@openedx/frontend-base 1.0.0-alpha.6 → 1.0.0-alpha.8

package/runtime/react/hooks/useSiteConfig.test.tsx

@@ -0,0 +1,13 @@
+import { renderHook } from '@testing-library/react';
+import siteConfig from 'site.config';
+import { EnvironmentTypes } from '../../../types';
+import useSiteConfig from './useSiteConfig';
+
+describe('useSiteConfig', () => {
+  it('returns the site config', () => {
+    const { result } = renderHook(() => useSiteConfig());
+    expect(result.current).toHaveProperty('apps', siteConfig.apps);
+    expect(result.current).toHaveProperty('environment', EnvironmentTypes.TEST);
+    expect(result.current).toHaveProperty('baseUrl', 'http://localhost:8080');
+  });
+});

package/runtime/react/hooks/useSiteConfig.ts

@@ -0,0 +1,9 @@
+import { useContext } from 'react';
+import SiteContext from '../SiteContext';
+
+const useSiteConfig = () => {
+  const { siteConfig } = useContext(SiteContext);
+  return siteConfig;
+};
+
+export default useSiteConfig;

package/runtime/react/hooks/useSiteEvent.ts

@@ -0,0 +1,24 @@
+import { useEffect } from 'react';
+import { subscribe, unsubscribe } from '../../subscriptions';
+
+/**
+ * A React hook that allows functional components to subscribe to application events.  This should
+ * be used sparingly - for the most part, Context should be used higher-up in the application to
+ * provide necessary data to a given component, rather than utilizing a non-React-like Pub/Sub
+ * mechanism.
+ *
+ * @memberof module:React
+ * @param {string} type
+ * @param {function} callback
+ */
+const useSiteEvent = (type, callback) => {
+  useEffect(() => {
+    subscribe(type, callback);
+
+    return () => {
+      unsubscribe(type, callback);
+    };
+  }, [callback, type]);
+};
+
+export default useSiteEvent;

package/runtime/react/reducers.ts

@@ -0,0 +1,40 @@
+import {
+  SET_THEME_VARIANT,
+  SET_IS_THEME_LOADED,
+} from './constants';
+
+export function themeReducer(state, action) {
+  switch (action.type) {
+    case SET_THEME_VARIANT: {
+      const requestedThemeVariant = action.payload;
+      return {
+        ...state,
+        themeVariant: requestedThemeVariant,
+      };
+    }
+    case SET_IS_THEME_LOADED: {
+      const requestedIsThemeLoaded = action.payload;
+      return {
+        ...state,
+        isThemeLoaded: requestedIsThemeLoaded,
+      };
+    }
+    default:
+      return state;
+  }
+}
+
+const setThemeVariant = (payload) => ({
+  type: SET_THEME_VARIANT,
+  payload,
+});
+
+const setThemeLoaded = (payload) => ({
+  type: SET_IS_THEME_LOADED,
+  payload,
+});
+
+export const themeActions = {
+  setThemeVariant,
+  setThemeLoaded,
+};

package/runtime/setupTest.js

@@ -12,38 +12,3 @@ jest.mock('universal-cookie', () => {
 });
 
 mergeSiteConfig(siteConfig);
-
-global.PARAGON_THEME = {
-  paragon: {
-    version: '1.0.0',
-    themeUrls: {
-      core: {
-        fileName: 'core.min.css',
-      },
-      defaults: {
-        light: 'light',
-      },
-      variants: {
-        light: {
-          fileName: 'light.min.css',
-        },
-      },
-    },
-  },
-  brand: {
-    version: '1.0.0',
-    themeUrls: {
-      core: {
-        fileName: 'core.min.css',
-      },
-      defaults: {
-        light: 'light',
-      },
-      variants: {
-        light: {
-          fileName: 'light.min.css',
-        },
-      },
-    },
-  },
-};

package/runtime/testing/initializeMockApp.ts

@@ -1,5 +1,7 @@
 import siteConfig from 'site.config';
 
