@esmx/import 3.0.0-rc.18 → 3.0.0-rc.19

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020 Vanelink
+Copyright (c) 2020 Esmx Team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -0,0 +1,134 @@
+<div align="center">
+  <img src="https://www.esmnext.com/logo.svg?t=2025" width="120" alt="Esmx Logo" />
+  <h1>@esmx/import</h1>
+  
+  <div>
+    <a href="https://www.npmjs.com/package/@esmx/import">
+      <img src="https://img.shields.io/npm/v/@esmx/import.svg" alt="npm version" />
+    </a>
+    <a href="https://github.com/esmnext/esmx/actions/workflows/build.yml">
+      <img src="https://github.com/esmnext/esmx/actions/workflows/build.yml/badge.svg" alt="Build" />
+    </a>
+    <a href="https://www.esmnext.com/coverage/">
+      <img src="https://img.shields.io/badge/coverage-live%20report-brightgreen" alt="Coverage Report" />
+    </a>
+    <a href="https://nodejs.org/">
+      <img src="https://img.shields.io/node/v/@esmx/import.svg" alt="node version" />
+    </a>
+    <a href="https://bundlephobia.com/package/@esmx/import">
+      <img src="https://img.shields.io/bundlephobia/minzip/@esmx/import" alt="size" />
+    </a>
+  </div>
+  
+  <p>Node.js server-side implementation of Import Maps for the Esmx framework</p>
+  
+  <p>
+    English | <a href="https://github.com/esmnext/esmx/blob/master/packages/import/README.zh-CN.md">中文</a>
+  </p>
+</div>
+
+## 🚀 Features
+
+- **Dual Implementation** - VM mode for development and Loader mode for production
+- **Hot Reload Support** - VM mode supports multiple creation for development flexibility
+- **High Performance** - Loader mode optimized for production deployment
+- **Node.js Focused** - Specifically designed for Node.js server-side environments
+- **TypeScript Ready** - Full TypeScript support with excellent type safety
+- **ESM Standards** - Fully compliant with Import Maps specification
+
+## 📦 Installation
+
+```bash
+npm install @esmx/import
+```
+
+## 🚀 Quick Start
+
+```typescript
+import { createVmImport } from '@esmx/import';
+import { pathToFileURL } from 'node:url';
+
+const vmImport = createVmImport(baseURL, importMap);
+const module = await vmImport('my-app/src/utils', import.meta.url);
+```
+
+## 📖 Mode Comparison
+
+`@esmx/import` provides two different Import Maps implementation approaches:
+
+| Feature | VM Mode | Loader Mode |
+|---------|---------|-------------|
+| **Function** | `createVmImport()` | `createLoaderImport()` |
+| **Environment** | Development | Production |
+| **Hot Reload** | ✅ Supports multiple creation | ❌ Can only be created once |
+| **Performance** | Relatively slower | High performance |
+| **Isolation** | Fully isolated VM environment | Uses Node.js native Loader |
+| **Debugging** | Easy for development debugging | Suitable for production deployment |
+
+## 🔧 Usage Examples
+
+### VM Mode (Development)
+
+```typescript
+import { createVmImport } from '@esmx/import';
+import { pathToFileURL } from 'node:url';
+
+const baseURL = pathToFileURL('/project');
+const importMap = {
+  imports: {
+    'my-app/src/utils': '/project/src/utils.mjs'
+  }
+};
+
+const vmImport = createVmImport(baseURL, importMap);
+const module = await vmImport('my-app/src/utils', import.meta.url);
+```
+
+### Loader Mode (Production)
+
+```typescript
+import { createLoaderImport } from '@esmx/import';
+import { pathToFileURL } from 'node:url';
+
+const baseURL = pathToFileURL('/app/dist/server');
+const importMap = {
+  imports: {
+    'my-app/src/utils': '/app/dist/server/my-app/src/utils.mjs'
+  }
+};
+
+const loaderImport = createLoaderImport(baseURL, importMap);
+const module = await loaderImport('my-app/src/utils');
+```
+
+## 📚 API Reference
+
+### createVmImport(baseURL, importMap?)
+Creates a VM-based import function with hot reload support.
+```typescript
+const vmImport = createVmImport(baseURL, importMap);
+const module = await vmImport(specifier, parent, sandbox?, options?);
+```
+
+### createLoaderImport(baseURL, importMap?)
+Creates a Loader-based import function with high performance, can only be created once.
+```typescript
+const loaderImport = createLoaderImport(baseURL, importMap);
+const module = await loaderImport(specifier);
+```
+
+### ImportMap Format
+```typescript
+interface ImportMap {
+  imports?: Record<string, string>;
+  scopes?: Record<string, Record<string, string>>;
+}
+```
+
+**Important Notes:**
+- Only supports Node.js environment, not browser
+- Paths must be absolute paths or complete URLs
+
+## 📄 License
+
+MIT © [Esmx Team](https://github.com/esmnext/esmx) 

package/README.zh-CN.md

@@ -0,0 +1,134 @@
+<div align="center">
+  <img src="https://www.esmnext.com/logo.svg?t=2025" width="120" alt="Esmx Logo" />
+  <h1>@esmx/import</h1>
+  
+  <div>
+    <a href="https://www.npmjs.com/package/@esmx/import">
+      <img src="https://img.shields.io/npm/v/@esmx/import.svg" alt="npm version" />
+    </a>
+    <a href="https://github.com/esmnext/esmx/actions/workflows/build.yml">
+      <img src="https://github.com/esmnext/esmx/actions/workflows/build.yml/badge.svg" alt="Build" />
+    </a>
+    <a href="https://www.esmnext.com/coverage/">
+      <img src="https://img.shields.io/badge/coverage-live%20report-brightgreen" alt="Coverage Report" />
+    </a>
+    <a href="https://nodejs.org/">
+      <img src="https://img.shields.io/node/v/@esmx/import.svg" alt="node version" />
+    </a>
+    <a href="https://bundlephobia.com/package/@esmx/import">
+      <img src="https://img.shields.io/bundlephobia/minzip/@esmx/import" alt="size" />
+    </a>
+  </div>
+  
+  <p>为 Esmx 框架提供 Import Maps 的 Node.js 服务端实现</p>
+  
+  <p>
+    <a href="https://github.com/esmnext/esmx/blob/master/packages/import/README.md">English</a> | 中文
+  </p>
+</div>
+
+## 🚀 特性
+
+- **双重实现** - 开发环境使用 VM 模式，生产环境使用 Loader 模式
+- **热重载支持** - VM 模式支持多次创建，提供开发灵活性
+- **高性能** - Loader 模式为生产部署优化
+- **Node.js 专注** - 专为 Node.js 服务端环境设计
+- **TypeScript 就绪** - 完整的 TypeScript 支持，出色的类型安全
+- **ESM 标准** - 完全符合 Import Maps 规范
+
+## 📦 安装
+
+```bash
+npm install @esmx/import
+```
+
+## 🚀 快速开始
+
+```typescript
+import { createVmImport } from '@esmx/import';
+import { pathToFileURL } from 'node:url';
+
+const vmImport = createVmImport(baseURL, importMap);
+const module = await vmImport('my-app/src/utils', import.meta.url);
+```
+
+## 📖 模式对比
+
+`@esmx/import` 提供两种不同的 Import Maps 实现方式：
+
+| 特性 | VM 模式 | Loader 模式 |
+|------|---------|-------------|
+| **函数** | `createVmImport()` | `createLoaderImport()` |
+| **适用环境** | 开发环境 | 生产环境 |
+| **热重载** | ✅ 支持多次创建 | ❌ 只能创建一次 |
+| **性能** | 相对较慢 | 高性能 |
+| **隔离性** | 完全隔离的 VM 环境 | 使用 Node.js 原生 Loader |
+| **调试** | 便于开发调试 | 适合生产部署 |
+
+## 🔧 使用示例
+
+### VM 模式 (开发环境)
+
+```typescript
+import { createVmImport } from '@esmx/import';
+import { pathToFileURL } from 'node:url';
+
+const baseURL = pathToFileURL('/project');
+const importMap = {
+  imports: {
+    'my-app/src/utils': '/project/src/utils.mjs'
+  }
+};
+
+const vmImport = createVmImport(baseURL, importMap);
+const module = await vmImport('my-app/src/utils', import.meta.url);
+```
+
+### Loader 模式 (生产环境)
+
+```typescript
+import { createLoaderImport } from '@esmx/import';
+import { pathToFileURL } from 'node:url';
+
+const baseURL = pathToFileURL('/app/dist/server');
+const importMap = {
+  imports: {
+    'my-app/src/utils': '/app/dist/server/my-app/src/utils.mjs'
+  }
+};
+
+const loaderImport = createLoaderImport(baseURL, importMap);
+const module = await loaderImport('my-app/src/utils');
+```
+
+## 📚 API 参考
+
+### createVmImport(baseURL, importMap?)
+创建基于 VM 的导入函数，支持热重载。
+```typescript
+const vmImport = createVmImport(baseURL, importMap);
+const module = await vmImport(specifier, parent, sandbox?, options?);
+```
+
+### createLoaderImport(baseURL, importMap?)
+创建基于 Loader 的导入函数，高性能，只能创建一次。
+```typescript
+const loaderImport = createLoaderImport(baseURL, importMap);
+const module = await loaderImport(specifier);
+```
+
+### ImportMap 格式
+```typescript
+interface ImportMap {
+  imports?: Record<string, string>;
+  scopes?: Record<string, Record<string, string>>;
+}
+```
+
+**注意事项：**
+- 仅支持 Node.js 环境，不支持浏览器
+- 路径必须为绝对路径或完整 URL
+
+## 📄 许可证
+
+MIT © [Esmx Team](https://github.com/esmnext/esmx) 

package/dist/import-loader.d.ts

@@ -3,9 +3,6 @@ interface Data {
     baseURL: string;
     importMap: ImportMap;
 }
-/**
- * 创建一个使用 loader 实现的 importmap 的 import 函数，只能创建一次，无热更新，适合生产使用。
- */
 export declare function createLoaderImport(baseURL: URL, importMap?: ImportMap): (specifier: string) => Promise<Record<string, any>>;
 export declare function initialize(data: Data): void;
 export declare function resolve(specifier: string, context: Record<string, any>, nextResolve: Function): any;

package/dist/import-loader.mjs

@@ -18,7 +18,11 @@ export function createLoaderImport(baseURL, importMap = {}) {
     );
   }
   return (specifier) => {
-    return import(specifier);
+    try {
+      return import(specifier);
+    } catch (e) {
+      throw new Error(`Failed to import '${specifier}'`);
+    }
   };
 }
 let loaderBaseURL = new URL("file:");

