@redpanda-data/docs-extensions-and-macros 4.6.8 → 4.6.10

package/bin/doc-tools.js

@@ -273,13 +273,14 @@ After installation, verify with:
 
   // Check for C++ standard library headers (critical for tree-sitter compilation)
   let tempDir = null;
+  let compileCmd = null;
   try {
     const testProgram = '#include <functional>\nint main() { return 0; }';
     tempDir = require('fs').mkdtempSync(require('path').join(require('os').tmpdir(), 'cpp-test-'));
     const tempFile = require('path').join(tempDir, 'test.cpp');
     require('fs').writeFileSync(tempFile, testProgram);
 
-    const compileCmd = cppCompiler === 'gcc' ? 'gcc' : 'clang++';
+    compileCmd = cppCompiler === 'gcc' ? 'gcc' : 'clang++';
     execSync(`${compileCmd} -x c++ -fsyntax-only "${tempFile}"`, { stdio: 'ignore' });
     require('fs').rmSync(tempDir, { recursive: true, force: true });
   } catch {
@@ -293,23 +294,23 @@ After installation, verify with:
     }
     fail(`C++ standard library headers are missing or incomplete.
 
-This error typically means:
-1. No C++ compiler is installed, OR
-2. Xcode Command Line Tools are missing/incomplete
+1. **Test if the issue exists**:
+   echo '#include <functional>' | ${compileCmd} -x c++ -fsyntax-only -
 
-To fix this on macOS:
-1. Install Xcode Command Line Tools:
-   xcode-select --install
-
-2. If already installed, reset the developer path:
+2. **If the test fails, try these fixes in order**:
+   **Fix 1**: Reset developer path
    sudo xcode-select --reset
 
-3. For Xcode users, ensure correct path:
-   sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
+   **Fix 2**: Force reinstall Command Line Tools
+   sudo rm -rf /Library/Developer/CommandLineTools
+   xcode-select --install
 
-4. Verify the fix:
-   echo '#include <functional>' | ${cppCompiler || 'clang++'} -x c++ -fsyntax-only -
+   Complete the GUI installation dialog that appears.
 
+3. **Verify the fix**:
+   echo '#include <functional>' | ${compileCmd} -x c++ -fsyntax-only -
+   If successful, you should see no output and the command should exit with code 0.
+`);
   }
 }
 

package/extensions/find-related-labs.js

@@ -31,7 +31,7 @@ function findRelated(labPage, sourceCategoryList, sourceDeploymentType, logger)
   const targetCategoryList = pageCategories.split(',').map(c => c.trim());
   const targetDeploymentType = getDeploymentType(targetAttributes)
   const categoryMatch = hasMatchingCategory(sourceCategoryList, targetCategoryList)
-  if (categoryMatch && (!targetDeploymentType ||sourceDeploymentType === targetDeploymentType || (targetDeploymentType === 'Docker' && !sourceDeploymentType))) {
+  if (categoryMatch && isCompatibleDeployment(sourceDeploymentType, targetDeploymentType)) {
     return {
       title: labPage.asciidoc.doctitle,
       url: labPage.pub.url,
@@ -51,4 +51,21 @@ function getDeploymentType (attributes) {
 
 function hasMatchingCategory (sourcePageCategories, targetPageCategories) {
   return sourcePageCategories.every((category) => targetPageCategories.includes(category))
+}
+
+function isCompatibleDeployment (sourceDeploymentType, targetDeploymentType) {
+  // If no target deployment type specified, it's compatible with everything
+  if (!targetDeploymentType) return true
+
+  // Cloud pages show only cloud labs
+  if (sourceDeploymentType === 'Redpanda Cloud') {
+    return targetDeploymentType === 'Redpanda Cloud'
+  }
+
+  // All other cases (Kubernetes, Docker, Linux, or no deployment type) show Docker and Kubernetes
+  if (targetDeploymentType === 'Docker' || targetDeploymentType === 'Kubernetes') {
+    return true
+  }
+
+  return false
 }

package/package.json

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

package/tools/property-extractor/requirements.txt

@@ -1,2 +1,2 @@
-tree_sitter==0.20.4
+tree_sitter==0.21.1
 setuptools>=42.0.0