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

package/hmr/shared/runtime/boot-progress.js

@@ -0,0 +1,134 @@
+import { getGlobalScope } from './global-scope.js';
+// Pure helpers for the cold-boot "Importing the app entry" progress display.
+//
+// Pipeline:
+//   * Server-side `buildBootProgressSnippet` is injected at the top of
+//     every served app module and bumps the count / last-module globals
+//     while `__NS_HMR_BOOT_COMPLETE__` is falsy (self-gating — the
+//     snippet no-ops after boot; FULLY SYNCHRONOUS — see the snippet
+//     doc for why top-level await must stay out of served modules).
+//   * `startBrowserRuntimeSession` stamps the time origin
+//     (`__NS_HMR_BOOT_IMPORT_STARTED_AT__`) right before the client +
+//     entry dynamic-import walk.
+//   * `startBootImportHeartbeat` reads both signals every 250 ms and
+//     re-asserts `'importing-main'` so the bar climbs even across long
+//     vendor stretches that don't tick the count axis. The iOS runtime's
+//     `MaybePumpJSThreadDuringBoot` keeps the JS-thread CFRunLoop ticking
+//     between synchronous fetches so the heartbeat's `setInterval` timer
+//     can fire during the cold-boot module walk.
+//
+// Monotonic ratchet (`applyMonotonicBootProgress`,
+// `__NS_HMR_BOOT_LAST_PROGRESS__`): each tick can never undercut the
+// previous one, preventing visible stutter when the count axis briefly
+// wins over the time axis.
+/**
+ * `'importing-main'` is the long HTTP-module-load phase (5–10s for a
+ * real Angular app). The bar uses this range so the user sees ~62
+ * percentage points of motion during the phase that actually takes
+ * time, sandwiched between the cheap bootstrap stages
+ * ('configuring-import-map' = 26) and the post-import wait
+ * ('waiting-for-app' = 94 → 'app-root-committed' = 100).
+ */
+export const BOOT_IMPORT_PROGRESS_MIN = 30;
+export const BOOT_IMPORT_PROGRESS_MAX = 92;
+/** Ceiling guards against rounding into `'waiting-for-app'` (94). */
+export const BOOT_IMPORT_PROGRESS_CEILING = 94;
+const BOOT_IMPORT_PROGRESS_RANGE = BOOT_IMPORT_PROGRESS_MAX - BOOT_IMPORT_PROGRESS_MIN;
+/**
+ * Compute the percentage shown next to "Importing the app entry".
+ *
+ * Sum of two clamped contributions:
+ *   * `progressFromCount` — `__NS_HMR_BOOT_MODULE_COUNT__` bumped by the
+ *     boot snippet (1 unit per 2 modules, cap 40).
+ *   * `progressFromTime` — elapsed wall-clock since
+ *     `__NS_HMR_BOOT_IMPORT_STARTED_AT__` (1 unit per 250 ms, cap
+ *     matches the full 62-point range so time alone can drive the bar
+ *     30 → 92 if the count axis is starved).
+ *
+ * The count axis goes silent in long node_modules stretches and on
+ * Vite's rewrite chains where the served import URL skips the
+ * `__ns_boot__/b1` prefix; the time axis covers those gaps. Both
+ * contributions are summed, clamped to the 62-point range, then
+ * ceilinged so they cannot cross into 'waiting-for-app' (94+).
+ *
+ * Canonical values are pinned by `boot-progress.spec.ts`. The
+ * server-side snippet does NOT mirror this math — it only writes the
+ * counters; the heartbeat in `session-bootstrap.ts` is the sole caller.
+ */
+const BOOT_IMPORT_COUNT_CONTRIBUTION_MAX = 40;
+const BOOT_IMPORT_TIME_CONTRIBUTION_MAX = 62;
+const BOOT_IMPORT_COUNT_DIVISOR = 2;
+const BOOT_IMPORT_TIME_TICK_MS = 250;
+export function computeBootImportProgress(input) {
+    // Coerce NaN / ±Infinity / negatives to 0 — `Math.max(0, NaN)` is NaN.
+    const rawCount = Number(input?.count ?? 0);
+    const rawElapsed = Number(input?.elapsedMs ?? 0);
+    const count = Number.isFinite(rawCount) ? Math.max(0, rawCount) : 0;
+    const elapsedMs = Number.isFinite(rawElapsed) ? Math.max(0, rawElapsed) : 0;
+    const progressFromCount = Math.min(BOOT_IMPORT_COUNT_CONTRIBUTION_MAX, Math.floor(count / BOOT_IMPORT_COUNT_DIVISOR));
+    const progressFromTime = Math.min(BOOT_IMPORT_TIME_CONTRIBUTION_MAX, Math.floor(elapsedMs / BOOT_IMPORT_TIME_TICK_MS));
+    const combined = BOOT_IMPORT_PROGRESS_MIN + Math.min(BOOT_IMPORT_PROGRESS_RANGE, progressFromCount + progressFromTime);
+    return Math.min(BOOT_IMPORT_PROGRESS_CEILING, combined);
+}
+/**
+ * Render the second-line detail for the placeholder. Surfaces the
+ * count + last-loaded module path once the snippet has fired, or a
+ * generic "Loading the module graph…" line during the pre-snippet
+ * window.
+ *
+ * No elapsed-ms readout: the primary line's percentage is the progress
+ * signal, and the heartbeat's `elapsedMs` is wall-clock since the import
+ * started — not a per-module timing — so surfacing it next to the
+ * percentage read as a confusing, inaccurate duration.
+ */
+export function formatBootImportDetail(input) {
+    const count = Math.max(0, Number(input?.count ?? 0));
+    const lastModule = typeof input?.lastModule === 'string' ? input.lastModule : '';
+    if (count > 0) {
+        return lastModule ? `Evaluated ${count} modules\n${lastModule}` : `Evaluated ${count} modules`;
+    }
+    return 'Loading the module graph…';
+}
+/**
+ * Ratchet a candidate boot-import progress value against the highest
+ * value any consumer has emitted so far (stored on
+ * `globalThis.__NS_HMR_BOOT_LAST_PROGRESS__`). Reset by
+ * `clearBootProgressState` between sessions.
+ */
+export function applyMonotonicBootProgress(candidate) {
+    const g = getGlobalScope();
+    const previousRaw = g.__NS_HMR_BOOT_LAST_PROGRESS__;
+    const previous = typeof previousRaw === 'number' && Number.isFinite(previousRaw) ? previousRaw : 0;
+    const next = Math.max(previous, Math.max(0, Number(candidate) || 0));
+    try {
+        g.__NS_HMR_BOOT_LAST_PROGRESS__ = next;
+    }
+    catch { }
+    return next;
+}
+/**
+ * Reset every boot-progress global so a re-bootstrapped session (e.g.
+ * after `__reboot_ng_modules__`) starts a fresh ratchet rather than
+ * inheriting the previous cycle's terminal values.
+ */
+export function clearBootProgressState() {
+    const g = getGlobalScope();
+    for (const key of [
+        '__NS_HMR_BOOT_MODULE_COUNT__',
+        '__NS_HMR_BOOT_LAST_MODULE__',
+        '__NS_HMR_BOOT_LAST_PROGRESS__',
+        '__NS_HMR_BOOT_LAST_PROGRESS_AT__',
+        '__NS_HMR_BOOT_IMPORT_STARTED_AT__',
+        // Defensive: an earlier snippet shape used this to throttle a
+        // top-level await yield. Removed — top-level await in a boot-tagged
+        // module trips the iOS 10s async-module deadline. Cleared in case a
+        // stale boot left it behind.
+        '__NS_HMR_BOOT_LAST_YIELD_AT__',
+    ]) {
+        try {
+            delete g[key];
+        }
+        catch { }
+    }
+}
+//# sourceMappingURL=boot-progress.js.map

