@fusion.dev/helix-docs 0.133.1 → 0.134.0

package/content/metrics.mdx

@@ -58,10 +58,10 @@ either barrel. The per-component tables show what your page pays.
 | Package | Raw | Gzip | Brotli | |
 |---|---|---|---|---|
 | `@fusion.dev/helix-core` | 183,735 | 58,230 | 49,473 | The element base class, mixins, decorators, and floating positioning. |
-| `@fusion.dev/helix-headless` | 746,304 | 193,314 | 149,776 | Every headless family. The barrel entry includes all of them. |
+| `@fusion.dev/helix-headless` | 746,360 | 193,340 | 149,928 | Every headless family. The barrel entry includes all of them. |
 | `@fusion.dev/helix-icons` | 55,565 | 17,727 | 14,864 | The whole glyph set. |
 | `@fusion.dev/helix-theme` | 3,626 | 1,597 | 1,384 | The derivation engine. Most sites run it at build time, and a theme switcher runs it in the browser. |
-| `@fusion.dev/helix` | 1,291,679 | 302,007 | 220,975 | Every styled family. |
+| `@fusion.dev/helix` | 1,292,222 | 302,091 | 220,839 | Every styled family. |
 | `lit` | 15,394 | 6,118 | 5,460 | Lit itself, listed so you can subtract it from every row above. |
 
 ## Stylesheets
@@ -74,7 +74,7 @@ shows the whole cost of using the base layer on its own.
 
 | File | Raw | Gzip | Brotli | |
 |---|---|---|---|---|
-| `base.css` | 30,672 | 4,430 | 3,844 | The base layer. It styles markup Helix does not render, and it works with no JavaScript. |
+| `base.css` | 30,785 | 4,456 | 3,871 | The base layer. It styles markup Helix does not render, and it works with no JavaScript. |
 | `elements.css` | 8,807 | 1,488 | 1,318 | Hides each element until its definition loads. It is generated from the tags in `@fusion.dev/helix`. |
 | `helix.css` | 207 | 148 | 118 | The other four stylesheets in one import, in the order they must load. |
 | `primitives.css` | 6,390 | 1,260 | 1,084 | The primitive layer. It is private, and it ships because `tokens.css` refers to it. |
@@ -84,9 +84,9 @@ shows the whole cost of using the base layer on its own.
 
 **Most of your first component is the shared runtime.** The median styled family is 21,372 bytes gzipped alone, and it adds 2,254 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.
 
-Across the 104 styled components, the smallest is `code` at 9,928 bytes gzipped alone, and the largest is `data-table` at 63,813. Every family together is 302,007.
+Across the 104 styled components, the smallest is `code` at 9,928 bytes gzipped alone, and the largest is `data-table` at 63,813. Every family together is 302,091.
 
