@mll-lab/js-utils 2.7.0 → 2.10.0

package/dist/array.d.ts

@@ -23,3 +23,9 @@ export declare const EMPTY_ARRAY: never[];
  */
 export declare function insertIf<T>(condition: boolean, ...elements: Array<T>): Array<T>;
 export declare function last<T, A extends Array<T>>(array: A): A extends NonEmptyArray<T> ? T : T | undefined;
+/**
+ * Appends element to array if not included or removes it.
+ *
+ * Never mutates the given array, always returns a new array.
+ */
+export declare function toggleElement<T>(array: Array<T>, element: T): Array<T>;

package/dist/index.common.js

@@ -9466,6 +9466,16 @@ function last(array) {
     // @ts-expect-error too magical
     return array[array.length - 1];
 }
+/**
+ * Appends element to array if not included or removes it.
+ *
+ * Never mutates the given array, always returns a new array.
+ */
+function toggleElement(array, element) {
+    return array.includes(element)
+        ? array.filter((e) => e !== element)
+        : array.concat(element);
+}
 
 function toInteger(dirtyNumber) {
   if (dirtyNumber === null || dirtyNumber === true || dirtyNumber === false) {
@@ -15201,6 +15211,26 @@ function includesIgnoreCase(needle, haystack) {
 function firstLine(multilineText) {
     return multilineText.split('\n', 1)[0];
 }
+function joinNonEmpty(maybeStrings, separator) {
+    return maybeStrings.filter(Boolean).join(separator);
+}
+
+/**
+ * Converts pixel value to number.
+ *
+ * @example "4px" to 4
+ */
+function pxToNumber(pixels) {
+    const count = (pixels.match(/px/g) || []).length;
+    if (count > 1 || !pixels.endsWith('px')) {
+        throw new Error(`'${pixels}' does not contain a single 'px'`);
+    }
+    const parsedValue = parseFloat(pixels);
+    if (Number.isNaN(parsedValue)) {
+        throw new Error(`'${pixels}' is not a valid single pixel-value`);
+    }
+    return parsedValue;
+}
 
 exports.DOTLESS_DATE_FORMAT = DOTLESS_DATE_FORMAT;
 exports.EMAIL_REGEX = EMAIL_REGEX;
@@ -15237,6 +15267,7 @@ exports.isString = isString;
 exports.isToday = isToday;
 exports.isURL = isURL;
 exports.isWord = isWord;
+exports.joinNonEmpty = joinNonEmpty;
 exports.last = last;
 exports.parseDate = parseDate;
 exports.parseDotlessDate = parseDotlessDate;
@@ -15248,6 +15279,8 @@ exports.parseIsoDate = parseIsoDate;
 exports.parseIsoDateTime = parseIsoDateTime;
 exports.parseSecondlessDateTime = parseSecondlessDateTime;
 exports.pluralize = pluralize;
+exports.pxToNumber = pxToNumber;
 exports.round = round;
+exports.toggleElement = toggleElement;
 exports.withoutIndex = withoutIndex;
 //# sourceMappingURL=index.common.js.map