@lwc/engine-core 2.33.0 → 2.35.0

package/package.json

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

package/types/framework/base-lightning-element.d.ts

@@ -10,6 +10,7 @@ import { AccessibleElementProperties } from '@lwc/shared';
 import { ShadowSupportMode } from './vm';
 import { Template } from './template';
 import { HTMLElementConstructor } from './base-bridge-element';
+import { TemplateStylesheetFactories } from './stylesheet';
 export interface LightningElementConstructor {
     new (): LightningElement;
     readonly prototype: LightningElement;
@@ -17,6 +18,7 @@ export interface LightningElementConstructor {
     delegatesFocus?: boolean;
     renderMode?: 'light' | 'shadow';
     shadowSupportMode?: ShadowSupportMode;
+    stylesheets: TemplateStylesheetFactories;
 }
 type HTMLElementTheGoodParts = Pick<Object, 'toString'> & Pick<HTMLElement, 'accessKey' | 'addEventListener' | 'children' | 'childNodes' | 'classList' | 'dir' | 'dispatchEvent' | 'draggable' | 'firstChild' | 'firstElementChild' | 'getAttribute' | 'getAttributeNS' | 'getBoundingClientRect' | 'getElementsByClassName' | 'getElementsByTagName' | 'hasAttribute' | 'hasAttributeNS' | 'hidden' | 'id' | 'isConnected' | 'lang' | 'lastChild' | 'lastElementChild' | 'querySelector' | 'querySelectorAll' | 'removeAttribute' | 'removeAttributeNS' | 'removeEventListener' | 'setAttribute' | 'setAttributeNS' | 'spellcheck' | 'tabIndex' | 'title'>;
 type RefNodes = {

package/types/framework/main.d.ts

@@ -17,6 +17,7 @@ export { unwrap } from './membrane';
 export { sanitizeAttribute } from './secure-template';
 export { getComponentDef, isComponentConstructor } from './def';
 export { profilerControl as __unstable__ProfilerControl } from './profiler';
+export { reportingControl as __unstable__ReportingControl } from './reporting';
 export { swapTemplate, swapComponent, swapStyle } from './hot-swaps';
 export { setHooks } from './overridable-hooks';
 export { freezeTemplate } from './freeze-template';

package/types/framework/reporting.d.ts

@@ -0,0 +1,31 @@
+import { VM } from './vm';
+export declare const enum ReportingEventId {
+    CrossRootAriaInSyntheticShadow = 0
+}
+type ReportingDispatcher = (reportingEventId: ReportingEventId, tagName: string, vmIndex: number) => void;
+type OnReportingEnabledCallback = () => void;
+export declare const reportingControl: {
+    /**
+     * Attach a new reporting control (aka dispatcher).
+     *
+     * @param dispatcher - reporting control
+     */
+    attachDispatcher(dispatcher: ReportingDispatcher): void;
+    /**
+     * Detach the current reporting control (aka dispatcher).
+     */
+    detachDispatcher(): void;
+};
+/**
+ * Call a callback when reporting is enabled, or immediately if reporting is already enabled.
+ * Will only ever be called once.
+ * @param callback
+ */
+export declare function onReportingEnabled(callback: OnReportingEnabledCallback): void;
+/**
+ * Report to the current dispatcher, if there is one.
+ * @param reportingEventId
+ * @param vm
+ */
+export declare function report(reportingEventId: ReportingEventId, vm: VM): void;
+export {};

package/types/framework/template.d.ts

@@ -21,4 +21,5 @@ 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 function evaluateTemplate(vm: VM, html: Template): VNodes;
-export declare function computeHasScopedStyles(template: Template): boolean;
+export declare function computeHasScopedStyles(template: Template, vm: VM | undefined): boolean;
+export declare function hasStyles(stylesheets: TemplateStylesheetFactories | undefined | null): stylesheets is TemplateStylesheetFactories;

package/types/framework/vm.d.ts

@@ -4,6 +4,7 @@ import { ComponentDef } from './def';
 import { LightningElement, LightningElementConstructor } from './base-lightning-element';
 import { ReactiveObserver } from './mutation-tracker';
 import { VNodes, VCustomElement, VNode, VBaseElement } from './vnodes';
+import { TemplateStylesheetFactories } from './stylesheet';
 type ShadowRootMode = 'open' | 'closed';
 export interface TemplateCache {
     [key: string]: any;
@@ -132,6 +133,9 @@ export interface VM<N = HostNode, E = HostElement> {
     /**
      * Debug info bag. Stores useful debug information about the component. */
     debugInfo?: Record<string, any>;
+    /**
+     * Any stylesheets associated with the component */
+    stylesheets: TemplateStylesheetFactories | null;
 }
 type VMAssociable = HostNode | LightningElement;
 export declare function rerenderVM(vm: VM): void;

package/types/index.d.ts

@@ -1,2 +1,3 @@
 import './testFeatureFlag';
+import './patches/detect-synthetic-cross-root-aria';
 export * from './framework/main';

package/types/patches/detect-synthetic-cross-root-aria.d.ts

@@ -0,0 +1 @@
+export {};

package/types/shared/logger.d.ts

@@ -1,3 +1,4 @@
 import { VM } from '../framework/vm';
 export declare function logError(message: string, vm?: VM): void;
 export declare function logWarn(message: string, vm?: VM): void;
+export declare function logWarnOnce(message: string, vm?: VM): void;