@f-ewald/components 1.22.0 → 1.23.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.
Files changed (45) hide show
  1. package/custom-elements.json +656 -9
  2. package/dist/address-autocomplete.d.ts +14 -0
  3. package/dist/address-autocomplete.d.ts.map +1 -1
  4. package/dist/address-autocomplete.js +205 -3
  5. package/dist/address-autocomplete.js.map +1 -1
  6. package/dist/autocomplete-input.d.ts +14 -0
  7. package/dist/autocomplete-input.d.ts.map +1 -1
  8. package/dist/autocomplete-input.js +205 -3
  9. package/dist/autocomplete-input.js.map +1 -1
  10. package/dist/dropdown-button.d.ts +22 -7
  11. package/dist/dropdown-button.d.ts.map +1 -1
  12. package/dist/dropdown-button.js +74 -15
  13. package/dist/dropdown-button.js.map +1 -1
  14. package/dist/form-field.d.ts +29 -1
  15. package/dist/form-field.d.ts.map +1 -1
  16. package/dist/form-field.js +376 -4
  17. package/dist/form-field.js.map +1 -1
  18. package/dist/icons.d.ts +1 -0
  19. package/dist/icons.d.ts.map +1 -1
  20. package/dist/icons.js +1 -0
  21. package/dist/icons.js.map +1 -1
  22. package/dist/index.d.ts +1 -1
  23. package/dist/index.d.ts.map +1 -1
  24. package/dist/index.js +1 -1
  25. package/dist/index.js.map +1 -1
  26. package/dist/text-area.d.ts +9 -0
  27. package/dist/text-area.d.ts.map +1 -1
  28. package/dist/text-area.js +123 -11
  29. package/dist/text-area.js.map +1 -1
  30. package/dist/timeline-entry.d.ts.map +1 -1
  31. package/dist/timeline-entry.js +32 -11
  32. package/dist/timeline-entry.js.map +1 -1
  33. package/dist/utils/form-field-control.d.ts +15 -0
  34. package/dist/utils/form-field-control.d.ts.map +1 -0
  35. package/dist/utils/form-field-control.js +7 -0
  36. package/dist/utils/form-field-control.js.map +1 -0
  37. package/docs/address-autocomplete.md +9 -0
  38. package/docs/autocomplete-input.md +9 -1
  39. package/docs/design-language.md +11 -0
  40. package/docs/dropdown-button.md +26 -6
  41. package/docs/form-field.md +18 -0
  42. package/docs/text-area.md +9 -1
  43. package/docs/timeline-entry.md +1 -0
  44. package/llms.txt +55 -19
  45. package/package.json +1 -1
