@bbn/bbn 1.0.350 → 1.0.352

package/dist/fn/html/getIndex.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Gets all the tag names present in the DOM
+ * @returns array
+ */
+export default function getIndex(element: HTMLElement, selector?: string): number;

package/dist/fn/html/getIndex.js

@@ -0,0 +1,17 @@
+/**
+ * Gets all the tag names present in the DOM
+ * @returns array
+ */
+export default function getIndex(element, selector) {
+    if (selector === void 0) { selector = ''; }
+    if (!element.parentElement) {
+        return -1; // Element has no parent, return -1
+    }
+    if (!selector) {
+        Array.from(element.parentElement.children).indexOf(element);
+    }
+    var siblings = Array.from(element.parentElement.children);
+    var filteredSiblings = siblings.filter(function (el) { return el.matches(selector); });
+    return filteredSiblings.indexOf(element);
+}
+;

package/dist/fn/object/getField.d.ts

@@ -1,29 +1,31 @@
 /**
-  * Returns the value of the given field (property) from the first object matching the given filter in an array of objects.
-  *
-  * The filtering arguments follow the same scheme as bbn.fn.search.
-  *
-  * @method   getField
-  * @global
-  * @example
-  * ```javascript
-  * let ar = [
-  *   {name: "Raiders of the lost ark", director: "Steven Spielberg", year: 1981, id: 589},
-  *   {name: "Goonies", director: "Richard Donner", year: 1985, id: 689},
-  *   {name: "Star wars", director: "George Lucas", year: 1977, id: 256},
-  *   {name: "Jaws", director: "Steven Spielberg", year: 1975, id: 423}
-  * ];
-  * bbn.fn.getField(ar, "name", {id: 256});
-  * // Star wars
-  * bbn.fn.getField(ar, "name", "id", 689);
-  * // Goonies
-  * ```
-  * @memberof bbn.fn
-  * @param    {Array}                    arr       The subject array
-  * @param    {String}                   field     The property from which the value is returned
-  * @param    {(String|Object|Function)} prop      A property's name or a filter object or function
-  * @param    {*}                        val       The value with which comparing the given property
-  * @param    {String}                   operator  The operator to use for comparison with the value as used in bbn.fn.compare
-  * @returns  {*}
-  */
-export default function getField(arr: any[], field: string, prop?: object | string, val?: any, operator?: string): any;
+ * Returns the value of the given field (property) from the first object matching the given filter in an array of objects.
+ *
+ * The filtering arguments follow the same scheme as bbn.fn.search.
+ *
+ * @method   getField
+ * @global
+ * @example
+ * ```javascript
+ * let ar = [
+ *   {name: "Raiders of the lost ark", director: "Steven Spielberg", year: 1981, id: 589},
+ *   {name: "Goonies", director: "Richard Donner", year: 1985, id: 689},
+ *   {name: "Star wars", director: "George Lucas", year: 1977, id: 256},
+ *   {name: "Jaws", director: "Steven Spielberg", year: 1975, id: 423}
+ * ];
+ * bbn.fn.getField(ar, "name", {id: 256});
+ * // Star wars
+ * bbn.fn.getField(ar, "name", "id", 689);
+ * // Goonies
+ * ```
+ * @memberof bbn.fn
+ * @param    {Array}                    arr       The subject array
+ * @param    {String}                   field     The property from which the value is returned
+ * @param    {(String|Object|Function)} prop      A property's name or a filter object or function
+ * @param    {*}                        val       The value with which comparing the given property
+ * @param    {String}                   operator  The operator to use for comparison with the value as used in bbn.fn.compare
+ * @param    {Number|false}             from      The index to start from, if false the search starts from the end
+ * @param    {Boolean}                  backward  Searches backward
+ * @returns  {*}
+ */
+export default function getField(arr: any[], field: string, prop?: object | string, val?: any, operator?: string, from?: boolean | number, backward?: any, notFound?: any): any;

package/dist/fn/object/getField.js

