@lwc/engine-core 6.3.3 → 6.4.0

package/dist/framework/api.d.ts

@@ -1,9 +1,9 @@
 import { SlotSet } from './vm';
 import { LightningElementConstructor } from './base-lightning-element';
-import { Key, VComment, VCustomElement, VElement, VElementData, VFragment, VNode, VNodes, VScopedSlotFragment, VStatic, VText, VStaticPart, VStaticPartData } from './vnodes';
-declare function sp(partId: number, data: VStaticPartData): VStaticPart;
+import { Key, VComment, VCustomElement, VElement, VElementData, VFragment, VNode, VNodes, VScopedSlotFragment, VStatic, VStaticPart, VStaticPartData, VText } from './vnodes';
+declare function sp(partId: number, data: VStaticPartData | null, text: string | null): VStaticPart;
 declare function ssf(slotName: unknown, factory: (value: any, key: any) => VFragment): VScopedSlotFragment;
-declare function st(fragment: Element, key: Key, parts?: VStaticPart[]): VStatic;
+declare function st(fragmentFactory: (parts?: VStaticPart[]) => Element, key: Key, parts?: VStaticPart[]): VStatic;
 declare function fr(key: Key, children: VNodes, stable: 0 | 1): VFragment;
 declare function h(sel: string, data: VElementData, children?: VNodes): VElement;
 declare function ti(value: any): number;

package/dist/framework/main.d.ts

@@ -19,6 +19,7 @@ export { shouldBeFormAssociated } from './utils';
 export { getComponentConstructor } from './get-component-constructor';
 export type { RendererAPI, LifecycleCallback } from './renderer';
 export type { ConfigValue as WireConfigValue, ContextValue as WireContextValue, DataCallback, WireAdapter, WireAdapterConstructor, WireAdapterSchemaValue, WireContextSubscriptionPayload, WireContextSubscriptionCallback, } from './wiring';
+export type { FormRestoreState, FormRestoreReason } from './vm';
 export { LightningElement } from './base-lightning-element';
 export { default as api } from './decorators/api';
 export { default as track } from './decorators/track';

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

@@ -1,4 +1,4 @@
 import { RendererAPI } from '../renderer';
-import { VBaseElement, VStatic } from '../vnodes';
-export declare function patchAttributes(oldVnode: VBaseElement | null, vnode: VBaseElement, renderer: RendererAPI): void;
+import { VBaseElement, VStatic, VStaticPartElement } from '../vnodes';
+export declare function patchAttributes(oldVnode: VBaseElement | VStaticPartElement | null, vnode: VBaseElement | VStaticPartElement, renderer: RendererAPI): void;
 export declare function patchSlotAssignment(oldVnode: VBaseElement | VStatic | null, vnode: VBaseElement | VStatic, renderer: RendererAPI): void;

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

@@ -1,3 +1,4 @@
 import { RendererAPI } from '../renderer';
-import { VBaseElement } from '../vnodes';
-export declare function patchClassAttribute(oldVnode: VBaseElement | null, vnode: VBaseElement, renderer: RendererAPI): void;
+import { VBaseElement, VStaticPartElement } from '../vnodes';
+export declare function getMapFromClassName(className: string | undefined): Record<string, boolean>;
+export declare function patchClassAttribute(oldVnode: VBaseElement | VStaticPartElement | null, vnode: VBaseElement | VStaticPartElement, renderer: RendererAPI): void;

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

@@ -1,3 +1,4 @@
 import { RendererAPI } from '../renderer';
-import { VBaseElement } from '../vnodes';
-export declare function patchStyleAttribute(oldVnode: VBaseElement | null, vnode: VBaseElement, renderer: RendererAPI): void;
+import { VBaseElement, VStaticPartElement } from '../vnodes';
+import { VM } from '../vm';
+export declare function patchStyleAttribute(oldVnode: VBaseElement | VStaticPartElement | null, vnode: VBaseElement | VStaticPartElement, renderer: RendererAPI, owner: VM): void;

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

@@ -1,3 +1,3 @@
 import { RendererAPI } from '../renderer';
-import { VBaseElement, VStaticPart } from '../vnodes';
-export declare function applyEventListeners(vnode: VBaseElement | VStaticPart, renderer: RendererAPI): void;
+import { VBaseElement, VStaticPartElement } from '../vnodes';
+export declare function applyEventListeners(vnode: VBaseElement | VStaticPartElement, renderer: RendererAPI): void;

package/dist/framework/modules/refs.d.ts