-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 193,314 bytes gzipped, whatever else the page imports. That is 9 times the median family above. All 104 styled families import the headless family they extend directly. The rule checks the shape of the import, so it applies to any package that sets `sideEffects`, whatever its name.
+No family imports a barrel. The `barrels` rule in `fusion 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 193,340 bytes gzipped, whatever else the page imports. That is 9 times the median family above. All 104 styled families import the headless family they extend directly. The rule checks the shape of the import, so it applies to any package that sets `sideEffects`, whatever its name.
 
 The headless tier never had the problem, so it serves as the control. `@fusion.dev/helix-core` is `sideEffects: false`, and the median headless family is 21,942 bytes gzipped alone.
 
@@ -235,7 +235,7 @@ Structure, accessibility, state, and form participation. It has no presentation
 | `megamenu` | 63,407 | 20,893 | 18,412 | 4,941 | 1,268 | 1,012 |
 | `menu` | 127,129 | 41,951 | 35,088 | 8,855 | 2,191 | 1,752 |
 | `meter` | 36,339 | 11,032 | 9,727 | 4,099 | 1,058 | 850 |
-| `navigation` | 34,843 | 10,709 | 9,395 | 1,361 | 301 | 226 |
+| `navigation` | 34,898 | 10,725 | 9,419 | 1,417 | 316 | 229 |
 | `notifications` | 104,181 | 33,078 | 26,996 | 11,383 | 2,637 | 2,263 |
 | `number-input` | 102,465 | 32,630 | 26,674 | 7,670 | 2,010 | 1,515 |
 | `object-inspector` | 141,531 | 46,276 | 38,905 | 19,579 | 5,236 | 4,304 |
@@ -286,7 +286,7 @@ The headless tier plus presentation. `bun add @fusion.dev/helix` installs this t
 | Family | Alone raw | Alone gzip | Alone brotli | Added raw | Added gzip | Added brotli |
 |---|---|---|---|---|---|---|
 | `accordion` | 95,843 | 30,972 | 25,266 | 6,204 | 1,543 | 1,321 |
-| `announcement` | 94,479 | 30,406 | 24,827 | 5,932 | 1,410 | 1,248 |
+| `announcement` | 94,680 | 30,414 | 24,809 | 6,133 | 1,419 | 1,194 |
 | `app-header` | 37,393 | 11,126 | 9,799 | 5,121 | 1,166 | 934 |
 | `area-chart` | 86,811 | 27,796 | 24,497 | 18,366 | 4,988 | 4,144 |
 | `aura` | 100,530 | 33,627 | 29,130 | 65,483 | 23,032 | 19,723 |
@@ -336,14 +336,14 @@ The headless tier plus presentation. `bun add @fusion.dev/helix` installs this t
 | `legend` | 41,731 | 12,479 | 10,955 | 5,790 | 1,387 | 1,129 |
 | `lightbox` | 44,310 | 13,142 | 11,532 | 7,805 | 1,983 | 1,745 |
 | `line-chart` | 88,777 | 27,900 | 24,579 | 20,419 | 5,132 | 4,223 |
-| `list` | 38,031 | 11,207 | 9,858 | 5,782 | 1,294 | 1,042 |
+| `list` | 38,048 | 11,215 | 9,865 | 5,799 | 1,303 | 1,077 |
 | `listbox` | 112,870 | 35,565 | 29,019 | 15,768 | 4,072 | 3,333 |
 | `loader` | 36,315 | 10,953 | 9,628 | 4,051 | 984 | 832 |
 | `map` | 169,561 | 45,161 | 37,585 | 69,255 | 13,207 | 10,925 |
 | `megamenu` | 68,288 | 21,962 | 19,385 | 9,805 | 2,346 | 1,953 |
 | `menu` | 134,656 | 43,587 | 36,501 | 16,362 | 3,797 | 3,179 |
 | `meter` | 41,737 | 12,178 | 10,745 | 9,479 | 2,229 | 1,935 |
-| `navigation` | 36,224 | 11,110 | 9,735 | 2,726 | 713 | 628 |
+| `navigation` | 36,549 | 11,195 | 9,811 | 3,051 | 806 | 632 |
 | `notifications` | 117,292 | 35,506 | 29,125 | 24,486 | 5,059 | 4,265 |
 | `number-input` | 107,345 | 33,815 | 27,626 | 12,539 | 3,150 | 2,570 |
 | `object-inspector` | 155,168 | 48,532 | 40,983 | 33,196 | 7,574 | 6,373 |
@@ -401,11 +401,11 @@ stripped column shows the bytes we removed.
 | Package | Unpacked | Files | Source maps stripped | Runtime dependencies |
 |---|---|---|---|---|
 | `@fusion.dev/helix-core` | 1,192,742 | 171 | 267,144 | `@floating-ui/dom`, `@fusion.dev/helix-icons` |
-| `@fusion.dev/helix-headless` | 13,515,038 | 510 | 1,077,677 | `@fusion.dev/helix-core`, `@fusion.dev/helix-icons`, `uqr` |
+| `@fusion.dev/helix-headless` | 13,517,978 | 510 | 1,077,781 | `@fusion.dev/helix-core`, `@fusion.dev/helix-icons`, `uqr` |
 | `@fusion.dev/helix-icons` | 150,162 | 21 | 50,346 | `svgo` |
-| `@fusion.dev/helix-styles` | 102,155 | 6 | 0 | none |
+| `@fusion.dev/helix-styles` | 102,268 | 6 | 0 | none |
 | `@fusion.dev/helix-theme` | 514,288 | 8 | 5,300 | none |
-| `@fusion.dev/helix` | 14,628,121 | 876 | 373,810 | `@fusion.dev/helix-core`, `@fusion.dev/helix-headless`, `@fusion.dev/helix-styles` |
+| `@fusion.dev/helix` | 14,634,154 | 876 | 373,843 | `@fusion.dev/helix-core`, `@fusion.dev/helix-headless`, `@fusion.dev/helix-styles` |
 
 ## Not measured yet
 

package/content/theme-builder.mdx

@@ -17,8 +17,8 @@ You enter the same inputs that `derive()` takes:
 
 - **Color:** the brand, the color scheme, the contrast target, the saturation,
   the accent angle, and the page's color in light and in dark
-- **Shape and type:** the density, the corner radius, the three faces, the body
-  size, and the type scale
+- **Shape and type:** the density, the corner radius, the three faces and a
+  stylesheet for faces of your own, the body size, and the type scale
 - **Status:** how far the status colors follow the palette, and how far their
   hues may move
 - **Motion, separation, and material:** the motion character, how surfaces are
@@ -39,10 +39,25 @@ or black, the grays take its tint, and every text color is solved against it. A
 page that no text color can reach the contrast target on is left out of the
 preview, and a caption under the fields says so.
 
-**Color the figures band** gives one section of the Marketing site layout a
-color of its own, as its own theme. The band is dark or light by whichever text
-reads better on it, and its block follows the page's in the generated
-stylesheet. See [Color one section](./theming#color-one-section).
+**Color one band** gives one section a color of its own, as its own theme: the
+figures band in the Marketing site layout, or the announcement in the Local
+business layout. The band is dark or light by whichever text reads better on
+it, and its block follows the page's in the generated stylesheet. See
+[Color one section](./theming#color-one-section).
+
+## Faces of your own
+
+Type a family's name into the Body face, Display face, or Mono face field and
+choose **Use**, then give the stylesheet that declares it in **Font
+stylesheet**, as Google Fonts, Adobe Fonts, or your own server serves one. The
+preview loads the stylesheet, and the link keeps both. The stylesheet has to
+allow other sites to load its fonts, as the font services do.
+
+## Layouts
+
+The Layout field picks the page the theme is drawn on. **Local business** is a
+services site: an announcement over the page, a hero on a picture with a rating,
+three prices, the steps, the questions people ask, and where to visit.
 
 ## The audit
 

package/dist/sources.generated.js

@@ -3365,10 +3365,10 @@ either barrel. The per-component tables show what your page pays.
 | Package | Raw | Gzip | Brotli | |
 |---|---|---|---|---|
 | \`@fusion.dev/helix-core\` | 183,735 | 58,230 | 49,473 | The element base class, mixins, decorators, and floating positioning. |
-| \`@fusion.dev/helix-headless\` | 746,304 | 193,314 | 149,776 | Every headless family. The barrel entry includes all of them. |
+| \`@fusion.dev/helix-headless\` | 746,360 | 193,340 | 149,928 | Every headless family. The barrel entry includes all of them. |
 | \`@fusion.dev/helix-icons\` | 55,565 | 17,727 | 14,864 | The whole glyph set. |
 | \`@fusion.dev/helix-theme\` | 3,626 | 1,597 | 1,384 | The derivation engine. Most sites run it at build time, and a theme switcher runs it in the browser. |
-| \`@fusion.dev/helix\` | 1,291,679 | 302,007 | 220,975 | Every styled family. |
+| \`@fusion.dev/helix\` | 1,292,222 | 302,091 | 220,839 | Every styled family. |
 | \`lit\` | 15,394 | 6,118 | 5,460 | Lit itself, listed so you can subtract it from every row above. |
 
 ## Stylesheets
@@ -3381,7 +3381,7 @@ shows the whole cost of using the base layer on its own.
 
 | File | Raw | Gzip | Brotli | |
 |---|---|---|---|---|
-| \`base.css\` | 30,672 | 4,430 | 3,844 | The base layer. It styles markup Helix does not render, and it works with no JavaScript. |
+| \`base.css\` | 30,785 | 4,456 | 3,871 | The base layer. It styles markup Helix does not render, and it works with no JavaScript. |
 | \`elements.css\` | 8,807 | 1,488 | 1,318 | Hides each element until its definition loads. It is generated from the tags in \`@fusion.dev/helix\`. |
 | \`helix.css\` | 207 | 148 | 118 | The other four stylesheets in one import, in the order they must load. |
 | \`primitives.css\` | 6,390 | 1,260 | 1,084 | The primitive layer. It is private, and it ships because \`tokens.css\` refers to it. |
@@ -3391,9 +3391,9 @@ shows the whole cost of using the base layer on its own.
 
 **Most of your first component is the shared runtime.** The median styled family is 21,372 bytes gzipped alone, and it adds 2,254 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.
 
-Across the 104 styled components, the smallest is \`code\` at 9,928 bytes gzipped alone, and the largest is \`data-table\` at 63,813. Every family together is 302,007.
+Across the 104 styled components, the smallest is \`code\` at 9,928 bytes gzipped alone, and the largest is \`data-table\` at 63,813. Every family together is 302,091.
 
-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 193,314 bytes gzipped, whatever else the page imports. That is 9 times the median family above. All 104 styled families import the headless family they extend directly. The rule checks the shape of the import, so it applies to any package that sets \`sideEffects\`, whatever its name.
+No family imports a barrel. The \`barrels\` rule in \`fusion 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 193,340 bytes gzipped, whatever else the page imports. That is 9 times the median family above. All 104 styled families import the headless family they extend directly. The rule checks the shape of the import, so it applies to any package that sets \`sideEffects\`, whatever its name.
 
 The headless tier never had the problem, so it serves as the control. \`@fusion.dev/helix-core\` is \`sideEffects: false\`, and the median headless family is 21,942 bytes gzipped alone.
 
@@ -3542,7 +3542,7 @@ Structure, accessibility, state, and form participation. It has no presentation
 | \`megamenu\` | 63,407 | 20,893 | 18,412 | 4,941 | 1,268 | 1,012 |
 | \`menu\` | 127,129 | 41,951 | 35,088 | 8,855 | 2,191 | 1,752 |
 | \`meter\` | 36,339 | 11,032 | 9,727 | 4,099 | 1,058 | 850 |
-| \`navigation\` | 34,843 | 10,709 | 9,395 | 1,361 | 301 | 226 |
+| \`navigation\` | 34,898 | 10,725 | 9,419 | 1,417 | 316 | 229 |
 | \`notifications\` | 104,181 | 33,078 | 26,996 | 11,383 | 2,637 | 2,263 |
 | \`number-input\` | 102,465 | 32,630 | 26,674 | 7,670 | 2,010 | 1,515 |
 | \`object-inspector\` | 141,531 | 46,276 | 38,905 | 19,579 | 5,236 | 4,304 |
@@ -3593,7 +3593,7 @@ The headless tier plus presentation. \`bun add @fusion.dev/helix\` installs this
 | Family | Alone raw | Alone gzip | Alone brotli | Added raw | Added gzip | Added brotli |
 |---|---|---|---|---|---|---|
 | \`accordion\` | 95,843 | 30,972 | 25,266 | 6,204 | 1,543 | 1,321 |
-| \`announcement\` | 94,479 | 30,406 | 24,827 | 5,932 | 1,410 | 1,248 |
+| \`announcement\` | 94,680 | 30,414 | 24,809 | 6,133 | 1,419 | 1,194 |
 | \`app-header\` | 37,393 | 11,126 | 9,799 | 5,121 | 1,166 | 934 |
 | \`area-chart\` | 86,811 | 27,796 | 24,497 | 18,366 | 4,988 | 4,144 |
 | \`aura\` | 100,530 | 33,627 | 29,130 | 65,483 | 23,032 | 19,723 |
@@ -3643,14 +3643,14 @@ The headless tier plus presentation. \`bun add @fusion.dev/helix\` installs this
 | \`legend\` | 41,731 | 12,479 | 10,955 | 5,790 | 1,387 | 1,129 |
 | \`lightbox\` | 44,310 | 13,142 | 11,532 | 7,805 | 1,983 | 1,745 |
 | \`line-chart\` | 88,777 | 27,900 | 24,579 | 20,419 | 5,132 | 4,223 |
-| \`list\` | 38,031 | 11,207 | 9,858 | 5,782 | 1,294 | 1,042 |
+| \`list\` | 38,048 | 11,215 | 9,865 | 5,799 | 1,303 | 1,077 |
 | \`listbox\` | 112,870 | 35,565 | 29,019 | 15,768 | 4,072 | 3,333 |
 | \`loader\` | 36,315 | 10,953 | 9,628 | 4,051 | 984 | 832 |
 | \`map\` | 169,561 | 45,161 | 37,585 | 69,255 | 13,207 | 10,925 |
 | \`megamenu\` | 68,288 | 21,962 | 19,385 | 9,805 | 2,346 | 1,953 |
 | \`menu\` | 134,656 | 43,587 | 36,501 | 16,362 | 3,797 | 3,179 |
 | \`meter\` | 41,737 | 12,178 | 10,745 | 9,479 | 2,229 | 1,935 |
-| \`navigation\` | 36,224 | 11,110 | 9,735 | 2,726 | 713 | 628 |
+| \`navigation\` | 36,549 | 11,195 | 9,811 | 3,051 | 806 | 632 |
 | \`notifications\` | 117,292 | 35,506 | 29,125 | 24,486 | 5,059 | 4,265 |
 | \`number-input\` | 107,345 | 33,815 | 27,626 | 12,539 | 3,150 | 2,570 |
 | \`object-inspector\` | 155,168 | 48,532 | 40,983 | 33,196 | 7,574 | 6,373 |
@@ -3708,11 +3708,11 @@ stripped column shows the bytes we removed.
 | Package | Unpacked | Files | Source maps stripped | Runtime dependencies |
 |---|---|---|---|---|
 | \`@fusion.dev/helix-core\` | 1,192,742 | 171 | 267,144 | \`@floating-ui/dom\`, \`@fusion.dev/helix-icons\` |
-| \`@fusion.dev/helix-headless\` | 13,515,038 | 510 | 1,077,677 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`uqr\` |
+| \`@fusion.dev/helix-headless\` | 13,517,978 | 510 | 1,077,781 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`uqr\` |
 | \`@fusion.dev/helix-icons\` | 150,162 | 21 | 50,346 | \`svgo\` |
-| \`@fusion.dev/helix-styles\` | 102,155 | 6 | 0 | none |
+| \`@fusion.dev/helix-styles\` | 102,268 | 6 | 0 | none |
 | \`@fusion.dev/helix-theme\` | 514,288 | 8 | 5,300 | none |
-| \`@fusion.dev/helix\` | 14,628,121 | 876 | 373,810 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\` |
+| \`@fusion.dev/helix\` | 14,634,154 | 876 | 373,843 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\` |
 
 ## Not measured yet
 
@@ -5606,8 +5606,8 @@ You enter the same inputs that \`derive()\` takes:
 
 - **Color:** the brand, the color scheme, the contrast target, the saturation,
   the accent angle, and the page's color in light and in dark
-- **Shape and type:** the density, the corner radius, the three faces, the body
-  size, and the type scale
+- **Shape and type:** the density, the corner radius, the three faces and a
+  stylesheet for faces of your own, the body size, and the type scale
 - **Status:** how far the status colors follow the palette, and how far their
   hues may move
 - **Motion, separation, and material:** the motion character, how surfaces are
@@ -5628,10 +5628,25 @@ or black, the grays take its tint, and every text color is solved against it. A
 page that no text color can reach the contrast target on is left out of the
 preview, and a caption under the fields says so.
 
-**Color the figures band** gives one section of the Marketing site layout a
-color of its own, as its own theme. The band is dark or light by whichever text
-reads better on it, and its block follows the page's in the generated
-stylesheet. See [Color one section](./theming#color-one-section).
+**Color one band** gives one section a color of its own, as its own theme: the
+figures band in the Marketing site layout, or the announcement in the Local
+business layout. The band is dark or light by whichever text reads better on
+it, and its block follows the page's in the generated stylesheet. See
+[Color one section](./theming#color-one-section).
+
+## Faces of your own
+
+Type a family's name into the Body face, Display face, or Mono face field and
+choose **Use**, then give the stylesheet that declares it in **Font
+stylesheet**, as Google Fonts, Adobe Fonts, or your own server serves one. The
+preview loads the stylesheet, and the link keeps both. The stylesheet has to
+allow other sites to load its fonts, as the font services do.
+
+## Layouts
+
+The Layout field picks the page the theme is drawn on. **Local business** is a
+services site: an announcement over the page, a hero on a picture with a rating,
+three prices, the steps, the questions people ask, and where to visit.
 
 ## The audit
 

package/package.json

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