@f-ewald/components 1.30.1 → 1.32.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 (42) hide show
  1. package/README.md +2 -0
  2. package/custom-elements.json +275 -1
  3. package/dist/address-autocomplete.js +1 -1
  4. package/dist/address-autocomplete.js.map +1 -1
  5. package/dist/autocomplete-input.js +1 -1
  6. package/dist/autocomplete-input.js.map +1 -1
  7. package/dist/form-field.d.ts.map +1 -1
  8. package/dist/form-field.js +81 -13
  9. package/dist/form-field.js.map +1 -1
  10. package/dist/form-select.js +3 -3
  11. package/dist/form-select.js.map +1 -1
  12. package/dist/index.d.ts +2 -0
  13. package/dist/index.d.ts.map +1 -1
  14. package/dist/index.js +2 -0
  15. package/dist/index.js.map +1 -1
  16. package/dist/multi-select.js +3 -3
  17. package/dist/multi-select.js.map +1 -1
  18. package/dist/progress-bar.d.ts +31 -0
  19. package/dist/progress-bar.d.ts.map +1 -0
  20. package/dist/progress-bar.js +128 -0
  21. package/dist/progress-bar.js.map +1 -0
  22. package/dist/radio-cards.d.ts +19 -0
  23. package/dist/radio-cards.d.ts.map +1 -1
  24. package/dist/radio-cards.js +62 -4
  25. package/dist/radio-cards.js.map +1 -1
  26. package/dist/text-area.js +3 -3
  27. package/dist/text-area.js.map +1 -1
  28. package/dist/ui-admonition.d.ts +33 -0
  29. package/dist/ui-admonition.d.ts.map +1 -0
  30. package/dist/ui-admonition.js +147 -0
  31. package/dist/ui-admonition.js.map +1 -0
  32. package/docs/address-autocomplete.md +1 -0
  33. package/docs/autocomplete-input.md +1 -0
  34. package/docs/form-field.md +2 -0
  35. package/docs/form-select.md +1 -1
  36. package/docs/multi-select.md +1 -0
  37. package/docs/progress-bar.md +51 -0
  38. package/docs/radio-cards.md +9 -0
  39. package/docs/text-area.md +1 -0
  40. package/docs/ui-admonition.md +55 -0
  41. package/llms.txt +59 -7
  42. package/package.json +1 -1
package/llms.txt CHANGED
@@ -131,7 +131,7 @@ Import: `import "@f-ewald/components/address-autocomplete.js";`
131
131
 
132
132
  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 —
133
133
  Events: `address-select`, `input`
134
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--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`
134
+ 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`
135
135
 
136
136
  Example:
137
137
  ```html
@@ -326,7 +326,7 @@ Import: `import "@f-ewald/components/autocomplete-input.js";`
326
326
 
327
327
  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 —
328
328
  Events: `option-select`, `input`
329
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--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`
329
+ 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`
330
330
 
331
331
  Example:
332
332
  ```html
@@ -956,7 +956,7 @@ Import: `import "@f-ewald/components/form-field.js";`
956
956
 
957
957
  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
958
958
  Events: none
959
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
959
+ 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`
960
960
 
961
961
  Example:
962
962
  ```html
@@ -1000,7 +1000,7 @@ Import: `import "@f-ewald/components/form-select.js";`
1000
1000
 
1001
1001
  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
1002
1002
  Events: `change`
1003
- CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1003
+ 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-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1004
1004
 
1005
1005
  Example:
1006
1006
  ```html
@@ -1594,7 +1594,7 @@ Import: `import "@f-ewald/components/multi-select.js";`
1594
1594
 
1595
1595
  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
1596
1596
  Events: `change`
1597
- CSS custom properties: `--ui-border`, `--ui-danger`, `--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`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1597
+ 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-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1598
1598
 
1599
1599
  Example:
1600
1600
  ```html
@@ -1799,6 +1799,27 @@ Example:
1799
1799
  </script>
