assign-gingerly 0.0.40 → 0.0.41

package/README.md

@@ -4617,13 +4617,24 @@ customElements.assignFeatures(MyBehaviors, { anything: { spawn: AnythingImpl } }
 
 ### Lifecycle callback forwarding with `callbackForwarding`
 
-Features can receive custom element lifecycle callbacks by declaring `callbackForwarding` in their config:
+Features can receive custom element lifecycle callbacks by declaring `callbackForwarding` in their config. This can be specified by the feature author (in `static supportedFeatures`) and/or by the consumer (in `assignFeatures`). Both are merged — the author declares what the feature intrinsically needs, the consumer can add more:
 
 ```JavaScript
+// Author declares what the feature needs
+class MyElement extends HTMLElement {
+    static supportedFeatures = {
+        reflector: {
+            fallbackSpawn: Reflector,
+            callbackForwarding: ['connectedCallback', 'disconnectedCallback']
+        }
+    }
+}
+
+// Consumer can add more (but not remove author's)
 customElements.assignFeatures(MyElement, {
     reflector: {
         spawn: Reflector,
-        callbackForwarding: ['connectedCallback', 'disconnectedCallback']
+        callbackForwarding: ['adoptedCallback'] // merged with author's
     }
 });
 ```

package/assignFeatures.js

@@ -401,10 +401,15 @@ export function assignFeatures(ctr, features, featuresRegistry) {
         featuresRegistry.set(ctr, key, features[key]);
         // 5. Install the lazy getter on the prototype
         installFeatureGetter(ctr, key, featuresRegistry);
-        // 6. Install callback forwarding if configured
+        // 6. Install callback forwarding if configured (merge author + consumer)
         const featureConfig = features[key];
-        if (featureConfig.callbackForwarding && featureConfig.callbackForwarding.length > 0) {
-            installCallbackForwarding(ctr, key, featureConfig.callbackForwarding);
+        const optIn = supportedFeatures[key];
+        const authorCallbacks = optIn.callbackForwarding || [];
+        const consumerCallbacks = featureConfig.callbackForwarding || [];
+        // Union of both (author defaults + consumer additions)
+        const allCallbacks = [...new Set([...authorCallbacks, ...consumerCallbacks])];
+        if (allCallbacks.length > 0) {
+            installCallbackForwarding(ctr, key, allCallbacks);
         }
     }
     // 6. Install whenFeatureReady method if featuresConfig.lifecycleKeys is configured

package/assignFeatures.ts

@@ -65,6 +65,16 @@ export interface SupportedFeatureConfig {
      * }
      */
     getSharedContext?: (instance: any) => any;
+
+    /**
+     * Lifecycle callbacks that this feature requires.
+     * Serves as the default — the consumer can add more via FeatureConfig.callbackForwarding
+     * but cannot remove these.
+     * 
+     * Supported: 'connectedCallback', 'disconnectedCallback',
+     *            'attributeChangedCallback', 'adoptedCallback'
+     */
+    callbackForwarding?: string[];
 }
 
 /**
@@ -636,10 +646,15 @@ export function assignFeatures(
         // 5. Install the lazy getter on the prototype
         installFeatureGetter(ctr, key, featuresRegistry);
 
-        // 6. Install callback forwarding if configured
+        // 6. Install callback forwarding if configured (merge author + consumer)
         const featureConfig = features[key];
-        if (featureConfig.callbackForwarding && featureConfig.callbackForwarding.length > 0) {
-            installCallbackForwarding(ctr, key, featureConfig.callbackForwarding);
+        const optIn = supportedFeatures[key];
+        const authorCallbacks = optIn.callbackForwarding || [];
+        const consumerCallbacks = featureConfig.callbackForwarding || [];
+        // Union of both (author defaults + consumer additions)
+        const allCallbacks = [...new Set([...authorCallbacks, ...consumerCallbacks])];
+        if (allCallbacks.length > 0) {
+            installCallbackForwarding(ctr, key, allCallbacks);
         }
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assign-gingerly",
-  "version": "0.0.40",
+  "version": "0.0.41",
   "description": "This package provides a utility function for carefully merging one object into another.",
   "homepage": "https://github.com/bahrus/assign-gingerly#readme",
   "bugs": {