@vureact/compiler-core 1.3.0 → 1.4.0

package/lib/compiler-core.esm.js

@@ -1,5 +1,5 @@
 /**
- * @vureact/compiler-core v1.3.0
+ * @vureact/compiler-core v1.4.0
  * (c) 2025-present Ruihong Zhong (Ryan John)
  * @license MIT
  */
@@ -18,7 +18,7 @@ import {
   parseOnlyScript,
   parseSFC,
   transform
-} from "./chunk-CUCUXW56.esm.js";
+} from "./chunk-NF5BSPYE.esm.js";
 export {
   BaseCompiler,
   CacheKey,

package/lib/compiler-core.js

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});/**
- * @vureact/compiler-core v1.3.0
+ * @vureact/compiler-core v1.4.0
  * (c) 2025-present Ruihong Zhong (Ryan John)
  * @license MIT
  */
@@ -18,7 +18,7 @@
 
 
 
-var _chunk7LBUUA24js = require('./chunk-7LBUUA24.js');
+var _chunkIVRFEV6Hjs = require('./chunk-IVRFEV6H.js');
 
 
 
@@ -33,4 +33,4 @@ var _chunk7LBUUA24js = require('./chunk-7LBUUA24.js');
 
 
 
-exports.BaseCompiler = _chunk7LBUUA24js.BaseCompiler; exports.CacheKey = _chunk7LBUUA24js.CacheKey; exports.FileCompiler = _chunk7LBUUA24js.FileCompiler; exports.Helper = _chunk7LBUUA24js.Helper; exports.VuReact = _chunk7LBUUA24js.VuReact; exports.defineConfig = _chunk7LBUUA24js.defineConfig; exports.generate = _chunk7LBUUA24js.generate; exports.generateComponent = _chunk7LBUUA24js.generateComponent; exports.generateOnlyScript = _chunk7LBUUA24js.generateOnlyScript; exports.parse = _chunk7LBUUA24js.parse; exports.parseOnlyScript = _chunk7LBUUA24js.parseOnlyScript; exports.parseSFC = _chunk7LBUUA24js.parseSFC; exports.transform = _chunk7LBUUA24js.transform;
+exports.BaseCompiler = _chunkIVRFEV6Hjs.BaseCompiler; exports.CacheKey = _chunkIVRFEV6Hjs.CacheKey; exports.FileCompiler = _chunkIVRFEV6Hjs.FileCompiler; exports.Helper = _chunkIVRFEV6Hjs.Helper; exports.VuReact = _chunkIVRFEV6Hjs.VuReact; exports.defineConfig = _chunkIVRFEV6Hjs.defineConfig; exports.generate = _chunkIVRFEV6Hjs.generate; exports.generateComponent = _chunkIVRFEV6Hjs.generateComponent; exports.generateOnlyScript = _chunkIVRFEV6Hjs.generateOnlyScript; exports.parse = _chunkIVRFEV6Hjs.parse; exports.parseOnlyScript = _chunkIVRFEV6Hjs.parseOnlyScript; exports.parseSFC = _chunkIVRFEV6Hjs.parseSFC; exports.transform = _chunkIVRFEV6Hjs.transform;

package/package.json