package/hmr/shared/runtime/boot-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-progress.js","sourceRoot":"","sources":["../../../../../../packages/vite/hmr/shared/runtime/boot-progress.ts"],"names":[],"mappings":"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"}

package/hmr/shared/runtime/boot-timeline.d.ts

@@ -8,7 +8,8 @@ export type BootTrace = {
     t1?: number;
     session?: BootTraceSegment;
     importMap?: BootTraceSegment;
-    native?: BootTraceSegment;
+    kickstart?: BootTraceSegment;
+    entry?: BootTraceSegment;
     error?: {
         message: string;
     };

package/hmr/shared/runtime/boot-timeline.js

@@ -1,22 +1,9 @@
-// Boot timeline instrumentation for the NativeScript dev session.
-//
-// `session-bootstrap.ts` is the real boot path on modern runtimes with
-// `__nsStartDevSession`. We record how long each segment takes and turn
-// the result into a single-line, human-readable log that is always on
-// (not behind the verbose flag) so anyone chasing regressions can see
-// the shape of a cold boot without having to flip any switches.
-//
-// The trace is also mirrored onto `globalThis.__NS_BOOT_TRACE__` so a
-// developer can `console.log(globalThis.__NS_BOOT_TRACE__)` from the
-// device or pick it up via `js:evaluate` in test harnesses.
-//
-// See HMR_CORE_REALM_DETERMINISTIC_PLAN.md — "Post-D roadmap — dev-loop
-// performance and UX" for the full context.
+import { getGlobalScope } from './global-scope.js';
 // Pure formatter so we can unit-test the exact string shape without
 // touching `console.info` or `Date.now()`.
 //
 // Format:
-//   [ns-boot] ok total=1234ms session=45ms importMap=67ms native=1100ms
+//   [ns-boot] ok total=1234ms session=45ms importMap=67ms entry=1100ms
 //   [ns-boot] FAILED total=230ms session=45ms ...: <message>
 //
 // Segment entries are only included when a numeric `ms` was recorded —
@@ -36,18 +23,18 @@ export function formatBootTimeline(trace) {
     }
     push('session', trace.session);
     push('importMap', trace.importMap);
-    push('native', trace.native);
+    push('kickstart', trace.kickstart);
+    push('entry', trace.entry);
     const suffix = trace.error?.message ? `: ${trace.error.message}` : '';
     return `[ns-boot] ${status} ${parts.join(' ')}${suffix}`.replace(/\s+$/, '');
 }
