Changelog

Added

• Monorepo test suite — Root Vitest runner and config (vitest.config.ts, pnpm test, pnpm test:watch) with a centralized tests/ layout and baseline coverage across core, cli, mdx, mdc, and next-dev.
• Registry JSON Schema — registry/schema.json now exists and matches the $schema reference in registry-index.json, enabling editor validation for version + items.
• Watcher integrations — @document0/next-dev for Next.js dev-time content invalidation without sidecar routes; @document0/core/watch for runtime-agnostic file watching (watchDocsSource / stopWatchingDocsSource).

Changed

• Slimmed @document0/core barrel export — Types, plugin, source, tree, and navigation remain in the barrel; search, llms, openapi, and graph are now only available via subpath exports (e.g. @document0/core/search). All doc examples updated accordingly.
• Deduplicated MDC processor pipeline — Extracted shared parseFrontmatter() helper in processor.ts, eliminating duplicated frontmatter parsing in processMdc and processMdcToHtml.
• Deduplicated MDX processor pipeline — Extracted shared.ts with parseFrontmatter(), buildRemarkPlugins(), and buildRehypePlugins(). Both processor.ts and html-processor.ts now import from shared.ts.
• Typed cache on DocsSource — Replaced the public _cache with a private map and a typed getOrSet<T>(key, factory) method. The search module now uses getOrSet instead of directly accessing the internal map.
• Deduplicated readMeta — Extracted readMeta from source/index.ts into a new core/src/meta.ts module, shared by both source/index.ts and tree/index.ts.
• Async FS throughout — Replaced all synchronous fs.readdirSync, fs.readFileSync, and fs.existsSync calls with fs.promises equivalents in source/index.ts and tree/index.ts. Propagated async through DocsSource methods (getPages, getPageTree, getPage, getPageByUrl, getMeta), buildPageTree, and all callers.
• Type-safe OpenAPI module — Replaced unsafe as casts with isObj, str, bool, arr type-guard helpers for safe property access with fallbacks. Non-object entries are now filtered out instead of silently producing wrong data.
• Skip redundant frontmatter parsing — processMdx, processMdxToHtml, processMdc, and processMdcToHtml now accept optional pre-parsed frontmatter and content, avoiding re-reading and re-parsing the raw file on every call.
• CLI add/update path validation — installPath must resolve inside the current project root, each file path must resolve inside the validated install directory, and unsafe paths now fail fast with an explicit error.
• CLI safe command execution — Replaced string-based execSync with argument-based execFileSync(command, args) for dependency installs, removing shell command concatenation from registry-controlled values.

Removed

• "./plugins" subpath export — Removed from @document0/core. Reading-time is now provided only via the plugin registry (registry/plugins/document0/reading-time); consumers install it with the CLI or copy the registry snippet.

Performance

• O(n) orderByMeta — Replaced O(n²) findIndex+splice loop with a pre-built Map<string, TreeNode> keyed on slug tails, URL tails, and folder names. Unmatched nodes are appended in a single pass.
• O(n) buildPageTree — Pre-computed pagesByDir and childDirs maps replace O(n²) page filtering at each recursion level with O(1) directory lookups.
• O(1) getPageNeighbours — Added a WeakMap-cached URL→index map so lookups use Map.get instead of findIndex on every call.
• O(1) ContentGraph link lookups — Replaced linear links.filter() in getLinks, getBacklinks, and getBrokenLinks with Map<string, LinkInfo[]> indexes built once at construction time.
• Single-parse processMdcToHtml — TOC is now extracted from the same HAST tree produced by a single parse+run, eliminating a redundant second pipeline pass.
• Cached unified processors — WeakMap-based processor caching keyed on the highlighter instance for processMdc, processMdcToHtml, and processMdxToHtml. The frozen processor is reused across calls, avoiding redundant pipeline construction per page.

Added

