@lumx/core 3.20.1-alpha.3 → 3.20.1-alpha.30

package/js/utils/collection/isEmpty.test.js

@@ -0,0 +1,21 @@
+import { isEmpty } from './isEmpty.js';
+
+describe(isEmpty, () => {
+  it('should return true for falsy values', () => {
+    expect(isEmpty(undefined)).toBe(true);
+    expect(isEmpty(null)).toBe(true);
+    expect(isEmpty(0)).toBe(true);
+    expect(isEmpty('')).toBe(true);
+    expect(isEmpty(false)).toBe(true);
+  });
+  it('should return true for empty object or array', () => {
+    expect(isEmpty([])).toBe(true);
+    expect(isEmpty({})).toBe(true);
+  });
+  it('should return false for non empty object or array', () => {
+    expect(isEmpty([''])).toBe(false);
+    expect(isEmpty({
+      foo: false
+    })).toBe(false);
+  });
+});

package/js/utils/collection/isEmpty.test.ts

@@ -0,0 +1,21 @@
+import { isEmpty } from './isEmpty';
+
+describe(isEmpty, () => {
+    it('should return true for falsy values', () => {
+        expect(isEmpty(undefined)).toBe(true);
+        expect(isEmpty(null)).toBe(true);
+        expect(isEmpty(0)).toBe(true);
+        expect(isEmpty('')).toBe(true);
+        expect(isEmpty(false)).toBe(true);
+    });
+
+    it('should return true for empty object or array', () => {
+        expect(isEmpty([])).toBe(true);
+        expect(isEmpty({})).toBe(true);
+    });
+
+    it('should return false for non empty object or array', () => {
+        expect(isEmpty([''])).toBe(false);
+        expect(isEmpty({ foo: false })).toBe(false);
+    });
+});

package/js/utils/collection/isEmpty.ts

@@ -0,0 +1,4 @@
+import type { Falsy } from '../../types';
+
+/** Check if object or array is empty (true on falsy values) */
+export const isEmpty = (obj: NonNullable<unknown> | Falsy) => !obj || Object.entries(obj).length === 0;

package/js/utils/collection/last.js

@@ -0,0 +1,4 @@
+/** Get last item from array */
+const last = array => array[array.length - 1];
+
+export { last };

package/js/utils/collection/last.test.js

@@ -0,0 +1,19 @@
+import { last } from '@lumx/core/js/utils/collection/last';
+
+describe(last, () => {
+  it('should return undefined for empty array', () => {
+    const input = [];
+    const output = last(input);
+    expect(output).toBeUndefined();
+  });
+  it('should return last element from array with single element', () => {
+    const input = [42];
+    const output = last(input);
+    expect(output).toBe(42);
+  });
+  it('should return last element from array with multiple elements', () => {
+    const input = [1, 2, 3, 4, 5];
+    const output = last(input);
+    expect(output).toBe(5);
+  });
+});

package/js/utils/collection/last.test.ts

@@ -0,0 +1,21 @@
+import { last } from '@lumx/core/js/utils/collection/last';
+
+describe(last, () => {
+    it('should return undefined for empty array', () => {
+        const input: number[] = [];
+        const output = last(input);
+        expect(output).toBeUndefined();
+    });
+
+    it('should return last element from array with single element', () => {
+        const input = [42];
+        const output = last(input);
+        expect(output).toBe(42);
+    });
+
+    it('should return last element from array with multiple elements', () => {
+        const input = [1, 2, 3, 4, 5];
+        const output = last(input);
+        expect(output).toBe(5);
+    });
+});

package/js/utils/collection/last.ts

@@ -0,0 +1,2 @@
+/** Get last item from array */
+export const last = <T>(array: Array<T>): T | undefined => array[array.length - 1];

package/js/utils/collection/partitionMulti.js

