@ghifari29/id-kit 0.7.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +9 -1
- package/dist/chunk-MY5YI3G5.js +2340 -0
- package/dist/index.cjs +2343 -0
- package/dist/index.d.cts +1 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.js +12 -0
- package/dist/wilayah.cjs +2370 -0
- package/dist/wilayah.d.cts +57 -0
- package/dist/wilayah.d.ts +57 -0
- package/dist/wilayah.js +14 -0
- package/package.json +6 -1
package/README.md
CHANGED
|
@@ -23,6 +23,7 @@ import { parseNPWP, parseNITKU, isValidNPWP, isValidNITKU } from "@ghifari29/id-
|
|
|
23
23
|
import { getBank, listBank } from "@ghifari29/id-kit/bank";
|
|
24
24
|
import { cekLibur, daftarLibur, tahunTersedia } from "@ghifari29/id-kit/libur";
|
|
25
25
|
import { formatTanggal, formatWaktu, formatTanggalWaktu, keZonaWaktu, zonaWaktuProvinsi } from "@ghifari29/id-kit/waktu";
|
|
26
|
+
import { getProvinsi, listProvinsi, getKabKota, listKabKota, cariWilayah } from "@ghifari29/id-kit/wilayah";
|
|
26
27
|
|
|
27
28
|
terbilang(1250000);
|
|
28
29
|
// "satu juta dua ratus lima puluh ribu rupiah"
|
|
@@ -80,6 +81,12 @@ formatTanggalWaktu("2026-11-18T13:35:00Z", { zona: "WITA" });
|
|
|
80
81
|
|
|
81
82
|
zonaWaktuProvinsi("64");
|
|
82
83
|
// "WITA"
|
|
84
|
+
|
|
85
|
+
getKabKota("3171");
|
|
86
|
+
// { kode: "31.71", provinsiKode: "31", nama: "Kota Administrasi Jakarta Pusat", jenis: "kota" }
|
|
87
|
+
|
|
88
|
+
cariWilayah("sorong");
|
|
89
|
+
// [{ tingkat: "kabupaten", kode: "96.01", ... }, { tingkat: "kabupaten", kode: "96.02", ... }, { tingkat: "kota", kode: "96.71", ... }]
|
|
83
90
|
```
|
|
84
91
|
|
|
85
92
|
## Fitur
|
|
@@ -93,7 +100,7 @@ zonaWaktuProvinsi("64");
|
|
|
93
100
|
- [x] `getBank`, `listBank` (daftar kode bank 3 digit)
|
|
94
101
|
- [x] `cekLibur`, `daftarLibur`, `tahunTersedia` (libur nasional dan cuti bersama)
|
|
95
102
|
- [x] `formatTanggal`, `formatWaktu`, `formatTanggalWaktu`, `keZonaWaktu`, `zonaWaktuProvinsi` (format & zona waktu Indonesia)
|
|
96
|
-
- [
|
|
103
|
+
- [x] `getProvinsi`, `listProvinsi`, `getKabKota`, `listKabKota`, `cariWilayah` (data 38 provinsi dan 514 kabupaten/kota)
|
|
97
104
|
|
|
98
105
|
## Batasan
|
|
99
106
|
|
|
@@ -106,6 +113,7 @@ zonaWaktuProvinsi("64");
|
|
|
106
113
|
- Modul `bank` (`getBank`, `listBank`) diverifikasi pada `2026-11-18` dari sumber sekunder (jaringan switching dan situs bank) karena Bank Indonesia tidak menerbitkan satu tabel terbuka untuk semua kode 3 digit. Daftar bisa usang akibat perubahan nama atau merger—cocokkan dengan sumber resmi bank sebelum dipakai untuk transaksi. Tidak ada validasi panjang nomor rekening, dengan sengaja.
|
|
107
114
|
- Modul `libur` (`cekLibur`, `daftarLibur`, `tahunTersedia`) diverifikasi pada `2026-11-18` dari SKB 3 Menteri (Kemenag, Kemnaker, KemenPAN-RB). SKB dapat direvisi di tengah tahun (contoh: pada 2025, satu hari cuti bersama ditambahkan pada Agustus), sehingga data bisa kedaluwarsa dan library membutuhkan rilis baru tiap tahun untuk menambah data tahun berikutnya. Tahun tanpa data menghasilkan `"data-tidak-tersedia"`, bukan `"bukan-libur"`. Ini bukan nasihat hukum mengenai hak cuti atau upah lembur, dan hari libur lokal atau daerah tidak termasuk.
|
|
108
115
|
- Modul `waktu` menolak string ISO tanpa zona waktu eksplisit agar tidak bergantung pada zona waktu mesin lokal (`YYYY-MM-DD` hanya diterima pada `formatTanggal`). Konversi memakai offset tetap (`WIB` `+07:00`, `WITA` `+08:00`, `WIT` `+09:00`) tanpa DST. `zonaWaktuProvinsi` menggunakan 38 kode provinsi Kemendagri (`11`–`96`) agar konsisten dengan modul `nik`, bukan kode wilayah kerja statistik BPS yang berbeda di wilayah Papua.
|
|
116
|
+
- Modul `wilayah` berisi data 38 provinsi dan 514 kabupaten/kota berdasarkan kode wilayah Kemendagri (terakhir diverifikasi `2026-11-18`; penamaan provinsi `31` dan `34` diseragamkan menjadi `"DKI Jakarta"` dan `"DI Yogyakarta"` agar konsisten dengan modul `nik`). Kecamatan, kelurahan/desa, serta kode wilayah kerja statistik BPS tidak disertakan, dan data dapat berubah bila terjadi pemekaran wilayah baru.
|
|
109
117
|
|
|
110
118
|
## Berkontribusi
|
|
111
119
|
|