@adobe/helix-html-pipeline 6.28.8 → 6.29.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [6.29.1](https://github.com/adobe/helix-html-pipeline/compare/v6.29.0...v6.29.1) (2026-05-04)
+
+
+### Bug Fixes
+
+* **deps:** update external fixes ([#1085](https://github.com/adobe/helix-html-pipeline/issues/1085)) ([58c9271](https://github.com/adobe/helix-html-pipeline/commit/58c92712ec61759ef89a14cc34ff94371abce212))
+
+# [6.29.0](https://github.com/adobe/helix-html-pipeline/compare/v6.28.8...v6.29.0) (2026-04-30)
+
+
+### Features
+
+* support id attribute in section metadata ([#1084](https://github.com/adobe/helix-html-pipeline/issues/1084)) ([0dd6f30](https://github.com/adobe/helix-html-pipeline/commit/0dd6f30e70c8305019d098dcadd96a701cd93625))
+
 ## [6.28.8](https://github.com/adobe/helix-html-pipeline/compare/v6.28.7...v6.28.8) (2026-04-19)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/helix-html-pipeline",
-  "version": "6.28.8",
+  "version": "6.29.1",
   "description": "Helix HTML Pipeline",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -56,7 +56,7 @@
     "mdast-util-to-hast": "13.2.1",
     "mdast-util-to-string": "4.0.0",
     "mime": "4.1.0",
-    "parse5": "8.0.0",
+    "parse5": "8.0.1",
     "rehype-format": "5.0.1",
     "rehype-parse": "9.0.1",
     "remark-parse": "11.0.0",
@@ -70,9 +70,9 @@
     "unist-util-visit-parents": "6.0.2"
   },
   "devDependencies": {
-    "@adobe/eslint-config-helix": "3.0.24",
-    "@eslint/config-helpers": "0.5.3",
-    "@markedjs/html-differ": "5.0.4",
+    "@adobe/eslint-config-helix": "3.0.26",
+    "@eslint/config-helpers": "0.5.5",
+    "@markedjs/html-differ": "5.0.5",
     "@semantic-release/changelog": "6.0.3",
     "@semantic-release/git": "10.0.1",
     "@semantic-release/npm": "13.1.5",
@@ -84,8 +84,8 @@
     "esmock": "2.7.3",
     "husky": "9.1.7",
     "js-yaml": "4.1.1",
-    "jsdom": "29.0.1",
-    "junit-report-builder": "5.1.1",
+    "jsdom": "29.0.2",
+    "junit-report-builder": "5.1.2",
     "lint-staged": "16.4.0",
     "mocha": "11.7.5",
     "mocha-multi-reporters": "1.5.1",

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

@@ -12,7 +12,7 @@
 import { toString } from 'hast-util-to-string';
 import { CONTINUE, SKIP, visit } from 'unist-util-visit';
 import { toMetaName } from '../utils/modifiers.js';
-import { getAbsoluteUrl, toBlockCSSClassNames } from './utils.js';
+import { getAbsoluteUrl, toBlockCSSClassNames, toSectionId } from './utils.js';
 
 /**
  * Checks whether section metadata processing is enabled for the current site.
@@ -107,6 +107,11 @@ export default function extractSectionMetadata(state) {
               parent.properties.className = [];
             }
             parent.properties.className.push(...getStyleClassNames($value));
+          } else if (name === 'id') {
+            const id = toSectionId(toString($value));
+            if (id) {
+              parent.properties.id = id;
+            }
           } else {
             const value = getValueFromNode(state, $value);
             parent.properties[`data-${name}`] = value;

package/src/steps/utils.js

@@ -80,6 +80,24 @@ export function wrapContent($parent, $node) {
   $node.children = [$parent];
 }
 
+/**
+ * Converts the given text to a valid HTML5 identifier (ID/NAME token):
+ * - converts to lowercase
+ * - collapses invalid characters to a single `-` (keeps letters, digits, `-`, `_`, `:`, `.`)
+ * - strips leading non-letter characters (must begin with [a-z])
+ * - strips trailing `-`
+ *
+ * @param {string} text input text
+ * @returns {string} the HTML identifier
+ */
+export function toSectionId(text) {
+  return (text || '')
+    .toLowerCase()
+    .replace(/[^0-9a-z._:-]+/g, '-')
+    .replace(/^[^a-z]+/, '')
+    .replace(/-+$/, '');
+}
+
 /**
  * Converts the given text to an array of CSS class names:
  * - extracts the list of options (given as CSV in braces at the end)