@lwc/ssr-compiler 8.1.3 → 8.3.0

package/dist/index.js

@@ -7,6 +7,7 @@ import { parseModule } from 'meriyah';
 import { AriaPropNameToAttrNameMap, reservedKeywords, normalizeStyleAttribute, isVoidElement, HTML_NAMESPACE, StringReplace, StringTrim } from '@lwc/shared';
 import { parse } from 'acorn';
 import { produce } from 'immer';
+import { basename } from 'node:path';
 import { generateScopeTokens, toPropertyName, kebabcaseToCamelcase, parse as parse$1 } from '@lwc/template-compiler';
 import { builders as builders$1 } from 'estree-toolkit/dist/builders';
 import { inspect } from 'util';
@@ -70,19 +71,29 @@ function catalogTmplImport(path, state) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
+/** Placeholder value to use to opt out of validation. */
+const NO_VALIDATION = false;
 const PLACEHOLDER_PREFIX = `__ESTEMPLATE_${Math.random().toString().slice(2)}_PLACEHOLDER__`;
+const getReplacementNode = (state, placeholderId, nodeType) => {
+    const key = Number(placeholderId.slice(PLACEHOLDER_PREFIX.length));
+    const nodeCount = state.replacementNodes.length;
+    if (key >= nodeCount) {
+        throw new Error(`Cannot use index ${key} when only ${nodeCount} values have been provided.`);
+    }
+    const validateReplacement = state.placeholderToValidator.get(key);
+    const replacementNode = state.replacementNodes[key];
+    if (validateReplacement &&
+        !(Array.isArray(replacementNode)
+            ? replacementNode.every(validateReplacement)
+            : validateReplacement(replacementNode))) {
+        throw new Error(`Validation failed for templated node of type ${nodeType}`);
+    }
+    return replacementNode;
+};
 const visitors$1 = {
     Identifier(path, state) {
         if (path.node?.name.startsWith(PLACEHOLDER_PREFIX)) {
-            const key = path.node.name.slice(PLACEHOLDER_PREFIX.length);
-            const validateReplacement = state.placeholderToValidator.get(key);
-            const replacementNode = state.replacementNodes[key];
-            if (validateReplacement &&
-                !(Array.isArray(replacementNode)
-                    ? replacementNode.every(validateReplacement)
-                    : validateReplacement(replacementNode))) {
-                throw new Error(`Validation failed for templated node of type ${path.node.type}`);
-            }
+            const replacementNode = getReplacementNode(state, path.node.name, path.node.type);
             if (replacementNode === null) {
                 path.remove();
             }
@@ -91,7 +102,7 @@ const visitors$1 = {
                     path.remove();
                 }
                 else {
-                    if (path.parentPath.node.type === 'ExpressionStatement') {
+                    if (path.parentPath?.node?.type === 'ExpressionStatement') {
                         path.parentPath.replaceWithMultiple(replacementNode);
                     }
                     else {
@@ -107,27 +118,34 @@ const visitors$1 = {
     Literal(path, state) {
         if (typeof path.node?.value === 'string' &&
             path.node.value.startsWith(PLACEHOLDER_PREFIX)) {
-            const key = path.node.value.slice(PLACEHOLDER_PREFIX.length);
-            const validateReplacement = state.placeholderToValidator.get(key);
-            const replacementNode = state.replacementNodes[key];
-            if (validateReplacement && !validateReplacement(replacementNode)) {
-                throw new Error(`Validation failed for templated node of type ${path.node.type}`);
-            }
+            // A literal can only be replaced with a single node
+            const replacementNode = getReplacementNode(state, path.node.value, path.node.type);
             path.replaceWith(replacementNode);
         }
     },
 };
-function esTemplateImpl(javascriptSegments, validatorFns, wrap, unwrap) {
+function esTemplateImpl(javascriptSegments, validators, wrap, unwrap) {
     let placeholderCount = 0;
     let parsableCode = javascriptSegments[0];
-    validatorFns.reverse();
     const placeholderToValidator = new Map();
-    for (const segment of javascriptSegments.slice(1)) {
-        const validatorFn = validatorFns.pop();
-        if (validatorFn) {
-            placeholderToValidator.set(placeholderCount.toString(), validatorFn);
+    for (let i = 1; i < javascriptSegments.length; i += 1) {
+        const segment = javascriptSegments[i];
+        const validator = validators[i - 1]; // always one less value than strings in template literals
+        if (typeof validator === 'function' || validator === NO_VALIDATION) {
+            // Template slot will be filled by a *new* argument passed to the generated function
+            if (validator !== NO_VALIDATION) {
+                placeholderToValidator.set(placeholderCount, validator);
+            }
+            parsableCode += `${PLACEHOLDER_PREFIX}${placeholderCount}`;
+            placeholderCount += 1;
+        }
+        else {
+            // Template slot uses a *previously defined* argument passed to the generated function
+            if (validator >= placeholderCount) {
+                throw new Error(`Reference to argument ${validator} at index ${i} cannot be used. Only ${placeholderCount - 1} arguments have been defined.`);
+            }
+            parsableCode += `${PLACEHOLDER_PREFIX}${validator}`;
         }
-        parsableCode += `${PLACEHOLDER_PREFIX}${placeholderCount++}`;
         parsableCode += segment;
     }
     if (wrap) {
@@ -159,16 +177,30 @@ function esTemplateImpl(javascriptSegments, validatorFns, wrap, unwrap) {
             placeholderToValidator,
             replacementNodes,
         }));
-        return unwrap ? unwrap(result) : result;
+        return (unwrap ? unwrap(result) : result);
     };
 }
-function esTemplate(javascriptSegments, ...validatorFns) {
-    return esTemplateImpl(javascriptSegments, validatorFns);
+/**
+ * Template literal tag that generates a builder function. Like estree's `builders`, but for more
+ * complex structures. The template values should be estree `is` validators or a back reference to
+ * a previous slot (to re-use the referenced value).
+ *
+ * To have the generated function return a particular node type, the generic comes _after_ the
+ * template literal. Kinda weird, but it's necessary to infer the types of the template values.
+ * (If it were at the start, we'd need to explicitly provide _all_ type params. Tedious!)
+ * @example
+ * const bSum = esTemplate`(${is.identifier}, ${is.identifier}) => ${0} + ${1}`<EsArrowFunctionExpression>
+ * const sumFuncNode = bSum(b.identifier('a'), b.identifier('b'))
+ * // `sumFuncNode` is an AST node representing `(a, b) => a + b`
+ */
+function esTemplate(javascriptSegments, ...Validators) {
+    return esTemplateImpl(javascriptSegments, Validators);
 }
-function esTemplateWithYield(javascriptSegments, ...validatorFns) {
+/** Similar to {@linkcode esTemplate}, but supports `yield` expressions. */
+function esTemplateWithYield(javascriptSegments, ...validators) {
     const wrap = (code) => `function* placeholder() {${code}}`;
     const unwrap = (node) => node.body.body.length === 1 ? node.body.body[0] : node.body.body;
-    return esTemplateImpl(javascriptSegments, validatorFns, wrap, unwrap);
+    return esTemplateImpl(javascriptSegments, validators, wrap, unwrap);
 }
 
 /*
@@ -177,12 +209,12 @@ function esTemplateWithYield(javascriptSegments, ...validatorFns) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-const bDefaultStyleImport = esTemplate `
+const bDefaultStyleImport = (esTemplate `
     import defaultStylesheets from '${is.literal}';
-`;
-const bDefaultScopedStyleImport = esTemplate `
+`);
+const bDefaultScopedStyleImport = (esTemplate `
     import defaultScopedStylesheets from '${is.literal}';
-`;
+`);
 function catalogStyleImport(path, state) {
     const specifier = path.node.specifiers[0];
     if (typeof path.node.source.value !== 'string' ||
@@ -220,14 +252,20 @@ function catalogStaticStylesheets(ids, state) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-const isStringLiteral = (node) => is.literal(node) && typeof node.value === 'string';
-const isIdentOrRenderCall = (node) => is.identifier(node) ||
-    (is.callExpression(node) &&
-        is.memberExpression(node.callee) &&
-        is.identifier(node.callee.property) &&
-        node.callee.property.name === 'render');
+const isStringLiteral = (node) => {
+    return is.literal(node) && typeof node.value === 'string';
+};
+/** Returns `true` if the node is an identifier or `<something>.render()`. */
+const isIdentOrRenderCall = (node) => {
+    return (is.identifier(node) ||
+        (is.callExpression(node) &&
+            is.memberExpression(node.callee) &&
+            is.identifier(node.callee.property) &&
+            node.callee.property.name === 'render'));
+};
+/** Extends a validator to return `true` if the node is `null`. */
 function isNullableOf(validator) {
-    return (node) => node === null || (validator && validator(node));
+    return (node) => node === null || validator(node);
 }
 
 /*
@@ -236,9 +274,9 @@ function isNullableOf(validator) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-const bImportDeclaration = esTemplate `
+const bImportDeclaration = (esTemplate `
     import ${is.identifier} from "${isStringLiteral}";
-`;
+`);
 
 /*
  * Copyright (c) 2024, salesforce.com, inc.
@@ -246,31 +284,40 @@ const bImportDeclaration = esTemplate `
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-const bGenerateMarkup = esTemplate `
+const bGenerateMarkup = (esTemplate `
     export async function* generateMarkup(tagName, props, attrs, slotted) {
         attrs = attrs ?? {};
         ${isNullableOf(is.expressionStatement)};
         const instance = new ${is.identifier}({
             tagName: tagName.toUpperCase(),
         });
-        instance.__internal__setState(props, __REFLECTED_PROPS__, attrs);
+        instance[__SYMBOL__SET_INTERNALS](props, __REFLECTED_PROPS__, attrs);
         instance.isConnected = true;
-        instance.connectedCallback?.();
+        if (instance.connectedCallback) {
+            __mutationTracker.enable(instance);
+            instance.connectedCallback();
+            __mutationTracker.disable(instance);
+        }
         const tmplFn = ${isIdentOrRenderCall} ?? __fallbackTmpl;
         yield \`<\${tagName}\`;
         yield tmplFn.stylesheetScopeTokenHostClass ?? '';
-        yield *__renderAttrs(attrs)
+        yield* __renderAttrs(instance, attrs)
         yield '>';
-        yield* tmplFn(props, attrs, slotted, ${is.identifier}, instance);
+        yield* tmplFn(props, attrs, slotted, ${1}, instance);
         yield \`</\${tagName}>\`;
     }
-`;
-const bInsertFallbackTmplImport = esTemplate `
-    import { fallbackTmpl as __fallbackTmpl, renderAttrs as __renderAttrs } from '@lwc/ssr-runtime';
-`;
-const bCreateReflectedPropArr = esTemplate `
+`);
+const bInsertFallbackTmplImport = (esTemplate `
+    import {
+        fallbackTmpl as __fallbackTmpl,
+	mutationTracker as __mutationTracker,
+        renderAttrs as __renderAttrs,
+        SYMBOL__SET_INTERNALS as __SYMBOL__SET_INTERNALS,
+    } from '@lwc/ssr-runtime';
+`);
+const bCreateReflectedPropArr = (esTemplate `
     const __REFLECTED_PROPS__ = ${is.arrayExpression};
-`;
+`);
 function bReflectedAttrsObj(reflectedPropNames) {
     // This will build getter properties for each reflected property. It'll look
     // something like this:
@@ -281,9 +328,16 @@ function bReflectedAttrsObj(reflectedPropNames) {
     //
     // The props object will be kept up-to-date with any new values set on the corresponding
     // property name in the component instance.
-    const reflectedAttrGetters = reflectedPropNames.map((propName) => builders.property('get', builders.literal(AriaPropNameToAttrNameMap[propName]), builders.functionExpression(null, [], builders.blockStatement([
-        builders.returnStatement(builders.memberExpression(builders.identifier('props'), builders.identifier(propName))),
-    ]))));
+    const reflectedAttrAccessors = [];
+    for (const propName of reflectedPropNames) {
+        reflectedAttrAccessors.push(builders.property('get', builders.literal(AriaPropNameToAttrNameMap[propName]), builders.functionExpression(null, [], builders.blockStatement([
+            builders.returnStatement(builders.callExpression(builders.identifier('String'), [
+                builders.memberExpression(builders.identifier('props'), builders.identifier(propName)),
+            ])),
+        ]))), builders.property('set', builders.literal(AriaPropNameToAttrNameMap[propName]), builders.functionExpression(null, [builders.identifier('val')], builders.blockStatement([
+            builders.expressionStatement(builders.assignmentExpression('=', builders.memberExpression(builders.identifier('props'), builders.identifier(propName)), builders.identifier('val'))),
+        ]))));
+    }
     // This mutates the `attrs` object, adding the reflected aria attributes that have been
     // detected. Example:
     //
@@ -293,7 +347,7 @@ function bReflectedAttrsObj(reflectedPropNames) {
     //       return props.ariaChecked;
     //     }
     //   }
-    return builders.expressionStatement(builders.assignmentExpression('=', builders.identifier('attrs'), builders.objectExpression([builders.spreadElement(builders.identifier('attrs')), ...reflectedAttrGetters])));
+    return builders.expressionStatement(builders.assignmentExpression('=', builders.identifier('attrs'), builders.objectExpression([builders.spreadElement(builders.identifier('attrs')), ...reflectedAttrAccessors])));
 }
 /**
  * This builds a generator function `generateMarkup` and adds it to the component JS's
@@ -314,7 +368,7 @@ function addGenerateMarkupExport(program, state, filename) {
         ? builders.callExpression(builders.memberExpression(builders.identifier('instance'), builders.identifier('render')), [])
         : builders.identifier('tmpl');
     if (!tmplExplicitImports) {
-        const defaultTmplPath = filename.replace(/\.js$/, '.html');
+        const defaultTmplPath = `./${basename(filename, 'js')}html`;
         program.body.unshift(bImportDeclaration(builders.identifier('tmpl'), builders.literal(defaultTmplPath)));
     }
     let attrsAugmentation = null;
@@ -324,7 +378,7 @@ function addGenerateMarkupExport(program, state, filename) {
     const reflectedPropArr = builders.arrayExpression([...state.reflectedPropsInPlay].map((propName) => builders.literal(propName)));
     program.body.unshift(bInsertFallbackTmplImport());
     program.body.push(bCreateReflectedPropArr(reflectedPropArr));
-    program.body.push(bGenerateMarkup(attrsAugmentation, classIdentifier, renderCall, classIdentifier));
+    program.body.push(bGenerateMarkup(attrsAugmentation, classIdentifier, renderCall));
 }
 
 /*
@@ -442,7 +496,7 @@ function compileJS(src, filename) {
         // file in question is likely not an LWC. With this v1 implementation,
         // we'll just return the original source.
         return {
-            code: src,
+            code: generate(ast, {}),
         };
     }
     if (state.cssExplicitImports || state.staticStylesheetIds) {
@@ -454,27 +508,1199 @@ function compileJS(src, filename) {
     };
 }
 
-const bStylesheetTokenDeclaration = esTemplate `
+/**
+ * Copyright (c) 2024 Salesforce, Inc.
+ */
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+
+/*
+ * Copyright (c) 2018, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+var DiagnosticLevel;
+(function (DiagnosticLevel) {
+    /** Unexpected error, parsing error, bundling error */
+    DiagnosticLevel[DiagnosticLevel["Fatal"] = 0] = "Fatal";
+    /** Linting error with error level, invalid external reference, invalid import, invalid transform */
+    DiagnosticLevel[DiagnosticLevel["Error"] = 1] = "Error";
+    /** Linting error with warning level, usage of an API to be deprecated */
+    DiagnosticLevel[DiagnosticLevel["Warning"] = 2] = "Warning";
+    /** Logging messages */
+    DiagnosticLevel[DiagnosticLevel["Log"] = 3] = "Log";
+})(DiagnosticLevel || (DiagnosticLevel = {}));
+
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+/*
+ * For the next available error code, reference (and update!) the value in ./index.ts
+ */
+({
+    code: 1001,
+    message: 'Unexpected compilation error: {0}',
+    level: DiagnosticLevel.Error,
+    url: '',
+});
+({
+    INVALID_COMPAT_PROPERTY: {
+        code: 1013,
+        message: 'Expected a boolean for outputConfig.compat, received "{0}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_ENV_ENTRY_VALUE: {
+        code: 1014,
+        message: 'Expected a string for outputConfig.env["{0}"], received "{1}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_ENV_PROPERTY: {
+        code: 1015,
+        message: 'Expected an object for outputConfig.env, received "{0}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_FILES_PROPERTY: {
+        code: 1016,
+        message: 'Expected an object with files to be compiled.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_NAME_PROPERTY: {
+        code: 1018,
+        message: 'Expected a string for name, received "{0}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_NAMESPACE_PROPERTY: {
+        code: 1019,
+        message: 'Expected a string for namespace, received "{0}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_SOURCEMAP_PROPERTY: {
+        code: 1021,
+        message: 'Expected a boolean value or \'inline\' for outputConfig.sourcemap, received "{0}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    MISSING_OPTIONS_OBJECT: {
+        code: 1023,
+        message: 'Expected options object, received "{0}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    UNEXPECTED_FILE_CONTENT: {
+        code: 1024,
+        message: 'Unexpected file content for "{0}". Expected a string, received "{1}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    UNKNOWN_ENV_ENTRY_KEY: {
+        code: 1025,
+        message: 'Unknown entry "{0}" in outputConfig.env.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+});
+({
+    MODULE_RESOLUTION_ERROR: {
+        code: 1002,
+        message: 'Error in module resolution: {0}',
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    IMPORTEE_RESOLUTION_FAILED: {
+        code: 1010,
+        message: 'Failed to resolve entry for module "{0}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    IMPORTEE_RESOLUTION_FROM_IMPORTER_FAILED: {
+        code: 1011,
+        message: 'Failed to resolve import "{0}" from "{1}". Please add "{2}" file to the component folder.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    NONEXISTENT_FILE: {
+        code: 1004,
+        message: 'No such file {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FOLDER_NAME_STARTS_WITH_CAPITAL_LETTER: {
+        code: 1116,
+        message: 'Illegal folder name "{0}". The folder name must start with a lowercase character: "{1}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FOLDER_AND_FILE_NAME_CASE_MISMATCH: {
+        code: 1117,
+        message: 'Failed to resolve "{0}". The file name must case match the component folder name "{1}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    IMPORT_AND_FILE_NAME_CASE_MISMATCH: {
+        code: 1118,
+        message: 'Failed to resolve "{0}" from "{1}". Did you mean "{2}"?',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    RELATIVE_DYNAMIC_IMPORT: {
+        code: 1120,
+        message: 'Illegal usage of the dynamic import syntax with a relative path.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+});
+({
+    CSS_TRANSFORMER_ERROR: {
+        code: 1009,
+        message: '{0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    CSS_IN_HTML_ERROR: {
+        code: 1026,
+        message: 'An error occurred parsing inline CSS. {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    HTML_TRANSFORMER_ERROR: {
+        code: 1008,
+        message: '{0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_ID: {
+        code: 1027,
+        message: 'Expect a string for id. Received {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_SOURCE: {
+        code: 1006,
+        message: 'Expect a string for source. Received {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    JS_TRANSFORMER_ERROR: {
+        code: 1007,
+        message: '{0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    NO_AVAILABLE_TRANSFORMER: {
+        code: 1005,
+        message: 'No available transformer for "{0}"',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    JS_TRANSFORMER_DECORATOR_ERROR: {
+        code: 1198,
+        message: 'Decorators like @api, @track, and @wire are only supported in LightningElement classes. {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+});
+
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+/*
+ * For the next available error code, reference (and update!) the value in ./index.ts
+ */
+({
+    INVALID_DYNAMIC_IMPORT_SOURCE_STRICT: {
+        code: 1121,
+        message: 'Invalid import. The argument "{0}" must be a stringLiteral for dynamic imports when strict mode is enabled.',
+        url: '',
+        level: DiagnosticLevel.Error,
+    },
+});
+({
+    ADAPTER_SHOULD_BE_FIRST_PARAMETER: {
+        code: 1092,
+        message: '@wire expects an adapter as first parameter. @wire(adapter: WireAdapter, config?: any).',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    API_AND_TRACK_DECORATOR_CONFLICT: {
+        code: 1093,
+        message: '@api method or property cannot be used with @track',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    CONFIG_OBJECT_SHOULD_BE_SECOND_PARAMETER: {
+        code: 1094,
+        message: '@wire expects a configuration object expression as second parameter.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    CONFLICT_WITH_ANOTHER_DECORATOR: {
+        code: 1095,
+        message: '@wire method or property cannot be used with @{0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    DUPLICATE_API_PROPERTY: {
+        code: 1096,
+        message: 'Duplicate @api property "{0}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FUNCTION_IDENTIFIER_SHOULD_BE_FIRST_PARAMETER: {
+        code: 1097,
+        message: '@wire expects a function identifier as first parameter.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    IMPORTED_FUNCTION_IDENTIFIER_SHOULD_BE_FIRST_PARAMETER: {
+        code: 1098,
+        message: '@wire expects a function identifier to be imported as first parameter.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_BOOLEAN_PUBLIC_PROPERTY: {
+        code: 1099,
+        message: 'Boolean public property must default to false.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_DECORATOR: {
+        code: 1100,
+        message: 'Invalid decorator usage. Supported decorators ({0}) should be imported from "{1}"',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_DECORATOR_TYPE: {
+        code: 1101,
+        message: 'Invalid property of field type',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_DECORATOR_WITH_NAME: {
+        code: 1102,
+        message: 'Invalid \'{0}\' decorator usage. Supported decorators ({1}) should be imported from "{2}"',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    IS_NOT_CLASS_PROPERTY_OR_CLASS_METHOD: {
+        code: 1103,
+        message: '"@{0}" can only be applied on class properties',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    IS_NOT_DECORATOR: {
+        code: 1104,
+        message: '"{0}" can only be used as a class decorator',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    ONE_WIRE_DECORATOR_ALLOWED: {
+        code: 1105,
+        message: 'Method or property can only have 1 @wire decorator',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    PROPERTY_CANNOT_BE_COMPUTED: {
+        code: 1106,
+        message: '@api cannot be applied to a computed property, getter, setter or method.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    PROPERTY_NAME_CANNOT_START_WITH_DATA: {
+        code: 1107,
+        message: 'Invalid property name "{0}". Properties starting with "data" are reserved attributes.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    PROPERTY_NAME_CANNOT_START_WITH_ON: {
+        code: 1108,
+        message: 'Invalid property name "{0}". Properties starting with "on" are reserved for event handlers.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    PROPERTY_NAME_IS_AMBIGUOUS: {
+        code: 1109,
+        message: 'Ambiguous attribute name "{0}". "{0}" will never be called from template because its corresponding property is camel cased. Consider renaming to "{1}".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    PROPERTY_NAME_IS_RESERVED: {
+        code: 1110,
+        message: 'Invalid property name "{0}". "{0}" is a reserved attribute.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    PROPERTY_NAME_PART_IS_RESERVED: {
+        code: 1111,
+        message: 'Invalid property name "{0}". "part" is a future reserved attribute for web components.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    SINGLE_DECORATOR_ON_SETTER_GETTER_PAIR: {
+        code: 1112,
+        message: '@api get {0} and @api set {0} detected in class declaration. Only one of the two needs to be decorated with @api.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    TRACK_ONLY_ALLOWED_ON_CLASS_PROPERTIES: {
+        code: 1113,
+        message: '@track decorator can only be applied to class properties.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    WIRE_ADAPTER_SHOULD_BE_IMPORTED: {
+        code: 1119,
+        message: 'Failed to resolve @wire adapter "{0}". Ensure it is imported.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FUNCTION_IDENTIFIER_CANNOT_HAVE_COMPUTED_PROPS: {
+        code: 1131,
+        message: '@wire identifier cannot contain computed properties',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FUNCTION_IDENTIFIER_CANNOT_HAVE_NESTED_MEMBER_EXRESSIONS: {
+        code: 1132,
+        message: '@wire identifier cannot contain nested member expressions',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    COMPUTED_PROPERTY_CANNOT_BE_TEMPLATE_LITERAL: {
+        code: 1199,
+        message: 'Cannot use a template literal as a computed property key. Instead, use a string or extract the value to a constant.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    COMPUTED_PROPERTY_MUST_BE_CONSTANT_OR_LITERAL: {
+        code: 1200,
+        message: 'Computed property in @wire config must be a constant or primitive literal.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+});
+
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+/*
+ * For the next available error code, reference (and update!) the value in ./index.ts
+ */
+({
+    INVALID_TEMPLATE: {
+        code: 1003,
+        message: 'Invalid template',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    OPTIONS_MUST_BE_OBJECT: {
+        code: 1028,
+        message: 'Compiler options must be an object',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    UNKNOWN_IF_MODIFIER: {
+        code: 1029,
+        message: 'Unknown if modifier {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    UNKNOWN_OPTION_PROPERTY: {
+        code: 1030,
+        message: 'Unknown option property {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    DUPLICATE_ELEMENT_ENTRY: {
+        code: 1150,
+        message: 'customRendererConfig contains duplicate entry for {0} element tag',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    CUSTOM_ELEMENT_TAG_DISALLOWED: {
+        code: 1151,
+        message: 'customRendererConfig should not contain a custom element tag, but found {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+});
+({
+    AMBIGUOUS_ATTRIBUTE_VALUE: {
+        code: 1034,
+        message: 'Ambiguous attribute value {0}. ' +
+            'If you want to make it a valid identifier you should remove the surrounding quotes {1}. ' +
+            'If you want to make it a string you should escape it {2}.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    AMBIGUOUS_ATTRIBUTE_VALUE_STRING: {
+        code: 1035,
+        message: 'Ambiguous attribute value {0}. If you want to make it a string you should escape it {1}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    BOOLEAN_ATTRIBUTE_FALSE: {
+        code: 1036,
+        message: 'To not set a boolean attribute, try <{0}> instead of <{0} {1}="{2}">. ' +
+            'To represent a false value, the attribute has to be omitted altogether.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    BOOLEAN_ATTRIBUTE_TRUE: {
+        code: 1037,
+        message: 'To set a boolean attributes, try <{0} {1}> instead of <{0} {1}="{2}">. ' +
+            'If the attribute is present, its value must either be the empty string ' +
+            "or a value that is an ASCII case -insensitive match for the attribute's canonical name " +
+            'with no leading or trailing whitespace.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    COMPUTED_PROPERTY_ACCESS_NOT_ALLOWED: {
+        code: 1038,
+        message: "Template expression doesn't allow computed property access",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    DIRECTIVE_SHOULD_BE_EXPRESSION: {
+        code: 1039,
+        message: '{0} directive is expected to be an expression',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_ID_ATTRIBUTE: {
+        code: 1040,
+        message: 'Invalid id value "{0}". Id values must not contain any whitespace.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_STATIC_ID_IN_ITERATION: {
+        code: 1041,
+        message: 'Static id values are not allowed in iterators. Id values must be unique within a template and must therefore be computed with an expression.',
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    DUPLICATE_ID_FOUND: {
+        code: 1042,
+        message: 'Duplicate id value "{0}" detected. Id values must be unique within a template.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    EVENT_HANDLER_SHOULD_BE_EXPRESSION: {
+        code: 1043,
+        message: 'Event handler should be an expression',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FOR_EACH_AND_FOR_ITEM_DIRECTIVES_SHOULD_BE_TOGETHER: {
+        code: 1044,
+        message: 'for:each and for:item directives should be associated together.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FOR_EACH_DIRECTIVE_SHOULD_BE_EXPRESSION: {
+        code: 1045,
+        message: 'for:each directive is expected to be a expression.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FOR_INDEX_DIRECTIVE_SHOULD_BE_STRING: {
+        code: 1046,
+        message: 'for:index directive is expected to be a string.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FOR_ITEM_DIRECTIVE_SHOULD_BE_STRING: {
+        code: 1047,
+        message: 'for:item directive is expected to be a string.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FORBIDDEN_IFRAME_SRCDOC_ATTRIBUTE: {
+        code: 1048,
+        message: 'srcdoc attribute is disallowed on <iframe> for security reasons',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FORBIDDEN_SVG_NAMESPACE_IN_TEMPLATE: {
+        code: 1049,
+        message: "Forbidden svg namespace tag found in template: '<{0}>' tag is not allowed within <svg>",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FORBIDDEN_MATHML_NAMESPACE_IN_TEMPLATE: {
+        code: 1050,
+        message: "Forbidden MathML namespace tag found in template: '<{0}>' tag is not allowed within <math>",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    FORBIDDEN_TAG_ON_TEMPLATE: {
+        code: 1051,
+        message: "Forbidden tag found in template: '<{0}>' tag is not allowed.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    GENERIC_PARSING_ERROR: {
+        code: 1052,
+        message: 'Error parsing attribute: {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    IDENTIFIER_PARSING_ERROR: {
+        code: 1053,
+        message: 'Error parsing identifier: {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    IF_DIRECTIVE_SHOULD_BE_EXPRESSION: {
+        code: 1054,
+        message: 'If directive should be an expression',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_ATTRIBUTE_CASE: {
+        code: 1055,
+        message: '{0} is not valid attribute for {1}. All attributes name should be all lowercase.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_EVENT_NAME: {
+        code: 1056,
+        message: 'Invalid event type "{0}". Event type must begin with a lower-case alphabetic character and contain only lower-case alphabetic characters, underscores, and numeric characters',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_HTML_ATTRIBUTE: {
+        code: 1057,
+        message: '{0} is not valid attribute for {1}. For more information refer to https://developer.mozilla.org/en-US/docs/Web/HTML/Element/{1}',
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    INVALID_HTML_SYNTAX: {
+        code: 1058,
+        message: 'Invalid HTML syntax: {0}. For more information, ' +
+            'please visit https://html.spec.whatwg.org/multipage/parsing.html#parse-error-{0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_IDENTIFIER: {
+        code: 1059,
+        message: '{0} is not a valid identifier',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_NODE: {
+        code: 1060,
+        message: "Template expression doesn't allow {0}",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_TABINDEX_ATTRIBUTE: {
+        code: 1061,
+        message: 'The attribute "tabindex" can only be set to "0" or "-1".',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    DEPRECATED_IS_ATTRIBUTE_CANNOT_BE_EXPRESSION: {
+        code: 1062,
+        message: '"is" attribute value can\'t be an expression',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    IS_ATTRIBUTE_NOT_SUPPORTED: {
+        code: 1063,
+        message: '"is" attribute is disallowed',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    KEY_ATTRIBUTE_SHOULD_BE_EXPRESSION: {
+        code: 1064,
+        message: 'Key attribute value should be an expression',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    KEY_SHOULDNT_REFERENCE_FOR_EACH_INDEX: {
+        code: 1065,
+        message: 'Invalid key value for element <{0}>. Key cannot reference for:each index {1}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    KEY_SHOULDNT_REFERENCE_ITERATOR_INDEX: {
+        code: 1066,
+        message: 'Invalid key value for element <{0}>. Key cannot reference iterator index',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    MISSING_KEY_IN_ITERATOR: {
+        code: 1071,
+        message: 'Missing key for element <{0}> inside of iterator. Elements within iterators must have a unique, computed key value.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    MISSING_ROOT_TEMPLATE_TAG: {
+        code: 1072,
+        message: 'Missing root template tag',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    MODIFYING_ITERATORS_NOT_ALLOWED: {
+        code: 1073,
+        message: "Template expression doesn't allow to modify iterators",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    MULTIPLE_EXPRESSIONS: {
+        code: 1074,
+        message: 'Multiple expressions found',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    MULTIPLE_ROOTS_FOUND: {
+        code: 1075,
+        message: 'Multiple roots found',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    NAME_ON_SLOT_CANNOT_BE_EXPRESSION: {
+        code: 1076,
+        message: "Name attribute on slot tag can't be an expression.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    NO_DIRECTIVE_FOUND_ON_TEMPLATE: {
+        code: 1077,
+        message: 'Invalid template tag. A directive is expected to be associated with the template tag.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    NO_MATCHING_CLOSING_TAGS: {
+        code: 1078,
+        message: '<{0}> has no matching closing tag.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    ROOT_TAG_SHOULD_BE_TEMPLATE: {
+        code: 1079,
+        message: 'Expected root tag to be template, found {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    ROOT_TEMPLATE_HAS_UNKNOWN_ATTRIBUTES: {
+        code: 1080,
+        message: 'Root template has unknown or disallowed attributes: {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    // TODO [#3100]: Update message to point to external documentation once available.
+    SLOT_TAG_CANNOT_HAVE_DIRECTIVES: {
+        code: 1082,
+        message: "<slot> tag can't be associated with {0} template directives.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    TEMPLATE_EXPRESSION_PARSING_ERROR: {
+        code: 1083,
+        message: 'Error parsing template expression: {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    UNEXPECTED_IF_MODIFIER: {
+        code: 1084,
+        message: 'Unexpected if modifier {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_DOM_INVALID_VALUE: {
+        code: 1085,
+        message: 'Invalid value for "lwc:dom". \'lwc:dom\' can only be set to {0}',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_DOM_INVALID_CONTENTS: {
+        code: 1086,
+        message: 'Invalid contents for element with "lwc:dom". Element must be empty',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_DOM_INVALID_CUSTOM_ELEMENT: {
+        code: 1087,
+        message: 'Invalid directive "lwc:dom" on element {0}. "lwc:dom" cannot be added to a custom element',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_DOM_INVALID_SLOT_ELEMENT: {
+        code: 1088,
+        message: 'Invalid directive "lwc:dom" on <slot>.. "lwc:dom" cannot be added to a <slot>',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    STYLE_TAG_NOT_ALLOWED_IN_TEMPLATE: {
+        code: 1122,
+        message: "The <style> element is disallowed inside the template. Please add css rules into '.css' file of your component bundle.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    UNKNOWN_HTML_TAG_IN_TEMPLATE: {
+        code: 1123,
+        message: "Unknown html tag '<{0}>'. For more information refer to https://developer.mozilla.org/en-US/docs/Web/HTML/Element and https://developer.mozilla.org/en-US/docs/Web/SVG/Element",
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    ATTRIBUTE_NAME_STARTS_WITH_INVALID_CHARACTER: {
+        code: 1124,
+        message: '{0} is not valid attribute for {1}. Attribute name must start with an underscore, dollar sign, or an optional hyphen character followed by an alphabetic character.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    ATTRIBUTE_NAME_MUST_END_WITH_ALPHA_NUMERIC_CHARACTER: {
+        code: 1125,
+        message: '{0} is not valid attribute for {1}. Attribute name must end with alpha-numeric character.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    UNKNOWN_LWC_DIRECTIVE: {
+        code: 1127,
+        message: 'Invalid directive "{0}" on element {1}.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_OPTS_LWC_DYNAMIC: {
+        code: 1128,
+        message: 'Invalid lwc:dynamic usage. The LWC dynamic directive must be enabled in order to use this feature.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_LWC_DYNAMIC_ON_NATIVE_ELEMENT: {
+        code: 1129,
+        message: 'Invalid lwc:dynamic usage on element "{0}". This directive can only be used in a custom element.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_LWC_DYNAMIC_LITERAL_PROP: {
+        code: 1130,
+        message: 'Invalid lwc:dynamic usage on element "{0}". The directive binding must be an expression.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_RENDER_MODE_INVALID_VALUE: {
+        code: 1133,
+        message: 'Invalid value for "lwc:render-mode". \'lwc:render-mode\' can only be set to "shadow", or "light"',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_LIGHT_SLOT_INVALID_ATTRIBUTES: {
+        code: 1134,
+        message: "Invalid attribute(s) '{0}' on slot. Slots in Light DOM templates (which have 'lwc:render-mode' directive) can only have [{1}] attributes",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_DOM_INVALID_IN_LIGHT_DOM: {
+        code: 1135,
+        message: "Invalid directive 'lwc:dom' on element {0}. 'lwc:dom' is not necessary in Light DOM components.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_FOR_EACH_WITH_ITERATOR: {
+        code: 1136,
+        message: "Invalid usage for 'for:each' and '{0}' directives on the same element.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    NO_DUPLICATE_SLOTS: {
+        code: 1137,
+        message: 'Invalid duplicate slot ({0}).',
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    NO_SLOTS_IN_ITERATOR: {
+        code: 1138,
+        message: 'Invalid slot ({0}). A slot cannot appear inside of an iterator.',
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    LWC_LIGHT_SLOT_INVALID_EVENT_LISTENER: {
+        code: 1139,
+        message: "Invalid event listener '{0}' on slot. Slots in Light DOM templates cannot have event listeners.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_INNER_HTML_INVALID_CUSTOM_ELEMENT: {
+        code: 1140,
+        message: 'Invalid lwc:inner-html usage on element "{0}". The directive can\'t be used on a custom element or special LWC managed elements denoted with lwc:*.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_INNER_HTML_INVALID_ELEMENT: {
+        code: 1141,
+        message: 'Invalid lwc:inner-html usage on element "{0}". The directive can\'t be used on a slot or a template element.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_INNER_HTML_INVALID_CONTENTS: {
+        code: 1142,
+        message: 'Invalid lwc:inner-html usage on element "{0}". The directive can\'t be used on an element with content.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_INNER_HTML_INVALID_VALUE: {
+        code: 1143,
+        message: 'Invalid lwc:inner-html usage on element "{0}". The directive binding can only be an expression or a string.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_HTML_RECOVERY: {
+        code: 1144,
+        message: 'Invalid HTML detected, "<{0}>" was automatically inserted within "<{1}>"; the compiled template may not match the template source.',
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    INVALID_TEMPLATE_ATTRIBUTE: {
+        code: 1145,
+        message: 'Invalid attributes detected on template. The following attributes are not supported on template tags in LWC: {0}. For more information, ' +
+            'please visit https://sfdc.co/template-directives',
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    PRESERVE_COMMENTS_MUST_BE_BOOLEAN: {
+        code: 1146,
+        message: 'lwc:preserve-comments must be a boolean attribute.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    DUPLICATE_ATTR_PROP_TRANSFORM: {
+        code: 1147,
+        message: 'Found multiple HTML attributes mapping to the same JavaScript property. "{0}" and "{1}" both map to "{2}".',
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    INVALID_HTML_SYNTAX_WARNING: {
+        code: 1148,
+        message: 'Invalid HTML syntax: {0}. This will not be supported in future versions of LWC. For more information, ' +
+            'please visit https://html.spec.whatwg.org/multipage/parsing.html#parse-error-{0}',
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    KEY_SHOULD_BE_IN_ITERATION: {
+        code: 1149,
+        message: 'Invalid key attribute on element <{0}>. The key attribute should be applied to an element with for:each or iterator:*, or to a direct child of a <template> element with for:each or iterator:*. This key will be ignored, and may throw an error in future versions of LWC.',
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    INVALID_TEMPLATE_WARNING: {
+        code: 1153,
+        message: 'Non-root template elements must contain valid LWC template directive attributes. Otherwise, the template and its children will be ignored. ' +
+            'For more information please visit https://sfdc.co/template-directives',
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    INVALID_LWC_SPREAD_LITERAL_PROP: {
+        code: 1155,
+        message: 'Invalid lwc:spread usage on element "{0}". The directive binding must be an expression.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_REF_INVALID_ELEMENT: {
+        code: 1156,
+        message: 'Invalid lwc:ref usage on element "{0}". The directive can\'t be used on a slot or a template element.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_REF_INVALID_VALUE: {
+        code: 1157,
+        message: 'Invalid lwc:ref usage on element "{0}". The directive binding must be a non-empty string.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_REF_INVALID_LOCATION_INSIDE_ITERATION: {
+        code: 1158,
+        message: 'Invalid lwc:ref usage on element "{0}". lwc:ref cannot be used inside for:each or an iterator.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    IF_BLOCK_DIRECTIVE_SHOULD_BE_EXPRESSION: {
+        code: 1159,
+        message: 'lwc:if directive value should be an expression',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    ELSEIF_BLOCK_DIRECTIVE_SHOULD_BE_EXPRESSION: {
+        code: 1160,
+        message: 'lwc:elseif directive value should be an expression',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    ELSE_BLOCK_DIRECTIVE_CANNOT_HAVE_VALUE: {
+        code: 1161,
+        message: 'lwc:else directive cannot have a value',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_IF_BLOCK_DIRECTIVE_WITH_CONDITIONAL: {
+        code: 1162,
+        message: "Invalid usage of 'lwc:if' and '{0}' directives on the same element.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_ELSEIF_BLOCK_DIRECTIVE_WITH_CONDITIONAL: {
+        code: 1163,
+        message: "Invalid usage of 'lwc:elseif' and '{0}' directives on the same element.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_ELSE_BLOCK_DIRECTIVE_WITH_CONDITIONAL: {
+        code: 1164,
+        message: "Invalid usage of 'lwc:else' and '{0}' directives on the same element.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_IF_SCOPE_NOT_FOUND: {
+        code: 1165,
+        message: "'{0}' directive must be used immediately after an element with 'lwc:if' or 'lwc:elseif'. No such element found.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_IF_CANNOT_BE_USED_WITH_IF_DIRECTIVE: {
+        code: 1166,
+        message: "'{0}' directive cannot be used with 'lwc:if', 'lwc:elseif', or 'lwc:else directives on the same element.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    SCOPED_SLOT_BIND_IN_LIGHT_DOM_ONLY: {
+        code: 1169,
+        message: 'Invalid lwc:slot-bind usage on <slot> element. Scoped slots usage is allowed in Light DOM templates only.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_LWC_SLOT_BIND_LITERAL_PROP: {
+        code: 1170,
+        message: 'Invalid lwc:slot-bind usage on element {0}. The directive binding must be an expression.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_LWC_SLOT_BIND_NON_SLOT_ELEMENT: {
+        code: 1171,
+        message: 'Invalid lwc:slot-bind usage on element {0}. The directive can be used on a <slot> element only.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    NO_DUPLICATE_SCOPED_SLOT: {
+        code: 1172,
+        message: 'Invalid duplicate scoped slots ({0})',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    NO_MIXED_SLOT_TYPES: {
+        code: 1173,
+        message: 'Mixing slot types disallowed for same ({0}) slot.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    SLOT_DATA_VALUE_SHOULD_BE_STRING: {
+        code: 1174,
+        message: 'lwc:slot-data attribute value is expected to be a string.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    SCOPED_SLOT_DATA_ON_TEMPLATE_ONLY: {
+        code: 1176,
+        message: 'lwc:slot-data directive can be used on <template> elements only.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    NON_ELEMENT_SCOPED_SLOT_CONTENT: {
+        code: 1177,
+        message: '<template> tag with lwc:slot-data directive cannot contain a comment or text node as a direct child.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_PARENT_OF_LWC_SLOT_DATA: {
+        code: 1178,
+        message: '<template> tag with lwc:slot-data directive must be the direct child of a custom element.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    SCOPED_SLOTDATA_CANNOT_BE_COMBINED_WITH_OTHER_DIRECTIVE: {
+        code: 1179,
+        message: 'lwc:slot-data directive cannot be combined with other directives on the same <template> tag.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_LWC_EXTERNAL_ON_NON_CUSTOM_ELEMENT: {
+        code: 1180,
+        message: 'Invalid lwc:external directive usage: {0}. This directive can only be used on custom elements.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    INVALID_LWC_EXTERNAL_VALUE: {
+        code: 1181,
+        message: 'Invalid lwc:external directive usage: {0}. This directive is a boolean attribute and should not have a value.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    SINGLE_IF_DIRECTIVE_ALLOWED: {
+        code: 1182,
+        message: `Multiple if: directives found on '{0}'. Only one if: directive is allowed; the rest are ignored.`,
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    LWC_COMPONENT_TAG_WITHOUT_IS_DIRECTIVE: {
+        code: 1183,
+        message: `<lwc:component> must have an 'lwc:is' attribute.`,
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    UNSUPPORTED_LWC_TAG_NAME: {
+        code: 1184,
+        message: '{0} is not a special LWC tag name and will be treated as an HTML element.',
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    INVALID_LWC_IS_DIRECTIVE_VALUE: {
+        code: 1185,
+        message: 'Invalid lwc:is usage for value {0}. The value assigned to lwc:is must be an expression.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    LWC_IS_INVALID_ELEMENT: {
+        code: 1186,
+        message: 'Invalid lwc:is usage for element {0}. The directive can only be used with <lwc:component>',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    DEPRECATED_LWC_DYNAMIC_ATTRIBUTE: {
+        code: 1187,
+        message: `The lwc:dynamic directive is deprecated and will be removed in a future release. Please use lwc:is instead.`,
+        level: DiagnosticLevel.Warning,
+        url: '',
+    },
+    INVALID_OPTS_LWC_ENABLE_DYNAMIC_COMPONENTS: {
+        code: 1188,
+        message: 'Invalid dynamic components usage, lwc:component and lwc:is can only be used when dynamic components have been enabled.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    // TODO [#3370]: remove this error if template expressions is removed
+    INVALID_EXPR_ARROW_FN_PARAM: {
+        code: 1189,
+        message: "Template expression doesn't allow {0} in arrow function params.",
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    // TODO [#3370]: remove this error if template expressions is removed
+    INVALID_EXPR_STATEMENTS_PROHIBITED: {
+        code: 1190,
+        message: 'Statements are disallowed in template expressions.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    // TODO [#3370]: remove this error if template expressions is removed
+    INVALID_EXPR_MUTATION_OUTSIDE_ARROW: {
+        code: 1191,
+        message: 'Field mutations are only permitted within arrow functions.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    // TODO [#3370]: remove this error if template expressions is removed
+    INVALID_EXPR_DELETE_OP: {
+        code: 1192,
+        message: 'Use of the delete operator is prohibited within template expressions.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    // TODO [#3370]: remove this error if template expressions is removed
+    INVALID_EXPR_ARROW_FN_BODY: {
+        code: 1193,
+        message: 'The body of arrow functions in template expressions must be an expression.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    // TODO [#3370]: remove this error if template expressions is removed
+    INVALID_EXPR_ARROW_FN_KIND: {
+        code: 1194,
+        message: 'Arrow functions in template expressions cannot be {0}.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    // TODO [#3370]: remove this error if template expressions is removed
+    INVALID_EXPR_EARLY_STAGE_FEATURE: {
+        code: 1195,
+        message: 'Early-stage JS features are disallowed in template expressions.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    // TODO [#3370]: remove this error if template expressions is removed
+    INVALID_EXPR_PROHIBITED_NODE_TYPE: {
+        code: 1196,
+        message: 'Use of {0} is disallowed within template expressions.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+    // TODO [#3370]: remove this error if template expressions is removed
+    INVALID_EXPR_COMMENTS_DISALLOWED: {
+        code: 1197,
+        message: 'Use of comments is disallowed within template expressions.',
+        level: DiagnosticLevel.Error,
+        url: '',
+    },
+});
+
+/**
+ * Pattern modeled after @lwc/engine-core's reporting.ts system
+ */
+var CompilerMetrics;
+(function (CompilerMetrics) {
+    CompilerMetrics["LWCDynamicDirective"] = "lwc-dynamic-directive";
+    CompilerMetrics["LWCRenderModeDirective"] = "lwc-render-mode-directive";
+    CompilerMetrics["LWCSpreadDirective"] = "lwc-spread-directive";
+    CompilerMetrics["DynamicImportTransform"] = "dynamic-import-transform";
+})(CompilerMetrics || (CompilerMetrics = {}));
+/** version: 8.3.0 */
+
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+const bStylesheetTokenDeclaration = (esTemplate `
     const stylesheetScopeToken = '${is.literal}';
-`;
+`);
 const bAdditionalDeclarations = [
-    esTemplate `
+    (esTemplate `
         const hasScopedStylesheets = defaultScopedStylesheets && defaultScopedStylesheets.length > 0;
-    `,
-    esTemplate `
+    `),
+    (esTemplate `
         const stylesheetScopeTokenClass = hasScopedStylesheets ? \` class="\${stylesheetScopeToken}"\` : '';
-    `,
-    esTemplate `
+    `),
+    (esTemplate `
         const stylesheetScopeTokenHostClass = hasScopedStylesheets ? \` class="\${stylesheetScopeToken}-host"\` : '';
-    `,
-    esTemplate `
+    `),
+    (esTemplate `
         const stylesheetScopeTokenClassPrefix = hasScopedStylesheets ? (stylesheetScopeToken + ' ') : '';
-    `,
+    `),
 ];
 // Scope tokens are associated with a given template. This is assigned here so that it can be used in `generateMarkup`.
-const tmplAssignmentBlock = esTemplate `
+const tmplAssignmentBlock = (esTemplate `
     ${is.identifier}.stylesheetScopeTokenHostClass = stylesheetScopeTokenHostClass;
-`;
+`);
 function addScopeTokenDeclarations(program, filename, namespace, componentName) {
     const { scopeToken } = generateScopeTokens(filename, namespace, componentName);
     program.body.unshift(bStylesheetTokenDeclaration(builders$1.literal(scopeToken)), ...bAdditionalDeclarations.map((declaration) => declaration()));
@@ -487,9 +1713,9 @@ function addScopeTokenDeclarations(program, filename, namespace, componentName)
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-const bImportHtmlEscape = esTemplate `
+const bImportHtmlEscape = (esTemplate `
     import { htmlEscape } from '@lwc/shared';
-`;
+`);
 const importHtmlEscapeKey = 'import:htmlEscape';
 // This is a mostly-correct regular expression will only match if the entire string
 // provided is a valid ECMAScript identifier. Its imperfections lie in the fact that
@@ -548,8 +1774,8 @@ const Comment = function Comment(node, cxt) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-function getRootMemberExpression$1(node) {
-    return node.object.type === 'MemberExpression' ? getRootMemberExpression$1(node.object) : node;
+function getRootMemberExpression$2(node) {
+    return node.object.type === 'MemberExpression' ? getRootMemberExpression$2(node.object) : node;
 }
 function expressionIrToEs(node, cxt) {
     if (node.type === 'Identifier') {
@@ -560,7 +1786,7 @@ function expressionIrToEs(node, cxt) {
     }
     else if (node.type === 'MemberExpression') {
         const nodeClone = structuredClone(node);
-        const rootMemberExpr = getRootMemberExpression$1(nodeClone);
+        const rootMemberExpr = getRootMemberExpression$2(nodeClone);
         if (!cxt.isLocalVar(rootMemberExpr.object.name)) {
             rootMemberExpr.object = builders.memberExpression(builders.identifier('instance'), rootMemberExpr.object);
         }
@@ -575,14 +1801,16 @@ function expressionIrToEs(node, cxt) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-const bYieldFromChildGenerator = esTemplateWithYield `
+const bYieldFromChildGenerator = (esTemplateWithYield `
     {
         const childProps = ${is.objectExpression};
         const childAttrs = ${is.objectExpression};
-        const childSlottedContentGenerators = {};
-        yield* ${is.identifier}(${is.literal}, childProps, childAttrs, childSlottedContentGenerators);
+        async function* childSlottedContentGenerator() {
+            ${is.statement}
+        };
+        yield* ${is.identifier}(${is.literal}, childProps, childAttrs, childSlottedContentGenerator);
     }
-`;
+`);
 const bImportGenerateMarkup = (localName, importPath) => builders.importDeclaration([builders.importSpecifier(builders.identifier('generateMarkup'), builders.identifier(localName))], builders.literal(importPath));
 function getChildAttrsOrProps(attrs, cxt) {
     const objectAttrsOrProps = attrs.map((attr) => {
@@ -627,7 +1855,7 @@ const Component = function Component(node, cxt) {
     const childTagName = node.name;
     const attributes = [...node.attributes, ...reflectAriaPropsAsAttrs(node.properties)];
     return [
-        bYieldFromChildGenerator(getChildAttrsOrProps(node.properties, cxt), getChildAttrsOrProps(attributes, cxt), builders.identifier(childGeneratorLocalName), builders.literal(childTagName)),
+        bYieldFromChildGenerator(getChildAttrsOrProps(node.properties, cxt), getChildAttrsOrProps(attributes, cxt), optimizeAdjacentYieldStmts(irChildrenToEs(node.children, cxt)), builders.identifier(childGeneratorLocalName), builders.literal(childTagName)),
     ];
 };
 
@@ -638,7 +1866,7 @@ const Component = function Component(node, cxt) {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 const bYield$1 = (expr) => builders.expressionStatement(builders.yieldExpression(expr));
-const bConditionalLiveYield = esTemplateWithYield `
+const bConditionalLiveYield = (esTemplateWithYield `
     {
         const prefix = (${ /* isClass */is.literal} && stylesheetScopeTokenClassPrefix) || '';
         const attrOrPropValue = ${is.expression};
@@ -650,13 +1878,13 @@ const bConditionalLiveYield = esTemplateWithYield `
             }
         }
     }
-`;
-const bStringLiteralYield = esTemplateWithYield `
+`);
+const bStringLiteralYield = (esTemplateWithYield `
     {
         const prefix = (${ /* isClass */is.literal} && stylesheetScopeTokenClassPrefix) || '';
         yield ' ' + ${is.literal} + '="' + prefix + "${is.literal}" + '"'
     }
-`;
+`);
 function yieldAttrOrPropLiteralValue(name, valueNode, isClass) {
     const { value, type } = valueNode;
     if (typeof value === 'string') {
@@ -704,6 +1932,7 @@ function reorderAttributes(attrs, props) {
     return [classAttr, styleAttr, ...boringAttrs, ...props, slotAttr].filter((el) => el !== null);
 }
 const Element = function Element(node, cxt) {
+    const innerHtmlDirective = node.type === 'Element' && node.directives.find((dir) => dir.name === 'InnerHTML');
     const attrsAndProps = reorderAttributes(node.attributes, node.properties);
     let hasClassAttribute = false;
     const yieldAttrsAndProps = attrsAndProps.flatMap((attr) => {
@@ -724,13 +1953,27 @@ const Element = function Element(node, cxt) {
     if (isVoidElement(node.name, HTML_NAMESPACE)) {
         return [bYield$1(builders.literal(`<${node.name}`)), ...yieldAttrsAndProps, bYield$1(builders.literal(`>`))];
     }
+    let childContent;
+    // An element can have children or lwc:inner-html, but not both
+    // If it has both, the template compiler will throw an error before reaching here
+    if (node.children.length) {
+        childContent = irChildrenToEs(node.children, cxt);
+    }
+    else if (innerHtmlDirective) {
+        const value = innerHtmlDirective.value;
+        const unsanitizedHtmlExpression = value.type === 'Literal' ? builders.literal(value.value) : expressionIrToEs(value, cxt);
+        childContent = [bYield$1(unsanitizedHtmlExpression)];
+    }
+    else {
+        childContent = [];
+    }
     return [
         bYield$1(builders.literal(`<${node.name}`)),
         // If we haven't already prefixed the scope token to an existing class, add an explicit class here
         ...(hasClassAttribute ? [] : [bYield$1(builders.identifier('stylesheetScopeTokenClass'))]),
         ...yieldAttrsAndProps,
         bYield$1(builders.literal(`>`)),
-        ...irChildrenToEs(node.children, cxt),
+        ...childContent,
         bYield$1(builders.literal(`</${node.name}>`)),
     ].filter(Boolean);
 };
@@ -741,18 +1984,18 @@ const Element = function Element(node, cxt) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-function getRootMemberExpression(node) {
-    return node.object.type === 'MemberExpression' ? getRootMemberExpression(node.object) : node;
+function getRootMemberExpression$1(node) {
+    return node.object.type === 'MemberExpression' ? getRootMemberExpression$1(node.object) : node;
 }
-function getRootIdentifier(node) {
-    const rootMemberExpression = getRootMemberExpression(node);
+function getRootIdentifier$1(node) {
+    const rootMemberExpression = getRootMemberExpression$1(node);
     return is.identifier(rootMemberExpression?.object) ? rootMemberExpression.object : null;
 }
-const bForOfYieldFrom = esTemplate `
+const bForOfYieldFrom$1 = (esTemplate `
     for (let [${is.identifier}, ${is.identifier}] of Object.entries(${is.expression} ?? {})) {
         ${is.statement};
     }
-`;
+`);
 const ForEach = function ForEach(node, cxt) {
     const forItemId = node.item.name;
     const forIndexId = node.index?.name ?? '__unused__';
@@ -762,14 +2005,55 @@ const ForEach = function ForEach(node, cxt) {
     });
     cxt.popLocalVars();
     const expression = node.expression;
+    const scopeReferencedId = is.memberExpression(expression)
+        ? getRootIdentifier$1(expression)
+        : null;
+    const iterable = cxt.isLocalVar(scopeReferencedId?.name)
+        ? node.expression
+        : builders.memberExpression(builders.identifier('instance'), node.expression);
+    return [
+        bForOfYieldFrom$1(builders.identifier(forIndexId), builders.identifier(forItemId), iterable, optimizeAdjacentYieldStmts(forEachStatements)),
+    ];
+};
+
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+function getRootMemberExpression(node) {
+    return node.object.type === 'MemberExpression' ? getRootMemberExpression(node.object) : node;
+}
+function getRootIdentifier(node) {
+    const rootMemberExpression = getRootMemberExpression(node);
+    return is.identifier(rootMemberExpression?.object) ? rootMemberExpression.object : null;
+}
+const bForOfYieldFrom = (esTemplate `
+    for (let ${is.identifier} of toIteratorDirective(${is.expression} ?? [])) {
+        ${is.statement};
+    }
+`);
+const bToIteratorDirectiveImport = (esTemplate `
+    import { toIteratorDirective } from '@lwc/ssr-runtime';
+`);
+const ForOf = function ForEach(node, cxt) {
+    const id = node.iterator.name;
+    cxt.pushLocalVars([id]);
+    const forEachStatements = node.children.flatMap((childNode) => {
+        return irToEs(childNode, cxt);
+    });
+    cxt.popLocalVars();
+    const expression = node.expression;
     const scopeReferencedId = is.memberExpression(expression)
         ? getRootIdentifier(expression)
         : null;
     const iterable = cxt.isLocalVar(scopeReferencedId?.name)
         ? node.expression
         : builders.memberExpression(builders.identifier('instance'), node.expression);
+    cxt.hoist(bToIteratorDirectiveImport(), 'toIteratorDirective');
     return [
-        bForOfYieldFrom(builders.identifier(forIndexId), builders.identifier(forItemId), iterable, optimizeAdjacentYieldStmts(forEachStatements)),
+        bForOfYieldFrom(builders.identifier(id), iterable, optimizeAdjacentYieldStmts(forEachStatements)),
     ];
 };
 
@@ -779,32 +2063,86 @@ const ForEach = function ForEach(node, cxt) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-function bBlockStatement(childNodes, cxt) {
-    return builders.blockStatement(optimizeAdjacentYieldStmts(childNodes.flatMap((childNode) => irToEs(childNode, cxt))));
+function bYieldComment(text = '') {
+    return builders.expressionStatement(builders.yieldExpression(builders.literal(`<!--${text}-->`)));
+}
+function bBlockStatement(childNodes, cxt, insertComments) {
+    let statements = childNodes.flatMap((childNode) => irToEs(childNode, cxt));
+    if (insertComments)
+        statements = [bYieldComment(), ...statements, bYieldComment()];
+    return builders.blockStatement(optimizeAdjacentYieldStmts(statements));
 }
 const If = function If(node, cxt) {
     const { modifier: trueOrFalseAsStr, condition, children } = node;
     const trueOrFalse = trueOrFalseAsStr === 'true';
     const comparison = builders.binaryExpression('===', builders.literal(trueOrFalse), expressionIrToEs(condition, cxt));
-    return [builders.ifStatement(comparison, bBlockStatement(children, cxt))];
+    return [builders.ifStatement(comparison, bBlockStatement(children, cxt, false))];
 };
 function bIfStatement(ifElseIfNode, cxt) {
     const { children, condition, else: elseNode } = ifElseIfNode;
     let elseBlock = null;
     if (elseNode) {
         if (elseNode.type === 'ElseBlock') {
-            elseBlock = bBlockStatement(elseNode.children, cxt);
+            elseBlock = bBlockStatement(elseNode.children, cxt, true);
         }
         else {
             elseBlock = bIfStatement(elseNode, cxt);
         }
     }
-    return builders.ifStatement(expressionIrToEs(condition, cxt), bBlockStatement(children, cxt), elseBlock);
+    return builders.ifStatement(expressionIrToEs(condition, cxt), bBlockStatement(children, cxt, true), elseBlock);
 }
 const IfBlock = function IfBlock(node, cxt) {
     return [bIfStatement(node, cxt)];
 };
 
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: MIT
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
+ */
+const bConditionalSlot = (esTemplateWithYield `
+    if (isLightDom) {
+        // start bookend HTML comment
+        yield '<!---->';
+
+        const generator = slottedContent[${ /* slotName */is.expression} ?? ""];
+        if (generator) {
+            yield* generator();
+        } else {
+            // If we're in this else block, then the generator _must_ have yielded
+            // something. It's impossible for a slottedContent["foo"] to exist
+            // without the generator yielding at least a text node / element.
+            // FIXME: how does this work with comments and lwc:preserve-comments?
+            // TODO: default/fallback slot content
+            ${ /* slot fallback content */is.statement}
+        }
+
+        // end bookend HTML comment
+        yield '<!---->';
+    } else {
+        ${ /* slot element AST */is.statement}
+    }
+`);
+const Slot = function Slot(node, ctx) {
+    const nameAttrValue = node.attributes.find((attr) => attr.name === 'name')?.value;
+    let slotName;
+    if (!nameAttrValue) {
+        slotName = builders.literal('');
+    }
+    else if (nameAttrValue.type === 'Literal') {
+        const name = typeof nameAttrValue.value === 'string' ? nameAttrValue.value : '';
+        slotName = builders.literal(name);
+    }
+    else {
+        slotName = builders.memberExpression(builders.literal('instance'), nameAttrValue);
+    }
+    // FIXME: avoid serializing the slot's children twice
+    const slotAst = Element(node, ctx);
+    const slotChildren = irChildrenToEs(node.children, ctx);
+    return [bConditionalSlot(slotName, slotChildren, slotAst)];
+};
+
 /*
  * Copyright (c) 2024, salesforce.com, inc.
  * All rights reserved.
@@ -812,16 +2150,16 @@ const IfBlock = function IfBlock(node, cxt) {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 const bYield = (expr) => builders.expressionStatement(builders.yieldExpression(expr));
-const bYieldEscapedString = esTemplateWithYield `
+const bYieldEscapedString = (esTemplateWithYield `
     const ${is.identifier} = ${is.expression};
-    if (typeof ${is.identifier} === 'string') {
-        yield (${is.literal} && ${is.identifier} === '') ? '\\u200D' : htmlEscape(${is.identifier});
-    } else if (typeof ${is.identifier} === 'number') {
-        yield ${is.identifier}.toString();
+    if (typeof ${0} === 'string') {
+        yield (${is.literal} && ${0} === '') ? '\\u200D' : htmlEscape(${0});
+    } else if (typeof ${0} === 'number') {
+        yield ${0}.toString();
     } else {
-        yield htmlEscape((${is.identifier} ?? '').toString());
+        yield ${0} ? htmlEscape(${0}.toString()) : '\\u200D';
     }
-`;
+`);
 function isLiteral(node) {
     return node.type === 'Literal';
 }
@@ -834,7 +2172,7 @@ const Text = function Text(node, cxt) {
     const valueToYield = expressionIrToEs(node.value, cxt);
     cxt.hoist(bImportHtmlEscape(), importHtmlEscapeKey);
     const tempVariable = builders.identifier(cxt.getUniqueVar());
-    return bYieldEscapedString(tempVariable, valueToYield, tempVariable, isIsolatedTextNode, tempVariable, tempVariable, tempVariable, tempVariable, tempVariable);
+    return bYieldEscapedString(tempVariable, valueToYield, isIsolatedTextNode);
 };
 
 /*
@@ -900,20 +2238,28 @@ function createNewContext(templateOptions) {
 const Root = function Root(node, cxt) {
     return irChildrenToEs(node.children, cxt);
 };
-const transformers = {
-    Comment: Comment,
-    Component: Component,
-    Root: Root,
-    Text: Text,
-    Element: Element,
-    ExternalComponent: Element,
-    ForEach: ForEach,
-    If: If,
-    IfBlock: IfBlock,
-};
 const defaultTransformer = (node) => {
     throw new Error(`Unimplemented IR node: ${inspect(node)}`);
 };
+const transformers = {
+    Comment,
+    Component,
+    Element,
+    ExternalComponent: Element,
+    ForEach,
+    ForOf,
+    If,
+    IfBlock,
+    Root,
+    Text,
+    // lwc:elseif cannot exist without an lwc:if (IfBlock); this gets handled by that transformer
+    ElseifBlock: defaultTransformer,
+    // lwc:elseif cannot exist without an lwc:elseif (IfBlock); this gets handled by that transformer
+    ElseBlock: defaultTransformer,
+    ScopedSlotFragment: defaultTransformer,
+    Slot,
+    Lwc: defaultTransformer,
+};
 function irChildrenToEs(children, cxt) {
     const result = children.flatMap((child, idx) => {
         cxt.prevSibling = children[idx - 1];
@@ -925,7 +2271,10 @@ function irChildrenToEs(children, cxt) {
     return result;
 }
 function irToEs(node, cxt) {
-    const transformer = transformers[node.type] ?? defaultTransformer;
+    if ('directives' in node && node.directives.some((d) => d.name === 'Dynamic')) {
+        throw new Error('The lwc:dynamic directive is not supported for SSR. Use <lwc:component> instead.');
+    }
+    const transformer = transformers[node.type];
     return transformer(node, cxt);
 }
 function templateIrToEsTree(node, contextOpts) {
@@ -943,13 +2292,14 @@ function templateIrToEsTree(node, contextOpts) {
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-const isBool = (node) => is.literal(node) && typeof node.value === 'boolean';
-const bStyleValidationImport = esTemplate `
+const bStyleValidationImport = (esTemplate `
     import { validateStyleTextContents } from '@lwc/ssr-runtime';
-`;
-const bExportTemplate = esTemplate `
-    export default async function* tmpl(props, attrs, slotted, Cmp, instance) {
-        if (!${isBool} && Cmp.renderMode !== 'light') {
+`);
+// TODO [#4663]: Render mode mismatch between template and compiler should throw.
+const bExportTemplate = (esTemplate `
+    export default async function* tmpl(props, attrs, slottedContent, Cmp, instance) {
+        const isLightDom = Cmp.renderMode === 'light';
+        if (!isLightDom) {
             yield \`<template shadowrootmode="open"\${Cmp.delegatesFocus ? ' shadowrootdelegatesfocus' : ''}>\`
         }
         
@@ -971,29 +2321,54 @@ const bExportTemplate = esTemplate `
 
         ${is.statement};
 
-        if (!${isBool} && Cmp.renderMode !== 'light') {
+        if (!isLightDom) {
             yield '</template>';
         }
+
+        if (slottedContent) {
+            yield* slottedContent();
+        }
     }
-`;
+`);
 function compileTemplate(src, filename, options) {
-    const { root, warnings } = parse$1(src);
+    const { root, warnings } = parse$1(src, {
+        // `options` is from @lwc/compiler, and may have flags that @lwc/template-compiler doesn't
+        // know about, so we must explicitly extract the relevant props.
+        name: options.name,
+        namespace: options.namespace,
+        customRendererConfig: options.customRendererConfig,
+        experimentalComputedMemberExpression: options.experimentalComputedMemberExpression,
+        experimentalComplexExpressions: options.experimentalComplexExpressions,
+        enableDynamicComponents: options.enableDynamicComponents,
+        preserveHtmlComments: options.preserveHtmlComments,
+        enableStaticContentOptimization: options.enableStaticContentOptimization,
+        instrumentation: options.instrumentation,
+        apiVersion: options.apiVersion,
+        disableSyntheticShadowSupport: options.disableSyntheticShadowSupport,
+        // TODO [#3331]: remove usage of lwc:dynamic in 246
+        experimentalDynamicDirective: options.experimentalDynamicDirective,
+    });
     if (!root || warnings.length) {
+        let fatal = !root;
         for (const warning of warnings) {
             // eslint-disable-next-line no-console
             console.error('Cannot compile:', warning.message);
+            if (warning.level === DiagnosticLevel.Fatal ||
+                warning.level === DiagnosticLevel.Error) {
+                fatal = true;
+            }
+        }
+        // || !root is just used here to make TypeScript happy
+        if (fatal || !root) {
+            throw new Error('Template compilation failure; see warnings in the console.');
         }
-        throw new Error('Template compilation failure; see warnings in the console.');
     }
-    const tmplRenderMode = root.directives.find((directive) => directive.name === 'RenderMode')?.value?.value ??
-        'shadow';
-    const astShadowModeBool = tmplRenderMode === 'light' ? builders.literal(true) : builders.literal(false);
     const preserveComments = !!root.directives.find((directive) => directive.name === 'PreserveComments')?.value?.value;
     const { hoisted, statements } = templateIrToEsTree(root, { preserveComments });
     const moduleBody = [
         ...hoisted,
         bStyleValidationImport(),
-        bExportTemplate(astShadowModeBool, optimizeAdjacentYieldStmts(statements), astShadowModeBool),
+        bExportTemplate(optimizeAdjacentYieldStmts(statements)),
     ];
     const program = builders.program(moduleBody, 'module');
     addScopeTokenDeclarations(program, filename, options.namespace, options.name);
@@ -1020,5 +2395,5 @@ function compileTemplateForSSR(src, filename, options) {
 }
 
 export { compileComponentForSSR, compileTemplateForSSR };
-/** version: 8.1.3 */
+/** version: 8.3.0 */
 //# sourceMappingURL=index.js.map