Function translate

src/engine/i18n.ts:82–114

(engine: VisualNovelEngine, statement: string)

 * @returns The translated string
 */
export function translate (engine: VisualNovelEngine, statement: string): string {
  // Find all elements in the string that match the "_(key)" format
  const matches = statement.match (/_\(\S+\)/g);
  const language = engine.preference ('Language') as string;

  // Check if any matches were found, if not then no translation is needed
  if (matches === null) {
    return statement;
  }

  // Go through all the found matches so we can get the string it maps to
  for (const match of matches) {
    // Remove the _() from the key
    const path = match.replace ('_(', '').replace (')', '').split ('.');

    // Retrieve the string from the translations using the given key
    const translationsForLang = translations (engine, language) as Record<string, unknown> | undefined;
    if (!translationsForLang) continue;

    let data: unknown = translationsForLang[path[0]];

    for (let j = 1; j < path.length; j++) {
      if (typeof data === 'object' && data !== null) {
        data = (data as Record<string, unknown>)[path[j]];
      }
    }
    if (typeof data === 'string') {
      statement = statement.replace (match, data);
    }
  }

  return statement;
}

/**
 * Recursively replace all occurrences of