Add dynamic lookup for enterprise SASL mechanisms from source code (#137)

* fix(property-extractor): Dynamic enterprise value resolution and improved type extraction

- Add dynamic lookup for enterprise SASL mechanisms from source code
- Fix template type extraction with proper bracket-counting for nested templates
- Implement constexpr identifier resolution for accurate default values
- Refactor FriendlyDefaultTransformer with production-ready architecture
- Eliminate hardcoded values in favor of dynamic source code analysis
- Add comprehensive error handling and performance optimizations
- Bump package version to 4.10.1

Resolves issues where enterprise properties showed function names instead of
actual values and improves overall code quality with zero hardcoded fallbacks.

* Apply suggestions

* 📝 Add docstrings to `config-prop-fixes` (#138)

Docstrings generation was requested by @JakeSCahill.

* #137 (comment)

The following files were modified:

* `tools/property-extractor/property_extractor.py`
* `tools/property-extractor/transformers.py`

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Update paths

* Fix paths

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

Author: JakeSCahill

bin/doc-tools.js

@@ -1111,6 +1111,8 @@ automation
       } else {
         env.OUTPUT_JSON_DIR = path.resolve(outputDir, 'examples');
         env.OUTPUT_AUTOGENERATED_DIR = path.resolve(outputDir);
+        // Set property files to go to properties subdirectory
+        env.OUTPUT_ASCIIDOC_DIR = path.resolve(outputDir, 'pages', 'properties');
       }
 
       const r = spawnSync('make', args, { cwd, stdio: 'inherit', env });

package-lock.json

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

package.json

@@ -111,10 +111,10 @@ generate-docs: node-deps
 	@# Use the enhanced properties file (with overrides) for documentation generation if it exists
 	@if [ -f "$(TOOL_ROOT)/gen/$(TAG)-properties.json" ]; then \
 	  cd $(TOOL_ROOT) && \
-	    node generate-handlebars-docs.js "gen/$(TAG)-properties.json" "$(OUTPUT_AUTOGENERATED_DIR)"; \
+	    node generate-handlebars-docs.js "gen/$(TAG)-properties.json" "$(OUTPUT_ASCIIDOC_DIR)"; \
 	else \
 	  cd $(TOOL_ROOT) && \
-	    node generate-handlebars-docs.js "gen/properties-output.json" "$(OUTPUT_AUTOGENERATED_DIR)"; \
+	    node generate-handlebars-docs.js "gen/properties-output.json" "$(OUTPUT_ASCIIDOC_DIR)"; \
 	fi
 	@echo "📄 Copying properties JSON files to $(OUTPUT_JSON_DIR)…"
 	@if [ -f "$(TOOL_ROOT)/gen/$(TAG)-properties.json" ]; then \

tools/property-extractor/Makefile

@@ -60,7 +60,17 @@ NOTE: Some cluster properties require that you restart the cluster for any updat
     sectionTitle: 'Cluster configuration',
     groups: [
       {
-        filter: (prop) => prop.config_scope === 'cluster' && !prop.is_deprecated
+        filter: (prop) => prop.config_scope === 'cluster' && !prop.is_deprecated && !(
+          prop.name && (
+            prop.name.includes('cloud_storage') ||
+            prop.name.includes('s3_') ||
+            prop.name.includes('azure_') ||
+            prop.name.includes('gcs_') ||
+            prop.name.includes('archival_') ||
+            prop.name.includes('remote_') ||
+            prop.name.includes('tiered_')
+          )
+        )
       }
     ],
     filename: 'cluster-properties.adoc'
@@ -269,7 +279,8 @@ function generateDeprecatedDocs(properties, outputDir) {
   };
 
   const output = template(data);
-  const outputPath = path.join(outputDir, 'deprecated', 'partials', 'deprecated-properties.adoc');
+  // Navigate back from pages/properties to reference, then into partials/deprecated
+  const outputPath = path.join(path.dirname(path.dirname(outputDir)), 'partials', 'deprecated', 'deprecated-properties.adoc');
 
   fs.mkdirSync(path.dirname(outputPath), { recursive: true });
   fs.writeFileSync(outputPath, output, 'utf8');
@@ -332,7 +343,7 @@ function generateAllDocs(inputFile, outputDir) {
 
   // Generate each type of documentation
   for (const [type, config] of Object.entries(PROPERTY_CONFIG)) {
-    const count = generatePropertyDocs(properties, config, path.join(outputDir, 'pages'));
+    const count = generatePropertyDocs(properties, config, outputDir);
     totalProperties += count;
 
     if (type === 'broker') totalBrokerProperties = count;
@@ -342,7 +353,7 @@ function generateAllDocs(inputFile, outputDir) {
   }
 
   // Generate deprecated properties documentation
-  const deprecatedCount = generateDeprecatedDocs(properties, path.join(outputDir, 'pages'));
+  const deprecatedCount = generateDeprecatedDocs(properties, outputDir);
 
   // Generate summary file
   const allPropertiesContent = Object.keys(properties).sort().join('\n');