@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
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
type KabKotaJenis = "kabupaten" | "kota";
|
|
2
|
+
interface ProvinsiInfo {
|
|
3
|
+
readonly kode: string;
|
|
4
|
+
readonly nama: string;
|
|
5
|
+
}
|
|
6
|
+
interface KabKotaInfo {
|
|
7
|
+
readonly kode: string;
|
|
8
|
+
readonly provinsiKode: string;
|
|
9
|
+
readonly nama: string;
|
|
10
|
+
readonly jenis: KabKotaJenis;
|
|
11
|
+
}
|
|
12
|
+
interface CariWilayahOptions {
|
|
13
|
+
/** Batas maksimum jumlah hasil yang dikembalikan. Default: `20`. */
|
|
14
|
+
batas?: number;
|
|
15
|
+
}
|
|
16
|
+
type WilayahSearchItem = {
|
|
17
|
+
readonly tingkat: "provinsi";
|
|
18
|
+
readonly kode: string;
|
|
19
|
+
readonly nama: string;
|
|
20
|
+
} | {
|
|
21
|
+
readonly tingkat: KabKotaJenis;
|
|
22
|
+
readonly kode: string;
|
|
23
|
+
readonly provinsiKode: string;
|
|
24
|
+
readonly nama: string;
|
|
25
|
+
};
|
|
26
|
+
/**
|
|
27
|
+
* Mencari provinsi berdasarkan kode wilayah Kemendagri 2 digit (contoh: `"31"`).
|
|
28
|
+
*
|
|
29
|
+
* Spasi di awal/akhir di-trim terlebih dahulu. Mengembalikan `null` jika format bukan 2 digit atau
|
|
30
|
+
* kode tidak ditemukan. Data terakhir diverifikasi 2026-11-18 dan tidak mencakup kode wilayah BPS.
|
|
31
|
+
*/
|
|
32
|
+
declare function getProvinsi(kode: string): ProvinsiInfo | null;
|
|
33
|
+
/**
|
|
34
|
+
* Mengembalikan salinan daftar seluruh 38 provinsi di Indonesia (kode wilayah Kemendagri).
|
|
35
|
+
*/
|
|
36
|
+
declare function listProvinsi(): ProvinsiInfo[];
|
|
37
|
+
/**
|
|
38
|
+
* Mencari kabupaten/kota berdasarkan kode wilayah Kemendagri (`"31.71"`) atau 4 digit rapat (`"3171"`).
|
|
39
|
+
*
|
|
40
|
+
* Kode dinormalkan ke format `"PP.KK"`. Mengembalikan `null` jika tidak ditemukan atau format tidak sesuai.
|
|
41
|
+
* Data terakhir diverifikasi 2026-11-18 (514 kabupaten/kota); belum mencakup kecamatan dan kelurahan/desa.
|
|
42
|
+
*/
|
|
43
|
+
declare function getKabKota(kode: string): KabKotaInfo | null;
|
|
44
|
+
/**
|
|
45
|
+
* Mengembalikan daftar kabupaten/kota di Indonesia, atau difilter berdasarkan `provinsiKode` 2 digit.
|
|
46
|
+
*
|
|
47
|
+
* Jika `provinsiKode` tidak ditemukan, mengembalikan array kosong `[]`.
|
|
48
|
+
*/
|
|
49
|
+
declare function listKabKota(provinsiKode?: string): KabKotaInfo[];
|
|
50
|
+
/**
|
|
51
|
+
* Mencari provinsi dan kabupaten/kota berdasarkan potongan nama (case-insensitive).
|
|
52
|
+
*
|
|
53
|
+
* Query kosong menghasilkan `[]`. Default maksimum `20` hasil (dapat diatur via `options.batas`).
|
|
54
|
+
*/
|
|
55
|
+
declare function cariWilayah(query: string, options?: CariWilayahOptions): WilayahSearchItem[];
|
|
56
|
+
|
|
57
|
+
export { type CariWilayahOptions, type KabKotaInfo, type KabKotaJenis, type ProvinsiInfo, type WilayahSearchItem, cariWilayah, getKabKota, getProvinsi, listKabKota, listProvinsi };
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
type KabKotaJenis = "kabupaten" | "kota";
|
|
2
|
+
interface ProvinsiInfo {
|
|
3
|
+
readonly kode: string;
|
|
4
|
+
readonly nama: string;
|
|
5
|
+
}
|
|
6
|
+
interface KabKotaInfo {
|
|
7
|
+
readonly kode: string;
|
|
8
|
+
readonly provinsiKode: string;
|
|
9
|
+
readonly nama: string;
|
|
10
|
+
readonly jenis: KabKotaJenis;
|
|
11
|
+
}
|
|
12
|
+
interface CariWilayahOptions {
|
|
13
|
+
/** Batas maksimum jumlah hasil yang dikembalikan. Default: `20`. */
|
|
14
|
+
batas?: number;
|
|
15
|
+
}
|
|
16
|
+
type WilayahSearchItem = {
|
|
17
|
+
readonly tingkat: "provinsi";
|
|
18
|
+
readonly kode: string;
|
|
19
|
+
readonly nama: string;
|
|
20
|
+
} | {
|
|
21
|
+
readonly tingkat: KabKotaJenis;
|
|
22
|
+
readonly kode: string;
|
|
23
|
+
readonly provinsiKode: string;
|
|
24
|
+
readonly nama: string;
|
|
25
|
+
};
|
|
26
|
+
/**
|
|
27
|
+
* Mencari provinsi berdasarkan kode wilayah Kemendagri 2 digit (contoh: `"31"`).
|
|
28
|
+
*
|
|
29
|
+
* Spasi di awal/akhir di-trim terlebih dahulu. Mengembalikan `null` jika format bukan 2 digit atau
|
|
30
|
+
* kode tidak ditemukan. Data terakhir diverifikasi 2026-11-18 dan tidak mencakup kode wilayah BPS.
|
|
31
|
+
*/
|
|
32
|
+
declare function getProvinsi(kode: string): ProvinsiInfo | null;
|
|
33
|
+
/**
|
|
34
|
+
* Mengembalikan salinan daftar seluruh 38 provinsi di Indonesia (kode wilayah Kemendagri).
|
|
35
|
+
*/
|
|
36
|
+
declare function listProvinsi(): ProvinsiInfo[];
|
|
37
|
+
/**
|
|
38
|
+
* Mencari kabupaten/kota berdasarkan kode wilayah Kemendagri (`"31.71"`) atau 4 digit rapat (`"3171"`).
|
|
39
|
+
*
|
|
40
|
+
* Kode dinormalkan ke format `"PP.KK"`. Mengembalikan `null` jika tidak ditemukan atau format tidak sesuai.
|
|
41
|
+
* Data terakhir diverifikasi 2026-11-18 (514 kabupaten/kota); belum mencakup kecamatan dan kelurahan/desa.
|
|
42
|
+
*/
|
|
43
|
+
declare function getKabKota(kode: string): KabKotaInfo | null;
|
|
44
|
+
/**
|
|
45
|
+
* Mengembalikan daftar kabupaten/kota di Indonesia, atau difilter berdasarkan `provinsiKode` 2 digit.
|
|
46
|
+
*
|
|
47
|
+
* Jika `provinsiKode` tidak ditemukan, mengembalikan array kosong `[]`.
|
|
48
|
+
*/
|
|
49
|
+
declare function listKabKota(provinsiKode?: string): KabKotaInfo[];
|
|
50
|
+
/**
|
|
51
|
+
* Mencari provinsi dan kabupaten/kota berdasarkan potongan nama (case-insensitive).
|
|
52
|
+
*
|
|
53
|
+
* Query kosong menghasilkan `[]`. Default maksimum `20` hasil (dapat diatur via `options.batas`).
|
|
54
|
+
*/
|
|
55
|
+
declare function cariWilayah(query: string, options?: CariWilayahOptions): WilayahSearchItem[];
|
|
56
|
+
|
|
57
|
+
export { type CariWilayahOptions, type KabKotaInfo, type KabKotaJenis, type ProvinsiInfo, type WilayahSearchItem, cariWilayah, getKabKota, getProvinsi, listKabKota, listProvinsi };
|
package/dist/wilayah.js
ADDED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ghifari29/id-kit",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.8.0",
|
|
4
4
|
"description": "Utilitas Indonesia: terbilang, rupiah, nomor telepon, dan lainnya",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"sideEffects": false,
|
|
@@ -55,6 +55,11 @@
|
|
|
55
55
|
"types": "./dist/waktu.d.ts",
|
|
56
56
|
"import": "./dist/waktu.js",
|
|
57
57
|
"require": "./dist/waktu.cjs"
|
|
58
|
+
},
|
|
59
|
+
"./wilayah": {
|
|
60
|
+
"types": "./dist/wilayah.d.ts",
|
|
61
|
+
"import": "./dist/wilayah.js",
|
|
62
|
+
"require": "./dist/wilayah.cjs"
|
|
58
63
|
}
|
|
59
64
|
},
|
|
60
65
|
"scripts": {
|