@nativescript/vite 8.0.0-alpha.29 → 8.0.0-alpha.30

package/hmr/shared/vendor/manifest.js

@@ -1,14 +1,12 @@
 import * as esbuild from 'esbuild';
-import { readFile } from 'fs/promises';
 import path from 'path';
-import fs, { readFileSync } from 'fs';
 import { createHash } from 'crypto';
-import { createRequire } from 'node:module';
-import { getAngularLinkerFactory, runAngularLinker } from '../../../helpers/angular/shared-linker.js';
 import { registerVendorManifest, clearVendorManifest, getVendorManifest } 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 } 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';
@@ -17,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;
@@ -532,419 +431,8 @@ 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 debug = process.env.VITE_DEBUG_LOGS === 'true' || process.env.VITE_DEBUG_LOGS === '1';
-    const vendor = new Set();
-    const visited = new Set();
-    const queue = [];
-    // Local-source deps (file: pointing to a directory, link:, workspace:) are
-    // app code, not pre-packaged libraries. esbuild's vendor pipeline has none
-    // of the user's tsconfig path aliases or other Vite plugin resolvers, so
-    // any aliased import inside their source will fail with "Could not
-    // resolve". We collect their names here so that peer-dep traversal can
-    // also skip them.
-    const localSourceNames = new Set();
-    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 isSolidFlavor = flavor === 'solid';
-    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;
-        }
-        // For the Solid flavor, keep `solid-js` itself OUT of the vendor bundle.
-        //
-        // Both `@solid-refresh` (served via HTTP) and Vite-aliased user code
-        // import `solid-js` through the dev server, while the vendor bundle
-        // pulls it in as a peerDependency of `@nativescript-community/solid-js`.
-        // Two copies → two `Owner` module-locals → the proxy memo created by
-        // `solid-refresh`'s `HMRComp` is registered on the HTTP copy's Owner
-        // (which is always null — hence the
-        // `computations created outside a createRoot or render` warning), while
-        // `render(App, doc)` runs against the vendor copy's Owner. Same chain
-        // breaks HMR propagation: `patchRegistry`'s `setComp` ticks the HTTP
-        // copy's signal but the live page tree subscribes through the vendor
-        // copy's reactive graph, so the new component body never reaches the
-        // screen.
-        //
-        // We pair this skip with the matching esbuild externalization
-        // (`nsSolidJsExternalPlugin`) and an import-map redirect in
-        // `import-map.ts` that points `solid-js` at the HTTP URL. All three
-        // converge on the same dev-server URL, V8 dedupes by URL, and the
-        // app sees a single `solid-js` realm.
-        if (isSolidFlavor && name === 'solid-js') {
-            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, spec] of Object.entries(deps)) {
-            if (isUnvendorableLocalSource(name, spec, projectRequire, platform)) {
-                // Defer to the regular Vite/Rolldown pipeline (HTTP-served in
-                // dev, bundled in production) where the
-                // ns-tsconfig-paths-resolver and the rest of the plugin chain
-                // can handle aliased imports. Local .tgz file: refs ARE proper
-                // packaged libraries and DO stay in vendor; so do file:
-                // directory refs that point at packages with compiled JS
-                // entry points (a common NativeScript monorepo pattern that
-                // hoists installs and re-exposes them from the app's
-                // package.json via `file:../../node_modules/<name>`).
-                localSourceNames.add(name);
-                if (debug) {
-                    console.log(`[vendor] skipping local source dependency ${name} (spec: ${String(spec)})`);
-                }
-                continue;
-            }
-            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) || localSourceNames.has(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;
-}
-const COMPILED_JS_ENTRY_EXTENSIONS = ['.js', '.mjs', '.cjs'];
-const COMPILED_JS_ENTRY_REGEX = /\.(?:c|m)?jsx?$/;
-function compiledJsExtensionsForPlatform(platform) {
-    const exts = [...COMPILED_JS_ENTRY_EXTENSIONS];
-    switch (platform) {
-        case 'android':
-            exts.push('.android.js');
-            break;
-        case 'ios':
-            exts.push('.ios.js', '.visionos.js');
-            break;
-        case 'visionos':
-            exts.push('.visionos.js', '.ios.js');
-            break;
-    }
-    return exts;
-}
-/**
- * Determine whether a `package.json` dependency must be excluded from the
- * HMR vendor bundle because esbuild's standalone vendor pipeline can't
- * resolve its source.
- *
- * The HMR vendor bundle is generated by a standalone esbuild build that
- * has none of the Vite plugin chain (most notably
- * `ns-tsconfig-paths-resolver`), so any aliased import inside the
- * package's **source** files will fail with "Could not resolve" and abort
- * the whole bundle.
- *
- * Skip:
- *  - `link:` and `workspace:` refs (always app-side source).
- *  - `file:` refs to a directory whose installed package only ships
- *    TypeScript/JSX source (no compiled `.js`/`.mjs`/`.cjs` entry).
- *
- * Keep (return false):
- *  - Regular semver / git / url specs (normal third-party libraries).
- *  - Local `.tgz` file refs (pre-packaged libraries extracted at install).
- *  - `file:` directory refs that resolve to a package with a compiled JS
- *    entry — a common NativeScript monorepo convention where the app's
- *    `package.json` redirects to `../../node_modules/<name>` to avoid
- *    duplicate installs while letting the NativeScript CLI discover
- *    plugins from the app directory.
- */
-export function isUnvendorableLocalSource(name, spec, projectRequire, platform) {
-    if (typeof spec !== 'string')
-        return false;
-    if (spec.startsWith('link:') || spec.startsWith('workspace:'))
-        return true;
-    if (!spec.startsWith('file:'))
-        return false;
-    // Tarballs are already pre-packaged libraries — install extracts them
-    // into a normal node_modules entry.
-    if (/\.t(?:ar\.)?gz(?:[?#].*)?$/.test(spec))
-        return false;
-    // Directory file: refs need a deeper check: peek at the installed
-    // package.json and ask "does this ship compiled JS?". If yes, vendor
-    // it. If no (TS source only), defer to the regular Vite pipeline.
-    return !packageHasCompiledJsEntry(name, projectRequire, platform);
-}
-function packageHasCompiledJsEntry(name, projectRequire, platform) {
-    let pkgJsonPath;
-    try {
-        pkgJsonPath = projectRequire.resolve(`${name}/package.json`);
-    }
-    catch {
-        return false;
-    }
-    let pkg;
-    try {
-        pkg = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
-    }
-    catch {
-        return false;
-    }
-    const pkgDir = path.dirname(pkgJsonPath);
-    const candidates = [];
-    const pushCandidate = (value) => {
-        if (typeof value === 'string' && value)
-            candidates.push(value);
-    };
-    pushCandidate(pkg.module);
-    pushCandidate(pkg.main);
-    // Recursively flatten conditional `exports` maps to surface concrete
-    // file paths. We only need `string` leaves; anything else (function-
-    // based exports, etc.) doesn't apply to esbuild's resolution.
-    const visitExports = (node) => {
-        if (!node)
-            return;
-        if (typeof node === 'string') {
-            pushCandidate(node);
-            return;
-        }
-        if (Array.isArray(node)) {
-            for (const item of node)
-                visitExports(item);
-            return;
-        }
-        if (typeof node === 'object') {
-            for (const value of Object.values(node))
-                visitExports(value);
-        }
-    };
-    visitExports(pkg.exports);
-    if (candidates.length === 0) {
-        // node's default lookup falls back to `index.js`.
-        candidates.push('index');
-    }
-    const extensionsToTry = compiledJsExtensionsForPlatform(platform);
-    for (const cand of candidates) {
-        const abs = path.resolve(pkgDir, cand);
-        const ext = path.extname(cand);
-        if (COMPILED_JS_ENTRY_REGEX.test(cand)) {
-            // Explicit JS extension. If the file exists, vendor it. If not
-            // (a NativeScript plugin commonly declares `main: "index.js"`
-            // but ships only platform variants like `index.ios.js`), try
-            // the platform-specific variants which esbuild's
-            // `resolveExtensions` will pick up at bundle time.
-            if (fs.existsSync(abs))
-                return true;
-            const baseAbs = abs.slice(0, -ext.length);
-            for (const e of extensionsToTry) {
-                if (fs.existsSync(baseAbs + e))
-                    return true;
-            }
-            continue;
-        }
-        if (!ext) {
-            // Extensionless main — try plain JS variants AND the
-            // platform-specific variants NativeScript plugins commonly use
-            // (`index.ios.js`, `index.android.js`, `index.visionos.js`).
-            for (const e of extensionsToTry) {
-                if (fs.existsSync(abs + e))
-                    return true;
-            }
-            continue;
-        }
-        // A non-JS extension (typically `.ts`/`.tsx`) means the package
-        // only ships TS source — esbuild's vendor pipeline can't resolve
-        // any tsconfig-aliased imports inside it.
-    }
-    return false;
-}
-export const __test_collectVendorModules = collectVendorModules;
 export const __test_createVendorBundleRuntimeModule = createVendorBundleRuntimeModule;
-export const __test_isUnvendorableLocalSource = isUnvendorableLocalSource;
-export const __test_packageHasCompiledJsEntry = packageHasCompiledJsEntry;
-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);
-}
+export { collectVendorModules as __test_collectVendorModules, isUnvendorableLocalSource as __test_isUnvendorableLocalSource, packageHasCompiledJsEntry as __test_packageHasCompiledJsEntry } from './manifest-collect.js';
 function createVendorEntry(entries) {
     if (!entries.length) {
         return `export const __nsVendorModuleMap = {};
@@ -1033,405 +521,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) {
-                    console.log('[vendor] map', args.path, '->', PB_ANIMATIONS_ID);
-                }
-                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) {
-                    console.log('[vendor] map', args.path, '->', ANIMATIONS_BROWSER_ID);
-                }
-                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) {
-                    console.log('[vendor] map', args.path, '->', ANIMATIONS_ID);
-                }
-                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) {
-    // 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';
-            const { babel, createLinker } = await getAngularLinkerFactory(projectRoot);
-            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' };
-                    }
-                    if (debug) {
-                        console.log('[ns-angular-linker][vendor] linking', args.path);
-                    }
-                    const linked = await runAngularLinker(source, { filename: args.path, projectRoot, freshPlugin: true });
-                    return { contents: linked || source, loader: 'js' };
-                }
-                catch {
-                    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)(?:\.[^.\/]+)?)$/, '');
 }