@modern-js/app-tools 2.58.3 → 2.59.0

package/dist/esm-node/plugins/analyze/getHtmlTemplate.js

@@ -0,0 +1,74 @@
+import path from "path";
+import { fs, findExists } from "@modern-js/utils";
+import { HTML_PARTIALS_EXTENSIONS, HTML_PARTIALS_FOLDER } from "./constants";
+import * as templates from "./templates";
+var PartialPosition;
+(function(PartialPosition2) {
+  PartialPosition2["TOP"] = "top";
+  PartialPosition2["HEAD"] = "head";
+  PartialPosition2["BODY"] = "body";
+  PartialPosition2["BOTTOM"] = "bottom";
+  PartialPosition2["INDEX"] = "index";
+})(PartialPosition || (PartialPosition = {}));
+const findPartials = (dir, entryName, position) => {
+  if (fs.existsSync(dir)) {
+    const base = findExists(HTML_PARTIALS_EXTENSIONS.map((ext) => path.resolve(dir, `${position}${ext}`)));
+    const file = entryName ? findExists(HTML_PARTIALS_EXTENSIONS.map((ext) => path.resolve(dir, entryName, `${position}${ext}`))) || base : base;
+    return file ? {
+      file,
+      content: fs.readFileSync(file, "utf8")
+    } : null;
+  }
+  return null;
+};
+const getHtmlTemplate = async (entrypoints, api, { appContext, config }) => {
+  const { appDirectory, internalDirectory } = appContext;
+  const { source: { configDir } } = config;
+  const htmlDir = path.resolve(appDirectory, configDir || "", HTML_PARTIALS_FOLDER);
+  const htmlTemplates = {};
+  const partialsByEntrypoint = {};
+  for (const entrypoint of entrypoints) {
+    const { entryName, isMainEntry } = entrypoint;
+    const name = entrypoints.length === 1 && isMainEntry ? "" : entryName;
+    const customIndexTemplate = findPartials(htmlDir, name, "index");
+    if (customIndexTemplate) {
+      htmlTemplates[entryName] = customIndexTemplate.file;
+    } else {
+      const hookRunners = api.useHookRunners();
+      const { partials } = await hookRunners.htmlPartials({
+        entrypoint,
+        partials: [
+          "top",
+          "head",
+          "body"
+        ].reduce((previous, position) => {
+          const found = findPartials(htmlDir, name, position);
+          previous[position] = found ? [
+            found.content
+          ] : [];
+          return previous;
+        }, {
+          top: [],
+          head: [],
+          body: []
+        })
+      });
+      const templatePath = path.resolve(internalDirectory, entryName, "index.html");
+      fs.outputFileSync(templatePath, templates.html(partials), "utf8");
+      htmlTemplates[entryName] = templatePath;
+      partialsByEntrypoint[entryName] = partials;
+      const bottomTemplate = findPartials(htmlDir, name, "bottom");
+      if (bottomTemplate) {
+        htmlTemplates[`__${entryName}-bottom__`] = bottomTemplate.content;
+      }
+    }
+  }
+  api.setAppContext({
+    ...api.useAppContext(),
+    partialsByEntrypoint
+  });
+  return htmlTemplates;
+};
+export {
+  getHtmlTemplate
+};

package/dist/esm-node/plugins/analyze/getServerRoutes.js

