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

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

@@ -0,0 +1,17 @@
+export type BootTraceSegment = {
+    ok?: boolean;
+    ms?: number;
+    meta?: Record<string, unknown>;
+};
+export type BootTrace = {
+    t0: number;
+    t1?: number;
+    session?: BootTraceSegment;
+    importMap?: BootTraceSegment;
+    native?: BootTraceSegment;
+    error?: {
+        message: string;
+    };
+};
+export declare function formatBootTimeline(trace: BootTrace): string;
+export declare function publishBootTrace(trace: BootTrace): void;

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

@@ -0,0 +1,54 @@
+// 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.
+// 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] FAILED total=230ms session=45ms ...: <message>
+//
+// Segment entries are only included when a numeric `ms` was recorded —
+// this keeps the log compact when a particular phase was skipped (e.g.
+// `__NS_IMPORT_MAP_CONFIGURED__` dedup) or never reached (early error).
+export function formatBootTimeline(trace) {
+    const status = trace.error ? 'FAILED' : 'ok';
+    const parts = [];
+    const push = (label, seg) => {
+        if (seg && typeof seg.ms === 'number' && Number.isFinite(seg.ms)) {
+            parts.push(`${label}=${Math.max(0, Math.round(seg.ms))}ms`);
+        }
+    };
+    const total = typeof trace.t0 === 'number' && typeof trace.t1 === 'number' ? trace.t1 - trace.t0 : undefined;
+    if (typeof total === 'number' && Number.isFinite(total)) {
+        parts.push(`total=${Math.max(0, Math.round(total))}ms`);
+    }
+    push('session', trace.session);
+    push('importMap', trace.importMap);
+    push('native', trace.native);
+    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.
+export function publishBootTrace(trace) {
+    try {
+        globalThis.__NS_BOOT_TRACE__ = trace;
+    }
+    catch { }
+}
+//# sourceMappingURL=boot-timeline.js.map

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

@@ -0,0 +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"}

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

@@ -1,7 +1,8 @@
-type HmrOverlayTone = 'info' | 'warn' | 'error';
-type HmrOverlayMode = 'hidden' | 'boot' | 'connection';
+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;
@@ -25,14 +26,60 @@ 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;
 };
 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, centered placement, safe-area clamping, sane defaults)
+ * from tests.
+ */
+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;
+}): 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 {};