@thelacanians/vue-native-cli 0.6.3 → 0.6.4

package/dist/cli.js

@@ -2,22 +2,36 @@
 
 // src/cli.ts
 import { program } from "commander";
+import pc6 from "picocolors";
 
 // src/commands/build.ts
 import { Command } from "commander";
 import { spawn, execSync } from "child_process";
-import { existsSync, readdirSync, mkdirSync, copyFileSync } from "fs";
-import { join, basename } from "path";
+import { existsSync as existsSync2, readdirSync, mkdirSync, copyFileSync } from "fs";
+import { join as join2, basename } from "path";
 import pc from "picocolors";
+
+// src/config.ts
+import { existsSync } from "fs";
+import { join } from "path";
+import { pathToFileURL } from "url";
+var ConfigError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ConfigError";
+  }
+};
+
+// src/commands/build.ts
 function findXcodeProject(iosDir) {
-  if (!existsSync(iosDir)) return null;
+  if (!existsSync2(iosDir)) return null;
   for (const ext of [".xcworkspace", ".xcodeproj"]) {
     try {
       const entries = readdirSync(iosDir);
       const match = entries.find((e) => e.endsWith(ext));
       if (match) {
         return {
-          path: join(iosDir, match),
+          path: join2(iosDir, match),
           isWorkspace: ext === ".xcworkspace"
         };
       }
@@ -27,13 +41,13 @@ function findXcodeProject(iosDir) {
   return null;
 }
 function findReleaseApk(androidDir) {
-  const apkDir = join(androidDir, "app", "build", "outputs", "apk", "release");
-  if (existsSync(apkDir)) {
+  const apkDir = join2(androidDir, "app", "build", "outputs", "apk", "release");
+  if (existsSync2(apkDir)) {
     try {
       const entries = readdirSync(apkDir);
       const apk = entries.find((e) => e.endsWith(".apk") && !e.includes("androidTest"));
       if (apk) {
-        return join(apkDir, apk);
+        return join2(apkDir, apk);
       }
     } catch {
     }
@@ -41,13 +55,13 @@ function findReleaseApk(androidDir) {
   return null;
 }
 function findReleaseAab(androidDir) {
-  const aabDir = join(androidDir, "app", "build", "outputs", "bundle", "release");
-  if (existsSync(aabDir)) {
+  const aabDir = join2(androidDir, "app", "build", "outputs", "bundle", "release");
+  if (existsSync2(aabDir)) {
     try {
       const entries = readdirSync(aabDir);
       const aab = entries.find((e) => e.endsWith(".aab"));
       if (aab) {
-        return join(aabDir, aab);
+        return join2(aabDir, aab);
       }
     } catch {
     }
@@ -55,17 +69,16 @@ function findReleaseAab(androidDir) {
   return null;
 }
 function ensureOutputDir(outputPath) {
-  if (!existsSync(outputPath)) {
+  if (!existsSync2(outputPath)) {
     mkdirSync(outputPath, { recursive: true });
   }
 }
 var buildCommand = new Command("build").description("Create a release build of the app").argument("<platform>", "platform to build for (ios, android, macos)").option("--mode <mode>", "build mode", "release").option("--output <path>", "output directory for the build artifact", "./build").option("--scheme <scheme>", "Xcode scheme to build (iOS only)").option("--aab", "build Android App Bundle (.aab) instead of APK").action(async (platform, options) => {
   if (platform !== "ios" && platform !== "android" && platform !== "macos") {
-    console.error(pc.red('Platform must be "ios", "android", or "macos"'));
-    process.exit(1);
+    throw new ConfigError('Platform must be "ios", "android", or "macos"');
   }
   const cwd = process.cwd();
-  const outputDir = join(cwd, options.output);
+  const outputDir = join2(cwd, options.output);
   const platformLabel = platform === "ios" ? "iOS" : platform === "android" ? "Android" : "macOS";
   console.log(pc.cyan(`
   Vue Native \u2014 ${options.mode.charAt(0).toUpperCase() + options.mode.slice(1)} Build (${platformLabel})
@@ -75,8 +88,7 @@ var buildCommand = new Command("build").description("Create a release build of t
     execSync("bun run vite build --mode production", { cwd, stdio: "inherit" });
     console.log(pc.green("  \u2713 Bundle built\n"));
   } catch {
-    console.error(pc.red("  \u2717 Bundle build failed"));
-    process.exit(1);
+    throw new ConfigError("Bundle build failed");
   }
   if (platform === "ios") {
     buildIOS(cwd, outputDir, options);
@@ -87,7 +99,7 @@ var buildCommand = new Command("build").description("Create a release build of t
   }
 });
 function buildIOS(cwd, outputDir, options) {
-  const iosDir = join(cwd, "ios");
+  const iosDir = join2(cwd, "ios");
   const project = findXcodeProject(iosDir);
   if (!project) {
     console.log(pc.yellow("  No Xcode project found in ./ios/"));
@@ -98,7 +110,7 @@ function buildIOS(cwd, outputDir, options) {
   const projectFlag = project.isWorkspace ? "-workspace" : "-project";
   const scheme = options.scheme || project.path.split("/").pop()?.replace(/\.(xcworkspace|xcodeproj)$/, "") || "App";
   const configuration = options.mode === "release" ? "Release" : "Debug";
-  const archivePath = join(outputDir, `${scheme}.xcarchive`);
+  const archivePath = join2(outputDir, `${scheme}.xcarchive`);
   ensureOutputDir(outputDir);
   console.log(pc.white(`  Archiving ${scheme} (${configuration})...`));
   console.log(pc.dim(`  Archive path: ${archivePath}`));
@@ -152,10 +164,10 @@ function buildIOS(cwd, outputDir, options) {
   xcodebuild.on("close", (code) => {
     if (code !== 0) {
       console.error(pc.red(`  \u2717 Archive failed (exit code ${code})`));
-      process.exit(1);
+      throw new ConfigError(`iOS archive failed with exit code ${code}`);
     }
     console.log(pc.green("  \u2713 Archive successful\n"));
-    if (existsSync(archivePath)) {
+    if (existsSync2(archivePath)) {
       console.log(pc.green(`  Archive: ${archivePath}`));
       console.log(pc.dim("  To export an IPA, open the archive in Xcode Organizer or run:"));
       console.log(pc.dim(`  xcodebuild -exportArchive -archivePath "${archivePath}" -exportOptionsPlist ExportOptions.plist -exportPath "${outputDir}"
@@ -166,18 +178,18 @@ function buildIOS(cwd, outputDir, options) {
   });
 }
 function buildAndroid(cwd, outputDir, options) {
-  const androidDir = join(cwd, "android");
-  if (!existsSync(androidDir)) {
+  const androidDir = join2(cwd, "android");
+  if (!existsSync2(androidDir)) {
     console.log(pc.yellow("  No android/ directory found."));
     console.log(pc.dim("  To add Android support, create an Android project in the android/ directory."));
     console.log(pc.dim("  Bundle has been built to dist/vue-native-bundle.js\n"));
     return;
   }
-  const gradlew = join(androidDir, "gradlew");
-  if (!existsSync(gradlew)) {
-    console.error(pc.red("  \u2717 gradlew not found in android/ directory"));
-    console.log(pc.dim("  Make sure your Android project has the Gradle wrapper.\n"));
-    process.exit(1);
+  const gradlew = join2(androidDir, "gradlew");
+  if (!existsSync2(gradlew)) {
+    throw new ConfigError(
+      "gradlew not found in android/ directory. Make sure your Android project has the Gradle wrapper."
+    );
   }
   const gradleTask = options.aab ? "bundleRelease" : "assembleRelease";
   const artifactType = options.aab ? "AAB" : "APK";
@@ -219,13 +231,13 @@ function buildAndroid(cwd, outputDir, options) {
   gradle.on("close", (code) => {
     if (code !== 0) {
       console.error(pc.red(`  \u2717 Gradle build failed (exit code ${code})`));
-      process.exit(1);
+      throw new ConfigError(`Android Gradle build failed with exit code ${code}`);
     }
     console.log(pc.green("  \u2713 Build successful\n"));
     if (options.aab) {
       const aabPath = findReleaseAab(androidDir);
       if (aabPath) {
-        const destPath = join(outputDir, basename(aabPath));
+        const destPath = join2(outputDir, basename(aabPath));
         copyFileSync(aabPath, destPath);
         console.log(pc.green(`  AAB copied to: ${destPath}`));
         console.log(pc.dim("  Upload this file to the Google Play Console.\n"));
@@ -236,7 +248,7 @@ function buildAndroid(cwd, outputDir, options) {
     } else {
       const apkPath = findReleaseApk(androidDir);
       if (apkPath) {
-        const destPath = join(outputDir, basename(apkPath));
+        const destPath = join2(outputDir, basename(apkPath));
         copyFileSync(apkPath, destPath);
         console.log(pc.green(`  APK copied to: ${destPath}`));
         console.log(pc.dim('  Install with: adb install -r "' + destPath + '"\n'));
@@ -248,7 +260,7 @@ function buildAndroid(cwd, outputDir, options) {
   });
 }
 function buildMacOS(cwd, outputDir, options) {
-  const macosDir = join(cwd, "macos");
+  const macosDir = join2(cwd, "macos");
   const project = findXcodeProject(macosDir);
   if (!project) {
     console.log(pc.yellow("  No Xcode project found in ./macos/"));
@@ -259,7 +271,7 @@ function buildMacOS(cwd, outputDir, options) {
   const projectFlag = project.isWorkspace ? "-workspace" : "-project";
   const scheme = options.scheme || project.path.split("/").pop()?.replace(/\.(xcworkspace|xcodeproj)$/, "") || "App";
   const configuration = options.mode === "release" ? "Release" : "Debug";
-  const archivePath = join(outputDir, `${scheme}.xcarchive`);
+  const archivePath = join2(outputDir, `${scheme}.xcarchive`);
   ensureOutputDir(outputDir);
   console.log(pc.white(`  Archiving ${scheme} (${configuration}) for macOS...`));
   console.log(pc.dim(`  Archive path: ${archivePath}`));
@@ -313,10 +325,10 @@ function buildMacOS(cwd, outputDir, options) {
   xcodebuild.on("close", (code) => {
     if (code !== 0) {
       console.error(pc.red(`  \u2717 Archive failed (exit code ${code})`));
-      process.exit(1);
+      throw new ConfigError(`macOS archive failed with exit code ${code}`);
     }
     console.log(pc.green("  \u2713 Archive successful\n"));
-    if (existsSync(archivePath)) {
+    if (existsSync2(archivePath)) {
       console.log(pc.green(`  Archive: ${archivePath}`));
       console.log(pc.dim("  To export a .app or .pkg, open the archive in Xcode Organizer or run:"));
       console.log(pc.dim(`  xcodebuild -exportArchive -archivePath "${archivePath}" -exportOptionsPlist ExportOptions.plist -exportPath "${outputDir}"
@@ -330,29 +342,54 @@ function buildMacOS(cwd, outputDir, options) {
 // src/commands/create.ts
 import { Command as Command2 } from "commander";
 import { cp, mkdir, writeFile } from "fs/promises";
-import { join as join2, dirname } from "path";
+import { join as join3, dirname } from "path";
 import { fileURLToPath } from "url";
-import { existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync3, readFileSync } from "fs";
 import pc2 from "picocolors";
 var VERSION = "0.6.2";
-var JS_PACKAGE_VERSION = "^0.6.2";
-var VITE_PLUGIN_VUE_VERSION = "^6.0.5";
-var VITE_VERSION = "^8.0.0";
+function getTemplateVersions() {
+  try {
+    const cliDir = dirname(dirname(fileURLToPath(import.meta.url)));
+    const pkg = JSON.parse(readFileSync(join3(cliDir, "package.json"), "utf8"));
+    const jsVersion = `^${pkg.version}`;
+    const viteDevDep = pkg.devDependencies?.vite;
+    const viteVuePluginDevDep = pkg.devDependencies?.["@vitejs/plugin-vue"];
+    return {
+      JS_PACKAGE_VERSION: jsVersion,
+      VITE_PLUGIN_VUE_VERSION: viteVuePluginDevDep ?? "^6.0.5",
+      VITE_VERSION: viteDevDep ?? "^8.0.0"
+    };
+  } catch {
+    return {
+      JS_PACKAGE_VERSION: `^${VERSION}`,
+      VITE_PLUGIN_VUE_VERSION: "^6.0.5",
+      VITE_VERSION: "^8.0.0"
+    };
+  }
+}
+var { JS_PACKAGE_VERSION, VITE_PLUGIN_VUE_VERSION, VITE_VERSION } = getTemplateVersions();
+var VALID_NAME = /^[a-zA-Z0-9_-]+$/i;
 var createCommand = new Command2("create").description("Create a new Vue Native project").argument("<name>", "project name").option("-t, --template <template>", "project template (blank, tabs, drawer)", "blank").action(async (name, options) => {
   const template = options.template;
   if (!["blank", "tabs", "drawer"].includes(template)) {
-    console.error(pc2.red(`Invalid template "${template}". Choose: blank, tabs, drawer`));
-    process.exit(1);
+    throw new ConfigError(
+      `Invalid template "${template}". Choose: blank, tabs, drawer`
+    );
   }
-  const dir = join2(process.cwd(), name);
+  if (!VALID_NAME.test(name)) {
+    throw new ConfigError(
+      `Project name "${name}" must match /^[a-zA-Z0-9_-]+$/i`
+    );
+  }
+  const dir = join3(process.cwd(), name);
   console.log(pc2.cyan(`
 Creating Vue Native project: ${pc2.bold(name)} (template: ${template})
 `));
   try {
     await mkdir(dir, { recursive: true });
-    await mkdir(join2(dir, "app"), { recursive: true });
-    await mkdir(join2(dir, "app", "pages"), { recursive: true });
-    await writeFile(join2(dir, "package.json"), JSON.stringify({
+    await mkdir(join3(dir, "app"), { recursive: true });
+    await mkdir(join3(dir, "app", "pages"), { recursive: true });
+    await writeFile(join3(dir, "package.json"), JSON.stringify({
       name,
       version: "0.0.1",
       private: true,
@@ -374,7 +411,7 @@ Creating Vue Native project: ${pc2.bold(name)} (template: ${template})
         "typescript": "^5.7.0"
       }
     }, null, 2));
-    await writeFile(join2(dir, "vite.config.ts"), `import { defineConfig } from 'vite'
+    await writeFile(join3(dir, "vite.config.ts"), `import { defineConfig } from 'vite'
 import vue from '@vitejs/plugin-vue'
 import vueNative from '@thelacanians/vue-native-vite-plugin'
 
@@ -382,7 +419,7 @@ export default defineConfig({
   plugins: [vue(), vueNative()],
 })
 `);
-    await writeFile(join2(dir, "tsconfig.json"), JSON.stringify({
+    await writeFile(join3(dir, "tsconfig.json"), JSON.stringify({
       compilerOptions: {
         target: "ES2020",
         module: "ESNext",
@@ -398,12 +435,12 @@ export default defineConfig({
       include: ["app/**/*", "env.d.ts"]
     }, null, 2));
     await generateTemplateFiles(dir, name, template);
-    const iosDir = join2(dir, "ios");
-    const iosSrcDir = join2(iosDir, "Sources");
+    const iosDir = join3(dir, "ios");
+    const iosSrcDir = join3(iosDir, "Sources");
     await mkdir(iosSrcDir, { recursive: true });
     const xcodeProjectName = name.replace(/[^a-zA-Z0-9]/g, "");
     const bundleId = `com.vuenative.${name.replace(/[^a-zA-Z0-9]/g, "").toLowerCase()}`;
-    await writeFile(join2(iosDir, "project.yml"), `name: ${xcodeProjectName}
+    await writeFile(join3(iosDir, "project.yml"), `name: ${xcodeProjectName}
 options:
   bundleIdPrefix: com.vuenative
   deploymentTarget:
@@ -434,7 +471,7 @@ targets:
       - path: ../dist/vue-native-bundle.js
         optional: true
 `);
-    await writeFile(join2(iosSrcDir, "Info.plist"), `<?xml version="1.0" encoding="UTF-8"?>
+    await writeFile(join3(iosSrcDir, "Info.plist"), `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
@@ -500,7 +537,7 @@ targets:
 </dict>
 </plist>
 `);
-    await writeFile(join2(iosSrcDir, "AppDelegate.swift"), `import UIKit
+    await writeFile(join3(iosSrcDir, "AppDelegate.swift"), `import UIKit
 
 @main
 class AppDelegate: UIResponder, UIApplicationDelegate {
@@ -524,7 +561,7 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
     }
 }
 `);
-    await writeFile(join2(iosSrcDir, "SceneDelegate.swift"), `import UIKit
+    await writeFile(join3(iosSrcDir, "SceneDelegate.swift"), `import UIKit
 import VueNativeCore
 
 class SceneDelegate: UIResponder, UIWindowSceneDelegate {
@@ -552,29 +589,29 @@ class AppViewController: VueNativeViewController {
     #endif
 }
 `);
-    const androidDir = join2(dir, "android");
-    const androidAppDir = join2(androidDir, "app");
+    const androidDir = join3(dir, "android");
+    const androidAppDir = join3(androidDir, "app");
     const androidPkg = `com.vuenative.${name.replace(/[^a-zA-Z0-9]/g, "").toLowerCase()}`;
     const androidPkgPath = androidPkg.replace(/\./g, "/");
-    const androidSrcDir = join2(androidAppDir, "src", "main");
-    const androidKotlinDir = join2(androidSrcDir, "kotlin", androidPkgPath);
-    const androidResValuesDir = join2(androidSrcDir, "res", "values");
-    const androidResXmlDir = join2(androidSrcDir, "res", "xml");
-    const androidDebugResXmlDir = join2(androidAppDir, "src", "debug", "res", "xml");
-    const androidGradleWrapperDir = join2(androidDir, "gradle", "wrapper");
+    const androidSrcDir = join3(androidAppDir, "src", "main");
+    const androidKotlinDir = join3(androidSrcDir, "kotlin", androidPkgPath);
+    const androidResValuesDir = join3(androidSrcDir, "res", "values");
+    const androidResXmlDir = join3(androidSrcDir, "res", "xml");
+    const androidDebugResXmlDir = join3(androidAppDir, "src", "debug", "res", "xml");
+    const androidGradleWrapperDir = join3(androidDir, "gradle", "wrapper");
     await mkdir(androidKotlinDir, { recursive: true });
     await mkdir(androidResValuesDir, { recursive: true });
     await mkdir(androidResXmlDir, { recursive: true });
     await mkdir(androidDebugResXmlDir, { recursive: true });
     await mkdir(androidGradleWrapperDir, { recursive: true });
-    await writeFile(join2(androidDir, "build.gradle.kts"), `// Top-level build file
+    await writeFile(join3(androidDir, "build.gradle.kts"), `// Top-level build file
 plugins {
     id("com.android.application") version "8.7.3" apply false
     id("com.android.library") version "8.7.3" apply false
     id("org.jetbrains.kotlin.android") version "2.0.21" apply false
 }
 `);
-    await writeFile(join2(androidDir, "settings.gradle.kts"), `pluginManagement {
+    await writeFile(join3(androidDir, "settings.gradle.kts"), `pluginManagement {
     repositories {
         google()
         mavenCentral()
@@ -600,7 +637,7 @@ dependencyResolutionManagement {
 rootProject.name = "${name}"
 include(":app")
 `);
-    await writeFile(join2(androidAppDir, "build.gradle.kts"), `plugins {
+    await writeFile(join3(androidAppDir, "build.gradle.kts"), `plugins {
     id("com.android.application")
     id("org.jetbrains.kotlin.android")
 }
@@ -648,13 +685,13 @@ dependencies {
     implementation("androidx.core:core-ktx:1.15.0")
 }
 `);
-    await writeFile(join2(androidAppDir, "proguard-rules.pro"), `# Vue Native
+    await writeFile(join3(androidAppDir, "proguard-rules.pro"), `# Vue Native
 -keep class com.vuenative.** { *; }
 
 # J2V8
 -keep class com.eclipsesource.v8.** { *; }
 `);
-    await writeFile(join2(androidSrcDir, "AndroidManifest.xml"), `<?xml version="1.0" encoding="utf-8"?>
+    await writeFile(join3(androidSrcDir, "AndroidManifest.xml"), `<?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
     <uses-permission android:name="android.permission.INTERNET" />
 
@@ -677,12 +714,12 @@ dependencies {
     </application>
 </manifest>
 `);
-    await writeFile(join2(androidResValuesDir, "strings.xml"), `<?xml version="1.0" encoding="utf-8"?>
+    await writeFile(join3(androidResValuesDir, "strings.xml"), `<?xml version="1.0" encoding="utf-8"?>
 <resources>
     <string name="app_name">${name}</string>
 </resources>
 `);
-    await writeFile(join2(androidResValuesDir, "themes.xml"), `<?xml version="1.0" encoding="utf-8"?>
+    await writeFile(join3(androidResValuesDir, "themes.xml"), `<?xml version="1.0" encoding="utf-8"?>
 <resources>
     <style name="Theme.VueNative" parent="Theme.MaterialComponents.Light.NoActionBar">
         <item name="colorPrimary">#4F46E5</item>
@@ -695,12 +732,12 @@ dependencies {
     </style>
 </resources>
 `);
-    await writeFile(join2(androidResXmlDir, "network_security_config.xml"), `<?xml version="1.0" encoding="utf-8"?>
+    await writeFile(join3(androidResXmlDir, "network_security_config.xml"), `<?xml version="1.0" encoding="utf-8"?>
 <network-security-config>
     <base-config cleartextTrafficPermitted="false" />
 </network-security-config>
 `);
-    await writeFile(join2(androidDebugResXmlDir, "network_security_config.xml"), `<?xml version="1.0" encoding="utf-8"?>
+    await writeFile(join3(androidDebugResXmlDir, "network_security_config.xml"), `<?xml version="1.0" encoding="utf-8"?>
 <network-security-config>
     <domain-config cleartextTrafficPermitted="true">
         <domain includeSubdomains="true">localhost</domain>
@@ -709,7 +746,7 @@ dependencies {
     </domain-config>
 </network-security-config>
 `);
-    await writeFile(join2(androidKotlinDir, "MainActivity.kt"), `package ${androidPkg}
+    await writeFile(join3(androidKotlinDir, "MainActivity.kt"), `package ${androidPkg}
 
 import com.vuenative.core.VueNativeActivity
 
@@ -723,20 +760,20 @@ class MainActivity : VueNativeActivity() {
     }
 }
 `);
-    await writeFile(join2(androidDir, "gradle.properties"), `# Project-wide Gradle settings
+    await writeFile(join3(androidDir, "gradle.properties"), `# Project-wide Gradle settings
 org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
 android.useAndroidX=true
 kotlin.code.style=official
 android.nonTransitiveRClass=true
 `);
-    await writeFile(join2(androidGradleWrapperDir, "gradle-wrapper.properties"), `distributionBase=GRADLE_USER_HOME
+    await writeFile(join3(androidGradleWrapperDir, "gradle-wrapper.properties"), `distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 distributionUrl=https\\://services.gradle.org/distributions/gradle-8.11.1-bin.zip
 networkTimeout=10000
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
 `);
-    await writeFile(join2(dir, "vue-native.config.ts"), `import { defineConfig } from '@thelacanians/vue-native-cli'
+    await writeFile(join3(dir, "vue-native.config.ts"), `import { defineConfig } from '@thelacanians/vue-native-cli'
 
 export default defineConfig({
   name: '${name}',
@@ -751,7 +788,7 @@ export default defineConfig({
   },
 })
 `);
-    await writeFile(join2(dir, "env.d.ts"), `/// <reference types="vite/client" />
+    await writeFile(join3(dir, "env.d.ts"), `/// <reference types="vite/client" />
 declare module '*.vue' {
   import type { DefineComponent } from '@thelacanians/vue-native-runtime'
   const component: DefineComponent<{}, {}, any>
@@ -759,7 +796,7 @@ declare module '*.vue' {
 }
 declare const __DEV__: boolean
 `);
-    await writeFile(join2(dir, ".gitignore"), `node_modules/
+    await writeFile(join3(dir, ".gitignore"), `node_modules/
 dist/
 *.xcuserstate
 *.xcuserdatad/
@@ -782,9 +819,9 @@ local.properties
 *.jks
 `);
     const cliDir = dirname(dirname(fileURLToPath(import.meta.url)));
-    const bundledNative = join2(cliDir, "native");
-    if (existsSync2(bundledNative)) {
-      const nativeDir = join2(dir, "native");
+    const bundledNative = join3(cliDir, "native");
+    if (existsSync3(bundledNative)) {
+      const nativeDir = join3(dir, "native");
       await cp(bundledNative, nativeDir, { recursive: true });
       console.log(pc2.dim("  Bundled native/ copied as fallback.\n"));
     }
@@ -800,12 +837,13 @@ local.properties
     console.log(pc2.dim("    cd android && gradle wrapper && cd .."));
     console.log(pc2.white("    vue-native run android\n"));
   } catch (err) {
-    console.error(pc2.red(`Error creating project: ${err.message}`));
-    process.exit(1);
+    throw new ConfigError(
+      `Error creating project: ${err.message}`
+    );
   }
 });
 async function generateTemplateFiles(dir, name, template) {
-  const pagesDir = join2(dir, "app", "pages");
+  const pagesDir = join3(dir, "app", "pages");
   if (template === "blank") {
     await generateBlankTemplate(dir, pagesDir);
   } else if (template === "tabs") {
@@ -815,7 +853,7 @@ async function generateTemplateFiles(dir, name, template) {
   }
 }
 async function generateBlankTemplate(dir, pagesDir) {
-  await writeFile(join2(dir, "app", "main.ts"), `import { createApp } from '@thelacanians/vue-native-runtime'
+  await writeFile(join3(dir, "app", "main.ts"), `import { createApp } from '@thelacanians/vue-native-runtime'
 import { createRouter } from '@thelacanians/vue-native-navigation'
 import App from './App.vue'
 import Home from './pages/Home.vue'
@@ -828,7 +866,7 @@ const app = createApp(App)
 app.use(router)
 app.start()
 `);
-  await writeFile(join2(dir, "app", "App.vue"), `<template>
+  await writeFile(join3(dir, "app", "App.vue"), `<template>
   <VSafeArea :style="{ flex: 1, backgroundColor: '#ffffff' }">
     <RouterView />
   </VSafeArea>
@@ -838,7 +876,7 @@ app.start()
 import { RouterView } from '@thelacanians/vue-native-navigation'
 </script>
 `);
-  await writeFile(join2(pagesDir, "Home.vue"), `<script setup lang="ts">
+  await writeFile(join3(pagesDir, "Home.vue"), `<script setup lang="ts">
 import { ref } from 'vue'
 import { createStyleSheet } from '@thelacanians/vue-native-runtime'
 
@@ -890,13 +928,13 @@ const styles = createStyleSheet({
 `);
 }
 async function generateTabsTemplate(dir, pagesDir) {
-  await writeFile(join2(dir, "app", "main.ts"), `import { createApp } from '@thelacanians/vue-native-runtime'
+  await writeFile(join3(dir, "app", "main.ts"), `import { createApp } from '@thelacanians/vue-native-runtime'
 import App from './App.vue'
 
 const app = createApp(App)
 app.start()
 `);
-  await writeFile(join2(dir, "app", "App.vue"), `<script setup lang="ts">
+  await writeFile(join3(dir, "app", "App.vue"), `<script setup lang="ts">
 import { createTabNavigator } from '@thelacanians/vue-native-navigation'
 import Home from './pages/Home.vue'
 import Settings from './pages/Settings.vue'
@@ -915,7 +953,7 @@ const { TabNavigator } = createTabNavigator()
   </VSafeArea>
 </template>
 `);
-  await writeFile(join2(pagesDir, "Home.vue"), `<script setup lang="ts">
+  await writeFile(join3(pagesDir, "Home.vue"), `<script setup lang="ts">
 import { ref } from 'vue'
 import { createStyleSheet } from '@thelacanians/vue-native-runtime'
 
@@ -959,7 +997,7 @@ const styles = createStyleSheet({
   </VView>
 </template>
 `);
-  await writeFile(join2(pagesDir, "Settings.vue"), `<script setup lang="ts">
+  await writeFile(join3(pagesDir, "Settings.vue"), `<script setup lang="ts">
 import { ref } from 'vue'
 import { createStyleSheet } from '@thelacanians/vue-native-runtime'
 
@@ -1003,13 +1041,13 @@ const styles = createStyleSheet({
 `);
 }
 async function generateDrawerTemplate(dir, pagesDir) {
-  await writeFile(join2(dir, "app", "main.ts"), `import { createApp } from '@thelacanians/vue-native-runtime'
+  await writeFile(join3(dir, "app", "main.ts"), `import { createApp } from '@thelacanians/vue-native-runtime'
 import App from './App.vue'
 
 const app = createApp(App)
 app.start()
 `);
-  await writeFile(join2(dir, "app", "App.vue"), `<script setup lang="ts">
+  await writeFile(join3(dir, "app", "App.vue"), `<script setup lang="ts">
 import { createDrawerNavigator } from '@thelacanians/vue-native-navigation'
 import Home from './pages/Home.vue'
 import About from './pages/About.vue'
@@ -1028,7 +1066,7 @@ const { DrawerNavigator } = createDrawerNavigator()
   </VSafeArea>
 </template>
 `);
-  await writeFile(join2(pagesDir, "Home.vue"), `<script setup lang="ts">
+  await writeFile(join3(pagesDir, "Home.vue"), `<script setup lang="ts">
 import { createStyleSheet } from '@thelacanians/vue-native-runtime'
 import { useDrawer } from '@thelacanians/vue-native-navigation'
 
@@ -1081,7 +1119,7 @@ const styles = createStyleSheet({
   </VView>
 </template>
 `);
-  await writeFile(join2(pagesDir, "About.vue"), `<script setup lang="ts">
+  await writeFile(join3(pagesDir, "About.vue"), `<script setup lang="ts">
 import { createStyleSheet } from '@thelacanians/vue-native-runtime'
 import { useDrawer } from '@thelacanians/vue-native-navigation'
 
@@ -1140,8 +1178,8 @@ const styles = createStyleSheet({
 import { Command as Command3 } from "commander";
 import { spawn as spawn2, execSync as execSync2 } from "child_process";
 import { readFile } from "fs/promises";
-import { existsSync as existsSync3 } from "fs";
-import { join as join3 } from "path";
+import { existsSync as existsSync4 } from "fs";
+import { join as join4 } from "path";
 import { watch } from "chokidar";
 import { WebSocketServer, WebSocket } from "ws";
 import pc3 from "picocolors";
@@ -1194,7 +1232,7 @@ function detectAndroidEmulators() {
 var devCommand = new Command3("dev").description("Start the Vue Native dev server with hot reload").option("-p, --port <port>", "WebSocket port for hot reload", String(DEFAULT_PORT)).option("--ios", "auto-detect and launch iOS Simulator").option("--android", "auto-detect Android emulator").option("--simulator <name>", "specify iOS Simulator name").action(async (options) => {
   const port = parseInt(options.port, 10);
   const cwd = process.cwd();
-  const bundlePath = join3(cwd, BUNDLE_FILE);
+  const bundlePath = join4(cwd, BUNDLE_FILE);
   console.log(pc3.cyan("\n  Vue Native Dev Server\n"));
   if (options.ios) {
     console.log(pc3.white("  Detecting iOS Simulators..."));
@@ -1290,15 +1328,15 @@ var devCommand = new Command3("dev").description("Start the Vue Native dev serve
   if (lanIP) {
     console.log(pc3.white(`  LAN address:       ${pc3.bold(`ws://${lanIP}:${port}`)}`));
   }
-  const iosDir = join3(cwd, "ios");
-  const androidDir = join3(cwd, "android");
-  if (existsSync3(iosDir)) {
+  const iosDir = join4(cwd, "ios");
+  const androidDir = join4(cwd, "android");
+  if (existsSync4(iosDir)) {
     console.log(pc3.dim(`  iOS Simulator:     ws://localhost:${port}`));
     if (lanIP) {
       console.log(pc3.dim(`  iOS Device (WiFi): ws://${lanIP}:${port}`));
     }
   }
-  if (existsSync3(androidDir)) {
+  if (existsSync4(androidDir)) {
     console.log(pc3.dim(`  Android emulator:  ws://10.0.2.2:${port}`));
     if (lanIP) {
       console.log(pc3.dim(`  Android Device:    ws://${lanIP}:${port}`));
@@ -1362,28 +1400,28 @@ var devCommand = new Command3("dev").description("Start the Vue Native dev serve
 // src/commands/run.ts
 import { Command as Command4 } from "commander";
 import { spawn as spawn3, execSync as execSync3 } from "child_process";
-import { existsSync as existsSync4, readdirSync as readdirSync2, readFileSync } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync2 } from "fs";
+import { join as join5 } from "path";
 import pc4 from "picocolors";
 function findAppPath(_buildDir) {
-  const derivedDataBase = join4(
+  const derivedDataBase = join5(
     process.env.HOME || "~",
     "Library/Developer/Xcode/DerivedData"
   );
-  if (existsSync4(derivedDataBase)) {
+  if (existsSync5(derivedDataBase)) {
     try {
       const projects = readdirSync2(derivedDataBase);
       for (const project of projects.reverse()) {
-        const productsDir = join4(
+        const productsDir = join5(
           derivedDataBase,
           project,
           "Build/Products/Debug-iphonesimulator"
         );
-        if (existsSync4(productsDir)) {
+        if (existsSync5(productsDir)) {
           const entries = readdirSync2(productsDir);
           const app = entries.find((e) => e.endsWith(".app"));
           if (app) {
-            return join4(productsDir, app);
+            return join5(productsDir, app);
           }
         }
       }
@@ -1393,10 +1431,10 @@ function findAppPath(_buildDir) {
   return null;
 }
 function readBundleId(iosDir) {
-  const plistPath = join4(iosDir, "Sources", "Info.plist");
-  if (existsSync4(plistPath)) {
+  const plistPath = join5(iosDir, "Sources", "Info.plist");
+  if (existsSync5(plistPath)) {
     try {
-      const content = readFileSync(plistPath, "utf8");
+      const content = readFileSync2(plistPath, "utf8");
       const match = content.match(
         /<key>CFBundleIdentifier<\/key>\s*<string>([^<]+)<\/string>/
       );
@@ -1409,13 +1447,13 @@ function readBundleId(iosDir) {
   return "com.vuenative.app";
 }
 function findApkPath(androidDir) {
-  const apkDir = join4(androidDir, "app", "build", "outputs", "apk", "debug");
-  if (existsSync4(apkDir)) {
+  const apkDir = join5(androidDir, "app", "build", "outputs", "apk", "debug");
+  if (existsSync5(apkDir)) {
     try {
       const entries = readdirSync2(apkDir);
       const apk = entries.find((e) => e.endsWith(".apk") && !e.includes("androidTest"));
       if (apk) {
-        return join4(apkDir, apk);
+        return join5(apkDir, apk);
       }
     } catch {
     }
@@ -1424,8 +1462,7 @@ function findApkPath(androidDir) {
 }
 var runCommand = new Command4("run").description("Build and run the app").argument("<platform>", "platform to run on (ios, android, macos)").option("--device", "run on physical device instead of simulator").option("--scheme <scheme>", "Xcode scheme to build").option("--simulator <name>", "simulator name", "iPhone 16").option("--bundle-id <id>", "app bundle identifier").option("--package <name>", "Android package name", "com.vuenative.app").option("--activity <name>", "Android activity name", ".MainActivity").action(async (platform, options) => {
   if (platform !== "ios" && platform !== "android" && platform !== "macos") {
-    console.error(pc4.red('Platform must be "ios", "android", or "macos"'));
-    process.exit(1);
+    throw new ConfigError('Platform must be "ios", "android", or "macos"');
   }
   const cwd = process.cwd();
   const platformLabel = platform === "ios" ? "iOS" : platform === "android" ? "Android" : "macOS";
@@ -1437,8 +1474,7 @@ var runCommand = new Command4("run").description("Build and run the app").argume
     execSync3("bun run vite build", { cwd, stdio: "inherit" });
     console.log(pc4.green("  \u2713 Bundle built\n"));
   } catch {
-    console.error(pc4.red("  \u2717 Bundle build failed"));
-    process.exit(1);
+    throw new ConfigError("Bundle build failed");
   }
   if (platform === "ios") {
     runIOS(cwd, options);
@@ -1450,14 +1486,14 @@ var runCommand = new Command4("run").description("Build and run the app").argume
 });
 function runIOS(cwd, options) {
   let xcodeProject = null;
-  const iosDir = join4(cwd, "ios");
-  if (existsSync4(iosDir)) {
+  const iosDir = join5(cwd, "ios");
+  if (existsSync5(iosDir)) {
     for (const ext of [".xcworkspace", ".xcodeproj"]) {
       try {
         const entries = readdirSync2(iosDir);
         const match = entries.find((e) => e.endsWith(ext));
         if (match) {
-          xcodeProject = join4(iosDir, match);
+          xcodeProject = join5(iosDir, match);
           break;
         }
       } catch {
@@ -1493,7 +1529,7 @@ function runIOS(cwd, options) {
   xcodebuild.on("close", (code) => {
     if (code !== 0) {
       console.error(pc4.red(`  \u2717 Build failed (exit code ${code})`));
-      process.exit(1);
+      throw new ConfigError(`iOS build failed with exit code ${code}`);
     }
     console.log(pc4.green("  \u2713 Build successful\n"));
     if (options.device) {
@@ -1501,7 +1537,7 @@ function runIOS(cwd, options) {
       return;
     }
     const simulatorName = options.simulator;
-    const bundleId = options.bundleId || readBundleId(join4(cwd, "ios"));
+    const bundleId = options.bundleId || readBundleId(join5(cwd, "ios"));
     console.log(pc4.white(`  Booting simulator "${simulatorName}"...`));
     try {
       execSync3(`xcrun simctl boot "${simulatorName}"`, { stdio: "pipe" });
@@ -1511,7 +1547,7 @@ function runIOS(cwd, options) {
       execSync3("open -a Simulator", { stdio: "pipe" });
     } catch {
     }
-    const appPath = findAppPath(join4(cwd, "ios"));
+    const appPath = findAppPath(join5(cwd, "ios"));
     if (appPath) {
       console.log(pc4.white(`  Installing app on simulator...`));
       try {
@@ -1519,7 +1555,7 @@ function runIOS(cwd, options) {
         console.log(pc4.green("  \u2713 App installed"));
       } catch (err) {
         console.error(pc4.red(`  \u2717 Failed to install app: ${err.message}`));
-        process.exit(1);
+        throw new ConfigError(`iOS app install failed: ${err.message}`);
       }
       console.log(pc4.white(`  Launching ${bundleId}...`));
       try {
@@ -1528,7 +1564,7 @@ function runIOS(cwd, options) {
 `));
       } catch (err) {
         console.error(pc4.red(`  \u2717 Failed to launch app: ${err.message}`));
-        process.exit(1);
+        throw new ConfigError(`iOS app launch failed: ${err.message}`);
       }
     } else {
       console.log(pc4.yellow("  Could not locate .app bundle in DerivedData."));
@@ -1537,18 +1573,18 @@ function runIOS(cwd, options) {
   });
 }
 function runAndroid(cwd, options) {
-  const androidDir = join4(cwd, "android");
-  if (!existsSync4(androidDir)) {
+  const androidDir = join5(cwd, "android");
+  if (!existsSync5(androidDir)) {
     console.log(pc4.yellow("  No android/ directory found."));
     console.log(pc4.dim("  To add Android support, create an Android project in the android/ directory."));
     console.log(pc4.dim("  Bundle has been built to dist/vue-native-bundle.js\n"));
     return;
   }
-  const gradlew = join4(androidDir, "gradlew");
-  if (!existsSync4(gradlew)) {
-    console.error(pc4.red("  \u2717 gradlew not found in android/ directory"));
-    console.log(pc4.dim("  Make sure your Android project has the Gradle wrapper.\n"));
-    process.exit(1);
+  const gradlew = join5(androidDir, "gradlew");
+  if (!existsSync5(gradlew)) {
+    throw new ConfigError(
+      "gradlew not found in android/ directory. Make sure your Android project has the Gradle wrapper."
+    );
   }
   console.log(pc4.white("  Building Android app with Gradle..."));
   const gradle = spawn3(
@@ -1587,7 +1623,7 @@ function runAndroid(cwd, options) {
   gradle.on("close", (code) => {
     if (code !== 0) {
       console.error(pc4.red(`  \u2717 Gradle build failed (exit code ${code})`));
-      process.exit(1);
+      throw new ConfigError(`Android Gradle build failed with exit code ${code}`);
     }
     console.log(pc4.green("  \u2713 Build successful\n"));
     const apkPath = findApkPath(androidDir);
@@ -1603,7 +1639,7 @@ function runAndroid(cwd, options) {
     } catch (err) {
       console.error(pc4.red(`  \u2717 Failed to install APK: ${err.message}`));
       console.log(pc4.dim("  Make sure an emulator is running or a device is connected (adb devices).\n"));
-      process.exit(1);
+      throw new ConfigError(`APK install failed: ${err.message}`);
     }
     const componentName = `${options.package}/${options.activity}`;
     console.log(pc4.white(`  Launching ${componentName}...`));
@@ -1613,13 +1649,13 @@ function runAndroid(cwd, options) {
 `));
     } catch (err) {
       console.error(pc4.red(`  \u2717 Failed to launch app: ${err.message}`));
-      process.exit(1);
+      throw new ConfigError(`App launch failed: ${err.message}`);
     }
   });
 }
 function runMacOS(cwd, options) {
-  const macosDir = join4(cwd, "macos");
-  if (!existsSync4(macosDir)) {
+  const macosDir = join5(cwd, "macos");
+  if (!existsSync5(macosDir)) {
     console.log(pc4.yellow("  No macos/ directory found."));
     console.log(pc4.dim("  To add macOS support, create an Xcode project in the macos/ directory."));
     console.log(pc4.dim("  Bundle has been built to dist/vue-native-bundle.js\n"));
@@ -1631,7 +1667,7 @@ function runMacOS(cwd, options) {
       const entries = readdirSync2(macosDir);
       const match = entries.find((e) => e.endsWith(ext));
       if (match) {
-        xcodeProject = join4(macosDir, match);
+        xcodeProject = join5(macosDir, match);
         break;
       }
     } catch {
@@ -1663,21 +1699,21 @@ function runMacOS(cwd, options) {
   xcodebuild.on("close", (code) => {
     if (code !== 0) {
       console.error(pc4.red(`  \u2717 Build failed (exit code ${code})`));
-      process.exit(1);
+      throw new ConfigError(`macOS build failed with exit code ${code}`);
     }
     console.log(pc4.green("  \u2713 Build successful\n"));
-    const derivedDataBase = join4(process.env.HOME || "~", "Library/Developer/Xcode/DerivedData");
+    const derivedDataBase = join5(process.env.HOME || "~", "Library/Developer/Xcode/DerivedData");
     let appPath = null;
-    if (existsSync4(derivedDataBase)) {
+    if (existsSync5(derivedDataBase)) {
       try {
         const projects = readdirSync2(derivedDataBase);
         for (const project of projects.reverse()) {
-          const productsDir = join4(derivedDataBase, project, "Build/Products/Debug");
-          if (existsSync4(productsDir)) {
+          const productsDir = join5(derivedDataBase, project, "Build/Products/Debug");
+          if (existsSync5(productsDir)) {
             const entries = readdirSync2(productsDir);
             const app = entries.find((e) => e.endsWith(".app"));
             if (app) {
-              appPath = join4(productsDir, app);
+              appPath = join5(productsDir, app);
               break;
             }
           }
@@ -1703,18 +1739,18 @@ function runMacOS(cwd, options) {
 
 // src/commands/generate.ts
 import { Command as Command5 } from "commander";
-import { existsSync as existsSync5 } from "fs";
-import { join as join5 } from "path";
+import { existsSync as existsSync6 } from "fs";
+import { join as join6 } from "path";
 import pc5 from "picocolors";
 import { parseDirectory } from "@thelacanians/vue-native-sfc-parser";
 import { generateCode, writeGeneratedFiles, cleanGeneratedFiles, validateNativeBlocks, formatValidationErrors } from "@thelacanians/vue-native-codegen";
 var generateCommand = new Command5("generate").description("Generate native code from <native> blocks in Vue SFC files").option("--root <path>", "project root directory", process.cwd()).option("--watch", "watch mode - regenerate on file changes").option("--clean", "clean generated files before generating").option("--ios-output <path>", "iOS Swift output directory").option("--android-output <path>", "Android Kotlin output directory").option("--macos-output <path>", "macOS Swift output directory").option("--ts-output <path>", "TypeScript output directory").option("--no-swift", "disable Swift generation").option("--no-kotlin", "disable Kotlin generation").option("--no-typescript", "disable TypeScript generation").option("--exclude <patterns>", "patterns to exclude (comma-separated)").action(async (options) => {
   const cwd = options.root;
-  const appDir = join5(cwd, "app");
-  if (!existsSync5(appDir)) {
-    console.error(pc5.red(`Error: App directory not found at ${appDir}`));
-    console.error(pc5.yellow("Make sure you run this command from your project root."));
-    process.exit(1);
+  const appDir = join6(cwd, "app");
+  if (!existsSync6(appDir)) {
+    throw new ConfigError(
+      `App directory not found at ${appDir}. Make sure you run this command from your project root.`
+    );
   }
   const codegenOptions = {
     root: cwd,
@@ -1761,7 +1797,7 @@ var generateCommand = new Command5("generate").description("Generate native code
       if (!validation.isValid) {
         console.log(pc5.red("\n\u274C Validation failed:"));
         console.log(formatValidationErrors(validation));
-        process.exit(1);
+        throw new ConfigError("Validation failed");
       }
       if (validation.warnings.length > 0) {
         console.log(pc5.yellow(`\u26A0\uFE0F  ${validation.warnings.length} warning${validation.warnings.length !== 1 ? "s" : ""}`));
@@ -1785,7 +1821,7 @@ var generateCommand = new Command5("generate").description("Generate native code
         codegenResult.errors.forEach((err) => {
           console.log(pc5.red(`  - ${err.file} ${err.message}`));
         });
-        process.exit(1);
+        throw new ConfigError("Code generation failed");
       }
       console.log(pc5.blue("\u{1F4DD} Writing files..."));
       const writeResult = writeGeneratedFiles(codegenResult, cwd);
@@ -1794,7 +1830,7 @@ var generateCommand = new Command5("generate").description("Generate native code
         writeResult.errors.forEach((err) => {
           console.log(pc5.red(`  - ${err.message}`));
         });
-        process.exit(1);
+        throw new ConfigError("Failed to write generated files");
       }
       console.log(pc5.green("\n\u2705 Generation complete!\n"));
       console.log(pc5.dim("Generated files:"));
@@ -1811,10 +1847,10 @@ var generateCommand = new Command5("generate").description("Generate native code
       }
       console.log(pc5.green("\u{1F389} Ready to build!\n"));
     } catch (error) {
-      console.error(pc5.red("\n\u274C Fatal error:"));
-      console.error(pc5.red(error.message));
-      console.error(pc5.dim(error.stack || ""));
-      process.exit(1);
+      if (error instanceof ConfigError) throw error;
+      throw new ConfigError(
+        error.message || "Unknown generation error"
+      );
     }
   }
   await runGeneration();
@@ -1850,4 +1886,10 @@ program.addCommand(createCommand);
 program.addCommand(devCommand);
 program.addCommand(runCommand);
 program.addCommand(generateCommand);
-program.parse(process.argv);
+program.parseAsync(process.argv).catch((err) => {
+  if (err instanceof ConfigError) {
+    console.error(pc6.red(err.message));
+    process.exit(1);
+  }
+  throw err;
+});

package/dist/config.d.ts

@@ -37,10 +37,13 @@ interface ResolvedConfig extends VueNativeConfig {
     plugins: string[];
 }
 declare function defineConfig(config: VueNativeConfig): VueNativeConfig;
+declare class ConfigError extends Error {
+    constructor(message: string);
+}
 /**
  * Load and resolve the vue-native.config.{ts,js,mjs} file from the project root.
  * Returns null if no config file is found.
  */
 declare function loadConfig(cwd: string): Promise<ResolvedConfig | null>;
 
-export { type ResolvedConfig, type VueNativeConfig, defineConfig, loadConfig };
+export { ConfigError, type ResolvedConfig, type VueNativeConfig, defineConfig, loadConfig };

package/dist/config.js

@@ -2,24 +2,42 @@
 import { existsSync } from "fs";
 import { join } from "path";
 import { pathToFileURL } from "url";
-import pc from "picocolors";
 function defineConfig(config) {
   return config;
 }
+var ConfigError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ConfigError";
+  }
+};
 function validateConfig(config) {
   if (typeof config !== "object" || config === null) return false;
   const c = config;
   if (typeof c.name !== "string" || c.name.length === 0) {
-    console.error(pc.red('  Config error: "name" is required and must be a non-empty string.'));
-    return false;
+    throw new ConfigError(
+      'Config error: "name" is required and must be a non-empty string.'
+    );
   }
   if (typeof c.bundleId !== "string" || !/^[a-z][a-z0-9]*(\.[a-z][a-z0-9]*)+$/i.test(c.bundleId)) {
-    console.error(pc.red('  Config error: "bundleId" must be a valid reverse-domain identifier (e.g. com.example.myapp).'));
-    return false;
+    throw new ConfigError(
+      'Config error: "bundleId" must be a valid reverse-domain identifier (e.g. com.example.myapp).'
+    );
   }
   if (typeof c.version !== "string" || c.version.length === 0) {
-    console.error(pc.red('  Config error: "version" is required (e.g. "1.0.0").'));
-    return false;
+    throw new ConfigError('Config error: "version" is required (e.g. "1.0.0").');
+  }
+  if (c.plugins !== void 0) {
+    if (!Array.isArray(c.plugins)) {
+      throw new ConfigError('Config error: "plugins" must be an array of strings.');
+    }
+    for (const plugin of c.plugins) {
+      if (typeof plugin !== "string") {
+        throw new ConfigError(
+          'Config error: "plugins" must be an array of strings.'
+        );
+      }
+    }
   }
   return true;
 }
@@ -42,7 +60,7 @@ async function loadConfig(cwd) {
     const mod = await import(pathToFileURL(configPath).href);
     const raw = mod.default ?? mod;
     if (!validateConfig(raw)) {
-      process.exit(1);
+      throw new ConfigError(`Invalid configuration in ${configPath}`);
     }
     const config = raw;
     const safeName = config.name.replace(/[^a-zA-Z0-9]/g, "");
@@ -61,12 +79,14 @@ async function loadConfig(cwd) {
     };
     return resolved;
   } catch (err) {
-    console.error(pc.red(`  Failed to load config from ${configPath}:`));
-    console.error(pc.red(`  ${err.message}`));
-    process.exit(1);
+    if (err instanceof ConfigError) throw err;
+    throw new ConfigError(
+      `Failed to load config from ${configPath}: ${err.message}`
+    );
   }
 }
 export {
+  ConfigError,
   defineConfig,
   loadConfig
 };

package/native/android/VueNativeCore/build.gradle.kts

@@ -119,7 +119,7 @@ afterEvaluate {
             create<MavenPublication>("release") {
                 groupId = "com.vuenative"
                 artifactId = "core"
-                version = "0.4.14"
+                version = "0.6.2"
                 from(components["release"])
             }
         }

package/native/ios/VueNativeCore/Package.swift

@@ -10,13 +10,16 @@ let package = Package(
     dependencies: [
         // Yoga layout engine — layoutBox/FlexLayout v2.x wraps Yoga 3.0.4
         // 2.1k stars, actively maintained (last release Dec 2025), full SPM support
-        .package(url: "https://github.com/layoutBox/FlexLayout.git", from: "2.0.0")
+        .package(url: "https://github.com/layoutBox/FlexLayout.git", from: "2.0.0"),
+        // Shared cross-platform Swift code used by both iOS and macOS
+        .package(path: "../../shared/VueNativeShared")
     ],
     targets: [
         .target(
             name: "VueNativeCore",
             dependencies: [
-                .product(name: "FlexLayout", package: "FlexLayout")
+                .product(name: "FlexLayout", package: "FlexLayout"),
+                "VueNativeShared"
             ],
             path: "Sources/VueNativeCore",
             resources: [

package/native/ios/VueNativeCore/Sources/VueNativeCore/Helpers/iOSRAFHelper.swift

@@ -0,0 +1,124 @@
+#if canImport(UIKit)
+import JavaScriptCore
+import UIKit
+import VueNativeShared
+
+/// iOS-specific requestAnimationFrame helper using CADisplayLink.
+/// Registers requestAnimationFrame/cancelAnimationFrame on the JS context
+/// and manages the display link lifecycle.
+enum IOSRAFHelper {
+
+    /// Active display link for requestAnimationFrame. Accessed only from main thread.
+    private static var displayLink: CADisplayLink?
+
+    // MARK: - Registration
+
+    /// Register requestAnimationFrame/cancelAnimationFrame on the given JS context.
+    /// MUST be called on the JS queue after SharedJSPolyfills.register().
+    static func register(in runtime: JSRuntime) {
+        guard let context = runtime.context else { return }
+
+        // requestAnimationFrame(callback) -> rafId (String)
+        let requestAnimationFrame: @convention(block) (JSValue) -> JSValue = { [weak runtime] callback in
+            guard let runtime = runtime, let context = runtime.context else {
+                return JSValue(nullIn: JSContext.current())
+            }
+
+            // Store callback using shared helper and get an ID
+            let rafId = SharedJSPolyfills.storeRAFCallback(callback)
+
+            // Ensure display link is running
+            DispatchQueue.main.async {
+                if displayLink == nil {
+                    let target = DisplayLinkTarget(runtime: runtime)
+                    let link = CADisplayLink(target: target, selector: #selector(DisplayLinkTarget.handleFrame(_:)))
+                    link.add(to: .main, forMode: .common)
+                    displayLink = link
+                }
+            }
+
+            return JSValue(object: rafId, in: context)
+        }
+
+        // cancelAnimationFrame(rafId)
+        let cancelAnimationFrame: @convention(block) (JSValue) -> Void = { [weak runtime] rafId in
+            _ = runtime
+            guard let id = rafId.toString() else { return }
+            // Remove the callback using shared helper
+            SharedJSPolyfills.removeRAFCallback(id)
+        }
+
+        context.setObject(requestAnimationFrame, forKeyedSubscript: "requestAnimationFrame" as NSString)
+        context.setObject(cancelAnimationFrame, forKeyedSubscript: "cancelAnimationFrame" as NSString)
+    }
+
+    // MARK: - Reset
+
+    /// Reset RAF state and stop the display link.
+    /// Safe to call from any thread — display link operations are dispatched to main thread.
+    static func reset() {
+        DispatchQueue.main.async {
+            displayLink?.invalidate()
+            displayLink = nil
+        }
+    }
+
+    // MARK: - Display Link Callback
+
+    /// Called from the display link target on every frame.
+    /// Dispatches all pending RAF callbacks to the JS queue.
+    fileprivate static func fireRAFCallbacks(runtime: JSRuntime, timestamp: Double) {
+        // Snapshot and clear callbacks using shared helper (RAF is one-shot)
+        let callbacks = SharedJSPolyfills.drainRAFCallbacks()
+
+        guard !callbacks.isEmpty else {
+            // No pending callbacks — stop the display link
+            displayLink?.invalidate()
+            displayLink = nil
+            return
+        }
+
+        runtime.jsQueue.async { [weak runtime] in
+            guard let runtime = runtime, let context = runtime.context else { return }
+
+            for (_, callback) in callbacks {
+                if !callback.isUndefined {
+                    callback.call(withArguments: [timestamp])
+                }
+            }
+
+            // Drain microtasks after all RAF callbacks
+            context.evaluateScript("void 0;")
+
+            // If no more callbacks pending, stop the display link
+            if !SharedJSPolyfills.hasRAFCallbacks {
+                DispatchQueue.main.async {
+                    displayLink?.invalidate()
+                    displayLink = nil
+                }
+            }
+        }
+    }
+}
+
+// MARK: - DisplayLinkTarget
+
+/// Separate NSObject target for CADisplayLink to avoid retain cycles with JSRuntime.
+private final class DisplayLinkTarget: NSObject {
+    private weak var runtime: JSRuntime?
+
+    init(runtime: JSRuntime) {
+        self.runtime = runtime
+        super.init()
+    }
+
+    @objc func handleFrame(_ link: CADisplayLink) {
+        guard let runtime = runtime else {
+            link.invalidate()
+            return
+        }
+        let timestamp = link.timestamp * 1000.0 // Convert to milliseconds
+        IOSRAFHelper.fireRAFCallbacks(runtime: runtime, timestamp: timestamp)
+    }
+}
+#endif

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thelacanians/vue-native-cli",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "CLI for creating and running Vue Native apps",
   "license": "MIT",
   "author": "Vue Native Contributors",
@@ -35,8 +35,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@thelacanians/vue-native-sfc-parser": "^0.0.2",
-    "@thelacanians/vue-native-codegen": "^0.0.2",
+    "@thelacanians/vue-native-sfc-parser": "^0.6.4",
+    "@thelacanians/vue-native-codegen": "^0.6.4",
     "commander": "^12.1.0",
     "ws": "^8.18.0",
     "chokidar": "^3.6.0",