@fusion.dev/helix 0.163.0 → 0.165.0

package/types/vue.d.ts

@@ -2025,6 +2025,11 @@ A word property: register it for a locale under the host's key. A family
 that names the control otherwise, such as Tag's `Remove {label}`,
 declares its own English with `@words` above the override. */
   dismissLabel?: (HelixCallout["dismissLabel"]) | undefined;
+  /** Whether the callout is showing. A dismissal nobody canceled turns it
+false and the callout hides itself, and setting it true shows the callout
+again. Not reflected: open is the resting state, so an `open` attribute
+would appear on markup a server sent without it. */
+  open?: (HelixCallout["open"]) | undefined;
   /** What kind of attention the passage needs.
 
 `tone` is the axis for what a thing means, and this is a subset of it: a
@@ -2059,7 +2064,7 @@ out keeps its English, and `tone-label` wins over both.
 };
 
 export type HelixCalloutVueEvents = {
-  /** The dismiss button was pressed. The callout does not remove itself, so remove it in response. Cancelable. */
+  /** The dismiss button was pressed. Unless a listener cancels it, the callout hides itself, and a listener may remove it instead. Cancelable: cancel it to keep the callout showing. */
   "helix-dismiss": HelixCalloutHelixDismissElementEvent;
 };
 
@@ -3981,6 +3986,14 @@ app.ts", as `code-name-label` puts it. */
   "collapse-label"?: (HelixCodeBlock["collapseLabel"]) | undefined;
   /** The expand button's words while the block shows every line. */
   collapseLabel?: (HelixCodeBlock["collapseLabel"]) | undefined;
+  /** In a diff, how many unchanged lines to keep beside each change. Each
+longer run of unchanged lines is folded behind a button that shows it.
+Unset shows every line the diff holds. */
+  "context-lines"?: (HelixCodeBlock["contextLines"] | `${number}`) | undefined;
+  /** In a diff, how many unchanged lines to keep beside each change. Each
+longer run of unchanged lines is folded behind a button that shows it.
+Unset shows every line the diff holds. */
+  contextLines?: (HelixCodeBlock["contextLines"]) | undefined;
   /** The copy button's name and tooltip text after a copy. */
   "copied-label"?: (HelixCodeBlock["copiedLabel"]) | undefined;
   /** The copy button's name and tooltip text after a copy. */
@@ -4019,6 +4032,14 @@ block lays out. Not for a diff, whose files each scroll on their own. */
   "expand-label"?: (HelixCodeBlock["expandLabel"]) | undefined;
   /** The expand button's words while the cap hides lines. */
   expandLabel?: (HelixCodeBlock["expandLabel"]) | undefined;
+  /** The words of a button that hides a run of unchanged lines it showed, in a
+diff with `context-lines`. `{count}` is how many, and each language
+writes the forms it has. */
+  "hide-unchanged-label"?: (HelixCodeBlock["hideUnchangedLabel"]) | undefined;
+  /** The words of a button that hides a run of unchanged lines it showed, in a
+diff with `context-lines`. `{count}` is how many, and each language
+writes the forms it has. */
+  hideUnchangedLabel?: (HelixCodeBlock["hideUnchangedLabel"]) | undefined;
   /** The block's name, usually a file name, drawn in the header.
 
 Absent, the block is named by `language` where there is one. In a diff,
@@ -4094,6 +4115,12 @@ A false boolean reflects as the attribute's absence, so this costs no
 reflected property taking no default is satisfied by the default being
 `false`. */
   noCopy?: (HelixCodeBlock["noCopy"]) | undefined;
