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

Ark UI एक ओपन-सोर्स, headless कंपोनेंट लाइब्रेरी है जिसे Chakra UI टीम द्वारा मेंटेन किया गया है। यह डिज़ाइन सिस्टम और वेब एप्लिकेशन बनाने के लिए बिना स्टाइल वाली लॉजिक और एक्सेसिबिलिटी लेयर प्रदान करती है, जिससे सभी विजुअल स्टाइलिंग डेवलपर पर छोड़ दी जाती है। **मुख्य दृष्टिकोण** यह प्रोजेक्ट कंपोनेंट के व्यवहार (behaviour) को उसके स्वरूप (appearance) से अलग करता है। प्रत्येक कंपोनेंट बिना किसी डिफॉल्ट स्टाइल के आता है, ताकि टीमें Tailwind, Panda CSS, Emotion या Styled Components जैसे CSS-in-JS समाधान, CSS Modules, या साधारण CSS का उपयोग कर सकें। इसका घोषित लक्ष्य डिज़ाइन-सिस्टम लेखकों को प्रेजेंटेशन पर पूर्ण नियंत्रण देना है, जबकि वे परीक्षित इंटरैक्शन और एक्सेसिबिलिटी व्यवहार को अपना सकें। **आर्किटेक्चर** कंपोनेंट लॉजिक Zag.js फाइनाइट स्टेट मशीनों पर आधारित है। README के अनुसार, इससे प्रेडिक्टेबल और टाइप-सेफ स्टेट ट्रांज़िशन, आसान टेस्टिंग और डीबगिंग, और कम एज केसेस मिलते हैं। एक ही कंपोनेंट व्यवहार React, Solid, Vue और Svelte के लिए अलग-अलग पैकेजों के माध्यम से उपलब्ध कराया गया है, ताकि एक डिज़ाइन सिस्टम लॉजिक को दोबारा लिखे बिना विभिन्न फ्रेमवर्क्स में एक ही API सरफेस साझा कर सके। ये पैकेज TypeScript के साथ पूरी तरह से टाइप किए गए हैं। **एक्सेसिबिलिटी** README बताता है कि कंपोनेंट्स WAI-ARIA डिज़ाइन पैटर्न का पालन करते हैं और सहायक तकनीकों (assistive technologies) के साथ परीक्षित हैं। दावा की गई विशेषताओं में उचित ARIA एट्रिब्यूट्स और रोल्स, कीबोर्ड नेविगेशन, फोकस मैनेजमेंट, स्क्रीन-रीडर अनाउंसमेंट और RTL सपोर्ट शामिल हैं। **कंपोनेंट्स** Ark UI 45+ कंपोनेंट्स का विज्ञापन करता है जिन्हें मोटे तौर पर इस प्रकार वर्गीकृत किया गया है: - लेआउट और नेविगेशन: Accordion, Tabs, Splitter, Steps, Tree View, Tour - ओवरले: Dialog, Popover, Tooltip, Hover Card, Bottom Sheet, Floating Panel - फॉर्म और इनपुट: Checkbox, Radio Group, Select, Combobox, Number Input, Pin Input, Tags Input, Editable, File Upload, Color Picker, Date Picker, Password Input, Signature Pad, Slider, Angle Slider, Rating Group, Switch, Toggle और Toggle Group - डेटा डिस्प्ले: Avatar, Highlight, Progress, QR Code, Format, JSON Tree View, Marquee - यूटिलिटीज: Carousel, Clipboard, Collapsible, Field और Fieldset, Menu, Pagination, Portal, Presence, Scroll Area, Segment Group, Timer, Toast, Client Only, Download Trigger, Focus Trap, Frame, Collection, Listbox **इंस्टॉलेशन और उपयोग** प्रत्येक फ्रेमवर्क का अपना npm पैकेज है (`@ark-ui/react`, `@ark-ui/solid`, `@ark-ui/vue`, `@ark-ui/svelte`)। कंपोनेंट्स को प्रति कंपोनेंट इम्पोर्ट किया जाता है, उदाहरण के लिए `@ark-ui/react/dialog`, और इन्हें Root, Trigger, Backdrop, Positioner, Content, Title, Description और CloseTrigger जैसे प्रिमिटिव्स से बनाया जाता है। README सभी चार फ्रेमवर्क्स में लगभग समान मार्कअप के साथ रेंडर किए गए Dialog का उदाहरण दिखाता है। **इकोसिस्टम** Ark UI, Chakra UI v3 का आधार है, और README में Park UI और Tark UI का भी उल्लेख है जो इसके ऊपर बने स्टाइल वाले कंपोनेंट सेट हैं। एक अलग इंटीग्रेशन फोल्डर AI-असिस्टेड डेवलपमेंट के लिए एक MCP सर्वर प्रदान करता है। **दस्तावेज़ीकरण और समुदाय** गाइड्स, प्रति-कंपोनेंट API रेफरेंस, उदाहरण और स्टाइलिंग रेसिपी ark-ui.com पर उपलब्ध हैं। प्रोजेक्ट का एक Discord समुदाय, फीचर अनुरोधों के लिए एक सार्वजनिक Canny रोडमैप और एक ब्लॉग है। योगदान एक कंट्रीब्यूटिंग गाइड के माध्यम से स्वीकार किए जाते हैं, और सहायता दस्तावेज़ीकरण, Discord और GitHub इश्यूज के माध्यम से मिलती है। विकास Open Collective के माध्यम से वित्त पोषित है, और प्रोजेक्ट को MIT लाइसेंस के तहत जारी किया गया है।