@nativescript/vite 8.0.0-alpha.9 → 8.0.0-dev.0

package/hmr/server/boot-recording.js

@@ -0,0 +1,214 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import * as path from 'node:path';
+import { resolvePlatform } from '../../helpers/cli-flags.js';
+import { getProjectFlavor } from '../../helpers/flavor.js';
+// Cold-boot request recording.
+//
+// A real cold boot fetches hundreds of `/ns/m/node_modules/...` bodies (deep
+// ESM packages like rxjs) that no static analysis can enumerate up front.
+// This recorder captures the EXACT prefetchable URL set served during a boot
+// window; the deps-bundle service (`resolveDepsEntriesFromRecording`) folds
+// those recorded deep files into the single-eval `/ns/deps-bundle.mjs`, so
+// the NEXT boot serves them as one payload instead of per-module fetches.
+//
+// Lifecycle: a recording session opens when the device fetches the session
+// descriptor (`/__ns_dev__/session` — requested exactly once per boot by the
+// session bootstrap), collects every successfully-served prefetchable
+// request, and closes after an idle window. Closed sessions replace the
+// previous recording and persist to
+// `node_modules/.ns-vite/boot-closure-<platform>-<flavor>.json` so a fresh
+// dev-server start benefits too.
+//
+// Self-healing: only 2xx responses are recorded, so deleted modules (404s)
+// drop out on the next boot. Stale-but-servable entries are harmless — the
+// deps bundle simply carries an unused entry until the next recording.
+export const BOOT_RECORDING_VERSION = 1;
+/** Endpoints whose request marks the start of a device boot. */
+export const BOOT_SIGNAL_PATHS = new Set(['/__ns_dev__/session']);
+// Non-JS resource types can never become deps-bundle entries, so recording
+// them would only bloat the closure.
+const NON_JS_EXT_RE = /\.(css|scss|sass|less|json|html|htm|png|jpe?g|gif|svg|webp|ico|woff2?|ttf|otf|eot|mp3|mp4|webm|wav|map)$/i;
+// Volatile cache-buster query param (`?t=169…` / `&t=169…`). URLs carrying it
+// are freshly minted per request (Vite HMR timestamps, the Angular
+// `@ng/component?c=…&t=…` refresh route), so a recorded copy can never match
+// a future boot's request — recording them only grows the closure by one dead
+// variant per boot.
+const VOLATILE_T_PARAM_RE = /[?&]t=\d+(?:&|$)/;
+/**
+ * True when a request path is served through the device module loader and is
+ * therefore worth recording for the next boot's deps bundle. Matches the URL
+ * spaces the HTTP ESM loader fetches: `/ns/m/**`, the `/ns/rt` + `/ns/core`
+ * bridges, the core and deps bundles, Vue SFC artifacts, the served vendor
+ * bundle, and the dev client bootstrap.
+ */
+export function isPrefetchableBootPath(pathWithSearch) {
+    if (!pathWithSearch || !pathWithSearch.startsWith('/'))
+        return false;
+    if (VOLATILE_T_PARAM_RE.test(pathWithSearch))
+        return false;
+    const pathname = pathWithSearch.split('?')[0];
+    if (NON_JS_EXT_RE.test(pathname))
+        return false;
+    if (pathname === '/ns/import-map.json')
+        return false;
+    if (pathname.startsWith('/ns/m/'))
+        return true;
+    if (pathname === '/ns/rt' || pathname.startsWith('/ns/rt/'))
+        return true;
+    if (pathname === '/ns/core' || pathname.startsWith('/ns/core/'))
+        return true;
+    if (pathname === '/ns/core-bundle.mjs')
+        return true;
+    if (pathname === '/ns/deps-bundle.mjs')
+        return true;
+    if (pathname.startsWith('/ns/sfc/') || pathname.startsWith('/ns/asm/'))
+        return true;
+    if (pathname === '/@nativescript/vendor.mjs')
+        return true;
+    if (pathname === '/__ns_dev__/client')
+        return true;
+    return false;
+}
+export function getBootRecordingFilePath(projectRoot, platform, flavor) {
+    return path.join(projectRoot, 'node_modules', '.ns-vite', `boot-closure-${platform}-${flavor}.json`);
+}
+/** Load a persisted recording; null when absent, invalid, or mismatched. */
+export function loadPersistedBootRecording(projectRoot, platform, flavor) {
+    try {
+        const file = getBootRecordingFilePath(projectRoot, platform, flavor);
+        if (!existsSync(file))
+            return null;
+        const parsed = JSON.parse(readFileSync(file, 'utf-8'));
+        if (!parsed || parsed.version !== BOOT_RECORDING_VERSION)
+            return null;
+        if (parsed.platform !== platform || parsed.flavor !== flavor)
+            return null;
+        // Re-apply the prefetchability filter on load so recordings written by
+        // an older filter (or hand-edited files) shed dead entries.
+        const paths = Array.isArray(parsed.paths) ? parsed.paths.filter((p) => typeof p === 'string' && isPrefetchableBootPath(p)) : [];
+        return paths.length ? paths : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function createBootRecorder(options) {
+    const idleWindowMs = Math.max(500, Math.floor(options.idleWindowMs ?? 5000));
+    const minEntries = Math.max(1, Math.floor(options.minEntries ?? 5));
+    const maxEntries = Math.max(minEntries, Math.floor(options.maxEntries ?? 5000));
+    const persist = options.persist !== false;
+    const now = options.now ?? (() => Date.now());
+    const setTimer = options.setTimer ?? ((handler, ms) => setTimeout(handler, ms));
+    const clearTimer = options.clearTimer ?? ((handle) => clearTimeout(handle));
+    const log = options.log ?? (() => { });
+    let best = persist ? loadPersistedBootRecording(options.projectRoot, options.platform, options.flavor) : null;
+    let session = null;
+    let idleTimer = null;
+    const persistBest = () => {
+        if (!persist || !best)
+            return;
+        try {
+            const file = getBootRecordingFilePath(options.projectRoot, options.platform, options.flavor);
+            mkdirSync(path.dirname(file), { recursive: true });
+            writeFileSync(file, JSON.stringify({
+                version: BOOT_RECORDING_VERSION,
+                platform: options.platform,
+                flavor: options.flavor,
+                recordedAt: now(),
+                paths: best,
+            }));
+        }
+        catch (error) {
+            log(`[hmr-ws][boot-record] persist failed: ${error?.message || error}`);
+        }
+    };
+    const closeSession = () => {
+        if (idleTimer !== null) {
+            clearTimer(idleTimer);
+            idleTimer = null;
+        }
+        if (!session)
+            return;
+        const finished = session;
+        session = null;
+        if (finished.order.length < minEntries) {
+            log(`[hmr-ws][boot-record] discarded window with ${finished.order.length} entries (< ${minEntries})`);
+            return;
+        }
+        best = finished.order.slice(0, maxEntries);
+        persistBest();
+        log(`[hmr-ws][boot-record] captured ${best.length} boot urls in ${Math.max(0, now() - finished.startedAt)}ms`);
+    };
+    const armIdle = () => {
+        if (idleTimer !== null)
+            clearTimer(idleTimer);
+        idleTimer = setTimer(() => {
+            idleTimer = null;
+            closeSession();
+        }, idleWindowMs);
+    };
+    const openSession = () => {
+        closeSession();
+        session = { order: [], seen: new Set(), startedAt: now() };
+        armIdle();
+    };
+    const record = (pathWithSearch) => {
+        if (!session || session.order.length >= maxEntries)
+            return;
+        if (session.seen.has(pathWithSearch))
+            return;
+        session.seen.add(pathWithSearch);
+        session.order.push(pathWithSearch);
+    };
+    return {
+        noteRequest(pathWithSearch) {
+            const pathname = pathWithSearch.split('?')[0];
+            if (BOOT_SIGNAL_PATHS.has(pathname)) {
+                openSession();
+                return null;
+            }
+            if (!session)
+                return null;
+            if (!isPrefetchableBootPath(pathWithSearch))
+                return null;
+            armIdle();
+            let done = false;
+            return (statusCode) => {
+                if (done)
+                    return;
+                done = true;
+                if (!session)
+                    return;
+                if (!(statusCode >= 200 && statusCode < 300))
+                    return;
+                record(pathWithSearch);
+                armIdle();
+            };
+        },
+        getRecordedPaths() {
+            return best ? best.slice() : null;
+        },
+        closeActiveSession() {
+            closeSession();
+        },
+    };
+}
+/**
+ * Standard dev-server construction: resolves platform/flavor from the
+ * project, honors `NS_VITE_HMR_DISABLE_BOOT_RECORDING` (returns null) and
+ * `NS_VITE_HMR_BOOT_RECORD_IDLE_MS`.
+ */
+export function createBootRecorderFromEnv(projectRoot, log) {
+    const disabled = process.env.NS_VITE_HMR_DISABLE_BOOT_RECORDING === '1' || process.env.NS_VITE_HMR_DISABLE_BOOT_RECORDING === 'true';
+    if (disabled)
+        return null;
+    const configuredIdleMs = Number.parseInt(process.env.NS_VITE_HMR_BOOT_RECORD_IDLE_MS || '', 10);
+    return createBootRecorder({
+        platform: resolvePlatform() || 'ios',
+        flavor: getProjectFlavor(),
+        projectRoot,
+        idleWindowMs: Number.isFinite(configuredIdleMs) && configuredIdleMs > 0 ? configuredIdleMs : undefined,
+        log,
+    });
+}
+//# sourceMappingURL=boot-recording.js.map

package/hmr/server/boot-recording.js.map

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

package/hmr/server/constants.js

@@ -24,7 +24,13 @@ export const IMPORT_PATTERN_SIDE_EFFECT = /((?:^|\n)\s*import\s+["'])([^"']+)(["
 export const VUE_FILE_PATTERN = /\.vue(?:\?[^"']*)?$/;
 export const VUE_FILE_IMPORT = /((?:^|\n)\s*import\s+[^'";]*?\s+from\s+["'])([^"']+\.vue(?:\?[^"']*)?)(["'];?)/g;
 // Vite/HMR noise cleanup
-export const VITE_CLIENT_IMPORT = /(?:^|\n)\s*import\s+['"](?:\/@vite\/client|@vite\/client)['"];?/g;
+// Matches BOTH the side-effect form (`import "/@vite/client";`) and the named
+// form Vite 8 emits (`import { injectQuery as __vite__injectQuery } from "/@vite/client";`).
+// NOT line-anchored: Vite 8 concatenates injected imports onto the module's
+// original first line, so an anchored pattern either misses or over-deletes.
+// Group 1 (the preceding `^`/newline/`;` boundary) MUST be preserved by
+// replacements (`replace(..., '$1')`) so the prior statement keeps its terminator.
+export const VITE_CLIENT_IMPORT = /(^|[\n;])\s*import\s+(?:[\w$]+\s*,\s*)?(?:\{[^}]*\}\s+from\s+|[\w$]+\s+from\s+|\*\s+as\s+[\w$]+\s+from\s+)?['"](?:\/@vite\/client|@vite\/client)['"];?/g;
 // Strip Vite's injected `import.meta.hot = __vite__createHotContext(...)` assignment.
 // Important: it may appear mid-line after other tokens/spaces in sanitized HTTP output,
 // so we cannot rely on it starting at BOL.

package/hmr/server/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/constants.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,qGAAqG;AAErG,uBAAuB;AACvB,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,sCAAsC,GAAG,0CAA0C,CAAC;AAEjG,8CAA8C;AAC9C,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,wEAAwE;AACxE,8BAA8B;AAC9B,kDAAkD;AAClD,qBAAqB;AACrB,8CAA8C;AAC9C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAG,+DAA+D,CAAC;AAChG,MAAM,CAAC,MAAM,gBAAgB,GAAG,+DAA+D,CAAC;AAChG,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,uCAAuC,CAAC;AACxE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,6CAA6C,CAAC;AAExF,wBAAwB;AACxB,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,iFAAiF,CAAC;AAEjH,yBAAyB;AACzB,MAAM,CAAC,MAAM,kBAAkB,GAAG,kEAAkE,CAAC;AACrG,sFAAsF;AACtF,wFAAwF;AACxF,2CAA2C;AAC3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,sCAAsC,CAAC;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAAG,+DAA+D,CAAC;AAErG,uEAAuE;AACvE,MAAM,CAAC,MAAM,iBAAiB,GAAG,kEAAkE,CAAC;AACpG,MAAM,CAAC,MAAM,qBAAqB,GAAG,sEAAsE,CAAC;AAC5G,MAAM,CAAC,MAAM,qBAAqB,GAAG,+CAA+C,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/constants.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,qGAAqG;AAErG,uBAAuB;AACvB,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,sCAAsC,GAAG,0CAA0C,CAAC;AAEjG,8CAA8C;AAC9C,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,wEAAwE;AACxE,8BAA8B;AAC9B,kDAAkD;AAClD,qBAAqB;AACrB,8CAA8C;AAC9C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAG,+DAA+D,CAAC;AAChG,MAAM,CAAC,MAAM,gBAAgB,GAAG,+DAA+D,CAAC;AAChG,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,uCAAuC,CAAC;AACxE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,6CAA6C,CAAC;AAExF,wBAAwB;AACxB,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,iFAAiF,CAAC;AAEjH,yBAAyB;AACzB,8EAA8E;AAC9E,6FAA6F;AAC7F,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,mFAAmF;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,yJAAyJ,CAAC;AAC5L,sFAAsF;AACtF,wFAAwF;AACxF,2CAA2C;AAC3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,sCAAsC,CAAC;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAAG,+DAA+D,CAAC;AAErG,uEAAuE;AACvE,MAAM,CAAC,MAAM,iBAAiB,GAAG,kEAAkE,CAAC;AACpG,MAAM,CAAC,MAAM,qBAAqB,GAAG,sEAAsE,CAAC;AAC5G,MAAM,CAAC,MAAM,qBAAqB,GAAG,+CAA+C,CAAC"}

package/hmr/server/content-css-update.d.ts

@@ -0,0 +1,54 @@
+import type { ViteDevServer } from 'vite';
+import type { WebSocketServer } from 'ws';
+import type { CssUpdateItem } from '../shared/protocol.js';
+export interface ContentCssUpdateOptions {
+    server: ViteDevServer;
+    file: string;
+    root: string;
+    wss: WebSocketServer;
+    isSocketClientOpen: (client: {
+        readyState?: number;
+        OPEN?: number;
+    } | null | undefined) => boolean;
+    /**
+     * The active framework strategy's `defersContentCssToFrameworkUpdate`
+     * verdict for this file: `true` routes the update into the framework's own
+     * message (returned as `deferredCssUpdates`) instead of broadcasting.
+     */
+    deferToFrameworkUpdate: boolean;
+    verbose: boolean;
+}
+export interface ContentCssUpdateResult {
+    /** Present when the framework tail must carry the CSS update in its own message. */
+    deferredCssUpdates?: CssUpdateItem[];
+    /** Open sockets the standalone `ns:css-updates` broadcast reached. */
+    recipients: number;
+}
+/**
+ * Tailwind / content-scanning CSS routing for non-CSS edits.
+ *
+ * Background: when a `.html` template or `.ts` file scanned by Tailwind's
+ * `content` config gains a brand-new utility class (e.g. a `pt-6` never used
+ * before), the booted CSS bundle has no rule for it — the template HMR swaps
+ * the markup, the class lookup misses, and the layout regresses.
+ *
+ * In a stock Vite setup the `vite:css` plugin registers each PostCSS content
+ * dependency as an importer of the CSS module, so a content edit invalidates
+ * the CSS through the moduleGraph. NS HMR breaks that chain: `app.css` loads
+ * through `virtual:ns-app-css` whose `load` hook calls `preprocessCSS(...)`
+ * and emits a JS module — the CSS is never a moduleGraph node, so the importer
+ * chain never forms. `mainEntryPlugin` bridges the gap by tracking the
+ * `preprocessCSS` dep set on the server (see `AppCssState`).
+ *
+ * When the changed file is in that set, regenerate the stylesheet and compare
+ * with the previous output. Ordinary content edits are skipped; output that
+ * actually changed is either broadcast as `ns:css-updates` or — when the
+ * framework's own update message must carry it (Angular TS reboots, via the
+ * `defersContentCssToFrameworkUpdate` strategy hook) — returned as
+ * `deferredCssUpdates` so the device serializes CSS with the framework's
+ * update cycle instead of racing view-tree teardown.
+ *
+ * Never throws: refresh is non-throwing by contract and the broadcast guards
+ * each send.
+ */
+export declare function processContentCssUpdate(opts: ContentCssUpdateOptions): Promise<ContentCssUpdateResult>;

package/hmr/server/content-css-update.js

@@ -0,0 +1,78 @@
+import * as path from 'path';
+import { getAppCssState } from '../../helpers/app-css-state.js';
+import { appCssRootRelPath, buildCssUpdateItem, buildCssUpdatesMessage } from './css-update-message.js';
+/**
+ * Tailwind / content-scanning CSS routing for non-CSS edits.
+ *
+ * Background: when a `.html` template or `.ts` file scanned by Tailwind's
+ * `content` config gains a brand-new utility class (e.g. a `pt-6` never used
+ * before), the booted CSS bundle has no rule for it — the template HMR swaps
+ * the markup, the class lookup misses, and the layout regresses.
+ *
+ * In a stock Vite setup the `vite:css` plugin registers each PostCSS content
+ * dependency as an importer of the CSS module, so a content edit invalidates
+ * the CSS through the moduleGraph. NS HMR breaks that chain: `app.css` loads
+ * through `virtual:ns-app-css` whose `load` hook calls `preprocessCSS(...)`
+ * and emits a JS module — the CSS is never a moduleGraph node, so the importer
+ * chain never forms. `mainEntryPlugin` bridges the gap by tracking the
+ * `preprocessCSS` dep set on the server (see `AppCssState`).
+ *
+ * When the changed file is in that set, regenerate the stylesheet and compare
+ * with the previous output. Ordinary content edits are skipped; output that
+ * actually changed is either broadcast as `ns:css-updates` or — when the
+ * framework's own update message must carry it (Angular TS reboots, via the
+ * `defersContentCssToFrameworkUpdate` strategy hook) — returned as
+ * `deferredCssUpdates` so the device serializes CSS with the framework's
+ * update cycle instead of racing view-tree teardown.
+ *
+ * Never throws: refresh is non-throwing by contract and the broadcast guards
+ * each send.
+ */
+export async function processContentCssUpdate(opts) {
+    const { server, file, root, wss, isSocketClientOpen, deferToFrameworkUpdate, verbose } = opts;
+    const none = { recipients: 0 };
+    const appCssState = getAppCssState(server);
+    if (!appCssState?.deps || !appCssState.path) {
+        return none;
+    }
+    const normalizedFile = path.resolve(file).replace(/\\/g, '/');
+    if (!appCssState.deps.has(normalizedFile)) {
+        return none;
+    }
+    const { changed } = await appCssState.refresh();
+    if (!changed) {
+        if (verbose)
+            console.info(`[ns-hmr][server] Tailwind/PostCSS output unchanged after ${path.basename(file)}; skipped app.css refresh`);
+        return none;
+    }
+    const appCssRel = appCssRootRelPath(root, appCssState.path);
+    if (!appCssRel) {
+        return none;
+    }
+    const update = buildCssUpdateItem(appCssRel);
+    if (deferToFrameworkUpdate) {
+        if (verbose)
+            console.info(`[ns-hmr][server] Tailwind/PostCSS output changed after ${path.basename(file)}; deferred ${appCssRel} to framework update`);
+        return { deferredCssUpdates: [update], recipients: 0 };
+    }
+    let recipients = 0;
+    try {
+        const payload = JSON.stringify(buildCssUpdatesMessage(server, [update]));
+        wss.clients.forEach((client) => {
+            if (isSocketClientOpen(client)) {
+                try {
+                    client.send(payload);
+                    recipients += 1;
+                }
+                catch { }
+            }
+        });
+        if (verbose)
+            console.info(`[ns-hmr][server] Tailwind/PostCSS content-file edit (${path.basename(file)}) broadcast ${appCssRel}`);
+    }
+    catch (error) {
+        console.warn('[hmr-ws] CSS content-source broadcast failed:', error);
+    }
+    return { recipients };
+}
+//# sourceMappingURL=content-css-update.js.map

package/hmr/server/content-css-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-css-update.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/content-css-update.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAyBxG;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAA6B;IAC1E,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC9F,MAAM,IAAI,GAA2B,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAEvD,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACb,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9D,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,IAAI,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,4DAA4D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACtI,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACb,CAAC;IACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAE7C,IAAI,sBAAsB,EAAE,CAAC;QAC5B,IAAI,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,0DAA0D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,SAAS,sBAAsB,CAAC,CAAC;QACtJ,OAAO,EAAE,kBAAkB,EAAE,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YAC9B,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACJ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACrB,UAAU,IAAI,CAAC,CAAC;gBACjB,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;YACX,CAAC;QACF,CAAC,CAAC,CAAC;QACH,IAAI,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,wDAAwD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC;IAClI,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,+CAA+C,EAAE,KAAK,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,CAAC;AACvB,CAAC"}

package/hmr/server/core-bundle.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Single-eval @nativescript/core bundle for device serving (bundle mode).
+ *
+ * DEFAULT MODE (consumers)
+ * ------------------------
+ * Instead of serving @nativescript/core per-module through Vite's transform
+ * pipeline (~hundreds of serial HTTP fetches + per-file transforms during cold
+ * boot), the dev server pre-bundles the ENTIRE core package with esbuild into
+ * one ESM payload served at `GET /ns/core-bundle.mjs`. The canonical
+ * `/ns/core[/<sub>]` URL space is preserved — those routes serve THIN SHIMS
+ * that statically import the bundle and re-export the requested subpath's
+ * namespace from the `globalThis.__NS_CORE_MODULES__` registry the bundle
+ * populates. Because every shim's only dependency is the one bundle URL,
+ * V8/iOS evaluates core exactly once per app lifetime — the single-realm
+ * invariant is enforced by construction, with ONE big prefetchable payload
+ * instead of a deep serial fetch chain.
+ *
+ * OPT-IN PER-MODULE MODE (core maintainers)
+ * -----------------------------------------
+ * Set `NS_CORE_PER_MODULE=1` to keep the classic per-module `/ns/core` bridge
+ * (websocket-ns-core.ts). That is the right mode when editing
+ * `@nativescript/core` source live inside the NativeScript monorepo: each core
+ * module stays individually served/transformed so core edits participate in
+ * HMR. Consumers of the published package don't edit core mid-session, so the
+ * bundle is both safe and much faster for them.
+ *
+ * FAILURE FALLBACK
+ * ----------------
+ * If the esbuild bundle build fails for any reason, the service marks itself
+ * failed and `/ns/core[/<sub>]` transparently falls back to the per-module
+ * bridge for the whole session (logged loudly once). Boot still works; only
+ * the speed win is lost.
+ */
+import type { ViteDevServer } from 'vite';
+import type { Platform } from '../../helpers/platform-types.js';
+/**
+ * Per-module /ns/core serving mode (vs the default single-eval bundle).
+ *
+ * `NS_CORE_PER_MODULE=1|true` forces it on, `0|false` forces bundle mode.
+ * When unset, it AUTO-ENABLES for monorepo core source (packages/core in the
+ * NativeScript repo). Two reasons:
+ *   - core maintainers edit core live, and per-module serving keeps those
+ *     edits in HMR;
+ *   - realm safety: the build-time externalizer emits
+ *     `/ns/m/packages/core/<file>` URLs for workspace-source core (see the
+ *     `ns-core-external-urls` workspace branch in configuration/base.ts), so
+ *     the served graph's core realm lives under /ns/m. A bundle-mode
+ *     `/ns/core-bundle.mjs` would evaluate a complete SECOND copy of core for
+ *     the entry's `/ns/core/globals|application|…` imports — duplicate native
+ *     class registrations crash in MetadataBuilder at startup.
+ */
+export declare function isCorePerModuleServingEnabled(env?: NodeJS.ProcessEnv, hasWorkspaceCoreSource?: () => boolean): boolean;
+export interface CoreBundleState {
+    /** Full ESM payload served at /ns/core-bundle.mjs (shape header + esbuild output). */
+    code: string;
+    /** Canonical subpaths registered in the bundle's __NS_CORE_MODULES__ registry. */
+    subs: Set<string>;
+    hash: string;
+    builtAt: number;
+    buildMs: number;
+}
+export interface CoreBundleService {
+    /** Resolves the built bundle, or null when the build failed (per-module fallback). */
+    ensureBuilt(): Promise<CoreBundleState | null>;
+    /** Synchronous view — null until built (or when failed). */
+    getState(): CoreBundleState | null;
+    hasFailed(): boolean;
+}
+export interface GenerateCoreBundleOptions {
+    projectRoot: string;
+    platform: Platform | string;
+    mode: 'development' | 'production' | string;
+    flavor?: string;
+    verbose?: boolean;
+}
+/**
+ * Resolve the physical @nativescript/core root the same way configuration/
+ * base.ts does: prefer monorepo source (`<workspace>/packages/core`), else the
+ * node_modules install reachable from the project root.
+ */
+export declare function resolveCoreRootForBundle(projectRoot: string): string;
+/**
+ * True when a canonical core subpath was DELIBERATELY excluded from bundle
+ * enumeration (debugger/, inspector_modules, bundle-entry-points, …). Requests
+ * for these at boot are normal — the runtime's inspector/debugger plumbing
+ * imports them in dev — and the per-module fallback that serves them is
+ * by-design and realm-safe. Callers use this to keep the fallback log
+ * verbose-only for expected subs while still surfacing unexpected
+ * enumeration misses.
+ */
+export declare function isExpectedCoreBundleExclusion(canonicalSub: string): boolean;
+/**
+ * Enumerate every importable core subpath (canonical form, per
+ * `normalizeCoreSub`) for the given platform. A subpath is included when it
+ * has a platform-neutral variant OR a variant for the current platform —
+ * other-platform-only modules (e.g. `ui/frame/activity.android` on iOS) are
+ * skipped since they can never resolve for this build.
+ */
+export declare function enumerateCoreModuleSubpaths(coreRoot: string, platform: string): string[];
+/**
+ * Synthetic esbuild entry: evaluate core once, expose every subpath's live
+ * namespace through `globalThis.__NS_CORE_MODULES__` (the SAME registry the
+ * per-module bridge footers populate, so the vendor CJS `require()` shim and
+ * `_nsReq` lookups keep working unchanged), and re-export the package main so
+ * `/ns/core-bundle.mjs` itself has core's full named-export surface.
+ */
+export declare function buildCoreBundleEntryCode(subs: readonly string[]): string;
+export declare function computeCoreBundleCacheKey(input: {
+    coreRoot: string;
+    coreVersion: string;
+    corePkgMtimeMs: number;
+    platform: string;
+    mode: string;
+    flavor: string;
+    defines: Record<string, string>;
+    nsConfigJson: string;
+    subs: readonly string[];
+    vitePackageVersion: string;
+}): string;
+export declare function tryLoadCoreBundleFromDisk(projectRoot: string, platform: string, key: string): CoreBundleState | null;
+export declare function saveCoreBundleToDisk(projectRoot: string, platform: string, key: string, state: CoreBundleState, verbose?: boolean): void;
+export declare function generateCoreBundle(options: GenerateCoreBundleOptions): Promise<CoreBundleState>;
+export declare function createCoreBundleService(options: GenerateCoreBundleOptions): CoreBundleService;
+/**
+ * Process-wide bundle service derived from the dev server's config + CLI
+ * flags. One dev server per process, so a module-level singleton matches the
+ * vendor manifest's lifecycle.
+ */
+export declare function getSharedCoreBundleService(server: ViteDevServer): CoreBundleService;
+/** Test seam: drop the shared service so specs can mount fresh. */
+export declare function resetSharedCoreBundleServiceForTests(): void;
+export declare const CORE_BUNDLE_PATH = "/ns/core-bundle.mjs";
+/**
+ * Shim served at `/ns/core` in bundle mode. `export * from` gives real,
+ * live named bindings straight off the bundle module record; the explicit
+ * default keeps the "default import + destructure" consumer rewrite working
+ * (see buildDefaultExportFooter in ns-core-cjs-shape.ts for that contract).
+ */
+export declare function buildCoreMainShimCode(): string;
+export declare function buildCoreSubShimCode(sub: string, exportNames: readonly string[], hasOwnDefaultExport?: boolean): string;