@fusion.dev/helix-headless 0.152.0 → 0.153.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
@@ -1128,6 +1128,25 @@ them, and the tooltip and the table hold every reading. */
1128
1128
  Absent draws none: bands read as a composition need no numbers beside
1129
1129
  them, and the tooltip and the table hold every reading. */
1130
1130
  valueAxis?: (HelixHeadlessAreaChart["valueAxis"]) | undefined;
1131
+ /** The words shown in place of the drawing when the table has no readings,
1132
+ and the fallback of the `empty` slot. */
1133
+ "empty-text"?: (HelixHeadlessAreaChart["emptyText"]) | undefined;
1134
+ /** The words shown in place of the drawing when the table has no readings,
1135
+ and the fallback of the `empty` slot. */
1136
+ emptyText?: (HelixHeadlessAreaChart["emptyText"]) | undefined;
1137
+ /** Whether the readings are still on their way. The chart shows
1138
+ `loading-text` in place of an empty drawing until it has readings.
1139
+
1140
+ Reflected, so a stylesheet can treat the chart while it waits. A chart
1141
+ that already has readings keeps drawing them, so a refresh does not
1142
+ blank it. */
1143
+ loading?: (HelixHeadlessAreaChart["loading"]) | undefined;
1144
+ /** The words shown in place of the drawing while `loading` is set and
1145
+ there are no readings yet, and the fallback of the `loading` slot. */
1146
+ "loading-text"?: (HelixHeadlessAreaChart["loadingText"]) | undefined;
1147
+ /** The words shown in place of the drawing while `loading` is set and
1148
+ there are no readings yet, and the fallback of the `loading` slot. */
1149
+ loadingText?: (HelixHeadlessAreaChart["loadingText"]) | undefined;
1131
1150
  /** The id of the table to read.
1132
1151
 
1133
1152
  Names a table in the same tree, so a chart inside another component's
@@ -1164,6 +1183,29 @@ Set it to the words of the page's language, such as `{position} von
1164
1183
  {count}`, or to nothing to say no position. A slice or a series a
1165
1184
  legend hid is not counted. */
1166
1185
  positionLabel?: (HelixHeadlessAreaChart["positionLabel"]) | undefined;
1186
+ /** The readings as data, in the shape of a table, where the page has no
1187
+ table to point `for` at. `for` wins where both are set.
1188
+
1189
+ ```js
1190
+ chart.data = {
1191
+ caption: 'Sessions by channel',
1192
+ columns: ['Month', 'Direct', 'Referral'],
1193
+ rows: [['Jan', 10, 4], ['Feb', 20, 8]],
1194
+ }
1195
+ ```
1196
+
1197
+ The first column holds each row's label and every column after it a
1198
+ series, as in a table. A cell is a number, words, `null` for a blank,
1199
+ or `{ value, text }` for a number shown as words, such as `$128k`. A
1200
+ number is shown in `locale`.
1201
+
1202
+ **A table is still the better source where the page can show one**:
1203
+ it reads with no script and before hydration, and a reader can sort and
1204
+ copy it. Data is drawn on the client only, so a server serves the
1205
+ frame, and the summary, the keys and the readout are then the whole of
1206
+ what a screen reader is given. Set a new object to redraw: the chart
1207
+ does not look inside the one it has. */
1208
+ data?: (HelixHeadlessAreaChart["data"]) | undefined;
1167
1209
 
1168
1210
  /** 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. */
