anki/ts/editor-toolbar/identifiable.ts

// Copyright: Ankitects Pty Ltd and contributors
// License: GNU AGPL, version 3 or later; http://www.gnu.org/licenses/agpl.html
export interface Identifiable {
    id?: string;
}

function normalize<T extends Identifiable>(
    values: T[],
    idOrIndex: string | number
): number {
    let normalizedIndex: number;

    if (typeof idOrIndex === "string") {
        normalizedIndex = values.findIndex((value) => value.id === idOrIndex);
    } else if (idOrIndex < 0) {
        normalizedIndex = values.length + idOrIndex;
    } else {
        normalizedIndex = idOrIndex;
    }

    return normalizedIndex >= values.length ? -1 : normalizedIndex;
}

export function search<T extends Identifiable>(
    values: T[],
    idOrIndex: string | number
): T | null {
    const index = normalize(values, idOrIndex);
    return index >= 0 ? values[index] : null;
}

export function insert<T extends Identifiable>(
    values: T[],
    value: T,
    idOrIndex: string | number
): T[] {
    const index = normalize(values, idOrIndex);
    return index >= 0
        ? [...values.slice(0, index), value, ...values.slice(index)]
        : values;
}

export function add<T extends Identifiable>(
    values: T[],
    value: T,
    idOrIndex: string | number
): T[] {
    const index = normalize(values, idOrIndex);
    return index >= 0
        ? [...values.slice(0, index + 1), value, ...values.slice(index + 1)]
        : values;
}