@fusion.dev/helix 0.150.0 → 0.152.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
@@ -172,6 +172,8 @@ import type {
172
172
  HelixRangeChangeEvent,
173
173
  HelixRating,
174
174
  HelixReadEvent,
175
+ HelixReadingChangeEvent,
176
+ HelixReadingPressEvent,
175
177
  HelixReconnectEvent,
176
178
  HelixRejectEvent,
177
179
  HelixRelabelEvent,
@@ -1107,6 +1109,22 @@ the wordmark and the actions happen to measure.
1107
1109
  takes a search field or a breadcrumb trail as readily as a `Navigation`, so
1108
1110
  the property carries the part's name, `content`. */
1109
1111
  contentAlign?: (HelixAppHeader["contentAlign"]) | undefined;
1112
+ /** The width of the bar, in pixels, below which the middle region folds behind
1113
+ a toggle. Unset, it never folds. */
1114
+ "fold-below"?: (HelixAppHeader["foldBelow"] | `${number}`) | undefined;
1115
+ /** The width of the bar, in pixels, below which the middle region folds behind
1116
+ a toggle. Unset, it never folds. */
1117
+ foldBelow?: (HelixAppHeader["foldBelow"]) | undefined;
1118
+ /** Hides the bar as the page scrolls down past it, and shows it again as the
1119
+ page scrolls up. */
1120
+ "hide-on-scroll"?: (HelixAppHeader["hideOnScroll"]) | undefined;
1121
+ /** Hides the bar as the page scrolls down past it, and shows it again as the
1122
+ page scrolls up. */
1123
+ hideOnScroll?: (HelixAppHeader["hideOnScroll"]) | undefined;
1124
+ /** The name of the toggle that opens a folded middle region. */
1125
+ "menu-label"?: (HelixAppHeader["menuLabel"]) | undefined;
1126
+ /** The name of the toggle that opens a folded middle region. */
1127
+ menuLabel?: (HelixAppHeader["menuLabel"]) | undefined;
1110
1128
  /** The id of the element whose scrolling lifts the bar, for an app shell that
1111
1129
  scrolls a container instead of the window. Unset is the window. */
1112
1130
  scroller?: (HelixAppHeader["scroller"]) | undefined;
@@ -1196,6 +1214,22 @@ the wordmark and the actions happen to measure.
1196
1214
  takes a search field or a breadcrumb trail as readily as a `Navigation`, so
1197
1215
  the property carries the part's name, `content`. */
1198
1216
  "prop:contentAlign"?: (HelixAppHeader["contentAlign"]) | undefined;
1217
+ /** The width of the bar, in pixels, below which the middle region folds behind
1218
+ a toggle. Unset, it never folds. */
1219
+ "attr:fold-below"?: (HelixAppHeader["foldBelow"] | `${number}`) | undefined;
1220
+ /** The width of the bar, in pixels, below which the middle region folds behind
1221
+ a toggle. Unset, it never folds. */
1222
+ "prop:foldBelow"?: (HelixAppHeader["foldBelow"]) | undefined;
1223
+ /** Hides the bar as the page scrolls down past it, and shows it again as the
1224
+ page scrolls up. */
1225
+ "bool:hide-on-scroll"?: (HelixAppHeader["hideOnScroll"]) | undefined;
1226
+ /** Hides the bar as the page scrolls down past it, and shows it again as the
1227
+ page scrolls up. */
1228
+ "prop:hideOnScroll"?: (HelixAppHeader["hideOnScroll"]) | undefined;
1229
+ /** The name of the toggle that opens a folded middle region. */
1230
+ "attr:menu-label"?: (HelixAppHeader["menuLabel"]) | undefined;
1231
+ /** The name of the toggle that opens a folded middle region. */
1232
+ "prop:menuLabel"?: (HelixAppHeader["menuLabel"]) | undefined;
1199
1233
  /** The id of the element whose scrolling lifts the bar, for an app shell that
1200
1234
  scrolls a container instead of the window. Unset is the window. */
1201
1235
  "prop:scroller"?: (HelixAppHeader["scroller"]) | undefined;
@@ -1208,6 +1242,18 @@ scrolls a container instead of the window. Unset is the window. */
1208
1242
  textContent?: (string | number) | undefined;
1209
1243
  };
1210
1244
 
1245
+ /** `HelixAreaChart` component event */
1246
+ export type HelixAreaChartElementEvent<E = Event> = TypedEvent<
1247
+ HelixAreaChart,
1248
+ E
1249
+ >;
1250
+ /** `helix-reading-change` event type */
1251
+ export type HelixAreaChartHelixReadingChangeElementEvent =
1252
+ HelixAreaChartElementEvent<HelixReadingChangeEvent>;
1253
+ /** `helix-reading-press` event type */
1254
+ export type HelixAreaChartHelixReadingPressElementEvent =
1255
+ HelixAreaChartElementEvent<HelixReadingPressEvent>;
1256
+
1211
1257
  export type HelixAreaChartProps = {
1212
1258
  /** The id of the table to read.
1213
1259
 
@@ -1294,6 +1340,27 @@ locale, and `{shares}` each part's share, listed as the locale lists. */
1294
1340
  "total-label"?: (HelixAreaChart["totalLabel"]) | undefined;
1295
1341
  /** The name for the sum of the parts, shown in the tooltip and the summary. */
1296
1342
  totalLabel?: (HelixAreaChart["totalLabel"]) | undefined;
1343
+ /** Draws the scale's numbers beside the plot, the `axis` part, at the levels
1344
+ `gridlines` rules: amounts, or percentages under `share`.
1345
+
1346
+ Absent draws none: bands read as a composition need no numbers beside
1347
+ them, and the tooltip and the table hold every reading. */
1348
+ "value-axis"?: (HelixAreaChart["valueAxis"]) | undefined;
1349
+ /** Draws the scale's numbers beside the plot, the `axis` part, at the levels
1350
+ `gridlines` rules: amounts, or percentages under `share`.
1351
+
1352
+ Absent draws none: bands read as a composition need no numbers beside
1353
+ them, and the tooltip and the table hold every reading. */
1354
+ valueAxis?: (HelixAreaChart["valueAxis"]) | undefined;
1355
+
1356
+ /** 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. */
1357
+ "onhelix-reading-change"?: ((
1358
+ e: HelixAreaChartHelixReadingChangeElementEvent,
1359
+ ) => void) | undefined;
1360
+ /** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
1361
+ "onhelix-reading-press"?: ((
1362
+ e: HelixAreaChartHelixReadingPressElementEvent,
1363
+ ) => void) | undefined;
1297
1364
  };
1298
1365
 
1299
1366
  export type HelixAreaChartSolidJsProps = {
@@ -1382,6 +1449,26 @@ locale, and `{shares}` each part's share, listed as the locale lists. */
1382
1449
  "attr:total-label"?: (HelixAreaChart["totalLabel"]) | undefined;
1383
1450
  /** The name for the sum of the parts, shown in the tooltip and the summary. */
1384
1451
  "prop:totalLabel"?: (HelixAreaChart["totalLabel"]) | undefined;
1452
+ /** Draws the scale's numbers beside the plot, the `axis` part, at the levels
1453
+ `gridlines` rules: amounts, or percentages under `share`.
1454
+
1455
+ Absent draws none: bands read as a composition need no numbers beside
1456
+ them, and the tooltip and the table hold every reading. */
1457
+ "bool:value-axis"?: (HelixAreaChart["valueAxis"]) | undefined;
1458
+ /** Draws the scale's numbers beside the plot, the `axis` part, at the levels
1459
+ `gridlines` rules: amounts, or percentages under `share`.
1460
+
1461
+ Absent draws none: bands read as a composition need no numbers beside
1462
+ them, and the tooltip and the table hold every reading. */
1463
+ "prop:valueAxis"?: (HelixAreaChart["valueAxis"]) | undefined;
1464
+ /** 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. */
1465
+ "on:helix-reading-change"?: ((
1466
+ e: HelixAreaChartHelixReadingChangeElementEvent,
1467
+ ) => void) | undefined;
1468
+ /** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
1469
+ "on:helix-reading-press"?: ((
1470
+ e: HelixAreaChartHelixReadingPressElementEvent,
1471
+ ) => void) | undefined;
1385
1472
 
1386
1473
  /** Set the innerHTML of the element */
1387
1474
  innerHTML?: (string) | undefined;
@@ -2016,6 +2103,15 @@ is showing a count must not lose the count for being handed one. */
2016
2103
  textContent?: (string | number) | undefined;
2017
2104
  };
2018
2105
 