@@ -54,7 +54,7 @@
54
54
  "declarations": [
55
55
  {
56
56
  "kind": "class",
57
- "description": "Form-associated text input with a suggestion dropdown. Works as a\ndrop-in replacement for a plain `<input name=\"address\">`: consumers keep\nreading `new FormData(form).get(\"address\")` and calling `form.reset()`\nunchanged.\n\nSupports two suggestion sources:\n- **API** (default): fetches from `endpoint`, a Mapbox Geocoding v6-shaped\n forward-geocode URL, debounced as the user types.\n- **Local array**: set `suggestions` to a fixed `AddressSuggestion[]` and\n the component filters it client-side instead of making any network\n request. Useful for small/fixed address lists, offline use, or tests.\n Takes priority over `endpoint` whenever it's non-null.",
57
+ "description": "Form-associated text input with a suggestion dropdown. Works as a\ndrop-in replacement for a plain `<input name=\"address\">`: consumers keep\nreading `new FormData(form).get(\"address\")` and calling `form.reset()`\nunchanged.\n\nSupports two suggestion sources:\n- **API** (default): fetches from `endpoint`, a Mapbox Geocoding v6-shaped\n forward-geocode URL, debounced as the user types.\n- **Local array**: set `suggestions` to a fixed `AddressSuggestion[]` and\n the component filters it client-side instead of making any network\n request. Useful for small/fixed address lists, offline use, or tests.\n Takes priority over `endpoint` whenever it's non-null.\n\nSet `clearable` to show an in-field clear action whenever a value is\npresent.",
58
58
  "name": "AddressAutocomplete",
59
59
  "members": [
60
60
  {
@@ -107,6 +107,17 @@
107
107
  "attribute": "disabled",
108
108
  "reflects": true
109
109
  },
110
+ {
111
+ "kind": "field",
112
+ "name": "clearable",
113
+ "type": {
114
+ "text": "boolean"
115
+ },
116
+ "default": "false",
117
+ "description": "Shows an in-field clear action while the control has a value.",
118
+ "attribute": "clearable",
119
+ "reflects": true
120
+ },
110
121
  {
111
122
  "kind": "field",
112
123
  "name": "types",
@@ -222,6 +233,23 @@
222
233
  "privacy": "private",
223
234
  "default": "false"
224
235
  },
236
+ {
237
+ "kind": "field",
238
+ "name": "_formFieldConfig",
239
+ "type": {
240
+ "text": "FormFieldControlConfig | null"
241
+ },
242
+ "privacy": "private",
243
+ "default": "null"
244
+ },
245
+ {
246
+ "kind": "field",
247
+ "name": "_input",
248
+ "type": {
249
+ "text": "HTMLInputElement | undefined"
250
+ },
251
+ "privacy": "private"
252
+ },
225
253
  {
226
254
  "kind": "field",
227
255
  "name": "#internals",
@@ -281,12 +309,19 @@
281
309
  },
282
310
  "default": "null"
283
311
  },
312
+ {
313
+ "kind": "field",
314
+ "name": "#inputId",
315
+ "privacy": "private",
316
+ "readonly": true,
317
+ "default": "`address-autocomplete-field-${++instanceCount}`"
318
+ },
284
319
  {
285
320
  "kind": "field",
286
321
  "name": "#listboxId",
287
322
  "privacy": "private",
288
323
  "readonly": true,
289
- "default": "`address-autocomplete-listbox-${++instanceCount}`"
324
+ "default": "`address-autocomplete-listbox-${instanceCount}`"
290
325
  },
291
326
  {
292
327
  "kind": "field",
@@ -307,6 +342,25 @@
307
342
  "description": "Last-picked suggestion, or null once the input diverges from it.",
308
343
  "readonly": true
309
344
  },
345
+ {
346
+ "kind": "method",
347
+ "name": "[formFieldControl]",
348
+ "return": {
349
+ "type": {
350
+ "text": "void"
351
+ }
352
+ },
353
+ "parameters": [
354
+ {
355
+ "name": "config",
356
+ "type": {
357
+ "text": "FormFieldControlConfig | null"
358
+ }
359
+ }
360
+ ],
361
+ "description": "Applies or clears label configuration supplied by a wrapping `form-field`.",
362
+ "privacy": "private"
363
+ },
310
364
  {
311
365
  "kind": "method",
312
366
  "name": "formResetCallback",
@@ -504,6 +558,17 @@
504
558
  }
505
559
  ]
506
560
  },
561
+ {
562
+ "kind": "method",
563
+ "name": "#clear",
564
+ "privacy": "private",
565
+ "return": {
566
+ "type": {
567
+ "text": "void"
568
+ }
569
+ },
570
+ "description": "Clears the field and all pending autocomplete state, then restores input focus."
571
+ },
507
572
  {
508
573
  "kind": "method",
509
574
  "name": "#onSuggestionMousedown",
@@ -537,6 +602,13 @@
537
602
  "text": "CustomEvent"
538
603
  },
539
604
  "description": "A suggestion was picked; detail: AddressSuggestion."
605
+ },
606
+ {
607
+ "name": "input",
608
+ "type": {
609
+ "text": "InputEvent"
610
+ },
611
+ "description": "Native-compatible input event fired while editing or clearing."
540
612
  }
541
613
  ],
542
614
  "attributes": [
@@ -576,6 +648,15 @@
576
648
  "description": "Disables the input and closes its suggestion popup.",
577
649
  "fieldName": "disabled"
578
650
  },
