Next
غلاف واحد للمُجمِّعين، والجذر في حدّ العميل.
أنشئ المشروع
pnpm create next-app@latest my-app --typescript --app
cd my-app
pnpm add @hanzo/ui @hanzo/gui react-native-webغلّف الضبط
const withGui = require('@hanzo/ui/next')
/** @type {import('next').NextConfig} */
const nextConfig = {}
module.exports = withGui(nextConfig, __dirname)يضع withGui ثلاثة أشياء، لـ webpack وTurbopack معًا: .web.* يُحل أولًا، وreact-native هو react-native-web، وكل حزمة @hanzogui/* في node_modules تُترجم حتى يصل الأولان إلى داخلها. يتآلف مع ما هو موجود — خطاف webpack() قائم، وضبط Turbopack، وtranspilePackages تُبقى وتُوسَّع. مرّر __dirname كي تُكتشف الحزمة من node_modules الخاص بالتطبيق، لا من حيث اتفق أن يكون مشغّل المهام.
يُعلَن مرة واحدة للمُجمِّعين، لأن ضبطًا خاصًا بـ webpack يغيب بصمت تحت Turbopack، ثم يختلف next dev وnext build في هل يُترجَم التطبيق.
ركّب الجذر
الجذر مكوّن عميل، فيعيش في ملف فيه التوجيه، ويصيّره التخطيط.
'use client'
import { Hanzo } from '@hanzo/ui'
export function Providers({ children }: { children: React.ReactNode }) {
return <Hanzo>{children}</Hanzo>
}import { Providers } from './providers'
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en" suppressHydrationWarning>
<body>
<Providers>{children}</Providers>
</body>
</html>
)
}suppressHydrationWarning على html من أجل صنف السمة الذي يكتبه مبدّل هناك قبل أن يركّب React — انظر الوضع الداكن.
مكوّنات الخادم
كل ما تحت @hanzo/ui حدّ عميل؛ يصيّره مكوّن الخادم باستيراده، كما يفعل مع أي مكوّن عميل. القواعد التي لا مكوّن ملصقًا بها — pages وmasked وtone وresolveBrand — في @hanzo/ui/product/pure ولا تستورد شيئًا، فيستطيع مكوّن خادم أو معالج مسار أن يناديها من غير تحميل شجرة مكوّنات.