pak-geodata 0.2.1 → 0.4.0

package/README.md

@@ -2,9 +2,9 @@
 
 > Comprehensive, typed, offline geographic data for all areas and cities in Pakistan.
 
-`pak-geodata` is an open-source, production-grade TypeScript and JavaScript client library providing offline access to verified geographic data for Pakistan, created and maintained by [Sohaib Bin Mohsin](https://sohaibbinmohsin.com) at [The Mohsin Project Global](https://themohsinproject.org).
+`pak-geodata` is an open-source, production-grade TypeScript and JavaScript client library providing offline access to verified geographic data for Pakistan.
 
-It covers all administrative provinces, 79 major and secondary cities, and 189 foundational flagship metropolitan areas (sectors, housing schemes, neighborhoods, and commercial centers).
+It covers all administrative provinces, 79 major and secondary cities, and 812 foundational metropolitan and regional areas across 42 cities.
 
 Designed with **zero runtime dependencies**, strict geofencing, sub-millisecond lookups, and modular tree-shakeable subpath exports.
 
@@ -91,7 +91,7 @@ for (const area of lahoreAreas.slice(0, 5)) {
 
 // Total verified areas in Pakistan
 const allAreas = getAllAreas();
-console.log(`Total verified areas: ${allAreas.length}`); // 189
+console.log(`Total verified areas: ${allAreas.length}`); // 812
 ```
 
 ### 3. Modular Subpath Imports (Tree-Shaking)
@@ -106,11 +106,16 @@ import { lahoreAreas } from 'pak-geodata/areas/lahore';
 import { karachiAreas } from 'pak-geodata/areas/karachi';
 
 // Available subpaths:
-// pak-geodata/areas/lahore
 // pak-geodata/areas/karachi
+// pak-geodata/areas/lahore
 // pak-geodata/areas/islamabad
 // pak-geodata/areas/rawalpindi
 // pak-geodata/areas/faisalabad
+// pak-geodata/areas/gujranwala
+// pak-geodata/areas/multan
+// pak-geodata/areas/hyderabad
+// pak-geodata/areas/peshawar
+// pak-geodata/areas/quetta
 ```
 
 ### 4. Intelligent Search
@@ -691,6 +696,20 @@ interface PakistanProvince {
 
 ---
 
+## About The Mohsin Project
+
+> **Free software for those who do good.**
+
+`pak-geodata` is an open-source public good engineered and maintained by **[The Mohsin Project](https://themohsinproject.org)**.
+
+The Mohsin Project exists because purpose-driven organizations and emergency teams lose momentum to outdated systems, expensive proprietary APIs, and scarce technical resources. We design, engineer, and deploy centralized digital solutions entirely free of cost so that nonprofits, humanitarian initiatives, and civic developers can focus on their mission.
+
+- 💬 **Get in Touch**: [hello@themohsinproject.org](mailto:hello@themohsinproject.org)
+
+---
+
 ## License
 
-MIT © 2026 [Sohaib Bin Mohsin](https://sohaibbinmohsin.com) • [The Mohsin Project Global](https://themohsinproject.org)
+This project is open-source software licensed under the [MIT License](LICENSE).
+
+Copyright (c) 2026 [The Mohsin Project Global](https://themohsinproject.org)

package/dist/areas/abbottabad.cjs

@@ -0,0 +1,290 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/areas/abbottabad.ts
+var abbottabad_exports = {};
+__export(abbottabad_exports, {
+  abbottabadAreas: () => abbottabadAreas
+});
+module.exports = __toCommonJS(abbottabad_exports);
+
+// src/data/areas/abbottabad.ts
+var abbottabadAreas = [
+  {
+    "id": "abbottabad-cantt",
+    "cityId": "abbottabad",
+    "provinceId": "kpk",
+    "name": "Abbottabad Cantonment",
+    "urduName": "\u0627\u06CC\u0628\u0679 \u0622\u0628\u0627\u062F \u06A9\u06CC\u0646\u0679",
+    "aliases": [
+      "Abbottabad Cantt",
+      "Cantt Abbottabad"
+    ],
+    "postalCode": "22010",
+    "coordinates": {
+      "lat": 34.152,
+      "lng": 73.218
+    },
+    "type": "administrative",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "abbottabad-mandian",
+    "cityId": "abbottabad",
+    "provinceId": "kpk",
+    "name": "Mandian",
+    "urduName": "\u0645\u0646\u062F\u06CC\u0627\u0646 \u0627\u06CC\u0628\u0679 \u0622\u0628\u0627\u062F",
+    "aliases": [
+      "Mandian Chowk",
+      "Ayub Medical Complex Area"
+    ],
+    "postalCode": "22010",
+    "coordinates": {
+      "lat": 34.195,
+      "lng": 73.238
+    },
+    "type": "neighborhood",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "abbottabad-supply",
+    "cityId": "abbottabad",
+    "provinceId": "kpk",
+    "name": "Supply Area",
+    "urduName": "\u0633\u067E\u0644\u0627\u0626\u06CC \u0627\u06CC\u0631\u06CC\u0627 \u0627\u06CC\u0628\u0679 \u0622\u0628\u0627\u062F",
+    "aliases": [
+      "Supply Bazaar Abbottabad"
+    ],
+    "postalCode": "22010",
+    "coordinates": {
+      "lat": 34.168,
+      "lng": 73.225
+    },
+    "type": "commercial",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "abbottabad-pma-kakul",
+    "cityId": "abbottabad",
+    "provinceId": "kpk",
+    "name": "PMA Kakul Area",
+    "urduName": "\u067E\u06CC \u0627\u06CC\u0645 \u0627\u06D2 \u06A9\u0627\u06A9\u0648\u0644",
+    "aliases": [
+      "Pakistan Military Academy Kakul",
+      "Kakul"
+    ],
+    "postalCode": "22010",
+    "coordinates": {
+      "lat": 34.185,
+      "lng": 73.258
+    },
+    "type": "administrative",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "abbottabad-jadoon-phase-1",
+    "cityId": "abbottabad",
+    "provinceId": "kpk",
+    "name": "Jadoon Phase 1",
+    "urduName": "\u062C\u062F\u0648\u0646 \u0641\u06CC\u0632 1 \u0627\u06CC\u0628\u0679 \u0622\u0628\u0627\u062F",
+    "aliases": [
+      "Jadoon Plaza Phase 1",
+      "Jadoon Colony 1"
+    ],
+    "postalCode": "22010",
+    "coordinates": {
+      "lat": 34.175,
+      "lng": 73.235
+    },
+    "type": "housing_society",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "abbottabad-jadoon-phase-2",
+    "cityId": "abbottabad",
+    "provinceId": "kpk",
+    "name": "Jadoon Phase 2",
+    "urduName": "\u062C\u062F\u0648\u0646 \u0641\u06CC\u0632 2 \u0627\u06CC\u0628\u0679 \u0622\u0628\u0627\u062F",
+    "aliases": [
+      "Jadoon Phase 2 Abbottabad"
+    ],
+    "postalCode": "22010",
+    "coordinates": {
+      "lat": 34.181,
+      "lng": 73.241
+    },
+    "type": "housing_society",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "abbottabad-bilal-town",
+    "cityId": "abbottabad",
+    "provinceId": "kpk",
+    "name": "Bilal Town",
+    "urduName": "\u0628\u0644\u0627\u0644 \u0679\u0627\u0624\u0646 \u0627\u06CC\u0628\u0679 \u0622\u0628\u0627\u062F",
+    "aliases": [
+      "Bilal Town Abbottabad"
+    ],
+    "postalCode": "22010",
+    "coordinates": {
+      "lat": 34.171,
+      "lng": 73.248
+    },
+    "type": "neighborhood",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "abbottabad-link-road",
+    "cityId": "abbottabad",
+    "provinceId": "kpk",
+    "name": "Link Road Commercial",
+    "urduName": "\u0644\u0646\u06A9 \u0631\u0648\u0688 \u0627\u06CC\u0628\u0679 \u0622\u0628\u0627\u062F",
+    "aliases": [
+      "Karakoram Highway Link Road"
+    ],
+    "postalCode": "22010",
+    "coordinates": {
+      "lat": 34.162,
+      "lng": 73.228
+    },
+    "type": "commercial",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "abbottabad-mansehra-road",
+    "cityId": "abbottabad",
+    "provinceId": "kpk",
+    "name": "Mansehra Road Corridor",
+    "urduName": "\u0645\u0627\u0646\u0633\u06C1\u0631\u06C1 \u0631\u0648\u0688 \u0627\u06CC\u0628\u0679 \u0622\u0628\u0627\u062F",
+    "aliases": [
+      "Main Mansehra Road Abbottabad"
+    ],
+    "postalCode": "22010",
+    "coordinates": {
+      "lat": 34.191,
+      "lng": 73.232
+    },
+    "type": "commercial",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "abbottabad-kaghan-colony",
+    "cityId": "abbottabad",
+    "provinceId": "kpk",
+    "name": "Kaghan Colony",
+    "urduName": "\u06A9\u0627\u063A\u0627\u0646 \u06A9\u0627\u0644\u0648\u0646\u06CC \u0627\u06CC\u0628\u0679 \u0622\u0628\u0627\u062F",
+    "aliases": [
+      "Kaghan Colony Abbottabad"
+    ],
+    "postalCode": "22010",
+    "coordinates": {
+      "lat": 34.158,
+      "lng": 73.212
+    },
+    "type": "neighborhood",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "abbottabad-shimla-hill",
+    "cityId": "abbottabad",
+    "provinceId": "kpk",
+    "name": "Shimla Hill Area",
+    "urduName": "\u0634\u0645\u0644\u06C1 \u067E\u06C1\u0627\u0691\u06CC \u0627\u06CC\u0628\u0679 \u0622\u0628\u0627\u062F",
+    "aliases": [
+      "Shimla Pahari",
+      "Shimla Hill Park"
+    ],
+    "postalCode": "22010",
+    "coordinates": {
+      "lat": 34.148,
+      "lng": 73.205
+    },
+    "type": "neighborhood",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "abbottabad-murree-road",
+    "cityId": "abbottabad",
+    "provinceId": "kpk",
+    "name": "Murree Road Commercial",
+    "urduName": "\u0645\u0631\u06CC \u0631\u0648\u0688 \u0627\u06CC\u0628\u0679 \u0622\u0628\u0627\u062F",
+    "aliases": [
+      "Murree Road Abbottabad"
+    ],
+    "postalCode": "22010",
+    "coordinates": {
+      "lat": 34.142,
+      "lng": 73.221
+    },
+    "type": "commercial",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  }
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  abbottabadAreas
+});

package/dist/areas/abbottabad.d.ts

@@ -0,0 +1,3 @@
+export { abbottabadAreas } from "../data/areas/abbottabad.js";
+export type { PakistanArea } from "../types.js";
+//# sourceMappingURL=abbottabad.d.ts.map

package/dist/areas/abbottabad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abbottabad.d.ts","sourceRoot":"","sources":["../../src/areas/abbottabad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/areas/abbottabad.js

@@ -0,0 +1,2 @@
+export { abbottabadAreas } from "../data/areas/abbottabad.js";
+//# sourceMappingURL=abbottabad.js.map

package/dist/areas/abbottabad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abbottabad.js","sourceRoot":"","sources":["../../src/areas/abbottabad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/areas/aliabad-hunza.cjs

@@ -0,0 +1,205 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/areas/aliabad-hunza.ts
+var aliabad_hunza_exports = {};
+__export(aliabad_hunza_exports, {
+  aliabadHunzaAreas: () => aliabadHunzaAreas
+});
+module.exports = __toCommonJS(aliabad_hunza_exports);
+
+// src/data/areas/aliabad-hunza.ts
+var aliabadHunzaAreas = [
+  {
+    "id": "aliabad-hunza-kkh-strip",
+    "cityId": "aliabad-hunza",
+    "provinceId": "gilgit-baltistan",
+    "name": "Karakoram Highway Commercial Strip",
+    "urduName": "\u0634\u0627\u06C1\u0631\u0627\u06C1 \u0631\u06CC\u0634\u0645 \u0639\u0644\u06CC \u0622\u0628\u0627\u062F \u06C1\u0646\u0632\u06C1",
+    "aliases": [
+      "KKH Aliabad",
+      "Main Highway Aliabad Hunza"
+    ],
+    "postalCode": "15710",
+    "coordinates": {
+      "lat": 36.312,
+      "lng": 74.618
+    },
+    "type": "commercial",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "aliabad-hunza-main-bazaar",
+    "cityId": "aliabad-hunza",
+    "provinceId": "gilgit-baltistan",
+    "name": "Aliabad Main Bazaar",
+    "urduName": "\u0645\u06CC\u0646 \u0628\u0627\u0632\u0627\u0631 \u0639\u0644\u06CC \u0622\u0628\u0627\u062F \u06C1\u0646\u0632\u06C1",
+    "aliases": [
+      "Aliabad Central Market",
+      "Hunza Central Bazaar"
+    ],
+    "postalCode": "15710",
+    "coordinates": {
+      "lat": 36.315,
+      "lng": 74.622
+    },
+    "type": "commercial",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "aliabad-hunza-hospital-road",
+    "cityId": "aliabad-hunza",
+    "provinceId": "gilgit-baltistan",
+    "name": "Hospital Road (Aga Khan Health Centre)",
+    "urduName": "\u06C1\u0633\u067E\u062A\u0627\u0644 \u0631\u0648\u0688 \u0639\u0644\u06CC \u0622\u0628\u0627\u062F \u06C1\u0646\u0632\u06C1",
+    "aliases": [
+      "Aga Khan Health Services Aliabad"
+    ],
+    "postalCode": "15710",
+    "coordinates": {
+      "lat": 36.318,
+      "lng": 74.628
+    },
+    "type": "neighborhood",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "aliabad-hunza-dorkhan",
+    "cityId": "aliabad-hunza",
+    "provinceId": "gilgit-baltistan",
+    "name": "Dorkhan",
+    "urduName": "\u062F\u0648\u0631\u06A9\u06BE\u0646 \u0639\u0644\u06CC \u0622\u0628\u0627\u062F \u06C1\u0646\u0632\u06C1",
+    "aliases": [
+      "Dorkhan Mohalla Aliabad"
+    ],
+    "postalCode": "15710",
+    "coordinates": {
+      "lat": 36.308,
+      "lng": 74.612
+    },
+    "type": "neighborhood",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "aliabad-hunza-ganish",
+    "cityId": "aliabad-hunza",
+    "provinceId": "gilgit-baltistan",
+    "name": "Ganish Heritage Village Link",
+    "urduName": "\u06AF\u0646\u06CC\u0634 \u0648\u0644\u06CC\u062C \u0639\u0644\u06CC \u0622\u0628\u0627\u062F",
+    "aliases": [
+      "Ganish Ancient Settlement",
+      "Ganish Hunza"
+    ],
+    "postalCode": "15710",
+    "coordinates": {
+      "lat": 36.302,
+      "lng": 74.648
+    },
+    "type": "suburb",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "aliabad-hunza-altit-link",
+    "cityId": "aliabad-hunza",
+    "provinceId": "gilgit-baltistan",
+    "name": "Altit Link Road",
+    "urduName": "\u0627\u0644\u062A\u062A \u0644\u0646\u06A9 \u0631\u0648\u0688",
+    "aliases": [
+      "Altit Karimabad Junction"
+    ],
+    "postalCode": "15710",
+    "coordinates": {
+      "lat": 36.321,
+      "lng": 74.652
+    },
+    "type": "suburb",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "aliabad-hunza-college-road",
+    "cityId": "aliabad-hunza",
+    "provinceId": "gilgit-baltistan",
+    "name": "College Road",
+    "urduName": "\u06A9\u0627\u0644\u062C \u0631\u0648\u0688 \u0639\u0644\u06CC \u0622\u0628\u0627\u062F \u06C1\u0646\u0632\u06C1",
+    "aliases": [
+      "Degree College Aliabad"
+    ],
+    "postalCode": "15710",
+    "coordinates": {
+      "lat": 36.324,
+      "lng": 74.625
+    },
+    "type": "neighborhood",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  },
+  {
+    "id": "aliabad-hunza-haiderabad",
+    "cityId": "aliabad-hunza",
+    "provinceId": "gilgit-baltistan",
+    "name": "Haiderabad Hunza",
+    "urduName": "\u062D\u06CC\u062F\u0631\u0622\u0628\u0627\u062F \u06C1\u0646\u0632\u06C1",
+    "aliases": [
+      "Hyderabad Hunza",
+      "Haiderabad Village"
+    ],
+    "postalCode": "15710",
+    "coordinates": {
+      "lat": 36.305,
+      "lng": 74.595
+    },
+    "type": "suburb",
+    "verified": true,
+    "sources": [
+      "survey",
+      "curated"
+    ]
+  }
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  aliabadHunzaAreas
+});

package/dist/areas/aliabad-hunza.d.ts

@@ -0,0 +1,3 @@
+export { aliabadHunzaAreas } from "../data/areas/aliabad-hunza.js";
+export type { PakistanArea } from "../types.js";
+//# sourceMappingURL=aliabad-hunza.d.ts.map

package/dist/areas/aliabad-hunza.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliabad-hunza.d.ts","sourceRoot":"","sources":["../../src/areas/aliabad-hunza.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/areas/aliabad-hunza.js

@@ -0,0 +1,2 @@
+export { aliabadHunzaAreas } from "../data/areas/aliabad-hunza.js";
+//# sourceMappingURL=aliabad-hunza.js.map

package/dist/areas/aliabad-hunza.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliabad-hunza.js","sourceRoot":"","sources":["../../src/areas/aliabad-hunza.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC"}