651
+ {
652
+ "name": "clearable",
653
+ "type": {
654
+ "text": "boolean"
655
+ },
656
+ "default": "false",
657
+ "description": "Shows an in-field clear action while the control has a value.",
658
+ "fieldName": "clearable"
659
+ },
579
660
  {
580
661
  "name": "types",
581
662
  "type": {
@@ -1463,7 +1544,7 @@
1463
1544
  "declarations": [
1464
1545
  {
1465
1546
  "kind": "class",
1466
- "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.",
1547
+ "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.",
1467
1548
  "name": "AutocompleteInput",
1468
1549
  "members": [
1469
1550
  {
@@ -1516,6 +1597,17 @@
1516
1597
  "attribute": "disabled",
1517
1598
  "reflects": true
1518
1599
  },
1600
+ {
1601
+ "kind": "field",
1602
+ "name": "clearable",
1603
+ "type": {
1604
+ "text": "boolean"
1605
+ },
1606
+ "default": "false",
1607
+ "description": "Shows an in-field clear action while the control has a value.",
1608
+ "attribute": "clearable",
1609
+ "reflects": true
1610
+ },
1519
1611
  {
1520
1612
  "kind": "field",
1521
1613
  "name": "endpoint",
@@ -1601,6 +1693,23 @@
1601
1693
  "privacy": "private",
1602
1694
  "default": "false"
1603
1695
  },
1696
+ {
1697
+ "kind": "field",
1698
+ "name": "_formFieldConfig",
1699
+ "type": {
1700
+ "text": "FormFieldControlConfig | null"
1701
+ },
1702
+ "privacy": "private",
1703
+ "default": "null"
1704
+ },
1705
+ {
1706
+ "kind": "field",
1707
+ "name": "_input",
1708
+ "type": {
1709
+ "text": "HTMLInputElement | undefined"
1710
+ },
1711
+ "privacy": "private"
1712
+ },
1604
1713
  {
1605
1714
  "kind": "field",
1606
1715
  "name": "#internals",
@@ -1660,12 +1769,19 @@
1660
1769
  },
1661
1770
  "default": "null"
1662
1771
  },
1772
+ {
1773
+ "kind": "field",
1774
+ "name": "#inputId",
1775
+ "privacy": "private",
1776
+ "readonly": true,
1777
+ "default": "`autocomplete-input-field-${++instanceCount}`"
1778
+ },
1663
1779
  {
1664
1780
  "kind": "field",
1665
1781
  "name": "#listboxId",
1666
1782
  "privacy": "private",
1667
1783
  "readonly": true,
1668
- "default": "`autocomplete-input-listbox-${++instanceCount}`"
1784
+ "default": "`autocomplete-input-listbox-${instanceCount}`"
1669
1785
  },
1670
1786
  {
1671
1787
  "kind": "field",
@@ -1686,6 +1802,25 @@
1686
1802
  "description": "Last-picked option, or null once the input diverges from it.",
1687
1803
  "readonly": true
1688
1804
  },
1805
+ {
1806
+ "kind": "method",
1807
+ "name": "[formFieldControl]",
1808
+ "return": {
1809
+ "type": {
1810
+ "text": "void"
1811
+ }
1812
+ },
1813
+ "parameters": [
1814
+ {
1815
+ "name": "config",
1816
+ "type": {
1817
+ "text": "FormFieldControlConfig | null"
1818
+ }
1819
+ }
1820
+ ],
1821
+ "description": "Applies or clears label configuration supplied by a wrapping `form-field`.",
1822
+ "privacy": "private"
1823
+ },
1689
1824
  {
1690
1825
  "kind": "method",
1691
1826
  "name": "formResetCallback",
@@ -1883,6 +2018,17 @@
1883
2018
  }
1884
2019
  ]
1885
2020
  },
2021
+ {
2022
+ "kind": "method",
2023
+ "name": "#clear",
2024
+ "privacy": "private",
2025
+ "return": {
2026
+ "type": {
2027
+ "text": "void"
2028
+ }
2029
+ },
2030
+ "description": "Clears the field and all pending autocomplete state, then restores input focus."
2031
+ },
1886
2032
  {
1887
2033
  "kind": "method",
1888
2034
  "name": "#onSuggestionMousedown",
@@ -1916,6 +2062,13 @@
1916
2062
  "text": "CustomEvent"
1917
2063
  },
1918
2064
  "description": "An option was picked; detail: AutocompleteOption."
2065
+ },
2066
+ {
2067
+ "name": "input",
2068
+ "type": {
2069
+ "text": "InputEvent"
2070
+ },
2071
+ "description": "Native-compatible input event fired while editing or clearing."
1919
2072
  }
1920
2073
  ],
1921
2074
  "attributes": [
@@ -1955,6 +2108,15 @@
1955
2108
  "description": "Disables the input and closes its suggestion popup.",
1956
2109
  "fieldName": "disabled"
1957
2110
  },
