Changelog

Experimentalv0.4.0-rc

Version links

Currentv0.4.0-rc

This page tracks changes to the docs system structure and conventions.

0.4.0-rcVersion links, localized search, and content templates

2026-03-20Current

Added support for disabling thinking on specific chat-completion models so model-specific behavior can be controlled at request time.
Expanded validation and plugin architecture: new config entries for frontmatter schema, missing translations, and heading depth, plus stronger schema typing for validation rules.
Introduced FrontmatterTypeRule and FrontmatterFieldRule, and implemented full frontmatter schema validation logic inside the validation pipeline.
Added a dedicated plugin runner to coordinate build hooks, then updated build and validation scripts to use that plugin architecture end to end.
Improved validation error handling and reporting, and refactored registry building to support plugins and context-aware execution.
Refined Ask Panel visibility logic and active-state styling so search and Ask transitions behave more predictably.
Updated package.json and site.config.ts for version consistency, dependency alignment, and configuration cleanup.
Added directive transformations for API documentation components, including leaf directives and support for ParamField, SchemaField, ParamTable, ResponseSchema, Endpoint, DoDont, VersionGate, CommandGroup, PreviewFrame, ReleaseItem, and Timeline.
Extended remarkDocsComponents, build-registry component aliases, navigation structure, starter kit content/config, and TypeScript exclusions so the new documentation primitives work cleanly across multilingual starter projects.
Added mdx-components.ts for MDX component collection and normalization, expanded registry/search metadata with aliases and version fields, introduced search-utils.ts for token expansion, and added versioning.ts for page-level version relationships.
Improved Chinese search and Ask AI retrieval by adding synonym expansion, route/component aliases, richer validation for new frontmatter fields, multilingual navigation-title support, and translated starter content.

0.3.0-rcCore registry and Ask AI

2026-03-12

Introduced the new typematter core library (configuration, plugin architecture, content registry, search indexing, validation), consolidating build-time extensibility.
Completed the plugin/build typing model (logger, build context, content page, validation report) and renamed ValidationReport to PluginValidationReport for consistency.
Added and integrated doc-quality validation rules: frontmatter, duplicates, empty directories, internal links/anchors, nav config, and orphan pages.
Expanded CLI capabilities: dev, build, validate, export-registry; and moved validation logic into a dedicated script for maintainability.
Strengthened typing in site/nav configuration (including explicit siteConfig annotation), and simplified repository config access in DocsShell.
Fixed repository URL access in nav config and import path issues in next-env.d.ts; upgraded Next.js to 16.1.6 and added PWA Service Worker support.
Added the full Ask AI path: DocsShell Ask config/context, Cloudflare Worker POST /v1/ask, ask-index generation, and hybrid recall flow.
Added Cloudflare AI Search static artifacts: automatic robots.txt and sitemap.xml generation.
Improved Ask AI UX: detailed error expand/copy, removed recentLimit in favor of assistant-style conversation UI, and Markdown answer rendering via ReactMarkdown.
Improved Worker and deployment operations: richer CORS/health origin diagnostics, plus environment variable templates and updated local/deploy docs.
Enhanced Ask-mode search modal responsiveness and expansion behavior (auto-expand after a question) across desktop and mobile.

0.2.0-betaExpanded MDX primitives

2026-02-03Beta

Added Annotation, Details, Steps/Step, and FileTree/FileTreeItem components to support annotations, collapsible sections, step flows, and file hierarchies in MDX.
Added Cards and Badge components (including inline syntax) and refreshed component docs/examples.
Extended the MDX pipeline to recognize new directives and render math via remark-math + rehype-katex.
Improved sidebar navigation behavior with a clearer close button.
Refined global body/html styles for better responsiveness and scrolling.
Cleaned up documentation links and expanded remarkCodeTabs typing to include TableNode.

0.1.5-alphaSearch and reading refinements

2026-01-31Alpha

Improved SearchModal with highlighted terms, clearer snippets, ellipsis handling, focus management, and autoFocus behavior.
Introduced CopyPageButton and Toc components for page copy and scroll-aware table of contents behavior.
Added CodeTabs and FeatureMatrix components for code switching and capability comparison.
Updated MDX rendering to support new directives (remark-directive, remark-code-tabs).
Expanded component docs and examples in both English and Chinese.

0.1.0-alphaInitial docs shell

2026-01-26Alpha

Initialized the Next.js App Router docs shell (MDX rendering, three-column layout, TOC, sidebar).
Established content/ as the single source of truth with cn/en structure and automatic nav/route generation.
Added the first search modal with full-text fuzzy matching and content snippets.
Added theme switching, route loading skeletons, and mobile sidebar interactions.
Shipped the initial doc components: Callout (Tip/Info/Warning/Deprecated), DiffBlock, Columns, and CodeBlock.
Added the build-time docs validation and configuration foundation.
Added lightweight syntax highlighting via rehype-highlight.