package/dist/import-vm.d.ts

@@ -1,6 +1,3 @@
 import vm from 'node:vm';
 import type { ImportMap } from './types';
-/**
- * 创建一个使用 vm 实现的 importmap 的 import 函数，可以创建多次来实现热更新效果，适合开发使用。
- */
 export declare function createVmImport(baseURL: URL, importMap?: ImportMap): (specifier: string, parent: string, sandbox?: vm.Context, options?: vm.CreateContextOptions) => Promise<Record<string, any>>;

package/dist/import-vm.mjs

@@ -82,12 +82,10 @@ export function createVmImport(baseURL, importMap = {}) {
         },
         identifier: specifier,
         context,
-        // @ts-ignore
         importModuleDynamically: (specifier2, referrer) => {
           return moduleLinker(
             specifier2,
             parsed.filename,
-            // @ts-ignore
             referrer.context,
             cache,
             [...moduleIds, parsed.pathname]

package/package.json

@@ -33,16 +33,15 @@
     },
     "devDependencies": {
         "@biomejs/biome": "1.9.4",
-        "@esmx/lint": "3.0.0-rc.18",
-        "@gez/lint": "3.0.0-rc.9",
-        "@types/node": "22.13.10",
-        "@vitest/coverage-v8": "3.0.8",
-        "stylelint": "16.15.0",
+        "@esmx/lint": "3.0.0-rc.19",
+        "@types/node": "22.15.18",
+        "@vitest/coverage-v8": "3.1.3",
+        "stylelint": "16.19.1",
         "typescript": "5.8.2",
-        "unbuild": "2.0.0",
-        "vitest": "3.0.8"
+        "unbuild": "3.5.0",
+        "vitest": "3.1.3"
     },
-    "version": "3.0.0-rc.18",
+    "version": "3.0.0-rc.19",
     "type": "module",
     "private": false,
     "exports": {
@@ -61,5 +60,5 @@
         "template",
         "public"
     ],
-    "gitHead": "79ceb323f985dd88dbd7f1349f61f341b6d522c4"
+    "gitHead": "83a9cfac4a91b2b54ac576e120bb4541f4cce9d6"
 }

