@fusion.dev/helix 0.44.0 → 0.46.0

package/types/vue.d.ts

@@ -1558,7 +1558,7 @@ case is the absent attribute, and the styles read it that way. */
 };
 
 export type HelixCarouselVueEvents = {
-  /** Fired when the slide in view changes, with its index. Cancelable where the carousel is about to move: refusing a control or an indicator takes the decision and nothing moves. A drag has already moved the track, so that one announces after the fact and refusing it does nothing. See `handleScroll`. */
+  /** Fired before the slide in view changes, with the index being asked for. Cancelable: refusing it takes the decision and nothing moves, including a drag, which is put back on the slide the index still holds. See `handleScroll`. */
   "helix-select": HelixCarouselHelixSelectElementEvent;
 };
 
@@ -1670,12 +1670,15 @@ Reflected, because every one of the four is a visual state and a stylesheet
 has no other way to know. Absent is a settled message with nothing to
 report, which is what most of a transcript is, and it is the absence of the
 attribute rather than a value of it: there is no initializer, so nothing is
-reflected until something happens. */
+reflected until something happens.
+
+**The turn writes this once, on a retry nobody refused**, and `handleRetry`
+holds the reason. Everything else that moves it is the consumer's. */
   state?: (HelixChatMessage["state"]) | undefined;
 };
 
 export type HelixChatMessageVueEvents = {
-  /** Fired when the reader asks to send a failed message again, and cancelable. */
+  /** Fired when the reader asks to send a failed message again. Cancelable: a retry that stands puts the turn back on its way, and refusing it leaves the failure and the control offering it exactly where they were. */
   "helix-send": HelixChatMessageHelixSendElementEvent;
 };
 
@@ -3907,7 +3910,7 @@ Here rather than on each control. */
 export type HelixFileInputVueEvents = {
   /** Announced once the value has moved. */
   change: HelixFileInputElementEvent;
-  /** Fired before the chosen files change, with their names. Cancelable: refusing it takes the decision and nothing moves. */
+  /** Fired before the chosen files change, with their names. Cancelable: refusing it takes the decision and the field keeps the files it had, a pick the browser has already written included. */
   "helix-before-change": HelixFileInputHelixBeforeChangeElementEvent;
   /** Announced once the value has moved. */
   input: HelixFileInputElementEvent;
@@ -7029,6 +7032,21 @@ name is the fault `TreeItem` avoids by mirroring to `data-selected`.
 Splitting them means moving what every stylesheet selects on, which is a
 change of its own rather than a property being added. */
   defaultSelected?: (HelixRadio["defaultSelected"]) | undefined;
+  /** Whether this choice holds the group's tab stop while nothing is chosen.
+
+The stop rides on the selection, and an unanswered group has no selection,
+so without this every choice is `tabindex="-1"` and the keyboard cannot
+enter the set at all.
+
+**Written by the group, with no attribute, and it reaches the control
+rather than the host.** A `tabindex` on the host is two faults at once: it
+is markup a consumer rendered and their server never sent, which React
+reports as a mismatch and does not patch up, and it puts the tab stop on
+the element rather than on the `<button role="radio">` inside it, so a
+screen reader meets an unnamed box where a native group would have given
+them an unchecked radio. `Toggle.Root` carries the same property for the
+same reason. */
+  focusable?: (HelixRadio["focusable"]) | undefined;
 };
 
 export type HelixRadioVueEvents = {
@@ -7223,11 +7241,26 @@ keyed on this attribute, and of the 56 tokens that differ by scheme the
 theme engine emits 19. The other 37 would stay light in a dark preview,
 including every one of the 24 series colors a chart reads. */
   colorMode?: (HelixSandboxPreview["colorMode"]) | undefined;
-  /** Writing direction inside the frame. */
+  /** Writing direction inside the frame.
+
+Not reflected. It is payload for the render message and nothing selects on
+it, here or anywhere: a frame is a document of its own and what is written
+on this host reaches nothing inside it, which is the same reason
+`colorMode` has to be sent rather than set. */
   direction?: (HelixSandboxPreview["direction"]) | undefined;
   /** Accessible name for the frame. */
   label?: (HelixSandboxPreview["label"]) | undefined;
-  /** How the example is placed in the frame. */
+  /** How the example is placed in the frame.
+
+`padded` insets it and leaves it at the top, which is the resting case and
+what an absent value sends. `centered` gives it a measure and centers that
+box in the frame. `hug` shrinks the example to its own content and centers
+what is left, which is the difference that matters for a component whose
+root is a full-width block. `fullscreen` is the whole frame with no inset.
+
+Not reflected, for `direction`'s reason: the placement is applied by the
+document inside the frame, against its own root, so no rule on this side
+could read it. */
   layout?: (HelixSandboxPreview["layout"]) | undefined;
   /** Markup to render. */
   source?: (HelixSandboxPreview["source"]) | undefined;
@@ -7318,7 +7351,12 @@ names below keeps that true whichever way round they sit.
 `split` follows the lead pane rather than the source, so `split="30"` means
 the same thing in both directions: thirty percent to whatever comes first. */
   lead?: (HelixSandbox["lead"]) | undefined;
-  /** Whether the panes sit side by side or stacked. */
+  /** Whether the panes sit side by side or stacked.
+
+Not reflected, for `lead`'s reason above: no rule selects on it. The axis
+reaches the stylesheet as the inner splitter's own `orientation`, which is
+where the panes are laid out, and this element's sheet names no host
+attribute at all. */
   orientation?: (HelixSandbox["orientation"]) | undefined;
   /** What the panel's height becomes when it is closed.