@ui5/webcomponents-base 0.0.0-cf50976ce → 0.0.0-d4d43327a

package/src/asset-registries/Icons.ts

@@ -0,0 +1,161 @@
+import getSharedResource from "../getSharedResource.js";
+import { getIconCollectionByAlias } from "../assets-meta/IconCollectionsAlias.js";
+import { getEffectiveIconCollection } from "../config/Icons.js";
+import { I18nText } from "../i18nBundle.js";
+import { TemplateFunction } from "../renderer/executeTemplate.js";
+
+type IconLoader = (collectionName: string) => Promise<CollectionData>;
+
+type CollectionData = {
+	collection: string,
+	packageName: string,
+	version?: string,
+	data: Record<string, {
+		path: string,
+		paths: Array<string>,
+		ltr: boolean,
+		acc: I18nText,
+	}>,
+};
+
+type IconData = {
+	collection: string,
+	packageName: string,
+	pathData: string | Array<string>,
+	ltr: boolean,
+	accData: I18nText,
+	customTemplate?: TemplateFunction,
+	viewBox?: string,
+};
+
+const loaders = new Map<string, IconLoader>();
+const registry = getSharedResource<Map<string, IconData>>("SVGIcons.registry", new Map());
+const iconCollectionPromises = getSharedResource<Map<string, Promise<CollectionData>>>("SVGIcons.promises", new Map());
+
+const ICON_NOT_FOUND = "ICON_NOT_FOUND";
+
+const registerIconLoader = (collectionName: string, loader: IconLoader) => {
+	loaders.set(collectionName, loader);
+};
+
+const _loadIconCollectionOnce = async (collectionName: string) => {
+	if (!iconCollectionPromises.has(collectionName)) {
+		if (!loaders.has(collectionName)) {
+			throw new Error(`No loader registered for the ${collectionName} icons collection. Probably you forgot to import the "AllIcons.js" module for the respective package.`);
+		}
+
+		const loadIcons = loaders.get(collectionName)!;
+		iconCollectionPromises.set(collectionName, loadIcons(collectionName));
+	}
+
+	return iconCollectionPromises.get(collectionName);
+};
+
+const _fillRegistry = (bundleData: CollectionData) => {
+	Object.keys(bundleData.data).forEach(iconName => {
+		const iconData = bundleData.data[iconName];
+
+		registerIcon(iconName, {
+			pathData: iconData.path || iconData.paths,
+			ltr: iconData.ltr,
+			accData: iconData.acc,
+			collection: bundleData.collection,
+			packageName: bundleData.packageName,
+		});
+	});
+};
+
+// set
+const registerIcon = (name: string, iconData: IconData) => { // eslint-disable-line
+	const key = `${iconData.collection}/${name}`;
+
+	registry.set(key, {
+		pathData: iconData.pathData,
+		ltr: iconData.ltr,
+		accData: iconData.accData,
+		packageName: iconData.packageName,
+		customTemplate: iconData.customTemplate,
+		viewBox: iconData.viewBox,
+		collection: iconData.collection,
+	});
+};
+
+/**
+ * Processes the full icon name and splits it into - "name", "collection"
+ * to form the proper registry key ("collection/name") under which the icon is registered:
+ *
+ * - removes legacy protocol ("sap-icon://")
+ * - resolves aliases (f.e "SAP-icons-TNT/actor" => "tnt/actor")
+ * - determines theme dependant icon collection (f.e "home" => "SAP-icons-v4/home" in Quartz | "SAP-icons-v5/home" in Horizon)
+ *
+ * @param { string } name
+ * @return { object }
+ */
+const processName = (name: string) => {
+	// silently support ui5-compatible URIs
+	if (name.startsWith("sap-icon://")) {
+		name = name.replace("sap-icon://", "");
+	}
+
+	let collection: string;
+	[name, collection] = name.split("/").reverse();
+
+	name = name.replace("icon-", "");
+
+	if (collection) {
+		collection = getIconCollectionByAlias(collection);
+	}
+	collection = getEffectiveIconCollection(collection);
+
+	const registryKey = `${collection}/${name}`;
+	return { name, collection, registryKey };
+};
+
+const getIconDataSync = (name: string) => {
+	const { registryKey } = processName(name);
+	return registry.get(registryKey);
+};
+
+const getIconData = async (name: string) => {
+	const { collection, registryKey } = processName(name);
+
+	let iconData: string | CollectionData = ICON_NOT_FOUND;
+	try {
+		iconData = (await _loadIconCollectionOnce(collection))!;
+	} catch (error: unknown) {
+		const e = error as Error;
+		console.error(e.message); /* eslint-disable-line */
+	}
+
+	if (iconData === ICON_NOT_FOUND) {
+		return iconData;
+	}
+
+	if (!registry.has(registryKey)) {
+		// not filled by another await. many getters will await on the same loader, but fill only once
+		_fillRegistry(iconData as CollectionData);
+	}
+	return registry.get(registryKey);
+};
+
+// test page usage only
+const _getRegisteredNames = async () => {
+	// fetch one icon of each collection to trigger the bundle load
+	await getIconData("edit");
+	await getIconData("tnt/arrow");
+	await getIconData("business-suite/3d");
+	return Array.from(registry.keys());
+};
+
+export {
+	registerIconLoader,
+	getIconData,
+	getIconDataSync,
+	registerIcon,
+	_getRegisteredNames,
+};
+
+export type {
+	IconData,
+	CollectionData,
+};

