@ui5/webcomponents-base 0.0.0-4180fe799 → 0.0.0-4738ea0dc

package/src/CustomElementsRegistry.ts

@@ -0,0 +1,98 @@
+import getSharedResource from "./getSharedResource.js";
+import { getCurrentRuntimeIndex, compareRuntimes, getAllRuntimes } from "./Runtimes.js";
+import { Timeout } from "./types.js";
+
+const Tags = getSharedResource<Map<string, number>>("Tags", new Map());
+const Definitions = new Set<string>();
+
+let Failures = new Map<number, Set<string>>();
+let failureTimeout: Timeout | undefined;
+
+const UNKNOWN_RUNTIME = -1;
+
+const registerTag = (tag: string) => {
+	Definitions.add(tag);
+	Tags.set(tag, getCurrentRuntimeIndex());
+};
+
+const isTagRegistered = (tag: string) => {
+	return Definitions.has(tag);
+};
+
+const getAllRegisteredTags = () => {
+	return [...Definitions.values()];
+};
+
+const recordTagRegistrationFailure = (tag: string) => {
+	let tagRegRuntimeIndex = Tags.get(tag);
+	if (tagRegRuntimeIndex === undefined) {
+		tagRegRuntimeIndex = UNKNOWN_RUNTIME; // If the tag is taken, but not registered in Tags, then a version before 1.1.0 defined it => use the "unknown" key
+	}
+
+	if (!Failures.has(tagRegRuntimeIndex)) {
+		Failures.set(tagRegRuntimeIndex, new Set());
+	}
+	Failures.get(tagRegRuntimeIndex)!.add(tag);
+
+	if (!failureTimeout) {
+		failureTimeout = setTimeout(() => {
+			displayFailedRegistrations();
+			Failures = new Map();
+			failureTimeout = undefined;
+		}, 1000);
+	}
+};
+
+const displayFailedRegistrations = () => {
+	const allRuntimes = getAllRuntimes();
+	const currentRuntimeIndex = getCurrentRuntimeIndex();
+	const currentRuntime = allRuntimes[currentRuntimeIndex];
+
+	let message = `Multiple UI5 Web Components instances detected.`;
+
+	if (allRuntimes.length > 1) {
+		message = `${message}\nLoading order (versions before 1.1.0 not listed): ${allRuntimes.map(runtime => `\n${runtime.description}`).join("")}`;
+	}
+
+	[...Failures.keys()].forEach(otherRuntimeIndex => {
+		let comparison: number;
+		let otherRuntime;
+
+		if (otherRuntimeIndex === UNKNOWN_RUNTIME) { // version < 1.1.0 defined the tag
+			comparison = 1; // the current runtime is considered newer
+			otherRuntime = {
+				description: `Older unknown runtime`,
+			};
+		} else {
+			comparison = compareRuntimes(currentRuntimeIndex, otherRuntimeIndex);
+			otherRuntime = allRuntimes[otherRuntimeIndex];
+		}
+
+		let compareWord;
+		if (comparison > 0) {
+			compareWord = "an older";
+		} else if (comparison < 0) {
+			compareWord = "a newer";
+		} else {
+			compareWord = "the same";
+		}
+		message = `${message}\n\n"${currentRuntime.description}" failed to define ${Failures.get(otherRuntimeIndex)!.size} tag(s) as they were defined by a runtime of ${compareWord} version "${otherRuntime.description}": ${([...Failures.get(otherRuntimeIndex)!]).sort().join(", ")}.`;
+
+		if (comparison > 0) {
+			message = `${message}\nWARNING! If your code uses features of the above web components, unavailable in ${otherRuntime.description}, it might not work as expected!`;
+		} else {
+			message = `${message}\nSince the above web components were defined by the same or newer version runtime, they should be compatible with your code.`;
+		}
+	});
+
+	message = `${message}\n\nTo prevent other runtimes from defining tags that you use, consider using scoping or have third-party libraries use scoping: https://github.com/SAP/ui5-webcomponents/blob/main/docs/2-advanced/03-scoping.md.`;
+
+	console.warn(message); // eslint-disable-line
+};
+
+export {
+	registerTag,
+	isTagRegistered,
+	getAllRegisteredTags,
+	recordTagRegistrationFailure,
+};

package/src/CustomElementsScope.ts

