Function t

packages/gitbook/src/intl/translate.tsx:8–46

(
    language: TranslationLanguage,
    id: TranslationKey,
    ...args: React.ReactNode[]
)

 * Translate a string.
 */
export function t(
    language: TranslationLanguage,
    id: TranslationKey,
    ...args: React.ReactNode[]
): React.ReactNode {
    const string = language[id];
    if (!string) {
        throw new Error(`Translation not found for "${id}"`);
    }

    // Now we are going to replace the arguments
    // but we want to return a string as long as it's possible
    // (eg. if there isn't any argument that is a ReactNode)
    const parts: React.ReactNode[] = [];
    let currentStringToReplace: string = string;

    args.forEach((arg, i) => {
        if (typeof arg === 'string') {
            currentStringToReplace = currentStringToReplace.replace(`\${${i + 1}}`, arg);
        } else {
            const [partToPush, partToReplace] = currentStringToReplace.split(`\${${i + 1}}`);
            parts.push(<React.Fragment key={`string-${i}`}>{partToPush}</React.Fragment>);
            parts.push(<React.Fragment key={`arg-${i}`}>{arg}</React.Fragment>);
            // @ts-expect-error
            currentStringToReplace = partToReplace;
        }
    });

    if (!parts.length) {
        return currentStringToReplace;
    }

    return (
        <>
            {parts}
            {currentStringToReplace}
        </>
    );
}

/**
 * Version of `t` that returns a string.