@lumx/core 3.20.1-alpha.36 → 3.20.1-alpha.38

package/js/utils/className/getBasicClass.js

@@ -1,7 +1,6 @@
 'use strict';
 
-var isBoolean = require('lodash/isBoolean');
-var kebabCase = require('lodash/kebabCase');
+var js_utils_string_kebabCase = require('../string/kebabCase.js');
 
 /**
  * Get the basic CSS class for the given type.
@@ -12,18 +11,18 @@ var kebabCase = require('lodash/kebabCase');
  * @return The basic CSS class.
  */
 function getBasicClass({ prefix, type, value, }) {
-    if (isBoolean(value)) {
+    if (typeof value === 'boolean') {
         if (!value) {
             // False value should not return a class.
             return '';
         }
         const booleanPrefixes = ['has', 'is'];
         if (booleanPrefixes.some((booleanPrefix) => type.toString().startsWith(booleanPrefix))) {
-            return `${prefix}--${kebabCase(type)}`;
+            return `${prefix}--${js_utils_string_kebabCase.kebabCase(type)}`;
         }
-        return `${prefix}--is-${kebabCase(type)}`;
+        return `${prefix}--is-${js_utils_string_kebabCase.kebabCase(type)}`;
     }
-    return `${prefix}--${kebabCase(type)}-${value}`;
+    return `${prefix}--${js_utils_string_kebabCase.kebabCase(type)}-${value}`;
 }
 
 exports.getBasicClass = getBasicClass;

package/js/utils/className/getBasicClass.min.js

@@ -1 +1 @@
-"use strict";var e=require("lodash/isBoolean"),r=require("lodash/kebabCase");exports.getBasicClass=function({prefix:s,type:t,value:i}){if(e(i)){if(!i)return"";return["has","is"].some(e=>t.toString().startsWith(e))?`${s}--${r(t)}`:`${s}--is-${r(t)}`}return`${s}--${r(t)}-${i}`};
+"use strict";var e=require("../string/kebabCase.min.js");exports.getBasicClass=function({prefix:s,type:t,value:a}){if("boolean"==typeof a){if(!a)return"";return["has","is"].some(e=>t.toString().startsWith(e))?`${s}--${e.kebabCase(t)}`:`${s}--is-${e.kebabCase(t)}`}return`${s}--${e.kebabCase(t)}-${a}`};

package/js/utils/className/getBasicClass.test.js

@@ -1,8 +1,7 @@
 'use strict';
 
 var js_utils_className_getBasicClass = require('./getBasicClass.js');
-require('lodash/isBoolean');
-require('lodash/kebabCase');
+require('../string/kebabCase.js');
 
 describe(js_utils_className_getBasicClass.getBasicClass, () => {
     it('should return correct basic CSS class for different types and values', () => {

package/js/utils/className/getBasicClass.test.min.js

@@ -1 +1 @@
-"use strict";var e=require("./getBasicClass.min.js");require("lodash/isBoolean"),require("lodash/kebabCase"),describe(e.getBasicClass,()=>{it("should return correct basic CSS class for different types and values",()=>{expect(e.getBasicClass({prefix:"test",type:"color",value:"primary"})).toBe("test--color-primary"),expect(e.getBasicClass({prefix:"test",type:"variant",value:"button"})).toBe("test--variant-button"),expect(e.getBasicClass({prefix:"test",type:"isDark",value:!0})).toBe("test--is-dark"),expect(e.getBasicClass({prefix:"test",type:"dark",value:!0})).toBe("test--is-dark"),expect(e.getBasicClass({prefix:"test",type:"hasDark",value:!0})).toBe("test--has-dark"),expect(e.getBasicClass({prefix:"test",type:"isActive",value:!1})).toBe(""),expect(e.getBasicClass({prefix:"test",type:"hasBorder",value:!0})).toBe("test--has-border"),expect(e.getBasicClass({prefix:"test",type:"isVisible",value:!1})).toBe(""),expect(e.getBasicClass({prefix:"test",type:"variant",value:void 0})).toBe("test--variant-undefined")})});
+"use strict";var e=require("./getBasicClass.min.js");require("../string/kebabCase.min.js"),describe(e.getBasicClass,()=>{it("should return correct basic CSS class for different types and values",()=>{expect(e.getBasicClass({prefix:"test",type:"color",value:"primary"})).toBe("test--color-primary"),expect(e.getBasicClass({prefix:"test",type:"variant",value:"button"})).toBe("test--variant-button"),expect(e.getBasicClass({prefix:"test",type:"isDark",value:!0})).toBe("test--is-dark"),expect(e.getBasicClass({prefix:"test",type:"dark",value:!0})).toBe("test--is-dark"),expect(e.getBasicClass({prefix:"test",type:"hasDark",value:!0})).toBe("test--has-dark"),expect(e.getBasicClass({prefix:"test",type:"isActive",value:!1})).toBe(""),expect(e.getBasicClass({prefix:"test",type:"hasBorder",value:!0})).toBe("test--has-border"),expect(e.getBasicClass({prefix:"test",type:"isVisible",value:!1})).toBe(""),expect(e.getBasicClass({prefix:"test",type:"variant",value:void 0})).toBe("test--variant-undefined")})});

package/js/utils/className/getBasicClass.ts

@@ -1,5 +1,4 @@
-import isBoolean from 'lodash/isBoolean';
-import kebabCase from 'lodash/kebabCase';
+import { kebabCase } from '../string/kebabCase';
 
 /**
  * Get the basic CSS class for the given type.
@@ -18,7 +17,7 @@ export function getBasicClass({
     type: string;
     value: string | number | boolean | undefined;
 }): string {
-    if (isBoolean(value)) {
+    if (typeof value === 'boolean') {
         if (!value) {
             // False value should not return a class.
             return '';

package/js/utils/className/getRootClassName.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var kebabCase = require('lodash/kebabCase');
 var js_constants_index = require('../../constants/index.js');
+var js_utils_string_kebabCase = require('../string/kebabCase.js');
 require('../../constants/keycodes.js');
 
 // See https://regex101.com/r/YjS1uI/3
@@ -17,7 +17,7 @@ const LAST_PART_CLASSNAME = /^(.*)-(.+)$/gi;
  *         lower-snake-case.
  */
 function getRootClassName(componentName, subComponent) {
-    const formattedClassName = `${js_constants_index.CSS_PREFIX}-${kebabCase(componentName)}`;
+    const formattedClassName = `${js_constants_index.CSS_PREFIX}-${js_utils_string_kebabCase.kebabCase(componentName)}`;
     if (subComponent) {
         return formattedClassName.replace(LAST_PART_CLASSNAME, '$1__$2');
     }

package/js/utils/className/getRootClassName.min.js

@@ -1 +1 @@
-"use strict";var e=require("lodash/kebabCase"),s=require("../../constants/index.min.js");require("../../constants/keycodes.min.js");const t=/^(.*)-(.+)$/gi;exports.getRootClassName=function(n,r){const o=`${s.CSS_PREFIX}-${e(n)}`;return r?o.replace(t,"$1__$2"):o};
+"use strict";var e=require("../../constants/index.min.js"),s=require("../string/kebabCase.min.js");require("../../constants/keycodes.min.js");const n=/^(.*)-(.+)$/gi;exports.getRootClassName=function(t,r){const i=`${e.CSS_PREFIX}-${s.kebabCase(t)}`;return r?i.replace(n,"$1__$2"):i};

package/js/utils/className/getRootClassName.test.js

@@ -1,9 +1,9 @@
 'use strict';
 
 var js_utils_className_getRootClassName = require('./getRootClassName.js');
-require('lodash/kebabCase');
 require('../../constants/index.js');
 require('../../constants/keycodes.js');
+require('../string/kebabCase.js');
 
 describe(js_utils_className_getRootClassName.getRootClassName, () => {
     it('should transform the component name into a lumx class', () => {

package/js/utils/className/getRootClassName.test.min.js

@@ -1 +1 @@
-"use strict";var e=require("./getRootClassName.min.js");require("lodash/kebabCase"),require("../../constants/index.min.js"),require("../../constants/keycodes.min.js"),describe(e.getRootClassName,()=>{it("should transform the component name into a lumx class",()=>{expect(e.getRootClassName("Table")).toBe("lumx-table")}),it("should transform the sub component name into a lumx class",()=>{expect(e.getRootClassName("TableBody",!0)).toBe("lumx-table__body")})});
+"use strict";var e=require("./getRootClassName.min.js");require("../../constants/index.min.js"),require("../../constants/keycodes.min.js"),require("../string/kebabCase.min.js"),describe(e.getRootClassName,()=>{it("should transform the component name into a lumx class",()=>{expect(e.getRootClassName("Table")).toBe("lumx-table")}),it("should transform the sub component name into a lumx class",()=>{expect(e.getRootClassName("TableBody",!0)).toBe("lumx-table__body")})});

package/js/utils/className/getRootClassName.ts

@@ -1,6 +1,5 @@
-import kebabCase from 'lodash/kebabCase';
-
 import { CSS_PREFIX } from '../../constants';
+import { kebabCase } from '../string/kebabCase';
 
 // See https://regex101.com/r/YjS1uI/3
 const LAST_PART_CLASSNAME = /^(.*)-(.+)$/gi;

package/js/utils/className/handleBasicClasses.js

@@ -1,10 +1,9 @@
 'use strict';
 
 var classNames = require('classnames');
-var isBoolean = require('lodash/isBoolean');
-var isEmpty = require('lodash/isEmpty');
+var js_utils_collection_isEmpty = require('../collection/isEmpty.js');
 var js_utils_className_getBasicClass = require('./getBasicClass.js');
-require('lodash/kebabCase');
+require('../string/kebabCase.js');
 
 /**
  * Enhance isEmpty method to also works with numbers.
@@ -16,7 +15,7 @@ const _isEmpty = (value) => {
     if (typeof value === 'number') {
         return value === 0;
     }
-    return isEmpty(value);
+    return js_utils_collection_isEmpty.isEmpty(value);
 };
 /**
  * Return all basic LumX CSS classes which are available for every components.
@@ -31,11 +30,10 @@ const _isEmpty = (value) => {
  */
 function handleBasicClasses({ prefix, ...props }) {
     const otherClasses = {};
-    if (!isEmpty(props)) {
+    if (!js_utils_collection_isEmpty.isEmpty(props)) {
         Object.keys(props).forEach((prop) => {
-            otherClasses[js_utils_className_getBasicClass.getBasicClass({ prefix, type: prop, value: props[prop] })] = isBoolean(props[prop])
-                ? props[prop]
-                : !_isEmpty(props[prop]);
+            otherClasses[js_utils_className_getBasicClass.getBasicClass({ prefix, type: prop, value: props[prop] })] =
+                typeof props[prop] === 'boolean' ? props[prop] : !_isEmpty(props[prop]);
         });
     }
     return classNames(prefix, otherClasses);

package/js/utils/className/handleBasicClasses.min.js

@@ -1 +1 @@
-"use strict";var e=require("classnames"),s=require("lodash/isBoolean"),r=require("lodash/isEmpty"),a=require("./getBasicClass.min.js");require("lodash/kebabCase");exports.handleBasicClasses=function({prefix:i,...t}){const l={};return r(t)||Object.keys(t).forEach(e=>{var o;l[a.getBasicClass({prefix:i,type:e,value:t[e]})]=s(t[e])?t[e]:!("number"==typeof(o=t[e])?0===o:r(o))}),e(i,l)};
+"use strict";var e=require("classnames"),s=require("../collection/isEmpty.min.js"),i=require("./getBasicClass.min.js");require("../string/kebabCase.min.js");exports.handleBasicClasses=function({prefix:r,...t}){const a={};return s.isEmpty(t)||Object.keys(t).forEach(e=>{var n;a[i.getBasicClass({prefix:r,type:e,value:t[e]})]="boolean"==typeof t[e]?t[e]:!("number"==typeof(n=t[e])?0===n:s.isEmpty(n))}),e(r,a)};

package/js/utils/className/handleBasicClasses.test.js

@@ -2,10 +2,9 @@
 
 var js_utils_className_handleBasicClasses = require('./handleBasicClasses.js');
 require('classnames');
-require('lodash/isBoolean');
-require('lodash/isEmpty');
+require('../collection/isEmpty.js');
 require('./getBasicClass.js');
-require('lodash/kebabCase');
+require('../string/kebabCase.js');
 
 describe(js_utils_className_handleBasicClasses.handleBasicClasses, () => {
     it('should return correct combined CSS classes based on props', () => {

package/js/utils/className/handleBasicClasses.test.min.js

@@ -1 +1 @@
-"use strict";var e=require("./handleBasicClasses.min.js");require("classnames"),require("lodash/isBoolean"),require("lodash/isEmpty"),require("./getBasicClass.min.js"),require("lodash/kebabCase"),describe(e.handleBasicClasses,()=>{it("should return correct combined CSS classes based on props",()=>{const s=e.handleBasicClasses({prefix:"test",undefined:void 0,null:null,emptyString:"",emptyArray:[],emptyObject:{},color:"red",isDisabled:!1,visible:!0,hasButton:!0});expect(s).toBe("test test--color-red test--is-visible test--has-button")})});
+"use strict";var e=require("./handleBasicClasses.min.js");require("classnames"),require("../collection/isEmpty.min.js"),require("./getBasicClass.min.js"),require("../string/kebabCase.min.js"),describe(e.handleBasicClasses,()=>{it("should return correct combined CSS classes based on props",()=>{const s=e.handleBasicClasses({prefix:"test",undefined:void 0,null:null,emptyString:"",emptyArray:[],emptyObject:{},color:"red",isDisabled:!1,visible:!0,hasButton:!0});expect(s).toBe("test test--color-red test--is-visible test--has-button")})});

package/js/utils/className/handleBasicClasses.ts

@@ -1,7 +1,6 @@
 import classNames from 'classnames';
 
-import isBoolean from 'lodash/isBoolean';
-import isEmpty from 'lodash/isEmpty';
+import { isEmpty } from '@lumx/core/js/utils/collection/isEmpty';
 
 import { getBasicClass } from './getBasicClass';
 
@@ -34,9 +33,8 @@ export function handleBasicClasses({ prefix, ...props }: { prefix: string; [prop
     const otherClasses: any = {};
     if (!isEmpty(props)) {
         Object.keys(props).forEach((prop) => {
-            otherClasses[getBasicClass({ prefix, type: prop, value: props[prop] })] = isBoolean(props[prop])
-                ? props[prop]
-                : !_isEmpty(props[prop]);
+            otherClasses[getBasicClass({ prefix, type: prop, value: props[prop] })] =
+                typeof props[prop] === 'boolean' ? props[prop] : !_isEmpty(props[prop]);
         });
     }
 

package/js/utils/className/index.js

@@ -7,9 +7,8 @@ var js_utils_className_getTypographyClassName = require('./getTypographyClassNam
 var js_utils_className_fontColorClass = require('./fontColorClass.js');
 var js_utils_className_resolveColorWithVariants = require('./resolveColorWithVariants.js');
 require('classnames');
-require('lodash/isBoolean');
-require('lodash/isEmpty');
-require('lodash/kebabCase');
+require('../collection/isEmpty.js');
+require('../string/kebabCase.js');
 require('../../constants/index.js');
 require('../../constants/keycodes.js');
 

package/js/utils/className/index.min.js

@@ -1 +1 @@
-"use strict";var s=require("./handleBasicClasses.min.js"),e=require("./getBasicClass.min.js"),a=require("./getRootClassName.min.js"),r=require("./getTypographyClassName.min.js"),o=require("./fontColorClass.min.js"),i=require("./resolveColorWithVariants.min.js");require("classnames"),require("lodash/isBoolean"),require("lodash/isEmpty"),require("lodash/kebabCase"),require("../../constants/index.min.js"),require("../../constants/keycodes.min.js"),exports.handleBasicClasses=s.handleBasicClasses,exports.getBasicClass=e.getBasicClass,exports.getRootClassName=a.getRootClassName,exports.getTypographyClassName=r.getTypographyClassName,exports.fontColorClass=o.fontColorClass,exports.resolveColorWithVariants=i.resolveColorWithVariants;
+"use strict";var s=require("./handleBasicClasses.min.js"),e=require("./getBasicClass.min.js"),a=require("./getRootClassName.min.js"),r=require("./getTypographyClassName.min.js"),i=require("./fontColorClass.min.js"),o=require("./resolveColorWithVariants.min.js");require("classnames"),require("../collection/isEmpty.min.js"),require("../string/kebabCase.min.js"),require("../../constants/index.min.js"),require("../../constants/keycodes.min.js"),exports.handleBasicClasses=s.handleBasicClasses,exports.getBasicClass=e.getBasicClass,exports.getRootClassName=a.getRootClassName,exports.getTypographyClassName=r.getTypographyClassName,exports.fontColorClass=i.fontColorClass,exports.resolveColorWithVariants=o.resolveColorWithVariants;

package/js/utils/collection/castArray.js

@@ -0,0 +1,6 @@
+'use strict';
+
+/** Cast a value into an array if needed */
+const castArray = (arrayOrElement) => Array.isArray(arrayOrElement) ? arrayOrElement : [arrayOrElement];
+
+exports.castArray = castArray;

package/js/utils/collection/castArray.min.js

@@ -0,0 +1 @@
+"use strict";exports.castArray=r=>Array.isArray(r)?r:[r];

package/js/utils/collection/castArray.test.js

@@ -0,0 +1,17 @@
+'use strict';
+
+var js_utils_collection_castArray = require('./castArray.js');
+
+describe(js_utils_collection_castArray.castArray, () => {
+    it('should keep existing array', () => {
+        const input = [1, 2];
+        const output = js_utils_collection_castArray.castArray(input);
+        expect(output).toEqual([1, 2]);
+        expect(output).toBe(input);
+    });
+    it('should cast item to array', () => {
+        const input = 1;
+        const output = js_utils_collection_castArray.castArray(input);
+        expect(output).toEqual([1]);
+    });
+});

package/js/utils/collection/castArray.test.min.js

@@ -0,0 +1 @@
+"use strict";var t=require("./castArray.min.js");describe(t.castArray,()=>{it("should keep existing array",()=>{const r=[1,2],a=t.castArray(r);expect(a).toEqual([1,2]),expect(a).toBe(r)}),it("should cast item to array",()=>{const r=t.castArray(1);expect(r).toEqual([1])})});

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

@@ -0,0 +1,15 @@
+import { castArray } from '@lumx/core/js/utils/collection/castArray';
+
+describe(castArray, () => {
+    it('should keep existing array', () => {
+        const input = [1, 2];
+        const output = castArray(input);
+        expect(output).toEqual([1, 2]);
+        expect(output).toBe(input);
+    });
+    it('should cast item to array', () => {
+        const input = 1;
+        const output = castArray(input);
+        expect(output).toEqual([1]);
+    });
+});

package/js/utils/collection/castArray.ts

@@ -0,0 +1,3 @@
+/** Cast a value into an array if needed */
+export const castArray = <T>(arrayOrElement: T[] | T) =>
+    Array.isArray(arrayOrElement) ? arrayOrElement : [arrayOrElement];

package/js/utils/collection/chunk.js

@@ -0,0 +1,15 @@
+'use strict';
+
+/** Chunk array in slices of given size */
+function chunk(input, size) {
+    if (size <= 0) {
+        throw new Error('Size must be greater than 0');
+    }
+    const result = [];
+    for (let i = 0; i < input.length; i += size) {
+        result.push(input.slice(i, i + size));
+    }
+    return result;
+}
+
+exports.chunk = chunk;

package/js/utils/collection/chunk.min.js

@@ -0,0 +1 @@
+"use strict";exports.chunk=function(t,e){if(e<=0)throw new Error("Size must be greater than 0");const r=[];for(let n=0;n<t.length;n+=e)r.push(t.slice(n,n+e));return r};

package/js/utils/collection/chunk.test.js

@@ -0,0 +1,33 @@
+'use strict';
+
+var js_utils_collection_chunk = require('./chunk.js');
+
+describe(js_utils_collection_chunk.chunk, () => {
+    it('should do nothing on empty array', () => {
+        expect(js_utils_collection_chunk.chunk([], 2)).toEqual([]);
+    });
+    it('should work with size larger than input array', () => {
+        expect(js_utils_collection_chunk.chunk([1, 2], 4)).toEqual([[1, 2]]);
+    });
+    it('should chunk array with size not perfectly dividing the array length', () => {
+        expect(js_utils_collection_chunk.chunk([1, 2, 3, 4, 5], 2)).toEqual([[1, 2], [3, 4], [5]]);
+    });
+    it('should chunk array with size perfectly dividing the array length', () => {
+        expect(js_utils_collection_chunk.chunk([1, 2, 3, 4], 2)).toEqual([
+            [1, 2],
+            [3, 4],
+        ]);
+    });
+    it('should work with size of 1', () => {
+        expect(js_utils_collection_chunk.chunk([1, 2, 3], 1)).toEqual([[1], [2], [3]]);
+    });
+    it('should work with size equal to array length', () => {
+        expect(js_utils_collection_chunk.chunk([1, 2, 3], 3)).toEqual([[1, 2, 3]]);
+    });
+    it('should throw error when size is 0', () => {
+        expect(() => js_utils_collection_chunk.chunk([1, 2, 3], 0)).toThrow('Size must be greater than 0');
+    });
+    it('should throw error when size is negative', () => {
+        expect(() => js_utils_collection_chunk.chunk([1, 2, 3], -1)).toThrow('Size must be greater than 0');
+    });
+});

package/js/utils/collection/chunk.test.min.js

@@ -0,0 +1 @@
+"use strict";var e=require("./chunk.min.js");describe(e.chunk,()=>{it("should do nothing on empty array",()=>{expect(e.chunk([],2)).toEqual([])}),it("should work with size larger than input array",()=>{expect(e.chunk([1,2],4)).toEqual([[1,2]])}),it("should chunk array with size not perfectly dividing the array length",()=>{expect(e.chunk([1,2,3,4,5],2)).toEqual([[1,2],[3,4],[5]])}),it("should chunk array with size perfectly dividing the array length",()=>{expect(e.chunk([1,2,3,4],2)).toEqual([[1,2],[3,4]])}),it("should work with size of 1",()=>{expect(e.chunk([1,2,3],1)).toEqual([[1],[2],[3]])}),it("should work with size equal to array length",()=>{expect(e.chunk([1,2,3],3)).toEqual([[1,2,3]])}),it("should throw error when size is 0",()=>{expect(()=>e.chunk([1,2,3],0)).toThrow("Size must be greater than 0")}),it("should throw error when size is negative",()=>{expect(()=>e.chunk([1,2,3],-1)).toThrow("Size must be greater than 0")})});

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

@@ -0,0 +1,38 @@
+import { chunk } from '@lumx/core/js/utils/collection/chunk';
+
+describe(chunk, () => {
+    it('should do nothing on empty array', () => {
+        expect(chunk([], 2)).toEqual([]);
+    });
+
+    it('should work with size larger than input array', () => {
+        expect(chunk([1, 2], 4)).toEqual([[1, 2]]);
+    });
+
+    it('should chunk array with size not perfectly dividing the array length', () => {
+        expect(chunk([1, 2, 3, 4, 5], 2)).toEqual([[1, 2], [3, 4], [5]]);
+    });
+
+    it('should chunk array with size perfectly dividing the array length', () => {
+        expect(chunk([1, 2, 3, 4], 2)).toEqual([
+            [1, 2],
+            [3, 4],
+        ]);
+    });
+
+    it('should work with size of 1', () => {
+        expect(chunk([1, 2, 3], 1)).toEqual([[1], [2], [3]]);
+    });
+
+    it('should work with size equal to array length', () => {
+        expect(chunk([1, 2, 3], 3)).toEqual([[1, 2, 3]]);
+    });
+
+    it('should throw error when size is 0', () => {
+        expect(() => chunk([1, 2, 3], 0)).toThrow('Size must be greater than 0');
+    });
+
+    it('should throw error when size is negative', () => {
+        expect(() => chunk([1, 2, 3], -1)).toThrow('Size must be greater than 0');
+    });
+});

package/js/utils/collection/chunk.ts

@@ -0,0 +1,11 @@
+/** Chunk array in slices of given size */
+export function chunk<T>(input: Array<T>, size: number): T[][] {
+    if (size <= 0) {
+        throw new Error('Size must be greater than 0');
+    }
+    const result: T[][] = [];
+    for (let i = 0; i < input.length; i += size) {
+        result.push(input.slice(i, i + size));
+    }
+    return result;
+}

package/js/utils/collection/isEmpty.js

@@ -0,0 +1,6 @@
+'use strict';
+
+/** Check if object or array is empty (true on falsy values) */
+const isEmpty = (obj) => !obj || Object.entries(obj).length === 0;
+
+exports.isEmpty = isEmpty;

package/js/utils/collection/isEmpty.min.js

@@ -0,0 +1 @@
+"use strict";exports.isEmpty=t=>!t||0===Object.entries(t).length;

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

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

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

@@ -0,0 +1 @@
+"use strict";var e=require("./isEmpty.min.js");describe(e.isEmpty,()=>{it("should return true for falsy values",()=>{expect(e.isEmpty(void 0)).toBe(!0),expect(e.isEmpty(null)).toBe(!0),expect(e.isEmpty(0)).toBe(!0),expect(e.isEmpty("")).toBe(!0),expect(e.isEmpty(!1)).toBe(!0)}),it("should return true for empty object or array",()=>{expect(e.isEmpty([])).toBe(!0),expect(e.isEmpty({})).toBe(!0)}),it("should return false for non empty object or array",()=>{expect(e.isEmpty([""])).toBe(!1),expect(e.isEmpty({foo:!1})).toBe(!1)})});

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,6 @@
+'use strict';
+
+/** Get last item from array */
+const last = (array) => array[array.length - 1];
+
+exports.last = last;

package/js/utils/collection/last.min.js

@@ -0,0 +1 @@
+"use strict";exports.last=t=>t[t.length-1];

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

@@ -0,0 +1,21 @@
+'use strict';
+
+var js_utils_collection_last = require('./last.js');
+
+describe(js_utils_collection_last.last, () => {
+    it('should return undefined for empty array', () => {
+        const input = [];
+        const output = js_utils_collection_last.last(input);
+        expect(output).toBeUndefined();
+    });
+    it('should return last element from array with single element', () => {
+        const input = [42];
+        const output = js_utils_collection_last.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 = js_utils_collection_last.last(input);
+        expect(output).toBe(5);
+    });
+});

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

@@ -0,0 +1 @@
+"use strict";var e=require("./last.min.js");describe(e.last,()=>{it("should return undefined for empty array",()=>{const t=e.last([]);expect(t).toBeUndefined()}),it("should return last element from array with single element",()=>{const t=e.last([42]);expect(t).toBe(42)}),it("should return last element from array with multiple elements",()=>{const t=e.last([1,2,3,4,5]);expect(t).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,31 @@
+'use strict';
+
+/**
+ * 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];
+}
+
+exports.partitionMulti = partitionMulti;

package/js/utils/collection/partitionMulti.min.js

@@ -0,0 +1 @@
+"use strict";exports.partitionMulti=function(t,n){const o=[],s=n.map(()=>[]);for(const i of t){const t=n.findIndex(t=>t(i));-1!==t?s[t].push(i):o.push(i)}return[...s,o]};

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

@@ -0,0 +1,32 @@
+'use strict';
+
+var js_utils_collection_partitionMulti = require('./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 = js_utils_collection_partitionMulti.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 = js_utils_collection_partitionMulti.partitionMulti(data, [isString, isNumber, isNull]);
+        expect(partitions).toEqual([
+            // strings
+            ['a', 'b'],
+            // numbers
+            [1],
+            // nulls
+            [],
+            // others
+            [false, true],
+        ]);
+    });
+});

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

@@ -0,0 +1 @@
+"use strict";var t=require("./partitionMulti.min.js");describe("partitionMulti",()=>{it("should partition with single predicate",()=>{const i=t.partitionMulti([0,1,2,3,4,5],[t=>t%2==0]);expect(i).toEqual([[0,2,4],[1,3,5]])}),it("should partition on multiple predicates",()=>{const i=t.partitionMulti(["a",1,"b",!1,!0],[t=>"string"==typeof t,t=>"number"==typeof t,t=>null===t]);expect(i).toEqual([["a","b"],[1],[],[!1,!0]])})});

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 @@
+'use strict';
+
+/** Generate a range of number starting at 0 and ending before the given number */
+const range = (end) => Array.from({ length: end }, (_, i) => i);
+
+exports.range = range;

package/js/utils/collection/range.min.js

@@ -0,0 +1 @@
+"use strict";exports.range=r=>Array.from({length:r},(r,e)=>e);

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

@@ -0,0 +1,12 @@
+'use strict';
+
+var js_utils_collection_range = require('./range.js');
+
+describe(js_utils_collection_range.range, () => {
+    it('should generate a number range', () => {
+        expect(js_utils_collection_range.range(-2)).toEqual([]);
+        expect(js_utils_collection_range.range(0)).toEqual([]);
+        expect(js_utils_collection_range.range(1)).toEqual([0]);
+        expect(js_utils_collection_range.range(5)).toEqual([0, 1, 2, 3, 4]);
+    });
+});

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

@@ -0,0 +1 @@
+"use strict";var e=require("./range.min.js");describe(e.range,()=>{it("should generate a number range",()=>{expect(e.range(-2)).toEqual([]),expect(e.range(0)).toEqual([]),expect(e.range(1)).toEqual([0]),expect(e.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,6 +1,5 @@
 'use strict';
 
-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');
@@ -8,9 +7,8 @@ var js_utils_className_getTypographyClassName = require('./className/getTypograp
 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('./collection/isEmpty.js');
+require('./string/kebabCase.js');
 require('../constants/index.js');
 require('../constants/keycodes.js');
 
@@ -65,7 +63,7 @@ function onButtonPressed(handler) {
  * @param  handleSwipe Callback function.
  * @return Function to remove listeners.
  */
-function detectSwipe(touchSurface, handleSwipe = noop) {
+function detectSwipe(touchSurface, handleSwipe) {
     let distX;
     let distY;
     let startX;
@@ -114,7 +112,7 @@ function detectSwipe(touchSurface, handleSwipe = noop) {
                 direction = distY < 0 ? 'up' : 'down';
             }
         }
-        handleSwipe(direction);
+        handleSwipe?.(direction);
         evt.preventDefault();
     };
     touchSurface.addEventListener('touchstart', onTouchStart, false);
@@ -138,8 +136,8 @@ function isPassiveEventAvailable() {
                 supportsPassiveOption = true;
             },
         });
-        window.addEventListener('testPassiveEventSupport', noop, opts);
-        window.removeEventListener('testPassiveEventSupport', noop, opts);
+        window.addEventListener('testPassiveEventSupport', () => { }, opts);
+        window.removeEventListener('testPassiveEventSupport', () => { }, opts);
     }
     catch (e) {
         // ignored

package/js/utils/index.min.js

@@ -1 +1 @@
-"use strict";var e=require("lodash/noop"),t=require("./className/handleBasicClasses.min.js"),s=require("./className/getBasicClass.min.js"),r=require("./className/getRootClassName.min.js"),a=require("./className/getTypographyClassName.min.js"),n=require("./className/fontColorClass.min.js"),o=require("./className/resolveColorWithVariants.min.js");require("classnames"),require("lodash/isBoolean"),require("lodash/isEmpty"),require("lodash/kebabCase"),require("../constants/index.min.js"),require("../constants/keycodes.min.js"),exports.handleBasicClasses=t.handleBasicClasses,exports.getBasicClass=s.getBasicClass,exports.getRootClassName=r.getRootClassName,exports.getTypographyClassName=a.getTypographyClassName,exports.fontColorClass=n.fontColorClass,exports.resolveColorWithVariants=o.resolveColorWithVariants,exports.detectHorizontalSwipe=function(t,s){let r,a,n,o,i;const c=e=>{const[t]=Array.from(e.changedTouches);r=t.pageX,a=t.pageY,o=(new Date).getTime(),i=!1},u=e=>{if(i)return;if(n=(new Date).getTime()-o,n>300)return;const[t]=Array.from(e.changedTouches),c=t.pageX-r,u=t.pageY-a;if(!(Math.abs(c)>=150&&Math.abs(u)<=150))return;s(c<0?"left":"right"),i=!0},l=!!function(){let t=!1;try{const s=Object.defineProperty({},"passive",{get(){t=!0}});window.addEventListener("testPassiveEventSupport",e,s),window.removeEventListener("testPassiveEventSupport",e,s)}catch(e){}return t}()&&{passive:!0};return t.addEventListener("touchstart",c,l),t.addEventListener("touchmove",u,l),()=>{t.removeEventListener("touchstart",c,l),t.removeEventListener("touchmove",u,l)}},exports.detectSwipe=function(t,s=e){let r,a,n,o,i,c,u;const l=e=>{const[t]=Array.from(e.changedTouches);i="none",n=t.pageX,o=t.pageY,u=(new Date).getTime(),e.preventDefault()},p=e=>{e.preventDefault()},h=e=>{const[t]=Array.from(e.changedTouches);r=t.pageX-n,a=t.pageY-o,c=(new Date).getTime()-u,c<=300&&(Math.abs(r)>=150&&Math.abs(a)<=100?i=r<0?"left":"right":Math.abs(a)>=150&&Math.abs(r)<=100&&(i=a<0?"up":"down")),s(i),e.preventDefault()};return t.addEventListener("touchstart",l,!1),t.addEventListener("touchmove",p,!1),t.addEventListener("touchend",h,!1),()=>{t.removeEventListener("touchstart",l,!1),t.removeEventListener("touchmove",p,!1),t.removeEventListener("touchend",h,!1)}},exports.onButtonPressed=function(e){return t=>{"Enter"!==t.key&&" "!==t.key||e(t)}},exports.onEnterPressed=function(e){return t=>{"Enter"===t.key&&e(t)}},exports.onEscapePressed=function(e){return t=>{"Escape"===t.key&&e(t)}};
+"use strict";var e=require("./className/handleBasicClasses.min.js"),t=require("./className/getBasicClass.min.js"),s=require("./className/getRootClassName.min.js"),r=require("./className/getTypographyClassName.min.js"),a=require("./className/fontColorClass.min.js"),n=require("./className/resolveColorWithVariants.min.js");require("classnames"),require("./collection/isEmpty.min.js"),require("./string/kebabCase.min.js"),require("../constants/index.min.js"),require("../constants/keycodes.min.js"),exports.handleBasicClasses=e.handleBasicClasses,exports.getBasicClass=t.getBasicClass,exports.getRootClassName=s.getRootClassName,exports.getTypographyClassName=r.getTypographyClassName,exports.fontColorClass=a.fontColorClass,exports.resolveColorWithVariants=n.resolveColorWithVariants,exports.detectHorizontalSwipe=function(e,t){let s,r,a,n,o;const i=e=>{const[t]=Array.from(e.changedTouches);s=t.pageX,r=t.pageY,n=(new Date).getTime(),o=!1},c=e=>{if(o)return;if(a=(new Date).getTime()-n,a>300)return;const[i]=Array.from(e.changedTouches),c=i.pageX-s,u=i.pageY-r;if(!(Math.abs(c)>=150&&Math.abs(u)<=150))return;t(c<0?"left":"right"),o=!0},u=!!function(){let e=!1;try{const t=Object.defineProperty({},"passive",{get(){e=!0}});window.addEventListener("testPassiveEventSupport",()=>{},t),window.removeEventListener("testPassiveEventSupport",()=>{},t)}catch(e){}return e}()&&{passive:!0};return e.addEventListener("touchstart",i,u),e.addEventListener("touchmove",c,u),()=>{e.removeEventListener("touchstart",i,u),e.removeEventListener("touchmove",c,u)}},exports.detectSwipe=function(e,t){let s,r,a,n,o,i,c;const u=e=>{const[t]=Array.from(e.changedTouches);o="none",a=t.pageX,n=t.pageY,c=(new Date).getTime(),e.preventDefault()},l=e=>{e.preventDefault()},m=e=>{const[u]=Array.from(e.changedTouches);s=u.pageX-a,r=u.pageY-n,i=(new Date).getTime()-c,i<=300&&(Math.abs(s)>=150&&Math.abs(r)<=100?o=s<0?"left":"right":Math.abs(r)>=150&&Math.abs(s)<=100&&(o=r<0?"up":"down")),t?.(o),e.preventDefault()};return e.addEventListener("touchstart",u,!1),e.addEventListener("touchmove",l,!1),e.addEventListener("touchend",m,!1),()=>{e.removeEventListener("touchstart",u,!1),e.removeEventListener("touchmove",l,!1),e.removeEventListener("touchend",m,!1)}},exports.onButtonPressed=function(e){return t=>{"Enter"!==t.key&&" "!==t.key||e(t)}},exports.onEnterPressed=function(e){return t=>{"Enter"===t.key&&e(t)}},exports.onEscapePressed=function(e){return t=>{"Escape"===t.key&&e(t)}};

package/js/utils/index.ts

@@ -1,7 +1,5 @@
 import type { KeyboardEvent as ReactKeyboardEvent } from 'react';
 
-import noop from 'lodash/noop';
-
 export * from './className';
 
 type KeyboardEventHandler<E extends KeyboardEvent | ReactKeyboardEvent> = (event: E) => void;
@@ -68,7 +66,7 @@ declare type SwipeDirection = 'none' | 'up' | 'down' | 'left' | 'right';
  * @param  handleSwipe Callback function.
  * @return Function to remove listeners.
  */
-export function detectSwipe(touchSurface: Element, handleSwipe: (direction: SwipeDirection) => void = noop) {
+export function detectSwipe(touchSurface: Element, handleSwipe?: (direction: SwipeDirection) => void) {
     let distX: number;
     let distY: number;
     let startX: number;
@@ -119,7 +117,7 @@ export function detectSwipe(touchSurface: Element, handleSwipe: (direction: Swip
                 direction = distY < 0 ? 'up' : 'down';
             }
         }
-        handleSwipe(direction);
+        handleSwipe?.(direction);
         evt.preventDefault();
     };
 
@@ -146,8 +144,8 @@ function isPassiveEventAvailable() {
                 supportsPassiveOption = true;
             },
         });
-        window.addEventListener('testPassiveEventSupport', noop, opts);
-        window.removeEventListener('testPassiveEventSupport', noop, opts);
+        window.addEventListener('testPassiveEventSupport', () => {}, opts);
+        window.removeEventListener('testPassiveEventSupport', () => {}, opts);
     } catch (e) {
         // ignored
     }

package/js/utils/string/kebabCase.js

@@ -0,0 +1,30 @@
+'use strict';
+
+/**
+ * Converts a string to kebab-case.
+ *
+ * @param str The string to convert
+ * @returns The kebab-cased string
+ *
+ * @example
+ * kebabCase('fooBar') // 'foo-bar'
+ * kebabCase('FooBar') // 'foo-bar'
+ * kebabCase('foo_bar') // 'foo-bar'
+ * kebabCase('foo bar') // 'foo-bar'
+ * kebabCase('FOO_BAR') // 'foo-bar'
+ */
+function kebabCase(str) {
+    return (str
+        // Insert a hyphen before any uppercase letter that follows a lowercase letter or number
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        // Insert a hyphen before any uppercase letter that is followed by a lowercase letter and preceded by an uppercase letter
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+        // Replace spaces and underscores with hyphens
+        .replace(/[\s_]+/g, '-')
+        // Convert to lowercase
+        .toLowerCase()
+        // Remove leading/trailing hyphens
+        .replace(/^-+|-+$/g, ''));
+}
+
+exports.kebabCase = kebabCase;

package/js/utils/string/kebabCase.min.js

@@ -0,0 +1 @@
+"use strict";exports.kebabCase=function(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/([A-Z])([A-Z][a-z])/g,"$1-$2").replace(/[\s_]+/g,"-").toLowerCase().replace(/^-+|-+$/g,"")};

package/js/utils/string/kebabCase.test.js

@@ -0,0 +1,43 @@
+'use strict';
+
+var js_utils_string_kebabCase = require('./kebabCase.js');
+
+describe(js_utils_string_kebabCase.kebabCase, () => {
+    it('should convert camelCase to kebab-case', () => {
+        expect(js_utils_string_kebabCase.kebabCase('fooBar')).toBe('foo-bar');
+        expect(js_utils_string_kebabCase.kebabCase('fooBarBaz')).toBe('foo-bar-baz');
+    });
+    it('should convert PascalCase to kebab-case', () => {
+        expect(js_utils_string_kebabCase.kebabCase('FooBar')).toBe('foo-bar');
+        expect(js_utils_string_kebabCase.kebabCase('FooBarBaz')).toBe('foo-bar-baz');
+    });
+    it('should convert snake_case to kebab-case', () => {
+        expect(js_utils_string_kebabCase.kebabCase('foo_bar')).toBe('foo-bar');
+        expect(js_utils_string_kebabCase.kebabCase('foo_bar_baz')).toBe('foo-bar-baz');
+    });
+    it('should convert spaces to hyphens', () => {
+        expect(js_utils_string_kebabCase.kebabCase('foo bar')).toBe('foo-bar');
+        expect(js_utils_string_kebabCase.kebabCase('foo bar baz')).toBe('foo-bar-baz');
+    });
+    it('should handle UPPERCASE strings', () => {
+        expect(js_utils_string_kebabCase.kebabCase('FOO_BAR')).toBe('foo-bar');
+        expect(js_utils_string_kebabCase.kebabCase('FOOBAR')).toBe('foobar');
+    });
+    it('should handle mixed formats', () => {
+        expect(js_utils_string_kebabCase.kebabCase('fooBar_baz qux')).toBe('foo-bar-baz-qux');
+    });
+    it('should handle strings that are already kebab-case', () => {
+        expect(js_utils_string_kebabCase.kebabCase('foo-bar')).toBe('foo-bar');
+    });
+    it('should handle empty strings', () => {
+        expect(js_utils_string_kebabCase.kebabCase('')).toBe('');
+    });
+    it('should handle single words', () => {
+        expect(js_utils_string_kebabCase.kebabCase('foo')).toBe('foo');
+        expect(js_utils_string_kebabCase.kebabCase('Foo')).toBe('foo');
+    });
+    it('should remove leading and trailing hyphens', () => {
+        expect(js_utils_string_kebabCase.kebabCase('_foo_bar_')).toBe('foo-bar');
+        expect(js_utils_string_kebabCase.kebabCase(' foo bar ')).toBe('foo-bar');
+    });
+});

package/js/utils/string/kebabCase.test.min.js

@@ -0,0 +1 @@
+"use strict";var e=require("./kebabCase.min.js");describe(e.kebabCase,()=>{it("should convert camelCase to kebab-case",()=>{expect(e.kebabCase("fooBar")).toBe("foo-bar"),expect(e.kebabCase("fooBarBaz")).toBe("foo-bar-baz")}),it("should convert PascalCase to kebab-case",()=>{expect(e.kebabCase("FooBar")).toBe("foo-bar"),expect(e.kebabCase("FooBarBaz")).toBe("foo-bar-baz")}),it("should convert snake_case to kebab-case",()=>{expect(e.kebabCase("foo_bar")).toBe("foo-bar"),expect(e.kebabCase("foo_bar_baz")).toBe("foo-bar-baz")}),it("should convert spaces to hyphens",()=>{expect(e.kebabCase("foo bar")).toBe("foo-bar"),expect(e.kebabCase("foo bar baz")).toBe("foo-bar-baz")}),it("should handle UPPERCASE strings",()=>{expect(e.kebabCase("FOO_BAR")).toBe("foo-bar"),expect(e.kebabCase("FOOBAR")).toBe("foobar")}),it("should handle mixed formats",()=>{expect(e.kebabCase("fooBar_baz qux")).toBe("foo-bar-baz-qux")}),it("should handle strings that are already kebab-case",()=>{expect(e.kebabCase("foo-bar")).toBe("foo-bar")}),it("should handle empty strings",()=>{expect(e.kebabCase("")).toBe("")}),it("should handle single words",()=>{expect(e.kebabCase("foo")).toBe("foo"),expect(e.kebabCase("Foo")).toBe("foo")}),it("should remove leading and trailing hyphens",()=>{expect(e.kebabCase("_foo_bar_")).toBe("foo-bar"),expect(e.kebabCase(" foo bar ")).toBe("foo-bar")})});

package/js/utils/string/kebabCase.test.ts

@@ -0,0 +1,50 @@
+import { kebabCase } from '@lumx/core/js/utils/string/kebabCase';
+
+describe(kebabCase, () => {
+    it('should convert camelCase to kebab-case', () => {
+        expect(kebabCase('fooBar')).toBe('foo-bar');
+        expect(kebabCase('fooBarBaz')).toBe('foo-bar-baz');
+    });
+
+    it('should convert PascalCase to kebab-case', () => {
+        expect(kebabCase('FooBar')).toBe('foo-bar');
+        expect(kebabCase('FooBarBaz')).toBe('foo-bar-baz');
+    });
+
+    it('should convert snake_case to kebab-case', () => {
+        expect(kebabCase('foo_bar')).toBe('foo-bar');
+        expect(kebabCase('foo_bar_baz')).toBe('foo-bar-baz');
+    });
+
+    it('should convert spaces to hyphens', () => {
+        expect(kebabCase('foo bar')).toBe('foo-bar');
+        expect(kebabCase('foo bar baz')).toBe('foo-bar-baz');
+    });
+
+    it('should handle UPPERCASE strings', () => {
+        expect(kebabCase('FOO_BAR')).toBe('foo-bar');
+        expect(kebabCase('FOOBAR')).toBe('foobar');
+    });
+
+    it('should handle mixed formats', () => {
+        expect(kebabCase('fooBar_baz qux')).toBe('foo-bar-baz-qux');
+    });
+
+    it('should handle strings that are already kebab-case', () => {
+        expect(kebabCase('foo-bar')).toBe('foo-bar');
+    });
+
+    it('should handle empty strings', () => {
+        expect(kebabCase('')).toBe('');
+    });
+
+    it('should handle single words', () => {
+        expect(kebabCase('foo')).toBe('foo');
+        expect(kebabCase('Foo')).toBe('foo');
+    });
+
+    it('should remove leading and trailing hyphens', () => {
+        expect(kebabCase('_foo_bar_')).toBe('foo-bar');
+        expect(kebabCase(' foo bar ')).toBe('foo-bar');
+    });
+});

package/js/utils/string/kebabCase.ts

@@ -0,0 +1,28 @@
+/**
+ * Converts a string to kebab-case.
+ *
+ * @param str The string to convert
+ * @returns The kebab-cased string
+ *
+ * @example
+ * kebabCase('fooBar') // 'foo-bar'
+ * kebabCase('FooBar') // 'foo-bar'
+ * kebabCase('foo_bar') // 'foo-bar'
+ * kebabCase('foo bar') // 'foo-bar'
+ * kebabCase('FOO_BAR') // 'foo-bar'
+ */
+export function kebabCase(str: string): string {
+    return (
+        str
+            // Insert a hyphen before any uppercase letter that follows a lowercase letter or number
+            .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+            // Insert a hyphen before any uppercase letter that is followed by a lowercase letter and preceded by an uppercase letter
+            .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+            // Replace spaces and underscores with hyphens
+            .replace(/[\s_]+/g, '-')
+            // Convert to lowercase
+            .toLowerCase()
+            // Remove leading/trailing hyphens
+            .replace(/^-+|-+$/g, '')
+    );
+}

package/package.json

@@ -34,7 +34,7 @@
         "update-version-changelog": "yarn version-changelog ../../CHANGELOG.md"
     },
     "sideEffects": false,
-    "version": "3.20.1-alpha.36",
+    "version": "3.20.1-alpha.38",
     "devDependencies": {
         "@rollup/plugin-commonjs": "^29.0.0",
         "@rollup/plugin-terser": "^0.4.4",