# Maguyva में TypeScript सपोर्ट: मोनोरेपो के लिए बेहतर कॉन्टेक्स्ट

Canonical source: https://maguyva.ai/hi/languages/typescript

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Maguyva, AST पार्सिंग और सिंबल एक्सट्रैक्शन के साथ TypeScript को सपोर्ट करता है, ताकि AI एजेंट मोनोरेपो में इंटरफ़ेस, इम्प्लीमेंटेशन, साझा पैकेज, और JSX-भारी एप्लिकेशन कोड को ट्रेस कर सकें।

## सपोर्ट स्नैपशॉट

- टियर: AST और सिंबल सपोर्ट
- प्रोग्रामिंग
- एक्सटेंशन: .cts, .d.ts, .mts, .spec.ts, .stories.ts, .test.ts, +1 और
- सिंटैक्स-अवेयर सर्च और स्ट्रक्चरल कॉन्टेक्स्ट के लिए असली AST पार्सिंग।
- नामित सिंबल सिमेंटिक लुकअप और क्रॉस-रेफ़रेंस को फ़ीड करते हैं। रिलेशनशिप एक्सट्रैक्शन सक्षम होने पर ग्राफ़ नेविगेशन उपलब्ध होता है।
- यह भाषा ग्राफ़-अवेयर सर्च में सिंबल्स और रिलेशनशिप्स जोड़ती है; सपोर्टेड एज प्रकार इसके नेटिव कंस्ट्रक्ट्स के अनुसार बदलते हैं।
- AST पार्सिंग और सिंबल एक्सट्रैक्शन, दोनों उपलब्ध हैं।

## सबसे उपयुक्त

- प्रोडक्ट और प्लेटफ़ॉर्म टीमें जो एक ही TypeScript रिपॉज़िटरी के भीतर Next.js, Node सर्विसेज़, साझा पैकेज, और टूलिंग चलाती हैं।
- ऐसे रिपॉज़िटरी जहां इंटरफ़ेस, DTO, स्कीमा, और React कंपोनेंट साथ-साथ बदलते हैं, लेकिन अलग-अलग डायरेक्टरी में रहते हैं।
- वे टीमें जो साझा टाइप या पैकेज सीमाओं को छूने से पहले AI एजेंट को सुरक्षित कॉन्टेक्स्ट देने की कोशिश करती हैं।

## एजेंट वर्कफ़्लो

- किसी टाइप, इंटरफ़ेस, या कंपोनेंट को उसकी परिभाषा से लेकर उन कोड पथों तक फ़ॉलो करें जो वास्तव में उसका उपयोग करते हैं।
- किसी साझा हेल्पर या API कॉन्ट्रैक्ट को बदलने से पहले पैकेज में इम्प्लीमेंटेशन की तुलना करें।
- किसी साझा टाइप, यूटिलिटी, या सर्विस मॉड्यूल को एडिट करने के संभावित ब्लास्ट रेडियस का मानचित्रण करें।

## TypeScript पेज क्यों मायने रखते हैं

TypeScript वह भाषा है जहां बहुत सी टीमें उम्मीद करती हैं कि AI-सहायता प्राप्त रीफ़ैक्टरिंग आख़िरकार सुरक्षित महसूस होगी। टाइप सिस्टम मदद करता है, लेकिन यह असली समस्या को दूर नहीं करता: साझा पैकेज, DTO, जनरेट किए गए क्लाइंट, React कंपोनेंट, टेस्ट, और ऐप कोड — ये सब एक बड़ी रिपॉज़िटरी में एक ही नामों पर निर्भर रहते हैं।

TypeScript के लिए, मानदंड "यह सिंटैक्स समझता है" से कहीं ऊंचा है। एजेंट को किसी साझा टाइप, hook, या क्लाइंट को एडिट करने से पहले कॉन्ट्रैक्ट को परिभाषा से इम्प्लीमेंटेशन और फिर उससे प्रभावित कोड तक फ़ॉलो करना ज़रूरी है।

## Maguyva वास्तव में TypeScript में क्या एक्सट्रैक्ट करता है

