'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)
الأنماط المركبة
القوالب الجاهزة
}>
مستودع GitHub
بدء التثبيت
{/* Main Documentation Shell: 3 Column Layout */}
{/* 1. Sticky Navigation Sidebar */}
{navigationSections.map((sec, sIdx) => (
{sec.title}
{sec.items.map((item) => {
const isActive = activeSection === item.id;
return (
setActiveSection(item.id)}
style={{
width: '100%',
textAlign: 'start',
padding: '6px 12px',
borderRadius: 'var(--qhr-radius-md, 6px)',
border: 'none',
background: isActive ? 'rgba(212, 175, 55, 0.12)' : 'transparent',
color: isActive ? 'var(--qhr-color-primary-400, #D4AF37)' : 'var(--qhr-text-secondary, #BDBDBD)',
fontSize: '0.875rem',
fontWeight: isActive ? 700 : 500,
cursor: 'pointer',
display: 'flex',
alignItems: 'center',
justifyContent: 'space-between',
transition: 'all 0.15s ease',
}}
>
{item.label}
{isActive && }
);
})}
))}
{/* 2. Main Center Content */}
{/* Breadcrumbs */}
التوثيق
/
الرموز التصميمية
/
المعمارية والهيكلة
معمارية الرموز التصميمية (Design Tokens Architecture)
تعد الرموز التصميمية (Tokens) في نظام قاهرة مصدر الحقيقة الأوحد لكافة المتغيرات البصرية.
تُصاغ الرموز بصيغة YAML وتُترجم تلقائياً إلى متغيرات CSS رسمية بالبادئة --qhr-* مع ضمان التوافق الكامل بين اليمين واليسار (RTL/LTR).
الرموز تسبق التنسيق: يُحظر نهائياً استخدام أكواد الألوان المباشرة (Hex) أو الأبعاد الصلبة بدون الرجوع إلى سجل متغيرات --qhr-*.
{/* Code Block Showcase */}
tokens/themes/luxury-gold.yaml
}
>
{copied ? 'تم النسخ' : 'نسخ'}
{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) */}
في هذه الصفحة
نظرة عامة
القاعدة المعمارية الثالثة
نموذج ملف YAML
جدول الرموز المعتمدة
التوافق مع بيئات التشغيل
);
}
export default DocumentationPage;