@f-ewald/components 1.39.0 → 1.40.1

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 (192) hide show
  1. package/README.md +48 -0
  2. package/custom-elements.json +1179 -100
  3. package/dist/address-autocomplete.js +2 -2
  4. package/dist/address-autocomplete.js.map +1 -1
  5. package/dist/app-shell.js +4 -4
  6. package/dist/app-shell.js.map +1 -1
  7. package/dist/app-sidebar.js +2 -2
  8. package/dist/app-sidebar.js.map +1 -1
  9. package/dist/audio-player.js +1 -1
  10. package/dist/audio-player.js.map +1 -1
  11. package/dist/autocomplete-input.js +2 -2
  12. package/dist/autocomplete-input.js.map +1 -1
  13. package/dist/breadcrumb-nav.d.ts +87 -0
  14. package/dist/breadcrumb-nav.d.ts.map +1 -0
  15. package/dist/breadcrumb-nav.js +281 -0
  16. package/dist/breadcrumb-nav.js.map +1 -0
  17. package/dist/button-group.js +2 -2
  18. package/dist/button-group.js.map +1 -1
  19. package/dist/calendar-day.js +3 -3
  20. package/dist/calendar-day.js.map +1 -1
  21. package/dist/calendar-month.d.ts.map +1 -1
  22. package/dist/calendar-month.js +4 -1
  23. package/dist/calendar-month.js.map +1 -1
  24. package/dist/calendar-week.js +4 -4
  25. package/dist/calendar-week.js.map +1 -1
  26. package/dist/chat-message.js +1 -1
  27. package/dist/chat-message.js.map +1 -1
  28. package/dist/comment-composer.js +1 -1
  29. package/dist/comment-composer.js.map +1 -1
  30. package/dist/confirm-dialog.d.ts.map +1 -1
  31. package/dist/confirm-dialog.js +5 -2
  32. package/dist/confirm-dialog.js.map +1 -1
  33. package/dist/content-divider.js +1 -1
  34. package/dist/content-divider.js.map +1 -1
  35. package/dist/cron-schedule.d.ts.map +1 -1
  36. package/dist/cron-schedule.js +6 -5
  37. package/dist/cron-schedule.js.map +1 -1
  38. package/dist/data-table.d.ts.map +1 -1
  39. package/dist/data-table.js +3 -2
  40. package/dist/data-table.js.map +1 -1
  41. package/dist/dropdown-button.d.ts.map +1 -1
  42. package/dist/dropdown-button.js +4 -2
  43. package/dist/dropdown-button.js.map +1 -1
  44. package/dist/editable-text.js +1 -1
  45. package/dist/editable-text.js.map +1 -1
  46. package/dist/empty-state.d.ts +58 -0
  47. package/dist/empty-state.d.ts.map +1 -0
  48. package/dist/empty-state.js +203 -0
  49. package/dist/empty-state.js.map +1 -0
  50. package/dist/form-field.js +1 -1
  51. package/dist/form-field.js.map +1 -1
  52. package/dist/form-select.js +3 -3
  53. package/dist/form-select.js.map +1 -1
  54. package/dist/frame-box.js +1 -1
  55. package/dist/frame-box.js.map +1 -1
  56. package/dist/fullscreen-button.js +1 -1
  57. package/dist/fullscreen-button.js.map +1 -1
  58. package/dist/icons.d.ts +2 -0
  59. package/dist/icons.d.ts.map +1 -1
  60. package/dist/icons.js +2 -0
  61. package/dist/icons.js.map +1 -1
  62. package/dist/index.d.ts +6 -1
  63. package/dist/index.d.ts.map +1 -1
  64. package/dist/index.js +6 -1
  65. package/dist/index.js.map +1 -1
  66. package/dist/kanban-card.js +1 -1
  67. package/dist/kanban-card.js.map +1 -1
  68. package/dist/kanban-column.js +3 -3
  69. package/dist/kanban-column.js.map +1 -1
  70. package/dist/kbd-hint.d.ts.map +1 -1
  71. package/dist/kbd-hint.js +2 -1
  72. package/dist/kbd-hint.js.map +1 -1
  73. package/dist/link-card.js +1 -1
  74. package/dist/link-card.js.map +1 -1
  75. package/dist/markdown-view.js +3 -3
  76. package/dist/markdown-view.js.map +1 -1
  77. package/dist/modal-dialog.js +1 -1
  78. package/dist/modal-dialog.js.map +1 -1
  79. package/dist/multi-select.js +5 -5
  80. package/dist/multi-select.js.map +1 -1
  81. package/dist/pagination-nav.d.ts.map +1 -1
  82. package/dist/pagination-nav.js +5 -1
  83. package/dist/pagination-nav.js.map +1 -1
  84. package/dist/photo-gallery.js +1 -1
  85. package/dist/photo-gallery.js.map +1 -1
  86. package/dist/popover-panel.d.ts.map +1 -1
  87. package/dist/popover-panel.js +4 -2
  88. package/dist/popover-panel.js.map +1 -1
  89. package/dist/progress-bar.d.ts.map +1 -1
  90. package/dist/progress-bar.js +1 -0
  91. package/dist/progress-bar.js.map +1 -1
  92. package/dist/radio-cards.js +1 -1
  93. package/dist/radio-cards.js.map +1 -1
  94. package/dist/radio-pills.js +1 -1
  95. package/dist/radio-pills.js.map +1 -1
  96. package/dist/reveal-button.js +1 -1
  97. package/dist/reveal-button.js.map +1 -1
  98. package/dist/scroll-to-bottom.js +1 -1
  99. package/dist/scroll-to-bottom.js.map +1 -1
  100. package/dist/scroll-to-top.js +1 -1
  101. package/dist/scroll-to-top.js.map +1 -1
  102. package/dist/skip-link.d.ts +38 -0
  103. package/dist/skip-link.d.ts.map +1 -0
  104. package/dist/skip-link.js +184 -0
  105. package/dist/skip-link.js.map +1 -0
  106. package/dist/slide-panel.js +1 -1
  107. package/dist/slide-panel.js.map +1 -1
  108. package/dist/spec-list.d.ts +58 -0
  109. package/dist/spec-list.d.ts.map +1 -0
  110. package/dist/spec-list.js +226 -0
  111. package/dist/spec-list.js.map +1 -0
  112. package/dist/stat-meter.d.ts.map +1 -1
  113. package/dist/stat-meter.js +1 -0
  114. package/dist/stat-meter.js.map +1 -1
  115. package/dist/tab-bar.js +1 -1
  116. package/dist/tab-bar.js.map +1 -1
  117. package/dist/text-area.js +1 -1
  118. package/dist/text-area.js.map +1 -1
  119. package/dist/tile-grid.js +1 -1
  120. package/dist/tile-grid.js.map +1 -1
  121. package/dist/tokens.css +42 -1
  122. package/dist/tokens.d.ts +50 -0
  123. package/dist/tokens.d.ts.map +1 -1
  124. package/dist/tokens.js +136 -0
  125. package/dist/tokens.js.map +1 -1
  126. package/dist/tree-view.js +2 -2
  127. package/dist/tree-view.js.map +1 -1
  128. package/dist/ui-admonition.js +1 -1
  129. package/dist/ui-admonition.js.map +1 -1
  130. package/dist/ui-button.js +1 -1
  131. package/dist/ui-button.js.map +1 -1
  132. package/dist/video-player.js +1 -1
  133. package/dist/video-player.js.map +1 -1
  134. package/dist/vote-control.d.ts +40 -0
  135. package/dist/vote-control.d.ts.map +1 -0
  136. package/dist/vote-control.js +318 -0
  137. package/dist/vote-control.js.map +1 -0
  138. package/docs/address-autocomplete.md +1 -0
  139. package/docs/app-shell.md +1 -0
  140. package/docs/app-sidebar.md +1 -0
  141. package/docs/audio-player.md +1 -0
  142. package/docs/autocomplete-input.md +1 -0
  143. package/docs/breadcrumb-nav.md +70 -0
  144. package/docs/button-group.md +1 -0
  145. package/docs/calendar-day.md +1 -0
  146. package/docs/calendar-month.md +1 -0
  147. package/docs/calendar-week.md +1 -0
  148. package/docs/chat-message.md +1 -0
  149. package/docs/comment-composer.md +1 -0
  150. package/docs/confirm-dialog.md +1 -0
  151. package/docs/content-divider.md +1 -0
  152. package/docs/cron-schedule.md +2 -0
  153. package/docs/data-table.md +2 -0
  154. package/docs/design-language.md +57 -5
  155. package/docs/dropdown-button.md +1 -0
  156. package/docs/editable-text.md +1 -0
  157. package/docs/empty-state.md +60 -0
  158. package/docs/form-field.md +1 -0
  159. package/docs/form-select.md +1 -0
  160. package/docs/frame-box.md +1 -0
  161. package/docs/fullscreen-button.md +1 -0
  162. package/docs/icons.md +1 -0
  163. package/docs/kanban-card.md +1 -0
  164. package/docs/kanban-column.md +1 -0
  165. package/docs/kbd-hint.md +1 -0
  166. package/docs/link-card.md +1 -0
  167. package/docs/markdown-view.md +1 -0
  168. package/docs/modal-dialog.md +1 -0
  169. package/docs/multi-select.md +1 -0
  170. package/docs/pagination-nav.md +2 -0
  171. package/docs/photo-gallery.md +1 -0
  172. package/docs/popover-panel.md +1 -0
  173. package/docs/progress-bar.md +1 -0
  174. package/docs/radio-cards.md +1 -0
  175. package/docs/radio-pills.md +1 -0
  176. package/docs/reveal-button.md +1 -0
  177. package/docs/scroll-to-bottom.md +1 -0
  178. package/docs/scroll-to-top.md +1 -0
  179. package/docs/skip-link.md +61 -0
  180. package/docs/slide-panel.md +1 -0
  181. package/docs/spec-list.md +79 -0
  182. package/docs/stat-meter.md +1 -0
  183. package/docs/tab-bar.md +1 -0
  184. package/docs/text-area.md +1 -0
  185. package/docs/tile-grid.md +1 -0
  186. package/docs/tree-view.md +1 -0
  187. package/docs/ui-admonition.md +1 -0
  188. package/docs/ui-button.md +1 -0
  189. package/docs/video-player.md +1 -0
  190. package/docs/vote-control.md +73 -0
  191. package/llms.txt +212 -49
  192. package/package.json +1 -1
