@esmx/import
Node.js server-side implementation of Import Maps for the Esmx framework
English | δΈζ
## π 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
npm install @esmx/import
# pnpm
pnpm add @esmx/import
# yarn
yarn add @esmx/import
```
## π Quick Start
```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);
```
## π 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);
```
### Import Map Format
```typescript
interface ImportMap {
imports?: Record
