@fusion.dev/helix-headless 0.53.1 → 0.53.2
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 +118 -138
- package/dist/accordion/item/accordion-item.d.ts +13 -13
- package/dist/accordion/root/accordion-root.d.ts +1 -1
- package/dist/area-chart/root/area-chart-root.js +1 -1
- package/dist/avatar/group/avatar-group.d.ts +11 -11
- package/dist/bar-chart/root/bar-chart-root.d.ts +1 -1
- package/dist/breadcrumbs/breadcrumb/breadcrumb.d.ts +6 -6
- package/dist/button/root/button-root.d.ts +1 -1
- package/dist/card/root/card-root.d.ts +1 -1
- package/dist/carousel/root/carousel-root.d.ts +14 -14
- package/dist/chat/composer/chat-composer.d.ts +6 -6
- package/dist/chat/root/chat-root.d.ts +9 -9
- package/dist/checkbox/root/checkbox-root.d.ts +2 -2
- package/dist/code-block/root/code-block-root.d.ts +5 -5
- package/dist/color-input/root/color-input-root.d.ts +3 -3
- package/dist/color-picker/root/color-picker-root.d.ts +14 -14
- package/dist/combobox/root/combobox-root.d.ts +9 -5
- package/dist/combobox/root/combobox-root.js +2 -3
- package/dist/command/root/command-root.d.ts +6 -7
- package/dist/data-table/root/data-table-root.d.ts +38 -38
- package/dist/data-table/root/order.d.ts +3 -3
- package/dist/date-input/root/date-input-root.d.ts +12 -11
- package/dist/dialog/root/dialog-root.d.ts +4 -4
- package/dist/drawer/root/drawer-root.d.ts +5 -5
- package/dist/filter-input/menu/filter-menu.d.ts +7 -1
- package/dist/filter-input/menu/filter-menu.js +2 -1
- package/dist/filter-input/root/filter-input-root.d.ts +6 -6
- package/dist/format-date/root/format-date-root.d.ts +6 -5
- package/dist/heatmap/root/heatmap-root.d.ts +11 -16
- package/dist/image/root/image-root.d.ts +4 -4
- package/dist/input/root/input-root.d.ts +7 -7
- package/dist/line-chart/root/line-chart-root.d.ts +1 -2
- package/dist/list/item/list-item.d.ts +6 -7
- package/dist/list/root/list-root.d.ts +4 -4
- package/dist/megamenu/root/megamenu-root.d.ts +4 -4
- package/dist/notifications/notification/notification.d.ts +10 -10
- package/dist/notifications/root/notifications-root.d.ts +1 -1
- package/dist/option/root/option-root.d.ts +3 -3
- package/dist/pagination/root/pagination-root.d.ts +2 -2
- package/dist/pin-input/root/pin-input-root.d.ts +4 -4
- package/dist/popover/root/popover-root.d.ts +7 -6
- package/dist/radio/root/radio-root.d.ts +1 -1
- package/dist/speed-dial/root/speed-dial-root.d.ts +8 -9
- package/dist/stat/root/stat-root.d.ts +3 -3
- package/dist/steps/root/steps-root.d.ts +1 -1
- package/dist/steps/step/step.d.ts +5 -5
- package/dist/table/column/table-column.d.ts +28 -28
- package/dist/table/root/table-root.d.ts +14 -17
- package/dist/table/row/table-row.d.ts +4 -4
- package/dist/tabs/panel/tab-panel.d.ts +2 -2
- package/dist/time-input/root/time-input-root.d.ts +13 -13
- package/dist/time-picker/root/time-picker-root.d.ts +8 -8
- package/dist/toast/root/toast-root.d.ts +2 -2
- package/dist/toggle/root/toggle-root.d.ts +5 -5
- package/dist/tooltip/root/tooltip-root.d.ts +2 -2
- package/dist/tour/stop/tour-stop.d.ts +3 -3
- package/dist/tree/item/tree-item.d.ts +2 -2
- package/dist/tree/root/tree-root.d.ts +8 -7
- package/dist/tree/root/tree-root.js +1 -1
- package/dist/video-playlist/menu/video-playlist-menu.d.ts +7 -1
- package/dist/video-playlist/menu/video-playlist-menu.js +4 -2
- package/dist/video-playlist/root/video-playlist-root.d.ts +5 -5
- package/dist/video-playlist/root/video-playlist-root.js +2 -3
- package/package.json +5 -5
- package/types/jsx.d.ts +754 -780
- package/types/vue.d.ts +172 -185
|
@@ -7,9 +7,9 @@ declare const HelixHeadlessDateInput_base: (new (...args: any[]) => import("@fus
|
|
|
7
7
|
* @summary A date, typed or picked from a calendar.
|
|
8
8
|
*
|
|
9
9
|
* @description
|
|
10
|
-
* **The calendar is `
|
|
11
|
-
*
|
|
12
|
-
*
|
|
10
|
+
* **The calendar is `DatePicker`, not a second one written here.** It already
|
|
11
|
+
* knows about months, ranges, disabled days, the first day of the week and
|
|
12
|
+
* every keyboard rule a grid owes a reader. This element is the field, the
|
|
13
13
|
* overlay, and the translation between them.
|
|
14
14
|
*
|
|
15
15
|
* **Typed as well as picked, and the typing is why it is not
|
|
@@ -260,14 +260,15 @@ export declare class HelixHeadlessDateInput extends HelixHeadlessDateInput_base
|
|
|
260
260
|
* Slot fallback, so a consumer replaces it by slotting; and a method, so the
|
|
261
261
|
* tier above replaces it by overriding.
|
|
262
262
|
*
|
|
263
|
-
* **A named import rather than `<helix-icon>`**, which loses on
|
|
264
|
-
* `
|
|
265
|
-
* no bundler can shake a runtime lookup, so every
|
|
266
|
-
* that renders one ships all 50kB of path data; a
|
|
267
|
-
* path. The import is checked when the package
|
|
268
|
-
* string is checked only by a later name lookup. And
|
|
269
|
-
* registered on the headless tier at all, which registers
|
|
270
|
-
* so a headless consumer gets an inert unknown element
|
|
263
|
+
* **A named import rather than `<helix-headless-icon>`**, which loses on
|
|
264
|
+
* three counts. `Icon` indexes the whole icon map at runtime,
|
|
265
|
+
* `icons[this.name]`, and no bundler can shake a runtime lookup, so every
|
|
266
|
+
* consumer of any component that renders one ships all 50kB of path data; a
|
|
267
|
+
* named import ships one path. The import is checked when the package
|
|
268
|
+
* compiles, where a `name` string is checked only by a later name lookup. And
|
|
269
|
+
* `Icon` is not registered on the headless tier at all, which registers
|
|
270
|
+
* `helix-headless-icon`, so a headless consumer gets an inert unknown element
|
|
271
|
+
* and no mark whatsoever.
|
|
271
272
|
*/
|
|
272
273
|
protected renderTrigger(): TemplateResult;
|
|
273
274
|
protected render(): TemplateResult;
|
|
@@ -148,10 +148,10 @@ export declare class HelixHeadlessDialog extends HelixHeadlessDialog_base {
|
|
|
148
148
|
* restarts it: without that, pressing twice does nothing the second time,
|
|
149
149
|
* which is the impression the whole thing exists to avoid.
|
|
150
150
|
*
|
|
151
|
-
* **`once: true` is not a release when the event cannot arrive.**
|
|
152
|
-
* `prefers-reduced-motion: reduce`
|
|
153
|
-
*
|
|
154
|
-
*
|
|
151
|
+
* **`once: true` is not a release when the event cannot arrive.** A sheet
|
|
152
|
+
* that sets `animation: none` under `prefers-reduced-motion: reduce` runs
|
|
153
|
+
* none, so `animationend` never fires, and every refused press left a
|
|
154
|
+
* listener that could not be removed and an attribute that stayed on. The
|
|
155
155
|
* controller bounds it to one listener, aborted before the next is added.
|
|
156
156
|
*
|
|
157
157
|
* **And the attribute is cleared at once when no animation is running**, asked
|
|
@@ -24,8 +24,8 @@ declare const HelixHeadlessDrawer_base: (new (...args: any[]) => import("@fusion
|
|
|
24
24
|
* Opened declaratively with the platform's invoker attributes:
|
|
25
25
|
*
|
|
26
26
|
* ```html
|
|
27
|
-
* <helix-button commandfor="nav" command="--toggle">Menu</helix-button>
|
|
28
|
-
* <helix-drawer id="nav">…</helix-drawer>
|
|
27
|
+
* <helix-headless-button commandfor="nav" command="--toggle">Menu</helix-headless-button>
|
|
28
|
+
* <helix-headless-drawer id="nav">…</helix-headless-drawer>
|
|
29
29
|
* ```
|
|
30
30
|
*
|
|
31
31
|
* @since 0.1.0
|
|
@@ -84,10 +84,10 @@ export declare class HelixHeadlessDrawer extends HelixHeadlessDrawer_base {
|
|
|
84
84
|
/**
|
|
85
85
|
* Which edge the drawer comes from.
|
|
86
86
|
*
|
|
87
|
-
* Unset is `end`,
|
|
88
|
-
* beside `:host([placement="end"])` rather than as a value written here: a
|
|
87
|
+
* Unset is `end`, and it stays unset rather than being written down: a
|
|
89
88
|
* default assigned to the property would reflect onto every host and put a
|
|
90
|
-
* `placement="end"` into markup no consumer wrote.
|
|
89
|
+
* `placement="end"` into markup no consumer wrote. So what this tier
|
|
90
|
+
* guarantees is the absence, and a sheet selects on it.
|
|
91
91
|
*/
|
|
92
92
|
placement?: 'start' | 'end' | 'top' | 'bottom';
|
|
93
93
|
/**
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { HelixElement } from '@fusion.dev/helix-core';
|
|
2
2
|
import { type PropertyValues, type TemplateResult } from 'lit';
|
|
3
|
-
import
|
|
3
|
+
import { HelixHeadlessFilterField } from '../field/filter-field.js';
|
|
4
4
|
import type { FilterGrammarOperator } from '../grammar.js';
|
|
5
5
|
import '../../divider/index.js';
|
|
6
6
|
import '../../menu/index.js';
|
|
@@ -97,6 +97,12 @@ export declare class HelixHeadlessFilterMenu extends HelixElement {
|
|
|
97
97
|
*
|
|
98
98
|
* What a render may know of them: none on a server, whose shim has no tree
|
|
99
99
|
* and threw here, and none while hydrating what one sent.
|
|
100
|
+
*
|
|
101
|
+
* By identity rather than by tag. A list of names can only hold the tags this
|
|
102
|
+
* package knows about, so it misses any third one, which is what subclassing
|
|
103
|
+
* a headless element produces, and it is also how a headless package learns a
|
|
104
|
+
* styled tag. `instanceof` answers for every one of them and proves the type
|
|
105
|
+
* the signature claims.
|
|
100
106
|
*/
|
|
101
107
|
get fields(): HelixHeadlessFilterField[];
|
|
102
108
|
protected firstUpdated(changed: PropertyValues): void;
|
|
@@ -8,6 +8,7 @@ import { customElement, HelixElement, HelixFacetEvent } from '@fusion.dev/helix-
|
|
|
8
8
|
import { nothing } from 'lit';
|
|
9
9
|
import { property } from 'lit/decorators.js';
|
|
10
10
|
import { html } from 'lit/static-html.js';
|
|
11
|
+
import { HelixHeadlessFilterField } from '../field/filter-field.js';
|
|
11
12
|
import '../../divider/index.js';
|
|
12
13
|
import '../../menu/index.js';
|
|
13
14
|
let HelixHeadlessFilterMenu = class HelixHeadlessFilterMenu extends HelixElement {
|
|
@@ -49,7 +50,7 @@ let HelixHeadlessFilterMenu = class HelixHeadlessFilterMenu extends HelixElement
|
|
|
49
50
|
};
|
|
50
51
|
}
|
|
51
52
|
get fields() {
|
|
52
|
-
return this.knownChildren.filter((child) =>
|
|
53
|
+
return this.knownChildren.filter((child) => child instanceof HelixHeadlessFilterField);
|
|
53
54
|
}
|
|
54
55
|
firstUpdated(changed) {
|
|
55
56
|
super.firstUpdated(changed);
|
|
@@ -43,12 +43,12 @@ declare const HelixHeadlessFilterInput_base: (new (...args: any[]) => import("@f
|
|
|
43
43
|
* `FilterField` already plays on its own children.
|
|
44
44
|
*
|
|
45
45
|
* **It can suggest what to type next, and deciding what to suggest is still the
|
|
46
|
-
* consumer's.** Slot
|
|
47
|
-
*
|
|
48
|
-
*
|
|
49
|
-
*
|
|
50
|
-
*
|
|
51
|
-
*
|
|
46
|
+
* consumer's.** Slot options into `suggestions` and the field shows them, moves
|
|
47
|
+
* through them with the arrows, and lets Enter press one; the option fires its
|
|
48
|
+
* own `helix-select` and the consumer decides what choosing meant. Keys before
|
|
49
|
+
* a colon and values after it are the same panel with different contents, and
|
|
50
|
+
* `readFilterText` is exported for a consumer narrowing that panel against what
|
|
51
|
+
* a reader has half typed.
|
|
52
52
|
*
|
|
53
53
|
* **The panel opens when there is something in it and closes when there is
|
|
54
54
|
* not**, rather than on a choice. A reader who picks a key wants its values
|
|
@@ -47,11 +47,12 @@ export declare class HelixHeadlessFormatDate extends HelixElement {
|
|
|
47
47
|
* would give.
|
|
48
48
|
*
|
|
49
49
|
* **The element's own text is read as a fallback, and only in a browser.**
|
|
50
|
-
* `<helix-
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
*
|
|
54
|
-
*
|
|
50
|
+
* `<helix-headless-format-date
|
|
51
|
+
* elapsed>2026-08-27T01:00:00Z</helix-headless-format-date>` is the spelling
|
|
52
|
+
* that reads best in markup, and it cannot be the only one: measured against
|
|
53
|
+
* Lit's server shim, `textContent`, `children`, `firstChild` and
|
|
54
|
+
* `querySelector` are all `undefined` there, so a server has no way to see
|
|
55
|
+
* it. An element rendered on a server needs the attribute; one rendered in a
|
|
55
56
|
* browser may use either.
|
|
56
57
|
*/
|
|
57
58
|
date: string;
|
|
@@ -63,11 +63,6 @@ declare const HelixHeadlessHeatmap_base: typeof HelixElement & (new (...args: an
|
|
|
63
63
|
* @csspart tooltip-top - The bubble while it is above the reading, beside `tooltip`.
|
|
64
64
|
* @csspart tooltip-value - A column's value inside the tooltip.
|
|
65
65
|
*
|
|
66
|
-
* @cssproperty --heatmap-cell-height - How tall a cell is. A row of a tall thin cell is what a status page draws.
|
|
67
|
-
* @cssproperty --heatmap-cell-inline-size - How wide a cell is. The strip fits as many as the container allows.
|
|
68
|
-
* @cssproperty --heatmap-cell-radius - How far a cell's corners are rounded.
|
|
69
|
-
* @cssproperty --heatmap-cell-size - The size a cell wants on both axes, where neither is given its own.
|
|
70
|
-
* @cssproperty --heatmap-gap - Space between cells. Zero is a continuous field rather than a grid of tiles.
|
|
71
66
|
* @cssproperty --heatmap-rows - How many rows the strip lays out. Written by the component from the data, read by the tier that draws it.
|
|
72
67
|
* @cssproperty --heatmap-tone - The tone of the cell this is set on. Written by the component, read by the sheet that paints.
|
|
73
68
|
* @cssproperty --heatmap-tone-1 - The quietest step of the magnitude ramp, reached by `tones="1 …"`.
|
|
@@ -105,12 +100,12 @@ export declare class HelixHeadlessHeatmap extends HelixHeadlessHeatmap_base {
|
|
|
105
100
|
* consumer has to keep by hand, and the one number a summary is told to trust
|
|
106
101
|
* is the one it gets wrong.
|
|
107
102
|
*
|
|
108
|
-
* The strip measures itself, so
|
|
109
|
-
*
|
|
110
|
-
*
|
|
111
|
-
*
|
|
112
|
-
*
|
|
113
|
-
*
|
|
103
|
+
* The strip measures itself, so sizing the cells in a sheet is enough on its
|
|
104
|
+
* own and these two are the estimate used until the first measurement lands.
|
|
105
|
+
* Writing the attribute pins the value and stops the measurement being
|
|
106
|
+
* consulted, which is what a container query or a transition on the cell size
|
|
107
|
+
* wants, where what is drawn this frame is not what the arithmetic should
|
|
108
|
+
* plan around.
|
|
114
109
|
*
|
|
115
110
|
* Zero turns the dropping off altogether, which is right for a strip in a
|
|
116
111
|
* container that cannot get narrow.
|
|
@@ -176,13 +171,13 @@ export declare class HelixHeadlessHeatmap extends HelixHeadlessHeatmap_base {
|
|
|
176
171
|
/**
|
|
177
172
|
* The cell and gap the strip is drawing, in pixels, once it has been read.
|
|
178
173
|
*
|
|
179
|
-
* **The arithmetic's inputs are a stylesheet's decisions, so the honest way
|
|
180
|
-
* learn them is to ask the stylesheet.** A cell's size is a length that
|
|
181
|
-
* the cascade can resolve: it may be a `rem` against a root font size, a
|
|
174
|
+
* **The arithmetic's inputs are a stylesheet's decisions, so the honest way
|
|
175
|
+
* to learn them is to ask the stylesheet.** A cell's size is a length that
|
|
176
|
+
* only the cascade can resolve: it may be a `rem` against a root font size, a
|
|
182
177
|
* percentage of a container, or whatever a container query chose this frame.
|
|
183
178
|
* Every one of those is invisible to a number typed into an attribute, and
|
|
184
|
-
*
|
|
185
|
-
*
|
|
179
|
+
* every hook a sheet offers for the cell box or the gap is one more way for
|
|
180
|
+
* the two to drift apart silently.
|
|
186
181
|
*
|
|
187
182
|
* Reading it back is not styling and does not breach the tier: this asks what
|
|
188
183
|
* was decided rather than deciding, which is the same direction as the facts
|
|
@@ -93,10 +93,10 @@ export declare class HelixHeadlessImage extends HelixElement {
|
|
|
93
93
|
* **Mirrored to `data-status`, and not reflected as `status`.** It is element
|
|
94
94
|
* state, so reflecting it puts the element's own bookkeeping into the markup
|
|
95
95
|
* a consumer rendered: React reads the attribute appearing at upgrade as a
|
|
96
|
-
* hydration mismatch, and a
|
|
97
|
-
*
|
|
98
|
-
*
|
|
99
|
-
*
|
|
96
|
+
* hydration mismatch, and a host pasted back carrying `status="loaded"`
|
|
97
|
+
* declares that a picture has arrived which this element has never fetched.
|
|
98
|
+
* The `data-` name is the library's answer to both, being a name a re-parse
|
|
99
|
+
* cannot mistake for a declaration, and it is what `data-closed` on
|
|
100
100
|
* `Toast.Item` already does. A picture arrives after somebody fetched it,
|
|
101
101
|
* which puts this on the safe side of hydration: a fact that can be true on
|
|
102
102
|
* the *first* update mirrors to a custom state instead, which is what
|
|
@@ -100,10 +100,10 @@ export declare class HelixHeadlessInput extends HelixHeadlessInput_base {
|
|
|
100
100
|
* **The attribute is `readonly`, which is the platform's spelling.** A
|
|
101
101
|
* camelCase property needs an explicit `attribute`, and dash-casing a word
|
|
102
102
|
* HTML writes as one costs what an attribute always costs here: nothing
|
|
103
|
-
* warns. `<helix-input readonly>` is what anybody who has written
|
|
104
|
-
* against `read-only` it parses to no property at all, and the
|
|
105
|
-
* editable with no error anywhere. Measured on the dash-cased
|
|
106
|
-
* came back `false`.
|
|
103
|
+
* warns. `<helix-headless-input readonly>` is what anybody who has written
|
|
104
|
+
* HTML types; against `read-only` it parses to no property at all, and the
|
|
105
|
+
* field stays editable with no error anywhere. Measured on the dash-cased
|
|
106
|
+
* form, `readOnly` came back `false`.
|
|
107
107
|
*/
|
|
108
108
|
readOnly: boolean;
|
|
109
109
|
/**
|
|
@@ -218,9 +218,9 @@ export declare class HelixHeadlessInput extends HelixHeadlessInput_base {
|
|
|
218
218
|
*
|
|
219
219
|
* **Not reflected.** Reflection exists so a selector can reach a value, and
|
|
220
220
|
* no stylesheet in this repository selects on `type`. Reflecting it writes
|
|
221
|
-
* `type="text"` onto every `<helix-input>` ever rendered, an
|
|
222
|
-
* consumer's markup has, which is the fault the area rules write
|
|
223
|
-
* `Button`'s `href`, `target` and `rel`.
|
|
221
|
+
* `type="text"` onto every `<helix-headless-input>` ever rendered, an
|
|
222
|
+
* attribute no consumer's markup has, which is the fault the area rules write
|
|
223
|
+
* up under `Button`'s `href`, `target` and `rel`.
|
|
224
224
|
*
|
|
225
225
|
* Nothing reads it from the attribute either. The real `<input>` inside takes
|
|
226
226
|
* it as a property binding, which is what makes the keyboard and the
|
|
@@ -156,8 +156,7 @@ export declare class HelixHeadlessLineChart extends HelixHeadlessLineChart_base
|
|
|
156
156
|
* over something busy. `triangle` points along the axis and reads as "and
|
|
157
157
|
* onward" rather than as a second claim about the data.
|
|
158
158
|
*
|
|
159
|
-
* The shapes come from
|
|
160
|
-
* `helix/styled/src/shared/chart/terminus.css`, the same sheet `Sparkline` takes, so
|
|
159
|
+
* The shapes come from one shared sheet, the same one `Sparkline` takes, so
|
|
161
160
|
* the set is identical wherever one appears. **Which is why every value is
|
|
162
161
|
* named here.** `Sparkline` shipped `square` implemented, drawn, asserted and
|
|
163
162
|
* undocumented until the cohort before this one; this family reads the same
|
|
@@ -65,13 +65,12 @@ export declare class HelixHeadlessListItem extends HelixElement {
|
|
|
65
65
|
* beside the words rather than at the edge of the block. A number that has to
|
|
66
66
|
* sit in a track has to be a box in that track.
|
|
67
67
|
*
|
|
68
|
-
* **The box belongs to the styled tier, which is why this returns
|
|
69
|
-
* Rendering it here puts an unstyled empty box in front of every
|
|
70
|
-
* and a row styled with `display: flex` and a `gap` draws that
|
|
71
|
-
* empty child: measured on this tier's own example, which is
|
|
72
|
-
* row, 1384 pixels moved and every label sat half a rem
|
|
73
|
-
*
|
|
74
|
-
* zero-width column.
|
|
68
|
+
* **The box belongs to the styled tier, which is why this returns
|
|
69
|
+
* `nothing`.** Rendering it here puts an unstyled empty box in front of every
|
|
70
|
+
* headless row, and a row styled with `display: flex` and a `gap` draws that
|
|
71
|
+
* gap beside the empty child: measured on this tier's own example, which is
|
|
72
|
+
* exactly such a row, 1384 pixels moved and every label sat half a rem
|
|
73
|
+
* further in.
|
|
75
74
|
*
|
|
76
75
|
* A tier that ships no CSS cannot make a box it renders cost nothing, so it
|
|
77
76
|
* does not render one. `marker="rail"` is a styled-tier attribute for the same
|
|
@@ -47,10 +47,10 @@ export declare class HelixHeadlessList extends HelixElement {
|
|
|
47
47
|
/**
|
|
48
48
|
* Which markers an ordered list draws, in `<ol type>`'s own five values.
|
|
49
49
|
*
|
|
50
|
-
* Reflected, because this is one of the things a stylesheet selects on
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
*
|
|
50
|
+
* Reflected, because this is one of the things a stylesheet selects on, each
|
|
51
|
+
* value mapping to a `list-style-type`. The platform's spellings rather than
|
|
52
|
+
* the CSS ones, so `<helix-headless-list kind="ordered" type="i">` is what a
|
|
53
|
+
* consumer would have written on an `<ol>`.
|
|
54
54
|
*
|
|
55
55
|
* **`start` and `reversed` are both absent and neither can be done here.**
|
|
56
56
|
* This renders no `<ol>`: the rows are slotted and numbered by the CSS
|
|
@@ -137,8 +137,8 @@ export declare class HelixHeadlessMegamenu extends HelixHeadlessMegamenu_base {
|
|
|
137
137
|
*
|
|
138
138
|
* **The first ancestor as wide as the window, which is a fact and not a tag
|
|
139
139
|
* name.** A band spans the viewport, so what it should hang from is whatever
|
|
140
|
-
* else does: that is what makes something a bar. Asking for `
|
|
141
|
-
*
|
|
140
|
+
* else does: that is what makes something a bar. Asking for `AppHeader` by
|
|
141
|
+
* name would make this element know about that one, which is the coupling
|
|
142
142
|
* `Menu` is careful not to have with `Drilldown`, and would leave a consumer
|
|
143
143
|
* who wrote their own header with a band across it.
|
|
144
144
|
*
|
|
@@ -228,8 +228,8 @@ export declare class HelixHeadlessMegamenu extends HelixHeadlessMegamenu_base {
|
|
|
228
228
|
* The control that opens it, behind a seam the styled tier can move.
|
|
229
229
|
*
|
|
230
230
|
* The same case `SpeedDial` records: a bare `<button>` is what this tier can
|
|
231
|
-
* write, `
|
|
232
|
-
*
|
|
231
|
+
* write, `Button` lives a tier above, and a render method is how a tier that
|
|
232
|
+
* has one reaches this without reimplementing the panel below it.
|
|
233
233
|
*/
|
|
234
234
|
protected renderTrigger(): TemplateResult;
|
|
235
235
|
protected render(): TemplateResult;
|
|
@@ -6,9 +6,9 @@ declare const HelixHeadlessNotification_base: (new (...args: any[]) => import("@
|
|
|
6
6
|
* @summary One thing that happened, which a reader may not have seen yet.
|
|
7
7
|
*
|
|
8
8
|
* @description
|
|
9
|
-
* A notification is a toast that did not go away. `
|
|
10
|
-
*
|
|
11
|
-
*
|
|
9
|
+
* A notification is a toast that did not go away. `Toast` is deliberately the
|
|
10
|
+
* opposite of this: a live region whose items carry a `duration` and whose root
|
|
11
|
+
* never creates or destroys anything. What makes this its own family is the
|
|
12
12
|
* state each item carries rather than the arrangement it sits in: read and
|
|
13
13
|
* unread, a timestamp that has to stay correct, and an action a reader can take
|
|
14
14
|
* later.
|
|
@@ -20,9 +20,9 @@ declare const HelixHeadlessNotification_base: (new (...args: any[]) => import("@
|
|
|
20
20
|
* reader wants exactly one of them at a time: the time while they are scanning,
|
|
21
21
|
* and what they can do about it once they have stopped on a row.
|
|
22
22
|
*
|
|
23
|
-
* **The timestamp is `
|
|
24
|
-
*
|
|
25
|
-
*
|
|
23
|
+
* **The timestamp is `FormatDate`**, which is where the reading, the `<time
|
|
24
|
+
* datetime>` and the shared timer now live. It was implemented here, and a
|
|
25
|
+
* component that formats a date is not a fact about notifications: Chat wanted
|
|
26
26
|
* the same thing and had its own copy of half of it.
|
|
27
27
|
*
|
|
28
28
|
* **Read state is reported, not invented.** Marking something read is usually a
|
|
@@ -86,10 +86,10 @@ export declare class HelixHeadlessNotification extends HelixHeadlessNotification
|
|
|
86
86
|
*
|
|
87
87
|
* **Not reflected.** Unread is a visual state, which is why the four mixins
|
|
88
88
|
* mirror theirs, but the mirror may not be the property's own attribute:
|
|
89
|
-
* `<helix-notification default-read>` comes back from a server
|
|
90
|
-
* and would gain it on the first update, which React reports
|
|
91
|
-
* mismatch, and which a copy of the serialized element
|
|
92
|
-
* declaration. `:state(read)` is what the stylesheet reads.
|
|
89
|
+
* `<helix-headless-notification default-read>` comes back from a server
|
|
90
|
+
* without `read` and would gain it on the first update, which React reports
|
|
91
|
+
* as a hydration mismatch, and which a copy of the serialized element
|
|
92
|
+
* re-parses as a declaration. `:state(read)` is what the stylesheet reads.
|
|
93
93
|
* `hydration.dom.spec.ts` holds it.
|
|
94
94
|
*/
|
|
95
95
|
get read(): boolean;
|
|
@@ -30,7 +30,7 @@ declare const HelixHeadlessNotifications_base: (new (...args: any[]) => import("
|
|
|
30
30
|
* @aliases Notification feed, Inbox, Activity
|
|
31
31
|
* @documentation https://fusion.dev/helix/components/notifications
|
|
32
32
|
*
|
|
33
|
-
* @slot - The notifications
|
|
33
|
+
* @slot - The notifications.
|
|
34
34
|
* @slot footer - Below the list, for a link to everything.
|
|
35
35
|
* @slot header - Above the list, for a title and the mark-all control.
|
|
36
36
|
*
|
|
@@ -107,7 +107,7 @@ export declare class HelixHeadlessOption extends HelixElement {
|
|
|
107
107
|
* **The attribute, read when it is asked for, and never a snapshot taken in
|
|
108
108
|
* the constructor.** A field initializer runs there, and an element the HTML
|
|
109
109
|
* parser created has none of its attributes yet at that moment: measured on
|
|
110
|
-
* this element, on `Radio` and on `Toggle`, `<helix-option value="a"
|
|
110
|
+
* this element, on `Radio` and on `Toggle`, `<helix-headless-option value="a"
|
|
111
111
|
* selected>` reported `defaultSelected` as `false` both from parsed markup
|
|
112
112
|
* and from `createElement` followed by `setAttribute`, which is every way a
|
|
113
113
|
* consumer writes one. The snapshot could only ever be true for an element
|
|
@@ -223,8 +223,8 @@ export declare class HelixHeadlessOption extends HelixElement {
|
|
|
223
223
|
* where it is not in the DOM at all.
|
|
224
224
|
*
|
|
225
225
|
* Reading `selected` is unaffected and so is writing it: the attribute still
|
|
226
|
-
* seeds the property, which is what `<helix-option selected>` in a
|
|
227
|
-
* markup means. What stops is the write back.
|
|
226
|
+
* seeds the property, which is what `<helix-headless-option selected>` in a
|
|
227
|
+
* consumer's markup means. What stops is the write back.
|
|
228
228
|
*/
|
|
229
229
|
protected willUpdate(changed: PropertyValues): void;
|
|
230
230
|
protected render(): TemplateResult;
|
|
@@ -6,8 +6,8 @@ import { type PropertyValues, type TemplateResult } from 'lit';
|
|
|
6
6
|
* @description
|
|
7
7
|
* **The component is the truncation.** Given a page and a total it works out
|
|
8
8
|
* which numbers to show and where the runs break, so this is data-driven rather
|
|
9
|
-
* than composed: `<helix-pagination page="4" pages="12">` rather than
|
|
10
|
-
* slotted children a consumer keeps in step with their own query.
|
|
9
|
+
* than composed: `<helix-headless-pagination page="4" pages="12">` rather than
|
|
10
|
+
* twelve slotted children a consumer keeps in step with their own query.
|
|
11
11
|
*
|
|
12
12
|
* **The width does not change as you page.** The run around the current page is
|
|
13
13
|
* `siblings` either side, and grows to absorb a gap slot at a boundary, so the
|
|
@@ -110,10 +110,10 @@ export declare class HelixHeadlessPinInput extends HelixHeadlessPinInput_base {
|
|
|
110
110
|
* marked letters wants `text`, which judges nothing.
|
|
111
111
|
*
|
|
112
112
|
* **Not reflected**: nothing selects on it, so reflecting only writes
|
|
113
|
-
* `type="numeric"` onto every `<helix-pin-input>` ever rendered, an
|
|
114
|
-
* no consumer's markup had. The area rules carry the sentence
|
|
115
|
-
* what CSS selects on". The real inputs take it as a binding,
|
|
116
|
-
* makes the keyboard follow.
|
|
113
|
+
* `type="numeric"` onto every `<helix-headless-pin-input>` ever rendered, an
|
|
114
|
+
* attribute no consumer's markup had. The area rules carry the sentence
|
|
115
|
+
* "reflect only what CSS selects on". The real inputs take it as a binding,
|
|
116
|
+
* which is what makes the keyboard follow.
|
|
117
117
|
*/
|
|
118
118
|
type: PinType;
|
|
119
119
|
/** Focus is delegated, so the host is never the focus target. */
|
|
@@ -64,12 +64,13 @@ export declare class HelixHeadlessPopover extends HelixHeadlessPopover_base {
|
|
|
64
64
|
* The invoker that last opened the panel, when a command did.
|
|
65
65
|
*
|
|
66
66
|
* Kept because the `source` a command hands the handlers is needed twice
|
|
67
|
-
* over. It is the anchor: the
|
|
68
|
-
*
|
|
69
|
-
* against the window origin. And the outside-press
|
|
70
|
-
* invoker is part of the control, the press firing
|
|
71
|
-
* command arriving on the `click` after it, or a
|
|
72
|
-
* the host closes the panel and immediately reopens
|
|
67
|
+
* over. It is the anchor: the host is not a box to position against, a sheet
|
|
68
|
+
* being free to give it none, so a popover opened by a command outside it
|
|
69
|
+
* would otherwise open against the window origin. And the outside-press
|
|
70
|
+
* dismissal has to know the invoker is part of the control, the press firing
|
|
71
|
+
* on `pointerdown` and the command arriving on the `click` after it, or a
|
|
72
|
+
* `--toggle` button outside the host closes the panel and immediately reopens
|
|
73
|
+
* it, for ever.
|
|
73
74
|
*/
|
|
74
75
|
private invoker;
|
|
75
76
|
protected readonly commands: CommandController;
|
|
@@ -54,7 +54,7 @@ export declare class HelixHeadlessRadio extends HelixHeadlessRadio_base {
|
|
|
54
54
|
* **The attribute, read when it is asked for, and never a snapshot taken in
|
|
55
55
|
* the constructor.** A field initializer runs there, and an element the HTML
|
|
56
56
|
* parser created has none of its attributes yet at that moment: measured on
|
|
57
|
-
* this element, on `Option` and on `Toggle`, `<helix-radio value="a"
|
|
57
|
+
* this element, on `Option` and on `Toggle`, `<helix-headless-radio value="a"
|
|
58
58
|
* selected>` reported `defaultSelected` as `false` both from parsed markup
|
|
59
59
|
* and from `createElement` followed by `setAttribute`, which is every way a
|
|
60
60
|
* consumer writes one. The snapshot could only ever be true for an element
|
|
@@ -15,11 +15,10 @@ declare const HelixHeadlessSpeedDial_base: (new (...args: any[]) => import("@fus
|
|
|
15
15
|
* mean defining what a dial with a submenu in it does.
|
|
16
16
|
*
|
|
17
17
|
* **The trigger is a control the consumer slots**, and the floating action
|
|
18
|
-
* button is the usual one: `
|
|
19
|
-
*
|
|
20
|
-
* `
|
|
21
|
-
*
|
|
22
|
-
* layer.
|
|
18
|
+
* button is the usual one: `IconButton` with `shape="circle"` and `raised`.
|
|
19
|
+
* There is no `helix-fab`, because it would re-declare `emphasis`, `tone`,
|
|
20
|
+
* `label` and a size around a control that already has all four. A round raised
|
|
21
|
+
* button is a shape, and where it sits is `data-dock` in the base layer.
|
|
23
22
|
*
|
|
24
23
|
* **Nothing is reserved from the keyboard.** A menu that drills has to keep the
|
|
25
24
|
* horizontal pair for going in and coming back; a dial goes nowhere, so all four
|
|
@@ -105,10 +104,10 @@ export declare class HelixHeadlessSpeedDial extends HelixHeadlessSpeedDial_base
|
|
|
105
104
|
*
|
|
106
105
|
* **This is the case the tier rule blocks and a render method unblocks.** A
|
|
107
106
|
* bare `<button>` is what the headless tier can write: it must not reach for
|
|
108
|
-
* `
|
|
109
|
-
*
|
|
110
|
-
* of its own overrides this to use one. Written inline, the only way
|
|
111
|
-
*
|
|
107
|
+
* `Button`, which lives a tier above and would make `headless` depend on
|
|
108
|
+
* `styled`. So the base draws the plain control and a tier that has buttons
|
|
109
|
+
* of its own overrides this to use one. Written inline, the only way to
|
|
110
|
+
* change it would be to reimplement the template, panel and all.
|
|
112
111
|
*/
|
|
113
112
|
protected renderTrigger(): TemplateResult;
|
|
114
113
|
protected render(): TemplateResult;
|
|
@@ -35,9 +35,9 @@ export declare class HelixHeadlessStat extends HelixElement {
|
|
|
35
35
|
* The row directions set them side by side, for a figure in a line of text or
|
|
36
36
|
* a narrow strip where a stacked pair would be two lines of almost nothing.
|
|
37
37
|
*
|
|
38
|
-
* A property rather than a `
|
|
39
|
-
*
|
|
40
|
-
*
|
|
38
|
+
* A property rather than a `Flex` around it, because the unit has to stay on
|
|
39
|
+
* the value's baseline whichever way the pair goes, and only this element
|
|
40
|
+
* knows which of its children the unit belongs to.
|
|
41
41
|
*
|
|
42
42
|
* **Optional rather than defaulted to `column`, which is not a style
|
|
43
43
|
* preference.** A reflecting property with a default writes its attribute onto
|
|
@@ -22,7 +22,7 @@ declare const HelixHeadlessSteps_base: (new (...args: any[]) => import("@fusion.
|
|
|
22
22
|
* @aliases Stepper, Wizard, Progress steps
|
|
23
23
|
* @documentation https://fusion.dev/helix/components/steps
|
|
24
24
|
*
|
|
25
|
-
* @slot - The steps
|
|
25
|
+
* @slot - The steps.
|
|
26
26
|
*
|
|
27
27
|
* @event {HelixActivateEvent} helix-activate - Fired once the current one has moved, so the element already holds it.
|
|
28
28
|
* @event {HelixBeforeActivateEvent} helix-before-activate - Fired before the active step changes. Cancelable: refusing it takes the decision and nothing moves.
|
|
@@ -6,9 +6,9 @@ import '../../button/index.js';
|
|
|
6
6
|
*
|
|
7
7
|
* @description
|
|
8
8
|
* **The name is a button, and only the name.** The marker is `aria-hidden`
|
|
9
|
-
* decoration, so wrapping it would add hit area and no meaning. It is
|
|
10
|
-
*
|
|
11
|
-
*
|
|
9
|
+
* decoration, so wrapping it would add hit area and no meaning. It is `Button`
|
|
10
|
+
* rather than a `<button>` this element resets: the hover wash, the focus ring
|
|
11
|
+
* and the disabled treatment are decisions the button carries.
|
|
12
12
|
*
|
|
13
13
|
* **It says nothing about where a reader may go.** Every step is pressable and
|
|
14
14
|
* announces itself with `helix-select`; refusing the ones ahead is `disabled`,
|
|
@@ -27,7 +27,7 @@ import '../../button/index.js';
|
|
|
27
27
|
* @documentation https://fusion.dev/helix/components/steps
|
|
28
28
|
*
|
|
29
29
|
* @slot - The step's name.
|
|
30
|
-
* @slot content - What the stage holds. Always rendered here, a tier with no stylesheet having nothing to fold it with
|
|
30
|
+
* @slot content - What the stage holds. Always rendered here, a tier with no stylesheet having nothing to fold it with, so whether it is folded away is the sheet's answer and not this tier's.
|
|
31
31
|
* @slot description - A line under the name, for what the stage is for.
|
|
32
32
|
* @slot marker - Replaces the number, or the check a complete step shows.
|
|
33
33
|
*
|
|
@@ -36,7 +36,7 @@ import '../../button/index.js';
|
|
|
36
36
|
* @csspart body - The name and its description.
|
|
37
37
|
* @csspart content - What the stage holds, while it is open.
|
|
38
38
|
* @csspart description - The line under it.
|
|
39
|
-
* @csspart label - The step's name, which is a
|
|
39
|
+
* @csspart label - The step's name, which is a control.
|
|
40
40
|
* @csspart label-button - The inner control.
|
|
41
41
|
* @csspart lead - The half line arriving from the step before.
|
|
42
42
|
* @csspart mark - The glyph inside the marker: a tick, a dot, or an empty ring.
|