@adobe/helix-html-pipeline 6.27.30 → 6.28.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [6.28.0](https://github.com/adobe/helix-html-pipeline/compare/v6.27.30...v6.28.0) (2026-03-31)
+
+
+### Features
+
+* process section metadata on the server side ([#1058](https://github.com/adobe/helix-html-pipeline/issues/1058)) ([e9efcc2](https://github.com/adobe/helix-html-pipeline/commit/e9efcc2156f6b2154abee74c8175168ceb0c1c9a))
+
 ## [6.27.30](https://github.com/adobe/helix-html-pipeline/compare/v6.27.29...v6.27.30) (2026-03-25)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/helix-html-pipeline",
-  "version": "6.27.30",
+  "version": "6.28.0",
   "description": "Helix HTML Pipeline",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -86,7 +86,7 @@
     "js-yaml": "4.1.1",
     "jsdom": "28.1.0",
     "junit-report-builder": "5.1.1",
-    "lint-staged": "16.3.2",
+    "lint-staged": "16.4.0",
     "mocha": "11.7.5",
     "mocha-multi-reporters": "1.5.1",
     "mocha-suppress-logs": "0.6.0",

package/src/html-pipe.js

@@ -15,6 +15,7 @@ import createPageBlocks from './steps/create-page-blocks.js';
 import createPictures from './steps/create-pictures.js';
 import { contentSecurityPolicyOnCode } from './steps/csp.js';
 import extractMetaData from './steps/extract-metadata.js';
+import extractSectionMetadata from './steps/extract-section-metadata.js';
 import fetchContent from './steps/fetch-content.js';
 import fetch404 from './steps/fetch-404.js';
 import initConfig from './steps/init-config.js';
@@ -167,6 +168,7 @@ export async function htmlPipe(state, req) {
       await rewriteUrls(state);
       await fixSections(state);
       await createPageBlocks(state);
+      await extractSectionMetadata(state);
       await createPictures(state);
       await extractMetaData(state, req);
       await rewriteIcons(state);

package/src/site-config.d.ts

@@ -32,6 +32,19 @@ export interface PipelineSiteConfig {
   }
   cdn?: ProjectCDNConfig;
   access?: SiteAccessConfig;
+  features?: SiteFeatures;
+  /**
+   * ISO date string of when the site was created
+   */
+  created?: string;
+}
+export interface SiteFeatures {
+  rendering?: {
+    /**
+     * Rendering version. Version 2 enables server-side section metadata processing.
+     */
+    version?: number;
+  };
 }
 export interface ModifiersSheet {
   data: Modifiers;

package/src/steps/extract-section-metadata.js

@@ -0,0 +1,73 @@
+/*
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+import { toString } from 'hast-util-to-string';
+import { SKIP, visit } from 'unist-util-visit';
+import { toMetaName } from '../utils/modifiers.js';
+import { toBlockCSSClassNames } from './utils.js';
+
+/**
+ * Checks whether section metadata processing is enabled for the current site.
+ * It is enabled if the rendering version is >= 2, or if no version is set
+ * and the site was created on or after April 15, 2026.
+ * @param {PipelineSiteConfig} config
+ * @returns {boolean}
+ */
+function isSectionMetadataEnabled(config) {
+  const { version } = config.features?.rendering ?? {};
+  if (version !== undefined) {
+    return version >= 2;
+  }
+  return new Date(config.created) >= new Date('2026-04-15');
+}
+
+/**
+ * Processes section metadata blocks by applying their key/value pairs
+ * as data attributes on the parent section div, with special handling
+ * for the "style" key (added as class names).
+ * @type PipelineStep
+ * @param {PipelineState} state
+ */
+export default function extractSectionMetadata(state) {
+  if (!isSectionMetadataEnabled(state.config)) {
+    return;
+  }
+
+  const { hast } = state.content;
+
+  const isSectionMetadata = (node) => node.tagName === 'div'
+    && node.properties?.className?.includes('section-metadata');
+
+  visit(hast, isSectionMetadata, (node, index, parent) => {
+    // extract metadata from rows
+    for (const $row of node.children) {
+      if ($row.tagName === 'div' && $row.children?.[1]) {
+        const [$name, $value] = $row.children;
+        const name = toMetaName(toString($name));
+        if (name) {
+          const value = toString($value).trim();
+          if (name === 'style') {
+            if (!parent.properties.className) {
+              parent.properties.className = [];
+            }
+            parent.properties.className.push(...toBlockCSSClassNames(value));
+          } else {
+            parent.properties[`data-${name}`] = value;
+          }
+        }
+      }
+    }
+
+    // remove the section-metadata block from the section
+    parent.children.splice(index, 1);
+    return SKIP;
+  });
+}