package/llms.txt CHANGED
@@ -15,11 +15,14 @@ Theming: components use `var(--ui-*, <fallback>)` custom properties, so they
15
15
  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. That
18
- stylesheet also ships four named themes, selected with a `data-theme`
18
+ stylesheet also ships five named themes, selected with a `data-theme`
19
19
  attribute on `<html>` (mutually exclusive): `"dark"`/`"light"` force one of
20
20
  the two flat palettes over the OS preference, `"gradient"` glosses buttons and
21
- toasts, and `"metro"` squares every tokenized corner and replaces drop shadows
22
- with hairline rings over a blue accent.
21
+ toasts, `"metro"` squares every tokenized corner and replaces drop shadows
22
+ with hairline rings over a blue accent, and `"blueprint"` restyles the palette
23
+ as a monospace spec sheet — ink on paper, one pure-blue accent, square corners,
24
+ uppercase micro-labels, tabular figures, and 1.5px hairline rules in place of
25
+ shadows.
23
26
 
24
27
  ## Icons
25
28
 
@@ -54,6 +57,7 @@ table to pick the icon matching a use case, for consistency across apps:
54
57
  | `iconCpuChip` | 18px | System, hardware, or technical/processing content. |
55
58
  | `iconCurrencyDollar` | 16px | Monetary values, pricing, or billing-related content. |
56
59
  | `iconDocument` | 18px | A generic file/document icon, e.g. tile-grid's default file icon. |
60
+ | `iconEllipsisHorizontal` | 16px | Collapsed items in an inline sequence, e.g. breadcrumb-nav's truncated middle. |
57
61
  | `iconEllipsisVertical` | 16px | An overflow ("kebab") menu trigger, e.g. dropdown-button's icon variant. |
