skill
إعداد وحدات TypeScript المتعمقة
ربط dependency-cruiser بمستودع TypeScript بحيث تكون كل حزمة وحدة عميقة، مع إخفاء التنفيذ في مجلدات فرعية ولا يمكن الوصول إليه إلا من خلال ملفات نقطة الدخول الخاصة بها. يتم استدعاؤه من قبل المستخدم.
نبذة
# إعداد وحدات TS العميقة
اجعل كل حزمة في هذا المستودع **وحدة عميقة**: الكثير من السلوك وراء واجهة صغيرة. السطح العام للحزمة هو **نقاط الدخول** الخاصة بها (الملفات الموجودة في جذر الحزمة)، وكل شيء في مجلداتها الفرعية مخفي. تثبت هذه المهارة [dependency-cruiser](https://github.com/sverweij/dependency-cruiser) والقواعد التي تجعل نقاط الدخول هي الطريقة الوحيدة للوصول، ثم تثبت أن القواعد فعالة.
للمصطلحات (وحدة عميقة، واجهة، نقطة اتصال، عمق)، استدع أداة المهارة ب "codebase-design" واستخدم لغتها في جميع أنحاء النص.
## الشكل الذي يفرضه هذا
``` src/packages/ <name>/ index.ts ← نقطة دخول (عامة). استورد هذا من الخارج. client.ts ← نقطة دخول أخرى. قد تكشف الحزم عن عدة نقاط. lib/ ← التنفيذ: مخفي من الخارج، حر في استيراد بعضها البعض. tests/ ← اختبارات ومكونات مساعدة متجاورة (مجلد فرعي، لذا خاص). ```
السطح العام هو **ملفات الجذر** للحزمة، وليس ملف `index.ts` واحدا محددا. تقليديا، يعيش التنفيذ في `lib/` وتعيش الاختبارات في `tests/`، مما يمنح كل حزمة نفس شكل المجلدين. ومع ذلك، القاعدة نفسها عامة: *أي شيء* في *أي* مجلد فرعي هو خاص، لذلك لا تقوم أبدا بتوسيع التكوين لإضافة مجلد.
أربع قواعد، كلها `error`:
1. **حد نقطة الدخول**: يمكن للتعليمات البرمجية خارج الحزمة (تعليمات برمجية للتطبيق أو حزمة أخرى) استيراد نقاط دخول تلك الحزمة فقط (ملفات الجذر الخاصة بها)، وليس أي شيء في مجلداتها الفرعية. 2. **حرية داخل الحزمة**: تستورد ملفات الحزمة الخاصة ببعضها البعض بحرية. 3. **الاختبارات عبر نقاط الدخول**: يمكن للملفات الموجودة ضمن `<pkg>/tests/` استيراد أي نقاط دخول للحزمة ومكونات `tests/` الخاصة بها، ولكن لا يمكنها أبدا استيراد أي تفاصيل داخلية لمجلد فرعي للحزمة (ولا حتى تفاصيلها الخاصة). اختبارات التكامل عبر الحزم مقبولة؛ الاستيرادات العميقة ليست كذلك. 4. **لا توجد دورات**: لا توجد دورات تبعية.
**نقاط الدخول، وليست ملف تجميع.** نظرا لأن السطح العام هو *كل* ملف جذر، يمكن للحزمة أن تكشف عن عدة نقاط دخول صغيرة (`index.ts`, `client.ts`, `server.ts`) بدلا من توجيه كل شيء عبر ملف `index.ts` عملاق واحد. لا ينصح بملفات التجميع التي تعيد تصدير شجرة فرعية كاملة؛ حافظ على نقاط الدخول صغيرة وأخف التنفيذ في المجلدات الفرعية.
الطبقات (أي الحزم التي قد تعتمد على أي منها) هي اهتمام *مختلف* وتترك كقالب معلق في التكوين لهذا المستودع ليتم ملؤه.
## الخطوات
### 1. اكتشاف البيئة
- **مدير الحزم**: `pnpm-lock.yaml` ← pnpm، `yarn.lock` ← yarn، `bun.lockb` ← bun، وإلا npm. استخدمه لكل أمر أدناه (`pnpm`/`yarn`/`npm run`/`bunx`). - **جذر الحزم**: إذا كان `src/` موجودا، استخدم `src/packages`، وإلا `packages`. أكد الاختيار مع المستخدم إذا كان المستودع يحتوي بالفعل على اتفاقية واضحة مختلفة. - **التكوين الحالي**: تحقق من وجود ملف `.dependency-cruiser.*`. إذا كان موجودا، **لا** تقم بالكتابة فوقه: ادمج القواعد الأربع والخيارات فيه، وأخبر المستخدم بما أضفته.
**يتم الانتهاء عندما:** يكون مدير الحزم، وجذر الحزم، وحالة التكوين الحالي كلها معروفة.
### 2. تثبيت dependency-cruiser
ثبت `dependency-cruiser` ك devDependency باستخدام مدير الحزم المكتشف.
**يتم الانتهاء عندما:** يكون `dependency-cruiser` موجودا في `devDependencies`.
### 3. كتابة التكوين
انسخ [`dependency-cruiser.config.cjs`](./dependency-cruiser.config.cjs) إلى جذر المستودع ك `.dependency-cruiser.cjs`. اضبط `PACKAGES_ROOT` على الجذر المكتشف في الخطوة 1. تعتمد القواعد على عمق المسار ومستقلة عن الامتداد، لذلك لا يلزم تكييف أي شيء آخر.
**يتم الانتهاء عندما:** يكون `.dependency-cruiser.cjs` موجودا مع `PACKAGES_ROOT` الصحيح، وتكون القواعد الأربع المحظورة موجودة.
### 4. ربطه بالفحوصات
- أضف سكربت `lint:boundaries`: `depcruise <packages-root>` (أو `depcruise src`). - ادمجه في أمر الفحص الشامل للمستودع، الأمر الذي يقوم بالفعل بتشغيل فحص النوع (على سبيل المثال، سكربت `check` / `ci` / `validate`). **لا** تلمس `tsconfig` أو تضيف أسماء مستعارة للمسار. - إذا لم يكن هناك سكربت شامل، أضف `lint:boundaries` واطلب من المستخدم تضمينه في CI.
**يتم الانتهاء عندما:** يكون `lint:boundaries` موجودا ويعمل كجزء من نفس الأمر مثل فحص النوع.
### 5. إعداد حزمة المثال
أنشئ مجلد `<packages-root>/example/` ملتزما كقالب للنسخ:
- `index.ts` هي نقطة دخول. قم بتصدير دالة واحدة تفوض إلى ملف داخلي (بحيث تكون الحزمة *عميقة* بشكل واضح، وليست تمريرا). - `lib/impl.ts`: ملف داخلي في **مجلد فرعي**، يتم استيراده بواسطة `index.ts`، ولا يمكن الوصول إليه من الخارج. - `tests/example.test.ts` يستورد **فقط** `../index` (نقطة دخول) ويؤكد مقابل الدالة العامة.
أخبر المستخدم أن هذا قالب بدء للنسخ أو الحذف.
**يتم الانتهاء عندما:** تكون حزمة المثال موجودة، وتكشف عن سلوكها من خلال نقطة دخول جذر، وتخفي `impl` في مجلد فرعي.
### 6. إثبات فعالية القواعد
هذا هو معيار الإنجاز للمهارة بأكملها: التكوين الذي لا يفشل عند الانتهاك لا قيمة له.
1. قم بتشغيل `lint:boundaries`. يجب أن **يمر** على المثال النظيف. 2. أضف مؤقتا استيرادا عميقا إلى `tests/example.test.ts` (على سبيل المثال `import { th`)
التثبيت
شغل هذا الأمر
npx skills add mattpocock/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add mattpocock/skills`، أو استنسخ المستودع وانسخ مجلد `skills/in-progress/setup-ts-deep-modules` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة إعداد وحدات TypeScript المتعمقة؟
ربط dependency-cruiser بمستودع TypeScript بحيث تكون كل حزمة وحدة عميقة، مع إخفاء التنفيذ في مجلدات فرعية ولا يمكن الوصول إليه إلا من خلال ملفات نقطة الدخول الخاصة بها. يتم استدعاؤه من قبل المستخدم.
كيف أثبت إعداد وحدات TypeScript المتعمقة؟
شغل هذا الأمر في الطرفية:
npx skills add mattpocock/skillsمع أي أدوات ذكاء اصطناعي تعمل إعداد وحدات TypeScript المتعمقة؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور إعداد وحدات TypeScript المتعمقة؟
طورها mattpocock.
هل إعداد وحدات TypeScript المتعمقة مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى