@nativescript/vite 8.0.0-beta.0 → 8.0.0-dev.0

package/hmr/server/websocket-hmr-pending.js

@@ -0,0 +1,33 @@
+/**
+ * Early "pending" notification for HMR.
+ *
+ * When `handleHotUpdate(ctx)` first fires for a save event, the server
+ * spends 7–200ms doing graph upserts, transforms and dependency
+ * analysis BEFORE broadcasting `ns:angular-update` (or
+ * `ns:css-updates`). During that window the client has no idea a
+ * change is in flight, so the HMR-applying overlay only appears at
+ * the tail end of the cycle and the user perceives the dev loop as
+ * laggy.
+ *
+ * `ns:hmr-pending` is broadcast at the very start of `handleHotUpdate`
+ * with just the file path + classified kind. The client reacts by
+ * showing the 'received' overlay frame immediately. The authoritative
+ * payload (`ns:angular-update` / `ns:css-updates`) follows once the
+ * server is ready and walks the rest of the stage progression.
+ *
+ * This module is intentionally a pure helper so the message shape and
+ * narrowing rules can be verified without spinning up a Vite dev
+ * server.
+ */
+export function createHmrPendingMessage(input) {
+    const allowed = ['ts', 'css', 'html', 'unknown'];
+    const kind = allowed.includes(input.kind || '') ? input.kind : 'unknown';
+    return {
+        type: 'ns:hmr-pending',
+        origin: typeof input.origin === 'string' ? input.origin : '',
+        path: typeof input.path === 'string' ? input.path : '',
+        kind,
+        timestamp: typeof input.timestamp === 'number' && Number.isFinite(input.timestamp) ? input.timestamp : 0,
+    };
+}
+//# sourceMappingURL=websocket-hmr-pending.js.map

package/hmr/server/websocket-hmr-pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-hmr-pending.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/websocket-hmr-pending.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAQH,MAAM,UAAU,uBAAuB,CAAC,KAAwE;IAC/G,MAAM,OAAO,GAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACnE,MAAM,IAAI,GAAI,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,IAAuB,CAAC,CAAC,CAAC,SAAS,CAAC;IACpH,OAAO;QACN,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC5D,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QACtD,IAAI;QACJ,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;KACxG,CAAC;AACH,CAAC"}

package/hmr/server/websocket-hot-update.d.ts

