feat(framework): Support custom dynamic asset paths (#2305)

packages/base/src/AssetRegistry.js

@@ -1,10 +1,12 @@
 import { registerI18nBundle } from "./asset-registries/i18n.js";
 import { registerCldr, _registerMappingFunction as registerCldrMappingFunction } from "./asset-registries/LocaleData.js";
 import { registerThemeProperties } from "./asset-registries/Themes.js";
+import { registerAssetPathMappingFunction } from "./util/EffectiveAssetPath.js";
 
 export {
 	registerCldr,
 	registerCldrMappingFunction,
 	registerThemeProperties,
 	registerI18nBundle,
+	registerAssetPathMappingFunction,
 };

packages/base/src/asset-registries/Icons.js

@@ -1,6 +1,6 @@
 import { registerIcon, registerCollectionPromise } from "../SVGIconRegistry.js";
 import { fetchJsonOnce } from "../util/FetchHelper.js";
-import getEffectiveAssetPath from "../util/getEffectiveAssetPath.js";
+import { getEffectiveAssetPath } from "../util/EffectiveAssetPath.js";
 
 const registerIconBundle = async (collectionName, bundleData) => {
 	let resolveFn;

packages/base/src/asset-registries/LocaleData.js

@@ -1,7 +1,7 @@
 import { fetchJsonOnce } from "../util/FetchHelper.js";
 import { getFeature } from "../FeaturesRegistry.js";
 import { DEFAULT_LOCALE, SUPPORTED_LOCALES } from "../generated/AssetParameters.js";
-import getEffectiveAssetPath from "../util/getEffectiveAssetPath.js";
+import { getEffectiveAssetPath } from "../util/EffectiveAssetPath.js";
 
 const resources = new Map();
 const cldrData = {};

packages/base/src/asset-registries/Themes.js

@@ -1,7 +1,7 @@
 import { fetchJsonOnce, fetchTextOnce } from "../util/FetchHelper.js";
 import { DEFAULT_THEME } from "../generated/AssetParameters.js";
 import getFileExtension from "../util/getFileExtension.js";
-import getEffectiveAssetPath from "../util/getEffectiveAssetPath.js";
+import { getEffectiveAssetPath } from "../util/EffectiveAssetPath.js";
 
 const themeURLs = new Map();
 const themeStyles = new Map();

packages/base/src/asset-registries/i18n.js

@@ -5,7 +5,7 @@ import { fetchTextOnce } from "../util/FetchHelper.js";
 import normalizeLocale from "../locale/normalizeLocale.js";
 import nextFallbackLocale from "../locale/nextFallbackLocale.js";
 import { DEFAULT_LANGUAGE } from "../generated/AssetParameters.js";
-import getEffectiveAssetPath from "../util/getEffectiveAssetPath.js";
+import { getEffectiveAssetPath } from "../util/EffectiveAssetPath.js";
 import { getUseDefaultLanguage } from "../config/Language.js";
 
 const bundleData = new Map();

packages/base/src/util/EffectiveAssetPath.js

@@ -0,0 +1,27 @@
+import { getAssetsPath } from "../config/AssetsPath.js";
+
+let assetPathMappingFn = assetName => assetName;
+
+const getEffectiveAssetPath = assetName => {
+	if (typeof assetName !== "string") {
+		return assetName;
+	}
+
+	assetName = assetPathMappingFn(assetName);
+
+	const assetsPathPrefix = getAssetsPath();
+	if (assetsPathPrefix) {
+		return `${assetsPathPrefix}${assetName}`;
+	}
+
+	return assetName;
+};
+
+const registerAssetPathMappingFunction = mappingFn => {
+	assetPathMappingFn = mappingFn;
+};
+
+export {
+	getEffectiveAssetPath,
+	registerAssetPathMappingFunction,
+};