@id-region-data/data 1.1.1 → 1.3.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 -11
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,14 +1,12 @@
|
|
|
1
1
|
# @id-region-data/data
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/@id-region-data/data)
|
|
4
|
-
[](https://github.com/id-region-data/id-region-data/blob/master/LICENSE)
|
|
5
|
-
[](https://bundlephobia.com/package/@id-region-data/data)
|
|
6
4
|
|
|
7
5
|
High-performance, ultra-lightweight Indonesian region data (Provinces, Regencies, Districts, Villages) optimized for modern web applications.
|
|
8
6
|
|
|
9
|
-
##
|
|
7
|
+
## Why this package?
|
|
10
8
|
|
|
11
|
-
Most Indonesian region packages are
|
|
9
|
+
Most Indonesian region packages are monolithic, forcing users to download a 24MB+ JSON file just to pick a single village. This causes massive frontend bundle bloat and slow page loads.
|
|
12
10
|
|
|
13
11
|
**@id-region-data/data** solves this by using **Dynamic Chunking**:
|
|
14
12
|
- **0MB Initial Load**: The core library is almost weightless.
|
|
@@ -19,7 +17,7 @@ Most Indonesian region packages are **monolithic**, forcing users to download a
|
|
|
19
17
|
|
|
20
18
|
---
|
|
21
19
|
|
|
22
|
-
##
|
|
20
|
+
## Installation
|
|
23
21
|
|
|
24
22
|
```bash
|
|
25
23
|
npm install @id-region-data/data
|
|
@@ -27,7 +25,7 @@ npm install @id-region-data/data
|
|
|
27
25
|
|
|
28
26
|
---
|
|
29
27
|
|
|
30
|
-
##
|
|
28
|
+
## Usage
|
|
31
29
|
|
|
32
30
|
All functions are asynchronous and return a `Promise`. Data is only downloaded when a function is called for a specific parent code.
|
|
33
31
|
|
|
@@ -62,7 +60,7 @@ const villages = await getVillagesByDistrict('3273100'); // Arcamanik
|
|
|
62
60
|
|
|
63
61
|
---
|
|
64
62
|
|
|
65
|
-
##
|
|
63
|
+
## Data Interfaces
|
|
66
64
|
|
|
67
65
|
Strict TypeScript interfaces are exported for your convenience:
|
|
68
66
|
|
|
@@ -72,7 +70,7 @@ import type { Province, Regency, District, Village } from '@id-region-data/data'
|
|
|
72
70
|
|
|
73
71
|
---
|
|
74
72
|
|
|
75
|
-
##
|
|
73
|
+
## Performance Deep Dive
|
|
76
74
|
|
|
77
75
|
This library splits the Indonesian hierarchy into **23,531 small JSON chunks**.
|
|
78
76
|
|
|
@@ -87,8 +85,8 @@ Instead of downloading **24MB**, your user's browser only downloads roughly **10
|
|
|
87
85
|
|
|
88
86
|
---
|
|
89
87
|
|
|
90
|
-
##
|
|
91
|
-
Data is parsed and verified from the authoritative [cahyadsn/wilayah](https://github.com/cahyadsn/wilayah) repository, ensuring compliance with the latest
|
|
88
|
+
## Source Data
|
|
89
|
+
Data is parsed and verified from the authoritative [cahyadsn/wilayah](https://github.com/cahyadsn/wilayah) repository, ensuring compliance with the latest **Kepmendagri 2025** regional codes (38 Provinces, 83,345 Villages).
|
|
92
90
|
|
|
93
|
-
##
|
|
91
|
+
## License
|
|
94
92
|
MIT © [id-region-data](https://www.npmjs.com/org/id-region-data)
|
package/package.json
CHANGED