@lynxship/cli 0.1.4 → 0.1.7

package/dist/ios-build.js

@@ -5,7 +5,8 @@ import { assert, sha256 } from "@lynxship/contracts";
 import { transitionBuild } from "@lynxship/build-orchestrator";
 import { loadR2, uploadR2Artifact } from "./r2.js";
 import { nativeArtifactName } from "./artifact-name.js";
-import { commandExists, packageManagerScriptCommand, runProcess, } from "./process-runner.js";
+import { commandExists, runProcess } from "./process-runner.js";
+import { buildLynxBundle } from "./bundle-build.js";
 export function hasIosHost(root, profile) {
     if (process.platform !== "darwin")
         return false;
@@ -23,8 +24,15 @@ export function hasIosHost(root, profile) {
 }
 function findProject(root, profile) {
     const configured = profile.ios?.workspace ?? profile.ios?.project;
-    if (configured)
-        return resolve(root, configured);
+    if (configured) {
+        const configuredPath = resolve(root, configured);
+        if (configuredPath.endsWith(".xcodeproj")) {
+            const workspace = configuredPath.replace(/\.xcodeproj$/, ".xcworkspace");
+            if (existsSync(workspace))
+                return workspace;
+        }
+        return configuredPath;
+    }
     for (const directory of ["ios", "macos"]) {
         try {
             const candidate = readdirSync(join(root, directory)).find((name) => name.endsWith(".xcworkspace") || name.endsWith(".xcodeproj"));
@@ -37,6 +45,19 @@ function findProject(root, profile) {
     }
     throw new Error("No Xcode workspace or project found under ios/ or macos/");
 }
+async function installCocoaPods(root, quiet, onEvent) {
+    const iosDirectory = join(root, "ios");
+    const podfile = join(iosDirectory, "Podfile");
+    if (!existsSync(podfile))
+        return;
+    assert(commandExists("pod"), "IOS_COCOAPODS_REQUIRED", "CocoaPods was not found. Install CocoaPods on macOS, then rerun the build.");
+    onEvent?.("Installing iOS CocoaPods dependencies…");
+    await runProcess("pod", ["install"], {
+        cwd: iosDirectory,
+        quiet,
+        onOutput: onEvent,
+    });
+}
 async function findIpa(directory) {
     const files = await readdir(directory, { withFileTypes: true });
     const ipa = files.find((file) => file.isFile() && file.name.endsWith(".ipa"));
@@ -50,6 +71,8 @@ export async function runRealIosBuild(job, options) {
     assert(commandExists("xcrun"), "IOS_XCRUN_REQUIRED", "xcrun was not found. Install Xcode command-line tools.");
     const project = findProject(options.root, options.profile);
     assert(existsSync(project), "IOS_PROJECT_REQUIRED", `Configured Xcode project was not found: ${project}`);
+    await installCocoaPods(options.root, options.quiet, options.onEvent);
+    const resolvedProject = findProject(options.root, options.profile);
     const ios = options.profile.ios ?? {};
     const scheme = ios.scheme;
     assert(scheme, "IOS_SCHEME_REQUIRED", "Configure build.<profile>.ios.scheme in lynxship.json");
@@ -57,7 +80,7 @@ export async function runRealIosBuild(job, options) {
     assert(exportOptions, "IOS_EXPORT_OPTIONS_REQUIRED", "Configure build.<profile>.ios.exportOptionsPlist for a signed IPA export");
     const exportOptionsPath = resolve(options.root, exportOptions);
     assert(existsSync(exportOptionsPath), "IOS_EXPORT_OPTIONS_REQUIRED", `Export options file was not found: ${exportOptionsPath}`);
-    const projectFlag = project.endsWith(".xcworkspace")
+    const projectFlag = resolvedProject.endsWith(".xcworkspace")
         ? "-workspace"
         : "-project";
     const configuration = ios.configuration ?? "Release";
@@ -74,13 +97,16 @@ export async function runRealIosBuild(job, options) {
             await loadR2(options.root);
         await mkdir(archiveDirectory, { recursive: true });
         transitionBuild(job, "uploading_source", "iOS source prepared");
-        step("Building Lynx bundle with Rspeedy…", 5);
-        const packageManager = packageManagerScriptCommand(options.root, "build");
-        await runProcess(packageManager.command, packageManager.args, {
-            cwd: options.root,
-            quiet: options.quiet,
-            onOutput: options.onEvent,
-        });
+        if (options.skipBundleBuild) {
+            step("Using shared Lynx bundle", 5);
+        }
+        else {
+            step("Building Lynx bundle with Rspeedy…", 5);
+            await buildLynxBundle(options.root, {
+                quiet: options.quiet,
+                onOutput: options.onEvent,
+            });
+        }
         if (ios.bundleScript) {
             step("Syncing bundle into the iOS host…", 8);
             await runProcess(process.execPath, [resolve(options.root, ios.bundleScript)], {
@@ -92,7 +118,7 @@ export async function runRealIosBuild(job, options) {
         step("Preparing Xcode archive…", 10);
         await runProcess("xcodebuild", [
             projectFlag,
-            project,
+            resolvedProject,
             "-scheme",
             scheme,
             "-configuration",

package/dist/ios-host.d.ts

@@ -0,0 +1,17 @@
+export interface IosHostOptions {
+    bundleIdentifier: string;
+    appName: string;
+}
+export interface IosHostResult {
+    directory: string;
+    targetName: string;
+    bundleIdentifier: string;
+    project: string;
+    scheme: string;
+    exportOptionsPlist: string;
+    bundleScript: string;
+    configUpdated: boolean;
+}
+export declare function initializeIosHost(root: string, options: IosHostOptions): Promise<IosHostResult>;
+export declare function suggestedIosBundleIdentifier(root: string): string;
+//# sourceMappingURL=ios-host.d.ts.map

package/dist/ios-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios-host.d.ts","sourceRoot":"","sources":["../src/ios-host.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB;AAoED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CA0CxB;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjE"}

package/dist/ios-host.js

@@ -0,0 +1,93 @@
+import { access, cp, readdir, readFile, rename, writeFile, } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { basename, join } from "node:path";
+import { assert } from "@lynxship/contracts";
+const templateRoot = fileURLToPath(new URL("../templates/ios-host/", import.meta.url));
+function validateBundleIdentifier(bundleIdentifier) {
+    assert(/^[a-zA-Z][a-zA-Z0-9-]*(\.[a-zA-Z][a-zA-Z0-9-]*)+$/.test(bundleIdentifier), "IOS_BUNDLE_IDENTIFIER_INVALID", "iOS bundle identifier must contain at least two dot-separated segments, for example com.example.myapp.");
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function targetName(value) {
+    const words = value.match(/[a-zA-Z0-9]+/g) ?? [];
+    const result = words
+        .map((word) => `${word[0]?.toUpperCase() ?? ""}${word.slice(1)}`)
+        .join("");
+    if (result && /^[A-Za-z]/.test(result))
+        return result;
+    return `LynxShip${result || "App"}`;
+}
+async function textFiles(directory) {
+    const entries = await readdir(directory, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const path = join(directory, entry.name);
+        if (entry.isDirectory())
+            files.push(...(await textFiles(path)));
+        else if ([".h", ".m", ".plist", ".pbxproj", ".swift", ".rb", ".mjs"].some((extension) => entry.name.endsWith(extension)) ||
+            entry.name === "Podfile")
+            files.push(path);
+    }
+    return files;
+}
+async function updateProjectConfig(root, result) {
+    const configPath = join(root, "lynxship.json");
+    if (!(await exists(configPath)))
+        return false;
+    const config = JSON.parse(await readFile(configPath, "utf8"));
+    config.build ??= {};
+    config.build.production ??= {};
+    config.build.production.ios = {
+        ...config.build.production.ios,
+        project: `ios/${result.targetName}.xcodeproj`,
+        scheme: result.scheme,
+        configuration: "Release",
+        exportOptionsPlist: "ios/ExportOptions.plist",
+        bundleScript: "ios/sync-bundle.mjs",
+    };
+    await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    return true;
+}
+export async function initializeIosHost(root, options) {
+    validateBundleIdentifier(options.bundleIdentifier);
+    const ios = join(root, "ios");
+    assert(!(await exists(ios)), "IOS_HOST_EXISTS", `The iOS host already exists at ${ios}. LynxShip will not overwrite it.`);
+    const scheme = targetName(options.appName);
+    await cp(templateRoot, ios, { recursive: true, force: false });
+    await rename(join(ios, "__IOS_TARGET_NAME__"), join(ios, scheme));
+    await rename(join(ios, "__IOS_TARGET_NAME__.xcodeproj"), join(ios, `${scheme}.xcodeproj`));
+    await rename(join(ios, scheme, "Hello-Lynx-Bridging-Header.h"), join(ios, scheme, `${scheme}-Bridging-Header.h`));
+    const files = await textFiles(ios);
+    for (const file of files) {
+        let content = await readFile(file, "utf8");
+        content = content
+            .replaceAll("test.Hello-Lynx", options.bundleIdentifier)
+            .replaceAll("Hello-Lynx", scheme);
+        await writeFile(file, content, "utf8");
+    }
+    const project = `ios/${scheme}.xcodeproj`;
+    const result = {
+        directory: ios,
+        targetName: scheme,
+        bundleIdentifier: options.bundleIdentifier,
+        project,
+        scheme,
+        exportOptionsPlist: "ios/ExportOptions.plist",
+        bundleScript: "ios/sync-bundle.mjs",
+    };
+    const configUpdated = await updateProjectConfig(root, result);
+    return { ...result, configUpdated };
+}
+export function suggestedIosBundleIdentifier(root) {
+    const project = basename(root)
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "");
+    return `com.example.${project || "lynxapp"}`;
+}

package/dist/ui/components.d.ts

@@ -18,6 +18,7 @@ export interface ProgressHandle {
     update(value?: number, label?: string): void;
     stop(): void;
 }
+export declare function formatEvent(message: string): string;
 export declare function createProgress(label: string, enabled: boolean): ProgressHandle;
 export interface SpinnerHandle {
     succeed(message: string): void;
@@ -32,5 +33,6 @@ export declare const pill: {
     error: (text: string) => string;
 };
 export declare function finalLine(message: string, success?: boolean): void;
+export declare function nextSteps(commands: string[], note?: string): void;
 export declare function downloadArtifact(url: string, expiresAt?: string, enabled?: boolean): void;
 //# sourceMappingURL=components.d.ts.map

package/dist/ui/components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/ui/components.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,eAAO,MAAM,GAAG;qBACG,MAAM,GAAG,IAAI;kBAGhB,MAAM,GAAG,IAAI;mBAGZ,MAAM,GAAG,IAAI;kBAGd,MAAM,GAAG,IAAI;mBAGZ,MAAM,GAAG,IAAI;CAG7B,CAAC;AAgBF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA6C9D;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,IAAI,IAAI,IAAI,CAAC;CACd;AA2FD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,cAAc,CA8DhB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CA2BlE;AAYD,eAAO,MAAM,IAAI;oBACC,MAAM;iBACT,MAAM;iBACN,MAAM;kBACL,MAAM;CACrB,CAAC;AAEF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,IAAI,CAE/D;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,UAAO,GACb,IAAI,CAQN"}
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/ui/components.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,eAAO,MAAM,GAAG;qBACG,MAAM,GAAG,IAAI;kBAGhB,MAAM,GAAG,IAAI;mBAGZ,MAAM,GAAG,IAAI;kBAGd,MAAM,GAAG,IAAI;mBAGZ,MAAM,GAAG,IAAI;CAG7B,CAAC;AAgBF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA6C9D;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,IAAI,IAAI,IAAI,CAAC;CACd;AA6CD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoBnD;AAyBD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,cAAc,CAkEhB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CA2BlE;AAYD,eAAO,MAAM,IAAI;oBACC,MAAM;iBACT,MAAM;iBACN,MAAM;kBACL,MAAM;CACrB,CAAC;AAEF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,IAAI,CAE/D;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAOjE;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,UAAO,GACb,IAAI,CAQN"}

package/dist/ui/components.js

@@ -10,13 +10,13 @@ export function sectionHeader(title) {
 }
 export const log = {
     success(message) {
-        console.log(`  ${c.teal("[OK]  ")} ${c.text(message)}`);
+        console.log(`  ${c.green("◆")} ${c.text(message)}`);
     },
     warn(message) {
-        console.log(`  ${c.yellow("[WARN]")} ${c.yellow(message)}`);
+        console.log(`  ${c.yellow("!")} ${c.yellow(message)}`);
     },
     error(message) {
-        console.error(`  ${c.red("[ERROR]")} ${c.red(message)}`);
+        console.error(`  ${c.red("x")} ${c.red(message)}`);
     },
     info(message) {
         console.log(`  ${c.muted(message)}`);
@@ -105,7 +105,7 @@ function eventTone(message) {
         return "step";
     return "output";
 }
-function formatEvent(message) {
+export function formatEvent(message) {
     const colors = {
         command: c.blue,
         step: c.teal,
@@ -115,17 +115,16 @@ function formatEvent(message) {
         output: c.text,
     };
     const tone = eventTone(message);
-    const tag = {
-        command: "[CMD]",
-        step: "[STEP]",
-        success: "[OK]",
-        warning: "[WARN]",
-        error: "[ERROR]",
-        output: "[LOG]",
-    }[tone];
     const normalized = message.trim().replace(/^\$\s*/, "");
-    const rail = supportsUnicode() ? "│" : "|";
-    return `  ${colors[tone](rail)} ${colors[tone](tag.padEnd(7))} ${colors[tone](normalized)}`;
+    const marker = {
+        command: supportsUnicode() ? "➜" : ">",
+        step: "-",
+        success: supportsUnicode() ? "◆" : "*",
+        warning: "!",
+        error: "x",
+        output: supportsUnicode() ? "│" : "|",
+    }[tone];
+    return `  ${colors[tone](marker)} ${colors[tone](normalized)}`;
 }
 const activeAnimations = new Set();
 let cleanupHooksInstalled = false;
@@ -162,6 +161,7 @@ export function createProgress(label, enabled) {
     let spinnerIndex = 0;
     let currentValue = 0;
     let hasMeasuredValue = false;
+    let previousTone;
     const formatPercent = (value) => `${value.toFixed(2).replace(/\.?0+$/, "")}%`;
     const bar = new cliProgress.SingleBar({
         format: `  {spinner} {stage} ${c.teal("{bar}")} ${c.muted("{percent}")}`,
@@ -191,9 +191,13 @@ export function createProgress(label, enabled) {
     const logEvent = (message) => {
         if (!bar.isActive)
             return;
+        const tone = eventTone(message);
         bar.stop();
+        if (tone === "output" && previousTone === "output")
+            console.log();
         console.log(formatEvent(message));
         bar.start(100, currentValue, payload(currentLabel));
+        previousTone = tone;
     };
     return {
         event: logEvent,
@@ -228,11 +232,11 @@ export function spin(text, enabled) {
     const untrack = trackAnimation(() => spinner.stop());
     return {
         succeed: (message) => {
-            spinner.succeed(`${c.teal("[OK]")} ${c.text(message)}`);
+            spinner.succeed(`${c.green("◆")} ${c.text(message)}`);
             untrack();
         },
         fail: (message) => {
-            spinner.fail(`${c.red("[ERROR]")} ${c.red(message)}`);
+            spinner.fail(`${c.red("x")} ${c.red(message)}`);
             untrack();
         },
         stop: () => {
@@ -255,6 +259,16 @@ export const pill = {
 export function finalLine(message, success = true) {
     console.log(`\n${success ? c.brand("◆") : c.red("◆")} ${c.text(message)}`);
 }
+export function nextSteps(commands, note) {
+    if (commands.length === 0)
+        return;
+    console.error(`\n${c.yellow("Next steps")}`);
+    commands.forEach((command, index) => {
+        console.error(`  ${c.muted(`${index + 1}.`)} ${c.teal(command)}`);
+    });
+    if (note)
+        console.error(`  ${c.muted(note)}`);
+}
 export function downloadArtifact(url, expiresAt, enabled = true) {
     if (!enabled)
         return;

package/dist/ui/index.d.ts

@@ -1,5 +1,6 @@
 import { type BoxRow, type ProgressHandle, type SpinnerHandle } from "./components.js";
 import { terminalOptions, type TerminalOptions } from "./terminal.js";
+import type { CliGuidance } from "../guidance.js";
 export declare class CliUi {
     readonly options: TerminalOptions;
     readonly interactive: boolean;
@@ -11,6 +12,7 @@ export declare class CliUi {
     info(message: string): void;
     debug(message: string): void;
     error(message: string): void;
+    nextSteps(guidance: CliGuidance): void;
     summary(title: string, rows: BoxRow[]): void;
     configurationStatus(rows: BoxRow[]): void;
     progress(label: string): ProgressHandle;
@@ -20,5 +22,5 @@ export declare class CliUi {
 }
 export declare function createCliUi(args: string[]): CliUi;
 export { terminalOptions };
-export type { BoxRow, TerminalOptions };
+export type { BoxRow, ProgressHandle, TerminalOptions };
 //# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAEL,eAAe,EACf,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AAEvB,qBAAa,KAAK;IAChB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;gBAElB,IAAI,EAAE,MAAM,EAAE;IAU1B,MAAM,IAAI,IAAI;IAId,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAI5C,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAKzC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc;IAIvC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAIpC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,IAAI;IAI3C,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;CAGxD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAEjD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAEL,eAAe,EACf,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,KAAK;IAChB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;gBAElB,IAAI,EAAE,MAAM,EAAE;IAU1B,MAAM,IAAI,IAAI;IAId,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAKtC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAI5C,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAKzC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc;IAIvC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAIpC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,IAAI;IAI3C,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;CAGxD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAEjD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC"}

package/dist/ui/index.js

@@ -1,4 +1,4 @@
-import { finalLine, log, sectionHeader, summaryBox, createProgress, spin, downloadArtifact, } from "./components.js";
+import { finalLine, log, sectionHeader, summaryBox, nextSteps, createProgress, spin, downloadArtifact, } from "./components.js";
 import { printBanner } from "./logo.js";
 import { setColors } from "./state.js";
 import { isInteractive, terminalOptions, } from "./terminal.js";
@@ -40,6 +40,11 @@ export class CliUi {
         if (!this.options.json)
             log.error(message);
     }
+    nextSteps(guidance) {
+        if (this.options.json || this.options.quiet)
+            return;
+        nextSteps(guidance.commands, guidance.note);
+    }
     summary(title, rows) {
         if (this.interactive)
             summaryBox(title, rows);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynxship/cli",
-  "version": "0.1.4",
+  "version": "0.1.7",
   "description": "Build, sign, store, submit and update LynxJS applications from the terminal.",
   "type": "module",
   "license": "MIT",
@@ -25,7 +25,8 @@
   ],
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "templates"
   ],
   "engines": {
     "node": ">=22.0.0"
@@ -68,10 +69,10 @@
     "ora": "8.2.0",
     "qrcode-terminal": "0.12.0",
     "@lynxship/build-orchestrator": "0.1.0",
-    "@lynxship/db": "0.1.0",
     "@lynxship/contracts": "0.1.0",
     "@lynxship/signing": "0.1.0",
-    "@lynxship/submit": "0.1.0"
+    "@lynxship/submit": "0.1.0",
+    "@lynxship/db": "0.1.0"
   },
   "devDependencies": {
     "@types/cli-progress": "3.11.6",

package/templates/android-host/app/build.gradle

@@ -0,0 +1,38 @@
+plugins {
+    id "com.android.application"
+}
+
+android {
+    namespace "__APPLICATION_ID__"
+    compileSdk 35
+
+    defaultConfig {
+        applicationId "__APPLICATION_ID__"
+        minSdk 24
+        targetSdk 35
+        versionCode 1
+        versionName "0.1.0"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+}
+
+dependencies {
+    implementation "org.lynxsdk.lynx:lynx:4.0.0"
+    implementation "org.lynxsdk.lynx:lynx-jssdk:4.0.0"
+    implementation "org.lynxsdk.lynx:lynx-trace:4.0.0"
+    implementation "org.lynxsdk.lynx:primjs:4.0.0"
+    implementation "org.lynxsdk.lynx:lynx-service-log:4.0.0"
+    implementation "org.lynxsdk.lynx:lynx-service-http:4.0.0"
+}

package/templates/android-host/app/proguard-rules.pro

@@ -0,0 +1,2 @@
+# Lynx's official release rules are supplied by the Lynx Android artifacts.
+# Add application-specific keep rules here when native modules require them.

package/templates/android-host/app/src/main/AndroidManifest.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.INTERNET" />
+
+    <application
+        android:allowBackup="false"
+        android:name=".LynxShipApplication"
+        android:label="@string/app_name"
+        android:supportsRtl="true"
+        android:theme="@style/AppTheme">
+        <activity
+            android:name=".MainActivity"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+</manifest>

package/templates/android-host/app/src/main/java/template/LynxShipApplication.java

@@ -0,0 +1,13 @@
+package __PACKAGE_NAME__;
+
+import android.app.Application;
+
+import com.lynx.tasm.LynxEnv;
+
+public final class LynxShipApplication extends Application {
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        LynxEnv.inst().init(this, null, null, null);
+    }
+}

package/templates/android-host/app/src/main/java/template/MainActivity.java

@@ -0,0 +1,19 @@
+package __PACKAGE_NAME__;
+
+import android.app.Activity;
+import android.os.Bundle;
+
+import com.lynx.tasm.LynxView;
+import com.lynx.tasm.LynxViewBuilder;
+
+public final class MainActivity extends Activity {
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        LynxView lynxView = new LynxViewBuilder()
+                .setTemplateProvider(new ProjectTemplateProvider(this))
+                .build(this);
+        setContentView(lynxView);
+        lynxView.renderTemplateUrl("main.lynx.bundle", "");
+    }
+}

package/templates/android-host/app/src/main/java/template/ProjectTemplateProvider.java

@@ -0,0 +1,32 @@
+package __PACKAGE_NAME__;
+
+import android.content.Context;
+
+import com.lynx.tasm.provider.AbsTemplateProvider;
+
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+
+public final class ProjectTemplateProvider extends AbsTemplateProvider {
+    private final Context context;
+
+    public ProjectTemplateProvider(Context context) {
+        this.context = context.getApplicationContext();
+    }
+
+    @Override
+    public void loadTemplate(String uri, Callback callback) {
+        new Thread(() -> {
+            try (InputStream input = context.getAssets().open(uri);
+                    ByteArrayOutputStream output = new ByteArrayOutputStream()) {
+                byte[] buffer = new byte[8192];
+                int read;
+                while ((read = input.read(buffer)) != -1) output.write(buffer, 0, read);
+                callback.onSuccess(output.toByteArray());
+            } catch (IOException error) {
+                callback.onFailed(error.getMessage());
+            }
+        }, "lynx-template-loader").start();
+    }
+}

package/templates/android-host/app/src/main/res/values/strings.xml

@@ -0,0 +1,3 @@
+<resources>
+    <string name="app_name">__APP_NAME__</string>
+</resources>

package/templates/android-host/app/src/main/res/values/themes.xml

@@ -0,0 +1,6 @@
+<resources>
+    <style name="AppTheme" parent="android:style/Theme.Material.Light.NoActionBar">
+        <item name="android:fontFamily">sans</item>
+        <item name="android:colorAccent">#1976D2</item>
+    </style>
+</resources>

package/templates/android-host/build.gradle

@@ -0,0 +1,3 @@
+plugins {
+    id "com.android.application" version "8.7.0" apply false
+}

package/templates/android-host/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.9-bin.zip
+networkTimeout=60000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

package/templates/android-host/gradle.properties

@@ -0,0 +1,3 @@
+android.useAndroidX=true
+android.nonTransitiveRClass=true
+org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8