@lwc/engine-core 2.7.3 → 2.7.4

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lwc/engine-core",
-    "version": "2.7.3",
+    "version": "2.7.4",
     "description": "Core LWC engine APIs.",
     "homepage": "https://lwc.dev/",
     "repository": {
@@ -24,8 +24,8 @@
         "types/"
     ],
     "dependencies": {
-        "@lwc/features": "2.7.3",
-        "@lwc/shared": "2.7.3"
+        "@lwc/features": "2.7.4",
+        "@lwc/shared": "2.7.4"
     },
     "devDependencies": {
         "observable-membrane": "2.0.0"
@@ -33,5 +33,5 @@
     "publishConfig": {
         "access": "public"
     },
-    "gitHead": "392d6a92b3a15a24b686024f3c4d0c6bdabc2b8e"
+    "gitHead": "df4eda8be794fa5f7a01148c137eea4e546a0844"
 }

package/types/framework/api.d.ts

@@ -1,6 +1,6 @@
 import { SlotSet } from './vm';
-import { VNode, VNodes, VElement, VText, VCustomElement, VComment, VElementData } from '../3rdparty/snabbdom/types';
 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 ti(value: any): number;
 declare function s(slotName: string, data: VElementData, children: VNodes, slotset: SlotSet | undefined): VElement | VNodes;

package/types/framework/component.d.ts

@@ -1,8 +1,8 @@
 import { VM } from './vm';
-import { VNodes } from '../3rdparty/snabbdom/types';
 import { ReactiveObserver } from '../libs/mutation-tracker';
 import { LightningElementConstructor } from './base-lightning-element';
 import { Template } from './template';
+import { VNodes } from './vnodes';
 /**
  * INTERNAL: This function can only be invoked by compiled code. The compiler
  * will prevent this function from being imported by userland code.

package/types/framework/def.d.ts

@@ -34,6 +34,7 @@ export interface ComponentDef {
  */
 export declare function isComponentConstructor(ctor: unknown): ctor is LightningElementConstructor;
 export declare function getComponentInternalDef(Ctor: unknown): ComponentDef;
+export declare function getComponentHtmlPrototype(Ctor: unknown): HTMLElementConstructor;
 declare const enum PropDefType {
     any = "any"
 }

package/types/framework/hydration.d.ts

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

package/types/framework/invoker.d.ts

@@ -1,6 +1,6 @@
 import { VM } from './vm';
 import { LightningElement, LightningElementConstructor } from './base-lightning-element';
-import { VNodes } from '../3rdparty/snabbdom/types';
+import { VNodes } from './vnodes';
 export declare let isInvokingRender: boolean;
 export declare let vmBeingConstructed: VM | null;
 export declare function isBeingConstructed(vm: VM): boolean;

package/types/framework/main.d.ts

@@ -6,7 +6,7 @@ export { default as track } from './decorators/track';
 export { default as wire } from './decorators/wire';
 export { readonly } from './readonly';
 export { setFeatureFlag, setFeatureFlagForTest } from '@lwc/features';
-export { getComponentInternalDef } from './def';
+export { getComponentHtmlPrototype } from './def';
 export { createVM, connectRootElement, disconnectRootElement, getAssociatedVMIfPresent, hydrateRootElement, } from './vm';
 export { registerComponent } from './component';
 export { registerTemplate } from './secure-template';

package/types/framework/modules/attrs.d.ts

@@ -1,2 +1,2 @@
-import { VElement } from '../../3rdparty/snabbdom/types';
-export declare function patchAttributes(oldVnode: VElement | null, vnode: VElement): void;
+import { VBaseElement } from '../vnodes';
+export declare function patchAttributes(oldVnode: VBaseElement | null, vnode: VBaseElement): void;

package/types/framework/modules/computed-class-attr.d.ts

@@ -1,2 +1,2 @@
-import { VElement } from '../../3rdparty/snabbdom/types';
-export declare function patchClassAttribute(oldVnode: VElement | null, vnode: VElement): void;
+import { VBaseElement } from '../vnodes';
+export declare function patchClassAttribute(oldVnode: VBaseElement | null, vnode: VBaseElement): void;

package/types/framework/modules/computed-style-attr.d.ts

@@ -1,2 +1,2 @@
-import { VElement } from '../../3rdparty/snabbdom/types';
-export declare function patchStyleAttribute(oldVnode: VElement | null, vnode: VElement): void;
+import { VBaseElement } from '../vnodes';
+export declare function patchStyleAttribute(oldVnode: VBaseElement | null, vnode: VBaseElement): void;

package/types/framework/modules/events.d.ts

@@ -1,2 +1,2 @@
-import { VElement } from '../../3rdparty/snabbdom/types';
-export declare function applyEventListeners(vnode: VElement): void;
+import { VBaseElement } from '../vnodes';
+export declare function applyEventListeners(vnode: VBaseElement): void;

package/types/framework/modules/props.d.ts

@@ -1,2 +1,2 @@
-import { VElement } from '../../3rdparty/snabbdom/types';
-export declare function patchProps(oldVnode: VElement | null, vnode: VElement): void;
+import { VBaseElement } from '../vnodes';
+export declare function patchProps(oldVnode: VBaseElement | null, vnode: VBaseElement): void;

