Rilis
Versioning
Tiap persona punya versi dan statusnya sendiri, di atas satu lapisan Foundation yang dipakai bersama. Paket npm @vilacation/designkit saat ini 0.6.0. Sumber data: src/docs/versions.ts.
Siapa pakai versi berapa
| Persona | Versi aktif | Memakai Foundation | Target adopsi | Dipakai oleh | |
|---|---|---|---|---|---|
| Foundation | v0.2 | — | Semua persona | Belum ada | |
| Guest | v0.5 | v0.2 | vilacation-frontend, vilacation-mobile | Belum ada | |
| Host | v0.2 | v0.2 | vilacation-cms, area /host | Belum ada | |
| Admin | v0.2 | v0.2 | vilacation-cms, area /management | Belum ada |
"Dipakai oleh" hanya diisi untuk app yang sudah mem-pin versi itu di package.json. Sekarang kosong untuk semua, karena design system ini belum diadopsi di frontend, mobile, maupun CMS. "Target adopsi" adalah rencana, bukan fakta pemakaian.
Detail per persona
Guest Aktif v0.5 Foundation v0.2
Pengalaman tamu: web (vilacation-frontend) dan app mobile.
| Item | Jenis | Status | Sejak | Obsolete sejak / pengganti | Foundation | Catatan |
|---|---|---|---|---|---|---|
| v0.5 — Batch 3: galeri, peta, validasi, navigasi desktop | Rilis | Dipakai | v0.5 | — | v0.2 | Menambah PhotoGallery, MapFrame, MapMarker, ErrorSummary, Drawer dari bawah, dan tautan di Header. Token tidak berubah. |
| v0.4 — Batch 2: overlay, form, notifikasi | Rilis | Obsolete | v0.4 | v0.5 Ganti: v0.5 | v0.2 | Modal, Drawer, Toast, Checkbox, Switch, Counter, Tabs, EmptyState. Dibawa ke v0.5 tanpa perubahan API. |
| v0.3 — Library Svelte 5 + docs SvelteKit | Rilis | Obsolete | v0.3 | v0.4 Ganti: v0.4 | v0.2 | Seluruh isinya dibawa ke v0.4 tanpa perubahan API. |
| v0.2 — HTML statis selaras kode | Rilis | Obsolete | v0.2 | v0.3 Ganti: v0.3 | v0.2 | Ada di riwayat git (48b00e3). |
| v0.1 — HTML statis dari audit vilacation.com | Rilis | Obsolete | v0.1 | v0.2 Ganti: v0.2, lalu v0.3 | v0.1 | |
| Button | Komponen | Dipakai | v0.1 | — | — | Varian brand, outline, dan link ditambahkan di v0.2. Bentuk Svelte sejak v0.3. |
| IconButton | Komponen | Dipakai | v0.1 | — | — | Bentuk Svelte sejak v0.3. |
| Badge | Komponen | Dipakai | v0.1 | — | — | Varian soldout dan count ditambahkan di v0.2. Bentuk Svelte sejak v0.3. |
| Chip | Komponen | Dipakai | v0.1 | — | — | Bentuk Svelte sejak v0.3. |
| Alert | Komponen | Dipakai | v0.1 | — | — | Bentuk Svelte sejak v0.3. |
| Field | Komponen | Dipakai | v0.1 | — | — | Bentuk Svelte sejak v0.3. |
| Select | Komponen | Dipakai | v0.1 | — | — | Bentuk Svelte sejak v0.3. |
| SearchBar | Komponen | Dipakai | v0.1 | — | — | Bentuk Svelte sejak v0.3. |
| Header | Komponen | Dipakai | v0.1 | — | — | Tinggi 64px di mobile, 88px mulai 768px sejak v0.2. Bentuk Svelte sejak v0.3. |
| VillaCard | Komponen | Dipakai | v0.1 | — | — | Dirombak di v0.2 mengikuti home-property-card.tsx. Bentuk Svelte sejak v0.3. |
| VillaCardSkeleton | Komponen | Dipakai | v0.1 | — | — | Bentuk Svelte sejak v0.3. |
| Skeleton | Komponen | Dipakai | v0.1 | — | — | Bentuk Svelte sejak v0.3. |
| Stepper | Komponen | Dipakai | v0.1 | — | — | Bentuk Svelte sejak v0.3. |
| PriceSummary | Komponen | Dipakai | v0.1 | — | — | Bentuk Svelte sejak v0.3. |
| TabBar | Komponen | Dipakai | v0.1 | — | — | Pil mengambang sejak v0.2. Bentuk Svelte sejak v0.3. |
| StatusPanel | Komponen | Dipakai | v0.1 | — | — | Bentuk Svelte sejak v0.3. |
| DateRangeCalendar | Komponen | Dipakai | v0.1 | — | — | Bentuk Svelte sejak v0.3. |
| Modal | Komponen | Dipakai | v0.4 | — | — | Acuan: AuthDialog. Escape menutup, fokus dikembalikan, scroll halaman dikunci. |
| Drawer | Komponen | Dipakai | v0.4 | — | — | Acuan: SearchFilterDrawer. Penuh layar di mobile, panel 448px mulai 640px. |
| Toast | Komponen | Dipakai | v0.4 | — | — | Acuan: ToastContainer dan store toast. Store ikut dibundel: toasts.show({ type, title }). |
| Checkbox | Komponen | Dipakai | v0.4 | — | — | Ditambahkan di v0.4. |
| Switch | Komponen | Dipakai | v0.4 | — | — | Ditambahkan di v0.4. |
| Counter | Komponen | Dipakai | v0.4 | — | — | Acuan: pemilih jumlah tamu di SearchFilterDrawer. |
| Tabs | Komponen | Dipakai | v0.4 | — | — | Tab garis bawah untuk konten; navigasi utama tetap TabBar. |
| EmptyState | Komponen | Dipakai | v0.4 | — | — | Ditambahkan di v0.4. |
| PhotoGallery | Komponen | Dipakai | v0.5 | — | — | Acuan: PropertyGalleryDrawer. Kategori, foto utama, thumbnail. |
| MapFrame dan MapMarker | Komponen | Dipakai | v0.5 | — | — | Bingkai dan penanda harga; penyedia peta bebas. Penanda memakai teal-800 (lulus AA). |
| ErrorSummary | Komponen | Dipakai | v0.5 | — | — | Pola validasi form: ringkasan error dengan tautan ke field, bersama Field error. |
| Drawer dari bawah (bottom sheet) | Komponen | Dipakai | v0.5 | — | — | Prop side="bottom" pada Drawer. |
| Header dengan navigasi desktop | Komponen | Dipakai | v0.5 | — | — | Prop links mulai 768px. |
| Kartu villa: __badge, __dots, __dot, __meta | Komponen | Obsolete | v0.1 | v0.2 Ganti: __tag, __heart, __price-label | — | Struktur kartu lama; carousel dot dan rating tidak ada di spec mobile. |
| Tab bar penuh (bar menempel) | Komponen | Obsolete | v0.1 | v0.2 Ganti: TabBar (pil mengambang) | — | |
| Halaman HTML statis (index.html + JS vanilla) | Format | Obsolete | v0.1 | v0.3 Ganti: Docs SvelteKit | — | |
| Kelas vcd- dan vct- di kode frontend | Format | Obsolete | — | — Ganti: vc- / komponen kit | — | Obsolete menurut arah kit, tapi masih dipakai di produksi sampai migrasi dilakukan. |
| Penyedia dan lisensi tile peta | Rencana | Akan datang | — | — | — | Frontend memuat tile dari mt1.google.com langsung; perlu keputusan dev team. |
| Adopsi di frontend dan mobile | Rencana | Akan datang | — | — | — | Mengganti komponen lama bertahap. Belum dimulai; perlu keputusan dev team soal prefix dan urutan. |
Dipakai
Berlaku sekarang. Pakai ini untuk kode baru.
Obsolete
Sudah digantikan. Jangan dipakai di kode baru.
Akan datang
Usulan atau rencana. Belum dikerjakan, belum dijadwalkan.
Aturan: item Akan datang tidak punya tanggal sampai dijadwalkan. Obsolete tidak dihapus dari daftar supaya jejak penggantinya tetap ada. Kalau Foundation naik versi, persona yang kolom Foundation-nya masih lama belum menyusul. Ubah status dengan mengedit versions.ts dan naikkan versi di package.json saat ada rilis.