Commit Graph
6 Commits
Author SHA1 Message Date
MervinPraisonandMervin Praison 192f40ee61 fix(docs): repair MDX escaping utilities and add reference-docs shim (fixes #60)
- Rewrite sanitize_type_for_mdx to collapse Callable/Literal/Coroutine and
  nested Optional[Union[...]] while preserving simple generics
- Make escape_mdx selectively escape unknown <tag>/{expr} while preserving
  valid Mintlify components and wrapping docstring code examples
- Auto-simplify complex nested types in escape_for_table
- Add validate_docs_json_structure and module-level VALID_MDX_TAGS
- Add missing hooks/mcp/policy icons to ICON_MAP
- Add scripts/generate_reference_docs.py shim (stdlib-only) so both test
  suites resolve the canonical generator implementation

tests/test_mdx_escaping.py: 7/7 pass; scripts/tests/test_mdx_escaping.py: 24/24 pass

Co-authored-by: Mervin Praison <[email protected]>
2026-07-27 12:01:35 +00:00
Mervin Praison dfcb2e1669 feat: Introduce a unified CLI, refactor documentation generation into a dedicated package, and add a CI workflow for automated documentation builds. 2026-01-26 10:48:12 +00:00
Mervin Praison d23bc9383c u 2026-01-26 09:44:17 +00:00
Mervin Praison 7f1cfd8ebc refactor: Update icon mappings and refactor reference documentation rendering to use improved markdown formatting and icon selection logic. 2026-01-26 09:41:53 +00:00
Mervin Praison af5e121d92 feat: Add Mermaid diagrams and enhance MDX escaping and type annotation sanitization for reference documentation. 2026-01-26 09:25:49 +00:00
Mervin Praison 294f7f46c7 update 2026-01-26 09:14:13 +00:00