african-states-and-tribes 1.1.3 → 2.0.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.
Files changed (18) hide show
  1. package/README.md +114 -102
  2. package/african-states-and-tribes-1.1.3.tgz +0 -0
  3. package/dist/{AO-LQ4VRH4F.mjs → AO-KTWONNYZ.mjs} +1 -1
  4. package/dist/{BF-BZ7WXNF3.mjs → BF-O7TBSCCA.mjs} +2 -2
  5. package/dist/{CV-B7NIY45I.mjs → CV-UT67RQS3.mjs} +23 -23
  6. package/dist/{EG-S75L33PX.mjs → EG-SP5CNNNV.mjs} +34 -28
  7. package/dist/{MA-TSZB2KUC.mjs → MA-4JTQR5LC.mjs} +12 -12
  8. package/dist/NG-RETX6WJ4.mjs +1631 -0
  9. package/dist/{SN-6NZD3VMK.mjs → SN-KDIN2VHE.mjs} +10 -10
  10. package/dist/{TD-T6K52QM6.mjs → TD-LC3R4NYM.mjs} +22 -11
  11. package/dist/TN-KWXKNLDT.mjs +515 -0
  12. package/dist/index.d.mts +1002 -258
  13. package/dist/index.d.ts +1002 -258
  14. package/dist/index.js +2508 -317
  15. package/dist/index.mjs +794 -132
  16. package/package.json +7 -2
  17. package/dist/NG-6QW6RXJE.mjs +0 -382
  18. package/dist/TN-KZ7WMICO.mjs +0 -252
package/README.md CHANGED
@@ -1,6 +1,26 @@
1
1
  # African-states-and-tribes
2
2
 
3
- This project provides comprehensive insights into African countries, the origins of various tribes, and their geographic distributions. Built to celebrate and document Africa’s rich multicultural landscape, it allows users to explore the continent’s diverse cultural heritage, discovering the roots and locations of countless ethnic groups across Africa.
3
+ A lightweight zero-dependency JavaScript/TypeScript utility library for African countries and their corresponding states and tribes, dynamically loaded by country code. It provides structured access to comprehensive data on African countries and their administrative geography and ethnic groups.
4
+
5
+ The library includes country-level metadata (such as name, capital, currency, phone code, flag, and ISO codes), supports geographic hierarchies including local government areas (LGAs) and other administrative subdivisions across all countries, and offers detailed tribal distributions by region or state, as well as major ethnic group data per country.
6
+
7
+ <!-- A zero-dependency JavaScript library for structured access to African countries’ metadata, ethnic groups, and administrative divisions — including tribal distributions and local government areas. -->
8
+
9
+ <!-- african-countries-data -->
10
+
11
+
12
+ ## 🚀 Features
13
+
14
+ ✅ List all African countries
15
+
16
+ ✅ Fetch a single country by its ISO code
17
+
18
+ ✅ Get state/tribal data for each country (on-demand)
19
+
20
+ ✅ Lightweight and async — loads only what you need
21
+
22
+ ✅ Simple, modular, and TypeScript-friendly
23
+
4
24
 
5
25
  # Install
6
26
  `npm i african-states-and-tribes`
@@ -10,7 +30,13 @@ This project provides comprehensive insights into African countries, the origins
10
30
  - ES6 Module usage
11
31
 
12
32
  ```js
13
- import * as africanStates from 'african-states-and-tribes'
33
+ import {
34
+ getCountries,
35
+ getCountry,
36
+ getCountryStates,
37
+ getCountriesAndStates,
38
+ getCountryAndState
39
+ } from 'african-states-and-tribes'
14
40
  ```
15
41
 
16
42
  - ES5 Module usage
@@ -21,12 +47,12 @@ This project provides comprehensive insights into African countries, the origins
21
47
 
22
48
  # Docs
23
49
 
24
- - **Get all African Countries**
50
+ - **Get all Countries**
25
51
 
26
52
  ```js
27
- import * as africanStates from 'african-states-and-tribes'
53
+ import { getCountries } from 'african-states-and-tribes'
28
54
 
29
- africanStates.getCountries().then(countries =>{
55
+ getCountries().then(countries =>{
30
56
  console.log(countries)
31
57
  })
32
58
  ```
