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

package/helpers/ns-core-external-urls.d.ts

@@ -0,0 +1,32 @@
+import type { Plugin } from 'vite';
+import type { Platform } from './platform-types.js';
+export interface NsCoreExternalUrlsPluginOptions {
+    platform: Platform;
+    projectRoot: string;
+    /** Resolved @nativescript/core root (workspace source or node_modules install). */
+    nsCoreRoot: string;
+    hmrPort: number;
+    useHttps: boolean;
+}
+/**
+ * HMR builds only: rewrite every bare `@nativescript/core*` specifier to the
+ * full /ns/core HTTP URL so bundle.mjs contains NO bundled copy of the core
+ * runtime. The plugin runs with enforce:'pre' so it fires BEFORE Vite's alias
+ * resolution converts bare specifiers to absolute filesystem paths, and
+ * apply:'build' so the dev-server transform pipeline (which has its own
+ * import-map) is unaffected.
+ *
+ * Why this is necessary: core's transitively-bundled helpers (e.g.
+ * `@nativescript/zone-js` patches) write `import '@nativescript/core/globals'`
+ * in their source. Without this interception, rolldown leaves those as bare
+ * specifiers in the emitted bundle.mjs output, iOS's ESM loader can't resolve
+ * bare specifiers at module-instantiation time (the runtime import map is
+ * installed later by the HMR client), and it falls back to a filesystem
+ * lookup that crashes with
+ * "Module not found: Cannot find module @nativescript/core/globals".
+ *
+ * The broader architecture: Vite is the single source of truth for every
+ * `@nativescript/core` URL on the device, so this build-time pre-resolver
+ * routes every reference into the runtime bridge.
+ */
+export declare function nsCoreExternalUrlsPlugin(opts: NsCoreExternalUrlsPluginOptions): Plugin;

package/helpers/ns-core-external-urls.js

