docs(ar): translate RSC reference, rules of React, preconnect/prefetchDNS

Made-with: Cursor

Author: hamdymohamedak

src/content/reference/react-dom/preconnect.md

@@ -4,7 +4,7 @@ title: preconnect
 
 <Intro>
 
-`preconnect` lets you eagerly connect to a server that you expect to load resources from.
+`preconnect` يتيح لك الاتصال مسبقاً بخادم تتوقع تحميل موارد منه.
 
 ```js
 preconnect("https://example.com");
@@ -16,11 +16,11 @@ preconnect("https://example.com");
 
 ---
 
-## Reference {/*reference*/}
+## المرجع {/*reference*/}
 
 ### `preconnect(href)` {/*preconnect*/}
 
-To preconnect to a host, call the `preconnect` function from `react-dom`.
+للاتصال المسبق بمضيف، استدعِ الدالة `preconnect` من `react-dom`.
 
 ```js
 import { preconnect } from 'react-dom';
@@ -32,34 +32,34 @@ function AppRoot() {
 
 ```
 
-[See more examples below.](#usage)
+[المزيد من الأمثلة أدناه.](#usage)
 
-The `preconnect` function provides the browser with a hint that it should open a connection to the given server. If the browser chooses to do so, this can speed up the loading of resources from that server. 
+توفّر `preconnect` للمتصفّح تلميحاً بأن يفتح اتصالاً بالخادم المحدّد. إن اختار المتصفّح ذلك، قد يسرّع تحميل الموارد من ذلك الخادم.
 
-#### Parameters {/*parameters*/}
+#### المعاملات {/*parameters*/}
 
-* `href`: a string. The URL of the server you want to connect to.
+* `href`: سلسلة نصية. عنوان URL للخادم الذي تريد الاتصال به.
 
 
-#### Returns {/*returns*/}
+#### القيمة المُرجَعة {/*returns*/}
 
-`preconnect` returns nothing.
+لا تُرجِع `preconnect` شيئاً.
 
-#### Caveats {/*caveats*/}
+#### ملاحظات {/*caveats*/}
 
-* Multiple calls to `preconnect` with the same server have the same effect as a single call.
-* In the browser, you can call `preconnect` in any situation: while rendering a component, in an Effect, in an event handler, and so on.
-* In server-side rendering or when rendering Server Components, `preconnect` only has an effect if you call it while rendering a component or in an async context originating from rendering a component. Any other calls will be ignored.
-* If you know the specific resources you'll need, you can call [other functions](/reference/react-dom/#resource-preloading-apis) instead that will start loading the resources right away.
-* There is no benefit to preconnecting to the same server the webpage itself is hosted from because it's already been connected to by the time the hint would be given.
+* عدة استدعاءات لـ `preconnect` لنفس الخادم لها نفس أثر استدعاء واحد.
+* في المتصفّح يمكن استدعاء `preconnect` في أي موضع: أثناء تصيير مكوّن، أو في Effect، أو في معالج حدث، إلخ.
+* في التصيير على الخادم أو عند تصيير مكوّنات الخادم، لا يكون لـ `preconnect` أثر إلا إذا استُدعي أثناء تصيير مكوّن أو في سياق async منبثق من تصيير مكوّن. تُتجاهل أي استدعاءات أخرى.
+* إن كنت تعرف الموارد المحدّدة التي تحتاجها، يمكنك استدعاء [دوال أخرى](/reference/react-dom/#resource-preloading-apis) تبدأ تحميل الموارد فوراً.
+* لا فائدة من الاتصال المسبق بنفس الخادم الذي يستضيف الصفحة لأن الاتصال قائم بالفعل قبل أن يُعطى التلميح.
 
 ---
 
-## Usage {/*usage*/}
+## الاستخدام {/*usage*/}
 
-### Preconnecting when rendering {/*preconnecting-when-rendering*/}
+### الاتصال المسبق أثناء التصيير {/*preconnecting-when-rendering*/}
 
-Call `preconnect` when rendering a component if you know that its children will load external resources from that host.
+استدعِ `preconnect` أثناء تصيير مكوّن إن كنت تعلم أن الأبناء سيحمّلون موارد خارجية من ذلك المضيف.
 
 ```js
 import { preconnect } from 'react-dom';
@@ -70,9 +70,9 @@ function AppRoot() {
 }
 ```
 
-### Preconnecting in an event handler {/*preconnecting-in-an-event-handler*/}
+### الاتصال المسبق في معالج حدث {/*preconnecting-in-an-event-handler*/}
 
-Call `preconnect` in an event handler before transitioning to a page or state where external resources will be needed. This gets the process started earlier than if you call it during the rendering of the new page or state.
+استدعِ `preconnect` في معالج حدث قبل الانتقال إلى صفحة أو حالة سيُحمّل فيها موارد خارجية. يبدأ ذلك مبكراً أكثر من الاستدعاء أثناء تصيير الصفحة أو الحالة الجديدة.
 
 ```js
 import { preconnect } from 'react-dom';

src/content/reference/react-dom/prefetchDNS.md

@@ -4,7 +4,7 @@ title: prefetchDNS
 
 <Intro>
 
-`prefetchDNS` lets you eagerly look up the IP of a server that you expect to load resources from.
+`prefetchDNS` يتيح لك البحث المسبق عن عنوان IP لخادم تتوقع تحميل موارد منه.
 
 ```js
 prefetchDNS("https://example.com");
@@ -16,11 +16,11 @@ prefetchDNS("https://example.com");
 
 ---
 
-## Reference {/*reference*/}
+## المرجع {/*reference*/}
 
 ### `prefetchDNS(href)` {/*prefetchdns*/}
 
-To look up a host, call the `prefetchDNS` function from `react-dom`.
+للبحث عن مضيف، استدعِ الدالة `prefetchDNS` من `react-dom`.
 
 ```js
 import { prefetchDNS } from 'react-dom';
@@ -32,34 +32,34 @@ function AppRoot() {
 
 ```
 
-[See more examples below.](#usage)
+[المزيد من الأمثلة أدناه.](#usage)
 
-The prefetchDNS function provides the browser with a hint that it should look up the IP address of a given server. If the browser chooses to do so, this can speed up the loading of resources from that server. 
+توفّر `prefetchDNS` للمتصفّح تلميحاً بأن يبحث عن عنوان IP لخادم معيّن. إن اختار المتصفّح ذلك، قد يسرّع تحميل الموارد من ذلك الخادم.
 
-#### Parameters {/*parameters*/}
+#### المعاملات {/*parameters*/}
 
-* `href`: a string. The URL of the server you want to connect to.
+* `href`: سلسلة نصية. عنوان URL للخادم.
 
-#### Returns {/*returns*/}
+#### القيمة المُرجَعة {/*returns*/}
 
-`prefetchDNS` returns nothing.
+لا تُرجِع `prefetchDNS` شيئاً.
 
-#### Caveats {/*caveats*/}
+#### ملاحظات {/*caveats*/}
 
-* Multiple calls to `prefetchDNS` with the same server have the same effect as a single call.
-* In the browser, you can call `prefetchDNS` in any situation: while rendering a component, in an Effect, in an event handler, and so on.
-* In server-side rendering or when rendering Server Components, `prefetchDNS` only has an effect if you call it while rendering a component or in an async context originating from rendering a component. Any other calls will be ignored.
-* If you know the specific resources you'll need, you can call [other functions](/reference/react-dom/#resource-preloading-apis) instead that will start loading the resources right away.
-* There is no benefit to prefetching the same server the webpage itself is hosted from because it's already been looked up by the time the hint would be given.
-* Compared with [`preconnect`](/reference/react-dom/preconnect), `prefetchDNS` may be better if you are speculatively connecting to a large number of domains, in which case the overhead of preconnections might outweigh the benefit.
+* عدة استدعاءات لـ `prefetchDNS` لنفس الخادم لها نفس أثر استدعاء واحد.
+* في المتصفّح يمكن استدعاء `prefetchDNS` في أي موضع: أثناء تصيير مكوّن، أو في Effect، أو في معالج حدث، إلخ.
+* في التصيير على الخادم أو عند تصيير مكوّنات الخادم، لا يكون لـ `prefetchDNS` أثر إلا إذا استُدعي أثناء تصيير مكوّن أو في سياق async منبثق من تصيير مكوّن. تُتجاهل أي استدعاءات أخرى.
+* إن كنت تعرف الموارد المحدّدة، يمكنك استدعاء [دوال أخرى](/reference/react-dom/#resource-preloading-apis) تبدأ التحميل فوراً.
+* لا فائدة من prefetch لنفس خادم الصفحة لأن البحث قد تم بالفعل.
+* مقارنةً بـ [`preconnect`](/reference/react-dom/preconnect)، قد يكون `prefetchDNS` أفضل إذا اتصلت تخمينياً بعدد كبير من النطاقات، حيث قد يفوق عبء الاتصالات المسبقة الفائدة.
 
 ---
 
-## Usage {/*usage*/}
+## الاستخدام {/*usage*/}
 
-### Prefetching DNS when rendering {/*prefetching-dns-when-rendering*/}
+### prefetch لـ DNS أثناء التصيير {/*prefetching-dns-when-rendering*/}
 
-Call `prefetchDNS` when rendering a component if you know that its children will load external resources from that host.
+استدعِ `prefetchDNS` أثناء تصيير مكوّن إن كنت تعلم أن الأبناء سيحمّلون موارد من ذلك المضيف.
 
 ```js
 import { prefetchDNS } from 'react-dom';
@@ -70,9 +70,9 @@ function AppRoot() {
 }
 ```
 
-### Prefetching DNS in an event handler {/*prefetching-dns-in-an-event-handler*/}
+### prefetch لـ DNS في معالج حدث {/*prefetching-dns-in-an-event-handler*/}
 
-Call `prefetchDNS` in an event handler before transitioning to a page or state where external resources will be needed. This gets the process started earlier than if you call it during the rendering of the new page or state.
+استدعِ `prefetchDNS` في معالج حدث قبل الانتقال إلى صفحة أو حالة سيُحمّل فيها موارد خارجية.
 
 ```js
 import { prefetchDNS } from 'react-dom';

src/content/reference/rsc/directives.md

@@ -4,18 +4,18 @@ title: "التوجيهات (Directives)"
 
 <RSC>
 
-Directives are for use in [React Server Components](/reference/rsc/server-components).
+التوجيهات مخصّصة للاستخدام مع [مكوّنات خادم React](/reference/rsc/server-components).
 
 </RSC>
 
 <Intro>
 
-تستخدم React علامتي توجيه، لإعلام أدوات التجميع (bundlers) بأن ملفاتك تحتوي على [مكونات من جانب الخادم RSC](/learn/creating-a-react-app#full-stack-frameworks)، والتعليمات اللازمة لذلك.
+تستخدم React علامتي توجيه لإعلام أدوات التجميع (bundlers) بأن ملفاتك تحتوي على [مكوّنات خادم React (RSC)](/learn/creating-a-react-app#full-stack-frameworks)، والتعليمات اللازمة لذلك.
 </Intro>
 
 ---
 
-## توجيهات الكود {/*source-code-directives*/}
+## توجيهات الشيفرة {/*source-code-directives*/}
 
-* [`'use client'`](/reference/rsc/use-client) تميز الملف بأن ما فيه مكون من جانب العميل (client-side).
-* [`'use server'`](/reference/rsc/use-server) تميز الدوال من جانب الخادم (server-side) التي يمكن استدعاؤها من الكود من جانب العميل (client-side).
+* [`'use client'`](/reference/rsc/use-client) يوسّم الملف بأن ما فيه يُنفَّذ على جانب العميل (client).
+* [`'use server'`](/reference/rsc/use-server) يوسّم الدوال التي تعمل على الخادم ويمكن استدعاؤها من شيفرة العميل.