@@ -38,38 +64,60 @@ This project provides comprehensive insights into African countries, the origins
38
64
  {
39
65
  phoneCode: 244,
40
66
  capitalCity: "Luanda",
41
- colonialMaster:"",
42
- countryCode:"AO",
67
+ colonialMaster: [
68
+ {
69
+ name: "Portugal",
70
+ countryCode: "PT"
71
+ }
72
+ ],
73
+ countryCode: "AO",
43
74
  flagEmoji: "🇦🇴",
44
75
  name: "Angola",
45
76
  currency: "Angolan kwanza",
46
- currencyCode:"AOA",
47
- currencySymbol:"Kz",
77
+ currencyCode: "AOA",
78
+ currencySymbol: "Kz",
48
79
  officialLanguage: "Portuguese",
49
- majorEthnicGroups:["Bakongo", "Chokwe", "Herero", "Humbi", "Kimbundu", "Mbundu", "Ngangela", "Ovimbundu"]
80
+ majorEthnicGroups: ["Bakongo", "Mbundu", "Ovimbundu"],
81
+ timezones: [
82
+ {
83
+ iana: "Africa/Luanda",
84
+ gmtOffset: "+01:00"
85
+ }
86
+ ]
50
87
  },
51
88
  {
52
89
  phoneCode: 229,
53
90
  capitalCity: "Porto-Novo",
54
- colonialMaster:"",
55
- countryCode:"BJ",
91
+ colonialMaster: [
92
+ {
93
+ name: "France",
94
+ countryCode: "FR"
95
+ }
96
+ ],
97
+ countryCode: "BJ",
56
98
  flagEmoji: "🇧🇯",
57
99
  name: "Benin",
58
100
  currency: "West African CFA franc",
59
- currencyCode:"XOF",
60
- currencySymbol:"Fr",
101
+ currencyCode: "XOF",
102
+ currencySymbol: "Fr",
61
103
  officialLanguage: "French",
62
- majorEthnicGroups:["Adja (Aja)","Bariba","Dendi (Songhai)","Fon (Dahomey)","Fulani","Lukpa","Tammari (Betammaribe)","Yoruba"]
63
- },
104
+ majorEthnicGroups: ["Bariba", "Fon (Dahomey)", "Yoruba"],
105
+ timezones: [
106
+ {
107
+ iana: "Africa/Porto-Novo",
108
+ gmtOffset: "+01:00"
109
+ }
110
+ ]
111
+ }
64
112
  ...
65
113
  ]
66
114
  ```
67
- - **Get All African Countries + Tribal Data**
115
+ - **Get All African Countries + State/Tribal Data**
68
116
 
69
117
  ```js
70
- import * as africanStates from 'african-states-and-tribes'
118
+ import { getCountriesAndStates } from 'african-states-and-tribes'
71
119
 
