@f-ewald/components 1.40.0 → 1.40.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/README.md +6 -0
  2. package/custom-elements.json +170 -6
  3. package/dist/breadcrumb-nav.d.ts +20 -2
  4. package/dist/breadcrumb-nav.d.ts.map +1 -1
  5. package/dist/breadcrumb-nav.js +53 -7
  6. package/dist/breadcrumb-nav.js.map +1 -1
  7. package/dist/button-group.d.ts.map +1 -1
  8. package/dist/button-group.js +9 -2
  9. package/dist/button-group.js.map +1 -1
  10. package/dist/confirm-dialog.d.ts.map +1 -1
  11. package/dist/confirm-dialog.js +11 -3
  12. package/dist/confirm-dialog.js.map +1 -1
  13. package/dist/empty-state.d.ts +16 -0
  14. package/dist/empty-state.d.ts.map +1 -1
  15. package/dist/empty-state.js +39 -8
  16. package/dist/empty-state.js.map +1 -1
  17. package/dist/pagination-nav.d.ts.map +1 -1
  18. package/dist/pagination-nav.js +9 -2
  19. package/dist/pagination-nav.js.map +1 -1
  20. package/dist/radio-cards.d.ts.map +1 -1
  21. package/dist/radio-cards.js +9 -2
  22. package/dist/radio-cards.js.map +1 -1
  23. package/dist/skip-link.d.ts +10 -2
  24. package/dist/skip-link.d.ts.map +1 -1
  25. package/dist/skip-link.js +55 -7
  26. package/dist/skip-link.js.map +1 -1
  27. package/dist/spec-list.d.ts +17 -8
  28. package/dist/spec-list.d.ts.map +1 -1
  29. package/dist/spec-list.js +103 -45
  30. package/dist/spec-list.js.map +1 -1
  31. package/dist/tokens.css +1 -1
  32. package/dist/tokens.d.ts.map +1 -1
  33. package/dist/tokens.js +8 -4
  34. package/dist/tokens.js.map +1 -1
  35. package/dist/ui-button.d.ts.map +1 -1
  36. package/dist/ui-button.js +15 -3
  37. package/dist/ui-button.js.map +1 -1
  38. package/dist/vote-control.d.ts.map +1 -1
  39. package/dist/vote-control.js +9 -2
  40. package/dist/vote-control.js.map +1 -1
  41. package/docs/breadcrumb-nav.md +1 -1
  42. package/docs/button-group.md +1 -0
  43. package/docs/design-language.md +21 -0
  44. package/docs/empty-state.md +6 -1
  45. package/docs/pagination-nav.md +1 -0
  46. package/docs/skip-link.md +10 -3
  47. package/docs/spec-list.md +18 -10
  48. package/docs/ui-button.md +1 -0
  49. package/llms.txt +26 -15
  50. package/package.json +1 -1
package/llms.txt CHANGED
@@ -447,7 +447,7 @@ Import: `import "@f-ewald/components/button-group.js";`
447
447
 
448
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"
449
449
  Events: `change`
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`
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`, `--ui-surface-muted`, `--ui-text`
451
451
 
452
452
  Example:
453
453
  ```html
@@ -1023,7 +1023,7 @@ completely when absent, reserving no layout space.
1023
1023
 
1024
1024
  Import: `import "@f-ewald/components/empty-state.js";`
1025
1025
 
1026
- Properties: `heading` (attribute `heading`) : string, default ""; `description` (attribute `description`) : string, default ""; `size` (attribute `size`) : "sm" | "md", default "md"
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
1027
  Events: none
1028
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
1029
 
@@ -1799,7 +1799,7 @@ Import: `import "@f-ewald/components/pagination-nav.js";`
1799
1799
 
1800
1800
  Properties: `currentPage` (attribute `current-page`) : number, default 1; `totalPages` (attribute `total-pages`) : number, default 1
1801
1801
  Events: `page-change`
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`
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`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1803
1803
 
1804
1804
  Example:
1805
1805
  ```html
@@ -2234,8 +2234,13 @@ accessibility-utility component. It renders a real `<a>` that stays
2234
2234
  visually hidden (but in the focus order) until it receives keyboard focus,
2235
2235
  then pins itself to the top-left of the viewport as a solid, high-contrast
2236
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.
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.
2239
2244
 
2240
2245
  Place it as the very first focusable element on the page, before the app
2241
2246
  chrome, and point `href` at the `id` of the main content region.
@@ -2277,15 +2282,19 @@ Example:
2277
2282
  ## <spec-list>
2278
2283
 
2279
2284
  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
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
2282
2288
  what sets it apart from `data-table` (many records, many columns, sorting);
2283
2289
  `spec-list` is not tabular and renders a real `<dl>`/`<dt>`/`<dd>` structure.
2284
2290
 
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.
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.
2289
2298
 
2290
2299
  Import: `import "@f-ewald/components/spec-list.js";`
2291
2300
 
@@ -2304,11 +2313,13 @@ Example:
2304
2313
  ];
2305
2314
  </script>
2306
2315
 
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
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
2309
2319
  `dividers="false"` attribute still parses as a truthy boolean. -->
2310
2320
  <spec-list layout="stacked" id="sheet">
2311
- <div><dt>Homepage</dt><dd><a href="https://example.com">example.com</a></dd></div>
2321
+ <dt>Homepage</dt>
2322
+ <dd><a href="https://example.com">example.com</a></dd>
2312
2323
  </spec-list>
2313
2324
  ```
2314
2325
 
@@ -2796,7 +2807,7 @@ Import: `import "@f-ewald/components/ui-button.js";`
2796
2807
 
2797
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
2798
2809
  Events: none
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`
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-surface`, `--ui-text`, `--ui-text-muted`
2800
2811
 
2801
2812
  Example:
2802
2813
  ```html
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@f-ewald/components",
3
3
  "private": false,
4
- "version": "1.40.0",
4
+ "version": "1.40.2",
5
5
  "description": "A collection of universally usable web components for various tasks.",
6
6
  "type": "module",
7
7
  "main": "dist/index.js",