@f-ewald/components 1.30.1 → 1.31.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 +1 -0
- package/custom-elements.json +94 -0
- 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 +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -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/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/text-area.md +1 -0
- package/docs/ui-admonition.md +55 -0
- package/llms.txt +30 -6
- package/package.json +1 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ui-admonition.js","sourceRoot":"","sources":["../src/ui-admonition.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAuB,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC;;;;;;;;;;;;GAYG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,UAAU;IAArC;;QA4FL,4EAA4E;QAC/C,YAAO,GAAsB,MAAM,CAAC;QAEjE;;;;WAIG;QAC6B,SAAI,GAA0B,IAAI,CAAC;IAarE,CAAC;aAhHiB,WAAM,GAAG;QACvB,MAAM;QACN,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsFF;KACF,AAzFqB,CAyFpB;IAYO,MAAM;QACb,OAAO,IAAI,CAAA;wBACS,IAAI,CAAC,OAAO,UAAU,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;UAClF,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA,sBAAsB,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO;;;;;;KAMvE,CAAC;IACJ,CAAC;CACF,CAAA;AApB8B;IAA5B,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;6CAAqC;AAOjC;IAA/B,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;0CAAoC;AApGxD,YAAY;IADxB,aAAa,CAAC,eAAe,CAAC;GAClB,YAAY,CAiHxB","sourcesContent":["import { LitElement, type TemplateResult, css, html, nothing } from \"lit\";\nimport { customElement, property } from \"lit/decorators.js\";\nimport { tokens } from \"./tokens.js\";\n\nexport type AdmonitionVariant = \"neutral\" | \"info\" | \"success\" | \"warning\" | \"danger\";\n\n/**\n * Bordered, rounded callout card for an inline notice with an optional call\n * to action — \"take the quiz to personalize your weights\", \"this feature is\n * in beta\", etc. Unlike `status-banner` (a borderless, non-rounded\n * full-width bar for a persistent app-level condition), this is meant to sit\n * inline within a page's content column, so it always has a visible border\n * and radius. Colors follow the same tinted-background + accent-color\n * scheme as `status-banner`/`status-pill`.\n *\n * @element ui-admonition\n * @slot - The message text.\n * @slot actions - Optional call-to-action controls, e.g. a primary `<ui-button>`.\n */\n@customElement(\"ui-admonition\")\nexport class UiAdmonition extends LitElement {\n static override styles = [\n tokens,\n css`\n :host {\n display: block;\n }\n .box {\n display: flex;\n align-items: flex-start;\n gap: 0.5rem;\n border-radius: var(--ui-radius, 0.5rem);\n border: 1px solid;\n padding: 0.75rem 1rem;\n box-sizing: border-box;\n font-family: var(\n --ui-font,\n ui-sans-serif,\n system-ui,\n sans-serif,\n \"Apple Color Emoji\",\n \"Segoe UI Emoji\",\n \"Segoe UI Symbol\",\n \"Noto Color Emoji\"\n );\n font-size: var(--ui-font-size-sm, 0.75rem);\n line-height: var(--ui-line-height-normal, 1.5);\n color: var(--ui-text, #0f172a);\n }\n .icon {\n display: inline-flex;\n line-height: 0;\n flex: 0 0 auto;\n margin-top: 0.125rem;\n }\n .body {\n flex: 1 1 auto;\n min-width: 0;\n }\n .actions {\n display: flex;\n align-items: center;\n flex-wrap: wrap;\n gap: 0.5rem;\n margin-top: 0.75rem;\n }\n .actions:empty {\n display: none;\n }\n .box.neutral {\n background: color-mix(in srgb, var(--ui-text-muted, #64748b) 8%, var(--ui-surface, #ffffff));\n border-color: color-mix(in srgb, var(--ui-text-muted, #64748b) 30%, transparent);\n }\n .box.neutral .icon {\n color: var(--ui-text-muted, #64748b);\n }\n .box.info {\n background: color-mix(in srgb, var(--ui-info, #0ea5e9) 8%, var(--ui-surface, #ffffff));\n border-color: color-mix(in srgb, var(--ui-info, #0ea5e9) 30%, transparent);\n }\n .box.info .icon {\n color: var(--ui-info, #0ea5e9);\n }\n .box.success {\n background: color-mix(in srgb, var(--ui-success, #16a34a) 8%, var(--ui-surface, #ffffff));\n border-color: color-mix(in srgb, var(--ui-success, #16a34a) 30%, transparent);\n }\n .box.success .icon {\n color: var(--ui-success, #16a34a);\n }\n .box.warning {\n background: color-mix(in srgb, var(--ui-warning, #d97706) 8%, var(--ui-surface, #ffffff));\n border-color: color-mix(in srgb, var(--ui-warning, #d97706) 30%, transparent);\n }\n .box.warning .icon {\n color: var(--ui-warning, #d97706);\n }\n .box.danger {\n background: color-mix(in srgb, var(--ui-danger, #dc2626) 8%, var(--ui-surface, #ffffff));\n border-color: color-mix(in srgb, var(--ui-danger, #dc2626) 30%, transparent);\n }\n .box.danger .icon {\n color: var(--ui-danger, #dc2626);\n }\n @media (forced-colors: active) {\n .box {\n border-color: CanvasText;\n }\n }\n `,\n ];\n\n /** Visual style; also selects the accent color for the icon/border/tint. */\n @property({ reflect: true }) variant: AdmonitionVariant = \"info\";\n\n /**\n * Optional leading icon, pre-rendered by the consumer (e.g. `iconInfo(18)`),\n * matching `status-banner`/`nav-item`/`icon-button` — icons are passed in,\n * not named, so the component never has to know the icon catalog.\n */\n @property({ attribute: false }) icon: TemplateResult | null = null;\n\n override render() {\n return html`\n <div class=\"box ${this.variant}\" role=${this.variant === \"danger\" ? \"alert\" : \"status\"}>\n ${this.icon ? html`<span class=\"icon\">${this.icon}</span>` : nothing}\n <div class=\"body\">\n <div class=\"text\"><slot></slot></div>\n <div class=\"actions\"><slot name=\"actions\"></slot></div>\n </div>\n </div>\n `;\n }\n}\n\ndeclare global {\n interface HTMLElementTagNameMap {\n \"ui-admonition\": UiAdmonition;\n }\n}\n"]}
|
package/docs/form-field.md
CHANGED
|
@@ -69,10 +69,12 @@ _None._
|
|
|
69
69
|
| `--ui-danger` |
|
|
70
70
|
| `--ui-focus-ring` |
|
|
71
71
|
| `--ui-font` |
|
|
72
|
+
| `--ui-font-size` |
|
|
72
73
|
| `--ui-font-size-sm` |
|
|
73
74
|
| `--ui-font-size-xs` |
|
|
74
75
|
| `--ui-font-weight-medium` |
|
|
75
76
|
| `--ui-font-weight-regular` |
|
|
77
|
+
| `--ui-line-height-normal` |
|
|
76
78
|
| `--ui-line-height-tight` |
|
|
77
79
|
| `--ui-primary` |
|
|
78
80
|
| `--ui-radius-sm` |
|
package/docs/form-select.md
CHANGED
package/docs/multi-select.md
CHANGED
package/docs/text-area.md
CHANGED
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# `<ui-admonition>`
|
|
2
|
+
|
|
3
|
+
Bordered, rounded callout card for an inline notice with an optional call
|
|
4
|
+
to action — "take the quiz to personalize your weights", "this feature is
|
|
5
|
+
in beta", etc. Unlike `status-banner` (a borderless, non-rounded
|
|
6
|
+
full-width bar for a persistent app-level condition), this is meant to sit
|
|
7
|
+
inline within a page's content column, so it always has a visible border
|
|
8
|
+
and radius. Colors follow the same tinted-background + accent-color
|
|
9
|
+
scheme as `status-banner`/`status-pill`.
|
|
10
|
+
|
|
11
|
+
## Install
|
|
12
|
+
|
|
13
|
+
```js
|
|
14
|
+
import "@f-ewald/components/ui-admonition.js";
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Usage
|
|
18
|
+
|
|
19
|
+
```html
|
|
20
|
+
<ui-admonition variant="info">
|
|
21
|
+
These are balanced defaults — take the quiz to personalize them.
|
|
22
|
+
<ui-button slot="actions" variant="primary">Take the quiz</ui-button>
|
|
23
|
+
</ui-admonition>
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Attributes / properties
|
|
27
|
+
|
|
28
|
+
| Property | Attribute | Type | Default | Description |
|
|
29
|
+
| --- | --- | --- | --- | --- |
|
|
30
|
+
| `variant` | `variant` | `AdmonitionVariant` | `"info"` | Visual style; also selects the accent color for the icon/border/tint. |
|
|
31
|
+
| `icon` | _(JS property only)_ | `TemplateResult | null` | `null` | Optional leading icon, pre-rendered by the consumer (e.g. `iconInfo(18)`), matching `status-banner`/`nav-item`/`icon-button` — icons are passed in, not named, so the component never has to know the icon catalog. |
|
|
32
|
+
|
|
33
|
+
## Events
|
|
34
|
+
|
|
35
|
+
_None._
|
|
36
|
+
|
|
37
|
+
## Slots
|
|
38
|
+
|
|
39
|
+
_None._
|
|
40
|
+
|
|
41
|
+
## CSS custom properties
|
|
42
|
+
|
|
43
|
+
| Custom property |
|
|
44
|
+
| --- |
|
|
45
|
+
| `--ui-danger` |
|
|
46
|
+
| `--ui-font` |
|
|
47
|
+
| `--ui-font-size-sm` |
|
|
48
|
+
| `--ui-info` |
|
|
49
|
+
| `--ui-line-height-normal` |
|
|
50
|
+
| `--ui-radius` |
|
|
51
|
+
| `--ui-success` |
|
|
52
|
+
| `--ui-surface` |
|
|
53
|
+
| `--ui-text` |
|
|
54
|
+
| `--ui-text-muted` |
|
|
55
|
+
| `--ui-warning` |
|
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
|
|
@@ -2237,7 +2237,7 @@ Import: `import "@f-ewald/components/text-area.js";`
|
|
|
2237
2237
|
|
|
2238
2238
|
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
2239
|
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`
|
|
2240
|
+
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
2241
|
|
|
2242
2242
|
Example:
|
|
2243
2243
|
```html
|
|
@@ -2476,6 +2476,30 @@ Example:
|
|
|
2476
2476
|
</script>
|
|
2477
2477
|
```
|
|
2478
2478
|
|
|
2479
|
+
## <ui-admonition>
|
|
2480
|
+
|
|
2481
|
+
Bordered, rounded callout card for an inline notice with an optional call
|
|
2482
|
+
to action — "take the quiz to personalize your weights", "this feature is
|
|
2483
|
+
in beta", etc. Unlike `status-banner` (a borderless, non-rounded
|
|
2484
|
+
full-width bar for a persistent app-level condition), this is meant to sit
|
|
2485
|
+
inline within a page's content column, so it always has a visible border
|
|
2486
|
+
and radius. Colors follow the same tinted-background + accent-color
|
|
2487
|
+
scheme as `status-banner`/`status-pill`.
|
|
2488
|
+
|
|
2489
|
+
Import: `import "@f-ewald/components/ui-admonition.js";`
|
|
2490
|
+
|
|
2491
|
+
Properties: `variant` (attribute `variant`) : AdmonitionVariant, default "info"; `icon` (JS property only) : TemplateResult | null, default null
|
|
2492
|
+
Events: none
|
|
2493
|
+
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`
|
|
2494
|
+
|
|
2495
|
+
Example:
|
|
2496
|
+
```html
|
|
2497
|
+
<ui-admonition variant="info">
|
|
2498
|
+
These are balanced defaults — take the quiz to personalize them.
|
|
2499
|
+
<ui-button slot="actions" variant="primary">Take the quiz</ui-button>
|
|
2500
|
+
</ui-admonition>
|
|
2501
|
+
```
|
|
2502
|
+
|
|
2479
2503
|
## <ui-button>
|
|
2480
2504
|
|
|
2481
2505
|
Button (or link styled as one) with an optional leading icon, in three
|