@f-ewald/components 1.22.2 → 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.
@@ -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": {
@@ -4396,7 +4558,7 @@
4396
4558
  "declarations": [
4397
4559
  {
4398
4560
  "kind": "class",
4399
- "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.",
4400
4562
  "name": "FormField",
4401
4563
  "slots": [
4402
4564
  {
@@ -4445,12 +4607,351 @@
4445
4607
  "description": "Shows a required indicator next to the label.",
4446
4608
  "attribute": "required"
4447
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
+ },
4448
4648
  {
4449
4649
  "kind": "field",
4450
4650
  "name": "#messageId",
4451
4651
  "privacy": "private",
4452
4652
  "readonly": true,
4453
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."
4454
4955
  }
4455
4956
  ],
4456
4957
  "attributes": [
@@ -4489,6 +4990,15 @@
4489
4990
  "default": "false",
4490
4991
  "description": "Shows a required indicator next to the label.",
4491
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"
4492
5002
  }
4493
5003
  ],
4494
5004
  "superclass": {
@@ -14006,7 +14516,7 @@
14006
14516
  "declarations": [
14007
14517
  {
14008
14518
  "kind": "class",
14009
- "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.",
14010
14520
  "name": "TextArea",
14011
14521
  "members": [
14012
14522
  {
@@ -14059,6 +14569,41 @@
14059
14569
  "description": "Disables the field entirely (no interaction, dimmed).",
14060
14570
  "attribute": "disabled"
14061
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
+ },
14062
14607
  {
14063
14608
  "kind": "method",
14064
14609
  "name": "_onInput",
@@ -16236,6 +16781,53 @@
16236
16781
  }
16237
16782
  ]
16238
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
+ },
16239
16831
  {
16240
16832
  "kind": "javascript-module",
16241
16833
  "path": "src/utils/form.ts",