package/types/framework/modules/static-class-attr.d.ts

@@ -1,2 +1,2 @@
-import { VElement } from '../../3rdparty/snabbdom/types';
-export declare function applyStaticClassAttribute(vnode: VElement): void;
+import { VBaseElement } from '../vnodes';
+export declare function applyStaticClassAttribute(vnode: VBaseElement): void;

package/types/framework/modules/static-style-attr.d.ts

@@ -1,2 +1,2 @@
-import { VElement } from '../../3rdparty/snabbdom/types';
-export declare function applyStaticStyleAttribute(vnode: VElement): void;
+import { VBaseElement } from '../vnodes';
+export declare function applyStaticStyleAttribute(vnode: VBaseElement): void;

package/types/framework/rendering.d.ts

@@ -0,0 +1,9 @@
+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;
+export declare function allocateChildren(vnode: VCustomElement, vm: VM): void;
+export declare function markAsDynamicChildren(children: VNodes): void;

package/types/framework/services.d.ts

@@ -1,6 +1,6 @@
-import { VNodeData } from '../3rdparty/snabbdom/types';
 import { ComponentDef } from './def';
 import { VM, Context } from './vm';
+import { VNodeData } from './vnodes';
 declare type ServiceCallback = (component: object, data: VNodeData, def: ComponentDef, context: Context) => void;
 interface ServiceDef {
     connected?: ServiceCallback;

package/types/framework/stylesheet.d.ts

@@ -1,6 +1,6 @@
-import { VNode } from '../3rdparty/snabbdom/types';
 import { VM } from './vm';
 import { Template } from './template';
+import { VNode } from './vnodes';
 /**
  * Function producing style based on a host and a shadow selector. This function is invoked by
  * the engine with different values depending on the mode that the component is running on.

package/types/framework/template.d.ts

@@ -1,7 +1,7 @@
-import { VNode, VNodes } from '../3rdparty/snabbdom/types';
 import { RenderAPI } from './api';
 import { SlotSet, TemplateCache, VM } from './vm';
 import { TemplateStylesheetFactories } from './stylesheet';
+import { VNode, VNodes } from './vnodes';
 export interface Template {
     (api: RenderAPI, cmp: object, slotSet: SlotSet, cache: TemplateCache): VNodes;
     /** The list of slot names used in the template. */

package/types/framework/vm.d.ts

@@ -1,10 +1,10 @@
 import type { HostNode, HostElement } from '../renderer';
 import { Template } from './template';
 import { ComponentDef } from './def';
-import { LightningElement } from './base-lightning-element';
+import { LightningElement, LightningElementConstructor } from './base-lightning-element';
 import { ReactiveObserver } from './mutation-tracker';
 import { AccessorReactiveObserver } from './decorators/api';
-import { VNodes, VCustomElement, VNode } from '../3rdparty/snabbdom/types';
+import { VNodes, VCustomElement, VNode } from './vnodes';
 declare type ShadowRootMode = 'open' | 'closed';
 export interface TemplateCache {
     [key: string]: any;
@@ -29,6 +29,9 @@ export declare const enum ShadowSupportMode {
     Any = "any",
     Default = "reset"
 }
+export declare const enum LwcDomMode {
+    Manual = "manual"
+}
 export interface Context {
     /** The string used for synthetic shadow DOM and light DOM style scoping. */
     stylesheetToken: string | undefined;
@@ -96,7 +99,10 @@ export interface VM<N = HostNode, E = HostElement> {
     /** The component instance. */
     component: LightningElement;
     /** The custom element shadow root. */
-    cmpRoot: ShadowRoot | null;
+    shadowRoot: ShadowRoot | null;
+    /** The component render root. If the component is a shadow DOM component, it is its shadow
+     * root. If the component is a light DOM component it the element itself. */
+    renderRoot: ShadowRoot | HostElement;
     /** The template reactive observer. */
     tro: ReactiveObserver;
     /** The accessor reactive observers. Is only used when the ENABLE_REACTIVE_SETTER feature flag
@@ -122,7 +128,7 @@ export declare function disconnectRootElement(elm: any): void;
 export declare function appendVM(vm: VM): void;
 export declare function hydrateVM(vm: VM): void;
 export declare function removeVM(vm: VM): void;
-export declare function createVM<HostNode, HostElement>(elm: HostElement, def: ComponentDef, options: {
+export declare function createVM<HostNode, HostElement>(elm: HostElement, ctor: LightningElementConstructor, options: {
     mode: ShadowRootMode;
     owner: VM<HostNode, HostElement> | null;
     tagName: string;
@@ -135,5 +141,4 @@ export declare function resetComponentRoot(vm: VM): void;
 export declare function scheduleRehydration(vm: VM): void;
 export declare function runWithBoundaryProtection(vm: VM, owner: VM | null, pre: () => void, job: () => void, post: () => void): void;
 export declare function forceRehydration(vm: VM): void;
-export declare function getRenderRoot(vm: VM): ShadowRoot | HostElement;
 export {};

package/types/{3rdparty/snabbdom/types.d.ts → framework/vnodes.d.ts}

@@ -1,51 +1,50 @@
-/**
- @license
- Copyright (c) 2015 Simon Friis Vindum.
- This code may only be used under the MIT License found at
- https://github.com/snabbdom/snabbdom/blob/master/LICENSE
- Code distributed by Snabbdom as part of the Snabbdom project at
- https://github.com/snabbdom/snabbdom/
- */
-import { VM } from '../../framework/vm';
+import { VM } from './vm';
 export declare type Key = string | number;
+export declare const enum VNodeType {
+    Text = 0,
+    Comment = 1,
+    Element = 2,
+    CustomElement = 3
+}
+export declare type VNode = VText | VComment | VElement | VCustomElement;
+export declare type VParentElement = VElement | VCustomElement;
 export declare type VNodes = Array<VNode | null>;
-export interface VNode {
-    sel: string | undefined;
-    data: VNodeData;
-    children: VNodes | undefined;
+export interface BaseVNode {
+    type: VNodeType;
     elm: Node | undefined;
-    parentElm?: Element;
-    text: string | undefined;
+    sel: string | undefined;
     key: Key | undefined;
     hook: Hooks<any>;
     owner: VM;
 }
-export interface VElement extends VNode {
+export interface VText extends BaseVNode {
+    type: VNodeType.Text;
+    sel: undefined;
+    text: string;
+    key: undefined;
+}
+export interface VComment extends BaseVNode {
+    type: VNodeType.Comment;
+    sel: undefined;
+    text: string;
+    key: undefined;
+}
+export interface VBaseElement extends BaseVNode {
     sel: string;
     data: VElementData;
     children: VNodes;
     elm: Element | undefined;
-    text: undefined;
     key: Key;
 }
-export interface VCustomElement extends VElement {
+export interface VElement extends VBaseElement {
+    type: VNodeType.Element;
+}
+export interface VCustomElement extends VBaseElement {
+    type: VNodeType.CustomElement;
     mode: 'closed' | 'open';
     ctor: any;
     aChildren?: VNodes;
 }
-export interface VText extends VNode {
-    sel: undefined;
-    children: undefined;
-    elm: Node | undefined;
-    text: string;
-    key: undefined;
-}
-export interface VComment extends VNode {
-    sel: undefined;
-    children: undefined;
-    text: string;
-    key: undefined;
-}
 export interface VNodeData {
     props?: Record<string, any>;
     attrs?: Record<string, string | number | boolean>;
@@ -66,5 +65,6 @@ export interface Hooks<N extends VNode> {
     move: (vNode: N, parentNode: Node, referenceNode: Node | null) => void;
     update: (oldVNode: N, vNode: N) => void;
     remove: (vNode: N, parentNode: Node) => void;
-    hydrate: (vNode: N, node: Node) => void;
 }
+export declare function isVBaseElement(vnode: VNode): vnode is VElement | VCustomElement;
+export declare function isSameVnode(vnode1: VNode, vnode2: VNode): boolean;

package/types/3rdparty/snabbdom/snabbdom.d.ts

@@ -1,11 +0,0 @@
-/**
-@license
-Copyright (c) 2015 Simon Friis Vindum.
-This code may only be used under the MIT License found at
-https://github.com/snabbdom/snabbdom/blob/master/LICENSE
-Code distributed by Snabbdom as part of the Snabbdom project at
-https://github.com/snabbdom/snabbdom/
-*/
-import { VNodes } from './types';
-export declare function updateDynamicChildren(parentElm: Node, oldCh: VNodes, newCh: VNodes): void;
-export declare function updateStaticChildren(parentElm: Node, oldCh: VNodes, newCh: VNodes): void;

package/types/framework/hooks.d.ts

@@ -1,18 +0,0 @@
-import { VM } from './vm';
-import { VNode, VCustomElement, VElement, VNodes } from '../3rdparty/snabbdom/types';
-export declare function updateNodeHook(oldVnode: VNode, vnode: VNode): void;
-export declare function insertNodeHook(vnode: VNode, parentNode: Node, referenceNode: Node | null): void;
-export declare function removeNodeHook(vnode: VNode, parentNode: Node): void;
-export declare function patchElementPropsAndAttrs(oldVnode: VElement | null, vnode: VElement): void;
-export declare const enum LWCDOMMode {
-    manual = "manual"
-}
-export declare function hydrateElmHook(vnode: VElement): void;
-export declare function fallbackElmHook(elm: Element, vnode: VElement): void;
-export declare function patchChildren(parent: ParentNode, oldCh: VNodes, newCh: VNodes): void;
-export declare function allocateChildrenHook(vnode: VCustomElement, vm: VM): void;
-export declare function createViewModelHook(elm: HTMLElement, vnode: VCustomElement): void;
-export declare function createChildrenHook(vnode: VElement): void;
-export declare function hydrateChildrenHook(elmChildren: NodeListOf<ChildNode>, children: VNodes, vm?: VM): void;
-export declare function removeElmHook(vnode: VElement): void;
-export declare function markAsDynamicChildren(children: VNodes): void;