@fusion.dev/helix 0.163.0 → 0.164.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/types/vue.d.ts CHANGED
@@ -2025,6 +2025,11 @@ A word property: register it for a locale under the host's key. A family
2025
2025
  that names the control otherwise, such as Tag's `Remove {label}`,
2026
2026
  declares its own English with `@words` above the override. */
2027
2027
  dismissLabel?: (HelixCallout["dismissLabel"]) | undefined;
2028
+ /** Whether the callout is showing. A dismissal nobody canceled turns it
2029
+ false and the callout hides itself, and setting it true shows the callout
2030
+ again. Not reflected: open is the resting state, so an `open` attribute
2031
+ would appear on markup a server sent without it. */
2032
+ open?: (HelixCallout["open"]) | undefined;
2028
2033
  /** What kind of attention the passage needs.
2029
2034
 
2030
2035
  `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.
2059
2064
  };
2060
2065
 
2061
2066
  export type HelixCalloutVueEvents = {
2062
- /** The dismiss button was pressed. The callout does not remove itself, so remove it in response. Cancelable. */
2067
+ /** 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. */
2063
2068
  "helix-dismiss": HelixCalloutHelixDismissElementEvent;
2064
2069
  };
2065
2070
 
@@ -3981,6 +3986,14 @@ app.ts", as `code-name-label` puts it. */
3981
3986
  "collapse-label"?: (HelixCodeBlock["collapseLabel"]) | undefined;
3982
3987
  /** The expand button's words while the block shows every line. */
3983
3988
  collapseLabel?: (HelixCodeBlock["collapseLabel"]) | undefined;
3989
+ /** In a diff, how many unchanged lines to keep beside each change. Each
3990
+ longer run of unchanged lines is folded behind a button that shows it.
3991
+ Unset shows every line the diff holds. */
3992
+ "context-lines"?: (HelixCodeBlock["contextLines"] | `${number}`) | undefined;
3993
+ /** In a diff, how many unchanged lines to keep beside each change. Each
3994
+ longer run of unchanged lines is folded behind a button that shows it.
3995
+ Unset shows every line the diff holds. */
3996
+ contextLines?: (HelixCodeBlock["contextLines"]) | undefined;
3984
3997
  /** The copy button's name and tooltip text after a copy. */
3985
3998
  "copied-label"?: (HelixCodeBlock["copiedLabel"]) | undefined;
3986
3999
  /** 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. */
4019
4032
  "expand-label"?: (HelixCodeBlock["expandLabel"]) | undefined;
4020
4033
  /** The expand button's words while the cap hides lines. */
4021
4034
  expandLabel?: (HelixCodeBlock["expandLabel"]) | undefined;
4035
+ /** The words of a button that hides a run of unchanged lines it showed, in a
4036
+ diff with `context-lines`. `{count}` is how many, and each language
4037
+ writes the forms it has. */
4038
+ "hide-unchanged-label"?: (HelixCodeBlock["hideUnchangedLabel"]) | undefined;
4039
+ /** The words of a button that hides a run of unchanged lines it showed, in a
4040
+ diff with `context-lines`. `{count}` is how many, and each language
4041
+ writes the forms it has. */
4042
+ hideUnchangedLabel?: (HelixCodeBlock["hideUnchangedLabel"]) | undefined;
4022
4043
  /** The block's name, usually a file name, drawn in the header.
4023
4044
 
4024
4045
  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
4094
4115
  reflected property taking no default is satisfied by the default being
4095
4116
  `false`. */
4096
4117
  noCopy?: (HelixCodeBlock["noCopy"]) | undefined;
4118
+ /** The words of a button that shows a folded run of unchanged lines, in a
4119
+ diff with `context-lines`. `{count}` is how many. */
4120
+ "show-unchanged-label"?: (HelixCodeBlock["showUnchangedLabel"]) | undefined;
4121
+ /** The words of a button that shows a folded run of unchanged lines, in a
4122
+ diff with `context-lines`. `{count}` is how many. */
4123
+ showUnchangedLabel?: (HelixCodeBlock["showUnchangedLabel"]) | undefined;
4097
4124
  /** How a diff's two versions are arranged. It has no effect without `diff`.
4098
4125
 
4099
4126
  Absent is unified, each removal above its replacement, which fits any
@@ -12993,6 +13020,12 @@ reader sees the shape of the value before its contents. `0` starts with the
12993
13020
  root closed; a large number opens everything, which on a big value is the
12994
13021
  wall of text this exists to avoid. */
