@lynxship/cli 0.1.13 → 0.1.15

package/README.md

@@ -212,6 +212,11 @@ Next steps
 ```
 
 `lynxship dev` is for Lynx Explorer and live QR/HMR development. The Android
+Rspeedy URLs are rendered by LynxShip's own compact QR adapter so the QR
+remains visible when child-process output is captured. It uses the WISA
+renderer settings (H-level correction, dots, dotted corners and 50-degree
+linear gradient) with LynxShip pink-to-cyan colors and no center logo;
+non-interactive output keeps the URL and omits terminal decoration. The Android
 host command creates the native Gradle project needed for a real APK/AAB. An
 interactive real build creates a missing host after asking for the application
 ID; CI must pass `--application-id`. Existing native directories are never
@@ -277,6 +282,10 @@ Use the official Lynx Harmony integration under `harmony/`. The project must
 provide `hvigorw`, `hvigorfile.ts`, `build-profile.json5` and
 `oh-package.json5`. LynxShip runs `ohpm install`, the pinned wrapper in release
 mode, then verifies the signed HAP with the official `hap-sign-tool.jar`.
+Before Hvigor runs, it copies root `.lynx.bundle` files plus `dist/static` and
+`dist/async` into the configured HarmonyOS `rawfile` directory. This keeps
+imported images and lazy bundles inside the HAP instead of leaving them only in
+the JavaScript build output.
 
 Optional profile overrides are explicit and remain project-owned:
 
@@ -406,6 +415,19 @@ with:
 lynxship ios host init --bundle-identifier com.example.myapp
 ```
 
+If the project already has its app icon, provide the required high-resolution
+PNG during host creation:
+
+```bash
+lynxship ios host init --bundle-identifier com.example.myapp --icon ./assets/icon.png
+```
+
+The icon must be a square 1024x1024 PNG. For an existing host, set
+`build.production.ios.appIcon` in `lynxship.json`, or add `icon.png` in the
+project root; LynxShip discovers it before the next native build. Simulator
+builds may fall back to a square `lynx-logo*.png` emitted by Rspeedy for local
+preview only; provide the project icon for an IPA or store release.
+
 The command refuses to overwrite an existing `ios/` directory and creates a
 Swift host based on Lynx's official integration shape: `LynxEnv`, `LynxView`,
 `LynxTemplateProvider`, `Podfile`, `ExportOptions.plist` and a bundle sync
@@ -421,9 +443,18 @@ lynxship build --project-dir ./my-lynx-app --platform ios --simulator --profile
 ```
 
 This uses Xcode's `iphonesimulator` SDK, boots an available Simulator, creates
-and installs a local `.app`, and does not require a physical iPhone, Apple
+and installs a local `.app`, opens the Simulator and launches the app in an
+interactive terminal, and does not require a physical iPhone, Apple
 Distribution certificate, provisioning profile or R2 upload. Use the
-production profile only for a signed device IPA.
+production profile only for a signed device IPA. Pass `--no-autostart` to
+install without launching, or use `run --platform ios --simulator --launch
+--artifact <app>` to launch an already-built app.
+
+Rspeedy can emit external files beside the main bundle. The iOS adapter copies
+all root `.lynx.bundle` files plus `dist/static` and `dist/async` into the
+compiled `.app` before installation/export, so imported images and lazy assets
+are included in Simulator and device builds. The same synchronization is
+applied to older LynxShip-generated iOS hosts.
 
 Run the complete first-use diagnosis before building:
 

package/dist/config.d.ts

@@ -15,6 +15,7 @@ export interface BuildProfile {
         scheme?: string;
         exportOptionsPlist?: string;
         bundleScript?: string;
+        appIcon?: string;
     };
     harmony?: {
         task?: string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,GAAG,CAAC,EAAE;QACJ,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAChC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,cAAc,CAAC,EAAE;QAAE,MAAM,EAAE,aAAa,GAAG,QAAQ,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE;QACP,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE;YAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1C,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,cAAc,EAAE,cAsB5B,CAAC;AAaF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,EACf,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B,cAAc,CAyChB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B,OAAO,CAAC,cAAc,CAAC,CAazB;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,IAAI,SAAe,GAClB,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAejC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAOrD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,GAAG,CAAC,EAAE;QACJ,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAChC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,cAAc,CAAC,EAAE;QAAE,MAAM,EAAE,aAAa,GAAG,QAAQ,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE;QACP,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE;YAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1C,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,cAAc,EAAE,cAsB5B,CAAC;AAaF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,EACf,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B,cAAc,CAyChB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B,OAAO,CAAC,cAAc,CAAC,CAazB;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,IAAI,SAAe,GAClB,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAejC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAOrD"}

package/dist/dev-qr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-qr.d.ts","sourceRoot":"","sources":["../src/dev-qr.ts"],"names":[],"mappings":"AAMA,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMpE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D"}
+{"version":3,"file":"dev-qr.d.ts","sourceRoot":"","sources":["../src/dev-qr.ts"],"names":[],"mappings":"AAOA,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOpE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/dev-qr.js

@@ -1,12 +1,14 @@
-const URL_PATTERN = /https?:\/\/[^\s<>"'`]+/g;
+// Rspeedy's QR plugin accepts custom schemas, so a dev URL is not always HTTP.
+const URL_PATTERN = /[a-z][a-z\d+.-]*:\/\/[^\s<>"'`]+/gi;
 function cleanUrl(value) {
     return value.replace(/[),.;!?]+$/u, "");
 }
 export function extractDevServerUrl(line) {
     const urls = (line.match(URL_PATTERN) ?? []).map(cleanUrl);
     return (urls.find((url) => url.includes("fullscreen=true")) ??
-        urls.find((url) => url.includes(".lynx.bundle")));
+        urls.find((url) => url.includes(".lynx.bundle")) ??
+        urls[0]);
 }
 export function shouldPrintDevServerQr(line) {
-    return /(?:default:|fullscreen=true|\bready\b)/iu.test(line);
+    return /(?:default:|fullscreen|\bready\b|\blynx\b)/iu.test(line);
 }