@@ -0,0 +1,28 @@
+/**
+ * Similar to lodash `partition` function but working with multiple predicates.
+ *
+ * @example
+ * const isString = (s) => typeof s === 'string'
+ * const isNumber = (s) => typeof s === 'number'
+ * const [strings, numbers, others] = partitionMulti(['a', 1, 'b', false], [isString, isNumber])
+ * //=> [['a', 'b'], [1], [false]]
+ *
+ * @param  elements array of elements
+ * @param  predicates array of predicates to apply on elements
+ * @return partitioned elements by the given predicates
+ */
+function partitionMulti(elements, predicates) {
+  const others = [];
+  const groups = predicates.map(() => []);
+  for (const element of elements) {
+    const index = predicates.findIndex(predicate => predicate(element));
+    if (index !== -1) {
+      groups[index].push(element);
+    } else {
+      others.push(element);
+    }
+  }
+  return [...groups, others];
+}
+
+export { partitionMulti };

package/js/utils/collection/partitionMulti.test.js

@@ -0,0 +1,26 @@
+import { partitionMulti } from './partitionMulti.js';
+
+describe('partitionMulti', () => {
+  it('should partition with single predicate', () => {
+    const data = [0, 1, 2, 3, 4, 5];
+    const isEven = n => n % 2 === 0;
+    const actual = partitionMulti(data, [isEven]);
+    expect(actual).toEqual([[0, 2, 4], [1, 3, 5]]);
+  });
+  it('should partition on multiple predicates', () => {
+    const data = ['a', 1, 'b', false, true];
+    const isString = s => typeof s === 'string';
+    const isNumber = s => typeof s === 'number';
+    const isNull = s => s === null;
+    const partitions = partitionMulti(data, [isString, isNumber, isNull]);
+    expect(partitions).toEqual([
+    // strings
+    ['a', 'b'],
+    // numbers
+    [1],
+    // nulls
+    [],
+    // others
+    [false, true]]);
+  });
+});

package/js/utils/collection/partitionMulti.test.ts

@@ -0,0 +1,35 @@
+import { partitionMulti } from './partitionMulti';
+
+describe('partitionMulti', () => {
+    it('should partition with single predicate', () => {
+        const data = [0, 1, 2, 3, 4, 5];
+        const isEven = (n: number): boolean => n % 2 === 0;
+
+        const actual = partitionMulti(data, [isEven]);
+
+        expect(actual).toEqual([
+            [0, 2, 4],
+            [1, 3, 5],
+        ]);
+    });
+
+    it('should partition on multiple predicates', () => {
+        type T = string | number | boolean;
+        const data: T[] = ['a', 1, 'b', false, true];
+        const isString = (s: T): boolean => typeof s === 'string';
+        const isNumber = (s: T): boolean => typeof s === 'number';
+        const isNull = (s: T): boolean => s === null;
+
+        const partitions = partitionMulti(data, [isString, isNumber, isNull]);
+        expect(partitions).toEqual([
+            // strings
+            ['a', 'b'],
+            // numbers
+            [1],
+            // nulls
+            [],
+            // others
+            [false, true],
+        ]);
+    });
+});

package/js/utils/collection/partitionMulti.ts

@@ -0,0 +1,29 @@
+import type { Predicate } from '@lumx/core/js/types';
+
+/**
+ * Similar to lodash `partition` function but working with multiple predicates.
+ *
+ * @example
+ * const isString = (s) => typeof s === 'string'
+ * const isNumber = (s) => typeof s === 'number'
+ * const [strings, numbers, others] = partitionMulti(['a', 1, 'b', false], [isString, isNumber])
+ * //=> [['a', 'b'], [1], [false]]
+ *
+ * @param  elements array of elements
+ * @param  predicates array of predicates to apply on elements
+ * @return partitioned elements by the given predicates
+ */
+export function partitionMulti<T>(elements: T[], predicates: Array<Predicate<T>>): T[][] {
+    const others = [] as T[];
+    const groups = predicates.map(() => []) as T[][];
+
+    for (const element of elements) {
+        const index = predicates.findIndex((predicate) => predicate(element));
+        if (index !== -1) {
+            groups[index].push(element);
+        } else {
+            others.push(element);
+        }
+    }
+    return [...groups, others];
+}

