@fusion.dev/helix 0.178.0 → 0.180.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/jsx.d.ts CHANGED
@@ -1696,6 +1696,14 @@ hit-testable at rest, or it would swallow clicks meant for what is over it,
1696
1696
  and an element that is not hit-testable never receives the `pointermove`
1697
1697
  this listens for. Asking for the pointer is asking for the hit test. */
1698
1698
  interactive?: (HelixAura["interactive"]) | undefined;
1699
+ /** Whether the aura draws its own control that pauses the field and starts it
1700
+ again, in its trailing corner. Absent draws none, for a page with a pause
1701
+ control of its own. */
1702
+ "pause-control"?: (HelixAura["pauseControl"]) | undefined;
1703
+ /** Whether the aura draws its own control that pauses the field and starts it
1704
+ again, in its trailing corner. Absent draws none, for a page with a pause
1705
+ control of its own. */
1706
+ pauseControl?: (HelixAura["pauseControl"]) | undefined;
1699
1707
  /** Whether the field holds still on the frame it shows.
1700
1708
 
1701
1709
  Set it from a pause control on your page, so a reader can stop the motion,
@@ -1703,6 +1711,14 @@ as WCAG 2.2.2 asks of anything that moves for more than five seconds. A
1703
1711
  change to another property still repaints the frame. Clearing it starts
1704
1712
  the field from where it stopped. */
1705
1713
  paused?: (HelixAura["paused"]) | undefined;
1714
+ /** The pause control's name, read by screen readers. The control is a toggle
1715
+ and says it is pressed while the field is paused, so the name stays the
1716
+ same. */
1717
+ "pause-label"?: (HelixAura["pauseLabel"]) | undefined;
1718
+ /** The pause control's name, read by screen readers. The control is a toggle
1719
+ and says it is pressed while the field is paused, so the name stays the
1720
+ same. */
1721
+ pauseLabel?: (HelixAura["pauseLabel"]) | undefined;
1706
1722
  /** How far the pointer reaches into the field, `0` upward.
1707
1723
 
1708
1724
  Multiplied into the presence the pointer already fades in and out with, so
@@ -1773,6 +1789,8 @@ look, which is what `variant` is for by the rule the registry already
1773
1789
  states. */
1774
1790
  variant?: (HelixAura["variant"]) | undefined;
1775
1791
 
1792
+ /** Fired when the aura's own pause control pauses the field or starts it again. */
1793
+ onchange?: ((e: HelixAuraElementEvent) => void) | undefined;
1776
1794
  /** Fired each time the aura stops drawing its shader and shows its gradient, with the reason. */
1777
1795
  "onhelix-aura-fallback"?: ((e: HelixAuraHelixAuraFallbackElementEvent) => void) | undefined;
1778
1796
  };
@@ -1815,6 +1833,14 @@ hit-testable at rest, or it would swallow clicks meant for what is over it,
1815
1833
  and an element that is not hit-testable never receives the `pointermove`
1816
1834
  this listens for. Asking for the pointer is asking for the hit test. */
1817
1835
  "prop:interactive"?: (HelixAura["interactive"]) | undefined;
1836
+ /** Whether the aura draws its own control that pauses the field and starts it
1837
+ again, in its trailing corner. Absent draws none, for a page with a pause
1838
+ control of its own. */
1839
+ "bool:pause-control"?: (HelixAura["pauseControl"]) | undefined;
1840
+ /** Whether the aura draws its own control that pauses the field and starts it
1841
+ again, in its trailing corner. Absent draws none, for a page with a pause
1842
+ control of its own. */
1843
+ "prop:pauseControl"?: (HelixAura["pauseControl"]) | undefined;
1818
1844
  /** Whether the field holds still on the frame it shows.
1819
1845
 
1820
1846
  Set it from a pause control on your page, so a reader can stop the motion,
@@ -1822,6 +1848,14 @@ as WCAG 2.2.2 asks of anything that moves for more than five seconds. A
1822
1848
  change to another property still repaints the frame. Clearing it starts
1823
1849
  the field from where it stopped. */
1824
1850
  "prop:paused"?: (HelixAura["paused"]) | undefined;
1851
+ /** The pause control's name, read by screen readers. The control is a toggle
1852
+ and says it is pressed while the field is paused, so the name stays the
1853
+ same. */
1854
+ "attr:pause-label"?: (HelixAura["pauseLabel"]) | undefined;
1855
+ /** The pause control's name, read by screen readers. The control is a toggle
1856
+ and says it is pressed while the field is paused, so the name stays the
1857
+ same. */
1858
+ "prop:pauseLabel"?: (HelixAura["pauseLabel"]) | undefined;
1825
1859
  /** How far the pointer reaches into the field, `0` upward.
1826
1860
 
1827
1861
  Multiplied into the presence the pointer already fades in and out with, so
@@ -1891,6 +1925,8 @@ Aurora, braid and caustics are not geometries; they are eleven names for a
1891
1925
  look, which is what `variant` is for by the rule the registry already
1892
1926
  states. */
1893
1927
  "prop:variant"?: (HelixAura["variant"]) | undefined;
1928
+ /** Fired when the aura's own pause control pauses the field or starts it again. */
1929
+ "on:change"?: ((e: HelixAuraElementEvent) => void) | undefined;
1894
1930
  /** Fired each time the aura stops drawing its shader and shows its gradient, with the reason. */
