@nativescript/vite 8.0.0-alpha.1 → 8.0.0-alpha.11

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/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,51 @@
+// 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.
+// 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;AAiB5D,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/browser-runtime-contract.d.ts

@@ -0,0 +1,64 @@
+export type NsDevPlatform = 'ios' | 'android' | 'visionos';
+export type NsHostModuleId = `ns-host://${string}`;
+export declare const NS_HOST_RUNTIME_MODULE_ID: "ns-host://runtime";
+export declare const NS_HOST_STYLE_ADAPTER_MODULE_ID: "ns-host://style-adapter";
+export declare const NS_DEFAULT_HOST_MODULES: readonly ["ns-host://runtime", "ns-host://style-adapter"];
+export declare const NS_DEV_SESSION_REQUIRED_FIELDS: readonly ["sessionId", "origin", "entryUrl", "clientUrl", "wsUrl", "platform"];
+export interface NsDevFeatureFlags {
+    fullReload?: boolean;
+    cssHmr?: boolean;
+    errorOverlay?: boolean;
+    styleScopeHmr?: boolean;
+}
+export declare const NS_DEFAULT_DEV_FEATURE_FLAGS: Readonly<Required<Pick<NsDevFeatureFlags, 'fullReload' | 'cssHmr'>>>;
+export interface NsDevSessionDescriptor {
+    sessionId: string;
+    origin: string;
+    entryUrl: string;
+    clientUrl: string;
+    wsUrl: string;
+    platform: NsDevPlatform;
+    runtimeConfigUrl?: string;
+    hostModules?: NsHostModuleId[];
+    features?: NsDevFeatureFlags;
+}
+export interface NsRuntimeDevSessionConfig extends NsDevSessionDescriptor {
+}
+export interface NsStyleUpdatePayload {
+    url: string;
+    cssText: string;
+}
+export interface NsHotUpdateInvalidatePayload {
+    urls: string[];
+    updatedAt?: number;
+}
+export interface NsRuntimeImportMap {
+    imports: Record<string, string>;
+}
+export interface NsRuntimeConfigurePayload {
+    importMap: NsRuntimeImportMap;
+    volatilePatterns?: string[];
+}
+export interface NsRuntimeDevHostApi {
+    configureRuntime?: (config: NsRuntimeConfigurePayload) => void;
+    supportsRuntimeConfigUrl: boolean;
+    startDevSession: (config: NsRuntimeDevSessionConfig) => Promise<void>;
+    invalidateModules?: (urls: string[]) => void;
+    reloadDevApp?: () => Promise<void>;
+    applyStyleUpdate?: (payload: NsStyleUpdatePayload) => void;
+    getLoadedModuleUrls?: () => string[];
+}
+export declare function isNsDevPlatform(value: unknown): value is NsDevPlatform;
+export declare function assertNsDevSessionDescriptor(session: unknown): asserts session is NsDevSessionDescriptor;
+export declare function readNsRuntimeDevHostApi(target?: Partial<typeof globalThis>): NsRuntimeDevHostApi;
+declare global {
+    var __nsConfigureDevRuntime: ((config: NsRuntimeConfigurePayload) => void) | undefined;
+    var __nsConfigureRuntime: ((config: NsRuntimeConfigurePayload) => void) | undefined;
+    var __nsSupportsRuntimeConfigUrl: boolean | undefined;
+    var __nsStartDevSession: ((config: NsRuntimeDevSessionConfig) => Promise<void>) | undefined;
+    var __nsInvalidateModules: ((urls: string[]) => void) | undefined;
+    var __nsReloadDevApp: (() => Promise<void>) | undefined;
+    var __nsApplyStyleUpdate: ((payload: NsStyleUpdatePayload) => void) | undefined;
+    var __nsGetLoadedModuleUrls: (() => string[]) | undefined;
+}
+export {};

package/hmr/shared/runtime/browser-runtime-contract.js

@@ -0,0 +1,54 @@
+export const NS_HOST_RUNTIME_MODULE_ID = 'ns-host://runtime';
+export const NS_HOST_STYLE_ADAPTER_MODULE_ID = 'ns-host://style-adapter';
+export const NS_DEFAULT_HOST_MODULES = [NS_HOST_RUNTIME_MODULE_ID, NS_HOST_STYLE_ADAPTER_MODULE_ID];
+export const NS_DEV_SESSION_REQUIRED_FIELDS = ['sessionId', 'origin', 'entryUrl', 'clientUrl', 'wsUrl', 'platform'];
+export const NS_DEFAULT_DEV_FEATURE_FLAGS = {
+    fullReload: true,
+    cssHmr: true,
+};
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+export function isNsDevPlatform(value) {
+    return value === 'ios' || value === 'android' || value === 'visionos';
+}
+export function assertNsDevSessionDescriptor(session) {
+    if (!session || typeof session !== 'object') {
+        throw new Error('Invalid NativeScript dev session descriptor');
+    }
+    const candidate = session;
+    for (const key of NS_DEV_SESSION_REQUIRED_FIELDS) {
+        if (!isNonEmptyString(candidate[key])) {
+            throw new Error(`Missing dev session field: ${key}`);
+        }
+    }
+    if (!isNsDevPlatform(candidate.platform)) {
+        throw new Error(`Invalid dev session platform: ${String(candidate.platform)}`);
+    }
+    if (candidate.hostModules != null) {
+        if (!Array.isArray(candidate.hostModules) || candidate.hostModules.some((value) => !isNonEmptyString(value) || !String(value).startsWith('ns-host://'))) {
+            throw new Error('Invalid dev session hostModules');
+        }
+    }
+    if (candidate.runtimeConfigUrl != null && !isNonEmptyString(candidate.runtimeConfigUrl)) {
+        throw new Error('Invalid dev session runtimeConfigUrl');
+    }
+    if (candidate.features != null) {
+        if (typeof candidate.features !== 'object') {
+            throw new Error('Invalid dev session features');
+        }
+    }
+}
+export function readNsRuntimeDevHostApi(target = globalThis) {
+    return {
+        configureRuntime: target.__nsConfigureDevRuntime ?? target.__nsConfigureRuntime,
+        supportsRuntimeConfigUrl: target.__nsSupportsRuntimeConfigUrl === true,
+        startDevSession: target.__nsStartDevSession,
+        invalidateModules: target.__nsInvalidateModules,
+        reloadDevApp: target.__nsReloadDevApp,
+        applyStyleUpdate: target.__nsApplyStyleUpdate,
+        getLoadedModuleUrls: target.__nsGetLoadedModuleUrls,
+    };
+}
+export {};
+//# sourceMappingURL=browser-runtime-contract.js.map

package/hmr/shared/runtime/browser-runtime-contract.js.map

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

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

@@ -0,0 +1,85 @@
+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;
+};
+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 {};