@bryntum/scheduler-vue-3-thin 7.3.0 → 7.3.1

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 (51) hide show
  1. package/README.md +8 -8
  2. package/lib/chunks/{DVFhf2Ma.js → BTSObfAz.js} +6 -4
  3. package/lib/chunks/BTSObfAz.js.map +1 -0
  4. package/lib/chunks/BXIuEgYD.js.map +1 -1
  5. package/lib/chunks/{DhhzgoYL.js → CCTV8qn0.js} +3 -1
  6. package/lib/chunks/CCTV8qn0.js.map +1 -0
  7. package/lib/chunks/{kN-s_8Na.js → COFzBhB8.js} +8 -6
  8. package/lib/chunks/COFzBhB8.js.map +1 -0
  9. package/lib/chunks/DB0UHrA3.js.map +1 -1
  10. package/lib/chunks/{5o-YjSb7.js → DJSlX0qP.js} +3 -1
  11. package/lib/chunks/DJSlX0qP.js.map +1 -0
  12. package/lib/chunks/DP61St-u.js.map +1 -1
  13. package/lib/chunks/{ZkU6CtWX.js → LNqNYJck.js} +9 -7
  14. package/lib/chunks/LNqNYJck.js.map +1 -0
  15. package/lib/chunks/R69sJLmF.js.map +1 -1
  16. package/lib/chunks/{OJaN5ZWK.js → WykRcMCN.js} +6 -4
  17. package/lib/chunks/WykRcMCN.js.map +1 -0
  18. package/lib/chunks/eUISgYXE.js.map +1 -1
  19. package/lib/chunks/t8aiH3XL.js.map +1 -1
  20. package/lib/components/BryntumEventColorField.js +1 -1
  21. package/lib/components/BryntumProjectCombo.js +1 -1
  22. package/lib/components/BryntumResourceCombo.js +1 -1
  23. package/lib/components/BryntumScheduler.js +1 -1
  24. package/lib/components/BryntumSchedulerBase.js +1 -1
  25. package/lib/components/BryntumViewPresetCombo.js +1 -1
  26. package/lib/index.js +6 -6
  27. package/package.json +1 -1
  28. package/src/components/BryntumEventColorField.vue +80 -106
  29. package/src/components/BryntumEventColorFieldProps.ts +9 -0
  30. package/src/components/BryntumProjectCombo.vue +81 -109
  31. package/src/components/BryntumProjectComboProps.ts +9 -0
  32. package/src/components/BryntumResourceCombo.vue +81 -109
  33. package/src/components/BryntumResourceComboProps.ts +9 -0
  34. package/src/components/BryntumResourceFilter.vue +69 -107
  35. package/src/components/BryntumScheduler.vue +1425 -1927
  36. package/src/components/BryntumSchedulerBase.vue +1425 -1927
  37. package/src/components/BryntumSchedulerBaseProps.ts +5 -0
  38. package/src/components/BryntumSchedulerDatePicker.vue +85 -135
  39. package/src/components/BryntumSchedulerProjectModel.vue +11 -15
  40. package/src/components/BryntumSchedulerProps.ts +5 -0
  41. package/src/components/BryntumTimeZoomSlider.vue +50 -80
  42. package/src/components/BryntumTimelineHistogram.vue +722 -1030
  43. package/src/components/BryntumUndoRedo.vue +49 -79
  44. package/src/components/BryntumViewPresetCombo.vue +77 -103
  45. package/src/components/BryntumViewPresetComboProps.ts +9 -0
  46. package/lib/chunks/5o-YjSb7.js.map +0 -1
  47. package/lib/chunks/DVFhf2Ma.js.map +0 -1
  48. package/lib/chunks/DhhzgoYL.js.map +0 -1
  49. package/lib/chunks/OJaN5ZWK.js.map +0 -1
  50. package/lib/chunks/ZkU6CtWX.js.map +0 -1
  51. package/lib/chunks/kN-s_8Na.js.map +0 -1
