@redpanda-data/docs-extensions-and-macros 5.47.0 → 5.47.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redpanda-data/docs-extensions-and-macros",
-  "version": "5.47.0",
+  "version": "5.47.1",
   "description": "Antora extensions and macros developed for Redpanda documentation.",
   "keywords": [
     "antora",

package/tools/redpanda-connect/helpers/renderConnectDescription.js

@@ -93,10 +93,16 @@ function ensureHeadingSeparation (body) {
  * Single-backtick spans still apply attribute substitution, so spans are
  * escaped too; `----` listing blocks and ```/~~~ fences are verbatim and stay
  * untouched (a `\{` inside a fence would render as a literal backslash).
+ *
+ * The name may start uppercase or with an underscore, because environment
+ * variable placeholders are the common case in prose: Asciidoctor downcases
+ * a reference before looking it up, so ${SALESFORCE_CLIENT_SECRET} outside a
+ * fence is consumed exactly like a lowercase one and logs the missing
+ * attribute as salesforce_client_secret.
  */
 function escapePlaceholderBraces (body) {
   return annotateVerbatimLines(body).map(({ line, verbatim }) => (
-    verbatim ? line : line.replace(/(?<![\\{])\{([a-z][\w.-]{1,30})\}/g, '\\{$1}')
+    verbatim ? line : line.replace(/(?<![\\{])\{([A-Za-z_][\w.-]{1,30})\}/g, '\\{$1}')
   )).join('\n');
 }
 

package/tools/redpanda-connect/helpers/renderConnectFields.js

@@ -2,6 +2,7 @@ const yaml = require('yaml');
 const renderYamlList = require('./renderYamlList');
 const handlebars = require('handlebars');
 const { connectFieldName } = require('./flattenConnectFields');
+const { escapePlaceholderBraces } = require('./renderConnectDescription');
 
 /**
  * Renders the children of a configuration object into AsciiDoc.
@@ -68,7 +69,9 @@ module.exports = function renderConnectFields(children, prefix = '') {
     block += `=== \`${currentPath}\`\n\n`;
 
     // --- Beta badge logic (now uses is_beta) ---
-    let desc = child.description || '';
+    // Escaped before the badge is prepended, not after: the badge's own
+    // tooltip={page-beta-text} is a real attribute reference and must survive.
+    let desc = escapePlaceholderBraces(child.description || '');
     if (child.is_beta) {
       // Remove any leading "BETA:" label (case-insensitive, trims leading whitespace)
       desc = 'badge::[label=Beta, size=large, tooltip={page-beta-text}]\n\n' + desc.replace(/^\s*BETA:\s*/i, '');