+  /** The words of a button that shows a folded run of unchanged lines, in a
+diff with `context-lines`. `{count}` is how many. */
+  "show-unchanged-label"?: (HelixCodeBlock["showUnchangedLabel"]) | undefined;
+  /** The words of a button that shows a folded run of unchanged lines, in a
+diff with `context-lines`. `{count}` is how many. */
+  showUnchangedLabel?: (HelixCodeBlock["showUnchangedLabel"]) | undefined;
   /** How a diff's two versions are arranged. It has no effect without `diff`.
 
 Absent is unified, each removal above its replacement, which fits any
@@ -8414,7 +8441,9 @@ place of the date: `long` ("3 hours ago"), `short` ("3 hr. ago") or
 `narrow` ("3h ago").
 
 The reading refreshes as it goes stale, as `elapsed` does, and the whole
-date is its title. `elapsed` wins where both are set. */
+date is its title. `elapsed` wins where both are set. Written with no
+value, as `elapsed` is, or with a style `Intl` does not know, it reads
+`long`. */
   relative?: (HelixFormatDate["relative"]) | undefined;
   /** How the second is written, where a time of day is shown. */
   second?: (HelixFormatDate["second"]) | undefined;
@@ -12847,10 +12876,11 @@ one they already know. */
 invalid, as it is in a native number field.
 
 Unset, a step moves by one, or by one percent under a percent format, and
-a typed number is rounded to the smallest amount `format-options` shows
-rather than to whole steps, as React Aria's NumberField does: a field
-showing dollars keeps the cents typed into it. Without `format-options`
-the grid is whole numbers, as in a native number field. */
+a typed number is rounded to the smallest amount the format shows, as
+React Aria's NumberField does: a field showing dollars keeps the cents
+typed into it, and one with no `format-options` keeps three decimal
+places. `any` puts the number on no grid, as it does in a native number
+field: a step moves by one, and any number in range is valid. */
   step?: (HelixNumberInput["step"]) | undefined;
   /** The message the browser shows when the number is off the step grid, with
 `{below}` and `{above}` filled in with the nearest valid values, written in
@@ -12993,6 +13023,12 @@ reader sees the shape of the value before its contents. `0` starts with the
 root closed; a large number opens everything, which on a big value is the
 wall of text this exists to avoid. */
   defaultDepth?: (HelixObjectInspector["defaultDepth"]) | undefined;
+  /** What the tree says while there is no value to show, such as before a
+fetch answers. The `empty` slot replaces it. */
+  "empty-label"?: (HelixObjectInspector["emptyLabel"]) | undefined;
+  /** What the tree says while there is no value to show, such as before a
+fetch answers. The `empty` slot replaces it. */
+  emptyLabel?: (HelixObjectInspector["emptyLabel"]) | undefined;
   /** Text the tree is narrowed to: the entries whose key or value holds it,
 ignoring case, and the branches that lead to them. Empty shows everything. */
   filter?: (HelixObjectInspector["filter"]) | undefined;
@@ -13062,6 +13098,12 @@ who set the property. This button is positioned out of the flow and takes no
 room, so nothing selects on it, and reflection exists so that a selector can
 reach a value. */
   noCopy?: (HelixObjectInspector["noCopy"]) | undefined;
+  /** What the tree says while a filter matched no entry. The `empty` slot
+replaces it. */
+  "no-matches-label"?: (HelixObjectInspector["noMatchesLabel"]) | undefined;
+  /** What the tree says while a filter matched no entry. The `empty` slot
+replaces it. */
+  noMatchesLabel?: (HelixObjectInspector["noMatchesLabel"]) | undefined;
   /** What a screen reader hears when a filter matches one entry, where
 `results-label` should not say it. `{count}` is the count. */
   "result-label"?: (HelixObjectInspector["resultLabel"]) | undefined;
@@ -20181,9 +20223,15 @@ export type HelixVideoPlaylistHelixActivateElementEvent =
 /** `helix-before-activate` event type */
 export type HelixVideoPlaylistHelixBeforeActivateElementEvent =
   HelixVideoPlaylistElementEvent<HelixBeforeActivateEvent>;
+/** `helix-before-reorder` event type */
+export type HelixVideoPlaylistHelixBeforeReorderElementEvent =
+  HelixVideoPlaylistElementEvent<HelixBeforeReorderEvent>;
 /** `helix-end` event type */
 export type HelixVideoPlaylistHelixEndElementEvent =
   HelixVideoPlaylistElementEvent<HelixEndEvent>;
