@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.
- package/README.md +6 -0
- package/custom-elements.json +170 -6
- package/dist/breadcrumb-nav.d.ts +20 -2
- package/dist/breadcrumb-nav.d.ts.map +1 -1
- package/dist/breadcrumb-nav.js +53 -7
- package/dist/breadcrumb-nav.js.map +1 -1
- package/dist/button-group.d.ts.map +1 -1
- package/dist/button-group.js +9 -2
- package/dist/button-group.js.map +1 -1
- package/dist/confirm-dialog.d.ts.map +1 -1
- package/dist/confirm-dialog.js +11 -3
- package/dist/confirm-dialog.js.map +1 -1
- package/dist/empty-state.d.ts +16 -0
- package/dist/empty-state.d.ts.map +1 -1
- package/dist/empty-state.js +39 -8
- package/dist/empty-state.js.map +1 -1
- package/dist/pagination-nav.d.ts.map +1 -1
- package/dist/pagination-nav.js +9 -2
- package/dist/pagination-nav.js.map +1 -1
- package/dist/radio-cards.d.ts.map +1 -1
- package/dist/radio-cards.js +9 -2
- package/dist/radio-cards.js.map +1 -1
- package/dist/skip-link.d.ts +10 -2
- package/dist/skip-link.d.ts.map +1 -1
- package/dist/skip-link.js +55 -7
- package/dist/skip-link.js.map +1 -1
- package/dist/spec-list.d.ts +17 -8
- package/dist/spec-list.d.ts.map +1 -1
- package/dist/spec-list.js +103 -45
- package/dist/spec-list.js.map +1 -1
- package/dist/tokens.css +1 -1
- package/dist/tokens.d.ts.map +1 -1
- package/dist/tokens.js +8 -4
- package/dist/tokens.js.map +1 -1
- package/dist/ui-button.d.ts.map +1 -1
- package/dist/ui-button.js +15 -3
- package/dist/ui-button.js.map +1 -1
- package/dist/vote-control.d.ts.map +1 -1
- package/dist/vote-control.js +9 -2
- package/dist/vote-control.js.map +1 -1
- package/docs/breadcrumb-nav.md +1 -1
- package/docs/button-group.md +1 -0
- package/docs/design-language.md +21 -0
- package/docs/empty-state.md +6 -1
- package/docs/pagination-nav.md +1 -0
- package/docs/skip-link.md +10 -3
- package/docs/spec-list.md +18 -10
- package/docs/ui-button.md +1 -0
- package/llms.txt +26 -15
- 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.
|
|
2238
|
-
|
|
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
|
-
|
|
2281
|
-
|
|
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
|
|
2286
|
-
|
|
2287
|
-
|
|
2288
|
-
|
|
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
|
|
2308
|
-
markup
|
|
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
|
-
<
|
|
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
|