package/src/import-loader.ts

@@ -9,9 +9,7 @@ interface Data {
 }
 
 let registered = '';
-/**
- * 创建一个使用 loader 实现的 importmap 的 import 函数，只能创建一次，无热更新，适合生产使用。
- */
+
 export function createLoaderImport(baseURL: URL, importMap: ImportMap = {}) {
     if (!registered) {
         module.register<Data>(fileURLToPath(import.meta.url), {
@@ -28,11 +26,14 @@ export function createLoaderImport(baseURL: URL, importMap: ImportMap = {}) {
         );
     }
     return (specifier: string): Promise<Record<string, any>> => {
-        return import(specifier);
+        try {
+            return import(specifier);
+        } catch (e) {
+            throw new Error(`Failed to import '${specifier}'`);
+        }
     };
 }
 
-// loader 线程时的处理逻辑
 let loaderBaseURL: URL = new URL('file:');
 let loaderParsedImportMap: IM.ParsedImportMap = {};
 

package/src/import-vm.ts

@@ -27,9 +27,6 @@ async function importBuiltinModule(specifier: string, context: vm.Context) {
     return module;
 }
 
-/**
- * 创建一个使用 vm 实现的 importmap 的 import 函数，可以创建多次来实现热更新效果，适合开发使用。
- */
 export function createVmImport(baseURL: URL, importMap: ImportMap = {}) {
     const parsedImportMap = IM.parse(importMap, baseURL);
     const parse = (specifier: string, parent: string) => {
@@ -101,12 +98,10 @@ export function createVmImport(baseURL: URL, importMap: ImportMap = {}) {
                 },
                 identifier: specifier,
                 context: context,
-                // @ts-ignore
                 importModuleDynamically: (specifier, referrer) => {
                     return moduleLinker(
                         specifier,
                         parsed.filename,
-                        // @ts-ignore
                         referrer.context,
                         cache,
                         [...moduleIds, parsed.pathname]