feat: language aware config step + hana changes

pipeline/preprocessors/__init__.py

@@ -1,5 +1,5 @@
 """Markdown preprocessors for documentation pipeline."""
 
-from .markdown_preprocessor import preprocess_markdown
+from .markdown_preprocessor import has_conditional_blocks, preprocess_markdown
 
-__all__ = ["preprocess_markdown"]
+__all__ = ["has_conditional_blocks", "preprocess_markdown"]

pipeline/preprocessors/markdown_preprocessor.py

@@ -14,6 +14,12 @@
 
 logger = logging.getLogger(__name__)
 
+CONDITIONAL_BLOCK_PATTERN = re.compile(
+    r"(?P<indent>[ \t]*):::(?P<language>\w+)\s*\n"
+    r"(?P<content>((?:.*\n)*?))"  # Capture the content inside the block
+    r"(?P=indent)[ \t]*:::"  # Match closing with same indentation
+)
+
 
 def _apply_conditional_rendering(md_text: str, target_language: str) -> str:
     """Apply conditional rendering to markdown content.
@@ -37,12 +43,6 @@ def _apply_conditional_rendering(md_text: str, target_language: str) -> str:
         msg = "target_language must be 'python' or 'js'"
         raise ValueError(msg)
 
-    pattern = re.compile(
-        r"(?P<indent>[ \t]*):::(?P<language>\w+)\s*\n"
-        r"(?P<content>((?:.*\n)*?))"  # Capture the content inside the block
-        r"(?P=indent)[ \t]*:::"  # Match closing with same indentation
-    )
-
     def replace_conditional_blocks(match: re.Match) -> str:
         """Keep active conditionals."""
         language = match.group("language")
@@ -58,7 +58,12 @@ def replace_conditional_blocks(match: re.Match) -> str:
         # If the language does not match, return an empty string
         return ""
 
-    return pattern.sub(replace_conditional_blocks, md_text)
+    return CONDITIONAL_BLOCK_PATTERN.sub(replace_conditional_blocks, md_text)
+
+
+def has_conditional_blocks(md_text: str) -> bool:
+    """Check if the markdown content has conditional blocks."""
+    return CONDITIONAL_BLOCK_PATTERN.search(md_text) is not None
 
 
 def preprocess_markdown(

pipeline/tools/mintlify.py

@@ -0,0 +1,47 @@
+"""TypedDict definitions for Mintlify docs.json configuration structure."""
+
+from __future__ import annotations
+
+from typing import TypedDict
+
+
+class MintlifyConfig(TypedDict):
+    """Mintlify config."""
+
+    navigation: Navigation
+
+
+class Navigation(TypedDict, total=False):
+    """Navigation configuration."""
+
+    versions: list[NavigationVersion] | None
+
+
+class NavigationVersion(TypedDict, total=False):
+    """Version within a navigation."""
+
+    version: str
+    dropdowns: list[NavigationDropdown] | None
+    tabs: list[NavigationTab] | None
+
+
+class NavigationDropdown(TypedDict, total=False):
+    """Dropdown within a version."""
+
+    dropdown: str
+    icon: str
+    tabs: list[NavigationTab] | None
+
+
+class NavigationTab(TypedDict, total=False):
+    """Tab within a version."""
+
+    tab: str
+    groups: list[NavigationGroup] | None
+
+
+class NavigationGroup(TypedDict):
+    """Group within a tab."""
+
+    group: str
+    pages: list[str | NavigationGroup]