@@ -0,0 +1,80 @@
+import type { HmrContext } from 'vite';
+import type { WebSocketServer } from 'ws';
+import type { FrameworkServerStrategy } from './framework-strategy.js';
+import type { HmrModuleGraph } from './hmr-module-graph.js';
+import type { SharedTransformRequestRunner } from './shared-transform-request.js';
+import type { CssUpdateItem } from '../shared/protocol.js';
+import type { BootstrapRootComponent } from '../frameworks/angular/server/angular-root-component.js';
+/**
+ * Dependencies injected into each strategy's `handleHotUpdate` (and the shared
+ * {@link runHotUpdatePrologue} it runs first). These hold per-server instance
+ * state (`wss`, `moduleGraph`, the file maps, `sharedTransformRequest`) or are
+ * plugin-closure accessors. Pure transform helpers (`cleanCode`,
+ * `rewriteImports`, `processSfcCode`, `collectImportDependencies`) are NOT on the
+ * context — the strategies that need them import them directly from
+ * `websocket-device-transform.ts`. `getServerOrigin` is likewise imported
+ * directly here from `server-origin.ts` (spy via the module in tests).
+ */
+export interface NsHotUpdateContext {
+    wss: WebSocketServer | null;
+    moduleGraph: HmrModuleGraph;
+    strategy: FrameworkServerStrategy;
+    verbose: boolean;
+    sfcFileMap: Map<string, string>;
+    depFileMap: Map<string, string>;
+    sharedTransformRequest: SharedTransformRequestRunner;
+    getHmrSourceRootsCached: () => string[];
+    getBootstrapEntryRelPath: () => string;
+    isSocketClientOpen: (client: {
+        readyState?: number;
+        OPEN?: number;
+    } | null | undefined) => boolean;
+    getHmrSocketRole: (client: {
+        __nsHmrClientRole?: string;
+    } | null | undefined) => string;
+    shouldRemapImport: (spec: string) => boolean;
+    rememberAngularReloadSuppression: (root: string, file: string, ttlMs?: number) => void;
+    /**
+     * Resolves the Angular bootstrap (root) component, or `null` when it
+     * can't be statically determined. Used to force root-component template
+     * edits through the reboot path instead of Analog's in-place update,
+     * which is destructive for the root view (see {@link BootstrapRootComponent}).
+     */
+    getRootComponentIdentity: () => BootstrapRootComponent | null;
+    getGraphInitialPopulationPromise: () => Promise<void> | null;
+    appRootDir: string;
+}
+/** Always-on per-update timing + diagnostics, mutated in place across the prologue and the framework tail. */
+export interface HmrUpdateMetrics {
+    file: string;
+    kind: string;
+    t0: number;
+    tAfterAwait: number;
+    tAfterFramework: number;
+    tEnd: number;
+    invalidated: number;
+    recipients: number;
+    narrowed: boolean | undefined;
+    emitted: boolean;
+}
+/** Per-invocation locals computed by {@link runHotUpdatePrologue} and consumed by the per-flavor tail. */
+export interface HotUpdatePrologueState {
+    root: string;
+    updateRel: string;
+    metrics: HmrUpdateMetrics;
+    emitSummary: () => void;
+    /** App CSS output changed during an Angular TS edit; attach it to the reboot message. */
+    deferredCssUpdates?: CssUpdateItem[];
+}
+/**
+ * Shared, framework-agnostic prologue for every strategy's `handleHotUpdate`:
+ * scope gating, update-metrics setup, the `ns:hmr-pending` broadcast, awaiting the
+ * initial graph population, the common module-graph upsert, CSS hot-update +
+ * Tailwind content-CSS broadcast, and the project-scope filter. Returns `null`
+ * when one of those steps fully handles the change (every such path resolves to
+ * Vite's `undefined` result, so the caller just returns), otherwise the
+ * per-invocation {@link HotUpdatePrologueState} (`root`, `updateRel`, the live
+ * `metrics` object, the idempotent `emitSummary`) the per-flavor tail consumes.
+ * Exported so per-flavor strategies can own `prologue + their tail`.
+ */
+export declare function runHotUpdatePrologue(ctx: HmrContext, deps: NsHotUpdateContext): Promise<HotUpdatePrologueState | null>;

package/hmr/server/websocket-hot-update.js

