@shopify/cli-kit/dist/public/common/array.js

A set of utilities, interfaces, and models that are common across all the platform features

import lodashUniqBy from 'lodash/uniqBy.js';
import lodashDifference from 'lodash/difference.js';
/**
 * Takes a random value from an array.
 *
 * @param array - Array from which we'll select a random item.
 * @returns A random element from the array.
 */
export function takeRandomFromArray(array) {
    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
    return array[Math.floor(Math.random() * array.length)];
}
/**
 * Returns a copy of the array deleting the elemements that are undefined.
 *
 * @param array - The array whose undefined will be deleted.
 * @returns A copy of the array with the undefined elements deleted.
 */
export function getArrayRejectingUndefined(array) {
    return array.filter((item) => item !== undefined);
}
/**
 * Returns true if an array contains duplicates.
 *
 * @param array - The array to check against.
 * @returns True if the array contains duplicates.
 */
export function getArrayContainsDuplicates(array) {
    return array.length !== new Set(array).size;
}
/**
 * Removes duplicated items from an array.
 *
 * @param array - The array to inspect.
 * @returns Returns the new duplicate free array.
 */
export function uniq(array) {
    return Array.from(new Set(array));
}
/**
 * This method is like `_.uniq` except that it accepts `iteratee` which is
 * invoked for each element in `array` to generate the criterion by which
 * uniqueness is computed. The iteratee is invoked with one argument: (value).
 *
 * @param array - The array to inspect.
 * @param iteratee - The iteratee invoked per element.
 * @returns Returns the new duplicate free array.
 */
export function uniqBy(array, iteratee) {
    return lodashUniqBy(array, iteratee);
}
/**
 * Creates an array of `array` values not included in the other provided arrays using SameValueZero for
 * equality comparisons. The order and references of result values are determined by the first array.
 *
 * @param array - The array to inspect.
 * @param values - The arrays of values to exclude.
 * @returns Returns the new array of filtered values.
 */
export function difference(array, ...values) {
    return lodashDifference(array, ...values);
}
/**
 * Converts an array of anything into a human friendly list.
 *
 * Returns a new array that contains the items separated by commas,
 * except for the last item, which is separated by "and".
 * This is useful for creating human-friendly sentences.
 *
 * @param items - Token[].
 * @returns Token[].
 * @example
 * ```ts
 *   const items = ['apple', 'banana', {command: "--flag"}];
 *   const result = asHumanFriendlyList(items)
 *
 *   // ['apple', ',', 'banana', ',', 'and', {command: "--flag"}]
 *   console.log(result);
 * ```
 */
export function asHumanFriendlyArray(items) {
    if (items.length < 2) {
        return items;
    }
    return items.reduce((acc, item, index) => {
        if (index === items.length - 1) {
            acc.push('and');
        }
        else if (index !== 0) {
            acc.push(', ');
        }
        acc.push(item);
        return acc;
    }, []);
}
//# sourceMappingURL=array.js.map