@lwc/engine-core 8.23.0 → 8.24.0

package/dist/framework/component.d.ts

@@ -9,6 +9,10 @@ type ComponentConstructorMetadata = {
     sel: string;
     apiVersion: APIVersion;
     enableSyntheticElementInternals?: boolean | undefined;
+    componentFeatureFlag?: {
+        value: boolean;
+        path: string;
+    } | undefined;
 };
 /**
  * INTERNAL: This function can only be invoked by compiled code. The compiler
@@ -21,6 +25,8 @@ export declare function getComponentRegisteredTemplate(Ctor: LightningElementCon
 export declare function getComponentRegisteredName(Ctor: LightningElementConstructor): string | undefined;
 export declare function getComponentAPIVersion(Ctor: LightningElementConstructor): APIVersion;
 export declare function supportsSyntheticElementInternals(Ctor: LightningElementConstructor): boolean;
+export declare function isComponentFeatureEnabled(Ctor: LightningElementConstructor): boolean;
+export declare function getComponentMetadata(Ctor: LightningElementConstructor): ComponentConstructorMetadata | undefined;
 export declare function getTemplateReactiveObserver(vm: VM): ReactiveObserver;
 export declare function resetTemplateObserverAndUnsubscribe(vm: VM): void;
 export declare function renderComponent(vm: VM): VNodes;

package/dist/index.cjs.js

@@ -3754,6 +3754,13 @@ function getCtorProto(Ctor) {
     return proto;
 }
 function createComponentDef(Ctor) {
+    // Enforce component-level feature flag if provided at compile time
+    if (!isComponentFeatureEnabled(Ctor)) {
+        const metadata = getComponentMetadata(Ctor);
+        const componentName = Ctor.name || metadata?.sel || 'Unknown';
+        const componentFeatureFlagPath = metadata?.componentFeatureFlag?.path || 'Unknown';
+        throw new Error(`Component ${componentName} is disabled by the feature flag at ${componentFeatureFlagPath}.`);
+    }
     const { shadowSupportMode: ctorShadowSupportMode, renderMode: ctorRenderMode, formAssociated: ctorFormAssociated, } = Ctor;
     if (process.env.NODE_ENV !== 'production') {
         const ctorName = Ctor.name;
@@ -6727,6 +6734,14 @@ function getComponentAPIVersion(Ctor) {
 function supportsSyntheticElementInternals(Ctor) {
     return registeredComponentMap.get(Ctor)?.enableSyntheticElementInternals || false;
 }
+function isComponentFeatureEnabled(Ctor) {
+    const flag = registeredComponentMap.get(Ctor)?.componentFeatureFlag;
+    // Default to true if not provided
+    return flag?.value !== false;
+}
+function getComponentMetadata(Ctor) {
+    return registeredComponentMap.get(Ctor);
+}
 function getTemplateReactiveObserver(vm) {
     const reactiveObserver = createReactiveObserver(() => {
         const { isDirty } = vm;
@@ -8825,5 +8840,5 @@ exports.swapTemplate = swapTemplate;
 exports.track = track;
 exports.unwrap = unwrap;
 exports.wire = wire;
-/** version: 8.23.0 */
+/** version: 8.24.0 */
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.js

@@ -3751,6 +3751,13 @@ function getCtorProto(Ctor) {
     return proto;
 }
 function createComponentDef(Ctor) {
+    // Enforce component-level feature flag if provided at compile time
+    if (!isComponentFeatureEnabled(Ctor)) {
+        const metadata = getComponentMetadata(Ctor);
+        const componentName = Ctor.name || metadata?.sel || 'Unknown';
+        const componentFeatureFlagPath = metadata?.componentFeatureFlag?.path || 'Unknown';
+        throw new Error(`Component ${componentName} is disabled by the feature flag at ${componentFeatureFlagPath}.`);
+    }
     const { shadowSupportMode: ctorShadowSupportMode, renderMode: ctorRenderMode, formAssociated: ctorFormAssociated, } = Ctor;
     if (process.env.NODE_ENV !== 'production') {
         const ctorName = Ctor.name;
@@ -6724,6 +6731,14 @@ function getComponentAPIVersion(Ctor) {
 function supportsSyntheticElementInternals(Ctor) {
     return registeredComponentMap.get(Ctor)?.enableSyntheticElementInternals || false;
 }
+function isComponentFeatureEnabled(Ctor) {
+    const flag = registeredComponentMap.get(Ctor)?.componentFeatureFlag;
+    // Default to true if not provided
+    return flag?.value !== false;
+}
+function getComponentMetadata(Ctor) {
+    return registeredComponentMap.get(Ctor);
+}
 function getTemplateReactiveObserver(vm) {
     const reactiveObserver = createReactiveObserver(() => {
         const { isDirty } = vm;
@@ -8751,5 +8766,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.23.0 */
+/** version: 8.24.0 */
 //# 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.23.0",
+    "version": "8.24.0",
     "description": "Core LWC engine APIs.",
     "keywords": [
         "lwc"
@@ -46,9 +46,9 @@
         }
     },
     "dependencies": {
-        "@lwc/features": "8.23.0",
-        "@lwc/shared": "8.23.0",
-        "@lwc/signals": "8.23.0"
+        "@lwc/features": "8.24.0",
+        "@lwc/shared": "8.24.0",
+        "@lwc/signals": "8.24.0"
     },
     "devDependencies": {
         "observable-membrane": "2.0.0"