@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.
Files changed (97) hide show
  1. package/README.md +7 -1
  2. package/custom-elements.json +1966 -643
  3. package/dist/address-autocomplete.d.ts.map +1 -1
  4. package/dist/address-autocomplete.js +7 -3
  5. package/dist/address-autocomplete.js.map +1 -1
  6. package/dist/audio-player.d.ts +53 -0
  7. package/dist/audio-player.d.ts.map +1 -0
  8. package/dist/audio-player.js +267 -0
  9. package/dist/audio-player.js.map +1 -0
  10. package/dist/autocomplete-input.d.ts.map +1 -1
  11. package/dist/autocomplete-input.js +7 -3
  12. package/dist/autocomplete-input.js.map +1 -1
  13. package/dist/button-group.d.ts +12 -1
  14. package/dist/button-group.d.ts.map +1 -1
  15. package/dist/button-group.js +35 -3
  16. package/dist/button-group.js.map +1 -1
  17. package/dist/comment-composer.d.ts +54 -0
  18. package/dist/comment-composer.d.ts.map +1 -0
  19. package/dist/comment-composer.js +244 -0
  20. package/dist/comment-composer.js.map +1 -0
  21. package/dist/confirm-dialog.d.ts +4 -1
  22. package/dist/confirm-dialog.d.ts.map +1 -1
  23. package/dist/confirm-dialog.js +47 -9
  24. package/dist/confirm-dialog.js.map +1 -1
  25. package/dist/dropdown-button.d.ts +4 -1
  26. package/dist/dropdown-button.d.ts.map +1 -1
  27. package/dist/dropdown-button.js +29 -3
  28. package/dist/dropdown-button.js.map +1 -1
  29. package/dist/icons.d.ts +65 -0
  30. package/dist/icons.d.ts.map +1 -1
  31. package/dist/icons.js +65 -0
  32. package/dist/icons.js.map +1 -1
  33. package/dist/index.d.ts +4 -1
  34. package/dist/index.d.ts.map +1 -1
  35. package/dist/index.js +4 -1
  36. package/dist/index.js.map +1 -1
  37. package/dist/mcp-server.js +39 -0
  38. package/dist/mcp-server.js.map +1 -1
  39. package/dist/page-header.d.ts +8 -3
  40. package/dist/page-header.d.ts.map +1 -1
  41. package/dist/page-header.js +33 -12
  42. package/dist/page-header.js.map +1 -1
  43. package/dist/pagination-nav.d.ts +7 -0
  44. package/dist/pagination-nav.d.ts.map +1 -1
  45. package/dist/pagination-nav.js +19 -4
  46. package/dist/pagination-nav.js.map +1 -1
  47. package/dist/radio-cards.d.ts +6 -0
  48. package/dist/radio-cards.d.ts.map +1 -1
  49. package/dist/radio-cards.js +13 -3
  50. package/dist/radio-cards.js.map +1 -1
  51. package/dist/radio-pills.d.ts +6 -0
  52. package/dist/radio-pills.d.ts.map +1 -1
  53. package/dist/radio-pills.js +13 -3
  54. package/dist/radio-pills.js.map +1 -1
  55. package/dist/range-slider.d.ts.map +1 -1
  56. package/dist/range-slider.js +11 -7
  57. package/dist/range-slider.js.map +1 -1
  58. package/dist/reveal-button.d.ts +5 -1
  59. package/dist/reveal-button.d.ts.map +1 -1
  60. package/dist/reveal-button.js +26 -4
  61. package/dist/reveal-button.js.map +1 -1
  62. package/dist/tokens.css +17 -0
  63. package/dist/tokens.d.ts.map +1 -1
  64. package/dist/tokens.js +56 -0
  65. package/dist/tokens.js.map +1 -1
  66. package/dist/ui-button.d.ts +16 -0
  67. package/dist/ui-button.d.ts.map +1 -1
  68. package/dist/ui-button.js +48 -7
  69. package/dist/ui-button.js.map +1 -1
  70. package/dist/utils/duration.d.ts +8 -0
  71. package/dist/utils/duration.d.ts.map +1 -1
  72. package/dist/utils/duration.js +18 -0
  73. package/dist/utils/duration.js.map +1 -1
  74. package/dist/utils/transport-controls.d.ts +11 -0
  75. package/dist/utils/transport-controls.d.ts.map +1 -0
  76. package/dist/utils/transport-controls.js +113 -0
  77. package/dist/utils/transport-controls.js.map +1 -0
  78. package/dist/video-player.d.ts +60 -0
  79. package/dist/video-player.d.ts.map +1 -0
  80. package/dist/video-player.js +324 -0
  81. package/dist/video-player.js.map +1 -0
  82. package/docs/audio-player.md +60 -0
  83. package/docs/button-group.md +18 -1
  84. package/docs/comment-composer.md +68 -0
  85. package/docs/confirm-dialog.md +19 -1
  86. package/docs/dropdown-button.md +10 -1
  87. package/docs/icons.md +75 -0
  88. package/docs/page-header.md +11 -4
  89. package/docs/pagination-nav.md +14 -0
  90. package/docs/radio-cards.md +9 -0
  91. package/docs/radio-pills.md +9 -0
  92. package/docs/range-slider.md +3 -0
  93. package/docs/reveal-button.md +11 -1
  94. package/docs/ui-button.md +32 -0
  95. package/docs/video-player.md +59 -0
  96. package/llms.txt +224 -23
  97. 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, and a right-aligned cluster of page-level actions.
1302
- It only lays these out — the breadcrumb links and action buttons are entirely
1303
- the consumer's, so it stays framework- and router-agnostic.
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
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@f-ewald/components",
3
3
  "private": false,
4
- "version": "1.23.0",
4
+ "version": "1.24.0",
5
5
  "description": "A collection of universally usable web components for various tasks.",
6
6
  "type": "module",
7
7
  "main": "dist/index.js",