@lwc/template-compiler 2.15.0 → 2.18.0

package/dist/types/codegen/helpers.d.ts

@@ -1,5 +1,6 @@
 import * as t from '../shared/estree';
 import { ChildNode, Node, Root } from '../shared/types';
+import State from '../state';
 import CodeGen from './codegen';
 export declare function identifierFromComponentName(name: string): t.Identifier;
 export declare function getMemberExpressionRoot(expression: t.MemberExpression): t.Identifier;
@@ -25,4 +26,4 @@ export declare function styleMapToStyleDeclsAST(styleMap: {
     [name: string]: string;
 }): t.ArrayExpression;
 export declare function parseClassNames(classNames: string): string[];
-export declare function getStaticNodes(root: Root): Set<ChildNode>;
+export declare function getStaticNodes(root: Root, state: State): Set<ChildNode>;

package/dist/types/codegen/index.d.ts

@@ -1,3 +1,3 @@
-import { NormalizedConfig } from '../config';
 import { Root } from '../shared/types';
-export default function (root: Root, config: NormalizedConfig): string;
+import State from '../state';
+export default function (root: Root, state: State): string;

package/dist/types/config.d.ts

@@ -1,4 +1,9 @@
+import { CustomRendererConfig } from './shared/renderer-hooks';
 export interface Config {
+    /**
+     * Specification to use to determine which nodes in the template require custom renderer hooks.
+     */
+    customRendererConfig?: CustomRendererConfig;
     /**
      * Enable computed member expression in the template. eg:
      *    <template>
@@ -15,9 +20,9 @@ export interface Config {
      */
     preserveHtmlComments?: boolean;
     /**
-     * When true, the template compiler will not generate optimized code for static content.
+     * When false, the template compiler will not generate optimized code for static content.
      */
-    disableStaticContentOptimization?: boolean;
+    enableStaticContentOptimization?: boolean;
 }
-export declare type NormalizedConfig = Required<Config>;
+export declare type NormalizedConfig = Required<Omit<Config, 'customRendererConfig'>> & Partial<Pick<Config, 'customRendererConfig'>>;
 export declare function normalizeConfig(config: Config): NormalizedConfig;

package/dist/types/index.d.ts

@@ -1,6 +1,7 @@
 import { Config } from './config';
 import { TemplateCompileResult, TemplateParseResult } from './shared/types';
 export * from './shared/types';
+export { CustomRendererConfig, CustomRendererElementConfig } from './shared/renderer-hooks';
 export { Config } from './config';
 export declare function parse(source: string, config?: Config): TemplateParseResult;
 export default function compile(source: string, config: Config): TemplateCompileResult;

package/dist/types/parser/constants.d.ts

@@ -20,7 +20,6 @@ export declare const DATA_RE: RegExp;
 export declare const SUPPORTED_SVG_TAGS: Set<string>;
 export declare const DISALLOWED_MATHML_TAGS: Set<string>;
 export declare const VOID_ELEMENT_SET: Set<string>;
-export declare const DASHED_TAGNAME_ELEMENT_SET: Set<string>;
 export declare const ATTRS_PROPS_TRANFORMS: {
     [name: string]: string;
 };
