<div align="center">
  <img src="https://esmx.dev/logo.svg?t=2025" width="120" alt="Esmx Logo" />
  <h1>@esmx/core</h1>
  
  <div>
    <a href="https://www.npmjs.com/package/@esmx/core">
      <img src="https://img.shields.io/npm/v/@esmx/core.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://esmx.dev/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/core.svg" alt="node version" />
    </a>
    <a href="https://bundlephobia.com/package/@esmx/core">
      <img src="https://img.shields.io/bundlephobia/minzip/@esmx/core" alt="size" />
    </a>
  </div>
  
  <p>支持 Vue、React、Preact、Solid、Svelte 的高性能微前端框架，支持 SSR 与模块链接</p>
  
  <p>
    <a href="https://github.com/esmnext/esmx/blob/master/packages/core/README.md">English</a> | 中文
  </p>
</div>

## 🚀 特性

- **原生微前端** - 基于 ESM + Import Map 的原生模块加载，零运行时开销
- **依赖管理** - 中心化依赖管理，基于内容哈希的强缓存策略
- **应用隔离** - ESM 原生模块隔离，保障应用运行时稳定性
- **SSR 支持** - 灵活的 SSR 策略，支持任意前端框架
- **开发体验** - 完整的 TypeScript 支持，原生模块链接能力

## 📦 安装

```bash
# npm
npm install @esmx/core

# pnpm
pnpm add @esmx/core

# yarn
yarn add @esmx/core
```

## 🚀 快速开始

在 `entry.node.ts` 中定义应用，并在 `devApp` 选择构建工具集成：

```typescript
import type { EsmxOptions } from '@esmx/core';

export default {
  async devApp(esmx) {
    return import('@esmx/rspack').then((m) => m.createRspackHtmlApp(esmx));
  }
} satisfies EsmxOptions;
```

然后用 `esmx` CLI 驱动：`esmx dev`、`esmx build`、`esmx start`。

📖 [完整文档](https://esmx.dev/zh/guide/start/getting-started.html)

## 📚 文档

访问[官方文档](https://esmx.dev)获取详细的使用指南和 API 参考。

## 📄 许可证

MIT © [Esmx Team](https://github.com/esmnext/esmx)
