@f-ewald/components 1.23.0 → 1.24.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/README.md +7 -1
- package/custom-elements.json +1966 -643
- package/dist/address-autocomplete.d.ts.map +1 -1
- package/dist/address-autocomplete.js +7 -3
- package/dist/address-autocomplete.js.map +1 -1
- package/dist/audio-player.d.ts +53 -0
- package/dist/audio-player.d.ts.map +1 -0
- package/dist/audio-player.js +267 -0
- package/dist/audio-player.js.map +1 -0
- package/dist/autocomplete-input.d.ts.map +1 -1
- package/dist/autocomplete-input.js +7 -3
- package/dist/autocomplete-input.js.map +1 -1
- package/dist/button-group.d.ts +12 -1
- package/dist/button-group.d.ts.map +1 -1
- package/dist/button-group.js +35 -3
- package/dist/button-group.js.map +1 -1
- package/dist/comment-composer.d.ts +54 -0
- package/dist/comment-composer.d.ts.map +1 -0
- package/dist/comment-composer.js +244 -0
- package/dist/comment-composer.js.map +1 -0
- package/dist/confirm-dialog.d.ts +4 -1
- package/dist/confirm-dialog.d.ts.map +1 -1
- package/dist/confirm-dialog.js +47 -9
- package/dist/confirm-dialog.js.map +1 -1
- package/dist/dropdown-button.d.ts +4 -1
- package/dist/dropdown-button.d.ts.map +1 -1
- package/dist/dropdown-button.js +29 -3
- package/dist/dropdown-button.js.map +1 -1
- package/dist/icons.d.ts +65 -0
- package/dist/icons.d.ts.map +1 -1
- package/dist/icons.js +65 -0
- package/dist/icons.js.map +1 -1
- package/dist/index.d.ts +4 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp-server.js +39 -0
- package/dist/mcp-server.js.map +1 -1
- package/dist/page-header.d.ts +8 -3
- package/dist/page-header.d.ts.map +1 -1
- package/dist/page-header.js +33 -12
- package/dist/page-header.js.map +1 -1
- package/dist/pagination-nav.d.ts +7 -0
- package/dist/pagination-nav.d.ts.map +1 -1
- package/dist/pagination-nav.js +19 -4
- package/dist/pagination-nav.js.map +1 -1
- package/dist/radio-cards.d.ts +6 -0
- package/dist/radio-cards.d.ts.map +1 -1
- package/dist/radio-cards.js +13 -3
- package/dist/radio-cards.js.map +1 -1
- package/dist/radio-pills.d.ts +6 -0
- package/dist/radio-pills.d.ts.map +1 -1
- package/dist/radio-pills.js +13 -3
- package/dist/radio-pills.js.map +1 -1
- package/dist/range-slider.d.ts.map +1 -1
- package/dist/range-slider.js +11 -7
- package/dist/range-slider.js.map +1 -1
- package/dist/reveal-button.d.ts +5 -1
- package/dist/reveal-button.d.ts.map +1 -1
- package/dist/reveal-button.js +26 -4
- package/dist/reveal-button.js.map +1 -1
- package/dist/tokens.css +17 -0
- package/dist/tokens.d.ts.map +1 -1
- package/dist/tokens.js +56 -0
- package/dist/tokens.js.map +1 -1
- package/dist/ui-button.d.ts +16 -0
- package/dist/ui-button.d.ts.map +1 -1
- package/dist/ui-button.js +48 -7
- package/dist/ui-button.js.map +1 -1
- package/dist/utils/duration.d.ts +8 -0
- package/dist/utils/duration.d.ts.map +1 -1
- package/dist/utils/duration.js +18 -0
- package/dist/utils/duration.js.map +1 -1
- package/dist/utils/transport-controls.d.ts +11 -0
- package/dist/utils/transport-controls.d.ts.map +1 -0
- package/dist/utils/transport-controls.js +113 -0
- package/dist/utils/transport-controls.js.map +1 -0
- package/dist/video-player.d.ts +60 -0
- package/dist/video-player.d.ts.map +1 -0
- package/dist/video-player.js +324 -0
- package/dist/video-player.js.map +1 -0
- package/docs/audio-player.md +60 -0
- package/docs/button-group.md +18 -1
- package/docs/comment-composer.md +68 -0
- package/docs/confirm-dialog.md +19 -1
- package/docs/dropdown-button.md +10 -1
- package/docs/icons.md +75 -0
- package/docs/page-header.md +11 -4
- package/docs/pagination-nav.md +14 -0
- package/docs/radio-cards.md +9 -0
- package/docs/radio-pills.md +9 -0
- package/docs/range-slider.md +3 -0
- package/docs/reveal-button.md +11 -1
- package/docs/ui-button.md +32 -0
- package/docs/video-player.md +59 -0
- package/llms.txt +224 -23
- package/package.json +1 -1
package/llms.txt
CHANGED
|
@@ -16,6 +16,73 @@ render correctly with zero external CSS. Override any `--ui-*` property on
|
|
|
16
16
|
`:root` (or an ancestor) to retheme, or import the optional
|
|
17
17
|
`@f-ewald/components/tokens.css` stylesheet as a starting point.
|
|
18
18
|
|
|
19
|
+
## Icons
|
|
20
|
+
|
|
21
|
+
Import from `@f-ewald/components/icons.js`, e.g. `iconPencil(16)`. Use this
|
|
22
|
+
table to pick the icon matching a use case, for consistency across apps:
|
|
23
|
+
|
|
24
|
+
| Icon | Default size | Use for |
|
|
25
|
+
| --- | --- | --- |
|
|
26
|
+
| `iconAcademicCap` | 18px | Education, learning, or certification-related content. |
|
|
27
|
+
| `iconArrowDownTray` | 16px | Download or export actions. |
|
|
28
|
+
| `iconArrowPath` | 12px | Refresh actions, or an animated busy/loading spinner. |
|
|
29
|
+
| `iconArrowRight` | 12px | "Continue" or forward-progressing actions, e.g. a compact next-step arrow. |
|
|
30
|
+
| `iconArrowRightOnRectangle` | 16px | Logout/sign-out actions. |
|
|
31
|
+
| `iconArrowsPointingIn` | 16px | "Exit fullscreen" actions; pair with iconArrowsPointingOut for entering fullscreen. |
|
|
32
|
+
| `iconArrowsPointingOut` | 16px | "Expand" or "view fullscreen" actions. |
|
|
33
|
+
| `iconArrowsRightLeft` | 16px | Swap, exchange, or compare actions between two items. |
|
|
34
|
+
| `iconArrowTopRightOnSquare` | 16px | Links that open in a new tab/window, or navigate to an external site. |
|
|
35
|
+
| `iconBars3` | 18px | A hamburger menu toggle, e.g. collapsing or opening a sidebar/nav drawer. |
|
|
36
|
+
| `iconCalendar` | 16px | Dates, due dates, or calendar-related metadata. |
|
|
37
|
+
| `iconChatBubbleLeftRight` | 18px | Messaging, comments, or conversation-related content. |
|
|
38
|
+
| `iconCheckCircle` | 16px | Success states, confirmations, or a selected-item checkmark. |
|
|
39
|
+
| `iconChevronDown` | 16px | "Scroll to bottom", a downward disclosure, or an expanded tree/accordion indicator. |
|
|
40
|
+
| `iconChevronLeft` | 16px | "Previous" navigation, e.g. pagination or carousel back controls. |
|
|
41
|
+
| `iconChevronRight` | 16px | "Next" navigation, or a collapsed disclosure/submenu indicator. |
|
|
42
|
+
| `iconChevronUp` | 16px | "Scroll to top", or an expanded/upward disclosure control. |
|
|
43
|
+
| `iconClipboardDocumentList` | 18px | Task lists, checklists, or clipboard/notes content. |
|
|
44
|
+
| `iconClock` | 16px | Timestamps, durations, or time-related metadata. |
|
|
45
|
+
| `iconCodeBracketSquare` | 16px | Code snippets, developer tools, or technical/API content. |
|
|
46
|
+
| `iconCog` | 20px | Settings, preferences, or configuration entry points. |
|
|
47
|
+
| `iconComputerDesktop` | 16px | A "system/auto" theme option, or to represent a desktop device. |
|
|
48
|
+
| `iconCpuChip` | 18px | System, hardware, or technical/processing content. |
|
|
49
|
+
| `iconCurrencyDollar` | 16px | Monetary values, pricing, or billing-related content. |
|
|
50
|
+
| `iconDocument` | 18px | A generic file/document icon, e.g. tile-grid's default file icon. |
|
|
51
|
+
| `iconEllipsisVertical` | 16px | An overflow ("kebab") menu trigger, e.g. dropdown-button's icon variant. |
|
|
52
|
+
| `iconExclamationCircle` | 16px | Error states, e.g. the error variant of toast-notification. |
|
|
53
|
+
| `iconExclamationTriangle` | 16px | Warning states, e.g. the warning variant of toast-notification. |
|
|
54
|
+
| `iconEye` | 16px | "Show"/"preview" actions or a visible/reviewed state, e.g. password visibility or a review status. |
|
|
55
|
+
| `iconEyeSlash` | 16px | "Hide" actions or a hidden/masked state; pair with iconEye for the visible state. |
|
|
56
|
+
| `iconFolder` | 18px | Folders, directories, or grouped file content. |
|
|
57
|
+
| `iconHeart` | 16px | "Like"/"favorite" actions in their unselected state. |
|
|
58
|
+
| `iconHeartSolid` | 16px | "Like"/"favorite" actions in their selected/active state; pair with iconHeart for the unselected state. |
|
|
59
|
+
| `iconHome` | 16px | A primary navigation link to the app's home or dashboard. |
|
|
60
|
+
| `iconInfo` | 20px | Neutral informational messages, e.g. an info toast or status banner. |
|
|
61
|
+
| `iconLink` | 16px | Copy-link or hyperlink-related actions, e.g. copy-link-button. |
|
|
62
|
+
| `iconListBullet` | 18px | A list-view toggle, or to represent list-type content. |
|
|
63
|
+
| `iconMap` | 16px | A map-view toggle, or to represent map/geographic content. |
|
|
64
|
+
| `iconMapPin` | 16px | A location, address, or map marker. |
|
|
65
|
+
| `iconMoon` | 16px | A dark-theme toggle, or to represent night/dark mode. |
|
|
66
|
+
| `iconPause` | 18px | "Pause" transport actions, e.g. audio-player/video-player's playing state. |
|
|
67
|
+
| `iconPencil` | 16px | Edit actions, e.g. an edit icon-button or inline edit toggle. |
|
|
68
|
+
| `iconPlay` | 18px | "Play" transport actions, e.g. audio-player/video-player's paused state. |
|
|
69
|
+
| `iconPlus` | 16px | "Add new" actions, e.g. creating a new item or row. |
|
|
70
|
+
| `iconPuzzlePiece` | 18px | Plugins, integrations, or extensible/add-on features. |
|
|
71
|
+
| `iconQuestionMarkCircle` | 20px | Help, tooltips, or "learn more" affordances. |
|
|
72
|
+
| `iconQueueList` | 16px | Queues, backlogs, or ordered work-item lists. |
|
|
73
|
+
| `iconShieldCheck` | 16px | Verified, secure, or trusted states. |
|
|
74
|
+
| `iconShieldExclamation` | 16px | Security warnings, or at-risk/compromised states. |
|
|
75
|
+
| `iconSpeakerWave` | 18px | An unmuted volume control, e.g. audio-player/video-player's mute toggle. |
|
|
76
|
+
| `iconSpeakerXMark` | 18px | A muted volume state; pair with iconSpeakerWave for the unmuted state. |
|
|
77
|
+
| `iconSquares2x2` | 18px | A grid or kanban-view toggle, or to represent card/tile layouts. |
|
|
78
|
+
| `iconSun` | 16px | A light-theme toggle, or to represent daytime/light mode. |
|
|
79
|
+
| `iconTag` | 16px | Tags, labels, or categorical metadata. |
|
|
80
|
+
| `iconTrash` | 16px | Delete/remove actions, typically paired with a destructive/danger style. |
|
|
81
|
+
| `iconUserCircle` | 20px | A generic user/person fallback, e.g. user-avatar's icon fallback. |
|
|
82
|
+
| `iconUsers` | 18px | Teams, groups, or multi-user/collaboration content. |
|
|
83
|
+
| `iconWrenchScrewdriver` | 18px | Tools, maintenance, or build/configuration actions. |
|
|
84
|
+
| `iconX` | 18px | Close, dismiss, or clear (e.g. a modal, toast, or clearable input). |
|
|
85
|
+
|
|
19
86
|
## <action-bar>
|
|
20
87
|
|
|
21
88
|
Toolbar that sits directly above a list or table: a left cluster for
|
|
@@ -173,6 +240,33 @@ Example:
|
|
|
173
240
|
</app-sidebar>
|
|
174
241
|
```
|
|
175
242
|
|
|
243
|
+
## <audio-player>
|
|
244
|
+
|
|
245
|
+
Compact audio player wrapping a native `<audio>` element (kept off-screen
|
|
246
|
+
for its decoding/playback engine and free `timeupdate`/`loadedmetadata`
|
|
247
|
+
events) behind a tokenized transport bar: a play/pause `icon-button`,
|
|
248
|
+
elapsed/total time, a seekable progress bar, and a mute toggle + volume
|
|
249
|
+
slider. The seek/volume sliders are native `<input type="range">`
|
|
250
|
+
elements (see `utils/transport-controls.ts`) for free keyboard and
|
|
251
|
+
pointer support, per this package's "native semantics before custom ARIA"
|
|
252
|
+
rule.
|
|
253
|
+
|
|
254
|
+
Import: `import "@f-ewald/components/audio-player.js";`
|
|
255
|
+
|
|
256
|
+
Properties: `src` (attribute `src`) : string, default ""; `label` (attribute `label`) : string, default "Audio player"; `loop` (attribute `loop`) : boolean, default false; `preload` (attribute `preload`) : "none" | "metadata" | "auto", default "metadata"
|
|
257
|
+
Events: `play`, `pause`, `ended`
|
|
258
|
+
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`
|
|
259
|
+
|
|
260
|
+
Example:
|
|
261
|
+
```html
|
|
262
|
+
<audio-player src="/episode-12.mp3" label="Episode 12"></audio-player>
|
|
263
|
+
<script type="module">
|
|
264
|
+
document.querySelector("audio-player").addEventListener("ended", () => {
|
|
265
|
+
console.log("playback finished");
|
|
266
|
+
});
|
|
267
|
+
</script>
|
|
268
|
+
```
|
|
269
|
+
|
|
176
270
|
## <auto-scroll>
|
|
177
271
|
|
|
178
272
|
Wraps arbitrary slotted content (e.g. `timeline-container`) and keeps it
|
|
@@ -258,13 +352,22 @@ choices (a view switcher, a theme picker) where the *currently selected*
|
|
|
258
352
|
option should read as visually "pressed," not just checked. For many
|
|
259
353
|
short, individually pill-shaped choices, use `radio-pills` instead. Wraps
|
|
260
354
|
native radio inputs for keyboard/a11y and fires `change` rather than
|
|
261
|
-
relying on form submission.
|
|
355
|
+
relying on form submission. Set `size="sm"` for a compact strip one step
|
|
356
|
+
below the default, matching `ui-button`'s `sm` size.
|
|
357
|
+
|
|
358
|
+
The checked segment reads `--ui-button-background`/`-hover`/`-active`,
|
|
359
|
+
same as `ui-button`'s `primary` variant. Unchecked segments are treated as
|
|
360
|
+
`ui-button`'s `secondary` variant: they read the shared
|
|
361
|
+
`--ui-button-secondary-background`/`-active` (rest/pressed) so a gradient
|
|
362
|
+
theme applies consistently, but use the shared `--ui-button-secondary-surface-muted`
|
|
363
|
+
(also used by `pagination-nav`) for hover, since — unlike `secondary` — an
|
|
364
|
+
unchecked segment already paints `--ui-surface-muted` on hover by default.
|
|
262
365
|
|
|
263
366
|
Import: `import "@f-ewald/components/button-group.js";`
|
|
264
367
|
|
|
265
|
-
Properties: `options` (JS property only) : ButtonGroupOption[], default []; `value` (attribute `value`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false; `iconOnly` (attribute `icon-only`) : boolean, default false
|
|
368
|
+
Properties: `options` (JS property only) : ButtonGroupOption[], default []; `value` (attribute `value`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false; `iconOnly` (attribute `icon-only`) : boolean, default false; `size` (attribute `size`) : "sm" | "md", default "md"
|
|
266
369
|
Events: `change`
|
|
267
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`
|
|
370
|
+
CSS custom properties: `--ui-border`, `--ui-button-background`, `--ui-button-highlight`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-surface-muted`, `--ui-button-text-shadow`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`
|
|
268
371
|
|
|
269
372
|
Example:
|
|
270
373
|
```html
|
|
@@ -428,19 +531,51 @@ Example:
|
|
|
428
531
|
</chat-message>
|
|
429
532
|
```
|
|
430
533
|
|
|
534
|
+
## <comment-composer>
|
|
535
|
+
|
|
536
|
+
GitHub/Slack-style comment composer: a one-line text field that expands
|
|
537
|
+
into a multi-line textarea with a bottom-right Cancel/Submit footer
|
|
538
|
+
(`form-actions`) as soon as it's focused or clicked. Submitting fires
|
|
539
|
+
`submit` with the trimmed value, then clears the field and collapses back
|
|
540
|
+
to one line — it's meant for posting one comment at a time, not editing a
|
|
541
|
+
persistent value in place (see `editable-text` for that). Canceling (the
|
|
542
|
+
Cancel button or `Escape`) discards the draft and collapses without
|
|
543
|
+
firing `submit`. Clicking away (blur) does neither — the composer stays
|
|
544
|
+
expanded until the user explicitly submits or cancels. `Cmd`/`Ctrl`+`Enter`
|
|
545
|
+
submits from the textarea, matching `editable-text`'s multiline shortcut.
|
|
546
|
+
Purely token-styled (no bespoke colors), so it's themeable via the same
|
|
547
|
+
`--ui-*` custom properties as every other value-entry field.
|
|
548
|
+
|
|
549
|
+
Import: `import "@f-ewald/components/comment-composer.js";`
|
|
550
|
+
|
|
551
|
+
Properties: `value` (attribute `value`) : string, default ""; `placeholder` (attribute `placeholder`) : string, default "Add a comment…"; `label` (attribute `label`) : string, default "Comment"; `rows` (attribute `rows`) : number, default 4; `submitLabel` (attribute `submit-label`) : string, default "Submit"; `cancelLabel` (attribute `cancel-label`) : string, default "Cancel"; `disabled` (attribute `disabled`) : boolean, default false
|
|
552
|
+
Events: `cancel`, `submit`
|
|
553
|
+
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-line-height-normal`, `--ui-radius`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`
|
|
554
|
+
|
|
555
|
+
Example:
|
|
556
|
+
```html
|
|
557
|
+
<comment-composer placeholder="Add a comment…"></comment-composer>
|
|
558
|
+
<script type="module">
|
|
559
|
+
document.querySelector("comment-composer").addEventListener("submit", (e) => {
|
|
560
|
+
postComment(e.detail.value);
|
|
561
|
+
});
|
|
562
|
+
</script>
|
|
563
|
+
```
|
|
564
|
+
|
|
431
565
|
## <confirm-dialog>
|
|
432
566
|
|
|
433
567
|
Reusable confirmation dialog: overlay + centered card with a slotted body,
|
|
434
568
|
an optional error line, and Cancel/Confirm actions. Instant `display:none`
|
|
435
569
|
→ `display:flex` toggle (no transitions). Fires `confirm`/`cancel`
|
|
436
570
|
(bubbling, composed) instead of owning any deletion logic itself —
|
|
437
|
-
callers stay in charge of the request.
|
|
571
|
+
callers stay in charge of the request. Set `size="sm"` for compact
|
|
572
|
+
actions one step below the default, matching `ui-button`'s `sm` size.
|
|
438
573
|
|
|
439
574
|
Import: `import "@f-ewald/components/confirm-dialog.js";`
|
|
440
575
|
|
|
441
|
-
Properties: `open` (attribute `open`) : boolean, default false; `confirmLabel` (attribute `confirm-label`) : string, default "Delete"; `cancelLabel` (attribute `cancel-label`) : string, default "Cancel"; `danger` (attribute `danger`) : boolean, default true; `busy` (attribute `busy`) : boolean, default false; `error` (attribute `error`) : string | null, default null
|
|
576
|
+
Properties: `open` (attribute `open`) : boolean, default false; `confirmLabel` (attribute `confirm-label`) : string, default "Delete"; `cancelLabel` (attribute `cancel-label`) : string, default "Cancel"; `danger` (attribute `danger`) : boolean, default true; `busy` (attribute `busy`) : boolean, default false; `error` (attribute `error`) : string | null, default null; `size` (attribute `size`) : "sm" | "md", default "md"
|
|
442
577
|
Events: `confirm`, `cancel`
|
|
443
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
|
|
578
|
+
CSS custom properties: `--ui-border`, `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-danger-background`, `--ui-button-danger-background-active`, `--ui-button-danger-background-hover`, `--ui-button-danger-border`, `--ui-button-highlight`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-button-text-shadow`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
|
|
444
579
|
|
|
445
580
|
Example:
|
|
446
581
|
```html
|
|
@@ -585,13 +720,14 @@ primary-filled button with a label and a rotating chevron), `text-icon`
|
|
|
585
720
|
(the same, with `icon` ahead of the label), and `icon` (a borderless,
|
|
586
721
|
square, low-emphasis icon target in the style of `icon-button` — the
|
|
587
722
|
classic "three-dot"/overflow menu, where `label` becomes the accessible
|
|
588
|
-
name rather than visible text).
|
|
723
|
+
name rather than visible text). Set `size="sm"` for a compact trigger one
|
|
724
|
+
step below the default, matching `ui-button`'s `sm` size.
|
|
589
725
|
|
|
590
726
|
Import: `import "@f-ewald/components/dropdown-button.js";`
|
|
591
727
|
|
|
592
|
-
Properties: `label` (attribute `label`) : string, default ""; `options` (JS property only) : DropdownOption[], default []; `disabled` (attribute `disabled`) : boolean, default false; `variant` (attribute `variant`) : DropdownButtonVariant, default "text"; `icon` (JS property only) : TemplateResult | null, default null
|
|
728
|
+
Properties: `label` (attribute `label`) : string, default ""; `options` (JS property only) : DropdownOption[], default []; `disabled` (attribute `disabled`) : boolean, default false; `variant` (attribute `variant`) : DropdownButtonVariant, default "text"; `icon` (JS property only) : TemplateResult | null, default null; `size` (attribute `size`) : "sm" | "md", default "md"
|
|
593
729
|
Events: `select`
|
|
594
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
730
|
+
CSS custom properties: `--ui-border`, `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-highlight`, `--ui-button-text-shadow`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
595
731
|
|
|
596
732
|
Example:
|
|
597
733
|
```html
|
|
@@ -1298,19 +1434,22 @@ Example:
|
|
|
1298
1434
|
## <page-header>
|
|
1299
1435
|
|
|
1300
1436
|
Page title block for the top of a dashboard view: an optional breadcrumb
|
|
1301
|
-
trail, the page heading
|
|
1302
|
-
|
|
1303
|
-
the
|
|
1437
|
+
trail, the page heading with a right-aligned cluster of page-level actions
|
|
1438
|
+
beside it, and an optional description of what the page is for underneath.
|
|
1439
|
+
The actions sit in the title row rather than beside the whole block, so a
|
|
1440
|
+
longer or wrapping description never moves them. It only lays these out —
|
|
1441
|
+
the breadcrumb links and action buttons are entirely the consumer's, so it
|
|
1442
|
+
stays framework- and router-agnostic.
|
|
1304
1443
|
|
|
1305
1444
|
Import: `import "@f-ewald/components/page-header.js";`
|
|
1306
1445
|
|
|
1307
|
-
Properties: `heading` (attribute `heading`) : string, default ""
|
|
1446
|
+
Properties: `heading` (attribute `heading`) : string, default ""; `description` (attribute `description`) : string, default ""
|
|
1308
1447
|
Events: none
|
|
1309
|
-
CSS custom properties: `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-text`, `--ui-text-muted`
|
|
1448
|
+
CSS custom properties: `--ui-font`, `--ui-font-size`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-text`, `--ui-text-muted`
|
|
1310
1449
|
|
|
1311
1450
|
Example:
|
|
1312
1451
|
```html
|
|
1313
|
-
<page-header heading="Team members">
|
|
1452
|
+
<page-header heading="Team members" description="Everyone with access to this workspace.">
|
|
1314
1453
|
<nav slot="breadcrumb" aria-label="Breadcrumb">Home / Settings / Members</nav>
|
|
1315
1454
|
<ui-button slot="actions" variant="primary">Invite</ui-button>
|
|
1316
1455
|
</page-header>
|
|
@@ -1327,11 +1466,18 @@ around a "Page N of M" status. It owns no data — the consumer sets
|
|
|
1327
1466
|
Previous is disabled on the first page and next on the last; neither fires an
|
|
1328
1467
|
event when there is nowhere to go.
|
|
1329
1468
|
|
|
1469
|
+
The prev/next buttons are treated as `ui-button`'s `secondary` variant:
|
|
1470
|
+
they read the same shared `--ui-button-secondary-*`/`--ui-button-highlight`
|
|
1471
|
+
tokens (and `--ui-button-secondary-surface-muted` for hover, since — like
|
|
1472
|
+
`button-group`'s unchecked segments — they already paint
|
|
1473
|
+
`--ui-surface-muted` on hover by default), so a gradient theme applies
|
|
1474
|
+
consistently here too.
|
|
1475
|
+
|
|
1330
1476
|
Import: `import "@f-ewald/components/pagination-nav.js";`
|
|
1331
1477
|
|
|
1332
1478
|
Properties: `currentPage` (attribute `current-page`) : number, default 1; `totalPages` (attribute `total-pages`) : number, default 1
|
|
1333
1479
|
Events: `page-change`
|
|
1334
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1480
|
+
CSS custom properties: `--ui-border`, `--ui-button-highlight`, `--ui-button-secondary-`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-button-secondary-surface-muted`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1335
1481
|
|
|
1336
1482
|
Example:
|
|
1337
1483
|
```html
|
|
@@ -1472,11 +1618,17 @@ description matters. For many short, same-shaped options (a color swatch,
|
|
|
1472
1618
|
a basemap style), use `radio-pills` instead. Wraps native radio inputs for
|
|
1473
1619
|
keyboard/a11y and fires `change` rather than relying on form submission.
|
|
1474
1620
|
|
|
1621
|
+
The selected card's border/radio dot read `--ui-button-accent` (a solid
|
|
1622
|
+
stand-in, since `border-color`/`accent-color` can't render a gradient),
|
|
1623
|
+
and its background reads the shared `--ui-button-secondary-surface-muted`
|
|
1624
|
+
plus `--ui-button-highlight`, so a gradient theme tints it consistently
|
|
1625
|
+
with `button-group`/`pagination-nav`'s equivalents.
|
|
1626
|
+
|
|
1475
1627
|
Import: `import "@f-ewald/components/radio-cards.js";`
|
|
1476
1628
|
|
|
1477
1629
|
Properties: `options` (JS property only) : RadioCardOption[], default []; `value` (attribute `value`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false
|
|
1478
1630
|
Events: `change`
|
|
1479
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1631
|
+
CSS custom properties: `--ui-border`, `--ui-button-accent`, `--ui-button-highlight`, `--ui-button-secondary-surface-muted`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1480
1632
|
|
|
1481
1633
|
Example:
|
|
1482
1634
|
```html
|
|
@@ -1500,11 +1652,17 @@ choices where a description matters, use `radio-cards` instead. Wraps
|
|
|
1500
1652
|
native radio inputs for keyboard/a11y and fires `change` rather than
|
|
1501
1653
|
relying on form submission.
|
|
1502
1654
|
|
|
1655
|
+
The selected pill's border/radio dot read `--ui-button-accent` (a solid
|
|
1656
|
+
stand-in, since `border-color`/`accent-color` can't render a gradient),
|
|
1657
|
+
and its background reads the shared `--ui-button-secondary-surface-muted`
|
|
1658
|
+
plus `--ui-button-highlight`, so a gradient theme tints it consistently
|
|
1659
|
+
with `button-group`/`pagination-nav`'s equivalents.
|
|
1660
|
+
|
|
1503
1661
|
Import: `import "@f-ewald/components/radio-pills.js";`
|
|
1504
1662
|
|
|
1505
1663
|
Properties: `options` (JS property only) : RadioPillOption[], default []; `value` (attribute `value`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false
|
|
1506
1664
|
Events: `change`
|
|
1507
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-line-height-tight`, `--ui-primary`, `--ui-surface-muted`, `--ui-text`
|
|
1665
|
+
CSS custom properties: `--ui-border`, `--ui-button-accent`, `--ui-button-highlight`, `--ui-button-secondary-surface-muted`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-line-height-tight`, `--ui-primary`, `--ui-surface-muted`, `--ui-text`
|
|
1508
1666
|
|
|
1509
1667
|
Example:
|
|
1510
1668
|
```html
|
|
@@ -1535,7 +1693,7 @@ Import: `import "@f-ewald/components/range-slider.js";`
|
|
|
1535
1693
|
|
|
1536
1694
|
Properties: `min` (attribute `min`) : number, default 0; `max` (attribute `max`) : number, default 100; `step` (attribute `step`) : number, default 1; `value` (attribute `value`) : number, default 0; `disabled` (attribute `disabled`) : boolean, default false; `name` (attribute `name`) : string, default ""
|
|
1537
1695
|
Events: `input`, `change`
|
|
1538
|
-
CSS custom properties: `--ui-focus-ring`, `--ui-primary`, `--ui-surface`, `--ui-surface-muted`, `--ui-text-muted`
|
|
1696
|
+
CSS custom properties: `--ui-button-accent`, `--ui-button-background`, `--ui-button-highlight`, `--ui-focus-ring`, `--ui-primary`, `--ui-surface`, `--ui-surface-muted`, `--ui-text-muted`
|
|
1539
1697
|
|
|
1540
1698
|
Example:
|
|
1541
1699
|
```html
|
|
@@ -1568,13 +1726,15 @@ Example:
|
|
|
1568
1726
|
|
|
1569
1727
|
## <reveal-button>
|
|
1570
1728
|
|
|
1571
|
-
Button that reveals hidden slotted content when clicked.
|
|
1729
|
+
Button that reveals hidden slotted content when clicked. Set `size="sm"`
|
|
1730
|
+
for a compact button one step below the default, matching `ui-button`'s
|
|
1731
|
+
`sm` size.
|
|
1572
1732
|
|
|
1573
1733
|
Import: `import "@f-ewald/components/reveal-button.js";`
|
|
1574
1734
|
|
|
1575
|
-
Properties: `label` (attribute `label`) : string, default "Reveal hidden content"; `disabled` (attribute `disabled`) : boolean, default false
|
|
1735
|
+
Properties: `label` (attribute `label`) : string, default "Reveal hidden content"; `disabled` (attribute `disabled`) : boolean, default false; `size` (attribute `size`) : "sm" | "md", default "md"
|
|
1576
1736
|
Events: none
|
|
1577
|
-
CSS custom properties: `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`
|
|
1737
|
+
CSS custom properties: `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-highlight`, `--ui-button-text-shadow`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`
|
|
1578
1738
|
|
|
1579
1739
|
Example:
|
|
1580
1740
|
```html
|
|
@@ -2039,11 +2199,27 @@ cross into from an ancestor light-DOM `<form>`. `type="submit"`/`"reset"`
|
|
|
2039
2199
|
is instead wired through `ElementInternals.form` — the same mechanism
|
|
2040
2200
|
`address-autocomplete` uses to associate with an ancestor form.
|
|
2041
2201
|
|
|
2202
|
+
`primary`/`danger` backgrounds read `--ui-button-background`/
|
|
2203
|
+
`--ui-button-danger-background` (and their `-hover`/`-active`
|
|
2204
|
+
counterparts), which default to the flat `--ui-primary`/`--ui-danger`
|
|
2205
|
+
tokens unchanged — so `--ui-primary`/`--ui-danger` stay the single source
|
|
2206
|
+
of truth for every other component. A consumer can override just these
|
|
2207
|
+
button-specific tokens with a `linear-gradient(...)` to opt every
|
|
2208
|
+
`ui-button` into a gradient look without touching component markup,
|
|
2209
|
+
pairing it with `--ui-button-border`/`--ui-button-danger-border` (default
|
|
2210
|
+
`transparent`) for a defining edge a shade darker than the gradient's dark
|
|
2211
|
+
stop, and setting the `-active` variant's stops in reverse for a
|
|
2212
|
+
pressed/"indented" look while the button is held down. `secondary`'s
|
|
2213
|
+
background/border read the equivalent `--ui-button-secondary-*` tokens
|
|
2214
|
+
(shared with `confirm-dialog`'s Cancel button), defaulting to today's
|
|
2215
|
+
transparent/bordered look, so it can be themed into a matching (e.g.
|
|
2216
|
+
white-to-gray) gradient too.
|
|
2217
|
+
|
|
2042
2218
|
Import: `import "@f-ewald/components/ui-button.js";`
|
|
2043
2219
|
|
|
2044
2220
|
Properties: `variant` (attribute `variant`) : ButtonVariant, default "primary"; `size` (attribute `size`) : "sm" | "md", default "md"; `href` (attribute `href`) : string | null, default null; `type` (attribute `type`) : "button" | "submit" | "reset", default "button"; `disabled` (attribute `disabled`) : boolean, default false; `busy` (attribute `busy`) : boolean, default false
|
|
2045
2221
|
Events: none
|
|
2046
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`, `--ui-text`, `--ui-text-muted`
|
|
2222
|
+
CSS custom properties: `--ui-border`, `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-danger-background`, `--ui-button-danger-background-active`, `--ui-button-danger-background-hover`, `--ui-button-danger-border`, `--ui-button-highlight`, `--ui-button-secondary-`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-button-text-shadow`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`, `--ui-text`, `--ui-text-muted`
|
|
2047
2223
|
|
|
2048
2224
|
Example:
|
|
2049
2225
|
```html
|
|
@@ -2104,6 +2280,31 @@ Example:
|
|
|
2104
2280
|
<user-avatar src="https://example.com/photo.jpg" name="Freddy" size="40"></user-avatar>
|
|
2105
2281
|
```
|
|
2106
2282
|
|
|
2283
|
+
## <video-player>
|
|
2284
|
+
|
|
2285
|
+
Video player wrapping a native `<video>` element (native `controls`
|
|
2286
|
+
disabled) with the same tokenized transport bar as `audio-player` — a
|
|
2287
|
+
play/pause `icon-button`, elapsed/total time, a seekable progress bar, a
|
|
2288
|
+
mute toggle + volume slider — plus a fullscreen toggle. The control bar
|
|
2289
|
+
sits in a persistent strip under the video frame rather than a
|
|
2290
|
+
hover-reveal overlay, so it stays usable for keyboard/touch input without
|
|
2291
|
+
a pointer hover state.
|
|
2292
|
+
|
|
2293
|
+
Import: `import "@f-ewald/components/video-player.js";`
|
|
2294
|
+
|
|
2295
|
+
Properties: `src` (attribute `src`) : string, default ""; `poster` (attribute `poster`) : string, default ""; `label` (attribute `label`) : string, default "Video player"; `loop` (attribute `loop`) : boolean, default false; `preload` (attribute `preload`) : "none" | "metadata" | "auto", default "metadata"
|
|
2296
|
+
Events: `play`, `pause`, `ended`
|
|
2297
|
+
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`
|
|
2298
|
+
|
|
2299
|
+
Example:
|
|
2300
|
+
```html
|
|
2301
|
+
<video-player
|
|
2302
|
+
src="/clip.mp4"
|
|
2303
|
+
poster="/clip-poster.jpg"
|
|
2304
|
+
label="Episode 12"
|
|
2305
|
+
></video-player>
|
|
2306
|
+
```
|
|
2307
|
+
|
|
2107
2308
|
## <weight-bar-chart>
|
|
2108
2309
|
|
|
2109
2310
|
Sorted horizontal bar chart of labeled weights (normalized fractions
|