@optionfactory/fml 8.0.3 → 9.0.0-rc2

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 (50) hide show
  1. package/LICENSE.md +7 -0
  2. package/README.md +88 -0
  3. package/dist/client-errors.iife.js +30 -9
  4. package/dist/client-errors.iife.js.map +1 -1
  5. package/dist/client-errors.iife.min.js +1 -1
  6. package/dist/client-errors.iife.min.js.map +1 -1
  7. package/dist/custom-elements.json +1591 -427
  8. package/dist/fml.css +21 -10
  9. package/dist/fml.css.map +1 -1
  10. package/dist/fml.d.mts +3 -1322
  11. package/dist/fml.iife.js +5308 -2280
  12. package/dist/fml.iife.js.map +1 -1
  13. package/dist/fml.iife.min.js +1 -1
  14. package/dist/fml.iife.min.js.map +1 -1
  15. package/dist/fml.min.mjs +1 -1
  16. package/dist/fml.min.mjs.map +1 -1
  17. package/dist/fml.mjs +6 -8737
  18. package/dist/fml.mjs.map +1 -1
  19. package/dist/ftl.d.mts +430 -92
  20. package/dist/ftl.iife.js +1314 -809
  21. package/dist/ftl.iife.js.map +1 -1
  22. package/dist/ftl.iife.min.js +1 -1
  23. package/dist/ftl.iife.min.js.map +1 -1
  24. package/dist/ftl.min.mjs +1 -1
  25. package/dist/ftl.min.mjs.map +1 -1
  26. package/dist/ftl.mjs +1313 -810
  27. package/dist/ftl.mjs.map +1 -1
  28. package/dist/ful.css +21 -10
  29. package/dist/ful.css.map +1 -1
  30. package/dist/ful.d.mts +801 -252
  31. package/dist/ful.iife.js +3711 -1375
  32. package/dist/ful.iife.js.map +1 -1
  33. package/dist/ful.iife.min.js +1 -1
  34. package/dist/ful.iife.min.js.map +1 -1
  35. package/dist/ful.min.mjs +1 -1
  36. package/dist/ful.min.mjs.map +1 -1
  37. package/dist/ful.mjs +3700 -1375
  38. package/dist/ful.mjs.map +1 -1
  39. package/dist/httpc.d.mts +114 -19
  40. package/dist/httpc.iife.js +253 -83
  41. package/dist/httpc.iife.js.map +1 -1
  42. package/dist/httpc.iife.min.js +1 -1
  43. package/dist/httpc.iife.min.js.map +1 -1
  44. package/dist/httpc.min.mjs +1 -1
  45. package/dist/httpc.min.mjs.map +1 -1
  46. package/dist/httpc.mjs +250 -84
  47. package/dist/httpc.mjs.map +1 -1
  48. package/dist/vscode.html-custom-data.json +640 -58
  49. package/dist/web-types.json +1529 -354
  50. package/package.json +16 -8
@@ -2,22 +2,128 @@
2
2
  "version": 1.1,