58
62
  | `iconExclamationCircle` | 16px | Error states, e.g. the error variant of toast-notification. |
59
63
  | `iconExclamationTriangle` | 16px | Warning states, e.g. the warning variant of toast-notification. |
@@ -141,7 +145,7 @@ Import: `import "@f-ewald/components/address-autocomplete.js";`
141
145
 
142
146
  Properties: `value` (attribute `value`) : string, default ""; `placeholder` (attribute `placeholder`) : string, default ""; `required` (attribute `required`) : boolean, default false; `disabled` (attribute `disabled`) : boolean, default false; `clearable` (attribute `clearable`) : boolean, default false; `types` (attribute `types`) : string, default "address"; `endpoint` (attribute `endpoint`) : string, default "https://api.mapbox.com/search/geocode/v6/forward"; `accessToken` (attribute `access-token`) : string, default ""; `bbox` (attribute `bbox`) : string, default ""; `proximity` (attribute `proximity`) : string, default ""; `debounce` (attribute `debounce`) : number, default 300; `minLength` (attribute `min-length`) : number, default 3; `suggestions` (JS property only) : AddressSuggestion[] | null, default null; `selectedSuggestion` (JS property only) : AddressSuggestion | null, default —
143
147
  Events: `address-select`, `input`
144
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-regular`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
148
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-regular`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
145
149
 
146
150
  Example:
147
151
  ```html
@@ -222,7 +226,7 @@ Import: `import "@f-ewald/components/app-shell.js";`
222
226
 
223
227
  Properties: `sidebarOpen` (attribute `sidebar-open`) : boolean, default false; `sidebarMode` (attribute `sidebar-mode`) : "overlay" | "push", default "overlay"; `sidebarWidth` (attribute `sidebar-width`) : "full" | "icon", default "full"; `detailOpen` (attribute `detail-open`) : boolean, default false; `detailWidth` (attribute `detail-width`) : "compact" | "comfortable", default "compact"; `noTopbar` (attribute `no-topbar`) : boolean, default false
224
228
  Events: `sidebar-toggle`, `detail-close`
225
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font-size-sm`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-radius-sm`, `--ui-shadow`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text-muted`, `--ui-tooltip`
229
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font-size-sm`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-radius-sm`, `--ui-shadow`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text-muted`, `--ui-tooltip`
226
230
 
227
231
  Example:
228
232
  ```html
@@ -265,7 +269,7 @@ Import: `import "@f-ewald/components/app-sidebar.js";`
265
269
 
266
270
  Properties: `collapsed` (attribute `collapsed`) : boolean, default false
267
271
  Events: none
268
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
272
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
269
273
 
270
274
  Example:
271
275
  ```html
@@ -294,7 +298,7 @@ Import: `import "@f-ewald/components/audio-player.js";`
294
298
 
295
299
  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"
296
300
  Events: `play`, `pause`, `ended`
297
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`
301
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`
298
302
 
299
303
  Example:
300
304
  ```html
@@ -364,7 +368,7 @@ Import: `import "@f-ewald/components/autocomplete-input.js";`
364
368
 
365
369
  Properties: `value` (attribute `value`) : string, default ""; `placeholder` (attribute `placeholder`) : string, default ""; `required` (attribute `required`) : boolean, default false; `disabled` (attribute `disabled`) : boolean, default false; `clearable` (attribute `clearable`) : boolean, default false; `endpoint` (attribute `endpoint`) : string, default ""; `queryParam` (attribute `query-param`) : string, default "q"; `debounce` (attribute `debounce`) : number, default 300; `minLength` (attribute `min-length`) : number, default 3; `options` (JS property only) : AutocompleteOption[] | null, default null; `selectedOption` (JS property only) : AutocompleteOption | null, default —
366
370
  Events: `option-select`, `input`
367
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-regular`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
371
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-regular`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
368
372
 
369
373
  Example:
370
374
  ```html
@@ -383,6 +387,43 @@ Example:
383
387
  </script>
384
388
  ```
385
389
 
390
+ ## <breadcrumb-nav>
391
+
392
+ A breadcrumb trail: a `<nav aria-label="Breadcrumb">` wrapping an ordered
393
+ list, with chevron separators and the current page rendered as plain,
394
+ non-interactive text. Designed to drop into `page-header`'s `breadcrumb`
395
+ slot, but usable on its own anywhere a trail is needed.
396
+
397
+ The last `items` entry is always treated as the current page: it renders as
398
+ text with `aria-current="page"` even if it carries an `href`. Middle entries
399
+ without an `href` render as plain text too; only middle entries with an
400
+ `href` are real anchors.
401
+
402
+ When `max-visible` is greater than zero and the trail is longer than that,
403
+ the middle collapses behind an overflow button that always keeps the first
404
+ and current crumbs visible; activating it toggles `expanded` to reveal the
405
+ hidden crumbs in place.
406
+
407
+ Import: `import "@f-ewald/components/breadcrumb-nav.js";`
408
+
409
+ Properties: `items` (attribute `items`) : BreadcrumbItem[], default []; `maxVisible` (attribute `max-visible`) : number, default 0; `expanded` (attribute `expanded`) : boolean, default false
410
+ Events: `breadcrumb-navigate`
411
+ CSS custom properties: `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-line-height-glyph`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-text`, `--ui-text-muted`
412
+
413
+ Example:
414
+ ```html
415
+ <breadcrumb-nav></breadcrumb-nav>
416
+ <script type="module">
417
+ const trail = document.querySelector("breadcrumb-nav");
418
+ trail.items = [
419
+ { label: "Home", href: "/" },
420
+ { label: "Settings", href: "/settings" },
421
+ { label: "Members" },
422
+ ];
423
+ trail.addEventListener("breadcrumb-navigate", (e) => console.log(e.detail.item.label, e.detail.index));
424
+ </script>
425
+ ```
426
+
386
427
  ## <button-group>
387
428
 
388
429
  Single-select segmented control — a strip of buttons joined into one
@@ -406,7 +447,7 @@ Import: `import "@f-ewald/components/button-group.js";`
406
447
 
407
448
  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"
408
449
  Events: `change`
409
- 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`
450
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--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`
410
451
 
411
452
  Example:
412
453
  ```html