@@ -1,91 +1,99 @@
-{
-  "name": "@vureact/compiler-core",
-  "version": "1.3.0",
-  "description": "🌀 Next Vue 3 to React 18+ intelligent compilation toolchain",
-  "author": "Ruihong Zhong (Ryan John)",
-  "license": "MIT",
-  "type": "module",
-  "main": "./lib/compiler-core.js",
-  "module": "./lib/compiler-core.esm.js",
-  "types": "./lib/compiler-core.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/compiler-core.d.ts",
-      "import": "./lib/compiler-core.esm.js",
-      "require": "./lib/compiler-core.js"
-    }
-  },
-  "files": [
-    "bin",
-    "lib",
-    "templates"
-  ],
-  "keywords": [
-    "vue",
-    "react",
-    "vureact",
-    "vue2react",
-    "vue-to-react",
-    "compiler",
-    "transformer",
-    "vue3",
-    "react18",
-    "migration",
-    "svelte",
-    "typescript",
-    "jsx",
-    "sfc",
-    "veaury",
-    "mitosis",
-    "vue3-to-react",
-    "vue-react",
-    "react-vue",
-    "vue-in-react"
-  ],
-  "homepage": "https://vureact.top",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/vureact-js/core.git",
-    "directory": "packages/compiler-core"
-  },
-  "bugs": {
-    "url": "https://github.com/vureact-js/core/issues"
-  },
-  "bin": {
-    "vureact": "./bin/vureact.js"
-  },
-  "scripts": {
-    "build": "tsup",
-    "test": "tsx watch"
-  },
-  "peerDependencies": {
-    "prettier": "^3.0.0"
-  },
-  "peerDependenciesMeta": {
-    "prettier": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "@babel/core": "^7.28.5",
-    "@babel/generator": "^7.28.3",
-    "@babel/parser": "^7.28.4",
-    "@babel/traverse": "^7.28.4",
-    "@babel/types": "^7.28.4",
-    "@vue/compiler-core": "^3.5.22",
-    "@vue/compiler-sfc": "^3.5.22",
-    "cac": "^6.7.14",
-    "chokidar": "^5.0.0",
-    "kleur": "^4.1.5",
-    "less": "^4.5.1",
-    "minimatch": "^10.1.1",
-    "ora": "^9.1.0",
-    "postcss": "^8.5.6",
-    "sass": "^1.97.3",
-    "update-notifier": "^7.3.1",
-    "xxhashjs": "^0.2.2"
-  },
-  "engines": {
-    "node": ">=14.0.0"
-  }
-}
+{
+  "name": "@vureact/compiler-core",
+  "version": "1.4.0",
+  "description": "🌀 Semantic-aware Vue 3 to React 18+ compiler for progressive migration.",
+  "author": "Ruihong Zhong (Ryan John)",
+  "license": "MIT",
+  "type": "module",
+  "main": "./lib/compiler-core.js",
+  "module": "./lib/compiler-core.esm.js",
+  "types": "./lib/compiler-core.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/compiler-core.d.ts",
+      "import": "./lib/compiler-core.esm.js",
+      "require": "./lib/compiler-core.js"
+    }
+  },
+  "files": [
+    "bin",
+    "lib"
+  ],
+  "keywords": [
+    "vue",
+    "react",
+    "vureact",
+    "vue2react",
+    "vue-to-react",
+    "compiler",
+    "transformer",
+    "vue3",
+    "react18",
+    "migration",
+    "svelte",
+    "typescript",
+    "jsx",
+    "sfc",
+    "veaury",
+    "mitosis",
+    "vue3-to-react",
+    "vue-react",
+    "react-vue",
+    "vue-in-react",
+    "code-migration",
+    "framework-migration",
+    "vue-migration",
+    "react-conversion",
+    "single-file-components",
+    "progressive-migration",
+    "automated-refactoring"
+  ],
+  "homepage": "https://vureact.top",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vureact-js/core.git",
+    "directory": "packages/compiler-core"
+  },
+  "bugs": {
+    "url": "https://github.com/vureact-js/core/issues"
+  },
+  "bin": {
+    "vureact": "./bin/vureact.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "tsx watch"
+  },
+  "peerDependencies": {
+    "prettier": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "prettier": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@babel/core": "^7.28.5",
+    "@babel/generator": "^7.28.3",
+    "@babel/parser": "^7.28.4",
+    "@babel/traverse": "^7.28.4",
+    "@babel/types": "^7.28.4",
+    "@vue/compiler-core": "^3.5.22",
+    "@vue/compiler-sfc": "^3.5.22",
+    "cac": "^6.7.14",
+    "chokidar": "^5.0.0",
+    "kleur": "^4.1.5",
+    "less": "^4.5.1",
+    "minimatch": "^10.1.1",
+    "ora": "^9.1.0",
+    "postcss": "^8.5.6",
+    "proper-lockfile": "^4.1.2",
+    "sass": "^1.97.3",
+    "tsx": "^4.21.0",
+    "update-notifier": "^7.3.1",
+    "xxhashjs": "^0.2.2"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}

package/templates/route-setup-notes.md

