@nativescript/vite 8.0.0-alpha.57 → 8.0.0-alpha.58

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

@@ -0,0 +1,116 @@
+/**
+ * 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;
+/**
+ * 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 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;

package/hmr/server/core-bundle.js

@@ -0,0 +1,460 @@
+/**
+ * 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 { createRequire } from 'node:module';
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import * as path from 'node:path';
+import { createHash } from 'node:crypto';
+import * as esbuild from 'esbuild';
+import { getCliFlags } from '../../helpers/cli-flags.js';
+import { getGlobalDefines } from '../../helpers/global-defines.js';
+import { getProjectFlavor } from '../../helpers/flavor.js';
+import { createNativeClassEsbuildPlugin } from '../../helpers/nativeclass-esbuild-plugin.js';
+import { createUnicodeRegexEsbuildPlugin } from '../shared/vendor/vendor-esbuild-plugins.js';
+import { moduleRegistrationKeys, normalizeCoreSub } from '../../helpers/ns-core-url.js';
+import { buildShapeInstallHeader } from './ns-core-cjs-shape.js';
+import { resolveVerboseFlag } from '../../helpers/logging.js';
+import { nsConfigToJson } from '../../helpers/utils.js';
+import { aliasCssTree } from '../../helpers/css-tree.js';
+import { getWorkspaceCoreSourceRoot } from './websocket-served-module-helpers.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 function isCorePerModuleServingEnabled(env = process.env, hasWorkspaceCoreSource = () => getWorkspaceCoreSourceRoot() !== null) {
+    const v = env.NS_CORE_PER_MODULE;
+    if (v === '1' || v === 'true')
+        return true;
+    if (v === '0' || v === 'false')
+        return false;
+    try {
+        return hasWorkspaceCoreSource();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 function resolveCoreRootForBundle(projectRoot) {
+    const workspaceCorePkg = path.resolve(projectRoot, '../../packages/core/package.json');
+    if (existsSync(workspaceCorePkg)) {
+        return path.dirname(workspaceCorePkg);
+    }
+    const req = createRequire(path.join(projectRoot, 'package.json'));
+    const corePkg = req.resolve('@nativescript/core/package.json');
+    return path.dirname(corePkg);
+}
+// Directories that are not runtime module space. `debugger/` and
+// `inspector_modules` only evaluate when a Web Inspector session loads them
+// (via the app bundle, not HTTP) and carry heavyweight side effects (network
+// interception) that must NOT run on every boot, so they stay out of the
+// bundle. A request for an excluded subpath falls back to per-module serving —
+// realm-safe, because the per-module response's own core imports are rewritten
+// back to `/ns/core/<sub>` shim URLs that resolve into the bundle realm.
+const EXCLUDED_DIRS = new Set(['node_modules', 'platforms', 'cli-hooks', 'debugger', '.git', '__tests__', 'fixtures']);
+const EXCLUDED_TOP_LEVEL_MODULES = new Set(['inspector_modules', 'bundle-entry-points', 'references', 'global-types', 'vite.config', 'vitest.setup']);
+const MODULE_FILE_RE = /\.(?:ts|tsx|js|mjs)$/;
+const NON_MODULE_FILE_RE = /\.(?:d\.ts|spec\.(?:ts|js|tsx)|test\.(?:ts|js|tsx))$/;
+function platformSuffixOf(baseName) {
+    const m = baseName.match(/\.(ios|android|visionos)$/);
+    return m?.[1] || null;
+}
+/**
+ * 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 function enumerateCoreModuleSubpaths(coreRoot, platform) {
+    const isApple = platform !== 'android';
+    // canonical sub → has a variant loadable on this platform
+    const loadable = new Map();
+    const visit = (dirAbs, relPrefix) => {
+        let entries;
+        try {
+            entries = readdirSync(dirAbs, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const name = entry.name;
+            if (name.startsWith('.'))
+                continue;
+            const rel = relPrefix ? `${relPrefix}/${name}` : name;
+            let isDir = entry.isDirectory();
+            if (entry.isSymbolicLink()) {
+                try {
+                    isDir = statSync(path.join(dirAbs, name)).isDirectory();
+                }
+                catch {
+                    continue;
+                }
+            }
+            if (isDir) {
+                if (EXCLUDED_DIRS.has(name))
+                    continue;
+                visit(path.join(dirAbs, name), rel);
+                continue;
+            }
+            if (!MODULE_FILE_RE.test(name) || NON_MODULE_FILE_RE.test(name))
+                continue;
+            const relNoExt = rel.replace(MODULE_FILE_RE, '');
+            const suffix = platformSuffixOf(relNoExt);
+            const platformOk = suffix === null || (isApple ? suffix !== 'android' : suffix === 'android');
+            const canonical = normalizeCoreSub(relNoExt);
+            // '' is the package main — always included, not part of the sub list.
+            if (!canonical)
+                continue;
+            if (!relPrefix && EXCLUDED_TOP_LEVEL_MODULES.has(canonical))
+                continue;
+            if (canonical.split('/').some((seg) => EXCLUDED_TOP_LEVEL_MODULES.has(seg) || EXCLUDED_DIRS.has(seg)))
+                continue;
+            // Cross-platform helper modules without a platform suffix in their
+            // own filename (e.g. `ui/frame/frame-helper-for-android`) import
+            // siblings that only exist with the OTHER platform's suffix, so
+            // force-importing them on this platform can never resolve. They are
+            // only reachable from that platform's `index.<platform>` graph.
+            if (/-for-android$/.test(canonical) && isApple)
+                continue;
+            if (/-for-(?:ios|visionos)$/.test(canonical) && !isApple)
+                continue;
+            loadable.set(canonical, loadable.get(canonical) || false || platformOk);
+        }
+    };
+    visit(coreRoot, '');
+    return Array.from(loadable.entries())
+        .filter(([, ok]) => ok)
+        .map(([sub]) => sub)
+        .sort();
+}
+/**
+ * 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 function buildCoreBundleEntryCode(subs) {
+    const lines = [];
+    // Package main first so its side-effect order (globals, bootstrap) matches
+    // the package's own intent; esbuild still evaluates shared deps once.
+    lines.push(`import * as __ns_core_main__ from ${JSON.stringify('@nativescript/core')};`);
+    subs.forEach((sub, i) => {
+        lines.push(`import * as __ns_core_m_${i}__ from ${JSON.stringify(`@nativescript/core/${sub}`)};`);
+    });
+    lines.push('');
+    lines.push('const __nsReg = (globalThis.__NS_CORE_MODULES__ || (globalThis.__NS_CORE_MODULES__ = Object.create(null)));');
+    lines.push(`const __nsShapeFn = typeof globalThis.__NS_CJS_SHAPE__ === 'function' ? globalThis.__NS_CJS_SHAPE__ : function (x) { return x; };`);
+    lines.push('const __nsRegSet = (keys, ns) => { const shaped = __nsShapeFn(ns); for (const k of keys) { __nsReg[k] = shaped; } };');
+    lines.push(`__nsRegSet(${JSON.stringify(moduleRegistrationKeys(''))}, __ns_core_main__);`);
+    subs.forEach((sub, i) => {
+        lines.push(`__nsRegSet(${JSON.stringify(moduleRegistrationKeys(sub))}, __ns_core_m_${i}__);`);
+    });
+    lines.push(`try { globalThis.__NS_CORE_EVAL_COUNT__ = (globalThis.__NS_CORE_EVAL_COUNT__ || 0) + 1; globalThis.__NS_CORE_BUNDLE_MODE__ = true; } catch (e) {}`);
+    lines.push(`export * from ${JSON.stringify('@nativescript/core')};`);
+    lines.push('');
+    return lines.join('\n');
+}
+// Platform-first extension order, mirroring Vite's `platformExtensions` in
+// configuration/base.ts so the bundle resolves the same physical files the
+// per-module bridge would (platform variant preferred over the bare one).
+function coreResolveExtensions(platform) {
+    if (platform === 'android') {
+        return ['.android.tsx', '.tsx', '.android.jsx', '.jsx', '.android.ts', '.ts', '.android.js', '.js', '.mjs', '.cjs', '.json'];
+    }
+    return ['.ios.tsx', '.visionos.tsx', '.tsx', '.ios.jsx', '.visionos.jsx', '.jsx', '.ios.ts', '.visionos.ts', '.ts', '.ios.js', '.visionos.js', '.js', '.mjs', '.cjs', '.json'];
+}
+// Node built-ins the device runtime cannot resolve — externalized exactly like
+// the vendor bundle build (see manifest.ts).
+const NODE_BUILTINS = ['assert', 'async_hooks', 'buffer', 'child_process', 'cluster', 'console', 'constants', 'crypto', 'dgram', 'diagnostics_channel', 'dns', 'domain', 'events', 'fs', 'fs/promises', 'http', 'http2', 'https', 'inspector', 'module', 'net', 'os', 'path', 'path/posix', 'path/win32', 'perf_hooks', 'process', 'punycode', 'querystring', 'readline', 'repl', 'stream', 'stream/web', 'stream/promises', 'string_decoder', 'sys', 'timers', 'timers/promises', 'tls', 'trace_events', 'tty', 'url', 'util', 'v8', 'vm', 'wasi', 'worker_threads', 'zlib'];
+const NODE_EXTERNALS = [...NODE_BUILTINS, ...NODE_BUILTINS.map((b) => `node:${b}`)];
+export async function generateCoreBundle(options) {
+    const { projectRoot, platform, mode, flavor, verbose } = options;
+    const t0 = Date.now();
+    const coreRoot = resolveCoreRootForBundle(projectRoot);
+    const subs = enumerateCoreModuleSubpaths(coreRoot, String(platform));
+    const entryCode = buildCoreBundleEntryCode(subs);
+    // Resolve bare @nativescript/core[/sub] specifiers against the resolved
+    // core root directly. esbuild's default node-resolution can't be trusted
+    // here for two reasons: (1) monorepo apps consume core via a symlink whose
+    // realpath escapes the project's node_modules, and (2) the package's
+    // `main: "index"` is extensionless. Mapping to `<coreRoot>/<sub>` and
+    // letting resolveExtensions pick the platform file mirrors Vite's alias +
+    // extension behavior byte-for-byte.
+    const coreAliasPlugin = {
+        name: 'ns-core-bundle-alias',
+        setup(build) {
+            build.onResolve({ filter: /^@nativescript\/core(?:\/.*)?$/ }, (args) => {
+                const sub = args.path === '@nativescript/core' ? '' : args.path.slice('@nativescript/core/'.length);
+                const target = sub ? path.join(coreRoot, sub) : path.join(coreRoot, 'index');
+                return build.resolve(target, { kind: args.kind, resolveDir: coreRoot });
+            });
+        },
+    };
+    // Mirror the Vite pipeline's css-tree environment aliases: css-tree's ESM
+    // files do `import { createRequire } from 'module'` to lazily require JSON
+    // data — on device that bare 'module' import must resolve to our polyfill
+    // (same replacement `aliasCssTree` feeds Vite's resolver; see
+    // helpers/css-tree.ts and polyfills/module.ts). In the source tree the
+    // replacement's `.js` file may not exist yet (only `.ts`) — fall back.
+    const resolvePolyfillFile = (p) => {
+        if (existsSync(p))
+            return p;
+        const ts = p.replace(/\.js$/, '.ts');
+        return existsSync(ts) ? ts : p;
+    };
+    const polyfillAliases = new Map();
+    for (const { find, replacement } of aliasCssTree) {
+        polyfillAliases.set(String(find), resolvePolyfillFile(replacement));
+    }
+    const cssTreeEnvPlugin = {
+        name: 'ns-core-bundle-css-tree-env',
+        setup(build) {
+            build.onResolve({ filter: /^(?:node:)?module$|^mdn-data\/css\// }, (args) => {
+                const key = args.path.replace(/^node:/, '');
+                const target = polyfillAliases.get(key);
+                return target ? { path: target } : undefined;
+            });
+        },
+    };
+    // `~/package.json` — core's profiling/style-scope modules import the APP's
+    // nativescript.config as JSON through this alias (Vite serves it via the
+    // nsvite:nsconfig-json virtual module; see helpers/config-as-json.ts).
+    // Mirror that here with the same nsConfigToJson() payload.
+    const nsConfigJson = (() => {
+        try {
+            return JSON.stringify(nsConfigToJson());
+        }
+        catch {
+            // No nativescript.config.ts reachable (tests, bare fixtures) — the
+            // importers only read optional profiling/cssParser hints from it.
+            return '{}';
+        }
+    })();
+    const nsConfigPlugin = {
+        name: 'ns-core-bundle-nsconfig',
+        setup(build) {
+            build.onResolve({ filter: /^~\/package\.json$/ }, () => ({ path: 'ns-core-bundle:nsconfig-json', namespace: 'ns-core-bundle-virtual' }));
+            build.onLoad({ filter: /^ns-core-bundle:nsconfig-json$/, namespace: 'ns-core-bundle-virtual' }, () => ({
+                contents: `export default ${nsConfigJson};`,
+                loader: 'js',
+            }));
+        },
+    };
+    const defines = (() => {
+        const raw = getGlobalDefines({
+            platform: String(platform),
+            targetMode: mode === 'development' ? 'development' : 'production',
+            verbose: !!verbose,
+            flavor: flavor ?? '',
+            isCI: !!process.env.CI,
+        });
+        const out = {};
+        for (const [key, value] of Object.entries(raw)) {
+            out[key] = typeof value === 'string' ? value : JSON.stringify(value);
+        }
+        out['process.env.NODE_ENV'] = JSON.stringify(mode === 'development' ? 'development' : 'production');
+        return out;
+    })();
+    const buildResult = await esbuild.build({
+        stdin: {
+            contents: entryCode,
+            resolveDir: projectRoot,
+            sourcefile: 'ns-core-bundle-entry.ts',
+            loader: 'ts',
+        },
+        platform: 'neutral',
+        format: 'esm',
+        bundle: true,
+        target: 'es2019',
+        // Keep every module body — core relies on registration side effects
+        // (CssAnimationProperty.register, global.registerModule, …).
+        treeShaking: false,
+        sourcemap: false,
+        write: false,
+        logLevel: 'silent',
+        legalComments: 'eof',
+        conditions: ['module', 'react-native', 'import', 'browser', 'default'],
+        mainFields: ['module', 'browser', 'main'],
+        resolveExtensions: coreResolveExtensions(String(platform)),
+        loader: {
+            '.css': 'text',
+            '.json': 'json',
+        },
+        define: defines,
+        plugins: [coreAliasPlugin, cssTreeEnvPlugin, nsConfigPlugin, createNativeClassEsbuildPlugin(platform), createUnicodeRegexEsbuildPlugin(projectRoot)],
+        external: NODE_EXTERNALS,
+    });
+    if (!buildResult.outputFiles?.length) {
+        throw new Error('core bundle generation produced no output');
+    }
+    // The shape installer must run before the registry writes in the entry
+    // body so CJS consumers looking up __NS_CORE_MODULES__ always see
+    // plain-object-compatible namespaces (Invariant D).
+    const code = ['/* /ns/core-bundle.mjs — single-eval @nativescript/core (dev bundle mode) */', buildShapeInstallHeader(), buildResult.outputFiles[0].text].join('\n');
+    const hash = createHash('sha1').update(code).digest('hex');
+    const state = {
+        code,
+        subs: new Set(subs),
+        hash,
+        builtAt: Date.now(),
+        buildMs: Date.now() - t0,
+    };
+    if (verbose) {
+        console.log(`[ns-core-bundle] built ${subs.length} subpaths, ${(code.length / 1024).toFixed(0)}kb in ${state.buildMs}ms (hash ${hash.slice(0, 8)})`);
+    }
+    return state;
+}
+export function createCoreBundleService(options) {
+    let state = null;
+    let failed = false;
+    let building = null;
+    const ensureBuilt = async () => {
+        if (state)
+            return state;
+        if (failed)
+            return null;
+        if (!building) {
+            building = generateCoreBundle(options)
+                .then((built) => {
+                state = built;
+                return built;
+            })
+                .catch((error) => {
+                failed = true;
+                console.warn(`[ns-core-bundle] bundle build FAILED — falling back to per-module /ns/core serving for this session. Set NS_CORE_PER_MODULE=1 to silence. Error: ${error?.message || error}`);
+                return null;
+            });
+        }
+        return building;
+    };
+    return {
+        ensureBuilt,
+        getState: () => state,
+        hasFailed: () => failed,
+    };
+}
+let sharedService = null;
+/**
+ * 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 function getSharedCoreBundleService(server) {
+    if (sharedService)
+        return sharedService;
+    const cliFlags = (getCliFlags() || {});
+    const platform = cliFlags.android ? 'android' : cliFlags.visionos ? 'visionos' : 'ios';
+    let flavor = '';
+    try {
+        flavor = getProjectFlavor();
+    }
+    catch { }
+    sharedService = createCoreBundleService({
+        projectRoot: server.config?.root || process.cwd(),
+        platform,
+        mode: server.config?.mode === 'development' ? 'development' : 'production',
+        flavor,
+        verbose: resolveVerboseFlag(),
+    });
+    return sharedService;
+}
+/** Test seam: drop the shared service so specs can mount fresh. */
+export function resetSharedCoreBundleServiceForTests() {
+    sharedService = null;
+}
+export 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 function buildCoreMainShimCode() {
+    return [`/* @nativescript/core bridge (bundle mode) — main */`, `import * as __ns_core_bundle_ns__ from ${JSON.stringify(CORE_BUNDLE_PATH)};`, `export * from ${JSON.stringify(CORE_BUNDLE_PATH)};`, `export default __ns_core_bundle_ns__;`, ``].join('\n');
+}
+/**
+ * Shim served at `/ns/core/<sub>` in bundle mode. The static bundle import
+ * guarantees the registry is populated before the body reads it (ESM deps
+ * evaluate first), so the named `export const` bindings snapshot the final
+ * class/function values. `exportNames` comes from the same disk-based export
+ * discovery the per-module bridge relies on (collectStaticExportNamesFromFile).
+ */
+const RESERVED_EXPORT_NAMES = new Set(['default', 'break', 'case', 'catch', 'class', 'const', 'continue', 'debugger', 'delete', 'do', 'else', 'enum', 'export', 'extends', 'false', 'finally', 'for', 'function', 'if', 'import', 'in', 'instanceof', 'new', 'null', 'return', 'super', 'switch', 'this', 'throw', 'true', 'try', 'typeof', 'var', 'void', 'while', 'with', 'let', 'static', 'yield', 'await', 'eval', 'arguments', '__ns_core_sub_ns__']);
+export function buildCoreSubShimCode(sub, exportNames, hasOwnDefaultExport = false) {
+    const canonical = normalizeCoreSub(sub);
+    const registryKey = `@nativescript/core/${canonical}`;
+    const names = Array.from(new Set(exportNames)).filter((n) => /^[A-Za-z_$][\w$]*$/.test(n) && !RESERVED_EXPORT_NAMES.has(n));
+    const lines = [];
+    lines.push(`/* @nativescript/core bridge (bundle mode) — sub: ${canonical} */`);
+    lines.push(`import ${JSON.stringify(CORE_BUNDLE_PATH)};`);
+    lines.push(`const __ns_core_sub_ns__ = (globalThis.__NS_CORE_MODULES__ || {})[${JSON.stringify(registryKey)}];`);
+    lines.push(`if (!__ns_core_sub_ns__) { throw new Error(${JSON.stringify(`[ns-core] core bundle registry missing '${registryKey}' — restart the dev server or set NS_CORE_PER_MODULE=1`)}); }`);
+    for (const name of names) {
+        lines.push(`export const ${name} = __ns_core_sub_ns__.${name};`);
+    }
+    // Deep-subpath contract (see isDeepCoreSubpath / per-module bridge): a sub
+    // that declares its own `export default` (e.g. utils/lazy.js's
+    // `export default function lazy`) must expose THAT value as the shim's
+    // default — consumers like the vendor bundle do
+    // `import lazy from '@nativescript/core/utils/lazy'` and call it directly.
+    // Subs without an own default keep the self-namespace default so the
+    // "default import + destructure" consumer rewrite still works.
+    if (hasOwnDefaultExport) {
+        lines.push(`export default __ns_core_sub_ns__.default;`);
+    }
+    else {
+        lines.push(`export default __ns_core_sub_ns__;`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=core-bundle.js.map

package/hmr/server/core-bundle.js.map

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

package/hmr/server/framework-strategy.d.ts

@@ -85,8 +85,13 @@ export interface FrameworkServerStrategy {
     rewriteFrameworkImports?(code: string): string;
     /** Framework-specific post-clean phase (strip HMR helpers, etc.). */
     postClean?(code: string): string;
-    /** Ensure framework-specific HTTP endpoints/imports are versioned for cache-busting. */
-    ensureVersionedImports?(code: string, origin: string, version: number): string;
+    /**
+     * Collapse framework-specific HTTP endpoint imports to their canonical
+     * (unversioned) URLs. Module identity is the URL; freshness is driven by
+     * explicit eviction, never URL variation. Versioned inbound shapes from
+     * stale cached device code (e.g. `/ns/sfc/<ver>/…`) are stripped here.
+     */
+    canonicalizeFrameworkImports?(code: string, origin: string): string;
     /** Optional vendor rewrite hook (e.g. map framework helper imports to vendor). */
     rewriteVendorSpec?(code: string, origin: string, version: number): string;
     /**
@@ -154,9 +159,9 @@ export interface FrameworkServerStrategy {
      */
     importMapEntries?(origin: string): Record<string, string>;
     /**
-     * Extra volatile URL patterns the device runtime must always re-fetch (Vue →
-     * `/@ns/sfc/`, `/@ns/asm/`; Angular → `/@ns/asm/`). Defaults to none.
-     * Replaces the framework arm of `getVolatilePatterns`.
+     * Extra volatile URL patterns the device runtime must always re-fetch.
+     * Defaults to none — no built-in strategy needs any (freshness is
+     * eviction-driven), but the hook stays for custom strategies.
      */
     volatilePatterns?(): string[];
     processFile(ctx: FrameworkProcessFileContext): Promise<void>;