@fusion.dev/helix-docs 0.133.1 → 0.135.0

package/content/graphs.mdx

@@ -365,6 +365,44 @@ helix-graph:state(ready) > div {
 }
 ```
 
+## Draw the graph before it loads
+
+`graphSnapshot(nodes, links, options)` draws the graph on your server as an
+SVG, fitted to its box as Sigma.js fits it and in your theme's colors. Put it
+in the frame after the element the renderer draws in, and the page shows a
+graph from its first paint. `connectGraph` fades it out once the renderer has
+drawn the graph whole.
+
+```js
+import { graphSnapshot } from '@fusion.dev/helix-graph/snapshot'
+
+const snapshot = graphSnapshot(nodes, links, {
+  height: 540,
+  labels: 'all',
+  width: 1200,
+})
+// Inside helix-graph, after <div id="drawing"></div>, write the snapshot's markup.
+```
+
+Give the snapshot the options you give the renderer, and it lines up with the
+drawing that replaces it:
+
+- `labels`, `groupLabels`, `shape`, and `emphasis`, as `sigmaDriver` takes them.
+- `active` and `reach`, as the frame and `connectGraph` take them, to draw the
+  selection lit.
+- `bounds`, the box you hand Sigma's `setCustomBBox`, where you hand it one.
+
+`width` and `height` are the box it is drawn for, and a smaller box shows its
+middle. Every note needs an `x` and a `y`, since only a layout run in the
+browser could place one without. The snapshot is an empty string where a note
+has no place, so it is whole or absent. Its colors are your theme's tokens, so
+it is light or dark with the page and follows a theme change.
+
+In a framework that renders the markup for you, such as React, put the snapshot
+in an element that is a direct child of the frame and has the
+`data-helix-graph-snapshot` attribute. `connectGraph` hides that element, and
+leaves removing it to your framework.
+
 ## Keyboard and screen readers
 
 - The frame is one tab stop. Arrow keys move the drawing, and the plus and

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

@@ -1949,6 +1949,44 @@ helix-graph:state(ready) > div {
 }
 \`\`\`
 
+## Draw the graph before it loads
+
+\`graphSnapshot(nodes, links, options)\` draws the graph on your server as an
+SVG, fitted to its box as Sigma.js fits it and in your theme's colors. Put it
+in the frame after the element the renderer draws in, and the page shows a
+graph from its first paint. \`connectGraph\` fades it out once the renderer has
+drawn the graph whole.
+
+\`\`\`js
+import { graphSnapshot } from '@fusion.dev/helix-graph/snapshot'
+
+const snapshot = graphSnapshot(nodes, links, {
+  height: 540,
+  labels: 'all',
+  width: 1200,
+})
+// Inside helix-graph, after <div id="drawing"></div>, write the snapshot's markup.
+\`\`\`
+
+Give the snapshot the options you give the renderer, and it lines up with the
+drawing that replaces it:
+
+- \`labels\`, \`groupLabels\`, \`shape\`, and \`emphasis\`, as \`sigmaDriver\` takes them.
+- \`active\` and \`reach\`, as the frame and \`connectGraph\` take them, to draw the
+  selection lit.
+- \`bounds\`, the box you hand Sigma's \`setCustomBBox\`, where you hand it one.
+
+\`width\` and \`height\` are the box it is drawn for, and a smaller box shows its
+middle. Every note needs an \`x\` and a \`y\`, since only a layout run in the
+browser could place one without. The snapshot is an empty string where a note
+has no place, so it is whole or absent. Its colors are your theme's tokens, so
+it is light or dark with the page and follows a theme change.
+
+In a framework that renders the markup for you, such as React, put the snapshot
+in an element that is a direct child of the frame and has the
+\`data-helix-graph-snapshot\` attribute. \`connectGraph\` hides that element, and
+leaves removing it to your framework.
+
 ## Keyboard and screen readers
 
 - The frame is one tab stop. Arrow keys move the drawing, and the plus and
@@ -3365,10 +3403,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 +3419,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 +3429,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 +3580,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 +3631,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 +3681,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 +3746,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 +5644,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 +5666,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.135.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.135.0",
+    "@fusion.dev/helix-cem": "0.135.0",
+    "@fusion.dev/helix-headless": "0.135.0",
+    "@fusion.dev/helix-icons": "0.135.0",
+    "@fusion.dev/helix-map": "0.135.0",
+    "@fusion.dev/helix-styles": "0.135.0",
+    "@fusion.dev/helix-testing": "0.135.0",
+    "@fusion.dev/helix-theme": "0.135.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "lit": "^3.2.1",
     "playwright": "^1.62.1"