@@ -0,0 +1,107 @@
+import { buildCoreUrl, corePathToSub, specToCoreSub } from './ns-core-url.js';
+import { resolveDeviceReachableOrigin } from './dev-host.js';
+import { getMonorepoWorkspaceRoot } from './project.js';
+import { normalizeModuleId } from './normalize-id.js';
+/**
+ * HMR builds only: rewrite every bare `@nativescript/core*` specifier to the
+ * full /ns/core HTTP URL so bundle.mjs contains NO bundled copy of the core
+ * runtime. The plugin runs with enforce:'pre' so it fires BEFORE Vite's alias
+ * resolution converts bare specifiers to absolute filesystem paths, and
+ * apply:'build' so the dev-server transform pipeline (which has its own
+ * import-map) is unaffected.
+ *
+ * Why this is necessary: core's transitively-bundled helpers (e.g.
+ * `@nativescript/zone-js` patches) write `import '@nativescript/core/globals'`
+ * in their source. Without this interception, rolldown leaves those as bare
+ * specifiers in the emitted bundle.mjs output, iOS's ESM loader can't resolve
+ * bare specifiers at module-instantiation time (the runtime import map is
+ * installed later by the HMR client), and it falls back to a filesystem
+ * lookup that crashes with
+ * "Module not found: Cannot find module @nativescript/core/globals".
+ *
+ * The broader architecture: Vite is the single source of truth for every
+ * `@nativescript/core` URL on the device, so this build-time pre-resolver
+ * routes every reference into the runtime bridge.
+ */
+export function nsCoreExternalUrlsPlugin(opts) {
+    const { platform, projectRoot, nsCoreRoot, hmrPort, useHttps } = opts;
+    // Routes through `resolveDeviceReachableOrigin` so the origin baked into
+    // externalized `@nativescript/core*` URLs is something the DEVICE can
+    // reach. Wildcard binds (`0.0.0.0`) and Android loopback get remapped to
+    // a real LAN IP (preferred) or `10.0.2.2` (Android emulator). Same helper
+    // used by `main-entry.ts` so both code paths produce byte-identical URL
+    // strings — required by the iOS HTTP ESM cache identity rule.
+    //
+    // Protocol baked into externalized @nativescript/core URLs must match the
+    // dev server's protocol. `NS_HTTPS` is the single switch (it also drives
+    // the server TLS + `wss` HMR socket); `NS_HMR_PROTO` remains an explicit
+    // override when set.
+    const proto = (process.env.NS_HMR_PROTO ? process.env.NS_HMR_PROTO === 'https' : useHttps) ? 'https' : 'http';
+    const { origin } = resolveDeviceReachableOrigin({
+        host: process.env.NS_HMR_HOST,
+        platform,
+        protocol: proto,
+        port: hmrPort,
+    });
+    return {
+        name: 'ns-core-external-urls',
+        enforce: 'pre',
+        apply: 'build',
+        async resolveId(source, importer) {
+            // Route every `@nativescript/core*` reference (bare specifier OR
+            // absolute path into the installed @nativescript/core package OR
+            // its subpath import-map aliases) through the ONE canonical URL
+            // generator. URL proliferation (`?p=`, versioned, mixed query vs
+            // path forms) produces distinct iOS HTTP ESM cache entries for
+            // the same module, yielding double evaluation.
+            const sub = specToCoreSub(source);
+            if (sub !== null) {
+                if (process.env.NS_CORE_EXTERNAL_DEBUG) {
+                    console.log('[ns-core-external]', 'source=', source, 'sub=', sub, 'importer=', importer?.slice(-80));
+                }
+                const url = buildCoreUrl(origin, sub);
+                return { id: url, external: 'absolute' };
+            }
+            // Monorepo-source core (`<workspace>/packages/core` via a file:
+            // dependency). The resolve-alias step runs BEFORE this hook and
+            // rewrites bare `@nativescript/core[/sub]` specifiers to absolute
+            // paths under NS_CORE_ROOT; for a node_modules install those
+            // still match specToCoreSub above, but workspace-source paths do
+            // not — without this branch the entire core library is silently
+            // inlined into bundle.mjs as a dead second realm
+            // (`Frame.topmost()` undefined on tap while the served realm owns
+            // the live UI).
+            //
+            // These must NOT map to `/ns/core/<sub>`: in the monorepo, the
+            // served core graph's internal imports resolve to
+            // workspace-relative `/ns/m/packages/core/<file>` URLs (Vite
+            // emits `/@fs/`-style ids for files outside the app root; see
+            // rewriteFsAbsoluteToNsM). A `/ns/core/<sub>` URL would serve a
+            // SECOND body for the same file in the same realm — its
+            // side-effect registrations re-run against shared classes and
+            // crash (`Cannot redefine property: default:width` from
+            // CssAnimationProperty.register). Resolve to the concrete file
+            // and emit the same `/ns/m/<workspace-rel>` spelling the served
+            // graph uses so the bundle joins the live realm.
+            if (corePathToSub(source, nsCoreRoot) === null)
+                return null;
+            const wsRoot = getMonorepoWorkspaceRoot(projectRoot);
+            const wsRootNorm = wsRoot ? normalizeModuleId(wsRoot).replace(/\/+$/, '') : '';
+            const resolved = await this.resolve(source, importer, { skipSelf: true });
+            const fileAbs = normalizeModuleId(((resolved && resolved.id) || source).split('?')[0]);
+            if (process.env.NS_CORE_EXTERNAL_DEBUG) {
+                console.log('[ns-core-external:workspace]', 'source=', source, 'file=', fileAbs, 'importer=', importer?.slice(-80));
+            }
+            if (wsRootNorm && fileAbs.startsWith(wsRootNorm + '/')) {
+                return { id: `${origin}/ns/m/${fileAbs.slice(wsRootNorm.length + 1)}`, external: 'absolute' };
+            }
+            // Could not anchor the resolved file under the workspace root —
+            // fall back to the canonical bridge URL rather than inlining a
+            // core copy.
+            const fallbackSub = corePathToSub(fileAbs, nsCoreRoot) ?? corePathToSub(source, nsCoreRoot);
+            console.warn('[ns-core-external] workspace-core path could not be anchored under the workspace root; using /ns/core bridge URL for', source);
+            return { id: buildCoreUrl(origin, fallbackSub), external: 'absolute' };
+        },
+    };
+}
+//# sourceMappingURL=ns-core-external-urls.js.map

