@ui5/webcomponents-base 0.0.0-4821618b2 → 0.0.0-49bade48d

package/dist/config/Theme.js

@@ -1,28 +1,105 @@
 import { getTheme as getConfiguredTheme } from "../InitialConfiguration.js";
+import { reRenderAllUI5Elements } from "../Render.js";
 import applyTheme from "../theming/applyTheme.js";
-
-let theme;
-
+import getThemeDesignerTheme from "../theming/getThemeDesignerTheme.js";
+import { DEFAULT_THEME, SUPPORTED_THEMES } from "../generated/AssetParameters.js";
+import { boot, isBooted } from "../Boot.js";
+import { attachConfigurationReset } from "./ConfigurationReset.js";
+import { fireConfigChange, attachConfigChange, getSharedValue } from "./ConfigurationSync.js";
+let curTheme;
+let curBaseTheme;
+attachConfigurationReset(() => {
+    curTheme = undefined;
+});
+attachConfigChange("theme", (theme) => {
+    curTheme = theme;
+    if (isBooted()) {
+        applyTheme(curTheme).then(() => reRenderAllUI5Elements({ themeAware: true }));
+    }
+});
+/**
+ * Returns the current theme.
+ * @public
+ * @returns {string} the current theme name
+ */
 const getTheme = () => {
-	if (theme === undefined) {
-		theme = getConfiguredTheme();
-	}
-
-	return theme;
-};
-
-const setTheme = async newTheme => {
-	if (theme === newTheme) {
-		return;
-	}
-
-	theme = newTheme;
-
-	// Update CSS Custom Properties
-	await applyTheme(theme);
-};
-
-export {
-	getTheme,
-	setTheme,
+    if (curTheme === undefined) {
+        curTheme = getSharedValue("theme") ?? getConfiguredTheme();
+    }
+    return curTheme;
 };
+/**
+ * Applies a new theme after fetching its assets from the network.
+ * @public
+ * @param {string} theme the name of the new theme
+ * @returns {Promise<void>} a promise that is resolved when the new theme assets have been fetched and applied to the DOM
+ */
+const setTheme = async (theme) => {
+    if (curTheme === theme) {
+        return;
+    }
+    curTheme = theme;
+    fireConfigChange("theme", theme);
+    if (isBooted()) {
+        // Update CSS Custom Properties
+        await applyTheme(curTheme);
+        await reRenderAllUI5Elements({ themeAware: true });
+    }
+};
+/**
+ * Returns the default theme.
+ *
+ * Note: Default theme might be different than the configurated one.
+ *
+ * @public
+ * @returns {string}
+ */
+const getDefaultTheme = () => {
+    return DEFAULT_THEME;
+};
+/**
+ * Returns if the given theme name is the one currently applied.
+ * @private
+ * @param {string} theme
+ * @returns {boolean}
+ */
+const isTheme = (theme) => {
+    return getTheme() === theme;
+};
+/**
+ * Returns if the currently set theme is part of legacy theme families ("sap_fiori_3").
+ * **Note**: in addition, the method checks the base theme of a custom theme, built via the ThemeDesigner.
+ *
+ * @private
+ * @returns { boolean }
+ */
+const isLegacyThemeFamily = () => {
+    const currentTheme = getTheme();
+    if (!isKnownTheme(currentTheme)) {
+        return !getThemeDesignerTheme()?.baseThemeName?.startsWith("sap_horizon");
+    }
+    return !currentTheme.startsWith("sap_horizon");
+};
+const isLegacyThemeFamilyAsync = async () => {
+    await boot();
+    return isLegacyThemeFamily();
+};
+const isKnownTheme = (theme) => SUPPORTED_THEMES.includes(theme);
+/**
+ * Returns the base theme of external theme.
+ * @private
+ * @returns {string | undefined} the base theme name
+ */
+const getBaseTheme = () => {
+    return curBaseTheme;
+};
+/**
+ * Sets the base theme of the current external theme.
+ * @param { string | undefined } theme the name of the new base theme
+ * @private
+ */
+const setBaseTheme = (theme) => {
+    curBaseTheme = theme;
+};
+export { getTheme, setTheme, isTheme, isLegacyThemeFamily, isLegacyThemeFamilyAsync, getDefaultTheme, getBaseTheme, setBaseTheme, };
+//# sourceMappingURL=Theme.js.map

