@tamer4lynx/cli 0.0.12 → 0.0.14

package/dist/index.js

@@ -7,8 +7,8 @@ process.on("warning", (w) => {
 });
 
 // index.ts
-import fs24 from "fs";
-import path25 from "path";
+import fs28 from "fs";
+import path29 from "path";
 import { fileURLToPath } from "url";
 import { program } from "commander";
 
@@ -2391,7 +2391,7 @@ var syncDevClient_default = syncDevClient;
 
 // src/android/bundle.ts
 async function bundleAndDeploy(opts = {}) {
-  const release = opts.release === true;
+  const release = opts.release === true || opts.production === true;
   let resolved;
   try {
     resolved = resolveHostPaths();
@@ -2468,10 +2468,11 @@ async function buildApk(opts = {}) {
   } catch (error) {
     throw error;
   }
-  await bundle_default({ release: opts.release });
+  const release = opts.release === true || opts.production === true;
+  await bundle_default({ release, production: opts.production });
   const androidDir = resolved.androidDir;
   const gradlew = path11.join(androidDir, process.platform === "win32" ? "gradlew.bat" : "gradlew");
-  const variant = opts.release ? "Release" : "Debug";
+  const variant = release ? "Release" : "Debug";
   const task = opts.install ? `install${variant}` : `assemble${variant}`;
   console.log(`
 \u{1F528} Building ${variant.toLowerCase()} APK${opts.install ? " and installing" : ""}...`);
@@ -4241,7 +4242,7 @@ import fs15 from "fs";
 import path16 from "path";
 import { execSync as execSync7 } from "child_process";
 function bundleAndDeploy2(opts = {}) {
-  const release = opts.release === true;
+  const release = opts.release === true || opts.production === true;
   let resolved;
   try {
     resolved = resolveHostPaths();
@@ -4351,8 +4352,9 @@ async function buildIpa(opts = {}) {
   const appName = resolved.config.ios.appName;
   const bundleId = resolved.config.ios.bundleId;
   const iosDir = resolved.iosDir;
-  const configuration = opts.release ? "Release" : "Debug";
-  bundle_default2({ release: opts.release });
+  const release = opts.release === true || opts.production === true;
+  const configuration = release ? "Release" : "Debug";
+  bundle_default2({ release, production: opts.production });
   const scheme = appName;
   const workspacePath = path17.join(iosDir, `${appName}.xcworkspace`);
   const projectPath = path17.join(iosDir, `${appName}.xcodeproj`);
@@ -4403,93 +4405,507 @@ async function buildIpa(opts = {}) {
 }
 var build_default2 = buildIpa;
 
-// src/common/init.ts
+// src/common/init.tsx
 import fs17 from "fs";
 import path18 from "path";
-import readline from "readline";
-var rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout,
-  terminal: false
-});
-function ask(question) {
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => resolve(answer.trim()));
-  });
-}
-async function init() {
-  console.log("Tamer4Lynx Init: Let's set up your tamer.config.json\n");
-  const androidAppName = await ask("Android app name: ");
-  const androidPackageName = await ask("Android package name (e.g. com.example.app): ");
-  let androidSdk = await ask("Android SDK path (e.g. ~/Library/Android/sdk or $ANDROID_HOME): ");
+import { useState as useState4, useEffect as useEffect2, useCallback as useCallback3 } from "react";
+import { render, Text as Text9, Box as Box8 } from "ink";
+
+// src/common/tui/components/TextInput.tsx
+import { useState, useEffect } from "react";
+import { Box, Text } from "ink";
+import InkTextInput from "ink-text-input";
+import { jsx, jsxs } from "react/jsx-runtime";
+function TuiTextInput({
+  label,
+  value: valueProp,
+  defaultValue = "",
+  onChange: onChangeProp,
+  onSubmitValue,
+  onSubmit,
+  hint,
+  error
+}) {
+  const controlled = valueProp !== void 0;
+  const [internal, setInternal] = useState(defaultValue);
+  useEffect(() => {
+    if (!controlled) setInternal(defaultValue);
+  }, [defaultValue, controlled]);
+  const value = controlled ? valueProp : internal;
+  const onChange = (v) => {
+    if (!controlled) setInternal(v);
+    onChangeProp?.(v);
+  };
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    label ? /* @__PURE__ */ jsx(Text, { children: label }) : null,
+    /* @__PURE__ */ jsx(
+      InkTextInput,
+      {
+        value,
+        onChange,
+        onSubmit: () => {
+          const r = onSubmitValue?.(value);
+          if (r === false) return;
+          onSubmit();
+        }
+      }
+    ),
+    error ? /* @__PURE__ */ jsx(Text, { color: "red", children: error }) : hint ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: hint }) : null
+  ] });
+}
+
+// src/common/tui/components/SelectInput.tsx
+import "react";
+import { Box as Box2, Text as Text2 } from "ink";
+import InkSelectInput from "ink-select-input";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function TuiSelectInput({
+  label,
+  items,
+  onSelect,
+  hint
+}) {
+  return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
+    label ? /* @__PURE__ */ jsx2(Text2, { children: label }) : null,
+    /* @__PURE__ */ jsx2(
+      InkSelectInput,
+      {
+        items,
+        onSelect: (item) => onSelect(item.value)
+      }
+    ),
+    hint ? /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: hint }) : null
+  ] });
+}
+
+// src/common/tui/components/PasswordInput.tsx
+import "react";
+import { Box as Box3, Text as Text3 } from "ink";
+import InkTextInput2 from "ink-text-input";
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+
+// src/common/tui/components/ConfirmInput.tsx
+import "react";
+import { Box as Box4, Text as Text4 } from "ink";
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+function TuiConfirmInput({
+  label,
+  onConfirm,
+  defaultYes = false,
+  hint
+}) {
+  const items = defaultYes ? [
+    { label: "Yes (default)", value: "yes" },
+    { label: "No", value: "no" }
+  ] : [
+    { label: "No (default)", value: "no" },
+    { label: "Yes", value: "yes" }
+  ];
+  return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", children: [
+    label ? /* @__PURE__ */ jsx4(Text4, { children: label }) : null,
+    /* @__PURE__ */ jsx4(
+      TuiSelectInput,
+      {
+        items,
+        onSelect: (v) => onConfirm(v === "yes"),
+        hint
+      }
+    )
+  ] });
+}
+
+// src/common/tui/components/Spinner.tsx
+import "react";
+import { Text as Text5 } from "ink";
+import InkSpinner from "ink-spinner";
+import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
+function TuiSpinner({ label, type = "dots" }) {
+  return /* @__PURE__ */ jsxs5(Text5, { color: "cyan", children: [
+    /* @__PURE__ */ jsx5(InkSpinner, { type }),
+    label ? ` ${label}` : ""
+  ] });
+}
+
+// src/common/tui/components/StatusBox.tsx
+import "react";
+import { Box as Box5, Text as Text6 } from "ink";
+import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
+var colors = {
+  success: "green",
+  error: "red",
+  warning: "yellow",
+  info: "cyan"
+};
+function StatusBox({ variant, children, title }) {
+  const c = colors[variant];
+  return /* @__PURE__ */ jsxs6(Box5, { flexDirection: "column", borderStyle: "round", borderColor: c, paddingX: 1, children: [
+    title ? /* @__PURE__ */ jsx6(Text6, { bold: true, color: c, children: title }) : null,
+    /* @__PURE__ */ jsx6(Box5, { flexDirection: "column", children })
+  ] });
+}
+
+// src/common/tui/components/Wizard.tsx
+import "react";
+import { Box as Box6, Text as Text7 } from "ink";
+import { jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
+function Wizard({ step, total, title, children }) {
+  return /* @__PURE__ */ jsxs7(Box6, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs7(Text7, { dimColor: true, children: [
+      "Step ",
+      step,
+      "/",
+      total,
+      title ? ` \u2014 ${title}` : ""
+    ] }),
+    /* @__PURE__ */ jsx7(Box6, { marginTop: 1, flexDirection: "column", children })
+  ] });
+}
+
+// src/common/tui/components/ServerDashboard.tsx
+import "react";
+import { Box as Box7, Text as Text8 } from "ink";
+import { jsx as jsx8, jsxs as jsxs8 } from "react/jsx-runtime";
+function ServerDashboard({
+  projectName,
+  port,
+  lanIp,
+  devUrl,
+  wsUrl,
+  lynxBundleFile,
+  bonjour,
+  verbose,
+  buildPhase,
+  buildError,
+  wsConnections,
+  logLines,
+  showLogs,
+  qrLines,
+  phase,
+  startError
+}) {
+  if (phase === "failed") {
+    return /* @__PURE__ */ jsxs8(Box7, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx8(Text8, { color: "red", bold: true, children: "Dev server failed to start" }),
+      startError ? /* @__PURE__ */ jsx8(Text8, { color: "red", children: startError }) : null,
+      /* @__PURE__ */ jsx8(Box7, { marginTop: 1, children: /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: "Press Ctrl+C or 'q' to quit" }) })
+    ] });
+  }
+  const bundlePath = `${devUrl}/${lynxBundleFile}`;
+  return /* @__PURE__ */ jsxs8(Box7, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs8(Text8, { bold: true, color: "green", children: [
+      "Tamer4Lynx dev server (",
+      projectName,
+      ")"
+    ] }),
+    verbose ? /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: "Logs: verbose (native + JS)" }) : null,
+    /* @__PURE__ */ jsxs8(Box7, { marginTop: 1, flexDirection: "row", columnGap: 3, alignItems: "flex-start", children: [
+      qrLines.length > 0 ? /* @__PURE__ */ jsxs8(Box7, { flexDirection: "column", flexShrink: 0, children: [
+        /* @__PURE__ */ jsx8(Text8, { bold: true, children: "Scan" }),
+        qrLines.map((line, i) => /* @__PURE__ */ jsx8(Text8, { children: line }, i)),
+        /* @__PURE__ */ jsxs8(Box7, { marginTop: 1, flexDirection: "column", children: [
+          /* @__PURE__ */ jsx8(Text8, { bold: true, children: "Open" }),
+          /* @__PURE__ */ jsx8(Text8, { color: "cyan", wrap: "truncate-end", children: devUrl })
+        ] })
+      ] }) : /* @__PURE__ */ jsxs8(Box7, { flexDirection: "column", flexShrink: 0, children: [
+        /* @__PURE__ */ jsx8(Text8, { bold: true, children: "Open" }),
+        /* @__PURE__ */ jsx8(Text8, { color: "cyan", wrap: "truncate-end", children: devUrl })
+      ] }),
+      /* @__PURE__ */ jsxs8(
+        Box7,
+        {
+          flexDirection: "column",
+          flexGrow: 1,
+          minWidth: 28,
+          marginTop: qrLines.length > 0 ? 2 : 0,
+          children: [
+            /* @__PURE__ */ jsxs8(Text8, { children: [
+              "Port: ",
+              /* @__PURE__ */ jsx8(Text8, { color: "cyan", children: port }),
+              " \xB7 LAN: ",
+              /* @__PURE__ */ jsx8(Text8, { color: "cyan", children: lanIp })
+            ] }),
+            /* @__PURE__ */ jsx8(Text8, { dimColor: true, wrap: "truncate-end", children: bundlePath }),
+            /* @__PURE__ */ jsxs8(Text8, { dimColor: true, wrap: "truncate-end", children: [
+              devUrl,
+              "/meta.json"
+            ] }),
+            /* @__PURE__ */ jsx8(Text8, { dimColor: true, wrap: "truncate-end", children: wsUrl }),
+            bonjour ? /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: "mDNS: _tamer._tcp" }) : null,
+            /* @__PURE__ */ jsxs8(Box7, { marginTop: 1, flexDirection: "column", children: [
+              /* @__PURE__ */ jsx8(Text8, { bold: true, children: "Build" }),
+              buildPhase === "building" ? /* @__PURE__ */ jsx8(TuiSpinner, { label: "Building\u2026" }) : buildPhase === "error" ? /* @__PURE__ */ jsx8(Text8, { color: "red", children: buildError ?? "Build failed" }) : /* @__PURE__ */ jsx8(Text8, { color: "green", children: "Ready" })
+            ] }),
+            /* @__PURE__ */ jsxs8(Box7, { marginTop: 1, flexDirection: "column", children: [
+              /* @__PURE__ */ jsx8(Text8, { bold: true, children: "Connections" }),
+              /* @__PURE__ */ jsxs8(Text8, { dimColor: true, children: [
+                "WebSocket clients: ",
+                wsConnections
+              ] })
+            ] })
+          ]
+        }
+      )
+    ] }),
+    showLogs && logLines.length > 0 ? /* @__PURE__ */ jsxs8(Box7, { marginTop: 1, flexDirection: "column", borderStyle: "single", paddingX: 1, children: [
+      /* @__PURE__ */ jsxs8(Text8, { dimColor: true, children: [
+        "Build / output (last ",
+        logLines.length,
+        " lines)"
+      ] }),
+      logLines.slice(-12).map((line, i) => /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: line }, i))
+    ] }) : null,
+    /* @__PURE__ */ jsx8(Box7, { marginTop: 1, children: /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: "r rebuild \xB7 l toggle logs \xB7 q quit" }) })
+  ] });
+}
+
+// src/common/tui/hooks/useInputState.ts
+import { useState as useState2, useCallback } from "react";
+
+// src/common/tui/hooks/useValidation.ts
+function isValidAndroidPackage(name) {
+  const s = name.trim();
+  if (!s) return false;
+  return /^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)+$/.test(s);
+}
+function isValidIosBundleId(id) {
+  const s = id.trim();
+  if (!s) return false;
+  return /^[a-zA-Z][a-zA-Z0-9_-]*(\.[a-zA-Z0-9][a-zA-Z0-9_-]*)+$/.test(s);
+}
+
+// src/common/tui/hooks/useServerStatus.ts
+import { useState as useState3, useCallback as useCallback2 } from "react";
+
+// src/common/init.tsx
+import { jsx as jsx9, jsxs as jsxs9 } from "react/jsx-runtime";
+function resolveSdkInput(raw) {
+  let androidSdk = raw.trim();
   if (androidSdk.startsWith("$") && /^[A-Z0-9_]+$/.test(androidSdk.slice(1))) {
     const envVar = androidSdk.slice(1);
     const envValue = process.env[envVar];
     if (envValue) {
       androidSdk = envValue;
-      console.log(`Resolved ${androidSdk} from $${envVar}`);
-    } else {
-      console.warn(`Environment variable $${envVar} not found. SDK path will be left as-is.`);
+      return { resolved: androidSdk, message: `Using ${androidSdk} from $${envVar}` };
     }
+    return {
+      resolved: androidSdk,
+      message: `Environment variable $${envVar} not found \u2014 path saved as typed.`
+    };
   }
-  const useSame = await ask("Use same name and bundle ID for iOS as Android? (y/N): ");
-  let iosAppName;
-  let iosBundleId;
-  if (/^y(es)?$/i.test(useSame)) {
-    iosAppName = androidAppName;
-    iosBundleId = androidPackageName;
-  } else {
-    iosAppName = await ask("iOS app name: ");
-    iosBundleId = await ask("iOS bundle ID (e.g. com.example.app): ");
-  }
-  const lynxProject = await ask("Lynx project path (relative to project root, e.g. packages/example) [optional]: ");
-  const config = {
-    android: {
-      appName: androidAppName || void 0,
-      packageName: androidPackageName || void 0,
-      sdk: androidSdk || void 0
-    },
-    ios: {
-      appName: iosAppName || void 0,
-      bundleId: iosBundleId || void 0
-    },
-    paths: { androidDir: "android", iosDir: "ios" }
-  };
-  if (lynxProject) config.lynxProject = lynxProject;
-  const configPath = path18.join(process.cwd(), "tamer.config.json");
-  fs17.writeFileSync(configPath, JSON.stringify(config, null, 2));
-  console.log(`
-\u2705 Generated tamer.config.json at ${configPath}`);
-  const tamerTypesInclude = "node_modules/@tamer4lynx/tamer-*/src/**/*.d.ts";
-  const tsconfigCandidates = lynxProject ? [path18.join(process.cwd(), lynxProject, "tsconfig.json"), path18.join(process.cwd(), "tsconfig.json")] : [path18.join(process.cwd(), "tsconfig.json")];
-  for (const tsconfigPath of tsconfigCandidates) {
-    if (!fs17.existsSync(tsconfigPath)) continue;
-    try {
-      const raw = fs17.readFileSync(tsconfigPath, "utf-8");
-      const tsconfig = JSON.parse(raw);
-      const include = tsconfig.include ?? [];
-      const arr = Array.isArray(include) ? include : [include];
-      if (arr.some((p) => (typeof p === "string" ? p : "").includes("tamer-"))) continue;
-      arr.push(tamerTypesInclude);
-      tsconfig.include = arr;
-      fs17.writeFileSync(tsconfigPath, JSON.stringify(tsconfig, null, 2));
-      console.log(`\u2705 Updated ${path18.relative(process.cwd(), tsconfigPath)} to include tamer type declarations`);
-      break;
-    } catch (e) {
-      console.warn(`\u26A0 Could not update ${tsconfigPath}:`, e.message);
+  return { resolved: androidSdk };
+}
+function InitWizard() {
+  const [step, setStep] = useState4("welcome");
+  const [androidAppName, setAndroidAppName] = useState4("");
+  const [androidPackageName, setAndroidPackageName] = useState4("");
+  const [androidSdk, setAndroidSdk] = useState4("");
+  const [sdkHint, setSdkHint] = useState4();
+  const [iosAppName, setIosAppName] = useState4("");
+  const [iosBundleId, setIosBundleId] = useState4("");
+  const [lynxProject, setLynxProject] = useState4("");
+  const [pkgError, setPkgError] = useState4();
+  const [bundleError, setBundleError] = useState4();
+  const [doneMessage, setDoneMessage] = useState4([]);
+  const writeConfigAndTsconfig = useCallback3(() => {
+    const config = {
+      android: {
+        appName: androidAppName || void 0,
+        packageName: androidPackageName || void 0,
+        sdk: androidSdk || void 0
+      },
+      ios: {
+        appName: iosAppName || void 0,
+        bundleId: iosBundleId || void 0
+      },
+      paths: { androidDir: "android", iosDir: "ios" }
+    };
+    if (lynxProject.trim()) config.lynxProject = lynxProject.trim();
+    const configPath = path18.join(process.cwd(), "tamer.config.json");
+    fs17.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    const lines = [`Generated tamer.config.json at ${configPath}`];
+    const tamerTypesInclude = "node_modules/@tamer4lynx/tamer-*/src/**/*.d.ts";
+    const tsconfigCandidates = lynxProject.trim() ? [
+      path18.join(process.cwd(), lynxProject.trim(), "tsconfig.json"),
+      path18.join(process.cwd(), "tsconfig.json")
+    ] : [path18.join(process.cwd(), "tsconfig.json")];
+    function parseTsconfigJson(raw) {
+      try {
+        return JSON.parse(raw);
+      } catch {
+        const noTrailingCommas = raw.replace(/,\s*([\]}])/g, "$1");
+        return JSON.parse(noTrailingCommas);
+      }
     }
+    for (const tsconfigPath of tsconfigCandidates) {
+      if (!fs17.existsSync(tsconfigPath)) continue;
+      try {
+        const raw = fs17.readFileSync(tsconfigPath, "utf-8");
+        const tsconfig = parseTsconfigJson(raw);
+        const include = tsconfig.include ?? [];
+        const arr = Array.isArray(include) ? include : [include];
+        if (arr.some((p) => (typeof p === "string" ? p : "").includes("tamer-"))) continue;
+        arr.push(tamerTypesInclude);
+        tsconfig.include = arr;
+        fs17.writeFileSync(tsconfigPath, JSON.stringify(tsconfig, null, 2));
+        lines.push(`Updated ${path18.relative(process.cwd(), tsconfigPath)} for tamer types`);
+        break;
+      } catch (e) {
+        lines.push(`Could not update ${tsconfigPath}: ${e.message}`);
+      }
+    }
+    setDoneMessage(lines);
+    setStep("done");
+    setTimeout(() => process.exit(0), 2e3);
+  }, [androidAppName, androidPackageName, androidSdk, iosAppName, iosBundleId, lynxProject]);
+  useEffect2(() => {
+    if (step !== "saving") return;
+    writeConfigAndTsconfig();
+  }, [step, writeConfigAndTsconfig]);
+  if (step === "welcome") {
+    return /* @__PURE__ */ jsxs9(Box8, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx9(Text9, { bold: true, children: "Tamer4Lynx init" }),
+      /* @__PURE__ */ jsx9(Text9, { dimColor: true, children: "Set up tamer.config.json for your project." }),
+      /* @__PURE__ */ jsx9(Box8, { marginTop: 1, children: /* @__PURE__ */ jsx9(
+        TuiSelectInput,
+        {
+          label: "Continue?",
+          items: [{ label: "Start", value: "start" }],
+          onSelect: () => setStep("android-app")
+        }
+      ) })
+    ] });
+  }
+  if (step === "android-app") {
+    return /* @__PURE__ */ jsx9(Wizard, { step: 1, total: 6, title: "Android app name", children: /* @__PURE__ */ jsx9(
+      TuiTextInput,
+      {
+        label: "Android app name:",
+        defaultValue: androidAppName,
+        onSubmitValue: (v) => setAndroidAppName(v),
+        onSubmit: () => setStep("android-pkg")
+      }
+    ) });
+  }
+  if (step === "android-pkg") {
+    return /* @__PURE__ */ jsx9(Wizard, { step: 2, total: 6, title: "Android package name", children: /* @__PURE__ */ jsx9(
+      TuiTextInput,
+      {
+        label: "Android package name (e.g. com.example.app):",
+        defaultValue: androidPackageName,
+        error: pkgError,
+        onChange: () => setPkgError(void 0),
+        onSubmitValue: (v) => {
+          const t = v.trim();
+          if (t && !isValidAndroidPackage(t)) {
+            setPkgError("Use reverse-DNS form: com.mycompany.app");
+            return false;
+          }
+          setAndroidPackageName(t);
+          setPkgError(void 0);
+        },
+        onSubmit: () => setStep("android-sdk")
+      }
+    ) });
+  }
+  if (step === "android-sdk") {
+    return /* @__PURE__ */ jsx9(Wizard, { step: 3, total: 6, title: "Android SDK", children: /* @__PURE__ */ jsx9(
+      TuiTextInput,
+      {
+        label: "Android SDK path (e.g. ~/Library/Android/sdk or $ANDROID_HOME):",
+        defaultValue: androidSdk,
+        onSubmitValue: (v) => {
+          const { resolved, message } = resolveSdkInput(v);
+          setAndroidSdk(resolved);
+          setSdkHint(message);
+        },
+        onSubmit: () => setStep("ios-reuse"),
+        hint: sdkHint
+      }
+    ) });
+  }
+  if (step === "ios-reuse") {
+    return /* @__PURE__ */ jsx9(Wizard, { step: 4, total: 6, title: "iOS", children: /* @__PURE__ */ jsx9(
+      TuiConfirmInput,
+      {
+        label: "Use the same app name and bundle ID for iOS as Android?",
+        defaultYes: false,
+        onConfirm: (yes) => {
+          if (yes) {
+            setIosAppName(androidAppName);
+            setIosBundleId(androidPackageName);
+            setStep("lynx-path");
+          } else {
+            setStep("ios-app");
+          }
+        },
+        hint: "No = enter iOS-specific values next"
+      }
+    ) });
+  }
+  if (step === "ios-app") {
+    return /* @__PURE__ */ jsx9(Wizard, { step: 4, total: 6, title: "iOS app name", children: /* @__PURE__ */ jsx9(
+      TuiTextInput,
+      {
+        label: "iOS app name:",
+        defaultValue: iosAppName,
+        onSubmitValue: (v) => setIosAppName(v),
+        onSubmit: () => setStep("ios-bundle")
+      }
+    ) });
+  }
+  if (step === "ios-bundle") {
+    return /* @__PURE__ */ jsx9(Wizard, { step: 5, total: 6, title: "iOS bundle ID", children: /* @__PURE__ */ jsx9(
+      TuiTextInput,
+      {
+        label: "iOS bundle ID (e.g. com.example.app):",
+        defaultValue: iosBundleId,
+        error: bundleError,
+        onChange: () => setBundleError(void 0),
+        onSubmitValue: (v) => {
+          const t = v.trim();
+          if (t && !isValidIosBundleId(t)) {
+            setBundleError("Use reverse-DNS form: com.mycompany.App");
+            return false;
+          }
+          setIosBundleId(t);
+          setBundleError(void 0);
+        },
+        onSubmit: () => setStep("lynx-path")
+      }
+    ) });
+  }
+  if (step === "lynx-path") {
+    return /* @__PURE__ */ jsx9(Wizard, { step: 6, total: 6, title: "Lynx project", children: /* @__PURE__ */ jsx9(
+      TuiTextInput,
+      {
+        label: "Lynx project path relative to project root (optional, e.g. packages/example):",
+        defaultValue: lynxProject,
+        onSubmitValue: (v) => setLynxProject(v),
+        onSubmit: () => setStep("saving"),
+        hint: "Press Enter with empty to skip"
+      }
+    ) });
   }