@@ -32,6 +31,18 @@ export declare const KNOWN_HTML_ELEMENTS: Set<string>;
 export declare const HTML_TAG: {
     A: string;
     AREA: string;
+    BODY: string;
+    CAPTION: string;
+    COL: string;
+    COLGROUP: string;
+    HEAD: string;
+    HTML: string;
+    TBODY: string;
+    TD: string;
+    TFOOT: string;
+    TH: string;
+    THEAD: string;
+    TR: string;
     USE: string;
 };
 export declare const ATTR_NAME: {
@@ -39,3 +50,4 @@ export declare const ATTR_NAME: {
     XLINK_HREF: string;
 };
 export declare const TEMPLATE_DIRECTIVES: RegExp[];
+export declare const TAGS_THAT_CANNOT_BE_PARSED_AS_TOP_LEVEL: Set<string>;

package/dist/types/parser/tag.d.ts

@@ -0,0 +1,2 @@
+import { BaseElement } from '../shared/types';
+export declare function isUnsafeTopLevelSerializableElement(element: BaseElement): boolean;

package/dist/types/shared/constants.d.ts

@@ -1,9 +1,11 @@
 export declare const SECURE_REGISTER_TEMPLATE_METHOD_NAME = "registerTemplate";
 export declare const PARSE_FRAGMENT_METHOD_NAME = "parseFragment";
 export declare const PARSE_SVG_FRAGMENT_METHOD_NAME = "parseSVGFragment";
+export declare const RENDERER = "renderer";
 export declare const LWC_MODULE_NAME = "lwc";
 export declare const TEMPLATE_MODULES_PARAMETER: string;
 export declare const TEMPLATE_FUNCTION_NAME: string;
 export declare const TEMPLATE_PARAMS: {
     [label: string]: string;
 };
+export declare const DASHED_TAGNAME_ELEMENT_SET: Set<string>;

package/dist/types/shared/renderer-hooks.d.ts

@@ -0,0 +1,43 @@
+import State from '../state';
+import { BaseElement, ElementDirective } from './types';
+/**
+ * Config representing criteria for an element match.
+ * All conditions specified must be satisfied to be considered a match.
+ */
+export interface CustomRendererElementConfig {
+    /**
+     * Tag name to use to match an element.
+     */
+    tagName: string;
+    /**
+     * Optional namespace to match an element.
+     */
+    namespace?: string;
+    /**
+     * Specify attributes that need to be matched.
+     * This field is optional.
+     * If undefined or empty, attribute matching is skipped.
+     */
+    attributes?: string[];
+}
+/**
+ * Config to specify which elements and directives require a customizable renderer.
+ * An element is qualified if it matches the CustomRendererElementConfig OR the directives.
+ */
+export interface CustomRendererConfig {
+    /**
+     * Element matching criteria. Element much satisfy all conditions of the CustomRendererElementConfig
+     */
+    elements: CustomRendererElementConfig[];
+    /**
+     * List of lwc directives that qualify an element. An element must use at least 1
+     * directive to be considered a match.
+     * If empty, elements matching is not done based on directives.
+     */
+    directives: string[];
+}
+/**
+ * Mapping of Directive.name to string literals used in template
+ */
+export declare const LWC_DIRECTIVES: Record<ElementDirective['name'], string>;
+export declare function isCustomRendererHookRequired(element: BaseElement, state: State): boolean;

package/dist/types/shared/utils.d.ts

@@ -1 +1,7 @@
 export declare function toPropertyName(attr: string): string;
+/**
+ * Test if given tag name is a custom element.
+ * @param tagName element tag name to test
+ * @returns true if given tag name represents a custom element, false otherwise.
+ */
+export declare function isCustomElementTag(tagName: string): boolean;

package/dist/types/state.d.ts

@@ -1,5 +1,23 @@
 import { NormalizedConfig } from './config';
+import { BaseElement } from './shared/types';
 export default class State {
     config: NormalizedConfig;
+    /**
+     * Look up custom renderer config by tag name.
+     */
+    crElmToConfigMap: {
+        [tagName: string]: {
+            namespace: string | undefined;
+            attributes: Set<string>;
+        };
+    };
+    /**
+     * Look up for directives that require custom renderer
+     */
+    crDirectives: Set<string>;
+    /**
+     * Cache the result of elements that have already been checked if they require custom renderer
+     */
+    crCheckedElements: Map<BaseElement, boolean>;
     constructor(config: NormalizedConfig);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lwc/template-compiler",
-    "version": "2.15.0",
+    "version": "2.18.0",
     "description": "Template compiler package",
     "homepage": "https://lwc.dev/",
     "repository": {
@@ -26,8 +26,8 @@
     },
     "//": "Currently can't upgrade estree-walker to v3.0.0 because it dropped CommonJS support: https://git.io/JXguS",
     "dependencies": {
-        "@lwc/errors": "2.15.0",
-        "@lwc/shared": "2.15.0",
+        "@lwc/errors": "2.18.0",
+        "@lwc/shared": "2.18.0",
         "acorn": "~8.7.1",
         "astring": "~1.8.3",
         "estree-walker": "~2.0.2",