-// Install the trace on `globalThis` so diagnostics can pick it up. We
-// use a distinct key from the legacy entry-runtime trace so existing
-// readers that expect `__NS_ENTRY_TRACE__` keep working. Exported for
-// tests; the runtime path calls this from the session-bootstrap finally
-// block.
+// Install the trace on `globalThis` so diagnostics can pick it up. The key
+// is distinct from the entry-runtime trace (`__NS_ENTRY_TRACE__`), which the
+// entry runtime writes for its own phases. Exported for tests; the runtime
+// path calls this from the session-bootstrap finally block.
 export function publishBootTrace(trace) {
     try {
-        globalThis.__NS_BOOT_TRACE__ = trace;
+        getGlobalScope().__NS_BOOT_TRACE__ = trace;
     }
     catch { }
 }

package/hmr/shared/runtime/boot-timeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"boot-timeline.js","sourceRoot":"","sources":["../../../../../../packages/vite/hmr/shared/runtime/boot-timeline.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,uEAAuE;AACvE,wEAAwE;AACxE,sEAAsE;AACtE,sEAAsE;AACtE,gEAAgE;AAChE,EAAE;AACF,sEAAsE;AACtE,qEAAqE;AACrE,4DAA4D;AAC5D,EAAE;AACF,wEAAwE;AACxE,4CAA4C;AAiB5C,oEAAoE;AACpE,2CAA2C;AAC3C,EAAE;AACF,UAAU;AACV,wEAAwE;AACxE,6DAA6D;AAC7D,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,wEAAwE;AACxE,MAAM,UAAU,kBAAkB,CAAC,KAAgB;IAClD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,GAAiC,EAAE,EAAE;QACjE,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAClE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAE7G,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE7B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtE,OAAO,aAAa,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,sEAAsE;AACtE,qEAAqE;AACrE,sEAAsE;AACtE,wEAAwE;AACxE,SAAS;AACT,MAAM,UAAU,gBAAgB,CAAC,KAAgB;IAChD,IAAI,CAAC;QACH,UAAkB,CAAC,iBAAiB,GAAG,KAAK,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACX,CAAC"}
+{"version":3,"file":"boot-timeline.js","sourceRoot":"","sources":["../../../../../../packages/vite/hmr/shared/runtime/boot-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAmCnD,oEAAoE;AACpE,2CAA2C;AAC3C,EAAE;AACF,UAAU;AACV,uEAAuE;AACvE,6DAA6D;AAC7D,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,wEAAwE;AACxE,MAAM,UAAU,kBAAkB,CAAC,KAAgB;IAClD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,GAAiC,EAAE,EAAE;QACjE,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAClE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAE7G,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAE3B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtE,OAAO,aAAa,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,4DAA4D;AAC5D,MAAM,UAAU,gBAAgB,CAAC,KAAgB;IAChD,IAAI,CAAC;QACJ,cAAc,EAAE,CAAC,iBAAiB,GAAG,KAAK,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACX,CAAC"}

package/hmr/shared/runtime/browser-runtime-contract.d.ts

@@ -22,16 +22,6 @@ export interface NsDevSessionDescriptor {
     hostModules?: NsHostModuleId[];
     features?: NsDevFeatureFlags;
 }
-export interface NsRuntimeDevSessionConfig extends NsDevSessionDescriptor {
-}
-export interface NsStyleUpdatePayload {
-    url: string;
-    cssText: string;
-}
-export interface NsHotUpdateInvalidatePayload {
-    urls: string[];
-    updatedAt?: number;
-}
 export interface NsRuntimeImportMap {
     imports: Record<string, string>;
 }
@@ -39,26 +29,67 @@ export interface NsRuntimeConfigurePayload {
     importMap: NsRuntimeImportMap;
     volatilePatterns?: string[];
 }
+export interface NsKickstartPrefetchOptions {
+    maxConcurrent?: number;
+    timeoutMs?: number;
+}
+export interface NsKickstartPrefetchResult {
+    ok: boolean;
+    fetched: number;
+    ms: number;
+}
+/** One `{url, body}` pair seeded into the native prewarm cache (boot archive). */
+export interface NsSeedModuleBodyEntry {
+    url: string;
+    body: string;
+}
+export interface NsSeedModuleBodiesResult {
+    ok: boolean;
+    seeded: number;
+    bytes: number;
+}
+/**
+ * The native dev-host contract — mechanism only. The runtime exposes its
+ * mechanism primitives on the single `globalThis.__NS_DEV__` namespace
+ * object; every policy concern (boot orchestration, import.meta.hot, full
+ * reload, CSS apply, WebSocket protocol) lives in JS inside
+ * @nativescript/vite.
+ *
+ * Every member is optional: a non-dev environment (or a test) may expose
+ * none or only some of them, and callers degrade gracefully.
+ */
 export interface NsRuntimeDevHostApi {
+    /** `__NS_DEV__.configureRuntime` — import map + volatile URL patterns for the sync resolver. */
     configureRuntime?: (config: NsRuntimeConfigurePayload) => void;
-    supportsRuntimeConfigUrl: boolean;
-    startDevSession: (config: NsRuntimeDevSessionConfig) => Promise<void>;
+    /** `__NS_DEV__.invalidateModules` — dual-cache eviction (V8 registry + prefetch cache + bust-next-fetch nonce). */
     invalidateModules?: (urls: string[]) => void;
-    reloadDevApp?: () => Promise<void>;
-    applyStyleUpdate?: (payload: NsStyleUpdatePayload) => void;
+    /** `__NS_DEV__.getLoadedModuleUrls` — registry introspection for JS-driven full reload. */
     getLoadedModuleUrls?: () => string[];
+    /** `__NS_DEV__.kickstartPrefetch(urls)` — parallel HTTP body prewarm for an explicit URL list. */
+    kickstartPrefetch?: (urls: string[], options?: NsKickstartPrefetchOptions) => NsKickstartPrefetchResult | null;
+    /**
+     * `__NS_DEV__.seedModuleBodies(entries)` — batch prewarm-cache seeding: the
+     * bootstrap downloads `/__ns_dev__/boot-archive` (NDJSON) and seeds every
+     * `{url, body}` into the prewarm cache in one call, behind the same
+     * http(s)/JS-shape/allowlist gates as a kickstart fetch. Callers fall back
+     * to `kickstartPrefetch(urls)` when absent or nothing seeded.
+     */
+    seedModuleBodies?: (entries: NsSeedModuleBodyEntry[]) => NsSeedModuleBodiesResult | null;
+    /** `__NS_DEV__.setDevBootComplete` — flips the native cold-boot gate + `__NS_HMR_BOOT_COMPLETE__`. */
+    setDevBootComplete?: (value?: boolean) => void;
+    /** `__NS_DEV__.terminateAllWorkers` — drains `Caches::Workers`; returns the count terminated (main isolate only). */
+    terminateAllWorkers?: () => number;
 }
 export declare function isNsDevPlatform(value: unknown): value is NsDevPlatform;
 export declare function assertNsDevSessionDescriptor(session: unknown): asserts session is NsDevSessionDescriptor;
+/**
+ * Resolve the dev host API from `globalThis.__NS_DEV__` — the one namespace
+ * object the runtime installs. Always read through this function rather than
+ * poking at the global so every consumer resolves the contract identically.
+ */
 export declare function readNsRuntimeDevHostApi(target?: Partial<typeof globalThis>): NsRuntimeDevHostApi;
 declare global {
-    var __nsConfigureDevRuntime: ((config: NsRuntimeConfigurePayload) => void) | undefined;
-    var __nsConfigureRuntime: ((config: NsRuntimeConfigurePayload) => void) | undefined;
-    var __nsSupportsRuntimeConfigUrl: boolean | undefined;
-    var __nsStartDevSession: ((config: NsRuntimeDevSessionConfig) => Promise<void>) | undefined;
-    var __nsInvalidateModules: ((urls: string[]) => void) | undefined;
-    var __nsReloadDevApp: (() => Promise<void>) | undefined;
-    var __nsApplyStyleUpdate: ((payload: NsStyleUpdatePayload) => void) | undefined;
-    var __nsGetLoadedModuleUrls: (() => string[]) | undefined;
+    /** The dev host namespace object the runtime installs (see NsRuntimeDevHostApi). */
+    var __NS_DEV__: NsRuntimeDevHostApi | undefined;
 }
 export {};

package/hmr/shared/runtime/browser-runtime-contract.js

@@ -39,16 +39,13 @@ export function assertNsDevSessionDescriptor(session) {
         }
     }
 }
