From 5afa25ca3017d42d2663984cce06c941255facf3 Mon Sep 17 00:00:00 2001
From: gabrieleolmi <gabrieleolmi11@gmail.com>
Date: Tue, 27 May 2025 16:24:49 +0200
Subject: [PATCH] added Albania and Kosovo providers

---
 src/Provider/sq_AL/Address.php     | 371 +++++++++++++++++++++++++++++
 src/Provider/sq_AL/PhoneNumber.php |  61 +++++
 src/Provider/sq_XK/Address.php     | 339 ++++++++++++++++++++++++++
 src/Provider/sq_XK/PhoneNumber.php |  68 ++++++
 4 files changed, 839 insertions(+)
 create mode 100644 src/Provider/sq_AL/Address.php
 create mode 100644 src/Provider/sq_AL/PhoneNumber.php
 create mode 100644 src/Provider/sq_XK/Address.php
 create mode 100644 src/Provider/sq_XK/PhoneNumber.php

diff --git a/src/Provider/sq_AL/Address.php b/src/Provider/sq_AL/Address.php
new file mode 100644
index 0000000000..7edf4535ac
--- /dev/null
+++ b/src/Provider/sq_AL/Address.php
@@ -0,0 +1,371 @@
+<?php
+
+namespace Faker\Provider\sq_AL;
+
+class Address extends \Faker\Provider\Address
+{
+    protected static $streetPrefix = [
+        'Rruga',
+        'Bulevardi',
+        'Sheshi',
+    ];
+
+    protected static $street = [
+        'Myslym Shyri',
+        'Barrikadave',
+        'Sami Frashëri',
+        'Ismail Qemali',
+        'Abdi Toptani',
+        'George W. Bush',
+        'Mihal Duri',
+        'Don Bosko',
+        'Ali Demi',
+        'Petro Nini Luarasi',
+        'Faik Konica',
+        'Margarita Tutulani',
+        'Bardhyl',
+        'Fortuzi',
+        'Vaso Pasha',
+        'Qemal Stafa',
+        'Hoxha Tahsim',
+        'Reshit Çollaku',
+        'Pjetër Bogdani',
+        'Asim Vokshi',
+        'Kajo Karafili',
+        'Skënderbej',
+        'Tefta Tashko Koço',
+        'Mihal Grameno',
+    ];
+
+    protected static $cityFormats = [
+        '{{municipality}}',
+    ];
+
+    protected static $streetNameFormats = [
+        '{{street}}',
+        '{{streetPrefix}} {{street}}',
+    ];
+
+    protected static $streetAddressFormats = [
+        '{{streetName}} {{buildingNumber}}',
+    ];
+
+    protected static $addressFormats = [
+        "{{streetAddress}}\n{{city}} {{postcode}}",
+    ];
+
+    protected static $buildingNumber = ['%##', '%#', '%'];
+
+    /**
+     * https://en.wikipedia.org/wiki/Postal_codes_in_Albania
+     */
+    protected static $postcode = ['####'];
+
+    /**
+     * https://sq.wikipedia.org/wiki/Lista_e_shteteve
+     */
+    protected static $country = [
+        'Afganistani',
+        'Afrika Qendrore',
+        'Algjeria',
+        'Andorra',
+        'Angola',
+        'Antigua dhe Barbuda',
+        'Arabia Saudite',
+        'Argjentina',
+        'Armenia',
+        'Australia',
+        'Austria',
+        'Azerbajxhani',
+        'Bahamet',
+        'Bahreini',
+        'Bangladeshi',
+        'Barbadosi',
+        'Belgjika',
+        'Beliza',
+        'Benini',
+        'Birmania',
+        'Bjellorusia',
+        'Bolivia',
+        'Bosnja dhe Hercegovina',
+        'Botsvana',
+        'Brazili',
+        'Bregu i Fildishtë',
+        'Brunei',
+        'Bullgaria',
+        'Burkina Faso',
+        'Burundi',
+        'Butani',
+        'Çadi',
+        'Republika Çeke',
+        'Danimarka',
+        'Domenika',
+        'Republika Dominikane',
+        'Egjipti',
+        'Ekuadori',
+        'Emiratet e Bashkuara Arabe',
+        'Eritrea',
+        'Estonia',
+        'Etiopia',
+        'Federata Mikroneziane',
+        'Filipinet',
+        'Finlanda',
+        'Fixhi',
+        'Franca',
+        'Gaboni',
+        'Gambia',
+        'Gana',
+        'Grenada',
+        'Greqia',
+        'Guajana',
+        'Guatemala',
+        'Guinea',
+        'Guinea Bisau',
+        'Guinea Ekuatoriale',
+        'Gjeorgjia',
+        'Gjermania',
+        'Haiti',
+        'Holanda',
+        'Hondurasi',
+        'Hungaria',
+        'India',
+        'Indonezia',
+        'Iraku',
+        'Irani',
+        'Irlanda',
+        'Islanda',
+        'Italia',
+        'Izraeli',
+        'Japonia',
+        'Jemeni',
+        'Jordania',
+        'Republika Jugafrikane',
+        'Kamboxhia',
+        'Kameruni',
+        'Kanadaja',
+        'Katari',
+        'Kazakistani',
+        'Kenia',
+        'Kepi i Gjelbër',
+        'Kili',
+        'Kina',
+        'Kirgizistani',
+        'Kiribati',
+        'Kolumbia',
+        'Komoret',
+        'Kongo, Republika e',
+        'Kongo, Republika Demokratike e',
+        'Koreja e Jugut',
+        'Koreja e Veriut',
+        'Kosova',
+        'Kosta Rika',
+        'Kroacia',
+        'Kuba',
+        'Kuvajti',
+        'Laosi',
+        'Lesoto',
+        'Letonia',
+        'Libani',
+        'Liberia',
+        'Libia',
+        'Lihtenshtajni',
+        'Lituania',
+        'Luksemburgu',
+        'Madagaskari',
+        'Malajzia',
+        'Malavi',
+        'Maldivet',
+        'Mali',
+        'Mali i Zi',
+        'Malta',
+        'Maroku',
+        'Maqedonia e Veriut',
+        'Ishujt Marshall',
+        'Mauritania',
+        'Mauritiusi',
+        'Mbretëria e Bashkuar',
+        'Anglia',
+        'Irlanda Veriore',
+        'Skocia',
+        'Uellsi',
+        'Moldavia',
+        'Monako',
+        'Mongolia',
+        'Mozambiku',
+        'Namibia',
+        'Naurua',
+        'Nepali',
+        'Nigeri',
+        'Nigeria',
+        'Nikaragua',
+        'Norvegjia',
+        'Omani',
+        'Pakistani',
+        'Palau',
+        'Palestina',
+        'Panamaja',
+        'Papua Guinea e Re',
+        'Paraguaji',
+        'Peruja',
+        'Polonia',
+        'Portugalia',
+        'Qiproja',
+        'Ruanda',
+        'Rumania',
+        'Rusia',
+        'Salvadori',
+        'Samoa',
+        'San Marino',
+        'Sao Tome dhe Principe',
+        'Sejshellet',
+        'Senegali',
+        'Serbia',
+        'Siera Leone',
+        'Singapori',
+        'Siria',
+        'Sllovakia',
+        'Sllovenia',
+        'Ishujt Solomon',
+        'Somalia',
+        'Spanja',
+        'Sri Lanka',
+        'Suazilandi',
+        'Sudani',
+        'Sudani i Jugut',
+        'Suedia',
+        'Surinami',
+        'Shën Kits dhe Nevis',
+        'Shën Luçia',
+        'Shën Vincenti dhe Grenadinet',
+        'Shqipëria',
+        'Shtetet e Bashkuara të Amerikës',
+        'Tajlanda',
+        'Tanzania',
+        'Taxhikistani',
+        'Timori Lindor',
+        'Togo',
+        'Tonga',
+        'Trinidadi dhe Tobagoja',
+        'Tunizia',
+        'Turkmenistani',
+        'Turqia',
+        'Tuvalu',
+        'Uganda',
+        'Ukraina',
+        'Uruguaji',
+        'Uzbekistani',
+        'Vanuatu',
+        'Vatikani',
+        'Venezuela',
+        'Vietnami',
+        'Xhamajka',
+        'Xhibuti',
+        'Zambia',
+        'Zelanda e Re',
+        'Zimbabveja',
+        'Zvicra',
+        'Abkazia',
+        'Arcah',
+        'Doneckut, Republika Popullore e',
+        'Kosova',
+        'Ishujt Kuk',
+        'Luhanskut, Republika Popullore e',
+        'Niue',
+        'Osetia Jugore',
+        'Qiproja Veriore',
+        'Sahravit, Republika Demokratike Arabe e',
+        'Somalilandi',
+        'Tajvan',
+        'Transnistria',
+    ];
+
+    /**
+     * https://en.wikipedia.org/wiki/Municipalities_of_Albania
+     */
+    protected static $municipalities = [
+        'Belsh',
+        'Berat',
+        'Bulqizë',
+        'Cërrik',
+        'Delvinë',
+        'Devoll',
+        'Dibër',
+        'Dimal',
+        'Divjakë',
+        'Dropull',
+        'Durrës',
+        'Elbasan',
+        'Fier',
+        'Finiq',
+        'Fushë-Arrëz',
+        'Gjirokastër',
+        'Gramsh',
+        'Has',
+        'Himarë',
+        'Kamëz',
+        'Kavajë',
+        'Këlcyrë',
+        'Klos',
+        'Kolonjë',
+        'Konispol',
+        'Korçë',
+        'Krujë',
+        'Kuçovë',
+        'Kukës',
+        'Kurbin',
+        'Lezhë',
+        'Libohovë',
+        'Librazhd',
+        'Lushnjë',
+        'Malësi e Madhe',
+        'Mallakastër',
+        'Maliq',
+        'Mat',
+        'Memaliaj',
+        'Mirditë',
+        'Patos',
+        'Peqin',
+        'Përmet',
+        'Poliçan',
+        'Pogradec',
+        'Prrenjas',
+        'Pukë',
+        'Pustec',
+        'Roskovec',
+        'Rrogozhinë',
+        'Sarandë',
+        'Selenicë',
+        'Shijak',
+        'Shkodër',
+        'Skrapar',
+        'Tepelenë',
+        'Tiranë',
+        'Tropojë',
+        'Vau i Dejës',
+        'Vlorë',
+        'Vorë',
+    ];
+
+    public static function municipality(): string
+    {
+        return static::randomElement(static::$municipalities);
+    }
+
+    public static function streetPrefix(): string
+    {
+        return static::randomElement(static::$streetPrefix);
+    }
+
+    public static function street(): string
+    {
+        return static::randomElement(static::$street);
+    }
+
+    public static function localCoordinates(): array
+    {
+        return [
+            'latitude' => static::latitude(40.208626, 42.193826),
+            'longitude' => static::longitude(19.649947, 20.371598),
+        ];
+    }
+}
diff --git a/src/Provider/sq_AL/PhoneNumber.php b/src/Provider/sq_AL/PhoneNumber.php
new file mode 100644
index 0000000000..7020b9b3b1
--- /dev/null
+++ b/src/Provider/sq_AL/PhoneNumber.php
@@ -0,0 +1,61 @@
+<?php
+
+namespace Faker\Provider\sq_AL;
+
+class PhoneNumber extends \Faker\Provider\PhoneNumber
+{
+    protected static $formats = [
+        '{{mobileNumber}}',
+        '{{fixedLineNumber}}',
+    ];
+
+    protected static $e164Formats = [
+        '+355{{mobileNumber}}',
+        '+355{{fixedLineNumber}}',
+    ];
+
+    /**
+     * https://en.wikipedia.org/wiki/Telephone_numbers_in_Albania#Mobile_phone_codes
+     * https://github.com/giggsey/libphonenumber-for-php/blob/master/src/data/PhoneNumberMetadata_AL.php
+     */
+    protected static $mobileFormats = [
+        '06[78][2-9]\d{6}',
+        '069\d{7}'
+    ];
+
+    /**
+     * https://en.wikipedia.org/wiki/Telephone_numbers_in_Albania#Numbering_plan_by_Municipality_(effective_15_September_2008)
+     * https://github.com/giggsey/libphonenumber-for-php/blob/master/src/data/PhoneNumberMetadata_AL.php
+     */
+    protected static $fixedLineFormats = [
+        '04505[0-2]\d{3}',
+        '0[2358][16-9]\d[2-9]\d{4}',
+        '04410\d{4}',
+        '0[2358][2-5][2-9]\d{5}',
+        '04[2-57-9][2-9]\d{5}',
+        '046\d{6}',
+    ];
+
+    public function mobileNumber(): string
+    {
+        $format = static::randomElement(static::$mobileFormats);
+
+        return static::regexify($format);
+    }
+
+    public function fixedLineNumber(): string
+    {
+        $format = static::randomElement(static::$fixedLineFormats);
+
+        return static::regexify($format);
+    }
+
+    public function e164PhoneNumber(): string
+    {
+        $format = static::randomElement(static::$e164Formats);
+
+        $phoneNumber = $this->generator->parse($format);
+
+        return preg_replace('/\+3550(\d+)/', '+355$1', $phoneNumber);
+    }
+}
diff --git a/src/Provider/sq_XK/Address.php b/src/Provider/sq_XK/Address.php
new file mode 100644
index 0000000000..c8336cbfb7
--- /dev/null
+++ b/src/Provider/sq_XK/Address.php
@@ -0,0 +1,339 @@
+<?php
+
+namespace Faker\Provider\sq_XK;
+
+class Address extends \Faker\Provider\Address
+{
+    protected static $street = [
+        'UÇK',
+        'Garibaldi',
+        'Luan Haradinaj',
+        'Fehmi Agani',
+        'Bill Clinton',
+        'Ilir Konushevci',
+        'Agim Ramadani',
+        'Xhemajl Prishtina',
+        'Muharrem Fejza',
+        'Rexhep Luci',
+        'Migjeni',
+        'Zahir Pajaziti',
+        'Adem Jashari',
+        'Dëshmorët e Kombit',
+        'Hasan Prishtina',
+        'Ismail Qemali',
+        'Eqrem Çabej',
+        'Vëllezërit Gërvalla',
+        'Idriz Seferi',
+        'Bekim Berisha',
+        'Nënë Tereza',
+        'Bajram Curri',
+        'Skënderbeu',
+        'Gani Elshani',
+        'Lidhja e Prizrenit',
+        'Marin Barleti',
+        'Haxhi Zeka'
+    ];
+
+    protected static $cityFormats = [
+        '{{municipality}}',
+    ];
+
+    protected static $streetNameFormats = [
+        '{{street}}',
+    ];
+
+    protected static $streetAddressFormats = [
+        '{{streetName}} {{buildingNumber}}',
+    ];
+
+    protected static $addressFormats = [
+        "{{streetAddress}}\n{{city}} {{postcode}}",
+    ];
+
+    protected static $buildingNumber = ['%##', '%#', '%'];
+
+    /**
+     * https://en.wikipedia.org/wiki/Postal_codes_in_Kosovo
+     */
+    protected static $postcode = ['#####'];
+
+    /**
+     * https://sq.wikipedia.org/wiki/Lista_e_shteteve
+     */
+    protected static $country = [
+        'Afganistani',
+        'Afrika Qendrore',
+        'Algjeria',
+        'Andorra',
+        'Angola',
+        'Antigua dhe Barbuda',
+        'Arabia Saudite',
+        'Argjentina',
+        'Armenia',
+        'Australia',
+        'Austria',
+        'Azerbajxhani',
+        'Bahamet',
+        'Bahreini',
+        'Bangladeshi',
+        'Barbadosi',
+        'Belgjika',
+        'Beliza',
+        'Benini',
+        'Birmania',
+        'Bjellorusia',
+        'Bolivia',
+        'Bosnja dhe Hercegovina',
+        'Botsvana',
+        'Brazili',
+        'Bregu i Fildishtë',
+        'Brunei',
+        'Bullgaria',
+        'Burkina Faso',
+        'Burundi',
+        'Butani',
+        'Çadi',
+        'Republika Çeke',
+        'Danimarka',
+        'Domenika',
+        'Republika Dominikane',
+        'Egjipti',
+        'Ekuadori',
+        'Emiratet e Bashkuara Arabe',
+        'Eritrea',
+        'Estonia',
+        'Etiopia',
+        'Federata Mikroneziane',
+        'Filipinet',
+        'Finlanda',
+        'Fixhi',
+        'Franca',
+        'Gaboni',
+        'Gambia',
+        'Gana',
+        'Grenada',
+        'Greqia',
+        'Guajana',
+        'Guatemala',
+        'Guinea',
+        'Guinea Bisau',
+        'Guinea Ekuatoriale',
+        'Gjeorgjia',
+        'Gjermania',
+        'Haiti',
+        'Holanda',
+        'Hondurasi',
+        'Hungaria',
+        'India',
+        'Indonezia',
+        'Iraku',
+        'Irani',
+        'Irlanda',
+        'Islanda',
+        'Italia',
+        'Izraeli',
+        'Japonia',
+        'Jemeni',
+        'Jordania',
+        'Republika Jugafrikane',
+        'Kamboxhia',
+        'Kameruni',
+        'Kanadaja',
+        'Katari',
+        'Kazakistani',
+        'Kenia',
+        'Kepi i Gjelbër',
+        'Kili',
+        'Kina',
+        'Kirgizistani',
+        'Kiribati',
+        'Kolumbia',
+        'Komoret',
+        'Kongo, Republika e',
+        'Kongo, Republika Demokratike e',
+        'Koreja e Jugut',
+        'Koreja e Veriut',
+        'Kosova',
+        'Kosta Rika',
+        'Kroacia',
+        'Kuba',
+        'Kuvajti',
+        'Laosi',
+        'Lesoto',
+        'Letonia',
+        'Libani',
+        'Liberia',
+        'Libia',
+        'Lihtenshtajni',
+        'Lituania',
+        'Luksemburgu',
+        'Madagaskari',
+        'Malajzia',
+        'Malavi',
+        'Maldivet',
+        'Mali',
+        'Mali i Zi',
+        'Malta',
+        'Maroku',
+        'Maqedonia e Veriut',
+        'Ishujt Marshall',
+        'Mauritania',
+        'Mauritiusi',
+        'Mbretëria e Bashkuar',
+        'Anglia',
+        'Irlanda Veriore',
+        'Skocia',
+        'Uellsi',
+        'Moldavia',
+        'Monako',
+        'Mongolia',
+        'Mozambiku',
+        'Namibia',
+        'Naurua',
+        'Nepali',
+        'Nigeri',
+        'Nigeria',
+        'Nikaragua',
+        'Norvegjia',
+        'Omani',
+        'Pakistani',
+        'Palau',
+        'Palestina',
+        'Panamaja',
+        'Papua Guinea e Re',
+        'Paraguaji',
+        'Peruja',
+        'Polonia',
+        'Portugalia',
+        'Qiproja',
+        'Ruanda',
+        'Rumania',
+        'Rusia',
+        'Salvadori',
+        'Samoa',
+        'San Marino',
+        'Sao Tome dhe Principe',
+        'Sejshellet',
+        'Senegali',
+        'Serbia',
+        'Siera Leone',
+        'Singapori',
+        'Siria',
+        'Sllovakia',
+        'Sllovenia',
+        'Ishujt Solomon',
+        'Somalia',
+        'Spanja',
+        'Sri Lanka',
+        'Suazilandi',
+        'Sudani',
+        'Sudani i Jugut',
+        'Suedia',
+        'Surinami',
+        'Shën Kits dhe Nevis',
+        'Shën Luçia',
+        'Shën Vincenti dhe Grenadinet',
+        'Shqipëria',
+        'Shtetet e Bashkuara të Amerikës',
+        'Tajlanda',
+        'Tanzania',
+        'Taxhikistani',
+        'Timori Lindor',
+        'Togo',
+        'Tonga',
+        'Trinidadi dhe Tobagoja',
+        'Tunizia',
+        'Turkmenistani',
+        'Turqia',
+        'Tuvalu',
+        'Uganda',
+        'Ukraina',
+        'Uruguaji',
+        'Uzbekistani',
+        'Vanuatu',
+        'Vatikani',
+        'Venezuela',
+        'Vietnami',
+        'Xhamajka',
+        'Xhibuti',
+        'Zambia',
+        'Zelanda e Re',
+        'Zimbabveja',
+        'Zvicra',
+        'Abkazia',
+        'Arcah',
+        'Doneckut, Republika Popullore e',
+        'Kosova',
+        'Ishujt Kuk',
+        'Luhanskut, Republika Popullore e',
+        'Niue',
+        'Osetia Jugore',
+        'Qiproja Veriore',
+        'Sahravit, Republika Demokratike Arabe e',
+        'Somalilandi',
+        'Tajvan',
+        'Transnistria',
+    ];
+
+    /**
+     * https://en.wikipedia.org/wiki/Municipalities_of_Kosovo
+     */
+    protected static $municipalities = [
+        'Deçan',
+        'Dragash',
+        'Drenas',
+        'Ferizaj',
+        'Fushë Kosova',
+        'Gjakova',
+        'Gjilan',
+        'Graçanicë',
+        'Hani i Elezit',
+        'Istog',
+        'Junik',
+        'Kaçanik',
+        'Kamenica',
+        'Klinë',
+        'Kllokot',
+        'Leposaviq',
+        'Lipjan',
+        'Malisheva',
+        'Mamusha',
+        'Mitrovica',
+        'North Mitrovica',
+        'Novobërda',
+        'Obiliq',
+        'Partesh',
+        'Peja',
+        'Podujevë',
+        'Prishtina',
+        'Prizren',
+        'Rahovec',
+        'Ranillug',
+        'Skenderaj',
+        'Shtime',
+        'Shtërpca',
+        'Suhareka',
+        'Vitia',
+        'Vushtrri',
+        'Zubin Potoku',
+        'Zveçan',
+    ];
+
+    public static function municipality(): string
+    {
+        return static::randomElement(static::$municipalities);
+    }
+
+    public static function street(): string
+    {
+        return static::randomElement(static::$street);
+    }
+
+    public static function localCoordinates(): array
+    {
+        return [
+            'latitude' => static::latitude(42.245536, 42.852125),
+            'longitude' => static::longitude(20.515369, 21.351432),
+        ];
+    }
+}
diff --git a/src/Provider/sq_XK/PhoneNumber.php b/src/Provider/sq_XK/PhoneNumber.php
new file mode 100644
index 0000000000..9a1cdbb9ff
--- /dev/null
+++ b/src/Provider/sq_XK/PhoneNumber.php
@@ -0,0 +1,68 @@
+<?php
+
+namespace Faker\Provider\sq_XK;
+
+class PhoneNumber extends \Faker\Provider\PhoneNumber
+{
+    protected static $formats = [
+        '{{mobileNumber}}',
+        '{{fixedLineNumber}}',
+    ];
+
+    protected static $e164Formats = [
+        '+383{{mobileNumber}}',
+        '+383{{fixedLineNumber}}',
+    ];
+
+    /**
+     * https://en.wikipedia.org/wiki/Telephone_numbers_in_Kosovo#Mobile_telephony
+     * https://github.com/giggsey/libphonenumber-for-php/blob/master/src/data/PhoneNumberMetadata_XK.php
+     */
+    protected static $mobileFormats = [
+        '04[3-9]\d{6}',
+    ];
+
+    /**
+     * https://en.wikipedia.org/wiki/Telephone_numbers_in_Kosovo#Fixed-line_telephony
+     * https://github.com/giggsey/libphonenumber-for-php/blob/master/src/data/PhoneNumberMetadata_XK.php
+     */
+    protected static $fixedLineFormats = [
+        '038\d{6}',
+        '038\d{7}',
+        '038\d{8}',
+        '038\d{9}',
+        '038\d{10}',
+        '0280\d{5}',
+        '0280\d{6}',
+        '028[1-9]\d{5}',
+        '0290\d{5}',
+        '0290\d{6}',
+        '029[1-9]\d{5}',
+        '0390\d{5}',
+        '0390\d{6}',
+        '039[1-9]\d{5}',
+    ];
+
+    public function mobileNumber(): string
+    {
+        $format = static::randomElement(static::$mobileFormats);
+
+        return static::regexify($format);
+    }
+
+    public function fixedLineNumber(): string
+    {
+        $format = static::randomElement(static::$fixedLineFormats);
+
+        return static::regexify($format);
+    }
+
+    public function e164PhoneNumber(): string
+    {
+        $format = static::randomElement(static::$e164Formats);
+
+        $phoneNumber = $this->generator->parse($format);
+
+        return preg_replace('/\+3830(\d+)/', '+383$1', $phoneNumber);
+    }
+}