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

CompoMo ایک فریم ورک سے غیر جانبدار ویب کمپوننٹ لائبریری ہے جسے @ds-mo/ui کے طور پر شائع کیا گیا ہے۔ اسے Stencil.js کے ساتھ بنایا گیا ہے، TokoMo ڈیزائن ٹوکنز کے ساتھ اسٹائل کیا گیا ہے، اور اسے کسٹم ایلیمنٹس کے ساتھ ساتھ تیار کردہ Angular، React، اور Vue اڈاپٹرز کے طور پر تقسیم کیا گیا ہے۔ اسے @ds-mo/tokens اور @ds-mo/icons کے ساتھ ds-mo خاندان کے حصے کے طور پر بیان کیا گیا ہے۔ انسٹالیشن میں تین پیکیجز شامل ہیں: @ds-mo/tokens، @ds-mo/icons، اور @ds-mo/ui۔ TokoMo ٹوکنز کو ایپلی کیشن کی جڑ (root) پر ایک بار امپورٹ کیا جاتا ہے (tokens, tokens/reset, اور tokens/globals)۔ استعمال فریم ورک کے مطابق ہوتا ہے۔ سادہ HTML میں، کسی کمپوننٹ ماڈیول کو امپورٹ کرنے سے اس کا کسٹم ایلیمنٹ خود بخود ڈیفائن ہو جاتا ہے، لہذا ds-button-filled جیسے ٹیگ کو لیبل ایٹریبیوٹ کے ساتھ براہ راست استعمال کیا جا سکتا ہے۔ Angular ایپلی کیشنز کو فی-کمپوننٹ اسٹینڈ الون اڈاپٹرز (مثلاً @ds-mo/ui/angular/ds-button-filled) امپورٹ کرنے کی ترغیب دی جاتی ہے؛ React اور Vue ایپلی کیشنز بالترتیب @ds-mo/ui/react اور @ds-mo/ui/vue سے تیار کردہ ریپرز (wrappers) استعمال کرتی ہیں۔ آئیکنز @ds-mo/icons کے ذریعے حل کیے جاتے ہیں، جہاں ds-icon بنڈل کے وقت IcoMo کے درست کینونیکل ایکسپورٹ ناموں سے میل کھاتا ہے۔ لائبریری کئی عوامی سپورٹ سرفسز کی دستاویزات فراہم کرتی ہے: فریم ورک سے غیر جانبدار شیل کنٹریکٹس کے لیے @ds-mo/ui/shell، ٹوسٹ مینیجر کے لیے @ds-mo/ui/toast، registerIcons جیسے جنرل ہیلپرز کے لیے @ds-mo/ui/utils، رینڈرر سے غیر جانبدار سیمیٹک نثر اسٹائلنگ کے لیے @ds-mo/ui/prose.css، اور ایلیویٹڈ آؤٹر کنٹرول ریپرز کے لیے @ds-mo/ui/control-elevation.css۔ جان بوجھ کر کوئی عالمی کمپوننٹ CSS بنڈل نہیں رکھا گیا ہے؛ اسٹائلز ہر کسٹم ایلیمنٹ کے ساتھ فراہم کیے جاتے ہیں۔ براؤزر سپورٹ کے حوالے سے، CompoMo "Baseline Newly available" سیٹ کو ٹارگٹ کرتا ہے۔ کمپوننٹس ویب پلیٹ فارم فیچر کو اس وقت اپنا سکتے ہیں جب وہ Baseline کور براؤزرز میں انٹر آپریبل ہو جائے، اور پرانے براؤزر ورژن استعمال کرنے والوں سے توقع کی جاتی ہے کہ وہ اپنا فال بیک فراہم کریں یا کسی سابقہ ہم آہنگ ریلیز پر رہیں۔ ایک قابل ذکر اضافہ compomo-mcp ہے، جو پیکیج کے ساتھ بنڈل شدہ ایک لوکل ایگزیکیوٹیبل ہے۔ یہ کسٹم ایلیمنٹس، Angular، React، اور Vue کے لیے تیار کردہ کمپوننٹ میٹا ڈیٹا اور ایگزیکیوٹیبل کمپوزیشن ریسیپیز فراہم کرتا ہے، اور اسے MCP سرور کے طور پر رجسٹر کیا جا سکتا ہے (مثلاً Codex کنفیگ فائل میں node_modules/.bin/compomo-mcp کی نشاندہی کر کے)۔ اسے صرف stdio استعمال کرنے اور جدید 2026-07-28 پروٹوکول کے ساتھ ساتھ 2025-11-25 تک کے پرانے initialize- tabadul ورژن فراہم کرنے والا بتایا گیا ہے، جس میں ان کلائنٹس کے لیے خودکار ورژن مذاکرات کی سفارش کی گئی ہے جو جدید دریافت (discovery) کو سپورٹ کرتے ہیں۔ README کے مطابق API حقائق Stencil میٹا ڈیٹا سے آتے ہیں جبکہ کیوریٹڈ ارادہ ساتھ موجود کمپوننٹ ایجنٹ JSON اور ایگزیکیوٹیبل پیٹرنز سے آتا ہے۔ دستاویزات Storybook تعارف، فریم ورک انٹیگریشن گائیڈ، v13 مائیگریشن گائیڈ، مینٹینر ڈاکومنٹیشن راؤٹر، اور AGENTS.md میں ریپوزٹری ہدایات کے درمیان تقسیم ہیں۔ README واضح طور پر پیکیج ورژنز، کمپوننٹ لسٹوں، props، events، اور exports کی نقل کرنے سے انکار کرتا ہے، اور قارئین کو موجودہ حقائق کے لیے package.json، Storybook، یا تیار کردہ رجسٹری کی طرف بھیجتا ہے۔