@@ -1,40 +1,52 @@
 import getRow from './getRow.js';
 /**
-  * Returns the value of the given field (property) from the first object matching the given filter in an array of objects.
-  *
-  * The filtering arguments follow the same scheme as bbn.fn.search.
-  *
-  * @method   getField
-  * @global
-  * @example
-  * ```javascript
-  * let ar = [
-  *   {name: "Raiders of the lost ark", director: "Steven Spielberg", year: 1981, id: 589},
-  *   {name: "Goonies", director: "Richard Donner", year: 1985, id: 689},
-  *   {name: "Star wars", director: "George Lucas", year: 1977, id: 256},
-  *   {name: "Jaws", director: "Steven Spielberg", year: 1975, id: 423}
-  * ];
-  * bbn.fn.getField(ar, "name", {id: 256});
-  * // Star wars
-  * bbn.fn.getField(ar, "name", "id", 689);
-  * // Goonies
-  * ```
-  * @memberof bbn.fn
-  * @param    {Array}                    arr       The subject array
-  * @param    {String}                   field     The property from which the value is returned
-  * @param    {(String|Object|Function)} prop      A property's name or a filter object or function
-  * @param    {*}                        val       The value with which comparing the given property
-  * @param    {String}                   operator  The operator to use for comparison with the value as used in bbn.fn.compare
-  * @returns  {*}
-  */
-export default function getField(arr, field, prop, val, operator) {
+ * Returns the value of the given field (property) from the first object matching the given filter in an array of objects.
+ *
+ * The filtering arguments follow the same scheme as bbn.fn.search.
+ *
+ * @method   getField
+ * @global
+ * @example
+ * ```javascript
+ * let ar = [
+ *   {name: "Raiders of the lost ark", director: "Steven Spielberg", year: 1981, id: 589},
+ *   {name: "Goonies", director: "Richard Donner", year: 1985, id: 689},
+ *   {name: "Star wars", director: "George Lucas", year: 1977, id: 256},
+ *   {name: "Jaws", director: "Steven Spielberg", year: 1975, id: 423}
+ * ];
+ * bbn.fn.getField(ar, "name", {id: 256});
+ * // Star wars
+ * bbn.fn.getField(ar, "name", "id", 689);
+ * // Goonies
+ * ```
+ * @memberof bbn.fn
+ * @param    {Array}                    arr       The subject array
+ * @param    {String}                   field     The property from which the value is returned
+ * @param    {(String|Object|Function)} prop      A property's name or a filter object or function
+ * @param    {*}                        val       The value with which comparing the given property
+ * @param    {String}                   operator  The operator to use for comparison with the value as used in bbn.fn.compare
+ * @param    {Number|false}             from      The index to start from, if false the search starts from the end
+ * @param    {Boolean}                  backward  Searches backward
+ * @returns  {*}
+ */
+export default function getField(arr, field, prop, val, operator, from, backward, notFound) {
     if (prop === void 0) { prop = ''; }
     if (val === void 0) { val = null; }
     if (operator === void 0) { operator = '='; }
+    if (from === void 0) { from = 0; }
+    if (backward === void 0) { backward = false; }
+    if (notFound === void 0) { notFound = undefined; }
     var r;
-    if (field && (r = getRow(arr, prop, val, operator))) {
+    if (prop && ['object', 'function'].includes(typeof prop) && (6 in arguments)) {
+        notFound = backward;
+    }
+    if (field) {
+        r = getRow(arr, prop, val, operator, from, backward, undefined);
+        if (r === undefined) {
+            return notFound;
+        }
         return r[field];
     }
-    return undefined;
+    return notFound;
 }
 ;

package/dist/fn/object/getRow.d.ts

@@ -36,7 +36,9 @@
  * @param    {(String|Object|Function)} prop      A property's name or a filter object or function
  * @param    {*}                        val       The value with which comparing the given property
  * @param    {Number|false|String}      operator  The operator to use for comparison with the value as used in bbn.fn.compare
- * @param    {Number|false}             from      The index to start from, if false the search starts from the end
- * @returns  {Object|Boolean}           The item if found, false otherwise
+ * @param    {Number|Boolean}           from      The index to start from, if false the search starts from the end
+ * @param    {*}                        backward  Searches backward
+ * @param    {*}                        notFound  Value to return when not found
+ * @returns  {*}           The item if found, false otherwise
  */
-export default function getRow(arr: any[], prop: object | string, val?: any, operator?: number | false | string, from?: false | number): any | false;
+export default function getRow(arr: any[], prop: object | string, val?: any, operator?: number | string, from?: boolean | number, backward?: any, notFound?: any): any | false;

package/dist/fn/object/getRow.js

@@ -37,17 +37,24 @@ import search from './search.js';
  * @param    {(String|Object|Function)} prop      A property's name or a filter object or function
  * @param    {*}                        val       The value with which comparing the given property
  * @param    {Number|false|String}      operator  The operator to use for comparison with the value as used in bbn.fn.compare
- * @param    {Number|false}             from      The index to start from, if false the search starts from the end
- * @returns  {Object|Boolean}           The item if found, false otherwise
+ * @param    {Number|Boolean}           from      The index to start from, if false the search starts from the end
+ * @param    {*}                        backward  Searches backward
+ * @param    {*}                        notFound  Value to return when not found
+ * @returns  {*}           The item if found, false otherwise
  */
-export default function getRow(arr, prop, val, operator, from) {
+export default function getRow(arr, prop, val, operator, from, backward, notFound) {
     if (val === void 0) { val = null; }
     if (operator === void 0) { operator = '='; }
     if (from === void 0) { from = 0; }
-    var idx = search(arr, prop, val, operator, from);
+    if (backward === void 0) { backward = false; }
+    if (notFound === void 0) { notFound = false; }
+    var idx = search(arr, prop, val, operator, from, backward);
     if (idx > -1) {
         return arr[idx];
     }
-    return false;
+    if (prop && ['object', 'function'].includes(typeof prop) && (5 in arguments)) {
+        return backward;
+    }
+    return notFound;
 }
 ;

package/dist/fn/object/search.d.ts

@@ -94,7 +94,7 @@ import { Filter } from './filterToConditions.js';
  * @param    {(String|Object|Function)} prop      A property's name or a filter object or function
  * @param    {*}                        val       The value with which comparing the given property
  * @param    {String}                   operator  The operator to use for comparison with the value as used in bbn.fn.compare
- * @param    {Number|false}             startFrom The index from which the search should start
+ * @param    {Number}                   startFrom The index from which the search should start
  * @returns  {Number}                   The index if found, otherwise -1
  */
-export default function search(arr: any[], prop: Filter | object | string | ((a: any, i: string | number | symbol) => boolean), val?: any, operator?: number | false | string, startFrom?: number | false): number;
+export default function search(arr: any[], prop: Filter | object | string | ((a: any, i: string | number | symbol) => boolean), val?: any, operator?: number | string, startFrom?: boolean | number, backward?: boolean): number;

package/dist/fn/object/search.js

@@ -3,6 +3,7 @@ import compareConditions from './compareConditions.js';
 import { filterToConditions } from './filterToConditions.js';
 import isObject from '../type/isObject.js';
 import numProperties from './numProperties.js';
+import isNumber from '../type/isNumber.js';
 /**
  * Retrieves the index of the array's first element corresponding to the given filter.
  *
@@ -98,13 +99,14 @@ import numProperties from './numProperties.js';
  * @param    {(String|Object|Function)} prop      A property's name or a filter object or function
  * @param    {*}                        val       The value with which comparing the given property
  * @param    {String}                   operator  The operator to use for comparison with the value as used in bbn.fn.compare
- * @param    {Number|false}             startFrom The index from which the search should start
+ * @param    {Number}                   startFrom The index from which the search should start
  * @returns  {Number}                   The index if found, otherwise -1
  */
-export default function search(arr, prop, val, operator, startFrom) {
+export default function search(arr, prop, val, operator, startFrom, backward) {
     if (val === void 0) { val = null; }
     if (operator === void 0) { operator = '='; }
     if (startFrom === void 0) { startFrom = 0; }
+    if (backward === void 0) { backward = false; }
     if (!isIterable(arr)) {
         throw new Error(bbn._('The first argument for a search should be iterable') + ' ' + typeof arr + ' ' + bbn._('given'));
     }
@@ -140,7 +142,8 @@ export default function search(arr, prop, val, operator, startFrom) {
         };
     }
     else {
-        startFrom = (typeof operator === 'number') || (operator === false) ? operator : 0;
+        backward = startFrom === true ? true : false;
+        startFrom = typeof (operator) === 'number' ? operator : (backward ? arr.length - 1 : 0);
         operator = val;
         if (isObject(prop)) {
             filter = prop;
@@ -151,17 +154,15 @@ export default function search(arr, prop, val, operator, startFrom) {
         }
     }
     if (isFn || (isObject(filter) && numProperties(filter))) {
-        var dir = 'asc';
-        if ((startFrom === undefined) && (typeof operator !== 'string')) {
-            startFrom = operator;
+        if (isNumber(operator)) {
+            startFrom = typeof (operator) === 'number' ? operator : 0;
             operator = undefined;
         }
-        if (startFrom === false) {
-            startFrom = arr.length - 1;
-            dir = 'desc';
+        if (typeof startFrom !== 'number') {
+            startFrom = backward ? arr.length - 1 : 0;
         }
         if (typeof filter === 'function') {
-            if (dir === 'desc') {
+            if (backward) {
                 for (var i = startFrom; i >= 0; i--) {
                     if (filter(arr[i])) {
                         return i;
@@ -178,7 +179,7 @@ export default function search(arr, prop, val, operator, startFrom) {
         }
         else {
             filter = filterToConditions(filter);
-            if (dir === 'desc') {
+            if (backward) {
                 for (var i = startFrom; i >= 0; i--) {
                     if (compareConditions(arr[i], filter)) {
                         return i;

package/dist/fn.d.ts

@@ -100,6 +100,7 @@ import getDeviceType from './fn/browser/getDeviceType.js';
 import getEventData from './fn/browser/getEventData.js';
 import getField from './fn/object/getField.js';
 import getFieldValues from './fn/object/getFieldValues.js';
+import getIndex from './fn/html/getIndex.js';
 import getHtml from './fn/html/getHtml.js';
 import getHTMLOfSelection from './fn/html/getHTMLOfSelection.js';
 import getLoader from './fn/ajax/getLoader.js';
@@ -340,6 +341,7 @@ declare const _default: {
     getEventData: typeof getEventData;
     getField: typeof getField;
     getFieldValues: typeof getFieldValues;
+    getIndex: typeof getIndex;
     getHtml: typeof getHtml;
     getHTMLOfSelection: typeof getHTMLOfSelection;
     getLoader: typeof getLoader;

package/dist/fn.js

@@ -100,6 +100,7 @@ import getDeviceType from './fn/browser/getDeviceType.js';
 import getEventData from './fn/browser/getEventData.js';
 import getField from './fn/object/getField.js';
 import getFieldValues from './fn/object/getFieldValues.js';
+import getIndex from './fn/html/getIndex.js';
 import getHtml from './fn/html/getHtml.js';
 import getHTMLOfSelection from './fn/html/getHTMLOfSelection.js';
 import getLoader from './fn/ajax/getLoader.js';
@@ -340,6 +341,7 @@ export default {
     getEventData: getEventData,
     getField: getField,
     getFieldValues: getFieldValues,
+    getIndex: getIndex,
     getHtml: getHtml,
     getHTMLOfSelection: getHTMLOfSelection,
     getLoader: getLoader,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bbn/bbn",
-  "version": "1.0.350",
+  "version": "1.0.352",
   "description": "Javascript toolkit",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",