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

package/hmr/shared/runtime/dev-overlay-snapshots.js

@@ -0,0 +1,324 @@
+// Pure snapshot model for the HMR dev overlay: the stage enums and the
+// factories that turn a stage + info into an immutable `HmrOverlaySnapshot`.
+// No view-tree or platform dependencies live here — rendering is in
+// `dev-overlay.ts`, so these factories are trivially unit-testable.
+export const BOOT_TITLE = 'NativeScript Vite preparing dev session...';
+export const DEFAULT_SNAPSHOT = {
+    visible: false,
+    mode: 'hidden',
+    badge: 'HMR',
+    title: BOOT_TITLE,
+    phase: '',
+    detail: '',
+    progress: null,
+    busy: false,
+    blocking: false,
+    tone: 'info',
+};
+const HMR_UPDATE_TITLE = 'HMR update applying...';
+const HMR_UPDATE_DONE_TITLE = 'HMR update applied';
+function describeAttempt(info) {
+    const attempt = Number(info?.attempt || 0);
+    const attempts = Number(info?.attempts || 0);
+    if (!attempt || !attempts) {
+        return '';
+    }
+    return `Attempt ${attempt}/${attempts}`;
+}
+export function createBootOverlaySnapshot(stage, info) {
+    const attemptText = describeAttempt(info);
+    const phaseInfo = {
+        placeholder: {
+            visible: true,
+            mode: 'boot',
+            badge: 'BOOT',
+            title: BOOT_TITLE,
+            phase: 'Preparing the HTTP HMR bootstrap',
+            progress: 4,
+            busy: true,
+            blocking: true,
+            tone: 'info',
+        },
+        'probing-origin': {
+            visible: true,
+            mode: 'boot',
+            badge: 'BOOT',
+            title: BOOT_TITLE,
+            phase: 'Contacting the Vite dev server',
+            progress: 8,
+            busy: true,
+            blocking: true,
+            tone: 'info',
+        },
+        'loading-entry-runtime': {
+            visible: true,
+            mode: 'boot',
+            badge: 'BOOT',
+            title: BOOT_TITLE,
+            phase: 'Loading the entry runtime bridge',
+            progress: 16,
+            busy: true,
+            blocking: true,
+            tone: 'info',
+        },
+        'configuring-import-map': {
+            visible: true,
+            mode: 'boot',
+            badge: 'BOOT',
+            title: BOOT_TITLE,
+            phase: 'Configuring the import map',
+            progress: 26,
+            busy: true,
+            blocking: true,
+            tone: 'info',
+        },
+        'loading-runtime-bridge': {
+            visible: true,
+            mode: 'boot',
+            badge: 'BOOT',
+            title: BOOT_TITLE,
+            phase: 'Loading the NativeScript runtime bridge',
+            progress: 40,
+            busy: true,
+            blocking: true,
+            tone: 'info',
+        },
+        'loading-core-bridge': {
+            visible: true,
+            mode: 'boot',
+            badge: 'BOOT',
+            title: BOOT_TITLE,
+            phase: 'Loading the unified core bridge',
+            progress: 54,
+            busy: true,
+            blocking: true,
+            tone: 'info',
+        },
+        'preloading-style-scope': {
+            visible: true,
+            mode: 'boot',
+            badge: 'BOOT',
+            title: BOOT_TITLE,
+            phase: 'Preparing the shared style scope',
+            progress: 62,
+            busy: true,
+            blocking: true,
+            tone: 'info',
+        },
+        'installing-css': {
+            visible: true,
+            mode: 'boot',
+            badge: 'BOOT',
+            title: BOOT_TITLE,
+            phase: 'Applying the app stylesheet',
+            progress: 70,
+            busy: true,
+            blocking: true,
+            tone: 'info',
+        },
+        'importing-main': {
+            visible: true,
+            mode: 'boot',
+            badge: 'BOOT',
+            title: BOOT_TITLE,
+            phase: 'Importing the app entry',
+            // 30 (not 82) so the bar visibly climbs the ~62 points the heartbeat +
+            // snippet drive during the long HTTP-module-load phase. The monotonic
+            // ratchet in `setBootStage` prevents earlier-but-higher stages from
+            // being clobbered.
+            progress: 30,
+            busy: true,
+            blocking: true,
+            tone: 'info',
+        },
+        'waiting-for-app': {
+            visible: true,
+            mode: 'boot',
+            badge: 'BOOT',
+            title: BOOT_TITLE,
+            phase: 'Waiting for the app root view',
+            progress: 94,
+            busy: true,
+            blocking: true,
+            tone: 'info',
+        },
+        'app-root-committed': {
+            visible: true,
+            mode: 'boot',
+            badge: 'READY',
+            title: BOOT_TITLE,
+            phase: 'Real app root committed',
+            progress: 100,
+            busy: false,
+            blocking: true,
+            tone: 'info',
+        },
+        ready: {
+            visible: true,
+            mode: 'boot',
+            badge: 'READY',
+            title: BOOT_TITLE,
+            phase: 'Boot complete',
+            progress: 100,
+            busy: false,
+            blocking: true,
+            tone: 'info',
+        },
+        error: {
+            visible: true,
+            mode: 'boot',
+            badge: 'RETRY',
+            title: BOOT_TITLE,
+            phase: 'Retrying after a boot failure',
+            progress: null,
+            busy: true,
+            blocking: true,
+            tone: 'error',
+        },
+    };
+    const base = phaseInfo[stage];
+    let detail = info?.detail || '';
+    if (!detail && stage === 'probing-origin' && info?.origin) {
+        detail = `Trying ${info.origin}`;
+    }
+    if (attemptText) {
+        detail = detail ? `${detail}  ${attemptText}` : attemptText;
+    }
+    return {
+        ...base,
+        detail,
+        progress: typeof info?.progress === 'number' || info?.progress === null ? info.progress : base.progress,
+    };
+}
+export function createConnectionOverlaySnapshot(stage, info) {
+    if (stage === 'healthy') {
+        return { ...DEFAULT_SNAPSHOT };
+    }
+    const phaseInfo = {
+        connecting: {
+            visible: true,
+            mode: 'connection',
+            badge: 'SOCKET',
+            title: 'Waiting for Vite dev server',
+            phase: 'Opening websocket connection',
+            detail: 'Live updates are paused until the connection is healthy.',
+            progress: null,
+            busy: true,
+            blocking: false,
+            tone: 'warn',
+        },
+        reconnecting: {
+            visible: true,
+            mode: 'connection',
+            badge: 'SOCKET',
+            title: 'HMR connection lost',
+            phase: 'Trying to reconnect Vite websocket',
+            detail: 'The app may be stale until the dev server reconnects.',
+            progress: null,
+            busy: true,
+            blocking: false,
+            tone: 'warn',
+        },
+        synchronizing: {
+            visible: true,
+            mode: 'connection',
+            badge: 'SYNC',
+            title: 'HMR connection restored',
+            phase: 'Synchronizing live-update state',
+            detail: 'Finalizing the module graph before dismissing the overlay.',
+            progress: 95,
+            busy: true,
+            blocking: false,
+            tone: 'info',
+        },
+        offline: {
+            visible: true,
+            mode: 'connection',
+            badge: 'OFFLINE',
+            title: 'Vite dev server offline',
+            phase: 'Please check your terminal.',
+            detail: 'The websocket and HTTP HMR path are both unavailable right now.',
+            progress: null,
+            busy: true,
+            blocking: false,
+            tone: 'error',
+        },
+    };
+    const base = phaseInfo[stage];
+    return {
+        ...base,
+        detail: info?.detail || base.detail,
+        progress: typeof info?.progress === 'number' || info?.progress === null ? info.progress : base.progress,
+    };
+}
+export function createUpdateOverlaySnapshot(stage, info) {
+    const phaseInfo = {
+        received: {
+            visible: true,
+            mode: 'update',
+            badge: 'HMR',
+            title: HMR_UPDATE_TITLE,
+            phase: 'Preparing update',
+            detail: '',
+            progress: 5,
+            busy: true,
+            blocking: false,
+            tone: 'success',
+        },
+        evicting: {
+            visible: true,
+            mode: 'update',
+            badge: 'HMR',
+            title: HMR_UPDATE_TITLE,
+            phase: 'Invalidating module cache',
+            detail: '',
+            progress: 30,
+            busy: true,
+            blocking: false,
+            tone: 'success',
+        },
+        reimporting: {
+            visible: true,
+            mode: 'update',
+            badge: 'HMR',
+            title: HMR_UPDATE_TITLE,
+            phase: 'Re-importing entry',
+            detail: '',
+            progress: 60,
+            busy: true,
+            blocking: false,
+            tone: 'success',
+        },
+        rebooting: {
+            visible: true,
+            mode: 'update',
+            badge: 'HMR',
+            title: HMR_UPDATE_TITLE,
+            phase: 'Rebooting Angular',
+            detail: '',
+            progress: 90,
+            busy: true,
+            blocking: false,
+            tone: 'success',
+        },
+        complete: {
+            visible: true,
+            mode: 'update',
+            badge: 'HMR',
+            title: HMR_UPDATE_DONE_TITLE,
+            phase: 'Update applied',
+            detail: '',
+            progress: 100,
+            busy: false,
+            blocking: false,
+            tone: 'success',
+        },
+    };
+    const base = phaseInfo[stage];
+    return {
+        ...base,
+        detail: info?.detail || base.detail,
+        progress: typeof info?.progress === 'number' || info?.progress === null ? info.progress : base.progress,
+    };
+}
+//# sourceMappingURL=dev-overlay-snapshots.js.map

