@lwc/engine-core 8.0.0 → 8.1.0-alpha.0

package/dist/advanced-mutation-tracker.d.ts

@@ -0,0 +1,7 @@
+import { VM } from "./framework/vm";
+export interface MutationLog {
+    vm: VM;
+    key: PropertyKey;
+}
+export declare function getAndFlushMutationLogs(): MutationLog[];
+export declare function logMutation(vm: VM, key: PropertyKey): void;

package/dist/framework/advanced-instrumentation.d.ts

@@ -0,0 +1,2 @@
+export declare function isAdvancedInstrumentationEnabled(): boolean;
+export declare function onAdvancedInstrumentationEnabledOrDisabled(listener: (enabled: boolean) => void): void;

package/dist/framework/advanced-mutation-tracker.d.ts

@@ -0,0 +1,7 @@
+import { VM } from "./vm";
+export interface MutationLog {
+    vm: VM;
+    key: PropertyKey;
+}
+export declare function getAndFlushMutationLogs(): MutationLog[];
+export declare function logMutation(vm: VM, key: PropertyKey): void;

package/dist/framework/mutation-logger.d.ts

@@ -0,0 +1,34 @@
+import { ReactiveObserver } from '../libs/mutation-tracker';
+import { VM } from './vm';
+export interface MutationLog {
+    vm: VM;
+    prop: string;
+}
+/**
+ * Flush all the logs we've written so far and return the current logs.
+ */
+export declare function getAndFlushMutationLogs(): MutationLog[];
+/**
+ * Log a new mutation for this reactive observer.
+ * @param reactiveObserver - relevant ReactiveObserver
+ * @param target - target object that is being observed
+ * @param key - key (property) that was mutated
+ */
+export declare function logMutation(reactiveObserver: ReactiveObserver, target: object, key: PropertyKey): void;
+/**
+ * Flush logs associated with a given VM.
+ * @param vm - given VM
+ */
+export declare function flushMutationLogsForVM(vm: VM): void;
+/**
+ * Mark this ReactiveObserver as related to this VM. This is only needed for mutation tracking in dev mode.
+ * @param reactiveObserver
+ * @param vm
+ */
+export declare function associateReactiveObserverWithVM(reactiveObserver: ReactiveObserver, vm: VM): void;
+/**
+ * Deeply track all objects in a target and associate with a given key.
+ * @param key - key associated with the object in the component
+ * @param target - tracked target object
+ */
+export declare function trackTargetForMutationLogging(key: PropertyKey, target: any): void;

package/dist/framework/profiler.d.ts

@@ -1,4 +1,5 @@
 import { RenderMode, ShadowMode, VM } from './vm';
+import type { MutationLog } from './mutation-logger';
 export declare const enum OperationId {
     Constructor = 0,
     Render = 1,
@@ -24,6 +25,8 @@ export declare const profilerControl: {
 };
 export declare function logOperationStart(opId: OperationId, vm: VM): void;
 export declare function logOperationEnd(opId: OperationId, vm: VM): void;
-export declare function logGlobalOperationStart(opId: GlobalOperationId, vm?: VM): void;
-export declare function logGlobalOperationEnd(opId: GlobalOperationId, vm?: VM): void;
+export declare function logGlobalOperationStart(opId: GlobalOperationId): void;
+export declare function logGlobalOperationStartWithVM(opId: GlobalOperationId, vm: VM): void;
+export declare function logGlobalOperationEnd(opId: GlobalOperationId, mutationLogs: MutationLog[] | undefined): void;
+export declare function logGlobalOperationEndWithVM(opId: GlobalOperationId, vm: VM): void;
 export {};

package/dist/framework/profiling/advanced-instrumentation.d.ts

@@ -0,0 +1,2 @@
+export declare function isAdvancedInstrumentationEnabled(): boolean;
+export declare function onAdvancedInstrumentationEnabledOrDisabled(listener: (enabled: boolean) => void): void;

package/dist/framework/profiling/advanced-mutation-tracker.d.ts

@@ -0,0 +1,7 @@
+import { VM } from "../../framework/vm";
+export interface MutationLog {
+    vm: VM;
+    key: PropertyKey;
+}
+export declare function getAndFlushMutationLogs(): MutationLog[];
+export declare function logMutation(vm: VM, key: PropertyKey): void;