package/helpers/ns-core-external-urls.js.map

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

package/helpers/ns-core-url.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Single canonical URL generator for `@nativescript/core` under HMR.
+ *
+ * Every public-facing reference to `@nativescript/core[/sub]` resolves to
+ * exactly one URL string — byte-for-byte identical across every emitter
+ * (bundle entry, external-urls plugin, rewriter, import map, runtime
+ * require). The only valid shapes are:
+ *
+ *   - `/ns/core`               — package main
+ *   - `/ns/core/<sub>`         — subpath form
+ *
+ * with `<sub>` always run through `normalizeCoreSub` (extensionless, no
+ * `/index` tail, no platform suffix). There is no version segment, no
+ * `?p=` query form, no `.js` tail.
+ *
+ * This module is the ONE site that constructs those URLs. Every caller in
+ * the repo should use `buildCoreUrl()` (or `buildCoreUrlPath()` when origin
+ * is not known yet). A single violation of canonical form produces a
+ * distinct iOS HTTP ESM cache entry for the same file — re-evaluating the
+ * module body, re-running `CssAnimationProperty.register(...)` side
+ * effects, and crashing with `Cannot redefine property`.
+ */
+/**
+ * Normalize a user-provided subpath into the canonical form used by the
+ * /ns/core bridge. Strips:
+ *   - Query and hash (`?v=…`, `#…`)
+ *   - Leading / trailing slashes
+ *   - Trailing `.js`/`.mjs`/`.cjs` extension (platform-suffixed forms are
+ *     preserved: `.ios.js` → `.ios`)
+ *   - Trailing `/index` segment (package-main sibling: `globals/index` →
+ *     `globals`; `ui/core/view/index` → `ui/core/view`)
+ *   - Canonical index forms (`index`, `index.js`, empty) → empty string
+ *
+ * Returns empty string for the main module (`@nativescript/core` itself).
+ */
+export declare function normalizeCoreSub(sub?: string | null): string;
+/**
+ * Canonical PATH (no origin) for a core module.
+ * Used by middleware/redirects where we don't have the dev-server origin.
+ *
+ *   ''                → '/ns/core'
+ *   'application'     → '/ns/core/application'
+ *   'ui/core/view'    → '/ns/core/ui/core/view'
+ *   'globals/index'   → '/ns/core/globals'
+ */
+export declare function buildCoreUrlPath(sub?: string | null): string;
+/**
+ * Canonical FULL URL for a core module.
+ *
+ *   origin='http://localhost:5173', sub='application'
+ *     → 'http://localhost:5173/ns/core/application'
+ *
+ * Throws if origin is empty — callers that may not have origin should use
+ * `buildCoreUrlPath()` instead.
+ */
+export declare function buildCoreUrl(origin: string, sub?: string | null): string;
+/**
+ * Detect whether a URL or path references the /ns/core bridge.
+ * Accepts both relative `/ns/core/...` and absolute `http(s)://.../ns/core/...`.
+ */
+export declare function isCoreBridgeUrl(input: string): boolean;
+/**
+ * Extract the canonical sub path from a /ns/core URL.
+ *   'http://localhost:5173/ns/core'             → ''
+ *   'http://localhost:5173/ns/core/application' → 'application'
+ *   '/ns/core/ui/core/view'                     → 'ui/core/view'
+ *   'http://example.com/other'                  → null
+ */
+export declare function extractCoreSub(input: string): string | null;
+/**
+ * Convert a bare `@nativescript/core[/sub]` specifier or an absolute path
+ * pointing into `@nativescript/core`'s node_modules install into the
+ * canonical sub path. Returns null for anything else.
+ *
+ *   '@nativescript/core'                                 → ''
+ *   '@nativescript/core/application'                     → 'application'
+ *   '/node_modules/@nativescript/core/ui/core/view.js'   → 'ui/core/view'
+ *   '/foo/bar/baz'                                       → null
+ */
+export declare function specToCoreSub(spec: string): string | null;
+/**
+ * Convert an absolute path INSIDE a known @nativescript/core root directory
+ * into the canonical sub path. Complements {@link specToCoreSub}, which only
+ * recognizes bare specifiers and `node_modules` installs: in a monorepo where
+ * core is consumed from source (`<workspace>/packages/core` via a `file:`
+ * dependency), the resolve-alias step rewrites bare `@nativescript/core[/sub]`
+ * specifiers to absolute paths under that source root BEFORE the
+ * `ns-core-external-urls` build plugin sees them. Without this mapping those
+ * paths escape externalization and the entire core library is inlined into
+ * bundle.mjs — a dead second realm whose `Frame.topmost()` is undefined while
+ * the dev-server-served realm owns the live UI.
+ *
+ *   corePathToSub('/ws/packages/core', '/ws/packages/core')                 → ''
+ *   corePathToSub('/ws/packages/core/ui/frame', '/ws/packages/core')        → 'ui/frame'
+ *   corePathToSub('/ws/packages/core/ui/frame/index.ios.ts', same root)     → 'ui/frame'
+ *   corePathToSub('/elsewhere/file.ts', '/ws/packages/core')                → null
+ */
+export declare function corePathToSub(spec: string, coreRoot: string | null | undefined): string | null;
+/**
+ * Produce the set of "runtime module id" strings we expose in
+ * `globalThis.__NS_CORE_MODULES__` for a given sub. Callers of the vendor
+ * CJS shim may request any of these forms for the same module; we register
+ * all of them to the one namespace so lookups are never ambiguous.
+ */
+export declare function moduleRegistrationKeys(sub?: string | null): string[];
+export declare const CORE_SCOPE = "@nativescript/core";