@@ -440,7 +481,7 @@ Import: `import "@f-ewald/components/calendar-day.js";`
440
481
 
441
482
  Properties: `date` (attribute `date`) : string, default —; `timeMarker` (attribute `time-marker`) : boolean, default false; `minWidth` (attribute `min-width`) : string, default ""
442
483
  Events: none
443
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
484
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
444
485
 
445
486
  Example:
446
487
  ```html
@@ -504,7 +545,7 @@ Import: `import "@f-ewald/components/calendar-month.js";`
504
545
 
505
546
  Properties: `year` (attribute `year`) : number, default —; `month` (attribute `month`) : number, default 1
506
547
  Events: none
507
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-bold`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
548
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-bold`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
508
549
 
509
550
  Example:
510
551
  ```html
@@ -545,7 +586,7 @@ Import: `import "@f-ewald/components/calendar-week.js";`
545
586
 
546
587
  Properties: `date` (attribute `date`) : string, default —
547
588
  Events: none
548
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-primary`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
589
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-primary`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
549
590
 
550
591
  Example:
551
592
  ```html
@@ -626,7 +667,7 @@ Import: `import "@f-ewald/components/chat-message.js";`
626
667
 
627
668
  Properties: `role` (attribute `role`) : ChatMessageRole, default "agent"; `variant` (attribute `variant`) : ChatMessageVariant, default "normal"; `author` (attribute `author`) : string, default ""; `timestamp` (attribute `timestamp`) : string | null, default null; `summary` (attribute `summary`) : string, default ""; `collapsible` (attribute `collapsible`) : boolean, default false; `collapsed` (attribute `collapsed`) : boolean, default false
628
669
  Events: `toggle`
629
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-mono`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-primary`, `--ui-radius`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
670
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-mono`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-primary`, `--ui-radius`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
630
671
 
631
672
  Example:
632
673
  ```html
@@ -689,7 +730,7 @@ Import: `import "@f-ewald/components/comment-composer.js";`
689
730
 
690
731
  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
691
732
  Events: `cancel`, `submit`
692
- 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`
733
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-line-height-normal`, `--ui-radius`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`
693
734
 
694
735
  Example:
695
736
  ```html
@@ -714,7 +755,7 @@ Import: `import "@f-ewald/components/confirm-dialog.js";`
714
755
 
715
756
  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"
716
757
  Events: `confirm`, `cancel`
717
- 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`
758
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--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`
718
759
 
719
760
  Example:
720
761
  ```html
@@ -741,7 +782,7 @@ Import: `import "@f-ewald/components/content-divider.js";`
741
782
 
742
783
  Properties: `label` (attribute `label`) : string, default ""
743
784
  Events: none
744
- CSS custom properties: `--ui-border`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-text-muted`
785
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-text-muted`
745
786
 
746
787
  Example:
747
788
  ```html
@@ -814,7 +855,7 @@ Import: `import "@f-ewald/components/cron-schedule.js";`
814
855
 