Maguyva, `.ts`, `.mts`, `.cts`, और टेस्ट व स्टोरी से जुड़े आम TypeScript फ़ाइल वेरिएंट में क्लासेज़, मेथड, इंटरफ़ेस, और टाइप एलियास एक्सट्रैक्ट करता है। मेंबर प्रीफ़िक्स नॉर्मलाइज़ किए जाते हैं, लेकिन क्लास-क्वालिफ़ाइड आइडेंटिफ़ायर सुरक्षित रखे जाते हैं, जो तब मदद करता है जब किसी रिपॉज़िटरी में एक बेयर हेल्पर नाम और एक क्लास-स्कोप्ड मेथड दोनों का अंतिम सेगमेंट एक जैसा हो।

JSX को इधर-उधर पड़े मार्कअप के बजाय एक असली संरचनात्मक सिग्नल माना जाता है। इंडेक्स की गई TypeScript फ़ाइलों में टेस्ट, स्टोरी और कॉन्फ़िगरेशन, एप्लिकेशन कोड के साथ उपलब्ध रहते हैं, जिससे एजेंट किसी साझा कंपोनेंट या सर्विस को बदलने से पहले उपयोग के उदाहरण और सेटअप की जाँच कर सकता है।

## TypeScript रिपॉज़िटरी के लिए उपयोगी MCP वर्कफ़्लो

तीन शुरुआती पैटर्न आमतौर पर काफ़ी होते हैं:

- जब आप पहले से इंटरफ़ेस, टाइप एलियास, hook, या सर्विस का नाम जानते हों, तो `find_symbol` का उपयोग करें।
- साझा टाइप या क्लाइंट को बदलने से पहले, जो कई पैकेज में फैल सकते हैं, `dependency_search` का उपयोग करें।
- जब आपको कीवर्ड मैच नहीं, बल्कि कोड की संरचना चाहिए हो, उदाहरण के लिए दोहराए गए कंपोनेंट या मेथड पैटर्न, तो `structural_search` का उपयोग करें।

"चेकआउट सबमिशन के पथ को फ़ॉलो करें" जैसे वैचारिक सवालों के लिए, `get_task_context` अक्सर कच्चे सर्च से बेहतर पहला कदम होता है।

## यह पेज सबसे ज़्यादा प्रासंगिक कहां है

यह पेज उन वेब और प्लेटफ़ॉर्म मोनोरेपो के लिए सबसे उपयोगी है जहां TypeScript कई पैकेज के लिए समन्वय लेयर है। अगर आपकी रिपॉज़िटरी में अब भी बहुत सारा पुराना JS शामिल है, तो [JavaScript मार्गदर्शिका](/hi/languages/javascript) पढ़ें। अगर आपका सवाल वास्तव में यह है कि "क्या एजेंट ऐप कोड और इन्फ़्रा कॉन्टेक्स्ट को साथ रख सकता है?" तो इसे [Terraform](/hi/languages/terraform) के साथ जोड़ें।

## इंजन विवरण

- TypeScript हर चीज़ को सामान्य सिंबल में समतल करने के बजाय क्लास, मेथड, इंटरफ़ेस, और टाइप एलियास एक्सट्रैक्ट करता है।
- मेंबर प्रीफ़िक्स हटा दिए जाते हैं, लेकिन क्लास-क्वालिफ़ाइड आइडेंटिफ़ायर सुरक्षित रहते हैं, जिससे `CheckoutService.create` को एक अकेले `create` से अलग पहचानने में मदद मिलती है।
- JSX एलिमेंट को इंस्टैंशिएशन माना जाता है। इंडेक्स की गई TypeScript फ़ाइलों में टेस्ट, स्टोरी और कॉन्फ़िगरेशन, एप्लिकेशन कोड के साथ कॉन्टेक्स्ट के रूप में उपलब्ध रहते हैं।

## उपयोगी MCP एंट्री पॉइंट

- `find_symbol`: जब आपको पता हो कि आप किस साझा इंटरफ़ेस, टाइप एलियास, हुक, या सर्विस को देखना चाहते हैं, तब यहीं से शुरू करें।
- `dependency_search`: पैकेजों में एक यथार्थवादी इम्पैक्ट रेडियस पाने के लिए किसी साझा DTO या क्लाइंट को बदलने से पहले इसका इस्तेमाल करें।
- `structural_search`: जब आपको स्ट्रिंग मैच नहीं बल्कि एक पैटर्न चाहिए हो, जैसे दोहराए गए कंपोनेंट या मेथड शेप, तब AST-लेवल सर्च का इस्तेमाल करें।
