@fusion.dev/helix-headless 0.52.0 → 0.53.0

package/types/vue.d.ts

@@ -408,7 +408,14 @@ can draw a part as less than nothing, `step` is for a quantity that changes
 at a moment and is ordered the way `straight` is.
 
 Absent rather than defaulted because a reflecting property with a default
-writes its attribute onto every host, including the ones nobody configured. */
+writes its attribute onto every host, including the ones nobody configured.
+The resting value therefore lives in the render, as `curve ?? 'straight'`.
+
+**`LineChart` and `Sparkline` rest at `smooth` and are not disagreeing.** A
+line claims a position, so the bounded invention a monotone cubic makes is
+a reading aid and costs nothing. A band claims an amount, and two sums
+smoothed independently can cross, so the same aid here draws a part as less
+than nothing. Same axis, different mark, different resting value. */
   curve?: (HelixHeadlessAreaChart["curve"]) | undefined;
   /** Which rules are drawn across the plot, if any.
 
@@ -4360,7 +4367,13 @@ renders, including the ones nobody configured.
 consumer wrote. The default therefore lives where the path is built, as
 `curve ?? 'smooth'`.
 
-`step` claims the opposite of both, that a reading holds until the next. */
+`step` claims the opposite of both, that a reading holds until the next.
+
+**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a
+position and a stacked band claims an amount: a curve fitted through one
+sum can pass under the curve fitted through the sum beneath it, so a
+smoothed stack can draw a part as less than nothing. There is no such edge
+here, which is what lets a line take the reading aid. */
   curve?: (HelixHeadlessLineChart["curve"]) | undefined;
   /** Which rules are drawn across the plot, if any.
 
@@ -5122,16 +5135,26 @@ declaration. `:state(read)` is what the stylesheet reads.
   "default-read"?: (HelixHeadlessNotification["defaultRead"]) | undefined;
   /** State to open with, where nothing declared one. */
   defaultRead?: (HelixHeadlessNotification["defaultRead"]) | undefined;
-  /** Whether a reader may remove it. */
-  dismissible?: (HelixHeadlessNotification["dismissible"]) | undefined;
-  /** Accessible name for the dismiss control. */
-  "dismiss-label"?: (HelixHeadlessNotification["dismissLabel"]) | undefined;
-  /** Accessible name for the dismiss control. */
-  dismissLabel?: (HelixHeadlessNotification["dismissLabel"]) | undefined;
   /** Locale for the timestamp.
 
 Empty is the runtime's own. */
   locale?: (HelixHeadlessNotification["locale"]) | undefined;