• Registry (document0/openrouter-chat) — index.ts server helper: Vercel AI SDK streaming chat through OpenRouter, with a search tool wired to documentation context (zod schemas). AiChat.tsx: slide-out sheet, user/assistant messages, Shiki-highlighted fenced code, lightweight markdown for assistant text, hover-to-reveal code copy, resizable sheet width with persistence.
• docs app — app/api/chat/route.ts delegates to the openrouter-chat plugin; docs-specific layout mounts AiChat; tsconfig path @registry/* → registry/* for cleaner imports.

Fixed

• registry/ui/document0/sidebar (MobileSidebar) — Portal backdrop and document.body scroll lock run only after mount, avoiding SSR/client HTML mismatches from createPortal.
• registry/ui/document0/openrouter-chat (AiChat) — Fixed Cannot read properties of undefined (reading 'trim') crash when initialized.
• Plugins layout — Replaced overflow-x-hidden with overflow-x: clip on the plugins page wrapper, restoring sticky sidebar positioning (same fix previously applied to the docs layout).
• Webpack / Shiki — Added null-loader rule for .d.mts declaration files in next.config.ts so Shiki's dynamic import("shiki/bundle/web") in the client-side AiChat component no longer crashes the production build.

Changed

• Changelog page — Preamble (format notes) and the Unreleased section are now filtered out at render time in app/changelog/page.tsx, keeping them in CHANGELOG.md but hidden from the published page.

Added

• @document0/mdc — New package for MDC (Markdown Components): unified pipeline with remark-mdc, remark-gfm, frontmatter via gray-matter, rehype (raw, slug, stringify), and Shiki highlighting via @shikijs/rehype. Exports processMdc / processMdcToHtml, AST types (MdcRoot, MdcNode, TocEntry, etc.), and rehypeShiki / rehypeStripShikiStyle helpers.
• @document0/mdx — processMdxToHtml (html-processor.ts): compile Markdown/MDX to a standalone HTML string (unified remark → rehype → stringify) with the same GFM, optional Shiki, and TOC extraction as the JSX-oriented processor, without requiring React at runtime.
• packages/template-nextjs — Standalone Next.js starter (App Router docs layout, shadcn-style UI primitives, MDX wiring, sample content/docs). Replaces the old single packages/template layout for published tarballs.
• packages/template-vue — Standalone Vue 3 + Vite starter: MdcRenderer.vue using @document0/mdc, doc shell with MobileSidebar, dev server that serves processed MDX/Markdown (server/api.ts), and prerender script (server/prerender.ts) for static HTML output.
• create-document0 — Interactive framework choice (Next.js vs Vue); copies template-nextjs or template-vue; rewrites package.json name; strips workspace: dependency specifiers so generated projects install from npm; prints correct dev URL (/docs vs Vite default port).
• apps/vue-preview — Vite + Vue app to preview registry Vue components: build plugin copies registry/ui → .registry/ui, resolves imports for live component previews; vercel.json for deployment; supports VUE_PREVIEW_URL from the main docs app for iframe previews.
• Registry (document0-vue) — Vue ports and previews: Sidebar / SidebarNode, TableOfContents, Breadcrumbs, PageNavigation, SearchDialog.
• Registry (fumadocs) — Documentation-style UI building blocks: Accordion, Banner, CodeBlock, Files, Steps (plus steps.css), Tabs; docs app includes matching preview entry points under components/previews/.
• apps/docs/lib/source.ts — Loads registry/registry-index.json, exposes getRegistry, getItemBySlug, getItemSource (reads plugin/UI source from registry/plugins or registry/ui), and getPluginsTree() for the plugins navigation tree.
• Documentation (MDX) — New or expanded pages: mdc, search, llms-txt, meta-json, custom-components (evolved from the old guides index); per-stack guides nextjs, vue, react-vite, svelte, astro, angular; _meta.json nav sections (Getting Started, API Reference, Tooling, Guides, Frameworks). cli.mdx expanded; core.mdx, installation, quickstart, and index updated for multi-framework and new APIs.
• Plugins section UX — /plugins index with search and CLI preview; per-item pages use Shiki for source, copy control, and dynamic React previews for document0/* and fumadocs/* items; optional Vue iframe previews when VUE_PREVIEW_URL is set.
• Root package.json — Declares license: MIT; scripts build:mdc, dev:mdc, typecheck:mdc, dev:docs (docs + vue-preview); build excludes template-nextjs from the generic packages/* build (template is not a library artifact).
• scripts/bump-version.mjs — Version bumps now include packages/mdc, template-nextjs, and template-vue (no longer packages/template).
• LICENSE — MIT license file at repo root (copyright notice as committed).
• README.md — DeepWiki “Ask” badge link.

Removed

• docs app — Deleted local sidebar.tsx, search-dialog.tsx, breadcrumbs.tsx, page-navigation.tsx, and table-of-contents.tsx under apps/docs/components/ (replaced by registry imports; see Changed).

Changed

• docs app UI source of truth — Sidebar, search dialog, breadcrumbs, page navigation, and TOC are imported from registry/ui/document0/... so the docs site matches the CLI-shipped components.
• Plugins sidebar data model — getPluginsTree() groups items by registry category: separators Plugins (nested folders MDX, Core) and UI Components; UI entries are grouped by base namespace with framework subfolders when multiple variants exist (e.g. document0 vs document0-vue), using namespace suffix rules (-vue, -react, etc.).
• @document0/core — BreadcrumbItem.url is now optional (string | undefined) for trees that supply display-only crumbs.
• @document0/cli add — After installing files, detects .css assets from the registry item and prints explicit @import hints for the user’s global stylesheet.
• Registry index — Large expansion: new namespaces, items, framework metadata, and install paths for the above UI and plugin entries.
• pnpm lockfile and workspace package manifests updated for new apps, templates, and AI / Shiki / MDC-related dependencies.

Fixed

• Sticky layout — Docs shell no longer uses overflow-x-hidden (which broke position: sticky for sidebar/TOC). html / body use overflow-x: clip instead of hidden; the main prose wrapper uses overflow-x-auto so wide content scrolls without trapping sticky descendants.
• vue-preview / Vite / Vercel — Build and deploy fixes for the preview app (including mobile-oriented layout adjustments where applicable).

Removed

Remove the now unused fs import and stripFrontMatter helper.

Changed

• Added _cache = new Map<string, unknown>() to DocsSource - a generic instance-scoped cache that any module can use. invalidate() now also calls this._cache.clear(). Removed module-level cachedDb and cachedSourceRef singletons. getOrCreateDb() now reads/writes via source._cache using a _searchDb key. Each DocsSource instance gets its own isolated Orama DB, and it's automatically cleared on invalidate(). This fixes the singleton anti-pattern. Multiple DocsSource instances now each maintain their own search index, and hot-reload works correctly via invalidate().

• Removed the _meta.ts and _meta.js candidates that were never actually supported. Only _meta.json is now supported. Now directly checks for _meta.json only, consistent with readMetaFromDir in tree/index.ts.

• generateLlmsFullTxt - replaced fs.readFileSync(page.filePath) + stripFrontMatter() with page.content (already in memory, already fronmatter-stripped by gray-matter during scan).

• getPageRawContent - same fix as above. No more redundant disk reads at request time.

• Added _slugMap and _urlMap (Map<string, PageData>) fields, populated once when getPages() first loads.

• getpage(slug) - now 0(1) via _slugMap.get(slug) instead of .find()

• getPageByUrl(url) - now 0(1) via _urlMap.get(url) instead of .find()

• Added lockfile for component/plugin versions. Update CLI commands for update command. Update registry-index for namespaces

Removed

• buildSearchIndex and searchPages — Legacy sync search API removed from @document0/core. Use createSearchRoute instead.
• SearchIndex type removed from @document0/core. Use SearchResult instead.

Changed

• buildOpenAPISearchIndex now returns SearchResult[] instead of the removed SearchIndex[].
• createSearchRoute (Orama-backed, async, with fuzzy matching and relevance ranking) is now the single canonical search API.
• Documentation and registry references updated to point at createSearchRoute.
• Added _cache = new Map<string, unknown>() to DocsSource - a generic instance-scoped cache that any module can use. invalidate() now also calls this._cache.clear(). Removed module-level cachedDb and cachedSourceRef singletons. getOrCreateDb() now reads/writes via source._cache using a _searchDb key. Each DocsSource instance gets its own isolated Orama DB, and it's automatically cleared on invalidate(). This fixes the singleton anti-pattern. Multiple DocsSource instances now each maintain their own search index, and hot-reload works correctly via invalidate().