[add] events description

Author: serhiipylypchuk1991

docs/api/api_overview.md

@@ -51,9 +51,11 @@ new booking.Booking("#root", {
 
 ## Booking events
 
-| Name                                                  | Description                                                 |
-| ----------------------------------------------------- | ----------------------------------------------------------- |
-| [](api/events/booking_eventname_event.md)             | @getshort(api/events/booking_eventname_event.md)            |
+| Name                                      | Description                                      |
+| ----------------------------------------- | ------------------------------------------------ |
+| [](api/events/js_booking_confirmslot.md)  | @getshort(api/events/js_booking_confirmslot.md)  |
+| [](api/events/js_booking_selectslot.md)   | @getshort(api/events/js_booking_selectslot.md)   |
+| [](api/events/js_booking_setfilter.md)    | @getshort(api/events/js_booking_setfilter.md)    |
 
 ## Booking properties
 

docs/api/events/js_booking_confirmslot.md

@@ -0,0 +1,51 @@
+---
+sidebar_label: confirm-slot
+title: confirm-slot Event
+description: You can learn about the confirm-slot event in the documentation of the DHTMLX JavaScript Booking library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Booking.
+---
+
+# confirm-slot
+
+### Description
+
+@short: Fires when confirming the booking of a slot
+
+### Usage
+
+~~~jsx {}
+"confirm-slot": ({
+    cardId: string | number,
+    data: {
+        [key: string]: string,
+    },
+    startTime: number,
+    confirmation: promise,
+}) => void;
+~~~
+
+### Parameters
+
+The callback of the **confirm-slot** event can take an object with the following parameters:
+
+- `cardId` - (required) the ID of a card for which the booking of a slot is confirmed
+- `data` - (required) an abject with the booking screen form fields with the following parameters for each field:
+   - `key` - (required) the form field ID. By default, three fields are added: *name*, *email*, *description*
+   - `startTime` - (required) the start time of a slot in milliseconds
+- `confirmation` - (required) a promise with the confirmation status
+
+### Example
+
+~~~jsx {7-10}
+// create Booking
+const booking = new booking.Booking("#root", {
+	cards,
+	cardShape
+});
+
+// ...
+booking.api.on("confirm-slot", (obj) => {
+	console.log(obj.cardId);
+});
+~~~
+
+**Related articles:** TODO

docs/api/events/js_booking_selectslot.md

@@ -0,0 +1,49 @@
+---
+sidebar_label: select-slot
+title: select-slot Event
+description: You can learn about the select-slot event in the documentation of the DHTMLX JavaScript Booking library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Booking.
+---
+
+# select-slot
+
+### Description
+
+@short: Fires when selecting a slot
+
+### Usage
+
+~~~jsx {}
+"select-slot": ({
+    cardId: string | number,
+    slotTime: {
+        from?: Date,
+        to?: Date,
+    }
+ }) => void;
+~~~
+
+### Parameters
+
+The callback of the **select-slot** event can take an object with the following parameters:
+
+- `cardId` - (required) the ID of a card a selected slot belongs to
+- `slotTime` - (required) an object with the slot time parameters. In this object you can specify the following parameters:
+	- `from` - (optional) the slot start date
+	- `to` - (optional) the slot end date
+  
+### Example
+
+~~~jsx {7-10}
+// create Booking
+const booking = new booking.Booking("#root", {
+	cards,
+	cardShape
+});
+
+// ...
+booking.api.on("select-slot", (obj) => {
+	console.log(obj.cardId);
+});
+~~~
+
+**Related articles:** TODO

docs/api/events/js_booking_setfilter.md

@@ -0,0 +1,53 @@
+---
+sidebar_label: set-filter
+title: set-filter Event
+description: You can learn about the set-filter event in the documentation of the DHTMLX JavaScript Booking library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Booking.
+---
+
+# set-filter
+
+### Description
+
+@short: Fires when filtering cards
+
+### Usage
+
+~~~jsx {}
+"set-filter": ({
+    global?: string,
+    date?: string,
+    time?: [
+		{
+			from?: number,
+			to?: number,
+		}, {...}
+	],
+ }) => void;
+~~~
+
+### Parameters
+
+The callback of the **set-filter** event can take an object with the following parameters:
+
+- `global` - (optional) the text in the search field
+- `date` - (optional) the slot date
+- `time` - (optional) an array of objects containing time options for a slot. For each object, you can specify the following parameters:
+  - `from` - (optional) the start time
+  - `to` - (optional) the end time
+
+### Example
+
+~~~jsx {7-10}
+// create Booking
+const booking = new booking.Booking("#root", {
+	cards,
+	cardShape
+});
+
+// ...
+booking.api.on("set-filter", (obj) => {
+	console.log(obj.time);
+});
+~~~
+
+**Related articles:** TODO

sidebars.js

@@ -78,7 +78,10 @@ module.exports = {
 					collapsed: true,
 					items: [
 						// Booking events
-						"api/events/booking_eventname_event",
+						//"api/events/booking_eventname_event",
+						"api/events/js_booking_confirmslot",
+						"api/events/js_booking_selectslot",
+						"api/events/js_booking_setfilter",
 					]
 				},
 				{