12995
13022
  defaultDepth?: (HelixObjectInspector["defaultDepth"]) | undefined;
13023
+ /** What the tree says while there is no value to show, such as before a
13024
+ fetch answers. The `empty` slot replaces it. */
13025
+ "empty-label"?: (HelixObjectInspector["emptyLabel"]) | undefined;
13026
+ /** What the tree says while there is no value to show, such as before a
13027
+ fetch answers. The `empty` slot replaces it. */
13028
+ emptyLabel?: (HelixObjectInspector["emptyLabel"]) | undefined;
12996
13029
  /** Text the tree is narrowed to: the entries whose key or value holds it,
12997
13030
  ignoring case, and the branches that lead to them. Empty shows everything. */
12998
13031
  filter?: (HelixObjectInspector["filter"]) | undefined;
@@ -13062,6 +13095,12 @@ who set the property. This button is positioned out of the flow and takes no
13062
13095
  room, so nothing selects on it, and reflection exists so that a selector can
13063
13096
  reach a value. */
13064
13097
  noCopy?: (HelixObjectInspector["noCopy"]) | undefined;
13098
+ /** What the tree says while a filter matched no entry. The `empty` slot
13099
+ replaces it. */
13100
+ "no-matches-label"?: (HelixObjectInspector["noMatchesLabel"]) | undefined;
13101
+ /** What the tree says while a filter matched no entry. The `empty` slot
13102
+ replaces it. */
13103
+ noMatchesLabel?: (HelixObjectInspector["noMatchesLabel"]) | undefined;
13065
13104
  /** What a screen reader hears when a filter matches one entry, where
13066
13105
  `results-label` should not say it. `{count}` is the count. */
13067
13106
  "result-label"?: (HelixObjectInspector["resultLabel"]) | undefined;
@@ -20181,9 +20220,15 @@ export type HelixVideoPlaylistHelixActivateElementEvent =
20181
20220
  /** `helix-before-activate` event type */
20182
20221
  export type HelixVideoPlaylistHelixBeforeActivateElementEvent =
20183
20222
  HelixVideoPlaylistElementEvent<HelixBeforeActivateEvent>;
20223
+ /** `helix-before-reorder` event type */
20224
+ export type HelixVideoPlaylistHelixBeforeReorderElementEvent =
20225
+ HelixVideoPlaylistElementEvent<HelixBeforeReorderEvent>;
20184
20226
  /** `helix-end` event type */
20185
20227
  export type HelixVideoPlaylistHelixEndElementEvent =
20186
20228
  HelixVideoPlaylistElementEvent<HelixEndEvent>;
20229
+ /** `helix-reorder` event type */
20230
+ export type HelixVideoPlaylistHelixReorderElementEvent =
20231
+ HelixVideoPlaylistElementEvent<HelixReorderEvent>;
20187
20232
 