package/dist/config/Theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Theme.js","sourceRoot":"","sources":["../../src/config/Theme.ts"],"names":[],"mappings":"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","sourcesContent":["import { getTheme as getConfiguredTheme } from \"../InitialConfiguration.js\";\nimport { reRenderAllUI5Elements } from \"../Render.js\";\nimport applyTheme from \"../theming/applyTheme.js\";\nimport getThemeDesignerTheme from \"../theming/getThemeDesignerTheme.js\";\nimport { DEFAULT_THEME, SUPPORTED_THEMES } from \"../generated/AssetParameters.js\";\nimport { boot, isBooted } from \"../Boot.js\";\nimport { attachConfigurationReset } from \"./ConfigurationReset.js\";\nimport { fireConfigChange, attachConfigChange, getSharedValue } from \"./ConfigurationSync.js\";\n\nlet curTheme: string | undefined;\nlet curBaseTheme: string | undefined;\n\nattachConfigurationReset(() => {\n\tcurTheme = undefined;\n});\n\nattachConfigChange(\"theme\", (theme: string) => {\n\tcurTheme = theme;\n\tif (isBooted()) {\n\t\tapplyTheme(curTheme).then(() => reRenderAllUI5Elements({ themeAware: true }));\n\t}\n});\n\n/**\n * Returns the current theme.\n * @public\n * @returns {string} the current theme name\n */\nconst getTheme = (): string => {\n\tif (curTheme === undefined) {\n\t\tcurTheme = getSharedValue<string>(\"theme\") ?? getConfiguredTheme();\n\t}\n\n\treturn curTheme;\n};\n\n/**\n * Applies a new theme after fetching its assets from the network.\n * @public\n * @param {string} theme the name of the new theme\n * @returns {Promise<void>} a promise that is resolved when the new theme assets have been fetched and applied to the DOM\n */\nconst setTheme = async (theme: string): Promise<void> => {\n\tif (curTheme === theme) {\n\t\treturn;\n\t}\n\n\tcurTheme = theme;\n\n\tfireConfigChange(\"theme\", theme);\n\n\tif (isBooted()) {\n\t\t// Update CSS Custom Properties\n\t\tawait applyTheme(curTheme);\n\t\tawait reRenderAllUI5Elements({ themeAware: true });\n\t}\n};\n\n/**\n * Returns the default theme.\n *\n * Note: Default theme might be different than the configurated one.\n *\n * @public\n * @returns {string}\n */\nconst getDefaultTheme = (): string => {\n\treturn DEFAULT_THEME;\n};\n\n/**\n * Returns if the given theme name is the one currently applied.\n * @private\n * @param {string} theme\n * @returns {boolean}\n */\nconst isTheme = (theme: string) => {\n\treturn getTheme() === theme;\n};\n\n/**\n * Returns if the currently set theme is part of legacy theme families (\"sap_fiori_3\").\n * **Note**: in addition, the method checks the base theme of a custom theme, built via the ThemeDesigner.\n *\n * @private\n * @returns { boolean }\n */\nconst isLegacyThemeFamily = () => {\n\tconst currentTheme = getTheme();\n\n\tif (!isKnownTheme(currentTheme)) {\n\t\treturn !getThemeDesignerTheme()?.baseThemeName?.startsWith(\"sap_horizon\");\n\t}\n\n\treturn !currentTheme.startsWith(\"sap_horizon\");\n};\n\nconst isLegacyThemeFamilyAsync = async () => {\n\tawait boot();\n\treturn isLegacyThemeFamily();\n};\n\nconst isKnownTheme = (theme: string) => SUPPORTED_THEMES.includes(theme);\n\n/**\n * Returns the base theme of external theme.\n * @private\n * @returns {string | undefined} the base theme name\n */\nconst getBaseTheme = (): string | undefined => {\n\treturn curBaseTheme;\n};\n\n/**\n * Sets the base theme of the current external theme.\n * @param { string | undefined } theme the name of the new base theme\n * @private\n */\nconst setBaseTheme = (theme: string | undefined): void => {\n\tcurBaseTheme = theme;\n};\n\nexport {\n\tgetTheme,\n\tsetTheme,\n\tisTheme,\n\tisLegacyThemeFamily,\n\tisLegacyThemeFamilyAsync,\n\tgetDefaultTheme,\n\tgetBaseTheme,\n\tsetBaseTheme,\n};\n"]}

package/dist/config/ThemeRoot.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Returns the current theme root.
+ *
+ * @public
+ * @since 1.14.0
+ * @returns { string } the current theme root
+ */
+declare const getThemeRoot: () => string | undefined;
+/**
+ * Sets theme root for the current theme.
+ * When set, the framework will validate the theme root and fetch the theme styles (CSS variables) from this location.
+ *
+ * **Note:** The feature is specific to custom themes, created with the `UI Theme Designer`.
+ * The provided theme root is used only as a base to construct the actual location of the theme styles: `{themeRoot}/.../css_variables.css`.
+ *
+ * **Note:** Certain security restrictions will apply before fetching the theme assets.
+ * Absolute URLs to a different origin than the current page will result in using the current page as an origin.
+ *
+ * **Important:** To use this feature you must explicitly allow specific origins by using <meta name="sap-allowed-theme-origins" content="https://my-example-host.com/"> tag inside the <head> of the page.
+ * Failing to do so will result in a warning in the console and the theme root will not be set.
+ *
+ * @public
+ * @since 1.14.0
+ * @param { string } themeRoot the new theme root
+ * @returns { Promise<void> }
+ */
+declare const setThemeRoot: (themeRoot: string) => Promise<void> | undefined;
+declare const attachCustomThemeStylesToHead: (theme: string) => Promise<void>;
+export { getThemeRoot, setThemeRoot, attachCustomThemeStylesToHead, };

package/dist/config/ThemeRoot.js

