@openedx/frontend-base 1.0.0-alpha.1 → 1.0.0-alpha.10

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'),
@@ -35,6 +29,7 @@ const config = {
         alias: {
             ...aliases,
             'site.config': resolvedSiteConfigPath,
+            '@src': path_1.default.resolve(process.cwd(), 'src'),
         },
         extensions: ['.js', '.jsx', '.ts', '.tsx'],
     },
@@ -77,10 +72,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 +81,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',
@@ -106,5 +96,9 @@ const config = {
     // This configures webpack-dev-server which serves bundles from memory and provides live
     // reloading.
     devServer: (0, common_config_1.getDevServer)(),
+    // Limit the number of watched files to avoid `inotify` resource starvation.
+    watchOptions: {
+        ignored: /node_modules/
+    }
 };
 exports.default = config;

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; } });

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

@@ -1,114 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.injectParagonCoreStylesheets = injectParagonCoreStylesheets;
-exports.injectParagonThemeVariantStylesheets = injectParagonThemeVariantStylesheets;
-exports.getParagonStylesheetUrls = getParagonStylesheetUrls;
-const stylesheetUtils_1 = require("./stylesheetUtils");
-const tagUtils_1 = require("./tagUtils");
-/**
- * Injects Paragon core stylesheets into the document.
- *
- * @param {Object} options - The options object.
- * @param {string|object} options.source - The source HTML document.
- * @param {Object} options.paragonCoreCss - The Paragon core CSS object.
- * @param {Object} options.paragonThemeCss - The Paragon theme CSS object.
- * @param {Object} options.brandThemeCss - The brand theme CSS object.
- * @return {string|object} The modified HTML document with Paragon core stylesheets injected.
- */
-function injectParagonCoreStylesheets({ source, paragonCoreCss, paragonThemeCss, brandThemeCss, }) {
-    return (0, stylesheetUtils_1.insertStylesheetsIntoDocument)({
-        source,
-        urls: paragonCoreCss.urls,
-        // @ts-expect-error These two parameters don't exist on insertStylesheetsIntoDocument
-        paragonThemeCss,
-        brandThemeCss,
-    });
-}
-/**
- * Injects Paragon theme variant stylesheets into the document.
- *
- * @param {Object} options - The options object.
- * @param {string|object} options.source - The source HTML document.
- * @param {Object} options.paragonThemeVariantCss - The Paragon theme variant CSS object.
- * @param {Object} options.paragonThemeCss - The Paragon theme CSS object.
- * @param {Object} options.brandThemeCss - The brand theme CSS object.
- * @return {string|object} The modified HTML document with Paragon theme variant stylesheets injected.
- */
-function injectParagonThemeVariantStylesheets({ source, paragonThemeVariantCss, paragonThemeCss, brandThemeCss, }) {
-    let newSource = source;
-    Object.values(paragonThemeVariantCss).forEach(({ urls }) => {
-        newSource = (0, stylesheetUtils_1.insertStylesheetsIntoDocument)({
-            source: (typeof newSource === 'object' ? newSource.source() : newSource),
-            urls,
-            // @ts-expect-error These two parameters don't exist on insertStylesheetsIntoDocument
-            paragonThemeCss,
-            brandThemeCss,
-        });
-    });
-    return newSource;
-}
-/**
- * Retrieves the URLs of the Paragon stylesheets based on the provided theme URLs, Paragon version, and brand version.
- *
- * @param {Object} options - The options object.
- * @param {Object} options.paragonThemeUrls - The URLs of the Paragon theme.
- * @param {string} options.paragonVersion - The version of the Paragon theme.
- * @param {string} options.brandVersion - The version of the brand theme.
- * @return {Object} An object containing the URLs of the Paragon stylesheets.
- */
-function getParagonStylesheetUrls({ paragonThemeUrls, paragonVersion, brandVersion }) {
-    const paragonCoreCssUrl = 'urls' in paragonThemeUrls.core && paragonThemeUrls.core.urls !== undefined ? paragonThemeUrls.core.urls.default : paragonThemeUrls.core.url;
-    const brandCoreCssUrl = 'urls' in paragonThemeUrls.core && paragonThemeUrls.core.urls !== undefined ? paragonThemeUrls.core.urls.brandOverride : undefined;
-    const defaultThemeVariants = paragonThemeUrls.defaults || {};
-    const coreCss = {
-        urls: {
-            default: (0, tagUtils_1.handleVersionSubstitution)({
-                url: paragonCoreCssUrl,
-                wildcardKeyword: '$paragonVersion',
-                localVersion: paragonVersion
-            }),
-            brandOverride: (0, tagUtils_1.handleVersionSubstitution)({
-                url: brandCoreCssUrl,
-                wildcardKeyword: '$brandVersion',
-                localVersion: brandVersion
-            }),
-        },
-    };
-    const themeVariantsCss = {};
-    const themeVariantsEntries = Object.entries(paragonThemeUrls.variants || {});
-    themeVariantsEntries.forEach(([themeVariant, { url, urls }]) => {
-        const themeVariantMetadata = { urls: {} };
-        if (url) {
-            themeVariantMetadata.urls = {
-                default: (0, tagUtils_1.handleVersionSubstitution)({
-                    url,
-                    wildcardKeyword: '$paragonVersion',
-                    localVersion: paragonVersion,
-                }),
-                // If there is no brand override URL, then we don't need to do any version substitution
-                // but we still need to return the property.
-                brandOverride: undefined,
-            };
-        }
-        else if (urls) {
-            themeVariantMetadata.urls = {
-                default: (0, tagUtils_1.handleVersionSubstitution)({
-                    url: urls.default,
-                    wildcardKeyword: '$paragonVersion',
-                    localVersion: paragonVersion,
-                }),
-                brandOverride: (0, tagUtils_1.handleVersionSubstitution)({
-                    url: urls.brandOverride,
-                    wildcardKeyword: '$brandVersion',
-                    localVersion: brandVersion,
-                }),
-            };
-        }
-        themeVariantsCss[themeVariant] = themeVariantMetadata;
-    });
-    return {
-        core: coreCss,
-        variants: themeVariantsCss,
-        defaults: defaultThemeVariants,
-    };
-}

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