+import { LocalizedMessages, User } from '../../types';
+
 import { configureAnalytics, MockAnalyticsService } from '../analytics';
 import { configureAuth, MockAuthService, setAuthenticatedUser } from '../auth';
 import { getSiteConfig, mergeSiteConfig } from '../config';
@@ -47,6 +49,9 @@ import mockMessages from './mockMessages';
 export default function initializeMockApp({
   messages = mockMessages,
   authenticatedUser = null,
+}: {
+  messages?: LocalizedMessages,
+  authenticatedUser?: User | null,
 } = {}) {
   const config = siteConfig;
   mergeSiteConfig(config);

package/shell/app.scss

@@ -1,4 +1,5 @@
-@use "@openedx/paragon/scss/core/core.scss";
+@use "@openedx/paragon/dist/core.min.css";
+@use "@openedx/paragon/dist/light.min.css";
 
 .flex-basis-0 {
   flex-basis: 0 !important;

package/shell/setupTest.js

@@ -11,38 +11,3 @@ jest.mock('universal-cookie', () => {
 });
 
 mergeSiteConfig(siteConfig);
-
-global.PARAGON_THEME = {
-  paragon: {
-    version: '1.0.0',
-    themeUrls: {
-      core: {
-        fileName: 'core.min.css',
-      },
-      defaults: {
-        light: 'light',
-      },
-      variants: {
-        light: {
-          fileName: 'light.min.css',
-        },
-      },
-    },
-  },
-  brand: {
-    version: '1.0.0',
-    themeUrls: {
-      core: {
-        fileName: 'core.min.css',
-      },
-      defaults: {
-        light: 'light',
-      },
-      variants: {
-        light: {
-          fileName: 'light.min.css',
-        },
-      },
-    },
-  },
-};

package/tools/dist/eslint/base.eslint.config.js

@@ -31,7 +31,6 @@ module.exports = tseslint.config(eslint.configs.recommended, ...tseslint.configs
             ...globals.browser,
             ...globals.node,
             ...globals.jest,
-            PARAGON_THEME: 'readonly',
             newrelic: 'readonly',
         },
     },
@@ -79,6 +78,7 @@ module.exports = tseslint.config(eslint.configs.recommended, ...tseslint.configs
                 caughtErrors: 'none',
             }],
         '@typescript-eslint/no-empty-function': 'off',
+        '@typescript-eslint/prefer-nullish-coalescing': 'off',
         '@stylistic/semi': ['error', 'always', { omitLastInOneLineBlock: true, omitLastInOneLineClassBody: true }],
         '@stylistic/quotes': ['error', 'single', {
                 avoidEscape: true,

package/tools/dist/webpack/common-config/all/getStylesheetRule.js

@@ -87,7 +87,7 @@ function getStyleUseConfig(mode) {
                     ],
                     // Silences compiler deprecation warnings.  They mostly come from bootstrap and/or paragon.
                     quietDeps: true,
-                    silenceDeprecations: ['abs-percent', 'color-functions', 'import', 'mixed-decls', 'global-builtin', 'legacy-js-api'],
+                    silenceDeprecations: ['abs-percent', 'color-functions', 'import', 'global-builtin', 'legacy-js-api'],
                 },
             },
         },

package/tools/dist/webpack/webpack.config.build.js

@@ -9,13 +9,9 @@ const path_1 = __importDefault(require("path"));
 const webpack_bundle_analyzer_1 = require("webpack-bundle-analyzer");
 const webpack_remove_empty_scripts_1 = __importDefault(require("webpack-remove-empty-scripts"));
 const common_config_1 = require("./common-config");
-const ParagonWebpackPlugin_1 = __importDefault(require("./plugins/paragon-webpack-plugin/ParagonWebpackPlugin"));
 const getLocalAliases_1 = __importDefault(require("./utils/getLocalAliases"));
 const getPublicPath_1 = __importDefault(require("./utils/getPublicPath"));
 const getResolvedSiteConfigPath_1 = __importDefault(require("./utils/getResolvedSiteConfigPath"));