@@ -0,0 +1,68 @@
+import createLinkInHead from "../util/createLinkInHead.js";
+import validateThemeRoot from "../validateThemeRoot.js";
+import { getThemeRoot as getConfiguredThemeRoot } from "../InitialConfiguration.js";
+import { getTheme } from "./Theme.js";
+import { attachConfigurationReset } from "./ConfigurationReset.js";
+let currThemeRoot;
+attachConfigurationReset(() => {
+    currThemeRoot = undefined;
+});
+/**
+ * Returns the current theme root.
+ *
+ * @public
+ * @since 1.14.0
+ * @returns { string } the current theme root
+ */
+const getThemeRoot = () => {
+    if (currThemeRoot === undefined) {
+        currThemeRoot = getConfiguredThemeRoot();
+    }
+    return currThemeRoot;
+};
+/**
+ * Sets theme root for the current theme.
+ * When set, the framework will validate the theme root and fetch the theme styles (CSS variables) from this location.
+ *
+ * **Note:** The feature is specific to custom themes, created with the `UI Theme Designer`.
+ * The provided theme root is used only as a base to construct the actual location of the theme styles: `{themeRoot}/.../css_variables.css`.
+ *
+ * **Note:** Certain security restrictions will apply before fetching the theme assets.
+ * Absolute URLs to a different origin than the current page will result in using the current page as an origin.
+ *
+ * **Important:** To use this feature you must explicitly allow specific origins by using <meta name="sap-allowed-theme-origins" content="https://my-example-host.com/"> tag inside the <head> of the page.
+ * Failing to do so will result in a warning in the console and the theme root will not be set.
+ *
+ * @public
+ * @since 1.14.0
+ * @param { string } themeRoot the new theme root
+ * @returns { Promise<void> }
+ */
+const setThemeRoot = (themeRoot) => {
+    if (currThemeRoot === themeRoot) {
+        return;
+    }
+    currThemeRoot = themeRoot;
+    return attachCustomThemeStylesToHead(getTheme());
+};
+const formatThemeLink = (theme, validatedThemeRoot) => {
+    return `${validatedThemeRoot}Base/baseLib/${theme}/css_variables.css`;
+};
+const attachCustomThemeStylesToHead = async (theme) => {
+    const link = document.querySelector(`[sap-ui-webcomponents-theme="${theme}"]`);
+    if (link) {
+        document.head.removeChild(link);
+    }
+    const themeRoot = getThemeRoot();
+    if (!themeRoot) {
+        return;
+    }
+    const validatedThemeRoot = validateThemeRoot(themeRoot);
+    if (!validatedThemeRoot) {
+        console.warn(`The ${themeRoot} is not valid. Check the allowed origins as suggested in the "setThemeRoot" description.`); // eslint-disable-line
+        return;
+    }
+    await createLinkInHead(formatThemeLink(theme, validatedThemeRoot), { "sap-ui-webcomponents-theme": theme });
+};
+export { getThemeRoot, setThemeRoot, attachCustomThemeStylesToHead, };
+//# sourceMappingURL=ThemeRoot.js.map

package/dist/config/ThemeRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeRoot.js","sourceRoot":"","sources":["../../src/config/ThemeRoot.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,6BAA6B,CAAC;AAC3D,OAAO,iBAAiB,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,IAAI,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,IAAI,aAAiC,CAAC;AAEtC,wBAAwB,CAAC,GAAG,EAAE;IAC7B,aAAa,GAAG,SAAS,CAAC;AAC3B,CAAC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,YAAY,GAAG,GAAuB,EAAE;IAC7C,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QACjC,aAAa,GAAG,sBAAsB,EAAE,CAAC;IAC1C,CAAC;IAED,OAAO,aAAa,CAAC;AACtB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,YAAY,GAAG,CAAC,SAAiB,EAA6B,EAAE;IACrE,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO;IACR,CAAC;IAED,aAAa,GAAG,SAAS,CAAC;IAE1B,OAAO,6BAA6B,CAAC,QAAQ,EAAE,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,KAAa,EAAE,kBAA0B,EAAE,EAAE;IACrE,OAAO,GAAG,kBAAkB,gBAAgB,KAAK,oBAAoB,CAAC;AACvE,CAAC,CAAC;AAEF,MAAM,6BAA6B,GAAG,KAAK,EAAE,KAAa,EAAiB,EAAE;IAC5E,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,gCAAgC,KAAK,IAAI,CAAC,CAAC;IAE/E,IAAI,IAAI,EAAE,CAAC;QACV,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IAEjC,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,OAAO;IACR,CAAC;IAED,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAExD,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,OAAO,SAAS,0FAA0F,CAAC,CAAC,CAAC,sBAAsB;QAChJ,OAAO;IACR,CAAC;IAED,MAAM,gBAAgB,CAAC,eAAe,CAAC,KAAK,EAAE,kBAAkB,CAAC,EAAE,EAAE,4BAA4B,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7G,CAAC,CAAC;AAEF,OAAO,EACN,YAAY,EACZ,YAAY,EACZ,6BAA6B,GAC7B,CAAC","sourcesContent":["import createLinkInHead from \"../util/createLinkInHead.js\";\nimport validateThemeRoot from \"../validateThemeRoot.js\";\nimport { getThemeRoot as getConfiguredThemeRoot } from \"../InitialConfiguration.js\";\nimport { getTheme } from \"./Theme.js\";\nimport { attachConfigurationReset } from \"./ConfigurationReset.js\";\n\nlet currThemeRoot: string | undefined;\n\nattachConfigurationReset(() => {\n\tcurrThemeRoot = undefined;\n});\n\n/**\n * Returns the current theme root.\n *\n * @public\n * @since 1.14.0\n * @returns { string } the current theme root\n */\nconst getThemeRoot = (): string | undefined => {\n\tif (currThemeRoot === undefined) {\n\t\tcurrThemeRoot = getConfiguredThemeRoot();\n\t}\n\n\treturn currThemeRoot;\n};\n\n/**\n * Sets theme root for the current theme.\n * When set, the framework will validate the theme root and fetch the theme styles (CSS variables) from this location.\n *\n * **Note:** The feature is specific to custom themes, created with the `UI Theme Designer`.\n * The provided theme root is used only as a base to construct the actual location of the theme styles: `{themeRoot}/.../css_variables.css`.\n *\n * **Note:** Certain security restrictions will apply before fetching the theme assets.\n * Absolute URLs to a different origin than the current page will result in using the current page as an origin.\n *\n * **Important:** To use this feature you must explicitly allow specific origins by using &lt;meta name=\"sap-allowed-theme-origins\" content=\"https://my-example-host.com/\"&gt; tag inside the &lt;head&gt; of the page.\n * Failing to do so will result in a warning in the console and the theme root will not be set.\n *\n * @public\n * @since 1.14.0\n * @param { string } themeRoot the new theme root\n * @returns { Promise<void> }\n */\nconst setThemeRoot = (themeRoot: string): Promise<void> | undefined => {\n\tif (currThemeRoot === themeRoot) {\n\t\treturn;\n\t}\n\n\tcurrThemeRoot = themeRoot;\n\n\treturn attachCustomThemeStylesToHead(getTheme());\n};\n\nconst formatThemeLink = (theme: string, validatedThemeRoot: string) => {\n\treturn `${validatedThemeRoot}Base/baseLib/${theme}/css_variables.css`;\n};\n\nconst attachCustomThemeStylesToHead = async (theme: string): Promise<void> => {\n\tconst link = document.querySelector(`[sap-ui-webcomponents-theme=\"${theme}\"]`);\n\n\tif (link) {\n\t\tdocument.head.removeChild(link);\n\t}\n\n\tconst themeRoot = getThemeRoot();\n\n\tif (!themeRoot) {\n\t\treturn;\n\t}\n\n\tconst validatedThemeRoot = validateThemeRoot(themeRoot);\n\n\tif (!validatedThemeRoot) {\n\t\tconsole.warn(`The ${themeRoot} is not valid. Check the allowed origins as suggested in the \"setThemeRoot\" description.`); // eslint-disable-line\n\t\treturn;\n\t}\n\n\tawait createLinkInHead(formatThemeLink(theme, validatedThemeRoot), { \"sap-ui-webcomponents-theme\": theme });\n};\n\nexport {\n\tgetThemeRoot,\n\tsetThemeRoot,\n\tattachCustomThemeStylesToHead,\n};\n"]}

