عن المشروع

Semiotic هي مكتبة React لتصور البيانات مصممة للتطوير بمساعدة الذكاء الاصطناعي. تجمع بين تغطية واسعة للرسوم البيانية وأدوات الذكاء الاصطناعي، وتدعم الرسوم البيانية الشبكية والبيانات المتدفقة والعروض المنسقة. توفر المكتبة مخططات منظمة وأدوات تشخيص وأدلة عرض لمساعدة مساعدي البرمجة على تنفيذ وفحص وإصلاح كود الرسوم البيانية. تشمل الميزات الرئيسية: - **تصور الشبكات**: رسوم بيانية موجهة بالقوة، ومخططات Sankey، ومخططات الأوتار، وتخطيطات شجرية، وخرائط شجرية، وتعبئة دائرية، ومخططات مدارية كمكونات React مع واجهة برمجة تطبيقات موحدة للخصائص. - **البيانات المتدفقة**: رسوم بيانية فورية تُعرض على canvas بمعدل 60 إطارًا في الثانية مع واجهة برمجة تطبيقات دفع قائمة على المراجع، بما في ذلك ترميز الاضمحلال والنبض والتقادم للوحات مراقبة. - **تعليقات توضيحية من الدرجة الأولى**: كائنات تعليقات مرتبطة بالبيانات تتحرك مع الرسوم البيانية وتُعرض عبر المتصفح والعرض من جانب الخادم والتصدير. - **أدوات الذكاء الاصطناعي**: تشمل `semiotic/ai` لكتالوج قدرات الرسوم البيانية المدعوم بالمخططات، و`ai/schema.json` لمخططات الخصائص القابلة للقراءة آليًا، و`npx semiotic-mcp` لعرض الرسوم البيانية عبر خادم MCP، و`npx semiotic-ai --doctor` للتحقق عبر سطر الأوامر. - **التشخيص**: دوال `diagnoseConfig` و`auditData` لاكتشاف الأنماط المضادة وفحوصات رقمية مسبقة. - **إمكانية الوصول**: حدود أخطاء مدمجة، والتحقق في وضع التطوير، وتسميات ARIA، ومفاتيح أساطير قابلة للتنقل بلوحة المفاتيح، وجداول بيانات قابلة للوصول. - **استيراد معياري**: مسارات فرعية للعائلات مثل `semiotic/xy` و`semiotic/geo` و`semiotic/value` و`semiotic/realtime` لحزم أصغر، مع دعم إزالة الشيفرات غير المستخدمة. - **العرض من جانب الخادم**: `semiotic/server` لعرض الرسوم البيانية إلى SVG ثابت أو صور. - **أدوات البيانات**: `semiotic/data` للتجميع والتراكم والتجميع حسب المفتاح والتحويل المحوري والتحويل إلى Vega-Lite. - **التسلسل**: تُسلسل الرسوم البيانية من وإلى JSON عبر `toConfig` و`fromConfig` و`toURL`، مما يتيح التنقل ذهابًا وإيابًا من دفاتر الملاحظات والمواصفات المولدة بالذكاء الاصطناعي. تتضمن المكتبة جداول أحجام الحزم لمختلف الاستيرادات، بدءًا من الأدوات الصغيرة (0.2 كيلوبايت) إلى واجهات برمجة تطبيقات الرسوم البيانية الكاملة (374 كيلوبايت). كما توفر رسومًا بيانية قائمة على الفيزياء (GaltonBoardChart) مع محولات اختيارية لـ Matter.js وRapier.js. تُوضع Semiotic للمشاريع التي تحتاج إلى رسوم بيانية شبكية إلى جانب السلاسل الزمنية والبيانات المتدفقة والعروض المنسقة بما يتجاوز مكتبات الرسوم البيانية القياسية.