@vaadin/date-picker 25.1.2 → 25.2.0-alpha10

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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/web-types",
3
3
  "name": "@vaadin/date-picker",
4
- "version": "25.1.2",
4
+ "version": "25.2.0-alpha10",
5
5
  "description-markup": "markdown",
6
6
  "framework": "lit",
7
7
  "framework-config": {
@@ -20,169 +20,169 @@
20
20
  "extension": true,
21
21
  "attributes": [
22
22
  {
23
- "name": "?autofocus",
24
- "description": "Specify that this control should have input focus when the page loads.",
23
+ "name": ".accessibleName",
24
+ "description": "String used to label the component to screen reader users.",
25
25
  "value": {
26
26
  "kind": "expression"
27
27
  }
28
28
  },
29
29
  {
30
- "name": "?autoOpenDisabled",
31
- "description": "Set true to prevent the overlay from opening automatically.",
30
+ "name": ".accessibleNameRef",
31
+ "description": "Id of the element used as label of the component to screen reader users.",
32
32
  "value": {
33
33
  "kind": "expression"
34
34
  }
35
35
  },
36
36
  {
37
- "name": "?autoselect",
38
- "description": "If true, the input text gets fully selected when the field is focused using click or touch / tap.",
37
+ "name": ".allowedCharPattern",
38
+ "description": "A pattern matched against individual characters the user inputs.\n\nWhen set, the field will prevent:\n- `keydown` events if the entered key doesn't match `/^allowedCharPattern$/`\n- `paste` events if the pasted text doesn't match `/^allowedCharPattern*$/`\n- `drop` events if the dropped text doesn't match `/^allowedCharPattern*$/`\n\nFor example, to allow entering only numbers and minus signs, use:\n`allowedCharPattern = \"[\\\\d-]\"`",
39
39
  "value": {
40
40
  "kind": "expression"
41
41
  }
42
42
  },
43
43
  {
44
- "name": "?clearButtonVisible",
45
- "description": "Set to true to display the clear icon which clears the input.\n\nIt is up to the component to choose where to place the clear icon:\nin the Shadow DOM or in the light DOM. In any way, a reference to\nthe clear icon element should be provided via the `clearElement` getter.",
44
+ "name": "?autofocus",
45
+ "description": "Specify that this control should have input focus when the page loads.",
46
46
  "value": {
47
47
  "kind": "expression"
48
48
  }
49
49
  },
50
50
  {
51
- "name": "?disabled",
52
- "description": "If true, the user cannot interact with this element.",
51
+ "name": "?autoOpenDisabled",
52
+ "description": "Set true to prevent the overlay from opening automatically.",
53
53
  "value": {
54
54
  "kind": "expression"
55
55
  }
56
56
  },
57
57
  {
58
- "name": "?invalid",
59
- "description": "Set to true when the field is invalid.",
58
+ "name": "?autoselect",
59
+ "description": "If true, the input text gets fully selected when the field is focused using click or touch / tap.",
60
60
  "value": {
61
61
  "kind": "expression"
62
62
  }
63
63
  },
64
64
  {
65
- "name": "?isDateDisabled",
66
- "description": "A function to be used to determine whether the user can select a given date.\nReceives a `DatePickerDate` object of the date to be selected and should return a\nboolean.",
65
+ "name": "?clearButtonVisible",
66
+ "description": "Set to true to display the clear icon which clears the input.\n\nIt is up to the component to choose where to place the clear icon:\nin the Shadow DOM or in the light DOM. In any way, a reference to\nthe clear icon element should be provided via the `clearElement` getter.",
67
67
  "value": {
68
68
  "kind": "expression"
69
69
  }
70
70
  },
71
71
  {
72
- "name": "?manualValidation",
73
- "description": "Set to true to enable manual validation mode. This mode disables automatic\nconstraint validation, allowing you to control the validation process yourself.\nYou can still trigger constraint validation manually with the `validate()` method\nor use `checkValidity()` to assess the component's validity without affecting\nthe invalid state. In manual validation mode, you can also manipulate\nthe `invalid` property directly through your application logic without conflicts\nwith the component's internal validation.",
72
+ "name": "?disabled",
73
+ "description": "If true, the user cannot interact with this element.",
74
74
  "value": {
75
75
  "kind": "expression"
76
76
  }
77
77
  },
78
78
  {
79
- "name": "?opened",
80
- "description": "Set true to open the date selector overlay.",
79
+ "name": ".errorMessage",
80
+ "description": "Error to show when the field is invalid.",
81
81
  "value": {
82
82
  "kind": "expression"
83
83
  }
84
84
  },
85
85
  {
86
- "name": "?readonly",
87
- "description": "When present, it specifies that the field is read-only.",
86
+ "name": ".helperText",
87
+ "description": "String used for the helper text.",
88
88
  "value": {
89
89
  "kind": "expression"
90
90
  }
91
91
  },
92
92
  {
93
- "name": "?required",
94
- "description": "Specifies that the user must fill in a value.",
93
+ "name": ".i18n",
94
+ "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nThe object has the following JSON structure and default values:\n\n```js\n{\n // An array with the full names of months starting\n // with January.\n monthNames: [\n 'January', 'February', 'March', 'April', 'May',\n 'June', 'July', 'August', 'September',\n 'October', 'November', 'December'\n ],\n\n // An array of weekday names starting with Sunday. Used\n // in screen reader announcements.\n weekdays: [\n 'Sunday', 'Monday', 'Tuesday', 'Wednesday',\n 'Thursday', 'Friday', 'Saturday'\n ],\n\n // An array of short weekday names starting with Sunday.\n // Displayed in the calendar.\n weekdaysShort: [\n 'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'\n ],\n\n // An integer indicating the first day of the week\n // (0 = Sunday, 1 = Monday, etc.).\n firstDayOfWeek: 0,\n\n // Translation of the Today shortcut button text.\n today: 'Today',\n\n // Translation of the Cancel button text.\n cancel: 'Cancel',\n\n // Used for adjusting the year value when parsing dates with short years.\n // The year values between 0 and 99 are evaluated and adjusted.\n // Example: for a referenceDate of 1970-10-30;\n // dateToBeParsed: 40-10-30, result: 1940-10-30\n // dateToBeParsed: 80-10-30, result: 1980-10-30\n // dateToBeParsed: 10-10-30, result: 2010-10-30\n // Supported date format: ISO 8601 `\"YYYY-MM-DD\"` (default)\n // The default value is the current date.\n referenceDate: '',\n\n // A function to format given `Object` as\n // date string. Object is in the format `{ day: ..., month: ..., year: ... }`\n // Note: The argument month is 0-based. This means that January = 0 and December = 11.\n formatDate: d => {\n // returns a string representation of the given\n // object in 'MM/DD/YYYY' -format\n },\n\n // A function to parse the given text to an `Object` in the format `{ day: ..., month: ..., year: ... }`.\n // Must properly parse (at least) text formatted by `formatDate`.\n // Setting the property to null will disable keyboard input feature.\n // Note: The argument month is 0-based. This means that January = 0 and December = 11.\n parseDate: text => {\n // Parses a string in 'MM/DD/YY', 'MM/DD' or 'DD' -format to\n // an `Object` in the format `{ day: ..., month: ..., year: ... }`.\n }\n\n // A function to format given `monthName` and\n // `fullYear` integer as calendar title string.\n formatTitle: (monthName, fullYear) => {\n return monthName + ' ' + fullYear;\n }\n}\n```",
95
95
  "value": {
96
96
  "kind": "expression"
97
97
  }
98
98
  },
99
99
  {
100
- "name": "?showWeekNumbers",
101
- "description": "Set true to display ISO-8601 week numbers in the calendar. Notice that\ndisplaying week numbers is only supported when `i18n.firstDayOfWeek`\nis 1 (Monday).",
100
+ "name": ".initialPosition",
101
+ "description": "Date which should be visible when there is no value selected.\n\nThe same date formats as for the `value` property are supported.",
102
102
  "value": {
103
103
  "kind": "expression"
104
104
  }
105
105
  },
106
106
  {
107
- "name": ".accessibleName",
108
- "description": "String used to label the component to screen reader users.",
107
+ "name": "?invalid",
108
+ "description": "Set to true when the field is invalid.",
109
109
  "value": {
110
110
  "kind": "expression"
111
111
  }
112
112
  },
113
113
  {
114
- "name": ".accessibleNameRef",
115
- "description": "Id of the element used as label of the component to screen reader users.",
114
+ "name": ".isDateDisabled",
115
+ "description": "A function to be used to determine whether the user can select a given date.\nReceives a `DatePickerDate` object of the date to be selected and should return a\nboolean.",
116
116
  "value": {
117
117
  "kind": "expression"
118
118
  }
119
119
  },
120
120
  {
121
- "name": ".allowedCharPattern",
122
- "description": "A pattern matched against individual characters the user inputs.\n\nWhen set, the field will prevent:\n- `keydown` events if the entered key doesn't match `/^allowedCharPattern$/`\n- `paste` events if the pasted text doesn't match `/^allowedCharPattern*$/`\n- `drop` events if the dropped text doesn't match `/^allowedCharPattern*$/`\n\nFor example, to allow entering only numbers and minus signs, use:\n`allowedCharPattern = \"[\\\\d-]\"`",
121
+ "name": ".label",
122
+ "description": "The label text for the input node.\nWhen no light dom defined via [slot=label], this value will be used.",
123
123
  "value": {
124
124
  "kind": "expression"
125
125
  }
126
126
  },
127
127
  {
128
- "name": ".errorMessage",
129
- "description": "Error to show when the field is invalid.",
128
+ "name": "?manualValidation",
129
+ "description": "Set to true to enable manual validation mode. This mode disables automatic\nconstraint validation, allowing you to control the validation process yourself.\nYou can still trigger constraint validation manually with the `validate()` method\nor use `checkValidity()` to assess the component's validity without affecting\nthe invalid state. In manual validation mode, you can also manipulate\nthe `invalid` property directly through your application logic without conflicts\nwith the component's internal validation.",
130
130
  "value": {
131
131
  "kind": "expression"
132
132
  }
133
133
  },
134
134
  {
135
- "name": ".helperText",
136
- "description": "String used for the helper text.",
135
+ "name": ".max",
136
+ "description": "The latest date that can be selected. All later dates will be disabled.\n\nSupported date formats:\n- ISO 8601 `\"YYYY-MM-DD\"` (default)\n- 6-digit extended ISO 8601 `\"+YYYYYY-MM-DD\"`, `\"-YYYYYY-MM-DD\"`",
137
137
  "value": {
138
138
  "kind": "expression"
139
139
  }
140
140
  },
141
141
  {
142
- "name": ".i18n",
143
- "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nThe object has the following JSON structure and default values:\n\n```js\n{\n // An array with the full names of months starting\n // with January.\n monthNames: [\n 'January', 'February', 'March', 'April', 'May',\n 'June', 'July', 'August', 'September',\n 'October', 'November', 'December'\n ],\n\n // An array of weekday names starting with Sunday. Used\n // in screen reader announcements.\n weekdays: [\n 'Sunday', 'Monday', 'Tuesday', 'Wednesday',\n 'Thursday', 'Friday', 'Saturday'\n ],\n\n // An array of short weekday names starting with Sunday.\n // Displayed in the calendar.\n weekdaysShort: [\n 'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'\n ],\n\n // An integer indicating the first day of the week\n // (0 = Sunday, 1 = Monday, etc.).\n firstDayOfWeek: 0,\n\n // Translation of the Today shortcut button text.\n today: 'Today',\n\n // Translation of the Cancel button text.\n cancel: 'Cancel',\n\n // Used for adjusting the year value when parsing dates with short years.\n // The year values between 0 and 99 are evaluated and adjusted.\n // Example: for a referenceDate of 1970-10-30;\n // dateToBeParsed: 40-10-30, result: 1940-10-30\n // dateToBeParsed: 80-10-30, result: 1980-10-30\n // dateToBeParsed: 10-10-30, result: 2010-10-30\n // Supported date format: ISO 8601 `\"YYYY-MM-DD\"` (default)\n // The default value is the current date.\n referenceDate: '',\n\n // A function to format given `Object` as\n // date string. Object is in the format `{ day: ..., month: ..., year: ... }`\n // Note: The argument month is 0-based. This means that January = 0 and December = 11.\n formatDate: d => {\n // returns a string representation of the given\n // object in 'MM/DD/YYYY' -format\n },\n\n // A function to parse the given text to an `Object` in the format `{ day: ..., month: ..., year: ... }`.\n // Must properly parse (at least) text formatted by `formatDate`.\n // Setting the property to null will disable keyboard input feature.\n // Note: The argument month is 0-based. This means that January = 0 and December = 11.\n parseDate: text => {\n // Parses a string in 'MM/DD/YY', 'MM/DD' or 'DD' -format to\n // an `Object` in the format `{ day: ..., month: ..., year: ... }`.\n }\n\n // A function to format given `monthName` and\n // `fullYear` integer as calendar title string.\n formatTitle: (monthName, fullYear) => {\n return monthName + ' ' + fullYear;\n }\n}\n```",
142
+ "name": ".min",
143
+ "description": "The earliest date that can be selected. All earlier dates will be disabled.\n\nSupported date formats:\n- ISO 8601 `\"YYYY-MM-DD\"` (default)\n- 6-digit extended ISO 8601 `\"+YYYYYY-MM-DD\"`, `\"-YYYYYY-MM-DD\"`",
144
144
  "value": {
145
145
  "kind": "expression"
146
146
  }
147
147
  },
148
148
  {
149
- "name": ".initialPosition",
150
- "description": "Date which should be visible when there is no value selected.\n\nThe same date formats as for the `value` property are supported.",
149
+ "name": ".name",
150
+ "description": "The name of this field.",
151
151
  "value": {
152
152
  "kind": "expression"
153
153
  }
154
154
  },
155
155
  {
156
- "name": ".label",
157
- "description": "The label text for the input node.\nWhen no light dom defined via [slot=label], this value will be used.",
156
+ "name": "?opened",
157
+ "description": "Set true to open the date selector overlay.",
158
158
  "value": {
159
159
  "kind": "expression"
160
160
  }
161
161
  },
162
162
  {
163
- "name": ".max",
164
- "description": "The latest date that can be selected. All later dates will be disabled.\n\nSupported date formats:\n- ISO 8601 `\"YYYY-MM-DD\"` (default)\n- 6-digit extended ISO 8601 `\"+YYYYYY-MM-DD\"`, `\"-YYYYYY-MM-DD\"`",
163
+ "name": ".placeholder",
164
+ "description": "A hint to the user of what can be entered in the field.",
165
165
  "value": {
166
166
  "kind": "expression"
167
167
  }
168
168
  },
169
169
  {
170
- "name": ".min",
171
- "description": "The earliest date that can be selected. All earlier dates will be disabled.\n\nSupported date formats:\n- ISO 8601 `\"YYYY-MM-DD\"` (default)\n- 6-digit extended ISO 8601 `\"+YYYYYY-MM-DD\"`, `\"-YYYYYY-MM-DD\"`",
170
+ "name": "?readonly",
171
+ "description": "When present, it specifies that the field is read-only.",
172
172
  "value": {
173
173
  "kind": "expression"
174
174
  }
175
175
  },
176
176
  {
177
- "name": ".name",
178
- "description": "The name of this field.",
177
+ "name": "?required",
178
+ "description": "Specifies that the user must fill in a value.",
179
179
  "value": {
180
180
  "kind": "expression"
181
181
  }
182
182
  },
183
183
  {
184
- "name": ".placeholder",
185
- "description": "A hint to the user of what can be entered in the field.",
184
+ "name": "?showWeekNumbers",
185
+ "description": "Set true to display ISO-8601 week numbers in the calendar. Notice that\ndisplaying week numbers is only supported when `i18n.firstDayOfWeek`\nis 1 (Monday).",
186
186
  "value": {
187
187
  "kind": "expression"
188
188
  }
@@ -209,22 +209,22 @@
209
209
  }
210
210
  },
211
211
  {
212
- "name": "@input",
213
- "description": "Fired when the value is changed by the user: on every typing keystroke,\nand the value is cleared using the clear button.",
212
+ "name": "@invalid-changed",
213
+ "description": "Fired when the `invalid` property changes.",
214
214
  "value": {
215
215
  "kind": "expression"
216
216
  }
217
217
  },
218
218
  {
219
- "name": "@invalid-changed",
220
- "description": "Fired when the `invalid` property changes.",
219
+ "name": "@opened-changed",
220
+ "description": "Fired when the `opened` property changes.",
221
221
  "value": {
222
222
  "kind": "expression"
223
223
  }
224
224
  },
225
225
  {
226
- "name": "@opened-changed",
227
- "description": "Fired when `opened` property value changes.",
226
+ "name": "@unparsable-change",
227
+ "description": "Fired when the user commits an unparsable value change and there is no change event.",
228
228
  "value": {
229
229
  "kind": "expression"
230
230
  }
@@ -238,7 +238,7 @@
238
238
  },
239
239
  {
240
240
  "name": "@value-changed",
241
- "description": "Fired when `value` property value changes.",
241
+ "description": "Fired when the `value` property changes.",
242
242
  "value": {
243
243
  "kind": "expression"
244
244
  }