@vureact/compiler-core 1.2.1 → 1.3.0

package/lib/cli.d.cts

@@ -1,2 +1 @@
-
-export {  }
+#!/usr/bin/env node

package/lib/cli.d.ts

@@ -1,2 +1 @@
-
-export {  }
+#!/usr/bin/env node

package/lib/cli.esm.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * @vureact/compiler-core v1.2.1
+ * @vureact/compiler-core v1.3.0
  * (c) 2025-present Ruihong Zhong (Ryan John)
  * @license MIT
  */
@@ -10,9 +10,10 @@ import {
   VuReact,
   bin,
   calcElapsedTime,
+  getDirname,
   normalizePath,
   version
-} from "./chunk-7FIMRVQS.esm.js";
+} from "./chunk-CUCUXW56.esm.js";
 
 // src/cli/index.ts
 import { cac } from "cac";
@@ -172,9 +173,53 @@ function resolveOptions(command) {
   return command.option("-i, --input <dir>", "Input directory (relative to root)").option("-o, --outDir <dir>", "Output directory name").option("--workspace <dir>", "The workspace directory for cache and output").option("--bootstrapVite", "Enable Vite to initialize a standard React project environment.").option("--exclude <pattern>", "Exclude files/directories (glob pattern)").option("--no-recursive", "Disable recursive search in subdirectories").option("--no-cache", "Disable cache", { default: void 0 }).option("--format", "Enable code formatting", { default: void 0 }).option("--formatter <type>", 'Choose formatter: "prettier" or "builtin"');
 }
 
+// src/cli/update-check.ts
+import { existsSync as existsSync2, readFileSync } from "fs";
+import { join } from "path";
+import updateNotifier from "update-notifier";
+var __dirname = getDirname(import.meta.url);
+function checkForUpdates() {
+  try {
+    const possiblePaths = [
+      "./package.json",
+      // 当前目录
+      "package.json",
+      // 当前目录（另一种写法）
+      "../package.json",
+      // 上一级目录（构建环境）
+      "../../package.json"
+      // 上两级目录（开发环境）
+    ];
+    let pkgPath = "";
+    for (const relPath of possiblePaths) {
+      const testPath = join(__dirname, relPath);
+      if (existsSync2(testPath)) {
+        pkgPath = testPath;
+        break;
+      }
+    }
+    if (!pkgPath) {
+      return;
+    }
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    const notifier = updateNotifier({
+      pkg,
+      updateCheckInterval: 1e3 * 60 * 60 * 24,
+      // 每天检查一次 (24小时)
+      shouldNotifyInNpmScript: true
+    });
+    notifier.notify();
+  } catch (error) {
+    if (process.env.NODE_ENV === "development") {
+      console.debug("Update check failed:", error);
+    }
+  }
+}
+
 // src/cli/index.ts
 var [programName] = Object.keys(bin);
 var cli = cac(programName);
