@nativescript/vite 8.0.0-alpha.2 → 8.0.0-alpha.20

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

@@ -1,7 +1,9 @@
-type HmrOverlayTone = 'info' | 'warn' | 'error';
-type HmrOverlayMode = 'hidden' | 'boot' | 'connection';
-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' | 'ready' | 'error';
+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;
@@ -25,14 +27,87 @@ type HmrOverlayApi = {
     ensureBootPage: (verbose?: boolean) => any | null;
     setBootStage: (stage: HmrBootStage, info?: HmrOverlayStageInfo) => HmrOverlaySnapshot;
     setConnectionStage: (stage: HmrConnectionStage, info?: HmrOverlayStageInfo) => HmrOverlaySnapshot;
+    setUpdateStage: (stage: HmrUpdateStage, info?: HmrOverlayStageInfo) => HmrOverlaySnapshot;
     hide: (reason?: string) => void;
     getSnapshot: () => 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;
 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;
+/**
+ * Returns the UIWindow level we use for the live/connection overlay. We lift
+ * above `UIWindowLevelAlert` so system alerts (and any app-presented modal)
+ * stack underneath. When the platform does not expose `UIWindowLevelAlert`
+ * we fall back to the documented constant value (2000).
+ */
+export declare function computeIosOverlayWindowLevel(baseAlert?: number | null): number;
+export type IosSafeInsets = {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+};
+export type IosRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type IosOverlayLayout = {
+    backdrop: IosRect;
+    panel: IosRect;
+    title: IosRect;
+    status: IosRect;
+};
+/**
+ * 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, 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;
+    viewHeight: number;
+    safeInsets?: IosSafeInsets | null;
+    titleHeight: number;
+    statusHeight: number;
+    maxPanelWidth?: number;
+    horizontalMargin?: number;
+    panelPadding?: number;
+    interLabelSpacing?: number;
+    minTopInset?: number;
+    position?: HmrOverlayPosition;
+    toastVerticalInset?: number;
+}): IosOverlayLayout;
 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 {};