@nativescript/vite 8.0.0-alpha.6 → 8.0.0-alpha.60

package/hmr/shared/vendor/manifest.js

@@ -1,12 +1,12 @@
 import * as esbuild from 'esbuild';
-import { readFile } from 'fs/promises';
 import path from 'path';
-import { readFileSync } from 'fs';
 import { createHash } from 'crypto';
-import { createRequire } from 'node:module';
-import { registerVendorManifest, clearVendorManifest, getVendorManifest } from './registry.js';
+import { registerVendorManifest, clearVendorManifest, getVendorManifest, getVendorRuntimeModule } from './registry.js';
+import { collectVendorModules } from './manifest-collect.js';
 import { generatePlatformPolyfills } from '../runtime/platform-polyfills.js';
 import { createNativeClassEsbuildPlugin } from '../../../helpers/nativeclass-esbuild-plugin.js';
+import { getGlobalDefines } from '../../../helpers/global-defines.js';
+import { createVendorEsbuildPlugin, createSolidJsxEsbuildPlugin, angularLinkerEsbuildPlugin, createUnicodeRegexEsbuildPlugin } from './vendor-esbuild-plugins.js';
 export const VENDOR_MANIFEST_ID = '@nativescript/vendor-manifest';
 export const VENDOR_MANIFEST_VIRTUAL_ID = '\0' + VENDOR_MANIFEST_ID;
 export const VENDOR_BUNDLE_ID = '@nativescript/vendor';
@@ -15,105 +15,6 @@ export const SERVER_VENDOR_PATH = '/@nativescript/vendor.mjs';
 export const SERVER_MANIFEST_PATH = '/@nativescript/vendor-manifest.json';
 export const DEFAULT_VENDOR_FILENAME = 'ns-vendor.mjs';
 export const DEFAULT_MANIFEST_FILENAME = 'ns-vendor-manifest.json';
