@modern-js/utils 2.21.1 → 2.22.1-alpha.0

package/dist/constants.d.ts

@@ -0,0 +1,244 @@
+import { InternalPlugins } from '@modern-js/types';
+/**
+ * route specification file
+ */
+
+export declare const ROUTE_SPEC_FILE = "route.json";
+/**
+ * main entry name
+ */
+
+export declare const MAIN_ENTRY_NAME = "main";
+/**
+ * open editor request path
+ */
+
+export declare const LAUNCH_EDITOR_ENDPOINT = "/__open-stack-frame-in-editor";
+/**
+ * server side bundles directory, which relative to dist.
+ */
+
+export declare const SERVER_BUNDLE_DIRECTORY = "bundles";
+/**
+ * server side bundles directory, which relative to dist.
+ */
+
+export declare const SERVER_WORKER_BUNDLE_DIRECTORY = "worker";
+/**
+ * entry name pattern used for ajv pattern properties.
+ */
+
+export declare const ENTRY_NAME_PATTERN = "^[a-zA-Z0-9_-]+$";
+/**
+ * SSR server render function name
+ */
+
+export declare const SERVER_RENDER_FUNCTION_NAME = "serverRender";
+/**
+ * loadbale manifest json file
+ */
+
+export declare const LOADABLE_STATS_FILE = "loadable-stats.json";
+/**
+ * internal specified folder
+ */
+
+export declare const API_DIR = "api";
+export declare const SERVER_DIR = "server";
+export declare const SHARED_DIR = "shared";
+/**
+ * Modern.config.ts cached dir
+ */
+
+export declare const CONFIG_CACHE_DIR = "./node_modules/.cache/node-bundle-require";
+export declare const CONFIG_FILE_EXTENSIONS: string[];
+/**
+ * Serialized config path
+ */
+
+export declare const OUTPUT_CONFIG_FILE = "modern.config.json";
+/**
+ * Default server config basename
+ */
+
+export declare const DEFAULT_SERVER_CONFIG = "modern.server-runtime.config";
+/**
+ * Routes manifest filename
+ */
+
+export declare const ROUTE_MANIFEST_FILE = "routes-manifest.json";
+/**
+ * directory name for loader routes
+ */
+
+export declare const LOADER_ROUTES_DIR = "loader-routes";
+/**
+ * default host for dev
+ */
+
+export declare const DEFAULT_DEV_HOST = "0.0.0.0";
+/**
+ * Internal app-tools plugins that work as soon as they are installed.
+ */
+
+export declare const INTERNAL_APP_TOOLS_PLUGINS: InternalPlugins;
+export declare const INTERNAL_APP_TOOLS_RUNTIME_PLUGINS: InternalPlugins;
+/**
+ * Internal module-tools plugins that work as soon as they are installed.
+ */
+
+export declare const INTERNAL_MODULE_TOOLS_PLUGINS: InternalPlugins;
+/**
+ * Internal monorepo-tools plugins that work as soon as they are installed.
+ */
+
+export declare const INTERNAL_MONOREPO_TOOLS_PLUGINS: InternalPlugins;
+/**
+ * Internal doc-tools plugins that work as soon as they are installed.
+ */
+
+export declare const INTERNAL_DOC_TOOLS_PLUGINS: InternalPlugins;
+/**
+ * Internal plugins that work as soon as they are installed.
+ */
+
+export declare const INTERNAL_CLI_PLUGINS: InternalPlugins;
+export declare const SERVER_PLUGIN_BFF = "@modern-js/plugin-bff";
+export declare const SERVER_PLUGIN_EXPRESS = "@modern-js/plugin-express";
+export declare const SERVER_PLUGIN_EGG = "@modern-js/plugin-egg";
+export declare const SERVER_PLUGIN_KOA = "@modern-js/plugin-koa";
+export declare const SERVER_PLUGIN_NEST = "@modern-js/plugin-nest";
+export declare const SERVER_PLUGIN_SERVER = "@modern-js/plugin-server";
+export declare const SERVER_PLUGIN_POLYFILL = "@modern-js/plugin-polyfill";
+export declare const INTERNAL_SERVER_PLUGINS: InternalPlugins;
+/**
+ * The schema registered in the plugin.
+ */
+
+export declare const PLUGIN_SCHEMAS: {
+  '@modern-js/runtime': ({
+    target: string;
+    schema: {
+      type: string;
+      additionalProperties: boolean;
+      patternProperties?: undefined;
+    };
+  } | {
+    target: string;
+    schema: {
+      type: string;
+      patternProperties: {
+        "^[a-zA-Z0-9_-]+$": {
+          type: string;
+        };
+      };
+      additionalProperties: boolean;
+    };
+  })[];
+  '@modern-js/plugin-swc': {
+    target: string;
+    schema: {
+      typeof: string[];
+    };
+  }[];
+  '@modern-js/plugin-bff': {
+    target: string;
+    schema: {
+      type: string;
+      properties: {
+        prefix: {
+          type: string[];
+          items: {
+            type: string;
+          };
+        };
+        fetcher: {
+          type: string;
+        };
+        proxy: {
+          type: string;
+        };
+        requestCreator: {
+          type: string;
+        };
+      };
+    };
+  }[];
+  '@modern-js/plugin-tailwindcss': {
+    target: string;
+    schema: {
+      typeof: string[];
+    };
+  }[];
+  '@modern-js/plugin-proxy': {
+    target: string;
+    schema: {
+      typeof: string[];
+    };
+  }[];
+  '@modern-js/plugin-ssg': {
+    target: string;
+    schema: {
+      oneOf: ({
+        type: string;
+        instanceof?: undefined;
+      } | {
+        instanceof: string;
+        type?: undefined;
+      })[];
+    };
+  }[];
+  '@modern-js/plugin-state': {
+    target: string;
+    schema: {
+      type: string[];
+    };
+  }[];
+  '@modern-js/plugin-design-token': ({
+    target: string;
+    schema: {
+      typeof: string[];
+      type?: undefined;
+    };
+  } | {
+    target: string;
+    schema: {
+      type: string[];
+      typeof?: undefined;
+    };
+  })[];
+  '@modern-js/plugin-router': {
+    target: string;
+    schema: {
+      type: string[];
+    };
+  }[];
+  '@modern-js/plugin-testing': {
+    target: string;
+    schema: {
+      typeof: string[];
+    };
+  }[];
+  '@modern-js/plugin-garfish': {
+    target: string;
+    schema: {
+      type: string[];
+    };
+  }[];
+  '@modern-js/plugin-nocode': never[];
+};
+/**
+ * The `@babel/preset-typescript` default options.
+ *
+ * for:
+ * - `@modern-js/builder-rspack-provider`
+ * - `@modern-js/babel-preset-base`
+ */
+
+export declare const DEFAULT_BABEL_PRESET_TYPESCRIPT_OPTIONS: {
+  allowNamespaces: boolean;
+  allExtensions: boolean;
+  allowDeclareFields: boolean;
+  optimizeConstEnums: boolean;
+  isTSX: boolean;
+};