@@ -0,0 +1,299 @@
+import * as path from 'path';
+import { isRuntimeGraphExcludedPath } from './runtime-graph-filter.js';
+import { isWithinHmrScope } from '../../helpers/hmr-scope.js';
+import { collectGraphUpdateModulesForHotUpdate } from '../frameworks/angular/server/websocket-angular-hot-update.js';
+import { getAppCssState } from '../../helpers/app-css-state.js';
+import { classifyHmrUpdateKind, formatHmrUpdateSummary } from './perf-instrumentation.js';
+import { createHmrPendingMessage } from './websocket-hmr-pending.js';
+import { appCssRootRelPath, buildCssUpdateItem, buildCssUpdatesMessage } from './css-update-message.js';
+import { processContentCssUpdate } from './content-css-update.js';
+import { getServerOrigin } from './server-origin.js';
+/**
+ * Shared, framework-agnostic prologue for every strategy's `handleHotUpdate`:
+ * scope gating, update-metrics setup, the `ns:hmr-pending` broadcast, awaiting the
+ * initial graph population, the common module-graph upsert, CSS hot-update +
+ * Tailwind content-CSS broadcast, and the project-scope filter. Returns `null`
+ * when one of those steps fully handles the change (every such path resolves to
+ * Vite's `undefined` result, so the caller just returns), otherwise the
+ * per-invocation {@link HotUpdatePrologueState} (`root`, `updateRel`, the live
+ * `metrics` object, the idempotent `emitSummary`) the per-flavor tail consumes.
+ * Exported so per-flavor strategies can own `prologue + their tail`.
+ */
+export async function runHotUpdatePrologue(ctx, deps) {
+    const { wss, moduleGraph, strategy, verbose, getHmrSourceRootsCached, isSocketClientOpen } = deps;
+    const APP_ROOT_DIR = deps.appRootDir;
+    const graphInitialPopulationPromise = deps.getGraphInitialPopulationPromise();
+    const { file, server } = ctx;
+    if (!wss) {
+        return null;
+    }
+    if (isRuntimeGraphExcludedPath(file)) {
+        return null;
+    }
+    // Authoritative "what triggers HMR" gate, applied before the pending
+    // overlay broadcast below: react only to files inside the app source
+    // dir (`appPath`) or a tsconfig-configured shared library.
+    if (!isWithinHmrScope(file, getHmrSourceRootsCached())) {
+        if (verbose) {
+            console.log(`[ns-hmr][server] ignored change (outside HMR source scope): ${file}`);
+        }
+        return null;
+    }
+    // Always-on update timing. Captures the four phases (await,
+    // framework, broadcast, total) plus invalidated module count
+    // and recipient count. Emitted at the end of this function via
+    // `emitHmrUpdateSummary()`. Single line, always-on so a
+    // 6-second `.ts` save is immediately visible without flipping
+    // verbose.
+    const updateRoot = server.config.root || process.cwd();
+    const updateRel = (() => {
+        try {
+            return '/' + path.posix.normalize(path.relative(updateRoot, file)).split(path.sep).join('/');
+        }
+        catch {
+            return file;
+        }
+    })();
+    const updateMetrics = {
+        file: updateRel,
+        kind: classifyHmrUpdateKind(file),
+        t0: Date.now(),
+        tAfterAwait: 0,
+        tAfterFramework: 0,
+        tEnd: 0,
+        invalidated: 0,
+        recipients: 0,
+        // Narrowing diagnostic — populated by the angular branch when
+        // the changed file is `.ts`, otherwise remains undefined and is
+        // omitted from the summary line entirely.
+        narrowed: undefined,
+        emitted: false,
+    };
+    // Broadcast a "pending" notification at the very start of
+    // handleHotUpdate so the client can show the HMR-applying
+    // overlay BEFORE we spend time on graph updates / transforms /
+    // dependency analysis (typically 7–200ms on a warm cache).
+    // Without this, the overlay only appears at `ns:angular-update`
+    // broadcast time and the user perceives a "delayed" reaction
+    // to their save.
+    //
+    // Fire-and-forget: a failed pending broadcast must never
+    // hold up the actual update. The client treats receipt of
+    // `ns:angular-update` (or `ns:css-updates`) as authoritative;
+    // the pending message is purely a UX hint.
+    try {
+        const pendingPayload = JSON.stringify(createHmrPendingMessage({
+            origin: getServerOrigin(server),
+            path: updateMetrics.file,
+            kind: updateMetrics.kind,
+            timestamp: updateMetrics.t0,
+        }));
+        wss.clients.forEach((client) => {
+            if (isSocketClientOpen(client)) {
+                try {
+                    client.send(pendingPayload);
+                }
+                catch { }
+            }
+        });
+    }
+    catch { }
+    const emitHmrUpdateSummary = () => {
+        if (updateMetrics.emitted)
+            return;
+        updateMetrics.emitted = true;
+        updateMetrics.tEnd = Date.now();
+        try {
+            const awaitMs = (updateMetrics.tAfterAwait || updateMetrics.t0) - updateMetrics.t0;
+            const frameworkMs = (updateMetrics.tAfterFramework || updateMetrics.tAfterAwait || updateMetrics.t0) - (updateMetrics.tAfterAwait || updateMetrics.t0);
+            const broadcastMs = updateMetrics.tEnd - (updateMetrics.tAfterFramework || updateMetrics.tAfterAwait || updateMetrics.t0);
+            const totalMs = updateMetrics.tEnd - updateMetrics.t0;
+            console.info(formatHmrUpdateSummary({
+                file: updateMetrics.file,
+                kind: updateMetrics.kind,
+                awaitMs,
+                frameworkMs,
+                broadcastMs,
+                totalMs,
+                invalidated: updateMetrics.invalidated,
+                recipients: updateMetrics.recipients,
+                narrowed: updateMetrics.narrowed,
+            }));
+        }
+        catch { }
+    };
+    // The first /ns/m request kicks off populateInitialGraph in the
+    // background. If an HMR update races in before that walk
+    // completes, we'd lose transitive-importer data. Await
+    // completion here so the delta computation below always sees a
+    // populated graph.
+    if (graphInitialPopulationPromise) {
+        try {
+            await graphInitialPopulationPromise;
+        }
+        catch { }
+    }
+    updateMetrics.tAfterAwait = Date.now();
+    // Graph update for this file change (wrapped to avoid aborting rest of handler)
+    try {
+        // Angular HTML templates opt out via `skipDefaultGraphUpdate` — their tail
+        // re-queries the graph and drives the in-place swap / reboot itself.
+        const skipDefaultGraphUpdate = strategy.skipDefaultGraphUpdate?.(file) ?? false;
+        if (!skipDefaultGraphUpdate) {
+            const graphTargets = collectGraphUpdateModulesForHotUpdate({
+                file,
+                flavor: strategy.flavor,
+                modules: ctx.modules,
+                getModuleById: (id) => server.moduleGraph.getModuleById(id),
+                verbose,
+            });
+            for (const mod of graphTargets) {
+                if (!mod?.id)
+                    continue;
+                try {
+                    const transformed = await server.transformRequest(mod.id);
+                    const code = transformed?.code || '';
+                    // Import analysis runs inside the transform, so the module's edges
+                    // are current only after it — read before, a newly added import is
+                    // missing from the graph until the NEXT save, and a client walking
+                    // the reverse graph to find accepting importers never sees it.
+                    const deps = Array.from(mod.importedModules || [])
+                        .map((m) => (m.id || '').replace(/\?.*$/, ''))
+                        .filter(Boolean);
+                    moduleGraph.upsert((mod.id || '').replace(/\?.*$/, ''), code, deps, {
+                        emitDeltaOnInsert: true,
+                        // Defer the delta broadcast until AFTER the framework
+                        // hot-update handler has had a chance to invalidate the
+                        // shared transform-request cache + Vite's moduleGraph
+                        // for the changed file and its transitive importers.
+                        // Otherwise the client races: it receives the delta
+                        // (eviction + re-import via tagged URL) before the
+                        // server has purged its caches, and the re-import is
+                        // served from cache → V8 evaluates the previous save's
+                        // transformed code → patchRegistry runs against an
+                        // unchanged source → the visible page is "one save
+                        // behind". Angular has always taken this path; Solid
+                        // needs the same contract because Solid HMR depends
+                        // on the client re-fetching the just-changed module
+                        // to drive `solid-refresh.patchRegistry`.
+                        broadcastDelta: !strategy.deferDeltaBroadcast,
+                    });
+                }
+                catch (error) {
+                    if (verbose)
+                        console.warn('[hmr-ws][v2] failed graph update target', mod.id, error);
+                }
+            }
+        }
+    }
+    catch (e) {
+        if (verbose)
+            console.warn('[hmr-ws][v2] failed graph update', e);
+    }
+    const root = server.config.root || process.cwd();
+    let deferredCssUpdates;
+    // CSS hot-update — handled BEFORE the project-scope filter because
+    // workspace deps (component `styleUrls`, `@import` partials) live outside
+    // `<root>/`. We distinguish two kinds of style edit and apply each
+    // correctly on the device — this is the fix for the regression where
+    // component `styleUrls` edits were misrouted to a global `app.css` refresh
+    // and silently did nothing:
+    //
+    //   • GLOBAL stylesheet — the app entry CSS itself OR one of its `@import`
+    //     deps (tracked via `getAppCssState().deps`). Broadcast the app entry
+    //     CSS path so Vite re-runs PostCSS through the `@import` chain; the
+    //     device replaces the boot-time `app.css`-tagged selectors.
+    //
+    //   • COMPONENT style (`styleUrls`, including workspace-library
+    //     components). Broadcast the style file's OWN path under a per-file
+    //     tag. The device fetches that component's CSS and replaces just that
+    //     file's selectors (`addTaggedAdditionalCSS` keyed by the file path),
+    //     re-styling the live view without a reboot or `ɵɵreplaceMetadata`
+    //     swap. `app.css` is never involved — it does not contain the
+    //     component's inlined styles. Using a per-file tag (instead of the
+    //     shared `app.css` tag) avoids clobbering the global stylesheet.
+    if (file.endsWith('.css')) {
+        const fileAbs = path.resolve(file).replace(/\\/g, '/');
+        const appCssState = getAppCssState(server);
+        const appEntryCssAbs = (appCssState?.path || path.resolve(root, APP_ROOT_DIR, 'app.css')).replace(/\\/g, '/');
+        const isGlobalStyle = fileAbs === appEntryCssAbs || !!appCssState?.deps?.has(fileAbs);
+        // Component-scoped style edit the framework applies in place itself
+        // (Angular + Analog liveReload → `angular:component-update`). Suppress
+        // the `ns:css-updates` broadcast: it can't win the emulated-scoping
+        // specificity battle anyway, AND the device's `?direct=1` fetch would
+        // create the css `?direct` module that stops the framework from
+        // re-emitting its component-update on subsequent edits. The framework's
+        // own `handleHotUpdate` (a separate plugin) drives the update.
+        if (!isGlobalStyle && strategy.ownsComponentStyleHmr?.(server)) {
+            updateMetrics.tAfterFramework = Date.now();
+            if (verbose)
+                console.log(`[hmr-ws] component style edit ${file} → left to framework component-update (no css broadcast)`);
+            emitHmrUpdateSummary();
+            return null;
+        }
+        const toRootRel = (absOrFile) => '/' + path.posix.normalize(path.relative(root, absOrFile)).split(path.sep).join('/');
+        // GLOBAL → app entry CSS path (default `app.css` tag on the client),
+        // through the guarded canonical helper. COMPONENT → the style file's
+        // OWN path (may legitimately escape the root for workspace libs).
+        const broadcastPath = isGlobalStyle ? appCssRootRelPath(root, appEntryCssAbs) : toRootRel(file);
+        const tag = isGlobalStyle ? undefined : broadcastPath;
+        updateMetrics.tAfterFramework = Date.now();
+        if (!broadcastPath) {
+            if (verbose)
+                console.warn(`[hmr-ws] global app.css path escapes the project root; skipped CSS broadcast for ${file}`);
+            emitHmrUpdateSummary();
+            return null;
+        }
+        try {
+            const msg = buildCssUpdatesMessage(server, [buildCssUpdateItem(broadcastPath, { tag })]);
+            wss.clients.forEach((client) => {
+                if (isSocketClientOpen(client)) {
+                    client.send(JSON.stringify(msg));
+                    updateMetrics.recipients += 1;
+                }
+            });
+        }
+        catch (error) {
+            console.warn('[hmr-ws] CSS update failed:', error);
+        }
+        if (verbose)
+            console.log(`[hmr-ws] Hot update for: ${file} → broadcast CSS ${broadcastPath} (${isGlobalStyle ? 'global app.css' : `component, tag=${tag}`})`);
+        emitHmrUpdateSummary();
+        return null;
+    }
+    // No second project-scope filter here. The authoritative allowlist is the
+    // `isWithinHmrScope` gate at the top of this prologue — app source dir plus
+    // tsconfig-configured shared-library roots. An older, narrower re-filter at
+    // this point (project-root `src`/`core`/app-dir substring checks) silently
+    // dropped workspace-library files: their `.ts`/`.html` edits never reached
+    // the framework tails, so a monorepo lib component's class edit could only
+    // flow through Analog's in-place `ɵɵreplaceMetadata` path — which reuses
+    // the live instance and can NEVER apply class-body changes — while the
+    // Angular reboot broadcast (`ns:angular-update`) that actually delivers
+    // them never fired. The visible symptom: editing a lib component's class
+    // (e.g. converting inputs to signals) appears to hot-update but the running
+    // instance keeps the old shape, and the next template edit that uses the
+    // new shape throws (`ctx.x is not a function`) on every subsequent save.
+    if (verbose)
+        console.log(`[hmr-ws] Hot update for: ${file}`);
+    // Tailwind / content-scanning CSS routing for non-CSS edits — see
+    // `processContentCssUpdate` for the full background. This MUST run before
+    // the framework branches because several of them return early (notably the
+    // Angular HTML live-reload path), and the broadcast must land alongside
+    // the framework's own template-update payload.
+    if (!file.endsWith('.css')) {
+        const contentCss = await processContentCssUpdate({
+            server,
+            file,
+            root,
+            wss,
+            isSocketClientOpen,
+            deferToFrameworkUpdate: strategy.defersContentCssToFrameworkUpdate?.(file) ?? false,
+            verbose,
+        });
+        deferredCssUpdates = contentCss.deferredCssUpdates;
+        updateMetrics.recipients += contentCss.recipients;
+    }
+    return { root, updateRel, metrics: updateMetrics, emitSummary: emitHmrUpdateSummary, deferredCssUpdates };
+}
+//# sourceMappingURL=websocket-hot-update.js.map