package/src/asset-registries/Illustrations.ts

@@ -0,0 +1,75 @@
+import getSharedResource from "../getSharedResource.js";
+import type { I18nText } from "../i18nBundle.js";
+
+type IllustrationLoader = (illustrationName: string) => Promise<IllustrationData>;
+
+type IllustrationProperties = {
+	dialogSvg: string,
+	sceneSvg: string,
+	spotSvg: string,
+	title: I18nText,
+	subtitle: I18nText,
+};
+
+type IllustrationData = IllustrationProperties & {
+	set: string,
+};
+
+const loaders = new Map<string, IllustrationLoader>();
+const registry = getSharedResource<Map<string, IllustrationProperties>>("SVGIllustration.registry", new Map());
+const illustrationPromises = getSharedResource<Map<string, Promise<IllustrationData>>>("SVGIllustration.promises", new Map());
+
+const registerIllustration = (name: string, data: IllustrationData) => {
+	registry.set(`${data.set}/${name}`, {
+		dialogSvg: data.dialogSvg,
+		sceneSvg: data.sceneSvg,
+		spotSvg: data.spotSvg,
+		title: data.title,
+		subtitle: data.subtitle,
+	});
+};
+
+const registerIllustrationLoader = (illustrationName: string, loader: IllustrationLoader) => {
+	loaders.set(illustrationName, loader);
+};
+
+const _loadIllustrationOnce = async (illustrationName: string) => {
+	if (!illustrationPromises.has(illustrationName)) {
+		if (!loaders.has(illustrationName)) {
+			const illustrationPath = illustrationName.startsWith("Tnt") ? `tnt/${illustrationName.replace(/^Tnt/, "")}` : illustrationName;
+			throw new Error(`No loader registered for the ${illustrationName} illustration. Probably you forgot to import the "@ui5/webcomponents-fiori/dist/illustrations/${illustrationPath}.js" module. Or you can import the "@ui5/webcomponents-fiori/dist/illustrations/AllIllustrations.js" module that will make all illustrations available, but fetch only the ones used.`);
+		}
+
+		const loadIllustrations = loaders.get(illustrationName)!;
+		illustrationPromises.set(illustrationName, loadIllustrations(illustrationName));
+	}
+	return illustrationPromises.get(illustrationName);
+};
+
+const getIllustrationDataSync = (illustrationName: string) => {
+	let set = "fiori";
+
+	if (illustrationName.startsWith("Tnt")) {
+		set = "tnt";
+		illustrationName = illustrationName.replace(/^Tnt/, "");
+	}
+	return registry.get(`${set}/${illustrationName}`);
+};
+
+const getIllustrationData = async (illustrationName: string) => {
+	let set = "fiori";
+
+	await _loadIllustrationOnce(illustrationName);
+	if (illustrationName.startsWith("Tnt")) {
+		set = "tnt";
+		illustrationName = illustrationName.replace(/^Tnt/, "");
+	}
+	return registry.get(`${set}/${illustrationName}`);
+};
+
+export {
+	getIllustrationDataSync,
+	registerIllustration,
+	registerIllustrationLoader,
+	getIllustrationData,
+};

package/src/asset-registries/{LocaleData.js → LocaleData.ts}

@@ -2,11 +2,15 @@ import { attachLanguageChange } from "../locale/languageChange.js";
 import getLocale from "../locale/getLocale.js";
 import { DEFAULT_LOCALE, SUPPORTED_LOCALES } from "../generated/AssetParameters.js";
 import { getFeature } from "../FeaturesRegistry.js";
