diff --git a/changelog.mdx b/changelog.mdx index d6484ff67..3980efbf8 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -5,6 +5,148 @@ rss: true noindex: true --- + + ## New features + + - **Standard Markdown file support**: You can now use standard `.md` files in addition to `.mdx` files in your documentation, making it easier to migrate existing Markdown content without conversion + - **Custom syntax highlighting**: Add support for custom programming languages in code blocks through the `styling.codeblocks.customLanguages` field in `docs.json`, enabling syntax highlighting for domain-specific languages with custom Shiki grammars + - **PowerShell and Swift code examples**: API playground now generates code examples in PowerShell and Swift, expanding language support for API testing and integration + - **View component**: New `` component for conditional rendering based on screen size or other display properties + + ## API playground improvements + + - Fixed issue where switching between response examples with different indices would fail to render the response section + - Resolved double Authorization header bug that was causing authentication issues in API requests + - Fixed oneOf schema rendering issues that were causing incorrect field displays in complex API schemas + - Improved response example generation to properly merge and display all required properties + - Fixed missing path parameters on certain API documentation pages + - Fixed extra separator appearing in array item schemas with no contents + - Fixed missing prefill examples in object arrays + - Improved handling of primitive parameters to ensure they're properly displayed + - Fixed description padding and layout issues in API playground modals + - Enhanced request body type and response body type synchronization with code examples + - Fixed missing query parameter descriptions in API documentation + - Improved performance of API playground inputs to reduce lag during typing + - Object fields now properly respect the `expanded` setting from `docs.json` configuration + - Fixed prefilling from `schema.example` to properly populate example values + - Fixed request example generation for top-level oneOf types + - Fixed type labels to display more accurate information about field types + - Fixed Coinbase playground issues for specific endpoints + - Improved handling of circular schema references to properly render descriptions + - Fixed various API page rendering issues including missing fields and incorrect layouts + + ## Web editor enhancements + + - Branch switching is now fully integrated into the editor UI with improved navigation and state management + - Fixed race condition when committing changes that could cause branch SHA mismatches + - Removed implicit folder directory logic for cleaner file organization + - Fixed file creation and renaming to properly match original file locations in MDX frontmatter + - Improved folder state persistence across editor sessions + - Fixed branch navigation where changing URL to specific branch would redirect incorrectly + - Added merge conflict resolution tracking and improved conflict dialog functionality + - Fixed file state updates after committing changes + - Spaces in file rename inputs are now automatically replaced with dashes for consistency + - Added video support in the editor for embedding video content + - Fixed handling of moving files to previously deleted paths + + ## Component and styling enhancements + + - **Badge component**: New `` component for displaying status indicators, labels, and tags with customizable colors + - Images can now be zoomed with improved overlay styling for both light and dark modes + - Fixed image icon backgrounds for dark mode to prevent display issues + - Fixed CardGroup prose styles to ensure proper text formatting within cards + - Fixed italic font rendering issues across the documentation + - Updated gray colors to new design system values for better consistency + - Fixed callouts nested items colors for improved readability + - Fixed font rendering for single code items to use proper monospace fonts + - Improved inline code selection to select only code content on triple-click + + ## Navigation and UI improvements + + - Tab hover indicators now have improved styling with consistent tab titles + - Fixed top-level tabs rendering and navigation + - Fixed page top padding for better visual consistency + - Long words now wrap properly with `overflow-wrap` to prevent horizontal scrolling + - Step component now handles cases where no step title is provided + - Fixed heading IDs to properly handle question marks and special characters for anchor links + - Icon component now accepts `className` prop for custom styling + - Fixed theme toggle colors for better visibility in both light and dark modes + - External links now properly open in new tabs + - Fixed badge position inside navigation group dropdowns + - Improved alignment for table headers and cells with tabular numbers + - Fixed scroll behavior for tables inside tabs and steps inside tabs + + ## Performance and infrastructure + + - Shiki themes are now lazy loaded for improved initial page load performance + - Reduced navigation lag by optimizing prefetching behavior + - KaTeX CSS is now conditionally loaded only when needed, reducing unnecessary asset loading + - Added YAML support to Shiki language constants for better syntax highlighting coverage + - Improved custom font loading user experience with better error handling + + ## Bug fixes and reliability + + - Fixed 500 errors in dashboard caused by Shiki syntax highlighting issues + - Fixed empty expandable objects in API documentation + - Removed example data for additional properties to prevent confusion + - Fixed propagation of required fields in oneOf schemas + - Fixed duplicated descriptions in API documentation + - Fixed missing parent names with dots in schema paths + - Fixed description rendering above tabs for objects with oneOf description combinations + - Improved handling of allOf schemas to properly concatenate descriptions + - Fixed missing defaults with allOf schemas + - Fixed unique key assignment to properly account for array indices in API fields + - Improved error messages for invalid URLs in API configurations + - Fixed playground error display to prevent height shrinking + - Fixed redirect behavior for OAuth to properly include base paths + - Removed dual base path issues in authentication login links + - Fixed sidebar display on non-API pages + - Fixed OG image generation with better truncation logic and Google Fonts support + - Fixed table of contents rendering issues + - Fixed favicon isolation to prevent conflicts between different documentation sites + - Fixed keyboard shortcut styles inside callouts for dark mode + - Fixed Palm theme sidebar styling issues + - Fixed zoomed image overlay background color for light theme + - Fixed scroll height capping for very long API responses + - Fixed button variants for consistent styling across the dashboard + + ## CLI improvements + + - Added error logging for lower Node.js versions to help users identify compatibility issues + - Fixed max file size validation in CLI (increased from 5MB to 20MB) + - Custom syntax highlighting now works properly in CLI local development + - Added early failure if Node 25 is being used with `mint dev` command + - Fixed CLI bugs on Windows and added tests to prevent regressions + + ## Security enhancements + + - Improved redirect validation to prevent XSS and open redirect vulnerabilities + - Enhanced path traversal defense mechanisms + - Disallowed direct access to internal markdown, RSS, and MCP routes via `_mintlify` path + - Improved authentication security with better validation and error handling + - Added validation for organization ownership before setting GitHub sources + + ## Dashboard improvements + + - Fixed dashboard design inconsistencies and improved spacing throughout + - Improved button sizing and layout for organization invitations + - Fixed disabled state for editor publish button + - Added better handling for links in dashboard assistant chat + - Fixed outline issues for chat assistant in Firefox + - Improved deployment history with pagination support + - Added cursor pagination to preview deployments table + - Fixed preview deployments to only return preview environment deployments + - Improved email validation with explicit error messages + - Fixed whitespace handling in email address validation + + ## Localization + + - Added support for additional languages in authentication flows + - Updated translations for contextual menu and assistant features + - Improved language selector functionality across all themes + + + ## New features