@@ -556,42 +556,34 @@ const emit = defineEmits<{
556
556
  * Fires before an object is destroyed.
557
557
  * @param {string} e Event name
558
558
  * @param {object} params Event parameters
559
- * @param {string} params.e Event name
560
- * @param {object} params.params Event parameters
561
- * @param {object} params.params.event Event object
562
- * @param {Core.Base} params.params.event.source The Object that is being destroyed.
559
+ * @param {object} params.event Event object
560
+ * @param {Core.Base} params.event.source The Object that is being destroyed.
563
561
  */
564
562
  (e: 'beforeDestroy', params: ((event: { source: Base }) => void)|string): void
565
563
  /**
566
564
  * Triggered before a widget is hidden. Return `false` to prevent the action.
567
565
  * @param {string} e Event name
568
566
  * @param {object} params Event parameters
569
- * @param {string} params.e Event name
570
- * @param {object} params.params Event parameters
571
- * @param {object} params.params.event Event object
572
- * @param {Core.widget.Widget} params.params.event.source The widget being hidden.
567
+ * @param {object} params.event Event object
568
+ * @param {Core.widget.Widget} params.event.source The widget being hidden.
573
569
  */
574
- (e: 'beforeHide', params: ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
570
+ (e: 'beforeHide', params: ((event: { source: Widget }) => boolean|void)|string): boolean|void
575
571
  /**
576
572
  * Fired before this container will load record values into its child fields. This is useful if you
577
573
  * want to modify the UI before data is loaded (e.g. set some input field to be readonly)
578
574
  * @param {string} e Event name
579
575
  * @param {object} params Event parameters
580
- * @param {string} params.e Event name
581
- * @param {object} params.params Event parameters
582
- * @param {object} params.params.event Event object
583
- * @param {Core.widget.Container} params.params.event.source The container
584
- * @param {Core.data.Model} params.params.event.record The record
576
+ * @param {object} params.event Event object
577
+ * @param {Core.widget.Container} params.event.source The container
578
+ * @param {Core.data.Model} params.event.record The record
585
579
  */
586
580
  (e: 'beforeSetRecord', params: ((event: { source: Container, record: Model }) => void)|string): void
587
581
  /**
588
582
  * Triggered before a widget is shown. Return `false` to prevent the action.
589
583
  * @param {string} e Event name
590
584
  * @param {object} params Event parameters
591
- * @param {string} params.e Event name
592
- * @param {object} params.params Event parameters
593
- * @param {object} params.params.event Event object
594
- * @param {Core.widget.Widget,any} params.params.event.source The widget being shown
585
+ * @param {object} params.event Event object
586
+ * @param {Core.widget.Widget,any} params.event.source The widget being shown
595
587
  */
596
588
  (e: 'beforeShow', params: ((event: { source: Widget|any }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
597
589
  /**
@@ -599,57 +591,47 @@ const emit = defineEmits<{
599
591
  * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/UndoRedo#event-catchAll)
600
592
  * @param {string} e Event name
601
593
  * @param {object} params Event parameters
602
- * @param {string} params.e Event name
603
- * @param {object} params.params Event parameters
604
- * @param {object} params.params.event Event object
605
- * @param {{[key: string]: any, type: string}} params.params.event.event The Object that contains event details
606
- * @param {string} params.params.event.event.type The type of the event which is caught by the listener
594
+ * @param {object} params.event Event object
595
+ * @param {{[key: string]: any, type: string}} params.event.event The Object that contains event details
596
+ * @param {string} params.event.event.type The type of the event which is caught by the listener
607
597
  */
608
598
  (e: 'catchAll', params: ((event: {[key: string]: any, type: string}) => void)|string): void
609
599
  /**
610
600
  * Fires when an object is destroyed.
611
601
  * @param {string} e Event name
612
602
  * @param {object} params Event parameters
613
- * @param {string} params.e Event name
614
- * @param {object} params.params Event parameters
615
- * @param {object} params.params.event Event object
616
- * @param {Core.Base} params.params.event.source The Object that is being destroyed.
603
+ * @param {object} params.event Event object
604
+ * @param {Core.Base} params.event.source The Object that is being destroyed.
617
605
  */
618
606
  (e: 'destroy', params: ((event: { source: Base }) => void)|string): void
619
607
  /**
620
608
  * Fires when a field is mutated and the state of the [hasChanges](https://bryntum.com/products/scheduler/docs/api/Core/widget/Container#property-hasChanges) property changes
621
609
  * @param {string} e Event name
622
610
  * @param {object} params Event parameters
623
- * @param {string} params.e Event name
624
- * @param {object} params.params Event parameters
625
- * @param {object} params.params.event Event object
626
- * @param {Core.widget.Container} params.params.event.source The container.
627
- * @param {boolean} params.params.event.dirty The dirty state of the Container - `true` if there are any fields which have been changed since initial load.
611
+ * @param {object} params.event Event object
612
+ * @param {Core.widget.Container} params.event.source The container.
613
+ * @param {boolean} params.event.dirty The dirty state of the Container - `true` if there are any fields which have been changed since initial load.
628
614
  */
629
615
  (e: 'dirtyStateChange', params: ((event: { source: Container, dirty: boolean }) => void)|string): void
630
616
  /**
631
617
  * Triggered when a widget's [element](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#property-element) is available.
632
618
  * @param {string} e Event name
633
619
  * @param {object} params Event parameters
634
- * @param {string} params.e Event name
635
- * @param {object} params.params Event parameters
636
- * @param {object} params.params.event Event object
637
- * @param {HTMLElement} params.params.event.element The Widget's element.
620
+ * @param {object} params.event Event object
621
+ * @param {HTMLElement} params.event.element The Widget's element.
638
622
  */
639
623
  (e: 'elementCreated', params: ((event: { element: HTMLElement }) => void)|string): void
640
624
  /**
641
625
  * Fired when focus enters this Widget.
642
626
  * @param {string} e Event name
643
627
  * @param {object} params Event parameters
644
- * @param {string} params.e Event name
645
- * @param {object} params.params Event parameters
646
- * @param {object} params.params.event Event object
647
- * @param {Core.widget.Widget} params.params.event.source This Widget
648
- * @param {HTMLElement} params.params.event.fromElement The element which lost focus.
649
- * @param {HTMLElement} params.params.event.toElement The element which gained focus.
650
- * @param {Core.widget.Widget} params.params.event.fromWidget The widget which lost focus.
651
- * @param {Core.widget.Widget} params.params.event.toWidget The widget which gained focus.
652
- * @param {boolean} params.params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
628
+ * @param {object} params.event Event object
629
+ * @param {Core.widget.Widget} params.event.source This Widget
630
+ * @param {HTMLElement} params.event.fromElement The element which lost focus.
631
+ * @param {HTMLElement} params.event.toElement The element which gained focus.
632
+ * @param {Core.widget.Widget} params.event.fromWidget The widget which lost focus.
633
+ * @param {Core.widget.Widget} params.event.toWidget The widget which gained focus.
634
+ * @param {boolean} params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
653
635
  */
654
636
  (e: 'focusIn', params: ((event: { source: Widget, fromElement: HTMLElement, toElement: HTMLElement, fromWidget: Widget, toWidget: Widget, backwards: boolean }) => void)|string): void
655
637
  /**
@@ -658,25 +640,21 @@ const emit = defineEmits<{
658
640
  * will not trigger this event. This is when focus exits this widget completely.
659
641
  * @param {string} e Event name
660
642
  * @param {object} params Event parameters
661
- * @param {string} params.e Event name
662
- * @param {object} params.params Event parameters
663
- * @param {object} params.params.event Event object
664
- * @param {Core.widget.Widget} params.params.event.source This Widget
665
- * @param {HTMLElement} params.params.event.fromElement The element which lost focus.
666
- * @param {HTMLElement} params.params.event.toElement The element which gained focus.
667
- * @param {Core.widget.Widget} params.params.event.fromWidget The widget which lost focus.
668
- * @param {Core.widget.Widget} params.params.event.toWidget The widget which gained focus.
669
- * @param {boolean} params.params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
643
+ * @param {object} params.event Event object
644
+ * @param {Core.widget.Widget} params.event.source This Widget
645
+ * @param {HTMLElement} params.event.fromElement The element which lost focus.
646
+ * @param {HTMLElement} params.event.toElement The element which gained focus.
647
+ * @param {Core.widget.Widget} params.event.fromWidget The widget which lost focus.
648
+ * @param {Core.widget.Widget} params.event.toWidget The widget which gained focus.
649
+ * @param {boolean} params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
670
650
  */
671
651
  (e: 'focusOut', params: ((event: { source: Widget, fromElement: HTMLElement, toElement: HTMLElement, fromWidget: Widget, toWidget: Widget, backwards: boolean }) => void)|string): void
672
652
  /**
673
653
  * Triggered after a widget was hidden
674
654
  * @param {string} e Event name
675
655
  * @param {object} params Event parameters
676
- * @param {string} params.e Event name
677
- * @param {object} params.params Event parameters
678
- * @param {object} params.params.event Event object
679
- * @param {Core.widget.Widget} params.params.event.source The widget
656
+ * @param {object} params.event Event object
657
+ * @param {Core.widget.Widget} params.event.source The widget
680
658
  */
681
659
  (e: 'hide', params: ((event: { source: Widget }) => void)|string): void
682
660
  /**
@@ -685,21 +663,17 @@ const emit = defineEmits<{
685
663
  * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/UndoRedo#event-paint)
686
664
  * @param {string} e Event name
687
665
  * @param {object} params Event parameters
688
- * @param {string} params.e Event name
689
- * @param {object} params.params Event parameters
690
- * @param {object} params.params.event Event object
691
- * @param {Core.widget.Widget} params.params.event.source The widget being painted.
692
- * @param {boolean} params.params.event.firstPaint `true` if this is the first paint.
666
+ * @param {object} params.event Event object
667
+ * @param {Core.widget.Widget} params.event.source The widget being painted.
668
+ * @param {boolean} params.event.firstPaint `true` if this is the first paint.
693
669
  */
694
670
  (e: 'paint', params: ((event: { source: Widget, firstPaint: boolean }) => void)|string): void
695
671
  /**
696
672
  * Fired when a Widget's read only state is toggled
697
673
  * @param {string} e Event name
698
674
  * @param {object} params Event parameters
699
- * @param {string} params.e Event name
700
- * @param {object} params.params Event parameters
701
- * @param {object} params.params.event Event object
702
- * @param {boolean} params.params.event.readOnly Read only or not
675
+ * @param {object} params.event Event object
676
+ * @param {boolean} params.event.readOnly Read only or not
703
677
  */
704
678
  (e: 'readOnly', params: ((event: { readOnly: boolean }) => void)|string): void
705
679
  /**
@@ -711,24 +685,20 @@ const emit = defineEmits<{
711
685
  * Fired when the encapsulating element of a Widget resizes *only when [monitorResize](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-monitorResize) is `true`*.
712
686
  * @param {string} e Event name
713
687
  * @param {object} params Event parameters
714
- * @param {string} params.e Event name
715
- * @param {object} params.params Event parameters
716
- * @param {object} params.params.event Event object
717
- * @param {Core.widget.Widget} params.params.event.source This Widget
718
- * @param {number} params.params.event.width The new width
719
- * @param {number} params.params.event.height The new height
720
- * @param {number} params.params.event.oldWidth The old width
721
- * @param {number} params.params.event.oldHeight The old height
688
+ * @param {object} params.event Event object
689
+ * @param {Core.widget.Widget} params.event.source This Widget
690
+ * @param {number} params.event.width The new width
691
+ * @param {number} params.event.height The new height
692
+ * @param {number} params.event.oldWidth The old width
693
+ * @param {number} params.event.oldHeight The old height
722
694
  */
723
695
  (e: 'resize', params: ((event: { source: Widget, width: number, height: number, oldWidth: number, oldHeight: number }) => void)|string): void
724
696
  /**
725
697
  * Triggered after a widget is shown.
726
698
  * @param {string} e Event name
727
699
  * @param {object} params Event parameters
728
- * @param {string} params.e Event name
729
- * @param {object} params.params Event parameters
730
- * @param {object} params.params.event Event object
731
- * @param {Core.widget.Widget} params.params.event.source The widget
700
+ * @param {object} params.event Event object
701
+ * @param {Core.widget.Widget} params.event.source The widget
732
702
  */
733
703
  (e: 'show', params: ((event: { source: Widget }) => void)|string): void
734
704
  }>();
@@ -82,6 +82,15 @@ defineProps<{
82
82
  * Set to `true` to centre the Widget in browser viewport space.
83
83
  */
84
84
  centered ? : Boolean
85
+ /**
86
+ * A function (or the name of a function in the ownership hierarchy) called during field validation
87
+ * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/scheduler/docs/api/Core/widget/Field#property-isValid)
88
+ * evaluation, after the built-in [required](https://bryntum.com/products/scheduler/docs/api/Core/widget/Field#config-required) check.
89
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ViewPresetCombo#config-checkValidity)
90
+ * @param {Core.widget.Field} field The field being validated
91
+ * @returns {void}
92
+ */
93
+ checkValidity ? : ((field: Field) => void)|string
85
94
  /**
86
95
  * Specify `false` to not clear value typed to a multiselect combo when an item is selected.
87
96
  */
@@ -550,44 +559,36 @@ const emit = defineEmits<{
550
559
  * The default action was performed (an item in the list was selected)
551
560
  * @param {string} e Event name
552
561
  * @param {object} params Event parameters
553
- * @param {string} params.e Event name
554
- * @param {object} params.params Event parameters
555
- * @param {object} params.params.event Event object
556
- * @param {Core.widget.Combo} params.params.event.source The combo
557
- * @param {any} params.params.event.value The [value](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-valueField) of the selected record
558
- * @param {Core.data.Model} params.params.event.record Selected record
559
- * @param {Core.data.Model[]} params.params.event.records Selected records as an array if [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-multiSelect) is `true`
560
- * @param {boolean} params.params.event.userAction `true` if the value change is due to user interaction
562
+ * @param {object} params.event Event object
563
+ * @param {Core.widget.Combo} params.event.source The combo
564
+ * @param {any} params.event.value The [value](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-valueField) of the selected record
565
+ * @param {Core.data.Model} params.event.record Selected record
566
+ * @param {Core.data.Model[]} params.event.records Selected records as an array if [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-multiSelect) is `true`
567
+ * @param {boolean} params.event.userAction `true` if the value change is due to user interaction
561
568
  */
562
569
  (e: 'action', params: ((event: { source: Combo, value: any, record: Model, records: Model[], userAction: boolean }) => void)|string): void
563
570
  /**
564
571
  * Fires before an object is destroyed.
565
572
  * @param {string} e Event name
566
573
  * @param {object} params Event parameters
567
- * @param {string} params.e Event name
568
- * @param {object} params.params Event parameters
569
- * @param {object} params.params.event Event object
570
- * @param {Core.Base} params.params.event.source The Object that is being destroyed.
574
+ * @param {object} params.event Event object
575
+ * @param {Core.Base} params.event.source The Object that is being destroyed.
571
576
  */
572
577
  (e: 'beforeDestroy', params: ((event: { source: Base }) => void)|string): void
573
578
  /**
574
579
  * Triggered before a widget is hidden. Return `false` to prevent the action.
575
580
  * @param {string} e Event name
576
581
  * @param {object} params Event parameters
577
- * @param {string} params.e Event name
578
- * @param {object} params.params Event parameters
579
- * @param {object} params.params.event Event object
580
- * @param {Core.widget.Widget} params.params.event.source The widget being hidden.
582
+ * @param {object} params.event Event object
583
+ * @param {Core.widget.Widget} params.event.source The widget being hidden.
581
584
  */
582
- (e: 'beforeHide', params: ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
585
+ (e: 'beforeHide', params: ((event: { source: Widget }) => boolean|void)|string): boolean|void
583
586
  /**
584
587
  * Triggered before a widget is shown. Return `false` to prevent the action.
585
588
  * @param {string} e Event name
586
589
  * @param {object} params Event parameters
587
- * @param {string} params.e Event name
588
- * @param {object} params.params Event parameters
589
- * @param {object} params.params.event Event object
590
- * @param {Core.widget.Widget,any} params.params.event.source The widget being shown
590
+ * @param {object} params.event Event object
591
+ * @param {Core.widget.Widget,any} params.event.source The widget being shown
591
592
  */
592
593
  (e: 'beforeShow', params: ((event: { source: Widget|any }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
593
594
  /**
@@ -595,27 +596,23 @@ const emit = defineEmits<{
595
596
  * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ViewPresetCombo#event-catchAll)
596
597
  * @param {string} e Event name
597
598
  * @param {object} params Event parameters
598
- * @param {string} params.e Event name
599
- * @param {object} params.params Event parameters
600
- * @param {object} params.params.event Event object
601
- * @param {{[key: string]: any, type: string}} params.params.event.event The Object that contains event details
602
- * @param {string} params.params.event.event.type The type of the event which is caught by the listener
599
+ * @param {object} params.event Event object
600
+ * @param {{[key: string]: any, type: string}} params.event.event The Object that contains event details
601
+ * @param {string} params.event.event.type The type of the event which is caught by the listener
603
602
  */
604
603
  (e: 'catchAll', params: ((event: {[key: string]: any, type: string}) => void)|string): void
605
604
  /**
606
605
  * Fired when this field's value changes.
607
606
  * @param {string} e Event name
608
607
  * @param {object} params Event parameters
609
- * @param {string} params.e Event name
610
- * @param {object} params.params Event parameters
611
- * @param {object} params.params.event Event object
612
- * @param {Core.widget.Field,any} params.params.event.source This Field
613
- * @param {string,number,boolean,any} params.params.event.value This field's value
614
- * @param {string,number,boolean,any} params.params.event.oldValue This field's previous value
615
- * @param {boolean} params.params.event.valid True if this field is in a valid state
616
- * @param {Event} params.params.event.event The triggering DOM event if any
617
- * @param {boolean} params.params.event.userAction Triggered by user taking an action (`true`) or by setting a value (`false`)
618
- * @param {boolean} params.params.event.checked
608
+ * @param {object} params.event Event object
609
+ * @param {Core.widget.Field,any} params.event.source This Field
610
+ * @param {string,number,boolean,any} params.event.value This field's value
611
+ * @param {string,number,boolean,any} params.event.oldValue This field's previous value
612
+ * @param {boolean} params.event.valid True if this field is in a valid state
613
+ * @param {Event} params.event.event The triggering DOM event if any
614
+ * @param {boolean} params.event.userAction Triggered by user taking an action (`true`) or by setting a value (`false`)
615
+ * @param {boolean} params.event.checked
619
616
  */
620
617
  (e: 'change', params: ((event: { source: Field|any, value: string|number|boolean|any, oldValue: string|number|boolean|any, valid: boolean, event: Event, userAction: boolean, checked: boolean }) => void)|string): void
621
618
  /**
@@ -623,45 +620,37 @@ const emit = defineEmits<{
623
620
  * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ViewPresetCombo#event-clear)
624
621
  * @param {string} e Event name
625
622
  * @param {object} params Event parameters
626
- * @param {string} params.e Event name
627
- * @param {object} params.params Event parameters
628
- * @param {object} params.params.event Event object
629
- * @param {Core.widget.Field,any} params.params.event.source This Field
623
+ * @param {object} params.event Event object
624
+ * @param {Core.widget.Field,any} params.event.source This Field
630
625
  */
631
626
  (e: 'clear', params: ((event: { source: Field|any }) => void)|string): void
632
627
  /**
633
628
  * Fires when an object is destroyed.
634
629
  * @param {string} e Event name
635
630
  * @param {object} params Event parameters
636
- * @param {string} params.e Event name
637
- * @param {object} params.params Event parameters
638
- * @param {object} params.params.event Event object
639
- * @param {Core.Base} params.params.event.source The Object that is being destroyed.
631
+ * @param {object} params.event Event object
632
+ * @param {Core.Base} params.event.source The Object that is being destroyed.
640
633
  */
641
634
  (e: 'destroy', params: ((event: { source: Base }) => void)|string): void
642
635
  /**
643
636
  * Triggered when a widget's [element](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#property-element) is available.
644
637
  * @param {string} e Event name
645
638
  * @param {object} params Event parameters
646
- * @param {string} params.e Event name
647
- * @param {object} params.params Event parameters
648
- * @param {object} params.params.event Event object
649
- * @param {HTMLElement} params.params.event.element The Widget's element.
639
+ * @param {object} params.event Event object
640
+ * @param {HTMLElement} params.event.element The Widget's element.
650
641
  */
651
642
  (e: 'elementCreated', params: ((event: { element: HTMLElement }) => void)|string): void
652
643
  /**
653
644
  * Fired when focus enters this Widget.
654
645
  * @param {string} e Event name
655
646
  * @param {object} params Event parameters
656
- * @param {string} params.e Event name
657
- * @param {object} params.params Event parameters
658
- * @param {object} params.params.event Event object
659
- * @param {Core.widget.Widget} params.params.event.source This Widget
660
- * @param {HTMLElement} params.params.event.fromElement The element which lost focus.
661
- * @param {HTMLElement} params.params.event.toElement The element which gained focus.
662
- * @param {Core.widget.Widget} params.params.event.fromWidget The widget which lost focus.
663
- * @param {Core.widget.Widget} params.params.event.toWidget The widget which gained focus.
664
- * @param {boolean} params.params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
647
+ * @param {object} params.event Event object
648
+ * @param {Core.widget.Widget} params.event.source This Widget
649
+ * @param {HTMLElement} params.event.fromElement The element which lost focus.
650
+ * @param {HTMLElement} params.event.toElement The element which gained focus.
651
+ * @param {Core.widget.Widget} params.event.fromWidget The widget which lost focus.
652
+ * @param {Core.widget.Widget} params.event.toWidget The widget which gained focus.
653
+ * @param {boolean} params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
665
654
  */
666
655
  (e: 'focusIn', params: ((event: { source: Widget, fromElement: HTMLElement, toElement: HTMLElement, fromWidget: Widget, toWidget: Widget, backwards: boolean }) => void)|string): void
667
656
  /**
@@ -670,25 +659,21 @@ const emit = defineEmits<{
670
659
  * will not trigger this event. This is when focus exits this widget completely.
671
660
  * @param {string} e Event name
672
661
  * @param {object} params Event parameters
673
- * @param {string} params.e Event name
674
- * @param {object} params.params Event parameters
675
- * @param {object} params.params.event Event object
676
- * @param {Core.widget.Widget} params.params.event.source This Widget
677
- * @param {HTMLElement} params.params.event.fromElement The element which lost focus.
678
- * @param {HTMLElement} params.params.event.toElement The element which gained focus.
679
- * @param {Core.widget.Widget} params.params.event.fromWidget The widget which lost focus.
680
- * @param {Core.widget.Widget} params.params.event.toWidget The widget which gained focus.
681
- * @param {boolean} params.params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
662
+ * @param {object} params.event Event object
663
+ * @param {Core.widget.Widget} params.event.source This Widget
664
+ * @param {HTMLElement} params.event.fromElement The element which lost focus.
665
+ * @param {HTMLElement} params.event.toElement The element which gained focus.
666
+ * @param {Core.widget.Widget} params.event.fromWidget The widget which lost focus.
667
+ * @param {Core.widget.Widget} params.event.toWidget The widget which gained focus.
668
+ * @param {boolean} params.event.backwards `true` if the `toElement` is before the `fromElement` in document order.
682
669
  */
683
670
  (e: 'focusOut', params: ((event: { source: Widget, fromElement: HTMLElement, toElement: HTMLElement, fromWidget: Widget, toWidget: Widget, backwards: boolean }) => void)|string): void
684
671
  /**
685
672
  * Triggered after a widget was hidden
686
673
  * @param {string} e Event name
687
674
  * @param {object} params Event parameters
688
- * @param {string} params.e Event name
689
- * @param {object} params.params Event parameters
690
- * @param {object} params.params.event Event object
691
- * @param {Core.widget.Widget} params.params.event.source The widget
675
+ * @param {object} params.event Event object
676
+ * @param {Core.widget.Widget} params.event.source The widget
692
677
  */
693
678
  (e: 'hide', params: ((event: { source: Widget }) => void)|string): void
694
679
  /**
@@ -697,21 +682,17 @@ const emit = defineEmits<{
697
682
  * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ViewPresetCombo#event-paint)
698
683
  * @param {string} e Event name
699
684
  * @param {object} params Event parameters
700
- * @param {string} params.e Event name
701
- * @param {object} params.params Event parameters
702
- * @param {object} params.params.event Event object
703
- * @param {Core.widget.Widget} params.params.event.source The widget being painted.
704
- * @param {boolean} params.params.event.firstPaint `true` if this is the first paint.
685
+ * @param {object} params.event Event object
686
+ * @param {Core.widget.Widget} params.event.source The widget being painted.
687
+ * @param {boolean} params.event.firstPaint `true` if this is the first paint.
705
688
  */
706
689
  (e: 'paint', params: ((event: { source: Widget, firstPaint: boolean }) => void)|string): void
707
690
  /**
708
691
  * Fired when a Widget's read only state is toggled
709
692
  * @param {string} e Event name
710
693
  * @param {object} params Event parameters
711
- * @param {string} params.e Event name
712
- * @param {object} params.params Event parameters
713
- * @param {object} params.params.event Event object
714
- * @param {boolean} params.params.event.readOnly Read only or not
694
+ * @param {object} params.event Event object
695
+ * @param {boolean} params.event.readOnly Read only or not
715
696
  */
716
697
  (e: 'readOnly', params: ((event: { readOnly: boolean }) => void)|string): void
717
698
  /**
@@ -723,48 +704,40 @@ const emit = defineEmits<{
723
704
  * Fired when the encapsulating element of a Widget resizes *only when [monitorResize](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-monitorResize) is `true`*.
724
705
  * @param {string} e Event name
725
706
  * @param {object} params Event parameters
726
- * @param {string} params.e Event name
727
- * @param {object} params.params Event parameters
728
- * @param {object} params.params.event Event object
729
- * @param {Core.widget.Widget} params.params.event.source This Widget
730
- * @param {number} params.params.event.width The new width
731
- * @param {number} params.params.event.height The new height
732
- * @param {number} params.params.event.oldWidth The old width
733
- * @param {number} params.params.event.oldHeight The old height
707
+ * @param {object} params.event Event object
708
+ * @param {Core.widget.Widget} params.event.source This Widget
709
+ * @param {number} params.event.width The new width
710
+ * @param {number} params.event.height The new height
711
+ * @param {number} params.event.oldWidth The old width
712
+ * @param {number} params.event.oldHeight The old height
734
713
  */
735
714
  (e: 'resize', params: ((event: { source: Widget, width: number, height: number, oldWidth: number, oldHeight: number }) => void)|string): void
736
715
  /**
737
716
  * An item in the list was selected
738
717
  * @param {string} e Event name
739
718
  * @param {object} params Event parameters
740
- * @param {string} params.e Event name
741
- * @param {object} params.params Event parameters
742
- * @param {object} params.params.event Event object
743
- * @param {Core.widget.Combo} params.params.event.source The combo
744
- * @param {Core.data.Model} params.params.event.record Selected record
745
- * @param {Core.data.Model[]} params.params.event.records Selected records as an array if [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-multiSelect) is `true`
746
- * @param {boolean} params.params.event.userAction `true` if the value change is due to user interaction
719
+ * @param {object} params.event Event object
720
+ * @param {Core.widget.Combo} params.event.source The combo
721
+ * @param {Core.data.Model} params.event.record Selected record
722
+ * @param {Core.data.Model[]} params.event.records Selected records as an array if [multiSelect](https://bryntum.com/products/scheduler/docs/api/Core/widget/Combo#config-multiSelect) is `true`
723
+ * @param {boolean} params.event.userAction `true` if the value change is due to user interaction
747
724
  */
748
725
  (e: 'select', params: ((event: { source: Combo, record: Model, records: Model[], userAction: boolean }) => void)|string): void
749
726
  /**
750
727
  * Triggered after a widget is shown.
751
728
  * @param {string} e Event name
752
729
  * @param {object} params Event parameters
753
- * @param {string} params.e Event name
754
- * @param {object} params.params Event parameters
755
- * @param {object} params.params.event Event object
756
- * @param {Core.widget.Widget} params.params.event.source The widget
730
+ * @param {object} params.event Event object
731
+ * @param {Core.widget.Widget} params.event.source The widget
757
732
  */
758
733
  (e: 'show', params: ((event: { source: Widget }) => void)|string): void
759
734
  /**
760
735
  * User clicked one of this field's [triggers](https://bryntum.com/products/scheduler/docs/api/Core/widget/Field#property-triggers)
761
736
  * @param {string} e Event name
762
737
  * @param {object} params Event parameters
763
- * @param {string} params.e Event name
764
- * @param {object} params.params Event parameters
765
- * @param {object} params.params.event Event object
766
- * @param {Core.widget.Field,any} params.params.event.source This field
767
- * @param {Core.widget.Widget} params.params.event.trigger The trigger activated by click or touch tap.
738
+ * @param {object} params.event Event object
739
+ * @param {Core.widget.Field,any} params.event.source This field
740
+ * @param {Core.widget.Widget} params.event.trigger The trigger activated by click or touch tap.
768
741
  */
769
742
  (e: 'trigger', params: ((event: { source: Field|any, trigger: Widget }) => void)|string): void
770
743
  }>();
@@ -781,6 +754,7 @@ const widgetData = {
781
754
  'bubbleEvents',
782
755
  'cacheLastResult',
783
756
  'centered',
757
+ 'checkValidity',
784
758
  'clearTextOnSelection',
785
759
  'clearWhenInputEmpty',
786
760
  'client',
@@ -67,6 +67,15 @@ export declare type BryntumViewPresetComboProps = {
67
67
  * Set to `true` to centre the Widget in browser viewport space.
68
68
  */
69
69
  centered ? : Boolean
70
+ /**
71
+ * A function (or the name of a function in the ownership hierarchy) called during field validation
72
+ * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/scheduler/docs/api/Core/widget/Field#property-isValid)
73
+ * evaluation, after the built-in [required](https://bryntum.com/products/scheduler/docs/api/Core/widget/Field#config-required) check.
74
+ * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ViewPresetCombo#config-checkValidity)
75
+ * @param {Core.widget.Field} field The field being validated
76
+ * @returns {void}
77
+ */
78
+ checkValidity ? : ((field: Field) => void)|string
70
79
  /**
71
80
  * Specify `false` to not clear value typed to a multiselect combo when an item is selected.
72
81
  */