package/dist/harmony-build.d.ts

@@ -17,6 +17,7 @@ export declare function harmonyToolchain(root: string): {
     hdc: boolean;
     message: string;
 };
+export declare function syncHarmonyAssets(root: string, profile: BuildProfile): Promise<string[]>;
 export declare function runRealHarmonyBuild(job: BuildJob, options: HarmonyBuildOptions): Promise<BuildJob>;
 export {};
 //# sourceMappingURL=harmony-build.d.ts.map

package/dist/harmony-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harmony-build.d.ts","sourceRoot":"","sources":["../src/harmony-build.ts"],"names":[],"mappings":"AAIA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAeD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC9C,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAcA;AAmID,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAkGnB"}
+{"version":3,"file":"harmony-build.d.ts","sourceRoot":"","sources":["../src/harmony-build.ts"],"names":[],"mappings":"AAIA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAeD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC9C,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAcA;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BnB;AA2GD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAoGnB"}

package/dist/harmony-build.js

@@ -1,4 +1,4 @@
-import { copyFile, mkdir, mkdtemp, readdir, rm } from "node:fs/promises";
+import { copyFile, cp, mkdir, mkdtemp, readdir, rm } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
 import { join, resolve } from "node:path";
@@ -37,7 +37,7 @@ export function harmonyToolchain(root) {
             : "Harmony host requires the project hvigorw wrapper and ohpm from DevEco Studio",
     };
 }