1169
1211
  "onhelix-reading-change"?: ((
@@ -1237,6 +1279,25 @@ them, and the tooltip and the table hold every reading. */
1237
1279
  Absent draws none: bands read as a composition need no numbers beside
1238
1280
  them, and the tooltip and the table hold every reading. */
1239
1281
  "prop:valueAxis"?: (HelixHeadlessAreaChart["valueAxis"]) | undefined;
1282
+ /** The words shown in place of the drawing when the table has no readings,
1283
+ and the fallback of the `empty` slot. */
1284
+ "attr:empty-text"?: (HelixHeadlessAreaChart["emptyText"]) | undefined;
1285
+ /** The words shown in place of the drawing when the table has no readings,
1286
+ and the fallback of the `empty` slot. */
1287
+ "prop:emptyText"?: (HelixHeadlessAreaChart["emptyText"]) | undefined;
1288
+ /** Whether the readings are still on their way. The chart shows
1289
+ `loading-text` in place of an empty drawing until it has readings.
1290
+
1291
+ Reflected, so a stylesheet can treat the chart while it waits. A chart
1292
+ that already has readings keeps drawing them, so a refresh does not
1293
+ blank it. */
1294
+ "prop:loading"?: (HelixHeadlessAreaChart["loading"]) | undefined;
1295
+ /** The words shown in place of the drawing while `loading` is set and
1296
+ there are no readings yet, and the fallback of the `loading` slot. */
1297
+ "attr:loading-text"?: (HelixHeadlessAreaChart["loadingText"]) | undefined;
1298
+ /** The words shown in place of the drawing while `loading` is set and
1299
+ there are no readings yet, and the fallback of the `loading` slot. */
1300
+ "prop:loadingText"?: (HelixHeadlessAreaChart["loadingText"]) | undefined;
1240
1301
  /** The id of the table to read.
1241
1302
 
1242
1303
  Names a table in the same tree, so a chart inside another component's
@@ -1273,6 +1334,29 @@ Set it to the words of the page's language, such as `{position} von
1273
1334
  {count}`, or to nothing to say no position. A slice or a series a
1274
1335
  legend hid is not counted. */
1275
1336
  "prop:positionLabel"?: (HelixHeadlessAreaChart["positionLabel"]) | undefined;
1337
+ /** The readings as data, in the shape of a table, where the page has no
1338
+ table to point `for` at. `for` wins where both are set.
1339
+
1340
+ ```js
1341
+ chart.data = {
1342
+ caption: 'Sessions by channel',
1343
+ columns: ['Month', 'Direct', 'Referral'],
1344
+ rows: [['Jan', 10, 4], ['Feb', 20, 8]],
1345
+ }
1346
+ ```
1347
+
1348
+ The first column holds each row's label and every column after it a
1349
+ series, as in a table. A cell is a number, words, `null` for a blank,
1350
+ or `{ value, text }` for a number shown as words, such as `$128k`. A
1351
+ number is shown in `locale`.
1352
+
1353
+ **A table is still the better source where the page can show one**:
1354
+ it reads with no script and before hydration, and a reader can sort and
1355
+ copy it. Data is drawn on the client only, so a server serves the
1356
+ frame, and the summary, the keys and the readout are then the whole of
1357
+ what a screen reader is given. Set a new object to redraw: the chart
1358
+ does not look inside the one it has. */
1359
+ "prop:data"?: (HelixHeadlessAreaChart["data"]) | undefined;
1276
1360
  /** 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. */
1277
1361
  "on:helix-reading-change"?: ((
1278
1362
  e: HelixHeadlessAreaChartHelixReadingChangeElementEvent,
@@ -1734,6 +1818,25 @@ bottom of bars under `orientation="horizontal"`.
1734
1818
  Absent draws none with one scale, since bars compared with each other need
1735
1819
  no numbers. With `secondary` both scales are drawn whatever this says. */
1736
1820
  valueAxis?: (HelixHeadlessBarChart["valueAxis"]) | undefined;
1821
+ /** The words shown in place of the drawing when the table has no readings,
1822
+ and the fallback of the `empty` slot. */
1823
+ "empty-text"?: (HelixHeadlessBarChart["emptyText"]) | undefined;
1824
+ /** The words shown in place of the drawing when the table has no readings,
1825
+ and the fallback of the `empty` slot. */
1826
+ emptyText?: (HelixHeadlessBarChart["emptyText"]) | undefined;
1827
+ /** Whether the readings are still on their way. The chart shows
1828
+ `loading-text` in place of an empty drawing until it has readings.
1829
+
1830
+ Reflected, so a stylesheet can treat the chart while it waits. A chart
1831
+ that already has readings keeps drawing them, so a refresh does not
1832
+ blank it. */
1833
+ loading?: (HelixHeadlessBarChart["loading"]) | undefined;
1834
+ /** The words shown in place of the drawing while `loading` is set and
1835
+ there are no readings yet, and the fallback of the `loading` slot. */
1836
+ "loading-text"?: (HelixHeadlessBarChart["loadingText"]) | undefined;
1837
+ /** The words shown in place of the drawing while `loading` is set and
1838
+ there are no readings yet, and the fallback of the `loading` slot. */
1839
+ loadingText?: (HelixHeadlessBarChart["loadingText"]) | undefined;
1737
1840
  /** The id of the table to read.
1738
1841
 
1739
1842
  Names a table in the same tree, so a chart inside another component's
@@ -1770,6 +1873,29 @@ Set it to the words of the page's language, such as `{position} von
1770
1873
  {count}`, or to nothing to say no position. A slice or a series a
1771
1874
  legend hid is not counted. */
1772
1875
  positionLabel?: (HelixHeadlessBarChart["positionLabel"]) | undefined;
1876
+ /** The readings as data, in the shape of a table, where the page has no
1877
+ table to point `for` at. `for` wins where both are set.
1878
+
1879
+ ```js
1880
+ chart.data = {
1881
+ caption: 'Sessions by channel',
1882
+ columns: ['Month', 'Direct', 'Referral'],
1883
+ rows: [['Jan', 10, 4], ['Feb', 20, 8]],
1884
+ }
1885
+ ```
1886
+
1887
+ The first column holds each row's label and every column after it a
1888
+ series, as in a table. A cell is a number, words, `null` for a blank,
1889
+ or `{ value, text }` for a number shown as words, such as `$128k`. A
1890
+ number is shown in `locale`.
1891
+
1892
+ **A table is still the better source where the page can show one**:
1893
+ it reads with no script and before hydration, and a reader can sort and
1894
+ copy it. Data is drawn on the client only, so a server serves the
1895
+ frame, and the summary, the keys and the readout are then the whole of
1896
+ what a screen reader is given. Set a new object to redraw: the chart
1897
+ does not look inside the one it has. */
1898
+ data?: (HelixHeadlessBarChart["data"]) | undefined;
1773
1899
 
1774
1900
  /** 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. */
1775
1901
  "onhelix-reading-change"?: ((
@@ -1905,6 +2031,25 @@ bottom of bars under `orientation="horizontal"`.
1905
2031
  Absent draws none with one scale, since bars compared with each other need
1906
2032
  no numbers. With `secondary` both scales are drawn whatever this says. */
1907
2033
  "prop:valueAxis"?: (HelixHeadlessBarChart["valueAxis"]) | undefined;
2034
+ /** The words shown in place of the drawing when the table has no readings,
2035
+ and the fallback of the `empty` slot. */
2036
+ "attr:empty-text"?: (HelixHeadlessBarChart["emptyText"]) | undefined;
2037
+ /** The words shown in place of the drawing when the table has no readings,
2038
+ and the fallback of the `empty` slot. */
2039
+ "prop:emptyText"?: (HelixHeadlessBarChart["emptyText"]) | undefined;
2040
+ /** Whether the readings are still on their way. The chart shows
2041
+ `loading-text` in place of an empty drawing until it has readings.
2042
+
2043
+ Reflected, so a stylesheet can treat the chart while it waits. A chart
2044
+ that already has readings keeps drawing them, so a refresh does not
2045
+ blank it. */
2046
+ "prop:loading"?: (HelixHeadlessBarChart["loading"]) | undefined;
2047
+ /** The words shown in place of the drawing while `loading` is set and
2048
+ there are no readings yet, and the fallback of the `loading` slot. */
2049
+ "attr:loading-text"?: (HelixHeadlessBarChart["loadingText"]) | undefined;
2050
+ /** The words shown in place of the drawing while `loading` is set and
2051
+ there are no readings yet, and the fallback of the `loading` slot. */
2052
+ "prop:loadingText"?: (HelixHeadlessBarChart["loadingText"]) | undefined;
1908
2053
  /** The id of the table to read.
1909
2054
 
1910
2055
  Names a table in the same tree, so a chart inside another component's
@@ -1941,6 +2086,29 @@ Set it to the words of the page's language, such as `{position} von
1941
2086
  {count}`, or to nothing to say no position. A slice or a series a
1942
2087
  legend hid is not counted. */
1943
2088
  "prop:positionLabel"?: (HelixHeadlessBarChart["positionLabel"]) | undefined;
2089
+ /** The readings as data, in the shape of a table, where the page has no
2090
+ table to point `for` at. `for` wins where both are set.
2091
+
2092
+ ```js
2093
+ chart.data = {
2094
+ caption: 'Sessions by channel',
2095
+ columns: ['Month', 'Direct', 'Referral'],
2096
+ rows: [['Jan', 10, 4], ['Feb', 20, 8]],
2097
+ }
2098
+ ```
2099
+
2100
+ The first column holds each row's label and every column after it a
2101
+ series, as in a table. A cell is a number, words, `null` for a blank,
2102
+ or `{ value, text }` for a number shown as words, such as `$128k`. A
2103
+ number is shown in `locale`.
2104
+
2105
+ **A table is still the better source where the page can show one**:
2106
+ it reads with no script and before hydration, and a reader can sort and
2107
+ copy it. Data is drawn on the client only, so a server serves the
2108
+ frame, and the summary, the keys and the readout are then the whole of
2109
+ what a screen reader is given. Set a new object to redraw: the chart
2110
+ does not look inside the one it has. */
2111
+ "prop:data"?: (HelixHeadlessBarChart["data"]) | undefined;
1944
2112
  /** 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. */
1945
2113
  "on:helix-reading-change"?: ((
1946
2114
  e: HelixHeadlessBarChartHelixReadingChangeElementEvent,
@@ -11147,6 +11315,29 @@ Set it to the words of the page's language, such as `{position} von
11147
11315
  {count}`, or to nothing to say no position. A slice or a series a
11148
11316
  legend hid is not counted. */
11149
11317
  positionLabel?: (HelixHeadlessDonutChart["positionLabel"]) | undefined;
11318
+ /** The readings as data, in the shape of a table, where the page has no
11319
+ table to point `for` at. `for` wins where both are set.
11320
+
11321
+ ```js
11322
+ chart.data = {
11323
+ caption: 'Sessions by channel',
11324
+ columns: ['Month', 'Direct', 'Referral'],
11325
+ rows: [['Jan', 10, 4], ['Feb', 20, 8]],
11326
+ }
11327
+ ```
11328
+
11329
+ The first column holds each row's label and every column after it a
11330
+ series, as in a table. A cell is a number, words, `null` for a blank,
11331
+ or `{ value, text }` for a number shown as words, such as `$128k`. A
11332
+ number is shown in `locale`.
11333
+
11334
+ **A table is still the better source where the page can show one**:
11335
+ it reads with no script and before hydration, and a reader can sort and
11336
+ copy it. Data is drawn on the client only, so a server serves the
11337
+ frame, and the summary, the keys and the readout are then the whole of
11338
+ what a screen reader is given. Set a new object to redraw: the chart
11339
+ does not look inside the one it has. */
11340
+ data?: (HelixHeadlessDonutChart["data"]) | undefined;
11150
11341
  };
11151
11342
 
11152
11343
  export type HelixHeadlessDonutChartSolidJsProps = {
@@ -11250,6 +11441,29 @@ Set it to the words of the page's language, such as `{position} von
11250
11441
  {count}`, or to nothing to say no position. A slice or a series a
11251
11442
  legend hid is not counted. */
11252
11443
  "prop:positionLabel"?: (HelixHeadlessDonutChart["positionLabel"]) | undefined;
11444
+ /** The readings as data, in the shape of a table, where the page has no
11445
+ table to point `for` at. `for` wins where both are set.
11446
+
11447
+ ```js
11448
+ chart.data = {
11449
+ caption: 'Sessions by channel',
11450
+ columns: ['Month', 'Direct', 'Referral'],
11451
+ rows: [['Jan', 10, 4], ['Feb', 20, 8]],
11452
+ }
11453
+ ```
11454
+
11455
+ The first column holds each row's label and every column after it a
11456
+ series, as in a table. A cell is a number, words, `null` for a blank,
11457
+ or `{ value, text }` for a number shown as words, such as `$128k`. A
11458
+ number is shown in `locale`.
11459
+
11460
+ **A table is still the better source where the page can show one**:
11461
+ it reads with no script and before hydration, and a reader can sort and
11462
+ copy it. Data is drawn on the client only, so a server serves the
11463
+ frame, and the summary, the keys and the readout are then the whole of
11464
+ what a screen reader is given. Set a new object to redraw: the chart
11465
+ does not look inside the one it has. */
11466
+ "prop:data"?: (HelixHeadlessDonutChart["data"]) | undefined;
11253
11467
 
11254
11468
  /** Set the innerHTML of the element */
11255
11469
  innerHTML?: (string) | undefined;
@@ -13888,6 +14102,29 @@ Set it to the words of the page's language, such as `{position} von
13888
14102
  {count}`, or to nothing to say no position. A slice or a series a
13889
14103
  legend hid is not counted. */
13890
14104
  positionLabel?: (HelixHeadlessHeatmap["positionLabel"]) | undefined;
14105
+ /** The readings as data, in the shape of a table, where the page has no
14106
+ table to point `for` at. `for` wins where both are set.
14107
+
14108
+ ```js
14109
+ chart.data = {
14110
+ caption: 'Sessions by channel',
14111
+ columns: ['Month', 'Direct', 'Referral'],
14112
+ rows: [['Jan', 10, 4], ['Feb', 20, 8]],
14113
+ }
14114
+ ```
14115
+
14116
+ The first column holds each row's label and every column after it a
14117
+ series, as in a table. A cell is a number, words, `null` for a blank,
14118
+ or `{ value, text }` for a number shown as words, such as `$128k`. A
14119
+ number is shown in `locale`.
14120
+
14121
+ **A table is still the better source where the page can show one**:
14122
+ it reads with no script and before hydration, and a reader can sort and
14123
+ copy it. Data is drawn on the client only, so a server serves the
14124
+ frame, and the summary, the keys and the readout are then the whole of
14125
+ what a screen reader is given. Set a new object to redraw: the chart
14126
+ does not look inside the one it has. */
14127
+ data?: (HelixHeadlessHeatmap["data"]) | undefined;
13891
14128
 
13892
14129
  /** Fired once a press or a key has changed which cells are selected. */
13893
14130
  onchange?: ((e: HelixHeadlessHeatmapElementEvent) => void) | undefined;
@@ -14071,6 +14308,29 @@ Set it to the words of the page's language, such as `{position} von
14071
14308
  {count}`, or to nothing to say no position. A slice or a series a
14072
14309
  legend hid is not counted. */
14073
14310
  "prop:positionLabel"?: (HelixHeadlessHeatmap["positionLabel"]) | undefined;
14311
+ /** The readings as data, in the shape of a table, where the page has no
14312
+ table to point `for` at. `for` wins where both are set.
14313
+
14314
+ ```js
14315
+ chart.data = {
14316
+ caption: 'Sessions by channel',
14317
+ columns: ['Month', 'Direct', 'Referral'],
14318
+ rows: [['Jan', 10, 4], ['Feb', 20, 8]],
14319
+ }
14320
+ ```
14321
+
14322
+ The first column holds each row's label and every column after it a
14323
+ series, as in a table. A cell is a number, words, `null` for a blank,
14324
+ or `{ value, text }` for a number shown as words, such as `$128k`. A
14325
+ number is shown in `locale`.
14326
+
14327
+ **A table is still the better source where the page can show one**:
14328
+ it reads with no script and before hydration, and a reader can sort and
14329
+ copy it. Data is drawn on the client only, so a server serves the
14330
+ frame, and the summary, the keys and the readout are then the whole of
14331
+ what a screen reader is given. Set a new object to redraw: the chart
14332
+ does not look inside the one it has. */
14333
+ "prop:data"?: (HelixHeadlessHeatmap["data"]) | undefined;
14074
14334
  /** Fired once a press or a key has changed which cells are selected. */
14075
14335
  "on:change"?: ((e: HelixHeadlessHeatmapElementEvent) => void) | undefined;
14076
14336
  /** Fired before a press or a key changes which cells are selected, with the `value` it would leave. Cancelable. */
@@ -16031,6 +16291,25 @@ Set it where the distance from nothing is the point rather than the shape,
16031
16291
  and accept that a series which never approaches zero becomes a flat rule
16032
16292
  near the top of the box. */
16033
16293
  zero?: (HelixHeadlessLineChart["zero"]) | undefined;
16294
+ /** The words shown in place of the drawing when the table has no readings,
16295
+ and the fallback of the `empty` slot. */
16296
+ "empty-text"?: (HelixHeadlessLineChart["emptyText"]) | undefined;
16297
+ /** The words shown in place of the drawing when the table has no readings,
16298
+ and the fallback of the `empty` slot. */
16299
+ emptyText?: (HelixHeadlessLineChart["emptyText"]) | undefined;
16300
+ /** Whether the readings are still on their way. The chart shows
16301
+ `loading-text` in place of an empty drawing until it has readings.
16302
+
16303
+ Reflected, so a stylesheet can treat the chart while it waits. A chart
16304
+ that already has readings keeps drawing them, so a refresh does not
16305
+ blank it. */
16306
+ loading?: (HelixHeadlessLineChart["loading"]) | undefined;
16307
+ /** The words shown in place of the drawing while `loading` is set and
16308
+ there are no readings yet, and the fallback of the `loading` slot. */
16309
+ "loading-text"?: (HelixHeadlessLineChart["loadingText"]) | undefined;
16310
+ /** The words shown in place of the drawing while `loading` is set and
16311
+ there are no readings yet, and the fallback of the `loading` slot. */
16312
+ loadingText?: (HelixHeadlessLineChart["loadingText"]) | undefined;
16034
16313
  /** The id of the table to read.
16035
16314
 
16036
16315
  Names a table in the same tree, so a chart inside another component's
@@ -16067,6 +16346,29 @@ Set it to the words of the page's language, such as `{position} von
16067
16346
  {count}`, or to nothing to say no position. A slice or a series a
16068
16347
  legend hid is not counted. */
16069
16348
  positionLabel?: (HelixHeadlessLineChart["positionLabel"]) | undefined;
16349
+ /** The readings as data, in the shape of a table, where the page has no
16350
+ table to point `for` at. `for` wins where both are set.
16351
+
16352
+ ```js
16353
+ chart.data = {
16354
+ caption: 'Sessions by channel',
16355
+ columns: ['Month', 'Direct', 'Referral'],
16356
+ rows: [['Jan', 10, 4], ['Feb', 20, 8]],
16357
+ }
16358
+ ```
16359
+
16360
+ The first column holds each row's label and every column after it a
16361
+ series, as in a table. A cell is a number, words, `null` for a blank,
16362
+ or `{ value, text }` for a number shown as words, such as `$128k`. A
16363
+ number is shown in `locale`.
16364
+
16365
+ **A table is still the better source where the page can show one**:
16366
+ it reads with no script and before hydration, and a reader can sort and
16367
+ copy it. Data is drawn on the client only, so a server serves the
16368
+ frame, and the summary, the keys and the readout are then the whole of
16369
+ what a screen reader is given. Set a new object to redraw: the chart
16370
+ does not look inside the one it has. */
16371
+ data?: (HelixHeadlessLineChart["data"]) | undefined;
16070
16372
 
16071
16373
  /** 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. */
16072
16374
  "onhelix-reading-change"?: ((
@@ -16200,6 +16502,25 @@ Set it where the distance from nothing is the point rather than the shape,
16200
16502
  and accept that a series which never approaches zero becomes a flat rule
16201
16503
  near the top of the box. */
16202
16504
  "prop:zero"?: (HelixHeadlessLineChart["zero"]) | undefined;
16505
+ /** The words shown in place of the drawing when the table has no readings,
16506
+ and the fallback of the `empty` slot. */
16507
+ "attr:empty-text"?: (HelixHeadlessLineChart["emptyText"]) | undefined;
16508
+ /** The words shown in place of the drawing when the table has no readings,
16509
+ and the fallback of the `empty` slot. */
16510
+ "prop:emptyText"?: (HelixHeadlessLineChart["emptyText"]) | undefined;
16511
+ /** Whether the readings are still on their way. The chart shows
16512
+ `loading-text` in place of an empty drawing until it has readings.
16513
+
16514
+ Reflected, so a stylesheet can treat the chart while it waits. A chart
16515
+ that already has readings keeps drawing them, so a refresh does not
16516
+ blank it. */
16517
+ "prop:loading"?: (HelixHeadlessLineChart["loading"]) | undefined;
16518
+ /** The words shown in place of the drawing while `loading` is set and
16519
+ there are no readings yet, and the fallback of the `loading` slot. */
16520
+ "attr:loading-text"?: (HelixHeadlessLineChart["loadingText"]) | undefined;
16521
+ /** The words shown in place of the drawing while `loading` is set and
16522
+ there are no readings yet, and the fallback of the `loading` slot. */
16523
+ "prop:loadingText"?: (HelixHeadlessLineChart["loadingText"]) | undefined;
16203
16524
  /** The id of the table to read.
16204
16525
 
16205
16526
  Names a table in the same tree, so a chart inside another component's
@@ -16236,6 +16557,29 @@ Set it to the words of the page's language, such as `{position} von
16236
16557
  {count}`, or to nothing to say no position. A slice or a series a
16237
16558
  legend hid is not counted. */
16238
16559
  "prop:positionLabel"?: (HelixHeadlessLineChart["positionLabel"]) | undefined;
16560
+ /** The readings as data, in the shape of a table, where the page has no
16561
+ table to point `for` at. `for` wins where both are set.
16562
+
16563
+ ```js
16564
+ chart.data = {
16565
+ caption: 'Sessions by channel',
16566
+ columns: ['Month', 'Direct', 'Referral'],
16567
+ rows: [['Jan', 10, 4], ['Feb', 20, 8]],
16568
+ }
16569
+ ```
16570
+
16571
+ The first column holds each row's label and every column after it a
16572
+ series, as in a table. A cell is a number, words, `null` for a blank,
16573
+ or `{ value, text }` for a number shown as words, such as `$128k`. A
16574
+ number is shown in `locale`.
16575
+
16576
+ **A table is still the better source where the page can show one**:
16577
+ it reads with no script and before hydration, and a reader can sort and
16578
+ copy it. Data is drawn on the client only, so a server serves the
16579
+ frame, and the summary, the keys and the readout are then the whole of
16580
+ what a screen reader is given. Set a new object to redraw: the chart
16581
+ does not look inside the one it has. */
16582
+ "prop:data"?: (HelixHeadlessLineChart["data"]) | undefined;
16239
16583
  /** 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. */
16240
16584
  "on:helix-reading-change"?: ((
16241
16585
  e: HelixHeadlessLineChartHelixReadingChangeElementEvent,
@@ -22352,7 +22696,8 @@ decimals. Written as JSON in the attribute.
22352
22696
 
22353
22697
  A `percent` style writes the share of the range, and any other the value
22354
22698
  itself, so the example says "18 GB". Absent is a whole percentage. The
22355
- words are announced as well as shown. `value-text` still wins. */
22699
+ words are announced whether or not `show-value` shows them. `value-text`
22700
+ still wins. */
22356
22701
  "format-options"?: (HelixHeadlessProgress["formatOptions"]) | undefined;
22357
22702
  /** `Intl.NumberFormat` options the reading is written with, as React Aria's
22358
22703
  Meter and ProgressBar take them: a unit, a currency, or a number of
@@ -22364,7 +22709,8 @@ decimals. Written as JSON in the attribute.
22364
22709
 
22365
22710
  A `percent` style writes the share of the range, and any other the value
22366
22711
  itself, so the example says "18 GB". Absent is a whole percentage. The
22367
- words are announced as well as shown. `value-text` still wins. */
22712
+ words are announced whether or not `show-value` shows them. `value-text`
22713
+ still wins. */
22368
22714
  formatOptions?: (HelixHeadlessProgress["formatOptions"]) | undefined;
22369
22715
  /** Whether the length of the task is unknown. The bar then shows activity
22370
22716
  without a value.
@@ -22480,7 +22826,8 @@ decimals. Written as JSON in the attribute.
22480
22826
 
22481
22827
  A `percent` style writes the share of the range, and any other the value
22482
22828
  itself, so the example says "18 GB". Absent is a whole percentage. The
22483
- words are announced as well as shown. `value-text` still wins. */
22829
+ words are announced whether or not `show-value` shows them. `value-text`
22830
+ still wins. */
22484
22831
  "attr:format-options"?: (HelixHeadlessProgress["formatOptions"]) | undefined;
22485
22832
  /** `Intl.NumberFormat` options the reading is written with, as React Aria's
22486
22833
  Meter and ProgressBar take them: a unit, a currency, or a number of
@@ -22492,7 +22839,8 @@ decimals. Written as JSON in the attribute.
22492
22839
 
22493
22840
  A `percent` style writes the share of the range, and any other the value
22494
22841
  itself, so the example says "18 GB". Absent is a whole percentage. The
22495
- words are announced as well as shown. `value-text` still wins. */
22842
+ words are announced whether or not `show-value` shows them. `value-text`
22843
+ still wins. */
22496
22844
  "prop:formatOptions"?: (HelixHeadlessProgress["formatOptions"]) | undefined;
22497
22845
  /** Whether the length of the task is unknown. The bar then shows activity
22498
22846
  without a value.
@@ -23576,6 +23924,25 @@ Absent draws none. A series with fewer than two points, or with every
23576
23924
  point at one measure across, has no line to draw. The summary already
23577
23925
  gives each series' correlation, which says how near the points are to it. */
23578
23926
  trend?: (HelixHeadlessScatterChart["trend"]) | undefined;
23927
+ /** The words shown in place of the drawing when the table has no readings,
23928
+ and the fallback of the `empty` slot. */
23929
+ "empty-text"?: (HelixHeadlessScatterChart["emptyText"]) | undefined;
23930
+ /** The words shown in place of the drawing when the table has no readings,
23931
+ and the fallback of the `empty` slot. */
23932
+ emptyText?: (HelixHeadlessScatterChart["emptyText"]) | undefined;
23933
+ /** Whether the readings are still on their way. The chart shows
23934
+ `loading-text` in place of an empty drawing until it has readings.
23935
+
23936
+ Reflected, so a stylesheet can treat the chart while it waits. A chart
23937
+ that already has readings keeps drawing them, so a refresh does not
23938
+ blank it. */
23939
+ loading?: (HelixHeadlessScatterChart["loading"]) | undefined;
23940
+ /** The words shown in place of the drawing while `loading` is set and
23941
+ there are no readings yet, and the fallback of the `loading` slot. */
23942
+ "loading-text"?: (HelixHeadlessScatterChart["loadingText"]) | undefined;
23943
+ /** The words shown in place of the drawing while `loading` is set and
23944
+ there are no readings yet, and the fallback of the `loading` slot. */
23945
+ loadingText?: (HelixHeadlessScatterChart["loadingText"]) | undefined;
23579
23946
  /** The id of the table to read.
23580
23947
 
23581
23948
  Names a table in the same tree, so a chart inside another component's
@@ -23612,6 +23979,29 @@ Set it to the words of the page's language, such as `{position} von
23612
23979
  {count}`, or to nothing to say no position. A slice or a series a
23613
23980
  legend hid is not counted. */
23614
23981
  positionLabel?: (HelixHeadlessScatterChart["positionLabel"]) | undefined;
23982
+ /** The readings as data, in the shape of a table, where the page has no
23983
+ table to point `for` at. `for` wins where both are set.
23984
+
23985
+ ```js
23986
+ chart.data = {
23987
+ caption: 'Sessions by channel',
23988
+ columns: ['Month', 'Direct', 'Referral'],
23989
+ rows: [['Jan', 10, 4], ['Feb', 20, 8]],
23990
+ }
23991
+ ```
23992
+
23993
+ The first column holds each row's label and every column after it a
23994
+ series, as in a table. A cell is a number, words, `null` for a blank,
23995
+ or `{ value, text }` for a number shown as words, such as `$128k`. A
23996
+ number is shown in `locale`.
23997
+
23998
+ **A table is still the better source where the page can show one**:
23999
+ it reads with no script and before hydration, and a reader can sort and
24000
+ copy it. Data is drawn on the client only, so a server serves the
24001
+ frame, and the summary, the keys and the readout are then the whole of
24002
+ what a screen reader is given. Set a new object to redraw: the chart
24003
+ does not look inside the one it has. */
24004
+ data?: (HelixHeadlessScatterChart["data"]) | undefined;
23615
24005
 
23616
24006
  /** 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. */
23617
24007
  "onhelix-reading-change"?: ((
@@ -23683,6 +24073,25 @@ Absent draws none. A series with fewer than two points, or with every
23683
24073
  point at one measure across, has no line to draw. The summary already
23684
24074
  gives each series' correlation, which says how near the points are to it. */
23685
24075
  "prop:trend"?: (HelixHeadlessScatterChart["trend"]) | undefined;
24076
+ /** The words shown in place of the drawing when the table has no readings,
24077
+ and the fallback of the `empty` slot. */
24078
+ "attr:empty-text"?: (HelixHeadlessScatterChart["emptyText"]) | undefined;
24079
+ /** The words shown in place of the drawing when the table has no readings,
24080
+ and the fallback of the `empty` slot. */
24081
+ "prop:emptyText"?: (HelixHeadlessScatterChart["emptyText"]) | undefined;
24082
+ /** Whether the readings are still on their way. The chart shows
24083
+ `loading-text` in place of an empty drawing until it has readings.
24084
+
24085
+ Reflected, so a stylesheet can treat the chart while it waits. A chart
24086
+ that already has readings keeps drawing them, so a refresh does not
24087
+ blank it. */
24088
+ "prop:loading"?: (HelixHeadlessScatterChart["loading"]) | undefined;
24089
+ /** The words shown in place of the drawing while `loading` is set and
24090
+ there are no readings yet, and the fallback of the `loading` slot. */
24091
+ "attr:loading-text"?: (HelixHeadlessScatterChart["loadingText"]) | undefined;
24092
+ /** The words shown in place of the drawing while `loading` is set and
24093
+ there are no readings yet, and the fallback of the `loading` slot. */
24094
+ "prop:loadingText"?: (HelixHeadlessScatterChart["loadingText"]) | undefined;
23686
24095
  /** The id of the table to read.
23687
24096
 
23688
24097
  Names a table in the same tree, so a chart inside another component's
@@ -23719,6 +24128,29 @@ Set it to the words of the page's language, such as `{position} von
23719
24128
  {count}`, or to nothing to say no position. A slice or a series a
23720
24129
  legend hid is not counted. */
23721
24130
  "prop:positionLabel"?: (HelixHeadlessScatterChart["positionLabel"]) | undefined;
24131
+ /** The readings as data, in the shape of a table, where the page has no
24132
+ table to point `for` at. `for` wins where both are set.
24133
+
24134
+ ```js
24135
+ chart.data = {
24136
+ caption: 'Sessions by channel',
24137
+ columns: ['Month', 'Direct', 'Referral'],
24138
+ rows: [['Jan', 10, 4], ['Feb', 20, 8]],
24139
+ }
24140
+ ```
24141
+
24142
+ The first column holds each row's label and every column after it a
24143
+ series, as in a table. A cell is a number, words, `null` for a blank,
24144
+ or `{ value, text }` for a number shown as words, such as `$128k`. A
24145
+ number is shown in `locale`.
24146
+
24147
+ **A table is still the better source where the page can show one**:
24148
+ it reads with no script and before hydration, and a reader can sort and
24149
+ copy it. Data is drawn on the client only, so a server serves the
24150
+ frame, and the summary, the keys and the readout are then the whole of
24151
+ what a screen reader is given. Set a new object to redraw: the chart
24152
+ does not look inside the one it has. */
24153
+ "prop:data"?: (HelixHeadlessScatterChart["data"]) | undefined;
23722
24154
  /** 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. */
23723
24155
  "on:helix-reading-change"?: ((
23724
24156
  e: HelixHeadlessScatterChartHelixReadingChangeElementEvent,
@@ -33142,6 +33574,16 @@ export type CustomElements = {
33142
33574
  * tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
33143
33575
  * pressed with Enter or Space, for a page that opens what a reading stands for.
33144
33576
  *
33577
+ * **`data` takes the readings as data** where the page has no table to point
33578
+ * `for` at, in a table's shape: the column headings, then one row per reading
33579
+ * with its label first. A table is still the better source where the page can
33580
+ * show one, since it reads before any script runs.
33581
+ *
33582
+ * **A chart with nothing to draw says so.** A table with no readings shows
33583
+ * `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
33584
+ * there until readings arrive. The `empty` and `loading` slots take markup in
33585
+ * their place, such as a link to add the first reading.
33586
+ *
33145
33587
  * ## Attributes & Properties
33146
33588
  *
33147
33589
  * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -33188,6 +33630,16 @@ export type CustomElements = {
33188
33630
  *
33189
33631
  * Absent draws none: bands read as a composition need no numbers beside
33190
33632
  * them, and the tooltip and the table hold every reading.
33633
+ * - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
33634
+ * and the fallback of the `empty` slot.
33635
+ * - `loading`: Whether the readings are still on their way. The chart shows
33636
+ * `loading-text` in place of an empty drawing until it has readings.
33637
+ *
33638
+ * Reflected, so a stylesheet can treat the chart while it waits. A chart
33639
+ * that already has readings keeps drawing them, so a refresh does not
33640
+ * blank it.
33641
+ * - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
33642
+ * there are no readings yet, and the fallback of the `loading` slot.
33191
33643
  * - `for`: The id of the table to read.
33192
33644
  *
33193
33645
  * Names a table in the same tree, so a chart inside another component's
@@ -33218,6 +33670,28 @@ export type CustomElements = {
33218
33670
  * cannot be cast onto across unrelated classes, so it would be invisible to
33219
33671
  * every chart that needs it. Reading where a pointer is resting is a fair
33220
33672
  * thing to ask a chart anyway. (property only) (readonly)
33673
+ * - `data`: The readings as data, in the shape of a table, where the page has no
33674
+ * table to point `for` at. `for` wins where both are set.
33675
+ *
33676
+ * ```js
33677
+ * chart.data = {
33678
+ * caption: 'Sessions by channel',
33679
+ * columns: ['Month', 'Direct', 'Referral'],
33680
+ * rows: [['Jan', 10, 4], ['Feb', 20, 8]],
33681
+ * }
33682
+ * ```
33683
+ *
33684
+ * The first column holds each row's label and every column after it a
33685
+ * series, as in a table. A cell is a number, words, `null` for a blank,
33686
+ * or `{ value, text }` for a number shown as words, such as `$128k`. A
33687
+ * number is shown in `locale`.
33688
+ *
33689
+ * **A table is still the better source where the page can show one**:
33690
+ * it reads with no script and before hydration, and a reader can sort and
33691
+ * copy it. Data is drawn on the client only, so a server serves the
33692
+ * frame, and the summary, the keys and the readout are then the whole of
33693
+ * what a screen reader is given. Set a new object to redraw: the chart
33694
+ * does not look inside the one it has. (property only)
33221
33695
  * - `series`: The table's columns, one series each. Empty when there is no table.
33222
33696
  *
33223
33697
  * Held by the controller between edits, so a render reading this five
@@ -33234,6 +33708,9 @@ export type CustomElements = {
33234
33708
  * names an element, and the chart is a generic around its plot: written
33235
33709
  * on the host, the name reached nobody. The plot takes it, as Heatmap's
33236
33710
  * strip always did. (property only) (readonly)
33711
+ * - `readingsKnown`: Whether the readings have been looked for: false on the server and
33712
+ * while hydrating, where no table is resolved and no data is read. A
33713
+ * chart says it has no readings only once this is true. (property only) (readonly)
33237
33714
  * - `sourceRows`: Every row of the table, with each cell's text and number.
33238
33715
  *
33239
33716
  * This is where a tooltip's content comes from, and it is deliberately not
@@ -33280,6 +33757,13 @@ export type CustomElements = {
33280
33757
  * - `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.
33281
33758
  * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
33282
33759
  *
33760
+ * ## Slots
33761
+ *
33762
+ * Areas where markup can be added to the component.
33763
+ *
33764
+ * - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
33765
+ * - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
33766
+ *
33283
33767
  * ## Methods
33284
33768
  *
33285
33769
  * Methods that can be called to access component functionality.
@@ -33329,12 +33813,14 @@ export type CustomElements = {
33329
33813
  * - `area`: One part's band.
33330
33814
  * - `axis`: The numbers of the scale beside the plot, under `value-axis`.
33331
33815
  * - `baseline`: The rule at zero, which is the floor of the drawing.
33816
+ * - `empty`: The words in place of the drawing when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration.
33332
33817
  * - `gridline`: One rule across the plot, under `gridlines`.
33333
33818
  * - `guide`: A rule down the reading a pointer is resting on.
33334
33819
  * - `label`: One reading's name.
33335
33820
  * - `labels`: The row of reading names.
33336
33821
  * - `line`: The top edge of one part's band.
33337
33822
  * - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
33823
+ * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
33338
33824
  * - `mark`: The invisible point the tooltip is anchored to.
33339
33825
  * - `plot`: The drawing, which takes focus to be read by key.
33340
33826
  * - `summary`: The total and each part's share at the latest reading, written as a sentence for screen readers.
@@ -33720,6 +34206,16 @@ export type CustomElements = {
33720
34206
  * tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
33721
34207
  * pressed with Enter or Space, for a page that opens what a reading stands for.
33722
34208
  *
34209
+ * **`data` takes the readings as data** where the page has no table to point
34210
+ * `for` at, in a table's shape: the column headings, then one row per reading
34211
+ * with its label first. A table is still the better source where the page can
34212
+ * show one, since it reads before any script runs.
34213
+ *
34214
+ * **A chart with nothing to draw says so.** A table with no readings shows
34215
+ * `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
34216
+ * there until readings arrive. The `empty` and `loading` slots take markup in
34217
+ * their place, such as a link to add the first reading.
34218
+ *
33723
34219
  * ## Attributes & Properties
33724
34220
  *
33725
34221
  * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -33825,6 +34321,16 @@ export type CustomElements = {
33825
34321
  *
33826
34322
  * Absent draws none with one scale, since bars compared with each other need
33827
34323
  * no numbers. With `secondary` both scales are drawn whatever this says.
34324
+ * - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
34325
+ * and the fallback of the `empty` slot.
34326
+ * - `loading`: Whether the readings are still on their way. The chart shows
34327
+ * `loading-text` in place of an empty drawing until it has readings.
34328
+ *
34329
+ * Reflected, so a stylesheet can treat the chart while it waits. A chart
34330
+ * that already has readings keeps drawing them, so a refresh does not
34331
+ * blank it.
34332
+ * - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
34333
+ * there are no readings yet, and the fallback of the `loading` slot.
33828
34334
  * - `for`: The id of the table to read.
33829
34335
  *
33830
34336
  * Names a table in the same tree, so a chart inside another component's
@@ -33855,6 +34361,28 @@ export type CustomElements = {
33855
34361
  * cannot be cast onto across unrelated classes, so it would be invisible to
33856
34362
  * every chart that needs it. Reading where a pointer is resting is a fair
33857
34363
  * thing to ask a chart anyway. (property only) (readonly)
34364
+ * - `data`: The readings as data, in the shape of a table, where the page has no
34365
+ * table to point `for` at. `for` wins where both are set.
34366
+ *
34367
+ * ```js
34368
+ * chart.data = {
34369
+ * caption: 'Sessions by channel',
34370
+ * columns: ['Month', 'Direct', 'Referral'],
34371
+ * rows: [['Jan', 10, 4], ['Feb', 20, 8]],
34372
+ * }
34373
+ * ```
34374
+ *
34375
+ * The first column holds each row's label and every column after it a
34376
+ * series, as in a table. A cell is a number, words, `null` for a blank,
34377
+ * or `{ value, text }` for a number shown as words, such as `$128k`. A
34378
+ * number is shown in `locale`.
34379
+ *
34380
+ * **A table is still the better source where the page can show one**:
34381
+ * it reads with no script and before hydration, and a reader can sort and
34382
+ * copy it. Data is drawn on the client only, so a server serves the
34383
+ * frame, and the summary, the keys and the readout are then the whole of
34384
+ * what a screen reader is given. Set a new object to redraw: the chart
34385
+ * does not look inside the one it has. (property only)
33858
34386
  * - `series`: The table's columns, one series each. Empty when there is no table.
33859
34387
  *
33860
34388
  * Held by the controller between edits, so a render reading this five
@@ -33871,6 +34399,9 @@ export type CustomElements = {
33871
34399
  * names an element, and the chart is a generic around its plot: written
33872
34400
  * on the host, the name reached nobody. The plot takes it, as Heatmap's
33873
34401
  * strip always did. (property only) (readonly)
34402
+ * - `readingsKnown`: Whether the readings have been looked for: false on the server and
34403
+ * while hydrating, where no table is resolved and no data is read. A
34404
+ * chart says it has no readings only once this is true. (property only) (readonly)
33874
34405
  * - `sourceRows`: Every row of the table, with each cell's text and number.
33875
34406
  *
33876
34407
  * This is where a tooltip's content comes from, and it is deliberately not
@@ -33917,6 +34448,13 @@ export type CustomElements = {
33917
34448
  * - `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.
33918
34449
  * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
33919
34450
  *
34451
+ * ## Slots
34452
+ *
34453
+ * Areas where markup can be added to the component.
34454
+ *
34455
+ * - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
34456
+ * - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
34457
+ *
33920
34458
  * ## Methods
33921
34459
  *
33922
34460
  * Methods that can be called to access component functionality.
@@ -33971,6 +34509,7 @@ export type CustomElements = {
33971
34509
  * - `bar-wash-end`: The far stop of a bar's gradient, where one is used.
33972
34510
  * - `bar-wash-start`: The stop of a bar's gradient at its base.
33973
34511
  * - `baseline`: The line the columns stand on.
34512
+ * - `empty`: The words in place of the drawing when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration.
33974
34513
  * - `gridline`: One gridline across the plot, drawn when `gridlines` is set.
33975
34514
  * - `group`: One category's columns, together.
33976
34515
  * - `group-active`: The group the tooltip describes. Set together with `group`.
@@ -33978,6 +34517,7 @@ export type CustomElements = {
33978
34517
  * - `labels`: The row of category names.
33979
34518
  * - `line`: A series drawn as a line, named in `lines`.
33980
34519
  * - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
34520
+ * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
33981
34521
  * - `mark`: The invisible point the tooltip is anchored to.
33982
34522
  * - `plot`: The drawing, which takes focus to be read by key.
33983
34523
  * - `summary`: The chart's name and each series' highest reading, written as a sentence for screen readers. Hide it visually.
@@ -40516,6 +41056,28 @@ export type CustomElements = {
40516
41056
  * cannot be cast onto across unrelated classes, so it would be invisible to
40517
41057
  * every chart that needs it. Reading where a pointer is resting is a fair
40518
41058
  * thing to ask a chart anyway. (property only) (readonly)
41059
+ * - `data`: The readings as data, in the shape of a table, where the page has no
41060
+ * table to point `for` at. `for` wins where both are set.
41061
+ *
41062
+ * ```js
41063
+ * chart.data = {
41064
+ * caption: 'Sessions by channel',
41065
+ * columns: ['Month', 'Direct', 'Referral'],
41066
+ * rows: [['Jan', 10, 4], ['Feb', 20, 8]],
41067
+ * }
41068
+ * ```
41069
+ *
41070
+ * The first column holds each row's label and every column after it a
41071
+ * series, as in a table. A cell is a number, words, `null` for a blank,
41072
+ * or `{ value, text }` for a number shown as words, such as `$128k`. A
41073
+ * number is shown in `locale`.
41074
+ *
41075
+ * **A table is still the better source where the page can show one**:
41076
+ * it reads with no script and before hydration, and a reader can sort and
41077
+ * copy it. Data is drawn on the client only, so a server serves the
41078
+ * frame, and the summary, the keys and the readout are then the whole of
41079
+ * what a screen reader is given. Set a new object to redraw: the chart
41080
+ * does not look inside the one it has. (property only)
40519
41081
  * - `series`: The table's columns, one series each. Empty when there is no table.
40520
41082
  *
40521
41083
  * Held by the controller between edits, so a render reading this five
@@ -40532,6 +41094,9 @@ export type CustomElements = {
40532
41094
  * names an element, and the chart is a generic around its plot: written
40533
41095
  * on the host, the name reached nobody. The plot takes it, as Heatmap's
40534
41096
  * strip always did. (property only) (readonly)
41097
+ * - `readingsKnown`: Whether the readings have been looked for: false on the server and
41098
+ * while hydrating, where no table is resolved and no data is read. A
41099
+ * chart says it has no readings only once this is true. (property only) (readonly)
40535
41100
  * - `sourceRows`: Every row of the table, with each cell's text and number.
40536
41101
  *
40537
41102
  * This is where a tooltip's content comes from, and it is deliberately not
@@ -43055,6 +43620,28 @@ export type CustomElements = {
43055
43620
  * cannot be cast onto across unrelated classes, so it would be invisible to
43056
43621
  * every chart that needs it. Reading where a pointer is resting is a fair
43057
43622
  * thing to ask a chart anyway. (property only) (readonly)
43623
+ * - `data`: The readings as data, in the shape of a table, where the page has no
43624
+ * table to point `for` at. `for` wins where both are set.
43625
+ *
43626
+ * ```js
43627
+ * chart.data = {
43628
+ * caption: 'Sessions by channel',
43629
+ * columns: ['Month', 'Direct', 'Referral'],
43630
+ * rows: [['Jan', 10, 4], ['Feb', 20, 8]],
43631
+ * }
43632
+ * ```
43633
+ *
43634
+ * The first column holds each row's label and every column after it a
43635
+ * series, as in a table. A cell is a number, words, `null` for a blank,
43636
+ * or `{ value, text }` for a number shown as words, such as `$128k`. A
43637
+ * number is shown in `locale`.
43638
+ *
43639
+ * **A table is still the better source where the page can show one**:
43640
+ * it reads with no script and before hydration, and a reader can sort and
43641
+ * copy it. Data is drawn on the client only, so a server serves the
43642
+ * frame, and the summary, the keys and the readout are then the whole of
43643
+ * what a screen reader is given. Set a new object to redraw: the chart
43644
+ * does not look inside the one it has. (property only)
43058
43645
  * - `series`: The table's columns, one series each. Empty when there is no table.
43059
43646
  *
43060
43647
  * Held by the controller between edits, so a render reading this five
@@ -43071,6 +43658,9 @@ export type CustomElements = {
43071
43658
  * names an element, and the chart is a generic around its plot: written
43072
43659
  * on the host, the name reached nobody. The plot takes it, as Heatmap's
43073
43660
  * strip always did. (property only) (readonly)
43661
+ * - `readingsKnown`: Whether the readings have been looked for: false on the server and
43662
+ * while hydrating, where no table is resolved and no data is read. A
43663
+ * chart says it has no readings only once this is true. (property only) (readonly)
43074
43664
  * - `sourceRows`: Every row of the table, with each cell's text and number.
43075
43665
  *
43076
43666
  * This is where a tooltip's content comes from, and it is deliberately not
@@ -44709,6 +45299,16 @@ export type CustomElements = {
44709
45299
  * tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
44710
45300
  * pressed with Enter or Space, for a page that opens what a reading stands for.
44711
45301
  *
45302
+ * **`data` takes the readings as data** where the page has no table to point
45303
+ * `for` at, in a table's shape: the column headings, then one row per reading
45304
+ * with its label first. A table is still the better source where the page can
45305
+ * show one, since it reads before any script runs.
45306
+ *
45307
+ * **A chart with nothing to draw says so.** A table with no readings shows
45308
+ * `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
45309
+ * there until readings arrive. The `empty` and `loading` slots take markup in
45310
+ * their place, such as a link to add the first reading.
45311
+ *
44712
45312
  * ## Attributes & Properties
44713
45313
  *
44714
45314
  * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -44819,6 +45419,16 @@ export type CustomElements = {
44819
45419
  * Set it where the distance from nothing is the point rather than the shape,
44820
45420
  * and accept that a series which never approaches zero becomes a flat rule
44821
45421
  * near the top of the box.
45422
+ * - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
45423
+ * and the fallback of the `empty` slot.
45424
+ * - `loading`: Whether the readings are still on their way. The chart shows
45425
+ * `loading-text` in place of an empty drawing until it has readings.
45426
+ *
45427
+ * Reflected, so a stylesheet can treat the chart while it waits. A chart
45428
+ * that already has readings keeps drawing them, so a refresh does not
45429
+ * blank it.
45430
+ * - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
45431
+ * there are no readings yet, and the fallback of the `loading` slot.
44822
45432
  * - `for`: The id of the table to read.
44823
45433
  *
44824
45434
  * Names a table in the same tree, so a chart inside another component's
@@ -44849,6 +45459,28 @@ export type CustomElements = {
44849
45459
  * cannot be cast onto across unrelated classes, so it would be invisible to
44850
45460
  * every chart that needs it. Reading where a pointer is resting is a fair
44851
45461
  * thing to ask a chart anyway. (property only) (readonly)
45462
+ * - `data`: The readings as data, in the shape of a table, where the page has no
45463
+ * table to point `for` at. `for` wins where both are set.
45464
+ *
45465
+ * ```js
45466
+ * chart.data = {
45467
+ * caption: 'Sessions by channel',
45468
+ * columns: ['Month', 'Direct', 'Referral'],
45469
+ * rows: [['Jan', 10, 4], ['Feb', 20, 8]],
45470
+ * }
45471
+ * ```
45472
+ *
45473
+ * The first column holds each row's label and every column after it a
45474
+ * series, as in a table. A cell is a number, words, `null` for a blank,
45475
+ * or `{ value, text }` for a number shown as words, such as `$128k`. A
45476
+ * number is shown in `locale`.
45477
+ *
45478
+ * **A table is still the better source where the page can show one**:
45479
+ * it reads with no script and before hydration, and a reader can sort and
45480
+ * copy it. Data is drawn on the client only, so a server serves the
45481
+ * frame, and the summary, the keys and the readout are then the whole of
45482
+ * what a screen reader is given. Set a new object to redraw: the chart
45483
+ * does not look inside the one it has. (property only)
44852
45484
  * - `series`: The table's columns, one series each. Empty when there is no table.
44853
45485
  *
44854
45486
  * Held by the controller between edits, so a render reading this five
@@ -44865,6 +45497,9 @@ export type CustomElements = {
44865
45497
  * names an element, and the chart is a generic around its plot: written
44866
45498
  * on the host, the name reached nobody. The plot takes it, as Heatmap's
44867
45499
  * strip always did. (property only) (readonly)
45500
+ * - `readingsKnown`: Whether the readings have been looked for: false on the server and
45501
+ * while hydrating, where no table is resolved and no data is read. A
45502
+ * chart says it has no readings only once this is true. (property only) (readonly)
44868
45503
  * - `sourceRows`: Every row of the table, with each cell's text and number.
44869
45504
  *
44870
45505
  * This is where a tooltip's content comes from, and it is deliberately not
@@ -44911,6 +45546,13 @@ export type CustomElements = {
44911
45546
  * - `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.
44912
45547
  * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
44913
45548
  *
45549
+ * ## Slots
45550
+ *
45551
+ * Areas where markup can be added to the component.
45552
+ *
45553
+ * - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
45554
+ * - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
45555
+ *
44914
45556
  * ## Methods
44915
45557
  *
44916
45558
  * Methods that can be called to access component functionality.
@@ -44963,6 +45605,7 @@ export type CustomElements = {
44963
45605
  * - `axis`: The numbers of the scale beside the plot, under `value-axis`.
44964
45606
  * - `band`: The band around the reading under the pointer.
44965
45607
  * - `baseline`: The rule at zero, where zero is inside the range.
45608
+ * - `empty`: The words in place of the drawing when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration.
44966
45609
  * - `gridline`: One rule across the plot, under `gridlines`.
44967
45610
  * - `guide`: A rule down the reading a pointer is resting on.
44968
45611
  * - `label`: One reading's name.
@@ -44970,6 +45613,7 @@ export type CustomElements = {
44970
45613
  * - `line`: The line for one series.
44971
45614
  * - `line-dashed`: A `line` whose series `dashed` names. Set alongside `line`.
44972
45615
  * - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
45616
+ * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
44973
45617
  * - `mark`: The invisible point the tooltip is anchored to.
44974
45618
  * - `marker`: The mark on one reading, under `markers`, and on a reading with a blank on either side. Placed with `inset-inline-start` and `inset-block-start`, and carries its series color as `--chart-series`.
44975
45619
  * - `marker-lone`: A `marker` on a reading with a blank on either side, which no line reaches. Set alongside `marker`.
@@ -45753,6 +46397,11 @@ export type CustomElements = {
45753
46397
  * Draws two concentric circles: a track and a moving arc. The track shows the
45754
46398
  * arc as a proportion of a whole, and costs one element.
45755
46399
  *
46400
+ * **For work whose length is known, use `Progress` with `shape="ring"`.** It
46401
+ * draws the same ring filled to the value, says the value as a progress bar
46402
+ * does, and says when the work is complete. A loader claims no proportion, so
46403
+ * it takes no value.
46404
+ *
45756
46405
  * **The center is a slot, empty by default.** Put your logo there once, where
45757
46406
  * your app wraps the loader. When nothing is slotted, nothing extra is
45758
46407
  * rendered.
@@ -50259,6 +50908,15 @@ export type CustomElements = {
50259
50908
  *
50260
50909
  * The fill is a fraction of the track, written as a custom property.
50261
50910
  *
50911
+ * **The reading is said in the words the bar would show**: a whole percentage
50912
+ * of the range in `locale`, the reading `format-options` writes, or
50913
+ * `value-text`, as `aria-valuetext` beside the number.
50914
+ *
50915
+ * **Words set in the default slot are drawn on the bar**, or in the middle of a
50916
+ * ring, such as `62%` or `3 of 8`, and are what the bar says as its reading
50917
+ * where `value-text` is not set. While there are any, the bar carries
50918
+ * `:state(content)`, so a sheet can make room for them.
50919
+ *
50262
50920
  * **Reaching `max` is said and sent.** When the value arrives at `max` from
50263
50921
  * below, the bar says `complete-label`, "Complete" by default, in a polite
50264
50922
  * `live` region and sends `helix-complete`, so a reader hears that the work is
@@ -50285,7 +50943,8 @@ export type CustomElements = {
50285
50943
  *
50286
50944
  * A `percent` style writes the share of the range, and any other the value
50287
50945
  * itself, so the example says "18 GB". Absent is a whole percentage. The
50288
- * words are announced as well as shown. `value-text` still wins.
50946
+ * words are announced whether or not `show-value` shows them. `value-text`
50947
+ * still wins.
50289
50948
  * - `indeterminate`: Whether the length of the task is unknown. The bar then shows activity
50290
50949
  * without a value.
50291
50950
  *
@@ -50374,6 +51033,7 @@ export type CustomElements = {
50374
51033
  *
50375
51034
  * Areas where markup can be added to the component.
50376
51035
  *
51036
+ * - `(default)`: Words drawn on the bar, or in the middle of a ring, such as the reading. Said as the reading where `value-text` is not set.
50377
51037
  * - `label`: A visible label. Its words name the progress bar in place of `label`.
50378
51038
  *
50379
51039
  * ## CSS Custom Properties
@@ -50386,6 +51046,7 @@ export type CustomElements = {
50386
51046
  *
50387
51047
  * Custom selectors for styling elements within the component.
50388
51048
  *
51049
+ * - `content`: The box holding the words of the default slot, over the track or in the middle of the ring. Carries `--progress-fraction`.
50389
51050
  * - `groove`: The unfilled circle under the ring's filled arc.
50390
51051
  * - `indicator`: The filled part that shows the work done.
50391
51052
  * - `live`: A polite region that says `complete-label` when the work is done, rendered from that moment. Hide it visually.
@@ -50397,6 +51058,7 @@ export type CustomElements = {
50397
51058
  * These can be used to apply styling when a component is in a given state.
50398
51059
  *
50399
51060
  * - `complete`: The value is at `max` and the bar is not indeterminate.
51061
+ * - `content`: Words are set in the default slot.
50400
51062
  * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
50401
51063
  */
50402
51064
  "helix-headless-progress": Partial<
@@ -51330,6 +51992,16 @@ export type CustomElements = {
51330
51992
  * tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
51331
51993
  * pressed with Enter or Space, for a page that opens what a reading stands for.
51332
51994
  *
51995
+ * **`data` takes the readings as data** where the page has no table to point
51996
+ * `for` at, in a table's shape: the column headings, then one row per reading
51997
+ * with its label first. A table is still the better source where the page can
51998
+ * show one, since it reads before any script runs.
51999
+ *
52000
+ * **A chart with nothing to draw says so.** A table with no readings shows
52001
+ * `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
52002
+ * there until readings arrive. The `empty` and `loading` slots take markup in
52003
+ * their place, such as a link to add the first reading.
52004
+ *
51333
52005
  * ## Attributes & Properties
51334
52006
  *
51335
52007
  * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -51365,6 +52037,16 @@ export type CustomElements = {
51365
52037
  * Absent draws none. A series with fewer than two points, or with every
51366
52038
  * point at one measure across, has no line to draw. The summary already
51367
52039
  * gives each series' correlation, which says how near the points are to it.
52040
+ * - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
52041
+ * and the fallback of the `empty` slot.
52042
+ * - `loading`: Whether the readings are still on their way. The chart shows
52043
+ * `loading-text` in place of an empty drawing until it has readings.
52044
+ *
52045
+ * Reflected, so a stylesheet can treat the chart while it waits. A chart
52046
+ * that already has readings keeps drawing them, so a refresh does not
52047
+ * blank it.
52048
+ * - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
52049
+ * there are no readings yet, and the fallback of the `loading` slot.
51368
52050
  * - `for`: The id of the table to read.
51369
52051
  *
51370
52052
  * Names a table in the same tree, so a chart inside another component's
@@ -51395,6 +52077,28 @@ export type CustomElements = {
51395
52077
  * cannot be cast onto across unrelated classes, so it would be invisible to
51396
52078
  * every chart that needs it. Reading where a pointer is resting is a fair
51397
52079
  * thing to ask a chart anyway. (property only) (readonly)
52080
+ * - `data`: The readings as data, in the shape of a table, where the page has no
52081
+ * table to point `for` at. `for` wins where both are set.
52082
+ *
52083
+ * ```js
52084
+ * chart.data = {
52085
+ * caption: 'Sessions by channel',
52086
+ * columns: ['Month', 'Direct', 'Referral'],
52087
+ * rows: [['Jan', 10, 4], ['Feb', 20, 8]],
52088
+ * }
52089
+ * ```
52090
+ *
52091
+ * The first column holds each row's label and every column after it a
52092
+ * series, as in a table. A cell is a number, words, `null` for a blank,
52093
+ * or `{ value, text }` for a number shown as words, such as `$128k`. A
52094
+ * number is shown in `locale`.
52095
+ *
52096
+ * **A table is still the better source where the page can show one**:
52097
+ * it reads with no script and before hydration, and a reader can sort and
52098
+ * copy it. Data is drawn on the client only, so a server serves the
52099
+ * frame, and the summary, the keys and the readout are then the whole of
52100
+ * what a screen reader is given. Set a new object to redraw: the chart
52101
+ * does not look inside the one it has. (property only)
51398
52102
  * - `series`: The table's columns, one series each. Empty when there is no table.
51399
52103
  *
51400
52104
  * Held by the controller between edits, so a render reading this five
@@ -51411,6 +52115,9 @@ export type CustomElements = {
51411
52115
  * names an element, and the chart is a generic around its plot: written
51412
52116
  * on the host, the name reached nobody. The plot takes it, as Heatmap's
51413
52117
  * strip always did. (property only) (readonly)
52118
+ * - `readingsKnown`: Whether the readings have been looked for: false on the server and
52119
+ * while hydrating, where no table is resolved and no data is read. A
52120
+ * chart says it has no readings only once this is true. (property only) (readonly)
51414
52121
  * - `sourceRows`: Every row of the table, with each cell's text and number.
51415
52122
  *
51416
52123
  * This is where a tooltip's content comes from, and it is deliberately not
@@ -51457,6 +52164,13 @@ export type CustomElements = {
51457
52164
  * - `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.
51458
52165
  * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
51459
52166
  *
52167
+ * ## Slots
52168
+ *
52169
+ * Areas where markup can be added to the component.
52170
+ *
52171
+ * - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
52172
+ * - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
52173
+ *
51460
52174
  * ## Methods
51461
52175
  *
51462
52176
  * Methods that can be called to access component functionality.
@@ -51506,8 +52220,10 @@ export type CustomElements = {
51506
52220
  *
51507
52221
  * Custom selectors for styling elements within the component.
51508
52222
  *
52223
+ * - `empty`: The words in place of the drawing when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration.
51509
52224
  * - `gridline`: One line across the plot, drawn when `gridlines` is set.
51510
52225
  * - `live`: The readout: a polite live region that says the row the keys moved to. Hide it visually.
52226
+ * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
51511
52227
  * - `mark`: The invisible point the tooltip is anchored to.
51512
52228
  * - `plane`: The grid that holds the plot, both axes, and their names. It runs left to right on every page.
51513
52229
  * - `plot`: The drawing, which takes focus to be read by key.
@@ -59872,6 +60588,16 @@ export type CustomElementsSolidJs = {
59872
60588
  * tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
59873
60589
  * pressed with Enter or Space, for a page that opens what a reading stands for.
59874
60590
  *
60591
+ * **`data` takes the readings as data** where the page has no table to point
60592
+ * `for` at, in a table's shape: the column headings, then one row per reading
60593
+ * with its label first. A table is still the better source where the page can
60594
+ * show one, since it reads before any script runs.
60595
+ *
60596
+ * **A chart with nothing to draw says so.** A table with no readings shows
60597
+ * `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
60598
+ * there until readings arrive. The `empty` and `loading` slots take markup in
60599
+ * their place, such as a link to add the first reading.
60600
+ *
59875
60601
  * ## Attributes & Properties
59876
60602
  *
59877
60603
  * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -59918,6 +60644,16 @@ export type CustomElementsSolidJs = {
59918
60644
  *
59919
60645
  * Absent draws none: bands read as a composition need no numbers beside
59920
60646
  * them, and the tooltip and the table hold every reading.
60647
+ * - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
60648
+ * and the fallback of the `empty` slot.
60649
+ * - `loading`: Whether the readings are still on their way. The chart shows
60650
+ * `loading-text` in place of an empty drawing until it has readings.
60651
+ *
60652
+ * Reflected, so a stylesheet can treat the chart while it waits. A chart
60653
+ * that already has readings keeps drawing them, so a refresh does not
60654
+ * blank it.
60655
+ * - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
60656
+ * there are no readings yet, and the fallback of the `loading` slot.
59921
60657
  * - `for`: The id of the table to read.
59922
60658
  *
59923
60659
  * Names a table in the same tree, so a chart inside another component's
@@ -59948,6 +60684,28 @@ export type CustomElementsSolidJs = {
59948
60684
  * cannot be cast onto across unrelated classes, so it would be invisible to
59949
60685
  * every chart that needs it. Reading where a pointer is resting is a fair
59950
60686
  * thing to ask a chart anyway. (property only) (readonly)
60687
+ * - `data`: The readings as data, in the shape of a table, where the page has no
60688
+ * table to point `for` at. `for` wins where both are set.
60689
+ *
60690
+ * ```js
60691
+ * chart.data = {
60692
+ * caption: 'Sessions by channel',
60693
+ * columns: ['Month', 'Direct', 'Referral'],
60694
+ * rows: [['Jan', 10, 4], ['Feb', 20, 8]],
60695
+ * }
60696
+ * ```
60697
+ *
60698
+ * The first column holds each row's label and every column after it a
60699
+ * series, as in a table. A cell is a number, words, `null` for a blank,
60700
+ * or `{ value, text }` for a number shown as words, such as `$128k`. A
60701
+ * number is shown in `locale`.
60702
+ *
60703
+ * **A table is still the better source where the page can show one**:
60704
+ * it reads with no script and before hydration, and a reader can sort and
60705
+ * copy it. Data is drawn on the client only, so a server serves the
60706
+ * frame, and the summary, the keys and the readout are then the whole of
60707
+ * what a screen reader is given. Set a new object to redraw: the chart
60708
+ * does not look inside the one it has. (property only)
59951
60709
  * - `series`: The table's columns, one series each. Empty when there is no table.
59952
60710
  *
59953
60711
  * Held by the controller between edits, so a render reading this five
@@ -59964,6 +60722,9 @@ export type CustomElementsSolidJs = {
59964
60722
  * names an element, and the chart is a generic around its plot: written
59965
60723
  * on the host, the name reached nobody. The plot takes it, as Heatmap's
59966
60724
  * strip always did. (property only) (readonly)
60725
+ * - `readingsKnown`: Whether the readings have been looked for: false on the server and
60726
+ * while hydrating, where no table is resolved and no data is read. A
60727
+ * chart says it has no readings only once this is true. (property only) (readonly)
59967
60728
  * - `sourceRows`: Every row of the table, with each cell's text and number.
59968
60729
  *
59969
60730
  * This is where a tooltip's content comes from, and it is deliberately not
@@ -60010,6 +60771,13 @@ export type CustomElementsSolidJs = {
60010
60771
  * - `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.
60011
60772
  * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
60012
60773
  *
60774
+ * ## Slots
60775
+ *
60776
+ * Areas where markup can be added to the component.
60777
+ *
60778
+ * - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
60779
+ * - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
60780
+ *
60013
60781
  * ## Methods
60014
60782
  *
60015
60783
  * Methods that can be called to access component functionality.
@@ -60059,12 +60827,14 @@ export type CustomElementsSolidJs = {
60059
60827
  * - `area`: One part's band.
60060
60828
  * - `axis`: The numbers of the scale beside the plot, under `value-axis`.
60061
60829
  * - `baseline`: The rule at zero, which is the floor of the drawing.
60830
+ * - `empty`: The words in place of the drawing when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration.
60062
60831
  * - `gridline`: One rule across the plot, under `gridlines`.
60063
60832
  * - `guide`: A rule down the reading a pointer is resting on.
60064
60833
  * - `label`: One reading's name.
60065
60834
  * - `labels`: The row of reading names.
60066
60835
  * - `line`: The top edge of one part's band.
60067
60836
  * - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
60837
+ * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
60068
60838
  * - `mark`: The invisible point the tooltip is anchored to.
60069
60839
  * - `plot`: The drawing, which takes focus to be read by key.
60070
60840
  * - `summary`: The total and each part's share at the latest reading, written as a sentence for screen readers.
@@ -60460,6 +61230,16 @@ export type CustomElementsSolidJs = {
60460
61230
  * tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
60461
61231
  * pressed with Enter or Space, for a page that opens what a reading stands for.
60462
61232
  *
61233
+ * **`data` takes the readings as data** where the page has no table to point
61234
+ * `for` at, in a table's shape: the column headings, then one row per reading
61235
+ * with its label first. A table is still the better source where the page can
61236
+ * show one, since it reads before any script runs.
61237
+ *
61238
+ * **A chart with nothing to draw says so.** A table with no readings shows
61239
+ * `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
61240
+ * there until readings arrive. The `empty` and `loading` slots take markup in
61241
+ * their place, such as a link to add the first reading.
61242
+ *
60463
61243
  * ## Attributes & Properties
60464
61244
  *
60465
61245
  * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -60565,6 +61345,16 @@ export type CustomElementsSolidJs = {
60565
61345
  *
60566
61346
  * Absent draws none with one scale, since bars compared with each other need
60567
61347
  * no numbers. With `secondary` both scales are drawn whatever this says.
61348
+ * - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
61349
+ * and the fallback of the `empty` slot.
61350
+ * - `loading`: Whether the readings are still on their way. The chart shows
61351
+ * `loading-text` in place of an empty drawing until it has readings.
61352
+ *
61353
+ * Reflected, so a stylesheet can treat the chart while it waits. A chart
61354
+ * that already has readings keeps drawing them, so a refresh does not
61355
+ * blank it.
61356
+ * - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
61357
+ * there are no readings yet, and the fallback of the `loading` slot.
60568
61358
  * - `for`: The id of the table to read.
60569
61359
  *
60570
61360
  * Names a table in the same tree, so a chart inside another component's
@@ -60595,6 +61385,28 @@ export type CustomElementsSolidJs = {
60595
61385
  * cannot be cast onto across unrelated classes, so it would be invisible to
60596
61386
  * every chart that needs it. Reading where a pointer is resting is a fair
60597
61387
  * thing to ask a chart anyway. (property only) (readonly)
61388
+ * - `data`: The readings as data, in the shape of a table, where the page has no
61389
+ * table to point `for` at. `for` wins where both are set.
61390
+ *
61391
+ * ```js
61392
+ * chart.data = {
61393
+ * caption: 'Sessions by channel',
61394
+ * columns: ['Month', 'Direct', 'Referral'],
61395
+ * rows: [['Jan', 10, 4], ['Feb', 20, 8]],
61396
+ * }
61397
+ * ```
61398
+ *
61399
+ * The first column holds each row's label and every column after it a
61400
+ * series, as in a table. A cell is a number, words, `null` for a blank,
61401
+ * or `{ value, text }` for a number shown as words, such as `$128k`. A
61402
+ * number is shown in `locale`.
61403
+ *
61404
+ * **A table is still the better source where the page can show one**:
61405
+ * it reads with no script and before hydration, and a reader can sort and
61406
+ * copy it. Data is drawn on the client only, so a server serves the
61407
+ * frame, and the summary, the keys and the readout are then the whole of
61408
+ * what a screen reader is given. Set a new object to redraw: the chart
61409
+ * does not look inside the one it has. (property only)
60598
61410
  * - `series`: The table's columns, one series each. Empty when there is no table.
60599
61411
  *
60600
61412
  * Held by the controller between edits, so a render reading this five
@@ -60611,6 +61423,9 @@ export type CustomElementsSolidJs = {
60611
61423
  * names an element, and the chart is a generic around its plot: written
60612
61424
  * on the host, the name reached nobody. The plot takes it, as Heatmap's
60613
61425
  * strip always did. (property only) (readonly)
61426
+ * - `readingsKnown`: Whether the readings have been looked for: false on the server and
61427
+ * while hydrating, where no table is resolved and no data is read. A
61428
+ * chart says it has no readings only once this is true. (property only) (readonly)
60614
61429
  * - `sourceRows`: Every row of the table, with each cell's text and number.
60615
61430
  *
60616
61431
  * This is where a tooltip's content comes from, and it is deliberately not
@@ -60657,6 +61472,13 @@ export type CustomElementsSolidJs = {
60657
61472
  * - `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.
60658
61473
  * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
60659
61474
  *
61475
+ * ## Slots
61476
+ *
61477
+ * Areas where markup can be added to the component.
61478
+ *
61479
+ * - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
61480
+ * - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
61481
+ *
60660
61482
  * ## Methods
60661
61483
  *
60662
61484
  * Methods that can be called to access component functionality.
@@ -60711,6 +61533,7 @@ export type CustomElementsSolidJs = {
60711
61533
  * - `bar-wash-end`: The far stop of a bar's gradient, where one is used.
60712
61534
  * - `bar-wash-start`: The stop of a bar's gradient at its base.
60713
61535
  * - `baseline`: The line the columns stand on.
61536
+ * - `empty`: The words in place of the drawing when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration.
60714
61537
  * - `gridline`: One gridline across the plot, drawn when `gridlines` is set.
60715
61538
  * - `group`: One category's columns, together.
60716
61539
  * - `group-active`: The group the tooltip describes. Set together with `group`.
@@ -60718,6 +61541,7 @@ export type CustomElementsSolidJs = {
60718
61541
  * - `labels`: The row of category names.
60719
61542
  * - `line`: A series drawn as a line, named in `lines`.
60720
61543
  * - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
61544
+ * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
60721
61545
  * - `mark`: The invisible point the tooltip is anchored to.
60722
61546
  * - `plot`: The drawing, which takes focus to be read by key.
60723
61547
  * - `summary`: The chart's name and each series' highest reading, written as a sentence for screen readers. Hide it visually.
@@ -67319,6 +68143,28 @@ export type CustomElementsSolidJs = {
67319
68143
  * cannot be cast onto across unrelated classes, so it would be invisible to
67320
68144
  * every chart that needs it. Reading where a pointer is resting is a fair
67321
68145
  * thing to ask a chart anyway. (property only) (readonly)
68146
+ * - `data`: The readings as data, in the shape of a table, where the page has no
68147
+ * table to point `for` at. `for` wins where both are set.
68148
+ *
68149
+ * ```js
68150
+ * chart.data = {
68151
+ * caption: 'Sessions by channel',
68152
+ * columns: ['Month', 'Direct', 'Referral'],
68153
+ * rows: [['Jan', 10, 4], ['Feb', 20, 8]],
68154
+ * }
68155
+ * ```
68156
+ *
68157
+ * The first column holds each row's label and every column after it a
68158
+ * series, as in a table. A cell is a number, words, `null` for a blank,
68159
+ * or `{ value, text }` for a number shown as words, such as `$128k`. A
68160
+ * number is shown in `locale`.
68161
+ *
68162
+ * **A table is still the better source where the page can show one**:
68163
+ * it reads with no script and before hydration, and a reader can sort and
68164
+ * copy it. Data is drawn on the client only, so a server serves the
68165
+ * frame, and the summary, the keys and the readout are then the whole of
68166
+ * what a screen reader is given. Set a new object to redraw: the chart
68167
+ * does not look inside the one it has. (property only)
67322
68168
  * - `series`: The table's columns, one series each. Empty when there is no table.
67323
68169
  *
67324
68170
  * Held by the controller between edits, so a render reading this five
@@ -67335,6 +68181,9 @@ export type CustomElementsSolidJs = {
67335
68181
  * names an element, and the chart is a generic around its plot: written
67336
68182
  * on the host, the name reached nobody. The plot takes it, as Heatmap's
67337
68183
  * strip always did. (property only) (readonly)
68184
+ * - `readingsKnown`: Whether the readings have been looked for: false on the server and
68185
+ * while hydrating, where no table is resolved and no data is read. A
68186
+ * chart says it has no readings only once this is true. (property only) (readonly)
67338
68187
  * - `sourceRows`: Every row of the table, with each cell's text and number.
67339
68188
  *
67340
68189
  * This is where a tooltip's content comes from, and it is deliberately not
@@ -69881,6 +70730,28 @@ export type CustomElementsSolidJs = {
69881
70730
  * cannot be cast onto across unrelated classes, so it would be invisible to
69882
70731
  * every chart that needs it. Reading where a pointer is resting is a fair
69883
70732
  * thing to ask a chart anyway. (property only) (readonly)
70733
+ * - `data`: The readings as data, in the shape of a table, where the page has no
70734
+ * table to point `for` at. `for` wins where both are set.
70735
+ *
70736
+ * ```js
70737
+ * chart.data = {
70738
+ * caption: 'Sessions by channel',
70739
+ * columns: ['Month', 'Direct', 'Referral'],
70740
+ * rows: [['Jan', 10, 4], ['Feb', 20, 8]],
70741
+ * }
70742
+ * ```
70743
+ *
70744
+ * The first column holds each row's label and every column after it a
70745
+ * series, as in a table. A cell is a number, words, `null` for a blank,
70746
+ * or `{ value, text }` for a number shown as words, such as `$128k`. A
70747
+ * number is shown in `locale`.
70748
+ *
70749
+ * **A table is still the better source where the page can show one**:
70750
+ * it reads with no script and before hydration, and a reader can sort and
70751
+ * copy it. Data is drawn on the client only, so a server serves the
70752
+ * frame, and the summary, the keys and the readout are then the whole of
70753
+ * what a screen reader is given. Set a new object to redraw: the chart
70754
+ * does not look inside the one it has. (property only)
69884
70755
  * - `series`: The table's columns, one series each. Empty when there is no table.
69885
70756
  *
69886
70757
  * Held by the controller between edits, so a render reading this five
@@ -69897,6 +70768,9 @@ export type CustomElementsSolidJs = {
69897
70768
  * names an element, and the chart is a generic around its plot: written
69898
70769
  * on the host, the name reached nobody. The plot takes it, as Heatmap's
69899
70770
  * strip always did. (property only) (readonly)
70771
+ * - `readingsKnown`: Whether the readings have been looked for: false on the server and
70772
+ * while hydrating, where no table is resolved and no data is read. A
70773
+ * chart says it has no readings only once this is true. (property only) (readonly)
69900
70774
  * - `sourceRows`: Every row of the table, with each cell's text and number.
69901
70775
  *
69902
70776
  * This is where a tooltip's content comes from, and it is deliberately not
@@ -71558,6 +72432,16 @@ export type CustomElementsSolidJs = {
71558
72432
  * tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
71559
72433
  * pressed with Enter or Space, for a page that opens what a reading stands for.
71560
72434
  *
72435
+ * **`data` takes the readings as data** where the page has no table to point
72436
+ * `for` at, in a table's shape: the column headings, then one row per reading
72437
+ * with its label first. A table is still the better source where the page can
72438
+ * show one, since it reads before any script runs.
72439
+ *
72440
+ * **A chart with nothing to draw says so.** A table with no readings shows
72441
+ * `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
72442
+ * there until readings arrive. The `empty` and `loading` slots take markup in
72443
+ * their place, such as a link to add the first reading.
72444
+ *
71561
72445
  * ## Attributes & Properties
71562
72446
  *
71563
72447
  * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -71668,6 +72552,16 @@ export type CustomElementsSolidJs = {
71668
72552
  * Set it where the distance from nothing is the point rather than the shape,
71669
72553
  * and accept that a series which never approaches zero becomes a flat rule
71670
72554
  * near the top of the box.
72555
+ * - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
72556
+ * and the fallback of the `empty` slot.
72557
+ * - `loading`: Whether the readings are still on their way. The chart shows
72558
+ * `loading-text` in place of an empty drawing until it has readings.
72559
+ *
72560
+ * Reflected, so a stylesheet can treat the chart while it waits. A chart
72561
+ * that already has readings keeps drawing them, so a refresh does not
72562
+ * blank it.
72563
+ * - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
72564
+ * there are no readings yet, and the fallback of the `loading` slot.
71671
72565
  * - `for`: The id of the table to read.
71672
72566
  *
71673
72567
  * Names a table in the same tree, so a chart inside another component's
@@ -71698,6 +72592,28 @@ export type CustomElementsSolidJs = {
71698
72592
  * cannot be cast onto across unrelated classes, so it would be invisible to
71699
72593
  * every chart that needs it. Reading where a pointer is resting is a fair
71700
72594
  * thing to ask a chart anyway. (property only) (readonly)
72595
+ * - `data`: The readings as data, in the shape of a table, where the page has no
72596
+ * table to point `for` at. `for` wins where both are set.
72597
+ *
72598
+ * ```js
72599
+ * chart.data = {
72600
+ * caption: 'Sessions by channel',
72601
+ * columns: ['Month', 'Direct', 'Referral'],
72602
+ * rows: [['Jan', 10, 4], ['Feb', 20, 8]],
72603
+ * }
72604
+ * ```
72605
+ *
72606
+ * The first column holds each row's label and every column after it a
72607
+ * series, as in a table. A cell is a number, words, `null` for a blank,
72608
+ * or `{ value, text }` for a number shown as words, such as `$128k`. A
72609
+ * number is shown in `locale`.
72610
+ *
72611
+ * **A table is still the better source where the page can show one**:
72612
+ * it reads with no script and before hydration, and a reader can sort and
72613
+ * copy it. Data is drawn on the client only, so a server serves the
72614
+ * frame, and the summary, the keys and the readout are then the whole of
72615
+ * what a screen reader is given. Set a new object to redraw: the chart
72616
+ * does not look inside the one it has. (property only)
71701
72617
  * - `series`: The table's columns, one series each. Empty when there is no table.
71702
72618
  *
71703
72619
  * Held by the controller between edits, so a render reading this five
@@ -71714,6 +72630,9 @@ export type CustomElementsSolidJs = {
71714
72630
  * names an element, and the chart is a generic around its plot: written
71715
72631
  * on the host, the name reached nobody. The plot takes it, as Heatmap's
71716
72632
  * strip always did. (property only) (readonly)
72633
+ * - `readingsKnown`: Whether the readings have been looked for: false on the server and
72634
+ * while hydrating, where no table is resolved and no data is read. A
72635
+ * chart says it has no readings only once this is true. (property only) (readonly)
71717
72636
  * - `sourceRows`: Every row of the table, with each cell's text and number.
71718
72637
  *
71719
72638
  * This is where a tooltip's content comes from, and it is deliberately not
@@ -71760,6 +72679,13 @@ export type CustomElementsSolidJs = {
71760
72679
  * - `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.
71761
72680
  * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
71762
72681
  *
72682
+ * ## Slots
72683
+ *
72684
+ * Areas where markup can be added to the component.
72685
+ *
72686
+ * - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
72687
+ * - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
72688
+ *
71763
72689
  * ## Methods
71764
72690
  *
71765
72691
  * Methods that can be called to access component functionality.
@@ -71812,6 +72738,7 @@ export type CustomElementsSolidJs = {
71812
72738
  * - `axis`: The numbers of the scale beside the plot, under `value-axis`.
71813
72739
  * - `band`: The band around the reading under the pointer.
71814
72740
  * - `baseline`: The rule at zero, where zero is inside the range.
72741
+ * - `empty`: The words in place of the drawing when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration.
71815
72742
  * - `gridline`: One rule across the plot, under `gridlines`.
71816
72743
  * - `guide`: A rule down the reading a pointer is resting on.
71817
72744
  * - `label`: One reading's name.
@@ -71819,6 +72746,7 @@ export type CustomElementsSolidJs = {
71819
72746
  * - `line`: The line for one series.
71820
72747
  * - `line-dashed`: A `line` whose series `dashed` names. Set alongside `line`.
71821
72748
  * - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
72749
+ * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
71822
72750
  * - `mark`: The invisible point the tooltip is anchored to.
71823
72751
  * - `marker`: The mark on one reading, under `markers`, and on a reading with a blank on either side. Placed with `inset-inline-start` and `inset-block-start`, and carries its series color as `--chart-series`.
71824
72752
  * - `marker-lone`: A `marker` on a reading with a blank on either side, which no line reaches. Set alongside `marker`.
@@ -72614,6 +73542,11 @@ export type CustomElementsSolidJs = {
72614
73542
  * Draws two concentric circles: a track and a moving arc. The track shows the
72615
73543
  * arc as a proportion of a whole, and costs one element.
72616
73544
  *
73545
+ * **For work whose length is known, use `Progress` with `shape="ring"`.** It
73546
+ * draws the same ring filled to the value, says the value as a progress bar
73547
+ * does, and says when the work is complete. A loader claims no proportion, so
73548
+ * it takes no value.
73549
+ *
72617
73550
  * **The center is a slot, empty by default.** Put your logo there once, where
72618
73551
  * your app wraps the loader. When nothing is slotted, nothing extra is
72619
73552
  * rendered.
@@ -77182,6 +78115,15 @@ export type CustomElementsSolidJs = {
77182
78115
  *
77183
78116
  * The fill is a fraction of the track, written as a custom property.
77184
78117
  *
78118
+ * **The reading is said in the words the bar would show**: a whole percentage
78119
+ * of the range in `locale`, the reading `format-options` writes, or
78120
+ * `value-text`, as `aria-valuetext` beside the number.
78121
+ *
78122
+ * **Words set in the default slot are drawn on the bar**, or in the middle of a
78123
+ * ring, such as `62%` or `3 of 8`, and are what the bar says as its reading
78124
+ * where `value-text` is not set. While there are any, the bar carries
78125
+ * `:state(content)`, so a sheet can make room for them.
78126
+ *
77185
78127
  * **Reaching `max` is said and sent.** When the value arrives at `max` from
77186
78128
  * below, the bar says `complete-label`, "Complete" by default, in a polite
77187
78129
  * `live` region and sends `helix-complete`, so a reader hears that the work is
@@ -77208,7 +78150,8 @@ export type CustomElementsSolidJs = {
77208
78150
  *
77209
78151
  * A `percent` style writes the share of the range, and any other the value
77210
78152
  * itself, so the example says "18 GB". Absent is a whole percentage. The
77211
- * words are announced as well as shown. `value-text` still wins.
78153
+ * words are announced whether or not `show-value` shows them. `value-text`
78154
+ * still wins.
77212
78155
  * - `indeterminate`: Whether the length of the task is unknown. The bar then shows activity
77213
78156
  * without a value.
77214
78157
  *
@@ -77297,6 +78240,7 @@ export type CustomElementsSolidJs = {
77297
78240
  *
77298
78241
  * Areas where markup can be added to the component.
77299
78242
  *
78243
+ * - `(default)`: Words drawn on the bar, or in the middle of a ring, such as the reading. Said as the reading where `value-text` is not set.
77300
78244
  * - `label`: A visible label. Its words name the progress bar in place of `label`.
77301
78245
  *
77302
78246
  * ## CSS Custom Properties
@@ -77309,6 +78253,7 @@ export type CustomElementsSolidJs = {
77309
78253
  *
77310
78254
  * Custom selectors for styling elements within the component.
77311
78255
  *
78256
+ * - `content`: The box holding the words of the default slot, over the track or in the middle of the ring. Carries `--progress-fraction`.
77312
78257
  * - `groove`: The unfilled circle under the ring's filled arc.
77313
78258
  * - `indicator`: The filled part that shows the work done.
77314
78259
  * - `live`: A polite region that says `complete-label` when the work is done, rendered from that moment. Hide it visually.
@@ -77320,6 +78265,7 @@ export type CustomElementsSolidJs = {
77320
78265
  * These can be used to apply styling when a component is in a given state.
77321
78266
  *
77322
78267
  * - `complete`: The value is at `max` and the bar is not indeterminate.
78268
+ * - `content`: Words are set in the default slot.
77323
78269
  * - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
77324
78270
  */
77325
78271
  "helix-headless-progress": Partial<
@@ -78269,6 +79215,16 @@ export type CustomElementsSolidJs = {
78269
79215
  * tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
78270
79216
  * pressed with Enter or Space, for a page that opens what a reading stands for.
78271
79217
  *
79218
+ * **`data` takes the readings as data** where the page has no table to point
79219
+ * `for` at, in a table's shape: the column headings, then one row per reading
79220
+ * with its label first. A table is still the better source where the page can
79221
+ * show one, since it reads before any script runs.
79222
+ *
79223
+ * **A chart with nothing to draw says so.** A table with no readings shows
79224
+ * `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
79225
+ * there until readings arrive. The `empty` and `loading` slots take markup in
79226
+ * their place, such as a link to add the first reading.
79227
+ *
78272
79228
  * ## Attributes & Properties
78273
79229
  *
78274
79230
  * Component attributes and properties that can be applied to the element or by using JavaScript.
@@ -78304,6 +79260,16 @@ export type CustomElementsSolidJs = {
78304
79260
  * Absent draws none. A series with fewer than two points, or with every
78305
79261
  * point at one measure across, has no line to draw. The summary already
78306
79262
  * gives each series' correlation, which says how near the points are to it.
79263
+ * - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
79264
+ * and the fallback of the `empty` slot.
79265
+ * - `loading`: Whether the readings are still on their way. The chart shows
79266
+ * `loading-text` in place of an empty drawing until it has readings.
79267
+ *
79268
+ * Reflected, so a stylesheet can treat the chart while it waits. A chart
79269
+ * that already has readings keeps drawing them, so a refresh does not
79270
+ * blank it.
79271
+ * - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
79272
+ * there are no readings yet, and the fallback of the `loading` slot.
78307
79273
  * - `for`: The id of the table to read.
78308
79274
  *
78309
79275
  * Names a table in the same tree, so a chart inside another component's
@@ -78334,6 +79300,28 @@ export type CustomElementsSolidJs = {
78334
79300
  * cannot be cast onto across unrelated classes, so it would be invisible to
78335
79301
  * every chart that needs it. Reading where a pointer is resting is a fair
78336
79302
  * thing to ask a chart anyway. (property only) (readonly)
79303
+ * - `data`: The readings as data, in the shape of a table, where the page has no
79304
+ * table to point `for` at. `for` wins where both are set.
79305
+ *
79306
+ * ```js
79307
+ * chart.data = {
79308
+ * caption: 'Sessions by channel',
79309
+ * columns: ['Month', 'Direct', 'Referral'],
79310
+ * rows: [['Jan', 10, 4], ['Feb', 20, 8]],
79311
+ * }
79312
+ * ```
79313
+ *
79314
+ * The first column holds each row's label and every column after it a
79315
+ * series, as in a table. A cell is a number, words, `null` for a blank,
79316
+ * or `{ value, text }` for a number shown as words, such as `$128k`. A
79317
+ * number is shown in `locale`.
79318
+ *
79319
+ * **A table is still the better source where the page can show one**:
79320
+ * it reads with no script and before hydration, and a reader can sort and
79321
+ * copy it. Data is drawn on the client only, so a server serves the
79322
+ * frame, and the summary, the keys and the readout are then the whole of
79323
+ * what a screen reader is given. Set a new object to redraw: the chart
79324
+ * does not look inside the one it has. (property only)
78337
79325
  * - `series`: The table's columns, one series each. Empty when there is no table.
78338
79326
  *
78339
79327
  * Held by the controller between edits, so a render reading this five
@@ -78350,6 +79338,9 @@ export type CustomElementsSolidJs = {
78350
79338
  * names an element, and the chart is a generic around its plot: written
78351
79339
  * on the host, the name reached nobody. The plot takes it, as Heatmap's
78352
79340
  * strip always did. (property only) (readonly)
79341
+ * - `readingsKnown`: Whether the readings have been looked for: false on the server and
79342
+ * while hydrating, where no table is resolved and no data is read. A
79343
+ * chart says it has no readings only once this is true. (property only) (readonly)
78353
79344
  * - `sourceRows`: Every row of the table, with each cell's text and number.
78354
79345
  *
78355
79346
  * This is where a tooltip's content comes from, and it is deliberately not
@@ -78396,6 +79387,13 @@ export type CustomElementsSolidJs = {
78396
79387
  * - `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.
78397
79388
  * - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
78398
79389
  *
79390
+ * ## Slots
79391
+ *
79392
+ * Areas where markup can be added to the component.
79393
+ *
79394
+ * - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
79395
+ * - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
79396
+ *
78399
79397
  * ## Methods
78400
79398
  *
78401
79399
  * Methods that can be called to access component functionality.
@@ -78445,8 +79443,10 @@ export type CustomElementsSolidJs = {
78445
79443
  *
78446
79444
  * Custom selectors for styling elements within the component.
78447
79445
  *
79446
+ * - `empty`: The words in place of the drawing when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration.
78448
79447
  * - `gridline`: One line across the plot, drawn when `gridlines` is set.
78449
79448
  * - `live`: The readout: a polite live region that says the row the keys moved to. Hide it visually.
79449
+ * - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
78450
79450
  * - `mark`: The invisible point the tooltip is anchored to.
78451
79451
  * - `plane`: The grid that holds the plot, both axes, and their names. It runs left to right on every page.
78452
79452
  * - `plot`: The drawing, which takes focus to be read by key.