package/hmr/server/websocket-hot-update.js.map

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

package/hmr/server/websocket-import-map-route.d.ts

@@ -0,0 +1,15 @@
+import type { ViteDevServer } from 'vite';
+import type { FrameworkServerStrategy } from './framework-strategy.js';
+export interface RegisterImportMapRouteOptions {
+    /** The active framework strategy — only its `flavor` is consulted. */
+    getStrategy: () => FrameworkServerStrategy | undefined;
+}
+/**
+ * Registers the device import-map endpoint: `GET /ns/import-map.json`.
+ *
+ * Returns the import map + runtime config consumed by ns:module `configureLoader()`
+ * on the device during cold boot. Extracted verbatim from
+ * `createHmrWebSocketPlugin`; the only injected dependency is the active
+ * framework strategy (for its `flavor`).
+ */
+export declare function registerImportMapRoute(server: ViteDevServer, options: RegisterImportMapRouteOptions): void;

package/hmr/server/websocket-import-map-route.js

@@ -0,0 +1,51 @@
+import { buildRuntimeConfig } from './import-map.js';
+import { getServerOrigin } from './server-origin.js';
+/**
+ * Registers the device import-map endpoint: `GET /ns/import-map.json`.
+ *
+ * Returns the import map + runtime config consumed by ns:module `configureLoader()`
+ * on the device during cold boot. Extracted verbatim from
+ * `createHmrWebSocketPlugin`; the only injected dependency is the active
+ * framework strategy (for its `flavor`).
+ */
+export function registerImportMapRoute(server, options) {
+    const { getStrategy } = options;
+    server.middlewares.use(async (req, res, next) => {
+        try {
+            const urlObj = new URL(req.url || '', 'http://localhost');
+            if (urlObj.pathname !== '/ns/import-map.json')
+                return next();
+            res.setHeader('Access-Control-Allow-Origin', '*');
+            res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
+            if (req.method === 'OPTIONS') {
+                res.statusCode = 204;
+                res.end();
+                return;
+            }
+            // Use the single trusted origin resolver (https-aware, validated, and
+            // byte-identical to the origin baked into bundle.mjs by dev-host.ts).
+            // Do NOT derive the origin from the client-supplied `Host` header: the
+            // dev server binds 0.0.0.0, so a spoofed Host would rewrite the origin
+            // of every device module URL.
+            const origin = getServerOrigin(server);
+            const strategy = getStrategy();
+            const runtimeConfig = buildRuntimeConfig({
+                origin,
+                flavor: strategy?.flavor || 'typescript',
+                strategy,
+            });
+            res.setHeader('Content-Type', 'application/json');
+            res.end(JSON.stringify({
+                importMap: JSON.parse(runtimeConfig.importMap),
+                volatilePatterns: runtimeConfig.volatilePatterns,
+                canonicalization: runtimeConfig.canonicalization,
+            }, null, 2));
+        }
+        catch (err) {
+            console.error('[import-map] error generating import map:', err?.message || err);
+            res.statusCode = 500;
+            res.end(JSON.stringify({ error: 'Failed to generate import map' }));
+        }
+    });
+}
+//# sourceMappingURL=websocket-import-map-route.js.map