@@ -1,192 +0,0 @@
-# Router Adaptation Guide
-
-## Overview
-
-VuReact provides full conversion support for Vue Router, but since routing is an engineering-level context, some manual adjustments are still required after compilation.
-
-### Automatically Converted Parts
-
-- `<router-link>` → `<RouterLink>`
-- `<router-view>` → `<RouterView>`
-- Routing API calls: `useRouter()`, `useRoute()`, etc.
-- Automatically injects the `@vureact/router` dependency
-
-### Parts Requiring Manual Adjustment
-
-- Routing configuration file format conversion
-- Entry file rendering method
-- Exclusion configuration setup
-
-## Configuration Steps
-
-### Step 1: Preparation Before Compilation
-
-Ensure your Vue project uses the standard Vue Router configuration.
-
-### Step 2: Execute Compilation
-
-```bash
-npx vureact build
-
-# Or manually configure the npm command
-npm run vr:build
-```
-
-### Step 3: Adjust the Output React Project (Critical Step)
-
-#### 3.1 Update the Entry File (src/main.tsx)
-
-Example:
-
-```tsx
-import { StrictMode } from 'react';
-import { createRoot } from 'react-dom/client';
-import './index.css';
-import router from './router';
-
-createRoot(document.getElementById('root')!).render(
-  <StrictMode>
-    <router.RouterProvider />
-  </StrictMode>,
-);
-```
-
-**Important Changes**:
-
-- Import the Router Provider; there is no need to render `<App />` because `App` should be mounted in the routing configuration.
-
-#### 3.2 Convert the Routing Configuration File
-
-The actual structure shall be based on the routing configuration output by your project.
-
-Rename `src/router/index.ts` to `src/router/index.tsx`.
-
-Example:
-
-```tsx
-import { createRouter, createWebHashHistory } from '@vureact/router';
-import App from '../App';
-import Dashboard from '../pages/Dashboard';
-import Customers from '../pages/Customers';
-
-const router = createRouter({
-  history: createWebHashHistory(),
-  routes: [
-    {
-      path: '/',
-      component: <App />,
-      children: [
-        { path: 'dashboard', component: <Dashboard /> },
-        { path: 'customers', component: <Customers /> },
-      ],
-    },
-  ],
-});
-
-export default router;
-```
-
-**Important Changes**:
-
-- File extension: `.ts` → `.tsx`
-- Export the `createRouter` router instance
-- Component syntax: `component: Dashboard` → `component: <Dashboard />`
-- Import method: Keep React component imports
-
-#### 3.3 Configure Exclusions
-
-Add exclusion configurations to `vureact.config.js` to prevent manually adjusted files from being overwritten during recompilation.
-
-If you need to modify these files later, you must **synchronize the changes manually**.
-
-Example:
-
-```js
-export default defineConfig({
-  exclude: [
-    'src/main.ts',
-    'src/router/**', // Exclude the entire routing directory
-  ],
-});
-```
-
-### Step 4: Verification and Testing
-
-1. Install dependencies: `npm install`
-2. Start the project: `npm run dev`
-3. Test route navigation
-4. Verify nested routes
-
-## Common Issues
-
-### Q1: Blank Page with Console Errors
-
-**Possible Cause**: The routing configuration file has not been converted to JSX syntax
-**Solution**:
-
-1. Confirm the file extension is `.tsx` or `.jsx`
-2. Check if components use the `<Component />` syntax
-3. Ensure React components are imported correctly
-
-### Q2: 404 Error on Route Navigation
-
-**Possible Cause**: Incorrect history mode configuration
-**Solution**:
-
-- Check `createWebHashHistory` vs `createWebHistory`
-- Verify the base path configuration
-
-### Q3: Nested Routes Not Displaying Content
-
-**Possible Cause**: Parent component lacks `<RouterView />`
-**Solution**:
-Add a route outlet in the layout component:
-
-```vue
-<!-- Original Vue -->
-<template>
-  <div>
-    <header>...</header>
-    <router-view />
-  </div>
-</template>
-```
-
-### Q4: Manual Adjustments Overwritten After Compilation
-
-**Possible Cause**: Files not added to the `exclude` list
-**Solution**:
-Update `vureact.config.js` and add the adjusted files to the exclusion list.
-
-## Best Practices
-
-### 1. Routing Configuration Specifications
-
-- Export the router instance: `export default createRouter({})`
-- Use named routes: `{ name: 'dashboard', path: '/dashboard', ... }`
-- Configure route lazy loading:
-
-  ```tsx
-  const Dashboard = lazy(() => import('../pages/Dashboard'));
-  ```
-
-- Centralize management of route meta fields
-
-### 2. File Management Strategy
-
-- Manage routing configuration files in a separate directory
-- Separate type definitions into `src/router/types.ts`
-- Unify route guards in `src/router/guards.ts`
-
-### 3. Testing Strategy
-
-- Unit test routing configurations
-- E2E test route navigation flows
-- Functional comparison testing before and after compilation
-
-## Related Resources
-
-- [VuReact Official Documentation](https://vureact.top/en)
-- [VuReact Router Official Documentation](https://router.vureact.top/en)
-- [Compilation Issue Feedback and Support](https://github.com/vureact-js/core/issues)
-- [Routing Issue Feedback and Support](https://github.com/vureact-js/vureact-router/issues)

package/templates/route-setup-notes.zh.md

@@ -1,192 +0,0 @@
-# 路由适配指南
-
-## 概述
-
-VuReact 对 Vue Router 提供了完整的转换支持，但由于路由是工程级上下文，编译后仍需要一些人工调整。
-
-### 自动转换的部分
-
-- `<router-link>` → `<RouterLink>`
-- `<router-view>` → `<RouterView>`
-- 路由API调用：`useRouter()`, `useRoute()`等
-- 自动注入`@vureact/router`依赖
-
-### 需要人工调整的部分
-
-- 路由配置文件格式转换
-- 入口文件渲染方式
-- 排除配置设置
-
-## 配置步骤
-
-### 步骤1：编译前的准备
-
-确保你的Vue项目使用标准Vue Router配置。
-
-### 步骤2：执行编译
-
-```bash
-npx vureact build
-
-# 或手动配置 npm 命令
-npm run vr:build
-```
-
-### 步骤3：调整输出的 React 项目（关键步骤）
-
-#### 3.1 更新入口文件（src/main.tsx）
-
-示例：
-
-```tsx
-import { StrictMode } from 'react';
-import { createRoot } from 'react-dom/client';
-import './index.css';
-import router from './router';
-
-createRoot(document.getElementById('root')!).render(
-  <StrictMode>
-    <router.RouterProvider />
-  </StrictMode>,
-);
-```
-
-**重要变化**：
-
-- 导入路由提供器，不需要渲染 `<App />`，因为 `App` 应该在路由配置中挂载。
-
-#### 3.2 转换路由配置文件
-
-实际以你项目输出的路由配置结构为准。
-
-将 `src/router/index.ts` 改为 `src/router/index.tsx`。
-
-示例：
-
-```tsx
-import { createRouter, createWebHashHistory } from '@vureact/router';
-import App from '../App';
-import Dashboard from '../pages/Dashboard';
-import Customers from '../pages/Customers';
-
-const router = createRouter({
-  history: createWebHashHistory(),
-  routes: [
-    {
-      path: '/',
-      component: <App />,
-      children: [
-        { path: 'dashboard', component: <Dashboard /> },
-        { path: 'customers', component: <Customers /> },
-      ],
-    },
-  ],
-});
-
-export default router;
-```
-
-**重要变化**：
-
-- 文件扩展名：`.ts` → `.tsx`
-- 导出 `createRouter` 路由器实例
-- 组件语法：`component: Dashboard` → `component: <Dashboard />`
-- 导入方式：保持React组件导入
-
-#### 3.3 配置排除项
-
-在 `vureact.config.js` 中添加排除配置，防止重新编译时覆盖手动调整的文件。
-
-若后续需要修改这些文件，需**手动同步**变更。
-
-示例：
-
-```js
-export default defineConfig({
-  exclude: [
-    'src/main.ts',
-    'src/router/**', // 排除整个路由目录
-  ],
-});
-```
-
-### 步骤4：验证与测试
-
-1. 安装依赖：`npm install`
-2. 启动项目：`npm run dev`
-3. 测试路由跳转
-4. 验证嵌套路由
-
-## 常见问题
-
-### Q1: 页面空白，控制台报错
-
-**可能原因**：路由配置文件未转换为JSX语法
-**解决方案**：
-
-1. 确认文件扩展名为`.tsx`或`.jsx`
-2. 检查组件是否使用`<Component />`语法
-3. 确保正确导入React组件
-
-### Q2: 路由跳转404
-
-**可能原因**：历史模式配置错误
-**解决方案**：
-
-- 检查`createWebHashHistory` vs `createWebHistory`
-- 确认base路径配置
-
-### Q3: 嵌套路由不显示内容
-
-**可能原因**：父组件缺少`<RouterView />`
-**解决方案**：
-在布局组件中添加路由出口：
-
-```vue
-<!-- Vue原版 -->
-<template>
-  <div>
-    <header>...</header>
-    <router-view />
-  </div>
-</template>
-```
-
-### Q4: 编译后手动调整被覆盖
-
-**可能原因**：未将文件加入`exclude`列表
-**解决方案**：
-更新`vureact.config.js`，将调整过的文件加入排除列表。
-
-## 最佳实践
-
-### 1. 路由配置规范
-
-- 导出路由器实例：`export default createRouter({})`
-- 使用命名路由：`{ name: 'dashboard', path: '/dashboard', ... }`
-- 配置路由懒加载：
-
-  ```tsx
-  const Dashboard = lazy(() => import('../pages/Dashboard'));
-  ```
-
-- 统一管理路由meta字段
-
-### 2. 文件管理策略
-
-- 路由配置文件单独目录管理
-- 类型定义分离到`src/router/types.ts`
-- 路由守卫统一在`src/router/guards.ts`
-
-### 3. 测试策略
-
-- 单元测试路由配置
-- E2E测试路由跳转流程
-- 编译前后功能对比测试
-
-## 相关资源
-
-- [VuReact 官方文档](https://vureact.top)
-- [VuReact Router 官方文档](https://router.vureact.top)
-- [编译问题反馈与支持](https://github.com/vureact-js/core/issues)
-- [路由问题反馈与支持](https://github.com/vureact-js/vureact-router/issues)