+/** `helix-reorder` event type */
+export type HelixVideoPlaylistHelixReorderElementEvent =
+  HelixVideoPlaylistElementEvent<HelixReorderEvent>;
 
 export type HelixVideoPlaylistVueProps = {
   /** The `value` of the current item.
@@ -20203,12 +20251,32 @@ Ignored once `active` is written. */
 
 Ignored once `active` is written. */
   defaultActive?: (HelixVideoPlaylist["defaultActive"]) | undefined;
+  /** What screen readers hear when a move is put back, in a `reorderable`
+playlist. `{name}` is the entry's words. */
+  "canceled-label"?: (HelixVideoPlaylist["canceledLabel"]) | undefined;
+  /** What screen readers hear when a move is put back, in a `reorderable`
+playlist. `{name}` is the entry's words. */
+  canceledLabel?: (HelixVideoPlaylist["canceledLabel"]) | undefined;
+  /** What screen readers hear when a moved entry is let go, in a `reorderable`
+playlist. `{name}` is the entry's words. */
+  "dropped-label"?: (HelixVideoPlaylist["droppedLabel"]) | undefined;
+  /** What screen readers hear when a moved entry is let go, in a `reorderable`
+playlist. `{name}` is the entry's words. */
+  droppedLabel?: (HelixVideoPlaylist["droppedLabel"]) | undefined;
   /** What the playlist says while it has no entries. The `empty` slot replaces it. */
   "empty-label"?: (HelixVideoPlaylist["emptyLabel"]) | undefined;
   /** What the playlist says while it has no entries. The `empty` slot replaces it. */
   emptyLabel?: (HelixVideoPlaylist["emptyLabel"]) | undefined;
   /** The list's name, read by screen readers. */
   label?: (HelixVideoPlaylist["label"]) | undefined;
+  /** What screen readers hear each time a key moves an entry, in a
+`reorderable` playlist. `{name}` is the entry's words, `{position}` its
+new place, counting from 1, and `{count}` the number of entries. */
+  "moved-label"?: (HelixVideoPlaylist["movedLabel"]) | undefined;
+  /** What screen readers hear each time a key moves an entry, in a
+`reorderable` playlist. `{name}` is the entry's words, `{position}` its
+new place, counting from 1, and `{count}` the number of entries. */
+  movedLabel?: (HelixVideoPlaylist["movedLabel"]) | undefined;
   /** Stays on an entry when its clip ends, where the playlist would otherwise
 play the next one. The player's controls, a press, and `next()` still
 move. `repeat="one"` still plays the entry again. */
@@ -20217,6 +20285,12 @@ move. `repeat="one"` still plays the entry again. */
 play the next one. The player's controls, a press, and `next()` still
 move. `repeat="one"` still plays the entry again. */
   noAdvance?: (HelixVideoPlaylist["noAdvance"]) | undefined;
+  /** What screen readers hear when a pointer picks up an entry, in a
+`reorderable` playlist. `{name}` is the entry's words. */
+  "picked-up-label"?: (HelixVideoPlaylist["pickedUpLabel"]) | undefined;
+  /** What screen readers hear when a pointer picks up an entry, in a
+`reorderable` playlist. `{name}` is the entry's words. */
+  pickedUpLabel?: (HelixVideoPlaylist["pickedUpLabel"]) | undefined;
   /** What the live region says when the playlist moves to another entry.
 `{title}` is the entry's name.
 
@@ -20231,6 +20305,10 @@ playlist starts the next one, and the only other trace of that is the
 playlist starts the next one, and the only other trace of that is the
 `aria-current` on a button the reader is not on. */
   playingLabel?: (HelixVideoPlaylist["playingLabel"]) | undefined;
+  /** Lets a reader move the entries, with Alt and the arrow keys or by
+dragging one. The playlist moves no entry itself: you move your entries
+on `helix-reorder`. */
+  reorderable?: (HelixVideoPlaylist["reorderable"]) | undefined;
   /** What happens when an entry ends with no next one to go to. `one` plays the
 same entry again, and `all` goes from the last entry back to the first.
 Absent, the playlist stops on the last entry and sends `helix-end`.
@@ -20250,8 +20328,12 @@ export type HelixVideoPlaylistVueEvents = {
   "helix-activate": HelixVideoPlaylistHelixActivateElementEvent;
   /** The current entry is about to change, and `detail.cause` says why: `press`, `next`, `previous`, `ended`, or `removed`. Cancelable: cancel it to keep the current entry. */
   "helix-before-activate": HelixVideoPlaylistHelixBeforeActivateElementEvent;
+  /** An entry was moved to a new place, in a `reorderable` playlist, with every entry's value in the new order in `detail.keys`. Cancelable: cancel it to keep the entry where it is. */
+  "helix-before-reorder": HelixVideoPlaylistHelixBeforeReorderElementEvent;
   /** The last entry finished playing, and the playlist stopped there. Not sent while `repeat` is set. */
   "helix-end": HelixVideoPlaylistHelixEndElementEvent;
+  /** Fired after `helix-before-reorder` when nobody canceled it. Move your entries to the order in `keys`. Cancelable: cancel it to say the move did not happen. */
+  "helix-reorder": HelixVideoPlaylistHelixReorderElementEvent;
 };
 
 /** `HelixVideo` component event */