package/js/utils/collection/range.js

@@ -0,0 +1,6 @@
+/** Generate a range of number starting at 0 and ending before the given number */
+const range = end => Array.from({
+  length: end
+}, (_, i) => i);
+
+export { range };

package/js/utils/collection/range.test.js

@@ -0,0 +1,10 @@
+import { range } from './range.js';
+
+describe(range, () => {
+  it('should generate a number range', () => {
+    expect(range(-2)).toEqual([]);
+    expect(range(0)).toEqual([]);
+    expect(range(1)).toEqual([0]);
+    expect(range(5)).toEqual([0, 1, 2, 3, 4]);
+  });
+});

package/js/utils/collection/range.test.ts

@@ -0,0 +1,10 @@
+import { range } from './range';
+
+describe(range, () => {
+    it('should generate a number range', () => {
+        expect(range(-2)).toEqual([]);
+        expect(range(0)).toEqual([]);
+        expect(range(1)).toEqual([0]);
+        expect(range(5)).toEqual([0, 1, 2, 3, 4]);
+    });
+});

package/js/utils/collection/range.ts

@@ -0,0 +1,2 @@
+/** Generate a range of number starting at 0 and ending before the given number */
+export const range = (end: number) => Array.from({ length: end }, (_, i) => i);

package/js/utils/index.js

@@ -1,24 +1,14 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var noop = require('lodash/noop');
-var js_utils_className_handleBasicClasses = require('./className/handleBasicClasses.js');
-var js_utils_className_getBasicClass = require('./className/getBasicClass.js');
-var js_utils_className_getRootClassName = require('./className/getRootClassName.js');
-var js_utils_className_getTypographyClassName = require('./className/getTypographyClassName.js');
-var js_utils_className_fontColorClass = require('./className/fontColorClass.js');
-var js_utils_className_resolveColorWithVariants = require('./className/resolveColorWithVariants.js');
-require('classnames');
-require('lodash/isBoolean');
-require('lodash/isEmpty');
-require('lodash/kebabCase');
-require('../constants/index.js');
-require('../constants/keycodes.js');
-
-function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
-
-var noop__default = /*#__PURE__*/_interopDefaultLegacy(noop);
+export { handleBasicClasses } from './className/handleBasicClasses.js';
+export { getBasicClass } from './className/getBasicClass.js';
+export { getRootClassName } from './className/getRootClassName.js';
+export { getTypographyClassName } from './className/getTypographyClassName.js';
+export { fontColorClass } from './className/fontColorClass.js';
+export { resolveColorWithVariants } from './className/resolveColorWithVariants.js';
+import 'classnames';
+import '@lumx/core/js/utils/collection/isEmpty';
+import './string/kebabCase.js';
+import '../constants/index.js';
+import '../constants/keycodes.js';
 
 /**
  * Make sure the pressed key is the enter key before calling the callback.
@@ -27,13 +17,14 @@ var noop__default = /*#__PURE__*/_interopDefaultLegacy(noop);
  * @return The decorated function.
  */
 function onEnterPressed(handler) {
-    return (evt) => {
-        if (evt.key !== 'Enter') {
-            return;
-        }
-        handler(evt);
-    };
+  return evt => {
+    if (evt.key !== 'Enter') {
+      return;
+    }
+    handler(evt);
+  };
 }
+
 /**
  * Make sure the pressed key is the escape key before calling the callback.
  *
@@ -41,13 +32,14 @@ function onEnterPressed(handler) {
  * @return The decorated function.
  */
 function onEscapePressed(handler) {
-    return (evt) => {
-        if (evt.key !== 'Escape') {
-            return;
-        }
-        handler(evt);
-    };
+  return evt => {
+    if (evt.key !== 'Escape') {
+      return;
+    }
+    handler(evt);
+  };
 }
