@fusion.dev/helix 0.105.0 → 0.107.0

package/dist/accordion/item/accordion-item.d.ts

@@ -5,27 +5,26 @@ import type { CSSResultGroup } from 'lit';
  *
  * @description
  * The open and close transition animates `grid-template-rows` from `0fr` to
- * `1fr`, which is the only technique that reaches the content's intrinsic
- * height without measuring it in JavaScript. It is disabled under
- * `prefers-reduced-motion`.
+ * `1fr`, which reaches the content's intrinsic height without measuring it in
+ * JavaScript. The transition is off under `prefers-reduced-motion`.
  *
- * Usable on its own as a disclosure, with no accordion around it.
+ * You can use an item on its own as a disclosure, with no accordion around it.
  *
  * @since 0.1.0
  * @status stable
  * @aliases Collapsible, Expander, Disclosure
  * @documentation https://fusion.dev/helix/components/accordion
  *
- * @slot - The content revealed when open.
- * @slot summary - The always-visible trigger content.
+ * @slot - The content shown when the section is open.
+ * @slot summary - The text of the button that opens and closes the section. Always shown.
  *
  * @csspart chevron - The open and close indicator.
  * @csspart container - The outer wrapper.
- * @csspart content - The revealed region.
- * @csspart content-inner - The clipping box inside the animated region. The inset is on the slot within it, not here: padding on the grid item survives a zero track, which left a shut section with a band of space under it.
- * @csspart trigger - The clickable summary row.
+ * @csspart content - The region that holds the content.
+ * @csspart content-inner - The clipping box inside the animated region. The padding is on the slot inside it, so a closed section leaves no space.
+ * @csspart trigger - The button that opens and closes the section, holding the summary.
  *
