docs: add missing JSDoc and type for time-picker unparsable-change event (#11300)

web-padawan · claude · web-flow · commit 2f4d02437add · 2026-03-10T13:37:42.000+02:00
Co-authored-by: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/packages/time-picker/src/vaadin-time-picker.d.ts b/packages/time-picker/src/vaadin-time-picker.d.ts
@@ -37,13 +37,20 @@ export type TimePickerValueChangedEvent = CustomEvent<{ value: string }>;
  */
 export type TimePickerValidatedEvent = CustomEvent<{ valid: boolean }>;
 
+/**
+ * Fired when the user commits an unparsable value change and there is no change event.
+ */
+export type TimePickerUnparsableChangeEvent = CustomEvent;
+
 export interface TimePickerCustomEventMap {
   'invalid-changed': TimePickerInvalidChangedEvent;
 
   'opened-changed': TimePickerOpenedChangedEvent;
 
   'value-changed': TimePickerValueChangedEvent;
 
+  'unparsable-change': TimePickerUnparsableChangeEvent;
+
   validated: TimePickerValidatedEvent;
 }
 
@@ -130,6 +137,7 @@ export interface TimePickerEventMap extends HTMLElementEventMap, TimePickerCusto
  * unparsable => unparsable | unparsable-change
  *
  * @fires {Event} change - Fired when the user commits a value change.
+ * @fires {Event} unparsable-change - Fired when the user commits an unparsable value change and there is no change event.
  * @fires {CustomEvent} invalid-changed - Fired when the `invalid` property changes.
  * @fires {CustomEvent} opened-changed - Fired when the `opened` property changes.
  * @fires {CustomEvent} value-changed - Fired when the `value` property changes.
diff --git a/packages/time-picker/src/vaadin-time-picker.js b/packages/time-picker/src/vaadin-time-picker.js
@@ -97,6 +97,7 @@ import { TimePickerMixin } from './vaadin-time-picker-mixin.js';
  * unparsable => unparsable | unparsable-change
  *
  * @fires {Event} change - Fired when the user commits a value change.
+ * @fires {Event} unparsable-change - Fired when the user commits an unparsable value change and there is no change event.
  * @fires {CustomEvent} invalid-changed - Fired when the `invalid` property changes.
  * @fires {CustomEvent} opened-changed - Fired when the `opened` property changes.
  * @fires {CustomEvent} value-changed - Fired when the `value` property changes.

Original file line number	Diff line number	Diff line change
`@@ -97,6 +97,7 @@ import { TimePickerMixin } from './vaadin-time-picker-mixin.js';`
`97`	`97`	`* unparsable => unparsable \| unparsable-change`
`98`	`98`	`*`
`99`	`99`	`* @fires {Event} change - Fired when the user commits a value change.`
	`100`	`+ * @fires {Event} unparsable-change - Fired when the user commits an unparsable value change and there is no change event.`
`100`	`101`	* @fires {CustomEvent} invalid-changed - Fired when the `invalid` property changes.
`101`	`102`	* @fires {CustomEvent} opened-changed - Fired when the `opened` property changes.
`102`	`103`	* @fires {CustomEvent} value-changed - Fired when the `value` property changes.