@lwc/template-compiler 2.50.0 → 3.0.0

package/README.md

@@ -89,6 +89,8 @@ const { code, warnings } = compile(`<template><h1>Hello World!</h1></template>`,
         }
         ```
 
+-   `apiVersion` (type: `number`, optional) - API version to associate with the compiled template.
+
 **Return:**
 The method returns an object with the following fields:
 

package/dist/config.d.ts

@@ -55,6 +55,10 @@ export interface Config {
      * Config to use to collect metrics and logs
      */
     instrumentation?: InstrumentationObject;
+    /**
+     * The API version to associate with the compiled template
+     */
+    apiVersion?: number;
 }
 export type NormalizedConfig = Required<Omit<Config, 'customRendererConfig' | 'instrumentation'>> & Partial<Pick<Config, 'customRendererConfig' | 'instrumentation'>>;
 export declare function normalizeConfig(config: Config): NormalizedConfig;

package/dist/index.cjs.js

@@ -1,4 +1,3 @@
-/* proxy-compat-disable */
 /**
  * Copyright (C) 2023 salesforce.com, inc.
  */
@@ -128,6 +127,7 @@ function isLwcElementTag(tagName) {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 const AVAILABLE_OPTION_NAMES = new Set([
+    'apiVersion',
     'customRendererConfig',
     'enableLwcSpread',
     'enableStaticContentOptimization',
@@ -180,9 +180,10 @@ function normalizeConfig(config) {
             });
         }
     }
+    const apiVersion = shared.getAPIVersionFromNumber(config.apiVersion);
     return Object.assign(Object.assign(Object.assign({ preserveHtmlComments: false, experimentalComputedMemberExpression: false, 
         // TODO [#3370]: remove experimental template expression flag
-        experimentalComplexExpressions: false, experimentalDynamicDirective: false, enableDynamicComponents: false, enableStaticContentOptimization: true, enableLwcSpread: true }, config), { customRendererConfig }), { instrumentation });
+        experimentalComplexExpressions: false, experimentalDynamicDirective: false, enableDynamicComponents: false, enableStaticContentOptimization: true, enableLwcSpread: true, apiVersion }, config), { customRendererConfig }), { instrumentation });
 }
 
 function isIdentifier(node) {
@@ -1588,6 +1589,7 @@ class ParserCtx {
             ? TMPL_EXPR_ECMASCRIPT_EDITION
             : 2020;
         this.instrumentation = config.instrumentation;
+        this.apiVersion = config.apiVersion;
     }
     getSource(start, end) {
         return this.source.slice(start, end);
@@ -1923,7 +1925,7 @@ const errorCodesToErrorOn = new Set([
     'duplicate-attribute',
 ]);
 // These were added between parse5-with-errors v4.0.4 and parse5 v6.0.1
-const errorCodesToWarnOn = new Set([
+const errorCodesToWarnOnInOlderAPIVersions = new Set([
     'non-conforming-doctype',
     'missing-doctype',
     'misplaced-doctype',
@@ -2258,13 +2260,19 @@ function parseFragment(source, config) {
     return parser.parseFragment(source);
 }
 
-function getLwcErrorFromParse5Error(code) {
+function getLwcErrorFromParse5Error(ctx, code) {
     /* istanbul ignore else */
     if (errorCodesToErrorOn.has(code)) {
         return errors.ParserDiagnostics.INVALID_HTML_SYNTAX;
     }
-    else if (errorCodesToWarnOn.has(code)) {
-        return errors.ParserDiagnostics.INVALID_HTML_SYNTAX_WARNING;
+    else if (errorCodesToWarnOnInOlderAPIVersions.has(code)) {
+        // In newer API versions, all parse 5 errors are errors, not warnings
+        if (shared.isAPIFeatureEnabled(1 /* APIFeature.TREAT_ALL_PARSE5_ERRORS_AS_ERRORS */, ctx.apiVersion)) {
+            return errors.ParserDiagnostics.INVALID_HTML_SYNTAX;
+        }
+        else {
+            return errors.ParserDiagnostics.INVALID_HTML_SYNTAX_WARNING;
+        }
     }
     else {
         // It should be impossible to reach here; we have a test in parser.spec.ts to ensure
@@ -2278,7 +2286,7 @@ function getLwcErrorFromParse5Error(code) {
 function parseHTML(ctx, source) {
     const onParseError = (err) => {
         const { code } = err, location = __rest(err, ["code"]);
-        const lwcError = getLwcErrorFromParse5Error(code);
+        const lwcError = getLwcErrorFromParse5Error(ctx, code);
         ctx.warnAtLocation(lwcError, sourceLocation(location), [code]);
     };
     // TODO [#3370]: remove experimental template expression flag
@@ -3972,11 +3980,13 @@ function parseClassNames(classNames) {
         .map((className) => className.trim())
         .filter((className) => className.length);
 }
-function isStaticNode(node) {
+function isStaticNode(node, apiVersion) {
     let result = true;
     const { name: nodeName, namespace = '', attributes, directives, properties } = node;
-    if (namespace !== shared.HTML_NAMESPACE) {
-        // TODO [#3313]: re-enable static optimization for SVGs once scope token is always lowercase
+    // SVG is excluded from static content optimization in older API versions due to issues with case sensitivity
+    // in CSS scope tokens. See https://github.com/salesforce/lwc/issues/3313
+    if (!shared.isAPIFeatureEnabled(0 /* APIFeature.LOWERCASE_SCOPE_TOKENS */, apiVersion) &&
+        namespace !== shared.HTML_NAMESPACE) {
         return false;
     }
     // it is an element
@@ -4031,7 +4041,9 @@ function collectStaticNodes(node, staticNodes, state) {
             collectStaticNodes(node.else, staticNodes, state);
         }
         nodeIsStatic =
-            isBaseElement(node) && !isCustomRendererHookRequired(node, state) && isStaticNode(node);
+            isBaseElement(node) &&
+                !isCustomRendererHookRequired(node, state) &&
+                isStaticNode(node, state.config.apiVersion);
     }
     if (nodeIsStatic && childrenAreStatic) {
         staticNodes.add(node);
@@ -5348,5 +5360,5 @@ function compile(source, config) {
 exports.compile = compile;
 exports.default = compile;
 exports.parse = parse;
-/** version: 2.50.0 */
+/** version: 3.0.0 */
 //# sourceMappingURL=index.cjs.js.map