- * @cssproperty --accordion-item-padding - Inset of the trigger and content.
+ * @cssproperty --accordion-item-padding - The padding of the trigger and the content.
  */
 export declare class HelixAccordionItem extends HelixHeadlessAccordionItem {
     static styles: CSSResultGroup;

package/dist/accordion/root/accordion-root.d.ts

@@ -1,13 +1,11 @@
 import { HelixHeadlessAccordion } from '@fusion.dev/helix-headless/accordion';
 import type { CSSResultGroup } from 'lit';
 /**
- * @summary Groups collapsible sections, one open at a time by default.
+ * @summary A group of collapsible sections.
  *
  * @description
- * Items share one rule between neighbors rather than each drawing its own, so
- * the seam between two items is one pixel and not two. Those seams are what
- * carry the grouping, which is why the surrounding frame is opt-in rather than
- * the default: an accordion is a list, where a card is a surface.
+ * Neighboring items share one line, so the line between two items is one pixel
+ * wide. The lines show the grouping, so a frame around each item is opt-in.
  *
  * @since 0.1.0
  * @status stable
@@ -17,13 +15,14 @@ import type { CSSResultGroup } from 'lit';
  *
  * @slot - The accordion's items.
  *
- * @cssproperty --accordion-border-color - Color of the seams, and of each item's frame when outlined.
- * @cssproperty --accordion-gap - Space between items, when outlined. Nothing separates them otherwise: a seam is a shared edge.
- * @cssproperty --accordion-radius - Corner radius of each item, when outlined.
+ * @cssproperty --accordion-border-color - The color of the lines between items, and of each item's border when outlined.
+ * @cssproperty --accordion-gap - The space between items when outlined. Otherwise items share an edge.
+ * @cssproperty --accordion-radius - The corner radius of each item when outlined.
  */
 export declare class HelixAccordion extends HelixHeadlessAccordion {
     /**
-     * How the stack separates itself from the page.
+     * How the items are set off from the page. `plain` draws a line between
+     * items, and `outlined` draws a border around each item.
      *
      * Two of the axis's four values, which is what this surface has meaning for:
      * a stack of items is already told apart by its seams, so a lift would be a

package/dist/announcement/root/announcement-root.d.ts

@@ -1,12 +1,12 @@
 import { HelixHeadlessAnnouncement } from '@fusion.dev/helix-headless/announcement';
 import type { CSSResultGroup } from 'lit';
 /**
- * @summary A page-level message above the masthead, which can be dismissed.
+ * @summary A message for the whole page, shown above its header, that can be dismissed.
  *
  * @description
- * Full width and flat, with the severity carried by a tinted fill and a
- * hairline beneath rather than by a border on four sides: an announcement is a
- * band across the top of the page, not a box that happens to be wide.
+ * Full width and flat. The tone is a tinted fill and a hairline along the
+ * bottom edge, with no border on the other sides, so the announcement is a band
+ * across the top of the page.
  *
  * @since 0.1.0
  * @status stable
@@ -14,12 +14,12 @@ import type { CSSResultGroup } from 'lit';
  * @aliases Banner, Notification bar, Alert bar
  * @documentation https://fusion.dev/helix/components/announcement
  *
- * @cssproperty --announcement-block-size - How tall the band is at its shortest, so adding a control to it does not move the page down. A floor, not a cap: a message long enough to wrap still gets the room.
- * @cssproperty --announcement-inset - Inline padding, matched to the page.
+ * @cssproperty --announcement-block-size - The band's minimum height, so adding a control to it does not move the page down. A message long enough to wrap makes the band taller.
+ * @cssproperty --announcement-inset - The inline padding, matched to the page.
  */
 export declare class HelixAnnouncement extends HelixHeadlessAnnouncement {
     /**
-     * Which rung of the surface ladder the band rides.
+     * The surface level the band sits on.
      *
      * `filled` is the resting one, a well sunk below the page. `elevated` brings
      * it up to the surface step, for a band that reads as part of the furniture

package/dist/app-header/root/app-header-root.d.ts

@@ -4,16 +4,18 @@ import type { CSSResultGroup } from 'lit';
  * @summary Page-level banner holding brand, navigation, and actions.
  *
  * @description
- * Flat, opaque, and in the flow. Both of the interesting things a banner can do
- * are opt-in: `sticky` because following the reader is a decision about the
- * page rather than about the bar, and `material` because a backdrop filter
- * makes the header a containing block for `position: fixed` descendants, so an
- * overlay rendered inside a material header is placed against the header rather
- * than the viewport.
+ * The header is flat, opaque, and in the document flow. Two behaviors are
+ * opt-in:
  *
- * The separating rule appears only once the page has scrolled, which keeps the
- * banner flat against a hero and lifts it off the content afterwards. There is
- * no shadow: the rule is the whole of it.
+ * - `sticky` keeps the header in view while the page scrolls. Whether it should
+ *   follow the page is a decision about the page.
+ * - `material` adds a backdrop filter. The filter makes the header a containing
+ *   block for `position: fixed` descendants, so an overlay rendered inside a
+ *   material header is positioned against the header.
+ *
+ * A separating rule appears once the page has scrolled, so the header sits flat
+ * against a hero and lifts off the content afterwards. The header has no
+ * shadow.
  *
  * @since 0.1.0
  * @status stable
@@ -27,7 +29,7 @@ import type { CSSResultGroup } from 'lit';
  *
  * @csspart content - The centered row inside the banner.
  *
- * @cssproperty --app-header-backdrop - The filter behind it. `none` to pair it with a panel.
+ * @cssproperty --app-header-backdrop - The filter behind the banner. Set it to `none` when you pair the header with a panel.
  * @cssproperty --app-header-background-color - Fill behind the banner.
  * @cssproperty --app-header-block-size - Height of the banner.
  * @cssproperty --app-header-border-color - The line under the bar. None by default.
@@ -36,8 +38,8 @@ import type { CSSResultGroup } from 'lit';
  */
 export declare class HelixAppHeader extends HelixHeadlessAppHeader {
     /**
-     * What the banner is made of, which is how much of what is behind it shows
-     * through.
+     * What the banner is made of, which sets how much of the page behind it
+     * shows through.
      *
      * One axis, and absent is opaque, per the rule that a reflected property
      * takes no default.

package/dist/area-chart/root/area-chart-root.d.ts

@@ -2,40 +2,28 @@ import { HelixHeadlessAreaChart } from '@fusion.dev/helix-headless/area-chart';
 import type { CSSResultGroup } from 'lit';
 import '../../tooltip/index.js';
 /**
- * @summary How a total is made up over time, as bands stacked on one another.
+ * @summary A chart that shows how a total is made up over time, as bands stacked on one another.
  *
  * @description
- * The bands take the series palette in order, the first column at the bottom,
- * so a legend beside the chart names them in the order they are stacked.
+ * The bands take the series palette in order, with the first column at the
+ * bottom, so a legend lists them in stacking order.
  *
- * Each band is a pale fill with its top edge drawn at the series' full color.
- * The fills are mixed toward the page rather than made translucent, because
- * the bands overlap where they are drawn and a translucent one would show the
- * others through it.
+ * Each band is a pale fill with its top edge in the series' full color. The
+ * fills are mixed toward the page background, because translucent bands would
+ * show each other where they overlap.
  *
- * **No visual axis applies here, and that is the answer rather than a gap.**
- * Both refusals are geometric and both were argued in the stylesheet before
- * they were argued anywhere a reader looks.
+ * **The chart supports neither the `emphasis` nor the `material` axis.**
  *
- * `emphasis` is which of a family's two marks carries the reading, and here
- * neither can give way. The fill is the value, a band's thickness being its
- * amount, and the edge is the boundary, which is why it is drawn at full color
- * over a pale fill rather than left to two pale fills meeting. Every point on
- * the axis moves one at the other's expense: `outlined` thins the fill until
- * the chart is a set of cumulative lines, which is `LineChart` and is the form
- * this one exists because a reader cannot read shares off; `solid` takes the
- * fill to the series' own color, which is the edge's color, so the boundary
- * disappears into the band it bounds. `LineChart` can take the axis because its
- * wash is optional there, `area` deciding whether one is drawn at all.
+ * - `emphasis`: the fill shows the value and the edge shows the boundary, and
+ *   both need to stay. `outlined` would thin the fill into cumulative lines,
+ *   which is `LineChart`. `solid` would fill the band in the edge color, so the
+ *   boundary would disappear.
+ * - `material`: a band covers everything under its top edge, so a translucent
+ *   band would show the bands behind it as a color outside the palette.
+ *   `LineChart` has no `wash` for the same reason.
  *
- * `material` is what reads through a mark, and a band cannot let anything
- * through. Each is drawn as everything under its top edge with the next one
- * down covering the rest, so a translucent band shows the bands behind it and
- * reads as a third color that is in no palette. That is `LineChart`'s recorded
- * reason for refusing `wash`, met here from the other side. The strength of a
- * fill is still adjustable and is `--area-chart-fill-strength`, which is a
- * continuum rather than an axis and is a theme's business rather than a
- * reader's.
+ * To change the strength of the fills, set `--area-chart-fill-strength` in your
+ * theme.
  *
  * @since 0.1.0
  * @status stable
@@ -47,12 +35,15 @@ import '../../tooltip/index.js';
  * @cssproperty --area-chart-block-size - Height of the drawing.
  * @cssproperty --area-chart-fill-strength - How much of its series' color a band takes, as a percentage mixed toward the page.
  * @cssproperty --area-chart-gap - Space between the drawing and its labels.
- * @cssproperty --area-chart-gridline-color - One rule across the plot, under `gridlines`.
- * @cssproperty --area-chart-width - Thickness of a band's top edge, over `--chart-stroke`.
- * @cssproperty --chart-stroke - Thickness of a band's top edge, one name across this family, Line Chart and Bar Chart's `lines`, since the three read one shared rule. `--area-chart-width` overrides it here.
+ * @cssproperty --area-chart-gridline-color - Color of the rules drawn across the plot under `gridlines`.
+ * @cssproperty --area-chart-width - Thickness of a band's top edge. Overrides `--chart-stroke`.
+ * @cssproperty --chart-stroke - Thickness of a band's top edge. Area Chart, Line Chart, and Bar Chart's `lines` all read this one property. `--area-chart-width` overrides it here.
  */
 export declare class HelixAreaChart extends HelixHeadlessAreaChart {
-    /** The styled tier, so the tooltip this renders is the styled one. */
+    /**
+     * The tag prefix for child elements. Set to the styled tier, so the chart
+     * renders the styled tooltip.
+     */
     static tier: string;
     static styles: CSSResultGroup;
 }

package/dist/aura/root/aura-root.d.ts

@@ -1,37 +1,37 @@
 import { HelixElement } from '@fusion.dev/helix-core';
 import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
 /**
- * @summary A lit, drifting background, drawn from the token layer.
+ * @summary A drifting background of light, drawn in your theme's colors.
  *
  * @description
- * One fragment shader over a full-screen triangle, with the palette read from
- * the tokens rather than given as colors. A background written with hex values
- * is an asset that has to be re-cut when the brand moves; one written against
- * `--helix-color-primary` is a consequence of it.
+ * One fragment shader draws over a full-screen triangle, and its palette comes
+ * from the tokens. A background built on `--helix-color-primary` changes when
+ * your brand color changes.
  *
- * **Every shape ramps through four token stops**, and the token layer inverts
- * each: the page's background, `primary-subtle`, `primary`, then a peak. The
- * peak is the foreground on a dark page and `primary-active` on a light one,
- * because mixing a saturated hue toward near-black takes the chroma out of the
- * pixels carrying most of it. Which way the page runs is read off the ground's
- * own luminance rather than asked of the mode, which is a private token.
+ * Every shape ramps through four token stops, and the token layer inverts each
+ * one: the page background, `primary-subtle`, `primary`, and a peak. The peak
+ * is the foreground on a dark page and `primary-active` on a light one, because
+ * mixing a saturated hue toward near-black removes its chroma. The component
+ * reads which way the page runs from the background's luminance, because the
+ * mode is a private token.
  *
- * **No dependency, and no scene graph.** The geometry is three vertices derived
- * from `gl_VertexID`, so there is no attribute, no buffer and no upload.
+ * The geometry is three vertices derived from `gl_VertexID`. There is no
+ * dependency, scene graph, attribute, buffer, or upload.
  *
- * **It stops when nobody is looking**, off screen and in a background tab, and
- * `prefers-reduced-motion` gets one still frame rather than an empty box. A
- * context the browser takes back, on a GPU reset or past its cap of about
- * sixteen, stops it too, and the gradient shows until the context returns.
+ * The shader stops drawing in these cases:
+ * - The element is off screen or in a background tab.
+ * - `prefers-reduced-motion` is set. The element shows one still frame.
+ * - The browser takes back the drawing context, on a GPU reset or past its
+ *   limit of about sixteen contexts. The gradient shows until the context
+ *   returns.
  *
- * **It declines a renderer that draws on the CPU**, which is a headless browser
- * and a machine with no usable GPU, and shows the gradient instead. The shader
- * costs about 450ms of first frame per element there against 2ms on a GPU, for
- * a field drawn from the same tokens the gradient already ramps.
+ * On a renderer that draws on the CPU, such as a headless browser or a machine
+ * with no usable GPU, the element shows the gradient. There the shader costs
+ * about 450ms for the first frame of each element, against 2ms on a GPU.
  *
- * Styled only, and with behavior, which the tier split does not otherwise
- * allow: the behavior is drawing to a canvas, so there is no structure a
- * consumer could restyle and nothing for a headless twin to hold.
+ * Aura is styled only and has behavior, which the tier split does not otherwise
+ * allow. Its behavior is drawing to a canvas, so there is no structure for you
+ * to restyle and nothing for a headless version to hold.
  *
  * @since 0.1.0
  * @status stable
@@ -67,7 +67,8 @@ export declare class HelixAura extends HelixElement {
      */
     gain: number;
     /**
-     * What the pointer does, where the shape's own answer is not wanted.
+     * What the pointer does to the field. Set it to override the default for the
+     * `variant`.
      *
      * Absent is `native`, which is each shape answering in the terms it is made
      * of: braid leans, rays are occluded, threads pinch, particles scatter. The
@@ -133,11 +134,11 @@ export declare class HelixAura extends HelixElement {
      */
     tilt: number;
     /**
-     * How much the members of a population differ from one another, `0` a set
-     * that is uniform and `1` the resting amount. Clamped to that range: these
-     * are interpolations, so a larger number extrapolates rather than
-     * exaggerating, and a streak whose length has passed through zero is drawn
-     * as a bar across the whole frame.
+     * How much the members of a population differ from one another, from `0`,
+     * where they are uniform, to `1`, the default amount. Values are clamped to
+     * that range, because they interpolate: a larger number would extrapolate,
+     * and a streak whose length passed through zero would be drawn as a bar
+     * across the whole frame.
      *
      * Read by six of the eleven shapes, the ones made of many similar things,
      * whether those are counted or continuous: `streaks`, whose lanes draw a
@@ -159,7 +160,7 @@ export declare class HelixAura extends HelixElement {
      */
     variance: number;
     /**
-     * Which form the light takes. Absent is `braid`.
+     * The form the light takes. When it is not set, the form is `braid`.
      *
      * Reflected because the fallback gradient selects on it, and given no default
      * for the same reason every axis here has none: a default on a reflected

package/dist/avatar/group/avatar-group.d.ts

@@ -4,17 +4,14 @@ import type { CSSResultGroup } from 'lit';
  * @summary Overlapping avatars, with a count for the ones not shown.
  *
  * @description
- * They overlap by a step of space, which is enough to read as a stack without
- * the faces occluding each other. Each carries a ring in the page's own
- * background color, because a stack with no separation between its members
- * reads as one shape rather than several: the ring is what makes the edge of
- * each avatar visible against the one behind it.
+ * Avatars overlap by one step of space, so they read as a stack and each face
+ * stays visible. Each avatar has a ring in the page background color, which
+ * marks its edge against the avatar behind it.
  *
- * Each avatar is drawn over the one before it, which falls out of document
- * order and needs no `z-index`. The familiar trick for putting the *first*
- * avatar on top is `row-reverse`, and it also reverses the row: the person
- * written first appears last. A facepile whose reading order is the reverse of
- * its markup is the worse trade of the two.
+ * Each avatar is drawn over the one before it, in document order, with no
+ * `z-index`. The group does not use `row-reverse` to put the first avatar on
+ * top, because that also reverses the visual order: the person written first
+ * would appear last.
  *
  * @since 0.1.0
  * @status stable
@@ -22,7 +19,7 @@ import type { CSSResultGroup } from 'lit';
  * @documentation https://fusion.dev/helix/components/avatar
  *
  * @cssproperty --avatar-group-overlap - How far each avatar sits over the one before it.
- * @cssproperty --avatar-group-ring-color - The separation drawn between one avatar and the next.
+ * @cssproperty --avatar-group-ring-color - Color of the ring that separates one avatar from the next.
  */
 export declare class HelixAvatarGroup extends HelixHeadlessAvatarGroup {
     static styles: CSSResultGroup;

package/dist/avatar/root/avatar-root.d.ts

@@ -1,13 +1,12 @@
 import { HelixHeadlessAvatar } from '@fusion.dev/helix-headless/avatar';
 import type { CSSResultGroup } from 'lit';
 /**
- * @summary Represents a person or entity with an image or their initials.
+ * @summary A person or entity, shown as an image or as their initials.
  *
  * @description
- * Initials scale with the avatar rather than being sized per size, because the
- * font size is set in `em` against the avatar's own dimension. One rule covers
- * every size, including one a consumer sets themselves through
- * `--avatar-size`.
+ * The font size of the initials is set in `em` against the avatar's own
+ * dimension, so the initials scale with every size, including a size you set
+ * through `--avatar-size`.
  *
  * @since 0.1.0
  * @status stable

package/dist/badge/root/badge-root.d.ts

@@ -1,12 +1,12 @@
 import { HelixHeadlessBadge } from '@fusion.dev/helix-headless/badge';
 import type { CSSResultGroup } from 'lit';
 /**
- * @summary Attaches a count or a presence mark to another element.
+ * @summary A count or a dot pinned to the corner of another element.
  *
  * @description
- * The indicator carries a ring in the page's own background color, so it stays
- * legible where it overlaps the thing it is pinned to. Without it a dark badge
- * on a dark icon reads as a bite taken out of the icon.
+ * The indicator has a ring in the page background color, so it stays legible
+ * where it overlaps the element it is pinned to, such as a dark badge on a dark
+ * icon.
  *
  * @since 0.1.0
  * @status stable
@@ -14,14 +14,13 @@ import type { CSSResultGroup } from 'lit';
  * @aliases Count, Indicator, Pip
  * @documentation https://fusion.dev/helix/components/badge
  *
- * @cssproperty --badge-background-color - Fill of the indicator.
+ * @cssproperty --badge-background-color - The fill of the indicator.
  * @cssproperty --badge-offset - Pulls the mark in from the corner, along both axes.
- * @cssproperty --badge-ring-color - The ring separating it from what is behind.
+ * @cssproperty --badge-ring-color - The color of the ring between the indicator and what is behind it.
  */
 export declare class HelixBadge extends HelixHeadlessBadge {
     /**
-     * What the mark means, not how loudly it is drawn: the stylesheet picks a fill
-     * from what the count *is*.
+     * What the mark means. The stylesheet picks the fill from it.
      *
      * **`Tag`'s vocabulary, because a badge is the same kind of thing.** Both are
      * a small mark carrying a meaning beside something else, and the two had

package/dist/bar-chart/root/bar-chart-root.d.ts

@@ -2,13 +2,13 @@ import { HelixHeadlessBarChart } from '@fusion.dev/helix-headless/bar-chart';
 import type { CSSResultGroup, PropertyValues } from 'lit';
 import '../../tooltip/index.js';
 /**
- * @summary Categories as columns, read from a table.
+ * @summary A chart that draws a table's categories as columns.
  *
  * @description
- * The columns take the series palette in order, so a chart of one is series one
- * and a chart of four is the first four. Rounded at the far end only, because a
- * column grows from the baseline and a rounded foot would lift it off the rule
- * it is measured against.
+ * The columns take the series palette in order, so a chart with one series uses
+ * the first color and a chart with four uses the first four. Only the end away
+ * from the baseline is rounded, so each column sits flat on the rule it is
+ * measured from.
  *
  * @since 0.1.0
  * @status stable
@@ -17,20 +17,20 @@ import '../../tooltip/index.js';
  * @aliases Column Chart, Categorical Chart
  * @documentation https://fusion.dev/helix/components/bar-chart
  *
- * @cssproperty --bar-chart-band-color - The slot the pointer is resting in.
+ * @cssproperty --bar-chart-band-color - Fill of the category band under the pointer.
  * @cssproperty --bar-chart-bar-radius - Corner radius at the far end of a column.
  * @cssproperty --bar-chart-bar-stroke - Width of the edge an `outlined` or `subtle`
  *   column is drawn with.
  * @cssproperty --bar-chart-block-size - Height of the drawing.
  * @cssproperty --bar-chart-gap - Space between the drawing and its labels.
- * @cssproperty --bar-chart-gridline-color - One rule across the plot, under `gridlines`.
- * @cssproperty --bar-chart-line-color - A `lines` series, overriding its series color.
- * @cssproperty --bar-chart-line-width - Thickness of a `lines` series, over `--chart-stroke`.
- * @cssproperty --chart-stroke - Thickness of a `lines` series, one name across this family, Line Chart and Area Chart's top edge, since the three read one shared rule. `--bar-chart-line-width` overrides it here.
+ * @cssproperty --bar-chart-gridline-color - Color of the gridlines drawn by `gridlines`.
+ * @cssproperty --bar-chart-line-color - Color of a `lines` series. Overrides its series color.
+ * @cssproperty --bar-chart-line-width - Thickness of a `lines` series. Overrides `--chart-stroke`.
+ * @cssproperty --chart-stroke - Thickness of a `lines` series. Bar Chart, Line Chart, and the top edge of Area Chart share this property. `--bar-chart-line-width` overrides it here.
  */
 export declare class HelixBarChart extends HelixHeadlessBarChart {
     /**
-     * **The styled tier, so the tooltip this renders is the styled one.**
+     * **The styled tier, so the chart renders the styled tooltip.**
      *
      * `tag()` builds a child's tag name from this prefix, and the base declares
      * `helix-headless-`. Without this override the chart puts a
@@ -41,7 +41,7 @@ export declare class HelixBarChart extends HelixHeadlessBarChart {
      */
     static tier: string;
     /**
-     * How much ink the columns claim.
+     * How strongly the columns are drawn.
      *
      * The chart's treatment, which every series takes unless `outlined` or
      * `subtle` names it. `outlined` is the mark as its edge alone, `subtle` a wash
@@ -63,7 +63,7 @@ export declare class HelixBarChart extends HelixHeadlessBarChart {
      */
     emphasis?: 'outlined' | 'solid' | 'subtle';
     /**
-     * Which series are glass rather than solid, by name.
+     * The names of the series drawn in glass.
      *
      * Matched the way `outlined` is, against the column headings the table gives.
      *
@@ -76,7 +76,8 @@ export declare class HelixBarChart extends HelixHeadlessBarChart {
      */
     glass?: string;
     /**
-     * What the columns are made of.
+     * The material the columns are drawn in. Leave it unset for solid columns, or
+     * set `glass` or `frosted`.
      *
      * **A third axis on the chart, not on the bar.** A bar is a mark inside a
      * drawing and nobody writes markup for one; the chart is what a consumer
@@ -114,7 +115,7 @@ export declare class HelixBarChart extends HelixHeadlessBarChart {
      */
     material?: 'frosted' | 'glass';
     /**
-     * Which series are drawn as an outline rather than a fill, by name.
+     * The names of the series drawn as an outline.
      *
      * Separated by whitespace or commas and matched against the column headings
      * the table gives, the way `lines` and `secondary` are, so a chart says
@@ -137,7 +138,7 @@ export declare class HelixBarChart extends HelixHeadlessBarChart {
      */
     outlined?: string;
     /**
-     * Which series are drawn as a wash of their color, by name.
+     * The names of the series drawn as a wash of their color.
      *
      * Matched as `outlined` is.
      */

package/dist/blockquote/root/blockquote-root.d.ts

@@ -4,10 +4,9 @@ import type { CSSResultGroup } from 'lit';
  * @summary A passage set off from the prose around it.
  *
  * @description
- * Set larger than body text on the display face, because a pulled quotation is
- * a change of voice and the type is what says so. No quotation marks are drawn:
- * the size and the space around it already set the passage apart, and marks on
- * top of that are the same thing said twice.
+ * Set in the display face, larger than body text, to mark a change of voice. No
+ * quotation marks are drawn, because the size and spacing already set the
+ * passage apart.
  *
  * @since 0.1.0
  * @status stable
@@ -15,7 +14,7 @@ import type { CSSResultGroup } from 'lit';
  * @aliases Pullquote, Citation, Excerpt
  * @documentation https://fusion.dev/helix/components/blockquote
  *
- * @cssproperty --blockquote-size - Size of the quoted passage.
+ * @cssproperty --blockquote-size - The font size of the quoted passage.
  */
 export declare class HelixBlockquote extends HelixHeadlessBlockquote {
     static styles: CSSResultGroup;

package/dist/breadcrumbs/breadcrumb/breadcrumb.d.ts

@@ -4,14 +4,14 @@ import type { CSSResultGroup } from 'lit';
  * @summary One step in a breadcrumb trail.
  *
  * @description
- * The separator is hidden on the first item with `:host(:first-child)`, so no
- * item needs to know its own index and the parent needs no coordination.
+ * The separator is hidden on the first crumb with `:host(:first-child)`, so no
+ * crumb needs its index and the parent needs no coordination.
  *
- * The link carries `data-link="quiet"`, the recipe navigation uses everywhere
- * else, which is what owns its color. Under the pointer it reads as a subtle
- * button. That part is styled from in here: the base layer sets color and
- * text-decoration on an anchor and nothing else, so the outer tree wins those
- * and leaves box and background to `::slotted`.
+ * The link carries `data-link="quiet"`, the link recipe navigation uses
+ * everywhere else, which sets its color. Under the pointer it looks like a
+ * subtle button, and that style is set inside the crumb. The base layer sets
+ * only color and text-decoration on an anchor, so your styles win for those,
+ * and the box and background come from `::slotted`.
  *
  * @since 0.1.0
  * @status stable

package/dist/breadcrumbs/root/breadcrumbs-root.d.ts

@@ -4,8 +4,8 @@ import type { CSSResultGroup } from 'lit';
  * @summary Shows the path to the current page.
  *
  * @description
- * A single wrapping line by default. The trail wraps rather than scrolling,
- * because a truncated path tells the reader less than a two-line one.
+ * The trail is a single line by default and wraps onto a second line when it
+ * runs out of room, so every crumb stays visible.
  *
  * @since 0.1.0
  * @status stable