@f-ewald/components 1.42.2 → 1.43.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 CHANGED
@@ -91,6 +91,7 @@ import "@f-ewald/components/roman-numeral.js";
91
91
  | `<kanban-card>` | [API reference](https://f-ewald.github.io/components/docs/kanban-card.html) |
92
92
  | `<kanban-column>` | [API reference](https://f-ewald.github.io/components/docs/kanban-column.html) |
93
93
  | `<kbd-hint>` | [API reference](https://f-ewald.github.io/components/docs/kbd-hint.html) |
94
+ | `<kind-icon>` | [API reference](https://f-ewald.github.io/components/docs/kind-icon.html) |
94
95
  | `<link-card>` | [API reference](https://f-ewald.github.io/components/docs/link-card.html) |
95
96
  | `<live-timer>` | [API reference](https://f-ewald.github.io/components/docs/live-timer.html) |
96
97
  | `<load-more>` | [API reference](https://f-ewald.github.io/components/docs/load-more.html) |
@@ -139,6 +140,7 @@ import "@f-ewald/components/roman-numeral.js";
139
140
  | `<ui-admonition>` | [API reference](https://f-ewald.github.io/components/docs/ui-admonition.html) |
140
141
  | `<ui-button>` | [API reference](https://f-ewald.github.io/components/docs/ui-button.html) |
141
142
  | `<ui-checkbox>` | [API reference](https://f-ewald.github.io/components/docs/ui-checkbox.html) |
143
+ | `<ui-tooltip>` | [API reference](https://f-ewald.github.io/components/docs/ui-tooltip.html) |
142
144
  | `<user-avatar>` | [API reference](https://f-ewald.github.io/components/docs/user-avatar.html) |
143
145
  | `<video-player>` | [API reference](https://f-ewald.github.io/components/docs/video-player.html) |
144
146
  | `<vote-control>` | [API reference](https://f-ewald.github.io/components/docs/vote-control.html) |
@@ -1917,7 +1917,7 @@
1917
1917
  "declarations": [
1918
1918
  {
1919
1919
  "kind": "class",
1920
- "description": "Generic form-associated text input with a suggestion dropdown, for any\n\"type to filter a list of `{key, value}` options\" use case. Works as a\ndrop-in replacement for a plain `<input>` inside a `<form>`: set `name` on\nthe element itself and consumers keep reading\n`new FormData(form).get(name)` and calling `form.reset()` unchanged — the\nsubmitted value is the picked option's `value`, while `key` is available\nvia the `option-select` event and the `selectedOption` getter for cases\nthat need the underlying id rather than the display text.\n\nSupports two suggestion sources:\n- **API**: set `endpoint` to a URL that, given a `?<query-param>=<text>`\n query string, responds with a JSON array of `{key, value}` objects.\n Requests are debounced as the user types.\n- **Local array**: set `options` to a fixed `AutocompleteOption[]` and the\n component filters it client-side instead of making any network\n request. Useful for small/fixed lists, offline use, or tests. Takes\n priority over `endpoint` whenever it's non-null.\n\nSet `clearable` to show an in-field clear action whenever a value is\npresent.",
1920
+ "description": "Generic form-associated text input with a suggestion dropdown, for any\n\"type to filter a list of `{key, value}` options\" use case. Works as a\ndrop-in replacement for a plain `<input>` inside a `<form>`: set `name` on\nthe element itself and consumers keep reading\n`new FormData(form).get(name)` and calling `form.reset()` unchanged — the\nsubmitted value is the picked option's `value`, while `key` is available\nvia the `option-select` event and the `selectedOption` getter for cases\nthat need the underlying id rather than the display text.\n\nSupports two suggestion sources:\n- **API**: set `endpoint` to a URL that, given a `?<query-param>=<text>`\n query string, responds with a JSON array of `{key, value}` objects.\n Requests are debounced as the user types.\n- **Local array**: set `options` to a fixed `AutocompleteOption[]` and the\n component filters it client-side instead of making any network\n request. Useful for small/fixed lists, offline use, or tests. Takes\n priority over `endpoint` whenever it's non-null.\n\nEach option may also carry a pre-rendered `icon` (shown before the value)\nand a `description` (a smaller, muted line under the value); options\nwithout them render as a plain value.\n\nSet `clearable` to show an in-field clear action whenever a value is\npresent.",
1921
1921
  "name": "AutocompleteInput",
1922
1922
  "members": [
1923
1923
  {
@@ -7347,7 +7347,7 @@
7347
7347
  "declarations": [
7348
7348
  {
7349
7349
  "kind": "class",
7350
- "description": "A generic, presentational table shell: renders a `<thead>` from `columns`\nand one `<tr>` per entry in `rows`, with each cell's content produced by\n`renderCell` (default: plain property lookup on the row object). Knows\nnothing about what a \"row\" means — callers own the data shape entirely.\n\nOptional `rowHref` makes whole rows clickable (navigating via `location.hash`),\nwithout hijacking clicks on nested interactive elements (links/buttons) a\ncell's rendered content might contain.",
7350
+ "description": "A generic, presentational table shell: renders a `<thead>` from `columns`\nand one `<tr>` per entry in `rows`, with each cell's content produced by\n`renderCell` (default: plain property lookup on the row object). Knows\nnothing about what a \"row\" means — callers own the data shape entirely.\n\nEach column may add a decorative header `icon` and an `align` for its\nheader and cells (`end` right-aligns numbers, with tabular figures).\n\nOptional `rowHref` makes whole rows clickable (navigating via `location.hash`),\nwithout hijacking clicks on nested interactive elements (links/buttons) a\ncell's rendered content might contain.",
7351
7351
  "name": "DataTable",
7352
7352
  "members": [
7353
7353
  {
@@ -7450,6 +7450,24 @@
7450
7450
  }
7451
7451
  ]
7452
7452
  },
7453
+ {
7454
+ "kind": "method",
7455
+ "name": "#alignClass",
7456
+ "privacy": "private",
7457
+ "return": {
7458
+ "type": {
7459
+ "text": "string"
7460
+ }
7461
+ },
7462
+ "parameters": [
7463
+ {
7464
+ "name": "column",
7465
+ "type": {
7466
+ "text": "DataTableColumn"
7467
+ }
7468
+ }
7469
+ ]
7470
+ },
7453
7471
  {
7454
7472
  "kind": "method",
7455
7473
  "name": "#rowLinkLabel",
@@ -12241,6 +12259,22 @@
12241
12259
  "module": "./ui-checkbox.js"
12242
12260
  }
12243
12261
  },
12262
+ {
12263
+ "kind": "js",
12264
+ "name": "UiTooltip",
12265
+ "declaration": {
12266
+ "name": "UiTooltip",
12267
+ "module": "./ui-tooltip.js"
12268
+ }
12269
+ },
12270
+ {
12271
+ "kind": "js",
12272
+ "name": "UiTooltipPlacement",
12273
+ "declaration": {
12274
+ "name": "UiTooltipPlacement",
12275
+ "module": "./ui-tooltip.js"
12276
+ }
12277
+ },
12244
12278
  {
12245
12279
  "kind": "js",
12246
12280
  "name": "FormField",
@@ -12297,6 +12331,14 @@
12297
12331
  "module": "./data-table.js"
12298
12332
  }
12299
12333
  },
12334
+ {
12335
+ "kind": "js",
12336
+ "name": "DataTableAlign",
12337
+ "declaration": {
12338
+ "name": "DataTableAlign",
12339
+ "module": "./data-table.js"
12340
+ }
12341
+ },
12300
12342
  {
12301
12343
  "kind": "js",
12302
12344
  "name": "DataTableColumn",
@@ -12385,6 +12427,22 @@
12385
12427
  "module": "./kbd-hint.js"
12386
12428
  }
12387
12429
  },
12430
+ {
12431
+ "kind": "js",
12432
+ "name": "KindIcon",
12433
+ "declaration": {
12434
+ "name": "KindIcon",
12435
+ "module": "./kind-icon.js"
12436
+ }
12437
+ },
12438
+ {
12439
+ "kind": "js",
12440
+ "name": "KindIconStyle",
12441
+ "declaration": {
12442
+ "name": "KindIconStyle",
12443
+ "module": "./kind-icon.js"
12444
+ }
12445
+ },
12388
12446
  {
12389
12447
  "kind": "js",
12390
12448
  "name": "FrameBox",
@@ -14068,6 +14126,113 @@
14068
14126
  }
14069
14127
  ]
14070
14128
  },
14129
+ {
14130
+ "kind": "javascript-module",
14131
+ "path": "src/kind-icon.ts",
14132
+ "declarations": [
14133
+ {
14134
+ "kind": "class",
14135
+ "description": "Inline icon for a named kind (e.g. a service, a library, an external\npackage), looked up in a shared `kinds` map so tables, lists, and search\nresults show the same icon and color as a `dag-graph` legend. With\n`show-label` the kind's label follows the icon as text; otherwise the\nicon alone is exposed as an image named by the label. Renders nothing for\na kind missing from `kinds`.",
14136
+ "name": "KindIcon",
14137
+ "members": [
14138
+ {
14139
+ "kind": "field",
14140
+ "name": "kind",
14141
+ "type": {
14142
+ "text": "string"
14143
+ },
14144
+ "default": "\"\"",
14145
+ "description": "Key of the kind to show, looked up in `kinds`.",
14146
+ "attribute": "kind",
14147
+ "reflects": true
14148
+ },
14149
+ {
14150
+ "kind": "field",
14151
+ "name": "kinds",
14152
+ "type": {
14153
+ "text": "Record<string, KindIconStyle>"
14154
+ },
14155
+ "default": "{}",
14156
+ "description": "Presentation per kind: label, color, and icon. Shareable with `dag-graph`'s `kinds`."
14157
+ },
14158
+ {
14159
+ "kind": "field",
14160
+ "name": "size",
14161
+ "type": {
14162
+ "text": "14 | 18"
14163
+ },
14164
+ "default": "14",
14165
+ "description": "Square icon size in pixels: 14 inline, 18 standalone.",
14166
+ "attribute": "size"
14167
+ },
14168
+ {
14169
+ "kind": "field",
14170
+ "name": "showLabel",
14171
+ "type": {
14172
+ "text": "boolean"
14173
+ },
14174
+ "default": "false",
14175
+ "description": "Shows the kind's label as text after the icon.",
14176
+ "attribute": "show-label",
14177
+ "reflects": true
14178
+ }
14179
+ ],
14180
+ "attributes": [
14181
+ {
14182
+ "name": "kind",
14183
+ "type": {
14184
+ "text": "string"
14185
+ },
14186
+ "default": "\"\"",
14187
+ "description": "Key of the kind to show, looked up in `kinds`.",
14188
+ "fieldName": "kind"
14189
+ },
14190
+ {
14191
+ "name": "size",
14192
+ "type": {
14193
+ "text": "14 | 18"
14194
+ },
14195
+ "default": "14",
14196
+ "description": "Square icon size in pixels: 14 inline, 18 standalone.",
14197
+ "fieldName": "size"
14198
+ },
14199
+ {
14200
+ "name": "show-label",
14201
+ "type": {
14202
+ "text": "boolean"
14203
+ },
14204
+ "default": "false",
14205
+ "description": "Shows the kind's label as text after the icon.",
14206
+ "fieldName": "showLabel"
14207
+ }
14208
+ ],
14209
+ "superclass": {
14210
+ "name": "LitElement",
14211
+ "package": "lit"
14212
+ },
14213
+ "tagName": "kind-icon",
14214
+ "customElement": true
14215
+ }
14216
+ ],
14217
+ "exports": [
14218
+ {
14219
+ "kind": "js",
14220
+ "name": "KindIcon",
14221
+ "declaration": {
14222
+ "name": "KindIcon",
14223
+ "module": "src/kind-icon.ts"
14224
+ }
14225
+ },
14226
+ {
14227
+ "kind": "custom-element-definition",
14228
+ "name": "kind-icon",
14229
+ "declaration": {
14230
+ "name": "KindIcon",
14231
+ "module": "src/kind-icon.ts"
14232
+ }
14233
+ }
14234
+ ]
14235
+ },
14071
14236
  {
14072
14237
  "kind": "javascript-module",
14073
14238
  "path": "src/link-card.ts",
@@ -22982,6 +23147,416 @@
22982
23147
  }
22983
23148
  ]
22984
23149
  },
23150
+ {
23151
+ "kind": "javascript-module",
23152
+ "path": "src/ui-tooltip.ts",
23153
+ "declarations": [
23154
+ {
23155
+ "kind": "class",
23156
+ "description": "Hover and focus tooltip for its default-slot trigger. The `content` slot\nholds the tooltip body — plain text or rich markup such as a list. It\nappears after `show-delay` on hover and at once on keyboard focus, stays\nopen while the pointer is over the tooltip itself, and closes on Escape,\nblur, or when the pointer leaves. It renders in the top layer, so\nscrolling or `overflow: hidden` ancestors never clip it.\n\nThe trigger is described by the content (`aria-describedby`). A trigger\nwith nothing focusable inside (e.g. plain text) makes the tooltip host\nfocusable so keyboard users can reach the description too. ARIA references\ncan't cross shadow roots, so when the trigger is a custom element whose\nfocusable control lives in its own shadow root, screen readers won't\nannounce the description on focus; prefer a native trigger such as\n`<button>` when that matters.",
23157
+ "name": "UiTooltip",
23158
+ "cssParts": [
23159
+ {
23160
+ "description": "The floating tooltip surface.",
23161
+ "name": "tooltip"
23162
+ }
23163
+ ],
23164
+ "slots": [
23165
+ {
23166
+ "description": "The trigger the tooltip describes.",
23167
+ "name": ""
23168
+ },
23169
+ {
23170
+ "description": "The tooltip body.",
23171
+ "name": "content"
23172
+ }
23173
+ ],
23174
+ "members": [
23175
+ {
23176
+ "kind": "field",
23177
+ "name": "placement",
23178
+ "type": {
23179
+ "text": "UiTooltipPlacement"
23180
+ },
23181
+ "default": "\"top\"",
23182
+ "description": "Preferred side of the trigger; flips to the other side when this one lacks room.",
23183
+ "attribute": "placement",
23184
+ "reflects": true
23185
+ },
23186
+ {
23187
+ "kind": "field",
23188
+ "name": "showDelay",
23189
+ "type": {
23190
+ "text": "number"
23191
+ },
23192
+ "default": "300",
23193
+ "description": "Hover delay in milliseconds before the tooltip appears; keyboard focus shows it at once.",
23194
+ "attribute": "show-delay"
23195
+ },
23196
+ {
23197
+ "kind": "field",
23198
+ "name": "disabled",
23199
+ "type": {
23200
+ "text": "boolean"
23201
+ },
23202
+ "default": "false",
23203
+ "description": "Suppresses the tooltip and closes it if open.",
23204
+ "attribute": "disabled",
23205
+ "reflects": true
23206
+ },
23207
+ {
23208
+ "kind": "field",
23209
+ "name": "_open",
23210
+ "type": {
23211
+ "text": "boolean"
23212
+ },
23213
+ "privacy": "private",
23214
+ "default": "false"
23215
+ },
23216
+ {
23217
+ "kind": "field",
23218
+ "name": "_tooltip",
23219
+ "type": {
23220
+ "text": "HTMLElement"
23221
+ },
23222
+ "privacy": "private"
23223
+ },
23224
+ {
23225
+ "kind": "field",
23226
+ "name": "#showTimer",
23227
+ "privacy": "private",
23228
+ "type": {
23229
+ "text": "ReturnType<typeof setTimeout> | null"
23230
+ },
23231
+ "default": "null"
23232
+ },
23233
+ {
23234
+ "kind": "field",
23235
+ "name": "#hideTimer",
23236
+ "privacy": "private",
23237
+ "type": {
23238
+ "text": "ReturnType<typeof setTimeout> | null"
23239
+ },
23240
+ "default": "null"
23241
+ },
23242
+ {
23243
+ "kind": "field",
23244
+ "name": "#describedTarget",
23245
+ "privacy": "private",
23246
+ "type": {
23247
+ "text": "HTMLElement | null"
23248
+ },
23249
+ "default": "null"
23250
+ },
23251
+ {
23252
+ "kind": "field",
23253
+ "name": "#describedId",
23254
+ "privacy": "private",
23255
+ "type": {
23256
+ "text": "string | null"
23257
+ },
23258
+ "default": "null"
23259
+ },
23260
+ {
23261
+ "kind": "field",
23262
+ "name": "#content",
23263
+ "privacy": "private",
23264
+ "type": {
23265
+ "text": "HTMLElement | null"
23266
+ },
23267
+ "default": "null"
23268
+ },
23269
+ {
23270
+ "kind": "field",
23271
+ "name": "#madeFocusable",
23272
+ "privacy": "private",
23273
+ "type": {
23274
+ "text": "boolean"
23275
+ },
23276
+ "default": "false"
23277
+ },
23278
+ {
23279
+ "kind": "field",
23280
+ "name": "#contentId",
23281
+ "privacy": "private",
23282
+ "readonly": true,
23283
+ "default": "`ui-tooltip-content-${++instanceCount}`"
23284
+ },
23285
+ {
23286
+ "kind": "field",
23287
+ "name": "open",
23288
+ "type": {
23289
+ "text": "boolean"
23290
+ },
23291
+ "description": "Whether the tooltip is currently showing.",
23292
+ "readonly": true
23293
+ },
23294
+ {
23295
+ "kind": "method",
23296
+ "name": "#scheduleShow",
23297
+ "privacy": "private",
23298
+ "return": {
23299
+ "type": {
23300
+ "text": "void"
23301
+ }
23302
+ },
23303
+ "parameters": [
23304
+ {
23305
+ "name": "delay",
23306
+ "type": {
23307
+ "text": "number"
23308
+ }
23309
+ }
23310
+ ]
23311
+ },
23312
+ {
23313
+ "kind": "method",
23314
+ "name": "#scheduleHide",
23315
+ "privacy": "private",
23316
+ "return": {
23317
+ "type": {
23318
+ "text": "void"
23319
+ }
23320
+ },
23321
+ "parameters": [
23322
+ {
23323
+ "name": "delay",
23324
+ "type": {
23325
+ "text": "number"
23326
+ }
23327
+ },
23328
+ {
23329
+ "name": "keepOpenWhile",
23330
+ "type": {
23331
+ "text": "string"
23332
+ }
23333
+ }
23334
+ ],
23335
+ "description": "Hides after `delay` unless the host still matches `keepOpenWhile` (still hovered or focused)."
23336
+ },
23337
+ {
23338
+ "kind": "method",
23339
+ "name": "#clearTimers",
23340
+ "privacy": "private",
23341
+ "return": {
23342
+ "type": {
23343
+ "text": "void"
23344
+ }
23345
+ }
23346
+ },
23347
+ {
23348
+ "kind": "method",
23349
+ "name": "#setOpen",
23350
+ "privacy": "private",
23351
+ "return": {
23352
+ "type": {
23353
+ "text": "void"
23354
+ }
23355
+ },
23356
+ "parameters": [
23357
+ {
23358
+ "name": "open",
23359
+ "type": {
23360
+ "text": "boolean"
23361
+ }
23362
+ }
23363
+ ]
23364
+ },
23365
+ {
23366
+ "kind": "field",
23367
+ "name": "#onDocumentKeydown",
23368
+ "privacy": "private",
23369
+ "description": "Escape closes the tooltip without dismissing anything else (WCAG 1.4.13)."
23370
+ },
23371
+ {
23372
+ "kind": "field",
23373
+ "name": "#onViewportChange",
23374
+ "privacy": "private"
23375
+ },
23376
+ {
23377
+ "kind": "method",
23378
+ "name": "#position",
23379
+ "privacy": "private",
23380
+ "return": {
23381
+ "type": {
23382
+ "text": "void"
23383
+ }
23384
+ },
23385
+ "description": "Places the tooltip beside the host, flipping sides and clamping it inside the viewport."
23386
+ },
23387
+ {
23388
+ "kind": "method",
23389
+ "name": "#onTriggerSlotChange",
23390
+ "privacy": "private",
23391
+ "return": {
23392
+ "type": {
23393
+ "text": "Promise<void>"
23394
+ }
23395
+ },
23396
+ "parameters": [
23397
+ {
23398
+ "name": "event",
23399
+ "type": {
23400
+ "text": "Event"
23401
+ }
23402
+ }
23403
+ ]
23404
+ },
23405
+ {
23406
+ "kind": "method",
23407
+ "name": "#onContentSlotChange",
23408
+ "privacy": "private",
23409
+ "return": {
23410
+ "type": {
23411
+ "text": "void"
23412
+ }
23413
+ },
23414
+ "parameters": [
23415
+ {
23416
+ "name": "event",
23417
+ "type": {
23418
+ "text": "Event"
23419
+ }
23420
+ }
23421
+ ]
23422
+ },
23423
+ {
23424
+ "kind": "method",
23425
+ "name": "#describe",
23426
+ "privacy": "private",
23427
+ "return": {
23428
+ "type": {
23429
+ "text": "void"
23430
+ }
23431
+ },
23432
+ "parameters": [
23433
+ {
23434
+ "name": "target",
23435
+ "type": {
23436
+ "text": "HTMLElement | null"
23437
+ }
23438
+ }
23439
+ ],
23440
+ "description": "Points the trigger's `aria-describedby` at the content, replacing this tooltip's previous reference."
23441
+ },
23442
+ {
23443
+ "kind": "method",
23444
+ "name": "#describedIds",
23445
+ "privacy": "private",
23446
+ "return": {
23447
+ "type": {
23448
+ "text": "string[]"
23449
+ }
23450
+ },
23451
+ "parameters": [
23452
+ {
23453
+ "name": "target",
23454
+ "type": {
23455
+ "text": "HTMLElement"
23456
+ }
23457
+ }
23458
+ ],
23459
+ "description": "The target's `aria-describedby` ids, minus the one this tooltip added."
23460
+ },
23461
+ {
23462
+ "kind": "method",
23463
+ "name": "#setDescribedBy",
23464
+ "privacy": "private",
23465
+ "return": {
23466
+ "type": {
23467
+ "text": "void"
23468
+ }
23469
+ },
23470
+ "parameters": [
23471
+ {
23472
+ "name": "target",
23473
+ "type": {
23474
+ "text": "HTMLElement"
23475
+ }
23476
+ },
23477
+ {
23478
+ "name": "ids",
23479
+ "type": {
23480
+ "text": "string[]"
23481
+ }
23482
+ }
23483
+ ]
23484
+ },
23485
+ {
23486
+ "kind": "method",
23487
+ "name": "#updateFocusability",
23488
+ "privacy": "private",
23489
+ "return": {
23490
+ "type": {
23491
+ "text": "void"
23492
+ }
23493
+ },
23494
+ "parameters": [
23495
+ {
23496
+ "name": "needed",
23497
+ "type": {
23498
+ "text": "boolean"
23499
+ }
23500
+ }
23501
+ ]
23502
+ }
23503
+ ],
23504
+ "attributes": [
23505
+ {
23506
+ "name": "placement",
23507
+ "type": {
23508
+ "text": "UiTooltipPlacement"
23509
+ },
23510
+ "default": "\"top\"",
23511
+ "description": "Preferred side of the trigger; flips to the other side when this one lacks room.",
23512
+ "fieldName": "placement"
23513
+ },
23514
+ {
23515
+ "name": "show-delay",
23516
+ "type": {
23517
+ "text": "number"
23518
+ },
23519
+ "default": "300",
23520
+ "description": "Hover delay in milliseconds before the tooltip appears; keyboard focus shows it at once.",
23521
+ "fieldName": "showDelay"
23522
+ },
23523
+ {
23524
+ "name": "disabled",
23525
+ "type": {
23526
+ "text": "boolean"
23527
+ },
23528
+ "default": "false",
23529
+ "description": "Suppresses the tooltip and closes it if open.",
23530
+ "fieldName": "disabled"
23531
+ }
23532
+ ],
23533
+ "superclass": {
23534
+ "name": "LitElement",
23535
+ "package": "lit"
23536
+ },
23537
+ "tagName": "ui-tooltip",
23538
+ "customElement": true
23539
+ }
23540
+ ],
23541
+ "exports": [
23542
+ {
23543
+ "kind": "js",
23544
+ "name": "UiTooltip",
23545
+ "declaration": {
23546
+ "name": "UiTooltip",
23547
+ "module": "src/ui-tooltip.ts"
23548
+ }
23549
+ },
23550
+ {
23551
+ "kind": "custom-element-definition",
23552
+ "name": "ui-tooltip",
23553
+ "declaration": {
23554
+ "name": "UiTooltip",
23555
+ "module": "src/ui-tooltip.ts"
23556
+ }
23557
+ }
23558
+ ]
23559
+ },
22985
23560
  {
22986
23561
  "kind": "javascript-module",
22987
23562
  "path": "src/user-avatar.ts",
@@ -1,9 +1,13 @@
1
- import { LitElement, type PropertyValues } from "lit";
1
+ import { LitElement, type PropertyValues, type TemplateResult } from "lit";
2
2
  import { formFieldControl, type FormFieldControlConfig } from "./utils/form-field-control.js";
3
3
  /** A single autocomplete candidate: an opaque `key` plus its display `value`. */
4
4
  export interface AutocompleteOption {
5
5
  key: string;
6
6
  value: string;
7
+ /** Optional pre-rendered icon shown before the value, e.g. `iconServer(14)`. Local `options` only — not JSON-serializable. */
8
+ icon?: TemplateResult;
9
+ /** Optional secondary line shown under the value in smaller, muted text. Not matched when filtering. */
10
+ description?: string;
7
11
  }
8
12
  /**
9
13
  * Generic form-associated text input with a suggestion dropdown, for any
@@ -24,6 +28,10 @@ export interface AutocompleteOption {
24
28
  * request. Useful for small/fixed lists, offline use, or tests. Takes
25
29
  * priority over `endpoint` whenever it's non-null.
26
30
  *
31
+ * Each option may also carry a pre-rendered `icon` (shown before the value)
32
+ * and a `description` (a smaller, muted line under the value); options
33
+ * without them render as a plain value.
34
+ *
27
35
  * Set `clearable` to show an in-field clear action whenever a value is
28
36
  * present.
29
37
  *
@@ -85,7 +93,7 @@ export declare class AutocompleteInput extends LitElement {
85
93
  private onCompositionStart;
86
94
  private onCompositionEnd;
87
95
  private renderSuggestions;
88
- render(): import("lit-html").TemplateResult<1>;
96
+ render(): TemplateResult<1>;
89
97
  }
90
98
  declare global {
91
99
  interface HTMLElementTagNameMap {