@@ -1,3 +1,3 @@
 import { VM } from '../vm';
-import { VBaseElement, VStaticPart } from '../vnodes';
-export declare function applyRefs(vnode: VBaseElement | VStaticPart, owner: VM): void;
+import { VBaseElement, VStaticPartElement } from '../vnodes';
+export declare function applyRefs(vnode: VBaseElement | VStaticPartElement, owner: VM): void;

package/dist/framework/modules/static-parts.d.ts

@@ -1,5 +1,12 @@
-import { VStatic } from '../vnodes';
+import { VStatic, VStaticPart } from '../vnodes';
 import { RendererAPI } from '../renderer';
+/**
+ * Given an array of static parts, mounts the DOM element to the part based on the staticPartId
+ * @param root the root element
+ * @param parts an array of VStaticParts
+ * @param renderer the renderer to use
+ */
+export declare function traverseAndSetElements(root: Element, parts: VStaticPart[], renderer: RendererAPI): void;
 /**
  * Given an array of static parts, do all the mounting required for these parts.
  * @param root the root element
@@ -8,8 +15,15 @@ import { RendererAPI } from '../renderer';
  */
 export declare function mountStaticParts(root: Element, vnode: VStatic, renderer: RendererAPI): void;
 /**
- * Mounts elements to the newly generated VStatic node
+ * Updates the static elements based on the content of the VStaticParts
  * @param n1 the previous VStatic vnode
  * @param n2 the current VStatic vnode
+ * @param renderer the renderer to use
+ */
+export declare function patchStaticParts(n1: VStatic, n2: VStatic, renderer: RendererAPI): void;
+/**
+ * Mounts the hydration specific attributes
+ * @param vnode the parent VStatic node
+ * @param renderer the renderer to use
  */
-export declare function patchStaticParts(n1: VStatic, n2: VStatic): void;
+export declare function hydrateStaticParts(vnode: VStatic, renderer: RendererAPI): void;

package/dist/framework/modules/text.d.ts

@@ -0,0 +1,5 @@
+import { RendererAPI } from '../renderer';
+import { VComment, VStaticPartText, VText } from '../vnodes';
+export declare function patchTextVNode(n1: VText, n2: VText, renderer: RendererAPI): void;
+export declare function patchTextVStaticPart(n1: VStaticPartText | null, n2: VStaticPartText, renderer: RendererAPI): void;
+export declare function updateTextContent(vnode: VText | VComment | VStaticPartText, renderer: RendererAPI): void;

package/dist/framework/template.d.ts