+  /** Whether it offers a control to take it away. */
+  dismissible?: (HelixHeadlessNotification["dismissible"]) | undefined;
+  /** Accessible name for that control.
+
+`attribute` is spelled out because Lit lowercases a property name to
+derive one rather than dash-casing it, so this would otherwise be
+reachable only as `dismisslabel`, which nobody would guess and no linter
+would catch. */
+  "dismiss-label"?: (HelixHeadlessNotification["dismissLabel"]) | undefined;
+  /** Accessible name for that control.
+
+`attribute` is spelled out because Lit lowercases a property name to
+derive one rather than dash-casing it, so this would otherwise be
+reachable only as `dismisslabel`, which nobody would guess and no linter
+would catch. */
+  dismissLabel?: (HelixHeadlessNotification["dismissLabel"]) | undefined;
 };
 
 export type HelixHeadlessNotificationVueEvents = {
@@ -6038,11 +6061,13 @@ and a URL is a better name than "QR code" for a reader who cannot see it. */
   label?: (HelixHeadlessQrCode["label"]) | undefined;
   /** How the modules are drawn.
 
-`square` is the default and the only one that joins runs of adjacent
-modules into a single subpath, which is what keeps a thousand modules to a
-handful of nodes. `rounded` and `dots` draw each module on its own, because
-the corners are the thing being drawn and a joined run has none in the
-middle. That cost is paid only by a code that asks for them.
+`square` is the resting state and is written by not writing it, per the
+rule that a reflected property takes no default. It is also the only one
+that joins runs of adjacent modules into a single subpath, which is what
+keeps a thousand modules to a handful of nodes. `rounded` and `dots` draw
+each module on its own, because the corners are the thing being drawn and a
+joined run has none in the middle. That cost is paid only by a code that
+asks for them.
 
 A scanner reads contrast between cells, not their shape, so all three
 scan. `dots` sits a little under half a module so neighbors do not touch,
@@ -6151,13 +6176,15 @@ export type HelixHeadlessRadioHelixSelectElementEvent =
   HelixHeadlessRadioElementEvent<HelixSelectEvent>;
 
 export type HelixHeadlessRadioVueProps = {
-  /** Whether this choice can be made. */
+  /** Whether this one can be chosen. */
   disabled?: (HelixHeadlessRadio["disabled"]) | undefined;
-  /** Whether this is the current choice.
+  /** Whether this is the current one.
 
-Written by the group. */
+Written by the set rather than by a consumer, which is why it takes no
+default from an attribute here: a family whose selection a consumer
+declares in markup carries `defaultSelected` of its own to say so. */
   selected?: (HelixHeadlessRadio["selected"]) | undefined;
-  /** Identifies this choice to the group, and is what the form submits. */
+  /** Identifies this one to the set, and is what a form submits. */
   value?: (HelixHeadlessRadio["value"]) | undefined;
   /** Whether the markup declared this one chosen, which is what a reset returns to.
 
@@ -6693,7 +6720,13 @@ assert against. So the resting state is still the attribute's absence, and
 `curve ?? 'smooth'` is what reads it.
 
 `step` claims the opposite of both, that a reading holds until the next.
-Bars ignore it, having no between to interpolate. */
+Bars ignore it, having no between to interpolate.
+
+**`AreaChart` rests at `straight` and is not disagreeing.** A line claims a
+position and a stacked band claims an amount: a curve fitted through one
+sum can pass under the curve fitted through the sum beneath it, so a
+smoothed stack can draw a part as less than nothing. There is no such edge
+here, which is what lets a line take the reading aid. */
   curve?: (HelixHeadlessSparkline["curve"]) | undefined;
   /** The id of a table to read instead, when there is one behind the line.
 
@@ -7415,11 +7448,15 @@ export type HelixHeadlessTabHelixSelectElementEvent =
   HelixHeadlessTabElementEvent<HelixSelectEvent>;
 
 export type HelixHeadlessTabVueProps = {
-  /** Whether the tab can be chosen. */
+  /** Whether this one can be chosen. */
   disabled?: (HelixHeadlessTab["disabled"]) | undefined;
-  /** Whether this tab is the current one. */
+  /** Whether this is the current one.
+
+Written by the set rather than by a consumer, which is why it takes no
+default from an attribute here: a family whose selection a consumer
+declares in markup carries `defaultSelected` of its own to say so. */
   selected?: (HelixHeadlessTab["selected"]) | undefined;
-  /** Identifies the tab, and pairs it with the panel of the same value. */
+  /** Identifies this one to the set, and is what a form submits. */
   value?: (HelixHeadlessTab["value"]) | undefined;
 };
 
@@ -8208,11 +8245,15 @@ export type HelixHeadlessToggleHelixSelectElementEvent =
   HelixHeadlessToggleElementEvent<HelixSelectEvent>;
 
 export type HelixHeadlessToggleVueProps = {
-  /** Whether the item can be chosen. */
+  /** Whether this one can be chosen. */
   disabled?: (HelixHeadlessToggle["disabled"]) | undefined;
-  /** Whether this item is the current one. */
+  /** Whether this is the current one.
+
+Written by the set rather than by a consumer, which is why it takes no
+default from an attribute here: a family whose selection a consumer
+declares in markup carries `defaultSelected` of its own to say so. */
   selected?: (HelixHeadlessToggle["selected"]) | undefined;
-  /** Identifies the item to the group. */
+  /** Identifies this one to the set, and is what a form submits. */
   value?: (HelixHeadlessToggle["value"]) | undefined;
   /** Whether the markup declared this one chosen, which is what a reset returns to.