vite-env-only يرفض node:fs مع Intlayer

إذا استخدمت الإضافة vite-env-only (كما ذُكر في اقتراحات React-Router v7 الأقدم) ورأيت:

Error: [vite-env-only] Import denied* Denied by specifier pattern: /^node:/* Importer: index.html* Import: "node:fs"

…على الرغم من أنه لا يوجد node:fs في حزمة العميل الخاصة بك، إلا أن هذا هو إيجابي كاذب.

ما الذي يسببه

vite-env-only يقوم بفحص يعتمد على Babel في وقت مبكر أثناء حل مخطط الاعتماديات في Vite، قبل:

• aliasing (بما في ذلك خرائط Intlayer بين المتصفح وNode),
• إزالة الشيفرة غير المُستخدمة (dead-code elimination),
• حل SSR مقابل العميل،
• الوحدات الافتراضية مثل تلك في React-Router.

حزم Intlayer تحتوي على شيفرة يمكن أن تعمل على كل من Node والمتصفح. في مرحلة وسيطة، قد يظهر مكوّن مدمج في Node مثل node:fs في المخطط قبل أن يزيله Vite من بناء العميل. vite-env-only يلاحظ ذلك ويُطلق الخطأ فورًا، حتى وإن كانت الحزمة النهائية لا تحتوي عليه.

React-Router ووحدات الخادم

في وثائق React-Router حول اتفاقيات وحدات الخادم (https://reactrouter.com/api/framework-conventions/server-modules)، يقترح الفريق بشكل صريح استخدام vite-env-only لمنع استيرادات الخادم فقط من التسرب إلى حزمة العميل.

ومع ذلك، تعتمد تلك الاتفاقيات على aliasing الخاص بـ Vite، و conditional exports، و tree-shaking لإزالة كود الخادم فقط. بينما يتم تطبيق aliasing و conditional exports بالفعل، تظل بعض الأدوات المعتمدة على Node موجودة في حزم مثل @intlayer/core في تلك المرحلة (حتى وإن لم تُستورد على العميل). وبما أن عملية tree-shaking لم تُنفَّذ بعد، تُحلل تلك الدوال بواسطة Babel، ويكتشف vite-env-only استيرادات node: ويرفع نتيجة إيجابية كاذبة — على الرغم من أنها تُزال بشكل صحيح من حزمة العميل النهائية.

كيفية الإصلاح / حلول بديلة

موصى به: إزالة vite-env-only

ببساطة احذف الإضافة. في العديد من الحالات لست بحاجة إليها — Vite يتعامل بالفعل مع استيرادات العميل مقابل الخادم عبر آلية الحل الخاصة به.

هذا يصلح خطأ رفض node:fs الزائف دون أي تغييرات في Intlayer.

تحقق من البناء النهائي بدلاً من ذلك

إذا رغبت مع ذلك بالتأكد من عدم وجود مكونات مدمجة من Node في جانب العميل، فافعل ذلك بعد عملية البناء، مثلاً:

pnpm buildgrep -R "node:" dist/

إذا لم تُرجع نتائج، فإن حزم العميل نظيفة.

ملخص

• قد يُخطئ vite-env-only بشأن node:fs لأنه يتحقق مبكرًا جدًا.
• عادةً ما تزيل Vite + Intlayer + إرشادات وحدات الخادم في React-Router المراجع الخاصة بالخادم بشكل صحيح.
• إزالة الإضافة أو التحقق من المخرجات النهائية هو عادةً الحل الأفضل.