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

package/hmr/server/perf-instrumentation.js

@@ -0,0 +1,195 @@
+// Server-side perf instrumentation helpers.
+//
+// All exports are pure so they can be unit-tested without spinning up
+// Vite. The websocket middleware wires them in with its own logger.
+//
+// The three primitives are:
+//   1. `formatServerStartupBanner` — the always-on banner that prints
+//      on dev server startup so the user can confirm which build is
+//      live and which perf knobs are active.
+//   2. `createColdBootRequestCounter` — a richer counter that tracks
+//      the first burst of NativeScript dev routes (`/ns/m/**`, `/ns/rt/**`,
+//      `/ns/core/**`, `/__ns_boot__/**`, `/ns/import-map.json`,
+//      `/@nativescript/vendor.mjs`). Emits a rolling + final summary so
+//      cold-boot traffic is visible without flipping verbose mode.
+//   3. `formatPopulateInitialGraphSummary` — the single line we print
+//      when `populateInitialGraph` finishes. Includes module count and
+//      duration so it's trivial to spot regressions.
+// Single-line, human-scannable banner. We avoid pretty-printing (no
+// boxes/colors) so it plays well with piped logs and the Vite custom
+// logger. Format:
+//   [hmr-ws] @nativescript/vite@<version> — transformConcurrency=8 transformCacheMs=60000ms lazyInitialGraph=on graphVersion=1
+export function formatServerStartupBanner(input) {
+    const parts = [`transformConcurrency=${Math.max(1, Math.floor(input.transformConcurrency))}`, `transformCacheMs=${Math.max(0, Math.floor(input.transformCacheMs))}ms`, `lazyInitialGraph=${input.lazyInitialGraph ? 'on' : 'off'}`, `graphVersion=${Math.max(0, Math.floor(input.graphVersion))}`];
+    return `[hmr-ws] @nativescript/vite@${input.version} — ${parts.join(' ')}`;
+}
+/**
+ * Classify a URL path into a coarse route category. Any pathname that
+ * doesn't match a known NativeScript dev route is reported as `other`;
+ * callers are expected to filter their own irrelevant routes before
+ * calling `record()`.
+ */
+export function classifyBootRoute(pathname) {
+    if (!pathname || typeof pathname !== 'string')
+        return 'other';
+    if (pathname === '/ns/import-map.json')
+        return 'ns/import-map';
+    if (pathname === '/@nativescript/vendor.mjs' || pathname.startsWith('/@nativescript/'))
+        return 'ns/vendor';
+    if (pathname.startsWith('/ns/m/'))
+        return 'ns/m';
+    if (pathname.startsWith('/ns/rt/'))
+        return 'ns/rt';
+    if (pathname.startsWith('/ns/core/'))
+        return 'ns/core';
+    if (pathname.startsWith('/__ns_boot__/'))
+        return 'ns/boot';
+    if (pathname.startsWith('/__ns_hmr__/'))
+        return 'ns/hmr';
+    if (pathname.startsWith('/ns/'))
+        return 'ns/other';
+    return 'other';
+}
+// Factory for the cold-boot counter. Encapsulates all state in a closure
+// so the websocket module doesn't have to track timers itself, and so
+// this is trivially testable with a fake clock.
+export function createColdBootRequestCounter(options) {
+    const summaryEvery = Math.max(0, Math.floor(options.summaryEvery ?? 100));
+    const idleWindowMs = Math.max(100, Math.floor(options.idleWindowMs ?? 5000));
+    const now = options.now ?? (() => Date.now());
+    const setTimer = options.setTimer ?? ((handler, ms) => setTimeout(handler, ms));
+    const clearTimer = options.clearTimer ?? ((handle) => clearTimeout(handle));
+    let active = true;
+    let count = 0;
+    let inFlight = 0;
+    let maxConcurrent = 0;
+    let startedAt = null;
+    let firstRequestUrl = null;
+    let idleTimer = null;
+    const perRoute = {};
+    const formatPerRoute = () => {
+        const entries = Object.entries(perRoute);
+        if (entries.length === 0)
+            return '';
+        entries.sort((a, b) => b[1] - a[1]);
+        return entries.map(([k, v]) => `${k}=${v}`).join(',');
+    };
+    const fireFinal = () => {
+        if (!active)
+            return;
+        active = false;
+        // `startedAt` is set the first time `record()` fires. Use an explicit
+        // null check — `startedAt` can be 0 on deterministic test clocks and
+        // `startedAt ? ... : 0` would mis-treat that as "never started".
+        const ms = startedAt !== null ? now() - startedAt : 0;
+        const routes = formatPerRoute();
+        const routesPart = routes ? ` routes=${routes}` : '';
+        options.log(`[hmr-ws][cold-boot] window closed modules=${count} ms=${ms} maxConcurrent=${maxConcurrent}${routesPart}`);
+    };
+    const scheduleIdleClose = () => {
+        if (idleTimer !== null)
+            clearTimer(idleTimer);
+        idleTimer = setTimer(() => {
+            idleTimer = null;
+            fireFinal();
+        }, idleWindowMs);
+    };
+    return {
+        record(url) {
+            if (!active) {
+                return { finish: () => { } };
+            }
+            count += 1;
+            inFlight += 1;
+            if (inFlight > maxConcurrent)
+                maxConcurrent = inFlight;
+            if (startedAt === null) {
+                startedAt = now();
+                firstRequestUrl = url;
+            }
+            const route = classifyBootRoute(url);
+            perRoute[route] = (perRoute[route] ?? 0) + 1;
+            if (summaryEvery > 0 && count % summaryEvery === 0) {
+                // Same `startedAt === 0` consideration as in fireFinal().
+                const ms = startedAt !== null ? now() - startedAt : 0;
+                options.log(`[hmr-ws][cold-boot] progress modules=${count} ms=${ms} inFlight=${inFlight} maxConcurrent=${maxConcurrent}`);
+            }
+            scheduleIdleClose();
+            let finished = false;
+            return {
+                finish() {
+                    if (finished)
+                        return;
+                    finished = true;
+                    if (inFlight > 0)
+                        inFlight -= 1;
+                },
+            };
+        },
+        finalize() {
+            if (idleTimer !== null) {
+                clearTimer(idleTimer);
+                idleTimer = null;
+            }
+            fireFinal();
+        },
+        getState() {
+            return { active, count, inFlight, maxConcurrent, startedAt, firstRequestUrl, perRoute: { ...perRoute } };
+        },
+    };
+}
+// Summary line for `populateInitialGraph`. Stable shape so CI greps or
+// external dashboards can pick it up without fragile regexes.
+export function formatPopulateInitialGraphSummary(input) {
+    return `[hmr-ws][populate] modules=${Math.max(0, Math.floor(input.moduleCount))} ms=${Math.max(0, Math.floor(input.durationMs))} graphVersion=${Math.max(0, Math.floor(input.graphVersion))} bumpedVersion=${input.bumpedVersion ? 'yes' : 'no'}`;
+}
+/**
+ * Classify a file's HMR update kind by extension. Used by the server-side
+ * update summary so a quick log line tells us which pipeline ran. Returns
+ * `'unknown'` for anything that doesn't match a known dev-time extension —
+ * the caller decides whether to log it or skip it entirely.
+ */
+export function classifyHmrUpdateKind(file) {
+    if (!file || typeof file !== 'string')
+        return 'unknown';
+    const lower = file.toLowerCase();
+    if (lower.endsWith('.ts'))
+        return 'ts';
+    if (lower.endsWith('.tsx'))
+        return 'tsx';
+    if (lower.endsWith('.jsx'))
+        return 'jsx';
+    if (lower.endsWith('.html') || lower.endsWith('.htm'))
+        return 'html';
+    if (lower.endsWith('.css') || lower.endsWith('.scss') || lower.endsWith('.sass') || lower.endsWith('.less'))
+        return 'css';
+    if (lower.endsWith('.vue'))
+        return 'vue';
+    if (lower.endsWith('.mjs'))
+        return 'mjs';
+    if (lower.endsWith('.js'))
+        return 'js';
+    return 'unknown';
+}
+/**
+ * Single-line summary for the server side of an HMR update. Always-on so
+ * a 6-second `.ts` save is immediately visible without flipping verbose.
+ * Format:
+ *   [hmr-ws][update] kind=ts file=/src/foo.ts await=12ms framework=180ms broadcast=2ms total=194ms invalidated=23 recipients=1
+ *
+ * For Angular `.ts` updates, `narrowed=yes|no` is appended so the
+ * narrowing decision is immediately visible without flipping verbose:
+ *   [hmr-ws][update] kind=ts file=/src/app/foo.constants.ts ... invalidated=1 recipients=1 narrowed=yes
+ *   [hmr-ws][update] kind=ts file=/src/app/foo.component.ts ... invalidated=132 recipients=1 narrowed=no
+ */
+export function formatHmrUpdateSummary(input) {
+    const parts = [`kind=${input.kind || 'unknown'}`, `file=${input.file || '<unknown>'}`, `await=${Math.max(0, Math.floor(input.awaitMs))}ms`, `framework=${Math.max(0, Math.floor(input.frameworkMs))}ms`, `broadcast=${Math.max(0, Math.floor(input.broadcastMs))}ms`, `total=${Math.max(0, Math.floor(input.totalMs))}ms`, `invalidated=${Math.max(0, Math.floor(input.invalidated))}`, `recipients=${Math.max(0, Math.floor(input.recipients))}`];
+    if (input.narrowed === true) {
+        parts.push('narrowed=yes');
+    }
+    else if (input.narrowed === false) {
+        parts.push('narrowed=no');
+    }
+    return `[hmr-ws][update] ${parts.join(' ')}`;
+}
+//# sourceMappingURL=perf-instrumentation.js.map