package/hmr/server/websocket-import-map-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-import-map-route.js","sourceRoot":"","sources":["../../../../../packages/vite/hmr/server/websocket-import-map-route.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAOrD;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAqB,EAAE,OAAsC;IACnG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAChC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC/C,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAC1D,IAAI,MAAM,CAAC,QAAQ,KAAK,qBAAqB;gBAAE,OAAO,IAAI,EAAE,CAAC;YAE7D,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;YAClD,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,cAAc,CAAC,CAAC;YAC9D,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9B,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;gBACrB,GAAG,CAAC,GAAG,EAAE,CAAC;gBACV,OAAO;YACR,CAAC;YAED,sEAAsE;YACtE,sEAAsE;YACtE,uEAAuE;YACvE,uEAAuE;YACvE,8BAA8B;YAC9B,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAEvC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;YAC/B,MAAM,aAAa,GAAG,kBAAkB,CAAC;gBACxC,MAAM;gBACN,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,YAAY;gBACxC,QAAQ;aACR,CAAC,CAAC;YAEH,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;YAClD,GAAG,CAAC,GAAG,CACN,IAAI,CAAC,SAAS,CACb;gBACC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC;gBAC9C,gBAAgB,EAAE,aAAa,CAAC,gBAAgB;gBAChD,gBAAgB,EAAE,aAAa,CAAC,gBAAgB;aAChD,EACD,IAAI,EACJ,CAAC,CACD,CACD,CAAC;QACH,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,GAAG,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC;YAChF,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/hmr/server/websocket-module-bindings.d.ts

