عن المشروع

@egjs/flicking هي مكتبة مكوّنات كاروسيل (شريط تمرير) يديرها NAVER، وتُوزَّع كمستودع أحادي (monorepo) من حزم npm. يصفها ملف README بأنها موثوقة ومرنة وقابلة للتوسيع، ويبرز أنها تُستخدم على نطاق واسع. القدرات الأساسية المذكورة في README: - جاهزية SSR: تعمل مع Next.js وNuxt. - الوضع الدائري: حلقة لا نهائية سلسة. - التمرير الحر: تجربة تمرير أصلية قائمة على الزخم. - التمرير الافتراضي: يعرض فقط اللوحات المرئية لمجموعات البيانات الكبيرة. - الإضافات: AutoPlay وFade وParallax وArrow وPagination عبر @egjs/flicking-plugins. - TypeScript: واجهة برمجية مُنمَّطة بالكامل. الحزم في المستودع: - @egjs/flicking — مكتبة الكاروسيل الأساسية. - @egjs/flicking-plugins — تأثيرات جاهزة للكاروسيل. - @egjs/react-flicking — إصدار React. - @egjs/vue3-flicking — إصدار Vue 3. التثبيت متاح عبر npm (npm install --save @egjs/flicking) أو CDN (jsDelivr وunpkg وcdnjs). يوضح البدء السريع بنية HTML بسيطة بعنصر viewport يحتوي على عنصر camera وأبناء panel، ثم التهيئة عبر وحدات ES أو سكربت CDN مُحزَّم، مثل new Flicking("#my-flicking", { circular: true }). المتصفحات المدعومة المذكورة هي أحدث إصدارات Chrome وFirefox وSafari، بالإضافة إلى iOS 7+ وAndroid 4+. يشير README أيضًا إلى توجه "AI Native": توثيق يتمحور حول حالات الاستخدام، وأنواع TypeScript أقوى، ورسائل خطأ أوضح، وتفاصيل داخلية أكثر قابلية للتوقع، مع دليل llms.txt لتغذية التوثيق إلى LLMs ووكلاء الذكاء الاصطناعي. يتضمن التوثيق عروضًا توضيحية مع محرر أكواد مباشر مدمج، ودليل بدء سريع، ومرجعًا للواجهة البرمجية. المشروع مرخَّص بموجب MIT (حقوق النشر 2015 حتى الآن لشركة NAVER Corp.) ويقبل المساهمات عبر قضايا GitHub وCONTRIBUTING.md.