package/helpers/ns-core-url.js

@@ -0,0 +1,225 @@
+/**
+ * Single canonical URL generator for `@nativescript/core` under HMR.
+ *
+ * Every public-facing reference to `@nativescript/core[/sub]` resolves to
+ * exactly one URL string — byte-for-byte identical across every emitter
+ * (bundle entry, external-urls plugin, rewriter, import map, runtime
+ * require). The only valid shapes are:
+ *
+ *   - `/ns/core`               — package main
+ *   - `/ns/core/<sub>`         — subpath form
+ *
+ * with `<sub>` always run through `normalizeCoreSub` (extensionless, no
+ * `/index` tail, no platform suffix). There is no version segment, no
+ * `?p=` query form, no `.js` tail.
+ *
+ * This module is the ONE site that constructs those URLs. Every caller in
+ * the repo should use `buildCoreUrl()` (or `buildCoreUrlPath()` when origin
+ * is not known yet). A single violation of canonical form produces a
+ * distinct iOS HTTP ESM cache entry for the same file — re-evaluating the
+ * module body, re-running `CssAnimationProperty.register(...)` side
+ * effects, and crashing with `Cannot redefine property`.
+ */
+const CORE_SCOPE_PREFIX = '@nativescript/core';
+/**
+ * Normalize a user-provided subpath into the canonical form used by the
+ * /ns/core bridge. Strips:
+ *   - Query and hash (`?v=…`, `#…`)
+ *   - Leading / trailing slashes
+ *   - Trailing `.js`/`.mjs`/`.cjs` extension (platform-suffixed forms are
+ *     preserved: `.ios.js` → `.ios`)
+ *   - Trailing `/index` segment (package-main sibling: `globals/index` →
+ *     `globals`; `ui/core/view/index` → `ui/core/view`)
+ *   - Canonical index forms (`index`, `index.js`, empty) → empty string
+ *
+ * Returns empty string for the main module (`@nativescript/core` itself).
+ */
+export function normalizeCoreSub(sub) {
+    if (!sub)
+        return '';
+    let s = String(sub).split('?')[0].split('#')[0].trim();
+    s = s.replace(/^\/+/, '').replace(/\/+$/, '');
+    s = s.replace(/\.(?:mjs|cjs|js)$/, '');
+    // Strip a trailing platform suffix (`.ios` / `.android` / `.visionos`)
+    // so Vite-resolved platform-specific file paths canonicalize to the
+    // same form the runtime import map uses for the bare subpath.
+    //
+    // Why this matters: when the app source has
+    // `import { TextBase } from '@nativescript/core/ui/text-base'`, Vite's
+    // alias + extension resolver picks `ui/text-base/index.ios.js`. After
+    // `.js` is stripped above we have `ui/text-base/index.ios`. Vendor
+    // code, by contrast, takes the bare specifier path: the runtime
+    // import map's `@nativescript/core/` prefix maps it to
+    // `/ns/core/ui/text-base` directly (no `.ios`). The iOS HTTP ESM
+    // loader caches by URL string, so two spellings of the same file
+    // would produce two distinct V8 module records, re-evaluate
+    // `TextBase`, and create a realm split that leaves the
+    // `@nativescript-community` plugin's `setTextDecorationAndTransform`
+    // override visible to vendor code but invisible to the app.
+    //
+    // Stripping the suffix here normalises both shapes — `ui/text-base/`
+    // `index.ios` and `runtime/runtime.ios` — to the bare form. The
+    // trailing `/index` handler below then collapses
+    // `ui/text-base/index` → `ui/text-base`, and the final `index`
+    // guard collapses the package-main case to ''.
+    s = s.replace(/\.(?:ios|android|visionos)$/, '');
+    // Strip trailing `/index` so that `globals/index` → `globals`, matching
+    // the bare import form that consumers spell as `@nativescript/core/globals`.
+    // The main module case (`index` alone) is handled below.
+    if (s.endsWith('/index')) {
+        s = s.slice(0, -'/index'.length);
+    }
+    if (!s || s === 'index')
+        return '';
+    return s;
+}
+/**
+ * Canonical PATH (no origin) for a core module.
+ * Used by middleware/redirects where we don't have the dev-server origin.
+ *
+ *   ''                → '/ns/core'
+ *   'application'     → '/ns/core/application'
+ *   'ui/core/view'    → '/ns/core/ui/core/view'
+ *   'globals/index'   → '/ns/core/globals'
+ */
+export function buildCoreUrlPath(sub) {
+    const s = normalizeCoreSub(sub);
+    return s ? `/ns/core/${s}` : '/ns/core';
+}
+/**
+ * Canonical FULL URL for a core module.
+ *
+ *   origin='http://localhost:5173', sub='application'
+ *     → 'http://localhost:5173/ns/core/application'
+ *
+ * Throws if origin is empty — callers that may not have origin should use
+ * `buildCoreUrlPath()` instead.
+ */
+export function buildCoreUrl(origin, sub) {
+    if (!origin) {
+        throw new Error('[ns-core-url] buildCoreUrl requires a non-empty origin. Use buildCoreUrlPath() when origin is not yet known.');
+    }
+    const trimmedOrigin = origin.replace(/\/+$/, '');
+    return `${trimmedOrigin}${buildCoreUrlPath(sub)}`;
+}
+/**
+ * Detect whether a URL or path references the /ns/core bridge.
+ * Accepts both relative `/ns/core/...` and absolute `http(s)://.../ns/core/...`.
+ */
+export function isCoreBridgeUrl(input) {
+    if (!input)
+        return false;
+    return /\/ns\/core(?:\/|$)/.test(input);
+}
+/**
+ * Extract the canonical sub path from a /ns/core URL.
+ *   'http://localhost:5173/ns/core'             → ''
+ *   'http://localhost:5173/ns/core/application' → 'application'
+ *   '/ns/core/ui/core/view'                     → 'ui/core/view'
+ *   'http://example.com/other'                  → null
+ */
+export function extractCoreSub(input) {
+    if (!isCoreBridgeUrl(input))
+        return null;
+    try {
+        const u = new URL(input, 'http://placeholder.invalid');
+        const pathname = u.pathname;
+        const afterCore = pathname.replace(/^.*\/ns\/core(?:\/|$)/, '');
+        return normalizeCoreSub(afterCore);
+    }
+    catch {
+        const m = input.match(/\/ns\/core(?:\/([^?#]*))?/);
+        if (!m)
+            return null;
+        return normalizeCoreSub(m[1] || '');
+    }
+}
+/**
+ * Convert a bare `@nativescript/core[/sub]` specifier or an absolute path
+ * pointing into `@nativescript/core`'s node_modules install into the
+ * canonical sub path. Returns null for anything else.
+ *
+ *   '@nativescript/core'                                 → ''
+ *   '@nativescript/core/application'                     → 'application'
+ *   '/node_modules/@nativescript/core/ui/core/view.js'   → 'ui/core/view'
+ *   '/foo/bar/baz'                                       → null
+ */
+export function specToCoreSub(spec) {
+    if (!spec)
+        return null;
+    const cleaned = spec.split('?')[0].split('#')[0];
+    if (cleaned === CORE_SCOPE_PREFIX)
+        return '';
+    if (cleaned.startsWith(CORE_SCOPE_PREFIX + '/')) {
+        return normalizeCoreSub(cleaned.slice(CORE_SCOPE_PREFIX.length + 1));
+    }
+    const abs = cleaned.replace(/\\/g, '/').match(/\/node_modules\/@nativescript\/core\/(.+?)$/);
+    if (abs)
+        return normalizeCoreSub(abs[1]);
+    // Case: the path ENDS at the core root (no subpath).
+    if (/\/node_modules\/@nativescript\/core\/?$/.test(cleaned.replace(/\\/g, '/'))) {
+        return '';
+    }
+    return null;
+}
+/**
+ * Convert an absolute path INSIDE a known @nativescript/core root directory
+ * into the canonical sub path. Complements {@link specToCoreSub}, which only
+ * recognizes bare specifiers and `node_modules` installs: in a monorepo where
+ * core is consumed from source (`<workspace>/packages/core` via a `file:`
+ * dependency), the resolve-alias step rewrites bare `@nativescript/core[/sub]`
+ * specifiers to absolute paths under that source root BEFORE the
+ * `ns-core-external-urls` build plugin sees them. Without this mapping those
+ * paths escape externalization and the entire core library is inlined into
+ * bundle.mjs — a dead second realm whose `Frame.topmost()` is undefined while
+ * the dev-server-served realm owns the live UI.
+ *
+ *   corePathToSub('/ws/packages/core', '/ws/packages/core')                 → ''
+ *   corePathToSub('/ws/packages/core/ui/frame', '/ws/packages/core')        → 'ui/frame'
+ *   corePathToSub('/ws/packages/core/ui/frame/index.ios.ts', same root)     → 'ui/frame'
+ *   corePathToSub('/elsewhere/file.ts', '/ws/packages/core')                → null
+ */
+export function corePathToSub(spec, coreRoot) {
+    if (!spec || !coreRoot)
+        return null;
+    const cleaned = spec.split('?')[0].split('#')[0].replace(/\\/g, '/');
+    const root = String(coreRoot).replace(/\\/g, '/').replace(/\/+$/, '');
+    if (!root)
+        return null;
+    if (cleaned === root)
+        return '';
+    if (!cleaned.startsWith(root + '/'))
+        return null;
+    // Monorepo core is TypeScript source; strip TS extensions before the
+    // canonical normalizer (which handles .js/.mjs/.cjs, platform suffixes
+    // and trailing /index).
+    const rel = cleaned.slice(root.length + 1).replace(/\.(?:ts|tsx|mts|cts)$/, '');
+    return normalizeCoreSub(rel);
+}
+/**
+ * Produce the set of "runtime module id" strings we expose in
+ * `globalThis.__NS_CORE_MODULES__` for a given sub. Callers of the vendor
+ * CJS shim may request any of these forms for the same module; we register
+ * all of them to the one namespace so lookups are never ambiguous.
+ */
+export function moduleRegistrationKeys(sub) {
+    const s = normalizeCoreSub(sub);
+    const keys = new Set();
+    if (!s) {
+        keys.add(CORE_SCOPE_PREFIX);
+        keys.add('');
+    }
+    else {
+        keys.add(`${CORE_SCOPE_PREFIX}/${s}`);
+        keys.add(s);
+        // Tolerate `.js` tail on the key (some consumers spell it out).
+        keys.add(`${CORE_SCOPE_PREFIX}/${s}.js`);
+        keys.add(`${s}.js`);
+        // Tolerate `/index` / `/index.js` suffix.
+        keys.add(`${CORE_SCOPE_PREFIX}/${s}/index`);
+        keys.add(`${CORE_SCOPE_PREFIX}/${s}/index.js`);
+    }
+    return Array.from(keys);
+}
+export const CORE_SCOPE = CORE_SCOPE_PREFIX;
+//# sourceMappingURL=ns-core-url.js.map

package/helpers/ns-core-url.js.map

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

package/helpers/optimize-deps.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Canonical list of packages that must NEVER be pre-bundled by Vite's
+ * dependency scanner.
+ *
+ * The most load-bearing entries are `module` / `node:module`: they are aliased
+ * to local polyfills/shims (see `helpers/css-tree.ts` and the `node:module`
+ * alias in `configuration/base.ts`). Vite's depscanner has no awareness of those
+ * aliases and, if allowed to pre-bundle them, the HMR `/ns/m/` pipeline can't map
+ * the pre-bundle URL back to a real package — dropping the
+ * `import { createRequire } from 'module'` line and crashing on device with
+ * `ReferenceError: createRequire is not defined` inside `css-tree`.
+ *
+ * Centralized here so base/angular configs share one source of truth instead of
+ * hand-maintaining divergent copies.
+ */
+export declare const NS_OPTIMIZE_DEPS_EXCLUDE: readonly ["@nativescript/core", "@valor/nativescript-websockets", "set-value", "react", "react-reconciler", "react-nativescript", "module", "node:module"];

package/helpers/optimize-deps.js

@@ -0,0 +1,17 @@
+/**
+ * Canonical list of packages that must NEVER be pre-bundled by Vite's
+ * dependency scanner.
+ *
+ * The most load-bearing entries are `module` / `node:module`: they are aliased
+ * to local polyfills/shims (see `helpers/css-tree.ts` and the `node:module`
+ * alias in `configuration/base.ts`). Vite's depscanner has no awareness of those
+ * aliases and, if allowed to pre-bundle them, the HMR `/ns/m/` pipeline can't map
+ * the pre-bundle URL back to a real package — dropping the
+ * `import { createRequire } from 'module'` line and crashing on device with
+ * `ReferenceError: createRequire is not defined` inside `css-tree`.
+ *
+ * Centralized here so base/angular configs share one source of truth instead of
+ * hand-maintaining divergent copies.
+ */
+export const NS_OPTIMIZE_DEPS_EXCLUDE = ['@nativescript/core', '@valor/nativescript-websockets', 'set-value', 'react', 'react-reconciler', 'react-nativescript', 'module', 'node:module'];
+//# sourceMappingURL=optimize-deps.js.map

package/helpers/optimize-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize-deps.js","sourceRoot":"","sources":["../../../../packages/vite/helpers/optimize-deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,oBAAoB,EAAE,gCAAgC,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,aAAa,CAAU,CAAC"}

package/helpers/package-platform-aliases.js

@@ -2,10 +2,19 @@ import path from 'path';
 import fs from 'fs';
 import { findPackageInNodeModules } from './module-resolution.js';
 import { getProjectRootPath } from './project.js';
+import { resolveMainFieldPlatformVariant } from './resolve-main-field-platform.js';
 const projectRoot = getProjectRootPath();
 export function packagePlatformResolverPlugin(opts) {
     // packages used via core transient dependencies and other vite support
     const commonSkips = ['source-map-js', 'html-entities', 'fast-xml-parser', '@valor/nativescript-websockets'];
+    // Memoize the resolved id (or null) per bare package name. This runs on the
+    // hot `enforce:'pre'` path for EVERY bare specifier; without a cache it does
+    // a full `findPackageInNodeModules` fs-walk + `package.json` read/parse on
+    // every resolve. The platform is fixed for this plugin instance (a fresh
+    // instance is created per worker build via the `worker.plugins` factory), so
+    // the package name is a sufficient key. Mirrors the cache in
+    // `nativescript-package-resolver.ts`.
+    const resolveCache = new Map();
     return {
         name: 'ns-package-platform-resolver',
         enforce: 'pre',
@@ -24,58 +33,34 @@ export function packagePlatformResolverPlugin(opts) {
             }
             // Only handle packages that exist in node_modules (real npm packages)
             const packageName = id;
-            const packagePath = findPackageInNodeModules(packageName, projectRoot);
-            if (packagePath) {
+            if (resolveCache.has(packageName)) {
+                return resolveCache.get(packageName);
+            }
+            // Compute once, then memoize (incl. the null "no rewrite" result so a
+            // known package short-circuits on the next resolve).
+            const resolved = (() => {
+                const packagePath = findPackageInNodeModules(packageName, projectRoot);
+                if (!packagePath)
+                    return null;
                 const packageJsonPath = path.join(packagePath, 'package.json');
-                if (fs.existsSync(packageJsonPath)) {
-                    try {
-                        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
-                        const mainField = packageJson.main;
-                        if (mainField) {
-                            const mainFilePath = path.join(packagePath, mainField);
-                            // Case 1: Main field has no extension - try to add extensions
-                            if (!mainField.includes('.')) {
-                                // Try platform-specific file first
-                                const platformFile = path.join(packagePath, `${mainField}.${opts.platform}.js`);
-                                if (fs.existsSync(platformFile)) {
-                                    if (opts.verbose) {
-                                        console.log(`✅ Alias resolver: ${packageName} -> ${mainField}.${opts.platform}.js (extensionless)`);
-                                    }
-                                    return platformFile;
-                                }
-                                // Fallback to .js
-                                const jsFile = path.join(packagePath, `${mainField}.js`);
-                                if (fs.existsSync(jsFile)) {
-                                    if (opts.verbose) {
-                                        console.log(`✅ Alias resolver: ${packageName} -> ${mainField}.js (extensionless)`);
-                                    }
-                                    return jsFile;
-                                }
-                            }
-                            // Case 2: Main field has extension but file doesn't exist - look for platform variants
-                            else if (!fs.existsSync(mainFilePath)) {
-                                // Extract base name and extension
-                                const ext = path.extname(mainField);
-                                const baseName = mainField.slice(0, -ext.length);
-                                // Try platform-specific file first
-                                const platformFile = path.join(packagePath, `${baseName}.${opts.platform}${ext}`);
-                                if (fs.existsSync(platformFile)) {
-                                    if (opts.verbose) {
-                                        console.log(`✅ Alias resolver: ${packageName} -> ${baseName}.${opts.platform}${ext} (missing main)`);
-                                    }
-                                    return platformFile;
-                                }
-                                // If main file exists, let normal resolution handle it
-                                // If it doesn't exist and no platform variant found, let it fail naturally
-                            }
-                        }
-                    }
-                    catch (e) {
-                        // Ignore parse errors and fall through
+                if (!fs.existsSync(packageJsonPath))
+                    return null;
+                try {
+                    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+                    // Shared main-field platform-variant rules (Case 1/2).
+                    const out = resolveMainFieldPlatformVariant(packagePath, packageJson.main, opts.platform);
+                    if (out && opts.verbose) {
+                        console.log(`✅ Alias resolver: ${packageName} -> ${out}`);
                     }
+                    return out;
                 }
-            }
-            return null;
+                catch {
+                    // Ignore parse errors and fall through.
+                    return null;
+                }
+            })();
+            resolveCache.set(packageName, resolved);
+            return resolved;
         },
     };
 }