@@ -0,0 +1,21 @@
+export interface EnsureNativeScriptModuleBindingsOptions {
+    preserveNonPluginVendorImports?: boolean;
+    resolvedSpecifierOverrides?: Map<string, string>;
+    /**
+     * Rewrite vendor/plugin imports to their `/ns/m/node_modules/<pkg>` HTTP
+     * ESM form instead of the `__nsVendorRequire` registry shim.
+     *
+     * Worker realms need this: the vendor registry (`__nsVendorRegistry` /
+     * `__nsRequire`) is installed by the MAIN realm's dev-session bootstrap
+     * and never exists inside a `new Worker(...)` context, so the registry
+     * shim's fallback to the native `require()` fails for every vendor
+     * package (observed with `@nativescript/zip` in a zip worker on a fresh
+     * install — the first boot's DB unzip was the first code path to ever
+     * exercise a vendor require inside a worker). The HTTP form gives the
+     * worker its own realm-local copy via the deps-bundle bridge — the same
+     * isolation semantics webpack's per-worker bundles had.
+     */
+    vendorImportsAsHttp?: boolean;
+}
+export declare function ensureNativeScriptModuleBindings(code: string, options?: EnsureNativeScriptModuleBindingsOptions): string;
+export declare function getProcessCodeResolvedSpecifierOverrides(sourceId: string | undefined, projectRoot: string): Map<string, string> | undefined;