+
 /**
  * Handle button key pressed (Enter + Space).
  *
@@ -55,12 +47,12 @@ function onEscapePressed(handler) {
  * @return The decorated function.
  */
 function onButtonPressed(handler) {
-    return (evt) => {
-        if (evt.key !== 'Enter' && evt.key !== ' ') {
-            return;
-        }
-        handler(evt);
-    };
+  return evt => {
+    if (evt.key !== 'Enter' && evt.key !== ' ') {
+      return;
+    }
+    handler(evt);
+  };
 }
 /**
  * Detects swipe direction.
@@ -71,153 +63,146 @@ function onButtonPressed(handler) {
  * @param  handleSwipe Callback function.
  * @return Function to remove listeners.
  */
-function detectSwipe(touchSurface, handleSwipe = noop__default["default"]) {
-    let distX;
-    let distY;
-    let startX;
-    let startY;
-    let direction;
-    // Required min distance traveled to be considered swipe.
-    const threshold = 150;
-    // Maximum distance allowed at the same time in perpendicular direction.
-    const restraint = 100;
-    // Maximum time allowed to travel that distance.
-    const allowedTime = 300;
-    let elapsedTime;
-    let startTime;
-    const onTouchStart = (evt) => {
-        const [touch] = Array.from(evt.changedTouches);
-        direction = 'none';
-        // Const dist = 0;
-        startX = touch.pageX;
-        startY = touch.pageY;
-        // Record time when finger first makes contact with surface.
-        startTime = new Date().getTime();
-        evt.preventDefault();
-    };
-    const onTouchMove = (evt) => {
-        // Prevent scrolling when inside DIV.
-        evt.preventDefault();
-    };
-    const onTouchEnd = (evt) => {
-        const [touch] = Array.from(evt.changedTouches);
-        // Get horizontal dist traveled by finger while in contact with surface.
-        distX = touch.pageX - startX;
-        // Get vertical dist traveled by finger while in contact with surface.
-        distY = touch.pageY - startY;
-        // Get time elapsed.
-        elapsedTime = new Date().getTime() - startTime;
-        if (elapsedTime <= allowedTime) {
-            // First condition for awipe met.
-            if (Math.abs(distX) >= threshold && Math.abs(distY) <= restraint) {
-                // 2nd condition for horizontal swipe met.
-                // If dist traveled is negative, it indicates left swipe.
-                direction = distX < 0 ? 'left' : 'right';
-            }
-            else if (Math.abs(distY) >= threshold && Math.abs(distX) <= restraint) {
-                // 2nd condition for vertical swipe met.
-                // If dist traveled is negative, it indicates up swipe.
-                direction = distY < 0 ? 'up' : 'down';
-            }
-        }
-        handleSwipe(direction);
-        evt.preventDefault();
-    };
-    touchSurface.addEventListener('touchstart', onTouchStart, false);
-    touchSurface.addEventListener('touchmove', onTouchMove, false);
-    touchSurface.addEventListener('touchend', onTouchEnd, false);
-    return () => {
-        touchSurface.removeEventListener('touchstart', onTouchStart, false);
-        touchSurface.removeEventListener('touchmove', onTouchMove, false);
-        touchSurface.removeEventListener('touchend', onTouchEnd, false);
-    };
+function detectSwipe(touchSurface, handleSwipe) {
+  let distX;
+  let distY;
+  let startX;
+  let startY;
+  let direction;
+  // Required min distance traveled to be considered swipe.
+  const threshold = 150;
+  // Maximum distance allowed at the same time in perpendicular direction.
+  const restraint = 100;
+  // Maximum time allowed to travel that distance.
+  const allowedTime = 300;
+  let elapsedTime;
+  let startTime;
+  const onTouchStart = evt => {
+    const [touch] = Array.from(evt.changedTouches);
+    direction = 'none';
+    // Const dist = 0;
+    startX = touch.pageX;
+    startY = touch.pageY;
+    // Record time when finger first makes contact with surface.
+    startTime = new Date().getTime();
+    evt.preventDefault();
+  };
+  const onTouchMove = evt => {
+    // Prevent scrolling when inside DIV.
+    evt.preventDefault();
+  };
+  const onTouchEnd = evt => {
+    const [touch] = Array.from(evt.changedTouches);
+    // Get horizontal dist traveled by finger while in contact with surface.
+    distX = touch.pageX - startX;
+    // Get vertical dist traveled by finger while in contact with surface.
+    distY = touch.pageY - startY;
+    // Get time elapsed.
+    elapsedTime = new Date().getTime() - startTime;
+    if (elapsedTime <= allowedTime) {
+      // First condition for awipe met.
+      if (Math.abs(distX) >= threshold && Math.abs(distY) <= restraint) {
+        // 2nd condition for horizontal swipe met.
+        // If dist traveled is negative, it indicates left swipe.
+        direction = distX < 0 ? 'left' : 'right';
+      } else if (Math.abs(distY) >= threshold && Math.abs(distX) <= restraint) {
+        // 2nd condition for vertical swipe met.
+        // If dist traveled is negative, it indicates up swipe.
+        direction = distY < 0 ? 'up' : 'down';
+      }
+    }
+    handleSwipe?.(direction);
+    evt.preventDefault();
+  };
+  touchSurface.addEventListener('touchstart', onTouchStart, false);
+  touchSurface.addEventListener('touchmove', onTouchMove, false);
+  touchSurface.addEventListener('touchend', onTouchEnd, false);
+  return () => {
+    touchSurface.removeEventListener('touchstart', onTouchStart, false);
+    touchSurface.removeEventListener('touchmove', onTouchMove, false);
+    touchSurface.removeEventListener('touchend', onTouchEnd, false);
+  };
 }
+
 /**
  * Checks whether or not the browser support passive events.
  * @see https://github.com/Modernizr/Modernizr/blob/6d56d814b9682843313b16060adb25a58d83a317/feature-detects/dom/passiveeventlisteners.js
  */
 function isPassiveEventAvailable() {
-    let supportsPassiveOption = false;
-    try {
-        const opts = Object.defineProperty({}, 'passive', {
-            get() {
-                supportsPassiveOption = true;
-            },
-        });
-        window.addEventListener('testPassiveEventSupport', noop__default["default"], opts);
-        window.removeEventListener('testPassiveEventSupport', noop__default["default"], opts);
-    }
-    catch (e) {
-        // ignored
-    }
-    return supportsPassiveOption;
+  let supportsPassiveOption = false;
+  try {
+    const opts = Object.defineProperty({}, 'passive', {
+      get() {
+        supportsPassiveOption = true;
+      }
+    });
+    window.addEventListener('testPassiveEventSupport', () => {}, opts);
+    window.removeEventListener('testPassiveEventSupport', () => {}, opts);
+  } catch (e) {
+    // ignored
+  }
+  return supportsPassiveOption;
 }
+
 /**
  * Detects horizontal swipe direction without blocking the browser scroll using passive event.
  * @see http://javascriptkit.com/javatutors/touchevents2.shtml
  * @see https://github.com/WICG/EventListenerOptions/blob/gh-pages/explainer.md
  */
 function detectHorizontalSwipe(touchSurface, handleSwipe) {
-    let startX;
-    let startY;
-    // Required min distance traveled to be considered swipe.
-    const threshold = 150;
-    // Maximum distance allowed at the same time in perpendicular direction.
-    const restraint = 150;
-    // Maximum time allowed to travel that distance.
-    const allowedTime = 300;
-    let elapsedTime;
-    let startTime;
-    let finished;
-    const onTouchStart = (evt) => {
-        const [touch] = Array.from(evt.changedTouches);
-        startX = touch.pageX;
-        startY = touch.pageY;
-        // Record time when finger first makes contact with surface.
-        startTime = new Date().getTime();
-        finished = false;
-    };
-    const onTouchMove = (evt) => {
-        if (finished) {
-            return;
-        }
-        elapsedTime = new Date().getTime() - startTime;
-        if (elapsedTime > allowedTime) {
-            // Touch swipe too long to be considered.
-            return;
-        }
-        const [touch] = Array.from(evt.changedTouches);
-        // Get horizontal dist traveled by finger while in contact with surface.
-        const distX = touch.pageX - startX;
-        // Get vertical dist traveled by finger while in contact with surface.
-        const distY = touch.pageY - startY;
-        if (!(Math.abs(distX) >= threshold && Math.abs(distY) <= restraint)) {
-            // Swipe is not horizontal.
-            return;
-        }
-        // Swipe direction.
-        const direction = distX < 0 ? 'left' : 'right';
-        handleSwipe(direction);
-        finished = true;
-    };
-    // Activate passive event if possible for better scrolling performance.
-    const eventOptions = isPassiveEventAvailable() ? { passive: true } : false;
-    touchSurface.addEventListener('touchstart', onTouchStart, eventOptions);
-    touchSurface.addEventListener('touchmove', onTouchMove, eventOptions);
-    return () => {
-        touchSurface.removeEventListener('touchstart', onTouchStart, eventOptions);
-        touchSurface.removeEventListener('touchmove', onTouchMove, eventOptions);
-    };
+  let startX;
+  let startY;
+  // Required min distance traveled to be considered swipe.
+  const threshold = 150;
+  // Maximum distance allowed at the same time in perpendicular direction.
+  const restraint = 150;
+  // Maximum time allowed to travel that distance.
+  const allowedTime = 300;
+  let elapsedTime;
+  let startTime;
+  let finished;
+  const onTouchStart = evt => {
+    const [touch] = Array.from(evt.changedTouches);
+    startX = touch.pageX;
+    startY = touch.pageY;
+    // Record time when finger first makes contact with surface.
+    startTime = new Date().getTime();
+    finished = false;
+  };
+  const onTouchMove = evt => {
+    if (finished) {
+      return;
+    }
+    elapsedTime = new Date().getTime() - startTime;
+    if (elapsedTime > allowedTime) {
+      // Touch swipe too long to be considered.
+      return;
+    }
+    const [touch] = Array.from(evt.changedTouches);
+    // Get horizontal dist traveled by finger while in contact with surface.
+    const distX = touch.pageX - startX;
+    // Get vertical dist traveled by finger while in contact with surface.
+    const distY = touch.pageY - startY;
+    if (!(Math.abs(distX) >= threshold && Math.abs(distY) <= restraint)) {
+      // Swipe is not horizontal.
+      return;
+    }
+    // Swipe direction.
+    const direction = distX < 0 ? 'left' : 'right';
+    handleSwipe(direction);
+    finished = true;
+  };
+
+  // Activate passive event if possible for better scrolling performance.
+  const eventOptions = isPassiveEventAvailable() ? {
+    passive: true
+  } : false;
+  touchSurface.addEventListener('touchstart', onTouchStart, eventOptions);
+  touchSurface.addEventListener('touchmove', onTouchMove, eventOptions);
+  return () => {
+    touchSurface.removeEventListener('touchstart', onTouchStart, eventOptions);
+    touchSurface.removeEventListener('touchmove', onTouchMove, eventOptions);
+  };
 }
 
-exports.handleBasicClasses = js_utils_className_handleBasicClasses.handleBasicClasses;
-exports.getBasicClass = js_utils_className_getBasicClass.getBasicClass;
-exports.getRootClassName = js_utils_className_getRootClassName.getRootClassName;
-exports.getTypographyClassName = js_utils_className_getTypographyClassName.getTypographyClassName;
-exports.fontColorClass = js_utils_className_fontColorClass.fontColorClass;
-exports.resolveColorWithVariants = js_utils_className_resolveColorWithVariants.resolveColorWithVariants;
-exports.detectHorizontalSwipe = detectHorizontalSwipe;
-exports.detectSwipe = detectSwipe;
-exports.onButtonPressed = onButtonPressed;
-exports.onEnterPressed = onEnterPressed;
-exports.onEscapePressed = onEscapePressed;
+export { detectHorizontalSwipe, detectSwipe, onButtonPressed, onEnterPressed, onEscapePressed };