@yannick-z/modulo 0.2.0 → 0.3.1

package/src/args/cmd.ts

@@ -1,16 +0,0 @@
-import type minimist from "minimist";
-import { PANIC_IF } from "../tools/panic.ts";
-
-// 命令
-export function get_cmd(argv: minimist.ParsedArgs) {
-  const cmd_list = ["build", "dev", "init"] as const;
-  const cmd = argv._[0] as (typeof cmd_list)[number];
-  PANIC_IF(
-    !cmd_list.includes(cmd),
-    `modulo必须执行 ${cmd_list.join(" 或 ")} 命令`
-  );
-  return cmd;
-}
-
-export type ModuloCmd_Pack = "build" | "dev";
-export type ModuloCmd_Init = "init";

package/src/args/mode.ts

@@ -1,38 +0,0 @@
-import type minimist from "minimist";
-import picocolors from "picocolors";
-import { PANIC_IF } from "../tools/panic.ts";
-
-const mode_list = ["dev", "development", "prd", "production"];
-
-export function get_env(argv: minimist.ParsedArgs, cmd: "dev" | "build") {
-  // mode参数
-  let env = "" as "dev" | "prd";
-  if (argv.env) {
-    if (argv.env === "dev" || argv.env === "development") {
-      env = "dev";
-    } else if (argv.env === "prd" || argv.env === "production") {
-      env = "prd";
-    } else {
-      PANIC_IF(true, `env参数只能为 ${mode_list.join(" 或 ")}`);
-    }
-    console.log(picocolors.blue(`env = ${env}`));
-  } else if (cmd === "build" || cmd === "dev") {
-    if (process.env.NODE_ENV) {
-      env = process.env.NODE_ENV === "production" ? "prd" : "dev";
-      console.log(
-        picocolors.yellow("\n未设置env，将根据process.env.NODE_ENV自动设置\n"),
-        picocolors.yellow(
-          `process.env.NODE_ENV = ${process.env.NODE_ENV}, env = ${env}`
-        )
-      );
-    } else {
-      env = cmd === "build" ? "prd" : "dev";
-      console.log(
-        picocolors.yellow("\n未设置env，将根据build或dev命令自动设置\n"),
-        picocolors.yellow(`cmd = ${cmd}, env = ${env}`)
-      );
-    }
-  }
-
-  return env;
-}

package/src/args/node_env.ts

@@ -1,15 +0,0 @@
-import picocolors from 'picocolors';
-
-export function set_node_env(mode: 'dev' | 'prd') {
-  /**
-   * 保证process.env.NODE_ENV有值
-   */
-  const _node_env = mode === 'dev' ? 'development' : 'production';
-  if (process.env.NODE_ENV !== _node_env) {
-    console.log(
-      picocolors.yellow('\nprocess.env.NODE_ENV 与 mode 不一致, 将被强制设置为与mode匹配的值\n'),
-      picocolors.yellow(`mode = ${mode}, process.env.NODE_ENV = ${_node_env}\n`),
-    );
-    process.env.NODE_ENV = _node_env;
-  }
-}

package/src/args/target.ts

@@ -1,44 +0,0 @@
-import type minimist from "minimist";
-import { PANIC_IF } from "../tools/panic.ts";
-import type { ModuloCmd_Init, ModuloCmd_Pack } from "./cmd";
-
-const pack_options = {
-  page: "构建页面",
-  module: "构建模块",
-  all: "页面和模块",
-};
-const init_options = {
-  config: "modulo的配置文件",
-  script: "package.json中modulo的启动命令",
-};
-const options = {
-  build: pack_options,
-  dev: {
-    page: pack_options.page,
-    module: pack_options.module,
-  },
-  init: init_options,
-};
-
-export type ModuloTarget_Pack = keyof typeof pack_options;
-export type ModuloTarget_Init = keyof typeof init_options;
-
-export function get_cmd_target<T extends ModuloCmd_Pack | ModuloCmd_Init>(
-  argv: minimist.ParsedArgs,
-  cmd: T
-) {
-  const target = argv._[1];
-
-  const target_list = options[cmd];
-
-  PANIC_IF(
-    !(target in target_list),
-    `modulo ${cmd} 命令必须执行 ${Object.entries(target_list).map(
-      ([k, v]) => `\n${k} - ${v}`
-    )} 几种目标`
-  );
-
-  return target as T extends ModuloCmd_Init
-    ? ModuloTarget_Init
-    : ModuloTarget_Pack;
-}

package/src/config/externals.ts