72
- africanStates.getCountriesAndTribalData("NG").then(countries =>{
120
+ getCountriesAndStates().then(countries =>{
73
121
  console.log(countries)
74
122
  })
75
123
  ```
@@ -89,8 +137,8 @@ This project provides comprehensive insights into African countries, the origins
89
137
  currencyCode:"AOA",
90
138
  currencySymbol:"Kz",
91
139
  officialLanguage: "Portuguese",
92
- majorEthnicGroups:["Bakongo", "Chokwe", "Herero", "Humbi", "Kimbundu", "Mbundu", "Ngangela", "Ovimbundu"]
93
- tribalDistribution:[
140
+ majorEthnicGroups: ["Bakongo", "Mbundu", "Ovimbundu"],
141
+ states:[
94
142
  {
95
143
  capitalCity:"Caxito",
96
144
  subdivisions:["Ambriz", "Bula Atumba", "Dande", "Dembos","Nambuangongo", "Pango Aluquém"],
@@ -122,9 +170,9 @@ This project provides comprehensive insights into African countries, the origins
122
170
  - **Get Specific Country by CountryCode**
123
171
 
124
172
  ```js
125
- import * as africanStates from 'african-states-and-tribes'
173
+ import { getCountry } from 'african-states-and-tribes'
126
174
 
127
- africanStates.getCountry("NG").then(country =>{
175
+ getCountry("NG").then(country =>{
128
176
  console.log(country)
129
177
  })
130
178
 
@@ -136,7 +184,12 @@ This project provides comprehensive insights into African countries, the origins
136
184
  {
137
185
  phoneCode: 234,
138
186
  capitalCity: "Abuja",
139
- colonialMaster:"",
187
+ colonialMaster: [
188
+ {
189
+ name: "United Kingdom",
190
+ countryCode: "GB"
191
+ }
192
+ ],
140
193
  countryCode:"NG",
141
194
  flagEmoji: "🇳🇬",
142
195
  name: "Nigeria",
@@ -144,16 +197,22 @@ This project provides comprehensive insights into African countries, the origins
144
197
  currencyCode:"NGN",
145
198
  currencySymbol:"₦",
146
199
  officialLanguage: "English",
147
- majorEthnicGroups:["Fulani", "Hausa","Kanuri","Ibibio", "Igbo","Ijaw", "Tiv","Yoruba"]
200
+ majorEthnicGroups:["Fulani", "Hausa", "Igbo", "Yoruba"],
201
+ timezones: [
202
+ {
203
+ "iana": "Africa/Lagos",
204
+ "gmtOffset": "+01:00"
205
+ }
206
+ ]
148
207
  }
149
208
 
150
209
  ```
151
- - **Get Specific Country + Tribal Data by CountryCode**
210
+ - **Get Specific Country + State/Tribal Data by CountryCode**
152
211
 
153
212
  ```js
154
- import * as africanStates from 'african-states-and-tribes'
213
+ import { getCountryAndState } from 'african-states-and-tribes'
155
214
 
156
- africanStates.getCountryAndTribalData("NG").then(country =>{
215
+ getCountryAndState("NG").then(country =>{
157
216
  console.log(country)
158
217
  })
159
218
  ```
@@ -164,7 +223,12 @@ This project provides comprehensive insights into African countries, the origins
164
223
  {
165
224
  phoneCode: 234,
166
225
  capitalCity: "Abuja",
167
- colonialMaster:"",
226
+ colonialMaster: [
227
+ {
228
+ name: "United Kingdom",
229
+ countryCode: "GB"
230
+ }
231
+ ],
168
232
  countryCode:"NG",
169
233
  flagEmoji: "🇳🇬",
170
234
  name: "Nigeria",
@@ -172,8 +236,8 @@ This project provides comprehensive insights into African countries, the origins
172
236
  currencyCode:"NGN",
173
237
  currencySymbol:"₦",
174
238
  officialLanguage: "English",
175
- majorEthnicGroups:["Fulani", "Hausa","Kanuri","Ibibio", "Igbo","Ijaw", "Tiv","Yoruba"]
176
- tribalDistribution:[
239
+ majorEthnicGroups:["Fulani", "Hausa", "Igbo", "Yoruba"],
240
+ states:[
177
241
  {
178
242
  capitalCity:"Umuahia",
179
243
  subdivisions: ["Aba North", "Aba South", "Arochukwu", "Bende", "Ikwuano", "Isiala Ngwa North", "Isiala Ngwa South", "Isuikwuato", "Obi Ngwa", "Ohafia", "Osisioma", "Ugwunagbo", "Ukwa East", "Ukwa West", "Umuahia North", "Umuahia South"],
@@ -189,12 +253,12 @@ This project provides comprehensive insights into African countries, the origins
189
253
 
190
254
  ```
191
255
 
192
- - **Get a Country's Tribal Data Only**
256
+ - **Get a Country's State/Tribal Data Only**
193
257
 
194
258
  ```js
195
- import * as africanStates from 'african-states-and-tribes'
259
+ import { getCountryStates } from 'african-states-and-tribes'
196
260
 
197
- africanStates.getTribesByCountry("NG").then(tribes =>{
261
+ getCountryStates("NG").then(tribes =>{
198
262
  console.log(tribes)
199
263
  })
200
264
  ```
@@ -228,6 +292,12 @@ This project provides comprehensive insights into African countries, the origins
228
292
  ```
229
293
 
230
294
 
295
+ Notes
296
+ - All functions are asynchronous – you must use await or .then()
297
+
298
+ - Tribe/state data is dynamically imported using import() for performance
299
+
300
+
231
301
 
232
302
  | Key | Description
233
303
  |----------------------------------------|-----------------------------
@@ -241,74 +311,16 @@ This project provides comprehensive insights into African countries, the origins
241
311
  | currencySymbol | Country's official currency symbol
242
312
  | officialLanguage | Country's official language
243
313
  | majorEthnicGroups | Major ethnic found in the country
244
- | tribalDistribution | Array containing country's tribal origin grouped by state/region/province found in.
245
- | tribalDistribution.capitalCity | state/region/province capital city
246
- | tribalDistribution.subdivisions | state/region/province administrative sub divisions such as Local Government
247
- | tribalDistribution.geoPoliticalZone | Geopolitical zone in which the state/region/province falls under
248
- | tribalDistribution.location | state/region/province location on country's map
249
- | tribalDistribution.name | state/region/province
250
- | tribalDistribution.stateCode | state/region/province official code
251
- | tribalDistribution.tribes | Tribes found in state/region/province
252
- | tribalDistribution.type | type of either state/region/province
253
-
254
-
255
-
256
-
257
- # Countries Covered.
258
- - Angola
259
- - Algeria
260
- - Benin - Departments/Communes
261
- - Botswana
262
- - Burkina Faso
263
- - Burundi
264
- - Cabo Verde
265
- - Cameroon
266
- - Central African Republic
267
- - Chad
268
- - Comoros
269
- - Democratic Republic of the Congo
270
- - Republic of the Congo
271
- - Cote D'Ivoire
272
- - Djibouti
273
- - Egypt
274
- - Equatorial Guinea
275
- - Eritrea
276
- - Ethiopia
277
- - Gabon
278
- - Ghana
279
- - Gambia
280
- - Guinea
281
- - Guinea-Bissau
282
- - Kenya
283
- - Lesotho
284
- - Liberia
285
- - Libya
286
- - Madagascar
287
- - Malawi
288
- - Mali
289
- - Mauritania
290
- - Mauritius
291
- - Morocco
292
- - Mozambique
293
- - Namibia
294
- - Niger
295
- - Nigeria - States/Local Government
296
- - Rwanda
297
- - Sao Tome And Principe
298
- - Senegal
299
- - Seychelles
300
- - Sierra Leone
301
- - Somalia - Regions/Districts
302
- - South Africa
303
- - South Sudan
304
- - Sudan
305
- - Eswatini
306
- - Tanzania
307
- - Togo
308
- - Tunisia
309
- - Uganda
310
- - Zambia
311
- - Zimbabwe
314
+ | states | Array containing country's states/provinces/regions
315
+ | states.capitalCity | state/region/province capital city
316
+ | states.subdivisions | state/region/province administrative sub divisions such as Local Government
317
+ | states.geoPoliticalZone | Geopolitical zone in which the state/region/province falls under
318
+ | states.location | state/region/province location on country's map
319
+ | states.name | state/region/province
320
+ | states.stateCode | state/region/province official code
321
+ | states.tribes | Tribes found in state/region/province
322
+ | states.type | type of either state/region/province
323
+
312
324
 
313
325
  # Data Sources
314
326
  - https://www.vanguardngr.com/2017/05/full-list-of-all-371-tribes-in-nigeria-states-where-they-originate/
package/dist/{AO-LQ4VRH4F.mjs → AO-KTWONNYZ.mjs} RENAMED
@@ -79,7 +79,7 @@ var AO = {
79
79
  location: "South",
80
80
  name: "Cunene",
81
81
  stateCode: "CNN",
82
- tribes: ["Herero", "Kwanyama", "Nyaneka-Nkhumbi", "Ovambo (Ovimbundu)"],
82
+ tribes: ["Herero", "Kwanyama", "Nyaneka-Nkhumbi", "Ovimbundu"],
83
83
  type: "province"
84
84
  },
85
85
  HUAMBO: {
package/dist/{BF-BZ7WXNF3.mjs → BF-O7TBSCCA.mjs} RENAMED
@@ -9,7 +9,7 @@ var BF = {
9
9
  location: "North West",
10
10
  name: "Boucle du Mouhoun",
11
11
  stateCode: "BM",
12
- tribes: ["Mossi", "Gourmantch\xE9", "Bobo"],
12
+ tribes: ["Bobo", "Gourmantch\xE9", "Mossi"],
13
13
  type: "region"
14
14
  },
15
15
  CASCADES: {
@@ -19,7 +19,7 @@ var BF = {
19
19
  location: "South West",
20
20
  name: "Cascades",
21
21
  stateCode: "CA",
22
- tribes: ["Bobo", "Mossi", "Gourmantch\xE9"],
22
+ tribes: ["Bobo", "Gourmantch\xE9", "Mossi"],
23
23
  type: "region"
24
24
  },
25
25
  CENTRE: {
package/dist/{CV-B7NIY45I.mjs → CV-UT67RQS3.mjs} RENAMED
@@ -9,7 +9,7 @@ var CV = {
9
9
  location: "North",
10
10
  name: "Boa Vista",
11
11
  stateCode: "BV",
12
- tribes: ["Cape Verdean"],
12
+ tribes: ["Creole"],
13
13
  type: "municipality"
14
14
  },
15
15
  BRAVA: {
@@ -19,7 +19,7 @@ var CV = {
19
19
  location: "South",
20
20
  name: "Brava",
21
21
  stateCode: "BR",
22
- tribes: ["Cape Verdean"],
22
+ tribes: ["Creole"],
23
23
  type: "municipality"
24
24
  },
25
25
  "CH\xC3O BOM": {
@@ -29,7 +29,7 @@ var CV = {
29
29
  location: "North",
30
30
  name: "Ch\xE3o Bom",
31
31
  stateCode: "CB",
32
- tribes: ["Cape Verdean"],
32
+ tribes: ["Creole"],
33
33
  type: "municipality"
34
34
  },
35
35
  CONCEI\u00C7\u00C3O: {
@@ -39,7 +39,7 @@ var CV = {
39
39
  location: "North",
40
40
  name: "Concei\xE7\xE3o",
41
41
  stateCode: "CE",
42
- tribes: ["Cape Verdean"],
42
+ tribes: ["Creole"],
43
43
  type: "municipality"
44
44
  },
45
45
  FOGO: {
@@ -49,7 +49,7 @@ var CV = {
49
49
  location: "South",
50
50
  name: "Fogo",
51
51
  stateCode: "FO",
52
- tribes: ["Cape Verdean"],
52
+ tribes: ["Creole"],
53
53
  type: "municipality"
54
54
  },
55
55
  MAIO: {
@@ -59,7 +59,7 @@ var CV = {
59
59
  location: "South",
60
60
  name: "Maio",
61
61
  stateCode: "MA",
62
- tribes: ["Cape Verdean"],
62
+ tribes: ["Creole"],
63
63
  type: "municipality"
64
64
  },
65
65
  PAUL: {
@@ -69,7 +69,7 @@ var CV = {
69
69
  location: "North West",
70
70
  name: "Paul",
71
71
  stateCode: "PA",
72
- tribes: ["Cape Verdean"],
72
+ tribes: ["Creole"],
73
73
  type: "municipality"
74
74
  },
75
75
  PRAIA: {
@@ -79,7 +79,7 @@ var CV = {
79
79
  location: "South",
80
80
  name: "Praia",
81
81
  stateCode: "PR",
82
- tribes: ["Cape Verdean"],
82
+ tribes: ["Creole"],
83
83
  type: "municipality"
84
84
  },
85
85
  "RIBEIRA GRANDE": {
@@ -89,7 +89,7 @@ var CV = {
89
89
  location: "North West",
90
90
  name: "Ribeira Grande",
91
91
  stateCode: "RG",
92
- tribes: ["Cape Verdean"],
92
+ tribes: ["Creole"],
93
93
  type: "municipality"
94
94
  },
95
95
  "RIBEIRA GRANDE DE SANTIAGO": {
@@ -99,7 +99,7 @@ var CV = {
99
99
  location: "South",
100
100
  name: "Ribeira Grande de Santiago",
101
101
  stateCode: "RG",
102
- tribes: ["Cape Verdean"],
102
+ tribes: ["Creole"],
103
103
  type: "municipality"
104
104
  },
105
105
  "RIBEIRA PRATA": {
@@ -109,7 +109,7 @@ var CV = {
109
109
  location: "North",
110
110
  name: "Ribeira Prata",
111
111
  stateCode: "RP",
112
- tribes: ["Cape Verdean"],
112
+ tribes: ["Creole"],
113
113
  type: "municipality"
114
114
  },
115
115
  "SANTA CATARINA": {
@@ -119,7 +119,7 @@ var CV = {
119
119
  location: "South",
120
120
  name: "Santa Catarina",
121
121
  stateCode: "SC",
122
- tribes: ["Cape Verdean"],
122
+ tribes: ["Creole"],
123
123
  type: "municipality"
124
124
  },
125
125
  "SANTA CRUZ": {
@@ -129,7 +129,7 @@ var CV = {
129
129
  location: "South",
130
130
  name: "Santa Cruz",
131
131
  stateCode: "SC",
132
- tribes: ["Cape Verdean"],
132
+ tribes: ["Creole"],
133
133
  type: "municipality"
134
134
  },
135
135
  "SANTO ANT\xC3O": {
@@ -139,7 +139,7 @@ var CV = {
139
139
  location: "North West",
140
140
  name: "Santo Ant\xE3o",
141
141
  stateCode: "SA",
142
- tribes: ["Cape Verdean"],
142
+ tribes: ["Creole"],
143
143
  type: "municipality"
144
144
  },
145
145
  "SANTO MIGUEL": {
@@ -149,7 +149,7 @@ var CV = {
149
149
  location: "North East",
150
150
  name: "Santo Miguel",
151
151
  stateCode: "SM",
152
- tribes: ["Cape Verdean"],
152
+ tribes: ["Creole"],
153
153
  type: "municipality"
154
154
  },
155
155
  "S\xC3O DOMINGOS": {
@@ -159,7 +159,7 @@ var CV = {
159
159
  location: "South",
160
160
  name: "S\xE3o Domingos",
161
161
  stateCode: "SD",
162
- tribes: ["Cape Verdean"],
162
+ tribes: ["Creole"],
163
163
  type: "municipality"
164
164
  },
165
165
  "S\xC3O FILIPE": {
@@ -169,7 +169,7 @@ var CV = {
169
169
  location: "South",
170
170
  name: "S\xE3o Filipe",
171
171
  stateCode: "SF",
172
- tribes: ["Cape Verdean"],
172
+ tribes: ["Creole"],
173
173
  type: "municipality"
174
174
  },
175
175
  "S\xC3O NICOLAU": {
@@ -179,7 +179,7 @@ var CV = {
179
179
  location: "North",
180
180
  name: "S\xE3o Nicolau",
181
181
  stateCode: "SN",
182
- tribes: ["Cape Verdean"],
182
+ tribes: ["Creole"],
183
183
  type: "municipality"
184
184
  },
185
185
  "S\xC3O VICTOR": {
@@ -189,7 +189,7 @@ var CV = {
189
189
  location: "North",
190
190
  name: "S\xE3o Victor",
191
191
  stateCode: "SV",
192
- tribes: ["Cape Verdean"],
192
+ tribes: ["Creole"],
193
193
  type: "municipality"
194
194
  },
195
195
  "S\xC3O VICENTE": {
@@ -199,7 +199,7 @@ var CV = {
199
199
  location: "North",
200
200
  name: "S\xE3o Vicente",
201
201
  stateCode: "SV",
202
- tribes: ["Cape Verdean"],
202
+ tribes: ["Creole"],
203
203
  type: "municipality"
204
204
  },
205
205
  TARFAYA: {
@@ -209,7 +209,7 @@ var CV = {
209
209
  location: "North",
210
210
  name: "Tarfaya",
211
211
  stateCode: "TA",
212
- tribes: ["Cape Verdean"],
212
+ tribes: ["Creole"],
213
213
  type: "municipality"
214
214
  },
215
215
  TAVARES: {
@@ -219,7 +219,7 @@ var CV = {
219
219
  location: "North",
220
220
  name: "Tavares",
221
221
  stateCode: "TA",
222
- tribes: ["Cape Verdean"],
222
+ tribes: ["Creole"],
223
223
  type: "municipality"
224
224
  },
225
225
  TOMBO: {
@@ -229,7 +229,7 @@ var CV = {
229
229
  location: "North",
230
230
  name: "Tombo",
231
231
  stateCode: "TO",
232
- tribes: ["Cape Verdean"],
232
+ tribes: ["Creole"],
233
233
  type: "municipality"
234
234
  }
235
235
  };