package/dist/config/Timezone.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Returns the configured IANA timezone ID.
+ *
+ * @private
+ * @returns {string}
+ */
+declare const getTimezone: () => string | undefined;
+/**
+ * Sets the IANA timezone ID.
+ * **For example:** "America/New_York", "Europe/London", "Australia/Sydney", "Asia/Bishkek", etc.
+ *>
+ * @param {string} timezone
+ * @private
+ * @returns { Promise<void> }
+ */
+declare const setTimezone: (timezone: string) => void;
+export { getTimezone, setTimezone, };

package/dist/config/Timezone.js

@@ -0,0 +1,34 @@
+import { getTimezone as getConfiguredTimezone } from "../InitialConfiguration.js";
+import { attachConfigurationReset } from "./ConfigurationReset.js";
+let currTimezone;
+attachConfigurationReset(() => {
+    currTimezone = undefined;
+});
+/**
+ * Returns the configured IANA timezone ID.
+ *
+ * @private
+ * @returns {string}
+ */
+const getTimezone = () => {
+    if (currTimezone === undefined) {
+        currTimezone = getConfiguredTimezone();
+    }
+    return currTimezone;
+};
+/**
+ * Sets the IANA timezone ID.
+ * **For example:** "America/New_York", "Europe/London", "Australia/Sydney", "Asia/Bishkek", etc.
+ *>
+ * @param {string} timezone
+ * @private
+ * @returns { Promise<void> }
+ */
+const setTimezone = (timezone) => {
+    if (currTimezone === timezone) {
+        return;
+    }
+    currTimezone = timezone;
+};
+export { getTimezone, setTimezone, };
+//# sourceMappingURL=Timezone.js.map

package/dist/config/Timezone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timezone.js","sourceRoot":"","sources":["../../src/config/Timezone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,IAAI,YAAgC,CAAC;AAErC,wBAAwB,CAAC,GAAG,EAAE;IAC7B,YAAY,GAAG,SAAS,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,WAAW,GAAG,GAAuB,EAAE;IAC5C,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAChC,YAAY,GAAG,qBAAqB,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,YAAY,CAAC;AACrB,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAE,EAAE;IACxC,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO;IACR,CAAC;IAED,YAAY,GAAG,QAAQ,CAAC;AACzB,CAAC,CAAC;AAEF,OAAO,EACN,WAAW,EACX,WAAW,GACX,CAAC","sourcesContent":["import { getTimezone as getConfiguredTimezone } from \"../InitialConfiguration.js\";\nimport { attachConfigurationReset } from \"./ConfigurationReset.js\";\n\nlet currTimezone: string | undefined;\n\nattachConfigurationReset(() => {\n\tcurrTimezone = undefined;\n});\n\n/**\n * Returns the configured IANA timezone ID.\n *\n * @private\n * @returns {string}\n */\nconst getTimezone = (): string | undefined => {\n\tif (currTimezone === undefined) {\n\t\tcurrTimezone = getConfiguredTimezone();\n\t}\n\treturn currTimezone;\n};\n\n/**\n * Sets the IANA timezone ID.\n * **For example:** \"America/New_York\", \"Europe/London\", \"Australia/Sydney\", \"Asia/Bishkek\", etc.\n *>\n * @param {string} timezone\n * @private\n * @returns { Promise<void> }\n */\nconst setTimezone = (timezone: string) => {\n\tif (currTimezone === timezone) {\n\t\treturn;\n\t}\n\n\tcurrTimezone = timezone;\n};\n\nexport {\n\tgetTimezone,\n\tsetTimezone,\n};\n"]}

package/dist/config/Tooltips.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Returns if the "enableDefaultTooltips" configuration is set.
+ * @public
+ * @since 2.1.0
+ * @returns { boolean }
+ */
+declare const getEnableDefaultTooltips: () => boolean;
+/**
+ * Defines the "enableDefaultTooltips" setting.
+ *
+ * - When set to "true" (default), the components will display default tooltips.
+ * - When set to "false", the components will NOT display default tooltips.
+ *
+ * @public
+ * @since 2.1.0
+ * @param { boolean } enableDefaultTooltips
+ */
+declare const setEnableDefaultTooltips: (enableDefaultTooltips: boolean) => void;
+export { getEnableDefaultTooltips, setEnableDefaultTooltips, };