+checkForUpdates();
 var buildCommand = cli.command("build [root]", "Compile Vue3 to React (one-time)");
 resolveOptions(buildCommand).action((root, options) => {
   resolveAction(root, { ...options, watch: false });

package/lib/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 "use strict"; function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }/**
- * @vureact/compiler-core v1.2.1
+ * @vureact/compiler-core v1.3.0
  * (c) 2025-present Ruihong Zhong (Ryan John)
  * @license MIT
  */
@@ -12,7 +12,8 @@
 
 
 
-var _chunkSQRJUILRjs = require('./chunk-SQRJUILR.js');
+
+var _chunk7LBUUA24js = require('./chunk-7LBUUA24.js');
 
 // src/cli/index.ts
 var _cac = require('cac');
@@ -28,7 +29,7 @@ async function resolveAction(root, options) {
   const projectRoot = root ? _path2.default.resolve(process.cwd(), root) : process.cwd();
   const userConfig = await loadUserConfig(projectRoot);
   const finalConfig = mergeConfig(projectRoot, options, userConfig);
-  const compiler = new (0, _chunkSQRJUILRjs.VuReact)(finalConfig);
+  const compiler = new (0, _chunk7LBUUA24js.VuReact)(finalConfig);
   await compiler.execute();
   if (finalConfig.watch) {
     setupWatcher(compiler, finalConfig);
@@ -82,7 +83,7 @@ function mergeConfig(projectRoot, options, userConfig) {
 }
 function setupWatcher(compiler, config) {
   const spinner = _ora2.default.call(void 0, );
-  const cmpHelper = new (0, _chunkSQRJUILRjs.Helper)(config);
+  const cmpHelper = new (0, _chunk7LBUUA24js.Helper)(config);
   const watcher = _chokidar2.default.watch(cmpHelper.getInputPath(), {
     ignored: cmpHelper.getExcludes(),
     persistent: true,
@@ -117,7 +118,7 @@ function setupWatcher(compiler, config) {
       const fn = processors[ext];
       const unit = await fn(filePath);
       cmpHelper.printCoreLogs();
-      cmpHelper.printCompileInfo(filePath, _chunkSQRJUILRjs.calcElapsedTime.call(void 0, startTime));
+      cmpHelper.printCompileInfo(filePath, _chunk7LBUUA24js.calcElapsedTime.call(void 0, startTime));
       if (unit) {
         await _optionalChain([config, 'access', _11 => _11.onChange, 'optionalCall', _12 => _12(event, unit)]);
       }
@@ -126,7 +127,7 @@ function setupWatcher(compiler, config) {
       await compiler.processAsset(filePath);
       cmpHelper.print(
         _kleur2.default.blue("Copied Asset"),
-        _kleur2.default.dim(_chunkSQRJUILRjs.normalizePath.call(void 0, cmpHelper.relativePath(filePath)))
+        _kleur2.default.dim(_chunk7LBUUA24js.normalizePath.call(void 0, cmpHelper.relativePath(filePath)))
       );
     }
     spinner.stop();
@@ -139,7 +140,7 @@ function setupWatcher(compiler, config) {
       await compiler.removeOutputPath(filePath, type2);
       cmpHelper.print(
         _kleur2.default.yellow("Removed"),
-        _kleur2.default.dim(_chunkSQRJUILRjs.normalizePath.call(void 0, cmpHelper.relativePath(filePath)))
+        _kleur2.default.dim(_chunk7LBUUA24js.normalizePath.call(void 0, cmpHelper.relativePath(filePath)))
       );
     };
     if (type === "unlink") {
@@ -172,9 +173,53 @@ function resolveOptions(command) {
   return command.option("-i, --input <dir>", "Input directory (relative to root)").option("-o, --outDir <dir>", "Output directory name").option("--workspace <dir>", "The workspace directory for cache and output").option("--bootstrapVite", "Enable Vite to initialize a standard React project environment.").option("--exclude <pattern>", "Exclude files/directories (glob pattern)").option("--no-recursive", "Disable recursive search in subdirectories").option("--no-cache", "Disable cache", { default: void 0 }).option("--format", "Enable code formatting", { default: void 0 }).option("--formatter <type>", 'Choose formatter: "prettier" or "builtin"');
 }
 
+// src/cli/update-check.ts
+
+
+var _updatenotifier = require('update-notifier'); var _updatenotifier2 = _interopRequireDefault(_updatenotifier);
+var __dirname = _chunk7LBUUA24js.getDirname.call(void 0, import.meta.url);
+function checkForUpdates() {
+  try {
+    const possiblePaths = [
+      "./package.json",
+      // 当前目录
+      "package.json",
+      // 当前目录（另一种写法）
+      "../package.json",
+      // 上一级目录（构建环境）
+      "../../package.json"
+      // 上两级目录（开发环境）
+    ];
+    let pkgPath = "";
+    for (const relPath of possiblePaths) {
+      const testPath = _path.join.call(void 0, __dirname, relPath);
+      if (_fs.existsSync.call(void 0, testPath)) {
+        pkgPath = testPath;
+        break;
+      }
+    }
+    if (!pkgPath) {
+      return;
+    }
+    const pkg = JSON.parse(_fs.readFileSync.call(void 0, pkgPath, "utf-8"));
+    const notifier = _updatenotifier2.default.call(void 0, {
+      pkg,
+      updateCheckInterval: 1e3 * 60 * 60 * 24,
+      // 每天检查一次 (24小时)
+      shouldNotifyInNpmScript: true
+    });
+    notifier.notify();
+  } catch (error) {
+    if (process.env.NODE_ENV === "development") {
+      console.debug("Update check failed:", error);
+    }
+  }
+}
+
 // src/cli/index.ts
-var [programName] = Object.keys(_chunkSQRJUILRjs.bin);
+var [programName] = Object.keys(_chunk7LBUUA24js.bin);
 var cli = _cac.cac.call(void 0, programName);
+checkForUpdates();
 var buildCommand = cli.command("build [root]", "Compile Vue3 to React (one-time)");
 resolveOptions(buildCommand).action((root, options) => {
   resolveAction(root, { ...options, watch: false });
@@ -183,4 +228,4 @@ var watchCommand = cli.command("watch [root]", "Compile Vue3 to React and watch
 resolveOptions(watchCommand).action((root, options) => {
   resolveAction(root, { ...options, watch: true });
 });
-cli.help().version(_chunkSQRJUILRjs.version).parse();
+cli.help().version(_chunk7LBUUA24js.version).parse();

package/lib/compiler-core.d.cts

@@ -1269,6 +1269,15 @@ declare class FileCompiler extends BaseCompiler {
      * @returns {Promise<void>}
      */
     execute(): Promise<void>;
+    /**
+     * 运行管线并显示加载动画
+     *
+     * @private
+     * @param text - 加载动画显示的文本
+     * @param pipelineFn - 要执行的管线函数
+     * @returns 返回的处理的文件数
+     */
+    private runPipelineWithSpinner;
     /**
      * 处理单个 Vue 单文件组件（SFC）
      *

package/lib/compiler-core.d.ts

@@ -1269,6 +1269,15 @@ declare class FileCompiler extends BaseCompiler {
      * @returns {Promise<void>}
      */
     execute(): Promise<void>;
+    /**
+     * 运行管线并显示加载动画
+     *
+     * @private
+     * @param text - 加载动画显示的文本
+     * @param pipelineFn - 要执行的管线函数
+     * @returns 返回的处理的文件数
+     */
+    private runPipelineWithSpinner;
     /**
      * 处理单个 Vue 单文件组件（SFC）
      *

package/lib/compiler-core.esm.js

@@ -1,5 +1,5 @@
 /**
- * @vureact/compiler-core v1.2.1
+ * @vureact/compiler-core v1.3.0
  * (c) 2025-present Ruihong Zhong (Ryan John)
  * @license MIT
  */
@@ -18,7 +18,7 @@ import {
   parseOnlyScript,
   parseSFC,
   transform
-} from "./chunk-7FIMRVQS.esm.js";
+} from "./chunk-CUCUXW56.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.2.1
+ * @vureact/compiler-core v1.3.0
  * (c) 2025-present Ruihong Zhong (Ryan John)
  * @license MIT
  */
@@ -18,7 +18,7 @@
 
 
 
-var _chunkSQRJUILRjs = require('./chunk-SQRJUILR.js');
+var _chunk7LBUUA24js = require('./chunk-7LBUUA24.js');
 
 
 
@@ -33,4 +33,4 @@ var _chunkSQRJUILRjs = require('./chunk-SQRJUILR.js');
 
 
 
-exports.BaseCompiler = _chunkSQRJUILRjs.BaseCompiler; exports.CacheKey = _chunkSQRJUILRjs.CacheKey; exports.FileCompiler = _chunkSQRJUILRjs.FileCompiler; exports.Helper = _chunkSQRJUILRjs.Helper; exports.VuReact = _chunkSQRJUILRjs.VuReact; exports.defineConfig = _chunkSQRJUILRjs.defineConfig; exports.generate = _chunkSQRJUILRjs.generate; exports.generateComponent = _chunkSQRJUILRjs.generateComponent; exports.generateOnlyScript = _chunkSQRJUILRjs.generateOnlyScript; exports.parse = _chunkSQRJUILRjs.parse; exports.parseOnlyScript = _chunkSQRJUILRjs.parseOnlyScript; exports.parseSFC = _chunkSQRJUILRjs.parseSFC; exports.transform = _chunkSQRJUILRjs.transform;
+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;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vureact/compiler-core",
-  "version": "1.2.1",
-  "description": "🌀 Next Vue to React compiler, compiles Vue 3 syntax into runnable React 18+ code.",
+  "version": "1.3.0",
+  "description": "🌀 Next Vue 3 to React 18+ intelligent compilation toolchain",
   "author": "Ruihong Zhong (Ryan John)",
   "license": "MIT",
   "type": "module",
@@ -17,7 +17,8 @@
   },
   "files": [
     "bin",
-    "lib"
+    "lib",
+    "templates"
   ],
   "keywords": [
     "vue",
@@ -30,10 +31,16 @@
     "vue3",
     "react18",
     "migration",
-    "incremental",
+    "svelte",
     "typescript",
     "jsx",
-    "sfc"
+    "sfc",
+    "veaury",
+    "mitosis",
+    "vue3-to-react",
+    "vue-react",
+    "react-vue",
+    "vue-in-react"
   ],
   "homepage": "https://vureact.top",
   "repository": {
@@ -75,6 +82,7 @@
     "ora": "^9.1.0",
     "postcss": "^8.5.6",
     "sass": "^1.97.3",
+    "update-notifier": "^7.3.1",
     "xxhashjs": "^0.2.2"
   },
   "engines": {

package/templates/route-setup-notes.md

@@ -0,0 +1,192 @@
+# 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)