package/hmr/server/perf-instrumentation.js.map

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

package/hmr/server/runtime-graph-filter.d.ts

@@ -0,0 +1,5 @@
+export declare function normalizeRuntimeGraphPath(value: string): string;
+export declare function isRuntimeGraphExcludedPath(value: string): boolean;
+export declare function shouldSkipRuntimeGraphDirectoryName(name: string): boolean;
+export declare function shouldIncludeRuntimeGraphFile(value: string, filePattern: RegExp): boolean;
+export declare function matchesRuntimeGraphModuleId(value: string, appPrefix: string, filePattern: RegExp): boolean;

package/hmr/server/runtime-graph-filter.js

@@ -0,0 +1,21 @@
+export function normalizeRuntimeGraphPath(value) {
+    return String(value || '')
+        .replace(/\\/g, '/')
+        .replace(/[?#].*$/, '');
+}
+export function isRuntimeGraphExcludedPath(value) {
+    const normalized = normalizeRuntimeGraphPath(value);
+    return /(?:^|\/)(?:__tests__|__mocks__)(?:\/|$)|(?:^|\/)[^/]+\.(?:spec|test)\.[^/]+$/i.test(normalized);
+}
+export function shouldSkipRuntimeGraphDirectoryName(name) {
+    return name === '__tests__' || name === '__mocks__';
+}
+export function shouldIncludeRuntimeGraphFile(value, filePattern) {
+    const normalized = normalizeRuntimeGraphPath(value);
+    return filePattern.test(normalized) && !isRuntimeGraphExcludedPath(normalized);
+}
+export function matchesRuntimeGraphModuleId(value, appPrefix, filePattern) {
+    const normalized = normalizeRuntimeGraphPath(value);
+    return normalized.startsWith(appPrefix) && filePattern.test(normalized) && !isRuntimeGraphExcludedPath(normalized);
+}
+//# sourceMappingURL=runtime-graph-filter.js.map

package/hmr/server/runtime-graph-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-graph-filter.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/runtime-graph-filter.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACtD,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;SACxB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAa;IACvD,MAAM,UAAU,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,+EAA+E,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,IAAY;IAC/D,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAa,EAAE,WAAmB;IAC/E,MAAM,UAAU,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAa,EAAE,SAAiB,EAAE,WAAmB;IAChG,MAAM,UAAU,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC;AACpH,CAAC"}

package/hmr/server/shared-transform-request.d.ts

@@ -0,0 +1,12 @@
+import type { TransformResult } from 'vite';
+export type SharedTransformRequestRunnerOptions = {
+    maxConcurrent?: number;
+    resultCacheTtlMs?: number;
+    getResultCacheKey?: (url: string) => string;
+};
+export type SharedTransformRequestRunner = ((url: string, timeoutMs?: number) => Promise<TransformResult | null>) & {
+    invalidate: (url: string) => void;
+    invalidateMany: (urls: Iterable<string>) => void;
+    clear: () => void;
+};
+export declare function createSharedTransformRequestRunner(transformRequest: (url: string) => Promise<TransformResult | null>, onTimeout?: (url: string, timeoutMs: number) => void, options?: SharedTransformRequestRunnerOptions): SharedTransformRequestRunner;

package/hmr/server/shared-transform-request.js

@@ -0,0 +1,144 @@
+export function createSharedTransformRequestRunner(transformRequest, onTimeout, options = {}) {
+    const inFlight = new Map();
+    const recentResults = new Map();
+    const cacheGenerations = new Map();
+    const queue = [];
+    const maxConcurrent = Math.max(1, Math.floor(options.maxConcurrent ?? 1));
+    const resultCacheTtlMs = Math.max(0, Math.floor(options.resultCacheTtlMs ?? 0));
+    const getResultCacheKey = options.getResultCacheKey ?? ((url) => url);
+    let activeCount = 0;
+    const getCacheGeneration = (cacheKey) => cacheGenerations.get(cacheKey) ?? 0;
+    const invalidateCacheKey = (cacheKey) => {
+        cacheGenerations.set(cacheKey, getCacheGeneration(cacheKey) + 1);
+        recentResults.delete(cacheKey);
+    };
+    const pruneRecentResults = () => {
+        if (!recentResults.size) {
+            return;
+        }
+        const now = Date.now();
+        for (const [key, entry] of recentResults) {
+            if (entry.expiresAt <= now) {
+                recentResults.delete(key);
+            }
+        }
+    };
+    const rememberRecentResult = (url, result, generation) => {
+        if (!result || resultCacheTtlMs <= 0) {
+            return;
+        }
+        const cacheKey = getResultCacheKey(url);
+        if (getCacheGeneration(cacheKey) !== generation) {
+            return;
+        }
+        recentResults.delete(cacheKey);
+        recentResults.set(cacheKey, {
+            expiresAt: Date.now() + resultCacheTtlMs,
+            result,
+        });
+        if (recentResults.size > 512) {
+            const oldestKey = recentResults.keys().next().value;
+            if (oldestKey) {
+                recentResults.delete(oldestKey);
+            }
+        }
+    };
+    const runNext = () => {
+        while (activeCount < maxConcurrent) {
+            const next = queue.shift();
+            if (!next) {
+                return;
+            }
+            activeCount += 1;
+            next();
+        }
+    };
+    const schedule = (task) => {
+        let resolveStarted = null;
+        const started = new Promise((resolve) => {
+            resolveStarted = resolve;
+        });
+        const execution = new Promise((resolve, reject) => {
+            queue.push(() => {
+                let started;
+                resolveStarted?.();
+                try {
+                    started = Promise.resolve(task());
+                }
+                catch (error) {
+                    started = Promise.reject(error);
+                }
+                started.then(resolve, reject).finally(() => {
+                    activeCount = Math.max(0, activeCount - 1);
+                    runNext();
+                });
+            });
+            runNext();
+        });
+        return { execution, started };
+    };
+    const withTimeout = (entry, url, timeoutMs) => {
+        if (!(timeoutMs > 0)) {
+            return entry.execution;
+        }
+        return entry.started.then(() => new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                try {
+                    onTimeout?.(url, timeoutMs);
+                }
+                catch { }
+            }, timeoutMs);
+            entry.execution.then(resolve, reject).finally(() => {
+                clearTimeout(timer);
+            });
+        }));
+    };
+    const runner = ((url, timeoutMs = 120000) => {
+        pruneRecentResults();
+        const cacheKey = getResultCacheKey(url);
+        const generation = getCacheGeneration(cacheKey);
+        const recent = recentResults.get(cacheKey);
+        if (recent && recent.expiresAt > Date.now()) {
+            return Promise.resolve(recent.result);
+        }
+        // Key the in-flight map on the canonical `cacheKey`, not the raw URL,
+        // so two concurrent calls for `/foo.ts?t=1` and `/foo.ts?t=2` share a
+        // single transform rather than doing the same work twice. The cache
+        // key already strips `?t=` and `?v=` cache-busters and sorts the
+        // remaining query — see `canonicalizeTransformRequestCacheKey`. This
+        // pairs with `rememberRecentResult`, which was always keyed by
+        // cacheKey.
+        const existingExecution = inFlight.get(cacheKey);
+        if (existingExecution && existingExecution.generation === generation) {
+            return withTimeout(existingExecution, url, timeoutMs);
+        }
+        const scheduled = schedule(async () => {
+            const result = await Promise.resolve(transformRequest(url));
+            rememberRecentResult(url, result, generation);
+            return result;
+        });
+        let execution;
+        execution = scheduled.execution.finally(() => {
+            if (inFlight.get(cacheKey)?.execution === execution) {
+                inFlight.delete(cacheKey);
+            }
+        });
+        const entry = { execution, started: scheduled.started, cacheKey, generation };
+        inFlight.set(cacheKey, entry);
+        return withTimeout(entry, url, timeoutMs);
+    });
+    runner.invalidate = (url) => {
+        invalidateCacheKey(getResultCacheKey(url));
+    };
+    runner.invalidateMany = (urls) => {
+        for (const url of urls || []) {
+            runner.invalidate(url);
+        }
+    };
+    runner.clear = () => {
+        recentResults.clear();
+        cacheGenerations.clear();
+    };
+    return runner;
+}
+//# sourceMappingURL=shared-transform-request.js.map

package/hmr/server/shared-transform-request.js.map

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

package/hmr/server/vite-plugin.d.ts

@@ -1,5 +1,25 @@
 import type { Plugin } from 'vite';
+import { type NsDevPlatform, type NsDevSessionDescriptor } from '../shared/runtime/browser-runtime-contract.js';
+export declare function computeClientImportSpecifier(options: {
+    projectRoot: string;
+    clientFsPath: string;
+}): string;
+export declare function resolveProjectMainEntryPath(projectRoot: string): string;
+export declare function createNsDevSessionDescriptor(options: {
+    projectRoot: string;
+    requestHost: string;
+    platform: NsDevPlatform;
+    sessionId: string;
+    secure?: boolean;
+    mainEntryPathname?: string;
+}): NsDevSessionDescriptor;
+export declare function createNsDevClientBootstrapCode(options: {
+    wsUrl: string;
+    origin: string;
+    clientImport: string;
+    verbose?: boolean;
+}): string;
 export declare function nsHmrClientVitePlugin(opts: {
-    platform: string;
+    platform: NsDevPlatform;
     verbose?: boolean;
 }): Plugin;