Function normalizeSpec

packages/vite/hmr/client/utils.ts:295–331

(raw: string)

// Normalize import specifiers for HTTP-only ESM runtime
export function normalizeSpec(raw: string): string {
	if (typeof raw !== 'string') return raw as any;
	let spec = raw.trim();
	try {
		// Expand HTTP origin placeholder emitted by server rewrites
		if (spec.startsWith('/__NS_HTTP_ORIGIN__')) {
			const origin = httpOriginForVite || deriveHttpOrigin(hmrWsUrl);
			if (origin) return origin + spec.slice('__NS_HTTP_ORIGIN__'.length);
		}
		// If server emitted path-style endpoints inside modules, prefix with origin here
		if (spec.startsWith('/ns/m') || spec.startsWith('/ns/sfc')) {
			const origin = httpOriginForVite || deriveHttpOrigin(hmrWsUrl);
			if (origin) return origin + spec;
		}
	} catch {}
	// Strip query/hash (cache busters like ?t=, ?v= etc.)
	const before = spec;
	spec = spec.replace(/[?#].*$/, '');
	if (spec !== before) {
		try {
			hmrMetrics.specQueryStripped = (hmrMetrics.specQueryStripped || 0) + 1;
		} catch {}
	}
	if (spec.startsWith('@/')) {
		// Generic alias '@/' -> project root relative; avoid assuming '/src/' structure
		spec = '/' + spec.slice(2);
	}
	if (spec === '@') {
		// Map anomalous '@' sentinel to a safe stub module path.
		if (__NS_ENV_VERBOSE__) console.warn('[hmr-normalize] mapping anomalous "@" to stub module');
		try {
			hmrMetrics.invalidAtSpec = (hmrMetrics.invalidAtSpec || 0) + 1;
		} catch {}
		return '/__invalid_at__.mjs';
	}
	return spec;
}

export function attachDiagnosticsToFrame(frame: any) {
	if (!__NS_ENV_VERBOSE__ || !frame) return;