Migrasi ke 1.0.0

Panduan ini merangkum kondisi API source 1.0.0 dan penyesuaian dari contoh dokumentasi 0.5.x. Ini bukan daftar tanggal rilis historis yang belum diverifikasi.

Perbarui dependency

npm install erlangform@1.0.0 zod@^4 @tanstack/react-form@^1

Basis source memakai React 19. Periksa dependency aplikasi dan jalankan pemeriksaan tipe/build setelah upgrade. Gunakan named import ErlForm; stylesheet dimuat otomatis.

Periksa konfigurasi

• Turunkan Values dari schema dan gunakan FieldConfig dengan satisfies.
• Letakkan child object pada induknya agar nama child yang sama tidak berbenturan.
• Gunakan item untuk array primitif, array dalam array, dan tuple dalam array. Bila item diberikan, konfigurasi itu menggantikan fallback konfigurasi item dari parent.
• Gunakan indeks 0, 1, dan seterusnya untuk tuple.
• Gunakan z.email(), z.url(), dan z.iso.* untuk inferensi input khusus.
• Hubungkan validator ke useForm; schema pada ErlForm hanya menyediakan metadata renderer.
• Siapkan defaultValues eksplisit. Default schema tidak otomatis mengisi state.

Cakupan versi 1.0.0

Dokumentasi mencakup radio, checkbox group, Date/ISO datetime/file, record, tuple, discriminated union, array bertingkat, batas item, duplikasi dan pengurutan, komponen kustom, kondisi, section, wizard, dan error server.

Beberapa opsi tersedia pada tipe tetapi belum diterapkan di semua renderer; lihat dukungan schema, file, dan wizard. Pastikan kasus aplikasi Anda diuji sebelum upgrade produksi.

URL dokumentasi

Object dan array sekarang berada pada kelompok Data terstruktur. URL lama /docs/basic/object dan /docs/basic/arrays diarahkan ke /docs/advanced/object dan /docs/advanced/arrays. URL awal /docs/object serta /docs/arrays tetap mendapat redirect.