@f-ewald/components 1.38.0 → 1.40.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 (197) hide show
  1. package/README.md +48 -0
  2. package/custom-elements.json +1052 -131
  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 +69 -0
  14. package/dist/breadcrumb-nav.d.ts.map +1 -0
  15. package/dist/breadcrumb-nav.js +235 -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 +42 -0
  47. package/dist/empty-state.d.ts.map +1 -0
  48. package/dist/empty-state.js +172 -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 +30 -0
  103. package/dist/skip-link.d.ts.map +1 -0
  104. package/dist/skip-link.js +136 -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 +49 -0
  109. package/dist/spec-list.d.ts.map +1 -0
  110. package/dist/spec-list.js +168 -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 +132 -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/ui-checkbox.d.ts +10 -1
  133. package/dist/ui-checkbox.d.ts.map +1 -1
  134. package/dist/ui-checkbox.js +11 -2
  135. package/dist/ui-checkbox.js.map +1 -1
  136. package/dist/video-player.js +1 -1
  137. package/dist/video-player.js.map +1 -1
  138. package/dist/vote-control.d.ts +40 -0
  139. package/dist/vote-control.d.ts.map +1 -0
  140. package/dist/vote-control.js +311 -0
  141. package/dist/vote-control.js.map +1 -0
  142. package/docs/address-autocomplete.md +1 -0
  143. package/docs/app-shell.md +1 -0
  144. package/docs/app-sidebar.md +1 -0
  145. package/docs/audio-player.md +1 -0
  146. package/docs/autocomplete-input.md +1 -0
  147. package/docs/breadcrumb-nav.md +70 -0
  148. package/docs/button-group.md +1 -0
  149. package/docs/calendar-day.md +1 -0
  150. package/docs/calendar-month.md +1 -0
  151. package/docs/calendar-week.md +1 -0
  152. package/docs/chat-message.md +1 -0
  153. package/docs/comment-composer.md +1 -0
  154. package/docs/confirm-dialog.md +1 -0
  155. package/docs/content-divider.md +1 -0
  156. package/docs/cron-schedule.md +2 -0
  157. package/docs/data-table.md +2 -0
  158. package/docs/design-language.md +57 -5
  159. package/docs/dropdown-button.md +1 -0
  160. package/docs/editable-text.md +1 -0
  161. package/docs/empty-state.md +55 -0
  162. package/docs/form-field.md +1 -0
  163. package/docs/form-select.md +1 -0
  164. package/docs/frame-box.md +1 -0
  165. package/docs/fullscreen-button.md +1 -0
  166. package/docs/icons.md +1 -0
  167. package/docs/kanban-card.md +1 -0
  168. package/docs/kanban-column.md +1 -0
  169. package/docs/kbd-hint.md +1 -0
  170. package/docs/link-card.md +1 -0
  171. package/docs/markdown-view.md +1 -0
  172. package/docs/modal-dialog.md +1 -0
  173. package/docs/multi-select.md +1 -0
  174. package/docs/pagination-nav.md +2 -0
  175. package/docs/photo-gallery.md +1 -0
  176. package/docs/popover-panel.md +1 -0
  177. package/docs/progress-bar.md +1 -0
  178. package/docs/radio-cards.md +1 -0
  179. package/docs/radio-pills.md +1 -0
  180. package/docs/reveal-button.md +1 -0
  181. package/docs/scroll-to-bottom.md +1 -0
  182. package/docs/scroll-to-top.md +1 -0
  183. package/docs/skip-link.md +54 -0
  184. package/docs/slide-panel.md +1 -0
  185. package/docs/spec-list.md +71 -0
  186. package/docs/stat-meter.md +1 -0
  187. package/docs/tab-bar.md +1 -0
  188. package/docs/text-area.md +1 -0
  189. package/docs/tile-grid.md +1 -0
  190. package/docs/tree-view.md +1 -0
  191. package/docs/ui-admonition.md +1 -0
  192. package/docs/ui-button.md +1 -0
  193. package/docs/ui-checkbox.md +13 -2
  194. package/docs/video-player.md +1 -0
  195. package/docs/vote-control.md +73 -0
  196. package/llms.txt +210 -49
  197. 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"
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,38 @@ 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. It needs no JavaScript beyond the element
2238
+ upgrade — the anchor's native in-page navigation does the rest.
2239
+
2240
+ Place it as the very first focusable element on the page, before the app
2241
+ chrome, and point `href` at the `id` of the main content region.
2242
+
2243
+ Import: `import "@f-ewald/components/skip-link.js";`
2244
+
2245
+ Properties: `href` (attribute `href`) : string, default "#main"; `label` (attribute `label`) : string, default "Skip to main content"
2246
+ Events: none
2247
+ 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`
2248
+
2249
+ Example:
2250
+ ```html
2251
+ <skip-link href="#main"></skip-link>
2252
+ <skip-link href="#results" label="Jump to results"></skip-link>
2253
+ ```
2254
+
2165
2255
  ## <slide-panel>
2166
2256
 
2167
2257
  Generic sliding panel shell. Handles positioning, open/close animation,
@@ -2175,7 +2265,7 @@ Import: `import "@f-ewald/components/slide-panel.js";`
2175
2265
 
2176
2266
  Properties: `open` (attribute `open`) : boolean, default false; `heading` (attribute `heading`) : string, default ""
2177
2267
  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`