@@ -1,70 +0,0 @@
-import { is_record, is_string } from "../type/guard.ts";
-
-export interface UmdExternalUrl {
-  umd: string;
-}
-
-export interface EsmExternalUrl {
-  esm: string;
-}
-
-export function is_umd_url(data: unknown): data is UmdExternalUrl {
-  return is_record(data) && is_string(data.umd);
-}
-
-export function is_esm_url(data: unknown): data is EsmExternalUrl {
-  return is_record(data) && is_string(data.esm);
-}
-
-export type ModuleTypedExternalUrl = UmdExternalUrl | EsmExternalUrl;
-
-export function is_module_typed_external_url(
-  data: unknown
-): data is ModuleTypedExternalUrl {
-  return is_umd_url(data) || is_esm_url(data);
-}
-
-export interface EnvExternalUrl {
-  dev: ModuleTypedExternalUrl | string;
-  prd: ModuleTypedExternalUrl | string;
-}
-
-export function is_env_external(data: unknown): data is EnvExternalUrl {
-  return (
-    is_record(data) &&
-    (is_string(data.dev) || is_module_typed_external_url(data.dev)) &&
-    (is_string(data.prd) || is_module_typed_external_url(data.prd))
-  );
-}
-
-export type ConfigExternalUrl =
-  | ModuleTypedExternalUrl
-  | EnvExternalUrl
-  | string;
-
-export interface ImportExternal {
-  url: ConfigExternalUrl;
-  importName?: string | string[];
-  preset?: string;
-}
-
-export function is_url_config(data: unknown): data is ConfigExternalUrl {
-  return (
-    is_module_typed_external_url(data) ||
-    is_env_external(data) ||
-    is_string(data)
-  );
-}
-
-export function is_import_external(data: unknown): data is ImportExternal {
-  // 没有global的一概作为import的依赖
-  return is_record(data) && is_url_config(data.url) && !is_string(data.global);
-}
-
-export type ExternalLibs = {
-  [name: string]:
-    | ImportExternal
-    | ModuleTypedExternalUrl
-    | EnvExternalUrl
-    | string;
-};

package/src/config/generate_config.ts

@@ -1,105 +0,0 @@
-import { resolve } from "node:path";
-import { cwd } from "node:process";
-import type { ModuloArgs_Pack } from "../args/index.ts";
-import { debug_log } from "../tools/debug-log.ts";
-import { resolve_and_read } from "../tools/file.ts";
-import { jsonparse } from "../tools/json.ts";
-import { merge_user_config } from "../tools/merge-user-config.ts";
-import { PANIC_IF } from "../tools/panic.ts";
-import { preset_config } from "./preset/index.ts";
-import { preset_minify_config } from "./preset/minify.ts";
-import type { GLOBAL_CONFIG, USER_CONFIG } from "./type.ts";
-/**
- * 命令启动时候的目录作为根目录
- */
-export const root = cwd();
-let global_config: GLOBAL_CONFIG;
-
-export function get_global_config(args: ModuloArgs_Pack): GLOBAL_CONFIG {
-  if (!global_config) {
-    /**
-     * 读取配置文件
-     */
-
-    // biome-ignore lint/style/noNonNullAssertion: <有panic保护>
-    const user_config = jsonparse<USER_CONFIG>(
-      resolve_and_read(root, args.pack.config)
-    )!;
-    PANIC_IF(!user_config, "根目录下没有配置文件");
-    debug_log("input user config", user_config);
-
-    /**
-     * 将配置文件和默认配置合并
-     */
-    merge_user_config(preset_config, user_config);
-    const _config: GLOBAL_CONFIG = preset_config;
-
-    /**
-     * src目录
-     */
-    const src = resolve(root, _config.input.src);
-    const input = {
-      modules: resolve(src, _config.input.modules),
-      pages: resolve(src, _config.input.pages),
-      src: src,
-    };
-
-    /**
-     * dist目录
-     */
-    const dist = resolve(root, _config.output.dist);
-    const output = {
-      ..._config.output,
-      dist: dist,
-      modules: resolve(dist, _config.output.modules),
-      pages: resolve(dist, _config.output.pages),
-    };
-
-    /**
-     * 允许定制template
-     */
-    const html = _config.html?.template
-      ? { ..._config.html, template: resolve(root, _config.html.template) }
-      : _config.html;
-
-    /**
-     * 所有define的值都序列化以正确传入
-     */
-    const define = Object.fromEntries(
-      Object.entries({
-        ..._config.define,
-        "process.env.NODE_ENV": process.env.NODE_ENV,
-        "import.meta.env.MOUNT_ID": _config.html.root,
-      }).map(([k, v]) => [k, JSON.stringify(v)])
-    );
-    debug_log("当前模式", process.env.NODE_ENV);
-
-    /**
-     * minify代码的开关
-     */
-    const minify =
-      _config.minify === true ? preset_minify_config : _config.minify;
-
-    /**
-     * alias 允许使用{src}作为占位符，取值来自input.src
-     */
-    const alias = Object.fromEntries(
-      Object.entries(_config.alias).map(([k, v]) => [
-        k,
-        v.replace("{input.src}", input.src),
-      ])
-    );
-
-    global_config = {
-      ..._config,
-      define,
-      html,
-      input,
-      minify,
-      output,
-      alias,
-    };
-    debug_log("global config", global_config);
-  }
-  return global_config;
-}

package/src/config/preset/alias.ts

@@ -1,3 +0,0 @@
-export const preset_alias: Record<string, string> = {
-  "@": "{input.src}",
-};

package/src/config/preset/dev-server.ts

