Pro 8152 anchors

CHANGELOG.md

@@ -18,6 +18,7 @@
 * Removes the non-functional `uniqueUsername` route from the `user` module
 * Updated dependencies to address deprecation warnings.
 
+* Modifies the `annotateAreaForExternalFront()` method of the `@apostrophecms/template` module to accept a per-module `annotateWidgetForExternalFront()` method. This allows widgets to send project-level options alongside the per-area options to external frontends.
 
 ## 4.21.0 (2025-09-03)
 

modules/@apostrophecms/template/index.js

@@ -432,8 +432,8 @@ module.exports = {
             const parse = config.parse
               ? config.parse
               : function (parser, nodes, lexer) {
-              // Default parser gets comma separated arguments,
-              // assumes no body
+                // Default parser gets comma separated arguments,
+                // assumes no body
 
                 // get the tag token
                 const token = parser.nextToken();
@@ -696,7 +696,7 @@ module.exports = {
           _.extend(args, data);
 
           if (req.aposError) {
-          // A 500-worthy error occurred already, i.e. in `pageBeforeSend`
+            // A 500-worthy error occurred already, i.e. in `pageBeforeSend`
             telemetry.handleError(span, req.aposError);
             span.end();
             return error(req.aposError);
@@ -739,8 +739,8 @@ module.exports = {
             span.setStatus({ code: telemetry.api.SpanStatusCode.OK });
             return content;
           } catch (e) {
-          // The page template threw an exception. Log where it
-          // occurred for easier debugging
+            // The page template threw an exception. Log where it
+            // occurred for easier debugging
             telemetry.handleError(span, e);
             return error(e);
           } finally {
@@ -1289,7 +1289,7 @@ module.exports = {
       // and `choices` properties, and guaranteeing that `items` exists,
       // at least as an empty array.
 
-      annotateAreaForExternalFront(field, area) {
+      async annotateAreaForExternalFront(field, area) {
         area.field = field;
         area.options = field.options;
         // Really widget configurations, but the method name is already set in
@@ -1303,11 +1303,27 @@ module.exports = {
             label: options.addLabel || manager.label || `No label for ${name}`
           };
         }).filter(choice => !!choice);
+
         area.items ||= [];
-        if (area._docId) {
-          for (const item of area.items) {
+        for (const item of area.items) {
+          // Add _docId if area has one
+          if (area._docId) {
             item._docId = area._docId;
           }
+
+          // Annotate each individual widget with its options
+          // Each widget must elect into this by creating an
+          // `annotateWidgetForExternalFront() method.
+          const manager = self.apos.area.getManager?.(item.type) ||
+            self.apos.area.widgetManagers?.[item.type];
+
+          let widgetOptions = {};
+          if (manager && typeof manager.annotateWidgetForExternalFront === 'function') {
+            widgetOptions = await manager.annotateWidgetForExternalFront() || {};
+          };
+          if (widgetOptions && Object.keys(widgetOptions).length > 0) {
+            item._options = widgetOptions;
+          }
         }
       }
     };

modules/@apostrophecms/widget-type/index.js

@@ -449,7 +449,12 @@ module.exports = {
           }
           return true;
         });
+      },
+
+      annotateWidgetForExternalFront() {
+        return {};
       }
+
     };
   },
   extendMethods(self) {