इस प्रोजेक्ट के बारे में

CompoMo एक framework-neutral वेब कंपोनेंट लाइब्रेरी है जिसे @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 टोकन को एप्लिकेशन रूट पर एक बार इम्पोर्ट किया जाता है (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 से जनरेटेड रैपर्स का उपयोग करते हैं। आइकन्स को @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 है, जो पैकेज के साथ बंडल किया गया एक लोकल एक्जीक्यूटेबल है। यह Custom Elements, Angular, React और Vue के लिए जनरेटेड कंपोनेंट मेटाडेटा और एक्जीक्यूटेबल कंपोज़िशन रेसिपीज़ को एक्सपोज़ करता है, और इसे एक MCP सर्वर के रूप में रजिस्टर किया जा सकता है (उदाहरण के लिए Codex कॉन्फ़िग फ़ाइल में node_modules/.bin/compomo-mcp की ओर इशारा करते हुए)। इसे केवल stdio का उपयोग करने और आधुनिक 2026-07-28 प्रोटोकॉल के साथ-साथ 2025-11-25 तक लीगेसी initialize-आधारित रिविज़न सर्व करने के रूप में वर्णित किया गया है, जिसमें आधुनिक डिस्कवरी का समर्थन करने वाले क्लाइंट्स के लिए ऑटोमैटिक वर्ज़न नेगोशिएशन की सिफारिश की गई है। README के अनुसार API तथ्य Stencil मेटाडेटा से आते हैं जबकि क्यूरेटेड इंटेंट सह-स्थित कंपोनेंट एजेंट JSON और एक्जीक्यूटेबल पैटर्न्स से आते हैं। दस्तावेज़ीकरण एक Storybook परिचय, एक फ्रेमवर्क इंटीग्रेशन गाइड, एक v13 माइग्रेशन गाइड, एक मेंटेनर डॉक्यूमेंटेशन राउटर, और AGENTS.md में रिपॉजिटरी निर्देशों में विभाजित है। README स्पष्ट रूप से पैकेज वर्ज़न, कंपोनेंट लिस्ट, प्रॉप्स, इवेंट्स और एक्सपोर्ट्स को डुप्लिकेट करने से इनकार करता है, और पाठकों को वर्तमान तथ्यों के लिए package.json, Storybook, या जनरेटेड रजिस्ट्री की ओर निर्देशित करता है।