Language.ts

import {
	getLanguage as getConfiguredLanguage,
	getFetchDefaultLanguage as getConfiguredFetchDefaultLanguage,
} from "../InitialConfiguration.js";
import { fireLanguageChange } from "../locale/languageChange.js";
import { reRenderAllUI5Elements } from "../Render.js";
import { DEFAULT_LANGUAGE } from "../generated/AssetParameters.js";
import { isBooted } from "../Boot.js";
import { attachConfigurationReset } from "./ConfigurationReset.js";
import { fireConfigChange, attachConfigChange, getSharedValue } from "./ConfigurationSync.js";

let curLanguage: string | undefined;
let fetchDefaultLanguage: boolean | undefined;

attachConfigurationReset(() => {
	curLanguage = undefined;
	fetchDefaultLanguage = undefined;
});

// Flag indicating that a language change is in progress and not yet complete.
// While this flag is true, language-aware components will not re-render.
// These components may rely on language-specific data (e.g., CLDR, language bundles),
// which might be unavailable during the loading phase.
// During this phase, all re-rendering is postponed.
// Once all necessary language data has been loaded, the language change
// will trigger a re-render of all language-aware components.
let languageChangePending = false;

attachConfigChange("language", (language: string) => {
	curLanguage = language;
	languageChangePending = true;
	fireLanguageChange(language).then(() => {
		languageChangePending = false;
		if (isBooted()) {
			reRenderAllUI5Elements({ languageAware: true });
		}
	});
});

const getLanguageChangePending = () => languageChangePending;

/**
 * Returns the currently configured language, or the browser language as a fallback.
 * @public
 * @returns {string}
 */
const getLanguage = (): string | undefined => {
	if (curLanguage === undefined) {
		curLanguage = getSharedValue<string>("language") ?? getConfiguredLanguage();
	}
	return curLanguage;
};

/**
 * Changes the current language, re-fetches all message bundles, updates all language-aware components
 * and returns a promise that resolves when all rendering is done.
 *
 * @param {string} language
 * @public
 * @returns {Promise<void>}
 */
const setLanguage = async (language: string): Promise<void> => {
	if (curLanguage === language) {
		return;
	}

	languageChangePending = true;
	curLanguage = language;

	fireConfigChange("language", language);

	await fireLanguageChange(language);

	languageChangePending = false;

	if (isBooted()) {
		await reRenderAllUI5Elements({ languageAware: true });
	}
};

/**
 * Returns the default languague.
 *
 * Note: Default language might be different than the configurated one.
 *
 * @public
 * @returns {string}
 */
const getDefaultLanguage = (): string => {
	return DEFAULT_LANGUAGE;
};

/**
 * Defines if the default language, that is inlined, should be
 * fetched over the network instead of using the inlined one.
 * **Note:** By default the language will not be fetched.
 *
 * @public
 * @param {boolean} fetchDefaultLang
 */
const setFetchDefaultLanguage = (fetchDefaultLang: boolean) => {
	fetchDefaultLanguage = fetchDefaultLang;
};

/**
 * Returns if the default language, that is inlined, should be fetched over the network.
 * @public
 * @returns {boolean}
 */
const getFetchDefaultLanguage = (): boolean => {
	if (fetchDefaultLanguage === undefined) {
		fetchDefaultLanguage = getConfiguredFetchDefaultLanguage();
	}

	return fetchDefaultLanguage;
};

export {
	getLanguage,
	setLanguage,
	getDefaultLanguage,
	setFetchDefaultLanguage,
	getFetchDefaultLanguage,
	getLanguageChangePending,
};