skill

إعداد وحدات TypeScript المتعمقة

ربط dependency-cruiser بمستودع TypeScript بحيث تكون كل حزمة وحدة عميقة، مع إخفاء التنفيذ في مجلدات فرعية ولا يمكن الوصول إليه إلا من خلال ملفات نقطة الدخول الخاصة بها. يتم استدعاؤه من قبل المستخدم.

mattpocock279,325+ تثبيتموثوق

نبذة

# إعداد وحدات 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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 المتعمقة مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التطوير والبرمجة.

كل بدائل إعداد وحدات TypeScript المتعمقة ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
واجهة برمجة تطبيقات Claude
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات (params)، البث (streaming)، استخدام الأدوات، MCP، الوكلاء (agents)، التخزين الم…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
واجهة سطر الأوامر Hyperframes
واجهة سطر الأوامر (CLI) ل HyperFrames من job - لإنشاء الهياكل، والتحقق من الإطارات، وعرضها، وتعديل الجدول الزمني، والمعاينة، والتصيير محليا أو سحابيا،…1,214,920+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تطوير مدفوع بالاختبار
التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبار…1,046,962+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء
استجوب المستخدم بلا هوادة حول خطة أو قرار أو فكرة. استخدمها عندما يرغب المستخدم في اختبار مدى متانة تفكيره، أو يستخدم أي عبارات تحفيزية مثل "استجواب".869,010+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تشخيص الأخطاء
حلقة تشخيص للأخطاء الصعبة وتراجعات الأداء. تستخدم عندما يقول المستخدم "شخص/صحح هذا"، أو يبلغ عن شيء معطل/يصدر أخطاء/فاشل/بطيء.746,030+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
مراجعة الكود
راجع التغييرات منذ نقطة ثابتة (التزام، فرع، وسم، أو قاعدة دمج) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات (…696,572+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التطوير والبرمجة