@lwc/engine-core 2.38.1 → 2.39.0

package/package.json

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

package/types/framework/api.d.ts

@@ -21,9 +21,15 @@ declare function k(compilerKey: number, obj: any): string | void;
 declare function gid(id: string | undefined | null): string | null | undefined;
 declare function fid(url: string | undefined | null): string | null | undefined;
 /**
- * create a dynamic component via `<x-foo lwc:dynamic={Ctor}>`
+ * [ddc] - create a (deprecated) dynamic component via `<x-foo lwc:dynamic={Ctor}>`
+ *
+ * TODO [#3331]: remove usage of lwc:dynamic in 246
  */
-declare function dc(sel: string, Ctor: LightningElementConstructor | null | undefined, data: VElementData, children?: VNodes): VCustomElement | null;
+declare function ddc(sel: string, Ctor: LightningElementConstructor | null | undefined, data: VElementData, children?: VNodes): VCustomElement | null;
+/**
+ * [dc] - create a dynamic component via `<lwc:component lwc:is={Ctor}>`
+ */
+declare function dc(Ctor: LightningElementConstructor | null | undefined, data: VElementData, children?: VNodes): VCustomElement | null;
 export type SanitizeHtmlContentHook = (content: unknown) => string;
 /**
  * Sets the sanitizeHtmlContentHook.
@@ -49,6 +55,7 @@ declare const api: Readonly<{
     fid: typeof fid;
     shc: typeof shc;
     ssf: typeof ssf;
+    ddc: typeof ddc;
 }>;
 export default api;
 export type RenderAPI = typeof api;

package/types/framework/component.d.ts

@@ -3,15 +3,19 @@ import { VM } from './vm';
 import { LightningElementConstructor } from './base-lightning-element';
 import { Template } from './template';
 import { VNodes } from './vnodes';
+type ComponentConstructorMetadata = {
+    tmpl: Template;
+    sel: string;
+};
 /**
  * INTERNAL: This function can only be invoked by compiled code. The compiler
  * will prevent this function from being imported by userland code.
  */
-export declare function registerComponent(Ctor: any, { tmpl }: {
-    tmpl: Template;
-}): any;
+export declare function registerComponent(Ctor: any, metadata: ComponentConstructorMetadata): any;
 export declare function getComponentRegisteredTemplate(Ctor: LightningElementConstructor): Template | undefined;
+export declare function getComponentRegisteredName(Ctor: LightningElementConstructor): string | undefined;
 export declare function getTemplateReactiveObserver(vm: VM): ReactiveObserver;
 export declare function renderComponent(vm: VM): VNodes;
 export declare function markComponentAsDirty(vm: VM): void;
 export declare function getWrappedComponentsListener(vm: VM, listener: EventListener): EventListener;
+export {};

package/types/framework/hot-swaps.d.ts

@@ -6,7 +6,6 @@ export declare function getTemplateOrSwappedTemplate(tpl: Template): Template;
 export declare function getComponentOrSwappedComponent(Ctor: LightningElementConstructor): LightningElementConstructor;
 export declare function getStyleOrSwappedStyle(style: StylesheetFactory): StylesheetFactory;
 export declare function setActiveVM(vm: VM): void;
-export declare function removeActiveVM(vm: VM): void;
 export declare function swapTemplate(oldTpl: Template, newTpl: Template): boolean;
 export declare function swapComponent(oldComponent: LightningElementConstructor, newComponent: LightningElementConstructor): boolean;
 export declare function swapStyle(oldStyle: StylesheetFactory, newStyle: StylesheetFactory): boolean;

package/types/framework/vnodes.d.ts

@@ -87,6 +87,6 @@ export interface VElementData extends VNodeData {
 }
 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 isVCustomElement(vnode: VNode | VBaseElement): vnode is VCustomElement;
 export declare function isVFragment(vnode: VNode): vnode is VFragment;
 export declare function isVScopedSlotFragment(vnode: VNode): vnode is VScopedSlotFragment;

package/types/framework/weak-multimap.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A map where the keys are weakly held and the values are a Set that are also each weakly held.
+ * The goal is to avoid leaking the values, which is what would happen with a WeakMap<K, Set<V>>.
+ *
+ * Note that this is currently only intended to be used in dev/PRODDEBUG environments.
+ * It leaks in legacy browsers, which may be undesired.
+ */
+export interface WeakMultiMap<T extends object, V extends object> {
+    get(key: T): ReadonlySet<V>;
+    add(key: T, vm: V): void;
+    delete(key: T): void;
+}
+declare class LegacyWeakMultiMap<K extends object, V extends object> implements WeakMultiMap<K, V> {
+    private _map;
+    private _getValues;
+    get(key: K): ReadonlySet<V>;
+    add(key: K, vm: V): void;
+    delete(key: K): void;
+}
+declare class ModernWeakMultiMap<K extends object, V extends object> implements WeakMultiMap<K, V> {
+    private _map;
+    private _registry;
+    private _getWeakRefs;
+    get(key: K): ReadonlySet<V>;
+    add(key: K, value: V): void;
+    delete(key: K): void;
+}
+export declare const WeakMultiMap: typeof LegacyWeakMultiMap | typeof ModernWeakMultiMap;
+export {};