@bleedingdev/modern-js-utils 3.2.0-ultramodern.0

package/dist/types/universal/constants.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Property mounted on window that describes route manifest
+ */
+export declare const ROUTE_MANIFEST = "_MODERNJS_ROUTE_MANIFEST";
+/**
+ * Property mounted on window that record all route modules
+ */
+export declare const ROUTE_MODULES = "_routeModules";
+/**
+ * html placeholder
+ */
+export declare const HTML_CHUNKSMAP_SEPARATOR = "<!--<?- chunksMap.js ?>-->";
+/**
+ * reporter name for server loader
+ */
+export declare const LOADER_REPORTER_NAME = "server-loader";
+/**
+ * route specification file
+ */
+export declare const ROUTE_SPEC_FILE = "route.json";
+/**
+ * Front-end routing metadata
+ */
+export declare const NESTED_ROUTE_SPEC_FILE = "nestedRoutes.json";
+/**
+ * main entry name
+ */
+export declare const MAIN_ENTRY_NAME = "main";
+/**
+ * default entry name
+ */
+export declare const DEFAULT_ENTRY_NAME = "index";
+/**
+ * server side bundles directory, which relative to dist.
+ */
+export declare const SERVER_BUNDLE_DIRECTORY = "bundles";
+/**
+ * SSR server render function name
+ */
+export declare const SERVER_RENDER_FUNCTION_NAME = "serverRender";
+export declare const SERVER_PLUGIN_BFF = "@modern-js/plugin-bff";
+export declare const SERVER_PLUGIN_POLYFILL = "@modern-js/plugin-polyfill";
+/**
+ * React useId identifier prefix for SSR hydration consistency
+ * Ensures server and client generate the same ID prefixes
+ */
+export declare const SSR_HYDRATION_ID_PREFIX = "modern-js-";

package/dist/types/universal/index.d.ts

@@ -0,0 +1 @@
+export { cutNameByHyphen } from './path';

package/dist/types/universal/path.d.ts

@@ -0,0 +1 @@
+export declare const cutNameByHyphen: (s: string) => string;

package/dist/types/universal/pluginDagSort.d.ts

@@ -0,0 +1 @@
+export declare const pluginDagSort: <P extends Record<string, any>>(plugins: P[], key?: string, preKey?: string, postKey?: string) => P[];

package/package.json

