html-render-webpack-plugin 0.0.0-master-20261021073115

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2018 Jahred Hope
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,311 @@
+# html-render-webpack-plugin
+
+[![npm](https://img.shields.io/npm/v/html-render-webpack-plugin.svg)](https://www.npmjs.com/package/html-render-webpack-plugin)
+
+Plugin to create HTML files with JavaScript.
+
+- Supports [multiple configurations](https://webpack.js.org/configuration/configuration-types/#exporting-multiple-configurations)
+- Supports [code-splitting](https://webpack.js.org/guides/code-splitting/) and [dynamic imports](https://webpack.js.org/guides/code-splitting/#dynamic-imports)
+
+# Setup
+
+```bash
+$ npm install webpack html-render-webpack-plugin
+# OR
+$ pnpm add webpack html-render-webpack-plugin
+```
+
+**webpack.config.js**
+
+```js
+module.exports = {
+  ...,
+  plugins: [new HtmlRenderPlugin().rendererPlugin]
+};
+```
+
+# Multiple configurations
+
+If you use [multiple webpack configurations](https://webpack.js.org/configuration/configuration-types/#exporting-multiple-configurations) you may want to add information from other builds when rendering.
+
+For example, you may wish to add a script tag where the name includes a hash. The asset name comes from the output of one build (browser assets) whilst the render is performed in another build (node rendering).
+
+**src/render.js**
+
+```js
+export default ({ assetsByChunkName }) => {
+  return `<html>
+<body>
+  <script src="${assetsByChunkName.main}"></script>
+</body>
+</html>`;
+};
+```
+
+**dist/index.html**
+
+```html
+<html>
+  <body>
+    <script src="/main-daf2166db871ad045ea4.js"></script>
+  </body>
+</html>
+```
+
+See [the full example below](#example-client-assets).
+
+## Multiple configuration setup
+
+Add `htmlRenderPlugin.statsCollectorPlugin` to the plugins of all configurations you want to get stats for.
+
+Add `htmlRenderPlugin.rendererPlugin` to the plugin of the configuration you want to use to render html.
+
+HtmlRenderPlugin will then pass the [Webpack Stats](https://webpack.js.org/api/stats/) for those builds into your render function.
+
+**webpack.config.js**
+
+```js
+const { HtmlRenderPlugin } = require("html-render-webpack-plugin");
+
+const htmlRenderPlugin = new HtmlRenderPlugin();
+module.exports = [
+  {
+    name: "render",
+    target: "node", // Creates assets that render HTML that runs well in node
+    plugins: [htmlRenderPlugin.rendererPlugin],
+  },
+  {
+    name: "client",
+    target: "web", // Creates files that run on the browser
+    plugins: [htmlRenderPlugin.statsCollectorPlugin],
+  },
+];
+```
+
+See [examples](#examples) for more details.
+
+# Options
+
+## Option: renderEntry _string_
+
+**default:** "main"
+
+The [webpack entry](https://webpack.js.org/concepts/entry-points/) to use when rendering. Override when using [object syntax](https://webpack.js.org/concepts/entry-points/#object-syntax).
+
+**webpack.config.js**
+
+```js
+module.exports = {
+  entry: {
+    myRender: "./src/myRender.js",
+  },
+  plugins: [
+    new HtmlRenderPlugin({
+      renderEntry: "myRender",
+    }).render,
+  ],
+};
+```
+
+## Option: renderDirectory _string_
+
+The location to create rendered files. Defaults to the rendered assets output.
+
+Useful when deploying HTML files separate to other build assets.
+
+## Option: routes _Array<object|string>_
+
+**default:** `[""]`
+
+Renders a HTML page for each value in the array.
+A route can be a string showing the folder or file to render, or an object containing a route parameter. `index.html` is automatically appended for paths.
+
+```js
+const routes = ["", "contact", "about"];
+```
+
+A route can be an object, containing a `route` parameter.
+
+```js
+const routes = [
+  {
+    route: "en-us/contact",
+    language: "en-us",
+  },
+  {
+    route: "en-us/about",
+    language: "en-us",
+  },
+  {
+    route: "en-au/contact",
+    language: "en-au",
+  },
+  {
+    route: "/en-au/about",
+    language: "en-au",
+  },
+];
+```
+
+## Option: mapStatsToParams _Function_
+
+**default:** `({webpackStats, ...route}) => ({ webpackStats })`
+
+mapStatsToParams should accept webpackStats and [route](#option-routes-arrayobjectstring) information and returns values to be passed into render.
+The function is called individually for each render.
+
+**Recommendation:** mapStatsToParams is an opportunity to limit what information is provided to your render function. Keeping the boundary between your build code and application code simple. Avoid passing all webpackStats into your render function, pull out only the information needed. It is recommended to override the default mapStatsToParams behaviour.
+
+## Option: transformFilePath _Function_
+
+**default:** `(route) => route.route ? route.route : route`
+
+By default a file will be created using the `route` value.
+For example the value `{route: '/about/us'}` would create **about/us/index.html**
+
+If you want to use a different file path you can provide a `transformFilePath` function.
+
+```js
+new HtmlRenderPlugin({
+  ...
+  transformFilePath: ({ route, language }) => `${language}/${route}`
+  routes: [
+    { route: '/about/us', language: 'en-us' },
+    { route: '/about/us', language: 'en-au' }
+  ]
+});
+```
+
+In this example, the resulting files will be
+
+- **en-us/about/us/index.html**
+
+- **en-au/about/us/index.html**
+
+## Option: renderConcurrency _string ("serial"|"parallel")_
+
+**default:** `"serial"`
+
+By default each file will be rendered one after the other, creating a simple sequential build log. When renders with significant asynchronous work you may want to have each render run in parallel.
+
+```
+new HtmlRenderPlugin({
+  renderConcurrency: 'parallel'
+});
+```
+
+## Option: skipAssets _Function_
+
+**default:** `false`
+
+After waiting for all builds to complete HtmlRenderPlugin will render all routes. For particularly large projects with a large number of routes this can take some time. For watch builds you may want to skip emitting assets, relying on `createDevRouter` instead.
+
+## Option: transformExpressPath _Function_
+
+**default:** `(route) => route.route ? route.route : route`
+
+When creating a dev router each route will be attached to the router using it's `route` value.
+
+If you want to use a different express route you can provide a `transformExpressPath` function.
+
+# Dev Server
+
+Create an [Express Middleware](https://expressjs.com/en/guide/using-middleware.html) to attach to Webpack Dev Server to speed up development builds.
+
+For particularly large projects with slow renders and a large number of routes rendering every route on every build can slow down development. The dev server allows you to only render the pages as they are needed during development, whilst ensuring the resulting render works like the full production render.
+
+Using the [Webpack Dev Server Node API](https://github.com/webpack/webpack-dev-server/blob/master/examples/api/simple/server.js#L14) create a dev server and attach the dev HtmlRenderPlugin router to it. When pages are requested they will be rendered just-in-time, using the same method of rendering as production.
+
+```js
+const htmlRenderPlugin = new HtmlRenderPlugin({
+  routes,
+  skipAssets: true,
+});
+
+const compiler = webpack(config);
+
+const webpackDevServer = new WebpackDevServer(compiler, {
+  before: (app) => {
+    app.use(htmlRenderPlugin.createDevRouter());
+  },
+});
+
+webpackDevServer.listen("8081");
+```
+
+**Note:** Ensure that you use the same htmlRenderPlugin created for your webpack configuration as you use for your dev server.
+
+# Manual just-in-time rendering
+
+As an alternative to using the default dev server you can access `renderWhenReady` to apply your own just-in-time rendering.
+
+Just call `renderWhenReady` with any route, and the next time the renderer is ready the render will be performed.
+
+**Note:** Be careful to only use routes that are generated in a production. Not doing this can lead to differences between development and production builds.
+
+Example: Using an Express App to render a dynamic path with ids.
+
+```js
+app.get('/books/:id', (req, res) => {
+  res.send(await htmlRenderPlugin.renderWhenReady({route: '/books/_id'}))
+})
+```
+
+Errors returned during this render will contain a `webpackStats` attribute when available. This can be useful when rendering your own error pages.
+
+# Examples
+
+## Example: Client assets
+
+An example of using `mapStatsToParams` to create `<script>` tags.
+
+**src/render.js**
+
+```js
+export default ({ mainChunk }) => {
+  return `<html>
+  <body>
+    <script src="${mainChunk}"></script>
+  </body>
+  </html>`;
+};
+```
+
+**webpack.config.js**
+
+```js
+const path = require("path");
+
+const { htmlRenderPlugin, htmlRenderClientPlugin } = createHtmlRenderPlugin({
+  mapStatsToParams: ({ webpackStats }) => ({
+    mainChunk: webpackStats.toJson().assetsByChunkName.main,
+  }),
+});
+
+module.exports = [
+  {
+    name: "client",
+    target: "web",
+    output: {
+      filename: "client-[name]-[contenthash].js",
+    },
+    entry: path.resolve("src", "client.js"),
+    plugins: [htmlRenderPlugin.statsCollectorPlugin],
+  },
+  {
+    name: "render",
+    target: "node",
+    output: {
+      libraryExport: "default",
+      libraryTarget: "umd2",
+      filename: "render-[name]-[contenthash].js",
+    },
+    entry: path.resolve("src", "render.js"),
+    plugins: [htmlRenderPlugin.rendererPlugin],
+  },
+];
+```
+
+# Migration Guides
+
+Migration from v1 to v2? Checkout the [Migration Guide](./MIGRATION_GUIDE_v1_to_v2.md).

package/dist/RenderError.d.ts

@@ -0,0 +1,3 @@
+export default class RenderError extends Error {
+    constructor(error: Error);
+}

package/dist/RenderError.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class RenderError extends Error {
+    constructor(error) {
+        super(`html-render-webpack-plugin: An error occurred during render: \n${error}`);
+        this.name = "RenderError";
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.default = RenderError;
+//# sourceMappingURL=RenderError.js.map

package/dist/RenderError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderError.js","sourceRoot":"","sources":["../src/RenderError.ts"],"names":[],"mappings":";;AAAA,MAAqB,WAAY,SAAQ,KAAK;IAC5C,YAAY,KAAY;QACtB,KAAK,CACH,kEAAkE,KAAK,EAAE,CAC1E,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAE1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAVD,8BAUC"}

package/dist/common-types.d.ts

@@ -0,0 +1,23 @@
+import { Stats } from "webpack";
+import { Request } from "express";
+export type WebpackStats = Stats;
+export type BaseRoute = {
+    route: string;
+};
+export type Render<Route = BaseRoute> = (route: Route) => Promise<string>;
+export type OnRendererReady<Route = BaseRoute> = (callback: (render: Render<Route>) => Promise<void>) => void;
+export type Renderer = (...params: any[]) => Promise<string>;
+export type SourceModules = Record<string, string>;
+export type RouteInput<Route = BaseRoute> = Route | string;
+export type Trace = (...values: any[]) => void;
+export type Specifier = string;
+export type ExtraGlobals = Record<string, unknown>;
+export type RenderConcurrency = "parallel" | "serial";
+export type MapStatsToParams = ({ webpackStats, }: {
+    webpackStats: WebpackStats;
+}) => Record<string, unknown>;
+export type TransformPath<Route = BaseRoute> = (route: Route) => string;
+export type TransformExpressPath<Route = BaseRoute> = (route: Route) => string;
+export type GetRouteFromRequest<Route> = (req: Request, routes: Route[]) => Route;
+import originalFs from "fs";
+export type FileSystem = typeof originalFs;

package/dist/common-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=common-types.js.map

package/dist/common-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-types.js","sourceRoot":"","sources":["../src/common-types.ts"],"names":[],"mappings":""}

package/dist/createDevRouter.d.ts

@@ -0,0 +1,11 @@
+import { Router } from "express";
+import { OnRendererReady, BaseRoute, WebpackStats, TransformExpressPath, GetRouteFromRequest } from "./common-types";
+interface Params<Route> {
+    routes: Route[];
+    getRouteFromRequest?: GetRouteFromRequest<Route>;
+    onRendererReady: OnRendererReady<Route>;
+    transformExpressPath: TransformExpressPath<Route>;
+    getClientStats: () => WebpackStats;
+}
+declare const _default: <Route extends BaseRoute>({ routes, getRouteFromRequest, onRendererReady, transformExpressPath, getClientStats, }: Params<Route>) => Router;
+export = _default;

package/dist/createDevRouter.js

@@ -0,0 +1,77 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const express_1 = __importDefault(require("express"));
+const logging_1 = require("./logging");
+const exception_formatter_1 = __importDefault(require("exception-formatter"));
+module.exports = ({ routes, getRouteFromRequest, onRendererReady, transformExpressPath, getClientStats, }) => {
+    (0, logging_1.log)("Create dev server");
+    const formatErrorResponse = (error, webpackStats) => {
+        let devServerScripts = [];
+        if ("entrypoints" in webpackStats && webpackStats.entrypoints) {
+            try {
+                const devServerAssets = webpackStats.entrypoints.main.assets;
+                devServerScripts = devServerAssets.map((asset) => {
+                    // webpack 5 reports assets as objects; older stats used strings.
+                    const assetName = typeof asset === "string" ? asset : asset.name;
+                    return `<script src="${webpackStats.publicPath}${assetName}"></script>`;
+                });
+            }
+            catch (err) {
+                console.error("Unable to load Dev Server Scripts. Error: ", err);
+            }
+        }
+        return [error, ...devServerScripts].join("\n");
+    };
+    const devServerRouter = express_1.default.Router();
+    const routesByExpressPath = {};
+    // Deduplicate paths to avoid duplicated processing in Express
+    routes.forEach((route) => {
+        const expressPath = transformExpressPath(route);
+        if (expressPath) {
+            routesByExpressPath[expressPath] = route;
+        }
+    });
+    Object.entries(routesByExpressPath).forEach(([expressPath, defaultRoute]) => {
+        devServerRouter.get(expressPath, (req, res, next) => __awaiter(void 0, void 0, void 0, function* () {
+            onRendererReady((render) => __awaiter(void 0, void 0, void 0, function* () {
+                const route = getRouteFromRequest
+                    ? getRouteFromRequest(req, routes)
+                    : defaultRoute;
+                if (!route) {
+                    next();
+                    return;
+                }
+                if (!routes.includes(route)) {
+                    const errorMessage = "Returned route was not an existing route. Ensure return value from getRouteFromRequest is route";
+                    (0, logging_1.logError)(errorMessage);
+                    next(new Error(errorMessage));
+                    return;
+                }
+                (0, logging_1.log)(`Static render for ${route} from ${req.path}`);
+                try {
+                    res.send(yield render(route));
+                }
+                catch (error) {
+                    res.status(500).send(formatErrorResponse((0, exception_formatter_1.default)(error, {
+                        format: "html",
+                        inlineStyle: true,
+                        basepath: "webpack://static/./",
+                    }), getClientStats().toJson()));
+                }
+            }));
+        }));
+    });
+    return devServerRouter;
+};
+//# sourceMappingURL=createDevRouter.js.map

package/dist/createDevRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDevRouter.js","sourceRoot":"","sources":["../src/createDevRouter.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,sDAA2E;AAC3E,uCAA0C;AAC1C,8EAAqD;AAiBrD,iBAAS,CAA0B,EACjC,MAAM,EACN,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,cAAc,GACA,EAAU,EAAE;IAC1B,IAAA,aAAG,EAAC,mBAAmB,CAAC,CAAC;IACzB,MAAM,mBAAmB,GAAG,CAC1B,KAAa,EACb,YAAiC,EACjC,EAAE;QACF,IAAI,gBAAgB,GAAa,EAAE,CAAC;QACpC,IAAI,aAAa,IAAI,YAAY,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC;YAC9D,IAAI,CAAC;gBACH,MAAM,eAAe,GAAG,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;gBAE7D,gBAAgB,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE;oBACpD,iEAAiE;oBACjE,MAAM,SAAS,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;oBACjE,OAAO,gBAAgB,YAAY,CAAC,UAAU,GAAG,SAAS,aAAa,CAAC;gBAC1E,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,OAAO,CAAC,KAAK,EAAE,GAAG,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,iBAAO,CAAC,MAAM,EAAE,CAAC;IAEzC,MAAM,mBAAmB,GAA0B,EAAE,CAAC;IAEtD,8DAA8D;IAC9D,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvB,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,WAAW,EAAE,CAAC;YAChB,mBAAmB,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,EAAE;QAC1E,eAAe,CAAC,GAAG,CACjB,WAAW,EACX,CAAO,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;YACxD,eAAe,CAAC,CAAO,MAAM,EAAE,EAAE;gBAC/B,MAAM,KAAK,GAAG,mBAAmB;oBAC/B,CAAC,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC;oBAClC,CAAC,CAAC,YAAY,CAAC;gBACjB,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,IAAI,EAAE,CAAC;oBACP,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5B,MAAM,YAAY,GAChB,iGAAiG,CAAC;oBACpG,IAAA,kBAAQ,EAAC,YAAY,CAAC,CAAC;oBACvB,IAAI,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;oBAC9B,OAAO;gBACT,CAAC;gBACD,IAAA,aAAG,EAAC,qBAAqB,KAAK,SAAS,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBACnD,IAAI,CAAC;oBACH,GAAG,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAChC,CAAC;gBAAC,OAAO,KAAU,EAAE,CAAC;oBACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAClB,mBAAmB,CACjB,IAAA,6BAAkB,EAAC,KAAK,EAAE;wBACxB,MAAM,EAAE,MAAM;wBACd,WAAW,EAAE,IAAI;wBACjB,QAAQ,EAAE,qBAAqB;qBAChC,CAAC,EACF,cAAc,EAAE,CAAC,MAAM,EAAE,CAC1B,CACF,CAAC;gBACJ,CAAC;YACH,CAAC,CAAA,CAAC,CAAC;QACL,CAAC,CAAA,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC"}

package/dist/createRenderer.d.ts

@@ -0,0 +1,8 @@
+import { FileSystem, ExtraGlobals } from "./common-types";
+declare const _default: ({ fileName, fileSystem, rootDir, extraGlobals, }: {
+    fileName: string;
+    fileSystem: FileSystem;
+    extraGlobals: ExtraGlobals;
+    rootDir: string;
+}) => import("./common-types").Renderer;
+export = _default;

package/dist/createRenderer.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const evaluateFromFileSystem_1 = __importDefault(require("./evaluateFromFileSystem"));
+module.exports = function createRenderer({ fileName, fileSystem, rootDir, extraGlobals, }) {
+    if (!fileName) {
+        throw new Error("Missing filename");
+    }
+    if (!fileSystem) {
+        throw new Error("Missing source");
+    }
+    if (!rootDir || typeof rootDir !== "string") {
+        throw new Error(`Recieved rootDir as ${typeof rootDir}`);
+    }
+    return (0, evaluateFromFileSystem_1.default)(fileName, fileSystem, rootDir, extraGlobals);
+};
+//# sourceMappingURL=createRenderer.js.map

package/dist/createRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRenderer.js","sourceRoot":"","sources":["../src/createRenderer.ts"],"names":[],"mappings":";;;;AAAA,sFAA8D;AAG9D,iBAAS,SAAS,cAAc,CAAC,EAC/B,QAAQ,EACR,UAAU,EACV,OAAO,EACP,YAAY,GAMb;IACC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,IAAA,gCAAsB,EAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;AAC7E,CAAC,CAAC"}

package/dist/evaluateFromFileSystem.d.ts

@@ -0,0 +1,3 @@
+import { ExtraGlobals, FileSystem, Renderer } from "./common-types";
+declare function evaluateFromFileSystem(specifier: string, fsModule: FileSystem, rootDir: string, extraGlobals: ExtraGlobals): Renderer;
+export = evaluateFromFileSystem;

package/dist/evaluateFromFileSystem.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const path_1 = __importDefault(require("path"));
+const node_vm_1 = require("node:vm");
+const logging_1 = require("./logging");
+// The wrapper Node uses for CommonJS modules. `extraGlobals` are appended as
+// further parameters so module assets can read them as free variables.
+const moduleParameters = [
+    "exports",
+    "require",
+    "module",
+    "__filename",
+    "__dirname",
+];
+const identifierPattern = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+function getFromSourceModules(specifier, fsModule, rootDir) {
+    const sourceModuleSpecifier = specifier.replace(/^\.\//, "");
+    if (!fsModule.existsSync(path_1.default.resolve(rootDir, sourceModuleSpecifier))) {
+        (0, logging_1.log)(`Unable to find file specifier ${sourceModuleSpecifier}. Root: ${rootDir}.`);
+        return undefined;
+    }
+    return fsModule.readFileSync(path_1.default.resolve(rootDir, sourceModuleSpecifier));
+}
+function getExtraGlobalNames(extraGlobals) {
+    const names = Object.keys(extraGlobals || {});
+    for (const name of names) {
+        if (moduleParameters.includes(name)) {
+            throw new Error(`extraGlobals cannot use the reserved name "${name}".`);
+        }
+        if (!identifierPattern.test(name)) {
+            throw new Error(`extraGlobals key "${name}" is not a valid JavaScript identifier.`);
+        }
+    }
+    return names;
+}
+function evaluateFromFileSystem(specifier, fsModule, rootDir, extraGlobals) {
+    (0, logging_1.log)(`Evaluating source for ${specifier}". From root directory: "${rootDir}".`);
+    let source;
+    try {
+        source = getFromSourceModules(specifier, fsModule, rootDir);
+    }
+    catch (error) {
+        throw new Error(`An error reading "${specifier}". Error: ${error}`, {
+            cause: error,
+        });
+    }
+    if (!source) {
+        throw new Error(`Unable to find source for "${specifier}".`);
+    }
+    const filename = path_1.default.resolve(rootDir, specifier);
+    const extraGlobalNames = getExtraGlobalNames(extraGlobals);
+    const requireFn = createLinker(specifier, fsModule, rootDir, extraGlobals);
+    const module = {
+        exports: {},
+        id: filename,
+        filename,
+        loaded: false,
+        require: requireFn,
+    };
+    // Compiling in the current context keeps Node's globals (Buffer, process,
+    // console, ...) and built-in object identities intact, so values crossing
+    // into the module still satisfy `instanceof` checks.
+    const compiled = (0, node_vm_1.compileFunction)(source.toString(), [...moduleParameters, ...extraGlobalNames], { filename });
+    compiled.call(module.exports, module.exports, requireFn, module, filename, path_1.default.dirname(filename), ...extraGlobalNames.map((name) => extraGlobals[name]));
+    module.loaded = true;
+    return module.exports;
+}
+function createLinker(parentModulePath, fsModule, rootDir, extraGlobals) {
+    (0, logging_1.log)("Creating linker for", parentModulePath);
+    return function linker(specifier) {
+        const absPath = path_1.default.join(path_1.default.dirname(parentModulePath), specifier);
+        if (!getFromSourceModules(specifier, fsModule, rootDir)) {
+            (0, logging_1.log)(`Using external require for ${specifier} from ${parentModulePath}`);
+            const resolvedPath = require.resolve(specifier, { paths: [rootDir] });
+            (0, logging_1.log)(`Resolved ${specifier} as external package to ${resolvedPath}`);
+            // External packages are resolved from the consumer's webpack root.
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            return require(resolvedPath);
+        }
+        (0, logging_1.log)(`Linking ${parentModulePath} to asset ${specifier}`);
+        return evaluateFromFileSystem(absPath, fsModule, rootDir, extraGlobals);
+    };
+}
+module.exports = evaluateFromFileSystem;
+//# sourceMappingURL=evaluateFromFileSystem.js.map

package/dist/evaluateFromFileSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluateFromFileSystem.js","sourceRoot":"","sources":["../src/evaluateFromFileSystem.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { BaseRoute, ExtraGlobals, MapStatsToParams, RenderConcurrency, RouteInput, TransformExpressPath, TransformPath, GetRouteFromRequest } from "./common-types";
+import { Compiler } from "webpack";
+import { Router } from "express";
+interface Options<Route extends BaseRoute = BaseRoute> {
+    skipAssets?: boolean;
+    getRouteFromRequest?: GetRouteFromRequest<Route>;
+    routes?: RouteInput<Route>[];
+    mapStatsToParams?: MapStatsToParams;
+    renderDirectory?: string;
+    renderConcurrency?: RenderConcurrency;
+    transformFilePath?: TransformPath<Route>;
+    transformExpressPath?: TransformExpressPath<Route>;
+    renderEntry?: string;
+    extraGlobals?: ExtraGlobals;
+}
+export default class HtmlRenderPlugin<Route extends BaseRoute = BaseRoute> {
+    constructor(options?: Options<Route>);
+    renderWhenReady: (route: Route) => Promise<string>;
+    statsCollectorPlugin: (compiler: Compiler) => void;
+    rendererPlugin: (compiler: Compiler) => void;
+    render: () => (compiler: Compiler) => void;
+    apply: (compiler: Compiler) => void;
+    createDevRouter: () => Router;
+}
+export { HtmlRenderPlugin };

package/dist/index.js

@@ -0,0 +1,246 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HtmlRenderPlugin = void 0;
+const schema_utils_1 = require("schema-utils");
+const HtmlRenderWebpackPlugin_json_1 = __importDefault(require("./schemas/HtmlRenderWebpackPlugin.json"));
+const RenderError_1 = __importDefault(require("./RenderError"));
+const renderRoutes_1 = __importDefault(require("./renderRoutes"));
+const logging_1 = require("./logging");
+const createDevRouter_1 = __importDefault(require("./createDevRouter"));
+const createRenderer_1 = __importDefault(require("./createRenderer"));
+const multiStats_1 = require("./multiStats");
+const timeSince = (startTime) => `${(Date.now() - startTime) / 1000}s`;
+const defaultMapStats = ({ webpackStats }) => webpackStats ? { webpackStats: webpackStats.toJson() } : {};
+const defaultTransform = (route) => route.route;
+class HtmlRenderPlugin {
+    constructor(options = {}) {
+        (0, schema_utils_1.validate)(HtmlRenderWebpackPlugin_json_1.default, options || {}, {
+            name: "HTML Render Webpack Plugin",
+        });
+        const pluginName = "HtmlRenderPlugin";
+        const { extraGlobals = {}, skipAssets = false, mapStatsToParams = defaultMapStats, renderEntry = "main", getRouteFromRequest, transformFilePath = defaultTransform, transformExpressPath = defaultTransform, renderConcurrency = "serial", } = options;
+        const routes = (options.routes || [""]).map((route) => typeof route === "string" ? { route } : route);
+        const renderDirectory = options.renderDirectory || "dist";
+        const clientCompilations = [];
+        let rendererCompilation;
+        let renderer;
+        let lastClientStats = null;
+        const isBuildReady = () => rendererCompilation &&
+            rendererCompilation.isReady &&
+            clientCompilations.every((compilationStatus) => compilationStatus.isReady);
+        const isRendererReady = () => isBuildReady() && Boolean(renderer);
+        const renderQueue = [];
+        const flushRenderQueue = () => __awaiter(this, void 0, void 0, function* () {
+            if (isRendererReady() && renderQueue.length > 0) {
+                yield renderQueue.shift()();
+                flushRenderQueue();
+            }
+        });
+        const render = (route) => __awaiter(this, void 0, void 0, function* () {
+            const startRenderTime = Date.now();
+            (0, logging_1.log)(`Starting render`, route);
+            const webpackStats = getClientStats();
+            const renderParams = Object.assign(Object.assign({}, route), mapStatsToParams(Object.assign(Object.assign({}, route), { webpackStats })));
+            try {
+                const result = yield renderer(renderParams);
+                (0, logging_1.log)(`Successfully rendered ${route.route} (${timeSince(startRenderTime)})`);
+                return result;
+            }
+            catch (error) {
+                (0, logging_1.log)(`Error rendering ${route.route}`);
+                if (error) {
+                    error.route = route.route;
+                    error.webpackStats = webpackStats;
+                }
+                throw error;
+            }
+        });
+        const onRenderAll = (currentCompilation) => __awaiter(this, void 0, void 0, function* () {
+            (0, logging_1.log)(`Starting routes render`);
+            if (!rendererCompilation.compilation) {
+                const errorMessage = `Unable to find render compilation. Something may have gone wrong during render build.`;
+                (0, logging_1.logError)(errorMessage);
+                throw new Error(errorMessage);
+            }
+            try {
+                yield (0, renderRoutes_1.default)({
+                    render,
+                    renderConcurrency,
+                    renderCompilation: rendererCompilation.compilation,
+                    renderDirectory,
+                    renderEntry,
+                    routes,
+                    transformFilePath,
+                });
+            }
+            catch (error) {
+                (0, logging_1.logError)("An error occurred rendering HTML", error);
+                // @ts-expect-error Allow passing errors to compilation
+                currentCompilation.errors.push(new RenderError_1.default(error));
+            }
+            (0, logging_1.log)(`Ending routes render`);
+        });
+        const getRenderEntry = (compilation) => {
+            const renderStats = compilation.getStats().toJson();
+            const asset = renderStats.assetsByChunkName[renderEntry];
+            if (!asset) {
+                throw new Error(`Unable to find renderEntry "${renderEntry}" in assets. Possible entries are: ${Object.keys(renderStats.assetsByChunkName).join(", ")}.`);
+            }
+            let renderFile = asset;
+            if (Array.isArray(renderFile)) {
+                renderFile = renderFile[0];
+            }
+            if (renderFile && typeof renderFile === "object") {
+                renderFile = renderFile.name;
+            }
+            return renderFile;
+        };
+        const renderCallbacks = [];
+        const getClientStats = () => {
+            if (lastClientStats) {
+                return lastClientStats;
+            }
+            const clientStats = clientCompilations.length === 1
+                ? clientCompilations[0].compilation.getStats()
+                : new ((0, multiStats_1.resolveMultiStats)())(clientCompilations
+                    .map((compilationStatus) => compilationStatus.compilation)
+                    .filter(Boolean)
+                    .map((compilation) => compilation.getStats()));
+            lastClientStats = clientStats;
+            return clientStats;
+        };
+        const flushQueuedRenders = () => {
+            if (isRendererReady() && renderCallbacks.length > 0) {
+                renderCallbacks.shift()(renderer, getClientStats());
+                flushQueuedRenders();
+            }
+        };
+        const onRendererReady = (cb) => {
+            if (isRendererReady()) {
+                cb(render);
+            }
+            else {
+                renderCallbacks.push(cb);
+            }
+        };
+        const createRendererIfReady = (currentCompilation) => __awaiter(this, void 0, void 0, function* () {
+            if (!isBuildReady()) {
+                return;
+            }
+            const renderCompilation = rendererCompilation.compilation;
+            const renderEntry = getRenderEntry(renderCompilation);
+            (0, logging_1.log)("Render route:", { renderEntry });
+            const rootDir = renderCompilation.compiler.outputPath;
+            renderer = (0, createRenderer_1.default)({
+                fileSystem: renderCompilation.compiler
+                    .outputFileSystem,
+                fileName: renderEntry,
+                rootDir,
+                extraGlobals,
+            });
+            (0, logging_1.log)("Created renderer");
+            if (typeof renderer !== "function") {
+                (0, logging_1.log)(`Unable to find render function. File "${renderEntry}". Received ${typeof renderer}.`);
+                throw new Error(`Unable to find render function. File "${renderEntry}". Received ${typeof renderer}.`);
+            }
+            flushQueuedRenders();
+            flushRenderQueue();
+            (0, logging_1.log)("Queued and flushed");
+            if (!skipAssets) {
+                yield onRenderAll(currentCompilation);
+                (0, logging_1.log)("onRenderAll complete");
+            }
+        });
+        const apply = (compiler, isRenderer) => {
+            const compilerName = compiler.name || compiler.options.name;
+            const compilationStatus = {
+                compilation: null,
+                isReady: false,
+            };
+            if (isRenderer) {
+                (0, logging_1.log)(`Received render compiler: ${compilerName}`);
+            }
+            else {
+                (0, logging_1.log)(`Received compiler: ${compilerName}`);
+            }
+            if (isRenderer) {
+                if (rendererCompilation) {
+                    throw new Error("Error. Unable to apply a second renderer");
+                }
+                rendererCompilation = compilationStatus;
+            }
+            else {
+                clientCompilations.push(compilationStatus);
+            }
+            compiler.hooks.watchRun.tap(pluginName, () => {
+                (0, logging_1.log)(`Build started for for ${compilerName}.`);
+                compilationStatus.isReady = false;
+            });
+            compiler.hooks.afterEmit.tapPromise(pluginName, (compilation) => __awaiter(this, void 0, void 0, function* () {
+                (0, logging_1.log)(`Assets emitted for ${compilerName}.`);
+                compilationStatus.compilation = compilation;
+                lastClientStats = null;
+                compilationStatus.isReady = true;
+                try {
+                    yield createRendererIfReady(compilation);
+                }
+                catch (error) {
+                    compilation.errors.push(error);
+                }
+            }));
+        };
+        this.statsCollectorPlugin = (compiler) => apply(compiler, false);
+        this.rendererPlugin = (compiler) => {
+            // Support legacy behaviour of calling '.render()' until next breaking change
+            if (!compiler) {
+                console.warn("Warning. Calling render no longer required. Change htmlRenderPlugin.render() to htmlRenderPlugin.render");
+                return (compiler) => apply(compiler, true);
+            }
+            return apply(compiler, true);
+        };
+        this.apply = (compiler) => {
+            console.warn("Warning. Attempted to apply directly to webpack. Use htmlRenderPlugin.statsCollectorPlugin instead.");
+            this.statsCollectorPlugin(compiler);
+        };
+        this.render = () => this.rendererPlugin;
+        this.createDevRouter = () => (0, createDevRouter_1.default)({
+            transformExpressPath,
+            getRouteFromRequest,
+            onRendererReady,
+            getClientStats,
+            routes,
+        });
+        this.renderWhenReady = (route) => new Promise((resolve, reject) => {
+            const onRender = () => {
+                (0, logging_1.log)("Rendering renderWhenReady onRender");
+                try {
+                    resolve(render(route));
+                }
+                catch (error) {
+                    reject(error);
+                }
+            };
+            if (isRendererReady()) {
+                onRender();
+            }
+            else {
+                renderQueue.push(onRender);
+            }
+        });
+    }
+}
+exports.default = HtmlRenderPlugin;
+exports.HtmlRenderPlugin = HtmlRenderPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/logging.d.ts

@@ -0,0 +1,3 @@
+import debug from "debug";
+export declare const log: debug.Debugger;
+export declare const logError: (...args: any[]) => void;

package/dist/logging.js

@@ -0,0 +1,14 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logError = exports.log = void 0;
+const debug_1 = __importDefault(require("debug"));
+const node_util_1 = require("node:util");
+exports.log = (0, debug_1.default)("HTMLRenderPlugin");
+const logError = (...args) => {
+    console.log((0, node_util_1.styleText)("red", "🚨 HtmlRenderPlugin:"), ...args);
+};
+exports.logError = logError;
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,yCAAsC;AAEzB,QAAA,GAAG,GAAG,IAAA,eAAK,EAAC,kBAAkB,CAAC,CAAC;AAEtC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE;IACzC,OAAO,CAAC,GAAG,CAAC,IAAA,qBAAS,EAAC,KAAK,EAAE,sBAAsB,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AACjE,CAAC,CAAC;AAFW,QAAA,QAAQ,YAEnB"}

package/dist/multiStats.d.ts

@@ -0,0 +1,6 @@
+import type { Stats } from "webpack";
+import type { WebpackStats } from "./common-types";
+type LoadModule = (id: string) => unknown;
+type MultiStatsConstructor = new (stats: Stats[]) => WebpackStats;
+export declare function resolveMultiStats(loadModule?: LoadModule): MultiStatsConstructor;
+export {};

package/dist/multiStats.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveMultiStats = resolveMultiStats;
+// webpack 5.112 moved MultiStats from lib/ to lib/stats/. Both are private
+// paths, so load whichever one exists instead of pinning to a single release.
+const MULTI_STATS_MODULE_PATHS = [
+    "webpack/lib/stats/MultiStats", // webpack >= 5.112.0
+    "webpack/lib/MultiStats", // webpack <= 5.111.x
+];
+function getWebpackVersion(loadModule) {
+    try {
+        return loadModule("webpack/package.json").version;
+    }
+    catch (_a) {
+        return "unknown";
+    }
+}
+function resolveMultiStats(loadModule = require) {
+    var _a;
+    const failures = [];
+    for (const modulePath of MULTI_STATS_MODULE_PATHS) {
+        try {
+            const loaded = loadModule(modulePath);
+            return ((_a = loaded.default) !== null && _a !== void 0 ? _a : loaded);
+        }
+        catch (error) {
+            failures.push(`${modulePath}: ${error instanceof Error ? error.message : error}`);
+        }
+    }
+    throw new Error(`Unable to load webpack's MultiStats class. Installed webpack: ${getWebpackVersion(loadModule)}. Tried ${failures.join(", ")}.`);
+}
+//# sourceMappingURL=multiStats.js.map

package/dist/multiStats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiStats.js","sourceRoot":"","sources":["../src/multiStats.ts"],"names":[],"mappings":";;AAqBA,8CA0BC;AAzCD,2EAA2E;AAC3E,8EAA8E;AAC9E,MAAM,wBAAwB,GAAG;IAC/B,8BAA8B,EAAE,qBAAqB;IACrD,wBAAwB,EAAE,qBAAqB;CAChD,CAAC;AAEF,SAAS,iBAAiB,CAAC,UAAsB;IAC/C,IAAI,CAAC;QACH,OAAQ,UAAU,CAAC,sBAAsB,CAAyB,CAAC,OAAO,CAAC;IAC7E,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAgB,iBAAiB,CAC/B,aAAyB,OAAO;;IAEhC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,UAAU,IAAI,wBAAwB,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CACwB,CAAC;YAE7D,OAAO,CACL,MAAC,MAA8C,CAAC,OAAO,mCACtD,MAAgC,CAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CACX,GAAG,UAAU,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CACnE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,iEAAiE,iBAAiB,CAChF,UAAU,CACX,WAAW,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACnC,CAAC;AACJ,CAAC"}

package/dist/renderRoutes.d.ts

@@ -0,0 +1,13 @@
+import { RenderConcurrency, TransformPath, Render, BaseRoute } from "./common-types";
+import { Compilation } from "webpack";
+interface Params<Route> {
+    render: Render<Route>;
+    renderConcurrency: RenderConcurrency;
+    routes: Route[];
+    renderEntry: string;
+    renderDirectory: string;
+    renderCompilation: Compilation;
+    transformFilePath: TransformPath<Route>;
+}
+export default function renderRoutes<Route extends BaseRoute>({ render: performRender, renderConcurrency, routes, renderDirectory, renderCompilation, transformFilePath, }: Params<Route>): Promise<void[] | undefined>;
+export {};

package/dist/renderRoutes.js

@@ -0,0 +1,107 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = renderRoutes;
+const path_1 = __importDefault(require("path"));
+const node_util_1 = require("node:util");
+const logging_1 = require("./logging");
+function safeMkdir(fileSystem, dir) {
+    // @ts-expect-error Allow looking for invalid field mkdirp
+    if (fileSystem.mkdirp) {
+        (0, logging_1.log)("Found mkdirp method on fileSystem. Assuming older mock fs system.");
+        return new Promise((resolve, reject) => {
+            // @ts-expect-error Allow calling for invalid field mkdirp
+            return fileSystem.mkdirp(dir, (error) => {
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve();
+            });
+        });
+    }
+    return new Promise((resolve, reject) => {
+        fileSystem.mkdir(dir, { recursive: true }, (error) => {
+            if (error) {
+                // @ts-expect-error Looking for code property that shouldn't exist
+                if (error.code === "EEXIST") {
+                    (0, logging_1.log)("Ignoring error when creating folder. Folder already existed. Assuming older mock fs systems.");
+                    resolve();
+                    return;
+                }
+                reject(error);
+                return;
+            }
+            resolve();
+        });
+    });
+}
+function renderRoutes(_a) {
+    return __awaiter(this, arguments, void 0, function* ({ render: performRender, renderConcurrency, routes, renderDirectory, renderCompilation, transformFilePath, }) {
+        (0, logging_1.log)(`Starting render of ${routes.length} routes`);
+        const outputFileSystem = renderCompilation.compiler.outputFileSystem;
+        if (!outputFileSystem) {
+            throw new Error("Unable to render HTML: the compilation has no output file system.");
+        }
+        const fileSystem = outputFileSystem;
+        function emitFile(dir, content) {
+            return __awaiter(this, void 0, void 0, function* () {
+                (0, logging_1.log)("Emitting file to", dir);
+                yield safeMkdir(fileSystem, path_1.default.dirname(dir));
+                return new Promise((resolve, reject) => fileSystem.writeFile(dir, content, (error) => {
+                    if (error) {
+                        reject(error);
+                        return;
+                    }
+                    resolve();
+                }));
+            });
+        }
+        function render(route) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const relativeFilePath = transformFilePath(route);
+                const includesHtmlInFilePath = relativeFilePath.substr(-5) === ".html";
+                if (!path_1.default.isAbsolute(renderDirectory)) {
+                    renderDirectory = path_1.default.resolve(renderDirectory);
+                }
+                const newFilePath = includesHtmlInFilePath
+                    ? path_1.default.join(renderDirectory, relativeFilePath)
+                    : path_1.default.join(renderDirectory, relativeFilePath, "index.html");
+                let renderResult;
+                try {
+                    renderResult = yield performRender(route);
+                }
+                catch (error) {
+                    console.error(`🚨 ${(0, node_util_1.styleText)("red", `An error occurred rendering route: "${route.route}"`)}. Exiting render.`);
+                    throw error;
+                }
+                if (typeof renderResult !== "string") {
+                    throw new Error(`Render must return a string. Received "${typeof renderResult}".`);
+                }
+                yield emitFile(newFilePath, renderResult);
+                (0, logging_1.log)(`Successfully emitted ${newFilePath}`);
+            });
+        }
+        if (renderConcurrency === "parallel") {
+            (0, logging_1.log)("Rendering parallel");
+            return Promise.all(routes.map(render));
+        }
+        (0, logging_1.log)("Rendering Serial");
+        for (const route of routes) {
+            yield render(route);
+        }
+        return;
+    });
+}
+//# sourceMappingURL=renderRoutes.js.map

package/dist/renderRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderRoutes.js","sourceRoot":"","sources":["../src/renderRoutes.ts"],"names":[],"mappings":"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"}

package/dist/schemas/HtmlRenderWebpackPlugin.json

@@ -0,0 +1,63 @@
+{
+    "title": "HTMLRenderOptionsArgument",
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+        "routes": {
+            "description": "List of routes to render. A file is created for each route.",
+            "type": "array",
+            "items": {
+                "description": "A rule condition",
+                "anyOf": [
+                    {
+                        "type": "object",
+                        "additionalProperties": true,
+                        "properties": {
+                            "route": {
+                                "description": "The path to generate",
+                                "type": "string"
+                            }
+                        }
+                    },
+                    { "type": "string" }
+                ]
+            }
+        },
+        "skipAssets": {
+            "description": "If true, skip creating assets after a build. Often used in conjuction with createDevRouter.",
+            "type": "boolean"
+        },
+        "mapStatsToParams": {
+            "description": "Used to pass additional values to each render.",
+            "instanceof": "Function"
+        },
+        "renderDirectory": {
+            "description": "The directory to render files to.",
+            "type": "string"
+        },
+        "renderConcurrency": {
+            "description": "Whether to render serial or parallel",
+            "type": "string"
+        },
+        "transformFilePath": {
+            "description": "Used to build the file path from the route.",
+            "instanceof": "Function"
+        },
+        "transformExpressPath": {
+            "description": "Used to build the express route for the dev server.",
+            "instanceof": "Function"
+        },
+        "getRouteFromRequest": {
+            "description": "Used on the dev server to identify a route for a request.",
+            "instanceof": "Function"
+        },
+        "renderEntry": {
+            "description": "Which webpack entry should be used to render.",
+            "type": "string"
+        },
+        "extraGlobals": {
+            "description": "Extra values to pass to the evaluated renderer's module scope.",
+            "type": "object"
+        }
+    }
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "html-render-webpack-plugin",
+  "description": "webpack plugin for rendering static HTML in a multi-config webpack build",
+  "author": "Jahred Hope <jahredhope@gmail.com>",
+  "version": "0.0.0-master-20261021073115",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "keywords": [
+    "html",
+    "static",
+    "plugin",
+    "webpack"
+  ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jahredhope/html-render-webpack-plugin.git"
+  },
+  "peerDependencies": {
+    "express": ">=4.0.0",
+    "webpack": "^5.0.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^3.0.3",
+    "@eslint/js": "^10.0.1",
+    "@types/debug": "^4.1.13",
+    "@types/express": "^5.0.6",
+    "@types/node": "^22.10.0",
+    "commitizen": "4.2.3",
+    "cz-conventional-changelog": "3.3.0",
+    "eslint": "10.13.0",
+    "express": "^5.3.0",
+    "globals": "^17.13.0",
+    "memfs": "^4.80.0",
+    "prettier": "3.9.10",
+    "react": "^17.0.1",
+    "react-dom": "^17.0.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.72.0",
+    "vitest": "^5.0.5",
+    "webpack": "^5.112.0",
+    "webpack-merge": "^6.0.1"
+  },
+  "dependencies": {
+    "debug": "^4.4.3",
+    "exception-formatter": "^2.1.2",
+    "schema-utils": "^4.8.1"
+  },
+  "config": {
+    "commitizen": {
+      "path": "cz-conventional-changelog"
+    }
+  },
+  "scripts": {
+    "build": "tsc --declaration",
+    "changeset": "changeset",
+    "commit": "git-cz",
+    "format": "prettier --write .",
+    "lint": "pnpm run lint.eslint && pnpm run lint.prettier && pnpm run lint.typecheck",
+    "lint.eslint": "eslint .",
+    "lint.prettier": "prettier --check .",
+    "lint.typecheck": "tsc -p tsconfig.test.json",
+    "release": "changeset publish",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "version-packages": "changeset version"
+  }
+}