تخطَّ إلى المحتوى

الرئيسية / مفتوح المصدر / slotsmith

slotsmith

مكوّنات React تفكّكها كما تشاء.

مكتبة تفصل منطق المكوّن عن شكله: أي جزء فيها تستطيع استبداله، وما تتركه يُعرض HTML جاهزاً يراعي إمكانية الوصول. أطلق منتجك من اليوم الأول، ثم طوّعها لنظام تصميمك في اليوم الأربعين، دون أن تنسخ المكتبة وتعدّل فيها.

  • v1.10.0
  • ISC
  • React 18 · 19
  • 0 runtime deps
  • RTL built in
Pagination barYousefمنجز
Skeleton stateNoorمراجعة
Error stateYousefمنجز
Empty stateLinaمنجز
Sticky headerOmarمراجعة

هذا الجزء مبني بمكوّن DataTable من مكتبتي slotsmith

users-table.tsx
import { DataTable } from "slotsmith"

// It works, and it already looks finished.
<DataTable data={users} columns={columns} />

نوعان من الأجزاء

أجزاء عناصر

Root · Table · Row · Cell …

تستقبل خصائص DOM العادية، وتظهر حالتها في سمات data-*. ضع فيها عناصر shadcn أو MUI أو Chakra كما هي.

أجزاء تفاعلية

Checkbox · Pagination · Empty …

تستقبل خصائص واضحة المعنى مثل checked وpageIndex، فتربط بها مكوّناتك عبر محوّل من بضعة أسطر.

Data table

21 parts · TanStack v9

مبني على TanStack Table v9 ويتألف من ٢٤ جزءاً قابلاً للاستبدال. يمكنك سحب الصفوف لإعادة ترتيبها، عدة صفوف معاً، وبين مستويات الشجرة، ومن جدول إلى آخر، وتعديله كجدول بيانات، والاختيار بين ست سمات جاهزة.

  • ترتيب وتقسيم صفحات من المتصفح أو من الخادم
  • التحديد يبقى محفوظاً بين صفحات الخادم
  • وضع جدول البيانات: محررات للخلايا ونسخ ولصق وتعبئة وتراجع
  • صفوف شجرية وافتراضية مع رأس ثابت
  • حالات التحميل والخطأ والجدول الفارغ
جرّبه مباشرة

Autocomplete

17 parts

حقل بحث وقائمة اختيار في مكوّن واحد، من ٢٢ جزءاً قابلاً للاستبدال. يعرض القيم المتعددة كوسوم، ويجلب الخيارات من الخادم مع تأخير ذكي وإلغاء للطلبات وتقسيم للصفحات.

جرّبه مباشرة

File uploader

drop zone · tile · picker

منطقة إفلات، أو مربع صورة، أو زر اختيار فقط. رفع متتابع مع شريط تقدم وإعادة محاولة، وإلغاء فعلي، ومعاينة فورية، وإرسال مع النماذج العادية.

جرّبه مباشرة

Date picker

13 parts · single · multiple · range

تاريخ واحد أو عدة تواريخ أو فترة كاملة، من ١٥ جزءاً قابلاً للاستبدال. اكتب التاريخ أو اختره بتنقّل كامل بلوحة المفاتيح، مع حدود دنيا وعليا وأيام محظورة، واختصارات جاهزة، وقيم ISO بالصيغة والمنطقة الزمنية التي تختارها.

جرّبه مباشرة

ومساعدك الذكي يعرفها أيضاً

slotsmith-ai خادم MCP لمساعدي البرمجة مثل Claude Code وCursor وVS Code Copilot. يزوّدهم بالخصائص والأجزاء وشيفرة البدائل كما هي، وبوصفات ربط MUI وshadcn وChakra، مطابقةً لنسخة slotsmith المثبّتة عندك، وينبّهك إن اختلفت النسخ. فلا خصائص مخمّنة ولا أسماء أجزاء مختلقة.

دليل أدوات الذكاء الاصطناعي

Claude Code

claude mcp add slotsmith -- npx -y slotsmith-ai mcp

Cursor · VS Code · Claude Desktop

{"command":"npx","args":["-y","slotsmith-ai","mcp"]}

الأدوات التي يضيفها لمساعدك

  • list_components
  • get_component_api
  • list_slots
  • get_slot
  • get_adapter_example
  • get_setup
  • search_docs

ما يلتزم به كل مكوّن

  • شكل افتراضي جاهز للإطلاقإن لم يكن الشكل الافتراضي صالحاً للإنتاج فالمكوّن لم يكتمل بعد.
  • يعمل دون إعدادلا تحتاج إلى تمرير أي حالة ليظهر المكوّن ويعمل.
  • كل نص قابل للتغييرالترجمة واتجاه الكتابة مجرد خصائص، لا نسخة معدّلة من المكتبة. وتأتي معها ١٨ حزمة لغات جاهزة، منها العربية مع دعم كامل للكتابة من اليمين لليسار.
  • يراعي إمكانية الوصولالتنقل بلوحة المفاتيح وخصائص ARIA وإدارة التركيز مدمجة في كل بديل.
  • بلا اعتمادياتلا يحتاج إلا المكتبة التي بُني عليها المكوّن.

لماذا بنيتها؟

المكتبات الجاهزة تفرض عليك تصميم غيرك، والمكتبات المجرّدة تتركك أمام صفحة بيضاء وأسبوع كامل تعيد فيه بناء الأساسيات. وبعد أن بنيت الجداول وقوائم الاختيار نفسها مرة بعد مرة في مشاريع العملاء، أردت حلاً وسطاً: سلوكاً جاهزاً وأجزاء لها أسماء، ولكل جزء بديل يصلح للإطلاق كما هو.

هذه مجرد البداية

أربعة مكوّنات اليوم، والمزيد قادم: مكوّنات جديدة، وتحسينات على الموجودة، وأفكار تختصر عليك العمل اليومي. والقواعد واحدة للجميع: منطق مستقل عن الشكل، وأجزاء قابلة للاستبدال، وبدائل جاهزة للإطلاق.

ما القادم

  • مكوّنات جديدة بالأسلوب نفسه
  • صقل أعمق للمكوّنات الأربعة الحالية
  • أدوات وأفكار تختصر التكرار في البرمجة اليومية

تريد هذا القدر من العناية في منتجك؟

أرسل فكرة مشروعك
$ npm i slotsmith
Esc

↑↓ للتنقل · Enter للفتح · Esc للإغلاق