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 {
    if (typeof idOrIndex === "string") {
        return values.findIndex((value) => value.id === idOrIndex);
    } else {
        return idOrIndex >= values.length ? -1 : idOrIndex;
    }
}

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;
}