package/types/words.d.ts

@@ -1157,6 +1157,21 @@ declare module '@fusion.dev/helix-core' {
        * English: `Show all lines`
        */
       expandLabel: Message
+      /**
+       * The words of a button that hides a run of unchanged lines it showed, in a
+       * diff with `context-lines`. `{count}` is how many, and each language
+       * writes the forms it has.
+       *
+       * English: `{count, plural, one {Hide # unchanged line} other {Hide # unchanged lines}}`
+       */
+      hideUnchangedLabel: Message
+      /**
+       * The words of a button that shows a folded run of unchanged lines, in a
+       * diff with `context-lines`. `{count}` is how many.
+       *
+       * English: `{count, plural, one {Show # unchanged line} other {Show # unchanged lines}}`
+       */
+      showUnchangedLabel: Message
       /**
        * The wrap button's name, which it keeps whether it is pressed or not.
        *
@@ -1895,6 +1910,13 @@ declare module '@fusion.dev/helix-core' {
        * English: `Copy value`
        */
       copyValueLabel: Message
+      /**
+       * What the tree says while there is no value to show, such as before a
+       * fetch answers. The `empty` slot replaces it.
+       *
+       * English: `Nothing to show`
+       */
+      emptyLabel: Message
       /**
        * The filter field's placeholder and accessible name.
        *
@@ -1917,6 +1939,13 @@ declare module '@fusion.dev/helix-core' {
        * English: `{count, plural, one {# key} other {# keys}}`
        */
       keysLabel: Message
+      /**
+       * What the tree says while a filter matched no entry. The `empty` slot
+       * replaces it.
+       *
+       * English: `No matches`
+       */
+      noMatchesLabel: Message
       /**
        * What a screen reader hears when a filter matches entries. `{count}` is
        * how many, written in the locale, and each language writes the forms it
@@ -2800,6 +2829,20 @@ declare module '@fusion.dev/helix-core' {
       volumeLabel: Message
     }
     'helix-video-playlist': {
+      /**
+       * What screen readers hear when a move is put back, in a `reorderable`
+       * playlist. `{name}` is the entry's words.
+       *
+       * English: `Canceled`
+       */
+      canceledLabel: Message
+      /**
+       * What screen readers hear when a moved entry is let go, in a `reorderable`
+       * playlist. `{name}` is the entry's words.
+       *
+       * English: `Dropped`
+       */
+      droppedLabel: Message
       /**
        * What the playlist says while it has no entries. The `empty` slot replaces it.
        *
@@ -2812,6 +2855,21 @@ declare module '@fusion.dev/helix-core' {
        * English: `Playlist`
        */
       label: Message
+      /**
+       * What screen readers hear each time a key moves an entry, in a
+       * `reorderable` playlist. `{name}` is the entry's words, `{position}` its
+       * new place, counting from 1, and `{count}` the number of entries.
+       *
+       * English: `{name} moved to position {position} of {count}`
+       */
+      movedLabel: Message
+      /**
+       * What screen readers hear when a pointer picks up an entry, in a
+       * `reorderable` playlist. `{name}` is the entry's words.
+       *
+       * English: `Picked up {name}`
+       */
+      pickedUpLabel: Message
       /**
        * What the live region says when the playlist moves to another entry.
        * `{title}` is the entry's name.