-const paragonUtils_1 = require("./utils/paragonUtils");
-const paragonThemeCss = (0, paragonUtils_1.getParagonThemeCss)(process.cwd());
-const brandThemeCss = (0, paragonUtils_1.getParagonThemeCss)(process.cwd(), { isBrandOverride: true });
 const aliases = (0, getLocalAliases_1.default)();
 const resolvedSiteConfigPath = (0, getResolvedSiteConfigPath_1.default)('site.config.build.tsx');
 const config = {
@@ -23,8 +19,6 @@ const config = {
     devtool: 'source-map',
     entry: {
         app: path_1.default.resolve(process.cwd(), 'node_modules/@openedx/frontend-base/shell/site'),
-        ...(0, paragonUtils_1.getParagonEntryPoints)(paragonThemeCss),
-        ...(0, paragonUtils_1.getParagonEntryPoints)(brandThemeCss),
     },
     output: {
         filename: '[name].[chunkhash].js',
@@ -51,10 +45,6 @@ const config = {
         runtimeChunk: 'single',
         splitChunks: {
             chunks: 'all',
-            cacheGroups: {
-                ...(0, paragonUtils_1.getParagonCacheGroups)(paragonThemeCss),
-                ...(0, paragonUtils_1.getParagonCacheGroups)(brandThemeCss),
-            },
         },
         minimizer: (0, common_config_1.getImageMinimizer)(),
     },
@@ -65,7 +55,6 @@ const config = {
         // See: https://www.npmjs.com/package/webpack-remove-empty-scripts#usage-with-mini-css-extract-plugin
         new webpack_remove_empty_scripts_1.default(),
         // Writes the extracted CSS from each entry to a file in the output directory.
-        new ParagonWebpackPlugin_1.default(),
         new mini_css_extract_plugin_1.default({
             filename: '[name].[chunkhash].css',
         }),

package/tools/dist/webpack/webpack.config.dev.js

@@ -9,20 +9,14 @@ const mini_css_extract_plugin_1 = __importDefault(require("mini-css-extract-plug
 const path_1 = __importDefault(require("path"));
 const webpack_remove_empty_scripts_1 = __importDefault(require("webpack-remove-empty-scripts"));
 const common_config_1 = require("./common-config");
-const ParagonWebpackPlugin_1 = __importDefault(require("./plugins/paragon-webpack-plugin/ParagonWebpackPlugin"));
 const getLocalAliases_1 = __importDefault(require("./utils/getLocalAliases"));
 const getPublicPath_1 = __importDefault(require("./utils/getPublicPath"));
 const getResolvedSiteConfigPath_1 = __importDefault(require("./utils/getResolvedSiteConfigPath"));
-const paragonUtils_1 = require("./utils/paragonUtils");
-const paragonThemeCss = (0, paragonUtils_1.getParagonThemeCss)(process.cwd());
-const brandThemeCss = (0, paragonUtils_1.getParagonThemeCss)(process.cwd(), { isBrandOverride: true });
 const aliases = (0, getLocalAliases_1.default)();
 const resolvedSiteConfigPath = (0, getResolvedSiteConfigPath_1.default)('site.config.dev.tsx');
 const config = {
     entry: {
         app: path_1.default.resolve(process.cwd(), 'node_modules/@openedx/frontend-base/shell/site'),
-        ...(0, paragonUtils_1.getParagonEntryPoints)(paragonThemeCss),
-        ...(0, paragonUtils_1.getParagonEntryPoints)(brandThemeCss),
     },
     output: {
         path: path_1.default.resolve(process.cwd(), './dist'),
@@ -47,10 +41,6 @@ const config = {
     optimization: {
         splitChunks: {
             chunks: 'all',
-            cacheGroups: {
-                ...(0, paragonUtils_1.getParagonCacheGroups)(paragonThemeCss),
-                ...(0, paragonUtils_1.getParagonCacheGroups)(brandThemeCss),
-            },
         },
         minimizer: (0, common_config_1.getImageMinimizer)(),
     },
@@ -60,7 +50,6 @@ const config = {
         // This helps to clean up the final bundle application
         // See: https://www.npmjs.com/package/webpack-remove-empty-scripts#usage-with-mini-css-extract-plugin
         new webpack_remove_empty_scripts_1.default(),
-        new ParagonWebpackPlugin_1.default(),
         // Writes the extracted CSS from each entry to a file in the output directory.
         new mini_css_extract_plugin_1.default({
             filename: '[name].css',

package/tools/dist/webpack/webpack.config.dev.shell.js

@@ -11,21 +11,15 @@ const path_1 = __importDefault(require("path"));
 const react_refresh_typescript_1 = __importDefault(require("react-refresh-typescript"));
 const webpack_remove_empty_scripts_1 = __importDefault(require("webpack-remove-empty-scripts"));
 const common_config_1 = require("./common-config");
-const ParagonWebpackPlugin_1 = __importDefault(require("./plugins/paragon-webpack-plugin/ParagonWebpackPlugin"));
 const html_webpack_plugin_1 = __importDefault(require("html-webpack-plugin"));
 const getLocalAliases_1 = __importDefault(require("./utils/getLocalAliases"));
 const getPublicPath_1 = __importDefault(require("./utils/getPublicPath"));
 const getResolvedSiteConfigPath_1 = __importDefault(require("./utils/getResolvedSiteConfigPath"));
-const paragonUtils_1 = require("./utils/paragonUtils");
-const paragonThemeCss = (0, paragonUtils_1.getParagonThemeCss)(process.cwd());
-const brandThemeCss = (0, paragonUtils_1.getParagonThemeCss)(process.cwd(), { isBrandOverride: true });
 const aliases = (0, getLocalAliases_1.default)();
 const resolvedSiteConfigPath = (0, getResolvedSiteConfigPath_1.default)('shell/site.config.dev.tsx');
 const config = {
     entry: {
         app: path_1.default.resolve(process.cwd(), 'shell/site'),
-        ...(0, paragonUtils_1.getParagonEntryPoints)(paragonThemeCss),
-        ...(0, paragonUtils_1.getParagonEntryPoints)(brandThemeCss),
     },
     output: {
         path: path_1.default.resolve(process.cwd(), './dist'),
@@ -77,10 +71,6 @@ const config = {
     optimization: {
         splitChunks: {
             chunks: 'all',
-            cacheGroups: {
-                ...(0, paragonUtils_1.getParagonCacheGroups)(paragonThemeCss),
-                ...(0, paragonUtils_1.getParagonCacheGroups)(brandThemeCss),
-            },
         },
         minimizer: (0, common_config_1.getImageMinimizer)(),
     },
@@ -90,7 +80,6 @@ const config = {
         // This helps to clean up the final bundle application
         // See: https://www.npmjs.com/package/webpack-remove-empty-scripts#usage-with-mini-css-extract-plugin
         new webpack_remove_empty_scripts_1.default(),
-        new ParagonWebpackPlugin_1.default(),
         // Writes the extracted CSS from each entry to a file in the output directory.
         new mini_css_extract_plugin_1.default({
             filename: '[name].css',

package/types.ts

@@ -60,6 +60,9 @@ export interface OptionalSiteConfig {
   externalLinkUrlOverrides: string[],
   mfeConfigApiUrl: string | null,
 
+  // Theme
+  theme: Theme,
+
   // Cookies
   accessTokenCookieName: string,
   languagePreferenceCookieName: string,
@@ -78,6 +81,23 @@ export interface OptionalSiteConfig {
 
 export type SiteConfig = RequiredSiteConfig & Partial<OptionalSiteConfig>;
 
+export interface ThemeVariant {
+  url: string,
+}
+
+export interface ThemeDefaults {
+  light?: string,
+  dark?: string,
+}
+
+export type ThemeVariants = Record<string, ThemeVariant>;
+
+export interface Theme {
+  core?: ThemeVariant,
+  defaults?: ThemeDefaults,
+  variants?: ThemeVariants,
+}
+
 export interface User {
   administrator: boolean,
   email: string,

package/config/webpack/plugins/paragon-webpack-plugin/ParagonWebpackPlugin.js

@@ -1,108 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const webpack_1 = require("webpack");
-const paragonUtils_1 = require("../../utils/paragonUtils");
-const utils_1 = require("./utils");
-// Get Paragon and brand versions / CSS files from disk.
-const paragonVersion = (0, paragonUtils_1.getParagonVersion)(process.cwd());
-const paragonThemeCss = (0, paragonUtils_1.getParagonThemeCss)(process.cwd());
-const brandVersion = (0, paragonUtils_1.getParagonVersion)(process.cwd(), { isBrandOverride: true });
-const brandThemeCss = (0, paragonUtils_1.getParagonThemeCss)(process.cwd(), { isBrandOverride: true });
-/**
- * 1. Injects `PARAGON_THEME` global variable into the HTML document during the Webpack compilation process.
- * 2. Injects `<link rel="preload" as="style">` element(s) for the Paragon and brand CSS into the HTML document.
- */
-class ParagonWebpackPlugin {
-    pluginName;
-    paragonThemeUrlsConfig;
-    processAssetsHandlers;
-    paragonMetadata;
-    constructor({ processAssetsHandlers = [] } = {}) {
-        this.pluginName = 'ParagonWebpackPlugin';
-        this.paragonThemeUrlsConfig = {};
-        this.paragonMetadata = {};
-        // List of handlers to be executed after processing assets during the Webpack compilation.
-        this.processAssetsHandlers = [
-            this.resolveParagonThemeUrlsFromConfig,
-            this.injectParagonMetadataIntoDocument,
-            this.injectParagonStylesheetsIntoDocument,
-            ...processAssetsHandlers,
-        ].map(handler => handler.bind(this));
-    }
-    /**
-     * Resolves the MFE configuration from ``PARAGON_THEME_URLS`` in the environment variables. `
-     *
-     * @returns {Object} Metadata about the Paragon and brand theme URLs from configuration.
-     */
-    async resolveParagonThemeUrlsFromConfig() {
-        try {
-            this.paragonThemeUrlsConfig = JSON.parse(process.env.PARAGON_THEME_URLS ?? '{}');
-        }
-        catch (error) {
-            console.info('Paragon Plugin cannot load PARAGON_THEME_URLS env variable, skipping.');
-        }
-    }
-    /**
-     * Generates `PARAGON_THEME` global variable in HTML document.
-     * @param {Object} compilation Webpack compilation object.
-     */
-    injectParagonMetadataIntoDocument(compilation) {
-        const paragonMetadata = (0, utils_1.injectMetadataIntoDocument)(compilation, {
-            paragonThemeCss,
-            paragonVersion,
-            brandThemeCss,
-            brandVersion,
-        });
-        if (paragonMetadata) {
-            this.paragonMetadata = paragonMetadata;
-        }
-    }
-    injectParagonStylesheetsIntoDocument(compilation) {
-        const file = compilation.getAsset('index.html');
-        // If the `index.html` hasn't loaded yet, or there are no Paragon theme URLs, then there is nothing to do yet.
-        if (!file || Object.keys(this.paragonThemeUrlsConfig || {}).length === 0) {
-            return;
-        }
-        // Generates `<link rel="preload" as="style">` element(s) for the Paragon and brand CSS files.
-        const paragonStylesheetUrls = (0, utils_1.getParagonStylesheetUrls)({
-            paragonThemeUrls: this.paragonThemeUrlsConfig,
-            paragonVersion,
-            brandVersion,
-        });
-        const { core: paragonCoreCss, variants: paragonThemeVariantCss, } = paragonStylesheetUrls;
-        // We do not expect to have a Buffer here, ever.
-        const originalSource = file.source.source();
-        // Inject core CSS
-        let newSource = (0, utils_1.injectParagonCoreStylesheets)({
-            source: originalSource,
-            paragonCoreCss,
-            paragonThemeCss,
-            brandThemeCss,
-        });
-        // Inject theme variant CSS
-        newSource = (0, utils_1.injectParagonThemeVariantStylesheets)({
-            // @ts-expect-error newSource is possibly undefined here.
-            source: newSource.source(),
-            paragonThemeVariantCss,
-            paragonThemeCss,
-            brandThemeCss,
-        });
-        // @ts-expect-error newSource is possibly undefined here.
-        compilation.updateAsset('index.html', new webpack_1.sources.RawSource(newSource.source()));
-    }
-    apply(compiler) {
-        compiler.hooks.thisCompilation.tap(this.pluginName, (compilation) => {
-            compilation.hooks.processAssets.tap({
-                name: this.pluginName,
-                stage: webpack_1.Compilation.PROCESS_ASSETS_STAGE_ADDITIONS,
-                additionalAssets: true,
-            }, () => {
-                // Iterate through each configured handler, passing the compilation to each.
-                this.processAssetsHandlers.forEach(async (handler) => {
-                    await handler(compilation);
-                });
-            });
-        });
-    }
-}
-exports.default = ParagonWebpackPlugin;

package/config/webpack/plugins/paragon-webpack-plugin/index.js

@@ -1,7 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const ParagonWebpackPlugin_1 = __importDefault(require("./ParagonWebpackPlugin"));
-exports.default = ParagonWebpackPlugin_1.default;

package/config/webpack/plugins/paragon-webpack-plugin/utils/assetUtils.js

@@ -1,64 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.findCoreCssAsset = findCoreCssAsset;
-exports.findThemeVariantCssAssets = findThemeVariantCssAssets;
-exports.getCssAssetsFromCompilation = getCssAssetsFromCompilation;
-/**
- * Finds the core CSS asset from the given array of Paragon assets.
- *
- * @param {Array} paragonAssets - An array of Paragon assets.
- * @return {Object|undefined} The core CSS asset, or undefined if not found.
- */
-function findCoreCssAsset(paragonAssets) {
-    return paragonAssets?.find((asset) => asset.name.includes('core') && asset.name.endsWith('.css'));
-}
-/**
- * Finds the theme variant CSS assets from the given Paragon assets based on the provided options.
- *
- * @param {Array} paragonAssets - An array of Paragon assets.
- * @param {Object} options - The options for finding the theme variant CSS assets.
- * @param {boolean} [options.isBrandOverride=false] - Indicates if the theme variant is a brand override.
- * @param {Object} [options.brandThemeCss] - The brand theme CSS object.
- * @param {Object} [options.paragonThemeCss] - The Paragon theme CSS object.
- * @return {Object} - The theme variant CSS assets.
- */
-function findThemeVariantCssAssets(paragonAssets, { isBrandOverride = false, brandThemeCss, paragonThemeCss, }) {
-    const themeVariantsSource = isBrandOverride ? brandThemeCss?.variants : paragonThemeCss?.variants;
-    const themeVariantCssAssets = {};
-    Object.entries(themeVariantsSource || {}).forEach(([themeVariant, value]) => {
-        const foundThemeVariantAsset = paragonAssets.find((asset) => asset.name.includes(value.outputChunkName));
-        if (!foundThemeVariantAsset) {
-            return;
-        }
-        themeVariantCssAssets[themeVariant] = {
-            fileName: foundThemeVariantAsset.name,
-        };
-    });
-    return themeVariantCssAssets;
-}
-/**
- * Retrieves the CSS assets from the compilation based on the provided options.
- *
- * @param {Object} compilation - The compilation object.
- * @param {Object} options - The options for retrieving the CSS assets.
- * @param {boolean} [options.isBrandOverride=false] - Indicates if the assets are for a brand override.
- * @param {Object} [options.brandThemeCss] - The brand theme CSS object.
- * @param {Object} [options.paragonThemeCss] - The Paragon theme CSS object.
- * @return {Object} - The CSS assets, including the core CSS asset and theme variant CSS assets.
- */
-function getCssAssetsFromCompilation(compilation, { isBrandOverride = false, brandThemeCss, paragonThemeCss, }) {
-    const assetSubstring = isBrandOverride ? 'brand' : 'paragon';
-    const paragonAssets = compilation.getAssets().filter(asset => asset.name.includes(assetSubstring) && asset.name.endsWith('.css'));
-    const coreCssAsset = findCoreCssAsset(paragonAssets);
-    const themeVariantCssAssets = findThemeVariantCssAssets(paragonAssets, {
-        isBrandOverride,
-        paragonThemeCss,
-        brandThemeCss,
-    });
-    return {
-        coreCssAsset: {
-            fileName: coreCssAsset?.name,
-        },
-        themeVariantCssAssets,
-    };
-}

package/config/webpack/plugins/paragon-webpack-plugin/utils/htmlUtils.js

@@ -1,53 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.injectMetadataIntoDocument = injectMetadataIntoDocument;
-const webpack_1 = require("webpack");
-const assetUtils_1 = require("./assetUtils");
-const scriptUtils_1 = require("./scriptUtils");
-/**
- * Injects metadata into the HTML document by modifying the 'index.html' asset in the compilation.
- *
- * @param {Object} compilation - The Webpack compilation object.
- * @param {Object} options - The options object.
- * @param {Object} options.paragonThemeCss - The Paragon theme CSS object.
- * @param {string} options.paragonVersion - The version of the Paragon theme.
- * @param {Object} options.brandThemeCss - The brand theme CSS object.
- * @param {string} options.brandVersion - The version of the brand theme.
- * @return {Object|undefined} The script contents object if the 'index.html' asset exists, otherwise undefined.
- */
-function injectMetadataIntoDocument(compilation, { paragonThemeCss, paragonVersion, brandThemeCss, brandVersion, }) {
-    const file = compilation.getAsset('index.html');
-    if (!file) {
-        return undefined;
-    }
-    const { coreCssAsset: paragonCoreCssAsset, themeVariantCssAssets: paragonThemeVariantCssAssets, } = (0, assetUtils_1.getCssAssetsFromCompilation)(compilation, {
-        brandThemeCss,
-        paragonThemeCss,
-    });
-    const { coreCssAsset: brandCoreCssAsset, themeVariantCssAssets: brandThemeVariantCssAssets, } = (0, assetUtils_1.getCssAssetsFromCompilation)(compilation, {
-        isBrandOverride: true,
-        brandThemeCss,
-        paragonThemeCss,
-    });
-    const scriptContents = (0, scriptUtils_1.generateScriptContents)({
-        paragonCoreCssAsset,
-        paragonThemeVariantCssAssets,
-        brandCoreCssAsset,
-        brandThemeVariantCssAssets,
-        paragonThemeCss,
-        paragonVersion,
-        brandThemeCss,
-        brandVersion,
-    });
-    // We expect this to be a string at all times.
-    const originalSource = file.source.source();
-    const newSource = (0, scriptUtils_1.insertScriptContentsIntoDocument)({
-        originalSource,
-        // @ts-expect-error This parameter doesn't exist in the function.
-        coreCssAsset: paragonCoreCssAsset,
-        themeVariantCssAssets: paragonThemeVariantCssAssets,
-        scriptContents,
-    });
-    compilation.updateAsset('index.html', new webpack_1.sources.RawSource(newSource.source()));
-    return scriptContents;
-}

package/config/webpack/plugins/paragon-webpack-plugin/utils/index.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.injectParagonThemeVariantStylesheets = exports.injectParagonCoreStylesheets = exports.getParagonStylesheetUrls = exports.injectMetadataIntoDocument = void 0;
-var htmlUtils_1 = require("./htmlUtils");
-Object.defineProperty(exports, "injectMetadataIntoDocument", { enumerable: true, get: function () { return htmlUtils_1.injectMetadataIntoDocument; } });
-var paragonStylesheetUtils_1 = require("./paragonStylesheetUtils");
-Object.defineProperty(exports, "getParagonStylesheetUrls", { enumerable: true, get: function () { return paragonStylesheetUtils_1.getParagonStylesheetUrls; } });
-Object.defineProperty(exports, "injectParagonCoreStylesheets", { enumerable: true, get: function () { return paragonStylesheetUtils_1.injectParagonCoreStylesheets; } });
-Object.defineProperty(exports, "injectParagonThemeVariantStylesheets", { enumerable: true, get: function () { return paragonStylesheetUtils_1.injectParagonThemeVariantStylesheets; } });