package/dist/constants.js

@@ -0,0 +1,320 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var constants_exports = {};
+__export(constants_exports, {
+  API_DIR: () => API_DIR,
+  CONFIG_CACHE_DIR: () => CONFIG_CACHE_DIR,
+  CONFIG_FILE_EXTENSIONS: () => CONFIG_FILE_EXTENSIONS,
+  DEFAULT_BABEL_PRESET_TYPESCRIPT_OPTIONS: () => DEFAULT_BABEL_PRESET_TYPESCRIPT_OPTIONS,
+  DEFAULT_DEV_HOST: () => DEFAULT_DEV_HOST,
+  DEFAULT_SERVER_CONFIG: () => DEFAULT_SERVER_CONFIG,
+  ENTRY_NAME_PATTERN: () => ENTRY_NAME_PATTERN,
+  INTERNAL_APP_TOOLS_PLUGINS: () => INTERNAL_APP_TOOLS_PLUGINS,
+  INTERNAL_APP_TOOLS_RUNTIME_PLUGINS: () => INTERNAL_APP_TOOLS_RUNTIME_PLUGINS,
+  INTERNAL_CLI_PLUGINS: () => INTERNAL_CLI_PLUGINS,
+  INTERNAL_DOC_TOOLS_PLUGINS: () => INTERNAL_DOC_TOOLS_PLUGINS,
+  INTERNAL_MODULE_TOOLS_PLUGINS: () => INTERNAL_MODULE_TOOLS_PLUGINS,
+  INTERNAL_MONOREPO_TOOLS_PLUGINS: () => INTERNAL_MONOREPO_TOOLS_PLUGINS,
+  INTERNAL_SERVER_PLUGINS: () => INTERNAL_SERVER_PLUGINS,
+  LAUNCH_EDITOR_ENDPOINT: () => LAUNCH_EDITOR_ENDPOINT,
+  LOADABLE_STATS_FILE: () => LOADABLE_STATS_FILE,
+  LOADER_ROUTES_DIR: () => LOADER_ROUTES_DIR,
+  MAIN_ENTRY_NAME: () => MAIN_ENTRY_NAME,
+  OUTPUT_CONFIG_FILE: () => OUTPUT_CONFIG_FILE,
+  PLUGIN_SCHEMAS: () => PLUGIN_SCHEMAS,
+  ROUTE_MANIFEST_FILE: () => ROUTE_MANIFEST_FILE,
+  ROUTE_SPEC_FILE: () => ROUTE_SPEC_FILE,
+  SERVER_BUNDLE_DIRECTORY: () => SERVER_BUNDLE_DIRECTORY,
+  SERVER_DIR: () => SERVER_DIR,
+  SERVER_PLUGIN_BFF: () => SERVER_PLUGIN_BFF,
+  SERVER_PLUGIN_EGG: () => SERVER_PLUGIN_EGG,
+  SERVER_PLUGIN_EXPRESS: () => SERVER_PLUGIN_EXPRESS,
+  SERVER_PLUGIN_KOA: () => SERVER_PLUGIN_KOA,
+  SERVER_PLUGIN_NEST: () => SERVER_PLUGIN_NEST,
+  SERVER_PLUGIN_POLYFILL: () => SERVER_PLUGIN_POLYFILL,
+  SERVER_PLUGIN_SERVER: () => SERVER_PLUGIN_SERVER,
+  SERVER_RENDER_FUNCTION_NAME: () => SERVER_RENDER_FUNCTION_NAME,
+  SERVER_WORKER_BUNDLE_DIRECTORY: () => SERVER_WORKER_BUNDLE_DIRECTORY,
+  SHARED_DIR: () => SHARED_DIR
+});
+module.exports = __toCommonJS(constants_exports);
+const ROUTE_SPEC_FILE = "route.json";
+const MAIN_ENTRY_NAME = "main";
+const LAUNCH_EDITOR_ENDPOINT = "/__open-stack-frame-in-editor";
+const SERVER_BUNDLE_DIRECTORY = "bundles";
+const SERVER_WORKER_BUNDLE_DIRECTORY = "worker";
+const ENTRY_NAME_PATTERN = "^[a-zA-Z0-9_-]+$";
+const SERVER_RENDER_FUNCTION_NAME = "serverRender";
+const LOADABLE_STATS_FILE = "loadable-stats.json";
+const API_DIR = "api";
+const SERVER_DIR = "server";
+const SHARED_DIR = "shared";
+const CONFIG_CACHE_DIR = "./node_modules/.cache/node-bundle-require";
+const CONFIG_FILE_EXTENSIONS = [".js", ".ts", ".mjs"];
+const OUTPUT_CONFIG_FILE = "modern.config.json";
+const DEFAULT_SERVER_CONFIG = "modern.server-runtime.config";
+const ROUTE_MANIFEST_FILE = "routes-manifest.json";
+const LOADER_ROUTES_DIR = `loader-routes`;
+const DEFAULT_DEV_HOST = "0.0.0.0";
+const INTERNAL_APP_TOOLS_PLUGINS = {
+  "@modern-js/app-tools": "@modern-js/app-tools/cli",
+  "@modern-js/plugin-proxy": "@modern-js/plugin-proxy/cli",
+  "@modern-js/plugin-ssg": "@modern-js/plugin-ssg/cli",
+  "@modern-js/plugin-bff": "@modern-js/plugin-bff/cli",
+  "@modern-js/plugin-testing": "@modern-js/plugin-testing/cli",
+  "@modern-js/plugin-storybook": "@modern-js/plugin-storybook/cli",
+  "@modern-js/plugin-express": "@modern-js/plugin-express/cli",
+  "@modern-js/plugin-egg": "@modern-js/plugin-egg/cli",
+  "@modern-js/plugin-koa": "@modern-js/plugin-koa/cli",
+  "@modern-js/plugin-nest": "@modern-js/plugin-nest/cli",
+  "@modern-js/plugin-server": "@modern-js/plugin-server/cli",
+  "@modern-js/plugin-garfish": "@modern-js/plugin-garfish/cli",
+  "@modern-js/plugin-tailwindcss": "@modern-js/plugin-tailwindcss/cli",
+  "@modern-js/plugin-polyfill": "@modern-js/plugin-polyfill/cli",
+  // legacy router (inner react-router-dom v5)
+  "@modern-js/plugin-router-v5": "@modern-js/plugin-router-v5/cli"
+};
+const INTERNAL_APP_TOOLS_RUNTIME_PLUGINS = {
+  "@modern-js/runtime": "@modern-js/runtime/cli"
+};
+const INTERNAL_MODULE_TOOLS_PLUGINS = {
+  "@modern-js/module-tools": "@modern-js/module-tools",
+  "@modern-js/doc-tools": "@modern-js/doc-tools",
+  "@modern-js/runtime": "@modern-js/runtime/cli",
+  "@modern-js/plugin-testing": "@modern-js/plugin-testing/cli",
+  "@modern-js/plugin-storybook": "@modern-js/plugin-storybook/cli",
+  "@modern-js/plugin-tailwindcss": "@modern-js/plugin-tailwindcss/cli",
+  // TODO: Maybe can remove it
+  "@modern-js/plugin-nocode": "@modern-js/plugin-nocode/cli",
+  // legacy router (inner react-router-dom v5)
+  "@modern-js/plugin-router-legacy": "@modern-js/plugin-router-legacy/cli"
+};
+const INTERNAL_MONOREPO_TOOLS_PLUGINS = {
+  "@modern-js/monorepo-tools": "@modern-js/monorepo-tools/cli",
+  "@modern-js/plugin-testing": "@modern-js/plugin-testing/cli"
+};
+const INTERNAL_DOC_TOOLS_PLUGINS = {
+  "@modern-js/doc-tools": "@modern-js/doc-tools",
+  "@modern-js/runtime": "@modern-js/runtime/cli",
+  "@modern-js/plugin-testing": "@modern-js/plugin-testing/cli"
+};
+const INTERNAL_CLI_PLUGINS = {
+  "@modern-js/app-tools": "@modern-js/app-tools/cli",
+  "@modern-js/monorepo-tools": "@modern-js/monorepo-tools/cli",
+  "@modern-js/module-tools": "@modern-js/module-tools",
+  "@modern-js/doc-tools": "@modern-js/doc-tools",
+  "@modern-js/runtime": "@modern-js/runtime/cli",
+  "@modern-js/plugin-proxy": "@modern-js/plugin-proxy/cli",
+  "@modern-js/plugin-ssg": "@modern-js/plugin-ssg/cli",
+  "@modern-js/plugin-bff": "@modern-js/plugin-bff/cli",
+  "@modern-js/plugin-testing": "@modern-js/plugin-testing/cli",
+  "@modern-js/plugin-storybook": "@modern-js/plugin-storybook/cli",
+  "@modern-js/plugin-express": "@modern-js/plugin-express/cli",
+  "@modern-js/plugin-egg": "@modern-js/plugin-egg/cli",
+  "@modern-js/plugin-koa": "@modern-js/plugin-koa/cli",
+  "@modern-js/plugin-nest": "@modern-js/plugin-nest/cli",
+  "@modern-js/plugin-server": "@modern-js/plugin-server/cli",
+  "@modern-js/plugin-swc": "@modern-js/plugin-swc",
+  "@modern-js/plugin-garfish": "@modern-js/plugin-garfish/cli",
+  "@modern-js/plugin-tailwindcss": "@modern-js/plugin-tailwindcss/cli",
+  "@modern-js/plugin-polyfill": "@modern-js/plugin-polyfill/cli",
+  // TODO: Maybe can remove it
+  "@modern-js/plugin-nocode": "@modern-js/plugin-nocode/cli",
+  // legacy router (inner react-router-dom v5)
+  "@modern-js/plugin-router-v5": "@modern-js/plugin-router-v5/cli"
+};
+const SERVER_PLUGIN_BFF = "@modern-js/plugin-bff";
+const SERVER_PLUGIN_EXPRESS = "@modern-js/plugin-express";
+const SERVER_PLUGIN_EGG = "@modern-js/plugin-egg";
+const SERVER_PLUGIN_KOA = "@modern-js/plugin-koa";
+const SERVER_PLUGIN_NEST = "@modern-js/plugin-nest";
+const SERVER_PLUGIN_SERVER = "@modern-js/plugin-server";
+const SERVER_PLUGIN_POLYFILL = "@modern-js/plugin-polyfill";
+const INTERNAL_SERVER_PLUGINS = {
+  [SERVER_PLUGIN_BFF]: "@modern-js/plugin-bff/server",
+  [SERVER_PLUGIN_EXPRESS]: "@modern-js/plugin-express/server",
+  [SERVER_PLUGIN_EGG]: "@modern-js/plugin-egg/server",
+  [SERVER_PLUGIN_KOA]: "@modern-js/plugin-koa/server",
+  [SERVER_PLUGIN_NEST]: "@modern-js/plugin-nest/server",
+  [SERVER_PLUGIN_SERVER]: "@modern-js/plugin-server/server",
+  [SERVER_PLUGIN_POLYFILL]: "@modern-js/plugin-polyfill/server"
+};
+const PLUGIN_SCHEMAS = {
+  "@modern-js/runtime": [
+    {
+      target: "runtime",
+      schema: {
+        type: "object",
+        additionalProperties: false
+      }
+    },
+    {
+      target: "runtimeByEntries",
+      schema: {
+        type: "object",
+        patternProperties: { [ENTRY_NAME_PATTERN]: { type: "object" } },
+        additionalProperties: false
+      }
+    }
+  ],
+  "@modern-js/plugin-swc": [
+    {
+      target: "tools.swc",
+      schema: { typeof: ["object"] }
+    }
+  ],
+  "@modern-js/plugin-bff": [
+    {
+      target: "bff",
+      schema: {
+        type: "object",
+        properties: {
+          prefix: {
+            type: ["string", "array"],
+            items: { type: "string" }
+          },
+          fetcher: { type: "string" },
+          proxy: { type: "object" },
+          requestCreator: { type: "string" }
+        }
+      }
+    }
+  ],
+  "@modern-js/plugin-tailwindcss": [
+    {
+      target: "tools.tailwindcss",
+      schema: { typeof: ["object", "function"] }
+    }
+  ],
+  "@modern-js/plugin-proxy": [
+    {
+      target: "dev.proxy",
+      schema: { typeof: ["string", "object"] }
+    }
+  ],
+  "@modern-js/plugin-ssg": [
+    {
+      target: "output.ssg",
+      schema: {
+        oneOf: [
+          { type: "boolean" },
+          { type: "object" },
+          { instanceof: "Function" }
+        ]
+      }
+    }
+  ],
+  "@modern-js/plugin-state": [
+    {
+      target: "runtime.state",
+      schema: { type: ["boolean", "object"] }
+    }
+  ],
+  "@modern-js/plugin-design-token": [
+    // Legacy Features
+    {
+      target: "source.designSystem",
+      schema: { typeof: ["object"] }
+    },
+    {
+      target: "source.designSystem.supportStyledComponents",
+      schema: { type: ["boolean"] }
+    },
+    {
+      target: "designSystem",
+      schema: { typeof: ["object"] }
+    }
+  ],
+  "@modern-js/plugin-router": [
+    {
+      target: "runtime.router",
+      schema: { type: ["boolean", "object"] }
+    }
+  ],
+  "@modern-js/plugin-testing": [
+    {
+      target: "testing",
+      schema: { typeof: ["object"] }
+    },
+    {
+      target: "tools.jest",
+      schema: { typeof: ["object", "function"] }
+    }
+  ],
+  "@modern-js/plugin-garfish": [
+    {
+      target: "runtime.masterApp",
+      schema: { type: ["boolean", "object"] }
+    },
+    {
+      target: "dev.withMasterApp",
+      schema: { type: ["object"] }
+    },
+    {
+      target: "deploy.microFrontend",
+      schema: { type: ["boolean", "object"] }
+    }
+  ],
+  "@modern-js/plugin-nocode": []
+};
+const DEFAULT_BABEL_PRESET_TYPESCRIPT_OPTIONS = {
+  allowNamespaces: true,
+  allExtensions: true,
+  allowDeclareFields: true,
+  // aligns Babel's behavior with TypeScript's default behavior.
+  // https://babeljs.io/docs/en/babel-preset-typescript#optimizeconstenums
+  optimizeConstEnums: true,
+  isTSX: true
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  API_DIR,
+  CONFIG_CACHE_DIR,
+  CONFIG_FILE_EXTENSIONS,
+  DEFAULT_BABEL_PRESET_TYPESCRIPT_OPTIONS,
+  DEFAULT_DEV_HOST,
+  DEFAULT_SERVER_CONFIG,
+  ENTRY_NAME_PATTERN,
+  INTERNAL_APP_TOOLS_PLUGINS,
+  INTERNAL_APP_TOOLS_RUNTIME_PLUGINS,
+  INTERNAL_CLI_PLUGINS,
+  INTERNAL_DOC_TOOLS_PLUGINS,
+  INTERNAL_MODULE_TOOLS_PLUGINS,
+  INTERNAL_MONOREPO_TOOLS_PLUGINS,
+  INTERNAL_SERVER_PLUGINS,
+  LAUNCH_EDITOR_ENDPOINT,
+  LOADABLE_STATS_FILE,
+  LOADER_ROUTES_DIR,
+  MAIN_ENTRY_NAME,
+  OUTPUT_CONFIG_FILE,
+  PLUGIN_SCHEMAS,
+  ROUTE_MANIFEST_FILE,
+  ROUTE_SPEC_FILE,
+  SERVER_BUNDLE_DIRECTORY,
+  SERVER_DIR,
+  SERVER_PLUGIN_BFF,
+  SERVER_PLUGIN_EGG,
+  SERVER_PLUGIN_EXPRESS,
+  SERVER_PLUGIN_KOA,
+  SERVER_PLUGIN_NEST,
+  SERVER_PLUGIN_POLYFILL,
+  SERVER_PLUGIN_SERVER,
+  SERVER_RENDER_FUNCTION_NAME,
+  SERVER_WORKER_BUNDLE_DIRECTORY,
+  SHARED_DIR
+});