-// Do not force-include @nativescript/core in the dev vendor bundle.
-// Keeping core out of vendor avoids duplicate side-effect registrations (e.g.,
-// com.tns.FragmentClass, com.tns.NativeScriptActivity) across bundle.mjs and vendor.
-// Force runtime-sensitive packages onto the vendor path so they do not drift
-// between startup bundle, HTTP-wrapped CommonJS, and base-require semantics
-// during HMR sessions.
-const ALWAYS_INCLUDE = new Set(['stacktrace-js']);
-const ALWAYS_EXCLUDE = new Set([
-    '@nativescript/android',
-    '@nativescript/ios',
-    '@nativescript/types',
-    '@nativescript/webpack',
-    // Angular browser animations are not used in NativeScript; excluding reduces
-    // memory pressure and avoids bringing partial declarations into vendor.
-    '@angular/animations',
-    '@angular/platform-browser/animations',
-    // Not needed at runtime with linked partials; reduce vendor size/memory.
-    '@angular/platform-browser-dynamic',
-    // Native add-on helpers pulled by ws or others; exclude in NS dev vendor
-    'bufferutil',
-    'utf-8-validate',
-    'node-gyp-build',
-    'bufferutil',
-    'utf-8-validate',
-    'node-gyp-build',
-    // All @babel/* and babel-* packages are build-time tools, never runtime deps.
-    // They get pulled in as peer deps of packages like @nativescript-community/solid-js
-    // but should never be in the vendor bundle (they require 'fs', 'path', etc.).
-    '@babel/core',
-    '@babel/helper-plugin-utils',
-    '@babel/generator',
-    '@babel/helper-string-parser',
-    '@babel/helper-validator-identifier',
-    '@babel/parser',
-    '@babel/plugin-syntax-typescript',
-    '@babel/plugin-transform-typescript',
-    '@babel/preset-typescript',
-    '@babel/preset-env',
-    '@babel/types',
-    'babel-preset-solid',
-    'babel-plugin-jsx-dom-expressions',
-    // Heavy dependency not needed in vendor dev bundle; fetch via HTTP loader instead
-    'rxjs',
-    'nativescript',
-    'typescript',
-    'ts-node',
-    'vue-tsc',
-    'ws',
-    '@types/node',
-    'nativescript-theme-core',
-    // Build-time tools that get pulled in as transitive dependencies but should
-    // never be in the device vendor bundle (they require Node built-ins like fs,
-    // path, child_process, etc.). Now that we collect transitive runtime deps,
-    // these need explicit exclusion.
-    'esbuild',
-    'prettier',
-    'acorn',
-    'recast',
-    'source-map',
-    'source-map-js',
-    'tsx',
-    'diff',
-    'esprima',
-    // TanStack build-time router tooling (code generation, file-based routing)
-    '@tanstack/router-plugin',
-    '@tanstack/router-generator',
-    '@tanstack/router-utils',
-    '@tanstack/virtual-file-routes',
-    // File system / glob utilities — build-time only, require Node fs
-    'fdir',
-    'picomatch',
-    'tinyglobby',
-    // SSR-only library (bot detection) — not needed on device
-    'isbot',
-    // Type-only packages with no runtime JavaScript
-    'csstype',
-    // NativeScript CLI hook system — build-time only, requires Node os/path
-    '@nativescript/hook',
-    // Test runner uses webpack's require.context API which doesn't exist in Vite.
-    // Including it in the vendor bundle causes __require.context crashes at runtime.
-    '@nativescript/unit-test-runner',
-    'nativescript-unit-test-runner',
-    // CSS build tools — postcss, tailwindcss, and related tooling are exclusively
-    // build-time processors. They require Node APIs (process, fs, path) and must
-    // never run on device. esbuild bundles their transitive deps (picocolors,
-    // nanoid, etc.) which reference `process` and crash at runtime.
-    'tailwindcss',
-    '@nativescript/tailwind',
-    'postcss',
-    'autoprefixer',
-    'postcss-import',
-    'postcss-url',
-    'postcss-nested',
-    'picocolors',
-    'nanoid',
-    // Server-side SDKs that require Node networking APIs (net, tls, dns, crypto).
-    // These are backend tools, not device-side.
-    'mongodb',
-]);
 const INDEX_ALIAS_SUFFIXES = ['/index', '/index.js', '/index.android.js', '/index.ios.js', '/index.visionos.js'];
 export function vendorManifestPlugin(options) {
     let cachedResult = null;
@@ -157,15 +58,42 @@ export function vendorManifestPlugin(options) {
         cachedResult = null;
         clearVendorManifest();
     };
+    // Manifest registration without the esbuild payload build. The dev serve
+    // process only needs the manifest (module ids + aliases) for the import
+    // map and vendor-routing decisions — the payload itself is deps-backed
+    // (see getVendorRuntimeModule). The full build stays lazy, reached only
+    // through the fallback serving path or the build-process virtual modules.
+    const ensureManifestRegistered = () => {
+        if (getVendorManifest())
+            return;
+        const collected = collectVendorModules(options.projectRoot, options.platform, options.flavor);
+        const hash = createHash('sha1').update(JSON.stringify(collected.entries)).digest('hex');
+        registerVendorManifest(buildManifest(collected.entries, hash));
+    };
     const respondWithVendor = async (_server, req, res) => {
         try {
-            const result = await ensureResult('server');
             if (req.url === SERVER_VENDOR_PATH) {
+                // ONE node_modules payload: when the deps bundle is active, the
+                // vendor module is a thin view over /ns/deps-bundle.mjs.
+                const depsBacked = getVendorRuntimeModule();
+                if (depsBacked !== null) {
+                    res.setHeader('Content-Type', 'application/javascript');
+                    res.end(depsBacked);
+                    return true;
+                }
+                const result = await ensureResult('server');
                 res.setHeader('Content-Type', 'application/javascript');
                 res.end(createVendorBundleRuntimeModule(result));
                 return true;
             }
             if (req.url === SERVER_MANIFEST_PATH) {
+                const registered = getVendorManifest();
+                if (registered) {
+                    res.setHeader('Content-Type', 'application/json');
+                    res.end(JSON.stringify(registered, null, 2));
+                    return true;
+                }
+                const result = await ensureResult('server');
                 res.setHeader('Content-Type', 'application/json');
                 res.end(JSON.stringify(result.manifest, null, 2));
                 return true;
@@ -184,7 +112,12 @@ export function vendorManifestPlugin(options) {
         enforce: 'pre',
         configResolved() { },
         async configureServer(server) {
-            await ensureResult('server-start');
+            try {
+                ensureManifestRegistered();
+            }
+            catch (error) {
+                console.error('[vendor] failed to register vendor manifest at server start', error);
+            }
             server.middlewares.use(async (req, res, next) => {
                 if (req.url === SERVER_VENDOR_PATH || req.url === SERVER_MANIFEST_PATH) {
                     const handled = await respondWithVendor(server, req, res);
@@ -202,9 +135,12 @@ export function vendorManifestPlugin(options) {
                     return;
                 }
                 resetCache();
-                ensureResult('package.json change').catch((error) => {
-                    console.error('[vendor] failed to regenerate vendor bundle', error);
-                });
+                try {
+                    ensureManifestRegistered();
+                }
+                catch (error) {
+                    console.error('[vendor] failed to regenerate vendor manifest', error);
+                }
             });
         },
         async buildStart() {
@@ -289,10 +225,41 @@ async function generateVendorBundle(options) {
             }));
         },
     };
+    // Externalize the `solid-js` root specifier for the Solid flavor so
+    // vendor-bundled packages (e.g. `@nativescript-community/solid-js`,
+    // `solid-navigation`, transitively `solid-js/universal` and
+    // `solid-js/store`) don't bake their own copy of solid-js into
+    // vendor.mjs. The dev server's import map (see `import-map.ts`)
+    // redirects bare `solid-js` to the same `/ns/m/node_modules/solid-js/...`
+    // URL that Vite's alias produces for user code and `@solid-refresh`,
+    // so V8 dedupes the three import paths down to a single module
+    // instance — one `Owner` module-local, one reactive graph, one
+    // `$DEVCOMP`/`$PROXY` symbol identity across the whole app.
+    //
+    // Important: scope this to the EXACT bare `solid-js` specifier. Subpaths
+    // like `solid-js/store`, `solid-js/universal`, `solid-js/web` stay
+    // bundleable so vendor packages that import them keep working out of
+    // the box; those subpaths still go through the unified solid-js
+    // runtime via their own `import 'solid-js'` statements (which we just
+    // externalized).
+    const nsSolidJsExternalPlugin = {
+        name: 'ns-solid-js-external',
+        setup(build) {
+            build.onResolve({ filter: /^solid-js$/ }, (args) => ({
+                path: args.path,
+                external: true,
+            }));
+        },
+    };
     const plugins = [
         // Mark @nativescript/core external BEFORE other plugins so esbuild never
         // tries to read/transform core's source files. See comment above.
         nsCoreExternalPlugin,
+        // For the Solid flavor, externalize `solid-js` so vendor.mjs and the
+        // HTTP-served `@solid-refresh` / user code converge on one runtime
+        // realm. See `nsSolidJsExternalPlugin`'s definition for the full
+        // duplicate-instance rationale.
+        ...(flavor === 'solid' ? [nsSolidJsExternalPlugin] : []),
         // Apply NativeClass transformer to convert @NativeClass decorated classes to ES5 IIFE pattern.
         // This MUST run before other plugins to ensure proper transformation.
         createNativeClassEsbuildPlugin(platform),
@@ -314,6 +281,12 @@ async function generateVendorBundle(options) {
     if (flavor === 'solid') {
         plugins.push(createSolidJsxEsbuildPlugin(projectRoot));
     }
+    // Registered last so the framework-specific passes above own their files
+    // first (esbuild stops at the first onLoad that returns a result). Applies
+    // to every flavor: any vendored dependency (e.g. highlight.js) may ship
+    // `\p{…}` regexes that NativeScript's non-ICU V8 cannot compile, which would
+    // otherwise abort the entire vendor.mjs compile. See the plugin for details.
+    plugins.push(createUnicodeRegexEsbuildPlugin(projectRoot));
     const buildResult = await esbuild.build({
         stdin: {
             contents: entryCode,
@@ -353,9 +326,31 @@ async function generateVendorBundle(options) {
             '.css': 'text',
             '.json': 'json',
         },
-        define: {
-            'process.env.NODE_ENV': JSON.stringify(mode),
-        },
+        // Mirror Vite's main-bundle DefinePlugin in the vendor esbuild build.
+        //
+        // esbuild's `define` requires every value to be a JS expression
+        // expressed as a string (the same constraint Vite normalises away).
+        // `getGlobalDefines()` returns a few raw `boolean` values for
+        // historical reasons (e.g. `__COMMONJS__: false`,
+        // `__UI_USE_XML_PARSER__: true`), so coerce any non-string entries
+        // through `JSON.stringify` before handing the table to esbuild.
+        define: (() => {
+            const raw = getGlobalDefines({
+                platform,
+                targetMode: mode,
+                verbose: !!options.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);
+            }
+            // Belt-and-suspenders: keep the original NODE_ENV define explicit so
+            // future changes to `getGlobalDefines()` can't silently drop it.
+            out['process.env.NODE_ENV'] = JSON.stringify(mode);
+            return out;
+        })(),
         plugins,
         // Externalize ALL Node built-in modules. The vendor bundle runs on the
         // NativeScript device runtime, not Node, so any Node API reference must
@@ -477,238 +472,32 @@ async function generateVendorBundle(options) {
         entries: collected.entries,
     };
 }
-function collectVendorModules(projectRoot, platform, flavor) {
-    const packageJsonPath = path.resolve(projectRoot, 'package.json');
-    const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-    const projectRequire = createRequire(packageJsonPath);
-    const vendor = new Set();
-    const visited = new Set();
-    const queue = [];
-    const isPackageRootSpecifier = (name) => {
-        if (!name)
-            return false;
-        if (name.startsWith('@')) {
-            // Scoped: @scope/name is root; anything deeper is subpath
-            const parts = name.split('/');
-            return parts.length === 2;
-        }
-        // Unscoped: no slash means root; any slash means subpath
-        return !name.includes('/');
-    };
-    const isAngularFlavor = flavor === 'angular';
-    const addCandidate = (name) => {
-        if (!name || shouldSkipDependency(name)) {
-            return;
-        }
-        // Avoid pulling Angular compiler/runtime into the dev vendor bundle when
-        // the current project flavor is not Angular (for example, solid). This
-        // prevents esbuild from trying to bundle @angular/compiler and its Babel
-        // toolchain, which requires Node built-ins like fs/path/url.
-        if (!isAngularFlavor && (name === '@angular/compiler' || name.startsWith('@angular/'))) {
-            return;
-        }
-        // Skip already-visited packages to avoid redundant queue processing
-        if (visited.has(name)) {
-            return;
-        }
-        visited.add(name);
-        vendor.add(name);
-        const isRoot = isPackageRootSpecifier(name);
-        // Only traverse deps for package roots; subpaths should not attempt package.json resolution
-        if (isRoot) {
-            queue.push(name);
-        }
-    };
-    const addDeps = (deps) => {
-        if (!deps) {
-            return;
-        }
-        for (const name of Object.keys(deps)) {
-            addCandidate(name);
-        }
-    };
-    addDeps(pkg.dependencies);
-    addDeps(pkg.optionalDependencies);
-    for (const name of ALWAYS_INCLUDE) {
-        // Some force-included packages are only present transitively in apps that
-        // actually use them. Skip missing packages quietly so unrelated projects do
-        // not fail vendor collection just because the policy list names them.
-        if (canResolveDependencyPackageJson(name, projectRequire)) {
-            addCandidate(name);
-        }
-    }
-    // Ensure Android Activity proxy is present for SBG scanning in dev/HMR
-    // and non-HMR builds alike: explicitly include the side-effect module
-    // that registers `com.tns.NativeScriptActivity`.
-    if (platform === 'android') {
-        addCandidate('@nativescript/core/ui/frame/activity.android');
-    }
-    if (pkg.dependencies?.['nativescript-vue'] && pkg.devDependencies?.vue) {
-        addCandidate('vue');
-    }
-    // Angular framework packages are intentionally NOT added to vendor. They are
-    // served via HTTP only so every importer resolves to a single module realm.
-    // See shouldSkipDependency() for the full rationale. RxJS is also left out of
-    // vendor (large, and not required in the vendor bundle for dev HMR).
-    if (pkg.dependencies?.['react-nativescript']) {
-        if (pkg.dependencies?.react) {
-            addCandidate('react');
-        }
-        if (pkg.dependencies?.['react-dom']) {
-            addCandidate('react-dom');
-        }
-    }
-    // SolidJS / TanStack Router: when @nativescript/tanstack-router is a dependency,
-    // its runtime deps (@tanstack/solid-router, @tanstack/router-core, @tanstack/history)
-    // MUST be in the vendor bundle. These packages:
-    // 1. Use browser APIs (window.dispatchEvent) that don't exist in NativeScript — they
-    //    must be bundled where the NativeScript wrapper intercepts those calls
-    // 2. Contain JSX source that needs Solid compilation (dist/source/*.jsx) — the HTTP
-    //    fallback can't compile node_modules JSX since vite-plugin-solid skips it
-    // 3. Import solid-js internally — loading via HTTP creates a separate solid-js instance
-    // esbuild uses the 'import' condition (not 'solid'), resolving to pre-compiled
-    // dist/esm/*.js which avoids all three issues.
-    if (pkg.dependencies?.['@nativescript/tanstack-router']) {
-        addCandidate('@tanstack/solid-router');
-        addCandidate('@tanstack/router-core');
-        addCandidate('@tanstack/history');
-    }
-    parseEnvList(process.env.NS_VENDOR_INCLUDE).forEach(addCandidate);
-    const projectDeps = {
-        dependencies: new Set(Object.keys(pkg.dependencies ?? {})),
-        optional: new Set(Object.keys(pkg.optionalDependencies ?? {})),
-        dev: new Set(Object.keys(pkg.devDependencies ?? {})),
-    };
-    while (queue.length) {
-        const specifier = queue.shift();
-        const dependencyPkg = readDependencyPackageJson(specifier, projectRequire);
-        if (!dependencyPkg) {
-            continue;
-        }
-        const peerDependencies = Object.keys(dependencyPkg.peerDependencies ?? {});
-        for (const peer of peerDependencies) {
-            if (shouldSkipDependency(peer)) {
-                continue;
-            }
-            if (projectDeps.dependencies.has(peer) || projectDeps.optional.has(peer) || projectDeps.dev.has(peer)) {
-                addCandidate(peer);
-            }
-        }
-        // NOTE: We intentionally do NOT collect transitive runtime dependencies
-        // here. The import map + runtime specifier normalization handles non-vendor
-        // packages by routing them through HTTP to the Vite dev server. This avoids
-        // the fragility of trying to esbuild-bundle every transitive dep (which can
-        // fail due to Node built-ins, type-only packages, duplicate module instances,
-        // etc.). Only direct project dependencies go into the vendor bundle.
-    }
-    parseEnvList(process.env.NS_VENDOR_EXCLUDE).forEach((name) => {
-        vendor.delete(name);
-    });
-    return {
-        entries: Array.from(vendor).sort(),
-    };
-}
-function shouldSkipDependency(name) {
-    if (!name) {
-        return true;
-    }
-    if (ALWAYS_EXCLUDE.has(name)) {
-        return true;
-    }
-    // Angular framework packages must only be served via the HTTP path so every
-    // importer resolves to a single module realm. When these packages are present
-    // in the vendor bundle AND imported by app modules via HTTP subpath, every
-    // @Component/@Injectable gets defined twice (once per realm), producing NG0912
-    // selector collisions, cross-realm `instanceof` failures, and dual class
-    // identities throughout Angular's DI container. HTTP-only is the single-realm
-    // invariant for user-level framework code.
-    if (name === '@nativescript/angular' || name === 'nativescript-angular' || name.startsWith('@angular/')) {
-        return true;
-    }
-    // All Babel packages are build tools — never bundle into device runtime.
-    // They require Node built-ins (fs, path, url) that don't exist on device.
-    if (name.startsWith('@babel/') || name.startsWith('babel-')) {
-        return true;
-    }
-    // Dev tools and type-only packages — not needed on device
-    if (name.startsWith('@solid-devtools/')) {
-        return true;
-    }
-    if (name.startsWith('@types/')) {
-        return true;
-    }
-    // PostCSS ecosystem — all build-time CSS processing
-    if (name === 'postcss' || name.startsWith('postcss-')) {
-        return true;
-    }
-    // Tailwind ecosystem — build-time only CSS framework
-    if (name.includes('tailwind')) {
-        return true;
-    }
-    // Test runners and frameworks — never needed on device
-    if (name.includes('test-runner') || name.includes('unit-test')) {
-        return true;
-    }
-    // Linters and formatters — build-time tools
-    if (name.includes('eslint') || name.includes('stylelint')) {
-        return true;
-    }
-    if (name.startsWith('.')) {
-        return true;
-    }
-    if (name.startsWith('file:')) {
-        return true;
-    }
-    if (name.startsWith('workspace:')) {
-        return true;
-    }
-    if (name.startsWith('link:')) {
-        return true;
-    }
-    return false;
-}
-export const __test_collectVendorModules = collectVendorModules;
-export const __test_createVendorBundleRuntimeModule = createVendorBundleRuntimeModule;
-function canResolveDependencyPackageJson(specifier, projectRequire) {
-    try {
-        projectRequire.resolve(`${specifier}/package.json`);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function readDependencyPackageJson(specifier, projectRequire) {
-    try {
-        const packageJsonPath = projectRequire.resolve(`${specifier}/package.json`);
-        return JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-    }
-    catch (error) {
-        if (process.env.VITE_DEBUG_LOGS) {
-            console.warn(`[vendor] unable to resolve ${specifier} package.json`, error);
-        }
-        return null;
-    }
-}
-function parseEnvList(value) {
-    if (!value) {
-        return [];
-    }
-    return value
-        .split(',')
-        .map((token) => token.trim())
-        .filter(Boolean);
-}
 function createVendorEntry(entries) {
     if (!entries.length) {
         return `export const __nsVendorModuleMap = {};
 `;
     }
-    const imports = entries.map((specifier, index) => `import * as __nsVendor_${index} from ${JSON.stringify(specifier)};`).join('\n');
+    // Emit a side-effect-only import FIRST for each entry, then the namespace
+    // import we actually expose through `__nsVendorModuleMap`. Per the ESM
+    // spec, `import "pkg";` (no clause) guarantees module body evaluation, and
+    // esbuild treats these as DCE-immune even when the package declares
+    // `"sideEffects": false`. Without this, packages whose top-level
+    // statements install runtime patches (e.g. `@nativescript-community/text`
+    // monkey-patching `TextBase.prototype.setTextDecorationAndTransform` via
+    // `overrideSpanAndFormattedString()` invoked from
+    // `@nativescript-community/ui-label/index-common.js` line 12) can have
+    // their bodies elided by esbuild — exports stay resolvable via the
+    // namespace, but the runtime patches never fire, producing line-height /
+    // letter-spacing / formatted-text rendering divergence between HMR
+    // (vendor.mjs via HTTP) and no-HMR (single Rolldown bundle that inlines
+    // everything anyway). This affects any NS plugin that relies on top-level
+    // side-effects to wire up renderer behavior.
+    const sideEffectImports = entries.map((specifier) => `import ${JSON.stringify(specifier)};`).join('\n');
+    const namespaceImports = entries.map((specifier, index) => `import * as __nsVendor_${index} from ${JSON.stringify(specifier)};`).join('\n');
     const modules = entries.map((specifier, index) => `${JSON.stringify(specifier)}: __nsVendor_${index}`).join(',\n  ');
-    return `${imports}\n\nexport const __nsVendorModuleMap = {\n  ${modules}\n};\n`;
+    return `${sideEffectImports}\n\n${namespaceImports}\n\nexport const __nsVendorModuleMap = {\n  ${modules}\n};\n`;
 }
-function createVendorBundleRuntimeModule(result) {
+export function createVendorBundleRuntimeModule(result) {
     return `${result.code}
 export const vendorManifest = ${JSON.stringify(result.manifest)};
 export default vendorManifest;
@@ -771,495 +560,6 @@ function createSbgVendorAssetCode(platform) {
     lines.push('export const __nsVendorModuleMap = {};\nexport default {};\n');
     return lines.join('\n');
 }
-function createVendorEsbuildPlugin(projectRoot) {
-    return {
-        name: 'ns-vendor-resolver',
-        setup(build) {
-            const debug = process.env.VITE_DEBUG_LOGS === 'true' || process.env.VITE_DEBUG_LOGS === '1';
-            build.onResolve({ filter: /^~\/package\.json$/ }, () => ({
-                path: path.resolve(projectRoot, 'package.json'),
-            }));
-            build.onResolve({ filter: /^module$/ }, () => ({
-                path: 'ns-vendor-module-shim',
-                namespace: 'ns-vendor',
-            }));
-            build.onLoad({ filter: /^ns-vendor-module-shim$/, namespace: 'ns-vendor' }, () => ({
-                contents: vendorModuleShim,
-                loader: 'js',
-            }));
-            // Stub Angular animations in vendor to avoid bundling browser-only code.
-            // Provide named exports expected by @nativescript/angular to satisfy esbuild.
-            const PB_ANIMATIONS_ID = 'ns-animations-pb-shim';
-            const ANIMATIONS_BROWSER_ID = 'ns-animations-browser-shim';
-            const ANIMATIONS_ID = 'ns-animations-noop';
-            // @angular/platform-browser/animations -> provide concrete named stubs
-            build.onResolve({ filter: /^@angular\/platform-browser\/animations(?:\/.*)?$/ }, (args) => {
-                if (debug) {
-                    try {
-                        console.log('[vendor] map', args.path, '->', PB_ANIMATIONS_ID);
-                    }
-                    catch { }
-                }
-                return { path: PB_ANIMATIONS_ID, namespace: 'ns-vendor' };
-            });
-            build.onLoad({ filter: new RegExp(`^${PB_ANIMATIONS_ID}$`), namespace: 'ns-vendor' }, () => ({
-                contents: [
-                    'export default {};',
-                    // Commonly imported symbols by @nativescript/angular
-                    'export class AnimationBuilder {};',
-                    'export const \u0275BrowserAnimationBuilder = class {};',
-                    'export const \u0275AnimationEngine = class {};',
-                    'export const \u0275AnimationRendererFactory = class {};',
-                    'export const \u0275WebAnimationsStyleNormalizer = class {};',
-                    // Typical platform-browser/animations APIs exported; safe no-ops
-                    'export class BrowserAnimationsModule {};',
-                    'export class NoopAnimationsModule {};',
-                    'export const provideAnimations = (..._args) => [];',
-                    'export const provideNoopAnimations = (..._args) => [];',
-                    // Marker used by some Angular internals
-                    'export const ANIMATION_MODULE_TYPE = void 0;',
-                ].join('\n'),
-                loader: 'js',
-            }));
-            // @angular/animations/browser -> provide ɵ* engine/renderer/style normalizer stubs
-            build.onResolve({ filter: /^@angular\/animations\/browser(?:\/.*)?$/ }, (args) => {
-                if (debug) {
-                    try {
-                        console.log('[vendor] map', args.path, '->', ANIMATIONS_BROWSER_ID);
-                    }
-                    catch { }
-                }
-                return { path: ANIMATIONS_BROWSER_ID, namespace: 'ns-vendor' };
-            });
-            build.onLoad({ filter: new RegExp(`^${ANIMATIONS_BROWSER_ID}$`), namespace: 'ns-vendor' }, () => ({
-                contents: [
-                    'export default {};',
-                    'export class AnimationDriver {};',
-                    'export const \u0275AnimationRendererFactory = class {};',
-                    'export const \u0275AnimationStyleNormalizer = class {};',
-                    'export const \u0275WebAnimationsStyleNormalizer = class {};',
-                    'export const \u0275AnimationEngine = class {};',
-                    // Convenience alias if any consumers import non-ɵ name
-                    'export const AnimationStyleNormalizer = \u0275AnimationStyleNormalizer;',
-                ].join('\n'),
-                loader: 'js',
-            }));
-            // @angular/animations -> broad no-op surface
-            build.onResolve(
-            // Keep generic mapping for @angular/animations base; /browser is handled above
-            { filter: /^@angular\/animations(?:$|\/)$/ }, (args) => {
-                if (debug) {
-                    try {
-                        console.log('[vendor] map', args.path, '->', ANIMATIONS_ID);
-                    }
-                    catch { }
-                }
-                return { path: ANIMATIONS_ID, namespace: 'ns-vendor' };
-            });
-            build.onLoad({ filter: new RegExp(`^${ANIMATIONS_ID}$`), namespace: 'ns-vendor' }, () => ({
-                contents: [
-                    'export default {};',
-                    // Provide names sometimes (incorrectly) imported from @angular/animations by wrappers
-                    'export class AnimationBuilder {};',
-                    'export const \u0275BrowserAnimationBuilder = class {};',
-                    'export const \u0275AnimationEngine = class {};',
-                    'export const \u0275AnimationRendererFactory = class {};',
-                    'export const \u0275WebAnimationsStyleNormalizer = class {};',
-                    'export const ANIMATION_MODULE_TYPE = void 0;',
-                    // Export a few common tokens as harmless stubs
-                    'export const animate = (..._a) => ({});',
-                    'export const state = (..._a) => ({});',
-                    'export const style = (..._a) => ({});',
-                    'export const transition = (..._a) => ({});',
-                    'export const trigger = (..._a) => ({});',
-                    'export const sequence = (..._a) => ({});',
-                    'export const group = (..._a) => ({});',
-                    'export const query = (..._a) => ({});',
-                    'export const stagger = (..._a) => ({});',
-                    'export const keyframes = (..._a) => ({});',
-                ].join('\n'),
-                loader: 'js',
-            }));
-        },
-    };
-}
-/**
- * esbuild plugin to compile .jsx/.tsx files from Solid packages through
- * babel-preset-solid. Without this, esbuild uses its default React JSX
- * transform, producing React.createElement calls that crash at runtime.
- *
- * Only applied to files inside node_modules that have .jsx or .tsx extension.
- */
-function createSolidJsxEsbuildPlugin(projectRoot) {
-    // Lazy-load Babel and the Solid preset so they're only required when
-    // the Solid flavor is active.
-    let babel;
-    let solidPreset;
-    return {
-        name: 'ns-vendor-solid-jsx',
-        setup(build) {
-            // Intercept .jsx and .tsx files from node_modules
-            build.onLoad({ filter: /node_modules\/.*\.[jt]sx$/ }, async (args) => {
-                try {
-                    if (!babel) {
-                        babel = await import('@babel/core');
-                        // babel-preset-solid is the standard Solid JSX transform
-                        solidPreset = (await import('babel-preset-solid')).default;
-                    }
-                    const source = await readFile(args.path, 'utf-8');
-                    const result = await babel.transformAsync(source, {
-                        filename: args.path,
-                        presets: [
-                            [
-                                solidPreset,
-                                {
-                                    generate: 'universal',
-                                    hydratable: false,
-                                    moduleName: '@nativescript-community/solid-js',
-                                },
-                            ],
-                        ],
-                        parserOpts: {
-                            plugins: ['jsx', ...(args.path.endsWith('.tsx') ? ['typescript'] : [])],
-                        },
-                        ast: false,
-                        sourceMaps: false,
-                        configFile: false,
-                        babelrc: false,
-                    });
-                    if (result?.code) {
-                        return { contents: result.code, loader: 'js' };
-                    }
-                }
-                catch (e) {
-                    console.warn(`[ns-vendor-solid-jsx] failed to transform ${args.path}:`, e?.message || e);
-                }
-                // Fall through to esbuild's default handling
-                return undefined;
-            });
-        },
-    };
-}
-/**
- * Minimal esbuild plugin to run Angular linker (Babel) over partial-compiled
- * Angular packages in node_modules. This converts ɵɵngDeclare* calls into
- * ɵɵdefine* so runtime doesn't require the JIT compiler.
- */
-function angularLinkerEsbuildPlugin(projectRoot) {
-    // Lazily resolve Babel and Angular linker from the project to avoid hard deps
-    let babel = null;
-    let createLinker = null;
-    let angularFileSystem = null;
-    async function ensureDeps() {
-        if (babel && createLinker)
-            return;
-        try {
-            const req = createRequire(projectRoot + '/package.json');
-            // Resolve from the application project first
-            const babelPath = req.resolve('@babel/core');
-            const linkerPath = req.resolve('@angular/compiler-cli/linker/babel');
-            babel = (await import(babelPath));
-            const linkerMod = await import(linkerPath);
-            createLinker = linkerMod.createLinkerPlugin || linkerMod.createEs2015LinkerPlugin || null;
-        }
-        catch {
-            // As a fallback, try local resolution (hoisted installs)
-            try {
-                babel = (await import('@babel/core'));
-            }
-            catch { }
-            try {
-                const linkerMod = await import('@angular/compiler-cli/linker/babel');
-                createLinker = linkerMod.createLinkerPlugin || linkerMod.createEs2015LinkerPlugin || null;
-            }
-            catch { }
-        }
-        // Angular 21+ requires a fileSystem for the linker plugin
-        if (!angularFileSystem) {
-            try {
-                const req = createRequire(projectRoot + '/package.json');
-                const cliPath = req.resolve('@angular/compiler-cli');
-                const cliMod = await import(cliPath);
-                if (cliMod.NodeJSFileSystem) {
-                    angularFileSystem = new cliMod.NodeJSFileSystem();
-                }
-            }
-            catch { }
-            if (!angularFileSystem) {
-                try {
-                    const cliMod = await import('@angular/compiler-cli');
-                    if (cliMod.NodeJSFileSystem) {
-                        angularFileSystem = new cliMod.NodeJSFileSystem();
-                    }
-                }
-                catch { }
-            }
-            if (!angularFileSystem) {
-                // Minimal fallback
-                const nodePath = await import('node:path');
-                const nodeFs = await import('node:fs');
-                angularFileSystem = {
-                    resolve: (...paths) => nodePath.resolve(...paths),
-                    dirname: (p) => nodePath.dirname(p),
-                    join: (...paths) => nodePath.join(...paths),
-                    isRooted: (p) => nodePath.isAbsolute(p),
-                    exists: (p) => nodeFs.existsSync(p),
-                    readFile: (p) => nodeFs.readFileSync(p, 'utf8'),
-                };
-            }
-        }
-    }
-    // Restrict to Angular framework packages to minimize esbuild memory usage.
-    const FILTER = /node_modules\/(?:@angular|@nativescript\/angular)\/.*\.[mc]?js$/;
-    return {
-        name: 'ns-angular-linker',
-        async setup(build) {
-            const debug = process.env.VITE_DEBUG_LOGS === 'true' || process.env.VITE_DEBUG_LOGS === '1';
-            await ensureDeps();
-            if (!babel || !createLinker) {
-                // Nothing to do if deps unavailable
-                return;
-            }
-            build.onLoad({ filter: FILTER }, async (args) => {
-                try {
-                    const source = await readFile(args.path, 'utf8');
-                    // Fast-path: only run linker when partial declarations are present
-                    if (!(source.includes('\u0275\u0275ngDeclare') || source.includes('ɵɵngDeclare'))) {
-                        return { contents: source, loader: 'js' };
-                    }
-                    const plugin = createLinker({
-                        sourceMapping: false,
-                        fileSystem: angularFileSystem,
-                    });
-                    if (debug) {
-                        try {
-                            console.log('[ns-angular-linker][vendor] linking', args.path);
-                        }
-                        catch { }
-                    }
-                    const result = await babel.transformAsync(source, {
-                        filename: args.path,
-                        configFile: false,
-                        babelrc: false,
-                        sourceMaps: false,
-                        compact: false,
-                        plugins: [plugin],
-                    });
-                    return {
-                        contents: (result && result.code) || source,
-                        loader: 'js',
-                    };
-                }
-                catch (e) {
-                    // On any failure, return original source to avoid breaking the build
-                    return { contents: await readFile(args.path, 'utf8'), loader: 'js' };
-                }
-            });
-        },
-    };
-}
-const vendorModuleShim = `
-const g = globalThis;
-const BACKSLASH = String.fromCharCode(92);
-
-function toForwardSlashes(input) {
-  return String(input ?? '').split(BACKSLASH).join('/');
-}
-
-function getNativeScriptRequire() {
-  const nsRequire = typeof g.require === "function" ? g.require : null;
-  if (nsRequire) {
-    return nsRequire;
-  }
-  const legacy = g.__nsRequire;
-  if (typeof legacy === "function") {
-    return legacy;
-  }
-  return null;
-}
-
-function getDocumentsPath() {
-  const cached = g.__NS_DOCUMENTS_PATH__;
-  if (typeof cached === "string" && cached.length) {
-    return toForwardSlashes(cached);
-  }
-  try {
-    const core = g.require ? g.require("@nativescript/core") : null;
-    const docsFolder = core?.knownFolders?.documents?.();
-    const docPath = docsFolder?.path;
-    if (docPath) {
-      const normalized = toForwardSlashes(docPath);
-      g.__NS_DOCUMENTS_PATH__ = normalized;
-      return normalized;
-    }
-  } catch (_err) {
-    // ignore - fallback to raw specifier
-  }
-  return null;
-}
-
-function collapseSegments(input) {
-  const segments = [];
-  const parts = input.split('/');
-  for (const part of parts) {
-    if (!part || part === ".") {
-      continue;
-    }
-    if (part === "..") {
-      if (segments.length && segments[segments.length - 1] !== "..") {
-        segments.pop();
-        continue;
-      }
-    }
-    segments.push(part);
-  }
-  const leadingSlash = input.startsWith('/');
-  return (leadingSlash ? '/' : '') + segments.join('/');
-}
-
-function normalizeSpecifier(spec) {
-  let value = String(spec ?? "");
-  value = toForwardSlashes(value);
-  const docsPath = getDocumentsPath();
-  if (value.startsWith("__NSDOC__/")) {
-    if (docsPath) {
-      value = docsPath + '/' + value.slice("__NSDOC__/".length);
-    } else {
-      value = value.slice("__NSDOC__/".length);
-    }
-  }
-  if (value.startsWith("~/") && docsPath) {
-    value = docsPath + '/' + value.slice(2);
-  }
-  if (value.startsWith("file://")) {
-    const stripped = value.slice("file://".length);
-    value = stripped.startsWith('/') ? stripped : '/' + stripped;
-  }
-  if (value.includes("/../") || value.includes("/./")) {
-    value = collapseSegments(value);
-  }
-  return value;
-}
-
-function normalizeCoreSubLocal(s) {
-  if (!s) return "";
-  let t = String(s).split("?")[0].split("#")[0].trim();
-  t = t.replace(/^\\/+/, "").replace(/\\/+$/, "");
-  t = t.replace(/\\.(?:mjs|cjs|js)$/, "");
-  if (t.length >= 6 && t.substring(t.length - 6) === "/index") {
-    t = t.substring(0, t.length - 6);
-  }
-  if (!t || t === "index") return "";
-  return t;
-}
-
-// Invariant D: shape ESM namespaces before returning to CJS callers.
-//
-// The /ns/core handler's registration footer (see websocket.ts) and the
-// main-entry require shim (see helpers/main-entry.ts) both install the
-// shape function on globalThis. In practice, entries stored in
-// __NS_CORE_MODULES__ are ALREADY shaped, so this pass-through is a
-// fast no-op (the shape function's fast path returns obj as-is when it
-// already has Object.prototype). We call it anyway as defense-in-depth
-// against future callers that might populate the registry without
-// shaping.
-function shapeForCjs(value) {
-  if (!value || typeof value !== "object") return value;
-  const shape = g.__NS_CJS_SHAPE__;
-  if (typeof shape === "function") {
-    try { return shape(value); } catch (e) {}
-  }
-  return value;
-}
-
-function resolveCoreFromRegistry(normalizedId) {
-  if (
-    normalizedId !== "@nativescript/core" &&
-    normalizedId.indexOf("@nativescript/core/") !== 0
-  ) {
-    return null;
-  }
-  const table = g.__NS_CORE_MODULES__;
-  if (!table) return null;
-  if (table[normalizedId]) return shapeForCjs(table[normalizedId]);
-  const rawSub =
-    normalizedId === "@nativescript/core"
-      ? ""
-      : normalizedId.slice("@nativescript/core/".length);
-  const normSub = normalizeCoreSubLocal(rawSub);
-  const bareKey = normSub ? "@nativescript/core/" + normSub : "@nativescript/core";
-  if (table[bareKey]) return shapeForCjs(table[bareKey]);
-  if (normSub && table[normSub]) return shapeForCjs(table[normSub]);
-  if (!normSub && table[""]) return shapeForCjs(table[""]);
-  return null;
-}
-
-export function createRequire(_url) {
-  const nsRequire = getNativeScriptRequire();
-  if (!nsRequire) {
-    return function (id) {
-      // Even without nsRequire, the @nativescript/core registry populated by
-      // the /ns/core bridge may already have the module — return it so
-      // vendor install() hooks that run against the HMR-served core don't
-      // crash at module-instantiation time.
-      const fromRegistry = resolveCoreFromRegistry(normalizeSpecifier(id));
-      if (fromRegistry) return fromRegistry;
-      throw new Error("NativeScript require() is not available in this context");
-    };
-  }
-  const req = function (id) {
-    const normalizedId = normalizeSpecifier(id);
-    // Invariant C: @nativescript/core and its subpaths are served ONCE via
-    // the /ns/core HTTP bridge, which self-registers each module's ESM
-    // namespace on globalThis.__NS_CORE_MODULES__. CommonJS require() from
-    // vendor packages (e.g. \`require('@nativescript/core/ui/core/view').View\`
-    // in @nativescript-community/gesturehandler, or \`require('@nativescript/core').View\`
-    // in @nativescript-community/ui-material-core) MUST resolve to that
-    // same namespace; otherwise we re-trigger class identity splits and
-    // applyMixins() crashes with "Cannot read properties of undefined".
-    const fromRegistry = resolveCoreFromRegistry(normalizedId);
-    if (fromRegistry) return fromRegistry;
-    if (
-      normalizedId.includes("../data/patch.json") ||
-      normalizedId.includes("css-tree/lib/data/patch.json")
-    ) {
-      return {
-        atrules: {},
-        properties: {},
-        types: {},
-      };
-    }
-    if (normalizedId.includes("mdn-data/")) {
-      return {};
-    }
-    if (
-      normalizedId.endsWith("/package.json") ||
-      normalizedId.includes("../package.json")
-    ) {
-      return { version: "0.0.0" };
-    }
-    if (normalizedId.endsWith(".json")) {
-      return {};
-    }
-    // Shape the native require result too. The NativeScript CJS loader
-    // may serve an @nativescript/core subpath over HTTP before the
-    // /ns/core footer has run (e.g., during initial boot). In that
-    // window, the result is a raw ESM namespace with null [[Prototype]]
-    // and zone.js/vendor install() hooks crash on hasOwnProperty.
-    return shapeForCjs(nsRequire(normalizedId));
-  };
-  req.resolve = nsRequire.resolve
-    ? function (id) {
-        return nsRequire.resolve(id);
-      }
-    : function (id) {
-        return id;
-      };
-  return req;
-}
-
-export default { createRequire };
-`;
 function stripIndexSuffix(specifier) {
     return specifier.replace(/\/(?:(?:index)(?:\.[^.\/]+)?)$/, '');
 }