adding onFirstSelect event

Author: dev-javascript

README.md

@@ -523,6 +523,33 @@ const [TabList, PanelList, ready] = useDynTabs({
 });
 ```
 
+### onFirstSelect
+
+<table>
+  <tbody>
+    <tr>
+      <th>type</th>
+      <th>required</th>
+      <th>description</th>
+    </tr>
+    <tr>
+      <td>function</td>
+      <td>false</td>
+      <td>fires after selecting a tab for the first time. It is not fired for the initial selected tab</td>
+    </tr>
+  </tbody>
+</table>
+
+**Example**
+
+```js
+const [TabList, PanelList, ready] = useDynTabs({
+  onFirstSelect: function ({currentSelectedTabId, previousSelectedTabId}) {
+    console.log('[onFirstSelect]');
+  },
+});
+```
+
 ### onSelect
 
 <table>

package-lock.json

@@ -185,12 +185,19 @@ Helper.setNoneEnumProps(_apiProps, {
       });
       openedTabIDs.length && this.trigger('onOpen', this.userProxy, openedTabIDs);
       closedTabIDs.length && this.trigger('onClose', this.userProxy, closedTabIDs);
-      isSwitched &&
+      if (isSwitched) {
+        if (this.activedTabsHistory.tabsId.indexOf(newState.selectedTabID) === -1) {
+          this.trigger('onFirstSelect', this.userProxy, {
+            currentSelectedTabId: newState.selectedTabID,
+            previousSelectedTabId: oldState.selectedTabID,
+          });
+        }
         this.trigger('onSelect', this.userProxy, {
           currentSelectedTabId: newState.selectedTabID,
           previousSelectedTabId: oldState.selectedTabID,
           perviousSelectedTabId: oldState.selectedTabID,
         });
+      }
     }
     return this;
   },

src/utils/api/api.factory.js

@@ -580,3 +580,38 @@ describe('Api.prototype._getNextSiblingTabId : ', () => {
     expect(!obj.helper.filterArrayUntilFirstValue.mock.calls[0][2]).toBe(true);
   });
 });
+describe('Api.prorotype.onChange : ', () => {
+  it('it should trigger onFirstSelect if isSwitched parameter was true and activedTabsHistory.tabsId does not include new selected tab id', () => {
+    obj.trigger = jest.fn(() => {});
+    obj.onChange({
+      newState: {selectedTabID: '2'},
+      oldState: {selectedTabID: '1'},
+      closedTabIDs: [],
+      openedTabIDs: [],
+      isSwitched: true,
+    });
+    expect(obj.trigger.mock.calls.length).toBe(3);
+    expect(obj.trigger.mock.calls[0][0]).toBe('onChange');
+    expect(obj.trigger.mock.calls[1][0]).toBe('onFirstSelect');
+    expect(obj.trigger.mock.calls[2][0]).toBe('onSelect');
+    expect(obj.trigger.mock.calls[1][1]).toBe(obj.userProxy);
+    expect(obj.trigger.mock.calls[1][2]).toEqual({
+      currentSelectedTabId: '2',
+      previousSelectedTabId: '1',
+    });
+  });
+  it('it should not trigger onFirstSelect if activedTabsHistory.tabsId includes new selected tab id', () => {
+    obj.trigger = jest.fn(() => {});
+    obj.activedTabsHistory.tabsId = ['1', '2'];
+    obj.onChange({
+      newState: {selectedTabID: '2'},
+      oldState: {selectedTabID: '1'},
+      closedTabIDs: [],
+      openedTabIDs: [],
+      isSwitched: true,
+    });
+    expect(obj.trigger.mock.calls.length).toBe(2);
+    expect(obj.trigger.mock.calls[0][0]).toBe('onChange');
+    expect(obj.trigger.mock.calls[1][0]).toBe('onSelect');
+  });
+});