/** * Copyright (c) OpenLens Authors. All rights reserved. * Licensed under MIT License. See LICENSE in root directory for more information. */ import * as array from "../utils/array"; /** * A strict N-tuple of type T */ export type Tuple = N extends N ? number extends N ? T[] : _TupleOf : never; type _TupleOf = R["length"] extends N ? R : _TupleOf; /** * Iterates over `sources` yielding full tuples until one of the tuple arrays * is empty. Then it returns a tuple with the rest of each of tuples * @param sources The source arrays * @yields A tuple of the next element from each of the sources * @returns The tuple of all the sources as soon as at least one of the sources is exausted */ export function* zip(...sources: Tuple): Iterator, Tuple> { const maxSafeLength = Math.min(...sources.map(source => source.length)); for (let i = 0; i < maxSafeLength; i += 1) { yield sources.map(source => source[i]) as Tuple; } return sources.map(source => source.slice(maxSafeLength)) as Tuple; } /** * Returns a `length` tuple filled with copies of `value` * @param length The size of the tuple * @param value The value for each of the tuple entries */ export function filled(length: L, value: T): Tuple { return array.filled(length, value) as Tuple; }