@nativescript/vite 8.0.0-alpha.5 → 8.0.0-alpha.6

package/helpers/global-defines.d.ts

@@ -1,3 +1,56 @@
+/**
+ * alpha.62 follow-up — opt-out flag for the HMR-applying progress
+ * overlay introduced in Round-eleven.3.
+ *
+ * Default: enabled. Set `NS_VITE_PROGRESS_OVERLAY=0` (or `false`) in
+ * the environment to suppress the overlay if a developer finds it
+ * distracting. We accept the same falsy spellings webpack-era tooling
+ * used (`0`, `false`, `off`, `no`) and treat anything else as
+ * enabled-by-default; this avoids surprising users who pass quoted
+ * truthy strings ("1", "true").
+ */
+export declare function isHmrProgressOverlayEnabled(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * alpha.64 — Kickstart-eligibility threshold for the parallel HMR
+ * prefetch (alpha.63's `__nsKickstartHmrPrefetch`).
+ *
+ * Why a threshold exists. The kickstart fetches the SERVER-computed
+ * inverse-dep closure (`evictPaths`) in parallel before V8 starts
+ * its module walk, which is a clean win when the closure size is
+ * close to what V8 will actually re-evaluate on the next import. For
+ * a typical Angular component edit (`*.component.ts` / `.html`) the
+ * closure contains ~5–30 modules and almost all of them sit on the
+ * live forward path from the entry, so fan-out beats sequential
+ * `HttpFetchText` calls by 3–5×.
+ *
+ * The picture inverts for `.ts` files with deep inverse-dep fan-in
+ * (constants files, design-system enums, shared utilities). The
+ * server faithfully reports the entire inverse closure (often
+ * 100–300 importers), but V8's forward walk on re-import only
+ * re-evaluates the ~20–30 modules that sit on the currently-rendered
+ * route's path. The kickstart's parallel wave then over-fetches the
+ * other ~70–270 importers — and Vite's single-threaded transform
+ * pipeline cannot keep up with 16-way concurrent demand, so each
+ * fetch's tail latency balloons (avg `[http-loader][fetch-sync]`
+ * went from 17 ms to 74 ms in the user's repro). Net result: a
+ * "should-be-200ms" HMR cycle becomes 6+ seconds.
+ *
+ * The threshold short-circuits the kickstart when `evictPaths.length`
+ * exceeds the configured cap. The HMR cycle still completes
+ * correctly — V8 falls back to per-module synchronous fetches, which
+ * is what the runtime did before alpha.63 — and the cycle reverts
+ * to roughly the alpha.62 floor (~400–800 ms for a wide-fan-in
+ * constants edit).
+ *
+ * Default: 32. Empirically chosen so component-shaped closures
+ * (typically 5–30) keep the kickstart speed-up while wide-fan-in
+ * leaf edits (typically 100+) skip it. Override with
+ * `NS_VITE_KICKSTART_MAX_URLS=N` (any non-negative integer) — `0`
+ * disables the kickstart entirely; `Infinity` disables the
+ * threshold and restores alpha.63 behavior unconditionally.
+ */
+export declare const HMR_KICKSTART_DEFAULT_MAX_URLS = 32;
+export declare function resolveHmrKickstartMaxUrls(env?: NodeJS.ProcessEnv): number;
 export declare function getGlobalDefines(opts: {
     platform: string;
     targetMode: string;
@@ -14,6 +67,8 @@ export declare function getGlobalDefines(opts: {
     __NS_WEBPACK__: boolean;
     __NS_ENV_VERBOSE__: string;
     __NS_TARGET_FLAVOR__: string;
+    __NS_HMR_PROGRESS_OVERLAY_ENABLED__: string;
+    __NS_HMR_KICKSTART_MAX_URLS__: string;
     __CSS_PARSER__: string;
     __UI_USE_XML_PARSER__: boolean;
     __UI_USE_EXTERNAL_RENDERER__: boolean;

package/helpers/global-defines.js

@@ -1,6 +1,77 @@
 import { getProjectAppPath, getProjectAppVirtualPath } from './utils.js';
 const APP_ROOT_DIR = getProjectAppPath();
 const APP_ROOT_VIRTUAL = getProjectAppVirtualPath();
+/**
+ * alpha.62 follow-up — opt-out flag for the HMR-applying progress
+ * overlay introduced in Round-eleven.3.
+ *
+ * Default: enabled. Set `NS_VITE_PROGRESS_OVERLAY=0` (or `false`) in
+ * the environment to suppress the overlay if a developer finds it
+ * distracting. We accept the same falsy spellings webpack-era tooling
+ * used (`0`, `false`, `off`, `no`) and treat anything else as
+ * enabled-by-default; this avoids surprising users who pass quoted
+ * truthy strings ("1", "true").
+ */
+export function isHmrProgressOverlayEnabled(env = process.env) {
+    const raw = (env.NS_VITE_PROGRESS_OVERLAY ?? '').toString().trim().toLowerCase();
+    if (!raw)
+        return true;
+    return !['0', 'false', 'off', 'no'].includes(raw);
+}
+/**
+ * alpha.64 — Kickstart-eligibility threshold for the parallel HMR
+ * prefetch (alpha.63's `__nsKickstartHmrPrefetch`).
+ *
+ * Why a threshold exists. The kickstart fetches the SERVER-computed
+ * inverse-dep closure (`evictPaths`) in parallel before V8 starts
+ * its module walk, which is a clean win when the closure size is
+ * close to what V8 will actually re-evaluate on the next import. For
+ * a typical Angular component edit (`*.component.ts` / `.html`) the
+ * closure contains ~5–30 modules and almost all of them sit on the
+ * live forward path from the entry, so fan-out beats sequential
+ * `HttpFetchText` calls by 3–5×.
+ *
+ * The picture inverts for `.ts` files with deep inverse-dep fan-in
+ * (constants files, design-system enums, shared utilities). The
+ * server faithfully reports the entire inverse closure (often
+ * 100–300 importers), but V8's forward walk on re-import only
+ * re-evaluates the ~20–30 modules that sit on the currently-rendered
+ * route's path. The kickstart's parallel wave then over-fetches the
+ * other ~70–270 importers — and Vite's single-threaded transform
+ * pipeline cannot keep up with 16-way concurrent demand, so each
+ * fetch's tail latency balloons (avg `[http-loader][fetch-sync]`
+ * went from 17 ms to 74 ms in the user's repro). Net result: a
+ * "should-be-200ms" HMR cycle becomes 6+ seconds.
+ *
+ * The threshold short-circuits the kickstart when `evictPaths.length`
+ * exceeds the configured cap. The HMR cycle still completes
+ * correctly — V8 falls back to per-module synchronous fetches, which
+ * is what the runtime did before alpha.63 — and the cycle reverts
+ * to roughly the alpha.62 floor (~400–800 ms for a wide-fan-in
+ * constants edit).
+ *
+ * Default: 32. Empirically chosen so component-shaped closures
+ * (typically 5–30) keep the kickstart speed-up while wide-fan-in
+ * leaf edits (typically 100+) skip it. Override with
+ * `NS_VITE_KICKSTART_MAX_URLS=N` (any non-negative integer) — `0`
+ * disables the kickstart entirely; `Infinity` disables the
+ * threshold and restores alpha.63 behavior unconditionally.
+ */
+export const HMR_KICKSTART_DEFAULT_MAX_URLS = 32;
+export function resolveHmrKickstartMaxUrls(env = process.env) {
+    const raw = (env.NS_VITE_KICKSTART_MAX_URLS ?? '').toString().trim();
+    if (!raw)
+        return HMR_KICKSTART_DEFAULT_MAX_URLS;
+    const lower = raw.toLowerCase();
+    if (lower === 'infinity' || lower === 'unlimited' || lower === 'none') {
+        return Number.POSITIVE_INFINITY;
+    }
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return HMR_KICKSTART_DEFAULT_MAX_URLS;
+    }
+    return Math.floor(parsed);
+}
 export function getGlobalDefines(opts) {
     return {
         // Define platform flags for runtime checks
@@ -13,6 +84,16 @@ export function getGlobalDefines(opts) {
         __NS_WEBPACK__: false,
         __NS_ENV_VERBOSE__: JSON.stringify(opts.verbose),
         __NS_TARGET_FLAVOR__: JSON.stringify(opts.flavor),
+        // whether to show the HMR in-progress overlay.
+        __NS_HMR_PROGRESS_OVERLAY_ENABLED__: JSON.stringify(isHmrProgressOverlayEnabled()),
+        // alpha.64 — eviction-set size cap for the parallel HMR
+        // kickstart. JSON.stringify(Number.POSITIVE_INFINITY) is the
+        // string "null", so we serialize Infinity ourselves to keep the
+        // build-time literal readable in source maps.
+        __NS_HMR_KICKSTART_MAX_URLS__: (() => {
+            const n = resolveHmrKickstartMaxUrls();
+            return Number.isFinite(n) ? String(n) : 'Infinity';
+        })(),
         __CSS_PARSER__: JSON.stringify('css-tree'),
         __UI_USE_XML_PARSER__: true,
         __UI_USE_EXTERNAL_RENDERER__: false,

package/helpers/global-defines.js.map

@@ -1 +1 @@
-{"version":3,"file":"global-defines.js","sourceRoot":"","sources":["../../../../packages/vite/helpers/global-defines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,YAAY,GAAG,iBAAiB,EAAE,CAAC;AACzC,MAAM,gBAAgB,GAAG,wBAAwB,EAAE,CAAC;AAEpD,MAAM,UAAU,gBAAgB,CAAC,IAAgG;IAChI,OAAO;QACN,2CAA2C;QAC3C,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC;QACxD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC;QAChD,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAC;QAC1D,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAC;QAClF,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,KAAK,aAAa,CAAC;QAC1D,YAAY,EAAE,KAAK;QACnB,cAAc,EAAE,KAAK;QACrB,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;QAChD,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;QACjD,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;QAC1C,qBAAqB,EAAE,IAAI;QAC3B,4BAA4B,EAAE,KAAK;QACnC,yDAAyD;QACzD,QAAQ,EAAE,KAAK;QACf,yCAAyC;QACzC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACnC,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;QACjD,uBAAuB,EAAE,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC;QACzD,2FAA2F;QAC3F,sBAAsB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC;KACxG,CAAC;AACH,CAAC"}
+{"version":3,"file":"global-defines.js","sourceRoot":"","sources":["../../../../packages/vite/helpers/global-defines.ts"],"names":[],"mappings":"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"}

package/helpers/logging.d.ts

@@ -10,4 +10,5 @@ type ResolveOptions = {
 export declare function resolveVerboseFlag(options?: ResolveOptions): boolean;
 export declare function clearVerboseCache(): void;
 export declare function createFilteredViteLogger(): Logger;
+export declare function shouldSuppressViteWarning(msg: string): boolean;
 export {};

package/helpers/logging.js

@@ -72,9 +72,19 @@ export function clearVerboseCache() {
 // expected given NativeScript's virtual vendor bundling strategy.
 // Currently filters:
 //  - Sourcemap missing source files (common in published packages)
+//  - Sourcemap source paths that walk outside the published package (the map
+//    was generated in a monorepo and still references workspace paths the
+//    consumer's node_modules doesn't have)
+//  - Sidecar `.js.map` files listed in a `//# sourceMappingURL=` comment that
+//    were not published alongside the `.js` file
 //  - Eval usage attributed to the virtual "@nativescript/vendor" module
 //  - License/annotation position warnings for the vendor bundle
+//  - Analog Angular optimizer/router plugins that never emit sourcemaps
 // Extend this list cautiously; prefer documenting each suppression reason.
+//
+// All matching uses `.includes()` (never `.startsWith()`) because Vite wraps
+// some warnings in picocolors ANSI escape sequences before handing them to
+// the logger, which would defeat `startsWith`-style probes on TTY output.
 export function createFilteredViteLogger() {
     const baseLogger = createLogger(undefined, { allowClearScreen: true });
     return {
@@ -93,9 +103,32 @@ export function createFilteredViteLogger() {
         },
     };
 }
-function shouldSuppressViteWarning(msg) {
-    // Missing sourcemap original sources
-    if (msg.startsWith('Sourcemap for ') && msg.includes('missing source files')) {
+// Exported for unit tests. Keep this function pure so the test suite can
+// exercise every suppression pattern without instantiating a real logger.
+export function shouldSuppressViteWarning(msg) {
+    // Missing sourcemap original sources (kept as-is — published packages
+    // frequently drop a few `sources[n]` entries during transpile).
+    if (msg.includes('Sourcemap for ') && msg.includes('missing source files')) {
+        return true;
+    }
+    // Cross-package sourcemap path. Emitted for every `@nativescript/core`
+    // file at dev-server startup when the consumer has the published
+    // package installed: the shipped `.js.map` still references the
+    // original monorepo `packages/core/**` path, which does not exist in
+    // the consumer's node_modules. There is nothing we (or the app
+    // author) can do about this short of republishing core with relative
+    // sources — silently dropping it is correct.
+    if (msg.includes('Sourcemap for ') && msg.includes('points to a source file outside its package')) {
+        return true;
+    }
+    // Missing sidecar .js.map file. A couple of community packages
+    // (e.g. `@nativescript-community/observable`) ship the `.js` with a
+    // `//# sourceMappingURL=foo.js.map` footer but never include the
+    // actual map. Vite's sourcemap loader then retries the ENOENT on
+    // every request, flooding the terminal. We cannot resolve the
+    // missing file, so suppressing the warn-level diagnostic is the
+    // least invasive fix.
+    if (msg.includes('Failed to load source map for')) {
         return true;
     }
     // Vendor eval usage (third-party libs aggregated); benign

package/helpers/logging.js.map

@@ -1 +1 @@
-{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../../../packages/vite/helpers/logging.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../../../packages/vite/helpers/logging.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,MAAM,CAAC;AAEjD,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AACjD,MAAM,gBAAgB,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;AAYpH,IAAI,aAAkC,CAAC;AAEvC,SAAS,aAAa,CAAC,KAAgB;IACtC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,KAAK,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACnE,OAAO,IAAI,CAAC;QACb,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAA0B,EAAE;IAC9D,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,IAAI,OAAO,aAAa,KAAK,SAAS,EAAE,CAAC;QACnE,OAAO,aAAa,CAAC;IACtB,CAAC;IAED,MAAM,EAAE,GAAG,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7F,IAAI,QAA6B,CAAC;IAElC,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,OAAO,UAAU,KAAK,SAAS,EAAE,CAAC;YACrC,QAAQ,GAAG,UAAU,CAAC;QACvB,CAAC;IACF,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;QAC/D,IAAI,CAAC;YACJ,MAAM,aAAa,GAAI,UAAkB,EAAE,CAAC,mBAAmB,CAAC,CAAC;YACjE,MAAM,OAAO,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;YAC7C,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;gBAClC,QAAQ,GAAG,OAAO,CAAC;YACpB,CAAC;QACF,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACX,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,IAAI,GAAG,EAAE,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;YACpC,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBACpD,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC3C,IAAI,OAAO,UAAU,KAAK,SAAS,EAAE,CAAC;oBACrC,QAAQ,GAAG,UAAU,CAAC;oBACtB,MAAM;gBACP,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,QAAQ,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QAC7B,aAAa,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAChC,aAAa,GAAG,SAAS,CAAC;AAC3B,CAAC;AAED,oCAAoC;AACpC,4EAA4E;AAC5E,kEAAkE;AAClE,qBAAqB;AACrB,mEAAmE;AACnE,6EAA6E;AAC7E,0EAA0E;AAC1E,2CAA2C;AAC3C,8EAA8E;AAC9E,iDAAiD;AACjD,wEAAwE;AACxE,gEAAgE;AAChE,wEAAwE;AACxE,2EAA2E;AAC3E,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,0EAA0E;AAC1E,MAAM,UAAU,wBAAwB;IACvC,MAAM,UAAU,GAAG,YAAY,CAAC,SAAS,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,OAAO;QACN,GAAG,UAAU;QACb,IAAI,CAAC,OAAY,EAAE,OAAa;YAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAClC,IAAI,yBAAyB,CAAC,GAAG,CAAC;gBAAE,OAAO;YAC3C,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;QACD,QAAQ,CAAC,OAAY;YACpB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAClC,IAAI,yBAAyB,CAAC,GAAG,CAAC;gBAAE,OAAO;YAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;KACD,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,0EAA0E;AAC1E,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACpD,sEAAsE;IACtE,gEAAgE;IAChE,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAC;IACb,CAAC;IACD,uEAAuE;IACvE,iEAAiE;IACjE,gEAAgE;IAChE,qEAAqE;IACrE,+DAA+D;IAC/D,qEAAqE;IACrE,6CAA6C;IAC7C,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,6CAA6C,CAAC,EAAE,CAAC;QACnG,OAAO,IAAI,CAAC;IACb,CAAC;IACD,+DAA+D;IAC/D,oEAAoE;IACpE,iEAAiE;IACjE,iEAAiE;IACjE,8DAA8D;IAC9D,gEAAgE;IAChE,sBAAsB;IACtB,IAAI,GAAG,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC;IACb,CAAC;IACD,0DAA0D;IAC1D,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC;QACrH,OAAO,IAAI,CAAC;IACb,CAAC;IACD,wDAAwD;IACxD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,qDAAqD,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC;QAC1M,OAAO,IAAI,CAAC;IACb,CAAC;IACD,kGAAkG;IAClG,IAAI,GAAG,CAAC,QAAQ,CAAC,qCAAqC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,8BAA8B,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,yCAAyC,CAAC,CAAC,EAAE,CAAC;QACtK,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/hmr/client/hmr-pending-overlay.d.ts

@@ -0,0 +1,27 @@
+/**
+ * alpha.62 follow-up — client-side helper for `ns:hmr-pending`.
+ *
+ * Server emits `ns:hmr-pending` immediately when `handleHotUpdate`
+ * fires, BEFORE doing any graph upserts / transforms / dependency
+ * analysis. The client uses that hint to drive the HMR-applying
+ * overlay's 'received' frame so the user sees an instant reaction
+ * to their save instead of waiting ~7–200ms for the framework
+ * payload (`ns:angular-update` / `ns:css-updates`) to arrive.
+ *
+ * This module is intentionally a tiny pure helper so the gating
+ * (`__NS_HMR_PROGRESS_OVERLAY_ENABLED__`) and detail-string formatting
+ * can be unit-tested without booting the full HMR client.
+ */
+export type HmrOverlayApiLike = {
+    setUpdateStage?: (stage: string, info?: {
+        detail?: string;
+    }) => unknown;
+} | null | undefined;
+export type HmrPendingHandlerDeps = {
+    /** Resolves the live overlay API. Returning null/undefined is treated as "no overlay installed". */
+    getOverlay: () => HmrOverlayApiLike;
+    /** Override the build-time gate for testing. Defaults to reading `__NS_HMR_PROGRESS_OVERLAY_ENABLED__` (or `true` when undefined). */
+    overlayEnabled?: boolean;
+};
+export declare function buildHmrPendingDetail(filePath: string | undefined): string;
+export declare function applyHmrPendingFrame(filePath: string | undefined, deps: HmrPendingHandlerDeps): boolean;

package/hmr/client/hmr-pending-overlay.js

@@ -0,0 +1,50 @@
+/**
+ * alpha.62 follow-up — client-side helper for `ns:hmr-pending`.
+ *
+ * Server emits `ns:hmr-pending` immediately when `handleHotUpdate`
+ * fires, BEFORE doing any graph upserts / transforms / dependency
+ * analysis. The client uses that hint to drive the HMR-applying
+ * overlay's 'received' frame so the user sees an instant reaction
+ * to their save instead of waiting ~7–200ms for the framework
+ * payload (`ns:angular-update` / `ns:css-updates`) to arrive.
+ *
+ * This module is intentionally a tiny pure helper so the gating
+ * (`__NS_HMR_PROGRESS_OVERLAY_ENABLED__`) and detail-string formatting
+ * can be unit-tested without booting the full HMR client.
+ */
+export function buildHmrPendingDetail(filePath) {
+    if (!filePath || filePath === '<unknown>')
+        return 'Preparing update';
+    return `Updating ${filePath}`;
+}
+export function applyHmrPendingFrame(filePath, deps) {
+    const enabled = typeof deps.overlayEnabled === 'boolean'
+        ? deps.overlayEnabled
+        : (() => {
+            try {
+                return typeof __NS_HMR_PROGRESS_OVERLAY_ENABLED__ === 'boolean' ? __NS_HMR_PROGRESS_OVERLAY_ENABLED__ : true;
+            }
+            catch {
+                return true;
+            }
+        })();
+    if (!enabled)
+        return false;
+    let api;
+    try {
+        api = deps.getOverlay();
+    }
+    catch {
+        return false;
+    }
+    if (!api || typeof api.setUpdateStage !== 'function')
+        return false;
+    try {
+        api.setUpdateStage('received', { detail: buildHmrPendingDetail(filePath) });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=hmr-pending-overlay.js.map

package/hmr/client/hmr-pending-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr-pending-overlay.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/client/hmr-pending-overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAkBH,MAAM,UAAU,qBAAqB,CAAC,QAA4B;IACjE,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,WAAW;QAAE,OAAO,kBAAkB,CAAC;IACrE,OAAO,YAAY,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAA4B,EAAE,IAA2B;IAC7F,MAAM,OAAO,GACZ,OAAO,IAAI,CAAC,cAAc,KAAK,SAAS;QACvC,CAAC,CAAC,IAAI,CAAC,cAAc;QACrB,CAAC,CAAC,CAAC,GAAG,EAAE;YACN,IAAI,CAAC;gBACJ,OAAO,OAAO,mCAAmC,KAAK,SAAS,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9G,CAAC;YAAC,MAAM,CAAC;gBACR,OAAO,IAAI,CAAC;YACb,CAAC;QACF,CAAC,CAAC,EAAE,CAAC;IACR,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,GAAsB,CAAC;IAC3B,IAAI,CAAC;QACJ,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACnE,IAAI,CAAC;QACJ,GAAG,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC"}

package/hmr/client/index.js

@@ -5,7 +5,7 @@
  * Always resolve core classes and Application from the vendor realm or globalThis at runtime.
  * The HMR client is evaluated via HTTP ESM on device; static imports would create secondary instances.
  */
-import { setHMRWsUrl, getHMRWsUrl, pendingModuleFetches, deriveHttpOrigin, setHttpOriginForVite, moduleFetchCache, requestModuleFromServer, getHttpOriginForVite, normalizeSpec, hmrMetrics, graph, setGraphVersion, getGraphVersion, getCurrentApp, getRootFrame, setCurrentApp, setRootFrame, getCore } from './utils.js';
+import { setHMRWsUrl, getHMRWsUrl, pendingModuleFetches, deriveHttpOrigin, setHttpOriginForVite, moduleFetchCache, requestModuleFromServer, getHttpOriginForVite, normalizeSpec, hmrMetrics, graph, setGraphVersion, getGraphVersion, getCurrentApp, getRootFrame, setCurrentApp, setRootFrame, getCore, hasExplicitEviction, invalidateModulesByUrls, buildEvictionUrls, emitHmrModeBannerOnce } from './utils.js';
 import { handleCssUpdates } from './css-handler.js';
 const VERBOSE = typeof __NS_ENV_VERBOSE__ !== 'undefined' && __NS_ENV_VERBOSE__;
 function resolveTargetFlavor() {
@@ -101,6 +101,23 @@ function hideConnectionOverlay() {
     }
     catch { }
 }
+// alpha.62 follow-up — Eagerly drive the HMR-applying overlay's
+// 'received' frame as soon as the server emits `ns:hmr-pending`,
+// BEFORE the framework-specific (`ns:angular-update` /
+// `ns:css-updates`) payload arrives. The flavor-specific handler
+// later walks through 'evicting' → 'reimporting' → 'rebooting' →
+// 'complete'. Calling 'received' twice in the same cycle is safe:
+// the overlay preserves `updateCycleStartedAt` when a 'received'
+// frame replaces an existing 'received' frame so the
+// minimum-visible window is still timed against the FIRST frame.
+//
+// Soft-fails when the overlay isn't installed (production builds,
+// vitest, etc.) or when the user opted out via
+// `__NS_HMR_PROGRESS_OVERLAY_ENABLED__ === false`.
+import { applyHmrPendingFrame } from './hmr-pending-overlay.js';
+function setHmrPendingOverlay(filePath) {
+    applyHmrPendingFrame(filePath, { getOverlay: getHmrOverlayApi });
+}
 let connectionOverlayTimer = null;
 let connectionOverlayVisible = false;
 let hasOpenedHmrSocket = false;
@@ -810,6 +827,25 @@ async function processQueue() {
                 return;
             if (VERBOSE)
                 console.log('[hmr][queue] processing changed ids', drained);
+            // alpha.59 — Explicit eviction step.
+            //
+            // On alpha.59+ runtimes the URL canonicalizer collapses any
+            // `__ns_hmr__/<tag>/` segment back to a stable cache key, so
+            // without explicit eviction the upcoming `import(url)` would
+            // resolve via V8's `g_moduleRegistry` and return the cached
+            // stale module — making the queue drain a silent no-op for
+            // every save after the first.
+            //
+            // We hand the canonical eviction URLs to the runtime first;
+            // `invalidateModulesByUrls` is a no-op on older runtimes and
+            // `requestModuleFromServer` automatically falls back to the
+            // legacy `/ns/m/__ns_hmr__/v<N>/` URL versioning path in that
+            // case. node_modules and virtual specs are filtered out by
+            // `buildEvictionUrls` so vendor modules stay hot.
+            const evictUrls = buildEvictionUrls(drained);
+            const evicted = invalidateModulesByUrls(evictUrls);
+            if (VERBOSE)
+                console.log(`[hmr][queue] eviction count=${evictUrls.length} ok=${evicted}`);
             // Evaluate changed modules best-effort; failures shouldn't completely break HMR.
             for (const id of drained) {
                 try {
@@ -924,6 +960,15 @@ async function processQueue() {
                             }
                             return null;
                         };
+                        // alpha.59 — Evict the boundary set so re-importing
+                        // each .tsx component actually picks up the new
+                        // transitive dependency code; without this V8 returns
+                        // the cached boundary module unchanged.
+                        const boundaryIds = Array.from(boundaries);
+                        const solidEvictUrls = buildEvictionUrls(boundaryIds);
+                        const solidEvicted = invalidateModulesByUrls(solidEvictUrls);
+                        if (VERBOSE)
+                            console.log(`[hmr][solid] eviction count=${solidEvictUrls.length} ok=${solidEvicted}`);
                         for (const id of boundaries) {
                             if (seen.has(id))
                                 continue;
@@ -1274,6 +1319,13 @@ function connectHmr() {
                     showConnectionOverlayNow('synchronizing', 'Connected. Synchronizing the HMR graph.');
                 }
                 VERBOSE && console.log('[hmr-client] Connected to HMR WebSocket');
+                // alpha.59 — Print the active module reload mode once on first
+                // successful connect so the user can correlate HMR latency with
+                // runtime capability without grepping for protocol details.
+                try {
+                    emitHmrModeBannerOnce();
+                }
+                catch { }
             };
             sock.onmessage = handleHmrMessage;
             sock.onerror = (error) => {
@@ -1333,6 +1385,17 @@ async function handleHmrMessage(ev) {
         catch { }
     }
     if (msg) {
+        // alpha.62 follow-up — `ns:hmr-pending` is a fire-and-forget
+        // UX hint emitted by the server at the START of handleHotUpdate.
+        // We drive the HMR-applying overlay's 'received' frame here
+        // (synchronously), well before the authoritative payload
+        // (`ns:angular-update` / `ns:css-updates`) lands. Skip running
+        // any other handlers — the pending message has no module
+        // payload and intentionally does not bump the graph version.
+        if (msg.type === 'ns:hmr-pending' && typeof msg.path === 'string') {
+            setHmrPendingOverlay(msg.path);
+            return;
+        }
         if (msg.type === 'ns:hmr-full-graph') {
             // Bump a monotonic nonce so HTTP ESM imports can always be cache-busted per update.
             try {
@@ -1402,6 +1465,14 @@ async function handleHmrMessage(ev) {
                 });
                 if (toReimport.length && VERBOSE)
                     console.log('[hmr][full-graph] inferred changed modules; re-importing', toReimport);
+                // alpha.59 — Evict the inferred changed set before re-importing.
+                // See `processQueue` for the architectural rationale; the
+                // full-graph code path is the resync fallback (server chose
+                // not to send a delta) and shares the same V8 cache pitfall.
+                const fgEvictUrls = buildEvictionUrls(toReimport);
+                const fgEvicted = invalidateModulesByUrls(fgEvictUrls);
+                if (VERBOSE)
+                    console.log(`[hmr][full-graph] eviction count=${fgEvictUrls.length} ok=${fgEvicted}`);
                 for (const id of toReimport) {
                     try {
                         const spec = normalizeSpec(id);