@@ -1,6 +0,0 @@
-export const preset_dev_server_config = {
-  open: false as false | string[], // dev时是否自动打开指定页面
-  port: 8080, // 开发页面时, dev-server服务器端口
-  proxy: {} as Record<string, string | { target: string; pathRewrite?: Record<string, string> }>, // dev时的代理配置
-};
-export type DEV_SERVER_CONFIG = typeof preset_dev_server_config;

package/src/config/preset/dirs.ts

@@ -1,12 +0,0 @@
-export const preset_input_dirs = {
-  src: "src", // 源码目录
-  pages: "pages", // 页面目录
-  modules: "modules", // 组件目录
-};
-
-export const preset_output_dirs = {
-  dist: "dist", // 源码目录
-  pages: "", // 页面目录输出目录，默认使用dist/..
-  modules: "modules", // 组件输出目录，默认使用dist/modules/..
-  filenameHash: true,
-};

package/src/config/preset/html.ts

@@ -1,19 +0,0 @@
-export interface Tag {
-  append?: boolean;
-  attrs?: Record<string, string>;
-  children?: string;
-  hash?: boolean | string;
-  head?: boolean;
-  publicPath?: string | boolean;
-  tag: string;
-}
-
-export const default_html_config = {
-  meta: {} as Record<string, string>,
-  root: '', // html挂载点id, 只允许id
-  tags: [] as Tag[],
-  template: '', // html模板的路径
-  title: '', // html标题
-};
-
-export type HTML_CONFIG = typeof default_html_config;

package/src/config/preset/index.ts

@@ -1,23 +0,0 @@
-import type { OutputConfig } from "@rsbuild/core";
-import { preset_alias } from "./alias.ts";
-import { preset_dev_server_config } from "./dev-server.ts";
-import { preset_input_dirs, preset_output_dirs } from "./dirs.ts";
-import { default_html_config } from "./html.ts";
-import { preset_ui_libs } from "./libs.ts";
-import { preset_minify_config } from "./minify.ts";
-import { preset_url_config } from "./url.ts";
-import type { ExternalLibs } from "../externals.ts";
-
-export const preset_config = {
-  analyze: false, // 是否执行bundleAnalyze
-  define: {} as Record<string, string | boolean | number>, // 配置全局变量，用于打包时替换代码中的全局变量
-  dev_server: preset_dev_server_config,
-  externals: {} as ExternalLibs,
-  html: default_html_config,
-  input: preset_input_dirs,
-  minify: preset_minify_config as OutputConfig["minify"], // 是否压缩产物，同时进行mangle
-  output: preset_output_dirs,
-  ui_lib: preset_ui_libs,
-  url: preset_url_config,
-  alias: preset_alias,
-};

package/src/config/preset/libs.ts

@@ -1,5 +0,0 @@
-export const preset_ui_libs = {
-  // 对ui库做严格的版本限制，以提高统一程度
-  react: '17.0.2',
-  vue: '2.7.16',
-};

package/src/config/preset/minify.ts

@@ -1,24 +0,0 @@
-import type { OutputConfig } from "@rsbuild/core";
-
-export const preset_minify_config: OutputConfig["minify"] = {
-  js: true,
-  jsOptions: {
-    minimizerOptions: {
-      compress: {
-        dead_code: true,
-        defaults: false,
-        toplevel: true,
-        unused: true,
-      },
-      format: {
-        comments: "some",
-        ecma: 2015,
-        preserve_annotations: true,
-        safari10: true,
-        semicolons: false,
-      },
-      mangle: true,
-      minify: true,
-    },
-  },
-};

package/src/config/preset/url.ts

@@ -1,4 +0,0 @@
-export const preset_url_config = {
-  base: '/', // 前缀路径
-  cdn: '', // 可以将除了html资源以外的资源都部署到cdn上，比如https://cdn.host.com/，或者https://cdn.host.com/cdn-path/
-};

package/src/tools/debug-log.ts

@@ -1,37 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import picocolors from "picocolors";
-import { argv_debug, argv_verbose } from "../args/index.ts";
-
-const logFile = path.join(process.cwd(), "modulo.debug.log");
-let index = 0;
-
-let debug_log_function: (hint: string, ...params: any) => void;
-
-export function debug_log(_hint: string, ..._params: any) {
-  if (!debug_log_function) {
-    debug_log_function = (hint: string, ...params: any) => {
-      if (argv_debug || argv_verbose) {
-        const timestamp = new Date().toISOString();
-        const sn = String(index++).padStart(3, "0");
-        const logEntry = `--------------\n${sn} [${timestamp}] ${hint}\n${params
-          .map((p: unknown) =>
-            typeof p === "object" ? JSON.stringify(p, null, 2) : String(p)
-          )
-          .join("\n")}\n---------------\n\n`;
-
-        if (argv_verbose) {
-          console.log(logEntry);
-        }
-
-        if (argv_debug) {
-          // 打印序列号方便debug
-          console.log(picocolors.blue(`\ndebug log ${sn}`));
-
-          fs.appendFileSync(logFile, logEntry);
-        }
-      }
-    };
-  }
-  debug_log_function(_hint, ..._params);
-}