@nativescript/vite 8.0.0-beta.0 → 8.0.0-rc.0

package/hmr/shared/ns-globals.js

@@ -0,0 +1,29 @@
+/* eslint-disable no-var -- ambient global declarations must use `var`: only `var`
+   in `declare global` registers the property on `typeof globalThis` (see header). */
+/**
+ * Ambient typings for the `__NS_*` / `__ns*` globals the HMR runtime stashes on
+ * `globalThis`. One `declare global` here replaces the scattered
+ * `(globalThis as any).__NS_X` casts across the device client + entry runtime:
+ * consumers read/write `globalThis.__NS_X` directly and get a real type, and the
+ * per-file `declare const __NS_X__` duplicates collapse to this single source of
+ * truth.
+ *
+ * Conventions:
+ *   - Every key is `var … | undefined` — `var` (not `const`/`let`) is what adds the
+ *     property to `typeof globalThis`, so both bare references (Vite `define`
+ *     substitutions like `__NS_ENV_VERBOSE__`) and `globalThis.__NS_X` access
+ *     type-check; `| undefined` reflects that these are populated lazily at runtime.
+ *   - Primitive flags/counters/urls get precise types. Keys holding framework
+ *     instances, native objects, ASTs, module registries, or arbitrary diagnostic
+ *     payloads are intentionally `any` — typing them precisely would couple this
+ *     shared file to device internals and risk breaking write sites elsewhere in
+ *     the package.
+ *   - The runtime dev-host API is NOT a global at all — it is the
+ *     `ns:module` builtin module, read through
+ *     `hmr/shared/runtime/browser-runtime-contract.ts`.
+ *
+ * This module emits no runtime code (ambient declaration only) and is picked up
+ * project-wide via the package tsconfig include (all .ts files).
+ */
+export {};
+//# sourceMappingURL=ns-globals.js.map

package/hmr/shared/ns-globals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ns-globals.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/shared/ns-globals.ts"],"names":[],"mappings":"AAAA;qFACqF;AACrF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AA0FH,OAAO,EAAE,CAAC"}

package/hmr/shared/package-classifier.d.ts

@@ -0,0 +1,9 @@
+export interface PackageRuntimeInfo {
+    rootPackageName: string;
+    hasPackageJson: boolean;
+    hasExports: boolean;
+    mainEntries: Set<string>;
+    hasNativeScriptMetadata: boolean;
+}
+export declare function extractRootPackageName(spec: string): string;
+export declare function getPackageRuntimeInfo(spec: string, projectRoot: string): PackageRuntimeInfo;

package/hmr/shared/package-classifier.js