815
856
  Properties: `value` (attribute `value`) : string, default "0 * * * *"; `label` (attribute `label`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false; `open` (attribute `open`) : boolean, default false; `description` (JS property only) : string, default —
816
857
  Events: `change`
817
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-mono`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
858
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-mono`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-label-transform`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
818
859
 
819
860
  Example:
820
861
  ```html
@@ -843,7 +884,7 @@ Import: `import "@f-ewald/components/data-table.js";`
843
884
 
844
885
  Properties: `columns` (JS property only) : DataTableColumn[], default []; `rows` (JS property only) : unknown[], default []; `rowKey` (JS property only) : (row: unknown, index: number) => string | number, default —; `renderCell` (JS property only) : (row: unknown, key: string) => unknown, default —; `rowHref` (JS property only) : ((row: unknown) => string | null) | null, default null; `rowLabel` (JS property only) : ((row: unknown) => string) | null, default null
845
886
  Events: none
846
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
887
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-label-transform`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
847
888
 
848
889
  Example:
849
890
  ```html
@@ -928,7 +969,7 @@ Import: `import "@f-ewald/components/dropdown-button.js";`
928
969
 
929
970
  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"; `circular` (attribute `circular`) : boolean, default false
930
971
  Events: `select`
931
- 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-circle`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
972
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--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-circle`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
932
973
 
933
974
  Example:
934
975
  ```html
@@ -963,7 +1004,7 @@ Import: `import "@f-ewald/components/editable-text.js";`
963
1004
 
964
1005
  Properties: `value` (attribute `value`) : string, default ""; `multiline` (attribute `multiline`) : boolean, default false; `placeholder` (attribute `placeholder`) : string, default ""; `readonly` (attribute `readonly`) : boolean, default false; `label` (attribute `label`) : string, default ""
965
1006
  Events: `change`
966
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text-muted`
1007
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text-muted`
967
1008
 
968
1009
  Example:
969
1010
  ```html
@@ -971,6 +1012,30 @@ Example:
971
1012
  <editable-text multiline placeholder="Add a description…" label="Description"></editable-text>
972
1013
  ```
973
1014
 
1015
+ ## <empty-state>
1016
+
1017
+ A centered placeholder for an empty list, an empty panel, or a zero-result
1018
+ search: an optional leading glyph, a heading, a supporting line (or richer
1019
+ slotted body), and an optional call-to-action row. Purely presentational —
1020
+ it carries no interactive state of its own and no ARIA `role`; it is a
1021
+ region of content, not a live status. Every optional part collapses
1022
+ completely when absent, reserving no layout space.
1023
+
1024
+ Import: `import "@f-ewald/components/empty-state.js";`
1025
+
1026
+ Properties: `heading` (attribute `heading`) : string, default ""; `description` (attribute `description`) : string, default ""; `size` (attribute `size`) : "sm" | "md", default "md"; `headingLevel` (attribute `heading-level`) : number, default 2
1027
+ Events: none
1028
+ 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`
1029
+
1030
+ Example:
1031
+ ```html
1032
+ <empty-state heading="No results found" description="Try adjusting your search or filters.">
1033
+ <span slot="icon">...</span>
1034
+ <ui-button slot="actions" variant="primary">Clear filters</ui-button>
1035
+ </empty-state>
1036
+ <empty-state size="sm" heading="No pinned items"></empty-state>
1037
+ ```
1038
+
974
1039
  ## <form-actions>
975
1040
 
976
1041
  Form footer button bar with a fixed action order for internal apps: the
@@ -1024,7 +1089,7 @@ Import: `import "@f-ewald/components/form-field.js";`
1024
1089
 
1025
1090
  Properties: `label` (attribute `label`) : string, default ""; `hint` (attribute `hint`) : string, default ""; `error` (attribute `error`) : string, default ""; `required` (attribute `required`) : boolean, default false; `floatingLabel` (attribute `floating-label`) : boolean, default false
1026
1091
  Events: none
1027
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
1092
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
1028
1093
 
1029
1094
  Example:
1030
1095
  ```html
@@ -1068,7 +1133,7 @@ Import: `import "@f-ewald/components/form-select.js";`
1068
1133
 
1069
1134
  Properties: `options` (JS property only) : SelectOption[], default []; `value` (attribute `value`) : string, default ""; `label` (attribute `label`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false; `searchable` (attribute `searchable`) : boolean, default false
1070
1135
  Events: `change`
1071
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1136
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1072
1137
 
1073
1138
  Example:
1074
1139
  ```html
@@ -1100,7 +1165,7 @@ Import: `import "@f-ewald/components/frame-box.js";`
1100
1165
 
1101
1166
  Properties: `label` (attribute `label`) : string, default ""
1102
1167
  Events: none
1103
- CSS custom properties: `--ui-border`, `--ui-font`, `--ui-font-size-xs`, `--ui-font-weight-semibold`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`, `--ui-tracking-wide`
1168
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-font`, `--ui-font-size-xs`, `--ui-font-weight-semibold`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`, `--ui-tracking-wide`
1104
1169
 
1105
1170
  Example:
1106
1171
  ```html
@@ -1128,7 +1193,7 @@ Import: `import "@f-ewald/components/fullscreen-button.js";`
1128
1193
 
1129
1194
  Properties: `target` (JS property only) : HTMLElement | null, default null; `enterLabel` (attribute `enter-label`) : string, default "Enter full screen"; `exitLabel` (attribute `exit-label`) : string, default "Exit full screen"
1130
1195
  Events: `fullscreen-change`
1131
- CSS custom properties: `--ui-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-focus-ring`, `--ui-line-height-glyph`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1196
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--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-focus-ring`, `--ui-line-height-glyph`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1132
1197
 
1133
1198
  Example:
1134
1199
  ```html
@@ -1284,7 +1349,7 @@ Import: `import "@f-ewald/components/kanban-card.js";`
1284
1349
 
1285
1350
  Properties: `ticket` (attribute `ticket`) : string, default ""; `heading` (attribute `heading`) : string, default ""
1286
1351
  Events: none
1287
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-highlight`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-shadow`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
1352
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-highlight`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-shadow`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
1288
1353
 
1289
1354
  Example:
1290
1355
  ```html
@@ -1304,7 +1369,7 @@ Import: `import "@f-ewald/components/kanban-column.js";`
1304
1369
 
1305
1370
  Properties: `heading` (attribute `heading`) : string, default ""; `count` (attribute `count`) : number, default 0; `dragover` (attribute `dragover`) : boolean, default false; `empty` (attribute `empty`) : boolean, default false
1306
1371
  Events: none
1307
- CSS custom properties: `--ui-border`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-glyph`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1372
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-glyph`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1308
1373
 
1309
1374
  Example:
1310
1375
  ```html
@@ -1322,7 +1387,7 @@ Import: `import "@f-ewald/components/kbd-hint.js";`
1322
1387
 
1323
1388
  Properties: `keys` (attribute `keys`) : string, default ""; `platform` (attribute `platform`) : KbdPlatform, default "auto"
1324
1389
  Events: none
1325
- CSS custom properties: `--ui-font-mono`, `--ui-font-size-xs`, `--ui-line-height-glyph`, `--ui-radius-sm`
1390
+ CSS custom properties: `--ui-border-width`, `--ui-font-mono`, `--ui-font-size-xs`, `--ui-line-height-glyph`, `--ui-radius-sm`
1326
1391
 
1327
1392
  Example:
1328
1393
  ```html
@@ -1342,7 +1407,7 @@ Import: `import "@f-ewald/components/link-card.js";`
1342
1407
 
1343
1408
  Properties: `heading` (attribute `heading`) : string, default ""; `description` (attribute `description`) : string, default ""; `href` (attribute `href`) : string, default ""; `logo` (attribute `logo`) : string, default ""; `status` (attribute `status`) : LinkCardStatus, default ""
1344
1409
  Events: none
1345
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-radius`, `--ui-radius-pill`, `--ui-shadow`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1410
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-radius`, `--ui-radius-pill`, `--ui-shadow`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1346
1411
 
1347
1412
  Example:
1348
1413
  ```html
@@ -1567,7 +1632,7 @@ Import: `import "@f-ewald/components/markdown-view.js";`
1567
1632
 
1568
1633
  Properties: `markdown` (attribute `markdown`) : string, default ""
1569
1634
  Events: none
1570
- CSS custom properties: `--ui-border`, `--ui-font`, `--ui-font-mono`, `--ui-font-size`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1635
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-font`, `--ui-font-mono`, `--ui-font-size`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1571
1636
 
1572
1637
  Example:
1573
1638
  ```html
@@ -1607,7 +1672,7 @@ Import: `import "@f-ewald/components/modal-dialog.js";`
1607
1672
 
1608
1673
  Properties: `open` (attribute `open`) : boolean, default false; `heading` (attribute `heading`) : string, default ""; `size` (attribute `size`) : ModalDialogSize, default "default"; `dismissible` (attribute `dismissible`) : boolean, default false
1609
1674
  Events: `panel-close`
1610
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-overlay`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1675
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-overlay`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1611
1676
 
1612
1677
  Example:
1613
1678
  ```html
@@ -1662,7 +1727,7 @@ Import: `import "@f-ewald/components/multi-select.js";`
1662
1727
 
1663
1728
  Properties: `options` (JS property only) : MultiSelectOption[], default []; `values` (JS property only) : string[], default []; `name` (attribute `name`) : string, default ""; `label` (attribute `label`) : string, default ""; `placeholder` (attribute `placeholder`) : string, default "Select options"; `disabled` (attribute `disabled`) : boolean, default false; `required` (attribute `required`) : boolean, default false; `searchable` (attribute `searchable`) : boolean, default false; `max` (attribute `max`) : number, default 0; `variant` (attribute `variant`) : MultiSelectVariant, default "dropdown"; `visibleRows` (attribute `visible-rows`) : number, default 5; `showChips` (attribute `show-chips`) : boolean, default false
1664
1729
  Events: `change`
1665
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1730
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1666
1731
 
1667
1732
  Example:
1668
1733
  ```html
@@ -1734,7 +1799,7 @@ Import: `import "@f-ewald/components/pagination-nav.js";`
1734
1799
 
1735
1800
  Properties: `currentPage` (attribute `current-page`) : number, default 1; `totalPages` (attribute `total-pages`) : number, default 1
1736
1801
  Events: `page-change`
1737
- 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`
1802
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--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-numeric`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1738
1803
 
1739
1804
  Example:
1740
1805
  ```html
@@ -1786,7 +1851,7 @@ Import: `import "@f-ewald/components/photo-gallery.js";`
1786
1851
 
1787
1852
  Properties: `currentIndex` (attribute `current-index`) : number, default 0; `delay` (attribute `delay`) : number, default 0; `showControls` (attribute `show-controls`) : boolean, default true; `showCounter` (attribute `show-counter`) : boolean, default false; `showIndicators` (attribute `show-indicators`) : boolean, default false; `showAutoplayControl` (attribute `show-autoplay-control`) : boolean, default true; `paused` (attribute `paused`) : boolean, default false; `aspectRatio` (attribute `aspect-ratio`) : string, default "16 / 9"; `objectFit` (attribute `object-fit`) : PhotoGalleryObjectFit, default "cover"
1788
1853
  Events: `slide-change`
1789
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1854
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1790
1855
 
1791
1856
  Example:
1792
1857
  ```html
@@ -1826,7 +1891,7 @@ Import: `import "@f-ewald/components/popover-panel.js";`
1826
1891
 
1827
1892
  Properties: `open` (attribute `open`) : boolean, default false; `heading` (attribute `heading`) : string, default ""; `centered` (attribute `centered`) : boolean, default false
1828
1893
  Events: `panel-close`
1829
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-overlay`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1894
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-overlay`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1830
1895
 
1831
1896
  Example:
1832
1897
  ```html
@@ -1880,7 +1945,7 @@ Import: `import "@f-ewald/components/progress-bar.js";`
1880
1945
 
1881
1946
  Properties: `value` (attribute `value`) : number, default 0; `max` (attribute `max`) : number, default 100; `label` (attribute `label`) : string, default ""; `color` (attribute `color`) : string, default ""; `trackColor` (attribute `track-color`) : string, default ""
1882
1947
  Events: none
1883
- CSS custom properties: `--ui-button-accent`, `--ui-font`, `--ui-font-size-sm`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text-muted`
1948
+ CSS custom properties: `--ui-button-accent`, `--ui-font`, `--ui-font-size-sm`, `--ui-numeric`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text-muted`
1884
1949
 
1885
1950
  Example:
1886
1951
  ```html
@@ -1921,7 +1986,7 @@ Import: `import "@f-ewald/components/radio-cards.js";`
1921
1986
 
1922
1987
  Properties: `options` (JS property only) : RadioCardOption[], default []; `value` (attribute `value`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false; `layout` (attribute `layout`) : "vertical" | "horizontal" | "mixed", default "mixed"; `hideInput` (attribute `hide-input`) : boolean, default false
1923
1988
  Events: `change`
1924
- CSS custom properties: `--ui-border`, `--ui-button-accent`, `--ui-button-highlight`, `--ui-button-secondary-background`, `--ui-button-secondary-background-hover`, `--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-regular`, `--ui-font-weight-semibold`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1989
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-button-accent`, `--ui-button-highlight`, `--ui-button-secondary-background`, `--ui-button-secondary-background-hover`, `--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-regular`, `--ui-font-weight-semibold`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1925
1990
 
1926
1991
  Example:
1927
1992
  ```html
@@ -1955,7 +2020,7 @@ Import: `import "@f-ewald/components/radio-pills.js";`
1955
2020
 
1956
2021
  Properties: `options` (JS property only) : RadioPillOption[], default []; `value` (attribute `value`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false
1957
2022
  Events: `change`
1958
- 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-radius-pill`, `--ui-surface-muted`, `--ui-text`
2023
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--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-radius-pill`, `--ui-surface-muted`, `--ui-text`
1959
2024
 
1960
2025
  Example:
1961
2026
  ```html
@@ -2027,7 +2092,7 @@ Import: `import "@f-ewald/components/reveal-button.js";`
2027
2092
 
2028
2093
  Properties: `label` (attribute `label`) : string, default "Reveal hidden content"; `disabled` (attribute `disabled`) : boolean, default false; `size` (attribute `size`) : "sm" | "md", default "md"
2029
2094
  Events: none
2030
- 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`
2095
+ CSS custom properties: `--ui-border-width`, `--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`
2031
2096
 
2032
2097
  Example:
2033
2098
  ```html
@@ -2114,7 +2179,7 @@ Import: `import "@f-ewald/components/scroll-to-bottom.js";`
2114
2179
 
2115
2180
  Properties: `target` (JS property only) : HTMLElement | null, default null; `threshold` (attribute `threshold`) : number, default 200; `label` (attribute `label`) : string, default "Scroll to bottom"
2116
2181
  Events: `scroll-to-bottom-triggered`
2117
- CSS custom properties: `--ui-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-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
2182
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--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-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
2118
2183
 
2119
2184
  Example:
2120
2185
  ```html
@@ -2155,13 +2220,43 @@ Import: `import "@f-ewald/components/scroll-to-top.js";`
2155
2220
 
2156
2221
  Properties: `target` (JS property only) : HTMLElement | null, default null; `threshold` (attribute `threshold`) : number, default 200; `label` (attribute `label`) : string, default "Scroll to top"
2157
2222
  Events: `scroll-to-top-triggered`
2158
- CSS custom properties: `--ui-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-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
2223
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--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-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
2159
2224
 
2160
2225
  Example:
2161
2226
  ```html
2162
2227
  <scroll-to-top></scroll-to-top>
2163
2228
  ```
2164
2229
 
2230
+ ## <skip-link>
2231
+
2232
+ "Skip to main content" bypass link — the package's first pure
2233
+ accessibility-utility component. It renders a real `<a>` that stays
2234
+ visually hidden (but in the focus order) until it receives keyboard focus,
2235
+ then pins itself to the top-left of the viewport as a solid, high-contrast
2236
+ block so a keyboard or screen-reader user can jump straight past repeated
2237
+ page chrome to the main content.
2238
+
2239
+ Activating it moves focus into the target as well as scrolling to it: a
2240
+ plain fragment link only moves focus when the target is already focusable,
2241
+ so this applies `tabindex="-1"` to the target on demand rather than making
2242
+ every consumer remember to. Native navigation is never prevented, so the
2243
+ hash still updates.
2244
+
2245
+ Place it as the very first focusable element on the page, before the app
2246
+ chrome, and point `href` at the `id` of the main content region.
2247
+
2248
+ Import: `import "@f-ewald/components/skip-link.js";`
2249
+
2250
+ Properties: `href` (attribute `href`) : string, default "#main"; `label` (attribute `label`) : string, default "Skip to main content"
2251
+ Events: none
2252
+ CSS custom properties: `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-radius-sm`, `--ui-shadow`, `--ui-text`
2253
+
2254
+ Example:
2255
+ ```html
2256
+ <skip-link href="#main"></skip-link>
2257
+ <skip-link href="#results" label="Jump to results"></skip-link>
2258
+ ```
2259
+
2165
2260
  ## <slide-panel>
2166
2261
 
2167
2262
  Generic sliding panel shell. Handles positioning, open/close animation,
@@ -2175,7 +2270,7 @@ Import: `import "@f-ewald/components/slide-panel.js";`
2175
2270
 
2176
2271
  Properties: `open` (attribute `open`) : boolean, default false; `heading` (attribute `heading`) : string, default ""
2177
2272
  Events: `panel-close`
2178
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
2273
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
2179
2274
 
2180
2275
  Example:
2181
2276
  ```html
@@ -2184,6 +2279,50 @@ Example:
2184
2279
  </slide-panel>
2185
2280
  ```
2186
2281
 
2282
+ ## <spec-list>
2283
+
2284
+ A key/value specification sheet — the "spec sheet" block on a product page:
2285
+ a muted, wide-tracked key column against a value column, separated by
2286
+ hairline rules (and uppercased under themes that set
2287
+ `--ui-label-transform`). It describes ONE record's attributes, which is
2288
+ what sets it apart from `data-table` (many records, many columns, sorting);
2289
+ `spec-list` is not tabular and renders a real `<dl>`/`<dt>`/`<dd>` structure.
2290
+
2291
+ Feed it the `items` array for the plain data path, or slot bare `<dt>`/`<dd>`
2292
+ pairs when a value needs a link, a `status-pill`, or other markup — slotted
2293
+ pairs inherit the component's own key/value styling, so no page CSS is
2294
+ needed. A `<div>` wrapping a pair is also accepted as a full-width grouping
2295
+ row, but `::slotted()` cannot reach inside it, so those `dt`/`dd` stay the
2296
+ consumer's to style. Slotted content takes precedence over `items`; with
2297
+ neither, nothing is rendered.
2298
+
2299
+ Import: `import "@f-ewald/components/spec-list.js";`
2300
+
2301
+ Properties: `items` (attribute `items`) : SpecListItem[], default []; `layout` (attribute `layout`) : "auto" | "stacked", default "auto"; `dividers` (attribute `dividers`) : boolean, default true; `caption` (attribute `caption`) : string, default ""
2302
+ Events: none
2303
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-label-transform`, `--ui-line-height-normal`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
2304
+
2305
+ Example:
2306
+ ```html
2307
+ <spec-list caption="Specifications"></spec-list>
2308
+ <script type="module">
2309
+ document.querySelector("spec-list").items = [
2310
+ { label: "Material", value: "Anodized aluminum" },
2311
+ { label: "Weight", value: "1.2 kg" },
2312
+ { label: "Warranty", value: "2 years" },
2313
+ ];
2314
+ </script>
2315
+
2316
+ <!-- Or slot your own pairs when a value needs a link, a status-pill, or other
2317
+ markup; slotted `dt`/`dd` pick up the component's own key/value styling.
2318
+ `dividers` defaults to true; turn it off via the property, since a
2319
+ `dividers="false"` attribute still parses as a truthy boolean. -->
2320
+ <spec-list layout="stacked" id="sheet">
2321
+ <dt>Homepage</dt>
2322
+ <dd><a href="https://example.com">example.com</a></dd>
2323
+ </spec-list>
2324
+ ```
2325
+
2187
2326
  ## <split-hero>
2188
2327
 
2189
2328
  Full-viewport split layout: a user-supplied photo fills one half, the
@@ -2222,7 +2361,7 @@ Import: `import "@f-ewald/components/stat-meter.js";`
2222
2361
 
2223
2362
  Properties: `label` (attribute `label`) : string, default ""; `percent` (attribute `percent`) : number | null, default null; `color` (attribute `color`) : string, default ""; `trackColor` (attribute `track-color`) : string, default ""
2224
2363
  Events: none
2225
- CSS custom properties: `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-radius-pill`, `--ui-success`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
2364
+ CSS custom properties: `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-label-transform`, `--ui-radius-pill`, `--ui-success`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
2226
2365
 
2227
2366
  Example:
2228
2367
  ```html
@@ -2292,7 +2431,7 @@ Import: `import "@f-ewald/components/tab-bar.js";`
2292
2431
 
2293
2432
  Properties: `label` (attribute `label`) : string, default ""
2294
2433
  Events: `change`
2295
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-text`, `--ui-text-muted`
2434
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-text`, `--ui-text-muted`
2296
2435
 
2297
2436
  Example:
2298
2437
  ```html
@@ -2337,7 +2476,7 @@ Import: `import "@f-ewald/components/text-area.js";`
2337
2476
 
2338
2477
  Properties: `value` (attribute `value`) : string, default ""; `rows` (attribute `rows`) : number, default 4; `placeholder` (attribute `placeholder`) : string, default ""; `readonly` (attribute `readonly`) : boolean, default false; `disabled` (attribute `disabled`) : boolean, default false
2339
2478
  Events: `input`, `change`
2340
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-regular`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
2479
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-regular`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
2341
2480
 
2342
2481
  Example:
2343
2482
  ```html
@@ -2368,7 +2507,7 @@ Import: `import "@f-ewald/components/tile-grid.js";`
2368
2507
 
2369
2508
  Properties: `items` (JS property only) : unknown[], default []; `itemKey` (JS property only) : (item: unknown, index: number) => string | number, default —; `renderTile` (JS property only) : (item: unknown) => unknown, default —; `itemHref` (JS property only) : ((item: unknown) => string | null) | null, default null; `fileIcon` (attribute `file-icon`) : boolean, default false
2370
2509
  Events: none
2371
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
2510
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
2372
2511
 
2373
2512
  Example:
2374
2513
  ```html
@@ -2565,7 +2704,7 @@ Import: `import "@f-ewald/components/tree-view.js";`
2565
2704
 
2566
2705
  Properties: `nodes` (JS property only) : TreeNode[], default []; `renderNode` (JS property only) : (node: TreeNode) => unknown, default —; `defaultExpanded` (attribute `default-expanded`) : boolean, default false; `lines` (attribute `lines`) : boolean, default false
2567
2706
  Events: `node-click`
2568
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
2707
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
2569
2708
 
2570
2709
  Example:
2571
2710
  ```html
@@ -2599,7 +2738,7 @@ Import: `import "@f-ewald/components/ui-admonition.js";`
2599
2738
 
2600
2739
  Properties: `variant` (attribute `variant`) : AdmonitionVariant, default "info"; `icon` (JS property only) : TemplateResult | null, default null
2601
2740
  Events: none
2602
- CSS custom properties: `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-info`, `--ui-line-height-normal`, `--ui-radius`, `--ui-success`, `--ui-surface`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
2741
+ CSS custom properties: `--ui-border-width`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-info`, `--ui-line-height-normal`, `--ui-radius`, `--ui-success`, `--ui-surface`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
2603
2742
 
2604
2743
  Example:
2605
2744
  ```html
@@ -2668,7 +2807,7 @@ Import: `import "@f-ewald/components/ui-button.js";`
2668
2807
 
2669
2808
  Properties: `variant` (attribute `variant`) : ButtonVariant, default "primary"; `size` (attribute `size`) : "sm" | "md", default "md"; `pill` (attribute `pill`) : boolean, default false; `ai` (attribute `ai`) : boolean, default false; `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
2670
2809
  Events: none
2671
- CSS custom properties: `--ui-ai-1`, `--ui-ai-2`, `--ui-ai-3`, `--ui-ai-4`, `--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-pill`, `--ui-radius-sm`, `--ui-text`, `--ui-text-muted`
2810
+ CSS custom properties: `--ui-ai-1`, `--ui-ai-2`, `--ui-ai-3`, `--ui-ai-4`, `--ui-border`, `--ui-border-width`, `--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-pill`, `--ui-radius-sm`, `--ui-text`, `--ui-text-muted`
2672
2811
 
2673
2812
  Example:
2674
2813
  ```html
@@ -2753,7 +2892,7 @@ Import: `import "@f-ewald/components/video-player.js";`
2753
2892
 
2754
2893
  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"
2755
2894
  Events: `play`, `pause`, `ended`
2756
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`
2895
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`
2757
2896
 
2758
2897
  Example:
2759
2898
  ```html
@@ -2764,6 +2903,30 @@ Example:
2764
2903
  ></video-player>
2765
2904
  ```
2766
2905
 
2906
+ ## <vote-control>
2907
+
2908
+ An up/down vote widget with a live score readout — the "vote an entry up or
2909
+ down toward a promotion threshold" pattern from a public register site,
2910
+ where one member casts a single vote that can be changed or withdrawn at any
2911
+ time. Two native `<button>`s flank a score; the button matching the user's
2912
+ own cast `vote` reads as pressed (`aria-pressed`), and clicking it again
2913
+ withdraws the vote. Set an optional `target` to render a thin progress meter
2914
+ toward the promotion threshold beneath (vertical) or beside (horizontal) the
2915
+ buttons.
2916
+
2917
+ Import: `import "@f-ewald/components/vote-control.js";`
2918
+
2919
+ Properties: `value` (attribute `value`) : number, default 0; `vote` (attribute `vote`) : "up" | "down" | null, default null; `disabled` (attribute `disabled`) : boolean, default false; `orientation` (attribute `orientation`) : "vertical" | "horizontal", default "vertical"; `target` (attribute `target`) : number, default 0; `label` (attribute `label`) : string, default "Vote"
2920
+ Events: `vote-change`
2921
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-button-accent`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-label-transform`, `--ui-line-height-tight`, `--ui-numeric`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
2922
+
2923
+ Example:
2924
+ ```html
2925
+ <vote-control value="7" target="10" label="Vote for this entry"></vote-control>
2926
+ <vote-control orientation="horizontal" value="42" target="50"></vote-control>
2927
+ <vote-control value="3" disabled></vote-control>
2928
+ ```
2929
+
2767
2930
  ## <weight-bar-chart>
2768
2931
 
2769
2932
  Sorted horizontal bar chart of labeled weights (normalized fractions