منصوبے کے بارے میں

Pts ایک TypeScript اور JavaScript لائبریری ہے جو ویژولائزیشن اور تخلیقی کوڈنگ کے لیے بنائی گئی ہے۔ یہ canvas پر ڈرائنگ اور اینیمیشن کے لیے primitives فراہم کرتی ہے، اور اسے براؤزر اسکرپٹ اور npm پیکج دونوں کی صورت میں تقسیم کیا جاتا ہے۔ استعمال کے اختیارات - براؤزر اسکرپٹ: dist ڈائریکٹری سے pts.js یا pts.min.js ڈاؤن لوڈ کریں، یا cdnjs، jsDelivr یا unpkg جیسے CDN سے لوڈ کریں۔ کلاسک اسکرپٹ لائبریری کو globalThis.Pts کے طور پر ظاہر کرتا ہے۔ - پیکج: npm install pts کے ذریعے انسٹال کریں۔ لائبریری ESM-first ہے اور CommonJS مطابقت کا entry بھی فراہم کرتی ہے، لہٰذا اسے import { CanvasSpace, Group, Line, Pt } from "pts" کے ساتھ import کیا جا سکتا ہے یا require("pts") کے ساتھ require کیا جا سکتا ہے۔ README میں درج اسٹارٹر پروجیکٹس اور انٹیگریشنز میں pts-starter-kit، pts-react-example، اور react-pts-canvas npm پیکج شامل ہیں۔ گائیڈز اور ڈیموز پروجیکٹ سائٹ پر دستیاب ہیں۔ ڈیولپمنٹ برقرار رکھا جانے والا بلڈ ماحول Node 24 لائن میں Node 24.18 یا اس سے نیا ہے، اور شائع شدہ لائبریری موجودہ 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 کمانڈ فارمیٹنگ، لنٹنگ، ٹائپس، یونٹ ٹیسٹس، ڈیٹرمنسٹک ڈاکیومنٹیشن، حقیقی براؤزر میں ڈاکیومنٹیشن اور بنڈل رویے، دوبارہ پیدا ہونے والے artifacts، پیک شدہ پیکج، ESM اور CommonJS resolution، declarations، اور tree-shaking کی توثیق کرتی ہے۔ اس کی packed-package integration suite test/integrations کے تحت برقرار رکھے گئے React، Vue، skia-canvas، اور single-file vanilla fixtures کو بھی بلڈ اور چلاتی ہے۔ Prettier ریپوزٹری کے فارمیٹنگ قواعد متعین کرتا ہے۔ ایک بار pnpm format چلانا، یا pnpm format:watch کو چلتا رکھنا، برقرار رکھی گئی سورس فائلوں کو تبدیل ہوتے وقت دوبارہ فارمیٹ کرتا ہے۔ تجویز کردہ VS Code ایکسٹینشن اور ورک اسپیس سیٹنگز بھی محفوظ کرنے پر Prettier فعال کرتی ہیں، جبکہ pnpm check CI میں غیر فارمیٹ شدہ تبدیلیوں کو مسترد کرتی ہے۔ ڈاکیومنٹیشن جنریشن ڈاکیومنٹیشن جنریٹر TypeDoc کے Node API کا استعمال کرتے ہوئے واضح سورس entry points سے حسب ضرورت اسٹیٹک ڈاکیومنٹیشن JSON دوبارہ بناتا ہے۔ یہ docs.md، guide.md، اور llms.txt بھی تیار کرتا ہے ان ایجنٹس اور دیگر کلائنٹس کے لیے جو ڈاکیومنٹیشن SPA میں نیویگیٹ نہیں کر سکتے۔ تیار شدہ ڈاکیومنٹیشن چیک اِن کی جاتی ہے؛ pnpm check:docs اسے میموری میں دوبارہ تیار کرتی ہے، پرانی یا اضافی فائلوں کی اطلاع دیتی ہے، اور Chromium میں نیویگیشن، سرچ، anchors، اور ریسپانسیو لے آؤٹس کو آزماتی ہے۔ شراکت اور لائسنس Issues اور چھوٹی pull requests کا خیرمقدم ہے؛ بڑی تبدیلیوں کا آغاز maintainer کے ساتھ بحث سے ہونا چاہیے۔ پروجیکٹ Apache License 2.0 کے تحت لائسنس یافتہ ہے، کاپی رائٹ 2017-present William Ngan اور contributors۔