@fusion.dev/helix 0.172.0 → 0.174.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/custom-elements.json +2140 -93
- package/dist/copy-button/root/copy-button-root.css.js +1 -1
- package/dist/element-events.generated.js +8 -1
- package/dist/graph/root/graph-root.css.js +2 -1
- package/dist/orb/root/orb-root.css.js +1 -1
- package/dist/orb/root/orb-root.d.ts +24 -5
- package/dist/orb/root/orb-root.js +24 -6
- package/dist/sandbox/index.d.ts +1 -0
- package/dist/sandbox/index.js +1 -0
- package/dist/sandbox/preview/sandbox-preview.d.ts +39 -2
- package/dist/sandbox/preview/sandbox-preview.js +37 -5
- package/dist/sandbox/root/sandbox-root.css.js +1 -1
- package/dist/sandbox/root/sandbox-root.d.ts +44 -4
- package/dist/sandbox/root/sandbox-root.js +92 -17
- package/dist/sandbox/source/editing.d.ts +111 -0
- package/dist/sandbox/source/editing.js +185 -0
- package/dist/sandbox/source/sandbox-source.css.js +2 -1
- package/dist/sandbox/source/sandbox-source.d.ts +131 -6
- package/dist/sandbox/source/sandbox-source.js +301 -17
- package/dist/strands/palette.d.ts +1 -1
- package/dist/strands/path.d.ts +17 -6
- package/dist/strands/path.js +149 -43
- package/dist/strands/renderer.d.ts +14 -0
- package/dist/strands/renderer.js +14 -4
- package/dist/strands/root/strands-root.css.js +1 -1
- package/dist/strands/root/strands-root.d.ts +41 -10
- package/dist/strands/root/strands-root.js +32 -5
- package/dist/strands/shader.d.ts +3 -3
- package/dist/strands/shader.js +35 -12
- package/dist/strands/stop/strands-stop.d.ts +5 -5
- package/dist/timeline/root/timeline-root.css.js +1 -1
- package/dist/virtual-list/reorder/index.d.ts +1 -0
- package/dist/virtual-list/reorder/index.js +5 -0
- package/dist/virtual-list/reorder/virtual-list-reorder.css.d.ts +1 -0
- package/dist/virtual-list/reorder/virtual-list-reorder.css.js +12 -0
- package/dist/virtual-list/root/virtual-list-root.d.ts +9 -0
- package/lint.json +1 -1
- package/package.json +6 -6
- package/types/jsx.d.ts +919 -79
- package/types/vue.d.ts +214 -15
- package/types/words.d.ts +27 -0
package/types/jsx.d.ts
CHANGED
|
@@ -3229,6 +3229,9 @@ separate actions. The semantics and the joining are separate questions:
|
|
|
3229
3229
|
`role="group"` and a shared name are what make a set of buttons a set, and
|
|
3230
3230
|
`helix-flex` gives the spacing without the group. */
|
|
3231
3231
|
variant?: (HelixButtonGroup["variant"]) | undefined;
|
|
3232
|
+
/** Disables every button in the group, and says so on the group with
|
|
3233
|
+
`aria-disabled`. Reflected, so a stylesheet can select on it. */
|
|
3234
|
+
disabled?: (HelixButtonGroup["disabled"]) | undefined;
|
|
3232
3235
|
/** Keeps at least one button pressed once one is, as React Aria's
|
|
3233
3236
|
`disallowEmptySelection`: a press that would leave none pressed is
|
|
3234
3237
|
refused. */
|
|
@@ -3278,6 +3281,9 @@ A button's own `value` names it, so a value holds no comma.
|
|
|
3278
3281
|
The attribute is the seed, and a press changes the property, which does
|
|
3279
3282
|
not reflect, as a native control's `value` does not. */
|
|
3280
3283
|
value?: (HelixButtonGroup["value"]) | undefined;
|
|
3284
|
+
/** The pressed values as a list, in a selection mode, and an empty list
|
|
3285
|
+
otherwise. Written, it presses exactly those buttons. */
|
|
3286
|
+
values?: (HelixButtonGroup["values"]) | undefined;
|
|
3281
3287
|
|
|
3282
3288
|
/** Fired after a press changes `value`, in a selection mode. */
|
|
3283
3289
|
onchange?: ((e: HelixButtonGroupElementEvent) => void) | undefined;
|
|
@@ -3302,6 +3308,9 @@ separate actions. The semantics and the joining are separate questions:
|
|
|
3302
3308
|
`role="group"` and a shared name are what make a set of buttons a set, and
|
|
3303
3309
|
`helix-flex` gives the spacing without the group. */
|
|
3304
3310
|
"prop:variant"?: (HelixButtonGroup["variant"]) | undefined;
|
|
3311
|
+
/** Disables every button in the group, and says so on the group with
|
|
3312
|
+
`aria-disabled`. Reflected, so a stylesheet can select on it. */
|
|
3313
|
+
"prop:disabled"?: (HelixButtonGroup["disabled"]) | undefined;
|
|
3305
3314
|
/** Keeps at least one button pressed once one is, as React Aria's
|
|
3306
3315
|
`disallowEmptySelection`: a press that would leave none pressed is
|
|
3307
3316
|
refused. */
|
|
@@ -3351,6 +3360,9 @@ A button's own `value` names it, so a value holds no comma.
|
|
|
3351
3360
|
The attribute is the seed, and a press changes the property, which does
|
|
3352
3361
|
not reflect, as a native control's `value` does not. */
|
|
3353
3362
|
"prop:value"?: (HelixButtonGroup["value"]) | undefined;
|
|
3363
|
+
/** The pressed values as a list, in a selection mode, and an empty list
|
|
3364
|
+
otherwise. Written, it presses exactly those buttons. */
|
|
3365
|
+
"prop:values"?: (HelixButtonGroup["values"]) | undefined;
|
|
3354
3366
|
/** Fired after a press changes `value`, in a selection mode. */
|
|
3355
3367
|
"on:change"?: ((e: HelixButtonGroupElementEvent) => void) | undefined;
|
|
3356
3368
|
/** Fired before a press changes `value`, with the value it would leave in `detail.value`. Cancelable: call `preventDefault()` to keep the buttons as they are. */
|
|
@@ -4594,6 +4606,9 @@ Third", rather than with a comma this component chose. */
|
|
|
4594
4606
|
/** The text read with a card that has connections both ways. `{leadsTo}` is
|
|
4595
4607
|
`leads-to-label` and `{comesFrom}` is `comes-from-label`, each filled in. */
|
|
4596
4608
|
linkedLabel?: (HelixCanvas["linkedLabel"]) | undefined;
|
|
4609
|
+
/** Marks the board as busy while its document arrives: the board is
|
|
4610
|
+
`aria-busy`, and the `loading` slot is shown. */
|
|
4611
|
+
loading?: (HelixCanvas["loading"]) | undefined;
|
|
4597
4612
|
/** What screen readers hear after a key moves a card, with `{name}` for the
|
|
4598
4613
|
card and `{x}` and `{y}` for where it now is, in the document's units.
|
|
4599
4614
|
|
|
@@ -5077,6 +5092,9 @@ Third", rather than with a comma this component chose. */
|
|
|
5077
5092
|
/** The text read with a card that has connections both ways. `{leadsTo}` is
|
|
5078
5093
|
`leads-to-label` and `{comesFrom}` is `comes-from-label`, each filled in. */
|
|
5079
5094
|
"prop:linkedLabel"?: (HelixCanvas["linkedLabel"]) | undefined;
|
|
5095
|
+
/** Marks the board as busy while its document arrives: the board is
|
|
5096
|
+
`aria-busy`, and the `loading` slot is shown. */
|
|
5097
|
+
"prop:loading"?: (HelixCanvas["loading"]) | undefined;
|
|
5080
5098
|
/** What screen readers hear after a key moves a card, with `{name}` for the
|
|
5081
5099
|
card and `{x}` and `{y}` for where it now is, in the document's units.
|
|
5082
5100
|
|
|
@@ -10726,6 +10744,24 @@ Defaulted rather than left empty. An icon-only control must be named, and
|
|
|
10726
10744
|
the name of this one is not a judgment call: every copy button in the
|
|
10727
10745
|
world is called Copy. A consumer with a better word still sets it. */
|
|
10728
10746
|
label?: (HelixCopyButton["label"]) | undefined;
|
|
10747
|
+
/** Draws the name as words beside the icon, and the result in their place
|
|
10748
|
+
after a press. The button stays as wide as the longest of them. */
|
|
10749
|
+
"show-label"?: (HelixCopyButton["showLabel"]) | undefined;
|
|
10750
|
+
/** Draws the name as words beside the icon, and the result in their place
|
|
10751
|
+
after a press. The button stays as wide as the longest of them. */
|
|
10752
|
+
showLabel?: (HelixCopyButton["showLabel"]) | undefined;
|
|
10753
|
+
/** When the tooltip shows: `full` on hover and focus and after a press,
|
|
10754
|
+
`copy` only after a press, to show the result, and `none` never, for a
|
|
10755
|
+
button whose result shows another way, such as under `show-label`.
|
|
10756
|
+
|
|
10757
|
+
Unset is `full`, and the attribute stays absent until you write it. */
|
|
10758
|
+
tooltip?: (HelixCopyButton["tooltip"]) | undefined;
|
|
10759
|
+
/** The side the tooltip prefers. It moves to another side where this one
|
|
10760
|
+
does not fit. */
|
|
10761
|
+
"tooltip-placement"?: (HelixCopyButton["tooltipPlacement"]) | undefined;
|
|
10762
|
+
/** The side the tooltip prefers. It moves to another side where this one
|
|
10763
|
+
does not fit. */
|
|
10764
|
+
tooltipPlacement?: (HelixCopyButton["tooltipPlacement"]) | undefined;
|
|
10729
10765
|
/** The text copied to the clipboard.
|
|
10730
10766
|
|
|
10731
10767
|
It replaces `Button.value`, the submit value: a copy button never submits,
|
|
@@ -10862,6 +10898,24 @@ Defaulted rather than left empty. An icon-only control must be named, and
|
|
|
10862
10898
|
the name of this one is not a judgment call: every copy button in the
|
|
10863
10899
|
world is called Copy. A consumer with a better word still sets it. */
|
|
10864
10900
|
"prop:label"?: (HelixCopyButton["label"]) | undefined;
|
|
10901
|
+
/** Draws the name as words beside the icon, and the result in their place
|
|
10902
|
+
after a press. The button stays as wide as the longest of them. */
|
|
10903
|
+
"bool:show-label"?: (HelixCopyButton["showLabel"]) | undefined;
|
|
10904
|
+
/** Draws the name as words beside the icon, and the result in their place
|
|
10905
|
+
after a press. The button stays as wide as the longest of them. */
|
|
10906
|
+
"prop:showLabel"?: (HelixCopyButton["showLabel"]) | undefined;
|
|
10907
|
+
/** When the tooltip shows: `full` on hover and focus and after a press,
|
|
10908
|
+
`copy` only after a press, to show the result, and `none` never, for a
|
|
10909
|
+
button whose result shows another way, such as under `show-label`.
|
|
10910
|
+
|
|
10911
|
+
Unset is `full`, and the attribute stays absent until you write it. */
|
|
10912
|
+
"prop:tooltip"?: (HelixCopyButton["tooltip"]) | undefined;
|
|
10913
|
+
/** The side the tooltip prefers. It moves to another side where this one
|
|
10914
|
+
does not fit. */
|
|
10915
|
+
"attr:tooltip-placement"?: (HelixCopyButton["tooltipPlacement"]) | undefined;
|
|
10916
|
+
/** The side the tooltip prefers. It moves to another side where this one
|
|
10917
|
+
does not fit. */
|
|
10918
|
+
"prop:tooltipPlacement"?: (HelixCopyButton["tooltipPlacement"]) | undefined;
|
|
10865
10919
|
/** The text copied to the clipboard.
|
|
10866
10920
|
|
|
10867
10921
|
It replaces `Button.value`, the submit value: a copy button never submits,
|
|
@@ -17035,6 +17089,13 @@ or hides its notes. Drawn where the notes have two groups or more. */
|
|
|
17035
17089
|
"links-to-label"?: (HelixGraph["linksToLabel"]) | undefined;
|
|
17036
17090
|
/** How a note that links to the selected one is described, with `{note}`. */
|
|
17037
17091
|
linksToLabel?: (HelixGraph["linksToLabel"]) | undefined;
|
|
17092
|
+
/** Marks the graph as busy while its notes arrive: the list is `aria-busy`,
|
|
17093
|
+
and the panel says so where it holds no notes yet. */
|
|
17094
|
+
loading?: (HelixGraph["loading"]) | undefined;
|
|
17095
|
+
/** What the panel says while `loading` is set and the list holds no notes. */
|
|
17096
|
+
"loading-label"?: (HelixGraph["loadingLabel"]) | undefined;
|
|
17097
|
+
/** What the panel says while `loading` is set and the list holds no notes. */
|
|
17098
|
+
loadingLabel?: (HelixGraph["loadingLabel"]) | undefined;
|
|
17038
17099
|
/** What screen readers hear once the drawing has moved down, after `moved()`. */
|
|
17039
17100
|
"moved-down-label"?: (HelixGraph["movedDownLabel"]) | undefined;
|
|
17040
17101
|
/** What screen readers hear once the drawing has moved down, after `moved()`. */
|
|
@@ -17107,6 +17168,16 @@ own, since the fallback name is the same word. Empty leaves the role. */
|
|
|
17107
17168
|
links?: (HelixGraph["links"]) | undefined;
|
|
17108
17169
|
/** The notes. A property, never an attribute. */
|
|
17109
17170
|
nodes?: (HelixGraph["nodes"]) | undefined;
|
|
17171
|
+
/** What each note's row in the list shows in place of its name: a function
|
|
17172
|
+
given the note that returns text, an element or a Lit template.
|
|
17173
|
+
|
|
17174
|
+
For an icon by its kind, or a date under its name, as React Aria's
|
|
17175
|
+
`ListBoxItem` takes children. The row is still named by the note's name,
|
|
17176
|
+
which typeahead and the search find it by, and described by how it stands
|
|
17177
|
+
to the selected note. Return the name with your content where it should
|
|
17178
|
+
still show. A property only, there being no way to write a function in
|
|
17179
|
+
markup. */
|
|
17180
|
+
noteContent?: (HelixGraph["noteContent"]) | undefined;
|
|
17110
17181
|
|
|
17111
17182
|
/** A note was selected, in the list or in the drawing. The detail's `value` is its `id`. */
|
|
17112
17183
|
"onhelix-activate"?: ((e: HelixGraphHelixActivateElementEvent) => void) | undefined;
|
|
@@ -17337,6 +17408,13 @@ or hides its notes. Drawn where the notes have two groups or more. */
|
|
|
17337
17408
|
"attr:links-to-label"?: (HelixGraph["linksToLabel"]) | undefined;
|
|
17338
17409
|
/** How a note that links to the selected one is described, with `{note}`. */
|
|
17339
17410
|
"prop:linksToLabel"?: (HelixGraph["linksToLabel"]) | undefined;
|
|
17411
|
+
/** Marks the graph as busy while its notes arrive: the list is `aria-busy`,
|
|
17412
|
+
and the panel says so where it holds no notes yet. */
|
|
17413
|
+
"prop:loading"?: (HelixGraph["loading"]) | undefined;
|
|
17414
|
+
/** What the panel says while `loading` is set and the list holds no notes. */
|
|
17415
|
+
"attr:loading-label"?: (HelixGraph["loadingLabel"]) | undefined;
|
|
17416
|
+
/** What the panel says while `loading` is set and the list holds no notes. */
|
|
17417
|
+
"prop:loadingLabel"?: (HelixGraph["loadingLabel"]) | undefined;
|
|
17340
17418
|
/** What screen readers hear once the drawing has moved down, after `moved()`. */
|
|
17341
17419
|
"attr:moved-down-label"?: (HelixGraph["movedDownLabel"]) | undefined;
|
|
17342
17420
|
/** What screen readers hear once the drawing has moved down, after `moved()`. */
|
|
@@ -17409,6 +17487,16 @@ own, since the fallback name is the same word. Empty leaves the role. */
|
|
|
17409
17487
|
"prop:links"?: (HelixGraph["links"]) | undefined;
|
|
17410
17488
|
/** The notes. A property, never an attribute. */
|
|
17411
17489
|
"prop:nodes"?: (HelixGraph["nodes"]) | undefined;
|
|
17490
|
+
/** What each note's row in the list shows in place of its name: a function
|
|
17491
|
+
given the note that returns text, an element or a Lit template.
|
|
17492
|
+
|
|
17493
|
+
For an icon by its kind, or a date under its name, as React Aria's
|
|
17494
|
+
`ListBoxItem` takes children. The row is still named by the note's name,
|
|
17495
|
+
which typeahead and the search find it by, and described by how it stands
|
|
17496
|
+
to the selected note. Return the name with your content where it should
|
|
17497
|
+
still show. A property only, there being no way to write a function in
|
|
17498
|
+
markup. */
|
|
17499
|
+
"prop:noteContent"?: (HelixGraph["noteContent"]) | undefined;
|
|
17412
17500
|
/** A note was selected, in the list or in the drawing. The detail's `value` is its `id`. */
|
|
17413
17501
|
"on:helix-activate"?: ((e: HelixGraphHelixActivateElementEvent) => void) | undefined;
|
|
17414
17502
|
/** A note is about to be selected. Cancelable: cancel it to keep the selection in your own state. */
|
|
@@ -20978,7 +21066,8 @@ itself. */
|
|
|
20978
21066
|
type?: (HelixList["type"]) | undefined;
|
|
20979
21067
|
/** The selected rows' values, separated by commas with no spaces, such as `a,c`, in a list that selects.
|
|
20980
21068
|
|
|
20981
|
-
|
|
21069
|
+
A press or a key writes it in row order, as Data Table does, whatever
|
|
21070
|
+
order the rows were chosen in. Set it to start with rows selected. A row's value is its `value`, or its
|
|
20982
21071
|
words where it has none. */
|
|
20983
21072
|
value?: (HelixList["value"]) | undefined;
|
|
20984
21073
|
|
|
@@ -21139,7 +21228,8 @@ itself. */
|
|
|
21139
21228
|
"prop:type"?: (HelixList["type"]) | undefined;
|
|
21140
21229
|
/** The selected rows' values, separated by commas with no spaces, such as `a,c`, in a list that selects.
|
|
21141
21230
|
|
|
21142
|
-
|
|
21231
|
+
A press or a key writes it in row order, as Data Table does, whatever
|
|
21232
|
+
order the rows were chosen in. Set it to start with rows selected. A row's value is its `value`, or its
|
|
21143
21233
|
words where it has none. */
|
|
21144
21234
|
"prop:value"?: (HelixList["value"]) | undefined;
|
|
21145
21235
|
/** Fired once a press has changed which rows are selected. */
|
|
@@ -26628,6 +26718,10 @@ box the sections scroll in. */
|
|
|
26628
26718
|
/** The navigation's name, read by screen readers. A heading in the `heading`
|
|
26629
26719
|
slot names it in place of this. */
|
|
26630
26720
|
label?: (HelixOutline["label"]) | undefined;
|
|
26721
|
+
/** Which links are marked. `reading` marks the one section being read, the
|
|
26722
|
+
last whose heading has passed the reading line. `visible` marks every
|
|
26723
|
+
section with part of it on screen, and the mark runs across their links. */
|
|
26724
|
+
marks?: (HelixOutline["marks"]) | undefined;
|
|
26631
26725
|
/** How far below the top of the scroll container a heading counts as reached,
|
|
26632
26726
|
in pixels. The scroll container is the window or the panel the sections
|
|
26633
26727
|
scroll in.
|
|
@@ -26670,6 +26764,10 @@ box the sections scroll in. */
|
|
|
26670
26764
|
/** The navigation's name, read by screen readers. A heading in the `heading`
|
|
26671
26765
|
slot names it in place of this. */
|
|
26672
26766
|
"prop:label"?: (HelixOutline["label"]) | undefined;
|
|
26767
|
+
/** Which links are marked. `reading` marks the one section being read, the
|
|
26768
|
+
last whose heading has passed the reading line. `visible` marks every
|
|
26769
|
+
section with part of it on screen, and the mark runs across their links. */
|
|
26770
|
+
"prop:marks"?: (HelixOutline["marks"]) | undefined;
|
|
26673
26771
|
/** How far below the top of the scroll container a heading counts as reached,
|
|
26674
26772
|
in pixels. The scroll container is the window or the panel the sections
|
|
26675
26773
|
scroll in.
|
|
@@ -29355,6 +29453,9 @@ export type HelixSandboxPreviewHelixResizeElementEvent =
|
|
|
29355
29453
|
HelixSandboxPreviewElementEvent<HelixResizeEvent>;
|
|
29356
29454
|
|
|
29357
29455
|
export type HelixSandboxPreviewProps = {
|
|
29456
|
+
/** The address the packages in `dependencies` load from, which the name, an
|
|
29457
|
+
`@` and the version follow. */
|
|
29458
|
+
cdn?: (HelixSandboxPreview["cdn"]) | undefined;
|
|
29358
29459
|
/** The color mode the frame renders in.
|
|
29359
29460
|
|
|
29360
29461
|
**The frame is a document and a document has its own color mode.** Setting
|
|
@@ -29386,6 +29487,11 @@ including every one of the 24 series colors a chart reads. */
|
|
|
29386
29487
|
/** Whether the preview draws a reload button and a button that opens the
|
|
29387
29488
|
example in a new tab, in its corner. */
|
|
29388
29489
|
controls?: (HelixSandboxPreview["controls"]) | undefined;
|
|
29490
|
+
/** The npm packages an example can import by name in the built-in document,
|
|
29491
|
+
each name to a version or a range, as a `package.json` lists them. Each
|
|
29492
|
+
loads from `cdn`. Set it as JSON in the attribute or as an object. Not
|
|
29493
|
+
read where `src` is set. */
|
|
29494
|
+
dependencies?: (HelixSandboxPreview["dependencies"]) | undefined;
|
|
29389
29495
|
/** Writing direction inside the frame.
|
|
29390
29496
|
|
|
29391
29497
|
Not reflected. It is payload for the render message and nothing selects on
|
|
@@ -29412,6 +29518,10 @@ Not reflected, for `direction`'s reason: the placement is applied by the
|
|
|
29412
29518
|
document inside the frame, against its own root, so no rule on this side
|
|
29413
29519
|
could read it. */
|
|
29414
29520
|
layout?: (HelixSandboxPreview["layout"]) | undefined;
|
|
29521
|
+
/** Module files an example imports by a relative path in the built-in
|
|
29522
|
+
document, each path, such as `utils.js`, to its source. Not read where
|
|
29523
|
+
`src` is set. */
|
|
29524
|
+
modules?: (HelixSandboxPreview["modules"]) | undefined;
|
|
29415
29525
|
/** The name of the button that opens the example in a new tab, under
|
|
29416
29526
|
`controls`. */
|
|
29417
29527
|
"open-label"?: (HelixSandboxPreview["openLabel"]) | undefined;
|
|
@@ -29442,6 +29552,9 @@ Empty loads the built-in document, which defines no element. */
|
|
|
29442
29552
|
};
|
|
29443
29553
|
|
|
29444
29554
|
export type HelixSandboxPreviewSolidJsProps = {
|
|
29555
|
+
/** The address the packages in `dependencies` load from, which the name, an
|
|
29556
|
+
`@` and the version follow. */
|
|
29557
|
+
"prop:cdn"?: (HelixSandboxPreview["cdn"]) | undefined;
|
|
29445
29558
|
/** The color mode the frame renders in.
|
|
29446
29559
|
|
|
29447
29560
|
**The frame is a document and a document has its own color mode.** Setting
|
|
@@ -29473,6 +29586,11 @@ including every one of the 24 series colors a chart reads. */
|
|
|
29473
29586
|
/** Whether the preview draws a reload button and a button that opens the
|
|
29474
29587
|
example in a new tab, in its corner. */
|
|
29475
29588
|
"prop:controls"?: (HelixSandboxPreview["controls"]) | undefined;
|
|
29589
|
+
/** The npm packages an example can import by name in the built-in document,
|
|
29590
|
+
each name to a version or a range, as a `package.json` lists them. Each
|
|
29591
|
+
loads from `cdn`. Set it as JSON in the attribute or as an object. Not
|
|
29592
|
+
read where `src` is set. */
|
|
29593
|
+
"prop:dependencies"?: (HelixSandboxPreview["dependencies"]) | undefined;
|
|
29476
29594
|
/** Writing direction inside the frame.
|
|
29477
29595
|
|
|
29478
29596
|
Not reflected. It is payload for the render message and nothing selects on
|
|
@@ -29499,6 +29617,10 @@ Not reflected, for `direction`'s reason: the placement is applied by the
|
|
|
29499
29617
|
document inside the frame, against its own root, so no rule on this side
|
|
29500
29618
|
could read it. */
|
|
29501
29619
|
"prop:layout"?: (HelixSandboxPreview["layout"]) | undefined;
|
|
29620
|
+
/** Module files an example imports by a relative path in the built-in
|
|
29621
|
+
document, each path, such as `utils.js`, to its source. Not read where
|
|
29622
|
+
`src` is set. */
|
|
29623
|
+
"prop:modules"?: (HelixSandboxPreview["modules"]) | undefined;
|
|
29502
29624
|
/** The name of the button that opens the example in a new tab, under
|
|
29503
29625
|
`controls`. */
|
|
29504
29626
|
"attr:open-label"?: (HelixSandboxPreview["openLabel"]) | undefined;
|
|
@@ -29628,6 +29750,12 @@ names below keeps that true whichever way round they sit.
|
|
|
29628
29750
|
`split` follows the lead pane rather than the source, so `split="30"` means
|
|
29629
29751
|
the same thing in both directions: thirty percent to whatever comes first. */
|
|
29630
29752
|
lead?: (HelixSandbox["lead"]) | undefined;
|
|
29753
|
+
/** The description of a file tab whose pane holds an edit, read by screen
|
|
29754
|
+
readers after the file's name. */
|
|
29755
|
+
"modified-label"?: (HelixSandbox["modifiedLabel"]) | undefined;
|
|
29756
|
+
/** The description of a file tab whose pane holds an edit, read by screen
|
|
29757
|
+
readers after the file's name. */
|
|
29758
|
+
modifiedLabel?: (HelixSandbox["modifiedLabel"]) | undefined;
|
|
29631
29759
|
/** Whether the panes sit side by side or stacked.
|
|
29632
29760
|
|
|
29633
29761
|
Not reflected, for `lead`'s reason above: no rule selects on it. The axis
|
|
@@ -29788,6 +29916,12 @@ names below keeps that true whichever way round they sit.
|
|
|
29788
29916
|
`split` follows the lead pane rather than the source, so `split="30"` means
|
|
29789
29917
|
the same thing in both directions: thirty percent to whatever comes first. */
|
|
29790
29918
|
"prop:lead"?: (HelixSandbox["lead"]) | undefined;
|
|
29919
|
+
/** The description of a file tab whose pane holds an edit, read by screen
|
|
29920
|
+
readers after the file's name. */
|
|
29921
|
+
"attr:modified-label"?: (HelixSandbox["modifiedLabel"]) | undefined;
|
|
29922
|
+
/** The description of a file tab whose pane holds an edit, read by screen
|
|
29923
|
+
readers after the file's name. */
|
|
29924
|
+
"prop:modifiedLabel"?: (HelixSandbox["modifiedLabel"]) | undefined;
|
|
29791
29925
|
/** Whether the panes sit side by side or stacked.
|
|
29792
29926
|
|
|
29793
29927
|
Not reflected, for `lead`'s reason above: no rule selects on it. The axis
|
|
@@ -29905,6 +30039,23 @@ export type HelixSandboxSourceHelixEditElementEvent =
|
|
|
29905
30039
|
HelixSandboxSourceElementEvent<HelixEditEvent>;
|
|
29906
30040
|
|
|
29907
30041
|
export type HelixSandboxSourceProps = {
|
|
30042
|
+
/** Whether typing an opening bracket or quote types its closing one too, and
|
|
30043
|
+
a bracket typed with text selected goes around it. */
|
|
30044
|
+
"close-brackets"?: (HelixSandboxSource["closeBrackets"]) | undefined;
|
|
30045
|
+
/** Whether typing an opening bracket or quote types its closing one too, and
|
|
30046
|
+
a bracket typed with text selected goes around it. */
|
|
30047
|
+
closeBrackets?: (HelixSandboxSource["closeBrackets"]) | undefined;
|
|
30048
|
+
/** Whether the pane offers completions for the word before the caret, from
|
|
30049
|
+
the words of the source and of `completions`. */
|
|
30050
|
+
complete?: (HelixSandboxSource["complete"]) | undefined;
|
|
30051
|
+
/** Words the pane offers under `complete` beside the words of the source,
|
|
30052
|
+
such as tag and attribute names. `manifestWords` reads them from a custom
|
|
30053
|
+
elements manifest. Set it as JSON in the attribute or as an array. */
|
|
30054
|
+
completions?: (HelixSandboxSource["completions"]) | undefined;
|
|
30055
|
+
/** The name of the list of completions, read by screen readers. */
|
|
30056
|
+
"completions-label"?: (HelixSandboxSource["completionsLabel"]) | undefined;
|
|
30057
|
+
/** The name of the list of completions, read by screen readers. */
|
|
30058
|
+
completionsLabel?: (HelixSandboxSource["completionsLabel"]) | undefined;
|
|
29908
30059
|
/** The editable region's name, read by screen readers. */
|
|
29909
30060
|
"field-label"?: (HelixSandboxSource["fieldLabel"]) | undefined;
|
|
29910
30061
|
/** The editable region's name, read by screen readers. */
|
|
@@ -29928,6 +30079,12 @@ holds several panes. Empty puts the pane's `name` on the tab. */
|
|
|
29928
30079
|
"line-numbers"?: (HelixSandboxSource["lineNumbers"]) | undefined;
|
|
29929
30080
|
/** Whether each line of the source is numbered, in a gutter beside it. */
|
|
29930
30081
|
lineNumbers?: (HelixSandboxSource["lineNumbers"]) | undefined;
|
|
30082
|
+
/** Whether the bracket beside the caret and its pair are marked while the
|
|
30083
|
+
field has focus. */
|
|
30084
|
+
"match-brackets"?: (HelixSandboxSource["matchBrackets"]) | undefined;
|
|
30085
|
+
/** Whether the bracket beside the caret and its pair are marked while the
|
|
30086
|
+
field has focus. */
|
|
30087
|
+
matchBrackets?: (HelixSandboxSource["matchBrackets"]) | undefined;
|
|
29931
30088
|
/** Which source this pane holds. Every `helix-before-edit` event includes it.
|
|
29932
30089
|
|
|
29933
30090
|
`html` and `css` are what the sandbox root routes on; any other name is
|
|
@@ -29935,6 +30092,14 @@ passed through untouched for a consumer wiring their own panes.
|
|
|
29935
30092
|
|
|
29936
30093
|
Not reflected: nothing selects on it, so it keeps a real default instead. */
|
|
29937
30094
|
name?: (HelixSandboxSource["name"]) | undefined;
|
|
30095
|
+
/** Whether the source is read only: it can be selected and copied, and not
|
|
30096
|
+
edited, as Sandpack's `readOnly` file is. Tab moves focus out of a field
|
|
30097
|
+
that is read only. */
|
|
30098
|
+
readonly?: (HelixSandboxSource["readOnly"]) | undefined;
|
|
30099
|
+
/** Whether the source is read only: it can be selected and copied, and not
|
|
30100
|
+
edited, as Sandpack's `readOnly` file is. Tab moves focus out of a field
|
|
30101
|
+
that is read only. */
|
|
30102
|
+
readOnly?: (HelixSandboxSource["readOnly"]) | undefined;
|
|
29938
30103
|
/** Whether Tab indents the source. When it is off, Tab moves focus. */
|
|
29939
30104
|
"tab-indents"?: (HelixSandboxSource["tabIndents"]) | undefined;
|
|
29940
30105
|
/** Whether Tab indents the source. When it is off, Tab moves focus. */
|
|
@@ -29965,6 +30130,23 @@ returns markup. */
|
|
|
29965
30130
|
};
|
|
29966
30131
|
|
|
29967
30132
|
export type HelixSandboxSourceSolidJsProps = {
|
|
30133
|
+
/** Whether typing an opening bracket or quote types its closing one too, and
|
|
30134
|
+
a bracket typed with text selected goes around it. */
|
|
30135
|
+
"bool:close-brackets"?: (HelixSandboxSource["closeBrackets"]) | undefined;
|
|
30136
|
+
/** Whether typing an opening bracket or quote types its closing one too, and
|
|
30137
|
+
a bracket typed with text selected goes around it. */
|
|
30138
|
+
"prop:closeBrackets"?: (HelixSandboxSource["closeBrackets"]) | undefined;
|
|
30139
|
+
/** Whether the pane offers completions for the word before the caret, from
|
|
30140
|
+
the words of the source and of `completions`. */
|
|
30141
|
+
"prop:complete"?: (HelixSandboxSource["complete"]) | undefined;
|
|
30142
|
+
/** Words the pane offers under `complete` beside the words of the source,
|
|
30143
|
+
such as tag and attribute names. `manifestWords` reads them from a custom
|
|
30144
|
+
elements manifest. Set it as JSON in the attribute or as an array. */
|
|
30145
|
+
"prop:completions"?: (HelixSandboxSource["completions"]) | undefined;
|
|
30146
|
+
/** The name of the list of completions, read by screen readers. */
|
|
30147
|
+
"attr:completions-label"?: (HelixSandboxSource["completionsLabel"]) | undefined;
|
|
30148
|
+
/** The name of the list of completions, read by screen readers. */
|
|
30149
|
+
"prop:completionsLabel"?: (HelixSandboxSource["completionsLabel"]) | undefined;
|
|
29968
30150
|
/** The editable region's name, read by screen readers. */
|
|
29969
30151
|
"attr:field-label"?: (HelixSandboxSource["fieldLabel"]) | undefined;
|
|
29970
30152
|
/** The editable region's name, read by screen readers. */
|
|
@@ -29988,6 +30170,12 @@ holds several panes. Empty puts the pane's `name` on the tab. */
|
|
|
29988
30170
|
"bool:line-numbers"?: (HelixSandboxSource["lineNumbers"]) | undefined;
|
|
29989
30171
|
/** Whether each line of the source is numbered, in a gutter beside it. */
|
|
29990
30172
|
"prop:lineNumbers"?: (HelixSandboxSource["lineNumbers"]) | undefined;
|
|
30173
|
+
/** Whether the bracket beside the caret and its pair are marked while the
|
|
30174
|
+
field has focus. */
|
|
30175
|
+
"bool:match-brackets"?: (HelixSandboxSource["matchBrackets"]) | undefined;
|
|
30176
|
+
/** Whether the bracket beside the caret and its pair are marked while the
|
|
30177
|
+
field has focus. */
|
|
30178
|
+
"prop:matchBrackets"?: (HelixSandboxSource["matchBrackets"]) | undefined;
|
|
29991
30179
|
/** Which source this pane holds. Every `helix-before-edit` event includes it.
|
|
29992
30180
|
|
|
29993
30181
|
`html` and `css` are what the sandbox root routes on; any other name is
|
|
@@ -29995,6 +30183,14 @@ passed through untouched for a consumer wiring their own panes.
|
|
|
29995
30183
|
|
|
29996
30184
|
Not reflected: nothing selects on it, so it keeps a real default instead. */
|
|
29997
30185
|
"prop:name"?: (HelixSandboxSource["name"]) | undefined;
|
|
30186
|
+
/** Whether the source is read only: it can be selected and copied, and not
|
|
30187
|
+
edited, as Sandpack's `readOnly` file is. Tab moves focus out of a field
|
|
30188
|
+
that is read only. */
|
|
30189
|
+
"bool:readonly"?: (HelixSandboxSource["readOnly"]) | undefined;
|
|
30190
|
+
/** Whether the source is read only: it can be selected and copied, and not
|
|
30191
|
+
edited, as Sandpack's `readOnly` file is. Tab moves focus out of a field
|
|
30192
|
+
that is read only. */
|
|
30193
|
+
"prop:readOnly"?: (HelixSandboxSource["readOnly"]) | undefined;
|
|
29998
30194
|
/** Whether Tab indents the source. When it is off, Tab moves focus. */
|
|
29999
30195
|
"bool:tab-indents"?: (HelixSandboxSource["tabIndents"]) | undefined;
|
|
30000
30196
|
/** Whether Tab indents the source. When it is off, Tab moves focus. */
|
|
@@ -32497,6 +32693,13 @@ that should survive its own collapse says how much of itself to keep, and
|
|
|
32497
32693
|
only whoever put it there knows that, which is the same reason `min` is a
|
|
32498
32694
|
consumer's to set. */
|
|
32499
32695
|
collapsedSize?: (HelixSplitter["collapsedSize"]) | undefined;
|
|
32696
|
+
/** Which panes can be collapsed, as Zag's panels each take `collapsible`:
|
|
32697
|
+
`start`, `end`, `both`, or `none`. A pane that cannot be collapsed stops
|
|
32698
|
+
at the edge without shutting. `Enter` collapses the end pane where only
|
|
32699
|
+
the end pane can be collapsed, and the start pane otherwise.
|
|
32700
|
+
|
|
32701
|
+
Unset is `both`, and the attribute stays absent until you write it. */
|
|
32702
|
+
collapsible?: (HelixSplitter["collapsible"]) | undefined;
|
|
32500
32703
|
/** The name of the handle where two dividers cross, read by screen readers. */
|
|
32501
32704
|
"corner-label"?: (HelixSplitter["cornerLabel"]) | undefined;
|
|
32502
32705
|
/** The name of the handle where two dividers cross, read by screen readers. */
|
|
@@ -32525,6 +32728,18 @@ these words are the whole of where it is. */
|
|
|
32525
32728
|
"default-position"?: (HelixSplitter["defaultPosition"] | `${number}`) | undefined;
|
|
32526
32729
|
/** Where the divider starts, when `position` is not set. */
|
|
32527
32730
|
defaultPosition?: (HelixSplitter["defaultPosition"]) | undefined;
|
|
32731
|
+
/** The least the end pane keeps, in the units `min` takes: a percentage, or
|
|
32732
|
+
a CSS length such as `16rem` resolved against the splitter's box. The
|
|
32733
|
+
divider stops that far from the end, whatever `max` allows, so `min` and
|
|
32734
|
+
`end-min` hold a minimum for each pane, as Zag's panels each take
|
|
32735
|
+
`minSize`. */
|
|
32736
|
+
"end-min"?: (HelixSplitter["endMin"]) | undefined;
|
|
32737
|
+
/** The least the end pane keeps, in the units `min` takes: a percentage, or
|
|
32738
|
+
a CSS length such as `16rem` resolved against the splitter's box. The
|
|
32739
|
+
divider stops that far from the end, whatever `max` allows, so `min` and
|
|
32740
|
+
`end-min` hold a minimum for each pane, as Zag's panels each take
|
|
32741
|
+
`minSize`. */
|
|
32742
|
+
endMin?: (HelixSplitter["endMin"]) | undefined;
|
|
32528
32743
|
/** The divider's name, read by screen readers.
|
|
32529
32744
|
|
|
32530
32745
|
An `aria-label` or `aria-labelledby` on the host names the divider too,
|
|
@@ -32669,6 +32884,13 @@ that should survive its own collapse says how much of itself to keep, and
|
|
|
32669
32884
|
only whoever put it there knows that, which is the same reason `min` is a
|
|
32670
32885
|
consumer's to set. */
|
|
32671
32886
|
"prop:collapsedSize"?: (HelixSplitter["collapsedSize"]) | undefined;
|
|
32887
|
+
/** Which panes can be collapsed, as Zag's panels each take `collapsible`:
|
|
32888
|
+
`start`, `end`, `both`, or `none`. A pane that cannot be collapsed stops
|
|
32889
|
+
at the edge without shutting. `Enter` collapses the end pane where only
|
|
32890
|
+
the end pane can be collapsed, and the start pane otherwise.
|
|
32891
|
+
|
|
32892
|
+
Unset is `both`, and the attribute stays absent until you write it. */
|
|
32893
|
+
"prop:collapsible"?: (HelixSplitter["collapsible"]) | undefined;
|
|
32672
32894
|
/** The name of the handle where two dividers cross, read by screen readers. */
|
|
32673
32895
|
"attr:corner-label"?: (HelixSplitter["cornerLabel"]) | undefined;
|
|
32674
32896
|
/** The name of the handle where two dividers cross, read by screen readers. */
|
|
@@ -32697,6 +32919,18 @@ these words are the whole of where it is. */
|
|
|
32697
32919
|
"attr:default-position"?: (HelixSplitter["defaultPosition"] | `${number}`) | undefined;
|
|
32698
32920
|
/** Where the divider starts, when `position` is not set. */
|
|
32699
32921
|
"prop:defaultPosition"?: (HelixSplitter["defaultPosition"]) | undefined;
|
|
32922
|
+
/** The least the end pane keeps, in the units `min` takes: a percentage, or
|
|
32923
|
+
a CSS length such as `16rem` resolved against the splitter's box. The
|
|
32924
|
+
divider stops that far from the end, whatever `max` allows, so `min` and
|
|
32925
|
+
`end-min` hold a minimum for each pane, as Zag's panels each take
|
|
32926
|
+
`minSize`. */
|
|
32927
|
+
"attr:end-min"?: (HelixSplitter["endMin"]) | undefined;
|
|
32928
|
+
/** The least the end pane keeps, in the units `min` takes: a percentage, or
|
|
32929
|
+
a CSS length such as `16rem` resolved against the splitter's box. The
|
|
32930
|
+
divider stops that far from the end, whatever `max` allows, so `min` and
|
|
32931
|
+
`end-min` hold a minimum for each pane, as Zag's panels each take
|
|
32932
|
+
`minSize`. */
|
|
32933
|
+
"prop:endMin"?: (HelixSplitter["endMin"]) | undefined;
|
|
32700
32934
|
/** The divider's name, read by screen readers.
|
|
32701
32935
|
|
|
32702
32936
|
An `aria-label` or `aria-labelledby` on the host names the divider too,
|
|
@@ -33209,23 +33443,43 @@ export type HelixStrandsHelixStrandsFallbackElementEvent =
|
|
|
33209
33443
|
HelixStrandsElementEvent<HelixStrandsFallbackEvent>;
|
|
33210
33444
|
|
|
33211
33445
|
export type HelixStrandsProps = {
|
|
33212
|
-
/** Where the form sits across the box, as a share of the width: the
|
|
33213
|
-
|
|
33214
|
-
crosses the whole width and does not read it. Unset, a
|
|
33446
|
+
/** Where the form sits across the box, as a share of the width: the bend's
|
|
33447
|
+
apex or the ribbon's axis. `0` is the left edge and `1` the right. A wave
|
|
33448
|
+
crosses the whole width and does not read it. Unset, a bend's apex sits at `0.5`
|
|
33215
33449
|
and a ribbon runs down the middle.
|
|
33216
33450
|
|
|
33217
33451
|
**A share rather than a length**, so the ribbon keeps its place when the
|
|
33218
33452
|
box changes shape. Read inside a box only; in `travel` each stop has its
|
|
33219
33453
|
own. */
|
|
33220
33454
|
at?: (HelixStrands["at"]) | undefined;
|
|
33455
|
+
/** How much the glow around the strands adds, as a multiplier. `0` draws the
|
|
33456
|
+
strands alone, crisp and dimmer, and `1` is the default glow. */
|
|
33457
|
+
bloom?: (HelixStrands["bloom"]) | undefined;
|
|
33458
|
+
/** How far apart the brightest and dimmest strands are, from `0`, most of
|
|
33459
|
+
them alike, to `1`, a few burning bright over many faint ones. Clamped to
|
|
33460
|
+
that range. The ribbon as a whole keeps its strength. */
|
|
33461
|
+
contrast?: (HelixStrands["contrast"]) | undefined;
|
|
33221
33462
|
/** How many strands the ribbon has, from `0`, sixty, to `1`, three hundred and
|
|
33222
33463
|
forty. Clamped to that range. */
|
|
33223
33464
|
density?: (HelixStrands["density"]) | undefined;
|
|
33465
|
+
/** How much the ribbon's depth shows, from `0`, flat, to `1`. Clamped to that
|
|
33466
|
+
range. The strands at the front of the ribbon's roll are drawn thicker,
|
|
33467
|
+
brighter, and further from its axis, and those at the back thinner, dimmer,
|
|
33468
|
+
and out of focus. */
|
|
33469
|
+
depth?: (HelixStrands["depth"]) | undefined;
|
|
33470
|
+
/** How differently each strand moves, from `0`, the whole ribbon rolling and
|
|
33471
|
+
waving as one, to `1`, each strand at its own pace and angle, crossing
|
|
33472
|
+
over the others. Clamped to that range. */
|
|
33473
|
+
drift?: (HelixStrands["drift"]) | undefined;
|
|
33474
|
+
/** How many specks of dust drift around the strands, as a multiplier: `0`
|
|
33475
|
+
draws none, `1` six hundred, and `4`, the most, two thousand four
|
|
33476
|
+
hundred. They gather where the ribbon is brightest. */
|
|
33477
|
+
dust?: (HelixStrands["dust"]) | undefined;
|
|
33224
33478
|
/** Overall brightness, as a multiplier on the light. */
|
|
33225
33479
|
gain?: (HelixStrands["gain"]) | undefined;
|
|
33226
33480
|
/** The share of strands drawn out of focus where the ribbon is wide, from `0`,
|
|
33227
33481
|
every strand sharp, to `1`, every one soft. Clamped to that range. A tight
|
|
33228
|
-
form, such as a
|
|
33482
|
+
form, such as a bend's apex or a wave, stays sharp whatever this says. */
|
|
33229
33483
|
softness?: (HelixStrands["softness"]) | undefined;
|
|
33230
33484
|
/** How fast the ribbon moves, as a multiplier on time. `0` holds it still. */
|
|
33231
33485
|
speed?: (HelixStrands["speed"]) | undefined;
|
|
@@ -33248,23 +33502,43 @@ itself to the viewport, behind the page. */
|
|
|
33248
33502
|
};
|
|
33249
33503
|
|
|
33250
33504
|
export type HelixStrandsSolidJsProps = {
|
|
33251
|
-
/** Where the form sits across the box, as a share of the width: the
|
|
33252
|
-
|
|
33253
|
-
crosses the whole width and does not read it. Unset, a
|
|
33505
|
+
/** Where the form sits across the box, as a share of the width: the bend's
|
|
33506
|
+
apex or the ribbon's axis. `0` is the left edge and `1` the right. A wave
|
|
33507
|
+
crosses the whole width and does not read it. Unset, a bend's apex sits at `0.5`
|
|
33254
33508
|
and a ribbon runs down the middle.
|
|
33255
33509
|
|
|
33256
33510
|
**A share rather than a length**, so the ribbon keeps its place when the
|
|
33257
33511
|
box changes shape. Read inside a box only; in `travel` each stop has its
|
|
33258
33512
|
own. */
|
|
33259
33513
|
"prop:at"?: (HelixStrands["at"]) | undefined;
|
|
33514
|
+
/** How much the glow around the strands adds, as a multiplier. `0` draws the
|
|
33515
|
+
strands alone, crisp and dimmer, and `1` is the default glow. */
|
|
33516
|
+
"prop:bloom"?: (HelixStrands["bloom"]) | undefined;
|
|
33517
|
+
/** How far apart the brightest and dimmest strands are, from `0`, most of
|
|
33518
|
+
them alike, to `1`, a few burning bright over many faint ones. Clamped to
|
|
33519
|
+
that range. The ribbon as a whole keeps its strength. */
|
|
33520
|
+
"prop:contrast"?: (HelixStrands["contrast"]) | undefined;
|
|
33260
33521
|
/** How many strands the ribbon has, from `0`, sixty, to `1`, three hundred and
|
|
33261
33522
|
forty. Clamped to that range. */
|
|
33262
33523
|
"prop:density"?: (HelixStrands["density"]) | undefined;
|
|
33524
|
+
/** How much the ribbon's depth shows, from `0`, flat, to `1`. Clamped to that
|
|
33525
|
+
range. The strands at the front of the ribbon's roll are drawn thicker,
|
|
33526
|
+
brighter, and further from its axis, and those at the back thinner, dimmer,
|
|
33527
|
+
and out of focus. */
|
|
33528
|
+
"prop:depth"?: (HelixStrands["depth"]) | undefined;
|
|
33529
|
+
/** How differently each strand moves, from `0`, the whole ribbon rolling and
|
|
33530
|
+
waving as one, to `1`, each strand at its own pace and angle, crossing
|
|
33531
|
+
over the others. Clamped to that range. */
|
|
33532
|
+
"prop:drift"?: (HelixStrands["drift"]) | undefined;
|
|
33533
|
+
/** How many specks of dust drift around the strands, as a multiplier: `0`
|
|
33534
|
+
draws none, `1` six hundred, and `4`, the most, two thousand four
|
|
33535
|
+
hundred. They gather where the ribbon is brightest. */
|
|
33536
|
+
"prop:dust"?: (HelixStrands["dust"]) | undefined;
|
|
33263
33537
|
/** Overall brightness, as a multiplier on the light. */
|
|
33264
33538
|
"prop:gain"?: (HelixStrands["gain"]) | undefined;
|
|
33265
33539
|
/** The share of strands drawn out of focus where the ribbon is wide, from `0`,
|
|
33266
33540
|
every strand sharp, to `1`, every one soft. Clamped to that range. A tight
|
|
33267
|
-
form, such as a
|
|
33541
|
+
form, such as a bend's apex or a wave, stays sharp whatever this says. */
|
|
33268
33542
|
"prop:softness"?: (HelixStrands["softness"]) | undefined;
|
|
33269
33543
|
/** How fast the ribbon moves, as a multiplier on time. `0` holds it still. */
|
|
33270
33544
|
"prop:speed"?: (HelixStrands["speed"]) | undefined;
|
|
@@ -33291,9 +33565,9 @@ itself to the viewport, behind the page. */
|
|
|
33291
33565
|
};
|
|
33292
33566
|
|
|
33293
33567
|
export type HelixStrandsStopProps = {
|
|
33294
|
-
/** Where the form sits across the page, as a share of the width: the
|
|
33295
|
-
|
|
33296
|
-
read it. Unset, a
|
|
33568
|
+
/** Where the form sits across the page, as a share of the width: the bend's
|
|
33569
|
+
apex or the ribbon's axis. A wave crosses the whole width and does not
|
|
33570
|
+
read it. Unset, a bend's apex sits at `0.5` and a ribbon runs down the middle. */
|
|
33297
33571
|
at?: (HelixStrandsStop["at"]) | undefined;
|
|
33298
33572
|
/** The id of the element the form is pinned to, in the same tree as the stop. */
|
|
33299
33573
|
for?: (HelixStrandsStop["for"]) | undefined;
|
|
@@ -33302,9 +33576,9 @@ read it. Unset, a fan bends at `0.4` and a ribbon runs down the middle. */
|
|
|
33302
33576
|
};
|
|
33303
33577
|
|
|
33304
33578
|
export type HelixStrandsStopSolidJsProps = {
|
|
33305
|
-
/** Where the form sits across the page, as a share of the width: the
|
|
33306
|
-
|
|
33307
|
-
read it. Unset, a
|
|
33579
|
+
/** Where the form sits across the page, as a share of the width: the bend's
|
|
33580
|
+
apex or the ribbon's axis. A wave crosses the whole width and does not
|
|
33581
|
+
read it. Unset, a bend's apex sits at `0.5` and a ribbon runs down the middle. */
|
|
33308
33582
|
"prop:at"?: (HelixStrandsStop["at"]) | undefined;
|
|
33309
33583
|
/** The id of the element the form is pinned to, in the same tree as the stop. */
|
|
33310
33584
|
"prop:for"?: (HelixStrandsStop["for"]) | undefined;
|
|
@@ -37040,6 +37314,18 @@ imperatively later, and nothing is hydrating by then.
|
|
|
37040
37314
|
|
|
37041
37315
|
Here rather than on each control. */
|
|
37042
37316
|
name?: (HelixTimePicker["name"]) | undefined;
|
|
37317
|
+
/** What each time in the list shows: a function given the time as `HH:mm`,
|
|
37318
|
+
or `HH:mm:ss` with `seconds`, and the time as the row writes it, that
|
|
37319
|
+
returns text, an element or a Lit template.
|
|
37320
|
+
|
|
37321
|
+
For the seats left at a time, or a caption under it, as React Aria's
|
|
37322
|
+
`ListBoxItem` takes children. Content with `slot="start"`, `slot="end"`
|
|
37323
|
+
or `slot="description"` goes to that slot of the row, and a description
|
|
37324
|
+
is read after the time. The row is still named by the written time, and
|
|
37325
|
+
typeahead still finds it by that. Return the written time with your
|
|
37326
|
+
content where it should still show. A property only, there being no way
|
|
37327
|
+
to write a function in markup. The wheels draw their own figures. */
|
|
37328
|
+
timeContent?: (HelixTimePicker["timeContent"]) | undefined;
|
|
37043
37329
|
/** The value as a `Date` on 1 January 1970 UTC, or `null` while there is no time.
|
|
37044
37330
|
|
|
37045
37331
|
The platform's own pair on `<input type="time">`, epoch day included: a time
|
|
@@ -37376,6 +37662,18 @@ imperatively later, and nothing is hydrating by then.
|
|
|
37376
37662
|
|
|
37377
37663
|
Here rather than on each control. */
|
|
37378
37664
|
"prop:name"?: (HelixTimePicker["name"]) | undefined;
|
|
37665
|
+
/** What each time in the list shows: a function given the time as `HH:mm`,
|
|
37666
|
+
or `HH:mm:ss` with `seconds`, and the time as the row writes it, that
|
|
37667
|
+
returns text, an element or a Lit template.
|
|
37668
|
+
|
|
37669
|
+
For the seats left at a time, or a caption under it, as React Aria's
|
|
37670
|
+
`ListBoxItem` takes children. Content with `slot="start"`, `slot="end"`
|
|
37671
|
+
or `slot="description"` goes to that slot of the row, and a description
|
|
37672
|
+
is read after the time. The row is still named by the written time, and
|
|
37673
|
+
typeahead still finds it by that. Return the written time with your
|
|
37674
|
+
content where it should still show. A property only, there being no way
|
|
37675
|
+
to write a function in markup. The wheels draw their own figures. */
|
|
37676
|
+
"prop:timeContent"?: (HelixTimePicker["timeContent"]) | undefined;
|
|
37379
37677
|
/** The value as a `Date` on 1 January 1970 UTC, or `null` while there is no time.
|
|
37380
37678
|
|
|
37381
37679
|
The platform's own pair on `<input type="time">`, epoch day included: a time
|
|
@@ -37523,6 +37821,13 @@ they run down it. */
|
|
|
37523
37821
|
orientation?: (HelixTimeline["orientation"]) | undefined;
|
|
37524
37822
|
/** Accessible name for the timeline, for people who reach it out of context. */
|
|
37525
37823
|
label?: (HelixTimeline["label"]) | undefined;
|
|
37824
|
+
/** Marks the timeline as busy fetching more entries, and draws an entry
|
|
37825
|
+
after the last that says so. */
|
|
37826
|
+
loading?: (HelixTimeline["loading"]) | undefined;
|
|
37827
|
+
/** The text of the entry drawn while `loading` is set, where the `loading` slot is empty. */
|
|
37828
|
+
"loading-label"?: (HelixTimeline["loadingLabel"]) | undefined;
|
|
37829
|
+
/** The text of the entry drawn while `loading` is set, where the `loading` slot is empty. */
|
|
37830
|
+
loadingLabel?: (HelixTimeline["loadingLabel"]) | undefined;
|
|
37526
37831
|
};
|
|
37527
37832
|
|
|
37528
37833
|
export type HelixTimelineSolidJsProps = {
|
|
@@ -37537,6 +37842,13 @@ they run down it. */
|
|
|
37537
37842
|
"prop:orientation"?: (HelixTimeline["orientation"]) | undefined;
|
|
37538
37843
|
/** Accessible name for the timeline, for people who reach it out of context. */
|
|
37539
37844
|
"prop:label"?: (HelixTimeline["label"]) | undefined;
|
|
37845
|
+
/** Marks the timeline as busy fetching more entries, and draws an entry
|
|
37846
|
+
after the last that says so. */
|
|
37847
|
+
"prop:loading"?: (HelixTimeline["loading"]) | undefined;
|
|
37848
|
+
/** The text of the entry drawn while `loading` is set, where the `loading` slot is empty. */
|
|
37849
|
+
"attr:loading-label"?: (HelixTimeline["loadingLabel"]) | undefined;
|
|
37850
|
+
/** The text of the entry drawn while `loading` is set, where the `loading` slot is empty. */
|
|
37851
|
+
"prop:loadingLabel"?: (HelixTimeline["loadingLabel"]) | undefined;
|
|
37540
37852
|
|
|
37541
37853
|
/** Set the innerHTML of the element */
|
|
37542
37854
|
innerHTML?: (string) | undefined;
|
|
@@ -41241,12 +41553,18 @@ export type HelixVirtualListElementEvent<E = Event> = TypedEvent<
|
|
|
41241
41553
|
/** `helix-before-change` event type */
|
|
41242
41554
|
export type HelixVirtualListHelixBeforeChangeElementEvent =
|
|
41243
41555
|
HelixVirtualListElementEvent<HelixBeforeChangeEvent>;
|
|
41556
|
+
/** `helix-before-reorder` event type */
|
|
41557
|
+
export type HelixVirtualListHelixBeforeReorderElementEvent =
|
|
41558
|
+
HelixVirtualListElementEvent<HelixBeforeReorderEvent>;
|
|
41244
41559
|
/** `helix-load-more` event type */
|
|
41245
41560
|
export type HelixVirtualListHelixLoadMoreElementEvent =
|
|
41246
41561
|
HelixVirtualListElementEvent<HelixLoadMoreEvent>;
|
|
41247
41562
|
/** `helix-range-change` event type */
|
|
41248
41563
|
export type HelixVirtualListHelixRangeChangeElementEvent =
|
|
41249
41564
|
HelixVirtualListElementEvent<HelixRangeChangeEvent>;
|
|
41565
|
+
/** `helix-reorder` event type */
|
|
41566
|
+
export type HelixVirtualListHelixReorderElementEvent =
|
|
41567
|
+
HelixVirtualListElementEvent<HelixReorderEvent>;
|
|
41250
41568
|
|
|
41251
41569
|
export type HelixVirtualListProps = {
|
|
41252
41570
|
/** How many items a line holds. One, the default, is a list; more lays the
|
|
@@ -41326,6 +41644,13 @@ and scrolls it sideways: Left and Right move between items, the other
|
|
|
41326
41644
|
way round on a right-to-left page, and `estimate` is an item's width. A
|
|
41327
41645
|
grid always runs down. */
|
|
41328
41646
|
orientation?: (HelixVirtualList["orientation"]) | undefined;
|
|
41647
|
+
/** Lets a reader move items, once `@fusion.dev/helix/virtual-list/reorder`
|
|
41648
|
+
(or `@fusion.dev/helix-headless/virtual-list/reorder`) is imported: Alt
|
|
41649
|
+
with an arrow moves the row the keys are on, and a pointer drags a row.
|
|
41650
|
+
The list moves no item itself: you move your `items` on `helix-reorder`.
|
|
41651
|
+
Without that import it does nothing, so a list that never moves items
|
|
41652
|
+
carries none of the code. A list of one column, without sections. */
|
|
41653
|
+
reorderable?: (HelixVirtualList["reorderable"]) | undefined;
|
|
41329
41654
|
/** The field of each item that names its section, as a key or a path of
|
|
41330
41655
|
keys. Set, the items are drawn in sections: a header, then the items, in
|
|
41331
41656
|
an element with the `group` role that the header names. A section starts
|
|
@@ -41391,12 +41716,18 @@ it is unset, the header is the name as text. */
|
|
|
41391
41716
|
"onhelix-before-change"?: ((
|
|
41392
41717
|
e: HelixVirtualListHelixBeforeChangeElementEvent,
|
|
41393
41718
|
) => void) | undefined;
|
|
41719
|
+
/** Fired when an item is dropped at a new place, in a `reorderable` list with `@fusion.dev/helix/virtual-list/reorder` imported, with every key in the new order. Cancelable: cancel it to keep the item where it is. */
|
|
41720
|
+
"onhelix-before-reorder"?: ((
|
|
41721
|
+
e: HelixVirtualListHelixBeforeReorderElementEvent,
|
|
41722
|
+
) => void) | undefined;
|
|
41394
41723
|
/** Fired when a reader comes within one screen of the last item, once for each length of the set. */
|
|
41395
41724
|
"onhelix-load-more"?: ((e: HelixVirtualListHelixLoadMoreElementEvent) => void) | undefined;
|
|
41396
41725
|
/** Fired when the items on screen change, with the new `first` and `last`, which `range` also holds. */
|
|
41397
41726
|
"onhelix-range-change"?: ((
|
|
41398
41727
|
e: HelixVirtualListHelixRangeChangeElementEvent,
|
|
41399
41728
|
) => void) | undefined;
|
|
41729
|
+
/** Fired after `helix-before-reorder` when nobody canceled it. Set `items` to the order in `keys`. Cancelable: cancel it to say the move did not happen. */
|
|
41730
|
+
"onhelix-reorder"?: ((e: HelixVirtualListHelixReorderElementEvent) => void) | undefined;
|
|
41400
41731
|
};
|
|
41401
41732
|
|
|
41402
41733
|
export type HelixVirtualListSolidJsProps = {
|
|
@@ -41477,6 +41808,13 @@ and scrolls it sideways: Left and Right move between items, the other
|
|
|
41477
41808
|
way round on a right-to-left page, and `estimate` is an item's width. A
|
|
41478
41809
|
grid always runs down. */
|
|
41479
41810
|
"prop:orientation"?: (HelixVirtualList["orientation"]) | undefined;
|
|
41811
|
+
/** Lets a reader move items, once `@fusion.dev/helix/virtual-list/reorder`
|
|
41812
|
+
(or `@fusion.dev/helix-headless/virtual-list/reorder`) is imported: Alt
|
|
41813
|
+
with an arrow moves the row the keys are on, and a pointer drags a row.
|
|
41814
|
+
The list moves no item itself: you move your `items` on `helix-reorder`.
|
|
41815
|
+
Without that import it does nothing, so a list that never moves items
|
|
41816
|
+
carries none of the code. A list of one column, without sections. */
|
|
41817
|
+
"prop:reorderable"?: (HelixVirtualList["reorderable"]) | undefined;
|
|
41480
41818
|
/** The field of each item that names its section, as a key or a path of
|
|
41481
41819
|
keys. Set, the items are drawn in sections: a header, then the items, in
|
|
41482
41820
|
an element with the `group` role that the header names. A section starts
|
|
@@ -41541,12 +41879,18 @@ it is unset, the header is the name as text. */
|
|
|
41541
41879
|
"on:helix-before-change"?: ((
|
|
41542
41880
|
e: HelixVirtualListHelixBeforeChangeElementEvent,
|
|
41543
41881
|
) => void) | undefined;
|
|
41882
|
+
/** Fired when an item is dropped at a new place, in a `reorderable` list with `@fusion.dev/helix/virtual-list/reorder` imported, with every key in the new order. Cancelable: cancel it to keep the item where it is. */
|
|
41883
|
+
"on:helix-before-reorder"?: ((
|
|
41884
|
+
e: HelixVirtualListHelixBeforeReorderElementEvent,
|
|
41885
|
+
) => void) | undefined;
|
|
41544
41886
|
/** Fired when a reader comes within one screen of the last item, once for each length of the set. */
|
|
41545
41887
|
"on:helix-load-more"?: ((e: HelixVirtualListHelixLoadMoreElementEvent) => void) | undefined;
|
|
41546
41888
|
/** Fired when the items on screen change, with the new `first` and `last`, which `range` also holds. */
|
|
41547
41889
|
"on:helix-range-change"?: ((
|
|
41548
41890
|
e: HelixVirtualListHelixRangeChangeElementEvent,
|
|
41549
41891
|
) => void) | undefined;
|
|
41892
|
+
/** Fired after `helix-before-reorder` when nobody canceled it. Set `items` to the order in `keys`. Cancelable: cancel it to say the move did not happen. */
|
|
41893
|
+
"on:helix-reorder"?: ((e: HelixVirtualListHelixReorderElementEvent) => void) | undefined;
|
|
41550
41894
|
|
|
41551
41895
|
/** Set the innerHTML of the element */
|
|
41552
41896
|
innerHTML?: (string) | undefined;
|
|
@@ -43789,6 +44133,8 @@ export type CustomElements = {
|
|
|
43789
44133
|
* separate actions. The semantics and the joining are separate questions:
|
|
43790
44134
|
* `role="group"` and a shared name are what make a set of buttons a set, and
|
|
43791
44135
|
* `helix-flex` gives the spacing without the group.
|
|
44136
|
+
* - `disabled`: Disables every button in the group, and says so on the group with
|
|
44137
|
+
* `aria-disabled`. Reflected, so a stylesheet can select on it.
|
|
43792
44138
|
* - `disallow-empty-selection`/`disallowEmptySelection`: Keeps at least one button pressed once one is, as React Aria's
|
|
43793
44139
|
* `disallowEmptySelection`: a press that would leave none pressed is
|
|
43794
44140
|
* refused.
|
|
@@ -43823,6 +44169,8 @@ export type CustomElements = {
|
|
|
43823
44169
|
*
|
|
43824
44170
|
* The attribute is the seed, and a press changes the property, which does
|
|
43825
44171
|
* not reflect, as a native control's `value` does not.
|
|
44172
|
+
* - `values`: The pressed values as a list, in a selection mode, and an empty list
|
|
44173
|
+
* otherwise. Written, it presses exactly those buttons. (property only)
|
|
43826
44174
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
43827
44175
|
*
|
|
43828
44176
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -44727,6 +45075,8 @@ export type CustomElements = {
|
|
|
44727
45075
|
* Third", rather than with a comma this component chose.
|
|
44728
45076
|
* - `linked-label`/`linkedLabel`: The text read with a card that has connections both ways. `{leadsTo}` is
|
|
44729
45077
|
* `leads-to-label` and `{comesFrom}` is `comes-from-label`, each filled in.
|
|
45078
|
+
* - `loading`: Marks the board as busy while its document arrives: the board is
|
|
45079
|
+
* `aria-busy`, and the `loading` slot is shown.
|
|
44730
45080
|
* - `moved-label`/`movedLabel`: What screen readers hear after a key moves a card, with `{name}` for the
|
|
44731
45081
|
* card and `{x}` and `{y}` for where it now is, in the document's units.
|
|
44732
45082
|
*
|
|
@@ -44892,6 +45242,7 @@ export type CustomElements = {
|
|
|
44892
45242
|
* - `footer`: Content below the board.
|
|
44893
45243
|
* - `fullscreen-icon`: Replaces the glyph inside the fullscreen button.
|
|
44894
45244
|
* - `header`: Content above the board.
|
|
45245
|
+
* - `loading`: Content shown while `loading` is set, such as a progress bar while the document arrives.
|
|
44895
45246
|
* - `pan-down-icon`: Replaces the glyph inside the pan down button.
|
|
44896
45247
|
* - `pan-end-icon`: Replaces the glyph inside the button that pans toward the end of a line of text.
|
|
44897
45248
|
* - `pan-start-icon`: Replaces the glyph inside the button that pans toward the start of a line of text.
|
|
@@ -45014,6 +45365,7 @@ export type CustomElements = {
|
|
|
45014
45365
|
* - `fullscreen`: While the board fills the screen.
|
|
45015
45366
|
* - `holding`: An item picked up with a click follows the pointer until the next press puts it down.
|
|
45016
45367
|
* - `idle`: The user has been still for `idle-delay` milliseconds. The board's own controls stay; select on it to hide chrome of your own.
|
|
45368
|
+
* - `loading`: While `loading` is set.
|
|
45017
45369
|
* - `pressing`: While a press on the board, its cards or its connections is under way.
|
|
45018
45370
|
* - `sharing`: The page keeps the plain wheel and one finger, with `gestures="cooperative"` or while a board with `gestures="activate"` waits to be pressed.
|
|
45019
45371
|
* - `using`: A board with `gestures="activate"` has been pressed and has the gestures.
|
|
@@ -48314,6 +48666,15 @@ export type CustomElements = {
|
|
|
48314
48666
|
* Defaulted rather than left empty. An icon-only control must be named, and
|
|
48315
48667
|
* the name of this one is not a judgment call: every copy button in the
|
|
48316
48668
|
* world is called Copy. A consumer with a better word still sets it.
|
|
48669
|
+
* - `show-label`/`showLabel`: Draws the name as words beside the icon, and the result in their place
|
|
48670
|
+
* after a press. The button stays as wide as the longest of them.
|
|
48671
|
+
* - `tooltip`: When the tooltip shows: `full` on hover and focus and after a press,
|
|
48672
|
+
* `copy` only after a press, to show the result, and `none` never, for a
|
|
48673
|
+
* button whose result shows another way, such as under `show-label`.
|
|
48674
|
+
*
|
|
48675
|
+
* Unset is `full`, and the attribute stays absent until you write it.
|
|
48676
|
+
* - `tooltip-placement`/`tooltipPlacement`: The side the tooltip prefers. It moves to another side where this one
|
|
48677
|
+
* does not fit.
|
|
48317
48678
|
* - `value`: The text copied to the clipboard.
|
|
48318
48679
|
*
|
|
48319
48680
|
* It replaces `Button.value`, the submit value: a copy button never submits,
|
|
@@ -48497,6 +48858,7 @@ export type CustomElements = {
|
|
|
48497
48858
|
* - `live`: The live region that says `copied-label` or `error-label` after a press, and `pending-label` when the button becomes pending under focus. It is rendered from the first time it says anything.
|
|
48498
48859
|
* - `mark`: The clipboard icon, and the confirmation icon that replaces it.
|
|
48499
48860
|
* - `spinner`: The ring a pending button turns, an empty element the styled button draws over the icon. It is rendered only while the button is pending.
|
|
48861
|
+
* - `text`: The words beside the icon, under `show-label`. It holds all three, `label`, `copied-label` and `error-label`, with all but the current one hidden.
|
|
48500
48862
|
* - `tooltip`: The tooltip bubble, forwarded from the tooltip inside the button.
|
|
48501
48863
|
* - `tooltip-arrow`: The tooltip's arrow, which points at the button.
|
|
48502
48864
|
* - `tooltip-arrow-bottom`: The arrow while the bubble is below the button, on the bubble's top edge. Set together with `tooltip-arrow`.
|
|
@@ -52644,6 +53006,9 @@ export type CustomElements = {
|
|
|
52644
53006
|
* - `linked-both-label`/`linkedBothLabel`: How a note linked both to and from the selected one is described, with `{note}`.
|
|
52645
53007
|
* - `linked-from-label`/`linkedFromLabel`: How a note the selected one links to is described, with `{note}`, the selected note's name.
|
|
52646
53008
|
* - `links-to-label`/`linksToLabel`: How a note that links to the selected one is described, with `{note}`.
|
|
53009
|
+
* - `loading`: Marks the graph as busy while its notes arrive: the list is `aria-busy`,
|
|
53010
|
+
* and the panel says so where it holds no notes yet.
|
|
53011
|
+
* - `loading-label`/`loadingLabel`: What the panel says while `loading` is set and the list holds no notes.
|
|
52647
53012
|
* - `moved-down-label`/`movedDownLabel`: What screen readers hear once the drawing has moved down, after `moved()`.
|
|
52648
53013
|
* - `moved-left-label`/`movedLeftLabel`: What screen readers hear once the drawing has moved left, after `moved()`.
|
|
52649
53014
|
* - `moved-right-label`/`movedRightLabel`: What screen readers hear once the drawing has moved right, after `moved()`.
|
|
@@ -52666,6 +53031,15 @@ export type CustomElements = {
|
|
|
52666
53031
|
* - `hiddenGroups`: The groups turned off in the legend, by name, whose notes neither the drawing nor the list shows. A property, never an attribute. (property only)
|
|
52667
53032
|
* - `links`: The links between notes, each from `source` to `target`. A property, never an attribute. (property only)
|
|
52668
53033
|
* - `nodes`: The notes. A property, never an attribute. (property only)
|
|
53034
|
+
* - `noteContent`: What each note's row in the list shows in place of its name: a function
|
|
53035
|
+
* given the note that returns text, an element or a Lit template.
|
|
53036
|
+
*
|
|
53037
|
+
* For an icon by its kind, or a date under its name, as React Aria's
|
|
53038
|
+
* `ListBoxItem` takes children. The row is still named by the note's name,
|
|
53039
|
+
* which typeahead and the search find it by, and described by how it stands
|
|
53040
|
+
* to the selected note. Return the name with your content where it should
|
|
53041
|
+
* still show. A property only, there being no way to write a function in
|
|
53042
|
+
* markup. (property only)
|
|
52669
53043
|
* - `ready`: Whether the graph has been drawn whole. For code that runs after `helix-graph-ready`. (property only) (readonly)
|
|
52670
53044
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
52671
53045
|
*
|
|
@@ -52712,6 +53086,7 @@ export type CustomElements = {
|
|
|
52712
53086
|
* - `footer`: Content below the graph.
|
|
52713
53087
|
* - `fullscreen-icon`: Replaces the glyph inside the fullscreen button.
|
|
52714
53088
|
* - `header`: Content above the graph.
|
|
53089
|
+
* - `loading`: What the panel shows while `loading` is set and the list holds no notes. Defaults to `loading-label`.
|
|
52715
53090
|
* - `pan-down-icon`: Replaces the glyph inside the pan down button.
|
|
52716
53091
|
* - `pan-end-icon`: Replaces the glyph inside the button that pans toward the end of a line of text.
|
|
52717
53092
|
* - `pan-start-icon`: Replaces the glyph inside the button that pans toward the start of a line of text.
|
|
@@ -52803,6 +53178,7 @@ export type CustomElements = {
|
|
|
52803
53178
|
* - `legend-swatch`: The mark in a group's color, before its name.
|
|
52804
53179
|
* - `list`: The list of notes, which draws only the rows in view.
|
|
52805
53180
|
* - `live`: What screen readers hear: how many notes there are when a search or the legend changes it, and which way the drawing went after a key or a control moved it.
|
|
53181
|
+
* - `loading`: The box in place of the list while `loading` is set and it holds no notes, holding the `loading` slot.
|
|
52806
53182
|
* - `note`: One note in the list.
|
|
52807
53183
|
* - `note-cursor`: The note the keyboard is on in the list.
|
|
52808
53184
|
* - `note-linked`: A note linked to or from the selected one.
|
|
@@ -52830,6 +53206,7 @@ export type CustomElements = {
|
|
|
52830
53206
|
* - `empty`: The list holds no notes: the graph has none, or a search or the groups hid them all.
|
|
52831
53207
|
* - `fullscreen`: The graph fills the screen.
|
|
52832
53208
|
* - `idle`: The user has been still long enough for the header and footer to fade.
|
|
53209
|
+
* - `loading`: While `loading` is set.
|
|
52833
53210
|
* - `local`: The drawing shows the selected note's local graph, with `depth`.
|
|
52834
53211
|
* - `panel-open`: A graph with `no-panel` has the search and the list open over the drawing.
|
|
52835
53212
|
* - `ready`: The graph has been drawn whole, after `helix-graph-ready`.
|
|
@@ -55415,7 +55792,8 @@ export type CustomElements = {
|
|
|
55415
55792
|
* itself.
|
|
55416
55793
|
* - `value`: The selected rows' values, separated by commas with no spaces, such as `a,c`, in a list that selects.
|
|
55417
55794
|
*
|
|
55418
|
-
*
|
|
55795
|
+
* A press or a key writes it in row order, as Data Table does, whatever
|
|
55796
|
+
* order the rows were chosen in. Set it to start with rows selected. A row's value is its `value`, or its
|
|
55419
55797
|
* words where it has none.
|
|
55420
55798
|
* - `rows`: The rows the list holds, in order. (property only) (readonly)
|
|
55421
55799
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
@@ -59436,10 +59814,18 @@ export type CustomElements = {
|
|
|
59436
59814
|
*
|
|
59437
59815
|
* The orb is styled only and has behavior, which the tier split does not
|
|
59438
59816
|
* otherwise allow. Its role, name and busy state follow `state`, unless
|
|
59439
|
-
* `announce` makes it a status region, and the rest
|
|
59440
|
-
*
|
|
59441
|
-
*
|
|
59442
|
-
*
|
|
59817
|
+
* `announce` makes it a status region, and the rest is drawing dots to a
|
|
59818
|
+
* canvas.
|
|
59819
|
+
*
|
|
59820
|
+
* **A shape of your own goes in the default slot**, such as an SVG, an
|
|
59821
|
+
* image, or an animation. The orb draws it over its box in place of the dots
|
|
59822
|
+
* and stops drawing them, and keeps its role, name, busy state and custom
|
|
59823
|
+
* states, so your stylesheet can change what you slotted by state, such as
|
|
59824
|
+
* `helix-orb:state(working) svg { animation-duration: 1s }`. What you slot is
|
|
59825
|
+
* for the eye: a screen reader hears the orb's name.
|
|
59826
|
+
*
|
|
59827
|
+
* `--orb-speed` scales how fast the dots move, so `0.5` is a calmer orb at
|
|
59828
|
+
* half the tempo.
|
|
59443
59829
|
*
|
|
59444
59830
|
* Each state is also a custom state, such as `:state(thinking)` or
|
|
59445
59831
|
* `:state(done)`, so a page can style what sits around an orb by what it shows,
|
|
@@ -59521,6 +59907,12 @@ export type CustomElements = {
|
|
|
59521
59907
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
59522
59908
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
59523
59909
|
*
|
|
59910
|
+
* ## Slots
|
|
59911
|
+
*
|
|
59912
|
+
* Areas where markup can be added to the component.
|
|
59913
|
+
*
|
|
59914
|
+
* - `(default)`: A shape of your own, drawn over the orb's box in place of the dots.
|
|
59915
|
+
*
|
|
59524
59916
|
* ## CSS Custom Properties
|
|
59525
59917
|
*
|
|
59526
59918
|
* CSS variables available for styling the component.
|
|
@@ -59528,12 +59920,13 @@ export type CustomElements = {
|
|
|
59528
59920
|
* - `--orb-color`: The color of the nearest dots. Defaults to `currentColor`.
|
|
59529
59921
|
* - `--orb-ground`: The color the farthest dots fade toward. Defaults to the page's background.
|
|
59530
59922
|
* - `--orb-size`: The diameter. Overrides `size`.
|
|
59923
|
+
* - `--orb-speed`: How fast the dots move, as a multiple of each state's own tempo. Defaults to `1`.
|
|
59531
59924
|
*
|
|
59532
59925
|
* ## CSS Parts
|
|
59533
59926
|
*
|
|
59534
59927
|
* Custom selectors for styling elements within the component.
|
|
59535
59928
|
*
|
|
59536
|
-
* - `canvas`: The canvas the dots are drawn on.
|
|
59929
|
+
* - `canvas`: The canvas the dots are drawn on. Hidden while the default slot holds a shape.
|
|
59537
59930
|
* - `live`: The word for the state, which the orb says as it changes when `announce` is set. Rendered only then, and clipped out of view.
|
|
59538
59931
|
*
|
|
59539
59932
|
* ## CSS States
|
|
@@ -59597,6 +59990,9 @@ export type CustomElements = {
|
|
|
59597
59990
|
* box the sections scroll in.
|
|
59598
59991
|
* - `label`: The navigation's name, read by screen readers. A heading in the `heading`
|
|
59599
59992
|
* slot names it in place of this.
|
|
59993
|
+
* - `marks`: Which links are marked. `reading` marks the one section being read, the
|
|
59994
|
+
* last whose heading has passed the reading line. `visible` marks every
|
|
59995
|
+
* section with part of it on screen, and the mark runs across their links.
|
|
59600
59996
|
* - `offset`: How far below the top of the scroll container a heading counts as reached,
|
|
59601
59997
|
* in pixels. The scroll container is the window or the panel the sections
|
|
59602
59998
|
* scroll in.
|
|
@@ -59612,6 +60008,9 @@ export type CustomElements = {
|
|
|
59612
60008
|
* writable property in this library that a component also writes is state a
|
|
59613
60009
|
* consumer can own; this one cannot be, and saying so with the type is better
|
|
59614
60010
|
* than saying it in a sentence nobody reads. (property only) (readonly)
|
|
60011
|
+
* - `marked`: The ids of the sections whose links are marked, in page order: the one
|
|
60012
|
+
* `current` names, or under `marks="visible"` every section on screen.
|
|
60013
|
+
* Read-only, for the reason `current` gives. (property only) (readonly)
|
|
59615
60014
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
59616
60015
|
*
|
|
59617
60016
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -59647,6 +60046,14 @@ export type CustomElements = {
|
|
|
59647
60046
|
* - `heading`: A heading above the links, such as "On this page". It names the navigation.
|
|
59648
60047
|
* - `indicator`: A mark of your own, drawn inside the `indicator` part, where `--indicator-x`, `--indicator-y`, `--indicator-inline-size` and `--indicator-block-size` reach it.
|
|
59649
60048
|
*
|
|
60049
|
+
* ## Methods
|
|
60050
|
+
*
|
|
60051
|
+
* Methods that can be called to access component functionality.
|
|
60052
|
+
*
|
|
60053
|
+
* - `scrollToSection(id: string) => boolean`: Scrolls to the section with this id, as a press on its link does, with
|
|
60054
|
+
* `behavior`, and marks its link at once. The address and focus stay where
|
|
60055
|
+
* they are. Returns whether the outline has a link to that section.
|
|
60056
|
+
*
|
|
59650
60057
|
* ## CSS Custom Properties
|
|
59651
60058
|
*
|
|
59652
60059
|
* CSS variables available for styling the component.
|
|
@@ -61719,6 +62126,16 @@ export type CustomElements = {
|
|
|
61719
62126
|
* since a browser reads one only as a document starts. A `src` document
|
|
61720
62127
|
* declares its own.
|
|
61721
62128
|
*
|
|
62129
|
+
* **`dependencies` names packages by version instead**, as a `package.json`
|
|
62130
|
+
* does: `{"canvas-confetti": "^1.9"}` loads `canvas-confetti` and the paths
|
|
62131
|
+
* under it from `cdn`, `https://esm.sh/` by default, at the version or range
|
|
62132
|
+
* given. An address in `imports` wins over a package of the same name.
|
|
62133
|
+
*
|
|
62134
|
+
* **`modules` holds files the example imports by a relative path**: each path,
|
|
62135
|
+
* such as `utils.js`, to its source, and `import { add } from './utils.js'`
|
|
62136
|
+
* in the `js` pane or in another module loads it. A sandbox writes each pane
|
|
62137
|
+
* named for a module file here.
|
|
62138
|
+
*
|
|
61722
62139
|
* **Examples render in a frame**, so an example's styles and scripts do not
|
|
61723
62140
|
* affect the page around the sandbox, and `position: fixed` stays inside the
|
|
61724
62141
|
* pane. The frame starts empty, with its own stylesheets and its own custom
|
|
@@ -61739,8 +62156,9 @@ export type CustomElements = {
|
|
|
61739
62156
|
*
|
|
61740
62157
|
* **A failed preview shows the error over the example**, in the `error` part,
|
|
61741
62158
|
* until the next source is sent. The terminal says it too, so the part is not
|
|
61742
|
-
* announced
|
|
61743
|
-
*
|
|
62159
|
+
* announced, and it is the frame's description while it shows, so a screen
|
|
62160
|
+
* reader reads it with the frame. Hide it with `::part(error) { display: none }`
|
|
62161
|
+
* where the page draws its own.
|
|
61744
62162
|
*
|
|
61745
62163
|
* **`controls` draws two buttons in the preview's corner**: one reloads the
|
|
61746
62164
|
* frame's document, as `reload()` does, and one opens the example in a new
|
|
@@ -61750,6 +62168,8 @@ export type CustomElements = {
|
|
|
61750
62168
|
*
|
|
61751
62169
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
61752
62170
|
*
|
|
62171
|
+
* - `cdn`: The address the packages in `dependencies` load from, which the name, an
|
|
62172
|
+
* `@` and the version follow.
|
|
61753
62173
|
* - `color-mode`/`colorMode`: The color mode the frame renders in.
|
|
61754
62174
|
*
|
|
61755
62175
|
* **The frame is a document and a document has its own color mode.** Setting
|
|
@@ -61765,6 +62185,10 @@ export type CustomElements = {
|
|
|
61765
62185
|
* including every one of the 24 series colors a chart reads.
|
|
61766
62186
|
* - `controls`: Whether the preview draws a reload button and a button that opens the
|
|
61767
62187
|
* example in a new tab, in its corner.
|
|
62188
|
+
* - `dependencies`: The npm packages an example can import by name in the built-in document,
|
|
62189
|
+
* each name to a version or a range, as a `package.json` lists them. Each
|
|
62190
|
+
* loads from `cdn`. Set it as JSON in the attribute or as an object. Not
|
|
62191
|
+
* read where `src` is set.
|
|
61768
62192
|
* - `direction`: Writing direction inside the frame.
|
|
61769
62193
|
*
|
|
61770
62194
|
* Not reflected. It is payload for the render message and nothing selects on
|
|
@@ -61787,6 +62211,9 @@ export type CustomElements = {
|
|
|
61787
62211
|
* Not reflected, for `direction`'s reason: the placement is applied by the
|
|
61788
62212
|
* document inside the frame, against its own root, so no rule on this side
|
|
61789
62213
|
* could read it.
|
|
62214
|
+
* - `modules`: Module files an example imports by a relative path in the built-in
|
|
62215
|
+
* document, each path, such as `utils.js`, to its source. Not read where
|
|
62216
|
+
* `src` is set.
|
|
61790
62217
|
* - `open-label`/`openLabel`: The name of the button that opens the example in a new tab, under
|
|
61791
62218
|
* `controls`.
|
|
61792
62219
|
* - `reload-label`/`reloadLabel`: The name of the button that reloads the frame's document, under
|
|
@@ -61885,10 +62312,22 @@ export type CustomElements = {
|
|
|
61885
62312
|
* milliseconds by default, so a word typed reloads it once. A pane's text when the sandbox starts reaches it at once.
|
|
61886
62313
|
*
|
|
61887
62314
|
* The event carries the pane's `name`, so one sandbox can hold several panes.
|
|
61888
|
-
*
|
|
61889
|
-
*
|
|
61890
|
-
*
|
|
61891
|
-
*
|
|
62315
|
+
* The names the sandbox writes into its previews:
|
|
62316
|
+
*
|
|
62317
|
+
* - `html` sets the preview's markup.
|
|
62318
|
+
* - `css` sets its stylesheet.
|
|
62319
|
+
* - `js` sets a script that runs as a module after the markup.
|
|
62320
|
+
* - A module file name ending in `.js` or `.mjs`, such as `utils.js`, is a
|
|
62321
|
+
* module the other scripts import by its path, `./utils.js`.
|
|
62322
|
+
* - `package.json` sets the npm packages the scripts import by name, from its
|
|
62323
|
+
* `dependencies`, which load from the preview's `cdn`.
|
|
62324
|
+
*
|
|
62325
|
+
* The sandbox ignores a pane with any other name, so that pane can show
|
|
62326
|
+
* content without changing the preview.
|
|
62327
|
+
*
|
|
62328
|
+
* **The sandbox is `:state(modified)` while a source pane holds an edit**, and
|
|
62329
|
+
* that pane's file tab is also `file-modified` and described as modified to
|
|
62330
|
+
* a screen reader. `reset()` puts every pane back to the source it was given.
|
|
61892
62331
|
*
|
|
61893
62332
|
* **The dividers are two nested `helix-splitter` elements**, which handle the
|
|
61894
62333
|
* pointer, the keyboard, and the corner. The inner splitter holds the panes and
|
|
@@ -61963,6 +62402,8 @@ export type CustomElements = {
|
|
|
61963
62402
|
*
|
|
61964
62403
|
* `split` follows the lead pane rather than the source, so `split="30"` means
|
|
61965
62404
|
* the same thing in both directions: thirty percent to whatever comes first.
|
|
62405
|
+
* - `modified-label`/`modifiedLabel`: The description of a file tab whose pane holds an edit, read by screen
|
|
62406
|
+
* readers after the file's name.
|
|
61966
62407
|
* - `orientation`: Whether the panes sit side by side or stacked.
|
|
61967
62408
|
*
|
|
61968
62409
|
* Not reflected, for `lead`'s reason above: no rule selects on it. The axis
|
|
@@ -62040,6 +62481,15 @@ export type CustomElements = {
|
|
|
62040
62481
|
* - `status`: A status bar, spanning both panes at the bottom.
|
|
62041
62482
|
* - `toolbar`: A bar across the top, spanning both panes.
|
|
62042
62483
|
*
|
|
62484
|
+
* ## Methods
|
|
62485
|
+
*
|
|
62486
|
+
* Methods that can be called to access component functionality.
|
|
62487
|
+
*
|
|
62488
|
+
* - `reset() => void`: Puts every source pane back to the source it was given: through the
|
|
62489
|
+
* pane's own `reset()` where it has one, which sends an edit the previews
|
|
62490
|
+
* take, and otherwise by setting its `value` and writing it into the
|
|
62491
|
+
* previews.
|
|
62492
|
+
*
|
|
62043
62493
|
* ## CSS Custom Properties
|
|
62044
62494
|
*
|
|
62045
62495
|
* CSS variables available for styling the component.
|
|
@@ -62055,6 +62505,7 @@ export type CustomElements = {
|
|
|
62055
62505
|
* - `body`: The splitter holding the panes above the panel. `::part(body):state(dragging)` matches while its divider is held.
|
|
62056
62506
|
* - `corner`: The handle where the two dividers cross.
|
|
62057
62507
|
* - `file`: One file tab, `aria-selected` while its pane is shown.
|
|
62508
|
+
* - `file-modified`: A file tab whose pane holds an edit.
|
|
62058
62509
|
* - `files`: The file tabs over the source panes, where there are several.
|
|
62059
62510
|
* - `pane`: Either pane.
|
|
62060
62511
|
* - `panel`: The box that holds the slotted panel.
|
|
@@ -62065,6 +62516,7 @@ export type CustomElements = {
|
|
|
62065
62516
|
*
|
|
62066
62517
|
* These can be used to apply styling when a component is in a given state.
|
|
62067
62518
|
*
|
|
62519
|
+
* - `modified`: While a source pane holds an edit, until `reset()`.
|
|
62068
62520
|
* - `panel-collapsed`: While there is a panel and it is no taller than `panel-collapsed-size`.
|
|
62069
62521
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
62070
62522
|
*/
|
|
@@ -62096,8 +62548,37 @@ export type CustomElements = {
|
|
|
62096
62548
|
* that wraps keeps one number. The numbers are drawn, and hidden from screen
|
|
62097
62549
|
* readers, which read the field.
|
|
62098
62550
|
*
|
|
62099
|
-
* Enter keeps the indentation of the line it breaks,
|
|
62100
|
-
*
|
|
62551
|
+
* Enter keeps the indentation of the line it breaks, one level deeper after
|
|
62552
|
+
* an opening bracket, and puts the closing bracket of an empty pair on a line
|
|
62553
|
+
* of its own. The new line is undone with the next undo as typing is.
|
|
62554
|
+
*
|
|
62555
|
+
* **The editing keys are CodeMirror's.** Tab with text selected indents every
|
|
62556
|
+
* line the selection touches. `Mod+]` indents the lines and `Mod+[` outdents
|
|
62557
|
+
* them, and `Mod+/` comments them out or back in: `//` in a `js` pane, and one
|
|
62558
|
+
* block comment in an `html` or `css` pane. `Mod` is Command on a Mac and
|
|
62559
|
+
* Control elsewhere. Each is one step of undo.
|
|
62560
|
+
*
|
|
62561
|
+
* **`close-brackets` closes brackets and quotes** as you type them: `(`, `[`,
|
|
62562
|
+
* `{` and the three quotes. A closing character typed before the same one
|
|
62563
|
+
* steps over it, Backspace between an empty pair deletes both, and a bracket
|
|
62564
|
+
* typed with text selected goes around the text. **`match-brackets` marks
|
|
62565
|
+
* the bracket beside the caret and its pair** while the field has focus, each
|
|
62566
|
+
* a `bracket` part, and a bracket with no pair is also `bracket-unmatched`.
|
|
62567
|
+
* A bracket in a string or a comment is not matched, where `tokenize` says
|
|
62568
|
+
* which runs those are.
|
|
62569
|
+
*
|
|
62570
|
+
* **`complete` offers completions as you type**: the words of the source and
|
|
62571
|
+
* of `completions` that start with the word before the caret. They open in a
|
|
62572
|
+
* list under the word. The arrow keys move through it, Enter or Tab takes the
|
|
62573
|
+
* word, and Escape closes it. `Ctrl+Space` opens it where it is closed. The
|
|
62574
|
+
* field is `aria-autocomplete="list"` and points at the word chosen with
|
|
62575
|
+
* `aria-activedescendant`, so a screen reader reads each one. Give
|
|
62576
|
+
* `completions` the names a page uses, such as the tag and attribute names of
|
|
62577
|
+
* a custom elements manifest through `manifestWords`.
|
|
62578
|
+
*
|
|
62579
|
+
* **The pane is `:state(modified)` while its source differs from the source it
|
|
62580
|
+
* was given**, the first `value` or the last one set from outside. `reset()`
|
|
62581
|
+
* puts that source back, as an edit the sandbox passes on to its preview.
|
|
62101
62582
|
*
|
|
62102
62583
|
* **The source can be written inside the pane** where `value` is not set: its
|
|
62103
62584
|
* text, or the markup of a `<template>` it holds, without the indentation the
|
|
@@ -62108,6 +62589,14 @@ export type CustomElements = {
|
|
|
62108
62589
|
*
|
|
62109
62590
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
62110
62591
|
*
|
|
62592
|
+
* - `close-brackets`/`closeBrackets`: Whether typing an opening bracket or quote types its closing one too, and
|
|
62593
|
+
* a bracket typed with text selected goes around it.
|
|
62594
|
+
* - `complete`: Whether the pane offers completions for the word before the caret, from
|
|
62595
|
+
* the words of the source and of `completions`.
|
|
62596
|
+
* - `completions`: Words the pane offers under `complete` beside the words of the source,
|
|
62597
|
+
* such as tag and attribute names. `manifestWords` reads them from a custom
|
|
62598
|
+
* elements manifest. Set it as JSON in the attribute or as an array.
|
|
62599
|
+
* - `completions-label`/`completionsLabel`: The name of the list of completions, read by screen readers.
|
|
62111
62600
|
* - `field-label`/`fieldLabel`: The editable region's name, read by screen readers.
|
|
62112
62601
|
* - `field-name-label`/`fieldNameLabel`: The editable region's name where the pane has a `label`, so each file's
|
|
62113
62602
|
* field says which file it holds. `{field}` is `field-label` and `{name}`
|
|
@@ -62116,12 +62605,17 @@ export type CustomElements = {
|
|
|
62116
62605
|
* - `label`: The pane's file name, such as `index.html`, on its tab where a sandbox
|
|
62117
62606
|
* holds several panes. Empty puts the pane's `name` on the tab.
|
|
62118
62607
|
* - `line-numbers`/`lineNumbers`: Whether each line of the source is numbered, in a gutter beside it.
|
|
62608
|
+
* - `match-brackets`/`matchBrackets`: Whether the bracket beside the caret and its pair are marked while the
|
|
62609
|
+
* field has focus.
|
|
62119
62610
|
* - `name`: Which source this pane holds. Every `helix-before-edit` event includes it.
|
|
62120
62611
|
*
|
|
62121
62612
|
* `html` and `css` are what the sandbox root routes on; any other name is
|
|
62122
62613
|
* passed through untouched for a consumer wiring their own panes.
|
|
62123
62614
|
*
|
|
62124
62615
|
* Not reflected: nothing selects on it, so it keeps a real default instead.
|
|
62616
|
+
* - `readonly`/`readOnly`: Whether the source is read only: it can be selected and copied, and not
|
|
62617
|
+
* edited, as Sandpack's `readOnly` file is. Tab moves focus out of a field
|
|
62618
|
+
* that is read only.
|
|
62125
62619
|
* - `tab-indents`/`tabIndents`: Whether Tab indents the source. When it is off, Tab moves focus.
|
|
62126
62620
|
* - `value`: The source being edited.
|
|
62127
62621
|
* - `tokenize`: Colors the source: a function from the source and the pane's `name` to
|
|
@@ -62135,6 +62629,8 @@ export type CustomElements = {
|
|
|
62135
62629
|
*
|
|
62136
62630
|
* Named for what it returns, runs of text, where Code Block's `highlight`
|
|
62137
62631
|
* returns markup. (property only)
|
|
62632
|
+
* - `modified`: Whether the source differs from the source the pane was given: its first
|
|
62633
|
+
* `value`, or the last one set from outside. (property only) (readonly)
|
|
62138
62634
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
62139
62635
|
*
|
|
62140
62636
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -62164,13 +62660,23 @@ export type CustomElements = {
|
|
|
62164
62660
|
* - `helix-caret`: Fired when the cursor moves.
|
|
62165
62661
|
* - `helix-edit`: Fired after the source was edited, with the new source.
|
|
62166
62662
|
*
|
|
62663
|
+
* ## Methods
|
|
62664
|
+
*
|
|
62665
|
+
* Methods that can be called to access component functionality.
|
|
62666
|
+
*
|
|
62667
|
+
* - `reset() => void`: Puts back the source the pane was given, as an edit: `helix-before-edit`
|
|
62668
|
+
* is sent first and can refuse it, and the sandbox passes it to its preview.
|
|
62669
|
+
*
|
|
62167
62670
|
* ## CSS Custom Properties
|
|
62168
62671
|
*
|
|
62169
62672
|
* CSS variables available for styling the component.
|
|
62170
62673
|
*
|
|
62171
62674
|
* - `--sandbox-source-background-color`: Fill behind the source.
|
|
62675
|
+
* - `--sandbox-source-bracket-color`: Fill behind a matched bracket, under `match-brackets`. Defaults to `--helix-color-accent-subtle`.
|
|
62172
62676
|
* - `--sandbox-source-callable-color`: Color of a `callable` run, under `tokenize`. Defaults to `--helix-color-syntax-callable`.
|
|
62173
62677
|
* - `--sandbox-source-comment-color`: Color of a `comment` run, under `tokenize`. Defaults to `--helix-color-syntax-comment`.
|
|
62678
|
+
* - `--sandbox-source-completions-border-width`: Width of the edge of the list of completions, under `complete`. Defaults to `--helix-border-floating`.
|
|
62679
|
+
* - `--sandbox-source-completions-shadow`: Shadow under the list of completions, under `complete`. Defaults to `--helix-shadow-floating`.
|
|
62174
62680
|
* - `--sandbox-source-constant-color`: Color of a `constant` run, under `tokenize`. Defaults to `--helix-color-syntax-constant`.
|
|
62175
62681
|
* - `--sandbox-source-invalid-color`: Color of an `invalid` run, under `tokenize`. Defaults to `--helix-color-syntax-invalid`.
|
|
62176
62682
|
* - `--sandbox-source-keyword-color`: Color of a `keyword` run, under `tokenize`. Defaults to `--helix-color-syntax-keyword`.
|
|
@@ -62184,8 +62690,13 @@ export type CustomElements = {
|
|
|
62184
62690
|
*
|
|
62185
62691
|
* Custom selectors for styling elements within the component.
|
|
62186
62692
|
*
|
|
62187
|
-
* - `
|
|
62188
|
-
* - `
|
|
62693
|
+
* - `bracket`: The bracket beside the caret and its pair, under `match-brackets`.
|
|
62694
|
+
* - `bracket-unmatched`: A bracket beside the caret with no pair, under `match-brackets`.
|
|
62695
|
+
* - `completion`: One word in the list of completions, under `complete`.
|
|
62696
|
+
* - `completion-active`: The word chosen in that list, which Enter or Tab takes.
|
|
62697
|
+
* - `completions`: The list of completions under the word being typed, under `complete`.
|
|
62698
|
+
* - `field`: The box that scrolls the field and its colors together, under `tokenize`, `line-numbers`, `match-brackets` or `complete`.
|
|
62699
|
+
* - `highlight`: The colored copy of the source drawn under the field, under `tokenize`, `line-numbers`, `match-brackets` or `complete`.
|
|
62189
62700
|
* - `line`: One line of that copy, under `line-numbers`, numbered in the gutter by its `::before`.
|
|
62190
62701
|
* - `source`: The editable region.
|
|
62191
62702
|
* - `token`: One run of the source that has a kind, under `tokenize`.
|
|
@@ -62194,6 +62705,7 @@ export type CustomElements = {
|
|
|
62194
62705
|
*
|
|
62195
62706
|
* These can be used to apply styling when a component is in a given state.
|
|
62196
62707
|
*
|
|
62708
|
+
* - `modified`: While the source differs from the source the pane was given, until `reset()` or a new `value`.
|
|
62197
62709
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
62198
62710
|
*/
|
|
62199
62711
|
"helix-sandbox-source": Partial<
|
|
@@ -64350,6 +64862,12 @@ export type CustomElements = {
|
|
|
64350
64862
|
* that should survive its own collapse says how much of itself to keep, and
|
|
64351
64863
|
* only whoever put it there knows that, which is the same reason `min` is a
|
|
64352
64864
|
* consumer's to set.
|
|
64865
|
+
* - `collapsible`: Which panes can be collapsed, as Zag's panels each take `collapsible`:
|
|
64866
|
+
* `start`, `end`, `both`, or `none`. A pane that cannot be collapsed stops
|
|
64867
|
+
* at the edge without shutting. `Enter` collapses the end pane where only
|
|
64868
|
+
* the end pane can be collapsed, and the start pane otherwise.
|
|
64869
|
+
*
|
|
64870
|
+
* Unset is `both`, and the attribute stays absent until you write it.
|
|
64353
64871
|
* - `corner-label`/`cornerLabel`: The name of the handle where two dividers cross, read by screen readers.
|
|
64354
64872
|
* - `corner-value-label`/`cornerValueLabel`: What the handle where two dividers cross says it is set to, both dividers
|
|
64355
64873
|
* at once: `{across}` is where the divider that runs down stands, and
|
|
@@ -64360,6 +64878,11 @@ export type CustomElements = {
|
|
|
64360
64878
|
* these words are the whole of where it is.
|
|
64361
64879
|
* - `default-collapsed`/`defaultCollapsed`: Which pane starts shut, when `collapsed` is not set.
|
|
64362
64880
|
* - `default-position`/`defaultPosition`: Where the divider starts, when `position` is not set.
|
|
64881
|
+
* - `end-min`/`endMin`: The least the end pane keeps, in the units `min` takes: a percentage, or
|
|
64882
|
+
* a CSS length such as `16rem` resolved against the splitter's box. The
|
|
64883
|
+
* divider stops that far from the end, whatever `max` allows, so `min` and
|
|
64884
|
+
* `end-min` hold a minimum for each pane, as Zag's panels each take
|
|
64885
|
+
* `minSize`.
|
|
64363
64886
|
* - `label`: The divider's name, read by screen readers.
|
|
64364
64887
|
*
|
|
64365
64888
|
* An `aria-label` or `aria-labelledby` on the host names the divider too,
|
|
@@ -64966,16 +65489,16 @@ export type CustomElements = {
|
|
|
64966
65489
|
* roll over one another, and light runs along them.
|
|
64967
65490
|
*
|
|
64968
65491
|
* Its palette comes from the tokens. The strands are `--helix-color-primary`,
|
|
64969
|
-
* a few are `--helix-color-
|
|
65492
|
+
* a few are `--helix-color-accent` for depth, and the page they light is
|
|
64970
65493
|
* `--helix-color-background`. On a light page the light becomes ink, because
|
|
64971
65494
|
* light added to near-white cannot be seen.
|
|
64972
65495
|
*
|
|
64973
|
-
* **Three forms, set with `variant`.** `
|
|
65496
|
+
* **Three forms, set with `variant`.** `bend` turns bright strands through one tight point, with its
|
|
64974
65497
|
* arms opening to the right. `ribbon`, the default, is a broad, soft ribbon in
|
|
64975
65498
|
* long curves. `waves` is sharp strands crossing the full width.
|
|
64976
65499
|
*
|
|
64977
65500
|
* **In its own box, by default.** The element fills the box it is given, the
|
|
64978
|
-
* way an image does, and `at` places the
|
|
65501
|
+
* way an image does, and `at` places the bend's apex or the ribbon's axis across
|
|
64979
65502
|
* it. Content placed inside sits over the ribbon, in the `content` part.
|
|
64980
65503
|
*
|
|
64981
65504
|
* **Down the whole page, with `travel`.** The element fixes itself behind the
|
|
@@ -64983,8 +65506,9 @@ export type CustomElements = {
|
|
|
64983
65506
|
* bottom, so scrolling travels along it. Put `helix-strands-stop` elements
|
|
64984
65507
|
* inside to pin a form to a section: each names an element with `for` and says
|
|
64985
65508
|
* which form the ribbon takes there. Between stops the ribbon fills the gap in
|
|
64986
|
-
* its own `variant`, and between two waves
|
|
64987
|
-
* reads alone. Set `z-index` on the
|
|
65509
|
+
* its own `variant`, and between two waves less than a screen and a half
|
|
65510
|
+
* apart it turns off screen so each wave reads alone. Set `z-index` on the
|
|
65511
|
+
* element to move it.
|
|
64988
65512
|
*
|
|
64989
65513
|
* The ribbon stops moving in these cases:
|
|
64990
65514
|
* - `prefers-reduced-motion` is set. The element shows one still frame, and in
|
|
@@ -65004,20 +65528,35 @@ export type CustomElements = {
|
|
|
65004
65528
|
*
|
|
65005
65529
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
65006
65530
|
*
|
|
65007
|
-
* - `at`: Where the form sits across the box, as a share of the width: the
|
|
65008
|
-
*
|
|
65009
|
-
* crosses the whole width and does not read it. Unset, a
|
|
65531
|
+
* - `at`: Where the form sits across the box, as a share of the width: the bend's
|
|
65532
|
+
* apex or the ribbon's axis. `0` is the left edge and `1` the right. A wave
|
|
65533
|
+
* crosses the whole width and does not read it. Unset, a bend's apex sits at `0.5`
|
|
65010
65534
|
* and a ribbon runs down the middle.
|
|
65011
65535
|
*
|
|
65012
65536
|
* **A share rather than a length**, so the ribbon keeps its place when the
|
|
65013
65537
|
* box changes shape. Read inside a box only; in `travel` each stop has its
|
|
65014
65538
|
* own.
|
|
65539
|
+
* - `bloom`: How much the glow around the strands adds, as a multiplier. `0` draws the
|
|
65540
|
+
* strands alone, crisp and dimmer, and `1` is the default glow.
|
|
65541
|
+
* - `contrast`: How far apart the brightest and dimmest strands are, from `0`, most of
|
|
65542
|
+
* them alike, to `1`, a few burning bright over many faint ones. Clamped to
|
|
65543
|
+
* that range. The ribbon as a whole keeps its strength.
|
|
65015
65544
|
* - `density`: How many strands the ribbon has, from `0`, sixty, to `1`, three hundred and
|
|
65016
65545
|
* forty. Clamped to that range.
|
|
65546
|
+
* - `depth`: How much the ribbon's depth shows, from `0`, flat, to `1`. Clamped to that
|
|
65547
|
+
* range. The strands at the front of the ribbon's roll are drawn thicker,
|
|
65548
|
+
* brighter, and further from its axis, and those at the back thinner, dimmer,
|
|
65549
|
+
* and out of focus.
|
|
65550
|
+
* - `drift`: How differently each strand moves, from `0`, the whole ribbon rolling and
|
|
65551
|
+
* waving as one, to `1`, each strand at its own pace and angle, crossing
|
|
65552
|
+
* over the others. Clamped to that range.
|
|
65553
|
+
* - `dust`: How many specks of dust drift around the strands, as a multiplier: `0`
|
|
65554
|
+
* draws none, `1` six hundred, and `4`, the most, two thousand four
|
|
65555
|
+
* hundred. They gather where the ribbon is brightest.
|
|
65017
65556
|
* - `gain`: Overall brightness, as a multiplier on the light.
|
|
65018
65557
|
* - `softness`: The share of strands drawn out of focus where the ribbon is wide, from `0`,
|
|
65019
65558
|
* every strand sharp, to `1`, every one soft. Clamped to that range. A tight
|
|
65020
|
-
* form, such as a
|
|
65559
|
+
* form, such as a bend's apex or a wave, stays sharp whatever this says.
|
|
65021
65560
|
* - `speed`: How fast the ribbon moves, as a multiplier on time. `0` holds it still.
|
|
65022
65561
|
* - `spread`: How wide the ribbon is, as a multiplier on each form's own width.
|
|
65023
65562
|
* - `travel`: Whether the ribbon is laid down the whole page, so scrolling travels along
|
|
@@ -65067,7 +65606,7 @@ export type CustomElements = {
|
|
|
65067
65606
|
* - `--strands-glow`: The color of most strands. Defaults to `--helix-color-primary`.
|
|
65068
65607
|
* - `--strands-ground`: The page the light is added to. Defaults to `--helix-color-background`.
|
|
65069
65608
|
* - `--strands-peak`: The hottest strands, and on a light page the ink the light darkens toward. Defaults to `--helix-color-primary-hover` on a dark page and `--helix-color-primary-active` on a light one.
|
|
65070
|
-
* - `--strands-tint`: The color of a few strands, for depth. Defaults to `--helix-color-
|
|
65609
|
+
* - `--strands-tint`: The color of a few strands, for depth. Defaults to `--helix-color-accent`, which is the primary itself unless the theme relates an accent to the brand, as `accent: { from: 'brand', rotate: 40 }` does.
|
|
65071
65610
|
*
|
|
65072
65611
|
* ## CSS Parts
|
|
65073
65612
|
*
|
|
@@ -65089,8 +65628,8 @@ export type CustomElements = {
|
|
|
65089
65628
|
|
|
65090
65629
|
/**
|
|
65091
65630
|
* Placed inside a `helix-strands` with `travel`, a stop names an element with
|
|
65092
|
-
* `for` and says which form the ribbon takes when the page reaches it: a `
|
|
65093
|
-
*
|
|
65631
|
+
* `for` and says which form the ribbon takes when the page reaches it: a `bend`
|
|
65632
|
+
* turning through it, a `ribbon` passing through `at`, or `waves` crossing at
|
|
65094
65633
|
* its top edge. The stops are read in page order, whatever order they are
|
|
65095
65634
|
* written in, and a stop naming no element is skipped.
|
|
65096
65635
|
*
|
|
@@ -65105,9 +65644,9 @@ export type CustomElements = {
|
|
|
65105
65644
|
*
|
|
65106
65645
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
65107
65646
|
*
|
|
65108
|
-
* - `at`: Where the form sits across the page, as a share of the width: the
|
|
65109
|
-
*
|
|
65110
|
-
* read it. Unset, a
|
|
65647
|
+
* - `at`: Where the form sits across the page, as a share of the width: the bend's
|
|
65648
|
+
* apex or the ribbon's axis. A wave crosses the whole width and does not
|
|
65649
|
+
* read it. Unset, a bend's apex sits at `0.5` and a ribbon runs down the middle.
|
|
65111
65650
|
* - `for`: The id of the element the form is pinned to, in the same tree as the stop.
|
|
65112
65651
|
* - `variant`: The form the ribbon takes at the element. When it is not set, the form is `ribbon`.
|
|
65113
65652
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
@@ -66583,6 +67122,7 @@ export type CustomElements = {
|
|
|
66583
67122
|
*
|
|
66584
67123
|
* These can be used to apply styling when a component is in a given state.
|
|
66585
67124
|
*
|
|
67125
|
+
* - `focus-visible`: The tag's cell has keyboard focus that the browser shows, in a `Tag.Group`.
|
|
66586
67126
|
* - `selected`: The tag is selected in a `Tag.Group` that selects.
|
|
66587
67127
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
66588
67128
|
*/
|
|
@@ -67634,6 +68174,17 @@ export type CustomElements = {
|
|
|
67634
68174
|
* imperatively later, and nothing is hydrating by then.
|
|
67635
68175
|
*
|
|
67636
68176
|
* Here rather than on each control.
|
|
68177
|
+
* - `timeContent`: What each time in the list shows: a function given the time as `HH:mm`,
|
|
68178
|
+
* or `HH:mm:ss` with `seconds`, and the time as the row writes it, that
|
|
68179
|
+
* returns text, an element or a Lit template.
|
|
68180
|
+
*
|
|
68181
|
+
* For the seats left at a time, or a caption under it, as React Aria's
|
|
68182
|
+
* `ListBoxItem` takes children. Content with `slot="start"`, `slot="end"`
|
|
68183
|
+
* or `slot="description"` goes to that slot of the row, and a description
|
|
68184
|
+
* is read after the time. The row is still named by the written time, and
|
|
68185
|
+
* typeahead still finds it by that. Return the written time with your
|
|
68186
|
+
* content where it should still show. A property only, there being no way
|
|
68187
|
+
* to write a function in markup. The wheels draw their own figures. (property only)
|
|
67637
68188
|
* - `valueAsDate`: The value as a `Date` on 1 January 1970 UTC, or `null` while there is no time.
|
|
67638
68189
|
*
|
|
67639
68190
|
* The platform's own pair on `<input type="time">`, epoch day included: a time
|
|
@@ -68040,6 +68591,9 @@ export type CustomElements = {
|
|
|
68040
68591
|
* - `orientation`: Which way time runs: `horizontal` lays the entries across the page. Unset,
|
|
68041
68592
|
* they run down it.
|
|
68042
68593
|
* - `label`: Accessible name for the timeline, for people who reach it out of context.
|
|
68594
|
+
* - `loading`: Marks the timeline as busy fetching more entries, and draws an entry
|
|
68595
|
+
* after the last that says so.
|
|
68596
|
+
* - `loading-label`/`loadingLabel`: The text of the entry drawn while `loading` is set, where the `loading` slot is empty.
|
|
68043
68597
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
68044
68598
|
*
|
|
68045
68599
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -68066,6 +68620,7 @@ export type CustomElements = {
|
|
|
68066
68620
|
* Areas where markup can be added to the component.
|
|
68067
68621
|
*
|
|
68068
68622
|
* - `(default)`: The entries, and any groups of them.
|
|
68623
|
+
* - `loading`: Content for the entry after the last while `loading` is set. Falls back to `loading-label`.
|
|
68069
68624
|
*
|
|
68070
68625
|
* ## CSS Custom Properties
|
|
68071
68626
|
*
|
|
@@ -68073,10 +68628,17 @@ export type CustomElements = {
|
|
|
68073
68628
|
*
|
|
68074
68629
|
* - `--timeline-gap`: Space between one entry and the next.
|
|
68075
68630
|
*
|
|
68631
|
+
* ## CSS Parts
|
|
68632
|
+
*
|
|
68633
|
+
* Custom selectors for styling elements within the component.
|
|
68634
|
+
*
|
|
68635
|
+
* - `loading`: The entry after the last while `loading` is set.
|
|
68636
|
+
*
|
|
68076
68637
|
* ## CSS States
|
|
68077
68638
|
*
|
|
68078
68639
|
* These can be used to apply styling when a component is in a given state.
|
|
68079
68640
|
*
|
|
68641
|
+
* - `loading`: While `loading` is set.
|
|
68080
68642
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
68081
68643
|
*/
|
|
68082
68644
|
"helix-timeline": Partial<
|
|
@@ -70761,6 +71323,12 @@ export type CustomElements = {
|
|
|
70761
71323
|
* and scrolls it sideways: Left and Right move between items, the other
|
|
70762
71324
|
* way round on a right-to-left page, and `estimate` is an item's width. A
|
|
70763
71325
|
* grid always runs down.
|
|
71326
|
+
* - `reorderable`: Lets a reader move items, once `@fusion.dev/helix/virtual-list/reorder`
|
|
71327
|
+
* (or `@fusion.dev/helix-headless/virtual-list/reorder`) is imported: Alt
|
|
71328
|
+
* with an arrow moves the row the keys are on, and a pointer drags a row.
|
|
71329
|
+
* The list moves no item itself: you move your `items` on `helix-reorder`.
|
|
71330
|
+
* Without that import it does nothing, so a list that never moves items
|
|
71331
|
+
* carries none of the code. A list of one column, without sections.
|
|
70764
71332
|
* - `section-field`/`sectionField`: The field of each item that names its section, as a key or a path of
|
|
70765
71333
|
* keys. Set, the items are drawn in sections: a header, then the items, in
|
|
70766
71334
|
* an element with the `group` role that the header names. A section starts
|
|
@@ -70823,8 +71391,10 @@ export type CustomElements = {
|
|
|
70823
71391
|
*
|
|
70824
71392
|
* - `change`: Fired once a press or a key has changed which items are selected, in a list with `selection-mode`.
|
|
70825
71393
|
* - `helix-before-change`: Fired before a press or a key changes which items are selected, with the `value` it would leave. Cancelable.
|
|
71394
|
+
* - `helix-before-reorder`: Fired when an item is dropped at a new place, in a `reorderable` list with `@fusion.dev/helix/virtual-list/reorder` imported, with every key in the new order. Cancelable: cancel it to keep the item where it is.
|
|
70826
71395
|
* - `helix-load-more`: Fired when a reader comes within one screen of the last item, once for each length of the set.
|
|
70827
71396
|
* - `helix-range-change`: Fired when the items on screen change, with the new `first` and `last`, which `range` also holds.
|
|
71397
|
+
* - `helix-reorder`: Fired after `helix-before-reorder` when nobody canceled it. Set `items` to the order in `keys`. Cancelable: cancel it to say the move did not happen.
|
|
70828
71398
|
*
|
|
70829
71399
|
* ## Slots
|
|
70830
71400
|
*
|
|
@@ -70850,6 +71420,15 @@ export type CustomElements = {
|
|
|
70850
71420
|
*
|
|
70851
71421
|
* - `--virtual-list-block-size`: How tall the scrolling box is. A list that runs across is as tall as its rows unless you set it.
|
|
70852
71422
|
* - `--virtual-list-disabled-opacity`: How faint a row `disabled-keys` names is drawn.
|
|
71423
|
+
* - `--virtual-list-drag-preview-background-color`: The fill behind the copy of a row a pointer drags, in a `reorderable` list with `@fusion.dev/helix/virtual-list/reorder` imported.
|
|
71424
|
+
* - `--virtual-list-drag-preview-border-color`: The color of the edge around the copy of a row a pointer drags.
|
|
71425
|
+
* - `--virtual-list-drag-preview-border-width`: The width of the edge around the copy of a row a pointer drags. None by default, where the shadow lifts it.
|
|
71426
|
+
* - `--virtual-list-drag-preview-opacity`: The opacity of the copy of a row a pointer drags.
|
|
71427
|
+
* - `--virtual-list-drag-preview-radius`: The corner radius of the copy of a row a pointer drags.
|
|
71428
|
+
* - `--virtual-list-drag-preview-shadow`: The shadow that raises the copy of a row a pointer drags over the page.
|
|
71429
|
+
* - `--virtual-list-dragging-opacity`: The opacity of a row being dragged, in a `reorderable` list with `@fusion.dev/helix/virtual-list/reorder` imported.
|
|
71430
|
+
* - `--virtual-list-drop-indicator-color`: The color of the line where a dragged row would land.
|
|
71431
|
+
* - `--virtual-list-drop-indicator-size`: The thickness of the line where a dragged row would land.
|
|
70853
71432
|
* - `--virtual-list-empty-color`: The color of the text in the row shown when there are no items.
|
|
70854
71433
|
* - `--virtual-list-empty-padding`: The space around the text in the row shown when there are no items.
|
|
70855
71434
|
* - `--virtual-list-loading-color`: The color of the text in the row drawn while `loading` is set.
|
|
@@ -73159,6 +73738,8 @@ export type CustomElementsSolidJs = {
|
|
|
73159
73738
|
* separate actions. The semantics and the joining are separate questions:
|
|
73160
73739
|
* `role="group"` and a shared name are what make a set of buttons a set, and
|
|
73161
73740
|
* `helix-flex` gives the spacing without the group.
|
|
73741
|
+
* - `disabled`: Disables every button in the group, and says so on the group with
|
|
73742
|
+
* `aria-disabled`. Reflected, so a stylesheet can select on it.
|
|
73162
73743
|
* - `disallow-empty-selection`/`disallowEmptySelection`: Keeps at least one button pressed once one is, as React Aria's
|
|
73163
73744
|
* `disallowEmptySelection`: a press that would leave none pressed is
|
|
73164
73745
|
* refused.
|
|
@@ -73193,6 +73774,8 @@ export type CustomElementsSolidJs = {
|
|
|
73193
73774
|
*
|
|
73194
73775
|
* The attribute is the seed, and a press changes the property, which does
|
|
73195
73776
|
* not reflect, as a native control's `value` does not.
|
|
73777
|
+
* - `values`: The pressed values as a list, in a selection mode, and an empty list
|
|
73778
|
+
* otherwise. Written, it presses exactly those buttons. (property only)
|
|
73196
73779
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
73197
73780
|
*
|
|
73198
73781
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -74112,6 +74695,8 @@ export type CustomElementsSolidJs = {
|
|
|
74112
74695
|
* Third", rather than with a comma this component chose.
|
|
74113
74696
|
* - `linked-label`/`linkedLabel`: The text read with a card that has connections both ways. `{leadsTo}` is
|
|
74114
74697
|
* `leads-to-label` and `{comesFrom}` is `comes-from-label`, each filled in.
|
|
74698
|
+
* - `loading`: Marks the board as busy while its document arrives: the board is
|
|
74699
|
+
* `aria-busy`, and the `loading` slot is shown.
|
|
74115
74700
|
* - `moved-label`/`movedLabel`: What screen readers hear after a key moves a card, with `{name}` for the
|
|
74116
74701
|
* card and `{x}` and `{y}` for where it now is, in the document's units.
|
|
74117
74702
|
*
|
|
@@ -74277,6 +74862,7 @@ export type CustomElementsSolidJs = {
|
|
|
74277
74862
|
* - `footer`: Content below the board.
|
|
74278
74863
|
* - `fullscreen-icon`: Replaces the glyph inside the fullscreen button.
|
|
74279
74864
|
* - `header`: Content above the board.
|
|
74865
|
+
* - `loading`: Content shown while `loading` is set, such as a progress bar while the document arrives.
|
|
74280
74866
|
* - `pan-down-icon`: Replaces the glyph inside the pan down button.
|
|
74281
74867
|
* - `pan-end-icon`: Replaces the glyph inside the button that pans toward the end of a line of text.
|
|
74282
74868
|
* - `pan-start-icon`: Replaces the glyph inside the button that pans toward the start of a line of text.
|
|
@@ -74399,6 +74985,7 @@ export type CustomElementsSolidJs = {
|
|
|
74399
74985
|
* - `fullscreen`: While the board fills the screen.
|
|
74400
74986
|
* - `holding`: An item picked up with a click follows the pointer until the next press puts it down.
|
|
74401
74987
|
* - `idle`: The user has been still for `idle-delay` milliseconds. The board's own controls stay; select on it to hide chrome of your own.
|
|
74988
|
+
* - `loading`: While `loading` is set.
|
|
74402
74989
|
* - `pressing`: While a press on the board, its cards or its connections is under way.
|
|
74403
74990
|
* - `sharing`: The page keeps the plain wheel and one finger, with `gestures="cooperative"` or while a board with `gestures="activate"` waits to be pressed.
|
|
74404
74991
|
* - `using`: A board with `gestures="activate"` has been pressed and has the gestures.
|
|
@@ -77738,6 +78325,15 @@ export type CustomElementsSolidJs = {
|
|
|
77738
78325
|
* Defaulted rather than left empty. An icon-only control must be named, and
|
|
77739
78326
|
* the name of this one is not a judgment call: every copy button in the
|
|
77740
78327
|
* world is called Copy. A consumer with a better word still sets it.
|
|
78328
|
+
* - `show-label`/`showLabel`: Draws the name as words beside the icon, and the result in their place
|
|
78329
|
+
* after a press. The button stays as wide as the longest of them.
|
|
78330
|
+
* - `tooltip`: When the tooltip shows: `full` on hover and focus and after a press,
|
|
78331
|
+
* `copy` only after a press, to show the result, and `none` never, for a
|
|
78332
|
+
* button whose result shows another way, such as under `show-label`.
|
|
78333
|
+
*
|
|
78334
|
+
* Unset is `full`, and the attribute stays absent until you write it.
|
|
78335
|
+
* - `tooltip-placement`/`tooltipPlacement`: The side the tooltip prefers. It moves to another side where this one
|
|
78336
|
+
* does not fit.
|
|
77741
78337
|
* - `value`: The text copied to the clipboard.
|
|
77742
78338
|
*
|
|
77743
78339
|
* It replaces `Button.value`, the submit value: a copy button never submits,
|
|
@@ -77921,6 +78517,7 @@ export type CustomElementsSolidJs = {
|
|
|
77921
78517
|
* - `live`: The live region that says `copied-label` or `error-label` after a press, and `pending-label` when the button becomes pending under focus. It is rendered from the first time it says anything.
|
|
77922
78518
|
* - `mark`: The clipboard icon, and the confirmation icon that replaces it.
|
|
77923
78519
|
* - `spinner`: The ring a pending button turns, an empty element the styled button draws over the icon. It is rendered only while the button is pending.
|
|
78520
|
+
* - `text`: The words beside the icon, under `show-label`. It holds all three, `label`, `copied-label` and `error-label`, with all but the current one hidden.
|
|
77924
78521
|
* - `tooltip`: The tooltip bubble, forwarded from the tooltip inside the button.
|
|
77925
78522
|
* - `tooltip-arrow`: The tooltip's arrow, which points at the button.
|
|
77926
78523
|
* - `tooltip-arrow-bottom`: The arrow while the bubble is below the button, on the bubble's top edge. Set together with `tooltip-arrow`.
|
|
@@ -82130,6 +82727,9 @@ export type CustomElementsSolidJs = {
|
|
|
82130
82727
|
* - `linked-both-label`/`linkedBothLabel`: How a note linked both to and from the selected one is described, with `{note}`.
|
|
82131
82728
|
* - `linked-from-label`/`linkedFromLabel`: How a note the selected one links to is described, with `{note}`, the selected note's name.
|
|
82132
82729
|
* - `links-to-label`/`linksToLabel`: How a note that links to the selected one is described, with `{note}`.
|
|
82730
|
+
* - `loading`: Marks the graph as busy while its notes arrive: the list is `aria-busy`,
|
|
82731
|
+
* and the panel says so where it holds no notes yet.
|
|
82732
|
+
* - `loading-label`/`loadingLabel`: What the panel says while `loading` is set and the list holds no notes.
|
|
82133
82733
|
* - `moved-down-label`/`movedDownLabel`: What screen readers hear once the drawing has moved down, after `moved()`.
|
|
82134
82734
|
* - `moved-left-label`/`movedLeftLabel`: What screen readers hear once the drawing has moved left, after `moved()`.
|
|
82135
82735
|
* - `moved-right-label`/`movedRightLabel`: What screen readers hear once the drawing has moved right, after `moved()`.
|
|
@@ -82152,6 +82752,15 @@ export type CustomElementsSolidJs = {
|
|
|
82152
82752
|
* - `hiddenGroups`: The groups turned off in the legend, by name, whose notes neither the drawing nor the list shows. A property, never an attribute. (property only)
|
|
82153
82753
|
* - `links`: The links between notes, each from `source` to `target`. A property, never an attribute. (property only)
|
|
82154
82754
|
* - `nodes`: The notes. A property, never an attribute. (property only)
|
|
82755
|
+
* - `noteContent`: What each note's row in the list shows in place of its name: a function
|
|
82756
|
+
* given the note that returns text, an element or a Lit template.
|
|
82757
|
+
*
|
|
82758
|
+
* For an icon by its kind, or a date under its name, as React Aria's
|
|
82759
|
+
* `ListBoxItem` takes children. The row is still named by the note's name,
|
|
82760
|
+
* which typeahead and the search find it by, and described by how it stands
|
|
82761
|
+
* to the selected note. Return the name with your content where it should
|
|
82762
|
+
* still show. A property only, there being no way to write a function in
|
|
82763
|
+
* markup. (property only)
|
|
82155
82764
|
* - `ready`: Whether the graph has been drawn whole. For code that runs after `helix-graph-ready`. (property only) (readonly)
|
|
82156
82765
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
82157
82766
|
*
|
|
@@ -82198,6 +82807,7 @@ export type CustomElementsSolidJs = {
|
|
|
82198
82807
|
* - `footer`: Content below the graph.
|
|
82199
82808
|
* - `fullscreen-icon`: Replaces the glyph inside the fullscreen button.
|
|
82200
82809
|
* - `header`: Content above the graph.
|
|
82810
|
+
* - `loading`: What the panel shows while `loading` is set and the list holds no notes. Defaults to `loading-label`.
|
|
82201
82811
|
* - `pan-down-icon`: Replaces the glyph inside the pan down button.
|
|
82202
82812
|
* - `pan-end-icon`: Replaces the glyph inside the button that pans toward the end of a line of text.
|
|
82203
82813
|
* - `pan-start-icon`: Replaces the glyph inside the button that pans toward the start of a line of text.
|
|
@@ -82289,6 +82899,7 @@ export type CustomElementsSolidJs = {
|
|
|
82289
82899
|
* - `legend-swatch`: The mark in a group's color, before its name.
|
|
82290
82900
|
* - `list`: The list of notes, which draws only the rows in view.
|
|
82291
82901
|
* - `live`: What screen readers hear: how many notes there are when a search or the legend changes it, and which way the drawing went after a key or a control moved it.
|
|
82902
|
+
* - `loading`: The box in place of the list while `loading` is set and it holds no notes, holding the `loading` slot.
|
|
82292
82903
|
* - `note`: One note in the list.
|
|
82293
82904
|
* - `note-cursor`: The note the keyboard is on in the list.
|
|
82294
82905
|
* - `note-linked`: A note linked to or from the selected one.
|
|
@@ -82316,6 +82927,7 @@ export type CustomElementsSolidJs = {
|
|
|
82316
82927
|
* - `empty`: The list holds no notes: the graph has none, or a search or the groups hid them all.
|
|
82317
82928
|
* - `fullscreen`: The graph fills the screen.
|
|
82318
82929
|
* - `idle`: The user has been still long enough for the header and footer to fade.
|
|
82930
|
+
* - `loading`: While `loading` is set.
|
|
82319
82931
|
* - `local`: The drawing shows the selected note's local graph, with `depth`.
|
|
82320
82932
|
* - `panel-open`: A graph with `no-panel` has the search and the list open over the drawing.
|
|
82321
82933
|
* - `ready`: The graph has been drawn whole, after `helix-graph-ready`.
|
|
@@ -84943,7 +85555,8 @@ export type CustomElementsSolidJs = {
|
|
|
84943
85555
|
* itself.
|
|
84944
85556
|
* - `value`: The selected rows' values, separated by commas with no spaces, such as `a,c`, in a list that selects.
|
|
84945
85557
|
*
|
|
84946
|
-
*
|
|
85558
|
+
* A press or a key writes it in row order, as Data Table does, whatever
|
|
85559
|
+
* order the rows were chosen in. Set it to start with rows selected. A row's value is its `value`, or its
|
|
84947
85560
|
* words where it has none.
|
|
84948
85561
|
* - `rows`: The rows the list holds, in order. (property only) (readonly)
|
|
84949
85562
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
@@ -89047,10 +89660,18 @@ export type CustomElementsSolidJs = {
|
|
|
89047
89660
|
*
|
|
89048
89661
|
* The orb is styled only and has behavior, which the tier split does not
|
|
89049
89662
|
* otherwise allow. Its role, name and busy state follow `state`, unless
|
|
89050
|
-
* `announce` makes it a status region, and the rest
|
|
89051
|
-
*
|
|
89052
|
-
*
|
|
89053
|
-
*
|
|
89663
|
+
* `announce` makes it a status region, and the rest is drawing dots to a
|
|
89664
|
+
* canvas.
|
|
89665
|
+
*
|
|
89666
|
+
* **A shape of your own goes in the default slot**, such as an SVG, an
|
|
89667
|
+
* image, or an animation. The orb draws it over its box in place of the dots
|
|
89668
|
+
* and stops drawing them, and keeps its role, name, busy state and custom
|
|
89669
|
+
* states, so your stylesheet can change what you slotted by state, such as
|
|
89670
|
+
* `helix-orb:state(working) svg { animation-duration: 1s }`. What you slot is
|
|
89671
|
+
* for the eye: a screen reader hears the orb's name.
|
|
89672
|
+
*
|
|
89673
|
+
* `--orb-speed` scales how fast the dots move, so `0.5` is a calmer orb at
|
|
89674
|
+
* half the tempo.
|
|
89054
89675
|
*
|
|
89055
89676
|
* Each state is also a custom state, such as `:state(thinking)` or
|
|
89056
89677
|
* `:state(done)`, so a page can style what sits around an orb by what it shows,
|
|
@@ -89132,6 +89753,12 @@ export type CustomElementsSolidJs = {
|
|
|
89132
89753
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
89133
89754
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
89134
89755
|
*
|
|
89756
|
+
* ## Slots
|
|
89757
|
+
*
|
|
89758
|
+
* Areas where markup can be added to the component.
|
|
89759
|
+
*
|
|
89760
|
+
* - `(default)`: A shape of your own, drawn over the orb's box in place of the dots.
|
|
89761
|
+
*
|
|
89135
89762
|
* ## CSS Custom Properties
|
|
89136
89763
|
*
|
|
89137
89764
|
* CSS variables available for styling the component.
|
|
@@ -89139,12 +89766,13 @@ export type CustomElementsSolidJs = {
|
|
|
89139
89766
|
* - `--orb-color`: The color of the nearest dots. Defaults to `currentColor`.
|
|
89140
89767
|
* - `--orb-ground`: The color the farthest dots fade toward. Defaults to the page's background.
|
|
89141
89768
|
* - `--orb-size`: The diameter. Overrides `size`.
|
|
89769
|
+
* - `--orb-speed`: How fast the dots move, as a multiple of each state's own tempo. Defaults to `1`.
|
|
89142
89770
|
*
|
|
89143
89771
|
* ## CSS Parts
|
|
89144
89772
|
*
|
|
89145
89773
|
* Custom selectors for styling elements within the component.
|
|
89146
89774
|
*
|
|
89147
|
-
* - `canvas`: The canvas the dots are drawn on.
|
|
89775
|
+
* - `canvas`: The canvas the dots are drawn on. Hidden while the default slot holds a shape.
|
|
89148
89776
|
* - `live`: The word for the state, which the orb says as it changes when `announce` is set. Rendered only then, and clipped out of view.
|
|
89149
89777
|
*
|
|
89150
89778
|
* ## CSS States
|
|
@@ -89210,6 +89838,9 @@ export type CustomElementsSolidJs = {
|
|
|
89210
89838
|
* box the sections scroll in.
|
|
89211
89839
|
* - `label`: The navigation's name, read by screen readers. A heading in the `heading`
|
|
89212
89840
|
* slot names it in place of this.
|
|
89841
|
+
* - `marks`: Which links are marked. `reading` marks the one section being read, the
|
|
89842
|
+
* last whose heading has passed the reading line. `visible` marks every
|
|
89843
|
+
* section with part of it on screen, and the mark runs across their links.
|
|
89213
89844
|
* - `offset`: How far below the top of the scroll container a heading counts as reached,
|
|
89214
89845
|
* in pixels. The scroll container is the window or the panel the sections
|
|
89215
89846
|
* scroll in.
|
|
@@ -89225,6 +89856,9 @@ export type CustomElementsSolidJs = {
|
|
|
89225
89856
|
* writable property in this library that a component also writes is state a
|
|
89226
89857
|
* consumer can own; this one cannot be, and saying so with the type is better
|
|
89227
89858
|
* than saying it in a sentence nobody reads. (property only) (readonly)
|
|
89859
|
+
* - `marked`: The ids of the sections whose links are marked, in page order: the one
|
|
89860
|
+
* `current` names, or under `marks="visible"` every section on screen.
|
|
89861
|
+
* Read-only, for the reason `current` gives. (property only) (readonly)
|
|
89228
89862
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
89229
89863
|
*
|
|
89230
89864
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -89260,6 +89894,14 @@ export type CustomElementsSolidJs = {
|
|
|
89260
89894
|
* - `heading`: A heading above the links, such as "On this page". It names the navigation.
|
|
89261
89895
|
* - `indicator`: A mark of your own, drawn inside the `indicator` part, where `--indicator-x`, `--indicator-y`, `--indicator-inline-size` and `--indicator-block-size` reach it.
|
|
89262
89896
|
*
|
|
89897
|
+
* ## Methods
|
|
89898
|
+
*
|
|
89899
|
+
* Methods that can be called to access component functionality.
|
|
89900
|
+
*
|
|
89901
|
+
* - `scrollToSection(id: string) => boolean`: Scrolls to the section with this id, as a press on its link does, with
|
|
89902
|
+
* `behavior`, and marks its link at once. The address and focus stay where
|
|
89903
|
+
* they are. Returns whether the outline has a link to that section.
|
|
89904
|
+
*
|
|
89263
89905
|
* ## CSS Custom Properties
|
|
89264
89906
|
*
|
|
89265
89907
|
* CSS variables available for styling the component.
|
|
@@ -91372,6 +92014,16 @@ export type CustomElementsSolidJs = {
|
|
|
91372
92014
|
* since a browser reads one only as a document starts. A `src` document
|
|
91373
92015
|
* declares its own.
|
|
91374
92016
|
*
|
|
92017
|
+
* **`dependencies` names packages by version instead**, as a `package.json`
|
|
92018
|
+
* does: `{"canvas-confetti": "^1.9"}` loads `canvas-confetti` and the paths
|
|
92019
|
+
* under it from `cdn`, `https://esm.sh/` by default, at the version or range
|
|
92020
|
+
* given. An address in `imports` wins over a package of the same name.
|
|
92021
|
+
*
|
|
92022
|
+
* **`modules` holds files the example imports by a relative path**: each path,
|
|
92023
|
+
* such as `utils.js`, to its source, and `import { add } from './utils.js'`
|
|
92024
|
+
* in the `js` pane or in another module loads it. A sandbox writes each pane
|
|
92025
|
+
* named for a module file here.
|
|
92026
|
+
*
|
|
91375
92027
|
* **Examples render in a frame**, so an example's styles and scripts do not
|
|
91376
92028
|
* affect the page around the sandbox, and `position: fixed` stays inside the
|
|
91377
92029
|
* pane. The frame starts empty, with its own stylesheets and its own custom
|
|
@@ -91392,8 +92044,9 @@ export type CustomElementsSolidJs = {
|
|
|
91392
92044
|
*
|
|
91393
92045
|
* **A failed preview shows the error over the example**, in the `error` part,
|
|
91394
92046
|
* until the next source is sent. The terminal says it too, so the part is not
|
|
91395
|
-
* announced
|
|
91396
|
-
*
|
|
92047
|
+
* announced, and it is the frame's description while it shows, so a screen
|
|
92048
|
+
* reader reads it with the frame. Hide it with `::part(error) { display: none }`
|
|
92049
|
+
* where the page draws its own.
|
|
91397
92050
|
*
|
|
91398
92051
|
* **`controls` draws two buttons in the preview's corner**: one reloads the
|
|
91399
92052
|
* frame's document, as `reload()` does, and one opens the example in a new
|
|
@@ -91403,6 +92056,8 @@ export type CustomElementsSolidJs = {
|
|
|
91403
92056
|
*
|
|
91404
92057
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
91405
92058
|
*
|
|
92059
|
+
* - `cdn`: The address the packages in `dependencies` load from, which the name, an
|
|
92060
|
+
* `@` and the version follow.
|
|
91406
92061
|
* - `color-mode`/`colorMode`: The color mode the frame renders in.
|
|
91407
92062
|
*
|
|
91408
92063
|
* **The frame is a document and a document has its own color mode.** Setting
|
|
@@ -91418,6 +92073,10 @@ export type CustomElementsSolidJs = {
|
|
|
91418
92073
|
* including every one of the 24 series colors a chart reads.
|
|
91419
92074
|
* - `controls`: Whether the preview draws a reload button and a button that opens the
|
|
91420
92075
|
* example in a new tab, in its corner.
|
|
92076
|
+
* - `dependencies`: The npm packages an example can import by name in the built-in document,
|
|
92077
|
+
* each name to a version or a range, as a `package.json` lists them. Each
|
|
92078
|
+
* loads from `cdn`. Set it as JSON in the attribute or as an object. Not
|
|
92079
|
+
* read where `src` is set.
|
|
91421
92080
|
* - `direction`: Writing direction inside the frame.
|
|
91422
92081
|
*
|
|
91423
92082
|
* Not reflected. It is payload for the render message and nothing selects on
|
|
@@ -91440,6 +92099,9 @@ export type CustomElementsSolidJs = {
|
|
|
91440
92099
|
* Not reflected, for `direction`'s reason: the placement is applied by the
|
|
91441
92100
|
* document inside the frame, against its own root, so no rule on this side
|
|
91442
92101
|
* could read it.
|
|
92102
|
+
* - `modules`: Module files an example imports by a relative path in the built-in
|
|
92103
|
+
* document, each path, such as `utils.js`, to its source. Not read where
|
|
92104
|
+
* `src` is set.
|
|
91443
92105
|
* - `open-label`/`openLabel`: The name of the button that opens the example in a new tab, under
|
|
91444
92106
|
* `controls`.
|
|
91445
92107
|
* - `reload-label`/`reloadLabel`: The name of the button that reloads the frame's document, under
|
|
@@ -91541,10 +92203,22 @@ export type CustomElementsSolidJs = {
|
|
|
91541
92203
|
* milliseconds by default, so a word typed reloads it once. A pane's text when the sandbox starts reaches it at once.
|
|
91542
92204
|
*
|
|
91543
92205
|
* The event carries the pane's `name`, so one sandbox can hold several panes.
|
|
91544
|
-
*
|
|
91545
|
-
*
|
|
91546
|
-
*
|
|
91547
|
-
*
|
|
92206
|
+
* The names the sandbox writes into its previews:
|
|
92207
|
+
*
|
|
92208
|
+
* - `html` sets the preview's markup.
|
|
92209
|
+
* - `css` sets its stylesheet.
|
|
92210
|
+
* - `js` sets a script that runs as a module after the markup.
|
|
92211
|
+
* - A module file name ending in `.js` or `.mjs`, such as `utils.js`, is a
|
|
92212
|
+
* module the other scripts import by its path, `./utils.js`.
|
|
92213
|
+
* - `package.json` sets the npm packages the scripts import by name, from its
|
|
92214
|
+
* `dependencies`, which load from the preview's `cdn`.
|
|
92215
|
+
*
|
|
92216
|
+
* The sandbox ignores a pane with any other name, so that pane can show
|
|
92217
|
+
* content without changing the preview.
|
|
92218
|
+
*
|
|
92219
|
+
* **The sandbox is `:state(modified)` while a source pane holds an edit**, and
|
|
92220
|
+
* that pane's file tab is also `file-modified` and described as modified to
|
|
92221
|
+
* a screen reader. `reset()` puts every pane back to the source it was given.
|
|
91548
92222
|
*
|
|
91549
92223
|
* **The dividers are two nested `helix-splitter` elements**, which handle the
|
|
91550
92224
|
* pointer, the keyboard, and the corner. The inner splitter holds the panes and
|
|
@@ -91619,6 +92293,8 @@ export type CustomElementsSolidJs = {
|
|
|
91619
92293
|
*
|
|
91620
92294
|
* `split` follows the lead pane rather than the source, so `split="30"` means
|
|
91621
92295
|
* the same thing in both directions: thirty percent to whatever comes first.
|
|
92296
|
+
* - `modified-label`/`modifiedLabel`: The description of a file tab whose pane holds an edit, read by screen
|
|
92297
|
+
* readers after the file's name.
|
|
91622
92298
|
* - `orientation`: Whether the panes sit side by side or stacked.
|
|
91623
92299
|
*
|
|
91624
92300
|
* Not reflected, for `lead`'s reason above: no rule selects on it. The axis
|
|
@@ -91696,6 +92372,15 @@ export type CustomElementsSolidJs = {
|
|
|
91696
92372
|
* - `status`: A status bar, spanning both panes at the bottom.
|
|
91697
92373
|
* - `toolbar`: A bar across the top, spanning both panes.
|
|
91698
92374
|
*
|
|
92375
|
+
* ## Methods
|
|
92376
|
+
*
|
|
92377
|
+
* Methods that can be called to access component functionality.
|
|
92378
|
+
*
|
|
92379
|
+
* - `reset() => void`: Puts every source pane back to the source it was given: through the
|
|
92380
|
+
* pane's own `reset()` where it has one, which sends an edit the previews
|
|
92381
|
+
* take, and otherwise by setting its `value` and writing it into the
|
|
92382
|
+
* previews.
|
|
92383
|
+
*
|
|
91699
92384
|
* ## CSS Custom Properties
|
|
91700
92385
|
*
|
|
91701
92386
|
* CSS variables available for styling the component.
|
|
@@ -91711,6 +92396,7 @@ export type CustomElementsSolidJs = {
|
|
|
91711
92396
|
* - `body`: The splitter holding the panes above the panel. `::part(body):state(dragging)` matches while its divider is held.
|
|
91712
92397
|
* - `corner`: The handle where the two dividers cross.
|
|
91713
92398
|
* - `file`: One file tab, `aria-selected` while its pane is shown.
|
|
92399
|
+
* - `file-modified`: A file tab whose pane holds an edit.
|
|
91714
92400
|
* - `files`: The file tabs over the source panes, where there are several.
|
|
91715
92401
|
* - `pane`: Either pane.
|
|
91716
92402
|
* - `panel`: The box that holds the slotted panel.
|
|
@@ -91721,6 +92407,7 @@ export type CustomElementsSolidJs = {
|
|
|
91721
92407
|
*
|
|
91722
92408
|
* These can be used to apply styling when a component is in a given state.
|
|
91723
92409
|
*
|
|
92410
|
+
* - `modified`: While a source pane holds an edit, until `reset()`.
|
|
91724
92411
|
* - `panel-collapsed`: While there is a panel and it is no taller than `panel-collapsed-size`.
|
|
91725
92412
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
91726
92413
|
*/
|
|
@@ -91755,8 +92442,37 @@ export type CustomElementsSolidJs = {
|
|
|
91755
92442
|
* that wraps keeps one number. The numbers are drawn, and hidden from screen
|
|
91756
92443
|
* readers, which read the field.
|
|
91757
92444
|
*
|
|
91758
|
-
* Enter keeps the indentation of the line it breaks,
|
|
91759
|
-
*
|
|
92445
|
+
* Enter keeps the indentation of the line it breaks, one level deeper after
|
|
92446
|
+
* an opening bracket, and puts the closing bracket of an empty pair on a line
|
|
92447
|
+
* of its own. The new line is undone with the next undo as typing is.
|
|
92448
|
+
*
|
|
92449
|
+
* **The editing keys are CodeMirror's.** Tab with text selected indents every
|
|
92450
|
+
* line the selection touches. `Mod+]` indents the lines and `Mod+[` outdents
|
|
92451
|
+
* them, and `Mod+/` comments them out or back in: `//` in a `js` pane, and one
|
|
92452
|
+
* block comment in an `html` or `css` pane. `Mod` is Command on a Mac and
|
|
92453
|
+
* Control elsewhere. Each is one step of undo.
|
|
92454
|
+
*
|
|
92455
|
+
* **`close-brackets` closes brackets and quotes** as you type them: `(`, `[`,
|
|
92456
|
+
* `{` and the three quotes. A closing character typed before the same one
|
|
92457
|
+
* steps over it, Backspace between an empty pair deletes both, and a bracket
|
|
92458
|
+
* typed with text selected goes around the text. **`match-brackets` marks
|
|
92459
|
+
* the bracket beside the caret and its pair** while the field has focus, each
|
|
92460
|
+
* a `bracket` part, and a bracket with no pair is also `bracket-unmatched`.
|
|
92461
|
+
* A bracket in a string or a comment is not matched, where `tokenize` says
|
|
92462
|
+
* which runs those are.
|
|
92463
|
+
*
|
|
92464
|
+
* **`complete` offers completions as you type**: the words of the source and
|
|
92465
|
+
* of `completions` that start with the word before the caret. They open in a
|
|
92466
|
+
* list under the word. The arrow keys move through it, Enter or Tab takes the
|
|
92467
|
+
* word, and Escape closes it. `Ctrl+Space` opens it where it is closed. The
|
|
92468
|
+
* field is `aria-autocomplete="list"` and points at the word chosen with
|
|
92469
|
+
* `aria-activedescendant`, so a screen reader reads each one. Give
|
|
92470
|
+
* `completions` the names a page uses, such as the tag and attribute names of
|
|
92471
|
+
* a custom elements manifest through `manifestWords`.
|
|
92472
|
+
*
|
|
92473
|
+
* **The pane is `:state(modified)` while its source differs from the source it
|
|
92474
|
+
* was given**, the first `value` or the last one set from outside. `reset()`
|
|
92475
|
+
* puts that source back, as an edit the sandbox passes on to its preview.
|
|
91760
92476
|
*
|
|
91761
92477
|
* **The source can be written inside the pane** where `value` is not set: its
|
|
91762
92478
|
* text, or the markup of a `<template>` it holds, without the indentation the
|
|
@@ -91767,6 +92483,14 @@ export type CustomElementsSolidJs = {
|
|
|
91767
92483
|
*
|
|
91768
92484
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
91769
92485
|
*
|
|
92486
|
+
* - `close-brackets`/`closeBrackets`: Whether typing an opening bracket or quote types its closing one too, and
|
|
92487
|
+
* a bracket typed with text selected goes around it.
|
|
92488
|
+
* - `complete`: Whether the pane offers completions for the word before the caret, from
|
|
92489
|
+
* the words of the source and of `completions`.
|
|
92490
|
+
* - `completions`: Words the pane offers under `complete` beside the words of the source,
|
|
92491
|
+
* such as tag and attribute names. `manifestWords` reads them from a custom
|
|
92492
|
+
* elements manifest. Set it as JSON in the attribute or as an array.
|
|
92493
|
+
* - `completions-label`/`completionsLabel`: The name of the list of completions, read by screen readers.
|
|
91770
92494
|
* - `field-label`/`fieldLabel`: The editable region's name, read by screen readers.
|
|
91771
92495
|
* - `field-name-label`/`fieldNameLabel`: The editable region's name where the pane has a `label`, so each file's
|
|
91772
92496
|
* field says which file it holds. `{field}` is `field-label` and `{name}`
|
|
@@ -91775,12 +92499,17 @@ export type CustomElementsSolidJs = {
|
|
|
91775
92499
|
* - `label`: The pane's file name, such as `index.html`, on its tab where a sandbox
|
|
91776
92500
|
* holds several panes. Empty puts the pane's `name` on the tab.
|
|
91777
92501
|
* - `line-numbers`/`lineNumbers`: Whether each line of the source is numbered, in a gutter beside it.
|
|
92502
|
+
* - `match-brackets`/`matchBrackets`: Whether the bracket beside the caret and its pair are marked while the
|
|
92503
|
+
* field has focus.
|
|
91778
92504
|
* - `name`: Which source this pane holds. Every `helix-before-edit` event includes it.
|
|
91779
92505
|
*
|
|
91780
92506
|
* `html` and `css` are what the sandbox root routes on; any other name is
|
|
91781
92507
|
* passed through untouched for a consumer wiring their own panes.
|
|
91782
92508
|
*
|
|
91783
92509
|
* Not reflected: nothing selects on it, so it keeps a real default instead.
|
|
92510
|
+
* - `readonly`/`readOnly`: Whether the source is read only: it can be selected and copied, and not
|
|
92511
|
+
* edited, as Sandpack's `readOnly` file is. Tab moves focus out of a field
|
|
92512
|
+
* that is read only.
|
|
91784
92513
|
* - `tab-indents`/`tabIndents`: Whether Tab indents the source. When it is off, Tab moves focus.
|
|
91785
92514
|
* - `value`: The source being edited.
|
|
91786
92515
|
* - `tokenize`: Colors the source: a function from the source and the pane's `name` to
|
|
@@ -91794,6 +92523,8 @@ export type CustomElementsSolidJs = {
|
|
|
91794
92523
|
*
|
|
91795
92524
|
* Named for what it returns, runs of text, where Code Block's `highlight`
|
|
91796
92525
|
* returns markup. (property only)
|
|
92526
|
+
* - `modified`: Whether the source differs from the source the pane was given: its first
|
|
92527
|
+
* `value`, or the last one set from outside. (property only) (readonly)
|
|
91797
92528
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
91798
92529
|
*
|
|
91799
92530
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -91823,13 +92554,23 @@ export type CustomElementsSolidJs = {
|
|
|
91823
92554
|
* - `helix-caret`: Fired when the cursor moves.
|
|
91824
92555
|
* - `helix-edit`: Fired after the source was edited, with the new source.
|
|
91825
92556
|
*
|
|
92557
|
+
* ## Methods
|
|
92558
|
+
*
|
|
92559
|
+
* Methods that can be called to access component functionality.
|
|
92560
|
+
*
|
|
92561
|
+
* - `reset() => void`: Puts back the source the pane was given, as an edit: `helix-before-edit`
|
|
92562
|
+
* is sent first and can refuse it, and the sandbox passes it to its preview.
|
|
92563
|
+
*
|
|
91826
92564
|
* ## CSS Custom Properties
|
|
91827
92565
|
*
|
|
91828
92566
|
* CSS variables available for styling the component.
|
|
91829
92567
|
*
|
|
91830
92568
|
* - `--sandbox-source-background-color`: Fill behind the source.
|
|
92569
|
+
* - `--sandbox-source-bracket-color`: Fill behind a matched bracket, under `match-brackets`. Defaults to `--helix-color-accent-subtle`.
|
|
91831
92570
|
* - `--sandbox-source-callable-color`: Color of a `callable` run, under `tokenize`. Defaults to `--helix-color-syntax-callable`.
|
|
91832
92571
|
* - `--sandbox-source-comment-color`: Color of a `comment` run, under `tokenize`. Defaults to `--helix-color-syntax-comment`.
|
|
92572
|
+
* - `--sandbox-source-completions-border-width`: Width of the edge of the list of completions, under `complete`. Defaults to `--helix-border-floating`.
|
|
92573
|
+
* - `--sandbox-source-completions-shadow`: Shadow under the list of completions, under `complete`. Defaults to `--helix-shadow-floating`.
|
|
91833
92574
|
* - `--sandbox-source-constant-color`: Color of a `constant` run, under `tokenize`. Defaults to `--helix-color-syntax-constant`.
|
|
91834
92575
|
* - `--sandbox-source-invalid-color`: Color of an `invalid` run, under `tokenize`. Defaults to `--helix-color-syntax-invalid`.
|
|
91835
92576
|
* - `--sandbox-source-keyword-color`: Color of a `keyword` run, under `tokenize`. Defaults to `--helix-color-syntax-keyword`.
|
|
@@ -91843,8 +92584,13 @@ export type CustomElementsSolidJs = {
|
|
|
91843
92584
|
*
|
|
91844
92585
|
* Custom selectors for styling elements within the component.
|
|
91845
92586
|
*
|
|
91846
|
-
* - `
|
|
91847
|
-
* - `
|
|
92587
|
+
* - `bracket`: The bracket beside the caret and its pair, under `match-brackets`.
|
|
92588
|
+
* - `bracket-unmatched`: A bracket beside the caret with no pair, under `match-brackets`.
|
|
92589
|
+
* - `completion`: One word in the list of completions, under `complete`.
|
|
92590
|
+
* - `completion-active`: The word chosen in that list, which Enter or Tab takes.
|
|
92591
|
+
* - `completions`: The list of completions under the word being typed, under `complete`.
|
|
92592
|
+
* - `field`: The box that scrolls the field and its colors together, under `tokenize`, `line-numbers`, `match-brackets` or `complete`.
|
|
92593
|
+
* - `highlight`: The colored copy of the source drawn under the field, under `tokenize`, `line-numbers`, `match-brackets` or `complete`.
|
|
91848
92594
|
* - `line`: One line of that copy, under `line-numbers`, numbered in the gutter by its `::before`.
|
|
91849
92595
|
* - `source`: The editable region.
|
|
91850
92596
|
* - `token`: One run of the source that has a kind, under `tokenize`.
|
|
@@ -91853,6 +92599,7 @@ export type CustomElementsSolidJs = {
|
|
|
91853
92599
|
*
|
|
91854
92600
|
* These can be used to apply styling when a component is in a given state.
|
|
91855
92601
|
*
|
|
92602
|
+
* - `modified`: While the source differs from the source the pane was given, until `reset()` or a new `value`.
|
|
91856
92603
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
91857
92604
|
*/
|
|
91858
92605
|
"helix-sandbox-source": Partial<
|
|
@@ -94051,6 +94798,12 @@ export type CustomElementsSolidJs = {
|
|
|
94051
94798
|
* that should survive its own collapse says how much of itself to keep, and
|
|
94052
94799
|
* only whoever put it there knows that, which is the same reason `min` is a
|
|
94053
94800
|
* consumer's to set.
|
|
94801
|
+
* - `collapsible`: Which panes can be collapsed, as Zag's panels each take `collapsible`:
|
|
94802
|
+
* `start`, `end`, `both`, or `none`. A pane that cannot be collapsed stops
|
|
94803
|
+
* at the edge without shutting. `Enter` collapses the end pane where only
|
|
94804
|
+
* the end pane can be collapsed, and the start pane otherwise.
|
|
94805
|
+
*
|
|
94806
|
+
* Unset is `both`, and the attribute stays absent until you write it.
|
|
94054
94807
|
* - `corner-label`/`cornerLabel`: The name of the handle where two dividers cross, read by screen readers.
|
|
94055
94808
|
* - `corner-value-label`/`cornerValueLabel`: What the handle where two dividers cross says it is set to, both dividers
|
|
94056
94809
|
* at once: `{across}` is where the divider that runs down stands, and
|
|
@@ -94061,6 +94814,11 @@ export type CustomElementsSolidJs = {
|
|
|
94061
94814
|
* these words are the whole of where it is.
|
|
94062
94815
|
* - `default-collapsed`/`defaultCollapsed`: Which pane starts shut, when `collapsed` is not set.
|
|
94063
94816
|
* - `default-position`/`defaultPosition`: Where the divider starts, when `position` is not set.
|
|
94817
|
+
* - `end-min`/`endMin`: The least the end pane keeps, in the units `min` takes: a percentage, or
|
|
94818
|
+
* a CSS length such as `16rem` resolved against the splitter's box. The
|
|
94819
|
+
* divider stops that far from the end, whatever `max` allows, so `min` and
|
|
94820
|
+
* `end-min` hold a minimum for each pane, as Zag's panels each take
|
|
94821
|
+
* `minSize`.
|
|
94064
94822
|
* - `label`: The divider's name, read by screen readers.
|
|
94065
94823
|
*
|
|
94066
94824
|
* An `aria-label` or `aria-labelledby` on the host names the divider too,
|
|
@@ -94682,16 +95440,16 @@ export type CustomElementsSolidJs = {
|
|
|
94682
95440
|
* roll over one another, and light runs along them.
|
|
94683
95441
|
*
|
|
94684
95442
|
* Its palette comes from the tokens. The strands are `--helix-color-primary`,
|
|
94685
|
-
* a few are `--helix-color-
|
|
95443
|
+
* a few are `--helix-color-accent` for depth, and the page they light is
|
|
94686
95444
|
* `--helix-color-background`. On a light page the light becomes ink, because
|
|
94687
95445
|
* light added to near-white cannot be seen.
|
|
94688
95446
|
*
|
|
94689
|
-
* **Three forms, set with `variant`.** `
|
|
95447
|
+
* **Three forms, set with `variant`.** `bend` turns bright strands through one tight point, with its
|
|
94690
95448
|
* arms opening to the right. `ribbon`, the default, is a broad, soft ribbon in
|
|
94691
95449
|
* long curves. `waves` is sharp strands crossing the full width.
|
|
94692
95450
|
*
|
|
94693
95451
|
* **In its own box, by default.** The element fills the box it is given, the
|
|
94694
|
-
* way an image does, and `at` places the
|
|
95452
|
+
* way an image does, and `at` places the bend's apex or the ribbon's axis across
|
|
94695
95453
|
* it. Content placed inside sits over the ribbon, in the `content` part.
|
|
94696
95454
|
*
|
|
94697
95455
|
* **Down the whole page, with `travel`.** The element fixes itself behind the
|
|
@@ -94699,8 +95457,9 @@ export type CustomElementsSolidJs = {
|
|
|
94699
95457
|
* bottom, so scrolling travels along it. Put `helix-strands-stop` elements
|
|
94700
95458
|
* inside to pin a form to a section: each names an element with `for` and says
|
|
94701
95459
|
* which form the ribbon takes there. Between stops the ribbon fills the gap in
|
|
94702
|
-
* its own `variant`, and between two waves
|
|
94703
|
-
* reads alone. Set `z-index` on the
|
|
95460
|
+
* its own `variant`, and between two waves less than a screen and a half
|
|
95461
|
+
* apart it turns off screen so each wave reads alone. Set `z-index` on the
|
|
95462
|
+
* element to move it.
|
|
94704
95463
|
*
|
|
94705
95464
|
* The ribbon stops moving in these cases:
|
|
94706
95465
|
* - `prefers-reduced-motion` is set. The element shows one still frame, and in
|
|
@@ -94720,20 +95479,35 @@ export type CustomElementsSolidJs = {
|
|
|
94720
95479
|
*
|
|
94721
95480
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
94722
95481
|
*
|
|
94723
|
-
* - `at`: Where the form sits across the box, as a share of the width: the
|
|
94724
|
-
*
|
|
94725
|
-
* crosses the whole width and does not read it. Unset, a
|
|
95482
|
+
* - `at`: Where the form sits across the box, as a share of the width: the bend's
|
|
95483
|
+
* apex or the ribbon's axis. `0` is the left edge and `1` the right. A wave
|
|
95484
|
+
* crosses the whole width and does not read it. Unset, a bend's apex sits at `0.5`
|
|
94726
95485
|
* and a ribbon runs down the middle.
|
|
94727
95486
|
*
|
|
94728
95487
|
* **A share rather than a length**, so the ribbon keeps its place when the
|
|
94729
95488
|
* box changes shape. Read inside a box only; in `travel` each stop has its
|
|
94730
95489
|
* own.
|
|
95490
|
+
* - `bloom`: How much the glow around the strands adds, as a multiplier. `0` draws the
|
|
95491
|
+
* strands alone, crisp and dimmer, and `1` is the default glow.
|
|
95492
|
+
* - `contrast`: How far apart the brightest and dimmest strands are, from `0`, most of
|
|
95493
|
+
* them alike, to `1`, a few burning bright over many faint ones. Clamped to
|
|
95494
|
+
* that range. The ribbon as a whole keeps its strength.
|
|
94731
95495
|
* - `density`: How many strands the ribbon has, from `0`, sixty, to `1`, three hundred and
|
|
94732
95496
|
* forty. Clamped to that range.
|
|
95497
|
+
* - `depth`: How much the ribbon's depth shows, from `0`, flat, to `1`. Clamped to that
|
|
95498
|
+
* range. The strands at the front of the ribbon's roll are drawn thicker,
|
|
95499
|
+
* brighter, and further from its axis, and those at the back thinner, dimmer,
|
|
95500
|
+
* and out of focus.
|
|
95501
|
+
* - `drift`: How differently each strand moves, from `0`, the whole ribbon rolling and
|
|
95502
|
+
* waving as one, to `1`, each strand at its own pace and angle, crossing
|
|
95503
|
+
* over the others. Clamped to that range.
|
|
95504
|
+
* - `dust`: How many specks of dust drift around the strands, as a multiplier: `0`
|
|
95505
|
+
* draws none, `1` six hundred, and `4`, the most, two thousand four
|
|
95506
|
+
* hundred. They gather where the ribbon is brightest.
|
|
94733
95507
|
* - `gain`: Overall brightness, as a multiplier on the light.
|
|
94734
95508
|
* - `softness`: The share of strands drawn out of focus where the ribbon is wide, from `0`,
|
|
94735
95509
|
* every strand sharp, to `1`, every one soft. Clamped to that range. A tight
|
|
94736
|
-
* form, such as a
|
|
95510
|
+
* form, such as a bend's apex or a wave, stays sharp whatever this says.
|
|
94737
95511
|
* - `speed`: How fast the ribbon moves, as a multiplier on time. `0` holds it still.
|
|
94738
95512
|
* - `spread`: How wide the ribbon is, as a multiplier on each form's own width.
|
|
94739
95513
|
* - `travel`: Whether the ribbon is laid down the whole page, so scrolling travels along
|
|
@@ -94783,7 +95557,7 @@ export type CustomElementsSolidJs = {
|
|
|
94783
95557
|
* - `--strands-glow`: The color of most strands. Defaults to `--helix-color-primary`.
|
|
94784
95558
|
* - `--strands-ground`: The page the light is added to. Defaults to `--helix-color-background`.
|
|
94785
95559
|
* - `--strands-peak`: The hottest strands, and on a light page the ink the light darkens toward. Defaults to `--helix-color-primary-hover` on a dark page and `--helix-color-primary-active` on a light one.
|
|
94786
|
-
* - `--strands-tint`: The color of a few strands, for depth. Defaults to `--helix-color-
|
|
95560
|
+
* - `--strands-tint`: The color of a few strands, for depth. Defaults to `--helix-color-accent`, which is the primary itself unless the theme relates an accent to the brand, as `accent: { from: 'brand', rotate: 40 }` does.
|
|
94787
95561
|
*
|
|
94788
95562
|
* ## CSS Parts
|
|
94789
95563
|
*
|
|
@@ -94808,8 +95582,8 @@ export type CustomElementsSolidJs = {
|
|
|
94808
95582
|
|
|
94809
95583
|
/**
|
|
94810
95584
|
* Placed inside a `helix-strands` with `travel`, a stop names an element with
|
|
94811
|
-
* `for` and says which form the ribbon takes when the page reaches it: a `
|
|
94812
|
-
*
|
|
95585
|
+
* `for` and says which form the ribbon takes when the page reaches it: a `bend`
|
|
95586
|
+
* turning through it, a `ribbon` passing through `at`, or `waves` crossing at
|
|
94813
95587
|
* its top edge. The stops are read in page order, whatever order they are
|
|
94814
95588
|
* written in, and a stop naming no element is skipped.
|
|
94815
95589
|
*
|
|
@@ -94824,9 +95598,9 @@ export type CustomElementsSolidJs = {
|
|
|
94824
95598
|
*
|
|
94825
95599
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
94826
95600
|
*
|
|
94827
|
-
* - `at`: Where the form sits across the page, as a share of the width: the
|
|
94828
|
-
*
|
|
94829
|
-
* read it. Unset, a
|
|
95601
|
+
* - `at`: Where the form sits across the page, as a share of the width: the bend's
|
|
95602
|
+
* apex or the ribbon's axis. A wave crosses the whole width and does not
|
|
95603
|
+
* read it. Unset, a bend's apex sits at `0.5` and a ribbon runs down the middle.
|
|
94830
95604
|
* - `for`: The id of the element the form is pinned to, in the same tree as the stop.
|
|
94831
95605
|
* - `variant`: The form the ribbon takes at the element. When it is not set, the form is `ribbon`.
|
|
94832
95606
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
@@ -96332,6 +97106,7 @@ export type CustomElementsSolidJs = {
|
|
|
96332
97106
|
*
|
|
96333
97107
|
* These can be used to apply styling when a component is in a given state.
|
|
96334
97108
|
*
|
|
97109
|
+
* - `focus-visible`: The tag's cell has keyboard focus that the browser shows, in a `Tag.Group`.
|
|
96335
97110
|
* - `selected`: The tag is selected in a `Tag.Group` that selects.
|
|
96336
97111
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
96337
97112
|
*/
|
|
@@ -97393,6 +98168,17 @@ export type CustomElementsSolidJs = {
|
|
|
97393
98168
|
* imperatively later, and nothing is hydrating by then.
|
|
97394
98169
|
*
|
|
97395
98170
|
* Here rather than on each control.
|
|
98171
|
+
* - `timeContent`: What each time in the list shows: a function given the time as `HH:mm`,
|
|
98172
|
+
* or `HH:mm:ss` with `seconds`, and the time as the row writes it, that
|
|
98173
|
+
* returns text, an element or a Lit template.
|
|
98174
|
+
*
|
|
98175
|
+
* For the seats left at a time, or a caption under it, as React Aria's
|
|
98176
|
+
* `ListBoxItem` takes children. Content with `slot="start"`, `slot="end"`
|
|
98177
|
+
* or `slot="description"` goes to that slot of the row, and a description
|
|
98178
|
+
* is read after the time. The row is still named by the written time, and
|
|
98179
|
+
* typeahead still finds it by that. Return the written time with your
|
|
98180
|
+
* content where it should still show. A property only, there being no way
|
|
98181
|
+
* to write a function in markup. The wheels draw their own figures. (property only)
|
|
97396
98182
|
* - `valueAsDate`: The value as a `Date` on 1 January 1970 UTC, or `null` while there is no time.
|
|
97397
98183
|
*
|
|
97398
98184
|
* The platform's own pair on `<input type="time">`, epoch day included: a time
|
|
@@ -97808,6 +98594,9 @@ export type CustomElementsSolidJs = {
|
|
|
97808
98594
|
* - `orientation`: Which way time runs: `horizontal` lays the entries across the page. Unset,
|
|
97809
98595
|
* they run down it.
|
|
97810
98596
|
* - `label`: Accessible name for the timeline, for people who reach it out of context.
|
|
98597
|
+
* - `loading`: Marks the timeline as busy fetching more entries, and draws an entry
|
|
98598
|
+
* after the last that says so.
|
|
98599
|
+
* - `loading-label`/`loadingLabel`: The text of the entry drawn while `loading` is set, where the `loading` slot is empty.
|
|
97811
98600
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
97812
98601
|
*
|
|
97813
98602
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -97834,6 +98623,7 @@ export type CustomElementsSolidJs = {
|
|
|
97834
98623
|
* Areas where markup can be added to the component.
|
|
97835
98624
|
*
|
|
97836
98625
|
* - `(default)`: The entries, and any groups of them.
|
|
98626
|
+
* - `loading`: Content for the entry after the last while `loading` is set. Falls back to `loading-label`.
|
|
97837
98627
|
*
|
|
97838
98628
|
* ## CSS Custom Properties
|
|
97839
98629
|
*
|
|
@@ -97841,10 +98631,17 @@ export type CustomElementsSolidJs = {
|
|
|
97841
98631
|
*
|
|
97842
98632
|
* - `--timeline-gap`: Space between one entry and the next.
|
|
97843
98633
|
*
|
|
98634
|
+
* ## CSS Parts
|
|
98635
|
+
*
|
|
98636
|
+
* Custom selectors for styling elements within the component.
|
|
98637
|
+
*
|
|
98638
|
+
* - `loading`: The entry after the last while `loading` is set.
|
|
98639
|
+
*
|
|
97844
98640
|
* ## CSS States
|
|
97845
98641
|
*
|
|
97846
98642
|
* These can be used to apply styling when a component is in a given state.
|
|
97847
98643
|
*
|
|
98644
|
+
* - `loading`: While `loading` is set.
|
|
97848
98645
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
97849
98646
|
*/
|
|
97850
98647
|
"helix-timeline": Partial<
|
|
@@ -100581,6 +101378,12 @@ export type CustomElementsSolidJs = {
|
|
|
100581
101378
|
* and scrolls it sideways: Left and Right move between items, the other
|
|
100582
101379
|
* way round on a right-to-left page, and `estimate` is an item's width. A
|
|
100583
101380
|
* grid always runs down.
|
|
101381
|
+
* - `reorderable`: Lets a reader move items, once `@fusion.dev/helix/virtual-list/reorder`
|
|
101382
|
+
* (or `@fusion.dev/helix-headless/virtual-list/reorder`) is imported: Alt
|
|
101383
|
+
* with an arrow moves the row the keys are on, and a pointer drags a row.
|
|
101384
|
+
* The list moves no item itself: you move your `items` on `helix-reorder`.
|
|
101385
|
+
* Without that import it does nothing, so a list that never moves items
|
|
101386
|
+
* carries none of the code. A list of one column, without sections.
|
|
100584
101387
|
* - `section-field`/`sectionField`: The field of each item that names its section, as a key or a path of
|
|
100585
101388
|
* keys. Set, the items are drawn in sections: a header, then the items, in
|
|
100586
101389
|
* an element with the `group` role that the header names. A section starts
|
|
@@ -100643,8 +101446,10 @@ export type CustomElementsSolidJs = {
|
|
|
100643
101446
|
*
|
|
100644
101447
|
* - `change`: Fired once a press or a key has changed which items are selected, in a list with `selection-mode`.
|
|
100645
101448
|
* - `helix-before-change`: Fired before a press or a key changes which items are selected, with the `value` it would leave. Cancelable.
|
|
101449
|
+
* - `helix-before-reorder`: Fired when an item is dropped at a new place, in a `reorderable` list with `@fusion.dev/helix/virtual-list/reorder` imported, with every key in the new order. Cancelable: cancel it to keep the item where it is.
|
|
100646
101450
|
* - `helix-load-more`: Fired when a reader comes within one screen of the last item, once for each length of the set.
|
|
100647
101451
|
* - `helix-range-change`: Fired when the items on screen change, with the new `first` and `last`, which `range` also holds.
|
|
101452
|
+
* - `helix-reorder`: Fired after `helix-before-reorder` when nobody canceled it. Set `items` to the order in `keys`. Cancelable: cancel it to say the move did not happen.
|
|
100648
101453
|
*
|
|
100649
101454
|
* ## Slots
|
|
100650
101455
|
*
|
|
@@ -100670,6 +101475,15 @@ export type CustomElementsSolidJs = {
|
|
|
100670
101475
|
*
|
|
100671
101476
|
* - `--virtual-list-block-size`: How tall the scrolling box is. A list that runs across is as tall as its rows unless you set it.
|
|
100672
101477
|
* - `--virtual-list-disabled-opacity`: How faint a row `disabled-keys` names is drawn.
|
|
101478
|
+
* - `--virtual-list-drag-preview-background-color`: The fill behind the copy of a row a pointer drags, in a `reorderable` list with `@fusion.dev/helix/virtual-list/reorder` imported.
|
|
101479
|
+
* - `--virtual-list-drag-preview-border-color`: The color of the edge around the copy of a row a pointer drags.
|
|
101480
|
+
* - `--virtual-list-drag-preview-border-width`: The width of the edge around the copy of a row a pointer drags. None by default, where the shadow lifts it.
|
|
101481
|
+
* - `--virtual-list-drag-preview-opacity`: The opacity of the copy of a row a pointer drags.
|
|
101482
|
+
* - `--virtual-list-drag-preview-radius`: The corner radius of the copy of a row a pointer drags.
|
|
101483
|
+
* - `--virtual-list-drag-preview-shadow`: The shadow that raises the copy of a row a pointer drags over the page.
|
|
101484
|
+
* - `--virtual-list-dragging-opacity`: The opacity of a row being dragged, in a `reorderable` list with `@fusion.dev/helix/virtual-list/reorder` imported.
|
|
101485
|
+
* - `--virtual-list-drop-indicator-color`: The color of the line where a dragged row would land.
|
|
101486
|
+
* - `--virtual-list-drop-indicator-size`: The thickness of the line where a dragged row would land.
|
|
100673
101487
|
* - `--virtual-list-empty-color`: The color of the text in the row shown when there are no items.
|
|
100674
101488
|
* - `--virtual-list-empty-padding`: The space around the text in the row shown when there are no items.
|
|
100675
101489
|
* - `--virtual-list-loading-color`: The color of the text in the row drawn while `loading` is set.
|
|
@@ -102214,6 +103028,8 @@ export type CustomCssProperties = {
|
|
|
102214
103028
|
"--orb-ground"?: (string) | undefined;
|
|
102215
103029
|
/** The diameter. Overrides `size`. */
|
|
102216
103030
|
"--orb-size"?: (string) | undefined;
|
|
103031
|
+
/** How fast the dots move, as a multiple of each state's own tempo. Defaults to `1`. */
|
|
103032
|
+
"--orb-speed"?: (string) | undefined;
|
|
102217
103033
|
/** The color of the heading in the `heading` slot. */
|
|
102218
103034
|
"--outline-heading-color"?: (string) | undefined;
|
|
102219
103035
|
/** How far each level is inset from the one above. */
|
|
@@ -102424,10 +103240,16 @@ export type CustomCssProperties = {
|
|
|
102424
103240
|
"--sandbox-separator-color"?: (string) | undefined;
|
|
102425
103241
|
/** Fill behind the source. */
|
|
102426
103242
|
"--sandbox-source-background-color"?: (string) | undefined;
|
|
103243
|
+
/** Fill behind a matched bracket, under `match-brackets`. Defaults to `--helix-color-accent-subtle`. */
|
|
103244
|
+
"--sandbox-source-bracket-color"?: (string) | undefined;
|
|
102427
103245
|
/** Color of a `callable` run, under `tokenize`. Defaults to `--helix-color-syntax-callable`. */
|
|
102428
103246
|
"--sandbox-source-callable-color"?: (string) | undefined;
|
|
102429
103247
|
/** Color of a `comment` run, under `tokenize`. Defaults to `--helix-color-syntax-comment`. */
|
|
102430
103248
|
"--sandbox-source-comment-color"?: (string) | undefined;
|
|
103249
|
+
/** Width of the edge of the list of completions, under `complete`. Defaults to `--helix-border-floating`. */
|
|
103250
|
+
"--sandbox-source-completions-border-width"?: (string) | undefined;
|
|
103251
|
+
/** Shadow under the list of completions, under `complete`. Defaults to `--helix-shadow-floating`. */
|
|
103252
|
+
"--sandbox-source-completions-shadow"?: (string) | undefined;
|
|
102431
103253
|
/** Color of a `constant` run, under `tokenize`. Defaults to `--helix-color-syntax-constant`. */
|
|
102432
103254
|
"--sandbox-source-constant-color"?: (string) | undefined;
|
|
102433
103255
|
/** Color of an `invalid` run, under `tokenize`. Defaults to `--helix-color-syntax-invalid`. */
|
|
@@ -102724,7 +103546,7 @@ export type CustomCssProperties = {
|
|
|
102724
103546
|
"--strands-ground"?: (string) | undefined;
|
|
102725
103547
|
/** The hottest strands, and on a light page the ink the light darkens toward. Defaults to `--helix-color-primary-hover` on a dark page and `--helix-color-primary-active` on a light one. */
|
|
102726
103548
|
"--strands-peak"?: (string) | undefined;
|
|
102727
|
-
/** The color of a few strands, for depth. Defaults to `--helix-color-
|
|
103549
|
+
/** The color of a few strands, for depth. Defaults to `--helix-color-accent`, which is the primary itself unless the theme relates an accent to the brand, as `accent: { from: 'brand', rotate: 40 }` does. */
|
|
102728
103550
|
"--strands-tint"?: (string) | undefined;
|
|
102729
103551
|
/** Height of the track. The width follows it. */
|
|
102730
103552
|
"--switch-block-size"?: (string) | undefined;
|
|
@@ -103182,6 +104004,24 @@ export type CustomCssProperties = {
|
|
|
103182
104004
|
"--virtual-list-block-size"?: (string) | undefined;
|
|
103183
104005
|
/** How faint a row `disabled-keys` names is drawn. */
|
|
103184
104006
|
"--virtual-list-disabled-opacity"?: (string) | undefined;
|
|
104007
|
+
/** The fill behind the copy of a row a pointer drags, in a `reorderable` list with `@fusion.dev/helix/virtual-list/reorder` imported. */
|
|
104008
|
+
"--virtual-list-drag-preview-background-color"?: (string) | undefined;
|
|
104009
|
+
/** The color of the edge around the copy of a row a pointer drags. */
|
|
104010
|
+
"--virtual-list-drag-preview-border-color"?: (string) | undefined;
|
|
104011
|
+
/** The width of the edge around the copy of a row a pointer drags. None by default, where the shadow lifts it. */
|
|
104012
|
+
"--virtual-list-drag-preview-border-width"?: (string) | undefined;
|
|
104013
|
+
/** The opacity of the copy of a row a pointer drags. */
|
|
104014
|
+
"--virtual-list-drag-preview-opacity"?: (string) | undefined;
|
|
104015
|
+
/** The corner radius of the copy of a row a pointer drags. */
|
|
104016
|
+
"--virtual-list-drag-preview-radius"?: (string) | undefined;
|
|
104017
|
+
/** The shadow that raises the copy of a row a pointer drags over the page. */
|
|
104018
|
+
"--virtual-list-drag-preview-shadow"?: (string) | undefined;
|
|
104019
|
+
/** The opacity of a row being dragged, in a `reorderable` list with `@fusion.dev/helix/virtual-list/reorder` imported. */
|
|
104020
|
+
"--virtual-list-dragging-opacity"?: (string) | undefined;
|
|
104021
|
+
/** The color of the line where a dragged row would land. */
|
|
104022
|
+
"--virtual-list-drop-indicator-color"?: (string) | undefined;
|
|
104023
|
+
/** The thickness of the line where a dragged row would land. */
|
|
104024
|
+
"--virtual-list-drop-indicator-size"?: (string) | undefined;
|
|
103185
104025
|
/** The color of the text in the row shown when there are no items. */
|
|
103186
104026
|
"--virtual-list-empty-color"?: (string) | undefined;
|
|
103187
104027
|
/** The space around the text in the row shown when there are no items. */
|