'use client'; import React, { useState } from 'react'; import { Navbar, NavbarBrand, NavbarLinks, NavbarLink, NavbarActions, } from '../../renderers/react/Navbar'; import { SearchToolbar } from '../../renderers/react/patterns/SearchToolbar'; import { Card } from '../../renderers/react/Card'; import { Badge } from '../../renderers/react/Badge'; import { Button } from '../../renderers/react/Button'; import { Alert } from '../../renderers/react/Alert'; import { BackToTop } from '../../renderers/react/BackToTop'; import { Icon } from '../../renderers/react/Icon'; export function DocumentationPage() { const [activeSection, setActiveSection] = useState('tokens-architecture'); const [copied, setCopied] = useState(false); const navigationSections = [ { title: 'البداية السريعة', items: [ { id: 'intro', label: 'مقدمة عن نظام قاهرة' }, { id: 'installation', label: 'التثبيت والإعداد' }, { id: 'cli', label: 'أداة سطر الأوامر CLI' }, ], }, { title: 'الرموز التصميمية (Tokens)', items: [ { id: 'tokens-architecture', label: 'المعمارية والهيكلة' }, { id: 'tokens-colors', label: 'لوحة الألوان والخامات' }, { id: 'tokens-typography', label: 'الخطوط والطباعة العربية' }, { id: 'tokens-motion', label: 'منحنيات الحركة الفيزيائية' }, ], }, { title: 'عقود المكونات (Contracts)', items: [ { id: 'contract-button', label: 'الزر (Button)' }, { id: 'contract-card', label: 'البطاقة (Card)' }, { id: 'contract-modal', label: 'النافذة المشروطة (Modal)' }, { id: 'contract-preloader', label: 'شاشة التحميل (Preloader)' }, ], }, { title: 'بيئات التشغيل (Renderers)', items: [ { id: 'renderer-react', label: 'React 19 / Next.js 16' }, { id: 'renderer-php', label: 'PHP 8 Plates' }, { id: 'renderer-htmx', label: 'HTMX Hypermedia' }, { id: 'renderer-html', label: 'HTML Native' }, ], }, ]; const handleCopy = () => { setCopied(true); setTimeout(() => setCopied(false), 2000); }; const sampleTokenCode = `// tokens/themes/luxury-gold.yaml theme: luxury-gold version: 1.0.0 tokens: color: obsidian: surface: "#0F0B09" card: "#17120F" gold: primary: "#D4AF37" accent: "#F2C94C" motion: luxury: "cubic-bezier(0.25, 0.8, 0.25, 1)"`; return (
{/* Top Header Navbar */}
توثيق قاهرة المعماري v1.0.0 · معتمد
المعايير والتوثيق الوصفات (Recipes) الأنماط المركبة القوالب الجاهزة
{/* Main Documentation Shell: 3 Column Layout */}
{/* 1. Sticky Navigation Sidebar */} {/* 2. Main Center Content */}
{/* Breadcrumbs */}
التوثيق / الرموز التصميمية / المعمارية والهيكلة

معمارية الرموز التصميمية (Design Tokens Architecture)

تعد الرموز التصميمية (Tokens) في نظام قاهرة مصدر الحقيقة الأوحد لكافة المتغيرات البصرية. تُصاغ الرموز بصيغة YAML وتُترجم تلقائياً إلى متغيرات CSS رسمية بالبادئة --qhr-* مع ضمان التوافق الكامل بين اليمين واليسار (RTL/LTR).

الرموز تسبق التنسيق: يُحظر نهائياً استخدام أكواد الألوان المباشرة (Hex) أو الأبعاد الصلبة بدون الرجوع إلى سجل متغيرات --qhr-*. {/* Code Block Showcase */}
tokens/themes/luxury-gold.yaml
              {sampleTokenCode}
            
{/* Tokens Specification Table */}

قائمة الرموز الأساسية المعتمدة

اسم المتغير (CSS Custom Property) القيمة المرجعية الوصف والاستخدام
--qhr-surface-page #0A0A0A الخلفية العميقة لصفحات النظام
--qhr-surface-card #141414 أسطح البطاقات والحاويات التفاعلية
--qhr-color-primary-500 #C7A35A لون الهوية الأساسي (الذهب الإمبراطوري)
--qhr-font-family-primary 'Cairo', sans-serif الخط العربي المعياري لواجهات النظام
{/* Bottom Navigation */}
الصفحة السابقة

أداة سطر الأوامر CLI

الصفحة التالية

لوحة الألوان والخامات

{/* 3. On-Page Table of Contents (TOC) */}
); } export default DocumentationPage;