@@ -0,0 +1,174 @@
+{
+  "name": "@bleedingdev/modern-js-utils",
+  "description": "A Progressive React Framework for modern web development.",
+  "homepage": "https://github.com/BleedingDev/ultramodern.js#readme",
+  "bugs": {
+    "url": "https://github.com/BleedingDev/ultramodern.js/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BleedingDev/ultramodern.js.git",
+    "directory": "packages/toolkit/utils"
+  },
+  "license": "MIT",
+  "keywords": [
+    "react",
+    "framework",
+    "modern",
+    "modern.js"
+  ],
+  "version": "3.2.0-ultramodern.0",
+  "types": "./dist/types/index.d.ts",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.mjs",
+  "_comment": "Provide ESM and CJS exports, ESM is used by runtime package, for treeshaking",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "node": {
+        "import": "./dist/esm-node/index.mjs",
+        "require": "./dist/cjs/index.js"
+      },
+      "default": "./dist/cjs/index.js"
+    },
+    "./universal": {
+      "types": "./dist/types/universal/index.d.ts",
+      "node": {
+        "module": "./dist/esm/universal/index.mjs",
+        "import": "./dist/esm-node/universal/index.mjs",
+        "require": "./dist/cjs/universal/index.js"
+      },
+      "default": "./dist/esm/universal/index.mjs"
+    },
+    "./universal/constants": {
+      "types": "./dist/types/universal/constants.d.ts",
+      "node": {
+        "module": "./dist/esm/universal/constants.mjs",
+        "import": "./dist/esm-node/universal/constants.mjs",
+        "require": "./dist/cjs/universal/constants.js"
+      },
+      "default": "./dist/esm/universal/constants.mjs"
+    },
+    "./commander": {
+      "import": "./dist/compiled/commander/index.mjs",
+      "default": "./dist/compiled/commander/index.js"
+    },
+    "./ora": "./dist/compiled/ora/index.js",
+    "./glob": "./dist/compiled/glob/index.js",
+    "./chalk": "./dist/compiled/chalk/index.js",
+    "./execa": "./dist/compiled/execa/index.js",
+    "./json5": "./dist/compiled/json5/index.js",
+    "./semver": "./dist/compiled/semver/index.js",
+    "./lodash": {
+      "import": "./dist/compiled/lodash/index.mjs",
+      "default": "./dist/compiled/lodash/index.js"
+    },
+    "./globby": "./dist/compiled/globby/index.js",
+    "./fs-extra": "./dist/compiled/fs-extra/index.js",
+    "./fast-glob": "./dist/compiled/fast-glob/index.js",
+    "./gzip-size": "./dist/compiled/gzip-size/index.js",
+    "./mime-types": "./dist/compiled/mime-types/index.js",
+    "./strip-ansi": "./dist/compiled/strip-ansi/index.js",
+    "./browserslist": "./dist/compiled/browserslist/index.js",
+    "./tsconfig-paths": {
+      "import": "./dist/compiled/tsconfig-paths/index.mjs",
+      "default": "./dist/compiled/tsconfig-paths/index.js"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "typesVersions": {
+    "*": {
+      "universal": [
+        "./dist/types/universal/index.d.ts"
+      ],
+      "universal/constants": [
+        "./dist/types/universal/constants.d.ts"
+      ],
+      "execa": [
+        "./dist/compiled/execa/index.d.ts"
+      ],
+      "glob": [
+        "./dist/compiled/glob/index.d.ts"
+      ],
+      "chalk": [
+        "./dist/compiled/chalk/index.d.ts"
+      ],
+      "json5": [
+        "./dist/compiled/json5/index.d.ts"
+      ],
+      "semver": [
+        "./dist/compiled/semver/index.d.ts"
+      ],
+      "lodash": [
+        "./dist/compiled/lodash/index.d.ts"
+      ],
+      "globby": [
+        "./dist/compiled/globby/index.d.ts"
+      ],
+      "fs-extra": [
+        "./dist/compiled/fs-extra/index.d.ts"
+      ],
+      "fast-glob": [
+        "./dist/compiled/fast-glob/index.d.ts"
+      ],
+      "gzip-size": [
+        "./dist/compiled/gzip-size/index.d.ts"
+      ],
+      "mime-types": [
+        "./dist/compiled/mime-types/index.d.ts"
+      ],
+      "strip-ansi": [
+        "./dist/compiled/strip-ansi/index.d.ts"
+      ],
+      "browserslist": [
+        "./dist/compiled/browserslist/index.d.ts"
+      ],
+      "tsconfig-paths": [
+        "./dist/compiled/tsconfig-paths/lib/index.d.ts"
+      ],
+      "commander": [
+        "./dist/compiled/commander/typings/index.d.ts"
+      ],
+      "ora": [
+        "./dist/compiled/ora/index.d.ts"
+      ]
+    }
+  },
+  "dependencies": {
+    "@swc/helpers": "^0.5.21",
+    "caniuse-lite": "^1.0.30001792",
+    "import-meta-resolve": "^4.2.0",
+    "lodash": "^4.18.1",
+    "lodash-es": "^4.18.1",
+    "rslog": "^2.1.1"
+  },
+  "devDependencies": {
+    "@rslib/core": "0.21.5",
+    "@types/node": "^25.8.0",
+    "@typescript/native-preview": "7.0.0-dev.20260516.1",
+    "happy-dom": "^20.8.9",
+    "@scripts/rstest-config": "2.66.0",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.2.0-ultramodern.0"
+  },
+  "peerDependencies": {
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "dev": "rslib build --watch",
+    "build": "rslib build",
+    "test": "rstest --passWithNoTests"
+  }
+}

package/rslib.config.mts