package/dist/debug.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Create debug function with unified namespace prefix.
+ * @param scope - Custom module name of your debug function.
+ * @returns Debug function which namespace start with modern-js:.
+ */
+export declare const createDebugger: (scope: string) => import("../compiled/debug").Debugger;

package/dist/debug.js

@@ -0,0 +1,28 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var debug_exports = {};
+__export(debug_exports, {
+  createDebugger: () => createDebugger
+});
+module.exports = __toCommonJS(debug_exports);
+var import_debug = require("../compiled/debug");
+const createDebugger = (scope) => (0, import_debug.debug)(`modern-js:${scope}`);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createDebugger
+});

package/dist/emptyDir.d.ts

@@ -0,0 +1 @@
+export declare const emptyDir: (dir: string) => Promise<void>;

package/dist/emptyDir.js

@@ -0,0 +1,52 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+var emptyDir_exports = {};
+__export(emptyDir_exports, {
+  emptyDir: () => emptyDir
+});
+module.exports = __toCommonJS(emptyDir_exports);
+var import_compiled = require("./compiled");
+const emptyDir = (dir) => __async(void 0, null, function* () {
+  if (yield import_compiled.fs.pathExists(dir)) {
+    yield import_compiled.fs.emptyDir(dir);
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  emptyDir
+});

package/dist/ensureAbsolutePath.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ensure absolute file path.
+ * @param base - Base path to resolve relative from.
+ * @param filePath - Absolute or relative file path.
+ * @returns Resolved absolute file path.
+ */
+export declare const ensureAbsolutePath: (base: string, filePath: string) => string;