package/dist/config/Tooltips.js

@@ -0,0 +1,29 @@
+import { getEnableDefaultTooltips as getConfiguredEnableDefaultTooltips } from "../InitialConfiguration.js";
+let _enableDefaultTooltips;
+/**
+ * Returns if the "enableDefaultTooltips" configuration is set.
+ * @public
+ * @since 2.1.0
+ * @returns { boolean }
+ */
+const getEnableDefaultTooltips = () => {
+    if (_enableDefaultTooltips === undefined) {
+        _enableDefaultTooltips = getConfiguredEnableDefaultTooltips();
+    }
+    return _enableDefaultTooltips;
+};
+/**
+ * Defines the "enableDefaultTooltips" setting.
+ *
+ * - When set to "true" (default), the components will display default tooltips.
+ * - When set to "false", the components will NOT display default tooltips.
+ *
+ * @public
+ * @since 2.1.0
+ * @param { boolean } enableDefaultTooltips
+ */
+const setEnableDefaultTooltips = (enableDefaultTooltips) => {
+    _enableDefaultTooltips = enableDefaultTooltips;
+};
+export { getEnableDefaultTooltips, setEnableDefaultTooltips, };
+//# sourceMappingURL=Tooltips.js.map

package/dist/config/Tooltips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltips.js","sourceRoot":"","sources":["../../src/config/Tooltips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,IAAI,kCAAkC,EAAE,MAAM,4BAA4B,CAAC;AAE5G,IAAI,sBAA+B,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,wBAAwB,GAAG,GAAY,EAAE;IAC9C,IAAI,sBAAsB,KAAK,SAAS,EAAE,CAAC;QAC1C,sBAAsB,GAAG,kCAAkC,EAAE,CAAC;IAC/D,CAAC;IAED,OAAO,sBAAsB,CAAC;AAC/B,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,wBAAwB,GAAG,CAAC,qBAA8B,EAAE,EAAE;IACnE,sBAAsB,GAAG,qBAAqB,CAAC;AAChD,CAAC,CAAC;AAEF,OAAO,EACN,wBAAwB,EACxB,wBAAwB,GACxB,CAAC","sourcesContent":["import { getEnableDefaultTooltips as getConfiguredEnableDefaultTooltips } from \"../InitialConfiguration.js\";\n\nlet _enableDefaultTooltips: boolean;\n\n/**\n * Returns if the \"enableDefaultTooltips\" configuration is set.\n * @public\n * @since 2.1.0\n * @returns { boolean }\n */\nconst getEnableDefaultTooltips = (): boolean => {\n\tif (_enableDefaultTooltips === undefined) {\n\t\t_enableDefaultTooltips = getConfiguredEnableDefaultTooltips();\n\t}\n\n\treturn _enableDefaultTooltips;\n};\n\n/**\n * Defines the \"enableDefaultTooltips\" setting.\n *\n * - When set to \"true\" (default), the components will display default tooltips.\n * - When set to \"false\", the components will NOT display default tooltips.\n *\n * @public\n * @since 2.1.0\n * @param { boolean } enableDefaultTooltips\n */\nconst setEnableDefaultTooltips = (enableDefaultTooltips: boolean) => {\n\t_enableDefaultTooltips = enableDefaultTooltips;\n};\n\nexport {\n\tgetEnableDefaultTooltips,\n\tsetEnableDefaultTooltips,\n};\n"]}

package/dist/config/UrlParams.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Returns if the "ignoreUrlParams" configuration is set.
+ * @public
+ * @since 2.23.0
+ * @returns { boolean }
+ */
+declare const getIgnoreUrlParams: () => boolean;
+/**
+ * Defines the "ignoreUrlParams" setting.
+ *
+ * - When set to "true", the framework will not process URL parameters
+ * (e.g. sap-ui-theme, sap-ui-language) during initialization.
+ * - When set to "false" (default), URL parameters are processed normally.
+ *
+ * @public
+ * @since 2.23.0
+ * @param { boolean } ignoreUrlParams
+ */
+declare const setIgnoreUrlParams: (ignoreUrlParams: boolean) => void;
+export { getIgnoreUrlParams, setIgnoreUrlParams, };

package/dist/config/UrlParams.js

@@ -0,0 +1,30 @@
+import { getIgnoreUrlParams as getConfiguredIgnoreUrlParams } from "../InitialConfiguration.js";
+let _ignoreUrlParams;
+/**
+ * Returns if the "ignoreUrlParams" configuration is set.
+ * @public
+ * @since 2.23.0
+ * @returns { boolean }
+ */
+const getIgnoreUrlParams = () => {
+    if (_ignoreUrlParams === undefined) {
+        _ignoreUrlParams = getConfiguredIgnoreUrlParams();
+    }
+    return _ignoreUrlParams;
+};
+/**
+ * Defines the "ignoreUrlParams" setting.
+ *
+ * - When set to "true", the framework will not process URL parameters
+ * (e.g. sap-ui-theme, sap-ui-language) during initialization.
+ * - When set to "false" (default), URL parameters are processed normally.
+ *
+ * @public
+ * @since 2.23.0
+ * @param { boolean } ignoreUrlParams
+ */
+const setIgnoreUrlParams = (ignoreUrlParams) => {
+    _ignoreUrlParams = ignoreUrlParams;
+};
+export { getIgnoreUrlParams, setIgnoreUrlParams, };
+//# sourceMappingURL=UrlParams.js.map