+import type OpenUI5Support from "../features/OpenUI5Support";
 
-const localeDataMap = new Map();
-const loaders = new Map();
-const cldrPromises = new Map();
-const reportedErrors = new Set();
+type LocaleDataLoader = (locale: string) => Promise<CLDRData>;
+type CLDRData = Record<string, object | boolean | string>;
+
+const localeDataMap = new Map<string, CLDRData>();
+const loaders = new Map<string, LocaleDataLoader>();
+const cldrPromises = new Map<string, Promise<CLDRData>>();
+const reportedErrors = new Set<string>();
 let warningShown = false;
 
 const M_ISO639_OLD_TO_NEW = {
@@ -15,25 +19,19 @@ const M_ISO639_OLD_TO_NEW = {
 	"in": "id",
 };
 
-const DEV_MODE = false;
-
-const _showAssetsWarningOnce = localeId => {
+const _showAssetsWarningOnce = (localeId: string) => {
 	if (warningShown) {
 		return;
 	}
 
-	if (!DEV_MODE) {
-		console.warn(`[LocaleData] Supported locale "${localeId}" not configured, import the "Assets.js" module from the webcomponents package you are using.`); /* eslint-disable-line */
-	} else {
-		console.warn(`[LocaleData] Note: in dev mode, CLDR assets might be disabled for performance reasons. Try running "ENABLE_CLDR=1 yarn start" to test CLDR assets.`); /* eslint-disable-line */
-	}
+	console.warn(`[LocaleData] Supported locale "${localeId}" not configured, import the "Assets.js" module from the webcomponents package you are using.`); /* eslint-disable-line */
 
 	warningShown = true;
 };
 
-const calcLocale = (language, region, script) => {
+const calcLocale = (language: string, region: string, script: string) => {
 	// normalize language and handle special cases
-	language = (language && M_ISO639_OLD_TO_NEW[language]) || language;
+	language = (language && M_ISO639_OLD_TO_NEW[language as keyof typeof M_ISO639_OLD_TO_NEW]) || language;
 	// Special case 1: in an SAP context, the inclusive language code "no" always means Norwegian Bokmal ("nb")
 	if (language === "no") {
 		language = "nb";
@@ -84,12 +82,12 @@ const calcLocale = (language, region, script) => {
 };
 
 // internal set data
-const setLocaleData = (localeId, content) => {
+const setLocaleData = (localeId: string, content: CLDRData) => {
 	localeDataMap.set(localeId, content);
 };
 
 // external getSync
-const getLocaleData = localeId => {
+const getLocaleData = (localeId: string) => {
 	// if there is no loader, the default fallback was fetched and a warning was given - use default locale instead
 	if (!loaders.has(localeId)) {
 		localeId = DEFAULT_LOCALE;
@@ -104,10 +102,14 @@ const getLocaleData = localeId => {
 };
 
 // load bundle over the network once
-const _loadCldrOnce = localeId => {
-	const loadCldr = loaders.get(localeId);
-
+const _loadCldrOnce = (localeId: string) => {
 	if (!cldrPromises.get(localeId)) {
+		const loadCldr = loaders.get(localeId);
+
+		if (!loadCldr) {
+			throw new Error(`CLDR data for locale ${localeId} is not loaded!`);
+		}
+
 		cldrPromises.set(localeId, loadCldr(localeId));
 	}
 
@@ -115,13 +117,13 @@ const _loadCldrOnce = localeId => {
 };
 
 // external getAsync
-const fetchCldr = async (language, region, script) => {
+const fetchCldr = async (language: string, region: string, script: string) => {
 	const localeId = calcLocale(language, region, script);
 
 	// reuse OpenUI5 CLDR if present
-	const OpenUI5Support = getFeature("OpenUI5Support");
-	if (OpenUI5Support) {
-		const cldrContent = OpenUI5Support.getLocaleDataObject();
+	const openUI5Support = getFeature<typeof OpenUI5Support>("OpenUI5Support");
+	if (openUI5Support) {
+		const cldrContent = openUI5Support.getLocaleDataObject();
 		if (cldrContent) {
 			// only if openui5 actually returned valid content
 			setLocaleData(localeId, cldrContent);
@@ -132,8 +134,9 @@ const fetchCldr = async (language, region, script) => {
 	// fetch it
 	try {
 		const cldrContent = await _loadCldrOnce(localeId);
-		setLocaleData(localeId, cldrContent);
-	} catch (e) {
+		setLocaleData(localeId, cldrContent as CLDRData);
+	} catch (error: unknown) {
+		const e = error as Error;
 		if (!reportedErrors.has(e.message)) {
 			reportedErrors.add(e.message);
 			console.error(e.message); /* eslint-disable-line */
@@ -141,13 +144,14 @@ const fetchCldr = async (language, region, script) => {
 	}
 };
 
-const registerLocaleDataLoader = (localeId, loader) => {
+const registerLocaleDataLoader = (localeId: string, loader: LocaleDataLoader) => {
 	loaders.set(localeId, loader);
 };
 
 // register default loader for "en" from ui5 CDN (dev workflow without assets)
-registerLocaleDataLoader("en", async runtimeLocaleId => {
-	return (await fetch(`https://sdk.openui5.org/1.103.0/resources/sap/ui/core/cldr/en.json`)).json();
+registerLocaleDataLoader("en", async () => {
+	const cldrContent = await fetch(`https://sdk.openui5.org/1.103.0/resources/sap/ui/core/cldr/en.json`);
+	return cldrContent.json() as Promise<CLDRData>;
 });
 
 // When the language changes dynamically (the user calls setLanguage),
@@ -162,3 +166,7 @@ export {
 	fetchCldr,
 	getLocaleData,
 };
+
+export type {
+	CLDRData,
+};

package/src/asset-registries/{Themes.js → Themes.ts}

@@ -1,36 +1,21 @@
 import { DEFAULT_THEME } from "../generated/AssetParameters.js";
+import { StyleData, StyleDataCSP } from "../types.js";
 
-const themeStyles = new Map();
-const loaders = new Map();
-const registeredPackages = new Set();
-const registeredThemes = new Set();
+type ThemeData = {_: StyleDataCSP } | StyleDataCSP | string;
+type ThemeLoader = (themeName: string) => Promise<ThemeData>;
 
-/**
- * Used to provide CSS Vars for a specific theme for a specific package.
- * The CSS Vars can be passed directly as a string (containing them), as an object with a "_" property(containing them in the "_" property), or as a URL.
- * This URL must point to a JSON file, containing a "_" property.
- *
- * Example usage:
- *  1) Pass the CSS Vars as a string directly.
- *  registerThemeProperties("my-package", "my_theme", ":root{--var1: red;}");
- *
- * @public
- * @param packageName - the NPM package for which CSS Vars are registered
- * @param themeName - the theme which the CSS Vars implement
- * @param style - the style content directly
- * @deprecated
- */
-const registerThemeProperties = (_packageName, _themeName, _style) => {
-	throw new Error("`registerThemeProperties` has been depracated. Use `registerThemePropertiesLoader` instead.");
-};
+const themeStyles = new Map<string, StyleData>();
+const loaders = new Map<string, ThemeLoader>();
+const registeredPackages = new Set<string>();
+const registeredThemes = new Set<string>();
 
-const registerThemePropertiesLoader = (packageName, themeName, loader) => {
+const registerThemePropertiesLoader = (packageName: string, themeName: string, loader: ThemeLoader) => {
 	loaders.set(`${packageName}/${themeName}`, loader);
 	registeredPackages.add(packageName);
 	registeredThemes.add(themeName);
 };
 
-const getThemeProperties = async (packageName, themeName) => {
+const getThemeProperties = async (packageName: string, themeName: string) => {
 	const style = themeStyles.get(`${packageName}_${themeName}`);
 	if (style !== undefined) { // it's valid for style to be an empty string
 		return style;
@@ -45,7 +30,7 @@ const getThemeProperties = async (packageName, themeName) => {
 	return _getThemeProperties(packageName, themeName);
 };
 
-const _getThemeProperties = async (packageName, themeName) => {
+const _getThemeProperties = async (packageName: string, themeName: string) => {
 	const loader = loaders.get(`${packageName}/${themeName}`);
 	if (!loader) {
 		// no themes for package
@@ -55,11 +40,12 @@ const _getThemeProperties = async (packageName, themeName) => {
 	let data;
 	try {
 		data = await loader(themeName);
-	} catch (e) {
+	} catch (error: unknown) {
+		const e = error as Error;
 		console.error(packageName, e.message); /* eslint-disable-line */
 		return;
 	}
-	const themeProps = data._ || data;
+	const themeProps = (data as {_: StyleDataCSP})._ || data; // Refactor: remove _ everywhere
 
 	themeStyles.set(`${packageName}_${themeName}`, themeProps);
 	return themeProps;
@@ -69,14 +55,18 @@ const getRegisteredPackages = () => {
 	return registeredPackages;
 };
 
-const isThemeRegistered = theme => {
+const isThemeRegistered = (theme: string) => {
 	return registeredThemes.has(theme);
 };
 
 export {
 	registerThemePropertiesLoader,
-	registerThemeProperties,
 	getThemeProperties,
 	getRegisteredPackages,
 	isThemeRegistered,
 };
+
+export type {
+	ThemeData,
+	ThemeLoader,
+};

package/src/asset-registries/{i18n.js → i18n.ts}

@@ -5,13 +5,16 @@ import nextFallbackLocale from "../locale/nextFallbackLocale.js";
 import { DEFAULT_LANGUAGE } from "../generated/AssetParameters.js";
 import { getFetchDefaultLanguage } from "../config/Language.js";
 
+type I18nLoader = (localeId: string) => Promise<I18nData>;
+type I18nData = Record<string, string>;
+
 // contains package names for which the warning has been shown
 const warningShown = new Set();
 const reportedErrors = new Set();
 
-const bundleData = new Map();
-const bundlePromises = new Map();
-const loaders = new Map();
+const bundleData = new Map<string, I18nData | null>();
+const bundlePromises = new Map<string, Promise<I18nData>>();
+const loaders = new Map<string, I18nLoader>();
 
 /**
  * Registers i18n loader function for given package and locale.
@@ -21,46 +24,38 @@ const loaders = new Map();
  * @param {string} localeId locale that this loader can handle
  * @param {function} loader async function that will be passed a localeId and should return a JSON object
  */
-const registerI18nLoader = (packageName, localeId, loader) => {
+const registerI18nLoader = (packageName: string, localeId: string, loader: I18nLoader) => {
 	// register loader by key
 	const bundleKey = `${packageName}/${localeId}`;
 	loaders.set(bundleKey, loader);
 };
 
-const _setI18nBundleData = (packageName, data) => {
+const _setI18nBundleData = (packageName: string, data: I18nData | null) => {
 	bundleData.set(packageName, data);
 };
 
-const getI18nBundleData = packageName => {
+const getI18nBundleData = (packageName: string) => {
 	return bundleData.get(packageName);
 };
 
-/**
- * @public
- * @deprecated
- */
-const registerI18nBundle = (_packageName, _bundle) => {
-	throw new Error("This method has been removed. Use `registerI18nLoader` instead.");
-};
-
-const _hasLoader = (packageName, localeId) => {
+const _hasLoader = (packageName: string, localeId: string) => {
 	const bundleKey = `${packageName}/${localeId}`;
 	return loaders.has(bundleKey);
 };
 
 // load bundle over the network once
-const _loadMessageBundleOnce = (packageName, localeId) => {
+const _loadMessageBundleOnce = (packageName: string, localeId: string) => {
 	const bundleKey = `${packageName}/${localeId}`;
 	const loadMessageBundle = loaders.get(bundleKey);
 
-	if (!bundlePromises.get(bundleKey)) {
+	if (loadMessageBundle && !bundlePromises.get(bundleKey)) {
 		bundlePromises.set(bundleKey, loadMessageBundle(localeId));
 	}
 
-	return bundlePromises.get(bundleKey);
+	return bundlePromises.get(bundleKey)!; // Investigate if i18n loader exists and this won't return undefined.
 };
 
-const _showAssetsWarningOnce = packageName => {
+const _showAssetsWarningOnce = (packageName: string) => {
 	if (!warningShown.has(packageName)) {
 		console.warn(`[${packageName}]: Message bundle assets are not configured. Falling back to English texts.`, /* eslint-disable-line */
 		` Add \`import "${packageName}/dist/Assets.js"\` in your bundle and make sure your build tool supports dynamic imports and JSON imports. See section "Assets" in the documentation for more information.`); /* eslint-disable-line */
@@ -77,7 +72,7 @@ const _showAssetsWarningOnce = packageName => {
  * @param {packageName} packageName the NPM package name
  * @public
  */
-const fetchI18nBundle = async packageName => {
+const fetchI18nBundle = async (packageName: string) => {
 	const language = getLocale().getLanguage();
 	const region = getLocale().getRegion();
 	let localeId = normalizeLocale(language + (region ? `-${region}` : ``));
@@ -101,7 +96,8 @@ const fetchI18nBundle = async packageName => {
 	try {
 		const data = await _loadMessageBundleOnce(packageName, localeId);
 		_setI18nBundleData(packageName, data);
-	} catch (e) {
+	} catch (error: unknown) {
+		const e = error as Error;
 		if (!reportedErrors.has(e.message)) {
 			reportedErrors.add(e.message);
 			console.error(e.message); /* eslint-disable-line */
@@ -110,7 +106,7 @@ const fetchI18nBundle = async packageName => {
 };
 
 // When the language changes dynamically (the user calls setLanguage), re-fetch all previously fetched bundles
-attachLanguageChange(() => {
+attachLanguageChange((lang: string /* eslint-disable-line */) => {
 	const allPackages = [...bundleData.keys()];
 	return Promise.all(allPackages.map(fetchI18nBundle));
 });
@@ -118,6 +114,5 @@ attachLanguageChange(() => {
 export {
 	registerI18nLoader,
 	fetchI18nBundle,
-	registerI18nBundle,
 	getI18nBundleData,
 };

package/src/assets-meta/IconCollectionsAlias.ts

@@ -0,0 +1,41 @@
+/**
+ * Supported icon collection aliases.
+ *
+ * Users might specify a collection, using both the key and the value in the following key-value pairs,
+ * e.g the following pairs are completely exchangeable:
+ *
+ * - "SAP-icons/accept" and "SAP-icons-v4/accept"
+ * - "horizon/accept" and "SAP-icons-v5/accept"
+ * - "SAP-icons-TNT/actor" and "tnt/actor"
+ * - "BusinessSuiteInAppSymbols/3d" and "business-suite/3d"
+ */
+enum IconCollectionsAlias {
+	"SAP-icons" = "SAP-icons-v4",
+	"horizon" = "SAP-icons-v5",
+	"SAP-icons-TNT" = "tnt",
+	"BusinessSuiteInAppSymbols" = "business-suite",
+}
+
+/**
+ * Returns the mapped collection name for a given alias.
+ *
+ * <b>For example</b>:
+ * - "SAP-icons-TNT"resolves to "tnt"
+ * - "BusinessSuiteInAppSymbols" resolves to "business-suite"
+ * - "horizon" resolves to "SAP-icons-v5"
+ *
+ * @param { string } collectionName
+ * @return { string } the normalized collection name
+ */
+const getIconCollectionByAlias = (collectionName: string) => {
+	if (IconCollectionsAlias[collectionName as keyof typeof IconCollectionsAlias]) {
+		return IconCollectionsAlias[collectionName as keyof typeof IconCollectionsAlias];
+	}
+
+	return collectionName;
+};
+
+export default IconCollectionsAlias;
+export {
+	getIconCollectionByAlias,
+};

package/src/config/AnimationMode.ts

@@ -0,0 +1,33 @@
+import { getAnimationMode as getConfiguredAnimationMode } from "../InitialConfiguration.js";
+import AnimationMode from "../types/AnimationMode.js";
+
+let curAnimationMode: AnimationMode;
+
+/**
+ * Returns the animation mode - "full", "basic", "minimal" or "none".
+ * @public
+ * @returns { AnimationMode }
+ */
+const getAnimationMode = (): AnimationMode => {
+	if (curAnimationMode === undefined) {
+		curAnimationMode = getConfiguredAnimationMode();
+	}
+
+	return curAnimationMode;
+};
+
+/**
+ * Sets the animation mode - "full", "basic", "minimal" or "none".
+ * @public
+ * @param { AnimationMode } animationMode
+ */
+const setAnimationMode = (animationMode: AnimationMode) => {
+	if (Object.values(AnimationMode).includes(animationMode)) {
+		curAnimationMode = animationMode;
+	}
+};
+
+export {
+	getAnimationMode,
+	setAnimationMode,
+};

package/src/config/{CalendarType.js → CalendarType.ts}

@@ -1,14 +1,19 @@
 import CalendarType from "../types/CalendarType.js";
 import { getCalendarType as getConfiguredCalendarType } from "../InitialConfiguration.js";
 
-let calendarType;
+let calendarType: CalendarType | undefined;
 
-const getCalendarType = () => {
+/**
+ * Returns the configured or default calendar type.
+ * @public
+ * @returns { CalendarType } the effective calendar type
+ */
+const getCalendarType = (): CalendarType => {
 	if (calendarType === undefined) {
 		calendarType = getConfiguredCalendarType();
 	}
 
-	if (CalendarType.isValid(calendarType)) {
+	if (calendarType && calendarType in CalendarType) {
 		return calendarType;
 	}