package/hmr/shared/runtime/dev-overlay-snapshots.js.map

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

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

@@ -1,27 +1,6 @@
-type HmrOverlayTone = 'info' | 'warn' | 'error' | 'success';
-type HmrOverlayMode = 'hidden' | 'boot' | 'connection' | 'update';
-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;
-};
+import { type HmrBootStage, type HmrConnectionStage, type HmrOverlayPosition, type HmrOverlaySnapshot, type HmrOverlayStageInfo, type HmrUpdateStage } from './dev-overlay-snapshots.js';
+export { createBootOverlaySnapshot, createConnectionOverlaySnapshot, createUpdateOverlaySnapshot } from './dev-overlay-snapshots.js';
+export type { HmrBootStage, HmrConnectionStage, HmrOverlayPosition, HmrOverlaySnapshot, HmrOverlayStageInfo, HmrUpdateStage } from './dev-overlay-snapshots.js';
 type HmrOverlayApi = {
     ensureBootPage: (verbose?: boolean) => any | null;
     setBootStage: (stage: HmrBootStage, info?: HmrOverlayStageInfo) => HmrOverlaySnapshot;
@@ -30,9 +9,22 @@ type HmrOverlayApi = {
     hide: (reason?: string) => void;
     getSnapshot: () => 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;
+/**
+ * Resolve the configured live-overlay position.
+ *
+ * Reads `globalThis.__NS_HMR_OVERLAY_POSITION__` so a project can
+ * override the default at boot time (e.g. inside `app.ts` before the
+ * Vite session bootstraps). Falls back to 'top' which gives the
+ * toast-style chip with a slide-in animation and safe-area padding.
+ */
+export declare function getHmrDevOverlayPosition(): HmrOverlayPosition;
+/**
+ * Imperative setter for the live-overlay position. Re-applies the
+ * current snapshot so the change is visible without waiting for the
+ * next HMR cycle. Useful during dev to A/B between top/bottom/center
+ * without restarting the app.
+ */
+export declare function setHmrDevOverlayPosition(position: HmrOverlayPosition): void;
 /**
  * Returns the UIWindow level we use for the live/connection overlay. We lift
  * above `UIWindowLevelAlert` so system alerts (and any app-presented modal)
@@ -61,8 +53,17 @@ export type IosOverlayLayout = {
 /**
  * Layout math for the live overlay when it runs inside its own UIWindow.
  * Pure, deterministic and independent of UIKit so we can verify the rules
- * (max panel width, centered placement, safe-area clamping, sane defaults)
- * from tests.
+ * (max panel width, position-aware placement, safe-area clamping, sane
+ * defaults) from tests.
+ *
+ * `position` controls where the panel sits vertically:
+ *   - 'top':    hugs `safeInsets.top + toastVerticalInset` so the chip
+ *               sits just below the notch / Dynamic Island.
+ *   - 'bottom': hugs `viewHeight - safeInsets.bottom - panelHeight -
+ *               toastVerticalInset` so the chip sits just above the
+ *               home indicator / nav bar.
+ *   - 'center': original modal placement (vertically centered, clamped
+ *               so it never crosses the top safe-area inset).
  */
 export declare function computeIosOverlayLayout(input: {
     viewWidth: number;
@@ -75,11 +76,56 @@ export declare function computeIosOverlayLayout(input: {
     panelPadding?: number;
     interLabelSpacing?: number;
     minTopInset?: number;
+    position?: HmrOverlayPosition;
+    toastVerticalInset?: number;
 }): IosOverlayLayout;
+export type AndroidSafeAreaInsets = {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+};
+export type AndroidToastMargin = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+/**
+ * Margin math for the in-tree (Android) live/update toast chip.
+ *
+ * NativeScript enables edge-to-edge on every Android activity
+ * (`@nativescript/core` → `application.android.ts` → `enableEdgeToEdge`),
+ * so the page content — and therefore the overlay wrapper we inject into
+ * it — extends underneath the status bar and navigation bar. A fixed
+ * top/bottom margin leaves the chip tucked behind the system bars, where
+ * it gets clipped (Android 15 / API 35 enforces edge-to-edge, so this is
+ * now the norm rather than the exception).
+ *
+ * This pure helper folds the system-bar safe-area insets into the chip's
+ * margin so the toast always clears the status bar (top position) /
+ * navigation bar (bottom position). It is deterministic and free of
+ * native deps so the rules stay unit-testable — the runtime reads the
+ * live insets via `readAndroidSafeAreaInsets()` and forwards them here.
+ *
+ *   - 'top':    margin.top    = baseVerticalInset + safeInsets.top
+ *   - 'bottom': margin.bottom = baseVerticalInset + safeInsets.bottom
+ *   - 'center': fixed `centerMargin` all around (vertically centered, so
+ *               it never approaches the system bars on normal viewports).
+ *
+ * Horizontal margins always include the relevant safe-area inset so a
+ * landscape display cutout / gesture pill doesn't clip the chip edge.
+ */
+export declare function computeAndroidToastMargin(input: {
+    position: HmrOverlayPosition;
+    safeInsets?: AndroidSafeAreaInsets | null;
+    baseVerticalInset?: number;
+    baseHorizontalInset?: number;
+    centerMargin?: number;
+}): AndroidToastMargin;
 export declare function ensureHmrDevOverlayRuntimeInstalled(verbose?: boolean): HmrOverlayApi;
 export declare function createHmrBootOverlayPage(verbose?: boolean): any | null;
 export declare function setHmrBootStage(stage: HmrBootStage, info?: HmrOverlayStageInfo): HmrOverlaySnapshot;
 export declare function setHmrConnectionStage(stage: HmrConnectionStage, info?: HmrOverlayStageInfo): HmrOverlaySnapshot;
 export declare function setHmrUpdateStage(stage: HmrUpdateStage, info?: HmrOverlayStageInfo): HmrOverlaySnapshot;
 export declare function hideHmrDevOverlay(reason?: string): void;
-export {};