-  rl.close();
+  if (step === "saving") {
+    return /* @__PURE__ */ jsx9(Box8, { children: /* @__PURE__ */ jsx9(TuiSpinner, { label: "Writing tamer.config.json and updating tsconfig\u2026" }) });
+  }
+  if (step === "done") {
+    return /* @__PURE__ */ jsx9(Box8, { flexDirection: "column", children: /* @__PURE__ */ jsx9(StatusBox, { variant: "success", title: "Done", children: doneMessage.map((line, i) => /* @__PURE__ */ jsx9(Text9, { color: "green", children: line }, i)) }) });
+  }
+  return null;
+}
+async function init() {
+  const { waitUntilExit } = render(/* @__PURE__ */ jsx9(InitWizard, {}));
+  await waitUntilExit();
 }
-var init_default = init;
 
 // src/common/create.ts
 import fs18 from "fs";
 import path19 from "path";
-import readline2 from "readline";
-var rl2 = readline2.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
-function ask2(question) {
-  return new Promise((resolve) => rl2.question(question, (answer) => resolve(answer.trim())));
+import readline from "readline";
+var rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+function ask(question) {
+  return new Promise((resolve) => rl.question(question, (answer) => resolve(answer.trim())));
 }
 async function create3(opts) {
   console.log("Tamer4Lynx: Create Lynx Extension\n");
@@ -4528,29 +4944,29 @@ async function create3(opts) {
     console.log("  [ ] Native Module");
     console.log("  [ ] Element");
     console.log("  [ ] Service\n");
-    includeModule = /^y(es)?$/i.test(await ask2("Include Native Module? (Y/n): ") || "y");
-    includeElement = /^y(es)?$/i.test(await ask2("Include Element? (y/N): ") || "n");
-    includeService = /^y(es)?$/i.test(await ask2("Include Service? (y/N): ") || "n");
+    includeModule = /^y(es)?$/i.test(await ask("Include Native Module? (Y/n): ") || "y");
+    includeElement = /^y(es)?$/i.test(await ask("Include Element? (y/N): ") || "n");
+    includeService = /^y(es)?$/i.test(await ask("Include Service? (y/N): ") || "n");
   }
   if (!includeModule && !includeElement && !includeService) {
     console.error("\u274C At least one extension type is required.");
-    rl2.close();
+    rl.close();
     process.exit(1);
   }
-  const extName = await ask2("Extension package name (e.g. my-lynx-module): ");
+  const extName = await ask("Extension package name (e.g. my-lynx-module): ");
   if (!extName || !/^[a-z0-9-_]+$/.test(extName)) {
     console.error("\u274C Invalid package name. Use lowercase letters, numbers, hyphens, underscores.");
-    rl2.close();
+    rl.close();
     process.exit(1);
   }
-  const packageName = await ask2("Android package name (e.g. com.example.mymodule): ") || `com.example.${extName.replace(/-/g, "")}`;
+  const packageName = await ask("Android package name (e.g. com.example.mymodule): ") || `com.example.${extName.replace(/-/g, "")}`;
   const simpleModuleName = extName.split("-").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("") + "Module";
   const fullModuleClassName = `${packageName}.${simpleModuleName}`;
   const cwd = process.cwd();
   const root = path19.join(cwd, extName);
   if (fs18.existsSync(root)) {
     console.error(`\u274C Directory ${extName} already exists.`);
-    rl2.close();
+    rl.close();
     process.exit(1);
   }
   fs18.mkdirSync(root, { recursive: true });
@@ -4704,7 +5120,7 @@ This package uses \`lynx.ext.json\` (RFC-compliant) for autolinking.
   console.log(`  cd ${extName}`);
   console.log("  npm install");
   if (includeModule) console.log("  npm run codegen");
-  rl2.close();
+  rl.close();
 }
 var create_default3 = create3;
 
@@ -4775,14 +5191,16 @@ function extractLynxModules(files) {
 }
 var codegen_default = codegen;
 
-// src/common/devServer.ts
+// src/common/devServer.tsx
+import { useState as useState5, useEffect as useEffect3, useRef, useCallback as useCallback4 } from "react";
 import { spawn } from "child_process";
 import fs20 from "fs";
 import http from "http";
 import os4 from "os";
 import path21 from "path";
-import readline3 from "readline";
+import { render as render2, useInput, useApp } from "ink";
 import { WebSocketServer } from "ws";
+import { jsx as jsx10 } from "react/jsx-runtime";
 var DEFAULT_PORT = 3e3;
 var STATIC_MIME = {
   ".png": "image/png",
@@ -4837,319 +5255,431 @@ function getLanIp() {
   }
   return "localhost";
 }
-async function startDevServer(opts) {
-  const verbose = opts?.verbose ?? false;
-  const resolved = resolveHostPaths();
-  const { projectRoot, lynxProjectDir, lynxBundlePath, lynxBundleFile, config } = resolved;
-  const distDir = path21.dirname(lynxBundlePath);
-  let buildProcess = null;
-  function detectPackageManager2(cwd) {
-    const dir = path21.resolve(cwd);
-    if (fs20.existsSync(path21.join(dir, "pnpm-lock.yaml"))) return { cmd: "pnpm", args: ["run", "build"] };
-    if (fs20.existsSync(path21.join(dir, "bun.lockb")) || fs20.existsSync(path21.join(dir, "bun.lock"))) return { cmd: "bun", args: ["run", "build"] };
-    return { cmd: "npm", args: ["run", "build"] };
-  }
-  function runBuild() {
-    return new Promise((resolve, reject) => {
-      const { cmd, args } = detectPackageManager2(lynxProjectDir);
-      buildProcess = spawn(cmd, args, {
-        cwd: lynxProjectDir,
-        stdio: "pipe",
-        shell: process.platform === "win32"
-      });
-      let stderr = "";
-      buildProcess.stderr?.on("data", (d) => {
-        stderr += d.toString();
-      });
-      buildProcess.on("close", (code) => {
-        buildProcess = null;
-        if (code === 0) resolve();
-        else reject(new Error(stderr || `Build exited ${code}`));
-      });
-    });
-  }
-  const preferredPort = config.devServer?.port ?? config.devServer?.httpPort ?? DEFAULT_PORT;
-  const port = await findAvailablePort(preferredPort);
-  if (port !== preferredPort) {
-    console.log(`\x1B[33m\u26A0 Port ${preferredPort} in use, using ${port}\x1B[0m`);
-  }
-  const projectName = path21.basename(lynxProjectDir);
-  const basePath = `/${projectName}`;
-  const iconPaths = resolveIconPaths(projectRoot, config);
-  let iconFilePath = null;
-  if (iconPaths?.source && fs20.statSync(iconPaths.source).isFile()) {
-    iconFilePath = iconPaths.source;
-  } else if (iconPaths?.androidAdaptiveForeground && fs20.statSync(iconPaths.androidAdaptiveForeground).isFile()) {
-    iconFilePath = iconPaths.androidAdaptiveForeground;
-  } else if (iconPaths?.android) {
-    const androidIcon = path21.join(iconPaths.android, "mipmap-xxxhdpi", "ic_launcher.png");
-    if (fs20.existsSync(androidIcon)) iconFilePath = androidIcon;
-  } else if (iconPaths?.ios) {
-    const iosIcon = path21.join(iconPaths.ios, "Icon-1024.png");
-    if (fs20.existsSync(iosIcon)) iconFilePath = iosIcon;
-  }
-  const iconExt = iconFilePath ? path21.extname(iconFilePath) || ".png" : "";
-  const httpServer = http.createServer((req, res) => {
-    let reqPath = (req.url || "/").split("?")[0];
-    if (reqPath === `${basePath}/status`) {
-      res.setHeader("Content-Type", "text/plain");
-      res.setHeader("Access-Control-Allow-Origin", "*");
-      res.end("packager-status:running");
-      return;
-    }
-    if (reqPath === `${basePath}/meta.json`) {
-      const lanIp = getLanIp();
-      const nativeModules = discoverNativeExtensions(projectRoot);
-      const androidPackageName = config.android?.packageName?.trim();
-      const iosBundleId = config.ios?.bundleId?.trim();
-      const idParts = [androidPackageName?.toLowerCase(), iosBundleId?.toLowerCase()].filter(
-        (x) => Boolean(x)
-      );
-      const meta = {
-        name: projectName,
-        slug: projectName,
-        bundleUrl: `http://${lanIp}:${port}${basePath}/${lynxBundleFile}`,
-        bundleFile: lynxBundleFile,
-        hostUri: `http://${lanIp}:${port}${basePath}`,
-        debuggerHost: `${lanIp}:${port}`,
-        developer: { tool: "tamer4lynx" },
-        packagerStatus: "running",
-        nativeModules: nativeModules.map((m) => ({ packageName: m.packageName, moduleClassName: m.moduleClassName }))
-      };
-      if (androidPackageName) meta.androidPackageName = androidPackageName;
-      if (iosBundleId) meta.iosBundleId = iosBundleId;
-      if (idParts.length > 0) meta.tamerAppKey = idParts.join("|");
-      const rawIcon = config.icon;
-      if (rawIcon && typeof rawIcon === "object" && "source" in rawIcon && typeof rawIcon.source === "string") {
-        meta.iconSource = rawIcon.source;
-      } else if (typeof rawIcon === "string") {
-        meta.iconSource = rawIcon;
-      }
-      if (iconFilePath) {
-        meta.icon = `http://${lanIp}:${port}${basePath}/icon${iconExt}`;
-      }
-      res.setHeader("Content-Type", "application/json");
-      res.setHeader("Access-Control-Allow-Origin", "*");
-      res.end(JSON.stringify(meta, null, 2));
-      return;
-    }
-    if (iconFilePath && (reqPath === `${basePath}/icon` || reqPath === `${basePath}/icon${iconExt}`)) {
-      fs20.readFile(iconFilePath, (err, data) => {
-        if (err) {
-          res.writeHead(404);
-          res.end();
-          return;
-        }
-        res.setHeader("Content-Type", STATIC_MIME[iconExt] ?? "image/png");
-        res.setHeader("Access-Control-Allow-Origin", "*");
-        res.end(data);
-      });
+function detectPackageManager(cwd) {
+  const dir = path21.resolve(cwd);
+  if (fs20.existsSync(path21.join(dir, "pnpm-lock.yaml"))) return { cmd: "pnpm", args: ["run", "build"] };
+  if (fs20.existsSync(path21.join(dir, "bun.lockb")) || fs20.existsSync(path21.join(dir, "bun.lock")))
+    return { cmd: "bun", args: ["run", "build"] };
+  return { cmd: "npm", args: ["run", "build"] };
+}
+var initialUi = () => ({
+  phase: "starting",
+  projectName: "",
+  port: 0,
+  lanIp: "localhost",
+  devUrl: "",
+  wsUrl: "",
+  lynxBundleFile: "main.lynx.bundle",
+  bonjour: false,
+  verbose: false,
+  buildPhase: "idle",
+  wsConnections: 0,
+  logLines: [],
+  showLogs: false,
+  qrLines: []
+});
+function DevServerApp({ verbose }) {
+  const { exit } = useApp();
+  const [ui, setUi] = useState5(() => {
+    const s = initialUi();
+    s.verbose = verbose;
+    return s;
+  });
+  const cleanupRef = useRef(null);
+  const rebuildRef = useRef(() => Promise.resolve());
+  const quitOnceRef = useRef(false);
+  const appendLog = useCallback4((chunk) => {
+    const lines = chunk.split(/\r?\n/).filter(Boolean);
+    setUi((prev) => ({
+      ...prev,
+      logLines: [...prev.logLines, ...lines].slice(-400)
+    }));
+  }, []);
+  const handleQuit = useCallback4(() => {
+    if (quitOnceRef.current) return;
+    quitOnceRef.current = true;
+    void cleanupRef.current?.();
+    exit();
+  }, [exit]);
+  useInput((input, key) => {
+    if (key.ctrl && key.name === "c") {
+      handleQuit();
       return;
     }
-    const lynxStaticMounts = [
-      { prefix: `${basePath}/src/assets/`, rootSub: "src/assets" },
-      { prefix: `${basePath}/assets/`, rootSub: "assets" }
-    ];
-    for (const { prefix, rootSub } of lynxStaticMounts) {
-      if (!reqPath.startsWith(prefix)) continue;
-      let rel = reqPath.slice(prefix.length);
-      try {
-        rel = decodeURIComponent(rel);
-      } catch {
-        res.writeHead(400);
-        res.end();
-        return;
-      }
-      const safe = path21.normalize(rel).replace(/^(\.\.(\/|\\|$))+/, "");
-      if (path21.isAbsolute(safe) || safe.startsWith("..")) {
-        res.writeHead(403);
-        res.end();
-        return;
-      }
-      const allowedRoot = path21.resolve(lynxProjectDir, rootSub);
-      const abs = path21.resolve(allowedRoot, safe);
-      if (!abs.startsWith(allowedRoot + path21.sep) && abs !== allowedRoot) {
-        res.writeHead(403);
-        res.end();
-        return;
-      }
-      if (!fs20.existsSync(abs) || !fs20.statSync(abs).isFile()) {
-        res.writeHead(404);
-        res.end("Not found");
-        return;
-      }
-      sendFileFromDisk(res, abs);
+    if (input === "q") {
+      handleQuit();
       return;
     }
-    if (reqPath === "/" || reqPath === basePath || reqPath === `${basePath}/`) {
-      reqPath = `${basePath}/${lynxBundleFile}`;
-    } else if (!reqPath.startsWith(basePath)) {
-      reqPath = basePath + (reqPath.startsWith("/") ? reqPath : "/" + reqPath);
-    }
-    const relPath = reqPath.replace(basePath, "").replace(/^\//, "") || lynxBundleFile;
-    const filePath = path21.resolve(distDir, relPath);
-    const distResolved = path21.resolve(distDir);
-    if (!filePath.startsWith(distResolved + path21.sep) && filePath !== distResolved) {
-      res.writeHead(403);
-      res.end();
+    if (input === "r") {
+      void rebuildRef.current();
       return;
     }
-    fs20.readFile(filePath, (err, data) => {
-      if (err) {
-        res.writeHead(404);
-        res.end("Not found");
-        return;
-      }
-      res.setHeader("Access-Control-Allow-Origin", "*");
-      res.setHeader("Content-Type", reqPath.endsWith(".bundle") ? "application/octet-stream" : "application/javascript");
-      res.end(data);
-    });
-  });
-  const wss = new WebSocketServer({ noServer: true });
-  httpServer.on("upgrade", (request, socket, head) => {
-    const reqPath = (request.url || "").split("?")[0];
-    if (reqPath === `${basePath}/__hmr` || reqPath === "/__hmr" || reqPath.endsWith("/__hmr")) {
-      wss.handleUpgrade(request, socket, head, (ws) => wss.emit("connection", ws, request));
-    } else {
-      socket.destroy();
+    if (input === "l") {
+      setUi((s) => ({ ...s, showLogs: !s.showLogs }));
     }
   });
-  wss.on("connection", (ws, req) => {
-    const clientIp = req.socket.remoteAddress ?? "unknown";
-    console.log(`\x1B[90m[WS] client connected: ${clientIp}\x1B[0m`);
-    ws.send(JSON.stringify({ type: "connected" }));
-    ws.on("close", () => {
-      console.log(`\x1B[90m[WS] client disconnected: ${clientIp}\x1B[0m`);
-    });
-    ws.on("message", (data) => {
+  useEffect3(() => {
+    const onSig = () => {
+      handleQuit();
+    };
+    process.on("SIGINT", onSig);
+    process.on("SIGTERM", onSig);
+    return () => {
+      process.off("SIGINT", onSig);
+      process.off("SIGTERM", onSig);
+    };
+  }, [handleQuit]);
+  useEffect3(() => {
+    let alive = true;
+    let buildProcess = null;
+    let watcher = null;
+    let stopBonjour;
+    const run = async () => {
       try {
-        const msg = JSON.parse(data.toString());
-        if (msg?.type === "console_log" && Array.isArray(msg.message)) {
-          const skip = msg.message.includes("[rspeedy-dev-server]") || msg.message.includes("[HMR]");
-          if (skip) return;
-          const isJs = msg.tag === "lynx-console" || msg.tag == null;
-          if (!verbose && !isJs) return;
-          const prefix = isJs ? "\x1B[36m[APP]:\x1B[0m" : "\x1B[33m[NATIVE]:\x1B[0m";
-          console.log(prefix, ...msg.message);
+        const resolved = resolveHostPaths();
+        const { projectRoot, lynxProjectDir, lynxBundlePath, lynxBundleFile, config } = resolved;
+        const distDir = path21.dirname(lynxBundlePath);
+        const projectName = path21.basename(lynxProjectDir);
+        const basePath = `/${projectName}`;
+        setUi((s) => ({ ...s, projectName, lynxBundleFile }));
+        const preferredPort = config.devServer?.port ?? config.devServer?.httpPort ?? DEFAULT_PORT;
+        const port = await findAvailablePort(preferredPort);
+        if (port !== preferredPort) {
+          appendLog(`Port ${preferredPort} in use, using ${port}`);
         }
-      } catch {
-      }
-    });
-  });
-  function broadcastReload() {
-    wss.clients.forEach((client) => {
-      if (client.readyState === 1) client.send(JSON.stringify({ type: "reload" }));
-    });
-  }
-  let chokidar = null;
-  try {
-    chokidar = await import("chokidar");
-  } catch {
-  }
-  if (chokidar) {
-    const watchPaths = [
-      path21.join(lynxProjectDir, "src"),
-      path21.join(lynxProjectDir, "lynx.config.ts"),
-      path21.join(lynxProjectDir, "lynx.config.js")
-    ].filter((p) => fs20.existsSync(p));
-    if (watchPaths.length > 0) {
-      const watcher = chokidar.watch(watchPaths, { ignoreInitial: true });
-      watcher.on("change", async () => {
-        try {
-          await runBuild();
-          broadcastReload();
-          console.log("\u{1F504} Rebuilt, clients notified");
-        } catch (e) {
-          console.error("Build failed:", e.message);
-        }
-      });
-    }
-  }
-  try {
-    await runBuild();
-  } catch (e) {
-    console.error("\u274C Initial build failed:", e.message);
-    process.exit(1);
-  }
-  let stopBonjour;
-  httpServer.listen(port, "0.0.0.0", () => {
-    void import("dnssd-advertise").then(({ advertise }) => {
-      stopBonjour = advertise({
-        name: projectName,
-        type: "tamer",
-        protocol: "tcp",
-        port,
-        txt: {
-          name: projectName.slice(0, 255),
-          path: basePath.slice(0, 255)
+        const iconPaths = resolveIconPaths(projectRoot, config);
+        let iconFilePath = null;
+        if (iconPaths?.source && fs20.statSync(iconPaths.source).isFile()) {
+          iconFilePath = iconPaths.source;
+        } else if (iconPaths?.androidAdaptiveForeground && fs20.statSync(iconPaths.androidAdaptiveForeground).isFile()) {
+          iconFilePath = iconPaths.androidAdaptiveForeground;
+        } else if (iconPaths?.android) {
+          const androidIcon = path21.join(iconPaths.android, "mipmap-xxxhdpi", "ic_launcher.png");
+          if (fs20.existsSync(androidIcon)) iconFilePath = androidIcon;
+        } else if (iconPaths?.ios) {
+          const iosIcon = path21.join(iconPaths.ios, "Icon-1024.png");
+          if (fs20.existsSync(iosIcon)) iconFilePath = iosIcon;
         }
-      });
-    }).catch(() => {
-    });
-    const lanIp = getLanIp();
-    const devUrl = `http://${lanIp}:${port}${basePath}`;
-    const wsUrl = `ws://${lanIp}:${port}${basePath}/__hmr`;
-    console.log(`
-\u{1F680} Tamer4Lynx dev server (${projectName})`);
-    if (verbose) console.log(`   Logs: \x1B[33mverbose\x1B[0m (native + JS)`);
-    console.log(`   Bundle:  ${devUrl}/${lynxBundleFile}`);
-    console.log(`   Meta:    ${devUrl}/meta.json`);
-    console.log(`   HMR WS:  ${wsUrl}`);
-    if (stopBonjour) console.log(`   mDNS:    _tamer._tcp (discoverable on LAN)`);
-    console.log(`
-   Scan QR or enter in app: ${devUrl}
-`);
-    void import("qrcode-terminal").then((mod) => {
-      const qrcode = mod.default ?? mod;
-      qrcode.generate(devUrl, { small: true });
-    }).catch(() => {
-    });
-    if (process.stdin.isTTY) {
-      readline3.emitKeypressEvents(process.stdin);
-      process.stdin.setRawMode(true);
-      process.stdin.resume();
-      process.stdin.setEncoding("utf8");
-      const help = "\x1B[90m  r: refresh  c/Ctrl+L: clear  Ctrl+C: exit\x1B[0m";
-      console.log(help);
-      process.stdin.on("keypress", (str, key) => {
-        if (key.ctrl && key.name === "c") {
-          void cleanup();
-          return;
+        const iconExt = iconFilePath ? path21.extname(iconFilePath) || ".png" : "";
+        const runBuild = () => {
+          return new Promise((resolve, reject) => {
+            const { cmd, args } = detectPackageManager(lynxProjectDir);
+            buildProcess = spawn(cmd, args, {
+              cwd: lynxProjectDir,
+              stdio: "pipe",
+              shell: process.platform === "win32"
+            });
+            let stderr = "";
+            buildProcess.stdout?.on("data", (d) => {
+              appendLog(d.toString());
+            });
+            buildProcess.stderr?.on("data", (d) => {
+              const t = d.toString();
+              stderr += t;
+              appendLog(t);
+            });
+            buildProcess.on("close", (code) => {
+              buildProcess = null;
+              if (code === 0) resolve();
+              else reject(new Error(stderr || `Build exited ${code}`));
+            });
+          });
+        };
+        const doBuild = async () => {
+          setUi((s) => ({ ...s, buildPhase: "building", buildError: void 0 }));
+          try {
+            await runBuild();
+            if (!alive) return;
+            setUi((s) => ({ ...s, buildPhase: "success" }));
+          } catch (e) {
+            if (!alive) return;
+            const msg = e.message;
+            setUi((s) => ({ ...s, buildPhase: "error", buildError: msg }));
+            throw e;
+          }
+        };
+        const httpSrv = http.createServer((req, res) => {
+          let reqPath = (req.url || "/").split("?")[0];
+          if (reqPath === `${basePath}/status`) {
+            res.setHeader("Content-Type", "text/plain");
+            res.setHeader("Access-Control-Allow-Origin", "*");
+            res.end("packager-status:running");
+            return;
+          }
+          if (reqPath === `${basePath}/meta.json`) {
+            const lanIp2 = getLanIp();
+            const nativeModules = discoverNativeExtensions(projectRoot);
+            const androidPackageName = config.android?.packageName?.trim();
+            const iosBundleId = config.ios?.bundleId?.trim();
+            const idParts = [androidPackageName?.toLowerCase(), iosBundleId?.toLowerCase()].filter(
+              (x) => Boolean(x)
+            );
+            const meta = {
+              name: projectName,
+              slug: projectName,
+              bundleUrl: `http://${lanIp2}:${port}${basePath}/${lynxBundleFile}`,
+              bundleFile: lynxBundleFile,
+              hostUri: `http://${lanIp2}:${port}${basePath}`,
+              debuggerHost: `${lanIp2}:${port}`,
+              developer: { tool: "tamer4lynx" },
+              packagerStatus: "running",
+              nativeModules: nativeModules.map((m) => ({
+                packageName: m.packageName,
+                moduleClassName: m.moduleClassName
+              }))
+            };
+            if (androidPackageName) meta.androidPackageName = androidPackageName;
+            if (iosBundleId) meta.iosBundleId = iosBundleId;
+            if (idParts.length > 0) meta.tamerAppKey = idParts.join("|");
+            const rawIcon = config.icon;
+            if (rawIcon && typeof rawIcon === "object" && "source" in rawIcon && typeof rawIcon.source === "string") {
+              meta.iconSource = rawIcon.source;
+            } else if (typeof rawIcon === "string") {
+              meta.iconSource = rawIcon;
+            }
+            if (iconFilePath) {
+              meta.icon = `http://${lanIp2}:${port}${basePath}/icon${iconExt}`;
+            }
+            res.setHeader("Content-Type", "application/json");
+            res.setHeader("Access-Control-Allow-Origin", "*");
+            res.end(JSON.stringify(meta, null, 2));
+            return;
+          }
+          if (iconFilePath && (reqPath === `${basePath}/icon` || reqPath === `${basePath}/icon${iconExt}`)) {
+            fs20.readFile(iconFilePath, (err, data) => {
+              if (err) {
+                res.writeHead(404);
+                res.end();
+                return;
+              }
+              res.setHeader("Content-Type", STATIC_MIME[iconExt] ?? "image/png");
+              res.setHeader("Access-Control-Allow-Origin", "*");
+              res.end(data);
+            });
+            return;
+          }
+          const lynxStaticMounts = [
+            { prefix: `${basePath}/src/assets/`, rootSub: "src/assets" },
+            { prefix: `${basePath}/assets/`, rootSub: "assets" }
+          ];
+          for (const { prefix, rootSub } of lynxStaticMounts) {
+            if (!reqPath.startsWith(prefix)) continue;
+            let rel = reqPath.slice(prefix.length);
+            try {
+              rel = decodeURIComponent(rel);
+            } catch {
+              res.writeHead(400);
+              res.end();
+              return;
+            }
+            const safe = path21.normalize(rel).replace(/^(\.\.(\/|\\|$))+/, "");
+            if (path21.isAbsolute(safe) || safe.startsWith("..")) {
+              res.writeHead(403);
+              res.end();
+              return;
+            }
+            const allowedRoot = path21.resolve(lynxProjectDir, rootSub);
+            const abs = path21.resolve(allowedRoot, safe);
+            if (!abs.startsWith(allowedRoot + path21.sep) && abs !== allowedRoot) {
+              res.writeHead(403);
+              res.end();
+              return;
+            }
+            if (!fs20.existsSync(abs) || !fs20.statSync(abs).isFile()) {
+              res.writeHead(404);
+              res.end("Not found");
+              return;
+            }
+            sendFileFromDisk(res, abs);
+            return;
+          }
+          if (reqPath === "/" || reqPath === basePath || reqPath === `${basePath}/`) {
+            reqPath = `${basePath}/${lynxBundleFile}`;
+          } else if (!reqPath.startsWith(basePath)) {
+            reqPath = basePath + (reqPath.startsWith("/") ? reqPath : "/" + reqPath);
+          }
+          const relPath = reqPath.replace(basePath, "").replace(/^\//, "") || lynxBundleFile;
+          const filePath = path21.resolve(distDir, relPath);
+          const distResolved = path21.resolve(distDir);
+          if (!filePath.startsWith(distResolved + path21.sep) && filePath !== distResolved) {
+            res.writeHead(403);
+            res.end();
+            return;
+          }
+          fs20.readFile(filePath, (err, data) => {
+            if (err) {
+              res.writeHead(404);
+              res.end("Not found");
+              return;
+            }
+            res.setHeader("Access-Control-Allow-Origin", "*");
+            res.setHeader("Content-Type", reqPath.endsWith(".bundle") ? "application/octet-stream" : "application/javascript");
+            res.end(data);
+          });
+        });
+        const wssInst = new WebSocketServer({ noServer: true });
+        rebuildRef.current = async () => {
+          try {
+            await doBuild();
+            if (!alive) return;
+            wssInst.clients.forEach((client) => {
+              if (client.readyState === 1) client.send(JSON.stringify({ type: "reload" }));
+            });
+            appendLog("Rebuilt, clients notified");
+          } catch {
+          }
+        };
+        httpSrv.on("upgrade", (request, socket, head) => {
+          const p = (request.url || "").split("?")[0];
+          if (p === `${basePath}/__hmr` || p === "/__hmr" || p.endsWith("/__hmr")) {
+            wssInst.handleUpgrade(request, socket, head, (ws) => wssInst.emit("connection", ws, request));
+          } else {
+            socket.destroy();
+          }
+        });
+        wssInst.on("connection", (ws, req) => {
+          const clientIp = req.socket.remoteAddress ?? "unknown";
+          setUi((s) => ({ ...s, wsConnections: s.wsConnections + 1 }));
+          appendLog(`[WS] connected: ${clientIp}`);
+          ws.send(JSON.stringify({ type: "connected" }));
+          ws.on("close", () => {
+            setUi((s) => ({ ...s, wsConnections: Math.max(0, s.wsConnections - 1) }));
+            appendLog(`[WS] disconnected: ${clientIp}`);
+          });
+          ws.on("message", (data) => {
+            try {
+              const msg = JSON.parse(data.toString());
+              if (msg?.type === "console_log" && Array.isArray(msg.message)) {
+                const skip = msg.message.includes("[rspeedy-dev-server]") || msg.message.includes("[HMR]");
+                if (skip) return;
+                const isJs = msg.tag === "lynx-console" || msg.tag == null;
+                if (!verbose && !isJs) return;
+                appendLog(`${isJs ? "[APP]" : "[NATIVE]"} ${msg.message.join(" ")}`);
+              }
+            } catch {
+            }
+          });
+        });
+        let chokidar = null;
+        try {
+          chokidar = await import("chokidar");
+        } catch {
         }
-        switch (key.name) {
-          case "r":
-            runBuild().then(() => {
-              broadcastReload();
-              console.log("\u{1F504} Refreshed, clients notified");
-            }).catch((e) => console.error("Build failed:", e.message));
-            break;
-          case "c":
-            process.stdout.write("\x1B[2J\x1B[H");
-            break;
-          case "l":
-            if (key.ctrl) process.stdout.write("\x1B[2J\x1B[H");
-            break;
-          default:
-            break;
+        if (chokidar) {
+          const watchPaths = [
+            path21.join(lynxProjectDir, "src"),
+            path21.join(lynxProjectDir, "lynx.config.ts"),
+            path21.join(lynxProjectDir, "lynx.config.js")
+          ].filter((p) => fs20.existsSync(p));
+          if (watchPaths.length > 0) {
+            const w = chokidar.watch(watchPaths, { ignoreInitial: true });
+            w.on("change", async () => {
+              try {
+                await rebuildRef.current();
+              } catch {
+              }
+            });
+            watcher = {
+              close: async () => {
+                await w.close();
+              }
+            };
+          }
         }
-      });
+        await doBuild();
+        if (!alive) return;
+        await new Promise((listenResolve, listenReject) => {
+          httpSrv.listen(port, "0.0.0.0", () => {
+            listenResolve();
+          });
+          httpSrv.once("error", (err) => listenReject(err));
+        });
+        if (!alive) return;
+        void import("dnssd-advertise").then(({ advertise }) => {
+          stopBonjour = advertise({
+            name: projectName,
+            type: "tamer",
+            protocol: "tcp",
+            port,
+            txt: {
+              name: projectName.slice(0, 255),
+              path: basePath.slice(0, 255)
+            }
+          });
+          setUi((s) => ({ ...s, bonjour: true }));
+        }).catch(() => {
+        });
+        const lanIp = getLanIp();
+        const devUrl = `http://${lanIp}:${port}${basePath}`;
+        const wsUrl = `ws://${lanIp}:${port}${basePath}/__hmr`;
+        setUi((s) => ({
+          ...s,
+          phase: "running",
+          port,
+          lanIp,
+          devUrl,
+          wsUrl
+        }));
+        void import("qrcode-terminal").then((mod) => {
+          const qrcode = mod.default ?? mod;
+          qrcode.generate(devUrl, { small: true }, (qr) => {
+            if (!alive) return;
+            setUi((s) => ({ ...s, qrLines: qr.split("\n").filter(Boolean) }));
+          });
+        }).catch(() => {
+        });
+        cleanupRef.current = async () => {
+          buildProcess?.kill();
+          await watcher?.close().catch(() => {
+          });
+          await stopBonjour?.();
+          httpSrv.close();
+          wssInst.close();
+        };
+      } catch (e) {
+        if (!alive) return;
+        setUi((s) => ({
+          ...s,
+          phase: "failed",
+          startError: e.message
+        }));
+      }
+    };
+    void run();
+    return () => {
+      alive = false;
+      void cleanupRef.current?.();
+    };
+  }, [appendLog, verbose]);
+  return /* @__PURE__ */ jsx10(
+    ServerDashboard,
+    {
+      projectName: ui.projectName,
+      port: ui.port,
+      lanIp: ui.lanIp,
+      devUrl: ui.devUrl,
+      wsUrl: ui.wsUrl,
+      lynxBundleFile: ui.lynxBundleFile,
+      bonjour: ui.bonjour,
+      verbose: ui.verbose,
+      buildPhase: ui.buildPhase,
+      buildError: ui.buildError,
+      wsConnections: ui.wsConnections,
+      logLines: ui.logLines,
+      showLogs: ui.showLogs,
+      qrLines: ui.qrLines,
+      phase: ui.phase,
+      startError: ui.startError
     }
+  );
+}
+async function startDevServer(opts) {
+  const verbose = opts?.verbose ?? false;
+  const { waitUntilExit } = render2(/* @__PURE__ */ jsx10(DevServerApp, { verbose }), {
+    exitOnCtrlC: false,
+    patchConsole: false
   });
-  const cleanup = async () => {
-    buildProcess?.kill();
-    await stopBonjour?.();
-    httpServer.close();
-    wss.close();
-    process.exit(0);
-  };
-  process.on("SIGINT", () => {
-    void cleanup();
-  });
-  process.on("SIGTERM", () => {
-    void cleanup();
-  });
-  await new Promise(() => {
-  });
+  await waitUntilExit();
 }
 var devServer_default = startDevServer;
 
@@ -5659,7 +6189,10 @@ ${podDeps.map((d) => `pod '${d.podName}', :path => '${d.absPath}'`).join("\n")}
 // src/common/add.ts
 import fs23 from "fs";
 import path24 from "path";
-import { execSync as execSync10 } from "child_process";
+import { execFile, execSync as execSync10 } from "child_process";
+import { promisify } from "util";
+import semver from "semver";
+var execFileAsync = promisify(execFile);
 var CORE_PACKAGES = [
   "@tamer4lynx/tamer-app-shell",
   "@tamer4lynx/tamer-screen",
@@ -5669,8 +6202,49 @@ var CORE_PACKAGES = [
   "@tamer4lynx/tamer-system-ui",
   "@tamer4lynx/tamer-icons"
 ];
+var DEV_STACK_PACKAGES = [
+  "@tamer4lynx/jiggle",
+  "@tamer4lynx/tamer-app-shell",
+  "@tamer4lynx/tamer-biometric",
+  "@tamer4lynx/tamer-dev-app",
+  "@tamer4lynx/tamer-dev-client",
+  "@tamer4lynx/tamer-display-browser",
+  "@tamer4lynx/tamer-icons",
+  "@tamer4lynx/tamer-insets",
+  "@tamer4lynx/tamer-linking",
+  "@tamer4lynx/tamer-plugin",
+  "@tamer4lynx/tamer-router",
+  "@tamer4lynx/tamer-screen",
+  "@tamer4lynx/tamer-secure-store",
+  "@tamer4lynx/tamer-system-ui",
+  "@tamer4lynx/tamer-transports"
+];
 var PACKAGE_ALIASES = {};
-function detectPackageManager(cwd) {
+async function getHighestPublishedVersion(fullName) {
+  try {
+    const { stdout } = await execFileAsync("npm", ["view", fullName, "versions", "--json"], {
+      maxBuffer: 10 * 1024 * 1024
+    });
+    const parsed = JSON.parse(stdout.trim());
+    const list = Array.isArray(parsed) ? parsed : [parsed];
+    const valid = list.filter((v) => typeof v === "string" && !!semver.valid(v));
+    if (valid.length === 0) return null;
+    return semver.rsort(valid)[0] ?? null;
+  } catch {
+    return null;
+  }
+}
+async function normalizeTamerInstallSpec(pkg) {
+  if (!pkg.startsWith("@tamer4lynx/")) return pkg;
+  if (/^@[^/]+\/[^@]+@/.test(pkg)) return pkg;
+  const highest = await getHighestPublishedVersion(pkg);
+  if (highest) {
+    return `${pkg}@${highest}`;
+  }
+  console.warn(`\u26A0\uFE0F  Could not resolve published versions for ${pkg}; using @prerelease`);
+  return `${pkg}@prerelease`;
+}
+function detectPackageManager2(cwd) {
   const dir = path24.resolve(cwd);
   if (fs23.existsSync(path24.join(dir, "pnpm-lock.yaml"))) return "pnpm";
   if (fs23.existsSync(path24.join(dir, "bun.lockb"))) return "bun";
@@ -5681,14 +6255,25 @@ function runInstall(cwd, packages, pm) {
   const cmd = pm === "npm" ? "npm" : pm === "pnpm" ? "pnpm" : "bun";
   execSync10(`${cmd} ${args.join(" ")}`, { stdio: "inherit", cwd });
 }
-function addCore() {
+async function addCore() {
   const { lynxProjectDir } = resolveHostPaths();
-  const pm = detectPackageManager(lynxProjectDir);
-  console.log(`Adding core packages to ${lynxProjectDir} (using ${pm})...`);
-  runInstall(lynxProjectDir, CORE_PACKAGES, pm);
+  const pm = detectPackageManager2(lynxProjectDir);
+  console.log(`Resolving latest published versions (npm)\u2026`);
+  const resolved = await Promise.all(CORE_PACKAGES.map(normalizeTamerInstallSpec));
+  console.log(`Adding core packages to ${lynxProjectDir} (using ${pm})\u2026`);
+  runInstall(lynxProjectDir, resolved, pm);
   console.log("\u2705 Core packages installed. Run `t4l link` to link native modules.");
 }
-function add(packages = []) {
+async function addDev() {
+  const { lynxProjectDir } = resolveHostPaths();
+  const pm = detectPackageManager2(lynxProjectDir);
+  console.log(`Resolving latest published versions (npm)\u2026`);
+  const resolved = await Promise.all([...DEV_STACK_PACKAGES].map(normalizeTamerInstallSpec));
+  console.log(`Adding dev stack (${DEV_STACK_PACKAGES.length} @tamer4lynx packages) to ${lynxProjectDir} (using ${pm})\u2026`);
+  runInstall(lynxProjectDir, resolved, pm);
+  console.log("\u2705 Dev stack installed. Run `t4l link` to link native modules.");
+}
+async function add(packages = []) {
   const list = Array.isArray(packages) ? packages : [];
   if (list.length === 0) {
     console.log("Usage: t4l add <package> [package...]");
@@ -5698,28 +6283,695 @@ function add(packages = []) {
     return;
   }
   const { lynxProjectDir } = resolveHostPaths();
-  const pm = detectPackageManager(lynxProjectDir);
-  const normalized = list.map((p) => {
-    if (p.startsWith("@")) return p;
-    return PACKAGE_ALIASES[p] ?? `@tamer4lynx/${p}`;
-  });
-  console.log(`Adding ${normalized.join(", ")} to ${lynxProjectDir} (using ${pm})...`);
+  const pm = detectPackageManager2(lynxProjectDir);
+  console.log(`Resolving latest published versions (npm)\u2026`);
+  const normalized = await Promise.all(
+    list.map(async (p) => {
+      const spec = p.startsWith("@") ? p : PACKAGE_ALIASES[p] ?? `@tamer4lynx/${p}`;
+      return normalizeTamerInstallSpec(spec);
+    })
+  );
+  console.log(`Adding ${normalized.join(", ")} to ${lynxProjectDir} (using ${pm})\u2026`);
   runInstall(lynxProjectDir, normalized, pm);
   console.log("\u2705 Packages installed. Run `t4l link` to link native modules.");
 }
 
+// src/common/signing.tsx
+import { useState as useState6, useEffect as useEffect4, useRef as useRef2 } from "react";
+import { render as render3, Text as Text10, Box as Box9 } from "ink";
+import fs26 from "fs";
+import path27 from "path";
+
+// src/common/androidKeystore.ts
+import { execFileSync } from "child_process";
+import fs24 from "fs";
+import path25 from "path";
+function normalizeJavaHome(raw) {
+  if (!raw) return void 0;
+  const t = raw.trim().replace(/^["']|["']$/g, "");
+  return t || void 0;
+}
+function discoverJavaHomeMacOs() {
+  if (process.platform !== "darwin") return void 0;
+  try {
+    const out = execFileSync("/usr/libexec/java_home", [], {
+      encoding: "utf8",
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim().split("\n")[0]?.trim();
+    if (out && fs24.existsSync(path25.join(out, "bin", "keytool"))) return out;
+  } catch {
+  }
+  return void 0;
+}
+function resolveKeytoolPath() {
+  const jh = normalizeJavaHome(process.env.JAVA_HOME);
+  const win = process.platform === "win32";
+  const keytoolName = win ? "keytool.exe" : "keytool";
+  if (jh) {
+    const p = path25.join(jh, "bin", keytoolName);
+    if (fs24.existsSync(p)) return p;
+  }
+  const mac = discoverJavaHomeMacOs();
+  if (mac) {
+    const p = path25.join(mac, "bin", keytoolName);
+    if (fs24.existsSync(p)) return p;
+  }
+  return "keytool";
+}
+function keytoolAvailable() {
+  const tryRun = (cmd) => {
+    try {
+      execFileSync(cmd, ["-help"], { stdio: "pipe" });
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  if (tryRun("keytool")) return true;
+  const fromJavaHome = resolveKeytoolPath();
+  if (fromJavaHome !== "keytool" && fs24.existsSync(fromJavaHome)) {
+    return tryRun(fromJavaHome);
+  }
+  return false;
+}
+function generateReleaseKeystore(opts) {
+  const keytool = resolveKeytoolPath();
+  const dir = path25.dirname(opts.keystoreAbsPath);
+  fs24.mkdirSync(dir, { recursive: true });
+  if (fs24.existsSync(opts.keystoreAbsPath)) {
+    throw new Error(`Keystore already exists: ${opts.keystoreAbsPath}`);
+  }
+  if (!opts.storePassword || !opts.keyPassword) {
+    throw new Error(
+      "JDK keytool requires a keystore and key password of at least 6 characters for -genkeypair. Enter a password or use an existing keystore."
+    );
+  }
+  const args = [
+    "-genkeypair",
+    "-v",
+    "-keystore",
+    opts.keystoreAbsPath,
+    "-alias",
+    opts.alias,
+    "-keyalg",
+    "RSA",
+    "-keysize",
+    "2048",
+    "-validity",
+    "10000",
+    "-storepass",
+    opts.storePassword,
+    "-keypass",
+    opts.keyPassword,
+    "-dname",
+    opts.dname
+  ];
+  try {
+    execFileSync(keytool, args, { stdio: ["pipe", "pipe", "pipe"] });
+  } catch (e) {
+    const err = e;
+    const fromKeytool = [err.stdout, err.stderr].filter(Boolean).map((b) => Buffer.from(b).toString("utf8")).join("\n").trim();
+    throw new Error(fromKeytool || err.message || "keytool failed");
+  }
+}
+
+// src/common/appendEnvFile.ts
+import fs25 from "fs";
+import path26 from "path";
+import { parse } from "dotenv";
+function keysDefinedInFile(filePath) {
+  if (!fs25.existsSync(filePath)) return /* @__PURE__ */ new Set();
+  try {
+    return new Set(Object.keys(parse(fs25.readFileSync(filePath, "utf8"))));
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+}
+function formatEnvLine(key, value) {
+  if (/[\r\n]/.test(value) || /^\s|\s$/.test(value) || /[#"'\\=]/.test(value)) {
+    const escaped = value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    return `${key}="${escaped}"`;
+  }
+  return `${key}=${value}`;
+}
+function appendEnvVarsIfMissing(projectRoot, vars) {
+  const entries = Object.entries(vars).filter(([, v]) => v !== void 0 && v !== "");
+  if (entries.length === 0) return null;
+  const envLocal = path26.join(projectRoot, ".env.local");
+  const envDefault = path26.join(projectRoot, ".env");
+  let target;
+  if (fs25.existsSync(envLocal)) target = envLocal;
+  else if (fs25.existsSync(envDefault)) target = envDefault;
+  else target = envLocal;
+  const existing = keysDefinedInFile(target);
+  const lines = [];
+  const appendedKeys = [];
+  for (const [k, v] of entries) {
+    if (existing.has(k)) continue;
+    lines.push(formatEnvLine(k, v));
+    appendedKeys.push(k);
+  }
+  if (lines.length === 0) {
+    return {
+      file: path26.basename(target),
+      keys: [],
+      skippedAll: entries.length > 0
+    };
+  }
+  let prefix = "";
+  if (fs25.existsSync(target)) {
+    const cur = fs25.readFileSync(target, "utf8");
+    prefix = cur.length === 0 ? "" : cur.endsWith("\n") ? cur : `${cur}
+`;
+  }
+  const block = lines.join("\n") + "\n";
+  fs25.writeFileSync(target, prefix + block, "utf8");
+  return { file: path26.basename(target), keys: appendedKeys };
+}
+
+// src/common/signing.tsx
+import { Fragment, jsx as jsx11, jsxs as jsxs10 } from "react/jsx-runtime";
+function AndroidKeystoreModeSelect({
+  onSelect
+}) {
+  const canGen = keytoolAvailable();
+  const items = canGen ? [
+    { label: "Generate a new release keystore (JDK keytool)", value: "generate" },
+    { label: "Use an existing keystore file", value: "existing" }
+  ] : [
+    {
+      label: "Use an existing keystore file (install a JDK for keytool to generate)",
+      value: "existing"
+    }
+  ];
+  return /* @__PURE__ */ jsxs10(Box9, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx11(
+      TuiSelectInput,
+      {
+        label: "Android release keystore:",
+        items,
+        onSelect
+      }
+    ),
+    !canGen && /* @__PURE__ */ jsx11(Text10, { dimColor: true, children: "keytool not found on PATH / JAVA_HOME. Install a JDK or set JAVA_HOME, then run signing again to generate." })
+  ] });
+}
+function firstStepForPlatform(p) {
+  if (p === "ios") return "ios-team";
+  if (p === "android" || p === "both") return "android-keystore-mode";
+  return "platform";
+}
+function SigningWizard({ platform: initialPlatform }) {
+  const [state, setState] = useState6({
+    platform: initialPlatform || null,
+    android: {
+      keystoreFile: "",
+      keyAlias: "release",
+      storePasswordEnv: "ANDROID_KEYSTORE_PASSWORD",
+      keyPasswordEnv: "ANDROID_KEY_PASSWORD",
+      keystoreMode: null,
+      genKeystorePath: "android/release.keystore",
+      genPassword: ""
+    },
+    ios: {
+      developmentTeam: "",
+      codeSignIdentity: "",
+      provisioningProfileSpecifier: ""
+    },
+    step: initialPlatform ? firstStepForPlatform(initialPlatform) : "platform",
+    generateError: null,
+    androidEnvAppend: null
+  });
+  const nextStep = () => {
+    setState((s) => {
+      if (s.step === "android-gen-path") {
+        return { ...s, step: "android-gen-alias" };
+      }
+      if (s.step === "android-gen-alias") {
+        return { ...s, step: "android-gen-password" };
+      }
+      if (s.step === "android-keystore") {
+        return { ...s, step: "android-alias" };
+      }
+      if (s.step === "android-alias") {
+        return { ...s, step: "android-password-env" };
+      }
+      if (s.step === "android-password-env") {
+        return { ...s, step: "android-key-password-env" };
+      }
+      if (s.step === "android-key-password-env") {
+        if (s.platform === "both") {
+          return { ...s, step: "ios-team" };
+        }
+        return { ...s, step: "saving" };
+      }
+      if (s.step === "ios-team") {
+        return { ...s, step: "ios-identity" };
+      }
+      if (s.step === "ios-identity") {
+        return { ...s, step: "ios-profile" };
+      }
+      if (s.step === "ios-profile") {
+        return { ...s, step: "saving" };
+      }
+      return s;
+    });
+  };
+  useEffect4(() => {
+    if (state.step === "saving") {
+      saveConfig();
+    }
+  }, [state.step]);
+  const generateRunId = useRef2(0);
+  useEffect4(() => {
+    if (state.step !== "android-generating") return;
+    const runId = ++generateRunId.current;
+    let cancelled = false;
+    const run = () => {
+      let abs = "";
+      try {
+        const resolved = resolveHostPaths();
+        const rel = state.android.genKeystorePath.trim() || "android/release.keystore";
+        abs = path27.isAbsolute(rel) ? rel : path27.join(resolved.projectRoot, rel);
+        const alias = state.android.keyAlias.trim() || "release";
+        const pw = state.android.genPassword;
+        const pkg = resolved.config.android?.packageName ?? "com.example.app";
+        const safeOU = pkg.replace(/[,=+]/g, "_");
+        const dname = `CN=Android Release, OU=${safeOU}, O=Android, C=US`;
+        generateReleaseKeystore({
+          keystoreAbsPath: abs,
+          alias,
+          storePassword: pw,
+          keyPassword: pw,
+          dname
+        });
+        if (cancelled || runId !== generateRunId.current) return;
+        setState((s) => ({
+          ...s,
+          android: {
+            ...s.android,
+            keystoreFile: rel,
+            keyAlias: alias,
+            keystoreMode: "generate"
+          },
+          step: "android-password-env",
+          generateError: null
+        }));
+      } catch (e) {
+        const msg = e.message;
+        if (abs && fs26.existsSync(abs) && (msg.includes("already exists") || msg.includes("Keystore already exists"))) {
+          if (cancelled || runId !== generateRunId.current) return;
+          const rel = state.android.genKeystorePath.trim() || "android/release.keystore";
+          const alias = state.android.keyAlias.trim() || "release";
+          setState((s) => ({
+            ...s,
+            android: {
+              ...s.android,
+              keystoreFile: rel,
+              keyAlias: alias,
+              keystoreMode: "generate"
+            },
+            step: "android-password-env",
+            generateError: null
+          }));
+          return;
+        }
+        if (cancelled || runId !== generateRunId.current) return;
+        setState((s) => ({
+          ...s,
+          step: "android-gen-password",
+          generateError: msg
+        }));
+      }
+    };
+    run();
+    return () => {
+      cancelled = true;
+    };
+  }, [state.step, state.android.genKeystorePath, state.android.keyAlias, state.android.genPassword]);
+  useEffect4(() => {
+    if (state.step === "done") {
+      setTimeout(() => {
+        process.exit(0);
+      }, 3e3);
+    }
+  }, [state.step]);
+  const saveConfig = async () => {
+    try {
+      const resolved = resolveHostPaths();
+      const configPath = path27.join(resolved.projectRoot, "tamer.config.json");
+      let config = {};
+      let androidEnvAppend = null;
+      if (fs26.existsSync(configPath)) {
+        config = JSON.parse(fs26.readFileSync(configPath, "utf8"));
+      }
+      if (state.platform === "android" || state.platform === "both") {
+        config.android = config.android || {};
+        config.android.signing = {
+          keystoreFile: state.android.keystoreFile,
+          keyAlias: state.android.keyAlias,
+          storePasswordEnv: state.android.storePasswordEnv,
+          keyPasswordEnv: state.android.keyPasswordEnv
+        };
+        if (state.android.keystoreMode === "generate" && state.android.genPassword) {
+          const storeEnv = state.android.storePasswordEnv.trim() || "ANDROID_KEYSTORE_PASSWORD";
+          const keyEnv = state.android.keyPasswordEnv.trim() || "ANDROID_KEY_PASSWORD";
+          androidEnvAppend = appendEnvVarsIfMissing(resolved.projectRoot, {
+            [storeEnv]: state.android.genPassword,
+            [keyEnv]: state.android.genPassword
+          });
+        }
+      }
+      if (state.platform === "ios" || state.platform === "both") {
+        config.ios = config.ios || {};
+        config.ios.signing = {
+          developmentTeam: state.ios.developmentTeam,
+          ...state.ios.codeSignIdentity && { codeSignIdentity: state.ios.codeSignIdentity },
+          ...state.ios.provisioningProfileSpecifier && { provisioningProfileSpecifier: state.ios.provisioningProfileSpecifier }
+        };
+      }
+      fs26.writeFileSync(configPath, JSON.stringify(config, null, 2));
+      const gitignorePath = path27.join(resolved.projectRoot, ".gitignore");
+      if (fs26.existsSync(gitignorePath)) {
+        let gitignore = fs26.readFileSync(gitignorePath, "utf8");
+        const additions = [
+          ".env.local",
+          "*.jks",
+          "*.keystore"
+        ];
+        for (const addition of additions) {
+          if (!gitignore.includes(addition)) {
+            gitignore += `
+${addition}
+`;
+          }
+        }
+        fs26.writeFileSync(gitignorePath, gitignore);
+      }
+      setState((s) => ({
+        ...s,
+        step: "done",
+        androidEnvAppend: state.platform === "android" || state.platform === "both" ? androidEnvAppend : null
+      }));
+    } catch (error) {
+      console.error("Error saving config:", error);
+      process.exit(1);
+    }
+  };
+  if (state.step === "done") {
+    return /* @__PURE__ */ jsxs10(Box9, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx11(Text10, { color: "green", children: "\u2705 Signing configuration saved to tamer.config.json" }),
+      (state.platform === "android" || state.platform === "both") && /* @__PURE__ */ jsxs10(Box9, { flexDirection: "column", marginTop: 1, children: [
+        /* @__PURE__ */ jsx11(Text10, { children: "Android signing configured:" }),
+        /* @__PURE__ */ jsxs10(Text10, { dimColor: true, children: [
+          "  Keystore: ",
+          state.android.keystoreFile
+        ] }),
+        /* @__PURE__ */ jsxs10(Text10, { dimColor: true, children: [
+          "  Alias: ",
+          state.android.keyAlias
+        ] }),
+        state.androidEnvAppend?.keys.length ? /* @__PURE__ */ jsxs10(Text10, { children: [
+          "Appended ",
+          state.androidEnvAppend.keys.join(", "),
+          " to ",
+          state.androidEnvAppend.file,
+          " (existing keys left unchanged)."
+        ] }) : state.androidEnvAppend?.skippedAll ? /* @__PURE__ */ jsxs10(Text10, { dimColor: true, children: [
+          state.androidEnvAppend.file,
+          " already defines the signing env vars; left unchanged."
+        ] }) : /* @__PURE__ */ jsxs10(Fragment, { children: [
+          /* @__PURE__ */ jsx11(Text10, { children: "Set environment variables (or add them to .env / .env.local):" }),
+          /* @__PURE__ */ jsxs10(Text10, { dimColor: true, children: [
+            "  export ",
+            state.android.storePasswordEnv,
+            '="your-keystore-password"'
+          ] }),
+          /* @__PURE__ */ jsxs10(Text10, { dimColor: true, children: [
+            "  export ",
+            state.android.keyPasswordEnv,
+            '="your-key-password"'
+          ] })
+        ] })
+      ] }),
+      (state.platform === "ios" || state.platform === "both") && /* @__PURE__ */ jsxs10(Box9, { flexDirection: "column", marginTop: 1, children: [
+        /* @__PURE__ */ jsx11(Text10, { children: "iOS signing configured:" }),
+        /* @__PURE__ */ jsxs10(Text10, { dimColor: true, children: [
+          "  Team ID: ",
+          state.ios.developmentTeam
+        ] }),
+        state.ios.codeSignIdentity && /* @__PURE__ */ jsxs10(Text10, { dimColor: true, children: [
+          "  Identity: ",
+          state.ios.codeSignIdentity
+        ] })
+      ] }),
+      /* @__PURE__ */ jsxs10(Box9, { flexDirection: "column", marginTop: 1, children: [
+        state.platform === "android" && /* @__PURE__ */ jsxs10(Fragment, { children: [
+          /* @__PURE__ */ jsx11(Text10, { children: "Run `t4l build android -p` to build this platform with signing." }),
+          /* @__PURE__ */ jsx11(Text10, { dimColor: true, children: "`t4l build -p` (no platform) builds both Android and iOS." })
+        ] }),
+        state.platform === "ios" && /* @__PURE__ */ jsxs10(Fragment, { children: [
+          /* @__PURE__ */ jsx11(Text10, { children: "Run `t4l build ios -p` to build this platform with signing." }),
+          /* @__PURE__ */ jsx11(Text10, { dimColor: true, children: "`t4l build -p` (no platform) builds both Android and iOS." })
+        ] }),
+        state.platform === "both" && /* @__PURE__ */ jsxs10(Fragment, { children: [
+          /* @__PURE__ */ jsx11(Text10, { children: "Run `t4l build -p` to build both platforms with signing." }),
+          /* @__PURE__ */ jsx11(Text10, { dimColor: true, children: "Or: `t4l build android -p` / `t4l build ios -p` for one platform." })
+        ] })
+      ] })
+    ] });
+  }
+  if (state.step === "saving") {
+    return /* @__PURE__ */ jsx11(Box9, { children: /* @__PURE__ */ jsx11(TuiSpinner, { label: "Saving configuration..." }) });
+  }
+  if (state.step === "android-generating") {
+    return /* @__PURE__ */ jsx11(Box9, { flexDirection: "column", children: /* @__PURE__ */ jsx11(TuiSpinner, { label: "Running keytool to create release keystore..." }) });
+  }
+  return /* @__PURE__ */ jsxs10(Box9, { flexDirection: "column", children: [
+    state.step === "platform" && /* @__PURE__ */ jsx11(
+      TuiSelectInput,
+      {
+        label: "Select platform(s) to configure signing:",
+        items: [
+          { label: "Android", value: "android" },
+          { label: "iOS", value: "ios" },
+          { label: "Both", value: "both" }
+        ],
+        onSelect: (platform) => {
+          setState((s) => ({ ...s, platform, step: firstStepForPlatform(platform) }));
+        }
+      }
+    ),
+    state.step === "android-keystore-mode" && /* @__PURE__ */ jsx11(
+      AndroidKeystoreModeSelect,
+      {
+        onSelect: (mode) => {
+          setState((s) => ({
+            ...s,
+            android: { ...s.android, keystoreMode: mode },
+            step: mode === "generate" ? "android-gen-path" : "android-keystore",
+            generateError: null
+          }));
+        }
+      }
+    ),
+    state.step === "android-gen-path" && /* @__PURE__ */ jsx11(
+      TuiTextInput,
+      {
+        label: "Keystore output path (relative to project root):",
+        defaultValue: state.android.genKeystorePath,
+        onSubmitValue: (v) => {
+          const p = v.trim() || "android/release.keystore";
+          setState((s) => ({ ...s, android: { ...s.android, genKeystorePath: p } }));
+        },
+        onSubmit: nextStep,
+        hint: "Default: android/release.keystore (gitignored pattern *.keystore)"
+      }
+    ),
+    state.step === "android-gen-alias" && /* @__PURE__ */ jsx11(
+      TuiTextInput,
+      {
+        label: "Android key alias:",
+        defaultValue: state.android.keyAlias,
+        onSubmitValue: (v) => {
+          setState((s) => ({ ...s, android: { ...s.android, keyAlias: v } }));
+        },
+        onSubmit: nextStep
+      }
+    ),
+    state.step === "android-gen-password" && /* @__PURE__ */ jsxs10(Box9, { flexDirection: "column", children: [
+      state.generateError ? /* @__PURE__ */ jsx11(Text10, { color: "red", children: state.generateError }) : null,
+      /* @__PURE__ */ jsx11(
+        TuiTextInput,
+        {
+          label: "Keystore and key password (same for both; shown as you type):",
+          value: state.android.genPassword,
+          onChange: (v) => setState((s) => ({ ...s, android: { ...s.android, genPassword: v } })),
+          onSubmitValue: (pw) => {
+            setState((s) => ({
+              ...s,
+              android: { ...s.android, genPassword: pw.trim() },
+              step: "android-generating",
+              generateError: null
+            }));
+          },
+          onSubmit: () => {
+          },
+          hint: "At least 6 characters (JDK keytool). Same value used for -storepass and -keypass."
+        }
+      )
+    ] }),
+    state.step === "android-keystore" && /* @__PURE__ */ jsx11(
+      TuiTextInput,
+      {
+        label: "Android keystore file path (relative to project root or android/):",
+        defaultValue: state.android.keystoreFile,
+        onSubmitValue: (v) => {
+          setState((s) => ({ ...s, android: { ...s.android, keystoreFile: v } }));
+        },
+        onSubmit: nextStep,
+        hint: "Example: android/app/my-release-key.keystore or ./my-release-key.keystore"
+      }
+    ),
+    state.step === "android-alias" && /* @__PURE__ */ jsx11(
+      TuiTextInput,
+      {
+        label: "Android key alias:",
+        defaultValue: state.android.keyAlias,
+        onSubmitValue: (v) => {
+          setState((s) => ({ ...s, android: { ...s.android, keyAlias: v } }));
+        },
+        onSubmit: nextStep
+      }
+    ),
+    state.step === "android-password-env" && /* @__PURE__ */ jsx11(
+      TuiTextInput,
+      {
+        label: "Keystore password environment variable name:",
+        defaultValue: state.android.storePasswordEnv || "ANDROID_KEYSTORE_PASSWORD",
+        onSubmitValue: (v) => {
+          setState((s) => ({ ...s, android: { ...s.android, storePasswordEnv: v } }));
+        },
+        onSubmit: () => {
+          setState((s) => ({ ...s, step: "android-key-password-env" }));
+        },
+        hint: "Default: ANDROID_KEYSTORE_PASSWORD (will be written to .env / .env.local)"
+      }
+    ),
+    state.step === "android-key-password-env" && /* @__PURE__ */ jsx11(
+      TuiTextInput,
+      {
+        label: "Key password environment variable name:",
+        defaultValue: state.android.keyPasswordEnv || "ANDROID_KEY_PASSWORD",
+        onSubmitValue: (v) => {
+          setState((s) => ({ ...s, android: { ...s.android, keyPasswordEnv: v } }));
+        },
+        onSubmit: () => {
+          if (state.platform === "both") {
+            setState((s) => ({ ...s, step: "ios-team" }));
+          } else {
+            setState((s) => ({ ...s, step: "saving" }));
+          }
+        },
+        hint: "Default: ANDROID_KEY_PASSWORD (will be written to .env / .env.local)"
+      }
+    ),
+    state.step === "ios-team" && /* @__PURE__ */ jsx11(
+      TuiTextInput,
+      {
+        label: "iOS Development Team ID:",
+        defaultValue: state.ios.developmentTeam,
+        onSubmitValue: (v) => {
+          setState((s) => ({ ...s, ios: { ...s.ios, developmentTeam: v } }));
+        },
+        onSubmit: nextStep,
+        hint: "Example: ABC123DEF4 (found in Apple Developer account)"
+      }
+    ),
+    state.step === "ios-identity" && /* @__PURE__ */ jsx11(
+      TuiTextInput,
+      {
+        label: "iOS Code Sign Identity (optional, press Enter to skip):",
+        defaultValue: state.ios.codeSignIdentity,
+        onSubmitValue: (v) => {
+          setState((s) => ({ ...s, ios: { ...s.ios, codeSignIdentity: v } }));
+        },
+        onSubmit: () => {
+          setState((s) => ({ ...s, step: "ios-profile" }));
+        },
+        hint: 'Example: "iPhone Developer" or "Apple Development"'
+      }
+    ),
+    state.step === "ios-profile" && /* @__PURE__ */ jsx11(
+      TuiTextInput,
+      {
+        label: "iOS Provisioning Profile Specifier (optional, press Enter to skip):",
+        defaultValue: state.ios.provisioningProfileSpecifier,
+        onSubmitValue: (v) => {
+          setState((s) => ({ ...s, ios: { ...s.ios, provisioningProfileSpecifier: v } }));
+        },
+        onSubmit: () => {
+          setState((s) => ({ ...s, step: "saving" }));
+        },
+        hint: "UUID of the provisioning profile"
+      }
+    )
+  ] });
+}
+async function signing(platform) {
+  const { waitUntilExit } = render3(/* @__PURE__ */ jsx11(SigningWizard, { platform }));
+  await waitUntilExit();
+}
+
+// src/common/productionSigning.ts
+import fs27 from "fs";
+import path28 from "path";
+function isAndroidSigningConfigured(resolved) {
+  const signing2 = resolved.config.android?.signing;
+  const hasConfig = Boolean(signing2?.keystoreFile?.trim() && signing2?.keyAlias?.trim());
+  const signingProps = path28.join(resolved.androidDir, "signing.properties");
+  const hasProps = fs27.existsSync(signingProps);
+  return hasConfig || hasProps;
+}
+function isIosSigningConfigured(resolved) {
+  const team = resolved.config.ios?.signing?.developmentTeam?.trim();
+  return Boolean(team);
+}
+function assertProductionSigningReady(filter) {
+  const resolved = resolveHostPaths();
+  const needAndroid = filter === "android" || filter === "all";
+  const needIos = filter === "ios" || filter === "all";
+  const missing = [];
+  if (needAndroid && !isAndroidSigningConfigured(resolved)) {
+    missing.push("Android: run `t4l signing android`, then `t4l build android -p`.");
+  }
+  if (needIos && !isIosSigningConfigured(resolved)) {
+    missing.push("iOS: run `t4l signing ios`, then `t4l build ios -p`.");
+  }
+  if (missing.length === 0) return;
+  console.error("\n\u274C Production build (`-p`) needs signing configured for the platform(s) you are building.");
+  for (const line of missing) {
+    console.error(`   ${line}`);
+  }
+  console.error(
+    "\n   `t4l build -p` (no platform) builds both Android and iOS; use `t4l build android -p` or `t4l build ios -p` for one platform only.\n"
+  );
+  process.exit(1);
+}
+
 // index.ts
 function readCliVersion() {
-  const root = path25.dirname(fileURLToPath(import.meta.url));
-  const here = path25.join(root, "package.json");
-  const parent = path25.join(root, "..", "package.json");
-  const pkgPath = fs24.existsSync(here) ? here : parent;
-  return JSON.parse(fs24.readFileSync(pkgPath, "utf8")).version;
+  const root = path29.dirname(fileURLToPath(import.meta.url));
+  const here = path29.join(root, "package.json");
+  const parent = path29.join(root, "..", "package.json");
+  const pkgPath = fs28.existsSync(here) ? here : parent;
+  return JSON.parse(fs28.readFileSync(pkgPath, "utf8")).version;
 }
 var version = readCliVersion();
-function validateDebugRelease(debug, release) {
-  if (debug && release) {
-    console.error("Cannot use --debug and --release together.");
+function validateBuildMode(debug, release, production) {
+  const modes = [debug, release, production].filter(Boolean).length;
+  if (modes > 1) {
+    console.error("Cannot use --debug, --release, and --production together. Use only one.");
     process.exit(1);
   }
 }
@@ -5731,7 +6983,7 @@ function parsePlatform(value) {
 }
 program.version(version).description("Tamer4Lynx CLI - A tool for managing Lynx projects");
 program.command("init").description("Initialize tamer.config.json interactively").action(() => {
-  init_default();
+  init();
 });
 program.command("create <target>").description("Create a project or extension. Target: ios | android | module | element | service | combo").option("-d, --debug", "For android: create host project (default)").option("-r, --release", "For android: create dev-app project").action(async (target, opts) => {
   const t = target.toLowerCase();
@@ -5754,22 +7006,26 @@ program.command("create <target>").description("Create a project or extension. T
   console.error(`Invalid create target: ${target}. Use ios | android | module | element | service | combo`);
   process.exit(1);
 });
-program.command("build [platform]").description("Build app. Platform: ios | android (default: both)").option("-e, --embeddable", "Output embeddable bundle + code for existing apps. Use with --release.").option("-d, --debug", "Debug build with dev client embedded (default)").option("-r, --release", "Release build without dev client").option("-i, --install", "Install after building").action(async (platform, opts) => {
-  validateDebugRelease(opts.debug, opts.release);
-  const release = opts.release === true;
+program.command("build [platform]").description("Build app. Platform: ios | android (default: both)").option("-e, --embeddable", "Output embeddable bundle + code for existing apps. Use with --release.").option("-d, --debug", "Debug build with dev client embedded (default)").option("-r, --release", "Release build without dev client (unsigned)").option("-p, --production", "Production build for app store (signed)").option("-i, --install", "Install after building").action(async (platform, opts) => {
+  validateBuildMode(opts.debug, opts.release, opts.production);
+  const release = opts.release === true || opts.production === true;
+  const production = opts.production === true;
   if (opts.embeddable) {
     await buildEmbeddable({ release: true });
     return;
   }
   const p = parsePlatform(platform ?? "all") ?? "all";
+  if (production) {
+    assertProductionSigningReady(p);
+  }
   if (p === "android" || p === "all") {
-    await build_default({ install: opts.install, release });
+    await build_default({ install: opts.install, release, production });
   }
   if (p === "ios" || p === "all") {
-    await build_default2({ install: opts.install, release });
+    await build_default2({ install: opts.install, release, production });
   }
 });
-program.command("link [platform]").description("Link native modules. Platform: ios | android | both (default: both)").option("-s, --silent", "Run in silent mode (e.g. for postinstall)").action((platform, opts) => {
+program.command("link [platform]").description("Link native modules. Platform: ios | android | both (default: both)").option("-s, --silent", "Run without output").action((platform, opts) => {
   if (opts.silent) {
     console.log = () => {
     };
@@ -5790,14 +7046,15 @@ program.command("link [platform]").description("Link native modules. Platform: i
   autolink_default2();
   autolink_default();
 });
-program.command("bundle [platform]").description("Build Lynx bundle and copy to native project. Platform: ios | android (default: both)").option("-d, --debug", "Debug bundle with dev client embedded (default)").option("-r, --release", "Release bundle without dev client").action(async (platform, opts) => {
-  validateDebugRelease(opts.debug, opts.release);
-  const release = opts.release === true;
+program.command("bundle [platform]").description("Build Lynx bundle and copy to native project. Platform: ios | android (default: both)").option("-d, --debug", "Debug bundle with dev client embedded (default)").option("-r, --release", "Release bundle without dev client (unsigned)").option("-p, --production", "Production bundle for app store (signed)").action(async (platform, opts) => {
+  validateBuildMode(opts.debug, opts.release, opts.production);
+  const release = opts.release === true || opts.production === true;
+  const production = opts.production === true;
   const p = parsePlatform(platform ?? "both") ?? "both";
-  if (p === "android" || p === "all") await bundle_default({ release });
-  if (p === "ios" || p === "all") bundle_default2({ release });
+  if (p === "android" || p === "all") await bundle_default({ release, production });
+  if (p === "ios" || p === "all") bundle_default2({ release, production });
 });
-program.command("inject <platform>").description("Inject tamer-host templates into an existing project. Platform: ios | android").option("-f, --force", "Overwrite existing files").action(async (platform, opts) => {
+program.command("inject <platform>").description("Inject host templates into an existing project. Platform: ios | android").option("-f, --force", "Overwrite existing files").action(async (platform, opts) => {
   const p = platform?.toLowerCase();
   if (p === "ios") {
     await injectHostIos({ force: opts.force });
@@ -5810,7 +7067,7 @@ program.command("inject <platform>").description("Inject tamer-host templates in
   console.error(`Invalid inject platform: ${platform}. Use ios | android`);
   process.exit(1);
 });
-program.command("sync [platform]").description("Sync dev client files from tamer.config.json. Platform: android (default)").action(async (platform) => {
+program.command("sync [platform]").description("Sync dev client. Platform: android (default)").action(async (platform) => {
   const p = (platform ?? "android").toLowerCase();
   if (p !== "android") {
     console.error("sync only supports android.");
@@ -5831,12 +7088,27 @@ program.command("build-dev-app").option("-p, --platform <platform>", "Platform:
     await build_default2({ install: opts.install, release: false });
   }
 });
-program.command("add [packages...]").description("Add @tamer4lynx packages to the Lynx project. Future: will track versions for compatibility (Expo-style).").action((packages) => add(packages));
-program.command("add-core").description("Add core packages (app-shell, screen, router, insets, transports, system-ui, icons)").action(() => addCore());
+program.command("add [packages...]").description("Add @tamer4lynx packages to the Lynx project").action(async (packages) => {
+  await add(packages);
+});
+program.command("add-core").description("Add core packages").action(async () => {
+  await addCore();
+});
+program.command("add-dev").description("Add dev-app, dev-client, and their dependencies").action(async () => {
+  await addDev();
+});
+program.command("signing [platform]").description("Configure Android and iOS signing interactively").action(async (platform) => {
+  const p = platform?.toLowerCase();
+  if (p === "android" || p === "ios") {
+    await signing(p);
+  } else {
+    await signing();
+  }
+});
 program.command("codegen").description("Generate code from @lynxmodule declarations").action(() => {
   codegen_default();
 });
-program.command("android <subcommand>").description("(Legacy) Use: t4l <command> android. e.g. t4l create android").option("-d, --debug", "Create: host project. Bundle/build: debug with dev client.").option("-r, --release", "Create: dev-app project. Bundle/build: release without dev client.").option("-i, --install", "Install after build").option("-e, --embeddable", "Build embeddable").option("-f, --force", "Force (inject)").action(async (subcommand, opts) => {
+program.command("android <subcommand>").description("(Legacy) Use: t4l <command> android. e.g. t4l create android").option("-d, --debug", "Create: host project. Bundle/build: debug with dev client.").option("-r, --release", "Create: dev-app project. Bundle/build: release without dev client.").option("-p, --production", "Bundle/build: production for app store (signed)").option("-i, --install", "Install after build").option("-e, --embeddable", "Build embeddable").option("-f, --force", "Force (inject)").action(async (subcommand, opts) => {
   const sub = subcommand?.toLowerCase();
   if (sub === "create") {
     if (opts.debug && opts.release) {
@@ -5851,14 +7123,19 @@ program.command("android <subcommand>").description("(Legacy) Use: t4l <command>
     return;
   }
   if (sub === "bundle") {
-    validateDebugRelease(opts.debug, opts.release);
-    await bundle_default({ release: opts.release === true });
+    validateBuildMode(opts.debug, opts.release, opts.production);
+    const release = opts.release === true || opts.production === true;
+    await bundle_default({ release, production: opts.production === true });
     return;
   }
   if (sub === "build") {
-    validateDebugRelease(opts.debug, opts.release);
+    validateBuildMode(opts.debug, opts.release, opts.production);
+    const release = opts.release === true || opts.production === true;
     if (opts.embeddable) await buildEmbeddable({ release: true });
-    else await build_default({ install: opts.install, release: opts.release === true });
+    else {
+      if (opts.production === true) assertProductionSigningReady("android");
+      await build_default({ install: opts.install, release, production: opts.production === true });
+    }
     return;
   }
   if (sub === "sync") {
@@ -5872,7 +7149,7 @@ program.command("android <subcommand>").description("(Legacy) Use: t4l <command>
   console.error(`Unknown android subcommand: ${subcommand}. Use: create | link | bundle | build | sync | inject`);
   process.exit(1);
 });
-program.command("ios <subcommand>").description("(Legacy) Use: t4l <command> ios. e.g. t4l create ios").option("-d, --debug", "Debug (bundle/build)").option("-r, --release", "Release (bundle/build)").option("-i, --install", "Install after build").option("-e, --embeddable", "Build embeddable").option("-f, --force", "Force (inject)").action(async (subcommand, opts) => {
+program.command("ios <subcommand>").description("(Legacy) Use: t4l <command> ios. e.g. t4l create ios").option("-d, --debug", "Debug (bundle/build)").option("-r, --release", "Release (bundle/build)").option("-p, --production", "Production for app store (signed)").option("-i, --install", "Install after build").option("-e, --embeddable", "Build embeddable").option("-f, --force", "Force (inject)").action(async (subcommand, opts) => {
   const sub = subcommand?.toLowerCase();
   if (sub === "create") {
     create_default2();
@@ -5883,14 +7160,19 @@ program.command("ios <subcommand>").description("(Legacy) Use: t4l <command> ios
     return;
   }
   if (sub === "bundle") {
-    validateDebugRelease(opts.debug, opts.release);
-    bundle_default2({ release: opts.release === true });
+    validateBuildMode(opts.debug, opts.release, opts.production);
+    const release = opts.release === true || opts.production === true;
+    bundle_default2({ release, production: opts.production === true });
     return;
   }
   if (sub === "build") {
-    validateDebugRelease(opts.debug, opts.release);
+    validateBuildMode(opts.debug, opts.release, opts.production);
+    const release = opts.release === true || opts.production === true;
     if (opts.embeddable) await buildEmbeddable({ release: true });
-    else await build_default2({ install: opts.install, release: opts.release === true });
+    else {
+      if (opts.production === true) assertProductionSigningReady("ios");
+      await build_default2({ install: opts.install, release, production: opts.production === true });
+    }
     return;
   }
   if (sub === "inject") {
@@ -5901,10 +7183,10 @@ program.command("ios <subcommand>").description("(Legacy) Use: t4l <command> ios
   process.exit(1);
 });
 program.command("autolink-toggle").alias("autolink").description("Toggle autolink on/off in tamer.config.json (controls postinstall linking)").action(async () => {
-  const configPath = path25.join(process.cwd(), "tamer.config.json");
+  const configPath = path29.join(process.cwd(), "tamer.config.json");
   let config = {};
-  if (fs24.existsSync(configPath)) {
-    config = JSON.parse(fs24.readFileSync(configPath, "utf8"));
+  if (fs28.existsSync(configPath)) {
+    config = JSON.parse(fs28.readFileSync(configPath, "utf8"));
   }
   if (config.autolink) {
     delete config.autolink;
@@ -5913,11 +7195,11 @@ program.command("autolink-toggle").alias("autolink").description("Toggle autolin
     config.autolink = true;
     console.log("Autolink enabled in tamer.config.json");
   }
-  fs24.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  fs28.writeFileSync(configPath, JSON.stringify(config, null, 2));
   console.log(`Updated ${configPath}`);
 });
 if (process.argv.length <= 2 || process.argv.length === 3 && process.argv[2] === "init") {
-  Promise.resolve(init_default()).then(() => process.exit(0));
+  Promise.resolve(init()).then(() => process.exit(0));
 } else {
   program.parseAsync().then(() => process.exit(0)).catch(() => process.exit(1));
 }