Merge branch 'engine-removal-note' of github.com:Snapstromegon/eleventy into Snapstromegon-engine-removal-note

Author: zachleat

src/Engines/TemplateEngineManager.js

@@ -74,6 +74,10 @@ class TemplateEngineManager {
 		return !!this.getClassNameFromTemplateKey(name);
 	}
 
+	isEngineDeprecated(name) {
+		return ["ejs", "hbs", "mustache", "haml", "pug"].includes(name) && !this.hasEngine(name);
+	}
+
 	async getEngineClassByExtension(extension) {
 		// We include these as raw strings (and not more readable variables) so they’re parsed by a bundler.
 		if (extension === "md") {
@@ -99,6 +103,14 @@ class TemplateEngineManager {
 	}
 
 	async getEngine(name, extensionMap) {
+		// Warning about engine deprecation
+		// TODO: error message needs updating once issue is closed
+		if (this.isEngineDeprecated(name)) {
+			throw new Error(
+				`Per our community survey, the "${name}" template syntax was removed from core in 11ty v3.0. Read more https://github.com/11ty/eleventy/issues/3124 including our plans to expose these as official plugins (outside of core). You can implement these yourself using https://www.11ty.dev/docs/languages/custom/`,
+			);
+		}
+
 		if (!this.hasEngine(name)) {
 			throw new Error(`Template Engine ${name} does not exist in getEngine()`);
 		}