+/**
+ * Resolve the dev host API from `globalThis.__NS_DEV__` — the one namespace
+ * object the runtime installs. Always read through this function rather than
+ * poking at the global so every consumer resolves the contract identically.
+ */
 export function readNsRuntimeDevHostApi(target = globalThis) {
-    return {
-        configureRuntime: target.__nsConfigureDevRuntime ?? target.__nsConfigureRuntime,
-        supportsRuntimeConfigUrl: target.__nsSupportsRuntimeConfigUrl === true,
-        startDevSession: target.__nsStartDevSession,
-        invalidateModules: target.__nsInvalidateModules,
-        reloadDevApp: target.__nsReloadDevApp,
-        applyStyleUpdate: target.__nsApplyStyleUpdate,
-        getLoadedModuleUrls: target.__nsGetLoadedModuleUrls,
-    };
+    return target.__NS_DEV__ ?? {};
 }
 export {};
 //# sourceMappingURL=browser-runtime-contract.js.map

package/hmr/shared/runtime/browser-runtime-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-runtime-contract.js","sourceRoot":"","sources":["../../../../../../packages/vite/hmr/shared/runtime/browser-runtime-contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"browser-runtime-contract.js","sourceRoot":"","sources":["../../../../../../packages/vite/hmr/shared/runtime/browser-runtime-contract.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAA4B,CAAC;AACtE,MAAM,CAAC,MAAM,+BAA+B,GAAG,yBAAkC,CAAC;AAClF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,yBAAyB,EAAE,+BAA+B,CAA8C,CAAC;AAEjJ,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AAS7H,MAAM,CAAC,MAAM,4BAA4B,GAAyE;IACjH,UAAU,EAAE,IAAI;IAChB,MAAM,EAAE,IAAI;CACZ,CAAC;AA+EF,SAAS,gBAAgB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC7C,OAAO,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAgB;IAC5D,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,SAAS,GAAG,OAAkC,CAAC;IACrD,KAAK,MAAM,GAAG,IAAI,8BAA8B,EAAE,CAAC;QAClD,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;QACtD,CAAC;IACF,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,SAAS,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;YACzJ,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACpD,CAAC;IACF,CAAC;IAED,IAAI,SAAS,CAAC,gBAAgB,IAAI,IAAI,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;QAChC,IAAI,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACjD,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAqC,UAAU;IACtF,OAAO,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;AAChC,CAAC;AAOD,OAAO,EAAE,CAAC"}

