عن المشروع

Pts هي مكتبة TypeScript وJavaScript موجهة للتصور والبرمجة الإبداعية. توفر أساسيات للرسم والتحريك على القماش، وتُوزع كسكربت متصفح وكحزمة npm. خيارات الاستخدام - سكربت المتصفح: قم بتنزيل pts.js أو pts.min.js من دليل dist، أو قم بالتحميل من CDN مثل cdnjs أو jsDelivr أو unpkg. يكشف السكربت الكلاسيكي المكتبة كـ globalThis.Pts. - الحزمة: قم بالتثبيت باستخدام npm install pts. المكتبة موجهة لـ ESM أولاً وتوفر أيضًا إدخال توافق CommonJS، لذا يمكن استيرادها باستخدام import { CanvasSpace, Group, Line, Pt } from "pts" أو require("pts"). تتضمن مشاريع البدء والتكاملات المدرجة في README pts-starter-kit وpts-react-example وحزمة npm react-pts-canvas. الأدلة والعروض متاحة على موقع المشروع. التطوير بيئة البناء المُدارة هي Node 24.18 أو أحدث في خط Node 24، والمكتبة المنشورة تُختبر أيضًا على إصدارات Node 20 و22 الحالية. الإعداد يستخدم pnpm install --frozen-lockfile وpnpm exec playwright install chromium وpnpm check. الأوامر الفردية تشمل build وtypecheck وtest وtest:browser وtest:integrations وcheck:package وformat وformat:watch. أمر pnpm check يتحقق من التنسيق والفحص والأنواع واختبارات الوحدة والتوثيق الحتمي والسلوك في متصفح حقيقي والقطع الأثرية القابلة للتكرار والحزمة المضغوطة ودقة ESM وCommonJS والتصريحات وtree-shaking. مجموعة تكامل الحزمة المضغوطة تبني وتشغل أيضًا نماذج React وVue وskia-canvas وvanilla أحادية الملف المُدارة تحت test/integrations. Prettier يحدد قواعد تنسيق المستودع. تشغيل pnpm format مرة واحدة، أو إبقاء pnpm format:watch يعمل، يعيد تنسيق ملفات المصدر المُدارة عند تغييرها. امتداد VS Code الموصى به وإعدادات مساحة العمل تمكن Prettier عند الحفظ، بينما يرفض pnpm check التغييرات غير المنسقة في CI. توليد التوثيق مولد التوثيق يستخدم واجهة Node الخاصة بـ TypeDoc لإعادة بناء JSON التوثيق الثابت المخصص من نقاط دخول المصدر الصريحة. كما يولد docs.md وguide.md وllms.txt للوكلاء والعملاء الآخرين الذين لا يمكنهم التنقل في تطبيق التوثيق أحادي الصفحة. التوثيق المولد مُسجل في المستودع؛ pnpm check:docs يعيد توليده في الذاكرة، ويبلغ عن الملفات القديمة أو الإضافية، ويمارس التنقل والبحث والمراسي والتخطيطات المتجاوبة في Chromium. المساهمة والترخيص المشكلات وطلبات السحب الصغيرة مرحب بها؛ التغييرات الأكبر يجب أن تبدأ بمناقشة مع المشرف. المشروع مرخص بموجب Apache License 2.0، حقوق الطبع والنشر 2017-حتى الآن William Ngan والمساهمون.