2268
+ 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
2269
 
2180
2270
  Example:
2181
2271
  ```html
@@ -2184,6 +2274,44 @@ Example:
2184
2274
  </slide-panel>
2185
2275
  ```
2186
2276
 
2277
+ ## <spec-list>
2278
+
2279
+ A key/value specification sheet — the "spec sheet" block on a product page:
2280
+ an uppercase, muted, wide-tracked key column against a value column,
2281
+ separated by hairline rules. It describes ONE record's attributes, which is
2282
+ what sets it apart from `data-table` (many records, many columns, sorting);
2283
+ `spec-list` is not tabular and renders a real `<dl>`/`<dt>`/`<dd>` structure.
2284
+
2285
+ Feed it the `items` array for the plain data path, or slot your own
2286
+ `<div><dt>…</dt><dd>…</dd></div>` groups when a value needs a link, a
2287
+ `status-pill`, or other markup. Slotted content takes precedence over
2288
+ `items`; with neither, nothing is rendered.
2289
+
2290
+ Import: `import "@f-ewald/components/spec-list.js";`
2291
+
2292
+ Properties: `items` (attribute `items`) : SpecListItem[], default []; `layout` (attribute `layout`) : "auto" | "stacked", default "auto"; `dividers` (attribute `dividers`) : boolean, default true; `caption` (attribute `caption`) : string, default ""
2293
+ Events: none
2294
+ 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`
2295
+
2296
+ Example:
2297
+ ```html
2298
+ <spec-list caption="Specifications"></spec-list>
2299
+ <script type="module">
2300
+ document.querySelector("spec-list").items = [
2301
+ { label: "Material", value: "Anodized aluminum" },
2302
+ { label: "Weight", value: "1.2 kg" },
2303
+ { label: "Warranty", value: "2 years" },
2304
+ ];
2305
+ </script>
2306
+
2307
+ <!-- Or slot your own groups when a value needs a link, a status-pill, or other
2308
+ markup. `dividers` defaults to true; turn it off via the property, since a
2309
+ `dividers="false"` attribute still parses as a truthy boolean. -->
2310
+ <spec-list layout="stacked" id="sheet">
2311
+ <div><dt>Homepage</dt><dd><a href="https://example.com">example.com</a></dd></div>
2312
+ </spec-list>
2313
+ ```
2314
+
2187
2315
  ## <split-hero>
2188
2316
 
2189
2317
  Full-viewport split layout: a user-supplied photo fills one half, the
@@ -2222,7 +2350,7 @@ Import: `import "@f-ewald/components/stat-meter.js";`
2222
2350
 
2223
2351
  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
2352
  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`
2353
+ 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
2354
 
2227
2355
  Example:
2228
2356
  ```html
@@ -2292,7 +2420,7 @@ Import: `import "@f-ewald/components/tab-bar.js";`
2292
2420
 
2293
2421
  Properties: `label` (attribute `label`) : string, default ""
2294
2422
  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`
2423
+ 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
2424
 
2297
2425
  Example:
2298
2426
  ```html
@@ -2337,7 +2465,7 @@ Import: `import "@f-ewald/components/text-area.js";`
2337
2465
 
2338
2466
  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
2467
  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`
2468
+ 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
2469
 
2342
2470
  Example:
2343
2471
  ```html
@@ -2368,7 +2496,7 @@ Import: `import "@f-ewald/components/tile-grid.js";`
2368
2496
 
2369
2497
  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
2498
  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`
2499
+ 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
2500
 
2373
2501
  Example:
2374
2502
  ```html
@@ -2565,7 +2693,7 @@ Import: `import "@f-ewald/components/tree-view.js";`
2565
2693
 
2566
2694
  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
2695
  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`
2696
+ 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
2697
 
2570
2698
  Example:
2571
2699
  ```html
@@ -2599,7 +2727,7 @@ Import: `import "@f-ewald/components/ui-admonition.js";`
2599
2727
 
2600
2728
  Properties: `variant` (attribute `variant`) : AdmonitionVariant, default "info"; `icon` (JS property only) : TemplateResult | null, default null
2601
2729
  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`
2730
+ 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
2731
 
2604
2732
  Example:
2605
2733
  ```html
@@ -2668,7 +2796,7 @@ Import: `import "@f-ewald/components/ui-button.js";`
2668
2796
 
2669
2797
  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
2798
  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`
2799
+ 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
2800
 
2673
2801
  Example:
2674
2802
  ```html
@@ -2697,6 +2825,13 @@ renders between the box and the label, inside the same clickable `<label>`
2697
2825
  — for a row that pairs a checkbox with an icon/swatch and needs the whole
2698
2826
  row, icon included, to stay one click target.
2699
2827
 
2828
+ The label is the default slot, with the `label` property as its fallback.
2829
+ Slot it instead of setting the property when it needs its own markup or
2830
+ styling — a link, an emphasized word — since a property renders inside this
2831
+ component's shadow DOM and cannot be reached from outside. Either way the
2832
+ label sits inside the native `<label>`, so it stays clickable and still
2833
+ names the checkbox for assistive technology.
2834
+
2700
2835
  Import: `import "@f-ewald/components/ui-checkbox.js";`
2701
2836
 
2702
2837
  Properties: `checked` (attribute `checked`) : boolean, default false; `indeterminate` (attribute `indeterminate`) : boolean, default false; `disabled` (attribute `disabled`) : boolean, default false; `required` (attribute `required`) : boolean, default false; `name` (attribute `name`) : string, default ""; `label` (attribute `label`) : string, default ""; `icon` (JS property only) : TemplateResult | null, default null; `iconSize` (attribute `iconSize`) : number, default 14
@@ -2707,6 +2842,8 @@ Example:
2707
2842
  ```html
2708
2843
  <ui-checkbox label="Subscribe to updates"></ui-checkbox>
2709
2844
  <ui-checkbox name="terms" label="I agree to the terms" required></ui-checkbox>
2845
+ <!-- Slot the label when it needs its own markup; it overrides the property -->
2846
+ <ui-checkbox name="beta">Enable <strong>beta</strong> features</ui-checkbox>
2710
2847
  <!-- .icon is set programmatically (a pre-rendered TemplateResult), not an attribute -->
2711
2848
  <ui-checkbox label="Show list view"></ui-checkbox>
2712
2849
  ```
@@ -2744,7 +2881,7 @@ Import: `import "@f-ewald/components/video-player.js";`
2744
2881
 
2745
2882
  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"
2746
2883
  Events: `play`, `pause`, `ended`
2747
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`
2884
+ CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`
2748
2885
 
2749
2886
  Example:
2750
2887
  ```html
@@ -2755,6 +2892,30 @@ Example:
2755
2892
  ></video-player>
2756
2893
  ```
2757
2894
 
2895
+ ## <vote-control>
2896
+
2897
+ An up/down vote widget with a live score readout — the "vote an entry up or
2898
+ down toward a promotion threshold" pattern from a public register site,
2899
+ where one member casts a single vote that can be changed or withdrawn at any
2900
+ time. Two native `<button>`s flank a score; the button matching the user's
2901
+ own cast `vote` reads as pressed (`aria-pressed`), and clicking it again
2902
+ withdraws the vote. Set an optional `target` to render a thin progress meter
2903
+ toward the promotion threshold beneath (vertical) or beside (horizontal) the
2904
+ buttons.
2905
+
2906
+ Import: `import "@f-ewald/components/vote-control.js";`
2907
+
2908
+ 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"
2909
+ Events: `vote-change`
2910
+ 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`
2911
+
2912
+ Example:
2913
+ ```html
2914
+ <vote-control value="7" target="10" label="Vote for this entry"></vote-control>
2915
+ <vote-control orientation="horizontal" value="42" target="50"></vote-control>
2916
+ <vote-control value="3" disabled></vote-control>
2917
+ ```
2918
+
2758
2919
  ## <weight-bar-chart>
2759
2920
 
2760
2921
  Sorted horizontal bar chart of labeled weights (normalized fractions