@@ -0,0 +1,132 @@
+import fs from "fs";
+import path from "path";
+import { SERVER_BUNDLE_DIRECTORY, SERVER_WORKER_BUNDLE_DIRECTORY, getEntryOptions, isPlainObject, removeLeadingSlash, removeTailSlash, urlJoin } from "@modern-js/utils";
+import { isMainEntry } from "../../utils/routes";
+import { walkDirectory } from "./utils";
+const applyBaseUrl = (baseUrl, routes) => {
+  if (baseUrl) {
+    if (Array.isArray(baseUrl)) {
+      return baseUrl.reduce((previous, current) => [
+        ...previous,
+        ...applyBaseUrl(current, routes)
+      ], []);
+    } else {
+      return routes.map((route) => {
+        const urlPath = urlJoin(baseUrl, route.urlPath);
+        return {
+          ...route,
+          urlPath: urlPath === "/" ? urlPath : removeTailSlash(urlPath)
+        };
+      });
+    }
+  }
+  return routes;
+};
+const applyRouteOptions = (original, routeOptions) => {
+  const { route, disableSpa } = routeOptions;
+  original.isSPA = !disableSpa;
+  !original.isSPA && (original.entryPath = path.dirname(original.entryPath));
+  let routes;
+  if (route) {
+    if (Array.isArray(route)) {
+      routes = route.map((url) => {
+        if (isPlainObject(url)) {
+          const { path: urlPath, ...other } = url;
+          return {
+            ...original,
+            ...other,
+            urlPath
+          };
+        } else {
+          return {
+            ...original,
+            urlPath: url
+          };
+        }
+      });
+    } else if (isPlainObject(route)) {
+      const { path: urlPath, ...other } = route;
+      routes = [
+        {
+          ...original,
+          ...other,
+          urlPath
+        }
+      ];
+    } else {
+      routes = [
+        {
+          ...original,
+          urlPath: route
+        }
+      ];
+    }
+  } else {
+    routes = [
+      original
+    ];
+  }
+  return routes;
+};
+const collectHtmlRoutes = (entrypoints, appContext, config) => {
+  var _deploy_worker;
+  const { source: { mainEntryName }, html: { disableHtmlFolder }, output: { distPath: { html: htmlPath } = {} }, server: { baseUrl, routes, ssr, ssrByEntries }, deploy } = config;
+  const { packageName } = appContext;
+  const workerSSR = deploy === null || deploy === void 0 ? void 0 : (_deploy_worker = deploy.worker) === null || _deploy_worker === void 0 ? void 0 : _deploy_worker.ssr;
+  let htmlRoutes = entrypoints.reduce((previous, { entryName }) => {
+    const isMain = isMainEntry(entryName, mainEntryName);
+    const entryOptions = getEntryOptions(entryName, isMain, ssr, ssrByEntries, packageName);
+    const isSSR = Boolean(entryOptions);
+    const isWorker = Boolean(workerSSR);
+    const isStream = typeof entryOptions === "object" && entryOptions.mode === "stream";
+    const { resHeaders } = (routes === null || routes === void 0 ? void 0 : routes[entryName]) || {};
+    let route = {
+      urlPath: `/${isMain ? "" : entryName}`,
+      entryName,
+      entryPath: removeLeadingSlash(path.posix.normalize(`${htmlPath}/${entryName}${disableHtmlFolder ? ".html" : "/index.html"}`)),
+      isSPA: true,
+      isStream,
+      isSSR,
+      responseHeaders: resHeaders,
+      worker: isWorker ? `${SERVER_WORKER_BUNDLE_DIRECTORY}/${entryName}.js` : void 0,
+      bundle: isSSR ? `${SERVER_BUNDLE_DIRECTORY}/${entryName}.js` : void 0
+    };
+    if (routes === null || routes === void 0 ? void 0 : routes.hasOwnProperty(entryName)) {
+      const routeOptions = isPlainObject(routes[entryName]) ? routes[entryName] : {
+        route: routes[entryName]
+      };
+      route = applyRouteOptions(route, routeOptions);
+    }
+    return Array.isArray(route) ? [
+      ...previous,
+      ...route
+    ] : [
+      ...previous,
+      route
+    ];
+  }, []);
+  htmlRoutes = applyBaseUrl(baseUrl, htmlRoutes);
+  return htmlRoutes;
+};
+const collectStaticRoutes = (appContext, config) => {
+  const { appDirectory } = appContext;
+  const { source: { configDir }, server: { publicRoutes = {} } } = config;
+  const publicFolder = path.resolve(appDirectory, configDir || "", "public");
+  return fs.existsSync(publicFolder) ? walkDirectory(publicFolder).map((filePath) => {
+    const urlPath = `${urlJoin(toPosix(filePath).slice(toPosix(publicFolder).length))}`;
+    return {
+      urlPath: publicRoutes[removeLeadingSlash(urlPath)] || urlPath,
+      isSPA: true,
+      isSSR: false,
+      entryPath: toPosix(path.relative(path.resolve(appDirectory, configDir || ""), filePath))
+    };
+  }) : [];
+};
+const getServerRoutes = (entrypoints, { appContext, config }) => [
+  ...collectHtmlRoutes(entrypoints, appContext, config),
+  ...collectStaticRoutes(appContext, config)
+];
+const toPosix = (pathStr) => pathStr.split(path.sep).join(path.posix.sep);
+export {
+  getServerRoutes
+};