@@ -0,0 +1,58 @@
+import { readFileSync } from 'fs';
+import path from 'path';
+import { createRequire } from 'node:module';
+const packageRuntimeInfoCache = new Map();
+export function extractRootPackageName(spec) {
+    if (!spec)
+        return '';
+    if (spec.startsWith('@')) {
+        const parts = spec.split('/');
+        return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : spec;
+    }
+    return spec.split('/')[0];
+}
+export function getPackageRuntimeInfo(spec, projectRoot) {
+    const rootPackageName = extractRootPackageName(String(spec || ''));
+    if (!rootPackageName) {
+        return {
+            rootPackageName: '',
+            hasPackageJson: false,
+            hasExports: false,
+            mainEntries: new Set(),
+            hasNativeScriptMetadata: false,
+        };
+    }
+    const resolvedProjectRoot = path.resolve(projectRoot || process.cwd());
+    const cacheKey = `${resolvedProjectRoot}::${rootPackageName}`;
+    const cached = packageRuntimeInfoCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const info = {
+        rootPackageName,
+        hasPackageJson: false,
+        hasExports: false,
+        mainEntries: new Set(),
+        hasNativeScriptMetadata: false,
+    };
+    try {
+        const projectRequire = createRequire(path.join(resolvedProjectRoot, 'package.json'));
+        const packageJsonPath = projectRequire.resolve(`${rootPackageName}/package.json`);
+        const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        info.hasPackageJson = true;
+        info.hasExports = !!pkg.exports && typeof pkg.exports === 'object';
+        for (const field of ['module', 'main']) {
+            const value = pkg[field];
+            if (value && typeof value === 'string') {
+                info.mainEntries.add(value.replace(/^\.\//, ''));
+            }
+        }
+        info.hasNativeScriptMetadata = (typeof pkg.nativescript === 'object' && pkg.nativescript !== null) || typeof pkg.peerDependencies?.['@nativescript/core'] === 'string' || typeof pkg.dependencies?.['@nativescript/core'] === 'string';
+    }
+    catch {
+        // Package metadata unavailable — leave defaults and let callers fall back to heuristics.
+    }
+    packageRuntimeInfoCache.set(cacheKey, info);
+    return info;
+}
+//# sourceMappingURL=package-classifier.js.map

package/hmr/shared/package-classifier.js.map

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

package/hmr/shared/protocol.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Wire protocol for the `ns:*` HMR messages exchanged over the dev-server
+ * WebSocket between the Vite dev server and the on-device client.
+ *
+ * This is the single source of truth for message shapes. Server emit sites
+ * annotate their payload objects with the matching interface here, so a field
+ * rename or type drift becomes a compile error at the emit site instead of a
+ * silent runtime mismatch the device only discovers at parse time. The client
+ * dispatch (`switch (msg.type)`) consumes the `ServerToClientMessage` union and
+ * uses {@link assertNeverNsMessage} for exhaustiveness.
+ *
+ * Pure types + one pure helper only — this module is in `hmr/shared` and must
+ * not import from `hmr/server` or `hmr/client`.
+ *
+ * Direction is encoded by the two unions:
+ *   - {@link ServerToClientMessage} — dev server → device (9 messages)
+ *   - {@link ClientToServerMessage} — device → dev server (2 messages)
+ */
+/** Module entry as carried inside the graph payloads (`ns:hmr-full-graph`, `ns:hmr-delta`). */
+export interface GraphModulePayload {
+    id: string;
+    deps: string[];
+    hash: string;
+}
+/** A single CSS update item nested inside an `ns:css-updates` batch. */
+export interface CssUpdateItem {
+    type: 'css-update';
+    path: string;
+    acceptedPath: string;
+    timestamp: number;
+    /**
+     * Tag for the client's `addTaggedAdditionalCSS`/`removeTaggedAdditionalCSS`
+     * remove+add pair, scoping the replace so repeated edits of the SAME source
+     * swap cleanly instead of stacking. Omitted for the app entry CSS (the
+     * client defaults to the shared `app.css` tag). Set to the component style
+     * file's own path for `styleUrls` edits so a component's rules replace
+     * independently of `app.css`.
+     */
+    tag?: string;
+}
+/** A single Vue SFC registry entry carried inside `ns:vue-sfc-registry`. */
+export interface VueSfcRegistryEntry {
+    path: string;
+    fileName: string;
+    hmrId: string;
+    /** Always empty in HTTP-only mode (artifacts are fetched over HTTP, not pushed over WS). */
+    code: string;
+}
+/** Classified kind of a pending HMR update (used by `ns:hmr-pending`). */
+export type HmrPendingKind = 'ts' | 'css' | 'html' | 'unknown';
+/** Angular hot-update broadcast: the device evicts `evictPaths` and re-fetches. */
+export interface AngularUpdateMessage {
+    type: 'ns:angular-update';
+    origin: string;
+    path: string;
+    version: number;
+    timestamp: number;
+    evictPaths: string[];
+    importerEntry: string;
+    /**
+     * App stylesheet refresh produced by the same content-file edit. Angular
+     * applies it inside the serialized reboot cycle so CSS replacement cannot
+     * race view-tree teardown/recreation.
+     */
+    cssUpdates?: CssUpdateItem[];
+    /** Legacy fallback the Angular client still reads; not emitted by the current server. */
+    entryCandidates?: string[];
+}
+/** Batched CSS hot-update broadcast (direct `.css` saves and Tailwind/PostCSS content edits). */
+export interface CssUpdatesMessage {
+    type: 'ns:css-updates';
+    origin: string;
+    updates: CssUpdateItem[];
+    /**
+     * `connect-sync` marks the boot-time stylesheet sync pushed to a freshly
+     * connected full client; the client applies it silently (no overlay). Full
+     * rationale in `hmr/server/css-connect-sync.ts`.
+     */
+    reason?: 'connect-sync';
+}
+/** Incremental module-graph delta broadcast on every graph mutation. */
+export interface HmrDeltaMessage {
+    type: 'ns:hmr-delta';
+    baseVersion: number;
+    newVersion: number;
+    changed: GraphModulePayload[];
+    removed: string[];
+}
+/** Full module-graph snapshot sent on connect and in response to `ns:hmr-resync-request`. */
+export interface HmrFullGraphMessage {
+    type: 'ns:hmr-full-graph';
+    version: number;
+    modules: GraphModulePayload[];
+}
+/** Early "change in flight" notification sent at the very start of `handleHotUpdate`. */
+export interface HmrPendingMessage {
+    type: 'ns:hmr-pending';
+    origin: string;
+    path: string;
+    kind: HmrPendingKind;
+    timestamp: number;
+}
+/**
+ * Response to a legacy on-demand module fetch (Option A).
+ *
+ * No server emit site currently exists — the live module-fetch path resolves
+ * HTTP URLs directly — but the client still handles this shape, so it is part
+ * of the union for completeness. Shape is inferred from the consumer.
+ */
+export interface ModuleResponseMessage {
+    type: 'ns:module-response';
+    requestId: number;
+    error?: string;
+}
+/** TypeScript-flavor module registry primed on connect; coalesced into the graph client-side. */
+export interface TsModuleRegistryMessage {
+    type: 'ns:ts-module-registry';
+    modules: string[];
+    ts: number;
+}
+/** Vue SFC registry sent on connect and in response to `ns:hmr-sfc-registry-request`. */
+export interface VueSfcRegistryMessage {
+    type: 'ns:vue-sfc-registry';
+    entries: VueSfcRegistryEntry[];
+    ts: number;
+}
+/** Mapping-only Vue SFC registry update emitted ahead of the artifact for a changed `.vue` file. */
+export interface VueSfcRegistryUpdateMessage {
+    type: 'ns:vue-sfc-registry-update';
+    path: string;
+    fileName: string;
+    ts: number;
+    version: number;
+}
+/** Device asks for a fresh full graph when its delta base version drifts from the server's. */
+export interface HmrResyncRequestMessage {
+    type: 'ns:hmr-resync-request';
+}
+/** Device asks the server to rebuild and re-broadcast the SFC registry. */
+export interface HmrSfcRegistryRequestMessage {
+    type: 'ns:hmr-sfc-registry-request';
+}
+/** Every `ns:*` message the dev server can send to the device. */
+export type ServerToClientMessage = AngularUpdateMessage | CssUpdatesMessage | HmrDeltaMessage | HmrFullGraphMessage | HmrPendingMessage | ModuleResponseMessage | TsModuleRegistryMessage | VueSfcRegistryMessage | VueSfcRegistryUpdateMessage;
+/** Every `ns:*` message the device can send back to the dev server. */
+export type ClientToServerMessage = HmrResyncRequestMessage | HmrSfcRegistryRequestMessage;
+/** Any `ns:*` HMR message, regardless of direction. */
+export type NsHmrMessage = ServerToClientMessage | ClientToServerMessage;
+/** The `type` discriminant of any `ns:*` HMR message. */
+export type NsHmrMessageType = NsHmrMessage['type'];
+/**
+ * Exhaustiveness guard for `switch (msg.type)` dispatch over the message unions.
+ * Reaching it means a new message type was added to the union but not handled;
+ * TypeScript flags the unhandled branch at compile time and this throws if a
+ * truly unexpected payload arrives at runtime.
+ */
+export declare function assertNeverNsMessage(message: never): never;

package/hmr/shared/protocol.js

@@ -0,0 +1,28 @@
+/**
+ * Wire protocol for the `ns:*` HMR messages exchanged over the dev-server
+ * WebSocket between the Vite dev server and the on-device client.
+ *
+ * This is the single source of truth for message shapes. Server emit sites
+ * annotate their payload objects with the matching interface here, so a field
+ * rename or type drift becomes a compile error at the emit site instead of a
+ * silent runtime mismatch the device only discovers at parse time. The client
+ * dispatch (`switch (msg.type)`) consumes the `ServerToClientMessage` union and
+ * uses {@link assertNeverNsMessage} for exhaustiveness.
+ *
+ * Pure types + one pure helper only — this module is in `hmr/shared` and must
+ * not import from `hmr/server` or `hmr/client`.
+ *
+ * Direction is encoded by the two unions:
+ *   - {@link ServerToClientMessage} — dev server → device (9 messages)
+ *   - {@link ClientToServerMessage} — device → dev server (2 messages)
+ */
+/**
+ * Exhaustiveness guard for `switch (msg.type)` dispatch over the message unions.
+ * Reaching it means a new message type was added to the union but not handled;
+ * TypeScript flags the unhandled branch at compile time and this throws if a
+ * truly unexpected payload arrives at runtime.
+ */
+export function assertNeverNsMessage(message) {
+    throw new Error(`Unhandled ns:* HMR message: ${JSON.stringify(message)}`);
+}
+//# sourceMappingURL=protocol.js.map

package/hmr/shared/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/shared/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqKH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAc;IAClD,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC3E,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * Flip the dev-boot-complete signal from JS.
+ *
+ * Sets the JS-visible `__NS_HMR_BOOT_COMPLETE__` global (every existing
+ * poller keys off it) AND — when the runtime exposes it — calls
+ * ns:module `setDevBootComplete(value)` so the native atomic that gates
+ * cold-boot-only behaviors (JS-thread runloop pump between synchronous
+ * fetches) is disarmed/re-armed in lockstep.
+ *
+ * Safe on runtimes without the native setter (Android today, tests): the
+ * JS global still flips and the native call is skipped.
+ */
+export declare function setDevBootComplete(value: boolean): void;
+export declare function markDevBootComplete(): void;

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

@@ -0,0 +1,32 @@
+import { getGlobalScope } from './global-scope.js';
+import { readNsRuntimeDevHostApi } from './browser-runtime-contract.js';
+/**
+ * Flip the dev-boot-complete signal from JS.
+ *
+ * Sets the JS-visible `__NS_HMR_BOOT_COMPLETE__` global (every existing
+ * poller keys off it) AND — when the runtime exposes it — calls
+ * ns:module `setDevBootComplete(value)` so the native atomic that gates
+ * cold-boot-only behaviors (JS-thread runloop pump between synchronous
+ * fetches) is disarmed/re-armed in lockstep.
+ *
+ * Safe on runtimes without the native setter (Android today, tests): the
+ * JS global still flips and the native call is skipped.
+ */
+export function setDevBootComplete(value) {
+    const g = getGlobalScope();
+    try {
+        g.__NS_HMR_BOOT_COMPLETE__ = value;
+    }
+    catch { }
+    try {
+        const nativeSetter = readNsRuntimeDevHostApi(g).setDevBootComplete;
+        if (typeof nativeSetter === 'function') {
+            nativeSetter(value);
+        }
+    }
+    catch { }
+}
+export function markDevBootComplete() {
+    setDevBootComplete(true);
+}
+//# sourceMappingURL=boot-complete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boot-complete.js","sourceRoot":"","sources":["../../../../../../packages/vite/hmr/shared/runtime/boot-complete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAChD,MAAM,CAAC,GAAQ,cAAc,EAAE,CAAC;IAChC,IAAI,CAAC;QACJ,CAAC,CAAC,wBAAwB,GAAG,KAAK,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,IAAI,CAAC;QACJ,MAAM,YAAY,GAAG,uBAAuB,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC;QACnE,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE,CAAC;YACxC,YAAY,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACF,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACX,CAAC;AAED,MAAM,UAAU,mBAAmB;IAClC,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/hmr/shared/runtime/boot-placeholder-ui.d.ts

@@ -0,0 +1,69 @@
+import type { HmrOverlaySnapshot } from './dev-overlay.js';
+/**
+ * Calibrated palette for the boot placeholder card. The card is
+ * intentionally light so the small accent (brand badge + progress
+ * fill) reads as the only "live" element on the screen.
+ *
+ * Tones map to the snapshot tone enum from `dev-overlay.ts`:
+ *  - `info` (default) — calm slate + NS blue
+ *  - `error` — dusty rose-on-white surface
+ */
+export type BootPlaceholderTone = 'info' | 'error';
+export interface BootPlaceholderPalette {
+    pageBackground: string;
+    cardBackground: string;
+    cardShadow: string;
+    titleText: string;
+    phaseText: string;
+    detailText: string;
+    progressTrack: string;
+    progressFill: string;
+    activityIndicator: string;
+}
+/**
+ * Resolve the palette for a given tone. Unknown tones fall back to
+ * the calm `info` palette
+ */
+export declare function getBootPlaceholderPalette(tone?: string | null): BootPlaceholderPalette;
+/**
+ * Animation contract for the boot placeholder.
+ *
+ * `entranceDurationMs` covers the one-shot fade + scale that fires
+ * when the placeholder card first attaches to the visual tree.
+ * `entranceFromScale` is the starting scale before easeOut to 1.
+ *
+ * `progressDurationMs` is the per-update fade for the progress fill's
+ * `scaleX`. Pegged to 220 ms (just under the heartbeat's 250 ms tick)
+ * so consecutive ticks chain into continuous motion rather than
+ * waiting on the previous animation to settle.
+ *
+ * `brandPulseDurationMs` is one half-period of the brand badge's
+ * opacity pulse. A full cycle is `brandPulseDurationMs * 2`. Keeping
+ * it long (~1.2 s) makes the pulse feel ambient rather than nervous.
+ */
+export declare const BOOT_PLACEHOLDER_MOTION: {
+    readonly entranceDurationMs: 380;
+    readonly entranceFromScale: 0.94;
+    readonly progressDurationMs: 220;
+    readonly brandPulseDurationMs: 1200;
+    readonly brandPulseMinOpacity: 0.55;
+};
+/**
+ * Convert a 0–100 progress percentage into an `scaleX` factor that
+ * the fill view can animate against. Clamps to [`minScale`, 1] so the
+ * fill never collapses to an invisible hairline
+ *
+ * The default `minScale` of 0.01 keeps the bar visible during the
+ * earliest moments of boot when progress is 0
+ */
+export declare function computeBootProgressFillScale(progress: number | null | undefined, minScale?: number): number;
+/**
+ * The "phase + percent" line we show as the primary status text
+ * inside the card
+ */
+export declare function formatBootPrimaryLine(snapshot: Pick<HmrOverlaySnapshot, 'phase' | 'progress'> | null | undefined): string;
+/**
+ * The secondary detail line (e.g. "Loading the module graph…" or
+ * "Evaluated 42 modules").
+ */
+export declare function formatBootDetailLine(snapshot: Pick<HmrOverlaySnapshot, 'detail'> | null | undefined): string;

package/hmr/shared/runtime/boot-placeholder-ui.js

@@ -0,0 +1,101 @@
+// Pure helpers for the cold-boot placeholder's visual treatment.
+//
+// The visible UI is constructed in `root-placeholder.ts` (an NS view
+// tree attached to `Application` via `launchEvent`), and driven by the
+// dev-overlay via `updateBootStatusLabel`. This file owns the bits
+// that don't need a runtime view tree to make sense — colours,
+// animation timings, the formula that turns a 0–100 progress into the
+// fill bar's `scaleX`, and the split between the "phase + percent"
+// primary line and the secondary detail line.
+//
+const INFO_PALETTE = {
+    pageBackground: '#F4F7FB',
+    cardBackground: '#FFFFFF',
+    cardShadow: '#0F172A',
+    titleText: '#0F172A',
+    phaseText: '#475569',
+    detailText: '#94A3B8',
+    progressTrack: '#E2E8F0',
+    progressFill: '#3B6FE5',
+    activityIndicator: '#3B6FE5',
+};
+const ERROR_PALETTE = {
+    pageBackground: '#FFF5F5',
+    cardBackground: '#FFFFFF',
+    cardShadow: '#7F1D1D',
+    titleText: '#7F1D1D',
+    phaseText: '#B91C1C',
+    detailText: '#DC2626',
+    progressTrack: '#FCA5A5',
+    progressFill: '#B41810',
+    activityIndicator: '#B41810',
+};
+/**
+ * Resolve the palette for a given tone. Unknown tones fall back to
+ * the calm `info` palette
+ */
+export function getBootPlaceholderPalette(tone) {
+    if (tone === 'error')
+        return ERROR_PALETTE;
+    return INFO_PALETTE;
+}
+/**
+ * Animation contract for the boot placeholder.
+ *
+ * `entranceDurationMs` covers the one-shot fade + scale that fires
+ * when the placeholder card first attaches to the visual tree.
+ * `entranceFromScale` is the starting scale before easeOut to 1.
+ *
+ * `progressDurationMs` is the per-update fade for the progress fill's
+ * `scaleX`. Pegged to 220 ms (just under the heartbeat's 250 ms tick)
+ * so consecutive ticks chain into continuous motion rather than
+ * waiting on the previous animation to settle.
+ *
+ * `brandPulseDurationMs` is one half-period of the brand badge's
+ * opacity pulse. A full cycle is `brandPulseDurationMs * 2`. Keeping
+ * it long (~1.2 s) makes the pulse feel ambient rather than nervous.
+ */
+export const BOOT_PLACEHOLDER_MOTION = {
+    entranceDurationMs: 380,
+    entranceFromScale: 0.94,
+    progressDurationMs: 220,
+    brandPulseDurationMs: 1200,
+    brandPulseMinOpacity: 0.55,
+};
+/**
+ * Convert a 0–100 progress percentage into an `scaleX` factor that
+ * the fill view can animate against. Clamps to [`minScale`, 1] so the
+ * fill never collapses to an invisible hairline
+ *
+ * The default `minScale` of 0.01 keeps the bar visible during the
+ * earliest moments of boot when progress is 0
+ */
+export function computeBootProgressFillScale(progress, minScale = 0.01) {
+    const numeric = typeof progress === 'number' && Number.isFinite(progress) ? progress : 0;
+    const normalized = numeric / 100;
+    if (!Number.isFinite(normalized))
+        return minScale;
+    return Math.max(minScale, Math.min(1, normalized));
+}
+/**
+ * The "phase + percent" line we show as the primary status text
+ * inside the card
+ */
+export function formatBootPrimaryLine(snapshot) {
+    if (!snapshot)
+        return '';
+    const progress = snapshot.progress;
+    const progressText = typeof progress === 'number' && Number.isFinite(progress) ? ` (${Math.round(progress)}%)` : '';
+    return `${snapshot.phase || ''}${progressText}`.trim();
+}
+/**
+ * The secondary detail line (e.g. "Loading the module graph…" or
+ * "Evaluated 42 modules").
+ */
+export function formatBootDetailLine(snapshot) {
+    if (!snapshot)
+        return '';
+    const detail = snapshot.detail;
+    return typeof detail === 'string' ? detail : '';
+}
+//# sourceMappingURL=boot-placeholder-ui.js.map

package/hmr/shared/runtime/boot-placeholder-ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-placeholder-ui.js","sourceRoot":"","sources":["../../../../../../packages/vite/hmr/shared/runtime/boot-placeholder-ui.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,qEAAqE;AACrE,uEAAuE;AACvE,mEAAmE;AACnE,+DAA+D;AAC/D,sEAAsE;AACtE,mEAAmE;AACnE,8CAA8C;AAC9C,EAAE;AA2BF,MAAM,YAAY,GAA2B;IAC5C,cAAc,EAAE,SAAS;IACzB,cAAc,EAAE,SAAS;IACzB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;IACrB,aAAa,EAAE,SAAS;IACxB,YAAY,EAAE,SAAS;IACvB,iBAAiB,EAAE,SAAS;CAC5B,CAAC;AAEF,MAAM,aAAa,GAA2B;IAC7C,cAAc,EAAE,SAAS;IACzB,cAAc,EAAE,SAAS;IACzB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;IACrB,aAAa,EAAE,SAAS;IACxB,YAAY,EAAE,SAAS;IACvB,iBAAiB,EAAE,SAAS;CAC5B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAoB;IAC7D,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,aAAa,CAAC;IAC3C,OAAO,YAAY,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACtC,kBAAkB,EAAE,GAAG;IACvB,iBAAiB,EAAE,IAAI;IACvB,kBAAkB,EAAE,GAAG;IACvB,oBAAoB,EAAE,IAAI;IAC1B,oBAAoB,EAAE,IAAI;CACjB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAmC,EAAE,QAAQ,GAAG,IAAI;IAChG,MAAM,OAAO,GAAG,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,UAAU,GAAG,OAAO,GAAG,GAAG,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAA2E;IAChH,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACnC,MAAM,YAAY,GAAG,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACpH,OAAO,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAA+D;IACnG,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/B,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * `'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 declare const BOOT_IMPORT_PROGRESS_MIN = 30;
+export declare const BOOT_IMPORT_PROGRESS_MAX = 92;
+/** Ceiling guards against rounding into `'waiting-for-app'` (94). */
+export declare const BOOT_IMPORT_PROGRESS_CEILING = 94;
+export declare function computeBootImportProgress(input: {
+    count?: number;
+    elapsedMs?: number;
+}): number;
+/**
+ * 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 declare function formatBootImportDetail(input: {
+    count?: number;
+    lastModule?: string;
+}): string;
+/**
+ * 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 declare function applyMonotonicBootProgress(candidate: number): number;
+/**
+ * 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 declare function clearBootProgressState(): void;