@lwc/engine-core 2.8.0 → 2.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lwc/engine-core",
-    "version": "2.8.0",
+    "version": "2.11.0",
     "description": "Core LWC engine APIs.",
     "homepage": "https://lwc.dev/",
     "repository": {
@@ -24,8 +24,8 @@
         "types/"
     ],
     "dependencies": {
-        "@lwc/features": "2.8.0",
-        "@lwc/shared": "2.8.0"
+        "@lwc/features": "2.11.0",
+        "@lwc/shared": "2.11.0"
     },
     "devDependencies": {
         "observable-membrane": "2.0.0"

package/types/framework/api.d.ts

@@ -1,7 +1,7 @@
 import { SlotSet } from './vm';
 import { LightningElementConstructor } from './base-lightning-element';
 import { VNode, VNodes, VElement, VText, VCustomElement, VComment, VElementData } from './vnodes';
-declare function h(sel: string, data: VElementData, children: VNodes): VElement;
+declare function h(sel: string, data: VElementData, children?: VNodes): VElement;
 declare function ti(value: any): number;
 declare function s(slotName: string, data: VElementData, children: VNodes, slotset: SlotSet | undefined): VElement | VNodes;
 declare function c(sel: string, Ctor: LightningElementConstructor, data: VElementData, children?: VNodes): VCustomElement;
@@ -9,7 +9,7 @@ declare function i(iterable: Iterable<any>, factory: (value: any, index: number,
 /**
  * [f]lattening
  */
-declare function f(items: any[]): any[];
+declare function f(items: Readonly<Array<Readonly<Array<VNodes>> | VNodes>>): VNodes;
 declare function t(text: string): VText;
 declare function co(text: string): VComment;
 declare function d(value: any): string;

package/types/framework/check-version-mismatch.d.ts

@@ -0,0 +1,11 @@
+import { Template } from './template';
+import { StylesheetFactory } from './stylesheet';
+import { LightningElementConstructor } from './base-lightning-element';
+/**
+ * Validate a template, stylesheet, or component to make sure that its compiled version matches
+ * the version used by the LWC engine at runtime. Note that this only works in dev mode because
+ * it relies on code comments, which are stripped in production due to minification.
+ */
+export declare function checkVersionMismatch(func: Template, type: 'template'): void;
+export declare function checkVersionMismatch(func: StylesheetFactory, type: 'stylesheet'): void;
+export declare function checkVersionMismatch(func: LightningElementConstructor, type: 'component'): void;

package/types/framework/hydration.d.ts

@@ -1,3 +1,3 @@
 import { VM } from './vm';
 import { VNodes } from './vnodes';
-export declare function hydrateChildren(elmChildren: NodeListOf<ChildNode>, children: VNodes, vm: VM): void;
+export declare function hydrateChildren(elmChildren: NodeList, children: VNodes, vm: VM): void;

package/types/framework/rendering.d.ts

@@ -1,9 +1,5 @@
 import { VM } from './vm';
-import { VNodes, VCustomElement, VElement, VText, VComment, Hooks } from './vnodes';
-export declare const TextHook: Hooks<VText>;
-export declare const CommentHook: Hooks<VComment>;
-export declare const ElementHook: Hooks<VElement>;
-export declare const CustomElementHook: Hooks<VCustomElement>;
-export declare function patchChildren(parent: ParentNode, oldCh: VNodes, newCh: VNodes): void;
+import { VNodes, VCustomElement } from './vnodes';
+export declare function patchChildren(c1: VNodes, c2: VNodes, parent: ParentNode): void;
 export declare function allocateChildren(vnode: VCustomElement, vm: VM): void;
 export declare function markAsDynamicChildren(children: VNodes): void;

package/types/framework/template.d.ts

@@ -1,7 +1,7 @@
 import { RenderAPI } from './api';
 import { SlotSet, TemplateCache, VM } from './vm';
 import { TemplateStylesheetFactories } from './stylesheet';
-import { VNode, VNodes } from './vnodes';
+import { VNodes } from './vnodes';
 export interface Template {
     (api: RenderAPI, cmp: object, slotSet: SlotSet, cache: TemplateCache): VNodes;
     /** The list of slot names used in the template. */
@@ -16,4 +16,4 @@ export interface Template {
 export declare let isUpdatingTemplate: boolean;
 export declare function getVMBeingRendered(): VM | null;
 export declare function setVMBeingRendered(vm: VM | null): void;
-export declare function evaluateTemplate(vm: VM, html: Template): Array<VNode | null>;
+export declare function evaluateTemplate(vm: VM, html: Template): VNodes;

package/types/framework/utils.d.ts

@@ -1,3 +1,4 @@
+import { StylesheetFactory, TemplateStylesheetFactories } from './stylesheet';
 declare type Callback = () => void;
 export declare const SPACE_CHAR = 32;
 export declare const EmptyObject: any;
@@ -7,4 +8,10 @@ export declare function guid(): string;
 export declare function parseStyleText(cssText: string): {
     [name: string]: string;
 };
+export declare function cloneAndOmitKey(object: {
+    [key: string]: any;
+}, keyToOmit: string): {
+    [key: string]: any;
+};
+export declare function flattenStylesheets(stylesheets: TemplateStylesheetFactories): StylesheetFactory[];
 export {};

package/types/framework/vnodes.d.ts

@@ -8,13 +8,12 @@ export declare const enum VNodeType {
 }
 export declare type VNode = VText | VComment | VElement | VCustomElement;
 export declare type VParentElement = VElement | VCustomElement;
-export declare type VNodes = Array<VNode | null>;
+export declare type VNodes = Readonly<Array<VNode | null>>;
 export interface BaseVNode {
     type: VNodeType;
     elm: Node | undefined;
     sel: string | undefined;
     key: Key | undefined;
-    hook: Hooks<any>;
     owner: VM;
 }
 export interface VText extends BaseVNode {
@@ -43,28 +42,22 @@ export interface VCustomElement extends VBaseElement {
     type: VNodeType.CustomElement;
     mode: 'closed' | 'open';
     ctor: any;
-    aChildren?: VNodes;
+    aChildren: VNodes | undefined;
+    vm: VM | undefined;
 }
 export interface VNodeData {
-    props?: Record<string, any>;
-    attrs?: Record<string, string | number | boolean>;
-    className?: string;
-    style?: string;
-    classMap?: Record<string, boolean>;
-    styleDecls?: Array<[string, string, boolean]>;
-    context?: Record<string, Record<string, any>>;
-    on?: Record<string, (event: Event) => any>;
-    svg?: boolean;
+    readonly props?: Readonly<Record<string, any>>;
+    readonly attrs?: Readonly<Record<string, string | number | boolean>>;
+    readonly className?: string;
+    readonly style?: string;
+    readonly classMap?: Readonly<Record<string, boolean>>;
+    readonly styleDecls?: Readonly<Array<[string, string, boolean]>>;
+    readonly context?: Readonly<Record<string, Readonly<Record<string, any>>>>;
+    readonly on?: Readonly<Record<string, (event: Event) => any>>;
+    readonly svg?: boolean;
 }
 export interface VElementData extends VNodeData {
-    key: Key;
-}
-export interface Hooks<N extends VNode> {
-    create: (vNode: N) => void;
-    insert: (vNode: N, parentNode: Node, referenceNode: Node | null) => void;
-    move: (vNode: N, parentNode: Node, referenceNode: Node | null) => void;
-    update: (oldVNode: N, vNode: N) => void;
-    remove: (vNode: N, parentNode: Node) => void;
+    readonly key: Key;
 }
 export declare function isVBaseElement(vnode: VNode): vnode is VElement | VCustomElement;
 export declare function isSameVnode(vnode1: VNode, vnode2: VNode): boolean;

package/types/renderer.d.ts

@@ -108,7 +108,7 @@ export declare function setIsConnected(isConnectedImpl: isConnectedFunc): void;
 declare type insertGlobalStylesheetFunc = (content: string) => void;
 export declare let insertGlobalStylesheet: insertGlobalStylesheetFunc;
 export declare function setInsertGlobalStylesheet(insertGlobalStylesheetImpl: insertGlobalStylesheetFunc): void;
-declare type insertStylesheetFunc = (content: string, target: N) => void;
+declare type insertStylesheetFunc = (content: string, target: ShadowRoot) => void;
 export declare let insertStylesheet: insertStylesheetFunc;
 export declare function setInsertStylesheet(insertStylesheetImpl: insertStylesheetFunc): void;
 declare type assertInstanceOfHTMLElementFunc = (elm: any, msg: string) => void;