openmaic-custom/packages/docs/components/docs-root-provider.tsx
wyuc 77bcd589e0
docs: add Fumadocs documentation site (#622)
* docs: add Fumadocs documentation site (packages/docs)

Static-exportable Fumadocs site for the OpenMAIC docs, served under /docs.
- 6 locales (en default + zh-CN/zh-TW/ja/ru/ar) with Arabic RTL
- English unprefixed (/docs/getting-started) to preserve legacy URLs;
  other locales at /docs/<lang>/<slug>
- Orama static search compatible with `output: 'export'`
- Brand theming via CSS variables; "Live Demo" link back to open.maic.chat

Kept fully isolated from the main app so it does not affect its build or CI:
- excluded from the pnpm workspace (own lockfile, build and deploy)
- ignored in .prettierignore (own toolchain, like the other packages)
- excluded from the root tsconfig so the main app build does not type-check it
ESLint already ignores packages/**.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* ci: add standalone docs build check

Validate that packages/docs still builds (next build + static export) on
PRs that touch it. Runs only on packages/docs changes; no secrets, no deploy.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs: address CR — CJK search, single-source locale config

- Fix Chinese/Japanese search: zh-CN/zh-TW use the mandarin tokenizer and ja
  the japanese tokenizer (@orama/tokenizers) on both the build-time index and
  the client query; the english whitespace tokenizer indexed CJK as one token.
- Add lib/locales.mjs as the single source for the locale list, default locale,
  per-locale search tokenizer, RTL set, labels, and the /docs basePath; consume
  it from i18n, the search index/dialog, next.config, and the postexport script
  (was duplicated and drift-prone).
- Drop dead gitConfig.branch; fix the stale README route table; document the
  English-nested-page limitation.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: 杨慎 <117187635+cosarah@users.noreply.github.com>
2026-05-31 00:11:17 +08:00

30 lines
810 B
TypeScript

'use client';
import { RootProvider } from 'fumadocs-ui/provider/next';
import { i18nProvider } from 'fumadocs-ui/i18n';
import type { ReactNode } from 'react';
import { translations } from '@/lib/i18n';
import StaticSearchDialog from '@/components/search-dialog';
// Client-side provider wrapper. The custom static SearchDialog must be wired in
// from a client component — a component function cannot be passed from a server
// component across the RootProvider client boundary.
export function DocsRootProvider({
lang,
dir,
children,
}: {
lang: string;
dir: 'ltr' | 'rtl';
children: ReactNode;
}) {
return (
<RootProvider
dir={dir}
i18n={i18nProvider(translations, lang)}
search={{ SearchDialog: StaticSearchDialog }}
>
{children}
</RootProvider>
);
}