package/dist/config/UrlParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlParams.js","sourceRoot":"","sources":["../../src/config/UrlParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,IAAI,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAEhG,IAAI,gBAAyB,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,GAAY,EAAE;IACxC,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACpC,gBAAgB,GAAG,4BAA4B,EAAE,CAAC;IACnD,CAAC;IAED,OAAO,gBAAgB,CAAC;AACzB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,kBAAkB,GAAG,CAAC,eAAwB,EAAE,EAAE;IACvD,gBAAgB,GAAG,eAAe,CAAC;AACpC,CAAC,CAAC;AAEF,OAAO,EACN,kBAAkB,EAClB,kBAAkB,GAClB,CAAC","sourcesContent":["import { getIgnoreUrlParams as getConfiguredIgnoreUrlParams } from \"../InitialConfiguration.js\";\n\nlet _ignoreUrlParams: boolean;\n\n/**\n * Returns if the \"ignoreUrlParams\" configuration is set.\n * @public\n * @since 2.23.0\n * @returns { boolean }\n */\nconst getIgnoreUrlParams = (): boolean => {\n\tif (_ignoreUrlParams === undefined) {\n\t\t_ignoreUrlParams = getConfiguredIgnoreUrlParams();\n\t}\n\n\treturn _ignoreUrlParams;\n};\n\n/**\n * Defines the \"ignoreUrlParams\" setting.\n *\n * - When set to \"true\", the framework will not process URL parameters\n * (e.g. sap-ui-theme, sap-ui-language) during initialization.\n * - When set to \"false\" (default), URL parameters are processed normally.\n *\n * @public\n * @since 2.23.0\n * @param { boolean } ignoreUrlParams\n */\nconst setIgnoreUrlParams = (ignoreUrlParams: boolean) => {\n\t_ignoreUrlParams = ignoreUrlParams;\n};\n\nexport {\n\tgetIgnoreUrlParams,\n\tsetIgnoreUrlParams,\n};\n"]}

package/dist/connectToComponent.d.ts

@@ -0,0 +1,9 @@
+import type UI5Element from "./UI5Element.js";
+type ConnectOptions = {
+    host: UI5Element;
+    propName: string;
+    onConnect?: (friend: HTMLElement) => void;
+    onDisconnect?: (friend: HTMLElement) => void;
+};
+declare const connectToComponent: (options: ConnectOptions) => HTMLElement | undefined;
+export default connectToComponent;

package/dist/connectToComponent.js

@@ -0,0 +1,59 @@
+import { renderDeferred } from "./Render.js";
+const MISSING_ELEMENT_POLL_TIMEOUT = 500; // how often to poll for not-yet-in-DOM friend elements
+const connections = new Map();
+const intervals = new Map();
+const connectToComponent = (options) => {
+    const host = options.host;
+    const propName = options.propName;
+    const friend = host[propName];
+    let connectedTo;
+    if (friend === undefined || friend === "") {
+        connectedTo = undefined; // do not return early even if a "menu" property is not set - it may have been set before and cleanup must run
+    }
+    else if (friend instanceof HTMLElement) {
+        connectedTo = friend;
+    }
+    else {
+        const rootNode = host.getRootNode();
+        connectedTo = (rootNode.getElementById && rootNode.getElementById(friend)) || undefined;
+    }
+    const key = `${host._id}-${propName}`;
+    const prevConnectedTo = connections.get(key);
+    // Not connected - return undefined
+    if (!connectedTo) {
+        if (prevConnectedTo) { // but first disconnect, if needed
+            options.onDisconnect && options.onDisconnect(prevConnectedTo);
+            connections.delete(key);
+        }
+        // if friend element not in DOM yet, start polling
+        if (typeof friend === "string" && friend && !intervals.has(key)) {
+            const interval = setInterval(() => {
+                const rootNode = host.getRootNode();
+                const found = (rootNode.getElementById && rootNode.getElementById(friend));
+                if (found) {
+                    clearInterval(intervals.get(key));
+                    intervals.delete(key);
+                    renderDeferred(host);
+                }
+            }, MISSING_ELEMENT_POLL_TIMEOUT);
+            intervals.set(key, interval);
+        }
+        return;
+    }
+    // If connected, but still polling, stop polling
+    if (intervals.has(key)) {
+        clearInterval(intervals.get(key));
+        intervals.delete(key);
+    }
+    // Connected - either for the first time, or to something else
+    if (prevConnectedTo !== connectedTo) {
+        if (prevConnectedTo) {
+            options.onDisconnect && options.onDisconnect(prevConnectedTo);
+        }
+        options.onConnect && options.onConnect(connectedTo);
+        connections.set(key, connectedTo);
+    }
+    return connections.get(key);
+};
+export default connectToComponent;
+//# sourceMappingURL=connectToComponent.js.map

