@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.
@@ -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"]}
@@ -70,6 +70,7 @@ _None._
70
70
  | `--ui-danger` |
71
71
  | `--ui-focus-ring` |
72
72
  | `--ui-font` |
73
+ | `--ui-font-size` |
73
74
  | `--ui-font-size-sm` |
74
75
  | `--ui-font-size-xs` |
75
76
  | `--ui-font-weight-regular` |
@@ -80,6 +80,7 @@ _None._
80
80
  | `--ui-danger` |
81
81
  | `--ui-focus-ring` |
82
82
  | `--ui-font` |
83
+ | `--ui-font-size` |
83
84
  | `--ui-font-size-sm` |
84
85
  | `--ui-font-size-xs` |
85
86
  | `--ui-font-weight-regular` |
@@ -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` |
@@ -73,7 +73,7 @@ _None._
73
73
  | `--ui-border` |
74
74
  | `--ui-focus-ring` |
75
75
  | `--ui-font` |
76
- | `--ui-font-size-sm` |
76
+ | `--ui-font-size` |
77
77
  | `--ui-font-weight-semibold` |
78
78
  | `--ui-line-height-tight` |
79
79
  | `--ui-primary` |
@@ -106,6 +106,7 @@ _None._
106
106
  | `--ui-danger` |
107
107
  | `--ui-focus-ring` |
108
108
  | `--ui-font` |
109
+ | `--ui-font-size` |
109
110
  | `--ui-font-size-sm` |
110
111
  | `--ui-font-weight-medium` |
111
112
  | `--ui-font-weight-semibold` |
package/docs/text-area.md CHANGED
@@ -51,6 +51,7 @@ _None._
51
51
  | `--ui-danger` |
52
52
  | `--ui-focus-ring` |
53
53
  | `--ui-font` |
54
+ | `--ui-font-size` |
54
55
  | `--ui-font-size-sm` |
55
56
  | `--ui-font-size-xs` |
56
57
  | `--ui-font-weight-regular` |
@@ -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-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
@@ -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
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.31.0",
5
5
  "description": "A collection of universally usable web components for various tasks.",
6
6
  "type": "module",
7
7
  "main": "dist/index.js",