20188
20233
  export type HelixVideoPlaylistVueProps = {
20189
20234
  /** The `value` of the current item.
@@ -20203,12 +20248,32 @@ Ignored once `active` is written. */
20203
20248
 
20204
20249
  Ignored once `active` is written. */
20205
20250
  defaultActive?: (HelixVideoPlaylist["defaultActive"]) | undefined;
20251
+ /** What screen readers hear when a move is put back, in a `reorderable`
20252
+ playlist. `{name}` is the entry's words. */
20253
+ "canceled-label"?: (HelixVideoPlaylist["canceledLabel"]) | undefined;
20254
+ /** What screen readers hear when a move is put back, in a `reorderable`
20255
+ playlist. `{name}` is the entry's words. */
20256
+ canceledLabel?: (HelixVideoPlaylist["canceledLabel"]) | undefined;
20257
+ /** What screen readers hear when a moved entry is let go, in a `reorderable`
20258
+ playlist. `{name}` is the entry's words. */
20259
+ "dropped-label"?: (HelixVideoPlaylist["droppedLabel"]) | undefined;
20260
+ /** What screen readers hear when a moved entry is let go, in a `reorderable`
20261
+ playlist. `{name}` is the entry's words. */
20262
+ droppedLabel?: (HelixVideoPlaylist["droppedLabel"]) | undefined;
20206
20263
  /** What the playlist says while it has no entries. The `empty` slot replaces it. */
20207
20264
  "empty-label"?: (HelixVideoPlaylist["emptyLabel"]) | undefined;
20208
20265
  /** What the playlist says while it has no entries. The `empty` slot replaces it. */
20209
20266
  emptyLabel?: (HelixVideoPlaylist["emptyLabel"]) | undefined;
20210
20267
  /** The list's name, read by screen readers. */
20211
20268
  label?: (HelixVideoPlaylist["label"]) | undefined;
20269
+ /** What screen readers hear each time a key moves an entry, in a
20270
+ `reorderable` playlist. `{name}` is the entry's words, `{position}` its
20271
+ new place, counting from 1, and `{count}` the number of entries. */
20272
+ "moved-label"?: (HelixVideoPlaylist["movedLabel"]) | undefined;
20273
+ /** What screen readers hear each time a key moves an entry, in a
20274
+ `reorderable` playlist. `{name}` is the entry's words, `{position}` its
20275
+ new place, counting from 1, and `{count}` the number of entries. */
20276
+ movedLabel?: (HelixVideoPlaylist["movedLabel"]) | undefined;
20212
20277
  /** Stays on an entry when its clip ends, where the playlist would otherwise
20213
20278
  play the next one. The player's controls, a press, and `next()` still
20214
20279
  move. `repeat="one"` still plays the entry again. */
@@ -20217,6 +20282,12 @@ move. `repeat="one"` still plays the entry again. */
20217
20282
  play the next one. The player's controls, a press, and `next()` still
20218
20283
  move. `repeat="one"` still plays the entry again. */
20219
20284
  noAdvance?: (HelixVideoPlaylist["noAdvance"]) | undefined;
20285
+ /** What screen readers hear when a pointer picks up an entry, in a
20286
+ `reorderable` playlist. `{name}` is the entry's words. */
20287
+ "picked-up-label"?: (HelixVideoPlaylist["pickedUpLabel"]) | undefined;
20288
+ /** What screen readers hear when a pointer picks up an entry, in a
20289
+ `reorderable` playlist. `{name}` is the entry's words. */
20290
+ pickedUpLabel?: (HelixVideoPlaylist["pickedUpLabel"]) | undefined;
20220
20291
  /** What the live region says when the playlist moves to another entry.
20221
20292
  `{title}` is the entry's name.
20222
20293
 
@@ -20231,6 +20302,10 @@ playlist starts the next one, and the only other trace of that is the
20231
20302
  playlist starts the next one, and the only other trace of that is the
20232
20303
  `aria-current` on a button the reader is not on. */
20233
20304
  playingLabel?: (HelixVideoPlaylist["playingLabel"]) | undefined;
20305
+ /** Lets a reader move the entries, with Alt and the arrow keys or by
20306
+ dragging one. The playlist moves no entry itself: you move your entries
20307
+ on `helix-reorder`. */
20308
+ reorderable?: (HelixVideoPlaylist["reorderable"]) | undefined;
20234
20309
  /** What happens when an entry ends with no next one to go to. `one` plays the
20235
20310
  same entry again, and `all` goes from the last entry back to the first.
20236
20311
  Absent, the playlist stops on the last entry and sends `helix-end`.
@@ -20250,8 +20325,12 @@ export type HelixVideoPlaylistVueEvents = {
20250
20325
  "helix-activate": HelixVideoPlaylistHelixActivateElementEvent;
20251
20326
  /** 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. */
20252
20327
  "helix-before-activate": HelixVideoPlaylistHelixBeforeActivateElementEvent;
20328
+ /** 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. */
20329
+ "helix-before-reorder": HelixVideoPlaylistHelixBeforeReorderElementEvent;
20253
20330
  /** The last entry finished playing, and the playlist stopped there. Not sent while `repeat` is set. */
20254
20331
  "helix-end": HelixVideoPlaylistHelixEndElementEvent;
20332
+ /** 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. */
20333
+ "helix-reorder": HelixVideoPlaylistHelixReorderElementEvent;
20255
20334
  };
20256
20335
 
