egydata 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 egydata
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,164 @@
+# Egydata
+
+[![NPM Version](https://img.shields.io/npm/v/egydata.svg)](https://www.npmjs.com/package/egydata)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/ahmed-ashraf-dv/egydata/blob/main/LICENSE)
+
+Structured Egyptian geographical and timezone data for Node.js and the browser.
+
+Provides a complete, offline dataset of Egyptian governorates, cities, landline and mobile area codes, and timezone utilities — with zero dependencies.
+
+[View on GitHub](https://github.com/ahmed-ashraf-dv/egydata) | [View on NPM](https://www.npmjs.com/package/egydata)
+
+## Installation
+
+```bash
+npm install egydata
+```
+
+## Quick Start
+
+```javascript
+// CommonJS
+const { governorates, cities, phoneArea, timezone } = require('egydata');
+
+// ESM
+import { governorates, cities, phoneArea, timezone } from 'egydata';
+```
+
+## Usage
+
+### Governorates
+
+```javascript
+const { governorates } = require('egydata');
+
+// Get all 27 governorates
+const all = governorates.getAll();
+// [{ id: 1, code: 'CAI', name: 'القاهرة', nameEn: 'Cairo' }, ...]
+
+// Find by code
+const cairo = governorates.getByCode('CAI');
+// { id: 1, code: 'CAI', name: 'القاهرة', nameEn: 'Cairo' }
+
+// Find by id
+const gov = governorates.getById(2);
+// { id: 2, code: 'ALX', name: 'الإسكندرية', nameEn: 'Alexandria' }
+
+// Search (Arabic or English, partial match)
+const results = governorates.search('alex');
+// [{ id: 2, code: 'ALX', name: 'الإسكندرية', nameEn: 'Alexandria' }]
+
+const arResults = governorates.search('القاهرة');
+// [{ id: 1, code: 'CAI', name: 'القاهرة', nameEn: 'Cairo' }]
+```
+
+### Cities
+
+```javascript
+const { cities } = require('egydata');
+
+// Get cities by governorate code
+const cairoCities = cities.getByGovernorate('CAI');
+// [{ id: 1, name: 'مدينة نصر', nameEn: 'Nasr City', governorateCode: 'CAI' }, ...]
+
+// Find by id
+const city = cities.getById(131);
+// { id: 131, name: 'شرم الشيخ', nameEn: 'Sharm El Sheikh', governorateCode: 'SIS' }
+
+// Search cities (Arabic or English, partial match)
+const found = cities.search('Maadi');
+// [{ id: 3, name: 'المعادي', nameEn: 'Maadi', governorateCode: 'CAI' }]
+```
+
+### Phone Area Codes
+
+```javascript
+const { phoneArea } = require('egydata');
+
+// Get all area codes (landline and mobile)
+const all = phoneArea.getAll();
+// [{ code: '02', region: 'القاهرة والجيزة', regionEn: 'Cairo & Giza' }, ...]
+
+// Look up a region by code
+const region = phoneArea.getRegion('03');
+// { code: '03', region: 'الإسكندرية', regionEn: 'Alexandria' }
+
+// Find area code by region name
+const entry = phoneArea.getCode('Mansoura');
+// { code: '050', region: 'الدقهلية (المنصورة)', regionEn: 'Dakahlia (Mansoura)' }
+```
+
+### Timezone
+
+```javascript
+const { timezone } = require('egydata');
+
+console.log(timezone.name);    // 'Africa/Cairo'
+console.log(timezone.offset);  // '+02:00'
+
+const now = timezone.now();    // Current date/time in Egypt (Date object)
+console.log(now.toISOString());
+
+console.log(timezone.isDST()); // true or false depending on current date (Egypt resumed DST in 2023)
+```
+
+## API Reference
+
+### `governorates`
+
+
+| Method            | Parameters        | Returns                   | Description                                                  |
+| ----------------- | ----------------- | ------------------------- | ------------------------------------------------------------ |
+| `getAll()`        | —                 | `Array<Governorate>`      | Returns all 27 Egyptian governorates                         |
+| `getByCode(code)` | `string`          | `Governorate | undefined` | Find a governorate by its code (e.g. `'CAI'`)                |
+| `getById(id)`     | `number | string` | `Governorate | undefined` | Find a governorate by its numeric id                         |
+| `search(query)`   | `string`          | `Array<Governorate>`      | Search by Arabic or English name (partial, case-insensitive) |
+
+
+**Governorate shape:** `{ id: number, code: string, name: string, nameEn: string }`
+
+### `cities`
+
+
+| Method                      | Parameters        | Returns            | Description                                                  |
+| --------------------------- | ----------------- | ------------------ | ------------------------------------------------------------ |
+| `getByGovernorate(govCode)` | `string`          | `Array<City>`      | Get all cities in a governorate                              |
+| `getById(id)`               | `number | string` | `City | undefined` | Find a city by its numeric id                                |
+| `search(query)`             | `string`          | `Array<City>`      | Search by Arabic or English name (partial, case-insensitive) |
+
+
+**City shape:** `{ id: number, name: string, nameEn: string, governorateCode: string }`
+
+### `phoneArea`
+
+
+| Method                | Parameters | Returns                | Description                                             |
+| --------------------- | ---------- | ---------------------- | ------------------------------------------------------- |
+| `getAll()`            | —          | `Array<AreaCode>`      | Returns all Egyptian landline and mobile area codes     |
+| `getRegion(code)`     | `string`   | `AreaCode | undefined` | Look up region info by area code                        |
+| `getCode(regionName)` | `string`   | `AreaCode | undefined` | Find area code entry by region name (Arabic or English) |
+
+
+**AreaCode shape:** `{ code: string, region: string, regionEn: string }`
+
+### `timezone`
+
+
+| Property / Method | Returns          | Description                                         |
+| ----------------- | ---------------- | --------------------------------------------------- |
+| `name`            | `'Africa/Cairo'` | IANA timezone identifier                            |
+| `offset`          | `'+02:00'`       | UTC offset                                          |
+| `now()`           | `Date`           | Current date/time in Egypt                          |
+| `isDST(date?)`    | `boolean`        | Whether DST is active (optionally for a given date) |
+
+
+## Data Coverage
+
+- **27** governorates with Arabic and English names
+- **151** cities and districts across all governorates
+- **30** landline and mobile area codes
+- Full timezone support for `Africa/Cairo`
+
+## License
+
+[MIT](LICENSE)

package/index.mjs

@@ -0,0 +1,4 @@
+import egydata from './src/index.js';
+
+export const { governorates, cities, phoneArea, timezone } = egydata;
+export default egydata;

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "egydata",
+  "version": "1.0.0",
+  "description": "Structured Egyptian geographical and timezone data — governorates, cities, phone area codes, and timezone utilities.",
+  "main": "./src/index.js",
+  "module": "./index.mjs",
+  "exports": {
+    ".": {
+      "import": "./index.mjs",
+      "require": "./src/index.js"
+    }
+  },
+  "scripts": {
+    "test": "jest --coverage"
+  },
+  "keywords": [
+    "egypt",
+    "egyptian",
+    "governorates",
+    "cities",
+    "geography",
+    "timezone",
+    "phone",
+    "area-codes",
+    "cairo",
+    "africa",
+    "arabic",
+    "محافظات",
+    "مصر"
+  ],
+  "author": "Ahmed Ashraf <ahmdgun0@gmail.com> (https://github.com/ahmed-ashraf-dv)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ahmed-ashraf-dv/egydata.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ahmed-ashraf-dv/egydata/issues"
+  },
+  "homepage": "https://github.com/ahmed-ashraf-dv/egydata#readme",
+  "files": [
+    "src/",
+    "index.mjs",
+    "LICENSE",
+    "README.md"
+  ],
+  "devDependencies": {
+    "jest": "^29.7.0"
+  }
+}

package/src/cities.js

@@ -0,0 +1,241 @@
+'use strict';
+
+const cities = [
+  // Cairo (CAI)
+  { id: 1, name: 'مدينة نصر', nameEn: 'Nasr City', governorateCode: 'CAI' },
+  { id: 2, name: 'مصر الجديدة', nameEn: 'Heliopolis', governorateCode: 'CAI' },
+  { id: 3, name: 'المعادي', nameEn: 'Maadi', governorateCode: 'CAI' },
+  { id: 4, name: 'مصر القديمة', nameEn: 'Old Cairo', governorateCode: 'CAI' },
+  { id: 5, name: 'شبرا', nameEn: 'Shubra', governorateCode: 'CAI' },
+  { id: 6, name: 'عين شمس', nameEn: 'Ain Shams', governorateCode: 'CAI' },
+  { id: 7, name: 'حلوان', nameEn: 'Helwan', governorateCode: 'CAI' },
+  { id: 8, name: 'التجمع الخامس', nameEn: 'Fifth Settlement', governorateCode: 'CAI' },
+  { id: 9, name: 'القاهرة الجديدة', nameEn: 'New Cairo', governorateCode: 'CAI' },
+  { id: 10, name: 'المقطم', nameEn: 'Mokattam', governorateCode: 'CAI' },
+
+  // Alexandria (ALX)
+  { id: 11, name: 'المنتزه', nameEn: 'Montaza', governorateCode: 'ALX' },
+  { id: 12, name: 'وسط الإسكندرية', nameEn: 'Downtown Alexandria', governorateCode: 'ALX' },
+  { id: 13, name: 'العجمي', nameEn: 'Agami', governorateCode: 'ALX' },
+  { id: 14, name: 'سيدي بشر', nameEn: 'Sidi Bishr', governorateCode: 'ALX' },
+  { id: 15, name: 'برج العرب', nameEn: 'Borg El Arab', governorateCode: 'ALX' },
+  { id: 16, name: 'العامرية', nameEn: 'Amreya', governorateCode: 'ALX' },
+
+  // Giza (GIZ)
+  { id: 17, name: 'الدقي', nameEn: 'Dokki', governorateCode: 'GIZ' },
+  { id: 18, name: 'المهندسين', nameEn: 'Mohandessin', governorateCode: 'GIZ' },
+  { id: 19, name: 'العجوزة', nameEn: 'Agouza', governorateCode: 'GIZ' },
+  { id: 20, name: 'الهرم', nameEn: 'Haram', governorateCode: 'GIZ' },
+  { id: 21, name: 'فيصل', nameEn: 'Faisal', governorateCode: 'GIZ' },
+  { id: 22, name: '6 أكتوبر', nameEn: '6th of October', governorateCode: 'GIZ' },
+  { id: 23, name: 'الشيخ زايد', nameEn: 'Sheikh Zayed', governorateCode: 'GIZ' },
+  { id: 24, name: 'إمبابة', nameEn: 'Imbaba', governorateCode: 'GIZ' },
+
+  // Port Said (PTS)
+  { id: 25, name: 'حي الشرق', nameEn: 'East District', governorateCode: 'PTS' },
+  { id: 26, name: 'حي العرب', nameEn: 'Arab District', governorateCode: 'PTS' },
+  { id: 27, name: 'حي الضواحي', nameEn: 'Suburbs District', governorateCode: 'PTS' },
+  { id: 28, name: 'بورفؤاد', nameEn: 'Port Fouad', governorateCode: 'PTS' },
+
+  // Suez (SUZ)
+  { id: 29, name: 'حي السويس', nameEn: 'Suez District', governorateCode: 'SUZ' },
+  { id: 30, name: 'حي الأربعين', nameEn: 'Arbaeen District', governorateCode: 'SUZ' },
+  { id: 31, name: 'عتاقة', nameEn: 'Ataka', governorateCode: 'SUZ' },
+  { id: 32, name: 'حي فيصل', nameEn: 'Faisal District', governorateCode: 'SUZ' },
+
+  // Dakahlia (DKH)
+  { id: 33, name: 'المنصورة', nameEn: 'Mansoura', governorateCode: 'DKH' },
+  { id: 34, name: 'طلخا', nameEn: 'Talkha', governorateCode: 'DKH' },
+  { id: 35, name: 'ميت غمر', nameEn: 'Mit Ghamr', governorateCode: 'DKH' },
+  { id: 36, name: 'دكرنس', nameEn: 'Dikirnis', governorateCode: 'DKH' },
+  { id: 37, name: 'أجا', nameEn: 'Aga', governorateCode: 'DKH' },
+  { id: 38, name: 'السنبلاوين', nameEn: 'Sinbellawin', governorateCode: 'DKH' },
+
+  // Sharqia (SHR)
+  { id: 39, name: 'الزقازيق', nameEn: 'Zagazig', governorateCode: 'SHR' },
+  { id: 40, name: 'العاشر من رمضان', nameEn: '10th of Ramadan', governorateCode: 'SHR' },
+  { id: 41, name: 'بلبيس', nameEn: 'Bilbeis', governorateCode: 'SHR' },
+  { id: 42, name: 'أبو حماد', nameEn: 'Abu Hammad', governorateCode: 'SHR' },
+  { id: 43, name: 'منيا القمح', nameEn: 'Minya Al Qamh', governorateCode: 'SHR' },
+  { id: 44, name: 'فاقوس', nameEn: 'Faqous', governorateCode: 'SHR' },
+
+  // Qalyubia (QLB)
+  { id: 45, name: 'بنها', nameEn: 'Benha', governorateCode: 'QLB' },
+  { id: 46, name: 'شبرا الخيمة', nameEn: 'Shubra El Kheima', governorateCode: 'QLB' },
+  { id: 47, name: 'قليوب', nameEn: 'Qalyub', governorateCode: 'QLB' },
+  { id: 48, name: 'القناطر الخيرية', nameEn: 'El Qanater El Khayreya', governorateCode: 'QLB' },
+  { id: 49, name: 'طوخ', nameEn: 'Toukh', governorateCode: 'QLB' },
+
+  // Kafr El Sheikh (KFS)
+  { id: 50, name: 'كفر الشيخ', nameEn: 'Kafr El Sheikh City', governorateCode: 'KFS' },
+  { id: 51, name: 'دسوق', nameEn: 'Desouk', governorateCode: 'KFS' },
+  { id: 52, name: 'فوه', nameEn: 'Fuwwah', governorateCode: 'KFS' },
+  { id: 53, name: 'بيلا', nameEn: 'Bella', governorateCode: 'KFS' },
+
+  // Gharbia (GHR)
+  { id: 54, name: 'طنطا', nameEn: 'Tanta', governorateCode: 'GHR' },
+  { id: 55, name: 'المحلة الكبرى', nameEn: 'El Mahalla El Kubra', governorateCode: 'GHR' },
+  { id: 56, name: 'كفر الزيات', nameEn: 'Kafr El Zayat', governorateCode: 'GHR' },
+  { id: 57, name: 'زفتى', nameEn: 'Zefta', governorateCode: 'GHR' },
+  { id: 58, name: 'السنطة', nameEn: 'Santa', governorateCode: 'GHR' },
+
+  // Monufia (MNF)
+  { id: 59, name: 'شبين الكوم', nameEn: 'Shebin El Kom', governorateCode: 'MNF' },
+  { id: 60, name: 'منوف', nameEn: 'Menouf', governorateCode: 'MNF' },
+  { id: 61, name: 'أشمون', nameEn: 'Ashmoun', governorateCode: 'MNF' },
+  { id: 62, name: 'السادات', nameEn: 'Sadat City', governorateCode: 'MNF' },
+  { id: 63, name: 'تلا', nameEn: 'Tala', governorateCode: 'MNF' },
+
+  // Beheira (BHR)
+  { id: 64, name: 'دمنهور', nameEn: 'Damanhour', governorateCode: 'BHR' },
+  { id: 65, name: 'كفر الدوار', nameEn: 'Kafr El Dawar', governorateCode: 'BHR' },
+  { id: 66, name: 'رشيد', nameEn: 'Rashid', governorateCode: 'BHR' },
+  { id: 67, name: 'إدكو', nameEn: 'Edku', governorateCode: 'BHR' },
+  { id: 68, name: 'أبو المطامير', nameEn: 'Abu El Matamir', governorateCode: 'BHR' },
+
+  // Ismailia (ISM)
+  { id: 69, name: 'الإسماعيلية', nameEn: 'Ismailia City', governorateCode: 'ISM' },
+  { id: 70, name: 'فايد', nameEn: 'Fayed', governorateCode: 'ISM' },
+  { id: 71, name: 'القنطرة شرق', nameEn: 'Qantara East', governorateCode: 'ISM' },
+  { id: 72, name: 'التل الكبير', nameEn: 'Tell El Kebir', governorateCode: 'ISM' },
+
+  // Damietta (DMT)
+  { id: 73, name: 'دمياط', nameEn: 'Damietta City', governorateCode: 'DMT' },
+  { id: 74, name: 'دمياط الجديدة', nameEn: 'New Damietta', governorateCode: 'DMT' },
+  { id: 75, name: 'رأس البر', nameEn: 'Ras El Bar', governorateCode: 'DMT' },
+  { id: 76, name: 'فارسكور', nameEn: 'Faraskour', governorateCode: 'DMT' },
+
+  // Faiyum (FYM)
+  { id: 77, name: 'الفيوم', nameEn: 'Faiyum City', governorateCode: 'FYM' },
+  { id: 78, name: 'إطسا', nameEn: 'Etsa', governorateCode: 'FYM' },
+  { id: 79, name: 'طامية', nameEn: 'Tamiya', governorateCode: 'FYM' },
+  { id: 80, name: 'سنورس', nameEn: 'Snouris', governorateCode: 'FYM' },
+
+  // Beni Suef (BNS)
+  { id: 81, name: 'بني سويف', nameEn: 'Beni Suef City', governorateCode: 'BNS' },
+  { id: 82, name: 'الواسطى', nameEn: 'El Wasta', governorateCode: 'BNS' },
+  { id: 83, name: 'ناصر', nameEn: 'Nasser', governorateCode: 'BNS' },
+  { id: 84, name: 'إهناسيا', nameEn: 'Ehnasia', governorateCode: 'BNS' },
+
+  // Minya (MNY)
+  { id: 85, name: 'المنيا', nameEn: 'Minya City', governorateCode: 'MNY' },
+  { id: 86, name: 'ملوي', nameEn: 'Mallawi', governorateCode: 'MNY' },
+  { id: 87, name: 'سمالوط', nameEn: 'Samalut', governorateCode: 'MNY' },
+  { id: 88, name: 'المنيا الجديدة', nameEn: 'New Minya', governorateCode: 'MNY' },
+  { id: 89, name: 'أبو قرقاص', nameEn: 'Abu Qurqas', governorateCode: 'MNY' },
+
+  // Asyut (AST)
+  { id: 90, name: 'أسيوط', nameEn: 'Asyut City', governorateCode: 'AST' },
+  { id: 91, name: 'ديروط', nameEn: 'Dairut', governorateCode: 'AST' },
+  { id: 92, name: 'القوصية', nameEn: 'El Qusiya', governorateCode: 'AST' },
+  { id: 93, name: 'منفلوط', nameEn: 'Manfalut', governorateCode: 'AST' },
+  { id: 94, name: 'أبنوب', nameEn: 'Abnoub', governorateCode: 'AST' },
+
+  // Sohag (SHG)
+  { id: 95, name: 'سوهاج', nameEn: 'Sohag City', governorateCode: 'SHG' },
+  { id: 96, name: 'أخميم', nameEn: 'Akhmim', governorateCode: 'SHG' },
+  { id: 97, name: 'جرجا', nameEn: 'Girga', governorateCode: 'SHG' },
+  { id: 98, name: 'طهطا', nameEn: 'Tahta', governorateCode: 'SHG' },
+  { id: 99, name: 'المراغة', nameEn: 'El Maragha', governorateCode: 'SHG' },
+
+  // Qena (QNA)
+  { id: 100, name: 'قنا', nameEn: 'Qena City', governorateCode: 'QNA' },
+  { id: 101, name: 'نجع حمادي', nameEn: 'Nag Hammadi', governorateCode: 'QNA' },
+  { id: 102, name: 'دشنا', nameEn: 'Dishna', governorateCode: 'QNA' },
+  { id: 103, name: 'قوص', nameEn: 'Qus', governorateCode: 'QNA' },
+
+  // Luxor (LXR)
+  { id: 104, name: 'الأقصر', nameEn: 'Luxor City', governorateCode: 'LXR' },
+  { id: 105, name: 'إسنا', nameEn: 'Esna', governorateCode: 'LXR' },
+  { id: 106, name: 'أرمنت', nameEn: 'Armant', governorateCode: 'LXR' },
+  { id: 107, name: 'الطود', nameEn: 'El Tod', governorateCode: 'LXR' },
+
+  // Aswan (ASN)
+  { id: 108, name: 'أسوان', nameEn: 'Aswan City', governorateCode: 'ASN' },
+  { id: 109, name: 'كوم أمبو', nameEn: 'Kom Ombo', governorateCode: 'ASN' },
+  { id: 110, name: 'إدفو', nameEn: 'Edfu', governorateCode: 'ASN' },
+  { id: 111, name: 'دراو', nameEn: 'Daraw', governorateCode: 'ASN' },
+  { id: 112, name: 'أبو سمبل', nameEn: 'Abu Simbel', governorateCode: 'ASN' },
+
+  // Red Sea (RED)
+  { id: 113, name: 'الغردقة', nameEn: 'Hurghada', governorateCode: 'RED' },
+  { id: 114, name: 'سفاجا', nameEn: 'Safaga', governorateCode: 'RED' },
+  { id: 115, name: 'القصير', nameEn: 'El Quseir', governorateCode: 'RED' },
+  { id: 116, name: 'مرسى علم', nameEn: 'Marsa Alam', governorateCode: 'RED' },
+  { id: 117, name: 'رأس غارب', nameEn: 'Ras Ghareb', governorateCode: 'RED' },
+
+  // New Valley (WAD)
+  { id: 118, name: 'الخارجة', nameEn: 'El Kharga', governorateCode: 'WAD' },
+  { id: 119, name: 'الداخلة', nameEn: 'Dakhla', governorateCode: 'WAD' },
+  { id: 120, name: 'الفرافرة', nameEn: 'Farafra', governorateCode: 'WAD' },
+  { id: 121, name: 'باريس', nameEn: 'Paris', governorateCode: 'WAD' },
+
+  // Matruh (MTR)
+  { id: 122, name: 'مرسى مطروح', nameEn: 'Marsa Matruh', governorateCode: 'MTR' },
+  { id: 123, name: 'سيوة', nameEn: 'Siwa', governorateCode: 'MTR' },
+  { id: 124, name: 'الحمام', nameEn: 'El Hamam', governorateCode: 'MTR' },
+  { id: 125, name: 'العلمين', nameEn: 'El Alamein', governorateCode: 'MTR' },
+  { id: 126, name: 'الضبعة', nameEn: 'El Dabaa', governorateCode: 'MTR' },
+
+  // North Sinai (SIN)
+  { id: 127, name: 'العريش', nameEn: 'Arish', governorateCode: 'SIN' },
+  { id: 128, name: 'الشيخ زويد', nameEn: 'Sheikh Zuweid', governorateCode: 'SIN' },
+  { id: 129, name: 'رفح', nameEn: 'Rafah', governorateCode: 'SIN' },
+  { id: 130, name: 'بئر العبد', nameEn: 'Bir al-Abed', governorateCode: 'SIN' },
+
+  // South Sinai (SIS)
+  { id: 131, name: 'شرم الشيخ', nameEn: 'Sharm El Sheikh', governorateCode: 'SIS' },
+  { id: 132, name: 'دهب', nameEn: 'Dahab', governorateCode: 'SIS' },
+  { id: 133, name: 'نويبع', nameEn: 'Nuweiba', governorateCode: 'SIS' },
+  { id: 134, name: 'طابا', nameEn: 'Taba', governorateCode: 'SIS' },
+  { id: 135, name: 'سانت كاترين', nameEn: 'Saint Catherine', governorateCode: 'SIS' },
+  { id: 136, name: 'الطور', nameEn: 'El Tor', governorateCode: 'SIS' },
+
+  // New Cities (4th Generation & Others)
+  { id: 137, name: 'العاصمة الإدارية الجديدة', nameEn: 'New Administrative Capital', governorateCode: 'CAI' },
+  { id: 138, name: 'الشروق', nameEn: 'El Shorouk', governorateCode: 'CAI' },
+  { id: 139, name: 'بدر', nameEn: 'Badr City', governorateCode: 'CAI' },
+  { id: 140, name: 'مدينتي', nameEn: 'Madinaty', governorateCode: 'CAI' },
+  { id: 141, name: 'مدينة الرحاب', nameEn: 'Al Rehab', governorateCode: 'CAI' },
+  { id: 142, name: '15 مايو', nameEn: '15 May City', governorateCode: 'CAI' },
+  { id: 143, name: 'سفنكس الجديدة', nameEn: 'New Sphinx', governorateCode: 'GIZ' },
+  { id: 144, name: 'حدائق أكتوبر', nameEn: 'Hadayek October', governorateCode: 'GIZ' },
+  { id: 145, name: 'برج العرب الجديدة', nameEn: 'New Borg El Arab', governorateCode: 'ALX' },
+  { id: 146, name: 'العبور', nameEn: 'El Obour', governorateCode: 'QLB' },
+  { id: 147, name: 'العبور الجديدة', nameEn: 'New Obour', governorateCode: 'QLB' },
+  { id: 148, name: 'المنصورة الجديدة', nameEn: 'New Mansoura', governorateCode: 'DKH' },
+  { id: 149, name: 'العلمين الجديدة', nameEn: 'New Alamein', governorateCode: 'MTR' },
+  { id: 150, name: 'مدينة الجلالة', nameEn: 'Galala City', governorateCode: 'SUZ' },
+  { id: 151, name: 'مدينة ناصر (غرب أسيوط)', nameEn: 'Nasser City (West Asyut)', governorateCode: 'AST' },
+];
+
+const idMap = new Map(cities.map((c) => [c.id, c]));
+
+const govMap = new Map();
+for (const city of cities) {
+  const code = city.governorateCode;
+  if (!govMap.has(code)) govMap.set(code, []);
+  govMap.get(code).push(city);
+}
+
+function getByGovernorate(govCode) {
+  if (typeof govCode !== 'string') return [];
+  const list = govMap.get(govCode.toUpperCase());
+  return list ? [...list] : [];
+}
+
+function getById(id) {
+  const numId = Number(id);
+  if (!Number.isInteger(numId)) return undefined;
+  return idMap.get(numId) || undefined;
+}
+
+function search(query) {
+  if (typeof query !== 'string' || !query.trim()) return [];
+  const q = query.trim().toLowerCase();
+  return cities.filter(
+    (c) => c.name.includes(q) || c.nameEn.toLowerCase().includes(q)
+  );
+}
+
+module.exports = { getByGovernorate, getById, search };

package/src/governorates.js

@@ -0,0 +1,62 @@
+'use strict';
+
+const governorates = [
+  { id: 1, code: 'CAI', name: 'القاهرة', nameEn: 'Cairo' },
+  { id: 2, code: 'ALX', name: 'الإسكندرية', nameEn: 'Alexandria' },
+  { id: 3, code: 'GIZ', name: 'الجيزة', nameEn: 'Giza' },
+  { id: 4, code: 'PTS', name: 'بورسعيد', nameEn: 'Port Said' },
+  { id: 5, code: 'SUZ', name: 'السويس', nameEn: 'Suez' },
+  { id: 6, code: 'DKH', name: 'الدقهلية', nameEn: 'Dakahlia' },
+  { id: 7, code: 'SHR', name: 'الشرقية', nameEn: 'Sharqia' },
+  { id: 8, code: 'QLB', name: 'القليوبية', nameEn: 'Qalyubia' },
+  { id: 9, code: 'KFS', name: 'كفر الشيخ', nameEn: 'Kafr El Sheikh' },
+  { id: 10, code: 'GHR', name: 'الغربية', nameEn: 'Gharbia' },
+  { id: 11, code: 'MNF', name: 'المنوفية', nameEn: 'Monufia' },
+  { id: 12, code: 'BHR', name: 'البحيرة', nameEn: 'Beheira' },
+  { id: 13, code: 'ISM', name: 'الإسماعيلية', nameEn: 'Ismailia' },
+  { id: 14, code: 'DMT', name: 'دمياط', nameEn: 'Damietta' },
+  { id: 15, code: 'FYM', name: 'الفيوم', nameEn: 'Faiyum' },
+  { id: 16, code: 'BNS', name: 'بني سويف', nameEn: 'Beni Suef' },
+  { id: 17, code: 'MNY', name: 'المنيا', nameEn: 'Minya' },
+  { id: 18, code: 'AST', name: 'أسيوط', nameEn: 'Asyut' },
+  { id: 19, code: 'SHG', name: 'سوهاج', nameEn: 'Sohag' },
+  { id: 20, code: 'QNA', name: 'قنا', nameEn: 'Qena' },
+  { id: 21, code: 'LXR', name: 'الأقصر', nameEn: 'Luxor' },
+  { id: 22, code: 'ASN', name: 'أسوان', nameEn: 'Aswan' },
+  { id: 23, code: 'RED', name: 'البحر الأحمر', nameEn: 'Red Sea' },
+  { id: 24, code: 'WAD', name: 'الوادي الجديد', nameEn: 'New Valley' },
+  { id: 25, code: 'MTR', name: 'مطروح', nameEn: 'Matruh' },
+  { id: 26, code: 'SIN', name: 'شمال سيناء', nameEn: 'North Sinai' },
+  { id: 27, code: 'SIS', name: 'جنوب سيناء', nameEn: 'South Sinai' },
+];
+
+const codeMap = new Map(governorates.map((g) => [g.code, g]));
+const idMap = new Map(governorates.map((g) => [g.id, g]));
+
+function getAll() {
+  return [...governorates];
+}
+
+function getByCode(code) {
+  if (typeof code !== 'string') return undefined;
+  return codeMap.get(code.toUpperCase()) || undefined;
+}
+
+function getById(id) {
+  const numId = Number(id);
+  if (!Number.isInteger(numId)) return undefined;
+  return idMap.get(numId) || undefined;
+}
+
+function search(query) {
+  if (typeof query !== 'string' || !query.trim()) return [];
+  const q = query.trim().toLowerCase();
+  return governorates.filter(
+    (g) =>
+      g.name.includes(q) ||
+      g.nameEn.toLowerCase().includes(q) ||
+      g.code.toLowerCase().includes(q)
+  );
+}
+
+module.exports = { getAll, getByCode, getById, search };

package/src/index.js

@@ -0,0 +1,8 @@
+'use strict';
+
+const governorates = require('./governorates');
+const cities = require('./cities');
+const phoneArea = require('./phoneArea');
+const timezone = require('./timezone');
+
+module.exports = { governorates, cities, phoneArea, timezone };

package/src/phoneArea.js

@@ -0,0 +1,61 @@
+'use strict';
+
+const areaCodes = [
+  // Mobile Networks
+  { code: '010', region: 'ڤودافون', regionEn: 'Vodafone' },
+  { code: '011', region: 'اتصالات', regionEn: 'Etisalat' },
+  { code: '012', region: 'أورنج', regionEn: 'Orange' },
+  { code: '015', region: 'وي / العاشر من رمضان', regionEn: 'WE / 10th of Ramadan' },
+
+  // Landlines
+  { code: '02', region: 'القاهرة والجيزة', regionEn: 'Cairo & Giza' },
+  { code: '03', region: 'الإسكندرية', regionEn: 'Alexandria' },
+  { code: '013', region: 'القليوبية (بنها)', regionEn: 'Qalyubia (Benha)' },
+  { code: '040', region: 'الغربية (طنطا)', regionEn: 'Gharbia (Tanta)' },
+  { code: '045', region: 'البحيرة (دمنهور)', regionEn: 'Beheira (Damanhour)' },
+  { code: '046', region: 'مطروح', regionEn: 'Matruh' },
+  { code: '047', region: 'كفر الشيخ', regionEn: 'Kafr El Sheikh' },
+  { code: '048', region: 'المنوفية (شبين الكوم)', regionEn: 'Monufia (Shebin El Kom)' },
+  { code: '050', region: 'الدقهلية (المنصورة)', regionEn: 'Dakahlia (Mansoura)' },
+  { code: '055', region: 'الشرقية (الزقازيق)', regionEn: 'Sharqia (Zagazig)' },
+  { code: '057', region: 'دمياط', regionEn: 'Damietta' },
+  { code: '062', region: 'السويس', regionEn: 'Suez' },
+  { code: '064', region: 'الإسماعيلية', regionEn: 'Ismailia' },
+  { code: '065', region: 'البحر الأحمر (الغردقة)', regionEn: 'Red Sea (Hurghada)' },
+  { code: '066', region: 'بورسعيد', regionEn: 'Port Said' },
+  { code: '068', region: 'شمال سيناء (العريش)', regionEn: 'North Sinai (Arish)' },
+  { code: '069', region: 'جنوب سيناء', regionEn: 'South Sinai' },
+  { code: '082', region: 'بني سويف', regionEn: 'Beni Suef' },
+  { code: '084', region: 'الفيوم', regionEn: 'Faiyum' },
+  { code: '086', region: 'المنيا', regionEn: 'Minya' },
+  { code: '088', region: 'أسيوط', regionEn: 'Asyut' },
+  { code: '092', region: 'الوادي الجديد', regionEn: 'New Valley' },
+  { code: '093', region: 'سوهاج', regionEn: 'Sohag' },
+  { code: '095', region: 'الأقصر', regionEn: 'Luxor' },
+  { code: '096', region: 'قنا', regionEn: 'Qena' },
+  { code: '097', region: 'أسوان', regionEn: 'Aswan' },
+];
+
+const codeMap = new Map(areaCodes.map((a) => [a.code, a]));
+
+function getAll() {
+  return [...areaCodes];
+}
+
+function getRegion(code) {
+  if (typeof code !== 'string') return undefined;
+  const normalized = code.replace(/^0*/, '0');
+  return codeMap.get(code) || codeMap.get(normalized) || undefined;
+}
+
+function getCode(regionName) {
+  if (typeof regionName !== 'string' || !regionName.trim()) return undefined;
+  const q = regionName.trim().toLowerCase();
+  return (
+    areaCodes.find(
+      (a) => a.region.includes(q) || a.regionEn.toLowerCase().includes(q)
+    ) || undefined
+  );
+}
+
+module.exports = { getAll, getRegion, getCode };

package/src/timezone.js

@@ -0,0 +1,55 @@
+'use strict';
+
+const name = 'Africa/Cairo';
+const offset = '+02:00';
+
+function now() {
+  const formatter = new Intl.DateTimeFormat('en-US', {
+    timeZone: 'Africa/Cairo',
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hour12: false,
+  });
+
+  const parts = formatter.formatToParts(new Date());
+  const get = (type) => parts.find((p) => p.type === type).value;
+
+  const year = Number(get('year'));
+  const month = Number(get('month')) - 1;
+  const day = Number(get('day'));
+  const hour = Number(get('hour'));
+  const minute = Number(get('minute'));
+  const second = Number(get('second'));
+
+  return new Date(Date.UTC(year, month, day, hour, minute, second));
+}
+
+function isDST(date = new Date()) {
+  // Egypt resumed daylight saving time in 2023.
+  const formatter = new Intl.DateTimeFormat('en-US', {
+    timeZone: 'Africa/Cairo',
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hour12: false,
+  });
+
+  const parts = formatter.formatToParts(date);
+  const get = (type) => Number(parts.find((p) => p.type === type).value);
+
+  const tzDate = new Date(Date.UTC(get('year'), get('month') - 1, get('day'), get('hour'), get('minute'), get('second')));
+  const offsetMinutes = Math.round((tzDate.getTime() - date.getTime()) / 60000);
+
+  // Standard time offset is +120 minutes (+02:00)
+  // DST offset is +180 minutes (+03:00)
+  return offsetMinutes === 180;
+}
+
+module.exports = { name, offset, now, isDST };