@@ -20,8 +20,8 @@ export interface Template {
 export declare let isUpdatingTemplate: boolean;
 export declare function getVMBeingRendered(): VM | null;
 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 const parseFragment: (strings: string[], ...keys: (string | number)[]) => () => Element;
+export declare const parseSVGFragment: (strings: string[], ...keys: (string | number)[]) => () => Element;
 export declare function evaluateTemplate(vm: VM, html: Template): VNodes;
 export declare function computeHasScopedStyles(template: Template, vm: VM | undefined): boolean;
 export declare function hasStyles(stylesheets: TemplateStylesheetFactories | undefined | null): stylesheets is TemplateStylesheetFactories;

package/dist/framework/utils.d.ts

@@ -1,6 +1,5 @@
 import { StylesheetFactory, TemplateStylesheetFactories } from './stylesheet';
 import { LightningElementConstructor } from './base-lightning-element';
-import { VElementData } from './vnodes';
 type Callback = () => void;
 export declare const SPACE_CHAR = 32;
 export declare const EmptyObject: any;
@@ -18,24 +17,5 @@ export declare function cloneAndOmitKey(object: {
 };
 export declare function flattenStylesheets(stylesheets: TemplateStylesheetFactories): StylesheetFactory[];
 export declare function assertNotProd(): void;
-export declare function applyTemporaryCompilerV5SlotFix(data: VElementData): VElementData | {
-    attrs: {
-        [key: string]: any;
-    };
-    slotAssignment: string;
-    key: import("./vnodes").Key;
-    external?: boolean | undefined;
-    ref?: string | undefined;
-    slotData?: any;
-    props?: Readonly<Record<string, any>> | undefined;
-    className?: string | undefined;
-    style?: string | undefined;
-    classMap?: Readonly<Record<string, boolean>> | undefined;
-    styleDecls?: readonly [string, string, boolean][] | undefined;
-    context?: Readonly<Record<string, Readonly<Record<string, any>>>> | undefined;
-    on?: Readonly<Record<string, (event: Event) => any>> | undefined;
-    svg?: boolean | undefined;
-    renderer?: import("./renderer").RendererAPI | undefined;
-};
 export declare function shouldBeFormAssociated(Ctor: LightningElementConstructor): boolean;
 export {};

package/dist/framework/vm.d.ts

@@ -4,7 +4,7 @@ import { Template } from './template';
 import { ComponentDef } from './def';
 import { LightningElement, LightningElementConstructor } from './base-lightning-element';
 import { ReactiveObserver } from './mutation-tracker';
-import { VNodes, VCustomElement, VNode, VBaseElement, VStaticPart } from './vnodes';
+import { VNodes, VCustomElement, VNode, VBaseElement, VStaticPartElement } from './vnodes';
 import { TemplateStylesheetFactories } from './stylesheet';
 type ShadowRootMode = 'open' | 'closed';
 export interface TemplateCache {
@@ -65,7 +65,7 @@ export interface Context {
     wiredDisconnecting: Array<() => void>;
 }
 export type RefVNodes = {
-    [name: string]: VBaseElement | VStaticPart;
+    [name: string]: VBaseElement | VStaticPartElement;
 };
 export interface VM<N = HostNode, E = HostElement> {
     /** The host element */
@@ -191,10 +191,12 @@ 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 runFormAssociatedCustomElementCallback(vm: VM, faceCb: () => void): void;
-export declare function runFormAssociatedCallback(elm: HTMLElement): void;
-export declare function runFormDisabledCallback(elm: HTMLElement): void;
+export declare function runFormAssociatedCustomElementCallback(vm: VM, faceCb: () => void, args?: any[]): void;
+export declare function runFormAssociatedCallback(elm: HTMLElement, form: HTMLFormElement | null): void;
+export declare function runFormDisabledCallback(elm: HTMLElement, disabled: boolean): void;
 export declare function runFormResetCallback(elm: HTMLElement): void;
-export declare function runFormStateRestoreCallback(elm: HTMLElement): void;
+export type FormRestoreState = File | string | Array<[string, FormDataEntryValue]>;
+export type FormRestoreReason = 'restore' | 'autocomplete';
+export declare function runFormStateRestoreCallback(elm: HTMLElement, state: FormRestoreState | null, reason: FormRestoreReason): void;
 export declare function resetRefVNodes(vm: VM): void;
 export {};

package/dist/framework/vnodes.d.ts

@@ -10,6 +10,10 @@ export declare const enum VNodeType {
     Fragment = 5,
     ScopedSlotFragment = 6
 }
+export declare const enum VStaticPartType {
+    Text = 0,
+    Element = 1
+}
 export type VNode = VText | VComment | VElement | VCustomElement | VStatic | VFragment | VScopedSlotFragment;
 export type VNodes = Readonly<Array<VNode | null>>;
 export interface BaseVParent {
@@ -28,11 +32,23 @@ export interface VScopedSlotFragment extends BaseVNode {
     slotName: unknown;
 }
 export interface VStaticPart {
+    readonly type: VStaticPartType;
     readonly partId: number;
+    readonly data: VStaticPartData | null;
+    readonly text: string | null;
+    elm: Element | Text | undefined;
+}
+export interface VStaticPartElement extends VStaticPart {
+    readonly type: VStaticPartType.Element;
     readonly data: VStaticPartData;
     elm: Element | undefined;
 }
-export type VStaticPartData = Pick<VElementData, 'on' | 'ref'>;
+export interface VStaticPartText extends VStaticPart {
+    readonly type: VStaticPartType.Text;
+    readonly text: string;
+    elm: Text | undefined;
+}
+export type VStaticPartData = Pick<VElementData, 'on' | 'ref' | 'attrs' | 'style' | 'className'>;
 export interface VStatic extends BaseVNode {
     readonly type: VNodeType.Static;
     readonly sel: undefined;
@@ -103,3 +119,5 @@ export declare function isVCustomElement(vnode: VNode | VBaseElement): vnode is
 export declare function isVFragment(vnode: VNode): vnode is VFragment;
 export declare function isVScopedSlotFragment(vnode: VNode): vnode is VScopedSlotFragment;
 export declare function isVStatic(vnode: VNode): vnode is VStatic;
+export declare function isVStaticPartElement(vnode: VStaticPart): vnode is VStaticPartElement;
+export declare function isVStaticPartText(vnode: VStaticPart): vnode is VStaticPartText;