@f-ewald/components 1.30.0 → 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` |
@@ -36,7 +36,7 @@ import "@f-ewald/components/calendar-day.js";
36
36
  | Property | Attribute | Type | Default | Description |
37
37
  | --- | --- | --- | --- | --- |
38
38
  | `date` | `date` | `string` | `—` | The day shown, `"YYYY-MM-DD"`. |
39
- | `timeMarker` | `time-marker` | `boolean` | `false` | Shows a fine live line marking the current time, Google-Calendar-style. Only rendered when `date` is today. |
39
+ | `timeMarker` | `time-marker` | `boolean` | `false` | Shows a fine live line marking the current time, with a rounded pill in the hour gutter reading the current clock time. The hour label the pill covers is hidden while it does. Only rendered when `date` is today. |
40
40
  | `minWidth` | `min-width` | `string` | `""` | Minimum width for the day column, as a CSS length (e.g. `"18rem"`). Unset leaves the host's width fully controlled by its container — useful as the sizing floor when placing several `calendar-day` elements in a scrollable row. |
41
41
 
42
42
  ## Events
@@ -67,6 +67,7 @@ _None._
67
67
  | `--ui-hover-overlay` |
68
68
  | `--ui-info` |
69
69
  | `--ui-line-height-tight` |
70
+ | `--ui-on-accent` |
70
71
  | `--ui-primary` |
71
72
  | `--ui-radius-sm` |
72
73
  | `--ui-success` |
@@ -114,6 +114,9 @@ literal values are migrated onto them.
114
114
  row-driven height. Unsupported controls keep the normal external label.
115
115
  - Icons are `14px` inline (next to text) and `18px` standalone; icon-only tap
116
116
  targets are `32px`.
117
+ - Icons come from the generated Heroicons catalog (`icons.js`; `docs/icons.md`);
118
+ add new names through `scripts/generate-icons.mjs` and `npm run icons`, not
119
+ ad hoc inline SVGs.
117
120
  - Control corners use `--ui-radius-sm` (4px); enclosing surfaces use
118
121
  `--ui-radius` (8px).
119
122
  - Side panels use a `20rem` compact / `25rem` comfortable width; the shared
@@ -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
@@ -402,7 +402,7 @@ Import: `import "@f-ewald/components/calendar-day.js";`
402
402
 
403
403
  Properties: `date` (attribute `date`) : string, default —; `timeMarker` (attribute `time-marker`) : boolean, default false; `minWidth` (attribute `min-width`) : string, default ""
404
404
  Events: none
405
- CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
405
+ CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
406
406
 
407
407
  Example:
408
408
  ```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.0",
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",