@@ -0,0 +1,162 @@
+import { rslibConfig } from '@modern-js/rslib';
+import { defineConfig, type RslibConfig, type Rspack } from '@rslib/core';
+
+const dependencies = [
+  // zero dependency
+  'address',
+  'filesize',
+  'minimist',
+  {
+    name: 'commander',
+    esm: true,
+  },
+  'import-lazy',
+  'dotenv',
+  'dotenv-expand',
+  'url-join',
+  'slash',
+  {
+    name: 'nanoid',
+    esm: true,
+  },
+  'lodash',
+  {
+    name: 'upath',
+  },
+  // a few dependencies
+  'debug',
+  'semver',
+  {
+    name: 'js-yaml',
+    esm: true,
+  },
+  'mime-types',
+  'strip-ansi',
+  'gzip-size',
+  {
+    name: 'json5',
+    externals: {
+      minimist: '../minimist',
+    },
+  },
+  // some dependencies
+  'glob',
+  'chalk',
+  'webpack-chain',
+  {
+    name: 'signale',
+    externals: {
+      chalk: '../chalk',
+    },
+    packageJsonField: ['options'],
+  },
+  'execa',
+  'fs-extra',
+  'browserslist',
+  'chokidar',
+  'fast-glob',
+  {
+    name: 'globby',
+    externals: {
+      'fast-glob': '../fast-glob',
+    },
+  },
+  {
+    name: 'ora',
+    externals: {
+      chalk: '../chalk',
+      'strip-ansi': '../strip-ansi',
+    },
+  },
+  {
+    name: 'inquirer',
+    externals: {
+      ora: '../ora',
+      chalk: '../chalk',
+      'strip-ansi': '../strip-ansi',
+    },
+  },
+  {
+    name: 'tsconfig-paths',
+    esm: true,
+    externals: {
+      json5: '../json5',
+      minimist: '../minimist',
+    },
+  },
+];
+
+const externalsMap: Record<string, { esm: boolean; regex: RegExp }> = {};
+
+for (const item of dependencies) {
+  const depName = typeof item === 'string' ? item : item.name;
+
+  // Skip dtsOnly dependencies
+  if (typeof item !== 'string' && 'dtsOnly' in item) {
+    continue;
+  }
+
+  externalsMap[depName] = {
+    esm: Boolean(typeof item === 'object' && item.esm),
+    regex: new RegExp(`compiled[\\/]${depName}(?:[\\/]|$)`),
+  };
+}
+
+// externalize pre-bundled dependencies
+const createExternals =
+  (type: string, noESM = false): Rspack.ExternalItem =>
+  ({ request }, callback) => {
+    const entries = Object.entries(externalsMap);
+    if (request) {
+      for (const [name, { regex, esm }] of entries) {
+        if (request === name) {
+          throw new Error(
+            `"${name}" is not allowed to be imported, use "../compiled/${name}/index.js" instead.`,
+          );
+        }
+        if (regex.test(request)) {
+          const index = esm && !noESM ? 'index.mjs' : 'index.js';
+          return callback(undefined, `${type} ${request}/${index}`);
+        }
+      }
+    }
+    callback();
+  };
+
+const lib: RslibConfig['lib'] = rslibConfig.lib.map((config, index) => {
+  if (config.format === 'esm') {
+    return {
+      ...config,
+      output: {
+        ...config.output,
+        externals: [createExternals('module-import')],
+      },
+    };
+  }
+  if (config.format === 'cjs') {
+    return {
+      ...config,
+      output: {
+        ...config.output,
+        externals: [
+          createExternals('commonjs', true),
+          {
+            'import-meta-resolve': 'var {}',
+          },
+        ],
+        copy: [
+          {
+            from: './compiled',
+            to: '../compiled',
+          },
+        ],
+      },
+    };
+  }
+  return config;
+});
+
+export default defineConfig({
+  ...rslibConfig,
+  lib,
+});

package/rstest.config.mts

@@ -0,0 +1,8 @@
+import { withTestPreset } from '@scripts/rstest-config';
+
+export default withTestPreset({
+  setupFiles: ['@scripts/rstest-config/setup.ts'],
+  root: __dirname,
+  testEnvironment: 'happy-dom',
+  globals: true,
+});