feat(bundler): vite build/prepare + dx improvements

[NathanWalker]

• improvements to the NativeScript CLI's Vite HMR workflow, focusing on reliability, developer experience, and automation. The CLI now fully manages the Vite dev server lifecycle and the Android adb reverse port forwarding needed for HMR, eliminating the need for developers to manually coordinate these steps or use external tooling. It also ensures that Vite build outputs are always correctly copied to the platform destination, fixing prior issues with missing or stale bundles.

Summary by CodeRabbit

• New Features
  • Enabled Android Vite HMR via automatic device-to-host tunneling during initial sync, and re-established the mapping before app launch.
  • Added long-lived Vite dev-server support in watch mode, including readiness checks and initial artifact copying.
• Bug Fixes
  • Improved reliability of Vite dist/output handling and made adb reverse setup best-effort with verification and safe fallbacks.
• Documentation
  • Documented the Vite dist folder naming/override behavior used for platform output copying.
• Chores
  • Bumped version to 9.1.0-alpha.12.

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: d0a0436a-3bfa-4d60-875e-9916b26366cf

📥 Commits

Reviewing files that changed from the base of the PR and between 37019bb and 201d547.

⛔ Files ignored due to path filters (1)

• package-lock.json is excluded by !**/package-lock.json

📒 Files selected for processing (6)

• lib/constants.ts
• lib/controllers/run-controller.ts
• lib/services/bundler/bundler-compiler-service.ts
• package.json
• test/controllers/run-controller.ts
• test/services/bundler/bundler-compiler-service.ts

🚧 Files skipped from review as they are similar to previous changes (6)

• package.json
• lib/controllers/run-controller.ts
• lib/services/bundler/bundler-compiler-service.ts
• test/services/bundler/bundler-compiler-service.ts
• lib/constants.ts
• test/controllers/run-controller.ts

---

📝 Walkthrough

Walkthrough

Adds Vite HMR support with Vite output path handling, dev-server lifecycle management, Android adb reverse wiring, related tests, and a package version bump.

Changes

Vite HMR: constant, bundler service, and run controller

Layer / File(s)	Summary
VITE_DIST_FOLDER_NAME and dist path resolution lib/constants.ts, lib/services/bundler/bundler-compiler-service.ts, test/services/bundler/bundler-compiler-service.ts	Exports VITE_DIST_FOLDER_NAME = ".ns-vite-build", adds getViteDistOutputPath() using NS_VITE_DIST_DIR or the constant, and updates Vite output path references to use that helper. Minor formatting updates in constants.ts are included, along with tests for the default and overridden dist paths.
Vite dev server lifecycle in BundlerCompilerService lib/services/bundler/bundler-compiler-service.ts, test/services/bundler/bundler-compiler-service.ts	Adds viteServeProcesses, starts vite serve during compileWithWatch, probes TCP readiness, copies Vite output into native app destinations on successful non-watch builds, and stops the managed Vite process in stopBundlerForPlatform. Tests verify watch emission behavior.
RunController adb reverse HMR wiring lib/controllers/run-controller.ts, test/controllers/run-controller.ts	Injects staticConfig into RunController, runs Android Vite HMR reverse setup before prepare and before launch, and adds helpers for HMR port resolution, env-flag parsing, bounded adb reverse execution, and reverse verification. Tests add the new injector stub and keep the existing watch/stop assertions.
BundlerCompilerService tests test/services/bundler/bundler-compiler-service.ts	Adds logger and cleanupService stubs, covers getViteDistOutputPath for default and overridden paths, and verifies compileWithWatch event emission behavior across initial and incremental Vite builds.
RunController tests and wiring stubs test/controllers/run-controller.ts	Registers a staticConfig test stub, reformats mockDevicesService and test case literals, and preserves the existing watch-mode and stop-mode assertions.

Package version bump

Layer / File(s)	Summary
Version bump to 9.1.0-alpha.12 package.json	Changes the version field in package.json.

Estimated code review effort: 4 (Complex) | ~60 minutes

Suggested reviewers: triniwiz

Poem

🐇 I hop through Vite’s bright new light,
with adb tunnels snug and tight.
Dist paths dance and builds sing clear,
.ns-vite-build is now right here.
A rabbit grin, a server hum —
the alpha update’s fully done ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title is concise and broadly matches the Vite bundler lifecycle, build output, and DX improvements in the changeset.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}