@ahmedrowaihi/8n 0.5.19 → 6.0.0

package/README.md

@@ -0,0 +1,14 @@
+# .
+
+This is a Next application generated with
+[Create Fumadocs](https://github.com/fuma-nama/fumadocs).
+
+Run development server:
+
+```bash
+npm run dev
+# or
+pnpm dev
+# or
+yarn dev
+```

package/app/[lang]/(docs)/[section]/[[...slug]]/page.jsx

@@ -0,0 +1 @@
+export{generateStaticParams,generateMetadata,default}from"@/features/docs/section-page";

package/app/[lang]/(docs)/error.jsx

@@ -0,0 +1,2 @@
+"use client";
+import{jsx as r}from"react/jsx-runtime";import{useEffect as e}from"react";import{ErrorState as o}from"@/components/error-state";export default function t({error:m,reset:n}){return e(()=>{console.error(m)},[m]),r(o,{error:m,reset:n,minHeight:"min-h-[60vh]"})}

package/app/[lang]/(docs)/layout.jsx

@@ -0,0 +1 @@
+import{createDocsLayout as o}from"@/lib/create-docs-layout";export default o();

package/app/[lang]/(docs)/loading.jsx

@@ -0,0 +1 @@
+import{jsx as e}from"react/jsx-runtime";import{LogoLoader as t}from"@/components/logo-loader";export default function r(){return e("div",{className:"fixed inset-0 z-50 flex items-center justify-center",children:e(t,{className:"size-14"})})}

package/app/[lang]/(marketing)/layout.jsx

@@ -0,0 +1,2 @@
+"use client";
+import{jsx as e,jsxs as a,Fragment as r}from"react/jsx-runtime";import t from"next/dynamic";import{AISearchTrigger as i}from"@/features/ai/chat";import{MessageCircleIcon as o}from"lucide-react";import{Transition as s}from"@/components/page-transition";let n=t(()=>import("@/features/ai/chat").then(e=>({default:e.AISearchPanel})),{ssr:!1});export default function l({children:t}){return a(r,{children:[e(n,{}),e(s,{className:"flex flex-col flex-1",children:t}),e(i,{position:"float","aria-label":"Ask AI",variant:"secondary",size:"icon",className:"rounded-full text-muted-foreground size-12",children:e(o,{className:"size-5"})})]})}

package/app/[lang]/(marketing)/page.jsx

@@ -0,0 +1 @@
+import{jsx as t}from"react/jsx-runtime";import{HomePage as r}from"@/features/marketing";export default async function a({params:e}){let{lang:n}=await e;return t(r,{lang:n})}

package/app/[lang]/changelog/[...slug]/layout.jsx

@@ -0,0 +1 @@
+import{createDocsLayout as o}from"@/lib/create-docs-layout";export default o();

package/app/[lang]/changelog/[...slug]/page.jsx

@@ -0,0 +1 @@
+import{jsx as e}from"react/jsx-runtime";import{createDocsPage as a}from"@/lib/create-docs-page";import{ChangelogEntryContent as t}from"@/features/changelog";import{getMDXComponents as o}from"@/components/fumadocs/mdx";export const{generateStaticParams,generateMetadata,default:Page}=a("changelog",{render:({page:a,toc:r,lang:d,MDX:n})=>e(t,{toc:r,lang:d,lastModified:a.data.lastModified??null,version:a.data.version,date:a.data.date,children:e(n,{components:o()})})});export default Page;

package/app/[lang]/changelog/layout.jsx

@@ -0,0 +1 @@
+import{jsx as e}from"react/jsx-runtime";import{Transition as r}from"@/components/page-transition";export default function t({children:o}){return e(r,{className:"flex flex-col flex-1",children:o})}

package/app/[lang]/changelog/page.jsx

@@ -0,0 +1 @@
+import{jsx as t}from"react/jsx-runtime";import{getSources as e}from"@/lib/source";import{localeConfig as a}from"@/locale.config";import{ChangelogList as r}from"@/features/changelog";export async function generateMetadata({params:t}){let{lang:e}=await t,r=a[e]?.translations??a.en.translations,n=a[e]?.siteName??a.en.siteName;return{title:`${r.changelog} — ${n}`}}export default async function n({params:a}){let{lang:i}=await a,{changelogSource:o}=await e();return t(r,{entries:o.getPages(i).map(t=>({url:t.url,title:t.data.title,summary:t.data.summary??null,version:t.data.version,date:t.data.date})).sort((t,e)=>new Date(e.date).getTime()-new Date(t.date).getTime()),lang:i})}

package/app/[lang]/error.jsx

@@ -0,0 +1,2 @@
+"use client";
+import{jsx as r}from"react/jsx-runtime";import{useEffect as o}from"react";import{ErrorState as e}from"@/components/error-state";export default function t({error:m,reset:n}){return o(()=>{console.error(m)},[m]),r(e,{error:m,reset:n})}

package/app/[lang]/lang-setup.jsx

@@ -0,0 +1,2 @@
+"use client";
+import{useEffect as e}from"react";export default function t({lang:n,dir:m}){return e(()=>{document.documentElement.lang=n,document.documentElement.dir=m},[n,m]),null}

package/app/[lang]/layout.jsx

@@ -0,0 +1 @@
+import{jsx as r,jsxs as e}from"react/jsx-runtime";import{DevRefresh as t}from"@/components/dev-refresh";import a from"@/components/fumadocs/search";import{getLocaleDir as o,i18n as n}from"@/lib/i18n";import{localeConfig as i,locales as m}from"@/locale.config";import{defineI18nUI as s}from"@fumadocs/base-ui/i18n";import{RootProvider as p}from"@fumadocs/base-ui/provider/next";import{redirect as f}from"next/navigation";import l from"./lang-setup";let{provider:c}=s(n,{translations:Object.fromEntries(m.map(r=>[r,{displayName:i[r].displayName,...i[r].translations}]))});export function generateStaticParams(){return m.map(r=>({lang:r}))}export default async function u({children:i,params:m}){let{lang:s}=await m;n.languages.includes(s)||f(`/${n.defaultLanguage}`);let d=o(s),g="auto"===d?"ltr":d;return e(p,{i18n:c(s),dir:g,search:{SearchDialog:a},children:[r(l,{lang:s,dir:d}),i,"development"===process.env.NODE_ENV&&r(t,{})]})}

package/app/[lang]/loading.jsx

@@ -0,0 +1 @@
+import{jsx as e}from"react/jsx-runtime";import{LogoLoader as t}from"@/components/logo-loader";export default function r(){return e("div",{className:"fixed inset-0 z-50 flex items-center justify-center",children:e(t,{className:"size-14"})})}

package/app/[lang]/playground/page.jsx

@@ -0,0 +1,2 @@
+"use client";
+import{jsx as r}from"react/jsx-runtime";import{MDXPlayground as o}from"@/features/mdx-playground/components/playground";export default function t(){return r(o,{})}

package/app/[lang]/rss.xml/route.js

@@ -0,0 +1 @@
+import{getRSS as t}from"@/lib/rss";import{locales as e}from"@/locale.config";export const dynamic="force-static";export function generateStaticParams(){return e.map(t=>({lang:t}))}export async function GET(e,{params:r}){let{lang:a}=await r;return new Response(await t(a),{headers:{"Content-Type":"application/rss+xml; charset=utf-8"}})}

package/app/api/chat/route.js

@@ -0,0 +1 @@
+import{handleChat as r}from"@/features/ai/chat/handler";export async function POST(t){return r(t)}

package/app/api/dev/watch/route.js

@@ -0,0 +1 @@
+import{watch as e,existsSync as n}from"node:fs";import{env as t}from"@/config";export const dynamic="force-static";export function GET(){let o;if("development"!==process.env.NODE_ENV)return new Response("Not found",{status:404});let c=new TextEncoder;return new Response(new ReadableStream({start(r){r.enqueue(c.encode("data: connected\n\n")),n(t.CONTENT_DIR)&&(o=e(t.CONTENT_DIR,{recursive:!0},()=>{try{r.enqueue(c.encode("data: change\n\n"))}catch{o?.close()}}))},cancel(){o?.close()}}),{headers:{"Content-Type":"text/event-stream","Cache-Control":"no-cache",Connection:"keep-alive"}})}

package/app/api/pages/route.js

@@ -0,0 +1 @@
+import{getPageEntries as o}from"@/lib/pages-api";export const dynamic="force-static";export async function GET(){return Response.json(await o())}

package/app/api/search/route.js

@@ -0,0 +1 @@
+import{getSources as t}from"@/lib/source";export const dynamic="force-static";export async function GET(){let{searchServer:c}=await t();return c.staticGET()}

package/app/excalidraw/layout.jsx

@@ -0,0 +1 @@
+export const metadata={robots:{index:!1,follow:!1}};export default function t({children:o}){return o}

package/app/excalidraw/page.jsx

@@ -0,0 +1,13 @@
+"use client";
+import{jsx as e,jsxs as i,Fragment as o}from"react/jsx-runtime";import"@excalidraw/excalidraw/index.css";import{lazy as r,Suspense as d,useState as a}from"react";import{useSearchParams as t}from"next/navigation";let n=r(async()=>{if("u"<typeof window)return{default:()=>null};let{Excalidraw:i}=await import("@excalidraw/excalidraw");return{default:({initialData:o,viewMode:r})=>e(i,{initialData:o,viewModeEnabled:r})}});function l(){let o=t().get("data"),r=o?JSON.parse(decodeURIComponent(o)):void 0,[l,c]=a(!0);return i("div",{id:"excalidraw-root",children:[e("button",{id:"mode-toggle",className:l?"":"edit",onClick:()=>c(e=>!e),children:l?"✏️":"👁️"}),e(d,{fallback:null,children:e(n,{initialData:r,viewMode:l})})]})}export default function c(){return i(o,{children:[e("style",{href:"excalidraw-page",precedence:"default",children:`
+        body { overflow: hidden; }
+        #excalidraw-root { position: fixed; inset: 0; }
+        #mode-toggle {
+          position: absolute; top: 10px; inset-inline-end: 10px; z-index: 10;
+          padding: 6px 12px; border-radius: 6px; border: 1px solid #ced4da;
+          background: #fff; cursor: pointer; font-size: 13px; font-weight: 500;
+          box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+        }
+        #mode-toggle:hover { background: #f1f3f5; }
+        #mode-toggle.edit { background: #e7f5ff; border-color: #74c0fc; color: #1971c2; }
+      `}),e("div",{id:"excalidraw-root",children:e(d,{fallback:null,children:e(l,{})})})]})}

package/app/layout.jsx

@@ -0,0 +1 @@
+import{jsx as r}from"react/jsx-runtime";import"@/styles/app.css";import{defaultLocale as e}from"@/locale.config";import{AIProvider as t}from"@/features/ai/chat";export default function i({children:n}){return r("html",{lang:e,suppressHydrationWarning:!0,children:r("body",{className:"flex flex-col min-h-screen",children:r(t,{children:n})})})}

package/app/llms-full.txt/route.js

@@ -0,0 +1 @@
+import{getLlmsFullText as t}from"@/lib/llms";export const dynamic="force-static";export async function GET(){return new Response(await t())}

package/app/llms.mdx/[section]/[...slug]/route.js

@@ -0,0 +1 @@
+import{getLlmsMdxStaticParams as t,getLlmsMdxPage as a}from"@/lib/llms";import{notFound as e}from"next/navigation";export const dynamic="force-static";export async function GET(t,{params:n}){let{section:r,slug:o}=await n,i=await a(r,o);return i||e(),new Response(i,{headers:{"Content-Type":"text/markdown"}})}export{t as generateStaticParams};

package/app/llms.txt/route.js

@@ -0,0 +1 @@
+import{getLlmsIndex as t}from"@/lib/llms";export const dynamic="force-static";export async function GET(){return new Response(await t())}

package/app/not-found.jsx

@@ -0,0 +1 @@
+import{jsx as e,jsxs as t}from"react/jsx-runtime";import n from"next/link";import{i18n as r}from"@/lib/i18n";import{localeConfig as o}from"@/locale.config";export default function a(){let a=o[r.defaultLanguage]?.translations??o.en.translations;return t("div",{className:"flex flex-col items-center justify-center min-h-screen gap-4 text-center px-4",children:[e("h1",{className:"text-4xl font-bold",children:a.notFoundTitle}),e("p",{className:"text-muted-foreground",children:a.notFoundDescription}),e(n,{href:`/${r.defaultLanguage}`,className:"underline text-sm text-muted-foreground hover:text-foreground",children:a.notFoundBack})]})}

package/app/page.jsx

@@ -0,0 +1 @@
+import{redirect as t}from"next/navigation";import{i18n as i}from"@/lib/i18n";export default function n(){t(`/${i.defaultLanguage}`)}

package/app/robots.js

@@ -0,0 +1 @@
+import{env as t}from"@/config";export const dynamic="force-static";export default function e(){return{rules:{userAgent:"*",allow:"/"},sitemap:`${t.SITE_URL}/sitemap.xml`}}

package/app/sitemap.js

@@ -0,0 +1 @@
+export const dynamic="force-static";export{buildSitemap as default}from"@/lib/sitemap";

package/content/api/ar/meta.json

@@ -0,0 +1 @@
+{ "title": "مرجع API", "icon": "PlugZap" }

package/content/api/en/createPet.mdx

@@ -0,0 +1,14 @@
+---
+title: Create a pet
+full: true
+_openapi:
+  method: POST
+  toc: []
+  structuredData:
+    headings: []
+    contents: []
+---
+
+{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}
+
+<APIPage document={"./openapi/petstore.json"} operations={[{"path":"/pets","method":"post"}]} />

package/content/api/en/deletePet.mdx

@@ -0,0 +1,14 @@
+---
+title: Delete a pet
+full: true
+_openapi:
+  method: DELETE
+  toc: []
+  structuredData:
+    headings: []
+    contents: []
+---
+
+{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}
+
+<APIPage document={"./openapi/petstore.json"} operations={[{"path":"/pets/{petId}","method":"delete"}]} />

package/content/api/en/index.mdx

@@ -0,0 +1,14 @@
+---
+title: API Reference
+description: Interactive REST API reference for the Petstore sample API.
+icon: PlugZap
+---
+
+This section documents the Petstore sample API. Replace the OpenAPI spec at `openapi/petstore.json` with your own schema and run `pnpm generate:api` to regenerate.
+
+<Cards>
+  <Card title="List all pets" href="/en/api/listPets" />
+  <Card title="Get a pet" href="/en/api/showPetById" />
+  <Card title="Create a pet" href="/en/api/createPet" />
+  <Card title="Delete a pet" href="/en/api/deletePet" />
+</Cards>

package/content/api/en/listPets.mdx

@@ -0,0 +1,14 @@
+---
+title: List all pets
+full: true
+_openapi:
+  method: GET
+  toc: []
+  structuredData:
+    headings: []
+    contents: []
+---
+
+{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}
+
+<APIPage document={"./openapi/petstore.json"} operations={[{"path":"/pets","method":"get"}]} />

package/content/api/en/meta.json

@@ -0,0 +1,5 @@
+{
+  "title": "API Reference",
+  "icon": "PlugZap",
+  "pages": ["index", "listPets", "showPetById", "createPet", "deletePet"]
+}

package/content/api/en/showPetById.mdx

@@ -0,0 +1,14 @@
+---
+title: Get a pet
+full: true
+_openapi:
+  method: GET
+  toc: []
+  structuredData:
+    headings: []
+    contents: []
+---
+
+{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}
+
+<APIPage document={"./openapi/petstore.json"} operations={[{"path":"/pets/{petId}","method":"get"}]} />

package/content/changelog/ar/meta.json

@@ -0,0 +1,3 @@
+{
+  "title": "سجل التغييرات"
+}

package/content/changelog/ar/v1.0.0.mdx

@@ -0,0 +1,53 @@
+---
+title: الإصدار 1.0.0
+version: 1.0.0
+date: "2026-03-14"
+summary: الإصدار الأول — توثيق ثنائي اللغة بدعم RTL كامل، بحث محلي، خطوط ثمانية، مكوّنات MDX غنية، Excalidraw، تضمين التغريدات، رياضيات، TwoSlash، تغذيات RSS، وملف LLMs.txt.
+---
+
+## الإصدار الأول
+
+### توثيق ثنائي اللغة (العربية + الإنجليزية)
+
+دعم كامل للكتابة من اليمين إلى اليسار بالعربية مع تبديل تلقائي لاتجاه `dir` حسب اللغة. جميع مكوّنات الواجهة تستخدم خصائص CSS المنطقية (`start`/`end`، `inset-s-*`/`inset-e-*`) في كل مكان — لا استخدام لـ `left`/`right` نهائيًا — مما يضمن تخطيطًا صحيحًا لكلا اتجاهَي الكتابة.
+
+### توليد ثابت مع Next.js
+
+مبني على Next.js 16 مع توليد ثابت كامل. جميع الصفحات تُصيَّر مسبقًا عند البناء — تحميل سريع دون الحاجة لخادم في وقت التشغيل.
+
+### بحث محلي بدون اتصال
+
+بحث نصي كامل مدعوم بـ [Orama](https://orama.com) يعمل كليًا في المتصفح — لا طلبات خارجية، لا اعتماد على الشبكة. يعمل بدون اتصال بعد أول تحميل.
+
+### مكوّنات MDX
+
+| المكوّن | الوصف |
+|---------|-------|
+| `Callout` | كتل تنبيه: معلومة، تحذير، خطأ، تلميح |
+| `Steps` | تسلسلات خطوات مرقّمة |
+| `Tabs` | لوحات محتوى بتبويبات |
+| `Accordion` | أقسام قابلة للطي |
+| `Cards` | شبكات بطاقات روابط |
+| `TypeTable` | جداول مرجعية لأنواع API |
+| `CodeBlock` | كود بتمييز صياغي وزر نسخ |
+| `Mermaid` | مخططات Mermaid مُصيَّرة مع توسيع بالشاشة الكاملة |
+| `Video` | تضمين فيديو متجاوب |
+| `Audio` | مشغّل صوت مضمّن |
+| `Files` | عرض شجرة نظام الملفات |
+| `ExcalidrawBlock` | رسوم Excalidraw تفاعلية (معزولة بـ iframe، مع تبديل العرض/التحرير) |
+| `Tweet` | تغريدات مُضمَّنة مُصيَّرة من الخادم عبر react-tweet |
+
+### مميزات أخرى
+
+| الميزة | التفاصيل |
+|--------|----------|
+| توسيع بالشاشة الكاملة | مخططات Mermaid و Excalidraw تدعم زر توسيع بالشاشة الكاملة |
+| TwoSlash | أنواع TypeScript والأخطاء والإكمال التلقائي مُصيَّرة مضمّنة؛ النتائج مُخزَّنة مؤقتًا |
+| الرياضيات | تصيير KaTeX عبر `remark-math` + `rehype-katex` |
+| تمييز الصياغة | [Shiki](https://shiki.style) مع ثيمَي `catppuccin-latte` / `vesper` |
+| تعليقات كود RTL | التعليقات العربية في كتل الكود تُحاذى تلقائيًا عبر محوّل `rtl-spans` |
+| خطوط ثمانية | خطوط العربية واللاتينية من نظام التصميم لثمانية مطبّقة بشكل عام |
+| تغذيات RSS | تُولَّد تلقائيًا على `/{lang}/rss.xml` للغتين |
+| ملف LLMs.txt | `/llms.txt` و`/llms-full.txt` وفق اتفاقية [llms.txt](https://llmstxt.org) |
+| تواريخ آخر تعديل | تاريخ آخر تعديل git لكل صفحة عبر `fumadocs-mdx/plugins/last-modified` |
+| سجل التغييرات | مصدر `content/changelog/` ثنائي اللغة بحقول `version` و`date` و`summary` |

package/content/changelog/en/meta.json

@@ -0,0 +1,3 @@
+{
+  "title": "Changelog"
+}

package/content/changelog/en/v1.0.0.mdx

@@ -0,0 +1,53 @@
+---
+title: Version 1.0.0
+version: 1.0.0
+date: "2026-03-14"
+summary: Initial release — bilingual docs with full RTL support, offline search, Thmanyah fonts, rich MDX components, Excalidraw, Tweet embeds, math, TwoSlash, RSS feeds, and LLMs.txt.
+---
+
+## Initial Release
+
+### Bilingual Docs (Arabic + English)
+
+Full right-to-left support for Arabic with automatic `dir` switching per locale. All UI components use logical CSS properties (`start`/`end`, `inset-s-*`/`inset-e-*`) throughout — no `left`/`right` anywhere — ensuring correct bidirectional layout for both LTR and RTL languages.
+
+### Next.js Static Export
+
+Built on Next.js 16 with full static generation. All pages are prerendered at build time — fast cold loads with no server dependency at runtime.
+
+### Offline-Capable Search
+
+Full-text search powered by [Orama](https://orama.com) runs entirely in the browser — no external API calls, no network dependency. Works offline after first load.
+
+### MDX Components
+
+| Component | Description |
+|-----------|-------------|
+| `Callout` | Info, warning, error, and tip callout blocks |
+| `Steps` | Numbered step sequences |
+| `Tabs` | Tabbed content panels |
+| `Accordion` | Collapsible sections |
+| `Cards` | Link card grids |
+| `TypeTable` | API type reference tables |
+| `CodeBlock` | Syntax-highlighted code with copy button |
+| `Mermaid` | Rendered Mermaid diagrams with fullscreen expand |
+| `Video` | Responsive video embeds |
+| `Audio` | Audio player embeds |
+| `Files` | Filesystem tree display |
+| `ExcalidrawBlock` | Interactive Excalidraw diagrams (iframe-isolated, view/edit toggle) |
+| `Tweet` | Server-rendered tweet embeds via react-tweet |
+
+### Also Included
+
+| Feature | Details |
+|---------|---------|
+| Fullscreen expand | Mermaid and Excalidraw diagrams both have a fullscreen overlay button |
+| TwoSlash | TypeScript hover types, errors, and completions rendered inline; results cached to filesystem |
+| Math | KaTeX rendering via `remark-math` + `rehype-katex` |
+| Syntax highlighting | [Shiki](https://shiki.style) with `catppuccin-latte` / `vesper` themes |
+| RTL code comments | Arabic comments in code blocks auto-aligned right via `rtl-spans` transformer |
+| Thmanyah fonts | Arabic and Latin typefaces from Thmanyah's design system applied globally |
+| RSS feeds | Auto-generated at `/{lang}/rss.xml` for both locales |
+| LLMs.txt | `/llms.txt` and `/llms-full.txt` following the [llms.txt](https://llmstxt.org) convention |
+| Last modified dates | Per-page git last-modified date via `fumadocs-mdx/plugins/last-modified` |
+| Changelog | Bilingual `content/changelog/` source with `version`, `date`, and `summary` fields |

package/content/docs/ar/components/accordion.mdx

@@ -0,0 +1,17 @@
+---
+title: الأكورديون
+description: أقسام قابلة للطي والفتح.
+icon: ChevronDown
+---
+
+<Accordions type="single">
+  <Accordion title="ما هذا القالب؟">
+    موقع توثيق مبني بـ Fumadocs يعمل على Next.js، مع دعم i18n وخطوط ثمانية والبحث المحلي.
+  </Accordion>
+  <Accordion title="هل يمكنني إضافة لغات أخرى؟">
+    نعم — أضف اللغة إلى `src/config.ts` وأنشئ مجلد <code>{'content/docs/<locale>/'}</code> المقابل.
+  </Accordion>
+  <Accordion title="هل يعمل بدون إنترنت؟">
+    يستخدم البحث Orama محلياً — بدون طلبات API خارجية. يحتاج الموقع فقط إلى خادم ملفات ثابتة.
+  </Accordion>
+</Accordions>

package/content/docs/ar/components/audio.mdx

@@ -0,0 +1,9 @@
+---
+title: الصوت
+description: مشغّل صوت مدمج لأي تيار أو ملف.
+icon: Music
+---
+
+`Audio` يعرض مشغّل صوت مدمج. المصادر المدعومة: MP3 وAAC وOGG وبث HLS وروابط ملفات الصوت المباشرة.
+
+<Audio src="https://www.youtube.com/watch?v=pO5dgZrM9Mk" title="سورة الفاتحة — الشيخ محمود خليل الحصري" />

package/content/docs/ar/components/callout.mdx

@@ -0,0 +1,10 @@
+---
+title: التنبيهات
+description: إبراز الملاحظات والتحذيرات والأخطاء.
+icon: CircleAlert
+---
+
+<Callout>تنبيه افتراضي — معلومات عامة.</Callout>
+<Callout type="info">تنبيه معلوماتي.</Callout>
+<Callout type="warn">تنبيه تحذيري.</Callout>
+<Callout type="error">تنبيه خطأ — حدث خطأ ما.</Callout>

package/content/docs/ar/components/cards.mdx

@@ -0,0 +1,10 @@
+---
+title: البطاقات
+description: شبكة بطاقات التنقل.
+icon: LayoutGrid
+---
+
+<Cards>
+  <Card title="بطاقة أولى" description="وصف قصير يظهر هنا." href="#" />
+  <Card title="بطاقة ثانية" description="بطاقة أخرى مع رابط." href="#" icon="Star" />
+</Cards>

package/content/docs/ar/components/circuit-board.mdx

@@ -0,0 +1,20 @@
+---
+title: CircuitBoardBlock
+description: مخطط عقد متحرك مع نبضات كهربائية على المسارات.
+icon: CircuitBoard
+---
+
+`CircuitBoardBlock` يرسم مخطط عقد متحرك مع نبضات كهربائية على المسارات. مناسب لتوضيح بنية الأنظمة والخدمات المصغّرة والتواصل بين المكونات.
+
+<CircuitBoardBlock
+  width={580} height={240}
+  nodes={[
+    { id: "client", x: 80,  y: 120, label: "العميل",        status: "active",     icon: "Monitor" },
+    { id: "api",    x: 290, y: 120, label: "API",            status: "processing", icon: "Server" },
+    { id: "db",     x: 500, y: 120, label: "قاعدة البيانات", status: "active",     icon: "Database" },
+  ]}
+  connections={[
+    { from: "client", to: "api", animated: true },
+    { from: "api",    to: "db",  bidirectional: true },
+  ]}
+/>

package/content/docs/ar/components/code-blocks.mdx

@@ -0,0 +1,56 @@
+---
+title: كتل الكود
+description: تمييز بالألوان وفروق وأرقام أسطر.
+icon: Code
+---
+
+كتلة كود عادية مع عنوان وتمييز بالألوان:
+
+```ts title="src/lib/source.ts"
+import { loader } from 'fumadocs-core/source';
+import { createMDXSource } from 'fumadocs-mdx';
+import { docs } from '@/.source';
+
+// بناء مصدر التوثيق من مجموعة MDX المولّدة
+export const source = loader({
+  baseUrl: '/docs',
+  source: createMDXSource(docs),
+});
+```
+
+تمييز أسطر محددة باستخدام `// [!code highlight]`:
+
+```tsx title="src/routes/$lang/docs/$.tsx"
+export const Route = createFileRoute('/$lang/docs/$')({
+  component: Page, // [!code highlight]
+  loader: async ({ params }) => {
+    const slugs = params._splat?.split('/') ?? [];
+    return loader({ data: { slugs, lang: params.lang } }); // [!code highlight]
+  },
+});
+```
+
+أرقام الأسطر باستخدام `lineNumbers`:
+
+```ts lineNumbers title="src/lib/source.ts"
+import { loader } from 'fumadocs-core/source';
+import { createMDXSource } from 'fumadocs-mdx';
+import { docs } from '@/.source';
+
+// بناء مصدر التوثيق من مجموعة MDX المولّدة
+export const source = loader({
+  baseUrl: '/docs',
+  source: createMDXSource(docs),
+});
+```
+
+إضافات وحذف مع `// [!code ++]` و `// [!code --]`:
+
+```ts
+themes: {
+  light: 'github-light', // [!code --]
+  dark: 'github-dark',   // [!code --]
+  light: 'catppuccin-latte', // [!code ++]
+  dark: 'vesper',            // [!code ++]
+},
+```

package/content/docs/ar/components/drawio.mdx

@@ -0,0 +1,19 @@
+---
+title: DrawioBlock
+description: تضمين مخططات draw.io التفاعلية.
+icon: Share2
+---
+
+`DrawioBlock` يُضمِّن مخطط draw.io تفاعلي كامل. مرِّر عناصر `mxCell` كـ XML خام — المكوّن يُغلّفها تلقائياً.
+
+<DrawioBlock height={300} xml={`
+  <mxCell id="2" value="العميل" style="rounded=1;whiteSpace=wrap;html=1;" vertex="1" parent="1">
+    <mxGeometry x="80" y="120" width="120" height="60" as="geometry"/>
+  </mxCell>
+  <mxCell id="3" value="الخادم" style="rounded=1;whiteSpace=wrap;html=1;" vertex="1" parent="1">
+    <mxGeometry x="360" y="120" width="120" height="60" as="geometry"/>
+  </mxCell>
+  <mxCell id="4" style="endArrow=classic;html=1;flowAnimation=1;" edge="1" source="2" target="3" parent="1">
+    <mxGeometry relative="1" as="geometry"/>
+  </mxCell>
+`} />

package/content/docs/ar/components/dynamic-code-block.mdx

@@ -0,0 +1,12 @@
+---
+title: كتلة كود ديناميكية
+description: كتلة كود يمكن تغيير لغتها في وقت التشغيل.
+icon: Braces
+---
+
+`DynamicCodeBlock` يعرض كتلة كود مع لغة يمكن تغييرها في وقت التشغيل:
+
+<DynamicCodeBlock lang="ts" code={`export async function greet() {
+  'use server';
+  return { message: 'مرحباً من الخادم!' };
+}`} />

package/content/docs/ar/components/excalidraw.mdx

@@ -0,0 +1,18 @@
+---
+title: Excalidraw
+description: تضمين مخططات Excalidraw بوضع القراءة فقط.
+icon: PenLine
+---
+
+`ExcalidrawBlock` يُضمِّن مخطط Excalidraw تفاعلي بوضع القراءة فقط. مرِّر `initialData` مع عناصر المخطط.
+
+<ExcalidrawBlock height={350} initialData={{
+  elements: [
+    { id: "1", type: "rectangle", x: 100, y: 60, width: 160, height: 60, roundness: { type: 3 }, strokeColor: "#1971c2", backgroundColor: "#d0ebff", fillStyle: "solid", strokeWidth: 2, roughness: 1, opacity: 100, groupIds: [], frameId: null, isDeleted: false, boundElements: [{ type: "text", id: "1t" }], updated: 1, version: 1, versionNonce: 1 },
+    { id: "1t", type: "text", x: 130, y: 78, width: 100, height: 25, text: "محتوى", fontSize: 16, fontFamily: 1, textAlign: "center", verticalAlign: "middle", containerId: "1", strokeColor: "#1971c2", backgroundColor: "transparent", fillStyle: "solid", strokeWidth: 1, roughness: 1, opacity: 100, groupIds: [], frameId: null, isDeleted: false, boundElements: null, updated: 1, version: 1, versionNonce: 2 },
+    { id: "2", type: "rectangle", x: 380, y: 60, width: 160, height: 60, roundness: { type: 3 }, strokeColor: "#2f9e44", backgroundColor: "#d3f9d8", fillStyle: "solid", strokeWidth: 2, roughness: 1, opacity: 100, groupIds: [], frameId: null, isDeleted: false, boundElements: [{ type: "text", id: "2t" }], updated: 1, version: 1, versionNonce: 3 },
+    { id: "2t", type: "text", x: 410, y: 78, width: 100, height: 25, text: "نشر", fontSize: 16, fontFamily: 1, textAlign: "center", verticalAlign: "middle", containerId: "2", strokeColor: "#2f9e44", backgroundColor: "transparent", fillStyle: "solid", strokeWidth: 1, roughness: 1, opacity: 100, groupIds: [], frameId: null, isDeleted: false, boundElements: null, updated: 1, version: 1, versionNonce: 4 },
+    { id: "3", type: "arrow", x: 260, y: 90, width: 120, height: 0, strokeColor: "#495057", backgroundColor: "transparent", fillStyle: "solid", strokeWidth: 2, roughness: 1, opacity: 100, groupIds: [], frameId: null, isDeleted: false, boundElements: null, updated: 1, version: 1, versionNonce: 5, startBinding: { elementId: "1", focus: 0, gap: 1 }, endBinding: { elementId: "2", focus: 0, gap: 1 }, points: [[0,0],[120,0]], lastCommittedPoint: null, startArrowhead: null, endArrowhead: "arrow" }
+  ],
+  appState: { viewBackgroundColor: "transparent" }
+}} />

package/content/docs/ar/components/figma.mdx

@@ -0,0 +1,16 @@
+---
+title: FigmaBlock
+description: تضمين ملفات Figma والنماذج التفاعلية.
+icon: Figma
+---
+
+`FigmaBlock` يُضمِّن ملف Figma أو نموذجاً تفاعلياً أو لوحة FigJam. مرِّر رابط المشاركة من Figma مباشرةً — يُحوَّل تلقائياً إلى رابط التضمين.
+
+<Callout type="info">
+  يجب أن يكون الملف عاماً أو مفعّلاً بخيار "يمكن لأي شخص لديه الرابط المشاهدة" حتى يظهر التضمين.
+</Callout>
+
+````mdx
+<FigmaBlock url="https://www.figma.com/design/abc123/My-File" />
+<FigmaBlock url="https://www.figma.com/proto/abc123/My-Prototype" height={600} />
+````

package/content/docs/ar/components/files.mdx

@@ -0,0 +1,25 @@
+---
+title: هيكل الملفات
+description: مخططات شجرة الملفات.
+icon: FolderTree
+---
+
+<Files>
+  <Folder name="src" defaultOpen>
+    <Folder name="routes" defaultOpen>
+      <File name="__root.tsx" />
+      <File name="$lang.tsx" />
+      <Folder name="$lang">
+        <File name="index.tsx" />
+        <Folder name="docs">
+          <File name="$.tsx" />
+        </Folder>
+      </Folder>
+    </Folder>
+    <Folder name="lib">
+      <File name="i18n.ts" />
+      <File name="source.ts" />
+      <File name="layout.shared.tsx" />
+    </Folder>
+  </Folder>
+</Files>