-async function syncBundle(root, profile) {
+export async function syncHarmonyAssets(root, profile) {
     const dist = join(root, "dist");
     const entries = await readdir(dist, { withFileTypes: true }).catch(() => []);
     const bundles = entries
@@ -46,9 +46,20 @@ async function syncBundle(root, profile) {
     assert(bundles.length > 0, "LYNX_BUNDLE_MISSING", `No .lynx.bundle was found in ${dist}. Check the Rspeedy output configuration.`);
     const target = resolve(root, profile.harmony?.bundleDir ?? "harmony/entry/src/main/resources/rawfile");
     await mkdir(target, { recursive: true });
-    for (const bundle of bundles)
-        await copyFile(join(dist, bundle), join(target, bundle));
-    return bundles;
+    const outputNames = [...bundles, "async", "static"];
+    const copied = [];
+    for (const name of outputNames) {
+        const source = join(dist, name);
+        if (!existsSync(source))
+            continue;
+        await rm(join(target, name), { recursive: true, force: true });
+        if (name.endsWith(".lynx.bundle"))
+            await copyFile(source, join(target, name));
+        else
+            await cp(source, join(target, name), { recursive: true, force: true });
+        copied.push(name);
+    }
+    return copied;
 }
 async function findHap(root, configured) {
     if (configured) {
@@ -133,7 +144,9 @@ export async function runRealHarmonyBuild(job, options) {
             });
         }
         step("Syncing bundle into the HarmonyOS HAP resources…", 20);
-        await syncBundle(options.root, options.profile);
+        const copiedAssets = await syncHarmonyAssets(options.root, options.profile);
+        for (const name of copiedAssets)
+            options.onEvent?.(`Synced dist/${name} into HarmonyOS rawfile resources`);
         transitionBuild(job, "queued", "HarmonyOS build queued locally");
         transitionBuild(job, "provisioning", "HarmonyOS Hvigor toolchain selected");
         transitionBuild(job, "installing_dependencies", "HarmonyOS dependencies selected");

package/dist/index.js

@@ -12,7 +12,7 @@ import { DEFAULT_CONFIG, loadConfig, platformValue, resolveProfile, } from "./co
 import { hasAndroidHost, isSupportedAndroidPlatform, runRealAndroidBuild, } from "./android-build.js";
 import { initializeAndroidHost, suggestedAndroidApplicationId, } from "./android-host.js";
 import { initializeIosHost, suggestedIosBundleIdentifier } from "./ios-host.js";
-import { hasIosHost, runRealIosBuild } from "./ios-build.js";
+import { hasIosHost, launchIosSimulatorApp, runRealIosBuild, } from "./ios-build.js";
 import { configureAndroid, configureAppStoreConnect, configureGooglePlay, configureR2, } from "./configure.js";
 import { fetchOtaPublicKey, publishOtaRelease, rollbackOtaRelease, submitRealArtifact, } from "./remote.js";
 import { uploadR2Artifact } from "./r2.js";
@@ -209,7 +209,7 @@ async function saveState(state, repository, builds, submissions) {
 }
 let stateSaveQueue = Promise.resolve();
 async function executeBuild(options, showResult = true) {
-    const { config, profile, platform, skipUpload, wait, local, state, repository, builds, submissions, progress: sharedProgress, progressPrefix, onProgress, onEvent, skipBundleBuild, simulator = false, simulatorDevice, } = options;
+    const { config, profile, platform, skipUpload, wait, local, state, repository, builds, submissions, progress: sharedProgress, progressPrefix, onProgress, onEvent, skipBundleBuild, simulator = false, simulatorDevice, simulatorAutostart = false, } = options;
     if (wait && !local)
         await ensureNativeHostForBuild(platform, profile, config);
     // Host initialization can write lynxship.json (for example, the generated
@@ -281,6 +281,7 @@ async function executeBuild(options, showResult = true) {
                     profile: resolvedBuildProfile,
                     simulator,
                     simulatorDevice,
+                    simulatorAutostart,
                     uploadArtifacts: !skipUpload,
                     skipBundleBuild,
                     quiet: json,
@@ -459,6 +460,8 @@ Build options:
   --no-upload              Keep the artifact local and skip R2 (CI verification)
   --simulator             Build and install an iOS Simulator .app locally
   --device <id>           Select the iOS Simulator device for a simulator build
+  --autostart              Open and launch the iOS Simulator app after install
+  --no-autostart           Install the Simulator app without launching it
   --allow-unsigned         Allow an unsigned Desktop artifact only with --no-upload (local tests)
   --local                 Use the contract-only build path for tests
 
@@ -490,6 +493,7 @@ Device and diagnostics options:
   run --artifact <path>   Install a specific APK, IPA, app or signed HAP
   run --device <id>       Select an Android, iOS or HarmonyOS device
   run --simulator         Install an iOS .app with simctl
+  run --launch             Launch the installed iOS Simulator app after install
   logs --device <id>      Select the device or simulator for native logs
 
 Global options:
@@ -503,6 +507,7 @@ Global options:
   --project-id <id>       Project ID used by init
   --application-id <id>   Android package/application ID for host init
   --bundle-identifier <id> iOS bundle identifier for host init
+  --icon <path>            1024x1024 PNG app icon for iOS host init
   --library-dir <path>    Native library directory for autolink codegen
   --simulator             Build/install an iOS .app or install one with simctl
   --help                  Show this complete command reference
@@ -594,6 +599,7 @@ async function ensureNativeHostForBuild(platform, profile, config) {
     const result = await initializeIosHost(root, {
         bundleIdentifier,
         appName: basename(root),
+        appIcon: flag("--icon") ?? undefined,
     });
     ui.success(`iOS host created: ${result.directory}`);
 }
@@ -638,13 +644,13 @@ async function runRspeedyCommand(subcommand, environment) {
     let devUrl;
     let devQrPrinted = false;
     let devQrTimer;
-    const printDevQr = () => {
+    const printDevQr = async () => {
         if (!devUrl || devQrPrinted || json || ui.options.quiet)
             return;
         devQrPrinted = true;
         if (devQrTimer)
             clearTimeout(devQrTimer);
-        ui.devServerQr(devUrl);
+        await ui.devServerQr(devUrl);
     };
     await runRspeedy(root, subcommand, forwarded, {
         env: environment,
@@ -658,10 +664,12 @@ async function runRspeedyCommand(subcommand, environment) {
                 devUrl = url;
                 if (devQrTimer)
                     clearTimeout(devQrTimer);
-                devQrTimer = setTimeout(printDevQr, 500);
+                devQrTimer = setTimeout(() => {
+                    void printDevQr();
+                }, 500);
             }
             if (devUrl && shouldPrintDevServerQr(line))
-                printDevQr();
+                void printDevQr();
         },
     });
     printValue({ status: "success", command: `rspeedy ${subcommand}` }, {
@@ -753,6 +761,12 @@ async function runDevice() {
                 quiet: json,
                 onOutput: (line) => ui.info(`│ ${line}`),
             });
+            if (args.includes("--launch")) {
+                await launchIosSimulatorApp(root, device, artifactPath, {
+                    quiet: json,
+                    onEvent: (line) => ui.info(`│ ${line}`),
+                });
+            }
         }
         else {
             assert(device !== "booted", "IOS_DEVICE_REQUIRED", "A physical iOS install requires --device <device-identifier>; use --simulator for a booted simulator.");
@@ -1228,6 +1242,7 @@ async function main() {
         const result = await initializeIosHost(root, {
             bundleIdentifier,
             appName: basename(root),
+            appIcon: flag("--icon") ?? undefined,
         });
         ui.success(`iOS host created: ${result.directory}`);
         printValue({
@@ -1671,6 +1686,9 @@ async function main() {
     const config = await loadConfig(root);
     const profile = flag("--profile", simulator ? "simulator" : "production");
     const simulatorDevice = flag("--device") ?? undefined;
+    const simulatorAutostart = simulator &&
+        !args.includes("--no-autostart") &&
+        (args.includes("--autostart") || (!json && ui.interactive));
     const wait = !args.includes("--no-wait");
     const local = args.includes("--local");
     const platforms = buildAll
@@ -1692,6 +1710,7 @@ async function main() {
             local,
             simulator,
             simulatorDevice,
+            simulatorAutostart,
             state,
             repository,
             builds,
@@ -1723,6 +1742,7 @@ async function main() {
         local,
         simulator,
         simulatorDevice,
+        simulatorAutostart,
         state,
         repository,
         builds,

package/dist/ios-build.d.ts

@@ -6,11 +6,32 @@ interface IosBuildOptions {
     uploadArtifacts?: boolean;
     simulator?: boolean;
     simulatorDevice?: string;
+    simulatorAutostart?: boolean;
     skipBundleBuild?: boolean;
     quiet?: boolean;
     onEvent?: (message: string) => void;
     onProgress?: (value?: number, label?: string) => void;
 }
+/**
+ * Rspeedy leaves external resources beside the Lynx bundle. Xcode does not
+ * know about those generated files, so copy the complete output into the
+ * final app bundle after the native host has been compiled. This also makes
+ * older LynxShip-generated iOS hosts behave correctly without editing their
+ * Xcode project files.
+ */
+export declare function syncIosRuntimeResources(root: string, appBundle: string): Promise<string[]>;
+/**
+ * Apply a project-owned 1024x1024 PNG to the generated or existing Xcode
+ * AppIcon set. A missing icon is reported as a warning by the caller rather
+ * than silently inventing product branding.
+ */
+export declare function prepareIosAppIcon(root: string, configured?: string, options?: {
+    allowFallback?: boolean;
+}): Promise<string | undefined>;
+export declare function launchIosSimulatorApp(root: string, device: string, appBundle: string, options?: {
+    quiet?: boolean;
+    onEvent?: (message: string) => void;
+}): Promise<void>;
 export declare function hasIosHost(root: string, profile?: BuildProfile): boolean;
 export declare function runRealIosBuild(job: BuildJob, options: IosBuildOptions): Promise<BuildJob>;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"ios-build.d.ts","sourceRoot":"","sources":["../src/ios-build.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAwRD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAcxE;AA+DD,wBAAsB,eAAe,CACnC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,QAAQ,CAAC,CAwMnB"}
+{"version":3,"file":"ios-build.d.ts","sourceRoot":"","sources":["../src/ios-build.ts"],"names":[],"mappings":"AAYA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAyHD;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB;AAoED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuD7B;AAgCD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GACL,OAAO,CAAC,IAAI,CAAC,CAcf;AAkND,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAcxE;AA+DD,wBAAsB,eAAe,CACnC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,QAAQ,CAAC,CAqNnB"}

package/dist/ios-build.js

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import { copyFile, mkdir, readdir, readFile } from "node:fs/promises";
+import { copyFile, cp, mkdir, readdir, readFile, rm, writeFile, } from "node:fs/promises";
 import { existsSync, readdirSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { assert, sha256 } from "@lynxship/contracts";
@@ -56,6 +56,159 @@ async function findSimulatorApp(root, derivedData, configuration, scheme) {
     assert(app, "IOS_SIMULATOR_ARTIFACT_MISSING", `Xcode did not produce a Simulator .app under ${products}`);
     return join(products, app.name);
 }
+async function findArchiveApp(archivePath) {
+    const products = join(archivePath, "Products", "Applications");
+    const entries = await readdir(products, { withFileTypes: true }).catch(() => []);
+    const app = entries.find((entry) => entry.isDirectory() && entry.name.endsWith(".app"));
+    assert(app, "IOS_ARCHIVE_ARTIFACT_MISSING", `Xcode did not produce an app bundle under ${products}`);
+    return join(products, app.name);
+}
+async function copyIosOutput(source, target) {
+    if (!existsSync(source))
+        return false;
+    await rm(target, { recursive: true, force: true });
+    await cp(source, target, { recursive: true, force: true });
+    return true;
+}
+/**
+ * Rspeedy leaves external resources beside the Lynx bundle. Xcode does not
+ * know about those generated files, so copy the complete output into the
+ * final app bundle after the native host has been compiled. This also makes
+ * older LynxShip-generated iOS hosts behave correctly without editing their
+ * Xcode project files.
+ */
+export async function syncIosRuntimeResources(root, appBundle) {
+    const distRoot = join(root, "dist");
+    const entries = await readdir(distRoot, { withFileTypes: true }).catch(() => []);
+    const bundles = entries
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".lynx.bundle"))
+        .map((entry) => entry.name);
+    assert(bundles.length > 0, "LYNX_BUNDLE_MISSING", `No .lynx.bundle was found in ${distRoot}. Check the Rspeedy output configuration.`);
+    const copied = [];
+    for (const name of [...bundles, "async", "static"]) {
+        if (await copyIosOutput(join(distRoot, name), join(appBundle, name)))
+            copied.push(name);
+    }
+    return copied;
+}
+async function findAppIconSet(directory) {
+    const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+        const path = join(directory, entry.name);
+        if (entry.isDirectory() && entry.name === "AppIcon.appiconset") {
+            if (existsSync(join(path, "Contents.json")))
+                return path;
+        }
+        if (entry.isDirectory() &&
+            !entry.name.endsWith(".xcodeproj") &&
+            !entry.name.endsWith(".xcworkspace")) {
+            const result = await findAppIconSet(path);
+            if (result)
+                return result;
+        }
+    }
+    return undefined;
+}
+function pngDimensions(content) {
+    assert(content.length >= 24 &&
+        content.subarray(0, 8).toString("hex") === "89504e470d0a1a0a", "IOS_APP_ICON_INVALID", "The iOS app icon must be a valid PNG file.");
+    return { width: content.readUInt32BE(16), height: content.readUInt32BE(20) };
+}
+async function findConfiguredIosIcon(root, configured, allowFallback = false) {
+    const candidates = [
+        configured,
+        "icon.png",
+        "app-icon.png",
+        "assets/icon.png",
+        "assets/app-icon.png",
+        "src/assets/icon.png",
+        "src/assets/app-icon.png",
+        "public/icon.png",
+    ].filter((value) => Boolean(value));
+    for (const candidate of candidates) {
+        const path = resolve(root, candidate);
+        if (existsSync(path))
+            return { path, fallback: false };
+    }
+    if (allowFallback) {
+        const staticImages = join(root, "dist", "static", "image");
+        const entries = await readdir(staticImages, { withFileTypes: true }).catch(() => []);
+        const logo = entries.find((entry) => entry.isFile() &&
+            entry.name.endsWith(".png") &&
+            /(?:lynx|logo|icon)/i.test(entry.name));
+        if (logo)
+            return { path: join(staticImages, logo.name), fallback: true };
+    }
+    return undefined;
+}
+/**
+ * Apply a project-owned 1024x1024 PNG to the generated or existing Xcode
+ * AppIcon set. A missing icon is reported as a warning by the caller rather
+ * than silently inventing product branding.
+ */
+export async function prepareIosAppIcon(root, configured, options = {}) {
+    const source = await findConfiguredIosIcon(root, configured, options.allowFallback);
+    const iconSet = await findAppIconSet(join(root, "ios"));
+    if (!source || !iconSet)
+        return undefined;
+    const dimensions = pngDimensions(await readFile(source.path));
+    const filename = "AppIcon.png";
+    const destination = join(iconSet, filename);
+    if (dimensions.width === 1024 && dimensions.height === 1024) {
+        await copyFile(source.path, destination);
+    }
+    else {
+        assert(source.fallback &&
+            dimensions.width === dimensions.height &&
+            dimensions.width >= 512, "IOS_APP_ICON_INVALID", `The iOS app icon must be exactly 1024x1024 PNG; received ${dimensions.width}x${dimensions.height} from ${source.path}.`);
+        assert(commandExists("sips"), "IOS_SIPS_REQUIRED", "The fallback Simulator icon needs Apple's sips tool. Install Xcode command-line tools, or provide a 1024x1024 icon.png.");
+        await runProcess("sips", ["-z", "1024", "1024", source.path, "--out", destination], {
+            cwd: root,
+            quiet: true,
+        });
+    }
+    await writeFile(join(iconSet, "Contents.json"), `${JSON.stringify({
+        images: [
+            {
+                filename,
+                idiom: "universal",
+                platform: "ios",
+                size: "1024x1024",
+            },
+        ],
+        info: { author: "xcode", version: 1 },
+    }, null, 2)}\n`, "utf8");
+    return source.path;
+}
+async function appBundleIdentifier(root, appBundle) {
+    assert(commandExists("plutil"), "IOS_PLUTIL_REQUIRED", "plutil was not found. Install Xcode command-line tools before launching the Simulator app.");
+    const result = await captureProcess("plutil", [
+        "-extract",
+        "CFBundleIdentifier",
+        "raw",
+        "-o",
+        "-",
+        join(appBundle, "Info.plist"),
+    ], { cwd: root });
+    const identifier = result.stdout.trim();
+    assert(result.code === 0 && identifier, "IOS_BUNDLE_IDENTIFIER_MISSING", `Could not read CFBundleIdentifier from ${join(appBundle, "Info.plist")}.`);
+    return identifier;
+}
+export async function launchIosSimulatorApp(root, device, appBundle, options = {}) {
+    const identifier = await appBundleIdentifier(root, appBundle);
+    options.onEvent?.("Opening iOS Simulator…");
+    await runProcess("open", ["-a", "Simulator"], {
+        cwd: root,
+        quiet: options.quiet,
+        onOutput: options.onEvent,
+    });
+    options.onEvent?.(`Launching ${identifier} in iOS Simulator…`);
+    await runProcess("xcrun", ["simctl", "launch", device, identifier], {
+        cwd: root,
+        quiet: options.quiet,
+        onOutput: options.onEvent,
+    });
+}
 async function hashDirectory(directory) {
     const hash = createHash("sha256");
     let size = 0;
@@ -121,6 +274,13 @@ async function runRealIosSimulatorBuild(job, options) {
                 onOutput: options.onEvent,
             });
         }
+        const icon = await prepareIosAppIcon(options.root, ios.appIcon, {
+            allowFallback: true,
+        });
+        if (icon)
+            step(`Using iOS app icon: ${icon}`, 9);
+        else
+            options.onEvent?.("No 1024x1024 PNG app icon was found; configure ios.appIcon or add icon.png before distribution.");
         transitionBuild(job, "queued", "iOS Simulator build queued locally");
         transitionBuild(job, "provisioning", "iOS Simulator destination selected");
         transitionBuild(job, "installing_dependencies", "iOS Simulator dependencies ready");
@@ -145,12 +305,26 @@ async function runRealIosSimulatorBuild(job, options) {
             "build",
         ], { cwd: options.root, quiet: options.quiet, onOutput: options.onEvent });
         const appPath = await findSimulatorApp(options.root, derivedData, configuration, ios.scheme);
+        const copiedResources = await syncIosRuntimeResources(options.root, appPath);
+        for (const name of copiedResources)
+            options.onEvent?.(`Packaged ${name} in the iOS Simulator app`);
         step("Installing .app in iOS Simulator…", 75);
         await runProcess("xcrun", ["simctl", "install", device, appPath], {
             cwd: options.root,
             quiet: options.quiet,
             onOutput: options.onEvent,
         });
+        if (options.simulatorAutostart) {
+            try {
+                await launchIosSimulatorApp(options.root, device, appPath, {
+                    quiet: options.quiet,
+                    onEvent: options.onEvent,
+                });
+            }
+            catch (error) {
+                options.onEvent?.(`Simulator app installed but could not be launched automatically: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
         const artifact = await hashDirectory(appPath);
         const artifactName = nativeArtifactName("app");
         job.attempts += 1;
@@ -290,6 +464,11 @@ export async function runRealIosBuild(job, options) {
                 onOutput: options.onEvent,
             });
         }
+        const icon = await prepareIosAppIcon(options.root, ios.appIcon);
+        if (icon)
+            step(`Using iOS app icon: ${icon}`, 9);
+        else
+            options.onEvent?.("No 1024x1024 PNG app icon was found; configure ios.appIcon or add icon.png before distribution.");
         step("Preparing Xcode archive…", 10);
         await runProcess("xcodebuild", [
             projectFlag,
@@ -304,6 +483,10 @@ export async function runRealIosBuild(job, options) {
             archivePath,
             "archive",
         ], { cwd: options.root, quiet: options.quiet, onOutput: options.onEvent });
+        const archivedApp = await findArchiveApp(archivePath);
+        const copiedResources = await syncIosRuntimeResources(options.root, archivedApp);
+        for (const name of copiedResources)
+            options.onEvent?.(`Packaged ${name} in the iOS archive`);
         transitionBuild(job, "queued", "iOS build queued locally");
         transitionBuild(job, "provisioning", "Xcode signing configuration selected");
         step("Exporting signed IPA…", 55);

package/dist/ios-host.d.ts

@@ -1,6 +1,7 @@
 export interface IosHostOptions {
     bundleIdentifier: string;
     appName: string;
+    appIcon?: string;
 }
 export interface IosHostResult {
     directory: string;
@@ -10,6 +11,7 @@ export interface IosHostResult {
     scheme: string;
     exportOptionsPlist: string;
     bundleScript: string;
+    appIcon?: string;
     configUpdated: boolean;
 }
 export declare function initializeIosHost(root: string, options: IosHostOptions): Promise<IosHostResult>;

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

@@ -1 +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"}
+{"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;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;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,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB;AAqED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CA2CxB;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjE"}

package/dist/ios-host.js

@@ -51,6 +51,7 @@ async function updateProjectConfig(root, result) {
         configuration: "Release",
         exportOptionsPlist: "ios/ExportOptions.plist",
         bundleScript: "ios/sync-bundle.mjs",
+        ...(result.appIcon ? { appIcon: result.appIcon } : {}),
     };
     await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
     return true;
@@ -81,6 +82,7 @@ export async function initializeIosHost(root, options) {
         scheme,
         exportOptionsPlist: "ios/ExportOptions.plist",
         bundleScript: "ios/sync-bundle.mjs",
+        ...(options.appIcon ? { appIcon: options.appIcon } : {}),
     };
     const configUpdated = await updateProjectConfig(root, result);
     return { ...result, configUpdated };

package/dist/ui/components.d.ts

@@ -35,5 +35,5 @@ export declare const pill: {
 export declare function finalLine(message: string, success?: boolean): void;
 export declare function nextSteps(commands: string[], note?: string, environment?: string): void;
 export declare function downloadArtifact(url: string, expiresAt?: string, enabled?: boolean): void;
-export declare function devServerQr(url: string, enabled?: boolean): void;
+export declare function devServerQr(url: string, enabled?: boolean): Promise<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;AA6CD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoBnD;AA6BD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,cAAc,CAuEhB;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,CACvB,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAQN;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,UAAO,GACb,IAAI,CAQN;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,IAAI,CAK7D"}
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/ui/components.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7C,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;AA6BD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,cAAc,CAuEhB;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,CACvB,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAQN;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,UAAO,GACb,IAAI,CAQN;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5E"}

package/dist/ui/components.js

@@ -5,6 +5,7 @@ import ora from "ora";
 import qrcode from "qrcode-terminal";
 import { c, colorsEnabled } from "./state.js";
 import { supportsUnicode, terminalWidth } from "./terminal.js";
+import { renderTerminalQr } from "./qr.js";
 export function sectionHeader(title) {
     console.log(`\n${c.brandBold(`◆ LynxShip — ${title}`)}`);
 }
@@ -288,10 +289,25 @@ export function downloadArtifact(url, expiresAt, enabled = true) {
     if (expiresAt)
         console.log(`  ${c.muted(`Link expires at ${expiresAt}`)}`);
 }
-export function devServerQr(url, enabled = true) {
+export async function devServerQr(url, enabled = true) {
     if (!enabled)
         return;
-    console.log(`\n${c.brandBold("Lynx Explorer")}`);
-    qrcode.generate(url, { small: true }, (code) => console.log(code));
-    console.log(`  ${c.teal("URL")}  ${url}\n`);
+    const rail = c.teal("│");
+    const printRail = (value = "") => console.log(`  ${rail}${value}`);
+    printRail();
+    printRail(` ${c.brandBold("Lynx Explorer")}`);
+    if (colorsEnabled && supportsUnicode()) {
+        (await renderTerminalQr(url))
+            .split("\n")
+            .forEach((line) => printRail(` ${line}`));
+    }
+    else {
+        qrcode.generate(url, { small: true }, (code) => {
+            code.split("\n").forEach((line) => printRail(` ${line}`));
+        });
+    }
+    printRail();
+    printRail(` ${c.teal("URL")}  ${url}`);
+    printRail();
+    console.log();
 }

package/dist/ui/index.d.ts

@@ -19,7 +19,7 @@ export declare class CliUi {
     spinner(text: string): SpinnerHandle;
     done(message: string, success?: boolean): void;
     downloadArtifact(url: string, expiresAt?: string): void;
-    devServerQr(url: string): void;
+    devServerQr(url: string): Promise<void>;
 }
 export declare function createCliUi(args: string[]): CliUi;
 export { terminalOptions };

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,EAUL,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;IAIvD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG/B;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAUL,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;IAIjD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAS9C;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

@@ -66,8 +66,11 @@ export class CliUi {
     downloadArtifact(url, expiresAt) {
         downloadArtifact(url, expiresAt, this.interactive);
     }
-    devServerQr(url) {
-        devServerQr(url, this.interactive && !this.options.quiet);
+    async devServerQr(url) {
+        // Rspeedy suppresses its own QR when its stdout is piped. LynxShip
+        // captures that output, so render the fallback unless the caller asked
+        // for machine JSON, quiet output, or an explicitly non-interactive run.
+        await devServerQr(url, !this.options.json && !this.options.quiet && !this.options.nonInteractive);
     }
 }
 export function createCliUi(args) {

package/dist/ui/qr.d.ts

@@ -0,0 +1,61 @@
+export declare const LYNXSHIP_QR_STYLE: {
+    readonly type: "svg";
+    readonly width: 300;
+    readonly height: 300;
+    readonly margin: 0;
+    readonly qrOptions: {
+        readonly errorCorrectionLevel: "H";
+    };
+    readonly dotsOptions: {
+        readonly type: "dots";
+        readonly gradient: {
+            readonly type: "linear";
+            readonly rotation: number;
+            readonly colorStops: readonly [{
+                readonly offset: 0;
+                readonly color: "#ff6b9d";
+            }, {
+                readonly offset: 1;
+                readonly color: "#45b7d1";
+            }];
+        };
+    };
+    readonly cornersSquareOptions: {
+        readonly type: "dot";
+        readonly gradient: {
+            readonly type: "linear";
+            readonly rotation: number;
+            readonly colorStops: readonly [{
+                readonly offset: 0;
+                readonly color: "#ff6b9d";
+            }, {
+                readonly offset: 1;
+                readonly color: "#45b7d1";
+            }];
+        };
+    };
+    readonly cornersDotOptions: {
+        readonly type: "dot";
+        readonly gradient: {
+            readonly type: "linear";
+            readonly rotation: number;
+            readonly colorStops: readonly [{
+                readonly offset: 0;
+                readonly color: "#ff6b9d";
+            }, {
+                readonly offset: 1;
+                readonly color: "#45b7d1";
+            }];
+        };
+    };
+    readonly backgroundOptions: {
+        readonly color: "#FFFFFF";
+    };
+};
+/**
+ * Generate the QR with qr-code-styling itself, exactly like the WISA renderer.
+ * The SVG is then rasterized only to make the library's real rounded shapes
+ * displayable in a normal terminal; no QR modules are recreated by LynxShip.
+ */
+export declare function renderTerminalQr(data: string): Promise<string>;
+//# sourceMappingURL=qr.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qr.d.ts","sourceRoot":"","sources":["../../src/ui/qr.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCpB,CAAC;AAyLX;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBpE"}

package/dist/ui/qr.js

@@ -0,0 +1,180 @@
+import { LYNX_BRAND } from "./colors.js";
+import { terminalWidth } from "./terminal.js";
+import { createRequire } from "node:module";
+export const LYNXSHIP_QR_STYLE = {
+    type: "svg",
+    width: 300,
+    height: 300,
+    margin: 0,
+    qrOptions: { errorCorrectionLevel: "H" },
+    dotsOptions: {
+        type: "dots",
+        gradient: {
+            type: "linear",
+            rotation: (50 * Math.PI) / 180,
+            colorStops: [
+                { offset: 0, color: LYNX_BRAND.pink },
+                { offset: 1, color: LYNX_BRAND.cyan },
+            ],
+        },
+    },
+    cornersSquareOptions: {
+        type: "dot",
+        gradient: {
+            type: "linear",
+            rotation: (50 * Math.PI) / 180,
+            colorStops: [
+                { offset: 0, color: LYNX_BRAND.pink },
+                { offset: 1, color: LYNX_BRAND.cyan },
+            ],
+        },
+    },
+    cornersDotOptions: {
+        type: "dot",
+        gradient: {
+            type: "linear",
+            rotation: (50 * Math.PI) / 180,
+            colorStops: [
+                { offset: 0, color: LYNX_BRAND.pink },
+                { offset: 1, color: LYNX_BRAND.cyan },
+            ],
+        },
+    },
+    backgroundOptions: { color: "#FFFFFF" },
+};
+async function loadDependencies() {
+    const require = createRequire(import.meta.url);
+    const qrModule = require("qr-code-styling");
+    const jsdomModule = require("jsdom");
+    const resvgModule = require("@resvg/resvg-js");
+    const pngModule = require("pngjs");
+    return {
+        QRCodeStyling: "default" in qrModule && qrModule.default
+            ? qrModule.default
+            : qrModule,
+        JSDOM: jsdomModule.JSDOM,
+        Resvg: resvgModule.Resvg,
+        PNG: pngModule.PNG,
+    };
+}
+function ansiColor(channel, red, green, blue) {
+    return "\u001b[" + channel + ";2;" + red + ";" + green + ";" + blue + "m";
+}
+function pixelAt(image, x, y) {
+    const offset = (y * image.width + x) * 4;
+    return [
+        image.data[offset] ?? 255,
+        image.data[offset + 1] ?? 255,
+        image.data[offset + 2] ?? 255,
+        image.data[offset + 3] ?? 255,
+    ];
+}
+function isBackground([red, green, blue, alpha]) {
+    return alpha < 16 || (red > 248 && green > 248 && blue > 248);
+}
+function cropToQrContent(image) {
+    let left = image.width;
+    let top = image.height;
+    let right = -1;
+    let bottom = -1;
+    for (let y = 0; y < image.height; y += 1) {
+        for (let x = 0; x < image.width; x += 1) {
+            if (!isBackground(pixelAt(image, x, y))) {
+                left = Math.min(left, x);
+                top = Math.min(top, y);
+                right = Math.max(right, x);
+                bottom = Math.max(bottom, y);
+            }
+        }
+    }
+    if (right < left || bottom < top)
+        return image;
+    const padding = Math.max(3, Math.round(Math.min(image.width, image.height) * 0.02));
+    const cropLeft = Math.max(0, left - padding);
+    const cropTop = Math.max(0, top - padding);
+    const cropRight = Math.min(image.width - 1, right + padding);
+    const cropBottom = Math.min(image.height - 1, bottom + padding);
+    const width = cropRight - cropLeft + 1;
+    const height = cropBottom - cropTop + 1;
+    const data = new Uint8Array(width * height * 4);
+    for (let y = 0; y < height; y += 1) {
+        for (let x = 0; x < width; x += 1) {
+            const source = ((cropTop + y) * image.width + cropLeft + x) * 4;
+            const target = (y * width + x) * 4;
+            data[target] = image.data[source] ?? 255;
+            data[target + 1] = image.data[source + 1] ?? 255;
+            data[target + 2] = image.data[source + 2] ?? 255;
+            data[target + 3] = image.data[source + 3] ?? 255;
+        }
+    }
+    return { width, height, data };
+}
+function renderRasterInTerminal(image) {
+    const columns = Math.max(35, Math.min(72, terminalWidth() - 8));
+    const scale = image.width / columns;
+    const rows = Math.ceil(image.height / scale / 2);
+    const lines = [];
+    const whiteBackground = ansiColor("48", 255, 255, 255);
+    const reset = "\u001b[0m";
+    for (let row = 0; row < rows; row += 1) {
+        const topY = Math.min(image.height - 1, Math.floor(row * 2 * scale));
+        const bottomY = Math.min(image.height - 1, Math.floor((row * 2 + 1) * scale));
+        let line = whiteBackground;
+        for (let column = 0; column < columns; column += 1) {
+            const x = Math.min(image.width - 1, Math.floor(column * scale));
+            const top = pixelAt(image, x, topY);
+            const bottom = pixelAt(image, x, bottomY);
+            const topBackground = isBackground(top);
+            const bottomBackground = isBackground(bottom);
+            if (topBackground && bottomBackground) {
+                line += " ";
+            }
+            else if (!topBackground && bottomBackground) {
+                line +=
+                    ansiColor("38", top[0], top[1], top[2]) +
+                        ansiColor("48", 255, 255, 255) +
+                        "▀";
+            }
+            else if (topBackground && !bottomBackground) {
+                line +=
+                    ansiColor("38", bottom[0], bottom[1], bottom[2]) +
+                        ansiColor("48", 255, 255, 255) +
+                        "▄";
+            }
+            else {
+                line +=
+                    ansiColor("38", top[0], top[1], top[2]) +
+                        ansiColor("48", bottom[0], bottom[1], bottom[2]) +
+                        "▀";
+            }
+        }
+        lines.push(line + reset);
+    }
+    return lines.join("\n");
+}
+/**
+ * Generate the QR with qr-code-styling itself, exactly like the WISA renderer.
+ * The SVG is then rasterized only to make the library's real rounded shapes
+ * displayable in a normal terminal; no QR modules are recreated by LynxShip.
+ */
+export async function renderTerminalQr(data) {
+    const { QRCodeStyling, JSDOM, Resvg, PNG } = await loadDependencies();
+    const qrCode = new QRCodeStyling({
+        jsdom: JSDOM,
+        data,
+        ...LYNXSHIP_QR_STYLE,
+    });
+    const svg = await qrCode.getRawData("svg");
+    if (!svg)
+        throw new Error("qr-code-styling returned no SVG data");
+    const svgText = Buffer.isBuffer(svg)
+        ? svg.toString("utf8")
+        : new TextDecoder().decode(svg);
+    // jsdom serializes SVG references as url('#id'). Normalize only those
+    // references for resvg; the SVG generated by qr-code-styling is unchanged
+    // for browsers and for the file returned by the library.
+    const rasterSvg = svgText.replaceAll("url('#", "url(#").replaceAll("')", ")");
+    const png = new Resvg(rasterSvg).render().asPng();
+    const image = cropToQrContent(PNG.sync.read(Buffer.from(png)));
+    return renderRasterInTerminal(image);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynxship/cli",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Build, sign, store, submit and update LynxJS applications from the terminal.",
   "type": "module",
   "license": "MIT",
@@ -68,14 +68,19 @@
     "cli-progress": "3.12.0",
     "ora": "8.2.0",
     "qrcode-terminal": "0.12.0",
+    "qr-code-styling": "1.9.2",
+    "@resvg/resvg-js": "2.6.2",
+    "jsdom": "29.1.1",
+    "pngjs": "7.0.0",
     "@lynxship/build-orchestrator": "0.1.0",
-    "@lynxship/contracts": "0.1.0",
     "@lynxship/db": "0.1.0",
-    "@lynxship/submit": "0.1.0",
-    "@lynxship/signing": "0.1.0"
+    "@lynxship/contracts": "0.1.0",
+    "@lynxship/signing": "0.1.0",
+    "@lynxship/submit": "0.1.0"
   },
   "devDependencies": {
     "@types/cli-progress": "3.11.6",
+    "@types/pngjs": "6.0.4",
     "@types/qrcode-terminal": "0.12.2"
   },
   "scripts": {