1895
1931
  "on:helix-aura-fallback"?: ((
1896
1932
  e: HelixAuraHelixAuraFallbackElementEvent,
@@ -12301,6 +12337,12 @@ for the page's language, then the English. */
12301
12337
  so a form in another language speaks it. Unset is the sentence registered
12302
12338
  for the page's language, then the English. */
12303
12339
  rangeLengthMessage?: (HelixDateInput["rangeLengthMessage"]) | undefined;
12340
+ /** The message shown when a range ends before it starts. `{start}` is
12341
+ replaced with the start, written the way the field writes dates. */
12342
+ "range-order-message"?: (HelixDateInput["rangeOrderMessage"]) | undefined;
12343
+ /** The message shown when a range ends before it starts. `{start}` is
12344
+ replaced with the start, written the way the field writes dates. */
12345
+ rangeOrderMessage?: (HelixDateInput["rangeOrderMessage"]) | undefined;
12304
12346
  /** The message shown when a date is after `max`. `{max}` is replaced with
12305
12347
  `max`, written the way the field writes dates. */
12306
12348
  "range-overflow-message"?: (HelixDateInput["rangeOverflowMessage"]) | undefined;
@@ -12833,6 +12875,12 @@ for the page's language, then the English. */
12833
12875
  so a form in another language speaks it. Unset is the sentence registered
12834
12876
  for the page's language, then the English. */
12835
12877
  "prop:rangeLengthMessage"?: (HelixDateInput["rangeLengthMessage"]) | undefined;
12878
+ /** The message shown when a range ends before it starts. `{start}` is
12879
+ replaced with the start, written the way the field writes dates. */
12880
+ "attr:range-order-message"?: (HelixDateInput["rangeOrderMessage"]) | undefined;
12881
+ /** The message shown when a range ends before it starts. `{start}` is
12882
+ replaced with the start, written the way the field writes dates. */
12883
+ "prop:rangeOrderMessage"?: (HelixDateInput["rangeOrderMessage"]) | undefined;
12836
12884
  /** The message shown when a date is after `max`. `{max}` is replaced with
12837
12885
  `max`, written the way the field writes dates. */
12838
12886
  "attr:range-overflow-message"?: (HelixDateInput["rangeOverflowMessage"]) | undefined;
@@ -13182,6 +13230,12 @@ it. */
13182
13230
  "previous-years-label"?: (HelixDatePicker["previousYearsLabel"]) | undefined;
13183
13231
  /** Accessible name for the control that moves back a page, in the years. */
13184
13232
  previousYearsLabel?: (HelixDatePicker["previousYearsLabel"]) | undefined;
13233
+ /** The validation message for a range that ends before it starts. `{start}`
13234
+ is replaced with the start, written as a date in `locale`. */
13235
+ "range-order-message"?: (HelixDatePicker["rangeOrderMessage"]) | undefined;
13236
+ /** The validation message for a range that ends before it starts. `{start}`
13237
+ is replaced with the start, written as a date in `locale`. */
13238
+ rangeOrderMessage?: (HelixDatePicker["rangeOrderMessage"]) | undefined;
13185
13239
  /** The validation message for a date after `max`. `{max}` is replaced with
13186
13240
  `max`, written as a date in `locale`. */
13187
13241
  "range-overflow-message"?: (HelixDatePicker["rangeOverflowMessage"]) | undefined;
@@ -13535,6 +13589,12 @@ it. */
13535
13589
  "attr:previous-years-label"?: (HelixDatePicker["previousYearsLabel"]) | undefined;
13536
13590
  /** Accessible name for the control that moves back a page, in the years. */
13537
13591
  "prop:previousYearsLabel"?: (HelixDatePicker["previousYearsLabel"]) | undefined;
13592
+ /** The validation message for a range that ends before it starts. `{start}`
13593
+ is replaced with the start, written as a date in `locale`. */
13594
+ "attr:range-order-message"?: (HelixDatePicker["rangeOrderMessage"]) | undefined;
13595
+ /** The validation message for a range that ends before it starts. `{start}`
13596
+ is replaced with the start, written as a date in `locale`. */
13597
+ "prop:rangeOrderMessage"?: (HelixDatePicker["rangeOrderMessage"]) | undefined;
13538
13598
  /** The validation message for a date after `max`. `{max}` is replaced with
13539
13599
  `max`, written as a date in `locale`. */
13540
13600
  "attr:range-overflow-message"?: (HelixDatePicker["rangeOverflowMessage"]) | undefined;
@@ -17909,11 +17969,36 @@ export type HelixHeatmapElementEvent<E = Event> = TypedEvent<HelixHeatmap, E>;
17909
17969
  /** `helix-before-change` event type */
17910
17970
  export type HelixHeatmapHelixBeforeChangeElementEvent =
17911
17971
  HelixHeatmapElementEvent<HelixBeforeChangeEvent>;
17972
+ /** `helix-reading-change` event type */
17973
+ export type HelixHeatmapHelixReadingChangeElementEvent =
17974
+ HelixHeatmapElementEvent<HelixReadingChangeEvent>;
17975
+ /** `helix-reading-press` event type */
17976
+ export type HelixHeatmapHelixReadingPressElementEvent =
17977
+ HelixHeatmapElementEvent<HelixReadingPressEvent>;
17912
17978
  /** `helix-resize` event type */
17913
17979
  export type HelixHeatmapHelixResizeElementEvent =
17914
17980
  HelixHeatmapElementEvent<HelixResizeEvent>;
17915
17981
 
17916
17982
  export type HelixHeatmapProps = {
17983
+ /** The words shown in place of the drawing when the table has no readings,
17984
+ and the fallback of the `empty` slot. */
17985
+ "empty-text"?: (HelixHeatmap["emptyText"]) | undefined;
17986
+ /** The words shown in place of the drawing when the table has no readings,
17987
+ and the fallback of the `empty` slot. */
17988
+ emptyText?: (HelixHeatmap["emptyText"]) | undefined;
17989
+ /** Whether the readings are still on their way. The chart shows
17990
+ `loading-text` in place of an empty drawing until it has readings.
17991
+
17992
+ Reflected, so a stylesheet can treat the chart while it waits. A chart
17993
+ that already has readings keeps drawing them, so a refresh does not
17994
+ blank it. */
17995
+ loading?: (HelixHeatmap["loading"]) | undefined;
17996
+ /** The words shown in place of the drawing while `loading` is set and
17997
+ there are no readings yet, and the fallback of the `loading` slot. */
17998
+ "loading-text"?: (HelixHeatmap["loadingText"]) | undefined;
17999
+ /** The words shown in place of the drawing while `loading` is set and
18000
+ there are no readings yet, and the fallback of the `loading` slot. */
18001
+ loadingText?: (HelixHeatmap["loadingText"]) | undefined;
17917
18002
  /** The id of the table to read.
17918
18003
 
17919
18004
  Names a table in the same tree, so a chart inside another component's
@@ -17956,16 +18041,6 @@ legend hid is not counted. */
17956
18041
  /** The name the `overview` gives the busiest reading, `{busiestLabel}` in
17957
18042
  `overview-label`. */
17958
18043
  busiestLabel?: (HelixHeatmap["busiestLabel"]) | undefined;
17959
- /** Shown when the table has no readings in it.
17960
-
17961
- Never shown while the table cannot be read at all, which is a server render
17962
- and the hydrating one after it: see `sourceKnown`. */
17963
- "empty-text"?: (HelixHeatmap["emptyText"]) | undefined;
17964
- /** Shown when the table has no readings in it.
17965
-
17966
- Never shown while the table cannot be read at all, which is a server render
17967
- and the hydrating one after it: see `sourceKnown`. */
17968
- emptyText?: (HelixHeatmap["emptyText"]) | undefined;
17969
18044
  /** Space between cells, in CSS pixels. It is a number for the same reason
17970
18045
  `min-cell` is. */
17971
18046
  gap?: (HelixHeatmap["gap"]) | undefined;
@@ -18023,13 +18098,9 @@ calendar heatmap does: a week is a column, so the strip reads along the
18023
18098
  line in weeks, from the right on a right-to-left page, and top to bottom in
18024
18099
  days. */
18025
18100
  rows?: (HelixHeatmap["rows"]) | undefined;
18026
- /** What the readout adds for a selected cell, under `selection-mode`, after
18027
- where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
18028
- nothing. */
18101
+ /** What the readout added for a selected cell, under `selection-mode`. */
18029
18102
  "selected-label"?: (HelixHeatmap["selectedLabel"]) | undefined;
18030
- /** What the readout adds for a selected cell, under `selection-mode`, after
18031
- where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
18032
- nothing. */
18103
+ /** What the readout added for a selected cell, under `selection-mode`. */
18033
18104
  selectedLabel?: (HelixHeatmap["selectedLabel"]) | undefined;
18034
18105
  /** What the `selection` part says after the selection changes. `{count}` is
18035
18106
  how many cells are selected, written in the locale, and a language that
@@ -18116,11 +18187,38 @@ does not look inside the one it has. */
18116
18187
  "onhelix-before-change"?: ((
18117
18188
  e: HelixHeatmapHelixBeforeChangeElementEvent,
18118
18189
  ) => void) | undefined;
18190
+ /** The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, and the `pointerType` that moved it. */
18191
+ "onhelix-reading-change"?: ((
18192
+ e: HelixHeatmapHelixReadingChangeElementEvent,
18193
+ ) => void) | undefined;
18194
+ /** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
18195
+ "onhelix-reading-press"?: ((
18196
+ e: HelixHeatmapHelixReadingPressElementEvent,
18197
+ ) => void) | undefined;
18119
18198
  /** Fired when the number of cells drawn changes, with the new number. */
18120
18199
  "onhelix-resize"?: ((e: HelixHeatmapHelixResizeElementEvent) => void) | undefined;
18121
18200
  };
18122
18201
 
18123
18202
  export type HelixHeatmapSolidJsProps = {
18203
+ /** The words shown in place of the drawing when the table has no readings,
18204
+ and the fallback of the `empty` slot. */
18205
+ "attr:empty-text"?: (HelixHeatmap["emptyText"]) | undefined;
18206
+ /** The words shown in place of the drawing when the table has no readings,
18207
+ and the fallback of the `empty` slot. */
18208
+ "prop:emptyText"?: (HelixHeatmap["emptyText"]) | undefined;
18209
+ /** Whether the readings are still on their way. The chart shows
18210
+ `loading-text` in place of an empty drawing until it has readings.
18211
+
18212
+ Reflected, so a stylesheet can treat the chart while it waits. A chart
18213
+ that already has readings keeps drawing them, so a refresh does not
18214
+ blank it. */
18215
+ "prop:loading"?: (HelixHeatmap["loading"]) | undefined;
18216
+ /** The words shown in place of the drawing while `loading` is set and
18217
+ there are no readings yet, and the fallback of the `loading` slot. */
18218
+ "attr:loading-text"?: (HelixHeatmap["loadingText"]) | undefined;
18219
+ /** The words shown in place of the drawing while `loading` is set and
18220
+ there are no readings yet, and the fallback of the `loading` slot. */
18221
+ "prop:loadingText"?: (HelixHeatmap["loadingText"]) | undefined;
18124
18222
  /** The id of the table to read.
18125
18223
 
18126
18224
  Names a table in the same tree, so a chart inside another component's
@@ -18163,16 +18261,6 @@ legend hid is not counted. */
18163
18261
  /** The name the `overview` gives the busiest reading, `{busiestLabel}` in
18164
18262
  `overview-label`. */
18165
18263
  "prop:busiestLabel"?: (HelixHeatmap["busiestLabel"]) | undefined;
18166
- /** Shown when the table has no readings in it.
18167
-
18168
- Never shown while the table cannot be read at all, which is a server render
18169
- and the hydrating one after it: see `sourceKnown`. */
18170
- "attr:empty-text"?: (HelixHeatmap["emptyText"]) | undefined;
18171
- /** Shown when the table has no readings in it.
18172
-
18173
- Never shown while the table cannot be read at all, which is a server render
18174
- and the hydrating one after it: see `sourceKnown`. */
18175
- "prop:emptyText"?: (HelixHeatmap["emptyText"]) | undefined;
18176
18264
  /** Space between cells, in CSS pixels. It is a number for the same reason
18177
18265
  `min-cell` is. */
18178
18266
  "prop:gap"?: (HelixHeatmap["gap"]) | undefined;
@@ -18230,13 +18318,9 @@ calendar heatmap does: a week is a column, so the strip reads along the
18230
18318
  line in weeks, from the right on a right-to-left page, and top to bottom in
18231
18319
  days. */
18232
18320
  "prop:rows"?: (HelixHeatmap["rows"]) | undefined;
18233
- /** What the readout adds for a selected cell, under `selection-mode`, after
18234
- where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
18235
- nothing. */
18321
+ /** What the readout added for a selected cell, under `selection-mode`. */
18236
18322
  "attr:selected-label"?: (HelixHeatmap["selectedLabel"]) | undefined;
18237
- /** What the readout adds for a selected cell, under `selection-mode`, after
18238
- where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
18239
- nothing. */
18323
+ /** What the readout added for a selected cell, under `selection-mode`. */
18240
18324
  "prop:selectedLabel"?: (HelixHeatmap["selectedLabel"]) | undefined;
18241
18325
  /** What the `selection` part says after the selection changes. `{count}` is
18242
18326
  how many cells are selected, written in the locale, and a language that
@@ -18322,6 +18406,14 @@ does not look inside the one it has. */
18322
18406
  "on:helix-before-change"?: ((
18323
18407
  e: HelixHeatmapHelixBeforeChangeElementEvent,
18324
18408
  ) => void) | undefined;
18409
+ /** The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, and the `pointerType` that moved it. */
18410
+ "on:helix-reading-change"?: ((
18411
+ e: HelixHeatmapHelixReadingChangeElementEvent,
18412
+ ) => void) | undefined;
18413
+ /** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
18414
+ "on:helix-reading-press"?: ((
18415
+ e: HelixHeatmapHelixReadingPressElementEvent,
18416
+ ) => void) | undefined;
18325
18417
  /** Fired when the number of cells drawn changes, with the new number. */
18326
18418
  "on:helix-resize"?: ((e: HelixHeatmapHelixResizeElementEvent) => void) | undefined;
18327
18419
 
@@ -21741,7 +21833,8 @@ React Aria virtualizes a `ListBox` with its `Virtualizer`; this is core's
21741
21833
 
21742
21834
  **The list needs a height to scroll in**: the styled tier's
21743
21835
  `--listbox-max-block-size`, or a `max-block-size` on `::part(items)` in the
21744
- headless tier. Import the Option family as well, whose elements are drawn.
21836
+ headless tier. The options drawn are this tier's Option, which the page
21837
+ imports, as it imports the options it writes.
21745
21838
  A server sends the list empty, and the options are drawn once it hydrates. */
21746
21839
  items?: (HelixListbox["items"]) | undefined;
21747
21840
  /** Which option is chosen, as an index, or `-1` where none is.
@@ -22041,7 +22134,8 @@ React Aria virtualizes a `ListBox` with its `Virtualizer`; this is core's
22041
22134
 
22042
22135
  **The list needs a height to scroll in**: the styled tier's
22043
22136
  `--listbox-max-block-size`, or a `max-block-size` on `::part(items)` in the
22044
- headless tier. Import the Option family as well, whose elements are drawn.
22137
+ headless tier. The options drawn are this tier's Option, which the page
22138
+ imports, as it imports the options it writes.
22045
22139
  A server sends the list empty, and the options are drawn once it hydrates. */
22046
22140
  "prop:items"?: (HelixListbox["items"]) | undefined;
22047
22141
  /** Which option is chosen, as an index, or `-1` where none is.
@@ -43076,8 +43170,8 @@ export type CustomElements = {
43076
43170
  * The shader stops drawing in these cases:
43077
43171
  * - The element is off screen or in a background tab.
43078
43172
  * - `prefers-reduced-motion` is set. The element shows one still frame.
43079
- * - `paused` is set, from a pause control on your page. The element holds the
43080
- * frame it shows.
43173
+ * - `paused` is set, from a pause control on your page or from the aura's own
43174
+ * under `pause-control`. The element holds the frame it shows.
43081
43175
  * - The browser takes back the drawing context, on a GPU reset or past its
43082
43176
  * limit of about sixteen contexts. The gradient shows until the context
43083
43177
  * returns.
@@ -43101,6 +43195,13 @@ export type CustomElements = {
43101
43195
  * changed while the aura draws, by a class, a style or the color mode,
43102
43196
  * reaches the shader on the next frame.
43103
43197
  *
43198
+ * **`pause-control` draws a control that stops the motion and starts it
43199
+ * again**, in the trailing corner of the field, as WCAG 2.2.2 asks of
43200
+ * anything that moves for more than five seconds. It is a toggle button named
43201
+ * by `pause-label`, which says it is pressed while the field is paused, and a
43202
+ * press sends `change`. A reader who asked for reduced motion sees no motion
43203
+ * and no control.
43204
+ *
43104
43205
  * Where the gradient shows in place of the shader, the aura matches
43105
43206
  * `:state(fallback)` and sends `helix-aura-fallback` with the reason.
43106
43207
  *
@@ -43140,12 +43241,18 @@ export type CustomElements = {
43140
43241
  * hit-testable at rest, or it would swallow clicks meant for what is over it,
43141
43242
  * and an element that is not hit-testable never receives the `pointermove`
43142
43243
  * this listens for. Asking for the pointer is asking for the hit test.
43244
+ * - `pause-control`/`pauseControl`: Whether the aura draws its own control that pauses the field and starts it
43245
+ * again, in its trailing corner. Absent draws none, for a page with a pause
43246
+ * control of its own.
43143
43247
  * - `paused`: Whether the field holds still on the frame it shows.
43144
43248
  *
43145
43249
  * Set it from a pause control on your page, so a reader can stop the motion,
43146
43250
  * as WCAG 2.2.2 asks of anything that moves for more than five seconds. A
43147
43251
  * change to another property still repaints the frame. Clearing it starts
43148
43252
  * the field from where it stopped.
43253
+ * - `pause-label`/`pauseLabel`: The pause control's name, read by screen readers. The control is a toggle
43254
+ * and says it is pressed while the field is paused, so the name stays the
43255
+ * same.
43149
43256
  * - `reach`: How far the pointer reaches into the field, `0` upward.
43150
43257
  *
43151
43258
  * Multiplied into the presence the pointer already fades in and out with, so
@@ -43233,6 +43340,7 @@ export type CustomElements = {
43233
43340
  *
43234
43341
  * Events that will be emitted by the component.
43235
43342
  *
43343
+ * - `change`: Fired when the aura's own pause control pauses the field or starts it again.
43236
43344
  * - `helix-aura-fallback`: Fired each time the aura stops drawing its shader and shows its gradient, with the reason.
43237
43345
  *
43238
43346
  * ## Slots
@@ -43248,6 +43356,7 @@ export type CustomElements = {
43248
43356
  * - `--aura-glow`: The bright stop of the ramp. Defaults to `--helix-color-primary`.
43249
43357
  * - `--aura-ground`: The page the field fades into. Defaults to `--helix-color-background`.
43250
43358
  * - `--aura-haze`: The faint stop between the ground and the glow. Defaults to `--helix-color-primary-subtle`.
43359
+ * - `--aura-pause-background-color`: The pause control's ground. Defaults to `--helix-color-surface-overlay`.
43251
43360
  * - `--aura-peak`: The hottest stop, at the center of a shape. Defaults to `--helix-color-primary-active` on a light page and `--helix-color-foreground` on a dark one.
43252
43361
  *
43253
43362
  * ## CSS Parts
@@ -43256,6 +43365,8 @@ export type CustomElements = {
43256
43365
  *
43257
43366
  * - `canvas`: The surface the shader draws into.
43258
43367
  * - `content`: The box over the field that holds the content. It covers the aura.
43368
+ * - `pause`: The control that pauses the field and starts it again, drawn under `pause-control`.
43369
+ * - `pause-mark`: The glyph on the pause control: pause while the field moves, play while it is paused.
43259
43370
  *
43260
43371
  * ## CSS States
43261
43372
  *
@@ -44721,6 +44832,15 @@ export type CustomElements = {
44721
44832
  *
44722
44833
  * Methods that can be called to access component functionality.
44723
44834
  *
44835
+ * - `click() => void`: Presses the button, as `click()` presses a native one: the command is sent,
44836
+ * the form submits or resets, and `helix-press` says `virtual`.
44837
+ *
44838
+ * **Passed to the inner control, because a click on the host reaches nothing
44839
+ * that acts.** The control in the shadow root is what answers a click, so
44840
+ * `click()` from a script, an automation or a test, dispatched on the host,
44841
+ * submitted nothing and sent no `helix-press`. The control's own click reaches
44842
+ * the host's listeners once, retargeted, as one from a native button does. A
44843
+ * disabled button does nothing, and a pending one refuses the press.
44724
44844
  * - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the button's form changes.
44725
44845
  * - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
44726
44846
  *
@@ -49051,6 +49171,15 @@ export type CustomElements = {
49051
49171
  *
49052
49172
  * Methods that can be called to access component functionality.
49053
49173
  *
49174
+ * - `click() => void`: Presses the button, as `click()` presses a native one: the command is sent,
49175
+ * the form submits or resets, and `helix-press` says `virtual`.
49176
+ *
49177
+ * **Passed to the inner control, because a click on the host reaches nothing
49178
+ * that acts.** The control in the shadow root is what answers a click, so
49179
+ * `click()` from a script, an automation or a test, dispatched on the host,
49180
+ * submitted nothing and sent no `helix-press`. The control's own click reaches
49181
+ * the host's listeners once, retargeted, as one from a native button does. A
49182
+ * disabled button does nothing, and a pending one refuses the press.
49054
49183
  * - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
49055
49184
  * form's `checkValidity()`, as connecting does for the form it starts in.
49056
49185
  * - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
@@ -49783,6 +49912,8 @@ export type CustomElements = {
49783
49912
  * **Every sentence a control raises in the browser's bubble is a property**,
49784
49913
  * so a form in another language speaks it. Unset is the sentence registered
49785
49914
  * for the page's language, then the English.
49915
+ * - `range-order-message`/`rangeOrderMessage`: The message shown when a range ends before it starts. `{start}` is
49916
+ * replaced with the start, written the way the field writes dates.
49786
49917
  * - `range-overflow-message`/`rangeOverflowMessage`: The message shown when a date is after `max`. `{max}` is replaced with
49787
49918
  * `max`, written the way the field writes dates.
49788
49919
  * - `range-underflow-message`/`rangeUnderflowMessage`: The message shown when a date is before `min`. `{min}` is replaced with
@@ -50173,6 +50304,8 @@ export type CustomElements = {
50173
50304
  * it.
50174
50305
  * - `previous-year-label`/`previousYearLabel`: Accessible name for the control that moves back a year, in the months.
50175
50306
  * - `previous-years-label`/`previousYearsLabel`: Accessible name for the control that moves back a page, in the years.
50307
+ * - `range-order-message`/`rangeOrderMessage`: The validation message for a range that ends before it starts. `{start}`
50308
+ * is replaced with the start, written as a date in `locale`.
50176
50309
  * - `range-overflow-message`/`rangeOverflowMessage`: The validation message for a date after `max`. `{max}` is replaced with
50177
50310
  * `max`, written as a date in `locale`.
50178
50311
  * - `range-underflow-message`/`rangeUnderflowMessage`: The validation message for a date before `min`. `{min}` is replaced with
@@ -51574,6 +51707,9 @@ export type CustomElements = {
51574
51707
  *
51575
51708
  * - `focusItem() => void`: Moves focus onto the row itself.
51576
51709
  * - `select() => void`: Fires `helix-select` for this row.
51710
+ * - `click() => void`: Presses the row, as `click()` presses a native button: passed to the
51711
+ * control inside, which is what answers a click, so a script's `click()`
51712
+ * chooses the row, or follows its link, once.
51577
51713
  *
51578
51714
  * ## CSS Custom Properties
51579
51715
  *
@@ -53663,6 +53799,16 @@ export type CustomElements = {
53663
53799
  *
53664
53800
  * Component attributes and properties that can be applied to the element or by using JavaScript.
53665
53801
  *
53802
+ * - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
53803
+ * and the fallback of the `empty` slot.
53804
+ * - `loading`: Whether the readings are still on their way. The chart shows
53805
+ * `loading-text` in place of an empty drawing until it has readings.
53806
+ *
53807
+ * Reflected, so a stylesheet can treat the chart while it waits. A chart
53808
+ * that already has readings keeps drawing them, so a refresh does not
53809
+ * blank it.
53810
+ * - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
53811
+ * there are no readings yet, and the fallback of the `loading` slot.
53666
53812
  * - `for`: The id of the table to read.
53667
53813
  *
53668
53814
  * Names a table in the same tree, so a chart inside another component's
@@ -53689,10 +53835,6 @@ export type CustomElements = {
53689
53835
  * legend hid is not counted.
53690
53836
  * - `busiest-label`/`busiestLabel`: The name the `overview` gives the busiest reading, `{busiestLabel}` in
53691
53837
  * `overview-label`.
53692
- * - `empty-text`/`emptyText`: Shown when the table has no readings in it.
53693
- *
53694
- * Never shown while the table cannot be read at all, which is a server render
53695
- * and the hydrating one after it: see `sourceKnown`.
53696
53838
  * - `gap`: Space between cells, in CSS pixels. It is a number for the same reason
53697
53839
  * `min-cell` is.
53698
53840
  * - `min-cell`/`minCell`: The smallest a cell may get before the strip draws fewer of them, in CSS pixels.
@@ -53723,9 +53865,7 @@ export type CustomElements = {
53723
53865
  * calendar heatmap does: a week is a column, so the strip reads along the
53724
53866
  * line in weeks, from the right on a right-to-left page, and top to bottom in
53725
53867
  * days.
53726
- * - `selected-label`/`selectedLabel`: What the readout adds for a selected cell, under `selection-mode`, after
53727
- * where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
53728
- * nothing.
53868
+ * - `selected-label`/`selectedLabel`: What the readout added for a selected cell, under `selection-mode`.
53729
53869
  * - `selection-label`/`selectionLabel`: What the `selection` part says after the selection changes. `{count}` is
53730
53870
  * how many cells are selected, written in the locale, and a language that
53731
53871
  * needs plural forms writes them: `{count, plural, one {# wybrany} few
@@ -53844,6 +53984,8 @@ export type CustomElements = {
53844
53984
  *
53845
53985
  * - `change`: Fired once a press or a key has changed which cells are selected.
53846
53986
  * - `helix-before-change`: Fired before a press or a key changes which cells are selected, with the `value` it would leave. Cancelable.
53987
+ * - `helix-reading-change`: The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, and the `pointerType` that moved it.
53988
+ * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
53847
53989
  * - `helix-resize`: Fired when the number of cells drawn changes, with the new number.
53848
53990
  *
53849
53991
  * ## Slots
@@ -53853,6 +53995,8 @@ export type CustomElements = {
53853
53995
  * - `end`: Below the strip, at the trailing edge.
53854
53996
  * - `start`: Below the strip, at the leading edge.
53855
53997
  * - `summary`: Below the strip, in the middle.
53998
+ * - `empty`: Content shown under the strip when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
53999
+ * - `loading`: Content shown under the strip while `loading` is set and there are no readings yet. Falls back to `loading-text`.
53856
54000
  *
53857
54001
  * ## Methods
53858
54002
  *
@@ -53944,9 +54088,12 @@ export type CustomElements = {
53944
54088
  * - `tooltip-top`: The bubble while it is above the reading. Set alongside `tooltip`.
53945
54089
  * - `tooltip-value`: A column's value inside the tooltip.
53946
54090
  * - `cell-selected`: A cell that is selected, under `selection-mode`. Set alongside `cell`.
53947
- * - `empty`: Shown when the table has no readings. It stays hidden until the table can be read: on the server and during hydration, there is no document to resolve `for` in.
54091
+ * - `empty`: The words under the strip when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration, there being no document to resolve `for` in.
53948
54092
  * - `end`: The trailing slot's box.
54093
+ * - `loading`: The words under the strip while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
53949
54094
  * - `overview`: The busiest reading and the total of the readings drawn, written as a sentence for screen readers, which describes the strip. Rendered once there are cells. Hide it visually.
54095
+ * - `plot`: The same element as `strip`, under the name every chart gives the drawing that takes focus.
54096
+ * - `row`: A column of cells, which a grid reads as a row, under `selection-mode`. It draws no box.
53950
54097
  * - `selection`: A polite region that says how many cells are selected after a change, rendered from the first change. Hide it visually.
53951
54098
  * - `start`: The leading slot's box.
53952
54099
  * - `summary`: The middle slot's box.
@@ -53958,6 +54105,7 @@ export type CustomElements = {
53958
54105
  *
53959
54106
  * - `active`: While a cell is shown, under the pointer or the keys, with its tooltip open.
53960
54107
  * - `empty`: While the `empty` part stands in place of the cells.
54108
+ * - `loading`: While the `loading` part stands in place of the cells.
53961
54109
  * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
53962
54110
  */
53963
54111
  "helix-heatmap": Partial<
@@ -54197,6 +54345,15 @@ export type CustomElements = {
54197
54345
  *
54198
54346
  * Methods that can be called to access component functionality.
54199
54347
  *
54348
+ * - `click() => void`: Presses the button, as `click()` presses a native one: the command is sent,
54349
+ * the form submits or resets, and `helix-press` says `virtual`.
54350
+ *
54351
+ * **Passed to the inner control, because a click on the host reaches nothing
54352
+ * that acts.** The control in the shadow root is what answers a click, so
54353
+ * `click()` from a script, an automation or a test, dispatched on the host,
54354
+ * submitted nothing and sent no `helix-press`. The control's own click reaches
54355
+ * the host's listeners once, retargeted, as one from a native button does. A
54356
+ * disabled button does nothing, and a pending one refuses the press.
54200
54357
  * - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
54201
54358
  * form's `checkValidity()`, as connecting does for the form it starts in.
54202
54359
  * - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
@@ -56343,7 +56500,8 @@ export type CustomElements = {
56343
56500
  *
56344
56501
  * **The list needs a height to scroll in**: the styled tier's
56345
56502
  * `--listbox-max-block-size`, or a `max-block-size` on `::part(items)` in the
56346
- * headless tier. Import the Option family as well, whose elements are drawn.
56503
+ * headless tier. The options drawn are this tier's Option, which the page
56504
+ * imports, as it imports the options it writes.
56347
56505
  * A server sends the list empty, and the options are drawn once it hydrates. (property only)
56348
56506
  * - `selectedIndex`: Which option is chosen, as an index, or `-1` where none is.
56349
56507
  *
@@ -58054,6 +58212,9 @@ export type CustomElements = {
58054
58212
  * `focus()` above already puts focus on the control inside the row rather than
58055
58213
  * on the row, which is the whole of what moving here means.
58056
58214
  * - `select() => void`: Chooses the row, the same as pressing it.
58215
+ * - `click() => void`: Presses the row, as `click()` presses a native button: passed to the
58216
+ * control inside, which is what answers a click, so a script's `click()`
58217
+ * chooses the row, or follows its link, once.
58057
58218
  *
58058
58219
  * ## CSS Custom Properties
58059
58220
  *
@@ -64931,6 +65092,9 @@ export type CustomElements = {
64931
65092
  * - `focus(options?: FocusOptions) => void`: Puts focus on the control inside the item.
64932
65093
  * - `focusItem() => void`: Moves focus to the action. Part of `NavigableItem`, which the shared
64933
65094
  * keyboard controller uses for the arrow keys.
65095
+ * - `click() => void`: Presses the action, as `click()` presses a native button: passed to the
65096
+ * control inside, which is what answers a click, so a script's `click()`
65097
+ * chooses the action and follows its link, once.
64934
65098
  * - `select() => void`: Chooses the action, the same as pressing it.
64935
65099
  *
64936
65100
  * ## CSS Custom Properties
@@ -67153,6 +67317,9 @@ export type CustomElements = {
67153
67317
  * disabled or a listener cancels the event.
67154
67318
  * - `focus(options?: FocusOptions) => void`: Moves focus to the tab's control, the button or the link inside it, so a
67155
67319
  * script can focus the tab the way it focuses a native one.
67320
+ * - `click() => void`: Presses the tab, as `click()` presses a native button: passed to the
67321
+ * control inside, which is what answers a click, so a script's `click()`
67322
+ * selects the tab, or follows its link, once.
67156
67323
  *
67157
67324
  * ## CSS Custom Properties
67158
67325
  *
@@ -72689,8 +72856,8 @@ export type CustomElementsSolidJs = {
72689
72856
  * The shader stops drawing in these cases:
72690
72857
  * - The element is off screen or in a background tab.
72691
72858
  * - `prefers-reduced-motion` is set. The element shows one still frame.
72692
- * - `paused` is set, from a pause control on your page. The element holds the
72693
- * frame it shows.
72859
+ * - `paused` is set, from a pause control on your page or from the aura's own
72860
+ * under `pause-control`. The element holds the frame it shows.
72694
72861
  * - The browser takes back the drawing context, on a GPU reset or past its
72695
72862
  * limit of about sixteen contexts. The gradient shows until the context
72696
72863
  * returns.
@@ -72714,6 +72881,13 @@ export type CustomElementsSolidJs = {
72714
72881
  * changed while the aura draws, by a class, a style or the color mode,
72715
72882
  * reaches the shader on the next frame.
72716
72883
  *
72884
+ * **`pause-control` draws a control that stops the motion and starts it
72885
+ * again**, in the trailing corner of the field, as WCAG 2.2.2 asks of
72886
+ * anything that moves for more than five seconds. It is a toggle button named
72887
+ * by `pause-label`, which says it is pressed while the field is paused, and a
72888
+ * press sends `change`. A reader who asked for reduced motion sees no motion
72889
+ * and no control.
72890
+ *
72717
72891
  * Where the gradient shows in place of the shader, the aura matches
72718
72892
  * `:state(fallback)` and sends `helix-aura-fallback` with the reason.
72719
72893
  *
@@ -72753,12 +72927,18 @@ export type CustomElementsSolidJs = {
72753
72927
  * hit-testable at rest, or it would swallow clicks meant for what is over it,
72754
72928
  * and an element that is not hit-testable never receives the `pointermove`
72755
72929
  * this listens for. Asking for the pointer is asking for the hit test.
72930
+ * - `pause-control`/`pauseControl`: Whether the aura draws its own control that pauses the field and starts it
72931
+ * again, in its trailing corner. Absent draws none, for a page with a pause
72932
+ * control of its own.
72756
72933
  * - `paused`: Whether the field holds still on the frame it shows.
72757
72934
  *
72758
72935
  * Set it from a pause control on your page, so a reader can stop the motion,
72759
72936
  * as WCAG 2.2.2 asks of anything that moves for more than five seconds. A
72760
72937
  * change to another property still repaints the frame. Clearing it starts
72761
72938
  * the field from where it stopped.
72939
+ * - `pause-label`/`pauseLabel`: The pause control's name, read by screen readers. The control is a toggle
72940
+ * and says it is pressed while the field is paused, so the name stays the
72941
+ * same.
72762
72942
  * - `reach`: How far the pointer reaches into the field, `0` upward.
72763
72943
  *
72764
72944
  * Multiplied into the presence the pointer already fades in and out with, so
@@ -72846,6 +73026,7 @@ export type CustomElementsSolidJs = {
72846
73026
  *
72847
73027
  * Events that will be emitted by the component.
72848
73028
  *
73029
+ * - `change`: Fired when the aura's own pause control pauses the field or starts it again.
72849
73030
  * - `helix-aura-fallback`: Fired each time the aura stops drawing its shader and shows its gradient, with the reason.
72850
73031
  *
72851
73032
  * ## Slots
@@ -72861,6 +73042,7 @@ export type CustomElementsSolidJs = {
72861
73042
  * - `--aura-glow`: The bright stop of the ramp. Defaults to `--helix-color-primary`.
72862
73043
  * - `--aura-ground`: The page the field fades into. Defaults to `--helix-color-background`.
72863
73044
  * - `--aura-haze`: The faint stop between the ground and the glow. Defaults to `--helix-color-primary-subtle`.
73045
+ * - `--aura-pause-background-color`: The pause control's ground. Defaults to `--helix-color-surface-overlay`.
72864
73046
  * - `--aura-peak`: The hottest stop, at the center of a shape. Defaults to `--helix-color-primary-active` on a light page and `--helix-color-foreground` on a dark one.
72865
73047
  *
72866
73048
  * ## CSS Parts
@@ -72869,6 +73051,8 @@ export type CustomElementsSolidJs = {
72869
73051
  *
72870
73052
  * - `canvas`: The surface the shader draws into.
72871
73053
  * - `content`: The box over the field that holds the content. It covers the aura.
73054
+ * - `pause`: The control that pauses the field and starts it again, drawn under `pause-control`.
73055
+ * - `pause-mark`: The glyph on the pause control: pause while the field moves, play while it is paused.
72872
73056
  *
72873
73057
  * ## CSS States
72874
73058
  *
@@ -74362,6 +74546,15 @@ export type CustomElementsSolidJs = {
74362
74546
  *
74363
74547
  * Methods that can be called to access component functionality.
74364
74548
  *
74549
+ * - `click() => void`: Presses the button, as `click()` presses a native one: the command is sent,
74550
+ * the form submits or resets, and `helix-press` says `virtual`.
74551
+ *
74552
+ * **Passed to the inner control, because a click on the host reaches nothing
74553
+ * that acts.** The control in the shadow root is what answers a click, so
74554
+ * `click()` from a script, an automation or a test, dispatched on the host,
74555
+ * submitted nothing and sent no `helix-press`. The control's own click reaches
74556
+ * the host's listeners once, retargeted, as one from a native button does. A
74557
+ * disabled button does nothing, and a pending one refuses the press.
74365
74558
  * - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the button's form changes.
74366
74559
  * - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
74367
74560
  *
@@ -78743,6 +78936,15 @@ export type CustomElementsSolidJs = {
78743
78936
  *
78744
78937
  * Methods that can be called to access component functionality.
78745
78938
  *
78939
+ * - `click() => void`: Presses the button, as `click()` presses a native one: the command is sent,
78940
+ * the form submits or resets, and `helix-press` says `virtual`.
78941
+ *
78942
+ * **Passed to the inner control, because a click on the host reaches nothing
78943
+ * that acts.** The control in the shadow root is what answers a click, so
78944
+ * `click()` from a script, an automation or a test, dispatched on the host,
78945
+ * submitted nothing and sent no `helix-press`. The control's own click reaches
78946
+ * the host's listeners once, retargeted, as one from a native button does. A
78947
+ * disabled button does nothing, and a pending one refuses the press.
78746
78948
  * - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
78747
78949
  * form's `checkValidity()`, as connecting does for the form it starts in.
78748
78950
  * - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
@@ -79481,6 +79683,8 @@ export type CustomElementsSolidJs = {
79481
79683
  * **Every sentence a control raises in the browser's bubble is a property**,
79482
79684
  * so a form in another language speaks it. Unset is the sentence registered
79483
79685
  * for the page's language, then the English.
79686
+ * - `range-order-message`/`rangeOrderMessage`: The message shown when a range ends before it starts. `{start}` is
79687
+ * replaced with the start, written the way the field writes dates.
79484
79688
  * - `range-overflow-message`/`rangeOverflowMessage`: The message shown when a date is after `max`. `{max}` is replaced with
79485
79689
  * `max`, written the way the field writes dates.
79486
79690
  * - `range-underflow-message`/`rangeUnderflowMessage`: The message shown when a date is before `min`. `{min}` is replaced with
@@ -79874,6 +80078,8 @@ export type CustomElementsSolidJs = {
79874
80078
  * it.
79875
80079
  * - `previous-year-label`/`previousYearLabel`: Accessible name for the control that moves back a year, in the months.
79876
80080
  * - `previous-years-label`/`previousYearsLabel`: Accessible name for the control that moves back a page, in the years.
80081
+ * - `range-order-message`/`rangeOrderMessage`: The validation message for a range that ends before it starts. `{start}`
80082
+ * is replaced with the start, written as a date in `locale`.
79877
80083
  * - `range-overflow-message`/`rangeOverflowMessage`: The validation message for a date after `max`. `{max}` is replaced with
79878
80084
  * `max`, written as a date in `locale`.
79879
80085
  * - `range-underflow-message`/`rangeUnderflowMessage`: The validation message for a date before `min`. `{min}` is replaced with
@@ -81294,6 +81500,9 @@ export type CustomElementsSolidJs = {
81294
81500
  *
81295
81501
  * - `focusItem() => void`: Moves focus onto the row itself.
81296
81502
  * - `select() => void`: Fires `helix-select` for this row.
81503
+ * - `click() => void`: Presses the row, as `click()` presses a native button: passed to the
81504
+ * control inside, which is what answers a click, so a script's `click()`
81505
+ * chooses the row, or follows its link, once.
81297
81506
  *
81298
81507
  * ## CSS Custom Properties
81299
81508
  *
@@ -83424,6 +83633,16 @@ export type CustomElementsSolidJs = {
83424
83633
  *
83425
83634
  * Component attributes and properties that can be applied to the element or by using JavaScript.
83426
83635
  *
83636
+ * - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
83637
+ * and the fallback of the `empty` slot.
83638
+ * - `loading`: Whether the readings are still on their way. The chart shows
83639
+ * `loading-text` in place of an empty drawing until it has readings.
83640
+ *
83641
+ * Reflected, so a stylesheet can treat the chart while it waits. A chart
83642
+ * that already has readings keeps drawing them, so a refresh does not
83643
+ * blank it.
83644
+ * - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
83645
+ * there are no readings yet, and the fallback of the `loading` slot.
83427
83646
  * - `for`: The id of the table to read.
83428
83647
  *
83429
83648
  * Names a table in the same tree, so a chart inside another component's
@@ -83450,10 +83669,6 @@ export type CustomElementsSolidJs = {
83450
83669
  * legend hid is not counted.
83451
83670
  * - `busiest-label`/`busiestLabel`: The name the `overview` gives the busiest reading, `{busiestLabel}` in
83452
83671
  * `overview-label`.
83453
- * - `empty-text`/`emptyText`: Shown when the table has no readings in it.
83454
- *
83455
- * Never shown while the table cannot be read at all, which is a server render
83456
- * and the hydrating one after it: see `sourceKnown`.
83457
83672
  * - `gap`: Space between cells, in CSS pixels. It is a number for the same reason
83458
83673
  * `min-cell` is.
83459
83674
  * - `min-cell`/`minCell`: The smallest a cell may get before the strip draws fewer of them, in CSS pixels.
@@ -83484,9 +83699,7 @@ export type CustomElementsSolidJs = {
83484
83699
  * calendar heatmap does: a week is a column, so the strip reads along the
83485
83700
  * line in weeks, from the right on a right-to-left page, and top to bottom in
83486
83701
  * days.
83487
- * - `selected-label`/`selectedLabel`: What the readout adds for a selected cell, under `selection-mode`, after
83488
- * where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
83489
- * nothing.
83702
+ * - `selected-label`/`selectedLabel`: What the readout added for a selected cell, under `selection-mode`.
83490
83703
  * - `selection-label`/`selectionLabel`: What the `selection` part says after the selection changes. `{count}` is
83491
83704
  * how many cells are selected, written in the locale, and a language that
83492
83705
  * needs plural forms writes them: `{count, plural, one {# wybrany} few
@@ -83605,6 +83818,8 @@ export type CustomElementsSolidJs = {
83605
83818
  *
83606
83819
  * - `change`: Fired once a press or a key has changed which cells are selected.
83607
83820
  * - `helix-before-change`: Fired before a press or a key changes which cells are selected, with the `value` it would leave. Cancelable.
83821
+ * - `helix-reading-change`: The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, and the `pointerType` that moved it.
83822
+ * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
83608
83823
  * - `helix-resize`: Fired when the number of cells drawn changes, with the new number.
83609
83824
  *
83610
83825
  * ## Slots
@@ -83614,6 +83829,8 @@ export type CustomElementsSolidJs = {
83614
83829
  * - `end`: Below the strip, at the trailing edge.
83615
83830
  * - `start`: Below the strip, at the leading edge.
83616
83831
  * - `summary`: Below the strip, in the middle.
83832
+ * - `empty`: Content shown under the strip when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
83833
+ * - `loading`: Content shown under the strip while `loading` is set and there are no readings yet. Falls back to `loading-text`.
83617
83834
  *
83618
83835
  * ## Methods
83619
83836
  *
@@ -83705,9 +83922,12 @@ export type CustomElementsSolidJs = {
83705
83922
  * - `tooltip-top`: The bubble while it is above the reading. Set alongside `tooltip`.
83706
83923
  * - `tooltip-value`: A column's value inside the tooltip.
83707
83924
  * - `cell-selected`: A cell that is selected, under `selection-mode`. Set alongside `cell`.
83708
- * - `empty`: Shown when the table has no readings. It stays hidden until the table can be read: on the server and during hydration, there is no document to resolve `for` in.
83925
+ * - `empty`: The words under the strip when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration, there being no document to resolve `for` in.
83709
83926
  * - `end`: The trailing slot's box.
83927
+ * - `loading`: The words under the strip while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
83710
83928
  * - `overview`: The busiest reading and the total of the readings drawn, written as a sentence for screen readers, which describes the strip. Rendered once there are cells. Hide it visually.
83929
+ * - `plot`: The same element as `strip`, under the name every chart gives the drawing that takes focus.
83930
+ * - `row`: A column of cells, which a grid reads as a row, under `selection-mode`. It draws no box.
83711
83931
  * - `selection`: A polite region that says how many cells are selected after a change, rendered from the first change. Hide it visually.
83712
83932
  * - `start`: The leading slot's box.
83713
83933
  * - `summary`: The middle slot's box.
@@ -83719,6 +83939,7 @@ export type CustomElementsSolidJs = {
83719
83939
  *
83720
83940
  * - `active`: While a cell is shown, under the pointer or the keys, with its tooltip open.
83721
83941
  * - `empty`: While the `empty` part stands in place of the cells.
83942
+ * - `loading`: While the `loading` part stands in place of the cells.
83722
83943
  * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
83723
83944
  */
83724
83945
  "helix-heatmap": Partial<
@@ -83961,6 +84182,15 @@ export type CustomElementsSolidJs = {
83961
84182
  *
83962
84183
  * Methods that can be called to access component functionality.
83963
84184
  *
84185
+ * - `click() => void`: Presses the button, as `click()` presses a native one: the command is sent,
84186
+ * the form submits or resets, and `helix-press` says `virtual`.
84187
+ *
84188
+ * **Passed to the inner control, because a click on the host reaches nothing
84189
+ * that acts.** The control in the shadow root is what answers a click, so
84190
+ * `click()` from a script, an automation or a test, dispatched on the host,
84191
+ * submitted nothing and sent no `helix-press`. The control's own click reaches
84192
+ * the host's listeners once, retargeted, as one from a native button does. A
84193
+ * disabled button does nothing, and a pending one refuses the press.
83964
84194
  * - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
83965
84195
  * form's `checkValidity()`, as connecting does for the form it starts in.
83966
84196
  * - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
@@ -86141,7 +86371,8 @@ export type CustomElementsSolidJs = {
86141
86371
  *
86142
86372
  * **The list needs a height to scroll in**: the styled tier's
86143
86373
  * `--listbox-max-block-size`, or a `max-block-size` on `::part(items)` in the
86144
- * headless tier. Import the Option family as well, whose elements are drawn.
86374
+ * headless tier. The options drawn are this tier's Option, which the page
86375
+ * imports, as it imports the options it writes.
86145
86376
  * A server sends the list empty, and the options are drawn once it hydrates. (property only)
86146
86377
  * - `selectedIndex`: Which option is chosen, as an index, or `-1` where none is.
86147
86378
  *
@@ -87893,6 +88124,9 @@ export type CustomElementsSolidJs = {
87893
88124
  * `focus()` above already puts focus on the control inside the row rather than
87894
88125
  * on the row, which is the whole of what moving here means.
87895
88126
  * - `select() => void`: Chooses the row, the same as pressing it.
88127
+ * - `click() => void`: Presses the row, as `click()` presses a native button: passed to the
88128
+ * control inside, which is what answers a click, so a script's `click()`
88129
+ * chooses the row, or follows its link, once.
87896
88130
  *
87897
88131
  * ## CSS Custom Properties
87898
88132
  *
@@ -94894,6 +95128,9 @@ export type CustomElementsSolidJs = {
94894
95128
  * - `focus(options?: FocusOptions) => void`: Puts focus on the control inside the item.
94895
95129
  * - `focusItem() => void`: Moves focus to the action. Part of `NavigableItem`, which the shared
94896
95130
  * keyboard controller uses for the arrow keys.
95131
+ * - `click() => void`: Presses the action, as `click()` presses a native button: passed to the
95132
+ * control inside, which is what answers a click, so a script's `click()`
95133
+ * chooses the action and follows its link, once.
94897
95134
  * - `select() => void`: Chooses the action, the same as pressing it.
94898
95135
  *
94899
95136
  * ## CSS Custom Properties
@@ -97165,6 +97402,9 @@ export type CustomElementsSolidJs = {
97165
97402
  * disabled or a listener cancels the event.
97166
97403
  * - `focus(options?: FocusOptions) => void`: Moves focus to the tab's control, the button or the link inside it, so a
97167
97404
  * script can focus the tab the way it focuses a native one.
97405
+ * - `click() => void`: Presses the tab, as `click()` presses a native button: passed to the
97406
+ * control inside, which is what answers a click, so a script's `click()`
97407
+ * selects the tab, or follows its link, once.
97168
97408
  *
97169
97409
  * ## CSS Custom Properties
97170
97410
  *
@@ -101948,6 +102188,8 @@ export type CustomCssProperties = {
101948
102188
  "--aura-ground"?: (string) | undefined;
101949
102189
  /** The faint stop between the ground and the glow. Defaults to `--helix-color-primary-subtle`. */
101950
102190
  "--aura-haze"?: (string) | undefined;
102191
+ /** The pause control's ground. Defaults to `--helix-color-surface-overlay`. */
102192
+ "--aura-pause-background-color"?: (string) | undefined;
101951
102193
  /** The hottest stop, at the center of a shape. Defaults to `--helix-color-primary-active` on a light page and `--helix-color-foreground` on a dark one. */
101952
102194
  "--aura-peak"?: (string) | undefined;
101953
102195
  /** The fill of the count of avatars past `max`. */