@quilted/rollup 0.1.18 → 0.2.0

package/build/esm/package.mjs

@@ -1,84 +1,185 @@
 import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+import { exec as exec$1 } from 'node:child_process';
+import { promisify } from 'node:util';
 import { glob } from 'glob';
-import { fileURLToPath } from 'node:url';
+import { multiline } from './shared/strings.mjs';
+import { resolveRoot } from './shared/path.mjs';
 import { getNodePlugins, removeBuildFiles } from './shared/rollup.mjs';
 import { loadPackageJSON } from './shared/package-json.mjs';
+import { getBrowserGroupTargetDetails, rollupGenerateOptionsForBrowsers } from './shared/browserslist.mjs';
 
+async function quiltPackage({
+  root: rootPath = process.cwd(),
+  commonjs = false,
+  esnext: explicitESNext,
+  entries,
+  executable,
+  bundle,
+  react,
+  graphql = true,
+  customize
+} = {}) {
+  const root = resolveRoot(rootPath);
+  const packageJSON = await loadPackageJSON(root);
+  const resolvedEntries = entries ?? await sourceEntriesForPackage(root, packageJSON);
+  const includeESNext = explicitESNext ?? Object.keys(resolvedEntries).length > 0;
+  const [esm, esnext] = await Promise.all([
+    quiltPackageESModules({
+      root,
+      react,
+      graphql,
+      entries: resolvedEntries,
+      executable,
+      bundle,
+      commonjs,
+      customize
+    }),
+    includeESNext ? quiltPackageESNext({
+      root,
+      react,
+      graphql,
+      entries: resolvedEntries,
+      bundle,
+      customize
+    }) : Promise.resolve(void 0)
+  ]);
+  return esnext ? [esm, esnext] : [esm];
+}
 async function quiltPackageESModules({
   root: rootPath = process.cwd(),
-  graphql = true
+  commonjs = false,
+  entries,
+  executable = {},
+  react,
+  bundle,
+  graphql = true,
+  customize
 } = {}) {
-  const root = typeof rootPath === 'string' ? rootPath : fileURLToPath(rootPath);
-  const outputDirectory = path.join(root, 'build/esm');
-  const [{
-    sourceCode
-  }, nodePlugins, packageJSON] = await Promise.all([import('./features/source-code.mjs'), getNodePlugins(), loadPackageJSON(root)]);
-  const source = await sourceForPackage(root, packageJSON);
-  const plugins = [...nodePlugins, sourceCode({
-    mode: 'production'
-  }), removeBuildFiles(['build/esm'], {
-    root
-  })];
+  const root = resolveRoot(rootPath);
+  const outputDirectory = path.resolve(root, "build/esm");
+  const hasExecutables = Object.keys(executable).length > 0;
+  const [{ sourceCode }, { esnext }, nodePlugins, packageJSON, browserGroup] = await Promise.all([
+    import('./features/source-code.mjs'),
+    import('./features/esnext.mjs'),
+    getNodePlugins({ bundle }),
+    loadPackageJSON(root),
+    getBrowserGroupTargetDetails({ name: "default" }, { root })
+  ]);
+  const resolvedEntries = entries ?? await sourceEntriesForPackage(root, packageJSON);
+  const hasEntries = Object.keys(resolvedEntries).length > 0;
+  const source = sourceForEntries({ ...resolvedEntries, ...executable }, { root });
+  const plugins = [
+    ...nodePlugins,
+    sourceCode({ mode: "production", react }),
+    esnext({ mode: "production", babel: false }),
+    removeBuildFiles(
+      [
+        "build/esm",
+        ...commonjs ? ["build/cjs"] : [],
+        ...hasExecutables ? ["bin"] : []
+      ],
+      { root }
+    )
+  ];
+  if (hasExecutables) {
+    plugins.push(packageExecutables(executable, { root }));
+  }
   if (graphql) {
-    const {
-      graphql
-    } = await import('./features/graphql.mjs');
-    plugins.push(graphql({
-      manifest: false
-    }));
+    const { graphql: graphql2 } = await import('./features/graphql.mjs');
+    plugins.push(graphql2({ manifest: false }));
   }
-  return {
+  const generatedCode = await rollupGenerateOptionsForBrowsers(
+    browserGroup.browsers
+  );
+  const output = [
+    {
+      format: "esm",
+      dir: outputDirectory,
+      entryFileNames: `[name].mjs`,
+      assetFileNames: `[name].[ext]`,
+      generatedCode,
+      // We only want to preserve the original directory structure if there
+      // are actual package entries.
+      ...hasEntries ? {
+        preserveModules: true,
+        preserveModulesRoot: source.root
+      } : {}
+    }
+  ];
+  if (commonjs) {
+    output.push({
+      format: "commonjs",
+      dir: path.resolve(outputDirectory, "../cjs"),
+      entryFileNames: `[name].cjs`,
+      assetFileNames: `[name].[ext]`,
+      preserveModules: true,
+      preserveModulesRoot: source.root,
+      generatedCode
+    });
+  }
+  const options = {
     input: source.files,
     plugins,
     onwarn(warning, defaultWarn) {
-      // Removes annoying warnings for React-focused libraries that
-      // include 'use client' directives.
-      if (warning.code === 'MODULE_LEVEL_DIRECTIVE' && /['"]use client['"]/.test(warning.message)) {
+      if (warning.code === "MODULE_LEVEL_DIRECTIVE" && /['"]use client['"]/.test(warning.message)) {
         return;
       }
       defaultWarn(warning);
     },
-    output: {
-      preserveModules: true,
-      preserveModulesRoot: source.root,
-      format: 'esm',
-      dir: outputDirectory,
-      entryFileNames: `[name].mjs`,
-      assetFileNames: `[name].[ext]`
-    }
+    output
   };
+  if (customize) {
+    if (typeof customize === "function") {
+      return await customize(options);
+    } else {
+      const customizedPlugins = await customize.plugins;
+      return {
+        ...options,
+        ...customize,
+        plugins: [
+          ...options.plugins,
+          ...Array.isArray(customizedPlugins) ? customizedPlugins : [customizedPlugins]
+        ]
+      };
+    }
+  } else {
+    return options;
+  }
 }
 async function quiltPackageESNext({
   root: rootPath = process.cwd(),
-  graphql = true
+  react,
+  graphql = true,
+  entries,
+  bundle,
+  customize
 } = {}) {
-  const root = typeof rootPath === 'string' ? rootPath : fileURLToPath(rootPath);
-  const outputDirectory = path.join(root, 'build/esnext');
-  const [{
-    sourceCode
-  }, nodePlugins, packageJSON] = await Promise.all([import('./features/source-code.mjs'), getNodePlugins(), loadPackageJSON(root)]);
-  const source = await sourceForPackage(root, packageJSON);
-  const plugins = [...nodePlugins, sourceCode({
-    mode: 'production',
-    babel: false
-  }), removeBuildFiles(['build/esnext'], {
-    root
-  })];
+  const root = resolveRoot(rootPath);
+  const outputDirectory = path.join(root, "build/esnext");
+  const [{ sourceCode }, { esnext }, nodePlugins, packageJSON] = await Promise.all([
+    import('./features/source-code.mjs'),
+    import('./features/esnext.mjs'),
+    getNodePlugins({ bundle }),
+    loadPackageJSON(root)
+  ]);
+  const resolvedEntries = entries ?? await sourceEntriesForPackage(root, packageJSON);
+  const source = sourceForEntries(resolvedEntries, { root });
+  const plugins = [
+    ...nodePlugins,
+    sourceCode({ mode: "production", babel: false, react }),
+    esnext({ mode: "production", babel: false }),
+    removeBuildFiles(["build/esnext"], { root })
+  ];
   if (graphql) {
-    const {
-      graphql
-    } = await import('./features/graphql.mjs');
-    plugins.push(graphql({
-      manifest: false
-    }));
+    const { graphql: graphql2 } = await import('./features/graphql.mjs');
+    plugins.push(graphql2({ manifest: false }));
   }
-  return {
+  const options = {
     input: source.files,
     plugins,
     onwarn(warning, defaultWarn) {
-      // Removes annoying warnings for React-focused libraries that
-      // include 'use client' directives.
-      if (warning.code === 'MODULE_LEVEL_DIRECTIVE' && /['"]use client['"]/.test(warning.message)) {
+      if (warning.code === "MODULE_LEVEL_DIRECTIVE" && /['"]use client['"]/.test(warning.message)) {
         return;
       }
       defaultWarn(warning);
@@ -86,63 +187,153 @@ async function quiltPackageESNext({
     output: {
       preserveModules: true,
       preserveModulesRoot: source.root,
-      format: 'esm',
+      format: "esm",
       dir: outputDirectory,
       entryFileNames: `[name].esnext`,
-      assetFileNames: `[name].[ext]`
+      assetFileNames: `[name].[ext]`,
+      generatedCode: "es2015"
     }
   };
+  if (customize) {
+    if (typeof customize === "function") {
+      return await customize(options);
+    } else {
+      const customizedPlugins = await customize.plugins;
+      return {
+        ...options,
+        ...customize,
+        plugins: [
+          ...options.plugins,
+          ...Array.isArray(customizedPlugins) ? customizedPlugins : [customizedPlugins]
+        ]
+      };
+    }
+  } else {
+    return options;
+  }
 }
-async function sourceForPackage(root, packageJSON) {
-  const [entries] = await Promise.all([sourceEntriesForPackage(root, packageJSON)]);
+const exec = promisify(exec$1);
+function packageExecutables(executables, { root, nodeOptions = [] }) {
+  return {
+    name: "@quilted/package-executables",
+    async generateBundle() {
+      await Promise.all(
+        Object.entries(executables).map(async ([name, source]) => {
+          await writeExecutable(name, source);
+        })
+      );
+    }
+  };
+  async function writeExecutable(name, source) {
+    const sourceExtension = path.extname(source);
+    let buildFileForSource = source.replace("source", "build/esm");
+    buildFileForSource = path.join(
+      path.dirname(buildFileForSource),
+      `${path.basename(buildFileForSource, sourceExtension)}.mjs`
+    );
+    const executableFile = path.resolve(
+      root,
+      "bin",
+      // Node needs a .mjs extension to parse the file as ESM
+      name.endsWith(".mjs") ? name : `${name}.mjs`
+    );
+    const relativeFromExecutable = normalizedRelative(
+      path.dirname(executableFile),
+      path.resolve(root, buildFileForSource)
+    );
+    const executableContent = nodeOptions.length > 0 ? multiline`
+          #!/usr/bin/env node
+  
+          import {spawn} from 'child_process';
+          import {fileURLToPath} from 'url';
+          import {dirname, resolve} from 'path';
+  
+          const executableFile = resolve(
+            dirname(fileURLToPath(import.meta.url)),
+            ${JSON.stringify(relativeFromExecutable)},
+          );
+  
+          spawn(
+            process.execPath,
+            [
+          ${nodeOptions.map((option) => `    ${JSON.stringify(option)},`).join("\n")}
+              ...process.execArgv,
+              executableFile,
+              ...process.argv.slice(2),
+            ],
+            {stdio: 'inherit'},
+          ).on('exit', (code) => {
+            process.exit(code == null ? 1 : code);
+          });
+        ` : multiline`
+          #!/usr/bin/env node
+          import ${JSON.stringify(relativeFromExecutable)};
+        `;
+    await fs.mkdir(path.dirname(executableFile), { recursive: true });
+    await fs.writeFile(executableFile, executableContent, "utf8");
+    await exec(`chmod +x ${executableFile}`);
+  }
+}
+function normalizedRelative(from, to) {
+  const rel = path.relative(from, to);
+  return rel.startsWith(".") ? rel : `./${rel}`;
+}
+function sourceForEntries(entries, { root }) {
   let sourceRoot = root;
   const sourceEntryFiles = Object.values(entries);
   for (const entry of sourceEntryFiles) {
-    if (!entry.startsWith(root)) continue;
-    sourceRoot = path.resolve(root, path.relative(root, entry).split(path.sep)[0] ?? '.');
+    if (!entry.startsWith(root))
+      continue;
+    sourceRoot = path.resolve(
+      root,
+      path.relative(root, entry).split(path.sep)[0] ?? "."
+    );
     break;
   }
-  return {
-    root: sourceRoot,
-    files: sourceEntryFiles
-  };
+  return { root: sourceRoot, files: sourceEntryFiles };
 }
 async function sourceEntriesForPackage(root, packageJSON) {
-  const {
-    main,
-    exports
-  } = packageJSON;
+  const { main, exports } = packageJSON;
   const entries = {};
-  if (typeof main === 'string') {
-    entries['.'] = await resolveTargetFileAsSource(main, root);
+  if (typeof main === "string") {
+    entries["."] = await resolveTargetFileAsSource(main, root);
   }
-  if (typeof exports === 'string') {
-    entries['.'] = await resolveTargetFileAsSource(exports, root);
+  if (typeof exports === "string") {
+    entries["."] = await resolveTargetFileAsSource(exports, root);
     return entries;
-  } else if (exports == null || typeof exports !== 'object') {
+  } else if (exports == null || typeof exports !== "object") {
     return entries;
   }
-  for (const [exportPath, exportCondition] of Object.entries(exports)) {
+  for (const [exportPath, exportCondition] of Object.entries(
+    exports
+  )) {
     let targetFile = null;
-    if (exportCondition == null) continue;
-    if (typeof exportCondition === 'string') {
+    if (exportCondition == null)
+      continue;
+    if (typeof exportCondition === "string") {
       targetFile = exportCondition;
     } else {
-      targetFile ?? (targetFile = exportCondition['source'] ?? exportCondition['quilt:source'] ?? exportCondition['quilt:esnext'] ?? Object.values(exportCondition).find(condition => typeof condition === 'string' && condition.startsWith('./build/')));
+      targetFile ??= exportCondition["source"] ?? exportCondition["quilt:source"] ?? exportCondition["quilt:esnext"] ?? Object.values(exportCondition).find(
+        (condition) => typeof condition === "string" && condition.startsWith("./build/")
+      );
     }
-    if (targetFile == null) continue;
+    if (targetFile == null)
+      continue;
     const sourceFile = await resolveTargetFileAsSource(targetFile, root);
     entries[exportPath] = sourceFile;
   }
   return entries;
 }
 async function resolveTargetFileAsSource(file, root) {
-  const sourceFile = file.includes('/build/') ? (await glob(file.replace(/[/]build[/][^/]+[/]/, '/*/').replace(/(\.d\.ts|\.[\w]+)$/, '.*'), {
-    cwd: root,
-    absolute: true,
-    ignore: [path.resolve(root, file)]
-  }))[0] : path.resolve(root, file);
+  const sourceFile = file.includes("/build/") ? (await glob(
+    file.replace(/[/]build[/][^/]+[/]/, "/*/").replace(/(\.d\.ts|\.[\w]+)$/, ".*"),
+    {
+      cwd: root,
+      absolute: true,
+      ignore: [path.resolve(root, file)]
+    }
+  ))[0] : path.resolve(root, file);
   return sourceFile;
 }
 
-export { quiltPackageESModules, quiltPackageESNext };
+export { packageExecutables, quiltPackage, quiltPackageESModules, quiltPackageESNext };

package/build/esm/server.mjs

@@ -0,0 +1,118 @@
+import * as path from 'node:path';
+import { glob } from 'glob';
+import { getNodePlugins, removeBuildFiles } from './shared/rollup.mjs';
+import { resolveRoot } from './shared/path.mjs';
+import { loadPackageJSON } from './shared/package-json.mjs';
+import { magicModuleRequestRouterEntry } from './features/request-router.mjs';
+import { resolveEnvOption } from './features/env.mjs';
+import { MAGIC_MODULE_ENTRY, MAGIC_MODULE_REQUEST_ROUTER } from './constants.mjs';
+import { createMagicModulePlugin } from './shared/magic-module.mjs';
+
+async function quiltServer({
+  root: rootPath = process.cwd(),
+  entry,
+  format = "request-router",
+  env,
+  graphql = true,
+  output,
+  port,
+  host
+} = {}) {
+  const root = resolveRoot(rootPath);
+  const mode = (typeof env === "object" ? env?.mode : void 0) ?? "production";
+  const outputDirectory = path.join(root, "build/server");
+  const minify = output?.minify ?? false;
+  const bundle = output?.bundle;
+  const hash = output?.hash ?? "async-only";
+  const outputFormat = output?.format ?? "esmodules";
+  const [
+    { visualizer },
+    { magicModuleEnv, replaceProcessEnv },
+    { sourceCode },
+    { esnext },
+    nodePlugins,
+    packageJSON
+  ] = await Promise.all([
+    import('rollup-plugin-visualizer'),
+    import('./features/env.mjs'),
+    import('./features/source-code.mjs'),
+    import('./features/esnext.mjs'),
+    getNodePlugins({ bundle }),
+    loadPackageJSON(root)
+  ]);
+  const serverEntry = entry ? path.resolve(root, entry) : await sourceForServer(root, packageJSON);
+  const finalEntry = format === "request-router" ? MAGIC_MODULE_ENTRY : serverEntry ?? MAGIC_MODULE_ENTRY;
+  const plugins = [
+    ...nodePlugins,
+    replaceProcessEnv({ mode }),
+    magicModuleEnv({ ...resolveEnvOption(env), mode }),
+    sourceCode({ mode, targets: ["current node"] }),
+    esnext({ mode, targets: ["current node"] }),
+    removeBuildFiles(["build/server", "build/reports"], { root })
+  ];
+  if (format === "request-router") {
+    plugins.push(
+      createMagicModulePlugin({
+        name: "@quilted/magic-module/server-request-router",
+        module: MAGIC_MODULE_REQUEST_ROUTER,
+        alias: serverEntry
+      }),
+      magicModuleRequestRouterEntry({
+        host,
+        port: typeof port === "string" ? Number.parseInt(port, 10) : port
+      })
+    );
+  }
+  if (graphql) {
+    const { graphql: graphql2 } = await import('./features/graphql.mjs');
+    plugins.push(graphql2({ manifest: false }));
+  }
+  if (minify) {
+    const { minify: minify2 } = await import('rollup-plugin-esbuild');
+    plugins.push(minify2());
+  }
+  plugins.push(
+    visualizer({
+      template: "treemap",
+      open: false,
+      brotliSize: true,
+      filename: path.resolve(root, `build/reports/bundle-visualizer.html`)
+    })
+  );
+  return {
+    input: finalEntry,
+    plugins,
+    onwarn(warning, defaultWarn) {
+      if (warning.code === "MODULE_LEVEL_DIRECTIVE" && /['"]use client['"]/.test(warning.message)) {
+        return;
+      }
+      defaultWarn(warning);
+    },
+    output: {
+      format: outputFormat === "commonjs" || outputFormat === "cjs" ? "cjs" : "esm",
+      dir: outputDirectory,
+      entryFileNames: `server${hash === true ? `.[hash]` : ""}.js`,
+      chunkFileNames: `[name]${hash === true || hash === "async-only" ? `.[hash]` : ""}.js`,
+      assetFileNames: `[name]${hash === true ? `.[hash]` : ""}.[ext]`,
+      generatedCode: "es2015"
+    }
+  };
+}
+async function sourceForServer(root, packageJSON) {
+  const { main, exports } = packageJSON;
+  const entryFromPackageJSON = main ?? exports?.["."];
+  if (entryFromPackageJSON) {
+    return path.resolve(root, entryFromPackageJSON);
+  }
+  const possibleSourceFiles = await glob(
+    "{index,server,service,backend,entry,input}.{ts,tsx,mjs,js,jsx}",
+    {
+      cwd: root,
+      nodir: true,
+      absolute: true
+    }
+  );
+  return possibleSourceFiles[0];
+}
+
+export { quiltServer };