package/hmr/shared/runtime/dev-overlay-snapshots.d.ts

@@ -0,0 +1,31 @@
+type HmrOverlayTone = 'info' | 'warn' | 'error' | 'success';
+type HmrOverlayMode = 'hidden' | 'boot' | 'connection' | 'update';
+export type HmrOverlayPosition = 'top' | 'bottom' | 'center';
+export type HmrBootStage = 'placeholder' | 'probing-origin' | 'loading-entry-runtime' | 'configuring-import-map' | 'loading-runtime-bridge' | 'loading-core-bridge' | 'preloading-style-scope' | 'installing-css' | 'importing-main' | 'waiting-for-app' | 'app-root-committed' | 'ready' | 'error';
+export type HmrConnectionStage = 'connecting' | 'reconnecting' | 'synchronizing' | 'offline' | 'healthy';
+export type HmrUpdateStage = 'received' | 'evicting' | 'reimporting' | 'rebooting' | 'complete';
+export type HmrOverlayStageInfo = {
+    detail?: string;
+    origin?: string;
+    progress?: number | null;
+    attempt?: number;
+    attempts?: number;
+};
+export type HmrOverlaySnapshot = {
+    visible: boolean;
+    mode: HmrOverlayMode;
+    badge: string;
+    title: string;
+    phase: string;
+    detail: string;
+    progress: number | null;
+    busy: boolean;
+    blocking: boolean;
+    tone: HmrOverlayTone;
+};
+export declare const BOOT_TITLE = "NativeScript Vite preparing dev session...";
+export declare const DEFAULT_SNAPSHOT: HmrOverlaySnapshot;
+export declare function createBootOverlaySnapshot(stage: HmrBootStage, info?: HmrOverlayStageInfo): HmrOverlaySnapshot;
+export declare function createConnectionOverlaySnapshot(stage: HmrConnectionStage, info?: HmrOverlayStageInfo): HmrOverlaySnapshot;
+export declare function createUpdateOverlaySnapshot(stage: HmrUpdateStage, info?: HmrOverlayStageInfo): HmrOverlaySnapshot;
+export {};