@optionfactory/fml 8.0.3 → 9.0.0-rc1

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 +1529 -435
  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 +5267 -2276
  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 +3677 -1378
  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 +3666 -1378
  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 +600 -58
  49. package/dist/web-types.json +1475 -380
  50. package/package.json +16 -8
@@ -2,22 +2,124 @@
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
+ ]
13
111
  },
14
112
  {
15
113
  "name": "ful-checkbox",
16
114
  "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
115
  "attributes": [
18
116
  {
19
- "name": "value",
20
- "description": "Checked when the attribute is the string true. (boolean)"
117
+ "name": "type",
118
+ "description": "switch renders the control as a switch rather than a checkbox. The value and the semantics are unchanged. (string)"
119
+ },
120
+ {
121
+ "name": "disabled",
122
+ "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
123
  },
22
124
  {
23
125
  "name": "readonly",
@@ -26,16 +128,44 @@
26
128
  {
27
129
  "name": "required",
28
130
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
131
+ },
132
+ {
133
+ "name": "value",
134
+ "description": "Checked when the attribute is the string true. (boolean)"
29
135
  }
30
136
  ]
31
137
  },
32
138
  {
33
139
  "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.",
140
+ "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
141
  "attributes": [
36
142
  {
37
- "name": "value",
38
- "description": "The current value. (string)"
143
+ "name": "type",
144
+ "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)"
145
+ },
146
+ {
147
+ "name": "v-type",
148
+ "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)"
149
+ },
150
+ {
151
+ "name": "keep",
152
+ "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)"
153
+ },
154
+ {
155
+ "name": "reject",
156
+ "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)"
157
+ },
158
+ {
159
+ "name": "uppercase",
160
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
161
+ },
162
+ {
163
+ "name": "trim",
164
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
165
+ },
166
+ {
167
+ "name": "disabled",
168
+ "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
169
  },
40
170
  {
41
171
  "name": "readonly",
@@ -45,6 +175,10 @@
45
175
  "name": "required",
46
176
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
47
177
  },
178
+ {
179
+ "name": "value",
180
+ "description": "The current value. (string)"
181
+ },
48
182
  {
49
183
  "name": "placeholder",
50
184
  "description": "Placeholder shown while the field is empty. (string)"
@@ -53,11 +187,35 @@
53
187
  },
54
188
  {
55
189
  "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.",
190
+ "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
191
  "attributes": [
58
192
  {
59
- "name": "value",
60
- "description": "Only an empty value is honoured, to clear the selection: file inputs cannot be filled programmatically. (string)"
193
+ "name": "type",
194
+ "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)"
195
+ },
196
+ {
197
+ "name": "v-type",
198
+ "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)"
199
+ },
200
+ {
201
+ "name": "keep",
202
+ "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)"
203
+ },
204
+ {
205
+ "name": "reject",
206
+ "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)"
207
+ },
208
+ {
209
+ "name": "uppercase",
210
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
211
+ },
212
+ {
213
+ "name": "trim",
214
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
215
+ },
216
+ {
217
+ "name": "disabled",
218
+ "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
219
  },
62
220
  {
63
221
  "name": "readonly",
@@ -67,20 +225,24 @@
67
225
  "name": "required",
68
226
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
69
227
  },
228
+ {
229
+ "name": "value",
230
+ "description": "Only an empty value is honoured, to clear the selection: file inputs cannot be filled programmatically. (string)"
231
+ },
70
232
  {
71
233
  "name": "placeholder",
72
234
  "description": "Placeholder shown while the field is empty. (string)"
73
235
  },
74
236
  {
75
237
  "name": "accept",
76
- "description": "Comma separated list of accepted extensions. Files that do not match are dropped with a warning. (string)"
238
+ "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
239
  },
78
240
  {
79
241
  "name": "multiple",
80
242
  "description": "Allows selecting more than one file. (boolean)"
81
243
  },
82
244
  {
83
- "name": "itemlist",
245
+ "name": "item-list",
84
246
  "description": "Shows the list of selected files. (boolean)"
85
247
  },
86
248
  {
@@ -88,36 +250,78 @@
88
250
  "description": "Shows the dropzone. (boolean)"
89
251
  },
90
252
  {
91
- "name": "maxfiles",
253
+ "name": "max-files",
92
254
  "description": "Maximum number of files. Exceeding it clears the selection. (number)"
93
255
  },
94
256
  {
95
- "name": "maxfilesize",
257
+ "name": "max-file-size",
96
258
  "description": "Maximum size of a single file, in bytes. Larger files are dropped. (number)"
97
259
  },
98
260
  {
99
- "name": "maxtotalsize",
261
+ "name": "max-total-size",
100
262
  "description": "Maximum size of all the selected files, in bytes. Exceeding it clears the selection. (number)"
101
263
  }
102
264
  ]
103
265
  },
104
266
  {
105
267
  "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": []
268
+ "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.",
269
+ "attributes": [
270
+ {
271
+ "name": "locale",
272
+ "description": "The locale the date is formatted in, taking precedence over the page's. The platform default applies when neither names one. (string)"
273
+ },
274
+ {
275
+ "name": "default",
276
+ "description": "The text rendered when the content is blank or does not parse as a date. (string)"
277
+ }
278
+ ]
108
279
  },
109
280
  {
110
281
  "name": "ful-instant",
111
- "description": "Formats the ISO instant in its content in the locale and timezone of the page.",
112
- "attributes": []
282
+ "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.",
283
+ "attributes": [
284
+ {
285
+ "name": "locale",
286
+ "description": "The locale the instant is formatted in, taking precedence over the page's. The platform default applies when neither names one. (string)"
287
+ },
288
+ {
289
+ "name": "default",
290
+ "description": "The text rendered when the content is blank or does not parse as an instant. (string)"
291
+ }
292
+ ]
113
293
  },
114
294
  {
115
295
  "name": "ful-input-local-date",
116
296
  "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
297
  "attributes": [
118
298
  {
119
- "name": "value",
120
- "description": "The current value. (string)"
299
+ "name": "type",
300
+ "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)"
301
+ },
302
+ {
303
+ "name": "v-type",
304
+ "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)"
305
+ },
306
+ {
307
+ "name": "keep",
308
+ "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)"
309
+ },
310
+ {
311
+ "name": "reject",
312
+ "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)"
313
+ },
314
+ {
315
+ "name": "uppercase",
316
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
317
+ },
318
+ {
319
+ "name": "trim",
320
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
321
+ },
322
+ {
323
+ "name": "disabled",
324
+ "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
325
  },
122
326
  {
123
327
  "name": "readonly",
@@ -127,10 +331,18 @@
127
331
  "name": "required",
128
332
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
129
333
  },
334
+ {
335
+ "name": "value",
336
+ "description": "The current value. (string)"
337
+ },
130
338
  {
131
339
  "name": "placeholder",
132
340
  "description": "Placeholder shown while the field is empty. (string)"
133
341
  },
342
+ {
343
+ "name": "step",
344
+ "description": "Step between selectable dates, in days. (string)"
345
+ },
134
346
  {
135
347
  "name": "min",
136
348
  "description": "Earliest selectable date. Accepts a date, now, or a day, month or year offset. (string)"
@@ -138,10 +350,6 @@
138
350
  {
139
351
  "name": "max",
140
352
  "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
353
  }
146
354
  ]
147
355
  },
@@ -150,8 +358,32 @@
150
358
  "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
359
  "attributes": [
152
360
  {
153
- "name": "value",
154
- "description": "The current value. (string)"
361
+ "name": "type",
362
+ "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)"
363
+ },
364
+ {
365
+ "name": "v-type",
366
+ "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)"
367
+ },
368
+ {
369
+ "name": "keep",
370
+ "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)"
371
+ },
372
+ {
373
+ "name": "reject",
374
+ "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)"
375
+ },
376
+ {
377
+ "name": "uppercase",
378
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
379
+ },
380
+ {
381
+ "name": "trim",
382
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
383
+ },
384
+ {
385
+ "name": "disabled",
386
+ "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
387
  },
156
388
  {
157
389
  "name": "readonly",
@@ -161,10 +393,18 @@
161
393
  "name": "required",
162
394
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
163
395
  },
396
+ {
397
+ "name": "value",
398
+ "description": "The current value. (string)"
399
+ },
164
400
  {
165
401
  "name": "placeholder",
166
402
  "description": "Placeholder shown while the field is empty. (string)"
167
403
  },
404
+ {
405
+ "name": "step",
406
+ "description": "Step between selectable times, in seconds. The bounds are truncated to this grid. (string)"
407
+ },
168
408
  {
169
409
  "name": "min",
170
410
  "description": "Earliest selectable time. Accepts a time, now, or an offset such as +2h or -30m. (string)"
@@ -172,10 +412,6 @@
172
412
  {
173
413
  "name": "max",
174
414
  "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
415
  }
180
416
  ]
181
417
  },
@@ -184,8 +420,32 @@
184
420
  "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
421
  "attributes": [
186
422
  {
187
- "name": "value",
188
- "description": "The current value. (string)"
423
+ "name": "type",
424
+ "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)"
425
+ },
426
+ {
427
+ "name": "v-type",
428
+ "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)"
429
+ },
430
+ {
431
+ "name": "keep",
432
+ "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)"
433
+ },
434
+ {
435
+ "name": "reject",
436
+ "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)"
437
+ },
438
+ {
439
+ "name": "uppercase",
440
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
441
+ },
442
+ {
443
+ "name": "trim",
444
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
445
+ },
446
+ {
447
+ "name": "disabled",
448
+ "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
449
  },
190
450
  {
191
451
  "name": "readonly",
@@ -195,10 +455,18 @@
195
455
  "name": "required",
196
456
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
197
457
  },
458
+ {
459
+ "name": "value",
460
+ "description": "The current value. (string)"
461
+ },
198
462
  {
199
463
  "name": "placeholder",
200
464
  "description": "Placeholder shown while the field is empty. (string)"
201
465
  },
466
+ {
467
+ "name": "step",
468
+ "description": "Step between selectable instants, in seconds. (string)"
469
+ },
202
470
  {
203
471
  "name": "min",
204
472
  "description": "Earliest selectable instant, as an ISO instant. (string)"
@@ -206,10 +474,6 @@
206
474
  {
207
475
  "name": "max",
208
476
  "description": "Latest selectable instant, as an ISO instant. (string)"
209
- },
210
- {
211
- "name": "step",
212
- "description": "Step between selectable instants, in seconds. (string)"
213
477
  }
214
478
  ]
215
479
  },
@@ -218,8 +482,16 @@
218
482
  "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
483
  "attributes": [
220
484
  {
221
- "name": "value",
222
- "description": "The value of the selected radio. (string)"
485
+ "name": "name",
486
+ "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)"
487
+ },
488
+ {
489
+ "name": "type",
490
+ "description": "boolean maps the two declared radios onto true and false rather than onto their own values. (string)"
491
+ },
492
+ {
493
+ "name": "disabled",
494
+ "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
495
  },
224
496
  {
225
497
  "name": "readonly",
@@ -228,18 +500,39 @@
228
500
  {
229
501
  "name": "required",
230
502
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
503
+ },
504
+ {
505
+ "name": "value",
506
+ "description": "The value of the selected radio. (string)"
231
507
  }
232
508
  ]
233
509
  },
234
510
  {
235
511
  "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": []
512
+ "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.",
513
+ "attributes": [
514
+ {
515
+ "name": "loader",
516
+ "description": "The registered component name the table loads its rows through; loaders:table when absent. (string)"
517
+ },
518
+ {
519
+ "name": "autoload",
520
+ "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)"
521
+ },
522
+ {
523
+ "name": "page-size",
524
+ "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)"
525
+ }
526
+ ]
238
527
  },
239
528
  {
240
529
  "name": "ful-pagination",
241
- "description": "The pager of a ful-table. Rarely used on its own.",
530
+ "description": "The pager of a ful-table, its window rendering at most pages links (5 by default). Rarely used on its own.",
242
531
  "attributes": [
532
+ {
533
+ "name": "pages",
534
+ "description": "How many page buttons are rendered around the current one, 5 by default. (number)"
535
+ },
243
536
  {
244
537
  "name": "total",
245
538
  "description": "Number of pages. (number)"
@@ -252,8 +545,12 @@
252
545
  },
253
546
  {
254
547
  "name": "ful-sorter",
255
- "description": "The sort control rendered in a ful-table header. Rarely used on its own.",
548
+ "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
549
  "attributes": [
550
+ {
551
+ "name": "sorter",
552
+ "description": "The field name this column sorts by, sent in the load request. A column without it is not sortable. (string)"
553
+ },
257
554
  {
258
555
  "name": "order",
259
556
  "description": "The sort currently applied, asc or desc, or absent when unsorted. (string)"
@@ -265,8 +562,32 @@
265
562
  "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
563
  "attributes": [
267
564
  {
268
- "name": "value",
269
- "description": "JSON tuple of the operator and its bounds, for example [\"BETWEEN\", from, to]. (string)"
565
+ "name": "type",
566
+ "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)"
567
+ },
568
+ {
569
+ "name": "v-type",
570
+ "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)"
571
+ },
572
+ {
573
+ "name": "keep",
574
+ "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)"
575
+ },
576
+ {
577
+ "name": "reject",
578
+ "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)"
579
+ },
580
+ {
581
+ "name": "uppercase",
582
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
583
+ },
584
+ {
585
+ "name": "trim",
586
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
587
+ },
588
+ {
589
+ "name": "disabled",
590
+ "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
591
  },
271
592
  {
272
593
  "name": "readonly",
@@ -276,9 +597,17 @@
276
597
  "name": "required",
277
598
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
278
599
  },
600
+ {
601
+ "name": "value",
602
+ "description": "JSON tuple of the operator and its bounds, for example [\"BETWEEN\", from, to]. (string)"
603
+ },
279
604
  {
280
605
  "name": "placeholder",
281
606
  "description": "Placeholder shown while the field is empty. (string)"
607
+ },
608
+ {
609
+ "name": "operators",
610
+ "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
611
  }
283
612
  ]
284
613
  },
@@ -286,10 +615,88 @@
286
615
  "name": "ful-filter-local-date",
287
616
  "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
617
  "attributes": [
618
+ {
619
+ "name": "type",
620
+ "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)"
621
+ },
622
+ {
623
+ "name": "v-type",
624
+ "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)"
625
+ },
626
+ {
627
+ "name": "keep",
628
+ "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)"
629
+ },
630
+ {
631
+ "name": "reject",
632
+ "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)"
633
+ },
634
+ {
635
+ "name": "uppercase",
636
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
637
+ },
638
+ {
639
+ "name": "trim",
640
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
641
+ },
642
+ {
643
+ "name": "disabled",
644
+ "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)"
645
+ },
646
+ {
647
+ "name": "readonly",
648
+ "description": "Renders the control but does not let it be edited. A readonly field still contributes its value to the form. (boolean)"
649
+ },
650
+ {
651
+ "name": "required",
652
+ "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
653
+ },
289
654
  {
290
655
  "name": "value",
291
656
  "description": "JSON tuple of the operator and its bounds, for example [\"BETWEEN\", from, to]. (string)"
292
657
  },
658
+ {
659
+ "name": "placeholder",
660
+ "description": "Placeholder shown while the field is empty. (string)"
661
+ },
662
+ {
663
+ "name": "operators",
664
+ "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)"
665
+ }
666
+ ]
667
+ },
668
+ {
669
+ "name": "ful-filter-number",
670
+ "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.",
671
+ "attributes": [
672
+ {
673
+ "name": "type",
674
+ "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)"
675
+ },
676
+ {
677
+ "name": "v-type",
678
+ "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)"
679
+ },
680
+ {
681
+ "name": "keep",
682
+ "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)"
683
+ },
684
+ {
685
+ "name": "reject",
686
+ "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)"
687
+ },
688
+ {
689
+ "name": "uppercase",
690
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
691
+ },
692
+ {
693
+ "name": "trim",
694
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
695
+ },
696
+ {
697
+ "name": "disabled",
698
+ "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)"
699
+ },
293
700
  {
294
701
  "name": "readonly",
295
702
  "description": "Renders the control but does not let it be edited. A readonly field still contributes its value to the form. (boolean)"
@@ -298,19 +705,77 @@
298
705
  "name": "required",
299
706
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
300
707
  },
708
+ {
709
+ "name": "value",
710
+ "description": "JSON tuple of the operator and its bound(s). (string)"
711
+ },
301
712
  {
302
713
  "name": "placeholder",
303
714
  "description": "Placeholder shown while the field is empty. (string)"
715
+ },
716
+ {
717
+ "name": "operators",
718
+ "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
719
  }
305
720
  ]
306
721
  },
307
722
  {
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.",
723
+ "name": "ful-filter-boolean",
724
+ "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
725
  "attributes": [
726
+ {
727
+ "name": "disabled",
728
+ "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)"
729
+ },
730
+ {
731
+ "name": "readonly",
732
+ "description": "Renders the control but does not let it be edited. A readonly field still contributes its value to the form. (boolean)"
733
+ },
734
+ {
735
+ "name": "required",
736
+ "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
737
+ },
311
738
  {
312
739
  "name": "value",
313
- "description": "JSON tuple of the operator, the sensitivity and the text. (string)"
740
+ "description": "JSON tuple of the operator and the token. (string)"
741
+ },
742
+ {
743
+ "name": "operators",
744
+ "description": "Comma separated list of the operators the menu offers, out of EQ, NEQ. Defaults to both. (string)"
745
+ }
746
+ ]
747
+ },
748
+ {
749
+ "name": "ful-filter-text",
750
+ "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.",
751
+ "attributes": [
752
+ {
753
+ "name": "type",
754
+ "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)"
755
+ },
756
+ {
757
+ "name": "v-type",
758
+ "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)"
759
+ },
760
+ {
761
+ "name": "keep",
762
+ "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)"
763
+ },
764
+ {
765
+ "name": "reject",
766
+ "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)"
767
+ },
768
+ {
769
+ "name": "uppercase",
770
+ "description": "Upper-cases the value on the way out, leaving what was typed alone. (boolean)"
771
+ },
772
+ {
773
+ "name": "trim",
774
+ "description": "Trims the value on the way out, leaving what was typed alone. (boolean)"
775
+ },
776
+ {
777
+ "name": "disabled",
778
+ "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
779
  },
315
780
  {
316
781
  "name": "readonly",
@@ -320,19 +785,83 @@
320
785
  "name": "required",
321
786
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
322
787
  },
788
+ {
789
+ "name": "value",
790
+ "description": "JSON tuple of the operator, the sensitivity and the text. (string)"
791
+ },
323
792
  {
324
793
  "name": "placeholder",
325
794
  "description": "Placeholder shown while the field is empty. (string)"
795
+ },
796
+ {
797
+ "name": "operators",
798
+ "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)"
799
+ },
800
+ {
801
+ "name": "sensitivities",
802
+ "description": "Comma separated list of the case sensitivity modes, IGNORE_CASE, CASE_SENSITIVE. A single entry pins every emitted tuple to it. (string)"
326
803
  }
327
804
  ]
328
805
  },
329
806
  {
330
807
  "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.",
808
+ "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
809
  "attributes": [
333
810
  {
334
- "name": "value",
335
- "description": "The selected key, or a comma separated list of keys when multiple. (string)"
811
+ "name": "name",
812
+ "description": "The field name the surrounding form submits the selection under. (string)"
813
+ },
814
+ {
815
+ "name": "loader",
816
+ "description": "The registered component name the select loads its vocabulary through; loaders:select when absent. (string)"
817
+ },
818
+ {
819
+ "name": "k-type",
820
+ "description": "How a key coerces when it arrives from the response or from the value attribute: number, string or bool. (string)"
821
+ },
822
+ {
823
+ "name": "src",
824
+ "description": "The url the vocabulary is fetched from. Without it the slotted <option> elements are the whole vocabulary, held in memory. (string)"
825
+ },
826
+ {
827
+ "name": "method",
828
+ "description": "The method the vocabulary is fetched with; POST when absent. (string)"
829
+ },
830
+ {
831
+ "name": "mode",
832
+ "description": "chunked asks the endpoint per query instead of fetching the vocabulary once, for a list too large to hold. (string)"
833
+ },
834
+ {
835
+ "name": "preload",
836
+ "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)"
837
+ },
838
+ {
839
+ "name": "revision",
840
+ "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)"
841
+ },
842
+ {
843
+ "name": "k-expr",
844
+ "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)"
845
+ },
846
+ {
847
+ "name": "l-expr",
848
+ "description": "The expression yielding an option's label, evaluated against each row of the response. (string)"
849
+ },
850
+ {
851
+ "name": "d-expr",
852
+ "description": "The expression yielding the rows from the response body; the body itself when absent. (string)"
853
+ },
854
+ {
855
+ "name": "m-expr",
856
+ "description": "The expression yielding an option's metadata, evaluated against each row; the whole row when absent. (string)"
857
+ },
858
+ {
859
+ "name": "response-mapper",
860
+ "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)"
861
+ },
862
+ {
863
+ "name": "disabled",
864
+ "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
865
  },
337
866
  {
338
867
  "name": "readonly",
@@ -343,15 +872,28 @@
343
872
  "description": "Marks the field as required for assistive technologies and shows the required marker on its label. (boolean)"
344
873
  },
345
874
  {
346
- "name": "itemlist",
347
- "description": "Shows the selection as a list under the control as well as badges. (boolean)"
875
+ "name": "value",
876
+ "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)"
877
+ },
878
+ {
879
+ "name": "multiple",
880
+ "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)"
881
+ },
882
+ {
883
+ "name": "item-list",
884
+ "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
885
  }
349
886
  ]
350
887
  },
351
888
  {
352
889
  "name": "ful-dropdown",
353
- "description": "The options popup of a ful-select. Rarely used on its own.",
354
- "attributes": []
890
+ "description": "The options popup of a ful-select, with a localized no-results message when the search matches nothing. Rarely used on its own.",
891
+ "attributes": [
892
+ {
893
+ "name": "listbox",
894
+ "description": "The id to give the listbox, so a host can point aria-controls and aria-activedescendant at it before this element upgrades. (string)"
895
+ }
896
+ ]
355
897
  }
356
898
  ]
357
899
  }