@nativescript/vite 8.0.0-alpha.3 → 8.0.0-alpha.31

package/hmr/shared/ns-globals.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 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-config API keys (`__nsConfigureRuntime`, `__nsInvalidateModules`,
+ *     `__nsReloadDevApp`, …) are deliberately NOT declared here; they are owned by
+ *     `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).
+ */
+declare global {
+    var __NS_APP_ROOT_VIRTUAL__: string | undefined;
+    var __NS_ENV_VERBOSE__: boolean | undefined;
+    var __NS_TARGET_FLAVOR__: string | undefined;
+    var __NS_HMR_PROGRESS_OVERLAY_ENABLED__: boolean | undefined;
+    var __NS_HMR_KICKSTART_MAX_URLS__: number | undefined;
+    var __NS_HMR_BOOT_COMPLETE__: boolean | undefined;
+    var __NS_HMR_HTTP_APP_CSS_APPLIED__: boolean | undefined;
+    var __NS_IMPORT_MAP_CONFIGURED__: boolean | undefined;
+    var __NS_ENTRY_OK__: boolean | undefined;
+    var __NS_DEV_RESET_IN_PROGRESS__: boolean | undefined;
+    var __NS_ANGULAR_HMR_CLIENT_INSTALLED__: boolean | undefined;
+    var __NS_ANGULAR_HMR_REGISTER_ONLY__: boolean | undefined;
+    var __NS_HMR_CLIENT_ACTIVE__: boolean | undefined;
+    var __NS_HMR_CLIENT_SOCKET_READY__: boolean | undefined;
+    var __NS_HMR_ALLOW_INITIAL_MOUNT__: boolean | undefined;
+    var __NS_HMR_INITIAL_MOUNT_IN_PROGRESS__: boolean | undefined;
+    var __NS_HMR_RESCUE_SCHEDULED__: boolean | undefined;
+    var __NS_HMR_BACK_WRAPPED__: boolean | undefined;
+    var __NS_HMR_DISABLE_ASM__: boolean | undefined;
+    var __NS_HMR_ASM_DIAG__: boolean | undefined;
+    var __NS_HMR_BOOT_MAIN_URL__: string | undefined;
+    var __NS_HMR_BOOT_MAIN_ATTEMPT__: number | undefined;
+    var __NS_HMR_BOOT_MAIN_ATTEMPTS__: number | undefined;
+    var __NS_HMR_BOOT_MODULE_COUNT__: number | undefined;
+    var __NS_HMR_BOOT_LAST_MODULE__: string | undefined;
+    var __NS_HMR_BOOT_LAST_PROGRESS__: number | undefined;
+    var __NS_HMR_BOOT_LAST_PROGRESS_AT__: number | undefined;
+    var __NS_HMR_BOOT_IMPORT_STARTED_AT__: number | undefined;
+    var __NS_HTTP_ORIGIN__: string | undefined;
+    var __NS_ENTRY_LAST_TARGET__: string | undefined;
+    var __NS_HMR_HOST: string | undefined;
+    var __NS_HMR_REALM__: string | undefined;
+    var __NS_RT_REALM__: string | undefined;
+    var __NS_HMR_BROWSER_RUNTIME_TARGET_FLAVOR__: string | undefined;
+    var __NS_HMR_GRAPH_VERSION__: number | undefined;
+    var __NS_HMR_IMPORT_NONCE__: number | undefined;
+    var __NS_HMR_APPLY_CSS__: ((cssText: string, refreshRoot?: boolean) => void) | undefined;
+    var __NS_HMR_APP_CSS__: string | undefined;
+    var __NS_HMR_APP_CSS_AST__: any;
+    var __NS_DISPATCH_HOT_EVENT__: ((event: string, payload?: unknown) => void) | undefined;
+    var __NS_HMR_IMPORT__: ((url: string) => Promise<unknown>) | undefined;
+    var __NS_HMR_ON_UPDATE__: ((payload: {
+        type: 'full-graph' | 'delta';
+        version: number;
+        changedIds: string[];
+        raw: any;
+    }) => void) | undefined;
+    var __NS_HMR_ON_NAVIGATE_BACK: (() => void) | undefined;
+    var __NS_DEV_RESTORE_PLACEHOLDER__: ((reason?: string) => void) | undefined;
+    var __nsAttemptBackRemount: (() => unknown) | undefined;
+    var __nsHmrRequestModule: ((spec: string) => Promise<string>) | undefined;
+    var __nsGetModuleExports: ((id: string) => any) | undefined;
+    var __nsKickstartHmrPrefetch: ((urls: string[], opts?: {
+        maxConcurrent: number;
+        timeoutMs: number;
+    }) => {
+        ok: boolean;
+        fetched: number;
+        ms: number;
+    } | null) | undefined;
+    var __ns_solid_hmr_subscribe: ((fn: (ev: {
+        kind: 'solid';
+        changedFiles: string[];
+        boundaries: string[];
+    }) => void) => () => void) | undefined;
+    var __NS_HMR_DEV_OVERLAY__: any;
+    var __NS_ENTRY_TRACE__: any;
+    var __NS_ENTRY_ERROR__: any;
+    var __NS_DEV_ORIGINAL_APP_RUN__: any;
+    var __NS_DEV_PLACEHOLDER_APPLICATION__: any;
+    var __NS_DEV_PLACEHOLDER_ROOT_VIEW__: any;
+    var __NS_DEV_PLACEHOLDER_ROOT_EARLY__: any;
+    var __NS_HMR_PINIA__: any;
+    var __NS_PINIA_SYMBOL__: symbol | undefined;
+    var __NS_VUE_APP__: any;
+    var __NS_HMR_CREATE_APP__: any;
+    var __NS_HMR_INSTALL_PLUGINS__: any;
+    var __NS_HMR_ORIG_ROOT_COMPONENT__: any;
+    var __NS_HMR_VUE_SFC_REGISTRY__: any;
+    var __NS_HMR_WORKERS__: any;
+    var __NS_UPDATE_ANGULAR_APP_OPTIONS__: any;
+    var __nsNavigateUsingApp: any;
+    var __nsHasDeclinedModule: any;
+    var __nsRunHmrDispose: any;
+    var __nsTerminateAllWorkers: any;
+    var __nsRequire: any;
+    var __nsVendorRequire: any;
+    var __nsVendorRegistry: any;
+    var __ns_router: any;
+    var __ns_solid_hmr_listener_set: any;
+}
+export {};

package/hmr/shared/ns-globals.js

@@ -0,0 +1,27 @@
+/**
+ * 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-config API keys (`__nsConfigureRuntime`, `__nsInvalidateModules`,
+ *     `__nsReloadDevApp`, …) are deliberately NOT declared here; they are owned by
+ *     `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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AA4FH,OAAO,EAAE,CAAC"}

