@dongmingzhixiu/vuexir 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 panvu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,20 @@
-# Temporary Holding Version
+# @vrn/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+```bash
+npx vrn build ios        # Vue SFC → IR → Swift 源码 →（--run 时）xcodegen + xcodebuild
+npx vrn build android    # 同上，产出 Compose 源码 → gradle assembleDebug
+npx vrn gen ios          # 只生成源码，不调用平台构建
+npx vrn doctor           # 环境自检：Xcode / xcodegen / JDK / ANDROID_HOME / adb（P2）
+npx vrn preview          # 多页预览器（P3 起由 @vrn/vite-plugin 承载）
+```
+
+配置（`vrn.config.ts`，P1 落地）：
+
+```ts
+export default {
+  entry: 'src/router.ts',
+  outDir: 'native',
+  projectName: 'MyApp',
+  bundleId: 'com.example.myapp',
+}
+```

package/bin/vrn.mjs

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * vrn 可执行入口（@vrn/cli）。
+ * 说明：源码为 TS，运行期用 vite-node 加载（vite-node 是 CLI 的运行时依赖）；
+ * 发布版可改用预编译 dist（P4 处理），此处在未编译时回退到 vite-node。
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const entry = join(here, '..', 'src', 'cli.ts');
+
+const dist = join(here, '..', 'dist', 'cli.js');
+if (existsSync(dist)) {
+  const { run } = await import(pathToFileURL(dist).href);
+  process.exit(await run(process.argv.slice(2)));
+}
+
+// 开发/未编译形态：交给 vite-node（其 CLI 会加载 TS 并设置好 Vite 解析）
+const r = spawnSync('npx', ['vite-node', entry, ...process.argv.slice(2)], { stdio: 'inherit' });
+process.exit(r.status ?? 1);

package/dist/cli.d.ts

@@ -0,0 +1,19 @@
+type Platform = 'ios' | 'android';
+interface CliArgs {
+    command: 'gen' | 'build' | 'doctor' | 'help';
+    platform?: Platform;
+    run: boolean;
+    input?: string;
+    outDir?: string;
+    projectName?: string;
+    bundleId?: string;
+    entry?: string;
+    projectRoot?: string;
+}
+export declare function parseArgs(argv: string[]): CliArgs;
+/** 生成指定平台；返回产物目录 */
+export declare function generate(args: CliArgs, platform: Platform): Promise<string>;
+/** vrn doctor：环境自检（生成链路依赖的外部工具） */
+export declare function doctor(): boolean;
+export declare function run(argv: string[]): Promise<number>;
+export {};

package/dist/cli.js

@@ -0,0 +1,203 @@
+/**
+ * @dongmingzhixiu/vuexir 命令实现（R-PKG：CLI 是唯一负责路径/IO/进程的层）
+ *
+ *   vrn gen   ios|android [--entry <p>] [--out <dir>] [--name <n>] [--bundle <id>]
+ *   vrn build ios|android [--run]        # gen + （--run 时）调用 xcodegen/xcodebuild | gradle
+ *   vrn doctor                           # 环境自检
+ *
+ * 配置来源见 config.ts（vrn.config.* + CLI 覆盖）。生成器在导入前设置 VRN_NO_AUTO_RUN=1，
+ * 避免模块加载时的自动执行。
+ */
+import { existsSync } from 'node:fs';
+import { readdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { deriveProjectName, loadConfig, platformOutDir, resolveConfig, resolveEntry } from './config.js';
+import { TEMPLATE_VERSION } from '@dongmingzhixiu/vuexir-templates';
+// 关键：生成器模块的默认入口是「导入即执行」（旧脚本行为），CLI 复用其函数前必须关闭该行为
+process.env.VRN_NO_AUTO_RUN = '1';
+export function parseArgs(argv) {
+    const args = { command: 'help', run: false };
+    const rest = [];
+    for (let i = 0; i < argv.length; i += 1) {
+        const a = argv[i];
+        const next = () => argv[++i] ?? '';
+        if (a === '--run')
+            args.run = true;
+        else if (a === '--out')
+            args.outDir = next();
+        else if (a === '--name')
+            args.projectName = next();
+        else if (a === '--bundle')
+            args.bundleId = next();
+        else if (a === '--entry')
+            args.entry = next();
+        else if (a === '--root')
+            args.projectRoot = next();
+        else if (a.startsWith('--'))
+            console.warn(`[vrn] 未知参数已忽略：${a}`);
+        else
+            rest.push(a);
+    }
+    const cmd = rest[0];
+    if (cmd === 'gen' || cmd === 'build' || cmd === 'doctor')
+        args.command = cmd;
+    const plat = rest.find((r) => r === 'ios' || r === 'android');
+    if (plat)
+        args.platform = plat;
+    // 位置参数（非子命令、非平台）视为入口（样例名/目录/路径）
+    args.input = rest.slice(1).find((r) => r !== 'ios' && r !== 'android');
+    return args;
+}
+/** 生成指定平台；返回产物目录 */
+export async function generate(args, platform) {
+    const fileConfig = await loadConfig(args.projectRoot ?? process.cwd());
+    const cfg = resolveConfig(fileConfig, {
+        projectRoot: args.projectRoot,
+        outDir: args.outDir,
+        entry: args.entry,
+        projectName: args.projectName,
+        bundleId: args.bundleId,
+    });
+    // 显式入口（CLI 位置参数）优先于 config.entry
+    const explicit = args.input ? await resolveExplicitEntry(args.input, cfg) : undefined;
+    const resolved = explicit ? { entry: explicit.entry, multiPage: explicit.multiPage } : resolveEntry(cfg);
+    const { entry, multiPage } = resolved;
+    /** 传给生成器的入口目录（生成器约定：目录内含 router.ts / App.vue） */
+    const inputDir = explicit ? explicit.dir : dirname(entry);
+    const projectName = cfg.projectName ?? deriveProjectName(cfg, entry);
+    const bundleId = cfg.bundleId ?? `com.vrn.${projectName.toLowerCase()}`;
+    const outRoot = platformOutDir(cfg, platform, '').replace(/\/$/, '');
+    // 动态导入：生成器模块在 import 时执行默认入口（旧脚本兼容），必须先置开关再加载
+    process.env.VRN_NO_AUTO_RUN = '1';
+    const { generateIos } = await import('./gen-ios.js');
+    const { generateAndroid } = await import('./gen-android.js');
+    if (platform === 'android') {
+        if (!multiPage) {
+            throw new Error('[vrn] Android 生成目前要求多页入口 router.ts（单页 App.vue 请先补 router.ts）');
+        }
+        return generateAndroid({ input: inputDir, outDirRoot: outRoot, projectName, bundleId });
+    }
+    const out = generateIos({ input: inputDir, outDirRoot: outRoot, projectName, bundleId });
+    if (!out)
+        throw new Error('[vrn] iOS 生成未返回产物目录');
+    return out;
+}
+/** 位置参数解析：样例名 / 目录 / .vue 路径 → { 目录, 入口文件, 是否多页 }
+ *  说明：生成器（gen-ios/gen-android）接收入口**目录**（内含 router.ts / App.vue） */
+async function resolveExplicitEntry(input, cfg) {
+    const candidates = [
+        input,
+        join(cfg.projectRoot, input),
+        join(cfg.projectRoot, 'examples', input),
+        join(process.cwd(), input),
+    ];
+    for (const c of candidates) {
+        if (!existsSync(c))
+            continue;
+        if (c.endsWith('.vue'))
+            return { dir: dirname(c), entry: c, multiPage: false };
+        if (existsSync(join(c, 'router.ts')))
+            return { dir: c, entry: join(c, 'router.ts'), multiPage: true };
+        if (existsSync(join(c, 'App.vue')))
+            return { dir: c, entry: join(c, 'App.vue'), multiPage: false };
+    }
+    throw new Error(`[vrn] 找不到入口「${input}」（已尝试：\n  ${candidates.join('\n  ')}）`);
+}
+/** vrn doctor：环境自检（生成链路依赖的外部工具） */
+export function doctor() {
+    const checks = [
+        { name: 'node', cmd: 'node', args: ['--version'], hint: '安装 Node.js ≥ 18' },
+        { name: 'xcodegen', cmd: 'xcodegen', args: ['--version'], hint: 'brew install xcodegen（iOS 工程生成）' },
+        { name: 'xcodebuild', cmd: 'xcrun', args: ['--find', 'xcodebuild'], hint: '安装 Xcode 并 xcode-select --install' },
+        { name: 'swiftc', cmd: 'xcrun', args: ['--find', 'swiftc'], hint: '随 Xcode 提供（iOS 源码类型检查）' },
+        { name: 'gradle', cmd: 'gradle', args: ['--version'], hint: 'brew install gradle 或设置 VRN_GRADLE' },
+        { name: 'adb', cmd: 'adb', args: ['version'], hint: 'Android SDK platform-tools（装到真机需要）' },
+    ];
+    let ok = true;
+    for (const c of checks) {
+        // 兼容自定义安装位置：VRN_GRADLE / ANDROID_HOME 下的 platform-tools
+        const custom = {
+            gradle: process.env.VRN_GRADLE ?? (existsSync(join(process.env.HOME ?? '', 'gradle-dist/gradle-8.9/bin/gradle')) ? join(process.env.HOME ?? '', 'gradle-dist/gradle-8.9/bin/gradle') : undefined),
+            adb: process.env.ANDROID_HOME ? join(process.env.ANDROID_HOME, 'platform-tools/adb') : undefined,
+        };
+        const bin = custom[c.name] ?? c.cmd;
+        const r = spawnSync(bin, c.args, { encoding: 'utf-8' });
+        // 自定义路径下以「文件存在」判定（部分环境禁止直接执行，如沙箱）
+        const good = r.status === 0 || (custom[c.name] !== undefined && existsSync(bin));
+        if (!good)
+            ok = false;
+        console.log(`${good ? '✓' : '✗'} ${c.name.padEnd(11)} ${good ? (r.stdout.split('\n')[0] ?? '').trim() : `缺失 → ${c.hint}`}`);
+    }
+    // P2：工程产物版本校验（.vrn/manifest.json 记录生成时的工具链/模板版本）
+    const outRoot = join(process.cwd(), 'native');
+    const scanDirs = [];
+    for (const plat of ['ios', 'android']) {
+        const d = join(outRoot, plat);
+        if (existsSync(d))
+            for (const name of readdirSync(d))
+                scanDirs.push(join(d, name));
+    }
+    for (const dir of scanDirs) {
+        const mf = join(dir, '.vrn/manifest.json');
+        if (!existsSync(mf)) {
+            console.log(`! ${dir.split('/').slice(-2).join('/')} 缺少 .vrn/manifest.json → 建议 vrn gen 重生成`);
+            continue;
+        }
+        try {
+            const m = JSON.parse(readFileSync(mf, 'utf-8'));
+            const stale = m.templateVersion !== TEMPLATE_VERSION;
+            if (stale)
+                ok = false;
+            console.log(`${stale ? '✗' : '✓'} ${dir.split('/').slice(-2).join('/')} 模板版本 ${m.templateVersion ?? '?'}${stale ? ` ≠ 当前 ${TEMPLATE_VERSION} → 重生成（vrn gen）` : ''}`);
+        }
+        catch {
+            console.log(`! ${dir} manifest 解析失败 → 重生成`);
+        }
+    }
+    const androidHome = process.env.ANDROID_HOME ?? process.env.ANDROID_SDK_ROOT;
+    console.log(`${androidHome ? '✓' : '✗'} ANDROID_HOME ${androidHome ?? '未设置 → export ANDROID_HOME=$HOME/Library/Android/sdk'}`);
+    if (!androidHome)
+        ok = false;
+    return ok;
+}
+export async function run(argv) {
+    const args = parseArgs(argv);
+    if (args.command === 'help') {
+        console.log(`vrn —— Vue SFC → iOS(SwiftUI) / Android(Compose) 原生工程
+
+用法：
+  vrn gen   ios|android [入口] [--out native] [--name MyApp] [--bundle com.x.y]
+  vrn build ios|android [入口] [--run]      # 生成后可选调用平台构建
+  vrn doctor                                 # 环境自检
+
+配置：<projectRoot>/vrn.config.ts（entry / outDir / projectName / bundleId）
+`);
+        return 0;
+    }
+    if (args.command === 'doctor')
+        return doctor() ? 0 : 1;
+    if (!args.platform) {
+        console.error('[vrn] 请指定平台：vrn gen ios | vrn gen android');
+        return 2;
+    }
+    const outDir = await generate(args, args.platform);
+    console.log(`[vrn] ${args.platform} 工程已生成：${outDir}`);
+    if (args.command === 'build' && args.run) {
+        const cmd = args.platform === 'android'
+            ? [process.env.VRN_GRADLE ?? 'gradle', ['assembleDebug']]
+            : ['xcodegen', ['generate']];
+        const r = spawnSync(cmd[0], cmd[1], { cwd: outDir, stdio: 'inherit' });
+        if (r.status !== 0) {
+            console.error(`[vrn] 平台构建命令失败：${cmd[0]}（可在工程目录手动执行）`);
+            return r.status ?? 1;
+        }
+        if (args.platform === 'ios') {
+            const project = outDir.split('/').pop();
+            const b = spawnSync('xcodebuild', ['-project', `${project}.xcodeproj`, '-scheme', project, '-configuration', 'Debug', '-destination', 'platform=iOS Simulator,name=iPhone 17', '-derivedDataPath', 'build', 'build', 'CODE_SIGNING_ALLOWED=NO'], { cwd: outDir, stdio: 'inherit' });
+            return b.status ?? 1;
+        }
+    }
+    return 0;
+}

package/dist/config.d.ts

@@ -0,0 +1,37 @@
+export interface VrnConfig {
+    /** Vue 工程根（默认 cwd） */
+    projectRoot: string;
+    /** 入口：router.ts（多页）或单个 .vue（单页），相对 projectRoot */
+    entry?: string;
+    /** 生成产物根目录（相对 projectRoot）；platform 子目录由 CLI 追加 */
+    outDir: string;
+    /** 工程名（生成 Xcode/Gradle 工程名；默认由入口目录推导） */
+    projectName?: string;
+    /** bundle id（默认 com.vrn.<projectname>） */
+    bundleId?: string;
+    /** 生成页面集合（多页模式；省略则用 entry 的 router.ts） */
+    platform?: {
+        ios?: {
+            deploymentTarget?: string;
+        };
+        android?: {
+            minSdk?: number;
+            compileSdk?: number;
+        };
+    };
+}
+/** 读取 vrn.config（json 直接解析；ts/mjs 用动态 import，失败则忽略并提示） */
+export declare function loadConfig(projectRoot: string): Promise<Partial<VrnConfig>>;
+/** 合并默认值 + 配置文件 + CLI 覆盖 */
+export declare function resolveConfig(base: Partial<VrnConfig> & {
+    projectRoot?: string;
+}, overrides?: Partial<VrnConfig>): VrnConfig;
+/** 入口解析：显式 entry → 目录下 router.ts → App.vue → 抛错并列出候选 */
+export declare function resolveEntry(cfg: VrnConfig): {
+    entry: string;
+    multiPage: boolean;
+};
+/** 平台输出目录：<outDir>/<platform>/<ProjectName> */
+export declare function platformOutDir(cfg: VrnConfig, platform: 'ios' | 'android', projectName: string): string;
+/** 工程名推导：projectName → 入口目录名 → 'VrnApp'（PascalCase） */
+export declare function deriveProjectName(cfg: VrnConfig, entry: string): string;

package/dist/config.js

@@ -0,0 +1,80 @@
+/**
+ * @dongmingzhixiu/vuexir 配置解析（R-PKG：CLI 只认「项目根 + vrn.config」两个事实来源）
+ *
+ * 解析顺序（后者覆盖前者）：
+ *   1. 内置默认值（projectRoot = process.cwd()，outDir = <root>/native）
+ *   2. vrn.config.ts / vrn.config.mts / vrn.config.js / vrn.config.mjs / vrn.config.json
+ *   3. 命令行参数（--out / --entry / --name / --bundle 等）
+ *
+ * 兼容期：未提供 vrn.config 时，若 <root>/router.ts 或 <root>/App.vue 存在，按「目录即项目」处理；
+ * 仓库内开发（旧行为）通过 `--repo-root`（或 cwd 落在仓库内）解析到 examples/<name>。
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+const CONFIG_FILES = ['vrn.config.ts', 'vrn.config.mts', 'vrn.config.js', 'vrn.config.mjs', 'vrn.config.json'];
+/** 读取 vrn.config（json 直接解析；ts/mjs 用动态 import，失败则忽略并提示） */
+export async function loadConfig(projectRoot) {
+    for (const file of CONFIG_FILES) {
+        const p = join(projectRoot, file);
+        if (!existsSync(p))
+            continue;
+        try {
+            if (file.endsWith('.json')) {
+                return JSON.parse(readFileSync(p, 'utf-8'));
+            }
+            const mod = (await import(`file://${p}`));
+            return mod.default ?? {};
+        }
+        catch (e) {
+            console.warn(`[vrn] 读取 ${file} 失败：${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    return {};
+}
+/** 合并默认值 + 配置文件 + CLI 覆盖 */
+export function resolveConfig(base, overrides = {}) {
+    const projectRoot = resolve(overrides.projectRoot ?? base.projectRoot ?? process.cwd());
+    const outDirRaw = overrides.outDir ?? base.outDir ?? 'native';
+    return {
+        projectRoot,
+        entry: overrides.entry ?? base.entry,
+        outDir: isAbsolute(outDirRaw) ? outDirRaw : join(projectRoot, outDirRaw),
+        projectName: overrides.projectName ?? base.projectName,
+        bundleId: overrides.bundleId ?? base.bundleId,
+        platform: { ...(base.platform ?? {}), ...(overrides.platform ?? {}) },
+    };
+}
+/** 入口解析：显式 entry → 目录下 router.ts → App.vue → 抛错并列出候选 */
+export function resolveEntry(cfg) {
+    const candidates = [];
+    if (cfg.entry) {
+        const p = isAbsolute(cfg.entry) ? cfg.entry : join(cfg.projectRoot, cfg.entry);
+        if (existsSync(p))
+            return { entry: p, multiPage: p.endsWith('router.ts') || p.endsWith('router.js') };
+        throw new Error(`vrn.config.entry 指向的文件不存在：${p}`);
+    }
+    const router = join(cfg.projectRoot, 'src/router.ts');
+    const routerRoot = join(cfg.projectRoot, 'router.ts');
+    for (const r of [router, routerRoot]) {
+        if (existsSync(r))
+            return { entry: r, multiPage: true };
+        candidates.push(r);
+    }
+    for (const a of [join(cfg.projectRoot, 'src/App.vue'), join(cfg.projectRoot, 'App.vue')]) {
+        if (existsSync(a))
+            return { entry: a, multiPage: false };
+        candidates.push(a);
+    }
+    throw new Error(`未找到入口（多页 src/router.ts 或单页 src/App.vue）。已尝试：\n  ${candidates.join('\n  ')}\n` +
+        `可在 vrn.config.ts 中用 entry 显式指定。`);
+}
+/** 平台输出目录：<outDir>/<platform>/<ProjectName> */
+export function platformOutDir(cfg, platform, projectName) {
+    return join(cfg.outDir, platform, projectName);
+}
+/** 工程名推导：projectName → 入口目录名 → 'VrnApp'（PascalCase） */
+export function deriveProjectName(cfg, entry) {
+    const raw = cfg.projectName ?? dirname(entry).split('/').pop() ?? 'VrnApp';
+    const cleaned = raw.replace(/[^A-Za-z0-9]+/g, ' ').trim().split(/\s+/).pop() ?? 'VrnApp';
+    return cleaned.charAt(0).toUpperCase() + cleaned.slice(1);
+}

package/dist/gen-android.d.ts

@@ -0,0 +1,10 @@
+export interface GenerateOptions {
+    /** 入口：样例名 / 目录 / 显式路径（默认 vuexir-demo） */
+    input?: string;
+    /** 产物根（默认 VRN_OUT_DIR 或仓库内 compiler/generated/android） */
+    outDirRoot?: string;
+    projectName?: string;
+    bundleId?: string;
+}
+/** 生成 Android（Compose）工程；返回产物目录 */
+export declare function generateAndroid(opts?: GenerateOptions): string;

package/dist/gen-android.js

@@ -0,0 +1,48 @@
+/**
+ * gen-android.ts —— Android 工程生成入口脚本（对位 gen-ios.ts）
+ *
+ * 链路：vuexir-demo/(router.ts + pages/*.vue) → vueToIr → validateIr → compose.ts → Gradle 工程
+ * 输出：compiler/generated/android/<ProjectName>/（gradle assembleDebug 可构建）
+ *
+ * 运行：
+ *   npx vite-node compiler/scripts/gen-android.ts                 # 默认 vuexir-demo
+ *   npx vite-node compiler/scripts/gen-android.ts <sample名|路径> # 指定样例
+ *
+ * codegen 核心在 compiler/src/codegen/compose.ts（对位 swiftui.ts）。
+ */
+import { existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { runTabs, resolveInput } from '@dongmingzhixiu/vuexir-compiler';
+import { TEMPLATE_VERSION, buildGradle } from '@dongmingzhixiu/vuexir-templates';
+// R-PKG：产物根不再假设仓库布局——VRN_OUT_DIR 优先（CLI 注入），否则回退到仓库内 compiler/generated/android
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
+const OUT_ROOT = process.env.VRN_OUT_DIR ?? join(ROOT, 'compiler/generated/android');
+/** 样例根（仓库内开发用；用户工程由 CLI 传入显式入口） */
+const SAMPLES_ROOT = process.env.VRN_SAMPLES_ROOT ?? join(ROOT, 'examples');
+/** 生成 Android（Compose）工程；返回产物目录 */
+export function generateAndroid(opts = {}) {
+    const input = resolveInput(opts.input);
+    if (!existsSync(join(input, 'router.ts'))) {
+        throw new Error(`[vrn] ${input} 缺少 router.ts（多页模式需要 router.ts；单页请用 gen-ios 路径或补 router.ts）`);
+    }
+    return runTabs(input, {
+        outDirRoot: opts.outDirRoot,
+        projectName: opts.projectName,
+        bundleId: opts.bundleId,
+        renderGradle: (projName, bid) => buildGradle(bid),
+        templateVersion: TEMPLATE_VERSION,
+    });
+}
+// 直接执行（旧脚本用法保持兼容）：npx vite-node packages/cli/src/gen-android.ts [样例名|路径]
+// CLI（packages/cli/src/cli.ts）导入本模块前设置 VRN_NO_AUTO_RUN=1，避免 import 时重复生成。
+// 说明：vite-node 下 process.argv[1] 是 vite-node 自身路径，不能用「是否为主模块」判定。
+if (process.env.VRN_NO_AUTO_RUN !== '1') {
+    try {
+        generateAndroid({ input: process.argv[2] });
+    }
+    catch (e) {
+        console.error(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    }
+}

package/dist/gen-ios.d.ts

@@ -0,0 +1,29 @@
+/**
+ * gen-ios.ts —— iOS 工程生成脚本（P1-lite 主入口）
+ *
+ * 输入：Vue SFC（默认 compiler/samples/hello/Hello.vue）或 IR JSON（.json 后缀）
+ * 管线：Vue SFC → (vueToIr) → IR → (validateIr) → SwiftUI 源码 + 独立 Xcode 工程
+ *
+ * 运行：
+ *   npx vite-node compiler/scripts/gen-ios.ts                    # 默认 Hello.vue
+ *   npx vite-node compiler/scripts/gen-ios.ts path/My.vue        # 指定 Vue 文件
+ *   npx vite-node compiler/scripts/gen-ios.ts path/screen.ir.json  # 或手写 IR
+ *
+ * 产物：compiler/generated/ios/<ProjectName>/{App.swift, ScreenView.swift, recite.json, project.yml}
+ * 后续：cd compiler/generated/ios/<ProjectName> && xcodegen generate && xcodebuild ...
+ */
+export interface GenerateIosOptions {
+    /** 样例名 / 目录 / 显式 .vue 或 .json 路径；'all' 批量；省略 = 默认 vuexir-demo */
+    input?: string;
+    /** 产物根（<outDir>/<ProjectName>） */
+    outDirRoot?: string;
+    /** 样例根（默认 examples/） */
+    samplesRoot?: string;
+    projectName?: string;
+    bundleId?: string;
+}
+/**
+ * 生成 iOS（SwiftUI）工程。返回产物目录；失败抛错（不调用 process.exit，便于 CLI 复用）。
+ * 说明：本函数沿用既有 main 逻辑（多页/单页/批量），仅把路径来源从「仓库布局」改成可注入。
+ */
+export declare function generateIos(opts?: GenerateIosOptions): string | undefined;