@lwc/engine-core 4.0.0 → 4.0.1

package/dist/framework/reporting.d.ts

@@ -3,7 +3,8 @@ export declare const enum ReportingEventId {
     CompilerRuntimeVersionMismatch = "CompilerRuntimeVersionMismatch",
     NonStandardAriaReflection = "NonStandardAriaReflection",
     TemplateMutation = "TemplateMutation",
-    StylesheetMutation = "StylesheetMutation"
+    StylesheetMutation = "StylesheetMutation",
+    ConnectedCallbackWhileDisconnected = "ConnectedCallbackWhileDisconnected"
 }
 export interface BasePayload {
     tagName?: string;
@@ -26,12 +27,15 @@ export interface TemplateMutationPayload extends BasePayload {
 export interface StylesheetMutationPayload extends BasePayload {
     propertyName: string;
 }
+export interface ConnectedCallbackWhileDisconnectedPayload extends BasePayload {
+}
 export type ReportingPayloadMapping = {
     [ReportingEventId.CrossRootAriaInSyntheticShadow]: CrossRootAriaInSyntheticShadowPayload;
     [ReportingEventId.CompilerRuntimeVersionMismatch]: CompilerRuntimeVersionMismatchPayload;
     [ReportingEventId.NonStandardAriaReflection]: NonStandardAriaReflectionPayload;
     [ReportingEventId.TemplateMutation]: TemplateMutationPayload;
     [ReportingEventId.StylesheetMutation]: StylesheetMutationPayload;
+    [ReportingEventId.ConnectedCallbackWhileDisconnected]: ConnectedCallbackWhileDisconnectedPayload;
 };
 export type ReportingDispatcher<T extends ReportingEventId = ReportingEventId> = (reportingEventId: T, payload: ReportingPayloadMapping[T]) => void;
 /** Callbacks to invoke when reporting is enabled **/
@@ -60,4 +64,8 @@ export declare function onReportingEnabled(callback: OnReportingEnabledCallback)
  * @param payload - data to report
  */
 export declare function report<T extends ReportingEventId>(reportingEventId: T, payload: ReportingPayloadMapping[T]): void;
+/**
+ * Return true if reporting is enabled
+ */
+export declare function isReportingEnabled(): boolean;
 export {};

package/dist/index.cjs.js

@@ -78,6 +78,12 @@ function report(reportingEventId, payload) {
         currentDispatcher$1(reportingEventId, payload);
     }
 }
+/**
+ * Return true if reporting is enabled
+ */
+function isReportingEnabled() {
+    return enabled$1;
+}
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -6038,6 +6044,24 @@ function runConnectedCallback(vm) {
         invokeComponentCallback(vm, connectedCallback);
         logOperationEnd(3 /* OperationId.ConnectedCallback */, vm);
     }
+    // This test only makes sense in the browser, with synthetic lifecycle, and when reporting is enabled or
+    // we're in dev mode. This is to detect a particular issue with synthetic lifecycle.
+    if (process.env.IS_BROWSER &&
+        !lwcRuntimeFlags.ENABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE &&
+        (process.env.NODE_ENV !== 'production' || isReportingEnabled())) {
+        if (!vm.renderer.isConnected(vm.elm)) {
+            if (process.env.NODE_ENV !== 'production') {
+                logWarnOnce(`Element <${vm.tagName}> ` +
+                    `fired a \`connectedCallback\` and rendered, but was not connected to the DOM. ` +
+                    `Please ensure all components are actually connected to the DOM, e.g. using ` +
+                    `\`document.body.appendChild(element)\`. This will not be supported in future versions of ` +
+                    `LWC and could cause component errors. For details, see: https://sfdc.co/synthetic-lifecycle`);
+            }
+            report("ConnectedCallbackWhileDisconnected" /* ReportingEventId.ConnectedCallbackWhileDisconnected */, {
+                tagName: vm.tagName,
+            });
+        }
+    }
 }
 function hasWireAdapters(vm) {
     return shared.getOwnPropertyNames(vm.def.wire).length > 0;
@@ -7313,5 +7337,5 @@ exports.swapTemplate = swapTemplate;
 exports.track = track;
 exports.unwrap = unwrap;
 exports.wire = wire;
-/** version: 4.0.0 */
+/** version: 4.0.1 */
 //# sourceMappingURL=index.cjs.js.map