1800
1800
  ```
1801
1801
 
1802
+ ## <progress-bar>
1803
+
1804
+ A determinate horizontal progress indicator — a page-level "step 3 of 14"
1805
+ bar. `stat-meter` is the closest existing thing but is an inline
1806
+ CPU-gauge-style meter with a leading label and a computed percent value;
1807
+ `progress-bar` instead takes a raw `value`/`max` pair and renders an
1808
+ optional plain-text `label` to the right of the bar rather than a percent
1809
+ inside it.
1810
+
1811
+ Import: `import "@f-ewald/components/progress-bar.js";`
1812
+
1813
+ 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 ""
1814
+ Events: none
1815
+ CSS custom properties: `--ui-button-accent`, `--ui-font`, `--ui-font-size-sm`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text-muted`
1816
+
1817
+ Example:
1818
+ ```html
1819
+ <progress-bar value="3" max="14" label="Question 3 out of 14"></progress-bar>
1820
+ <progress-bar value="7" max="10" color="#dc2626" track-color="#fecaca"></progress-bar>
1821
+ ```
1822
+
1802
1823
  ## <radio-cards>
1803
1824
 
1804
1825
  Single-select group of full-width cards, each with a label and optional
@@ -1817,9 +1838,16 @@ toward `--ui-surface` rather than taking a second token: the tint stays
1817
1838
  the same hue and gradient, just lighter on light themes (and
1818
1839
  correspondingly deeper on dark ones) than on a button.
1819
1840
 
1841
+ `layout` controls how cards flow ("mixed" wraps with per-option
1842
+ `fullWidth` rows, "vertical" stacks one per row, "horizontal" stays
1843
+ side-by-side at every width). `hideInput` visually hides the radio dot via
1844
+ the same `sr-only` clip pattern as `ui-checkbox` — the native input stays
1845
+ in the DOM for keyboard/a11y, and the card's own border/tint carries the
1846
+ selected state instead.
1847
+
1820
1848
  Import: `import "@f-ewald/components/radio-cards.js";`
1821
1849
 
1822
- Properties: `options` (JS property only) : RadioCardOption[], default []; `value` (attribute `value`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false
1850
+ 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
1823
1851
  Events: `change`
1824
1852
  CSS custom properties: `--ui-border`, `--ui-button-accent`, `--ui-button-highlight`, `--ui-button-secondary-surface-muted`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
1825
1853
 
@@ -2237,7 +2265,7 @@ Import: `import "@f-ewald/components/text-area.js";`
2237
2265
 
2238
2266
  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
2239
2267
  Events: `input`, `change`
2240
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--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`
2268
+ 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`
2241
2269
 
2242
2270
  Example:
2243
2271
  ```html
@@ -2476,6 +2504,30 @@ Example:
2476
2504
  </script>
2477
2505
  ```
2478
2506
 
2507
+ ## <ui-admonition>
2508
+
2509
+ Bordered, rounded callout card for an inline notice with an optional call
2510
+ to action — "take the quiz to personalize your weights", "this feature is
2511
+ in beta", etc. Unlike `status-banner` (a borderless, non-rounded
2512
+ full-width bar for a persistent app-level condition), this is meant to sit
2513
+ inline within a page's content column, so it always has a visible border
2514
+ and radius. Colors follow the same tinted-background + accent-color
2515
+ scheme as `status-banner`/`status-pill`.
2516
+
2517
+ Import: `import "@f-ewald/components/ui-admonition.js";`
2518
+
2519
+ Properties: `variant` (attribute `variant`) : AdmonitionVariant, default "info"; `icon` (JS property only) : TemplateResult | null, default null
2520
+ Events: none
2521
+ 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`
2522
+
2523
+ Example:
2524
+ ```html
2525
+ <ui-admonition variant="info">
2526
+ These are balanced defaults — take the quiz to personalize them.
2527
+ <ui-button slot="actions" variant="primary">Take the quiz</ui-button>
2528
+ </ui-admonition>
2529
+ ```
2530
+
2479
2531
  ## <ui-button>
2480
2532
 
2481
2533
  Button (or link styled as one) with an optional leading icon, in three
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@f-ewald/components",
3
3
  "private": false,
4
- "version": "1.30.1",
4
+ "version": "1.32.0",
5
5
  "description": "A collection of universally usable web components for various tasks.",
6
6
  "type": "module",
7
7
  "main": "dist/index.js",