package/dist/esm-node/plugins/analyze/index.js

@@ -0,0 +1,166 @@
+import * as path from "path";
+import { fs, createDebugger, getArgv, isApiOnly, isDevCommand, minimist } from "@modern-js/utils";
+import { createBuilderGenerator } from "../../builder";
+import { initialNormalizedConfig } from "../../config";
+import { emitResolvedConfig } from "../../utils/config";
+import { getSelectedEntries } from "../../utils/getSelectedEntries";
+import { printInstructions } from "../../utils/printInstructions";
+import { generateRoutes } from "../../utils/routes";
+import { checkIsBuildCommands } from "./utils";
+const debug = createDebugger("plugin-analyze");
+var analyze_default = ({ bundler }) => ({
+  name: "@modern-js/plugin-analyze",
+  post: [
+    "@modern-js/runtime"
+  ],
+  setup: (api) => {
+    let pagesDir = [];
+    let nestedRouteEntries = [];
+    return {
+      async prepare() {
+        var _resolvedConfig_source;
+        let appContext = api.useAppContext();
+        const resolvedConfig = api.useResolvedConfigContext();
+        const hookRunners = api.useHookRunners();
+        try {
+          if (checkIsBuildCommands()) {
+            fs.emptydirSync(appContext.internalDirectory);
+          }
+        } catch {
+        }
+        const apiOnly = await isApiOnly(appContext.appDirectory, (_resolvedConfig_source = resolvedConfig.source) === null || _resolvedConfig_source === void 0 ? void 0 : _resolvedConfig_source.entriesDir, appContext.apiDirectory);
+        await hookRunners.addRuntimeExports();
+        if (apiOnly) {
+          const { routes: routes2 } = await hookRunners.modifyServerRoutes({
+            routes: []
+          });
+          debug(`server routes: %o`, routes2);
+          appContext = {
+            ...api.useAppContext(),
+            apiOnly,
+            serverRoutes: routes2
+          };
+          api.setAppContext(appContext);
+          return;
+        }
+        const [{ getBundleEntry }, { getServerRoutes }, { getHtmlTemplate }] = await Promise.all([
+          import("./getBundleEntry.js"),
+          import("./getServerRoutes.js"),
+          import("./getHtmlTemplate.js")
+        ]);
+        const { entrypoints } = await hookRunners.modifyEntrypoints({
+          entrypoints: await getBundleEntry(hookRunners, appContext, resolvedConfig)
+        });
+        debug(`entrypoints: %o`, entrypoints);
+        const initialRoutes = getServerRoutes(entrypoints, {
+          appContext,
+          config: resolvedConfig
+        });
+        const { routes } = await hookRunners.modifyServerRoutes({
+          routes: initialRoutes
+        });
+        debug(`server routes: %o`, routes);
+        appContext = {
+          ...api.useAppContext(),
+          entrypoints,
+          serverRoutes: routes
+        };
+        api.setAppContext(appContext);
+        nestedRouteEntries = entrypoints.map((point) => point.nestedRoutesEntry).filter(Boolean);
+        pagesDir = entrypoints.map((point) => point.entry).filter((entry) => entry && !path.extname(entry)).concat(nestedRouteEntries);
+        const htmlTemplates = await getHtmlTemplate(entrypoints, api, {
+          appContext,
+          config: resolvedConfig
+        });
+        debug(`html templates: %o`, htmlTemplates);
+        await hookRunners.addDefineTypes();
+        debug(`add Define Types`);
+        let checkedEntries = entrypoints.map((point) => point.entryName);
+        if (isDevCommand()) {
+          const { entry } = minimist(getArgv());
+          checkedEntries = await getSelectedEntries(typeof entry === "string" ? entry.split(",") : entry, entrypoints);
+        }
+        appContext = {
+          ...api.useAppContext(),
+          entrypoints,
+          checkedEntries,
+          apiOnly,
+          serverRoutes: routes,
+          htmlTemplates
+        };
+        api.setAppContext(appContext);
+        if (checkIsBuildCommands()) {
+          await hookRunners.generateEntryCode({
+            entrypoints
+          });
+          const normalizedConfig = api.useResolvedConfigContext();
+          const createBuilderForModern = await createBuilderGenerator(bundler);
+          const builder = await createBuilderForModern({
+            normalizedConfig,
+            appContext
+          });
+          builder.onBeforeBuild(async ({ bundlerConfigs, isFirstCompile }) => {
+            if (!isFirstCompile) {
+              return;
+            }
+            const hookRunners2 = api.useHookRunners();
+            await generateRoutes(appContext);
+            await hookRunners2.beforeBuild({
+              bundlerConfigs
+            });
+          });
+          builder.onAfterBuild(async ({ stats }) => {
+            const hookRunners2 = api.useHookRunners();
+            await hookRunners2.afterBuild({
+              stats
+            });
+            await emitResolvedConfig(appContext.appDirectory, normalizedConfig);
+          });
+          builder.onDevCompileDone(async ({ isFirstCompile }) => {
+            const hookRunners2 = api.useHookRunners();
+            hookRunners2.afterDev({
+              isFirstCompile
+            });
+            if (isFirstCompile) {
+              printInstructions(hookRunners2, appContext, normalizedConfig);
+            }
+          });
+          builder.onBeforeCreateCompiler(async ({ bundlerConfigs }) => {
+            const hookRunners2 = api.useHookRunners();
+            await hookRunners2.beforeCreateCompiler({
+              bundlerConfigs
+            });
+          });
+          builder.onAfterCreateCompiler(async ({ compiler }) => {
+            const hookRunners2 = api.useHookRunners();
+            await hookRunners2.afterCreateCompiler({
+              compiler
+            });
+          });
+          builder.addPlugins(resolvedConfig.builderPlugins);
+          appContext = {
+            ...api.useAppContext(),
+            builder
+          };
+          api.setAppContext(appContext);
+        }
+      },
+      watchFiles() {
+        return {
+          files: pagesDir,
+          isPrivate: true
+        };
+      },
+      resolvedConfig({ resolved }) {
+        const appContext = api.useAppContext();
+        const config = initialNormalizedConfig(resolved, appContext, bundler);
+        return {
+          resolved: config
+        };
+      }
+    };
+  }
+});
+export {
+  analyze_default as default
+};