@@ -0,0 +1,33 @@
+import {
+	html,
+	svg,
+	unsafeStatic,
+} from "lit-html/static.js";
+
+import {
+	setCustomElementsScopingSuffix,
+	getCustomElementsScopingSuffix,
+	setCustomElementsScopingRules,
+	getCustomElementsScopingRules,
+	shouldScopeCustomElement,
+	getEffectiveScopingSuffixForTag,
+} from "./CustomElementsScopeUtils.js";
+import { registerFeature } from "./FeaturesRegistry.js";
+
+class LitStatic {
+	static html = html;
+	static svg = svg;
+	static unsafeStatic: (value: string) => object = unsafeStatic;
+}
+
+registerFeature("LitStatic", LitStatic);
+
+export {
+	LitStatic,
+	setCustomElementsScopingSuffix,
+	getCustomElementsScopingSuffix,
+	setCustomElementsScopingRules,
+	getCustomElementsScopingRules,
+	shouldScopeCustomElement,
+	getEffectiveScopingSuffixForTag,
+};

package/src/{CustomElementsScope.js → CustomElementsScopeUtils.ts}

@@ -1,9 +1,16 @@
-let suf;
-let rulesObj = {
+let suf: string;
+
+type Rules = {
+	include: Array<RegExp>,
+	exclude: Array<RegExp>,
+};
+
+let rulesObj: Rules = {
 	include: [/^ui5-/],
 	exclude: [],
 };
-const tagsCache = new Map(); // true/false means the tag should/should not be cached, undefined means not known yet.
+
+const tagsCache = new Map<string, boolean>(); // true/false means the tag should/should not be cached, undefined means not known yet.
 
 /**
  * Sets the suffix to be used for custom elements scoping, f.e. pass "demo" to get tags such as "ui5-button-demo".
@@ -12,7 +19,7 @@ const tagsCache = new Map(); // true/false means the tag should/should not be ca
  * @public
  * @param suffix The scoping suffix
  */
-const setCustomElementsScopingSuffix = suffix => {
+const setCustomElementsScopingSuffix = (suffix: string) => {
 	if (!suffix.match(/^[a-zA-Z0-9_-]+$/)) {
 		throw new Error("Only alphanumeric characters and dashes allowed for the scoping suffix");
 	}
@@ -39,7 +46,7 @@ const getCustomElementsScopingSuffix = () => {
  * @param rules Object with "include" and "exclude" properties, both arrays of regular expressions. Note that "include"
  * rules are applied first and "exclude" rules second.
  */
-const setCustomElementsScopingRules = rules => {
+const setCustomElementsScopingRules = (rules: Rules) => {
 	if (!rules || !rules.include) {
 		throw new Error(`"rules" must be an object with at least an "include" property`);
 	}
@@ -76,7 +83,7 @@ const getCustomElementsScopingRules = () => {
  * @public
  * @param tag
  */
-const shouldScopeCustomElement = tag => {
+const shouldScopeCustomElement = (tag: string) => {
 	if (!tagsCache.has(tag)) {
 		const result = rulesObj.include.some(rule => tag.match(rule)) && !rulesObj.exclude.some(rule => tag.match(rule));
 		tagsCache.set(tag, result);
@@ -92,7 +99,7 @@ const shouldScopeCustomElement = tag => {
  * @param tag
  * @returns {String}
  */
-const getEffectiveScopingSuffixForTag = tag => {
+const getEffectiveScopingSuffixForTag = (tag: string) => {
 	if (shouldScopeCustomElement(tag)) {
 		return getCustomElementsScopingSuffix();
 	}

package/src/DOMObserver.ts

@@ -0,0 +1,28 @@
+const observers = new WeakMap<Node, MutationObserver>();
+
+/**
+ * @param node
+ * @param callback
+ * @param options
+ */
+const observeDOMNode = (node: Node, callback: MutationCallback, options?: MutationObserverInit) => {
+	const observer = new MutationObserver(callback);
+	observers.set(node, observer);
+	observer.observe(node, options);
+};
+
+/**
+ * @param node
+ */
+const unobserveDOMNode = (node: Node) => {
+	const observer = observers.get(node);
+	if (observer) {
+		observer.disconnect();
+		observers.delete(node);
+	}
+};
+
+export {
+	observeDOMNode,
+	unobserveDOMNode,
+};

package/src/Device.ts

@@ -0,0 +1,203 @@
+const isSSR = typeof document === "undefined";
+
+const internals = {
+	get userAgent() {
+		if (isSSR) {
+			return "";
+		}
+		return navigator.userAgent;
+	},
+	get touch() {
+		if (isSSR) {
+			return false;
+		}
+		return "ontouchstart" in window || navigator.maxTouchPoints > 0;
+	},
+	get ie() {
+		if (isSSR) {
+			return false;
+		}
+		return /(msie|trident)/i.test(internals.userAgent);
+	},
+	get chrome() {
+		if (isSSR) {
+			return false;
+		}
+		return !internals.ie && /(Chrome|CriOS)/.test(internals.userAgent);
+	},
+	get firefox() {
+		if (isSSR) {
+			return false;
+		}
+		return /Firefox/.test(internals.userAgent);
+	},
+	get safari() {
+		if (isSSR) {
+			return false;
+		}
+		return !internals.ie && !internals.chrome && /(Version|PhantomJS)\/(\d+\.\d+).*Safari/.test(internals.userAgent);
+	},
+	get webkit() {
+		if (isSSR) {
+			return false;
+		}
+		return !internals.ie && /webkit/.test(internals.userAgent);
+	},
+	get windows() {
+		if (isSSR) {
+			return false;
+		}
+		return navigator.platform.indexOf("Win") !== -1;
+	},
+	get iOS() {
+		if (isSSR) {
+			return false;
+		}
+		return !!(navigator.platform.match(/iPhone|iPad|iPod/)) || !!(internals.userAgent.match(/Mac/) && "ontouchend" in document);
+	},
+	get android() {
+		if (isSSR) {
+			return false;
+		}
+		return !internals.windows && /Android/.test(internals.userAgent);
+	},
+	get androidPhone() {
+		if (isSSR) {
+			return false;
+		}
+		return internals.android && /(?=android)(?=.*mobile)/i.test(internals.userAgent);
+	},
+	get ipad() {
+		if (isSSR) {
+			return false;
+		}
+		// With iOS 13 the string 'iPad' was removed from the user agent string through a browser setting, which is applied on all sites by default:
+		// "Request Desktop Website -> All websites" (for more infos see: https://forums.developer.apple.com/thread/119186).
+		// Therefore the OS is detected as MACINTOSH instead of iOS and the device is a tablet if the Device.support.touch is true.
+		return /ipad/i.test(internals.userAgent) || (/Macintosh/i.test(internals.userAgent) && "ontouchend" in document);
+	},
+};
+
+let windowsVersion: number;
+let webkitVersion: number;
+let tablet: boolean;
+
+const isWindows8OrAbove = () => {
+	if (isSSR) {
+		return false;
+	}
+
+	if (!internals.windows) {
+		return false;
+	}
+
+	if (windowsVersion === undefined) {
+		const matches = internals.userAgent.match(/Windows NT (\d+).(\d)/);
+		windowsVersion = matches ? parseFloat(matches[1]) : 0;
+	}
+
+	return windowsVersion >= 8;
+};
+
+const isWebkit537OrAbove = () => {
+	if (isSSR) {
+		return false;
+	}
+
+	if (!internals.webkit) {
+		return false;
+	}
+
+	if (webkitVersion === undefined) {
+		const matches = internals.userAgent.match(/(webkit)[ /]([\w.]+)/);
+		webkitVersion = matches ? parseFloat(matches[1]) : 0;
+	}
+
+	return webkitVersion >= 537.10;
+};
+
+const detectTablet = () => {
+	if (isSSR) {
+		return false;
+	}
+
+	if (tablet !== undefined) {
+		return;
+	}
+
+	if (internals.ipad) {
+		tablet = true;
+		return;
+	}
+
+	if (internals.touch) {
+		if (isWindows8OrAbove()) {
+			tablet = true;
+			return;
+		}
+
+		if (internals.chrome && internals.android) {
+			tablet = !/Mobile Safari\/[.0-9]+/.test(internals.userAgent);
+			return;
+		}
+
+		let densityFactor = window.devicePixelRatio ? window.devicePixelRatio : 1; // may be undefined in Windows Phone devices
+		if (internals.android && isWebkit537OrAbove()) {
+			densityFactor = 1;
+		}
+
+		tablet = (Math.min(window.screen.width / densityFactor, window.screen.height / densityFactor) >= 600);
+		return;
+	}
+
+	tablet = (internals.ie && internals.userAgent.indexOf("Touch") !== -1) || (internals.android && !internals.androidPhone);
+};
+
+const supportsTouch = (): boolean => internals.touch;
+const isIE = (): boolean => internals.ie;
+const isSafari = (): boolean => internals.safari;
+const isChrome = (): boolean => internals.chrome;
+const isFirefox = (): boolean => internals.firefox;
+
+const isTablet = (): boolean => {
+	detectTablet();
+	return (internals.touch || isWindows8OrAbove()) && tablet;
+};
+
+const isPhone = (): boolean => {
+	detectTablet();
+	return internals.touch && !tablet;
+};
+
+const isDesktop = (): boolean => {
+	if (isSSR) {
+		return false;
+	}
+	return (!isTablet() && !isPhone()) || isWindows8OrAbove();
+};
+
+const isCombi = (): boolean => {
+	return isTablet() && isDesktop();
+};
+
+const isIOS = (): boolean => {
+	return internals.iOS;
+};
+
+const isAndroid = (): boolean => {
+	return internals.android || internals.androidPhone;
+};
+
+export {
+	supportsTouch,
+	isIE,
+	isSafari,
+	isChrome,
+	isFirefox,
+	isPhone,
+	isTablet,
+	isDesktop,
+	isCombi,
+	isIOS,
+	isAndroid,
+};

package/src/{EventProvider.js → EventProvider.ts}

@@ -1,9 +1,11 @@
-class EventProvider {
+class EventProvider<EventListenerParam, EventListenerReturn> {
+	_eventRegistry: Map<string, Array<(param: EventListenerParam) => EventListenerReturn>>;
+
 	constructor() {
 		this._eventRegistry = new Map();
 	}
 
-	attachEvent(eventName, fnFunction) {
+	attachEvent(eventName: string, fnFunction: (param: EventListenerParam) => EventListenerReturn) {
 		const eventRegistry = this._eventRegistry;
 		const eventListeners = eventRegistry.get(eventName);
 
@@ -17,7 +19,7 @@ class EventProvider {
 		}
 	}
 
-	detachEvent(eventName, fnFunction) {
+	detachEvent(eventName: string, fnFunction: (param: EventListenerParam) => EventListenerReturn) {
 		const eventRegistry = this._eventRegistry;
 		const eventListeners = eventRegistry.get(eventName);
 
@@ -42,7 +44,7 @@ class EventProvider {
 	 * @param data optional data to pass to each event listener
 	 * @returns {Array} an array with the results of all event listeners
 	 */
-	fireEvent(eventName, data) {
+	fireEvent(eventName: string, data: EventListenerParam) {
 		const eventRegistry = this._eventRegistry;
 		const eventListeners = eventRegistry.get(eventName);
 
@@ -62,11 +64,11 @@ class EventProvider {
 	 * @param data optional data to pass to each event listener
 	 * @returns {Promise} a promise that will resolve when all listeners have resolved
 	 */
-	fireEventAsync(eventName, data) {
+	fireEventAsync(eventName: string, data: EventListenerParam) {
 		return Promise.all(this.fireEvent(eventName, data));
 	}
 
-	isHandlerAttached(eventName, fnFunction) {
+	isHandlerAttached(eventName: string, fnFunction: (param: EventListenerParam) => EventListenerReturn) {
 		const eventRegistry = this._eventRegistry;
 		const eventListeners = eventRegistry.get(eventName);
 
@@ -77,7 +79,7 @@ class EventProvider {
 		return eventListeners.includes(fnFunction);
 	}
 
-	hasListeners(eventName) {
+	hasListeners(eventName: string) {
 		return !!this._eventRegistry.get(eventName);
 	}
 }

package/src/FeaturesRegistry.ts

@@ -0,0 +1,14 @@
+const features = new Map<string, any>();
+
+const registerFeature = (name: string, feature: object) => {
+	features.set(name, feature);
+};
+
+const getFeature = <T>(name: string): T => {
+	return features.get(name) as T;
+};
+
+export {
+	registerFeature,
+	getFeature,
+};

package/src/{FontFace.js → FontFace.ts}

@@ -2,12 +2,13 @@ import { hasStyle, createStyle } from "./ManagedStyles.js";
 import { getFeature } from "./FeaturesRegistry.js";
 import fontFaceCSS from "./generated/css/FontFace.css.js";
 import overrideFontFaceCSS from "./generated/css/OverrideFontFace.css.js";
+import type OpenUI5Support from "./features/OpenUI5Support.js";
 
 const insertFontFace = () => {
-	const OpenUI5Support = getFeature("OpenUI5Support");
+	const openUI5Support = getFeature<typeof OpenUI5Support>("OpenUI5Support");
 
 	// Only set the main font if there is no OpenUI5 support, or there is, but OpenUI5 is not loaded
-	if (!OpenUI5Support || !OpenUI5Support.isLoaded()) {
+	if (!openUI5Support || !openUI5Support.isLoaded()) {
 		insertMainFontFace();
 	}
 

package/src/{InitialConfiguration.js → InitialConfiguration.ts}

@@ -1,15 +1,34 @@
 import merge from "./thirdparty/merge.js";
 import { getFeature } from "./FeaturesRegistry.js";
 import { DEFAULT_THEME } from "./generated/AssetParameters.js";
+import validateThemeRoot from "./validateThemeRoot.js";
+import type OpenUI5Support from "./features/OpenUI5Support";
+import type { FormatSettings } from "./config/FormatSettings.js";
+import AnimationMode from "./types/AnimationMode.js";
+import CalendarType from "./types/CalendarType.js";
 
 let initialized = false;
 
-let initialConfig = {
-	animationMode: "full",
+type InitialConfig = {
+	[key: string]: any,
+	animationMode: AnimationMode,
+	theme: string,
+	themeRoot: string | undefined,
+	rtl: boolean | undefined,
+	language: string | undefined,
+	calendarType: CalendarType | undefined,
+	noConflict: boolean,
+	formatSettings: FormatSettings,
+	fetchDefaultLanguage: boolean,
+};
+
+let initialConfig: InitialConfig = {
+	animationMode: AnimationMode.Full,
 	theme: DEFAULT_THEME,
-	rtl: null,
-	language: null,
-	calendarType: null,
+	themeRoot: undefined,
+	rtl: undefined,
+	language: undefined,
+	calendarType: undefined,
 	noConflict: false, // no URL
 	formatSettings: {},
 	fetchDefaultLanguage: false,
@@ -26,6 +45,11 @@ const getTheme = () => {
 	return initialConfig.theme;
 };
 
+const getThemeRoot = () => {
+	initConfiguration();
+	return initialConfig.themeRoot;
+};
+
 const getRTL = () => {
 	initConfiguration();
 	return initialConfig.rtl;
@@ -51,6 +75,10 @@ const getNoConflict = () => {
 	return initialConfig.noConflict;
 };
 
+/**
+ * Get the configured calendar type
+ * @returns { String } the name of the configured calendar type
+ */
 const getCalendarType = () => {
 	initConfiguration();
 	return initialConfig.calendarType;
@@ -106,7 +134,13 @@ const parseURLParameters = () => {
 	});
 };
 
-const normalizeParamValue = (param, value) => {
+const normalizeThemeRootParamValue = (value: string) => {
+	const themeRoot = value.split("@")[1];
+
+	return validateThemeRoot(themeRoot);
+};
+
+const normalizeThemeParamValue = (param: string, value: string) => {
 	if (param === "theme" && value.includes("@")) { // the theme parameter might have @<URL-TO-THEME> in the value - strip this
 		return value.split("@")[0];
 	}
@@ -114,7 +148,7 @@ const normalizeParamValue = (param, value) => {
 	return value;
 };
 
-const applyURLParam = (key, value, paramType) => {
+const applyURLParam = (key: string, value: string, paramType: string) => {
 	const lowerCaseValue = value.toLowerCase();
 	const param = key.split(`${paramType}-`)[1];
 
@@ -122,23 +156,29 @@ const applyURLParam = (key, value, paramType) => {
 		value = booleanMapping.get(lowerCaseValue);
 	}
 
-	value = normalizeParamValue(param, value);
+	if (param === "theme") {
+		initialConfig.theme = normalizeThemeParamValue(param, value);
 
-	initialConfig[param] = value;
+		if (value && value.includes("@")) {
+			initialConfig.themeRoot = normalizeThemeRootParamValue(value);
+		}
+	} else {
+		initialConfig[param] = value;
+	}
 };
 
 const applyOpenUI5Configuration = () => {
-	const OpenUI5Support = getFeature("OpenUI5Support");
-	if (!OpenUI5Support || !OpenUI5Support.isLoaded()) {
+	const openUI5Support = getFeature<typeof OpenUI5Support>("OpenUI5Support");
+	if (!openUI5Support || !openUI5Support.isLoaded()) {
 		return;
 	}
 
-	const OpenUI5Config = OpenUI5Support.getConfigurationSettingsObject();
+	const OpenUI5Config = openUI5Support.getConfigurationSettingsObject();
 	initialConfig = merge(initialConfig, OpenUI5Config);
 };
 
 const initConfiguration = () => {
-	if (initialized) {
+	if (typeof document === "undefined" || initialized) {
 		return;
 	}
 
@@ -157,6 +197,7 @@ const initConfiguration = () => {
 export {
 	getAnimationMode,
 	getTheme,
+	getThemeRoot,
 	getRTL,
 	getLanguage,
 	getFetchDefaultLanguage,