package/hmr/shared/protocol.d.ts

@@ -0,0 +1,136 @@
+/**
+ * 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;
+}
+/** 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;
+    /** 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[];
+}
+/** 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;AAgJH;;;;;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-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 (6259ms)").
+ */
+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 (6259ms)").
+ */
+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,40 @@
+/**
+ * `'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 (Nms)" line during
+ * the pre-snippet window.
+ */
+export declare function formatBootImportDetail(input: {
+    count?: number;
+    lastModule?: string;
+    elapsedMs?: number;
+}): 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;

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

@@ -0,0 +1,128 @@
+// Pure helpers for the cold-boot "Importing the app entry" progress display.
+//
+// Pipeline:
+//   * Server-side `buildBootProgressSnippet` is injected at the top of
+//     every `__ns_boot__/b1`-tagged module and bumps the count /
+//     last-module globals (FULLY SYNCHRONOUS — see the snippet doc for
+//     why top-level await must stay out of boot-tagged modules).
+//   * `startBrowserRuntimeSession` stamps the time origin
+//     (`__NS_HMR_BOOT_IMPORT_STARTED_AT__`) right before
+//     `__nsStartDevSession`.
+//   * `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 (Nms)" line during
+ * the pre-snippet window.
+ */
+export function formatBootImportDetail(input) {
+    const count = Math.max(0, Number(input?.count ?? 0));
+    const lastModule = typeof input?.lastModule === 'string' ? input.lastModule : '';
+    const elapsedMs = Math.max(0, Number(input?.elapsedMs ?? 0));
+    if (count > 0) {
+        return lastModule ? `Evaluated ${count} modules\n${lastModule}` : `Evaluated ${count} modules`;
+    }
+    return `Loading the module graph (${elapsedMs}ms)`;
+}
+/**
+ * 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 = globalThis;
+    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 = globalThis;
+    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