package/dist/esm-node/plugins/analyze/isDefaultExportFunction.js

@@ -0,0 +1,47 @@
+import fs from "fs";
+import { parse } from "@babel/parser";
+import traverse from "@babel/traverse";
+import * as t from "@babel/types";
+const isFunction = (node) => t.isFunctionDeclaration(node) || t.isFunctionExpression(node) || t.isArrowFunctionExpression(node);
+const isDefaultExportFunction = (file) => {
+  if (!file || !fs.existsSync(file)) {
+    return false;
+  }
+  const ast = parse(fs.readFileSync(file, "utf8"), {
+    sourceType: "unambiguous",
+    plugins: [
+      "jsx",
+      "typescript",
+      "classProperties",
+      "dynamicImport",
+      "exportDefaultFrom",
+      "exportNamespaceFrom",
+      "decorators-legacy",
+      "functionBind",
+      "classPrivateMethods",
+      [
+        "pipelineOperator",
+        {
+          proposal: "minimal"
+        }
+      ],
+      "optionalChaining",
+      "optionalCatchBinding",
+      "objectRestSpread",
+      "numericSeparator"
+    ]
+  });
+  let isExportFunction = false;
+  traverse(ast, {
+    ExportDefaultDeclaration: (path) => {
+      const { declaration } = path.node;
+      if (isFunction(declaration)) {
+        isExportFunction = true;
+      }
+    }
+  });
+  return isExportFunction;
+};
+export {
+  isDefaultExportFunction
+};

