roninforge-angularjs-migration

AngularJS से Angular 18 GitHub Copilot निर्देश पैकेज के लिए स्रोत-सत्यता रिपॉजिटरी, जो github/awesome-copilot पर instructions/angularjs-to-angular-18.instructions.md के रूप में भेजा गया है। RoninForge से उद्यम-लक्षित Copilot उत्पादों की एक नियोजित श्रृंखला में पहला (नियोजित: .NET Framework से .NET 9 माइग्रेशन, HIPAA PHI रिडक्शन, T-SQL एंटी-पैटर्न, लीगेसी कोड के लिए कैरेक्टराइज़ेशन टेस्ट)।

समस्या

• AngularJS 1.x ने 31 दिसंबर, 2021 को दीर्घकालिक समर्थन (LTS) समाप्त कर दिया। जनवरी 2022 से Google ने सुरक्षा, ब्राउज़र-संगतता और jQuery-संगतता फिक्स भेजना बंद कर दिया है।
• अंतिम रिलीज v1.8.3 (7 अप्रैल, 2022) है - एक README-मात्र "अंतिम विदाई" टैग। वास्तविक कोड फ्रीज़ v1.8.2 (अक्टूबर 2020) है।
• CVE-2024-21490 (ng-srcset में Regular Expression Denial of Service, सभी संस्करण 1.3.0 से 1.8.3) का कोई अपस्ट्रीम पैच नहीं है। वाणिज्यिक विस्तारित-समर्थन फोर्क (HeroDevs NES, OpenLogic) ही एकमात्र पैच किए गए बिल्ड हैं।
• बैंक, हेल्थकेयर सिस्टम और सरकारी एजेंसियां अभी भी 1.x पर हैं: अनुपालन फ्रीज़, प्रतिभा अंतराल, ngUpgrade जटिलता, और XLTS माइग्रेशन-गणित सूत्र (TTM = (LOC/LPW) * 1.4) जो कैलेंडर लागत को दृश्यमान बनाता है।
• GitHub Copilot का अपना मुद्दा ट्रैकर (#1019, #1128) Angular 17+ सिंटैक्स जागरूकता की कमी को दस्तावेज करता है; HeroDevs रिपोर्ट करता है कि AI-सहायता प्राप्त AngularJS माइग्रेशन का 73% शेड्यूल से पीछे रह जाता है क्योंकि LLM 2025-पूर्व के पैटर्न उत्सर्जित करते हैं।

यह पैकेज Copilot को क्या सिखाता है

एक बड़ी .instructions.md फ़ाइल (1,971 पंक्तियाँ) जो कवर करती है:

• AngularJS EOL स्थिति + CVE-2024-21490 साक्ष्य (क्यों माइग्रेशन अनिवार्य है जब तक कि वाणिज्यिक समर्थन पर न हों)
• 17 Angular 18 विहित पैटर्न (स्टैंडअलोन डिफ़ॉल्ट, सिग्नल, कंट्रोल फ्लो @if/@for/@switch, डिफरेबल व्यू @defer, फंक्शन-आधारित इंटरसेप्टर/गार्ड/रिज़ॉल्वर, provideHttpClient, provideRouter + withComponentInputBinding, inject(), टाइप किए गए रिएक्टिव फॉर्म, OnPush + ज़ोनलेस डेव प्रीव्यू, DestroyRef + takeUntilDestroyed, toSignal/toObservable, सिग्नल-आधारित viewChild/viewChildren, NgOptimizedImage, Vitest, एप्लीकेशन बिल्डर)
• प्रयास आकार और केस स्टडीज़ के साथ तीन माइग्रेशन पथ: बिग-बैंग (3-9 महीने), ngUpgrade हाइब्रिड (6-18 महीने, अनुशंसित), स्ट्रैंगलर-फिग (6-24 महीने)
• 62 एंटी-पैटर्न BAD/CORRECT जोड़े और स्रोत उद्धरणों के साथ, तीन विफलता मोड में:
  • मोड A (15): सादे "Angular" अनुरोधों के लिए उत्सर्जित AngularJS 1.x पैटर्न ($scope.$apply, ng-controller, $compile, $http, $q, ng-app, ng-bind-html, ng-click, angular.module, | filter, $resource, $cookies, $location, IIFE 'use strict' रैप)
  • मोड B (35): Angular 18 के बजाय उत्सर्जित Angular 2-17 लीगेसी मुहावरे (*ngIf / *ngFor / *ngSwitch, NgModules, @Input() / @Output() डेकोरेटर, कंस्ट्रक्टर DI, क्लास-आधारित इंटरसेप्टर/गार्ड/रिज़ॉल्वर, HttpClientModule, RouterModule.forRoot, Promise.all बनाम forkJoin, सब्सक्राइब लीक, BehaviorSubject स्टेट, डिफ़ॉल्ट चेंज डिटेक्शन, @ViewChild स्टैटिक, अनटाइप किए गए फॉर्म, rxjs/operators डिप्रेकेटेड इम्पोर्ट, ब्राउज़र बिल्डर)
  • मोड C (12): माइग्रेशन-विशिष्ट गलतियाँ (ngUpgrade के बिना बिग-बैंग सलाह, अनुरक्षित न पैकेज, मिश्रित इम्पोर्ट, लापता downgradeInjectable / downgradeComponent, गलत बूटस्ट्रैप क्रम, ng update को फ्रेमवर्क माइग्रेशन के रूप में मानना, शाब्दिक $rootScope.$broadcast पोर्ट, स्टैंडअलोन में BrowserAnimationsModule, ज़ोनलेस + zone.js पॉलीफिल लीक)
• निर्णय वृक्ष (LoC-बकेट से कैलेंडर मैपिंग; शर्त से पथ)
• आठ ngUpgrade नुकसान और फिक्स स्निपेट
• संदर्भ (Angular 18 आधिकारिक दस्तावेज़, EOL + CVE सलाहकार, वाणिज्यिक समर्थन, केस स्टडीज़, डिप्रेकेशन)

रिपॉजिटरी लेआउट

~/development/roninforge-angularjs-migration/
.
.cm  README.md                       This file
.cm  LICENSE                         MIT
.cm  CHANGELOG.md                    semver entries
.cm  META.yml                        slug / type / version / target_paths consumed by submit script
.cm  .editorconfig / .gitattributes  LF-only normalization (awesome-copilot blocks CRLF)
.cm  .codespellrc                    mirrors upstream allowlist
.cm  scripts/
.cm    validate-awesome-copilot-submission.sh   reusable validator, mirrors every blocking CI gate
.cm    submit-to-awesome-copilot.sh             reusable submitter (fork, branch from staged, copy, regen, PR)
.cm  src/                            (placeholder for authoring partials when future packages split sources)
.cm  dist/
.cm    angularjs-to-angular-18.instructions.md  exact file that gets rsynced into upstream instructions/
.cm  tests/golden/                   (placeholder for diff-against-frozen-output tests)
.cm  .github/workflows/validate.yml  runs the validator on every push

research/ gitignored है; इसमें आंतरिक नोट्स हैं जिन्होंने निर्देश सामग्री को सूचित किया लेकिन सार्वजनिक आर्टिफैक्ट का हिस्सा नहीं है।

पाइपलाइन स्क्रिप्ट (सभी RoninForge awesome-copilot पैकेजों में पुन: प्रयोज्य)

scripts/validate-awesome-copilot-submission.sh

github/awesome-copilot के क्लोन के अंदर चलाएँ। प्रत्येक अवरुद्ध CI गेट को दर्पण करता है:

1. प्रीफ्लाइट (node 20+, npm, jq, git, codespell)
2. यदि आवश्यक हो तो npm ci
3. पथ से आर्टिफैक्ट प्रकार का पता लगाएँ
4. नामकरण सम्मेलन जाँच (लोअरकेस-केबाब; प्रकार-वार फ़ाइलनाम regex)
5. फ्रंटमैटर स्कीमा जाँच (प्रकार-वार आवश्यक फ़ील्ड, एकल-उद्धृत स्ट्रिंग)
6. बॉडी सामग्री जाँच (निर्देश # से खुलने चाहिए)
7. CRLF लाइन-एंडिंग जाँच (पाए जाने पर अवरुद्ध)
8. codespell --check-filenames --config .codespellrc
9. स्किल्स के लिए 5MB एसेट कैप
10. वर्कफ़्लो के लिए gh aw compile --validate
11. प्लगइन्स के लिए npm run plugin:validate
12. स्किल्स/एजेंट के लिए npm run skill:validate (केवल चेतावनी)
13. npm start + git diff --exit-code (#1 यांत्रिक बाउंस - यदि README/मार्केटप्लेस पुराने हैं तो validate-readme.yml विफल हो जाता है)

scripts/submit-to-awesome-copilot.sh

एंड-टू-एंड पाइपलाइन:

1. META.yml पढ़ें (slug, type, version)
2. gh auth status
3. github/awesome-copilot को RoninForge में फोर्क करें यदि पहले से फोर्क नहीं किया गया है
4. फोर्क को .upstream-clone/ में क्लोन करें
5. upstream/staged पर फ़ेच और रीसेट करें (NEVER main)
6. upstream/staged से फ़ीचर ब्रांच काटें
7. dist/ आर्टिफैक्ट को अपस्ट्रीम ट्री में सही पथ पर प्रति प्रकार कॉपी करें
8. वैलिडेटर चलाएँ (ऊपर) - किसी भी विफलता पर रोकें
9. README + मार्केटप्लेस को पुनर्जीवित करने के लिए npm start
10. 🤖🤖🤖 AI-लेखक फ़ास्ट-ट्रैक मार्कर के साथ कमिट करें
11. फोर्क में पुश करें
12. बेस: staged (NEVER main) के साथ PR खोलें - check-pr-target.yml जॉब स्वचालित रूप से main पर PR को अस्वीकार करता है

--dry-run (पुश से पहले रुकता है) और --no-pr (PR निर्माण छोड़ते हुए ब्रांच पुश करता है) का समर्थन करता है।

संस्करण

पिन फ़्लोर:

• AngularJS अंतिम स्थिर: 1.8.2 (अक्टूबर 2020, अंतिम कोड रिलीज़); 1.8.3 (अप्रैल 2022, README-मात्र विदाई)। LTS 31 दिसंबर 2021 को समाप्त हुआ।
• Angular 18: 22 मई, 2024। ng update स्कीमेटिक स्थिरता के लिए नवीनतम 18.x पैच अनुशंसित।
• Angular 18 डेव सर्वर के लिए Node 20 LTS न्यूनतम।
• Angular 18 पीयर के लिए RxJS 7.5+ न्यूनतम।
• Angular 18 पीयर के लिए TypeScript 5.4+ न्यूनतम।

से बचें: AngularJS-युग के पैकेज जो अब अनुरक्षित नहीं हैं (angular-ui-bootstrap, ng-storage, ng-flow, angular-translate-loader-static-files); नई टेस्ट फ़ाइलों के लिए Karma + Jasmine (Vitest के माध्यम से ng add @analogjs/vitest-angular)।

लाइसेंस

MIT - देखें LICENSE।

लिंक

• Angular 18 रिलीज़ पोस्ट
• AI-सहायता प्राप्त डेवलपमेंट के लिए Angular llms.txt
• ngUpgrade दस्तावेज़ीकरण
• HeroDevs CVE-2024-21490 सलाहकार
• endoflife.date / AngularJS
• github/awesome-copilot
• RoninForge

RoninForge से और अधिक

RoninForge AI कोडिंग सहायकों के साथ काम करने वाले डेवलपर्स के लिए मुफ़्त टूल बनाता है:

• LLM API मूल्य तुलना - Claude, GPT, Gemini, DeepSeek, Mistral और Grok टोकन कीमतें साथ-साथ, आधिकारिक मूल्य निर्धारण पृष्ठों से सत्यापित
• GitHub Copilot AI Credits कैलकुलेटर - उपयोग-आधारित बिलिंग के तहत अपने मासिक क्रेडिट खर्च का अनुमान लगाएं
• सभी Cursor प्लगइन्स