20257
20336
  /** `HelixVideo` component event */
package/types/words.d.ts CHANGED
@@ -1157,6 +1157,21 @@ declare module '@fusion.dev/helix-core' {
1157
1157
  * English: `Show all lines`
1158
1158
  */
1159
1159
  expandLabel: Message
1160
+ /**
1161
+ * The words of a button that hides a run of unchanged lines it showed, in a
1162
+ * diff with `context-lines`. `{count}` is how many, and each language
1163
+ * writes the forms it has.
1164
+ *
1165
+ * English: `{count, plural, one {Hide # unchanged line} other {Hide # unchanged lines}}`
1166
+ */
1167
+ hideUnchangedLabel: Message
1168
+ /**
1169
+ * The words of a button that shows a folded run of unchanged lines, in a
1170
+ * diff with `context-lines`. `{count}` is how many.
1171
+ *
1172
+ * English: `{count, plural, one {Show # unchanged line} other {Show # unchanged lines}}`
1173
+ */
1174
+ showUnchangedLabel: Message
1160
1175
  /**
1161
1176
  * The wrap button's name, which it keeps whether it is pressed or not.
1162
1177
  *
@@ -1895,6 +1910,13 @@ declare module '@fusion.dev/helix-core' {
1895
1910
  * English: `Copy value`
1896
1911
  */
1897
1912
  copyValueLabel: Message
1913
+ /**
1914
+ * What the tree says while there is no value to show, such as before a
1915
+ * fetch answers. The `empty` slot replaces it.
1916
+ *
1917
+ * English: `Nothing to show`
1918
+ */
1919
+ emptyLabel: Message
1898
1920
  /**
1899
1921
  * The filter field's placeholder and accessible name.
1900
1922
  *
@@ -1917,6 +1939,13 @@ declare module '@fusion.dev/helix-core' {
1917
1939
  * English: `{count, plural, one {# key} other {# keys}}`
1918
1940
  */
1919
1941
  keysLabel: Message
1942
+ /**
1943
+ * What the tree says while a filter matched no entry. The `empty` slot
1944
+ * replaces it.
1945
+ *
1946
+ * English: `No matches`
1947
+ */
1948
+ noMatchesLabel: Message
1920
1949
  /**
1921
1950
  * What a screen reader hears when a filter matches entries. `{count}` is
1922
1951
  * how many, written in the locale, and each language writes the forms it
@@ -2800,6 +2829,20 @@ declare module '@fusion.dev/helix-core' {
2800
2829
  volumeLabel: Message
2801
2830
  }
2802
2831
  'helix-video-playlist': {
2832
+ /**
2833
+ * What screen readers hear when a move is put back, in a `reorderable`
2834
+ * playlist. `{name}` is the entry's words.
2835
+ *
2836
+ * English: `Canceled`
2837
+ */
2838
+ canceledLabel: Message
2839
+ /**
2840
+ * What screen readers hear when a moved entry is let go, in a `reorderable`
2841
+ * playlist. `{name}` is the entry's words.
2842
+ *
2843
+ * English: `Dropped`
2844
+ */
2845
+ droppedLabel: Message
2803
2846
  /**
2804
2847
  * What the playlist says while it has no entries. The `empty` slot replaces it.
2805
2848
  *
@@ -2812,6 +2855,21 @@ declare module '@fusion.dev/helix-core' {
2812
2855
  * English: `Playlist`
2813
2856
  */
2814
2857
  label: Message
2858
+ /**
2859
+ * What screen readers hear each time a key moves an entry, in a
2860
+ * `reorderable` playlist. `{name}` is the entry's words, `{position}` its
2861
+ * new place, counting from 1, and `{count}` the number of entries.
2862
+ *
2863
+ * English: `{name} moved to position {position} of {count}`
2864
+ */
2865
+ movedLabel: Message
2866
+ /**
2867
+ * What screen readers hear when a pointer picks up an entry, in a
2868
+ * `reorderable` playlist. `{name}` is the entry's words.
2869
+ *
2870
+ * English: `Picked up {name}`
2871
+ */
2872
+ pickedUpLabel: Message
2815
2873
  /**
2816
2874
  * What the live region says when the playlist moves to another entry.
2817
2875
  * `{title}` is the entry's name.