3
3
  "tags": [
4
4
  {
5
- "name": "ful-spinner",
6
- "description": "A busy indicator. ful-form shows and hides the ones it contains while submitting.",
7
- "attributes": []
5
+ "name": "ful-tooltip",
6
+ "description": "An info affordance: a themed icon button toggling a small popover with a short explanation, opened by click and by keyboard like a button, dismissed by Escape or an outside click. placement picks the side the note sits on: bottom (default), top, left or right.",
7
+ "attributes": [
8
+ {
9
+ "name": "placement",
10
+ "description": "Which side of the trigger the note opens on: bottom (the default), top, start or end. The library places the note itself on every platform, so the side is the same everywhere. (string)"
11
+ }
12
+ ]
13
+ },
14
+ {
15
+ "name": "ful-dialog",
16
+ "description": "A modal dialog on the native platform: header, body and buttons, the header attribute naming its heading, opened by any element carrying dialog-target set to its id, or programmatically through open()/ask(), which resolve with the data-result of the button that closed the dialog (null on Escape). Longer explanations belong here, shorter ones in ful-tooltip.",
17
+ "attributes": [
18
+ {
19
+ "name": "header",
20
+ "description": "The dialog's title, shown in its header. Text only; slot content into the body instead for anything richer. (string)"
21
+ }
22
+ ]
23
+ },
24
+ {
25
+ "name": "ful-drawer",
26
+ "description": "A side panel drawer on the native dialog platform: a header with its title (the title attribute, or update()'s own) and close button, and a body that opens in a loading state, then shows either the content delivered by update(title, callback) (or the slotted one, when it is never updated) or the error a rejecting callback carries. placement picks the side, end by default, start its mirror. Any element carrying dialog-target set to its id opens it too.",
27
+ "attributes": [
28
+ {
29
+ "name": "title",
30
+ "description": "The drawer's title, shown in its header. Text only, and also what update() re-titles the panel with. (string)"
31
+ },
32
+ {
33
+ "name": "placement",
34
+ "description": "Which edge the panel slides in from: end (the default) or start, following the page's writing direction. (string)"
35
+ }
36
+ ]
37
+ },
38
+ {
39
+ "name": "ful-toasts",
40
+ "description": "A transient feedback region, one per page: each show() (or a show-toast document event carrying the same detail) appends a toast that dismisses itself after its timeout, the element's timeout attribute or five seconds by default, and carries its own dismiss button. severity picks the theme and the announcement, info by default, success, warning and error, the error one announced as an alert; a Failure message shows its problems' reasons.",
41
+ "attributes": [
42
+ {
43
+ "name": "timeout",
44
+ "description": "How long a toast stands before it retires, in milliseconds; 5000 when absent. A show() may override it per toast. (number)"
45
+ }
46
+ ]
47
+ },
48
+ {
49
+ "name": "ful-tabs",
50
+ "description": "A tab panel: one visible panel at a time, announced through the tab pattern (a tablist of tab buttons, each panel a tabpanel named by its tab, the arrows and Home/End walking the tabs with automatic activation). The tabs are declared as tab elements in the tabs slot, the panels as the slotless children, paired in order; the chrome anchors on the ful-tablist style-only tag, so a subclass or foreign markup built from it keeps the look.",
51
+ "attributes": [
52
+ {
53
+ "name": "active",
54
+ "description": "The index of the visible panel, zero based, reflected as the active attribute. Clicks, the arrow keys and the property all move it, each move answering with a change event. (number)"
55
+ }
56
+ ]
57
+ },
58
+ {
59
+ "name": "ful-accordion",
60
+ "description": "An accordion over native details/summary disclosures: the platform carries the semantics, the keyboard and the toggling, the chrome paints the group (anchored on the ful-accordion-group style-only tag). With the exclusive claim the render assigns one shared name to every panel, which is the platform's own exclusive grouping: opening one closes the others.",
61
+ "attributes": [
62
+ {
63
+ "name": "exclusive",
64
+ "description": "When present, opening a panel closes the others: the native details name grouping, assigned (and assignable again) by the render. (boolean)"
65
+ }
66
+ ]
67
+ },
68
+ {
69
+ "name": "ful-wizard",
70
+ "description": "A wizard: a progress of steps over one-of-N sections. The steps are declared as step elements in the steps slot, the sections as the slotless children, paired in order; each section may carry a data-step name, which is what move() answers to, next() and prev() walk the neighbors, and the current step is the aria-current=step claim carried in lockstep by the step and its section, so the chrome, including which section is shown, follows the claim alone. Each move answers with a change event.",
71
+ "attributes": [
72
+ {
73
+ "name": "progress",
74
+ "description": "picks the progress chrome's shape over the same claims: the default shows the current step alone (any counter or dressing is the page's own), timeline the full timeline, dots a done/current/future strip, none leaves the chrome to the page. (string)"
75
+ }
76
+ ]
8
77
  },
9
78
  {
10
79
  "name": "ful-form",
11
- "description": "Wraps its content in a form, collects the values of the fields it contains and hands them to a loader on submit.",
12
- "attributes": []
80
+ "description": "Wraps its content in a form, collects the values of the fields it contains and hands them to the loader named by loader (loaders:form by default) on submit: with action the values travel as json (method, POST by default) through the request-mapper and response-mapper components when declared, without it the submit:requested listeners deliver the response themselves. Validation errors are announced politely without focus, or exactly once through focus management with scroll-on-error, and clear-invalid-on-change drops a field's problem as soon as the field changes again; global errors land in an author-provided ful-errors element, announced as an alert.",
81
+ "attributes": [
82
+ {
83
+ "name": "action",
84
+ "description": "The endpoint the values are submitted to. With it the form posts json through a RemoteJsonFormLoader; without it a LocalFormLoader hands the outcome to whatever a submit:requested listener resolves with. (string)"
85
+ },
86
+ {
87
+ "name": "method",
88
+ "description": "The http method of the remote loader, POST by default. (string)"
89
+ },
90
+ {
91
+ "name": "loader",
92
+ "description": "The registry component key of the form loader, loaders:form by default. A loader of your own implements prepare, submit and transform. (string)"
93
+ },
94
+ {
95
+ "name": "request-mapper",
96
+ "description": "A registry component key, (values, form) => request, applied to the extracted values before they are sent. (string)"
97
+ },
98
+ {
99
+ "name": "response-mapper",
100
+ "description": "A registry component key, (response, form) => mapped, applied to a successful response before it reaches submit:success. (string)"
101
+ },
102
+ {
103
+ "name": "clear-invalid-on-change",
104
+ "description": "Clears a field's custom validity as soon as that field changes again, so a server problem stops being shown the moment the user addresses it. (boolean)"
105
+ },
106
+ {
107
+ "name": "scroll-on-error",
108
+ "description": "Moves focus, and the viewport with it, to the topmost invalid field when errors land. The error live region is muted while focus moves, so each problem is announced once through the focused field rather than twice. (boolean)"
109
+ },
110
+ {
111
+ "name": "autocomplete",
112
+ "description": "The autofill token every field in the form takes unless it declares one of its own, copied onto the form element the host renders. A form cannot pass it down the way the platform would: each control carries form=\"\" so that the host is the only thing that submits, which leaves it with no form owner to inherit through, so the fields read it off the form instead. (string)"
113
+ }
114
+ ]
13
115
  },
14
116
  {
15
117
  "name": "ful-checkbox",
16
118
  "description": "A checkbox, or a switch with type=\"switch\". Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
17
119
  "attributes": [
18
120
  {
19
- "name": "value",
20
- "description": "Checked when the attribute is the string true. (boolean)"
121
+ "name": "type",
122
+ "description": "switch renders the control as a switch rather than a checkbox. The value and the semantics are unchanged. (string)"
123
+ },
124
+ {
125
+ "name": "disabled",
126
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
21
127
  },
22
128
  {
23
129
  "name": "readonly",
@@ -26,16 +132,48 @@
26
132
  {
27
133
  "name": "required",
28
134
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
135
+ },
136
+ {
137
+ "name": "value",
138
+ "description": "Checked when the attribute is the string true. (boolean)"
29
139
  }
30
140
  ]
31
141
  },
32
142
  {
33
143
  "name": "ful-input",
34
- "description": "A labelled text input. Use type to pick any native input type, or textarea. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
144
+ "description": "A labelled text input. Use type to pick any native input type, or textarea; keep names the characters that survive a keystroke and reject the ones that do not, the caret staying among the survivors, and the uppercase and trim claims shape the value before it is read; v-type=number decodes the value to a number, blank staying null and a value that does not decode kept as it is, an undeclared type defaulting to number. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
35
145
  "attributes": [
36
146
  {
37
- "name": "value",
38
- "description": "The current value. (string)"
147
+ "name": "type",
148
+ "description": "Any native input type, or the literal textarea to render one. Defaults to number under v-type=number, and a declared type wins. (string)"
149
+ },
150
+ {
151
+ "name": "v-type",
152
+ "description": "number decodes the value to a number on the way out: blank stays null and a value that does not decode is kept as it is. (string)"
153
+ },
154
+ {
155
+ "name": "keep",
156
+ "description": "A regular expression naming the characters that survive a keystroke, so keep=\"[0-9]\" is digits only. It matches rather than negating, so it takes a pattern and not only a character class. (string)"
157
+ },
158
+ {
159
+ "name": "reject",
160
+ "description": "The same filter from the other side: a regular expression naming what is stripped from the value on every keystroke. Declaring both applies keep and warns once. (string)"
161
+ },
162
+ {
163
+ "name": "uppercase",
164
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
165
+ },
166
+ {
167
+ "name": "trim",
168
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
169
+ },
170
+ {
171
+ "name": "autocomplete",
172
+ "description": "The autofill token the browser classifies the control by, one of the names the html autocomplete grammar defines (name, given-name, street-address, postal-code, one-time-code, off, ...). It is set on the control itself because the control carries form=\"\", which leaves it without a form owner to inherit a form-wide setting from. Read once at the upgrade. A value outside the grammar reads as on, so an identifier of your own does not switch autofill off. (string)"
173
+ },
174
+ {
175
+ "name": "disabled",
176
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
39
177
  },
40
178
  {
41
179
  "name": "readonly",
@@ -45,6 +183,10 @@
45
183
  "name": "required",
46
184
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
47
185
  },
186
+ {
187
+ "name": "value",
188
+ "description": "The current value. (string)"
189
+ },
48
190
  {
49
191
  "name": "placeholder",
50
192
  "description": "Placeholder shown while the field is empty. (string)"
@@ -53,11 +195,39 @@
53
195
  },
54
196
  {
55
197
  "name": "ful-input-file",
56
- "description": "A file input with an optional dropzone and a list of the selected files, enforcing the size and count limits it declares. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
198
+ "description": "A file input with an optional dropzone and a list of the selected files, enforcing the size and count limits it declares; the noinput claim hides the picker control, the dropzone and the item list carrying the field alone. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
57
199
  "attributes": [
58
200
  {
59
- "name": "value",
60
- "description": "Only an empty value is honoured, to clear the selection: file inputs cannot be filled programmatically. (string)"
201
+ "name": "type",
202
+ "description": "Any native input type, or the literal textarea to render one. Defaults to number under v-type=number, and a declared type wins. (string)"
203
+ },
204
+ {
205
+ "name": "v-type",
206
+ "description": "number decodes the value to a number on the way out: blank stays null and a value that does not decode is kept as it is. (string)"
207
+ },
208
+ {
209
+ "name": "keep",
210
+ "description": "A regular expression naming the characters that survive a keystroke, so keep=\"[0-9]\" is digits only. It matches rather than negating, so it takes a pattern and not only a character class. (string)"
211
+ },
212
+ {
213
+ "name": "reject",
214
+ "description": "The same filter from the other side: a regular expression naming what is stripped from the value on every keystroke. Declaring both applies keep and warns once. (string)"
215
+ },
216
+ {
217
+ "name": "uppercase",
218
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
219
+ },
220
+ {
221
+ "name": "trim",
222
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
223
+ },
224
+ {
225
+ "name": "autocomplete",
226
+ "description": "The autofill token the browser classifies the control by, one of the names the html autocomplete grammar defines (name, given-name, street-address, postal-code, one-time-code, off, ...). It is set on the control itself because the control carries form=\"\", which leaves it without a form owner to inherit a form-wide setting from. Read once at the upgrade. A value outside the grammar reads as on, so an identifier of your own does not switch autofill off. (string)"
227
+ },
228
+ {
229
+ "name": "disabled",
230
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
61
231
  },
62
232
  {
63
233
  "name": "readonly",
@@ -67,20 +237,24 @@
67
237
  "name": "required",
68
238
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
69
239
  },
240
+ {
241
+ "name": "value",
242
+ "description": "Only an empty value is honoured, to clear the selection: file inputs cannot be filled programmatically. (string)"
243
+ },
70
244
  {
71
245
  "name": "placeholder",
72
246
  "description": "Placeholder shown while the field is empty. (string)"
73
247
  },
74
248
  {
75
249
  "name": "accept",
76
- "description": "Comma separated list of accepted extensions. Files that do not match are dropped with a warning. (string)"
250
+ "description": "Comma separated list of accepted tokens: an extension (.pdf), a mime type (application/pdf) or a wildcard (image/*). Files that do not match are dropped with a warning. (string)"
77
251
  },
78
252
  {
79
253
  "name": "multiple",
80
254
  "description": "Allows selecting more than one file. (boolean)"
81
255
  },
82
256
  {
83
- "name": "itemlist",
257
+ "name": "item-list",
84
258
  "description": "Shows the list of selected files. (boolean)"
85
259
  },
86
260
  {
@@ -88,36 +262,82 @@
88
262
  "description": "Shows the dropzone. (boolean)"
89
263
  },
90
264
  {
91
- "name": "maxfiles",
265
+ "name": "max-files",
92
266
  "description": "Maximum number of files. Exceeding it clears the selection. (number)"
93
267
  },
94
268
  {
95
- "name": "maxfilesize",
269
+ "name": "max-file-size",
96
270
  "description": "Maximum size of a single file, in bytes. Larger files are dropped. (number)"
97
271
  },
98
272
  {
99
- "name": "maxtotalsize",
273
+ "name": "max-total-size",
100
274
  "description": "Maximum size of all the selected files, in bytes. Exceeding it clears the selection. (number)"
101
275
  }
102
276
  ]
103
277
  },
104
278
  {
105
279
  "name": "ful-local-date",
106
- "description": "Formats the date in its content, written as yyyy-mm-dd, in the locale of the page.",
107
- "attributes": []
280
+ "description": "Formats the date in its content, written as yyyy-mm-dd, in the locale of the page or the one its locale attribute names; default is shown when the content is empty.",
281
+ "attributes": [
282
+ {
283
+ "name": "locale",
284
+ "description": "The locale the date is formatted in, taking precedence over the page's. The platform default applies when neither names one. (string)"
285
+ },
286
+ {
287
+ "name": "default",
288
+ "description": "The text rendered when the content is blank or does not parse as a date. (string)"
289
+ }
290
+ ]
108
291
  },
109
292
  {
110
293
  "name": "ful-instant",
111
- "description": "Formats the ISO instant in its content in the locale and timezone of the page.",
112
- "attributes": []
294
+ "description": "Formats the ISO instant in its content in the locale and timezone of the page or the one its locale attribute names; default is shown when the content is empty.",
295
+ "attributes": [
296
+ {
297
+ "name": "locale",
298
+ "description": "The locale the instant is formatted in, taking precedence over the page's. The platform default applies when neither names one. (string)"
299
+ },
300
+ {
301
+ "name": "default",
302
+ "description": "The text rendered when the content is blank or does not parse as an instant. (string)"
303
+ }
304
+ ]
113
305
  },
114
306
  {
115
307
  "name": "ful-input-local-date",
116
308
  "description": "A date input. Its bounds accept a date, now, or an offset such as +1d, -2m or +3y. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
117
309
  "attributes": [
118
310
  {
119
- "name": "value",
120
- "description": "The current value. (string)"
311
+ "name": "type",
312
+ "description": "Any native input type, or the literal textarea to render one. Defaults to number under v-type=number, and a declared type wins. (string)"
313
+ },
314
+ {
315
+ "name": "v-type",
316
+ "description": "number decodes the value to a number on the way out: blank stays null and a value that does not decode is kept as it is. (string)"
317
+ },
318
+ {
319
+ "name": "keep",
320
+ "description": "A regular expression naming the characters that survive a keystroke, so keep=\"[0-9]\" is digits only. It matches rather than negating, so it takes a pattern and not only a character class. (string)"
321
+ },
322
+ {
323
+ "name": "reject",
324
+ "description": "The same filter from the other side: a regular expression naming what is stripped from the value on every keystroke. Declaring both applies keep and warns once. (string)"
325
+ },
326
+ {
327
+ "name": "uppercase",
328
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
329
+ },
330
+ {
331
+ "name": "trim",
332
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
333
+ },
334
+ {
335
+ "name": "autocomplete",
336
+ "description": "The autofill token the browser classifies the control by, one of the names the html autocomplete grammar defines (name, given-name, street-address, postal-code, one-time-code, off, ...). It is set on the control itself because the control carries form=\"\", which leaves it without a form owner to inherit a form-wide setting from. Read once at the upgrade. A value outside the grammar reads as on, so an identifier of your own does not switch autofill off. (string)"
337
+ },
338
+ {
339
+ "name": "disabled",
340
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
121
341
  },
122
342
  {
123
343
  "name": "readonly",
@@ -127,10 +347,18 @@
127
347
  "name": "required",
128
348
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
129
349
  },
350
+ {
351
+ "name": "value",
352
+ "description": "The current value. (string)"
353
+ },
130
354
  {
131
355
  "name": "placeholder",
132
356
  "description": "Placeholder shown while the field is empty. (string)"
133
357
  },
358
+ {
359
+ "name": "step",
360
+ "description": "Step between selectable dates, in days. (string)"
361
+ },
134
362
  {
135
363
  "name": "min",
136
364
  "description": "Earliest selectable date. Accepts a date, now, or a day, month or year offset. (string)"
@@ -138,10 +366,6 @@
138
366
  {
139
367
  "name": "max",
140
368
  "description": "Latest selectable date. Accepts a date, now, or a day, month or year offset. (string)"
141
- },
142
- {
143
- "name": "step",
144
- "description": "Step between selectable dates, in days. (string)"
145
369
  }
146
370
  ]
147
371
  },
@@ -150,8 +374,36 @@
150
374
  "description": "A time input. Its bounds accept a time, now, or an hour or minute offset, snapped to the step grid. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
151
375
  "attributes": [
152
376
  {
153
- "name": "value",
154
- "description": "The current value. (string)"
377
+ "name": "type",
378
+ "description": "Any native input type, or the literal textarea to render one. Defaults to number under v-type=number, and a declared type wins. (string)"
379
+ },
380
+ {
381
+ "name": "v-type",
382
+ "description": "number decodes the value to a number on the way out: blank stays null and a value that does not decode is kept as it is. (string)"
383
+ },
384
+ {
385
+ "name": "keep",
386
+ "description": "A regular expression naming the characters that survive a keystroke, so keep=\"[0-9]\" is digits only. It matches rather than negating, so it takes a pattern and not only a character class. (string)"
387
+ },
388
+ {
389
+ "name": "reject",
390
+ "description": "The same filter from the other side: a regular expression naming what is stripped from the value on every keystroke. Declaring both applies keep and warns once. (string)"
391
+ },
392
+ {
393
+ "name": "uppercase",
394
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
395
+ },
396
+ {
397
+ "name": "trim",
398
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
399
+ },
400
+ {
401
+ "name": "autocomplete",
402
+ "description": "The autofill token the browser classifies the control by, one of the names the html autocomplete grammar defines (name, given-name, street-address, postal-code, one-time-code, off, ...). It is set on the control itself because the control carries form=\"\", which leaves it without a form owner to inherit a form-wide setting from. Read once at the upgrade. A value outside the grammar reads as on, so an identifier of your own does not switch autofill off. (string)"
403
+ },
404
+ {
405
+ "name": "disabled",
406
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
155
407
  },
156
408
  {
157
409
  "name": "readonly",
@@ -161,10 +413,18 @@
161
413
  "name": "required",
162
414
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
163
415
  },
416
+ {
417
+ "name": "value",
418
+ "description": "The current value. (string)"
419
+ },
164
420
  {
165
421
  "name": "placeholder",
166
422
  "description": "Placeholder shown while the field is empty. (string)"
167
423
  },
424
+ {
425
+ "name": "step",
426
+ "description": "Step between selectable times, in seconds. The bounds are truncated to this grid. (string)"
427
+ },
168
428
  {
169
429
  "name": "min",
170
430
  "description": "Earliest selectable time. Accepts a time, now, or an offset such as +2h or -30m. (string)"
@@ -172,10 +432,6 @@
172
432
  {
173
433
  "name": "max",
174
434
  "description": "Latest selectable time. Accepts a time, now, or an offset such as +2h or -30m. (string)"
175
- },
176
- {
177
- "name": "step",
178
- "description": "Step between selectable times, in seconds. The bounds are truncated to this grid. (string)"
179
435
  }
180
436
  ]
181
437
  },
@@ -184,8 +440,36 @@
184
440
  "description": "A datetime input whose value is read and written as an ISO instant. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
185
441
  "attributes": [
186
442
  {
187
- "name": "value",
188
- "description": "The current value. (string)"
443
+ "name": "type",
444
+ "description": "Any native input type, or the literal textarea to render one. Defaults to number under v-type=number, and a declared type wins. (string)"
445
+ },
446
+ {
447
+ "name": "v-type",
448
+ "description": "number decodes the value to a number on the way out: blank stays null and a value that does not decode is kept as it is. (string)"
449
+ },
450
+ {
451
+ "name": "keep",
452
+ "description": "A regular expression naming the characters that survive a keystroke, so keep=\"[0-9]\" is digits only. It matches rather than negating, so it takes a pattern and not only a character class. (string)"
453
+ },
454
+ {
455
+ "name": "reject",
456
+ "description": "The same filter from the other side: a regular expression naming what is stripped from the value on every keystroke. Declaring both applies keep and warns once. (string)"
457
+ },
458
+ {
459
+ "name": "uppercase",
460
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
461
+ },
462
+ {
463
+ "name": "trim",
464
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
465
+ },
466
+ {
467
+ "name": "autocomplete",
468
+ "description": "The autofill token the browser classifies the control by, one of the names the html autocomplete grammar defines (name, given-name, street-address, postal-code, one-time-code, off, ...). It is set on the control itself because the control carries form=\"\", which leaves it without a form owner to inherit a form-wide setting from. Read once at the upgrade. A value outside the grammar reads as on, so an identifier of your own does not switch autofill off. (string)"
469
+ },
470
+ {
471
+ "name": "disabled",
472
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
189
473
  },
190
474
  {
191
475
  "name": "readonly",
@@ -195,10 +479,18 @@
195
479
  "name": "required",
196
480
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
197
481
  },
482
+ {
483
+ "name": "value",
484
+ "description": "The current value. (string)"
485
+ },
198
486
  {
199
487
  "name": "placeholder",
200
488
  "description": "Placeholder shown while the field is empty. (string)"
201
489
  },
490
+ {
491
+ "name": "step",
492
+ "description": "Step between selectable instants, in seconds. (string)"
493
+ },
202
494
  {
203
495
  "name": "min",
204
496
  "description": "Earliest selectable instant, as an ISO instant. (string)"
@@ -206,10 +498,6 @@
206
498
  {
207
499
  "name": "max",
208
500
  "description": "Latest selectable instant, as an ISO instant. (string)"
209
- },
210
- {
211
- "name": "step",
212
- "description": "Step between selectable instants, in seconds. (string)"
213
501
  }
214
502
  ]
215
503
  },
@@ -218,8 +506,16 @@
218
506
  "description": "A group of radios, declared as ful-radio children. With type=\"boolean\" the value is a real boolean. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
219
507
  "attributes": [
220
508
  {
221
- "name": "value",
222
- "description": "The value of the selected radio. (string)"
509
+ "name": "name",
510
+ "description": "The name the radio inputs share, which is what makes them one group. Generated when absent, so a group only needs it to be addressed from outside. (string)"
511
+ },
512
+ {
513
+ "name": "type",
514
+ "description": "boolean maps the two declared radios onto true and false rather than onto their own values. (string)"
515
+ },
516
+ {
517
+ "name": "disabled",
518
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
223
519
  },
224
520
  {
225
521
  "name": "readonly",
@@ -228,18 +524,39 @@
228
524
  {
229
525
  "name": "required",
230
526
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
527
+ },
528
+ {
529
+ "name": "value",
530
+ "description": "The value of the selected radio. (string)"
231
531
  }
232
532
  ]
233
533
  },
234
534
  {
235
535
  "name": "ful-table",
236
- "description": "A table that loads its rows from a loader, with sorting, pagination and an optional filter form. Its columns are declared in a schema slot.",
237
- "attributes": []
536
+ "description": "A table that loads its rows from a loader, with sorting, pagination and an optional filter form. Its columns are declared in a schema slot; the rows come from src (method, GET by default) through the loader named by loader (loaders:table by default), page-size rows a page (10 by default), the first one loading on upgrade under the autoload claim.",
537
+ "attributes": [
538
+ {
539
+ "name": "loader",
540
+ "description": "The registered component name the table loads its rows through; loaders:table when absent. (string)"
541
+ },
542
+ {
543
+ "name": "autoload",
544
+ "description": "Loads the first page while upgrading, instead of waiting for a reload(). The load is not awaited, so a slow or failing loader cannot hold up the page. (boolean)"
545
+ },
546
+ {
547
+ "name": "page-size",
548
+ "description": "How many rows a page asks the loader for, 10 by default. Stays live: writing it reloads from the first page, a table that has not been asked to load yet only recording it. (number)"
549
+ }
550
+ ]
238
551
  },
239
552
  {
240
553
  "name": "ful-pagination",
241
- "description": "The pager of a ful-table. Rarely used on its own.",
554
+ "description": "The pager of a ful-table, its window rendering at most pages links (5 by default). Rarely used on its own.",
242
555
  "attributes": [
556
+ {
557
+ "name": "pages",
558
+ "description": "How many page buttons are rendered around the current one, 5 by default. (number)"
559
+ },
243
560
  {
244
561
  "name": "total",
245
562
  "description": "Number of pages. (number)"
@@ -252,8 +569,12 @@
252
569
  },
253
570
  {
254
571
  "name": "ful-sorter",
255
- "description": "The sort control rendered in a ful-table header. Rarely used on its own.",
572
+ "description": "The sort control rendered in a ful-table header, focusable and activated by Enter and Space, carrying aria-sort on its header cell. Rarely used on its own.",
256
573
  "attributes": [
574
+ {
575
+ "name": "sorter",
576
+ "description": "The field name this column sorts by, sent in the load request. A column without it is not sortable. (string)"
577
+ },
257
578
  {
258
579
  "name": "order",
259
580
  "description": "The sort currently applied, asc or desc, or absent when unsorted. (string)"
@@ -265,8 +586,36 @@
265
586
  "description": "A ful-table filter over an instant, with an operator and one or two bounds. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
266
587
  "attributes": [
267
588
  {
268
- "name": "value",
269
- "description": "JSON tuple of the operator and its bounds, for example [\"BETWEEN\", from, to]. (string)"
589
+ "name": "type",
590
+ "description": "Any native input type, or the literal textarea to render one. Defaults to number under v-type=number, and a declared type wins. (string)"
591
+ },
592
+ {
593
+ "name": "v-type",
594
+ "description": "number decodes the value to a number on the way out: blank stays null and a value that does not decode is kept as it is. (string)"
595
+ },
596
+ {
597
+ "name": "keep",
598
+ "description": "A regular expression naming the characters that survive a keystroke, so keep=\"[0-9]\" is digits only. It matches rather than negating, so it takes a pattern and not only a character class. (string)"
599
+ },
600
+ {
601
+ "name": "reject",
602
+ "description": "The same filter from the other side: a regular expression naming what is stripped from the value on every keystroke. Declaring both applies keep and warns once. (string)"
603
+ },
604
+ {
605
+ "name": "uppercase",
606
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
607
+ },
608
+ {
609
+ "name": "trim",
610
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
611
+ },
612
+ {
613
+ "name": "autocomplete",
614
+ "description": "The autofill token the browser classifies the control by, one of the names the html autocomplete grammar defines (name, given-name, street-address, postal-code, one-time-code, off, ...). It is set on the control itself because the control carries form=\"\", which leaves it without a form owner to inherit a form-wide setting from. Read once at the upgrade. A value outside the grammar reads as on, so an identifier of your own does not switch autofill off. (string)"
615
+ },
616
+ {
617
+ "name": "disabled",
618
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
270
619
  },
271
620
  {
272
621
  "name": "readonly",
@@ -276,9 +625,17 @@
276
625
  "name": "required",
277
626
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
278
627
  },
628
+ {
629
+ "name": "value",
630
+ "description": "JSON tuple of the operator and its bounds, for example [\"BETWEEN\", from, to]. (string)"
631
+ },
279
632
  {
280
633
  "name": "placeholder",
281
634
  "description": "Placeholder shown while the field is empty. (string)"
635
+ },
636
+ {
637
+ "name": "operators",
638
+ "description": "Comma separated list of the operators the menu offers, out of EQ, NEQ, LT, GT, LTE, GTE, BETWEEN. Defaults to all of them. (string)"
282
639
  }
283
640
  ]
284
641
  },
@@ -286,10 +643,96 @@
286
643
  "name": "ful-filter-local-date",
287
644
  "description": "A ful-table filter over a date, with an operator and one or two bounds. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
288
645
  "attributes": [
646
+ {
647
+ "name": "type",
648
+ "description": "Any native input type, or the literal textarea to render one. Defaults to number under v-type=number, and a declared type wins. (string)"
649
+ },
650
+ {
651
+ "name": "v-type",
652
+ "description": "number decodes the value to a number on the way out: blank stays null and a value that does not decode is kept as it is. (string)"
653
+ },
654
+ {
655
+ "name": "keep",
656
+ "description": "A regular expression naming the characters that survive a keystroke, so keep=\"[0-9]\" is digits only. It matches rather than negating, so it takes a pattern and not only a character class. (string)"
657
+ },
658
+ {
659
+ "name": "reject",
660
+ "description": "The same filter from the other side: a regular expression naming what is stripped from the value on every keystroke. Declaring both applies keep and warns once. (string)"
661
+ },
662
+ {
663
+ "name": "uppercase",
664
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
665
+ },
666
+ {
667
+ "name": "trim",
668
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
669
+ },
670
+ {
671
+ "name": "autocomplete",
672
+ "description": "The autofill token the browser classifies the control by, one of the names the html autocomplete grammar defines (name, given-name, street-address, postal-code, one-time-code, off, ...). It is set on the control itself because the control carries form=\"\", which leaves it without a form owner to inherit a form-wide setting from. Read once at the upgrade. A value outside the grammar reads as on, so an identifier of your own does not switch autofill off. (string)"
673
+ },
674
+ {
675
+ "name": "disabled",
676
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
677
+ },
678
+ {
679
+ "name": "readonly",
680
+ "description": "Renders the control but does not let it be edited. A readonly field still contributes its value to the form. (boolean)"
681
+ },
682
+ {
683
+ "name": "required",
684
+ "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
685
+ },
289
686
  {
290
687
  "name": "value",
291
688
  "description": "JSON tuple of the operator and its bounds, for example [\"BETWEEN\", from, to]. (string)"
292
689
  },
690
+ {
691
+ "name": "placeholder",
692
+ "description": "Placeholder shown while the field is empty. (string)"
693
+ },
694
+ {
695
+ "name": "operators",
696
+ "description": "Comma separated list of the operators the menu offers, out of EQ, NEQ, LT, GT, LTE, GTE, BETWEEN. Defaults to all of them. (string)"
697
+ }
698
+ ]
699
+ },
700
+ {
701
+ "name": "ful-filter-number",
702
+ "description": "A ful-table filter over numbers, with an operator such as GTE or BETWEEN. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
703
+ "attributes": [
704
+ {
705
+ "name": "type",
706
+ "description": "Any native input type, or the literal textarea to render one. Defaults to number under v-type=number, and a declared type wins. (string)"
707
+ },
708
+ {
709
+ "name": "v-type",
710
+ "description": "number decodes the value to a number on the way out: blank stays null and a value that does not decode is kept as it is. (string)"
711
+ },
712
+ {
713
+ "name": "keep",
714
+ "description": "A regular expression naming the characters that survive a keystroke, so keep=\"[0-9]\" is digits only. It matches rather than negating, so it takes a pattern and not only a character class. (string)"
715
+ },
716
+ {
717
+ "name": "reject",
718
+ "description": "The same filter from the other side: a regular expression naming what is stripped from the value on every keystroke. Declaring both applies keep and warns once. (string)"
719
+ },
720
+ {
721
+ "name": "uppercase",
722
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
723
+ },
724
+ {
725
+ "name": "trim",
726
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
727
+ },
728
+ {
729
+ "name": "autocomplete",
730
+ "description": "The autofill token the browser classifies the control by, one of the names the html autocomplete grammar defines (name, given-name, street-address, postal-code, one-time-code, off, ...). It is set on the control itself because the control carries form=\"\", which leaves it without a form owner to inherit a form-wide setting from. Read once at the upgrade. A value outside the grammar reads as on, so an identifier of your own does not switch autofill off. (string)"
731
+ },
732
+ {
733
+ "name": "disabled",
734
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
735
+ },
293
736
  {
294
737
  "name": "readonly",
295
738
  "description": "Renders the control but does not let it be edited. A readonly field still contributes its value to the form. (boolean)"
@@ -298,19 +741,81 @@
298
741
  "name": "required",
299
742
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
300
743
  },
744
+ {
745
+ "name": "value",
746
+ "description": "JSON tuple of the operator and its bound(s). (string)"
747
+ },
301
748
  {
302
749
  "name": "placeholder",
303
750
  "description": "Placeholder shown while the field is empty. (string)"
751
+ },
752
+ {
753
+ "name": "operators",
754
+ "description": "Comma separated list of the operators the menu offers, out of EQ, NEQ, LT, GT, LTE, GTE, BETWEEN. Defaults to all of them. (string)"
304
755
  }
305
756
  ]
306
757
  },
307
758
  {
308
- "name": "ful-filter-text",
309
- "description": "A ful-table filter over text, with an operator such as CONTAINS or STARTS_WITH. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
759
+ "name": "ful-filter-boolean",
760
+ "description": "A ful-table filter over booleans, with the EQ or NEQ operator and a yes/no menu carrying the true and false tokens, plus an any entry that contributes nothing. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
310
761
  "attributes": [
762
+ {
763
+ "name": "disabled",
764
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
765
+ },
766
+ {
767
+ "name": "readonly",
768
+ "description": "Renders the control but does not let it be edited. A readonly field still contributes its value to the form. (boolean)"
769
+ },
770
+ {
771
+ "name": "required",
772
+ "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
773
+ },
311
774
  {
312
775
  "name": "value",
313
- "description": "JSON tuple of the operator, the sensitivity and the text. (string)"
776
+ "description": "JSON tuple of the operator and the token. (string)"
777
+ },
778
+ {
779
+ "name": "operators",
780
+ "description": "Comma separated list of the operators the menu offers, out of EQ, NEQ. Defaults to both. (string)"
781
+ }
782
+ ]
783
+ },
784
+ {
785
+ "name": "ful-filter-text",
786
+ "description": "A ful-table filter over text, with an operator such as CONTAINS or STARTS_WITH and a case sensitivity. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only. A multiple ful-select used as a filter emits the bare value array the in-list annotations expect.",
787
+ "attributes": [
788
+ {
789
+ "name": "type",
790
+ "description": "Any native input type, or the literal textarea to render one. Defaults to number under v-type=number, and a declared type wins. (string)"
791
+ },
792
+ {
793
+ "name": "v-type",
794
+ "description": "number decodes the value to a number on the way out: blank stays null and a value that does not decode is kept as it is. (string)"
795
+ },
796
+ {
797
+ "name": "keep",
798
+ "description": "A regular expression naming the characters that survive a keystroke, so keep=\"[0-9]\" is digits only. It matches rather than negating, so it takes a pattern and not only a character class. (string)"
799
+ },
800
+ {
801
+ "name": "reject",
802
+ "description": "The same filter from the other side: a regular expression naming what is stripped from the value on every keystroke. Declaring both applies keep and warns once. (string)"
803
+ },
804
+ {
805
+ "name": "uppercase",
806
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
807
+ },
808
+ {
809
+ "name": "trim",
810
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
811
+ },
812
+ {
813
+ "name": "autocomplete",
814
+ "description": "The autofill token the browser classifies the control by, one of the names the html autocomplete grammar defines (name, given-name, street-address, postal-code, one-time-code, off, ...). It is set on the control itself because the control carries form=\"\", which leaves it without a form owner to inherit a form-wide setting from. Read once at the upgrade. A value outside the grammar reads as on, so an identifier of your own does not switch autofill off. (string)"
815
+ },
816
+ {
817
+ "name": "disabled",
818
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
314
819
  },
315
820
  {
316
821
  "name": "readonly",
@@ -320,19 +825,83 @@
320
825
  "name": "required",
321
826
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
322
827
  },
828
+ {
829
+ "name": "value",
830
+ "description": "JSON tuple of the operator, the sensitivity and the text. (string)"
831
+ },
323
832
  {
324
833
  "name": "placeholder",
325
834
  "description": "Placeholder shown while the field is empty. (string)"
835
+ },
836
+ {
837
+ "name": "operators",
838
+ "description": "Comma separated list of the operators the menu offers, out of EQ, NEQ, LT, GT, LTE, GTE, BETWEEN, CONTAINS, STARTS_WITH, ENDS_WITH. Defaults to all of them. (string)"
839
+ },
840
+ {
841
+ "name": "sensitivities",
842
+ "description": "Comma separated list of the case sensitivity modes, IGNORE_CASE, CASE_SENSITIVE. A single entry pins every emitted tuple to it. (string)"
326
843
  }
327
844
  ]
328
845
  },
329
846
  {
330
847
  "name": "ful-select",
331
- "description": "A combobox backed by a loader, with badges for the current selection. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
848
+ "description": "A combobox backed by a loader that acts like a select: the field mirrors the label of a single selection, clicking anywhere on it toggles the dropdown, which opens highlighting the current selection, and Home, End, PageUp, PageDown and Alt+arrows navigate it. A multiple selection renders as ful-badge chips. Without src the slotted options are the vocabulary; with src the options are fetched once (method, POST by default, preload fetching them while upgrading, revision caching them in local storage) or asked per query under mode=chunked, the response shaped through the k-expr/l-expr/d-expr/m-expr expressions or a response-mapper component, and every key coerced as k-type declares. Disabled follows native semantics: the attribute is the field's own claim, honored together with a disabled fieldset ancestry through :disabled, while the property reflects the claim only.",
332
849
  "attributes": [
333
850
  {
334
- "name": "value",
335
- "description": "The selected key, or a comma separated list of keys when multiple. (string)"
851
+ "name": "name",
852
+ "description": "The field name the surrounding form submits the selection under. (string)"
853
+ },
854
+ {
855
+ "name": "loader",
856
+ "description": "The registered component name the select loads its vocabulary through; loaders:select when absent. (string)"
857
+ },
858
+ {
859
+ "name": "k-type",
860
+ "description": "How a key coerces when it arrives from the response or from the value attribute: number, string or bool. (string)"
861
+ },
862
+ {
863
+ "name": "src",
864
+ "description": "The url the vocabulary is fetched from. Without it the slotted <option> elements are the whole vocabulary, held in memory. (string)"
865
+ },
866
+ {
867
+ "name": "method",
868
+ "description": "The method the vocabulary is fetched with; POST when absent. (string)"
869
+ },
870
+ {
871
+ "name": "mode",
872
+ "description": "chunked asks the endpoint per query instead of fetching the vocabulary once, for a list too large to hold. (string)"
873
+ },
874
+ {
875
+ "name": "preload",
876
+ "description": "Fetches the vocabulary while the element upgrades rather than on first use. The field paints immediately either way; the options arrive when they arrive. (boolean)"
877
+ },
878
+ {
879
+ "name": "revision",
880
+ "description": "Caches the fetched vocabulary in local storage under this revision; a load under a different one is a miss that evicts the entry. It is the cache's namespace, so a vocabulary that differs per user wants the principal in it. (string)"
881
+ },
882
+ {
883
+ "name": "k-expr",
884
+ "description": "The expression yielding an option's key, evaluated against each row of the response. Set it together with l-expr to shape a response without a mapper component. (string)"
885
+ },
886
+ {
887
+ "name": "l-expr",
888
+ "description": "The expression yielding an option's label, evaluated against each row of the response. (string)"
889
+ },
890
+ {
891
+ "name": "d-expr",
892
+ "description": "The expression yielding the rows from the response body; the body itself when absent. (string)"
893
+ },
894
+ {
895
+ "name": "m-expr",
896
+ "description": "The expression yielding an option's metadata, evaluated against each row; the whole row when absent. (string)"
897
+ },
898
+ {
899
+ "name": "response-mapper",
900
+ "description": "The registered component name that turns a response into { key, label, metadata } entries. The k-expr/l-expr pair takes precedence; without either, the response is read as positional rows. (string)"
901
+ },
902
+ {
903
+ "name": "disabled",
904
+ "description": "The field's own disabled claim: the control is disabled and the field is left out of the submitted values, composed with a disabled fieldset ancestry. The property reflects the claim only, matches(':disabled') tells the effective state. (boolean)"
336
905
  },
337
906
  {
338
907
  "name": "readonly",
@@ -343,15 +912,28 @@
343
912
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
344
913
  },
345
914
  {
346
- "name": "itemlist",
347
- "description": "Shows the selection as a list under the control as well as badges. (boolean)"
915
+ "name": "value",
916
+ "description": "The selected keys, comma separated, whether or not the select is multiple. A key given here is trimmed and cannot contain a comma; assign such a key through the property instead. The property answers a key for a single select and an array for a multiple one. (string)"
917
+ },
918
+ {
919
+ "name": "multiple",
920
+ "description": "Selects any number of options rather than one: the value is a comma separated list of keys and the selection renders as ful-badge chips. (boolean)"
921
+ },
922
+ {
923
+ "name": "item-list",
924
+ "description": "Shows the selection as a ful-item-list under the control as well, in addition to the field itself (the label for a single select, the ful-badge chips when multiple). (boolean)"
348
925
  }
349
926
  ]
350
927
  },
351
928
  {
352
929
  "name": "ful-dropdown",
353
- "description": "The options popup of a ful-select. Rarely used on its own.",
354
- "attributes": []
930
+ "description": "The options popup of a ful-select, with a localized no-results message when the search matches nothing. Rarely used on its own.",
931
+ "attributes": [
932
+ {
933
+ "name": "listbox",
934
+ "description": "The id to give the listbox, so a host can point aria-controls and aria-activedescendant at it before this element upgrades. (string)"
935
+ }
936
+ ]
355
937
  }
356
938
  ]
357
939
  }