package/dist/esm-node/plugins/analyze/templates.js

@@ -0,0 +1,24 @@
+const html = (partials) => `
+<!DOCTYPE html>
+<html>
+<head>
+
+  ${partials.top.join("\n")}
+
+  ${partials.head.join("\n")}
+
+</head>
+
+<body>
+  <div id="<%= mountId %>"><!--<?- html ?>--></div>
+  ${partials.body.join("\n")}
+  <!--<?- chunksMap.js ?>-->
+  <!--<?- SSRDataScript ?>-->
+  <!--<?- bottomTemplate ?>-->
+</body>
+
+</html>
+`;
+export {
+  html
+};

package/dist/esm-node/plugins/analyze/utils.js

@@ -0,0 +1,68 @@
+import fs from "fs";
+import path from "path";
+import { JS_EXTENSIONS, getCommand, normalizeToPosixPath } from "@modern-js/utils";
+import { parse } from "es-module-lexer";
+import { transform } from "esbuild";
+const walkDirectory = (dir) => fs.readdirSync(dir).reduce((previous, filename) => {
+  const filePath = path.join(dir, filename);
+  if (fs.statSync(filePath).isDirectory()) {
+    return [
+      ...previous,
+      ...walkDirectory(filePath)
+    ];
+  } else {
+    return [
+      ...previous,
+      filePath
+    ];
+  }
+}, []);
+const replaceWithAlias = (base, filePath, alias) => {
+  if (filePath.includes(base)) {
+    return normalizeToPosixPath(path.join(alias, path.relative(base, filePath)));
+  } else {
+    return filePath;
+  }
+};
+const parseModule = async ({ source, filename }) => {
+  let content = source;
+  if (JS_EXTENSIONS.some((ext) => filename.endsWith(ext))) {
+    const result = await transform(content, {
+      loader: path.extname(filename).slice(1),
+      format: "esm"
+    });
+    content = result.code;
+  }
+  return await parse(content);
+};
+const getServerCombinedModueFile = (internalDirectory, entryName) => {
+  return path.join(internalDirectory, entryName, "server-loader-combined.js");
+};
+const checkIsBuildCommands = () => {
+  const buildCommands = [
+    "dev",
+    "start",
+    "build",
+    "inspect",
+    "deploy",
+    "dev-worker"
+  ];
+  const command = getCommand();
+  return buildCommands.includes(command);
+};
+const isSubDirOrEqual = (parent, child) => {
+  if (parent === child) {
+    return true;
+  }
+  const relative = path.relative(parent, child);
+  const isSubdir = relative && !relative.startsWith("..") && !path.isAbsolute(relative);
+  return Boolean(isSubdir);
+};
+export {
+  checkIsBuildCommands,
+  getServerCombinedModueFile,
+  isSubDirOrEqual,
+  parseModule,
+  replaceWithAlias,
+  walkDirectory
+};