2106
+ /** `HelixBarChart` component event */
2107
+ export type HelixBarChartElementEvent<E = Event> = TypedEvent<HelixBarChart, E>;
2108
+ /** `helix-reading-change` event type */
2109
+ export type HelixBarChartHelixReadingChangeElementEvent =
2110
+ HelixBarChartElementEvent<HelixReadingChangeEvent>;
2111
+ /** `helix-reading-press` event type */
2112
+ export type HelixBarChartHelixReadingPressElementEvent =
2113
+ HelixBarChartElementEvent<HelixReadingPressEvent>;
2114
+
2019
2115
  export type HelixBarChartProps = {
2020
2116
  /** How strongly the columns are drawn.
2021
2117
 
@@ -2267,6 +2363,29 @@ the reading as the table writes it. */
2267
2363
  `{readings}` each series' highest reading: the series, the category and
2268
2364
  the reading as the table writes it. */
2269
2365
  summaryLabel?: (HelixBarChart["summaryLabel"]) | undefined;
2366
+ /** Draws the numbers of the scale the bars are measured on, the `axis` part,
2367
+ at the levels `gridlines` rules: down the side of columns, and along the
2368
+ bottom of bars under `orientation="horizontal"`.
2369
+
2370
+ Absent draws none with one scale, since bars compared with each other need
2371
+ no numbers. With `secondary` both scales are drawn whatever this says. */
2372
+ "value-axis"?: (HelixBarChart["valueAxis"]) | undefined;
2373
+ /** Draws the numbers of the scale the bars are measured on, the `axis` part,
2374
+ at the levels `gridlines` rules: down the side of columns, and along the
2375
+ bottom of bars under `orientation="horizontal"`.
2376
+
2377
+ Absent draws none with one scale, since bars compared with each other need
2378
+ no numbers. With `secondary` both scales are drawn whatever this says. */
2379
+ valueAxis?: (HelixBarChart["valueAxis"]) | undefined;
2380
+
2381
+ /** 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. */
2382
+ "onhelix-reading-change"?: ((
2383
+ e: HelixBarChartHelixReadingChangeElementEvent,
2384
+ ) => void) | undefined;
2385
+ /** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
2386
+ "onhelix-reading-press"?: ((
2387
+ e: HelixBarChartHelixReadingPressElementEvent,
2388
+ ) => void) | undefined;
2270
2389
  };
2271
2390
 
2272
2391
  export type HelixBarChartSolidJsProps = {
@@ -2520,6 +2639,28 @@ the reading as the table writes it. */
2520
2639
  `{readings}` each series' highest reading: the series, the category and
2521
2640
  the reading as the table writes it. */
2522
2641
  "prop:summaryLabel"?: (HelixBarChart["summaryLabel"]) | undefined;
2642
+ /** Draws the numbers of the scale the bars are measured on, the `axis` part,
2643
+ at the levels `gridlines` rules: down the side of columns, and along the
2644
+ bottom of bars under `orientation="horizontal"`.
2645
+
2646
+ Absent draws none with one scale, since bars compared with each other need
2647
+ no numbers. With `secondary` both scales are drawn whatever this says. */
2648
+ "bool:value-axis"?: (HelixBarChart["valueAxis"]) | undefined;
2649
+ /** Draws the numbers of the scale the bars are measured on, the `axis` part,
2650
+ at the levels `gridlines` rules: down the side of columns, and along the
2651
+ bottom of bars under `orientation="horizontal"`.
2652
+
2653
+ Absent draws none with one scale, since bars compared with each other need
2654
+ no numbers. With `secondary` both scales are drawn whatever this says. */
2655
+ "prop:valueAxis"?: (HelixBarChart["valueAxis"]) | undefined;
2656
+ /** 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. */
2657
+ "on:helix-reading-change"?: ((
2658
+ e: HelixBarChartHelixReadingChangeElementEvent,
2659
+ ) => void) | undefined;
2660
+ /** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
2661
+ "on:helix-reading-press"?: ((
2662
+ e: HelixBarChartHelixReadingPressElementEvent,
2663
+ ) => void) | undefined;
2523
2664
 
2524
2665
  /** Set the innerHTML of the element */
2525
2666
  innerHTML?: (string) | undefined;
@@ -5822,8 +5963,21 @@ export type HelixChatComposerHelixTypingElementEvent =
5822
5963
  export type HelixChatComposerProps = {
5823
5964
  /** The field's name, read by screen readers. */
5824
5965
  label?: (HelixChatComposer["label"]) | undefined;
5966
+ /** The most characters a draft can have. The field stops taking more. */
5967
+ maxlength?: (HelixChatComposer["maxLength"] | `${number}`) | undefined;
5968
+ /** The most characters a draft can have. The field stops taking more. */
5969
+ maxLength?: (HelixChatComposer["maxLength"]) | undefined;
5970
+ /** The fewest characters a draft can have, once the reader has written in
5971
+ the field, as on a `<textarea>`. */
5972
+ minlength?: (HelixChatComposer["minLength"] | `${number}`) | undefined;
5973
+ /** The fewest characters a draft can have, once the reader has written in
5974
+ the field, as on a `<textarea>`. */
5975
+ minLength?: (HelixChatComposer["minLength"]) | undefined;
5825
5976
  /** Placeholder text shown in an empty field. */
5826
5977
  placeholder?: (HelixChatComposer["placeholder"]) | undefined;
5978
+ /** Whether the form needs a draft to submit. An empty draft never sends,
5979
+ required or not. */
5980
+ required?: (HelixChatComposer["required"]) | undefined;
5827
5981
  /** How many rows the field opens at.
5828
5982
 
5829
5983
  It grows from there. */
@@ -5895,8 +6049,21 @@ Here rather than on each control. */
5895
6049
  export type HelixChatComposerSolidJsProps = {
5896
6050
  /** The field's name, read by screen readers. */
5897
6051
  "prop:label"?: (HelixChatComposer["label"]) | undefined;
6052
+ /** The most characters a draft can have. The field stops taking more. */
6053
+ "attr:maxlength"?: (HelixChatComposer["maxLength"] | `${number}`) | undefined;
6054
+ /** The most characters a draft can have. The field stops taking more. */
6055
+ "prop:maxLength"?: (HelixChatComposer["maxLength"]) | undefined;
6056
+ /** The fewest characters a draft can have, once the reader has written in
6057
+ the field, as on a `<textarea>`. */
6058
+ "attr:minlength"?: (HelixChatComposer["minLength"] | `${number}`) | undefined;
6059
+ /** The fewest characters a draft can have, once the reader has written in
6060
+ the field, as on a `<textarea>`. */
6061
+ "prop:minLength"?: (HelixChatComposer["minLength"]) | undefined;
5898
6062
  /** Placeholder text shown in an empty field. */
5899
6063
  "prop:placeholder"?: (HelixChatComposer["placeholder"]) | undefined;
6064
+ /** Whether the form needs a draft to submit. An empty draft never sends,
6065
+ required or not. */
6066
+ "prop:required"?: (HelixChatComposer["required"]) | undefined;
5900
6067
  /** How many rows the field opens at.
5901
6068
 
5902
6069
  It grows from there. */
@@ -10024,6 +10191,20 @@ rows are chosen, written in the locale, and a language that needs plural
10024
10191
  forms writes them: `{count, plural, one {# wybrany} few {# wybrane} many
10025
10192
  {# wybranych} other {# wybranego}}`. */
10026
10193
  selectedLabel?: (HelixDataTable["selectedLabel"]) | undefined;
10194
+ /** What a key or a press on a row does to the rows already selected, in a
10195
+ `selectable` table. `toggle`, the default, keeps them: Space adds or takes
10196
+ out the row. `replace` selects the row alone, as a file list does: Down and
10197
+ Up carry the selection with them, and a press on a row selects it. Control
10198
+ or Command with a press or Space adds or takes out one row, and with a move
10199
+ goes without selecting. The checkboxes add or take out one row either way. */
10200
+ "selection-behavior"?: (HelixDataTable["selectionBehavior"]) | undefined;
10201
+ /** What a key or a press on a row does to the rows already selected, in a
10202
+ `selectable` table. `toggle`, the default, keeps them: Space adds or takes
10203
+ out the row. `replace` selects the row alone, as a file list does: Down and
10204
+ Up carry the selection with them, and a press on a row selects it. Control
10205
+ or Command with a press or Space adds or takes out one row, and with a move
10206
+ goes without selecting. The checkboxes add or take out one row either way. */
10207
+ selectionBehavior?: (HelixDataTable["selectionBehavior"]) | undefined;
10027
10208
  /** The name of a row's checkbox. `{row}` is replaced with the row's value in
10028
10209
  the first column that has a field, or with its key. */
10029
10210
  "select-row-label"?: (HelixDataTable["selectRowLabel"]) | undefined;
@@ -10409,6 +10590,20 @@ rows are chosen, written in the locale, and a language that needs plural
10409
10590
  forms writes them: `{count, plural, one {# wybrany} few {# wybrane} many
10410
10591
  {# wybranych} other {# wybranego}}`. */
10411
10592
  "prop:selectedLabel"?: (HelixDataTable["selectedLabel"]) | undefined;
10593
+ /** What a key or a press on a row does to the rows already selected, in a
10594
+ `selectable` table. `toggle`, the default, keeps them: Space adds or takes
10595
+ out the row. `replace` selects the row alone, as a file list does: Down and
10596
+ Up carry the selection with them, and a press on a row selects it. Control
10597
+ or Command with a press or Space adds or takes out one row, and with a move
10598
+ goes without selecting. The checkboxes add or take out one row either way. */
10599
+ "attr:selection-behavior"?: (HelixDataTable["selectionBehavior"]) | undefined;
10600
+ /** What a key or a press on a row does to the rows already selected, in a
10601
+ `selectable` table. `toggle`, the default, keeps them: Space adds or takes
10602
+ out the row. `replace` selects the row alone, as a file list does: Down and
10603
+ Up carry the selection with them, and a press on a row selects it. Control
10604
+ or Command with a press or Space adds or takes out one row, and with a move
10605
+ goes without selecting. The checkboxes add or take out one row either way. */
10606
+ "prop:selectionBehavior"?: (HelixDataTable["selectionBehavior"]) | undefined;
10412
10607
  /** The name of a row's checkbox. `{row}` is replaced with the row's value in
10413
10608
  the first column that has a field, or with its key. */
10414
10609
  "attr:select-row-label"?: (HelixDataTable["selectRowLabel"]) | undefined;
@@ -12279,8 +12474,14 @@ first, `handleCancel` prevents it, and `requestOpen` decides. So
12279
12474
  `closedby="any"` gains light dismiss without giving up the refusal, which is
12280
12475
  the property this component exists to keep.
12281
12476
 
12477
+ The press on the backdrop that this element handles itself follows it too:
12478
+ `closerequest` and `none` leave the dialog open on that press, as the
12479
+ platform does, and `none` also keeps it open on Escape in a browser without
12480
+ `closedby`.
12481
+
12282
12482
  Absent by default, which is the platform's `auto` and this library's rule
12283
- that a resting value is an attribute's absence. */
12483
+ that a resting value is an attribute's absence. Absent, a press on the
12484
+ backdrop closes the dialog. */
12284
12485
  closedby?: (HelixDialog["closedBy"]) | undefined;
12285
12486
  /** Which close requests the browser handles on its own.
12286
12487
 
@@ -12290,8 +12491,14 @@ first, `handleCancel` prevents it, and `requestOpen` decides. So
12290
12491
  `closedby="any"` gains light dismiss without giving up the refusal, which is
12291
12492
  the property this component exists to keep.
12292
12493
 
12494
+ The press on the backdrop that this element handles itself follows it too:
12495
+ `closerequest` and `none` leave the dialog open on that press, as the
12496
+ platform does, and `none` also keeps it open on Escape in a browser without
12497
+ `closedby`.
12498
+
12293
12499
  Absent by default, which is the platform's `auto` and this library's rule
12294
- that a resting value is an attribute's absence. */
12500
+ that a resting value is an attribute's absence. Absent, a press on the
12501
+ backdrop closes the dialog. */
12295
12502
  closedBy?: (HelixDialog["closedBy"]) | undefined;
12296
12503
  /** Draws a control that closes the dialog, in the corner where the title is.
12297
12504
 
@@ -12439,8 +12646,14 @@ first, `handleCancel` prevents it, and `requestOpen` decides. So
12439
12646
  `closedby="any"` gains light dismiss without giving up the refusal, which is
12440
12647
  the property this component exists to keep.
12441
12648
 
12649
+ The press on the backdrop that this element handles itself follows it too:
12650
+ `closerequest` and `none` leave the dialog open on that press, as the
12651
+ platform does, and `none` also keeps it open on Escape in a browser without
12652
+ `closedby`.
12653
+
12442
12654
  Absent by default, which is the platform's `auto` and this library's rule
12443
- that a resting value is an attribute's absence. */
12655
+ that a resting value is an attribute's absence. Absent, a press on the
12656
+ backdrop closes the dialog. */
12444
12657
  "attr:closedby"?: (HelixDialog["closedBy"]) | undefined;
12445
12658
  /** Which close requests the browser handles on its own.
12446
12659
 
@@ -12450,8 +12663,14 @@ first, `handleCancel` prevents it, and `requestOpen` decides. So
12450
12663
  `closedby="any"` gains light dismiss without giving up the refusal, which is
12451
12664
  the property this component exists to keep.
12452
12665
 
12666
+ The press on the backdrop that this element handles itself follows it too:
12667
+ `closerequest` and `none` leave the dialog open on that press, as the
12668
+ platform does, and `none` also keeps it open on Escape in a browser without
12669
+ `closedby`.
12670
+
12453
12671
  Absent by default, which is the platform's `auto` and this library's rule
12454
- that a resting value is an attribute's absence. */
12672
+ that a resting value is an attribute's absence. Absent, a press on the
12673
+ backdrop closes the dialog. */
12455
12674
  "prop:closedBy"?: (HelixDialog["closedBy"]) | undefined;
12456
12675
  /** Draws a control that closes the dialog, in the corner where the title is.
12457
12676
 
@@ -12525,11 +12744,7 @@ short length of line, `--divider-content-offset`, kept before or after it.
12525
12744
  A divider with nothing set into it is one line whatever this says. */
12526
12745
  contentPlacement?: (HelixDivider["contentPlacement"]) | undefined;
12527
12746
  /** Whether screen readers announce the line as a separator, which they now do
12528
- by default.
12529
-
12530
- It dates from when the line was decorative by default. It is still read,
12531
- and it wins over `decorative`, so a divider written with it stays a
12532
- separator. */
12747
+ by default. */
12533
12748
  announced?: (HelixDivider["announced"]) | undefined;
12534
12749
  /** Takes the line out of the accessibility tree, for a rule that separates
12535
12750
  nothing: one under a heading, or between the facts of a byline.
@@ -12558,11 +12773,7 @@ short length of line, `--divider-content-offset`, kept before or after it.
12558
12773
  A divider with nothing set into it is one line whatever this says. */
12559
12774
  "prop:contentPlacement"?: (HelixDivider["contentPlacement"]) | undefined;
12560
12775
  /** Whether screen readers announce the line as a separator, which they now do
12561
- by default.
12562
-
12563
- It dates from when the line was decorative by default. It is still read,
12564
- and it wins over `decorative`, so a divider written with it stays a
12565
- separator. */
12776
+ by default. */
12566
12777
  "prop:announced"?: (HelixDivider["announced"]) | undefined;
12567
12778
  /** Takes the line out of the accessibility tree, for a rule that separates
12568
12779
  nothing: one under a heading, or between the facts of a byline.
@@ -12975,6 +13186,12 @@ lost its focus trap because a consumer forgot a word would be worse than an
12975
13186
  attribute on the host, and nothing selects on it: the scrim is rendered or
12976
13187
  not, rather than shown or hidden by CSS. */
12977
13188
  modal?: (HelixDrawer["modal"]) | undefined;
13189
+ /** Stops Escape, a press outside, and a swipe from closing the drawer, for a
13190
+ drawer that has to be answered.
13191
+
13192
+ The close control and `close()` still close it, as on `Dialog`: a panel
13193
+ with no way out at all is a trap. */
13194
+ persistent?: (HelixDrawer["persistent"]) | undefined;
12978
13195
  /** Which edge the drawer comes from.
12979
13196
 
12980
13197
  Unset is `end`, and it stays unset rather than being written down: a
@@ -13114,6 +13331,12 @@ lost its focus trap because a consumer forgot a word would be worse than an
13114
13331
  attribute on the host, and nothing selects on it: the scrim is rendered or
13115
13332
  not, rather than shown or hidden by CSS. */
13116
13333
  "prop:modal"?: (HelixDrawer["modal"]) | undefined;
13334
+ /** Stops Escape, a press outside, and a swipe from closing the drawer, for a
13335
+ drawer that has to be answered.
13336
+
13337
+ The close control and `close()` still close it, as on `Dialog`: a panel
13338
+ with no way out at all is a trap. */
13339
+ "prop:persistent"?: (HelixDrawer["persistent"]) | undefined;
13117
13340
  /** Which edge the drawer comes from.
13118
13341
 
13119
13342
  Unset is `end`, and it stays unset rather than being written down: a
@@ -18076,6 +18299,18 @@ it to say nothing. */
18076
18299
  textContent?: (string | number) | undefined;
18077
18300
  };
18078
18301
 
18302
+ /** `HelixLineChart` component event */
18303
+ export type HelixLineChartElementEvent<E = Event> = TypedEvent<
18304
+ HelixLineChart,
18305
+ E
18306
+ >;
18307
+ /** `helix-reading-change` event type */
18308
+ export type HelixLineChartHelixReadingChangeElementEvent =
18309
+ HelixLineChartElementEvent<HelixReadingChangeEvent>;
18310
+ /** `helix-reading-press` event type */
18311
+ export type HelixLineChartHelixReadingPressElementEvent =
18312
+ HelixLineChartElementEvent<HelixReadingPressEvent>;
18313
+
18079
18314
  export type HelixLineChartProps = {
18080
18315
  /** How strongly the lines and their washes are drawn.
18081
18316
 
@@ -18253,6 +18488,20 @@ masked with one disc per series and every stroke stops at its own ring's
18253
18488
  inner edge. `mask-composite: intersect` is what makes N holes out of N
18254
18489
  layers; a single `mask-image` would only ever cut the last one. */
18255
18490
  terminus?: (HelixLineChart["terminus"]) | undefined;
18491
+ /** Draws the scale's numbers beside the plot, the `axis` part, at the levels
18492
+ `gridlines` rules, so a reading can be measured off the drawing as well
18493
+ as read from the tooltip.
18494
+
18495
+ Absent draws none: a line read for its shape needs no numbers beside it,
18496
+ and the tooltip and the table hold every reading. */
18497
+ "value-axis"?: (HelixLineChart["valueAxis"]) | undefined;
18498
+ /** Draws the scale's numbers beside the plot, the `axis` part, at the levels
18499
+ `gridlines` rules, so a reading can be measured off the drawing as well
18500
+ as read from the tooltip.
18501
+
18502
+ Absent draws none: a line read for its shape needs no numbers beside it,
18503
+ and the tooltip and the table hold every reading. */
18504
+ valueAxis?: (HelixLineChart["valueAxis"]) | undefined;
18256
18505
  /** Whether the range always includes zero.
18257
18506
 
18258
18507
  Absent measures from the data's own extent, which is what a line is for.
@@ -18260,6 +18509,15 @@ Set it where the distance from nothing is the point rather than the shape,
18260
18509
  and accept that a series which never approaches zero becomes a flat rule
18261
18510
  near the top of the box. */
18262
18511
  zero?: (HelixLineChart["zero"]) | undefined;
18512
+
18513
+ /** 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. */
18514
+ "onhelix-reading-change"?: ((
18515
+ e: HelixLineChartHelixReadingChangeElementEvent,
18516
+ ) => void) | undefined;
18517
+ /** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
18518
+ "onhelix-reading-press"?: ((
18519
+ e: HelixLineChartHelixReadingPressElementEvent,
18520
+ ) => void) | undefined;
18263
18521
  };
18264
18522
 
18265
18523
  export type HelixLineChartSolidJsProps = {
@@ -18439,6 +18697,20 @@ masked with one disc per series and every stroke stops at its own ring's
18439
18697
  inner edge. `mask-composite: intersect` is what makes N holes out of N
18440
18698
  layers; a single `mask-image` would only ever cut the last one. */
18441
18699
  "prop:terminus"?: (HelixLineChart["terminus"]) | undefined;
18700
+ /** Draws the scale's numbers beside the plot, the `axis` part, at the levels
18701
+ `gridlines` rules, so a reading can be measured off the drawing as well
18702
+ as read from the tooltip.
18703
+
18704
+ Absent draws none: a line read for its shape needs no numbers beside it,
18705
+ and the tooltip and the table hold every reading. */
18706
+ "bool:value-axis"?: (HelixLineChart["valueAxis"]) | undefined;
18707
+ /** Draws the scale's numbers beside the plot, the `axis` part, at the levels
18708
+ `gridlines` rules, so a reading can be measured off the drawing as well
18709
+ as read from the tooltip.
18710
+
18711
+ Absent draws none: a line read for its shape needs no numbers beside it,
18712
+ and the tooltip and the table hold every reading. */
18713
+ "prop:valueAxis"?: (HelixLineChart["valueAxis"]) | undefined;
18442
18714
  /** Whether the range always includes zero.
18443
18715
 
18444
18716
  Absent measures from the data's own extent, which is what a line is for.
@@ -18446,6 +18718,14 @@ Set it where the distance from nothing is the point rather than the shape,
18446
18718
  and accept that a series which never approaches zero becomes a flat rule
18447
18719
  near the top of the box. */
18448
18720
  "prop:zero"?: (HelixLineChart["zero"]) | undefined;
18721
+ /** 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. */
18722
+ "on:helix-reading-change"?: ((
18723
+ e: HelixLineChartHelixReadingChangeElementEvent,
18724
+ ) => void) | undefined;
18725
+ /** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
18726
+ "on:helix-reading-press"?: ((
18727
+ e: HelixLineChartHelixReadingPressElementEvent,
18728
+ ) => void) | undefined;
18449
18729
 
18450
18730
  /** Set the innerHTML of the element */
18451
18731
  innerHTML?: (string) | undefined;
@@ -26984,6 +27264,18 @@ export type HelixSandboxToolbarSolidJsProps = {
26984
27264
  textContent?: (string | number) | undefined;
26985
27265
  };
26986
27266
 
27267
+ /** `HelixScatterChart` component event */
27268
+ export type HelixScatterChartElementEvent<E = Event> = TypedEvent<
27269
+ HelixScatterChart,
27270
+ E
27271
+ >;
27272
+ /** `helix-reading-change` event type */
27273
+ export type HelixScatterChartHelixReadingChangeElementEvent =
27274
+ HelixScatterChartElementEvent<HelixReadingChangeEvent>;
27275
+ /** `helix-reading-press` event type */
27276
+ export type HelixScatterChartHelixReadingPressElementEvent =
27277
+ HelixScatterChartElementEvent<HelixReadingPressEvent>;
27278
+
26987
27279
  export type HelixScatterChartProps = {
26988
27280
  /** The id of the table to read.
26989
27281
 
@@ -27080,6 +27372,15 @@ Absent draws none. A series with fewer than two points, or with every
27080
27372
  point at one measure across, has no line to draw. The summary already
27081
27373
  gives each series' correlation, which says how near the points are to it. */
27082
27374
  trend?: (HelixScatterChart["trend"]) | undefined;
27375
+
27376
+ /** 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. */
27377
+ "onhelix-reading-change"?: ((
27378
+ e: HelixScatterChartHelixReadingChangeElementEvent,
27379
+ ) => void) | undefined;
27380
+ /** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
27381
+ "onhelix-reading-press"?: ((
27382
+ e: HelixScatterChartHelixReadingPressElementEvent,
27383
+ ) => void) | undefined;
27083
27384
  };
27084
27385
 
27085
27386
  export type HelixScatterChartSolidJsProps = {
@@ -27178,6 +27479,14 @@ Absent draws none. A series with fewer than two points, or with every
27178
27479
  point at one measure across, has no line to draw. The summary already
27179
27480
  gives each series' correlation, which says how near the points are to it. */
27180
27481
  "prop:trend"?: (HelixScatterChart["trend"]) | undefined;
27482
+ /** 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. */
27483
+ "on:helix-reading-change"?: ((
27484
+ e: HelixScatterChartHelixReadingChangeElementEvent,
27485
+ ) => void) | undefined;
27486
+ /** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
27487
+ "on:helix-reading-press"?: ((
27488
+ e: HelixScatterChartHelixReadingPressElementEvent,
27489
+ ) => void) | undefined;
27181
27490
 
27182
27491
  /** Set the innerHTML of the element */
27183
27492
  innerHTML?: (string) | undefined;
@@ -29005,6 +29314,9 @@ Reading gives where it is; writing declares it the consumer's, and
29005
29314
  `default-position` seeds one this element owns. The same accessor pair
29006
29315
  `Pagination.page` and the calendar's `month` carry. */
29007
29316
  position?: (HelixSplitter["position"]) | undefined;
29317
+ /** The pane that keeps its size when the splitter's own size changes. The
29318
+ other pane takes all of the change. Unset, both keep their share. */
29319
+ primary?: (HelixSplitter["primary"]) | undefined;
29008
29320
  /** Where a dragged divider snaps, comma separated, as Web Awesome's split
29009
29321
  panel does: a bare number is a percentage and a length such as `240px` is
29010
29322
  measured along the splitter, so `snap="25, 50, 75"` or `snap="240px, 50"`.
@@ -29158,6 +29470,9 @@ Reading gives where it is; writing declares it the consumer's, and
29158
29470
  `default-position` seeds one this element owns. The same accessor pair
29159
29471
  `Pagination.page` and the calendar's `month` carry. */
29160
29472
  "prop:position"?: (HelixSplitter["position"]) | undefined;
29473
+ /** The pane that keeps its size when the splitter's own size changes. The
29474
+ other pane takes all of the change. Unset, both keep their share. */
29475
+ "prop:primary"?: (HelixSplitter["primary"]) | undefined;
29161
29476
  /** Where a dragged divider snaps, comma separated, as Web Awesome's split
29162
29477
  panel does: a bare number is a percentage and a length such as `240px` is
29163
29478
  measured along the splitter, so `snap="25, 50, 75"` or `snap="240px, 50"`.
@@ -30579,6 +30894,13 @@ order has its whole sentence. `{order}` is the deprecated
30579
30894
  };
30580
30895
 
30581
30896
  export type HelixTableRowProps = {
30897
+ /** Takes the row out of the table's selection and out of its link: the row's
30898
+ checkbox is disabled, Space, Shift ranges, and the checkbox in the heading
30899
+ pass over it, and a press does not follow `href`. A row already selected
30900
+ stays selected. A screen reader hears it as unavailable, and in a `grid`
30901
+ table the arrow keys still reach it, as a disabled cell in a grid is
30902
+ reached. */
30903
+ disabled?: (HelixTableRow["disabled"]) | undefined;
30582
30904
  /** The URL a press on the row follows, which makes the whole row a link.
30583
30905
  Empty, the default, leaves presses to the row's cells. */
30584
30906
  href?: (HelixTableRow["href"]) | undefined;
@@ -30592,6 +30914,13 @@ known by its place among the rows as written. */
30592
30914
  };
30593
30915
 
30594
30916
  export type HelixTableRowSolidJsProps = {
30917
+ /** Takes the row out of the table's selection and out of its link: the row's
30918
+ checkbox is disabled, Space, Shift ranges, and the checkbox in the heading
30919
+ pass over it, and a press does not follow `href`. A row already selected
30920
+ stays selected. A screen reader hears it as unavailable, and in a `grid`
30921
+ table the arrow keys still reach it, as a disabled cell in a grid is
30922
+ reached. */
30923
+ "prop:disabled"?: (HelixTableRow["disabled"]) | undefined;
30595
30924
  /** The URL a press on the row follows, which makes the whole row a link.
30596
30925
  Empty, the default, leaves presses to the row's cells. */
30597
30926
  "prop:href"?: (HelixTableRow["href"]) | undefined;
@@ -35711,6 +36040,14 @@ regardless, because a reader who stopped it is deciding what to do next. */
35711
36040
  loadingLabel?: (HelixVideo["loadingLabel"]) | undefined;
35712
36041
  /** Whether the video starts again at the end. */
35713
36042
  loop?: (HelixVideo["loop"]) | undefined;
36043
+ /** The title the device's own media controls show while the video plays,
36044
+ such as on a lock screen. Empty, the default, shows `label`. A playlist
36045
+ writes the current entry's name here. */
36046
+ "media-title"?: (HelixVideo["mediaTitle"]) | undefined;
36047
+ /** The title the device's own media controls show while the video plays,
36048
+ such as on a lock screen. Empty, the default, shows `label`. A playlist
36049
+ writes the current entry's name here. */
36050
+ mediaTitle?: (HelixVideo["mediaTitle"]) | undefined;
35714
36051
  /** What the button that opens `overflow-controls` is called. */
35715
36052
  "more-label"?: (HelixVideo["moreLabel"]) | undefined;
35716
36053
  /** What the button that opens `overflow-controls` is called. */
@@ -36170,6 +36507,14 @@ regardless, because a reader who stopped it is deciding what to do next. */
36170
36507
  "prop:loadingLabel"?: (HelixVideo["loadingLabel"]) | undefined;
36171
36508
  /** Whether the video starts again at the end. */
36172
36509
  "prop:loop"?: (HelixVideo["loop"]) | undefined;
36510
+ /** The title the device's own media controls show while the video plays,
36511
+ such as on a lock screen. Empty, the default, shows `label`. A playlist
36512
+ writes the current entry's name here. */
36513
+ "attr:media-title"?: (HelixVideo["mediaTitle"]) | undefined;
36514
+ /** The title the device's own media controls show while the video plays,
36515
+ such as on a lock screen. Empty, the default, shows `label`. A playlist
36516
+ writes the current entry's name here. */
36517
+ "prop:mediaTitle"?: (HelixVideo["mediaTitle"]) | undefined;
36173
36518
  /** What the button that opens `overflow-controls` is called. */
36174
36519
  "attr:more-label"?: (HelixVideo["moreLabel"]) | undefined;
36175
36520
  /** What the button that opens `overflow-controls` is called. */
@@ -36430,6 +36775,12 @@ export type HelixVirtualListProps = {
36430
36775
  items out as a grid of that many equal columns, windowed a line at a
36431
36776
  time, with Left and Right moving along a line. */
36432
36777
  columns?: (HelixVirtualList["columns"]) | undefined;
36778
+ /** The text of the row shown when there are no items and none are loading,
36779
+ where the `empty` slot is empty. Empty, the default, shows no row. */
36780
+ "empty-label"?: (HelixVirtualList["emptyLabel"]) | undefined;
36781
+ /** The text of the row shown when there are no items and none are loading,
36782
+ where the `empty` slot is empty. Empty, the default, shows no row. */
36783
+ emptyLabel?: (HelixVirtualList["emptyLabel"]) | undefined;
36433
36784
  /** The height of one row, in pixels, used to find the row at a scroll offset.
36434
36785
 
36435
36786
  An estimate rather than a measurement while `measured` is off, which is
@@ -36527,6 +36878,12 @@ export type HelixVirtualListSolidJsProps = {
36527
36878
  items out as a grid of that many equal columns, windowed a line at a
36528
36879
  time, with Left and Right moving along a line. */
36529
36880
  "prop:columns"?: (HelixVirtualList["columns"]) | undefined;
36881
+ /** The text of the row shown when there are no items and none are loading,
36882
+ where the `empty` slot is empty. Empty, the default, shows no row. */
36883
+ "attr:empty-label"?: (HelixVirtualList["emptyLabel"]) | undefined;
36884
+ /** The text of the row shown when there are no items and none are loading,
36885
+ where the `empty` slot is empty. Empty, the default, shows no row. */
36886
+ "prop:emptyLabel"?: (HelixVirtualList["emptyLabel"]) | undefined;
36530
36887
  /** The height of one row, in pixels, used to find the row at a scroll offset.
36531
36888
 
36532
36889
  An estimate rather than a measurement while `measured` is off, which is
@@ -37104,6 +37461,11 @@ export type CustomElements = {
37104
37461
  * **Named for the region and not for what is usually in it.** The middle slot
37105
37462
  * takes a search field or a breadcrumb trail as readily as a `Navigation`, so
37106
37463
  * the property carries the part's name, `content`.
37464
+ * - `fold-below`/`foldBelow`: The width of the bar, in pixels, below which the middle region folds behind
37465
+ * a toggle. Unset, it never folds.
37466
+ * - `hide-on-scroll`/`hideOnScroll`: Hides the bar as the page scrolls down past it, and shows it again as the
37467
+ * page scrolls up.
37468
+ * - `menu-label`/`menuLabel`: The name of the toggle that opens a folded middle region.
37107
37469
  * - `scroller`: The id of the element whose scrolling lifts the bar, for an app shell that
37108
37470
  * scrolls a container instead of the window. Unset is the window.
37109
37471
  * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
@@ -37140,6 +37502,7 @@ export type CustomElements = {
37140
37502
  * - `(default)`: The middle region, usually a `Navigation`.
37141
37503
  * - `end`: Trailing content, usually a call to action.
37142
37504
  * - `start`: Leading content, usually a wordmark.
37505
+ * - `menu-icon`: Replaces the glyph inside the toggle that opens a folded middle region.
37143
37506
  *
37144
37507
  * ## CSS Custom Properties
37145
37508
  *
@@ -37160,11 +37523,16 @@ export type CustomElements = {
37160
37523
  * - `end`: The trailing region.
37161
37524
  * - `row`: The centered row inside the banner.
37162
37525
  * - `start`: The leading region.
37526
+ * - `toggle`: The control that opens and closes the folded middle region, drawn while the bar is narrower than `fold-below`.
37527
+ * - `toggle-mark`: The glyph on the toggle, where none is slotted.
37163
37528
  *
37164
37529
  * ## CSS States
37165
37530
  *
37166
37531
  * These can be used to apply styling when a component is in a given state.
37167
37532
  *
37533
+ * - `folded`: While the bar is narrower than `fold-below`, and the middle region is behind the toggle.
37534
+ * - `hidden`: While `hide-on-scroll` has the bar out of the way, after a scroll down.
37535
+ * - `open`: While the folded middle region is open.
37168
37536
  * - `scrolled`: While the page is scrolled down from the top, which is when the bar lifts off it.
37169
37537
  * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
37170
37538
  */
@@ -37258,6 +37626,11 @@ export type CustomElements = {
37258
37626
  * `{totalLabel}` the name for the sum, `{total}` the sum, written in the
37259
37627
  * locale, and `{shares}` each part's share, listed as the locale lists.
37260
37628
  * - `total-label`/`totalLabel`: The name for the sum of the parts, shown in the tooltip and the summary.
37629
+ * - `value-axis`/`valueAxis`: Draws the scale's numbers beside the plot, the `axis` part, at the levels
37630
+ * `gridlines` rules: amounts, or percentages under `share`.
37631
+ *
37632
+ * Absent draws none: bands read as a composition need no numbers beside
37633
+ * them, and the tooltip and the table hold every reading.
37261
37634
  * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
37262
37635
  *
37263
37636
  * Public for the same reason `series` and `named` are: a protected member
@@ -37319,6 +37692,13 @@ export type CustomElements = {
37319
37692
  * browser harness's awaits it alone: a browser always runs the frame, and a
37320
37693
  * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
37321
37694
  *
37695
+ * ## Events
37696
+ *
37697
+ * Events that will be emitted by the component.
37698
+ *
37699
+ * - `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.
37700
+ * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
37701
+ *
37322
37702
  * ## Methods
37323
37703
  *
37324
37704
  * Methods that can be called to access component functionality.
@@ -37366,12 +37746,14 @@ export type CustomElements = {
37366
37746
  * - `--area-chart-overlap-opacity`: How much of each band shows under `overlap`, where the bands in front let the ones behind show through.
37367
37747
  * - `--area-chart-width`: Thickness of a band's top edge. Overrides `--chart-stroke`.
37368
37748
  * - `--chart-stroke`: Thickness of a band's top edge. Area Chart, Line Chart, and Bar Chart's `lines` all read this one property. `--area-chart-width` overrides it here.
37749
+ * - `--area-chart-axis`: The width of the axis, in `ch`, set from the widest number on it. Written by the component on the axis.
37369
37750
  *
37370
37751
  * ## CSS Parts
37371
37752
  *
37372
37753
  * Custom selectors for styling elements within the component.
37373
37754
  *
37374
37755
  * - `area`: One part's band.
37756
+ * - `axis`: The numbers of the scale beside the plot, under `value-axis`.
37375
37757
  * - `baseline`: The rule at zero, which is the floor of the drawing.
37376
37758
  * - `gridline`: One rule across the plot, under `gridlines`.
37377
37759
  * - `guide`: A rule down the reading a pointer is resting on.
@@ -37383,6 +37765,7 @@ export type CustomElements = {
37383
37765
  * - `plot`: The drawing, which takes focus to be read by key.
37384
37766
  * - `summary`: The total and each part's share at the latest reading, written as a sentence for screen readers.
37385
37767
  * - `svg`: The drawing surface the bands sit on.
37768
+ * - `tick`: One number on the axis, placed with `inset-block-start` at its level.
37386
37769
  * - `tooltip`: The bubble, forwarded from `Tooltip`.
37387
37770
  * - `tooltip-anchor`: The `Tooltip` element itself.
37388
37771
  * - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
@@ -38185,6 +38568,12 @@ export type CustomElements = {
38185
38568
  * - `summary-label`/`summaryLabel`: The summary's sentence. `{highestLabel}` is `highest-label`, and
38186
38569
  * `{readings}` each series' highest reading: the series, the category and
38187
38570
  * the reading as the table writes it.
38571
+ * - `value-axis`/`valueAxis`: Draws the numbers of the scale the bars are measured on, the `axis` part,
38572
+ * at the levels `gridlines` rules: down the side of columns, and along the
38573
+ * bottom of bars under `orientation="horizontal"`.
38574
+ *
38575
+ * Absent draws none with one scale, since bars compared with each other need
38576
+ * no numbers. With `secondary` both scales are drawn whatever this says.
38188
38577
  * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
38189
38578
  *
38190
38579
  * Public for the same reason `series` and `named` are: a protected member
@@ -38246,6 +38635,13 @@ export type CustomElements = {
38246
38635
  * browser harness's awaits it alone: a browser always runs the frame, and a
38247
38636
  * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
38248
38637
  *
38638
+ * ## Events
38639
+ *
38640
+ * Events that will be emitted by the component.
38641
+ *
38642
+ * - `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.
38643
+ * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
38644
+ *
38249
38645
  * ## Methods
38250
38646
  *
38251
38647
  * Methods that can be called to access component functionality.
@@ -38303,7 +38699,7 @@ export type CustomElements = {
38303
38699
  *
38304
38700
  * Custom selectors for styling elements within the component.
38305
38701
  *
38306
- * - `axis`: The numbers of one scale, drawn only when `secondary` splits the chart into two scales.
38702
+ * - `axis`: The numbers of one scale: the primary under `value-axis`, and both when `secondary` splits the chart into two scales.
38307
38703
  * - `band`: The category band under the pointer.
38308
38704
  * - `bar`: One column.
38309
38705
  * - `bar-wash-end`: The far stop of a bar's gradient, where one is used.
@@ -40333,7 +40729,12 @@ export type CustomElements = {
40333
40729
  * Component attributes and properties that can be applied to the element or by using JavaScript.
40334
40730
  *
40335
40731
  * - `label`: The field's name, read by screen readers.
40732
+ * - `maxlength`/`maxLength`: The most characters a draft can have. The field stops taking more.
40733
+ * - `minlength`/`minLength`: The fewest characters a draft can have, once the reader has written in
40734
+ * the field, as on a `<textarea>`.
40336
40735
  * - `placeholder`: Placeholder text shown in an empty field.
40736
+ * - `required`: Whether the form needs a draft to submit. An empty draft never sends,
40737
+ * required or not.
40337
40738
  * - `rows`: How many rows the field opens at.
40338
40739
  *
40339
40740
  * It grows from there.
@@ -40499,6 +40900,7 @@ export type CustomElements = {
40499
40900
  *
40500
40901
  * These can be used to apply styling when a component is in a given state.
40501
40902
  *
40903
+ * - `invalid`: The draft fails `required`, `minlength`, `maxlength`, or a custom error, and the reader has tried to send or submit it, or edited the field and left it.
40502
40904
  * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
40503
40905
  */
40504
40906
  "helix-chat-composer": Partial<
@@ -43266,6 +43668,12 @@ export type CustomElements = {
43266
43668
  * rows are chosen, written in the locale, and a language that needs plural
43267
43669
  * forms writes them: `{count, plural, one {# wybrany} few {# wybrane} many
43268
43670
  * {# wybranych} other {# wybranego}}`.
43671
+ * - `selection-behavior`/`selectionBehavior`: What a key or a press on a row does to the rows already selected, in a
43672
+ * `selectable` table. `toggle`, the default, keeps them: Space adds or takes
43673
+ * out the row. `replace` selects the row alone, as a file list does: Down and
43674
+ * Up carry the selection with them, and a press on a row selects it. Control
43675
+ * or Command with a press or Space adds or takes out one row, and with a move
43676
+ * goes without selecting. The checkboxes add or take out one row either way.
43269
43677
  * - `select-row-label`/`selectRowLabel`: The name of a row's checkbox. `{row}` is replaced with the row's value in
43270
43678
  * the first column that has a field, or with its key.
43271
43679
  * - `sort`: The sort order, as `field:direction`.
@@ -43362,7 +43770,9 @@ export type CustomElements = {
43362
43770
  * Areas where markup can be added to the component.
43363
43771
  *
43364
43772
  * - `(default)`: The columns, as `TableColumn` elements.
43773
+ * - `empty`: Content shown when there are no rows to show and none are loading, such as a picture and a link. Falls back to `empty-text`, which the live region still says.
43365
43774
  * - `footer`: Content below the grid. It replaces the built-in pagination.
43775
+ * - `loading`: Content shown while the rows load, such as a spinner. Falls back to `loading-text`, which the live region still says.
43366
43776
  * - `toolbar`: Content above the grid, such as a search field or actions.
43367
43777
  *
43368
43778
  * ## Methods
@@ -44556,8 +44966,14 @@ export type CustomElements = {
44556
44966
  * `closedby="any"` gains light dismiss without giving up the refusal, which is
44557
44967
  * the property this component exists to keep.
44558
44968
  *
44969
+ * The press on the backdrop that this element handles itself follows it too:
44970
+ * `closerequest` and `none` leave the dialog open on that press, as the
44971
+ * platform does, and `none` also keeps it open on Escape in a browser without
44972
+ * `closedby`.
44973
+ *
44559
44974
  * Absent by default, which is the platform's `auto` and this library's rule
44560
- * that a resting value is an attribute's absence.
44975
+ * that a resting value is an attribute's absence. Absent, a press on the
44976
+ * backdrop closes the dialog.
44561
44977
  * - `dismissible`: Draws a control that closes the dialog, in the corner where the title is.
44562
44978
  *
44563
44979
  * Pressing it is `close()`, so it sends `helix-before-close` like every other
@@ -44712,10 +45128,6 @@ export type CustomElements = {
44712
45128
  * A divider with nothing set into it is one line whatever this says.
44713
45129
  * - `announced`: Whether screen readers announce the line as a separator, which they now do
44714
45130
  * by default.
44715
- *
44716
- * It dates from when the line was decorative by default. It is still read,
44717
- * and it wins over `decorative`, so a divider written with it stays a
44718
- * separator.
44719
45131
  * - `decorative`: Takes the line out of the accessibility tree, for a rule that separates
44720
45132
  * nothing: one under a heading, or between the facts of a byline.
44721
45133
  *
@@ -45148,6 +45560,11 @@ export type CustomElements = {
45148
45560
  * lost its focus trap because a consumer forgot a word would be worse than an
45149
45561
  * attribute on the host, and nothing selects on it: the scrim is rendered or
45150
45562
  * not, rather than shown or hidden by CSS.
45563
+ * - `persistent`: Stops Escape, a press outside, and a swipe from closing the drawer, for a
45564
+ * drawer that has to be answered.
45565
+ *
45566
+ * The close control and `close()` still close it, as on `Dialog`: a panel
45567
+ * with no way out at all is a trap.
45151
45568
  * - `placement`: Which edge the drawer comes from.
45152
45569
  *
45153
45570
  * Unset is `end`, and it stays unset rather than being written down: a
@@ -49227,6 +49644,12 @@ export type CustomElements = {
49227
49644
  * masked with one disc per series and every stroke stops at its own ring's
49228
49645
  * inner edge. `mask-composite: intersect` is what makes N holes out of N
49229
49646
  * layers; a single `mask-image` would only ever cut the last one.
49647
+ * - `value-axis`/`valueAxis`: Draws the scale's numbers beside the plot, the `axis` part, at the levels
49648
+ * `gridlines` rules, so a reading can be measured off the drawing as well
49649
+ * as read from the tooltip.
49650
+ *
49651
+ * Absent draws none: a line read for its shape needs no numbers beside it,
49652
+ * and the tooltip and the table hold every reading.
49230
49653
  * - `zero`: Whether the range always includes zero.
49231
49654
  *
49232
49655
  * Absent measures from the data's own extent, which is what a line is for.
@@ -49294,6 +49717,13 @@ export type CustomElements = {
49294
49717
  * browser harness's awaits it alone: a browser always runs the frame, and a
49295
49718
  * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
49296
49719
  *
49720
+ * ## Events
49721
+ *
49722
+ * Events that will be emitted by the component.
49723
+ *
49724
+ * - `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.
49725
+ * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
49726
+ *
49297
49727
  * ## Methods
49298
49728
  *
49299
49729
  * Methods that can be called to access component functionality.
@@ -49348,12 +49778,14 @@ export type CustomElements = {
49348
49778
  * - `--line-chart-width`: Thickness of a line. Overrides `--chart-stroke`.
49349
49779
  * - `--chart-terminus-x`: Where a series' last reading sits horizontally, as a percentage. Written by the component.
49350
49780
  * - `--chart-terminus-y`: Where a series' last reading sits vertically, as a percentage. Written by the component.
49781
+ * - `--line-chart-axis`: The width of the axis, in `ch`, set from the widest number on it. Written by the component on the axis.
49351
49782
  *
49352
49783
  * ## CSS Parts
49353
49784
  *
49354
49785
  * Custom selectors for styling elements within the component.
49355
49786
  *
49356
49787
  * - `area`: The wash under one line, where `area` is set.
49788
+ * - `axis`: The numbers of the scale beside the plot, under `value-axis`.
49357
49789
  * - `band`: The band around the reading under the pointer.
49358
49790
  * - `baseline`: The rule at zero, where zero is inside the range.
49359
49791
  * - `gridline`: One rule across the plot, under `gridlines`.
@@ -49370,6 +49802,7 @@ export type CustomElements = {
49370
49802
  * - `summary`: The chart's name and each series' latest reading, written as a sentence for screen readers. Hide it visually.
49371
49803
  * - `svg`: The drawing surface the lines and areas sit on.
49372
49804
  * - `terminus`: The mark on one series' last reading.
49805
+ * - `tick`: One number on the axis, placed with `inset-block-start` at its level.
49373
49806
  * - `tooltip`: The bubble, forwarded from `Tooltip`.
49374
49807
  * - `tooltip-anchor`: The `Tooltip` element itself.
49375
49808
  * - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
@@ -55732,6 +56165,12 @@ export type CustomElements = {
55732
56165
  * pointer, the keyboard, and the corner. The inner splitter holds the panes and
55733
56166
  * the outer one holds the panel, so the panel spans the full width.
55734
56167
  *
56168
+ * On a focused divider, the arrow keys move it, and `Home` and `End` move it
56169
+ * to its ends. `Enter` on the panes divider shuts the lead pane, and pressed
56170
+ * again it opens the pane where it was. `Enter` on the panel divider shuts the
56171
+ * panel to `panel-collapsed-size`, and pressed again it opens the panel to its
56172
+ * last height.
56173
+ *
55735
56174
  * ## Attributes & Properties
55736
56175
  *
55737
56176
  * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -56364,6 +56803,13 @@ export type CustomElements = {
56364
56803
  * browser harness's awaits it alone: a browser always runs the frame, and a
56365
56804
  * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
56366
56805
  *
56806
+ * ## Events
56807
+ *
56808
+ * Events that will be emitted by the component.
56809
+ *
56810
+ * - `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.
56811
+ * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
56812
+ *
56367
56813
  * ## Methods
56368
56814
  *
56369
56815
  * Methods that can be called to access component functionality.
@@ -58047,6 +58493,8 @@ export type CustomElements = {
58047
58493
  * Reading gives where it is; writing declares it the consumer's, and
58048
58494
  * `default-position` seeds one this element owns. The same accessor pair
58049
58495
  * `Pagination.page` and the calendar's `month` carry.
58496
+ * - `primary`: The pane that keeps its size when the splitter's own size changes. The
58497
+ * other pane takes all of the change. Unset, both keep their share.
58050
58498
  * - `snap`: Where a dragged divider snaps, comma separated, as Web Awesome's split
58051
58499
  * panel does: a bare number is a percentage and a length such as `240px` is
58052
58500
  * measured along the splitter, so `snap="25, 50, 75"` or `snap="240px, 50"`.
@@ -58449,7 +58897,14 @@ export type CustomElements = {
58449
58897
  "helix-steps": Partial<HelixStepsProps & BaseProps<HelixSteps> & BaseEvents<HelixSteps>>;
58450
58898
 
58451
58899
  /**
58900
+ * A step draws its mark, its name as a `helix-button`, and the line that joins
58901
+ * it to the steps either side. The mark is a tick on a finished step, a dot
58902
+ * on the current one, and an empty ring on one nobody has reached. Where the
58903
+ * list sets `variant="numeric"`, it is the step's number.
58452
58904
  *
58905
+ * Down a column, the current step opens to show what is in its `content` slot,
58906
+ * and the others collapse it. A collapsed stage's content is hidden, so Tab and
58907
+ * a screen reader pass over it as well.
58453
58908
  *
58454
58909
  * ## Attributes & Properties
58455
58910
  *
@@ -59171,7 +59626,9 @@ export type CustomElements = {
59171
59626
  * Areas where markup can be added to the component.
59172
59627
  *
59173
59628
  * - `(default)`: The table's rows.
59629
+ * - `empty`: Content shown when there are no rows and none are loading, such as a picture and a link. Falls back to `empty-text`, which the live region still says.
59174
59630
  * - `heading`: Words that name the table, shown above it in the weight of a heading.
59631
+ * - `loading`: Content shown while the rows load, such as a spinner. Falls back to `loading-text`, which the live region still says.
59175
59632
  *
59176
59633
  * ## Methods
59177
59634
  *
@@ -59241,6 +59698,12 @@ export type CustomElements = {
59241
59698
  *
59242
59699
  * Component attributes and properties that can be applied to the element or by using JavaScript.
59243
59700
  *
59701
+ * - `disabled`: Takes the row out of the table's selection and out of its link: the row's
59702
+ * checkbox is disabled, Space, Shift ranges, and the checkbox in the heading
59703
+ * pass over it, and a press does not follow `href`. A row already selected
59704
+ * stays selected. A screen reader hears it as unavailable, and in a `grid`
59705
+ * table the arrow keys still reach it, as a disabled cell in a grid is
59706
+ * reached.
59244
59707
  * - `href`: The URL a press on the row follows, which makes the whole row a link.
59245
59708
  * Empty, the default, leaves presses to the row's cells.
59246
59709
  * - `rel`: The `rel` of the row's link. You set it yourself, as on an anchor.
@@ -59283,6 +59746,7 @@ export type CustomElements = {
59283
59746
  * - `--table-drop-indicator-size`: The thickness of the line where a moved row would land.
59284
59747
  * - `--table-grip-color`: The color of a row's grip, in a `reorderable` table.
59285
59748
  * - `--table-grip-disabled-opacity`: The opacity of a row's grip while a sort decides the order.
59749
+ * - `--table-row-disabled-opacity`: The opacity of the cells of a `disabled` row.
59286
59750
  * - `--table-row-hover-background-color`: The wash across the cells of a row with `href` under the pointer.
59287
59751
  *
59288
59752
  * ## CSS Parts
@@ -59313,7 +59777,7 @@ export type CustomElements = {
59313
59777
  * - `dragging`: The row is being moved, in a `reorderable` table.
59314
59778
  * - `drop-after`: The row being moved goes after this one when it is dropped.
59315
59779
  * - `drop-before`: The row being moved goes before this one when it is dropped.
59316
- * - `link`: While the row has `href`, so a press on it follows the link.
59780
+ * - `link`: While the row has `href` and is not `disabled`, so a press on it follows the link.
59317
59781
  * - `selected`: While the row is selected, in a `selectable` table.
59318
59782
  * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
59319
59783
  */
@@ -63457,6 +63921,9 @@ export type CustomElements = {
63457
63921
  * - `label`: Accessible name for the video, which its filename does not provide.
63458
63922
  * - `loading-label`/`loadingLabel`: The text announced while the video waits for more data.
63459
63923
  * - `loop`: Whether the video starts again at the end.
63924
+ * - `media-title`/`mediaTitle`: The title the device's own media controls show while the video plays,
63925
+ * such as on a lock screen. Empty, the default, shows `label`. A playlist
63926
+ * writes the current entry's name here.
63460
63927
  * - `more-label`/`moreLabel`: What the button that opens `overflow-controls` is called.
63461
63928
  * - `mute-label`/`muteLabel`: The name of the mute control. The control shows as pressed while the video
63462
63929
  * is muted.
@@ -63763,6 +64230,8 @@ export type CustomElements = {
63763
64230
  * - `columns`: How many items a line holds. One, the default, is a list; more lays the
63764
64231
  * items out as a grid of that many equal columns, windowed a line at a
63765
64232
  * time, with Left and Right moving along a line.
64233
+ * - `empty-label`/`emptyLabel`: The text of the row shown when there are no items and none are loading,
64234
+ * where the `empty` slot is empty. Empty, the default, shows no row.
63766
64235
  * - `estimate`: The height of one row, in pixels, used to find the row at a scroll offset.
63767
64236
  *
63768
64237
  * An estimate rather than a measurement while `measured` is off, which is
@@ -63852,6 +64321,7 @@ export type CustomElements = {
63852
64321
  * Areas where markup can be added to the component.
63853
64322
  *
63854
64323
  * - `(default)`: The `<template>` that defines one row. The list writes the rows it renders beside it, and this slot shows them between the two spacers.
64324
+ * - `empty`: Content for the row shown when there are no items and none are loading. Falls back to `empty-label`.
63855
64325
  * - `loading`: Content for the row after the last item while `loading` is set. Falls back to `loading-label`.
63856
64326
  *
63857
64327
  * ## Methods
@@ -63869,6 +64339,8 @@ export type CustomElements = {
63869
64339
  * CSS variables available for styling the component.
63870
64340
  *
63871
64341
  * - `--virtual-list-block-size`: How tall the scrolling box is.
64342
+ * - `--virtual-list-empty-color`: The color of the text in the row shown when there are no items.
64343
+ * - `--virtual-list-empty-padding`: The space around the text in the row shown when there are no items.
63872
64344
  * - `--virtual-list-loading-color`: The color of the text in the row drawn while `loading` is set.
63873
64345
  * - `--virtual-list-loading-padding`: The space around the text in the row drawn while `loading` is set.
63874
64346
  * - `--virtual-list-scrollbar-thumb-color`: The thumb of the list's scrollbar. Defaults to `--helix-scrollbar-thumb-color`.
@@ -63882,6 +64354,7 @@ export type CustomElements = {
63882
64354
  *
63883
64355
  * - `after`: The space that stands in for the rows below the rendered ones.
63884
64356
  * - `before`: The space that stands in for the rows above the rendered ones.
64357
+ * - `empty`: The row shown when there are no items and none are loading, where `empty-label` or the `empty` slot gives it content.
63885
64358
  * - `loading`: The row after the last item while `loading` is set.
63886
64359
  * - `viewport`: The scrolling box.
63887
64360
  *
@@ -64386,6 +64859,11 @@ export type CustomElementsSolidJs = {
64386
64859
  * **Named for the region and not for what is usually in it.** The middle slot
64387
64860
  * takes a search field or a breadcrumb trail as readily as a `Navigation`, so
64388
64861
  * the property carries the part's name, `content`.
64862
+ * - `fold-below`/`foldBelow`: The width of the bar, in pixels, below which the middle region folds behind
64863
+ * a toggle. Unset, it never folds.
64864
+ * - `hide-on-scroll`/`hideOnScroll`: Hides the bar as the page scrolls down past it, and shows it again as the
64865
+ * page scrolls up.
64866
+ * - `menu-label`/`menuLabel`: The name of the toggle that opens a folded middle region.
64389
64867
  * - `scroller`: The id of the element whose scrolling lifts the bar, for an app shell that
64390
64868
  * scrolls a container instead of the window. Unset is the window.
64391
64869
  * - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
@@ -64422,6 +64900,7 @@ export type CustomElementsSolidJs = {
64422
64900
  * - `(default)`: The middle region, usually a `Navigation`.
64423
64901
  * - `end`: Trailing content, usually a call to action.
64424
64902
  * - `start`: Leading content, usually a wordmark.
64903
+ * - `menu-icon`: Replaces the glyph inside the toggle that opens a folded middle region.
64425
64904
  *
64426
64905
  * ## CSS Custom Properties
64427
64906
  *
@@ -64442,11 +64921,16 @@ export type CustomElementsSolidJs = {
64442
64921
  * - `end`: The trailing region.
64443
64922
  * - `row`: The centered row inside the banner.
64444
64923
  * - `start`: The leading region.
64924
+ * - `toggle`: The control that opens and closes the folded middle region, drawn while the bar is narrower than `fold-below`.
64925
+ * - `toggle-mark`: The glyph on the toggle, where none is slotted.
64445
64926
  *
64446
64927
  * ## CSS States
64447
64928
  *
64448
64929
  * These can be used to apply styling when a component is in a given state.
64449
64930
  *
64931
+ * - `folded`: While the bar is narrower than `fold-below`, and the middle region is behind the toggle.
64932
+ * - `hidden`: While `hide-on-scroll` has the bar out of the way, after a scroll down.
64933
+ * - `open`: While the folded middle region is open.
64450
64934
  * - `scrolled`: While the page is scrolled down from the top, which is when the bar lifts off it.
64451
64935
  * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
64452
64936
  */
@@ -64543,6 +65027,11 @@ export type CustomElementsSolidJs = {
64543
65027
  * `{totalLabel}` the name for the sum, `{total}` the sum, written in the
64544
65028
  * locale, and `{shares}` each part's share, listed as the locale lists.
64545
65029
  * - `total-label`/`totalLabel`: The name for the sum of the parts, shown in the tooltip and the summary.
65030
+ * - `value-axis`/`valueAxis`: Draws the scale's numbers beside the plot, the `axis` part, at the levels
65031
+ * `gridlines` rules: amounts, or percentages under `share`.
65032
+ *
65033
+ * Absent draws none: bands read as a composition need no numbers beside
65034
+ * them, and the tooltip and the table hold every reading.
64546
65035
  * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
64547
65036
  *
64548
65037
  * Public for the same reason `series` and `named` are: a protected member
@@ -64604,6 +65093,13 @@ export type CustomElementsSolidJs = {
64604
65093
  * browser harness's awaits it alone: a browser always runs the frame, and a
64605
65094
  * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
64606
65095
  *
65096
+ * ## Events
65097
+ *
65098
+ * Events that will be emitted by the component.
65099
+ *
65100
+ * - `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.
65101
+ * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
65102
+ *
64607
65103
  * ## Methods
64608
65104
  *
64609
65105
  * Methods that can be called to access component functionality.
@@ -64651,12 +65147,14 @@ export type CustomElementsSolidJs = {
64651
65147
  * - `--area-chart-overlap-opacity`: How much of each band shows under `overlap`, where the bands in front let the ones behind show through.
64652
65148
  * - `--area-chart-width`: Thickness of a band's top edge. Overrides `--chart-stroke`.
64653
65149
  * - `--chart-stroke`: Thickness of a band's top edge. Area Chart, Line Chart, and Bar Chart's `lines` all read this one property. `--area-chart-width` overrides it here.
65150
+ * - `--area-chart-axis`: The width of the axis, in `ch`, set from the widest number on it. Written by the component on the axis.
64654
65151
  *
64655
65152
  * ## CSS Parts
64656
65153
  *
64657
65154
  * Custom selectors for styling elements within the component.
64658
65155
  *
64659
65156
  * - `area`: One part's band.
65157
+ * - `axis`: The numbers of the scale beside the plot, under `value-axis`.
64660
65158
  * - `baseline`: The rule at zero, which is the floor of the drawing.
64661
65159
  * - `gridline`: One rule across the plot, under `gridlines`.
64662
65160
  * - `guide`: A rule down the reading a pointer is resting on.
@@ -64668,6 +65166,7 @@ export type CustomElementsSolidJs = {
64668
65166
  * - `plot`: The drawing, which takes focus to be read by key.
64669
65167
  * - `summary`: The total and each part's share at the latest reading, written as a sentence for screen readers.
64670
65168
  * - `svg`: The drawing surface the bands sit on.
65169
+ * - `tick`: One number on the axis, placed with `inset-block-start` at its level.
64671
65170
  * - `tooltip`: The bubble, forwarded from `Tooltip`.
64672
65171
  * - `tooltip-anchor`: The `Tooltip` element itself.
64673
65172
  * - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
@@ -65486,6 +65985,12 @@ export type CustomElementsSolidJs = {
65486
65985
  * - `summary-label`/`summaryLabel`: The summary's sentence. `{highestLabel}` is `highest-label`, and
65487
65986
  * `{readings}` each series' highest reading: the series, the category and
65488
65987
  * the reading as the table writes it.
65988
+ * - `value-axis`/`valueAxis`: Draws the numbers of the scale the bars are measured on, the `axis` part,
65989
+ * at the levels `gridlines` rules: down the side of columns, and along the
65990
+ * bottom of bars under `orientation="horizontal"`.
65991
+ *
65992
+ * Absent draws none with one scale, since bars compared with each other need
65993
+ * no numbers. With `secondary` both scales are drawn whatever this says.
65489
65994
  * - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
65490
65995
  *
65491
65996
  * Public for the same reason `series` and `named` are: a protected member
@@ -65547,6 +66052,13 @@ export type CustomElementsSolidJs = {
65547
66052
  * browser harness's awaits it alone: a browser always runs the frame, and a
65548
66053
  * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
65549
66054
  *
66055
+ * ## Events
66056
+ *
66057
+ * Events that will be emitted by the component.
66058
+ *
66059
+ * - `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.
66060
+ * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
66061
+ *
65550
66062
  * ## Methods
65551
66063
  *
65552
66064
  * Methods that can be called to access component functionality.
@@ -65604,7 +66116,7 @@ export type CustomElementsSolidJs = {
65604
66116
  *
65605
66117
  * Custom selectors for styling elements within the component.
65606
66118
  *
65607
- * - `axis`: The numbers of one scale, drawn only when `secondary` splits the chart into two scales.
66119
+ * - `axis`: The numbers of one scale: the primary under `value-axis`, and both when `secondary` splits the chart into two scales.
65608
66120
  * - `band`: The category band under the pointer.
65609
66121
  * - `bar`: One column.
65610
66122
  * - `bar-wash-end`: The far stop of a bar's gradient, where one is used.
@@ -67669,7 +68181,12 @@ export type CustomElementsSolidJs = {
67669
68181
  * Component attributes and properties that can be applied to the element or by using JavaScript.
67670
68182
  *
67671
68183
  * - `label`: The field's name, read by screen readers.
68184
+ * - `maxlength`/`maxLength`: The most characters a draft can have. The field stops taking more.
68185
+ * - `minlength`/`minLength`: The fewest characters a draft can have, once the reader has written in
68186
+ * the field, as on a `<textarea>`.
67672
68187
  * - `placeholder`: Placeholder text shown in an empty field.
68188
+ * - `required`: Whether the form needs a draft to submit. An empty draft never sends,
68189
+ * required or not.
67673
68190
  * - `rows`: How many rows the field opens at.
67674
68191
  *
67675
68192
  * It grows from there.
@@ -67835,6 +68352,7 @@ export type CustomElementsSolidJs = {
67835
68352
  *
67836
68353
  * These can be used to apply styling when a component is in a given state.
67837
68354
  *
68355
+ * - `invalid`: The draft fails `required`, `minlength`, `maxlength`, or a custom error, and the reader has tried to send or submit it, or edited the field and left it.
67838
68356
  * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
67839
68357
  */
67840
68358
  "helix-chat-composer": Partial<
@@ -70636,6 +71154,12 @@ export type CustomElementsSolidJs = {
70636
71154
  * rows are chosen, written in the locale, and a language that needs plural
70637
71155
  * forms writes them: `{count, plural, one {# wybrany} few {# wybrane} many
70638
71156
  * {# wybranych} other {# wybranego}}`.
71157
+ * - `selection-behavior`/`selectionBehavior`: What a key or a press on a row does to the rows already selected, in a
71158
+ * `selectable` table. `toggle`, the default, keeps them: Space adds or takes
71159
+ * out the row. `replace` selects the row alone, as a file list does: Down and
71160
+ * Up carry the selection with them, and a press on a row selects it. Control
71161
+ * or Command with a press or Space adds or takes out one row, and with a move
71162
+ * goes without selecting. The checkboxes add or take out one row either way.
70639
71163
  * - `select-row-label`/`selectRowLabel`: The name of a row's checkbox. `{row}` is replaced with the row's value in
70640
71164
  * the first column that has a field, or with its key.
70641
71165
  * - `sort`: The sort order, as `field:direction`.
@@ -70732,7 +71256,9 @@ export type CustomElementsSolidJs = {
70732
71256
  * Areas where markup can be added to the component.
70733
71257
  *
70734
71258
  * - `(default)`: The columns, as `TableColumn` elements.
71259
+ * - `empty`: Content shown when there are no rows to show and none are loading, such as a picture and a link. Falls back to `empty-text`, which the live region still says.
70735
71260
  * - `footer`: Content below the grid. It replaces the built-in pagination.
71261
+ * - `loading`: Content shown while the rows load, such as a spinner. Falls back to `loading-text`, which the live region still says.
70736
71262
  * - `toolbar`: Content above the grid, such as a search field or actions.
70737
71263
  *
70738
71264
  * ## Methods
@@ -71939,8 +72465,14 @@ export type CustomElementsSolidJs = {
71939
72465
  * `closedby="any"` gains light dismiss without giving up the refusal, which is
71940
72466
  * the property this component exists to keep.
71941
72467
  *
72468
+ * The press on the backdrop that this element handles itself follows it too:
72469
+ * `closerequest` and `none` leave the dialog open on that press, as the
72470
+ * platform does, and `none` also keeps it open on Escape in a browser without
72471
+ * `closedby`.
72472
+ *
71942
72473
  * Absent by default, which is the platform's `auto` and this library's rule
71943
- * that a resting value is an attribute's absence.
72474
+ * that a resting value is an attribute's absence. Absent, a press on the
72475
+ * backdrop closes the dialog.
71944
72476
  * - `dismissible`: Draws a control that closes the dialog, in the corner where the title is.
71945
72477
  *
71946
72478
  * Pressing it is `close()`, so it sends `helix-before-close` like every other
@@ -72098,10 +72630,6 @@ export type CustomElementsSolidJs = {
72098
72630
  * A divider with nothing set into it is one line whatever this says.
72099
72631
  * - `announced`: Whether screen readers announce the line as a separator, which they now do
72100
72632
  * by default.
72101
- *
72102
- * It dates from when the line was decorative by default. It is still read,
72103
- * and it wins over `decorative`, so a divider written with it stays a
72104
- * separator.
72105
72633
  * - `decorative`: Takes the line out of the accessibility tree, for a rule that separates
72106
72634
  * nothing: one under a heading, or between the facts of a byline.
72107
72635
  *
@@ -72540,6 +73068,11 @@ export type CustomElementsSolidJs = {
72540
73068
  * lost its focus trap because a consumer forgot a word would be worse than an
72541
73069
  * attribute on the host, and nothing selects on it: the scrim is rendered or
72542
73070
  * not, rather than shown or hidden by CSS.
73071
+ * - `persistent`: Stops Escape, a press outside, and a swipe from closing the drawer, for a
73072
+ * drawer that has to be answered.
73073
+ *
73074
+ * The close control and `close()` still close it, as on `Dialog`: a panel
73075
+ * with no way out at all is a trap.
72543
73076
  * - `placement`: Which edge the drawer comes from.
72544
73077
  *
72545
73078
  * Unset is `end`, and it stays unset rather than being written down: a
@@ -76692,6 +77225,12 @@ export type CustomElementsSolidJs = {
76692
77225
  * masked with one disc per series and every stroke stops at its own ring's
76693
77226
  * inner edge. `mask-composite: intersect` is what makes N holes out of N
76694
77227
  * layers; a single `mask-image` would only ever cut the last one.
77228
+ * - `value-axis`/`valueAxis`: Draws the scale's numbers beside the plot, the `axis` part, at the levels
77229
+ * `gridlines` rules, so a reading can be measured off the drawing as well
77230
+ * as read from the tooltip.
77231
+ *
77232
+ * Absent draws none: a line read for its shape needs no numbers beside it,
77233
+ * and the tooltip and the table hold every reading.
76695
77234
  * - `zero`: Whether the range always includes zero.
76696
77235
  *
76697
77236
  * Absent measures from the data's own extent, which is what a line is for.
@@ -76759,6 +77298,13 @@ export type CustomElementsSolidJs = {
76759
77298
  * browser harness's awaits it alone: a browser always runs the frame, and a
76760
77299
  * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
76761
77300
  *
77301
+ * ## Events
77302
+ *
77303
+ * Events that will be emitted by the component.
77304
+ *
77305
+ * - `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.
77306
+ * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
77307
+ *
76762
77308
  * ## Methods
76763
77309
  *
76764
77310
  * Methods that can be called to access component functionality.
@@ -76813,12 +77359,14 @@ export type CustomElementsSolidJs = {
76813
77359
  * - `--line-chart-width`: Thickness of a line. Overrides `--chart-stroke`.
76814
77360
  * - `--chart-terminus-x`: Where a series' last reading sits horizontally, as a percentage. Written by the component.
76815
77361
  * - `--chart-terminus-y`: Where a series' last reading sits vertically, as a percentage. Written by the component.
77362
+ * - `--line-chart-axis`: The width of the axis, in `ch`, set from the widest number on it. Written by the component on the axis.
76816
77363
  *
76817
77364
  * ## CSS Parts
76818
77365
  *
76819
77366
  * Custom selectors for styling elements within the component.
76820
77367
  *
76821
77368
  * - `area`: The wash under one line, where `area` is set.
77369
+ * - `axis`: The numbers of the scale beside the plot, under `value-axis`.
76822
77370
  * - `band`: The band around the reading under the pointer.
76823
77371
  * - `baseline`: The rule at zero, where zero is inside the range.
76824
77372
  * - `gridline`: One rule across the plot, under `gridlines`.
@@ -76835,6 +77383,7 @@ export type CustomElementsSolidJs = {
76835
77383
  * - `summary`: The chart's name and each series' latest reading, written as a sentence for screen readers. Hide it visually.
76836
77384
  * - `svg`: The drawing surface the lines and areas sit on.
76837
77385
  * - `terminus`: The mark on one series' last reading.
77386
+ * - `tick`: One number on the axis, placed with `inset-block-start` at its level.
76838
77387
  * - `tooltip`: The bubble, forwarded from `Tooltip`.
76839
77388
  * - `tooltip-anchor`: The `Tooltip` element itself.
76840
77389
  * - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
@@ -83331,6 +83880,12 @@ export type CustomElementsSolidJs = {
83331
83880
  * pointer, the keyboard, and the corner. The inner splitter holds the panes and
83332
83881
  * the outer one holds the panel, so the panel spans the full width.
83333
83882
  *
83883
+ * On a focused divider, the arrow keys move it, and `Home` and `End` move it
83884
+ * to its ends. `Enter` on the panes divider shuts the lead pane, and pressed
83885
+ * again it opens the pane where it was. `Enter` on the panel divider shuts the
83886
+ * panel to `panel-collapsed-size`, and pressed again it opens the panel to its
83887
+ * last height.
83888
+ *
83334
83889
  * ## Attributes & Properties
83335
83890
  *
83336
83891
  * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -83978,6 +84533,13 @@ export type CustomElementsSolidJs = {
83978
84533
  * browser harness's awaits it alone: a browser always runs the frame, and a
83979
84534
  * timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
83980
84535
  *
84536
+ * ## Events
84537
+ *
84538
+ * Events that will be emitted by the component.
84539
+ *
84540
+ * - `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.
84541
+ * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
84542
+ *
83981
84543
  * ## Methods
83982
84544
  *
83983
84545
  * Methods that can be called to access component functionality.
@@ -85691,6 +86253,8 @@ export type CustomElementsSolidJs = {
85691
86253
  * Reading gives where it is; writing declares it the consumer's, and
85692
86254
  * `default-position` seeds one this element owns. The same accessor pair
85693
86255
  * `Pagination.page` and the calendar's `month` carry.
86256
+ * - `primary`: The pane that keeps its size when the splitter's own size changes. The
86257
+ * other pane takes all of the change. Unset, both keep their share.
85694
86258
  * - `snap`: Where a dragged divider snaps, comma separated, as Web Awesome's split
85695
86259
  * panel does: a bare number is a percentage and a length such as `240px` is
85696
86260
  * measured along the splitter, so `snap="25, 50, 75"` or `snap="240px, 50"`.
@@ -86106,7 +86670,14 @@ export type CustomElementsSolidJs = {
86106
86670
  >;
86107
86671
 
86108
86672
  /**
86673
+ * A step draws its mark, its name as a `helix-button`, and the line that joins
86674
+ * it to the steps either side. The mark is a tick on a finished step, a dot
86675
+ * on the current one, and an empty ring on one nobody has reached. Where the
86676
+ * list sets `variant="numeric"`, it is the step's number.
86109
86677
  *
86678
+ * Down a column, the current step opens to show what is in its `content` slot,
86679
+ * and the others collapse it. A collapsed stage's content is hidden, so Tab and
86680
+ * a screen reader pass over it as well.
86110
86681
  *
86111
86682
  * ## Attributes & Properties
86112
86683
  *
@@ -86839,7 +87410,9 @@ export type CustomElementsSolidJs = {
86839
87410
  * Areas where markup can be added to the component.
86840
87411
  *
86841
87412
  * - `(default)`: The table's rows.
87413
+ * - `empty`: Content shown when there are no rows and none are loading, such as a picture and a link. Falls back to `empty-text`, which the live region still says.
86842
87414
  * - `heading`: Words that name the table, shown above it in the weight of a heading.
87415
+ * - `loading`: Content shown while the rows load, such as a spinner. Falls back to `loading-text`, which the live region still says.
86843
87416
  *
86844
87417
  * ## Methods
86845
87418
  *
@@ -86914,6 +87487,12 @@ export type CustomElementsSolidJs = {
86914
87487
  *
86915
87488
  * Component attributes and properties that can be applied to the element or by using JavaScript.
86916
87489
  *
87490
+ * - `disabled`: Takes the row out of the table's selection and out of its link: the row's
87491
+ * checkbox is disabled, Space, Shift ranges, and the checkbox in the heading
87492
+ * pass over it, and a press does not follow `href`. A row already selected
87493
+ * stays selected. A screen reader hears it as unavailable, and in a `grid`
87494
+ * table the arrow keys still reach it, as a disabled cell in a grid is
87495
+ * reached.
86917
87496
  * - `href`: The URL a press on the row follows, which makes the whole row a link.
86918
87497
  * Empty, the default, leaves presses to the row's cells.
86919
87498
  * - `rel`: The `rel` of the row's link. You set it yourself, as on an anchor.
@@ -86956,6 +87535,7 @@ export type CustomElementsSolidJs = {
86956
87535
  * - `--table-drop-indicator-size`: The thickness of the line where a moved row would land.
86957
87536
  * - `--table-grip-color`: The color of a row's grip, in a `reorderable` table.
86958
87537
  * - `--table-grip-disabled-opacity`: The opacity of a row's grip while a sort decides the order.
87538
+ * - `--table-row-disabled-opacity`: The opacity of the cells of a `disabled` row.
86959
87539
  * - `--table-row-hover-background-color`: The wash across the cells of a row with `href` under the pointer.
86960
87540
  *
86961
87541
  * ## CSS Parts
@@ -86986,7 +87566,7 @@ export type CustomElementsSolidJs = {
86986
87566
  * - `dragging`: The row is being moved, in a `reorderable` table.
86987
87567
  * - `drop-after`: The row being moved goes after this one when it is dropped.
86988
87568
  * - `drop-before`: The row being moved goes before this one when it is dropped.
86989
- * - `link`: While the row has `href`, so a press on it follows the link.
87569
+ * - `link`: While the row has `href` and is not `disabled`, so a press on it follows the link.
86990
87570
  * - `selected`: While the row is selected, in a `selectable` table.
86991
87571
  * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
86992
87572
  */
@@ -91209,6 +91789,9 @@ export type CustomElementsSolidJs = {
91209
91789
  * - `label`: Accessible name for the video, which its filename does not provide.
91210
91790
  * - `loading-label`/`loadingLabel`: The text announced while the video waits for more data.
91211
91791
  * - `loop`: Whether the video starts again at the end.
91792
+ * - `media-title`/`mediaTitle`: The title the device's own media controls show while the video plays,
91793
+ * such as on a lock screen. Empty, the default, shows `label`. A playlist
91794
+ * writes the current entry's name here.
91212
91795
  * - `more-label`/`moreLabel`: What the button that opens `overflow-controls` is called.
91213
91796
  * - `mute-label`/`muteLabel`: The name of the mute control. The control shows as pressed while the video
91214
91797
  * is muted.
@@ -91520,6 +92103,8 @@ export type CustomElementsSolidJs = {
91520
92103
  * - `columns`: How many items a line holds. One, the default, is a list; more lays the
91521
92104
  * items out as a grid of that many equal columns, windowed a line at a
91522
92105
  * time, with Left and Right moving along a line.
92106
+ * - `empty-label`/`emptyLabel`: The text of the row shown when there are no items and none are loading,
92107
+ * where the `empty` slot is empty. Empty, the default, shows no row.
91523
92108
  * - `estimate`: The height of one row, in pixels, used to find the row at a scroll offset.
91524
92109
  *
91525
92110
  * An estimate rather than a measurement while `measured` is off, which is
@@ -91609,6 +92194,7 @@ export type CustomElementsSolidJs = {
91609
92194
  * Areas where markup can be added to the component.
91610
92195
  *
91611
92196
  * - `(default)`: The `<template>` that defines one row. The list writes the rows it renders beside it, and this slot shows them between the two spacers.
92197
+ * - `empty`: Content for the row shown when there are no items and none are loading. Falls back to `empty-label`.
91612
92198
  * - `loading`: Content for the row after the last item while `loading` is set. Falls back to `loading-label`.
91613
92199
  *
91614
92200
  * ## Methods
@@ -91626,6 +92212,8 @@ export type CustomElementsSolidJs = {
91626
92212
  * CSS variables available for styling the component.
91627
92213
  *
91628
92214
  * - `--virtual-list-block-size`: How tall the scrolling box is.
92215
+ * - `--virtual-list-empty-color`: The color of the text in the row shown when there are no items.
92216
+ * - `--virtual-list-empty-padding`: The space around the text in the row shown when there are no items.
91629
92217
  * - `--virtual-list-loading-color`: The color of the text in the row drawn while `loading` is set.
91630
92218
  * - `--virtual-list-loading-padding`: The space around the text in the row drawn while `loading` is set.
91631
92219
  * - `--virtual-list-scrollbar-thumb-color`: The thumb of the list's scrollbar. Defaults to `--helix-scrollbar-thumb-color`.
@@ -91639,6 +92227,7 @@ export type CustomElementsSolidJs = {
91639
92227
  *
91640
92228
  * - `after`: The space that stands in for the rows below the rendered ones.
91641
92229
  * - `before`: The space that stands in for the rows above the rendered ones.
92230
+ * - `empty`: The row shown when there are no items and none are loading, where `empty-label` or the `empty` slot gives it content.
91642
92231
  * - `loading`: The row after the last item while `loading` is set.
91643
92232
  * - `viewport`: The scrolling box.
91644
92233
  *
@@ -91723,6 +92312,8 @@ export type CustomCssProperties = {
91723
92312
  "--area-chart-width"?: (string) | undefined;
91724
92313
  /** Thickness of a band's top edge. Area Chart, Line Chart, and Bar Chart's `lines` all read this one property. `--area-chart-width` overrides it here. */
91725
92314
  "--chart-stroke"?: (string) | undefined;
92315
+ /** The width of the axis, in `ch`, set from the widest number on it. Written by the component on the axis. */
92316
+ "--area-chart-axis"?: (string) | undefined;
91726
92317
  /** The bright stop of the ramp. Defaults to `--helix-color-primary`. */
91727
92318
  "--aura-glow"?: (string) | undefined;
91728
92319
  /** The page the field fades into. Defaults to `--helix-color-background`. */
@@ -92733,6 +93324,8 @@ export type CustomCssProperties = {
92733
93324
  "--chart-terminus-x"?: (string) | undefined;
92734
93325
  /** Where a series' last reading sits vertically, as a percentage. Written by the component. */
92735
93326
  "--chart-terminus-y"?: (string) | undefined;
93327
+ /** The width of the axis, in `ch`, set from the widest number on it. Written by the component on the axis. */
93328
+ "--line-chart-axis"?: (string) | undefined;
92736
93329
  /** The fill behind a row that is `current`. */
92737
93330
  "--list-item-current-background-color"?: (string) | undefined;
92738
93331
  /** The opacity of a `disabled` row. */
@@ -93655,6 +94248,8 @@ export type CustomCssProperties = {
93655
94248
  "--table-grip-color"?: (string) | undefined;
93656
94249
  /** The opacity of a row's grip while a sort decides the order. */
93657
94250
  "--table-grip-disabled-opacity"?: (string) | undefined;
94251
+ /** The opacity of the cells of a `disabled` row. */
94252
+ "--table-row-disabled-opacity"?: (string) | undefined;
93658
94253
  /** The wash across the cells of a row with `href` under the pointer. */
93659
94254
  "--table-row-hover-background-color"?: (string) | undefined;
93660
94255
  /** The space between the tab row and the panel's content. */
@@ -94031,6 +94626,10 @@ export type CustomCssProperties = {
94031
94626
  "--video-progress"?: (string) | undefined;
94032
94627
  /** How tall the scrolling box is. */
94033
94628
  "--virtual-list-block-size"?: (string) | undefined;
94629
+ /** The color of the text in the row shown when there are no items. */
94630
+ "--virtual-list-empty-color"?: (string) | undefined;
94631
+ /** The space around the text in the row shown when there are no items. */
94632
+ "--virtual-list-empty-padding"?: (string) | undefined;
94034
94633
  /** The color of the text in the row drawn while `loading` is set. */
94035
94634
  "--virtual-list-loading-color"?: (string) | undefined;
94036
94635
  /** The space around the text in the row drawn while `loading` is set. */