@@ -1,146 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.insertScriptContentsIntoDocument = insertScriptContentsIntoDocument;
-exports.addToScriptContents = addToScriptContents;
-exports.generateScriptContents = generateScriptContents;
-const parse5 = __importStar(require("parse5"));
-const webpack_1 = require("webpack");
-const tagUtils_1 = require("./tagUtils");
-/**
- * Finds the insertion point for a script in an HTML document.
- *
- * @param {Object} options - The options object.
- * @param {Object} options.document - The parsed HTML document.
- * @param {string} options.originalSource - The original source code of the HTML document.
- * @throws {Error} If the body element is missing in the HTML document.
- * @return {number} The insertion point for the script in the HTML document.
- */
-function findScriptInsertionPoint({ document, originalSource }) {
-    const bodyElement = (0, tagUtils_1.getDescendantByTag)(document, 'body');
-    if (!bodyElement) {
-        throw new Error('Missing body element in index.html.');
-    }
-    // determine script insertion point
-    if (bodyElement.sourceCodeLocation?.endTag) {
-        return bodyElement.sourceCodeLocation.endTag.startOffset;
-    }
-    // less accurate fallback
-    return originalSource.indexOf('</body>');
-}
-/**
- * Inserts the given script contents into the HTML document and returns a new source with the modified content.
- *
- * @param {Object} options - The options object.
- * @param {string} options.originalSource - The original HTML source.
- * @param {Object} options.scriptContents - The contents of the script to be inserted.
- * @return {sources.ReplaceSource} The new source with the modified HTML content.
- */
-function insertScriptContentsIntoDocument({ originalSource, scriptContents, }) {
-    // parse file as html document
-    const document = parse5.parse(originalSource, {
-        sourceCodeLocationInfo: true,
-    });
-    // find the body element
-    const scriptInsertionPoint = findScriptInsertionPoint({
-        document,
-        originalSource,
-    });
-    // create Paragon script to inject into the HTML document
-    const paragonScript = `<script type="text/javascript">var PARAGON_THEME = ${JSON.stringify(scriptContents, null, 2)};</script>`;
-    // insert the Paragon script into the HTML document
-    const newSource = new webpack_1.sources.ReplaceSource(new webpack_1.sources.RawSource(originalSource), 'index.html');
-    newSource.insert(scriptInsertionPoint, (0, tagUtils_1.minifyScript)(paragonScript));
-    return newSource;
-}
-/**
- * Creates an object with the provided version, defaults, coreCssAsset, and themeVariantCssAssets
- * and returns it. The returned object has the following structure:
- * {
- *   version: The provided version,
- *   themeUrls: {
- *     core: The provided coreCssAsset,
- *     variants: The provided themeVariantCssAssets,
- *     defaults: The provided defaults
- *   }
- * }
- *
- * @param {Object} options - The options object.
- * @param {string} options.version - The version to be added to the returned object.
- * @param {Object} options.defaults - The defaults to be added to the returned object.
- * @param {Object} options.coreCssAsset - The coreCssAsset to be added to the returned object.
- * @param {Object} options.themeVariantCssAssets - The themeVariantCssAssets to be added to the returned object.
- * @return {Object} The object with the provided version, defaults, coreCssAsset, and themeVariantCssAssets.
- */
-function addToScriptContents({ version, defaults, coreCssAsset, themeVariantCssAssets, }) {
-    return {
-        version,
-        themeUrls: {
-            core: coreCssAsset,
-            variants: themeVariantCssAssets,
-            defaults,
-        },
-    };
-}
-/**
- * Generates the script contents object based on the provided assets and versions.
- *
- * @param {Object} options - The options object.
- * @param {Object} options.paragonCoreCssAsset - The asset for the Paragon core CSS.
- * @param {Object} options.paragonThemeVariantCssAssets - The assets for the Paragon theme variants.
- * @param {Object} options.brandCoreCssAsset - The asset for the brand core CSS.
- * @param {Object} options.brandThemeVariantCssAssets - The assets for the brand theme variants.
- * @param {Object} options.paragonThemeCss - The Paragon theme CSS.
- * @param {string} options.paragonVersion - The version of the Paragon theme.
- * @param {Object} options.brandThemeCss - The brand theme CSS.
- * @param {string} options.brandVersion - The version of the brand theme.
- * @return {Object} The script contents object.
- */
-function generateScriptContents({ paragonCoreCssAsset, paragonThemeVariantCssAssets, brandCoreCssAsset, brandThemeVariantCssAssets, paragonThemeCss, paragonVersion, brandThemeCss, brandVersion, }) {
-    const scriptContents = {};
-    scriptContents.paragon = addToScriptContents({
-        version: paragonVersion,
-        coreCssAsset: paragonCoreCssAsset,
-        themeVariantCssAssets: paragonThemeVariantCssAssets,
-        defaults: paragonThemeCss?.defaults,
-    });
-    scriptContents.brand = addToScriptContents({
-        version: brandVersion,
-        coreCssAsset: brandCoreCssAsset,
-        themeVariantCssAssets: brandThemeVariantCssAssets,
-        defaults: brandThemeCss?.defaults,
-    });
-    return scriptContents;
-}