Ultracite هو تكوين فحص قوي لتطبيقات TypeScript الحديثة، المبني على Biome. إنه عنيد وصارم بشكل لا يصدق، ويفرض أقصى قدر من سلامة النوع وجودة التعليمات البرمجية. بمجرد إعداد Ultracite، سيقوم تلقائيًا بفحص الكود الخاص بك وإصلاحه وتنسيقه عند الحفظ.
قم بتشغيل الأمر أدناه لتثبيت Ultracite:
pnpm add -D --save-exact ultracite @biomejs/biome
إذا كنت تقوم بتشغيل VS Code، فتأكد من تثبيت الملحقات التالية:
code --install-extension biomejs.biome
code --install-extension bradlc.vscode-tailwindcss
قم بإنشاء ملف biome.json
بالمحتويات التالية:
{ "extends" : [ " ultracite " ] }
تم تصميم Ultracite ليتم استخدامه مع VS Code. قم بإنشاء ملف .vscode/settings.json
بالمحتويات التالية لتمكين التنسيق الكامل والإصلاح عند الحفظ:
{
"typescript.tsdk" : " node_modules/typescript/lib " ,
"editor.defaultFormatter" : " biomejs.biome " ,
"editor.formatOnSave" : true ,
"editor.formatOnPaste" : true ,
"emmet.showExpandedAbbreviation" : " never " ,
"editor.codeActionsOnSave" : {
"quickfix.biome" : " explicit " ,
"source.organizeImports.biome" : " explicit "
},
"[typescript]" : {
"editor.defaultFormatter" : " biomejs.biome "
},
"[json]" : {
"editor.defaultFormatter" : " biomejs.biome "
},
"[javascript]" : {
"editor.defaultFormatter" : " biomejs.biome "
},
"[jsonc]" : {
"editor.defaultFormatter" : " biomejs.biome "
},
"[typescriptreact]" : {
"editor.defaultFormatter" : " biomejs.biome "
}
}
وأخيرًا، تأكد من أن tsconfig.json
(إذا كان موجودًا) يتضمن تكوين ESLint الجديد الخاص بك ومن تمكين strictNullChecks
.
{
"compilerOptions" : {
"strictNullChecks" : true
}
}
سوف يقوم Ultracite تلقائيًا بفحص الكود الخاص بك وإصلاحه وتنسيقه عند الحفظ. إذا كنت ترغب في تشغيل Ultracite يدويًا، فيمكنك القيام بذلك باستخدام الأمر التالي:
npx ultracite
على الرغم من أن Ultracite مصمم ليكون خاليًا من التكوين، إلا أنه يمكنك تعديل أي شيء تريده في ملف biome.json
الخاص بك. على سبيل المثال، لتمكين قاعدة noAutofocus
، يمكنك القيام بما يلي:
{
"extends" : [ " ultracite " ],
"linter" : {
"rules" : {
"a11y" : {
"noAutofocus" : " off "
}
}
}
}
يمكنك أيضًا تعطيل القواعد على أساس كل سطر عن طريق إضافة تعليق في نهاية السطر:
// biome-ignore lint/security/noDangerouslySetInnerHtml: I do what I want mate.
< div dangerouslySetInnerHTML = { { ... } } / >
تم إنشاء Ultracite سابقًا على ESLint وPrettier وStylint. إذا كنت ترغب في استخدام هذا المكدس، فيمكنك تثبيت إصدار متوافق من Ultracite باستخدام الأمر التالي:
pnpm add -D ultracite@3 eslint@8 prettier stylelint typescript jest