@lwc/engine-core 2.25.1 → 2.27.0

package/package.json

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

package/types/framework/api.d.ts

@@ -1,6 +1,7 @@
 import { SlotSet } from './vm';
 import { LightningElementConstructor } from './base-lightning-element';
-import { VNode, VNodes, VElement, VText, VCustomElement, VComment, VElementData, VStatic, Key, VFragment } from './vnodes';
+import { VNode, VNodes, VElement, VText, VCustomElement, VComment, VElementData, VStatic, Key, VFragment, VScopedSlotFragment } from './vnodes';
+declare function ssf(slotName: string, factory: (value: any) => VNodes): VScopedSlotFragment;
 declare function st(fragment: Element, key: Key): VStatic;
 declare function fr(key: Key, children: VNodes, stable: 0 | 1): VFragment;
 declare function h(sel: string, data: VElementData, children?: VNodes): VElement;
@@ -47,6 +48,7 @@ declare const api: Readonly<{
     gid: typeof gid;
     fid: typeof fid;
     shc: typeof shc;
+    ssf: typeof ssf;
 }>;
 export default api;
 export declare type RenderAPI = typeof api;

package/types/framework/main.d.ts

@@ -17,10 +17,9 @@ export { unwrap } from './membrane';
 export { sanitizeAttribute } from './secure-template';
 export { getComponentDef, isComponentConstructor } from './def';
 export { profilerControl as __unstable__ProfilerControl } from './profiler';
-export { getUpgradableConstructor } from './upgradable-element';
 export { swapTemplate, swapComponent, swapStyle } from './hot-swaps';
 export { setHooks } from './overridable-hooks';
 export { freezeTemplate } from './freeze-template';
 export { getComponentConstructor } from './get-component-constructor';
-export type { RendererAPI } from './renderer';
+export type { RendererAPI, LifecycleCallback } from './renderer';
 export type { ConfigValue as WireConfigValue, ContextValue as WireContextValue, DataCallback, WireAdapter, WireAdapterConstructor, WireAdapterSchemaValue, } from './wiring';

package/types/framework/renderer.d.ts

@@ -2,10 +2,10 @@ export declare type HostNode = any;
 export declare type HostElement = any;
 declare type N = HostNode;
 declare type E = HostElement;
+export declare type LifecycleCallback = (elm: E) => void;
 export interface RendererAPI {
     isNativeShadowDefined: boolean;
     isSyntheticShadowDefined: boolean;
-    HTMLElementExported: typeof HTMLElement;
     insert: (node: N, parent: E, anchor: N | null) => void;
     remove: (node: N, parent: E) => void;
     cloneNode: (node: N, deep: boolean) => N;
@@ -40,7 +40,6 @@ export interface RendererAPI {
     isConnected: (node: N) => boolean;
     insertStylesheet: (content: string, target?: ShadowRoot) => void;
     assertInstanceOfHTMLElement: (elm: any, msg: string) => void;
-    defineCustomElement: (name: string, constructor: CustomElementConstructor, options?: ElementDefinitionOptions) => void;
-    getCustomElement: (name: string) => CustomElementConstructor | undefined;
+    createCustomElement: (tagName: string, upgradeCallback: LifecycleCallback, connectedCallback: LifecycleCallback, disconnectedCallback: LifecycleCallback) => E;
 }
 export {};

package/types/framework/stylesheet.d.ts

@@ -23,6 +23,8 @@ export declare function getScopeTokenClass(owner: VM): string | null;
 /**
  * This function returns the host style token for a custom element if it
  * exists. Otherwise it returns null.
+ *
+ * A host style token is applied to the component if scoped styles are used.
  */
 export declare function getStylesheetTokenHost(vnode: VCustomElement): string | null;
 export declare function createStylesheet(vm: VM, stylesheets: string[]): VNode[] | null;

package/types/framework/template.d.ts

@@ -21,3 +21,4 @@ export declare function setVMBeingRendered(vm: VM | null): void;
 export declare const parseFragment: (strings: string[], ...keys: number[]) => () => Element;
 export declare const parseSVGFragment: (strings: string[], ...keys: number[]) => () => Element;
 export declare function evaluateTemplate(vm: VM, html: Template): VNodes;
+export declare function computeHasScopedStyles(template: Template): boolean;

package/types/framework/vm.d.ts

@@ -10,7 +10,10 @@ export interface TemplateCache {
     [key: string]: any;
 }
 export interface SlotSet {
-    [key: string]: VNodes;
+    slotAssignments: {
+        [key: string]: VNodes;
+    };
+    owner?: VM;
 }
 export declare const enum VMState {
     created = 0,
@@ -91,7 +94,8 @@ export interface VM<N = HostNode, E = HostElement> {
     cmpProps: {
         [name: string]: any;
     };
-    /** The mapping between the slot names and the slotted VNodes. */
+    /** Contains information about the mapping between the slot names and the slotted VNodes, and
+     *  the owner of the slot content. */
     cmpSlots: SlotSet;
     /** The component internal reactive properties. */
     cmpFields: {

package/types/framework/vnodes.d.ts

@@ -7,9 +7,10 @@ export declare const enum VNodeType {
     Element = 2,
     CustomElement = 3,
     Static = 4,
-    Fragment = 5
+    Fragment = 5,
+    ScopedSlotFragment = 6
 }
-export declare type VNode = VText | VComment | VElement | VCustomElement | VStatic | VFragment;
+export declare type VNode = VText | VComment | VElement | VCustomElement | VStatic | VFragment | VScopedSlotFragment;
 export declare type VParentElement = VElement | VCustomElement | VFragment;
 export declare type VNodes = Readonly<Array<VNode | null>>;
 export interface BaseVParent {
@@ -22,6 +23,11 @@ export interface BaseVNode {
     key: Key | undefined;
     owner: VM;
 }
+export interface VScopedSlotFragment extends BaseVNode {
+    factory: (value: any) => VNodes;
+    type: VNodeType.ScopedSlotFragment;
+    slotName: string;
+}
 export interface VStatic extends BaseVNode {
     type: VNodeType.Static;
     sel: undefined;
@@ -77,7 +83,9 @@ export interface VNodeData {
 export interface VElementData extends VNodeData {
     readonly key: Key;
     readonly ref?: string;
+    readonly slotData?: any;
 }
 export declare function isVBaseElement(vnode: VNode): vnode is VElement | VCustomElement;
 export declare function isSameVnode(vnode1: VNode, vnode2: VNode): boolean;
 export declare function isVCustomElement(vnode: VBaseElement): vnode is VCustomElement;
+export declare function isVScopedSlotFragment(vnode: VNode): vnode is VScopedSlotFragment;

package/types/framework/upgradable-element.d.ts

@@ -1,7 +0,0 @@
-import type { RendererAPI } from './renderer';
-declare type UpgradeCallback = (elm: HTMLElement) => void;
-interface UpgradableCustomElementConstructor extends CustomElementConstructor {
-    new (upgradeCallback?: UpgradeCallback): HTMLElement;
-}
-export declare function getUpgradableConstructor(tagName: string, renderer: RendererAPI): CustomElementConstructor | UpgradableCustomElementConstructor;
-export {};