@nativescript/vite 8.0.0-alpha.7 → 8.0.0-alpha.70

package/README.md

@@ -45,23 +45,16 @@ npx nativescript-vite init
 This will:
 
 - Generate a `vite.config.ts` using the detected project flavor (Angular, Vue, React, Solid, TypeScript, or JavaScript) and the corresponding helper subpath from `@nativescript/vite`.
-- Add (or update) the following npm scripts in your app `package.json`:
-	- `dev:ios`
-	- `dev:android`
-	- `dev:server:ios`
-	- `dev:server:android`
-	- `ios`
-	- `android`
-- Add the devDependencies `concurrently` and `wait-on`.
 - Add the dependency `@valor/nativescript-websockets`.
 - Append `.ns-vite-build` to `.gitignore` if it is not already present.
 
-After running `init`, you now have two ways to work with Vite:
+After running `init`, you have two ways to work with Vite:
 
-1. HMR workflow
+1. HMR workflow (default — the CLI starts the dev server for you)
 
 ```bash
-npm run dev:ios
+ns debug ios
+ns debug android
 ```
 
 2. Standard dev workflow (non-HMR)
@@ -71,6 +64,53 @@ ns debug ios --no-hmr
 ns debug android --no-hmr
 ```
 
+### Android: automatic `adb reverse`
+
+For Android HMR the CLI automatically runs `adb reverse tcp:5173 tcp:5173`
+(using the SDK-resolved adb, scoped to the deploy target, after the device is
+ready) so the device reaches the dev server through the ADB tunnel at
+`127.0.0.1:5173`. Relevant opt-outs:
+
+- `NS_HMR_NO_ADB_REVERSE=1` — skip the tunnel and use `10.0.2.2`.
+- `NS_HMR_PREFER_LAN_HOST=1` — physical device over Wi-Fi; emit the host's LAN IP.
+- `NS_HMR_HOST=<host[:port]>` — point the device at an explicit origin (CI / tunnels).
+
+## Custom HMR sessions
+
+A NativeScript Vite HMR session may use custom server and staging settings:
+
+| Environment variable | Purpose | Default |
+| --- | --- | --- |
+| `NS_HMR_PORT` | Vite server port used by the generated device HTTP and websocket URLs (the CLI reverses and probes this port) | `5173` |
+| `NS_VITE_DIST_DIR` | Project-relative staging directory used for Vite output before the NativeScript CLI copies it into the platform app | `.ns-vite-build` |
+
+Leave both unset for the standard single-session workflow.
+
+### Running two platforms at once
+
+The CLI runs **one dev server per port**. To run iOS and Android HMR
+simultaneously for the same app, give each its own port and staging dir so the
+servers and their platform-specific bundles don't collide:
+
+```bash
+# Terminal 1: iOS
+NS_HMR_PORT=5173 NS_VITE_DIST_DIR=.ns-vite-build/ios ns debug ios
+
+# Terminal 2: Android
+NS_HMR_PORT=5174 NS_VITE_DIST_DIR=.ns-vite-build/android ns debug android
+```
+
+The environment settings only need to be visible to the `ns` process — the CLI
+propagates them to the dev server it spawns. The inline environment syntax
+above is for POSIX shells; use the equivalent assignment on Windows.
+
+### Advanced: running `vite serve` yourself
+
+The dev server is just `vite serve -- --env.<platform> --env.hmr`. You can run
+it standalone for diagnostics, but do **not** run it alongside `ns run`/`ns debug`
+for the same platform — both would try to bind the same port. CLI-managed is the
+supported default.
+
 ## Usage
 
 1) Create `vite.config.ts`:

package/bin/cli.cjs

@@ -2,25 +2,19 @@
 
 // Small CommonJS launcher that forwards to the ESM library's init helper.
 // This allows `npx @nativescript/vite init` to work reliably across npm versions.
+// The package is ESM-only (no dist/index.cjs); the init entry lives at
+// `../helpers/init.js` relative to this file in both the source tree and the
+// published `dist/packages/vite` layout.
 
 (async () => {
   try {
-    const mod = await import('../dist/index.cjs').catch(async () => import('../index.js'));
     if (process.argv[2] === 'init') {
-      if (typeof mod.runInit === 'function') {
-        await mod.runInit();
-      } else if (mod && mod.helpers && typeof mod.helpers.runInit === 'function') {
-        await mod.helpers.runInit();
-      } else if (mod && mod.default && typeof mod.default.runInit === 'function') {
-        await mod.default.runInit();
+      const { runInit } = await import('../helpers/init.js');
+      if (typeof runInit === 'function') {
+        await runInit();
       } else {
-        const initMod = await import('../helpers/init.js');
-        if (typeof initMod.runInit === 'function') {
-          await initMod.runInit();
-        } else {
-          console.error('[@nativescript/vite] `runInit` not found in helpers.');
-          process.exitCode = 1;
-        }
+        console.error('[@nativescript/vite] `runInit` not found in helpers/init.js.');
+        process.exitCode = 1;
       }
     } else {
       console.log('Usage: npx @nativescript/vite init');

package/configuration/angular.d.ts

@@ -1,4 +1,37 @@
 import { type UserConfig } from 'vite';
-export declare const angularConfig: ({ mode }: {
+/**
+ * File replacement entry forwarded to `@analogjs/vite-plugin-angular`.
+ * `replace` and `with` may be absolute paths or paths relative to
+ * `workspaceRoot` (when supplied). The Analog plugin matches against the
+ * resolved id with `endsWith(replace)`, so absolute paths Just Work in Nx
+ * / pnpm / Rush layouts where the source tree may live above the project
+ * root.
+ */
+export interface AngularFileReplacement {
+    replace: string;
+    with: string;
+    ssr?: string;
+}
+export declare const angularConfig: ({ mode, fileReplacements, workspaceRoot, }: {
     mode: string;
+    /**
+     * Angular CLI–style file replacements (e.g. `environment.ts` →
+     * `environment.stg.ts`) forwarded to `@analogjs/vite-plugin-angular`'s
+     * `replaceFiles` plugin AND to the Angular TypeScript CompilerHost.
+     *
+     * Required for monorepo apps that need configuration-specific
+     * environment files: the Angular host reads source files via its own
+     * file-system layer, so a Vite `resolveId`/`load` plugin alone cannot
+     * swap a `.ts` file for `vite serve` / HMR — the host will still
+     * compile the original source from disk. Passing the list here ensures
+     * the host sees the replacement before TypeScript ever parses the
+     * file, matching how Angular CLI's `fileReplacements` works.
+     */
+    fileReplacements?: AngularFileReplacement[];
+    /**
+     * Workspace root used by `@analogjs/vite-plugin-angular` to resolve
+     * relative `fileReplacements` paths. Absolute paths bypass this.
+     * Defaults to `process.cwd()`.
+     */
+    workspaceRoot?: string;
 }) => UserConfig;