2111
+ {
2112
+ "name": "clearable",
2113
+ "type": {
2114
+ "text": "boolean"
2115
+ },
2116
+ "default": "false",
2117
+ "description": "Shows an in-field clear action while the control has a value.",
2118
+ "fieldName": "clearable"
2119
+ },
1958
2120
  {
1959
2121
  "name": "endpoint",
1960
2122
  "type": {
@@ -3881,7 +4043,7 @@
3881
4043
  "declarations": [
3882
4044
  {
3883
4045
  "kind": "class",
3884
- "description": "A primary-styled button with a label and chevron that opens an anchored\nmenu of actions — essentially `form-select` minus \"current value\"\nsemantics: a menu, not a select. Use for a set of mutually exclusive\nnext-step actions (e.g. a failed task's Retry / Close / Backlog).",
4046
+ "description": "A button that opens an anchored menu of actions — essentially `form-select`\nminus \"current value\" semantics: a menu, not a select. Use for a set of\nmutually exclusive next-step actions (e.g. a failed task's Retry / Close /\nBacklog, or a table row's overflow actions).\n\nThree trigger presentations share one base: `text` (the default — a\nprimary-filled button with a label and a rotating chevron), `text-icon`\n(the same, with `icon` ahead of the label), and `icon` (a borderless,\nsquare, low-emphasis icon target in the style of `icon-button` — the\nclassic \"three-dot\"/overflow menu, where `label` becomes the accessible\nname rather than visible text).",
3885
4047
  "name": "DropdownButton",
3886
4048
  "members": [
3887
4049
  {
@@ -3891,7 +4053,7 @@
3891
4053
  "text": "string"
3892
4054
  },
3893
4055
  "default": "\"\"",
3894
- "description": "The trigger button's label.",
4056
+ "description": "The trigger button's label. In the `icon` variant it is the accessible name instead of visible text.",
3895
4057
  "attribute": "label"
3896
4058
  },
3897
4059
  {
@@ -3913,6 +4075,26 @@
3913
4075
  "description": "Disables the trigger, preventing the menu from opening.",
3914
4076
  "attribute": "disabled"
3915
4077
  },
4078
+ {
4079
+ "kind": "field",
4080
+ "name": "variant",
4081
+ "type": {
4082
+ "text": "DropdownButtonVariant"
4083
+ },
4084
+ "default": "\"text\"",
4085
+ "description": "Trigger presentation: label only, icon only, or icon + label.",
4086
+ "attribute": "variant",
4087
+ "reflects": true
4088
+ },
4089
+ {
4090
+ "kind": "field",
4091
+ "name": "icon",
4092
+ "type": {
4093
+ "text": "TemplateResult | null"
4094
+ },
4095
+ "default": "null",
4096
+ "description": "Icon template rendered by the `icon` and `text-icon` variants."
4097
+ },
3916
4098
  {
3917
4099
  "kind": "field",
3918
4100
  "name": "_open",
@@ -4039,7 +4221,7 @@
4039
4221
  "text": "string"
4040
4222
  },
4041
4223
  "default": "\"\"",
4042
- "description": "The trigger button's label.",
4224
+ "description": "The trigger button's label. In the `icon` variant it is the accessible name instead of visible text.",
4043
4225
  "fieldName": "label"
4044
4226
  },
4045
4227
  {
@@ -4050,6 +4232,15 @@
4050
4232
  "default": "false",
4051
4233
  "description": "Disables the trigger, preventing the menu from opening.",
4052
4234
  "fieldName": "disabled"
4235
+ },
4236
+ {
4237
+ "name": "variant",
4238
+ "type": {
4239
+ "text": "DropdownButtonVariant"
4240
+ },
4241
+ "default": "\"text\"",
4242
+ "description": "Trigger presentation: label only, icon only, or icon + label.",
4243
+ "fieldName": "variant"
4053
4244
  }
4054
4245
  ],
4055
4246
  "superclass": {
@@ -4367,7 +4558,7 @@
4367
4558
  "declarations": [
4368
4559
  {
4369
4560
  "kind": "class",
4370
- "description": "Per-field wrapper for a form control: label, slotted control, and an\noptional hint or error message, in one consistent unit repeated across a\nform. Purely presentational — composes whatever control is slotted\n(`form-select`, `multi-select`, `autocomplete-input`, `ui-checkbox`, etc.)\nwithout intercepting its events or value.\n\nThe label wraps the default slot for a best-effort visual/click\nassociation only: every existing value-entry control encapsulates its\nreal `<input>` inside its own shadow DOM, so there is no light-DOM `id` a\n`for` attribute could target from outside, and this component cannot set\n`aria-describedby`/`aria-invalid` on an arbitrary slotted control's\nshadow-encapsulated input for the same reason. The error message uses\n`role=\"alert\"` as the practical accessibility mitigation instead of true\n`aria-describedby` association.",
4561
+ "description": "Per-field wrapper for a form control: label, slotted control, and an\noptional hint or error message, in one consistent unit repeated across a\nform. Purely presentational — composes whatever control is slotted\n(`form-select`, `multi-select`, `autocomplete-input`, `ui-checkbox`, etc.)\nwithout intercepting its events or value.\n\nSet `floating-label` for supported text controls (`input`, `textarea`,\n`autocomplete-input`, `address-autocomplete`, and `text-area`). The label\nthen rests inside an empty field and moves to a smaller top-left position\nwhile focused or non-empty. Other controls keep the external label.\n\nThe label wraps the default slot for a best-effort visual/click\nassociation only: every existing value-entry control encapsulates its\nreal `<input>` inside its own shadow DOM, so there is no light-DOM `id` a\n`for` attribute could target from outside, and this component cannot set\n`aria-describedby`/`aria-invalid` on an arbitrary slotted control's\nshadow-encapsulated input for the same reason. The error message uses\n`role=\"alert\"` as the practical accessibility mitigation instead of true\n`aria-describedby` association.",
4371
4562
  "name": "FormField",
4372
4563
  "slots": [
4373
4564
  {
@@ -4416,12 +4607,351 @@
4416
4607
  "description": "Shows a required indicator next to the label.",
4417
4608
  "attribute": "required"
4418
4609
  },
4610
+ {
4611
+ "kind": "field",
4612
+ "name": "floatingLabel",
4613
+ "type": {
4614
+ "text": "boolean"
4615
+ },
4616
+ "default": "false",
4617
+ "description": "Moves labels inside supported text controls until they receive focus or content.",
4618
+ "attribute": "floating-label",
4619
+ "reflects": true
4620
+ },
4621
+ {
4622
+ "kind": "field",
4623
+ "name": "_assignedElements",
4624
+ "type": {
4625
+ "text": "HTMLElement[]"
4626
+ },
4627
+ "privacy": "private",
4628
+ "readonly": true
4629
+ },
4630
+ {
4631
+ "kind": "field",
4632
+ "name": "_floatingKind",
4633
+ "type": {
4634
+ "text": "\"delegated\" | \"native\" | null"
4635
+ },
4636
+ "privacy": "private",
4637
+ "default": "null"
4638
+ },
4639
+ {
4640
+ "kind": "field",
4641
+ "name": "_nativeHasValue",
4642
+ "type": {
4643
+ "text": "boolean"
4644
+ },
4645
+ "privacy": "private",
4646
+ "default": "false"
4647
+ },
4419
4648
  {
4420
4649
  "kind": "field",
4421
4650
  "name": "#messageId",
4422
4651
  "privacy": "private",
4423
4652
  "readonly": true,
4424
4653
  "default": "`form-field-message-${++instanceCount}`"
4654
+ },
4655
+ {
4656
+ "kind": "field",
4657
+ "name": "#configuredControls",
4658
+ "privacy": "private",
4659
+ "default": "new Set<FormFieldControl>()"
4660
+ },
4661
+ {
4662
+ "kind": "field",
4663
+ "name": "#resetForm",
4664
+ "privacy": "private",
4665
+ "type": {
4666
+ "text": "HTMLFormElement | null"
4667
+ },
4668
+ "default": "null"
4669
+ },
4670
+ {
4671
+ "kind": "field",
4672
+ "name": "#placeholderControl",
4673
+ "privacy": "private",
4674
+ "type": {
4675
+ "text": "HTMLInputElement | HTMLTextAreaElement | null"
4676
+ },
4677
+ "default": "null"
4678
+ },
4679
+ {
4680
+ "kind": "field",
4681
+ "name": "#placeholder",
4682
+ "privacy": "private",
4683
+ "type": {
4684
+ "text": "string"
4685
+ },
4686
+ "default": "\"\""
4687
+ },
4688
+ {
4689
+ "kind": "field",
4690
+ "name": "#accessibleNameControl",
4691
+ "privacy": "private",
4692
+ "type": {
4693
+ "text": "HTMLInputElement | HTMLTextAreaElement | null"
4694
+ },
4695
+ "default": "null"
4696
+ },
4697
+ {
4698
+ "kind": "field",
4699
+ "name": "#accessibleName",
4700
+ "privacy": "private",
4701
+ "type": {
4702
+ "text": "string | null"
4703
+ },
4704
+ "default": "null"
4705
+ },
4706
+ {
4707
+ "kind": "field",
4708
+ "name": "#nativeEventControl",
4709
+ "privacy": "private",
4710
+ "type": {
4711
+ "text": "HTMLInputElement | HTMLTextAreaElement | null"
4712
+ },
4713
+ "default": "null"
4714
+ },
4715
+ {
4716
+ "kind": "field",
4717
+ "name": "#nativeFocused",
4718
+ "privacy": "private",
4719
+ "type": {
4720
+ "text": "boolean"
4721
+ },
4722
+ "default": "false"
4723
+ },
4724
+ {
4725
+ "kind": "field",
4726
+ "name": "#onNativeValueChange",
4727
+ "privacy": "private",
4728
+ "readonly": true
4729
+ },
4730
+ {
4731
+ "kind": "field",
4732
+ "name": "#onNativeFocus",
4733
+ "privacy": "private",
4734
+ "readonly": true
4735
+ },
4736
+ {
4737
+ "kind": "field",
4738
+ "name": "#onNativeBlur",
4739
+ "privacy": "private",
4740
+ "readonly": true
4741
+ },
4742
+ {
4743
+ "kind": "field",
4744
+ "name": "#onNativeAnimation",
4745
+ "privacy": "private",
4746
+ "readonly": true
4747
+ },
4748
+ {
4749
+ "kind": "field",
4750
+ "name": "#onFormReset",
4751
+ "privacy": "private",
4752
+ "readonly": true
4753
+ },
4754
+ {
4755
+ "kind": "method",
4756
+ "name": "_onSlotChange",
4757
+ "privacy": "private",
4758
+ "return": {
4759
+ "type": {
4760
+ "text": "void"
4761
+ }
4762
+ },
4763
+ "description": "Handles assigned-control changes and updates the floating-label strategy."
4764
+ },
4765
+ {
4766
+ "kind": "method",
4767
+ "name": "_onControlValueChange",
4768
+ "privacy": "private",
4769
+ "return": {
4770
+ "type": {
4771
+ "text": "void"
4772
+ }
4773
+ },
4774
+ "description": "Tracks native input/textarea content after user edits."
4775
+ },
4776
+ {
4777
+ "kind": "method",
4778
+ "name": "_onControlFocusIn",
4779
+ "privacy": "private",
4780
+ "return": {
4781
+ "type": {
4782
+ "text": "void"
4783
+ }
4784
+ },
4785
+ "description": "Reveals the native placeholder once focus floats the label."
4786
+ },
4787
+ {
4788
+ "kind": "method",
4789
+ "name": "_onControlFocusOut",
4790
+ "privacy": "private",
4791
+ "return": {
4792
+ "type": {
4793
+ "text": "void"
4794
+ }
4795
+ },
4796
+ "description": "Hides the native placeholder again when an empty field loses focus."
4797
+ },
4798
+ {
4799
+ "kind": "method",
4800
+ "name": "_onControlLabelClick",
4801
+ "privacy": "private",
4802
+ "return": {
4803
+ "type": {
4804
+ "text": "void"
4805
+ }
4806
+ },
4807
+ "parameters": [
4808
+ {
4809
+ "name": "event",
4810
+ "type": {
4811
+ "text": "MouseEvent"
4812
+ }
4813
+ }
4814
+ ],
4815
+ "description": "Focuses a native control when its shadow-rendered floating label is clicked."
4816
+ },
4817
+ {
4818
+ "kind": "method",
4819
+ "name": "_onNativeAnimationStart",
4820
+ "privacy": "private",
4821
+ "return": {
4822
+ "type": {
4823
+ "text": "void"
4824
+ }
4825
+ },
4826
+ "parameters": [
4827
+ {
4828
+ "name": "event",
4829
+ "type": {
4830
+ "text": "AnimationEvent"
4831
+ }
4832
+ }
4833
+ ],
4834
+ "description": "Synchronizes native value state when WebKit applies autofill without input events."
4835
+ },
4836
+ {
4837
+ "kind": "method",
4838
+ "name": "#nativeControl",
4839
+ "privacy": "private",
4840
+ "return": {
4841
+ "type": {
4842
+ "text": "HTMLInputElement | HTMLTextAreaElement | null"
4843
+ }
4844
+ },
4845
+ "description": "Finds the sole assigned native text control, if present."
4846
+ },
4847
+ {
4848
+ "kind": "method",
4849
+ "name": "#syncControls",
4850
+ "privacy": "private",
4851
+ "return": {
4852
+ "type": {
4853
+ "text": "void"
4854
+ }
4855
+ },
4856
+ "description": "Pushes current label configuration into a supported slotted control."
4857
+ },
4858
+ {
4859
+ "kind": "method",
4860
+ "name": "#updateNativeValue",
4861
+ "privacy": "private",
4862
+ "return": {
4863
+ "type": {
4864
+ "text": "void"
4865
+ }
4866
+ },
4867
+ "description": "Updates whether a native control currently contains a value."
4868
+ },
4869
+ {
4870
+ "kind": "method",
4871
+ "name": "#bindNativePlaceholder",
4872
+ "privacy": "private",
4873
+ "return": {
4874
+ "type": {
4875
+ "text": "void"
4876
+ }
4877
+ },
4878
+ "parameters": [
4879
+ {
4880
+ "name": "control",
4881
+ "type": {
4882
+ "text": "HTMLInputElement | HTMLTextAreaElement | null"
4883
+ }
4884
+ }
4885
+ ],
4886
+ "description": "Preserves the consumer placeholder while floating mode temporarily hides it."
4887
+ },
4888
+ {
4889
+ "kind": "method",
4890
+ "name": "#syncNativePlaceholder",
4891
+ "privacy": "private",
4892
+ "return": {
4893
+ "type": {
4894
+ "text": "void"
4895
+ }
4896
+ },
4897
+ "description": "Applies the correct placeholder for the native label's focus/value state."
4898
+ },
4899
+ {
4900
+ "kind": "method",
4901
+ "name": "#bindNativeAccessibleName",
4902
+ "privacy": "private",
4903
+ "return": {
4904
+ "type": {
4905
+ "text": "void"
4906
+ }
4907
+ },
4908
+ "parameters": [
4909
+ {
4910
+ "name": "control",
4911
+ "type": {
4912
+ "text": "HTMLInputElement | HTMLTextAreaElement | null"
4913
+ }
4914
+ }
4915
+ ],
4916
+ "description": "Applies a shadow-boundary-safe accessible name and restores any prior value."
4917
+ },
4918
+ {
4919
+ "kind": "method",
4920
+ "name": "#bindNativeEvents",
4921
+ "privacy": "private",
4922
+ "return": {
4923
+ "type": {
4924
+ "text": "void"
4925
+ }
4926
+ },
4927
+ "parameters": [
4928
+ {
4929
+ "name": "control",
4930
+ "type": {
4931
+ "text": "HTMLInputElement | HTMLTextAreaElement | null"
4932
+ }
4933
+ }
4934
+ ],
4935
+ "description": "Moves native field listeners directly between assigned controls."
4936
+ },
4937
+ {
4938
+ "kind": "method",
4939
+ "name": "#bindResetForm",
4940
+ "privacy": "private",
4941
+ "return": {
4942
+ "type": {
4943
+ "text": "void"
4944
+ }
4945
+ },
4946
+ "parameters": [
4947
+ {
4948
+ "name": "form",
4949
+ "type": {
4950
+ "text": "HTMLFormElement | null"
4951
+ }
4952
+ }
4953
+ ],
4954
+ "description": "Moves the reset listener to the native control's current owner form."
4425
4955
  }
4426
4956
  ],
4427
4957
  "attributes": [
@@ -4460,6 +4990,15 @@
4460
4990
  "default": "false",
4461
4991
  "description": "Shows a required indicator next to the label.",
4462
4992
  "fieldName": "required"
4993
+ },
4994
+ {
4995
+ "name": "floating-label",
4996
+ "type": {
4997
+ "text": "boolean"
4998
+ },
4999
+ "default": "false",
5000
+ "description": "Moves labels inside supported text controls until they receive focus or content.",
5001
+ "fieldName": "floatingLabel"
4463
5002
  }
4464
5003
  ],
4465
5004
  "superclass": {
@@ -5556,6 +6095,16 @@
5556
6095
  }
5557
6096
  ]
5558
6097
  },
6098
+ {
6099
+ "kind": "function",
6100
+ "name": "iconEllipsisVertical",
6101
+ "parameters": [
6102
+ {
6103
+ "name": "size",
6104
+ "default": "16"
6105
+ }
6106
+ ]
6107
+ },
5559
6108
  {
5560
6109
  "kind": "function",
5561
6110
  "name": "iconPlus",
@@ -6058,6 +6607,14 @@
6058
6607
  "module": "src/icons.ts"
6059
6608
  }
6060
6609
  },
6610
+ {
6611
+ "kind": "js",
6612
+ "name": "iconEllipsisVertical",
6613
+ "declaration": {
6614
+ "name": "iconEllipsisVertical",
6615
+ "module": "src/icons.ts"
6616
+ }
6617
+ },
6061
6618
  {
6062
6619
  "kind": "js",
6063
6620
  "name": "iconPlus",
@@ -7001,6 +7558,14 @@
7001
7558
  "module": "./dropdown-button.js"
7002
7559
  }
7003
7560
  },