package/dist/connectToComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectToComponent.js","sourceRoot":"","sources":["../src/connectToComponent.ts"],"names":[],"mappings":"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","sourcesContent":["import type UI5Element from \"./UI5Element.js\";\nimport { renderDeferred } from \"./Render.js\";\nimport type { Interval } from \"./types.js\";\n\nconst MISSING_ELEMENT_POLL_TIMEOUT = 500; // how often to poll for not-yet-in-DOM friend elements\nconst connections = new Map<string, HTMLElement>();\nconst intervals = new Map<string, Interval>();\n\ntype ConnectOptions = {\n\thost: UI5Element;\n\tpropName: string;\n\tonConnect?: (friend: HTMLElement) => void;\n\tonDisconnect?: (friend: HTMLElement) => void;\n}\n\nconst connectToComponent = (options: ConnectOptions): HTMLElement | undefined => {\n\tconst host = options.host;\n\tconst propName = options.propName;\n\tconst friend = host[propName as keyof typeof host] as HTMLElement | string | undefined;\n\n\tlet connectedTo: HTMLElement | undefined;\n\tif (friend === undefined || friend === \"\") {\n\t\tconnectedTo = undefined; // do not return early even if a \"menu\" property is not set - it may have been set before and cleanup must run\n\t} else if (friend instanceof HTMLElement) {\n\t\tconnectedTo = friend;\n\t} else {\n\t\tconst rootNode = host.getRootNode() as Document;\n\t\tconnectedTo = (rootNode.getElementById && rootNode.getElementById(friend)) || undefined;\n\t}\n\n\tconst key = `${host._id}-${propName}`;\n\tconst prevConnectedTo = connections.get(key);\n\n\t// Not connected - return undefined\n\tif (!connectedTo) {\n\t\tif (prevConnectedTo) { // but first disconnect, if needed\n\t\t\toptions.onDisconnect && options.onDisconnect(prevConnectedTo);\n\t\t\tconnections.delete(key);\n\t\t}\n\n\t\t// if friend element not in DOM yet, start polling\n\t\tif (typeof friend === \"string\" && friend && !intervals.has(key)) {\n\t\t\tconst interval = setInterval(() => {\n\t\t\t\tconst rootNode = host.getRootNode() as Document;\n\t\t\t\tconst found = (rootNode.getElementById && rootNode.getElementById(friend));\n\n\t\t\t\tif (found) {\n\t\t\t\t\tclearInterval(intervals.get(key));\n\t\t\t\t\tintervals.delete(key);\n\t\t\t\t\trenderDeferred(host);\n\t\t\t\t}\n\t\t\t}, MISSING_ELEMENT_POLL_TIMEOUT);\n\t\t\tintervals.set(key, interval);\n\t\t}\n\n\t\treturn;\n\t}\n\n\t// If connected, but still polling, stop polling\n\tif (intervals.has(key)) {\n\t\tclearInterval(intervals.get(key));\n\t\tintervals.delete(key);\n\t}\n\n\t// Connected - either for the first time, or to something else\n\tif (prevConnectedTo !== connectedTo) {\n\t\tif (prevConnectedTo) {\n\t\t\toptions.onDisconnect && options.onDisconnect(prevConnectedTo);\n\t\t}\n\t\toptions.onConnect && options.onConnect(connectedTo);\n\t\tconnections.set(key, connectedTo);\n\t}\n\n\treturn connections.get(key);\n};\n\nexport default connectToComponent;\n"]}

package/dist/converters/DOMReference.d.ts

@@ -0,0 +1,5 @@
+declare const DOMReferenceConverter: {
+    toAttribute(propertyValue: string | HTMLElement): string | null;
+    fromAttribute(value: string | null): string | null;
+};
+export default DOMReferenceConverter;

package/dist/converters/DOMReference.js

@@ -0,0 +1,13 @@
+const DOMReferenceConverter = {
+    toAttribute(propertyValue) {
+        if (propertyValue instanceof HTMLElement) {
+            return null;
+        }
+        return propertyValue;
+    },
+    fromAttribute(value) {
+        return value;
+    },
+};
+export default DOMReferenceConverter;
+//# sourceMappingURL=DOMReference.js.map

package/dist/converters/DOMReference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DOMReference.js","sourceRoot":"","sources":["../../src/converters/DOMReference.ts"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,GAAG;IAC7B,WAAW,CAAC,aAAmC;QAC9C,IAAI,aAAa,YAAY,WAAW,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC;QACb,CAAC;QAED,OAAO,aAAa,CAAC;IACtB,CAAC;IACD,aAAa,CAAC,KAAoB;QACjC,OAAO,KAAK,CAAC;IACd,CAAC;CACD,CAAC;AAEF,eAAe,qBAAqB,CAAC","sourcesContent":["const DOMReferenceConverter = {\n\ttoAttribute(propertyValue: string | HTMLElement) {\n\t\tif (propertyValue instanceof HTMLElement) {\n\t\t\treturn null;\n\t\t}\n\n\t\treturn propertyValue;\n\t},\n\tfromAttribute(value: string | null) {\n\t\treturn value;\n\t},\n};\n\nexport default DOMReferenceConverter;\n"]}

package/dist/createReactComponent.d.ts

@@ -0,0 +1,26 @@
+/**
+ * React wrapper factory for UI5 Web Components.
+ *
+ * This lightweight factory creates typed React components that wrap UI5 Web Components.
+ * It handles:
+ * - Event prop conversion (onXxx → ui5-xxx event listeners)
+ * - Ref forwarding
+ * - Children handling
+ *
+ * Note: Supports React >=19.
+ *
+ * Note: This is for documentation samples only - for production React apps,
+ * use the official @ui5/webcomponents-react library.
+ */
+import type UI5Element from "@ui5/webcomponents-base/dist/UI5Element.js";
+/**
+ * Creates a React component wrapper for a UI5 Web Component.
+ *
+ * @param ComponentClass - The UI5 Web Component class (e.g., Button from "@ui5/webcomponents/dist/Button.js")
+ * @returns A React component that renders the custom element with proper TypeScript types
+ * @since 2.21.0
+ * @example
+ * import Button from "@ui5/webcomponents/dist/Button.js";
+ * const ReactButton = createReactComponent(Button);
+ */
+export default function createReactComponent<T extends typeof UI5Element>(klass: T): (props: InstanceType<T>["_jsxProps"]) => import("react").DOMElement<Record<string, unknown>, Element>;

package/dist/createReactComponent.js

