jiek 2.2.1 → 2.2.3

package/dist/cli.js

@@ -16,8 +16,7 @@ import 'jiek/cli-only-build';
 
 let root;
 function getRoot() {
-  if (root)
-    return root;
+  if (root) return root;
   const rootOption = process.env.JIEK_ROOT;
   root = rootOption ? path.isAbsolute(rootOption) ? rootOption : path.resolve(process.cwd(), rootOption) : void 0;
   return root;
@@ -26,8 +25,7 @@ function getRoot() {
 let wd;
 let notWorkspace = false;
 function getWD() {
-  if (wd)
-    return { wd, notWorkspace };
+  if (wd) return { wd, notWorkspace };
   const root = getRoot();
   if (root !== void 0) {
     const isWorkspace = isWorkspaceDir(root, type);
@@ -4407,8 +4405,7 @@ function loadConfig(dirOrOptions) {
     default:
       throw new Error(`unsupported config file type: ${ext}`);
   }
-  if (!module)
-    throw new Error("config file is empty");
+  if (!module) throw new Error("config file is empty");
   return module.default ?? module;
 }
 
@@ -4520,10 +4517,8 @@ async function prepublish({ bumper } = {}) {
       )
     );
     for (const [key, value] of Object.entries(manifest)) {
-      if (key === "version")
-        continue;
-      if (JSON.stringify(value) === JSON.stringify(oldJSON[key]))
-        continue;
+      if (key === "version") continue;
+      if (JSON.stringify(value) === JSON.stringify(oldJSON[key])) continue;
       if (key !== "exports") {
         newJSONString = applyEdits(
           newJSONString,
@@ -4562,8 +4557,7 @@ async function prepublish({ bumper } = {}) {
             }
           }
           for (const [k, v] of Object.entries(indexPublishConfig)) {
-            if (v === void 0)
-              continue;
+            if (v === void 0) continue;
             newJSONString = applyEdits(
               newJSONString,
               modify(

package/dist/index.d.cts

@@ -40,6 +40,17 @@ interface TemplateOptions {
     } & rollup_plugin_esbuild.Options) | ({
         type: 'swc';
     } & rollup_plugin_swc3.PluginOptions);
+    features?: {
+        /**
+         * When use esbuild type builder, it will inject `supported.import-attributes` option.
+         * When use swc type builder, it will inject `jsc.experimental.keepImportAttributes` option.
+         *
+         * And it will auto set the rollup output externalImportAttributes and importAttributesKey options.
+         *
+         * @default true
+         */
+        keepImportAttributes?: boolean | 'assert';
+    };
     output?: {
         /**
          * @default true

package/dist/index.d.ts

@@ -40,6 +40,17 @@ interface TemplateOptions {
     } & rollup_plugin_esbuild.Options) | ({
         type: 'swc';
     } & rollup_plugin_swc3.PluginOptions);
+    features?: {
+        /**
+         * When use esbuild type builder, it will inject `supported.import-attributes` option.
+         * When use swc type builder, it will inject `jsc.experimental.keepImportAttributes` option.
+         *
+         * And it will auto set the rollup output externalImportAttributes and importAttributesKey options.
+         *
+         * @default true
+         */
+        keepImportAttributes?: boolean | 'assert';
+    };
     output?: {
         /**
          * @default true

package/dist/rollup/index.cjs

@@ -4171,8 +4171,7 @@ function bundleAnalyzer(modulesResolved) {
       return {
         name: "jiek:bundle-analyzer",
         async closeBundle(...args) {
-          if (typeof ana.closeBundle !== "function")
-            return;
+          if (typeof ana.closeBundle !== "function") return;
           return ana.closeBundle?.call(this, ...args);
         }
       };
@@ -4280,8 +4279,7 @@ function getExports({
 
 let root;
 function getRoot() {
-  if (root)
-    return root;
+  if (root) return root;
   const rootOption = process.env.JIEK_ROOT;
   root = rootOption ? path__default.default.isAbsolute(rootOption) ? rootOption : path__default.default.resolve(process.cwd(), rootOption) : void 0;
   return root;
@@ -4298,8 +4296,7 @@ try {
 let wd;
 let notWorkspace = false;
 function getWD() {
-  if (wd)
-    return { wd, notWorkspace };
+  if (wd) return { wd, notWorkspace };
   const root = getRoot();
   if (root !== void 0) {
     const isWorkspace = getWorkspaceDir.isWorkspaceDir(root, type);
@@ -4421,16 +4418,14 @@ function loadConfig(dirOrOptions) {
     default:
       throw new Error(`unsupported config file type: ${ext}`);
   }
-  if (!module)
-    throw new Error("config file is empty");
+  if (!module) throw new Error("config file is empty");
   return module.default ?? module;
 }
 
 const recusiveListFiles = (dir) => fs__default.default.readdirSync(dir).reduce((acc, file) => {
   const filePath = path.resolve(dir, file);
   if (fs__default.default.statSync(filePath).isDirectory()) {
-    if (filePath.endsWith("/node_modules"))
-      return acc;
+    if (filePath.endsWith("/node_modules")) return acc;
     return [...acc, ...recusiveListFiles(filePath)];
   }
   return [...acc, filePath];
@@ -4443,10 +4438,9 @@ const getExtendTSConfig = (tsconfigPath) => {
   const { extends: exts, ...tsconfig } = getTSConfig(tsconfigPath);
   const resolvePaths = (paths) => paths?.map((p) => path.resolve(tsconfigPathDirname, p)) ?? [];
   const extendsPaths = resolvePaths(
-    exts ? Array.isArray(exts) ? exts : [exts] : []
+    exts !== void 0 ? Array.isArray(exts) ? exts : [exts] : []
   );
-  if (extendsPaths.length === 0)
-    return tsconfig;
+  if (extendsPaths.length === 0) return tsconfig;
   return extendsPaths.map(getExtendTSConfig).concat(tsconfig).reduce((acc, { compilerOptions = {}, references: _, ...curr }) => ({
     ...acc,
     ...curr,
@@ -4473,24 +4467,20 @@ const getCompilerOptionsByFilePath = (tsconfigPath, filePath) => {
     tsconfig.include,
     tsconfig.exclude
   ].map(resolvePaths);
-  if (exclude.length > 0 && exclude.some((i) => micromatchExports.isMatch(filePath, i)))
-    return;
-  if (tsconfig.files?.length === 0 && tsconfig.include?.length === 0)
-    return;
+  if (exclude.length > 0 && exclude.some((i) => micromatchExports.isMatch(filePath, i))) return;
+  if (tsconfig.files?.length === 0 && tsconfig.include?.length === 0) return;
   let isInclude = false;
-  isInclude || (isInclude = files.length > 0 && files.includes(filePath));
-  isInclude || (isInclude = include.length > 0 && include.some((i) => micromatchExports.isMatch(filePath, i)));
+  isInclude ||= files.length > 0 && files.includes(filePath);
+  isInclude ||= include.length > 0 && include.some((i) => micromatchExports.isMatch(filePath, i));
   if (isInclude) {
     return tsconfig.compilerOptions ?? {};
   } else {
-    if (tsconfig.files && tsconfig.files.length > 0 || tsconfig.include && tsconfig.include.length > 0)
-      return;
+    if (tsconfig.files && tsconfig.files.length > 0 || tsconfig.include && tsconfig.include.length > 0) return;
   }
   references.reverse();
   for (const ref of references) {
     const compilerOptions = getCompilerOptionsByFilePath(ref, filePath);
-    if (compilerOptions)
-      return compilerOptions;
+    if (compilerOptions) return compilerOptions;
   }
   return tsconfig.compilerOptions;
 };
@@ -4669,10 +4659,8 @@ const resolveOutputControls = (context, output) => ({
 const resolveWorkspacePath = (p) => path.resolve(WORKSPACE_ROOT, p);
 const pascalCase = (str) => str.replace(/[@|/-](\w)/g, (_, $1) => $1.toUpperCase()).replace(/(?:^|-)(\w)/g, (_, $1) => $1.toUpperCase());
 const reveal = (obj, keys) => keys.reduce((acc, key) => {
-  if (typeof acc === "string")
-    throw new Error("key not found in exports");
-  if (!(key in acc))
-    throw new Error(`key ${key} not found in exports`);
+  if (typeof acc === "string") throw new Error("key not found in exports");
+  if (!(key in acc)) throw new Error(`key ${key} not found in exports`);
   return acc[key];
 }, obj);
 const resolveMinifyOptions = (minifyOptions) => typeof minifyOptions === "string" ? { type: minifyOptions } : minifyOptions ?? { type: "esbuild" };
@@ -4692,7 +4680,7 @@ const withMinify = (output, onlyOncePlugins = []) => {
   const minifyPlugin = resolvedMinifyOptions.type === "esbuild" ? import('rollup-plugin-esbuild').then(({ minify: minify2 }) => minify2(noTypeResolvedMinifyOptions)) : resolvedMinifyOptions.type === "swc" ? import('rollup-plugin-swc3').then(({ minify: minify2 }) => minify2(noTypeResolvedMinifyOptions)) : import('@rollup/plugin-terser').then(({ default: minify2 }) => minify2(noTypeResolvedMinifyOptions));
   return minify === "only-minify" ? [{
     ...output,
-    // TODO replace suffix when pubish to npm and the `build.output.minify` is 'only-minify'
+    // TODO replace suffix when publish to npm and the `build.output.minify` is 'only-minify'
     // TODO resolve dts output file name
     entryFileNames: (chunkInfo) => typeof output.entryFileNames === "function" ? output.entryFileNames(chunkInfo) : (() => {
       throw new Error("entryFileNames must be a function");
@@ -4799,15 +4787,39 @@ const generateConfigs = (context, options = {}) => {
   const { js: jsOutput, dts: dtsOutput } = resolveOutputControls(context, build.output);
   const rollupOptions = [];
   const commonPlugins = [
-    pluginNodeResolve.nodeResolve({ exportConditions })
+    pluginNodeResolve.nodeResolve({
+      exportConditions,
+      extensions: [
+        ".js",
+        ".cjs",
+        ".mjs",
+        ".jsx",
+        ".cjsx",
+        ".mjsx",
+        ".ts",
+        ".cts",
+        ".mts",
+        ".tsx",
+        ".ctsx",
+        ".mtsx"
+      ]
+    })
   ];
   if (jsOutput && !WITHOUT_JS) {
     const sourcemap = typeof options?.output?.sourcemap === "object" ? options.output.sourcemap.js : options?.output?.sourcemap;
+    const features = Object.assign({
+      keepImportAttributes: true
+    }, build.features);
     const builder = resolvedBuilderOptions.type === "esbuild" ? import('rollup-plugin-esbuild').then(
       ({ default: esbuild }) => esbuild({
         sourceMap: sourcemap === "hidden" ? false : !!sourcemap,
         tsconfig: buildTSConfigPath,
-        ...noTypeResolvedBuilderOptions
+        target: "node22",
+        ...noTypeResolvedBuilderOptions,
+        supported: {
+          "import-attributes": features.keepImportAttributes !== false,
+          ...resolvedBuilderOptions.supported
+        }
       })
     ) : import('rollup-plugin-swc3').then(
       ({ default: swc }) => swc({
@@ -4816,7 +4828,14 @@ const generateConfigs = (context, options = {}) => {
           inline: "inline"
         }[sourcemap] ?? void 0,
         tsconfig: buildTSConfigPath,
-        ...noTypeResolvedBuilderOptions
+        ...noTypeResolvedBuilderOptions,
+        jsc: {
+          ...resolvedBuilderOptions.jsc,
+          experimental: {
+            ...resolvedBuilderOptions.jsc?.experimental,
+            keepImportAttributes: features.keepImportAttributes !== false
+          }
+        }
       })
     );
     const [ana, anaOutputPlugin] = bundleAnalyzer((modules) => void publishInEntry("modulesAnalyze", { modules }));
@@ -4835,6 +4854,8 @@ const generateConfigs = (context, options = {}) => {
           sourcemap,
           format,
           strict: typeof options?.output?.strict === "object" ? options.output.strict.js : options?.output?.strict,
+          externalImportAttributes: features.keepImportAttributes !== false,
+          importAttributesKey: features.keepImportAttributes === false || features.keepImportAttributes === void 0 ? void 0 : features.keepImportAttributes === true ? "with" : features.keepImportAttributes,
           plugins: [
             isFormatEsm(format === "esm")
           ]
@@ -4910,10 +4931,8 @@ const generateConfigs = (context, options = {}) => {
 function template(packageJSON) {
   const { name, type, exports: entrypoints$1 } = packageJSON;
   const pkgIsModule = type === "module";
-  if (!name)
-    throw new Error("package.json name is required");
-  if (!entrypoints$1)
-    throw new Error("package.json exports is required");
+  if (!name) throw new Error("package.json name is required");
+  if (!entrypoints$1) throw new Error("package.json exports is required");
   const packageName = pascalCase(name);
   const external = externalResolver(packageJSON);
   const [filteredResolvedEntrypoints, exports] = getExports({

package/dist/rollup/index.js

@@ -4155,8 +4155,7 @@ function bundleAnalyzer(modulesResolved) {
       return {
         name: "jiek:bundle-analyzer",
         async closeBundle(...args) {
-          if (typeof ana.closeBundle !== "function")
-            return;
+          if (typeof ana.closeBundle !== "function") return;
           return ana.closeBundle?.call(this, ...args);
         }
       };
@@ -4264,8 +4263,7 @@ function getExports({
 
 let root;
 function getRoot() {
-  if (root)
-    return root;
+  if (root) return root;
   const rootOption = process.env.JIEK_ROOT;
   root = rootOption ? path.isAbsolute(rootOption) ? rootOption : path.resolve(process.cwd(), rootOption) : void 0;
   return root;
@@ -4282,8 +4280,7 @@ try {
 let wd;
 let notWorkspace = false;
 function getWD() {
-  if (wd)
-    return { wd, notWorkspace };
+  if (wd) return { wd, notWorkspace };
   const root = getRoot();
   if (root !== void 0) {
     const isWorkspace = isWorkspaceDir(root, type);
@@ -4405,16 +4402,14 @@ function loadConfig(dirOrOptions) {
     default:
       throw new Error(`unsupported config file type: ${ext}`);
   }
-  if (!module)
-    throw new Error("config file is empty");
+  if (!module) throw new Error("config file is empty");
   return module.default ?? module;
 }
 
 const recusiveListFiles = (dir) => fs.readdirSync(dir).reduce((acc, file) => {
   const filePath = resolve(dir, file);
   if (fs.statSync(filePath).isDirectory()) {
-    if (filePath.endsWith("/node_modules"))
-      return acc;
+    if (filePath.endsWith("/node_modules")) return acc;
     return [...acc, ...recusiveListFiles(filePath)];
   }
   return [...acc, filePath];
@@ -4427,10 +4422,9 @@ const getExtendTSConfig = (tsconfigPath) => {
   const { extends: exts, ...tsconfig } = getTSConfig(tsconfigPath);
   const resolvePaths = (paths) => paths?.map((p) => resolve(tsconfigPathDirname, p)) ?? [];
   const extendsPaths = resolvePaths(
-    exts ? Array.isArray(exts) ? exts : [exts] : []
+    exts !== void 0 ? Array.isArray(exts) ? exts : [exts] : []
   );
-  if (extendsPaths.length === 0)
-    return tsconfig;
+  if (extendsPaths.length === 0) return tsconfig;
   return extendsPaths.map(getExtendTSConfig).concat(tsconfig).reduce((acc, { compilerOptions = {}, references: _, ...curr }) => ({
     ...acc,
     ...curr,
@@ -4457,24 +4451,20 @@ const getCompilerOptionsByFilePath = (tsconfigPath, filePath) => {
     tsconfig.include,
     tsconfig.exclude
   ].map(resolvePaths);
-  if (exclude.length > 0 && exclude.some((i) => micromatchExports.isMatch(filePath, i)))
-    return;
-  if (tsconfig.files?.length === 0 && tsconfig.include?.length === 0)
-    return;
+  if (exclude.length > 0 && exclude.some((i) => micromatchExports.isMatch(filePath, i))) return;
+  if (tsconfig.files?.length === 0 && tsconfig.include?.length === 0) return;
   let isInclude = false;
-  isInclude || (isInclude = files.length > 0 && files.includes(filePath));
-  isInclude || (isInclude = include.length > 0 && include.some((i) => micromatchExports.isMatch(filePath, i)));
+  isInclude ||= files.length > 0 && files.includes(filePath);
+  isInclude ||= include.length > 0 && include.some((i) => micromatchExports.isMatch(filePath, i));
   if (isInclude) {
     return tsconfig.compilerOptions ?? {};
   } else {
-    if (tsconfig.files && tsconfig.files.length > 0 || tsconfig.include && tsconfig.include.length > 0)
-      return;
+    if (tsconfig.files && tsconfig.files.length > 0 || tsconfig.include && tsconfig.include.length > 0) return;
   }
   references.reverse();
   for (const ref of references) {
     const compilerOptions = getCompilerOptionsByFilePath(ref, filePath);
-    if (compilerOptions)
-      return compilerOptions;
+    if (compilerOptions) return compilerOptions;
   }
   return tsconfig.compilerOptions;
 };
@@ -4653,10 +4643,8 @@ const resolveOutputControls = (context, output) => ({
 const resolveWorkspacePath = (p) => resolve(WORKSPACE_ROOT, p);
 const pascalCase = (str) => str.replace(/[@|/-](\w)/g, (_, $1) => $1.toUpperCase()).replace(/(?:^|-)(\w)/g, (_, $1) => $1.toUpperCase());
 const reveal = (obj, keys) => keys.reduce((acc, key) => {
-  if (typeof acc === "string")
-    throw new Error("key not found in exports");
-  if (!(key in acc))
-    throw new Error(`key ${key} not found in exports`);
+  if (typeof acc === "string") throw new Error("key not found in exports");
+  if (!(key in acc)) throw new Error(`key ${key} not found in exports`);
   return acc[key];
 }, obj);
 const resolveMinifyOptions = (minifyOptions) => typeof minifyOptions === "string" ? { type: minifyOptions } : minifyOptions ?? { type: "esbuild" };
@@ -4676,7 +4664,7 @@ const withMinify = (output, onlyOncePlugins = []) => {
   const minifyPlugin = resolvedMinifyOptions.type === "esbuild" ? import('rollup-plugin-esbuild').then(({ minify: minify2 }) => minify2(noTypeResolvedMinifyOptions)) : resolvedMinifyOptions.type === "swc" ? import('rollup-plugin-swc3').then(({ minify: minify2 }) => minify2(noTypeResolvedMinifyOptions)) : import('@rollup/plugin-terser').then(({ default: minify2 }) => minify2(noTypeResolvedMinifyOptions));
   return minify === "only-minify" ? [{
     ...output,
-    // TODO replace suffix when pubish to npm and the `build.output.minify` is 'only-minify'
+    // TODO replace suffix when publish to npm and the `build.output.minify` is 'only-minify'
     // TODO resolve dts output file name
     entryFileNames: (chunkInfo) => typeof output.entryFileNames === "function" ? output.entryFileNames(chunkInfo) : (() => {
       throw new Error("entryFileNames must be a function");
@@ -4783,15 +4771,39 @@ const generateConfigs = (context, options = {}) => {
   const { js: jsOutput, dts: dtsOutput } = resolveOutputControls(context, build.output);
   const rollupOptions = [];
   const commonPlugins = [
-    nodeResolve({ exportConditions })
+    nodeResolve({
+      exportConditions,
+      extensions: [
+        ".js",
+        ".cjs",
+        ".mjs",
+        ".jsx",
+        ".cjsx",
+        ".mjsx",
+        ".ts",
+        ".cts",
+        ".mts",
+        ".tsx",
+        ".ctsx",
+        ".mtsx"
+      ]
+    })
   ];
   if (jsOutput && !WITHOUT_JS) {
     const sourcemap = typeof options?.output?.sourcemap === "object" ? options.output.sourcemap.js : options?.output?.sourcemap;
+    const features = Object.assign({
+      keepImportAttributes: true
+    }, build.features);
     const builder = resolvedBuilderOptions.type === "esbuild" ? import('rollup-plugin-esbuild').then(
       ({ default: esbuild }) => esbuild({
         sourceMap: sourcemap === "hidden" ? false : !!sourcemap,
         tsconfig: buildTSConfigPath,
-        ...noTypeResolvedBuilderOptions
+        target: "node22",
+        ...noTypeResolvedBuilderOptions,
+        supported: {
+          "import-attributes": features.keepImportAttributes !== false,
+          ...resolvedBuilderOptions.supported
+        }
       })
     ) : import('rollup-plugin-swc3').then(
       ({ default: swc }) => swc({
@@ -4800,7 +4812,14 @@ const generateConfigs = (context, options = {}) => {
           inline: "inline"
         }[sourcemap] ?? void 0,
         tsconfig: buildTSConfigPath,
-        ...noTypeResolvedBuilderOptions
+        ...noTypeResolvedBuilderOptions,
+        jsc: {
+          ...resolvedBuilderOptions.jsc,
+          experimental: {
+            ...resolvedBuilderOptions.jsc?.experimental,
+            keepImportAttributes: features.keepImportAttributes !== false
+          }
+        }
       })
     );
     const [ana, anaOutputPlugin] = bundleAnalyzer((modules) => void publishInEntry("modulesAnalyze", { modules }));
@@ -4819,6 +4838,8 @@ const generateConfigs = (context, options = {}) => {
           sourcemap,
           format,
           strict: typeof options?.output?.strict === "object" ? options.output.strict.js : options?.output?.strict,
+          externalImportAttributes: features.keepImportAttributes !== false,
+          importAttributesKey: features.keepImportAttributes === false || features.keepImportAttributes === void 0 ? void 0 : features.keepImportAttributes === true ? "with" : features.keepImportAttributes,
           plugins: [
             isFormatEsm(format === "esm")
           ]
@@ -4894,10 +4915,8 @@ const generateConfigs = (context, options = {}) => {
 function template(packageJSON) {
   const { name, type, exports: entrypoints } = packageJSON;
   const pkgIsModule = type === "module";
-  if (!name)
-    throw new Error("package.json name is required");
-  if (!entrypoints)
-    throw new Error("package.json exports is required");
+  if (!name) throw new Error("package.json name is required");
+  if (!entrypoints) throw new Error("package.json exports is required");
   const packageName = pascalCase(name);
   const external = externalResolver(packageJSON);
   const [filteredResolvedEntrypoints, exports] = getExports({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jiek",
   "type": "module",
-  "version": "2.2.1",
+  "version": "2.2.3",
   "description": "A lightweight toolkit for compiling and managing libraries based on `package.json` metadata and suitable for `Monorepo`.",
   "author": "YiJie <yijie4188@gmail.com>",
   "homepage": "https://github.com/NWYLZW/jiek/tree/master/packages/jiek#readme",
@@ -48,7 +48,11 @@
     }
   },
   "imports": {
-    "#~/*": "./src/*"
+    "#~/*": [
+      "./src/*",
+      "./src/*/index.ts",
+      "./src/*/index.tsx"
+    ]
   },
   "bin": {
     "jiek": "bin/jiek.js",
@@ -65,7 +69,7 @@
     "rollup-plugin-postcss": "^4.0.2",
     "rollup-plugin-swc3": "^0.12.1",
     "typescript": "^4.0.0||^5.0.0",
-    "vite-bundle-analyzer": "^0.15.2"
+    "vite-bundle-analyzer": "0.16.0-beta.1"
   },
   "dependencies": {
     "@inquirer/prompts": "^7.1.0",
@@ -83,8 +87,8 @@
     "jsonc-parser": "^3.2.1",
     "koa": "^2.15.3",
     "rollup": "^4.0.0",
-    "@jiek/utils": "^0.2.3",
-    "@jiek/pkger": "^0.2.1"
+    "@jiek/pkger": "^0.2.1",
+    "@jiek/utils": "^0.2.3"
   },
   "peerDependenciesMeta": {
     "@pnpm/filter-workspace-packages": {

package/src/commands/build/analyzer.ts

@@ -0,0 +1,122 @@
+import type { Command } from 'commander'
+
+import { CLIENT_CUSTOM_RENDER_SCRIPT } from '#~/commands/build/client/index.ts'
+import { parseBoolean } from '#~/commands/utils/optionParser.ts'
+import type { Module } from '#~/rollup/bundle-analyzer.ts'
+import type { createServer } from '#~/server.ts'
+import { checkDependency } from '#~/utils/checkDependency.ts'
+import { existsSync, mkdirSync, statSync, writeFileSync } from 'node:fs'
+import path from 'node:path'
+
+export interface AnalyzerBuildOptions {
+  ana?: boolean
+  /**
+   * @default '.jk-analyses'
+   */
+  'ana.dir': string
+  /**
+   * @default 'server'
+   */
+  'ana.mode': string
+  'ana.open'?: boolean
+  /**
+   * @default 'parsed'
+   */
+  'ana.size': string
+}
+
+export const registerAnalyzerCommandOptions = (command: Command) =>
+  command
+    .option('--ana', 'Enable the bundle analyzer.', parseBoolean)
+    .option('--ana.dir <DIR>', 'The directory of the bundle analyzer.', '.jk-analyses')
+    .option(
+      '--ana.mode <MODE>',
+      'The mode of the bundle analyzer, support "static", "json" and "server".',
+      'server'
+    )
+    .option('--ana.open', 'Open the bundle analyzer in the browser.', parseBoolean)
+    .option(
+      '--ana.size <SIZE>',
+      'The default size of the bundle analyzer, support "stat", "parsed" and "gzip".',
+      'parsed'
+    )
+
+export const useAnalyzer = async (options: AnalyzerBuildOptions, server?: ReturnType<typeof createServer>) => {
+  const modules: Module[] = []
+  let bundleAnalyzerModule: typeof import('vite-bundle-analyzer') | undefined
+  const analyzer = options.ana
+    ? {
+      dir: options['ana.dir'],
+      mode: options['ana.mode'],
+      open: options['ana.open'],
+      size: options['ana.size']
+    }
+    : undefined
+  if (
+    options.ana
+    && ![
+      'stat',
+      'parsed',
+      'gzip'
+    ].includes(analyzer?.size ?? '')
+  ) {
+    throw new Error('The value of `ana.size` must be "stat", "parsed" or "gzip"')
+  }
+
+  if (analyzer) {
+    await checkDependency('vite-bundle-analyzer')
+    bundleAnalyzerModule = await import('vite-bundle-analyzer')
+  }
+
+  const refreshAnalyzer = async (cwd: string, applyModules: typeof modules) => {
+    if (!(analyzer && server && bundleAnalyzerModule)) return
+
+    if (analyzer.mode === 'json') {
+      const anaDir = path.resolve(cwd, analyzer.dir)
+      if (!existsSync(anaDir)) {
+        mkdirSync(anaDir, { recursive: true })
+      }
+      const gitIgnorePath = path.resolve(anaDir, '.gitignore')
+      if (!existsSync(gitIgnorePath)) {
+        writeFileSync(gitIgnorePath, '*\n!.gitignore\n')
+      }
+      const npmIgnorePath = path.resolve(anaDir, '.npmignore')
+      if (!existsSync(npmIgnorePath)) {
+        writeFileSync(npmIgnorePath, '*\n')
+      }
+      if (!statSync(anaDir).isDirectory()) {
+        throw new Error(`The directory '${anaDir}' is not a directory.`)
+      }
+    }
+
+    const { renderView, injectHTMLTag } = bundleAnalyzerModule
+    applyModules.forEach(m => {
+      const index = modules.findIndex(({ filename }) => filename === m.filename)
+      if (index === -1) {
+        modules.push(m)
+      } else {
+        modules[index] = m
+      }
+    })
+    let html = await renderView(modules, {
+      title: `Jiek Analyzer`,
+      mode: analyzer.size as 'stat' | 'parsed' | 'gzip'
+    })
+    html = injectHTMLTag({
+      html,
+      injectTo: 'body',
+      descriptors: [
+        { kind: 'script', text: CLIENT_CUSTOM_RENDER_SCRIPT }
+      ]
+    })
+    void server.renderTo('/ana', html)
+  }
+
+  return {
+    modules,
+    refreshAnalyzer,
+    ANALYZER_ENV: {
+      JIEK_ANALYZER: analyzer ? JSON.stringify(analyzer) : undefined
+    }
+  }
+}