7561
+ {
7562
+ "kind": "js",
7563
+ "name": "DropdownButtonVariant",
7564
+ "declaration": {
7565
+ "name": "DropdownButtonVariant",
7566
+ "module": "./dropdown-button.js"
7567
+ }
7568
+ },
7004
7569
  {
7005
7570
  "kind": "js",
7006
7571
  "name": "DropdownOption",
@@ -13951,7 +14516,7 @@
13951
14516
  "declarations": [
13952
14517
  {
13953
14518
  "kind": "class",
13954
- "description": "Plain multi-line text field — a thin, tokenized wrapper around a native\n`<textarea>`, styled to match the other value-entry form fields\n(autocomplete-input, form-select, ...). Not a rich editor; use `readonly`\nto display pre-formatted text (e.g. an error message) that the user can\nstill select and copy, typically paired with `<copy-link-button>`.",
14519
+ "description": "Plain multi-line text field — a thin, tokenized wrapper around a native\n`<textarea>`, styled to match the other value-entry form fields\n(autocomplete-input, form-select, ...). Not a rich editor; use `readonly`\nto display pre-formatted text (e.g. an error message) that the user can\nstill select and copy, typically paired with `<copy-link-button>`.\nSupports `form-field`'s opt-in floating-label mode when slotted inside it.",
13955
14520
  "name": "TextArea",
13956
14521
  "members": [
13957
14522
  {
@@ -14004,6 +14569,41 @@
14004
14569
  "description": "Disables the field entirely (no interaction, dimmed).",
14005
14570
  "attribute": "disabled"
14006
14571
  },
14572
+ {
14573
+ "kind": "field",
14574
+ "name": "_formFieldConfig",
14575
+ "type": {
14576
+ "text": "FormFieldControlConfig | null"
14577
+ },
14578
+ "privacy": "private",
14579
+ "default": "null"
14580
+ },
14581
+ {
14582
+ "kind": "field",
14583
+ "name": "#textareaId",
14584
+ "privacy": "private",
14585
+ "readonly": true,
14586
+ "default": "`text-area-field-${++instanceCount}`"
14587
+ },
14588
+ {
14589
+ "kind": "method",
14590
+ "name": "[formFieldControl]",
14591
+ "return": {
14592
+ "type": {
14593
+ "text": "void"
14594
+ }
14595
+ },
14596
+ "parameters": [
14597
+ {
14598
+ "name": "config",
14599
+ "type": {
14600
+ "text": "FormFieldControlConfig | null"
14601
+ }
14602
+ }
14603
+ ],
14604
+ "description": "Applies or clears label configuration supplied by a wrapping `form-field`.",
14605
+ "privacy": "private"
14606
+ },
14007
14607
  {
14008
14608
  "kind": "method",
14009
14609
  "name": "_onInput",
@@ -16181,6 +16781,53 @@
16181
16781
  }
16182
16782
  ]
16183
16783
  },
16784
+ {
16785
+ "kind": "javascript-module",
16786
+ "path": "src/utils/form-field-control.ts",
16787
+ "declarations": [
16788
+ {
16789
+ "kind": "variable",
16790
+ "name": "formFieldControl",
16791
+ "description": "Internal protocol key used to configure controls across their shadow boundary."
16792
+ },
16793
+ {
16794
+ "kind": "function",
16795
+ "name": "supportsFormFieldControl",
16796
+ "return": {
16797
+ "type": {
16798
+ "text": "element is FormFieldControl"
16799
+ }
16800
+ },
16801
+ "parameters": [
16802
+ {
16803
+ "name": "element",
16804
+ "type": {
16805
+ "text": "Element"
16806
+ }
16807
+ }
16808
+ ],
16809
+ "description": "Returns whether an assigned element implements the internal form-field protocol."
16810
+ }
16811
+ ],
16812
+ "exports": [
16813
+ {
16814
+ "kind": "js",
16815
+ "name": "formFieldControl",
16816
+ "declaration": {
16817
+ "name": "formFieldControl",
16818
+ "module": "src/utils/form-field-control.ts"
16819
+ }
16820
+ },
16821
+ {
16822
+ "kind": "js",
16823
+ "name": "supportsFormFieldControl",
16824
+ "declaration": {
16825
+ "name": "supportsFormFieldControl",
16826
+ "module": "src/utils/form-field-control.ts"
16827
+ }
16828
+ }
16829
+ ]
16830
+ },
16184
16831
  {
16185
16832
  "kind": "javascript-module",
16186
16833
  "path": "src/utils/form.ts",