@@ -0,0 +1,51 @@
+/**
+ * React wrapper factory for UI5 Web Components.
+ *
+ * This lightweight factory creates typed React components that wrap UI5 Web Components.
+ * It handles:
+ * - Event prop conversion (onXxx → ui5-xxx event listeners)
+ * - Ref forwarding
+ * - Children handling
+ *
+ * Note: Supports React >=19.
+ *
+ * Note: This is for documentation samples only - for production React apps,
+ * use the official @ui5/webcomponents-react library.
+ */
+import { createElement } from "react";
+/**
+ * Creates a React component wrapper for a UI5 Web Component.
+ *
+ * @param ComponentClass - The UI5 Web Component class (e.g., Button from "@ui5/webcomponents/dist/Button.js")
+ * @returns A React component that renders the custom element with proper TypeScript types
+ * @since 2.21.0
+ * @example
+ * import Button from "@ui5/webcomponents/dist/Button.js";
+ * const ReactButton = createReactComponent(Button);
+ */
+export default function createReactComponent(klass) {
+    const tag = klass.getMetadata().getTag();
+    return function Component(props) {
+        const patchedProps = {};
+        Object.entries(props).forEach(([key, value]) => {
+            if (key.startsWith("on") && typeof value === "function") {
+                // React 19 wraps DOM events (change, click, input, etc.) in SyntheticEvent,
+                // hiding CustomEvent.detail under nativeEvent.detail.
+                // Patch all event handlers to restore detail from nativeEvent.
+                const originalHandler = value;
+                patchedProps[key] = (e) => {
+                    const nativeDetail = e.nativeEvent?.detail;
+                    if (nativeDetail !== undefined) {
+                        e.detail = nativeDetail;
+                    }
+                    originalHandler(e);
+                };
+            }
+            else {
+                patchedProps[key] = value;
+            }
+        });
+        return createElement(tag, patchedProps);
+    };
+}
+//# sourceMappingURL=createReactComponent.js.map

package/dist/createReactComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createReactComponent.js","sourceRoot":"","sources":["../src/createReactComponent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAA8B,KAAQ;IACjF,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,CAAC;IAEzC,OAAO,SAAS,SAAS,CAAC,KAAmC;QAC5D,MAAM,YAAY,GAA4B,EAAE,CAAC;QAEjD,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACzE,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBACzD,4EAA4E;gBAC5E,sDAAsD;gBACtD,+DAA+D;gBAC/D,MAAM,eAAe,GAAG,KAAK,CAAC;gBAC9B,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAQ,EAAE,EAAE;oBAChC,MAAM,YAAY,GAAI,CAAsD,CAAC,WAAW,EAAE,MAAM,CAAC;oBACjG,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;wBAC/B,CAAoC,CAAC,MAAM,GAAG,YAAY,CAAC;oBAC7D,CAAC;oBACD,eAAe,CAAC,CAAC,CAAC,CAAC;gBACpB,CAAC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACP,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC3B,CAAC;QACF,CAAC,CAAC,CAAC;QAEH,OAAO,aAAa,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACzC,CAAC,CAAC;AACH,CAAC","sourcesContent":["/**\n * React wrapper factory for UI5 Web Components.\n *\n * This lightweight factory creates typed React components that wrap UI5 Web Components.\n * It handles:\n * - Event prop conversion (onXxx → ui5-xxx event listeners)\n * - Ref forwarding\n * - Children handling\n *\n * Note: Supports React >=19.\n *\n * Note: This is for documentation samples only - for production React apps,\n * use the official @ui5/webcomponents-react library.\n */\n\nimport { createElement } from \"react\";\nimport type UI5Element from \"@ui5/webcomponents-base/dist/UI5Element.js\";\n\n/**\n * Creates a React component wrapper for a UI5 Web Component.\n *\n * @param ComponentClass - The UI5 Web Component class (e.g., Button from \"@ui5/webcomponents/dist/Button.js\")\n * @returns A React component that renders the custom element with proper TypeScript types\n * @since 2.21.0\n * @example\n * import Button from \"@ui5/webcomponents/dist/Button.js\";\n * const ReactButton = createReactComponent(Button);\n */\nexport default function createReactComponent<T extends typeof UI5Element>(klass: T) {\n\tconst tag = klass.getMetadata().getTag();\n\n\treturn function Component(props: InstanceType<T>[\"_jsxProps\"]) {\n\t\tconst patchedProps: Record<string, unknown> = {};\n\n\t\tObject.entries(props as Record<string, unknown>).forEach(([key, value]) => {\n\t\t\tif (key.startsWith(\"on\") && typeof value === \"function\") {\n\t\t\t\t// React 19 wraps DOM events (change, click, input, etc.) in SyntheticEvent,\n\t\t\t\t// hiding CustomEvent.detail under nativeEvent.detail.\n\t\t\t\t// Patch all event handlers to restore detail from nativeEvent.\n\t\t\t\tconst originalHandler = value;\n\t\t\t\tpatchedProps[key] = (e: Event) => {\n\t\t\t\t\tconst nativeDetail = (e as unknown as { nativeEvent?: { detail: unknown } }).nativeEvent?.detail;\n\t\t\t\t\tif (nativeDetail !== undefined) {\n\t\t\t\t\t\t(e as unknown as { detail: unknown }).detail = nativeDetail;\n\t\t\t\t\t}\n\t\t\t\t\toriginalHandler(e);\n\t\t\t\t};\n\t\t\t} else {\n\t\t\t\tpatchedProps[key] = value;\n\t\t\t}\n\t\t});\n\n\t\treturn createElement(tag, patchedProps);\n\t};\n}\n"]}