Function replaceVueImport

packages/vite/hmr/server/websocket.ts:1908–2058

(_match: string, prefix: string, spec: string, suffix: string)

	// Replacement function for all imports
	const replaceVueImport = (_match: string, prefix: string, spec: string, suffix: string): string => {
		// Safety check
		if (!spec || typeof spec !== 'string') {
			return `${prefix}${spec}${suffix}`;
		}

		// Guard 0: leave fully-qualified HTTP(S) URLs alone
		if (/^https?:\/\//.test(spec)) {
			return `${prefix}${spec}${suffix}`;
		}

		// Guard: anomalous bare '@' spec should be rewritten to a safe stub module.
		// This can surface from upstream alias mishaps; mapping it here avoids device-side
		// "instantiate failed @" errors.
		if (spec === '@') {
			const stub = `/ns/m/__invalid_at__.mjs`;
			if (verbose) {
				try {
					console.warn(`[rewrite] mapped bare '@' spec to stub: ${stub}`);
				} catch {}
			}
			return `${prefix}${stub}${suffix}`;
		}

		spec = normalizeNativeScriptCoreSpecifier(spec);

		// Route internal NS endpoints to absolute HTTP origin for device
		if (spec.startsWith('/ns/')) {
			if (httpOriginSafe) {
				return `${prefix}${httpOriginSafe}${spec}${suffix}`;
			}
			return `${prefix}${spec}${suffix}`;
		}

		if (isNativeScriptCoreModule(spec)) {
			return `${prefix}${spec}${suffix}`;
		}

		const nodeModulesSpecifier = normalizeNodeModulesSpecifier(spec);
		const candidateNativeScriptSpec = nodeModulesSpecifier ?? spec;

		const vendorCanonical = resolveVendorFromCandidate(nodeModulesSpecifier ?? spec);

		if (vendorCanonical) {
			if (nodeModulesSpecifier) {
				return `${prefix}${nodeModulesSpecifier.replace(PAT.QUERY_PATTERN, '')}${suffix}`;
			}
			return `${prefix}${spec.replace(PAT.QUERY_PATTERN, '')}${suffix}`;
		}

		if (isNativeScriptPluginModule(candidateNativeScriptSpec)) {
			const bareSpecifier = candidateNativeScriptSpec.replace(PAT.QUERY_PATTERN, '');
			return `${prefix}${bareSpecifier}${suffix}`;
		}

		if (nodeModulesSpecifier) {
			return `${prefix}${nodeModulesSpecifier}${suffix}`;
		}