@lwc/engine-core 8.23.0 → 8.25.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

@@ -139,7 +139,7 @@ function addErrorComponentStack(vm, error) {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 const alreadyLoggedMessages = new Set();
-// Only used in LWC's Karma tests
+// Only used in LWC's integration tests
 if (process.env.NODE_ENV === 'test-lwc-integration') {
     window.__lwcResetAlreadyLoggedMessages = () => {
         alreadyLoggedMessages.clear();
@@ -2856,7 +2856,7 @@ function getDecoratorsMeta(Ctor) {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 let warned = false;
-// Only used in LWC's Karma tests
+// Only used in LWC's integration tests
 if (process.env.NODE_ENV === 'test-lwc-integration') {
     window.__lwcResetWarnedOnVersionMismatch = () => {
         warned = false;
@@ -3137,7 +3137,7 @@ const VALID_SCOPE_TOKEN_REGEX = /^[a-zA-Z0-9\-_]+$/;
 // The "pure" annotations are so that Rollup knows for sure it can remove these from prod mode
 let stylesheetsToCssContent = /*@__PURE__@*/ new WeakMap();
 let cssContentToAbortControllers = /*@__PURE__@*/ new Map();
-// Only used in LWC's Karma tests
+// Only used in LWC's integration tests
 if (process.env.NODE_ENV === 'test-lwc-integration') {
     // Used to reset the global state between test runs
     window.__lwcResetStylesheetCache = () => {
@@ -3539,7 +3539,7 @@ let activeTemplates = /*@__PURE__@*/ new WeakMultiMap();
 let activeComponents = 
 /*@__PURE__@*/ new WeakMultiMap();
 let activeStyles = /*@__PURE__@*/ new WeakMultiMap();
-// Only used in LWC's Karma tests
+// Only used in LWC's integration tests
 if (process.env.NODE_ENV === 'test-lwc-integration') {
     // Used to reset the global state between test runs
     window.__lwcResetHotSwaps = () => {
@@ -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;
@@ -6219,7 +6226,7 @@ const MAX_CACHE_KEY = 3;
 // See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals#tagged_templates
 // Also note that this array only needs to be large enough to account for the maximum possible cache key
 const fragmentCache = shared.ArrayFrom({ length: MAX_CACHE_KEY + 1 }, () => new WeakMap());
-// Only used in LWC's Karma tests
+// Only used in LWC's integration tests
 if (process.env.NODE_ENV === 'test-lwc-integration') {
     window.__lwcResetFragmentCache = () => {
         for (let i = 0; i < fragmentCache.length; i++) {
@@ -6717,7 +6724,7 @@ function getComponentAPIVersion(Ctor) {
     const metadata = registeredComponentMap.get(Ctor);
     const apiVersion = metadata?.apiVersion;
     if (shared.isUndefined(apiVersion)) {
-        // This should only occur in our Karma tests; in practice every component
+        // This should only occur in our integration tests; in practice every component
         // is registered, and so this code path should not get hit. But to be safe,
         // return the lowest possible version.
         return shared.LOWEST_API_VERSION;
@@ -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.25.0 */
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.js

@@ -136,7 +136,7 @@ function addErrorComponentStack(vm, error) {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 const alreadyLoggedMessages = new Set();
-// Only used in LWC's Karma tests
+// Only used in LWC's integration tests
 if (process.env.NODE_ENV === 'test-lwc-integration') {
     window.__lwcResetAlreadyLoggedMessages = () => {
         alreadyLoggedMessages.clear();
@@ -2853,7 +2853,7 @@ function getDecoratorsMeta(Ctor) {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 let warned = false;
-// Only used in LWC's Karma tests
+// Only used in LWC's integration tests
 if (process.env.NODE_ENV === 'test-lwc-integration') {
     window.__lwcResetWarnedOnVersionMismatch = () => {
         warned = false;
@@ -3134,7 +3134,7 @@ const VALID_SCOPE_TOKEN_REGEX = /^[a-zA-Z0-9\-_]+$/;
 // The "pure" annotations are so that Rollup knows for sure it can remove these from prod mode
 let stylesheetsToCssContent = /*@__PURE__@*/ new WeakMap();
 let cssContentToAbortControllers = /*@__PURE__@*/ new Map();
-// Only used in LWC's Karma tests
+// Only used in LWC's integration tests
 if (process.env.NODE_ENV === 'test-lwc-integration') {
     // Used to reset the global state between test runs
     window.__lwcResetStylesheetCache = () => {
@@ -3536,7 +3536,7 @@ let activeTemplates = /*@__PURE__@*/ new WeakMultiMap();
 let activeComponents = 
 /*@__PURE__@*/ new WeakMultiMap();
 let activeStyles = /*@__PURE__@*/ new WeakMultiMap();
-// Only used in LWC's Karma tests
+// Only used in LWC's integration tests
 if (process.env.NODE_ENV === 'test-lwc-integration') {
     // Used to reset the global state between test runs
     window.__lwcResetHotSwaps = () => {
@@ -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;
@@ -6216,7 +6223,7 @@ const MAX_CACHE_KEY = 3;
 // See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals#tagged_templates
 // Also note that this array only needs to be large enough to account for the maximum possible cache key
 const fragmentCache = ArrayFrom({ length: MAX_CACHE_KEY + 1 }, () => new WeakMap());
-// Only used in LWC's Karma tests
+// Only used in LWC's integration tests
 if (process.env.NODE_ENV === 'test-lwc-integration') {
     window.__lwcResetFragmentCache = () => {
         for (let i = 0; i < fragmentCache.length; i++) {
@@ -6714,7 +6721,7 @@ function getComponentAPIVersion(Ctor) {
     const metadata = registeredComponentMap.get(Ctor);
     const apiVersion = metadata?.apiVersion;
     if (isUndefined$1(apiVersion)) {
-        // This should only occur in our Karma tests; in practice every component
+        // This should only occur in our integration tests; in practice every component
         // is registered, and so this code path should not get hit. But to be safe,
         // return the lowest possible version.
         return LOWEST_API_VERSION;
@@ -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.25.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.25.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.25.0",
+        "@lwc/shared": "8.25.0",
+        "@lwc/signals": "8.25.0"
     },
     "devDependencies": {
         "observable-membrane": "2.0.0"