@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.
- package/README.md +2 -0
- package/custom-elements.json +275 -1
- package/dist/address-autocomplete.js +1 -1
- package/dist/address-autocomplete.js.map +1 -1
- package/dist/autocomplete-input.js +1 -1
- package/dist/autocomplete-input.js.map +1 -1
- package/dist/form-field.d.ts.map +1 -1
- package/dist/form-field.js +81 -13
- package/dist/form-field.js.map +1 -1
- package/dist/form-select.js +3 -3
- package/dist/form-select.js.map +1 -1
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/dist/multi-select.js +3 -3
- package/dist/multi-select.js.map +1 -1
- package/dist/progress-bar.d.ts +31 -0
- package/dist/progress-bar.d.ts.map +1 -0
- package/dist/progress-bar.js +128 -0
- package/dist/progress-bar.js.map +1 -0
- package/dist/radio-cards.d.ts +19 -0
- package/dist/radio-cards.d.ts.map +1 -1
- package/dist/radio-cards.js +62 -4
- package/dist/radio-cards.js.map +1 -1
- package/dist/text-area.js +3 -3
- package/dist/text-area.js.map +1 -1
- package/dist/ui-admonition.d.ts +33 -0
- package/dist/ui-admonition.d.ts.map +1 -0
- package/dist/ui-admonition.js +147 -0
- package/dist/ui-admonition.js.map +1 -0
- package/docs/address-autocomplete.md +1 -0
- package/docs/autocomplete-input.md +1 -0
- package/docs/form-field.md +2 -0
- package/docs/form-select.md +1 -1
- package/docs/multi-select.md +1 -0
- package/docs/progress-bar.md +51 -0
- package/docs/radio-cards.md +9 -0
- package/docs/text-area.md +1 -0
- package/docs/ui-admonition.md +55 -0
- package/llms.txt +59 -7
- 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
|
|
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
|