@lwc/engine-core 8.12.5 → 8.12.6

package/dist/framework/invoker.d.ts

@@ -1,5 +1,6 @@
+import { LightningElement } from './base-lightning-element';
 import type { VM } from './vm';
-import type { LightningElement, LightningElementConstructor } from './base-lightning-element';
+import type { LightningElementConstructor } from './base-lightning-element';
 import type { VNodes } from './vnodes';
 export declare let isInvokingRender: boolean;
 export declare let vmBeingConstructed: VM | null;

package/dist/framework/profiler.d.ts

@@ -9,10 +9,11 @@ export declare const enum OperationId {
     RenderedCallback = 4,
     DisconnectedCallback = 5,
     ErrorCallback = 6,
-    GlobalHydrate = 7,
-    GlobalRehydrate = 8
+    GlobalRender = 7,
+    GlobalRerender = 8,
+    GlobalSsrHydrate = 9
 }
-type GlobalOperationId = OperationId.GlobalHydrate | OperationId.GlobalRehydrate;
+type GlobalOperationId = OperationId.GlobalRender | OperationId.GlobalRerender | OperationId.GlobalSsrHydrate;
 declare const enum Phase {
     Start = 0,
     Stop = 1

package/dist/index.cjs.js

@@ -2960,7 +2960,10 @@ function HTMLBridgeElementFactory(SuperClass, publicProperties, methods, observe
     const { observedAttributes: superObservedAttributes = [] } = SuperClass;
     const descriptors = shared.create(null);
     // present a hint message so that developers are aware that they have not decorated property with @api
-    if (process.env.NODE_ENV !== 'production') {
+    // Note that we also don't do this in SSR because we cannot sniff for what props are declared on
+    // HTMLElementPrototype, and it seems not worth it to have these dev-only warnings there, since
+    // an `in` check could mistakenly assume that a prop is declared on a LightningElement prototype.
+    if (process.env.NODE_ENV !== 'production' && process.env.IS_BROWSER) {
         // TODO [#3761]: enable for components that don't extend from LightningElement
         if (!shared.isUndefined(proto) && !shared.isNull(proto) && !hasCustomSuperClass) {
             const nonPublicPropertiesToWarnOn = new Set([
@@ -5821,8 +5824,9 @@ const operationIdNameMapping = [
     'renderedCallback',
     'disconnectedCallback',
     'errorCallback',
-    'lwc-hydrate',
-    'lwc-rehydrate',
+    'lwc-render',
+    'lwc-rerender',
+    'lwc-ssr-hydrate',
 ];
 const operationTooltipMapping = [
     // constructor
@@ -5839,10 +5843,12 @@ const operationTooltipMapping = [
     'component disconnectedCallback()',
     // errorCallback
     'component errorCallback()',
-    // lwc-hydrate
+    // lwc-render
     'component first rendered',
-    // lwc-rehydrate
+    // lwc-rerender
     'component re-rendered',
+    // lwc-ssr-hydrate
+    'component hydrated from server-rendered HTML',
 ];
 // Even if all the browser the engine supports implements the UserTiming API, we need to guard the measure APIs.
 // JSDom (used in Jest) for example doesn't implement the UserTiming APIs.
@@ -5896,13 +5902,14 @@ function getProperties(vm) {
 function getColor(opId) {
     // As of Sept 2024: primary (dark blue), secondary (light blue), tertiary (green)
     switch (opId) {
-        // GlobalHydrate and Constructor tend to occur at the top level
-        case 7 /* OperationId.GlobalHydrate */:
+        // GlobalSsrHydrate, GlobalRender, and Constructor tend to occur at the top level
+        case 7 /* OperationId.GlobalRender */:
+        case 9 /* OperationId.GlobalSsrHydrate */:
         case 0 /* OperationId.Constructor */:
             return 'primary';
-        // GlobalRehydrate also occurs at the top level, but we want to use tertiary (green) because it's easier to
+        // GlobalRerender also occurs at the top level, but we want to use tertiary (green) because it's easier to
         // distinguish from primary, and at a glance you should be able to easily tell re-renders from first renders.
-        case 8 /* OperationId.GlobalRehydrate */:
+        case 8 /* OperationId.GlobalRerender */:
             return 'tertiary';
         // Everything else (patch/render/callbacks)
         default:
@@ -6107,7 +6114,7 @@ function getVMBeingRendered() {
 function setVMBeingRendered(vm) {
     vmBeingRendered = vm;
 }
-const VALID_SCOPE_TOKEN_REGEX = /^[a-zA-Z0-9\-_.]+$/;
+const VALID_SCOPE_TOKEN_REGEX = /^[a-zA-Z0-9\-_]+$/;
 // See W-16614556
 // TODO [#2826]: freeze the template object
 function isValidScopeToken(token) {
@@ -6475,7 +6482,10 @@ function invokeComponentConstructor(vm, Ctor) {
         // the "instanceof" operator would not work here since Locker Service provides its own
         // implementation of LightningElement, so we indirectly check if the base constructor is
         // invoked by accessing the component on the vm.
-        if (vmBeingConstructed.component !== result) {
+        const isInvalidConstructor = lwcRuntimeFlags.LEGACY_LOCKER_ENABLED
+            ? vmBeingConstructed.component !== result
+            : !(result instanceof LightningElement);
+        if (isInvalidConstructor) {
             throw new TypeError('Invalid component constructor, the class should extend LightningElement.');
         }
     }
@@ -6661,10 +6671,10 @@ function connectRootElement(elm) {
     const vm = getAssociatedVM(elm);
     if (process.env.NODE_ENV !== 'production') {
         // Flush any logs for this VM so that the initial properties from the constructor don't "count"
-        // in subsequent re-renders (lwc-rehydrate). Right now we're at the first render (lwc-hydrate).
+        // in subsequent re-renders (lwc-rerender). Right now we're at the first render (lwc-hydrate).
         flushMutationLogsForVM(vm);
     }
-    logGlobalOperationStartWithVM(7 /* OperationId.GlobalHydrate */, vm);
+    logGlobalOperationStartWithVM(7 /* OperationId.GlobalRender */, vm);
     // Usually means moving the element from one place to another, which is observable via
     // life-cycle hooks.
     if (vm.state === 1 /* VMState.connected */) {
@@ -6672,7 +6682,7 @@ function connectRootElement(elm) {
     }
     runConnectedCallback(vm);
     rehydrate(vm);
-    logGlobalOperationEndWithVM(7 /* OperationId.GlobalHydrate */, vm);
+    logGlobalOperationEndWithVM(7 /* OperationId.GlobalRender */, vm);
 }
 function disconnectRootElement(elm) {
     const vm = getAssociatedVM(elm);
@@ -6981,7 +6991,7 @@ function flushRehydrationQueue() {
     // Gather the logs before rehydration starts so they can be reported at the end of rehydration.
     // Note that we also clear all existing logs at this point so that subsequent re-renders start from a clean slate.
     const mutationLogs = process.env.NODE_ENV === 'production' ? undefined : getAndFlushMutationLogs();
-    logGlobalOperationStart(8 /* OperationId.GlobalRehydrate */);
+    logGlobalOperationStart(8 /* OperationId.GlobalRerender */);
     if (process.env.NODE_ENV !== 'production') {
         shared.assert.invariant(rehydrateQueue.length, `If rehydrateQueue was scheduled, it is because there must be at least one VM on this pending queue instead of ${rehydrateQueue}.`);
     }
@@ -7001,13 +7011,13 @@ function flushRehydrationQueue() {
                 shared.ArrayUnshift.apply(rehydrateQueue, shared.ArraySlice.call(vms, i + 1));
             }
             // we need to end the measure before throwing.
-            logGlobalOperationEnd(8 /* OperationId.GlobalRehydrate */, mutationLogs);
+            logGlobalOperationEnd(8 /* OperationId.GlobalRerender */, mutationLogs);
             // re-throwing the original error will break the current tick, but since the next tick is
             // already scheduled, it should continue patching the rest.
             throw error;
         }
     }
-    logGlobalOperationEnd(8 /* OperationId.GlobalRehydrate */, mutationLogs);
+    logGlobalOperationEnd(8 /* OperationId.GlobalRerender */, mutationLogs);
 }
 function runConnectedCallback(vm) {
     const { state } = vm;
@@ -7613,6 +7623,7 @@ const EMPTY_SET = new Set();
 let hasMismatch = false;
 function hydrateRoot(vm) {
     hasMismatch = false;
+    logGlobalOperationStartWithVM(9 /* OperationId.GlobalSsrHydrate */, vm);
     runConnectedCallback(vm);
     hydrateVM(vm);
     if (process.env.NODE_ENV !== 'production') {
@@ -7625,6 +7636,7 @@ function hydrateRoot(vm) {
             logHydrationWarning('Hydration completed with errors.');
         }
     }
+    logGlobalOperationEndWithVM(9 /* OperationId.GlobalSsrHydrate */, vm);
 }
 function hydrateVM(vm) {
     const children = renderComponent(vm);
@@ -7632,7 +7644,9 @@ function hydrateVM(vm) {
     // reset the refs; they will be set during `hydrateChildren`
     resetRefVNodes(vm);
     const { renderRoot: parentNode, renderer: { getFirstChild }, } = vm;
+    logOperationStart(2 /* OperationId.Patch */, vm);
     hydrateChildren(getFirstChild(parentNode), children, parentNode, vm, false);
+    logOperationEnd(2 /* OperationId.Patch */, vm);
     runRenderedCallback(vm);
 }
 function hydrateNode(node, vnode, renderer) {
@@ -8474,5 +8488,5 @@ exports.swapTemplate = swapTemplate;
 exports.track = track;
 exports.unwrap = unwrap;
 exports.wire = wire;
-/** version: 8.12.5 */
+/** version: 8.12.6 */
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.js

@@ -2957,7 +2957,10 @@ function HTMLBridgeElementFactory(SuperClass, publicProperties, methods, observe
     const { observedAttributes: superObservedAttributes = [] } = SuperClass;
     const descriptors = create(null);
     // present a hint message so that developers are aware that they have not decorated property with @api
-    if (process.env.NODE_ENV !== 'production') {
+    // Note that we also don't do this in SSR because we cannot sniff for what props are declared on
+    // HTMLElementPrototype, and it seems not worth it to have these dev-only warnings there, since
+    // an `in` check could mistakenly assume that a prop is declared on a LightningElement prototype.
+    if (process.env.NODE_ENV !== 'production' && process.env.IS_BROWSER) {
         // TODO [#3761]: enable for components that don't extend from LightningElement
         if (!isUndefined$1(proto) && !isNull(proto) && !hasCustomSuperClass) {
             const nonPublicPropertiesToWarnOn = new Set([
@@ -5818,8 +5821,9 @@ const operationIdNameMapping = [
     'renderedCallback',
     'disconnectedCallback',
     'errorCallback',
-    'lwc-hydrate',
-    'lwc-rehydrate',
+    'lwc-render',
+    'lwc-rerender',
+    'lwc-ssr-hydrate',
 ];
 const operationTooltipMapping = [
     // constructor
@@ -5836,10 +5840,12 @@ const operationTooltipMapping = [
     'component disconnectedCallback()',
     // errorCallback
     'component errorCallback()',
-    // lwc-hydrate
+    // lwc-render
     'component first rendered',
-    // lwc-rehydrate
+    // lwc-rerender
     'component re-rendered',
+    // lwc-ssr-hydrate
+    'component hydrated from server-rendered HTML',
 ];
 // Even if all the browser the engine supports implements the UserTiming API, we need to guard the measure APIs.
 // JSDom (used in Jest) for example doesn't implement the UserTiming APIs.
@@ -5893,13 +5899,14 @@ function getProperties(vm) {
 function getColor(opId) {
     // As of Sept 2024: primary (dark blue), secondary (light blue), tertiary (green)
     switch (opId) {
-        // GlobalHydrate and Constructor tend to occur at the top level
-        case 7 /* OperationId.GlobalHydrate */:
+        // GlobalSsrHydrate, GlobalRender, and Constructor tend to occur at the top level
+        case 7 /* OperationId.GlobalRender */:
+        case 9 /* OperationId.GlobalSsrHydrate */:
         case 0 /* OperationId.Constructor */:
             return 'primary';
-        // GlobalRehydrate also occurs at the top level, but we want to use tertiary (green) because it's easier to
+        // GlobalRerender also occurs at the top level, but we want to use tertiary (green) because it's easier to
         // distinguish from primary, and at a glance you should be able to easily tell re-renders from first renders.
-        case 8 /* OperationId.GlobalRehydrate */:
+        case 8 /* OperationId.GlobalRerender */:
             return 'tertiary';
         // Everything else (patch/render/callbacks)
         default:
@@ -6104,7 +6111,7 @@ function getVMBeingRendered() {
 function setVMBeingRendered(vm) {
     vmBeingRendered = vm;
 }
-const VALID_SCOPE_TOKEN_REGEX = /^[a-zA-Z0-9\-_.]+$/;
+const VALID_SCOPE_TOKEN_REGEX = /^[a-zA-Z0-9\-_]+$/;
 // See W-16614556
 // TODO [#2826]: freeze the template object
 function isValidScopeToken(token) {
@@ -6472,7 +6479,10 @@ function invokeComponentConstructor(vm, Ctor) {
         // the "instanceof" operator would not work here since Locker Service provides its own
         // implementation of LightningElement, so we indirectly check if the base constructor is
         // invoked by accessing the component on the vm.
-        if (vmBeingConstructed.component !== result) {
+        const isInvalidConstructor = lwcRuntimeFlags.LEGACY_LOCKER_ENABLED
+            ? vmBeingConstructed.component !== result
+            : !(result instanceof LightningElement);
+        if (isInvalidConstructor) {
             throw new TypeError('Invalid component constructor, the class should extend LightningElement.');
         }
     }
@@ -6658,10 +6668,10 @@ function connectRootElement(elm) {
     const vm = getAssociatedVM(elm);
     if (process.env.NODE_ENV !== 'production') {
         // Flush any logs for this VM so that the initial properties from the constructor don't "count"
-        // in subsequent re-renders (lwc-rehydrate). Right now we're at the first render (lwc-hydrate).
+        // in subsequent re-renders (lwc-rerender). Right now we're at the first render (lwc-hydrate).
         flushMutationLogsForVM(vm);
     }
-    logGlobalOperationStartWithVM(7 /* OperationId.GlobalHydrate */, vm);
+    logGlobalOperationStartWithVM(7 /* OperationId.GlobalRender */, vm);
     // Usually means moving the element from one place to another, which is observable via
     // life-cycle hooks.
     if (vm.state === 1 /* VMState.connected */) {
@@ -6669,7 +6679,7 @@ function connectRootElement(elm) {
     }
     runConnectedCallback(vm);
     rehydrate(vm);
-    logGlobalOperationEndWithVM(7 /* OperationId.GlobalHydrate */, vm);
+    logGlobalOperationEndWithVM(7 /* OperationId.GlobalRender */, vm);
 }
 function disconnectRootElement(elm) {
     const vm = getAssociatedVM(elm);
@@ -6978,7 +6988,7 @@ function flushRehydrationQueue() {
     // Gather the logs before rehydration starts so they can be reported at the end of rehydration.
     // Note that we also clear all existing logs at this point so that subsequent re-renders start from a clean slate.
     const mutationLogs = process.env.NODE_ENV === 'production' ? undefined : getAndFlushMutationLogs();
-    logGlobalOperationStart(8 /* OperationId.GlobalRehydrate */);
+    logGlobalOperationStart(8 /* OperationId.GlobalRerender */);
     if (process.env.NODE_ENV !== 'production') {
         assert.invariant(rehydrateQueue.length, `If rehydrateQueue was scheduled, it is because there must be at least one VM on this pending queue instead of ${rehydrateQueue}.`);
     }
@@ -6998,13 +7008,13 @@ function flushRehydrationQueue() {
                 ArrayUnshift.apply(rehydrateQueue, ArraySlice.call(vms, i + 1));
             }
             // we need to end the measure before throwing.
-            logGlobalOperationEnd(8 /* OperationId.GlobalRehydrate */, mutationLogs);
+            logGlobalOperationEnd(8 /* OperationId.GlobalRerender */, mutationLogs);
             // re-throwing the original error will break the current tick, but since the next tick is
             // already scheduled, it should continue patching the rest.
             throw error;
         }
     }
-    logGlobalOperationEnd(8 /* OperationId.GlobalRehydrate */, mutationLogs);
+    logGlobalOperationEnd(8 /* OperationId.GlobalRerender */, mutationLogs);
 }
 function runConnectedCallback(vm) {
     const { state } = vm;
@@ -7610,6 +7620,7 @@ const EMPTY_SET = new Set();
 let hasMismatch = false;
 function hydrateRoot(vm) {
     hasMismatch = false;
+    logGlobalOperationStartWithVM(9 /* OperationId.GlobalSsrHydrate */, vm);
     runConnectedCallback(vm);
     hydrateVM(vm);
     if (process.env.NODE_ENV !== 'production') {
@@ -7622,6 +7633,7 @@ function hydrateRoot(vm) {
             logHydrationWarning('Hydration completed with errors.');
         }
     }
+    logGlobalOperationEndWithVM(9 /* OperationId.GlobalSsrHydrate */, vm);
 }
 function hydrateVM(vm) {
     const children = renderComponent(vm);
@@ -7629,7 +7641,9 @@ function hydrateVM(vm) {
     // reset the refs; they will be set during `hydrateChildren`
     resetRefVNodes(vm);
     const { renderRoot: parentNode, renderer: { getFirstChild }, } = vm;
+    logOperationStart(2 /* OperationId.Patch */, vm);
     hydrateChildren(getFirstChild(parentNode), children, parentNode, vm, false);
+    logOperationEnd(2 /* OperationId.Patch */, vm);
     runRenderedCallback(vm);
 }
 function hydrateNode(node, vnode, renderer) {
@@ -8420,5 +8434,5 @@ function readonly(obj) {
 }
 
 export { BaseBridgeElement, LightningElement, profilerControl as __unstable__ProfilerControl, reportingControl as __unstable__ReportingControl, api$1 as api, computeShadowAndRenderMode, connectRootElement, createContextProviderWithRegister, createVM, disconnectRootElement, freezeTemplate, getAssociatedVMIfPresent, getComponentAPIVersion, getComponentConstructor, getComponentDef, getComponentHtmlPrototype, hydrateRoot, isComponentConstructor, parseFragment, parseSVGFragment, readonly, registerComponent, registerDecorators, registerTemplate, runFormAssociatedCallback, runFormDisabledCallback, runFormResetCallback, runFormStateRestoreCallback, sanitizeAttribute, shouldBeFormAssociated, swapComponent, swapStyle, swapTemplate, track, unwrap, wire };
-/** version: 8.12.5 */
+/** version: 8.12.6 */
 //# sourceMappingURL=index.js.map

package/package.json

@@ -4,7 +4,7 @@
         "You can safely modify dependencies, devDependencies, keywords, etc., but other props will be overwritten."
     ],
     "name": "@lwc/engine-core",
-    "version": "8.12.5",
+    "version": "8.12.6",
     "description": "Core LWC engine APIs.",
     "keywords": [
         "lwc"
@@ -46,9 +46,9 @@
         }
     },
     "dependencies": {
-        "@lwc/features": "8.12.5",
-        "@lwc/shared": "8.12.5",
-        "@lwc/signals": "8.12.5"
+        "@lwc/features": "8.12.6",
+        "@lwc/shared": "8.12.6",
+        "@lwc/signals": "8.12.6"
     },
     "devDependencies": {
         "observable-membrane": "2.0.0"