diff --git a/api/composer.json b/api/composer.json
index 1e9cf1fa..bc63c185 100644
--- a/api/composer.json
+++ b/api/composer.json
@@ -3,16 +3,17 @@
"description": "API Multi-sites",
"type": "project",
"require": {
- "php": ">=8.1",
- "phpmailer/phpmailer": "^6.8",
- "ext-pdo": "*",
+ "php": ">=8.3",
+ "ext-json": "*",
"ext-openssl": "*",
- "ext-json": "*"
+ "ext-pdo": "*",
+ "phpmailer/phpmailer": "^6.8",
+ "phpoffice/phpspreadsheet": "^2.0"
},
"autoload": {
- "psr-4": {
- "App\\": "src/"
- }
+ "classmap": [
+ "src/"
+ ]
},
"config": {
"sort-packages": true,
diff --git a/api/composer.lock b/api/composer.lock
index be981f46..8aad9bae 100644
--- a/api/composer.lock
+++ b/api/composer.lock
@@ -4,20 +4,284 @@
"Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
"This file is @generated automatically"
],
- "content-hash": "03e608fa83a14a82b3f9223977e9674e",
+ "content-hash": "cf5e9de2a9687d04e4e094ad368ce366",
"packages": [
{
- "name": "phpmailer/phpmailer",
- "version": "v6.9.3",
+ "name": "composer/pcre",
+ "version": "3.3.2",
"source": {
"type": "git",
- "url": "https://github.com/PHPMailer/PHPMailer.git",
- "reference": "2f5c94fe7493efc213f643c23b1b1c249d40f47e"
+ "url": "https://github.com/composer/pcre.git",
+ "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/PHPMailer/PHPMailer/zipball/2f5c94fe7493efc213f643c23b1b1c249d40f47e",
- "reference": "2f5c94fe7493efc213f643c23b1b1c249d40f47e",
+ "url": "https://api.github.com/repos/composer/pcre/zipball/b2bed4734f0cc156ee1fe9c0da2550420d99a21e",
+ "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e",
+ "shasum": ""
+ },
+ "require": {
+ "php": "^7.4 || ^8.0"
+ },
+ "conflict": {
+ "phpstan/phpstan": "<1.11.10"
+ },
+ "require-dev": {
+ "phpstan/phpstan": "^1.12 || ^2",
+ "phpstan/phpstan-strict-rules": "^1 || ^2",
+ "phpunit/phpunit": "^8 || ^9"
+ },
+ "type": "library",
+ "extra": {
+ "phpstan": {
+ "includes": [
+ "extension.neon"
+ ]
+ },
+ "branch-alias": {
+ "dev-main": "3.x-dev"
+ }
+ },
+ "autoload": {
+ "psr-4": {
+ "Composer\\Pcre\\": "src"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Jordi Boggiano",
+ "email": "j.boggiano@seld.be",
+ "homepage": "http://seld.be"
+ }
+ ],
+ "description": "PCRE wrapping library that offers type-safe preg_* replacements.",
+ "keywords": [
+ "PCRE",
+ "preg",
+ "regex",
+ "regular expression"
+ ],
+ "support": {
+ "issues": "https://github.com/composer/pcre/issues",
+ "source": "https://github.com/composer/pcre/tree/3.3.2"
+ },
+ "funding": [
+ {
+ "url": "https://packagist.com",
+ "type": "custom"
+ },
+ {
+ "url": "https://github.com/composer",
+ "type": "github"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/composer/composer",
+ "type": "tidelift"
+ }
+ ],
+ "time": "2024-11-12T16:29:46+00:00"
+ },
+ {
+ "name": "maennchen/zipstream-php",
+ "version": "3.1.2",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/maennchen/ZipStream-PHP.git",
+ "reference": "aeadcf5c412332eb426c0f9b4485f6accba2a99f"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/maennchen/ZipStream-PHP/zipball/aeadcf5c412332eb426c0f9b4485f6accba2a99f",
+ "reference": "aeadcf5c412332eb426c0f9b4485f6accba2a99f",
+ "shasum": ""
+ },
+ "require": {
+ "ext-mbstring": "*",
+ "ext-zlib": "*",
+ "php-64bit": "^8.2"
+ },
+ "require-dev": {
+ "brianium/paratest": "^7.7",
+ "ext-zip": "*",
+ "friendsofphp/php-cs-fixer": "^3.16",
+ "guzzlehttp/guzzle": "^7.5",
+ "mikey179/vfsstream": "^1.6",
+ "php-coveralls/php-coveralls": "^2.5",
+ "phpunit/phpunit": "^11.0",
+ "vimeo/psalm": "^6.0"
+ },
+ "suggest": {
+ "guzzlehttp/psr7": "^2.4",
+ "psr/http-message": "^2.0"
+ },
+ "type": "library",
+ "autoload": {
+ "psr-4": {
+ "ZipStream\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Paul Duncan",
+ "email": "pabs@pablotron.org"
+ },
+ {
+ "name": "Jonatan Männchen",
+ "email": "jonatan@maennchen.ch"
+ },
+ {
+ "name": "Jesse Donat",
+ "email": "donatj@gmail.com"
+ },
+ {
+ "name": "András Kolesár",
+ "email": "kolesar@kolesar.hu"
+ }
+ ],
+ "description": "ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.",
+ "keywords": [
+ "stream",
+ "zip"
+ ],
+ "support": {
+ "issues": "https://github.com/maennchen/ZipStream-PHP/issues",
+ "source": "https://github.com/maennchen/ZipStream-PHP/tree/3.1.2"
+ },
+ "funding": [
+ {
+ "url": "https://github.com/maennchen",
+ "type": "github"
+ }
+ ],
+ "time": "2025-01-27T12:07:53+00:00"
+ },
+ {
+ "name": "markbaker/complex",
+ "version": "3.0.2",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/MarkBaker/PHPComplex.git",
+ "reference": "95c56caa1cf5c766ad6d65b6344b807c1e8405b9"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/MarkBaker/PHPComplex/zipball/95c56caa1cf5c766ad6d65b6344b807c1e8405b9",
+ "reference": "95c56caa1cf5c766ad6d65b6344b807c1e8405b9",
+ "shasum": ""
+ },
+ "require": {
+ "php": "^7.2 || ^8.0"
+ },
+ "require-dev": {
+ "dealerdirect/phpcodesniffer-composer-installer": "dev-master",
+ "phpcompatibility/php-compatibility": "^9.3",
+ "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0",
+ "squizlabs/php_codesniffer": "^3.7"
+ },
+ "type": "library",
+ "autoload": {
+ "psr-4": {
+ "Complex\\": "classes/src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Mark Baker",
+ "email": "mark@lange.demon.co.uk"
+ }
+ ],
+ "description": "PHP Class for working with complex numbers",
+ "homepage": "https://github.com/MarkBaker/PHPComplex",
+ "keywords": [
+ "complex",
+ "mathematics"
+ ],
+ "support": {
+ "issues": "https://github.com/MarkBaker/PHPComplex/issues",
+ "source": "https://github.com/MarkBaker/PHPComplex/tree/3.0.2"
+ },
+ "time": "2022-12-06T16:21:08+00:00"
+ },
+ {
+ "name": "markbaker/matrix",
+ "version": "3.0.1",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/MarkBaker/PHPMatrix.git",
+ "reference": "728434227fe21be27ff6d86621a1b13107a2562c"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/MarkBaker/PHPMatrix/zipball/728434227fe21be27ff6d86621a1b13107a2562c",
+ "reference": "728434227fe21be27ff6d86621a1b13107a2562c",
+ "shasum": ""
+ },
+ "require": {
+ "php": "^7.1 || ^8.0"
+ },
+ "require-dev": {
+ "dealerdirect/phpcodesniffer-composer-installer": "dev-master",
+ "phpcompatibility/php-compatibility": "^9.3",
+ "phpdocumentor/phpdocumentor": "2.*",
+ "phploc/phploc": "^4.0",
+ "phpmd/phpmd": "2.*",
+ "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0",
+ "sebastian/phpcpd": "^4.0",
+ "squizlabs/php_codesniffer": "^3.7"
+ },
+ "type": "library",
+ "autoload": {
+ "psr-4": {
+ "Matrix\\": "classes/src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Mark Baker",
+ "email": "mark@demon-angel.eu"
+ }
+ ],
+ "description": "PHP Class for working with matrices",
+ "homepage": "https://github.com/MarkBaker/PHPMatrix",
+ "keywords": [
+ "mathematics",
+ "matrix",
+ "vector"
+ ],
+ "support": {
+ "issues": "https://github.com/MarkBaker/PHPMatrix/issues",
+ "source": "https://github.com/MarkBaker/PHPMatrix/tree/3.0.1"
+ },
+ "time": "2022-12-02T22:17:43+00:00"
+ },
+ {
+ "name": "phpmailer/phpmailer",
+ "version": "v6.10.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/PHPMailer/PHPMailer.git",
+ "reference": "bf74d75a1fde6beaa34a0ddae2ec5fce0f72a144"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/PHPMailer/PHPMailer/zipball/bf74d75a1fde6beaa34a0ddae2ec5fce0f72a144",
+ "reference": "bf74d75a1fde6beaa34a0ddae2ec5fce0f72a144",
"shasum": ""
},
"require": {
@@ -77,7 +341,7 @@
"description": "PHPMailer is a full-featured email creation and transfer class for PHP",
"support": {
"issues": "https://github.com/PHPMailer/PHPMailer/issues",
- "source": "https://github.com/PHPMailer/PHPMailer/tree/v6.9.3"
+ "source": "https://github.com/PHPMailer/PHPMailer/tree/v6.10.0"
},
"funding": [
{
@@ -85,7 +349,323 @@
"type": "github"
}
],
- "time": "2024-11-24T18:04:13+00:00"
+ "time": "2025-04-24T15:19:31+00:00"
+ },
+ {
+ "name": "phpoffice/phpspreadsheet",
+ "version": "2.3.8",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/PHPOffice/PhpSpreadsheet.git",
+ "reference": "7a700683743bf1c4a21837c84b266916f1aa7d25"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/PHPOffice/PhpSpreadsheet/zipball/7a700683743bf1c4a21837c84b266916f1aa7d25",
+ "reference": "7a700683743bf1c4a21837c84b266916f1aa7d25",
+ "shasum": ""
+ },
+ "require": {
+ "composer/pcre": "^1 || ^2 || ^3",
+ "ext-ctype": "*",
+ "ext-dom": "*",
+ "ext-fileinfo": "*",
+ "ext-gd": "*",
+ "ext-iconv": "*",
+ "ext-libxml": "*",
+ "ext-mbstring": "*",
+ "ext-simplexml": "*",
+ "ext-xml": "*",
+ "ext-xmlreader": "*",
+ "ext-xmlwriter": "*",
+ "ext-zip": "*",
+ "ext-zlib": "*",
+ "maennchen/zipstream-php": "^2.1 || ^3.0",
+ "markbaker/complex": "^3.0",
+ "markbaker/matrix": "^3.0",
+ "php": "^8.1",
+ "psr/http-client": "^1.0",
+ "psr/http-factory": "^1.0",
+ "psr/simple-cache": "^1.0 || ^2.0 || ^3.0"
+ },
+ "require-dev": {
+ "dealerdirect/phpcodesniffer-composer-installer": "dev-main",
+ "dompdf/dompdf": "^2.0 || ^3.0",
+ "friendsofphp/php-cs-fixer": "^3.2",
+ "mitoteam/jpgraph": "^10.3",
+ "mpdf/mpdf": "^8.1.1",
+ "phpcompatibility/php-compatibility": "^9.3",
+ "phpstan/phpstan": "^1.1",
+ "phpstan/phpstan-phpunit": "^1.0",
+ "phpunit/phpunit": "^9.6 || ^10.5",
+ "squizlabs/php_codesniffer": "^3.7",
+ "tecnickcom/tcpdf": "^6.5"
+ },
+ "suggest": {
+ "dompdf/dompdf": "Option for rendering PDF with PDF Writer",
+ "ext-intl": "PHP Internationalization Functions",
+ "mitoteam/jpgraph": "Option for rendering charts, or including charts with PDF or HTML Writers",
+ "mpdf/mpdf": "Option for rendering PDF with PDF Writer",
+ "tecnickcom/tcpdf": "Option for rendering PDF with PDF Writer"
+ },
+ "type": "library",
+ "autoload": {
+ "psr-4": {
+ "PhpOffice\\PhpSpreadsheet\\": "src/PhpSpreadsheet"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Maarten Balliauw",
+ "homepage": "https://blog.maartenballiauw.be"
+ },
+ {
+ "name": "Mark Baker",
+ "homepage": "https://markbakeruk.net"
+ },
+ {
+ "name": "Franck Lefevre",
+ "homepage": "https://rootslabs.net"
+ },
+ {
+ "name": "Erik Tilt"
+ },
+ {
+ "name": "Adrien Crivelli"
+ }
+ ],
+ "description": "PHPSpreadsheet - Read, Create and Write Spreadsheet documents in PHP - Spreadsheet engine",
+ "homepage": "https://github.com/PHPOffice/PhpSpreadsheet",
+ "keywords": [
+ "OpenXML",
+ "excel",
+ "gnumeric",
+ "ods",
+ "php",
+ "spreadsheet",
+ "xls",
+ "xlsx"
+ ],
+ "support": {
+ "issues": "https://github.com/PHPOffice/PhpSpreadsheet/issues",
+ "source": "https://github.com/PHPOffice/PhpSpreadsheet/tree/2.3.8"
+ },
+ "time": "2025-02-08T03:01:45+00:00"
+ },
+ {
+ "name": "psr/http-client",
+ "version": "1.0.3",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/php-fig/http-client.git",
+ "reference": "bb5906edc1c324c9a05aa0873d40117941e5fa90"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/php-fig/http-client/zipball/bb5906edc1c324c9a05aa0873d40117941e5fa90",
+ "reference": "bb5906edc1c324c9a05aa0873d40117941e5fa90",
+ "shasum": ""
+ },
+ "require": {
+ "php": "^7.0 || ^8.0",
+ "psr/http-message": "^1.0 || ^2.0"
+ },
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "1.0.x-dev"
+ }
+ },
+ "autoload": {
+ "psr-4": {
+ "Psr\\Http\\Client\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "https://www.php-fig.org/"
+ }
+ ],
+ "description": "Common interface for HTTP clients",
+ "homepage": "https://github.com/php-fig/http-client",
+ "keywords": [
+ "http",
+ "http-client",
+ "psr",
+ "psr-18"
+ ],
+ "support": {
+ "source": "https://github.com/php-fig/http-client"
+ },
+ "time": "2023-09-23T14:17:50+00:00"
+ },
+ {
+ "name": "psr/http-factory",
+ "version": "1.1.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/php-fig/http-factory.git",
+ "reference": "2b4765fddfe3b508ac62f829e852b1501d3f6e8a"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/php-fig/http-factory/zipball/2b4765fddfe3b508ac62f829e852b1501d3f6e8a",
+ "reference": "2b4765fddfe3b508ac62f829e852b1501d3f6e8a",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=7.1",
+ "psr/http-message": "^1.0 || ^2.0"
+ },
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "1.0.x-dev"
+ }
+ },
+ "autoload": {
+ "psr-4": {
+ "Psr\\Http\\Message\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "https://www.php-fig.org/"
+ }
+ ],
+ "description": "PSR-17: Common interfaces for PSR-7 HTTP message factories",
+ "keywords": [
+ "factory",
+ "http",
+ "message",
+ "psr",
+ "psr-17",
+ "psr-7",
+ "request",
+ "response"
+ ],
+ "support": {
+ "source": "https://github.com/php-fig/http-factory"
+ },
+ "time": "2024-04-15T12:06:14+00:00"
+ },
+ {
+ "name": "psr/http-message",
+ "version": "2.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/php-fig/http-message.git",
+ "reference": "402d35bcb92c70c026d1a6a9883f06b2ead23d71"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/php-fig/http-message/zipball/402d35bcb92c70c026d1a6a9883f06b2ead23d71",
+ "reference": "402d35bcb92c70c026d1a6a9883f06b2ead23d71",
+ "shasum": ""
+ },
+ "require": {
+ "php": "^7.2 || ^8.0"
+ },
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "2.0.x-dev"
+ }
+ },
+ "autoload": {
+ "psr-4": {
+ "Psr\\Http\\Message\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "https://www.php-fig.org/"
+ }
+ ],
+ "description": "Common interface for HTTP messages",
+ "homepage": "https://github.com/php-fig/http-message",
+ "keywords": [
+ "http",
+ "http-message",
+ "psr",
+ "psr-7",
+ "request",
+ "response"
+ ],
+ "support": {
+ "source": "https://github.com/php-fig/http-message/tree/2.0"
+ },
+ "time": "2023-04-04T09:54:51+00:00"
+ },
+ {
+ "name": "psr/simple-cache",
+ "version": "3.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/php-fig/simple-cache.git",
+ "reference": "764e0b3939f5ca87cb904f570ef9be2d78a07865"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/php-fig/simple-cache/zipball/764e0b3939f5ca87cb904f570ef9be2d78a07865",
+ "reference": "764e0b3939f5ca87cb904f570ef9be2d78a07865",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=8.0.0"
+ },
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "3.0.x-dev"
+ }
+ },
+ "autoload": {
+ "psr-4": {
+ "Psr\\SimpleCache\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "https://www.php-fig.org/"
+ }
+ ],
+ "description": "Common interfaces for simple caching",
+ "keywords": [
+ "cache",
+ "caching",
+ "psr",
+ "psr-16",
+ "simple-cache"
+ ],
+ "support": {
+ "source": "https://github.com/php-fig/simple-cache/tree/3.0.0"
+ },
+ "time": "2021-10-29T13:26:27+00:00"
}
],
"packages-dev": [],
@@ -95,10 +675,10 @@
"prefer-stable": false,
"prefer-lowest": false,
"platform": {
- "php": ">=8.1",
- "ext-pdo": "*",
+ "php": ">=8.3",
+ "ext-json": "*",
"ext-openssl": "*",
- "ext-json": "*"
+ "ext-pdo": "*"
},
"platform-dev": {},
"plugin-api-version": "2.6.0"
diff --git a/api/deploy-api.sh b/api/deploy-api.sh
index b70a6761..825e75de 100755
--- a/api/deploy-api.sh
+++ b/api/deploy-api.sh
@@ -128,6 +128,12 @@ $SSH_JUMP_CMD "
incus exec ${INCUS_CONTAINER} -- chmod -R 775 ${FINAL_PATH}/logs || exit 1
incus exec ${INCUS_CONTAINER} -- find ${FINAL_PATH}/logs -type f -exec chmod 664 {} \; || exit 1
+ echo '📁 Création des dossiers uploads...'
+ incus exec ${INCUS_CONTAINER} -- mkdir -p ${FINAL_PATH}/uploads || exit 1
+ incus exec ${INCUS_CONTAINER} -- chown -R ${FINAL_OWNER}:${FINAL_OWNER_LOGS} ${FINAL_PATH}/uploads || exit 1
+ incus exec ${INCUS_CONTAINER} -- chmod -R 775 ${FINAL_PATH}/uploads || exit 1
+ incus exec ${INCUS_CONTAINER} -- find ${FINAL_PATH}/uploads -type f -exec chmod -R 664 {} \; || exit 1
+
echo '🧹 Nettoyage...'
incus exec ${INCUS_CONTAINER} -- rm -f /tmp/${ARCHIVE_NAME} || exit 1
rm -f /tmp/${ARCHIVE_NAME} || exit 1
diff --git a/api/docs/EXPORT-SYSTEM.md b/api/docs/EXPORT-SYSTEM.md
new file mode 100644
index 00000000..5f9134b5
--- /dev/null
+++ b/api/docs/EXPORT-SYSTEM.md
@@ -0,0 +1,276 @@
+# Système d'Export/Import d'Opérations - Geosector API
+
+## Vue d'ensemble
+
+Le système d'export/import permet de sauvegarder et restaurer des opérations complètes avec toutes leurs données associées (passages, utilisateurs, secteurs, relations).
+
+## Architecture
+
+### Routes API
+
+#### Exports
+
+- `GET /api/operations/{id}/export/excel` - Export Excel (consultation)
+- `GET /api/operations/{id}/export/json` - Export JSON (sauvegarde)
+- `GET /api/operations/{id}/export/full` - Export combiné (Excel + JSON)
+
+#### Gestion des sauvegardes
+
+- `GET /api/operations/{id}/backups` - Liste des sauvegardes
+- `GET /api/operations/{id}/backups/{backup_id}` - Télécharger une sauvegarde
+- `DELETE /api/operations/{id}/backups/{backup_id}` - Supprimer une sauvegarde
+
+### Structure des fichiers
+
+```
+uploads/entites/{entite_id}/operations/{operation_id}/documents/exports/
+├── excel/
+│ └── geosector-export-{operation_id}-{timestamp}.xlsx
+└── json/
+ └── geosector-backup-{operation_id}-{type}-{timestamp}.json
+```
+
+## Export Excel
+
+### Contenu
+
+Le fichier Excel contient 4 feuilles :
+
+#### 1. Feuille "Passages"
+
+- **Colonnes** : ID_Passage, Date, Heure, Prénom, Nom, Tournée, Type, N°, Rue, Ville, Habitat, Donateur, Email, Tél, Montant, Règlement, Remarque, FK_User, FK_Sector, FK_Operation
+- **Données déchiffrées** : Noms, emails, téléphones
+- **Formatage** : Dates françaises (dd/mm/yyyy), types traduits
+
+#### 2. Feuille "Utilisateurs"
+
+- **Colonnes** : ID_User, Nom, Prénom, Email, Téléphone, Mobile, Rôle, Date_création, Actif, FK_Entite
+- **Données déchiffrées** : Informations personnelles
+
+#### 3. Feuille "Secteurs"
+
+- **Colonnes** : ID_Sector, Libellé, Couleur, Date_création, Actif, FK_Operation
+
+#### 4. Feuille "Secteurs-Utilisateurs"
+
+- **Colonnes** : ID_Relation, FK_Sector, Nom_Secteur, FK_User, Nom_Utilisateur, Date_assignation, FK_Operation
+
+### Paramètres optionnels
+
+- `?user_id={id}` - Filtrer les passages par utilisateur
+
+### Exemple d'utilisation
+
+```bash
+# Export complet
+GET /api/operations/2644/export/excel
+
+# Export filtré par utilisateur
+GET /api/operations/2644/export/excel?user_id=123
+```
+
+## Export JSON
+
+### Structure du fichier JSON
+
+```json
+{
+ "export_metadata": {
+ "version": "1.0",
+ "export_date": "2025-06-21T16:19:23Z",
+ "source_entite_id": 5,
+ "export_type": "full_operation"
+ },
+ "operation": {
+ "id": 2644,
+ "libelle": "OPE 2024-25",
+ "date_deb": "2024-09-01",
+ "date_fin": "2025-05-30",
+ "fk_entite": 5,
+ "chk_distinct_sectors": 1,
+ "created_at": "2024-08-15T10:00:00Z"
+ },
+ "users": [...],
+ "sectors": [...],
+ "passages": [...],
+ "user_sectors": [...]
+}
+```
+
+### Types d'export JSON
+
+- **manual** : Export à la demande (par défaut)
+- **auto** : Sauvegarde automatique (avant modifications importantes)
+
+### Paramètres
+
+- `?type=manual|auto` - Type d'export
+
+## Sécurité
+
+### Contrôles d'accès
+
+- ✅ Authentification obligatoire
+- ✅ Vérification d'appartenance à l'entité
+- ✅ Isolation des données par entité
+- ✅ Logs détaillés de toutes les opérations
+
+### Données sensibles
+
+- ✅ Chiffrement/déchiffrement automatique
+- ✅ Données personnelles protégées
+- ✅ Pas d'exposition des clés de chiffrement
+
+## Stockage et organisation
+
+### Enregistrement en base
+
+Tous les fichiers sont enregistrés dans la table `medias` :
+
+```sql
+support = 'operation'
+support_id = {operation_id}
+file_type = 'xlsx' | 'json'
+description = 'Export Excel opération - {libelle}'
+```
+
+### Métadonnées des fichiers
+
+- **ID** : Identifiant unique en base
+- **Filename** : Nom du fichier généré
+- **Path** : Chemin relatif depuis la racine
+- **Size** : Taille en octets
+- **Type** : excel | json
+
+## Exemples de réponses API
+
+### Export Excel réussi
+
+```json
+{
+ "status": "success",
+ "message": "Export Excel généré avec succès",
+ "file": {
+ "id": 123,
+ "filename": "geosector-export-2644-20250621-161923.xlsx",
+ "path": "uploads/entites/5/operations/2644/documents/exports/excel/geosector-export-2644-20250621-161923.xlsx",
+ "size": 45678,
+ "type": "excel"
+ }
+}
+```
+
+### Export complet réussi
+
+```json
+{
+ "status": "success",
+ "message": "Export complet généré avec succès",
+ "files": {
+ "excel": {
+ "id": 123,
+ "filename": "geosector-export-2644-20250621-161923.xlsx",
+ "path": "uploads/entites/5/operations/2644/documents/exports/excel/geosector-export-2644-20250621-161923.xlsx",
+ "size": 45678,
+ "type": "excel"
+ },
+ "json": {
+ "id": 124,
+ "filename": "geosector-backup-2644-manual-20250621-161923.json",
+ "path": "uploads/entites/5/operations/2644/documents/exports/json/geosector-backup-2644-manual-20250621-161923.json",
+ "size": 12345,
+ "type": "json"
+ }
+ }
+}
+```
+
+### Liste des sauvegardes
+
+```json
+{
+ "status": "success",
+ "backups": [
+ {
+ "id": 124,
+ "fichier": "geosector-backup-2644-manual-20250621-161923.json",
+ "file_type": "json",
+ "file_size": 12345,
+ "description": "Sauvegarde JSON opération - manual - OPE 2024-25",
+ "created_at": "2025-06-21 16:19:23",
+ "fk_user_creat": 1
+ },
+ {
+ "id": 123,
+ "fichier": "geosector-export-2644-20250621-161923.xlsx",
+ "file_type": "xlsx",
+ "file_size": 45678,
+ "description": "Export Excel opération - OPE 2024-25",
+ "created_at": "2025-06-21 16:19:23",
+ "fk_user_creat": 1
+ }
+ ]
+}
+```
+
+## Installation et dépendances
+
+### PhpSpreadsheet
+
+```bash
+composer require phpoffice/phpspreadsheet
+```
+
+### Permissions de dossiers
+
+```bash
+chmod 755 uploads/
+chmod 755 uploads/entites/
+```
+
+## Gestion des erreurs
+
+### Erreurs courantes
+
+- **401** : Non authentifié
+- **403** : Pas d'accès à l'entité
+- **404** : Opération non trouvée
+- **500** : Erreur de génération
+
+### Logs
+
+Tous les événements sont loggés via `LogService` :
+
+- Exports réussis (level: info)
+- Erreurs de génération (level: error)
+- Tentatives d'accès non autorisées (level: warning)
+
+## Maintenance
+
+### Nettoyage automatique (à implémenter)
+
+- Sauvegardes auto > 30 jours
+- Fichiers temporaires > 24h
+- Vérification cohérence base/fichiers
+
+### Monitoring
+
+- Espace disque utilisé
+- Nombre de fichiers par entité
+- Fréquence des exports
+
+## Évolutions futures
+
+### Import/Restauration
+
+- Validation des fichiers JSON
+- Import transactionnel
+- Gestion des conflits d'IDs
+- Mapping entités source/cible
+
+### Optimisations
+
+- Compression des fichiers
+- Export asynchrone pour gros volumes
+- Cache des exports fréquents
+- API de streaming pour téléchargements
diff --git a/api/docs/FILE-SYSTEM-API.md b/api/docs/FILE-SYSTEM-API.md
new file mode 100644
index 00000000..a8b155cf
--- /dev/null
+++ b/api/docs/FILE-SYSTEM-API.md
@@ -0,0 +1,376 @@
+# API de Gestion des Fichiers - Geosector
+
+## Vue d'ensemble
+
+L'API de gestion des fichiers permet aux administrateurs de naviguer, rechercher et gérer les fichiers stockés dans l'application Geosector avec des contrôles d'accès basés sur les rôles.
+
+## Contrôles d'accès
+
+### Rôle 2 (Admin d'entité)
+
+- Accès limité aux fichiers de son entité uniquement
+- Chemin racine : `/uploads/entites/{son_entite_id}/`
+- Peut naviguer dans tous les sous-dossiers de son entité
+
+### Rôle > 2 (Super admin)
+
+- Accès complet à tous les fichiers
+- Chemin racine : `/uploads/` (accès total)
+- Peut naviguer dans toutes les entités et dossiers système
+
+## Routes disponibles
+
+### Navigation et listing
+
+#### `GET /api/files/browse`
+
+Navigation dans l'arborescence avec recherche et pagination.
+
+**Paramètres de requête :**
+
+- `path` (string) : Chemin à explorer (ex: `entites/5/operations`)
+- `page` (int) : Page (défaut: 1)
+- `per_page` (int) : Éléments par page (défaut: 50, max: 100)
+- `search` (string) : Recherche dans nom, nom original, description
+- `type` (string) : Filtrage par extension (pdf, jpg, xlsx, etc.)
+- `category` (string) : Filtrage par catégorie métier
+- `sort` (string) : Tri (name, date, size, type) - défaut: date
+- `order` (string) : Ordre (asc, desc) - défaut: desc
+
+**Exemple :**
+
+```bash
+GET /api/files/browse?path=entites/5/operations&search=2024&type=xlsx&page=1
+```
+
+**Réponse :**
+
+```json
+{
+ "status": "success",
+ "current_path": "entites/5/operations",
+ "parent_path": "entites/5",
+ "pagination": {
+ "current_page": 1,
+ "per_page": 50,
+ "total_items": 127,
+ "total_pages": 3,
+ "has_next": true,
+ "has_prev": false
+ },
+ "filters": {
+ "search": "2024",
+ "type": "xlsx",
+ "category": null,
+ "sort": "date",
+ "order": "desc"
+ },
+ "files": [
+ {
+ "id": 123,
+ "fichier": "planning_2024_op2644.xlsx",
+ "original_name": "Planning Opération 2024.xlsx",
+ "file_type": "xlsx",
+ "file_category": "planning",
+ "description": "Planning détaillé opération 2024",
+ "file_size": 1024000,
+ "file_path": "entites/5/operations/2644/documents/planning_2024_op2644.xlsx",
+ "created_at": "2025-06-22 08:30:00",
+ "creator_name": "Jean Dupont"
+ }
+ ],
+ "summary": {
+ "total_files": 45,
+ "total_size": 25600000,
+ "by_category": {
+ "planning": 12,
+ "export": 20,
+ "backup": 13
+ }
+ }
+}
+```
+
+#### `GET /api/files/list/{support}/{id}`
+
+Liste des fichiers par support (entite, user, operation, passage).
+
+**Paramètres :**
+
+- `support` : Type de support (entite, user, operation, passage)
+- `id` : ID de l'élément
+- Mêmes paramètres de requête que `/browse`
+
+**Exemple :**
+
+```bash
+GET /api/files/list/operation/2644?category=export&page=1
+```
+
+### Recherche
+
+#### `GET /api/files/search`
+
+Recherche globale dans tous les fichiers accessibles.
+
+**Paramètres de requête :**
+
+- `q` (string, requis) : Terme de recherche
+- `page`, `per_page`, `type`, `category`, `sort`, `order` : Mêmes que browse
+
+**Exemple :**
+
+```bash
+GET /api/files/search?q=planning&type=xlsx&category=planning
+```
+
+### Actions sur fichiers
+
+#### `GET /api/files/download/{id}`
+
+Téléchargement sécurisé d'un fichier.
+
+**Réponse :** Fichier en téléchargement direct avec headers appropriés.
+
+#### `DELETE /api/files/{id}`
+
+Suppression sécurisée d'un fichier (physique + base de données).
+
+**Réponse :**
+
+```json
+{
+ "status": "success",
+ "message": "Fichier supprimé avec succès"
+}
+```
+
+#### `GET /api/files/info/{id}`
+
+Informations détaillées d'un fichier.
+
+**Réponse :**
+
+```json
+{
+ "status": "success",
+ "file": {
+ "id": 123,
+ "fichier": "planning_2024.xlsx",
+ "original_name": "Planning Opération 2024.xlsx",
+ "file_type": "xlsx",
+ "file_category": "planning",
+ "file_size": 1024000,
+ "mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+ "description": "Planning détaillé",
+ "support": "operation",
+ "support_id": 2644,
+ "fk_entite": 5,
+ "created_at": "2025-06-22 08:30:00",
+ "updated_at": "2025-06-22 08:30:00",
+ "creator_name": "Jean Dupont",
+ "modifier_name": null,
+ "file_exists": true
+ }
+}
+```
+
+### Statistiques
+
+#### `GET /api/files/stats`
+
+Statistiques d'utilisation des fichiers.
+
+**Pour admin d'entité (rôle 2) :**
+
+```json
+{
+ "status": "success",
+ "entite_id": 5,
+ "storage": {
+ "total_files": 245,
+ "total_size": 157286400,
+ "by_support": {
+ "entite": { "count": 12, "size": 45000000 },
+ "operation": { "count": 180, "size": 98000000 },
+ "user": { "count": 45, "size": 12000000 },
+ "passage": { "count": 8, "size": 2286400 }
+ },
+ "by_category": {
+ "document": 25,
+ "export": 120,
+ "avatar": 45,
+ "photo": 55
+ },
+ "by_type": {
+ "xlsx": 85,
+ "jpg": 120,
+ "pdf": 40
+ }
+ }
+}
+```
+
+**Pour super admin (rôle > 2) :**
+
+```json
+{
+ "status": "success",
+ "global_stats": {
+ "total_files": 2450,
+ "total_size": 1572864000,
+ "entites_count": 25,
+ "by_entite": [
+ { "entite_id": 5, "files": 245, "size": 157286400 },
+ { "entite_id": 12, "files": 180, "size": 98000000 }
+ ]
+ }
+}
+```
+
+### Métadonnées
+
+#### `GET /api/files/metadata`
+
+Informations sur les catégories, extensions et limites autorisées.
+
+**Réponse :**
+
+```json
+{
+ "status": "success",
+ "categories": {
+ "entite": ["logo", "document", "reglement", "statut"],
+ "user": ["avatar", "photo"],
+ "operation": ["planning", "liste", "export", "backup"],
+ "passage": ["recu", "photo", "justificatif", "carte"]
+ },
+ "extensions": ["pdf", "jpg", "jpeg", "png", "gif", "webp", "xlsx", "xls", "json", "csv"],
+ "mime_types": {
+ "pdf": "application/pdf",
+ "jpg": "image/jpeg",
+ "xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
+ },
+ "max_file_sizes": {
+ "entite": 20971520, // 20 MB
+ "user": 5242880, // 5 MB
+ "operation": 20971520, // 20 MB
+ "passage": 10485760 // 10 MB
+ }
+}
+```
+
+## Catégories de fichiers
+
+### Distinction Extension vs Catégorie
+
+- **Extension** (`file_type`) : Type technique (pdf, jpg, xlsx, png, etc.)
+- **Catégorie** (`file_category`) : Type métier (logo, carte, photo, document, planning, etc.)
+
+### Catégories par support
+
+#### Entité
+
+- `logo` : Logo de l'entité
+- `document` : Documents généraux
+- `reglement` : Règlements internes
+- `statut` : Statuts de l'entité
+
+#### Utilisateur
+
+- `avatar` : Photo de profil
+- `photo` : Photos diverses
+
+#### Opération
+
+- `planning` : Plannings d'opération
+- `liste` : Listes diverses
+- `export` : Exports de données
+- `backup` : Sauvegardes automatiques
+
+#### Passage
+
+- `recu` : Reçus de passage
+- `photo` : Photos de passage
+- `justificatif` : Justificatifs divers
+- `carte` : Cartes et plans
+
+## Sécurité
+
+### Validation des chemins
+
+- Empêche les traversées de répertoire (`../`)
+- Validation stricte selon le rôle utilisateur
+- Contrôle d'accès au niveau fichier
+
+### Logs
+
+- Tous les téléchargements sont loggés
+- Toutes les suppressions sont tracées
+- Erreurs d'accès enregistrées
+
+### Contrôles d'intégrité
+
+- Vérification de l'existence physique des fichiers
+- Validation des permissions avant chaque action
+- Contrôle de cohérence base/fichiers
+
+## Exemples d'utilisation
+
+### Navigation dans les opérations d'une entité
+
+```bash
+GET /api/files/browse?path=entites/5/operations&sort=name&order=asc
+```
+
+### Recherche de tous les exports Excel
+
+```bash
+GET /api/files/search?q=export&type=xlsx&category=export
+```
+
+### Statistiques de stockage
+
+```bash
+GET /api/files/stats
+```
+
+### Téléchargement d'un fichier
+
+```bash
+GET /api/files/download/123
+```
+
+### Suppression d'un fichier
+
+```bash
+DELETE /api/files/123
+```
+
+## Codes d'erreur
+
+- **401** : Non authentifié
+- **403** : Accès refusé (rôle insuffisant ou fichier d'une autre entité)
+- **404** : Fichier ou chemin non trouvé
+- **400** : Paramètres invalides (terme de recherche manquant, etc.)
+- **500** : Erreur serveur
+
+## Migration base de données
+
+Pour utiliser le système, exécuter la migration :
+
+```sql
+-- Ajout de la colonne file_category
+ALTER TABLE `medias`
+ADD COLUMN `file_category` varchar(50) DEFAULT NULL COMMENT 'Catégorie du fichier (logo, carte, photo, document, etc.)' AFTER `file_type`;
+
+-- Index pour optimiser les requêtes
+ALTER TABLE `medias`
+ADD INDEX `idx_file_category` (`file_category`);
+```
+
+---
+
+**Version** : 1.0
+**Date** : Juin 2025
+**Auteur** : API Geosector Team
diff --git a/api/docs/README-UPLOAD.md b/api/docs/README-UPLOAD.md
new file mode 100644
index 00000000..981a5c3a
--- /dev/null
+++ b/api/docs/README-UPLOAD.md
@@ -0,0 +1,339 @@
+# Système de Gestion des Fichiers - API Geosector
+
+## Vue d'ensemble
+
+Ce document décrit l'organisation et la gestion des fichiers uploadés dans l'API Geosector. Le système permet de stocker et organiser différents types de fichiers par entité, utilisateur, opération et passage.
+
+## Structure des Dossiers
+
+```
+uploads/
+├── entites/
+│ ├── {entite_id}/
+│ │ ├── documents/ # PDF, Excel généraux de l'entité
+│ │ ├── images/ # Images de l'entité
+│ │ ├── users/ # Dossier pour les fichiers des utilisateurs
+│ │ │ └── {user_id}/ # Images par utilisateur (avatars, etc.)
+│ │ └── operations/ # Dossier pour les opérations
+│ │ └── {operation_id}/
+│ │ ├── documents/ # Fichiers Excel de l'opération
+│ │ └── passages/ # Fichiers des passages de cette opération
+│ │ └── {passage_id}/ # PDF et images par passage
+│ └── temp/ # Fichiers temporaires avant validation
+```
+
+### Exemples de chemins
+
+- Document d'entité : `uploads/entites/5/documents/reglement_2024.pdf`
+- Avatar utilisateur : `uploads/entites/5/users/123/avatar.jpg`
+- Excel d'opération : `uploads/entites/5/operations/2644/documents/planning.xlsx`
+- Photo de passage : `uploads/entites/5/operations/2644/passages/789/photo_1.jpg`
+
+## Structure de la Table `medias`
+
+### Table existante enrichie
+
+```sql
+-- Structure complète de la table medias
+CREATE TABLE `medias` (
+ `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
+ `support` varchar(45) NOT NULL DEFAULT '' COMMENT 'Type de support (entite, user, operation, passage)',
+ `support_id` int(10) unsigned NOT NULL DEFAULT 0 COMMENT 'ID de l\'élément associé',
+ `fichier` varchar(250) NOT NULL DEFAULT '' COMMENT 'Nom du fichier stocké',
+ `file_type` varchar(50) DEFAULT NULL COMMENT 'Extension du fichier (pdf, jpg, xlsx, etc.)',
+ `file_size` int(10) unsigned DEFAULT NULL COMMENT 'Taille du fichier en octets',
+ `mime_type` varchar(100) DEFAULT NULL COMMENT 'Type MIME du fichier',
+ `original_name` varchar(255) DEFAULT NULL COMMENT 'Nom original du fichier uploadé',
+ `fk_entite` int(10) unsigned DEFAULT NULL COMMENT 'ID de l\'entité propriétaire',
+ `fk_operation` int(10) unsigned DEFAULT NULL COMMENT 'ID de l\'opération (pour passages)',
+ `file_path` varchar(500) DEFAULT NULL COMMENT 'Chemin complet du fichier',
+ `original_width` int(10) unsigned DEFAULT NULL COMMENT 'Largeur originale de l\'image',
+ `original_height` int(10) unsigned DEFAULT NULL COMMENT 'Hauteur originale de l\'image',
+ `processed_width` int(10) unsigned DEFAULT NULL COMMENT 'Largeur après traitement',
+ `processed_height` int(10) unsigned DEFAULT NULL COMMENT 'Hauteur après traitement',
+ `is_processed` tinyint(1) unsigned DEFAULT 0 COMMENT 'Image redimensionnée (1) ou originale (0)',
+ `description` varchar(100) NOT NULL DEFAULT '' COMMENT 'Description du fichier',
+ `created_at` timestamp NOT NULL DEFAULT current_timestamp(),
+ `fk_user_creat` int(10) unsigned NOT NULL DEFAULT 0,
+ `updated_at` timestamp NULL DEFAULT NULL ON UPDATE current_timestamp(),
+ `fk_user_modif` int(10) unsigned NOT NULL DEFAULT 0,
+ PRIMARY KEY (`id`),
+ UNIQUE KEY `id_UNIQUE` (`id`),
+ KEY `idx_entite` (`fk_entite`),
+ KEY `idx_operation` (`fk_operation`),
+ KEY `idx_support_type` (`support`, `support_id`),
+ KEY `idx_file_type` (`file_type`),
+ CONSTRAINT `fk_medias_entite` FOREIGN KEY (`fk_entite`) REFERENCES `entites` (`id`) ON UPDATE CASCADE ON DELETE CASCADE,
+ CONSTRAINT `fk_medias_operation` FOREIGN KEY (`fk_operation`) REFERENCES `operations` (`id`) ON UPDATE CASCADE ON DELETE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+```
+
+### Migration SQL pour table existante
+
+```sql
+-- Ajout des nouvelles colonnes à la table existante
+ALTER TABLE `medias`
+ADD COLUMN `file_type` varchar(50) DEFAULT NULL COMMENT 'Extension du fichier (pdf, jpg, xlsx, etc.)' AFTER `fichier`,
+ADD COLUMN `file_size` int(10) unsigned DEFAULT NULL COMMENT 'Taille du fichier en octets' AFTER `file_type`,
+ADD COLUMN `mime_type` varchar(100) DEFAULT NULL COMMENT 'Type MIME du fichier' AFTER `file_size`,
+ADD COLUMN `original_name` varchar(255) DEFAULT NULL COMMENT 'Nom original du fichier uploadé' AFTER `mime_type`,
+ADD COLUMN `fk_entite` int(10) unsigned DEFAULT NULL COMMENT 'ID de l\'entité propriétaire' AFTER `support_id`,
+ADD COLUMN `fk_operation` int(10) unsigned DEFAULT NULL COMMENT 'ID de l\'opération (pour passages)' AFTER `fk_entite`,
+ADD COLUMN `file_path` varchar(500) DEFAULT NULL COMMENT 'Chemin complet du fichier' AFTER `original_name`,
+ADD COLUMN `original_width` int(10) unsigned DEFAULT NULL COMMENT 'Largeur originale de l\'image' AFTER `file_path`,
+ADD COLUMN `original_height` int(10) unsigned DEFAULT NULL COMMENT 'Hauteur originale de l\'image' AFTER `original_width`,
+ADD COLUMN `processed_width` int(10) unsigned DEFAULT NULL COMMENT 'Largeur après traitement' AFTER `original_height`,
+ADD COLUMN `processed_height` int(10) unsigned DEFAULT NULL COMMENT 'Hauteur après traitement' AFTER `processed_width`,
+ADD COLUMN `is_processed` tinyint(1) unsigned DEFAULT 0 COMMENT 'Image redimensionnée (1) ou originale (0)' AFTER `processed_height`;
+
+-- Ajout des index pour optimiser les requêtes
+ALTER TABLE `medias`
+ADD INDEX `idx_entite` (`fk_entite`),
+ADD INDEX `idx_operation` (`fk_operation`),
+ADD INDEX `idx_support_type` (`support`, `support_id`),
+ADD INDEX `idx_file_type` (`file_type`);
+
+-- Ajout des contraintes de clés étrangères
+ALTER TABLE `medias`
+ADD CONSTRAINT `fk_medias_entite` FOREIGN KEY (`fk_entite`) REFERENCES `entites` (`id`) ON UPDATE CASCADE ON DELETE CASCADE,
+ADD CONSTRAINT `fk_medias_operation` FOREIGN KEY (`fk_operation`) REFERENCES `operations` (`id`) ON UPDATE CASCADE ON DELETE CASCADE;
+```
+
+## Types de Support
+
+### 1. Entité (`support = 'entite'`)
+
+- **Fichiers autorisés** : PDF, Excel, Images (JPG, PNG)
+- **Taille max** : 20 MB
+- **Usage** : Documents généraux de l'entité (règlements, statuts, etc.)
+- **Chemin** : `uploads/entites/{entite_id}/documents/`
+
+### 2. Utilisateur (`support = 'user'`)
+
+- **Fichiers autorisés** : Images uniquement (JPG, PNG, GIF, WebP)
+- **Taille max** : 5 MB
+- **Usage** : Avatars, photos de profil
+- **Chemin** : `uploads/entites/{entite_id}/users/{user_id}/`
+- **Traitement** : Redimensionnement automatique
+
+### 3. Opération (`support = 'operation'`)
+
+- **Fichiers autorisés** : Excel uniquement (XLS, XLSX)
+- **Taille max** : 20 MB
+- **Usage** : Plannings, listes, données d'opération
+- **Chemin** : `uploads/entites/{entite_id}/operations/{operation_id}/documents/`
+
+### 4. Passage (`support = 'passage'`)
+
+- **Fichiers autorisés** : PDF et Images (JPG, PNG, PDF)
+- **Taille max** : 10 MB par fichier
+- **Usage** : Reçus, photos de passage, justificatifs
+- **Chemin** : `uploads/entites/{entite_id}/operations/{operation_id}/passages/{passage_id}/`
+- **Traitement** : Redimensionnement automatique pour les images
+
+## Traitement Automatique des Images
+
+### Règles de redimensionnement
+
+- **Dimension maximale** : 250px (hauteur ou largeur, selon la plus grande)
+- **Résolution** : 72 DPI (optimisé web)
+- **Préservation du ratio** : Redimensionnement proportionnel
+- **Formats supportés** : JPG, PNG, GIF, WebP
+- **Qualité JPEG** : 85% (bon compromis qualité/poids)
+
+### Exemples de transformation
+
+```
+Image originale 1000x800px → Image traitée 250x200px
+Image originale 600x1200px → Image traitée 125x250px
+Image originale 200x150px → Pas de redimensionnement (déjà < 250px)
+```
+
+### Workflow de traitement
+
+1. **Upload** → Validation du type MIME
+2. **Analyse** → Détection des dimensions originales
+3. **Traitement** → Redimensionnement si nécessaire
+4. **Optimisation** → Compression et résolution web
+5. **Sauvegarde** → Image optimisée + métadonnées
+6. **Nettoyage** → Suppression du fichier temporaire
+
+## API Endpoints
+
+### Routes de gestion des fichiers
+
+```php
+// Upload de fichiers
+POST /api/medias/upload
+Content-Type: multipart/form-data
+Body: {
+ "file": [fichier],
+ "support": "entite|user|operation|passage",
+ "support_id": 123,
+ "description": "Description du fichier"
+}
+
+// Récupération d'un fichier
+GET /api/medias/{id}
+
+// Liste des fichiers par support
+GET /api/medias/list/{support}/{support_id}
+
+// Suppression d'un fichier
+DELETE /api/medias/{id}
+```
+
+### Exemples de requêtes
+
+#### Upload d'un avatar utilisateur
+
+```bash
+curl -X POST "https://api.geosector.fr/medias/upload" \
+ -H "Authorization: Bearer {token}" \
+ -F "file=@avatar.jpg" \
+ -F "support=user" \
+ -F "support_id=123" \
+ -F "description=Avatar utilisateur"
+```
+
+#### Upload d'une photo de passage
+
+```bash
+curl -X POST "https://api.geosector.fr/medias/upload" \
+ -H "Authorization: Bearer {token}" \
+ -F "file=@photo_passage.jpg" \
+ -F "support=passage" \
+ -F "support_id=789" \
+ -F "description=Photo du passage"
+```
+
+## Sécurité et Contrôles
+
+### Validation des fichiers
+
+- **Types MIME** : Vérification stricte du type de fichier
+- **Extensions** : Validation de l'extension par rapport au contenu
+- **Taille** : Limite selon le type de support
+- **Contenu** : Scan antivirus recommandé en production
+
+### Contrôles d'accès
+
+- **Authentification** : Token JWT requis
+- **Autorisation** : Utilisateur ne peut accéder qu'aux fichiers de son entité
+- **Vérification** : Contrôle que l'utilisateur appartient à l'entité du fichier
+- **Logs** : Traçabilité complète des uploads et accès
+
+### Nommage des fichiers
+
+```php
+// Format : {timestamp}_{random}_{sanitized_name}.{extension}
+// Exemple : 1640995200_a1b2c3_document_reglement.pdf
+```
+
+## Gestion des Erreurs
+
+### Codes d'erreur HTTP
+
+- **400** : Fichier invalide ou paramètres manquants
+- **401** : Non authentifié
+- **403** : Accès refusé à cette entité
+- **413** : Fichier trop volumineux
+- **415** : Type de fichier non supporté
+- **500** : Erreur serveur lors du traitement
+
+### Messages d'erreur
+
+```json
+{
+ "status": "error",
+ "message": "Type de fichier non autorisé pour ce support",
+ "code": "INVALID_FILE_TYPE",
+ "allowed_types": ["jpg", "png", "gif", "webp"]
+}
+```
+
+## Maintenance et Nettoyage
+
+### Nettoyage automatique
+
+- **Fichiers temporaires** : Suppression après 24h
+- **Fichiers orphelins** : Détection et suppression des fichiers sans référence en base
+- **Anciennes opérations** : Suppression en cascade lors de la suppression d'une opération
+
+### Commandes de maintenance
+
+```bash
+# Nettoyage des fichiers temporaires
+php scripts/cleanup_temp_files.php
+
+# Détection des fichiers orphelins
+php scripts/find_orphan_files.php
+
+# Statistiques d'utilisation
+php scripts/storage_stats.php
+```
+
+## Performances et Optimisation
+
+### Optimisations
+
+- **CDN** : Recommandé pour la distribution des fichiers
+- **Cache** : Headers de cache appropriés pour les fichiers statiques
+- **Compression** : Gzip pour les réponses API
+- **Index** : Index optimisés sur la table medias
+
+### Monitoring
+
+- **Espace disque** : Surveillance de l'utilisation
+- **Performance** : Temps de traitement des images
+- **Erreurs** : Logs des échecs d'upload et de traitement
+
+## Exemples d'Utilisation
+
+### Cas d'usage typiques
+
+1. **Upload d'avatar utilisateur**
+
+ - Fichier JPG de 2MB
+ - Redimensionnement automatique à 250x250px
+ - Stockage dans `uploads/entites/5/users/123/`
+
+2. **Document d'opération**
+
+ - Fichier Excel de planning
+ - Stockage dans `uploads/entites/5/operations/2644/documents/`
+ - Pas de traitement (fichier conservé tel quel)
+
+3. **Photo de passage**
+ - Photo JPG de 8MB prise sur mobile
+ - Redimensionnement automatique à 250px max
+ - Stockage dans `uploads/entites/5/operations/2644/passages/789/`
+
+### Intégration frontend
+
+```javascript
+// Upload avec progress
+const uploadFile = async (file, support, supportId, description) => {
+ const formData = new FormData();
+ formData.append('file', file);
+ formData.append('support', support);
+ formData.append('support_id', supportId);
+ formData.append('description', description);
+
+ const response = await fetch('/api/medias/upload', {
+ method: 'POST',
+ headers: {
+ Authorization: `Bearer ${token}`,
+ },
+ body: formData,
+ });
+
+ return response.json();
+};
+```
+
+---
+
+**Version** : 1.0
+**Date** : Juin 2025
+**Auteur** : API Geosector Team
diff --git a/api/docs/geo_app.sql b/api/docs/geo_app.sql
index 810a0113..f82412a8 100644
--- a/api/docs/geo_app.sql
+++ b/api/docs/geo_app.sql
@@ -237,17 +237,37 @@ CREATE TABLE `entites` (
CREATE TABLE `medias` (
`id` int(10) unsigned NOT NULL AUTO_INCREMENT,
- `support` varchar(45) NOT NULL DEFAULT '',
- `support_id` int(10) unsigned NOT NULL DEFAULT 0,
- `fichier` varchar(250) NOT NULL DEFAULT '',
- `description` varchar(100) NOT NULL DEFAULT '',
+ `support` varchar(45) NOT NULL DEFAULT '' COMMENT 'Type de support (entite, user, operation, passage)',
+ `support_id` int(10) unsigned NOT NULL DEFAULT 0 COMMENT 'ID de élément associé',
+ `fichier` varchar(250) NOT NULL DEFAULT '' COMMENT 'Nom du fichier stocké',
+ `file_type` varchar(50) DEFAULT NULL COMMENT 'Extension du fichier (pdf, jpg, xlsx, etc.)',
+ `file_category` varchar(50) DEFAULT NULL COMMENT 'export, logo, carte, etc.',
+ `file_size` int(10) unsigned DEFAULT NULL COMMENT 'Taille du fichier en octets',
+ `mime_type` varchar(100) DEFAULT NULL COMMENT 'Type MIME du fichier',
+ `original_name` varchar(255) DEFAULT NULL COMMENT 'Nom original du fichier uploadé',
+ `fk_entite` int(10) unsigned DEFAULT NULL COMMENT 'ID de entité propriétaire',
+ `fk_operation` int(10) unsigned DEFAULT NULL COMMENT 'ID de opération (pour passages)',
+ `file_path` varchar(500) DEFAULT NULL COMMENT 'Chemin complet du fichier',
+ `original_width` int(10) unsigned DEFAULT NULL COMMENT 'Largeur originale de image',
+ `original_height` int(10) unsigned DEFAULT NULL COMMENT 'Hauteur originale de image',
+ `processed_width` int(10) unsigned DEFAULT NULL COMMENT 'Largeur après traitement',
+ `processed_height` int(10) unsigned DEFAULT NULL COMMENT 'Hauteur après traitement',
+ `is_processed` tinyint(1) unsigned DEFAULT 0 COMMENT 'Image redimensionnée (1) ou originale (0)',
+ `description` varchar(100) NOT NULL DEFAULT '' COMMENT 'Description du fichier',
`created_at` timestamp NOT NULL DEFAULT current_timestamp(),
`fk_user_creat` int(10) unsigned NOT NULL DEFAULT 0,
`updated_at` timestamp NULL DEFAULT NULL ON UPDATE current_timestamp(),
`fk_user_modif` int(10) unsigned NOT NULL DEFAULT 0,
PRIMARY KEY (`id`),
- UNIQUE KEY `id_UNIQUE` (`id`)
-) ENGINE=InnoDB AUTO_INCREMENT=176 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci `PAGE_COMPRESSED`='ON';
+ UNIQUE KEY `id_UNIQUE` (`id`),
+ KEY `idx_entite` (`fk_entite`),
+ KEY `idx_operation` (`fk_operation`),
+ KEY `idx_support_type` (`support`, `support_id`),
+ KEY `idx_file_type` (`file_type`),
+ KEY `idx_file_category` (`file_category`),
+ CONSTRAINT `fk_medias_entite` FOREIGN KEY (`fk_entite`) REFERENCES `entites` (`id`) ON UPDATE CASCADE ON DELETE CASCADE,
+ CONSTRAINT `fk_medias_operation` FOREIGN KEY (`fk_operation`) REFERENCES `operations` (`id`) ON UPDATE CASCADE ON DELETE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
CREATE TABLE `ope_pass` (
`id` int(10) unsigned NOT NULL AUTO_INCREMENT,
@@ -375,22 +395,6 @@ CREATE TABLE `ope_users_sectors` (
CONSTRAINT `ope_users_sectors_ibfk_3` FOREIGN KEY (`fk_sector`) REFERENCES `ope_sectors` (`id`) ON UPDATE CASCADE
) ENGINE=InnoDB AUTO_INCREMENT=48082 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci `PAGE_COMPRESSED`='ON';
-CREATE TABLE `ope_users_suivis` (
- `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
- `fk_operation` int(10) unsigned NOT NULL DEFAULT 0,
- `fk_user` int(10) unsigned NOT NULL DEFAULT 0,
- `date_suivi` timestamp NOT NULL DEFAULT current_timestamp() COMMENT 'Date du suivi',
- `gps_lat` varchar(20) NOT NULL DEFAULT '',
- `gps_lng` varchar(20) NOT NULL DEFAULT '',
- `vitesse` varchar(20) NOT NULL DEFAULT '',
- `created_at` timestamp NOT NULL DEFAULT current_timestamp() COMMENT 'Date de création',
- `fk_user_creat` int(10) unsigned NOT NULL DEFAULT 0,
- `updated_at` timestamp NULL DEFAULT NULL ON UPDATE current_timestamp() COMMENT 'Date de modification',
- `fk_user_modif` int(10) unsigned NOT NULL DEFAULT 0,
- PRIMARY KEY (`id`),
- UNIQUE KEY `id_UNIQUE` (`id`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci `PAGE_COMPRESSED`='ON';
-
CREATE TABLE `operations` (
`id` int(10) unsigned NOT NULL AUTO_INCREMENT,
`fk_entite` int(10) unsigned NOT NULL DEFAULT 1,
diff --git a/api/export_operation.php b/api/export_operation.php
new file mode 100644
index 00000000..6c0f1354
--- /dev/null
+++ b/api/export_operation.php
@@ -0,0 +1,145 @@
+prepare($sql);
+ // $stmt->execute();
+ // return $stmt->fetchAll(PDO::FETCH_ASSOC);
+ return [];
+}
+
+function eLog($message) {
+ error_log($message);
+}
+
+switch ($Route->_action) {
+ case "export_operation":
+ $data = json_decode(file_get_contents("php://input"));
+ if (isset($data->cid)) {
+ $cid = nettoie_input($data->cid);
+ $idMembre = "0";
+ $libMembre = "";
+ if (isset($data->idMembre) && isset($data->libMembre)) {
+ $idMembre = nettoie_input($data->idMembre);
+ $libMembre = nettoie_input($data->libMembre);
+ }
+
+ // On crée le dossier de l'amicale s'il n'est pas déjà créé
+ $dir = 'pub/files/upload/' . $Conf->_entite["rowid"];
+ if (!is_dir($dir)) {
+ mkdir($dir, 0777, true);
+ }
+
+ $sql = 'SELECT p.date_eve, u.prenom, u.libelle AS nom, u.nom_tournee, p.fk_type, p.numero, p.rue_bis, p.rue, p.ville, p.fk_habitat, p.appt, p.niveau, p.libelle, p.email, p.phone, p.montant, xtr.libelle AS reglement, p.remarque FROM ope_pass p LEFT JOIN users u ON u.rowid=p.fk_user LEFT JOIN x_types_reglements xtr ON xtr.rowid=p.fk_type_reglement WHERE p.fk_operation=' . $cid;
+ if ($idMembre != "0") {
+ $sql .= ' AND p.fk_user=' . $idMembre . ';';
+ }
+ $pass = getinfos($sql);
+
+ $aData = array();
+ $aData[] = array(
+ 'Date',
+ 'Heure',
+ 'Prenom',
+ 'Nom',
+ 'Tournee',
+ 'Type',
+ 'N°',
+ 'Rue',
+ 'Ville',
+ 'Habitat',
+ 'Donateur',
+ 'Email',
+ 'Tel',
+ 'Montant',
+ 'Reglement',
+ 'Remarque'
+ );
+ foreach ($pass as $p) {
+ switch ($p["fk_type"]) {
+ case 1:
+ $ptype = "Effectué";
+ $preglement = $p["reglement"];
+ break;
+ case 2:
+ $ptype = "A finaliser";
+ $preglement = "";
+ break;
+ case 3:
+ $ptype = "Refusé";
+ $preglement = "";
+ break;
+ case 4:
+ $ptype = "Don";
+ $preglement = "";
+ break;
+ case 9:
+ $ptype = "Habitat vide";
+ $preglement = "";
+ break;
+ default:
+ $ptype = $p["fk_type"];
+ $preglement = "";
+ break;
+ }
+ if ($p["fk_habitat"] == 1) {
+ $phabitat = "Individuel";
+ } else {
+ $phabitat = "Etage " . $p["niveau"] . " - Appt " . $p["appt"];
+ }
+ $dateEve = date("d/m/Y", strtotime($p["date_eve"]));
+ $heureEve = date("H:i", strtotime($p["date_eve"]));
+ $nom = str_replace("/", "-", $p["nom"]);
+ $tournee = str_replace("/", "-", $p["nom_tournee"]);
+ $aData[] = array(
+ $dateEve,
+ $heureEve,
+ $p["prenom"],
+ $nom,
+ $tournee,
+ $ptype,
+ $p["numero"] . $p["rue_bis"],
+ $p["rue"],
+ $p["ville"],
+ $phabitat,
+ $p["libelle"],
+ $p["email"],
+ $p["phone"],
+ $p["montant"],
+ $preglement,
+ $p["remarque"]
+ );
+ }
+ $spreadsheet = new \PhpOffice\PhpSpreadsheet\Spreadsheet();
+ $activeWorksheet = $spreadsheet->getActiveSheet()
+ ->fromArray($aData, null, 'A1');
+
+ $writer = new Xlsx($spreadsheet);
+ if ($idMembre == "0") {
+ $xlsxName = $dir . '/geosector-ope-' . $cid . '-' . date("Ymd-His") . '.xlsx';
+ } else {
+ $libMembre = str_replace("/", "-", $libMembre);
+ $libMembre = str_replace("*", "-", $libMembre);
+ $xlsxName = $dir . '/geosector-ope-' . $cid . '-' . $libMembre . '-' . date("Ymd-His") . '.xlsx';
+ }
+ eLog("Export Operation : " . $xlsxName);
+ $writer->save($xlsxName);
+
+ $ret = array('url' => $xlsxName);
+ echo json_encode($ret);
+ }
+ break;
+}
diff --git a/api/index.php b/api/index.php
index e0a2828e..4add79d2 100644
--- a/api/index.php
+++ b/api/index.php
@@ -19,6 +19,7 @@ require_once __DIR__ . '/src/Controllers/LogController.php';
require_once __DIR__ . '/src/Controllers/LoginController.php';
require_once __DIR__ . '/src/Controllers/EntiteController.php';
require_once __DIR__ . '/src/Controllers/UserController.php';
+require_once __DIR__ . '/src/Controllers/OperationController.php';
// Initialiser la configuration
$appConfig = AppConfig::getInstance();
diff --git a/api/livre-api.sh b/api/livre-api.sh
index 7a2775ae..04a1c4f0 100755
--- a/api/livre-api.sh
+++ b/api/livre-api.sh
@@ -1,9 +1,14 @@
#!/bin/bash
# Vérification des arguments
-if [ $# -ne 2 ]; then
- echo "Usage: $0 "
- echo "Example: $0 dva-geo rca-geo"
+if [ $# -ne 1 ]; then
+ echo "Usage: $0 "
+ echo " rec : Livrer de DVA (dva-geo) vers RECETTE (rca-geo)"
+ echo " prod : Livrer de RECETTE (rca-geo) vers PRODUCTION (pra-geo)"
+ echo ""
+ echo "Examples:"
+ echo " $0 rec # DVA → RECETTE"
+ echo " $0 prod # RECETTE → PRODUCTION"
exit 1
fi
@@ -12,14 +17,31 @@ HOST_USER=root
HOST_KEY=/Users/pierre/.ssh/id_rsa_mbpi
HOST_PORT=22
-SOURCE_CONTAINER=$1
-DEST_CONTAINER=$2
+# Mapping des environnements
+ENVIRONMENT=$1
+case $ENVIRONMENT in
+ "rec")
+ SOURCE_CONTAINER="dva-geo"
+ DEST_CONTAINER="rca-geo"
+ ENV_NAME="RECETTE"
+ ;;
+ "prod")
+ SOURCE_CONTAINER="rca-geo"
+ DEST_CONTAINER="pra-geo"
+ ENV_NAME="PRODUCTION"
+ ;;
+ *)
+ echo "❌ Environnement '$ENVIRONMENT' non reconnu"
+ echo "Utilisez 'rec' pour RECETTE ou 'prod' pour PRODUCTION"
+ exit 1
+ ;;
+esac
API_PATH="/var/www/geosector/api"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
BACKUP_DIR="${API_PATH}_backup_${TIMESTAMP}"
PROJECT="default"
-echo "🔄 Copie de l'API de $SOURCE_CONTAINER vers $DEST_CONTAINER (projet: $PROJECT)"
+echo "🔄 Livraison vers $ENV_NAME : $SOURCE_CONTAINER → $DEST_CONTAINER (projet: $PROJECT)"
# Vérifier si les containers existent
echo "🔍 Vérification des containers..."
@@ -47,37 +69,24 @@ else
echo "⚠️ Le dossier API n'existe pas sur la destination"
fi
-# Sauvegarder spécifiquement le dossier logs
-echo "📋 Sauvegarde du dossier logs..."
-# Vérifier si le dossier logs existe
-ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- test -d $API_PATH/logs"
-if [ $? -eq 0 ]; then
- # Le dossier logs existe, le sauvegarder
- ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- mkdir -p /tmp/geosector_logs_backup"
- ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- cp -r $API_PATH/logs /tmp/geosector_logs_backup/"
- echo "✅ Dossier logs sauvegardé temporairement"
-else
- echo "⚠️ Le dossier logs n'existe pas sur la destination"
-fi
-
# Copier le dossier API entre les containers
echo "📋 Copie des fichiers en cours..."
-# Approche directe: utiliser incus copy pour copier directement entre containers
-echo "📤 Transfert direct entre containers..."
-# Nettoyer le dossier de destination
-ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- rm -rf $API_PATH"
-ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- mkdir -p $API_PATH"
+# Nettoyage sélectif : supprimer seulement le code, pas les données (logs et uploads)
+echo "🧹 Nettoyage sélectif (préservation de logs et uploads)..."
+ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- find $API_PATH -mindepth 1 -maxdepth 1 ! -name 'uploads' ! -name 'logs' -exec rm -rf {} \;"
-# Copier directement du container source vers le container destination
-ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $SOURCE_CONTAINER --project $PROJECT -- tar -cf - -C $API_PATH . | incus exec $DEST_CONTAINER --project $PROJECT -- tar -xf - -C $API_PATH"
+# Copier directement du container source vers le container destination (en excluant logs et uploads)
+echo "📤 Transfert du code (hors logs et uploads)..."
+ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $SOURCE_CONTAINER --project $PROJECT -- tar -cf - -C $API_PATH --exclude='uploads' --exclude='logs' . | incus exec $DEST_CONTAINER --project $PROJECT -- tar -xf - -C $API_PATH"
if [ $? -ne 0 ]; then
- echo "❌ Erreur lors du transfert direct entre containers"
+ echo "❌ Erreur lors du transfert entre containers"
echo "⚠️ Tentative de restauration de la sauvegarde..."
# Vérifier si la sauvegarde existe
ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- test -d $BACKUP_DIR"
if [ $? -eq 0 ]; then
# La sauvegarde existe, la restaurer
+ ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- rm -rf $API_PATH"
ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- cp -r $BACKUP_DIR $API_PATH"
echo "✅ Restauration réussie"
else
@@ -86,21 +95,7 @@ if [ $? -ne 0 ]; then
exit 1
fi
-# Pas de fichiers temporaires à nettoyer avec cette approche
-
-# Restaurer le dossier logs
-echo "📋 Restauration du dossier logs..."
-# Vérifier si la sauvegarde des logs existe
-ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- test -d /tmp/geosector_logs_backup/logs"
-if [ $? -eq 0 ]; then
- # La sauvegarde des logs existe, la restaurer
- ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- mkdir -p $API_PATH/logs"
- ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- cp -r /tmp/geosector_logs_backup/logs/* $API_PATH/logs/"
- ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- rm -rf /tmp/geosector_logs_backup"
- echo "✅ Dossier logs restauré"
-else
- echo "⚠️ Aucune sauvegarde de logs à restaurer"
-fi
+echo "✅ Code transféré avec succès (logs et uploads préservés)"
# Changer le propriétaire et les permissions des fichiers
echo "👤 Application des droits et permissions pour tous les fichiers..."
@@ -128,6 +123,23 @@ else
echo "⚠️ Le dossier logs n'existe pas"
fi
+# Vérifier et corriger les permissions du dossier uploads s'il existe
+ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- test -d $API_PATH/uploads"
+if [ $? -eq 0 ]; then
+ # S'assurer que uploads a les bonnes permissions
+ ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- chown -R nginx:nobody $API_PATH/uploads"
+ ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- chmod -R 775 $API_PATH/uploads"
+ ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- find $API_PATH/uploads -type f -exec chmod 664 {} \;"
+ echo "✅ Droits vérifiés pour le dossier uploads (nginx:nginx avec permissions 775)"
+else
+ # Créer le dossier uploads s'il n'existe pas
+ ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- mkdir -p $API_PATH/uploads"
+ ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- chown -R nginx:nobody $API_PATH/uploads"
+ ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- chmod -R 775 $API_PATH/uploads"
+ ssh -i $HOST_KEY -p $HOST_PORT $HOST_USER@$HOST_IP "incus exec $DEST_CONTAINER --project $PROJECT -- find $API_PATH/uploads -type f -exec chmod 664 {} \;"
+ echo "✅ Dossier uploads créé avec les bonnes permissions (nginx:nginx avec permissions 775/664)"
+fi
+
echo "✅ Propriétaire et permissions appliqués avec succès"
# Vérifier la copie
@@ -139,6 +151,8 @@ else
echo "❌ Erreur: Le dossier API n'a pas été copié correctement"
fi
-echo "✅ Opération terminée! L'API a été copiée de $SOURCE_CONTAINER vers $DEST_CONTAINER"
-echo "📁 Une sauvegarde a été créée dans $BACKUP_DIR sur $DEST_CONTAINER"
-echo "👤 Les fichiers appartiennent maintenant à l'utilisateur nginx"
+echo "✅ Livraison vers $ENV_NAME terminée avec succès!"
+echo "📤 Source: $SOURCE_CONTAINER → Destination: $DEST_CONTAINER"
+echo "📁 Sauvegarde créée: $BACKUP_DIR sur $DEST_CONTAINER"
+echo "🔒 Données préservées: logs/ et uploads/ intouchés"
+echo "👤 Permissions: nginx:nginx (755/644) + logs (nginx:nobody 775/664)"
diff --git a/api/migration_add_file_category.sql b/api/migration_add_file_category.sql
new file mode 100644
index 00000000..556c0c04
--- /dev/null
+++ b/api/migration_add_file_category.sql
@@ -0,0 +1,26 @@
+-- Migration pour ajouter la colonne file_category à la table medias
+-- Date: 2025-06-22
+-- Description: Ajout du champ file_category pour distinguer les types métier des fichiers
+
+-- Ajout de la colonne file_category
+ALTER TABLE `medias`
+ADD COLUMN `file_category` varchar(50) DEFAULT NULL COMMENT 'Catégorie du fichier (logo, carte, photo, document, etc.)' AFTER `file_type`;
+
+-- Ajout de l'index pour optimiser les requêtes
+ALTER TABLE `medias`
+ADD INDEX `idx_file_category` (`file_category`);
+
+-- Mise à jour des données existantes avec des catégories par défaut selon le support
+UPDATE `medias` SET `file_category` = 'document' WHERE `support` = 'entite' AND `file_category` IS NULL;
+UPDATE `medias` SET `file_category` = 'avatar' WHERE `support` = 'user' AND `file_category` IS NULL;
+UPDATE `medias` SET `file_category` = 'export' WHERE `support` = 'operation' AND `file_category` IS NULL;
+UPDATE `medias` SET `file_category` = 'recu' WHERE `support` = 'passage' AND `file_category` IS NULL;
+
+-- Vérification des modifications
+SELECT
+ support,
+ file_category,
+ COUNT(*) as count
+FROM medias
+GROUP BY support, file_category
+ORDER BY support, file_category;
diff --git a/api/migration_add_ope_users_fields.sql b/api/migration_add_ope_users_fields.sql
new file mode 100644
index 00000000..dc3cb0b7
--- /dev/null
+++ b/api/migration_add_ope_users_fields.sql
@@ -0,0 +1,16 @@
+-- Migration pour ajouter les champs utilisateur dans ope_users
+-- Date: 2025-06-23
+-- Description: Ajout des champs fk_role, first_name, encrypted_name, sect_name dans ope_users
+-- pour conserver un historique propre de chaque opération
+
+USE geo_app;
+
+-- Ajout des nouvelles colonnes dans ope_users
+ALTER TABLE ope_users
+ADD COLUMN fk_role int unsigned DEFAULT 1 AFTER fk_user,
+ADD COLUMN first_name varchar(45) DEFAULT '' AFTER fk_role,
+ADD COLUMN encrypted_name varchar(255) DEFAULT '' AFTER first_name,
+ADD COLUMN sect_name varchar(60) DEFAULT '' AFTER encrypted_name;
+
+-- Vérification de la structure modifiée
+DESCRIBE ope_users;
diff --git a/api/src/Config/AppConfig.php b/api/src/Config/AppConfig.php
index 81f22042..e22a9ced 100644
--- a/api/src/Config/AppConfig.php
+++ b/api/src/Config/AppConfig.php
@@ -71,6 +71,12 @@ class AppConfig {
'api_key' => '', // À remplir avec la clé API SMS OVH
'api_secret' => '', // À remplir avec le secret API SMS OVH
],
+ 'backup' => [
+ 'encryption_key' => 'K8mN2pQ5rT9wX3zA6bE1fH4jL7oS0vY2', // Clé de 32 caractères pour AES-256
+ 'compression' => true,
+ 'compression_level' => 6,
+ 'cipher' => 'AES-256-CBC'
+ ],
];
// Configuration PRODUCTION
@@ -336,6 +342,24 @@ class AppConfig {
return $this->clientIp;
}
+ /**
+ * Retourne la configuration des backups
+ *
+ * @return array Configuration des backups
+ */
+ public function getBackupConfig(): array {
+ return $this->getCurrentConfig()['backup'];
+ }
+
+ /**
+ * Retourne la clé de chiffrement des backups
+ *
+ * @return string Clé de chiffrement des backups
+ */
+ public function getBackupEncryptionKey(): string {
+ return $this->getCurrentConfig()['backup']['encryption_key'];
+ }
+
/**
* Détermine l'adresse IP du client en tenant compte des proxys et load balancers
*
diff --git a/api/src/Controllers/FileController.php b/api/src/Controllers/FileController.php
new file mode 100644
index 00000000..ade72e98
--- /dev/null
+++ b/api/src/Controllers/FileController.php
@@ -0,0 +1,1066 @@
+ ['logo', 'document', 'reglement', 'statut'],
+ 'user' => ['avatar', 'photo'],
+ 'operation' => ['planning', 'liste', 'export', 'backup'],
+ 'passage' => ['recu', 'photo', 'justificatif', 'carte']
+ ];
+
+ // Extensions autorisées
+ private const ALLOWED_EXTENSIONS = [
+ 'pdf',
+ 'jpg',
+ 'jpeg',
+ 'png',
+ 'gif',
+ 'webp',
+ 'xlsx',
+ 'xls',
+ 'json',
+ 'csv'
+ ];
+
+ public function __construct() {
+ $this->db = Database::getInstance();
+ $this->appConfig = AppConfig::getInstance();
+ }
+
+ /**
+ * Récupère les informations utilisateur (rôle et entité)
+ */
+ private function getUserInfo(int $userId): ?array {
+ try {
+ $stmt = $this->db->prepare('SELECT fk_entite, fk_role FROM users WHERE id = ?');
+ $stmt->execute([$userId]);
+ return $stmt->fetch(PDO::FETCH_ASSOC) ?: null;
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la récupération des infos utilisateur', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'userId' => $userId
+ ]);
+ return null;
+ }
+ }
+
+ /**
+ * Valide qu'un chemin est autorisé pour l'utilisateur
+ */
+ private function validatePath(string $path, int $userRole, int $userEntiteId): bool {
+ // Empêcher les traversées de répertoire
+ if (strpos($path, '..') !== false || strpos($path, './') !== false) {
+ return false;
+ }
+
+ // Normaliser le chemin
+ $path = trim($path, '/');
+
+ // Super admin : accès total
+ if ($userRole > 2) {
+ return true;
+ }
+
+ // Admin entité : limité à son entité
+ if ($userRole == 2) {
+ return strpos($path, "entites/{$userEntiteId}") === 0 || $path === "entites/{$userEntiteId}";
+ }
+
+ return false;
+ }
+
+ /**
+ * Vérifie si l'utilisateur peut accéder à un fichier
+ */
+ private function canAccessFile(int $fileId, int $userRole, int $userEntiteId): bool {
+ try {
+ $stmt = $this->db->prepare('SELECT fk_entite FROM medias WHERE id = ?');
+ $stmt->execute([$fileId]);
+ $file = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$file) {
+ return false;
+ }
+
+ // Super admin : accès total
+ if ($userRole > 2) {
+ return true;
+ }
+
+ // Admin entité : seulement ses fichiers
+ return (int)$file['fk_entite'] === $userEntiteId;
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la vérification d\'accès au fichier', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'fileId' => $fileId,
+ 'userId' => Session::getUserId()
+ ]);
+ return false;
+ }
+ }
+
+ /**
+ * Extrait et valide les paramètres de filtrage
+ */
+ private function extractFilters(array $params): array {
+ return [
+ 'page' => max(1, (int)($params['page'] ?? 1)),
+ 'per_page' => min(100, max(1, (int)($params['per_page'] ?? 50))),
+ 'search' => !empty($params['search']) ? trim($params['search']) : null,
+ 'type' => !empty($params['type']) && in_array($params['type'], self::ALLOWED_EXTENSIONS) ? $params['type'] : null,
+ 'category' => !empty($params['category']) ? trim($params['category']) : null,
+ 'sort' => in_array($params['sort'] ?? '', ['name', 'date', 'size', 'type']) ? $params['sort'] : 'date',
+ 'order' => in_array($params['order'] ?? '', ['asc', 'desc']) ? $params['order'] : 'desc'
+ ];
+ }
+
+ /**
+ * Construit la clause WHERE pour les requêtes de recherche
+ */
+ private function buildWhereClause(array $filters, int $userRole, int $userEntiteId, ?string $path = null): array {
+ $conditions = [];
+ $params = [];
+
+ // Restriction par entité selon le rôle
+ if ($userRole == 2) {
+ $conditions[] = 'm.fk_entite = ?';
+ $params[] = $userEntiteId;
+ }
+
+ // Filtrage par chemin si spécifié
+ if ($path !== null) {
+ $conditions[] = 'm.file_path LIKE ?';
+ $params[] = "uploads/{$path}%";
+ }
+
+ // Recherche textuelle
+ if ($filters['search']) {
+ $searchTerm = '%' . $filters['search'] . '%';
+ $conditions[] = '(m.fichier LIKE ? OR m.original_name LIKE ? OR m.description LIKE ?)';
+ $params[] = $searchTerm;
+ $params[] = $searchTerm;
+ $params[] = $searchTerm;
+ }
+
+ // Filtrage par type (extension)
+ if ($filters['type']) {
+ $conditions[] = 'm.file_type = ?';
+ $params[] = $filters['type'];
+ }
+
+ // Filtrage par catégorie
+ if ($filters['category']) {
+ $conditions[] = 'm.file_category = ?';
+ $params[] = $filters['category'];
+ }
+
+ $whereClause = !empty($conditions) ? 'WHERE ' . implode(' AND ', $conditions) : '';
+
+ return [$whereClause, $params];
+ }
+
+ /**
+ * Construit la clause ORDER BY
+ */
+ private function buildOrderClause(array $filters): string {
+ $sortField = match ($filters['sort']) {
+ 'name' => 'm.original_name',
+ 'size' => 'm.file_size',
+ 'type' => 'm.file_type',
+ default => 'm.created_at'
+ };
+
+ return "ORDER BY {$sortField} {$filters['order']}";
+ }
+
+ /**
+ * Navigation dans l'arborescence avec recherche et pagination
+ */
+ public function browse(): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $userInfo = $this->getUserInfo($userId);
+ if (!$userInfo) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Informations utilisateur non trouvées'
+ ], 404);
+ return;
+ }
+
+ $userRole = (int)$userInfo['fk_role'];
+ $userEntiteId = (int)$userInfo['fk_entite'];
+
+ $path = $_GET['path'] ?? '';
+ $filters = $this->extractFilters($_GET);
+
+ // Validation du chemin
+ if (!$this->validatePath($path, $userRole, $userEntiteId)) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Accès refusé à ce répertoire'
+ ], 403);
+ return;
+ }
+
+ // Construction de la requête
+ [$whereClause, $params] = $this->buildWhereClause($filters, $userRole, $userEntiteId, $path);
+ $orderClause = $this->buildOrderClause($filters);
+
+ // Requête pour compter le total
+ $countSql = "
+ SELECT COUNT(*) as total
+ FROM medias m
+ {$whereClause}
+ ";
+
+ $stmt = $this->db->prepare($countSql);
+ $stmt->execute($params);
+ $totalItems = (int)$stmt->fetchColumn();
+
+ // Calcul de la pagination
+ $totalPages = ceil($totalItems / $filters['per_page']);
+ $offset = ($filters['page'] - 1) * $filters['per_page'];
+
+ // Requête principale avec pagination
+ $sql = "
+ SELECT
+ m.id, m.fichier, m.original_name, m.file_type, m.file_category,
+ m.file_size, m.file_path, m.description, m.created_at,
+ m.fk_user_creat, u.encrypted_name as creator_name
+ FROM medias m
+ LEFT JOIN users u ON u.id = m.fk_user_creat
+ {$whereClause}
+ {$orderClause}
+ LIMIT ? OFFSET ?
+ ";
+
+ $params[] = $filters['per_page'];
+ $params[] = $offset;
+
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute($params);
+ $files = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ // Déchiffrer les noms des créateurs
+ foreach ($files as &$file) {
+ if ($file['creator_name']) {
+ $file['creator_name'] = ApiService::decryptData($file['creator_name']);
+ }
+ unset($file['encrypted_name']);
+ }
+
+ // Statistiques rapides
+ $statsSql = "
+ SELECT
+ COUNT(*) as total_files,
+ SUM(m.file_size) as total_size,
+ m.file_category,
+ COUNT(*) as category_count
+ FROM medias m
+ {$whereClause}
+ GROUP BY m.file_category
+ ";
+
+ $stmt = $this->db->prepare($statsSql);
+ $stmt->execute(array_slice($params, 0, -2)); // Enlever LIMIT et OFFSET
+ $stats = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ $summary = [
+ 'total_files' => $totalItems,
+ 'total_size' => array_sum(array_column($stats, 'total_size')),
+ 'by_category' => []
+ ];
+
+ foreach ($stats as $stat) {
+ if ($stat['file_category']) {
+ $summary['by_category'][$stat['file_category']] = (int)$stat['category_count'];
+ }
+ }
+
+ Response::json([
+ 'status' => 'success',
+ 'current_path' => $path,
+ 'parent_path' => dirname($path) !== '.' ? dirname($path) : null,
+ 'pagination' => [
+ 'current_page' => $filters['page'],
+ 'per_page' => $filters['per_page'],
+ 'total_items' => $totalItems,
+ 'total_pages' => $totalPages,
+ 'has_next' => $filters['page'] < $totalPages,
+ 'has_prev' => $filters['page'] > 1
+ ],
+ 'filters' => [
+ 'search' => $filters['search'],
+ 'type' => $filters['type'],
+ 'category' => $filters['category'],
+ 'sort' => $filters['sort'],
+ 'order' => $filters['order']
+ ],
+ 'files' => $files,
+ 'summary' => $summary
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la navigation des fichiers', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'userId' => $userId ?? null,
+ 'path' => $_GET['path'] ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la navigation des fichiers'
+ ], 500);
+ }
+ }
+
+ /**
+ * Liste des fichiers par support avec recherche et pagination
+ */
+ public function listBySupport(string $support, string $supportId): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $userInfo = $this->getUserInfo($userId);
+ if (!$userInfo) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Informations utilisateur non trouvées'
+ ], 404);
+ return;
+ }
+
+ $userRole = (int)$userInfo['fk_role'];
+ $userEntiteId = (int)$userInfo['fk_entite'];
+ $supportIdInt = (int)$supportId;
+
+ $filters = $this->extractFilters($_GET);
+
+ // Construction de la requête de base
+ $conditions = ['m.support = ?', 'm.support_id = ?'];
+ $params = [$support, $supportIdInt];
+
+ // Restriction par entité selon le rôle
+ if ($userRole == 2) {
+ $conditions[] = 'm.fk_entite = ?';
+ $params[] = $userEntiteId;
+ }
+
+ // Recherche textuelle
+ if ($filters['search']) {
+ $searchTerm = '%' . $filters['search'] . '%';
+ $conditions[] = '(m.fichier LIKE ? OR m.original_name LIKE ? OR m.description LIKE ?)';
+ $params[] = $searchTerm;
+ $params[] = $searchTerm;
+ $params[] = $searchTerm;
+ }
+
+ // Filtrage par type
+ if ($filters['type']) {
+ $conditions[] = 'm.file_type = ?';
+ $params[] = $filters['type'];
+ }
+
+ // Filtrage par catégorie
+ if ($filters['category']) {
+ $conditions[] = 'm.file_category = ?';
+ $params[] = $filters['category'];
+ }
+
+ $whereClause = 'WHERE ' . implode(' AND ', $conditions);
+ $orderClause = $this->buildOrderClause($filters);
+
+ // Compter le total
+ $countSql = "SELECT COUNT(*) as total FROM medias m {$whereClause}";
+ $stmt = $this->db->prepare($countSql);
+ $stmt->execute($params);
+ $totalItems = (int)$stmt->fetchColumn();
+
+ // Calcul pagination
+ $totalPages = ceil($totalItems / $filters['per_page']);
+ $offset = ($filters['page'] - 1) * $filters['per_page'];
+
+ // Requête principale
+ $sql = "
+ SELECT
+ m.id, m.fichier, m.original_name, m.file_type, m.file_category,
+ m.file_size, m.file_path, m.description, m.created_at,
+ m.fk_user_creat, u.encrypted_name as creator_name
+ FROM medias m
+ LEFT JOIN users u ON u.id = m.fk_user_creat
+ {$whereClause}
+ {$orderClause}
+ LIMIT ? OFFSET ?
+ ";
+
+ $params[] = $filters['per_page'];
+ $params[] = $offset;
+
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute($params);
+ $files = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ // Déchiffrer les noms
+ foreach ($files as &$file) {
+ if ($file['creator_name']) {
+ $file['creator_name'] = ApiService::decryptData($file['creator_name']);
+ }
+ unset($file['encrypted_name']);
+ }
+
+ Response::json([
+ 'status' => 'success',
+ 'support' => $support,
+ 'support_id' => $supportIdInt,
+ 'pagination' => [
+ 'current_page' => $filters['page'],
+ 'per_page' => $filters['per_page'],
+ 'total_items' => $totalItems,
+ 'total_pages' => $totalPages,
+ 'has_next' => $filters['page'] < $totalPages,
+ 'has_prev' => $filters['page'] > 1
+ ],
+ 'filters' => [
+ 'search' => $filters['search'],
+ 'type' => $filters['type'],
+ 'category' => $filters['category']
+ ],
+ 'files' => $files
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la liste des fichiers par support', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'support' => $support,
+ 'supportId' => $supportId,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la récupération des fichiers'
+ ], 500);
+ }
+ }
+
+ /**
+ * Recherche globale de fichiers
+ */
+ public function search(): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $userInfo = $this->getUserInfo($userId);
+ if (!$userInfo) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Informations utilisateur non trouvées'
+ ], 404);
+ return;
+ }
+
+ $userRole = (int)$userInfo['fk_role'];
+ $userEntiteId = (int)$userInfo['fk_entite'];
+
+ $query = $_GET['q'] ?? '';
+ if (empty(trim($query))) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Terme de recherche requis'
+ ], 400);
+ return;
+ }
+
+ $filters = $this->extractFilters($_GET);
+ $filters['search'] = trim($query);
+
+ [$whereClause, $params] = $this->buildWhereClause($filters, $userRole, $userEntiteId);
+ $orderClause = $this->buildOrderClause($filters);
+
+ // Compter le total
+ $countSql = "SELECT COUNT(*) as total FROM medias m {$whereClause}";
+ $stmt = $this->db->prepare($countSql);
+ $stmt->execute($params);
+ $totalItems = (int)$stmt->fetchColumn();
+
+ // Pagination
+ $totalPages = ceil($totalItems / $filters['per_page']);
+ $offset = ($filters['page'] - 1) * $filters['per_page'];
+
+ // Requête principale
+ $sql = "
+ SELECT
+ m.id, m.fichier, m.original_name, m.file_type, m.file_category,
+ m.file_size, m.file_path, m.description, m.created_at, m.support,
+ m.support_id, m.fk_user_creat, u.encrypted_name as creator_name
+ FROM medias m
+ LEFT JOIN users u ON u.id = m.fk_user_creat
+ {$whereClause}
+ {$orderClause}
+ LIMIT ? OFFSET ?
+ ";
+
+ $params[] = $filters['per_page'];
+ $params[] = $offset;
+
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute($params);
+ $files = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ // Déchiffrer les noms
+ foreach ($files as &$file) {
+ if ($file['creator_name']) {
+ $file['creator_name'] = ApiService::decryptData($file['creator_name']);
+ }
+ unset($file['encrypted_name']);
+ }
+
+ Response::json([
+ 'status' => 'success',
+ 'query' => $query,
+ 'pagination' => [
+ 'current_page' => $filters['page'],
+ 'per_page' => $filters['per_page'],
+ 'total_items' => $totalItems,
+ 'total_pages' => $totalPages,
+ 'has_next' => $filters['page'] < $totalPages,
+ 'has_prev' => $filters['page'] > 1
+ ],
+ 'filters' => [
+ 'type' => $filters['type'],
+ 'category' => $filters['category']
+ ],
+ 'files' => $files
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la recherche de fichiers', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'query' => $_GET['q'] ?? null,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la recherche'
+ ], 500);
+ }
+ }
+
+ /**
+ * Statistiques d'utilisation des fichiers
+ */
+ public function getStats(): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $userInfo = $this->getUserInfo($userId);
+ if (!$userInfo) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Informations utilisateur non trouvées'
+ ], 404);
+ return;
+ }
+
+ $userRole = (int)$userInfo['fk_role'];
+ $userEntiteId = (int)$userInfo['fk_entite'];
+
+ if ($userRole == 2) {
+ // Stats pour admin d'entité
+ $sql = "
+ SELECT
+ COUNT(*) as total_files,
+ SUM(file_size) as total_size,
+ support,
+ file_category,
+ file_type,
+ COUNT(*) as count
+ FROM medias
+ WHERE fk_entite = ?
+ GROUP BY support, file_category, file_type
+ ORDER BY support, file_category
+ ";
+
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute([$userEntiteId]);
+ $stats = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ $response = [
+ 'status' => 'success',
+ 'entite_id' => $userEntiteId,
+ 'storage' => [
+ 'total_files' => 0,
+ 'total_size' => 0,
+ 'by_support' => [],
+ 'by_category' => [],
+ 'by_type' => []
+ ]
+ ];
+
+ foreach ($stats as $stat) {
+ $response['storage']['total_files'] += (int)$stat['count'];
+ $response['storage']['total_size'] += (int)$stat['total_size'];
+
+ $support = $stat['support'];
+ $category = $stat['file_category'] ?: 'non_categorise';
+ $type = $stat['file_type'] ?: 'inconnu';
+
+ if (!isset($response['storage']['by_support'][$support])) {
+ $response['storage']['by_support'][$support] = ['count' => 0, 'size' => 0];
+ }
+ $response['storage']['by_support'][$support]['count'] += (int)$stat['count'];
+ $response['storage']['by_support'][$support]['size'] += (int)$stat['total_size'];
+
+ if (!isset($response['storage']['by_category'][$category])) {
+ $response['storage']['by_category'][$category] = 0;
+ }
+ $response['storage']['by_category'][$category] += (int)$stat['count'];
+
+ if (!isset($response['storage']['by_type'][$type])) {
+ $response['storage']['by_type'][$type] = 0;
+ }
+ $response['storage']['by_type'][$type] += (int)$stat['count'];
+ }
+ } else {
+ // Stats globales pour super admin
+ $sql = "
+ SELECT
+ fk_entite,
+ COUNT(*) as files,
+ SUM(file_size) as size
+ FROM medias
+ GROUP BY fk_entite
+ ORDER BY size DESC
+ ";
+
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute();
+ $entiteStats = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ $totalSql = "
+ SELECT
+ COUNT(*) as total_files,
+ SUM(file_size) as total_size,
+ COUNT(DISTINCT fk_entite) as entites_count
+ FROM medias
+ ";
+
+ $stmt = $this->db->prepare($totalSql);
+ $stmt->execute();
+ $totals = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ $response = [
+ 'status' => 'success',
+ 'global_stats' => [
+ 'total_files' => (int)$totals['total_files'],
+ 'total_size' => (int)$totals['total_size'],
+ 'entites_count' => (int)$totals['entites_count'],
+ 'by_entite' => []
+ ]
+ ];
+
+ foreach ($entiteStats as $stat) {
+ $response['global_stats']['by_entite'][] = [
+ 'entite_id' => (int)$stat['fk_entite'],
+ 'files' => (int)$stat['files'],
+ 'size' => (int)$stat['size']
+ ];
+ }
+ }
+
+ Response::json($response, 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la récupération des statistiques', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la récupération des statistiques'
+ ], 500);
+ }
+ }
+
+ /**
+ * Téléchargement sécurisé d'un fichier
+ */
+ public function download(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $userInfo = $this->getUserInfo($userId);
+ if (!$userInfo) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Informations utilisateur non trouvées'
+ ], 404);
+ return;
+ }
+
+ $userRole = (int)$userInfo['fk_role'];
+ $userEntiteId = (int)$userInfo['fk_entite'];
+ $fileId = (int)$id;
+
+ // Vérifier l'accès au fichier
+ if (!$this->canAccessFile($fileId, $userRole, $userEntiteId)) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Accès refusé à ce fichier'
+ ], 403);
+ return;
+ }
+
+ // Récupérer les informations du fichier
+ $stmt = $this->db->prepare('
+ SELECT fichier, file_path, mime_type, original_name, file_size
+ FROM medias
+ WHERE id = ?
+ ');
+ $stmt->execute([$fileId]);
+ $file = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$file) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Fichier non trouvé'
+ ], 404);
+ return;
+ }
+
+ $filepath = getcwd() . '/' . $file['file_path'];
+
+ if (!file_exists($filepath)) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Fichier physique non trouvé'
+ ], 404);
+ return;
+ }
+
+ // Log du téléchargement
+ LogService::log('Téléchargement de fichier', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'fileId' => $fileId,
+ 'filename' => $file['original_name']
+ ]);
+
+ // Envoyer le fichier
+ header('Content-Type: ' . $file['mime_type']);
+ header('Content-Disposition: attachment; filename="' . $file['original_name'] . '"');
+ header('Content-Length: ' . filesize($filepath));
+ header('Cache-Control: no-cache, must-revalidate');
+ header('Expires: 0');
+
+ readfile($filepath);
+ exit;
+ } catch (Exception $e) {
+ LogService::log('Erreur lors du téléchargement', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'fileId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors du téléchargement'
+ ], 500);
+ }
+ }
+
+ /**
+ * Suppression sécurisée d'un fichier
+ */
+ public function deleteFile(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $userInfo = $this->getUserInfo($userId);
+ if (!$userInfo) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Informations utilisateur non trouvées'
+ ], 404);
+ return;
+ }
+
+ $userRole = (int)$userInfo['fk_role'];
+ $userEntiteId = (int)$userInfo['fk_entite'];
+ $fileId = (int)$id;
+
+ // Vérifier l'accès au fichier
+ if (!$this->canAccessFile($fileId, $userRole, $userEntiteId)) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Accès refusé à ce fichier'
+ ], 403);
+ return;
+ }
+
+ // Récupérer les informations du fichier
+ $stmt = $this->db->prepare('
+ SELECT fichier, file_path, original_name, support, support_id
+ FROM medias
+ WHERE id = ?
+ ');
+ $stmt->execute([$fileId]);
+ $file = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$file) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Fichier non trouvé'
+ ], 404);
+ return;
+ }
+
+ // Supprimer le fichier physique
+ $filepath = getcwd() . '/' . $file['file_path'];
+ if (file_exists($filepath)) {
+ unlink($filepath);
+ }
+
+ // Supprimer l'enregistrement en base
+ $stmt = $this->db->prepare('DELETE FROM medias WHERE id = ?');
+ $stmt->execute([$fileId]);
+
+ LogService::log('Suppression de fichier', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'fileId' => $fileId,
+ 'filename' => $file['original_name'],
+ 'support' => $file['support'],
+ 'support_id' => $file['support_id']
+ ]);
+
+ Response::json([
+ 'status' => 'success',
+ 'message' => 'Fichier supprimé avec succès'
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la suppression de fichier', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'fileId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la suppression'
+ ], 500);
+ }
+ }
+
+ /**
+ * Informations détaillées d'un fichier
+ */
+ public function getFileInfo(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $userInfo = $this->getUserInfo($userId);
+ if (!$userInfo) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Informations utilisateur non trouvées'
+ ], 404);
+ return;
+ }
+
+ $userRole = (int)$userInfo['fk_role'];
+ $userEntiteId = (int)$userInfo['fk_entite'];
+ $fileId = (int)$id;
+
+ // Vérifier l'accès au fichier
+ if (!$this->canAccessFile($fileId, $userRole, $userEntiteId)) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Accès refusé à ce fichier'
+ ], 403);
+ return;
+ }
+
+ // Récupérer toutes les informations du fichier
+ $stmt = $this->db->prepare('
+ SELECT
+ m.*,
+ u_creat.encrypted_name as creator_name,
+ u_modif.encrypted_name as modifier_name
+ FROM medias m
+ LEFT JOIN users u_creat ON u_creat.id = m.fk_user_creat
+ LEFT JOIN users u_modif ON u_modif.id = m.fk_user_modif
+ WHERE m.id = ?
+ ');
+ $stmt->execute([$fileId]);
+ $file = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$file) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Fichier non trouvé'
+ ], 404);
+ return;
+ }
+
+ // Déchiffrer les noms d'utilisateurs
+ if ($file['creator_name']) {
+ $file['creator_name'] = ApiService::decryptData($file['creator_name']);
+ }
+ if ($file['modifier_name']) {
+ $file['modifier_name'] = ApiService::decryptData($file['modifier_name']);
+ }
+
+ // Vérifier si le fichier physique existe
+ $filepath = getcwd() . '/' . $file['file_path'];
+ $file['file_exists'] = file_exists($filepath);
+
+ Response::json([
+ 'status' => 'success',
+ 'file' => $file
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la récupération des infos fichier', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'fileId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la récupération des informations'
+ ], 500);
+ }
+ }
+
+ /**
+ * Métadonnées du système de fichiers (catégories, extensions, etc.)
+ */
+ public function getMetadata(): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ Response::json([
+ 'status' => 'success',
+ 'categories' => self::FILE_CATEGORIES,
+ 'extensions' => self::ALLOWED_EXTENSIONS,
+ 'mime_types' => [
+ 'pdf' => 'application/pdf',
+ 'jpg' => 'image/jpeg',
+ 'jpeg' => 'image/jpeg',
+ 'png' => 'image/png',
+ 'gif' => 'image/gif',
+ 'webp' => 'image/webp',
+ 'xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+ 'xls' => 'application/vnd.ms-excel',
+ 'json' => 'application/json',
+ 'csv' => 'text/csv'
+ ],
+ 'max_file_sizes' => [
+ 'entite' => 20971520, // 20 MB
+ 'user' => 5242880, // 5 MB
+ 'operation' => 20971520, // 20 MB
+ 'passage' => 10485760 // 10 MB
+ ]
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la récupération des métadonnées', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la récupération des métadonnées'
+ ], 500);
+ }
+ }
+}
diff --git a/api/src/Controllers/LoginController.php b/api/src/Controllers/LoginController.php
index 1e5c6b5e..ae921bad 100644
--- a/api/src/Controllers/LoginController.php
+++ b/api/src/Controllers/LoginController.php
@@ -157,7 +157,6 @@ class LoginController {
'first_name' => $user['first_name'] ?? '',
'fk_role' => $user['fk_role'] ?? '0',
'fk_entite' => $user['fk_entite'] ?? '0',
- // 'interface' supprimée pour se baser uniquement sur le rôle
];
Session::login($sessionData);
@@ -229,13 +228,16 @@ class LoginController {
} elseif ($interface === 'admin' && $user['fk_role'] == 2) {
// Interface admin avec rôle 2 : les 3 dernières opérations dont l'active
$operationLimit = 3;
+ } elseif ($interface === 'admin' && $user['fk_role'] > 2) {
+ // Interface admin avec rôle > 2 : les 10 dernières opérations dont l'active
+ $operationLimit = 10;
} else {
// Autres cas : pas d'opérations
$operationLimit = 0;
}
if ($operationLimit > 0 && !empty($user['fk_entite'])) {
- $operationQuery = "SELECT id, libelle, date_deb, date_fin
+ $operationQuery = "SELECT id, fk_entite, libelle, date_deb, date_fin, chk_active
FROM operations
WHERE fk_entite = ?";
@@ -254,9 +256,11 @@ class LoginController {
foreach ($operations as $operation) {
$operationsData[] = [
'id' => $operation['id'],
- 'name' => $operation['libelle'],
+ 'fk_entite' => $operation['fk_entite'],
+ 'libelle' => $operation['libelle'],
'date_deb' => $operation['date_deb'],
- 'date_fin' => $operation['date_fin']
+ 'date_fin' => $operation['date_fin'],
+ 'chk_active' => $operation['chk_active']
];
}
@@ -435,21 +439,29 @@ class LoginController {
// Déchiffrement du nom
if (!empty($membre['encrypted_name'])) {
$membreItem['name'] = ApiService::decryptData($membre['encrypted_name']);
+ } else {
+ $membreItem['name'] = '';
}
// Déchiffrement du nom d'utilisateur
if (!empty($membre['encrypted_user_name'])) {
$membreItem['username'] = ApiService::decryptSearchableData($membre['encrypted_user_name']);
+ } else {
+ $membreItem['username'] = '';
}
// Déchiffrement du téléphone
if (!empty($membre['encrypted_phone'])) {
$membreItem['phone'] = ApiService::decryptData($membre['encrypted_phone']);
+ } else {
+ $membreItem['phone'] = '';
}
// Déchiffrement du mobile
if (!empty($membre['encrypted_mobile'])) {
$membreItem['mobile'] = ApiService::decryptData($membre['encrypted_mobile']);
+ } else {
+ $membreItem['mobile'] = '';
}
// Déchiffrement de l'email
@@ -458,6 +470,8 @@ class LoginController {
if ($decryptedEmail) {
$membreItem['email'] = $decryptedEmail;
}
+ } else {
+ $membreItem['email'] = '';
}
$membresData[] = $membreItem;
diff --git a/api/src/Controllers/OperationController.php b/api/src/Controllers/OperationController.php
new file mode 100644
index 00000000..5bb9f0ed
--- /dev/null
+++ b/api/src/Controllers/OperationController.php
@@ -0,0 +1,1516 @@
+db = Database::getInstance();
+ $this->appConfig = AppConfig::getInstance();
+ }
+
+ /**
+ * Récupère l'entité de l'utilisateur connecté
+ *
+ * @param int $userId ID de l'utilisateur
+ * @return int|null ID de l'entité ou null si non trouvé
+ */
+ private function getUserEntiteId(int $userId): ?int {
+ try {
+ $stmt = $this->db->prepare('SELECT fk_entite FROM users WHERE id = ?');
+ $stmt->execute([$userId]);
+ $user = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ return $user ? (int)$user['fk_entite'] : null;
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la récupération de l\'entité utilisateur', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'userId' => $userId
+ ]);
+ return null;
+ }
+ }
+
+ /**
+ * Valide les données d'une opération
+ *
+ * @param array $data Données à valider
+ * @param int $entiteId ID de l'entité
+ * @param int|null $operationId ID de l'opération (pour update)
+ * @return array|null Erreurs de validation ou null
+ */
+ private function validateOperationData(array $data, int $entiteId, ?int $operationId = null): ?array {
+ $errors = [];
+
+ // Validation du libellé (accepter 'name' ou 'libelle')
+ $libelle = $data['libelle'] ?? $data['name'] ?? null;
+ if (!$libelle || empty(trim($libelle))) {
+ $errors[] = 'Le nom de l\'opération est obligatoire';
+ } else {
+ $libelle = trim($libelle);
+ if (strlen($libelle) < 5) {
+ $errors[] = 'Le nom de l\'opération doit contenir au moins 5 caractères';
+ }
+ if (strlen($libelle) > 75) {
+ $errors[] = 'Le nom de l\'opération ne peut pas dépasser 75 caractères';
+ }
+
+ // Vérifier l'unicité du nom dans l'entité
+ $sql = 'SELECT COUNT(*) as count FROM operations WHERE fk_entite = ? AND libelle = ? AND chk_active = 1';
+ $params = [$entiteId, $libelle];
+
+ if ($operationId) {
+ $sql .= ' AND id != ?';
+ $params[] = $operationId;
+ }
+
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute($params);
+ $result = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if ($result && $result['count'] > 0) {
+ $errors[] = 'Une opération avec ce nom existe déjà dans votre entité';
+ }
+ }
+
+ // Validation des dates
+ if (!isset($data['date_deb']) || empty($data['date_deb'])) {
+ $errors[] = 'La date de début est obligatoire';
+ }
+
+ if (!isset($data['date_fin']) || empty($data['date_fin'])) {
+ $errors[] = 'La date de fin est obligatoire';
+ }
+
+ if (
+ isset($data['date_deb']) && isset($data['date_fin']) &&
+ !empty($data['date_deb']) && !empty($data['date_fin'])
+ ) {
+
+ $dateDeb = DateTime::createFromFormat('Y-m-d', $data['date_deb']);
+ $dateFin = DateTime::createFromFormat('Y-m-d', $data['date_fin']);
+
+ if (!$dateDeb) {
+ $errors[] = 'Format de date de début invalide (YYYY-MM-DD attendu)';
+ }
+
+ if (!$dateFin) {
+ $errors[] = 'Format de date de fin invalide (YYYY-MM-DD attendu)';
+ }
+
+ if ($dateDeb && $dateFin && $dateFin <= $dateDeb) {
+ $errors[] = 'La date de fin doit être postérieure à la date de début';
+ }
+ }
+
+ return empty($errors) ? null : $errors;
+ }
+
+ /**
+ * Récupère toutes les opérations de l'entité de l'utilisateur
+ */
+ public function getOperations(): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $stmt = $this->db->prepare('
+ SELECT id, libelle, date_deb, date_fin, chk_distinct_sectors,
+ created_at, updated_at, chk_active
+ FROM operations
+ WHERE fk_entite = ?
+ ORDER BY chk_active DESC, created_at DESC
+ ');
+
+ $stmt->execute([$entiteId]);
+ $operations = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ Response::json([
+ 'status' => 'success',
+ 'operations' => $operations
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la récupération des opérations', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la récupération des opérations'
+ ], 500);
+ }
+ }
+
+ /**
+ * Récupère une opération spécifique par son ID
+ */
+ public function getOperationById(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $operationId = (int)$id;
+
+ $stmt = $this->db->prepare('
+ SELECT id, libelle, date_deb, date_fin, chk_distinct_sectors,
+ created_at, updated_at, chk_active
+ FROM operations
+ WHERE id = ? AND fk_entite = ?
+ ');
+
+ $stmt->execute([$operationId, $entiteId]);
+ $operation = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$operation) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Opération non trouvée'
+ ], 404);
+ return;
+ }
+
+ Response::json([
+ 'status' => 'success',
+ 'operation' => $operation
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la récupération de l\'opération', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la récupération de l\'opération'
+ ], 500);
+ }
+ }
+
+ /**
+ * Crée une nouvelle opération avec duplication des données de l'opération active précédente
+ */
+ public function createOperation(): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $data = Request::getJson();
+
+ // Validation des données
+ $errors = $this->validateOperationData($data, $entiteId);
+ if ($errors) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreurs de validation',
+ 'errors' => $errors
+ ], 400);
+ return;
+ }
+
+ $this->db->beginTransaction();
+
+ // Étape 1 : Récupérer l'id de l'opération active actuelle (oldOpeId)
+ $stmt = $this->db->prepare('
+ SELECT id FROM operations
+ WHERE fk_entite = ? AND chk_active = 1
+ LIMIT 1
+ ');
+ $stmt->execute([$entiteId]);
+ $oldOperation = $stmt->fetch(PDO::FETCH_ASSOC);
+ $oldOpeId = $oldOperation ? (int)$oldOperation['id'] : null;
+
+ LogService::log('Étape 1 : Récupération opération active', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'entiteId' => $entiteId,
+ 'oldOpeId' => $oldOpeId
+ ]);
+
+ // Étape 2 : Créer la nouvelle opération (newOpeId) - pas encore active
+ $stmt = $this->db->prepare('
+ INSERT INTO operations (
+ fk_entite, libelle, date_deb, date_fin,
+ chk_distinct_sectors, fk_user_creat, chk_active
+ ) VALUES (?, ?, ?, ?, ?, ?, 0)
+ ');
+
+ $stmt->execute([
+ $entiteId,
+ trim($data['name']),
+ $data['date_deb'],
+ $data['date_fin'],
+ isset($data['chk_distinct_sectors']) ? (int)$data['chk_distinct_sectors'] : 0,
+ $userId
+ ]);
+
+ $newOpeId = (int)$this->db->lastInsertId();
+
+ LogService::log('Étape 2 : Création nouvelle opération', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'entiteId' => $entiteId,
+ 'newOpeId' => $newOpeId,
+ 'libelle' => trim($data['name'])
+ ]);
+
+ // Étape 3 : Insérer tous les users actifs de l'entité dans ope_users avec newOpeId
+ $stmt = $this->db->prepare('
+ INSERT INTO ope_users (fk_operation, fk_user, fk_role, first_name, encrypted_name, sect_name, fk_user_creat)
+ SELECT ?, id, fk_role, first_name, encrypted_name, sect_name, ?
+ FROM users
+ WHERE fk_entite = ? AND chk_active = 1
+ ');
+ $stmt->execute([$newOpeId, $userId, $entiteId]);
+ $insertedUsers = $stmt->rowCount();
+
+ LogService::log('Étape 3 : Insertion users actifs', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'entiteId' => $entiteId,
+ 'newOpeId' => $newOpeId,
+ 'insertedUsers' => $insertedUsers
+ ]);
+
+ // Étape 4 : Si oldOpeId existe, dupliquer les secteurs et données associées
+ $duplicatedSectors = 0;
+ $duplicatedUsersSectors = 0;
+ $duplicatedPassages = 0;
+
+ if ($oldOpeId) {
+ // Étape 4.1 : Récupérer tous les secteurs de l'ancienne opération
+ $stmt = $this->db->prepare('
+ SELECT id, libelle, sector, color
+ FROM ope_sectors
+ WHERE fk_operation = ? AND chk_active = 1
+ ');
+ $stmt->execute([$oldOpeId]);
+ $oldSectors = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ foreach ($oldSectors as $oldSector) {
+ $oldSectId = (int)$oldSector['id'];
+
+ // Étape 4.2 : Dupliquer le secteur avec newOpeId
+ $stmt = $this->db->prepare('
+ INSERT INTO ope_sectors (fk_operation, fk_old_sector, libelle, sector, color, fk_user_creat)
+ VALUES (?, ?, ?, ?, ?, ?)
+ ');
+ $stmt->execute([
+ $newOpeId,
+ $oldSectId,
+ $oldSector['libelle'],
+ $oldSector['sector'],
+ $oldSector['color'],
+ $userId
+ ]);
+ $newSectId = (int)$this->db->lastInsertId();
+ $duplicatedSectors++;
+
+ // Étape 4.3 : Dupliquer les users_sectors en vérifiant que fk_user existe dans ope_users
+ $stmt = $this->db->prepare('
+ INSERT INTO ope_users_sectors (fk_operation, fk_user, fk_sector, fk_user_creat)
+ SELECT ?, ous.fk_user, ?, ?
+ FROM ope_users_sectors ous
+ INNER JOIN ope_users ou ON ou.fk_user = ous.fk_user AND ou.fk_operation = ?
+ WHERE ous.fk_operation = ? AND ous.fk_sector = ? AND ous.chk_active = 1
+ ');
+ $stmt->execute([$newOpeId, $newSectId, $userId, $newOpeId, $oldOpeId, $oldSectId]);
+ $duplicatedUsersSectors += $stmt->rowCount();
+
+ // Étape 4.4 : Dupliquer les passages avec les valeurs par défaut spécifiées
+ $stmt = $this->db->prepare('
+ INSERT INTO ope_pass (
+ fk_operation, fk_sector, fk_user, fk_adresse, numero, rue, rue_bis, ville,
+ fk_habitat, appt, niveau, residence, gps_lat, gps_lng, encrypted_name,
+ fk_type, passed_at, montant, fk_type_reglement, chk_email_sent, chk_striped,
+ docremis, nb_passages, chk_map_create, chk_mobile, chk_synchro, anomalie,
+ fk_user_creat, chk_active
+ )
+ SELECT
+ ?, ?, fk_user, fk_adresse, numero, rue, rue_bis, ville,
+ fk_habitat, appt, niveau, residence, gps_lat, gps_lng, encrypted_name,
+ 2, NULL, 0, 4, 0, 0, 0, 1, 0, 0, 1, 0, ?, 1
+ FROM ope_pass
+ WHERE fk_operation = ? AND fk_sector = ? AND chk_active = 1
+ ');
+ $stmt->execute([$newOpeId, $newSectId, $userId, $oldOpeId, $oldSectId]);
+ $duplicatedPassages += $stmt->rowCount();
+ }
+
+ LogService::log('Étape 4 : Duplication données anciennes opération', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'oldOpeId' => $oldOpeId,
+ 'newOpeId' => $newOpeId,
+ 'duplicatedSectors' => $duplicatedSectors,
+ 'duplicatedUsersSectors' => $duplicatedUsersSectors,
+ 'duplicatedPassages' => $duplicatedPassages
+ ]);
+ }
+
+ // Étape 5 : Désactiver l'ancienne opération
+ if ($oldOpeId) {
+ $stmt = $this->db->prepare('
+ UPDATE operations
+ SET chk_active = 0, updated_at = NOW(), fk_user_modif = ?
+ WHERE id = ?
+ ');
+ $stmt->execute([$userId, $oldOpeId]);
+
+ LogService::log('Étape 5 : Désactivation ancienne opération', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'oldOpeId' => $oldOpeId
+ ]);
+ }
+
+ // Étape 6 : Activer la nouvelle opération
+ $stmt = $this->db->prepare('
+ UPDATE operations
+ SET chk_active = 1, updated_at = NOW(), fk_user_modif = ?
+ WHERE id = ?
+ ');
+ $stmt->execute([$userId, $newOpeId]);
+
+ LogService::log('Étape 6 : Activation nouvelle opération', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'newOpeId' => $newOpeId
+ ]);
+
+ $this->db->commit();
+
+ // Étape 7 : Préparer la réponse avec les groupes JSON
+ $response = OperationDataService::prepareOperationResponse($this->db, $newOpeId, $entiteId);
+
+ LogService::log('Création opération terminée avec succès', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'entiteId' => $entiteId,
+ 'newOpeId' => $newOpeId,
+ 'oldOpeId' => $oldOpeId,
+ 'stats' => [
+ 'insertedUsers' => $insertedUsers,
+ 'duplicatedSectors' => $duplicatedSectors,
+ 'duplicatedUsersSectors' => $duplicatedUsersSectors,
+ 'duplicatedPassages' => $duplicatedPassages
+ ]
+ ]);
+
+ Response::json($response, 201);
+ } catch (Exception $e) {
+ $this->db->rollBack();
+
+ LogService::log('Erreur lors de la création de l\'opération', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la création de l\'opération'
+ ], 500);
+ }
+ }
+
+
+ /**
+ * Met à jour une opération (uniquement l'opération active)
+ */
+ public function updateOperation(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $operationId = (int)$id;
+ $data = Request::getJson();
+
+ // Étape 1: Vérifier que l'opération existe (sans filtrer par entité d'abord)
+ $stmt = $this->db->prepare('
+ SELECT id, fk_entite, chk_active
+ FROM operations
+ WHERE id = ?
+ ');
+
+ $stmt->execute([$operationId]);
+ $operation = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$operation) {
+ LogService::log('Tentative de mise à jour d\'une opération inexistante', [
+ 'level' => 'warning',
+ 'userId' => $userId,
+ 'operationId' => $operationId
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Opération non trouvée'
+ ], 404);
+ return;
+ }
+
+ // Étape 2: Vérifier la cohérence du fk_entite si fourni dans le JSON
+ if (isset($data['fk_entite'])) {
+ $receivedEntiteId = (int)$data['fk_entite'];
+ $operationEntiteId = (int)$operation['fk_entite'];
+
+ if ($receivedEntiteId !== $operationEntiteId) {
+ LogService::log('Incohérence détectée entre fk_entite reçu et celui de l\'opération', [
+ 'level' => 'warning',
+ 'userId' => $userId,
+ 'operationId' => $operationId,
+ 'receivedEntiteId' => $receivedEntiteId,
+ 'operationEntiteId' => $operationEntiteId
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Incohérence détectée : l\'opération n\'appartient pas à l\'entité spécifiée'
+ ], 400);
+ return;
+ }
+ }
+
+ // Étape 3: Vérifier que l'utilisateur a accès à l'entité de l'opération
+ $operationEntiteId = (int)$operation['fk_entite'];
+ if ($operationEntiteId !== $entiteId) {
+ LogService::log('Tentative d\'accès à une opération d\'une autre entité', [
+ 'level' => 'warning',
+ 'userId' => $userId,
+ 'userEntiteId' => $entiteId,
+ 'operationEntiteId' => $operationEntiteId,
+ 'operationId' => $operationId
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous n\'avez pas accès à cette entité'
+ ], 403);
+ return;
+ }
+
+ // Étape 4: Vérifier que l'opération est active
+ if (!$operation['chk_active']) {
+ LogService::log('Tentative de modification d\'une opération inactive', [
+ 'level' => 'warning',
+ 'userId' => $userId,
+ 'operationId' => $operationId
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Seule l\'opération active peut être modifiée'
+ ], 403);
+ return;
+ }
+
+ // Validation des données
+ $errors = $this->validateOperationData($data, $entiteId, $operationId);
+ if ($errors) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreurs de validation',
+ 'errors' => $errors
+ ], 400);
+ return;
+ }
+
+ // Mettre à jour l'opération
+ $stmt = $this->db->prepare('
+ UPDATE operations
+ SET libelle = ?, date_deb = ?, date_fin = ?,
+ chk_distinct_sectors = ?, updated_at = NOW(), fk_user_modif = ?
+ WHERE id = ?
+ ');
+
+ $libelle = trim($data['libelle'] ?? $data['name']);
+ $stmt->execute([
+ $libelle,
+ $data['date_deb'],
+ $data['date_fin'],
+ isset($data['chk_distinct_sectors']) ? (int)$data['chk_distinct_sectors'] : 0,
+ $userId,
+ $operationId
+ ]);
+
+ LogService::log('Mise à jour d\'une opération', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'entiteId' => $entiteId,
+ 'operationId' => $operationId
+ ]);
+
+ Response::json([
+ 'status' => 'success',
+ 'message' => 'Opération mise à jour avec succès'
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la mise à jour de l\'opération', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la mise à jour de l\'opération'
+ ], 500);
+ }
+ }
+
+ /**
+ * Désactive une opération
+ */
+ public function deleteOperation(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $operationId = (int)$id;
+
+ // Récupérer les informations de l'utilisateur (rôle et entité)
+ $stmt = $this->db->prepare('SELECT fk_entite, fk_role FROM users WHERE id = ?');
+ $stmt->execute([$userId]);
+ $user = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$user) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Utilisateur non trouvé'
+ ], 404);
+ return;
+ }
+
+ $userEntiteId = (int)$user['fk_entite'];
+ $userRole = (int)$user['fk_role'];
+
+ // Vérifier que l'utilisateur a un rôle > 1 (pas un simple utilisateur)
+ if ($userRole <= 1) {
+ LogService::log('Tentative de suppression d\'opération avec rôle insuffisant', [
+ 'level' => 'warning',
+ 'userId' => $userId,
+ 'userRole' => $userRole,
+ 'operationId' => $operationId
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous n\'avez pas les droits suffisants pour supprimer une opération'
+ ], 403);
+ return;
+ }
+
+ // Récupérer les informations de l'opération
+ $stmt = $this->db->prepare('
+ SELECT id, fk_entite, chk_active
+ FROM operations
+ WHERE id = ?
+ ');
+
+ $stmt->execute([$operationId]);
+ $operation = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$operation) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Opération non trouvée'
+ ], 404);
+ return;
+ }
+
+ $operationEntiteId = (int)$operation['fk_entite'];
+
+ // Si l'utilisateur a le rôle 2, vérifier qu'il appartient à la même entité que l'opération
+ if ($userRole == 2 && $userEntiteId !== $operationEntiteId) {
+ LogService::log('Tentative de suppression d\'opération d\'une autre entité', [
+ 'level' => 'warning',
+ 'userId' => $userId,
+ 'userRole' => $userRole,
+ 'userEntiteId' => $userEntiteId,
+ 'operationEntiteId' => $operationEntiteId,
+ 'operationId' => $operationId
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous ne pouvez supprimer que les opérations de votre entité'
+ ], 403);
+ return;
+ }
+
+ // Les utilisateurs avec rôle > 2 (super admin, etc.) peuvent supprimer toutes les opérations
+ // Les utilisateurs avec rôle 2 ne peuvent supprimer que les opérations de leur entité
+
+ $operationActive = (bool)$operation['chk_active'];
+
+ // Créer un export complet automatique avant suppression (Excel + JSON)
+ try {
+ $exportService = new ExportService();
+
+ // Générer l'export Excel
+ $excelFile = $exportService->generateExcelExport($operationId, $operationEntiteId);
+
+ // Générer l'export JSON
+ $jsonFile = $exportService->generateJsonExport($operationId, $operationEntiteId, 'auto');
+
+ LogService::log('Export complet automatique créé avant suppression', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'operationId' => $operationId,
+ 'operationActive' => $operationActive,
+ 'excelFile' => $excelFile['filename'],
+ 'jsonFile' => $jsonFile['filename']
+ ]);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de l\'export complet automatique avant suppression', [
+ 'level' => 'warning',
+ 'error' => $e->getMessage(),
+ 'operationId' => $operationId,
+ 'operationActive' => $operationActive
+ ]);
+ // On continue même si l'export échoue
+ }
+
+ // Commencer une transaction pour supprimer toutes les données liées
+ $this->db->beginTransaction();
+
+ try {
+ // 1. Supprimer les médias liés à l'opération
+ $stmt = $this->db->prepare('DELETE FROM medias WHERE support = "operation" AND support_id = ?');
+ $stmt->execute([$operationId]);
+ $deletedMedias = $stmt->rowCount();
+
+ // 2. Supprimer l'historique des passages (via les passages de l'opération)
+ $stmt = $this->db->prepare('
+ DELETE oph FROM ope_pass_histo oph
+ INNER JOIN ope_pass op ON oph.fk_pass = op.id
+ WHERE op.fk_operation = ?
+ ');
+ $stmt->execute([$operationId]);
+ $deletedPassHisto = $stmt->rowCount();
+
+ // 3. Supprimer les passages
+ $stmt = $this->db->prepare('DELETE FROM ope_pass WHERE fk_operation = ?');
+ $stmt->execute([$operationId]);
+ $deletedPass = $stmt->rowCount();
+
+ // 4. Supprimer les relations utilisateurs-secteurs
+ $stmt = $this->db->prepare('DELETE FROM ope_users_sectors WHERE fk_operation = ?');
+ $stmt->execute([$operationId]);
+ $deletedUsersSectors = $stmt->rowCount();
+
+ // 5. Supprimer les adresses des secteurs (via les secteurs de l'opération)
+ $stmt = $this->db->prepare('
+ DELETE sa FROM sectors_adresses sa
+ INNER JOIN ope_sectors os ON sa.fk_sector = os.id
+ WHERE os.fk_operation = ?
+ ');
+ $stmt->execute([$operationId]);
+ $deletedSectorsAdresses = $stmt->rowCount();
+
+ // 6. Supprimer les secteurs
+ $stmt = $this->db->prepare('DELETE FROM ope_sectors WHERE fk_operation = ?');
+ $stmt->execute([$operationId]);
+ $deletedSectors = $stmt->rowCount();
+
+ // 7. Supprimer les utilisateurs de l'opération
+ $stmt = $this->db->prepare('DELETE FROM ope_users WHERE fk_operation = ?');
+ $stmt->execute([$operationId]);
+ $deletedUsers = $stmt->rowCount();
+
+ // 8. Supprimer l'opération elle-même
+ $stmt = $this->db->prepare('DELETE FROM operations WHERE id = ?');
+ $stmt->execute([$operationId]);
+
+ // Valider la transaction
+ $this->db->commit();
+
+ LogService::log('Suppression complète d\'une opération et de toutes ses données', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'userRole' => $userRole,
+ 'userEntiteId' => $userEntiteId,
+ 'operationEntiteId' => $operationEntiteId,
+ 'operationId' => $operationId,
+ 'operationActive' => $operationActive,
+ 'deletedCounts' => [
+ 'medias' => $deletedMedias,
+ 'ope_pass_histo' => $deletedPassHisto,
+ 'ope_pass' => $deletedPass,
+ 'ope_users_sectors' => $deletedUsersSectors,
+ 'sectors_adresses' => $deletedSectorsAdresses,
+ 'ope_sectors' => $deletedSectors,
+ 'ope_users' => $deletedUsers,
+ 'operations' => 1
+ ]
+ ]);
+
+ // Préparer la réponse selon le statut de l'opération supprimée
+ $response = [
+ 'status' => 'success',
+ 'message' => 'Opération et toutes ses données supprimées avec succès',
+ 'operation_was_active' => $operationActive,
+ 'deleted_counts' => [
+ 'medias' => $deletedMedias,
+ 'passages_history' => $deletedPassHisto,
+ 'passages' => $deletedPass,
+ 'user_sectors' => $deletedUsersSectors,
+ 'sectors_addresses' => $deletedSectorsAdresses,
+ 'sectors' => $deletedSectors,
+ 'users' => $deletedUsers
+ ]
+ ];
+
+ // Si l'opération supprimée était active, activer la dernière opération créée
+ $newActiveOperationId = null;
+ if ($operationActive) {
+ // Trouver la dernière opération créée de cette entité
+ $stmt = $this->db->prepare('
+ SELECT id FROM operations
+ WHERE fk_entite = ?
+ ORDER BY id DESC
+ LIMIT 1
+ ');
+ $stmt->execute([$operationEntiteId]);
+ $lastOperation = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if ($lastOperation) {
+ $newActiveOperationId = (int)$lastOperation['id'];
+
+ // Activer cette opération
+ $stmt = $this->db->prepare('
+ UPDATE operations
+ SET chk_active = 1, updated_at = NOW(), fk_user_modif = ?
+ WHERE id = ?
+ ');
+ $stmt->execute([$userId, $newActiveOperationId]);
+
+ LogService::log('Activation automatique de la dernière opération après suppression', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'entiteId' => $operationEntiteId,
+ 'newActiveOperationId' => $newActiveOperationId,
+ 'deletedOperationId' => $operationId
+ ]);
+ }
+ }
+
+ // Récupérer les 3 dernières opérations (dont l'active)
+ $stmt = $this->db->prepare('
+ SELECT id, libelle, date_deb, date_fin, chk_distinct_sectors,
+ created_at, updated_at, chk_active
+ FROM operations
+ WHERE fk_entite = ?
+ ORDER BY chk_active DESC, created_at DESC
+ LIMIT 3
+ ');
+ $stmt->execute([$operationEntiteId]);
+ $operations = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ $response['operations'] = $operations;
+
+ // Si une opération a été activée, récupérer ses données complètes
+ if ($newActiveOperationId) {
+ // Récupérer les secteurs de la nouvelle opération active
+ $stmt = $this->db->prepare('
+ SELECT id, libelle, color, sector, created_at, updated_at, chk_active
+ FROM ope_sectors
+ WHERE fk_operation = ? AND chk_active = 1
+ ORDER BY libelle
+ ');
+ $stmt->execute([$newActiveOperationId]);
+ $sectors = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ // Récupérer les passages de la nouvelle opération active
+ $stmt = $this->db->prepare('
+ SELECT
+ p.id, p.fk_operation, p.fk_sector, p.fk_user, p.fk_adresse,
+ p.passed_at, p.fk_type, p.numero, p.rue, p.rue_bis, p.ville,
+ p.fk_habitat, p.appt, p.niveau, p.residence, p.gps_lat, p.gps_lng,
+ p.encrypted_name, p.montant, p.fk_type_reglement, p.remarque,
+ p.encrypted_email, p.encrypted_phone, p.nom_recu, p.date_recu,
+ p.chk_email_sent, p.docremis, p.date_repasser, p.nb_passages,
+ p.chk_mobile, p.anomalie, p.created_at, p.updated_at, p.chk_active
+ FROM ope_pass p
+ WHERE p.fk_operation = ? AND p.chk_active = 1
+ ORDER BY p.created_at DESC
+ LIMIT 50
+ ');
+ $stmt->execute([$newActiveOperationId]);
+ $passages = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ // Déchiffrer les données sensibles des passages
+ foreach ($passages as &$passage) {
+ $passage['name'] = ApiService::decryptData($passage['encrypted_name']);
+ $passage['email'] = !empty($passage['encrypted_email']) ?
+ ApiService::decryptSearchableData($passage['encrypted_email']) : '';
+ $passage['phone'] = !empty($passage['encrypted_phone']) ?
+ ApiService::decryptData($passage['encrypted_phone']) : '';
+
+ // Suppression des champs chiffrés
+ unset($passage['encrypted_name'], $passage['encrypted_email'], $passage['encrypted_phone']);
+ }
+
+ // Récupérer les relations utilisateurs-secteurs
+ $stmt = $this->db->prepare('
+ SELECT
+ ous.id, ous.fk_operation, ous.fk_user, ous.fk_sector,
+ ous.created_at, ous.updated_at, ous.chk_active,
+ u.encrypted_name as user_name, u.first_name as user_first_name,
+ s.libelle as sector_name
+ FROM ope_users_sectors ous
+ INNER JOIN users u ON u.id = ous.fk_user
+ INNER JOIN ope_sectors s ON s.id = ous.fk_sector
+ WHERE ous.fk_operation = ? AND ous.chk_active = 1
+ ORDER BY s.libelle, u.encrypted_name
+ ');
+ $stmt->execute([$newActiveOperationId]);
+ $usersSectors = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ // Déchiffrer les noms d'utilisateurs
+ foreach ($usersSectors as &$userSector) {
+ $userSector['user_name'] = ApiService::decryptData($userSector['user_name']);
+ unset($userSector['encrypted_name']);
+ }
+
+ $response['activated_operation'] = [
+ 'id' => $newActiveOperationId,
+ 'sectors' => $sectors,
+ 'passages' => $passages,
+ 'users_sectors' => $usersSectors
+ ];
+ }
+
+ Response::json($response, 200);
+ } catch (Exception $e) {
+ // Annuler la transaction en cas d'erreur
+ $this->db->rollBack();
+
+ LogService::log('Erreur lors de la suppression complète de l\'opération', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $operationId,
+ 'operationActive' => $operationActive,
+ 'userId' => $userId
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la suppression complète de l\'opération'
+ ], 500);
+ return;
+ }
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la suppression de l\'opération', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la suppression de l\'opération'
+ ], 500);
+ }
+ }
+
+ /**
+ * Export Excel d'une opération (retourne directement le fichier)
+ */
+ public function exportExcel(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $operationId = (int)$id;
+
+ // Vérifier d'abord si l'opération existe (sans filtrer par entité)
+ $stmt = $this->db->prepare('
+ SELECT id, libelle, chk_active, fk_entite
+ FROM operations
+ WHERE id = ?
+ ');
+
+ $stmt->execute([$operationId]);
+ $operation = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$operation) {
+ LogService::log('Opération inexistante pour export Excel', [
+ 'level' => 'warning',
+ 'operationId' => $operationId,
+ 'userId' => $userId,
+ 'entiteId' => $entiteId
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Opération non trouvée'
+ ], 404);
+ return;
+ }
+
+ // Vérifier que l'opération appartient à l'entité de l'utilisateur
+ if ((int)$operation['fk_entite'] !== $entiteId) {
+ LogService::log('Tentative d\'accès à une opération d\'une autre entité pour export Excel', [
+ 'level' => 'warning',
+ 'operationId' => $operationId,
+ 'operationEntiteId' => (int)$operation['fk_entite'],
+ 'userEntiteId' => $entiteId,
+ 'userId' => $userId
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous n\'avez pas accès à cette opération'
+ ], 403);
+ return;
+ }
+
+ // Paramètre optionnel pour filtrer par utilisateur
+ $filterUserId = isset($_GET['user_id']) ? (int)$_GET['user_id'] : null;
+
+ // Générer l'export Excel
+ $exportService = new ExportService();
+ $fileInfo = $exportService->generateExcelExport($operationId, $entiteId, $filterUserId);
+
+ // Construire le chemin complet du fichier
+ $filepath = getcwd() . '/' . $fileInfo['path'];
+
+ if (!file_exists($filepath)) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Fichier Excel non trouvé'
+ ], 404);
+ return;
+ }
+
+ // Nettoyer le nom de l'opération pour le nom de fichier
+ $operationName = preg_replace('/[^a-zA-Z0-9\-_]/', '_', $operation['libelle']);
+ $userSuffix = $filterUserId ? "-user{$filterUserId}" : '';
+ $timestamp = date('Ymd-His');
+ $downloadFilename = "export-{$operationName}{$userSuffix}-{$timestamp}.xlsx";
+
+ // Envoyer le fichier Excel directement
+ header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
+ header('Content-Disposition: attachment; filename="' . $downloadFilename . '"');
+ header('Content-Length: ' . filesize($filepath));
+ header('Cache-Control: must-revalidate');
+ header('Pragma: public');
+
+ // Lire et envoyer le fichier
+ readfile($filepath);
+
+ LogService::log('Export Excel téléchargé', [
+ 'level' => 'info',
+ 'operationId' => $operationId,
+ 'entiteId' => $entiteId,
+ 'userId' => $userId,
+ 'filename' => $downloadFilename,
+ 'filterUserId' => $filterUserId
+ ]);
+
+ exit;
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de l\'export Excel', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la génération de l\'export Excel'
+ ], 500);
+ }
+ }
+
+ /**
+ * Export JSON d'une opération (sauvegarde)
+ */
+ public function exportJson(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $operationId = (int)$id;
+
+ // Vérifier que l'opération existe et appartient à l'entité
+ $stmt = $this->db->prepare('
+ SELECT id, chk_active
+ FROM operations
+ WHERE id = ? AND fk_entite = ?
+ ');
+
+ $stmt->execute([$operationId, $entiteId]);
+ $operation = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$operation) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Opération non trouvée'
+ ], 404);
+ return;
+ }
+
+ // Type d'export (manual par défaut)
+ $exportType = $_GET['type'] ?? 'manual';
+
+ // Générer l'export JSON
+ $exportService = new ExportService();
+ $fileInfo = $exportService->generateJsonExport($operationId, $entiteId, $exportType);
+
+ Response::json([
+ 'status' => 'success',
+ 'message' => 'Sauvegarde JSON générée avec succès',
+ 'file' => $fileInfo
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de l\'export JSON', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la génération de la sauvegarde JSON'
+ ], 500);
+ }
+ }
+
+ /**
+ * Export complet (Excel + JSON)
+ */
+ public function exportFull(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $operationId = (int)$id;
+
+ // Vérifier que l'opération existe et appartient à l'entité
+ $stmt = $this->db->prepare('
+ SELECT id, chk_active
+ FROM operations
+ WHERE id = ? AND fk_entite = ?
+ ');
+
+ $stmt->execute([$operationId, $entiteId]);
+ $operation = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$operation) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Opération non trouvée'
+ ], 404);
+ return;
+ }
+
+ $exportService = new ExportService();
+
+ // Générer les deux exports
+ $excelFile = $exportService->generateExcelExport($operationId, $entiteId);
+ $jsonFile = $exportService->generateJsonExport($operationId, $entiteId, 'manual');
+
+ Response::json([
+ 'status' => 'success',
+ 'message' => 'Export complet généré avec succès',
+ 'files' => [
+ 'excel' => $excelFile,
+ 'json' => $jsonFile
+ ]
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de l\'export complet', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la génération de l\'export complet'
+ ], 500);
+ }
+ }
+
+ /**
+ * Liste des sauvegardes d'une opération
+ */
+ public function getBackups(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $operationId = (int)$id;
+
+ // Vérifier que l'opération existe et appartient à l'entité
+ $stmt = $this->db->prepare('
+ SELECT id
+ FROM operations
+ WHERE id = ? AND fk_entite = ?
+ ');
+
+ $stmt->execute([$operationId, $entiteId]);
+ $operation = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$operation) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Opération non trouvée'
+ ], 404);
+ return;
+ }
+
+ // Récupérer les fichiers d'export de cette opération
+ $stmt = $this->db->prepare('
+ SELECT
+ id, fichier, file_type, file_size, description,
+ created_at, fk_user_creat
+ FROM medias
+ WHERE support = "operation" AND support_id = ? AND fk_entite = ?
+ ORDER BY created_at DESC
+ ');
+
+ $stmt->execute([$operationId, $entiteId]);
+ $backups = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ Response::json([
+ 'status' => 'success',
+ 'backups' => $backups
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la récupération des sauvegardes', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la récupération des sauvegardes'
+ ], 500);
+ }
+ }
+
+ /**
+ * Télécharger une sauvegarde spécifique
+ */
+ public function downloadBackup(string $id, string $backup_id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $operationId = (int)$id;
+ $backupId = (int)$backup_id;
+
+ // Vérifier que le fichier existe et appartient à l'opération/entité
+ $stmt = $this->db->prepare('
+ SELECT m.fichier, m.file_path, m.mime_type, m.original_name
+ FROM medias m
+ INNER JOIN operations o ON o.id = m.support_id
+ WHERE m.id = ? AND m.support = "operation" AND m.support_id = ?
+ AND o.fk_entite = ?
+ ');
+
+ $stmt->execute([$backupId, $operationId, $entiteId]);
+ $backup = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$backup) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Fichier de sauvegarde non trouvé'
+ ], 404);
+ return;
+ }
+
+ $filepath = getcwd() . '/' . $backup['file_path'];
+
+ if (!file_exists($filepath)) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Fichier physique non trouvé'
+ ], 404);
+ return;
+ }
+
+ // Envoyer le fichier
+ header('Content-Type: ' . $backup['mime_type']);
+ header('Content-Disposition: attachment; filename="' . $backup['original_name'] . '"');
+ header('Content-Length: ' . filesize($filepath));
+ readfile($filepath);
+ exit;
+ } catch (Exception $e) {
+ LogService::log('Erreur lors du téléchargement de sauvegarde', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $id,
+ 'backupId' => $backup_id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors du téléchargement'
+ ], 500);
+ }
+ }
+
+ /**
+ * Supprimer une sauvegarde
+ */
+ public function deleteBackup(string $id, string $backup_id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $operationId = (int)$id;
+ $backupId = (int)$backup_id;
+
+ // Vérifier que le fichier existe et appartient à l'opération/entité
+ $stmt = $this->db->prepare('
+ SELECT m.id, m.file_path
+ FROM medias m
+ INNER JOIN operations o ON o.id = m.support_id
+ WHERE m.id = ? AND m.support = "operation" AND m.support_id = ?
+ AND o.fk_entite = ?
+ ');
+
+ $stmt->execute([$backupId, $operationId, $entiteId]);
+ $backup = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$backup) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Fichier de sauvegarde non trouvé'
+ ], 404);
+ return;
+ }
+
+ // Supprimer le fichier physique
+ $filepath = getcwd() . '/' . $backup['file_path'];
+ if (file_exists($filepath)) {
+ unlink($filepath);
+ }
+
+ // Supprimer l'enregistrement en base
+ $stmt = $this->db->prepare('DELETE FROM medias WHERE id = ?');
+ $stmt->execute([$backupId]);
+
+ LogService::log('Suppression d\'une sauvegarde', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'operationId' => $operationId,
+ 'backupId' => $backupId
+ ]);
+
+ Response::json([
+ 'status' => 'success',
+ 'message' => 'Sauvegarde supprimée avec succès'
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la suppression de sauvegarde', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $id,
+ 'backupId' => $backup_id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la suppression'
+ ], 500);
+ }
+ }
+}
diff --git a/api/src/Controllers/PassageController.php b/api/src/Controllers/PassageController.php
new file mode 100644
index 00000000..89a34f9d
--- /dev/null
+++ b/api/src/Controllers/PassageController.php
@@ -0,0 +1,803 @@
+db = Database::getInstance();
+ $this->appConfig = AppConfig::getInstance();
+ }
+
+ /**
+ * Récupère l'entité de l'utilisateur connecté
+ *
+ * @param int $userId ID de l'utilisateur
+ * @return int|null ID de l'entité ou null si non trouvé
+ */
+ private function getUserEntiteId(int $userId): ?int {
+ try {
+ $stmt = $this->db->prepare('SELECT fk_entite FROM users WHERE id = ?');
+ $stmt->execute([$userId]);
+ $user = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ return $user ? (int)$user['fk_entite'] : null;
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la récupération de l\'entité utilisateur', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'userId' => $userId
+ ]);
+ return null;
+ }
+ }
+
+ /**
+ * Vérifie si l'utilisateur a accès à l'opération
+ *
+ * @param int $userId ID de l'utilisateur
+ * @param int $operationId ID de l'opération
+ * @return bool True si l'utilisateur a accès
+ */
+ private function hasAccessToOperation(int $userId, int $operationId): bool {
+ try {
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ return false;
+ }
+
+ $stmt = $this->db->prepare('
+ SELECT COUNT(*) as count
+ FROM operations
+ WHERE id = ? AND fk_entite = ? AND chk_active = 1
+ ');
+ $stmt->execute([$operationId, $entiteId]);
+ $result = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ return $result && $result['count'] > 0;
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la vérification d\'accès à l\'opération', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'userId' => $userId,
+ 'operationId' => $operationId
+ ]);
+ return false;
+ }
+ }
+
+ /**
+ * Valide les données d'un passage
+ *
+ * @param array $data Données à valider
+ * @param int|null $passageId ID du passage (pour update)
+ * @return array|null Erreurs de validation ou null
+ */
+ private function validatePassageData(array $data, ?int $passageId = null): ?array {
+ $errors = [];
+
+ // Validation de l'opération
+ if (!isset($data['fk_operation']) || empty($data['fk_operation'])) {
+ $errors[] = 'L\'ID de l\'opération est obligatoire';
+ }
+
+ // Validation de l'utilisateur
+ if (!isset($data['fk_user']) || empty($data['fk_user'])) {
+ $errors[] = 'L\'ID de l\'utilisateur est obligatoire';
+ }
+
+ // Validation de l'adresse
+ if (!isset($data['numero']) || empty(trim($data['numero']))) {
+ $errors[] = 'Le numéro de rue est obligatoire';
+ }
+
+ if (!isset($data['rue']) || empty(trim($data['rue']))) {
+ $errors[] = 'Le nom de rue est obligatoire';
+ }
+
+ if (!isset($data['ville']) || empty(trim($data['ville']))) {
+ $errors[] = 'La ville est obligatoire';
+ }
+
+ // Validation du nom (chiffré)
+ if (!isset($data['encrypted_name']) && !isset($data['name'])) {
+ $errors[] = 'Le nom est obligatoire';
+ }
+
+ // Validation du montant
+ if (isset($data['montant'])) {
+ $montant = (float)$data['montant'];
+ if ($montant < 0) {
+ $errors[] = 'Le montant ne peut pas être négatif';
+ }
+ if ($montant > 999999.99) {
+ $errors[] = 'Le montant ne peut pas dépasser 999999.99';
+ }
+ }
+
+ // Validation de l'email si fourni
+ if (isset($data['email']) && !empty($data['email'])) {
+ if (!filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
+ $errors[] = 'Format d\'email invalide';
+ }
+ }
+
+ // Validation des coordonnées GPS si fournies
+ if (isset($data['gps_lat']) && !empty($data['gps_lat'])) {
+ $lat = (float)$data['gps_lat'];
+ if ($lat < -90 || $lat > 90) {
+ $errors[] = 'Latitude invalide (doit être entre -90 et 90)';
+ }
+ }
+
+ if (isset($data['gps_lng']) && !empty($data['gps_lng'])) {
+ $lng = (float)$data['gps_lng'];
+ if ($lng < -180 || $lng > 180) {
+ $errors[] = 'Longitude invalide (doit être entre -180 et 180)';
+ }
+ }
+
+ return empty($errors) ? null : $errors;
+ }
+
+ /**
+ * Récupère tous les passages de l'entité de l'utilisateur
+ */
+ public function getPassages(): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ // Paramètres de pagination
+ $page = isset($_GET['page']) ? max(1, (int)$_GET['page']) : 1;
+ $limit = isset($_GET['limit']) ? min(100, max(1, (int)$_GET['limit'])) : 20;
+ $offset = ($page - 1) * $limit;
+
+ // Filtres optionnels
+ $operationId = isset($_GET['operation_id']) ? (int)$_GET['operation_id'] : null;
+ $userId_filter = isset($_GET['user_id']) ? (int)$_GET['user_id'] : null;
+
+ // Construction de la requête
+ $whereConditions = ['o.fk_entite = ?'];
+ $params = [$entiteId];
+
+ if ($operationId) {
+ $whereConditions[] = 'p.fk_operation = ?';
+ $params[] = $operationId;
+ }
+
+ if ($userId_filter) {
+ $whereConditions[] = 'p.fk_user = ?';
+ $params[] = $userId_filter;
+ }
+
+ $whereClause = implode(' AND ', $whereConditions);
+
+ // Requête principale avec jointures
+ $stmt = $this->db->prepare("
+ SELECT
+ p.id, p.fk_operation, p.fk_sector, p.fk_user, p.fk_adresse,
+ p.passed_at, p.fk_type, p.numero, p.rue, p.rue_bis, p.ville,
+ p.fk_habitat, p.appt, p.niveau, p.residence, p.gps_lat, p.gps_lng,
+ p.encrypted_name, p.montant, p.fk_type_reglement, p.remarque,
+ p.encrypted_email, p.encrypted_phone, p.nom_recu, p.date_recu,
+ p.chk_email_sent, p.docremis, p.date_repasser, p.nb_passages,
+ p.chk_mobile, p.anomalie, p.created_at, p.updated_at, p.chk_active,
+ o.libelle as operation_libelle,
+ u.encrypted_name as user_name, u.first_name as user_first_name
+ FROM ope_pass p
+ INNER JOIN operations o ON p.fk_operation = o.id
+ INNER JOIN users u ON p.fk_user = u.id
+ WHERE $whereClause AND p.chk_active = 1
+ ORDER BY p.created_at DESC
+ LIMIT ? OFFSET ?
+ ");
+
+ $params[] = $limit;
+ $params[] = $offset;
+ $stmt->execute($params);
+ $passages = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ // Déchiffrement des données sensibles
+ foreach ($passages as &$passage) {
+ $passage['name'] = ApiService::decryptData($passage['encrypted_name']);
+ $passage['email'] = !empty($passage['encrypted_email']) ?
+ ApiService::decryptSearchableData($passage['encrypted_email']) : '';
+ $passage['phone'] = !empty($passage['encrypted_phone']) ?
+ ApiService::decryptData($passage['encrypted_phone']) : '';
+ $passage['user_name'] = ApiService::decryptData($passage['user_name']);
+
+ // Suppression des champs chiffrés
+ unset($passage['encrypted_name'], $passage['encrypted_email'], $passage['encrypted_phone']);
+ }
+
+ // Compter le total pour la pagination
+ $countStmt = $this->db->prepare("
+ SELECT COUNT(*) as total
+ FROM ope_pass p
+ INNER JOIN operations o ON p.fk_operation = o.id
+ WHERE $whereClause AND p.chk_active = 1
+ ");
+ $countStmt->execute(array_slice($params, 0, -2)); // Enlever limit et offset
+ $totalResult = $countStmt->fetch(PDO::FETCH_ASSOC);
+ $total = $totalResult['total'];
+
+ Response::json([
+ 'status' => 'success',
+ 'passages' => $passages,
+ 'pagination' => [
+ 'page' => $page,
+ 'limit' => $limit,
+ 'total' => $total,
+ 'pages' => ceil($total / $limit)
+ ]
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la récupération des passages', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la récupération des passages'
+ ], 500);
+ }
+ }
+
+ /**
+ * Récupère un passage spécifique par son ID
+ */
+ public function getPassageById(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $passageId = (int)$id;
+
+ $stmt = $this->db->prepare('
+ SELECT
+ p.*,
+ o.libelle as operation_libelle,
+ u.encrypted_name as user_name, u.first_name as user_first_name
+ FROM ope_pass p
+ INNER JOIN operations o ON p.fk_operation = o.id
+ INNER JOIN users u ON p.fk_user = u.id
+ WHERE p.id = ? AND o.fk_entite = ? AND p.chk_active = 1
+ ');
+
+ $stmt->execute([$passageId, $entiteId]);
+ $passage = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$passage) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Passage non trouvé'
+ ], 404);
+ return;
+ }
+
+ // Déchiffrement des données sensibles
+ $passage['name'] = ApiService::decryptData($passage['encrypted_name']);
+ $passage['email'] = !empty($passage['encrypted_email']) ?
+ ApiService::decryptSearchableData($passage['encrypted_email']) : '';
+ $passage['phone'] = !empty($passage['encrypted_phone']) ?
+ ApiService::decryptData($passage['encrypted_phone']) : '';
+ $passage['user_name'] = ApiService::decryptData($passage['user_name']);
+
+ // Suppression des champs chiffrés
+ unset($passage['encrypted_name'], $passage['encrypted_email'], $passage['encrypted_phone']);
+
+ Response::json([
+ 'status' => 'success',
+ 'passage' => $passage
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la récupération du passage', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'passageId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la récupération du passage'
+ ], 500);
+ }
+ }
+
+ /**
+ * Récupère tous les passages d'une opération spécifique
+ */
+ public function getPassagesByOperation(string $operation_id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $operationId = (int)$operation_id;
+
+ // Vérifier l'accès à l'opération
+ if (!$this->hasAccessToOperation($userId, $operationId)) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous n\'avez pas accès à cette opération'
+ ], 403);
+ return;
+ }
+
+ // Paramètres de pagination
+ $page = isset($_GET['page']) ? max(1, (int)$_GET['page']) : 1;
+ $limit = isset($_GET['limit']) ? min(100, max(1, (int)$_GET['limit'])) : 50;
+ $offset = ($page - 1) * $limit;
+
+ $stmt = $this->db->prepare('
+ SELECT
+ p.id, p.fk_operation, p.fk_sector, p.fk_user, p.passed_at,
+ p.numero, p.rue, p.rue_bis, p.ville, p.gps_lat, p.gps_lng,
+ p.encrypted_name, p.montant, p.fk_type_reglement, p.remarque,
+ p.encrypted_email, p.encrypted_phone, p.chk_email_sent,
+ p.docremis, p.date_repasser, p.nb_passages, p.chk_mobile,
+ p.anomalie, p.created_at, p.updated_at,
+ u.encrypted_name as user_name, u.first_name as user_first_name
+ FROM ope_pass p
+ INNER JOIN users u ON p.fk_user = u.id
+ WHERE p.fk_operation = ? AND p.chk_active = 1
+ ORDER BY p.created_at DESC
+ LIMIT ? OFFSET ?
+ ');
+
+ $stmt->execute([$operationId, $limit, $offset]);
+ $passages = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ // Déchiffrement des données sensibles
+ foreach ($passages as &$passage) {
+ $passage['name'] = ApiService::decryptData($passage['encrypted_name']);
+ $passage['email'] = !empty($passage['encrypted_email']) ?
+ ApiService::decryptSearchableData($passage['encrypted_email']) : '';
+ $passage['phone'] = !empty($passage['encrypted_phone']) ?
+ ApiService::decryptData($passage['encrypted_phone']) : '';
+ $passage['user_name'] = ApiService::decryptData($passage['user_name']);
+
+ // Suppression des champs chiffrés
+ unset($passage['encrypted_name'], $passage['encrypted_email'], $passage['encrypted_phone']);
+ }
+
+ // Compter le total
+ $countStmt = $this->db->prepare('
+ SELECT COUNT(*) as total
+ FROM ope_pass
+ WHERE fk_operation = ? AND chk_active = 1
+ ');
+ $countStmt->execute([$operationId]);
+ $totalResult = $countStmt->fetch(PDO::FETCH_ASSOC);
+ $total = $totalResult['total'];
+
+ Response::json([
+ 'status' => 'success',
+ 'passages' => $passages,
+ 'pagination' => [
+ 'page' => $page,
+ 'limit' => $limit,
+ 'total' => $total,
+ 'pages' => ceil($total / $limit)
+ ]
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la récupération des passages par opération', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $operation_id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la récupération des passages'
+ ], 500);
+ }
+ }
+
+ /**
+ * Crée un nouveau passage
+ */
+ public function createPassage(): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $data = Request::getJson();
+
+ // Validation des données
+ $errors = $this->validatePassageData($data);
+ if ($errors) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreurs de validation',
+ 'errors' => $errors
+ ], 400);
+ return;
+ }
+
+ $operationId = (int)$data['fk_operation'];
+
+ // Vérifier l'accès à l'opération
+ if (!$this->hasAccessToOperation($userId, $operationId)) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous n\'avez pas accès à cette opération'
+ ], 403);
+ return;
+ }
+
+ // Chiffrement des données sensibles
+ $encryptedName = isset($data['name']) ? ApiService::encryptData($data['name']) : (isset($data['encrypted_name']) ? $data['encrypted_name'] : '');
+ $encryptedEmail = isset($data['email']) && !empty($data['email']) ?
+ ApiService::encryptSearchableData($data['email']) : '';
+ $encryptedPhone = isset($data['phone']) && !empty($data['phone']) ?
+ ApiService::encryptData($data['phone']) : '';
+
+ // Préparation des données pour l'insertion
+ $insertData = [
+ 'fk_operation' => $operationId,
+ 'fk_sector' => isset($data['fk_sector']) ? (int)$data['fk_sector'] : 0,
+ 'fk_user' => (int)$data['fk_user'],
+ 'fk_adresse' => $data['fk_adresse'] ?? '',
+ 'passed_at' => isset($data['passed_at']) ? $data['passed_at'] : null,
+ 'fk_type' => isset($data['fk_type']) ? (int)$data['fk_type'] : 0,
+ 'numero' => trim($data['numero']),
+ 'rue' => trim($data['rue']),
+ 'rue_bis' => $data['rue_bis'] ?? '',
+ 'ville' => trim($data['ville']),
+ 'fk_habitat' => isset($data['fk_habitat']) ? (int)$data['fk_habitat'] : 1,
+ 'appt' => $data['appt'] ?? '',
+ 'niveau' => $data['niveau'] ?? '',
+ 'residence' => $data['residence'] ?? '',
+ 'gps_lat' => $data['gps_lat'] ?? '',
+ 'gps_lng' => $data['gps_lng'] ?? '',
+ 'encrypted_name' => $encryptedName,
+ 'montant' => isset($data['montant']) ? (float)$data['montant'] : 0.00,
+ 'fk_type_reglement' => isset($data['fk_type_reglement']) ? (int)$data['fk_type_reglement'] : 1,
+ 'remarque' => $data['remarque'] ?? '',
+ 'encrypted_email' => $encryptedEmail,
+ 'encrypted_phone' => $encryptedPhone,
+ 'nom_recu' => $data['nom_recu'] ?? null,
+ 'date_recu' => isset($data['date_recu']) ? $data['date_recu'] : null,
+ 'docremis' => isset($data['docremis']) ? (int)$data['docremis'] : 0,
+ 'date_repasser' => isset($data['date_repasser']) ? $data['date_repasser'] : null,
+ 'nb_passages' => isset($data['nb_passages']) ? (int)$data['nb_passages'] : 1,
+ 'chk_mobile' => isset($data['chk_mobile']) ? (int)$data['chk_mobile'] : 0,
+ 'anomalie' => isset($data['anomalie']) ? (int)$data['anomalie'] : 0,
+ 'fk_user_creat' => $userId
+ ];
+
+ // Construction de la requête d'insertion
+ $fields = array_keys($insertData);
+ $placeholders = array_fill(0, count($fields), '?');
+
+ $sql = 'INSERT INTO ope_pass (' . implode(', ', $fields) . ') VALUES (' . implode(', ', $placeholders) . ')';
+
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute(array_values($insertData));
+
+ $passageId = $this->db->lastInsertId();
+
+ LogService::log('Création d\'un nouveau passage', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'passageId' => $passageId,
+ 'operationId' => $operationId
+ ]);
+
+ Response::json([
+ 'status' => 'success',
+ 'message' => 'Passage créé avec succès',
+ 'passage_id' => $passageId
+ ], 201);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la création du passage', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la création du passage'
+ ], 500);
+ }
+ }
+
+ /**
+ * Met à jour un passage existant
+ */
+ public function updatePassage(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $passageId = (int)$id;
+ $data = Request::getJson();
+
+ // Vérifier que le passage existe et appartient à l'entité de l'utilisateur
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $stmt = $this->db->prepare('
+ SELECT p.id, p.fk_operation
+ FROM ope_pass p
+ INNER JOIN operations o ON p.fk_operation = o.id
+ WHERE p.id = ? AND o.fk_entite = ? AND p.chk_active = 1
+ ');
+ $stmt->execute([$passageId, $entiteId]);
+ $passage = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$passage) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Passage non trouvé'
+ ], 404);
+ return;
+ }
+
+ // Validation des données
+ $errors = $this->validatePassageData($data, $passageId);
+ if ($errors) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreurs de validation',
+ 'errors' => $errors
+ ], 400);
+ return;
+ }
+
+ // Construction de la requête de mise à jour dynamique
+ $updateFields = [];
+ $params = [];
+
+ // Champs pouvant être mis à jour
+ $updatableFields = [
+ 'fk_sector',
+ 'fk_user',
+ 'fk_adresse',
+ 'passed_at',
+ 'fk_type',
+ 'numero',
+ 'rue',
+ 'rue_bis',
+ 'ville',
+ 'fk_habitat',
+ 'appt',
+ 'niveau',
+ 'residence',
+ 'gps_lat',
+ 'gps_lng',
+ 'montant',
+ 'fk_type_reglement',
+ 'remarque',
+ 'nom_recu',
+ 'date_recu',
+ 'docremis',
+ 'date_repasser',
+ 'nb_passages',
+ 'chk_mobile',
+ 'anomalie'
+ ];
+
+ foreach ($updatableFields as $field) {
+ if (isset($data[$field])) {
+ $updateFields[] = "$field = ?";
+ $params[] = $data[$field];
+ }
+ }
+
+ // Gestion des champs chiffrés
+ if (isset($data['name'])) {
+ $updateFields[] = "encrypted_name = ?";
+ $params[] = ApiService::encryptData($data['name']);
+ }
+
+ if (isset($data['email'])) {
+ $updateFields[] = "encrypted_email = ?";
+ $params[] = !empty($data['email']) ? ApiService::encryptSearchableData($data['email']) : '';
+ }
+
+ if (isset($data['phone'])) {
+ $updateFields[] = "encrypted_phone = ?";
+ $params[] = !empty($data['phone']) ? ApiService::encryptData($data['phone']) : '';
+ }
+
+ if (empty($updateFields)) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Aucune donnée à mettre à jour'
+ ], 400);
+ return;
+ }
+
+ // Ajout des champs de mise à jour
+ $updateFields[] = "updated_at = NOW()";
+ $updateFields[] = "fk_user_modif = ?";
+ $params[] = $userId;
+ $params[] = $passageId;
+
+ $sql = 'UPDATE ope_pass SET ' . implode(', ', $updateFields) . ' WHERE id = ?';
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute($params);
+
+ LogService::log('Mise à jour d\'un passage', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'passageId' => $passageId
+ ]);
+
+ Response::json([
+ 'status' => 'success',
+ 'message' => 'Passage mis à jour avec succès'
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la mise à jour du passage', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'passageId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la mise à jour du passage'
+ ], 500);
+ }
+ }
+
+ /**
+ * Supprime (désactive) un passage
+ */
+ public function deletePassage(string $id): void {
+ try {
+ $userId = Session::getUserId();
+ if (!$userId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Vous devez être connecté pour effectuer cette action'
+ ], 401);
+ return;
+ }
+
+ $passageId = (int)$id;
+
+ // Vérifier que le passage existe et appartient à l'entité de l'utilisateur
+ $entiteId = $this->getUserEntiteId($userId);
+ if (!$entiteId) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Entité non trouvée pour cet utilisateur'
+ ], 404);
+ return;
+ }
+
+ $stmt = $this->db->prepare('
+ SELECT p.id
+ FROM ope_pass p
+ INNER JOIN operations o ON p.fk_operation = o.id
+ WHERE p.id = ? AND o.fk_entite = ? AND p.chk_active = 1
+ ');
+ $stmt->execute([$passageId, $entiteId]);
+ $passage = $stmt->fetch(PDO::FETCH_ASSOC);
+
+ if (!$passage) {
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Passage non trouvé'
+ ], 404);
+ return;
+ }
+
+ // Désactiver le passage (soft delete)
+ $stmt = $this->db->prepare('
+ UPDATE ope_pass
+ SET chk_active = 0, updated_at = NOW(), fk_user_modif = ?
+ WHERE id = ?
+ ');
+
+ $stmt->execute([$userId, $passageId]);
+
+ LogService::log('Suppression d\'un passage', [
+ 'level' => 'info',
+ 'userId' => $userId,
+ 'passageId' => $passageId
+ ]);
+
+ Response::json([
+ 'status' => 'success',
+ 'message' => 'Passage supprimé avec succès'
+ ], 200);
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la suppression du passage', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'passageId' => $id,
+ 'userId' => $userId ?? null
+ ]);
+
+ Response::json([
+ 'status' => 'error',
+ 'message' => 'Erreur lors de la suppression du passage'
+ ], 500);
+ }
+ }
+}
diff --git a/api/src/Core/Router.php b/api/src/Core/Router.php
index e514f4d6..dd9fbd4e 100644
--- a/api/src/Core/Router.php
+++ b/api/src/Core/Router.php
@@ -45,8 +45,41 @@ class Router {
$this->get('entites/postal/:code', ['EntiteController', 'getEntiteByPostalCode']);
$this->put('entites/:id', ['EntiteController', 'updateEntite']);
+ // Routes opérations
+ $this->get('operations', ['OperationController', 'getOperations']);
+ $this->get('operations/:id', ['OperationController', 'getOperationById']);
+ $this->post('operations', ['OperationController', 'createOperation']);
+ $this->put('operations/:id', ['OperationController', 'updateOperation']);
+ $this->delete('operations/:id', ['OperationController', 'deleteOperation']);
+
+ // Routes d'export d'opérations
+ $this->get('operations/:id/export/excel', ['OperationController', 'exportExcel']);
+ $this->get('operations/:id/export/json', ['OperationController', 'exportJson']);
+ $this->get('operations/:id/export/full', ['OperationController', 'exportFull']);
+ $this->get('operations/:id/backups', ['OperationController', 'getBackups']);
+ $this->get('operations/:id/backups/:backup_id', ['OperationController', 'downloadBackup']);
+ $this->delete('operations/:id/backups/:backup_id', ['OperationController', 'deleteBackup']);
+
+ // Routes passages
+ $this->get('passages', ['PassageController', 'getPassages']);
+ $this->get('passages/:id', ['PassageController', 'getPassageById']);
+ $this->get('passages/operation/:operation_id', ['PassageController', 'getPassagesByOperation']);
+ $this->post('passages', ['PassageController', 'createPassage']);
+ $this->put('passages/:id', ['PassageController', 'updatePassage']);
+ $this->delete('passages/:id', ['PassageController', 'deletePassage']);
+
// Routes villes
$this->get('villes', ['VilleController', 'searchVillesByPostalCode']);
+
+ // Routes fichiers
+ $this->get('files/browse', ['FileController', 'browse']);
+ $this->get('files/search', ['FileController', 'search']);
+ $this->get('files/stats', ['FileController', 'getStats']);
+ $this->get('files/metadata', ['FileController', 'getMetadata']);
+ $this->get('files/list/:support/:id', ['FileController', 'listBySupport']);
+ $this->get('files/info/:id', ['FileController', 'getFileInfo']);
+ $this->get('files/download/:id', ['FileController', 'download']);
+ $this->delete('files/:id', ['FileController', 'deleteFile']);
}
public function handle(): void {
diff --git a/api/src/Services/BackupEncryptionService.php b/api/src/Services/BackupEncryptionService.php
new file mode 100644
index 00000000..3600a842
--- /dev/null
+++ b/api/src/Services/BackupEncryptionService.php
@@ -0,0 +1,304 @@
+appConfig = AppConfig::getInstance();
+ $this->encryptionKey = $this->appConfig->getBackupEncryptionKey();
+ $this->backupConfig = $this->appConfig->getBackupConfig();
+ }
+
+ /**
+ * Chiffre et compresse les données JSON d'un backup
+ *
+ * @param string $jsonData Données JSON à sauvegarder
+ * @return string Données chiffrées et compressées en base64
+ * @throws Exception En cas d'erreur de compression ou chiffrement
+ */
+ public function encryptBackup(string $jsonData): string {
+ try {
+ // Étape 1: Compression GZIP si activée
+ $dataToEncrypt = $jsonData;
+ if ($this->backupConfig['compression']) {
+ $compressed = gzencode($jsonData, $this->backupConfig['compression_level']);
+ if ($compressed === false) {
+ throw new Exception('Erreur lors de la compression GZIP');
+ }
+ $dataToEncrypt = $compressed;
+
+ LogService::log('Compression backup réussie', [
+ 'level' => 'debug',
+ 'original_size' => strlen($jsonData),
+ 'compressed_size' => strlen($compressed),
+ 'compression_ratio' => round((1 - strlen($compressed) / strlen($jsonData)) * 100, 2) . '%'
+ ]);
+ }
+
+ // Étape 2: Génération d'un IV aléatoire pour AES-256-CBC
+ $ivLength = openssl_cipher_iv_length($this->backupConfig['cipher']);
+ $iv = openssl_random_pseudo_bytes($ivLength);
+
+ if ($iv === false || strlen($iv) !== $ivLength) {
+ throw new Exception('Erreur lors de la génération de l\'IV');
+ }
+
+ // Étape 3: Chiffrement AES-256-CBC
+ $encrypted = openssl_encrypt(
+ $dataToEncrypt,
+ $this->backupConfig['cipher'],
+ $this->encryptionKey,
+ OPENSSL_RAW_DATA,
+ $iv
+ );
+
+ if ($encrypted === false) {
+ throw new Exception('Erreur lors du chiffrement AES-256');
+ }
+
+ // Étape 4: Concaténation IV + données chiffrées et encodage base64
+ $finalData = base64_encode($iv . $encrypted);
+
+ LogService::log('Chiffrement backup réussi', [
+ 'level' => 'debug',
+ 'data_size' => strlen($dataToEncrypt),
+ 'encrypted_size' => strlen($finalData),
+ 'cipher' => $this->backupConfig['cipher']
+ ]);
+
+ return $finalData;
+ } catch (Exception $e) {
+ LogService::log('Erreur lors du chiffrement du backup', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'data_size' => strlen($jsonData)
+ ]);
+ throw $e;
+ }
+ }
+
+ /**
+ * Déchiffre et décompresse les données d'un backup
+ *
+ * @param string $encryptedData Données chiffrées en base64
+ * @return string Données JSON originales
+ * @throws Exception En cas d'erreur de déchiffrement ou décompression
+ */
+ public function decryptBackup(string $encryptedData): string {
+ try {
+ // Étape 1: Décodage base64
+ $rawData = base64_decode($encryptedData);
+ if ($rawData === false) {
+ throw new Exception('Erreur lors du décodage base64');
+ }
+
+ // Étape 2: Extraction de l'IV
+ $ivLength = openssl_cipher_iv_length($this->backupConfig['cipher']);
+ if (strlen($rawData) < $ivLength) {
+ throw new Exception('Données corrompues : taille insuffisante pour l\'IV');
+ }
+
+ $iv = substr($rawData, 0, $ivLength);
+ $encryptedContent = substr($rawData, $ivLength);
+
+ // Étape 3: Déchiffrement AES-256-CBC
+ $decrypted = openssl_decrypt(
+ $encryptedContent,
+ $this->backupConfig['cipher'],
+ $this->encryptionKey,
+ OPENSSL_RAW_DATA,
+ $iv
+ );
+
+ if ($decrypted === false) {
+ throw new Exception('Erreur lors du déchiffrement : clé invalide ou données corrompues');
+ }
+
+ LogService::log('Déchiffrement backup réussi', [
+ 'level' => 'debug',
+ 'encrypted_size' => strlen($encryptedData),
+ 'decrypted_size' => strlen($decrypted)
+ ]);
+
+ // Étape 4: Décompression GZIP si les données sont compressées
+ $finalData = $decrypted;
+ if ($this->backupConfig['compression']) {
+ // Vérifier si les données sont bien compressées (magic number GZIP)
+ if (substr($decrypted, 0, 2) === "\x1f\x8b") {
+ $decompressed = gzdecode($decrypted);
+ if ($decompressed === false) {
+ throw new Exception('Erreur lors de la décompression GZIP');
+ }
+ $finalData = $decompressed;
+
+ LogService::log('Décompression backup réussie', [
+ 'level' => 'debug',
+ 'compressed_size' => strlen($decrypted),
+ 'decompressed_size' => strlen($decompressed)
+ ]);
+ }
+ }
+
+ // Étape 5: Validation que le résultat est du JSON valide
+ $jsonTest = json_decode($finalData, true);
+ if ($jsonTest === null && json_last_error() !== JSON_ERROR_NONE) {
+ throw new Exception('Les données déchiffrées ne sont pas du JSON valide : ' . json_last_error_msg());
+ }
+
+ return $finalData;
+ } catch (Exception $e) {
+ LogService::log('Erreur lors du déchiffrement du backup', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'encrypted_size' => strlen($encryptedData)
+ ]);
+ throw $e;
+ }
+ }
+
+ /**
+ * Vérifie si un fichier de backup est chiffré
+ *
+ * @param string $filePath Chemin vers le fichier
+ * @return bool True si le fichier est chiffré
+ */
+ public function isEncryptedBackup(string $filePath): bool {
+ return str_ends_with($filePath, '.json.gz.enc') || str_ends_with($filePath, '.enc');
+ }
+
+ /**
+ * Vérifie si un fichier de backup est compressé (mais pas chiffré)
+ *
+ * @param string $filePath Chemin vers le fichier
+ * @return bool True si le fichier est compressé
+ */
+ public function isCompressedBackup(string $filePath): bool {
+ return str_ends_with($filePath, '.json.gz') && !str_ends_with($filePath, '.enc');
+ }
+
+ /**
+ * Lit un fichier de backup en détectant automatiquement le format
+ *
+ * @param string $filePath Chemin vers le fichier de backup
+ * @return array Données JSON décodées
+ * @throws Exception En cas d'erreur de lecture ou format non supporté
+ */
+ public function readBackupFile(string $filePath): array {
+ if (!file_exists($filePath)) {
+ throw new Exception("Fichier de backup non trouvé : {$filePath}");
+ }
+
+ $fileContent = file_get_contents($filePath);
+ if ($fileContent === false) {
+ throw new Exception("Impossible de lire le fichier : {$filePath}");
+ }
+
+ try {
+ // Fichier chiffré
+ if ($this->isEncryptedBackup($filePath)) {
+ $jsonContent = $this->decryptBackup($fileContent);
+ }
+ // Fichier compressé seulement
+ elseif ($this->isCompressedBackup($filePath)) {
+ $jsonContent = gzdecode($fileContent);
+ if ($jsonContent === false) {
+ throw new Exception('Erreur lors de la décompression du fichier');
+ }
+ }
+ // Fichier JSON brut
+ else {
+ $jsonContent = $fileContent;
+ }
+
+ // Décodage JSON
+ $data = json_decode($jsonContent, true);
+ if ($data === null && json_last_error() !== JSON_ERROR_NONE) {
+ throw new Exception('JSON invalide : ' . json_last_error_msg());
+ }
+
+ LogService::log('Lecture backup réussie', [
+ 'level' => 'info',
+ 'file_path' => $filePath,
+ 'file_size' => filesize($filePath),
+ 'is_encrypted' => $this->isEncryptedBackup($filePath),
+ 'is_compressed' => $this->isCompressedBackup($filePath)
+ ]);
+
+ return $data;
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la lecture du backup', [
+ 'level' => 'error',
+ 'file_path' => $filePath,
+ 'error' => $e->getMessage()
+ ]);
+ throw $e;
+ }
+ }
+
+ /**
+ * Génère le nom de fichier approprié selon la configuration
+ *
+ * @param int $operationId ID de l'opération
+ * @param string $timestamp Timestamp pour l'unicité
+ * @param string $type Type d'export (manual, auto, etc.)
+ * @return string Nom du fichier avec extension appropriée
+ */
+ public function generateBackupFilename(int $operationId, string $timestamp, string $type = 'manual'): string {
+ $baseName = "backup_operation_{$operationId}_{$timestamp}";
+
+ if ($type !== 'manual') {
+ $baseName .= "_{$type}";
+ }
+
+ // Extension selon la configuration
+ $extension = '.json';
+
+ if ($this->backupConfig['compression']) {
+ $extension .= '.gz';
+ }
+
+ // Toujours chiffré
+ $extension .= '.enc';
+
+ return $baseName . $extension;
+ }
+
+ /**
+ * Retourne les statistiques de compression et chiffrement
+ *
+ * @param string $originalJson JSON original
+ * @param string $finalData Données finales chiffrées
+ * @return array Statistiques détaillées
+ */
+ public function getCompressionStats(string $originalJson, string $finalData): array {
+ $originalSize = strlen($originalJson);
+ $finalSize = strlen($finalData);
+
+ return [
+ 'original_size' => $originalSize,
+ 'final_size' => $finalSize,
+ 'size_reduction' => $originalSize - $finalSize,
+ 'compression_ratio' => $originalSize > 0 ? round((1 - $finalSize / $originalSize) * 100, 2) : 0,
+ 'is_compressed' => $this->backupConfig['compression'],
+ 'is_encrypted' => true,
+ 'cipher' => $this->backupConfig['cipher']
+ ];
+ }
+}
diff --git a/api/src/Services/ExportService.php b/api/src/Services/ExportService.php
new file mode 100644
index 00000000..053ca94f
--- /dev/null
+++ b/api/src/Services/ExportService.php
@@ -0,0 +1,933 @@
+db = Database::getInstance();
+ $this->fileService = new FileService();
+ }
+
+ /**
+ * Génère un export Excel complet d'une opération
+ *
+ * @param int $operationId ID de l'opération
+ * @param int $entiteId ID de l'entité
+ * @param int|null $userId Filtrer par utilisateur (optionnel)
+ * @return array Informations du fichier généré
+ */
+ public function generateExcelExport(int $operationId, int $entiteId, ?int $userId = null): array {
+ try {
+ // Récupérer les données de l'opération
+ $operationData = $this->getOperationData($operationId, $entiteId);
+ if (!$operationData) {
+ throw new Exception('Opération non trouvée');
+ }
+
+ // Créer le dossier de destination
+ $exportDir = $this->fileService->createDirectory($entiteId, "/{$entiteId}/operations/{$operationId}/exports/excel");
+
+ LogService::log('exportDir', [
+ 'level' => 'warning',
+ 'exportDir' => $exportDir,
+ ]);
+
+ // Générer le nom du fichier
+ $timestamp = date('Ymd-His');
+ $userSuffix = $userId ? "-user{$userId}" : '';
+ $filename = "geosector-export-{$operationId}{$userSuffix}-{$timestamp}.xlsx";
+ $filepath = $exportDir . '/' . $filename;
+
+ // Créer le spreadsheet
+ $spreadsheet = new PhpOffice\PhpSpreadsheet\Spreadsheet();
+
+ // Insérer les données
+ $this->createPassagesSheet($spreadsheet, $operationId, $userId);
+ $this->createUsersSheet($spreadsheet, $operationId);
+ $this->createSectorsSheet($spreadsheet, $operationId);
+ $this->createUserSectorsSheet($spreadsheet, $operationId);
+
+ // Supprimer la feuille par défaut (Worksheet) qui est créée automatiquement
+ $defaultSheet = $spreadsheet->getSheetByName('Worksheet');
+ if ($defaultSheet) {
+ $spreadsheet->removeSheetByIndex($spreadsheet->getIndex($defaultSheet));
+ }
+
+ // Essayer d'abord le writer XLSX, sinon utiliser CSV
+ try {
+ $writer = new Xls($spreadsheet);
+ $writer->save($filepath);
+ } catch (Exception $e) {
+ // Si XLSX échoue, utiliser CSV comme fallback
+ $csvPath = str_replace('.xlsx', '.csv', $filepath);
+ $csvWriter = new Csv($spreadsheet);
+ $csvWriter->setDelimiter(';');
+ $csvWriter->setEnclosure('"');
+ $csvWriter->save($csvPath);
+
+ // Mettre à jour les variables pour le CSV
+ $filepath = $csvPath;
+ $filename = str_replace('.xlsx', '.csv', $filename);
+
+ LogService::log('Fallback vers CSV car XLSX a échoué', [
+ 'level' => 'warning',
+ 'error' => $e->getMessage(),
+ 'operationId' => $operationId
+ ]);
+ }
+
+ // Appliquer les permissions sur le fichier
+ $this->fileService->setFilePermissions($filepath);
+
+ // Déterminer le type de fichier réellement généré
+ $fileType = str_ends_with($filename, '.csv') ? 'csv' : 'xlsx';
+
+ // Enregistrer en base de données
+ $mediaId = $this->fileService->saveToMediasTable($entiteId, $operationId, $filename, $filepath, $fileType, 'Export Excel opération - ' . $operationData['libelle']);
+
+ LogService::log('Export Excel généré', [
+ 'level' => 'info',
+ 'operationId' => $operationId,
+ 'entiteId' => $entiteId,
+ 'path' => $exportDir,
+ 'filename' => $filename,
+ 'mediaId' => $mediaId
+ ]);
+
+ return [
+ 'id' => $mediaId,
+ 'filename' => $filename,
+ 'path' => str_replace(getcwd() . '/', '', $filepath),
+ 'size' => filesize($filepath),
+ 'type' => 'excel'
+ ];
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la génération de l\'export Excel', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $operationId,
+ 'entiteId' => $entiteId
+ ]);
+ throw $e;
+ }
+ }
+
+ /**
+ * Génère un export JSON complet d'une opération (chiffré et compressé)
+ *
+ * @param int $operationId ID de l'opération
+ * @param int $entiteId ID de l'entité
+ * @param string $type Type d'export (auto, manual)
+ * @return array Informations du fichier généré
+ */
+ public function generateJsonExport(int $operationId, int $entiteId, string $type = 'manual'): array {
+ try {
+ // Récupérer toutes les données de l'opération
+ $exportData = $this->collectOperationData($operationId, $entiteId);
+
+ // Créer le dossier de destination
+ $exportDir = $this->fileService->createDirectory($entiteId, "/{$entiteId}/operations/{$operationId}/exports/json");
+
+ // Initialiser le service de chiffrement
+ $backupService = new BackupEncryptionService();
+
+ // Générer le JSON original
+ $jsonData = json_encode($exportData, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
+
+ // Chiffrer et compresser les données
+ $encryptedData = $backupService->encryptBackup($jsonData);
+
+ // Générer le nom du fichier avec extension appropriée
+ $timestamp = date('Ymd-His');
+ $filename = $backupService->generateBackupFilename($operationId, $timestamp, $type);
+ $filepath = $exportDir . '/' . $filename;
+
+ // Sauvegarder le fichier chiffré
+ file_put_contents($filepath, $encryptedData);
+
+ // Appliquer les permissions sur le fichier
+ $this->fileService->setFilePermissions($filepath);
+
+ // Obtenir les statistiques de compression
+ $stats = $backupService->getCompressionStats($jsonData, $encryptedData);
+
+ // Enregistrer en base de données avec le bon type MIME
+ $mediaId = $this->fileService->saveToMediasTable(
+ $entiteId,
+ $operationId,
+ $filename,
+ $filepath,
+ 'enc',
+ "Sauvegarde chiffrée opération - {$type} - " . $exportData['operation']['libelle'],
+ 'backup'
+ );
+
+ LogService::log('Export JSON chiffré généré', [
+ 'level' => 'info',
+ 'operationId' => $operationId,
+ 'entiteId' => $entiteId,
+ 'filename' => $filename,
+ 'type' => $type,
+ 'mediaId' => $mediaId,
+ 'original_size' => $stats['original_size'],
+ 'final_size' => $stats['final_size'],
+ 'compression_ratio' => $stats['compression_ratio'] . '%',
+ 'is_compressed' => $stats['is_compressed'],
+ 'cipher' => $stats['cipher']
+ ]);
+
+ return [
+ 'id' => $mediaId,
+ 'filename' => $filename,
+ 'path' => str_replace(getcwd() . '/', '', $filepath),
+ 'size' => filesize($filepath),
+ 'type' => 'encrypted_json',
+ 'compression_stats' => $stats
+ ];
+ } catch (Exception $e) {
+ LogService::log('Erreur lors de la génération de l\'export JSON chiffré', [
+ 'level' => 'error',
+ 'error' => $e->getMessage(),
+ 'operationId' => $operationId,
+ 'entiteId' => $entiteId
+ ]);
+ throw $e;
+ }
+ }
+
+ /**
+ * Crée la feuille des passages
+ */
+ private function createPassagesSheet(Spreadsheet $spreadsheet, int $operationId, ?int $userId = null): void {
+ $sheet = $spreadsheet->createSheet();
+ $sheet->setTitle('Passages');
+
+ // En-têtes
+ $headers = [
+ 'ID_Passage',
+ 'Date',
+ 'Heure',
+ 'Prénom',
+ 'Nom',
+ 'Tournée',
+ 'Type',
+ 'N°',
+ 'Bis',
+ 'Rue',
+ 'Ville',
+ 'Habitat',
+ 'Donateur',
+ 'Email',
+ 'Tél',
+ 'Montant',
+ 'Règlement',
+ 'Remarque',
+ 'FK_User',
+ 'FK_Sector',
+ 'FK_Operation'
+ ];
+
+ // Écrire les en-têtes
+ $sheet->fromArray([$headers], null, 'A1');
+
+ // Récupérer les données des passages
+ $sql = '
+ SELECT
+ p.id, p.passed_at, p.fk_type, p.numero, p.rue_bis, p.rue, p.ville,
+ p.fk_habitat, p.appt, p.niveau, p.encrypted_name, p.encrypted_email,
+ p.encrypted_phone, p.montant, p.fk_type_reglement, p.remarque,
+ p.fk_user, p.fk_sector, p.fk_operation,
+ u.encrypted_name as user_name, u.first_name as user_first_name, u.sect_name,
+ xtr.libelle as reglement_libelle
+ FROM ope_pass p
+ LEFT JOIN users u ON u.id = p.fk_user
+ LEFT JOIN x_types_reglements xtr ON xtr.id = p.fk_type_reglement
+ WHERE p.fk_operation = ? AND p.chk_active = 1
+ ';
+
+ $params = [$operationId];
+ if ($userId) {
+ $sql .= ' AND p.fk_user = ?';
+ $params[] = $userId;
+ }
+
+ $sql .= ' ORDER BY p.passed_at DESC';
+
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute($params);
+ $passages = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ // Remplir les données
+ $row = 2;
+ foreach ($passages as $passage) {
+ $dateEve = $passage['passed_at'] ? date('d/m/Y', strtotime($passage['passed_at'])) : '';
+ $heureEve = $passage['passed_at'] ? date('H:i', strtotime($passage['passed_at'])) : '';
+
+ // Déchiffrer les données
+ $donateur = ApiService::decryptData($passage['encrypted_name']);
+ $email = !empty($passage['encrypted_email']) ? ApiService::decryptSearchableData($passage['encrypted_email']) : '';
+ $phone = !empty($passage['encrypted_phone']) ? ApiService::decryptData($passage['encrypted_phone']) : '';
+ $userName = ApiService::decryptData($passage['user_name']);
+
+ // Type de passage
+ $typeLabels = [
+ 1 => 'Effectué',
+ 2 => 'A finaliser',
+ 3 => 'Refusé',
+ 4 => 'Don',
+ 9 => 'Habitat vide'
+ ];
+ $typeLabel = $typeLabels[$passage['fk_type']] ?? $passage['fk_type'];
+
+ // Habitat
+ $habitat = $passage['fk_habitat'] == 1 ? 'Individuel' :
+ "Etage {$passage['niveau']} - Appt {$passage['appt']}";
+
+ $rowData = [
+ $passage['id'],
+ $dateEve,
+ $heureEve,
+ $passage['user_first_name'],
+ $userName,
+ $passage['sect_name'],
+ $typeLabel,
+ $passage['numero'],
+ $passage['rue_bis'],
+ $passage['rue'],
+ $passage['ville'],
+ $habitat,
+ $donateur,
+ $email,
+ $phone,
+ $passage['montant'],
+ $passage['reglement_libelle'],
+ $passage['remarque'],
+ $passage['fk_user'],
+ $passage['fk_sector'],
+ $passage['fk_operation']
+ ];
+
+ $sheet->fromArray([$rowData], null, "A{$row}");
+ $row++;
+ }
+
+ // Auto-ajuster les colonnes
+ foreach (range('A', 'T') as $col) {
+ $sheet->getColumnDimension($col)->setAutoSize(true);
+ }
+ }
+
+ /**
+ * Crée la feuille des utilisateurs
+ */
+ private function createUsersSheet(Spreadsheet $spreadsheet, int $operationId): void {
+ $sheet = $spreadsheet->createSheet();
+ $sheet->setTitle('Utilisateurs');
+
+ // En-têtes
+ $headers = [
+ 'ID_User',
+ 'Nom',
+ 'Prénom',
+ 'Email',
+ 'Téléphone',
+ 'Mobile',
+ 'Rôle',
+ 'Date_création',
+ 'Actif',
+ 'FK_Entite'
+ ];
+
+ $sheet->fromArray([$headers], null, 'A1');
+
+ // Récupérer les utilisateurs de l'opération
+ $sql = '
+ SELECT DISTINCT
+ u.id, u.encrypted_name, u.first_name, u.encrypted_email,
+ u.encrypted_phone, u.encrypted_mobile, u.fk_role, u.created_at,
+ u.chk_active, u.fk_entite,
+ r.libelle as role_libelle
+ FROM users u
+ INNER JOIN ope_users ou ON ou.fk_user = u.id
+ LEFT JOIN x_users_roles r ON r.id = u.fk_role
+ WHERE ou.fk_operation = ? AND ou.chk_active = 1
+ ORDER BY u.encrypted_name
+ ';
+
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute([$operationId]);
+ $users = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ $row = 2;
+ foreach ($users as $user) {
+ $rowData = [
+ $user['id'],
+ ApiService::decryptData($user['encrypted_name']),
+ $user['first_name'],
+ !empty($user['encrypted_email']) ? ApiService::decryptSearchableData($user['encrypted_email']) : '',
+ !empty($user['encrypted_phone']) ? ApiService::decryptData($user['encrypted_phone']) : '',
+ !empty($user['encrypted_mobile']) ? ApiService::decryptData($user['encrypted_mobile']) : '',
+ $user['role_libelle'],
+ date('d/m/Y H:i', strtotime($user['created_at'])),
+ $user['chk_active'] ? 'Oui' : 'Non',
+ $user['fk_entite']
+ ];
+
+ $sheet->fromArray([$rowData], null, "A{$row}");
+ $row++;
+ }
+
+ foreach (range('A', 'J') as $col) {
+ $sheet->getColumnDimension($col)->setAutoSize(true);
+ }
+ }
+
+ /**
+ * Crée la feuille des secteurs
+ */
+ private function createSectorsSheet(Spreadsheet $spreadsheet, int $operationId): void {
+ $sheet = $spreadsheet->createSheet();
+ $sheet->setTitle('Secteurs');
+
+ $headers = ['ID_Sector', 'Libellé', 'Couleur', 'Date_création', 'Actif', 'FK_Operation'];
+ $sheet->fromArray([$headers], null, 'A1');
+
+ $sql = '
+ SELECT id, libelle, color, created_at, chk_active, fk_operation
+ FROM ope_sectors
+ WHERE fk_operation = ? AND chk_active = 1
+ ORDER BY libelle
+ ';
+
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute([$operationId]);
+ $sectors = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ $row = 2;
+ foreach ($sectors as $sector) {
+ $rowData = [
+ $sector['id'],
+ $sector['libelle'],
+ $sector['color'],
+ date('d/m/Y H:i', strtotime($sector['created_at'])),
+ $sector['chk_active'] ? 'Oui' : 'Non',
+ $sector['fk_operation']
+ ];
+
+ $sheet->fromArray([$rowData], null, "A{$row}");
+ $row++;
+ }
+
+ foreach (range('A', 'F') as $col) {
+ $sheet->getColumnDimension($col)->setAutoSize(true);
+ }
+ }
+
+ /**
+ * Crée la feuille des relations secteurs-utilisateurs
+ */
+ private function createUserSectorsSheet(Spreadsheet $spreadsheet, int $operationId): void {
+ $sheet = $spreadsheet->createSheet();
+ $sheet->setTitle('Secteurs-Utilisateurs');
+
+ $headers = [
+ 'ID_Relation',
+ 'FK_Sector',
+ 'Nom_Secteur',
+ 'FK_User',
+ 'Nom_Utilisateur',
+ 'Date_assignation',
+ 'FK_Operation'
+ ];
+ $sheet->fromArray([$headers], null, 'A1');
+
+ $sql = '
+ SELECT
+ ous.id, ous.fk_sector, ous.fk_user, ous.created_at, ous.fk_operation,
+ s.libelle as sector_name,
+ u.encrypted_name as user_name, u.first_name
+ FROM ope_users_sectors ous
+ INNER JOIN ope_sectors s ON s.id = ous.fk_sector
+ INNER JOIN users u ON u.id = ous.fk_user
+ WHERE ous.fk_operation = ? AND ous.chk_active = 1
+ ORDER BY s.libelle, u.encrypted_name
+ ';
+
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute([$operationId]);
+ $userSectors = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ $row = 2;
+ foreach ($userSectors as $us) {
+ $userName = ApiService::decryptData($us['user_name']);
+ $fullUserName = $us['first_name'] ? $us['first_name'] . ' ' . $userName : $userName;
+
+ $rowData = [
+ $us['id'],
+ $us['fk_sector'],
+ $us['sector_name'],
+ $us['fk_user'],
+ $fullUserName,
+ date('d/m/Y H:i', strtotime($us['created_at'])),
+ $us['fk_operation']
+ ];
+
+ $sheet->fromArray([$rowData], null, "A{$row}");
+ $row++;
+ }
+
+ foreach (range('A', 'G') as $col) {
+ $sheet->getColumnDimension($col)->setAutoSize(true);
+ }
+ }
+
+ /**
+ * Collecte toutes les données d'une opération pour l'export JSON
+ */
+ private function collectOperationData(int $operationId, int $entiteId): array {
+ // Métadonnées de l'export
+ $exportData = [
+ 'export_metadata' => [
+ 'version' => '1.0',
+ 'export_date' => date('c'),
+ 'source_entite_id' => $entiteId,
+ 'export_type' => 'full_operation'
+ ]
+ ];
+
+ // Données de l'opération
+ $exportData['operation'] = $this->getOperationData($operationId, $entiteId);
+
+ // Utilisateurs de l'opération
+ $exportData['users'] = $this->getOperationUsers($operationId);
+
+ // Secteurs de l'opération
+ $exportData['sectors'] = $this->getOperationSectors($operationId);
+
+ // Passages de l'opération
+ $exportData['passages'] = $this->getOperationPassages($operationId);
+
+ // Relations utilisateurs-secteurs
+ $exportData['user_sectors'] = $this->getOperationUserSectors($operationId);
+
+ return $exportData;
+ }
+
+ /**
+ * Récupère les données de l'opération
+ */
+ private function getOperationData(int $operationId, int $entiteId): ?array {
+ $stmt = $this->db->prepare('
+ SELECT * FROM operations
+ WHERE id = ? AND fk_entite = ?
+ ');
+ $stmt->execute([$operationId, $entiteId]);
+ return $stmt->fetch(PDO::FETCH_ASSOC) ?: null;
+ }
+
+ /**
+ * Récupère les utilisateurs de l'opération
+ */
+ private function getOperationUsers(int $operationId): array {
+ $stmt = $this->db->prepare('
+ SELECT DISTINCT u.*
+ FROM users u
+ INNER JOIN ope_users ou ON ou.fk_user = u.id
+ WHERE ou.fk_operation = ? AND ou.chk_active = 1
+ ');
+ $stmt->execute([$operationId]);
+ return $stmt->fetchAll(PDO::FETCH_ASSOC);
+ }
+
+ /**
+ * Récupère les secteurs de l'opération
+ */
+ private function getOperationSectors(int $operationId): array {
+ $stmt = $this->db->prepare('
+ SELECT * FROM ope_sectors
+ WHERE fk_operation = ? AND chk_active = 1
+ ');
+ $stmt->execute([$operationId]);
+ return $stmt->fetchAll(PDO::FETCH_ASSOC);
+ }
+
+ /**
+ * Récupère les passages de l'opération
+ */
+ private function getOperationPassages(int $operationId): array {
+ $stmt = $this->db->prepare('
+ SELECT * FROM ope_pass
+ WHERE fk_operation = ? AND chk_active = 1
+ ');
+ $stmt->execute([$operationId]);
+ return $stmt->fetchAll(PDO::FETCH_ASSOC);
+ }
+
+ /**
+ * Récupère les relations utilisateurs-secteurs
+ */
+ private function getOperationUserSectors(int $operationId): array {
+ $stmt = $this->db->prepare('
+ SELECT * FROM ope_users_sectors
+ WHERE fk_operation = ? AND chk_active = 1
+ ');
+ $stmt->execute([$operationId]);
+ return $stmt->fetchAll(PDO::FETCH_ASSOC);
+ }
+
+ /**
+ * Récupère les données des passages dans un format simple pour l'export Excel
+ * (inspiré de l'ancienne version qui fonctionne)
+ */
+ private function getSimplePassagesData(int $operationId, ?int $userId = null): array {
+ // En-têtes (comme dans l'ancienne version)
+ $aData = [];
+ $aData[] = [
+ 'Date',
+ 'Heure',
+ 'Prenom',
+ 'Nom',
+ 'Tournee',
+ 'Type',
+ 'N°',
+ 'Rue',
+ 'Ville',
+ 'Habitat',
+ 'Donateur',
+ 'Email',
+ 'Tel',
+ 'Montant',
+ 'Reglement',
+ 'Remarque'
+ ];
+
+ // Récupérer les données des passages
+ $sql = '
+ SELECT
+ p.passed_at, p.fk_type, p.numero, p.rue_bis, p.rue, p.ville,
+ p.fk_habitat, p.appt, p.niveau, p.encrypted_name, p.encrypted_email,
+ p.encrypted_phone, p.montant, p.fk_type_reglement, p.remarque,
+ u.encrypted_name as user_name, u.first_name as user_first_name, u.sect_name,
+ xtr.libelle as reglement_libelle
+ FROM ope_pass p
+ LEFT JOIN users u ON u.id = p.fk_user
+ LEFT JOIN x_types_reglements xtr ON xtr.id = p.fk_type_reglement
+ WHERE p.fk_operation = ? AND p.chk_active = 1
+ ';
+
+ $params = [$operationId];
+ if ($userId) {
+ $sql .= ' AND p.fk_user = ?';
+ $params[] = $userId;
+ }
+
+ $sql .= ' ORDER BY p.passed_at DESC';
+
+ $stmt = $this->db->prepare($sql);
+ $stmt->execute($params);
+ $passages = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ // Traiter les données comme dans l'ancienne version
+ foreach ($passages as $p) {
+ // Type de passage
+ switch ($p["fk_type"]) {
+ case 1:
+ $ptype = "Effectué";
+ $preglement = $p["reglement_libelle"];
+ break;
+ case 2:
+ $ptype = "A finaliser";
+ $preglement = "";
+ break;
+ case 3:
+ $ptype = "Refusé";
+ $preglement = "";
+ break;
+ case 4:
+ $ptype = "Don";
+ $preglement = "";
+ break;
+ case 9:
+ $ptype = "Habitat vide";
+ $preglement = "";
+ break;
+ default:
+ $ptype = $p["fk_type"];
+ $preglement = "";
+ break;
+ }
+
+ // Habitat
+ if ($p["fk_habitat"] == 1) {
+ $phabitat = "Individuel";
+ } else {
+ $phabitat = "Etage " . $p["niveau"] . " - Appt " . $p["appt"];
+ }
+
+ // Dates
+ $dateEve = $p["passed_at"] ? date("d/m/Y", strtotime($p["passed_at"])) : "";
+ $heureEve = $p["passed_at"] ? date("H:i", strtotime($p["passed_at"])) : "";
+
+ // Déchiffrer les données
+ $donateur = ApiService::decryptData($p["encrypted_name"]);
+ $email = !empty($p["encrypted_email"]) ? ApiService::decryptSearchableData($p["encrypted_email"]) : "";
+ $phone = !empty($p["encrypted_phone"]) ? ApiService::decryptData($p["encrypted_phone"]) : "";
+ $userName = ApiService::decryptData($p["user_name"]);
+
+ // Nettoyer les données (comme dans l'ancienne version)
+ $nom = str_replace("/", "-", $userName);
+ $tournee = str_replace("/", "-", $p["sect_name"]);
+
+ $aData[] = [
+ $dateEve,
+ $heureEve,
+ $p["user_first_name"],
+ $nom,
+ $tournee,
+ $ptype,
+ $p["numero"] . $p["rue_bis"],
+ $p["rue"],
+ $p["ville"],
+ $phabitat,
+ $donateur,
+ $email,
+ $phone,
+ $p["montant"],
+ $preglement,
+ $p["remarque"]
+ ];
+ }
+
+ return $aData;
+ }
+
+ /**
+ * Restaure une opération à partir d'un backup chiffré
+ *
+ * @param string $backupFilePath Chemin vers le fichier de backup
+ * @param int $targetEntiteId ID de l'entité cible (pour restauration cross-entité)
+ * @return array Résultat de la restauration
+ * @throws Exception En cas d'erreur de restauration
+ */
+ public function restoreFromBackup(string $backupFilePath, int $targetEntiteId): array {
+ try {
+ // Initialiser le service de chiffrement
+ $backupService = new BackupEncryptionService();
+
+ // Lire et déchiffrer le backup
+ $backupData = $backupService->readBackupFile($backupFilePath);
+
+ // Valider la structure du backup
+ if (!isset($backupData['operation']) || !isset($backupData['export_metadata'])) {
+ throw new Exception('Structure de backup invalide');
+ }
+
+ $operationData = $backupData['operation'];
+ $originalEntiteId = $backupData['export_metadata']['source_entite_id'];
+
+ // Commencer la transaction
+ $this->db->beginTransaction();
+
+ // Créer la nouvelle opération
+ $newOperationId = $this->restoreOperation($operationData, $targetEntiteId);
+
+ // Restaurer les utilisateurs (si même entité)
+ if ($targetEntiteId === $originalEntiteId && isset($backupData['users'])) {
+ $this->restoreUsers($backupData['users'], $newOperationId);
+ }
+
+ // Restaurer les secteurs
+ if (isset($backupData['sectors'])) {
+ $this->restoreSectors($backupData['sectors'], $newOperationId);
+ }
+
+ // Restaurer les relations utilisateurs-secteurs
+ if (isset($backupData['user_sectors'])) {
+ $this->restoreUserSectors($backupData['user_sectors'], $newOperationId);
+ }
+
+ // Restaurer les passages
+ if (isset($backupData['passages'])) {
+ $this->restorePassages($backupData['passages'], $newOperationId);
+ }
+
+ $this->db->commit();
+
+ LogService::log('Restauration de backup réussie', [
+ 'level' => 'info',
+ 'backup_file' => $backupFilePath,
+ 'original_operation_id' => $operationData['id'],
+ 'new_operation_id' => $newOperationId,
+ 'target_entite_id' => $targetEntiteId,
+ 'original_entite_id' => $originalEntiteId
+ ]);
+
+ return [
+ 'success' => true,
+ 'new_operation_id' => $newOperationId,
+ 'original_operation_id' => $operationData['id'],
+ 'restored_data' => [
+ 'operation' => true,
+ 'users' => isset($backupData['users']) && $targetEntiteId === $originalEntiteId,
+ 'sectors' => isset($backupData['sectors']),
+ 'user_sectors' => isset($backupData['user_sectors']),
+ 'passages' => isset($backupData['passages'])
+ ]
+ ];
+ } catch (Exception $e) {
+ $this->db->rollBack();
+
+ LogService::log('Erreur lors de la restauration du backup', [
+ 'level' => 'error',
+ 'backup_file' => $backupFilePath,
+ 'target_entite_id' => $targetEntiteId,
+ 'error' => $e->getMessage()
+ ]);
+
+ throw $e;
+ }
+ }
+
+ /**
+ * Restaure les données de l'opération
+ */
+ private function restoreOperation(array $operationData, int $targetEntiteId): int {
+ $stmt = $this->db->prepare('
+ INSERT INTO operations (
+ fk_entite, libelle, date_deb, date_fin, chk_distinct_sectors,
+ fk_user_creat, chk_active, created_at
+ ) VALUES (?, ?, ?, ?, ?, ?, 0, NOW())
+ ');
+
+ $userId = Session::getUserId() ?? 1;
+
+ $stmt->execute([
+ $targetEntiteId,
+ $operationData['libelle'] . ' (Restaurée)',
+ $operationData['date_deb'],
+ $operationData['date_fin'],
+ $operationData['chk_distinct_sectors'] ?? 0,
+ $userId
+ ]);
+
+ return (int)$this->db->lastInsertId();
+ }
+
+ /**
+ * Restaure les utilisateurs (uniquement si même entité)
+ */
+ private function restoreUsers(array $users, int $newOperationId): void {
+ foreach ($users as $user) {
+ // Vérifier si l'utilisateur existe déjà
+ $stmt = $this->db->prepare('SELECT id FROM users WHERE id = ?');
+ $stmt->execute([$user['id']]);
+
+ if ($stmt->fetch()) {
+ // Associer l'utilisateur existant à la nouvelle opération
+ $stmt = $this->db->prepare('
+ INSERT IGNORE INTO ope_users (fk_operation, fk_user, chk_active, created_at)
+ VALUES (?, ?, 1, NOW())
+ ');
+ $stmt->execute([$newOperationId, $user['id']]);
+ }
+ }
+ }
+
+ /**
+ * Restaure les secteurs
+ */
+ private function restoreSectors(array $sectors, int $newOperationId): void {
+ foreach ($sectors as $sector) {
+ $stmt = $this->db->prepare('
+ INSERT INTO ope_sectors (
+ fk_operation, libelle, color, chk_active, created_at
+ ) VALUES (?, ?, ?, 1, NOW())
+ ');
+
+ $stmt->execute([
+ $newOperationId,
+ $sector['libelle'],
+ $sector['color']
+ ]);
+ }
+ }
+
+ /**
+ * Restaure les relations utilisateurs-secteurs
+ */
+ private function restoreUserSectors(array $userSectors, int $newOperationId): void {
+ foreach ($userSectors as $us) {
+ // Trouver le nouveau secteur par son libellé
+ $stmt = $this->db->prepare('
+ SELECT id FROM ope_sectors
+ WHERE fk_operation = ? AND libelle = ?
+ LIMIT 1
+ ');
+ $stmt->execute([$newOperationId, $us['libelle'] ?? '']);
+ $newSector = $stmt->fetch();
+
+ if ($newSector) {
+ $stmt = $this->db->prepare('
+ INSERT IGNORE INTO ope_users_sectors (
+ fk_operation, fk_sector, fk_user, chk_active, created_at
+ ) VALUES (?, ?, ?, 1, NOW())
+ ');
+
+ $stmt->execute([
+ $newOperationId,
+ $newSector['id'],
+ $us['fk_user']
+ ]);
+ }
+ }
+ }
+
+ /**
+ * Restaure les passages
+ */
+ private function restorePassages(array $passages, int $newOperationId): void {
+ foreach ($passages as $passage) {
+ $stmt = $this->db->prepare('
+ INSERT INTO ope_pass (
+ fk_operation, fk_user, fk_sector, fk_type, passed_at,
+ numero, rue_bis, rue, ville, fk_habitat, appt, niveau,
+ encrypted_name, encrypted_email, encrypted_phone,
+ montant, fk_type_reglement, remarque, chk_active, created_at
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, NOW())
+ ');
+
+ $stmt->execute([
+ $newOperationId,
+ $passage['fk_user'],
+ $passage['fk_sector'],
+ $passage['fk_type'],
+ $passage['passed_at'],
+ $passage['numero'],
+ $passage['rue_bis'],
+ $passage['rue'],
+ $passage['ville'],
+ $passage['fk_habitat'],
+ $passage['appt'],
+ $passage['niveau'],
+ $passage['encrypted_name'],
+ $passage['encrypted_email'],
+ $passage['encrypted_phone'],
+ $passage['montant'],
+ $passage['fk_type_reglement'],
+ $passage['remarque']
+ ]);
+ }
+ }
+}
diff --git a/api/src/Services/FileService.php b/api/src/Services/FileService.php
new file mode 100644
index 00000000..01cb3d95
--- /dev/null
+++ b/api/src/Services/FileService.php
@@ -0,0 +1,439 @@
+db = Database::getInstance();
+ }
+
+ /**
+ * Crée un dossier dans l'arborescence uploads
+ *
+ * @param int $entiteId ID de l'entité
+ * @param string $path Chemin relatif à partir de BASE_UPLOADS_DIR (ex: '/5/operations/2644/export')
+ * @return string Le chemin complet du dossier créé
+ */
+ public function createDirectory(int $entiteId, string $path): string {
+ // Construire le chemin complet
+ $fullPath = self::BASE_UPLOADS_DIR . $path;
+
+ LogService::log('Création de dossier', [
+ 'level' => 'info',
+ 'entiteId' => $entiteId,
+ 'path' => $path,
+ 'fullPath' => $fullPath,
+ ]);
+
+ // Créer le dossier avec tous les dossiers parents si nécessaire
+ if (!is_dir($fullPath)) {
+ if (!mkdir($fullPath, self::DIR_PERMS, true)) {
+ LogService::log('Erreur création dossier', [
+ 'level' => 'error',
+ 'fullPath' => $fullPath,
+ ]);
+ throw new Exception("Impossible de créer le dossier: {$fullPath}");
+ }
+
+ // Appliquer les permissions et propriétaire
+ $this->setDirectoryPermissions($fullPath);
+
+ LogService::log('Dossier créé avec succès', [
+ 'level' => 'info',
+ 'fullPath' => $fullPath,
+ 'permissions' => decoct(self::DIR_PERMS),
+ 'owner' => self::OWNER_GROUP,
+ ]);
+ }
+
+ return $fullPath;
+ }
+
+ /**
+ * Applique les permissions et propriétaire sur un dossier
+ */
+ private function setDirectoryPermissions(string $path): void {
+ // Appliquer les permissions
+ chmod($path, self::DIR_PERMS);
+
+ // Changer le propriétaire et le groupe séparément pour plus de fiabilité
+ $chownUserCommand = "chown nginx " . escapeshellarg($path);
+ exec($chownUserCommand, $output, $returnCode);
+
+ if ($returnCode !== 0) {
+ LogService::log('Avertissement: Impossible de changer le propriétaire', [
+ 'level' => 'warning',
+ 'path' => $path,
+ 'command' => $chownUserCommand,
+ 'return_code' => $returnCode,
+ ]);
+ }
+
+ $chgrpCommand = "chgrp nobody " . escapeshellarg($path);
+ exec($chgrpCommand, $output, $returnCode);
+
+ if ($returnCode !== 0) {
+ LogService::log('Avertissement: Impossible de changer le groupe', [
+ 'level' => 'warning',
+ 'path' => $path,
+ 'command' => $chgrpCommand,
+ 'return_code' => $returnCode,
+ ]);
+ }
+ }
+
+ /**
+ * Applique les permissions sur un fichier
+ */
+ public function setFilePermissions(string $filepath): void {
+ // Appliquer les permissions fichier
+ chmod($filepath, self::FILE_PERMS);
+
+ // Changer le propriétaire et le groupe séparément pour plus de fiabilité
+ $chownUserCommand = "chown nginx " . escapeshellarg($filepath);
+ exec($chownUserCommand, $output, $returnCode);
+
+ if ($returnCode !== 0) {
+ LogService::log('Avertissement: Impossible de changer le propriétaire du fichier', [
+ 'level' => 'warning',
+ 'filepath' => $filepath,
+ 'command' => $chownUserCommand,
+ 'return_code' => $returnCode,
+ ]);
+ }
+
+ $chgrpCommand = "chgrp nobody " . escapeshellarg($filepath);
+ exec($chgrpCommand, $output, $returnCode);
+
+ if ($returnCode !== 0) {
+ LogService::log('Avertissement: Impossible de changer le groupe du fichier', [
+ 'level' => 'warning',
+ 'filepath' => $filepath,
+ 'command' => $chgrpCommand,
+ 'return_code' => $returnCode,
+ ]);
+ }
+ }
+
+ /**
+ * Supprime un fichier
+ *
+ * @param string $filePath Chemin complet vers le fichier ou chemin relatif depuis BASE_UPLOADS_DIR
+ * @param string $fileName Nom du fichier (pour les logs)
+ * @return bool True si suppression réussie, false sinon
+ */
+ public function deleteFile(string $filePath, string $fileName): bool {
+ // Si le chemin ne commence pas par /, on considère qu'il est relatif à BASE_UPLOADS_DIR
+ if (!str_starts_with($filePath, '/')) {
+ $fullPath = self::BASE_UPLOADS_DIR . '/' . $filePath;
+ } else {
+ $fullPath = $filePath;
+ }
+
+ LogService::log('Tentative de suppression de fichier', [
+ 'level' => 'info',
+ 'fileName' => $fileName,
+ 'filePath' => $filePath,
+ 'fullPath' => $fullPath,
+ ]);
+
+ // Vérifier que le fichier existe
+ if (!file_exists($fullPath)) {
+ LogService::log('Fichier non trouvé pour suppression', [
+ 'level' => 'warning',
+ 'fileName' => $fileName,
+ 'fullPath' => $fullPath,
+ ]);
+ return false;
+ }
+
+ // Vérifier que c'est bien un fichier (pas un dossier)
+ if (!is_file($fullPath)) {
+ LogService::log('Le chemin ne pointe pas vers un fichier', [
+ 'level' => 'error',
+ 'fileName' => $fileName,
+ 'fullPath' => $fullPath,
+ ]);
+ return false;
+ }
+
+ // Supprimer d'abord les enregistrements dans la table medias
+ $deletedMediaRecords = $this->deleteMediaRecordsByFile($fullPath, $fileName);
+
+ // Tenter la suppression du fichier physique
+ if (unlink($fullPath)) {
+ LogService::log('Fichier supprimé avec succès', [
+ 'level' => 'info',
+ 'fileName' => $fileName,
+ 'fullPath' => $fullPath,
+ 'deletedMediaRecords' => $deletedMediaRecords,
+ ]);
+ return true;
+ } else {
+ LogService::log('Erreur lors de la suppression du fichier', [
+ 'level' => 'error',
+ 'fileName' => $fileName,
+ 'fullPath' => $fullPath,
+ ]);
+ return false;
+ }
+ }
+
+ /**
+ * Supprime un dossier et tout son contenu
+ *
+ * @param string $filePath Chemin complet vers le dossier ou chemin relatif depuis BASE_UPLOADS_DIR
+ * @return bool True si suppression réussie, false sinon
+ */
+ public function deleteDir(string $filePath): bool {
+ // Si le chemin ne commence pas par /, on considère qu'il est relatif à BASE_UPLOADS_DIR
+ if (!str_starts_with($filePath, '/')) {
+ $fullPath = self::BASE_UPLOADS_DIR . '/' . $filePath;
+ } else {
+ $fullPath = $filePath;
+ }
+
+ LogService::log('Tentative de suppression de dossier', [
+ 'level' => 'info',
+ 'filePath' => $filePath,
+ 'fullPath' => $fullPath,
+ ]);
+
+ // Vérifier que le dossier existe
+ if (!file_exists($fullPath)) {
+ LogService::log('Dossier non trouvé pour suppression', [
+ 'level' => 'warning',
+ 'fullPath' => $fullPath,
+ ]);
+ return false;
+ }
+
+ // Vérifier que c'est bien un dossier
+ if (!is_dir($fullPath)) {
+ LogService::log('Le chemin ne pointe pas vers un dossier', [
+ 'level' => 'error',
+ 'fullPath' => $fullPath,
+ ]);
+ return false;
+ }
+
+ // Supprimer d'abord les enregistrements dans la table medias pour ce dossier
+ $deletedMediaRecords = $this->deleteMediaRecordsByDirectory($fullPath);
+
+ // Supprimer récursivement le contenu du dossier
+ if ($this->deleteDirectoryRecursive($fullPath)) {
+ LogService::log('Dossier supprimé avec succès', [
+ 'level' => 'info',
+ 'fullPath' => $fullPath,
+ 'deletedMediaRecords' => $deletedMediaRecords,
+ ]);
+ return true;
+ } else {
+ LogService::log('Erreur lors de la suppression du dossier', [
+ 'level' => 'error',
+ 'fullPath' => $fullPath,
+ ]);
+ return false;
+ }
+ }
+
+ /**
+ * Supprime les enregistrements medias correspondant à un fichier spécifique
+ *
+ * @param string $fullPath Chemin complet du fichier
+ * @param string $fileName Nom du fichier (pour les logs)
+ * @return int Nombre d'enregistrements supprimés
+ */
+ private function deleteMediaRecordsByFile(string $fullPath, string $fileName): int {
+ // Convertir le chemin complet en chemin relatif pour la recherche en base
+ $relativePath = str_replace(getcwd() . '/', '', $fullPath);
+
+ // Rechercher les enregistrements correspondants
+ $stmt = $this->db->prepare('
+ SELECT id, fichier, file_path FROM medias
+ WHERE file_path = ? OR fichier = ?
+ ');
+ $stmt->execute([$relativePath, $fileName]);
+ $mediaRecords = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ if (empty($mediaRecords)) {
+ LogService::log('Aucun enregistrement media trouvé pour le fichier', [
+ 'level' => 'info',
+ 'fileName' => $fileName,
+ 'relativePath' => $relativePath,
+ ]);
+ return 0;
+ }
+
+ // Supprimer les enregistrements
+ $stmt = $this->db->prepare('DELETE FROM medias WHERE file_path = ? OR fichier = ?');
+ $stmt->execute([$relativePath, $fileName]);
+ $deletedCount = $stmt->rowCount();
+
+ LogService::log('Enregistrements medias supprimés pour fichier', [
+ 'level' => 'info',
+ 'fileName' => $fileName,
+ 'deletedCount' => $deletedCount,
+ 'mediaRecords' => array_column($mediaRecords, 'id'),
+ ]);
+
+ return $deletedCount;
+ }
+
+ /**
+ * Supprime les enregistrements medias correspondant à un dossier et ses sous-dossiers
+ *
+ * @param string $fullPath Chemin complet du dossier
+ * @return int Nombre d'enregistrements supprimés
+ */
+ private function deleteMediaRecordsByDirectory(string $fullPath): int {
+ // Convertir le chemin complet en chemin relatif pour la recherche en base
+ $relativePath = str_replace(getcwd() . '/', '', $fullPath);
+
+ // Rechercher tous les enregistrements dont le chemin commence par le dossier
+ $stmt = $this->db->prepare('
+ SELECT id, fichier, file_path FROM medias
+ WHERE file_path LIKE ?
+ ');
+ $stmt->execute([$relativePath . '%']);
+ $mediaRecords = $stmt->fetchAll(PDO::FETCH_ASSOC);
+
+ if (empty($mediaRecords)) {
+ LogService::log('Aucun enregistrement media trouvé pour le dossier', [
+ 'level' => 'info',
+ 'relativePath' => $relativePath,
+ ]);
+ return 0;
+ }
+
+ // Supprimer les enregistrements
+ $stmt = $this->db->prepare('DELETE FROM medias WHERE file_path LIKE ?');
+ $stmt->execute([$relativePath . '%']);
+ $deletedCount = $stmt->rowCount();
+
+ LogService::log('Enregistrements medias supprimés pour dossier', [
+ 'level' => 'info',
+ 'relativePath' => $relativePath,
+ 'deletedCount' => $deletedCount,
+ 'mediaRecords' => array_column($mediaRecords, 'id'),
+ ]);
+
+ return $deletedCount;
+ }
+
+ /**
+ * Supprime récursivement un dossier et tout son contenu
+ *
+ * @param string $dir Chemin complet vers le dossier
+ * @return bool True si suppression réussie, false sinon
+ */
+ private function deleteDirectoryRecursive(string $dir): bool {
+ if (!is_dir($dir)) {
+ return false;
+ }
+
+ $files = array_diff(scandir($dir), ['.', '..']);
+ $deletedFiles = 0;
+ $totalFiles = count($files);
+
+ foreach ($files as $file) {
+ $filePath = $dir . DIRECTORY_SEPARATOR . $file;
+
+ if (is_dir($filePath)) {
+ // Récursion pour les sous-dossiers
+ if ($this->deleteDirectoryRecursive($filePath)) {
+ $deletedFiles++;
+ LogService::log('Sous-dossier supprimé', [
+ 'level' => 'debug',
+ 'subDir' => $filePath,
+ ]);
+ } else {
+ LogService::log('Erreur suppression sous-dossier', [
+ 'level' => 'error',
+ 'subDir' => $filePath,
+ ]);
+ }
+ } else {
+ // Supprimer le fichier
+ if (unlink($filePath)) {
+ $deletedFiles++;
+ LogService::log('Fichier supprimé du dossier', [
+ 'level' => 'debug',
+ 'file' => $filePath,
+ ]);
+ } else {
+ LogService::log('Erreur suppression fichier du dossier', [
+ 'level' => 'error',
+ 'file' => $filePath,
+ ]);
+ }
+ }
+ }
+
+ // Supprimer le dossier lui-même s'il est vide
+ if ($deletedFiles === $totalFiles && rmdir($dir)) {
+ return true;
+ } else {
+ LogService::log('Impossible de supprimer le dossier principal', [
+ 'level' => 'error',
+ 'dir' => $dir,
+ 'deletedFiles' => $deletedFiles,
+ 'totalFiles' => $totalFiles,
+ ]);
+ return false;
+ }
+ }
+
+ /**
+ * Enregistre le fichier dans la table medias
+ */
+ public function saveToMediasTable(int $entiteId, int $operationId, string $filename, string $filepath, string $fileType, string $description, string $fileCategory = 'export'): int {
+ $stmt = $this->db->prepare('
+ INSERT INTO medias (
+ support, support_id, fichier, file_type, file_category, file_size, mime_type,
+ original_name, fk_entite, fk_operation, file_path, description,
+ created_at, fk_user_creat
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NOW(), ?)
+ ');
+
+ // Déterminer le type MIME selon l'extension
+ $mimeTypes = [
+ 'xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+ 'json' => 'application/json',
+ 'enc' => 'application/octet-stream'
+ ];
+ $mimeType = $mimeTypes[$fileType] ?? 'application/octet-stream';
+
+ $relativePath = str_replace(getcwd() . '/', '', $filepath);
+ $userId = Session::getUserId() ?? 1; // Fallback si pas de session
+
+ $stmt->execute([
+ 'operation',
+ $operationId,
+ $filename,
+ $fileType,
+ $fileCategory,
+ filesize($filepath),
+ $mimeType,
+ $filename,
+ $entiteId,
+ $operationId,
+ $relativePath,
+ $description,
+ $userId
+ ]);
+
+ return (int)$this->db->lastInsertId();
+ }
+}
diff --git a/api/src/Services/OperationDataService.php b/api/src/Services/OperationDataService.php
new file mode 100644
index 00000000..8b3e3d15
--- /dev/null
+++ b/api/src/Services/OperationDataService.php
@@ -0,0 +1,282 @@
+ 2) {
+ // Super admin : les 3 dernières opérations
+ $operationLimit = 3;
+ } else {
+ // Autres cas : pas d'opérations
+ $operationLimit = 0;
+ }
+
+ // Si une opération spécifique est demandée (création d'opération)
+ if ($specificOperationId) {
+ $operationQuery = "SELECT id, fk_entite, libelle, date_deb, date_fin, chk_active
+ FROM operations
+ WHERE fk_entite = ?
+ ORDER BY id DESC LIMIT 3";
+
+ $operationStmt = $db->prepare($operationQuery);
+ $operationStmt->execute([$entiteId]);
+ $operations = $operationStmt->fetchAll(PDO::FETCH_ASSOC);
+ $activeOperationId = $specificOperationId;
+ } elseif ($operationLimit > 0) {
+ $operationQuery = "SELECT id, fk_entite, libelle, date_deb, date_fin, chk_active
+ FROM operations
+ WHERE fk_entite = ?";
+
+ if ($activeOperationOnly) {
+ $operationQuery .= " AND chk_active = 1";
+ }
+
+ $operationQuery .= " ORDER BY id DESC LIMIT " . $operationLimit;
+
+ $operationStmt = $db->prepare($operationQuery);
+ $operationStmt->execute([$entiteId]);
+ $operations = $operationStmt->fetchAll(PDO::FETCH_ASSOC);
+
+ // Récupérer l'ID de l'opération active (première opération retournée ou celle avec chk_active=1)
+ $activeOperationId = null;
+ if (!empty($operations)) {
+ foreach ($operations as $operation) {
+ if ($operation['chk_active'] == 1) {
+ $activeOperationId = (int)$operation['id'];
+ break;
+ }
+ }
+ // Si aucune opération active trouvée, prendre la première
+ if (!$activeOperationId) {
+ $activeOperationId = (int)$operations[0]['id'];
+ }
+ }
+ } else {
+ $operations = [];
+ $activeOperationId = null;
+ }
+
+ if (!empty($operations)) {
+ // Formater les données des opérations
+ foreach ($operations as $operation) {
+ $operationsData[] = [
+ 'id' => $operation['id'],
+ 'fk_entite' => $operation['fk_entite'],
+ 'libelle' => $operation['libelle'],
+ 'date_deb' => $operation['date_deb'],
+ 'date_fin' => $operation['date_fin'],
+ 'chk_active' => $operation['chk_active']
+ ];
+ }
+
+ // 2. Récupérer les secteurs selon l'interface et le rôle
+ if ($activeOperationId) {
+ if ($interface === 'user') {
+ // Interface utilisateur : seulement les secteurs affectés à l'utilisateur
+ $sectorsStmt = $db->prepare(
+ 'SELECT s.id, s.libelle, s.color, s.sector
+ FROM ope_sectors s
+ JOIN ope_users_sectors us ON s.id = us.fk_sector
+ WHERE us.fk_operation = ? AND us.fk_user = ? AND us.chk_active = 1 AND s.chk_active = 1'
+ );
+ $sectorsStmt->execute([$activeOperationId, $userId]);
+ } elseif ($interface === 'admin' && ($userRole == 2 || $userRole > 2)) {
+ // Interface admin : tous les secteurs distincts de l'opération
+ $sectorsStmt = $db->prepare(
+ 'SELECT DISTINCT s.id, s.libelle, s.color, s.sector
+ FROM ope_sectors s
+ WHERE s.fk_operation = ? AND s.chk_active = 1'
+ );
+ $sectorsStmt->execute([$activeOperationId]);
+ } else {
+ $sectors = [];
+ }
+
+ // Récupération des secteurs si une requête a été préparée
+ if (isset($sectorsStmt)) {
+ $sectors = $sectorsStmt->fetchAll(PDO::FETCH_ASSOC);
+ } else {
+ $sectors = [];
+ }
+
+ if (!empty($sectors)) {
+ $sectorsData = $sectors;
+
+ // 3. Récupérer les passages selon l'interface et le rôle
+ if ($interface === 'user' && !empty($sectors)) {
+ // Interface utilisateur : passages liés aux secteurs de l'utilisateur
+ $sectorIds = array_column($sectors, 'id');
+ $sectorIdsString = implode(',', $sectorIds);
+
+ if (!empty($sectorIdsString)) {
+ $passagesStmt = $db->prepare(
+ "SELECT id, fk_operation, fk_sector, fk_user, fk_type, fk_adresse, passed_at, numero, rue, rue_bis, ville, residence, fk_habitat, appt, niveau,
+ gps_lat, gps_lng, nom_recu, encrypted_name, remarque, encrypted_email, encrypted_phone, montant, fk_type_reglement, email_erreur, nb_passages,
+ chk_email_sent, docremis, date_repasser, chk_mobile, anomalie, created_at, updated_at, chk_active
+ FROM ope_pass
+ WHERE fk_operation = ? AND fk_sector IN ($sectorIdsString) AND chk_active = 1"
+ );
+ $passagesStmt->execute([$activeOperationId]);
+ }
+ } elseif ($interface === 'admin' && ($userRole == 2 || $userRole > 2)) {
+ // Interface admin : tous les passages de l'opération
+ $passagesStmt = $db->prepare(
+ "SELECT id, fk_operation, fk_sector, fk_user, fk_type, fk_adresse, passed_at, numero, rue, rue_bis, ville, residence, fk_habitat, appt, niveau,
+ gps_lat, gps_lng, nom_recu, encrypted_name, remarque, encrypted_email, encrypted_phone, montant, fk_type_reglement, email_erreur, nb_passages,
+ chk_email_sent, docremis, date_repasser, chk_mobile, anomalie, created_at, updated_at, chk_active
+ FROM ope_pass
+ WHERE fk_operation = ? AND chk_active = 1"
+ );
+ $passagesStmt->execute([$activeOperationId]);
+ } else {
+ $passages = [];
+ }
+
+ // Récupération des passages si une requête a été préparée
+ if (isset($passagesStmt)) {
+ $passages = $passagesStmt->fetchAll(PDO::FETCH_ASSOC);
+ } else {
+ $passages = [];
+ }
+
+ if (!empty($passages)) {
+ // Déchiffrer les données sensibles
+ foreach ($passages as &$passage) {
+ // Déchiffrement du nom
+ $passage['name'] = '';
+ if (!empty($passage['encrypted_name'])) {
+ $passage['name'] = ApiService::decryptData($passage['encrypted_name']);
+ }
+ unset($passage['encrypted_name']);
+
+ // Déchiffrement de l'email
+ $passage['email'] = '';
+ if (!empty($passage['encrypted_email'])) {
+ $decryptedEmail = ApiService::decryptSearchableData($passage['encrypted_email']);
+ if ($decryptedEmail) {
+ $passage['email'] = $decryptedEmail;
+ }
+ }
+ unset($passage['encrypted_email']);
+
+ // Déchiffrement du téléphone
+ $passage['phone'] = '';
+ if (!empty($passage['encrypted_phone'])) {
+ $passage['phone'] = ApiService::decryptData($passage['encrypted_phone']);
+ }
+ unset($passage['encrypted_phone']);
+ }
+ $passagesData = $passages;
+ }
+
+ // 4. Récupérer les utilisateurs des secteurs partagés
+ if (($interface === 'user' || ($interface === 'admin' && ($userRole == 2 || $userRole > 2))) && !empty($sectors)) {
+ $sectorIds = array_column($sectors, 'id');
+ $sectorIdsString = implode(',', $sectorIds);
+
+ if (!empty($sectorIdsString)) {
+ // Utiliser ope_users au lieu de users pour avoir les données historiques
+ $usersSectorsStmt = $db->prepare(
+ "SELECT DISTINCT ou.fk_user as id, ou.first_name, ou.encrypted_name, ou.sect_name, us.fk_sector
+ FROM ope_users ou
+ JOIN ope_users_sectors us ON ou.fk_user = us.fk_user AND ou.fk_operation = us.fk_operation
+ WHERE us.fk_sector IN ($sectorIdsString)
+ AND us.fk_operation = ?
+ AND us.chk_active = 1
+ AND ou.chk_active = 1
+ AND ou.fk_user != ?" // Exclure l'utilisateur connecté
+ );
+ $usersSectorsStmt->execute([$activeOperationId, $userId]);
+ $usersSectors = $usersSectorsStmt->fetchAll(PDO::FETCH_ASSOC);
+
+ if (!empty($usersSectors)) {
+ // Déchiffrer les noms des utilisateurs
+ foreach ($usersSectors as &$userSector) {
+ if (!empty($userSector['encrypted_name'])) {
+ $userSector['name'] = ApiService::decryptData($userSector['encrypted_name']);
+ unset($userSector['encrypted_name']);
+ }
+ }
+ $usersSectorsData = $usersSectors;
+ }
+ }
+ }
+ }
+ }
+ }
+
+ return [
+ 'operations' => $operationsData,
+ 'sectors' => $sectorsData,
+ 'users_sectors' => $usersSectorsData,
+ 'passages' => $passagesData
+ ];
+ }
+
+ /**
+ * Prépare la réponse complète pour la création d'opération
+ *
+ * @param PDO $db Instance de la base de données
+ * @param int $newOpeId ID de la nouvelle opération
+ * @param int $entiteId ID de l'entité
+ * @return array Réponse formatée avec status, message, operation_id et données
+ */
+ public static function prepareOperationResponse(PDO $db, int $newOpeId, int $entiteId): array {
+ // Utiliser le rôle admin pour récupérer toutes les données
+ $operationData = self::prepareOperationData($db, $entiteId, 'admin', 2, 0, $newOpeId);
+
+ return [
+ 'status' => 'success',
+ 'message' => 'Opération créée avec succès',
+ 'operation_id' => $newOpeId,
+ 'operations' => $operationData['operations'],
+ 'sectors' => $operationData['sectors'],
+ 'users_sectors' => $operationData['users_sectors'],
+ 'passages' => $operationData['passages']
+ ];
+ }
+}
diff --git a/api/vendor/autoload.php b/api/vendor/autoload.php
index 8ddac8fe..6d38b9de 100644
--- a/api/vendor/autoload.php
+++ b/api/vendor/autoload.php
@@ -14,10 +14,7 @@ if (PHP_VERSION_ID < 50600) {
echo $err;
}
}
- trigger_error(
- $err,
- E_USER_ERROR
- );
+ throw new RuntimeException($err);
}
require_once __DIR__ . '/composer/autoload_real.php';
diff --git a/api/vendor/composer/InstalledVersions.php b/api/vendor/composer/InstalledVersions.php
index 6d29bff6..2052022f 100644
--- a/api/vendor/composer/InstalledVersions.php
+++ b/api/vendor/composer/InstalledVersions.php
@@ -26,6 +26,12 @@ use Composer\Semver\VersionParser;
*/
class InstalledVersions
{
+ /**
+ * @var string|null if set (by reflection by Composer), this should be set to the path where this class is being copied to
+ * @internal
+ */
+ private static $selfDir = null;
+
/**
* @var mixed[]|null
* @psalm-var array{root: array{name: string, pretty_version: string, version: string, reference: string|null, type: string, install_path: string, aliases: string[], dev: bool}, versions: array}|array{}|null
@@ -322,6 +328,18 @@ class InstalledVersions
self::$installedIsLocalDir = false;
}
+ /**
+ * @return string
+ */
+ private static function getSelfDir()
+ {
+ if (self::$selfDir === null) {
+ self::$selfDir = strtr(__DIR__, '\\', '/');
+ }
+
+ return self::$selfDir;
+ }
+
/**
* @return array[]
* @psalm-return list}>
@@ -336,7 +354,7 @@ class InstalledVersions
$copiedLocalDir = false;
if (self::$canGetVendors) {
- $selfDir = strtr(__DIR__, '\\', '/');
+ $selfDir = self::getSelfDir();
foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) {
$vendorDir = strtr($vendorDir, '\\', '/');
if (isset(self::$installedByVendor[$vendorDir])) {
diff --git a/api/vendor/composer/autoload_classmap.php b/api/vendor/composer/autoload_classmap.php
index c20440c1..1dcee676 100644
--- a/api/vendor/composer/autoload_classmap.php
+++ b/api/vendor/composer/autoload_classmap.php
@@ -6,7 +6,59 @@ $vendorDir = dirname(__DIR__);
$baseDir = dirname($vendorDir);
return array(
+ 'ApiService' => $baseDir . '/src/Services/ApiService.php',
+ 'AppConfig' => $baseDir . '/src/Config/AppConfig.php',
+ 'App\\Controllers\\EntiteController' => $baseDir . '/src/Controllers/EntiteController.php',
+ 'App\\Controllers\\FileController' => $baseDir . '/src/Controllers/FileController.php',
+ 'App\\Controllers\\LoginController' => $baseDir . '/src/Controllers/LoginController.php',
+ 'App\\Controllers\\OperationController' => $baseDir . '/src/Controllers/OperationController.php',
+ 'App\\Controllers\\PassageController' => $baseDir . '/src/Controllers/PassageController.php',
+ 'App\\Controllers\\UserController' => $baseDir . '/src/Controllers/UserController.php',
+ 'App\\Controllers\\VilleController' => $baseDir . '/src/Controllers/VilleController.php',
+ 'BackupEncryptionService' => $baseDir . '/src/Services/BackupEncryptionService.php',
+ 'ClientDetector' => $baseDir . '/src/Utils/ClientDetector.php',
+ 'Complex\\Complex' => $vendorDir . '/markbaker/complex/classes/src/Complex.php',
+ 'Complex\\Exception' => $vendorDir . '/markbaker/complex/classes/src/Exception.php',
+ 'Complex\\Functions' => $vendorDir . '/markbaker/complex/classes/src/Functions.php',
+ 'Complex\\Operations' => $vendorDir . '/markbaker/complex/classes/src/Operations.php',
'Composer\\InstalledVersions' => $vendorDir . '/composer/InstalledVersions.php',
+ 'Composer\\Pcre\\MatchAllResult' => $vendorDir . '/composer/pcre/src/MatchAllResult.php',
+ 'Composer\\Pcre\\MatchAllStrictGroupsResult' => $vendorDir . '/composer/pcre/src/MatchAllStrictGroupsResult.php',
+ 'Composer\\Pcre\\MatchAllWithOffsetsResult' => $vendorDir . '/composer/pcre/src/MatchAllWithOffsetsResult.php',
+ 'Composer\\Pcre\\MatchResult' => $vendorDir . '/composer/pcre/src/MatchResult.php',
+ 'Composer\\Pcre\\MatchStrictGroupsResult' => $vendorDir . '/composer/pcre/src/MatchStrictGroupsResult.php',
+ 'Composer\\Pcre\\MatchWithOffsetsResult' => $vendorDir . '/composer/pcre/src/MatchWithOffsetsResult.php',
+ 'Composer\\Pcre\\PHPStan\\InvalidRegexPatternRule' => $vendorDir . '/composer/pcre/src/PHPStan/InvalidRegexPatternRule.php',
+ 'Composer\\Pcre\\PHPStan\\PregMatchFlags' => $vendorDir . '/composer/pcre/src/PHPStan/PregMatchFlags.php',
+ 'Composer\\Pcre\\PHPStan\\PregMatchParameterOutTypeExtension' => $vendorDir . '/composer/pcre/src/PHPStan/PregMatchParameterOutTypeExtension.php',
+ 'Composer\\Pcre\\PHPStan\\PregMatchTypeSpecifyingExtension' => $vendorDir . '/composer/pcre/src/PHPStan/PregMatchTypeSpecifyingExtension.php',
+ 'Composer\\Pcre\\PHPStan\\PregReplaceCallbackClosureTypeExtension' => $vendorDir . '/composer/pcre/src/PHPStan/PregReplaceCallbackClosureTypeExtension.php',
+ 'Composer\\Pcre\\PHPStan\\UnsafeStrictGroupsCallRule' => $vendorDir . '/composer/pcre/src/PHPStan/UnsafeStrictGroupsCallRule.php',
+ 'Composer\\Pcre\\PcreException' => $vendorDir . '/composer/pcre/src/PcreException.php',
+ 'Composer\\Pcre\\Preg' => $vendorDir . '/composer/pcre/src/Preg.php',
+ 'Composer\\Pcre\\Regex' => $vendorDir . '/composer/pcre/src/Regex.php',
+ 'Composer\\Pcre\\ReplaceResult' => $vendorDir . '/composer/pcre/src/ReplaceResult.php',
+ 'Composer\\Pcre\\UnexpectedNullMatchException' => $vendorDir . '/composer/pcre/src/UnexpectedNullMatchException.php',
+ 'Database' => $baseDir . '/src/Core/Database.php',
+ 'EmailTemplates' => $baseDir . '/src/Services/EmailTemplates.php',
+ 'ExportService' => $baseDir . '/src/Services/ExportService.php',
+ 'LogController' => $baseDir . '/src/Controllers/LogController.php',
+ 'LogService' => $baseDir . '/src/Services/LogService.php',
+ 'Matrix\\Builder' => $vendorDir . '/markbaker/matrix/classes/src/Builder.php',
+ 'Matrix\\Decomposition\\Decomposition' => $vendorDir . '/markbaker/matrix/classes/src/Decomposition/Decomposition.php',
+ 'Matrix\\Decomposition\\LU' => $vendorDir . '/markbaker/matrix/classes/src/Decomposition/LU.php',
+ 'Matrix\\Decomposition\\QR' => $vendorDir . '/markbaker/matrix/classes/src/Decomposition/QR.php',
+ 'Matrix\\Div0Exception' => $vendorDir . '/markbaker/matrix/classes/src/Div0Exception.php',
+ 'Matrix\\Exception' => $vendorDir . '/markbaker/matrix/classes/src/Exception.php',
+ 'Matrix\\Functions' => $vendorDir . '/markbaker/matrix/classes/src/Functions.php',
+ 'Matrix\\Matrix' => $vendorDir . '/markbaker/matrix/classes/src/Matrix.php',
+ 'Matrix\\Operations' => $vendorDir . '/markbaker/matrix/classes/src/Operations.php',
+ 'Matrix\\Operators\\Addition' => $vendorDir . '/markbaker/matrix/classes/src/Operators/Addition.php',
+ 'Matrix\\Operators\\DirectSum' => $vendorDir . '/markbaker/matrix/classes/src/Operators/DirectSum.php',
+ 'Matrix\\Operators\\Division' => $vendorDir . '/markbaker/matrix/classes/src/Operators/Division.php',
+ 'Matrix\\Operators\\Multiplication' => $vendorDir . '/markbaker/matrix/classes/src/Operators/Multiplication.php',
+ 'Matrix\\Operators\\Operator' => $vendorDir . '/markbaker/matrix/classes/src/Operators/Operator.php',
+ 'Matrix\\Operators\\Subtraction' => $vendorDir . '/markbaker/matrix/classes/src/Operators/Subtraction.php',
'PHPMailer\\PHPMailer\\DSNConfigurator' => $vendorDir . '/phpmailer/phpmailer/src/DSNConfigurator.php',
'PHPMailer\\PHPMailer\\Exception' => $vendorDir . '/phpmailer/phpmailer/src/Exception.php',
'PHPMailer\\PHPMailer\\OAuth' => $vendorDir . '/phpmailer/phpmailer/src/OAuth.php',
@@ -14,4 +66,554 @@ return array(
'PHPMailer\\PHPMailer\\PHPMailer' => $vendorDir . '/phpmailer/phpmailer/src/PHPMailer.php',
'PHPMailer\\PHPMailer\\POP3' => $vendorDir . '/phpmailer/phpmailer/src/POP3.php',
'PHPMailer\\PHPMailer\\SMTP' => $vendorDir . '/phpmailer/phpmailer/src/SMTP.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\ArrayEnabled' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/ArrayEnabled.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\BinaryComparison' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/BinaryComparison.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Calculation' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Calculation.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Category' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Category.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DAverage' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DAverage.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DCount' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DCount.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DCountA' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DCountA.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DGet' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DGet.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DMax' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DMax.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DMin' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DMin.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DProduct' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DProduct.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DStDev' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DStDev.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DStDevP' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DStDevP.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DSum' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DSum.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DVar' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DVar.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DVarP' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DVarP.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DatabaseAbstract' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DatabaseAbstract.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Constants' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Constants.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Current' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Current.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Date' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Date.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\DateParts' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/DateParts.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\DateValue' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/DateValue.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Days' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Days.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Days360' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Days360.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Difference' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Difference.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Helpers' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Helpers.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Month' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Month.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\NetworkDays' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/NetworkDays.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Time' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Time.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\TimeParts' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/TimeParts.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\TimeValue' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/TimeValue.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Week' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Week.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\WorkDay' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/WorkDay.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\YearFrac' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/YearFrac.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\ArrayArgumentHelper' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/ArrayArgumentHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\ArrayArgumentProcessor' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/ArrayArgumentProcessor.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\BranchPruner' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/BranchPruner.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\CyclicReferenceStack' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/CyclicReferenceStack.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\FormattedNumber' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/FormattedNumber.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\Logger' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/Logger.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\Operands\\Operand' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/Operands/Operand.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\Operands\\StructuredReference' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/Operands/StructuredReference.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\BesselI' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselI.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\BesselJ' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselJ.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\BesselK' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselK.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\BesselY' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselY.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\BitWise' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BitWise.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\Compare' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Compare.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\Complex' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Complex.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ComplexFunctions' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ComplexFunctions.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ComplexOperations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ComplexOperations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\Constants' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Constants.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ConvertBase' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ConvertBinary' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertBinary.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ConvertDecimal' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertDecimal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ConvertHex' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertHex.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ConvertOctal' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertOctal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ConvertUOM' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertUOM.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\EngineeringValidations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/EngineeringValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\Erf' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Erf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ErfC' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ErfC.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Exception' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Exception.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\ExceptionHandler' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/ExceptionHandler.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Amortization' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Amortization.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\CashFlowValidations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/CashFlowValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Constant\\Periodic' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Constant\\Periodic\\Cumulative' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Cumulative.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Constant\\Periodic\\Interest' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Interest.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Constant\\Periodic\\InterestAndPrincipal' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/InterestAndPrincipal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Constant\\Periodic\\Payments' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Payments.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Single' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Single.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Variable\\NonPeriodic' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Variable/NonPeriodic.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Variable\\Periodic' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Variable/Periodic.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Constants' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Constants.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Coupons' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Coupons.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Depreciation' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Depreciation.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Dollar' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Dollar.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\FinancialValidations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/FinancialValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Helpers' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Helpers.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\InterestRate' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/InterestRate.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Securities\\AccruedInterest' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/AccruedInterest.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Securities\\Price' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Price.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Securities\\Rates' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Rates.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Securities\\SecurityValidations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/SecurityValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Securities\\Yields' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Yields.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\TreasuryBill' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/TreasuryBill.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\FormulaParser' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/FormulaParser.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\FormulaToken' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/FormulaToken.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Functions' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Functions.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Information\\ErrorValue' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Information/ErrorValue.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Information\\ExcelError' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Information/ExcelError.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Information\\Value' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Information/Value.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Internal\\MakeMatrix' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Internal/MakeMatrix.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Internal\\WildcardMatch' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Internal/WildcardMatch.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Logical\\Boolean' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Logical/Boolean.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Logical\\Conditional' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Logical/Conditional.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Logical\\Operations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Logical/Operations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Address' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Address.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\ExcelMatch' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/ExcelMatch.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Filter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Filter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Formula' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Formula.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\HLookup' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/HLookup.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Helpers' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Helpers.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Hyperlink' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Hyperlink.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Indirect' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Indirect.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Lookup' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Lookup.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\LookupBase' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/LookupBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\LookupRefValidations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/LookupRefValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Matrix' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Matrix.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Offset' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Offset.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\RowColumnInformation' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/RowColumnInformation.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Selection' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Selection.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Sort' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Sort.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Unique' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Unique.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\VLookup' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/VLookup.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Absolute' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Absolute.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Angle' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Angle.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Arabic' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Arabic.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Base' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Base.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Ceiling' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Ceiling.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Combinations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Combinations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Exp' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Exp.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Factorial' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Factorial.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Floor' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Floor.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Gcd' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Gcd.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Helpers' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Helpers.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\IntClass' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/IntClass.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Lcm' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Lcm.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Logarithms' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Logarithms.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\MatrixFunctions' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/MatrixFunctions.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Operations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Operations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Random' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Random.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Roman' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Roman.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Round' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Round.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\SeriesSum' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/SeriesSum.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Sign' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sign.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Sqrt' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sqrt.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Subtotal' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Subtotal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Sum' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sum.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\SumSquares' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/SumSquares.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trig\\Cosecant' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cosecant.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trig\\Cosine' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cosine.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trig\\Cotangent' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cotangent.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trig\\Secant' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Secant.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trig\\Sine' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Sine.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trig\\Tangent' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Tangent.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trunc' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trunc.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\AggregateBase' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/AggregateBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Averages' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Averages.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Averages\\Mean' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Averages/Mean.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Conditional' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Conditional.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Confidence' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Confidence.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Counts' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Counts.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Deviations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Deviations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Beta' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Beta.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Binomial' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Binomial.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\ChiSquared' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/ChiSquared.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\DistributionValidations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/DistributionValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Exponential' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Exponential.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\F' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/F.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Fisher' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Fisher.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Gamma' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Gamma.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\GammaBase' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/GammaBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\HyperGeometric' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/HyperGeometric.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\LogNormal' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/LogNormal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\NewtonRaphson' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/NewtonRaphson.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Normal' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Normal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Poisson' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Poisson.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\StandardNormal' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/StandardNormal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\StudentT' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/StudentT.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Weibull' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Weibull.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\MaxMinBase' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/MaxMinBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Maximum' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Maximum.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Minimum' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Minimum.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Percentiles' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Percentiles.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Permutations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Permutations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Size' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Size.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\StandardDeviations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/StandardDeviations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Standardize' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Standardize.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\StatisticalValidations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/StatisticalValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Trends' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Trends.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\VarianceBase' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/VarianceBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Variances' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Variances.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\CaseConvert' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/CaseConvert.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\CharacterConvert' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/CharacterConvert.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Concatenate' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Concatenate.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Extract' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Extract.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Format' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Format.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Helpers' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Helpers.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Replace' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Replace.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Search' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Search.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Text' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Text.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Trim' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Trim.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Token\\Stack' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Token/Stack.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Web\\Service' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Web/Service.php',
+ 'PhpOffice\\PhpSpreadsheet\\CellReferenceHelper' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/CellReferenceHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\AddressHelper' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/AddressHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\AddressRange' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/AddressRange.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\AdvancedValueBinder' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/AdvancedValueBinder.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\Cell' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Cell.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\CellAddress' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/CellAddress.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\CellRange' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/CellRange.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\ColumnRange' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/ColumnRange.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\Coordinate' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Coordinate.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\DataType' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataType.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\DataValidation' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataValidation.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\DataValidator' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataValidator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\DefaultValueBinder' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DefaultValueBinder.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\Hyperlink' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Hyperlink.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\IValueBinder' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/IValueBinder.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\IgnoredErrors' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/IgnoredErrors.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\RowRange' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/RowRange.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\StringValueBinder' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/StringValueBinder.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Axis' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Axis.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\AxisText' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/AxisText.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Chart' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Chart.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\ChartColor' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/ChartColor.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\DataSeries' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/DataSeries.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\DataSeriesValues' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/DataSeriesValues.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Exception' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Exception.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\GridLines' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/GridLines.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Layout' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Layout.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Legend' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Legend.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\PlotArea' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/PlotArea.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Properties' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Properties.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Renderer\\IRenderer' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/IRenderer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Renderer\\JpGraph' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/JpGraph.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Renderer\\JpGraphRendererBase' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/JpGraphRendererBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Renderer\\MtJpGraphRenderer' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/MtJpGraphRenderer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Title' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Title.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\TrendLine' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/TrendLine.php',
+ 'PhpOffice\\PhpSpreadsheet\\Collection\\Cells' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/Cells.php',
+ 'PhpOffice\\PhpSpreadsheet\\Collection\\CellsFactory' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/CellsFactory.php',
+ 'PhpOffice\\PhpSpreadsheet\\Collection\\Memory\\SimpleCache1' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/Memory/SimpleCache1.php',
+ 'PhpOffice\\PhpSpreadsheet\\Collection\\Memory\\SimpleCache3' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/Memory/SimpleCache3.php',
+ 'PhpOffice\\PhpSpreadsheet\\Comment' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Comment.php',
+ 'PhpOffice\\PhpSpreadsheet\\DefinedName' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/DefinedName.php',
+ 'PhpOffice\\PhpSpreadsheet\\Document\\Properties' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Document/Properties.php',
+ 'PhpOffice\\PhpSpreadsheet\\Document\\Security' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Document/Security.php',
+ 'PhpOffice\\PhpSpreadsheet\\Exception' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Exception.php',
+ 'PhpOffice\\PhpSpreadsheet\\HashTable' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/HashTable.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\Dimension' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Dimension.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\Downloader' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Downloader.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\Handler' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Handler.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\Html' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Html.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\Sample' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Sample.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\Size' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Size.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\TextGrid' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/TextGrid.php',
+ 'PhpOffice\\PhpSpreadsheet\\IComparable' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/IComparable.php',
+ 'PhpOffice\\PhpSpreadsheet\\IOFactory' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/IOFactory.php',
+ 'PhpOffice\\PhpSpreadsheet\\NamedFormula' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/NamedFormula.php',
+ 'PhpOffice\\PhpSpreadsheet\\NamedRange' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/NamedRange.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\BaseReader' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/BaseReader.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Csv' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Csv.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Csv\\Delimiter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Csv/Delimiter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\DefaultReadFilter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/DefaultReadFilter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Exception' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Exception.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Gnumeric' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Gnumeric\\PageSetup' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/PageSetup.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Gnumeric\\Properties' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/Properties.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Gnumeric\\Styles' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/Styles.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Html' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Html.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\IReadFilter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/IReadFilter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\IReader' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/IReader.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods\\AutoFilter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/AutoFilter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods\\BaseLoader' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/BaseLoader.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods\\DefinedNames' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/DefinedNames.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods\\FormulaTranslator' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/FormulaTranslator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods\\PageSettings' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/PageSettings.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods\\Properties' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/Properties.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Security\\XmlScanner' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Security/XmlScanner.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Slk' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Slk.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Color' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Color\\BIFF5' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BIFF5.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Color\\BIFF8' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BIFF8.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Color\\BuiltIn' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BuiltIn.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\ConditionalFormatting' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/ConditionalFormatting.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\DataValidationHelper' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/DataValidationHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\ErrorCode' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/ErrorCode.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Escher' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Escher.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\MD5' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/MD5.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\RC4' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/RC4.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Style\\Border' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/Border.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Style\\CellAlignment' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/CellAlignment.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Style\\CellFont' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/CellFont.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Style\\FillPattern' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/FillPattern.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\AutoFilter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/AutoFilter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\BaseParserClass' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/BaseParserClass.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\Chart' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Chart.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\ColumnAndRowAttributes' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/ColumnAndRowAttributes.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\ConditionalStyles' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/ConditionalStyles.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\DataValidations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/DataValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\Hyperlinks' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Hyperlinks.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\Namespaces' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Namespaces.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\PageSetup' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/PageSetup.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\Properties' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Properties.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\SharedFormula' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SharedFormula.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\SheetViewOptions' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SheetViewOptions.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\SheetViews' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SheetViews.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\Styles' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Styles.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\TableReader' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/TableReader.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\Theme' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Theme.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\WorkbookView' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/WorkbookView.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\DataValidations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/DataValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\PageSettings' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/PageSettings.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Properties' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Properties.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style\\Alignment' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Alignment.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style\\Border' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Border.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style\\Fill' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Fill.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style\\Font' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Font.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style\\NumberFormat' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/NumberFormat.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style\\StyleBase' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/StyleBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\ReferenceHelper' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/ReferenceHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\RichText\\ITextElement' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/ITextElement.php',
+ 'PhpOffice\\PhpSpreadsheet\\RichText\\RichText' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/RichText.php',
+ 'PhpOffice\\PhpSpreadsheet\\RichText\\Run' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/Run.php',
+ 'PhpOffice\\PhpSpreadsheet\\RichText\\TextElement' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/TextElement.php',
+ 'PhpOffice\\PhpSpreadsheet\\Settings' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Settings.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\CodePage' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/CodePage.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Date' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Date.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Drawing' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Drawing.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DgContainer' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DgContainer\\SpgrContainer' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer/SpgrContainer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DgContainer\\SpgrContainer\\SpContainer' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer/SpgrContainer/SpContainer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DggContainer' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DggContainer\\BstoreContainer' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DggContainer\\BstoreContainer\\BSE' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer/BSE.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DggContainer\\BstoreContainer\\BSE\\Blip' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer/BSE/Blip.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\File' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/File.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Font' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Font.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\IntOrFloat' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/IntOrFloat.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\OLE' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\OLERead' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLERead.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\OLE\\ChainedBlockStream' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/ChainedBlockStream.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\OLE\\PPS' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\OLE\\PPS\\File' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS/File.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\OLE\\PPS\\Root' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS/Root.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\PasswordHasher' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/PasswordHasher.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\StringHelper' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/StringHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\TimeZone' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/TimeZone.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\BestFit' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/BestFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\ExponentialBestFit' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/ExponentialBestFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\LinearBestFit' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/LinearBestFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\LogarithmicBestFit' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/LogarithmicBestFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\PolynomialBestFit' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/PolynomialBestFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\PowerBestFit' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/PowerBestFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\Trend' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/Trend.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\XMLWriter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/XMLWriter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Xls' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Xls.php',
+ 'PhpOffice\\PhpSpreadsheet\\Spreadsheet' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Spreadsheet.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Alignment' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Alignment.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Border' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Border.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Borders' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Borders.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Color' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Color.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Conditional' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Conditional.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\CellMatcher' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/CellMatcher.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\CellStyleAssessor' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/CellStyleAssessor.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\ConditionalColorScale' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalColorScale.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\ConditionalDataBar' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalDataBar.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\ConditionalDataBarExtension' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalDataBarExtension.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\ConditionalFormatValueObject' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalFormatValueObject.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\ConditionalFormattingRuleExtension' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalFormattingRuleExtension.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\StyleMerger' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/StyleMerger.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\Blanks' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Blanks.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\CellValue' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/CellValue.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\DateValue' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/DateValue.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\Duplicates' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Duplicates.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\Errors' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Errors.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\Expression' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Expression.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\TextValue' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/TextValue.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\WizardAbstract' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/WizardAbstract.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\WizardInterface' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/WizardInterface.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Fill' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Fill.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Font' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Font.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\BaseFormatter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/BaseFormatter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\DateFormatter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/DateFormatter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Formatter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Formatter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\FractionFormatter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/FractionFormatter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\NumberFormatter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/NumberFormatter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\PercentageFormatter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/PercentageFormatter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Accounting' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Accounting.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Currency' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Currency.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Date' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Date.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\DateTime' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/DateTime.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\DateTimeWizard' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/DateTimeWizard.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Duration' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Duration.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Locale' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Locale.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Number' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Number.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\NumberBase' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/NumberBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Percentage' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Percentage.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Scientific' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Scientific.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Time' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Time.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Wizard' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Wizard.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Protection' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Protection.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\RgbTint' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/RgbTint.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Style' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Style.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Supervisor' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Supervisor.php',
+ 'PhpOffice\\PhpSpreadsheet\\Theme' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Theme.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\AutoFilter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/AutoFilter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\AutoFilter\\Column' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/AutoFilter/Column.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\AutoFilter\\Column\\Rule' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/AutoFilter/Column/Rule.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\AutoFit' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/AutoFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\BaseDrawing' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/BaseDrawing.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\CellIterator' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/CellIterator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Column' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Column.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\ColumnCellIterator' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/ColumnCellIterator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\ColumnDimension' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/ColumnDimension.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\ColumnIterator' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/ColumnIterator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Dimension' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Dimension.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Drawing' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Drawing.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Drawing\\Shadow' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Drawing/Shadow.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\HeaderFooter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/HeaderFooter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\HeaderFooterDrawing' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/HeaderFooterDrawing.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Iterator' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Iterator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\MemoryDrawing' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/MemoryDrawing.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\PageBreak' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/PageBreak.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\PageMargins' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/PageMargins.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\PageSetup' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/PageSetup.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Pane' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Pane.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\ProtectedRange' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/ProtectedRange.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Protection' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Protection.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Row' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Row.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\RowCellIterator' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/RowCellIterator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\RowDimension' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/RowDimension.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\RowIterator' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/RowIterator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\SheetView' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/SheetView.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Table' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Table.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Table\\Column' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Table/Column.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Table\\TableStyle' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Table/TableStyle.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Validations' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Validations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Worksheet' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Worksheet.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\BaseWriter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/BaseWriter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Csv' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Csv.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Exception' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Exception.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Html' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Html.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\IWriter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/IWriter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\AutoFilters' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/AutoFilters.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Cell\\Comment' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Cell/Comment.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Cell\\Style' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Cell/Style.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Content' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Content.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Formula' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Formula.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Meta' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Meta.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\MetaInf' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/MetaInf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Mimetype' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Mimetype.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\NamedExpressions' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/NamedExpressions.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Settings' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Settings.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Styles' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Styles.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Thumbnails' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Thumbnails.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\WriterPart' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/WriterPart.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Pdf' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Pdf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Pdf\\Dompdf' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Pdf/Dompdf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Pdf\\Mpdf' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Pdf/Mpdf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Pdf\\Tcpdf' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Pdf/Tcpdf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\BIFFwriter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/BIFFwriter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\CellDataValidation' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/CellDataValidation.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\ConditionalHelper' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/ConditionalHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\ErrorCode' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/ErrorCode.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Escher' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Escher.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Font' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Font.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Parser' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Parser.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Style\\CellAlignment' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Style/CellAlignment.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Style\\CellBorder' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Style/CellBorder.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Style\\CellFill' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Style/CellFill.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Style\\ColorMap' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Style/ColorMap.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Workbook' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Workbook.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Worksheet' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Worksheet.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Xf' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Xf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\AutoFilter' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/AutoFilter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Chart' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Chart.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Comments' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Comments.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\ContentTypes' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/ContentTypes.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\DefinedNames' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/DefinedNames.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\DocProps' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/DocProps.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Drawing' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Drawing.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\FunctionPrefix' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/FunctionPrefix.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Rels' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Rels.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\RelsRibbon' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/RelsRibbon.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\RelsVBA' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/RelsVBA.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\StringTable' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/StringTable.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Style' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Style.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Table' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Table.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Theme' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Theme.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Workbook' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Workbook.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Worksheet' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Worksheet.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\WriterPart' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/WriterPart.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\ZipStream0' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/ZipStream0.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\ZipStream2' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/ZipStream2.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\ZipStream3' => $vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/ZipStream3.php',
+ 'Psr\\Http\\Client\\ClientExceptionInterface' => $vendorDir . '/psr/http-client/src/ClientExceptionInterface.php',
+ 'Psr\\Http\\Client\\ClientInterface' => $vendorDir . '/psr/http-client/src/ClientInterface.php',
+ 'Psr\\Http\\Client\\NetworkExceptionInterface' => $vendorDir . '/psr/http-client/src/NetworkExceptionInterface.php',
+ 'Psr\\Http\\Client\\RequestExceptionInterface' => $vendorDir . '/psr/http-client/src/RequestExceptionInterface.php',
+ 'Psr\\Http\\Message\\MessageInterface' => $vendorDir . '/psr/http-message/src/MessageInterface.php',
+ 'Psr\\Http\\Message\\RequestFactoryInterface' => $vendorDir . '/psr/http-factory/src/RequestFactoryInterface.php',
+ 'Psr\\Http\\Message\\RequestInterface' => $vendorDir . '/psr/http-message/src/RequestInterface.php',
+ 'Psr\\Http\\Message\\ResponseFactoryInterface' => $vendorDir . '/psr/http-factory/src/ResponseFactoryInterface.php',
+ 'Psr\\Http\\Message\\ResponseInterface' => $vendorDir . '/psr/http-message/src/ResponseInterface.php',
+ 'Psr\\Http\\Message\\ServerRequestFactoryInterface' => $vendorDir . '/psr/http-factory/src/ServerRequestFactoryInterface.php',
+ 'Psr\\Http\\Message\\ServerRequestInterface' => $vendorDir . '/psr/http-message/src/ServerRequestInterface.php',
+ 'Psr\\Http\\Message\\StreamFactoryInterface' => $vendorDir . '/psr/http-factory/src/StreamFactoryInterface.php',
+ 'Psr\\Http\\Message\\StreamInterface' => $vendorDir . '/psr/http-message/src/StreamInterface.php',
+ 'Psr\\Http\\Message\\UploadedFileFactoryInterface' => $vendorDir . '/psr/http-factory/src/UploadedFileFactoryInterface.php',
+ 'Psr\\Http\\Message\\UploadedFileInterface' => $vendorDir . '/psr/http-message/src/UploadedFileInterface.php',
+ 'Psr\\Http\\Message\\UriFactoryInterface' => $vendorDir . '/psr/http-factory/src/UriFactoryInterface.php',
+ 'Psr\\Http\\Message\\UriInterface' => $vendorDir . '/psr/http-message/src/UriInterface.php',
+ 'Psr\\SimpleCache\\CacheException' => $vendorDir . '/psr/simple-cache/src/CacheException.php',
+ 'Psr\\SimpleCache\\CacheInterface' => $vendorDir . '/psr/simple-cache/src/CacheInterface.php',
+ 'Psr\\SimpleCache\\InvalidArgumentException' => $vendorDir . '/psr/simple-cache/src/InvalidArgumentException.php',
+ 'Request' => $baseDir . '/src/Core/Request.php',
+ 'Response' => $baseDir . '/src/Core/Response.php',
+ 'Router' => $baseDir . '/src/Core/Router.php',
+ 'Session' => $baseDir . '/src/Core/Session.php',
+ 'ZipStream\\CentralDirectoryFileHeader' => $vendorDir . '/maennchen/zipstream-php/src/CentralDirectoryFileHeader.php',
+ 'ZipStream\\CompressionMethod' => $vendorDir . '/maennchen/zipstream-php/src/CompressionMethod.php',
+ 'ZipStream\\DataDescriptor' => $vendorDir . '/maennchen/zipstream-php/src/DataDescriptor.php',
+ 'ZipStream\\EndOfCentralDirectory' => $vendorDir . '/maennchen/zipstream-php/src/EndOfCentralDirectory.php',
+ 'ZipStream\\Exception' => $vendorDir . '/maennchen/zipstream-php/src/Exception.php',
+ 'ZipStream\\Exception\\DosTimeOverflowException' => $vendorDir . '/maennchen/zipstream-php/src/Exception/DosTimeOverflowException.php',
+ 'ZipStream\\Exception\\FileNotFoundException' => $vendorDir . '/maennchen/zipstream-php/src/Exception/FileNotFoundException.php',
+ 'ZipStream\\Exception\\FileNotReadableException' => $vendorDir . '/maennchen/zipstream-php/src/Exception/FileNotReadableException.php',
+ 'ZipStream\\Exception\\FileSizeIncorrectException' => $vendorDir . '/maennchen/zipstream-php/src/Exception/FileSizeIncorrectException.php',
+ 'ZipStream\\Exception\\OverflowException' => $vendorDir . '/maennchen/zipstream-php/src/Exception/OverflowException.php',
+ 'ZipStream\\Exception\\ResourceActionException' => $vendorDir . '/maennchen/zipstream-php/src/Exception/ResourceActionException.php',
+ 'ZipStream\\Exception\\SimulationFileUnknownException' => $vendorDir . '/maennchen/zipstream-php/src/Exception/SimulationFileUnknownException.php',
+ 'ZipStream\\Exception\\StreamNotReadableException' => $vendorDir . '/maennchen/zipstream-php/src/Exception/StreamNotReadableException.php',
+ 'ZipStream\\Exception\\StreamNotSeekableException' => $vendorDir . '/maennchen/zipstream-php/src/Exception/StreamNotSeekableException.php',
+ 'ZipStream\\File' => $vendorDir . '/maennchen/zipstream-php/src/File.php',
+ 'ZipStream\\GeneralPurposeBitFlag' => $vendorDir . '/maennchen/zipstream-php/src/GeneralPurposeBitFlag.php',
+ 'ZipStream\\LocalFileHeader' => $vendorDir . '/maennchen/zipstream-php/src/LocalFileHeader.php',
+ 'ZipStream\\OperationMode' => $vendorDir . '/maennchen/zipstream-php/src/OperationMode.php',
+ 'ZipStream\\PackField' => $vendorDir . '/maennchen/zipstream-php/src/PackField.php',
+ 'ZipStream\\Time' => $vendorDir . '/maennchen/zipstream-php/src/Time.php',
+ 'ZipStream\\Version' => $vendorDir . '/maennchen/zipstream-php/src/Version.php',
+ 'ZipStream\\Zip64\\DataDescriptor' => $vendorDir . '/maennchen/zipstream-php/src/Zip64/DataDescriptor.php',
+ 'ZipStream\\Zip64\\EndOfCentralDirectory' => $vendorDir . '/maennchen/zipstream-php/src/Zip64/EndOfCentralDirectory.php',
+ 'ZipStream\\Zip64\\EndOfCentralDirectoryLocator' => $vendorDir . '/maennchen/zipstream-php/src/Zip64/EndOfCentralDirectoryLocator.php',
+ 'ZipStream\\Zip64\\ExtendedInformationExtraField' => $vendorDir . '/maennchen/zipstream-php/src/Zip64/ExtendedInformationExtraField.php',
+ 'ZipStream\\ZipStream' => $vendorDir . '/maennchen/zipstream-php/src/ZipStream.php',
+ 'ZipStream\\Zs\\ExtendedInformationExtraField' => $vendorDir . '/maennchen/zipstream-php/src/Zs/ExtendedInformationExtraField.php',
);
diff --git a/api/vendor/composer/autoload_psr4.php b/api/vendor/composer/autoload_psr4.php
index 452e39f8..f5a70e61 100644
--- a/api/vendor/composer/autoload_psr4.php
+++ b/api/vendor/composer/autoload_psr4.php
@@ -6,6 +6,13 @@ $vendorDir = dirname(__DIR__);
$baseDir = dirname($vendorDir);
return array(
+ 'ZipStream\\' => array($vendorDir . '/maennchen/zipstream-php/src'),
+ 'Psr\\SimpleCache\\' => array($vendorDir . '/psr/simple-cache/src'),
+ 'Psr\\Http\\Message\\' => array($vendorDir . '/psr/http-factory/src', $vendorDir . '/psr/http-message/src'),
+ 'Psr\\Http\\Client\\' => array($vendorDir . '/psr/http-client/src'),
+ 'PhpOffice\\PhpSpreadsheet\\' => array($vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet'),
'PHPMailer\\PHPMailer\\' => array($vendorDir . '/phpmailer/phpmailer/src'),
- 'App\\' => array($baseDir . '/src'),
+ 'Matrix\\' => array($vendorDir . '/markbaker/matrix/classes/src'),
+ 'Composer\\Pcre\\' => array($vendorDir . '/composer/pcre/src'),
+ 'Complex\\' => array($vendorDir . '/markbaker/complex/classes/src'),
);
diff --git a/api/vendor/composer/autoload_real.php b/api/vendor/composer/autoload_real.php
index d2aba9b2..868e577d 100644
--- a/api/vendor/composer/autoload_real.php
+++ b/api/vendor/composer/autoload_real.php
@@ -22,8 +22,6 @@ class ComposerAutoloaderInit03e608fa83a14a82b3f9223977e9674e
return self::$loader;
}
- require __DIR__ . '/platform_check.php';
-
spl_autoload_register(array('ComposerAutoloaderInit03e608fa83a14a82b3f9223977e9674e', 'loadClassLoader'), true, true);
self::$loader = $loader = new \Composer\Autoload\ClassLoader(\dirname(__DIR__));
spl_autoload_unregister(array('ComposerAutoloaderInit03e608fa83a14a82b3f9223977e9674e', 'loadClassLoader'));
diff --git a/api/vendor/composer/autoload_static.php b/api/vendor/composer/autoload_static.php
index 620bbd1f..ab104bd8 100644
--- a/api/vendor/composer/autoload_static.php
+++ b/api/vendor/composer/autoload_static.php
@@ -7,29 +7,123 @@ namespace Composer\Autoload;
class ComposerStaticInit03e608fa83a14a82b3f9223977e9674e
{
public static $prefixLengthsPsr4 = array (
+ 'Z' =>
+ array (
+ 'ZipStream\\' => 10,
+ ),
'P' =>
array (
+ 'Psr\\SimpleCache\\' => 16,
+ 'Psr\\Http\\Message\\' => 17,
+ 'Psr\\Http\\Client\\' => 16,
+ 'PhpOffice\\PhpSpreadsheet\\' => 25,
'PHPMailer\\PHPMailer\\' => 20,
),
- 'A' =>
+ 'M' =>
array (
- 'App\\' => 4,
+ 'Matrix\\' => 7,
+ ),
+ 'C' =>
+ array (
+ 'Composer\\Pcre\\' => 14,
+ 'Complex\\' => 8,
),
);
public static $prefixDirsPsr4 = array (
+ 'ZipStream\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/maennchen/zipstream-php/src',
+ ),
+ 'Psr\\SimpleCache\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/psr/simple-cache/src',
+ ),
+ 'Psr\\Http\\Message\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/psr/http-factory/src',
+ 1 => __DIR__ . '/..' . '/psr/http-message/src',
+ ),
+ 'Psr\\Http\\Client\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/psr/http-client/src',
+ ),
+ 'PhpOffice\\PhpSpreadsheet\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet',
+ ),
'PHPMailer\\PHPMailer\\' =>
array (
0 => __DIR__ . '/..' . '/phpmailer/phpmailer/src',
),
- 'App\\' =>
+ 'Matrix\\' =>
array (
- 0 => __DIR__ . '/../..' . '/src',
+ 0 => __DIR__ . '/..' . '/markbaker/matrix/classes/src',
+ ),
+ 'Composer\\Pcre\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/composer/pcre/src',
+ ),
+ 'Complex\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/markbaker/complex/classes/src',
),
);
public static $classMap = array (
+ 'ApiService' => __DIR__ . '/../..' . '/src/Services/ApiService.php',
+ 'AppConfig' => __DIR__ . '/../..' . '/src/Config/AppConfig.php',
+ 'App\\Controllers\\EntiteController' => __DIR__ . '/../..' . '/src/Controllers/EntiteController.php',
+ 'App\\Controllers\\FileController' => __DIR__ . '/../..' . '/src/Controllers/FileController.php',
+ 'App\\Controllers\\LoginController' => __DIR__ . '/../..' . '/src/Controllers/LoginController.php',
+ 'App\\Controllers\\OperationController' => __DIR__ . '/../..' . '/src/Controllers/OperationController.php',
+ 'App\\Controllers\\PassageController' => __DIR__ . '/../..' . '/src/Controllers/PassageController.php',
+ 'App\\Controllers\\UserController' => __DIR__ . '/../..' . '/src/Controllers/UserController.php',
+ 'App\\Controllers\\VilleController' => __DIR__ . '/../..' . '/src/Controllers/VilleController.php',
+ 'BackupEncryptionService' => __DIR__ . '/../..' . '/src/Services/BackupEncryptionService.php',
+ 'ClientDetector' => __DIR__ . '/../..' . '/src/Utils/ClientDetector.php',
+ 'Complex\\Complex' => __DIR__ . '/..' . '/markbaker/complex/classes/src/Complex.php',
+ 'Complex\\Exception' => __DIR__ . '/..' . '/markbaker/complex/classes/src/Exception.php',
+ 'Complex\\Functions' => __DIR__ . '/..' . '/markbaker/complex/classes/src/Functions.php',
+ 'Complex\\Operations' => __DIR__ . '/..' . '/markbaker/complex/classes/src/Operations.php',
'Composer\\InstalledVersions' => __DIR__ . '/..' . '/composer/InstalledVersions.php',
+ 'Composer\\Pcre\\MatchAllResult' => __DIR__ . '/..' . '/composer/pcre/src/MatchAllResult.php',
+ 'Composer\\Pcre\\MatchAllStrictGroupsResult' => __DIR__ . '/..' . '/composer/pcre/src/MatchAllStrictGroupsResult.php',
+ 'Composer\\Pcre\\MatchAllWithOffsetsResult' => __DIR__ . '/..' . '/composer/pcre/src/MatchAllWithOffsetsResult.php',
+ 'Composer\\Pcre\\MatchResult' => __DIR__ . '/..' . '/composer/pcre/src/MatchResult.php',
+ 'Composer\\Pcre\\MatchStrictGroupsResult' => __DIR__ . '/..' . '/composer/pcre/src/MatchStrictGroupsResult.php',
+ 'Composer\\Pcre\\MatchWithOffsetsResult' => __DIR__ . '/..' . '/composer/pcre/src/MatchWithOffsetsResult.php',
+ 'Composer\\Pcre\\PHPStan\\InvalidRegexPatternRule' => __DIR__ . '/..' . '/composer/pcre/src/PHPStan/InvalidRegexPatternRule.php',
+ 'Composer\\Pcre\\PHPStan\\PregMatchFlags' => __DIR__ . '/..' . '/composer/pcre/src/PHPStan/PregMatchFlags.php',
+ 'Composer\\Pcre\\PHPStan\\PregMatchParameterOutTypeExtension' => __DIR__ . '/..' . '/composer/pcre/src/PHPStan/PregMatchParameterOutTypeExtension.php',
+ 'Composer\\Pcre\\PHPStan\\PregMatchTypeSpecifyingExtension' => __DIR__ . '/..' . '/composer/pcre/src/PHPStan/PregMatchTypeSpecifyingExtension.php',
+ 'Composer\\Pcre\\PHPStan\\PregReplaceCallbackClosureTypeExtension' => __DIR__ . '/..' . '/composer/pcre/src/PHPStan/PregReplaceCallbackClosureTypeExtension.php',
+ 'Composer\\Pcre\\PHPStan\\UnsafeStrictGroupsCallRule' => __DIR__ . '/..' . '/composer/pcre/src/PHPStan/UnsafeStrictGroupsCallRule.php',
+ 'Composer\\Pcre\\PcreException' => __DIR__ . '/..' . '/composer/pcre/src/PcreException.php',
+ 'Composer\\Pcre\\Preg' => __DIR__ . '/..' . '/composer/pcre/src/Preg.php',
+ 'Composer\\Pcre\\Regex' => __DIR__ . '/..' . '/composer/pcre/src/Regex.php',
+ 'Composer\\Pcre\\ReplaceResult' => __DIR__ . '/..' . '/composer/pcre/src/ReplaceResult.php',
+ 'Composer\\Pcre\\UnexpectedNullMatchException' => __DIR__ . '/..' . '/composer/pcre/src/UnexpectedNullMatchException.php',
+ 'Database' => __DIR__ . '/../..' . '/src/Core/Database.php',
+ 'EmailTemplates' => __DIR__ . '/../..' . '/src/Services/EmailTemplates.php',
+ 'ExportService' => __DIR__ . '/../..' . '/src/Services/ExportService.php',
+ 'LogController' => __DIR__ . '/../..' . '/src/Controllers/LogController.php',
+ 'LogService' => __DIR__ . '/../..' . '/src/Services/LogService.php',
+ 'Matrix\\Builder' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Builder.php',
+ 'Matrix\\Decomposition\\Decomposition' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Decomposition/Decomposition.php',
+ 'Matrix\\Decomposition\\LU' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Decomposition/LU.php',
+ 'Matrix\\Decomposition\\QR' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Decomposition/QR.php',
+ 'Matrix\\Div0Exception' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Div0Exception.php',
+ 'Matrix\\Exception' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Exception.php',
+ 'Matrix\\Functions' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Functions.php',
+ 'Matrix\\Matrix' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Matrix.php',
+ 'Matrix\\Operations' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Operations.php',
+ 'Matrix\\Operators\\Addition' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Operators/Addition.php',
+ 'Matrix\\Operators\\DirectSum' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Operators/DirectSum.php',
+ 'Matrix\\Operators\\Division' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Operators/Division.php',
+ 'Matrix\\Operators\\Multiplication' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Operators/Multiplication.php',
+ 'Matrix\\Operators\\Operator' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Operators/Operator.php',
+ 'Matrix\\Operators\\Subtraction' => __DIR__ . '/..' . '/markbaker/matrix/classes/src/Operators/Subtraction.php',
'PHPMailer\\PHPMailer\\DSNConfigurator' => __DIR__ . '/..' . '/phpmailer/phpmailer/src/DSNConfigurator.php',
'PHPMailer\\PHPMailer\\Exception' => __DIR__ . '/..' . '/phpmailer/phpmailer/src/Exception.php',
'PHPMailer\\PHPMailer\\OAuth' => __DIR__ . '/..' . '/phpmailer/phpmailer/src/OAuth.php',
@@ -37,6 +131,556 @@ class ComposerStaticInit03e608fa83a14a82b3f9223977e9674e
'PHPMailer\\PHPMailer\\PHPMailer' => __DIR__ . '/..' . '/phpmailer/phpmailer/src/PHPMailer.php',
'PHPMailer\\PHPMailer\\POP3' => __DIR__ . '/..' . '/phpmailer/phpmailer/src/POP3.php',
'PHPMailer\\PHPMailer\\SMTP' => __DIR__ . '/..' . '/phpmailer/phpmailer/src/SMTP.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\ArrayEnabled' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/ArrayEnabled.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\BinaryComparison' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/BinaryComparison.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Calculation' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Calculation.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Category' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Category.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DAverage' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DAverage.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DCount' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DCount.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DCountA' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DCountA.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DGet' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DGet.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DMax' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DMax.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DMin' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DMin.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DProduct' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DProduct.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DStDev' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DStDev.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DStDevP' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DStDevP.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DSum' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DSum.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DVar' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DVar.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DVarP' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DVarP.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Database\\DatabaseAbstract' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DatabaseAbstract.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Constants' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Constants.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Current' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Current.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Date' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Date.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\DateParts' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/DateParts.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\DateValue' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/DateValue.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Days' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Days.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Days360' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Days360.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Difference' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Difference.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Helpers' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Helpers.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Month' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Month.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\NetworkDays' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/NetworkDays.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Time' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Time.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\TimeParts' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/TimeParts.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\TimeValue' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/TimeValue.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\Week' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Week.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\WorkDay' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/WorkDay.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\DateTimeExcel\\YearFrac' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/YearFrac.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\ArrayArgumentHelper' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/ArrayArgumentHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\ArrayArgumentProcessor' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/ArrayArgumentProcessor.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\BranchPruner' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/BranchPruner.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\CyclicReferenceStack' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/CyclicReferenceStack.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\FormattedNumber' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/FormattedNumber.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\Logger' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/Logger.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\Operands\\Operand' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/Operands/Operand.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engine\\Operands\\StructuredReference' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/Operands/StructuredReference.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\BesselI' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselI.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\BesselJ' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselJ.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\BesselK' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselK.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\BesselY' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselY.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\BitWise' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BitWise.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\Compare' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Compare.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\Complex' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Complex.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ComplexFunctions' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ComplexFunctions.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ComplexOperations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ComplexOperations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\Constants' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Constants.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ConvertBase' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ConvertBinary' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertBinary.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ConvertDecimal' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertDecimal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ConvertHex' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertHex.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ConvertOctal' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertOctal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ConvertUOM' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertUOM.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\EngineeringValidations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/EngineeringValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\Erf' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Erf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Engineering\\ErfC' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ErfC.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Exception' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Exception.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\ExceptionHandler' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/ExceptionHandler.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Amortization' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Amortization.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\CashFlowValidations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/CashFlowValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Constant\\Periodic' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Constant\\Periodic\\Cumulative' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Cumulative.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Constant\\Periodic\\Interest' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Interest.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Constant\\Periodic\\InterestAndPrincipal' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/InterestAndPrincipal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Constant\\Periodic\\Payments' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Payments.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Single' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Single.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Variable\\NonPeriodic' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Variable/NonPeriodic.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\CashFlow\\Variable\\Periodic' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Variable/Periodic.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Constants' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Constants.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Coupons' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Coupons.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Depreciation' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Depreciation.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Dollar' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Dollar.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\FinancialValidations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/FinancialValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Helpers' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Helpers.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\InterestRate' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/InterestRate.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Securities\\AccruedInterest' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/AccruedInterest.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Securities\\Price' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Price.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Securities\\Rates' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Rates.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Securities\\SecurityValidations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/SecurityValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\Securities\\Yields' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Yields.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Financial\\TreasuryBill' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/TreasuryBill.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\FormulaParser' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/FormulaParser.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\FormulaToken' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/FormulaToken.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Functions' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Functions.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Information\\ErrorValue' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Information/ErrorValue.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Information\\ExcelError' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Information/ExcelError.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Information\\Value' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Information/Value.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Internal\\MakeMatrix' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Internal/MakeMatrix.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Internal\\WildcardMatch' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Internal/WildcardMatch.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Logical\\Boolean' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Logical/Boolean.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Logical\\Conditional' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Logical/Conditional.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Logical\\Operations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Logical/Operations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Address' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Address.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\ExcelMatch' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/ExcelMatch.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Filter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Filter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Formula' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Formula.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\HLookup' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/HLookup.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Helpers' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Helpers.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Hyperlink' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Hyperlink.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Indirect' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Indirect.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Lookup' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Lookup.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\LookupBase' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/LookupBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\LookupRefValidations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/LookupRefValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Matrix' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Matrix.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Offset' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Offset.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\RowColumnInformation' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/RowColumnInformation.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Selection' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Selection.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Sort' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Sort.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\Unique' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Unique.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\LookupRef\\VLookup' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/VLookup.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Absolute' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Absolute.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Angle' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Angle.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Arabic' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Arabic.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Base' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Base.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Ceiling' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Ceiling.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Combinations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Combinations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Exp' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Exp.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Factorial' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Factorial.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Floor' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Floor.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Gcd' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Gcd.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Helpers' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Helpers.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\IntClass' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/IntClass.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Lcm' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Lcm.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Logarithms' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Logarithms.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\MatrixFunctions' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/MatrixFunctions.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Operations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Operations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Random' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Random.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Roman' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Roman.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Round' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Round.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\SeriesSum' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/SeriesSum.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Sign' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sign.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Sqrt' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sqrt.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Subtotal' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Subtotal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Sum' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sum.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\SumSquares' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/SumSquares.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trig\\Cosecant' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cosecant.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trig\\Cosine' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cosine.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trig\\Cotangent' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cotangent.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trig\\Secant' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Secant.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trig\\Sine' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Sine.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trig\\Tangent' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Tangent.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\MathTrig\\Trunc' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trunc.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\AggregateBase' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/AggregateBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Averages' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Averages.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Averages\\Mean' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Averages/Mean.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Conditional' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Conditional.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Confidence' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Confidence.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Counts' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Counts.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Deviations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Deviations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Beta' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Beta.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Binomial' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Binomial.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\ChiSquared' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/ChiSquared.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\DistributionValidations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/DistributionValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Exponential' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Exponential.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\F' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/F.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Fisher' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Fisher.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Gamma' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Gamma.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\GammaBase' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/GammaBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\HyperGeometric' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/HyperGeometric.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\LogNormal' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/LogNormal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\NewtonRaphson' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/NewtonRaphson.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Normal' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Normal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Poisson' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Poisson.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\StandardNormal' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/StandardNormal.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\StudentT' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/StudentT.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Distributions\\Weibull' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Weibull.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\MaxMinBase' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/MaxMinBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Maximum' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Maximum.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Minimum' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Minimum.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Percentiles' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Percentiles.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Permutations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Permutations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Size' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Size.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\StandardDeviations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/StandardDeviations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Standardize' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Standardize.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\StatisticalValidations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/StatisticalValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Trends' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Trends.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\VarianceBase' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/VarianceBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Statistical\\Variances' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Variances.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\CaseConvert' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/CaseConvert.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\CharacterConvert' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/CharacterConvert.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Concatenate' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Concatenate.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Extract' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Extract.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Format' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Format.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Helpers' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Helpers.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Replace' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Replace.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Search' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Search.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Text' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Text.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\TextData\\Trim' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Trim.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Token\\Stack' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Token/Stack.php',
+ 'PhpOffice\\PhpSpreadsheet\\Calculation\\Web\\Service' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Web/Service.php',
+ 'PhpOffice\\PhpSpreadsheet\\CellReferenceHelper' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/CellReferenceHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\AddressHelper' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/AddressHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\AddressRange' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/AddressRange.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\AdvancedValueBinder' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/AdvancedValueBinder.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\Cell' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Cell.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\CellAddress' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/CellAddress.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\CellRange' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/CellRange.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\ColumnRange' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/ColumnRange.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\Coordinate' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Coordinate.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\DataType' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataType.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\DataValidation' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataValidation.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\DataValidator' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataValidator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\DefaultValueBinder' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DefaultValueBinder.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\Hyperlink' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Hyperlink.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\IValueBinder' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/IValueBinder.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\IgnoredErrors' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/IgnoredErrors.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\RowRange' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/RowRange.php',
+ 'PhpOffice\\PhpSpreadsheet\\Cell\\StringValueBinder' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/StringValueBinder.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Axis' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Axis.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\AxisText' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/AxisText.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Chart' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Chart.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\ChartColor' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/ChartColor.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\DataSeries' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/DataSeries.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\DataSeriesValues' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/DataSeriesValues.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Exception' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Exception.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\GridLines' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/GridLines.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Layout' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Layout.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Legend' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Legend.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\PlotArea' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/PlotArea.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Properties' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Properties.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Renderer\\IRenderer' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/IRenderer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Renderer\\JpGraph' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/JpGraph.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Renderer\\JpGraphRendererBase' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/JpGraphRendererBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Renderer\\MtJpGraphRenderer' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/MtJpGraphRenderer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\Title' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Title.php',
+ 'PhpOffice\\PhpSpreadsheet\\Chart\\TrendLine' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/TrendLine.php',
+ 'PhpOffice\\PhpSpreadsheet\\Collection\\Cells' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/Cells.php',
+ 'PhpOffice\\PhpSpreadsheet\\Collection\\CellsFactory' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/CellsFactory.php',
+ 'PhpOffice\\PhpSpreadsheet\\Collection\\Memory\\SimpleCache1' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/Memory/SimpleCache1.php',
+ 'PhpOffice\\PhpSpreadsheet\\Collection\\Memory\\SimpleCache3' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/Memory/SimpleCache3.php',
+ 'PhpOffice\\PhpSpreadsheet\\Comment' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Comment.php',
+ 'PhpOffice\\PhpSpreadsheet\\DefinedName' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/DefinedName.php',
+ 'PhpOffice\\PhpSpreadsheet\\Document\\Properties' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Document/Properties.php',
+ 'PhpOffice\\PhpSpreadsheet\\Document\\Security' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Document/Security.php',
+ 'PhpOffice\\PhpSpreadsheet\\Exception' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Exception.php',
+ 'PhpOffice\\PhpSpreadsheet\\HashTable' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/HashTable.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\Dimension' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Dimension.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\Downloader' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Downloader.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\Handler' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Handler.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\Html' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Html.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\Sample' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Sample.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\Size' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Size.php',
+ 'PhpOffice\\PhpSpreadsheet\\Helper\\TextGrid' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/TextGrid.php',
+ 'PhpOffice\\PhpSpreadsheet\\IComparable' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/IComparable.php',
+ 'PhpOffice\\PhpSpreadsheet\\IOFactory' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/IOFactory.php',
+ 'PhpOffice\\PhpSpreadsheet\\NamedFormula' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/NamedFormula.php',
+ 'PhpOffice\\PhpSpreadsheet\\NamedRange' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/NamedRange.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\BaseReader' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/BaseReader.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Csv' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Csv.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Csv\\Delimiter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Csv/Delimiter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\DefaultReadFilter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/DefaultReadFilter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Exception' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Exception.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Gnumeric' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Gnumeric\\PageSetup' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/PageSetup.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Gnumeric\\Properties' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/Properties.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Gnumeric\\Styles' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/Styles.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Html' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Html.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\IReadFilter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/IReadFilter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\IReader' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/IReader.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods\\AutoFilter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/AutoFilter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods\\BaseLoader' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/BaseLoader.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods\\DefinedNames' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/DefinedNames.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods\\FormulaTranslator' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/FormulaTranslator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods\\PageSettings' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/PageSettings.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Ods\\Properties' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/Properties.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Security\\XmlScanner' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Security/XmlScanner.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Slk' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Slk.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Color' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Color\\BIFF5' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BIFF5.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Color\\BIFF8' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BIFF8.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Color\\BuiltIn' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BuiltIn.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\ConditionalFormatting' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/ConditionalFormatting.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\DataValidationHelper' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/DataValidationHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\ErrorCode' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/ErrorCode.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Escher' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Escher.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\MD5' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/MD5.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\RC4' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/RC4.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Style\\Border' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/Border.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Style\\CellAlignment' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/CellAlignment.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Style\\CellFont' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/CellFont.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xls\\Style\\FillPattern' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/FillPattern.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\AutoFilter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/AutoFilter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\BaseParserClass' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/BaseParserClass.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\Chart' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Chart.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\ColumnAndRowAttributes' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/ColumnAndRowAttributes.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\ConditionalStyles' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/ConditionalStyles.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\DataValidations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/DataValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\Hyperlinks' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Hyperlinks.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\Namespaces' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Namespaces.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\PageSetup' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/PageSetup.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\Properties' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Properties.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\SharedFormula' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SharedFormula.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\SheetViewOptions' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SheetViewOptions.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\SheetViews' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SheetViews.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\Styles' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Styles.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\TableReader' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/TableReader.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\Theme' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Theme.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xlsx\\WorkbookView' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/WorkbookView.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\DataValidations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/DataValidations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\PageSettings' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/PageSettings.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Properties' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Properties.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style\\Alignment' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Alignment.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style\\Border' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Border.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style\\Fill' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Fill.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style\\Font' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Font.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style\\NumberFormat' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/NumberFormat.php',
+ 'PhpOffice\\PhpSpreadsheet\\Reader\\Xml\\Style\\StyleBase' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/StyleBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\ReferenceHelper' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/ReferenceHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\RichText\\ITextElement' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/ITextElement.php',
+ 'PhpOffice\\PhpSpreadsheet\\RichText\\RichText' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/RichText.php',
+ 'PhpOffice\\PhpSpreadsheet\\RichText\\Run' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/Run.php',
+ 'PhpOffice\\PhpSpreadsheet\\RichText\\TextElement' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/TextElement.php',
+ 'PhpOffice\\PhpSpreadsheet\\Settings' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Settings.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\CodePage' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/CodePage.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Date' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Date.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Drawing' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Drawing.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DgContainer' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DgContainer\\SpgrContainer' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer/SpgrContainer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DgContainer\\SpgrContainer\\SpContainer' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer/SpgrContainer/SpContainer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DggContainer' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DggContainer\\BstoreContainer' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DggContainer\\BstoreContainer\\BSE' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer/BSE.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Escher\\DggContainer\\BstoreContainer\\BSE\\Blip' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer/BSE/Blip.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\File' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/File.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Font' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Font.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\IntOrFloat' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/IntOrFloat.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\OLE' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\OLERead' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLERead.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\OLE\\ChainedBlockStream' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/ChainedBlockStream.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\OLE\\PPS' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\OLE\\PPS\\File' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS/File.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\OLE\\PPS\\Root' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS/Root.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\PasswordHasher' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/PasswordHasher.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\StringHelper' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/StringHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\TimeZone' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/TimeZone.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\BestFit' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/BestFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\ExponentialBestFit' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/ExponentialBestFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\LinearBestFit' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/LinearBestFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\LogarithmicBestFit' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/LogarithmicBestFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\PolynomialBestFit' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/PolynomialBestFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\PowerBestFit' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/PowerBestFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Trend\\Trend' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/Trend.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\XMLWriter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/XMLWriter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Shared\\Xls' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Xls.php',
+ 'PhpOffice\\PhpSpreadsheet\\Spreadsheet' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Spreadsheet.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Alignment' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Alignment.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Border' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Border.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Borders' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Borders.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Color' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Color.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Conditional' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Conditional.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\CellMatcher' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/CellMatcher.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\CellStyleAssessor' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/CellStyleAssessor.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\ConditionalColorScale' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalColorScale.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\ConditionalDataBar' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalDataBar.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\ConditionalDataBarExtension' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalDataBarExtension.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\ConditionalFormatValueObject' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalFormatValueObject.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\ConditionalFormattingRuleExtension' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalFormattingRuleExtension.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\StyleMerger' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/StyleMerger.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\Blanks' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Blanks.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\CellValue' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/CellValue.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\DateValue' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/DateValue.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\Duplicates' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Duplicates.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\Errors' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Errors.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\Expression' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Expression.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\TextValue' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/TextValue.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\WizardAbstract' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/WizardAbstract.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\ConditionalFormatting\\Wizard\\WizardInterface' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/WizardInterface.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Fill' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Fill.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Font' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Font.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\BaseFormatter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/BaseFormatter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\DateFormatter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/DateFormatter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Formatter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Formatter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\FractionFormatter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/FractionFormatter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\NumberFormatter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/NumberFormatter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\PercentageFormatter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/PercentageFormatter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Accounting' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Accounting.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Currency' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Currency.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Date' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Date.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\DateTime' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/DateTime.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\DateTimeWizard' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/DateTimeWizard.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Duration' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Duration.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Locale' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Locale.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Number' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Number.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\NumberBase' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/NumberBase.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Percentage' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Percentage.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Scientific' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Scientific.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Time' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Time.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\NumberFormat\\Wizard\\Wizard' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Wizard.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Protection' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Protection.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\RgbTint' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/RgbTint.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Style' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Style.php',
+ 'PhpOffice\\PhpSpreadsheet\\Style\\Supervisor' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Supervisor.php',
+ 'PhpOffice\\PhpSpreadsheet\\Theme' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Theme.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\AutoFilter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/AutoFilter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\AutoFilter\\Column' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/AutoFilter/Column.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\AutoFilter\\Column\\Rule' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/AutoFilter/Column/Rule.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\AutoFit' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/AutoFit.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\BaseDrawing' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/BaseDrawing.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\CellIterator' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/CellIterator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Column' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Column.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\ColumnCellIterator' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/ColumnCellIterator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\ColumnDimension' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/ColumnDimension.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\ColumnIterator' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/ColumnIterator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Dimension' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Dimension.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Drawing' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Drawing.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Drawing\\Shadow' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Drawing/Shadow.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\HeaderFooter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/HeaderFooter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\HeaderFooterDrawing' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/HeaderFooterDrawing.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Iterator' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Iterator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\MemoryDrawing' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/MemoryDrawing.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\PageBreak' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/PageBreak.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\PageMargins' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/PageMargins.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\PageSetup' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/PageSetup.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Pane' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Pane.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\ProtectedRange' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/ProtectedRange.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Protection' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Protection.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Row' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Row.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\RowCellIterator' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/RowCellIterator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\RowDimension' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/RowDimension.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\RowIterator' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/RowIterator.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\SheetView' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/SheetView.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Table' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Table.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Table\\Column' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Table/Column.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Table\\TableStyle' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Table/TableStyle.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Validations' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Validations.php',
+ 'PhpOffice\\PhpSpreadsheet\\Worksheet\\Worksheet' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Worksheet/Worksheet.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\BaseWriter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/BaseWriter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Csv' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Csv.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Exception' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Exception.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Html' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Html.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\IWriter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/IWriter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\AutoFilters' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/AutoFilters.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Cell\\Comment' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Cell/Comment.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Cell\\Style' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Cell/Style.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Content' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Content.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Formula' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Formula.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Meta' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Meta.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\MetaInf' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/MetaInf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Mimetype' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Mimetype.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\NamedExpressions' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/NamedExpressions.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Settings' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Settings.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Styles' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Styles.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\Thumbnails' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/Thumbnails.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Ods\\WriterPart' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Ods/WriterPart.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Pdf' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Pdf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Pdf\\Dompdf' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Pdf/Dompdf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Pdf\\Mpdf' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Pdf/Mpdf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Pdf\\Tcpdf' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Pdf/Tcpdf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\BIFFwriter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/BIFFwriter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\CellDataValidation' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/CellDataValidation.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\ConditionalHelper' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/ConditionalHelper.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\ErrorCode' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/ErrorCode.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Escher' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Escher.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Font' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Font.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Parser' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Parser.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Style\\CellAlignment' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Style/CellAlignment.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Style\\CellBorder' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Style/CellBorder.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Style\\CellFill' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Style/CellFill.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Style\\ColorMap' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Style/ColorMap.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Workbook' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Workbook.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Worksheet' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Worksheet.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xls\\Xf' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xls/Xf.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\AutoFilter' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/AutoFilter.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Chart' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Chart.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Comments' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Comments.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\ContentTypes' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/ContentTypes.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\DefinedNames' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/DefinedNames.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\DocProps' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/DocProps.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Drawing' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Drawing.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\FunctionPrefix' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/FunctionPrefix.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Rels' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Rels.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\RelsRibbon' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/RelsRibbon.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\RelsVBA' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/RelsVBA.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\StringTable' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/StringTable.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Style' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Style.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Table' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Table.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Theme' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Theme.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Workbook' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Workbook.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\Worksheet' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/Worksheet.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\Xlsx\\WriterPart' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/Xlsx/WriterPart.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\ZipStream0' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/ZipStream0.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\ZipStream2' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/ZipStream2.php',
+ 'PhpOffice\\PhpSpreadsheet\\Writer\\ZipStream3' => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Writer/ZipStream3.php',
+ 'Psr\\Http\\Client\\ClientExceptionInterface' => __DIR__ . '/..' . '/psr/http-client/src/ClientExceptionInterface.php',
+ 'Psr\\Http\\Client\\ClientInterface' => __DIR__ . '/..' . '/psr/http-client/src/ClientInterface.php',
+ 'Psr\\Http\\Client\\NetworkExceptionInterface' => __DIR__ . '/..' . '/psr/http-client/src/NetworkExceptionInterface.php',
+ 'Psr\\Http\\Client\\RequestExceptionInterface' => __DIR__ . '/..' . '/psr/http-client/src/RequestExceptionInterface.php',
+ 'Psr\\Http\\Message\\MessageInterface' => __DIR__ . '/..' . '/psr/http-message/src/MessageInterface.php',
+ 'Psr\\Http\\Message\\RequestFactoryInterface' => __DIR__ . '/..' . '/psr/http-factory/src/RequestFactoryInterface.php',
+ 'Psr\\Http\\Message\\RequestInterface' => __DIR__ . '/..' . '/psr/http-message/src/RequestInterface.php',
+ 'Psr\\Http\\Message\\ResponseFactoryInterface' => __DIR__ . '/..' . '/psr/http-factory/src/ResponseFactoryInterface.php',
+ 'Psr\\Http\\Message\\ResponseInterface' => __DIR__ . '/..' . '/psr/http-message/src/ResponseInterface.php',
+ 'Psr\\Http\\Message\\ServerRequestFactoryInterface' => __DIR__ . '/..' . '/psr/http-factory/src/ServerRequestFactoryInterface.php',
+ 'Psr\\Http\\Message\\ServerRequestInterface' => __DIR__ . '/..' . '/psr/http-message/src/ServerRequestInterface.php',
+ 'Psr\\Http\\Message\\StreamFactoryInterface' => __DIR__ . '/..' . '/psr/http-factory/src/StreamFactoryInterface.php',
+ 'Psr\\Http\\Message\\StreamInterface' => __DIR__ . '/..' . '/psr/http-message/src/StreamInterface.php',
+ 'Psr\\Http\\Message\\UploadedFileFactoryInterface' => __DIR__ . '/..' . '/psr/http-factory/src/UploadedFileFactoryInterface.php',
+ 'Psr\\Http\\Message\\UploadedFileInterface' => __DIR__ . '/..' . '/psr/http-message/src/UploadedFileInterface.php',
+ 'Psr\\Http\\Message\\UriFactoryInterface' => __DIR__ . '/..' . '/psr/http-factory/src/UriFactoryInterface.php',
+ 'Psr\\Http\\Message\\UriInterface' => __DIR__ . '/..' . '/psr/http-message/src/UriInterface.php',
+ 'Psr\\SimpleCache\\CacheException' => __DIR__ . '/..' . '/psr/simple-cache/src/CacheException.php',
+ 'Psr\\SimpleCache\\CacheInterface' => __DIR__ . '/..' . '/psr/simple-cache/src/CacheInterface.php',
+ 'Psr\\SimpleCache\\InvalidArgumentException' => __DIR__ . '/..' . '/psr/simple-cache/src/InvalidArgumentException.php',
+ 'Request' => __DIR__ . '/../..' . '/src/Core/Request.php',
+ 'Response' => __DIR__ . '/../..' . '/src/Core/Response.php',
+ 'Router' => __DIR__ . '/../..' . '/src/Core/Router.php',
+ 'Session' => __DIR__ . '/../..' . '/src/Core/Session.php',
+ 'ZipStream\\CentralDirectoryFileHeader' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/CentralDirectoryFileHeader.php',
+ 'ZipStream\\CompressionMethod' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/CompressionMethod.php',
+ 'ZipStream\\DataDescriptor' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/DataDescriptor.php',
+ 'ZipStream\\EndOfCentralDirectory' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/EndOfCentralDirectory.php',
+ 'ZipStream\\Exception' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Exception.php',
+ 'ZipStream\\Exception\\DosTimeOverflowException' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Exception/DosTimeOverflowException.php',
+ 'ZipStream\\Exception\\FileNotFoundException' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Exception/FileNotFoundException.php',
+ 'ZipStream\\Exception\\FileNotReadableException' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Exception/FileNotReadableException.php',
+ 'ZipStream\\Exception\\FileSizeIncorrectException' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Exception/FileSizeIncorrectException.php',
+ 'ZipStream\\Exception\\OverflowException' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Exception/OverflowException.php',
+ 'ZipStream\\Exception\\ResourceActionException' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Exception/ResourceActionException.php',
+ 'ZipStream\\Exception\\SimulationFileUnknownException' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Exception/SimulationFileUnknownException.php',
+ 'ZipStream\\Exception\\StreamNotReadableException' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Exception/StreamNotReadableException.php',
+ 'ZipStream\\Exception\\StreamNotSeekableException' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Exception/StreamNotSeekableException.php',
+ 'ZipStream\\File' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/File.php',
+ 'ZipStream\\GeneralPurposeBitFlag' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/GeneralPurposeBitFlag.php',
+ 'ZipStream\\LocalFileHeader' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/LocalFileHeader.php',
+ 'ZipStream\\OperationMode' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/OperationMode.php',
+ 'ZipStream\\PackField' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/PackField.php',
+ 'ZipStream\\Time' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Time.php',
+ 'ZipStream\\Version' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Version.php',
+ 'ZipStream\\Zip64\\DataDescriptor' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Zip64/DataDescriptor.php',
+ 'ZipStream\\Zip64\\EndOfCentralDirectory' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Zip64/EndOfCentralDirectory.php',
+ 'ZipStream\\Zip64\\EndOfCentralDirectoryLocator' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Zip64/EndOfCentralDirectoryLocator.php',
+ 'ZipStream\\Zip64\\ExtendedInformationExtraField' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Zip64/ExtendedInformationExtraField.php',
+ 'ZipStream\\ZipStream' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/ZipStream.php',
+ 'ZipStream\\Zs\\ExtendedInformationExtraField' => __DIR__ . '/..' . '/maennchen/zipstream-php/src/Zs/ExtendedInformationExtraField.php',
);
public static function getInitializer(ClassLoader $loader)
diff --git a/api/vendor/composer/installed.json b/api/vendor/composer/installed.json
index 6a697b3c..f5cf0fba 100644
--- a/api/vendor/composer/installed.json
+++ b/api/vendor/composer/installed.json
@@ -1,18 +1,294 @@
{
"packages": [
{
- "name": "phpmailer/phpmailer",
- "version": "v6.9.3",
- "version_normalized": "6.9.3.0",
+ "name": "composer/pcre",
+ "version": "3.3.2",
+ "version_normalized": "3.3.2.0",
"source": {
"type": "git",
- "url": "https://github.com/PHPMailer/PHPMailer.git",
- "reference": "2f5c94fe7493efc213f643c23b1b1c249d40f47e"
+ "url": "https://github.com/composer/pcre.git",
+ "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e"
},
"dist": {
"type": "zip",
- "url": "https://api.github.com/repos/PHPMailer/PHPMailer/zipball/2f5c94fe7493efc213f643c23b1b1c249d40f47e",
- "reference": "2f5c94fe7493efc213f643c23b1b1c249d40f47e",
+ "url": "https://api.github.com/repos/composer/pcre/zipball/b2bed4734f0cc156ee1fe9c0da2550420d99a21e",
+ "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e",
+ "shasum": ""
+ },
+ "require": {
+ "php": "^7.4 || ^8.0"
+ },
+ "conflict": {
+ "phpstan/phpstan": "<1.11.10"
+ },
+ "require-dev": {
+ "phpstan/phpstan": "^1.12 || ^2",
+ "phpstan/phpstan-strict-rules": "^1 || ^2",
+ "phpunit/phpunit": "^8 || ^9"
+ },
+ "time": "2024-11-12T16:29:46+00:00",
+ "type": "library",
+ "extra": {
+ "phpstan": {
+ "includes": [
+ "extension.neon"
+ ]
+ },
+ "branch-alias": {
+ "dev-main": "3.x-dev"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Composer\\Pcre\\": "src"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Jordi Boggiano",
+ "email": "j.boggiano@seld.be",
+ "homepage": "http://seld.be"
+ }
+ ],
+ "description": "PCRE wrapping library that offers type-safe preg_* replacements.",
+ "keywords": [
+ "PCRE",
+ "preg",
+ "regex",
+ "regular expression"
+ ],
+ "support": {
+ "issues": "https://github.com/composer/pcre/issues",
+ "source": "https://github.com/composer/pcre/tree/3.3.2"
+ },
+ "funding": [
+ {
+ "url": "https://packagist.com",
+ "type": "custom"
+ },
+ {
+ "url": "https://github.com/composer",
+ "type": "github"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/composer/composer",
+ "type": "tidelift"
+ }
+ ],
+ "install-path": "./pcre"
+ },
+ {
+ "name": "maennchen/zipstream-php",
+ "version": "3.1.2",
+ "version_normalized": "3.1.2.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/maennchen/ZipStream-PHP.git",
+ "reference": "aeadcf5c412332eb426c0f9b4485f6accba2a99f"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/maennchen/ZipStream-PHP/zipball/aeadcf5c412332eb426c0f9b4485f6accba2a99f",
+ "reference": "aeadcf5c412332eb426c0f9b4485f6accba2a99f",
+ "shasum": ""
+ },
+ "require": {
+ "ext-mbstring": "*",
+ "ext-zlib": "*",
+ "php-64bit": "^8.2"
+ },
+ "require-dev": {
+ "brianium/paratest": "^7.7",
+ "ext-zip": "*",
+ "friendsofphp/php-cs-fixer": "^3.16",
+ "guzzlehttp/guzzle": "^7.5",
+ "mikey179/vfsstream": "^1.6",
+ "php-coveralls/php-coveralls": "^2.5",
+ "phpunit/phpunit": "^11.0",
+ "vimeo/psalm": "^6.0"
+ },
+ "suggest": {
+ "guzzlehttp/psr7": "^2.4",
+ "psr/http-message": "^2.0"
+ },
+ "time": "2025-01-27T12:07:53+00:00",
+ "type": "library",
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "ZipStream\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Paul Duncan",
+ "email": "pabs@pablotron.org"
+ },
+ {
+ "name": "Jonatan Männchen",
+ "email": "jonatan@maennchen.ch"
+ },
+ {
+ "name": "Jesse Donat",
+ "email": "donatj@gmail.com"
+ },
+ {
+ "name": "András Kolesár",
+ "email": "kolesar@kolesar.hu"
+ }
+ ],
+ "description": "ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.",
+ "keywords": [
+ "stream",
+ "zip"
+ ],
+ "support": {
+ "issues": "https://github.com/maennchen/ZipStream-PHP/issues",
+ "source": "https://github.com/maennchen/ZipStream-PHP/tree/3.1.2"
+ },
+ "funding": [
+ {
+ "url": "https://github.com/maennchen",
+ "type": "github"
+ }
+ ],
+ "install-path": "../maennchen/zipstream-php"
+ },
+ {
+ "name": "markbaker/complex",
+ "version": "3.0.2",
+ "version_normalized": "3.0.2.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/MarkBaker/PHPComplex.git",
+ "reference": "95c56caa1cf5c766ad6d65b6344b807c1e8405b9"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/MarkBaker/PHPComplex/zipball/95c56caa1cf5c766ad6d65b6344b807c1e8405b9",
+ "reference": "95c56caa1cf5c766ad6d65b6344b807c1e8405b9",
+ "shasum": ""
+ },
+ "require": {
+ "php": "^7.2 || ^8.0"
+ },
+ "require-dev": {
+ "dealerdirect/phpcodesniffer-composer-installer": "dev-master",
+ "phpcompatibility/php-compatibility": "^9.3",
+ "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0",
+ "squizlabs/php_codesniffer": "^3.7"
+ },
+ "time": "2022-12-06T16:21:08+00:00",
+ "type": "library",
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Complex\\": "classes/src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Mark Baker",
+ "email": "mark@lange.demon.co.uk"
+ }
+ ],
+ "description": "PHP Class for working with complex numbers",
+ "homepage": "https://github.com/MarkBaker/PHPComplex",
+ "keywords": [
+ "complex",
+ "mathematics"
+ ],
+ "support": {
+ "issues": "https://github.com/MarkBaker/PHPComplex/issues",
+ "source": "https://github.com/MarkBaker/PHPComplex/tree/3.0.2"
+ },
+ "install-path": "../markbaker/complex"
+ },
+ {
+ "name": "markbaker/matrix",
+ "version": "3.0.1",
+ "version_normalized": "3.0.1.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/MarkBaker/PHPMatrix.git",
+ "reference": "728434227fe21be27ff6d86621a1b13107a2562c"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/MarkBaker/PHPMatrix/zipball/728434227fe21be27ff6d86621a1b13107a2562c",
+ "reference": "728434227fe21be27ff6d86621a1b13107a2562c",
+ "shasum": ""
+ },
+ "require": {
+ "php": "^7.1 || ^8.0"
+ },
+ "require-dev": {
+ "dealerdirect/phpcodesniffer-composer-installer": "dev-master",
+ "phpcompatibility/php-compatibility": "^9.3",
+ "phpdocumentor/phpdocumentor": "2.*",
+ "phploc/phploc": "^4.0",
+ "phpmd/phpmd": "2.*",
+ "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0",
+ "sebastian/phpcpd": "^4.0",
+ "squizlabs/php_codesniffer": "^3.7"
+ },
+ "time": "2022-12-02T22:17:43+00:00",
+ "type": "library",
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Matrix\\": "classes/src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Mark Baker",
+ "email": "mark@demon-angel.eu"
+ }
+ ],
+ "description": "PHP Class for working with matrices",
+ "homepage": "https://github.com/MarkBaker/PHPMatrix",
+ "keywords": [
+ "mathematics",
+ "matrix",
+ "vector"
+ ],
+ "support": {
+ "issues": "https://github.com/MarkBaker/PHPMatrix/issues",
+ "source": "https://github.com/MarkBaker/PHPMatrix/tree/3.0.1"
+ },
+ "install-path": "../markbaker/matrix"
+ },
+ {
+ "name": "phpmailer/phpmailer",
+ "version": "v6.10.0",
+ "version_normalized": "6.10.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/PHPMailer/PHPMailer.git",
+ "reference": "bf74d75a1fde6beaa34a0ddae2ec5fce0f72a144"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/PHPMailer/PHPMailer/zipball/bf74d75a1fde6beaa34a0ddae2ec5fce0f72a144",
+ "reference": "bf74d75a1fde6beaa34a0ddae2ec5fce0f72a144",
"shasum": ""
},
"require": {
@@ -42,7 +318,7 @@
"symfony/polyfill-mbstring": "To support UTF-8 if the Mbstring PHP extension is not enabled (^1.2)",
"thenetworg/oauth2-azure": "Needed for Microsoft XOAUTH2 authentication"
},
- "time": "2024-11-24T18:04:13+00:00",
+ "time": "2025-04-24T15:19:31+00:00",
"type": "library",
"installation-source": "dist",
"autoload": {
@@ -74,7 +350,7 @@
"description": "PHPMailer is a full-featured email creation and transfer class for PHP",
"support": {
"issues": "https://github.com/PHPMailer/PHPMailer/issues",
- "source": "https://github.com/PHPMailer/PHPMailer/tree/v6.9.3"
+ "source": "https://github.com/PHPMailer/PHPMailer/tree/v6.10.0"
},
"funding": [
{
@@ -83,6 +359,337 @@
}
],
"install-path": "../phpmailer/phpmailer"
+ },
+ {
+ "name": "phpoffice/phpspreadsheet",
+ "version": "2.3.8",
+ "version_normalized": "2.3.8.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/PHPOffice/PhpSpreadsheet.git",
+ "reference": "7a700683743bf1c4a21837c84b266916f1aa7d25"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/PHPOffice/PhpSpreadsheet/zipball/7a700683743bf1c4a21837c84b266916f1aa7d25",
+ "reference": "7a700683743bf1c4a21837c84b266916f1aa7d25",
+ "shasum": ""
+ },
+ "require": {
+ "composer/pcre": "^1 || ^2 || ^3",
+ "ext-ctype": "*",
+ "ext-dom": "*",
+ "ext-fileinfo": "*",
+ "ext-gd": "*",
+ "ext-iconv": "*",
+ "ext-libxml": "*",
+ "ext-mbstring": "*",
+ "ext-simplexml": "*",
+ "ext-xml": "*",
+ "ext-xmlreader": "*",
+ "ext-xmlwriter": "*",
+ "ext-zip": "*",
+ "ext-zlib": "*",
+ "maennchen/zipstream-php": "^2.1 || ^3.0",
+ "markbaker/complex": "^3.0",
+ "markbaker/matrix": "^3.0",
+ "php": "^8.1",
+ "psr/http-client": "^1.0",
+ "psr/http-factory": "^1.0",
+ "psr/simple-cache": "^1.0 || ^2.0 || ^3.0"
+ },
+ "require-dev": {
+ "dealerdirect/phpcodesniffer-composer-installer": "dev-main",
+ "dompdf/dompdf": "^2.0 || ^3.0",
+ "friendsofphp/php-cs-fixer": "^3.2",
+ "mitoteam/jpgraph": "^10.3",
+ "mpdf/mpdf": "^8.1.1",
+ "phpcompatibility/php-compatibility": "^9.3",
+ "phpstan/phpstan": "^1.1",
+ "phpstan/phpstan-phpunit": "^1.0",
+ "phpunit/phpunit": "^9.6 || ^10.5",
+ "squizlabs/php_codesniffer": "^3.7",
+ "tecnickcom/tcpdf": "^6.5"
+ },
+ "suggest": {
+ "dompdf/dompdf": "Option for rendering PDF with PDF Writer",
+ "ext-intl": "PHP Internationalization Functions",
+ "mitoteam/jpgraph": "Option for rendering charts, or including charts with PDF or HTML Writers",
+ "mpdf/mpdf": "Option for rendering PDF with PDF Writer",
+ "tecnickcom/tcpdf": "Option for rendering PDF with PDF Writer"
+ },
+ "time": "2025-02-08T03:01:45+00:00",
+ "type": "library",
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "PhpOffice\\PhpSpreadsheet\\": "src/PhpSpreadsheet"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Maarten Balliauw",
+ "homepage": "https://blog.maartenballiauw.be"
+ },
+ {
+ "name": "Mark Baker",
+ "homepage": "https://markbakeruk.net"
+ },
+ {
+ "name": "Franck Lefevre",
+ "homepage": "https://rootslabs.net"
+ },
+ {
+ "name": "Erik Tilt"
+ },
+ {
+ "name": "Adrien Crivelli"
+ }
+ ],
+ "description": "PHPSpreadsheet - Read, Create and Write Spreadsheet documents in PHP - Spreadsheet engine",
+ "homepage": "https://github.com/PHPOffice/PhpSpreadsheet",
+ "keywords": [
+ "OpenXML",
+ "excel",
+ "gnumeric",
+ "ods",
+ "php",
+ "spreadsheet",
+ "xls",
+ "xlsx"
+ ],
+ "support": {
+ "issues": "https://github.com/PHPOffice/PhpSpreadsheet/issues",
+ "source": "https://github.com/PHPOffice/PhpSpreadsheet/tree/2.3.8"
+ },
+ "install-path": "../phpoffice/phpspreadsheet"
+ },
+ {
+ "name": "psr/http-client",
+ "version": "1.0.3",
+ "version_normalized": "1.0.3.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/php-fig/http-client.git",
+ "reference": "bb5906edc1c324c9a05aa0873d40117941e5fa90"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/php-fig/http-client/zipball/bb5906edc1c324c9a05aa0873d40117941e5fa90",
+ "reference": "bb5906edc1c324c9a05aa0873d40117941e5fa90",
+ "shasum": ""
+ },
+ "require": {
+ "php": "^7.0 || ^8.0",
+ "psr/http-message": "^1.0 || ^2.0"
+ },
+ "time": "2023-09-23T14:17:50+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "1.0.x-dev"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Psr\\Http\\Client\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "https://www.php-fig.org/"
+ }
+ ],
+ "description": "Common interface for HTTP clients",
+ "homepage": "https://github.com/php-fig/http-client",
+ "keywords": [
+ "http",
+ "http-client",
+ "psr",
+ "psr-18"
+ ],
+ "support": {
+ "source": "https://github.com/php-fig/http-client"
+ },
+ "install-path": "../psr/http-client"
+ },
+ {
+ "name": "psr/http-factory",
+ "version": "1.1.0",
+ "version_normalized": "1.1.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/php-fig/http-factory.git",
+ "reference": "2b4765fddfe3b508ac62f829e852b1501d3f6e8a"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/php-fig/http-factory/zipball/2b4765fddfe3b508ac62f829e852b1501d3f6e8a",
+ "reference": "2b4765fddfe3b508ac62f829e852b1501d3f6e8a",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=7.1",
+ "psr/http-message": "^1.0 || ^2.0"
+ },
+ "time": "2024-04-15T12:06:14+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "1.0.x-dev"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Psr\\Http\\Message\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "https://www.php-fig.org/"
+ }
+ ],
+ "description": "PSR-17: Common interfaces for PSR-7 HTTP message factories",
+ "keywords": [
+ "factory",
+ "http",
+ "message",
+ "psr",
+ "psr-17",
+ "psr-7",
+ "request",
+ "response"
+ ],
+ "support": {
+ "source": "https://github.com/php-fig/http-factory"
+ },
+ "install-path": "../psr/http-factory"
+ },
+ {
+ "name": "psr/http-message",
+ "version": "2.0",
+ "version_normalized": "2.0.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/php-fig/http-message.git",
+ "reference": "402d35bcb92c70c026d1a6a9883f06b2ead23d71"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/php-fig/http-message/zipball/402d35bcb92c70c026d1a6a9883f06b2ead23d71",
+ "reference": "402d35bcb92c70c026d1a6a9883f06b2ead23d71",
+ "shasum": ""
+ },
+ "require": {
+ "php": "^7.2 || ^8.0"
+ },
+ "time": "2023-04-04T09:54:51+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "2.0.x-dev"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Psr\\Http\\Message\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "https://www.php-fig.org/"
+ }
+ ],
+ "description": "Common interface for HTTP messages",
+ "homepage": "https://github.com/php-fig/http-message",
+ "keywords": [
+ "http",
+ "http-message",
+ "psr",
+ "psr-7",
+ "request",
+ "response"
+ ],
+ "support": {
+ "source": "https://github.com/php-fig/http-message/tree/2.0"
+ },
+ "install-path": "../psr/http-message"
+ },
+ {
+ "name": "psr/simple-cache",
+ "version": "3.0.0",
+ "version_normalized": "3.0.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/php-fig/simple-cache.git",
+ "reference": "764e0b3939f5ca87cb904f570ef9be2d78a07865"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/php-fig/simple-cache/zipball/764e0b3939f5ca87cb904f570ef9be2d78a07865",
+ "reference": "764e0b3939f5ca87cb904f570ef9be2d78a07865",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=8.0.0"
+ },
+ "time": "2021-10-29T13:26:27+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "3.0.x-dev"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Psr\\SimpleCache\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "https://www.php-fig.org/"
+ }
+ ],
+ "description": "Common interfaces for simple caching",
+ "keywords": [
+ "cache",
+ "caching",
+ "psr",
+ "psr-16",
+ "simple-cache"
+ ],
+ "support": {
+ "source": "https://github.com/php-fig/simple-cache/tree/3.0.0"
+ },
+ "install-path": "../psr/simple-cache"
}
],
"dev": true,
diff --git a/api/vendor/composer/installed.php b/api/vendor/composer/installed.php
index 21e851b4..e456cf50 100644
--- a/api/vendor/composer/installed.php
+++ b/api/vendor/composer/installed.php
@@ -3,26 +3,107 @@
'name' => 'your-vendor/api',
'pretty_version' => 'dev-main',
'version' => 'dev-main',
- 'reference' => '254f026824de5b6ef6183b0885c1512d32a5d78c',
+ 'reference' => 'b9672a62283414a30f1bf111ed54759be7392347',
'type' => 'project',
'install_path' => __DIR__ . '/../../',
'aliases' => array(),
'dev' => true,
),
'versions' => array(
+ 'composer/pcre' => array(
+ 'pretty_version' => '3.3.2',
+ 'version' => '3.3.2.0',
+ 'reference' => 'b2bed4734f0cc156ee1fe9c0da2550420d99a21e',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/./pcre',
+ 'aliases' => array(),
+ 'dev_requirement' => false,
+ ),
+ 'maennchen/zipstream-php' => array(
+ 'pretty_version' => '3.1.2',
+ 'version' => '3.1.2.0',
+ 'reference' => 'aeadcf5c412332eb426c0f9b4485f6accba2a99f',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../maennchen/zipstream-php',
+ 'aliases' => array(),
+ 'dev_requirement' => false,
+ ),
+ 'markbaker/complex' => array(
+ 'pretty_version' => '3.0.2',
+ 'version' => '3.0.2.0',
+ 'reference' => '95c56caa1cf5c766ad6d65b6344b807c1e8405b9',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../markbaker/complex',
+ 'aliases' => array(),
+ 'dev_requirement' => false,
+ ),
+ 'markbaker/matrix' => array(
+ 'pretty_version' => '3.0.1',
+ 'version' => '3.0.1.0',
+ 'reference' => '728434227fe21be27ff6d86621a1b13107a2562c',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../markbaker/matrix',
+ 'aliases' => array(),
+ 'dev_requirement' => false,
+ ),
'phpmailer/phpmailer' => array(
- 'pretty_version' => 'v6.9.3',
- 'version' => '6.9.3.0',
- 'reference' => '2f5c94fe7493efc213f643c23b1b1c249d40f47e',
+ 'pretty_version' => 'v6.10.0',
+ 'version' => '6.10.0.0',
+ 'reference' => 'bf74d75a1fde6beaa34a0ddae2ec5fce0f72a144',
'type' => 'library',
'install_path' => __DIR__ . '/../phpmailer/phpmailer',
'aliases' => array(),
'dev_requirement' => false,
),
+ 'phpoffice/phpspreadsheet' => array(
+ 'pretty_version' => '2.3.8',
+ 'version' => '2.3.8.0',
+ 'reference' => '7a700683743bf1c4a21837c84b266916f1aa7d25',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../phpoffice/phpspreadsheet',
+ 'aliases' => array(),
+ 'dev_requirement' => false,
+ ),
+ 'psr/http-client' => array(
+ 'pretty_version' => '1.0.3',
+ 'version' => '1.0.3.0',
+ 'reference' => 'bb5906edc1c324c9a05aa0873d40117941e5fa90',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../psr/http-client',
+ 'aliases' => array(),
+ 'dev_requirement' => false,
+ ),
+ 'psr/http-factory' => array(
+ 'pretty_version' => '1.1.0',
+ 'version' => '1.1.0.0',
+ 'reference' => '2b4765fddfe3b508ac62f829e852b1501d3f6e8a',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../psr/http-factory',
+ 'aliases' => array(),
+ 'dev_requirement' => false,
+ ),
+ 'psr/http-message' => array(
+ 'pretty_version' => '2.0',
+ 'version' => '2.0.0.0',
+ 'reference' => '402d35bcb92c70c026d1a6a9883f06b2ead23d71',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../psr/http-message',
+ 'aliases' => array(),
+ 'dev_requirement' => false,
+ ),
+ 'psr/simple-cache' => array(
+ 'pretty_version' => '3.0.0',
+ 'version' => '3.0.0.0',
+ 'reference' => '764e0b3939f5ca87cb904f570ef9be2d78a07865',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../psr/simple-cache',
+ 'aliases' => array(),
+ 'dev_requirement' => false,
+ ),
'your-vendor/api' => array(
'pretty_version' => 'dev-main',
'version' => 'dev-main',
- 'reference' => '254f026824de5b6ef6183b0885c1512d32a5d78c',
+ 'reference' => 'b9672a62283414a30f1bf111ed54759be7392347',
'type' => 'project',
'install_path' => __DIR__ . '/../../',
'aliases' => array(),
diff --git a/api/vendor/composer/pcre/LICENSE b/api/vendor/composer/pcre/LICENSE
new file mode 100644
index 00000000..c5a282ff
--- /dev/null
+++ b/api/vendor/composer/pcre/LICENSE
@@ -0,0 +1,19 @@
+Copyright (C) 2021 Composer
+
+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.
diff --git a/api/vendor/composer/pcre/README.md b/api/vendor/composer/pcre/README.md
new file mode 100644
index 00000000..49065149
--- /dev/null
+++ b/api/vendor/composer/pcre/README.md
@@ -0,0 +1,189 @@
+composer/pcre
+=============
+
+PCRE wrapping library that offers type-safe `preg_*` replacements.
+
+This library gives you a way to ensure `preg_*` functions do not fail silently, returning
+unexpected `null`s that may not be handled.
+
+As of 3.0 this library enforces [`PREG_UNMATCHED_AS_NULL`](#preg_unmatched_as_null) usage
+for all matching and replaceCallback functions, [read more below](#preg_unmatched_as_null)
+to understand the implications.
+
+It thus makes it easier to work with static analysis tools like PHPStan or Psalm as it
+simplifies and reduces the possible return values from all the `preg_*` functions which
+are quite packed with edge cases. As of v2.2.0 / v3.2.0 the library also comes with a
+[PHPStan extension](#phpstan-extension) for parsing regular expressions and giving you even better output types.
+
+This library is a thin wrapper around `preg_*` functions with [some limitations](#restrictions--limitations).
+If you are looking for a richer API to handle regular expressions have a look at
+[rawr/t-regx](https://packagist.org/packages/rawr/t-regx) instead.
+
+[](https://github.com/composer/pcre/actions)
+
+
+Installation
+------------
+
+Install the latest version with:
+
+```bash
+$ composer require composer/pcre
+```
+
+
+Requirements
+------------
+
+* PHP 7.4.0 is required for 3.x versions
+* PHP 7.2.0 is required for 2.x versions
+* PHP 5.3.2 is required for 1.x versions
+
+
+Basic usage
+-----------
+
+Instead of:
+
+```php
+if (preg_match('{fo+}', $string, $matches)) { ... }
+if (preg_match('{fo+}', $string, $matches, PREG_OFFSET_CAPTURE)) { ... }
+if (preg_match_all('{fo+}', $string, $matches)) { ... }
+$newString = preg_replace('{fo+}', 'bar', $string);
+$newString = preg_replace_callback('{fo+}', function ($match) { return strtoupper($match[0]); }, $string);
+$newString = preg_replace_callback_array(['{fo+}' => fn ($match) => strtoupper($match[0])], $string);
+$filtered = preg_grep('{[a-z]}', $elements);
+$array = preg_split('{[a-z]+}', $string);
+```
+
+You can now call these on the `Preg` class:
+
+```php
+use Composer\Pcre\Preg;
+
+if (Preg::match('{fo+}', $string, $matches)) { ... }
+if (Preg::matchWithOffsets('{fo+}', $string, $matches)) { ... }
+if (Preg::matchAll('{fo+}', $string, $matches)) { ... }
+$newString = Preg::replace('{fo+}', 'bar', $string);
+$newString = Preg::replaceCallback('{fo+}', function ($match) { return strtoupper($match[0]); }, $string);
+$newString = Preg::replaceCallbackArray(['{fo+}' => fn ($match) => strtoupper($match[0])], $string);
+$filtered = Preg::grep('{[a-z]}', $elements);
+$array = Preg::split('{[a-z]+}', $string);
+```
+
+The main difference is if anything fails to match/replace/.., it will throw a `Composer\Pcre\PcreException`
+instead of returning `null` (or false in some cases), so you can now use the return values safely relying on
+the fact that they can only be strings (for replace), ints (for match) or arrays (for grep/split).
+
+Additionally the `Preg` class provides match methods that return `bool` rather than `int`, for stricter type safety
+when the number of pattern matches is not useful:
+
+```php
+use Composer\Pcre\Preg;
+
+if (Preg::isMatch('{fo+}', $string, $matches)) // bool
+if (Preg::isMatchAll('{fo+}', $string, $matches)) // bool
+```
+
+Finally the `Preg` class provides a few `*StrictGroups` method variants that ensure match groups
+are always present and thus non-nullable, making it easier to write type-safe code:
+
+```php
+use Composer\Pcre\Preg;
+
+// $matches is guaranteed to be an array of strings, if a subpattern does not match and produces a null it will throw
+if (Preg::matchStrictGroups('{fo+}', $string, $matches))
+if (Preg::matchAllStrictGroups('{fo+}', $string, $matches))
+```
+
+**Note:** This is generally safe to use as long as you do not have optional subpatterns (i.e. `(something)?`
+or `(something)*` or branches with a `|` that result in some groups not being matched at all).
+A subpattern that can match an empty string like `(.*)` is **not** optional, it will be present as an
+empty string in the matches. A non-matching subpattern, even if optional like `(?:foo)?` will anyway not be present in
+matches so it is also not a problem to use these with `*StrictGroups` methods.
+
+If you would prefer a slightly more verbose usage, replacing by-ref arguments by result objects, you can use the `Regex` class:
+
+```php
+use Composer\Pcre\Regex;
+
+// this is useful when you are just interested in knowing if something matched
+// as it returns a bool instead of int(1/0) for match
+$bool = Regex::isMatch('{fo+}', $string);
+
+$result = Regex::match('{fo+}', $string);
+if ($result->matched) { something($result->matches); }
+
+$result = Regex::matchWithOffsets('{fo+}', $string);
+if ($result->matched) { something($result->matches); }
+
+$result = Regex::matchAll('{fo+}', $string);
+if ($result->matched && $result->count > 3) { something($result->matches); }
+
+$newString = Regex::replace('{fo+}', 'bar', $string)->result;
+$newString = Regex::replaceCallback('{fo+}', function ($match) { return strtoupper($match[0]); }, $string)->result;
+$newString = Regex::replaceCallbackArray(['{fo+}' => fn ($match) => strtoupper($match[0])], $string)->result;
+```
+
+Note that `preg_grep` and `preg_split` are only callable via the `Preg` class as they do not have
+complex return types warranting a specific result object.
+
+See the [MatchResult](src/MatchResult.php), [MatchWithOffsetsResult](src/MatchWithOffsetsResult.php), [MatchAllResult](src/MatchAllResult.php),
+[MatchAllWithOffsetsResult](src/MatchAllWithOffsetsResult.php), and [ReplaceResult](src/ReplaceResult.php) class sources for more details.
+
+Restrictions / Limitations
+--------------------------
+
+Due to type safety requirements a few restrictions are in place.
+
+- matching using `PREG_OFFSET_CAPTURE` is made available via `matchWithOffsets` and `matchAllWithOffsets`.
+ You cannot pass the flag to `match`/`matchAll`.
+- `Preg::split` will also reject `PREG_SPLIT_OFFSET_CAPTURE` and you should use `splitWithOffsets`
+ instead.
+- `matchAll` rejects `PREG_SET_ORDER` as it also changes the shape of the returned matches. There
+ is no alternative provided as you can fairly easily code around it.
+- `preg_filter` is not supported as it has a rather crazy API, most likely you should rather
+ use `Preg::grep` in combination with some loop and `Preg::replace`.
+- `replace`, `replaceCallback` and `replaceCallbackArray` do not support an array `$subject`,
+ only simple strings.
+- As of 2.0, the library always uses `PREG_UNMATCHED_AS_NULL` for matching, which offers [much
+ saner/more predictable results](#preg_unmatched_as_null). As of 3.0 the flag is also set for
+ `replaceCallback` and `replaceCallbackArray`.
+
+#### PREG_UNMATCHED_AS_NULL
+
+As of 2.0, this library always uses PREG_UNMATCHED_AS_NULL for all `match*` and `isMatch*`
+functions. As of 3.0 it is also done for `replaceCallback` and `replaceCallbackArray`.
+
+This means your matches will always contain all matching groups, either as null if unmatched
+or as string if it matched.
+
+The advantages in clarity and predictability are clearer if you compare the two outputs of
+running this with and without PREG_UNMATCHED_AS_NULL in $flags:
+
+```php
+preg_match('/(a)(b)*(c)(d)*/', 'ac', $matches, $flags);
+```
+
+| no flag | PREG_UNMATCHED_AS_NULL |
+| --- | --- |
+| array (size=4) | array (size=5) |
+| 0 => string 'ac' (length=2) | 0 => string 'ac' (length=2) |
+| 1 => string 'a' (length=1) | 1 => string 'a' (length=1) |
+| 2 => string '' (length=0) | 2 => null |
+| 3 => string 'c' (length=1) | 3 => string 'c' (length=1) |
+| | 4 => null |
+| group 2 (any unmatched group preceding one that matched) is set to `''`. You cannot tell if it matched an empty string or did not match at all | group 2 is `null` when unmatched and a string if it matched, easy to check for |
+| group 4 (any optional group without a matching one following) is missing altogether. So you have to check with `isset()`, but really you want `isset($m[4]) && $m[4] !== ''` for safety unless you are very careful to check that a non-optional group follows it | group 4 is always set, and null in this case as there was no match, easy to check for with `$m[4] !== null` |
+
+PHPStan Extension
+-----------------
+
+To use the PHPStan extension if you do not use `phpstan/extension-installer` you can include `vendor/composer/pcre/extension.neon` in your PHPStan config.
+
+The extension provides much better type information for $matches as well as regex validation where possible.
+
+License
+-------
+
+composer/pcre is licensed under the MIT License, see the LICENSE file for details.
diff --git a/api/vendor/composer/pcre/composer.json b/api/vendor/composer/pcre/composer.json
new file mode 100644
index 00000000..d3a7e67c
--- /dev/null
+++ b/api/vendor/composer/pcre/composer.json
@@ -0,0 +1,54 @@
+{
+ "name": "composer/pcre",
+ "description": "PCRE wrapping library that offers type-safe preg_* replacements.",
+ "type": "library",
+ "license": "MIT",
+ "keywords": [
+ "pcre",
+ "regex",
+ "preg",
+ "regular expression"
+ ],
+ "authors": [
+ {
+ "name": "Jordi Boggiano",
+ "email": "j.boggiano@seld.be",
+ "homepage": "http://seld.be"
+ }
+ ],
+ "require": {
+ "php": "^7.4 || ^8.0"
+ },
+ "require-dev": {
+ "phpunit/phpunit": "^8 || ^9",
+ "phpstan/phpstan": "^1.12 || ^2",
+ "phpstan/phpstan-strict-rules": "^1 || ^2"
+ },
+ "conflict": {
+ "phpstan/phpstan": "<1.11.10"
+ },
+ "autoload": {
+ "psr-4": {
+ "Composer\\Pcre\\": "src"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "Composer\\Pcre\\": "tests"
+ }
+ },
+ "extra": {
+ "branch-alias": {
+ "dev-main": "3.x-dev"
+ },
+ "phpstan": {
+ "includes": [
+ "extension.neon"
+ ]
+ }
+ },
+ "scripts": {
+ "test": "@php vendor/bin/phpunit",
+ "phpstan": "@php phpstan analyse"
+ }
+}
diff --git a/api/vendor/composer/pcre/extension.neon b/api/vendor/composer/pcre/extension.neon
new file mode 100644
index 00000000..b9cea113
--- /dev/null
+++ b/api/vendor/composer/pcre/extension.neon
@@ -0,0 +1,22 @@
+# composer/pcre PHPStan extensions
+#
+# These can be reused by third party packages by including 'vendor/composer/pcre/extension.neon'
+# in your phpstan config
+
+services:
+ -
+ class: Composer\Pcre\PHPStan\PregMatchParameterOutTypeExtension
+ tags:
+ - phpstan.staticMethodParameterOutTypeExtension
+ -
+ class: Composer\Pcre\PHPStan\PregMatchTypeSpecifyingExtension
+ tags:
+ - phpstan.typeSpecifier.staticMethodTypeSpecifyingExtension
+ -
+ class: Composer\Pcre\PHPStan\PregReplaceCallbackClosureTypeExtension
+ tags:
+ - phpstan.staticMethodParameterClosureTypeExtension
+
+rules:
+ - Composer\Pcre\PHPStan\UnsafeStrictGroupsCallRule
+ - Composer\Pcre\PHPStan\InvalidRegexPatternRule
diff --git a/api/vendor/composer/pcre/src/MatchAllResult.php b/api/vendor/composer/pcre/src/MatchAllResult.php
new file mode 100644
index 00000000..b22b52d6
--- /dev/null
+++ b/api/vendor/composer/pcre/src/MatchAllResult.php
@@ -0,0 +1,46 @@
+
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Composer\Pcre;
+
+final class MatchAllResult
+{
+ /**
+ * An array of match group => list of matched strings
+ *
+ * @readonly
+ * @var array>
+ */
+ public $matches;
+
+ /**
+ * @readonly
+ * @var 0|positive-int
+ */
+ public $count;
+
+ /**
+ * @readonly
+ * @var bool
+ */
+ public $matched;
+
+ /**
+ * @param 0|positive-int $count
+ * @param array> $matches
+ */
+ public function __construct(int $count, array $matches)
+ {
+ $this->matches = $matches;
+ $this->matched = (bool) $count;
+ $this->count = $count;
+ }
+}
diff --git a/api/vendor/composer/pcre/src/MatchAllStrictGroupsResult.php b/api/vendor/composer/pcre/src/MatchAllStrictGroupsResult.php
new file mode 100644
index 00000000..b7ec3974
--- /dev/null
+++ b/api/vendor/composer/pcre/src/MatchAllStrictGroupsResult.php
@@ -0,0 +1,46 @@
+
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Composer\Pcre;
+
+final class MatchAllStrictGroupsResult
+{
+ /**
+ * An array of match group => list of matched strings
+ *
+ * @readonly
+ * @var array>
+ */
+ public $matches;
+
+ /**
+ * @readonly
+ * @var 0|positive-int
+ */
+ public $count;
+
+ /**
+ * @readonly
+ * @var bool
+ */
+ public $matched;
+
+ /**
+ * @param 0|positive-int $count
+ * @param array> $matches
+ */
+ public function __construct(int $count, array $matches)
+ {
+ $this->matches = $matches;
+ $this->matched = (bool) $count;
+ $this->count = $count;
+ }
+}
diff --git a/api/vendor/composer/pcre/src/MatchAllWithOffsetsResult.php b/api/vendor/composer/pcre/src/MatchAllWithOffsetsResult.php
new file mode 100644
index 00000000..032a02cd
--- /dev/null
+++ b/api/vendor/composer/pcre/src/MatchAllWithOffsetsResult.php
@@ -0,0 +1,48 @@
+
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Composer\Pcre;
+
+final class MatchAllWithOffsetsResult
+{
+ /**
+ * An array of match group => list of matches, every match being a pair of string matched + offset in bytes (or -1 if no match)
+ *
+ * @readonly
+ * @var array>
+ * @phpstan-var array}>>
+ */
+ public $matches;
+
+ /**
+ * @readonly
+ * @var 0|positive-int
+ */
+ public $count;
+
+ /**
+ * @readonly
+ * @var bool
+ */
+ public $matched;
+
+ /**
+ * @param 0|positive-int $count
+ * @param array> $matches
+ * @phpstan-param array}>> $matches
+ */
+ public function __construct(int $count, array $matches)
+ {
+ $this->matches = $matches;
+ $this->matched = (bool) $count;
+ $this->count = $count;
+ }
+}
diff --git a/api/vendor/composer/pcre/src/MatchResult.php b/api/vendor/composer/pcre/src/MatchResult.php
new file mode 100644
index 00000000..e951a5ee
--- /dev/null
+++ b/api/vendor/composer/pcre/src/MatchResult.php
@@ -0,0 +1,39 @@
+
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Composer\Pcre;
+
+final class MatchResult
+{
+ /**
+ * An array of match group => string matched
+ *
+ * @readonly
+ * @var array
+ */
+ public $matches;
+
+ /**
+ * @readonly
+ * @var bool
+ */
+ public $matched;
+
+ /**
+ * @param 0|positive-int $count
+ * @param array $matches
+ */
+ public function __construct(int $count, array $matches)
+ {
+ $this->matches = $matches;
+ $this->matched = (bool) $count;
+ }
+}
diff --git a/api/vendor/composer/pcre/src/MatchStrictGroupsResult.php b/api/vendor/composer/pcre/src/MatchStrictGroupsResult.php
new file mode 100644
index 00000000..126ee629
--- /dev/null
+++ b/api/vendor/composer/pcre/src/MatchStrictGroupsResult.php
@@ -0,0 +1,39 @@
+
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Composer\Pcre;
+
+final class MatchStrictGroupsResult
+{
+ /**
+ * An array of match group => string matched
+ *
+ * @readonly
+ * @var array
+ */
+ public $matches;
+
+ /**
+ * @readonly
+ * @var bool
+ */
+ public $matched;
+
+ /**
+ * @param 0|positive-int $count
+ * @param array $matches
+ */
+ public function __construct(int $count, array $matches)
+ {
+ $this->matches = $matches;
+ $this->matched = (bool) $count;
+ }
+}
diff --git a/api/vendor/composer/pcre/src/MatchWithOffsetsResult.php b/api/vendor/composer/pcre/src/MatchWithOffsetsResult.php
new file mode 100644
index 00000000..ba4d4bc4
--- /dev/null
+++ b/api/vendor/composer/pcre/src/MatchWithOffsetsResult.php
@@ -0,0 +1,41 @@
+
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Composer\Pcre;
+
+final class MatchWithOffsetsResult
+{
+ /**
+ * An array of match group => pair of string matched + offset in bytes (or -1 if no match)
+ *
+ * @readonly
+ * @var array
+ * @phpstan-var array}>
+ */
+ public $matches;
+
+ /**
+ * @readonly
+ * @var bool
+ */
+ public $matched;
+
+ /**
+ * @param 0|positive-int $count
+ * @param array $matches
+ * @phpstan-param array}> $matches
+ */
+ public function __construct(int $count, array $matches)
+ {
+ $this->matches = $matches;
+ $this->matched = (bool) $count;
+ }
+}
diff --git a/api/vendor/composer/pcre/src/PHPStan/InvalidRegexPatternRule.php b/api/vendor/composer/pcre/src/PHPStan/InvalidRegexPatternRule.php
new file mode 100644
index 00000000..8a05fb24
--- /dev/null
+++ b/api/vendor/composer/pcre/src/PHPStan/InvalidRegexPatternRule.php
@@ -0,0 +1,142 @@
+
+ */
+class InvalidRegexPatternRule implements Rule
+{
+ public function getNodeType(): string
+ {
+ return StaticCall::class;
+ }
+
+ public function processNode(Node $node, Scope $scope): array
+ {
+ $patterns = $this->extractPatterns($node, $scope);
+
+ $errors = [];
+ foreach ($patterns as $pattern) {
+ $errorMessage = $this->validatePattern($pattern);
+ if ($errorMessage === null) {
+ continue;
+ }
+
+ $errors[] = RuleErrorBuilder::message(sprintf('Regex pattern is invalid: %s', $errorMessage))->identifier('regexp.pattern')->build();
+ }
+
+ return $errors;
+ }
+
+ /**
+ * @return string[]
+ */
+ private function extractPatterns(StaticCall $node, Scope $scope): array
+ {
+ if (!$node->class instanceof FullyQualified) {
+ return [];
+ }
+ $isRegex = $node->class->toString() === Regex::class;
+ $isPreg = $node->class->toString() === Preg::class;
+ if (!$isRegex && !$isPreg) {
+ return [];
+ }
+ if (!$node->name instanceof Node\Identifier || !Preg::isMatch('{^(match|isMatch|grep|replace|split)}', $node->name->name)) {
+ return [];
+ }
+
+ $functionName = $node->name->name;
+ if (!isset($node->getArgs()[0])) {
+ return [];
+ }
+
+ $patternNode = $node->getArgs()[0]->value;
+ $patternType = $scope->getType($patternNode);
+
+ $patternStrings = [];
+
+ foreach ($patternType->getConstantStrings() as $constantStringType) {
+ if ($functionName === 'replaceCallbackArray') {
+ continue;
+ }
+
+ $patternStrings[] = $constantStringType->getValue();
+ }
+
+ foreach ($patternType->getConstantArrays() as $constantArrayType) {
+ if (
+ in_array($functionName, [
+ 'replace',
+ 'replaceCallback',
+ ], true)
+ ) {
+ foreach ($constantArrayType->getValueTypes() as $arrayKeyType) {
+ foreach ($arrayKeyType->getConstantStrings() as $constantString) {
+ $patternStrings[] = $constantString->getValue();
+ }
+ }
+ }
+
+ if ($functionName !== 'replaceCallbackArray') {
+ continue;
+ }
+
+ foreach ($constantArrayType->getKeyTypes() as $arrayKeyType) {
+ foreach ($arrayKeyType->getConstantStrings() as $constantString) {
+ $patternStrings[] = $constantString->getValue();
+ }
+ }
+ }
+
+ return $patternStrings;
+ }
+
+ private function validatePattern(string $pattern): ?string
+ {
+ try {
+ $msg = null;
+ $prev = set_error_handler(function (int $severity, string $message, string $file) use (&$msg): bool {
+ $msg = preg_replace("#^preg_match(_all)?\\(.*?\\): #", '', $message);
+
+ return true;
+ });
+
+ if ($pattern === '') {
+ return 'Empty string is not a valid regular expression';
+ }
+
+ Preg::match($pattern, '');
+ if ($msg !== null) {
+ return $msg;
+ }
+ } catch (PcreException $e) {
+ if ($e->getCode() === PREG_INTERNAL_ERROR && $msg !== null) {
+ return $msg;
+ }
+
+ return preg_replace('{.*? failed executing ".*": }', '', $e->getMessage());
+ } finally {
+ restore_error_handler();
+ }
+
+ return null;
+ }
+
+}
diff --git a/api/vendor/composer/pcre/src/PHPStan/PregMatchFlags.php b/api/vendor/composer/pcre/src/PHPStan/PregMatchFlags.php
new file mode 100644
index 00000000..aa30ab34
--- /dev/null
+++ b/api/vendor/composer/pcre/src/PHPStan/PregMatchFlags.php
@@ -0,0 +1,70 @@
+getType($flagsArg->value);
+
+ $constantScalars = $flagsType->getConstantScalarValues();
+ if ($constantScalars === []) {
+ return null;
+ }
+
+ $internalFlagsTypes = [];
+ foreach ($flagsType->getConstantScalarValues() as $constantScalarValue) {
+ if (!is_int($constantScalarValue)) {
+ return null;
+ }
+
+ $internalFlagsTypes[] = new ConstantIntegerType($constantScalarValue | PREG_UNMATCHED_AS_NULL);
+ }
+ return TypeCombinator::union(...$internalFlagsTypes);
+ }
+
+ static public function removeNullFromMatches(Type $matchesType): Type
+ {
+ return TypeTraverser::map($matchesType, static function (Type $type, callable $traverse): Type {
+ if ($type instanceof UnionType || $type instanceof IntersectionType) {
+ return $traverse($type);
+ }
+
+ if ($type instanceof ConstantArrayType) {
+ return new ConstantArrayType(
+ $type->getKeyTypes(),
+ array_map(static function (Type $valueType) use ($traverse): Type {
+ return $traverse($valueType);
+ }, $type->getValueTypes()),
+ $type->getNextAutoIndexes(),
+ [],
+ $type->isList()
+ );
+ }
+
+ if ($type instanceof ArrayType) {
+ return new ArrayType($type->getKeyType(), $traverse($type->getItemType()));
+ }
+
+ return TypeCombinator::removeNull($type);
+ });
+ }
+
+}
diff --git a/api/vendor/composer/pcre/src/PHPStan/PregMatchParameterOutTypeExtension.php b/api/vendor/composer/pcre/src/PHPStan/PregMatchParameterOutTypeExtension.php
new file mode 100644
index 00000000..e0d60208
--- /dev/null
+++ b/api/vendor/composer/pcre/src/PHPStan/PregMatchParameterOutTypeExtension.php
@@ -0,0 +1,65 @@
+regexShapeMatcher = $regexShapeMatcher;
+ }
+
+ public function isStaticMethodSupported(MethodReflection $methodReflection, ParameterReflection $parameter): bool
+ {
+ return
+ $methodReflection->getDeclaringClass()->getName() === Preg::class
+ && in_array($methodReflection->getName(), [
+ 'match', 'isMatch', 'matchStrictGroups', 'isMatchStrictGroups',
+ 'matchAll', 'isMatchAll', 'matchAllStrictGroups', 'isMatchAllStrictGroups'
+ ], true)
+ && $parameter->getName() === 'matches';
+ }
+
+ public function getParameterOutTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, ParameterReflection $parameter, Scope $scope): ?Type
+ {
+ $args = $methodCall->getArgs();
+ $patternArg = $args[0] ?? null;
+ $matchesArg = $args[2] ?? null;
+ $flagsArg = $args[3] ?? null;
+
+ if (
+ $patternArg === null || $matchesArg === null
+ ) {
+ return null;
+ }
+
+ $flagsType = PregMatchFlags::getType($flagsArg, $scope);
+ if ($flagsType === null) {
+ return null;
+ }
+
+ if (stripos($methodReflection->getName(), 'matchAll') !== false) {
+ return $this->regexShapeMatcher->matchAllExpr($patternArg->value, $flagsType, TrinaryLogic::createMaybe(), $scope);
+ }
+
+ return $this->regexShapeMatcher->matchExpr($patternArg->value, $flagsType, TrinaryLogic::createMaybe(), $scope);
+ }
+
+}
diff --git a/api/vendor/composer/pcre/src/PHPStan/PregMatchTypeSpecifyingExtension.php b/api/vendor/composer/pcre/src/PHPStan/PregMatchTypeSpecifyingExtension.php
new file mode 100644
index 00000000..3db0ce06
--- /dev/null
+++ b/api/vendor/composer/pcre/src/PHPStan/PregMatchTypeSpecifyingExtension.php
@@ -0,0 +1,119 @@
+regexShapeMatcher = $regexShapeMatcher;
+ }
+
+ public function setTypeSpecifier(TypeSpecifier $typeSpecifier): void
+ {
+ $this->typeSpecifier = $typeSpecifier;
+ }
+
+ public function getClass(): string
+ {
+ return Preg::class;
+ }
+
+ public function isStaticMethodSupported(MethodReflection $methodReflection, StaticCall $node, TypeSpecifierContext $context): bool
+ {
+ return in_array($methodReflection->getName(), [
+ 'match', 'isMatch', 'matchStrictGroups', 'isMatchStrictGroups',
+ 'matchAll', 'isMatchAll', 'matchAllStrictGroups', 'isMatchAllStrictGroups'
+ ], true)
+ && !$context->null();
+ }
+
+ public function specifyTypes(MethodReflection $methodReflection, StaticCall $node, Scope $scope, TypeSpecifierContext $context): SpecifiedTypes
+ {
+ $args = $node->getArgs();
+ $patternArg = $args[0] ?? null;
+ $matchesArg = $args[2] ?? null;
+ $flagsArg = $args[3] ?? null;
+
+ if (
+ $patternArg === null || $matchesArg === null
+ ) {
+ return new SpecifiedTypes();
+ }
+
+ $flagsType = PregMatchFlags::getType($flagsArg, $scope);
+ if ($flagsType === null) {
+ return new SpecifiedTypes();
+ }
+
+ if (stripos($methodReflection->getName(), 'matchAll') !== false) {
+ $matchedType = $this->regexShapeMatcher->matchAllExpr($patternArg->value, $flagsType, TrinaryLogic::createFromBoolean($context->true()), $scope);
+ } else {
+ $matchedType = $this->regexShapeMatcher->matchExpr($patternArg->value, $flagsType, TrinaryLogic::createFromBoolean($context->true()), $scope);
+ }
+
+ if ($matchedType === null) {
+ return new SpecifiedTypes();
+ }
+
+ if (
+ in_array($methodReflection->getName(), ['matchStrictGroups', 'isMatchStrictGroups', 'matchAllStrictGroups', 'isMatchAllStrictGroups'], true)
+ ) {
+ $matchedType = PregMatchFlags::removeNullFromMatches($matchedType);
+ }
+
+ $overwrite = false;
+ if ($context->false()) {
+ $overwrite = true;
+ $context = $context->negate();
+ }
+
+ // @phpstan-ignore function.alreadyNarrowedType
+ if (method_exists('PHPStan\Analyser\SpecifiedTypes', 'setRootExpr')) {
+ $typeSpecifier = $this->typeSpecifier->create(
+ $matchesArg->value,
+ $matchedType,
+ $context,
+ $scope
+ )->setRootExpr($node);
+
+ return $overwrite ? $typeSpecifier->setAlwaysOverwriteTypes() : $typeSpecifier;
+ }
+
+ // @phpstan-ignore arguments.count
+ return $this->typeSpecifier->create(
+ $matchesArg->value,
+ $matchedType,
+ $context,
+ // @phpstan-ignore argument.type
+ $overwrite,
+ $scope,
+ $node
+ );
+ }
+}
diff --git a/api/vendor/composer/pcre/src/PHPStan/PregReplaceCallbackClosureTypeExtension.php b/api/vendor/composer/pcre/src/PHPStan/PregReplaceCallbackClosureTypeExtension.php
new file mode 100644
index 00000000..7b953672
--- /dev/null
+++ b/api/vendor/composer/pcre/src/PHPStan/PregReplaceCallbackClosureTypeExtension.php
@@ -0,0 +1,91 @@
+regexShapeMatcher = $regexShapeMatcher;
+ }
+
+ public function isStaticMethodSupported(MethodReflection $methodReflection, ParameterReflection $parameter): bool
+ {
+ return in_array($methodReflection->getDeclaringClass()->getName(), [Preg::class, Regex::class], true)
+ && in_array($methodReflection->getName(), ['replaceCallback', 'replaceCallbackStrictGroups'], true)
+ && $parameter->getName() === 'replacement';
+ }
+
+ public function getTypeFromStaticMethodCall(MethodReflection $methodReflection, StaticCall $methodCall, ParameterReflection $parameter, Scope $scope): ?Type
+ {
+ $args = $methodCall->getArgs();
+ $patternArg = $args[0] ?? null;
+ $flagsArg = $args[5] ?? null;
+
+ if (
+ $patternArg === null
+ ) {
+ return null;
+ }
+
+ $flagsType = PregMatchFlags::getType($flagsArg, $scope);
+
+ $matchesType = $this->regexShapeMatcher->matchExpr($patternArg->value, $flagsType, TrinaryLogic::createYes(), $scope);
+ if ($matchesType === null) {
+ return null;
+ }
+
+ if ($methodReflection->getName() === 'replaceCallbackStrictGroups' && count($matchesType->getConstantArrays()) === 1) {
+ $matchesType = $matchesType->getConstantArrays()[0];
+ $matchesType = new ConstantArrayType(
+ $matchesType->getKeyTypes(),
+ array_map(static function (Type $valueType): Type {
+ if (count($valueType->getConstantArrays()) === 1) {
+ $valueTypeArray = $valueType->getConstantArrays()[0];
+ return new ConstantArrayType(
+ $valueTypeArray->getKeyTypes(),
+ array_map(static function (Type $valueType): Type {
+ return TypeCombinator::removeNull($valueType);
+ }, $valueTypeArray->getValueTypes()),
+ $valueTypeArray->getNextAutoIndexes(),
+ [],
+ $valueTypeArray->isList()
+ );
+ }
+ return TypeCombinator::removeNull($valueType);
+ }, $matchesType->getValueTypes()),
+ $matchesType->getNextAutoIndexes(),
+ [],
+ $matchesType->isList()
+ );
+ }
+
+ return new ClosureType(
+ [
+ new NativeParameterReflection($parameter->getName(), $parameter->isOptional(), $matchesType, $parameter->passedByReference(), $parameter->isVariadic(), $parameter->getDefaultValue()),
+ ],
+ new StringType()
+ );
+ }
+}
diff --git a/api/vendor/composer/pcre/src/PHPStan/UnsafeStrictGroupsCallRule.php b/api/vendor/composer/pcre/src/PHPStan/UnsafeStrictGroupsCallRule.php
new file mode 100644
index 00000000..5bced507
--- /dev/null
+++ b/api/vendor/composer/pcre/src/PHPStan/UnsafeStrictGroupsCallRule.php
@@ -0,0 +1,112 @@
+
+ */
+final class UnsafeStrictGroupsCallRule implements Rule
+{
+ /**
+ * @var RegexArrayShapeMatcher
+ */
+ private $regexShapeMatcher;
+
+ public function __construct(RegexArrayShapeMatcher $regexShapeMatcher)
+ {
+ $this->regexShapeMatcher = $regexShapeMatcher;
+ }
+
+ public function getNodeType(): string
+ {
+ return StaticCall::class;
+ }
+
+ public function processNode(Node $node, Scope $scope): array
+ {
+ if (!$node->class instanceof FullyQualified) {
+ return [];
+ }
+ $isRegex = $node->class->toString() === Regex::class;
+ $isPreg = $node->class->toString() === Preg::class;
+ if (!$isRegex && !$isPreg) {
+ return [];
+ }
+ if (!$node->name instanceof Node\Identifier || !in_array($node->name->name, ['matchStrictGroups', 'isMatchStrictGroups', 'matchAllStrictGroups', 'isMatchAllStrictGroups'], true)) {
+ return [];
+ }
+
+ $args = $node->getArgs();
+ if (!isset($args[0])) {
+ return [];
+ }
+
+ $patternArg = $args[0] ?? null;
+ if ($isPreg) {
+ if (!isset($args[2])) { // no matches set, skip as the matches won't be used anyway
+ return [];
+ }
+ $flagsArg = $args[3] ?? null;
+ } else {
+ $flagsArg = $args[2] ?? null;
+ }
+
+ if ($patternArg === null) {
+ return [];
+ }
+
+ $flagsType = PregMatchFlags::getType($flagsArg, $scope);
+ if ($flagsType === null) {
+ return [];
+ }
+
+ $matchedType = $this->regexShapeMatcher->matchExpr($patternArg->value, $flagsType, TrinaryLogic::createYes(), $scope);
+ if ($matchedType === null) {
+ return [
+ RuleErrorBuilder::message(sprintf('The %s call is potentially unsafe as $matches\' type could not be inferred.', $node->name->name))
+ ->identifier('composerPcre.maybeUnsafeStrictGroups')
+ ->build(),
+ ];
+ }
+
+ if (count($matchedType->getConstantArrays()) === 1) {
+ $matchedType = $matchedType->getConstantArrays()[0];
+ $nullableGroups = [];
+ foreach ($matchedType->getValueTypes() as $index => $type) {
+ if (TypeCombinator::containsNull($type)) {
+ $nullableGroups[] = $matchedType->getKeyTypes()[$index]->getValue();
+ }
+ }
+
+ if (\count($nullableGroups) > 0) {
+ return [
+ RuleErrorBuilder::message(sprintf(
+ 'The %s call is unsafe as match group%s "%s" %s optional and may be null.',
+ $node->name->name,
+ \count($nullableGroups) > 1 ? 's' : '',
+ implode('", "', $nullableGroups),
+ \count($nullableGroups) > 1 ? 'are' : 'is'
+ ))->identifier('composerPcre.unsafeStrictGroups')->build(),
+ ];
+ }
+ }
+
+ return [];
+ }
+}
diff --git a/api/vendor/composer/pcre/src/PcreException.php b/api/vendor/composer/pcre/src/PcreException.php
new file mode 100644
index 00000000..23d93279
--- /dev/null
+++ b/api/vendor/composer/pcre/src/PcreException.php
@@ -0,0 +1,55 @@
+
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Composer\Pcre;
+
+class PcreException extends \RuntimeException
+{
+ /**
+ * @param string $function
+ * @param string|string[] $pattern
+ * @return self
+ */
+ public static function fromFunction($function, $pattern)
+ {
+ $code = preg_last_error();
+
+ if (is_array($pattern)) {
+ $pattern = implode(', ', $pattern);
+ }
+
+ return new PcreException($function.'(): failed executing "'.$pattern.'": '.self::pcreLastErrorMessage($code), $code);
+ }
+
+ /**
+ * @param int $code
+ * @return string
+ */
+ private static function pcreLastErrorMessage($code)
+ {
+ if (function_exists('preg_last_error_msg')) {
+ return preg_last_error_msg();
+ }
+
+ $constants = get_defined_constants(true);
+ if (!isset($constants['pcre']) || !is_array($constants['pcre'])) {
+ return 'UNDEFINED_ERROR';
+ }
+
+ foreach ($constants['pcre'] as $const => $val) {
+ if ($val === $code && substr($const, -6) === '_ERROR') {
+ return $const;
+ }
+ }
+
+ return 'UNDEFINED_ERROR';
+ }
+}
diff --git a/api/vendor/composer/pcre/src/Preg.php b/api/vendor/composer/pcre/src/Preg.php
new file mode 100644
index 00000000..400abbfe
--- /dev/null
+++ b/api/vendor/composer/pcre/src/Preg.php
@@ -0,0 +1,430 @@
+
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Composer\Pcre;
+
+class Preg
+{
+ /** @internal */
+ public const ARRAY_MSG = '$subject as an array is not supported. You can use \'foreach\' instead.';
+ /** @internal */
+ public const INVALID_TYPE_MSG = '$subject must be a string, %s given.';
+
+ /**
+ * @param non-empty-string $pattern
+ * @param array $matches Set by method
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ * @return 0|1
+ *
+ * @param-out array $matches
+ */
+ public static function match(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): int
+ {
+ self::checkOffsetCapture($flags, 'matchWithOffsets');
+
+ $result = preg_match($pattern, $subject, $matches, $flags | PREG_UNMATCHED_AS_NULL, $offset);
+ if ($result === false) {
+ throw PcreException::fromFunction('preg_match', $pattern);
+ }
+
+ return $result;
+ }
+
+ /**
+ * Variant of `match()` which outputs non-null matches (or throws)
+ *
+ * @param non-empty-string $pattern
+ * @param array $matches Set by method
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ * @return 0|1
+ * @throws UnexpectedNullMatchException
+ *
+ * @param-out array $matches
+ */
+ public static function matchStrictGroups(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): int
+ {
+ $result = self::match($pattern, $subject, $matchesInternal, $flags, $offset);
+ $matches = self::enforceNonNullMatches($pattern, $matchesInternal, 'match');
+
+ return $result;
+ }
+
+ /**
+ * Runs preg_match with PREG_OFFSET_CAPTURE
+ *
+ * @param non-empty-string $pattern
+ * @param array $matches Set by method
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL and PREG_OFFSET_CAPTURE are always set, no other flags are supported
+ * @return 0|1
+ *
+ * @param-out array}> $matches
+ */
+ public static function matchWithOffsets(string $pattern, string $subject, ?array &$matches, int $flags = 0, int $offset = 0): int
+ {
+ $result = preg_match($pattern, $subject, $matches, $flags | PREG_UNMATCHED_AS_NULL | PREG_OFFSET_CAPTURE, $offset);
+ if ($result === false) {
+ throw PcreException::fromFunction('preg_match', $pattern);
+ }
+
+ return $result;
+ }
+
+ /**
+ * @param non-empty-string $pattern
+ * @param array $matches Set by method
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ * @return 0|positive-int
+ *
+ * @param-out array> $matches
+ */
+ public static function matchAll(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): int
+ {
+ self::checkOffsetCapture($flags, 'matchAllWithOffsets');
+ self::checkSetOrder($flags);
+
+ $result = preg_match_all($pattern, $subject, $matches, $flags | PREG_UNMATCHED_AS_NULL, $offset);
+ if (!is_int($result)) { // PHP < 8 may return null, 8+ returns int|false
+ throw PcreException::fromFunction('preg_match_all', $pattern);
+ }
+
+ return $result;
+ }
+
+ /**
+ * Variant of `match()` which outputs non-null matches (or throws)
+ *
+ * @param non-empty-string $pattern
+ * @param array $matches Set by method
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ * @return 0|positive-int
+ * @throws UnexpectedNullMatchException
+ *
+ * @param-out array> $matches
+ */
+ public static function matchAllStrictGroups(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): int
+ {
+ $result = self::matchAll($pattern, $subject, $matchesInternal, $flags, $offset);
+ $matches = self::enforceNonNullMatchAll($pattern, $matchesInternal, 'matchAll');
+
+ return $result;
+ }
+
+ /**
+ * Runs preg_match_all with PREG_OFFSET_CAPTURE
+ *
+ * @param non-empty-string $pattern
+ * @param array $matches Set by method
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL and PREG_MATCH_OFFSET are always set, no other flags are supported
+ * @return 0|positive-int
+ *
+ * @param-out array}>> $matches
+ */
+ public static function matchAllWithOffsets(string $pattern, string $subject, ?array &$matches, int $flags = 0, int $offset = 0): int
+ {
+ self::checkSetOrder($flags);
+
+ $result = preg_match_all($pattern, $subject, $matches, $flags | PREG_UNMATCHED_AS_NULL | PREG_OFFSET_CAPTURE, $offset);
+ if (!is_int($result)) { // PHP < 8 may return null, 8+ returns int|false
+ throw PcreException::fromFunction('preg_match_all', $pattern);
+ }
+
+ return $result;
+ }
+
+ /**
+ * @param string|string[] $pattern
+ * @param string|string[] $replacement
+ * @param string $subject
+ * @param int $count Set by method
+ *
+ * @param-out int<0, max> $count
+ */
+ public static function replace($pattern, $replacement, $subject, int $limit = -1, ?int &$count = null): string
+ {
+ if (!is_scalar($subject)) {
+ if (is_array($subject)) {
+ throw new \InvalidArgumentException(static::ARRAY_MSG);
+ }
+
+ throw new \TypeError(sprintf(static::INVALID_TYPE_MSG, gettype($subject)));
+ }
+
+ $result = preg_replace($pattern, $replacement, $subject, $limit, $count);
+ if ($result === null) {
+ throw PcreException::fromFunction('preg_replace', $pattern);
+ }
+
+ return $result;
+ }
+
+ /**
+ * @param string|string[] $pattern
+ * @param ($flags is PREG_OFFSET_CAPTURE ? (callable(array}>): string) : callable(array): string) $replacement
+ * @param string $subject
+ * @param int $count Set by method
+ * @param int-mask $flags PREG_OFFSET_CAPTURE is supported, PREG_UNMATCHED_AS_NULL is always set
+ *
+ * @param-out int<0, max> $count
+ */
+ public static function replaceCallback($pattern, callable $replacement, $subject, int $limit = -1, ?int &$count = null, int $flags = 0): string
+ {
+ if (!is_scalar($subject)) {
+ if (is_array($subject)) {
+ throw new \InvalidArgumentException(static::ARRAY_MSG);
+ }
+
+ throw new \TypeError(sprintf(static::INVALID_TYPE_MSG, gettype($subject)));
+ }
+
+ $result = preg_replace_callback($pattern, $replacement, $subject, $limit, $count, $flags | PREG_UNMATCHED_AS_NULL);
+ if ($result === null) {
+ throw PcreException::fromFunction('preg_replace_callback', $pattern);
+ }
+
+ return $result;
+ }
+
+ /**
+ * Variant of `replaceCallback()` which outputs non-null matches (or throws)
+ *
+ * @param string $pattern
+ * @param ($flags is PREG_OFFSET_CAPTURE ? (callable(array}>): string) : callable(array): string) $replacement
+ * @param string $subject
+ * @param int $count Set by method
+ * @param int-mask $flags PREG_OFFSET_CAPTURE is supported, PREG_UNMATCHED_AS_NULL is always set
+ *
+ * @param-out int<0, max> $count
+ */
+ public static function replaceCallbackStrictGroups(string $pattern, callable $replacement, $subject, int $limit = -1, ?int &$count = null, int $flags = 0): string
+ {
+ return self::replaceCallback($pattern, function (array $matches) use ($pattern, $replacement) {
+ return $replacement(self::enforceNonNullMatches($pattern, $matches, 'replaceCallback'));
+ }, $subject, $limit, $count, $flags);
+ }
+
+ /**
+ * @param ($flags is PREG_OFFSET_CAPTURE ? (array}>): string>) : array): string>) $pattern
+ * @param string $subject
+ * @param int $count Set by method
+ * @param int-mask $flags PREG_OFFSET_CAPTURE is supported, PREG_UNMATCHED_AS_NULL is always set
+ *
+ * @param-out int<0, max> $count
+ */
+ public static function replaceCallbackArray(array $pattern, $subject, int $limit = -1, ?int &$count = null, int $flags = 0): string
+ {
+ if (!is_scalar($subject)) {
+ if (is_array($subject)) {
+ throw new \InvalidArgumentException(static::ARRAY_MSG);
+ }
+
+ throw new \TypeError(sprintf(static::INVALID_TYPE_MSG, gettype($subject)));
+ }
+
+ $result = preg_replace_callback_array($pattern, $subject, $limit, $count, $flags | PREG_UNMATCHED_AS_NULL);
+ if ($result === null) {
+ $pattern = array_keys($pattern);
+ throw PcreException::fromFunction('preg_replace_callback_array', $pattern);
+ }
+
+ return $result;
+ }
+
+ /**
+ * @param int-mask $flags PREG_SPLIT_NO_EMPTY or PREG_SPLIT_DELIM_CAPTURE
+ * @return list
+ */
+ public static function split(string $pattern, string $subject, int $limit = -1, int $flags = 0): array
+ {
+ if (($flags & PREG_SPLIT_OFFSET_CAPTURE) !== 0) {
+ throw new \InvalidArgumentException('PREG_SPLIT_OFFSET_CAPTURE is not supported as it changes the type of $matches, use splitWithOffsets() instead');
+ }
+
+ $result = preg_split($pattern, $subject, $limit, $flags);
+ if ($result === false) {
+ throw PcreException::fromFunction('preg_split', $pattern);
+ }
+
+ return $result;
+ }
+
+ /**
+ * @param int-mask $flags PREG_SPLIT_NO_EMPTY or PREG_SPLIT_DELIM_CAPTURE, PREG_SPLIT_OFFSET_CAPTURE is always set
+ * @return list
+ * @phpstan-return list}>
+ */
+ public static function splitWithOffsets(string $pattern, string $subject, int $limit = -1, int $flags = 0): array
+ {
+ $result = preg_split($pattern, $subject, $limit, $flags | PREG_SPLIT_OFFSET_CAPTURE);
+ if ($result === false) {
+ throw PcreException::fromFunction('preg_split', $pattern);
+ }
+
+ return $result;
+ }
+
+ /**
+ * @template T of string|\Stringable
+ * @param string $pattern
+ * @param array $array
+ * @param int-mask $flags PREG_GREP_INVERT
+ * @return array
+ */
+ public static function grep(string $pattern, array $array, int $flags = 0): array
+ {
+ $result = preg_grep($pattern, $array, $flags);
+ if ($result === false) {
+ throw PcreException::fromFunction('preg_grep', $pattern);
+ }
+
+ return $result;
+ }
+
+ /**
+ * Variant of match() which returns a bool instead of int
+ *
+ * @param non-empty-string $pattern
+ * @param array $matches Set by method
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ *
+ * @param-out array $matches
+ */
+ public static function isMatch(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): bool
+ {
+ return (bool) static::match($pattern, $subject, $matches, $flags, $offset);
+ }
+
+ /**
+ * Variant of `isMatch()` which outputs non-null matches (or throws)
+ *
+ * @param non-empty-string $pattern
+ * @param array $matches Set by method
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ * @throws UnexpectedNullMatchException
+ *
+ * @param-out array $matches
+ */
+ public static function isMatchStrictGroups(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): bool
+ {
+ return (bool) self::matchStrictGroups($pattern, $subject, $matches, $flags, $offset);
+ }
+
+ /**
+ * Variant of matchAll() which returns a bool instead of int
+ *
+ * @param non-empty-string $pattern
+ * @param array $matches Set by method
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ *
+ * @param-out array> $matches
+ */
+ public static function isMatchAll(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): bool
+ {
+ return (bool) static::matchAll($pattern, $subject, $matches, $flags, $offset);
+ }
+
+ /**
+ * Variant of `isMatchAll()` which outputs non-null matches (or throws)
+ *
+ * @param non-empty-string $pattern
+ * @param array $matches Set by method
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ *
+ * @param-out array> $matches
+ */
+ public static function isMatchAllStrictGroups(string $pattern, string $subject, ?array &$matches = null, int $flags = 0, int $offset = 0): bool
+ {
+ return (bool) self::matchAllStrictGroups($pattern, $subject, $matches, $flags, $offset);
+ }
+
+ /**
+ * Variant of matchWithOffsets() which returns a bool instead of int
+ *
+ * Runs preg_match with PREG_OFFSET_CAPTURE
+ *
+ * @param non-empty-string $pattern
+ * @param array $matches Set by method
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ *
+ * @param-out array}> $matches
+ */
+ public static function isMatchWithOffsets(string $pattern, string $subject, ?array &$matches, int $flags = 0, int $offset = 0): bool
+ {
+ return (bool) static::matchWithOffsets($pattern, $subject, $matches, $flags, $offset);
+ }
+
+ /**
+ * Variant of matchAllWithOffsets() which returns a bool instead of int
+ *
+ * Runs preg_match_all with PREG_OFFSET_CAPTURE
+ *
+ * @param non-empty-string $pattern
+ * @param array $matches Set by method
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ *
+ * @param-out array}>> $matches
+ */
+ public static function isMatchAllWithOffsets(string $pattern, string $subject, ?array &$matches, int $flags = 0, int $offset = 0): bool
+ {
+ return (bool) static::matchAllWithOffsets($pattern, $subject, $matches, $flags, $offset);
+ }
+
+ private static function checkOffsetCapture(int $flags, string $useFunctionName): void
+ {
+ if (($flags & PREG_OFFSET_CAPTURE) !== 0) {
+ throw new \InvalidArgumentException('PREG_OFFSET_CAPTURE is not supported as it changes the type of $matches, use ' . $useFunctionName . '() instead');
+ }
+ }
+
+ private static function checkSetOrder(int $flags): void
+ {
+ if (($flags & PREG_SET_ORDER) !== 0) {
+ throw new \InvalidArgumentException('PREG_SET_ORDER is not supported as it changes the type of $matches');
+ }
+ }
+
+ /**
+ * @param array $matches
+ * @return array
+ * @throws UnexpectedNullMatchException
+ */
+ private static function enforceNonNullMatches(string $pattern, array $matches, string $variantMethod)
+ {
+ foreach ($matches as $group => $match) {
+ if (is_string($match) || (is_array($match) && is_string($match[0]))) {
+ continue;
+ }
+
+ throw new UnexpectedNullMatchException('Pattern "'.$pattern.'" had an unexpected unmatched group "'.$group.'", make sure the pattern always matches or use '.$variantMethod.'() instead.');
+ }
+
+ /** @var array */
+ return $matches;
+ }
+
+ /**
+ * @param array> $matches
+ * @return array>
+ * @throws UnexpectedNullMatchException
+ */
+ private static function enforceNonNullMatchAll(string $pattern, array $matches, string $variantMethod)
+ {
+ foreach ($matches as $group => $groupMatches) {
+ foreach ($groupMatches as $match) {
+ if (null === $match) {
+ throw new UnexpectedNullMatchException('Pattern "'.$pattern.'" had an unexpected unmatched group "'.$group.'", make sure the pattern always matches or use '.$variantMethod.'() instead.');
+ }
+ }
+ }
+
+ /** @var array> */
+ return $matches;
+ }
+}
diff --git a/api/vendor/composer/pcre/src/Regex.php b/api/vendor/composer/pcre/src/Regex.php
new file mode 100644
index 00000000..038cf069
--- /dev/null
+++ b/api/vendor/composer/pcre/src/Regex.php
@@ -0,0 +1,176 @@
+
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Composer\Pcre;
+
+class Regex
+{
+ /**
+ * @param non-empty-string $pattern
+ */
+ public static function isMatch(string $pattern, string $subject, int $offset = 0): bool
+ {
+ return (bool) Preg::match($pattern, $subject, $matches, 0, $offset);
+ }
+
+ /**
+ * @param non-empty-string $pattern
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ */
+ public static function match(string $pattern, string $subject, int $flags = 0, int $offset = 0): MatchResult
+ {
+ self::checkOffsetCapture($flags, 'matchWithOffsets');
+
+ $count = Preg::match($pattern, $subject, $matches, $flags, $offset);
+
+ return new MatchResult($count, $matches);
+ }
+
+ /**
+ * Variant of `match()` which returns non-null matches (or throws)
+ *
+ * @param non-empty-string $pattern
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ * @throws UnexpectedNullMatchException
+ */
+ public static function matchStrictGroups(string $pattern, string $subject, int $flags = 0, int $offset = 0): MatchStrictGroupsResult
+ {
+ // @phpstan-ignore composerPcre.maybeUnsafeStrictGroups
+ $count = Preg::matchStrictGroups($pattern, $subject, $matches, $flags, $offset);
+
+ return new MatchStrictGroupsResult($count, $matches);
+ }
+
+ /**
+ * Runs preg_match with PREG_OFFSET_CAPTURE
+ *
+ * @param non-empty-string $pattern
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL and PREG_MATCH_OFFSET are always set, no other flags are supported
+ */
+ public static function matchWithOffsets(string $pattern, string $subject, int $flags = 0, int $offset = 0): MatchWithOffsetsResult
+ {
+ $count = Preg::matchWithOffsets($pattern, $subject, $matches, $flags, $offset);
+
+ return new MatchWithOffsetsResult($count, $matches);
+ }
+
+ /**
+ * @param non-empty-string $pattern
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ */
+ public static function matchAll(string $pattern, string $subject, int $flags = 0, int $offset = 0): MatchAllResult
+ {
+ self::checkOffsetCapture($flags, 'matchAllWithOffsets');
+ self::checkSetOrder($flags);
+
+ $count = Preg::matchAll($pattern, $subject, $matches, $flags, $offset);
+
+ return new MatchAllResult($count, $matches);
+ }
+
+ /**
+ * Variant of `matchAll()` which returns non-null matches (or throws)
+ *
+ * @param non-empty-string $pattern
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL is always set, no other flags are supported
+ * @throws UnexpectedNullMatchException
+ */
+ public static function matchAllStrictGroups(string $pattern, string $subject, int $flags = 0, int $offset = 0): MatchAllStrictGroupsResult
+ {
+ self::checkOffsetCapture($flags, 'matchAllWithOffsets');
+ self::checkSetOrder($flags);
+
+ // @phpstan-ignore composerPcre.maybeUnsafeStrictGroups
+ $count = Preg::matchAllStrictGroups($pattern, $subject, $matches, $flags, $offset);
+
+ return new MatchAllStrictGroupsResult($count, $matches);
+ }
+
+ /**
+ * Runs preg_match_all with PREG_OFFSET_CAPTURE
+ *
+ * @param non-empty-string $pattern
+ * @param int-mask $flags PREG_UNMATCHED_AS_NULL and PREG_MATCH_OFFSET are always set, no other flags are supported
+ */
+ public static function matchAllWithOffsets(string $pattern, string $subject, int $flags = 0, int $offset = 0): MatchAllWithOffsetsResult
+ {
+ self::checkSetOrder($flags);
+
+ $count = Preg::matchAllWithOffsets($pattern, $subject, $matches, $flags, $offset);
+
+ return new MatchAllWithOffsetsResult($count, $matches);
+ }
+ /**
+ * @param string|string[] $pattern
+ * @param string|string[] $replacement
+ * @param string $subject
+ */
+ public static function replace($pattern, $replacement, $subject, int $limit = -1): ReplaceResult
+ {
+ $result = Preg::replace($pattern, $replacement, $subject, $limit, $count);
+
+ return new ReplaceResult($count, $result);
+ }
+
+ /**
+ * @param string|string[] $pattern
+ * @param ($flags is PREG_OFFSET_CAPTURE ? (callable(array}>): string) : callable(array): string) $replacement
+ * @param string $subject
+ * @param int-mask $flags PREG_OFFSET_CAPTURE is supported, PREG_UNMATCHED_AS_NULL is always set
+ */
+ public static function replaceCallback($pattern, callable $replacement, $subject, int $limit = -1, int $flags = 0): ReplaceResult
+ {
+ $result = Preg::replaceCallback($pattern, $replacement, $subject, $limit, $count, $flags);
+
+ return new ReplaceResult($count, $result);
+ }
+
+ /**
+ * Variant of `replaceCallback()` which outputs non-null matches (or throws)
+ *
+ * @param string $pattern
+ * @param ($flags is PREG_OFFSET_CAPTURE ? (callable(array}>): string) : callable(array): string) $replacement
+ * @param string $subject
+ * @param int-mask $flags PREG_OFFSET_CAPTURE is supported, PREG_UNMATCHED_AS_NULL is always set
+ */
+ public static function replaceCallbackStrictGroups($pattern, callable $replacement, $subject, int $limit = -1, int $flags = 0): ReplaceResult
+ {
+ $result = Preg::replaceCallbackStrictGroups($pattern, $replacement, $subject, $limit, $count, $flags);
+
+ return new ReplaceResult($count, $result);
+ }
+
+ /**
+ * @param ($flags is PREG_OFFSET_CAPTURE ? (array}>): string>) : array): string>) $pattern
+ * @param string $subject
+ * @param int-mask $flags PREG_OFFSET_CAPTURE is supported, PREG_UNMATCHED_AS_NULL is always set
+ */
+ public static function replaceCallbackArray(array $pattern, $subject, int $limit = -1, int $flags = 0): ReplaceResult
+ {
+ $result = Preg::replaceCallbackArray($pattern, $subject, $limit, $count, $flags);
+
+ return new ReplaceResult($count, $result);
+ }
+
+ private static function checkOffsetCapture(int $flags, string $useFunctionName): void
+ {
+ if (($flags & PREG_OFFSET_CAPTURE) !== 0) {
+ throw new \InvalidArgumentException('PREG_OFFSET_CAPTURE is not supported as it changes the return type, use '.$useFunctionName.'() instead');
+ }
+ }
+
+ private static function checkSetOrder(int $flags): void
+ {
+ if (($flags & PREG_SET_ORDER) !== 0) {
+ throw new \InvalidArgumentException('PREG_SET_ORDER is not supported as it changes the return type');
+ }
+ }
+}
diff --git a/api/vendor/composer/pcre/src/ReplaceResult.php b/api/vendor/composer/pcre/src/ReplaceResult.php
new file mode 100644
index 00000000..33847712
--- /dev/null
+++ b/api/vendor/composer/pcre/src/ReplaceResult.php
@@ -0,0 +1,43 @@
+
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Composer\Pcre;
+
+final class ReplaceResult
+{
+ /**
+ * @readonly
+ * @var string
+ */
+ public $result;
+
+ /**
+ * @readonly
+ * @var 0|positive-int
+ */
+ public $count;
+
+ /**
+ * @readonly
+ * @var bool
+ */
+ public $matched;
+
+ /**
+ * @param 0|positive-int $count
+ */
+ public function __construct(int $count, string $result)
+ {
+ $this->count = $count;
+ $this->matched = (bool) $count;
+ $this->result = $result;
+ }
+}
diff --git a/api/vendor/composer/pcre/src/UnexpectedNullMatchException.php b/api/vendor/composer/pcre/src/UnexpectedNullMatchException.php
new file mode 100644
index 00000000..f123828b
--- /dev/null
+++ b/api/vendor/composer/pcre/src/UnexpectedNullMatchException.php
@@ -0,0 +1,20 @@
+
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace Composer\Pcre;
+
+class UnexpectedNullMatchException extends PcreException
+{
+ public static function fromFunction($function, $pattern)
+ {
+ throw new \LogicException('fromFunction should not be called on '.self::class.', use '.PcreException::class);
+ }
+}
diff --git a/api/vendor/composer/platform_check.php b/api/vendor/composer/platform_check.php
deleted file mode 100644
index 4c3a5d68..00000000
--- a/api/vendor/composer/platform_check.php
+++ /dev/null
@@ -1,26 +0,0 @@
-= 80100)) {
- $issues[] = 'Your Composer dependencies require a PHP version ">= 8.1.0". You are running ' . PHP_VERSION . '.';
-}
-
-if ($issues) {
- if (!headers_sent()) {
- header('HTTP/1.1 500 Internal Server Error');
- }
- if (!ini_get('display_errors')) {
- if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') {
- fwrite(STDERR, 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . implode(PHP_EOL, $issues) . PHP_EOL.PHP_EOL);
- } elseif (!headers_sent()) {
- echo 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . str_replace('You are running '.PHP_VERSION.'.', '', implode(PHP_EOL, $issues)) . PHP_EOL.PHP_EOL;
- }
- }
- trigger_error(
- 'Composer detected issues in your platform: ' . implode(' ', $issues),
- E_USER_ERROR
- );
-}
diff --git a/api/vendor/maennchen/zipstream-php/.editorconfig b/api/vendor/maennchen/zipstream-php/.editorconfig
new file mode 100644
index 00000000..f7cd9142
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.editorconfig
@@ -0,0 +1,22 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+
+[*.{yml,md,xml}]
+indent_style = space
+indent_size = 2
+
+[*.{rst,php}]
+indent_style = space
+indent_size = 4
+
+[composer.json]
+indent_style = space
+indent_size = 2
+
+[composer.lock]
+indent_style = space
+indent_size = 4
diff --git a/api/vendor/maennchen/zipstream-php/.gitattributes b/api/vendor/maennchen/zipstream-php/.gitattributes
new file mode 100644
index 00000000..e058ebd0
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.gitattributes
@@ -0,0 +1,6 @@
+.gitignore text eol=lf
+.gitattributes text eol=lf
+*.md text eol=lf
+*.php text eol=lf
+*.yml text eol=lf
+*.xml text eol=lf
diff --git a/api/vendor/maennchen/zipstream-php/.github/CODE_OF_CONDUCT.md b/api/vendor/maennchen/zipstream-php/.github/CODE_OF_CONDUCT.md
new file mode 100644
index 00000000..9d75b876
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/CODE_OF_CONDUCT.md
@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
+ and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the overall
+ community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances of
+ any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address,
+ without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+jonatan@maennchen.ch.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][mozilla coc].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][faq]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[mozilla coc]: https://github.com/mozilla/diversity
+[faq]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations
diff --git a/api/vendor/maennchen/zipstream-php/.github/CONTRIBUTING.md b/api/vendor/maennchen/zipstream-php/.github/CONTRIBUTING.md
new file mode 100644
index 00000000..d8caee08
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/CONTRIBUTING.md
@@ -0,0 +1,139 @@
+# Contributing to ZipStream-PHP
+
+## Welcome!
+
+We look forward to your contributions! Here are some examples how you can
+contribute:
+
+- [Report a bug](https://github.com/maennchen/ZipStream-PHP/issues/new?labels=bug&template=BUG.md)
+- [Propose a new feature](https://github.com/maennchen/ZipStream-PHP/issues/new?labels=enhancement&template=FEATURE.md)
+- [Send a pull request](https://github.com/maennchen/ZipStream-PHP/pulls)
+
+## We have a Code of Conduct
+
+Please note that this project is released with a
+[Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this
+project you agree to abide by its terms.
+
+## Any contributions you make will be under the MIT License
+
+When you submit code changes, your submissions are understood to be under the
+same [MIT License](https://github.com/maennchen/ZipStream-PHP/blob/main/LICENSE)
+that covers the project. By contributing to this project, you agree that your
+contributions will be licensed under its MIT License.
+
+## Write bug reports with detail, background, and sample code
+
+In your bug report, please provide the following:
+
+- A quick summary and/or background
+- Steps to reproduce
+ - Be specific!
+ - Give sample code if you can.
+- What you expected would happen
+- What actually happens
+- Notes (possibly including why you think this might be happening, or stuff you
+- tried that didn't work)
+
+Please do not report a bug for a version of ZIPStream-PHP that is no longer
+supported (`< 3.0.0`). Please do not report a bug if you are using a version of
+PHP that is not supported by the version of ZipStream-PHP you are using.
+
+Please post code and output as text
+([using proper markup](https://guides.github.com/features/mastering-markdown/)).
+Do not post screenshots of code or output.
+
+Please include the output of `composer info | sort`.
+
+## Workflow for Pull Requests
+
+1. Fork the repository.
+2. Create your branch from `main` if you plan to implement new functionality or
+ change existing code significantly; create your branch from the oldest branch
+ that is affected by the bug if you plan to fix a bug.
+3. Implement your change and add tests for it.
+4. Ensure the test suite passes.
+5. Ensure the code complies with our coding guidelines (see below).
+6. Send that pull request!
+
+Please make sure you have
+[set up your user name and email address](https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup)
+for use with Git. Strings such as `silly nick name ` look really
+stupid in the commit history of a project.
+
+We encourage you to
+[sign your Git commits with your GPG key](https://docs.github.com/en/github/authenticating-to-github/signing-commits).
+
+Pull requests for new features must be based on the `main` branch.
+
+We are trying to keep backwards compatibility breaks in ZipStream-PHP to a
+minimum. Please take this into account when proposing changes.
+
+Due to time constraints, we are not always able to respond as quickly as we
+would like. Please do not take delays personal and feel free to remind us if you
+feel that we forgot to respond.
+
+## Coding Guidelines
+
+This project comes with a configuration file (located at `/psalm.yml` in the
+repository) that you can use to perform static analysis (with a focus on type
+checking):
+
+```bash
+$ .composer run test:lint
+```
+
+This project comes with a configuration file (located at
+`/.php-cs-fixer.dist.php` in the repository) that you can use to (re)format your
+source code for compliance with this project's coding guidelines:
+
+```bash
+$ composer run format
+```
+
+Please understand that we will not accept a pull request when its changes
+violate this project's coding guidelines.
+
+## Using ZipStream-PHP from a Git checkout
+
+The following commands can be used to perform the initial checkout of
+ZipStream-PHP:
+
+```bash
+$ git clone git@github.com:maennchen/ZipStream-PHP.git
+
+$ cd ZipStream-PHP
+```
+
+Install ZipStream-PHP's dependencies using [Composer](https://getcomposer.org/):
+
+```bash
+$ composer install
+$ composer run install:tools # Install phpDocumentor using phive
+```
+
+## Running ZipStream-PHP's test suite
+
+After following the steps shown above, ZipStream-PHP's test suite is run like
+this:
+
+```bash
+$ composer run test:unit
+```
+
+There's some slow tests in the test suite that test the handling of big files in
+the archives. To skip them use the following command instead:
+
+```bash
+$ composer run test:unit:fast
+```
+
+## Generating ZipStream-PHP Documentation
+
+To generate the documentation for the library, run:
+
+```bash
+$ composer run docs:generate
+```
+
+The guide documentation pages can be found in the `/guides/` directory.
diff --git a/api/vendor/maennchen/zipstream-php/.github/FUNDING.yml b/api/vendor/maennchen/zipstream-php/.github/FUNDING.yml
new file mode 100644
index 00000000..5a461276
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/FUNDING.yml
@@ -0,0 +1 @@
+github: maennchen
diff --git a/api/vendor/maennchen/zipstream-php/.github/ISSUE_TEMPLATE/BUG.yml b/api/vendor/maennchen/zipstream-php/.github/ISSUE_TEMPLATE/BUG.yml
new file mode 100644
index 00000000..0eb8cc77
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/ISSUE_TEMPLATE/BUG.yml
@@ -0,0 +1,71 @@
+name: 🐞 Bug Report
+description: Something is broken?
+labels: ["bug"]
+body:
+ - type: markdown
+ attributes:
+ value: |
+ - Create a discussion instead if you are looking for support:
+ https://github.com/maennchen/ZipStream-PHP/discussions
+ - type: input
+ id: version
+ attributes:
+ label: ZipStream-PHP version
+ placeholder: x.y.z
+ validations:
+ required: true
+ - type: input
+ id: php-version
+ attributes:
+ label: PHP version
+ placeholder: x.y.z
+ validations:
+ required: true
+ - type: checkboxes
+ id: constraints
+ attributes:
+ label: Constraints for Bug Report
+ options:
+ - label: |
+ I'm using a version of ZipStream that is currently supported:
+ https://github.com/maennchen/ZipStream-PHP#version-support
+ required: true
+ - label: |
+ I'm using a version of PHP that has active support:
+ https://www.php.net/supported-versions.php
+ required: true
+ - label: |
+ I'm using a version of PHP that is compatible with your used
+ ZipStream version.
+ required: true
+ - label: |
+ I'm using the latest release of the used ZipStream major version.
+ required: true
+ - type: textarea
+ id: summary
+ attributes:
+ label: Summary
+ description: Provide a summary describing the problem you are experiencing.
+ validations:
+ required: true
+ - type: textarea
+ id: current-behaviour
+ attributes:
+ label: Current behavior
+ description: What is the current (buggy) behavior?
+ validations:
+ required: true
+ - type: textarea
+ id: reproduction
+ attributes:
+ label: How to reproduce
+ description: Provide steps to reproduce the bug.
+ validations:
+ required: true
+ - type: textarea
+ id: expected-behaviour
+ attributes:
+ label: Expected behavior
+ description: What was the expected (correct) behavior?
+ validations:
+ required: true
diff --git a/api/vendor/maennchen/zipstream-php/.github/ISSUE_TEMPLATE/FEATURE.yml b/api/vendor/maennchen/zipstream-php/.github/ISSUE_TEMPLATE/FEATURE.yml
new file mode 100644
index 00000000..e5dec637
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/ISSUE_TEMPLATE/FEATURE.yml
@@ -0,0 +1,11 @@
+name: 🎉 Feature Request
+description: You have a neat idea that should be implemented?
+labels: ["enhancement"]
+body:
+ - type: textarea
+ id: description
+ attributes:
+ label: Description
+ description: Provide a summary of the feature you would like to see implemented.
+ validations:
+ required: true
diff --git a/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE.md b/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 00000000..6892c571
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,6 @@
+Please go the the `Preview` tab and select the appropriate sub-template:
+
+* [🐞 Failing Test](?expand=1&template=FAILING_TEST.md)
+* [🐞 Bug Fix](?expand=1&template=FIX.md)
+* [⚙ Improvement](?expand=1&template=IMPROVEMENT.md)
+* [🎉 New Feature](?expand=1&template=NEW_FEATURE.md)
diff --git a/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE/FAILING_TEST.md b/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE/FAILING_TEST.md
new file mode 100644
index 00000000..24603cb6
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE/FAILING_TEST.md
@@ -0,0 +1,13 @@
+
+
+
diff --git a/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE/FIX.md b/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE/FIX.md
new file mode 100644
index 00000000..77f65a08
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE/FIX.md
@@ -0,0 +1,13 @@
+
+
+
diff --git a/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE/IMPROVEMENT.md b/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE/IMPROVEMENT.md
new file mode 100644
index 00000000..3ac8e310
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE/IMPROVEMENT.md
@@ -0,0 +1,9 @@
+
+
+
diff --git a/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE/NEW_FEATURE.md b/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE/NEW_FEATURE.md
new file mode 100644
index 00000000..ca53939c
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/PULL_REQUEST_TEMPLATE/NEW_FEATURE.md
@@ -0,0 +1,9 @@
+
+
+
diff --git a/api/vendor/maennchen/zipstream-php/.github/SECURITY.md b/api/vendor/maennchen/zipstream-php/.github/SECURITY.md
new file mode 100644
index 00000000..3046c310
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/SECURITY.md
@@ -0,0 +1,22 @@
+# Security Policy
+
+[](https://github.com/ossf/oss-vulnerability-guide/blob/main/finder-guide.md)
+[](https://github.com/maennchen/ZipStream-PHP/security/advisories/new)
+[](mailto:jonatan@maennchen.ch)
+
+This repository follows the
+[OpenSSF Vulnerability Disclosure guide](https://github.com/ossf/oss-vulnerability-guide/tree/main).
+You can learn more about it in the
+[Finders Guide](https://github.com/ossf/oss-vulnerability-guide/blob/main/finder-guide.md).
+
+Please report vulnerabilities via the
+[GitHub Security Vulnerability Reporting](https://github.com/maennchen/ZipStream-PHP/security/advisories/new)
+or via email to [`jonatan@maennchen.ch`](mailto:jonatan@maennchen.ch) if this does
+not work for you.
+
+Our vulnerability management team will respond within 3 working days of your
+report. If the issue is confirmed as a vulnerability, we will open a Security
+Advisory. This project follows a 90 day disclosure timeline.
+
+If you have questions about reporting security issues, email the vulnerability
+management team: [`jonatan@maennchen.ch`](mailto:jonatan@maennchen.ch)
diff --git a/api/vendor/maennchen/zipstream-php/.github/dependabot.yml b/api/vendor/maennchen/zipstream-php/.github/dependabot.yml
new file mode 100644
index 00000000..9d20742e
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/dependabot.yml
@@ -0,0 +1,15 @@
+version: 2
+updates:
+ - package-ecosystem: "composer"
+ directory: "/"
+ schedule:
+ interval: "daily"
+ - package-ecosystem: "github-actions"
+ directory: "/"
+ schedule:
+ interval: "weekly"
+ groups:
+ github-actions:
+ applies-to: version-updates
+ patterns:
+ - "*"
diff --git a/api/vendor/maennchen/zipstream-php/.github/scorecard.yml b/api/vendor/maennchen/zipstream-php/.github/scorecard.yml
new file mode 100644
index 00000000..219fc0bf
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/scorecard.yml
@@ -0,0 +1,14 @@
+annotations:
+ - checks:
+ - fuzzing
+ reasons:
+ - reason: not-applicable # PHP is memory safe
+ - checks:
+ - packaging
+ reasons:
+ - reason: not-supported # Using Composer
+ - checks:
+ - signed-releases
+ reasons:
+ - reason: not-applicable # Releases are distributed via Composer
+
diff --git a/api/vendor/maennchen/zipstream-php/.github/workflows/branch_main.yml b/api/vendor/maennchen/zipstream-php/.github/workflows/branch_main.yml
new file mode 100644
index 00000000..15ff2782
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/workflows/branch_main.yml
@@ -0,0 +1,24 @@
+on:
+ push:
+ branches:
+ - "main"
+
+name: "Main Branch"
+
+permissions:
+ contents: read
+
+jobs:
+ test:
+ name: "Test"
+
+ permissions:
+ contents: read
+ security-events: write
+
+ uses: ./.github/workflows/part_test.yml
+
+ docs:
+ name: "Docs"
+
+ uses: ./.github/workflows/part_docs.yml
diff --git a/api/vendor/maennchen/zipstream-php/.github/workflows/part_dependabot.yml b/api/vendor/maennchen/zipstream-php/.github/workflows/part_dependabot.yml
new file mode 100644
index 00000000..20a13a20
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/workflows/part_dependabot.yml
@@ -0,0 +1,30 @@
+on:
+ workflow_call: {}
+
+name: "Dependabot"
+
+permissions:
+ contents: read
+
+jobs:
+ automerge_dependabot:
+ name: "Automerge PRs"
+
+ runs-on: ubuntu-latest
+
+ permissions:
+ pull-requests: write
+ contents: write
+
+ steps:
+ - name: Harden Runner
+ uses: step-security/harden-runner@cb605e52c26070c328afc4562f0b4ada7618a84e # v2.10.4
+ with:
+ egress-policy: audit
+
+ - uses: fastify/github-action-merge-dependabot@c3bde0759d4f24db16f7b250b2122bc2df57e817 # v3.11.0
+ with:
+ github-token: ${{ github.token }}
+ use-github-auto-merge: true
+ # Major Updates need to be merged manually
+ target: minor
diff --git a/api/vendor/maennchen/zipstream-php/.github/workflows/part_docs.yml b/api/vendor/maennchen/zipstream-php/.github/workflows/part_docs.yml
new file mode 100644
index 00000000..9b779eb5
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/workflows/part_docs.yml
@@ -0,0 +1,51 @@
+on:
+ workflow_call: {}
+
+name: "Documentation"
+
+permissions:
+ contents: read
+
+jobs:
+ generate:
+ name: "Generate"
+
+ runs-on: ubuntu-latest
+
+ steps:
+ - name: Harden Runner
+ uses: step-security/harden-runner@cb605e52c26070c328afc4562f0b4ada7618a84e # v2.10.4
+ with:
+ egress-policy: audit
+
+ - name: Checkout Code
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+ - name: SetUp PHP
+ id: setup-php
+ uses: shivammathur/setup-php@9e72090525849c5e82e596468b86eb55e9cc5401 # v2
+ with:
+ php-version: "8.3"
+ tools: phive
+ - name: Cache Tools
+ uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+ id: cache
+ with:
+ path: ~/.phive
+ key: tools-${{ runner.os }}-${{ steps.setup-php.outputs.php-version }}-${{ hashFiles('**/phars.xml') }}
+ restore-keys: |
+ tools-${{ runner.os }}-${{ steps.setup-php.outputs.php-version }}-
+ tools-${{ steps.setup-php.outputs.php-version }}-
+ tools-
+ - name: Install Tools
+ run: composer run install:tools
+ - name: Generate Docs
+ run: composer run docs:generate
+ - uses: actions/upload-artifact@65c4c4a1ddee5b72f698fdd19549f0f0fb45cf08 # v4.6.0
+ with:
+ name: docs
+ path: docs
+ - name: Package for GitHub Pages
+ uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3.0.1
+ with:
+ path: docs
+
diff --git a/api/vendor/maennchen/zipstream-php/.github/workflows/part_release.yml b/api/vendor/maennchen/zipstream-php/.github/workflows/part_release.yml
new file mode 100644
index 00000000..112d72a4
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/workflows/part_release.yml
@@ -0,0 +1,94 @@
+on:
+ workflow_call:
+ inputs:
+ releaseName:
+ required: true
+ type: string
+ stable:
+ required: false
+ type: boolean
+ default: false
+
+name: "Release"
+
+permissions:
+ contents: read
+
+jobs:
+ create:
+ name: Create Release
+
+ runs-on: ubuntu-latest
+
+ permissions:
+ contents: write
+
+ steps:
+ - name: Harden Runner
+ uses: step-security/harden-runner@cb605e52c26070c328afc4562f0b4ada7618a84e # v2.10.4
+ with:
+ egress-policy: audit
+
+ - name: Create prerelease
+ if: ${{ !inputs.stable }}
+ env:
+ GITHUB_TOKEN: ${{ github.token }}
+ run: |
+ gh release create \
+ --repo ${{ github.repository }} \
+ --title ${{ inputs.releaseName }} \
+ --prerelease \
+ --generate-notes \
+ ${{ inputs.releaseName }}
+
+ - name: Create release
+ if: ${{ inputs.stable }}
+ env:
+ GITHUB_TOKEN: ${{ github.token }}
+ run: |
+ gh release create \
+ --repo ${{ github.repository }} \
+ --title ${{ inputs.releaseName }} \
+ --generate-notes \
+ ${{ inputs.releaseName }}
+
+ upload_release:
+ name: "Upload"
+
+ needs: ["create"]
+
+ runs-on: ubuntu-latest
+
+ permissions:
+ id-token: write
+ contents: write
+ attestations: write
+
+ steps:
+ - name: Harden Runner
+ uses: step-security/harden-runner@cb605e52c26070c328afc4562f0b4ada7618a84e # v2.10.4
+ with:
+ egress-policy: audit
+
+ - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+ - uses: actions/download-artifact@fa0a91b85d4f404e444e00e005971372dc801d16 # v4.1.8
+ with:
+ name: docs
+ path: docs
+ - run: |
+ tar -czvf docs.tar.gz docs
+ - name: "Attest Documentation"
+ id: attestation
+ uses: actions/attest-build-provenance@520d128f165991a6c774bcb264f323e3d70747f4 # v2.2.0
+ with:
+ subject-path: "docs.tar.gz"
+ - name: Copy Attestation
+ run: cp "$ATTESTATION" docs.tar.gz.sigstore
+ env:
+ ATTESTATION: "${{ steps.attestation.outputs.bundle-path }}"
+ - name: Upload
+ env:
+ GITHUB_TOKEN: ${{ github.token }}
+ run: |
+ gh release upload --clobber "${{ github.ref_name }}" \
+ docs.tar.gz docs.tar.gz.sigstore
diff --git a/api/vendor/maennchen/zipstream-php/.github/workflows/part_test.yml b/api/vendor/maennchen/zipstream-php/.github/workflows/part_test.yml
new file mode 100644
index 00000000..d4f8180a
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/workflows/part_test.yml
@@ -0,0 +1,181 @@
+on:
+ workflow_call:
+
+name: "Test"
+
+permissions:
+ contents: read
+
+jobs:
+ phpunit:
+ name: PHPUnit (PHP ${{ matrix.php }} on ${{ matrix.os }})
+
+ runs-on: ${{ matrix.os }}
+
+ continue-on-error: ${{ matrix.experimental }}
+
+ strategy:
+ fail-fast: false
+ matrix:
+ php: ["8.2", "8.3", "8.4"]
+ os: [ubuntu-latest]
+ experimental: [false]
+ include:
+ - php: nightly
+ os: ubuntu-latest
+ experimental: true
+ - php: "8.4"
+ os: windows-latest
+ experimental: false
+ - php: "8.4"
+ os: macos-latest
+ experimental: false
+
+ steps:
+ - name: Harden Runner
+ uses: step-security/harden-runner@cb605e52c26070c328afc4562f0b4ada7618a84e # v2.10.4
+ with:
+ egress-policy: audit
+
+ - name: Checkout Code
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+ - name: SetUp PHP
+ id: setup-php
+ uses: shivammathur/setup-php@9e72090525849c5e82e596468b86eb55e9cc5401 # v2
+ with:
+ php-version: "${{ matrix.php }}"
+ tools: phpunit
+ coverage: xdebug
+ extensions: xdebug,zip
+ - name: Get composer cache directory
+ id: composer-cache-common
+ if: "${{ runner.os != 'Windows' }}"
+ run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+ - name: Get composer cache directory
+ id: composer-cache-windows
+ if: "${{ runner.os == 'Windows' }}"
+ run: echo "dir=$(composer config cache-files-dir)" >> $env:GITHUB_OUTPUT
+ - name: Cache Deps
+ uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+ id: cache
+ with:
+ path: ${{ steps.composer-cache-common.outputs.dir }}${{ steps.composer-cache-windows.outputs.dir }}
+ key: deps-${{ runner.os }}-${{ steps.setup-php.outputs.php-version }}-composer-${{ hashFiles('**/composer.lock') }}
+ restore-keys: |
+ deps-${{ runner.os }}-${{ steps.setup-php.outputs.php-version }}-composer-
+ deps-${{ runner.os }}-${{ steps.setup-php.outputs.php-version }}-
+ deps-${{ steps.setup-php.outputs.php-version }}-
+ deps-
+ - name: Install Deps
+ if: matrix.php != 'nightly'
+ run: composer install --prefer-dist
+ - name: Install Deps (ignore PHP requirement)
+ if: matrix.php == 'nightly'
+ run: composer install --prefer-dist --ignore-platform-req=php+
+ - name: Run PHPUnit
+ run: composer run test:unit:cov
+ - name: Upload coverage results to Coveralls
+ env:
+ COVERALLS_REPO_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ COVERALLS_PARALLEL: true
+ COVERALLS_FLAG_NAME: ${{ runner.os }}-${{ steps.setup-php.outputs.php-version }}
+ run: composer run coverage:report
+ continue-on-error: ${{ matrix.experimental }}
+
+ mark_coverage_done:
+ needs: ["phpunit"]
+
+ runs-on: ubuntu-latest
+
+ steps:
+ - name: Harden Runner
+ uses: step-security/harden-runner@cb605e52c26070c328afc4562f0b4ada7618a84e # v2.10.4
+ with:
+ egress-policy: audit
+
+ - name: Coveralls Finished
+ uses: coverallsapp/github-action@648a8eb78e6d50909eff900e4ec85cab4524a45b # v2.3.6
+ with:
+ github-token: ${{ secrets.github_token }}
+ parallel-finished: true
+
+ psalm:
+ name: Run Psalm
+
+ runs-on: "ubuntu-latest"
+
+ permissions:
+ security-events: write
+
+ steps:
+ - name: Harden Runner
+ uses: step-security/harden-runner@cb605e52c26070c328afc4562f0b4ada7618a84e # v2.10.4
+ with:
+ egress-policy: audit
+
+ - name: Checkout Code
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+ - name: SetUp PHP
+ id: setup-php
+ uses: shivammathur/setup-php@9e72090525849c5e82e596468b86eb55e9cc5401 # v2
+ with:
+ php-version: "8.3"
+ - name: Get composer cache directory
+ id: composer-cache
+ run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+ - name: Cache Deps
+ uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+ id: cache
+ with:
+ path: ${{ steps.composer-cache.outputs.dir }}
+ key: deps-${{ runner.os }}-${{ steps.setup-php.outputs.php-version }}-composer-${{ hashFiles('**/composer.lock') }}
+ restore-keys: |
+ deps-${{ runner.os }}-${{ steps.setup-php.outputs.php-version }}-composer-
+ deps-${{ runner.os }}-${{ steps.setup-php.outputs.php-version }}-
+ deps-${{ steps.setup-php.outputs.php-version }}-
+ deps-
+ - name: Install Deps
+ run: composer install --prefer-dist
+ - name: Run Psalm
+ run: composer run test:lint -- --report=results.sarif
+ - name: "Upload SARIF"
+ uses: github/codeql-action/upload-sarif@f6091c0113d1dcf9b98e269ee48e8a7e51b7bdd4 # v3
+ with:
+ sarif_file: results.sarif
+
+ php-cs:
+ name: Run PHP-CS
+
+ runs-on: "ubuntu-latest"
+
+ steps:
+ - name: Harden Runner
+ uses: step-security/harden-runner@cb605e52c26070c328afc4562f0b4ada7618a84e # v2.10.4
+ with:
+ egress-policy: audit
+
+ - name: Checkout Code
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+ - name: SetUp PHP
+ id: setup-php
+ uses: shivammathur/setup-php@9e72090525849c5e82e596468b86eb55e9cc5401 # v2
+ with:
+ php-version: "8.3"
+ - name: Get composer cache directory
+ id: composer-cache
+ run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+ - name: Cache Deps
+ uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
+ id: cache
+ with:
+ path: ${{ steps.composer-cache.outputs.dir }}
+ key: deps-${{ runner.os }}-${{ steps.setup-php.outputs.php-version }}-composer-${{ hashFiles('**/composer.lock') }}
+ restore-keys: |
+ deps-${{ runner.os }}-${{ steps.setup-php.outputs.php-version }}-composer-
+ deps-${{ runner.os }}-${{ steps.setup-php.outputs.php-version }}-
+ deps-${{ steps.setup-php.outputs.php-version }}-
+ deps-
+ - name: Install Deps
+ run: composer install --prefer-dist
+ - name: Run PHP-CS
+ run: composer run test:formatted
diff --git a/api/vendor/maennchen/zipstream-php/.github/workflows/pr.yml b/api/vendor/maennchen/zipstream-php/.github/workflows/pr.yml
new file mode 100644
index 00000000..d21f3986
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/workflows/pr.yml
@@ -0,0 +1,50 @@
+on:
+ pull_request:
+ branches:
+ - "*"
+ workflow_dispatch: {}
+
+name: "Pull Request"
+
+permissions:
+ contents: read
+
+jobs:
+ test:
+ name: "Test"
+
+ permissions:
+ contents: read
+ security-events: write
+
+ uses: ./.github/workflows/part_test.yml
+
+ docs:
+ name: "Docs"
+
+ uses: ./.github/workflows/part_docs.yml
+
+ dependabot:
+ name: "Dependabot"
+
+ if: ${{ github.actor == 'dependabot[bot]'}}
+
+ permissions:
+ pull-requests: write
+ contents: write
+
+ uses: ./.github/workflows/part_dependabot.yml
+
+ dependency-review:
+ name: Dependency Review
+ runs-on: ubuntu-latest
+ steps:
+ - name: Harden Runner
+ uses: step-security/harden-runner@cb605e52c26070c328afc4562f0b4ada7618a84e # v2.10.4
+ with:
+ egress-policy: audit
+
+ - name: 'Checkout Repository'
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+ - name: 'Dependency Review'
+ uses: actions/dependency-review-action@3b139cfc5fae8b618d3eae3675e383bb1769c019 # v4.5.0
diff --git a/api/vendor/maennchen/zipstream-php/.github/workflows/scorecard.yml b/api/vendor/maennchen/zipstream-php/.github/workflows/scorecard.yml
new file mode 100644
index 00000000..c1d08a21
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/workflows/scorecard.yml
@@ -0,0 +1,78 @@
+# This workflow uses actions that are not certified by GitHub. They are provided
+# by a third-party and are governed by separate terms of service, privacy
+# policy, and support documentation.
+
+name: Scorecard supply-chain security
+on:
+ # For Branch-Protection check. Only the default branch is supported. See
+ # https://github.com/ossf/scorecard/blob/main/docs/checks.md#branch-protection
+ branch_protection_rule:
+ # To guarantee Maintained check is occasionally updated. See
+ # https://github.com/ossf/scorecard/blob/main/docs/checks.md#maintained
+ schedule:
+ - cron: '28 11 * * 3'
+ push:
+ branches: [ "main" ]
+
+# Declare default permissions as read only.
+permissions: read-all
+
+jobs:
+ analysis:
+ name: Scorecard analysis
+ runs-on: ubuntu-latest
+ permissions:
+ # Needed to upload the results to code-scanning dashboard.
+ security-events: write
+ # Needed to publish results and get a badge (see publish_results below).
+ id-token: write
+ # Uncomment the permissions below if installing in a private repository.
+ # contents: read
+ # actions: read
+
+ steps:
+ - name: Harden Runner
+ uses: step-security/harden-runner@cb605e52c26070c328afc4562f0b4ada7618a84e # v2.10.4
+ with:
+ egress-policy: audit
+
+ - name: "Checkout code"
+ uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+ with:
+ persist-credentials: false
+
+ - name: "Run analysis"
+ uses: ossf/scorecard-action@62b2cac7ed8198b15735ed49ab1e5cf35480ba46 # v2.4.0
+ with:
+ results_file: results.sarif
+ results_format: sarif
+ # (Optional) "write" PAT token. Uncomment the `repo_token` line below if:
+ # - you want to enable the Branch-Protection check on a *public* repository, or
+ # - you are installing Scorecard on a *private* repository
+ # To create the PAT, follow the steps in https://github.com/ossf/scorecard-action?tab=readme-ov-file#authentication-with-fine-grained-pat-optional.
+ # repo_token: ${{ secrets.SCORECARD_TOKEN }}
+
+ # Public repositories:
+ # - Publish results to OpenSSF REST API for easy access by consumers
+ # - Allows the repository to include the Scorecard badge.
+ # - See https://github.com/ossf/scorecard-action#publishing-results.
+ # For private repositories:
+ # - `publish_results` will always be set to `false`, regardless
+ # of the value entered here.
+ publish_results: true
+
+ # Upload the results as artifacts (optional). Commenting out will disable uploads of run results in SARIF
+ # format to the repository Actions tab.
+ - name: "Upload artifact"
+ uses: actions/upload-artifact@65c4c4a1ddee5b72f698fdd19549f0f0fb45cf08 # v4.6.0
+ with:
+ name: SARIF file
+ path: results.sarif
+ retention-days: 5
+
+ # Upload the results to GitHub's code scanning dashboard (optional).
+ # Commenting out will disable upload of results to your repo's Code Scanning dashboard
+ - name: "Upload to code-scanning"
+ uses: github/codeql-action/upload-sarif@f6091c0113d1dcf9b98e269ee48e8a7e51b7bdd4 # v3.28.5
+ with:
+ sarif_file: results.sarif
diff --git a/api/vendor/maennchen/zipstream-php/.github/workflows/tag-beta.yml b/api/vendor/maennchen/zipstream-php/.github/workflows/tag-beta.yml
new file mode 100644
index 00000000..b3399454
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/workflows/tag-beta.yml
@@ -0,0 +1,29 @@
+on:
+ push:
+ tags:
+ - "[0-9]+.[0-9]+.[0-9]+-beta.[0-9]+"
+
+name: "Beta Tag"
+
+permissions:
+ contents: read
+
+jobs:
+ docs:
+ name: "Docs"
+
+ uses: ./.github/workflows/part_docs.yml
+
+ release:
+ name: "Release"
+
+ needs: ["docs"]
+
+ permissions:
+ id-token: write
+ contents: write
+ attestations: write
+
+ uses: ./.github/workflows/part_release.yml
+ with:
+ releaseName: "${{ github.ref_name }}"
diff --git a/api/vendor/maennchen/zipstream-php/.github/workflows/tag-stable.yml b/api/vendor/maennchen/zipstream-php/.github/workflows/tag-stable.yml
new file mode 100644
index 00000000..dfc14383
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.github/workflows/tag-stable.yml
@@ -0,0 +1,55 @@
+on:
+ push:
+ tags:
+ - "[0-9]+.[0-9]+.[0-9]+"
+
+name: "Stable Tag"
+
+permissions:
+ contents: read
+
+jobs:
+ docs:
+ name: "Docs"
+
+ uses: ./.github/workflows/part_docs.yml
+
+ release:
+ name: "Release"
+
+ needs: ["docs"]
+
+ permissions:
+ id-token: write
+ contents: write
+ attestations: write
+
+ uses: ./.github/workflows/part_release.yml
+ with:
+ releaseName: "${{ github.ref_name }}"
+ stable: true
+
+ deploy_pages:
+ name: "Deploy to GitHub Pages"
+
+ needs: ["release", "docs"]
+
+ runs-on: ubuntu-latest
+
+ permissions:
+ pages: write
+ id-token: write
+
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+
+ steps:
+ - name: Harden Runner
+ uses: step-security/harden-runner@cb605e52c26070c328afc4562f0b4ada7618a84e # v2.10.4
+ with:
+ egress-policy: audit
+
+ - name: Deploy to GitHub Pages
+ id: deployment
+ uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4.0.5
diff --git a/api/vendor/maennchen/zipstream-php/.gitignore b/api/vendor/maennchen/zipstream-php/.gitignore
new file mode 100644
index 00000000..e52a4987
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.gitignore
@@ -0,0 +1,12 @@
+/composer.lock
+/cov
+/coverage.clover.xml
+/docs
+.idea
+/.php-cs-fixer.cache
+/.phpdoc/cache
+/.phpunit.result.cache
+/phpunit.xml
+/.phpunit.cache
+/tools
+/vendor
diff --git a/api/vendor/maennchen/zipstream-php/.phive/phars.xml b/api/vendor/maennchen/zipstream-php/.phive/phars.xml
new file mode 100644
index 00000000..c958402b
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.phive/phars.xml
@@ -0,0 +1,4 @@
+
+
+
+
diff --git a/api/vendor/maennchen/zipstream-php/.php-cs-fixer.dist.php b/api/vendor/maennchen/zipstream-php/.php-cs-fixer.dist.php
new file mode 100644
index 00000000..9d47c384
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.php-cs-fixer.dist.php
@@ -0,0 +1,73 @@
+
+ * @copyright 2022 Nicolas CARPi
+ * @see https://github.com/maennchen/ZipStream-PHP
+ * @license MIT
+ * @package maennchen/ZipStream-PHP
+ */
+
+use PhpCsFixer\Config;
+use PhpCsFixer\Finder;
+use PhpCsFixer\Runner;
+
+$finder = Finder::create()
+ ->exclude('.github')
+ ->exclude('.phpdoc')
+ ->exclude('docs')
+ ->exclude('tools')
+ ->exclude('vendor')
+ ->in(__DIR__);
+
+$config = new Config();
+return $config->setRules([
+ '@PER' => true,
+ '@PER:risky' => true,
+ '@PHP83Migration' => true,
+ '@PHP84Migration' => true,
+ '@PHPUnit84Migration:risky' => true,
+ 'array_syntax' => ['syntax' => 'short'],
+ 'class_attributes_separation' => true,
+ 'declare_strict_types' => true,
+ 'dir_constant' => true,
+ 'is_null' => true,
+ 'no_homoglyph_names' => true,
+ 'no_null_property_initialization' => true,
+ 'no_php4_constructor' => true,
+ 'no_unused_imports' => true,
+ 'no_useless_else' => true,
+ 'non_printable_character' => true,
+ 'ordered_imports' => true,
+ 'ordered_class_elements' => true,
+ 'php_unit_construct' => true,
+ 'pow_to_exponentiation' => true,
+ 'psr_autoloading' => true,
+ 'random_api_migration' => true,
+ 'return_assignment' => true,
+ 'self_accessor' => true,
+ 'semicolon_after_instruction' => true,
+ 'short_scalar_cast' => true,
+ 'simplified_null_return' => true,
+ 'single_class_element_per_statement' => true,
+ 'single_line_comment_style' => true,
+ 'single_quote' => true,
+ 'space_after_semicolon' => true,
+ 'standardize_not_equals' => true,
+ 'strict_param' => true,
+ 'ternary_operator_spaces' => true,
+ 'trailing_comma_in_multiline' => true,
+ 'trim_array_spaces' => true,
+ 'unary_operator_spaces' => true,
+ 'global_namespace_import' => [
+ 'import_classes' => true,
+ 'import_functions' => true,
+ 'import_constants' => true,
+ ],
+ ])
+ ->setFinder($finder)
+ ->setRiskyAllowed(true)
+ ->setParallelConfig(Runner\Parallel\ParallelConfigFactory::detect());
diff --git a/api/vendor/maennchen/zipstream-php/.phpdoc/template/base.html.twig b/api/vendor/maennchen/zipstream-php/.phpdoc/template/base.html.twig
new file mode 100644
index 00000000..2a70c0aa
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.phpdoc/template/base.html.twig
@@ -0,0 +1,15 @@
+{% extends 'layout.html.twig' %}
+
+{% set topMenu = {
+ "menu": [
+ { "name": "Guides", "url": "https://maennchen.dev/ZipStream-PHP/guide/index.html"},
+ { "name": "API", "url": "https://maennchen.dev/ZipStream-PHP/classes/ZipStream-ZipStream.html"},
+ { "name": "Issues", "url": "https://github.com/maennchen/ZipStream-PHP/issues"},
+ ],
+ "social": [
+ { "iconClass": "fab fa-github", "url": "https://github.com/maennchen/ZipStream-PHP"},
+ { "iconClass": "fas fa-envelope-open-text", "url": "https://github.com/maennchen/ZipStream-PHP/discussions"},
+ { "iconClass": "fas fa-money-bill", "url": "https://github.com/sponsors/maennchen"},
+ ]
+}
+%}
\ No newline at end of file
diff --git a/api/vendor/maennchen/zipstream-php/.tool-versions b/api/vendor/maennchen/zipstream-php/.tool-versions
new file mode 100644
index 00000000..150c1ee4
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/.tool-versions
@@ -0,0 +1 @@
+php 8.4.3
diff --git a/api/vendor/maennchen/zipstream-php/LICENSE b/api/vendor/maennchen/zipstream-php/LICENSE
new file mode 100644
index 00000000..ebe7fe2f
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/LICENSE
@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (C) 2007-2009 Paul Duncan
+Copyright (C) 2014 Jonatan Männchen
+Copyright (C) 2014 Jesse G. Donat
+Copyright (C) 2018 Nicolas CARPi
+
+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.
diff --git a/api/vendor/maennchen/zipstream-php/README.md b/api/vendor/maennchen/zipstream-php/README.md
new file mode 100644
index 00000000..1e6d6798
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/README.md
@@ -0,0 +1,157 @@
+# ZipStream-PHP
+
+[](https://github.com/maennchen/ZipStream-PHP/actions/workflows/branch_main.yml)
+[](https://coveralls.io/github/maennchen/ZipStream-PHP?branch=main)
+[](https://packagist.org/packages/maennchen/zipstream-php)
+[](https://packagist.org/packages/maennchen/zipstream-php)
+[](https://www.bestpractices.dev/projects/9524)
+[](https://scorecard.dev/viewer/?uri=github.com/maennchen/ZipStream-PHP)
+
+## Unstable Branch
+
+The `main` branch is not stable. Please see the
+[releases](https://github.com/maennchen/ZipStream-PHP/releases) for a stable
+version.
+
+## Overview
+
+A fast and simple streaming zip file downloader for PHP. Using this library will
+save you from having to write the Zip to disk. You can directly send it to the
+user, which is much faster. It can work with S3 buckets or any PSR7 Stream.
+
+Please see the [LICENSE](LICENSE) file for licensing and warranty information.
+
+## Installation
+
+Simply add a dependency on maennchen/zipstream-php to your project's
+`composer.json` file if you use Composer to manage the dependencies of your
+project. Use following command to add the package to your project's dependencies:
+
+```bash
+composer require maennchen/zipstream-php
+```
+
+## Usage
+
+For detailed instructions, please check the
+[Documentation](https://maennchen.github.io/ZipStream-PHP/).
+
+```php
+// Autoload the dependencies
+require 'vendor/autoload.php';
+
+// create a new zipstream object
+$zip = new ZipStream\ZipStream(
+ outputName: 'example.zip',
+
+ // enable output of HTTP headers
+ sendHttpHeaders: true,
+);
+
+// create a file named 'hello.txt'
+$zip->addFile(
+ fileName: 'hello.txt',
+ data: 'This is the contents of hello.txt',
+);
+
+// add a file named 'some_image.jpg' from a local file 'path/to/image.jpg'
+$zip->addFileFromPath(
+ fileName: 'some_image.jpg',
+ path: 'path/to/image.jpg',
+);
+
+// finish the zip stream
+$zip->finish();
+```
+
+## Upgrade to version 3.1.2
+
+- Minimum PHP Version: `8.2`
+
+## Upgrade to version 3.0.0
+
+### General
+
+- Minimum PHP Version: `8.1`
+- Only 64bit Architecture is supported.
+- The class `ZipStream\Option\Method` has been replaced with the enum
+ `ZipStream\CompressionMethod`.
+- Most clases have been flagged as `@internal` and should not be used from the
+ outside.
+ If you're using internal resources to extend this library, please open an
+ issue so that a clean interface can be added & published.
+ The externally available classes & enums are:
+ - `ZipStream\CompressionMethod`
+ - `ZipStream\Exception*`
+ - `ZipStream\ZipStream`
+
+### Archive Options
+
+- The class `ZipStream\Option\Archive` has been replaced in favor of named
+ arguments in the `ZipStream\ZipStream` constuctor.
+- The archive options `largeFileSize` & `largeFileMethod` has been removed. If
+ you want different `compressionMethods` based on the file size, you'll have to
+ implement this yourself.
+- The archive option `httpHeaderCallback` changed the type from `callable` to
+ `Closure`.
+- The archive option `zeroHeader` has been replaced with the option
+ `defaultEnableZeroHeader` and can be overridden for every file. Its default
+ value changed from `false` to `true`.
+- The archive option `statFiles` was removed since the library no longer checks
+ filesizes this way.
+- The archive option `deflateLevel` has been replaced with the option
+ `defaultDeflateLevel` and can be overridden for every file.
+- The first argument (`name`) of the `ZipStream\ZipStream` constuctor has been
+ replaced with the named argument `outputName`.
+- Headers are now also sent if the `outputName` is empty. If you do not want to
+ automatically send http headers, set `sendHttpHeaders` to `false`.
+
+### File Options
+
+- The class `ZipStream\Option\File` has been replaced in favor of named
+ arguments in the `ZipStream\ZipStream->addFile*` functions.
+- The file option `method` has been renamed to `compressionMethod`.
+- The file option `time` has been renamed to `lastModificationDateTime`.
+- The file option `size` has been renamed to `maxSize`.
+
+## Upgrade to version 2.0.0
+
+https://github.com/maennchen/ZipStream-PHP/tree/2.0.0#upgrade-to-version-200
+
+## Upgrade to version 1.0.0
+
+https://github.com/maennchen/ZipStream-PHP/tree/2.0.0#upgrade-to-version-100
+
+## Contributing
+
+ZipStream-PHP is a collaborative project. Please take a look at the
+[.github/CONTRIBUTING.md](.github/CONTRIBUTING.md) file.
+
+## Version Support
+
+Versions are supported according to the table below.
+
+Please do not open any pull requests contradicting the current version support
+status.
+
+Careful: Always check the `README` on `main` for up-to-date information.
+
+| Version | New Features | Bugfixes | Security |
+|---------|--------------|----------|----------|
+| *3* | ✓ | ✓ | ✓ |
+| *2* | ✗ | ✗ | ✓ |
+| *1* | ✗ | ✗ | ✗ |
+| *0* | ✗ | ✗ | ✗ |
+
+This library aligns itself with the PHP core support. New features and bugfixes
+will only target PHP versions according to their current status.
+
+See: https://www.php.net/supported-versions.php
+
+## About the Authors
+
+- Paul Duncan - https://pablotron.org/
+- Jonatan Männchen - https://maennchen.dev
+- Jesse G. Donat - https://donatstudios.com
+- Nicolas CARPi - https://www.deltablot.com
+- Nik Barham - https://www.brokencube.co.uk
diff --git a/api/vendor/maennchen/zipstream-php/composer.json b/api/vendor/maennchen/zipstream-php/composer.json
new file mode 100644
index 00000000..6ecd503a
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/composer.json
@@ -0,0 +1,93 @@
+{
+ "name": "maennchen/zipstream-php",
+ "description": "ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.",
+ "keywords": ["zip", "stream"],
+ "type": "library",
+ "license": "MIT",
+ "authors": [{
+ "name": "Paul Duncan",
+ "email": "pabs@pablotron.org"
+ },
+ {
+ "name": "Jonatan Männchen",
+ "email": "jonatan@maennchen.ch"
+ },
+ {
+ "name": "Jesse Donat",
+ "email": "donatj@gmail.com"
+ },
+ {
+ "name": "András Kolesár",
+ "email": "kolesar@kolesar.hu"
+ }
+ ],
+ "require": {
+ "php-64bit": "^8.2",
+ "ext-mbstring": "*",
+ "ext-zlib": "*"
+ },
+ "require-dev": {
+ "phpunit/phpunit": "^11.0",
+ "guzzlehttp/guzzle": "^7.5",
+ "ext-zip": "*",
+ "mikey179/vfsstream": "^1.6",
+ "php-coveralls/php-coveralls": "^2.5",
+ "friendsofphp/php-cs-fixer": "^3.16",
+ "vimeo/psalm": "^6.0",
+ "brianium/paratest": "^7.7"
+ },
+ "suggest": {
+ "psr/http-message": "^2.0",
+ "guzzlehttp/psr7": "^2.4"
+ },
+ "scripts": {
+ "format": "php-cs-fixer fix",
+ "test": [
+ "@test:unit",
+ "@test:formatted",
+ "@test:lint"
+ ],
+ "test:unit:setup-cov": "@putenv XDEBUG_MODE=coverage",
+ "test:unit": "paratest --functional",
+ "test:unit:cov": ["@test:unit:setup-cov", "@test:unit --coverage-clover=coverage.clover.xml --coverage-html cov"],
+ "test:unit:slow": "@test:unit --group slow",
+ "test:unit:slow:cov": ["@test:unit:setup-cov", "@test:unit --coverage-clover=coverage.clover.xml --coverage-html cov --group slow"],
+ "test:unit:fast": "@test:unit --exclude-group slow",
+ "test:unit:fast:cov": ["@test:unit:setup-cov", "@test:unit --coverage-clover=coverage.clover.xml --coverage-html cov --exclude-group slow"],
+ "test:formatted": "@format --dry-run --stop-on-violation --using-cache=no",
+ "test:lint": "psalm --stats --show-info=true --find-unused-psalm-suppress",
+ "coverage:report": "php-coveralls --coverage_clover=coverage.clover.xml --json_path=coveralls-upload.json --insecure",
+ "install:tools": "phive install --trust-gpg-keys 0x67F861C3D889C656 --trust-gpg-keys 0x8AC0BAA79732DD42",
+ "docs:generate": "tools/phpdocumentor --sourcecode"
+ },
+ "autoload": {
+ "psr-4": {
+ "ZipStream\\": "src/"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": { "ZipStream\\Test\\": "test/" }
+ },
+ "archive": {
+ "exclude": [
+ "/composer.lock",
+ "/docs",
+ "/.gitattributes",
+ "/.github",
+ "/.gitignore",
+ "/guides",
+ "/.phive",
+ "/.php-cs-fixer.cache",
+ "/.php-cs-fixer.dist.php",
+ "/.phpdoc",
+ "/phpdoc.dist.xml",
+ "/.phpunit.result.cache",
+ "/phpunit.xml.dist",
+ "/psalm.xml",
+ "/test",
+ "/tools",
+ "/.tool-versions",
+ "/vendor"
+ ]
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/guides/ContentLength.rst b/api/vendor/maennchen/zipstream-php/guides/ContentLength.rst
new file mode 100644
index 00000000..21fea34d
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/guides/ContentLength.rst
@@ -0,0 +1,47 @@
+Adding Content-Length header
+=============
+
+Adding a ``Content-Length`` header for ``ZipStream`` can be achieved by
+using the options ``SIMULATION_STRICT`` or ``SIMULATION_LAX`` in the
+``operationMode`` parameter.
+
+In the ``SIMULATION_STRICT`` mode, ``ZipStream`` will not allow to calculate the
+size based on reading the whole file. ``SIMULATION_LAX`` will read the whole
+file if neccessary.
+
+``SIMULATION_STRICT`` is therefore useful to make sure that the size can be
+calculated efficiently.
+
+.. code-block:: php
+ use ZipStream\OperationMode;
+ use ZipStream\ZipStream;
+
+ $zip = new ZipStream(
+ operationMode: OperationMode::SIMULATE_STRICT, // or SIMULATE_LAX
+ defaultEnableZeroHeader: false,
+ sendHttpHeaders: true,
+ outputStream: $stream,
+ );
+
+ // Normally add files
+ $zip->addFile('sample.txt', 'Sample String Data');
+
+ // Use addFileFromCallback and exactSize if you want to defer opening of
+ // the file resource
+ $zip->addFileFromCallback(
+ 'sample.txt',
+ exactSize: 18,
+ callback: function () {
+ return fopen('...');
+ }
+ );
+
+ // Read resulting file size
+ $size = $zip->finish();
+
+ // Tell it to the browser
+ header('Content-Length: '. $size);
+
+ // Execute the Simulation and stream the actual zip to the client
+ $zip->executeSimulation();
+
diff --git a/api/vendor/maennchen/zipstream-php/guides/FlySystem.rst b/api/vendor/maennchen/zipstream-php/guides/FlySystem.rst
new file mode 100644
index 00000000..4e6c6fb8
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/guides/FlySystem.rst
@@ -0,0 +1,34 @@
+Usage with FlySystem
+===============
+
+For saving or uploading the generated zip, you can use the
+`Flysystem `_ package, and its many
+adapters.
+
+For that you will need to provide another stream than the ``php://output``
+default one, and pass it to Flysystem ``putStream`` method.
+
+.. code-block:: php
+
+ // Open Stream only once for read and write since it's a memory stream and
+ // the content is lost when closing the stream / opening another one
+ $tempStream = fopen('php://memory', 'w+');
+
+ // Create Zip Archive
+ $zipStream = new ZipStream(
+ outputStream: $tempStream,
+ outputName: 'test.zip',
+ );
+ $zipStream->addFile('test.txt', 'text');
+ $zipStream->finish();
+
+ // Store File
+ // (see Flysystem documentation, and all its framework integration)
+ // Can be any adapter (AWS, Google, Ftp, etc.)
+ $adapter = new Local(__DIR__.'/path/to/folder');
+ $filesystem = new Filesystem($adapter);
+
+ $filesystem->writeStream('test.zip', $tempStream)
+
+ // Close Stream
+ fclose($tempStream);
diff --git a/api/vendor/maennchen/zipstream-php/guides/Nginx.rst b/api/vendor/maennchen/zipstream-php/guides/Nginx.rst
new file mode 100644
index 00000000..c53d3000
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/guides/Nginx.rst
@@ -0,0 +1,16 @@
+Usage with nginx
+=============
+
+If you are using nginx as a webserver, it will try to buffer the response.
+So you'll want to disable this with a custom header:
+
+.. code-block:: php
+ header('X-Accel-Buffering: no');
+ # or with the Response class from Symfony
+ $response->headers->set('X-Accel-Buffering', 'no');
+
+Alternatively, you can tweak the
+`fastcgi cache parameters `_
+within nginx config.
+
+See `original issue `_.
\ No newline at end of file
diff --git a/api/vendor/maennchen/zipstream-php/guides/Options.rst b/api/vendor/maennchen/zipstream-php/guides/Options.rst
new file mode 100644
index 00000000..5e92e94d
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/guides/Options.rst
@@ -0,0 +1,66 @@
+Available options
+===============
+
+Here is the full list of options available to you. You can also have a look at
+``src/ZipStream.php`` file.
+
+.. code-block:: php
+
+ use ZipStream\ZipStream;
+
+ require_once 'vendor/autoload.php';
+
+ $zip = new ZipStream(
+ // Define output stream
+ // (argument is eiter a resource or implementing
+ // `Psr\Http\Message\StreamInterface`)
+ //
+ // Setup with `psr/http-message` & `guzzlehttp/psr7` dependencies
+ // required when using `Psr\Http\Message\StreamInterface`.
+ outputStream: $filePointer,
+
+ // Set the deflate level (default is 6; use -1 to disable it)
+ defaultDeflateLevel: 6,
+
+ // Add a comment to the zip file
+ comment: 'This is a comment.',
+
+ // Send http headers (default is true)
+ sendHttpHeaders: false,
+
+ // HTTP Content-Disposition.
+ // Defaults to 'attachment', where FILENAME is the specified filename.
+ // Note that this does nothing if you are not sending HTTP headers.
+ contentDisposition: 'attachment',
+
+ // Output Name for HTTP Content-Disposition
+ // Defaults to no name
+ outputName: "example.zip",
+
+ // HTTP Content-Type.
+ // Defaults to 'application/x-zip'.
+ // Note that this does nothing if you are not sending HTTP headers.
+ contentType: 'application/x-zip',
+
+ // Set the function called for setting headers.
+ // Default is the `header()` of PHP
+ httpHeaderCallback: header(...),
+
+ // Enable streaming files with single read where general purpose bit 3
+ // indicates local file header contain zero values in crc and size
+ // fields, these appear only after file contents in data descriptor
+ // block.
+ // Set to true if your input stream is remote
+ // (used with addFileFromStream()).
+ // Default is false.
+ defaultEnableZeroHeader: false,
+
+ // Enable zip64 extension, allowing very large archives
+ // (> 4Gb or file count > 64k)
+ // Default is true
+ enableZip64: true,
+
+ // Flush output buffer after every write
+ // Default is false
+ flushOutput: true,
+ );
diff --git a/api/vendor/maennchen/zipstream-php/guides/PSR7Streams.rst b/api/vendor/maennchen/zipstream-php/guides/PSR7Streams.rst
new file mode 100644
index 00000000..22af71d4
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/guides/PSR7Streams.rst
@@ -0,0 +1,21 @@
+Usage with PSR 7 Streams
+===============
+
+PSR-7 streams are `standardized streams `_.
+
+ZipStream-PHP supports working with these streams with the function
+``addFileFromPsr7Stream``.
+
+For all parameters of the function see the API documentation.
+
+Example
+---------------
+
+.. code-block:: php
+
+ $stream = $response->getBody();
+ // add a file named 'streamfile.txt' from the content of the stream
+ $zip->addFileFromPsr7Stream(
+ fileName: 'streamfile.txt',
+ stream: $stream,
+ );
diff --git a/api/vendor/maennchen/zipstream-php/guides/StreamOutput.rst b/api/vendor/maennchen/zipstream-php/guides/StreamOutput.rst
new file mode 100644
index 00000000..9f3165b7
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/guides/StreamOutput.rst
@@ -0,0 +1,39 @@
+Stream Output
+===============
+
+Stream to S3 Bucket
+---------------
+
+.. code-block:: php
+
+ use Aws\S3\S3Client;
+ use Aws\Credentials\CredentialProvider;
+ use ZipStream\ZipStream;
+
+ $bucket = 'your bucket name';
+ $client = new S3Client([
+ 'region' => 'your region',
+ 'version' => 'latest',
+ 'bucketName' => $bucket,
+ 'credentials' => CredentialProvider::defaultProvider(),
+ ]);
+ $client->registerStreamWrapper();
+
+ $zipFile = fopen("s3://$bucket/example.zip", 'w');
+
+ $zip = new ZipStream(
+ enableZip64: false,
+ outputStream: $zipFile,
+ );
+
+ $zip->addFile(
+ fileName: 'file1.txt',
+ data: 'File1 data',
+ );
+ $zip->addFile(
+ fileName: 'file2.txt',
+ data: 'File2 data',
+ );
+ $zip->finish();
+
+ fclose($zipFile);
diff --git a/api/vendor/maennchen/zipstream-php/guides/Symfony.rst b/api/vendor/maennchen/zipstream-php/guides/Symfony.rst
new file mode 100644
index 00000000..902552c9
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/guides/Symfony.rst
@@ -0,0 +1,130 @@
+Usage with Symfony
+===============
+
+Overview for using ZipStream in Symfony
+--------
+
+Using ZipStream in Symfony requires use of Symfony's ``StreamedResponse`` when
+used in controller actions.
+
+Wrap your call to the relevant ``ZipStream`` stream method (i.e. ``addFile``,
+``addFileFromPath``, ``addFileFromStream``) in Symfony's ``StreamedResponse``
+function passing in any required arguments for your use case.
+
+Using Symfony's ``StreamedResponse`` will allow Symfony to stream output from
+ZipStream correctly to users' browsers and avoid a corrupted final zip landing
+on the users' end.
+
+Example for using ``ZipStream`` in a controller action to zip stream files
+stored in an AWS S3 bucket by key:
+
+.. code-block:: php
+
+ use Symfony\Component\HttpFoundation\StreamedResponse;
+ use Aws\S3\S3Client;
+ use ZipStream;
+
+ //...
+
+ /**
+ * @Route("/zipstream", name="zipstream")
+ */
+ public function zipStreamAction()
+ {
+ // sample test file on s3
+ $s3keys = array(
+ "ziptestfolder/file1.txt"
+ );
+
+ $s3Client = $this->get('app.amazon.s3'); //s3client service
+ $s3Client->registerStreamWrapper(); //required
+
+ // using StreamedResponse to wrap ZipStream functionality
+ // for files on AWS s3.
+ $response = new StreamedResponse(function() use($s3keys, $s3Client)
+ {
+ // Define suitable options for ZipStream Archive.
+ // this is needed to prevent issues with truncated zip files
+ //initialise zipstream with output zip filename and options.
+ $zip = new ZipStream\ZipStream(
+ outputName: 'test.zip',
+ defaultEnableZeroHeader: true,
+ contentType: 'application/octet-stream',
+ );
+
+ //loop keys - useful for multiple files
+ foreach ($s3keys as $key) {
+ // Get the file name in S3 key so we can save it to the zip
+ //file using the same name.
+ $fileName = basename($key);
+
+ // concatenate s3path.
+ // replace with your bucket name or get from parameters file.
+ $bucket = 'bucketname';
+ $s3path = "s3://" . $bucket . "/" . $key;
+
+ //addFileFromStream
+ if ($streamRead = fopen($s3path, 'r')) {
+ $zip->addFileFromStream(
+ fileName: $fileName,
+ stream: $streamRead,
+ );
+ } else {
+ die('Could not open stream for reading');
+ }
+ }
+
+ $zip->finish();
+
+ });
+
+ return $response;
+ }
+
+In the above example, files on AWS S3 are being streamed from S3 to the Symfon
+application via ``fopen`` call when the s3Client has ``registerStreamWrapper``
+applied. This stream is then passed to ``ZipStream`` via the
+``addFileFromStream`` function, which ZipStream then streams as a zip to the
+client browser via Symfony's ``StreamedResponse``. No Zip is created server
+side, which makes this approach a more efficient solution for streaming zips to
+the client browser especially for larger files.
+
+For the above use case you will need to have installed
+`aws/aws-sdk-php-symfony `_ to
+support accessing S3 objects in your Symfony web application. This is not
+required for locally stored files on you server you intend to stream via
+``ZipStream``.
+
+See official Symfony documentation for details on
+`Symfony's StreamedResponse `_
+``Symfony\Component\HttpFoundation\StreamedResponse``.
+
+Note from `S3 documentation `_:
+
+ Streams opened in "r" mode only allow data to be read from the stream, and
+ are not seekable by default. This is so that data can be downloaded from
+ Amazon S3 in a truly streaming manner, where previously read bytes do not
+ need to be buffered into memory. If you need a stream to be seekable, you
+ can pass seekable into the stream context options of a function.
+
+Make sure to configure your S3 context correctly!
+
+Uploading a file
+--------
+
+You need to add correct permissions
+(see `#120 `_)
+
+**example code**
+
+
+.. code-block:: php
+
+ $path = "s3://{$adapter->getBucket()}/{$this->getArchivePath()}";
+
+ // the important bit
+ $outputContext = stream_context_create([
+ 's3' => ['ACL' => 'public-read'],
+ ]);
+
+ fopen($path, 'w', null, $outputContext);
diff --git a/api/vendor/maennchen/zipstream-php/guides/Varnish.rst b/api/vendor/maennchen/zipstream-php/guides/Varnish.rst
new file mode 100644
index 00000000..952d2874
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/guides/Varnish.rst
@@ -0,0 +1,22 @@
+Usage with Varnish
+=============
+
+Serving a big zip with varnish in between can cause random stream close.
+This can be solved by adding attached code to the vcl file.
+
+To avoid the problem, add the following to your varnish config file:
+
+.. code-block::
+ sub vcl_recv {
+ # Varnish can’t intercept the discussion anymore
+ # helps for streaming big zips
+ if (req.url ~ "\.(tar|gz|zip|7z|exe)$") {
+ return (pipe);
+ }
+ }
+ # Varnish can’t intercept the discussion anymore
+ # helps for streaming big zips
+ sub vcl_pipe {
+ set bereq.http.connection = "close";
+ return (pipe);
+ }
diff --git a/api/vendor/maennchen/zipstream-php/guides/index.rst b/api/vendor/maennchen/zipstream-php/guides/index.rst
new file mode 100644
index 00000000..48f465ae
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/guides/index.rst
@@ -0,0 +1,126 @@
+ZipStream PHP
+=============
+
+A fast and simple streaming zip file downloader for PHP. Using this library will
+save you from having to write the Zip to disk. You can directly send it to the
+user, which is much faster. It can work with S3 buckets or any PSR7 Stream.
+
+.. toctree::
+
+ index
+ Symfony
+ Options
+ StreamOutput
+ FlySystem
+ PSR7Streams
+ Nginx
+ Varnish
+ ContentLength
+
+Installation
+---------------
+
+Simply add a dependency on ``maennchen/zipstream-php`` to your project's
+``composer.json`` file if you use Composer to manage the dependencies of your
+project. Use following command to add the package to your project's
+dependencies:
+
+.. code-block:: sh
+ composer require maennchen/zipstream-php
+
+If you want to use``addFileFromPsr7Stream```
+(``Psr\Http\Message\StreamInterface``) or use a stream instead of a
+``resource`` as ``outputStream``, the following dependencies must be installed
+as well:
+
+.. code-block:: sh
+ composer require psr/http-message guzzlehttp/psr7
+
+If ``composer install`` yields the following error, your installation is missing
+the `mbstring extension `_,
+either `install it `_
+or run the follwoing command:
+
+.. code-block::
+ Your requirements could not be resolved to an installable set of packages.
+
+ Problem 1
+ - Root composer.json requires PHP extension ext-mbstring * but it is
+ missing from your system. Install or enable PHP's mbstrings extension.
+
+.. code-block:: sh
+ composer require symfony/polyfill-mbstring
+
+Usage Intro
+---------------
+
+Here's a simple example:
+
+.. code-block:: php
+
+ // Autoload the dependencies
+ require 'vendor/autoload.php';
+
+ // create a new zipstream object
+ $zip = new ZipStream\ZipStream(
+ outputName: 'example.zip',
+
+ // enable output of HTTP headers
+ sendHttpHeaders: true,
+ );
+
+ // create a file named 'hello.txt'
+ $zip->addFile(
+ fileName: 'hello.txt',
+ data: 'This is the contents of hello.txt',
+ );
+
+ // add a file named 'some_image.jpg' from a local file 'path/to/image.jpg'
+ $zip->addFileFromPath(
+ fileName: 'some_image.jpg',
+ path: 'path/to/image.jpg',
+ );
+
+ // add a file named 'goodbye.txt' from an open stream resource
+ $filePointer = tmpfile();
+ fwrite($filePointer, 'The quick brown fox jumped over the lazy dog.');
+ rewind($filePointer);
+ $zip->addFileFromStream(
+ fileName: 'goodbye.txt',
+ stream: $filePointer,
+ );
+ fclose($filePointer);
+
+ // add a file named 'streamfile.txt' from the body of a `guzzle` response
+ // Setup with `psr/http-message` & `guzzlehttp/psr7` dependencies required.
+ $zip->addFileFromPsr7Stream(
+ fileName: 'streamfile.txt',
+ stream: $response->getBody(),
+ );
+
+ // finish the zip stream
+ $zip->finish();
+
+You can also add comments, modify file timestamps, and customize (or
+disable) the HTTP headers. It is also possible to specify the storage method
+when adding files, the current default storage method is ``DEFLATE``
+i.e files are stored with Compression mode 0x08.
+
+Known Issues
+---------------
+
+The native Mac OS archive extraction tool prior to macOS 10.15 might not open
+archives in some conditions. A workaround is to disable the Zip64 feature with
+the option ``enableZip64: false``. This limits the archive to 4 Gb and 64k files
+but will allow users on macOS 10.14 and below to open them without issue.
+See `#116 `_.
+
+The linux ``unzip`` utility might not handle properly unicode characters.
+It is recommended to extract with another tool like
+`7-zip `_.
+See `#146 `_.
+
+It is the responsability of the client code to make sure that files are not
+saved with the same path, as it is not possible for the library to figure it out
+while streaming a zip.
+See `#154 `_.
diff --git a/api/vendor/maennchen/zipstream-php/phpdoc.dist.xml b/api/vendor/maennchen/zipstream-php/phpdoc.dist.xml
new file mode 100644
index 00000000..b98fe1cd
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/phpdoc.dist.xml
@@ -0,0 +1,39 @@
+
+
+ 💾 ZipStream-PHP
+
+ docs
+
+
+ latest
+
+
+ src
+
+ api
+
+ tests/**/*
+ vendor/**/*
+
+
+ php
+
+ public
+ ZipStream
+ true
+
+
+
+ guides
+
+ guide
+
+
+
+
+
\ No newline at end of file
diff --git a/api/vendor/maennchen/zipstream-php/phpunit.xml.dist b/api/vendor/maennchen/zipstream-php/phpunit.xml.dist
new file mode 100644
index 00000000..1b02a3af
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/phpunit.xml.dist
@@ -0,0 +1,15 @@
+
+
+
+
+
+ test
+
+
+
+
+
+ src
+
+
+
diff --git a/api/vendor/maennchen/zipstream-php/psalm.xml b/api/vendor/maennchen/zipstream-php/psalm.xml
new file mode 100644
index 00000000..56af0e66
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/psalm.xml
@@ -0,0 +1,25 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/api/vendor/maennchen/zipstream-php/src/CentralDirectoryFileHeader.php b/api/vendor/maennchen/zipstream-php/src/CentralDirectoryFileHeader.php
new file mode 100644
index 00000000..ffcfc6e9
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/src/CentralDirectoryFileHeader.php
@@ -0,0 +1,52 @@
+value),
+ new PackField(format: 'V', value: Time::dateTimeToDosTime($lastModificationDateTime)),
+ new PackField(format: 'V', value: $crc32),
+ new PackField(format: 'V', value: $compressedSize),
+ new PackField(format: 'V', value: $uncompressedSize),
+ new PackField(format: 'v', value: strlen($fileName)),
+ new PackField(format: 'v', value: strlen($extraField)),
+ new PackField(format: 'v', value: strlen($fileComment)),
+ new PackField(format: 'v', value: $diskNumberStart),
+ new PackField(format: 'v', value: $internalFileAttributes),
+ new PackField(format: 'V', value: $externalFileAttributes),
+ new PackField(format: 'V', value: $relativeOffsetOfLocalHeader),
+ ) . $fileName . $extraField . $fileComment;
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/src/CompressionMethod.php b/api/vendor/maennchen/zipstream-php/src/CompressionMethod.php
new file mode 100644
index 00000000..51e43637
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/src/CompressionMethod.php
@@ -0,0 +1,106 @@
+format(DateTimeInterface::ATOM) . " can't be represented as DOS time / date.");
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/src/Exception/FileNotFoundException.php b/api/vendor/maennchen/zipstream-php/src/Exception/FileNotFoundException.php
new file mode 100644
index 00000000..350a7bfe
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/src/Exception/FileNotFoundException.php
@@ -0,0 +1,22 @@
+resource = $resource;
+ parent::__construct('Function ' . $function . 'failed on resource.');
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/src/Exception/SimulationFileUnknownException.php b/api/vendor/maennchen/zipstream-php/src/Exception/SimulationFileUnknownException.php
new file mode 100644
index 00000000..717c1aaf
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/src/Exception/SimulationFileUnknownException.php
@@ -0,0 +1,19 @@
+fileName = self::filterFilename($fileName);
+ $this->checkEncoding();
+
+ if ($this->enableZeroHeader) {
+ $this->generalPurposeBitFlag |= GeneralPurposeBitFlag::ZERO_HEADER;
+ }
+
+ $this->version = $this->compressionMethod === CompressionMethod::DEFLATE ? Version::DEFLATE : Version::STORE;
+ }
+
+ public function cloneSimulationExecution(): self
+ {
+ return new self(
+ $this->fileName,
+ $this->dataCallback,
+ OperationMode::NORMAL,
+ $this->startOffset,
+ $this->compressionMethod,
+ $this->comment,
+ $this->lastModificationDateTime,
+ $this->deflateLevel,
+ $this->maxSize,
+ $this->exactSize,
+ $this->enableZip64,
+ $this->enableZeroHeader,
+ $this->send,
+ $this->recordSentBytes,
+ );
+ }
+
+ public function process(): string
+ {
+ $forecastSize = $this->forecastSize();
+
+ if ($this->enableZeroHeader) {
+ // No calculation required
+ } elseif ($this->isSimulation() && $forecastSize !== null) {
+ $this->uncompressedSize = $forecastSize;
+ $this->compressedSize = $forecastSize;
+ } else {
+ $this->readStream(send: false);
+ if (rewind($this->unpackStream()) === false) {
+ throw new ResourceActionException('rewind', $this->unpackStream());
+ }
+ }
+
+ $this->addFileHeader();
+
+ $detectedSize = $forecastSize ?? ($this->compressedSize > 0 ? $this->compressedSize : null);
+
+ if (
+ $this->isSimulation() &&
+ $detectedSize !== null
+ ) {
+ $this->uncompressedSize = $detectedSize;
+ $this->compressedSize = $detectedSize;
+ ($this->recordSentBytes)($detectedSize);
+ } else {
+ $this->readStream(send: true);
+ }
+
+ $this->addFileFooter();
+ return $this->getCdrFile();
+ }
+
+ /**
+ * @return resource
+ */
+ private function unpackStream()
+ {
+ if ($this->stream) {
+ return $this->stream;
+ }
+
+ if ($this->operationMode === OperationMode::SIMULATE_STRICT) {
+ throw new SimulationFileUnknownException();
+ }
+
+ $this->stream = ($this->dataCallback)();
+
+ if (!$this->enableZeroHeader && !stream_get_meta_data($this->stream)['seekable']) {
+ throw new StreamNotSeekableException();
+ }
+ if (!(
+ str_contains(stream_get_meta_data($this->stream)['mode'], 'r')
+ || str_contains(stream_get_meta_data($this->stream)['mode'], 'w+')
+ || str_contains(stream_get_meta_data($this->stream)['mode'], 'a+')
+ || str_contains(stream_get_meta_data($this->stream)['mode'], 'x+')
+ || str_contains(stream_get_meta_data($this->stream)['mode'], 'c+')
+ )) {
+ throw new StreamNotReadableException();
+ }
+
+ return $this->stream;
+ }
+
+ private function forecastSize(): ?int
+ {
+ if ($this->compressionMethod !== CompressionMethod::STORE) {
+ return null;
+ }
+ if ($this->exactSize !== null) {
+ return $this->exactSize;
+ }
+ $fstat = fstat($this->unpackStream());
+ if (!$fstat || !array_key_exists('size', $fstat) || $fstat['size'] < 1) {
+ return null;
+ }
+
+ if ($this->maxSize !== null && $this->maxSize < $fstat['size']) {
+ return $this->maxSize;
+ }
+
+ return $fstat['size'];
+ }
+
+ /**
+ * Create and send zip header for this file.
+ */
+ private function addFileHeader(): void
+ {
+ $forceEnableZip64 = $this->enableZeroHeader && $this->enableZip64;
+
+ $footer = $this->buildZip64ExtraBlock($forceEnableZip64);
+
+ $zip64Enabled = $footer !== '';
+
+ if ($zip64Enabled) {
+ $this->version = Version::ZIP64;
+ }
+
+ if ($this->generalPurposeBitFlag & GeneralPurposeBitFlag::EFS) {
+ // Put the tricky entry to
+ // force Linux unzip to lookup EFS flag.
+ $footer .= Zs\ExtendedInformationExtraField::generate();
+ }
+
+ $data = LocalFileHeader::generate(
+ versionNeededToExtract: $this->version->value,
+ generalPurposeBitFlag: $this->generalPurposeBitFlag,
+ compressionMethod: $this->compressionMethod,
+ lastModificationDateTime: $this->lastModificationDateTime,
+ crc32UncompressedData: $this->crc,
+ compressedSize: $zip64Enabled
+ ? 0xFFFFFFFF
+ : $this->compressedSize,
+ uncompressedSize: $zip64Enabled
+ ? 0xFFFFFFFF
+ : $this->uncompressedSize,
+ fileName: $this->fileName,
+ extraField: $footer,
+ );
+
+
+ ($this->send)($data);
+ }
+
+ /**
+ * Strip characters that are not legal in Windows filenames
+ * to prevent compatibility issues
+ */
+ private static function filterFilename(
+ /**
+ * Unprocessed filename
+ */
+ string $fileName
+ ): string {
+ // strip leading slashes from file name
+ // (fixes bug in windows archive viewer)
+ $fileName = ltrim($fileName, '/');
+
+ return str_replace(['\\', ':', '*', '?', '"', '<', '>', '|'], '_', $fileName);
+ }
+
+ private function checkEncoding(): void
+ {
+ // Sets Bit 11: Language encoding flag (EFS). If this bit is set,
+ // the filename and comment fields for this file
+ // MUST be encoded using UTF-8. (see APPENDIX D)
+ if (mb_check_encoding($this->fileName, 'UTF-8') &&
+ mb_check_encoding($this->comment, 'UTF-8')) {
+ $this->generalPurposeBitFlag |= GeneralPurposeBitFlag::EFS;
+ }
+ }
+
+ private function buildZip64ExtraBlock(bool $force = false): string
+ {
+ $outputZip64ExtraBlock = false;
+
+ $originalSize = null;
+ if ($force || $this->uncompressedSize > 0xFFFFFFFF) {
+ $outputZip64ExtraBlock = true;
+ $originalSize = $this->uncompressedSize;
+ }
+
+ $compressedSize = null;
+ if ($force || $this->compressedSize > 0xFFFFFFFF) {
+ $outputZip64ExtraBlock = true;
+ $compressedSize = $this->compressedSize;
+ }
+
+ // If this file will start over 4GB limit in ZIP file,
+ // CDR record will have to use Zip64 extension to describe offset
+ // to keep consistency we use the same value here
+ $relativeHeaderOffset = null;
+ if ($this->startOffset > 0xFFFFFFFF) {
+ $outputZip64ExtraBlock = true;
+ $relativeHeaderOffset = $this->startOffset;
+ }
+
+ if (!$outputZip64ExtraBlock) {
+ return '';
+ }
+
+ if (!$this->enableZip64) {
+ throw new OverflowException();
+ }
+
+ return Zip64\ExtendedInformationExtraField::generate(
+ originalSize: $originalSize,
+ compressedSize: $compressedSize,
+ relativeHeaderOffset: $relativeHeaderOffset,
+ diskStartNumber: null,
+ );
+ }
+
+ private function addFileFooter(): void
+ {
+ if (($this->compressedSize > 0xFFFFFFFF || $this->uncompressedSize > 0xFFFFFFFF) && $this->version !== Version::ZIP64) {
+ throw new OverflowException();
+ }
+
+ if (!$this->enableZeroHeader) {
+ return;
+ }
+
+ if ($this->version === Version::ZIP64) {
+ $footer = Zip64\DataDescriptor::generate(
+ crc32UncompressedData: $this->crc,
+ compressedSize: $this->compressedSize,
+ uncompressedSize: $this->uncompressedSize,
+ );
+ } else {
+ $footer = DataDescriptor::generate(
+ crc32UncompressedData: $this->crc,
+ compressedSize: $this->compressedSize,
+ uncompressedSize: $this->uncompressedSize,
+ );
+ }
+
+ ($this->send)($footer);
+ }
+
+ private function readStream(bool $send): void
+ {
+ $this->compressedSize = 0;
+ $this->uncompressedSize = 0;
+ $hash = hash_init('crc32b');
+
+ $deflate = $this->compressionInit();
+
+ while (
+ !feof($this->unpackStream()) &&
+ ($this->maxSize === null || $this->uncompressedSize < $this->maxSize) &&
+ ($this->exactSize === null || $this->uncompressedSize < $this->exactSize)
+ ) {
+ $readLength = min(
+ ($this->maxSize ?? PHP_INT_MAX) - $this->uncompressedSize,
+ ($this->exactSize ?? PHP_INT_MAX) - $this->uncompressedSize,
+ self::CHUNKED_READ_BLOCK_SIZE
+ );
+
+ $data = fread($this->unpackStream(), $readLength);
+
+ if ($data === false) {
+ throw new ResourceActionException('fread', $this->unpackStream());
+ }
+
+ hash_update($hash, $data);
+
+ $this->uncompressedSize += strlen($data);
+
+ if ($deflate) {
+ $data = deflate_add(
+ $deflate,
+ $data,
+ feof($this->unpackStream()) ? ZLIB_FINISH : ZLIB_NO_FLUSH
+ );
+
+ if ($data === false) {
+ throw new RuntimeException('deflate_add failed');
+ }
+ }
+
+ $this->compressedSize += strlen($data);
+
+ if ($send) {
+ ($this->send)($data);
+ }
+ }
+
+ if ($this->exactSize !== null && $this->uncompressedSize !== $this->exactSize) {
+ throw new FileSizeIncorrectException(expectedSize: $this->exactSize, actualSize: $this->uncompressedSize);
+ }
+
+ $this->crc = hexdec(hash_final($hash));
+ }
+
+ private function compressionInit(): ?DeflateContext
+ {
+ switch ($this->compressionMethod) {
+ case CompressionMethod::STORE:
+ // Noting to do
+ return null;
+ case CompressionMethod::DEFLATE:
+ $deflateContext = deflate_init(
+ ZLIB_ENCODING_RAW,
+ ['level' => $this->deflateLevel]
+ );
+
+ if (!$deflateContext) {
+ // @codeCoverageIgnoreStart
+ throw new RuntimeException("Can't initialize deflate context.");
+ // @codeCoverageIgnoreEnd
+ }
+
+ // False positive, resource is no longer returned from this function
+ return $deflateContext;
+ default:
+ // @codeCoverageIgnoreStart
+ throw new RuntimeException('Unsupported Compression Method ' . print_r($this->compressionMethod, true));
+ // @codeCoverageIgnoreEnd
+ }
+ }
+
+ private function getCdrFile(): string
+ {
+ $footer = $this->buildZip64ExtraBlock();
+
+ return CentralDirectoryFileHeader::generate(
+ versionMadeBy: ZipStream::ZIP_VERSION_MADE_BY,
+ versionNeededToExtract: $this->version->value,
+ generalPurposeBitFlag: $this->generalPurposeBitFlag,
+ compressionMethod: $this->compressionMethod,
+ lastModificationDateTime: $this->lastModificationDateTime,
+ crc32: $this->crc,
+ compressedSize: $this->compressedSize > 0xFFFFFFFF
+ ? 0xFFFFFFFF
+ : $this->compressedSize,
+ uncompressedSize: $this->uncompressedSize > 0xFFFFFFFF
+ ? 0xFFFFFFFF
+ : $this->uncompressedSize,
+ fileName: $this->fileName,
+ extraField: $footer,
+ fileComment: $this->comment,
+ diskNumberStart: 0,
+ internalFileAttributes: 0,
+ externalFileAttributes: 32,
+ relativeOffsetOfLocalHeader: $this->startOffset > 0xFFFFFFFF
+ ? 0xFFFFFFFF
+ : $this->startOffset,
+ );
+ }
+
+ private function isSimulation(): bool
+ {
+ return $this->operationMode === OperationMode::SIMULATE_LAX || $this->operationMode === OperationMode::SIMULATE_STRICT;
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/src/GeneralPurposeBitFlag.php b/api/vendor/maennchen/zipstream-php/src/GeneralPurposeBitFlag.php
new file mode 100644
index 00000000..23a66d88
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/src/GeneralPurposeBitFlag.php
@@ -0,0 +1,89 @@
+value),
+ new PackField(format: 'V', value: Time::dateTimeToDosTime($lastModificationDateTime)),
+ new PackField(format: 'V', value: $crc32UncompressedData),
+ new PackField(format: 'V', value: $compressedSize),
+ new PackField(format: 'V', value: $uncompressedSize),
+ new PackField(format: 'v', value: strlen($fileName)),
+ new PackField(format: 'v', value: strlen($extraField)),
+ ) . $fileName . $extraField;
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/src/OperationMode.php b/api/vendor/maennchen/zipstream-php/src/OperationMode.php
new file mode 100644
index 00000000..dd650f07
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/src/OperationMode.php
@@ -0,0 +1,35 @@
+format;
+ }, '');
+
+ $args = array_map(function (self $field) {
+ switch ($field->format) {
+ case 'V':
+ if ($field->value > self::MAX_V) {
+ throw new RuntimeException(print_r($field->value, true) . ' is larger than 32 bits');
+ }
+ break;
+ case 'v':
+ if ($field->value > self::MAX_v) {
+ throw new RuntimeException(print_r($field->value, true) . ' is larger than 16 bits');
+ }
+ break;
+ case 'P': break;
+ default:
+ break;
+ }
+
+ return $field->value;
+ }, $fields);
+
+ return pack($fmt, ...$args);
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/src/Time.php b/api/vendor/maennchen/zipstream-php/src/Time.php
new file mode 100644
index 00000000..1b4121ca
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/src/Time.php
@@ -0,0 +1,39 @@
+getTimestamp() < $dosMinimumDate->getTimestamp()) {
+ throw new DosTimeOverflowException(dateTime: $dateTime);
+ }
+
+ $dateTime = DateTimeImmutable::createFromInterface($dateTime)->sub(new DateInterval('P1980Y'));
+
+ [$year, $month, $day, $hour, $minute, $second] = explode(' ', $dateTime->format('Y n j G i s'));
+
+ return
+ ((int) $year << 25) |
+ ((int) $month << 21) |
+ ((int) $day << 16) |
+ ((int) $hour << 11) |
+ ((int) $minute << 5) |
+ ((int) $second >> 1);
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/src/Version.php b/api/vendor/maennchen/zipstream-php/src/Version.php
new file mode 100644
index 00000000..c014f8a1
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/src/Version.php
@@ -0,0 +1,12 @@
+addFile(fileName: 'world.txt', data: 'Hello World');
+ *
+ * // add second file
+ * $zip->addFile(fileName: 'moon.txt', data: 'Hello Moon');
+ * ```
+ *
+ * 3. Finish the zip stream:
+ *
+ * ```php
+ * $zip->finish();
+ * ```
+ *
+ * You can also add an archive comment, add comments to individual files,
+ * and adjust the timestamp of files. See the API documentation for each
+ * method below for additional information.
+ *
+ * ## Example
+ *
+ * ```php
+ * // create a new zip stream object
+ * $zip = new ZipStream(outputName: 'some_files.zip');
+ *
+ * // list of local files
+ * $files = array('foo.txt', 'bar.jpg');
+ *
+ * // read and add each file to the archive
+ * foreach ($files as $path)
+ * $zip->addFileFromPath(fileName: $path, $path);
+ *
+ * // write archive footer to stream
+ * $zip->finish();
+ * ```
+ */
+class ZipStream
+{
+ /**
+ * This number corresponds to the ZIP version/OS used (2 bytes)
+ * From: https://www.iana.org/assignments/media-types/application/zip
+ * The upper byte (leftmost one) indicates the host system (OS) for the
+ * file. Software can use this information to determine
+ * the line record format for text files etc. The current
+ * mappings are:
+ *
+ * 0 - MS-DOS and OS/2 (F.A.T. file systems)
+ * 1 - Amiga 2 - VAX/VMS
+ * 3 - *nix 4 - VM/CMS
+ * 5 - Atari ST 6 - OS/2 H.P.F.S.
+ * 7 - Macintosh 8 - Z-System
+ * 9 - CP/M 10 thru 255 - unused
+ *
+ * The lower byte (rightmost one) indicates the version number of the
+ * software used to encode the file. The value/10
+ * indicates the major version number, and the value
+ * mod 10 is the minor version number.
+ * Here we are using 6 for the OS, indicating OS/2 H.P.F.S.
+ * to prevent file permissions issues upon extract (see #84)
+ * 0x603 is 00000110 00000011 in binary, so 6 and 3
+ *
+ * @internal
+ */
+ public const ZIP_VERSION_MADE_BY = 0x603;
+
+ private bool $ready = true;
+
+ private int $offset = 0;
+
+ /**
+ * @var string[]
+ */
+ private array $centralDirectoryRecords = [];
+
+ /**
+ * @var resource
+ */
+ private $outputStream;
+
+ private readonly Closure $httpHeaderCallback;
+
+ /**
+ * @var File[]
+ */
+ private array $recordedSimulation = [];
+
+ /**
+ * Create a new ZipStream object.
+ *
+ * ##### Examples
+ *
+ * ```php
+ * // create a new zip file named 'foo.zip'
+ * $zip = new ZipStream(outputName: 'foo.zip');
+ *
+ * // create a new zip file named 'bar.zip' with a comment
+ * $zip = new ZipStream(
+ * outputName: 'bar.zip',
+ * comment: 'this is a comment for the zip file.',
+ * );
+ * ```
+ *
+ * @param OperationMode $operationMode
+ * The mode can be used to switch between `NORMAL` and `SIMULATION_*` modes.
+ * For details see the `OperationMode` documentation.
+ *
+ * Default to `NORMAL`.
+ *
+ * @param string $comment
+ * Archive Level Comment
+ *
+ * @param StreamInterface|resource|null $outputStream
+ * Override the output of the archive to a different target.
+ *
+ * By default the archive is sent to `STDOUT`.
+ *
+ * @param CompressionMethod $defaultCompressionMethod
+ * How to handle file compression. Legal values are
+ * `CompressionMethod::DEFLATE` (the default), or
+ * `CompressionMethod::STORE`. `STORE` sends the file raw and is
+ * significantly faster, while `DEFLATE` compresses the file and
+ * is much, much slower.
+ *
+ * @param int $defaultDeflateLevel
+ * Default deflation level. Only relevant if `compressionMethod`
+ * is `DEFLATE`.
+ *
+ * See details of [`deflate_init`](https://www.php.net/manual/en/function.deflate-init.php#refsect1-function.deflate-init-parameters)
+ *
+ * @param bool $enableZip64
+ * Enable Zip64 extension, supporting very large
+ * archives (any size > 4 GB or file count > 64k)
+ *
+ * @param bool $defaultEnableZeroHeader
+ * Enable streaming files with single read.
+ *
+ * When the zero header is set, the file is streamed into the output
+ * and the size & checksum are added at the end of the file. This is the
+ * fastest method and uses the least memory. Unfortunately not all
+ * ZIP clients fully support this and can lead to clients reporting
+ * the generated ZIP files as corrupted in combination with other
+ * circumstances. (Zip64 enabled, using UTF8 in comments / names etc.)
+ *
+ * When the zero header is not set, the length & checksum need to be
+ * defined before the file is actually added. To prevent loading all
+ * the data into memory, the data has to be read twice. If the data
+ * which is added is not seekable, this call will fail.
+ *
+ * @param bool $sendHttpHeaders
+ * Boolean indicating whether or not to send
+ * the HTTP headers for this file.
+ *
+ * @param ?Closure $httpHeaderCallback
+ * The method called to send HTTP headers
+ *
+ * @param string|null $outputName
+ * The name of the created archive.
+ *
+ * Only relevant if `$sendHttpHeaders = true`.
+ *
+ * @param string $contentDisposition
+ * HTTP Content-Disposition
+ *
+ * Only relevant if `sendHttpHeaders = true`.
+ *
+ * @param string $contentType
+ * HTTP Content Type
+ *
+ * Only relevant if `sendHttpHeaders = true`.
+ *
+ * @param bool $flushOutput
+ * Enable flush after every write to output stream.
+ *
+ * @return self
+ */
+ public function __construct(
+ private OperationMode $operationMode = OperationMode::NORMAL,
+ private readonly string $comment = '',
+ $outputStream = null,
+ private readonly CompressionMethod $defaultCompressionMethod = CompressionMethod::DEFLATE,
+ private readonly int $defaultDeflateLevel = 6,
+ private readonly bool $enableZip64 = true,
+ private readonly bool $defaultEnableZeroHeader = true,
+ private bool $sendHttpHeaders = true,
+ ?Closure $httpHeaderCallback = null,
+ private readonly ?string $outputName = null,
+ private readonly string $contentDisposition = 'attachment',
+ private readonly string $contentType = 'application/x-zip',
+ private bool $flushOutput = false,
+ ) {
+ $this->outputStream = self::normalizeStream($outputStream);
+ $this->httpHeaderCallback = $httpHeaderCallback ?? header(...);
+ }
+
+ /**
+ * Add a file to the archive.
+ *
+ * ##### File Options
+ *
+ * See {@see addFileFromPsr7Stream()}
+ *
+ * ##### Examples
+ *
+ * ```php
+ * // add a file named 'world.txt'
+ * $zip->addFile(fileName: 'world.txt', data: 'Hello World!');
+ *
+ * // add a file named 'bar.jpg' with a comment and a last-modified
+ * // time of two hours ago
+ * $zip->addFile(
+ * fileName: 'bar.jpg',
+ * data: $data,
+ * comment: 'this is a comment about bar.jpg',
+ * lastModificationDateTime: new DateTime('2 hours ago'),
+ * );
+ * ```
+ *
+ * @param string $data
+ *
+ * contents of file
+ */
+ public function addFile(
+ string $fileName,
+ string $data,
+ string $comment = '',
+ ?CompressionMethod $compressionMethod = null,
+ ?int $deflateLevel = null,
+ ?DateTimeInterface $lastModificationDateTime = null,
+ ?int $maxSize = null,
+ ?int $exactSize = null,
+ ?bool $enableZeroHeader = null,
+ ): void {
+ $this->addFileFromCallback(
+ fileName: $fileName,
+ callback: fn() => $data,
+ comment: $comment,
+ compressionMethod: $compressionMethod,
+ deflateLevel: $deflateLevel,
+ lastModificationDateTime: $lastModificationDateTime,
+ maxSize: $maxSize,
+ exactSize: $exactSize,
+ enableZeroHeader: $enableZeroHeader,
+ );
+ }
+
+ /**
+ * Add a file at path to the archive.
+ *
+ * ##### File Options
+ *
+ * See {@see addFileFromPsr7Stream()}
+ *
+ * ###### Examples
+ *
+ * ```php
+ * // add a file named 'foo.txt' from the local file '/tmp/foo.txt'
+ * $zip->addFileFromPath(
+ * fileName: 'foo.txt',
+ * path: '/tmp/foo.txt',
+ * );
+ *
+ * // add a file named 'bigfile.rar' from the local file
+ * // '/usr/share/bigfile.rar' with a comment and a last-modified
+ * // time of two hours ago
+ * $zip->addFileFromPath(
+ * fileName: 'bigfile.rar',
+ * path: '/usr/share/bigfile.rar',
+ * comment: 'this is a comment about bigfile.rar',
+ * lastModificationDateTime: new DateTime('2 hours ago'),
+ * );
+ * ```
+ *
+ * @throws \ZipStream\Exception\FileNotFoundException
+ * @throws \ZipStream\Exception\FileNotReadableException
+ */
+ public function addFileFromPath(
+ /**
+ * name of file in archive (including directory path).
+ */
+ string $fileName,
+
+ /**
+ * path to file on disk (note: paths should be encoded using
+ * UNIX-style forward slashes -- e.g '/path/to/some/file').
+ */
+ string $path,
+ string $comment = '',
+ ?CompressionMethod $compressionMethod = null,
+ ?int $deflateLevel = null,
+ ?DateTimeInterface $lastModificationDateTime = null,
+ ?int $maxSize = null,
+ ?int $exactSize = null,
+ ?bool $enableZeroHeader = null,
+ ): void {
+ if (!is_readable($path)) {
+ if (!file_exists($path)) {
+ throw new FileNotFoundException($path);
+ }
+ throw new FileNotReadableException($path);
+ }
+
+ $fileTime = filemtime($path);
+ if ($fileTime !== false) {
+ $lastModificationDateTime ??= (new DateTimeImmutable())->setTimestamp($fileTime);
+ }
+
+ $this->addFileFromCallback(
+ fileName: $fileName,
+ callback: function () use ($path) {
+
+ $stream = fopen($path, 'rb');
+
+ if (!$stream) {
+ // @codeCoverageIgnoreStart
+ throw new ResourceActionException('fopen');
+ // @codeCoverageIgnoreEnd
+ }
+
+ return $stream;
+ },
+ comment: $comment,
+ compressionMethod: $compressionMethod,
+ deflateLevel: $deflateLevel,
+ lastModificationDateTime: $lastModificationDateTime,
+ maxSize: $maxSize,
+ exactSize: $exactSize,
+ enableZeroHeader: $enableZeroHeader,
+ );
+ }
+
+ /**
+ * Add an open stream (resource) to the archive.
+ *
+ * ##### File Options
+ *
+ * See {@see addFileFromPsr7Stream()}
+ *
+ * ##### Examples
+ *
+ * ```php
+ * // create a temporary file stream and write text to it
+ * $filePointer = tmpfile();
+ * fwrite($filePointer, 'The quick brown fox jumped over the lazy dog.');
+ *
+ * // add a file named 'streamfile.txt' from the content of the stream
+ * $archive->addFileFromStream(
+ * fileName: 'streamfile.txt',
+ * stream: $filePointer,
+ * );
+ * ```
+ *
+ * @param resource $stream contents of file as a stream resource
+ */
+ public function addFileFromStream(
+ string $fileName,
+ $stream,
+ string $comment = '',
+ ?CompressionMethod $compressionMethod = null,
+ ?int $deflateLevel = null,
+ ?DateTimeInterface $lastModificationDateTime = null,
+ ?int $maxSize = null,
+ ?int $exactSize = null,
+ ?bool $enableZeroHeader = null,
+ ): void {
+ $this->addFileFromCallback(
+ fileName: $fileName,
+ callback: fn() => $stream,
+ comment: $comment,
+ compressionMethod: $compressionMethod,
+ deflateLevel: $deflateLevel,
+ lastModificationDateTime: $lastModificationDateTime,
+ maxSize: $maxSize,
+ exactSize: $exactSize,
+ enableZeroHeader: $enableZeroHeader,
+ );
+ }
+
+ /**
+ * Add an open stream to the archive.
+ *
+ * ##### Examples
+ *
+ * ```php
+ * $stream = $response->getBody();
+ * // add a file named 'streamfile.txt' from the content of the stream
+ * $archive->addFileFromPsr7Stream(
+ * fileName: 'streamfile.txt',
+ * stream: $stream,
+ * );
+ * ```
+ *
+ * @param string $fileName
+ * path of file in archive (including directory)
+ *
+ * @param StreamInterface $stream
+ * contents of file as a stream resource
+ *
+ * @param string $comment
+ * ZIP comment for this file
+ *
+ * @param ?CompressionMethod $compressionMethod
+ * Override `defaultCompressionMethod`
+ *
+ * See {@see __construct()}
+ *
+ * @param ?int $deflateLevel
+ * Override `defaultDeflateLevel`
+ *
+ * See {@see __construct()}
+ *
+ * @param ?DateTimeInterface $lastModificationDateTime
+ * Set last modification time of file.
+ *
+ * Default: `now`
+ *
+ * @param ?int $maxSize
+ * Only read `maxSize` bytes from file.
+ *
+ * The file is considered done when either reaching `EOF`
+ * or the `maxSize`.
+ *
+ * @param ?int $exactSize
+ * Read exactly `exactSize` bytes from file.
+ * If `EOF` is reached before reading `exactSize` bytes, an error will be
+ * thrown. The parameter allows for faster size calculations if the `stream`
+ * does not support `fstat` size or is slow and otherwise known beforehand.
+ *
+ * @param ?bool $enableZeroHeader
+ * Override `defaultEnableZeroHeader`
+ *
+ * See {@see __construct()}
+ */
+ public function addFileFromPsr7Stream(
+ string $fileName,
+ StreamInterface $stream,
+ string $comment = '',
+ ?CompressionMethod $compressionMethod = null,
+ ?int $deflateLevel = null,
+ ?DateTimeInterface $lastModificationDateTime = null,
+ ?int $maxSize = null,
+ ?int $exactSize = null,
+ ?bool $enableZeroHeader = null,
+ ): void {
+ $this->addFileFromCallback(
+ fileName: $fileName,
+ callback: fn() => $stream,
+ comment: $comment,
+ compressionMethod: $compressionMethod,
+ deflateLevel: $deflateLevel,
+ lastModificationDateTime: $lastModificationDateTime,
+ maxSize: $maxSize,
+ exactSize: $exactSize,
+ enableZeroHeader: $enableZeroHeader,
+ );
+ }
+
+ /**
+ * Add a file based on a callback.
+ *
+ * This is useful when you want to simulate a lot of files without keeping
+ * all of the file handles open at the same time.
+ *
+ * ##### Examples
+ *
+ * ```php
+ * foreach($files as $name => $size) {
+ * $archive->addFileFromCallback(
+ * fileName: 'streamfile.txt',
+ * exactSize: $size,
+ * callback: function() use($name): Psr\Http\Message\StreamInterface {
+ * $response = download($name);
+ * return $response->getBody();
+ * }
+ * );
+ * }
+ * ```
+ *
+ * @param string $fileName
+ * path of file in archive (including directory)
+ *
+ * @param Closure $callback
+ * @psalm-param Closure(): (resource|StreamInterface|string) $callback
+ * A callback to get the file contents in the shape of a PHP stream,
+ * a Psr StreamInterface implementation, or a string.
+ *
+ * @param string $comment
+ * ZIP comment for this file
+ *
+ * @param ?CompressionMethod $compressionMethod
+ * Override `defaultCompressionMethod`
+ *
+ * See {@see __construct()}
+ *
+ * @param ?int $deflateLevel
+ * Override `defaultDeflateLevel`
+ *
+ * See {@see __construct()}
+ *
+ * @param ?DateTimeInterface $lastModificationDateTime
+ * Set last modification time of file.
+ *
+ * Default: `now`
+ *
+ * @param ?int $maxSize
+ * Only read `maxSize` bytes from file.
+ *
+ * The file is considered done when either reaching `EOF`
+ * or the `maxSize`.
+ *
+ * @param ?int $exactSize
+ * Read exactly `exactSize` bytes from file.
+ * If `EOF` is reached before reading `exactSize` bytes, an error will be
+ * thrown. The parameter allows for faster size calculations if the `stream`
+ * does not support `fstat` size or is slow and otherwise known beforehand.
+ *
+ * @param ?bool $enableZeroHeader
+ * Override `defaultEnableZeroHeader`
+ *
+ * See {@see __construct()}
+ */
+ public function addFileFromCallback(
+ string $fileName,
+ Closure $callback,
+ string $comment = '',
+ ?CompressionMethod $compressionMethod = null,
+ ?int $deflateLevel = null,
+ ?DateTimeInterface $lastModificationDateTime = null,
+ ?int $maxSize = null,
+ ?int $exactSize = null,
+ ?bool $enableZeroHeader = null,
+ ): void {
+ $file = new File(
+ dataCallback: function () use ($callback, $maxSize) {
+ $data = $callback();
+
+ if (is_resource($data)) {
+ return $data;
+ }
+
+ if ($data instanceof StreamInterface) {
+ return StreamWrapper::getResource($data);
+ }
+
+
+ $stream = fopen('php://memory', 'rw+');
+ if ($stream === false) {
+ // @codeCoverageIgnoreStart
+ throw new ResourceActionException('fopen');
+ // @codeCoverageIgnoreEnd
+ }
+ if ($maxSize !== null && fwrite($stream, $data, $maxSize) === false) {
+ // @codeCoverageIgnoreStart
+ throw new ResourceActionException('fwrite', $stream);
+ // @codeCoverageIgnoreEnd
+ } elseif (fwrite($stream, $data) === false) {
+ // @codeCoverageIgnoreStart
+ throw new ResourceActionException('fwrite', $stream);
+ // @codeCoverageIgnoreEnd
+ }
+ if (rewind($stream) === false) {
+ // @codeCoverageIgnoreStart
+ throw new ResourceActionException('rewind', $stream);
+ // @codeCoverageIgnoreEnd
+ }
+
+ return $stream;
+
+ },
+ send: $this->send(...),
+ recordSentBytes: $this->recordSentBytes(...),
+ operationMode: $this->operationMode,
+ fileName: $fileName,
+ startOffset: $this->offset,
+ compressionMethod: $compressionMethod ?? $this->defaultCompressionMethod,
+ comment: $comment,
+ deflateLevel: $deflateLevel ?? $this->defaultDeflateLevel,
+ lastModificationDateTime: $lastModificationDateTime ?? new DateTimeImmutable(),
+ maxSize: $maxSize,
+ exactSize: $exactSize,
+ enableZip64: $this->enableZip64,
+ enableZeroHeader: $enableZeroHeader ?? $this->defaultEnableZeroHeader,
+ );
+
+ if ($this->operationMode !== OperationMode::NORMAL) {
+ $this->recordedSimulation[] = $file;
+ }
+
+ $this->centralDirectoryRecords[] = $file->process();
+ }
+
+ /**
+ * Add a directory to the archive.
+ *
+ * ##### File Options
+ *
+ * See {@see addFileFromPsr7Stream()}
+ *
+ * ##### Examples
+ *
+ * ```php
+ * // add a directory named 'world/'
+ * $zip->addDirectory(fileName: 'world/');
+ * ```
+ */
+ public function addDirectory(
+ string $fileName,
+ string $comment = '',
+ ?DateTimeInterface $lastModificationDateTime = null,
+ ): void {
+ if (!str_ends_with($fileName, '/')) {
+ $fileName .= '/';
+ }
+
+ $this->addFile(
+ fileName: $fileName,
+ data: '',
+ comment: $comment,
+ compressionMethod: CompressionMethod::STORE,
+ deflateLevel: null,
+ lastModificationDateTime: $lastModificationDateTime,
+ maxSize: 0,
+ exactSize: 0,
+ enableZeroHeader: false,
+ );
+ }
+
+ /**
+ * Executes a previously calculated simulation.
+ *
+ * ##### Example
+ *
+ * ```php
+ * $zip = new ZipStream(
+ * outputName: 'foo.zip',
+ * operationMode: OperationMode::SIMULATE_STRICT,
+ * );
+ *
+ * $zip->addFile('test.txt', 'Hello World');
+ *
+ * $size = $zip->finish();
+ *
+ * header('Content-Length: '. $size);
+ *
+ * $zip->executeSimulation();
+ * ```
+ */
+ public function executeSimulation(): void
+ {
+ if ($this->operationMode !== OperationMode::NORMAL) {
+ throw new RuntimeException('Zip simulation is not finished.');
+ }
+
+ foreach ($this->recordedSimulation as $file) {
+ $this->centralDirectoryRecords[] = $file->cloneSimulationExecution()->process();
+ }
+
+ $this->finish();
+ }
+
+ /**
+ * Write zip footer to stream.
+ *
+ * The clase is left in an unusable state after `finish`.
+ *
+ * ##### Example
+ *
+ * ```php
+ * // write footer to stream
+ * $zip->finish();
+ * ```
+ */
+ public function finish(): int
+ {
+ $centralDirectoryStartOffsetOnDisk = $this->offset;
+ $sizeOfCentralDirectory = 0;
+
+ // add trailing cdr file records
+ foreach ($this->centralDirectoryRecords as $centralDirectoryRecord) {
+ $this->send($centralDirectoryRecord);
+ $sizeOfCentralDirectory += strlen($centralDirectoryRecord);
+ }
+
+ // Add 64bit headers (if applicable)
+ if (count($this->centralDirectoryRecords) >= 0xFFFF ||
+ $centralDirectoryStartOffsetOnDisk > 0xFFFFFFFF ||
+ $sizeOfCentralDirectory > 0xFFFFFFFF) {
+ if (!$this->enableZip64) {
+ throw new OverflowException();
+ }
+
+ $this->send(Zip64\EndOfCentralDirectory::generate(
+ versionMadeBy: self::ZIP_VERSION_MADE_BY,
+ versionNeededToExtract: Version::ZIP64->value,
+ numberOfThisDisk: 0,
+ numberOfTheDiskWithCentralDirectoryStart: 0,
+ numberOfCentralDirectoryEntriesOnThisDisk: count($this->centralDirectoryRecords),
+ numberOfCentralDirectoryEntries: count($this->centralDirectoryRecords),
+ sizeOfCentralDirectory: $sizeOfCentralDirectory,
+ centralDirectoryStartOffsetOnDisk: $centralDirectoryStartOffsetOnDisk,
+ extensibleDataSector: '',
+ ));
+
+ $this->send(Zip64\EndOfCentralDirectoryLocator::generate(
+ numberOfTheDiskWithZip64CentralDirectoryStart: 0x00,
+ zip64centralDirectoryStartOffsetOnDisk: $centralDirectoryStartOffsetOnDisk + $sizeOfCentralDirectory,
+ totalNumberOfDisks: 1,
+ ));
+ }
+
+ // add trailing cdr eof record
+ $numberOfCentralDirectoryEntries = min(count($this->centralDirectoryRecords), 0xFFFF);
+ $this->send(EndOfCentralDirectory::generate(
+ numberOfThisDisk: 0x00,
+ numberOfTheDiskWithCentralDirectoryStart: 0x00,
+ numberOfCentralDirectoryEntriesOnThisDisk: $numberOfCentralDirectoryEntries,
+ numberOfCentralDirectoryEntries: $numberOfCentralDirectoryEntries,
+ sizeOfCentralDirectory: min($sizeOfCentralDirectory, 0xFFFFFFFF),
+ centralDirectoryStartOffsetOnDisk: min($centralDirectoryStartOffsetOnDisk, 0xFFFFFFFF),
+ zipFileComment: $this->comment,
+ ));
+
+ $size = $this->offset;
+
+ // The End
+ $this->clear();
+
+ return $size;
+ }
+
+ /**
+ * @param StreamInterface|resource|null $outputStream
+ * @return resource
+ */
+ private static function normalizeStream($outputStream)
+ {
+ if ($outputStream instanceof StreamInterface) {
+ return StreamWrapper::getResource($outputStream);
+ }
+ if (is_resource($outputStream)) {
+ return $outputStream;
+ }
+ $resource = fopen('php://output', 'wb');
+
+ if ($resource === false) {
+ throw new RuntimeException('fopen of php://output failed');
+ }
+
+ return $resource;
+ }
+
+ /**
+ * Record sent bytes
+ */
+ private function recordSentBytes(int $sentBytes): void
+ {
+ $this->offset += $sentBytes;
+ }
+
+ /**
+ * Send string, sending HTTP headers if necessary.
+ * Flush output after write if configure option is set.
+ */
+ private function send(string $data): void
+ {
+ if (!$this->ready) {
+ throw new RuntimeException('Archive is already finished');
+ }
+
+ if ($this->operationMode === OperationMode::NORMAL && $this->sendHttpHeaders) {
+ $this->sendHttpHeaders();
+ $this->sendHttpHeaders = false;
+ }
+
+ $this->recordSentBytes(strlen($data));
+
+ if ($this->operationMode === OperationMode::NORMAL) {
+ if (fwrite($this->outputStream, $data) === false) {
+ throw new ResourceActionException('fwrite', $this->outputStream);
+ }
+
+ if ($this->flushOutput) {
+ // flush output buffer if it is on and flushable
+ $status = ob_get_status();
+ if (isset($status['flags']) && is_int($status['flags']) && ($status['flags'] & PHP_OUTPUT_HANDLER_FLUSHABLE)) {
+ ob_flush();
+ }
+
+ // Flush system buffers after flushing userspace output buffer
+ flush();
+ }
+ }
+ }
+
+ /**
+ * Send HTTP headers for this stream.
+ */
+ private function sendHttpHeaders(): void
+ {
+ // grab content disposition
+ $disposition = $this->contentDisposition;
+
+ if ($this->outputName !== null) {
+ // Various different browsers dislike various characters here. Strip them all for safety.
+ $safeOutput = trim(str_replace(['"', "'", '\\', ';', "\n", "\r"], '', $this->outputName));
+
+ // Check if we need to UTF-8 encode the filename
+ $urlencoded = rawurlencode($safeOutput);
+ $disposition .= "; filename*=UTF-8''{$urlencoded}";
+ }
+
+ $headers = [
+ 'Content-Type' => $this->contentType,
+ 'Content-Disposition' => $disposition,
+ 'Pragma' => 'public',
+ 'Cache-Control' => 'public, must-revalidate',
+ 'Content-Transfer-Encoding' => 'binary',
+ ];
+
+ foreach ($headers as $key => $val) {
+ ($this->httpHeaderCallback)("$key: $val");
+ }
+ }
+
+ /**
+ * Clear all internal variables. Note that the stream object is not
+ * usable after this.
+ */
+ private function clear(): void
+ {
+ $this->centralDirectoryRecords = [];
+ $this->offset = 0;
+
+ if ($this->operationMode === OperationMode::NORMAL) {
+ $this->ready = false;
+ $this->recordedSimulation = [];
+ } else {
+ $this->operationMode = OperationMode::NORMAL;
+ }
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/src/Zs/ExtendedInformationExtraField.php b/api/vendor/maennchen/zipstream-php/src/Zs/ExtendedInformationExtraField.php
new file mode 100644
index 00000000..bf621bc0
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/src/Zs/ExtendedInformationExtraField.php
@@ -0,0 +1,23 @@
+fail("File {$filePath} must contain {$needle}");
+ }
+
+ protected function assertFileDoesNotContain(string $filePath, string $needle): void
+ {
+ $last = '';
+
+ $handle = fopen($filePath, 'r');
+ while (!feof($handle)) {
+ $line = fgets($handle, 1024);
+
+ if (str_contains($last . $line, $needle)) {
+ fclose($handle);
+
+ $this->fail("File {$filePath} must not contain {$needle}");
+ }
+
+ $last = $line;
+ }
+
+ fclose($handle);
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/CentralDirectoryFileHeaderTest.php b/api/vendor/maennchen/zipstream-php/test/CentralDirectoryFileHeaderTest.php
new file mode 100644
index 00000000..5457b4f4
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/CentralDirectoryFileHeaderTest.php
@@ -0,0 +1,60 @@
+assertSame(
+ bin2hex($header),
+ '504b0102' . // 4 bytes; central file header signature
+ '0306' . // 2 bytes; version made by
+ '2d00' . // 2 bytes; version needed to extract
+ '2222' . // 2 bytes; general purpose bit flag
+ '0800' . // 2 bytes; compression method
+ '2008' . // 2 bytes; last mod file time
+ '2154' . // 2 bytes; last mod file date
+ '11111111' . // 4 bytes; crc-32
+ '77777777' . // 4 bytes; compressed size
+ '99999999' . // 4 bytes; uncompressed size
+ '0800' . // 2 bytes; file name length (n)
+ '0c00' . // 2 bytes; extra field length (m)
+ '0c00' . // 2 bytes; file comment length (o)
+ '0000' . // 2 bytes; disk number start
+ '0000' . // 2 bytes; internal file attributes
+ '20000000' . // 4 bytes; external file attributes
+ '34120000' . // 4 bytes; relative offset of local header
+ '746573742e706e67' . // n bytes; file name
+ '736f6d6520636f6e74656e74' . // m bytes; extra field
+ '736f6d6520636f6d6d656e74' // o bytes; file comment
+ );
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/DataDescriptorTest.php b/api/vendor/maennchen/zipstream-php/test/DataDescriptorTest.php
new file mode 100644
index 00000000..cc886c74
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/DataDescriptorTest.php
@@ -0,0 +1,26 @@
+assertSame(
+ bin2hex(DataDescriptor::generate(
+ crc32UncompressedData: 0x11111111,
+ compressedSize: 0x77777777,
+ uncompressedSize: 0x99999999,
+ )),
+ '504b0708' . // 4 bytes; Optional data descriptor signature = 0x08074b50
+ '11111111' . // 4 bytes; CRC-32 of uncompressed data
+ '77777777' . // 4 bytes; Compressed size
+ '99999999' // 4 bytes; Uncompressed size
+ );
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/EndOfCentralDirectoryTest.php b/api/vendor/maennchen/zipstream-php/test/EndOfCentralDirectoryTest.php
new file mode 100644
index 00000000..be0a9074
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/EndOfCentralDirectoryTest.php
@@ -0,0 +1,35 @@
+assertSame(
+ bin2hex(EndOfCentralDirectory::generate(
+ numberOfThisDisk: 0x00,
+ numberOfTheDiskWithCentralDirectoryStart: 0x00,
+ numberOfCentralDirectoryEntriesOnThisDisk: 0x10,
+ numberOfCentralDirectoryEntries: 0x10,
+ sizeOfCentralDirectory: 0x22,
+ centralDirectoryStartOffsetOnDisk: 0x33,
+ zipFileComment: 'foo',
+ )),
+ '504b0506' . // 4 bytes; end of central dir signature 0x06054b50
+ '0000' . // 2 bytes; number of this disk
+ '0000' . // 2 bytes; number of the disk with the start of the central directory
+ '1000' . // 2 bytes; total number of entries in the central directory on this disk
+ '1000' . // 2 bytes; total number of entries in the central directory
+ '22000000' . // 4 bytes; size of the central directory
+ '33000000' . // 4 bytes; offset of start of central directory with respect to the starting disk number
+ '0300' . // 2 bytes; .ZIP file comment length
+ bin2hex('foo')
+ );
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/EndlessCycleStream.php b/api/vendor/maennchen/zipstream-php/test/EndlessCycleStream.php
new file mode 100644
index 00000000..d9e7df1f
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/EndlessCycleStream.php
@@ -0,0 +1,104 @@
+detach();
+ }
+
+ /**
+ * @return null
+ */
+ public function detach()
+ {
+ return;
+ }
+
+ public function getSize(): ?int
+ {
+ return null;
+ }
+
+ public function tell(): int
+ {
+ return $this->offset;
+ }
+
+ public function eof(): bool
+ {
+ return false;
+ }
+
+ public function isSeekable(): bool
+ {
+ return true;
+ }
+
+ public function seek(int $offset, int $whence = SEEK_SET): void
+ {
+ switch ($whence) {
+ case SEEK_SET:
+ $this->offset = $offset;
+ break;
+ case SEEK_CUR:
+ $this->offset += $offset;
+ break;
+ case SEEK_END:
+ throw new RuntimeException('Infinite Stream!');
+ break;
+ }
+ }
+
+ public function rewind(): void
+ {
+ $this->seek(0);
+ }
+
+ public function isWritable(): bool
+ {
+ return false;
+ }
+
+ public function write(string $string): int
+ {
+ throw new RuntimeException('Not writeable');
+ }
+
+ public function isReadable(): bool
+ {
+ return true;
+ }
+
+ public function read(int $length): string
+ {
+ $this->offset += $length;
+ return substr(str_repeat($this->toRepeat, (int) ceil($length / strlen($this->toRepeat))), 0, $length);
+ }
+
+ public function getContents(): string
+ {
+ throw new RuntimeException('Infinite Stream!');
+ }
+
+ public function getMetadata(?string $key = null): array|null
+ {
+ return $key !== null ? null : [];
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/FaultInjectionResource.php b/api/vendor/maennchen/zipstream-php/test/FaultInjectionResource.php
new file mode 100644
index 00000000..af9305ba
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/FaultInjectionResource.php
@@ -0,0 +1,141 @@
+context);
+
+ if (!isset($options[self::NAME]['injectFaults'])) {
+ return false;
+ }
+
+ $this->mode = $mode;
+ $this->injectFaults = $options[self::NAME]['injectFaults'];
+
+ if ($this->shouldFail(__FUNCTION__)) {
+ return false;
+ }
+
+ return true;
+ }
+
+ public function stream_write(string $data)
+ {
+ if ($this->shouldFail(__FUNCTION__)) {
+ return false;
+ }
+ return true;
+ }
+
+ public function stream_eof()
+ {
+ return true;
+ }
+
+ public function stream_seek(int $offset, int $whence): bool
+ {
+ if ($this->shouldFail(__FUNCTION__)) {
+ return false;
+ }
+
+ return true;
+ }
+
+ public function stream_tell(): int
+ {
+ if ($this->shouldFail(__FUNCTION__)) {
+ return false;
+ }
+
+ return 0;
+ }
+
+ public static function register(): void
+ {
+ if (!in_array(self::NAME, stream_get_wrappers(), true)) {
+ stream_wrapper_register(self::NAME, __CLASS__);
+ }
+ }
+
+ public function stream_stat(): array
+ {
+ static $modeMap = [
+ 'r' => 33060,
+ 'rb' => 33060,
+ 'r+' => 33206,
+ 'w' => 33188,
+ 'wb' => 33188,
+ ];
+
+ return [
+ 'dev' => 0,
+ 'ino' => 0,
+ 'mode' => $modeMap[$this->mode],
+ 'nlink' => 0,
+ 'uid' => 0,
+ 'gid' => 0,
+ 'rdev' => 0,
+ 'size' => 0,
+ 'atime' => 0,
+ 'mtime' => 0,
+ 'ctime' => 0,
+ 'blksize' => 0,
+ 'blocks' => 0,
+ ];
+ }
+
+ public function url_stat(string $path, int $flags): array
+ {
+ return [
+ 'dev' => 0,
+ 'ino' => 0,
+ 'mode' => 0,
+ 'nlink' => 0,
+ 'uid' => 0,
+ 'gid' => 0,
+ 'rdev' => 0,
+ 'size' => 0,
+ 'atime' => 0,
+ 'mtime' => 0,
+ 'ctime' => 0,
+ 'blksize' => 0,
+ 'blocks' => 0,
+ ];
+ }
+
+ private static function createStreamContext(array $injectFaults)
+ {
+ return stream_context_create([
+ self::NAME => ['injectFaults' => $injectFaults],
+ ]);
+ }
+
+ private function shouldFail(string $function): bool
+ {
+ return in_array($function, $this->injectFaults, true);
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/LocalFileHeaderTest.php b/api/vendor/maennchen/zipstream-php/test/LocalFileHeaderTest.php
new file mode 100644
index 00000000..196dd0fe
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/LocalFileHeaderTest.php
@@ -0,0 +1,47 @@
+assertSame(
+ bin2hex((string) $header),
+ '504b0304' . // 4 bytes; Local file header signature
+ '2d00' . // 2 bytes; Version needed to extract (minimum)
+ '2222' . // 2 bytes; General purpose bit flag
+ '0800' . // 2 bytes; Compression method; e.g. none = 0, DEFLATE = 8
+ '2008' . // 2 bytes; File last modification time
+ '2154' . // 2 bytes; File last modification date
+ '11111111' . // 4 bytes; CRC-32 of uncompressed data
+ '77777777' . // 4 bytes; Compressed size (or 0xffffffff for ZIP64)
+ '99999999' . // 4 bytes; Uncompressed size (or 0xffffffff for ZIP64)
+ '0800' . // 2 bytes; File name length (n)
+ '0c00' . // 2 bytes; Extra field length (m)
+ '746573742e706e67' . // n bytes; File name
+ '736f6d6520636f6e74656e74' // m bytes; Extra field
+ );
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/PackFieldTest.php b/api/vendor/maennchen/zipstream-php/test/PackFieldTest.php
new file mode 100644
index 00000000..ecd66bac
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/PackFieldTest.php
@@ -0,0 +1,42 @@
+assertSame(
+ bin2hex(PackField::pack(new PackField(format: 'v', value: 0x1122))),
+ '2211',
+ );
+ }
+
+ public function testOverflow2(): void
+ {
+ $this->expectException(RuntimeException::class);
+
+ PackField::pack(new PackField(format: 'v', value: 0xFFFFF));
+ }
+
+ public function testOverflow4(): void
+ {
+ $this->expectException(RuntimeException::class);
+
+ PackField::pack(new PackField(format: 'V', value: 0xFFFFFFFFF));
+ }
+
+ public function testUnknownOperator(): void
+ {
+ $this->assertSame(
+ bin2hex(PackField::pack(new PackField(format: 'a', value: 0x1122))),
+ '34',
+ );
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/ResourceStream.php b/api/vendor/maennchen/zipstream-php/test/ResourceStream.php
new file mode 100644
index 00000000..752a1a35
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/ResourceStream.php
@@ -0,0 +1,159 @@
+isSeekable()) {
+ $this->seek(0);
+ }
+ return (string) stream_get_contents($this->stream);
+ }
+
+ public function close(): void
+ {
+ $stream = $this->detach();
+ if ($stream) {
+ fclose($stream);
+ }
+ }
+
+ public function detach()
+ {
+ $result = $this->stream;
+ // According to the interface, the stream is left in an unusable state;
+ /** @psalm-suppress PossiblyNullPropertyAssignmentValue */
+ $this->stream = null;
+ return $result;
+ }
+
+ public function seek(int $offset, int $whence = SEEK_SET): void
+ {
+ if (!$this->isSeekable()) {
+ throw new RuntimeException();
+ }
+ if (fseek($this->stream, $offset, $whence) !== 0) {
+ // @codeCoverageIgnoreStart
+ throw new RuntimeException();
+ // @codeCoverageIgnoreEnd
+ }
+ }
+
+ public function isSeekable(): bool
+ {
+ return (bool) $this->getMetadata('seekable');
+ }
+
+ public function getMetadata(?string $key = null)
+ {
+ $metadata = stream_get_meta_data($this->stream);
+ return $key !== null ? @$metadata[$key] : $metadata;
+ }
+
+ public function getSize(): ?int
+ {
+ $stats = fstat($this->stream);
+ return $stats['size'];
+ }
+
+ public function tell(): int
+ {
+ $position = ftell($this->stream);
+ if ($position === false) {
+ // @codeCoverageIgnoreStart
+ throw new RuntimeException();
+ // @codeCoverageIgnoreEnd
+ }
+ return $position;
+ }
+
+ public function eof(): bool
+ {
+ return feof($this->stream);
+ }
+
+ public function rewind(): void
+ {
+ $this->seek(0);
+ }
+
+ public function write(string $string): int
+ {
+ if (!$this->isWritable()) {
+ throw new RuntimeException();
+ }
+ if (fwrite($this->stream, $string) === false) {
+ // @codeCoverageIgnoreStart
+ throw new RuntimeException();
+ // @codeCoverageIgnoreEnd
+ }
+ return strlen($string);
+ }
+
+ public function isWritable(): bool
+ {
+ $mode = $this->getMetadata('mode');
+ if (!is_string($mode)) {
+ // @codeCoverageIgnoreStart
+ throw new RuntimeException('Could not get stream mode from metadata!');
+ // @codeCoverageIgnoreEnd
+ }
+ return preg_match('/[waxc+]/', $mode) === 1;
+ }
+
+ public function read(int $length): string
+ {
+ if (!$this->isReadable()) {
+ throw new RuntimeException();
+ }
+ $result = fread($this->stream, $length);
+ if ($result === false) {
+ // @codeCoverageIgnoreStart
+ throw new RuntimeException();
+ // @codeCoverageIgnoreEnd
+ }
+ return $result;
+ }
+
+ public function isReadable(): bool
+ {
+ $mode = $this->getMetadata('mode');
+ if (!is_string($mode)) {
+ // @codeCoverageIgnoreStart
+ throw new RuntimeException('Could not get stream mode from metadata!');
+ // @codeCoverageIgnoreEnd
+ }
+ return preg_match('/[r+]/', $mode) === 1;
+ }
+
+ public function getContents(): string
+ {
+ if (!$this->isReadable()) {
+ throw new RuntimeException();
+ }
+ $result = stream_get_contents($this->stream);
+ if ($result === false) {
+ // @codeCoverageIgnoreStart
+ throw new RuntimeException();
+ // @codeCoverageIgnoreEnd
+ }
+ return $result;
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/Tempfile.php b/api/vendor/maennchen/zipstream-php/test/Tempfile.php
new file mode 100644
index 00000000..7ef9c61f
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/Tempfile.php
@@ -0,0 +1,42 @@
+getTmpFileStream();
+
+ $this->tempfile = $tempfile;
+ $this->tempfileStream = $tempfileStream;
+ }
+
+ protected function tearDown(): void
+ {
+ unlink($this->tempfile);
+ if (is_resource($this->tempfileStream)) {
+ fclose($this->tempfileStream);
+ }
+
+ $this->tempfile = null;
+ $this->tempfileStream = null;
+ }
+
+ protected function getTmpFileStream(): array
+ {
+ $tmp = tempnam(sys_get_temp_dir(), 'zipstreamtest');
+ $stream = fopen($tmp, 'wb+');
+
+ return [$tmp, $stream];
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/TimeTest.php b/api/vendor/maennchen/zipstream-php/test/TimeTest.php
new file mode 100644
index 00000000..61cfe038
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/TimeTest.php
@@ -0,0 +1,44 @@
+assertSame(
+ Time::dateTimeToDosTime(new DateTimeImmutable('2014-11-17T17:46:08Z')),
+ 1165069764
+ );
+
+ // January 1 1980 - DOS Epoch.
+ $this->assertSame(
+ Time::dateTimeToDosTime(new DateTimeImmutable('1980-01-01T00:00:00+00:00')),
+ 2162688
+ );
+
+ // Local timezone different than UTC.
+ $prevLocalTimezone = date_default_timezone_get();
+ date_default_timezone_set('Europe/Berlin');
+ $this->assertSame(
+ Time::dateTimeToDosTime(new DateTimeImmutable('1980-01-01T00:00:00+00:00')),
+ 2162688
+ );
+ date_default_timezone_set($prevLocalTimezone);
+ }
+
+ public function testTooEarlyDateToDosTime(): void
+ {
+ $this->expectException(DosTimeOverflowException::class);
+
+ // January 1 1980 is the minimum DOS Epoch.
+ Time::dateTimeToDosTime(new DateTimeImmutable('1970-01-01T00:00:00+00:00'));
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/Util.php b/api/vendor/maennchen/zipstream-php/test/Util.php
new file mode 100644
index 00000000..86592b42
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/Util.php
@@ -0,0 +1,127 @@
+cmdExists('hexdump')) {
+ return '';
+ }
+
+ $output = [];
+
+ if (!exec("hexdump -C \"$path\" | head -n 50", $output)) {
+ return '';
+ }
+
+ return "\nHexdump:\n" . implode("\n", $output);
+ }
+
+ protected function validateAndExtractZip(string $zipPath): string
+ {
+ $tmpDir = $this->getTmpDir();
+
+ $zipArchive = new ZipArchive();
+ $result = $zipArchive->open($zipPath);
+
+ if ($result !== true) {
+ $codeName = $this->zipArchiveOpenErrorCodeName($result);
+ $debugInformation = $this->dumpZipContents($zipPath);
+
+ $this->fail("Failed to open {$zipPath}. Code: $result ($codeName)$debugInformation");
+
+ return $tmpDir;
+ }
+
+ $this->assertSame(0, $zipArchive->status);
+ $this->assertSame(0, $zipArchive->statusSys);
+
+ $zipArchive->extractTo($tmpDir);
+ $zipArchive->close();
+
+ return $tmpDir;
+ }
+
+ protected function zipArchiveOpenErrorCodeName(int $code): string
+ {
+ switch ($code) {
+ case ZipArchive::ER_EXISTS: return 'ER_EXISTS';
+ case ZipArchive::ER_INCONS: return 'ER_INCONS';
+ case ZipArchive::ER_INVAL: return 'ER_INVAL';
+ case ZipArchive::ER_MEMORY: return 'ER_MEMORY';
+ case ZipArchive::ER_NOENT: return 'ER_NOENT';
+ case ZipArchive::ER_NOZIP: return 'ER_NOZIP';
+ case ZipArchive::ER_OPEN: return 'ER_OPEN';
+ case ZipArchive::ER_READ: return 'ER_READ';
+ case ZipArchive::ER_SEEK: return 'ER_SEEK';
+ default: return 'unknown';
+ }
+ }
+
+ protected function getTmpDir(): string
+ {
+ $tmp = tempnam(sys_get_temp_dir(), 'zipstreamtest');
+ unlink($tmp);
+ mkdir($tmp) or $this->fail('Failed to make directory');
+
+ return $tmp;
+ }
+
+ /**
+ * @return string[]
+ */
+ protected function getRecursiveFileList(string $path, bool $includeDirectories = false): array
+ {
+ $data = [];
+ $path = (string) realpath($path);
+ $files = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($path));
+
+ $pathLen = strlen($path);
+ foreach ($files as $file) {
+ $filePath = $file->getRealPath();
+
+ if (is_dir($filePath) && !$includeDirectories) {
+ continue;
+ }
+
+ $data[] = substr($filePath, $pathLen + 1);
+ }
+
+ sort($data);
+
+ return $data;
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/Zip64/DataDescriptorTest.php b/api/vendor/maennchen/zipstream-php/test/Zip64/DataDescriptorTest.php
new file mode 100644
index 00000000..49fb2ccb
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/Zip64/DataDescriptorTest.php
@@ -0,0 +1,28 @@
+assertSame(
+ bin2hex($descriptor),
+ '504b0708' . // 4 bytes; Optional data descriptor signature = 0x08074b50
+ '11111111' . // 4 bytes; CRC-32 of uncompressed data
+ '6666666677777777' . // 8 bytes; Compressed size
+ '8888888899999999' // 8 bytes; Uncompressed size
+ );
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/Zip64/EndOfCentralDirectoryLocatorTest.php b/api/vendor/maennchen/zipstream-php/test/Zip64/EndOfCentralDirectoryLocatorTest.php
new file mode 100644
index 00000000..271a2986
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/Zip64/EndOfCentralDirectoryLocatorTest.php
@@ -0,0 +1,28 @@
+assertSame(
+ bin2hex($descriptor),
+ '504b0607' . // 4 bytes; zip64 end of central dir locator signature - 0x07064b50
+ '11111111' . // 4 bytes; number of the disk with the start of the zip64 end of central directory
+ '3333333322222222' . // 28 bytes; relative offset of the zip64 end of central directory record
+ '44444444' // 4 bytes;total number of disks
+ );
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/Zip64/EndOfCentralDirectoryTest.php b/api/vendor/maennchen/zipstream-php/test/Zip64/EndOfCentralDirectoryTest.php
new file mode 100644
index 00000000..b86fb178
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/Zip64/EndOfCentralDirectoryTest.php
@@ -0,0 +1,41 @@
+assertSame(
+ bin2hex($descriptor),
+ '504b0606' . // 4 bytes;zip64 end of central dir signature - 0x06064b50
+ '2f00000000000000' . // 8 bytes; size of zip64 end of central directory record
+ '3333' . // 2 bytes; version made by
+ '4444' . // 2 bytes; version needed to extract
+ '55555555' . // 4 bytes; number of this disk
+ '66666666' . // 4 bytes; number of the disk with the start of the central directory
+ '8888888877777777' . // 8 bytes; total number of entries in the central directory on this disk
+ 'aaaaaaaa99999999' . // 8 bytes; total number of entries in the central directory
+ 'ccccccccbbbbbbbb' . // 8 bytes; size of the central directory
+ 'eeeeeeeedddddddd' . // 8 bytes; offset of start of central directory with respect to the starting disk number
+ bin2hex('foo')
+ );
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/Zip64/ExtendedInformationExtraFieldTest.php b/api/vendor/maennchen/zipstream-php/test/Zip64/ExtendedInformationExtraFieldTest.php
new file mode 100644
index 00000000..904783d8
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/Zip64/ExtendedInformationExtraFieldTest.php
@@ -0,0 +1,42 @@
+assertSame(
+ bin2hex($extraField),
+ '0100' . // 2 bytes; Tag for this "extra" block type
+ '1c00' . // 2 bytes; Size of this "extra" block
+ '6666666677777777' . // 8 bytes; Original uncompressed file size
+ '8888888899999999' . // 8 bytes; Size of compressed data
+ '1111111122222222' . // 8 bytes; Offset of local header record
+ '33333333' // 4 bytes; Number of the disk on which this file starts
+ );
+ }
+
+ public function testSerializesEmptyCorrectly(): void
+ {
+ $extraField = ExtendedInformationExtraField::generate();
+
+ $this->assertSame(
+ bin2hex($extraField),
+ '0100' . // 2 bytes; Tag for this "extra" block type
+ '0000' // 2 bytes; Size of this "extra" block
+ );
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/ZipStreamTest.php b/api/vendor/maennchen/zipstream-php/test/ZipStreamTest.php
new file mode 100644
index 00000000..f4ead1d8
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/ZipStreamTest.php
@@ -0,0 +1,1216 @@
+tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ $zip->addFile('sample.txt', 'Sample String Data');
+ $zip->addFile('test/sample.txt', 'More Simple Sample Data');
+
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+ $this->assertSame(['sample.txt', 'test' . DIRECTORY_SEPARATOR . 'sample.txt'], $files);
+
+ $this->assertStringEqualsFile($tmpDir . '/sample.txt', 'Sample String Data');
+ $this->assertStringEqualsFile($tmpDir . '/test/sample.txt', 'More Simple Sample Data');
+ }
+
+ public function testAddFileUtf8NameComment(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ $name = 'árvíztűrő tükörfúrógép.txt';
+ $content = 'Sample String Data';
+ $comment =
+ 'Filename has every special characters ' .
+ 'from Hungarian language in lowercase. ' .
+ 'In uppercase: ÁÍŰŐÜÖÚÓÉ';
+
+ $zip->addFile(fileName: $name, data: $content, comment: $comment);
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+ $this->assertSame([$name], $files);
+ $this->assertStringEqualsFile($tmpDir . '/' . $name, $content);
+
+ $zipArchive = new ZipArchive();
+ $zipArchive->open($this->tempfile);
+ $this->assertSame($comment, $zipArchive->getCommentName($name));
+ }
+
+ public function testAddFileUtf8NameNonUtfComment(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ $name = 'á.txt';
+ $content = 'any';
+ $comment = mb_convert_encoding('á', 'ISO-8859-2', 'UTF-8');
+
+ // @see https://libzip.org/documentation/zip_file_get_comment.html
+ //
+ // mb_convert_encoding hasn't CP437.
+ // nearly CP850 (DOS-Latin-1)
+ $guessComment = mb_convert_encoding($comment, 'UTF-8', 'CP850');
+
+ $zip->addFile(fileName: $name, data: $content, comment: $comment);
+
+ $zip->finish();
+
+ $zipArch = new ZipArchive();
+ $zipArch->open($this->tempfile);
+ $this->assertSame($guessComment, $zipArch->getCommentName($name));
+ $this->assertSame($comment, $zipArch->getCommentName($name, ZipArchive::FL_ENC_RAW));
+ }
+
+ public function testAddFileWithStorageMethod(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ $zip->addFile(fileName: 'sample.txt', data: 'Sample String Data', compressionMethod: CompressionMethod::STORE);
+ $zip->addFile(fileName: 'test/sample.txt', data: 'More Simple Sample Data');
+ $zip->finish();
+
+ $zipArchive = new ZipArchive();
+ $zipArchive->open($this->tempfile);
+
+ $sample1 = $zipArchive->statName('sample.txt');
+ $sample12 = $zipArchive->statName('test/sample.txt');
+ $this->assertSame($sample1['comp_method'], CompressionMethod::STORE->value);
+ $this->assertSame($sample12['comp_method'], CompressionMethod::DEFLATE->value);
+
+ $zipArchive->close();
+ }
+
+ public function testAddFileFromPath(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ [$tmpExample, $streamExample] = $this->getTmpFileStream();
+ fwrite($streamExample, 'Sample String Data');
+ fclose($streamExample);
+ $zip->addFileFromPath(fileName: 'sample.txt', path: $tmpExample);
+
+ [$tmpExample, $streamExample] = $this->getTmpFileStream();
+ fwrite($streamExample, 'More Simple Sample Data');
+ fclose($streamExample);
+ $zip->addFileFromPath(fileName: 'test/sample.txt', path: $tmpExample);
+
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+ $this->assertSame(['sample.txt', 'test' . DIRECTORY_SEPARATOR . 'sample.txt'], $files);
+
+ $this->assertStringEqualsFile($tmpDir . '/sample.txt', 'Sample String Data');
+ $this->assertStringEqualsFile($tmpDir . '/test/sample.txt', 'More Simple Sample Data');
+
+ unlink($tmpExample);
+ }
+
+ public function testAddFileFromPathFileNotFoundException(): void
+ {
+ $this->expectException(FileNotFoundException::class);
+
+ // Get ZipStream Object
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ // Trigger error by adding a file which doesn't exist
+ $zip->addFileFromPath(fileName: 'foobar.php', path: '/foo/bar/foobar.php');
+ }
+
+ public function testAddFileFromPathFileNotReadableException(): void
+ {
+ $this->expectException(FileNotReadableException::class);
+
+ // create new virtual filesystem
+ $root = vfsStream::setup('vfs');
+ // create a virtual file with no permissions
+ $file = vfsStream::newFile('foo.txt', 0)->at($root)->setContent('bar');
+
+ // Get ZipStream Object
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ $zip->addFileFromPath('foo.txt', $file->url());
+ }
+
+ public function testAddFileFromPathWithStorageMethod(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ [$tmpExample, $streamExample] = $this->getTmpFileStream();
+ fwrite($streamExample, 'Sample String Data');
+ fclose($streamExample);
+ $zip->addFileFromPath(fileName: 'sample.txt', path: $tmpExample, compressionMethod: CompressionMethod::STORE);
+
+ [$tmpExample, $streamExample] = $this->getTmpFileStream();
+ fwrite($streamExample, 'More Simple Sample Data');
+ fclose($streamExample);
+ $zip->addFileFromPath('test/sample.txt', $tmpExample);
+
+ $zip->finish();
+
+ $zipArchive = new ZipArchive();
+ $zipArchive->open($this->tempfile);
+
+ $sample1 = $zipArchive->statName('sample.txt');
+ $this->assertSame(CompressionMethod::STORE->value, $sample1['comp_method']);
+
+ $sample2 = $zipArchive->statName('test/sample.txt');
+ $this->assertSame(CompressionMethod::DEFLATE->value, $sample2['comp_method']);
+
+ $zipArchive->close();
+ }
+
+ public function testAddLargeFileFromPath(): void
+ {
+ foreach ([CompressionMethod::DEFLATE, CompressionMethod::STORE] as $compressionMethod) {
+ foreach ([false, true] as $zeroHeader) {
+ foreach ([false, true] as $zip64) {
+ if ($zeroHeader && $compressionMethod === CompressionMethod::DEFLATE) {
+ continue;
+ }
+ $this->addLargeFileFileFromPath(
+ compressionMethod: $compressionMethod,
+ zeroHeader: $zeroHeader,
+ zip64: $zip64
+ );
+ }
+ }
+ }
+ }
+
+ public function testAddFileFromStream(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ // In this test we can't use temporary stream to feed data
+ // because zlib.deflate filter gives empty string before PHP 7
+ // it works fine with file stream
+ $streamExample = fopen(__FILE__, 'rb');
+ $zip->addFileFromStream('sample.txt', $streamExample);
+ fclose($streamExample);
+
+ $streamExample2 = fopen('php://temp', 'wb+');
+ fwrite($streamExample2, 'More Simple Sample Data');
+ rewind($streamExample2); // move the pointer back to the beginning of file.
+ $zip->addFileFromStream('test/sample.txt', $streamExample2); //, $fileOptions);
+ fclose($streamExample2);
+
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+ $this->assertSame(['sample.txt', 'test' . DIRECTORY_SEPARATOR . 'sample.txt'], $files);
+
+ $this->assertStringEqualsFile(__FILE__, file_get_contents($tmpDir . '/sample.txt'));
+ $this->assertStringEqualsFile($tmpDir . '/test/sample.txt', 'More Simple Sample Data');
+ }
+
+ public function testAddFileFromStreamUnreadableInput(): void
+ {
+ $this->expectException(StreamNotReadableException::class);
+
+ [$tmpInput] = $this->getTmpFileStream();
+
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ $streamUnreadable = fopen($tmpInput, 'w');
+
+ $zip->addFileFromStream('sample.json', $streamUnreadable);
+ }
+
+ public function testAddFileFromStreamBrokenOutputWrite(): void
+ {
+ $this->expectException(ResourceActionException::class);
+
+ $outputStream = FaultInjectionResource::getResource(['stream_write']);
+
+ $zip = new ZipStream(
+ outputStream: $outputStream,
+ sendHttpHeaders: false,
+ );
+
+ $zip->addFile('sample.txt', 'foobar');
+ }
+
+ public function testAddFileFromStreamBrokenInputRewind(): void
+ {
+ $this->expectException(ResourceActionException::class);
+
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ defaultEnableZeroHeader: false,
+ );
+
+ $fileStream = FaultInjectionResource::getResource(['stream_seek']);
+
+ $zip->addFileFromStream('sample.txt', $fileStream, maxSize: 0);
+ }
+
+ public function testAddFileFromStreamUnseekableInputWithoutZeroHeader(): void
+ {
+ $this->expectException(StreamNotSeekableException::class);
+
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ defaultEnableZeroHeader: false,
+ );
+
+ if (file_exists('/dev/null')) {
+ $streamUnseekable = fopen('/dev/null', 'w+');
+ } elseif (file_exists('NUL')) {
+ $streamUnseekable = fopen('NUL', 'w+');
+ } else {
+ $this->markTestSkipped('Needs file /dev/null');
+ }
+
+ $zip->addFileFromStream('sample.txt', $streamUnseekable, maxSize: 2);
+ }
+
+ public function testAddFileFromStreamUnseekableInputWithZeroHeader(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ defaultEnableZeroHeader: true,
+ defaultCompressionMethod: CompressionMethod::STORE,
+ );
+
+ $streamUnseekable = StreamWrapper::getResource(new class ('test') extends EndlessCycleStream {
+ public function isSeekable(): bool
+ {
+ return false;
+ }
+
+ public function seek(int $offset, int $whence = SEEK_SET): void
+ {
+ throw new RuntimeException('Not seekable');
+ }
+ });
+
+ $zip->addFileFromStream('sample.txt', $streamUnseekable, maxSize: 7);
+
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+ $this->assertSame(['sample.txt'], $files);
+
+ $this->assertSame(filesize($tmpDir . '/sample.txt'), 7);
+ }
+
+ public function testAddFileFromStreamWithStorageMethod(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ $streamExample = fopen('php://temp', 'wb+');
+ fwrite($streamExample, 'Sample String Data');
+ rewind($streamExample); // move the pointer back to the beginning of file.
+ $zip->addFileFromStream('sample.txt', $streamExample, compressionMethod: CompressionMethod::STORE);
+ fclose($streamExample);
+
+ $streamExample2 = fopen('php://temp', 'bw+');
+ fwrite($streamExample2, 'More Simple Sample Data');
+ rewind($streamExample2); // move the pointer back to the beginning of file.
+ $zip->addFileFromStream('test/sample.txt', $streamExample2, compressionMethod: CompressionMethod::DEFLATE);
+ fclose($streamExample2);
+
+ $zip->finish();
+
+ $zipArchive = new ZipArchive();
+ $zipArchive->open($this->tempfile);
+
+ $sample1 = $zipArchive->statName('sample.txt');
+ $this->assertSame(CompressionMethod::STORE->value, $sample1['comp_method']);
+
+ $sample2 = $zipArchive->statName('test/sample.txt');
+ $this->assertSame(CompressionMethod::DEFLATE->value, $sample2['comp_method']);
+
+ $zipArchive->close();
+ }
+
+ public function testAddFileFromPsr7Stream(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ $body = 'Sample String Data';
+ $response = new Response(200, [], $body);
+
+ $zip->addFileFromPsr7Stream('sample.json', $response->getBody());
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+ $this->assertSame(['sample.json'], $files);
+ $this->assertStringEqualsFile($tmpDir . '/sample.json', $body);
+ }
+
+ #[Group('slow')]
+ public function testAddLargeFileFromPsr7Stream(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ enableZip64: true,
+ );
+
+ $zip->addFileFromPsr7Stream(
+ fileName: 'sample.json',
+ stream: new EndlessCycleStream('0'),
+ maxSize: 0x100000000,
+ compressionMethod: CompressionMethod::STORE,
+ lastModificationDateTime: new DateTimeImmutable('2022-01-01 01:01:01Z'),
+ );
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+ $this->assertSame(['sample.json'], $files);
+ $this->assertFileIsReadable($tmpDir . '/sample.json');
+ $this->assertStringStartsWith('000000', file_get_contents(filename: $tmpDir . '/sample.json', length: 20));
+ }
+
+ public function testContinueFinishedZip(): void
+ {
+ $this->expectException(RuntimeException::class);
+
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+ $zip->finish();
+
+ $zip->addFile('sample.txt', '1234');
+ }
+
+ #[Group('slow')]
+ public function testManyFilesWithoutZip64(): void
+ {
+ $this->expectException(OverflowException::class);
+
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ enableZip64: false,
+ );
+
+ for ($i = 0; $i <= 0xFFFF; $i++) {
+ $zip->addFile('sample' . $i, '');
+ }
+
+ $zip->finish();
+ }
+
+ #[Group('slow')]
+ public function testManyFilesWithZip64(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ enableZip64: true,
+ );
+
+ for ($i = 0; $i <= 0xFFFF; $i++) {
+ $zip->addFile('sample' . $i, '');
+ }
+
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+
+ $this->assertSame(count($files), 0x10000);
+ }
+
+ #[Group('slow')]
+ public function testLongZipWithout64(): void
+ {
+ $this->expectException(OverflowException::class);
+
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ enableZip64: false,
+ defaultCompressionMethod: CompressionMethod::STORE,
+ );
+
+ for ($i = 0; $i < 4; $i++) {
+ $zip->addFileFromPsr7Stream(
+ fileName: 'sample' . $i,
+ stream: new EndlessCycleStream('0'),
+ maxSize: 0xFFFFFFFF,
+ compressionMethod: CompressionMethod::STORE,
+ lastModificationDateTime: new DateTimeImmutable('2022-01-01 01:01:01Z'),
+ );
+ }
+ }
+
+ #[Group('slow')]
+ public function testLongZipWith64(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ enableZip64: true,
+ defaultCompressionMethod: CompressionMethod::STORE,
+ );
+
+ for ($i = 0; $i < 4; $i++) {
+ $zip->addFileFromPsr7Stream(
+ fileName: 'sample' . $i,
+ stream: new EndlessCycleStream('0'),
+ maxSize: 0x5FFFFFFF,
+ compressionMethod: CompressionMethod::STORE,
+ lastModificationDateTime: new DateTimeImmutable('2022-01-01 01:01:01Z'),
+ );
+ }
+
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+ $this->assertSame(['sample0', 'sample1', 'sample2', 'sample3'], $files);
+ }
+
+ #[Group('slow')]
+ public function testAddLargeFileWithoutZip64WithZeroHeader(): void
+ {
+ $this->expectException(OverflowException::class);
+
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ enableZip64: false,
+ defaultEnableZeroHeader: true,
+ );
+
+ $zip->addFileFromPsr7Stream(
+ fileName: 'sample.json',
+ stream: new EndlessCycleStream('0'),
+ maxSize: 0x100000000,
+ compressionMethod: CompressionMethod::STORE,
+ lastModificationDateTime: new DateTimeImmutable('2022-01-01 01:01:01Z'),
+ );
+ }
+
+ #[Group('slow')]
+ public function testAddsZip64HeaderWhenNeeded(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ enableZip64: true,
+ defaultEnableZeroHeader: false,
+ );
+
+ $zip->addFileFromPsr7Stream(
+ fileName: 'sample.json',
+ stream: new EndlessCycleStream('0'),
+ maxSize: 0x100000000,
+ compressionMethod: CompressionMethod::STORE,
+ lastModificationDateTime: new DateTimeImmutable('2022-01-01 01:01:01Z'),
+ );
+
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+ $files = $this->getRecursiveFileList($tmpDir);
+
+ $this->assertSame(['sample.json'], $files);
+ $this->assertFileContains($this->tempfile, PackField::pack(
+ new PackField(format: 'V', value: 0x06064b50)
+ ));
+ }
+
+ #[Group('slow')]
+ public function testDoesNotAddZip64HeaderWhenNotNeeded(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ enableZip64: true,
+ defaultEnableZeroHeader: false,
+ );
+
+ $zip->addFileFromPsr7Stream(
+ fileName: 'sample.json',
+ stream: new EndlessCycleStream('0'),
+ maxSize: 0x10,
+ compressionMethod: CompressionMethod::STORE,
+ lastModificationDateTime: new DateTimeImmutable('2022-01-01 01:01:01Z'),
+ );
+
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+ $files = $this->getRecursiveFileList($tmpDir);
+
+ $this->assertSame(['sample.json'], $files);
+ $this->assertFileDoesNotContain($this->tempfile, PackField::pack(
+ new PackField(format: 'V', value: 0x06064b50)
+ ));
+ }
+
+ #[Group('slow')]
+ public function testAddLargeFileWithoutZip64WithoutZeroHeader(): void
+ {
+ $this->expectException(OverflowException::class);
+
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ enableZip64: false,
+ defaultEnableZeroHeader: false,
+ );
+
+ $zip->addFileFromPsr7Stream(
+ fileName: 'sample.json',
+ stream: new EndlessCycleStream('0'),
+ maxSize: 0x100000000,
+ compressionMethod: CompressionMethod::STORE,
+ lastModificationDateTime: new DateTimeImmutable('2022-01-01 01:01:01Z'),
+ );
+ }
+
+ public function testAddFileFromPsr7StreamWithOutputToPsr7Stream(): void
+ {
+ $psr7OutputStream = new ResourceStream($this->tempfileStream);
+
+ $zip = new ZipStream(
+ outputStream: $psr7OutputStream,
+ sendHttpHeaders: false,
+ );
+
+ $body = 'Sample String Data';
+ $response = new Response(200, [], $body);
+
+ $zip->addFileFromPsr7Stream(
+ fileName: 'sample.json',
+ stream: $response->getBody(),
+ compressionMethod: CompressionMethod::STORE,
+ );
+ $zip->finish();
+ $psr7OutputStream->close();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+ $files = $this->getRecursiveFileList($tmpDir);
+
+ $this->assertSame(['sample.json'], $files);
+ $this->assertStringEqualsFile($tmpDir . '/sample.json', $body);
+ }
+
+ public function testAddFileFromPsr7StreamWithFileSizeSet(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ $body = 'Sample String Data';
+ $fileSize = strlen($body);
+ // Add fake padding
+ $fakePadding = "\0\0\0\0\0\0";
+ $response = new Response(200, [], $body . $fakePadding);
+
+ $zip->addFileFromPsr7Stream(
+ fileName: 'sample.json',
+ stream: $response->getBody(),
+ compressionMethod: CompressionMethod::STORE,
+ maxSize: $fileSize
+ );
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+ $this->assertSame(['sample.json'], $files);
+ $this->assertStringEqualsFile($tmpDir . '/sample.json', $body);
+ }
+
+ public function testCreateArchiveHeaders(): void
+ {
+ $headers = [];
+
+ $httpHeaderCallback = function (string $header) use (&$headers) {
+ $headers[] = $header;
+ };
+
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: true,
+ outputName: 'example.zip',
+ httpHeaderCallback: $httpHeaderCallback,
+ );
+
+ $zip->addFile(
+ fileName: 'sample.json',
+ data: 'foo',
+ );
+ $zip->finish();
+
+ $this->assertContains('Content-Type: application/x-zip', $headers);
+ $this->assertContains("Content-Disposition: attachment; filename*=UTF-8''example.zip", $headers);
+ $this->assertContains('Pragma: public', $headers);
+ $this->assertContains('Cache-Control: public, must-revalidate', $headers);
+ $this->assertContains('Content-Transfer-Encoding: binary', $headers);
+ }
+
+ public function testCreateArchiveWithFlushOptionSet(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ flushOutput: true,
+ sendHttpHeaders: false,
+ );
+
+ $zip->addFile('sample.txt', 'Sample String Data');
+ $zip->addFile('test/sample.txt', 'More Simple Sample Data');
+
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+ $this->assertSame(['sample.txt', 'test' . DIRECTORY_SEPARATOR . 'sample.txt'], $files);
+
+ $this->assertStringEqualsFile($tmpDir . '/sample.txt', 'Sample String Data');
+ $this->assertStringEqualsFile($tmpDir . '/test/sample.txt', 'More Simple Sample Data');
+ }
+
+ public function testCreateArchiveWithOutputBufferingOffAndFlushOptionSet(): void
+ {
+ // WORKAROUND (1/2): remove phpunit's output buffer in order to run test without any buffering
+ ob_end_flush();
+ $this->assertSame(0, ob_get_level());
+
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ flushOutput: true,
+ sendHttpHeaders: false,
+ );
+
+ $zip->addFile('sample.txt', 'Sample String Data');
+
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+ $this->assertStringEqualsFile($tmpDir . '/sample.txt', 'Sample String Data');
+
+ // WORKAROUND (2/2): add back output buffering so that PHPUnit doesn't complain that it is missing
+ ob_start();
+ }
+
+ public function testAddEmptyDirectory(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ );
+
+ $zip->addDirectory('foo');
+
+ $zip->finish();
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir, includeDirectories: true);
+
+ $this->assertContains('foo', $files);
+
+ $this->assertFileExists($tmpDir . DIRECTORY_SEPARATOR . 'foo');
+ $this->assertDirectoryExists($tmpDir . DIRECTORY_SEPARATOR . 'foo');
+ }
+
+ public function testAddFileSimulate(): void
+ {
+ $create = function (OperationMode $operationMode): int {
+ $zip = new ZipStream(
+ sendHttpHeaders: false,
+ operationMode: $operationMode,
+ defaultEnableZeroHeader: true,
+ outputStream: $this->tempfileStream,
+ );
+
+ $zip->addFile('sample.txt', 'Sample String Data');
+ $zip->addFile('test/sample.txt', 'More Simple Sample Data');
+
+ return $zip->finish();
+ };
+
+
+ $sizeExpected = $create(OperationMode::NORMAL);
+ $sizeActual = $create(OperationMode::SIMULATE_LAX);
+
+ $this->assertEquals($sizeExpected, $sizeActual);
+ }
+
+ public function testAddFileSimulateWithMaxSize(): void
+ {
+ $create = function (OperationMode $operationMode): int {
+ $zip = new ZipStream(
+ sendHttpHeaders: false,
+ operationMode: $operationMode,
+ defaultCompressionMethod: CompressionMethod::STORE,
+ defaultEnableZeroHeader: true,
+ outputStream: $this->tempfileStream,
+ );
+
+ $zip->addFile('sample.txt', 'Sample String Data', maxSize: 0);
+
+ return $zip->finish();
+ };
+
+
+ $sizeExpected = $create(OperationMode::NORMAL);
+ $sizeActual = $create(OperationMode::SIMULATE_LAX);
+
+ $this->assertEquals($sizeExpected, $sizeActual);
+ }
+
+ public function testAddFileSimulateWithFstat(): void
+ {
+ $create = function (OperationMode $operationMode): int {
+ $zip = new ZipStream(
+ sendHttpHeaders: false,
+ operationMode: $operationMode,
+ defaultCompressionMethod: CompressionMethod::STORE,
+ defaultEnableZeroHeader: true,
+ outputStream: $this->tempfileStream,
+ );
+
+ $zip->addFile('sample.txt', 'Sample String Data');
+ $zip->addFile('test/sample.txt', 'More Simple Sample Data');
+
+ return $zip->finish();
+ };
+
+
+ $sizeExpected = $create(OperationMode::NORMAL);
+ $sizeActual = $create(OperationMode::SIMULATE_LAX);
+
+ $this->assertEquals($sizeExpected, $sizeActual);
+ }
+
+ public function testAddFileSimulateWithExactSizeZero(): void
+ {
+ $create = function (OperationMode $operationMode): int {
+ $zip = new ZipStream(
+ sendHttpHeaders: false,
+ operationMode: $operationMode,
+ defaultCompressionMethod: CompressionMethod::STORE,
+ defaultEnableZeroHeader: true,
+ outputStream: $this->tempfileStream,
+ );
+
+ $zip->addFile('sample.txt', 'Sample String Data', exactSize: 18);
+
+ return $zip->finish();
+ };
+
+
+ $sizeExpected = $create(OperationMode::NORMAL);
+ $sizeActual = $create(OperationMode::SIMULATE_LAX);
+
+ $this->assertEquals($sizeExpected, $sizeActual);
+ }
+
+ public function testAddFileSimulateWithExactSizeInitial(): void
+ {
+ $create = function (OperationMode $operationMode): int {
+ $zip = new ZipStream(
+ sendHttpHeaders: false,
+ operationMode: $operationMode,
+ defaultCompressionMethod: CompressionMethod::STORE,
+ defaultEnableZeroHeader: false,
+ outputStream: $this->tempfileStream,
+ );
+
+ $zip->addFile('sample.txt', 'Sample String Data', exactSize: 18);
+
+ return $zip->finish();
+ };
+
+ $sizeExpected = $create(OperationMode::NORMAL);
+ $sizeActual = $create(OperationMode::SIMULATE_LAX);
+
+ $this->assertEquals($sizeExpected, $sizeActual);
+ }
+
+ public function testAddFileSimulateWithZeroSizeInFstat(): void
+ {
+ $create = function (OperationMode $operationMode): int {
+ $zip = new ZipStream(
+ sendHttpHeaders: false,
+ operationMode: $operationMode,
+ defaultCompressionMethod: CompressionMethod::STORE,
+ defaultEnableZeroHeader: false,
+ outputStream: $this->tempfileStream,
+ );
+
+ $zip->addFileFromPsr7Stream('sample.txt', new class implements StreamInterface {
+ public $pos = 0;
+
+ public function __toString(): string
+ {
+ return 'test';
+ }
+
+ public function close(): void {}
+
+ public function detach() {}
+
+ public function getSize(): ?int
+ {
+ return null;
+ }
+
+ public function tell(): int
+ {
+ return $this->pos;
+ }
+
+ public function eof(): bool
+ {
+ return $this->pos >= 4;
+ }
+
+ public function isSeekable(): bool
+ {
+ return true;
+ }
+
+ public function seek(int $offset, int $whence = SEEK_SET): void
+ {
+ $this->pos = $offset;
+ }
+
+ public function rewind(): void
+ {
+ $this->pos = 0;
+ }
+
+ public function isWritable(): bool
+ {
+ return false;
+ }
+
+ public function write(string $string): int
+ {
+ return 0;
+ }
+
+ public function isReadable(): bool
+ {
+ return true;
+ }
+
+ public function read(int $length): string
+ {
+ $data = substr('test', $this->pos, $length);
+ $this->pos += strlen($data);
+ return $data;
+ }
+
+ public function getContents(): string
+ {
+ return $this->read(4);
+ }
+
+ public function getMetadata(?string $key = null)
+ {
+ return $key !== null ? null : [];
+ }
+ });
+
+ return $zip->finish();
+ };
+
+ $sizeExpected = $create(OperationMode::NORMAL);
+ $sizeActual = $create(OperationMode::SIMULATE_LAX);
+
+
+ $this->assertEquals($sizeExpected, $sizeActual);
+ }
+
+ public function testAddFileSimulateWithWrongExactSize(): void
+ {
+ $this->expectException(FileSizeIncorrectException::class);
+
+ $zip = new ZipStream(
+ sendHttpHeaders: false,
+ operationMode: OperationMode::SIMULATE_LAX,
+ );
+
+ $zip->addFile('sample.txt', 'Sample String Data', exactSize: 1000);
+ }
+
+ public function testAddFileSimulateStrictZero(): void
+ {
+ $this->expectException(SimulationFileUnknownException::class);
+
+ $zip = new ZipStream(
+ sendHttpHeaders: false,
+ operationMode: OperationMode::SIMULATE_STRICT,
+ defaultEnableZeroHeader: true
+ );
+
+ $zip->addFile('sample.txt', 'Sample String Data');
+ }
+
+ public function testAddFileSimulateStrictInitial(): void
+ {
+ $this->expectException(SimulationFileUnknownException::class);
+
+ $zip = new ZipStream(
+ sendHttpHeaders: false,
+ operationMode: OperationMode::SIMULATE_STRICT,
+ defaultEnableZeroHeader: false
+ );
+
+ $zip->addFile('sample.txt', 'Sample String Data');
+ }
+
+ public function testAddFileCallbackStrict(): void
+ {
+ $this->expectException(SimulationFileUnknownException::class);
+
+ $zip = new ZipStream(
+ sendHttpHeaders: false,
+ operationMode: OperationMode::SIMULATE_STRICT,
+ defaultEnableZeroHeader: false
+ );
+
+ $zip->addFileFromCallback('sample.txt', callback: function () {
+ return '';
+ });
+ }
+
+ public function testAddFileCallbackLax(): void
+ {
+ $zip = new ZipStream(
+ operationMode: OperationMode::SIMULATE_LAX,
+ defaultEnableZeroHeader: false,
+ sendHttpHeaders: false,
+ );
+
+ $zip->addFileFromCallback('sample.txt', callback: function () {
+ return 'Sample String Data';
+ });
+
+ $size = $zip->finish();
+
+ $this->assertEquals($size, 142);
+ }
+
+ public function testExecuteSimulation(): void
+ {
+ $zip = new ZipStream(
+ operationMode: OperationMode::SIMULATE_STRICT,
+ defaultCompressionMethod: CompressionMethod::STORE,
+ defaultEnableZeroHeader: false,
+ sendHttpHeaders: false,
+ outputStream: $this->tempfileStream,
+ );
+
+ $zip->addFileFromCallback(
+ 'sample.txt',
+ exactSize: 18,
+ callback: function () {
+ return 'Sample String Data';
+ }
+ );
+
+ $zip->addFileFromCallback(
+ '.gitkeep',
+ exactSize: 0,
+ callback: function () {
+ return '';
+ }
+ );
+
+ $size = $zip->finish();
+
+ $this->assertEquals(filesize($this->tempfile), 0);
+
+ $zip->executeSimulation();
+
+ clearstatcache();
+
+ $this->assertEquals(filesize($this->tempfile), $size);
+
+ $tmpDir = $this->validateAndExtractZip($this->tempfile);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+ $this->assertSame(['.gitkeep', 'sample.txt'], $files);
+ }
+
+ public function testExecuteSimulationBeforeFinish(): void
+ {
+ $this->expectException(RuntimeException::class);
+
+ $zip = new ZipStream(
+ operationMode: OperationMode::SIMULATE_LAX,
+ defaultEnableZeroHeader: false,
+ sendHttpHeaders: false,
+ outputStream: $this->tempfileStream,
+ );
+
+ $zip->executeSimulation();
+ }
+
+ #[Group('slow')]
+ public function testSimulationWithLargeZip64AndZeroHeader(): void
+ {
+ $zip = new ZipStream(
+ outputStream: $this->tempfileStream,
+ sendHttpHeaders: false,
+ operationMode: OperationMode::SIMULATE_STRICT,
+ defaultCompressionMethod: CompressionMethod::STORE,
+ outputName: 'archive.zip',
+ enableZip64: true,
+ defaultEnableZeroHeader: true
+ );
+
+ $zip->addFileFromPsr7Stream(
+ fileName: 'large',
+ stream: new EndlessCycleStream('large'),
+ exactSize: 0x120000000, // ~5gb
+ compressionMethod: CompressionMethod::STORE,
+ lastModificationDateTime: new DateTimeImmutable('2022-01-01 01:01:01Z'),
+ );
+
+ $zip->addFileFromPsr7Stream(
+ fileName: 'small',
+ stream: new EndlessCycleStream('small'),
+ exactSize: 0x20,
+ compressionMethod: CompressionMethod::STORE,
+ lastModificationDateTime: new DateTimeImmutable('2022-01-01 01:01:01Z'),
+ );
+
+ $forecastedSize = $zip->finish();
+
+ $zip->executeSimulation();
+
+ $this->assertSame($forecastedSize, filesize($this->tempfile));
+
+ $this->validateAndExtractZip($this->tempfile);
+ }
+
+ private function addLargeFileFileFromPath(CompressionMethod $compressionMethod, $zeroHeader, $zip64): void
+ {
+ [$tmp, $stream] = $this->getTmpFileStream();
+
+ $zip = new ZipStream(
+ outputStream: $stream,
+ sendHttpHeaders: false,
+ defaultEnableZeroHeader: $zeroHeader,
+ enableZip64: $zip64,
+ );
+
+ [$tmpExample, $streamExample] = $this->getTmpFileStream();
+ for ($i = 0; $i <= 10000; $i++) {
+ fwrite($streamExample, sha1((string) $i));
+ if ($i % 100 === 0) {
+ fwrite($streamExample, "\n");
+ }
+ }
+ fclose($streamExample);
+ $shaExample = sha1_file($tmpExample);
+ $zip->addFileFromPath('sample.txt', $tmpExample);
+ unlink($tmpExample);
+
+ $zip->finish();
+ fclose($stream);
+
+ $tmpDir = $this->validateAndExtractZip($tmp);
+
+ $files = $this->getRecursiveFileList($tmpDir);
+ $this->assertSame(['sample.txt'], $files);
+
+ $this->assertSame(sha1_file($tmpDir . '/sample.txt'), $shaExample, "SHA-1 Mismatch Method: {$compressionMethod->value}");
+
+ unlink($tmp);
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/Zs/ExtendedInformationExtraFieldTest.php b/api/vendor/maennchen/zipstream-php/test/Zs/ExtendedInformationExtraFieldTest.php
new file mode 100644
index 00000000..2b8dbed4
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/Zs/ExtendedInformationExtraFieldTest.php
@@ -0,0 +1,22 @@
+assertSame(
+ bin2hex((string) $extraField),
+ '5356' . // 2 bytes; Tag for this "extra" block type
+ '0000' // 2 bytes; TODO: Document
+ );
+ }
+}
diff --git a/api/vendor/maennchen/zipstream-php/test/bootstrap.php b/api/vendor/maennchen/zipstream-php/test/bootstrap.php
new file mode 100644
index 00000000..13c7a0e6
--- /dev/null
+++ b/api/vendor/maennchen/zipstream-php/test/bootstrap.php
@@ -0,0 +1,7 @@
+add($complexString2);
+```
+
+or use the static Operation methods
+```php
+$complexString1 = '1.23-4.56i';
+$complexString2 = '2.34+5.67i';
+
+echo Complex\Operations::add($complexString1, $complexString2);
+```
+If you want to perform the same operation against multiple values (e.g. to add three or more complex numbers), then you can pass multiple arguments to any of the operations.
+
+You can pass these arguments as Complex objects, or as an array, or string that will parse to a complex object.
+
+## Using functions
+
+When calling any of the available functions for a complex value, you can either call the relevant method for the Complex object
+```php
+$complexString = '1.23-4.56i';
+
+$complexObject = new Complex\Complex($complexString);
+echo $complexObject->sinh();
+```
+
+or use the static Functions methods
+```php
+$complexString = '1.23-4.56i';
+
+echo Complex\Functions::sinh($complexString);
+```
+As with operations, you can pass these arguments as Complex objects, or as an array or string that will parse to a complex object.
+
+
+In the case of the `pow()` function (the only implemented function that requires an additional argument) you need to pass both arguments when calling the function
+
+```php
+$complexString = '1.23-4.56i';
+
+$complexObject = new Complex\Complex($complexString);
+echo Complex\Functions::pow($complexObject, 2);
+```
+or pass the additional argument when calling the method
+```php
+$complexString = '1.23-4.56i';
+
+$complexObject = new Complex\Complex($complexString);
+echo $complexObject->pow(2);
+```
diff --git a/api/vendor/markbaker/complex/classes/src/Complex.php b/api/vendor/markbaker/complex/classes/src/Complex.php
new file mode 100644
index 00000000..25414ee6
--- /dev/null
+++ b/api/vendor/markbaker/complex/classes/src/Complex.php
@@ -0,0 +1,388 @@
+realPart = (float) $realPart;
+ $this->imaginaryPart = (float) $imaginaryPart;
+ $this->suffix = strtolower($suffix ?? '');
+ }
+
+ /**
+ * Gets the real part of this complex number
+ *
+ * @return Float
+ */
+ public function getReal(): float
+ {
+ return $this->realPart;
+ }
+
+ /**
+ * Gets the imaginary part of this complex number
+ *
+ * @return Float
+ */
+ public function getImaginary(): float
+ {
+ return $this->imaginaryPart;
+ }
+
+ /**
+ * Gets the suffix of this complex number
+ *
+ * @return String
+ */
+ public function getSuffix(): string
+ {
+ return $this->suffix;
+ }
+
+ /**
+ * Returns true if this is a real value, false if a complex value
+ *
+ * @return Bool
+ */
+ public function isReal(): bool
+ {
+ return $this->imaginaryPart == 0.0;
+ }
+
+ /**
+ * Returns true if this is a complex value, false if a real value
+ *
+ * @return Bool
+ */
+ public function isComplex(): bool
+ {
+ return !$this->isReal();
+ }
+
+ public function format(): string
+ {
+ $str = "";
+ if ($this->imaginaryPart != 0.0) {
+ if (\abs($this->imaginaryPart) != 1.0) {
+ $str .= $this->imaginaryPart . $this->suffix;
+ } else {
+ $str .= (($this->imaginaryPart < 0.0) ? '-' : '') . $this->suffix;
+ }
+ }
+ if ($this->realPart != 0.0) {
+ if (($str) && ($this->imaginaryPart > 0.0)) {
+ $str = "+" . $str;
+ }
+ $str = $this->realPart . $str;
+ }
+ if (!$str) {
+ $str = "0.0";
+ }
+
+ return $str;
+ }
+
+ public function __toString(): string
+ {
+ return $this->format();
+ }
+
+ /**
+ * Validates whether the argument is a valid complex number, converting scalar or array values if possible
+ *
+ * @param mixed $complex The value to validate
+ * @return Complex
+ * @throws Exception If the argument isn't a Complex number or cannot be converted to one
+ */
+ public static function validateComplexArgument($complex): Complex
+ {
+ if (is_scalar($complex) || is_array($complex)) {
+ $complex = new Complex($complex);
+ } elseif (!is_object($complex) || !($complex instanceof Complex)) {
+ throw new Exception('Value is not a valid complex number');
+ }
+
+ return $complex;
+ }
+
+ /**
+ * Returns the reverse of this complex number
+ *
+ * @return Complex
+ */
+ public function reverse(): Complex
+ {
+ return new Complex(
+ $this->imaginaryPart,
+ $this->realPart,
+ ($this->realPart == 0.0) ? null : $this->suffix
+ );
+ }
+
+ public function invertImaginary(): Complex
+ {
+ return new Complex(
+ $this->realPart,
+ $this->imaginaryPart * -1,
+ ($this->imaginaryPart == 0.0) ? null : $this->suffix
+ );
+ }
+
+ public function invertReal(): Complex
+ {
+ return new Complex(
+ $this->realPart * -1,
+ $this->imaginaryPart,
+ ($this->imaginaryPart == 0.0) ? null : $this->suffix
+ );
+ }
+
+ protected static $functions = [
+ 'abs',
+ 'acos',
+ 'acosh',
+ 'acot',
+ 'acoth',
+ 'acsc',
+ 'acsch',
+ 'argument',
+ 'asec',
+ 'asech',
+ 'asin',
+ 'asinh',
+ 'atan',
+ 'atanh',
+ 'conjugate',
+ 'cos',
+ 'cosh',
+ 'cot',
+ 'coth',
+ 'csc',
+ 'csch',
+ 'exp',
+ 'inverse',
+ 'ln',
+ 'log2',
+ 'log10',
+ 'negative',
+ 'pow',
+ 'rho',
+ 'sec',
+ 'sech',
+ 'sin',
+ 'sinh',
+ 'sqrt',
+ 'tan',
+ 'tanh',
+ 'theta',
+ ];
+
+ protected static $operations = [
+ 'add',
+ 'subtract',
+ 'multiply',
+ 'divideby',
+ 'divideinto',
+ ];
+
+ /**
+ * Returns the result of the function call or operation
+ *
+ * @return Complex|float
+ * @throws Exception|\InvalidArgumentException
+ */
+ public function __call($functionName, $arguments)
+ {
+ $functionName = strtolower(str_replace('_', '', $functionName));
+
+ // Test for function calls
+ if (in_array($functionName, self::$functions, true)) {
+ return Functions::$functionName($this, ...$arguments);
+ }
+ // Test for operation calls
+ if (in_array($functionName, self::$operations, true)) {
+ return Operations::$functionName($this, ...$arguments);
+ }
+ throw new Exception('Complex Function or Operation does not exist');
+ }
+}
diff --git a/api/vendor/markbaker/complex/classes/src/Exception.php b/api/vendor/markbaker/complex/classes/src/Exception.php
new file mode 100644
index 00000000..a2beb732
--- /dev/null
+++ b/api/vendor/markbaker/complex/classes/src/Exception.php
@@ -0,0 +1,13 @@
+getReal() - $invsqrt->getImaginary(),
+ $complex->getImaginary() + $invsqrt->getReal()
+ );
+ $log = self::ln($adjust);
+
+ return new Complex(
+ $log->getImaginary(),
+ -1 * $log->getReal()
+ );
+ }
+
+ /**
+ * Returns the inverse hyperbolic cosine of a complex number.
+ *
+ * Formula from Wolfram Alpha:
+ * cosh^(-1)z = ln(z + sqrt(z + 1) sqrt(z - 1)).
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The inverse hyperbolic cosine of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function acosh($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->isReal() && ($complex->getReal() > 1)) {
+ return new Complex(\acosh($complex->getReal()));
+ }
+
+ $acosh = self::ln(
+ Operations::add(
+ $complex,
+ Operations::multiply(
+ self::sqrt(Operations::add($complex, 1)),
+ self::sqrt(Operations::subtract($complex, 1))
+ )
+ )
+ );
+
+ return $acosh;
+ }
+
+ /**
+ * Returns the inverse cotangent of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The inverse cotangent of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function acot($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ return self::atan(self::inverse($complex));
+ }
+
+ /**
+ * Returns the inverse hyperbolic cotangent of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The inverse hyperbolic cotangent of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function acoth($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ return self::atanh(self::inverse($complex));
+ }
+
+ /**
+ * Returns the inverse cosecant of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The inverse cosecant of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function acsc($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ return new Complex(INF);
+ }
+
+ return self::asin(self::inverse($complex));
+ }
+
+ /**
+ * Returns the inverse hyperbolic cosecant of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The inverse hyperbolic cosecant of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function acsch($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ return new Complex(INF);
+ }
+
+ return self::asinh(self::inverse($complex));
+ }
+
+ /**
+ * Returns the argument of a complex number.
+ * Also known as the theta of the complex number, i.e. the angle in radians
+ * from the real axis to the representation of the number in polar coordinates.
+ *
+ * This function is a synonym for theta()
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return float The argument (or theta) value of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ *
+ * @see theta
+ */
+ public static function argument($complex): float
+ {
+ return self::theta($complex);
+ }
+
+ /**
+ * Returns the inverse secant of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The inverse secant of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function asec($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ return new Complex(INF);
+ }
+
+ return self::acos(self::inverse($complex));
+ }
+
+ /**
+ * Returns the inverse hyperbolic secant of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The inverse hyperbolic secant of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function asech($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ return new Complex(INF);
+ }
+
+ return self::acosh(self::inverse($complex));
+ }
+
+ /**
+ * Returns the inverse sine of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The inverse sine of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function asin($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ $invsqrt = self::sqrt(Operations::subtract(1, Operations::multiply($complex, $complex)));
+ $adjust = new Complex(
+ $invsqrt->getReal() - $complex->getImaginary(),
+ $invsqrt->getImaginary() + $complex->getReal()
+ );
+ $log = self::ln($adjust);
+
+ return new Complex(
+ $log->getImaginary(),
+ -1 * $log->getReal()
+ );
+ }
+
+ /**
+ * Returns the inverse hyperbolic sine of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The inverse hyperbolic sine of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function asinh($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->isReal() && ($complex->getReal() > 1)) {
+ return new Complex(\asinh($complex->getReal()));
+ }
+
+ $asinh = clone $complex;
+ $asinh = $asinh->reverse()
+ ->invertReal();
+ $asinh = self::asin($asinh);
+
+ return $asinh->reverse()
+ ->invertImaginary();
+ }
+
+ /**
+ * Returns the inverse tangent of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The inverse tangent of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function atan($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->isReal()) {
+ return new Complex(\atan($complex->getReal()));
+ }
+
+ $t1Value = new Complex(-1 * $complex->getImaginary(), $complex->getReal());
+ $uValue = new Complex(1, 0);
+
+ $d1Value = clone $uValue;
+ $d1Value = Operations::subtract($d1Value, $t1Value);
+ $d2Value = Operations::add($t1Value, $uValue);
+ $uResult = $d1Value->divideBy($d2Value);
+ $uResult = self::ln($uResult);
+
+ $realMultiplier = -0.5;
+ $imaginaryMultiplier = 0.5;
+
+ if (abs($uResult->getImaginary()) === M_PI) {
+ // If we have an imaginary value at the max or min (PI or -PI), then we need to ensure
+ // that the primary is assigned for the correct quadrant.
+ $realMultiplier = (
+ ($uResult->getImaginary() === M_PI && $uResult->getReal() > 0.0) ||
+ ($uResult->getImaginary() === -M_PI && $uResult->getReal() < 0.0)
+ ) ? 0.5 : -0.5;
+ }
+
+ return new Complex(
+ $uResult->getImaginary() * $realMultiplier,
+ $uResult->getReal() * $imaginaryMultiplier,
+ $complex->getSuffix()
+ );
+ }
+
+ /**
+ * Returns the inverse hyperbolic tangent of a complex number.
+ *
+ * Formula from Wolfram Alpha:
+ * tanh^(-1)z = 1/2 [ln(1 + z) - ln(1 - z)].
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The inverse hyperbolic tangent of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function atanh($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->isReal()) {
+ $real = $complex->getReal();
+ if ($real >= -1.0 && $real <= 1.0) {
+ return new Complex(\atanh($real));
+ } else {
+ return new Complex(\atanh(1 / $real), (($real < 0.0) ? M_PI_2 : -1 * M_PI_2));
+ }
+ }
+
+ $atanh = Operations::multiply(
+ Operations::subtract(
+ self::ln(Operations::add(1.0, $complex)),
+ self::ln(Operations::subtract(1.0, $complex))
+ ),
+ 0.5
+ );
+
+ return $atanh;
+ }
+
+ /**
+ * Returns the complex conjugate of a complex number
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The conjugate of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function conjugate($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ return new Complex(
+ $complex->getReal(),
+ -1 * $complex->getImaginary(),
+ $complex->getSuffix()
+ );
+ }
+
+ /**
+ * Returns the cosine of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The cosine of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function cos($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->isReal()) {
+ return new Complex(\cos($complex->getReal()));
+ }
+
+ return self::conjugate(
+ new Complex(
+ \cos($complex->getReal()) * \cosh($complex->getImaginary()),
+ \sin($complex->getReal()) * \sinh($complex->getImaginary()),
+ $complex->getSuffix()
+ )
+ );
+ }
+
+ /**
+ * Returns the hyperbolic cosine of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The hyperbolic cosine of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function cosh($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->isReal()) {
+ return new Complex(\cosh($complex->getReal()));
+ }
+
+ return new Complex(
+ \cosh($complex->getReal()) * \cos($complex->getImaginary()),
+ \sinh($complex->getReal()) * \sin($complex->getImaginary()),
+ $complex->getSuffix()
+ );
+ }
+
+ /**
+ * Returns the cotangent of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The cotangent of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function cot($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ return new Complex(INF);
+ }
+
+ return self::inverse(self::tan($complex));
+ }
+
+ /**
+ * Returns the hyperbolic cotangent of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The hyperbolic cotangent of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function coth($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ return self::inverse(self::tanh($complex));
+ }
+
+ /**
+ * Returns the cosecant of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The cosecant of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function csc($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ return new Complex(INF);
+ }
+
+ return self::inverse(self::sin($complex));
+ }
+
+ /**
+ * Returns the hyperbolic cosecant of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The hyperbolic cosecant of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function csch($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ return new Complex(INF);
+ }
+
+ return self::inverse(self::sinh($complex));
+ }
+
+ /**
+ * Returns the exponential of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The exponential of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function exp($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if (($complex->getReal() == 0.0) && (\abs($complex->getImaginary()) == M_PI)) {
+ return new Complex(-1.0, 0.0);
+ }
+
+ $rho = \exp($complex->getReal());
+
+ return new Complex(
+ $rho * \cos($complex->getImaginary()),
+ $rho * \sin($complex->getImaginary()),
+ $complex->getSuffix()
+ );
+ }
+
+ /**
+ * Returns the inverse of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The inverse of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws InvalidArgumentException If function would result in a division by zero
+ */
+ public static function inverse($complex): Complex
+ {
+ $complex = clone Complex::validateComplexArgument($complex);
+
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ throw new InvalidArgumentException('Division by zero');
+ }
+
+ return $complex->divideInto(1.0);
+ }
+
+ /**
+ * Returns the natural logarithm of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The natural logarithm of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws InvalidArgumentException If the real and the imaginary parts are both zero
+ */
+ public static function ln($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if (($complex->getReal() == 0.0) && ($complex->getImaginary() == 0.0)) {
+ throw new InvalidArgumentException();
+ }
+
+ return new Complex(
+ \log(self::rho($complex)),
+ self::theta($complex),
+ $complex->getSuffix()
+ );
+ }
+
+ /**
+ * Returns the base-2 logarithm of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The base-2 logarithm of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws InvalidArgumentException If the real and the imaginary parts are both zero
+ */
+ public static function log2($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if (($complex->getReal() == 0.0) && ($complex->getImaginary() == 0.0)) {
+ throw new InvalidArgumentException();
+ } elseif (($complex->getReal() > 0.0) && ($complex->getImaginary() == 0.0)) {
+ return new Complex(\log($complex->getReal(), 2), 0.0, $complex->getSuffix());
+ }
+
+ return self::ln($complex)
+ ->multiply(\log(Complex::EULER, 2));
+ }
+
+ /**
+ * Returns the common logarithm (base 10) of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The common logarithm (base 10) of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws InvalidArgumentException If the real and the imaginary parts are both zero
+ */
+ public static function log10($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if (($complex->getReal() == 0.0) && ($complex->getImaginary() == 0.0)) {
+ throw new InvalidArgumentException();
+ } elseif (($complex->getReal() > 0.0) && ($complex->getImaginary() == 0.0)) {
+ return new Complex(\log10($complex->getReal()), 0.0, $complex->getSuffix());
+ }
+
+ return self::ln($complex)
+ ->multiply(\log10(Complex::EULER));
+ }
+
+ /**
+ * Returns the negative of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The negative value of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ *
+ * @see rho
+ *
+ */
+ public static function negative($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ return new Complex(
+ -1 * $complex->getReal(),
+ -1 * $complex->getImaginary(),
+ $complex->getSuffix()
+ );
+ }
+
+ /**
+ * Returns a complex number raised to a power.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @param float|integer $power The power to raise this value to
+ * @return Complex The complex argument raised to the real power.
+ * @throws Exception If the power argument isn't a valid real
+ */
+ public static function pow($complex, $power): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if (!is_numeric($power)) {
+ throw new Exception('Power argument must be a real number');
+ }
+
+ if ($complex->getImaginary() == 0.0 && $complex->getReal() >= 0.0) {
+ return new Complex(\pow($complex->getReal(), $power));
+ }
+
+ $rValue = \sqrt(($complex->getReal() * $complex->getReal()) + ($complex->getImaginary() * $complex->getImaginary()));
+ $rPower = \pow($rValue, $power);
+ $theta = $complex->argument() * $power;
+ if ($theta == 0) {
+ return new Complex(1);
+ }
+
+ return new Complex($rPower * \cos($theta), $rPower * \sin($theta), $complex->getSuffix());
+ }
+
+ /**
+ * Returns the rho of a complex number.
+ * This is the distance/radius from the centrepoint to the representation of the number in polar coordinates.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return float The rho value of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function rho($complex): float
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ return \sqrt(
+ ($complex->getReal() * $complex->getReal()) +
+ ($complex->getImaginary() * $complex->getImaginary())
+ );
+ }
+
+ /**
+ * Returns the secant of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The secant of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function sec($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ return self::inverse(self::cos($complex));
+ }
+
+ /**
+ * Returns the hyperbolic secant of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The hyperbolic secant of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function sech($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ return self::inverse(self::cosh($complex));
+ }
+
+ /**
+ * Returns the sine of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The sine of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function sin($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->isReal()) {
+ return new Complex(\sin($complex->getReal()));
+ }
+
+ return new Complex(
+ \sin($complex->getReal()) * \cosh($complex->getImaginary()),
+ \cos($complex->getReal()) * \sinh($complex->getImaginary()),
+ $complex->getSuffix()
+ );
+ }
+
+ /**
+ * Returns the hyperbolic sine of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The hyperbolic sine of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function sinh($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->isReal()) {
+ return new Complex(\sinh($complex->getReal()));
+ }
+
+ return new Complex(
+ \sinh($complex->getReal()) * \cos($complex->getImaginary()),
+ \cosh($complex->getReal()) * \sin($complex->getImaginary()),
+ $complex->getSuffix()
+ );
+ }
+
+ /**
+ * Returns the square root of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The Square root of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function sqrt($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ $theta = self::theta($complex);
+ $delta1 = \cos($theta / 2);
+ $delta2 = \sin($theta / 2);
+ $rho = \sqrt(self::rho($complex));
+
+ return new Complex($delta1 * $rho, $delta2 * $rho, $complex->getSuffix());
+ }
+
+ /**
+ * Returns the tangent of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The tangent of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws InvalidArgumentException If function would result in a division by zero
+ */
+ public static function tan($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->isReal()) {
+ return new Complex(\tan($complex->getReal()));
+ }
+
+ $real = $complex->getReal();
+ $imaginary = $complex->getImaginary();
+ $divisor = 1 + \pow(\tan($real), 2) * \pow(\tanh($imaginary), 2);
+ if ($divisor == 0.0) {
+ throw new InvalidArgumentException('Division by zero');
+ }
+
+ return new Complex(
+ \pow(self::sech($imaginary)->getReal(), 2) * \tan($real) / $divisor,
+ \pow(self::sec($real)->getReal(), 2) * \tanh($imaginary) / $divisor,
+ $complex->getSuffix()
+ );
+ }
+
+ /**
+ * Returns the hyperbolic tangent of a complex number.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return Complex The hyperbolic tangent of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ * @throws \InvalidArgumentException If function would result in a division by zero
+ */
+ public static function tanh($complex): Complex
+ {
+ $complex = Complex::validateComplexArgument($complex);
+ $real = $complex->getReal();
+ $imaginary = $complex->getImaginary();
+ $divisor = \cos($imaginary) * \cos($imaginary) + \sinh($real) * \sinh($real);
+ if ($divisor == 0.0) {
+ throw new InvalidArgumentException('Division by zero');
+ }
+
+ return new Complex(
+ \sinh($real) * \cosh($real) / $divisor,
+ 0.5 * \sin(2 * $imaginary) / $divisor,
+ $complex->getSuffix()
+ );
+ }
+
+ /**
+ * Returns the theta of a complex number.
+ * This is the angle in radians from the real axis to the representation of the number in polar coordinates.
+ *
+ * @param Complex|mixed $complex Complex number or a numeric value.
+ * @return float The theta value of the complex argument.
+ * @throws Exception If argument isn't a valid real or complex number.
+ */
+ public static function theta($complex): float
+ {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($complex->getReal() == 0.0) {
+ if ($complex->isReal()) {
+ return 0.0;
+ } elseif ($complex->getImaginary() < 0.0) {
+ return M_PI / -2;
+ }
+ return M_PI / 2;
+ } elseif ($complex->getReal() > 0.0) {
+ return \atan($complex->getImaginary() / $complex->getReal());
+ } elseif ($complex->getImaginary() < 0.0) {
+ return -(M_PI - \atan(\abs($complex->getImaginary()) / \abs($complex->getReal())));
+ }
+
+ return M_PI - \atan($complex->getImaginary() / \abs($complex->getReal()));
+ }
+}
diff --git a/api/vendor/markbaker/complex/classes/src/Operations.php b/api/vendor/markbaker/complex/classes/src/Operations.php
new file mode 100644
index 00000000..b13a8734
--- /dev/null
+++ b/api/vendor/markbaker/complex/classes/src/Operations.php
@@ -0,0 +1,210 @@
+isComplex() && $complex->isComplex() &&
+ $result->getSuffix() !== $complex->getSuffix()) {
+ throw new Exception('Suffix Mismatch');
+ }
+
+ $real = $result->getReal() + $complex->getReal();
+ $imaginary = $result->getImaginary() + $complex->getImaginary();
+
+ $result = new Complex(
+ $real,
+ $imaginary,
+ ($imaginary == 0.0) ? null : max($result->getSuffix(), $complex->getSuffix())
+ );
+ }
+
+ return $result;
+ }
+
+ /**
+ * Divides two or more complex numbers
+ *
+ * @param array of string|integer|float|Complex $complexValues The numbers to divide
+ * @return Complex
+ */
+ public static function divideby(...$complexValues): Complex
+ {
+ if (count($complexValues) < 2) {
+ throw new \Exception('This function requires at least 2 arguments');
+ }
+
+ $base = array_shift($complexValues);
+ $result = clone Complex::validateComplexArgument($base);
+
+ foreach ($complexValues as $complex) {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($result->isComplex() && $complex->isComplex() &&
+ $result->getSuffix() !== $complex->getSuffix()) {
+ throw new Exception('Suffix Mismatch');
+ }
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ throw new InvalidArgumentException('Division by zero');
+ }
+
+ $delta1 = ($result->getReal() * $complex->getReal()) +
+ ($result->getImaginary() * $complex->getImaginary());
+ $delta2 = ($result->getImaginary() * $complex->getReal()) -
+ ($result->getReal() * $complex->getImaginary());
+ $delta3 = ($complex->getReal() * $complex->getReal()) +
+ ($complex->getImaginary() * $complex->getImaginary());
+
+ $real = $delta1 / $delta3;
+ $imaginary = $delta2 / $delta3;
+
+ $result = new Complex(
+ $real,
+ $imaginary,
+ ($imaginary == 0.0) ? null : max($result->getSuffix(), $complex->getSuffix())
+ );
+ }
+
+ return $result;
+ }
+
+ /**
+ * Divides two or more complex numbers
+ *
+ * @param array of string|integer|float|Complex $complexValues The numbers to divide
+ * @return Complex
+ */
+ public static function divideinto(...$complexValues): Complex
+ {
+ if (count($complexValues) < 2) {
+ throw new \Exception('This function requires at least 2 arguments');
+ }
+
+ $base = array_shift($complexValues);
+ $result = clone Complex::validateComplexArgument($base);
+
+ foreach ($complexValues as $complex) {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($result->isComplex() && $complex->isComplex() &&
+ $result->getSuffix() !== $complex->getSuffix()) {
+ throw new Exception('Suffix Mismatch');
+ }
+ if ($result->getReal() == 0.0 && $result->getImaginary() == 0.0) {
+ throw new InvalidArgumentException('Division by zero');
+ }
+
+ $delta1 = ($complex->getReal() * $result->getReal()) +
+ ($complex->getImaginary() * $result->getImaginary());
+ $delta2 = ($complex->getImaginary() * $result->getReal()) -
+ ($complex->getReal() * $result->getImaginary());
+ $delta3 = ($result->getReal() * $result->getReal()) +
+ ($result->getImaginary() * $result->getImaginary());
+
+ $real = $delta1 / $delta3;
+ $imaginary = $delta2 / $delta3;
+
+ $result = new Complex(
+ $real,
+ $imaginary,
+ ($imaginary == 0.0) ? null : max($result->getSuffix(), $complex->getSuffix())
+ );
+ }
+
+ return $result;
+ }
+
+ /**
+ * Multiplies two or more complex numbers
+ *
+ * @param array of string|integer|float|Complex $complexValues The numbers to multiply
+ * @return Complex
+ */
+ public static function multiply(...$complexValues): Complex
+ {
+ if (count($complexValues) < 2) {
+ throw new \Exception('This function requires at least 2 arguments');
+ }
+
+ $base = array_shift($complexValues);
+ $result = clone Complex::validateComplexArgument($base);
+
+ foreach ($complexValues as $complex) {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($result->isComplex() && $complex->isComplex() &&
+ $result->getSuffix() !== $complex->getSuffix()) {
+ throw new Exception('Suffix Mismatch');
+ }
+
+ $real = ($result->getReal() * $complex->getReal()) -
+ ($result->getImaginary() * $complex->getImaginary());
+ $imaginary = ($result->getReal() * $complex->getImaginary()) +
+ ($result->getImaginary() * $complex->getReal());
+
+ $result = new Complex(
+ $real,
+ $imaginary,
+ ($imaginary == 0.0) ? null : max($result->getSuffix(), $complex->getSuffix())
+ );
+ }
+
+ return $result;
+ }
+
+ /**
+ * Subtracts two or more complex numbers
+ *
+ * @param array of string|integer|float|Complex $complexValues The numbers to subtract
+ * @return Complex
+ */
+ public static function subtract(...$complexValues): Complex
+ {
+ if (count($complexValues) < 2) {
+ throw new \Exception('This function requires at least 2 arguments');
+ }
+
+ $base = array_shift($complexValues);
+ $result = clone Complex::validateComplexArgument($base);
+
+ foreach ($complexValues as $complex) {
+ $complex = Complex::validateComplexArgument($complex);
+
+ if ($result->isComplex() && $complex->isComplex() &&
+ $result->getSuffix() !== $complex->getSuffix()) {
+ throw new Exception('Suffix Mismatch');
+ }
+
+ $real = $result->getReal() - $complex->getReal();
+ $imaginary = $result->getImaginary() - $complex->getImaginary();
+
+ $result = new Complex(
+ $real,
+ $imaginary,
+ ($imaginary == 0.0) ? null : max($result->getSuffix(), $complex->getSuffix())
+ );
+ }
+
+ return $result;
+ }
+}
diff --git a/api/vendor/markbaker/complex/composer.json b/api/vendor/markbaker/complex/composer.json
new file mode 100644
index 00000000..246683ca
--- /dev/null
+++ b/api/vendor/markbaker/complex/composer.json
@@ -0,0 +1,40 @@
+{
+ "name": "markbaker/complex",
+ "type": "library",
+ "description": "PHP Class for working with complex numbers",
+ "keywords": ["complex", "mathematics"],
+ "homepage": "https://github.com/MarkBaker/PHPComplex",
+ "license": "MIT",
+ "authors": [
+ {
+ "name": "Mark Baker",
+ "email": "mark@lange.demon.co.uk"
+ }
+ ],
+ "config": {
+ "sort-packages": true,
+ "allow-plugins": {
+ "dealerdirect/phpcodesniffer-composer-installer": true,
+ "markbaker/ukraine": true
+ }
+ },
+ "require": {
+ "php": "^7.2 || ^8.0"
+ },
+ "require-dev": {
+ "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0",
+ "squizlabs/php_codesniffer": "^3.7",
+ "phpcompatibility/php-compatibility": "^9.3",
+ "dealerdirect/phpcodesniffer-composer-installer": "dev-master"
+ },
+ "autoload": {
+ "psr-4": {
+ "Complex\\": "classes/src/"
+ }
+ },
+ "scripts": {
+ "style": "phpcs --report-width=200 --standard=PSR2 --report=summary,full classes/src/ unitTests/classes/src -n",
+ "versions": "phpcs --report-width=200 --standard=PHPCompatibility --report=summary,full classes/src/ --runtime-set testVersion 7.2- -n"
+ },
+ "minimum-stability": "dev"
+}
diff --git a/api/vendor/markbaker/complex/examples/complexTest.php b/api/vendor/markbaker/complex/examples/complexTest.php
new file mode 100644
index 00000000..9a5e1238
--- /dev/null
+++ b/api/vendor/markbaker/complex/examples/complexTest.php
@@ -0,0 +1,154 @@
+add(456);
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456);
+$x->add(789.012);
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456, 78.90);
+$x->add(new Complex(-987.654, -32.1));
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456, 78.90);
+$x->add(-987.654);
+echo $x, PHP_EOL;
+
+$x = new Complex(-987.654, -32.1);
+$x->add(new Complex(0, 1));
+echo $x, PHP_EOL;
+
+$x = new Complex(-987.654, -32.1);
+$x->add(new Complex(0, -1));
+echo $x, PHP_EOL;
+
+
+echo PHP_EOL, 'Subtract', PHP_EOL;
+
+$x = new Complex(123);
+$x->subtract(456);
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456);
+$x->subtract(789.012);
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456, 78.90);
+$x->subtract(new Complex(-987.654, -32.1));
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456, 78.90);
+$x->subtract(-987.654);
+echo $x, PHP_EOL;
+
+$x = new Complex(-987.654, -32.1);
+$x->subtract(new Complex(0, 1));
+echo $x, PHP_EOL;
+
+$x = new Complex(-987.654, -32.1);
+$x->subtract(new Complex(0, -1));
+echo $x, PHP_EOL;
+
+
+echo PHP_EOL, 'Multiply', PHP_EOL;
+
+$x = new Complex(123);
+$x->multiply(456);
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456);
+$x->multiply(789.012);
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456, 78.90);
+$x->multiply(new Complex(-987.654, -32.1));
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456, 78.90);
+$x->multiply(-987.654);
+echo $x, PHP_EOL;
+
+$x = new Complex(-987.654, -32.1);
+$x->multiply(new Complex(0, 1));
+echo $x, PHP_EOL;
+
+$x = new Complex(-987.654, -32.1);
+$x->multiply(new Complex(0, -1));
+echo $x, PHP_EOL;
+
+
+echo PHP_EOL, 'Divide By', PHP_EOL;
+
+$x = new Complex(123);
+$x->divideBy(456);
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456);
+$x->divideBy(789.012);
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456, 78.90);
+$x->divideBy(new Complex(-987.654, -32.1));
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456, 78.90);
+$x->divideBy(-987.654);
+echo $x, PHP_EOL;
+
+$x = new Complex(-987.654, -32.1);
+$x->divideBy(new Complex(0, 1));
+echo $x, PHP_EOL;
+
+$x = new Complex(-987.654, -32.1);
+$x->divideBy(new Complex(0, -1));
+echo $x, PHP_EOL;
+
+
+echo PHP_EOL, 'Divide Into', PHP_EOL;
+
+$x = new Complex(123);
+$x->divideInto(456);
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456);
+$x->divideInto(789.012);
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456, 78.90);
+$x->divideInto(new Complex(-987.654, -32.1));
+echo $x, PHP_EOL;
+
+$x = new Complex(123.456, 78.90);
+$x->divideInto(-987.654);
+echo $x, PHP_EOL;
+
+$x = new Complex(-987.654, -32.1);
+$x->divideInto(new Complex(0, 1));
+echo $x, PHP_EOL;
+
+$x = new Complex(-987.654, -32.1);
+$x->divideInto(new Complex(0, -1));
+echo $x, PHP_EOL;
diff --git a/api/vendor/markbaker/complex/examples/testFunctions.php b/api/vendor/markbaker/complex/examples/testFunctions.php
new file mode 100644
index 00000000..bad1c03d
--- /dev/null
+++ b/api/vendor/markbaker/complex/examples/testFunctions.php
@@ -0,0 +1,52 @@
+getMessage(), PHP_EOL;
+ }
+ }
+ echo PHP_EOL;
+ }
+}
diff --git a/api/vendor/markbaker/complex/examples/testOperations.php b/api/vendor/markbaker/complex/examples/testOperations.php
new file mode 100644
index 00000000..2b7e0ba4
--- /dev/null
+++ b/api/vendor/markbaker/complex/examples/testOperations.php
@@ -0,0 +1,35 @@
+ ', $result, PHP_EOL;
+
+echo PHP_EOL;
+
+echo 'Subtraction', PHP_EOL;
+
+$result = Operations::subtract(...$values);
+echo '=> ', $result, PHP_EOL;
+
+echo PHP_EOL;
+
+echo 'Multiplication', PHP_EOL;
+
+$result = Operations::multiply(...$values);
+echo '=> ', $result, PHP_EOL;
diff --git a/api/vendor/markbaker/complex/license.md b/api/vendor/markbaker/complex/license.md
new file mode 100644
index 00000000..5b4b1561
--- /dev/null
+++ b/api/vendor/markbaker/complex/license.md
@@ -0,0 +1,25 @@
+The MIT License (MIT)
+=====================
+
+Copyright © `2017` `Mark Baker`
+
+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.
\ No newline at end of file
diff --git a/api/vendor/markbaker/matrix/.github/workflows/main.yaml b/api/vendor/markbaker/matrix/.github/workflows/main.yaml
new file mode 100644
index 00000000..5fa1bdb2
--- /dev/null
+++ b/api/vendor/markbaker/matrix/.github/workflows/main.yaml
@@ -0,0 +1,124 @@
+name: main
+on: [ push, pull_request ]
+jobs:
+ test:
+ runs-on: ubuntu-latest
+ strategy:
+ matrix:
+ php-version:
+ - '7.1'
+ - '7.2'
+ - '7.3'
+ - '7.4'
+ - '8.0'
+ - '8.1'
+ - '8.2'
+
+ include:
+ - php-version: 'nightly'
+ experimental: true
+
+ name: PHP ${{ matrix.php-version }}
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v3
+
+ - name: Setup PHP, with composer and extensions
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: ${{ matrix.php-version }}
+ extensions: ctype, dom, gd, iconv, fileinfo, libxml, mbstring, simplexml, xml, xmlreader, xmlwriter, zip, zlib
+ coverage: none
+
+ - name: Get composer cache directory
+ id: composer-cache
+ run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+
+ - name: Cache composer dependencies
+ uses: actions/cache@v3
+ with:
+ path: ${{ steps.composer-cache.outputs.dir }}
+ key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+ restore-keys: ${{ runner.os }}-composer-
+
+ - name: Delete composer lock file
+ id: composer-lock
+ if: ${{ matrix.php-version == '8.0' || matrix.php-version == '8.1' || matrix.php-version == '8.2' || matrix.php-version == 'nightly' }}
+ run: |
+ rm composer.lock
+ echo "::set-output name=flags::--ignore-platform-reqs"
+
+ - name: Install dependencies
+ run: composer update --no-progress --prefer-dist --optimize-autoloader ${{ steps.composer-lock.outputs.flags }}
+
+ - name: Setup problem matchers for PHP
+ run: echo "::add-matcher::${{ runner.tool_cache }}/php.json"
+
+ - name: Setup problem matchers for PHPUnit
+ run: echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
+
+ - name: Test with PHPUnit
+ run: ./vendor/bin/phpunit
+
+ phpcs:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v3
+
+ - name: Setup PHP, with composer and extensions
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: 7.4
+ extensions: ctype, dom, gd, iconv, fileinfo, libxml, mbstring, simplexml, xml, xmlreader, xmlwriter, zip, zlib
+ coverage: none
+ tools: cs2pr
+
+ - name: Get composer cache directory
+ id: composer-cache
+ run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+
+ - name: Cache composer dependencies
+ uses: actions/cache@v3
+ with:
+ path: ${{ steps.composer-cache.outputs.dir }}
+ key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+ restore-keys: ${{ runner.os }}-composer-
+
+ - name: Install dependencies
+ run: composer install --no-progress --prefer-dist --optimize-autoloader
+
+ - name: Code style with PHP_CodeSniffer
+ run: ./vendor/bin/phpcs -q --report=checkstyle | cs2pr --graceful-warnings --colorize
+
+ coverage:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v3
+
+ - name: Setup PHP, with composer and extensions
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: 7.4
+ extensions: ctype, dom, gd, iconv, fileinfo, libxml, mbstring, simplexml, xml, xmlreader, xmlwriter, zip, zlib
+ coverage: pcov
+
+ - name: Get composer cache directory
+ id: composer-cache
+ run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+
+ - name: Cache composer dependencies
+ uses: actions/cache@v3
+ with:
+ path: ${{ steps.composer-cache.outputs.dir }}
+ key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+ restore-keys: ${{ runner.os }}-composer-
+
+ - name: Install dependencies
+ run: composer install --no-progress --prefer-dist --optimize-autoloader
+
+ - name: Coverage
+ run: |
+ ./vendor/bin/phpunit --coverage-text
diff --git a/api/vendor/markbaker/matrix/README.md b/api/vendor/markbaker/matrix/README.md
new file mode 100644
index 00000000..d0dc9145
--- /dev/null
+++ b/api/vendor/markbaker/matrix/README.md
@@ -0,0 +1,215 @@
+PHPMatrix
+==========
+
+---
+
+PHP Class for handling Matrices
+
+[](https://github.com/MarkBaker/PHPMatrix/actions)
+[](https://packagist.org/packages/markbaker/matrix)
+[](https://packagist.org/packages/markbaker/matrix)
+[](https://packagist.org/packages/markbaker/matrix)
+
+
+[](https://xkcd.com/184/)
+
+Matrix Transform
+
+---
+
+This library currently provides the following operations:
+
+ - addition
+ - direct sum
+ - subtraction
+ - multiplication
+ - division (using [A].[B]-1 )
+ - division by
+ - division into
+
+together with functions for
+
+ - adjoint
+ - antidiagonal
+ - cofactors
+ - determinant
+ - diagonal
+ - identity
+ - inverse
+ - minors
+ - trace
+ - transpose
+ - solve
+
+ Given Matrices A and B, calculate X for A.X = B
+
+and classes for
+
+ - Decomposition
+ - LU Decomposition with partial row pivoting,
+
+ such that [P].[A] = [L].[U] and [A] = [P]| .[L].[U]
+ - QR Decomposition
+
+ such that [A] = [Q].[R]
+
+## TO DO
+
+ - power() function
+ - Decomposition
+ - Cholesky Decomposition
+ - EigenValue Decomposition
+ - EigenValues
+ - EigenVectors
+
+---
+
+# Installation
+
+```shell
+composer require markbaker/matrix:^3.0
+```
+
+# Important BC Note
+
+If you've previously been using procedural calls to functions and operations using this library, then from version 3.0 you should use [MarkBaker/PHPMatrixFunctions](https://github.com/MarkBaker/PHPMatrixFunctions) instead (available on packagist as [markbaker/matrix-functions](https://packagist.org/packages/markbaker/matrix-functions)).
+
+You'll need to replace `markbaker/matrix`in your `composer.json` file with the new library, but otherwise there should be no difference in the namespacing, or in the way that you have called the Matrix functions in the past, so no actual code changes are required.
+
+```shell
+composer require markbaker/matrix-functions:^1.0
+```
+
+You should not reference this library (`markbaker/matrix`) in your `composer.json`, composer wil take care of that for you.
+
+# Usage
+
+To create a new Matrix object, provide an array as the constructor argument
+
+```php
+$grid = [
+ [16, 3, 2, 13],
+ [ 5, 10, 11, 8],
+ [ 9, 6, 7, 12],
+ [ 4, 15, 14, 1],
+];
+
+$matrix = new Matrix\Matrix($grid);
+```
+The `Builder` class provides helper methods for creating specific matrices, specifically an identity matrix of a specified size; or a matrix of a specified dimensions, with every cell containing a set value.
+```php
+$matrix = Matrix\Builder::createFilledMatrix(1, 5, 3);
+```
+Will create a matrix of 5 rows and 3 columns, filled with a `1` in every cell; while
+```php
+$matrix = Matrix\Builder::createIdentityMatrix(3);
+```
+will create a 3x3 identity matrix.
+
+
+Matrix objects are immutable: whenever you call a method or pass a grid to a function that returns a matrix value, a new Matrix object will be returned, and the original will remain unchanged. This also allows you to chain multiple methods as you would for a fluent interface (as long as they are methods that will return a Matrix result).
+
+## Performing Mathematical Operations
+
+To perform mathematical operations with Matrices, you can call the appropriate method against a matrix value, passing other values as arguments
+
+```php
+$matrix1 = new Matrix\Matrix([
+ [2, 7, 6],
+ [9, 5, 1],
+ [4, 3, 8],
+]);
+$matrix2 = new Matrix\Matrix([
+ [1, 2, 3],
+ [4, 5, 6],
+ [7, 8, 9],
+]);
+
+var_dump($matrix1->multiply($matrix2)->toArray());
+```
+or pass all values to the appropriate static method
+```php
+$matrix1 = new Matrix\Matrix([
+ [2, 7, 6],
+ [9, 5, 1],
+ [4, 3, 8],
+]);
+$matrix2 = new Matrix\Matrix([
+ [1, 2, 3],
+ [4, 5, 6],
+ [7, 8, 9],
+]);
+
+var_dump(Matrix\Operations::multiply($matrix1, $matrix2)->toArray());
+```
+You can pass in the arguments as Matrix objects, or as arrays.
+
+If you want to perform the same operation against multiple values (e.g. to add three or more matrices), then you can pass multiple arguments to any of the operations.
+
+## Using functions
+
+When calling any of the available functions for a matrix value, you can either call the relevant method for the Matrix object
+```php
+$grid = [
+ [16, 3, 2, 13],
+ [ 5, 10, 11, 8],
+ [ 9, 6, 7, 12],
+ [ 4, 15, 14, 1],
+];
+
+$matrix = new Matrix\Matrix($grid);
+
+echo $matrix->trace();
+```
+or you can call the static method, passing the Matrix object or array as an argument
+```php
+$grid = [
+ [16, 3, 2, 13],
+ [ 5, 10, 11, 8],
+ [ 9, 6, 7, 12],
+ [ 4, 15, 14, 1],
+];
+
+$matrix = new Matrix\Matrix($grid);
+echo Matrix\Functions::trace($matrix);
+```
+```php
+$grid = [
+ [16, 3, 2, 13],
+ [ 5, 10, 11, 8],
+ [ 9, 6, 7, 12],
+ [ 4, 15, 14, 1],
+];
+
+echo Matrix\Functions::trace($grid);
+```
+
+## Decomposition
+
+The library also provides classes for matrix decomposition. You can access these using
+```php
+$grid = [
+ [1, 2],
+ [3, 4],
+];
+
+$matrix = new Matrix\Matrix($grid);
+
+$decomposition = new Matrix\Decomposition\QR($matrix);
+$Q = $decomposition->getQ();
+$R = $decomposition->getR();
+```
+
+or alternatively us the `Decomposition` factory, identifying which form of decomposition you want to use
+```php
+$grid = [
+ [1, 2],
+ [3, 4],
+];
+
+$matrix = new Matrix\Matrix($grid);
+
+$decomposition = Matrix\Decomposition\Decomposition::decomposition(Matrix\Decomposition\Decomposition::QR, $matrix);
+$Q = $decomposition->getQ();
+$R = $decomposition->getR();
+```
diff --git a/api/vendor/markbaker/matrix/buildPhar.php b/api/vendor/markbaker/matrix/buildPhar.php
new file mode 100644
index 00000000..e1b8f96f
--- /dev/null
+++ b/api/vendor/markbaker/matrix/buildPhar.php
@@ -0,0 +1,62 @@
+ 'Mark Baker ',
+ 'Description' => 'PHP Class for working with Matrix numbers',
+ 'Copyright' => 'Mark Baker (c) 2013-' . date('Y'),
+ 'Timestamp' => time(),
+ 'Version' => '0.1.0',
+ 'Date' => date('Y-m-d')
+);
+
+// cleanup
+if (file_exists($pharName)) {
+ echo "Removed: {$pharName}\n";
+ unlink($pharName);
+}
+
+echo "Building phar file...\n";
+
+// the phar object
+$phar = new Phar($pharName, null, 'Matrix');
+$phar->buildFromDirectory($sourceDir);
+$phar->setStub(
+<<<'EOT'
+getMessage());
+ exit(1);
+ }
+
+ include 'phar://functions/sqrt.php';
+
+ __HALT_COMPILER();
+EOT
+);
+$phar->setMetadata($metaData);
+$phar->compressFiles(Phar::GZ);
+
+echo "Complete.\n";
+
+exit();
diff --git a/api/vendor/markbaker/matrix/classes/src/Builder.php b/api/vendor/markbaker/matrix/classes/src/Builder.php
new file mode 100644
index 00000000..161bb688
--- /dev/null
+++ b/api/vendor/markbaker/matrix/classes/src/Builder.php
@@ -0,0 +1,70 @@
+toArray();
+
+ for ($x = 0; $x < $dimensions; ++$x) {
+ $grid[$x][$x] = 1;
+ }
+
+ return new Matrix($grid);
+ }
+}
diff --git a/api/vendor/markbaker/matrix/classes/src/Decomposition/Decomposition.php b/api/vendor/markbaker/matrix/classes/src/Decomposition/Decomposition.php
new file mode 100644
index 00000000..f0144487
--- /dev/null
+++ b/api/vendor/markbaker/matrix/classes/src/Decomposition/Decomposition.php
@@ -0,0 +1,27 @@
+luMatrix = $matrix->toArray();
+ $this->rows = $matrix->rows;
+ $this->columns = $matrix->columns;
+
+ $this->buildPivot();
+ }
+
+ /**
+ * Get lower triangular factor.
+ *
+ * @return Matrix Lower triangular factor
+ */
+ public function getL(): Matrix
+ {
+ $lower = [];
+
+ $columns = min($this->rows, $this->columns);
+ for ($row = 0; $row < $this->rows; ++$row) {
+ for ($column = 0; $column < $columns; ++$column) {
+ if ($row > $column) {
+ $lower[$row][$column] = $this->luMatrix[$row][$column];
+ } elseif ($row === $column) {
+ $lower[$row][$column] = 1.0;
+ } else {
+ $lower[$row][$column] = 0.0;
+ }
+ }
+ }
+
+ return new Matrix($lower);
+ }
+
+ /**
+ * Get upper triangular factor.
+ *
+ * @return Matrix Upper triangular factor
+ */
+ public function getU(): Matrix
+ {
+ $upper = [];
+
+ $rows = min($this->rows, $this->columns);
+ for ($row = 0; $row < $rows; ++$row) {
+ for ($column = 0; $column < $this->columns; ++$column) {
+ if ($row <= $column) {
+ $upper[$row][$column] = $this->luMatrix[$row][$column];
+ } else {
+ $upper[$row][$column] = 0.0;
+ }
+ }
+ }
+
+ return new Matrix($upper);
+ }
+
+ /**
+ * Return pivot permutation vector.
+ *
+ * @return Matrix Pivot matrix
+ */
+ public function getP(): Matrix
+ {
+ $pMatrix = [];
+
+ $pivots = $this->pivot;
+ $pivotCount = count($pivots);
+ foreach ($pivots as $row => $pivot) {
+ $pMatrix[$row] = array_fill(0, $pivotCount, 0);
+ $pMatrix[$row][$pivot] = 1;
+ }
+
+ return new Matrix($pMatrix);
+ }
+
+ /**
+ * Return pivot permutation vector.
+ *
+ * @return array Pivot vector
+ */
+ public function getPivot(): array
+ {
+ return $this->pivot;
+ }
+
+ /**
+ * Is the matrix nonsingular?
+ *
+ * @return bool true if U, and hence A, is nonsingular
+ */
+ public function isNonsingular(): bool
+ {
+ for ($diagonal = 0; $diagonal < $this->columns; ++$diagonal) {
+ if ($this->luMatrix[$diagonal][$diagonal] === 0.0) {
+ return false;
+ }
+ }
+
+ return true;
+ }
+
+ private function buildPivot(): void
+ {
+ for ($row = 0; $row < $this->rows; ++$row) {
+ $this->pivot[$row] = $row;
+ }
+
+ for ($column = 0; $column < $this->columns; ++$column) {
+ $luColumn = $this->localisedReferenceColumn($column);
+
+ $this->applyTransformations($column, $luColumn);
+
+ $pivot = $this->findPivot($column, $luColumn);
+ if ($pivot !== $column) {
+ $this->pivotExchange($pivot, $column);
+ }
+
+ $this->computeMultipliers($column);
+
+ unset($luColumn);
+ }
+ }
+
+ private function localisedReferenceColumn($column): array
+ {
+ $luColumn = [];
+
+ for ($row = 0; $row < $this->rows; ++$row) {
+ $luColumn[$row] = &$this->luMatrix[$row][$column];
+ }
+
+ return $luColumn;
+ }
+
+ private function applyTransformations($column, array $luColumn): void
+ {
+ for ($row = 0; $row < $this->rows; ++$row) {
+ $luRow = $this->luMatrix[$row];
+ // Most of the time is spent in the following dot product.
+ $kmax = min($row, $column);
+ $sValue = 0.0;
+ for ($kValue = 0; $kValue < $kmax; ++$kValue) {
+ $sValue += $luRow[$kValue] * $luColumn[$kValue];
+ }
+ $luRow[$column] = $luColumn[$row] -= $sValue;
+ }
+ }
+
+ private function findPivot($column, array $luColumn): int
+ {
+ $pivot = $column;
+ for ($row = $column + 1; $row < $this->rows; ++$row) {
+ if (abs($luColumn[$row]) > abs($luColumn[$pivot])) {
+ $pivot = $row;
+ }
+ }
+
+ return $pivot;
+ }
+
+ private function pivotExchange($pivot, $column): void
+ {
+ for ($kValue = 0; $kValue < $this->columns; ++$kValue) {
+ $tValue = $this->luMatrix[$pivot][$kValue];
+ $this->luMatrix[$pivot][$kValue] = $this->luMatrix[$column][$kValue];
+ $this->luMatrix[$column][$kValue] = $tValue;
+ }
+
+ $lValue = $this->pivot[$pivot];
+ $this->pivot[$pivot] = $this->pivot[$column];
+ $this->pivot[$column] = $lValue;
+ }
+
+ private function computeMultipliers($diagonal): void
+ {
+ if (($diagonal < $this->rows) && ($this->luMatrix[$diagonal][$diagonal] != 0.0)) {
+ for ($row = $diagonal + 1; $row < $this->rows; ++$row) {
+ $this->luMatrix[$row][$diagonal] /= $this->luMatrix[$diagonal][$diagonal];
+ }
+ }
+ }
+
+ private function pivotB(Matrix $B): array
+ {
+ $X = [];
+ foreach ($this->pivot as $rowId) {
+ $row = $B->getRows($rowId + 1)->toArray();
+ $X[] = array_pop($row);
+ }
+
+ return $X;
+ }
+
+ /**
+ * Solve A*X = B.
+ *
+ * @param Matrix $B a Matrix with as many rows as A and any number of columns
+ *
+ * @throws Exception
+ *
+ * @return Matrix X so that L*U*X = B(piv,:)
+ */
+ public function solve(Matrix $B): Matrix
+ {
+ if ($B->rows !== $this->rows) {
+ throw new Exception('Matrix row dimensions are not equal');
+ }
+
+ if ($this->rows !== $this->columns) {
+ throw new Exception('LU solve() only works on square matrices');
+ }
+
+ if (!$this->isNonsingular()) {
+ throw new Exception('Can only perform operation on singular matrix');
+ }
+
+ // Copy right hand side with pivoting
+ $nx = $B->columns;
+ $X = $this->pivotB($B);
+
+ // Solve L*Y = B(piv,:)
+ for ($k = 0; $k < $this->columns; ++$k) {
+ for ($i = $k + 1; $i < $this->columns; ++$i) {
+ for ($j = 0; $j < $nx; ++$j) {
+ $X[$i][$j] -= $X[$k][$j] * $this->luMatrix[$i][$k];
+ }
+ }
+ }
+
+ // Solve U*X = Y;
+ for ($k = $this->columns - 1; $k >= 0; --$k) {
+ for ($j = 0; $j < $nx; ++$j) {
+ $X[$k][$j] /= $this->luMatrix[$k][$k];
+ }
+ for ($i = 0; $i < $k; ++$i) {
+ for ($j = 0; $j < $nx; ++$j) {
+ $X[$i][$j] -= $X[$k][$j] * $this->luMatrix[$i][$k];
+ }
+ }
+ }
+
+ return new Matrix($X);
+ }
+}
diff --git a/api/vendor/markbaker/matrix/classes/src/Decomposition/QR.php b/api/vendor/markbaker/matrix/classes/src/Decomposition/QR.php
new file mode 100644
index 00000000..4b6106f6
--- /dev/null
+++ b/api/vendor/markbaker/matrix/classes/src/Decomposition/QR.php
@@ -0,0 +1,191 @@
+qrMatrix = $matrix->toArray();
+ $this->rows = $matrix->rows;
+ $this->columns = $matrix->columns;
+
+ $this->decompose();
+ }
+
+ public function getHouseholdVectors(): Matrix
+ {
+ $householdVectors = [];
+ for ($row = 0; $row < $this->rows; ++$row) {
+ for ($column = 0; $column < $this->columns; ++$column) {
+ if ($row >= $column) {
+ $householdVectors[$row][$column] = $this->qrMatrix[$row][$column];
+ } else {
+ $householdVectors[$row][$column] = 0.0;
+ }
+ }
+ }
+
+ return new Matrix($householdVectors);
+ }
+
+ public function getQ(): Matrix
+ {
+ $qGrid = [];
+
+ $rowCount = $this->rows;
+ for ($k = $this->columns - 1; $k >= 0; --$k) {
+ for ($i = 0; $i < $this->rows; ++$i) {
+ $qGrid[$i][$k] = 0.0;
+ }
+ $qGrid[$k][$k] = 1.0;
+ if ($this->columns > $this->rows) {
+ $qGrid = array_slice($qGrid, 0, $this->rows);
+ }
+
+ for ($j = $k; $j < $this->columns; ++$j) {
+ if (isset($this->qrMatrix[$k], $this->qrMatrix[$k][$k]) && $this->qrMatrix[$k][$k] != 0.0) {
+ $s = 0.0;
+ for ($i = $k; $i < $this->rows; ++$i) {
+ $s += $this->qrMatrix[$i][$k] * $qGrid[$i][$j];
+ }
+ $s = -$s / $this->qrMatrix[$k][$k];
+ for ($i = $k; $i < $this->rows; ++$i) {
+ $qGrid[$i][$j] += $s * $this->qrMatrix[$i][$k];
+ }
+ }
+ }
+ }
+
+ array_walk(
+ $qGrid,
+ function (&$row) use ($rowCount) {
+ $row = array_reverse($row);
+ $row = array_slice($row, 0, $rowCount);
+ }
+ );
+
+ return new Matrix($qGrid);
+ }
+
+ public function getR(): Matrix
+ {
+ $rGrid = [];
+
+ for ($row = 0; $row < $this->columns; ++$row) {
+ for ($column = 0; $column < $this->columns; ++$column) {
+ if ($row < $column) {
+ $rGrid[$row][$column] = $this->qrMatrix[$row][$column] ?? 0.0;
+ } elseif ($row === $column) {
+ $rGrid[$row][$column] = $this->rDiagonal[$row] ?? 0.0;
+ } else {
+ $rGrid[$row][$column] = 0.0;
+ }
+ }
+ }
+
+ if ($this->columns > $this->rows) {
+ $rGrid = array_slice($rGrid, 0, $this->rows);
+ }
+
+ return new Matrix($rGrid);
+ }
+
+ private function hypo($a, $b): float
+ {
+ if (abs($a) > abs($b)) {
+ $r = $b / $a;
+ $r = abs($a) * sqrt(1 + $r * $r);
+ } elseif ($b != 0.0) {
+ $r = $a / $b;
+ $r = abs($b) * sqrt(1 + $r * $r);
+ } else {
+ $r = 0.0;
+ }
+
+ return $r;
+ }
+
+ /**
+ * QR Decomposition computed by Householder reflections.
+ */
+ private function decompose(): void
+ {
+ for ($k = 0; $k < $this->columns; ++$k) {
+ // Compute 2-norm of k-th column without under/overflow.
+ $norm = 0.0;
+ for ($i = $k; $i < $this->rows; ++$i) {
+ $norm = $this->hypo($norm, $this->qrMatrix[$i][$k]);
+ }
+ if ($norm != 0.0) {
+ // Form k-th Householder vector.
+ if ($this->qrMatrix[$k][$k] < 0.0) {
+ $norm = -$norm;
+ }
+ for ($i = $k; $i < $this->rows; ++$i) {
+ $this->qrMatrix[$i][$k] /= $norm;
+ }
+ $this->qrMatrix[$k][$k] += 1.0;
+ // Apply transformation to remaining columns.
+ for ($j = $k + 1; $j < $this->columns; ++$j) {
+ $s = 0.0;
+ for ($i = $k; $i < $this->rows; ++$i) {
+ $s += $this->qrMatrix[$i][$k] * $this->qrMatrix[$i][$j];
+ }
+ $s = -$s / $this->qrMatrix[$k][$k];
+ for ($i = $k; $i < $this->rows; ++$i) {
+ $this->qrMatrix[$i][$j] += $s * $this->qrMatrix[$i][$k];
+ }
+ }
+ }
+ $this->rDiagonal[$k] = -$norm;
+ }
+ }
+
+ public function isFullRank(): bool
+ {
+ for ($j = 0; $j < $this->columns; ++$j) {
+ if ($this->rDiagonal[$j] == 0.0) {
+ return false;
+ }
+ }
+
+ return true;
+ }
+
+ /**
+ * Least squares solution of A*X = B.
+ *
+ * @param Matrix $B a Matrix with as many rows as A and any number of columns
+ *
+ * @throws Exception
+ *
+ * @return Matrix matrix that minimizes the two norm of Q*R*X-B
+ */
+ public function solve(Matrix $B): Matrix
+ {
+ if ($B->rows !== $this->rows) {
+ throw new Exception('Matrix row dimensions are not equal');
+ }
+
+ if (!$this->isFullRank()) {
+ throw new Exception('Can only perform this operation on a full-rank matrix');
+ }
+
+ // Compute Y = transpose(Q)*B
+ $Y = $this->getQ()->transpose()
+ ->multiply($B);
+ // Solve R*X = Y;
+ return $this->getR()->inverse()
+ ->multiply($Y);
+ }
+}
diff --git a/api/vendor/markbaker/matrix/classes/src/Div0Exception.php b/api/vendor/markbaker/matrix/classes/src/Div0Exception.php
new file mode 100644
index 00000000..eba28f8a
--- /dev/null
+++ b/api/vendor/markbaker/matrix/classes/src/Div0Exception.php
@@ -0,0 +1,13 @@
+isSquare()) {
+ throw new Exception('Adjoint can only be calculated for a square matrix');
+ }
+
+ return self::getAdjoint($matrix);
+ }
+
+ /**
+ * Calculate the cofactors of the matrix
+ *
+ * @param Matrix $matrix The matrix whose cofactors we wish to calculate
+ * @return Matrix
+ *
+ * @throws Exception
+ */
+ private static function getCofactors(Matrix $matrix)
+ {
+ $cofactors = self::getMinors($matrix);
+ $dimensions = $matrix->rows;
+
+ $cof = 1;
+ for ($i = 0; $i < $dimensions; ++$i) {
+ $cofs = $cof;
+ for ($j = 0; $j < $dimensions; ++$j) {
+ $cofactors[$i][$j] *= $cofs;
+ $cofs = -$cofs;
+ }
+ $cof = -$cof;
+ }
+
+ return new Matrix($cofactors);
+ }
+
+ /**
+ * Return the cofactors of this matrix
+ *
+ * @param Matrix|array $matrix The matrix whose cofactors we wish to calculate
+ * @return Matrix
+ *
+ * @throws Exception
+ */
+ public static function cofactors($matrix)
+ {
+ $matrix = self::validateMatrix($matrix);
+
+ if (!$matrix->isSquare()) {
+ throw new Exception('Cofactors can only be calculated for a square matrix');
+ }
+
+ return self::getCofactors($matrix);
+ }
+
+ /**
+ * @param Matrix $matrix
+ * @param int $row
+ * @param int $column
+ * @return float
+ * @throws Exception
+ */
+ private static function getDeterminantSegment(Matrix $matrix, $row, $column)
+ {
+ $tmpMatrix = $matrix->toArray();
+ unset($tmpMatrix[$row]);
+ array_walk(
+ $tmpMatrix,
+ function (&$row) use ($column) {
+ unset($row[$column]);
+ }
+ );
+
+ return self::getDeterminant(new Matrix($tmpMatrix));
+ }
+
+ /**
+ * Calculate the determinant of the matrix
+ *
+ * @param Matrix $matrix The matrix whose determinant we wish to calculate
+ * @return float
+ *
+ * @throws Exception
+ */
+ private static function getDeterminant(Matrix $matrix)
+ {
+ $dimensions = $matrix->rows;
+ $determinant = 0;
+
+ switch ($dimensions) {
+ case 1:
+ $determinant = $matrix->getValue(1, 1);
+ break;
+ case 2:
+ $determinant = $matrix->getValue(1, 1) * $matrix->getValue(2, 2) -
+ $matrix->getValue(1, 2) * $matrix->getValue(2, 1);
+ break;
+ default:
+ for ($i = 1; $i <= $dimensions; ++$i) {
+ $det = $matrix->getValue(1, $i) * self::getDeterminantSegment($matrix, 0, $i - 1);
+ if (($i % 2) == 0) {
+ $determinant -= $det;
+ } else {
+ $determinant += $det;
+ }
+ }
+ break;
+ }
+
+ return $determinant;
+ }
+
+ /**
+ * Return the determinant of this matrix
+ *
+ * @param Matrix|array $matrix The matrix whose determinant we wish to calculate
+ * @return float
+ * @throws Exception
+ **/
+ public static function determinant($matrix)
+ {
+ $matrix = self::validateMatrix($matrix);
+
+ if (!$matrix->isSquare()) {
+ throw new Exception('Determinant can only be calculated for a square matrix');
+ }
+
+ return self::getDeterminant($matrix);
+ }
+
+ /**
+ * Return the diagonal of this matrix
+ *
+ * @param Matrix|array $matrix The matrix whose diagonal we wish to calculate
+ * @return Matrix
+ * @throws Exception
+ **/
+ public static function diagonal($matrix)
+ {
+ $matrix = self::validateMatrix($matrix);
+
+ if (!$matrix->isSquare()) {
+ throw new Exception('Diagonal can only be extracted from a square matrix');
+ }
+
+ $dimensions = $matrix->rows;
+ $grid = Builder::createFilledMatrix(0, $dimensions, $dimensions)
+ ->toArray();
+
+ for ($i = 0; $i < $dimensions; ++$i) {
+ $grid[$i][$i] = $matrix->getValue($i + 1, $i + 1);
+ }
+
+ return new Matrix($grid);
+ }
+
+ /**
+ * Return the antidiagonal of this matrix
+ *
+ * @param Matrix|array $matrix The matrix whose antidiagonal we wish to calculate
+ * @return Matrix
+ * @throws Exception
+ **/
+ public static function antidiagonal($matrix)
+ {
+ $matrix = self::validateMatrix($matrix);
+
+ if (!$matrix->isSquare()) {
+ throw new Exception('Anti-Diagonal can only be extracted from a square matrix');
+ }
+
+ $dimensions = $matrix->rows;
+ $grid = Builder::createFilledMatrix(0, $dimensions, $dimensions)
+ ->toArray();
+
+ for ($i = 0; $i < $dimensions; ++$i) {
+ $grid[$i][$dimensions - $i - 1] = $matrix->getValue($i + 1, $dimensions - $i);
+ }
+
+ return new Matrix($grid);
+ }
+
+ /**
+ * Return the identity matrix
+ * The identity matrix, or sometimes ambiguously called a unit matrix, of size n is the n × n square matrix
+ * with ones on the main diagonal and zeros elsewhere
+ *
+ * @param Matrix|array $matrix The matrix whose identity we wish to calculate
+ * @return Matrix
+ * @throws Exception
+ **/
+ public static function identity($matrix)
+ {
+ $matrix = self::validateMatrix($matrix);
+
+ if (!$matrix->isSquare()) {
+ throw new Exception('Identity can only be created for a square matrix');
+ }
+
+ $dimensions = $matrix->rows;
+
+ return Builder::createIdentityMatrix($dimensions);
+ }
+
+ /**
+ * Return the inverse of this matrix
+ *
+ * @param Matrix|array $matrix The matrix whose inverse we wish to calculate
+ * @return Matrix
+ * @throws Exception
+ **/
+ public static function inverse($matrix, string $type = 'inverse')
+ {
+ $matrix = self::validateMatrix($matrix);
+
+ if (!$matrix->isSquare()) {
+ throw new Exception(ucfirst($type) . ' can only be calculated for a square matrix');
+ }
+
+ $determinant = self::getDeterminant($matrix);
+ if ($determinant == 0.0) {
+ throw new Div0Exception(ucfirst($type) . ' can only be calculated for a matrix with a non-zero determinant');
+ }
+
+ if ($matrix->rows == 1) {
+ return new Matrix([[1 / $matrix->getValue(1, 1)]]);
+ }
+
+ return self::getAdjoint($matrix)
+ ->multiply(1 / $determinant);
+ }
+
+ /**
+ * Calculate the minors of the matrix
+ *
+ * @param Matrix $matrix The matrix whose minors we wish to calculate
+ * @return array[]
+ *
+ * @throws Exception
+ */
+ protected static function getMinors(Matrix $matrix)
+ {
+ $minors = $matrix->toArray();
+ $dimensions = $matrix->rows;
+ if ($dimensions == 1) {
+ return $minors;
+ }
+
+ for ($i = 0; $i < $dimensions; ++$i) {
+ for ($j = 0; $j < $dimensions; ++$j) {
+ $minors[$i][$j] = self::getDeterminantSegment($matrix, $i, $j);
+ }
+ }
+
+ return $minors;
+ }
+
+ /**
+ * Return the minors of the matrix
+ * The minor of a matrix A is the determinant of some smaller square matrix, cut down from A by removing one or
+ * more of its rows or columns.
+ * Minors obtained by removing just one row and one column from square matrices (first minors) are required for
+ * calculating matrix cofactors, which in turn are useful for computing both the determinant and inverse of
+ * square matrices.
+ *
+ * @param Matrix|array $matrix The matrix whose minors we wish to calculate
+ * @return Matrix
+ * @throws Exception
+ **/
+ public static function minors($matrix)
+ {
+ $matrix = self::validateMatrix($matrix);
+
+ if (!$matrix->isSquare()) {
+ throw new Exception('Minors can only be calculated for a square matrix');
+ }
+
+ return new Matrix(self::getMinors($matrix));
+ }
+
+ /**
+ * Return the trace of this matrix
+ * The trace is defined as the sum of the elements on the main diagonal (the diagonal from the upper left to the lower right)
+ * of the matrix
+ *
+ * @param Matrix|array $matrix The matrix whose trace we wish to calculate
+ * @return float
+ * @throws Exception
+ **/
+ public static function trace($matrix)
+ {
+ $matrix = self::validateMatrix($matrix);
+
+ if (!$matrix->isSquare()) {
+ throw new Exception('Trace can only be extracted from a square matrix');
+ }
+
+ $dimensions = $matrix->rows;
+ $result = 0;
+ for ($i = 1; $i <= $dimensions; ++$i) {
+ $result += $matrix->getValue($i, $i);
+ }
+
+ return $result;
+ }
+
+ /**
+ * Return the transpose of this matrix
+ *
+ * @param Matrix|\a $matrix The matrix whose transpose we wish to calculate
+ * @return Matrix
+ **/
+ public static function transpose($matrix)
+ {
+ $matrix = self::validateMatrix($matrix);
+
+ $array = array_values(array_merge([null], $matrix->toArray()));
+ $grid = call_user_func_array(
+ 'array_map',
+ $array
+ );
+
+ return new Matrix($grid);
+ }
+}
diff --git a/api/vendor/markbaker/matrix/classes/src/Matrix.php b/api/vendor/markbaker/matrix/classes/src/Matrix.php
new file mode 100644
index 00000000..95f55e75
--- /dev/null
+++ b/api/vendor/markbaker/matrix/classes/src/Matrix.php
@@ -0,0 +1,423 @@
+buildFromArray(array_values($grid));
+ }
+
+ /*
+ * Create a new Matrix object from an array of values
+ *
+ * @param array $grid
+ */
+ protected function buildFromArray(array $grid): void
+ {
+ $this->rows = count($grid);
+ $columns = array_reduce(
+ $grid,
+ function ($carry, $value) {
+ return max($carry, is_array($value) ? count($value) : 1);
+ }
+ );
+ $this->columns = $columns;
+
+ array_walk(
+ $grid,
+ function (&$value) use ($columns) {
+ if (!is_array($value)) {
+ $value = [$value];
+ }
+ $value = array_pad(array_values($value), $columns, null);
+ }
+ );
+
+ $this->grid = $grid;
+ }
+
+ /**
+ * Validate that a row number is a positive integer
+ *
+ * @param int $row
+ * @return int
+ * @throws Exception
+ */
+ public static function validateRow(int $row): int
+ {
+ if ((!is_numeric($row)) || (intval($row) < 1)) {
+ throw new Exception('Invalid Row');
+ }
+
+ return (int)$row;
+ }
+
+ /**
+ * Validate that a column number is a positive integer
+ *
+ * @param int $column
+ * @return int
+ * @throws Exception
+ */
+ public static function validateColumn(int $column): int
+ {
+ if ((!is_numeric($column)) || (intval($column) < 1)) {
+ throw new Exception('Invalid Column');
+ }
+
+ return (int)$column;
+ }
+
+ /**
+ * Validate that a row number falls within the set of rows for this matrix
+ *
+ * @param int $row
+ * @return int
+ * @throws Exception
+ */
+ protected function validateRowInRange(int $row): int
+ {
+ $row = static::validateRow($row);
+ if ($row > $this->rows) {
+ throw new Exception('Requested Row exceeds matrix size');
+ }
+
+ return $row;
+ }
+
+ /**
+ * Validate that a column number falls within the set of columns for this matrix
+ *
+ * @param int $column
+ * @return int
+ * @throws Exception
+ */
+ protected function validateColumnInRange(int $column): int
+ {
+ $column = static::validateColumn($column);
+ if ($column > $this->columns) {
+ throw new Exception('Requested Column exceeds matrix size');
+ }
+
+ return $column;
+ }
+
+ /**
+ * Return a new matrix as a subset of rows from this matrix, starting at row number $row, and $rowCount rows
+ * A $rowCount value of 0 will return all rows of the matrix from $row
+ * A negative $rowCount value will return rows until that many rows from the end of the matrix
+ *
+ * Note that row numbers start from 1, not from 0
+ *
+ * @param int $row
+ * @param int $rowCount
+ * @return static
+ * @throws Exception
+ */
+ public function getRows(int $row, int $rowCount = 1): Matrix
+ {
+ $row = $this->validateRowInRange($row);
+ if ($rowCount === 0) {
+ $rowCount = $this->rows - $row + 1;
+ }
+
+ return new static(array_slice($this->grid, $row - 1, (int)$rowCount));
+ }
+
+ /**
+ * Return a new matrix as a subset of columns from this matrix, starting at column number $column, and $columnCount columns
+ * A $columnCount value of 0 will return all columns of the matrix from $column
+ * A negative $columnCount value will return columns until that many columns from the end of the matrix
+ *
+ * Note that column numbers start from 1, not from 0
+ *
+ * @param int $column
+ * @param int $columnCount
+ * @return Matrix
+ * @throws Exception
+ */
+ public function getColumns(int $column, int $columnCount = 1): Matrix
+ {
+ $column = $this->validateColumnInRange($column);
+ if ($columnCount < 1) {
+ $columnCount = $this->columns + $columnCount - $column + 1;
+ }
+
+ $grid = [];
+ for ($i = $column - 1; $i < $column + $columnCount - 1; ++$i) {
+ $grid[] = array_column($this->grid, $i);
+ }
+
+ return (new static($grid))->transpose();
+ }
+
+ /**
+ * Return a new matrix as a subset of rows from this matrix, dropping rows starting at row number $row,
+ * and $rowCount rows
+ * A negative $rowCount value will drop rows until that many rows from the end of the matrix
+ * A $rowCount value of 0 will remove all rows of the matrix from $row
+ *
+ * Note that row numbers start from 1, not from 0
+ *
+ * @param int $row
+ * @param int $rowCount
+ * @return static
+ * @throws Exception
+ */
+ public function dropRows(int $row, int $rowCount = 1): Matrix
+ {
+ $this->validateRowInRange($row);
+ if ($rowCount === 0) {
+ $rowCount = $this->rows - $row + 1;
+ }
+
+ $grid = $this->grid;
+ array_splice($grid, $row - 1, (int)$rowCount);
+
+ return new static($grid);
+ }
+
+ /**
+ * Return a new matrix as a subset of columns from this matrix, dropping columns starting at column number $column,
+ * and $columnCount columns
+ * A negative $columnCount value will drop columns until that many columns from the end of the matrix
+ * A $columnCount value of 0 will remove all columns of the matrix from $column
+ *
+ * Note that column numbers start from 1, not from 0
+ *
+ * @param int $column
+ * @param int $columnCount
+ * @return static
+ * @throws Exception
+ */
+ public function dropColumns(int $column, int $columnCount = 1): Matrix
+ {
+ $this->validateColumnInRange($column);
+ if ($columnCount < 1) {
+ $columnCount = $this->columns + $columnCount - $column + 1;
+ }
+
+ $grid = $this->grid;
+ array_walk(
+ $grid,
+ function (&$row) use ($column, $columnCount) {
+ array_splice($row, $column - 1, (int)$columnCount);
+ }
+ );
+
+ return new static($grid);
+ }
+
+ /**
+ * Return a value from this matrix, from the "cell" identified by the row and column numbers
+ * Note that row and column numbers start from 1, not from 0
+ *
+ * @param int $row
+ * @param int $column
+ * @return mixed
+ * @throws Exception
+ */
+ public function getValue(int $row, int $column)
+ {
+ $row = $this->validateRowInRange($row);
+ $column = $this->validateColumnInRange($column);
+
+ return $this->grid[$row - 1][$column - 1];
+ }
+
+ /**
+ * Returns a Generator that will yield each row of the matrix in turn as a vector matrix
+ * or the value of each cell if the matrix is a column vector
+ *
+ * @return Generator|Matrix[]|mixed[]
+ */
+ public function rows(): Generator
+ {
+ foreach ($this->grid as $i => $row) {
+ yield $i + 1 => ($this->columns == 1)
+ ? $row[0]
+ : new static([$row]);
+ }
+ }
+
+ /**
+ * Returns a Generator that will yield each column of the matrix in turn as a vector matrix
+ * or the value of each cell if the matrix is a row vector
+ *
+ * @return Generator|Matrix[]|mixed[]
+ */
+ public function columns(): Generator
+ {
+ for ($i = 0; $i < $this->columns; ++$i) {
+ yield $i + 1 => ($this->rows == 1)
+ ? $this->grid[0][$i]
+ : new static(array_column($this->grid, $i));
+ }
+ }
+
+ /**
+ * Identify if the row and column dimensions of this matrix are equal,
+ * i.e. if it is a "square" matrix
+ *
+ * @return bool
+ */
+ public function isSquare(): bool
+ {
+ return $this->rows === $this->columns;
+ }
+
+ /**
+ * Identify if this matrix is a vector
+ * i.e. if it comprises only a single row or a single column
+ *
+ * @return bool
+ */
+ public function isVector(): bool
+ {
+ return $this->rows === 1 || $this->columns === 1;
+ }
+
+ /**
+ * Return the matrix as a 2-dimensional array
+ *
+ * @return array
+ */
+ public function toArray(): array
+ {
+ return $this->grid;
+ }
+
+ /**
+ * Solve A*X = B.
+ *
+ * @param Matrix $B Right hand side
+ *
+ * @throws Exception
+ *
+ * @return Matrix ... Solution if A is square, least squares solution otherwise
+ */
+ public function solve(Matrix $B): Matrix
+ {
+ if ($this->columns === $this->rows) {
+ return (new LU($this))->solve($B);
+ }
+
+ return (new QR($this))->solve($B);
+ }
+
+ protected static $getters = [
+ 'rows',
+ 'columns',
+ ];
+
+ /**
+ * Access specific properties as read-only (no setters)
+ *
+ * @param string $propertyName
+ * @return mixed
+ * @throws Exception
+ */
+ public function __get(string $propertyName)
+ {
+ $propertyName = strtolower($propertyName);
+
+ // Test for function calls
+ if (in_array($propertyName, self::$getters)) {
+ return $this->$propertyName;
+ }
+
+ throw new Exception('Property does not exist');
+ }
+
+ protected static $functions = [
+ 'adjoint',
+ 'antidiagonal',
+ 'cofactors',
+ 'determinant',
+ 'diagonal',
+ 'identity',
+ 'inverse',
+ 'minors',
+ 'trace',
+ 'transpose',
+ ];
+
+ protected static $operations = [
+ 'add',
+ 'subtract',
+ 'multiply',
+ 'divideby',
+ 'divideinto',
+ 'directsum',
+ ];
+
+ /**
+ * Returns the result of the function call or operation
+ *
+ * @param string $functionName
+ * @param mixed[] $arguments
+ * @return Matrix|float
+ * @throws Exception
+ */
+ public function __call(string $functionName, $arguments)
+ {
+ $functionName = strtolower(str_replace('_', '', $functionName));
+
+ // Test for function calls
+ if (in_array($functionName, self::$functions, true)) {
+ return Functions::$functionName($this, ...$arguments);
+ }
+ // Test for operation calls
+ if (in_array($functionName, self::$operations, true)) {
+ return Operations::$functionName($this, ...$arguments);
+ }
+ throw new Exception('Function or Operation does not exist');
+ }
+}
diff --git a/api/vendor/markbaker/matrix/classes/src/Operations.php b/api/vendor/markbaker/matrix/classes/src/Operations.php
new file mode 100644
index 00000000..e3d88d64
--- /dev/null
+++ b/api/vendor/markbaker/matrix/classes/src/Operations.php
@@ -0,0 +1,157 @@
+execute($matrix);
+ }
+
+ return $result->result();
+ }
+
+ public static function directsum(...$matrixValues): Matrix
+ {
+ if (count($matrixValues) < 2) {
+ throw new Exception('DirectSum operation requires at least 2 arguments');
+ }
+
+ $matrix = array_shift($matrixValues);
+
+ if (is_array($matrix)) {
+ $matrix = new Matrix($matrix);
+ }
+ if (!$matrix instanceof Matrix) {
+ throw new Exception('DirectSum arguments must be Matrix or array');
+ }
+
+ $result = new DirectSum($matrix);
+
+ foreach ($matrixValues as $matrix) {
+ $result->execute($matrix);
+ }
+
+ return $result->result();
+ }
+
+ public static function divideby(...$matrixValues): Matrix
+ {
+ if (count($matrixValues) < 2) {
+ throw new Exception('Division operation requires at least 2 arguments');
+ }
+
+ $matrix = array_shift($matrixValues);
+
+ if (is_array($matrix)) {
+ $matrix = new Matrix($matrix);
+ }
+ if (!$matrix instanceof Matrix) {
+ throw new Exception('Division arguments must be Matrix or array');
+ }
+
+ $result = new Division($matrix);
+
+ foreach ($matrixValues as $matrix) {
+ $result->execute($matrix);
+ }
+
+ return $result->result();
+ }
+
+ public static function divideinto(...$matrixValues): Matrix
+ {
+ if (count($matrixValues) < 2) {
+ throw new Exception('Division operation requires at least 2 arguments');
+ }
+
+ $matrix = array_pop($matrixValues);
+ $matrixValues = array_reverse($matrixValues);
+
+ if (is_array($matrix)) {
+ $matrix = new Matrix($matrix);
+ }
+ if (!$matrix instanceof Matrix) {
+ throw new Exception('Division arguments must be Matrix or array');
+ }
+
+ $result = new Division($matrix);
+
+ foreach ($matrixValues as $matrix) {
+ $result->execute($matrix);
+ }
+
+ return $result->result();
+ }
+
+ public static function multiply(...$matrixValues): Matrix
+ {
+ if (count($matrixValues) < 2) {
+ throw new Exception('Multiplication operation requires at least 2 arguments');
+ }
+
+ $matrix = array_shift($matrixValues);
+
+ if (is_array($matrix)) {
+ $matrix = new Matrix($matrix);
+ }
+ if (!$matrix instanceof Matrix) {
+ throw new Exception('Multiplication arguments must be Matrix or array');
+ }
+
+ $result = new Multiplication($matrix);
+
+ foreach ($matrixValues as $matrix) {
+ $result->execute($matrix);
+ }
+
+ return $result->result();
+ }
+
+ public static function subtract(...$matrixValues): Matrix
+ {
+ if (count($matrixValues) < 2) {
+ throw new Exception('Subtraction operation requires at least 2 arguments');
+ }
+
+ $matrix = array_shift($matrixValues);
+
+ if (is_array($matrix)) {
+ $matrix = new Matrix($matrix);
+ }
+ if (!$matrix instanceof Matrix) {
+ throw new Exception('Subtraction arguments must be Matrix or array');
+ }
+
+ $result = new Subtraction($matrix);
+
+ foreach ($matrixValues as $matrix) {
+ $result->execute($matrix);
+ }
+
+ return $result->result();
+ }
+}
diff --git a/api/vendor/markbaker/matrix/classes/src/Operators/Addition.php b/api/vendor/markbaker/matrix/classes/src/Operators/Addition.php
new file mode 100644
index 00000000..543f56e9
--- /dev/null
+++ b/api/vendor/markbaker/matrix/classes/src/Operators/Addition.php
@@ -0,0 +1,68 @@
+addMatrix($value);
+ } elseif (is_numeric($value)) {
+ return $this->addScalar($value);
+ }
+
+ throw new Exception('Invalid argument for addition');
+ }
+
+ /**
+ * Execute the addition for a scalar
+ *
+ * @param mixed $value The numeric value to add to the current base value
+ * @return $this The operation object, allowing multiple additions to be chained
+ **/
+ protected function addScalar($value): Operator
+ {
+ for ($row = 0; $row < $this->rows; ++$row) {
+ for ($column = 0; $column < $this->columns; ++$column) {
+ $this->matrix[$row][$column] += $value;
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Execute the addition for a matrix
+ *
+ * @param Matrix $value The numeric value to add to the current base value
+ * @return $this The operation object, allowing multiple additions to be chained
+ * @throws Exception If the provided argument is not appropriate for the operation
+ **/
+ protected function addMatrix(Matrix $value): Operator
+ {
+ $this->validateMatchingDimensions($value);
+
+ for ($row = 0; $row < $this->rows; ++$row) {
+ for ($column = 0; $column < $this->columns; ++$column) {
+ $this->matrix[$row][$column] += $value->getValue($row + 1, $column + 1);
+ }
+ }
+
+ return $this;
+ }
+}
diff --git a/api/vendor/markbaker/matrix/classes/src/Operators/DirectSum.php b/api/vendor/markbaker/matrix/classes/src/Operators/DirectSum.php
new file mode 100644
index 00000000..cc51ef96
--- /dev/null
+++ b/api/vendor/markbaker/matrix/classes/src/Operators/DirectSum.php
@@ -0,0 +1,64 @@
+directSumMatrix($value);
+ }
+
+ throw new Exception('Invalid argument for addition');
+ }
+
+ /**
+ * Execute the direct sum for a matrix
+ *
+ * @param Matrix $value The numeric value to concatenate/direct sum with the current base value
+ * @return $this The operation object, allowing multiple additions to be chained
+ **/
+ private function directSumMatrix($value): Operator
+ {
+ $originalColumnCount = count($this->matrix[0]);
+ $originalRowCount = count($this->matrix);
+ $valColumnCount = $value->columns;
+ $valRowCount = $value->rows;
+ $value = $value->toArray();
+
+ for ($row = 0; $row < $this->rows; ++$row) {
+ $this->matrix[$row] = array_merge($this->matrix[$row], array_fill(0, $valColumnCount, 0));
+ }
+
+ $this->matrix = array_merge(
+ $this->matrix,
+ array_fill(0, $valRowCount, array_fill(0, $originalColumnCount, 0))
+ );
+
+ for ($row = $originalRowCount; $row < $originalRowCount + $valRowCount; ++$row) {
+ array_splice(
+ $this->matrix[$row],
+ $originalColumnCount,
+ $valColumnCount,
+ $value[$row - $originalRowCount]
+ );
+ }
+
+ return $this;
+ }
+}
diff --git a/api/vendor/markbaker/matrix/classes/src/Operators/Division.php b/api/vendor/markbaker/matrix/classes/src/Operators/Division.php
new file mode 100644
index 00000000..dbfec9d3
--- /dev/null
+++ b/api/vendor/markbaker/matrix/classes/src/Operators/Division.php
@@ -0,0 +1,35 @@
+multiplyMatrix($value, $type);
+ } elseif (is_numeric($value)) {
+ return $this->multiplyScalar(1 / $value, $type);
+ }
+
+ throw new Exception('Invalid argument for division');
+ }
+}
diff --git a/api/vendor/markbaker/matrix/classes/src/Operators/Multiplication.php b/api/vendor/markbaker/matrix/classes/src/Operators/Multiplication.php
new file mode 100644
index 00000000..0761e466
--- /dev/null
+++ b/api/vendor/markbaker/matrix/classes/src/Operators/Multiplication.php
@@ -0,0 +1,86 @@
+multiplyMatrix($value, $type);
+ } elseif (is_numeric($value)) {
+ return $this->multiplyScalar($value, $type);
+ }
+
+ throw new Exception("Invalid argument for $type");
+ }
+
+ /**
+ * Execute the multiplication for a scalar
+ *
+ * @param mixed $value The numeric value to multiply with the current base value
+ * @return $this The operation object, allowing multiple mutiplications to be chained
+ **/
+ protected function multiplyScalar($value, string $type = 'multiplication'): Operator
+ {
+ try {
+ for ($row = 0; $row < $this->rows; ++$row) {
+ for ($column = 0; $column < $this->columns; ++$column) {
+ $this->matrix[$row][$column] *= $value;
+ }
+ }
+ } catch (Throwable $e) {
+ throw new Exception("Invalid argument for $type");
+ }
+
+ return $this;
+ }
+
+ /**
+ * Execute the multiplication for a matrix
+ *
+ * @param Matrix $value The numeric value to multiply with the current base value
+ * @return $this The operation object, allowing multiple mutiplications to be chained
+ * @throws Exception If the provided argument is not appropriate for the operation
+ **/
+ protected function multiplyMatrix(Matrix $value, string $type = 'multiplication'): Operator
+ {
+ $this->validateReflectingDimensions($value);
+
+ $newRows = $this->rows;
+ $newColumns = $value->columns;
+ $matrix = Builder::createFilledMatrix(0, $newRows, $newColumns)
+ ->toArray();
+ try {
+ for ($row = 0; $row < $newRows; ++$row) {
+ for ($column = 0; $column < $newColumns; ++$column) {
+ $columnData = $value->getColumns($column + 1)->toArray();
+ foreach ($this->matrix[$row] as $key => $valueData) {
+ $matrix[$row][$column] += $valueData * $columnData[$key][0];
+ }
+ }
+ }
+ } catch (Throwable $e) {
+ throw new Exception("Invalid argument for $type");
+ }
+ $this->matrix = $matrix;
+
+ return $this;
+ }
+}
diff --git a/api/vendor/markbaker/matrix/classes/src/Operators/Operator.php b/api/vendor/markbaker/matrix/classes/src/Operators/Operator.php
new file mode 100644
index 00000000..39e36c61
--- /dev/null
+++ b/api/vendor/markbaker/matrix/classes/src/Operators/Operator.php
@@ -0,0 +1,78 @@
+rows = $matrix->rows;
+ $this->columns = $matrix->columns;
+ $this->matrix = $matrix->toArray();
+ }
+
+ /**
+ * Compare the dimensions of the matrices being operated on to see if they are valid for addition/subtraction
+ *
+ * @param Matrix $matrix The second Matrix object on which the operation will be performed
+ * @throws Exception
+ */
+ protected function validateMatchingDimensions(Matrix $matrix): void
+ {
+ if (($this->rows != $matrix->rows) || ($this->columns != $matrix->columns)) {
+ throw new Exception('Matrices have mismatched dimensions');
+ }
+ }
+
+ /**
+ * Compare the dimensions of the matrices being operated on to see if they are valid for multiplication/division
+ *
+ * @param Matrix $matrix The second Matrix object on which the operation will be performed
+ * @throws Exception
+ */
+ protected function validateReflectingDimensions(Matrix $matrix): void
+ {
+ if ($this->columns != $matrix->rows) {
+ throw new Exception('Matrices have mismatched dimensions');
+ }
+ }
+
+ /**
+ * Return the result of the operation
+ *
+ * @return Matrix
+ */
+ public function result(): Matrix
+ {
+ return new Matrix($this->matrix);
+ }
+}
diff --git a/api/vendor/markbaker/matrix/classes/src/Operators/Subtraction.php b/api/vendor/markbaker/matrix/classes/src/Operators/Subtraction.php
new file mode 100644
index 00000000..b7e14fad
--- /dev/null
+++ b/api/vendor/markbaker/matrix/classes/src/Operators/Subtraction.php
@@ -0,0 +1,68 @@
+subtractMatrix($value);
+ } elseif (is_numeric($value)) {
+ return $this->subtractScalar($value);
+ }
+
+ throw new Exception('Invalid argument for subtraction');
+ }
+
+ /**
+ * Execute the subtraction for a scalar
+ *
+ * @param mixed $value The numeric value to subtracted from the current base value
+ * @return $this The operation object, allowing multiple additions to be chained
+ **/
+ protected function subtractScalar($value): Operator
+ {
+ for ($row = 0; $row < $this->rows; ++$row) {
+ for ($column = 0; $column < $this->columns; ++$column) {
+ $this->matrix[$row][$column] -= $value;
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Execute the subtraction for a matrix
+ *
+ * @param Matrix $value The numeric value to subtract from the current base value
+ * @return $this The operation object, allowing multiple subtractions to be chained
+ * @throws Exception If the provided argument is not appropriate for the operation
+ **/
+ protected function subtractMatrix(Matrix $value): Operator
+ {
+ $this->validateMatchingDimensions($value);
+
+ for ($row = 0; $row < $this->rows; ++$row) {
+ for ($column = 0; $column < $this->columns; ++$column) {
+ $this->matrix[$row][$column] -= $value->getValue($row + 1, $column + 1);
+ }
+ }
+
+ return $this;
+ }
+}
diff --git a/api/vendor/markbaker/matrix/composer.json b/api/vendor/markbaker/matrix/composer.json
new file mode 100644
index 00000000..e86a1e05
--- /dev/null
+++ b/api/vendor/markbaker/matrix/composer.json
@@ -0,0 +1,52 @@
+{
+ "name": "markbaker/matrix",
+ "type": "library",
+ "description": "PHP Class for working with matrices",
+ "keywords": ["matrix", "vector", "mathematics"],
+ "homepage": "https://github.com/MarkBaker/PHPMatrix",
+ "license": "MIT",
+ "authors": [
+ {
+ "name": "Mark Baker",
+ "email": "mark@demon-angel.eu"
+ }
+ ],
+ "require": {
+ "php": "^7.1 || ^8.0"
+ },
+ "require-dev": {
+ "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0",
+ "phpdocumentor/phpdocumentor": "2.*",
+ "phpmd/phpmd": "2.*",
+ "sebastian/phpcpd": "^4.0",
+ "phploc/phploc": "^4.0",
+ "squizlabs/php_codesniffer": "^3.7",
+ "phpcompatibility/php-compatibility": "^9.3",
+ "dealerdirect/phpcodesniffer-composer-installer": "dev-master"
+ },
+ "autoload": {
+ "psr-4": {
+ "Matrix\\": "classes/src/"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "MatrixTest\\": "unitTests/classes/src/"
+ }
+ },
+ "scripts": {
+ "style": "phpcs --report-width=200 --standard=PSR2 --report=summary,full classes/src/ unitTests/classes/src -n",
+ "test": "phpunit -c phpunit.xml.dist",
+ "mess": "phpmd classes/src/ xml codesize,unusedcode,design,naming -n",
+ "lines": "phploc classes/src/ -n",
+ "cpd": "phpcpd classes/src/ -n",
+ "versions": "phpcs --report-width=200 --standard=PHPCompatibility --report=summary,full classes/src/ --runtime-set testVersion 7.2- -n",
+ "coverage": "phpunit -c phpunit.xml.dist --coverage-text --coverage-html ./build/coverage"
+ },
+ "minimum-stability": "dev",
+ "config": {
+ "allow-plugins": {
+ "dealerdirect/phpcodesniffer-composer-installer": true
+ }
+ }
+}
diff --git a/api/vendor/markbaker/matrix/examples/test.php b/api/vendor/markbaker/matrix/examples/test.php
new file mode 100644
index 00000000..071dae91
--- /dev/null
+++ b/api/vendor/markbaker/matrix/examples/test.php
@@ -0,0 +1,33 @@
+solve($target);
+
+echo 'X', PHP_EOL;
+var_export($X->toArray());
+echo PHP_EOL;
+
+$resolve = $matrix->multiply($X);
+
+echo 'Resolve', PHP_EOL;
+var_export($resolve->toArray());
+echo PHP_EOL;
diff --git a/api/vendor/markbaker/matrix/infection.json.dist b/api/vendor/markbaker/matrix/infection.json.dist
new file mode 100644
index 00000000..eddaa70a
--- /dev/null
+++ b/api/vendor/markbaker/matrix/infection.json.dist
@@ -0,0 +1,17 @@
+{
+ "timeout": 1,
+ "source": {
+ "directories": [
+ "classes\/src"
+ ]
+ },
+ "logs": {
+ "text": "build/infection/text.log",
+ "summary": "build/infection/summary.log",
+ "debug": "build/infection/debug.log",
+ "perMutator": "build/infection/perMutator.md"
+ },
+ "mutators": {
+ "@default": true
+ }
+}
diff --git a/api/vendor/markbaker/matrix/license.md b/api/vendor/markbaker/matrix/license.md
new file mode 100644
index 00000000..7329058f
--- /dev/null
+++ b/api/vendor/markbaker/matrix/license.md
@@ -0,0 +1,25 @@
+The MIT License (MIT)
+=====================
+
+Copyright © `2018` `Mark Baker`
+
+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.
\ No newline at end of file
diff --git a/api/vendor/markbaker/matrix/phpstan.neon b/api/vendor/markbaker/matrix/phpstan.neon
new file mode 100644
index 00000000..3d90d492
--- /dev/null
+++ b/api/vendor/markbaker/matrix/phpstan.neon
@@ -0,0 +1,6 @@
+parameters:
+ ignoreErrors:
+ - '#Property [A-Za-z\\]+::\$[A-Za-z]+ has no typehint specified#'
+ - '#Method [A-Za-z\\]+::[A-Za-z]+\(\) has no return typehint specified#'
+ - '#Method [A-Za-z\\]+::[A-Za-z]+\(\) has parameter \$[A-Za-z0-9]+ with no typehint specified#'
+ checkMissingIterableValueType: false
diff --git a/api/vendor/phpmailer/phpmailer/README.md b/api/vendor/phpmailer/phpmailer/README.md
index 07fe8c8a..862a4e1a 100644
--- a/api/vendor/phpmailer/phpmailer/README.md
+++ b/api/vendor/phpmailer/phpmailer/README.md
@@ -20,25 +20,26 @@
- Multipart/alternative emails for mail clients that do not read HTML email
- Add attachments, including inline
- Support for UTF-8 content and 8bit, base64, binary, and quoted-printable encodings
-- SMTP authentication with LOGIN, PLAIN, CRAM-MD5, and XOAUTH2 mechanisms over SMTPS and SMTP+STARTTLS transports
+- Full UTF-8 support when using servers that support `SMTPUTF8`.
+- Support for iCal events in multiparts and attachments
+- SMTP authentication with `LOGIN`, `PLAIN`, `CRAM-MD5`, and `XOAUTH2` mechanisms over SMTPS and SMTP+STARTTLS transports
- Validates email addresses automatically
- Protects against header injection attacks
- Error messages in over 50 languages!
- DKIM and S/MIME signing support
-- Compatible with PHP 5.5 and later, including PHP 8.2
+- Compatible with PHP 5.5 and later, including PHP 8.4
- Namespaced to prevent name clashes
- Much more!
## Why you might need it
-Many PHP developers need to send email from their code. The only PHP function that supports this directly is [`mail()`](https://www.php.net/manual/en/function.mail.php). However, it does not provide any assistance for making use of popular features such as encryption, authentication, HTML messages, and attachments.
+Many PHP developers need to send email from their code. The only PHP function that supports this directly is [`mail()`](https://www.php.net/manual/en/function.mail.php). However, it does not provide any assistance for making use of popular features such as authentication, HTML messages, and attachments.
Formatting email correctly is surprisingly difficult. There are myriad overlapping (and conflicting) standards, requiring tight adherence to horribly complicated formatting and encoding rules – the vast majority of code that you'll find online that uses the `mail()` function directly is just plain wrong, if not unsafe!
The PHP `mail()` function usually sends via a local mail server, typically fronted by a `sendmail` binary on Linux, BSD, and macOS platforms, however, Windows usually doesn't include a local mail server; PHPMailer's integrated SMTP client allows email sending on all platforms without needing a local mail server. Be aware though, that the `mail()` function should be avoided when possible; it's both faster and [safer](https://exploitbox.io/paper/Pwning-PHP-Mail-Function-For-Fun-And-RCE.html) to use SMTP to localhost.
*Please* don't be tempted to do it yourself – if you don't use PHPMailer, there are many other excellent libraries that
-you should look at before rolling your own. Try [SwiftMailer](https://swiftmailer.symfony.com/)
-, [Laminas/Mail](https://docs.laminas.dev/laminas-mail/), [ZetaComponents](https://github.com/zetacomponents/Mail), etc.
+you should look at before rolling your own. Try [Symfony Mailer](https://symfony.com/doc/current/mailer.html), [Laminas/Mail](https://docs.laminas.dev/laminas-mail/), [ZetaComponents](https://github.com/zetacomponents/Mail), etc.
## License
This software is distributed under the [LGPL 2.1](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html) license, along with the [GPL Cooperation Commitment](https://gplcc.github.io/gplcc/). Please read [LICENSE](https://github.com/PHPMailer/PHPMailer/blob/master/LICENSE) for information on the software availability and distribution.
@@ -47,7 +48,7 @@ This software is distributed under the [LGPL 2.1](https://www.gnu.org/licenses/o
PHPMailer is available on [Packagist](https://packagist.org/packages/phpmailer/phpmailer) (using semantic versioning), and installation via [Composer](https://getcomposer.org) is the recommended way to install PHPMailer. Just add this line to your `composer.json` file:
```json
-"phpmailer/phpmailer": "^6.9.2"
+"phpmailer/phpmailer": "^6.10.0"
```
or run
@@ -74,7 +75,7 @@ require 'path/to/PHPMailer/src/PHPMailer.php';
require 'path/to/PHPMailer/src/SMTP.php';
```
-If you're not using the `SMTP` class explicitly (you're probably not), you don't need a `use` line for the SMTP class. Even if you're not using exceptions, you do still need to load the `Exception` class as it is used internally.
+If you're not using the `SMTP` class explicitly (you're probably not), you don't need a `use` line for it. Even if you're not using exceptions, you do still need to load the `Exception` class as it is used internally.
## Legacy versions
PHPMailer 5.2 (which is compatible with PHP 5.0 — 7.0) is no longer supported, even for security updates. You will find the latest version of 5.2 in the [5.2-stable branch](https://github.com/PHPMailer/PHPMailer/tree/5.2-stable). If you're using PHP 5.5 or later (which you should be), switch to the 6.x releases.
@@ -95,7 +96,7 @@ use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;
-//Load Composer's autoloader
+//Load Composer's autoloader (created by composer, not included with PHPMailer)
require 'vendor/autoload.php';
//Create an instance; passing `true` enables exceptions
diff --git a/api/vendor/phpmailer/phpmailer/SMTPUTF8.md b/api/vendor/phpmailer/phpmailer/SMTPUTF8.md
new file mode 100644
index 00000000..ca284ee2
--- /dev/null
+++ b/api/vendor/phpmailer/phpmailer/SMTPUTF8.md
@@ -0,0 +1,48 @@
+# A short history of UTF-8 in email
+
+## Background
+
+For most of its existence, SMTP has been a 7-bit channel, only supporting US-ASCII characters. This has been a problem for many languages, especially those that use non-Latin scripts, and has led to the development of various workarounds.
+
+The first major improvement, introduced in 1994 in [RFC 1652](https://www.rfc-editor.org/rfc/rfc1652) and extended in 2011 in [RFC 6152](https://www.rfc-editor.org/rfc/rfc6152), was the addition of the `8BITMIME` SMTP extension, which allowed raw 8-bit data to be included in message bodies sent over SMTP.
+This allowed the message *contents* to contain 8-bit data, including things like UTF-8 text, even though the SMTP protocol itself was still firmly 7-bit. This worked by having the server switch to 8-bit after the headers, and then back to 7-bit after the completion of a `DATA` command.
+
+From 1996, messages could support [RFC 2047 encoding](https://www.rfc-editor.org/rfc/rfc2047), which permitted inserting characters from any character set into header *values* (but not names), but only by encoding them in somewhat unreadable ways to allow them to survive passage through a 7-bit channel. An example with a subject of "Schrödinger's cat" would be:
+
+```
+Subject: =?utf-8?Q=Schr=C3=B6dinger=92s_Cat?=
+```
+
+Here the accented `ö` is encoded as `=C3=B6`, which is the UTF-8 encoding of the 2-byte character, and the whole thing is wrapped in `=?utf-8?Q?` to indicate that it uses the UTF-8 charset and `quoted-printable` encoding. This is a bit of a hack, and not very human-friendly, but it works.
+
+Similarly, 8-bit message bodies could be encoded using the same `quoted-printable` and `base64` content transfer encoding (CTE) schemes, which preserved the 8-bit content while encoding it in a format that could survive transmission through a 7-bit channel.
+
+Domain names were originally also stuck in a 7-bit world, actually even more constrained to only a subset of the US-ASCII character set. But of course, many people want to have domains in their own language/script. Internationalized domain name (IDN) permitted this, using yet another complex encoding scheme called punycode, defined for domain names in 2003 in [RFC 3492](https://www.rfc-editor.org/rfc/rfc3492). This finally allowed the domain part (after the `@`) of email addresses to contain UTF-8, though it was actually an illusion preserved by email client applications. For example, an address of
+`user@café.example.com` translates to
+`user@xn--caf-dma.example.com` in punycode, rendering it mostly unreadable, but 7-bit friendly, and remaining compatible with email clients that don't know about IDN.
+
+The one remaining part of email that could not handle UTF-8 is the local part of email addresses (the part before the `@`).
+
+I've only mentioned UTF-8 here, but most of these approaches also allowed other character sets that were popular, such as [the ISO-8859 family](https://en.wikipedia.org/wiki/ISO/IEC_8859). However, UTF-8 solves so many problems that these other character sets are gradually falling out of favour, as UTF-8 can support all languages.
+
+This patchwork of overlapping approaches has served us well, but we have to admit that it's a mess.
+
+## SMTPUTF8
+
+`SMTPUTF8` is another SMTP extension, defined in [RFC 6531](https://www.rfc-editor.org/rfc/rfc6531) in 2012. This essentially solves the whole problem, allowing the entire SMTP conversation — commands, headers, and message bodies — to be sent in raw, unencoded UTF-8.
+
+But there's a problem with this approach: adoption. If you send a UTF-8 message to a recipient whose mail server doesn't support this format, the sender has to somehow downgrade the message to make it survive a transition to 7-bit. This is a hard problem to solve, especially since there is no way to make a 7-bit system support UTF-8 in the local parts of addresses. This downgrade problem is what held up the adoption of `SMTPUTF8` in PHPMailer for many years, but in that time the *de facto* approach has become to simply fail in that situation, and tell the recipient it's time they upgraded their mail server 😅.
+
+The vast majority of large email providers (gmail, Yahoo, Microsoft, etc), mail servers (postfix, exim, IIS, etc), and mail clients (Apple Mail, Outlook, Thunderbird, etc) now all support SMTPUTF8, so the need for backward compatibility is no longer what it was.
+
+## SMTPUTF8 in PHPMailer
+
+Several other PHP email libraries have implemented a halfway solution to `SMTPUTF8`, adding only the ability to support UTF-8 in email addresses, not elsewhere in the protocol. I wanted PHPMailer to do it "the right way", and this has taken much longer. PHPMailer now supports UTF-8 everywhere, and does not need to use transfer or header encodings for UTF-8 text when connecting to an `SMTPUTF8`-capable mail server.
+
+This support is handled automatically: if you add an email address that requires UTF-8, PHPMailer will use UTF-8 for everything. If not, it will fall back to 7-bit and encode the message as necessary.
+
+The one place you will need to be careful is in the selection of the address validator. By default, PHPMailer uses PHP's built-in `filter_var` validator, which does not allow UTF-8 email addresses. When PHPMailer spots that you have submitted a UTF-8 address, but have not altered the default validator, it will automatically switch to using a UTF-8-compatible validator. As soon as you do this, any SMTP connection you make will *require* that the server you connect to supports `SMTPUTF8`. You can select this validator explicitly by setting `PHPMailer::$validator = 'eai'` (an acronym for Email Address Internationalization).
+
+### Postfix gotcha
+
+Postfix has supported `SMTPUTF8` for a long time, but it has a peculiarity that it does not always advertise that it does so. However, rather surprisingly, if you use UTF-8 in the conversation, it will work anyway.
diff --git a/api/vendor/phpmailer/phpmailer/VERSION b/api/vendor/phpmailer/phpmailer/VERSION
index 5f54f91e..cf79bf90 100644
--- a/api/vendor/phpmailer/phpmailer/VERSION
+++ b/api/vendor/phpmailer/phpmailer/VERSION
@@ -1 +1 @@
-6.9.3
+6.10.0
diff --git a/api/vendor/phpmailer/phpmailer/language/phpmailer.lang-pt.php b/api/vendor/phpmailer/phpmailer/language/phpmailer.lang-pt.php
index f1ce946e..79a68026 100644
--- a/api/vendor/phpmailer/phpmailer/language/phpmailer.lang-pt.php
+++ b/api/vendor/phpmailer/phpmailer/language/phpmailer.lang-pt.php
@@ -3,25 +3,32 @@
/**
* Portuguese (European) PHPMailer language file: refer to English translation for definitive list
* @package PHPMailer
- * @author Jonadabe
+ * @author João Vieira
*/
-$PHPMAILER_LANG['authenticate'] = 'Erro do SMTP: Não foi possível realizar a autenticação.';
-$PHPMAILER_LANG['connect_host'] = 'Erro do SMTP: Não foi possível realizar ligação com o servidor SMTP.';
-$PHPMAILER_LANG['data_not_accepted'] = 'Erro do SMTP: Os dados foram rejeitados.';
-$PHPMAILER_LANG['empty_message'] = 'A mensagem no e-mail está vazia.';
+$PHPMAILER_LANG['authenticate'] = 'Erro SMTP: Falha na autenticação.';
+$PHPMAILER_LANG['buggy_php'] = 'A sua versão do PHP tem um bug que pode causar mensagens corrompidas. Para resolver, utilize o envio por SMTP, desative a opção mail.add_x_header no ficheiro php.ini, mude para MacOS ou Linux, ou atualize o PHP para a versão 7.0.17+ ou 7.1.3+.';
+$PHPMAILER_LANG['connect_host'] = 'Erro SMTP: Não foi possível ligar ao servidor SMTP.';
+$PHPMAILER_LANG['data_not_accepted'] = 'Erro SMTP: Dados não aceites.';
+$PHPMAILER_LANG['empty_message'] = 'A mensagem de e-mail está vazia.';
$PHPMAILER_LANG['encoding'] = 'Codificação desconhecida: ';
$PHPMAILER_LANG['execute'] = 'Não foi possível executar: ';
-$PHPMAILER_LANG['file_access'] = 'Não foi possível aceder o ficheiro: ';
-$PHPMAILER_LANG['file_open'] = 'Abertura do ficheiro: Não foi possível abrir o ficheiro: ';
-$PHPMAILER_LANG['from_failed'] = 'Ocorreram falhas nos endereços dos seguintes remententes: ';
-$PHPMAILER_LANG['instantiate'] = 'Não foi possível iniciar uma instância da função mail.';
-$PHPMAILER_LANG['invalid_address'] = 'Não foi enviado nenhum e-mail para o endereço de e-mail inválido: ';
-$PHPMAILER_LANG['mailer_not_supported'] = ' mailer não é suportado.';
-$PHPMAILER_LANG['provide_address'] = 'Tem de fornecer pelo menos um endereço como destinatário do e-mail.';
-$PHPMAILER_LANG['recipients_failed'] = 'Erro do SMTP: O endereço do seguinte destinatário falhou: ';
-$PHPMAILER_LANG['signing'] = 'Erro ao assinar: ';
-$PHPMAILER_LANG['smtp_connect_failed'] = 'SMTP Connect() falhou.';
-$PHPMAILER_LANG['smtp_error'] = 'Erro de servidor SMTP: ';
-$PHPMAILER_LANG['variable_set'] = 'Não foi possível definir ou redefinir a variável: ';
$PHPMAILER_LANG['extension_missing'] = 'Extensão em falta: ';
+$PHPMAILER_LANG['file_access'] = 'Não foi possível aceder ao ficheiro: ';
+$PHPMAILER_LANG['file_open'] = 'Erro ao abrir o ficheiro: ';
+$PHPMAILER_LANG['from_failed'] = 'O envio falhou para o seguinte endereço do remetente: ';
+$PHPMAILER_LANG['instantiate'] = 'Não foi possível instanciar a função mail.';
+$PHPMAILER_LANG['invalid_address'] = 'Endereço de e-mail inválido: ';
+$PHPMAILER_LANG['invalid_header'] = 'Nome ou valor do cabeçalho inválido.';
+$PHPMAILER_LANG['invalid_hostentry'] = 'Entrada de host inválida: ';
+$PHPMAILER_LANG['invalid_host'] = 'Host inválido: ';
+$PHPMAILER_LANG['mailer_not_supported'] = 'O cliente de e-mail não é suportado.';
+$PHPMAILER_LANG['provide_address'] = 'Deve fornecer pelo menos um endereço de destinatário.';
+$PHPMAILER_LANG['recipients_failed'] = 'Erro SMTP: Falha no envio para os seguintes destinatários: ';
+$PHPMAILER_LANG['signing'] = 'Erro ao assinar: ';
+$PHPMAILER_LANG['smtp_code'] = 'Código SMTP: ';
+$PHPMAILER_LANG['smtp_code_ex'] = 'Informações adicionais SMTP: ';
+$PHPMAILER_LANG['smtp_connect_failed'] = 'Falha na função SMTP connect().';
+$PHPMAILER_LANG['smtp_detail'] = 'Detalhes: ';
+$PHPMAILER_LANG['smtp_error'] = 'Erro do servidor SMTP: ';
+$PHPMAILER_LANG['variable_set'] = 'Não foi possível definir ou redefinir a variável: ';
diff --git a/api/vendor/phpmailer/phpmailer/src/PHPMailer.php b/api/vendor/phpmailer/phpmailer/src/PHPMailer.php
index 4a6077c0..2444bcf3 100644
--- a/api/vendor/phpmailer/phpmailer/src/PHPMailer.php
+++ b/api/vendor/phpmailer/phpmailer/src/PHPMailer.php
@@ -580,6 +580,10 @@ class PHPMailer
* May be a callable to inject your own validator, but there are several built-in validators.
* The default validator uses PHP's FILTER_VALIDATE_EMAIL filter_var option.
*
+ * If CharSet is UTF8, the validator is left at the default value,
+ * and you send to addresses that use non-ASCII local parts, then
+ * PHPMailer automatically changes to the 'eai' validator.
+ *
* @see PHPMailer::validateAddress()
*
* @var string|callable
@@ -659,6 +663,14 @@ class PHPMailer
*/
protected $ReplyToQueue = [];
+ /**
+ * Whether the need for SMTPUTF8 has been detected. Set by
+ * preSend() if necessary.
+ *
+ * @var bool
+ */
+ public $UseSMTPUTF8 = false;
+
/**
* The array of attachments.
*
@@ -756,7 +768,7 @@ class PHPMailer
*
* @var string
*/
- const VERSION = '6.9.3';
+ const VERSION = '6.10.0';
/**
* Error severity: message only, continue processing.
@@ -1110,19 +1122,22 @@ class PHPMailer
$params = [$kind, $address, $name];
//Enqueue addresses with IDN until we know the PHPMailer::$CharSet.
//Domain is assumed to be whatever is after the last @ symbol in the address
- if (static::idnSupported() && $this->has8bitChars(substr($address, ++$pos))) {
- if ('Reply-To' !== $kind) {
- if (!array_key_exists($address, $this->RecipientsQueue)) {
- $this->RecipientsQueue[$address] = $params;
+ if ($this->has8bitChars(substr($address, ++$pos))) {
+ if (static::idnSupported()) {
+ if ('Reply-To' !== $kind) {
+ if (!array_key_exists($address, $this->RecipientsQueue)) {
+ $this->RecipientsQueue[$address] = $params;
+
+ return true;
+ }
+ } elseif (!array_key_exists($address, $this->ReplyToQueue)) {
+ $this->ReplyToQueue[$address] = $params;
return true;
}
- } elseif (!array_key_exists($address, $this->ReplyToQueue)) {
- $this->ReplyToQueue[$address] = $params;
-
- return true;
}
-
+ //We have an 8-bit domain, but we are missing the necessary extensions to support it
+ //Or we are already sending to this address
return false;
}
@@ -1160,6 +1175,15 @@ class PHPMailer
*/
protected function addAnAddress($kind, $address, $name = '')
{
+ if (
+ self::$validator === 'php' &&
+ ((bool) preg_match('/[\x80-\xFF]/', $address))
+ ) {
+ //The caller has not altered the validator and is sending to an address
+ //with UTF-8, so assume that they want UTF-8 support instead of failing
+ $this->CharSet = self::CHARSET_UTF8;
+ self::$validator = 'eai';
+ }
if (!in_array($kind, ['to', 'cc', 'bcc', 'Reply-To'])) {
$error_message = sprintf(
'%s: %s',
@@ -1362,6 +1386,7 @@ class PHPMailer
* * `pcre` Use old PCRE implementation;
* * `php` Use PHP built-in FILTER_VALIDATE_EMAIL;
* * `html5` Use the pattern given by the HTML5 spec for 'email' type form input elements.
+ * * `eai` Use a pattern similar to the HTML5 spec for 'email' and to firefox, extended to support EAI (RFC6530).
* * `noregex` Don't use a regex: super fast, really dumb.
* Alternatively you may pass in a callable to inject your own validator, for example:
*
@@ -1432,6 +1457,24 @@ class PHPMailer
'[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/sD',
$address
);
+ case 'eai':
+ /*
+ * This is the pattern used in the HTML5 spec for validation of 'email' type
+ * form input elements (as above), modified to accept Unicode email addresses.
+ * This is also more lenient than Firefox' html5 spec, in order to make the regex faster.
+ * 'eai' is an acronym for Email Address Internationalization.
+ * This validator is selected automatically if you attempt to use recipient addresses
+ * that contain Unicode characters in the local part.
+ *
+ * @see https://html.spec.whatwg.org/#e-mail-state-(type=email)
+ * @see https://en.wikipedia.org/wiki/International_email
+ */
+ return (bool) preg_match(
+ '/^[-\p{L}\p{N}\p{M}.!#$%&\'*+\/=?^_`{|}~]+@[\p{L}\p{N}\p{M}](?:[\p{L}\p{N}\p{M}-]{0,61}' .
+ '[\p{L}\p{N}\p{M}])?(?:\.[\p{L}\p{N}\p{M}]' .
+ '(?:[-\p{L}\p{N}\p{M}]{0,61}[\p{L}\p{N}\p{M}])?)*$/usD',
+ $address
+ );
case 'php':
default:
return filter_var($address, FILTER_VALIDATE_EMAIL) !== false;
@@ -1565,9 +1608,26 @@ class PHPMailer
$this->error_count = 0; //Reset errors
$this->mailHeader = '';
+ //The code below tries to support full use of Unicode,
+ //while remaining compatible with legacy SMTP servers to
+ //the greatest degree possible: If the message uses
+ //Unicode in the local parts of any addresses, it is sent
+ //using SMTPUTF8. If not, it it sent using
+ //punycode-encoded domains and plain SMTP.
+ if (
+ static::CHARSET_UTF8 === strtolower($this->CharSet) &&
+ ($this->anyAddressHasUnicodeLocalPart($this->RecipientsQueue) ||
+ $this->anyAddressHasUnicodeLocalPart(array_keys($this->all_recipients)) ||
+ $this->anyAddressHasUnicodeLocalPart($this->ReplyToQueue) ||
+ $this->addressHasUnicodeLocalPart($this->From))
+ ) {
+ $this->UseSMTPUTF8 = true;
+ }
//Dequeue recipient and Reply-To addresses with IDN
foreach (array_merge($this->RecipientsQueue, $this->ReplyToQueue) as $params) {
- $params[1] = $this->punyencodeAddress($params[1]);
+ if (!$this->UseSMTPUTF8) {
+ $params[1] = $this->punyencodeAddress($params[1]);
+ }
call_user_func_array([$this, 'addAnAddress'], $params);
}
if (count($this->to) + count($this->cc) + count($this->bcc) < 1) {
@@ -2058,6 +2118,11 @@ class PHPMailer
if (!$this->smtpConnect($this->SMTPOptions)) {
throw new Exception($this->lang('smtp_connect_failed'), self::STOP_CRITICAL);
}
+ //If we have recipient addresses that need Unicode support,
+ //but the server doesn't support it, stop here
+ if ($this->UseSMTPUTF8 && !$this->smtp->getServerExt('SMTPUTF8')) {
+ throw new Exception($this->lang('no_smtputf8'), self::STOP_CRITICAL);
+ }
//Sender already validated in preSend()
if ('' === $this->Sender) {
$smtp_from = $this->From;
@@ -2159,6 +2224,7 @@ class PHPMailer
$this->smtp->setDebugLevel($this->SMTPDebug);
$this->smtp->setDebugOutput($this->Debugoutput);
$this->smtp->setVerp($this->do_verp);
+ $this->smtp->setSMTPUTF8($this->UseSMTPUTF8);
if ($this->Host === null) {
$this->Host = 'localhost';
}
@@ -2356,6 +2422,7 @@ class PHPMailer
'smtp_detail' => 'Detail: ',
'smtp_error' => 'SMTP server error: ',
'variable_set' => 'Cannot set or reset variable: ',
+ 'no_smtputf8' => 'Server does not support SMTPUTF8 needed to send to Unicode addresses',
];
if (empty($lang_path)) {
//Calculate an absolute path so it can work if CWD is not here
@@ -2870,7 +2937,9 @@ class PHPMailer
$bodyEncoding = $this->Encoding;
$bodyCharSet = $this->CharSet;
//Can we do a 7-bit downgrade?
- if (static::ENCODING_8BIT === $bodyEncoding && !$this->has8bitChars($this->Body)) {
+ if ($this->UseSMTPUTF8) {
+ $bodyEncoding = static::ENCODING_8BIT;
+ } elseif (static::ENCODING_8BIT === $bodyEncoding && !$this->has8bitChars($this->Body)) {
$bodyEncoding = static::ENCODING_7BIT;
//All ISO 8859, Windows codepage and UTF-8 charsets are ascii compatible up to 7-bit
$bodyCharSet = static::CHARSET_ASCII;
@@ -3507,7 +3576,8 @@ class PHPMailer
/**
* Encode a header value (not including its label) optimally.
* Picks shortest of Q, B, or none. Result includes folding if needed.
- * See RFC822 definitions for phrase, comment and text positions.
+ * See RFC822 definitions for phrase, comment and text positions,
+ * and RFC2047 for inline encodings.
*
* @param string $str The header value to encode
* @param string $position What context the string will be used in
@@ -3516,6 +3586,11 @@ class PHPMailer
*/
public function encodeHeader($str, $position = 'text')
{
+ $position = strtolower($position);
+ if ($this->UseSMTPUTF8 && !("comment" === $position)) {
+ return trim(static::normalizeBreaks($str));
+ }
+
$matchcount = 0;
switch (strtolower($position)) {
case 'phrase':
@@ -4180,7 +4255,7 @@ class PHPMailer
if ('smtp' === $this->Mailer && null !== $this->smtp) {
$lasterror = $this->smtp->getError();
if (!empty($lasterror['error'])) {
- $msg .= $this->lang('smtp_error') . $lasterror['error'];
+ $msg .= ' ' . $this->lang('smtp_error') . $lasterror['error'];
if (!empty($lasterror['detail'])) {
$msg .= ' ' . $this->lang('smtp_detail') . $lasterror['detail'];
}
@@ -4267,6 +4342,45 @@ class PHPMailer
return filter_var('https://' . $host, FILTER_VALIDATE_URL) !== false;
}
+ /**
+ * Check whether the supplied address uses Unicode in the local part.
+ *
+ * @return bool
+ */
+ protected function addressHasUnicodeLocalPart($address)
+ {
+ return (bool) preg_match('/[\x80-\xFF].*@/', $address);
+ }
+
+ /**
+ * Check whether any of the supplied addresses use Unicode in the local part.
+ *
+ * @return bool
+ */
+ protected function anyAddressHasUnicodeLocalPart($addresses)
+ {
+ foreach ($addresses as $address) {
+ if (is_array($address)) {
+ $address = $address[0];
+ }
+ if ($this->addressHasUnicodeLocalPart($address)) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /**
+ * Check whether the message requires SMTPUTF8 based on what's known so far.
+ *
+ * @return bool
+ */
+ public function needsSMTPUTF8()
+ {
+ return $this->UseSMTPUTF8;
+ }
+
+
/**
* Get an error message in the current language.
*
diff --git a/api/vendor/phpmailer/phpmailer/src/POP3.php b/api/vendor/phpmailer/phpmailer/src/POP3.php
index 376fae2a..1190a1e2 100644
--- a/api/vendor/phpmailer/phpmailer/src/POP3.php
+++ b/api/vendor/phpmailer/phpmailer/src/POP3.php
@@ -46,7 +46,7 @@ class POP3
*
* @var string
*/
- const VERSION = '6.9.3';
+ const VERSION = '6.10.0';
/**
* Default POP3 port number.
diff --git a/api/vendor/phpmailer/phpmailer/src/SMTP.php b/api/vendor/phpmailer/phpmailer/src/SMTP.php
index b4eff404..7226ee93 100644
--- a/api/vendor/phpmailer/phpmailer/src/SMTP.php
+++ b/api/vendor/phpmailer/phpmailer/src/SMTP.php
@@ -35,7 +35,7 @@ class SMTP
*
* @var string
*/
- const VERSION = '6.9.3';
+ const VERSION = '6.10.0';
/**
* SMTP line break constant.
@@ -159,6 +159,15 @@ class SMTP
*/
public $do_verp = false;
+ /**
+ * Whether to use SMTPUTF8.
+ *
+ * @see https://www.rfc-editor.org/rfc/rfc6531
+ *
+ * @var bool
+ */
+ public $do_smtputf8 = false;
+
/**
* The timeout value for connection, in seconds.
* Default of 5 minutes (300sec) is from RFC2821 section 4.5.3.2.
@@ -913,7 +922,15 @@ class SMTP
* $from. Returns true if successful or false otherwise. If True
* the mail transaction is started and then one or more recipient
* commands may be called followed by a data command.
- * Implements RFC 821: MAIL FROM: .
+ * Implements RFC 821: MAIL FROM: and
+ * two extensions, namely XVERP and SMTPUTF8.
+ *
+ * The server's EHLO response is not checked. If use of either
+ * extensions is enabled even though the server does not support
+ * that, mail submission will fail.
+ *
+ * XVERP is documented at https://www.postfix.org/VERP_README.html
+ * and SMTPUTF8 is specified in RFC 6531.
*
* @param string $from Source address of this message
*
@@ -922,10 +939,11 @@ class SMTP
public function mail($from)
{
$useVerp = ($this->do_verp ? ' XVERP' : '');
+ $useSmtputf8 = ($this->do_smtputf8 ? ' SMTPUTF8' : '');
return $this->sendCommand(
'MAIL FROM',
- 'MAIL FROM:<' . $from . '>' . $useVerp,
+ 'MAIL FROM:<' . $from . '>' . $useSmtputf8 . $useVerp,
250
);
}
@@ -1364,6 +1382,26 @@ class SMTP
return $this->do_verp;
}
+ /**
+ * Enable or disable use of SMTPUTF8.
+ *
+ * @param bool $enabled
+ */
+ public function setSMTPUTF8($enabled = false)
+ {
+ $this->do_smtputf8 = $enabled;
+ }
+
+ /**
+ * Get SMTPUTF8 use.
+ *
+ * @return bool
+ */
+ public function getSMTPUTF8()
+ {
+ return $this->do_smtputf8;
+ }
+
/**
* Set error messages and codes.
*
diff --git a/api/vendor/phpoffice/phpspreadsheet/CHANGELOG.md b/api/vendor/phpoffice/phpspreadsheet/CHANGELOG.md
new file mode 100644
index 00000000..8084e7b0
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/CHANGELOG.md
@@ -0,0 +1,1705 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com)
+and this project adheres to [Semantic Versioning](https://semver.org).
+
+# 2025-02-07 - 2.3.8
+
+### Fixed
+
+- Xls writer Parser Mishandling True/False Argument. Backport of [PR #4333](https://github.com/PHPOffice/PhpSpreadsheet/pull/4333)
+- Xls writer Parser Parse By Character Not Byte. Backport of [PR #4344](https://github.com/PHPOffice/PhpSpreadsheet/pull/4344)
+
+# 2025-01-26 - 2.3.7
+
+### Fixed
+
+- Backported security patch for control characters in protocol.
+- Use Composer\Pcre in Xls/Parser. Partial backport of [PR #4203](https://github.com/PHPOffice/PhpSpreadsheet/pull/4203)
+
+# 2025-01-11 - 2.3.6
+
+### Deprecated
+
+- Worksheet::getHashCode is no longer needed.
+
+### Fixed
+
+- Backported security patch for Html navigation.
+- Change hash code for worksheet. Backport of [PR #4207](https://github.com/PHPOffice/PhpSpreadsheet/pull/4207)
+- Retitling cloned worksheets. Backport of [PR #4302](https://github.com/PHPOffice/PhpSpreadsheet/pull/4302)
+
+
+# 2024-12-26 - 2.3.5
+
+### Deprecated
+
+- Drawing::setIsUrl is unneeded. The property is set when setPath determines whether path is a url.
+
+### Fixed
+
+- More context options may be needed for http(s) image. Backport of [PR #4276](https://github.com/PHPOffice/PhpSpreadsheet/pull/4276)
+- Backported security patches for Samples.
+- Backported security patches for Html Writer.
+
+## 2024-12-08 - 2.3.4
+
+### Fixed
+
+- Fix Minor Break Handling Drawings. Backport of [PR #4244](https://github.com/PHPOffice/PhpSpreadsheet/pull/4244)
+- Swapped Row and Column Indexes in Reference Helper. Backport of [PR #4247](https://github.com/PHPOffice/PhpSpreadsheet/pull/4247)
+- Upgrade locked version of Dompdf (Php8.4 compatibility).
+- Remove unnecessary files from Composer package.
+
+## 2024-11-22 - 2.3.3
+
+### Changed
+
+- Settings::libXmlLoaderOptions is ignored. Backport of [PR #4233](https://github.com/PHPOffice/PhpSpreadsheet/pull/4233)
+
+### Deprecated
+
+- Settings::setLibXmlLoaderOptions() and Settings::getLibXmlLoaderOptions() are no longer needed - no replacement.
+
+## 2024-11-10 - 2.3.2
+
+### Fixed
+
+- 2.3.1 omitted.
+- Backported security patches.
+- Write ignoredErrors Tag Before Drawings. Backport of [PR #4212](https://github.com/PHPOffice/PhpSpreadsheet/pull/4212) intended for 3.4.0.
+- Changes to ROUNDDOWN/ROUNDUP/TRUNC. Backport of [PR #4214](https://github.com/PHPOffice/PhpSpreadsheet/pull/4214) intended for 3.4.0.
+
+### Added
+
+- Method to Test Whether Csv Will Be Affected by Php9. Backport of [PR #4189](https://github.com/PHPOffice/PhpSpreadsheet/pull/4189) intended for 3.4.0.
+
+## 2024-09-29 - 2.3.0
+
+### Fixed
+
+- Backported security patches.
+- Improve Xlsx Reader speed (backport of PR #4153 intended for 3.0.0). [Issue #3917](https://github.com/PHPOffice/PhpSpreadsheet/issues/3917)
+- Change to Csv Reader (see below under Deprecated). Backport of PR #4162 intended for 3.0.0. [Issue #4161](https://github.com/PHPOffice/PhpSpreadsheet/issues/4161)
+- Tweak to AMORDEGRC. Backport of PR #4164 intended for 3.0.0.
+
+### Changed
+
+- Images will not be added to spreadsheet if they cannot be validated as images.
+
+### Deprecated
+
+- Php8.4 will deprecate the escape parameter of fgetcsv. Csv Reader is affected by this; code is changed to be unaffected, but this will mean a breaking change is coming with Php9. Any code which uses the default escape value of backslash will fail in Php9. It is recommended to explicitly set the escape value to null string before then.
+
+## 2024-08-07 - 2.2.2
+
+### Added
+
+- Nothing yet.
+
+### Changed
+
+- Nothing yet.
+
+### Deprecated
+
+- Nothing yet.
+
+### Moved
+
+- Nothing yet.
+
+### Fixed
+
+- Html Reader Preserve Unicode Whitespace. [Issue #1284](https://github.com/PHPOffice/PhpSpreadsheet/issues/1284) [PR #4106](https://github.com/PHPOffice/PhpSpreadsheet/pull/4106)
+- RATE Function Floating Point Number of Periods. [PR #4107](https://github.com/PHPOffice/PhpSpreadsheet/pull/4107)
+- Parameter Name Change Xlsx Writer Workbook. [Issue #4108](https://github.com/PHPOffice/PhpSpreadsheet/issues/4108) [PR #4111](https://github.com/PHPOffice/PhpSpreadsheet/pull/4111)
+- New Algorithm for TRUNC, ROUNDUP, ROUNDDOWN. [Issue #4113](https://github.com/PHPOffice/PhpSpreadsheet/issues/4113) [PR #4115](https://github.com/PHPOffice/PhpSpreadsheet/pull/4115)
+- Worksheet applyStylesFromArray Retain Active Cell (Excel 16 was having a problem with some files). [Issue #4128](https://github.com/PHPOffice/PhpSpreadsheet/issues/4128) [PR #4132](https://github.com/PHPOffice/PhpSpreadsheet/pull/4132)
+
+## 2024-07-29 - 2.2.1
+
+### Security Fix
+
+- Prevent XXE when loading files [PR #4119](https://github.com/PHPOffice/PhpSpreadsheet/pull/4119)
+
+### Fixed
+
+- Add Sheet may leave Active Sheet uninitialized. [Issue #4112](https://github.com/PHPOffice/PhpSpreadsheet/issues/4112) [PR #4114](https://github.com/PHPOffice/PhpSpreadsheet/pull/4114)
+- Reference to Defined Name Specifying Worksheet. [Issue #206](https://github.com/PHPOffice/PhpSpreadsheet/issues/296) [PR #4096](https://github.com/PHPOffice/PhpSpreadsheet/pull/4096)
+- Xls Reader Print/Show Gridlines. [Issue #912](https://github.com/PHPOffice/PhpSpreadsheet/issues/912) [PR #4098](https://github.com/PHPOffice/PhpSpreadsheet/pull/4098)
+- ODS Reader Allow Omission of Page Settings Tags. [Issue #4099](https://github.com/PHPOffice/PhpSpreadsheet/issues/4099) [PR #4101](https://github.com/PHPOffice/PhpSpreadsheet/pull/4101)
+
+## 2024-07-24 - 2.2.0
+
+### Added
+
+- Xlsx Reader Optionally Ignore Rows With No Cells. [Issue #3982](https://github.com/PHPOffice/PhpSpreadsheet/issues/3982) [PR #4035](https://github.com/PHPOffice/PhpSpreadsheet/pull/4035)
+- Means to change style without affecting current cell/sheet. [PR #4073](https://github.com/PHPOffice/PhpSpreadsheet/pull/4073)
+- Option for CSV output file to have varying numbers of columns for each row. [Issue #1415](https://github.com/PHPOffice/PhpSpreadsheet/issues/1415) [PR #4076](https://github.com/PHPOffice/PhpSpreadsheet/pull/4076)
+
+### Changed
+
+- On read, Xlsx Reader had been breaking up union ranges into separate individual ranges. It will now try to preserve range as it was read in. [PR #4042](https://github.com/PHPOffice/PhpSpreadsheet/pull/4042)
+- Xlsx/Xls spreadsheet calculation and formatting of dates will use base date of spreadsheet even when spreadsheets with different base dates are simultaneously open. [Issue #1036](https://github.com/PHPOffice/PhpSpreadsheet/issues/1036) [Issue #1635](https://github.com/PHPOffice/PhpSpreadsheet/issues/1635) [PR #4071](https://github.com/PHPOffice/PhpSpreadsheet/pull/4071)
+
+### Deprecated
+
+- Writer\Xls\Style\ColorMap is no longer needed.
+
+### Moved
+
+- Nothing
+
+### Fixed
+
+- Incorrect Reader CSV with BOM. [Issue #4028](https://github.com/PHPOffice/PhpSpreadsheet/issues/4028) [PR #4029](https://github.com/PHPOffice/PhpSpreadsheet/pull/4029)
+- POWER Null/Bool Args. [PR #4031](https://github.com/PHPOffice/PhpSpreadsheet/pull/4031)
+- Do Not Output Alignment and Protection for Conditional Format. [Issue #4025](https://github.com/PHPOffice/PhpSpreadsheet/issues/4025) [PR #4027](https://github.com/PHPOffice/PhpSpreadsheet/pull/4027)
+- Conditional Color Scale Improvements. [Issue #4049](https://github.com/PHPOffice/PhpSpreadsheet/issues/4049) [PR #4050](https://github.com/PHPOffice/PhpSpreadsheet/pull/4050)
+- Mpdf and Tcpdf Borders on Merged Cells. [Issue #3557](https://github.com/PHPOffice/PhpSpreadsheet/issues/3557) [PR #4047](https://github.com/PHPOffice/PhpSpreadsheet/pull/4047)
+- Xls Conditional Format Improvements. [PR #4030](https://github.com/PHPOffice/PhpSpreadsheet/pull/4030) [PR #4033](https://github.com/PHPOffice/PhpSpreadsheet/pull/4033)
+- Conditional Range Unions and Intersections [Issue #4039](https://github.com/PHPOffice/PhpSpreadsheet/issues/4039) [PR #4042](https://github.com/PHPOffice/PhpSpreadsheet/pull/4042)
+- Ods comments with newlines. [Issue #4081](https://github.com/PHPOffice/PhpSpreadsheet/issues/4081) [PR #4086](https://github.com/PHPOffice/PhpSpreadsheet/pull/4086)
+- Propagate errors in Text functions. [Issue #2581](https://github.com/PHPOffice/PhpSpreadsheet/issues/2581) [PR #4080](https://github.com/PHPOffice/PhpSpreadsheet/pull/4080)
+- Csv Reader allow use of html mimetype. [Issue #4036](https://github.com/PHPOffice/PhpSpreadsheet/issues/4036) [PR #4040](https://github.com/PHPOffice/PhpSpreadsheet/pull/4040)
+- Problem rendering line chart with missing plot label. [PR #4074](https://github.com/PHPOffice/PhpSpreadsheet/pull/4074)
+- More RTL in Xlsx/Html Comments [Issue #4004](https://github.com/PHPOffice/PhpSpreadsheet/issues/4004) [PR #4065](https://github.com/PHPOffice/PhpSpreadsheet/pull/4065)
+- Empty String in sharedStrings. [Issue #4063](https://github.com/PHPOffice/PhpSpreadsheet/issues/4063) [PR #4064](https://github.com/PHPOffice/PhpSpreadsheet/pull/4064)
+- Xlsx Writer RichText and TYPE_STRING. [Issue #476](https://github.com/PHPOffice/PhpSpreadsheet/issues/476) [PR #4094](https://github.com/PHPOffice/PhpSpreadsheet/pull/4094)
+- Ods boolean data. [Issue #460](https://github.com/PHPOffice/PhpSpreadsheet/issues/460) [PR #4093](https://github.com/PHPOffice/PhpSpreadsheet/pull/4093)
+- Html Writer Minor Fixes. [PR #4089](https://github.com/PHPOffice/PhpSpreadsheet/pull/4089)
+- Changes to INDEX function. [Issue #64](https://github.com/PHPOffice/PhpSpreadsheet/issues/64) [PR #4088](https://github.com/PHPOffice/PhpSpreadsheet/pull/4088)
+- Ods Reader and Whitespace Text Nodes. [Issue #804](https://github.com/PHPOffice/PhpSpreadsheet/issues/804) [PR #4087](https://github.com/PHPOffice/PhpSpreadsheet/pull/4087)
+- Ods Xml Reader and Whitespace Text Nodes. [Issue #804](https://github.com/PHPOffice/PhpSpreadsheet/issues/804) [PR #4087](https://github.com/PHPOffice/PhpSpreadsheet/pull/4087)
+- Treat invalid formulas as strings. [Issue #1310](https://github.com/PHPOffice/PhpSpreadsheet/issues/1310) [PR #4073](https://github.com/PHPOffice/PhpSpreadsheet/pull/4073)
+
+## 2024-05-11 - 2.1.0
+
+### MINOR BREAKING CHANGE
+
+- Writing of cell comments to Html will now sanitize all Html tags within the comment, so the tags will be rendered as plaintext and have no other effects when rendered. Styling can be achieved by using the Font property of of the TextRuns which make up the comment, as is already the cases for Xlsx. [PR #3957](https://github.com/PHPOffice/PhpSpreadsheet/pull/3957)
+
+### Added
+
+- Default Style Alignment Property (workaround for bug in non-Excel spreadsheet apps) [Issue #3918](https://github.com/PHPOffice/PhpSpreadsheet/issues/3918) [PR #3924](https://github.com/PHPOffice/PhpSpreadsheet/pull/3924)
+- Additional Support for Date/Time Styles [PR #3939](https://github.com/PHPOffice/PhpSpreadsheet/pull/3939)
+
+### Changed
+
+- Nothing
+
+### Deprecated
+
+- Reader/Xml trySimpleXMLLoadString should not have had public visibility, and will be removed.
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- IF Empty Arguments. [Issue #3875](https://github.com/PHPOffice/PhpSpreadsheet/issues/3875) [Issue #2146](https://github.com/PHPOffice/PhpSpreadsheet/issues/2146) [PR #3879](https://github.com/PHPOffice/PhpSpreadsheet/pull/3879)
+- Changes to floating point in Php8.4. [Issue #3896](https://github.com/PHPOffice/PhpSpreadsheet/issues/3896) [PR #3897](https://github.com/PHPOffice/PhpSpreadsheet/pull/3897)
+- Handling User-supplied Decimal and Thousands Separators. [Issue #3900](https://github.com/PHPOffice/PhpSpreadsheet/issues/3900) [PR #3903](https://github.com/PHPOffice/PhpSpreadsheet/pull/3903)
+- Improve Performance of CSV Writer. [Issue #3904](https://github.com/PHPOffice/PhpSpreadsheet/issues/3904) [PR #3906](https://github.com/PHPOffice/PhpSpreadsheet/pull/3906)
+- Fix issue with prepending zero in percentage [Issue #3920](https://github.com/PHPOffice/PhpSpreadsheet/issues/3920) [PR #3921](https://github.com/PHPOffice/PhpSpreadsheet/pull/3921)
+- Incorrect SUMPRODUCT Calculation [Issue #3909](https://github.com/PHPOffice/PhpSpreadsheet/issues/3909) [PR #3916](https://github.com/PHPOffice/PhpSpreadsheet/pull/3916)
+- Formula Misidentifying Text as Cell After Insertion/Deletion [Issue #3907](https://github.com/PHPOffice/PhpSpreadsheet/issues/3907) [PR #3915](https://github.com/PHPOffice/PhpSpreadsheet/pull/3915)
+- Unexpected Absolute Address in Xlsx Rels [Issue #3730](https://github.com/PHPOffice/PhpSpreadsheet/issues/3730) [PR #3923](https://github.com/PHPOffice/PhpSpreadsheet/pull/3923)
+- Unallocated Cells Affected by Column/Row Insert/Delete [Issue #3933](https://github.com/PHPOffice/PhpSpreadsheet/issues/3933) [PR #3940](https://github.com/PHPOffice/PhpSpreadsheet/pull/3940)
+- Invalid Builtin Defined Name in Xls Reader [Issue #3935](https://github.com/PHPOffice/PhpSpreadsheet/issues/3935) [PR #3942](https://github.com/PHPOffice/PhpSpreadsheet/pull/3942)
+- Hidden Rows and Columns Tcpdf/Mpdf [PR #3945](https://github.com/PHPOffice/PhpSpreadsheet/pull/3945)
+- RTL Text Alignment in Xlsx Comments [Issue #4004](https://github.com/PHPOffice/PhpSpreadsheet/issues/4004) [PR #4006](https://github.com/PHPOffice/PhpSpreadsheet/pull/4006)
+- Protect Sheet But Allow Sort [Issue #3951](https://github.com/PHPOffice/PhpSpreadsheet/issues/3951) [PR #3956](https://github.com/PHPOffice/PhpSpreadsheet/pull/3956)
+- Default Value for Conditional::$text [PR #3946](https://github.com/PHPOffice/PhpSpreadsheet/pull/3946)
+- Table Filter Buttons [Issue #3988](https://github.com/PHPOffice/PhpSpreadsheet/issues/3988) [PR #3992](https://github.com/PHPOffice/PhpSpreadsheet/pull/3992)
+- Improvements to Xml Reader [Issue #3999](https://github.com/PHPOffice/PhpSpreadsheet/issues/3999) [Issue #4000](https://github.com/PHPOffice/PhpSpreadsheet/issues/4000) [Issue #4001](https://github.com/PHPOffice/PhpSpreadsheet/issues/4001) [Issue #4002](https://github.com/PHPOffice/PhpSpreadsheet/issues/4002) [PR #4003](https://github.com/PHPOffice/PhpSpreadsheet/pull/4003) [PR #4007](https://github.com/PHPOffice/PhpSpreadsheet/pull/4007)
+- Html Reader non-UTF8 [Issue #3995](https://github.com/PHPOffice/PhpSpreadsheet/issues/3995) [Issue #866](https://github.com/PHPOffice/PhpSpreadsheet/issues/866) [Issue #1681](https://github.com/PHPOffice/PhpSpreadsheet/issues/1681) [PR #4019](https://github.com/PHPOffice/PhpSpreadsheet/pull/4019)
+
+## 2.0.0 - 2024-01-04
+
+### BREAKING CHANGE
+
+- Typing was strengthened by leveraging native typing. This should not change any behavior. However, if you implement
+ any interfaces or inherit from any classes, you will need to adapt your typing accordingly. If you use static analysis
+ tools such as PHPStan or Psalm, new errors might be found. If you find actual bugs because of the new typing, please
+ open a PR that fixes it with a **detailed** explanation of the reason. We'll try to merge and release typing-related
+ fixes quickly in the coming days. [PR #3718](https://github.com/PHPOffice/PhpSpreadsheet/pull/3718)
+- All deprecated things have been removed, for details, see [816b91d0b4](https://github.com/PHPOffice/PhpSpreadsheet/commit/816b91d0b4a0c7285a9e3fc88c58f7730d922044)
+
+### Added
+
+- Split screens (Xlsx and Xml only, not 100% complete). [Issue #3601](https://github.com/PHPOffice/PhpSpreadsheet/issues/3601) [PR #3622](https://github.com/PHPOffice/PhpSpreadsheet/pull/3622)
+- Permit Meta Viewport in Html. [Issue #3565](https://github.com/PHPOffice/PhpSpreadsheet/issues/3565) [PR #3623](https://github.com/PHPOffice/PhpSpreadsheet/pull/3623)
+- Hyperlink support for Ods. [Issue #3660](https://github.com/PHPOffice/PhpSpreadsheet/issues/3660) [PR #3669](https://github.com/PHPOffice/PhpSpreadsheet/pull/3669)
+- ListWorksheetInfo/Names for Html/Csv/Slk. [Issue #3706](https://github.com/PHPOffice/PhpSpreadsheet/issues/3706) [PR #3709](https://github.com/PHPOffice/PhpSpreadsheet/pull/3709)
+- Methods to determine if cell is actually locked, or hidden on formula bar. [PR #3722](https://github.com/PHPOffice/PhpSpreadsheet/pull/3722)
+- Add iterateOnlyExistingCells to Constructors. [Issue #3721](https://github.com/PHPOffice/PhpSpreadsheet/issues/3721) [PR #3727](https://github.com/PHPOffice/PhpSpreadsheet/pull/3727)
+- Support for Conditional Formatting Color Scale. [PR #3738](https://github.com/PHPOffice/PhpSpreadsheet/pull/3738)
+- Support Additional Tags in Helper/Html. [Issue #3751](https://github.com/PHPOffice/PhpSpreadsheet/issues/3751) [PR #3752](https://github.com/PHPOffice/PhpSpreadsheet/pull/3752)
+- Writer ODS : Write Border Style for cells [Issue #3690](https://github.com/PHPOffice/PhpSpreadsheet/issues/3690) [PR #3693](https://github.com/PHPOffice/PhpSpreadsheet/pull/3693)
+- Sheet Background Images [Issue #1649](https://github.com/PHPOffice/PhpSpreadsheet/issues/1649) [PR #3795](https://github.com/PHPOffice/PhpSpreadsheet/pull/3795)
+- Check if Coordinate is Inside Range [PR #3779](https://github.com/PHPOffice/PhpSpreadsheet/pull/3779)
+- Flipping Images [Issue #731](https://github.com/PHPOffice/PhpSpreadsheet/issues/731) [PR #3801](https://github.com/PHPOffice/PhpSpreadsheet/pull/3801)
+- Chart Dynamic Title and Font Properties [Issue #3797](https://github.com/PHPOffice/PhpSpreadsheet/issues/3797) [PR #3800](https://github.com/PHPOffice/PhpSpreadsheet/pull/3800)
+- Chart Axis Display Units and Logarithmic Scale. [Issue #3833](https://github.com/PHPOffice/PhpSpreadsheet/issues/3833) [PR #3836](https://github.com/PHPOffice/PhpSpreadsheet/pull/3836)
+- Partial Support of Fill Handles. [Discussion #3847](https://github.com/PHPOffice/PhpSpreadsheet/discussions/3847) [PR #3855](https://github.com/PHPOffice/PhpSpreadsheet/pull/3855)
+
+### Changed
+
+- **Drop support for PHP 7.4**, according to https://phpspreadsheet.readthedocs.io/en/latest/#php-version-support [PR #3713](https://github.com/PHPOffice/PhpSpreadsheet/pull/3713)
+- RLM Added to NumberFormatter Currency. This happens depending on release of ICU which Php is using (it does not yet happen with any official release). PhpSpreadsheet will continue to use the value returned by Php, but a method is added to keep the result unchanged from release to release. [Issue #3571](https://github.com/PHPOffice/PhpSpreadsheet/issues/3571) [PR #3640](https://github.com/PHPOffice/PhpSpreadsheet/pull/3640)
+- `toFormattedString` will now always return a string. This was introduced with 1.28.0, but was not properly documented at the time. This can affect the results of `toArray`, `namedRangeToArray`, and `rangeToArray`. [PR #3304](https://github.com/PHPOffice/PhpSpreadsheet/pull/3304)
+- Value of constants FORMAT_CURRENCY_EUR and FORMAT_CURRENCY_USD was changed in 1.28.0, but was not properly documented at the time. [Issue #3577](https://github.com/PHPOffice/PhpSpreadsheet/issues/3577)
+- Html Writer will attempt to use Chart coordinates to determine image size. [Issue #3783](https://github.com/PHPOffice/PhpSpreadsheet/issues/3783) [PR #3787](https://github.com/PHPOffice/PhpSpreadsheet/pull/3787)
+
+### Deprecated
+
+- Functions `_translateFormulaToLocale` and `_translateFormulaEnglish` are replaced by versions without leading underscore. [PR #3828](https://github.com/PHPOffice/PhpSpreadsheet/pull/3828)
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Take advantage of mitoteam/jpgraph Extended mode to enable rendering of more graphs. [PR #3603](https://github.com/PHPOffice/PhpSpreadsheet/pull/3603)
+- Column widths, especially for ODS. [Issue #3609](https://github.com/PHPOffice/PhpSpreadsheet/issues/3609) [PR #3610](https://github.com/PHPOffice/PhpSpreadsheet/pull/3610)
+- Avoid NULL in String Function call (partial solution). [Issue #3613](https://github.com/PHPOffice/PhpSpreadsheet/issues/3613) [PR #3617](https://github.com/PHPOffice/PhpSpreadsheet/pull/3617)
+- Preserve transparency in Memory Drawing. [Issue #3624](https://github.com/PHPOffice/PhpSpreadsheet/issues/3624) [PR #3627](https://github.com/PHPOffice/PhpSpreadsheet/pull/3627)
+- Customizable padding for Exact Column Width. [Issue #3626](https://github.com/PHPOffice/PhpSpreadsheet/issues/3626) [PR #3628](https://github.com/PHPOffice/PhpSpreadsheet/pull/3628)
+- Ensure ROW function returns int (problem exposed in unreleased Php). [PR #3641](https://github.com/PHPOffice/PhpSpreadsheet/pull/3641)
+- Minor changes to Mpdf and Html Writers. [PR #3645](https://github.com/PHPOffice/PhpSpreadsheet/pull/3645)
+- Xlsx Reader Namespacing for Tables, Autofilters. [Issue #3665](https://github.com/PHPOffice/PhpSpreadsheet/issues/3665) [PR #3668](https://github.com/PHPOffice/PhpSpreadsheet/pull/3668)
+- Read Code Page for Xls ListWorksheetInfo/Names BIFF5. [Issue #3671](https://github.com/PHPOffice/PhpSpreadsheet/issues/3671) [PR #3672](https://github.com/PHPOffice/PhpSpreadsheet/pull/3672)
+- Read Data from Table on Different Sheet. [Issue #3635](https://github.com/PHPOffice/PhpSpreadsheet/issues/3635) [PR #3659](https://github.com/PHPOffice/PhpSpreadsheet/pull/3659)
+- Html Writer Styles Using Inline Css. [Issue #3678](https://github.com/PHPOffice/PhpSpreadsheet/issues/3678) [PR #3680](https://github.com/PHPOffice/PhpSpreadsheet/pull/3680)
+- Xlsx Read Ignoring Some Comments. [Issue #3654](https://github.com/PHPOffice/PhpSpreadsheet/issues/3654) [PR #3655](https://github.com/PHPOffice/PhpSpreadsheet/pull/3655)
+- Fractional Seconds in Date/Time Values. [PR #3677](https://github.com/PHPOffice/PhpSpreadsheet/pull/3677)
+- SetCalculatedValue Avoid Casting String to Numeric. [Issue #3658](https://github.com/PHPOffice/PhpSpreadsheet/issues/3658) [PR #3685](https://github.com/PHPOffice/PhpSpreadsheet/pull/3685)
+- Several Problems in a Very Complicated Spreadsheet. [Issue #3679](https://github.com/PHPOffice/PhpSpreadsheet/issues/3679) [PR #3681](https://github.com/PHPOffice/PhpSpreadsheet/pull/3681)
+- Inconsistent String Handling for Sum Functions. [Issue #3652](https://github.com/PHPOffice/PhpSpreadsheet/issues/3652) [PR #3653](https://github.com/PHPOffice/PhpSpreadsheet/pull/3653)
+- Recomputation of Relative Addresses in Defined Names. [Issue #3661](https://github.com/PHPOffice/PhpSpreadsheet/issues/3661) [PR #3673](https://github.com/PHPOffice/PhpSpreadsheet/pull/3673)
+- Writer Xls Characters Outside BMP (emojis). [Issue #642](https://github.com/PHPOffice/PhpSpreadsheet/issues/642) [PR #3696](https://github.com/PHPOffice/PhpSpreadsheet/pull/3696)
+- Xlsx Reader Improve Handling of Row and Column Styles. [Issue #3533](https://github.com/PHPOffice/PhpSpreadsheet/issues/3533) [Issue #3534](https://github.com/PHPOffice/PhpSpreadsheet/issues/3534) [PR #3688](https://github.com/PHPOffice/PhpSpreadsheet/pull/3688)
+- Avoid Allocating RowDimension Unneccesarily. [PR #3686](https://github.com/PHPOffice/PhpSpreadsheet/pull/3686)
+- Use Column Style when Row Dimension Exists Without Style. [Issue #3534](https://github.com/PHPOffice/PhpSpreadsheet/issues/3534) [PR #3688](https://github.com/PHPOffice/PhpSpreadsheet/pull/3688)
+- Inconsistency Between Cell Data and Explicitly Declared Type. [Issue #3711](https://github.com/PHPOffice/PhpSpreadsheet/issues/3711) [PR #3715](https://github.com/PHPOffice/PhpSpreadsheet/pull/3715)
+- Unexpected Namespacing in rels File. [Issue #3720](https://github.com/PHPOffice/PhpSpreadsheet/issues/3720) [PR #3722](https://github.com/PHPOffice/PhpSpreadsheet/pull/3722)
+- Break Some Circular References. [PR #3716](https://github.com/PHPOffice/PhpSpreadsheet/pull/3716) [PR #3707](https://github.com/PHPOffice/PhpSpreadsheet/pull/3707)
+- Missing Font Index in Some Xls. [PR #3734](https://github.com/PHPOffice/PhpSpreadsheet/pull/3734)
+- Load Tables even with READ_DATA_ONLY. [PR #3726](https://github.com/PHPOffice/PhpSpreadsheet/pull/3726)
+- Theme File Missing but Referenced in Spreadsheet. [Issue #3770](https://github.com/PHPOffice/PhpSpreadsheet/issues/3770) [PR #3772](https://github.com/PHPOffice/PhpSpreadsheet/pull/3772)
+- Slk Shared Formulas. [Issue #2267](https://github.com/PHPOffice/PhpSpreadsheet/issues/2267) [PR #3776](https://github.com/PHPOffice/PhpSpreadsheet/pull/3776)
+- Html omitting some charts. [Issue #3767](https://github.com/PHPOffice/PhpSpreadsheet/issues/3767) [PR #3771](https://github.com/PHPOffice/PhpSpreadsheet/pull/3771)
+- Case Insensitive Comparison for Sheet Names [PR #3791](https://github.com/PHPOffice/PhpSpreadsheet/pull/3791)
+- Performance improvement for Xlsx Reader. [Issue #3683](https://github.com/PHPOffice/PhpSpreadsheet/issues/3683) [PR #3810](https://github.com/PHPOffice/PhpSpreadsheet/pull/3810)
+- Prevent loop in Shared/File. [Issue #3807](https://github.com/PHPOffice/PhpSpreadsheet/issues/3807) [PR #3809](https://github.com/PHPOffice/PhpSpreadsheet/pull/3809)
+- Consistent handling of decimal/thousands separators between StringHelper and Php setlocale. [Issue #3811](https://github.com/PHPOffice/PhpSpreadsheet/issues/3811) [PR #3815](https://github.com/PHPOffice/PhpSpreadsheet/pull/3815)
+- Clone worksheet with tables or charts. [Issue #3820](https://github.com/PHPOffice/PhpSpreadsheet/issues/3820) [PR #3821](https://github.com/PHPOffice/PhpSpreadsheet/pull/3821)
+- COUNTIFS Does Not Require xlfn. [Issue #3819](https://github.com/PHPOffice/PhpSpreadsheet/issues/3819) [PR #3827](https://github.com/PHPOffice/PhpSpreadsheet/pull/3827)
+- Strip `xlfn.` and `xlws.` from Formula Translations. [Issue #3819](https://github.com/PHPOffice/PhpSpreadsheet/issues/3819) [PR #3828](https://github.com/PHPOffice/PhpSpreadsheet/pull/3828)
+- Recurse directories searching for font file. [Issue #2809](https://github.com/PHPOffice/PhpSpreadsheet/issues/2809) [PR #3830](https://github.com/PHPOffice/PhpSpreadsheet/pull/3830)
+- Reduce memory consumption of Worksheet::rangeToArray() when many empty rows are read. [Issue #3814](https://github.com/PHPOffice/PhpSpreadsheet/issues/3814) [PR #3834](https://github.com/PHPOffice/PhpSpreadsheet/pull/3834)
+- Reduce time used by Worksheet::rangeToArray() when many empty rows are read. [PR #3839](https://github.com/PHPOffice/PhpSpreadsheet/pull/3839)
+- Html Reader Tolerate Invalid Sheet Title. [PR #3845](https://github.com/PHPOffice/PhpSpreadsheet/pull/3845)
+- Do not include unparsed drawings when new drawing added. [Issue #3843](https://github.com/PHPOffice/PhpSpreadsheet/issues/3843) [PR #3846](https://github.com/PHPOffice/PhpSpreadsheet/pull/3846)
+- Do not include unparsed drawings when new drawing added. [Issue #3861](https://github.com/PHPOffice/PhpSpreadsheet/issues/3861) [PR #3862](https://github.com/PHPOffice/PhpSpreadsheet/pull/3862)
+- Excel omits `between` operator for data validation. [Issue #3863](https://github.com/PHPOffice/PhpSpreadsheet/issues/3863) [PR #3865](https://github.com/PHPOffice/PhpSpreadsheet/pull/3865)
+- Use less space when inserting rows and columns. [Issue #3687](https://github.com/PHPOffice/PhpSpreadsheet/issues/3687) [PR #3856](https://github.com/PHPOffice/PhpSpreadsheet/pull/3856)
+- Excel inconsistent handling of MIN/MAX/MINA/MAXA. [Issue #3866](https://github.com/PHPOffice/PhpSpreadsheet/issues/3866) [PR #3868](https://github.com/PHPOffice/PhpSpreadsheet/pull/3868)
+
+## 1.29.0 - 2023-06-15
+
+### Added
+
+- Wizards for defining Number Format masks for Dates and Times, including Durations/Intervals. [PR #3458](https://github.com/PHPOffice/PhpSpreadsheet/pull/3458)
+- Specify data type in html tags. [Issue #3444](https://github.com/PHPOffice/PhpSpreadsheet/issues/3444) [PR #3445](https://github.com/PHPOffice/PhpSpreadsheet/pull/3445)
+- Provide option to ignore hidden rows/columns in `toArray()` methods. [PR #3494](https://github.com/PHPOffice/PhpSpreadsheet/pull/3494)
+- Font/Effects/Theme support for Chart Data Labels and Axis. [PR #3476](https://github.com/PHPOffice/PhpSpreadsheet/pull/3476)
+- Font Themes support. [PR #3486](https://github.com/PHPOffice/PhpSpreadsheet/pull/3486)
+- Ability to Ignore Cell Errors in Excel. [Issue #1141](https://github.com/PHPOffice/PhpSpreadsheet/issues/1141) [PR #3508](https://github.com/PHPOffice/PhpSpreadsheet/pull/3508)
+- Unzipped Gnumeric file [PR #3591](https://github.com/PHPOffice/PhpSpreadsheet/pull/3591)
+
+### Changed
+
+- Xlsx Color schemes read in will be written out (previously Excel 2007-2010 Color scheme was always written); manipulation of those schemes before write, including restoring prior behavior, is provided [PR #3476](https://github.com/PHPOffice/PhpSpreadsheet/pull/3476)
+- Memory and speed optimisations for Read Filters with Xlsx Files and Shared Formulae. [PR #3474](https://github.com/PHPOffice/PhpSpreadsheet/pull/3474)
+- Allow `CellRange` and `CellAddress` objects for the `range` argument in the `rangeToArray()` method. [PR #3494](https://github.com/PHPOffice/PhpSpreadsheet/pull/3494)
+- Stock charts will now read and reproduce `upDownBars` and subsidiary tags; these were previously ignored on read and hard-coded on write. [PR #3515](https://github.com/PHPOffice/PhpSpreadsheet/pull/3515)
+
+### Deprecated
+
+- Nothing
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Updates Cell formula absolute ranges/references, and Defined Name absolute ranges/references when inserting/deleting rows/columns. [Issue #3368](https://github.com/PHPOffice/PhpSpreadsheet/issues/3368) [PR #3402](https://github.com/PHPOffice/PhpSpreadsheet/pull/3402)
+- EOMONTH() and EDATE() Functions should round date value before evaluation. [Issue #3436](https://github.com/PHPOffice/PhpSpreadsheet/issues/3436) [PR #3437](https://github.com/PHPOffice/PhpSpreadsheet/pull/3437)
+- NETWORKDAYS function erroneously being converted to NETWORK_xlfn.DAYS in Xlsx Writer. [Issue #3461](https://github.com/PHPOffice/PhpSpreadsheet/issues/3461) [PR #3463](https://github.com/PHPOffice/PhpSpreadsheet/pull/3463)
+- Getting a style for a CellAddress instance fails if the worksheet is set in the CellAddress instance. [Issue #3439](https://github.com/PHPOffice/PhpSpreadsheet/issues/3439) [PR #3469](https://github.com/PHPOffice/PhpSpreadsheet/pull/3469)
+- Shared Formulae outside the filter range when reading with a filter are not always being identified. [Issue #3473](https://github.com/PHPOffice/PhpSpreadsheet/issues/3473) [PR #3474](https://github.com/PHPOffice/PhpSpreadsheet/pull/3474)
+- Xls Reader Conditional Styles. [PR #3400](https://github.com/PHPOffice/PhpSpreadsheet/pull/3400)
+- Allow use of # and 0 digit placeholders in fraction masks. [PR #3401](https://github.com/PHPOffice/PhpSpreadsheet/pull/3401)
+- Modify Date/Time check in the NumberFormatter for decimal/fractional times. [PR #3413](https://github.com/PHPOffice/PhpSpreadsheet/pull/3413)
+- Misplaced Xml Writing Chart Label FillColor. [Issue #3397](https://github.com/PHPOffice/PhpSpreadsheet/issues/3397) [PR #3404](https://github.com/PHPOffice/PhpSpreadsheet/pull/3404)
+- TEXT function ignores Time in DateTimeStamp. [Issue #3409](https://github.com/PHPOffice/PhpSpreadsheet/issues/3409) [PR #3411](https://github.com/PHPOffice/PhpSpreadsheet/pull/3411)
+- Xlsx Column Autosize Approximate for CJK. [Issue #3405](https://github.com/PHPOffice/PhpSpreadsheet/issues/3405) [PR #3416](https://github.com/PHPOffice/PhpSpreadsheet/pull/3416)
+- Correct Xlsx Parsing of quotePrefix="0". [Issue #3435](https://github.com/PHPOffice/PhpSpreadsheet/issues/3435) [PR #3438](https://github.com/PHPOffice/PhpSpreadsheet/pull/3438)
+- More Display Options for Chart Axis and Legend. [Issue #3414](https://github.com/PHPOffice/PhpSpreadsheet/issues/3414) [PR #3434](https://github.com/PHPOffice/PhpSpreadsheet/pull/3434)
+- Apply strict type checking to Complex suffix. [PR #3452](https://github.com/PHPOffice/PhpSpreadsheet/pull/3452)
+- Incorrect Font Color Read Xlsx Rich Text Indexed Color Custom Palette. [Issue #3464](https://github.com/PHPOffice/PhpSpreadsheet/issues/3464) [PR #3465](https://github.com/PHPOffice/PhpSpreadsheet/pull/3465)
+- Xlsx Writer Honor Alignment in Default Font. [Issue #3443](https://github.com/PHPOffice/PhpSpreadsheet/issues/3443) [PR #3459](https://github.com/PHPOffice/PhpSpreadsheet/pull/3459)
+- Support Border for Charts. [PR #3462](https://github.com/PHPOffice/PhpSpreadsheet/pull/3462)
+- Error in "this row" structured reference calculation (cached result from first row when using a range) [Issue #3504](https://github.com/PHPOffice/PhpSpreadsheet/issues/3504) [PR #3505](https://github.com/PHPOffice/PhpSpreadsheet/pull/3505)
+- Allow colour palette index references in Number Format masks [Issue #3511](https://github.com/PHPOffice/PhpSpreadsheet/issues/3511) [PR #3512](https://github.com/PHPOffice/PhpSpreadsheet/pull/3512)
+- Xlsx Reader formula with quotePrefix [Issue #3495](https://github.com/PHPOffice/PhpSpreadsheet/issues/3495) [PR #3497](https://github.com/PHPOffice/PhpSpreadsheet/pull/3497)
+- Handle REF error as part of range [Issue #3453](https://github.com/PHPOffice/PhpSpreadsheet/issues/3453) [PR #3467](https://github.com/PHPOffice/PhpSpreadsheet/pull/3467)
+- Handle Absolute Pathnames in Rels File [Issue #3553](https://github.com/PHPOffice/PhpSpreadsheet/issues/3553) [PR #3554](https://github.com/PHPOffice/PhpSpreadsheet/pull/3554)
+- Return Page Breaks in Order [Issue #3552](https://github.com/PHPOffice/PhpSpreadsheet/issues/3552) [PR #3555](https://github.com/PHPOffice/PhpSpreadsheet/pull/3555)
+- Add position attribute for MemoryDrawing in Html [Issue #3529](https://github.com/PHPOffice/PhpSpreadsheet/issues/3529 [PR #3535](https://github.com/PHPOffice/PhpSpreadsheet/pull/3535)
+- Allow Index_number as Array for VLOOKUP/HLOOKUP [Issue #3561](https://github.com/PHPOffice/PhpSpreadsheet/issues/3561 [PR #3570](https://github.com/PHPOffice/PhpSpreadsheet/pull/3570)
+- Add Unsupported Options in Xml Spreadsheet [Issue #3566](https://github.com/PHPOffice/PhpSpreadsheet/issues/3566 [Issue #3568](https://github.com/PHPOffice/PhpSpreadsheet/issues/3568 [Issue #3569](https://github.com/PHPOffice/PhpSpreadsheet/issues/3569 [PR #3567](https://github.com/PHPOffice/PhpSpreadsheet/pull/3567)
+- Changes to NUMBERVALUE, VALUE, DATEVALUE, TIMEVALUE [Issue #3574](https://github.com/PHPOffice/PhpSpreadsheet/issues/3574 [PR #3575](https://github.com/PHPOffice/PhpSpreadsheet/pull/3575)
+- Redo calculation of color tinting [Issue #3550](https://github.com/PHPOffice/PhpSpreadsheet/issues/3550) [PR #3580](https://github.com/PHPOffice/PhpSpreadsheet/pull/3580)
+- Accommodate Slash with preg_quote [PR #3582](https://github.com/PHPOffice/PhpSpreadsheet/pull/3582) [PR #3583](https://github.com/PHPOffice/PhpSpreadsheet/pull/3583) [PR #3584](https://github.com/PHPOffice/PhpSpreadsheet/pull/3584)
+- HyperlinkBase Property and Html Handling of Properties [Issue #3573](https://github.com/PHPOffice/PhpSpreadsheet/issues/3573) [PR #3589](https://github.com/PHPOffice/PhpSpreadsheet/pull/3589)
+- Improvements for Data Validation [Issue #3592](https://github.com/PHPOffice/PhpSpreadsheet/issues/3592) [Issue #3594](https://github.com/PHPOffice/PhpSpreadsheet/issues/3594) [PR #3605](https://github.com/PHPOffice/PhpSpreadsheet/pull/3605)
+
+## 1.28.0 - 2023-02-25
+
+### Added
+
+- Support for configuring a Chart Title's overlay [PR #3325](https://github.com/PHPOffice/PhpSpreadsheet/pull/3325)
+- Wizards for defining Number Format masks for Numbers, Percentages, Scientific, Currency and Accounting [PR #3334](https://github.com/PHPOffice/PhpSpreadsheet/pull/3334)
+- Support for fixed value divisor in fractional Number Format Masks [PR #3339](https://github.com/PHPOffice/PhpSpreadsheet/pull/3339)
+- Allow More Fonts/Fontnames for Exact Width Calculation [PR #3326](https://github.com/PHPOffice/PhpSpreadsheet/pull/3326) [Issue #3190](https://github.com/PHPOffice/PhpSpreadsheet/issues/3190)
+- Allow override of the Value Binder when setting a Cell value [PR #3361](https://github.com/PHPOffice/PhpSpreadsheet/pull/3361)
+
+### Changed
+
+- Improved handling for @ placeholder in Number Format Masks [PR #3344](https://github.com/PHPOffice/PhpSpreadsheet/pull/3344)
+- Improved handling for ? placeholder in Number Format Masks [PR #3394](https://github.com/PHPOffice/PhpSpreadsheet/pull/3394)
+- Improved support for locale settings and currency codes when matching formatted strings to numerics in the Calculation Engine [PR #3373](https://github.com/PHPOffice/PhpSpreadsheet/pull/3373) and [PR #3374](https://github.com/PHPOffice/PhpSpreadsheet/pull/3374)
+- Improved support for locale settings and matching in the Advanced Value Binder [PR #3376](https://github.com/PHPOffice/PhpSpreadsheet/pull/3376)
+- `toFormattedString` will now always return a string. This can affect the results of `toArray`, `namedRangeToArray`, and `rangeToArray`. [PR #3304](https://github.com/PHPOffice/PhpSpreadsheet/pull/3304)
+- Value of constants FORMAT_CURRENCY_EUR and FORMAT_CURRENCY_USD is changed. [Issue #3577](https://github.com/PHPOffice/PhpSpreadsheet/issues/3577) [PR #3377](https://github.com/PHPOffice/PhpSpreadsheet/pull/3377)
+
+### Deprecated
+
+- Rationalisation of Pre-defined Currency Format Masks [PR #3377](https://github.com/PHPOffice/PhpSpreadsheet/pull/3377)
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Calculation Engine doesn't evaluate Defined Name when default cell A1 is quote-prefixed [Issue #3335](https://github.com/PHPOffice/PhpSpreadsheet/issues/3335) [PR #3336](https://github.com/PHPOffice/PhpSpreadsheet/pull/3336)
+- XLSX Writer - Array Formulas do not include function prefix [Issue #3337](https://github.com/PHPOffice/PhpSpreadsheet/issues/3337) [PR #3338](https://github.com/PHPOffice/PhpSpreadsheet/pull/3338)
+- Permit Max Column for Row Breaks [Issue #3143](https://github.com/PHPOffice/PhpSpreadsheet/issues/3143) [PR #3345](https://github.com/PHPOffice/PhpSpreadsheet/pull/3345)
+- AutoSize Columns should allow for dropdown icon when AutoFilter is for a Table [Issue #3356](https://github.com/PHPOffice/PhpSpreadsheet/issues/3356) [PR #3358](https://github.com/PHPOffice/PhpSpreadsheet/pull/3358) and for Center Alignment of Headers [Issue #3395](https://github.com/PHPOffice/PhpSpreadsheet/issues/3395) [PR #3399](https://github.com/PHPOffice/PhpSpreadsheet/pull/3399)
+- Decimal Precision for Scientific Number Format Mask [Issue #3381](https://github.com/PHPOffice/PhpSpreadsheet/issues/3381) [PR #3382](https://github.com/PHPOffice/PhpSpreadsheet/pull/3382)
+- Xls Writer Parser Handle Boolean Literals as Function Arguments [Issue #3369](https://github.com/PHPOffice/PhpSpreadsheet/issues/3369) [PR #3391](https://github.com/PHPOffice/PhpSpreadsheet/pull/3391)
+- Conditional Formatting Improvements for Xlsx [Issue #3370](https://github.com/PHPOffice/PhpSpreadsheet/issues/3370) [Issue #3202](https://github.com/PHPOffice/PhpSpreadsheet/issues/3302) [PR #3372](https://github.com/PHPOffice/PhpSpreadsheet/pull/3372)
+- Coerce Bool to Int for Mathematical Operations on Arrays [Issue #3389](https://github.com/PHPOffice/PhpSpreadsheet/issues/3389) [Issue #3396](https://github.com/PHPOffice/PhpSpreadsheet/issues/3396) [PR #3392](https://github.com/PHPOffice/PhpSpreadsheet/pull/3392)
+
+## 1.27.1 - 2023-02-08
+
+### Added
+
+- Nothing
+
+### Changed
+
+- Nothing
+
+### Deprecated
+
+- Nothing
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Fix Composer --dev dependency issue with dealerdirect/phpcodesniffer-composer-installer renaming their `master` branch to `main`
+
+
+## 1.27.0 - 2023-01-24
+
+### Added
+
+- Option to specify a range of columns/rows for the Row/Column `isEmpty()` methods [PR #3315](https://github.com/PHPOffice/PhpSpreadsheet/pull/3315)
+- Option for Cell Iterator to return a null value or create and return a new cell when accessing a cell that doesn't exist [PR #3314](https://github.com/PHPOffice/PhpSpreadsheet/pull/3314)
+- Support for Structured References in the Calculation Engine [PR #3261](https://github.com/PHPOffice/PhpSpreadsheet/pull/3261)
+- Limited Support for Form Controls [PR #3130](https://github.com/PHPOffice/PhpSpreadsheet/pull/3130) [Issue #2396](https://github.com/PHPOffice/PhpSpreadsheet/issues/2396) [Issue #1770](https://github.com/PHPOffice/PhpSpreadsheet/issues/1770) [Issue #2388](https://github.com/PHPOffice/PhpSpreadsheet/issues/2388) [Issue #2904](https://github.com/PHPOffice/PhpSpreadsheet/issues/2904) [Issue #2661](https://github.com/PHPOffice/PhpSpreadsheet/issues/2661)
+
+### Changed
+
+- Nothing
+
+### Deprecated
+
+- Nothing
+
+### Removed
+
+- Shared/JAMA is removed. [PR #3260](https://github.com/PHPOffice/PhpSpreadsheet/pull/3260)
+
+### Fixed
+
+- Namespace-Aware Code for SheetViewOptions, SheetProtection [PR #3230](https://github.com/PHPOffice/PhpSpreadsheet/pull/3230)
+- Additional Method for XIRR if Newton-Raphson Doesn't Converge [Issue #689](https://github.com/PHPOffice/PhpSpreadsheet/issues/689) [PR #3262](https://github.com/PHPOffice/PhpSpreadsheet/pull/3262)
+- Better Handling of Composite Charts [Issue #2333](https://github.com/PHPOffice/PhpSpreadsheet/issues/2333) [PR #3265](https://github.com/PHPOffice/PhpSpreadsheet/pull/3265)
+- Update Column Reference for Columns Beginning with Y and Z [Issue #3263](https://github.com/PHPOffice/PhpSpreadsheet/issues/3263) [PR #3264](https://github.com/PHPOffice/PhpSpreadsheet/pull/3264)
+- Honor Fit to 1-Page Height Html/Pdf [Issue #3266](https://github.com/PHPOffice/PhpSpreadsheet/issues/3266) [PR #3279](https://github.com/PHPOffice/PhpSpreadsheet/pull/3279)
+- AND/OR/XOR Handling of Literal Strings [PR #3287](https://github.com/PHPOffice/PhpSpreadsheet/pull/3287)
+- Xls Reader Vertical Break and Writer Page Order [Issue #3305](https://github.com/PHPOffice/PhpSpreadsheet/issues/3305) [PR #3306](https://github.com/PHPOffice/PhpSpreadsheet/pull/3306)
+
+
+## 1.26.0 - 2022-12-21
+
+### Added
+
+- Extended flag options for the Reader `load()` and Writer `save()` methods
+- Apply Row/Column limits (1048576 and XFD) in ReferenceHelper [PR #3213](https://github.com/PHPOffice/PhpSpreadsheet/pull/3213)
+- Allow the creation of In-Memory Drawings from a string of binary image data, or from a stream. [PR #3157](https://github.com/PHPOffice/PhpSpreadsheet/pull/3157)
+- Xlsx Reader support for Pivot Tables [PR #2829](https://github.com/PHPOffice/PhpSpreadsheet/pull/2829)
+- Permit Date/Time Entered on Spreadsheet to be calculated as Float [Issue #1416](https://github.com/PHPOffice/PhpSpreadsheet/issues/1416) [PR #3121](https://github.com/PHPOffice/PhpSpreadsheet/pull/3121)
+
+### Changed
+
+- Nothing
+
+### Deprecated
+
+- Direct update of Calculation::suppressFormulaErrors is replaced with setter.
+- Font public static variable defaultColumnWidths replaced with constant DEFAULT_COLUMN_WIDTHS.
+- ExcelError public static variable errorCodes replaced with constant ERROR_CODES.
+- NumberFormat constant FORMAT_DATE_YYYYMMDD2 replaced with existing identical FORMAT_DATE_YYYYMMDD.
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Fixed handling for `_xlws` prefixed functions from Office365 [Issue #3245](https://github.com/PHPOffice/PhpSpreadsheet/issues/3245) [PR #3247](https://github.com/PHPOffice/PhpSpreadsheet/pull/3247)
+- Conditionals formatting rules applied to rows/columns are removed [Issue #3184](https://github.com/PHPOffice/PhpSpreadsheet/issues/3184) [PR #3213](https://github.com/PHPOffice/PhpSpreadsheet/pull/3213)
+- Treat strings containing currency or accounting values as floats in Calculation Engine operations [Issue #3165](https://github.com/PHPOffice/PhpSpreadsheet/issues/3165) [PR #3189](https://github.com/PHPOffice/PhpSpreadsheet/pull/3189)
+- Treat strings containing percentage values as floats in Calculation Engine operations [Issue #3155](https://github.com/PHPOffice/PhpSpreadsheet/issues/3155) [PR #3156](https://github.com/PHPOffice/PhpSpreadsheet/pull/3156) and [PR #3164](https://github.com/PHPOffice/PhpSpreadsheet/pull/3164)
+- Xlsx Reader Accept Palette of Fewer than 64 Colors [Issue #3093](https://github.com/PHPOffice/PhpSpreadsheet/issues/3093) [PR #3096](https://github.com/PHPOffice/PhpSpreadsheet/pull/3096)
+- Use Locale-Independent Float Conversion for Xlsx Writer Custom Property [Issue #3095](https://github.com/PHPOffice/PhpSpreadsheet/issues/3095) [PR #3099](https://github.com/PHPOffice/PhpSpreadsheet/pull/3099)
+- Allow setting AutoFilter range on a single cell or row [Issue #3102](https://github.com/PHPOffice/PhpSpreadsheet/issues/3102) [PR #3111](https://github.com/PHPOffice/PhpSpreadsheet/pull/3111)
+- Xlsx Reader External Data Validations Flag Missing [Issue #2677](https://github.com/PHPOffice/PhpSpreadsheet/issues/2677) [PR #3078](https://github.com/PHPOffice/PhpSpreadsheet/pull/3078)
+- Reduces extra memory usage on `__destruct()` calls [PR #3092](https://github.com/PHPOffice/PhpSpreadsheet/pull/3092)
+- Additional properties for Trendlines [Issue #3011](https://github.com/PHPOffice/PhpSpreadsheet/issues/3011) [PR #3028](https://github.com/PHPOffice/PhpSpreadsheet/pull/3028)
+- Calculation suppressFormulaErrors fix [Issue #1531](https://github.com/PHPOffice/PhpSpreadsheet/issues/1531) [PR #3092](https://github.com/PHPOffice/PhpSpreadsheet/pull/3092)
+- Permit Date/Time Entered on Spreadsheet to be Calculated as Float [Issue #1416](https://github.com/PHPOffice/PhpSpreadsheet/issues/1416) [PR #3121](https://github.com/PHPOffice/PhpSpreadsheet/pull/3121)
+- Incorrect Handling of Data Validation Formula Containing Ampersand [Issue #3145](https://github.com/PHPOffice/PhpSpreadsheet/issues/3145) [PR #3146](https://github.com/PHPOffice/PhpSpreadsheet/pull/3146)
+- Xlsx Namespace Handling of Drawings, RowAndColumnAttributes, MergeCells [Issue #3138](https://github.com/PHPOffice/PhpSpreadsheet/issues/3138) [PR #3136](https://github.com/PHPOffice/PhpSpreadsheet/pull/3137)
+- Generation3 Copy With Image in Footer [Issue #3126](https://github.com/PHPOffice/PhpSpreadsheet/issues/3126) [PR #3140](https://github.com/PHPOffice/PhpSpreadsheet/pull/3140)
+- MATCH Function Problems with Int/Float Compare and Wildcards [Issue #3141](https://github.com/PHPOffice/PhpSpreadsheet/issues/3141) [PR #3142](https://github.com/PHPOffice/PhpSpreadsheet/pull/3142)
+- Fix ODS Read Filter on number-columns-repeated cell [Issue #3148](https://github.com/PHPOffice/PhpSpreadsheet/issues/3148) [PR #3149](https://github.com/PHPOffice/PhpSpreadsheet/pull/3149)
+- Problems Formatting Very Small and Very Large Numbers [Issue #3128](https://github.com/PHPOffice/PhpSpreadsheet/issues/3128) [PR #3152](https://github.com/PHPOffice/PhpSpreadsheet/pull/3152)
+- XlsxWrite preserve line styles for y-axis, not just x-axis [PR #3163](https://github.com/PHPOffice/PhpSpreadsheet/pull/3163)
+- Xlsx Namespace Handling of Drawings, RowAndColumnAttributes, MergeCells [Issue #3138](https://github.com/PHPOffice/PhpSpreadsheet/issues/3138) [PR #3137](https://github.com/PHPOffice/PhpSpreadsheet/pull/3137)
+- More Detail for Cyclic Error Messages [Issue #3169](https://github.com/PHPOffice/PhpSpreadsheet/issues/3169) [PR #3170](https://github.com/PHPOffice/PhpSpreadsheet/pull/3170)
+- Improved Documentation for Deprecations - many PRs [Issue #3162](https://github.com/PHPOffice/PhpSpreadsheet/issues/3162)
+
+
+## 1.25.2 - 2022-09-25
+
+### Added
+
+- Nothing
+
+### Changed
+
+- Nothing
+
+### Deprecated
+
+- Nothing
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Composer dependency clash with ezyang/htmlpurifier
+
+
+## 1.25.0 - 2022-09-25
+
+### Added
+
+- Implementation of the new `TEXTBEFORE()`, `TEXTAFTER()` and `TEXTSPLIT()` Excel Functions
+- Implementation of the `ARRAYTOTEXT()` and `VALUETOTEXT()` Excel Functions
+- Support for [mitoteam/jpgraph](https://packagist.org/packages/mitoteam/jpgraph) implementation of
+ JpGraph library to render charts added.
+- Charts: Add Gradients, Transparency, Hidden Axes, Rounded Corners, Trendlines, Date Axes.
+
+### Changed
+
+- Allow variant behaviour when merging cells [Issue #3065](https://github.com/PHPOffice/PhpSpreadsheet/issues/3065)
+ - Merge methods now allow an additional `$behaviour` argument. Permitted values are:
+ - Worksheet::MERGE_CELL_CONTENT_EMPTY - Empty the content of the hidden cells (the default behaviour)
+ - Worksheet::MERGE_CELL_CONTENT_HIDE - Keep the content of the hidden cells
+ - Worksheet::MERGE_CELL_CONTENT_MERGE - Move the content of the hidden cells into the first cell
+
+### Deprecated
+
+- Axis getLineProperty deprecated in favor of getLineColorProperty.
+- Moved majorGridlines and minorGridlines from Chart to Axis. Setting either in Chart constructor or through Chart methods, or getting either using Chart methods is deprecated.
+- Chart::EXCEL_COLOR_TYPE_* copied from Properties to ChartColor; use in Properties is deprecated.
+- ChartColor::EXCEL_COLOR_TYPE_ARGB deprecated in favor of EXCEL_COLOR_TYPE_RGB ("A" component was never allowed).
+- Misspelled Properties::LINE_STYLE_DASH_SQUERE_DOT deprecated in favor of LINE_STYLE_DASH_SQUARE_DOT.
+- Clone not permitted for Spreadsheet. Spreadsheet->copy() can be used instead.
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Fix update to defined names when inserting/deleting rows/columns [Issue #3076](https://github.com/PHPOffice/PhpSpreadsheet/issues/3076) [PR #3077](https://github.com/PHPOffice/PhpSpreadsheet/pull/3077)
+- Fix DataValidation sqRef when inserting/deleting rows/columns [Issue #3056](https://github.com/PHPOffice/PhpSpreadsheet/issues/3056) [PR #3074](https://github.com/PHPOffice/PhpSpreadsheet/pull/3074)
+- Named ranges not usable as anchors in OFFSET function [Issue #3013](https://github.com/PHPOffice/PhpSpreadsheet/issues/3013)
+- Fully flatten an array [Issue #2955](https://github.com/PHPOffice/PhpSpreadsheet/issues/2955) [PR #2956](https://github.com/PHPOffice/PhpSpreadsheet/pull/2956)
+- cellExists() and getCell() methods should support UTF-8 named cells [Issue #2987](https://github.com/PHPOffice/PhpSpreadsheet/issues/2987) [PR #2988](https://github.com/PHPOffice/PhpSpreadsheet/pull/2988)
+- Spreadsheet copy fixed, clone disabled. [PR #2951](https://github.com/PHPOffice/PhpSpreadsheet/pull/2951)
+- Fix PDF problems with text rotation and paper size. [Issue #1747](https://github.com/PHPOffice/PhpSpreadsheet/issues/1747) [Issue #1713](https://github.com/PHPOffice/PhpSpreadsheet/issues/1713) [PR #2960](https://github.com/PHPOffice/PhpSpreadsheet/pull/2960)
+- Limited support for chart titles as formulas [Issue #2965](https://github.com/PHPOffice/PhpSpreadsheet/issues/2965) [Issue #749](https://github.com/PHPOffice/PhpSpreadsheet/issues/749) [PR #2971](https://github.com/PHPOffice/PhpSpreadsheet/pull/2971)
+- Add Gradients, Transparency, and Hidden Axes to Chart [Issue #2257](https://github.com/PHPOffice/PhpSpreadsheet/issues/2257) [Issue #2229](https://github.com/PHPOffice/PhpSpreadsheet/issues/2929) [Issue #2935](https://github.com/PHPOffice/PhpSpreadsheet/issues/2935) [PR #2950](https://github.com/PHPOffice/PhpSpreadsheet/pull/2950)
+- Chart Support for Rounded Corners and Trendlines [Issue #2968](https://github.com/PHPOffice/PhpSpreadsheet/issues/2968) [Issue #2815](https://github.com/PHPOffice/PhpSpreadsheet/issues/2815) [PR #2976](https://github.com/PHPOffice/PhpSpreadsheet/pull/2976)
+- Add setName Method for Chart [Issue #2991](https://github.com/PHPOffice/PhpSpreadsheet/issues/2991) [PR #3001](https://github.com/PHPOffice/PhpSpreadsheet/pull/3001)
+- Eliminate partial dependency on php-intl in StringHelper [Issue #2982](https://github.com/PHPOffice/PhpSpreadsheet/issues/2982) [PR #2994](https://github.com/PHPOffice/PhpSpreadsheet/pull/2994)
+- Minor changes for Pdf [Issue #2999](https://github.com/PHPOffice/PhpSpreadsheet/issues/2999) [PR #3002](https://github.com/PHPOffice/PhpSpreadsheet/pull/3002) [PR #3006](https://github.com/PHPOffice/PhpSpreadsheet/pull/3006)
+- Html/Pdf Do net set background color for cells using (default) nofill [PR #3016](https://github.com/PHPOffice/PhpSpreadsheet/pull/3016)
+- Add support for Date Axis to Chart [Issue #2967](https://github.com/PHPOffice/PhpSpreadsheet/issues/2967) [PR #3018](https://github.com/PHPOffice/PhpSpreadsheet/pull/3018)
+- Reconcile Differences Between Css and Excel for Cell Alignment [PR #3048](https://github.com/PHPOffice/PhpSpreadsheet/pull/3048)
+- R1C1 Format Internationalization and Better Support for Relative Offsets [Issue #1704](https://github.com/PHPOffice/PhpSpreadsheet/issues/1704) [PR #3052](https://github.com/PHPOffice/PhpSpreadsheet/pull/3052)
+- Minor Fix for Percentage Formatting [Issue #1929](https://github.com/PHPOffice/PhpSpreadsheet/issues/1929) [PR #3053](https://github.com/PHPOffice/PhpSpreadsheet/pull/3053)
+
+## 1.24.1 - 2022-07-18
+
+### Added
+
+- Support for SimpleCache Interface versions 1.0, 2.0 and 3.0
+- Add Chart Axis Option textRotation [Issue #2705](https://github.com/PHPOffice/PhpSpreadsheet/issues/2705) [PR #2940](https://github.com/PHPOffice/PhpSpreadsheet/pull/2940)
+
+### Changed
+
+- Nothing
+
+### Deprecated
+
+- Nothing
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Fix Encoding issue with Html reader (PHP 8.2 deprecation for mb_convert_encoding) [Issue #2942](https://github.com/PHPOffice/PhpSpreadsheet/issues/2942) [PR #2943](https://github.com/PHPOffice/PhpSpreadsheet/pull/2943)
+- Additional Chart fixes
+ - Pie chart with part separated unwantedly [Issue #2506](https://github.com/PHPOffice/PhpSpreadsheet/issues/2506) [PR #2928](https://github.com/PHPOffice/PhpSpreadsheet/pull/2928)
+ - Chart styling is lost on simple load / save process [Issue #1797](https://github.com/PHPOffice/PhpSpreadsheet/issues/1797) [Issue #2077](https://github.com/PHPOffice/PhpSpreadsheet/issues/2077) [PR #2930](https://github.com/PHPOffice/PhpSpreadsheet/pull/2930)
+ - Can't create contour chart (surface 2d) [Issue #2931](https://github.com/PHPOffice/PhpSpreadsheet/issues/2931) [PR #2933](https://github.com/PHPOffice/PhpSpreadsheet/pull/2933)
+- VLOOKUP Breaks When Array Contains Null Cells [Issue #2934](https://github.com/PHPOffice/PhpSpreadsheet/issues/2934) [PR #2939](https://github.com/PHPOffice/PhpSpreadsheet/pull/2939)
+
+## 1.24.0 - 2022-07-09
+
+Note that this will be the last 1.x branch release before the 2.x release. We will maintain both branches in parallel for a time; but users are requested to update to version 2.0 once that is fully available.
+
+### Added
+
+- Added `removeComment()` method for Worksheet [PR #2875](https://github.com/PHPOffice/PhpSpreadsheet/pull/2875/files)
+- Add point size option for scatter charts [Issue #2298](https://github.com/PHPOffice/PhpSpreadsheet/issues/2298) [PR #2801](https://github.com/PHPOffice/PhpSpreadsheet/pull/2801)
+- Basic support for Xlsx reading/writing Chart Sheets [PR #2830](https://github.com/PHPOffice/PhpSpreadsheet/pull/2830)
+
+ Note that a ChartSheet is still only written as a normal Worksheet containing a single chart, not as an actual ChartSheet.
+
+- Added Worksheet visibility in Ods Reader [PR #2851](https://github.com/PHPOffice/PhpSpreadsheet/pull/2851) and Gnumeric Reader [PR #2853](https://github.com/PHPOffice/PhpSpreadsheet/pull/2853)
+- Added Worksheet visibility in Ods Writer [PR #2850](https://github.com/PHPOffice/PhpSpreadsheet/pull/2850)
+- Allow Csv Reader to treat string as contents of file [Issue #1285](https://github.com/PHPOffice/PhpSpreadsheet/issues/1285) [PR #2792](https://github.com/PHPOffice/PhpSpreadsheet/pull/2792)
+- Allow Csv Reader to store null string rather than leave cell empty [Issue #2840](https://github.com/PHPOffice/PhpSpreadsheet/issues/2840) [PR #2842](https://github.com/PHPOffice/PhpSpreadsheet/pull/2842)
+- Provide new Worksheet methods to identify if a row or column is "empty", making allowance for different definitions of "empty":
+ - Treat rows/columns containing no cell records as empty (default)
+ - Treat cells containing a null value as empty
+ - Treat cells containing an empty string as empty
+
+### Changed
+
+- Modify `rangeBoundaries()`, `rangeDimension()` and `getRangeBoundaries()` Coordinate methods to work with row/column ranges as well as with cell ranges and cells [PR #2926](https://github.com/PHPOffice/PhpSpreadsheet/pull/2926)
+- Better enforcement of value modification to match specified datatype when using `setValueExplicit()`
+- Relax validation of merge cells to allow merge for a single cell reference [Issue #2776](https://github.com/PHPOffice/PhpSpreadsheet/issues/2776)
+- Memory and speed improvements, particularly for the Cell Collection, and the Writers.
+
+ See [the Discussion section on github](https://github.com/PHPOffice/PhpSpreadsheet/discussions/2821) for details of performance across versions
+- Improved performance for removing rows/columns from a worksheet
+
+### Deprecated
+
+- Nothing
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Xls Reader resolving absolute named ranges to relative ranges [Issue #2826](https://github.com/PHPOffice/PhpSpreadsheet/issues/2826) [PR #2827](https://github.com/PHPOffice/PhpSpreadsheet/pull/2827)
+- Null value handling in the Excel Math/Trig PRODUCT() function [Issue #2833](https://github.com/PHPOffice/PhpSpreadsheet/issues/2833) [PR #2834](https://github.com/PHPOffice/PhpSpreadsheet/pull/2834)
+- Invalid Print Area defined in Xlsx corrupts internal storage of print area [Issue #2848](https://github.com/PHPOffice/PhpSpreadsheet/issues/2848) [PR #2849](https://github.com/PHPOffice/PhpSpreadsheet/pull/2849)
+- Time interval formatting [Issue #2768](https://github.com/PHPOffice/PhpSpreadsheet/issues/2768) [PR #2772](https://github.com/PHPOffice/PhpSpreadsheet/pull/2772)
+- Copy from Xls(x) to Html/Pdf loses drawings [PR #2788](https://github.com/PHPOffice/PhpSpreadsheet/pull/2788)
+- Html Reader converting cell containing 0 to null string [Issue #2810](https://github.com/PHPOffice/PhpSpreadsheet/issues/2810) [PR #2813](https://github.com/PHPOffice/PhpSpreadsheet/pull/2813)
+- Many fixes for Charts, especially, but not limited to, Scatter, Bubble, and Surface charts. [Issue #2762](https://github.com/PHPOffice/PhpSpreadsheet/issues/2762) [Issue #2299](https://github.com/PHPOffice/PhpSpreadsheet/issues/2299) [Issue #2700](https://github.com/PHPOffice/PhpSpreadsheet/issues/2700) [Issue #2817](https://github.com/PHPOffice/PhpSpreadsheet/issues/2817) [Issue #2763](https://github.com/PHPOffice/PhpSpreadsheet/issues/2763) [Issue #2219](https://github.com/PHPOffice/PhpSpreadsheet/issues/2219) [Issue #2863](https://github.com/PHPOffice/PhpSpreadsheet/issues/2863) [PR #2828](https://github.com/PHPOffice/PhpSpreadsheet/pull/2828) [PR #2841](https://github.com/PHPOffice/PhpSpreadsheet/pull/2841) [PR #2846](https://github.com/PHPOffice/PhpSpreadsheet/pull/2846) [PR #2852](https://github.com/PHPOffice/PhpSpreadsheet/pull/2852) [PR #2856](https://github.com/PHPOffice/PhpSpreadsheet/pull/2856) [PR #2865](https://github.com/PHPOffice/PhpSpreadsheet/pull/2865) [PR #2872](https://github.com/PHPOffice/PhpSpreadsheet/pull/2872) [PR #2879](https://github.com/PHPOffice/PhpSpreadsheet/pull/2879) [PR #2898](https://github.com/PHPOffice/PhpSpreadsheet/pull/2898) [PR #2906](https://github.com/PHPOffice/PhpSpreadsheet/pull/2906) [PR #2922](https://github.com/PHPOffice/PhpSpreadsheet/pull/2922) [PR #2923](https://github.com/PHPOffice/PhpSpreadsheet/pull/2923)
+- Adjust both coordinates for two-cell anchors when rows/columns are added/deleted. [Issue #2908](https://github.com/PHPOffice/PhpSpreadsheet/issues/2908) [PR #2909](https://github.com/PHPOffice/PhpSpreadsheet/pull/2909)
+- Keep calculated string results below 32K. [PR #2921](https://github.com/PHPOffice/PhpSpreadsheet/pull/2921)
+- Filter out illegal Unicode char values FFFE/FFFF. [Issue #2897](https://github.com/PHPOffice/PhpSpreadsheet/issues/2897) [PR #2910](https://github.com/PHPOffice/PhpSpreadsheet/pull/2910)
+- Better handling of REF errors and propagation of all errors in Calculation engine. [PR #2902](https://github.com/PHPOffice/PhpSpreadsheet/pull/2902)
+- Calculating Engine regexp for Column/Row references when there are multiple quoted worksheet references in the formula [Issue #2874](https://github.com/PHPOffice/PhpSpreadsheet/issues/2874) [PR #2899](https://github.com/PHPOffice/PhpSpreadsheet/pull/2899)
+
+## 1.23.0 - 2022-04-24
+
+### Added
+
+- Ods Writer support for Freeze Pane [Issue #2013](https://github.com/PHPOffice/PhpSpreadsheet/issues/2013) [PR #2755](https://github.com/PHPOffice/PhpSpreadsheet/pull/2755)
+- Ods Writer support for setting column width/row height (including the use of AutoSize) [Issue #2346](https://github.com/PHPOffice/PhpSpreadsheet/issues/2346) [PR #2753](https://github.com/PHPOffice/PhpSpreadsheet/pull/2753)
+- Introduced CellAddress, CellRange, RowRange and ColumnRange value objects that can be used as an alternative to a string value (e.g. `'C5'`, `'B2:D4'`, `'2:2'` or `'B:C'`) in appropriate contexts.
+- Implementation of the FILTER(), SORT(), SORTBY() and UNIQUE() Lookup/Reference (array) functions.
+- Implementation of the ISREF() Information function.
+- Added support for reading "formatted" numeric values from Csv files; although default behaviour of reading these values as strings is preserved.
+
+ (i.e a value of "12,345.67" can be read as numeric `12345.67`, not simply as a string `"12,345.67"`, if the `castFormattedNumberToNumeric()` setting is enabled.
+
+ This functionality is locale-aware, using the server's locale settings to identify the thousands and decimal separators.
+
+- Support for two cell anchor drawing of images. [#2532](https://github.com/PHPOffice/PhpSpreadsheet/pull/2532) [#2674](https://github.com/PHPOffice/PhpSpreadsheet/pull/2674)
+- Limited support for Xls Reader to handle Conditional Formatting:
+
+ Ranges and Rules are read, but style is currently limited to font size, weight and color; and to fill style and color.
+
+- Add ability to suppress Mac line ending check for CSV [#2623](https://github.com/PHPOffice/PhpSpreadsheet/pull/2623)
+- Initial support for creating and writing Tables (Xlsx Writer only) [PR #2671](https://github.com/PHPOffice/PhpSpreadsheet/pull/2671)
+
+ See `/samples/Table` for examples of use.
+
+ Note that PreCalculateFormulas needs to be disabled when saving spreadsheets containing tables with formulae (totals or column formulae).
+
+### Changed
+
+- Gnumeric Reader now loads number formatting for cells.
+- Gnumeric Reader now correctly identifies selected worksheet and selected cells in a worksheet.
+- Some Refactoring of the Ods Reader, moving all formula and address translation from Ods to Excel into a separate class to eliminate code duplication and ensure consistency.
+- Make Boolean Conversion in Csv Reader locale-aware when using the String Value Binder.
+
+ This is determined by the Calculation Engine locale setting.
+
+ (i.e. `"Vrai"` wil be converted to a boolean `true` if the Locale is set to `fr`.)
+- Allow `psr/simple-cache` 2.x
+
+### Deprecated
+
+- All Excel Function implementations in `Calculation\Functions` (including the Error functions) have been moved to dedicated classes for groups of related functions. See the docblocks against all the deprecated methods for details of the new methods to call instead. At some point, these old classes will be deleted.
+- Worksheet methods that reference cells "byColumnandRow". All such methods have an equivalent that references the cell by its address (e.g. '`E3'` rather than `5, 3`).
+
+ These functions now accept either a cell address string (`'E3')` or an array with columnId and rowId (`[5, 3]`) or a new `CellAddress` object as their `cellAddress`/`coordinate` argument.
+ This includes the methods:
+ - `setCellValueByColumnAndRow()` use the equivalent `setCellValue()`
+ - `setCellValueExplicitByColumnAndRow()` use the equivalent `setCellValueExplicit()`
+ - `getCellByColumnAndRow()` use the equivalent `getCell()`
+ - `cellExistsByColumnAndRow()` use the equivalent `cellExists()`
+ - `getStyleByColumnAndRow()` use the equivalent `getStyle()`
+ - `setBreakByColumnAndRow()` use the equivalent `setBreak()`
+ - `mergeCellsByColumnAndRow()` use the equivalent `mergeCells()`
+ - `unmergeCellsByColumnAndRow()` use the equivalent `unmergeCells()`
+ - `protectCellsByColumnAndRow()` use the equivalent `protectCells()`
+ - `unprotectCellsByColumnAndRow()` use the equivalent `unprotectCells()`
+ - `setAutoFilterByColumnAndRow()` use the equivalent `setAutoFilter()`
+ - `freezePaneByColumnAndRow()` use the equivalent `freezePane()`
+ - `getCommentByColumnAndRow()` use the equivalent `getComment()`
+ - `setSelectedCellByColumnAndRow()` use the equivalent `setSelectedCells()`
+
+ This change provides more consistency in the methods (not every "by cell address" method has an equivalent "byColumnAndRow" method);
+ and the "by cell address" methods often provide more flexibility, such as allowing a range of cells, or referencing them by passing the defined name of a named range as the argument.
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Make allowance for the AutoFilter dropdown icon in the first row of an Autofilter range when using Autosize columns. [Issue #2413](https://github.com/PHPOffice/PhpSpreadsheet/issues/2413) [PR #2754](https://github.com/PHPOffice/PhpSpreadsheet/pull/2754)
+- Support for "chained" ranges (e.g. `A5:C10:C20:F1`) in the Calculation Engine; and also support for using named ranges with the Range operator (e.g. `NamedRange1:NamedRange2`) [Issue #2730](https://github.com/PHPOffice/PhpSpreadsheet/issues/2730) [PR #2746](https://github.com/PHPOffice/PhpSpreadsheet/pull/2746)
+- Update Conditional Formatting ranges and rule conditions when inserting/deleting rows/columns [Issue #2678](https://github.com/PHPOffice/PhpSpreadsheet/issues/2678) [PR #2689](https://github.com/PHPOffice/PhpSpreadsheet/pull/2689)
+- Allow `INDIRECT()` to accept row/column ranges as well as cell ranges [PR #2687](https://github.com/PHPOffice/PhpSpreadsheet/pull/2687)
+- Fix bug when deleting cells with hyperlinks, where the hyperlink was then being "inherited" by whatever cell moved to that cell address.
+- Fix bug in Conditional Formatting in the Xls Writer that resulted in a broken file when there were multiple conditional ranges in a worksheet.
+- Fix Conditional Formatting in the Xls Writer to work with rules that contain string literals, cell references and formulae.
+- Fix for setting Active Sheet to the first loaded worksheet when bookViews element isn't defined [Issue #2666](https://github.com/PHPOffice/PhpSpreadsheet/issues/2666) [PR #2669](https://github.com/PHPOffice/PhpSpreadsheet/pull/2669)
+- Fixed behaviour of XLSX font style vertical align settings [PR #2619](https://github.com/PHPOffice/PhpSpreadsheet/pull/2619)
+- Resolved formula translations to handle separators (row and column) for array functions as well as for function argument separators; and cleanly handle nesting levels.
+
+ Note that this method is used when translating Excel functions between `en_us` and other locale languages, as well as when converting formulae between different spreadsheet formats (e.g. Ods to Excel).
+
+ Nor is this a perfect solution, as there may still be issues when function calls have array arguments that themselves contain function calls; but it's still better than the current logic.
+- Fix for escaping double quotes within a formula [Issue #1971](https://github.com/PHPOffice/PhpSpreadsheet/issues/1971) [PR #2651](https://github.com/PHPOffice/PhpSpreadsheet/pull/2651)
+- Change open mode for output from `wb+` to `wb` [Issue #2372](https://github.com/PHPOffice/PhpSpreadsheet/issues/2372) [PR #2657](https://github.com/PHPOffice/PhpSpreadsheet/pull/2657)
+- Use color palette if supplied [Issue #2499](https://github.com/PHPOffice/PhpSpreadsheet/issues/2499) [PR #2595](https://github.com/PHPOffice/PhpSpreadsheet/pull/2595)
+- Xls reader treat drawing offsets as int rather than float [PR #2648](https://github.com/PHPOffice/PhpSpreadsheet/pull/2648)
+- Handle booleans in conditional styles properly [PR #2654](https://github.com/PHPOffice/PhpSpreadsheet/pull/2654)
+- Fix for reading files in the root directory of a ZipFile, which should not be prefixed by relative paths ("./") as dirname($filename) does by default.
+- Fix invalid style of cells in empty columns with columnDimensions and rows with rowDimensions in added external sheet. [PR #2739](https://github.com/PHPOffice/PhpSpreadsheet/pull/2739)
+- Time Interval Formatting [Issue #2768](https://github.com/PHPOffice/PhpSpreadsheet/issues/2768) [PR #2772](https://github.com/PHPOffice/PhpSpreadsheet/pull/2772)
+
+## 1.22.0 - 2022-02-18
+
+### Added
+
+- Namespacing phase 2 - styles.
+[PR #2471](https://github.com/PHPOffice/PhpSpreadsheet/pull/2471)
+
+- Improved support for passing of array arguments to Excel function implementations to return array results (where appropriate). [Issue #2551](https://github.com/PHPOffice/PhpSpreadsheet/issues/2551)
+
+ This is the first stage in an ongoing process of adding array support to all appropriate function implementations,
+- Support for the Excel365 Math/Trig SEQUENCE() function [PR #2536](https://github.com/PHPOffice/PhpSpreadsheet/pull/2536)
+- Support for the Excel365 Math/Trig RANDARRAY() function [PR #2540](https://github.com/PHPOffice/PhpSpreadsheet/pull/2540)
+
+ Note that the Spill Operator is not yet supported in the Calculation Engine; but this can still be useful for defining array constants.
+- Improved support for Conditional Formatting Rules [PR #2491](https://github.com/PHPOffice/PhpSpreadsheet/pull/2491)
+ - Provide support for a wider range of Conditional Formatting Rules for Xlsx Reader/Writer:
+ - Cells Containing (cellIs)
+ - Specific Text (containing, notContaining, beginsWith, endsWith)
+ - Dates Occurring (all supported timePeriods)
+ - Blanks/NoBlanks
+ - Errors/NoErrors
+ - Duplicates/Unique
+ - Expression
+ - Provision of CF Wizards (for all the above listed rule types) to help create/modify CF Rules without having to manage all the combinations of types/operators, and the complexities of formula expressions, or the text/timePeriod attributes.
+
+ See [documentation](https://phpspreadsheet.readthedocs.io/en/latest/topics/conditional-formatting/) for details
+
+ - Full support of the above CF Rules for the Xlsx Reader and Writer; even when the file being loaded has CF rules listed in the `` element for the worksheet rather than the `` element.
+ - Provision of a CellMatcher to identify if rules are matched for a cell, and which matching style will be applied.
+ - Improved documentation and examples, covering all supported CF rule types.
+ - Add support for one digit decimals (FORMAT_NUMBER_0, FORMAT_PERCENTAGE_0). [PR #2525](https://github.com/PHPOffice/PhpSpreadsheet/pull/2525)
+ - Initial work enabling Excel function implementations for handling arrays as arguments when used in "array formulae" [#2562](https://github.com/PHPOffice/PhpSpreadsheet/issues/2562)
+ - Enable most of the Date/Time functions to accept array arguments [#2573](https://github.com/PHPOffice/PhpSpreadsheet/issues/2573)
+ - Array ready functions - Text, Math/Trig, Statistical, Engineering and Logical [#2580](https://github.com/PHPOffice/PhpSpreadsheet/issues/2580)
+
+### Changed
+
+- Additional Russian translations for Excel Functions (courtesy of aleks-samurai).
+- Improved code coverage for NumberFormat. [PR #2556](https://github.com/PHPOffice/PhpSpreadsheet/pull/2556)
+- Extract some methods from the Calculation Engine into dedicated classes [#2537](https://github.com/PHPOffice/PhpSpreadsheet/issues/2537)
+- Eliminate calls to `flattenSingleValue()` that are no longer required when we're checking for array values as arguments [#2590](https://github.com/PHPOffice/PhpSpreadsheet/issues/2590)
+
+### Deprecated
+
+- Nothing
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Fixed `ReferenceHelper@insertNewBefore` behavior when removing column before last column with null value [PR #2541](https://github.com/PHPOffice/PhpSpreadsheet/pull/2541)
+- Fix bug with `DOLLARDE()` and `DOLLARFR()` functions when the dollar value is negative [Issue #2578](https://github.com/PHPOffice/PhpSpreadsheet/issues/2578) [PR #2579](https://github.com/PHPOffice/PhpSpreadsheet/pull/2579)
+- Fix partial function name matching when translating formulae from Russian to English [Issue #2533](https://github.com/PHPOffice/PhpSpreadsheet/issues/2533) [PR #2534](https://github.com/PHPOffice/PhpSpreadsheet/pull/2534)
+- Various bugs related to Conditional Formatting Rules, and errors in the Xlsx Writer for Conditional Formatting [PR #2491](https://github.com/PHPOffice/PhpSpreadsheet/pull/2491)
+- Xlsx Reader merge range fixes. [Issue #2501](https://github.com/PHPOffice/PhpSpreadsheet/issues/2501) [PR #2504](https://github.com/PHPOffice/PhpSpreadsheet/pull/2504)
+- Handle explicit "date" type for Cell in Xlsx Reader. [Issue #2373](https://github.com/PHPOffice/PhpSpreadsheet/issues/2373) [PR #2485](https://github.com/PHPOffice/PhpSpreadsheet/pull/2485)
+- Recalibrate Row/Column Dimensions after removeRow/Column. [Issue #2442](https://github.com/PHPOffice/PhpSpreadsheet/issues/2442) [PR #2486](https://github.com/PHPOffice/PhpSpreadsheet/pull/2486)
+- Refinement for XIRR. [Issue #2469](https://github.com/PHPOffice/PhpSpreadsheet/issues/2469) [PR #2487](https://github.com/PHPOffice/PhpSpreadsheet/pull/2487)
+- Xlsx Reader handle cell with non-null explicit type but null value. [Issue #2488](https://github.com/PHPOffice/PhpSpreadsheet/issues/2488) [PR #2489](https://github.com/PHPOffice/PhpSpreadsheet/pull/2489)
+- Xlsx Reader fix height and width for oneCellAnchorDrawings. [PR #2492](https://github.com/PHPOffice/PhpSpreadsheet/pull/2492)
+- Fix rounding error in NumberFormat::NUMBER_PERCENTAGE, NumberFormat::NUMBER_PERCENTAGE_00. [PR #2555](https://github.com/PHPOffice/PhpSpreadsheet/pull/2555)
+- Don't treat thumbnail file as xml. [Issue #2516](https://github.com/PHPOffice/PhpSpreadsheet/issues/2516) [PR #2517](https://github.com/PHPOffice/PhpSpreadsheet/pull/2517)
+- Eliminating Xlsx Reader warning when no sz tag for RichText. [Issue #2542](https://github.com/PHPOffice/PhpSpreadsheet/issues/2542) [PR #2550](https://github.com/PHPOffice/PhpSpreadsheet/pull/2550)
+- Fix Xlsx/Xls Writer handling of inline strings. [Issue #353](https://github.com/PHPOffice/PhpSpreadsheet/issues/353) [PR #2569](https://github.com/PHPOffice/PhpSpreadsheet/pull/2569)
+- Richtext colors were not being read correctly after namespace change [#2458](https://github.com/PHPOffice/PhpSpreadsheet/issues/2458)
+- Fix discrepancy between the way markdown tables are rendered in ReadTheDocs and in PHPStorm [#2520](https://github.com/PHPOffice/PhpSpreadsheet/issues/2520)
+- Update Russian Functions Text File [#2557](https://github.com/PHPOffice/PhpSpreadsheet/issues/2557)
+- Fix documentation, instantiation example [#2564](https://github.com/PHPOffice/PhpSpreadsheet/issues/2564)
+
+
+## 1.21.0 - 2022-01-06
+
+### Added
+
+- Ability to add a picture to the background of the comment. Supports four image formats: png, jpeg, gif, bmp. New `Comment::setSizeAsBackgroundImage()` to change the size of a comment to the size of a background image. [Issue #1547](https://github.com/PHPOffice/PhpSpreadsheet/issues/1547) [PR #2422](https://github.com/PHPOffice/PhpSpreadsheet/pull/2422)
+- Ability to set default paper size and orientation [PR #2410](https://github.com/PHPOffice/PhpSpreadsheet/pull/2410)
+- Ability to extend AutoFilter to Maximum Row [PR #2414](https://github.com/PHPOffice/PhpSpreadsheet/pull/2414)
+
+### Changed
+
+- Xlsx Writer will evaluate AutoFilter only if it is as yet unevaluated, or has changed since it was last evaluated [PR #2414](https://github.com/PHPOffice/PhpSpreadsheet/pull/2414)
+
+### Deprecated
+
+- Nothing
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Rounding in `NumberFormatter` [Issue #2385](https://github.com/PHPOffice/PhpSpreadsheet/issues/2385) [PR #2399](https://github.com/PHPOffice/PhpSpreadsheet/pull/2399)
+- Support for themes [Issue #2075](https://github.com/PHPOffice/PhpSpreadsheet/issues/2075) [Issue #2387](https://github.com/PHPOffice/PhpSpreadsheet/issues/2387) [PR #2403](https://github.com/PHPOffice/PhpSpreadsheet/pull/2403)
+- Read spreadsheet with `#` in name [Issue #2405](https://github.com/PHPOffice/PhpSpreadsheet/issues/2405) [PR #2409](https://github.com/PHPOffice/PhpSpreadsheet/pull/2409)
+- Improve PDF support for page size and orientation [Issue #1691](https://github.com/PHPOffice/PhpSpreadsheet/issues/1691) [PR #2410](https://github.com/PHPOffice/PhpSpreadsheet/pull/2410)
+- Wildcard handling issues in text match [Issue #2430](https://github.com/PHPOffice/PhpSpreadsheet/issues/2430) [PR #2431](https://github.com/PHPOffice/PhpSpreadsheet/pull/2431)
+- Respect DataType in `insertNewBefore` [PR #2433](https://github.com/PHPOffice/PhpSpreadsheet/pull/2433)
+- Handle rows explicitly hidden after AutoFilter [Issue #1641](https://github.com/PHPOffice/PhpSpreadsheet/issues/1641) [PR #2414](https://github.com/PHPOffice/PhpSpreadsheet/pull/2414)
+- Special characters in image file name [Issue #1470](https://github.com/PHPOffice/PhpSpreadsheet/issues/1470) [Issue #2415](https://github.com/PHPOffice/PhpSpreadsheet/issues/2415) [PR #2416](https://github.com/PHPOffice/PhpSpreadsheet/pull/2416)
+- Mpdf with very many styles [Issue #2432](https://github.com/PHPOffice/PhpSpreadsheet/issues/2432) [PR #2434](https://github.com/PHPOffice/PhpSpreadsheet/pull/2434)
+- Name clashes between parsed and unparsed drawings [Issue #1767](https://github.com/PHPOffice/PhpSpreadsheet/issues/1767) [Issue #2396](https://github.com/PHPOffice/PhpSpreadsheet/issues/2396) [PR #2423](https://github.com/PHPOffice/PhpSpreadsheet/pull/2423)
+- Fill pattern start and end colors [Issue #2441](https://github.com/PHPOffice/PhpSpreadsheet/issues/2441) [PR #2444](https://github.com/PHPOffice/PhpSpreadsheet/pull/2444)
+- General style specified in wrong case [Issue #2450](https://github.com/PHPOffice/PhpSpreadsheet/issues/2450) [PR #2451](https://github.com/PHPOffice/PhpSpreadsheet/pull/2451)
+- Null passed to `AutoFilter::setRange()` [Issue #2281](https://github.com/PHPOffice/PhpSpreadsheet/issues/2281) [PR #2454](https://github.com/PHPOffice/PhpSpreadsheet/pull/2454)
+- Another undefined index in Xls reader (#2470) [Issue #2463](https://github.com/PHPOffice/PhpSpreadsheet/issues/2463) [PR #2470](https://github.com/PHPOffice/PhpSpreadsheet/pull/2470)
+- Allow single-cell checks on conditional styles, even when the style is configured for a range of cells (#) [PR #2483](https://github.com/PHPOffice/PhpSpreadsheet/pull/2483)
+
+## 1.20.0 - 2021-11-23
+
+### Added
+
+- Xlsx Writer Support for WMF Files [#2339](https://github.com/PHPOffice/PhpSpreadsheet/issues/2339)
+- Use standard temporary file for internal use of HTMLPurifier [#2383](https://github.com/PHPOffice/PhpSpreadsheet/issues/2383)
+
+### Changed
+
+- Drop support for PHP 7.2, according to https://phpspreadsheet.readthedocs.io/en/latest/#php-version-support
+- Use native typing for objects that were already documented as such
+
+### Deprecated
+
+- Nothing
+
+### Removed
+
+- Nothing
+
+### Fixed
+
+- Fixed null conversation for strToUpper [#2292](https://github.com/PHPOffice/PhpSpreadsheet/issues/2292)
+- Fixed Trying to access array offset on value of type null (Xls Reader) [#2315](https://github.com/PHPOffice/PhpSpreadsheet/issues/2315)
+- Don't corrupt XLSX files containing data validation [#2377](https://github.com/PHPOffice/PhpSpreadsheet/issues/2377)
+- Non-fixed cells were not updated if shared formula has a fixed cell [#2354](https://github.com/PHPOffice/PhpSpreadsheet/issues/2354)
+- Declare key of generic ArrayObject
+- CSV reader better support for boolean values [#2374](https://github.com/PHPOffice/PhpSpreadsheet/pull/2374)
+- Some ZIP file could not be read [#2376](https://github.com/PHPOffice/PhpSpreadsheet/pull/2376)
+- Fix regression were hyperlinks could not be read [#2391](https://github.com/PHPOffice/PhpSpreadsheet/pull/2391)
+- AutoFilter Improvements [#2393](https://github.com/PHPOffice/PhpSpreadsheet/pull/2393)
+- Don't corrupt file when using chart with fill color [#589](https://github.com/PHPOffice/PhpSpreadsheet/pull/589)
+- Restore imperfect array formula values in xlsx writer [#2343](https://github.com/PHPOffice/PhpSpreadsheet/pull/2343)
+- Restore explicit list of changes to PHPExcel migration document [#1546](https://github.com/PHPOffice/PhpSpreadsheet/issues/1546)
+
+## 1.19.0 - 2021-10-31
+
+### Added
+
+- Ability to set style on named range, and validate input to setSelectedCells [Issue #2279](https://github.com/PHPOffice/PhpSpreadsheet/issues/2279) [PR #2280](https://github.com/PHPOffice/PhpSpreadsheet/pull/2280)
+- Process comments in Sylk file [Issue #2276](https://github.com/PHPOffice/PhpSpreadsheet/issues/2276) [PR #2277](https://github.com/PHPOffice/PhpSpreadsheet/pull/2277)
+- Addition of Custom Properties to Ods Writer, and 32-bit-safe timestamps for Document Properties [PR #2113](https://github.com/PHPOffice/PhpSpreadsheet/pull/2113)
+- Added callback to CSV reader to set user-specified defaults for various properties (especially for escape which has a poor PHP-inherited default of backslash which does not correspond with Excel) [PR #2103](https://github.com/PHPOffice/PhpSpreadsheet/pull/2103)
+- Phase 1 of better namespace handling for Xlsx, resolving many open issues [PR #2173](https://github.com/PHPOffice/PhpSpreadsheet/pull/2173) [PR #2204](https://github.com/PHPOffice/PhpSpreadsheet/pull/2204) [PR #2303](https://github.com/PHPOffice/PhpSpreadsheet/pull/2303)
+- Add ability to extract images if source is a URL [Issue #1997](https://github.com/PHPOffice/PhpSpreadsheet/issues/1997) [PR #2072](https://github.com/PHPOffice/PhpSpreadsheet/pull/2072)
+- Support for passing flags in the Reader `load()` and Writer `save()`methods, and through the IOFactory, to set behaviours [PR #2136](https://github.com/PHPOffice/PhpSpreadsheet/pull/2136)
+ - See [documentation](https://phpspreadsheet.readthedocs.io/en/latest/topics/reading-and-writing-to-file/#readerwriter-flags) for details
+- More flexibility in the StringValueBinder to determine what datatypes should be treated as strings [PR #2138](https://github.com/PHPOffice/PhpSpreadsheet/pull/2138)
+- Helper class for conversion between css size Units of measure (`px`, `pt`, `pc`, `in`, `cm`, `mm`) [PR #2152](https://github.com/PHPOffice/PhpSpreadsheet/issues/2145)
+- Allow Row height and Column Width to be set using different units of measure (`px`, `pt`, `pc`, `in`, `cm`, `mm`), rather than only in points or MS Excel column width units [PR #2152](https://github.com/PHPOffice/PhpSpreadsheet/issues/2145)
+- Ability to stream to an Amazon S3 bucket [Issue #2249](https://github.com/PHPOffice/PhpSpreadsheet/issues/2249)
+- Provided a Size Helper class to validate size values (pt, px, em) [PR #1694](https://github.com/PHPOffice/PhpSpreadsheet/pull/1694)
+
+### Changed
+
+- Nothing.
+
+### Deprecated
+
+- PHP 8.1 will deprecate auto_detect_line_endings. As a result of this change, Csv Reader using some release after PHP8.1 will no longer be able to handle a Csv with Mac line endings.
+
+### Removed
+
+- Nothing.
+
+### Fixed
+
+- Unexpected format in Xlsx Timestamp [Issue #2331](https://github.com/PHPOffice/PhpSpreadsheet/issues/2331) [PR #2332](https://github.com/PHPOffice/PhpSpreadsheet/pull/2332)
+- Corrections for HLOOKUP [Issue #2123](https://github.com/PHPOffice/PhpSpreadsheet/issues/2123) [PR #2330](https://github.com/PHPOffice/PhpSpreadsheet/pull/2330)
+- Corrections for Xlsx Read Comments [Issue #2316](https://github.com/PHPOffice/PhpSpreadsheet/issues/2316) [PR #2329](https://github.com/PHPOffice/PhpSpreadsheet/pull/2329)
+- Lowercase Calibri font names [Issue #2273](https://github.com/PHPOffice/PhpSpreadsheet/issues/2273) [PR #2325](https://github.com/PHPOffice/PhpSpreadsheet/pull/2325)
+- isFormula Referencing Sheet with Space in Title [Issue #2304](https://github.com/PHPOffice/PhpSpreadsheet/issues/2304) [PR #2306](https://github.com/PHPOffice/PhpSpreadsheet/pull/2306)
+- Xls Reader Fatal Error due to Undefined Offset [Issue #1114](https://github.com/PHPOffice/PhpSpreadsheet/issues/1114) [PR #2308](https://github.com/PHPOffice/PhpSpreadsheet/pull/2308)
+- Permit Csv Reader delimiter to be set to null [Issue #2287](https://github.com/PHPOffice/PhpSpreadsheet/issues/2287) [PR #2288](https://github.com/PHPOffice/PhpSpreadsheet/pull/2288)
+- Csv Reader did not handle booleans correctly [PR #2232](https://github.com/PHPOffice/PhpSpreadsheet/pull/2232)
+- Problems when deleting sheet with local defined name [Issue #2266](https://github.com/PHPOffice/PhpSpreadsheet/issues/2266) [PR #2284](https://github.com/PHPOffice/PhpSpreadsheet/pull/2284)
+- Worksheet passwords were not always handled correctly [Issue #1897](https://github.com/PHPOffice/PhpSpreadsheet/issues/1897) [PR #2197](https://github.com/PHPOffice/PhpSpreadsheet/pull/2197)
+- Gnumeric Reader will now distinguish between Created and Modified timestamp [PR #2133](https://github.com/PHPOffice/PhpSpreadsheet/pull/2133)
+- Xls Reader will now handle MACCENTRALEUROPE with or without hyphen [Issue #549](https://github.com/PHPOffice/PhpSpreadsheet/issues/549) [PR #2213](https://github.com/PHPOffice/PhpSpreadsheet/pull/2213)
+- Tweaks to input file validation [Issue #1718](https://github.com/PHPOffice/PhpSpreadsheet/issues/1718) [PR #2217](https://github.com/PHPOffice/PhpSpreadsheet/pull/2217)
+- Html Reader did not handle comments correctly [Issue #2234](https://github.com/PHPOffice/PhpSpreadsheet/issues/2234) [PR #2235](https://github.com/PHPOffice/PhpSpreadsheet/pull/2235)
+- Apache OpenOffice Uses Unexpected Case for General format [Issue #2239](https://github.com/PHPOffice/PhpSpreadsheet/issues/2239) [PR #2242](https://github.com/PHPOffice/PhpSpreadsheet/pull/2242)
+- Problems with fraction formatting [Issue #2253](https://github.com/PHPOffice/PhpSpreadsheet/issues/2253) [PR #2254](https://github.com/PHPOffice/PhpSpreadsheet/pull/2254)
+- Xlsx Reader had problems reading file with no styles.xml or empty styles.xml [Issue #2246](https://github.com/PHPOffice/PhpSpreadsheet/issues/2246) [PR #2247](https://github.com/PHPOffice/PhpSpreadsheet/pull/2247)
+- Xlsx Reader did not read Data Validation flags correctly [Issue #2224](https://github.com/PHPOffice/PhpSpreadsheet/issues/2224) [PR #2225](https://github.com/PHPOffice/PhpSpreadsheet/pull/2225)
+- Better handling of empty arguments in Calculation engine [PR #2143](https://github.com/PHPOffice/PhpSpreadsheet/pull/2143)
+- Many fixes for Autofilter [Issue #2216](https://github.com/PHPOffice/PhpSpreadsheet/issues/2216) [PR #2141](https://github.com/PHPOffice/PhpSpreadsheet/pull/2141) [PR #2162](https://github.com/PHPOffice/PhpSpreadsheet/pull/2162) [PR #2218](https://github.com/PHPOffice/PhpSpreadsheet/pull/2218)
+- Locale generator will now use Unix line endings even on Windows [Issue #2172](https://github.com/PHPOffice/PhpSpreadsheet/issues/2172) [PR #2174](https://github.com/PHPOffice/PhpSpreadsheet/pull/2174)
+- Support differences in implementation of Text functions between Excel/Ods/Gnumeric [PR #2151](https://github.com/PHPOffice/PhpSpreadsheet/pull/2151)
+- Fixes to places where PHP8.1 enforces new or previously unenforced restrictions [PR #2137](https://github.com/PHPOffice/PhpSpreadsheet/pull/2137) [PR #2191](https://github.com/PHPOffice/PhpSpreadsheet/pull/2191) [PR #2231](https://github.com/PHPOffice/PhpSpreadsheet/pull/2231)
+- Clone for HashTable was incorrect [PR #2130](https://github.com/PHPOffice/PhpSpreadsheet/pull/2130)
+- Xlsx Reader was not evaluating Document Security Lock correctly [PR #2128](https://github.com/PHPOffice/PhpSpreadsheet/pull/2128)
+- Error in COUPNCD handling end of month [Issue #2116](https://github.com/PHPOffice/PhpSpreadsheet/issues/2116) [PR #2119](https://github.com/PHPOffice/PhpSpreadsheet/pull/2119)
+- Xls Writer Parser did not handle concatenation operator correctly [PR #2080](https://github.com/PHPOffice/PhpSpreadsheet/pull/2080)
+- Xlsx Writer did not handle boolean false correctly [Issue #2082](https://github.com/PHPOffice/PhpSpreadsheet/issues/2082) [PR #2087](https://github.com/PHPOffice/PhpSpreadsheet/pull/2087)
+- SUM needs to treat invalid strings differently depending on whether they come from a cell or are used as literals [Issue #2042](https://github.com/PHPOffice/PhpSpreadsheet/issues/2042) [PR #2045](https://github.com/PHPOffice/PhpSpreadsheet/pull/2045)
+- Html reader could have set illegal coordinates when dealing with embedded tables [Issue #2029](https://github.com/PHPOffice/PhpSpreadsheet/issues/2029) [PR #2032](https://github.com/PHPOffice/PhpSpreadsheet/pull/2032)
+- Documentation for printing gridlines was wrong [PR #2188](https://github.com/PHPOffice/PhpSpreadsheet/pull/2188)
+- Return Value Error - DatabaseAbstruct::buildQuery() return null but must be string [Issue #2158](https://github.com/PHPOffice/PhpSpreadsheet/issues/2158) [PR #2160](https://github.com/PHPOffice/PhpSpreadsheet/pull/2160)
+- Xlsx reader not recognize data validations that references another sheet [Issue #1432](https://github.com/PHPOffice/PhpSpreadsheet/issues/1432) [Issue #2149](https://github.com/PHPOffice/PhpSpreadsheet/issues/2149) [PR #2150](https://github.com/PHPOffice/PhpSpreadsheet/pull/2150) [PR #2265](https://github.com/PHPOffice/PhpSpreadsheet/pull/2265)
+- Don't calculate cell width for autosize columns if a cell contains a null or empty string value [Issue #2165](https://github.com/PHPOffice/PhpSpreadsheet/issues/2165) [PR #2167](https://github.com/PHPOffice/PhpSpreadsheet/pull/2167)
+- Allow negative interest rate values in a number of the Financial functions (`PPMT()`, `PMT()`, `FV()`, `PV()`, `NPER()`, etc) [Issue #2163](https://github.com/PHPOffice/PhpSpreadsheet/issues/2163) [PR #2164](https://github.com/PHPOffice/PhpSpreadsheet/pull/2164)
+- Xls Reader changing grey background to black in Excel template [Issue #2147](https://github.com/PHPOffice/PhpSpreadsheet/issues/2147) [PR #2156](https://github.com/PHPOffice/PhpSpreadsheet/pull/2156)
+- Column width and Row height styles in the Html Reader when the value includes a unit of measure [Issue #2145](https://github.com/PHPOffice/PhpSpreadsheet/issues/2145).
+- Data Validation flags not set correctly when reading XLSX files [Issue #2224](https://github.com/PHPOffice/PhpSpreadsheet/issues/2224) [PR #2225](https://github.com/PHPOffice/PhpSpreadsheet/pull/2225)
+- Reading XLSX files without styles.xml throws an exception [Issue #2246](https://github.com/PHPOffice/PhpSpreadsheet/issues/2246)
+- Improved performance of `Style::applyFromArray()` when applied to several cells [PR #1785](https://github.com/PHPOffice/PhpSpreadsheet/issues/1785).
+- Improve XLSX parsing speed if no readFilter is applied (again) - [#772](https://github.com/PHPOffice/PhpSpreadsheet/issues/772)
+
+## 1.18.0 - 2021-05-31
+
+### Added
+
+- Enhancements to CSV Reader, allowing options to be set when using `IOFactory::load()` with a callback to set delimiter, enclosure, charset etc [PR #2103](https://github.com/PHPOffice/PhpSpreadsheet/pull/2103) - See [documentation](https://github.com/PHPOffice/PhpSpreadsheet/blob/master/docs/topics/reading-and-writing-to-file.md#csv-comma-separated-values) for details.
+- Implemented basic AutoFiltering for Ods Reader and Writer [PR #2053](https://github.com/PHPOffice/PhpSpreadsheet/pull/2053)
+- Implemented basic AutoFiltering for Gnumeric Reader [PR #2055](https://github.com/PHPOffice/PhpSpreadsheet/pull/2055)
+- Improved support for Row and Column ranges in formulae [Issue #1755](https://github.com/PHPOffice/PhpSpreadsheet/issues/1755) [PR #2028](https://github.com/PHPOffice/PhpSpreadsheet/pull/2028)
+- Implemented URLENCODE() Web Function
+- Implemented the CHITEST(), CHISQ.DIST() and CHISQ.INV() and equivalent Statistical functions, for both left- and right-tailed distributions.
+- Support for ActiveSheet and SelectedCells in the ODS Reader and Writer [PR #1908](https://github.com/PHPOffice/PhpSpreadsheet/pull/1908)
+- Support for notContainsText Conditional Style in xlsx [Issue #984](https://github.com/PHPOffice/PhpSpreadsheet/issues/984)
+
+### Changed
+
+- Use of `nb` rather than `no` as the locale code for Norsk Bokmål.
+
+### Deprecated
+
+- All Excel Function implementations in `Calculation\Database`, `Calculation\DateTime`, `Calculation\Engineering`, `Calculation\Financial`, `Calculation\Logical`, `Calculation\LookupRef`, `Calculation\MathTrig`, `Calculation\Statistical`, `Calculation\TextData` and `Calculation\Web` have been moved to dedicated classes for individual functions or groups of related functions. See the docblocks against all the deprecated methods for details of the new methods to call instead. At some point, these old classes will be deleted.
+
+### Removed
+
+- Use of `nb` rather than `no` as the locale language code for Norsk Bokmål.
+
+### Fixed
+
+- Fixed error in COUPNCD() calculation for end of month [Issue #2116](https://github.com/PHPOffice/PhpSpreadsheet/issues/2116) - [PR #2119](https://github.com/PHPOffice/PhpSpreadsheet/pull/2119)
+- Resolve default values when a null argument is passed for HLOOKUP(), VLOOKUP() and ADDRESS() functions [Issue #2120](https://github.com/PHPOffice/PhpSpreadsheet/issues/2120) - [PR #2121](https://github.com/PHPOffice/PhpSpreadsheet/pull/2121)
+- Fixed incorrect R1C1 to A1 subtraction formula conversion (`R[-2]C-R[2]C`) [Issue #2076](https://github.com/PHPOffice/PhpSpreadsheet/pull/2076) [PR #2086](https://github.com/PHPOffice/PhpSpreadsheet/pull/2086)
+- Correctly handle absolute A1 references when converting to R1C1 format [PR #2060](https://github.com/PHPOffice/PhpSpreadsheet/pull/2060)
+- Correct default fill style for conditional without a pattern defined [Issue #2035](https://github.com/PHPOffice/PhpSpreadsheet/issues/2035) [PR #2050](https://github.com/PHPOffice/PhpSpreadsheet/pull/2050)
+- Fixed issue where array key check for existince before accessing arrays in Xlsx.php [PR #1970](https://github.com/PHPOffice/PhpSpreadsheet/pull/1970)
+- Fixed issue with quoted strings in number format mask rendered with toFormattedString() [Issue 1972#](https://github.com/PHPOffice/PhpSpreadsheet/issues/1972) [PR #1978](https://github.com/PHPOffice/PhpSpreadsheet/pull/1978)
+- Fixed issue with percentage formats in number format mask rendered with toFormattedString() [Issue 1929#](https://github.com/PHPOffice/PhpSpreadsheet/issues/1929) [PR #1928](https://github.com/PHPOffice/PhpSpreadsheet/pull/1928)
+- Fixed issue with _ spacing character in number format mask corrupting output from toFormattedString() [Issue 1924#](https://github.com/PHPOffice/PhpSpreadsheet/issues/1924) [PR #1927](https://github.com/PHPOffice/PhpSpreadsheet/pull/1927)
+- Fix for [Issue #1887](https://github.com/PHPOffice/PhpSpreadsheet/issues/1887) - Lose Track of Selected Cells After Save
+- Fixed issue with Xlsx@listWorksheetInfo not returning any data
+- Fixed invalid arguments triggering mb_substr() error in LEFT(), MID() and RIGHT() text functions [Issue #640](https://github.com/PHPOffice/PhpSpreadsheet/issues/640)
+- Fix for [Issue #1916](https://github.com/PHPOffice/PhpSpreadsheet/issues/1916) - Invalid signature check for XML files
+- Fix change in `Font::setSize()` behavior for PHP8 [PR #2100](https://github.com/PHPOffice/PhpSpreadsheet/pull/2100)
+
+## 1.17.1 - 2021-03-01
+
+### Added
+
+- Implementation of the Excel `AVERAGEIFS()` functions as part of a restructuring of Database functions and Conditional Statistical functions.
+- Support for date values and percentages in query parameters for Database functions, and the IF expressions in functions like COUNTIF() and AVERAGEIF(). [#1875](https://github.com/PHPOffice/PhpSpreadsheet/pull/1875)
+- Support for booleans, and for wildcard text search in query parameters for Database functions, and the IF expressions in functions like COUNTIF() and AVERAGEIF(). [#1876](https://github.com/PHPOffice/PhpSpreadsheet/pull/1876)
+- Implemented DataBar for conditional formatting in Xlsx, providing read/write and creation of (type, value, direction, fills, border, axis position, color settings) as DataBar options in Excel. [#1754](https://github.com/PHPOffice/PhpSpreadsheet/pull/1754)
+- Alignment for ODS Writer [#1796](https://github.com/PHPOffice/PhpSpreadsheet/issues/1796)
+- Basic implementation of the PERMUTATIONA() Statistical Function
+
+### Changed
+
+- Formula functions that previously called PHP functions directly are now processed through the Excel Functions classes; resolving issues with PHP8 stricter typing. [#1789](https://github.com/PHPOffice/PhpSpreadsheet/issues/1789)
+
+ The following MathTrig functions are affected:
+ `ABS()`, `ACOS()`, `ACOSH()`, `ASIN()`, `ASINH()`, `ATAN()`, `ATANH()`,
+ `COS()`, `COSH()`, `DEGREES()` (rad2deg), `EXP()`, `LN()` (log), `LOG10()`,
+ `RADIANS()` (deg2rad), `SIN()`, `SINH()`, `SQRT()`, `TAN()`, `TANH()`.
+
+ One TextData function is also affected: `REPT()` (str_repeat).
+- `formatAsDate` correctly matches language metadata, reverting c55272e
+- Formulae that previously crashed on sub function call returning excel error value now return said value.
+ The following functions are affected `CUMPRINC()`, `CUMIPMT()`, `AMORLINC()`,
+ `AMORDEGRC()`.
+- Adapt some function error return value to match excel's error.
+ The following functions are affected `PPMT()`, `IPMT()`.
+
+### Deprecated
+
+- Calling many of the Excel formula functions directly rather than through the Calculation Engine.
+
+ The logic for these Functions is now being moved out of the categorised `Database`, `DateTime`, `Engineering`, `Financial`, `Logical`, `LookupRef`, `MathTrig`, `Statistical`, `TextData` and `Web` classes into small, dedicated classes for individual functions or related groups of functions.
+
+ This makes the logic in these classes easier to maintain; and will reduce the memory footprint required to execute formulae when calling these functions.
+
+### Removed
+
+- Nothing.
+
+### Fixed
+
+- Avoid Duplicate Titles When Reading Multiple HTML Files.[Issue #1823](https://github.com/PHPOffice/PhpSpreadsheet/issues/1823) [PR #1829](https://github.com/PHPOffice/PhpSpreadsheet/pull/1829)
+- Fixed issue with Worksheet's `getCell()` method when trying to get a cell by defined name. [#1858](https://github.com/PHPOffice/PhpSpreadsheet/issues/1858)
+- Fix possible endless loop in NumberFormat Masks [#1792](https://github.com/PHPOffice/PhpSpreadsheet/issues/1792)
+- Fix problem resulting from literal dot inside quotes in number format masks [PR #1830](https://github.com/PHPOffice/PhpSpreadsheet/pull/1830)
+- Resolve Google Sheets Xlsx charts issue. Google Sheets uses oneCellAnchor positioning and does not include *Cache values in the exported Xlsx [PR #1761](https://github.com/PHPOffice/PhpSpreadsheet/pull/1761)
+- Fix for Xlsx Chart axis titles mapping to correct X or Y axis label when only one is present [PR #1760](https://github.com/PHPOffice/PhpSpreadsheet/pull/1760)
+- Fix For Null Exception on ODS Read of Page Settings. [#1772](https://github.com/PHPOffice/PhpSpreadsheet/issues/1772)
+- Fix Xlsx reader overriding manually set number format with builtin number format [PR #1805](https://github.com/PHPOffice/PhpSpreadsheet/pull/1805)
+- Fix Xlsx reader cell alignment [PR #1710](https://github.com/PHPOffice/PhpSpreadsheet/pull/1710)
+- Fix for not yet implemented data-types in Open Document writer [Issue #1674](https://github.com/PHPOffice/PhpSpreadsheet/issues/1674)
+- Fix XLSX reader when having a corrupt numeric cell data type [PR #1664](https://github.com/phpoffice/phpspreadsheet/pull/1664)
+- Fix on `CUMPRINC()`, `CUMIPMT()`, `AMORLINC()`, `AMORDEGRC()` usage. When those functions called one of `YEARFRAC()`, `PPMT()`, `IPMT()` and they would get back an error value (represented as a string), trying to use numeral operands (`+`, `/`, `-`, `*`) on said return value and a number (`float or `int`) would fail.
+
+## 1.16.0 - 2020-12-31
+
+### Added
+
+- CSV Reader - Best Guess for Encoding, and Handle Null-string Escape [#1647](https://github.com/PHPOffice/PhpSpreadsheet/issues/1647)
+
+### Changed
+
+- Updated the CONVERT() function to support all current MS Excel categories and Units of Measure.
+
+### Deprecated
+
+- All Excel Function implementations in `Calculation\Database`, `Calculation\DateTime`, `Calculation\Engineering`, `Calculation\Financial`, `Calculation\Logical`, `Calculation\LookupRef`, `Calculation\MathTrig`, `Calculation\Statistical`, `Calculation\TextData` and `Calculation\Web` have been moved to dedicated classes for individual functions or groups of related functions. See the docblocks against all the deprecated methods for details of the new methods to call instead. At some point, these old classes will be deleted.
+
+### Removed
+
+- Nothing.
+
+### Fixed
+
+- Fixed issue with absolute path in worksheets' Target [PR #1769](https://github.com/PHPOffice/PhpSpreadsheet/pull/1769)
+- Fix for Xls Reader when SST has a bad length [#1592](https://github.com/PHPOffice/PhpSpreadsheet/issues/1592)
+- Resolve Xlsx loader issue whe hyperlinks don't have a destination
+- Resolve issues when printer settings resources IDs clash with drawing IDs
+- Resolve issue with SLK long filenames [#1612](https://github.com/PHPOffice/PhpSpreadsheet/issues/1612)
+- ROUNDUP and ROUNDDOWN return incorrect results for values of 0 [#1627](https://github.com/phpoffice/phpspreadsheet/pull/1627)
+- Apply Column and Row Styles to Existing Cells [#1712](https://github.com/PHPOffice/PhpSpreadsheet/issues/1712) [PR #1721](https://github.com/PHPOffice/PhpSpreadsheet/pull/1721)
+- Resolve issues with defined names where worksheet doesn't exist (#1686)[https://github.com/PHPOffice/PhpSpreadsheet/issues/1686] and [#1723](https://github.com/PHPOffice/PhpSpreadsheet/issues/1723) - [PR #1742](https://github.com/PHPOffice/PhpSpreadsheet/pull/1742)
+- Fix for issue [#1735](https://github.com/PHPOffice/PhpSpreadsheet/issues/1735) Incorrect activeSheetIndex after RemoveSheetByIndex - [PR #1743](https://github.com/PHPOffice/PhpSpreadsheet/pull/1743)
+- Ensure that the list of shared formulae is maintained when an xlsx file is chunked with readFilter[Issue #169](https://github.com/PHPOffice/PhpSpreadsheet/issues/1669).
+- Fix for notice during accessing "cached magnification factor" offset [#1354](https://github.com/PHPOffice/PhpSpreadsheet/pull/1354)
+- Fix compatibility with ext-gd on php 8
+
+### Security Fix (CVE-2020-7776)
+
+- Prevent XSS through cell comments in the HTML Writer.
+
+## 1.15.0 - 2020-10-11
+
+### Added
+
+- Implemented Page Order for Xlsx and Xls Readers, and provided Page Settings (Orientation, Scale, Horizontal/Vertical Centering, Page Order, Margins) support for Ods, Gnumeric and Xls Readers [#1559](https://github.com/PHPOffice/PhpSpreadsheet/pull/1559)
+- Implementation of the Excel `LOGNORM.DIST()`, `NORM.S.DIST()`, `GAMMA()` and `GAUSS()` functions. [#1588](https://github.com/PHPOffice/PhpSpreadsheet/pull/1588)
+- Named formula implementation, and improved handling of Defined Names generally [#1535](https://github.com/PHPOffice/PhpSpreadsheet/pull/1535)
+ - Defined Names are now case-insensitive
+ - Distinction between named ranges and named formulae
+ - Correct handling of union and intersection operators in named ranges
+ - Correct evaluation of named range operators in calculations
+ - fix resolution of relative named range values in the calculation engine; previously all named range values had been treated as absolute.
+ - Calculation support for named formulae
+ - Support for nested ranges and formulae (named ranges and formulae that reference other named ranges/formulae) in calculations
+ - Introduction of a helper to convert address formats between R1C1 and A1 (and the reverse)
+ - Proper support for both named ranges and named formulae in all appropriate Readers
+ - **Xlsx** (Previously only simple named ranges were supported)
+ - **Xls** (Previously only simple named ranges were supported)
+ - **Gnumeric** (Previously neither named ranges nor formulae were supported)
+ - **Ods** (Previously neither named ranges nor formulae were supported)
+ - **Xml** (Previously neither named ranges nor formulae were supported)
+ - Proper support for named ranges and named formulae in all appropriate Writers
+ - **Xlsx** (Previously only simple named ranges were supported)
+ - **Xls** (Previously neither named ranges nor formulae were supported) - Still not supported, but some parser issues resolved that previously failed to differentiate between a defined name and a function name
+ - **Ods** (Previously neither named ranges nor formulae were supported)
+- Support for PHP 8.0
+
+### Changed
+
+- Improve Coverage for ODS Reader [#1545](https://github.com/phpoffice/phpspreadsheet/pull/1545)
+- Named formula implementation, and improved handling of Defined Names generally [#1535](https://github.com/PHPOffice/PhpSpreadsheet/pull/1535)
+- fix resolution of relative named range values in the calculation engine; previously all named range values had been treated as absolute.
+- Drop $this->spreadSheet null check from Xlsx Writer [#1646](https://github.com/phpoffice/phpspreadsheet/pull/1646)
+- Improving Coverage for Excel2003 XML Reader [#1557](https://github.com/phpoffice/phpspreadsheet/pull/1557)
+
+### Deprecated
+
+- **IMPORTANT NOTE:** This Introduces a **BC break** in the handling of named ranges. Previously, a named range cell reference of `B2` would be treated identically to a named range cell reference of `$B2` or `B$2` or `$B$2` because the calculation engine treated then all as absolute references. These changes "fix" that, so the calculation engine now handles relative references in named ranges correctly.
+ This change that resolves previously incorrect behaviour in the calculation may affect users who have dynamically defined named ranges using relative references when they should have used absolute references.
+
+### Removed
+
+- Nothing.
+
+### Fixed
+
+- PrintArea causes exception [#1544](https://github.com/phpoffice/phpspreadsheet/pull/1544)
+- Calculation/DateTime Failure With PHP8 [#1661](https://github.com/phpoffice/phpspreadsheet/pull/1661)
+- Reader/Gnumeric Failure with PHP8 [#1662](https://github.com/phpoffice/phpspreadsheet/pull/1662)
+- ReverseSort bug, exposed but not caused by PHP8 [#1660](https://github.com/phpoffice/phpspreadsheet/pull/1660)
+- Bug setting Superscript/Subscript to false [#1567](https://github.com/phpoffice/phpspreadsheet/pull/1567)
+
+## 1.14.1 - 2020-07-19
+
+### Added
+
+- nothing
+
+### Fixed
+
+- WEBSERVICE is HTTP client agnostic and must be configured via `Settings::setHttpClient()` [#1562](https://github.com/PHPOffice/PhpSpreadsheet/issues/1562)
+- Borders were not complete on rowspanned columns using HTML reader [#1473](https://github.com/PHPOffice/PhpSpreadsheet/pull/1473)
+
+### Changed
+
+## 1.14.0 - 2020-06-29
+
+### Added
+
+- Add support for IFS() logical function [#1442](https://github.com/PHPOffice/PhpSpreadsheet/pull/1442)
+- Add Cell Address Helper to provide conversions between the R1C1 and A1 address formats [#1558](https://github.com/PHPOffice/PhpSpreadsheet/pull/1558)
+- Add ability to edit Html/Pdf before saving [#1499](https://github.com/PHPOffice/PhpSpreadsheet/pull/1499)
+- Add ability to set codepage explicitly for BIFF5 [#1018](https://github.com/PHPOffice/PhpSpreadsheet/issues/1018)
+- Added support for the WEBSERVICE function [#1409](https://github.com/PHPOffice/PhpSpreadsheet/pull/1409)
+
+### Fixed
+
+- Resolve evaluation of utf-8 named ranges in calculation engine [#1522](https://github.com/PHPOffice/PhpSpreadsheet/pull/1522)
+- Fix HLOOKUP on single row [#1512](https://github.com/PHPOffice/PhpSpreadsheet/pull/1512)
+- Fix MATCH when comparing different numeric types [#1521](https://github.com/PHPOffice/PhpSpreadsheet/pull/1521)
+- Fix exact MATCH on ranges with empty cells [#1520](https://github.com/PHPOffice/PhpSpreadsheet/pull/1520)
+- Fix for Issue [#1516](https://github.com/PHPOffice/PhpSpreadsheet/issues/1516) (Cloning worksheet makes corrupted Xlsx) [#1530](https://github.com/PHPOffice/PhpSpreadsheet/pull/1530)
+- Fix For Issue [#1509](https://github.com/PHPOffice/PhpSpreadsheet/issues/1509) (Can not set empty enclosure for CSV) [#1518](https://github.com/PHPOffice/PhpSpreadsheet/pull/1518)
+- Fix for Issue [#1505](https://github.com/PHPOffice/PhpSpreadsheet/issues/1505) (TypeError : Argument 4 passed to PhpOffice\PhpSpreadsheet\Writer\Xlsx\Worksheet::writeAttributeIf() must be of the type string) [#1525](https://github.com/PHPOffice/PhpSpreadsheet/pull/1525)
+- Fix for Issue [#1495](https://github.com/PHPOffice/PhpSpreadsheet/issues/1495) (Sheet index being changed when multiple sheets are used in formula) [#1500]((https://github.com/PHPOffice/PhpSpreadsheet/pull/1500))
+- Fix for Issue [#1533](https://github.com/PHPOffice/PhpSpreadsheet/issues/1533) (A reference to a cell containing a string starting with "#" leads to errors in the generated xlsx.) [#1534](https://github.com/PHPOffice/PhpSpreadsheet/pull/1534)
+- Xls Writer - Correct Timestamp Bug [#1493](https://github.com/PHPOffice/PhpSpreadsheet/pull/1493)
+- Don't ouput row and columns without any cells in HTML writer [#1235](https://github.com/PHPOffice/PhpSpreadsheet/issues/1235)
+
+## 1.13.0 - 2020-05-31
+
+### Added
+
+- Support writing to streams in all writers [#1292](https://github.com/PHPOffice/PhpSpreadsheet/issues/1292)
+- Support CSV files with data wrapping a lot of lines [#1468](https://github.com/PHPOffice/PhpSpreadsheet/pull/1468)
+- Support protection of worksheet by a specific hash algorithm [#1485](https://github.com/PHPOffice/PhpSpreadsheet/pull/1485)
+
+### Fixed
+
+- Fix Chart samples by updating chart parameter from 0 to DataSeries::EMPTY_AS_GAP [#1448](https://github.com/PHPOffice/PhpSpreadsheet/pull/1448)
+- Fix return type in docblock for the Cells::get() [#1398](https://github.com/PHPOffice/PhpSpreadsheet/pull/1398)
+- Fix RATE, PRICE, XIRR, and XNPV Functions [#1456](https://github.com/PHPOffice/PhpSpreadsheet/pull/1456)
+- Save Excel 2010+ functions properly in XLSX [#1461](https://github.com/PHPOffice/PhpSpreadsheet/pull/1461)
+- Several improvements in HTML writer [#1464](https://github.com/PHPOffice/PhpSpreadsheet/pull/1464)
+- Fix incorrect behaviour when saving XLSX file with drawings [#1462](https://github.com/PHPOffice/PhpSpreadsheet/pull/1462),
+- Fix Crash while trying setting a cell the value "123456\n" [#1476](https://github.com/PHPOffice/PhpSpreadsheet/pull/1481)
+- Improved DATEDIF() function and reduced errors for Y and YM units [#1466](https://github.com/PHPOffice/PhpSpreadsheet/pull/1466)
+- Stricter typing for mergeCells [#1494](https://github.com/PHPOffice/PhpSpreadsheet/pull/1494)
+
+### Changed
+
+- Drop support for PHP 7.1, according to https://phpspreadsheet.readthedocs.io/en/latest/#php-version-support
+- Drop partial migration tool in favor of complete migration via RectorPHP [#1445](https://github.com/PHPOffice/PhpSpreadsheet/issues/1445)
+- Limit composer package to `src/` [#1424](https://github.com/PHPOffice/PhpSpreadsheet/pull/1424)
+
+## 1.12.0 - 2020-04-27
+
+### Added
+
+- Improved the ARABIC function to also handle short-hand roman numerals
+- Added support for the FLOOR.MATH and FLOOR.PRECISE functions [#1351](https://github.com/PHPOffice/PhpSpreadsheet/pull/1351)
+
+### Fixed
+
+- Fix ROUNDUP and ROUNDDOWN for floating-point rounding error [#1404](https://github.com/PHPOffice/PhpSpreadsheet/pull/1404)
+- Fix ROUNDUP and ROUNDDOWN for negative number [#1417](https://github.com/PHPOffice/PhpSpreadsheet/pull/1417)
+- Fix loading styles from vmlDrawings when containing whitespace [#1347](https://github.com/PHPOffice/PhpSpreadsheet/issues/1347)
+- Fix incorrect behavior when removing last row [#1365](https://github.com/PHPOffice/PhpSpreadsheet/pull/1365)
+- MATCH with a static array should return the position of the found value based on the values submitted [#1332](https://github.com/PHPOffice/PhpSpreadsheet/pull/1332)
+- Fix Xlsx Reader's handling of undefined fill color [#1353](https://github.com/PHPOffice/PhpSpreadsheet/pull/1353)
+
+## 1.11.0 - 2020-03-02
+
+### Added
+
+- Added support for the BASE function
+- Added support for the ARABIC function
+- Conditionals - Extend Support for (NOT)CONTAINSBLANKS [#1278](https://github.com/PHPOffice/PhpSpreadsheet/pull/1278)
+
+### Fixed
+
+- Handle Error in Formula Processing Better for Xls [#1267](https://github.com/PHPOffice/PhpSpreadsheet/pull/1267)
+- Handle ConditionalStyle NumberFormat When Reading Xlsx File [#1296](https://github.com/PHPOffice/PhpSpreadsheet/pull/1296)
+- Fix Xlsx Writer's handling of decimal commas [#1282](https://github.com/PHPOffice/PhpSpreadsheet/pull/1282)
+- Fix for issue by removing test code mistakenly left in [#1328](https://github.com/PHPOffice/PhpSpreadsheet/pull/1328)
+- Fix for Xls writer wrong selected cells and active sheet [#1256](https://github.com/PHPOffice/PhpSpreadsheet/pull/1256)
+- Fix active cell when freeze pane is used [#1323](https://github.com/PHPOffice/PhpSpreadsheet/pull/1323)
+- Fix XLSX file loading with autofilter containing '$' [#1326](https://github.com/PHPOffice/PhpSpreadsheet/pull/1326)
+- PHPDoc - Use `@return $this` for fluent methods [#1362](https://github.com/PHPOffice/PhpSpreadsheet/pull/1362)
+
+## 1.10.1 - 2019-12-02
+
+### Changed
+
+- PHP 7.4 compatibility
+
+### Fixed
+
+- FLOOR() function accept negative number and negative significance [#1245](https://github.com/PHPOffice/PhpSpreadsheet/pull/1245)
+- Correct column style even when using rowspan [#1249](https://github.com/PHPOffice/PhpSpreadsheet/pull/1249)
+- Do not confuse defined names and cell refs [#1263](https://github.com/PHPOffice/PhpSpreadsheet/pull/1263)
+- XLSX reader/writer keep decimal for floats with a zero decimal part [#1262](https://github.com/PHPOffice/PhpSpreadsheet/pull/1262)
+- ODS writer prevent invalid numeric value if locale decimal separator is comma [#1268](https://github.com/PHPOffice/PhpSpreadsheet/pull/1268)
+- Xlsx writer actually writes plotVisOnly and dispBlanksAs from chart properties [#1266](https://github.com/PHPOffice/PhpSpreadsheet/pull/1266)
+
+## 1.10.0 - 2019-11-18
+
+### Changed
+
+- Change license from LGPL 2.1 to MIT [#140](https://github.com/PHPOffice/PhpSpreadsheet/issues/140)
+
+### Added
+
+- Implementation of IFNA() logical function
+- Support "showZeros" worksheet option to change how Excel shows and handles "null" values returned from a calculation
+- Allow HTML Reader to accept HTML as a string into an existing spreadsheet [#1212](https://github.com/PHPOffice/PhpSpreadsheet/pull/1212)
+
+### Fixed
+
+- IF implementation properly handles the value `#N/A` [#1165](https://github.com/PHPOffice/PhpSpreadsheet/pull/1165)
+- Formula Parser: Wrong line count for stuff like "MyOtherSheet!A:D" [#1215](https://github.com/PHPOffice/PhpSpreadsheet/issues/1215)
+- Call garbage collector after removing a column to prevent stale cached values
+- Trying to remove a column that doesn't exist deletes the latest column
+- Keep big integer as integer instead of lossely casting to float [#874](https://github.com/PHPOffice/PhpSpreadsheet/pull/874)
+- Fix branch pruning handling of non boolean conditions [#1167](https://github.com/PHPOffice/PhpSpreadsheet/pull/1167)
+- Fix ODS Reader when no DC namespace are defined [#1182](https://github.com/PHPOffice/PhpSpreadsheet/pull/1182)
+- Fixed Functions->ifCondition for allowing <> and empty condition [#1206](https://github.com/PHPOffice/PhpSpreadsheet/pull/1206)
+- Validate XIRR inputs and return correct error values [#1120](https://github.com/PHPOffice/PhpSpreadsheet/issues/1120)
+- Allow to read xlsx files with exotic workbook names like "workbook2.xml" [#1183](https://github.com/PHPOffice/PhpSpreadsheet/pull/1183)
+
+## 1.9.0 - 2019-08-17
+
+### Changed
+
+- Drop support for PHP 5.6 and 7.0, according to https://phpspreadsheet.readthedocs.io/en/latest/#php-version-support
+
+### Added
+
+- When <br> appears in a table cell, set the cell to wrap [#1071](https://github.com/PHPOffice/PhpSpreadsheet/issues/1071) and [#1070](https://github.com/PHPOffice/PhpSpreadsheet/pull/1070)
+- Add MAXIFS, MINIFS, COUNTIFS and Remove MINIF, MAXIF [#1056](https://github.com/PHPOffice/PhpSpreadsheet/issues/1056)
+- HLookup needs an ordered list even if range_lookup is set to false [#1055](https://github.com/PHPOffice/PhpSpreadsheet/issues/1055) and [#1076](https://github.com/PHPOffice/PhpSpreadsheet/pull/1076)
+- Improve performance of IF function calls via ranch pruning to avoid resolution of every branches [#844](https://github.com/PHPOffice/PhpSpreadsheet/pull/844)
+- MATCH function supports `*?~` Excel functionality, when match_type=0 [#1116](https://github.com/PHPOffice/PhpSpreadsheet/issues/1116)
+- Allow HTML Reader to accept HTML as a string [#1136](https://github.com/PHPOffice/PhpSpreadsheet/pull/1136)
+
+### Fixed
+
+- Fix to AVERAGEIF() function when called with a third argument
+- Eliminate duplicate fill none style entries [#1066](https://github.com/PHPOffice/PhpSpreadsheet/issues/1066)
+- Fix number format masks containing literal (non-decimal point) dots [#1079](https://github.com/PHPOffice/PhpSpreadsheet/issues/1079)
+- Fix number format masks containing named colours that were being misinterpreted as date formats; and add support for masks that fully replace the value with a full text string [#1009](https://github.com/PHPOffice/PhpSpreadsheet/issues/1009)
+- Stricter-typed comparison testing in COUNTIF() and COUNTIFS() evaluation [#1046](https://github.com/PHPOffice/PhpSpreadsheet/issues/1046)
+- COUPNUM should not return zero when settlement is in the last period [#1020](https://github.com/PHPOffice/PhpSpreadsheet/issues/1020) and [#1021](https://github.com/PHPOffice/PhpSpreadsheet/pull/1021)
+- Fix handling of named ranges referencing sheets with spaces or "!" in their title
+- Cover `getSheetByName()` with tests for name with quote and spaces [#739](https://github.com/PHPOffice/PhpSpreadsheet/issues/739)
+- Best effort to support invalid colspan values in HTML reader - [#878](https://github.com/PHPOffice/PhpSpreadsheet/pull/878)
+- Fixes incorrect rows deletion [#868](https://github.com/PHPOffice/PhpSpreadsheet/issues/868)
+- MATCH function fix (value search by type, stop search when match_type=-1 and unordered element encountered) [#1116](https://github.com/PHPOffice/PhpSpreadsheet/issues/1116)
+- Fix `getCalculatedValue()` error with more than two INDIRECT [#1115](https://github.com/PHPOffice/PhpSpreadsheet/pull/1115)
+- Writer\Html did not hide columns [#985](https://github.com/PHPOffice/PhpSpreadsheet/pull/985)
+
+## 1.8.2 - 2019-07-08
+
+### Fixed
+
+- Uncaught error when opening ods file and properties aren't defined [#1047](https://github.com/PHPOffice/PhpSpreadsheet/issues/1047)
+- Xlsx Reader Cell datavalidations bug [#1052](https://github.com/PHPOffice/PhpSpreadsheet/pull/1052)
+
+## 1.8.1 - 2019-07-02
+
+### Fixed
+
+- Allow nullable theme for Xlsx Style Reader class [#1043](https://github.com/PHPOffice/PhpSpreadsheet/issues/1043)
+
+## 1.8.0 - 2019-07-01
+
+### Security Fix (CVE-2019-12331)
+
+- Detect double-encoded xml in the Security scanner, and reject as suspicious.
+- This change also broadens the scope of the `libxml_disable_entity_loader` setting when reading XML-based formats, so that it is enabled while the xml is being parsed and not simply while it is loaded.
+ On some versions of PHP, this can cause problems because it is not thread-safe, and can affect other PHP scripts running on the same server. This flag is set to true when instantiating a loader, and back to its original setting when the Reader is no longer in scope, or manually unset.
+- Provide a check to identify whether libxml_disable_entity_loader is thread-safe or not.
+
+ `XmlScanner::threadSafeLibxmlDisableEntityLoaderAvailability()`
+- Provide an option to disable the libxml_disable_entity_loader call through settings. This is not recommended as it reduces the security of the XML-based readers, and should only be used if you understand the consequences and have no other choice.
+
+### Added
+
+- Added support for the SWITCH function [#963](https://github.com/PHPOffice/PhpSpreadsheet/issues/963) and [#983](https://github.com/PHPOffice/PhpSpreadsheet/pull/983)
+- Add accounting number format style [#974](https://github.com/PHPOffice/PhpSpreadsheet/pull/974)
+
+### Fixed
+
+- Whitelist `tsv` extension when opening CSV files [#429](https://github.com/PHPOffice/PhpSpreadsheet/issues/429)
+- Fix a SUMIF warning with some versions of PHP when having different length of arrays provided as input [#873](https://github.com/PHPOffice/PhpSpreadsheet/pull/873)
+- Fix incorrectly handled backslash-escaped space characters in number format
+
+## 1.7.0 - 2019-05-26
+
+- Added support for inline styles in Html reader (borders, alignment, width, height)
+- QuotedText cells no longer treated as formulae if the content begins with a `=`
+- Clean handling for DDE in formulae
+
+### Fixed
+
+- Fix handling for escaped enclosures and new lines in CSV Separator Inference
+- Fix MATCH an error was appearing when comparing strings against 0 (always true)
+- Fix wrong calculation of highest column with specified row [#700](https://github.com/PHPOffice/PhpSpreadsheet/issues/700)
+- Fix VLOOKUP
+- Fix return type hint
+
+## 1.6.0 - 2019-01-02
+
+### Added
+
+- Refactored Matrix Functions to use external Matrix library
+- Possibility to specify custom colors of values for pie and donut charts [#768](https://github.com/PHPOffice/PhpSpreadsheet/pull/768)
+
+### Fixed
+
+- Improve XLSX parsing speed if no readFilter is applied [#772](https://github.com/PHPOffice/PhpSpreadsheet/issues/772)
+- Fix column names if read filter calls in XLSX reader skip columns [#777](https://github.com/PHPOffice/PhpSpreadsheet/pull/777)
+- XLSX reader can now ignore blank cells, using the setReadEmptyCells(false) method. [#810](https://github.com/PHPOffice/PhpSpreadsheet/issues/810)
+- Fix LOOKUP function which was breaking on edge cases [#796](https://github.com/PHPOffice/PhpSpreadsheet/issues/796)
+- Fix VLOOKUP with exact matches [#809](https://github.com/PHPOffice/PhpSpreadsheet/pull/809)
+- Support COUNTIFS multiple arguments [#830](https://github.com/PHPOffice/PhpSpreadsheet/pull/830)
+- Change `libxml_disable_entity_loader()` as shortly as possible [#819](https://github.com/PHPOffice/PhpSpreadsheet/pull/819)
+- Improved memory usage and performance when loading large spreadsheets [#822](https://github.com/PHPOffice/PhpSpreadsheet/pull/822)
+- Improved performance when loading large spreadsheets [#825](https://github.com/PHPOffice/PhpSpreadsheet/pull/825)
+- Improved performance when loading large spreadsheets [#824](https://github.com/PHPOffice/PhpSpreadsheet/pull/824)
+- Fix color from CSS when reading from HTML [#831](https://github.com/PHPOffice/PhpSpreadsheet/pull/831)
+- Fix infinite loop when reading invalid ODS files [#832](https://github.com/PHPOffice/PhpSpreadsheet/pull/832)
+- Fix time format for duration is incorrect [#666](https://github.com/PHPOffice/PhpSpreadsheet/pull/666)
+- Fix iconv unsupported `//IGNORE//TRANSLIT` on IBM i [#791](https://github.com/PHPOffice/PhpSpreadsheet/issues/791)
+
+### Changed
+
+- `master` is the new default branch, `develop` does not exist anymore
+
+## 1.5.2 - 2018-11-25
+
+### Security
+
+- Improvements to the design of the XML Security Scanner [#771](https://github.com/PHPOffice/PhpSpreadsheet/issues/771)
+
+## 1.5.1 - 2018-11-20
+
+### Security
+
+- Fix and improve XXE security scanning for XML-based and HTML Readers [#771](https://github.com/PHPOffice/PhpSpreadsheet/issues/771)
+
+### Added
+
+- Support page margin in mPDF [#750](https://github.com/PHPOffice/PhpSpreadsheet/issues/750)
+
+### Fixed
+
+- Support numeric condition in SUMIF, SUMIFS, AVERAGEIF, COUNTIF, MAXIF and MINIF [#683](https://github.com/PHPOffice/PhpSpreadsheet/issues/683)
+- SUMIFS containing multiple conditions [#704](https://github.com/PHPOffice/PhpSpreadsheet/issues/704)
+- Csv reader avoid notice when the file is empty [#743](https://github.com/PHPOffice/PhpSpreadsheet/pull/743)
+- Fix print area parser for XLSX reader [#734](https://github.com/PHPOffice/PhpSpreadsheet/pull/734)
+- Support overriding `DefaultValueBinder::dataTypeForValue()` without overriding `DefaultValueBinder::bindValue()` [#735](https://github.com/PHPOffice/PhpSpreadsheet/pull/735)
+- Mpdf export can exceed pcre.backtrack_limit [#637](https://github.com/PHPOffice/PhpSpreadsheet/issues/637)
+- Fix index overflow on data values array [#748](https://github.com/PHPOffice/PhpSpreadsheet/pull/748)
+
+## 1.5.0 - 2018-10-21
+
+### Added
+
+- PHP 7.3 support
+- Add the DAYS() function [#594](https://github.com/PHPOffice/PhpSpreadsheet/pull/594)
+
+### Fixed
+
+- Sheet title can contain exclamation mark [#325](https://github.com/PHPOffice/PhpSpreadsheet/issues/325)
+- Xls file cause the exception during open by Xls reader [#402](https://github.com/PHPOffice/PhpSpreadsheet/issues/402)
+- Skip non numeric value in SUMIF [#618](https://github.com/PHPOffice/PhpSpreadsheet/pull/618)
+- OFFSET should allow omitted height and width [#561](https://github.com/PHPOffice/PhpSpreadsheet/issues/561)
+- Correctly determine delimiter when CSV contains line breaks inside enclosures [#716](https://github.com/PHPOffice/PhpSpreadsheet/issues/716)
+
+## 1.4.1 - 2018-09-30
+
+### Fixed
+
+- Remove locale from formatting string [#644](https://github.com/PHPOffice/PhpSpreadsheet/pull/644)
+- Allow iterators to go out of bounds with prev [#587](https://github.com/PHPOffice/PhpSpreadsheet/issues/587)
+- Fix warning when reading xlsx without styles [#631](https://github.com/PHPOffice/PhpSpreadsheet/pull/631)
+- Fix broken sample links on windows due to $baseDir having backslash [#653](https://github.com/PHPOffice/PhpSpreadsheet/pull/653)
+
+## 1.4.0 - 2018-08-06
+
+### Added
+
+- Add excel function EXACT(value1, value2) support [#595](https://github.com/PHPOffice/PhpSpreadsheet/pull/595)
+- Support workbook view attributes for Xlsx format [#523](https://github.com/PHPOffice/PhpSpreadsheet/issues/523)
+- Read and write hyperlink for drawing image [#490](https://github.com/PHPOffice/PhpSpreadsheet/pull/490)
+- Added calculation engine support for the new bitwise functions that were added in MS Excel 2013
+ - BITAND() Returns a Bitwise 'And' of two numbers
+ - BITOR() Returns a Bitwise 'Or' of two number
+ - BITXOR() Returns a Bitwise 'Exclusive Or' of two numbers
+ - BITLSHIFT() Returns a number shifted left by a specified number of bits
+ - BITRSHIFT() Returns a number shifted right by a specified number of bits
+- Added calculation engine support for other new functions that were added in MS Excel 2013 and MS Excel 2016
+ - Text Functions
+ - CONCAT() Synonym for CONCATENATE()
+ - NUMBERVALUE() Converts text to a number, in a locale-independent way
+ - UNICHAR() Synonym for CHAR() in PHPSpreadsheet, which has always used UTF-8 internally
+ - UNIORD() Synonym for ORD() in PHPSpreadsheet, which has always used UTF-8 internally
+ - TEXTJOIN() Joins together two or more text strings, separated by a delimiter
+ - Logical Functions
+ - XOR() Returns a logical Exclusive Or of all arguments
+ - Date/Time Functions
+ - ISOWEEKNUM() Returns the ISO 8601 week number of the year for a given date
+ - Lookup and Reference Functions
+ - FORMULATEXT() Returns a formula as a string
+ - Financial Functions
+ - PDURATION() Calculates the number of periods required for an investment to reach a specified value
+ - RRI() Calculates the interest rate required for an investment to grow to a specified future value
+ - Engineering Functions
+ - ERF.PRECISE() Returns the error function integrated between 0 and a supplied limit
+ - ERFC.PRECISE() Synonym for ERFC
+ - Math and Trig Functions
+ - SEC() Returns the secant of an angle
+ - SECH() Returns the hyperbolic secant of an angle
+ - CSC() Returns the cosecant of an angle
+ - CSCH() Returns the hyperbolic cosecant of an angle
+ - COT() Returns the cotangent of an angle
+ - COTH() Returns the hyperbolic cotangent of an angle
+ - ACOT() Returns the cotangent of an angle
+ - ACOTH() Returns the hyperbolic cotangent of an angle
+- Refactored Complex Engineering Functions to use external complex number library
+- Added calculation engine support for the new complex number functions that were added in MS Excel 2013
+ - IMCOSH() Returns the hyperbolic cosine of a complex number
+ - IMCOT() Returns the cotangent of a complex number
+ - IMCSC() Returns the cosecant of a complex number
+ - IMCSCH() Returns the hyperbolic cosecant of a complex number
+ - IMSEC() Returns the secant of a complex number
+ - IMSECH() Returns the hyperbolic secant of a complex number
+ - IMSINH() Returns the hyperbolic sine of a complex number
+ - IMTAN() Returns the tangent of a complex number
+
+### Fixed
+
+- Fix ISFORMULA() function to work with a cell reference to another worksheet
+- Xlsx reader crashed when reading a file with workbook protection [#553](https://github.com/PHPOffice/PhpSpreadsheet/pull/553)
+- Cell formats with escaped spaces were causing incorrect date formatting [#557](https://github.com/PHPOffice/PhpSpreadsheet/issues/557)
+- Could not open CSV file containing HTML fragment [#564](https://github.com/PHPOffice/PhpSpreadsheet/issues/564)
+- Exclude the vendor folder in migration [#481](https://github.com/PHPOffice/PhpSpreadsheet/issues/481)
+- Chained operations on cell ranges involving borders operated on last cell only [#428](https://github.com/PHPOffice/PhpSpreadsheet/issues/428)
+- Avoid memory exhaustion when cloning worksheet with a drawing [#437](https://github.com/PHPOffice/PhpSpreadsheet/issues/437)
+- Migration tool keep variables containing $PHPExcel untouched [#598](https://github.com/PHPOffice/PhpSpreadsheet/issues/598)
+- Rowspans/colspans were incorrect when adding worksheet using loadIntoExisting [#619](https://github.com/PHPOffice/PhpSpreadsheet/issues/619)
+
+## 1.3.1 - 2018-06-12
+
+### Fixed
+
+- Ranges across Z and AA columns incorrectly threw an exception [#545](https://github.com/PHPOffice/PhpSpreadsheet/issues/545)
+
+## 1.3.0 - 2018-06-10
+
+### Added
+
+- Support to read Xlsm templates with form elements, macros, printer settings, protected elements and back compatibility drawing, and save result without losing important elements of document [#435](https://github.com/PHPOffice/PhpSpreadsheet/issues/435)
+- Expose sheet title maximum length as `Worksheet::SHEET_TITLE_MAXIMUM_LENGTH` [#482](https://github.com/PHPOffice/PhpSpreadsheet/issues/482)
+- Allow escape character to be set in CSV reader [#492](https://github.com/PHPOffice/PhpSpreadsheet/issues/492)
+
+### Fixed
+
+- Subtotal 9 in a group that has other subtotals 9 exclude the totals of the other subtotals in the range [#332](https://github.com/PHPOffice/PhpSpreadsheet/issues/332)
+- `Helper\Html` support UTF-8 HTML input [#444](https://github.com/PHPOffice/PhpSpreadsheet/issues/444)
+- Xlsx loaded an extra empty comment for each real comment [#375](https://github.com/PHPOffice/PhpSpreadsheet/issues/375)
+- Xlsx reader do not read rows and columns filtered out in readFilter at all [#370](https://github.com/PHPOffice/PhpSpreadsheet/issues/370)
+- Make newer Excel versions properly recalculate formulas on document open [#456](https://github.com/PHPOffice/PhpSpreadsheet/issues/456)
+- `Coordinate::extractAllCellReferencesInRange()` throws an exception for an invalid range [#519](https://github.com/PHPOffice/PhpSpreadsheet/issues/519)
+- Fixed parsing of conditionals in COUNTIF functions [#526](https://github.com/PHPOffice/PhpSpreadsheet/issues/526)
+- Corruption errors for saved Xlsx docs with frozen panes [#532](https://github.com/PHPOffice/PhpSpreadsheet/issues/532)
+
+## 1.2.1 - 2018-04-10
+
+### Fixed
+
+- Plain text and richtext mixed in same cell can be read [#442](https://github.com/PHPOffice/PhpSpreadsheet/issues/442)
+
+## 1.2.0 - 2018-03-04
+
+### Added
+
+- HTML writer creates a generator meta tag [#312](https://github.com/PHPOffice/PhpSpreadsheet/issues/312)
+- Support invalid zoom value in XLSX format [#350](https://github.com/PHPOffice/PhpSpreadsheet/pull/350)
+- Support for `_xlfn.` prefixed functions and `ISFORMULA`, `MODE.SNGL`, `STDEV.S`, `STDEV.P` [#390](https://github.com/PHPOffice/PhpSpreadsheet/pull/390)
+
+### Fixed
+
+- Avoid potentially unsupported PSR-16 cache keys [#354](https://github.com/PHPOffice/PhpSpreadsheet/issues/354)
+- Check for MIME type to know if CSV reader can read a file [#167](https://github.com/PHPOffice/PhpSpreadsheet/issues/167)
+- Use proper € symbol for currency format [#379](https://github.com/PHPOffice/PhpSpreadsheet/pull/379)
+- Read printing area correctly when skipping some sheets [#371](https://github.com/PHPOffice/PhpSpreadsheet/issues/371)
+- Avoid incorrectly overwriting calculated value type [#394](https://github.com/PHPOffice/PhpSpreadsheet/issues/394)
+- Select correct cell when calling freezePane [#389](https://github.com/PHPOffice/PhpSpreadsheet/issues/389)
+- `setStrikethrough()` did not set the font [#403](https://github.com/PHPOffice/PhpSpreadsheet/issues/403)
+
+## 1.1.0 - 2018-01-28
+
+### Added
+
+- Support for PHP 7.2
+- Support cell comments in HTML writer and reader [#308](https://github.com/PHPOffice/PhpSpreadsheet/issues/308)
+- Option to stop at a conditional styling, if it matches (only XLSX format) [#292](https://github.com/PHPOffice/PhpSpreadsheet/pull/292)
+- Support for line width for data series when rendering Xlsx [#329](https://github.com/PHPOffice/PhpSpreadsheet/pull/329)
+
+### Fixed
+
+- Better auto-detection of CSV separators [#305](https://github.com/PHPOffice/PhpSpreadsheet/issues/305)
+- Support for shape style ending with `;` [#304](https://github.com/PHPOffice/PhpSpreadsheet/issues/304)
+- Freeze Panes takes wrong coordinates for XLSX [#322](https://github.com/PHPOffice/PhpSpreadsheet/issues/322)
+- `COLUMNS` and `ROWS` functions crashed in some cases [#336](https://github.com/PHPOffice/PhpSpreadsheet/issues/336)
+- Support XML file without styles [#331](https://github.com/PHPOffice/PhpSpreadsheet/pull/331)
+- Cell coordinates which are already a range cause an exception [#319](https://github.com/PHPOffice/PhpSpreadsheet/issues/319)
+
+## 1.0.0 - 2017-12-25
+
+### Added
+
+- Support to write merged cells in ODS format [#287](https://github.com/PHPOffice/PhpSpreadsheet/issues/287)
+- Able to set the `topLeftCell` in freeze panes [#261](https://github.com/PHPOffice/PhpSpreadsheet/pull/261)
+- Support `DateTimeImmutable` as cell value
+- Support migration of prefixed classes
+
+### Fixed
+
+- Can read very small HTML files [#194](https://github.com/PHPOffice/PhpSpreadsheet/issues/194)
+- Written DataValidation was corrupted [#290](https://github.com/PHPOffice/PhpSpreadsheet/issues/290)
+- Date format compatible with both LibreOffice and Excel [#298](https://github.com/PHPOffice/PhpSpreadsheet/issues/298)
+
+### BREAKING CHANGE
+
+- Constant `TYPE_DOUGHTNUTCHART` is now `TYPE_DOUGHNUTCHART`.
+
+## 1.0.0-beta2 - 2017-11-26
+
+### Added
+
+- Support for chart fill color - @CrazyBite [#158](https://github.com/PHPOffice/PhpSpreadsheet/pull/158)
+- Support for read Hyperlink for xml - @GreatHumorist [#223](https://github.com/PHPOffice/PhpSpreadsheet/pull/223)
+- Support for cell value validation according to data validation rules - @SailorMax [#257](https://github.com/PHPOffice/PhpSpreadsheet/pull/257)
+- Support for custom implementation, or configuration, of PDF libraries - @SailorMax [#266](https://github.com/PHPOffice/PhpSpreadsheet/pull/266)
+
+### Changed
+
+- Merge data-validations to reduce written worksheet size - @billblume [#131](https://github.com/PHPOffice/PhpSpreadSheet/issues/131)
+- Throws exception if a XML file is invalid - @GreatHumorist [#222](https://github.com/PHPOffice/PhpSpreadsheet/pull/222)
+- Upgrade to mPDF 7.0+ [#144](https://github.com/PHPOffice/PhpSpreadsheet/issues/144)
+
+### Fixed
+
+- Control characters in cell values are automatically escaped [#212](https://github.com/PHPOffice/PhpSpreadsheet/issues/212)
+- Prevent color changing when copy/pasting xls files written by PhpSpreadsheet to another file - @al-lala [#218](https://github.com/PHPOffice/PhpSpreadsheet/issues/218)
+- Add cell reference automatic when there is no cell reference('r' attribute) in Xlsx file. - @GreatHumorist [#225](https://github.com/PHPOffice/PhpSpreadsheet/pull/225) Refer to [#201](https://github.com/PHPOffice/PhpSpreadsheet/issues/201)
+- `Reader\Xlsx::getFromZipArchive()` function return false if the zip entry could not be located. - @anton-harvey [#268](https://github.com/PHPOffice/PhpSpreadsheet/pull/268)
+
+### BREAKING CHANGE
+
+- Extracted coordinate method to dedicate class [migration guide](./docs/topics/migration-from-PHPExcel.md).
+- Column indexes are based on 1, see the [migration guide](./docs/topics/migration-from-PHPExcel.md).
+- Standardization of array keys used for style, see the [migration guide](./docs/topics/migration-from-PHPExcel.md).
+- Easier usage of PDF writers, and other custom readers and writers, see the [migration guide](./docs/topics/migration-from-PHPExcel.md).
+- Easier usage of chart renderers, see the [migration guide](./docs/topics/migration-from-PHPExcel.md).
+- Rename a few more classes to keep them in their related namespaces:
+ - `CalcEngine` => `Calculation\Engine`
+ - `PhpSpreadsheet\Calculation` => `PhpSpreadsheet\Calculation\Calculation`
+ - `PhpSpreadsheet\Cell` => `PhpSpreadsheet\Cell\Cell`
+ - `PhpSpreadsheet\Chart` => `PhpSpreadsheet\Chart\Chart`
+ - `PhpSpreadsheet\RichText` => `PhpSpreadsheet\RichText\RichText`
+ - `PhpSpreadsheet\Style` => `PhpSpreadsheet\Style\Style`
+ - `PhpSpreadsheet\Worksheet` => `PhpSpreadsheet\Worksheet\Worksheet`
+
+## 1.0.0-beta - 2017-08-17
+
+### Added
+
+- Initial implementation of SUMIFS() function
+- Additional codepages
+- MemoryDrawing not working in HTML writer [#808](https://github.com/PHPOffice/PHPExcel/issues/808)
+- CSV Reader can auto-detect the separator used in file [#141](https://github.com/PHPOffice/PhpSpreadsheet/pull/141)
+- HTML Reader supports some basic inline styles [#180](https://github.com/PHPOffice/PhpSpreadsheet/pull/180)
+
+### Changed
+
+- Start following [SemVer](https://semver.org) properly.
+
+### Fixed
+
+- Fix to getCell() method when cell reference includes a worksheet reference - @MarkBaker
+- Ignore inlineStr type if formula element exists - @ncrypthic [#570](https://github.com/PHPOffice/PHPExcel/issues/570)
+- Excel 2007 Reader freezes because of conditional formatting - @rentalhost [#575](https://github.com/PHPOffice/PHPExcel/issues/575)
+- Readers will now parse files containing worksheet titles over 31 characters [#176](https://github.com/PHPOffice/PhpSpreadsheet/pull/176)
+- Fixed PHP8 deprecation warning for libxml_disable_entity_loader() [#1625](https://github.com/phpoffice/phpspreadsheet/pull/1625)
+
+### General
+
+- Whitespace after toRichTextObject() - @MarkBaker [#554](https://github.com/PHPOffice/PHPExcel/issues/554)
+- Optimize vlookup() sort - @umpirsky [#548](https://github.com/PHPOffice/PHPExcel/issues/548)
+- c:max and c:min elements shall NOT be inside c:orientation elements - @vitalyrepin [#869](https://github.com/PHPOffice/PHPExcel/pull/869)
+- Implement actual timezone adjustment into PHPExcel_Shared_Date::PHPToExcel - @sim642 [#489](https://github.com/PHPOffice/PHPExcel/pull/489)
+
+### BREAKING CHANGE
+
+- Introduction of namespaces for all classes, eg: `PHPExcel_Calculation_Functions` becomes `PhpOffice\PhpSpreadsheet\Calculation\Functions`
+- Some classes were renamed for clarity and/or consistency:
+
+For a comprehensive list of all class changes, and a semi-automated migration path, read the [migration guide](./docs/topics/migration-from-PHPExcel.md).
+
+- Dropped `PHPExcel_Calculation_Functions::VERSION()`. Composer or git should be used to know the version.
+- Dropped `PHPExcel_Settings::setPdfRenderer()` and `PHPExcel_Settings::setPdfRenderer()`. Composer should be used to autoload PDF libs.
+- Dropped support for HHVM
+
+## Previous versions of PHPExcel
+
+The changelog for the project when it was called PHPExcel is [still available](./CHANGELOG.PHPExcel.md).
+
+### Changed
+- Replace ezyang/htmlpurifier (LGPL2.1) with voku/anti-xss (MIT)
diff --git a/api/vendor/phpoffice/phpspreadsheet/CONTRIBUTING.md b/api/vendor/phpoffice/phpspreadsheet/CONTRIBUTING.md
new file mode 100644
index 00000000..e89e99ec
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/CONTRIBUTING.md
@@ -0,0 +1,45 @@
+# Want to contribute?
+
+If you would like to contribute, here are some notes and guidelines:
+
+ - All new development should be on feature/fix branches, which are then merged to the `master` branch once stable and approved; so the `master` branch is always the most up-to-date, working code
+ - If you are going to submit a pull request, please fork from `master`, and submit your pull request back as a fix/feature branch referencing the GitHub issue number
+ - The code must work with all PHP versions that we support.
+ - You can call `composer versions` to test version compatibility.
+ - Code style should be maintained.
+ - `composer style` will identify any issues with Coding Style`.
+ - `composer fix` will fix most issues with Coding Style.
+ - All code changes must be validated by `composer check`.
+ - Please include Unit Tests to verify that a bug exists, and that this PR fixes it.
+ - Please include Unit Tests to show that a new Feature works as expected.
+ - Please don't "bundle" several changes into a single PR; submit a PR for each discrete change/fix.
+ - Remember to update documentation if necessary.
+
+ - [Helpful article about forking](https://help.github.com/articles/fork-a-repo/ "Forking a GitHub repository")
+ - [Helpful article about pull requests](https://help.github.com/articles/using-pull-requests/ "Pull Requests")
+
+## Unit Tests
+
+When writing Unit Tests, please
+ - Always try to write Unit Tests for both the happy and unhappy paths.
+ - Put all assertions in the Test itself, not in an abstract class that the Test extends (even if this means code duplication between tests).
+ - Include any necessary `setup()` and `tearDown()` in the Test itself.
+ - If you change any global settings (such as system locale, or Compatibility Mode for Excel Function tests), make sure that you reset to the default in the `tearDown()`.
+ - Use the `ExcelError` functions in assertions for Excel Error values in Excel Function implementations.
+ Not only does it reduce the risk of typos; but at some point in the future, ExcelError values will be an object rather than a string, and we won't then need to update all the tests.
+ - Don't over-complicate test code by testing happy and unhappy paths in the same test.
+
+This makes it easier to see exactly what is being tested when reviewing the PR. I want to be able to see it in the PR, not have to hunt in other unchanged classes to see what the test is doing.
+
+## How to release
+
+1. Complete CHANGELOG.md and commit
+2. Create an annotated tag
+ 1. `git tag -a 1.2.3`
+ 2. Tag subject must be the version number, eg: `1.2.3`
+ 3. Tag body must be a copy-paste of the changelog entries.
+3. Push the tag with `git push --tags`, GitHub Actions will create a GitHub release automatically, and the release details will automatically be sent to packagist.
+4. Github seems to remove markdown headings in the Release Notes, so you should edit to restore these.
+
+> **Note:** Tagged releases are made from the `master` branch. Only in an emergency should a tagged release be made from the `release` branch. (i.e. cherry-picked hot-fixes.)
+
diff --git a/api/vendor/phpoffice/phpspreadsheet/LICENSE b/api/vendor/phpoffice/phpspreadsheet/LICENSE
new file mode 100644
index 00000000..04a90f08
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019-2025 PhpSpreadsheet Authors
+
+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.
diff --git a/api/vendor/phpoffice/phpspreadsheet/README.md b/api/vendor/phpoffice/phpspreadsheet/README.md
new file mode 100644
index 00000000..84b4b7be
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/README.md
@@ -0,0 +1,70 @@
+# PhpSpreadsheet
+
+[](https://github.com/PHPOffice/PhpSpreadsheet/actions)
+[](https://scrutinizer-ci.com/g/PHPOffice/PhpSpreadsheet/?branch=master)
+[](https://scrutinizer-ci.com/g/PHPOffice/PhpSpreadsheet/?branch=master)
+[](https://packagist.org/packages/phpoffice/phpspreadsheet)
+[](https://packagist.org/packages/phpoffice/phpspreadsheet)
+[](https://packagist.org/packages/phpoffice/phpspreadsheet)
+[](https://gitter.im/PHPOffice/PhpSpreadsheet)
+
+PhpSpreadsheet is a library written in pure PHP and offers a set of classes that
+allow you to read and write various spreadsheet file formats such as Excel and LibreOffice Calc.
+
+## Installation
+
+See the [install instructions](https://phpspreadsheet.readthedocs.io/en/latest/#installation).
+
+## Documentation
+
+Read more about it, including install instructions, in the [official documentation](https://phpspreadsheet.readthedocs.io). Or check out the [API documentation](https://phpoffice.github.io/PhpSpreadsheet).
+
+Please ask your support questions on [StackOverflow](https://stackoverflow.com/questions/tagged/phpspreadsheet), or have a quick chat on [Gitter](https://gitter.im/PHPOffice/PhpSpreadsheet).
+
+## Patreon
+
+I am now running a [Patreon](https://www.patreon.com/MarkBaker) to support the work that I do on PhpSpreadsheet.
+
+Supporters will receive access to articles about working with PhpSpreadsheet, and how to use some of its more advanced features.
+
+Posts already available to Patreon supporters:
+ - The Dating Game
+ - A look at how MS Excel (and PhpSpreadsheet) handle date and time values.
+- Looping the Loop
+ - Advice on Iterating through the rows and cells in a worksheet.
+
+And for Patrons at levels actively using PhpSpreadsheet:
+ - Behind the Mask
+ - A look at Number Format Masks.
+
+The Next Article (currently Work in Progress):
+ - Formula for Success
+ - How to debug formulae that don't produce the expected result.
+
+
+My aim is to post at least one article each month, taking a detailed look at some feature of MS Excel and how to use that feature in PhpSpreadsheet, or on how to perform different activities in PhpSpreadsheet.
+
+Planned posts for the future include topics like:
+ - Tables
+ - Structured References
+ - AutoFiltering
+ - Array Formulae
+ - Conditional Formatting
+ - Data Validation
+ - Value Binders
+ - Images
+ - Charts
+
+After a period of six months exclusive to Patreon supporters, articles will be incorporated into the public documentation for the library.
+
+## PHPExcel vs PhpSpreadsheet ?
+
+PhpSpreadsheet is the next version of PHPExcel. It breaks compatibility to dramatically improve the code base quality (namespaces, PSR compliance, use of latest PHP language features, etc.).
+
+Because all efforts have shifted to PhpSpreadsheet, PHPExcel will no longer be maintained. All contributions for PHPExcel, patches and new features, should target PhpSpreadsheet `master` branch.
+
+Do you need to migrate? There is [an automated tool](/docs/topics/migration-from-PHPExcel.md) for that.
+
+## License
+
+PhpSpreadsheet is licensed under [MIT](https://github.com/PHPOffice/PhpSpreadsheet/blob/master/LICENSE).
diff --git a/api/vendor/phpoffice/phpspreadsheet/composer.json b/api/vendor/phpoffice/phpspreadsheet/composer.json
new file mode 100644
index 00000000..cb00ebf4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/composer.json
@@ -0,0 +1,121 @@
+{
+ "name": "phpoffice/phpspreadsheet",
+ "description": "PHPSpreadsheet - Read, Create and Write Spreadsheet documents in PHP - Spreadsheet engine",
+ "keywords": [
+ "PHP",
+ "OpenXML",
+ "Excel",
+ "xlsx",
+ "xls",
+ "ods",
+ "gnumeric",
+ "spreadsheet"
+ ],
+ "config": {
+ "platform": {
+ "php" : "8.1.99"
+ },
+ "sort-packages": true,
+ "allow-plugins": {
+ "dealerdirect/phpcodesniffer-composer-installer": true
+ }
+ },
+ "homepage": "https://github.com/PHPOffice/PhpSpreadsheet",
+ "type": "library",
+ "license": "MIT",
+ "authors": [
+ {
+ "name": "Maarten Balliauw",
+ "homepage": "https://blog.maartenballiauw.be"
+ },
+ {
+ "name": "Mark Baker",
+ "homepage": "https://markbakeruk.net"
+ },
+ {
+ "name": "Franck Lefevre",
+ "homepage": "https://rootslabs.net"
+ },
+ {
+ "name": "Erik Tilt"
+ },
+ {
+ "name": "Adrien Crivelli"
+ }
+ ],
+ "scripts": {
+ "check": [
+ "./bin/check-phpdoc-types",
+ "phpcs samples/ src/ tests/ --report=checkstyle",
+ "phpcs samples/ src/ tests/ --standard=PHPCompatibility --runtime-set testVersion 8.0- -n",
+ "php-cs-fixer fix --ansi --dry-run --diff",
+ "phpunit --color=always",
+ "phpstan analyse --ansi --memory-limit=2048M"
+ ],
+ "style": [
+ "phpcs samples/ src/ tests/ --report=checkstyle",
+ "php-cs-fixer fix --ansi --dry-run --diff"
+ ],
+ "fix": [
+ "phpcbf samples/ src/ tests/ --report=checkstyle",
+ "php-cs-fixer fix"
+ ],
+ "versions": [
+ "phpcs samples/ src/ tests/ --standard=PHPCompatibility --runtime-set testVersion 8.0- -n"
+ ]
+ },
+ "require": {
+ "php": "^8.1",
+ "ext-ctype": "*",
+ "ext-dom": "*",
+ "ext-fileinfo": "*",
+ "ext-gd": "*",
+ "ext-iconv": "*",
+ "ext-libxml": "*",
+ "ext-mbstring": "*",
+ "ext-simplexml": "*",
+ "ext-xml": "*",
+ "ext-xmlreader": "*",
+ "ext-xmlwriter": "*",
+ "ext-zip": "*",
+ "ext-zlib": "*",
+ "composer/pcre": "^1 || ^2 || ^3",
+ "maennchen/zipstream-php": "^2.1 || ^3.0",
+ "markbaker/complex": "^3.0",
+ "markbaker/matrix": "^3.0",
+ "psr/http-client": "^1.0",
+ "psr/http-factory": "^1.0",
+ "psr/simple-cache": "^1.0 || ^2.0 || ^3.0"
+ },
+ "require-dev": {
+ "dealerdirect/phpcodesniffer-composer-installer": "dev-main",
+ "dompdf/dompdf": "^2.0 || ^3.0",
+ "friendsofphp/php-cs-fixer": "^3.2",
+ "mitoteam/jpgraph": "^10.3",
+ "mpdf/mpdf": "^8.1.1",
+ "phpcompatibility/php-compatibility": "^9.3",
+ "phpstan/phpstan": "^1.1",
+ "phpstan/phpstan-phpunit": "^1.0",
+ "phpunit/phpunit": "^9.6 || ^10.5",
+ "squizlabs/php_codesniffer": "^3.7",
+ "tecnickcom/tcpdf": "^6.5"
+ },
+ "suggest": {
+ "ext-intl": "PHP Internationalization Functions",
+ "mpdf/mpdf": "Option for rendering PDF with PDF Writer",
+ "dompdf/dompdf": "Option for rendering PDF with PDF Writer",
+ "tecnickcom/tcpdf": "Option for rendering PDF with PDF Writer",
+ "mitoteam/jpgraph": "Option for rendering charts, or including charts with PDF or HTML Writers"
+ },
+ "autoload": {
+ "psr-4": {
+ "PhpOffice\\PhpSpreadsheet\\": "src/PhpSpreadsheet"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "PhpOffice\\PhpSpreadsheetTests\\": "tests/PhpSpreadsheetTests",
+ "PhpOffice\\PhpSpreadsheetInfra\\": "infra"
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/ArrayEnabled.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/ArrayEnabled.php
new file mode 100644
index 00000000..7b78b6f5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/ArrayEnabled.php
@@ -0,0 +1,122 @@
+initialise(($arguments === false) ? [] : $arguments);
+ }
+
+ /**
+ * Handles array argument processing when the function accepts a single argument that can be an array argument.
+ * Example use for:
+ * DAYOFMONTH() or FACT().
+ */
+ protected static function evaluateSingleArgumentArray(callable $method, array $values): array
+ {
+ $result = [];
+ foreach ($values as $value) {
+ $result[] = $method($value);
+ }
+
+ return $result;
+ }
+
+ /**
+ * Handles array argument processing when the function accepts multiple arguments,
+ * and any of them can be an array argument.
+ * Example use for:
+ * ROUND() or DATE().
+ */
+ protected static function evaluateArrayArguments(callable $method, mixed ...$arguments): array
+ {
+ self::initialiseHelper($arguments);
+ $arguments = self::$arrayArgumentHelper->arguments();
+
+ return ArrayArgumentProcessor::processArguments(self::$arrayArgumentHelper, $method, ...$arguments);
+ }
+
+ /**
+ * Handles array argument processing when the function accepts multiple arguments,
+ * but only the first few (up to limit) can be an array arguments.
+ * Example use for:
+ * NETWORKDAYS() or CONCATENATE(), where the last argument is a matrix (or a series of values) that need
+ * to be treated as a such rather than as an array arguments.
+ */
+ protected static function evaluateArrayArgumentsSubset(callable $method, int $limit, mixed ...$arguments): array
+ {
+ self::initialiseHelper(array_slice($arguments, 0, $limit));
+ $trailingArguments = array_slice($arguments, $limit);
+ $arguments = self::$arrayArgumentHelper->arguments();
+ $arguments = array_merge($arguments, $trailingArguments);
+
+ return ArrayArgumentProcessor::processArguments(self::$arrayArgumentHelper, $method, ...$arguments);
+ }
+
+ private static function testFalse(mixed $value): bool
+ {
+ return $value === false;
+ }
+
+ /**
+ * Handles array argument processing when the function accepts multiple arguments,
+ * but only the last few (from start) can be an array arguments.
+ * Example use for:
+ * Z.TEST() or INDEX(), where the first argument 1 is a matrix that needs to be treated as a dataset
+ * rather than as an array argument.
+ */
+ protected static function evaluateArrayArgumentsSubsetFrom(callable $method, int $start, mixed ...$arguments): array
+ {
+ $arrayArgumentsSubset = array_combine(
+ range($start, count($arguments) - $start),
+ array_slice($arguments, $start)
+ );
+ if (self::testFalse($arrayArgumentsSubset)) {
+ return ['#VALUE!'];
+ }
+
+ self::initialiseHelper($arrayArgumentsSubset);
+ $leadingArguments = array_slice($arguments, 0, $start);
+ $arguments = self::$arrayArgumentHelper->arguments();
+ $arguments = array_merge($leadingArguments, $arguments);
+
+ return ArrayArgumentProcessor::processArguments(self::$arrayArgumentHelper, $method, ...$arguments);
+ }
+
+ /**
+ * Handles array argument processing when the function accepts multiple arguments,
+ * and any of them can be an array argument except for the one specified by ignore.
+ * Example use for:
+ * HLOOKUP() and VLOOKUP(), where argument 1 is a matrix that needs to be treated as a database
+ * rather than as an array argument.
+ */
+ protected static function evaluateArrayArgumentsIgnore(callable $method, int $ignore, mixed ...$arguments): array
+ {
+ $leadingArguments = array_slice($arguments, 0, $ignore);
+ $ignoreArgument = array_slice($arguments, $ignore, 1);
+ $trailingArguments = array_slice($arguments, $ignore + 1);
+
+ self::initialiseHelper(array_merge($leadingArguments, [[null]], $trailingArguments));
+ $arguments = self::$arrayArgumentHelper->arguments();
+
+ array_splice($arguments, $ignore, 1, $ignoreArgument);
+
+ return ArrayArgumentProcessor::processArguments(self::$arrayArgumentHelper, $method, ...$arguments);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/BinaryComparison.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/BinaryComparison.php
new file mode 100644
index 00000000..e4bc156a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/BinaryComparison.php
@@ -0,0 +1,136 @@
+ '' && $operand1[0] == Calculation::FORMULA_STRING_QUOTE) {
+ $operand1 = Calculation::unwrapResult($operand1);
+ }
+ if (is_string($operand2) && $operand2 > '' && $operand2[0] == Calculation::FORMULA_STRING_QUOTE) {
+ $operand2 = Calculation::unwrapResult($operand2);
+ }
+
+ // Use case insensitive comparaison if not OpenOffice mode
+ if (Functions::getCompatibilityMode() != Functions::COMPATIBILITY_OPENOFFICE) {
+ if (is_string($operand1)) {
+ $operand1 = StringHelper::strToUpper($operand1);
+ }
+ if (is_string($operand2)) {
+ $operand2 = StringHelper::strToUpper($operand2);
+ }
+ }
+
+ $useLowercaseFirstComparison = is_string($operand1)
+ && is_string($operand2)
+ && Functions::getCompatibilityMode() === Functions::COMPATIBILITY_OPENOFFICE;
+
+ return self::evaluateComparison($operand1, $operand2, $operator, $useLowercaseFirstComparison);
+ }
+
+ private static function evaluateComparison(mixed $operand1, mixed $operand2, string $operator, bool $useLowercaseFirstComparison): bool
+ {
+ return match ($operator) {
+ '=' => self::equal($operand1, $operand2),
+ '>' => self::greaterThan($operand1, $operand2, $useLowercaseFirstComparison),
+ '<' => self::lessThan($operand1, $operand2, $useLowercaseFirstComparison),
+ '>=' => self::greaterThanOrEqual($operand1, $operand2, $useLowercaseFirstComparison),
+ '<=' => self::lessThanOrEqual($operand1, $operand2, $useLowercaseFirstComparison),
+ '<>' => self::notEqual($operand1, $operand2),
+ default => throw new Exception('Unsupported binary comparison operator'),
+ };
+ }
+
+ private static function equal(mixed $operand1, mixed $operand2): bool
+ {
+ if (is_numeric($operand1) && is_numeric($operand2)) {
+ $result = (abs($operand1 - $operand2) < self::DELTA);
+ } elseif (($operand1 === null && is_numeric($operand2)) || ($operand2 === null && is_numeric($operand1))) {
+ $result = $operand1 == $operand2;
+ } else {
+ $result = self::strcmpAllowNull($operand1, $operand2) == 0;
+ }
+
+ return $result;
+ }
+
+ private static function greaterThanOrEqual(mixed $operand1, mixed $operand2, bool $useLowercaseFirstComparison): bool
+ {
+ if (is_numeric($operand1) && is_numeric($operand2)) {
+ $result = ((abs($operand1 - $operand2) < self::DELTA) || ($operand1 > $operand2));
+ } elseif (($operand1 === null && is_numeric($operand2)) || ($operand2 === null && is_numeric($operand1))) {
+ $result = $operand1 >= $operand2;
+ } elseif ($useLowercaseFirstComparison) {
+ $result = self::strcmpLowercaseFirst($operand1, $operand2) >= 0;
+ } else {
+ $result = self::strcmpAllowNull($operand1, $operand2) >= 0;
+ }
+
+ return $result;
+ }
+
+ private static function lessThanOrEqual(mixed $operand1, mixed $operand2, bool $useLowercaseFirstComparison): bool
+ {
+ if (is_numeric($operand1) && is_numeric($operand2)) {
+ $result = ((abs($operand1 - $operand2) < self::DELTA) || ($operand1 < $operand2));
+ } elseif (($operand1 === null && is_numeric($operand2)) || ($operand2 === null && is_numeric($operand1))) {
+ $result = $operand1 <= $operand2;
+ } elseif ($useLowercaseFirstComparison) {
+ $result = self::strcmpLowercaseFirst($operand1, $operand2) <= 0;
+ } else {
+ $result = self::strcmpAllowNull($operand1, $operand2) <= 0;
+ }
+
+ return $result;
+ }
+
+ private static function greaterThan(mixed $operand1, mixed $operand2, bool $useLowercaseFirstComparison): bool
+ {
+ return self::lessThanOrEqual($operand1, $operand2, $useLowercaseFirstComparison) !== true;
+ }
+
+ private static function lessThan(mixed $operand1, mixed $operand2, bool $useLowercaseFirstComparison): bool
+ {
+ return self::greaterThanOrEqual($operand1, $operand2, $useLowercaseFirstComparison) !== true;
+ }
+
+ private static function notEqual(mixed $operand1, mixed $operand2): bool
+ {
+ return self::equal($operand1, $operand2) !== true;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Calculation.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Calculation.php
new file mode 100644
index 00000000..8d622d4e
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Calculation.php
@@ -0,0 +1,5673 @@
+=:`-]*)|(\'(?:[^\']|\'[^!])+?\')|(\"(?:[^\"]|\"[^!])+?\"))!)?\$?\b([a-z]{1,3})\$?(\d{1,7})(?![\w.])';
+ // Cell reference (with or without a sheet reference) ensuring absolute/relative
+ const CALCULATION_REGEXP_CELLREF_RELATIVE = '((([^\s\(,!&%^\/\*\+<>=:`-]*)|(\'(?:[^\']|\'[^!])+?\')|(\"(?:[^\"]|\"[^!])+?\"))!)?(\$?\b[a-z]{1,3})(\$?\d{1,7})(?![\w.])';
+ const CALCULATION_REGEXP_COLUMN_RANGE = '(((([^\s\(,!&%^\/\*\+<>=:`-]*)|(\'(?:[^\']|\'[^!])+?\')|(\".(?:[^\"]|\"[^!])?\"))!)?(\$?[a-z]{1,3})):(?![.*])';
+ const CALCULATION_REGEXP_ROW_RANGE = '(((([^\s\(,!&%^\/\*\+<>=:`-]*)|(\'(?:[^\']|\'[^!])+?\')|(\"(?:[^\"]|\"[^!])+?\"))!)?(\$?[1-9][0-9]{0,6})):(?![.*])';
+ // Cell reference (with or without a sheet reference) ensuring absolute/relative
+ // Cell ranges ensuring absolute/relative
+ const CALCULATION_REGEXP_COLUMNRANGE_RELATIVE = '(\$?[a-z]{1,3}):(\$?[a-z]{1,3})';
+ const CALCULATION_REGEXP_ROWRANGE_RELATIVE = '(\$?\d{1,7}):(\$?\d{1,7})';
+ // Defined Names: Named Range of cells, or Named Formulae
+ const CALCULATION_REGEXP_DEFINEDNAME = '((([^\s,!&%^\/\*\+<>=-]*)|(\'(?:[^\']|\'[^!])+?\')|(\"(?:[^\"]|\"[^!])+?\"))!)?([_\p{L}][_\p{L}\p{N}\.]*)';
+ // Structured Reference (Fully Qualified and Unqualified)
+ const CALCULATION_REGEXP_STRUCTURED_REFERENCE = '([\p{L}_\\\\][\p{L}\p{N}\._]+)?(\[(?:[^\d\]+-])?)';
+ // Error
+ const CALCULATION_REGEXP_ERROR = '\#[A-Z][A-Z0_\/]*[!\?]?';
+
+ /** constants */
+ const RETURN_ARRAY_AS_ERROR = 'error';
+ const RETURN_ARRAY_AS_VALUE = 'value';
+ const RETURN_ARRAY_AS_ARRAY = 'array';
+
+ const FORMULA_OPEN_FUNCTION_BRACE = '(';
+ const FORMULA_CLOSE_FUNCTION_BRACE = ')';
+ const FORMULA_OPEN_MATRIX_BRACE = '{';
+ const FORMULA_CLOSE_MATRIX_BRACE = '}';
+ const FORMULA_STRING_QUOTE = '"';
+
+ private static string $returnArrayAsType = self::RETURN_ARRAY_AS_VALUE;
+
+ /**
+ * Instance of this class.
+ */
+ private static ?Calculation $instance = null;
+
+ /**
+ * Instance of the spreadsheet this Calculation Engine is using.
+ */
+ private ?Spreadsheet $spreadsheet;
+
+ /**
+ * Calculation cache.
+ */
+ private array $calculationCache = [];
+
+ /**
+ * Calculation cache enabled.
+ */
+ private bool $calculationCacheEnabled = true;
+
+ private BranchPruner $branchPruner;
+
+ private bool $branchPruningEnabled = true;
+
+ /**
+ * List of operators that can be used within formulae
+ * The true/false value indicates whether it is a binary operator or a unary operator.
+ */
+ private const CALCULATION_OPERATORS = [
+ '+' => true, '-' => true, '*' => true, '/' => true,
+ '^' => true, '&' => true, '%' => false, '~' => false,
+ '>' => true, '<' => true, '=' => true, '>=' => true,
+ '<=' => true, '<>' => true, '∩' => true, '∪' => true,
+ ':' => true,
+ ];
+
+ /**
+ * List of binary operators (those that expect two operands).
+ */
+ private const BINARY_OPERATORS = [
+ '+' => true, '-' => true, '*' => true, '/' => true,
+ '^' => true, '&' => true, '>' => true, '<' => true,
+ '=' => true, '>=' => true, '<=' => true, '<>' => true,
+ '∩' => true, '∪' => true, ':' => true,
+ ];
+
+ /**
+ * The debug log generated by the calculation engine.
+ */
+ private Logger $debugLog;
+
+ private bool $suppressFormulaErrors = false;
+
+ /**
+ * Error message for any error that was raised/thrown by the calculation engine.
+ */
+ public ?string $formulaError = null;
+
+ /**
+ * Reference Helper.
+ */
+ private static ReferenceHelper $referenceHelper;
+
+ /**
+ * An array of the nested cell references accessed by the calculation engine, used for the debug log.
+ */
+ private CyclicReferenceStack $cyclicReferenceStack;
+
+ private array $cellStack = [];
+
+ /**
+ * Current iteration counter for cyclic formulae
+ * If the value is 0 (or less) then cyclic formulae will throw an exception,
+ * otherwise they will iterate to the limit defined here before returning a result.
+ */
+ private int $cyclicFormulaCounter = 1;
+
+ private string $cyclicFormulaCell = '';
+
+ /**
+ * Number of iterations for cyclic formulae.
+ */
+ public int $cyclicFormulaCount = 1;
+
+ /**
+ * The current locale setting.
+ */
+ private static string $localeLanguage = 'en_us'; // US English (default locale)
+
+ /**
+ * List of available locale settings
+ * Note that this is read for the locale subdirectory only when requested.
+ *
+ * @var string[]
+ */
+ private static array $validLocaleLanguages = [
+ 'en', // English (default language)
+ ];
+
+ /**
+ * Locale-specific argument separator for function arguments.
+ */
+ private static string $localeArgumentSeparator = ',';
+
+ private static array $localeFunctions = [];
+
+ /**
+ * Locale-specific translations for Excel constants (True, False and Null).
+ *
+ * @var array
+ */
+ private static array $localeBoolean = [
+ 'TRUE' => 'TRUE',
+ 'FALSE' => 'FALSE',
+ 'NULL' => 'NULL',
+ ];
+
+ public static function getLocaleBoolean(string $index): string
+ {
+ return self::$localeBoolean[$index];
+ }
+
+ /**
+ * Excel constant string translations to their PHP equivalents
+ * Constant conversion from text name/value to actual (datatyped) value.
+ *
+ * @var array
+ */
+ private static array $excelConstants = [
+ 'TRUE' => true,
+ 'FALSE' => false,
+ 'NULL' => null,
+ ];
+
+ public static function keyInExcelConstants(string $key): bool
+ {
+ return array_key_exists($key, self::$excelConstants);
+ }
+
+ public static function getExcelConstants(string $key): bool|null
+ {
+ return self::$excelConstants[$key];
+ }
+
+ /**
+ * Array of functions usable on Spreadsheet.
+ * In theory, this could be const rather than static;
+ * however, Phpstan breaks trying to analyze it when attempted.
+ */
+ private static array $phpSpreadsheetFunctions = [
+ 'ABS' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Absolute::class, 'evaluate'],
+ 'argumentCount' => '1',
+ ],
+ 'ACCRINT' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Securities\AccruedInterest::class, 'periodic'],
+ 'argumentCount' => '4-8',
+ ],
+ 'ACCRINTM' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Securities\AccruedInterest::class, 'atMaturity'],
+ 'argumentCount' => '3-5',
+ ],
+ 'ACOS' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Cosine::class, 'acos'],
+ 'argumentCount' => '1',
+ ],
+ 'ACOSH' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Cosine::class, 'acosh'],
+ 'argumentCount' => '1',
+ ],
+ 'ACOT' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Cotangent::class, 'acot'],
+ 'argumentCount' => '1',
+ ],
+ 'ACOTH' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Cotangent::class, 'acoth'],
+ 'argumentCount' => '1',
+ ],
+ 'ADDRESS' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Address::class, 'cell'],
+ 'argumentCount' => '2-5',
+ ],
+ 'AGGREGATE' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3+',
+ ],
+ 'AMORDEGRC' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Amortization::class, 'AMORDEGRC'],
+ 'argumentCount' => '6,7',
+ ],
+ 'AMORLINC' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Amortization::class, 'AMORLINC'],
+ 'argumentCount' => '6,7',
+ ],
+ 'ANCHORARRAY' => [
+ 'category' => Category::CATEGORY_UNCATEGORISED,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '*',
+ ],
+ 'AND' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Logical\Operations::class, 'logicalAnd'],
+ 'argumentCount' => '1+',
+ ],
+ 'ARABIC' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Arabic::class, 'evaluate'],
+ 'argumentCount' => '1',
+ ],
+ 'AREAS' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1',
+ ],
+ 'ARRAYTOTEXT' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Text::class, 'fromArray'],
+ 'argumentCount' => '1,2',
+ ],
+ 'ASC' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1',
+ ],
+ 'ASIN' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Sine::class, 'asin'],
+ 'argumentCount' => '1',
+ ],
+ 'ASINH' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Sine::class, 'asinh'],
+ 'argumentCount' => '1',
+ ],
+ 'ATAN' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Tangent::class, 'atan'],
+ 'argumentCount' => '1',
+ ],
+ 'ATAN2' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Tangent::class, 'atan2'],
+ 'argumentCount' => '2',
+ ],
+ 'ATANH' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Tangent::class, 'atanh'],
+ 'argumentCount' => '1',
+ ],
+ 'AVEDEV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Averages::class, 'averageDeviations'],
+ 'argumentCount' => '1+',
+ ],
+ 'AVERAGE' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Averages::class, 'average'],
+ 'argumentCount' => '1+',
+ ],
+ 'AVERAGEA' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Averages::class, 'averageA'],
+ 'argumentCount' => '1+',
+ ],
+ 'AVERAGEIF' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Conditional::class, 'AVERAGEIF'],
+ 'argumentCount' => '2,3',
+ ],
+ 'AVERAGEIFS' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Conditional::class, 'AVERAGEIFS'],
+ 'argumentCount' => '3+',
+ ],
+ 'BAHTTEXT' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1',
+ ],
+ 'BASE' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Base::class, 'evaluate'],
+ 'argumentCount' => '2,3',
+ ],
+ 'BESSELI' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\BesselI::class, 'BESSELI'],
+ 'argumentCount' => '2',
+ ],
+ 'BESSELJ' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\BesselJ::class, 'BESSELJ'],
+ 'argumentCount' => '2',
+ ],
+ 'BESSELK' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\BesselK::class, 'BESSELK'],
+ 'argumentCount' => '2',
+ ],
+ 'BESSELY' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\BesselY::class, 'BESSELY'],
+ 'argumentCount' => '2',
+ ],
+ 'BETADIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Beta::class, 'distribution'],
+ 'argumentCount' => '3-5',
+ ],
+ 'BETA.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '4-6',
+ ],
+ 'BETAINV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Beta::class, 'inverse'],
+ 'argumentCount' => '3-5',
+ ],
+ 'BETA.INV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Beta::class, 'inverse'],
+ 'argumentCount' => '3-5',
+ ],
+ 'BIN2DEC' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertBinary::class, 'toDecimal'],
+ 'argumentCount' => '1',
+ ],
+ 'BIN2HEX' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertBinary::class, 'toHex'],
+ 'argumentCount' => '1,2',
+ ],
+ 'BIN2OCT' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertBinary::class, 'toOctal'],
+ 'argumentCount' => '1,2',
+ ],
+ 'BINOMDIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Binomial::class, 'distribution'],
+ 'argumentCount' => '4',
+ ],
+ 'BINOM.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Binomial::class, 'distribution'],
+ 'argumentCount' => '4',
+ ],
+ 'BINOM.DIST.RANGE' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Binomial::class, 'range'],
+ 'argumentCount' => '3,4',
+ ],
+ 'BINOM.INV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Binomial::class, 'inverse'],
+ 'argumentCount' => '3',
+ ],
+ 'BITAND' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\BitWise::class, 'BITAND'],
+ 'argumentCount' => '2',
+ ],
+ 'BITOR' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\BitWise::class, 'BITOR'],
+ 'argumentCount' => '2',
+ ],
+ 'BITXOR' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\BitWise::class, 'BITXOR'],
+ 'argumentCount' => '2',
+ ],
+ 'BITLSHIFT' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\BitWise::class, 'BITLSHIFT'],
+ 'argumentCount' => '2',
+ ],
+ 'BITRSHIFT' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\BitWise::class, 'BITRSHIFT'],
+ 'argumentCount' => '2',
+ ],
+ 'BYCOL' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '*',
+ ],
+ 'BYROW' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '*',
+ ],
+ 'CEILING' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Ceiling::class, 'ceiling'],
+ 'argumentCount' => '1-2', // 2 for Excel, 1-2 for Ods/Gnumeric
+ ],
+ 'CEILING.MATH' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Ceiling::class, 'math'],
+ 'argumentCount' => '1-3',
+ ],
+ 'CEILING.PRECISE' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Ceiling::class, 'precise'],
+ 'argumentCount' => '1,2',
+ ],
+ 'CELL' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1,2',
+ ],
+ 'CHAR' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\CharacterConvert::class, 'character'],
+ 'argumentCount' => '1',
+ ],
+ 'CHIDIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\ChiSquared::class, 'distributionRightTail'],
+ 'argumentCount' => '2',
+ ],
+ 'CHISQ.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\ChiSquared::class, 'distributionLeftTail'],
+ 'argumentCount' => '3',
+ ],
+ 'CHISQ.DIST.RT' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\ChiSquared::class, 'distributionRightTail'],
+ 'argumentCount' => '2',
+ ],
+ 'CHIINV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\ChiSquared::class, 'inverseRightTail'],
+ 'argumentCount' => '2',
+ ],
+ 'CHISQ.INV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\ChiSquared::class, 'inverseLeftTail'],
+ 'argumentCount' => '2',
+ ],
+ 'CHISQ.INV.RT' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\ChiSquared::class, 'inverseRightTail'],
+ 'argumentCount' => '2',
+ ],
+ 'CHITEST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\ChiSquared::class, 'test'],
+ 'argumentCount' => '2',
+ ],
+ 'CHISQ.TEST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\ChiSquared::class, 'test'],
+ 'argumentCount' => '2',
+ ],
+ 'CHOOSE' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Selection::class, 'CHOOSE'],
+ 'argumentCount' => '2+',
+ ],
+ 'CHOOSECOLS' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2+',
+ ],
+ 'CHOOSEROWS' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2+',
+ ],
+ 'CLEAN' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Trim::class, 'nonPrintable'],
+ 'argumentCount' => '1',
+ ],
+ 'CODE' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\CharacterConvert::class, 'code'],
+ 'argumentCount' => '1',
+ ],
+ 'COLUMN' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\RowColumnInformation::class, 'COLUMN'],
+ 'argumentCount' => '-1',
+ 'passCellReference' => true,
+ 'passByReference' => [true],
+ ],
+ 'COLUMNS' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\RowColumnInformation::class, 'COLUMNS'],
+ 'argumentCount' => '1',
+ ],
+ 'COMBIN' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Combinations::class, 'withoutRepetition'],
+ 'argumentCount' => '2',
+ ],
+ 'COMBINA' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Combinations::class, 'withRepetition'],
+ 'argumentCount' => '2',
+ ],
+ 'COMPLEX' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\Complex::class, 'COMPLEX'],
+ 'argumentCount' => '2,3',
+ ],
+ 'CONCAT' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Concatenate::class, 'CONCATENATE'],
+ 'argumentCount' => '1+',
+ ],
+ 'CONCATENATE' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Concatenate::class, 'CONCATENATE'],
+ 'argumentCount' => '1+',
+ ],
+ 'CONFIDENCE' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Confidence::class, 'CONFIDENCE'],
+ 'argumentCount' => '3',
+ ],
+ 'CONFIDENCE.NORM' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Confidence::class, 'CONFIDENCE'],
+ 'argumentCount' => '3',
+ ],
+ 'CONFIDENCE.T' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3',
+ ],
+ 'CONVERT' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertUOM::class, 'CONVERT'],
+ 'argumentCount' => '3',
+ ],
+ 'CORREL' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'CORREL'],
+ 'argumentCount' => '2',
+ ],
+ 'COS' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Cosine::class, 'cos'],
+ 'argumentCount' => '1',
+ ],
+ 'COSH' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Cosine::class, 'cosh'],
+ 'argumentCount' => '1',
+ ],
+ 'COT' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Cotangent::class, 'cot'],
+ 'argumentCount' => '1',
+ ],
+ 'COTH' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Cotangent::class, 'coth'],
+ 'argumentCount' => '1',
+ ],
+ 'COUNT' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Counts::class, 'COUNT'],
+ 'argumentCount' => '1+',
+ ],
+ 'COUNTA' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Counts::class, 'COUNTA'],
+ 'argumentCount' => '1+',
+ ],
+ 'COUNTBLANK' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Counts::class, 'COUNTBLANK'],
+ 'argumentCount' => '1',
+ ],
+ 'COUNTIF' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Conditional::class, 'COUNTIF'],
+ 'argumentCount' => '2',
+ ],
+ 'COUNTIFS' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Conditional::class, 'COUNTIFS'],
+ 'argumentCount' => '2+',
+ ],
+ 'COUPDAYBS' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Coupons::class, 'COUPDAYBS'],
+ 'argumentCount' => '3,4',
+ ],
+ 'COUPDAYS' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Coupons::class, 'COUPDAYS'],
+ 'argumentCount' => '3,4',
+ ],
+ 'COUPDAYSNC' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Coupons::class, 'COUPDAYSNC'],
+ 'argumentCount' => '3,4',
+ ],
+ 'COUPNCD' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Coupons::class, 'COUPNCD'],
+ 'argumentCount' => '3,4',
+ ],
+ 'COUPNUM' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Coupons::class, 'COUPNUM'],
+ 'argumentCount' => '3,4',
+ ],
+ 'COUPPCD' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Coupons::class, 'COUPPCD'],
+ 'argumentCount' => '3,4',
+ ],
+ 'COVAR' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'COVAR'],
+ 'argumentCount' => '2',
+ ],
+ 'COVARIANCE.P' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'COVAR'],
+ 'argumentCount' => '2',
+ ],
+ 'COVARIANCE.S' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2',
+ ],
+ 'CRITBINOM' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Binomial::class, 'inverse'],
+ 'argumentCount' => '3',
+ ],
+ 'CSC' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Cosecant::class, 'csc'],
+ 'argumentCount' => '1',
+ ],
+ 'CSCH' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Cosecant::class, 'csch'],
+ 'argumentCount' => '1',
+ ],
+ 'CUBEKPIMEMBER' => [
+ 'category' => Category::CATEGORY_CUBE,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'CUBEMEMBER' => [
+ 'category' => Category::CATEGORY_CUBE,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'CUBEMEMBERPROPERTY' => [
+ 'category' => Category::CATEGORY_CUBE,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'CUBERANKEDMEMBER' => [
+ 'category' => Category::CATEGORY_CUBE,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'CUBESET' => [
+ 'category' => Category::CATEGORY_CUBE,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'CUBESETCOUNT' => [
+ 'category' => Category::CATEGORY_CUBE,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'CUBEVALUE' => [
+ 'category' => Category::CATEGORY_CUBE,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'CUMIPMT' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Constant\Periodic\Cumulative::class, 'interest'],
+ 'argumentCount' => '6',
+ ],
+ 'CUMPRINC' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Constant\Periodic\Cumulative::class, 'principal'],
+ 'argumentCount' => '6',
+ ],
+ 'DATE' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\Date::class, 'fromYMD'],
+ 'argumentCount' => '3',
+ ],
+ 'DATEDIF' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\Difference::class, 'interval'],
+ 'argumentCount' => '2,3',
+ ],
+ 'DATESTRING' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'DATEVALUE' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\DateValue::class, 'fromString'],
+ 'argumentCount' => '1',
+ ],
+ 'DAVERAGE' => [
+ 'category' => Category::CATEGORY_DATABASE,
+ 'functionCall' => [Database\DAverage::class, 'evaluate'],
+ 'argumentCount' => '3',
+ ],
+ 'DAY' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\DateParts::class, 'day'],
+ 'argumentCount' => '1',
+ ],
+ 'DAYS' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\Days::class, 'between'],
+ 'argumentCount' => '2',
+ ],
+ 'DAYS360' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\Days360::class, 'between'],
+ 'argumentCount' => '2,3',
+ ],
+ 'DB' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Depreciation::class, 'DB'],
+ 'argumentCount' => '4,5',
+ ],
+ 'DBCS' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1',
+ ],
+ 'DCOUNT' => [
+ 'category' => Category::CATEGORY_DATABASE,
+ 'functionCall' => [Database\DCount::class, 'evaluate'],
+ 'argumentCount' => '3',
+ ],
+ 'DCOUNTA' => [
+ 'category' => Category::CATEGORY_DATABASE,
+ 'functionCall' => [Database\DCountA::class, 'evaluate'],
+ 'argumentCount' => '3',
+ ],
+ 'DDB' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Depreciation::class, 'DDB'],
+ 'argumentCount' => '4,5',
+ ],
+ 'DEC2BIN' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertDecimal::class, 'toBinary'],
+ 'argumentCount' => '1,2',
+ ],
+ 'DEC2HEX' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertDecimal::class, 'toHex'],
+ 'argumentCount' => '1,2',
+ ],
+ 'DEC2OCT' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertDecimal::class, 'toOctal'],
+ 'argumentCount' => '1,2',
+ ],
+ 'DECIMAL' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2',
+ ],
+ 'DEGREES' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Angle::class, 'toDegrees'],
+ 'argumentCount' => '1',
+ ],
+ 'DELTA' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\Compare::class, 'DELTA'],
+ 'argumentCount' => '1,2',
+ ],
+ 'DEVSQ' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Deviations::class, 'sumSquares'],
+ 'argumentCount' => '1+',
+ ],
+ 'DGET' => [
+ 'category' => Category::CATEGORY_DATABASE,
+ 'functionCall' => [Database\DGet::class, 'evaluate'],
+ 'argumentCount' => '3',
+ ],
+ 'DISC' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Securities\Rates::class, 'discount'],
+ 'argumentCount' => '4,5',
+ ],
+ 'DMAX' => [
+ 'category' => Category::CATEGORY_DATABASE,
+ 'functionCall' => [Database\DMax::class, 'evaluate'],
+ 'argumentCount' => '3',
+ ],
+ 'DMIN' => [
+ 'category' => Category::CATEGORY_DATABASE,
+ 'functionCall' => [Database\DMin::class, 'evaluate'],
+ 'argumentCount' => '3',
+ ],
+ 'DOLLAR' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Format::class, 'DOLLAR'],
+ 'argumentCount' => '1,2',
+ ],
+ 'DOLLARDE' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Dollar::class, 'decimal'],
+ 'argumentCount' => '2',
+ ],
+ 'DOLLARFR' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Dollar::class, 'fractional'],
+ 'argumentCount' => '2',
+ ],
+ 'DPRODUCT' => [
+ 'category' => Category::CATEGORY_DATABASE,
+ 'functionCall' => [Database\DProduct::class, 'evaluate'],
+ 'argumentCount' => '3',
+ ],
+ 'DROP' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2-3',
+ ],
+ 'DSTDEV' => [
+ 'category' => Category::CATEGORY_DATABASE,
+ 'functionCall' => [Database\DStDev::class, 'evaluate'],
+ 'argumentCount' => '3',
+ ],
+ 'DSTDEVP' => [
+ 'category' => Category::CATEGORY_DATABASE,
+ 'functionCall' => [Database\DStDevP::class, 'evaluate'],
+ 'argumentCount' => '3',
+ ],
+ 'DSUM' => [
+ 'category' => Category::CATEGORY_DATABASE,
+ 'functionCall' => [Database\DSum::class, 'evaluate'],
+ 'argumentCount' => '3',
+ ],
+ 'DURATION' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '5,6',
+ ],
+ 'DVAR' => [
+ 'category' => Category::CATEGORY_DATABASE,
+ 'functionCall' => [Database\DVar::class, 'evaluate'],
+ 'argumentCount' => '3',
+ ],
+ 'DVARP' => [
+ 'category' => Category::CATEGORY_DATABASE,
+ 'functionCall' => [Database\DVarP::class, 'evaluate'],
+ 'argumentCount' => '3',
+ ],
+ 'ECMA.CEILING' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1,2',
+ ],
+ 'EDATE' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\Month::class, 'adjust'],
+ 'argumentCount' => '2',
+ ],
+ 'EFFECT' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\InterestRate::class, 'effective'],
+ 'argumentCount' => '2',
+ ],
+ 'ENCODEURL' => [
+ 'category' => Category::CATEGORY_WEB,
+ 'functionCall' => [Web\Service::class, 'urlEncode'],
+ 'argumentCount' => '1',
+ ],
+ 'EOMONTH' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\Month::class, 'lastDay'],
+ 'argumentCount' => '2',
+ ],
+ 'ERF' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\Erf::class, 'ERF'],
+ 'argumentCount' => '1,2',
+ ],
+ 'ERF.PRECISE' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\Erf::class, 'ERFPRECISE'],
+ 'argumentCount' => '1',
+ ],
+ 'ERFC' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ErfC::class, 'ERFC'],
+ 'argumentCount' => '1',
+ ],
+ 'ERFC.PRECISE' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ErfC::class, 'ERFC'],
+ 'argumentCount' => '1',
+ ],
+ 'ERROR.TYPE' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [ExcelError::class, 'type'],
+ 'argumentCount' => '1',
+ ],
+ 'EVEN' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Round::class, 'even'],
+ 'argumentCount' => '1',
+ ],
+ 'EXACT' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Text::class, 'exact'],
+ 'argumentCount' => '2',
+ ],
+ 'EXP' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Exp::class, 'evaluate'],
+ 'argumentCount' => '1',
+ ],
+ 'EXPAND' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2-4',
+ ],
+ 'EXPONDIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Exponential::class, 'distribution'],
+ 'argumentCount' => '3',
+ ],
+ 'EXPON.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Exponential::class, 'distribution'],
+ 'argumentCount' => '3',
+ ],
+ 'FACT' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Factorial::class, 'fact'],
+ 'argumentCount' => '1',
+ ],
+ 'FACTDOUBLE' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Factorial::class, 'factDouble'],
+ 'argumentCount' => '1',
+ ],
+ 'FALSE' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Logical\Boolean::class, 'FALSE'],
+ 'argumentCount' => '0',
+ ],
+ 'FDIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3',
+ ],
+ 'F.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\F::class, 'distribution'],
+ 'argumentCount' => '4',
+ ],
+ 'F.DIST.RT' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3',
+ ],
+ 'FILTER' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Filter::class, 'filter'],
+ 'argumentCount' => '2-3',
+ ],
+ 'FILTERXML' => [
+ 'category' => Category::CATEGORY_WEB,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2',
+ ],
+ 'FIND' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Search::class, 'sensitive'],
+ 'argumentCount' => '2,3',
+ ],
+ 'FINDB' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Search::class, 'sensitive'],
+ 'argumentCount' => '2,3',
+ ],
+ 'FINV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3',
+ ],
+ 'F.INV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3',
+ ],
+ 'F.INV.RT' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3',
+ ],
+ 'FISHER' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Fisher::class, 'distribution'],
+ 'argumentCount' => '1',
+ ],
+ 'FISHERINV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Fisher::class, 'inverse'],
+ 'argumentCount' => '1',
+ ],
+ 'FIXED' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Format::class, 'FIXEDFORMAT'],
+ 'argumentCount' => '1-3',
+ ],
+ 'FLOOR' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Floor::class, 'floor'],
+ 'argumentCount' => '1-2', // Excel requries 2, Ods/Gnumeric 1-2
+ ],
+ 'FLOOR.MATH' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Floor::class, 'math'],
+ 'argumentCount' => '1-3',
+ ],
+ 'FLOOR.PRECISE' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Floor::class, 'precise'],
+ 'argumentCount' => '1-2',
+ ],
+ 'FORECAST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'FORECAST'],
+ 'argumentCount' => '3',
+ ],
+ 'FORECAST.ETS' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3-6',
+ ],
+ 'FORECAST.ETS.CONFINT' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3-6',
+ ],
+ 'FORECAST.ETS.SEASONALITY' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2-4',
+ ],
+ 'FORECAST.ETS.STAT' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3-6',
+ ],
+ 'FORECAST.LINEAR' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'FORECAST'],
+ 'argumentCount' => '3',
+ ],
+ 'FORMULATEXT' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Formula::class, 'text'],
+ 'argumentCount' => '1',
+ 'passCellReference' => true,
+ 'passByReference' => [true],
+ ],
+ 'FREQUENCY' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2',
+ ],
+ 'FTEST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2',
+ ],
+ 'F.TEST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2',
+ ],
+ 'FV' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Constant\Periodic::class, 'futureValue'],
+ 'argumentCount' => '3-5',
+ ],
+ 'FVSCHEDULE' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Single::class, 'futureValue'],
+ 'argumentCount' => '2',
+ ],
+ 'GAMMA' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Gamma::class, 'gamma'],
+ 'argumentCount' => '1',
+ ],
+ 'GAMMADIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Gamma::class, 'distribution'],
+ 'argumentCount' => '4',
+ ],
+ 'GAMMA.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Gamma::class, 'distribution'],
+ 'argumentCount' => '4',
+ ],
+ 'GAMMAINV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Gamma::class, 'inverse'],
+ 'argumentCount' => '3',
+ ],
+ 'GAMMA.INV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Gamma::class, 'inverse'],
+ 'argumentCount' => '3',
+ ],
+ 'GAMMALN' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Gamma::class, 'ln'],
+ 'argumentCount' => '1',
+ ],
+ 'GAMMALN.PRECISE' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Gamma::class, 'ln'],
+ 'argumentCount' => '1',
+ ],
+ 'GAUSS' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\StandardNormal::class, 'gauss'],
+ 'argumentCount' => '1',
+ ],
+ 'GCD' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Gcd::class, 'evaluate'],
+ 'argumentCount' => '1+',
+ ],
+ 'GEOMEAN' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Averages\Mean::class, 'geometric'],
+ 'argumentCount' => '1+',
+ ],
+ 'GESTEP' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\Compare::class, 'GESTEP'],
+ 'argumentCount' => '1,2',
+ ],
+ 'GETPIVOTDATA' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2+',
+ ],
+ 'GROWTH' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'GROWTH'],
+ 'argumentCount' => '1-4',
+ ],
+ 'HARMEAN' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Averages\Mean::class, 'harmonic'],
+ 'argumentCount' => '1+',
+ ],
+ 'HEX2BIN' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertHex::class, 'toBinary'],
+ 'argumentCount' => '1,2',
+ ],
+ 'HEX2DEC' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertHex::class, 'toDecimal'],
+ 'argumentCount' => '1',
+ ],
+ 'HEX2OCT' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertHex::class, 'toOctal'],
+ 'argumentCount' => '1,2',
+ ],
+ 'HLOOKUP' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\HLookup::class, 'lookup'],
+ 'argumentCount' => '3,4',
+ ],
+ 'HOUR' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\TimeParts::class, 'hour'],
+ 'argumentCount' => '1',
+ ],
+ 'HSTACK' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1+',
+ ],
+ 'HYPERLINK' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Hyperlink::class, 'set'],
+ 'argumentCount' => '1,2',
+ 'passCellReference' => true,
+ ],
+ 'HYPGEOMDIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\HyperGeometric::class, 'distribution'],
+ 'argumentCount' => '4',
+ ],
+ 'HYPGEOM.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '5',
+ ],
+ 'IF' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Logical\Conditional::class, 'statementIf'],
+ 'argumentCount' => '2-3',
+ ],
+ 'IFERROR' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Logical\Conditional::class, 'IFERROR'],
+ 'argumentCount' => '2',
+ ],
+ 'IFNA' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Logical\Conditional::class, 'IFNA'],
+ 'argumentCount' => '2',
+ ],
+ 'IFS' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Logical\Conditional::class, 'IFS'],
+ 'argumentCount' => '2+',
+ ],
+ 'IMABS' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMABS'],
+ 'argumentCount' => '1',
+ ],
+ 'IMAGINARY' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\Complex::class, 'IMAGINARY'],
+ 'argumentCount' => '1',
+ ],
+ 'IMARGUMENT' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMARGUMENT'],
+ 'argumentCount' => '1',
+ ],
+ 'IMCONJUGATE' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMCONJUGATE'],
+ 'argumentCount' => '1',
+ ],
+ 'IMCOS' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMCOS'],
+ 'argumentCount' => '1',
+ ],
+ 'IMCOSH' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMCOSH'],
+ 'argumentCount' => '1',
+ ],
+ 'IMCOT' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMCOT'],
+ 'argumentCount' => '1',
+ ],
+ 'IMCSC' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMCSC'],
+ 'argumentCount' => '1',
+ ],
+ 'IMCSCH' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMCSCH'],
+ 'argumentCount' => '1',
+ ],
+ 'IMDIV' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexOperations::class, 'IMDIV'],
+ 'argumentCount' => '2',
+ ],
+ 'IMEXP' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMEXP'],
+ 'argumentCount' => '1',
+ ],
+ 'IMLN' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMLN'],
+ 'argumentCount' => '1',
+ ],
+ 'IMLOG10' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMLOG10'],
+ 'argumentCount' => '1',
+ ],
+ 'IMLOG2' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMLOG2'],
+ 'argumentCount' => '1',
+ ],
+ 'IMPOWER' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMPOWER'],
+ 'argumentCount' => '2',
+ ],
+ 'IMPRODUCT' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexOperations::class, 'IMPRODUCT'],
+ 'argumentCount' => '1+',
+ ],
+ 'IMREAL' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\Complex::class, 'IMREAL'],
+ 'argumentCount' => '1',
+ ],
+ 'IMSEC' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMSEC'],
+ 'argumentCount' => '1',
+ ],
+ 'IMSECH' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMSECH'],
+ 'argumentCount' => '1',
+ ],
+ 'IMSIN' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMSIN'],
+ 'argumentCount' => '1',
+ ],
+ 'IMSINH' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMSINH'],
+ 'argumentCount' => '1',
+ ],
+ 'IMSQRT' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMSQRT'],
+ 'argumentCount' => '1',
+ ],
+ 'IMSUB' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexOperations::class, 'IMSUB'],
+ 'argumentCount' => '2',
+ ],
+ 'IMSUM' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexOperations::class, 'IMSUM'],
+ 'argumentCount' => '1+',
+ ],
+ 'IMTAN' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ComplexFunctions::class, 'IMTAN'],
+ 'argumentCount' => '1',
+ ],
+ 'INDEX' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Matrix::class, 'index'],
+ 'argumentCount' => '2-4',
+ ],
+ 'INDIRECT' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Indirect::class, 'INDIRECT'],
+ 'argumentCount' => '1,2',
+ 'passCellReference' => true,
+ ],
+ 'INFO' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1',
+ ],
+ 'INT' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\IntClass::class, 'evaluate'],
+ 'argumentCount' => '1',
+ ],
+ 'INTERCEPT' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'INTERCEPT'],
+ 'argumentCount' => '2',
+ ],
+ 'INTRATE' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Securities\Rates::class, 'interest'],
+ 'argumentCount' => '4,5',
+ ],
+ 'IPMT' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Constant\Periodic\Interest::class, 'payment'],
+ 'argumentCount' => '4-6',
+ ],
+ 'IRR' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Variable\Periodic::class, 'rate'],
+ 'argumentCount' => '1,2',
+ ],
+ 'ISBLANK' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\Value::class, 'isBlank'],
+ 'argumentCount' => '1',
+ ],
+ 'ISERR' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\ErrorValue::class, 'isErr'],
+ 'argumentCount' => '1',
+ ],
+ 'ISERROR' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\ErrorValue::class, 'isError'],
+ 'argumentCount' => '1',
+ ],
+ 'ISEVEN' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\Value::class, 'isEven'],
+ 'argumentCount' => '1',
+ ],
+ 'ISFORMULA' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\Value::class, 'isFormula'],
+ 'argumentCount' => '1',
+ 'passCellReference' => true,
+ 'passByReference' => [true],
+ ],
+ 'ISLOGICAL' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\Value::class, 'isLogical'],
+ 'argumentCount' => '1',
+ ],
+ 'ISNA' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\ErrorValue::class, 'isNa'],
+ 'argumentCount' => '1',
+ ],
+ 'ISNONTEXT' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\Value::class, 'isNonText'],
+ 'argumentCount' => '1',
+ ],
+ 'ISNUMBER' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\Value::class, 'isNumber'],
+ 'argumentCount' => '1',
+ ],
+ 'ISO.CEILING' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1,2',
+ ],
+ 'ISODD' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\Value::class, 'isOdd'],
+ 'argumentCount' => '1',
+ ],
+ 'ISOMITTED' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '*',
+ ],
+ 'ISOWEEKNUM' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\Week::class, 'isoWeekNumber'],
+ 'argumentCount' => '1',
+ ],
+ 'ISPMT' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Constant\Periodic\Interest::class, 'schedulePayment'],
+ 'argumentCount' => '4',
+ ],
+ 'ISREF' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\Value::class, 'isRef'],
+ 'argumentCount' => '1',
+ 'passCellReference' => true,
+ 'passByReference' => [true],
+ ],
+ 'ISTEXT' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\Value::class, 'isText'],
+ 'argumentCount' => '1',
+ ],
+ 'ISTHAIDIGIT' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'JIS' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1',
+ ],
+ 'KURT' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Deviations::class, 'kurtosis'],
+ 'argumentCount' => '1+',
+ ],
+ 'LAMBDA' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '*',
+ ],
+ 'LARGE' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Size::class, 'large'],
+ 'argumentCount' => '2',
+ ],
+ 'LCM' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Lcm::class, 'evaluate'],
+ 'argumentCount' => '1+',
+ ],
+ 'LEFT' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Extract::class, 'left'],
+ 'argumentCount' => '1,2',
+ ],
+ 'LEFTB' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Extract::class, 'left'],
+ 'argumentCount' => '1,2',
+ ],
+ 'LEN' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Text::class, 'length'],
+ 'argumentCount' => '1',
+ ],
+ 'LENB' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Text::class, 'length'],
+ 'argumentCount' => '1',
+ ],
+ 'LET' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '*',
+ ],
+ 'LINEST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'LINEST'],
+ 'argumentCount' => '1-4',
+ ],
+ 'LN' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Logarithms::class, 'natural'],
+ 'argumentCount' => '1',
+ ],
+ 'LOG' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Logarithms::class, 'withBase'],
+ 'argumentCount' => '1,2',
+ ],
+ 'LOG10' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Logarithms::class, 'base10'],
+ 'argumentCount' => '1',
+ ],
+ 'LOGEST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'LOGEST'],
+ 'argumentCount' => '1-4',
+ ],
+ 'LOGINV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\LogNormal::class, 'inverse'],
+ 'argumentCount' => '3',
+ ],
+ 'LOGNORMDIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\LogNormal::class, 'cumulative'],
+ 'argumentCount' => '3',
+ ],
+ 'LOGNORM.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\LogNormal::class, 'distribution'],
+ 'argumentCount' => '4',
+ ],
+ 'LOGNORM.INV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\LogNormal::class, 'inverse'],
+ 'argumentCount' => '3',
+ ],
+ 'LOOKUP' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Lookup::class, 'lookup'],
+ 'argumentCount' => '2,3',
+ ],
+ 'LOWER' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\CaseConvert::class, 'lower'],
+ 'argumentCount' => '1',
+ ],
+ 'MAKEARRAY' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '*',
+ ],
+ 'MAP' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '*',
+ ],
+ 'MATCH' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\ExcelMatch::class, 'MATCH'],
+ 'argumentCount' => '2,3',
+ ],
+ 'MAX' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Maximum::class, 'max'],
+ 'argumentCount' => '1+',
+ ],
+ 'MAXA' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Maximum::class, 'maxA'],
+ 'argumentCount' => '1+',
+ ],
+ 'MAXIFS' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Conditional::class, 'MAXIFS'],
+ 'argumentCount' => '3+',
+ ],
+ 'MDETERM' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\MatrixFunctions::class, 'determinant'],
+ 'argumentCount' => '1',
+ ],
+ 'MDURATION' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '5,6',
+ ],
+ 'MEDIAN' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Averages::class, 'median'],
+ 'argumentCount' => '1+',
+ ],
+ 'MEDIANIF' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2+',
+ ],
+ 'MID' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Extract::class, 'mid'],
+ 'argumentCount' => '3',
+ ],
+ 'MIDB' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Extract::class, 'mid'],
+ 'argumentCount' => '3',
+ ],
+ 'MIN' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Minimum::class, 'min'],
+ 'argumentCount' => '1+',
+ ],
+ 'MINA' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Minimum::class, 'minA'],
+ 'argumentCount' => '1+',
+ ],
+ 'MINIFS' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Conditional::class, 'MINIFS'],
+ 'argumentCount' => '3+',
+ ],
+ 'MINUTE' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\TimeParts::class, 'minute'],
+ 'argumentCount' => '1',
+ ],
+ 'MINVERSE' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\MatrixFunctions::class, 'inverse'],
+ 'argumentCount' => '1',
+ ],
+ 'MIRR' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Variable\Periodic::class, 'modifiedRate'],
+ 'argumentCount' => '3',
+ ],
+ 'MMULT' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\MatrixFunctions::class, 'multiply'],
+ 'argumentCount' => '2',
+ ],
+ 'MOD' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Operations::class, 'mod'],
+ 'argumentCount' => '2',
+ ],
+ 'MODE' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Averages::class, 'mode'],
+ 'argumentCount' => '1+',
+ ],
+ 'MODE.MULT' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1+',
+ ],
+ 'MODE.SNGL' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Averages::class, 'mode'],
+ 'argumentCount' => '1+',
+ ],
+ 'MONTH' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\DateParts::class, 'month'],
+ 'argumentCount' => '1',
+ ],
+ 'MROUND' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Round::class, 'multiple'],
+ 'argumentCount' => '2',
+ ],
+ 'MULTINOMIAL' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Factorial::class, 'multinomial'],
+ 'argumentCount' => '1+',
+ ],
+ 'MUNIT' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\MatrixFunctions::class, 'identity'],
+ 'argumentCount' => '1',
+ ],
+ 'N' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\Value::class, 'asNumber'],
+ 'argumentCount' => '1',
+ ],
+ 'NA' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [ExcelError::class, 'NA'],
+ 'argumentCount' => '0',
+ ],
+ 'NEGBINOMDIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Binomial::class, 'negative'],
+ 'argumentCount' => '3',
+ ],
+ 'NEGBINOM.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '4',
+ ],
+ 'NETWORKDAYS' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\NetworkDays::class, 'count'],
+ 'argumentCount' => '2-3',
+ ],
+ 'NETWORKDAYS.INTL' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2-4',
+ ],
+ 'NOMINAL' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\InterestRate::class, 'nominal'],
+ 'argumentCount' => '2',
+ ],
+ 'NORMDIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Normal::class, 'distribution'],
+ 'argumentCount' => '4',
+ ],
+ 'NORM.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Normal::class, 'distribution'],
+ 'argumentCount' => '4',
+ ],
+ 'NORMINV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Normal::class, 'inverse'],
+ 'argumentCount' => '3',
+ ],
+ 'NORM.INV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Normal::class, 'inverse'],
+ 'argumentCount' => '3',
+ ],
+ 'NORMSDIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\StandardNormal::class, 'cumulative'],
+ 'argumentCount' => '1',
+ ],
+ 'NORM.S.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\StandardNormal::class, 'distribution'],
+ 'argumentCount' => '1,2',
+ ],
+ 'NORMSINV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\StandardNormal::class, 'inverse'],
+ 'argumentCount' => '1',
+ ],
+ 'NORM.S.INV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\StandardNormal::class, 'inverse'],
+ 'argumentCount' => '1',
+ ],
+ 'NOT' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Logical\Operations::class, 'NOT'],
+ 'argumentCount' => '1',
+ ],
+ 'NOW' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\Current::class, 'now'],
+ 'argumentCount' => '0',
+ ],
+ 'NPER' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Constant\Periodic::class, 'periods'],
+ 'argumentCount' => '3-5',
+ ],
+ 'NPV' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Variable\Periodic::class, 'presentValue'],
+ 'argumentCount' => '2+',
+ ],
+ 'NUMBERSTRING' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'NUMBERVALUE' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Format::class, 'NUMBERVALUE'],
+ 'argumentCount' => '1+',
+ ],
+ 'OCT2BIN' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertOctal::class, 'toBinary'],
+ 'argumentCount' => '1,2',
+ ],
+ 'OCT2DEC' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertOctal::class, 'toDecimal'],
+ 'argumentCount' => '1',
+ ],
+ 'OCT2HEX' => [
+ 'category' => Category::CATEGORY_ENGINEERING,
+ 'functionCall' => [Engineering\ConvertOctal::class, 'toHex'],
+ 'argumentCount' => '1,2',
+ ],
+ 'ODD' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Round::class, 'odd'],
+ 'argumentCount' => '1',
+ ],
+ 'ODDFPRICE' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '8,9',
+ ],
+ 'ODDFYIELD' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '8,9',
+ ],
+ 'ODDLPRICE' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '7,8',
+ ],
+ 'ODDLYIELD' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '7,8',
+ ],
+ 'OFFSET' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Offset::class, 'OFFSET'],
+ 'argumentCount' => '3-5',
+ 'passCellReference' => true,
+ 'passByReference' => [true],
+ ],
+ 'OR' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Logical\Operations::class, 'logicalOr'],
+ 'argumentCount' => '1+',
+ ],
+ 'PDURATION' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Single::class, 'periods'],
+ 'argumentCount' => '3',
+ ],
+ 'PEARSON' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'CORREL'],
+ 'argumentCount' => '2',
+ ],
+ 'PERCENTILE' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Percentiles::class, 'PERCENTILE'],
+ 'argumentCount' => '2',
+ ],
+ 'PERCENTILE.EXC' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2',
+ ],
+ 'PERCENTILE.INC' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Percentiles::class, 'PERCENTILE'],
+ 'argumentCount' => '2',
+ ],
+ 'PERCENTRANK' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Percentiles::class, 'PERCENTRANK'],
+ 'argumentCount' => '2,3',
+ ],
+ 'PERCENTRANK.EXC' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2,3',
+ ],
+ 'PERCENTRANK.INC' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Percentiles::class, 'PERCENTRANK'],
+ 'argumentCount' => '2,3',
+ ],
+ 'PERMUT' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Permutations::class, 'PERMUT'],
+ 'argumentCount' => '2',
+ ],
+ 'PERMUTATIONA' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Permutations::class, 'PERMUTATIONA'],
+ 'argumentCount' => '2',
+ ],
+ 'PHONETIC' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1',
+ ],
+ 'PHI' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1',
+ ],
+ 'PI' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => 'pi',
+ 'argumentCount' => '0',
+ ],
+ 'PMT' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Constant\Periodic\Payments::class, 'annuity'],
+ 'argumentCount' => '3-5',
+ ],
+ 'POISSON' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Poisson::class, 'distribution'],
+ 'argumentCount' => '3',
+ ],
+ 'POISSON.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Poisson::class, 'distribution'],
+ 'argumentCount' => '3',
+ ],
+ 'POWER' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Operations::class, 'power'],
+ 'argumentCount' => '2',
+ ],
+ 'PPMT' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Constant\Periodic\Payments::class, 'interestPayment'],
+ 'argumentCount' => '4-6',
+ ],
+ 'PRICE' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Securities\Price::class, 'price'],
+ 'argumentCount' => '6,7',
+ ],
+ 'PRICEDISC' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Securities\Price::class, 'priceDiscounted'],
+ 'argumentCount' => '4,5',
+ ],
+ 'PRICEMAT' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Securities\Price::class, 'priceAtMaturity'],
+ 'argumentCount' => '5,6',
+ ],
+ 'PROB' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3,4',
+ ],
+ 'PRODUCT' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Operations::class, 'product'],
+ 'argumentCount' => '1+',
+ ],
+ 'PROPER' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\CaseConvert::class, 'proper'],
+ 'argumentCount' => '1',
+ ],
+ 'PV' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Constant\Periodic::class, 'presentValue'],
+ 'argumentCount' => '3-5',
+ ],
+ 'QUARTILE' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Percentiles::class, 'QUARTILE'],
+ 'argumentCount' => '2',
+ ],
+ 'QUARTILE.EXC' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2',
+ ],
+ 'QUARTILE.INC' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Percentiles::class, 'QUARTILE'],
+ 'argumentCount' => '2',
+ ],
+ 'QUOTIENT' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Operations::class, 'quotient'],
+ 'argumentCount' => '2',
+ ],
+ 'RADIANS' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Angle::class, 'toRadians'],
+ 'argumentCount' => '1',
+ ],
+ 'RAND' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Random::class, 'rand'],
+ 'argumentCount' => '0',
+ ],
+ 'RANDARRAY' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Random::class, 'randArray'],
+ 'argumentCount' => '0-5',
+ ],
+ 'RANDBETWEEN' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Random::class, 'randBetween'],
+ 'argumentCount' => '2',
+ ],
+ 'RANK' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Percentiles::class, 'RANK'],
+ 'argumentCount' => '2,3',
+ ],
+ 'RANK.AVG' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2,3',
+ ],
+ 'RANK.EQ' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Percentiles::class, 'RANK'],
+ 'argumentCount' => '2,3',
+ ],
+ 'RATE' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Constant\Periodic\Interest::class, 'rate'],
+ 'argumentCount' => '3-6',
+ ],
+ 'RECEIVED' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Securities\Price::class, 'received'],
+ 'argumentCount' => '4-5',
+ ],
+ 'REDUCE' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '*',
+ ],
+ 'REPLACE' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Replace::class, 'replace'],
+ 'argumentCount' => '4',
+ ],
+ 'REPLACEB' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Replace::class, 'replace'],
+ 'argumentCount' => '4',
+ ],
+ 'REPT' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Concatenate::class, 'builtinREPT'],
+ 'argumentCount' => '2',
+ ],
+ 'RIGHT' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Extract::class, 'right'],
+ 'argumentCount' => '1,2',
+ ],
+ 'RIGHTB' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Extract::class, 'right'],
+ 'argumentCount' => '1,2',
+ ],
+ 'ROMAN' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Roman::class, 'evaluate'],
+ 'argumentCount' => '1,2',
+ ],
+ 'ROUND' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Round::class, 'round'],
+ 'argumentCount' => '2',
+ ],
+ 'ROUNDBAHTDOWN' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'ROUNDBAHTUP' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'ROUNDDOWN' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Round::class, 'down'],
+ 'argumentCount' => '2',
+ ],
+ 'ROUNDUP' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Round::class, 'up'],
+ 'argumentCount' => '2',
+ ],
+ 'ROW' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\RowColumnInformation::class, 'ROW'],
+ 'argumentCount' => '-1',
+ 'passCellReference' => true,
+ 'passByReference' => [true],
+ ],
+ 'ROWS' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\RowColumnInformation::class, 'ROWS'],
+ 'argumentCount' => '1',
+ ],
+ 'RRI' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Single::class, 'interestRate'],
+ 'argumentCount' => '3',
+ ],
+ 'RSQ' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'RSQ'],
+ 'argumentCount' => '2',
+ ],
+ 'RTD' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1+',
+ ],
+ 'SEARCH' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Search::class, 'insensitive'],
+ 'argumentCount' => '2,3',
+ ],
+ 'SCAN' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '*',
+ ],
+ 'SEARCHB' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Search::class, 'insensitive'],
+ 'argumentCount' => '2,3',
+ ],
+ 'SEC' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Secant::class, 'sec'],
+ 'argumentCount' => '1',
+ ],
+ 'SECH' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Secant::class, 'sech'],
+ 'argumentCount' => '1',
+ ],
+ 'SECOND' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\TimeParts::class, 'second'],
+ 'argumentCount' => '1',
+ ],
+ 'SEQUENCE' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\MatrixFunctions::class, 'sequence'],
+ 'argumentCount' => '1-4',
+ ],
+ 'SERIESSUM' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\SeriesSum::class, 'evaluate'],
+ 'argumentCount' => '4',
+ ],
+ 'SHEET' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '0,1',
+ ],
+ 'SHEETS' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '0,1',
+ ],
+ 'SIGN' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Sign::class, 'evaluate'],
+ 'argumentCount' => '1',
+ ],
+ 'SIN' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Sine::class, 'sin'],
+ 'argumentCount' => '1',
+ ],
+ 'SINGLE' => [
+ 'category' => Category::CATEGORY_UNCATEGORISED,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '*',
+ ],
+ 'SINH' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Sine::class, 'sinh'],
+ 'argumentCount' => '1',
+ ],
+ 'SKEW' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Deviations::class, 'skew'],
+ 'argumentCount' => '1+',
+ ],
+ 'SKEW.P' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1+',
+ ],
+ 'SLN' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Depreciation::class, 'SLN'],
+ 'argumentCount' => '3',
+ ],
+ 'SLOPE' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'SLOPE'],
+ 'argumentCount' => '2',
+ ],
+ 'SMALL' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Size::class, 'small'],
+ 'argumentCount' => '2',
+ ],
+ 'SORT' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Sort::class, 'sort'],
+ 'argumentCount' => '1-4',
+ ],
+ 'SORTBY' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Sort::class, 'sortBy'],
+ 'argumentCount' => '2+',
+ ],
+ 'SQRT' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Sqrt::class, 'sqrt'],
+ 'argumentCount' => '1',
+ ],
+ 'SQRTPI' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Sqrt::class, 'pi'],
+ 'argumentCount' => '1',
+ ],
+ 'STANDARDIZE' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Standardize::class, 'execute'],
+ 'argumentCount' => '3',
+ ],
+ 'STDEV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\StandardDeviations::class, 'STDEV'],
+ 'argumentCount' => '1+',
+ ],
+ 'STDEV.S' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\StandardDeviations::class, 'STDEV'],
+ 'argumentCount' => '1+',
+ ],
+ 'STDEV.P' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\StandardDeviations::class, 'STDEVP'],
+ 'argumentCount' => '1+',
+ ],
+ 'STDEVA' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\StandardDeviations::class, 'STDEVA'],
+ 'argumentCount' => '1+',
+ ],
+ 'STDEVP' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\StandardDeviations::class, 'STDEVP'],
+ 'argumentCount' => '1+',
+ ],
+ 'STDEVPA' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\StandardDeviations::class, 'STDEVPA'],
+ 'argumentCount' => '1+',
+ ],
+ 'STEYX' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'STEYX'],
+ 'argumentCount' => '2',
+ ],
+ 'SUBSTITUTE' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Replace::class, 'substitute'],
+ 'argumentCount' => '3,4',
+ ],
+ 'SUBTOTAL' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Subtotal::class, 'evaluate'],
+ 'argumentCount' => '2+',
+ 'passCellReference' => true,
+ ],
+ 'SUM' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Sum::class, 'sumErroringStrings'],
+ 'argumentCount' => '1+',
+ ],
+ 'SUMIF' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Statistical\Conditional::class, 'SUMIF'],
+ 'argumentCount' => '2,3',
+ ],
+ 'SUMIFS' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Statistical\Conditional::class, 'SUMIFS'],
+ 'argumentCount' => '3+',
+ ],
+ 'SUMPRODUCT' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Sum::class, 'product'],
+ 'argumentCount' => '1+',
+ ],
+ 'SUMSQ' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\SumSquares::class, 'sumSquare'],
+ 'argumentCount' => '1+',
+ ],
+ 'SUMX2MY2' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\SumSquares::class, 'sumXSquaredMinusYSquared'],
+ 'argumentCount' => '2',
+ ],
+ 'SUMX2PY2' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\SumSquares::class, 'sumXSquaredPlusYSquared'],
+ 'argumentCount' => '2',
+ ],
+ 'SUMXMY2' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\SumSquares::class, 'sumXMinusYSquared'],
+ 'argumentCount' => '2',
+ ],
+ 'SWITCH' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Logical\Conditional::class, 'statementSwitch'],
+ 'argumentCount' => '3+',
+ ],
+ 'SYD' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Depreciation::class, 'SYD'],
+ 'argumentCount' => '4',
+ ],
+ 'T' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Text::class, 'test'],
+ 'argumentCount' => '1',
+ ],
+ 'TAKE' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2-3',
+ ],
+ 'TAN' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Tangent::class, 'tan'],
+ 'argumentCount' => '1',
+ ],
+ 'TANH' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trig\Tangent::class, 'tanh'],
+ 'argumentCount' => '1',
+ ],
+ 'TBILLEQ' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\TreasuryBill::class, 'bondEquivalentYield'],
+ 'argumentCount' => '3',
+ ],
+ 'TBILLPRICE' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\TreasuryBill::class, 'price'],
+ 'argumentCount' => '3',
+ ],
+ 'TBILLYIELD' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\TreasuryBill::class, 'yield'],
+ 'argumentCount' => '3',
+ ],
+ 'TDIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\StudentT::class, 'distribution'],
+ 'argumentCount' => '3',
+ ],
+ 'T.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3',
+ ],
+ 'T.DIST.2T' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2',
+ ],
+ 'T.DIST.RT' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2',
+ ],
+ 'TEXT' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Format::class, 'TEXTFORMAT'],
+ 'argumentCount' => '2',
+ ],
+ 'TEXTAFTER' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Extract::class, 'after'],
+ 'argumentCount' => '2-6',
+ ],
+ 'TEXTBEFORE' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Extract::class, 'before'],
+ 'argumentCount' => '2-6',
+ ],
+ 'TEXTJOIN' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Concatenate::class, 'TEXTJOIN'],
+ 'argumentCount' => '3+',
+ ],
+ 'TEXTSPLIT' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Text::class, 'split'],
+ 'argumentCount' => '2-6',
+ ],
+ 'THAIDAYOFWEEK' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'THAIDIGIT' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'THAIMONTHOFYEAR' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'THAINUMSOUND' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'THAINUMSTRING' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'THAISTRINGLENGTH' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'THAIYEAR' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '?',
+ ],
+ 'TIME' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\Time::class, 'fromHMS'],
+ 'argumentCount' => '3',
+ ],
+ 'TIMEVALUE' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\TimeValue::class, 'fromString'],
+ 'argumentCount' => '1',
+ ],
+ 'TINV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\StudentT::class, 'inverse'],
+ 'argumentCount' => '2',
+ ],
+ 'T.INV' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\StudentT::class, 'inverse'],
+ 'argumentCount' => '2',
+ ],
+ 'T.INV.2T' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2',
+ ],
+ 'TODAY' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\Current::class, 'today'],
+ 'argumentCount' => '0',
+ ],
+ 'TOCOL' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1-3',
+ ],
+ 'TOROW' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1-3',
+ ],
+ 'TRANSPOSE' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Matrix::class, 'transpose'],
+ 'argumentCount' => '1',
+ ],
+ 'TREND' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Trends::class, 'TREND'],
+ 'argumentCount' => '1-4',
+ ],
+ 'TRIM' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Trim::class, 'spaces'],
+ 'argumentCount' => '1',
+ ],
+ 'TRIMMEAN' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Averages\Mean::class, 'trim'],
+ 'argumentCount' => '2',
+ ],
+ 'TRUE' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Logical\Boolean::class, 'TRUE'],
+ 'argumentCount' => '0',
+ ],
+ 'TRUNC' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [MathTrig\Trunc::class, 'evaluate'],
+ 'argumentCount' => '1,2',
+ ],
+ 'TTEST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '4',
+ ],
+ 'T.TEST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '4',
+ ],
+ 'TYPE' => [
+ 'category' => Category::CATEGORY_INFORMATION,
+ 'functionCall' => [Information\Value::class, 'type'],
+ 'argumentCount' => '1',
+ ],
+ 'UNICHAR' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\CharacterConvert::class, 'character'],
+ 'argumentCount' => '1',
+ ],
+ 'UNICODE' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\CharacterConvert::class, 'code'],
+ 'argumentCount' => '1',
+ ],
+ 'UNIQUE' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\Unique::class, 'unique'],
+ 'argumentCount' => '1+',
+ ],
+ 'UPPER' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\CaseConvert::class, 'upper'],
+ 'argumentCount' => '1',
+ ],
+ 'USDOLLAR' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Dollar::class, 'format'],
+ 'argumentCount' => '2',
+ ],
+ 'VALUE' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Format::class, 'VALUE'],
+ 'argumentCount' => '1',
+ ],
+ 'VALUETOTEXT' => [
+ 'category' => Category::CATEGORY_TEXT_AND_DATA,
+ 'functionCall' => [TextData\Format::class, 'valueToText'],
+ 'argumentCount' => '1,2',
+ ],
+ 'VAR' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Variances::class, 'VAR'],
+ 'argumentCount' => '1+',
+ ],
+ 'VAR.P' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Variances::class, 'VARP'],
+ 'argumentCount' => '1+',
+ ],
+ 'VAR.S' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Variances::class, 'VAR'],
+ 'argumentCount' => '1+',
+ ],
+ 'VARA' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Variances::class, 'VARA'],
+ 'argumentCount' => '1+',
+ ],
+ 'VARP' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Variances::class, 'VARP'],
+ 'argumentCount' => '1+',
+ ],
+ 'VARPA' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Variances::class, 'VARPA'],
+ 'argumentCount' => '1+',
+ ],
+ 'VDB' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '5-7',
+ ],
+ 'VLOOKUP' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [LookupRef\VLookup::class, 'lookup'],
+ 'argumentCount' => '3,4',
+ ],
+ 'VSTACK' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '1+',
+ ],
+ 'WEBSERVICE' => [
+ 'category' => Category::CATEGORY_WEB,
+ 'functionCall' => [Web\Service::class, 'webService'],
+ 'argumentCount' => '1',
+ ],
+ 'WEEKDAY' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\Week::class, 'day'],
+ 'argumentCount' => '1,2',
+ ],
+ 'WEEKNUM' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\Week::class, 'number'],
+ 'argumentCount' => '1,2',
+ ],
+ 'WEIBULL' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Weibull::class, 'distribution'],
+ 'argumentCount' => '4',
+ ],
+ 'WEIBULL.DIST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\Weibull::class, 'distribution'],
+ 'argumentCount' => '4',
+ ],
+ 'WORKDAY' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\WorkDay::class, 'date'],
+ 'argumentCount' => '2-3',
+ ],
+ 'WORKDAY.INTL' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2-4',
+ ],
+ 'WRAPCOLS' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2-3',
+ ],
+ 'WRAPROWS' => [
+ 'category' => Category::CATEGORY_MATH_AND_TRIG,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2-3',
+ ],
+ 'XIRR' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Variable\NonPeriodic::class, 'rate'],
+ 'argumentCount' => '2,3',
+ ],
+ 'XLOOKUP' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '3-6',
+ ],
+ 'XNPV' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\CashFlow\Variable\NonPeriodic::class, 'presentValue'],
+ 'argumentCount' => '3',
+ ],
+ 'XMATCH' => [
+ 'category' => Category::CATEGORY_LOOKUP_AND_REFERENCE,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '2,3',
+ ],
+ 'XOR' => [
+ 'category' => Category::CATEGORY_LOGICAL,
+ 'functionCall' => [Logical\Operations::class, 'logicalXor'],
+ 'argumentCount' => '1+',
+ ],
+ 'YEAR' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\DateParts::class, 'year'],
+ 'argumentCount' => '1',
+ ],
+ 'YEARFRAC' => [
+ 'category' => Category::CATEGORY_DATE_AND_TIME,
+ 'functionCall' => [DateTimeExcel\YearFrac::class, 'fraction'],
+ 'argumentCount' => '2,3',
+ ],
+ 'YIELD' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Functions::class, 'DUMMY'],
+ 'argumentCount' => '6,7',
+ ],
+ 'YIELDDISC' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Securities\Yields::class, 'yieldDiscounted'],
+ 'argumentCount' => '4,5',
+ ],
+ 'YIELDMAT' => [
+ 'category' => Category::CATEGORY_FINANCIAL,
+ 'functionCall' => [Financial\Securities\Yields::class, 'yieldAtMaturity'],
+ 'argumentCount' => '5,6',
+ ],
+ 'ZTEST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\StandardNormal::class, 'zTest'],
+ 'argumentCount' => '2-3',
+ ],
+ 'Z.TEST' => [
+ 'category' => Category::CATEGORY_STATISTICAL,
+ 'functionCall' => [Statistical\Distributions\StandardNormal::class, 'zTest'],
+ 'argumentCount' => '2-3',
+ ],
+ ];
+
+ /**
+ * Internal functions used for special control purposes.
+ */
+ private static array $controlFunctions = [
+ 'MKMATRIX' => [
+ 'argumentCount' => '*',
+ 'functionCall' => [Internal\MakeMatrix::class, 'make'],
+ ],
+ 'NAME.ERROR' => [
+ 'argumentCount' => '*',
+ 'functionCall' => [ExcelError::class, 'NAME'],
+ ],
+ 'WILDCARDMATCH' => [
+ 'argumentCount' => '2',
+ 'functionCall' => [Internal\WildcardMatch::class, 'compare'],
+ ],
+ ];
+
+ public function __construct(?Spreadsheet $spreadsheet = null)
+ {
+ $this->spreadsheet = $spreadsheet;
+ $this->cyclicReferenceStack = new CyclicReferenceStack();
+ $this->debugLog = new Logger($this->cyclicReferenceStack);
+ $this->branchPruner = new BranchPruner($this->branchPruningEnabled);
+ self::$referenceHelper = ReferenceHelper::getInstance();
+ }
+
+ private static function loadLocales(): void
+ {
+ $localeFileDirectory = __DIR__ . '/locale/';
+ $localeFileNames = glob($localeFileDirectory . '*', GLOB_ONLYDIR) ?: [];
+ foreach ($localeFileNames as $filename) {
+ $filename = substr($filename, strlen($localeFileDirectory));
+ if ($filename != 'en') {
+ self::$validLocaleLanguages[] = $filename;
+ }
+ }
+ }
+
+ /**
+ * Get an instance of this class.
+ *
+ * @param ?Spreadsheet $spreadsheet Injected spreadsheet for working with a PhpSpreadsheet Spreadsheet object,
+ * or NULL to create a standalone calculation engine
+ */
+ public static function getInstance(?Spreadsheet $spreadsheet = null): self
+ {
+ if ($spreadsheet !== null) {
+ $instance = $spreadsheet->getCalculationEngine();
+ if (isset($instance)) {
+ return $instance;
+ }
+ }
+
+ if (!self::$instance) {
+ self::$instance = new self();
+ }
+
+ return self::$instance;
+ }
+
+ /**
+ * Flush the calculation cache for any existing instance of this class
+ * but only if a Calculation instance exists.
+ */
+ public function flushInstance(): void
+ {
+ $this->clearCalculationCache();
+ $this->branchPruner->clearBranchStore();
+ }
+
+ /**
+ * Get the Logger for this calculation engine instance.
+ */
+ public function getDebugLog(): Logger
+ {
+ return $this->debugLog;
+ }
+
+ /**
+ * __clone implementation. Cloning should not be allowed in a Singleton!
+ */
+ final public function __clone()
+ {
+ throw new Exception('Cloning the calculation engine is not allowed!');
+ }
+
+ /**
+ * Return the locale-specific translation of TRUE.
+ *
+ * @return string locale-specific translation of TRUE
+ */
+ public static function getTRUE(): string
+ {
+ return self::$localeBoolean['TRUE'];
+ }
+
+ /**
+ * Return the locale-specific translation of FALSE.
+ *
+ * @return string locale-specific translation of FALSE
+ */
+ public static function getFALSE(): string
+ {
+ return self::$localeBoolean['FALSE'];
+ }
+
+ /**
+ * Set the Array Return Type (Array or Value of first element in the array).
+ *
+ * @param string $returnType Array return type
+ *
+ * @return bool Success or failure
+ */
+ public static function setArrayReturnType(string $returnType): bool
+ {
+ if (
+ ($returnType == self::RETURN_ARRAY_AS_VALUE)
+ || ($returnType == self::RETURN_ARRAY_AS_ERROR)
+ || ($returnType == self::RETURN_ARRAY_AS_ARRAY)
+ ) {
+ self::$returnArrayAsType = $returnType;
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Return the Array Return Type (Array or Value of first element in the array).
+ *
+ * @return string $returnType Array return type
+ */
+ public static function getArrayReturnType(): string
+ {
+ return self::$returnArrayAsType;
+ }
+
+ /**
+ * Is calculation caching enabled?
+ */
+ public function getCalculationCacheEnabled(): bool
+ {
+ return $this->calculationCacheEnabled;
+ }
+
+ /**
+ * Enable/disable calculation cache.
+ */
+ public function setCalculationCacheEnabled(bool $calculationCacheEnabled): void
+ {
+ $this->calculationCacheEnabled = $calculationCacheEnabled;
+ $this->clearCalculationCache();
+ }
+
+ /**
+ * Enable calculation cache.
+ */
+ public function enableCalculationCache(): void
+ {
+ $this->setCalculationCacheEnabled(true);
+ }
+
+ /**
+ * Disable calculation cache.
+ */
+ public function disableCalculationCache(): void
+ {
+ $this->setCalculationCacheEnabled(false);
+ }
+
+ /**
+ * Clear calculation cache.
+ */
+ public function clearCalculationCache(): void
+ {
+ $this->calculationCache = [];
+ }
+
+ /**
+ * Clear calculation cache for a specified worksheet.
+ */
+ public function clearCalculationCacheForWorksheet(string $worksheetName): void
+ {
+ if (isset($this->calculationCache[$worksheetName])) {
+ unset($this->calculationCache[$worksheetName]);
+ }
+ }
+
+ /**
+ * Rename calculation cache for a specified worksheet.
+ */
+ public function renameCalculationCacheForWorksheet(string $fromWorksheetName, string $toWorksheetName): void
+ {
+ if (isset($this->calculationCache[$fromWorksheetName])) {
+ $this->calculationCache[$toWorksheetName] = &$this->calculationCache[$fromWorksheetName];
+ unset($this->calculationCache[$fromWorksheetName]);
+ }
+ }
+
+ /**
+ * Enable/disable calculation cache.
+ */
+ public function setBranchPruningEnabled(mixed $enabled): void
+ {
+ $this->branchPruningEnabled = $enabled;
+ $this->branchPruner = new BranchPruner($this->branchPruningEnabled);
+ }
+
+ public function enableBranchPruning(): void
+ {
+ $this->setBranchPruningEnabled(true);
+ }
+
+ public function disableBranchPruning(): void
+ {
+ $this->setBranchPruningEnabled(false);
+ }
+
+ /**
+ * Get the currently defined locale code.
+ */
+ public function getLocale(): string
+ {
+ return self::$localeLanguage;
+ }
+
+ private function getLocaleFile(string $localeDir, string $locale, string $language, string $file): string
+ {
+ $localeFileName = $localeDir . str_replace('_', DIRECTORY_SEPARATOR, $locale)
+ . DIRECTORY_SEPARATOR . $file;
+ if (!file_exists($localeFileName)) {
+ // If there isn't a locale specific file, look for a language specific file
+ $localeFileName = $localeDir . $language . DIRECTORY_SEPARATOR . $file;
+ if (!file_exists($localeFileName)) {
+ throw new Exception('Locale file not found');
+ }
+ }
+
+ return $localeFileName;
+ }
+
+ /**
+ * Set the locale code.
+ *
+ * @param string $locale The locale to use for formula translation, eg: 'en_us'
+ */
+ public function setLocale(string $locale): bool
+ {
+ // Identify our locale and language
+ $language = $locale = strtolower($locale);
+ if (str_contains($locale, '_')) {
+ [$language] = explode('_', $locale);
+ }
+ if (count(self::$validLocaleLanguages) == 1) {
+ self::loadLocales();
+ }
+
+ // Test whether we have any language data for this language (any locale)
+ if (in_array($language, self::$validLocaleLanguages, true)) {
+ // initialise language/locale settings
+ self::$localeFunctions = [];
+ self::$localeArgumentSeparator = ',';
+ self::$localeBoolean = ['TRUE' => 'TRUE', 'FALSE' => 'FALSE', 'NULL' => 'NULL'];
+
+ // Default is US English, if user isn't requesting US english, then read the necessary data from the locale files
+ if ($locale !== 'en_us') {
+ $localeDir = implode(DIRECTORY_SEPARATOR, [__DIR__, 'locale', null]);
+
+ // Search for a file with a list of function names for locale
+ try {
+ $functionNamesFile = $this->getLocaleFile($localeDir, $locale, $language, 'functions');
+ } catch (Exception $e) {
+ return false;
+ }
+
+ // Retrieve the list of locale or language specific function names
+ $localeFunctions = file($functionNamesFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES) ?: [];
+ foreach ($localeFunctions as $localeFunction) {
+ [$localeFunction] = explode('##', $localeFunction); // Strip out comments
+ if (str_contains($localeFunction, '=')) {
+ [$fName, $lfName] = array_map('trim', explode('=', $localeFunction));
+ if ((str_starts_with($fName, '*') || isset(self::$phpSpreadsheetFunctions[$fName])) && ($lfName != '') && ($fName != $lfName)) {
+ self::$localeFunctions[$fName] = $lfName;
+ }
+ }
+ }
+ // Default the TRUE and FALSE constants to the locale names of the TRUE() and FALSE() functions
+ if (isset(self::$localeFunctions['TRUE'])) {
+ self::$localeBoolean['TRUE'] = self::$localeFunctions['TRUE'];
+ }
+ if (isset(self::$localeFunctions['FALSE'])) {
+ self::$localeBoolean['FALSE'] = self::$localeFunctions['FALSE'];
+ }
+
+ try {
+ $configFile = $this->getLocaleFile($localeDir, $locale, $language, 'config');
+ } catch (Exception) {
+ return false;
+ }
+
+ $localeSettings = file($configFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES) ?: [];
+ foreach ($localeSettings as $localeSetting) {
+ [$localeSetting] = explode('##', $localeSetting); // Strip out comments
+ if (str_contains($localeSetting, '=')) {
+ [$settingName, $settingValue] = array_map('trim', explode('=', $localeSetting));
+ $settingName = strtoupper($settingName);
+ if ($settingValue !== '') {
+ switch ($settingName) {
+ case 'ARGUMENTSEPARATOR':
+ self::$localeArgumentSeparator = $settingValue;
+
+ break;
+ }
+ }
+ }
+ }
+ }
+
+ self::$functionReplaceFromExcel = self::$functionReplaceToExcel
+ = self::$functionReplaceFromLocale = self::$functionReplaceToLocale = null;
+ self::$localeLanguage = $locale;
+
+ return true;
+ }
+
+ return false;
+ }
+
+ public static function translateSeparator(
+ string $fromSeparator,
+ string $toSeparator,
+ string $formula,
+ int &$inBracesLevel,
+ string $openBrace = self::FORMULA_OPEN_FUNCTION_BRACE,
+ string $closeBrace = self::FORMULA_CLOSE_FUNCTION_BRACE
+ ): string {
+ $strlen = mb_strlen($formula);
+ for ($i = 0; $i < $strlen; ++$i) {
+ $chr = mb_substr($formula, $i, 1);
+ switch ($chr) {
+ case $openBrace:
+ ++$inBracesLevel;
+
+ break;
+ case $closeBrace:
+ --$inBracesLevel;
+
+ break;
+ case $fromSeparator:
+ if ($inBracesLevel > 0) {
+ $formula = mb_substr($formula, 0, $i) . $toSeparator . mb_substr($formula, $i + 1);
+ }
+ }
+ }
+
+ return $formula;
+ }
+
+ private static function translateFormulaBlock(
+ array $from,
+ array $to,
+ string $formula,
+ int &$inFunctionBracesLevel,
+ int &$inMatrixBracesLevel,
+ string $fromSeparator,
+ string $toSeparator
+ ): string {
+ // Function Names
+ $formula = (string) preg_replace($from, $to, $formula);
+
+ // Temporarily adjust matrix separators so that they won't be confused with function arguments
+ $formula = self::translateSeparator(';', '|', $formula, $inMatrixBracesLevel, self::FORMULA_OPEN_MATRIX_BRACE, self::FORMULA_CLOSE_MATRIX_BRACE);
+ $formula = self::translateSeparator(',', '!', $formula, $inMatrixBracesLevel, self::FORMULA_OPEN_MATRIX_BRACE, self::FORMULA_CLOSE_MATRIX_BRACE);
+ // Function Argument Separators
+ $formula = self::translateSeparator($fromSeparator, $toSeparator, $formula, $inFunctionBracesLevel);
+ // Restore matrix separators
+ $formula = self::translateSeparator('|', ';', $formula, $inMatrixBracesLevel, self::FORMULA_OPEN_MATRIX_BRACE, self::FORMULA_CLOSE_MATRIX_BRACE);
+ $formula = self::translateSeparator('!', ',', $formula, $inMatrixBracesLevel, self::FORMULA_OPEN_MATRIX_BRACE, self::FORMULA_CLOSE_MATRIX_BRACE);
+
+ return $formula;
+ }
+
+ private static function translateFormula(array $from, array $to, string $formula, string $fromSeparator, string $toSeparator): string
+ {
+ // Convert any Excel function names and constant names to the required language;
+ // and adjust function argument separators
+ if (self::$localeLanguage !== 'en_us') {
+ $inFunctionBracesLevel = 0;
+ $inMatrixBracesLevel = 0;
+ // If there is the possibility of separators within a quoted string, then we treat them as literals
+ if (str_contains($formula, self::FORMULA_STRING_QUOTE)) {
+ // So instead we skip replacing in any quoted strings by only replacing in every other array element
+ // after we've exploded the formula
+ $temp = explode(self::FORMULA_STRING_QUOTE, $formula);
+ $notWithinQuotes = false;
+ foreach ($temp as &$value) {
+ // Only adjust in alternating array entries
+ $notWithinQuotes = $notWithinQuotes === false;
+ if ($notWithinQuotes === true) {
+ $value = self::translateFormulaBlock($from, $to, $value, $inFunctionBracesLevel, $inMatrixBracesLevel, $fromSeparator, $toSeparator);
+ }
+ }
+ unset($value);
+ // Then rebuild the formula string
+ $formula = implode(self::FORMULA_STRING_QUOTE, $temp);
+ } else {
+ // If there's no quoted strings, then we do a simple count/replace
+ $formula = self::translateFormulaBlock($from, $to, $formula, $inFunctionBracesLevel, $inMatrixBracesLevel, $fromSeparator, $toSeparator);
+ }
+ }
+
+ return $formula;
+ }
+
+ private static ?array $functionReplaceFromExcel;
+
+ private static ?array $functionReplaceToLocale;
+
+ /**
+ * @deprecated 1.30.0 use translateFormulaToLocale() instead
+ *
+ * @codeCoverageIgnore
+ */
+ public function _translateFormulaToLocale(string $formula): string
+ {
+ return $this->translateFormulaToLocale($formula);
+ }
+
+ public function translateFormulaToLocale(string $formula): string
+ {
+ $formula = preg_replace(self::CALCULATION_REGEXP_STRIP_XLFN_XLWS, '', $formula) ?? '';
+ // Build list of function names and constants for translation
+ if (self::$functionReplaceFromExcel === null) {
+ self::$functionReplaceFromExcel = [];
+ foreach (array_keys(self::$localeFunctions) as $excelFunctionName) {
+ self::$functionReplaceFromExcel[] = '/(@?[^\w\.])' . preg_quote($excelFunctionName, '/') . '([\s]*\()/ui';
+ }
+ foreach (array_keys(self::$localeBoolean) as $excelBoolean) {
+ self::$functionReplaceFromExcel[] = '/(@?[^\w\.])' . preg_quote($excelBoolean, '/') . '([^\w\.])/ui';
+ }
+ }
+
+ if (self::$functionReplaceToLocale === null) {
+ self::$functionReplaceToLocale = [];
+ foreach (self::$localeFunctions as $localeFunctionName) {
+ self::$functionReplaceToLocale[] = '$1' . trim($localeFunctionName) . '$2';
+ }
+ foreach (self::$localeBoolean as $localeBoolean) {
+ self::$functionReplaceToLocale[] = '$1' . trim($localeBoolean) . '$2';
+ }
+ }
+
+ return self::translateFormula(
+ self::$functionReplaceFromExcel,
+ self::$functionReplaceToLocale,
+ $formula,
+ ',',
+ self::$localeArgumentSeparator
+ );
+ }
+
+ private static ?array $functionReplaceFromLocale;
+
+ private static ?array $functionReplaceToExcel;
+
+ /**
+ * @deprecated 1.30.0 use translateFormulaToEnglish() instead
+ *
+ * @codeCoverageIgnore
+ */
+ public function _translateFormulaToEnglish(string $formula): string
+ {
+ return $this->translateFormulaToEnglish($formula);
+ }
+
+ public function translateFormulaToEnglish(string $formula): string
+ {
+ if (self::$functionReplaceFromLocale === null) {
+ self::$functionReplaceFromLocale = [];
+ foreach (self::$localeFunctions as $localeFunctionName) {
+ self::$functionReplaceFromLocale[] = '/(@?[^\w\.])' . preg_quote($localeFunctionName, '/') . '([\s]*\()/ui';
+ }
+ foreach (self::$localeBoolean as $excelBoolean) {
+ self::$functionReplaceFromLocale[] = '/(@?[^\w\.])' . preg_quote($excelBoolean, '/') . '([^\w\.])/ui';
+ }
+ }
+
+ if (self::$functionReplaceToExcel === null) {
+ self::$functionReplaceToExcel = [];
+ foreach (array_keys(self::$localeFunctions) as $excelFunctionName) {
+ self::$functionReplaceToExcel[] = '$1' . trim($excelFunctionName) . '$2';
+ }
+ foreach (array_keys(self::$localeBoolean) as $excelBoolean) {
+ self::$functionReplaceToExcel[] = '$1' . trim($excelBoolean) . '$2';
+ }
+ }
+
+ return self::translateFormula(self::$functionReplaceFromLocale, self::$functionReplaceToExcel, $formula, self::$localeArgumentSeparator, ',');
+ }
+
+ public static function localeFunc(string $function): string
+ {
+ if (self::$localeLanguage !== 'en_us') {
+ $functionName = trim($function, '(');
+ if (isset(self::$localeFunctions[$functionName])) {
+ $brace = ($functionName != $function);
+ $function = self::$localeFunctions[$functionName];
+ if ($brace) {
+ $function .= '(';
+ }
+ }
+ }
+
+ return $function;
+ }
+
+ /**
+ * Wrap string values in quotes.
+ */
+ public static function wrapResult(mixed $value): mixed
+ {
+ if (is_string($value)) {
+ // Error values cannot be "wrapped"
+ if (preg_match('/^' . self::CALCULATION_REGEXP_ERROR . '$/i', $value, $match)) {
+ // Return Excel errors "as is"
+ return $value;
+ }
+
+ // Return strings wrapped in quotes
+ return self::FORMULA_STRING_QUOTE . $value . self::FORMULA_STRING_QUOTE;
+ } elseif ((is_float($value)) && ((is_nan($value)) || (is_infinite($value)))) {
+ // Convert numeric errors to NaN error
+ return ExcelError::NAN();
+ }
+
+ return $value;
+ }
+
+ /**
+ * Remove quotes used as a wrapper to identify string values.
+ */
+ public static function unwrapResult(mixed $value): mixed
+ {
+ if (is_string($value)) {
+ if ((isset($value[0])) && ($value[0] == self::FORMULA_STRING_QUOTE) && (substr($value, -1) == self::FORMULA_STRING_QUOTE)) {
+ return substr($value, 1, -1);
+ }
+ // Convert numeric errors to NAN error
+ } elseif ((is_float($value)) && ((is_nan($value)) || (is_infinite($value)))) {
+ return ExcelError::NAN();
+ }
+
+ return $value;
+ }
+
+ /**
+ * Calculate cell value (using formula from a cell ID)
+ * Retained for backward compatibility.
+ *
+ * @param ?Cell $cell Cell to calculate
+ */
+ public function calculate(?Cell $cell = null): mixed
+ {
+ try {
+ return $this->calculateCellValue($cell);
+ } catch (\Exception $e) {
+ throw new Exception($e->getMessage());
+ }
+ }
+
+ /**
+ * Calculate the value of a cell formula.
+ *
+ * @param ?Cell $cell Cell to calculate
+ * @param bool $resetLog Flag indicating whether the debug log should be reset or not
+ */
+ public function calculateCellValue(?Cell $cell = null, bool $resetLog = true): mixed
+ {
+ if ($cell === null) {
+ return null;
+ }
+
+ $returnArrayAsType = self::$returnArrayAsType;
+ if ($resetLog) {
+ // Initialise the logging settings if requested
+ $this->formulaError = null;
+ $this->debugLog->clearLog();
+ $this->cyclicReferenceStack->clear();
+ $this->cyclicFormulaCounter = 1;
+
+ self::$returnArrayAsType = self::RETURN_ARRAY_AS_ARRAY;
+ }
+
+ // Execute the calculation for the cell formula
+ $this->cellStack[] = [
+ 'sheet' => $cell->getWorksheet()->getTitle(),
+ 'cell' => $cell->getCoordinate(),
+ ];
+
+ $cellAddressAttempted = false;
+ $cellAddress = null;
+
+ try {
+ $result = self::unwrapResult($this->_calculateFormulaValue($cell->getValue(), $cell->getCoordinate(), $cell));
+ if ($this->spreadsheet === null) {
+ throw new Exception('null spreadsheet in calculateCellValue');
+ }
+ $cellAddressAttempted = true;
+ $cellAddress = array_pop($this->cellStack);
+ if ($cellAddress === null) {
+ throw new Exception('null cellAddress in calculateCellValue');
+ }
+ $testSheet = $this->spreadsheet->getSheetByName($cellAddress['sheet']);
+ if ($testSheet === null) {
+ throw new Exception('worksheet not found in calculateCellValue');
+ }
+ $testSheet->getCell($cellAddress['cell']);
+ } catch (\Exception $e) {
+ if (!$cellAddressAttempted) {
+ $cellAddress = array_pop($this->cellStack);
+ }
+ if ($this->spreadsheet !== null && is_array($cellAddress) && array_key_exists('sheet', $cellAddress)) {
+ $testSheet = $this->spreadsheet->getSheetByName($cellAddress['sheet']);
+ if ($testSheet !== null && array_key_exists('cell', $cellAddress)) {
+ $testSheet->getCell($cellAddress['cell']);
+ }
+ }
+
+ throw new Exception($e->getMessage(), $e->getCode(), $e);
+ }
+
+ if ((is_array($result)) && (self::$returnArrayAsType != self::RETURN_ARRAY_AS_ARRAY)) {
+ self::$returnArrayAsType = $returnArrayAsType;
+ $testResult = Functions::flattenArray($result);
+ if (self::$returnArrayAsType == self::RETURN_ARRAY_AS_ERROR) {
+ return ExcelError::VALUE();
+ }
+ // If there's only a single cell in the array, then we allow it
+ if (count($testResult) != 1) {
+ // If keys are numeric, then it's a matrix result rather than a cell range result, so we permit it
+ $r = array_keys($result);
+ $r = array_shift($r);
+ if (!is_numeric($r)) {
+ return ExcelError::VALUE();
+ }
+ if (is_array($result[$r])) {
+ $c = array_keys($result[$r]);
+ $c = array_shift($c);
+ if (!is_numeric($c)) {
+ return ExcelError::VALUE();
+ }
+ }
+ }
+ $result = array_shift($testResult);
+ }
+ self::$returnArrayAsType = $returnArrayAsType;
+
+ if ($result === null && $cell->getWorksheet()->getSheetView()->getShowZeros()) {
+ return 0;
+ } elseif ((is_float($result)) && ((is_nan($result)) || (is_infinite($result)))) {
+ return ExcelError::NAN();
+ }
+
+ return $result;
+ }
+
+ /**
+ * Validate and parse a formula string.
+ *
+ * @param string $formula Formula to parse
+ */
+ public function parseFormula(string $formula): array|bool
+ {
+ // Basic validation that this is indeed a formula
+ // We return an empty array if not
+ $formula = trim($formula);
+ if ((!isset($formula[0])) || ($formula[0] != '=')) {
+ return [];
+ }
+ $formula = ltrim(substr($formula, 1));
+ if (!isset($formula[0])) {
+ return [];
+ }
+
+ // Parse the formula and return the token stack
+ return $this->internalParseFormula($formula);
+ }
+
+ /**
+ * Calculate the value of a formula.
+ *
+ * @param string $formula Formula to parse
+ * @param ?string $cellID Address of the cell to calculate
+ * @param ?Cell $cell Cell to calculate
+ */
+ public function calculateFormula(string $formula, ?string $cellID = null, ?Cell $cell = null): mixed
+ {
+ // Initialise the logging settings
+ $this->formulaError = null;
+ $this->debugLog->clearLog();
+ $this->cyclicReferenceStack->clear();
+
+ $resetCache = $this->getCalculationCacheEnabled();
+ if ($this->spreadsheet !== null && $cellID === null && $cell === null) {
+ $cellID = 'A1';
+ $cell = $this->spreadsheet->getActiveSheet()->getCell($cellID);
+ } else {
+ // Disable calculation cacheing because it only applies to cell calculations, not straight formulae
+ // But don't actually flush any cache
+ $this->calculationCacheEnabled = false;
+ }
+
+ // Execute the calculation
+ try {
+ $result = self::unwrapResult($this->_calculateFormulaValue($formula, $cellID, $cell));
+ } catch (\Exception $e) {
+ throw new Exception($e->getMessage());
+ }
+
+ if ($this->spreadsheet === null) {
+ // Reset calculation cacheing to its previous state
+ $this->calculationCacheEnabled = $resetCache;
+ }
+
+ return $result;
+ }
+
+ public function getValueFromCache(string $cellReference, mixed &$cellValue): bool
+ {
+ $this->debugLog->writeDebugLog('Testing cache value for cell %s', $cellReference);
+ // Is calculation cacheing enabled?
+ // If so, is the required value present in calculation cache?
+ if (($this->calculationCacheEnabled) && (isset($this->calculationCache[$cellReference]))) {
+ $this->debugLog->writeDebugLog('Retrieving value for cell %s from cache', $cellReference);
+ // Return the cached result
+
+ $cellValue = $this->calculationCache[$cellReference];
+
+ return true;
+ }
+
+ return false;
+ }
+
+ public function saveValueToCache(string $cellReference, mixed $cellValue): void
+ {
+ if ($this->calculationCacheEnabled) {
+ $this->calculationCache[$cellReference] = $cellValue;
+ }
+ }
+
+ /**
+ * Parse a cell formula and calculate its value.
+ *
+ * @param string $formula The formula to parse and calculate
+ * @param ?string $cellID The ID (e.g. A3) of the cell that we are calculating
+ * @param ?Cell $cell Cell to calculate
+ * @param bool $ignoreQuotePrefix If set to true, evaluate the formyla even if the referenced cell is quote prefixed
+ */
+ public function _calculateFormulaValue(string $formula, ?string $cellID = null, ?Cell $cell = null, bool $ignoreQuotePrefix = false): mixed
+ {
+ $cellValue = null;
+
+ // Quote-Prefixed cell values cannot be formulae, but are treated as strings
+ if ($cell !== null && $ignoreQuotePrefix === false && $cell->getStyle()->getQuotePrefix() === true) {
+ return self::wrapResult((string) $formula);
+ }
+
+ if (preg_match('/^=\s*cmd\s*\|/miu', $formula) !== 0) {
+ return self::wrapResult($formula);
+ }
+
+ // Basic validation that this is indeed a formula
+ // We simply return the cell value if not
+ $formula = trim($formula);
+ if ($formula[0] != '=') {
+ return self::wrapResult($formula);
+ }
+ $formula = ltrim(substr($formula, 1));
+ if (!isset($formula[0])) {
+ return self::wrapResult($formula);
+ }
+
+ $pCellParent = ($cell !== null) ? $cell->getWorksheet() : null;
+ $wsTitle = ($pCellParent !== null) ? $pCellParent->getTitle() : "\x00Wrk";
+ $wsCellReference = $wsTitle . '!' . $cellID;
+
+ if (($cellID !== null) && ($this->getValueFromCache($wsCellReference, $cellValue))) {
+ return $cellValue;
+ }
+ $this->debugLog->writeDebugLog('Evaluating formula for cell %s', $wsCellReference);
+
+ if (($wsTitle[0] !== "\x00") && ($this->cyclicReferenceStack->onStack($wsCellReference))) {
+ if ($this->cyclicFormulaCount <= 0) {
+ $this->cyclicFormulaCell = '';
+
+ return $this->raiseFormulaError('Cyclic Reference in Formula');
+ } elseif ($this->cyclicFormulaCell === $wsCellReference) {
+ ++$this->cyclicFormulaCounter;
+ if ($this->cyclicFormulaCounter >= $this->cyclicFormulaCount) {
+ $this->cyclicFormulaCell = '';
+
+ return $cellValue;
+ }
+ } elseif ($this->cyclicFormulaCell == '') {
+ if ($this->cyclicFormulaCounter >= $this->cyclicFormulaCount) {
+ return $cellValue;
+ }
+ $this->cyclicFormulaCell = $wsCellReference;
+ }
+ }
+
+ $this->debugLog->writeDebugLog('Formula for cell %s is %s', $wsCellReference, $formula);
+ // Parse the formula onto the token stack and calculate the value
+ $this->cyclicReferenceStack->push($wsCellReference);
+
+ $cellValue = $this->processTokenStack($this->internalParseFormula($formula, $cell), $cellID, $cell);
+ $this->cyclicReferenceStack->pop();
+
+ // Save to calculation cache
+ if ($cellID !== null) {
+ $this->saveValueToCache($wsCellReference, $cellValue);
+ }
+
+ // Return the calculated value
+ return $cellValue;
+ }
+
+ /**
+ * Ensure that paired matrix operands are both matrices and of the same size.
+ *
+ * @param mixed $operand1 First matrix operand
+ * @param mixed $operand2 Second matrix operand
+ * @param int $resize Flag indicating whether the matrices should be resized to match
+ * and (if so), whether the smaller dimension should grow or the
+ * larger should shrink.
+ * 0 = no resize
+ * 1 = shrink to fit
+ * 2 = extend to fit
+ */
+ private static function checkMatrixOperands(mixed &$operand1, mixed &$operand2, int $resize = 1): array
+ {
+ // Examine each of the two operands, and turn them into an array if they aren't one already
+ // Note that this function should only be called if one or both of the operand is already an array
+ if (!is_array($operand1)) {
+ [$matrixRows, $matrixColumns] = self::getMatrixDimensions($operand2);
+ $operand1 = array_fill(0, $matrixRows, array_fill(0, $matrixColumns, $operand1));
+ $resize = 0;
+ } elseif (!is_array($operand2)) {
+ [$matrixRows, $matrixColumns] = self::getMatrixDimensions($operand1);
+ $operand2 = array_fill(0, $matrixRows, array_fill(0, $matrixColumns, $operand2));
+ $resize = 0;
+ }
+
+ [$matrix1Rows, $matrix1Columns] = self::getMatrixDimensions($operand1);
+ [$matrix2Rows, $matrix2Columns] = self::getMatrixDimensions($operand2);
+ if (($matrix1Rows == $matrix2Columns) && ($matrix2Rows == $matrix1Columns)) {
+ $resize = 1;
+ }
+
+ if ($resize == 2) {
+ // Given two matrices of (potentially) unequal size, convert the smaller in each dimension to match the larger
+ self::resizeMatricesExtend($operand1, $operand2, $matrix1Rows, $matrix1Columns, $matrix2Rows, $matrix2Columns);
+ } elseif ($resize == 1) {
+ // Given two matrices of (potentially) unequal size, convert the larger in each dimension to match the smaller
+ self::resizeMatricesShrink($operand1, $operand2, $matrix1Rows, $matrix1Columns, $matrix2Rows, $matrix2Columns);
+ }
+ [$matrix1Rows, $matrix1Columns] = self::getMatrixDimensions($operand1);
+ [$matrix2Rows, $matrix2Columns] = self::getMatrixDimensions($operand2);
+
+ return [$matrix1Rows, $matrix1Columns, $matrix2Rows, $matrix2Columns];
+ }
+
+ /**
+ * Read the dimensions of a matrix, and re-index it with straight numeric keys starting from row 0, column 0.
+ *
+ * @param array $matrix matrix operand
+ *
+ * @return int[] An array comprising the number of rows, and number of columns
+ */
+ public static function getMatrixDimensions(array &$matrix): array
+ {
+ $matrixRows = count($matrix);
+ $matrixColumns = 0;
+ foreach ($matrix as $rowKey => $rowValue) {
+ if (!is_array($rowValue)) {
+ $matrix[$rowKey] = [$rowValue];
+ $matrixColumns = max(1, $matrixColumns);
+ } else {
+ $matrix[$rowKey] = array_values($rowValue);
+ $matrixColumns = max(count($rowValue), $matrixColumns);
+ }
+ }
+ $matrix = array_values($matrix);
+
+ return [$matrixRows, $matrixColumns];
+ }
+
+ /**
+ * Ensure that paired matrix operands are both matrices of the same size.
+ *
+ * @param array $matrix1 First matrix operand
+ * @param array $matrix2 Second matrix operand
+ * @param int $matrix1Rows Row size of first matrix operand
+ * @param int $matrix1Columns Column size of first matrix operand
+ * @param int $matrix2Rows Row size of second matrix operand
+ * @param int $matrix2Columns Column size of second matrix operand
+ */
+ private static function resizeMatricesShrink(array &$matrix1, array &$matrix2, int $matrix1Rows, int $matrix1Columns, int $matrix2Rows, int $matrix2Columns): void
+ {
+ if (($matrix2Columns < $matrix1Columns) || ($matrix2Rows < $matrix1Rows)) {
+ if ($matrix2Rows < $matrix1Rows) {
+ for ($i = $matrix2Rows; $i < $matrix1Rows; ++$i) {
+ unset($matrix1[$i]);
+ }
+ }
+ if ($matrix2Columns < $matrix1Columns) {
+ for ($i = 0; $i < $matrix1Rows; ++$i) {
+ for ($j = $matrix2Columns; $j < $matrix1Columns; ++$j) {
+ unset($matrix1[$i][$j]);
+ }
+ }
+ }
+ }
+
+ if (($matrix1Columns < $matrix2Columns) || ($matrix1Rows < $matrix2Rows)) {
+ if ($matrix1Rows < $matrix2Rows) {
+ for ($i = $matrix1Rows; $i < $matrix2Rows; ++$i) {
+ unset($matrix2[$i]);
+ }
+ }
+ if ($matrix1Columns < $matrix2Columns) {
+ for ($i = 0; $i < $matrix2Rows; ++$i) {
+ for ($j = $matrix1Columns; $j < $matrix2Columns; ++$j) {
+ unset($matrix2[$i][$j]);
+ }
+ }
+ }
+ }
+ }
+
+ /**
+ * Ensure that paired matrix operands are both matrices of the same size.
+ *
+ * @param array $matrix1 First matrix operand
+ * @param array $matrix2 Second matrix operand
+ * @param int $matrix1Rows Row size of first matrix operand
+ * @param int $matrix1Columns Column size of first matrix operand
+ * @param int $matrix2Rows Row size of second matrix operand
+ * @param int $matrix2Columns Column size of second matrix operand
+ */
+ private static function resizeMatricesExtend(array &$matrix1, array &$matrix2, int $matrix1Rows, int $matrix1Columns, int $matrix2Rows, int $matrix2Columns): void
+ {
+ if (($matrix2Columns < $matrix1Columns) || ($matrix2Rows < $matrix1Rows)) {
+ if ($matrix2Columns < $matrix1Columns) {
+ for ($i = 0; $i < $matrix2Rows; ++$i) {
+ $x = $matrix2[$i][$matrix2Columns - 1];
+ for ($j = $matrix2Columns; $j < $matrix1Columns; ++$j) {
+ $matrix2[$i][$j] = $x;
+ }
+ }
+ }
+ if ($matrix2Rows < $matrix1Rows) {
+ $x = $matrix2[$matrix2Rows - 1];
+ for ($i = 0; $i < $matrix1Rows; ++$i) {
+ $matrix2[$i] = $x;
+ }
+ }
+ }
+
+ if (($matrix1Columns < $matrix2Columns) || ($matrix1Rows < $matrix2Rows)) {
+ if ($matrix1Columns < $matrix2Columns) {
+ for ($i = 0; $i < $matrix1Rows; ++$i) {
+ $x = $matrix1[$i][$matrix1Columns - 1];
+ for ($j = $matrix1Columns; $j < $matrix2Columns; ++$j) {
+ $matrix1[$i][$j] = $x;
+ }
+ }
+ }
+ if ($matrix1Rows < $matrix2Rows) {
+ $x = $matrix1[$matrix1Rows - 1];
+ for ($i = 0; $i < $matrix2Rows; ++$i) {
+ $matrix1[$i] = $x;
+ }
+ }
+ }
+ }
+
+ /**
+ * Format details of an operand for display in the log (based on operand type).
+ *
+ * @param mixed $value First matrix operand
+ */
+ private function showValue(mixed $value): mixed
+ {
+ if ($this->debugLog->getWriteDebugLog()) {
+ $testArray = Functions::flattenArray($value);
+ if (count($testArray) == 1) {
+ $value = array_pop($testArray);
+ }
+
+ if (is_array($value)) {
+ $returnMatrix = [];
+ $pad = $rpad = ', ';
+ foreach ($value as $row) {
+ if (is_array($row)) {
+ $returnMatrix[] = implode($pad, array_map([$this, 'showValue'], $row));
+ $rpad = '; ';
+ } else {
+ $returnMatrix[] = $this->showValue($row);
+ }
+ }
+
+ return '{ ' . implode($rpad, $returnMatrix) . ' }';
+ } elseif (is_string($value) && (trim($value, self::FORMULA_STRING_QUOTE) == $value)) {
+ return self::FORMULA_STRING_QUOTE . $value . self::FORMULA_STRING_QUOTE;
+ } elseif (is_bool($value)) {
+ return ($value) ? self::$localeBoolean['TRUE'] : self::$localeBoolean['FALSE'];
+ } elseif ($value === null) {
+ return self::$localeBoolean['NULL'];
+ }
+ }
+
+ return Functions::flattenSingleValue($value);
+ }
+
+ /**
+ * Format type and details of an operand for display in the log (based on operand type).
+ *
+ * @param mixed $value First matrix operand
+ */
+ private function showTypeDetails(mixed $value): ?string
+ {
+ if ($this->debugLog->getWriteDebugLog()) {
+ $testArray = Functions::flattenArray($value);
+ if (count($testArray) == 1) {
+ $value = array_pop($testArray);
+ }
+
+ if ($value === null) {
+ return 'a NULL value';
+ } elseif (is_float($value)) {
+ $typeString = 'a floating point number';
+ } elseif (is_int($value)) {
+ $typeString = 'an integer number';
+ } elseif (is_bool($value)) {
+ $typeString = 'a boolean';
+ } elseif (is_array($value)) {
+ $typeString = 'a matrix';
+ } else {
+ if ($value == '') {
+ return 'an empty string';
+ } elseif ($value[0] == '#') {
+ return 'a ' . $value . ' error';
+ }
+ $typeString = 'a string';
+ }
+
+ return $typeString . ' with a value of ' . $this->showValue($value);
+ }
+
+ return null;
+ }
+
+ /**
+ * @return false|string False indicates an error
+ */
+ private function convertMatrixReferences(string $formula): false|string
+ {
+ static $matrixReplaceFrom = [self::FORMULA_OPEN_MATRIX_BRACE, ';', self::FORMULA_CLOSE_MATRIX_BRACE];
+ static $matrixReplaceTo = ['MKMATRIX(MKMATRIX(', '),MKMATRIX(', '))'];
+
+ // Convert any Excel matrix references to the MKMATRIX() function
+ if (str_contains($formula, self::FORMULA_OPEN_MATRIX_BRACE)) {
+ // If there is the possibility of braces within a quoted string, then we don't treat those as matrix indicators
+ if (str_contains($formula, self::FORMULA_STRING_QUOTE)) {
+ // So instead we skip replacing in any quoted strings by only replacing in every other array element after we've exploded
+ // the formula
+ $temp = explode(self::FORMULA_STRING_QUOTE, $formula);
+ // Open and Closed counts used for trapping mismatched braces in the formula
+ $openCount = $closeCount = 0;
+ $notWithinQuotes = false;
+ foreach ($temp as &$value) {
+ // Only count/replace in alternating array entries
+ $notWithinQuotes = $notWithinQuotes === false;
+ if ($notWithinQuotes === true) {
+ $openCount += substr_count($value, self::FORMULA_OPEN_MATRIX_BRACE);
+ $closeCount += substr_count($value, self::FORMULA_CLOSE_MATRIX_BRACE);
+ $value = str_replace($matrixReplaceFrom, $matrixReplaceTo, $value);
+ }
+ }
+ unset($value);
+ // Then rebuild the formula string
+ $formula = implode(self::FORMULA_STRING_QUOTE, $temp);
+ } else {
+ // If there's no quoted strings, then we do a simple count/replace
+ $openCount = substr_count($formula, self::FORMULA_OPEN_MATRIX_BRACE);
+ $closeCount = substr_count($formula, self::FORMULA_CLOSE_MATRIX_BRACE);
+ $formula = str_replace($matrixReplaceFrom, $matrixReplaceTo, $formula);
+ }
+ // Trap for mismatched braces and trigger an appropriate error
+ if ($openCount < $closeCount) {
+ if ($openCount > 0) {
+ return $this->raiseFormulaError("Formula Error: Mismatched matrix braces '}'");
+ }
+
+ return $this->raiseFormulaError("Formula Error: Unexpected '}' encountered");
+ } elseif ($openCount > $closeCount) {
+ if ($closeCount > 0) {
+ return $this->raiseFormulaError("Formula Error: Mismatched matrix braces '{'");
+ }
+
+ return $this->raiseFormulaError("Formula Error: Unexpected '{' encountered");
+ }
+ }
+
+ return $formula;
+ }
+
+ /**
+ * Binary Operators.
+ * These operators always work on two values.
+ * Array key is the operator, the value indicates whether this is a left or right associative operator.
+ */
+ private static array $operatorAssociativity = [
+ '^' => 0, // Exponentiation
+ '*' => 0, '/' => 0, // Multiplication and Division
+ '+' => 0, '-' => 0, // Addition and Subtraction
+ '&' => 0, // Concatenation
+ '∪' => 0, '∩' => 0, ':' => 0, // Union, Intersect and Range
+ '>' => 0, '<' => 0, '=' => 0, '>=' => 0, '<=' => 0, '<>' => 0, // Comparison
+ ];
+
+ /**
+ * Comparison (Boolean) Operators.
+ * These operators work on two values, but always return a boolean result.
+ */
+ private static array $comparisonOperators = ['>' => true, '<' => true, '=' => true, '>=' => true, '<=' => true, '<>' => true];
+
+ /**
+ * Operator Precedence.
+ * This list includes all valid operators, whether binary (including boolean) or unary (such as %).
+ * Array key is the operator, the value is its precedence.
+ */
+ private static array $operatorPrecedence = [
+ ':' => 9, // Range
+ '∩' => 8, // Intersect
+ '∪' => 7, // Union
+ '~' => 6, // Negation
+ '%' => 5, // Percentage
+ '^' => 4, // Exponentiation
+ '*' => 3, '/' => 3, // Multiplication and Division
+ '+' => 2, '-' => 2, // Addition and Subtraction
+ '&' => 1, // Concatenation
+ '>' => 0, '<' => 0, '=' => 0, '>=' => 0, '<=' => 0, '<>' => 0, // Comparison
+ ];
+
+ // Convert infix to postfix notation
+
+ /**
+ * @return array|false
+ */
+ private function internalParseFormula(string $formula, ?Cell $cell = null): bool|array
+ {
+ if (($formula = $this->convertMatrixReferences(trim($formula))) === false) {
+ return false;
+ }
+
+ // If we're using cell caching, then $pCell may well be flushed back to the cache (which detaches the parent worksheet),
+ // so we store the parent worksheet so that we can re-attach it when necessary
+ $pCellParent = ($cell !== null) ? $cell->getWorksheet() : null;
+
+ $regexpMatchString = '/^((?' . self::CALCULATION_REGEXP_STRING
+ . ')|(?' . self::CALCULATION_REGEXP_FUNCTION
+ . ')|(?' . self::CALCULATION_REGEXP_CELLREF
+ . ')|(?' . self::CALCULATION_REGEXP_COLUMN_RANGE
+ . ')|(?' . self::CALCULATION_REGEXP_ROW_RANGE
+ . ')|(?' . self::CALCULATION_REGEXP_NUMBER
+ . ')|(?' . self::CALCULATION_REGEXP_OPENBRACE
+ . ')|(?' . self::CALCULATION_REGEXP_STRUCTURED_REFERENCE
+ . ')|(?' . self::CALCULATION_REGEXP_DEFINEDNAME
+ . ')|(?' . self::CALCULATION_REGEXP_ERROR
+ . '))/sui';
+
+ // Start with initialisation
+ $index = 0;
+ $stack = new Stack($this->branchPruner);
+ $output = [];
+ $expectingOperator = false; // We use this test in syntax-checking the expression to determine when a
+ // - is a negation or + is a positive operator rather than an operation
+ $expectingOperand = false; // We use this test in syntax-checking the expression to determine whether an operand
+ // should be null in a function call
+
+ // The guts of the lexical parser
+ // Loop through the formula extracting each operator and operand in turn
+ while (true) {
+ // Branch pruning: we adapt the output item to the context (it will
+ // be used to limit its computation)
+ $this->branchPruner->initialiseForLoop();
+
+ $opCharacter = $formula[$index]; // Get the first character of the value at the current index position
+
+ // Check for two-character operators (e.g. >=, <=, <>)
+ if ((isset(self::$comparisonOperators[$opCharacter])) && (strlen($formula) > $index) && isset($formula[$index + 1], self::$comparisonOperators[$formula[$index + 1]])) {
+ $opCharacter .= $formula[++$index];
+ }
+ // Find out if we're currently at the beginning of a number, variable, cell/row/column reference,
+ // function, defined name, structured reference, parenthesis, error or operand
+ $isOperandOrFunction = (bool) preg_match($regexpMatchString, substr($formula, $index), $match);
+
+ $expectingOperatorCopy = $expectingOperator;
+ if ($opCharacter === '-' && !$expectingOperator) { // Is it a negation instead of a minus?
+ // Put a negation on the stack
+ $stack->push('Unary Operator', '~');
+ ++$index; // and drop the negation symbol
+ } elseif ($opCharacter === '%' && $expectingOperator) {
+ // Put a percentage on the stack
+ $stack->push('Unary Operator', '%');
+ ++$index;
+ } elseif ($opCharacter === '+' && !$expectingOperator) { // Positive (unary plus rather than binary operator plus) can be discarded?
+ ++$index; // Drop the redundant plus symbol
+ } elseif ((($opCharacter === '~') || ($opCharacter === '∩') || ($opCharacter === '∪')) && (!$isOperandOrFunction)) {
+ // We have to explicitly deny a tilde, union or intersect because they are legal
+ return $this->raiseFormulaError("Formula Error: Illegal character '~'"); // on the stack but not in the input expression
+ } elseif ((isset(self::CALCULATION_OPERATORS[$opCharacter]) || $isOperandOrFunction) && $expectingOperator) { // Are we putting an operator on the stack?
+ while (
+ $stack->count() > 0
+ && ($o2 = $stack->last())
+ && isset(self::CALCULATION_OPERATORS[$o2['value']])
+ && @(self::$operatorAssociativity[$opCharacter] ? self::$operatorPrecedence[$opCharacter] < self::$operatorPrecedence[$o2['value']] : self::$operatorPrecedence[$opCharacter] <= self::$operatorPrecedence[$o2['value']])
+ ) {
+ $output[] = $stack->pop(); // Swap operands and higher precedence operators from the stack to the output
+ }
+
+ // Finally put our current operator onto the stack
+ $stack->push('Binary Operator', $opCharacter);
+
+ ++$index;
+ $expectingOperator = false;
+ } elseif ($opCharacter === ')' && $expectingOperator) { // Are we expecting to close a parenthesis?
+ $expectingOperand = false;
+ while (($o2 = $stack->pop()) && $o2['value'] !== '(') { // Pop off the stack back to the last (
+ $output[] = $o2;
+ }
+ $d = $stack->last(2);
+
+ // Branch pruning we decrease the depth whether is it a function
+ // call or a parenthesis
+ $this->branchPruner->decrementDepth();
+
+ if (is_array($d) && preg_match('/^' . self::CALCULATION_REGEXP_FUNCTION . '$/miu', $d['value'], $matches)) {
+ // Did this parenthesis just close a function?
+ try {
+ $this->branchPruner->closingBrace($d['value']);
+ } catch (Exception $e) {
+ return $this->raiseFormulaError($e->getMessage(), $e->getCode(), $e);
+ }
+
+ $functionName = $matches[1]; // Get the function name
+ $d = $stack->pop();
+ $argumentCount = $d['value'] ?? 0; // See how many arguments there were (argument count is the next value stored on the stack)
+ $output[] = $d; // Dump the argument count on the output
+ $output[] = $stack->pop(); // Pop the function and push onto the output
+ if (isset(self::$controlFunctions[$functionName])) {
+ $expectedArgumentCount = self::$controlFunctions[$functionName]['argumentCount'];
+ } elseif (isset(self::$phpSpreadsheetFunctions[$functionName])) {
+ $expectedArgumentCount = self::$phpSpreadsheetFunctions[$functionName]['argumentCount'];
+ } else { // did we somehow push a non-function on the stack? this should never happen
+ return $this->raiseFormulaError('Formula Error: Internal error, non-function on stack');
+ }
+ // Check the argument count
+ $argumentCountError = false;
+ $expectedArgumentCountString = null;
+ if (is_numeric($expectedArgumentCount)) {
+ if ($expectedArgumentCount < 0) {
+ if ($argumentCount > abs($expectedArgumentCount)) {
+ $argumentCountError = true;
+ $expectedArgumentCountString = 'no more than ' . abs($expectedArgumentCount);
+ }
+ } else {
+ if ($argumentCount != $expectedArgumentCount) {
+ $argumentCountError = true;
+ $expectedArgumentCountString = $expectedArgumentCount;
+ }
+ }
+ } elseif ($expectedArgumentCount != '*') {
+ preg_match('/(\d*)([-+,])(\d*)/', $expectedArgumentCount, $argMatch);
+ switch ($argMatch[2] ?? '') {
+ case '+':
+ if ($argumentCount < $argMatch[1]) {
+ $argumentCountError = true;
+ $expectedArgumentCountString = $argMatch[1] . ' or more ';
+ }
+
+ break;
+ case '-':
+ if (($argumentCount < $argMatch[1]) || ($argumentCount > $argMatch[3])) {
+ $argumentCountError = true;
+ $expectedArgumentCountString = 'between ' . $argMatch[1] . ' and ' . $argMatch[3];
+ }
+
+ break;
+ case ',':
+ if (($argumentCount != $argMatch[1]) && ($argumentCount != $argMatch[3])) {
+ $argumentCountError = true;
+ $expectedArgumentCountString = 'either ' . $argMatch[1] . ' or ' . $argMatch[3];
+ }
+
+ break;
+ }
+ }
+ if ($argumentCountError) {
+ return $this->raiseFormulaError("Formula Error: Wrong number of arguments for $functionName() function: $argumentCount given, " . $expectedArgumentCountString . ' expected');
+ }
+ }
+ ++$index;
+ } elseif ($opCharacter === ',') { // Is this the separator for function arguments?
+ try {
+ $this->branchPruner->argumentSeparator();
+ } catch (Exception $e) {
+ return $this->raiseFormulaError($e->getMessage(), $e->getCode(), $e);
+ }
+
+ while (($o2 = $stack->pop()) && $o2['value'] !== '(') { // Pop off the stack back to the last (
+ $output[] = $o2; // pop the argument expression stuff and push onto the output
+ }
+ // If we've a comma when we're expecting an operand, then what we actually have is a null operand;
+ // so push a null onto the stack
+ if (($expectingOperand) || (!$expectingOperator)) {
+ $output[] = $stack->getStackItem('Empty Argument', null, 'NULL');
+ }
+ // make sure there was a function
+ $d = $stack->last(2);
+ if (!preg_match('/^' . self::CALCULATION_REGEXP_FUNCTION . '$/miu', $d['value'] ?? '', $matches)) {
+ // Can we inject a dummy function at this point so that the braces at least have some context
+ // because at least the braces are paired up (at this stage in the formula)
+ // MS Excel allows this if the content is cell references; but doesn't allow actual values,
+ // but at this point, we can't differentiate (so allow both)
+ return $this->raiseFormulaError('Formula Error: Unexpected ,');
+ }
+
+ /** @var array $d */
+ $d = $stack->pop();
+ ++$d['value']; // increment the argument count
+
+ $stack->pushStackItem($d);
+ $stack->push('Brace', '('); // put the ( back on, we'll need to pop back to it again
+
+ $expectingOperator = false;
+ $expectingOperand = true;
+ ++$index;
+ } elseif ($opCharacter === '(' && !$expectingOperator) {
+ // Branch pruning: we go deeper
+ $this->branchPruner->incrementDepth();
+ $stack->push('Brace', '(', null);
+ ++$index;
+ } elseif ($isOperandOrFunction && !$expectingOperatorCopy) {
+ // do we now have a function/variable/number?
+ $expectingOperator = true;
+ $expectingOperand = false;
+ $val = $match[1];
+ $length = strlen($val);
+
+ if (preg_match('/^' . self::CALCULATION_REGEXP_FUNCTION . '$/miu', $val, $matches)) {
+ $val = (string) preg_replace('/\s/u', '', $val);
+ if (isset(self::$phpSpreadsheetFunctions[strtoupper($matches[1])]) || isset(self::$controlFunctions[strtoupper($matches[1])])) { // it's a function
+ $valToUpper = strtoupper($val);
+ } else {
+ $valToUpper = 'NAME.ERROR(';
+ }
+ // here $matches[1] will contain values like "IF"
+ // and $val "IF("
+
+ $this->branchPruner->functionCall($valToUpper);
+
+ $stack->push('Function', $valToUpper);
+ // tests if the function is closed right after opening
+ $ax = preg_match('/^\s*\)/u', substr($formula, $index + $length));
+ if ($ax) {
+ $stack->push('Operand Count for Function ' . $valToUpper . ')', 0);
+ $expectingOperator = true;
+ } else {
+ $stack->push('Operand Count for Function ' . $valToUpper . ')', 1);
+ $expectingOperator = false;
+ }
+ $stack->push('Brace', '(');
+ } elseif (preg_match('/^' . self::CALCULATION_REGEXP_CELLREF . '$/miu', $val, $matches)) {
+ // Watch for this case-change when modifying to allow cell references in different worksheets...
+ // Should only be applied to the actual cell column, not the worksheet name
+ // If the last entry on the stack was a : operator, then we have a cell range reference
+ $testPrevOp = $stack->last(1);
+ if ($testPrevOp !== null && $testPrevOp['value'] === ':') {
+ // If we have a worksheet reference, then we're playing with a 3D reference
+ if ($matches[2] === '') {
+ // Otherwise, we 'inherit' the worksheet reference from the start cell reference
+ // The start of the cell range reference should be the last entry in $output
+ $rangeStartCellRef = $output[count($output) - 1]['value'] ?? '';
+ if ($rangeStartCellRef === ':') {
+ // Do we have chained range operators?
+ $rangeStartCellRef = $output[count($output) - 2]['value'] ?? '';
+ }
+ preg_match('/^' . self::CALCULATION_REGEXP_CELLREF . '$/miu', $rangeStartCellRef, $rangeStartMatches);
+ if (array_key_exists(2, $rangeStartMatches)) {
+ if ($rangeStartMatches[2] > '') {
+ $val = $rangeStartMatches[2] . '!' . $val;
+ }
+ } else {
+ $val = ExcelError::REF();
+ }
+ } else {
+ $rangeStartCellRef = $output[count($output) - 1]['value'] ?? '';
+ if ($rangeStartCellRef === ':') {
+ // Do we have chained range operators?
+ $rangeStartCellRef = $output[count($output) - 2]['value'] ?? '';
+ }
+ preg_match('/^' . self::CALCULATION_REGEXP_CELLREF . '$/miu', $rangeStartCellRef, $rangeStartMatches);
+ if ($rangeStartMatches[2] !== $matches[2]) {
+ return $this->raiseFormulaError('3D Range references are not yet supported');
+ }
+ }
+ } elseif (!str_contains($val, '!') && $pCellParent !== null) {
+ $worksheet = $pCellParent->getTitle();
+ $val = "'{$worksheet}'!{$val}";
+ }
+ // unescape any apostrophes or double quotes in worksheet name
+ $val = str_replace(["''", '""'], ["'", '"'], $val);
+ $outputItem = $stack->getStackItem('Cell Reference', $val, $val);
+
+ $output[] = $outputItem;
+ } elseif (preg_match('/^' . self::CALCULATION_REGEXP_STRUCTURED_REFERENCE . '$/miu', $val, $matches)) {
+ try {
+ $structuredReference = Operands\StructuredReference::fromParser($formula, $index, $matches);
+ } catch (Exception $e) {
+ return $this->raiseFormulaError($e->getMessage(), $e->getCode(), $e);
+ }
+
+ $val = $structuredReference->value();
+ $length = strlen($val);
+ $outputItem = $stack->getStackItem(Operands\StructuredReference::NAME, $structuredReference, null);
+
+ $output[] = $outputItem;
+ $expectingOperator = true;
+ } else {
+ // it's a variable, constant, string, number or boolean
+ $localeConstant = false;
+ $stackItemType = 'Value';
+ $stackItemReference = null;
+
+ // If the last entry on the stack was a : operator, then we may have a row or column range reference
+ $testPrevOp = $stack->last(1);
+ if ($testPrevOp !== null && $testPrevOp['value'] === ':') {
+ $stackItemType = 'Cell Reference';
+
+ if (
+ !is_numeric($val)
+ && ((ctype_alpha($val) === false || strlen($val) > 3))
+ && (preg_match('/^' . self::CALCULATION_REGEXP_DEFINEDNAME . '$/mui', $val) !== false)
+ && ($this->spreadsheet === null || $this->spreadsheet->getNamedRange($val) !== null)
+ ) {
+ $namedRange = ($this->spreadsheet === null) ? null : $this->spreadsheet->getNamedRange($val);
+ if ($namedRange !== null) {
+ $stackItemType = 'Defined Name';
+ $address = str_replace('$', '', $namedRange->getValue());
+ $stackItemReference = $val;
+ if (str_contains($address, ':')) {
+ // We'll need to manipulate the stack for an actual named range rather than a named cell
+ $fromTo = explode(':', $address);
+ $to = array_pop($fromTo);
+ foreach ($fromTo as $from) {
+ $output[] = $stack->getStackItem($stackItemType, $from, $stackItemReference);
+ $output[] = $stack->getStackItem('Binary Operator', ':');
+ }
+ $address = $to;
+ }
+ $val = $address;
+ }
+ } elseif ($val === ExcelError::REF()) {
+ $stackItemReference = $val;
+ } else {
+ /** @var non-empty-string $startRowColRef */
+ $startRowColRef = $output[count($output) - 1]['value'] ?? '';
+ [$rangeWS1, $startRowColRef] = Worksheet::extractSheetTitle($startRowColRef, true);
+ $rangeSheetRef = $rangeWS1;
+ if ($rangeWS1 !== '') {
+ $rangeWS1 .= '!';
+ }
+ $rangeSheetRef = trim($rangeSheetRef, "'");
+ [$rangeWS2, $val] = Worksheet::extractSheetTitle($val, true);
+ if ($rangeWS2 !== '') {
+ $rangeWS2 .= '!';
+ } else {
+ $rangeWS2 = $rangeWS1;
+ }
+
+ $refSheet = $pCellParent;
+ if ($pCellParent !== null && $rangeSheetRef !== '' && $rangeSheetRef !== $pCellParent->getTitle()) {
+ $refSheet = $pCellParent->getParentOrThrow()->getSheetByName($rangeSheetRef);
+ }
+
+ if (ctype_digit($val) && $val <= 1048576) {
+ // Row range
+ $stackItemType = 'Row Reference';
+ /** @var int $valx */
+ $valx = $val;
+ $endRowColRef = ($refSheet !== null) ? $refSheet->getHighestDataColumn($valx) : AddressRange::MAX_COLUMN; // Max 16,384 columns for Excel2007
+ $val = "{$rangeWS2}{$endRowColRef}{$val}";
+ } elseif (ctype_alpha($val) && strlen($val ?? '') <= 3) {
+ // Column range
+ $stackItemType = 'Column Reference';
+ $endRowColRef = ($refSheet !== null) ? $refSheet->getHighestDataRow($val) : AddressRange::MAX_ROW; // Max 1,048,576 rows for Excel2007
+ $val = "{$rangeWS2}{$val}{$endRowColRef}";
+ }
+ $stackItemReference = $val;
+ }
+ } elseif ($opCharacter === self::FORMULA_STRING_QUOTE) {
+ // UnEscape any quotes within the string
+ $val = self::wrapResult(str_replace('""', self::FORMULA_STRING_QUOTE, self::unwrapResult($val)));
+ } elseif (isset(self::$excelConstants[trim(strtoupper($val))])) {
+ $stackItemType = 'Constant';
+ $excelConstant = trim(strtoupper($val));
+ $val = self::$excelConstants[$excelConstant];
+ $stackItemReference = $excelConstant;
+ } elseif (($localeConstant = array_search(trim(strtoupper($val)), self::$localeBoolean)) !== false) {
+ $stackItemType = 'Constant';
+ $val = self::$excelConstants[$localeConstant];
+ $stackItemReference = $localeConstant;
+ } elseif (
+ preg_match('/^' . self::CALCULATION_REGEXP_ROW_RANGE . '/miu', substr($formula, $index), $rowRangeReference)
+ ) {
+ $val = $rowRangeReference[1];
+ $length = strlen($rowRangeReference[1]);
+ $stackItemType = 'Row Reference';
+ // unescape any apostrophes or double quotes in worksheet name
+ $val = str_replace(["''", '""'], ["'", '"'], $val);
+ $column = 'A';
+ if (($testPrevOp !== null && $testPrevOp['value'] === ':') && $pCellParent !== null) {
+ $column = $pCellParent->getHighestDataColumn($val);
+ }
+ $val = "{$rowRangeReference[2]}{$column}{$rowRangeReference[7]}";
+ $stackItemReference = $val;
+ } elseif (
+ preg_match('/^' . self::CALCULATION_REGEXP_COLUMN_RANGE . '/miu', substr($formula, $index), $columnRangeReference)
+ ) {
+ $val = $columnRangeReference[1];
+ $length = strlen($val);
+ $stackItemType = 'Column Reference';
+ // unescape any apostrophes or double quotes in worksheet name
+ $val = str_replace(["''", '""'], ["'", '"'], $val);
+ $row = '1';
+ if (($testPrevOp !== null && $testPrevOp['value'] === ':') && $pCellParent !== null) {
+ $row = $pCellParent->getHighestDataRow($val);
+ }
+ $val = "{$val}{$row}";
+ $stackItemReference = $val;
+ } elseif (preg_match('/^' . self::CALCULATION_REGEXP_DEFINEDNAME . '.*/miu', $val, $match)) {
+ $stackItemType = 'Defined Name';
+ $stackItemReference = $val;
+ } elseif (is_numeric($val)) {
+ if ((str_contains((string) $val, '.')) || (stripos((string) $val, 'e') !== false) || ($val > PHP_INT_MAX) || ($val < -PHP_INT_MAX)) {
+ $val = (float) $val;
+ } else {
+ $val = (int) $val;
+ }
+ }
+
+ $details = $stack->getStackItem($stackItemType, $val, $stackItemReference);
+ if ($localeConstant) {
+ $details['localeValue'] = $localeConstant;
+ }
+ $output[] = $details;
+ }
+ $index += $length;
+ } elseif ($opCharacter === '$') { // absolute row or column range
+ ++$index;
+ } elseif ($opCharacter === ')') { // miscellaneous error checking
+ if ($expectingOperand) {
+ $output[] = $stack->getStackItem('Empty Argument', null, 'NULL');
+ $expectingOperand = false;
+ $expectingOperator = true;
+ } else {
+ return $this->raiseFormulaError("Formula Error: Unexpected ')'");
+ }
+ } elseif (isset(self::CALCULATION_OPERATORS[$opCharacter]) && !$expectingOperator) {
+ return $this->raiseFormulaError("Formula Error: Unexpected operator '$opCharacter'");
+ } else { // I don't even want to know what you did to get here
+ return $this->raiseFormulaError('Formula Error: An unexpected error occurred');
+ }
+ // Test for end of formula string
+ if ($index == strlen($formula)) {
+ // Did we end with an operator?.
+ // Only valid for the % unary operator
+ if ((isset(self::CALCULATION_OPERATORS[$opCharacter])) && ($opCharacter != '%')) {
+ return $this->raiseFormulaError("Formula Error: Operator '$opCharacter' has no operands");
+ }
+
+ break;
+ }
+ // Ignore white space
+ while (($formula[$index] === "\n") || ($formula[$index] === "\r")) {
+ ++$index;
+ }
+
+ if ($formula[$index] === ' ') {
+ while ($formula[$index] === ' ') {
+ ++$index;
+ }
+
+ // If we're expecting an operator, but only have a space between the previous and next operands (and both are
+ // Cell References, Defined Names or Structured References) then we have an INTERSECTION operator
+ $countOutputMinus1 = count($output) - 1;
+ if (
+ ($expectingOperator)
+ && array_key_exists($countOutputMinus1, $output)
+ && is_array($output[$countOutputMinus1])
+ && array_key_exists('type', $output[$countOutputMinus1])
+ && (
+ (preg_match('/^' . self::CALCULATION_REGEXP_CELLREF . '.*/miu', substr($formula, $index), $match))
+ && ($output[$countOutputMinus1]['type'] === 'Cell Reference')
+ || (preg_match('/^' . self::CALCULATION_REGEXP_DEFINEDNAME . '.*/miu', substr($formula, $index), $match))
+ && ($output[$countOutputMinus1]['type'] === 'Defined Name' || $output[$countOutputMinus1]['type'] === 'Value')
+ || (preg_match('/^' . self::CALCULATION_REGEXP_STRUCTURED_REFERENCE . '.*/miu', substr($formula, $index), $match))
+ && ($output[$countOutputMinus1]['type'] === Operands\StructuredReference::NAME || $output[$countOutputMinus1]['type'] === 'Value')
+ )
+ ) {
+ while (
+ $stack->count() > 0
+ && ($o2 = $stack->last())
+ && isset(self::CALCULATION_OPERATORS[$o2['value']])
+ && @(self::$operatorAssociativity[$opCharacter] ? self::$operatorPrecedence[$opCharacter] < self::$operatorPrecedence[$o2['value']] : self::$operatorPrecedence[$opCharacter] <= self::$operatorPrecedence[$o2['value']])
+ ) {
+ $output[] = $stack->pop(); // Swap operands and higher precedence operators from the stack to the output
+ }
+ $stack->push('Binary Operator', '∩'); // Put an Intersect Operator on the stack
+ $expectingOperator = false;
+ }
+ }
+ }
+
+ while (($op = $stack->pop()) !== null) {
+ // pop everything off the stack and push onto output
+ if ((is_array($op) && $op['value'] == '(')) {
+ return $this->raiseFormulaError("Formula Error: Expecting ')'"); // if there are any opening braces on the stack, then braces were unbalanced
+ }
+ $output[] = $op;
+ }
+
+ return $output;
+ }
+
+ private static function dataTestReference(array &$operandData): mixed
+ {
+ $operand = $operandData['value'];
+ if (($operandData['reference'] === null) && (is_array($operand))) {
+ $rKeys = array_keys($operand);
+ $rowKey = array_shift($rKeys);
+ if (is_array($operand[$rowKey]) === false) {
+ $operandData['value'] = $operand[$rowKey];
+
+ return $operand[$rowKey];
+ }
+
+ $cKeys = array_keys(array_keys($operand[$rowKey]));
+ $colKey = array_shift($cKeys);
+ if (ctype_upper("$colKey")) {
+ $operandData['reference'] = $colKey . $rowKey;
+ }
+ }
+
+ return $operand;
+ }
+
+ /**
+ * @return array|false
+ */
+ private function processTokenStack(mixed $tokens, ?string $cellID = null, ?Cell $cell = null)
+ {
+ if ($tokens === false) {
+ return false;
+ }
+
+ // If we're using cell caching, then $pCell may well be flushed back to the cache (which detaches the parent cell collection),
+ // so we store the parent cell collection so that we can re-attach it when necessary
+ $pCellWorksheet = ($cell !== null) ? $cell->getWorksheet() : null;
+ $pCellParent = ($cell !== null) ? $cell->getParent() : null;
+ $stack = new Stack($this->branchPruner);
+
+ // Stores branches that have been pruned
+ $fakedForBranchPruning = [];
+ // help us to know when pruning ['branchTestId' => true/false]
+ $branchStore = [];
+ // Loop through each token in turn
+ foreach ($tokens as $tokenData) {
+ $token = $tokenData['value'];
+ // Branch pruning: skip useless resolutions
+ $storeKey = $tokenData['storeKey'] ?? null;
+ if ($this->branchPruningEnabled && isset($tokenData['onlyIf'])) {
+ $onlyIfStoreKey = $tokenData['onlyIf'];
+ $storeValue = $branchStore[$onlyIfStoreKey] ?? null;
+ $storeValueAsBool = ($storeValue === null)
+ ? true : (bool) Functions::flattenSingleValue($storeValue);
+ if (is_array($storeValue)) {
+ $wrappedItem = end($storeValue);
+ $storeValue = is_array($wrappedItem) ? end($wrappedItem) : $wrappedItem;
+ }
+
+ if (
+ (isset($storeValue) || $tokenData['reference'] === 'NULL')
+ && (!$storeValueAsBool || Information\ErrorValue::isError($storeValue) || ($storeValue === 'Pruned branch'))
+ ) {
+ // If branching value is not true, we don't need to compute
+ if (!isset($fakedForBranchPruning['onlyIf-' . $onlyIfStoreKey])) {
+ $stack->push('Value', 'Pruned branch (only if ' . $onlyIfStoreKey . ') ' . $token);
+ $fakedForBranchPruning['onlyIf-' . $onlyIfStoreKey] = true;
+ }
+
+ if (isset($storeKey)) {
+ // We are processing an if condition
+ // We cascade the pruning to the depending branches
+ $branchStore[$storeKey] = 'Pruned branch';
+ $fakedForBranchPruning['onlyIfNot-' . $storeKey] = true;
+ $fakedForBranchPruning['onlyIf-' . $storeKey] = true;
+ }
+
+ continue;
+ }
+ }
+
+ if ($this->branchPruningEnabled && isset($tokenData['onlyIfNot'])) {
+ $onlyIfNotStoreKey = $tokenData['onlyIfNot'];
+ $storeValue = $branchStore[$onlyIfNotStoreKey] ?? null;
+ $storeValueAsBool = ($storeValue === null)
+ ? true : (bool) Functions::flattenSingleValue($storeValue);
+ if (is_array($storeValue)) {
+ $wrappedItem = end($storeValue);
+ $storeValue = is_array($wrappedItem) ? end($wrappedItem) : $wrappedItem;
+ }
+
+ if (
+ (isset($storeValue) || $tokenData['reference'] === 'NULL')
+ && ($storeValueAsBool || Information\ErrorValue::isError($storeValue) || ($storeValue === 'Pruned branch'))
+ ) {
+ // If branching value is true, we don't need to compute
+ if (!isset($fakedForBranchPruning['onlyIfNot-' . $onlyIfNotStoreKey])) {
+ $stack->push('Value', 'Pruned branch (only if not ' . $onlyIfNotStoreKey . ') ' . $token);
+ $fakedForBranchPruning['onlyIfNot-' . $onlyIfNotStoreKey] = true;
+ }
+
+ if (isset($storeKey)) {
+ // We are processing an if condition
+ // We cascade the pruning to the depending branches
+ $branchStore[$storeKey] = 'Pruned branch';
+ $fakedForBranchPruning['onlyIfNot-' . $storeKey] = true;
+ $fakedForBranchPruning['onlyIf-' . $storeKey] = true;
+ }
+
+ continue;
+ }
+ }
+
+ if ($token instanceof Operands\StructuredReference) {
+ if ($cell === null) {
+ return $this->raiseFormulaError('Structured References must exist in a Cell context');
+ }
+
+ try {
+ $cellRange = $token->parse($cell);
+ if (str_contains($cellRange, ':')) {
+ $this->debugLog->writeDebugLog('Evaluating Structured Reference %s as Cell Range %s', $token->value(), $cellRange);
+ $rangeValue = self::getInstance($cell->getWorksheet()->getParent())->_calculateFormulaValue("={$cellRange}", $cellRange, $cell);
+ $stack->push('Value', $rangeValue);
+ $this->debugLog->writeDebugLog('Evaluated Structured Reference %s as value %s', $token->value(), $this->showValue($rangeValue));
+ } else {
+ $this->debugLog->writeDebugLog('Evaluating Structured Reference %s as Cell %s', $token->value(), $cellRange);
+ $cellValue = $cell->getWorksheet()->getCell($cellRange)->getCalculatedValue(false);
+ $stack->push('Cell Reference', $cellValue, $cellRange);
+ $this->debugLog->writeDebugLog('Evaluated Structured Reference %s as value %s', $token->value(), $this->showValue($cellValue));
+ }
+ } catch (Exception $e) {
+ if ($e->getCode() === Exception::CALCULATION_ENGINE_PUSH_TO_STACK) {
+ $stack->push('Error', ExcelError::REF(), null);
+ $this->debugLog->writeDebugLog('Evaluated Structured Reference %s as error value %s', $token->value(), ExcelError::REF());
+ } else {
+ return $this->raiseFormulaError($e->getMessage(), $e->getCode(), $e);
+ }
+ }
+ } elseif (!is_numeric($token) && !is_object($token) && isset(self::BINARY_OPERATORS[$token])) {
+ // if the token is a binary operator, pop the top two values off the stack, do the operation, and push the result back on the stack
+ // We must have two operands, error if we don't
+ $operand2Data = $stack->pop();
+ if ($operand2Data === null) {
+ return $this->raiseFormulaError('Internal error - Operand value missing from stack');
+ }
+ $operand1Data = $stack->pop();
+ if ($operand1Data === null) {
+ return $this->raiseFormulaError('Internal error - Operand value missing from stack');
+ }
+
+ $operand1 = self::dataTestReference($operand1Data);
+ $operand2 = self::dataTestReference($operand2Data);
+
+ // Log what we're doing
+ if ($token == ':') {
+ $this->debugLog->writeDebugLog('Evaluating Range %s %s %s', $this->showValue($operand1Data['reference']), $token, $this->showValue($operand2Data['reference']));
+ } else {
+ $this->debugLog->writeDebugLog('Evaluating %s %s %s', $this->showValue($operand1), $token, $this->showValue($operand2));
+ }
+
+ // Process the operation in the appropriate manner
+ switch ($token) {
+ // Comparison (Boolean) Operators
+ case '>': // Greater than
+ case '<': // Less than
+ case '>=': // Greater than or Equal to
+ case '<=': // Less than or Equal to
+ case '=': // Equality
+ case '<>': // Inequality
+ $result = $this->executeBinaryComparisonOperation($operand1, $operand2, (string) $token, $stack);
+ if (isset($storeKey)) {
+ $branchStore[$storeKey] = $result;
+ }
+
+ break;
+ // Binary Operators
+ case ':': // Range
+ if ($operand1Data['type'] === 'Defined Name') {
+ if (preg_match('/$' . self::CALCULATION_REGEXP_DEFINEDNAME . '^/mui', $operand1Data['reference']) !== false && $this->spreadsheet !== null) {
+ $definedName = $this->spreadsheet->getNamedRange($operand1Data['reference']);
+ if ($definedName !== null) {
+ $operand1Data['reference'] = $operand1Data['value'] = str_replace('$', '', $definedName->getValue());
+ }
+ }
+ }
+ if (str_contains($operand1Data['reference'] ?? '', '!')) {
+ [$sheet1, $operand1Data['reference']] = Worksheet::extractSheetTitle($operand1Data['reference'], true);
+ } else {
+ $sheet1 = ($pCellWorksheet !== null) ? $pCellWorksheet->getTitle() : '';
+ }
+ $sheet1 ??= '';
+
+ [$sheet2, $operand2Data['reference']] = Worksheet::extractSheetTitle($operand2Data['reference'], true);
+ if (empty($sheet2)) {
+ $sheet2 = $sheet1;
+ }
+
+ if (trim($sheet1, "'") === trim($sheet2, "'")) {
+ if ($operand1Data['reference'] === null && $cell !== null) {
+ if (is_array($operand1Data['value'])) {
+ $operand1Data['reference'] = $cell->getCoordinate();
+ } elseif ((trim($operand1Data['value']) != '') && (is_numeric($operand1Data['value']))) {
+ $operand1Data['reference'] = $cell->getColumn() . $operand1Data['value'];
+ } elseif (trim($operand1Data['value']) == '') {
+ $operand1Data['reference'] = $cell->getCoordinate();
+ } else {
+ $operand1Data['reference'] = $operand1Data['value'] . $cell->getRow();
+ }
+ }
+ if ($operand2Data['reference'] === null && $cell !== null) {
+ if (is_array($operand2Data['value'])) {
+ $operand2Data['reference'] = $cell->getCoordinate();
+ } elseif ((trim($operand2Data['value']) != '') && (is_numeric($operand2Data['value']))) {
+ $operand2Data['reference'] = $cell->getColumn() . $operand2Data['value'];
+ } elseif (trim($operand2Data['value']) == '') {
+ $operand2Data['reference'] = $cell->getCoordinate();
+ } else {
+ $operand2Data['reference'] = $operand2Data['value'] . $cell->getRow();
+ }
+ }
+
+ $oData = array_merge(explode(':', $operand1Data['reference'] ?? ''), explode(':', $operand2Data['reference'] ?? ''));
+ $oCol = $oRow = [];
+ $breakNeeded = false;
+ foreach ($oData as $oDatum) {
+ try {
+ $oCR = Coordinate::coordinateFromString($oDatum);
+ $oCol[] = Coordinate::columnIndexFromString($oCR[0]) - 1;
+ $oRow[] = $oCR[1];
+ } catch (\Exception) {
+ $stack->push('Error', ExcelError::REF(), null);
+ $breakNeeded = true;
+
+ break;
+ }
+ }
+ if ($breakNeeded) {
+ break;
+ }
+ $cellRef = Coordinate::stringFromColumnIndex(min($oCol) + 1) . min($oRow) . ':' . Coordinate::stringFromColumnIndex(max($oCol) + 1) . max($oRow);
+ if ($pCellParent !== null && $this->spreadsheet !== null) {
+ $cellValue = $this->extractCellRange($cellRef, $this->spreadsheet->getSheetByName($sheet1), false);
+ } else {
+ return $this->raiseFormulaError('Unable to access Cell Reference');
+ }
+
+ $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($cellValue));
+ $stack->push('Cell Reference', $cellValue, $cellRef);
+ } else {
+ $this->debugLog->writeDebugLog('Evaluation Result is a #REF! Error');
+ $stack->push('Error', ExcelError::REF(), null);
+ }
+
+ break;
+ case '+': // Addition
+ case '-': // Subtraction
+ case '*': // Multiplication
+ case '/': // Division
+ case '^': // Exponential
+ $result = $this->executeNumericBinaryOperation($operand1, $operand2, $token, $stack);
+ if (isset($storeKey)) {
+ $branchStore[$storeKey] = $result;
+ }
+
+ break;
+ case '&': // Concatenation
+ // If either of the operands is a matrix, we need to treat them both as matrices
+ // (converting the other operand to a matrix if need be); then perform the required
+ // matrix operation
+ $operand1 = self::boolToString($operand1);
+ $operand2 = self::boolToString($operand2);
+ if (is_array($operand1) || is_array($operand2)) {
+ if (is_string($operand1)) {
+ $operand1 = self::unwrapResult($operand1);
+ }
+ if (is_string($operand2)) {
+ $operand2 = self::unwrapResult($operand2);
+ }
+ // Ensure that both operands are arrays/matrices
+ [$rows, $columns] = self::checkMatrixOperands($operand1, $operand2, 2);
+
+ for ($row = 0; $row < $rows; ++$row) {
+ for ($column = 0; $column < $columns; ++$column) {
+ $op1x = self::boolToString($operand1[$row][$column]);
+ $op2x = self::boolToString($operand2[$row][$column]);
+ if (Information\ErrorValue::isError($op1x)) {
+ // no need to do anything
+ } elseif (Information\ErrorValue::isError($op2x)) {
+ $operand1[$row][$column] = $op2x;
+ } else {
+ $operand1[$row][$column]
+ = Shared\StringHelper::substring(
+ $op1x . $op2x,
+ 0,
+ DataType::MAX_STRING_LENGTH
+ );
+ }
+ }
+ }
+ $result = $operand1;
+ } else {
+ // In theory, we should truncate here.
+ // But I can't figure out a formula
+ // using the concatenation operator
+ // with literals that fits in 32K,
+ // so I don't think we can overflow here.
+ if (Information\ErrorValue::isError($operand1)) {
+ $result = $operand1;
+ } elseif (Information\ErrorValue::isError($operand2)) {
+ $result = $operand2;
+ } else {
+ $result = self::FORMULA_STRING_QUOTE . str_replace('""', self::FORMULA_STRING_QUOTE, self::unwrapResult($operand1) . self::unwrapResult($operand2)) . self::FORMULA_STRING_QUOTE;
+ }
+ }
+ $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($result));
+ $stack->push('Value', $result);
+
+ if (isset($storeKey)) {
+ $branchStore[$storeKey] = $result;
+ }
+
+ break;
+ case '∩': // Intersect
+ $rowIntersect = array_intersect_key($operand1, $operand2);
+ $cellIntersect = $oCol = $oRow = [];
+ foreach (array_keys($rowIntersect) as $row) {
+ $oRow[] = $row;
+ foreach ($rowIntersect[$row] as $col => $data) {
+ $oCol[] = Coordinate::columnIndexFromString($col) - 1;
+ $cellIntersect[$row] = array_intersect_key($operand1[$row], $operand2[$row]);
+ }
+ }
+ if (count(Functions::flattenArray($cellIntersect)) === 0) {
+ $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($cellIntersect));
+ $stack->push('Error', ExcelError::null(), null);
+ } else {
+ $cellRef = Coordinate::stringFromColumnIndex(min($oCol) + 1) . min($oRow) . ':'
+ . Coordinate::stringFromColumnIndex(max($oCol) + 1) . max($oRow);
+ $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($cellIntersect));
+ $stack->push('Value', $cellIntersect, $cellRef);
+ }
+
+ break;
+ }
+ } elseif (($token === '~') || ($token === '%')) {
+ // if the token is a unary operator, pop one value off the stack, do the operation, and push it back on
+ if (($arg = $stack->pop()) === null) {
+ return $this->raiseFormulaError('Internal error - Operand value missing from stack');
+ }
+ $arg = $arg['value'];
+ if ($token === '~') {
+ $this->debugLog->writeDebugLog('Evaluating Negation of %s', $this->showValue($arg));
+ $multiplier = -1;
+ } else {
+ $this->debugLog->writeDebugLog('Evaluating Percentile of %s', $this->showValue($arg));
+ $multiplier = 0.01;
+ }
+ if (is_array($arg)) {
+ $operand2 = $multiplier;
+ $result = $arg;
+ [$rows, $columns] = self::checkMatrixOperands($result, $operand2, 0);
+ for ($row = 0; $row < $rows; ++$row) {
+ for ($column = 0; $column < $columns; ++$column) {
+ if (self::isNumericOrBool($result[$row][$column])) {
+ $result[$row][$column] *= $multiplier;
+ } else {
+ $result[$row][$column] = self::makeError($result[$row][$column]);
+ }
+ }
+ }
+
+ $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($result));
+ $stack->push('Value', $result);
+ if (isset($storeKey)) {
+ $branchStore[$storeKey] = $result;
+ }
+ } else {
+ $this->executeNumericBinaryOperation($multiplier, $arg, '*', $stack);
+ }
+ } elseif (preg_match('/^' . self::CALCULATION_REGEXP_CELLREF . '$/i', $token ?? '', $matches)) {
+ $cellRef = null;
+
+ if (isset($matches[8])) {
+ if ($cell === null) {
+ // We can't access the range, so return a REF error
+ $cellValue = ExcelError::REF();
+ } else {
+ $cellRef = $matches[6] . $matches[7] . ':' . $matches[9] . $matches[10];
+ if ($matches[2] > '') {
+ $matches[2] = trim($matches[2], "\"'");
+ if ((str_contains($matches[2], '[')) || (str_contains($matches[2], ']'))) {
+ // It's a Reference to an external spreadsheet (not currently supported)
+ return $this->raiseFormulaError('Unable to access External Workbook');
+ }
+ $matches[2] = trim($matches[2], "\"'");
+ $this->debugLog->writeDebugLog('Evaluating Cell Range %s in worksheet %s', $cellRef, $matches[2]);
+ if ($pCellParent !== null && $this->spreadsheet !== null) {
+ $cellValue = $this->extractCellRange($cellRef, $this->spreadsheet->getSheetByName($matches[2]), false);
+ } else {
+ return $this->raiseFormulaError('Unable to access Cell Reference');
+ }
+ $this->debugLog->writeDebugLog('Evaluation Result for cells %s in worksheet %s is %s', $cellRef, $matches[2], $this->showTypeDetails($cellValue));
+ } else {
+ $this->debugLog->writeDebugLog('Evaluating Cell Range %s in current worksheet', $cellRef);
+ if ($pCellParent !== null) {
+ $cellValue = $this->extractCellRange($cellRef, $pCellWorksheet, false);
+ } else {
+ return $this->raiseFormulaError('Unable to access Cell Reference');
+ }
+ $this->debugLog->writeDebugLog('Evaluation Result for cells %s is %s', $cellRef, $this->showTypeDetails($cellValue));
+ }
+ }
+ } else {
+ if ($cell === null) {
+ // We can't access the cell, so return a REF error
+ $cellValue = ExcelError::REF();
+ } else {
+ $cellRef = $matches[6] . $matches[7];
+ if ($matches[2] > '') {
+ $matches[2] = trim($matches[2], "\"'");
+ if ((str_contains($matches[2], '[')) || (str_contains($matches[2], ']'))) {
+ // It's a Reference to an external spreadsheet (not currently supported)
+ return $this->raiseFormulaError('Unable to access External Workbook');
+ }
+ $this->debugLog->writeDebugLog('Evaluating Cell %s in worksheet %s', $cellRef, $matches[2]);
+ if ($pCellParent !== null && $this->spreadsheet !== null) {
+ $cellSheet = $this->spreadsheet->getSheetByName($matches[2]);
+ if ($cellSheet && $cellSheet->cellExists($cellRef)) {
+ $cellValue = $this->extractCellRange($cellRef, $this->spreadsheet->getSheetByName($matches[2]), false);
+ $cell->attach($pCellParent);
+ } else {
+ $cellRef = ($cellSheet !== null) ? "'{$matches[2]}'!{$cellRef}" : $cellRef;
+ $cellValue = ($cellSheet !== null) ? null : ExcelError::REF();
+ }
+ } else {
+ return $this->raiseFormulaError('Unable to access Cell Reference');
+ }
+ $this->debugLog->writeDebugLog('Evaluation Result for cell %s in worksheet %s is %s', $cellRef, $matches[2], $this->showTypeDetails($cellValue));
+ } else {
+ $this->debugLog->writeDebugLog('Evaluating Cell %s in current worksheet', $cellRef);
+ if ($pCellParent !== null && $pCellParent->has($cellRef)) {
+ $cellValue = $this->extractCellRange($cellRef, $pCellWorksheet, false);
+ $cell->attach($pCellParent);
+ } else {
+ $cellValue = null;
+ }
+ $this->debugLog->writeDebugLog('Evaluation Result for cell %s is %s', $cellRef, $this->showTypeDetails($cellValue));
+ }
+ }
+ }
+
+ $stack->push('Cell Value', $cellValue, $cellRef);
+ if (isset($storeKey)) {
+ $branchStore[$storeKey] = $cellValue;
+ }
+ } elseif (preg_match('/^' . self::CALCULATION_REGEXP_FUNCTION . '$/miu', $token ?? '', $matches)) {
+ // if the token is a function, pop arguments off the stack, hand them to the function, and push the result back on
+ if ($cell !== null && $pCellParent !== null) {
+ $cell->attach($pCellParent);
+ }
+
+ $functionName = $matches[1];
+ $argCount = $stack->pop();
+ $argCount = $argCount['value'];
+ if ($functionName !== 'MKMATRIX') {
+ $this->debugLog->writeDebugLog('Evaluating Function %s() with %s argument%s', self::localeFunc($functionName), (($argCount == 0) ? 'no' : $argCount), (($argCount == 1) ? '' : 's'));
+ }
+ if ((isset(self::$phpSpreadsheetFunctions[$functionName])) || (isset(self::$controlFunctions[$functionName]))) { // function
+ $passByReference = false;
+ $passCellReference = false;
+ $functionCall = null;
+ if (isset(self::$phpSpreadsheetFunctions[$functionName])) {
+ $functionCall = self::$phpSpreadsheetFunctions[$functionName]['functionCall'];
+ $passByReference = isset(self::$phpSpreadsheetFunctions[$functionName]['passByReference']);
+ $passCellReference = isset(self::$phpSpreadsheetFunctions[$functionName]['passCellReference']);
+ } elseif (isset(self::$controlFunctions[$functionName])) {
+ $functionCall = self::$controlFunctions[$functionName]['functionCall'];
+ $passByReference = isset(self::$controlFunctions[$functionName]['passByReference']);
+ $passCellReference = isset(self::$controlFunctions[$functionName]['passCellReference']);
+ }
+
+ // get the arguments for this function
+ $args = $argArrayVals = [];
+ $emptyArguments = [];
+ for ($i = 0; $i < $argCount; ++$i) {
+ $arg = $stack->pop();
+ $a = $argCount - $i - 1;
+ if (
+ ($passByReference)
+ && (isset(self::$phpSpreadsheetFunctions[$functionName]['passByReference'][$a]))
+ && (self::$phpSpreadsheetFunctions[$functionName]['passByReference'][$a])
+ ) {
+ if ($arg['reference'] === null) {
+ $args[] = $cellID;
+ if ($functionName !== 'MKMATRIX') {
+ $argArrayVals[] = $this->showValue($cellID);
+ }
+ } else {
+ $args[] = $arg['reference'];
+ if ($functionName !== 'MKMATRIX') {
+ $argArrayVals[] = $this->showValue($arg['reference']);
+ }
+ }
+ } else {
+ if ($arg['type'] === 'Empty Argument' && in_array($functionName, ['MIN', 'MINA', 'MAX', 'MAXA', 'IF'], true)) {
+ $emptyArguments[] = false;
+ $args[] = $arg['value'] = 0;
+ $this->debugLog->writeDebugLog('Empty Argument reevaluated as 0');
+ } else {
+ $emptyArguments[] = $arg['type'] === 'Empty Argument';
+ $args[] = self::unwrapResult($arg['value']);
+ }
+ if ($functionName !== 'MKMATRIX') {
+ $argArrayVals[] = $this->showValue($arg['value']);
+ }
+ }
+ }
+
+ // Reverse the order of the arguments
+ krsort($args);
+ krsort($emptyArguments);
+
+ if ($argCount > 0 && is_array($functionCall)) {
+ $args = $this->addDefaultArgumentValues($functionCall, $args, $emptyArguments);
+ }
+
+ if (($passByReference) && ($argCount == 0)) {
+ $args[] = $cellID;
+ $argArrayVals[] = $this->showValue($cellID);
+ }
+
+ if ($functionName !== 'MKMATRIX') {
+ if ($this->debugLog->getWriteDebugLog()) {
+ krsort($argArrayVals);
+ $this->debugLog->writeDebugLog('Evaluating %s ( %s )', self::localeFunc($functionName), implode(self::$localeArgumentSeparator . ' ', Functions::flattenArray($argArrayVals)));
+ }
+ }
+
+ // Process the argument with the appropriate function call
+ $args = $this->addCellReference($args, $passCellReference, $functionCall, $cell);
+
+ if (!is_array($functionCall)) {
+ foreach ($args as &$arg) {
+ $arg = Functions::flattenSingleValue($arg);
+ }
+ unset($arg);
+ }
+
+ $result = call_user_func_array($functionCall, $args);
+
+ if ($functionName !== 'MKMATRIX') {
+ $this->debugLog->writeDebugLog('Evaluation Result for %s() function call is %s', self::localeFunc($functionName), $this->showTypeDetails($result));
+ }
+ $stack->push('Value', self::wrapResult($result));
+ if (isset($storeKey)) {
+ $branchStore[$storeKey] = $result;
+ }
+ }
+ } else {
+ // if the token is a number, boolean, string or an Excel error, push it onto the stack
+ if (isset(self::$excelConstants[strtoupper($token ?? '')])) {
+ $excelConstant = strtoupper($token);
+ $stack->push('Constant Value', self::$excelConstants[$excelConstant]);
+ if (isset($storeKey)) {
+ $branchStore[$storeKey] = self::$excelConstants[$excelConstant];
+ }
+ $this->debugLog->writeDebugLog('Evaluating Constant %s as %s', $excelConstant, $this->showTypeDetails(self::$excelConstants[$excelConstant]));
+ } elseif ((is_numeric($token)) || ($token === null) || (is_bool($token)) || ($token == '') || ($token[0] == self::FORMULA_STRING_QUOTE) || ($token[0] == '#')) {
+ $stack->push($tokenData['type'], $token, $tokenData['reference']);
+ if (isset($storeKey)) {
+ $branchStore[$storeKey] = $token;
+ }
+ } elseif (preg_match('/^' . self::CALCULATION_REGEXP_DEFINEDNAME . '$/miu', $token, $matches)) {
+ // if the token is a named range or formula, evaluate it and push the result onto the stack
+ $definedName = $matches[6];
+ if ($cell === null || $pCellWorksheet === null) {
+ return $this->raiseFormulaError("undefined name '$token'");
+ }
+ $specifiedWorksheet = trim($matches[2], "'");
+
+ $this->debugLog->writeDebugLog('Evaluating Defined Name %s', $definedName);
+ $namedRange = DefinedName::resolveName($definedName, $pCellWorksheet, $specifiedWorksheet);
+ // If not Defined Name, try as Table.
+ if ($namedRange === null && $this->spreadsheet !== null) {
+ $table = $this->spreadsheet->getTableByName($definedName);
+ if ($table !== null) {
+ $tableRange = Coordinate::getRangeBoundaries($table->getRange());
+ if ($table->getShowHeaderRow()) {
+ ++$tableRange[0][1];
+ }
+ if ($table->getShowTotalsRow()) {
+ --$tableRange[1][1];
+ }
+ $tableRangeString
+ = '$' . $tableRange[0][0]
+ . '$' . $tableRange[0][1]
+ . ':'
+ . '$' . $tableRange[1][0]
+ . '$' . $tableRange[1][1];
+ $namedRange = new NamedRange($definedName, $table->getWorksheet(), $tableRangeString);
+ }
+ }
+ if ($namedRange === null) {
+ return $this->raiseFormulaError("undefined name '$definedName'");
+ }
+
+ $result = $this->evaluateDefinedName($cell, $namedRange, $pCellWorksheet, $stack, $specifiedWorksheet !== '');
+ if (isset($storeKey)) {
+ $branchStore[$storeKey] = $result;
+ }
+ } else {
+ return $this->raiseFormulaError("undefined name '$token'");
+ }
+ }
+ }
+ // when we're out of tokens, the stack should have a single element, the final result
+ if ($stack->count() != 1) {
+ return $this->raiseFormulaError('internal error');
+ }
+ $output = $stack->pop();
+ $output = $output['value'];
+
+ return $output;
+ }
+
+ private function validateBinaryOperand(mixed &$operand, mixed &$stack): bool
+ {
+ if (is_array($operand)) {
+ if ((count($operand, COUNT_RECURSIVE) - count($operand)) == 1) {
+ do {
+ $operand = array_pop($operand);
+ } while (is_array($operand));
+ }
+ }
+ // Numbers, matrices and booleans can pass straight through, as they're already valid
+ if (is_string($operand)) {
+ // We only need special validations for the operand if it is a string
+ // Start by stripping off the quotation marks we use to identify true excel string values internally
+ if ($operand > '' && $operand[0] == self::FORMULA_STRING_QUOTE) {
+ $operand = self::unwrapResult($operand);
+ }
+ // If the string is a numeric value, we treat it as a numeric, so no further testing
+ if (!is_numeric($operand)) {
+ // If not a numeric, test to see if the value is an Excel error, and so can't be used in normal binary operations
+ if ($operand > '' && $operand[0] == '#') {
+ $stack->push('Value', $operand);
+ $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($operand));
+
+ return false;
+ } elseif (Engine\FormattedNumber::convertToNumberIfFormatted($operand) === false) {
+ // If not a numeric, a fraction or a percentage, then it's a text string, and so can't be used in mathematical binary operations
+ $stack->push('Error', '#VALUE!');
+ $this->debugLog->writeDebugLog('Evaluation Result is a %s', $this->showTypeDetails('#VALUE!'));
+
+ return false;
+ }
+ }
+ }
+
+ // return a true if the value of the operand is one that we can use in normal binary mathematical operations
+ return true;
+ }
+
+ private function executeArrayComparison(mixed $operand1, mixed $operand2, string $operation, Stack &$stack, bool $recursingArrays): array
+ {
+ $result = [];
+ if (!is_array($operand2)) {
+ // Operand 1 is an array, Operand 2 is a scalar
+ foreach ($operand1 as $x => $operandData) {
+ $this->debugLog->writeDebugLog('Evaluating Comparison %s %s %s', $this->showValue($operandData), $operation, $this->showValue($operand2));
+ $this->executeBinaryComparisonOperation($operandData, $operand2, $operation, $stack);
+ $r = $stack->pop();
+ $result[$x] = $r['value'];
+ }
+ } elseif (!is_array($operand1)) {
+ // Operand 1 is a scalar, Operand 2 is an array
+ foreach ($operand2 as $x => $operandData) {
+ $this->debugLog->writeDebugLog('Evaluating Comparison %s %s %s', $this->showValue($operand1), $operation, $this->showValue($operandData));
+ $this->executeBinaryComparisonOperation($operand1, $operandData, $operation, $stack);
+ $r = $stack->pop();
+ $result[$x] = $r['value'];
+ }
+ } else {
+ // Operand 1 and Operand 2 are both arrays
+ if (!$recursingArrays) {
+ self::checkMatrixOperands($operand1, $operand2, 2);
+ }
+ foreach ($operand1 as $x => $operandData) {
+ $this->debugLog->writeDebugLog('Evaluating Comparison %s %s %s', $this->showValue($operandData), $operation, $this->showValue($operand2[$x]));
+ $this->executeBinaryComparisonOperation($operandData, $operand2[$x], $operation, $stack, true);
+ $r = $stack->pop();
+ $result[$x] = $r['value'];
+ }
+ }
+ // Log the result details
+ $this->debugLog->writeDebugLog('Comparison Evaluation Result is %s', $this->showTypeDetails($result));
+ // And push the result onto the stack
+ $stack->push('Array', $result);
+
+ return $result;
+ }
+
+ private function executeBinaryComparisonOperation(mixed $operand1, mixed $operand2, string $operation, Stack &$stack, bool $recursingArrays = false): array|bool
+ {
+ // If we're dealing with matrix operations, we want a matrix result
+ if ((is_array($operand1)) || (is_array($operand2))) {
+ return $this->executeArrayComparison($operand1, $operand2, $operation, $stack, $recursingArrays);
+ }
+
+ $result = BinaryComparison::compare($operand1, $operand2, $operation);
+
+ // Log the result details
+ $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($result));
+ // And push the result onto the stack
+ $stack->push('Value', $result);
+
+ return $result;
+ }
+
+ private function executeNumericBinaryOperation(mixed $operand1, mixed $operand2, string $operation, Stack &$stack): mixed
+ {
+ // Validate the two operands
+ if (
+ ($this->validateBinaryOperand($operand1, $stack) === false)
+ || ($this->validateBinaryOperand($operand2, $stack) === false)
+ ) {
+ return false;
+ }
+
+ if (
+ (Functions::getCompatibilityMode() != Functions::COMPATIBILITY_OPENOFFICE)
+ && ((is_string($operand1) && !is_numeric($operand1) && $operand1 !== '')
+ || (is_string($operand2) && !is_numeric($operand2) && $operand2 !== ''))
+ ) {
+ $result = ExcelError::VALUE();
+ } elseif (is_array($operand1) || is_array($operand2)) {
+ // Ensure that both operands are arrays/matrices
+ if (is_array($operand1)) {
+ foreach ($operand1 as $key => $value) {
+ $operand1[$key] = Functions::flattenArray($value);
+ }
+ }
+ if (is_array($operand2)) {
+ foreach ($operand2 as $key => $value) {
+ $operand2[$key] = Functions::flattenArray($value);
+ }
+ }
+ [$rows, $columns] = self::checkMatrixOperands($operand1, $operand2, 2);
+
+ for ($row = 0; $row < $rows; ++$row) {
+ for ($column = 0; $column < $columns; ++$column) {
+ if ($operand1[$row][$column] === null) {
+ $operand1[$row][$column] = 0;
+ } elseif (!self::isNumericOrBool($operand1[$row][$column])) {
+ $operand1[$row][$column] = self::makeError($operand1[$row][$column]);
+
+ continue;
+ }
+ if ($operand2[$row][$column] === null) {
+ $operand2[$row][$column] = 0;
+ } elseif (!self::isNumericOrBool($operand2[$row][$column])) {
+ $operand1[$row][$column] = self::makeError($operand2[$row][$column]);
+
+ continue;
+ }
+ switch ($operation) {
+ case '+':
+ $operand1[$row][$column] += $operand2[$row][$column];
+
+ break;
+ case '-':
+ $operand1[$row][$column] -= $operand2[$row][$column];
+
+ break;
+ case '*':
+ $operand1[$row][$column] *= $operand2[$row][$column];
+
+ break;
+ case '/':
+ if ($operand2[$row][$column] == 0) {
+ $operand1[$row][$column] = ExcelError::DIV0();
+ } else {
+ $operand1[$row][$column] /= $operand2[$row][$column];
+ }
+
+ break;
+ case '^':
+ $operand1[$row][$column] = $operand1[$row][$column] ** $operand2[$row][$column];
+
+ break;
+
+ default:
+ throw new Exception('Unsupported numeric binary operation');
+ }
+ }
+ }
+ $result = $operand1;
+ } else {
+ // If we're dealing with non-matrix operations, execute the necessary operation
+ switch ($operation) {
+ // Addition
+ case '+':
+ $result = $operand1 + $operand2;
+
+ break;
+ // Subtraction
+ case '-':
+ $result = $operand1 - $operand2;
+
+ break;
+ // Multiplication
+ case '*':
+ $result = $operand1 * $operand2;
+
+ break;
+ // Division
+ case '/':
+ if ($operand2 == 0) {
+ // Trap for Divide by Zero error
+ $stack->push('Error', ExcelError::DIV0());
+ $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails(ExcelError::DIV0()));
+
+ return false;
+ }
+ $result = $operand1 / $operand2;
+
+ break;
+ // Power
+ case '^':
+ $result = $operand1 ** $operand2;
+
+ break;
+
+ default:
+ throw new Exception('Unsupported numeric binary operation');
+ }
+ }
+
+ // Log the result details
+ $this->debugLog->writeDebugLog('Evaluation Result is %s', $this->showTypeDetails($result));
+ // And push the result onto the stack
+ $stack->push('Value', $result);
+
+ return $result;
+ }
+
+ /**
+ * Trigger an error, but nicely, if need be.
+ *
+ * @return false
+ */
+ protected function raiseFormulaError(string $errorMessage, int $code = 0, ?Throwable $exception = null): bool
+ {
+ $this->formulaError = $errorMessage;
+ $this->cyclicReferenceStack->clear();
+ $suppress = $this->suppressFormulaErrors;
+ if (!$suppress) {
+ throw new Exception($errorMessage, $code, $exception);
+ }
+
+ return false;
+ }
+
+ /**
+ * Extract range values.
+ *
+ * @param string $range String based range representation
+ * @param ?Worksheet $worksheet Worksheet
+ * @param bool $resetLog Flag indicating whether calculation log should be reset or not
+ *
+ * @return array Array of values in range if range contains more than one element. Otherwise, a single value is returned.
+ */
+ public function extractCellRange(string &$range = 'A1', ?Worksheet $worksheet = null, bool $resetLog = true): array
+ {
+ // Return value
+ $returnValue = [];
+
+ if ($worksheet !== null) {
+ $worksheetName = $worksheet->getTitle();
+
+ if (str_contains($range, '!')) {
+ [$worksheetName, $range] = Worksheet::extractSheetTitle($range, true);
+ $worksheet = ($this->spreadsheet === null) ? null : $this->spreadsheet->getSheetByName($worksheetName);
+ }
+
+ // Extract range
+ $aReferences = Coordinate::extractAllCellReferencesInRange($range);
+ $range = "'" . $worksheetName . "'" . '!' . $range;
+ $currentCol = '';
+ $currentRow = 0;
+ if (!isset($aReferences[1])) {
+ // Single cell in range
+ sscanf($aReferences[0], '%[A-Z]%d', $currentCol, $currentRow);
+ if ($worksheet !== null && $worksheet->cellExists($aReferences[0])) {
+ $returnValue[$currentRow][$currentCol] = $worksheet->getCell($aReferences[0])->getCalculatedValue($resetLog);
+ } else {
+ $returnValue[$currentRow][$currentCol] = null;
+ }
+ } else {
+ // Extract cell data for all cells in the range
+ foreach ($aReferences as $reference) {
+ // Extract range
+ sscanf($reference, '%[A-Z]%d', $currentCol, $currentRow);
+ if ($worksheet !== null && $worksheet->cellExists($reference)) {
+ $returnValue[$currentRow][$currentCol] = $worksheet->getCell($reference)->getCalculatedValue($resetLog);
+ } else {
+ $returnValue[$currentRow][$currentCol] = null;
+ }
+ }
+ }
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * Extract range values.
+ *
+ * @param string $range String based range representation
+ * @param null|Worksheet $worksheet Worksheet
+ * @param bool $resetLog Flag indicating whether calculation log should be reset or not
+ *
+ * @return array|string Array of values in range if range contains more than one element. Otherwise, a single value is returned.
+ */
+ public function extractNamedRange(string &$range = 'A1', ?Worksheet $worksheet = null, bool $resetLog = true): string|array
+ {
+ // Return value
+ $returnValue = [];
+
+ if ($worksheet !== null) {
+ if (str_contains($range, '!')) {
+ [$worksheetName, $range] = Worksheet::extractSheetTitle($range, true);
+ $worksheet = ($this->spreadsheet === null) ? null : $this->spreadsheet->getSheetByName($worksheetName);
+ }
+
+ // Named range?
+ $namedRange = ($worksheet === null) ? null : DefinedName::resolveName($range, $worksheet);
+ if ($namedRange === null) {
+ return ExcelError::REF();
+ }
+
+ $worksheet = $namedRange->getWorksheet();
+ $range = $namedRange->getValue();
+ $splitRange = Coordinate::splitRange($range);
+ // Convert row and column references
+ if ($worksheet !== null && ctype_alpha($splitRange[0][0])) {
+ $range = $splitRange[0][0] . '1:' . $splitRange[0][1] . $worksheet->getHighestRow();
+ } elseif ($worksheet !== null && ctype_digit($splitRange[0][0])) {
+ $range = 'A' . $splitRange[0][0] . ':' . $worksheet->getHighestColumn() . $splitRange[0][1];
+ }
+
+ // Extract range
+ $aReferences = Coordinate::extractAllCellReferencesInRange($range);
+ if (!isset($aReferences[1])) {
+ // Single cell (or single column or row) in range
+ [$currentCol, $currentRow] = Coordinate::coordinateFromString($aReferences[0]);
+ if ($worksheet !== null && $worksheet->cellExists($aReferences[0])) {
+ $returnValue[$currentRow][$currentCol] = $worksheet->getCell($aReferences[0])->getCalculatedValue($resetLog);
+ } else {
+ $returnValue[$currentRow][$currentCol] = null;
+ }
+ } else {
+ // Extract cell data for all cells in the range
+ foreach ($aReferences as $reference) {
+ // Extract range
+ [$currentCol, $currentRow] = Coordinate::coordinateFromString($reference);
+ if ($worksheet !== null && $worksheet->cellExists($reference)) {
+ $returnValue[$currentRow][$currentCol] = $worksheet->getCell($reference)->getCalculatedValue($resetLog);
+ } else {
+ $returnValue[$currentRow][$currentCol] = null;
+ }
+ }
+ }
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * Is a specific function implemented?
+ *
+ * @param string $function Function Name
+ */
+ public function isImplemented(string $function): bool
+ {
+ $function = strtoupper($function);
+ $notImplemented = !isset(self::$phpSpreadsheetFunctions[$function]) || (is_array(self::$phpSpreadsheetFunctions[$function]['functionCall']) && self::$phpSpreadsheetFunctions[$function]['functionCall'][1] === 'DUMMY');
+
+ return !$notImplemented;
+ }
+
+ /**
+ * Get a list of all implemented functions as an array of function objects.
+ */
+ public static function getFunctions(): array
+ {
+ return self::$phpSpreadsheetFunctions;
+ }
+
+ /**
+ * Get a list of implemented Excel function names.
+ */
+ public function getImplementedFunctionNames(): array
+ {
+ $returnValue = [];
+ foreach (self::$phpSpreadsheetFunctions as $functionName => $function) {
+ if ($this->isImplemented($functionName)) {
+ $returnValue[] = $functionName;
+ }
+ }
+
+ return $returnValue;
+ }
+
+ private function addDefaultArgumentValues(array $functionCall, array $args, array $emptyArguments): array
+ {
+ $reflector = new ReflectionMethod($functionCall[0], $functionCall[1]);
+ $methodArguments = $reflector->getParameters();
+
+ if (count($methodArguments) > 0) {
+ // Apply any defaults for empty argument values
+ foreach ($emptyArguments as $argumentId => $isArgumentEmpty) {
+ if ($isArgumentEmpty === true) {
+ $reflectedArgumentId = count($args) - (int) $argumentId - 1;
+ if (
+ !array_key_exists($reflectedArgumentId, $methodArguments)
+ || $methodArguments[$reflectedArgumentId]->isVariadic()
+ ) {
+ break;
+ }
+
+ $args[$argumentId] = $this->getArgumentDefaultValue($methodArguments[$reflectedArgumentId]);
+ }
+ }
+ }
+
+ return $args;
+ }
+
+ private function getArgumentDefaultValue(ReflectionParameter $methodArgument): mixed
+ {
+ $defaultValue = null;
+
+ if ($methodArgument->isDefaultValueAvailable()) {
+ $defaultValue = $methodArgument->getDefaultValue();
+ if ($methodArgument->isDefaultValueConstant()) {
+ $constantName = $methodArgument->getDefaultValueConstantName() ?? '';
+ // read constant value
+ if (str_contains($constantName, '::')) {
+ [$className, $constantName] = explode('::', $constantName);
+ $constantReflector = new ReflectionClassConstant($className, $constantName);
+
+ return $constantReflector->getValue();
+ }
+
+ return constant($constantName);
+ }
+ }
+
+ return $defaultValue;
+ }
+
+ /**
+ * Add cell reference if needed while making sure that it is the last argument.
+ */
+ private function addCellReference(array $args, bool $passCellReference, array|string $functionCall, ?Cell $cell = null): array
+ {
+ if ($passCellReference) {
+ if (is_array($functionCall)) {
+ $className = $functionCall[0];
+ $methodName = $functionCall[1];
+
+ $reflectionMethod = new ReflectionMethod($className, $methodName);
+ $argumentCount = count($reflectionMethod->getParameters());
+ while (count($args) < $argumentCount - 1) {
+ $args[] = null;
+ }
+ }
+
+ $args[] = $cell;
+ }
+
+ return $args;
+ }
+
+ private function evaluateDefinedName(Cell $cell, DefinedName $namedRange, Worksheet $cellWorksheet, Stack $stack, bool $ignoreScope = false): mixed
+ {
+ $definedNameScope = $namedRange->getScope();
+ if ($definedNameScope !== null && $definedNameScope !== $cellWorksheet && !$ignoreScope) {
+ // The defined name isn't in our current scope, so #REF
+ $result = ExcelError::REF();
+ $stack->push('Error', $result, $namedRange->getName());
+
+ return $result;
+ }
+
+ $definedNameValue = $namedRange->getValue();
+ $definedNameType = $namedRange->isFormula() ? 'Formula' : 'Range';
+ $definedNameWorksheet = $namedRange->getWorksheet();
+
+ if ($definedNameValue[0] !== '=') {
+ $definedNameValue = '=' . $definedNameValue;
+ }
+
+ $this->debugLog->writeDebugLog('Defined Name is a %s with a value of %s', $definedNameType, $definedNameValue);
+
+ $originalCoordinate = $cell->getCoordinate();
+ $recursiveCalculationCell = ($definedNameType !== 'Formula' && $definedNameWorksheet !== null && $definedNameWorksheet !== $cellWorksheet)
+ ? $definedNameWorksheet->getCell('A1')
+ : $cell;
+ $recursiveCalculationCellAddress = $recursiveCalculationCell->getCoordinate();
+
+ // Adjust relative references in ranges and formulae so that we execute the calculation for the correct rows and columns
+ $definedNameValue = self::$referenceHelper->updateFormulaReferencesAnyWorksheet(
+ $definedNameValue,
+ Coordinate::columnIndexFromString($cell->getColumn()) - 1,
+ $cell->getRow() - 1
+ );
+
+ $this->debugLog->writeDebugLog('Value adjusted for relative references is %s', $definedNameValue);
+
+ $recursiveCalculator = new self($this->spreadsheet);
+ $recursiveCalculator->getDebugLog()->setWriteDebugLog($this->getDebugLog()->getWriteDebugLog());
+ $recursiveCalculator->getDebugLog()->setEchoDebugLog($this->getDebugLog()->getEchoDebugLog());
+ $result = $recursiveCalculator->_calculateFormulaValue($definedNameValue, $recursiveCalculationCellAddress, $recursiveCalculationCell, true);
+ $cellWorksheet->getCell($originalCoordinate);
+
+ if ($this->getDebugLog()->getWriteDebugLog()) {
+ $this->debugLog->mergeDebugLog(array_slice($recursiveCalculator->getDebugLog()->getLog(), 3));
+ $this->debugLog->writeDebugLog('Evaluation Result for Named %s %s is %s', $definedNameType, $namedRange->getName(), $this->showTypeDetails($result));
+ }
+
+ $stack->push('Defined Name', $result, $namedRange->getName());
+
+ return $result;
+ }
+
+ public function setSuppressFormulaErrors(bool $suppressFormulaErrors): void
+ {
+ $this->suppressFormulaErrors = $suppressFormulaErrors;
+ }
+
+ public function getSuppressFormulaErrors(): bool
+ {
+ return $this->suppressFormulaErrors;
+ }
+
+ private static function boolToString(mixed $operand1): mixed
+ {
+ if (is_bool($operand1)) {
+ $operand1 = ($operand1) ? self::$localeBoolean['TRUE'] : self::$localeBoolean['FALSE'];
+ } elseif ($operand1 === null) {
+ $operand1 = '';
+ }
+
+ return $operand1;
+ }
+
+ private static function isNumericOrBool(mixed $operand): bool
+ {
+ return is_numeric($operand) || is_bool($operand);
+ }
+
+ private static function makeError(mixed $operand = ''): string
+ {
+ return Information\ErrorValue::isError($operand) ? $operand : ExcelError::VALUE();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Category.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Category.php
new file mode 100644
index 00000000..b661fafe
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Category.php
@@ -0,0 +1,21 @@
+ 1) {
+ return ExcelError::NAN();
+ }
+
+ $row = array_pop($columnData);
+
+ return array_pop($row);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DMax.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DMax.php
new file mode 100644
index 00000000..23b95a7d
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Database/DMax.php
@@ -0,0 +1,45 @@
+= count($fieldNames)) {
+ return null;
+ }
+
+ return $field;
+ }
+ $key = array_search($field, array_values($fieldNames), true);
+
+ return ($key !== false) ? (int) $key : null;
+ }
+
+ /**
+ * filter.
+ *
+ * Parses the selection criteria, extracts the database rows that match those criteria, and
+ * returns that subset of rows.
+ *
+ * @param mixed[] $database The range of cells that makes up the list or database.
+ * A database is a list of related data in which rows of related
+ * information are records, and columns of data are fields. The
+ * first row of the list contains labels for each column.
+ * @param mixed[] $criteria The range of cells that contains the conditions you specify.
+ * You can use any range for the criteria argument, as long as it
+ * includes at least one column label and at least one cell below
+ * the column label in which you specify a condition for the
+ * column.
+ *
+ * @return mixed[]
+ */
+ protected static function filter(array $database, array $criteria): array
+ {
+ $fieldNames = array_shift($database);
+ $criteriaNames = array_shift($criteria);
+
+ // Convert the criteria into a set of AND/OR conditions with [:placeholders]
+ $query = self::buildQuery($criteriaNames, $criteria);
+
+ // Loop through each row of the database
+ return self::executeQuery($database, $query, $criteriaNames, $fieldNames);
+ }
+
+ protected static function getFilteredColumn(array $database, ?int $field, array $criteria): array
+ {
+ // reduce the database to a set of rows that match all the criteria
+ $database = self::filter($database, $criteria);
+ $defaultReturnColumnValue = ($field === null) ? 1 : null;
+
+ // extract an array of values for the requested column
+ $columnData = [];
+ foreach ($database as $rowKey => $row) {
+ $keys = array_keys($row);
+ $key = $keys[$field] ?? null;
+ $columnKey = $key ?? 'A';
+ $columnData[$rowKey][$columnKey] = $row[$key] ?? $defaultReturnColumnValue;
+ }
+
+ return $columnData;
+ }
+
+ private static function buildQuery(array $criteriaNames, array $criteria): string
+ {
+ $baseQuery = [];
+ foreach ($criteria as $key => $criterion) {
+ foreach ($criterion as $field => $value) {
+ $criterionName = $criteriaNames[$field];
+ if ($value !== null) {
+ $condition = self::buildCondition($value, $criterionName);
+ $baseQuery[$key][] = $condition;
+ }
+ }
+ }
+
+ $rowQuery = array_map(
+ fn ($rowValue): string => (count($rowValue) > 1) ? 'AND(' . implode(',', $rowValue) . ')' : ($rowValue[0] ?? ''),
+ $baseQuery
+ );
+
+ return (count($rowQuery) > 1) ? 'OR(' . implode(',', $rowQuery) . ')' : ($rowQuery[0] ?? '');
+ }
+
+ private static function buildCondition(mixed $criterion, string $criterionName): string
+ {
+ $ifCondition = Functions::ifCondition($criterion);
+
+ // Check for wildcard characters used in the condition
+ $result = preg_match('/(?[^"]*)(?".*[*?].*")/ui', $ifCondition, $matches);
+ if ($result !== 1) {
+ return "[:{$criterionName}]{$ifCondition}";
+ }
+
+ $trueFalse = ($matches['operator'] !== '<>');
+ $wildcard = WildcardMatch::wildcard($matches['operand']);
+ $condition = "WILDCARDMATCH([:{$criterionName}],{$wildcard})";
+ if ($trueFalse === false) {
+ $condition = "NOT({$condition})";
+ }
+
+ return $condition;
+ }
+
+ private static function executeQuery(array $database, string $query, array $criteria, array $fields): array
+ {
+ foreach ($database as $dataRow => $dataValues) {
+ // Substitute actual values from the database row for our [:placeholders]
+ $conditions = $query;
+ foreach ($criteria as $criterion) {
+ $conditions = self::processCondition($criterion, $fields, $dataValues, $conditions);
+ }
+
+ // evaluate the criteria against the row data
+ $result = Calculation::getInstance()->_calculateFormulaValue('=' . $conditions);
+
+ // If the row failed to meet the criteria, remove it from the database
+ if ($result !== true) {
+ unset($database[$dataRow]);
+ }
+ }
+
+ return $database;
+ }
+
+ private static function processCondition(string $criterion, array $fields, array $dataValues, string $conditions): string
+ {
+ $key = array_search($criterion, $fields, true);
+
+ $dataValue = 'NULL';
+ if (is_bool($dataValues[$key])) {
+ $dataValue = ($dataValues[$key]) ? 'TRUE' : 'FALSE';
+ } elseif ($dataValues[$key] !== null) {
+ $dataValue = $dataValues[$key];
+ // escape quotes if we have a string containing quotes
+ if (is_string($dataValue) && str_contains($dataValue, '"')) {
+ $dataValue = str_replace('"', '""', $dataValue);
+ }
+ $dataValue = (is_string($dataValue)) ? Calculation::wrapResult(strtoupper($dataValue)) : $dataValue;
+ }
+
+ return str_replace('[:' . $criterion . ']', $dataValue, $conditions);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Constants.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Constants.php
new file mode 100644
index 00000000..1165eb1f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Constants.php
@@ -0,0 +1,38 @@
+ self::DOW_SUNDAY,
+ self::DOW_MONDAY,
+ self::STARTWEEK_MONDAY_ALT => self::DOW_MONDAY,
+ self::DOW_TUESDAY,
+ self::DOW_WEDNESDAY,
+ self::DOW_THURSDAY,
+ self::DOW_FRIDAY,
+ self::DOW_SATURDAY,
+ self::DOW_SUNDAY,
+ self::STARTWEEK_MONDAY_ISO => self::STARTWEEK_MONDAY_ISO,
+ ];
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Current.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Current.php
new file mode 100644
index 00000000..088e3794
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Current.php
@@ -0,0 +1,60 @@
+format('c'));
+
+ return Helpers::dateParseSucceeded($dateArray) ? Helpers::returnIn3FormatsArray($dateArray, true) : ExcelError::VALUE();
+ }
+
+ /**
+ * DATETIMENOW.
+ *
+ * Returns the current date and time.
+ * The NOW function is useful when you need to display the current date and time on a worksheet or
+ * calculate a value based on the current date and time, and have that value updated each time you
+ * open the worksheet.
+ *
+ * NOTE: When used in a Cell Formula, MS Excel changes the cell format so that it matches the date
+ * and time format of your regional settings. PhpSpreadsheet does not change cell formatting in this way.
+ *
+ * Excel Function:
+ * NOW()
+ *
+ * @return DateTime|float|int|string Excel date/time serial value, PHP date/time serial value or PHP date/time object,
+ * depending on the value of the ReturnDateType flag
+ */
+ public static function now(): DateTime|float|int|string
+ {
+ $dti = new DateTimeImmutable();
+ $dateArray = Helpers::dateParse($dti->format('c'));
+
+ return Helpers::dateParseSucceeded($dateArray) ? Helpers::returnIn3FormatsArray($dateArray) : ExcelError::VALUE();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Date.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Date.php
new file mode 100644
index 00000000..e0e4b25f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Date.php
@@ -0,0 +1,167 @@
+getMessage();
+ }
+
+ // Execute function
+ $excelDateValue = SharedDateHelper::formattedPHPToExcel($year, $month, $day);
+
+ return Helpers::returnIn3FormatsFloat($excelDateValue);
+ }
+
+ /**
+ * Convert year from multiple formats to int.
+ */
+ private static function getYear(mixed $year, int $baseYear): int
+ {
+ $year = ($year !== null) ? StringHelper::testStringAsNumeric((string) $year) : 0;
+ if (!is_numeric($year)) {
+ throw new Exception(ExcelError::VALUE());
+ }
+ $year = (int) $year;
+
+ if ($year < ($baseYear - 1900)) {
+ throw new Exception(ExcelError::NAN());
+ }
+ if ((($baseYear - 1900) !== 0) && ($year < $baseYear) && ($year >= 1900)) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ if (($year < $baseYear) && ($year >= ($baseYear - 1900))) {
+ $year += 1900;
+ }
+
+ return (int) $year;
+ }
+
+ /**
+ * Convert month from multiple formats to int.
+ */
+ private static function getMonth(mixed $month): int
+ {
+ if (($month !== null) && (!is_numeric($month))) {
+ $month = SharedDateHelper::monthStringToNumber($month);
+ }
+
+ $month = ($month !== null) ? StringHelper::testStringAsNumeric((string) $month) : 0;
+ if (!is_numeric($month)) {
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ return (int) $month;
+ }
+
+ /**
+ * Convert day from multiple formats to int.
+ */
+ private static function getDay(mixed $day): int
+ {
+ if (($day !== null) && (!is_numeric($day))) {
+ $day = SharedDateHelper::dayStringToNumber($day);
+ }
+
+ $day = ($day !== null) ? StringHelper::testStringAsNumeric((string) $day) : 0;
+ if (!is_numeric($day)) {
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ return (int) $day;
+ }
+
+ private static function adjustYearMonth(int &$year, int &$month, int $baseYear): void
+ {
+ if ($month < 1) {
+ // Handle year/month adjustment if month < 1
+ --$month;
+ $year += ceil($month / 12) - 1;
+ $month = 13 - abs($month % 12);
+ } elseif ($month > 12) {
+ // Handle year/month adjustment if month > 12
+ $year += floor($month / 12);
+ $month = ($month % 12);
+ }
+
+ // Re-validate the year parameter after adjustments
+ if (($year < $baseYear) || ($year >= 10000)) {
+ throw new Exception(ExcelError::NAN());
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/DateParts.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/DateParts.php
new file mode 100644
index 00000000..60e4de19
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/DateParts.php
@@ -0,0 +1,154 @@
+= 0) {
+ return $weirdResult;
+ }
+
+ try {
+ $dateValue = Helpers::getDateValue($dateValue);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Execute function
+ $PHPDateObject = SharedDateHelper::excelToDateTimeObject($dateValue);
+ SharedDateHelper::roundMicroseconds($PHPDateObject);
+
+ return (int) $PHPDateObject->format('j');
+ }
+
+ /**
+ * MONTHOFYEAR.
+ *
+ * Returns the month of a date represented by a serial number.
+ * The month is given as an integer, ranging from 1 (January) to 12 (December).
+ *
+ * Excel Function:
+ * MONTH(dateValue)
+ *
+ * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
+ * PHP DateTime object, or a standard date string
+ * Or can be an array of date values
+ *
+ * @return array|int|string Month of the year
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function month(mixed $dateValue): array|string|int
+ {
+ if (is_array($dateValue)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $dateValue);
+ }
+
+ try {
+ $dateValue = Helpers::getDateValue($dateValue);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+ if ($dateValue < 1 && SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_WINDOWS_1900) {
+ return 1;
+ }
+
+ // Execute function
+ $PHPDateObject = SharedDateHelper::excelToDateTimeObject($dateValue);
+ SharedDateHelper::roundMicroseconds($PHPDateObject);
+
+ return (int) $PHPDateObject->format('n');
+ }
+
+ /**
+ * YEAR.
+ *
+ * Returns the year corresponding to a date.
+ * The year is returned as an integer in the range 1900-9999.
+ *
+ * Excel Function:
+ * YEAR(dateValue)
+ *
+ * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
+ * PHP DateTime object, or a standard date string
+ * Or can be an array of date values
+ *
+ * @return array|int|string Year
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function year(mixed $dateValue): array|string|int
+ {
+ if (is_array($dateValue)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $dateValue);
+ }
+
+ try {
+ $dateValue = Helpers::getDateValue($dateValue);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($dateValue < 1 && SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_WINDOWS_1900) {
+ return 1900;
+ }
+ // Execute function
+ $PHPDateObject = SharedDateHelper::excelToDateTimeObject($dateValue);
+ SharedDateHelper::roundMicroseconds($PHPDateObject);
+
+ return (int) $PHPDateObject->format('Y');
+ }
+
+ /**
+ * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
+ * PHP DateTime object, or a standard date string
+ */
+ private static function weirdCondition(mixed $dateValue): int
+ {
+ // Excel does not treat 0 consistently for DAY vs. (MONTH or YEAR)
+ if (SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_WINDOWS_1900 && Functions::getCompatibilityMode() == Functions::COMPATIBILITY_EXCEL) {
+ if (is_bool($dateValue)) {
+ return (int) $dateValue;
+ }
+ if ($dateValue === null) {
+ return 0;
+ }
+ if (is_numeric($dateValue) && $dateValue < 1 && $dateValue >= 0) {
+ return 0;
+ }
+ }
+
+ return -1;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/DateValue.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/DateValue.php
new file mode 100644
index 00000000..8c5fa71c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/DateValue.php
@@ -0,0 +1,163 @@
+ 31)) {
+ if ($yearFound) {
+ return ExcelError::VALUE();
+ }
+ if ($t < 100) {
+ $t += 1900;
+ }
+ $yearFound = true;
+ }
+ }
+ if (count($t1) === 1) {
+ // We've been fed a time value without any date
+ return ((!str_contains((string) $t, ':'))) ? ExcelError::Value() : 0.0;
+ }
+ unset($t);
+
+ $dateValue = self::t1ToString($t1, $dti, $yearFound);
+
+ $PHPDateArray = self::setUpArray($dateValue, $dti);
+
+ return self::finalResults($PHPDateArray, $dti, $baseYear);
+ }
+
+ private static function t1ToString(array $t1, DateTimeImmutable $dti, bool $yearFound): string
+ {
+ if (count($t1) == 2) {
+ // We only have two parts of the date: either day/month or month/year
+ if ($yearFound) {
+ array_unshift($t1, 1);
+ } else {
+ if (is_numeric($t1[1]) && $t1[1] > 29) {
+ $t1[1] += 1900;
+ array_unshift($t1, 1);
+ } else {
+ $t1[] = $dti->format('Y');
+ }
+ }
+ }
+ $dateValue = implode(' ', $t1);
+
+ return $dateValue;
+ }
+
+ /**
+ * Parse date.
+ */
+ private static function setUpArray(string $dateValue, DateTimeImmutable $dti): array
+ {
+ $PHPDateArray = Helpers::dateParse($dateValue);
+ if (!Helpers::dateParseSucceeded($PHPDateArray)) {
+ // If original count was 1, we've already returned.
+ // If it was 2, we added another.
+ // Therefore, neither of the first 2 stroks below can fail.
+ $testVal1 = strtok($dateValue, '- ');
+ $testVal2 = strtok('- ');
+ $testVal3 = strtok('- ') ?: $dti->format('Y');
+ Helpers::adjustYear((string) $testVal1, (string) $testVal2, $testVal3);
+ $PHPDateArray = Helpers::dateParse($testVal1 . '-' . $testVal2 . '-' . $testVal3);
+ if (!Helpers::dateParseSucceeded($PHPDateArray)) {
+ $PHPDateArray = Helpers::dateParse($testVal2 . '-' . $testVal1 . '-' . $testVal3);
+ }
+ }
+
+ return $PHPDateArray;
+ }
+
+ /**
+ * Final results.
+ *
+ * @return DateTime|float|int|string Excel date/time serial value, PHP date/time serial value or PHP date/time object,
+ * depending on the value of the ReturnDateType flag
+ */
+ private static function finalResults(array $PHPDateArray, DateTimeImmutable $dti, int $baseYear): string|float|int|DateTime
+ {
+ $retValue = ExcelError::Value();
+ if (Helpers::dateParseSucceeded($PHPDateArray)) {
+ // Execute function
+ Helpers::replaceIfEmpty($PHPDateArray['year'], $dti->format('Y'));
+ if ($PHPDateArray['year'] < $baseYear) {
+ return ExcelError::VALUE();
+ }
+ Helpers::replaceIfEmpty($PHPDateArray['month'], $dti->format('m'));
+ Helpers::replaceIfEmpty($PHPDateArray['day'], $dti->format('d'));
+ $PHPDateArray['hour'] = 0;
+ $PHPDateArray['minute'] = 0;
+ $PHPDateArray['second'] = 0;
+ $month = (int) $PHPDateArray['month'];
+ $day = (int) $PHPDateArray['day'];
+ $year = (int) $PHPDateArray['year'];
+ if (!checkdate($month, $day, $year)) {
+ return ($year === 1900 && $month === 2 && $day === 29) ? Helpers::returnIn3FormatsFloat(60.0) : ExcelError::VALUE();
+ }
+ $retValue = Helpers::returnIn3FormatsArray($PHPDateArray, true);
+ }
+
+ return $retValue;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Days.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Days.php
new file mode 100644
index 00000000..6c6fd3d7
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Days.php
@@ -0,0 +1,62 @@
+getMessage();
+ }
+
+ // Execute function
+ $PHPStartDateObject = SharedDateHelper::excelToDateTimeObject($startDate);
+ $PHPEndDateObject = SharedDateHelper::excelToDateTimeObject($endDate);
+
+ $days = ExcelError::VALUE();
+ $diff = $PHPStartDateObject->diff($PHPEndDateObject);
+ if ($diff !== false && !is_bool($diff->days)) {
+ $days = $diff->days;
+ if ($diff->invert) {
+ $days = -$days;
+ }
+ }
+
+ return $days;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Days360.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Days360.php
new file mode 100644
index 00000000..c7e03fc0
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Days360.php
@@ -0,0 +1,118 @@
+getMessage();
+ }
+
+ if (!is_bool($method)) {
+ return ExcelError::VALUE();
+ }
+
+ // Execute function
+ $PHPStartDateObject = SharedDateHelper::excelToDateTimeObject($startDate);
+ $startDay = $PHPStartDateObject->format('j');
+ $startMonth = $PHPStartDateObject->format('n');
+ $startYear = $PHPStartDateObject->format('Y');
+
+ $PHPEndDateObject = SharedDateHelper::excelToDateTimeObject($endDate);
+ $endDay = $PHPEndDateObject->format('j');
+ $endMonth = $PHPEndDateObject->format('n');
+ $endYear = $PHPEndDateObject->format('Y');
+
+ return self::dateDiff360((int) $startDay, (int) $startMonth, (int) $startYear, (int) $endDay, (int) $endMonth, (int) $endYear, !$method);
+ }
+
+ /**
+ * Return the number of days between two dates based on a 360 day calendar.
+ */
+ private static function dateDiff360(int $startDay, int $startMonth, int $startYear, int $endDay, int $endMonth, int $endYear, bool $methodUS): int
+ {
+ $startDay = self::getStartDay($startDay, $startMonth, $startYear, $methodUS);
+ $endDay = self::getEndDay($endDay, $endMonth, $endYear, $startDay, $methodUS);
+
+ return $endDay + $endMonth * 30 + $endYear * 360 - $startDay - $startMonth * 30 - $startYear * 360;
+ }
+
+ private static function getStartDay(int $startDay, int $startMonth, int $startYear, bool $methodUS): int
+ {
+ if ($startDay == 31) {
+ --$startDay;
+ } elseif ($methodUS && ($startMonth == 2 && ($startDay == 29 || ($startDay == 28 && !Helpers::isLeapYear($startYear))))) {
+ $startDay = 30;
+ }
+
+ return $startDay;
+ }
+
+ private static function getEndDay(int $endDay, int &$endMonth, int &$endYear, int $startDay, bool $methodUS): int
+ {
+ if ($endDay == 31) {
+ if ($methodUS && $startDay != 30) {
+ $endDay = 1;
+ if ($endMonth == 12) {
+ ++$endYear;
+ $endMonth = 1;
+ } else {
+ ++$endMonth;
+ }
+ } else {
+ $endDay = 30;
+ }
+ }
+
+ return $endDay;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Difference.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Difference.php
new file mode 100644
index 00000000..199d5d85
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Difference.php
@@ -0,0 +1,153 @@
+getMessage();
+ }
+
+ // Execute function
+ $PHPStartDateObject = SharedDateHelper::excelToDateTimeObject($startDate);
+ $startDays = (int) $PHPStartDateObject->format('j');
+ //$startMonths = (int) $PHPStartDateObject->format('n');
+ $startYears = (int) $PHPStartDateObject->format('Y');
+
+ $PHPEndDateObject = SharedDateHelper::excelToDateTimeObject($endDate);
+ $endDays = (int) $PHPEndDateObject->format('j');
+ //$endMonths = (int) $PHPEndDateObject->format('n');
+ $endYears = (int) $PHPEndDateObject->format('Y');
+
+ $PHPDiffDateObject = $PHPEndDateObject->diff($PHPStartDateObject);
+
+ $retVal = false;
+ $retVal = self::replaceRetValue($retVal, $unit, 'D') ?? self::datedifD($difference);
+ $retVal = self::replaceRetValue($retVal, $unit, 'M') ?? self::datedifM($PHPDiffDateObject);
+ $retVal = self::replaceRetValue($retVal, $unit, 'MD') ?? self::datedifMD($startDays, $endDays, $PHPEndDateObject, $PHPDiffDateObject);
+ $retVal = self::replaceRetValue($retVal, $unit, 'Y') ?? self::datedifY($PHPDiffDateObject);
+ $retVal = self::replaceRetValue($retVal, $unit, 'YD') ?? self::datedifYD($difference, $startYears, $endYears, $PHPStartDateObject, $PHPEndDateObject);
+ $retVal = self::replaceRetValue($retVal, $unit, 'YM') ?? self::datedifYM($PHPDiffDateObject);
+
+ return is_bool($retVal) ? ExcelError::VALUE() : $retVal;
+ }
+
+ private static function initialDiff(float $startDate, float $endDate): float
+ {
+ // Validate parameters
+ if ($startDate > $endDate) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $endDate - $startDate;
+ }
+
+ /**
+ * Decide whether it's time to set retVal.
+ */
+ private static function replaceRetValue(bool|int $retVal, string $unit, string $compare): null|bool|int
+ {
+ if ($retVal !== false || $unit !== $compare) {
+ return $retVal;
+ }
+
+ return null;
+ }
+
+ private static function datedifD(float $difference): int
+ {
+ return (int) $difference;
+ }
+
+ private static function datedifM(DateInterval $PHPDiffDateObject): int
+ {
+ return 12 * (int) $PHPDiffDateObject->format('%y') + (int) $PHPDiffDateObject->format('%m');
+ }
+
+ private static function datedifMD(int $startDays, int $endDays, DateTime $PHPEndDateObject, DateInterval $PHPDiffDateObject): int
+ {
+ if ($endDays < $startDays) {
+ $retVal = $endDays;
+ $PHPEndDateObject->modify('-' . $endDays . ' days');
+ $adjustDays = (int) $PHPEndDateObject->format('j');
+ $retVal += ($adjustDays - $startDays);
+ } else {
+ $retVal = (int) $PHPDiffDateObject->format('%d');
+ }
+
+ return $retVal;
+ }
+
+ private static function datedifY(DateInterval $PHPDiffDateObject): int
+ {
+ return (int) $PHPDiffDateObject->format('%y');
+ }
+
+ private static function datedifYD(float $difference, int $startYears, int $endYears, DateTime $PHPStartDateObject, DateTime $PHPEndDateObject): int
+ {
+ $retVal = (int) $difference;
+ if ($endYears > $startYears) {
+ $isLeapStartYear = $PHPStartDateObject->format('L');
+ $wasLeapEndYear = $PHPEndDateObject->format('L');
+
+ // Adjust end year to be as close as possible as start year
+ while ($PHPEndDateObject >= $PHPStartDateObject) {
+ $PHPEndDateObject->modify('-1 year');
+ //$endYears = $PHPEndDateObject->format('Y');
+ }
+ $PHPEndDateObject->modify('+1 year');
+
+ // Get the result
+ $retVal = (int) $PHPEndDateObject->diff($PHPStartDateObject)->days;
+
+ // Adjust for leap years cases
+ $isLeapEndYear = $PHPEndDateObject->format('L');
+ $limit = new DateTime($PHPEndDateObject->format('Y-02-29'));
+ if (!$isLeapStartYear && !$wasLeapEndYear && $isLeapEndYear && $PHPEndDateObject >= $limit) {
+ --$retVal;
+ }
+ }
+
+ return (int) $retVal;
+ }
+
+ private static function datedifYM(DateInterval $PHPDiffDateObject): int
+ {
+ return (int) $PHPDiffDateObject->format('%m');
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Helpers.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Helpers.php
new file mode 100644
index 00000000..1e9af6cb
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Helpers.php
@@ -0,0 +1,287 @@
+format('m');
+ $oYear = (int) $PHPDateObject->format('Y');
+
+ $adjustmentMonthsString = (string) $adjustmentMonths;
+ if ($adjustmentMonths > 0) {
+ $adjustmentMonthsString = '+' . $adjustmentMonths;
+ }
+ if ($adjustmentMonths != 0) {
+ $PHPDateObject->modify($adjustmentMonthsString . ' months');
+ }
+ $nMonth = (int) $PHPDateObject->format('m');
+ $nYear = (int) $PHPDateObject->format('Y');
+
+ $monthDiff = ($nMonth - $oMonth) + (($nYear - $oYear) * 12);
+ if ($monthDiff != $adjustmentMonths) {
+ $adjustDays = (int) $PHPDateObject->format('d');
+ $adjustDaysString = '-' . $adjustDays . ' days';
+ $PHPDateObject->modify($adjustDaysString);
+ }
+
+ return $PHPDateObject;
+ }
+
+ /**
+ * Help reduce perceived complexity of some tests.
+ */
+ public static function replaceIfEmpty(mixed &$value, mixed $altValue): void
+ {
+ $value = $value ?: $altValue;
+ }
+
+ /**
+ * Adjust year in ambiguous situations.
+ */
+ public static function adjustYear(string $testVal1, string $testVal2, string &$testVal3): void
+ {
+ if (!is_numeric($testVal1) || $testVal1 < 31) {
+ if (!is_numeric($testVal2) || $testVal2 < 12) {
+ if (is_numeric($testVal3) && $testVal3 < 12) {
+ $testVal3 += 2000;
+ }
+ }
+ }
+ }
+
+ /**
+ * Return result in one of three formats.
+ */
+ public static function returnIn3FormatsArray(array $dateArray, bool $noFrac = false): DateTime|float|int
+ {
+ $retType = Functions::getReturnDateType();
+ if ($retType === Functions::RETURNDATE_PHP_DATETIME_OBJECT) {
+ return new DateTime(
+ $dateArray['year']
+ . '-' . $dateArray['month']
+ . '-' . $dateArray['day']
+ . ' ' . $dateArray['hour']
+ . ':' . $dateArray['minute']
+ . ':' . $dateArray['second']
+ );
+ }
+ $excelDateValue
+ = SharedDateHelper::formattedPHPToExcel(
+ $dateArray['year'],
+ $dateArray['month'],
+ $dateArray['day'],
+ $dateArray['hour'],
+ $dateArray['minute'],
+ $dateArray['second']
+ );
+ if ($retType === Functions::RETURNDATE_EXCEL) {
+ return $noFrac ? floor($excelDateValue) : $excelDateValue;
+ }
+ // RETURNDATE_UNIX_TIMESTAMP)
+
+ return SharedDateHelper::excelToTimestamp($excelDateValue);
+ }
+
+ /**
+ * Return result in one of three formats.
+ */
+ public static function returnIn3FormatsFloat(float $excelDateValue): float|int|DateTime
+ {
+ $retType = Functions::getReturnDateType();
+ if ($retType === Functions::RETURNDATE_EXCEL) {
+ return $excelDateValue;
+ }
+ if ($retType === Functions::RETURNDATE_UNIX_TIMESTAMP) {
+ return SharedDateHelper::excelToTimestamp($excelDateValue);
+ }
+ // RETURNDATE_PHP_DATETIME_OBJECT
+
+ return SharedDateHelper::excelToDateTimeObject($excelDateValue);
+ }
+
+ /**
+ * Return result in one of three formats.
+ */
+ public static function returnIn3FormatsObject(DateTime $PHPDateObject): DateTime|float|int
+ {
+ $retType = Functions::getReturnDateType();
+ if ($retType === Functions::RETURNDATE_PHP_DATETIME_OBJECT) {
+ return $PHPDateObject;
+ }
+ if ($retType === Functions::RETURNDATE_EXCEL) {
+ return (float) SharedDateHelper::PHPToExcel($PHPDateObject);
+ }
+ // RETURNDATE_UNIX_TIMESTAMP
+ $stamp = SharedDateHelper::PHPToExcel($PHPDateObject);
+ $stamp = is_bool($stamp) ? ((int) $stamp) : $stamp;
+
+ return SharedDateHelper::excelToTimestamp($stamp);
+ }
+
+ private static function baseDate(): int
+ {
+ if (Functions::getCompatibilityMode() === Functions::COMPATIBILITY_OPENOFFICE) {
+ return 0;
+ }
+ if (SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_MAC_1904) {
+ return 0;
+ }
+
+ return 1;
+ }
+
+ /**
+ * Many functions accept null/false/true argument treated as 0/0/1.
+ */
+ public static function nullFalseTrueToNumber(mixed &$number, bool $allowBool = true): void
+ {
+ $number = Functions::flattenSingleValue($number);
+ $nullVal = self::baseDate();
+ if ($number === null) {
+ $number = $nullVal;
+ } elseif ($allowBool && is_bool($number)) {
+ $number = $nullVal + (int) $number;
+ }
+ }
+
+ /**
+ * Many functions accept null argument treated as 0.
+ */
+ public static function validateNumericNull(mixed $number): int|float
+ {
+ $number = Functions::flattenSingleValue($number);
+ if ($number === null) {
+ return 0;
+ }
+ if (is_int($number)) {
+ return $number;
+ }
+ if (is_numeric($number)) {
+ return (float) $number;
+ }
+
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ /**
+ * Many functions accept null/false/true argument treated as 0/0/1.
+ *
+ * @phpstan-assert float $number
+ */
+ public static function validateNotNegative(mixed $number): float
+ {
+ if (!is_numeric($number)) {
+ throw new Exception(ExcelError::VALUE());
+ }
+ if ($number >= 0) {
+ return (float) $number;
+ }
+
+ throw new Exception(ExcelError::NAN());
+ }
+
+ public static function silly1900(DateTime $PHPDateObject, string $mod = '-1 day'): void
+ {
+ $isoDate = $PHPDateObject->format('c');
+ if ($isoDate < '1900-03-01') {
+ $PHPDateObject->modify($mod);
+ }
+ }
+
+ public static function dateParse(string $string): array
+ {
+ return self::forceArray(date_parse($string));
+ }
+
+ public static function dateParseSucceeded(array $dateArray): bool
+ {
+ return $dateArray['error_count'] === 0;
+ }
+
+ /**
+ * Despite documentation, date_parse probably never returns false.
+ * Just in case, this routine helps guarantee it.
+ *
+ * @param array|false $dateArray
+ */
+ private static function forceArray(array|bool $dateArray): array
+ {
+ return is_array($dateArray) ? $dateArray : ['error_count' => 1];
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Month.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Month.php
new file mode 100644
index 00000000..a90c0517
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Month.php
@@ -0,0 +1,104 @@
+getMessage();
+ }
+ $dateValue = floor($dateValue);
+ $adjustmentMonths = floor($adjustmentMonths);
+
+ // Execute function
+ $PHPDateObject = Helpers::adjustDateByMonths($dateValue, $adjustmentMonths);
+
+ return Helpers::returnIn3FormatsObject($PHPDateObject);
+ }
+
+ /**
+ * EOMONTH.
+ *
+ * Returns the date value for the last day of the month that is the indicated number of months
+ * before or after start_date.
+ * Use EOMONTH to calculate maturity dates or due dates that fall on the last day of the month.
+ *
+ * Excel Function:
+ * EOMONTH(dateValue,adjustmentMonths)
+ *
+ * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
+ * PHP DateTime object, or a standard date string
+ * Or can be an array of date values
+ * @param array|int $adjustmentMonths The number of months before or after start_date.
+ * A positive value for months yields a future date;
+ * a negative value yields a past date.
+ * Or can be an array of adjustment values
+ *
+ * @return array|DateTime|float|int|string Excel date/time serial value, PHP date/time serial value or PHP date/time object,
+ * depending on the value of the ReturnDateType flag
+ * If an array of values is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function lastDay(mixed $dateValue, array|float|int|bool|string $adjustmentMonths): array|string|DateTime|float|int
+ {
+ if (is_array($dateValue) || is_array($adjustmentMonths)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $dateValue, $adjustmentMonths);
+ }
+
+ try {
+ $dateValue = Helpers::getDateValue($dateValue, false);
+ $adjustmentMonths = Helpers::validateNumericNull($adjustmentMonths);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+ $dateValue = floor($dateValue);
+ $adjustmentMonths = floor($adjustmentMonths);
+
+ // Execute function
+ $PHPDateObject = Helpers::adjustDateByMonths($dateValue, $adjustmentMonths + 1);
+ $adjustDays = (int) $PHPDateObject->format('d');
+ $adjustDaysString = '-' . $adjustDays . ' days';
+ $PHPDateObject->modify($adjustDaysString);
+
+ return Helpers::returnIn3FormatsObject($PHPDateObject);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/NetworkDays.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/NetworkDays.php
new file mode 100644
index 00000000..503e30e8
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/NetworkDays.php
@@ -0,0 +1,119 @@
+getMessage();
+ }
+
+ // Execute function
+ $startDow = self::calcStartDow($startDate);
+ $endDow = self::calcEndDow($endDate);
+ $wholeWeekDays = (int) floor(($endDate - $startDate) / 7) * 5;
+ $partWeekDays = self::calcPartWeekDays($startDow, $endDow);
+
+ // Test any extra holiday parameters
+ $holidayCountedArray = [];
+ foreach ($holidayArray as $holidayDate) {
+ if (($holidayDate >= $startDate) && ($holidayDate <= $endDate)) {
+ if ((Week::day($holidayDate, 2) < 6) && (!in_array($holidayDate, $holidayCountedArray))) {
+ --$partWeekDays;
+ $holidayCountedArray[] = $holidayDate;
+ }
+ }
+ }
+
+ return self::applySign($wholeWeekDays + $partWeekDays, $sDate, $eDate);
+ }
+
+ private static function calcStartDow(float $startDate): int
+ {
+ $startDow = 6 - (int) Week::day($startDate, 2);
+ if ($startDow < 0) {
+ $startDow = 5;
+ }
+
+ return $startDow;
+ }
+
+ private static function calcEndDow(float $endDate): int
+ {
+ $endDow = (int) Week::day($endDate, 2);
+ if ($endDow >= 6) {
+ $endDow = 0;
+ }
+
+ return $endDow;
+ }
+
+ private static function calcPartWeekDays(int $startDow, int $endDow): int
+ {
+ $partWeekDays = $endDow + $startDow;
+ if ($partWeekDays > 5) {
+ $partWeekDays -= 5;
+ }
+
+ return $partWeekDays;
+ }
+
+ private static function applySign(int $result, float $sDate, float $eDate): int
+ {
+ return ($sDate > $eDate) ? -$result : $result;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Time.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Time.php
new file mode 100644
index 00000000..3f8f324c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Time.php
@@ -0,0 +1,130 @@
+getMessage();
+ }
+
+ self::adjustSecond($second, $minute);
+ self::adjustMinute($minute, $hour);
+
+ if ($hour > 23) {
+ $hour = $hour % 24;
+ } elseif ($hour < 0) {
+ return ExcelError::NAN();
+ }
+
+ // Execute function
+ $retType = Functions::getReturnDateType();
+ if ($retType === Functions::RETURNDATE_EXCEL) {
+ $calendar = SharedDateHelper::getExcelCalendar();
+ $date = (int) ($calendar !== SharedDateHelper::CALENDAR_WINDOWS_1900);
+
+ return (float) SharedDateHelper::formattedPHPToExcel($calendar, 1, $date, $hour, $minute, $second);
+ }
+ if ($retType === Functions::RETURNDATE_UNIX_TIMESTAMP) {
+ return (int) SharedDateHelper::excelToTimestamp(SharedDateHelper::formattedPHPToExcel(1970, 1, 1, $hour, $minute, $second)); // -2147468400; // -2147472000 + 3600
+ }
+ // RETURNDATE_PHP_DATETIME_OBJECT
+ // Hour has already been normalized (0-23) above
+ $phpDateObject = new DateTime('1900-01-01 ' . $hour . ':' . $minute . ':' . $second);
+
+ return $phpDateObject;
+ }
+
+ private static function adjustSecond(int &$second, int &$minute): void
+ {
+ if ($second < 0) {
+ $minute += floor($second / 60);
+ $second = 60 - abs($second % 60);
+ if ($second == 60) {
+ $second = 0;
+ }
+ } elseif ($second >= 60) {
+ $minute += floor($second / 60);
+ $second = $second % 60;
+ }
+ }
+
+ private static function adjustMinute(int &$minute, int &$hour): void
+ {
+ if ($minute < 0) {
+ $hour += floor($minute / 60);
+ $minute = 60 - abs($minute % 60);
+ if ($minute == 60) {
+ $minute = 0;
+ }
+ } elseif ($minute >= 60) {
+ $hour += floor($minute / 60);
+ $minute = $minute % 60;
+ }
+ }
+
+ /**
+ * @param mixed $value expect int
+ */
+ private static function toIntWithNullBool(mixed $value): int
+ {
+ $value = $value ?? 0;
+ if (is_bool($value)) {
+ $value = (int) $value;
+ }
+ if (!is_numeric($value)) {
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ return (int) $value;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/TimeParts.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/TimeParts.php
new file mode 100644
index 00000000..de522692
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/TimeParts.php
@@ -0,0 +1,135 @@
+getMessage();
+ }
+
+ // Execute function
+ $timeValue = fmod($timeValue, 1);
+ $timeValue = SharedDateHelper::excelToDateTimeObject($timeValue);
+ SharedDateHelper::roundMicroseconds($timeValue);
+
+ return (int) $timeValue->format('H');
+ }
+
+ /**
+ * MINUTE.
+ *
+ * Returns the minutes of a time value.
+ * The minute is given as an integer, ranging from 0 to 59.
+ *
+ * Excel Function:
+ * MINUTE(timeValue)
+ *
+ * @param mixed $timeValue Excel date serial value (float), PHP date timestamp (integer),
+ * PHP DateTime object, or a standard time string
+ * Or can be an array of date/time values
+ *
+ * @return array|int|string Minute
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function minute(mixed $timeValue): array|string|int
+ {
+ if (is_array($timeValue)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $timeValue);
+ }
+
+ try {
+ Helpers::nullFalseTrueToNumber($timeValue);
+ if (!is_numeric($timeValue)) {
+ $timeValue = Helpers::getTimeValue($timeValue);
+ }
+ Helpers::validateNotNegative($timeValue);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Execute function
+ $timeValue = fmod($timeValue, 1);
+ $timeValue = SharedDateHelper::excelToDateTimeObject($timeValue);
+ SharedDateHelper::roundMicroseconds($timeValue);
+
+ return (int) $timeValue->format('i');
+ }
+
+ /**
+ * SECOND.
+ *
+ * Returns the seconds of a time value.
+ * The minute is given as an integer, ranging from 0 to 59.
+ *
+ * Excel Function:
+ * SECOND(timeValue)
+ *
+ * @param mixed $timeValue Excel date serial value (float), PHP date timestamp (integer),
+ * PHP DateTime object, or a standard time string
+ * Or can be an array of date/time values
+ *
+ * @return array|int|string Second
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function second(mixed $timeValue): array|string|int
+ {
+ if (is_array($timeValue)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $timeValue);
+ }
+
+ try {
+ Helpers::nullFalseTrueToNumber($timeValue);
+ if (!is_numeric($timeValue)) {
+ $timeValue = Helpers::getTimeValue($timeValue);
+ }
+ Helpers::validateNotNegative($timeValue);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Execute function
+ $timeValue = fmod($timeValue, 1);
+ $timeValue = SharedDateHelper::excelToDateTimeObject($timeValue);
+ SharedDateHelper::roundMicroseconds($timeValue);
+
+ return (int) $timeValue->format('s');
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/TimeValue.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/TimeValue.php
new file mode 100644
index 00000000..d8c53b47
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/TimeValue.php
@@ -0,0 +1,80 @@
+ 24) {
+ $arraySplit[0] = ((int) $arraySplit[0] % 24);
+ $timeValue = implode(':', $arraySplit);
+ }
+
+ $PHPDateArray = Helpers::dateParse($timeValue);
+ $retValue = ExcelError::VALUE();
+ if (Helpers::dateParseSucceeded($PHPDateArray)) {
+ $hour = $PHPDateArray['hour'];
+ $minute = $PHPDateArray['minute'];
+ $second = $PHPDateArray['second'];
+ // OpenOffice-specific code removed - it works just like Excel
+ $excelDateValue = SharedDateHelper::formattedPHPToExcel(1900, 1, 1, $hour, $minute, $second) - 1;
+
+ $retType = Functions::getReturnDateType();
+ if ($retType === Functions::RETURNDATE_EXCEL) {
+ $retValue = (float) $excelDateValue;
+ } elseif ($retType === Functions::RETURNDATE_UNIX_TIMESTAMP) {
+ $retValue = (int) SharedDateHelper::excelToTimestamp($excelDateValue + 25569) - 3600;
+ } else {
+ $retValue = new Datetime('1900-01-01 ' . $PHPDateArray['hour'] . ':' . $PHPDateArray['minute'] . ':' . $PHPDateArray['second']);
+ }
+ }
+
+ return $retValue;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Week.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Week.php
new file mode 100644
index 00000000..e620b4ca
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/Week.php
@@ -0,0 +1,274 @@
+getMessage();
+ }
+
+ // Execute function
+ $PHPDateObject = SharedDateHelper::excelToDateTimeObject($dateValue);
+ if ($method == Constants::STARTWEEK_MONDAY_ISO) {
+ Helpers::silly1900($PHPDateObject);
+
+ return (int) $PHPDateObject->format('W');
+ }
+ if (self::buggyWeekNum1904($method, $origDateValueNull, $PHPDateObject)) {
+ return 0;
+ }
+ Helpers::silly1900($PHPDateObject, '+ 5 years'); // 1905 calendar matches
+ $dayOfYear = (int) $PHPDateObject->format('z');
+ $PHPDateObject->modify('-' . $dayOfYear . ' days');
+ $firstDayOfFirstWeek = (int) $PHPDateObject->format('w');
+ $daysInFirstWeek = (6 - $firstDayOfFirstWeek + $method) % 7;
+ $daysInFirstWeek += 7 * !$daysInFirstWeek;
+ $endFirstWeek = $daysInFirstWeek - 1;
+ $weekOfYear = floor(($dayOfYear - $endFirstWeek + 13) / 7);
+
+ return (int) $weekOfYear;
+ }
+
+ /**
+ * ISOWEEKNUM.
+ *
+ * Returns the ISO 8601 week number of the year for a specified date.
+ *
+ * Excel Function:
+ * ISOWEEKNUM(dateValue)
+ *
+ * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
+ * PHP DateTime object, or a standard date string
+ * Or can be an array of date values
+ *
+ * @return array|int|string Week Number
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function isoWeekNumber(mixed $dateValue): array|int|string
+ {
+ if (is_array($dateValue)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $dateValue);
+ }
+
+ if (self::apparentBug($dateValue)) {
+ return 52;
+ }
+
+ try {
+ $dateValue = Helpers::getDateValue($dateValue);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Execute function
+ $PHPDateObject = SharedDateHelper::excelToDateTimeObject($dateValue);
+ Helpers::silly1900($PHPDateObject);
+
+ return (int) $PHPDateObject->format('W');
+ }
+
+ /**
+ * WEEKDAY.
+ *
+ * Returns the day of the week for a specified date. The day is given as an integer
+ * ranging from 0 to 7 (dependent on the requested style).
+ *
+ * Excel Function:
+ * WEEKDAY(dateValue[,style])
+ *
+ * @param null|array|bool|float|int|string $dateValue Excel date serial value (float), PHP date timestamp (integer),
+ * PHP DateTime object, or a standard date string
+ * Or can be an array of date values
+ * @param mixed $style A number that determines the type of return value
+ * 1 or omitted Numbers 1 (Sunday) through 7 (Saturday).
+ * 2 Numbers 1 (Monday) through 7 (Sunday).
+ * 3 Numbers 0 (Monday) through 6 (Sunday).
+ * Or can be an array of styles
+ *
+ * @return array|int|string Day of the week value
+ * If an array of values is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function day(null|array|float|int|string|bool $dateValue, mixed $style = 1): array|string|int
+ {
+ if (is_array($dateValue) || is_array($style)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $dateValue, $style);
+ }
+
+ try {
+ $dateValue = Helpers::getDateValue($dateValue);
+ $style = self::validateStyle($style);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Execute function
+ $PHPDateObject = SharedDateHelper::excelToDateTimeObject($dateValue);
+ Helpers::silly1900($PHPDateObject);
+ $DoW = (int) $PHPDateObject->format('w');
+
+ switch ($style) {
+ case 1:
+ ++$DoW;
+
+ break;
+ case 2:
+ $DoW = self::dow0Becomes7($DoW);
+
+ break;
+ case 3:
+ $DoW = self::dow0Becomes7($DoW) - 1;
+
+ break;
+ }
+
+ return $DoW;
+ }
+
+ /**
+ * @param mixed $style expect int
+ */
+ private static function validateStyle(mixed $style): int
+ {
+ if (!is_numeric($style)) {
+ throw new Exception(ExcelError::VALUE());
+ }
+ $style = (int) $style;
+ if (($style < 1) || ($style > 3)) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $style;
+ }
+
+ private static function dow0Becomes7(int $DoW): int
+ {
+ return ($DoW === 0) ? 7 : $DoW;
+ }
+
+ /**
+ * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
+ * PHP DateTime object, or a standard date string
+ */
+ private static function apparentBug(mixed $dateValue): bool
+ {
+ if (SharedDateHelper::getExcelCalendar() !== SharedDateHelper::CALENDAR_MAC_1904) {
+ if (is_bool($dateValue)) {
+ return true;
+ }
+ if (is_numeric($dateValue) && !((int) $dateValue)) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Validate dateValue parameter.
+ */
+ private static function validateDateValue(mixed $dateValue): float
+ {
+ if (is_bool($dateValue)) {
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ return Helpers::getDateValue($dateValue);
+ }
+
+ /**
+ * Validate method parameter.
+ */
+ private static function validateMethod(mixed $method): int
+ {
+ if ($method === null) {
+ $method = Constants::STARTWEEK_SUNDAY;
+ }
+
+ if (!is_numeric($method)) {
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ $method = (int) $method;
+ if (!array_key_exists($method, Constants::METHODARR)) {
+ throw new Exception(ExcelError::NAN());
+ }
+ $method = Constants::METHODARR[$method];
+
+ return $method;
+ }
+
+ private static function buggyWeekNum1900(int $method): bool
+ {
+ return $method === Constants::DOW_SUNDAY && SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_WINDOWS_1900;
+ }
+
+ private static function buggyWeekNum1904(int $method, bool $origNull, DateTime $dateObject): bool
+ {
+ // This appears to be another Excel bug.
+
+ return $method === Constants::DOW_SUNDAY && SharedDateHelper::getExcelCalendar() === SharedDateHelper::CALENDAR_MAC_1904
+ && !$origNull && $dateObject->format('Y-m-d') === '1904-01-01';
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/WorkDay.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/WorkDay.php
new file mode 100644
index 00000000..4e4ed3c8
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/WorkDay.php
@@ -0,0 +1,198 @@
+getMessage();
+ }
+
+ $startDate = (float) floor($startDate);
+ $endDays = (int) floor($endDays);
+ // If endDays is 0, we always return startDate
+ if ($endDays == 0) {
+ return $startDate;
+ }
+ if ($endDays < 0) {
+ return self::decrementing($startDate, $endDays, $holidayArray);
+ }
+
+ return self::incrementing($startDate, $endDays, $holidayArray);
+ }
+
+ /**
+ * Use incrementing logic to determine Workday.
+ */
+ private static function incrementing(float $startDate, int $endDays, array $holidayArray): float|int|DateTime
+ {
+ // Adjust the start date if it falls over a weekend
+ $startDoW = self::getWeekDay($startDate, 3);
+ if ($startDoW >= 5) {
+ $startDate += 7 - $startDoW;
+ --$endDays;
+ }
+
+ // Add endDays
+ $endDate = (float) $startDate + ((int) ($endDays / 5) * 7);
+ $endDays = $endDays % 5;
+ while ($endDays > 0) {
+ ++$endDate;
+ // Adjust the calculated end date if it falls over a weekend
+ $endDow = self::getWeekDay($endDate, 3);
+ if ($endDow >= 5) {
+ $endDate += 7 - $endDow;
+ }
+ --$endDays;
+ }
+
+ // Test any extra holiday parameters
+ if (!empty($holidayArray)) {
+ $endDate = self::incrementingArray($startDate, $endDate, $holidayArray);
+ }
+
+ return Helpers::returnIn3FormatsFloat($endDate);
+ }
+
+ private static function incrementingArray(float $startDate, float $endDate, array $holidayArray): float
+ {
+ $holidayCountedArray = $holidayDates = [];
+ foreach ($holidayArray as $holidayDate) {
+ if (self::getWeekDay($holidayDate, 3) < 5) {
+ $holidayDates[] = $holidayDate;
+ }
+ }
+ sort($holidayDates, SORT_NUMERIC);
+ foreach ($holidayDates as $holidayDate) {
+ if (($holidayDate >= $startDate) && ($holidayDate <= $endDate)) {
+ if (!in_array($holidayDate, $holidayCountedArray)) {
+ ++$endDate;
+ $holidayCountedArray[] = $holidayDate;
+ }
+ }
+ // Adjust the calculated end date if it falls over a weekend
+ $endDoW = self::getWeekDay($endDate, 3);
+ if ($endDoW >= 5) {
+ $endDate += 7 - $endDoW;
+ }
+ }
+
+ return $endDate;
+ }
+
+ /**
+ * Use decrementing logic to determine Workday.
+ */
+ private static function decrementing(float $startDate, int $endDays, array $holidayArray): float|int|DateTime
+ {
+ // Adjust the start date if it falls over a weekend
+ $startDoW = self::getWeekDay($startDate, 3);
+ if ($startDoW >= 5) {
+ $startDate += -$startDoW + 4;
+ ++$endDays;
+ }
+
+ // Add endDays
+ $endDate = (float) $startDate + ((int) ($endDays / 5) * 7);
+ $endDays = $endDays % 5;
+ while ($endDays < 0) {
+ --$endDate;
+ // Adjust the calculated end date if it falls over a weekend
+ $endDow = self::getWeekDay($endDate, 3);
+ if ($endDow >= 5) {
+ $endDate += 4 - $endDow;
+ }
+ ++$endDays;
+ }
+
+ // Test any extra holiday parameters
+ if (!empty($holidayArray)) {
+ $endDate = self::decrementingArray($startDate, $endDate, $holidayArray);
+ }
+
+ return Helpers::returnIn3FormatsFloat($endDate);
+ }
+
+ private static function decrementingArray(float $startDate, float $endDate, array $holidayArray): float
+ {
+ $holidayCountedArray = $holidayDates = [];
+ foreach ($holidayArray as $holidayDate) {
+ if (self::getWeekDay($holidayDate, 3) < 5) {
+ $holidayDates[] = $holidayDate;
+ }
+ }
+ rsort($holidayDates, SORT_NUMERIC);
+ foreach ($holidayDates as $holidayDate) {
+ if (($holidayDate <= $startDate) && ($holidayDate >= $endDate)) {
+ if (!in_array($holidayDate, $holidayCountedArray)) {
+ --$endDate;
+ $holidayCountedArray[] = $holidayDate;
+ }
+ }
+ // Adjust the calculated end date if it falls over a weekend
+ $endDoW = self::getWeekDay($endDate, 3);
+ /** int $endDoW */
+ if ($endDoW >= 5) {
+ $endDate += -$endDoW + 4;
+ }
+ }
+
+ return $endDate;
+ }
+
+ private static function getWeekDay(float $date, int $wd): int
+ {
+ $result = Functions::scalar(Week::day($date, $wd));
+
+ return is_int($result) ? $result : -1;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/YearFrac.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/YearFrac.php
new file mode 100644
index 00000000..2713754a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/DateTimeExcel/YearFrac.php
@@ -0,0 +1,124 @@
+getMessage();
+ }
+
+ return match ($method) {
+ 0 => Functions::scalar(Days360::between($startDate, $endDate)) / 360,
+ 1 => self::method1($startDate, $endDate),
+ 2 => Functions::scalar(Difference::interval($startDate, $endDate)) / 360,
+ 3 => Functions::scalar(Difference::interval($startDate, $endDate)) / 365,
+ 4 => Functions::scalar(Days360::between($startDate, $endDate, true)) / 360,
+ default => ExcelError::NAN(),
+ };
+ }
+
+ /**
+ * Excel 1900 calendar treats date argument of null as 1900-01-00. Really.
+ */
+ private static function excelBug(float $sDate, mixed $startDate, mixed $endDate, int $method): float
+ {
+ if (Functions::getCompatibilityMode() !== Functions::COMPATIBILITY_OPENOFFICE && SharedDateHelper::getExcelCalendar() !== SharedDateHelper::CALENDAR_MAC_1904) {
+ if ($endDate === null && $startDate !== null) {
+ if (DateParts::month($sDate) == 12 && DateParts::day($sDate) === 31 && $method === 0) {
+ $sDate += 2;
+ } else {
+ ++$sDate;
+ }
+ }
+ }
+
+ return $sDate;
+ }
+
+ private static function method1(float $startDate, float $endDate): float
+ {
+ $days = Functions::scalar(Difference::interval($startDate, $endDate));
+ $startYear = (int) DateParts::year($startDate);
+ $endYear = (int) DateParts::year($endDate);
+ $years = $endYear - $startYear + 1;
+ $startMonth = (int) DateParts::month($startDate);
+ $startDay = (int) DateParts::day($startDate);
+ $endMonth = (int) DateParts::month($endDate);
+ $endDay = (int) DateParts::day($endDate);
+ $startMonthDay = 100 * $startMonth + $startDay;
+ $endMonthDay = 100 * $endMonth + $endDay;
+ if ($years == 1) {
+ $tmpCalcAnnualBasis = 365 + (int) Helpers::isLeapYear($endYear);
+ } elseif ($years == 2 && $startMonthDay >= $endMonthDay) {
+ if (Helpers::isLeapYear($startYear)) {
+ $tmpCalcAnnualBasis = 365 + (int) ($startMonthDay <= 229);
+ } elseif (Helpers::isLeapYear($endYear)) {
+ $tmpCalcAnnualBasis = 365 + (int) ($endMonthDay >= 229);
+ } else {
+ $tmpCalcAnnualBasis = 365;
+ }
+ } else {
+ $tmpCalcAnnualBasis = 0;
+ for ($year = $startYear; $year <= $endYear; ++$year) {
+ $tmpCalcAnnualBasis += 365 + (int) Helpers::isLeapYear($year);
+ }
+ $tmpCalcAnnualBasis /= $years;
+ }
+
+ return $days / $tmpCalcAnnualBasis;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/ArrayArgumentHelper.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/ArrayArgumentHelper.php
new file mode 100644
index 00000000..0107f404
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/ArrayArgumentHelper.php
@@ -0,0 +1,190 @@
+indexStart = (int) array_shift($keys);
+ $this->rows = $this->rows($arguments);
+ $this->columns = $this->columns($arguments);
+
+ $this->argumentCount = count($arguments);
+ $this->arguments = $this->flattenSingleCellArrays($arguments, $this->rows, $this->columns);
+
+ $this->rows = $this->rows($arguments);
+ $this->columns = $this->columns($arguments);
+
+ if ($this->arrayArguments() > 2) {
+ throw new Exception('Formulae with more than two array arguments are not supported');
+ }
+ }
+
+ public function arguments(): array
+ {
+ return $this->arguments;
+ }
+
+ public function hasArrayArgument(): bool
+ {
+ return $this->arrayArguments() > 0;
+ }
+
+ public function getFirstArrayArgumentNumber(): int
+ {
+ $rowArrays = $this->filterArray($this->rows);
+ $columnArrays = $this->filterArray($this->columns);
+
+ for ($index = $this->indexStart; $index < $this->argumentCount; ++$index) {
+ if (isset($rowArrays[$index]) || isset($columnArrays[$index])) {
+ return ++$index;
+ }
+ }
+
+ return 0;
+ }
+
+ public function getSingleRowVector(): ?int
+ {
+ $rowVectors = $this->getRowVectors();
+
+ return count($rowVectors) === 1 ? array_pop($rowVectors) : null;
+ }
+
+ private function getRowVectors(): array
+ {
+ $rowVectors = [];
+ for ($index = $this->indexStart; $index < ($this->indexStart + $this->argumentCount); ++$index) {
+ if ($this->rows[$index] === 1 && $this->columns[$index] > 1) {
+ $rowVectors[] = $index;
+ }
+ }
+
+ return $rowVectors;
+ }
+
+ public function getSingleColumnVector(): ?int
+ {
+ $columnVectors = $this->getColumnVectors();
+
+ return count($columnVectors) === 1 ? array_pop($columnVectors) : null;
+ }
+
+ private function getColumnVectors(): array
+ {
+ $columnVectors = [];
+ for ($index = $this->indexStart; $index < ($this->indexStart + $this->argumentCount); ++$index) {
+ if ($this->rows[$index] > 1 && $this->columns[$index] === 1) {
+ $columnVectors[] = $index;
+ }
+ }
+
+ return $columnVectors;
+ }
+
+ public function getMatrixPair(): array
+ {
+ for ($i = $this->indexStart; $i < ($this->indexStart + $this->argumentCount - 1); ++$i) {
+ for ($j = $i + 1; $j < $this->argumentCount; ++$j) {
+ if (isset($this->rows[$i], $this->rows[$j])) {
+ return [$i, $j];
+ }
+ }
+ }
+
+ return [];
+ }
+
+ public function isVector(int $argument): bool
+ {
+ return $this->rows[$argument] === 1 || $this->columns[$argument] === 1;
+ }
+
+ public function isRowVector(int $argument): bool
+ {
+ return $this->rows[$argument] === 1;
+ }
+
+ public function isColumnVector(int $argument): bool
+ {
+ return $this->columns[$argument] === 1;
+ }
+
+ public function rowCount(int $argument): int
+ {
+ return $this->rows[$argument];
+ }
+
+ public function columnCount(int $argument): int
+ {
+ return $this->columns[$argument];
+ }
+
+ private function rows(array $arguments): array
+ {
+ return array_map(
+ fn ($argument): int => is_countable($argument) ? count($argument) : 1,
+ $arguments
+ );
+ }
+
+ private function columns(array $arguments): array
+ {
+ return array_map(
+ function (mixed $argument): int {
+ return is_array($argument) && is_array($argument[array_keys($argument)[0]])
+ ? count($argument[array_keys($argument)[0]])
+ : 1;
+ },
+ $arguments
+ );
+ }
+
+ public function arrayArguments(): int
+ {
+ $count = 0;
+ foreach (array_keys($this->arguments) as $argument) {
+ if ($this->rows[$argument] > 1 || $this->columns[$argument] > 1) {
+ ++$count;
+ }
+ }
+
+ return $count;
+ }
+
+ private function flattenSingleCellArrays(array $arguments, array $rows, array $columns): array
+ {
+ foreach ($arguments as $index => $argument) {
+ if ($rows[$index] === 1 && $columns[$index] === 1) {
+ while (is_array($argument)) {
+ $argument = array_pop($argument);
+ }
+ $arguments[$index] = $argument;
+ }
+ }
+
+ return $arguments;
+ }
+
+ private function filterArray(array $array): array
+ {
+ return array_filter(
+ $array,
+ fn ($value): bool => $value > 1
+ );
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/ArrayArgumentProcessor.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/ArrayArgumentProcessor.php
new file mode 100644
index 00000000..fb2c853b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/ArrayArgumentProcessor.php
@@ -0,0 +1,159 @@
+hasArrayArgument() === false) {
+ return [$method(...$arguments)];
+ }
+
+ if (self::$arrayArgumentHelper->arrayArguments() === 1) {
+ $nthArgument = self::$arrayArgumentHelper->getFirstArrayArgumentNumber();
+
+ return self::evaluateNthArgumentAsArray($method, $nthArgument, ...$arguments);
+ }
+
+ $singleRowVectorIndex = self::$arrayArgumentHelper->getSingleRowVector();
+ $singleColumnVectorIndex = self::$arrayArgumentHelper->getSingleColumnVector();
+
+ if ($singleRowVectorIndex !== null && $singleColumnVectorIndex !== null) {
+ // Basic logic for a single row vector and a single column vector
+ return self::evaluateVectorPair($method, $singleRowVectorIndex, $singleColumnVectorIndex, ...$arguments);
+ }
+
+ $matrixPair = self::$arrayArgumentHelper->getMatrixPair();
+ if ($matrixPair !== []) {
+ if (
+ (self::$arrayArgumentHelper->isVector($matrixPair[0]) === true
+ && self::$arrayArgumentHelper->isVector($matrixPair[1]) === false)
+ || (self::$arrayArgumentHelper->isVector($matrixPair[0]) === false
+ && self::$arrayArgumentHelper->isVector($matrixPair[1]) === true)
+ ) {
+ // Logic for a matrix and a vector (row or column)
+ return self::evaluateVectorMatrixPair($method, $matrixPair, ...$arguments);
+ }
+
+ // Logic for matrix/matrix, column vector/column vector or row vector/row vector
+ return self::evaluateMatrixPair($method, $matrixPair, ...$arguments);
+ }
+
+ // Still need to work out the logic for more than two array arguments,
+ // For the moment, we're throwing an Exception when we initialise the ArrayArgumentHelper
+ return ['#VALUE!'];
+ }
+
+ private static function evaluateVectorMatrixPair(callable $method, array $matrixIndexes, mixed ...$arguments): array
+ {
+ $matrix2 = array_pop($matrixIndexes);
+ /** @var array $matrixValues2 */
+ $matrixValues2 = $arguments[$matrix2];
+ $matrix1 = array_pop($matrixIndexes);
+ /** @var array $matrixValues1 */
+ $matrixValues1 = $arguments[$matrix1];
+
+ $rows = min(array_map([self::$arrayArgumentHelper, 'rowCount'], [$matrix1, $matrix2]));
+ $columns = min(array_map([self::$arrayArgumentHelper, 'columnCount'], [$matrix1, $matrix2]));
+
+ if ($rows === 1) {
+ $rows = max(array_map([self::$arrayArgumentHelper, 'rowCount'], [$matrix1, $matrix2]));
+ }
+ if ($columns === 1) {
+ $columns = max(array_map([self::$arrayArgumentHelper, 'columnCount'], [$matrix1, $matrix2]));
+ }
+
+ $result = [];
+ for ($rowIndex = 0; $rowIndex < $rows; ++$rowIndex) {
+ for ($columnIndex = 0; $columnIndex < $columns; ++$columnIndex) {
+ $rowIndex1 = self::$arrayArgumentHelper->isRowVector($matrix1) ? 0 : $rowIndex;
+ $columnIndex1 = self::$arrayArgumentHelper->isColumnVector($matrix1) ? 0 : $columnIndex;
+ $value1 = $matrixValues1[$rowIndex1][$columnIndex1];
+ $rowIndex2 = self::$arrayArgumentHelper->isRowVector($matrix2) ? 0 : $rowIndex;
+ $columnIndex2 = self::$arrayArgumentHelper->isColumnVector($matrix2) ? 0 : $columnIndex;
+ $value2 = $matrixValues2[$rowIndex2][$columnIndex2];
+ $arguments[$matrix1] = $value1;
+ $arguments[$matrix2] = $value2;
+
+ $result[$rowIndex][$columnIndex] = $method(...$arguments);
+ }
+ }
+
+ return $result;
+ }
+
+ private static function evaluateMatrixPair(callable $method, array $matrixIndexes, mixed ...$arguments): array
+ {
+ $matrix2 = array_pop($matrixIndexes);
+ /** @var array $matrixValues2 */
+ $matrixValues2 = $arguments[$matrix2];
+ $matrix1 = array_pop($matrixIndexes);
+ /** @var array $matrixValues1 */
+ $matrixValues1 = $arguments[$matrix1];
+
+ $result = [];
+ foreach ($matrixValues1 as $rowIndex => $row) {
+ foreach ($row as $columnIndex => $value1) {
+ if (isset($matrixValues2[$rowIndex][$columnIndex]) === false) {
+ continue;
+ }
+
+ $value2 = $matrixValues2[$rowIndex][$columnIndex];
+ $arguments[$matrix1] = $value1;
+ $arguments[$matrix2] = $value2;
+
+ $result[$rowIndex][$columnIndex] = $method(...$arguments);
+ }
+ }
+
+ return $result;
+ }
+
+ private static function evaluateVectorPair(callable $method, int $rowIndex, int $columnIndex, mixed ...$arguments): array
+ {
+ $rowVector = Functions::flattenArray($arguments[$rowIndex]);
+ $columnVector = Functions::flattenArray($arguments[$columnIndex]);
+
+ $result = [];
+ foreach ($columnVector as $column) {
+ $rowResults = [];
+ foreach ($rowVector as $row) {
+ $arguments[$rowIndex] = $row;
+ $arguments[$columnIndex] = $column;
+
+ $rowResults[] = $method(...$arguments);
+ }
+ $result[] = $rowResults;
+ }
+
+ return $result;
+ }
+
+ /**
+ * Note, offset is from 1 (for the first argument) rather than from 0.
+ */
+ private static function evaluateNthArgumentAsArray(callable $method, int $nthArgument, mixed ...$arguments): array
+ {
+ $values = array_slice($arguments, $nthArgument - 1, 1);
+ /** @var array $values */
+ $values = array_pop($values);
+
+ $result = [];
+ foreach ($values as $value) {
+ $arguments[$nthArgument - 1] = $value;
+ $result[] = $method(...$arguments);
+ }
+
+ return $result;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/BranchPruner.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/BranchPruner.php
new file mode 100644
index 00000000..e6dbbcbd
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/BranchPruner.php
@@ -0,0 +1,201 @@
+branchPruningEnabled = $branchPruningEnabled;
+ }
+
+ public function clearBranchStore(): void
+ {
+ $this->branchStoreKeyCounter = 0;
+ }
+
+ public function initialiseForLoop(): void
+ {
+ $this->currentCondition = null;
+ $this->currentOnlyIf = null;
+ $this->currentOnlyIfNot = null;
+ $this->previousStoreKey = null;
+ $this->pendingStoreKey = empty($this->storeKeysStack) ? null : end($this->storeKeysStack);
+
+ if ($this->branchPruningEnabled) {
+ $this->initialiseCondition();
+ $this->initialiseThen();
+ $this->initialiseElse();
+ }
+ }
+
+ private function initialiseCondition(): void
+ {
+ if (isset($this->conditionMap[$this->pendingStoreKey]) && $this->conditionMap[$this->pendingStoreKey]) {
+ $this->currentCondition = $this->pendingStoreKey;
+ $stackDepth = count($this->storeKeysStack);
+ if ($stackDepth > 1) {
+ // nested if
+ $this->previousStoreKey = $this->storeKeysStack[$stackDepth - 2];
+ }
+ }
+ }
+
+ private function initialiseThen(): void
+ {
+ if (isset($this->thenMap[$this->pendingStoreKey]) && $this->thenMap[$this->pendingStoreKey]) {
+ $this->currentOnlyIf = $this->pendingStoreKey;
+ } elseif (
+ isset($this->previousStoreKey, $this->thenMap[$this->previousStoreKey])
+ && $this->thenMap[$this->previousStoreKey]
+ ) {
+ $this->currentOnlyIf = $this->previousStoreKey;
+ }
+ }
+
+ private function initialiseElse(): void
+ {
+ if (isset($this->elseMap[$this->pendingStoreKey]) && $this->elseMap[$this->pendingStoreKey]) {
+ $this->currentOnlyIfNot = $this->pendingStoreKey;
+ } elseif (
+ isset($this->previousStoreKey, $this->elseMap[$this->previousStoreKey])
+ && $this->elseMap[$this->previousStoreKey]
+ ) {
+ $this->currentOnlyIfNot = $this->previousStoreKey;
+ }
+ }
+
+ public function decrementDepth(): void
+ {
+ if (!empty($this->pendingStoreKey)) {
+ --$this->braceDepthMap[$this->pendingStoreKey];
+ }
+ }
+
+ public function incrementDepth(): void
+ {
+ if (!empty($this->pendingStoreKey)) {
+ ++$this->braceDepthMap[$this->pendingStoreKey];
+ }
+ }
+
+ public function functionCall(string $functionName): void
+ {
+ if ($this->branchPruningEnabled && ($functionName === 'IF(')) {
+ // we handle a new if
+ $this->pendingStoreKey = $this->getUnusedBranchStoreKey();
+ $this->storeKeysStack[] = $this->pendingStoreKey;
+ $this->conditionMap[$this->pendingStoreKey] = true;
+ $this->braceDepthMap[$this->pendingStoreKey] = 0;
+ } elseif (!empty($this->pendingStoreKey) && array_key_exists($this->pendingStoreKey, $this->braceDepthMap)) {
+ // this is not an if but we go deeper
+ ++$this->braceDepthMap[$this->pendingStoreKey];
+ }
+ }
+
+ public function argumentSeparator(): void
+ {
+ if (!empty($this->pendingStoreKey) && $this->braceDepthMap[$this->pendingStoreKey] === 0) {
+ // We must go to the IF next argument
+ if ($this->conditionMap[$this->pendingStoreKey]) {
+ $this->conditionMap[$this->pendingStoreKey] = false;
+ $this->thenMap[$this->pendingStoreKey] = true;
+ } elseif ($this->thenMap[$this->pendingStoreKey]) {
+ $this->thenMap[$this->pendingStoreKey] = false;
+ $this->elseMap[$this->pendingStoreKey] = true;
+ } elseif ($this->elseMap[$this->pendingStoreKey]) {
+ throw new Exception('Reaching fourth argument of an IF');
+ }
+ }
+ }
+
+ public function closingBrace(mixed $value): void
+ {
+ if (!empty($this->pendingStoreKey) && $this->braceDepthMap[$this->pendingStoreKey] === -1) {
+ // we are closing an IF(
+ if ($value !== 'IF(') {
+ throw new Exception('Parser bug we should be in an "IF("');
+ }
+
+ if ($this->conditionMap[$this->pendingStoreKey]) {
+ throw new Exception('We should not be expecting a condition');
+ }
+
+ $this->thenMap[$this->pendingStoreKey] = false;
+ $this->elseMap[$this->pendingStoreKey] = false;
+ --$this->braceDepthMap[$this->pendingStoreKey];
+ array_pop($this->storeKeysStack);
+ $this->pendingStoreKey = null;
+ }
+ }
+
+ public function currentCondition(): ?string
+ {
+ return $this->currentCondition;
+ }
+
+ public function currentOnlyIf(): ?string
+ {
+ return $this->currentOnlyIf;
+ }
+
+ public function currentOnlyIfNot(): ?string
+ {
+ return $this->currentOnlyIfNot;
+ }
+
+ private function getUnusedBranchStoreKey(): string
+ {
+ $storeKeyValue = 'storeKey-' . $this->branchStoreKeyCounter;
+ ++$this->branchStoreKeyCounter;
+
+ return $storeKeyValue;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/CyclicReferenceStack.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/CyclicReferenceStack.php
new file mode 100644
index 00000000..f4806b47
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/CyclicReferenceStack.php
@@ -0,0 +1,65 @@
+stack);
+ }
+
+ /**
+ * Push a new entry onto the stack.
+ */
+ public function push(mixed $value): void
+ {
+ $this->stack[$value] = $value;
+ }
+
+ /**
+ * Pop the last entry from the stack.
+ */
+ public function pop(): mixed
+ {
+ return array_pop($this->stack);
+ }
+
+ /**
+ * Test to see if a specified entry exists on the stack.
+ *
+ * @param mixed $value The value to test
+ */
+ public function onStack(mixed $value): bool
+ {
+ return isset($this->stack[$value]);
+ }
+
+ /**
+ * Clear the stack.
+ */
+ public function clear(): void
+ {
+ $this->stack = [];
+ }
+
+ /**
+ * Return an array of all entries on the stack.
+ *
+ * @return mixed[]
+ */
+ public function showStack(): array
+ {
+ return $this->stack;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/FormattedNumber.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/FormattedNumber.php
new file mode 100644
index 00000000..331fa448
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/FormattedNumber.php
@@ -0,0 +1,147 @@
+[-+])? *\% *(?[-+])? *(?[0-9]+\.?[0-9*]*(?:E[-+]?[0-9]*)?) *)|(?: *(?[-+])? *(?[0-9]+\.?[0-9]*(?:E[-+]?[0-9]*)?) *\% *))$~i';
+
+ // preg_quoted string for major currency symbols, with a %s for locale currency
+ private const CURRENCY_CONVERSION_LIST = '\$€£¥%s';
+
+ private const STRING_CONVERSION_LIST = [
+ [self::class, 'convertToNumberIfNumeric'],
+ [self::class, 'convertToNumberIfFraction'],
+ [self::class, 'convertToNumberIfPercent'],
+ [self::class, 'convertToNumberIfCurrency'],
+ ];
+
+ /**
+ * Identify whether a string contains a formatted numeric value,
+ * and convert it to a numeric if it is.
+ *
+ * @param string $operand string value to test
+ */
+ public static function convertToNumberIfFormatted(string &$operand): bool
+ {
+ foreach (self::STRING_CONVERSION_LIST as $conversionMethod) {
+ if ($conversionMethod($operand) === true) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Identify whether a string contains a numeric value,
+ * and convert it to a numeric if it is.
+ *
+ * @param string $operand string value to test
+ */
+ public static function convertToNumberIfNumeric(string &$operand): bool
+ {
+ $thousandsSeparator = preg_quote(StringHelper::getThousandsSeparator(), '/');
+ $value = preg_replace(['/(\d)' . $thousandsSeparator . '(\d)/u', '/([+-])\s+(\d)/u'], ['$1$2', '$1$2'], trim($operand));
+ $decimalSeparator = preg_quote(StringHelper::getDecimalSeparator(), '/');
+ $value = preg_replace(['/(\d)' . $decimalSeparator . '(\d)/u', '/([+-])\s+(\d)/u'], ['$1.$2', '$1$2'], $value ?? '');
+
+ if (is_numeric($value)) {
+ $operand = (float) $value;
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Identify whether a string contains a fractional numeric value,
+ * and convert it to a numeric if it is.
+ *
+ * @param string $operand string value to test
+ */
+ public static function convertToNumberIfFraction(string &$operand): bool
+ {
+ if (preg_match(self::STRING_REGEXP_FRACTION, $operand, $match)) {
+ $sign = ($match[1] === '-') ? '-' : '+';
+ $wholePart = ($match[3] === '') ? '' : ($sign . $match[3]);
+ $fractionFormula = '=' . $wholePart . $sign . $match[4];
+ $operand = Calculation::getInstance()->_calculateFormulaValue($fractionFormula);
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Identify whether a string contains a percentage, and if so,
+ * convert it to a numeric.
+ *
+ * @param string $operand string value to test
+ */
+ public static function convertToNumberIfPercent(string &$operand): bool
+ {
+ $thousandsSeparator = preg_quote(StringHelper::getThousandsSeparator(), '/');
+ $value = preg_replace('/(\d)' . $thousandsSeparator . '(\d)/u', '$1$2', trim($operand));
+ $decimalSeparator = preg_quote(StringHelper::getDecimalSeparator(), '/');
+ $value = preg_replace(['/(\d)' . $decimalSeparator . '(\d)/u', '/([+-])\s+(\d)/u'], ['$1.$2', '$1$2'], $value ?? '');
+
+ $match = [];
+ if ($value !== null && preg_match(self::STRING_REGEXP_PERCENT, $value, $match, PREG_UNMATCHED_AS_NULL)) {
+ //Calculate the percentage
+ $sign = ($match['PrefixedSign'] ?? $match['PrefixedSign2'] ?? $match['PostfixedSign']) ?? '';
+ $operand = (float) ($sign . ($match['PostfixedValue'] ?? $match['PrefixedValue'])) / 100;
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Identify whether a string contains a currency value, and if so,
+ * convert it to a numeric.
+ *
+ * @param string $operand string value to test
+ */
+ public static function convertToNumberIfCurrency(string &$operand): bool
+ {
+ $currencyRegexp = self::currencyMatcherRegexp();
+ $thousandsSeparator = preg_quote(StringHelper::getThousandsSeparator(), '/');
+ $value = preg_replace('/(\d)' . $thousandsSeparator . '(\d)/u', '$1$2', $operand);
+
+ $match = [];
+ if ($value !== null && preg_match($currencyRegexp, $value, $match, PREG_UNMATCHED_AS_NULL)) {
+ //Determine the sign
+ $sign = ($match['PrefixedSign'] ?? $match['PrefixedSign2'] ?? $match['PostfixedSign']) ?? '';
+ $decimalSeparator = StringHelper::getDecimalSeparator();
+ //Cast to a float
+ $intermediate = (string) ($match['PostfixedValue'] ?? $match['PrefixedValue']);
+ $intermediate = str_replace($decimalSeparator, '.', $intermediate);
+ if (is_numeric($intermediate)) {
+ $operand = (float) ($sign . str_replace($decimalSeparator, '.', $intermediate));
+
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ public static function currencyMatcherRegexp(): string
+ {
+ $currencyCodes = sprintf(self::CURRENCY_CONVERSION_LIST, preg_quote(StringHelper::getCurrencyCode(), '/'));
+ $decimalSeparator = preg_quote(StringHelper::getDecimalSeparator(), '/');
+
+ return '~^(?:(?: *(?[-+])? *(?[' . $currencyCodes . ']) *(?[-+])? *(?[0-9]+[' . $decimalSeparator . ']?[0-9*]*(?:E[-+]?[0-9]*)?) *)|(?: *(?[-+])? *(?[0-9]+' . $decimalSeparator . '?[0-9]*(?:E[-+]?[0-9]*)?) *(?[' . $currencyCodes . ']) *))$~ui';
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/Logger.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/Logger.php
new file mode 100644
index 00000000..9adcd559
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/Logger.php
@@ -0,0 +1,126 @@
+cellStack = $stack;
+ }
+
+ /**
+ * Enable/Disable Calculation engine logging.
+ */
+ public function setWriteDebugLog(bool $writeDebugLog): void
+ {
+ $this->writeDebugLog = $writeDebugLog;
+ }
+
+ /**
+ * Return whether calculation engine logging is enabled or disabled.
+ */
+ public function getWriteDebugLog(): bool
+ {
+ return $this->writeDebugLog;
+ }
+
+ /**
+ * Enable/Disable echoing of debug log information.
+ */
+ public function setEchoDebugLog(bool $echoDebugLog): void
+ {
+ $this->echoDebugLog = $echoDebugLog;
+ }
+
+ /**
+ * Return whether echoing of debug log information is enabled or disabled.
+ */
+ public function getEchoDebugLog(): bool
+ {
+ return $this->echoDebugLog;
+ }
+
+ /**
+ * Write an entry to the calculation engine debug log.
+ */
+ public function writeDebugLog(string $message, mixed ...$args): void
+ {
+ // Only write the debug log if logging is enabled
+ if ($this->writeDebugLog) {
+ $message = sprintf($message, ...$args);
+ $cellReference = implode(' -> ', $this->cellStack->showStack());
+ if ($this->echoDebugLog) {
+ echo $cellReference,
+ ($this->cellStack->count() > 0 ? ' => ' : ''),
+ $message,
+ PHP_EOL;
+ }
+ $this->debugLog[] = $cellReference
+ . ($this->cellStack->count() > 0 ? ' => ' : '')
+ . $message;
+ }
+ }
+
+ /**
+ * Write a series of entries to the calculation engine debug log.
+ *
+ * @param string[] $args
+ */
+ public function mergeDebugLog(array $args): void
+ {
+ if ($this->writeDebugLog) {
+ foreach ($args as $entry) {
+ $this->writeDebugLog($entry);
+ }
+ }
+ }
+
+ /**
+ * Clear the calculation engine debug log.
+ */
+ public function clearLog(): void
+ {
+ $this->debugLog = [];
+ }
+
+ /**
+ * Return the calculation engine debug log.
+ *
+ * @return string[]
+ */
+ public function getLog(): array
+ {
+ return $this->debugLog;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/Operands/Operand.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/Operands/Operand.php
new file mode 100644
index 00000000..05264c3f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engine/Operands/Operand.php
@@ -0,0 +1,10 @@
+value = $structuredReference;
+ }
+
+ public static function fromParser(string $formula, int $index, array $matches): self
+ {
+ $val = $matches[0];
+
+ $srCount = substr_count($val, self::OPEN_BRACE)
+ - substr_count($val, self::CLOSE_BRACE);
+ while ($srCount > 0) {
+ $srIndex = strlen($val);
+ $srStringRemainder = substr($formula, $index + $srIndex);
+ $closingPos = strpos($srStringRemainder, self::CLOSE_BRACE);
+ if ($closingPos === false) {
+ throw new Exception("Formula Error: No closing ']' to match opening '['");
+ }
+ $srStringRemainder = substr($srStringRemainder, 0, $closingPos + 1);
+ --$srCount;
+ if (str_contains($srStringRemainder, self::OPEN_BRACE)) {
+ ++$srCount;
+ }
+ $val .= $srStringRemainder;
+ }
+
+ return new self($val);
+ }
+
+ /**
+ * @throws Exception
+ * @throws \PhpOffice\PhpSpreadsheet\Exception
+ */
+ public function parse(Cell $cell): string
+ {
+ $this->getTableStructure($cell);
+ $cellRange = ($this->isRowReference()) ? $this->getRowReference($cell) : $this->getColumnReference();
+ $sheetName = '';
+ $worksheet = $this->table->getWorksheet();
+ if ($worksheet !== null && $worksheet !== $cell->getWorksheet()) {
+ $sheetName = "'" . $worksheet->getTitle() . "'!";
+ }
+
+ return $sheetName . $cellRange;
+ }
+
+ private function isRowReference(): bool
+ {
+ return str_contains($this->value, '[@')
+ || str_contains($this->value, '[' . self::ITEM_SPECIFIER_THIS_ROW . ']');
+ }
+
+ /**
+ * @throws Exception
+ * @throws \PhpOffice\PhpSpreadsheet\Exception
+ */
+ private function getTableStructure(Cell $cell): void
+ {
+ preg_match(self::TABLE_REFERENCE, $this->value, $matches);
+
+ $this->tableName = $matches[1];
+ $this->table = ($this->tableName === '')
+ ? $this->getTableForCell($cell)
+ : $this->getTableByName($cell);
+ $this->reference = $matches[2];
+ $tableRange = Coordinate::getRangeBoundaries($this->table->getRange());
+
+ $this->headersRow = ($this->table->getShowHeaderRow()) ? (int) $tableRange[0][1] : null;
+ $this->firstDataRow = ($this->table->getShowHeaderRow()) ? (int) $tableRange[0][1] + 1 : $tableRange[0][1];
+ $this->totalsRow = ($this->table->getShowTotalsRow()) ? (int) $tableRange[1][1] : null;
+ $this->lastDataRow = ($this->table->getShowTotalsRow()) ? (int) $tableRange[1][1] - 1 : $tableRange[1][1];
+
+ $cellParam = $cell;
+ $worksheet = $this->table->getWorksheet();
+ if ($worksheet !== null && $worksheet !== $cell->getWorksheet()) {
+ $cellParam = $worksheet->getCell('A1');
+ }
+ $this->columns = $this->getColumns($cellParam, $tableRange);
+ }
+
+ /**
+ * @throws Exception
+ * @throws \PhpOffice\PhpSpreadsheet\Exception
+ */
+ private function getTableForCell(Cell $cell): Table
+ {
+ $tables = $cell->getWorksheet()->getTableCollection();
+ foreach ($tables as $table) {
+ /** @var Table $table */
+ $range = $table->getRange();
+ if ($cell->isInRange($range) === true) {
+ $this->tableName = $table->getName();
+
+ return $table;
+ }
+ }
+
+ throw new Exception('Table for Structured Reference cannot be identified');
+ }
+
+ /**
+ * @throws Exception
+ * @throws \PhpOffice\PhpSpreadsheet\Exception
+ */
+ private function getTableByName(Cell $cell): Table
+ {
+ $table = $cell->getWorksheet()->getTableByName($this->tableName);
+
+ if ($table === null) {
+ $spreadsheet = $cell->getWorksheet()->getParent();
+ if ($spreadsheet !== null) {
+ $table = $spreadsheet->getTableByName($this->tableName);
+ }
+ }
+
+ if ($table === null) {
+ throw new Exception("Table {$this->tableName} for Structured Reference cannot be located");
+ }
+
+ return $table;
+ }
+
+ private function getColumns(Cell $cell, array $tableRange): array
+ {
+ $worksheet = $cell->getWorksheet();
+ $cellReference = $cell->getCoordinate();
+
+ $columns = [];
+ $lastColumn = ++$tableRange[1][0];
+ for ($column = $tableRange[0][0]; $column !== $lastColumn; ++$column) {
+ $columns[$column] = $worksheet
+ ->getCell($column . ($this->headersRow ?? ($this->firstDataRow - 1)))
+ ->getCalculatedValue();
+ }
+
+ $worksheet->getCell($cellReference);
+
+ return $columns;
+ }
+
+ private function getRowReference(Cell $cell): string
+ {
+ $reference = str_replace("\u{a0}", ' ', $this->reference);
+ /** @var string $reference */
+ $reference = str_replace('[' . self::ITEM_SPECIFIER_THIS_ROW . '],', '', $reference);
+
+ foreach ($this->columns as $columnId => $columnName) {
+ $columnName = str_replace("\u{a0}", ' ', $columnName);
+ $reference = $this->adjustRowReference($columnName, $reference, $cell, $columnId);
+ }
+
+ return $this->validateParsedReference(trim($reference, '[]@, '));
+ }
+
+ private function adjustRowReference(string $columnName, string $reference, Cell $cell, string $columnId): string
+ {
+ if ($columnName !== '') {
+ $cellReference = $columnId . $cell->getRow();
+ $pattern1 = '/\[' . preg_quote($columnName, '/') . '\]/miu';
+ $pattern2 = '/@' . preg_quote($columnName, '/') . '/miu';
+ if (preg_match($pattern1, $reference) === 1) {
+ $reference = preg_replace($pattern1, $cellReference, $reference);
+ } elseif (preg_match($pattern2, $reference) === 1) {
+ $reference = preg_replace($pattern2, $cellReference, $reference);
+ }
+ /** @var string $reference */
+ }
+
+ return $reference;
+ }
+
+ /**
+ * @throws Exception
+ * @throws \PhpOffice\PhpSpreadsheet\Exception
+ */
+ private function getColumnReference(): string
+ {
+ $reference = str_replace("\u{a0}", ' ', $this->reference);
+ $startRow = ($this->totalsRow === null) ? $this->lastDataRow : $this->totalsRow;
+ $endRow = ($this->headersRow === null) ? $this->firstDataRow : $this->headersRow;
+
+ [$startRow, $endRow] = $this->getRowsForColumnReference($reference, $startRow, $endRow);
+ $reference = $this->getColumnsForColumnReference($reference, $startRow, $endRow);
+
+ $reference = trim($reference, '[]@, ');
+ if (substr_count($reference, ':') > 1) {
+ $cells = explode(':', $reference);
+ $firstCell = array_shift($cells);
+ $lastCell = array_pop($cells);
+ $reference = "{$firstCell}:{$lastCell}";
+ }
+
+ return $this->validateParsedReference($reference);
+ }
+
+ /**
+ * @throws Exception
+ * @throws \PhpOffice\PhpSpreadsheet\Exception
+ */
+ private function validateParsedReference(string $reference): string
+ {
+ if (preg_match('/^' . Calculation::CALCULATION_REGEXP_CELLREF . ':' . Calculation::CALCULATION_REGEXP_CELLREF . '$/miu', $reference) !== 1) {
+ if (preg_match('/^' . Calculation::CALCULATION_REGEXP_CELLREF . '$/miu', $reference) !== 1) {
+ throw new Exception(
+ "Invalid Structured Reference {$this->reference} {$reference}",
+ Exception::CALCULATION_ENGINE_PUSH_TO_STACK
+ );
+ }
+ }
+
+ return $reference;
+ }
+
+ private function fullData(int $startRow, int $endRow): string
+ {
+ $columns = array_keys($this->columns);
+ $firstColumn = array_shift($columns);
+ $lastColumn = (empty($columns)) ? $firstColumn : array_pop($columns);
+
+ return "{$firstColumn}{$startRow}:{$lastColumn}{$endRow}";
+ }
+
+ private function getMinimumRow(string $reference): int
+ {
+ return match ($reference) {
+ self::ITEM_SPECIFIER_ALL, self::ITEM_SPECIFIER_HEADERS => $this->headersRow ?? $this->firstDataRow,
+ self::ITEM_SPECIFIER_DATA => $this->firstDataRow,
+ self::ITEM_SPECIFIER_TOTALS => $this->totalsRow ?? $this->lastDataRow,
+ default => $this->headersRow ?? $this->firstDataRow,
+ };
+ }
+
+ private function getMaximumRow(string $reference): int
+ {
+ return match ($reference) {
+ self::ITEM_SPECIFIER_HEADERS => $this->headersRow ?? $this->firstDataRow,
+ self::ITEM_SPECIFIER_DATA => $this->lastDataRow,
+ self::ITEM_SPECIFIER_ALL, self::ITEM_SPECIFIER_TOTALS => $this->totalsRow ?? $this->lastDataRow,
+ default => $this->totalsRow ?? $this->lastDataRow,
+ };
+ }
+
+ public function value(): string
+ {
+ return $this->value;
+ }
+
+ /**
+ * @return array
+ */
+ private function getRowsForColumnReference(string &$reference, int $startRow, int $endRow): array
+ {
+ $rowsSelected = false;
+ foreach (self::ITEM_SPECIFIER_ROWS_SET as $rowReference) {
+ $pattern = '/\[' . $rowReference . '\]/mui';
+ if (preg_match($pattern, $reference) === 1) {
+ if (($rowReference === self::ITEM_SPECIFIER_HEADERS) && ($this->table->getShowHeaderRow() === false)) {
+ throw new Exception(
+ 'Table Headers are Hidden, and should not be Referenced',
+ Exception::CALCULATION_ENGINE_PUSH_TO_STACK
+ );
+ }
+ $rowsSelected = true;
+ $startRow = min($startRow, $this->getMinimumRow($rowReference));
+ $endRow = max($endRow, $this->getMaximumRow($rowReference));
+ $reference = preg_replace($pattern, '', $reference) ?? '';
+ }
+ }
+ if ($rowsSelected === false) {
+ // If there isn't any Special Item Identifier specified, then the selection defaults to data rows only.
+ $startRow = $this->firstDataRow;
+ $endRow = $this->lastDataRow;
+ }
+
+ return [$startRow, $endRow];
+ }
+
+ private function getColumnsForColumnReference(string $reference, int $startRow, int $endRow): string
+ {
+ $columnsSelected = false;
+ foreach ($this->columns as $columnId => $columnName) {
+ $columnName = str_replace("\u{a0}", ' ', $columnName ?? '');
+ $cellFrom = "{$columnId}{$startRow}";
+ $cellTo = "{$columnId}{$endRow}";
+ $cellReference = ($cellFrom === $cellTo) ? $cellFrom : "{$cellFrom}:{$cellTo}";
+ $pattern = '/\[' . preg_quote($columnName, '/') . '\]/mui';
+ if (preg_match($pattern, $reference) === 1) {
+ $columnsSelected = true;
+ $reference = preg_replace($pattern, $cellReference, $reference);
+ }
+ /** @var string $reference */
+ }
+ if ($columnsSelected === false) {
+ return $this->fullData($startRow, $endRow);
+ }
+
+ return $reference;
+ }
+
+ public function __toString(): string
+ {
+ return $this->value;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselI.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselI.php
new file mode 100644
index 00000000..5d564a05
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselI.php
@@ -0,0 +1,141 @@
+getMessage();
+ }
+
+ if ($ord < 0) {
+ return ExcelError::NAN();
+ }
+
+ $fResult = self::calculate($x, $ord);
+
+ return (is_nan($fResult)) ? ExcelError::NAN() : $fResult;
+ }
+
+ private static function calculate(float $x, int $ord): float
+ {
+ return match ($ord) {
+ 0 => self::besselI0($x),
+ 1 => self::besselI1($x),
+ default => self::besselI2($x, $ord),
+ };
+ }
+
+ private static function besselI0(float $x): float
+ {
+ $ax = abs($x);
+
+ if ($ax < 3.75) {
+ $y = $x / 3.75;
+ $y = $y * $y;
+
+ return 1.0 + $y * (3.5156229 + $y * (3.0899424 + $y * (1.2067492
+ + $y * (0.2659732 + $y * (0.360768e-1 + $y * 0.45813e-2)))));
+ }
+
+ $y = 3.75 / $ax;
+
+ return (exp($ax) / sqrt($ax)) * (0.39894228 + $y * (0.1328592e-1 + $y * (0.225319e-2 + $y * (-0.157565e-2
+ + $y * (0.916281e-2 + $y * (-0.2057706e-1 + $y * (0.2635537e-1
+ + $y * (-0.1647633e-1 + $y * 0.392377e-2))))))));
+ }
+
+ private static function besselI1(float $x): float
+ {
+ $ax = abs($x);
+
+ if ($ax < 3.75) {
+ $y = $x / 3.75;
+ $y = $y * $y;
+ $ans = $ax * (0.5 + $y * (0.87890594 + $y * (0.51498869 + $y * (0.15084934 + $y * (0.2658733e-1
+ + $y * (0.301532e-2 + $y * 0.32411e-3))))));
+
+ return ($x < 0.0) ? -$ans : $ans;
+ }
+
+ $y = 3.75 / $ax;
+ $ans = 0.2282967e-1 + $y * (-0.2895312e-1 + $y * (0.1787654e-1 - $y * 0.420059e-2));
+ $ans = 0.39894228 + $y * (-0.3988024e-1 + $y * (-0.362018e-2 + $y * (0.163801e-2
+ + $y * (-0.1031555e-1 + $y * $ans))));
+ $ans *= exp($ax) / sqrt($ax);
+
+ return ($x < 0.0) ? -$ans : $ans;
+ }
+
+ private static function besselI2(float $x, int $ord): float
+ {
+ if ($x === 0.0) {
+ return 0.0;
+ }
+
+ $tox = 2.0 / abs($x);
+ $bip = 0;
+ $ans = 0.0;
+ $bi = 1.0;
+
+ for ($j = 2 * ($ord + (int) sqrt(40.0 * $ord)); $j > 0; --$j) {
+ $bim = $bip + $j * $tox * $bi;
+ $bip = $bi;
+ $bi = $bim;
+
+ if (abs($bi) > 1.0e+12) {
+ $ans *= 1.0e-12;
+ $bi *= 1.0e-12;
+ $bip *= 1.0e-12;
+ }
+
+ if ($j === $ord) {
+ $ans = $bip;
+ }
+ }
+
+ $ans *= self::besselI0($x) / $bi;
+
+ return ($x < 0.0 && (($ord % 2) === 1)) ? -$ans : $ans;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselJ.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselJ.php
new file mode 100644
index 00000000..4a9d9ffd
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselJ.php
@@ -0,0 +1,176 @@
+ 8. This code provides a more accurate calculation
+ *
+ * @param mixed $x A float value at which to evaluate the function.
+ * If x is nonnumeric, BESSELJ returns the #VALUE! error value.
+ * Or can be an array of values
+ * @param mixed $ord The integer order of the Bessel function.
+ * If ord is not an integer, it is truncated.
+ * If $ord is nonnumeric, BESSELJ returns the #VALUE! error value.
+ * If $ord < 0, BESSELJ returns the #NUM! error value.
+ * Or can be an array of values
+ *
+ * @return array|float|string Result, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function BESSELJ(mixed $x, mixed $ord): array|string|float
+ {
+ if (is_array($x) || is_array($ord)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $x, $ord);
+ }
+
+ try {
+ $x = EngineeringValidations::validateFloat($x);
+ $ord = EngineeringValidations::validateInt($ord);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($ord < 0) {
+ return ExcelError::NAN();
+ }
+
+ $fResult = self::calculate($x, $ord);
+
+ return (is_nan($fResult)) ? ExcelError::NAN() : $fResult;
+ }
+
+ private static function calculate(float $x, int $ord): float
+ {
+ return match ($ord) {
+ 0 => self::besselJ0($x),
+ 1 => self::besselJ1($x),
+ default => self::besselJ2($x, $ord),
+ };
+ }
+
+ private static function besselJ0(float $x): float
+ {
+ $ax = abs($x);
+
+ if ($ax < 8.0) {
+ $y = $x * $x;
+ $ans1 = 57568490574.0 + $y * (-13362590354.0 + $y * (651619640.7 + $y * (-11214424.18 + $y
+ * (77392.33017 + $y * (-184.9052456)))));
+ $ans2 = 57568490411.0 + $y * (1029532985.0 + $y * (9494680.718 + $y * (59272.64853 + $y
+ * (267.8532712 + $y * 1.0))));
+
+ return $ans1 / $ans2;
+ }
+
+ $z = 8.0 / $ax;
+ $y = $z * $z;
+ $xx = $ax - 0.785398164;
+ $ans1 = 1.0 + $y * (-0.1098628627e-2 + $y * (0.2734510407e-4 + $y * (-0.2073370639e-5 + $y * 0.2093887211e-6)));
+ $ans2 = -0.1562499995e-1 + $y * (0.1430488765e-3 + $y * (-0.6911147651e-5 + $y
+ * (0.7621095161e-6 - $y * 0.934935152e-7)));
+
+ return sqrt(0.636619772 / $ax) * (cos($xx) * $ans1 - $z * sin($xx) * $ans2);
+ }
+
+ private static function besselJ1(float $x): float
+ {
+ $ax = abs($x);
+
+ if ($ax < 8.0) {
+ $y = $x * $x;
+ $ans1 = $x * (72362614232.0 + $y * (-7895059235.0 + $y * (242396853.1 + $y
+ * (-2972611.439 + $y * (15704.48260 + $y * (-30.16036606))))));
+ $ans2 = 144725228442.0 + $y * (2300535178.0 + $y * (18583304.74 + $y * (99447.43394 + $y
+ * (376.9991397 + $y * 1.0))));
+
+ return $ans1 / $ans2;
+ }
+
+ $z = 8.0 / $ax;
+ $y = $z * $z;
+ $xx = $ax - 2.356194491;
+
+ $ans1 = 1.0 + $y * (0.183105e-2 + $y * (-0.3516396496e-4 + $y * (0.2457520174e-5 + $y * (-0.240337019e-6))));
+ $ans2 = 0.04687499995 + $y * (-0.2002690873e-3 + $y * (0.8449199096e-5 + $y
+ * (-0.88228987e-6 + $y * 0.105787412e-6)));
+ $ans = sqrt(0.636619772 / $ax) * (cos($xx) * $ans1 - $z * sin($xx) * $ans2);
+
+ return ($x < 0.0) ? -$ans : $ans;
+ }
+
+ private static function besselJ2(float $x, int $ord): float
+ {
+ $ax = abs($x);
+ if ($ax === 0.0) {
+ return 0.0;
+ }
+
+ if ($ax > $ord) {
+ return self::besselj2a($ax, $ord, $x);
+ }
+
+ return self::besselj2b($ax, $ord, $x);
+ }
+
+ private static function besselj2a(float $ax, int $ord, float $x): float
+ {
+ $tox = 2.0 / $ax;
+ $bjm = self::besselJ0($ax);
+ $bj = self::besselJ1($ax);
+ for ($j = 1; $j < $ord; ++$j) {
+ $bjp = $j * $tox * $bj - $bjm;
+ $bjm = $bj;
+ $bj = $bjp;
+ }
+ $ans = $bj;
+
+ return ($x < 0.0 && ($ord % 2) == 1) ? -$ans : $ans;
+ }
+
+ private static function besselj2b(float $ax, int $ord, float $x): float
+ {
+ $tox = 2.0 / $ax;
+ $jsum = false;
+ $bjp = $ans = $sum = 0.0;
+ $bj = 1.0;
+ for ($j = 2 * ($ord + (int) sqrt(40.0 * $ord)); $j > 0; --$j) {
+ $bjm = $j * $tox * $bj - $bjp;
+ $bjp = $bj;
+ $bj = $bjm;
+ if (abs($bj) > 1.0e+10) {
+ $bj *= 1.0e-10;
+ $bjp *= 1.0e-10;
+ $ans *= 1.0e-10;
+ $sum *= 1.0e-10;
+ }
+ if ($jsum === true) {
+ $sum += $bj;
+ }
+ $jsum = $jsum === false;
+ if ($j === $ord) {
+ $ans = $bjp;
+ }
+ }
+ $sum = 2.0 * $sum - $bj;
+ $ans /= $sum;
+
+ return ($x < 0.0 && ($ord % 2) === 1) ? -$ans : $ans;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselK.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselK.php
new file mode 100644
index 00000000..5a9bd54c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselK.php
@@ -0,0 +1,130 @@
+getMessage();
+ }
+
+ if (($ord < 0) || ($x <= 0.0)) {
+ return ExcelError::NAN();
+ }
+
+ $fBk = self::calculate($x, $ord);
+
+ return (is_nan($fBk)) ? ExcelError::NAN() : $fBk;
+ }
+
+ private static function calculate(float $x, int $ord): float
+ {
+ return match ($ord) {
+ 0 => self::besselK0($x),
+ 1 => self::besselK1($x),
+ default => self::besselK2($x, $ord),
+ };
+ }
+
+ /**
+ * Mollify Phpstan.
+ *
+ * @codeCoverageIgnore
+ */
+ private static function callBesselI(float $x, int $ord): float
+ {
+ $rslt = BesselI::BESSELI($x, $ord);
+ if (!is_float($rslt)) {
+ throw new Exception('Unexpected array or string');
+ }
+
+ return $rslt;
+ }
+
+ private static function besselK0(float $x): float
+ {
+ if ($x <= 2) {
+ $fNum2 = $x * 0.5;
+ $y = ($fNum2 * $fNum2);
+
+ return -log($fNum2) * self::callBesselI($x, 0)
+ + (-0.57721566 + $y * (0.42278420 + $y * (0.23069756 + $y * (0.3488590e-1 + $y * (0.262698e-2 + $y
+ * (0.10750e-3 + $y * 0.74e-5))))));
+ }
+
+ $y = 2 / $x;
+
+ return exp(-$x) / sqrt($x)
+ * (1.25331414 + $y * (-0.7832358e-1 + $y * (0.2189568e-1 + $y * (-0.1062446e-1 + $y
+ * (0.587872e-2 + $y * (-0.251540e-2 + $y * 0.53208e-3))))));
+ }
+
+ private static function besselK1(float $x): float
+ {
+ if ($x <= 2) {
+ $fNum2 = $x * 0.5;
+ $y = ($fNum2 * $fNum2);
+
+ return log($fNum2) * self::callBesselI($x, 1)
+ + (1 + $y * (0.15443144 + $y * (-0.67278579 + $y * (-0.18156897 + $y * (-0.1919402e-1 + $y
+ * (-0.110404e-2 + $y * (-0.4686e-4))))))) / $x;
+ }
+
+ $y = 2 / $x;
+
+ return exp(-$x) / sqrt($x)
+ * (1.25331414 + $y * (0.23498619 + $y * (-0.3655620e-1 + $y * (0.1504268e-1 + $y * (-0.780353e-2 + $y
+ * (0.325614e-2 + $y * (-0.68245e-3)))))));
+ }
+
+ private static function besselK2(float $x, int $ord): float
+ {
+ $fTox = 2 / $x;
+ $fBkm = self::besselK0($x);
+ $fBk = self::besselK1($x);
+ for ($n = 1; $n < $ord; ++$n) {
+ $fBkp = $fBkm + $n * $fTox * $fBk;
+ $fBkm = $fBk;
+ $fBk = $fBkp;
+ }
+
+ return $fBk;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselY.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselY.php
new file mode 100644
index 00000000..5d99638a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BesselY.php
@@ -0,0 +1,137 @@
+getMessage();
+ }
+
+ if (($ord < 0) || ($x <= 0.0)) {
+ return ExcelError::NAN();
+ }
+
+ $fBy = self::calculate($x, $ord);
+
+ return (is_nan($fBy)) ? ExcelError::NAN() : $fBy;
+ }
+
+ private static function calculate(float $x, int $ord): float
+ {
+ return match ($ord) {
+ 0 => self::besselY0($x),
+ 1 => self::besselY1($x),
+ default => self::besselY2($x, $ord),
+ };
+ }
+
+ /**
+ * Mollify Phpstan.
+ *
+ * @codeCoverageIgnore
+ */
+ private static function callBesselJ(float $x, int $ord): float
+ {
+ $rslt = BesselJ::BESSELJ($x, $ord);
+ if (!is_float($rslt)) {
+ throw new Exception('Unexpected array or string');
+ }
+
+ return $rslt;
+ }
+
+ private static function besselY0(float $x): float
+ {
+ if ($x < 8.0) {
+ $y = ($x * $x);
+ $ans1 = -2957821389.0 + $y * (7062834065.0 + $y * (-512359803.6 + $y * (10879881.29 + $y
+ * (-86327.92757 + $y * 228.4622733))));
+ $ans2 = 40076544269.0 + $y * (745249964.8 + $y * (7189466.438 + $y
+ * (47447.26470 + $y * (226.1030244 + $y))));
+
+ return $ans1 / $ans2 + 0.636619772 * self::callBesselJ($x, 0) * log($x);
+ }
+
+ $z = 8.0 / $x;
+ $y = ($z * $z);
+ $xx = $x - 0.785398164;
+ $ans1 = 1 + $y * (-0.1098628627e-2 + $y * (0.2734510407e-4 + $y * (-0.2073370639e-5 + $y * 0.2093887211e-6)));
+ $ans2 = -0.1562499995e-1 + $y * (0.1430488765e-3 + $y * (-0.6911147651e-5 + $y * (0.7621095161e-6 + $y
+ * (-0.934945152e-7))));
+
+ return sqrt(0.636619772 / $x) * (sin($xx) * $ans1 + $z * cos($xx) * $ans2);
+ }
+
+ private static function besselY1(float $x): float
+ {
+ if ($x < 8.0) {
+ $y = ($x * $x);
+ $ans1 = $x * (-0.4900604943e13 + $y * (0.1275274390e13 + $y * (-0.5153438139e11 + $y
+ * (0.7349264551e9 + $y * (-0.4237922726e7 + $y * 0.8511937935e4)))));
+ $ans2 = 0.2499580570e14 + $y * (0.4244419664e12 + $y * (0.3733650367e10 + $y * (0.2245904002e8 + $y
+ * (0.1020426050e6 + $y * (0.3549632885e3 + $y)))));
+
+ return ($ans1 / $ans2) + 0.636619772 * (self::callBesselJ($x, 1) * log($x) - 1 / $x);
+ }
+
+ $z = 8.0 / $x;
+ $y = $z * $z;
+ $xx = $x - 2.356194491;
+ $ans1 = 1.0 + $y * (0.183105e-2 + $y * (-0.3516396496e-4 + $y * (0.2457520174e-5 + $y * (-0.240337019e-6))));
+ $ans2 = 0.04687499995 + $y * (-0.2002690873e-3 + $y * (0.8449199096e-5 + $y
+ * (-0.88228987e-6 + $y * 0.105787412e-6)));
+
+ return sqrt(0.636619772 / $x) * (sin($xx) * $ans1 + $z * cos($xx) * $ans2);
+ }
+
+ private static function besselY2(float $x, int $ord): float
+ {
+ $fTox = 2.0 / $x;
+ $fBym = self::besselY0($x);
+ $fBy = self::besselY1($x);
+ for ($n = 1; $n < $ord; ++$n) {
+ $fByp = $n * $fTox * $fBy - $fBym;
+ $fBym = $fBy;
+ $fBy = $fByp;
+ }
+
+ return $fBy;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BitWise.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BitWise.php
new file mode 100644
index 00000000..c861c21a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/BitWise.php
@@ -0,0 +1,247 @@
+getMessage();
+ }
+ $split1 = self::splitNumber($number1);
+ $split2 = self::splitNumber($number2);
+
+ return self::SPLIT_DIVISOR * ($split1[0] & $split2[0]) + ($split1[1] & $split2[1]);
+ }
+
+ /**
+ * BITOR.
+ *
+ * Returns the bitwise OR of two integer values.
+ *
+ * Excel Function:
+ * BITOR(number1, number2)
+ *
+ * @param null|array|bool|float|int|string $number1 Or can be an array of values
+ * @param null|array|bool|float|int|string $number2 Or can be an array of values
+ *
+ * @return array|int|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function BITOR(null|array|bool|float|int|string $number1, null|array|bool|float|int|string $number2): array|string|int|float
+ {
+ if (is_array($number1) || is_array($number2)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $number1, $number2);
+ }
+
+ try {
+ $number1 = self::validateBitwiseArgument($number1);
+ $number2 = self::validateBitwiseArgument($number2);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $split1 = self::splitNumber($number1);
+ $split2 = self::splitNumber($number2);
+
+ return self::SPLIT_DIVISOR * ($split1[0] | $split2[0]) + ($split1[1] | $split2[1]);
+ }
+
+ /**
+ * BITXOR.
+ *
+ * Returns the bitwise XOR of two integer values.
+ *
+ * Excel Function:
+ * BITXOR(number1, number2)
+ *
+ * @param null|array|bool|float|int|string $number1 Or can be an array of values
+ * @param null|array|bool|float|int|string $number2 Or can be an array of values
+ *
+ * @return array|int|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function BITXOR(null|array|bool|float|int|string $number1, null|array|bool|float|int|string $number2): array|string|int|float
+ {
+ if (is_array($number1) || is_array($number2)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $number1, $number2);
+ }
+
+ try {
+ $number1 = self::validateBitwiseArgument($number1);
+ $number2 = self::validateBitwiseArgument($number2);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $split1 = self::splitNumber($number1);
+ $split2 = self::splitNumber($number2);
+
+ return self::SPLIT_DIVISOR * ($split1[0] ^ $split2[0]) + ($split1[1] ^ $split2[1]);
+ }
+
+ /**
+ * BITLSHIFT.
+ *
+ * Returns the number value shifted left by shift_amount bits.
+ *
+ * Excel Function:
+ * BITLSHIFT(number, shift_amount)
+ *
+ * @param null|array|bool|float|int|string $number Or can be an array of values
+ * @param null|array|bool|float|int|string $shiftAmount Or can be an array of values
+ *
+ * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function BITLSHIFT(null|array|bool|float|int|string $number, null|array|bool|float|int|string $shiftAmount): array|string|float
+ {
+ if (is_array($number) || is_array($shiftAmount)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $shiftAmount);
+ }
+
+ try {
+ $number = self::validateBitwiseArgument($number);
+ $shiftAmount = self::validateShiftAmount($shiftAmount);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $result = floor($number * (2 ** $shiftAmount));
+ if ($result > 2 ** 48 - 1) {
+ return ExcelError::NAN();
+ }
+
+ return $result;
+ }
+
+ /**
+ * BITRSHIFT.
+ *
+ * Returns the number value shifted right by shift_amount bits.
+ *
+ * Excel Function:
+ * BITRSHIFT(number, shift_amount)
+ *
+ * @param null|array|bool|float|int|string $number Or can be an array of values
+ * @param null|array|bool|float|int|string $shiftAmount Or can be an array of values
+ *
+ * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function BITRSHIFT(null|array|bool|float|int|string $number, null|array|bool|float|int|string $shiftAmount): array|string|float
+ {
+ if (is_array($number) || is_array($shiftAmount)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $shiftAmount);
+ }
+
+ try {
+ $number = self::validateBitwiseArgument($number);
+ $shiftAmount = self::validateShiftAmount($shiftAmount);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $result = floor($number / (2 ** $shiftAmount));
+ if ($result > 2 ** 48 - 1) { // possible because shiftAmount can be negative
+ return ExcelError::NAN();
+ }
+
+ return $result;
+ }
+
+ /**
+ * Validate arguments passed to the bitwise functions.
+ */
+ private static function validateBitwiseArgument(mixed $value): float
+ {
+ $value = self::nullFalseTrueToNumber($value);
+
+ if (is_numeric($value)) {
+ $value = (float) $value;
+ if ($value == floor($value)) {
+ if (($value > 2 ** 48 - 1) || ($value < 0)) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return floor($value);
+ }
+
+ throw new Exception(ExcelError::NAN());
+ }
+
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ /**
+ * Validate arguments passed to the bitwise functions.
+ */
+ private static function validateShiftAmount(mixed $value): int
+ {
+ $value = self::nullFalseTrueToNumber($value);
+
+ if (is_numeric($value)) {
+ if (abs($value) > 53) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return (int) $value;
+ }
+
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ /**
+ * Many functions accept null/false/true argument treated as 0/0/1.
+ */
+ private static function nullFalseTrueToNumber(mixed &$number): mixed
+ {
+ if ($number === null) {
+ $number = 0;
+ } elseif (is_bool($number)) {
+ $number = (int) $number;
+ }
+
+ return $number;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Compare.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Compare.php
new file mode 100644
index 00000000..9e3275fc
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Compare.php
@@ -0,0 +1,82 @@
+getMessage();
+ }
+
+ return (int) (abs($a - $b) < 1.0e-15);
+ }
+
+ /**
+ * GESTEP.
+ *
+ * Excel Function:
+ * GESTEP(number[,step])
+ *
+ * Returns 1 if number >= step; returns 0 (zero) otherwise
+ * Use this function to filter a set of values. For example, by summing several GESTEP
+ * functions you calculate the count of values that exceed a threshold.
+ *
+ * @param array|bool|float|int|string $number the value to test against step
+ * Or can be an array of values
+ * @param null|array|bool|float|int|string $step The threshold value. If you omit a value for step, GESTEP uses zero.
+ * Or can be an array of values
+ *
+ * @return array|int|string (string in the event of an error)
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function GESTEP(array|float|bool|string|int $number, $step = 0.0): array|string|int
+ {
+ if (is_array($number) || is_array($step)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $step);
+ }
+
+ try {
+ $number = EngineeringValidations::validateFloat($number);
+ $step = EngineeringValidations::validateFloat($step ?? 0.0);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return (int) ($number >= $step);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Complex.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Complex.php
new file mode 100644
index 00000000..3e41371b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Complex.php
@@ -0,0 +1,120 @@
+getMessage();
+ }
+
+ if (($suffix === 'i') || ($suffix === 'j') || ($suffix === '')) {
+ $complex = new ComplexObject($realNumber, $imaginary, $suffix);
+
+ return (string) $complex;
+ }
+
+ return ExcelError::VALUE();
+ }
+
+ /**
+ * IMAGINARY.
+ *
+ * Returns the imaginary coefficient of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMAGINARY(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the imaginary
+ * coefficient
+ * Or can be an array of values
+ *
+ * @return array|float|string (string if an error)
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMAGINARY($complexNumber): array|string|float
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return $complex->getImaginary();
+ }
+
+ /**
+ * IMREAL.
+ *
+ * Returns the real coefficient of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMREAL(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the real coefficient
+ * Or can be an array of values
+ *
+ * @return array|float|string (string if an error)
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMREAL($complexNumber): array|string|float
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return $complex->getReal();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ComplexFunctions.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ComplexFunctions.php
new file mode 100644
index 00000000..d1b7764a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ComplexFunctions.php
@@ -0,0 +1,592 @@
+abs();
+ }
+
+ /**
+ * IMARGUMENT.
+ *
+ * Returns the argument theta of a complex number, i.e. the angle in radians from the real
+ * axis to the representation of the number in polar coordinates.
+ *
+ * Excel Function:
+ * IMARGUMENT(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the argument theta
+ * Or can be an array of values
+ *
+ * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMARGUMENT(array|string $complexNumber): array|float|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ return ExcelError::DIV0();
+ }
+
+ return $complex->argument();
+ }
+
+ /**
+ * IMCONJUGATE.
+ *
+ * Returns the complex conjugate of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMCONJUGATE(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the conjugate
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMCONJUGATE(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->conjugate();
+ }
+
+ /**
+ * IMCOS.
+ *
+ * Returns the cosine of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMCOS(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the cosine
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMCOS(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->cos();
+ }
+
+ /**
+ * IMCOSH.
+ *
+ * Returns the hyperbolic cosine of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMCOSH(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the hyperbolic cosine
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMCOSH(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->cosh();
+ }
+
+ /**
+ * IMCOT.
+ *
+ * Returns the cotangent of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMCOT(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the cotangent
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMCOT(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->cot();
+ }
+
+ /**
+ * IMCSC.
+ *
+ * Returns the cosecant of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMCSC(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the cosecant
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMCSC(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->csc();
+ }
+
+ /**
+ * IMCSCH.
+ *
+ * Returns the hyperbolic cosecant of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMCSCH(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the hyperbolic cosecant
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMCSCH(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->csch();
+ }
+
+ /**
+ * IMSIN.
+ *
+ * Returns the sine of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMSIN(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the sine
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMSIN(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->sin();
+ }
+
+ /**
+ * IMSINH.
+ *
+ * Returns the hyperbolic sine of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMSINH(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the hyperbolic sine
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMSINH(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->sinh();
+ }
+
+ /**
+ * IMSEC.
+ *
+ * Returns the secant of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMSEC(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the secant
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMSEC(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->sec();
+ }
+
+ /**
+ * IMSECH.
+ *
+ * Returns the hyperbolic secant of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMSECH(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the hyperbolic secant
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMSECH(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->sech();
+ }
+
+ /**
+ * IMTAN.
+ *
+ * Returns the tangent of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMTAN(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the tangent
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMTAN(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->tan();
+ }
+
+ /**
+ * IMSQRT.
+ *
+ * Returns the square root of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMSQRT(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the square root
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMSQRT(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ $theta = self::IMARGUMENT($complexNumber);
+ if ($theta === ExcelError::DIV0()) {
+ return '0';
+ }
+
+ return (string) $complex->sqrt();
+ }
+
+ /**
+ * IMLN.
+ *
+ * Returns the natural logarithm of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMLN(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the natural logarithm
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMLN(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->ln();
+ }
+
+ /**
+ * IMLOG10.
+ *
+ * Returns the common logarithm (base 10) of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMLOG10(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the common logarithm
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMLOG10(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->log10();
+ }
+
+ /**
+ * IMLOG2.
+ *
+ * Returns the base-2 logarithm of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMLOG2(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the base-2 logarithm
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMLOG2(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->log2();
+ }
+
+ /**
+ * IMEXP.
+ *
+ * Returns the exponential of a complex number in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMEXP(complexNumber)
+ *
+ * @param array|string $complexNumber the complex number for which you want the exponential
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMEXP(array|string $complexNumber): array|string
+ {
+ if (is_array($complexNumber)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $complexNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $complex->exp();
+ }
+
+ /**
+ * IMPOWER.
+ *
+ * Returns a complex number in x + yi or x + yj text format raised to a power.
+ *
+ * Excel Function:
+ * IMPOWER(complexNumber,realNumber)
+ *
+ * @param array|string $complexNumber the complex number you want to raise to a power
+ * Or can be an array of values
+ * @param array|float|int|string $realNumber the power to which you want to raise the complex number
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMPOWER(array|string $complexNumber, array|float|int|string $realNumber): array|string
+ {
+ if (is_array($complexNumber) || is_array($realNumber)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $complexNumber, $realNumber);
+ }
+
+ try {
+ $complex = new ComplexObject($complexNumber);
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ if (!is_numeric($realNumber)) {
+ return ExcelError::VALUE();
+ }
+
+ return (string) $complex->pow((float) $realNumber);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ComplexOperations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ComplexOperations.php
new file mode 100644
index 00000000..61efa847
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ComplexOperations.php
@@ -0,0 +1,128 @@
+divideby(new ComplexObject($complexDivisor));
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+ }
+
+ /**
+ * IMSUB.
+ *
+ * Returns the difference of two complex numbers in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMSUB(complexNumber1,complexNumber2)
+ *
+ * @param array|string $complexNumber1 the complex number from which to subtract complexNumber2
+ * Or can be an array of values
+ * @param array|string $complexNumber2 the complex number to subtract from complexNumber1
+ * Or can be an array of values
+ *
+ * @return array|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function IMSUB(array|string $complexNumber1, array|string $complexNumber2): array|string
+ {
+ if (is_array($complexNumber1) || is_array($complexNumber2)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $complexNumber1, $complexNumber2);
+ }
+
+ try {
+ return (string) (new ComplexObject($complexNumber1))->subtract(new ComplexObject($complexNumber2));
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+ }
+
+ /**
+ * IMSUM.
+ *
+ * Returns the sum of two or more complex numbers in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMSUM(complexNumber[,complexNumber[,...]])
+ *
+ * @param string ...$complexNumbers Series of complex numbers to add
+ */
+ public static function IMSUM(...$complexNumbers): string
+ {
+ // Return value
+ $returnValue = new ComplexObject(0.0);
+ $aArgs = Functions::flattenArray($complexNumbers);
+
+ try {
+ // Loop through the arguments
+ foreach ($aArgs as $complex) {
+ $returnValue = $returnValue->add(new ComplexObject($complex));
+ }
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $returnValue;
+ }
+
+ /**
+ * IMPRODUCT.
+ *
+ * Returns the product of two or more complex numbers in x + yi or x + yj text format.
+ *
+ * Excel Function:
+ * IMPRODUCT(complexNumber[,complexNumber[,...]])
+ *
+ * @param string ...$complexNumbers Series of complex numbers to multiply
+ */
+ public static function IMPRODUCT(...$complexNumbers): string
+ {
+ // Return value
+ $returnValue = new ComplexObject(1.0);
+ $aArgs = Functions::flattenArray($complexNumbers);
+
+ try {
+ // Loop through the arguments
+ foreach ($aArgs as $complex) {
+ $returnValue = $returnValue->multiply(new ComplexObject($complex));
+ }
+ } catch (ComplexException) {
+ return ExcelError::NAN();
+ }
+
+ return (string) $returnValue;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Constants.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Constants.php
new file mode 100644
index 00000000..a926db6e
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/Constants.php
@@ -0,0 +1,11 @@
+ 10) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return (int) $places;
+ }
+
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ /**
+ * Formats a number base string value with leading zeroes.
+ *
+ * @param string $value The "number" to pad
+ * @param ?int $places The length that we want to pad this value
+ *
+ * @return string The padded "number"
+ */
+ protected static function nbrConversionFormat(string $value, ?int $places): string
+ {
+ if ($places !== null) {
+ if (strlen($value) <= $places) {
+ return substr(str_pad($value, $places, '0', STR_PAD_LEFT), -10);
+ }
+
+ return ExcelError::NAN();
+ }
+
+ return substr($value, -10);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertBinary.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertBinary.php
new file mode 100644
index 00000000..9c00dcb5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertBinary.php
@@ -0,0 +1,163 @@
+getMessage();
+ }
+
+ if (strlen($value) == 10 && $value[0] === '1') {
+ // Two's Complement
+ $value = substr($value, -9);
+
+ return '-' . (512 - bindec($value));
+ }
+
+ return (string) bindec($value);
+ }
+
+ /**
+ * toHex.
+ *
+ * Return a binary value as hex.
+ *
+ * Excel Function:
+ * BIN2HEX(x[,places])
+ *
+ * @param array|bool|float|int|string $value The binary number (as a string) that you want to convert. The number
+ * cannot contain more than 10 characters (10 bits). The most significant
+ * bit of number is the sign bit. The remaining 9 bits are magnitude bits.
+ * Negative numbers are represented using two's-complement notation.
+ * If number is not a valid binary number, or if number contains more than
+ * 10 characters (10 bits), BIN2HEX returns the #NUM! error value.
+ * Or can be an array of values
+ * @param null|array|float|int|string $places The number of characters to use. If places is omitted, BIN2HEX uses the
+ * minimum number of characters necessary. Places is useful for padding the
+ * return value with leading 0s (zeros).
+ * If places is not an integer, it is truncated.
+ * If places is nonnumeric, BIN2HEX returns the #VALUE! error value.
+ * If places is negative, BIN2HEX returns the #NUM! error value.
+ * Or can be an array of values
+ *
+ * @return array|string Result, or an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function toHex($value, $places = null): array|string
+ {
+ if (is_array($value) || is_array($places)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);
+ }
+
+ try {
+ $value = self::validateValue($value);
+ $value = self::validateBinary($value);
+ $places = self::validatePlaces($places);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if (strlen($value) == 10 && $value[0] === '1') {
+ $high2 = substr($value, 0, 2);
+ $low8 = substr($value, 2);
+ $xarr = ['00' => '00000000', '01' => '00000001', '10' => 'FFFFFFFE', '11' => 'FFFFFFFF'];
+
+ return $xarr[$high2] . strtoupper(substr('0' . dechex((int) bindec($low8)), -2));
+ }
+ $hexVal = (string) strtoupper(dechex((int) bindec($value)));
+
+ return self::nbrConversionFormat($hexVal, $places);
+ }
+
+ /**
+ * toOctal.
+ *
+ * Return a binary value as octal.
+ *
+ * Excel Function:
+ * BIN2OCT(x[,places])
+ *
+ * @param array|bool|float|int|string $value The binary number (as a string) that you want to convert. The number
+ * cannot contain more than 10 characters (10 bits). The most significant
+ * bit of number is the sign bit. The remaining 9 bits are magnitude bits.
+ * Negative numbers are represented using two's-complement notation.
+ * If number is not a valid binary number, or if number contains more than
+ * 10 characters (10 bits), BIN2OCT returns the #NUM! error value.
+ * Or can be an array of values
+ * @param null|array|float|int|string $places The number of characters to use. If places is omitted, BIN2OCT uses the
+ * minimum number of characters necessary. Places is useful for padding the
+ * return value with leading 0s (zeros).
+ * If places is not an integer, it is truncated.
+ * If places is nonnumeric, BIN2OCT returns the #VALUE! error value.
+ * If places is negative, BIN2OCT returns the #NUM! error value.
+ * Or can be an array of values
+ *
+ * @return array|string Result, or an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function toOctal($value, $places = null): array|string
+ {
+ if (is_array($value) || is_array($places)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);
+ }
+
+ try {
+ $value = self::validateValue($value);
+ $value = self::validateBinary($value);
+ $places = self::validatePlaces($places);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if (strlen($value) == 10 && $value[0] === '1') { // Two's Complement
+ return str_repeat('7', 6) . strtoupper(decoct((int) bindec("11$value")));
+ }
+ $octVal = (string) decoct((int) bindec($value));
+
+ return self::nbrConversionFormat($octVal, $places);
+ }
+
+ protected static function validateBinary(string $value): string
+ {
+ if ((strlen($value) > preg_match_all('/[01]/', $value)) || (strlen($value) > 10)) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $value;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertDecimal.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertDecimal.php
new file mode 100644
index 00000000..923caa96
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertDecimal.php
@@ -0,0 +1,213 @@
+ 511, DEC2BIN returns the #NUM! error
+ * value.
+ * If number is nonnumeric, DEC2BIN returns the #VALUE! error value.
+ * If DEC2BIN requires more than places characters, it returns the #NUM!
+ * error value.
+ * Or can be an array of values
+ * @param null|array|float|int|string $places The number of characters to use. If places is omitted, DEC2BIN uses
+ * the minimum number of characters necessary. Places is useful for
+ * padding the return value with leading 0s (zeros).
+ * If places is not an integer, it is truncated.
+ * If places is nonnumeric, DEC2BIN returns the #VALUE! error value.
+ * If places is zero or negative, DEC2BIN returns the #NUM! error value.
+ * Or can be an array of values
+ *
+ * @return array|string Result, or an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function toBinary($value, $places = null): array|string
+ {
+ if (is_array($value) || is_array($places)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);
+ }
+
+ try {
+ $value = self::validateValue($value);
+ $value = self::validateDecimal($value);
+ $places = self::validatePlaces($places);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $value = (int) floor((float) $value);
+ if ($value > self::LARGEST_BINARY_IN_DECIMAL || $value < self::SMALLEST_BINARY_IN_DECIMAL) {
+ return ExcelError::NAN();
+ }
+
+ $r = decbin($value);
+ // Two's Complement
+ $r = substr($r, -10);
+
+ return self::nbrConversionFormat($r, $places);
+ }
+
+ /**
+ * toHex.
+ *
+ * Return a decimal value as hex.
+ *
+ * Excel Function:
+ * DEC2HEX(x[,places])
+ *
+ * @param array|bool|float|int|string $value The decimal integer you want to convert. If number is negative,
+ * places is ignored and DEC2HEX returns a 10-character (40-bit)
+ * hexadecimal number in which the most significant bit is the sign
+ * bit. The remaining 39 bits are magnitude bits. Negative numbers
+ * are represented using two's-complement notation.
+ * If number < -549,755,813,888 or if number > 549,755,813,887,
+ * DEC2HEX returns the #NUM! error value.
+ * If number is nonnumeric, DEC2HEX returns the #VALUE! error value.
+ * If DEC2HEX requires more than places characters, it returns the
+ * #NUM! error value.
+ * Or can be an array of values
+ * @param null|array|float|int|string $places The number of characters to use. If places is omitted, DEC2HEX uses
+ * the minimum number of characters necessary. Places is useful for
+ * padding the return value with leading 0s (zeros).
+ * If places is not an integer, it is truncated.
+ * If places is nonnumeric, DEC2HEX returns the #VALUE! error value.
+ * If places is zero or negative, DEC2HEX returns the #NUM! error value.
+ * Or can be an array of values
+ *
+ * @return array|string Result, or an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function toHex($value, $places = null): array|string
+ {
+ if (is_array($value) || is_array($places)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);
+ }
+
+ try {
+ $value = self::validateValue($value);
+ $value = self::validateDecimal($value);
+ $places = self::validatePlaces($places);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $value = floor((float) $value);
+ if ($value > self::LARGEST_HEX_IN_DECIMAL || $value < self::SMALLEST_HEX_IN_DECIMAL) {
+ return ExcelError::NAN();
+ }
+ $r = strtoupper(dechex((int) $value));
+ $r = self::hex32bit($value, $r);
+
+ return self::nbrConversionFormat($r, $places);
+ }
+
+ public static function hex32bit(float $value, string $hexstr, bool $force = false): string
+ {
+ if (PHP_INT_SIZE === 4 || $force) {
+ if ($value >= 2 ** 32) {
+ $quotient = (int) ($value / (2 ** 32));
+
+ return strtoupper(substr('0' . dechex($quotient), -2) . $hexstr);
+ }
+ if ($value < -(2 ** 32)) {
+ $quotient = 256 - (int) ceil((-$value) / (2 ** 32));
+
+ return strtoupper(substr('0' . dechex($quotient), -2) . substr("00000000$hexstr", -8));
+ }
+ if ($value < 0) {
+ return "FF$hexstr";
+ }
+ }
+
+ return $hexstr;
+ }
+
+ /**
+ * toOctal.
+ *
+ * Return an decimal value as octal.
+ *
+ * Excel Function:
+ * DEC2OCT(x[,places])
+ *
+ * @param array|bool|float|int|string $value The decimal integer you want to convert. If number is negative,
+ * places is ignored and DEC2OCT returns a 10-character (30-bit)
+ * octal number in which the most significant bit is the sign bit.
+ * The remaining 29 bits are magnitude bits. Negative numbers are
+ * represented using two's-complement notation.
+ * If number < -536,870,912 or if number > 536,870,911, DEC2OCT
+ * returns the #NUM! error value.
+ * If number is nonnumeric, DEC2OCT returns the #VALUE! error value.
+ * If DEC2OCT requires more than places characters, it returns the
+ * #NUM! error value.
+ * Or can be an array of values
+ * @param array|int $places The number of characters to use. If places is omitted, DEC2OCT uses
+ * the minimum number of characters necessary. Places is useful for
+ * padding the return value with leading 0s (zeros).
+ * If places is not an integer, it is truncated.
+ * If places is nonnumeric, DEC2OCT returns the #VALUE! error value.
+ * If places is zero or negative, DEC2OCT returns the #NUM! error value.
+ * Or can be an array of values
+ *
+ * @return array|string Result, or an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function toOctal($value, $places = null): array|string
+ {
+ if (is_array($value) || is_array($places)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);
+ }
+
+ try {
+ $value = self::validateValue($value);
+ $value = self::validateDecimal($value);
+ $places = self::validatePlaces($places);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $value = (int) floor((float) $value);
+ if ($value > self::LARGEST_OCTAL_IN_DECIMAL || $value < self::SMALLEST_OCTAL_IN_DECIMAL) {
+ return ExcelError::NAN();
+ }
+ $r = decoct($value);
+ $r = substr($r, -10);
+
+ return self::nbrConversionFormat($r, $places);
+ }
+
+ protected static function validateDecimal(string $value): string
+ {
+ if (strlen($value) > preg_match_all('/[-0123456789.]/', $value)) {
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ return $value;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertHex.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertHex.php
new file mode 100644
index 00000000..0003a9fd
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertHex.php
@@ -0,0 +1,175 @@
+getMessage();
+ }
+
+ $dec = self::toDecimal($value);
+
+ return ConvertDecimal::toBinary($dec, $places);
+ }
+
+ /**
+ * toDecimal.
+ *
+ * Return a hex value as decimal.
+ *
+ * Excel Function:
+ * HEX2DEC(x)
+ *
+ * @param array|bool|float|int|string $value The hexadecimal number you want to convert. This number cannot
+ * contain more than 10 characters (40 bits). The most significant
+ * bit of number is the sign bit. The remaining 39 bits are magnitude
+ * bits. Negative numbers are represented using two's-complement
+ * notation.
+ * If number is not a valid hexadecimal number, HEX2DEC returns the
+ * #NUM! error value.
+ * Or can be an array of values
+ *
+ * @return array|string Result, or an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function toDecimal($value)
+ {
+ if (is_array($value)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);
+ }
+
+ try {
+ $value = self::validateValue($value);
+ $value = self::validateHex($value);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if (strlen($value) > 10) {
+ return ExcelError::NAN();
+ }
+
+ $binX = '';
+ foreach (str_split($value) as $char) {
+ $binX .= str_pad(base_convert($char, 16, 2), 4, '0', STR_PAD_LEFT);
+ }
+ if (strlen($binX) == 40 && $binX[0] == '1') {
+ for ($i = 0; $i < 40; ++$i) {
+ $binX[$i] = ($binX[$i] == '1' ? '0' : '1');
+ }
+
+ return (string) ((bindec($binX) + 1) * -1);
+ }
+
+ return (string) bindec($binX);
+ }
+
+ /**
+ * toOctal.
+ *
+ * Return a hex value as octal.
+ *
+ * Excel Function:
+ * HEX2OCT(x[,places])
+ *
+ * @param array|bool|float|int|string $value The hexadecimal number you want to convert. Number cannot
+ * contain more than 10 characters. The most significant bit of
+ * number is the sign bit. The remaining 39 bits are magnitude
+ * bits. Negative numbers are represented using two's-complement
+ * notation.
+ * If number is negative, HEX2OCT ignores places and returns a
+ * 10-character octal number.
+ * If number is negative, it cannot be less than FFE0000000, and
+ * if number is positive, it cannot be greater than 1FFFFFFF.
+ * If number is not a valid hexadecimal number, HEX2OCT returns
+ * the #NUM! error value.
+ * If HEX2OCT requires more than places characters, it returns
+ * the #NUM! error value.
+ * Or can be an array of values
+ * @param array|int $places The number of characters to use. If places is omitted, HEX2OCT
+ * uses the minimum number of characters necessary. Places is
+ * useful for padding the return value with leading 0s (zeros).
+ * If places is not an integer, it is truncated.
+ * If places is nonnumeric, HEX2OCT returns the #VALUE! error
+ * value.
+ * If places is negative, HEX2OCT returns the #NUM! error value.
+ * Or can be an array of values
+ *
+ * @return array|string Result, or an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function toOctal($value, $places = null): array|string
+ {
+ if (is_array($value) || is_array($places)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);
+ }
+
+ try {
+ $value = self::validateValue($value);
+ $value = self::validateHex($value);
+ $places = self::validatePlaces($places);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $decimal = self::toDecimal($value);
+
+ return ConvertDecimal::toOctal($decimal, $places);
+ }
+
+ protected static function validateHex(string $value): string
+ {
+ if (strlen($value) > preg_match_all('/[0123456789ABCDEF]/', $value)) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $value;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertOctal.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertOctal.php
new file mode 100644
index 00000000..5e3c1248
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertOctal.php
@@ -0,0 +1,174 @@
+getMessage();
+ }
+
+ return ConvertDecimal::toBinary(self::toDecimal($value), $places);
+ }
+
+ /**
+ * toDecimal.
+ *
+ * Return an octal value as decimal.
+ *
+ * Excel Function:
+ * OCT2DEC(x)
+ *
+ * @param array|bool|float|int|string $value The octal number you want to convert. Number may not contain
+ * more than 10 octal characters (30 bits). The most significant
+ * bit of number is the sign bit. The remaining 29 bits are
+ * magnitude bits. Negative numbers are represented using
+ * two's-complement notation.
+ * If number is not a valid octal number, OCT2DEC returns the
+ * #NUM! error value.
+ * Or can be an array of values
+ *
+ * @return array|string Result, or an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function toDecimal($value)
+ {
+ if (is_array($value)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);
+ }
+
+ try {
+ $value = self::validateValue($value);
+ $value = self::validateOctal($value);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $binX = '';
+ foreach (str_split($value) as $char) {
+ $binX .= str_pad(decbin((int) $char), 3, '0', STR_PAD_LEFT);
+ }
+ if (strlen($binX) == 30 && $binX[0] == '1') {
+ for ($i = 0; $i < 30; ++$i) {
+ $binX[$i] = ($binX[$i] == '1' ? '0' : '1');
+ }
+
+ return (string) ((bindec($binX) + 1) * -1);
+ }
+
+ return (string) bindec($binX);
+ }
+
+ /**
+ * toHex.
+ *
+ * Return an octal value as hex.
+ *
+ * Excel Function:
+ * OCT2HEX(x[,places])
+ *
+ * @param array|bool|float|int|string $value The octal number you want to convert. Number may not contain
+ * more than 10 octal characters (30 bits). The most significant
+ * bit of number is the sign bit. The remaining 29 bits are
+ * magnitude bits. Negative numbers are represented using
+ * two's-complement notation.
+ * If number is negative, OCT2HEX ignores places and returns a
+ * 10-character hexadecimal number.
+ * If number is not a valid octal number, OCT2HEX returns the
+ * #NUM! error value.
+ * If OCT2HEX requires more than places characters, it returns
+ * the #NUM! error value.
+ * Or can be an array of values
+ * @param array|int $places The number of characters to use. If places is omitted, OCT2HEX
+ * uses the minimum number of characters necessary. Places is useful
+ * for padding the return value with leading 0s (zeros).
+ * If places is not an integer, it is truncated.
+ * If places is nonnumeric, OCT2HEX returns the #VALUE! error value.
+ * If places is negative, OCT2HEX returns the #NUM! error value.
+ * Or can be an array of values
+ *
+ * @return array|string Result, or an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function toHex($value, $places = null): array|string
+ {
+ if (is_array($value) || is_array($places)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);
+ }
+
+ try {
+ $value = self::validateValue($value);
+ $value = self::validateOctal($value);
+ $places = self::validatePlaces($places);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $hexVal = strtoupper(dechex((int) self::toDecimal($value)));
+ $hexVal = (PHP_INT_SIZE === 4 && strlen($value) === 10 && $value[0] >= '4') ? "FF{$hexVal}" : $hexVal;
+
+ return self::nbrConversionFormat($hexVal, $places);
+ }
+
+ protected static function validateOctal(string $value): string
+ {
+ $numDigits = (int) preg_match_all('/[01234567]/', $value);
+ if (strlen($value) > $numDigits || $numDigits > 10) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $value;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertUOM.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertUOM.php
new file mode 100644
index 00000000..969c270a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ConvertUOM.php
@@ -0,0 +1,679 @@
+
+ */
+ private static array $conversionUnits = [
+ // Weight and Mass
+ 'g' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Gram', 'AllowPrefix' => true],
+ 'sg' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Slug', 'AllowPrefix' => false],
+ 'lbm' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Pound mass (avoirdupois)', 'AllowPrefix' => false],
+ 'u' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'U (atomic mass unit)', 'AllowPrefix' => true],
+ 'ozm' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Ounce mass (avoirdupois)', 'AllowPrefix' => false],
+ 'grain' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Grain', 'AllowPrefix' => false],
+ 'cwt' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'U.S. (short) hundredweight', 'AllowPrefix' => false],
+ 'shweight' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'U.S. (short) hundredweight', 'AllowPrefix' => false],
+ 'uk_cwt' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Imperial hundredweight', 'AllowPrefix' => false],
+ 'lcwt' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Imperial hundredweight', 'AllowPrefix' => false],
+ 'hweight' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Imperial hundredweight', 'AllowPrefix' => false],
+ 'stone' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Stone', 'AllowPrefix' => false],
+ 'ton' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Ton', 'AllowPrefix' => false],
+ 'uk_ton' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Imperial ton', 'AllowPrefix' => false],
+ 'LTON' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Imperial ton', 'AllowPrefix' => false],
+ 'brton' => ['Group' => self::CATEGORY_WEIGHT_AND_MASS, 'UnitName' => 'Imperial ton', 'AllowPrefix' => false],
+ // Distance
+ 'm' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Meter', 'AllowPrefix' => true],
+ 'mi' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Statute mile', 'AllowPrefix' => false],
+ 'Nmi' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Nautical mile', 'AllowPrefix' => false],
+ 'in' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Inch', 'AllowPrefix' => false],
+ 'ft' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Foot', 'AllowPrefix' => false],
+ 'yd' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Yard', 'AllowPrefix' => false],
+ 'ang' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Angstrom', 'AllowPrefix' => true],
+ 'ell' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Ell', 'AllowPrefix' => false],
+ 'ly' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Light Year', 'AllowPrefix' => false],
+ 'parsec' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Parsec', 'AllowPrefix' => false],
+ 'pc' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Parsec', 'AllowPrefix' => false],
+ 'Pica' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Pica (1/72 in)', 'AllowPrefix' => false],
+ 'Picapt' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Pica (1/72 in)', 'AllowPrefix' => false],
+ 'pica' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'Pica (1/6 in)', 'AllowPrefix' => false],
+ 'survey_mi' => ['Group' => self::CATEGORY_DISTANCE, 'UnitName' => 'U.S survey mile (statute mile)', 'AllowPrefix' => false],
+ // Time
+ 'yr' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Year', 'AllowPrefix' => false],
+ 'day' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Day', 'AllowPrefix' => false],
+ 'd' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Day', 'AllowPrefix' => false],
+ 'hr' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Hour', 'AllowPrefix' => false],
+ 'mn' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Minute', 'AllowPrefix' => false],
+ 'min' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Minute', 'AllowPrefix' => false],
+ 'sec' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Second', 'AllowPrefix' => true],
+ 's' => ['Group' => self::CATEGORY_TIME, 'UnitName' => 'Second', 'AllowPrefix' => true],
+ // Pressure
+ 'Pa' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'Pascal', 'AllowPrefix' => true],
+ 'p' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'Pascal', 'AllowPrefix' => true],
+ 'atm' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'Atmosphere', 'AllowPrefix' => true],
+ 'at' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'Atmosphere', 'AllowPrefix' => true],
+ 'mmHg' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'mm of Mercury', 'AllowPrefix' => true],
+ 'psi' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'PSI', 'AllowPrefix' => true],
+ 'Torr' => ['Group' => self::CATEGORY_PRESSURE, 'UnitName' => 'Torr', 'AllowPrefix' => true],
+ // Force
+ 'N' => ['Group' => self::CATEGORY_FORCE, 'UnitName' => 'Newton', 'AllowPrefix' => true],
+ 'dyn' => ['Group' => self::CATEGORY_FORCE, 'UnitName' => 'Dyne', 'AllowPrefix' => true],
+ 'dy' => ['Group' => self::CATEGORY_FORCE, 'UnitName' => 'Dyne', 'AllowPrefix' => true],
+ 'lbf' => ['Group' => self::CATEGORY_FORCE, 'UnitName' => 'Pound force', 'AllowPrefix' => false],
+ 'pond' => ['Group' => self::CATEGORY_FORCE, 'UnitName' => 'Pond', 'AllowPrefix' => true],
+ // Energy
+ 'J' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Joule', 'AllowPrefix' => true],
+ 'e' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Erg', 'AllowPrefix' => true],
+ 'c' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Thermodynamic calorie', 'AllowPrefix' => true],
+ 'cal' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'IT calorie', 'AllowPrefix' => true],
+ 'eV' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Electron volt', 'AllowPrefix' => true],
+ 'ev' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Electron volt', 'AllowPrefix' => true],
+ 'HPh' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Horsepower-hour', 'AllowPrefix' => false],
+ 'hh' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Horsepower-hour', 'AllowPrefix' => false],
+ 'Wh' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Watt-hour', 'AllowPrefix' => true],
+ 'wh' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Watt-hour', 'AllowPrefix' => true],
+ 'flb' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'Foot-pound', 'AllowPrefix' => false],
+ 'BTU' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'BTU', 'AllowPrefix' => false],
+ 'btu' => ['Group' => self::CATEGORY_ENERGY, 'UnitName' => 'BTU', 'AllowPrefix' => false],
+ // Power
+ 'HP' => ['Group' => self::CATEGORY_POWER, 'UnitName' => 'Horsepower', 'AllowPrefix' => false],
+ 'h' => ['Group' => self::CATEGORY_POWER, 'UnitName' => 'Horsepower', 'AllowPrefix' => false],
+ 'W' => ['Group' => self::CATEGORY_POWER, 'UnitName' => 'Watt', 'AllowPrefix' => true],
+ 'w' => ['Group' => self::CATEGORY_POWER, 'UnitName' => 'Watt', 'AllowPrefix' => true],
+ 'PS' => ['Group' => self::CATEGORY_POWER, 'UnitName' => 'Pferdestärke', 'AllowPrefix' => false],
+ // Magnetism
+ 'T' => ['Group' => self::CATEGORY_MAGNETISM, 'UnitName' => 'Tesla', 'AllowPrefix' => true],
+ 'ga' => ['Group' => self::CATEGORY_MAGNETISM, 'UnitName' => 'Gauss', 'AllowPrefix' => true],
+ // Temperature
+ 'C' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Degrees Celsius', 'AllowPrefix' => false],
+ 'cel' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Degrees Celsius', 'AllowPrefix' => false],
+ 'F' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Degrees Fahrenheit', 'AllowPrefix' => false],
+ 'fah' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Degrees Fahrenheit', 'AllowPrefix' => false],
+ 'K' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Kelvin', 'AllowPrefix' => false],
+ 'kel' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Kelvin', 'AllowPrefix' => false],
+ 'Rank' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Degrees Rankine', 'AllowPrefix' => false],
+ 'Reau' => ['Group' => self::CATEGORY_TEMPERATURE, 'UnitName' => 'Degrees Réaumur', 'AllowPrefix' => false],
+ // Volume
+ 'l' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Litre', 'AllowPrefix' => true],
+ 'L' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Litre', 'AllowPrefix' => true],
+ 'lt' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Litre', 'AllowPrefix' => true],
+ 'tsp' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Teaspoon', 'AllowPrefix' => false],
+ 'tspm' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Modern Teaspoon', 'AllowPrefix' => false],
+ 'tbs' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Tablespoon', 'AllowPrefix' => false],
+ 'oz' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Fluid Ounce', 'AllowPrefix' => false],
+ 'cup' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cup', 'AllowPrefix' => false],
+ 'pt' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'U.S. Pint', 'AllowPrefix' => false],
+ 'us_pt' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'U.S. Pint', 'AllowPrefix' => false],
+ 'uk_pt' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'U.K. Pint', 'AllowPrefix' => false],
+ 'qt' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Quart', 'AllowPrefix' => false],
+ 'uk_qt' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Imperial Quart (UK)', 'AllowPrefix' => false],
+ 'gal' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Gallon', 'AllowPrefix' => false],
+ 'uk_gal' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Imperial Gallon (UK)', 'AllowPrefix' => false],
+ 'ang3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Angstrom', 'AllowPrefix' => true],
+ 'ang^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Angstrom', 'AllowPrefix' => true],
+ 'barrel' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'US Oil Barrel', 'AllowPrefix' => false],
+ 'bushel' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'US Bushel', 'AllowPrefix' => false],
+ 'in3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Inch', 'AllowPrefix' => false],
+ 'in^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Inch', 'AllowPrefix' => false],
+ 'ft3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Foot', 'AllowPrefix' => false],
+ 'ft^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Foot', 'AllowPrefix' => false],
+ 'ly3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Light Year', 'AllowPrefix' => false],
+ 'ly^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Light Year', 'AllowPrefix' => false],
+ 'm3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Meter', 'AllowPrefix' => true],
+ 'm^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Meter', 'AllowPrefix' => true],
+ 'mi3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Mile', 'AllowPrefix' => false],
+ 'mi^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Mile', 'AllowPrefix' => false],
+ 'yd3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Yard', 'AllowPrefix' => false],
+ 'yd^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Yard', 'AllowPrefix' => false],
+ 'Nmi3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Nautical Mile', 'AllowPrefix' => false],
+ 'Nmi^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Nautical Mile', 'AllowPrefix' => false],
+ 'Pica3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Pica', 'AllowPrefix' => false],
+ 'Pica^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Pica', 'AllowPrefix' => false],
+ 'Picapt3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Pica', 'AllowPrefix' => false],
+ 'Picapt^3' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Cubic Pica', 'AllowPrefix' => false],
+ 'GRT' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Gross Registered Ton', 'AllowPrefix' => false],
+ 'regton' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Gross Registered Ton', 'AllowPrefix' => false],
+ 'MTON' => ['Group' => self::CATEGORY_VOLUME, 'UnitName' => 'Measurement Ton (Freight Ton)', 'AllowPrefix' => false],
+ // Area
+ 'ha' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Hectare', 'AllowPrefix' => true],
+ 'uk_acre' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'International Acre', 'AllowPrefix' => false],
+ 'us_acre' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'US Survey/Statute Acre', 'AllowPrefix' => false],
+ 'ang2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Angstrom', 'AllowPrefix' => true],
+ 'ang^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Angstrom', 'AllowPrefix' => true],
+ 'ar' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Are', 'AllowPrefix' => true],
+ 'ft2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Feet', 'AllowPrefix' => false],
+ 'ft^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Feet', 'AllowPrefix' => false],
+ 'in2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Inches', 'AllowPrefix' => false],
+ 'in^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Inches', 'AllowPrefix' => false],
+ 'ly2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Light Years', 'AllowPrefix' => false],
+ 'ly^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Light Years', 'AllowPrefix' => false],
+ 'm2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Meters', 'AllowPrefix' => true],
+ 'm^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Meters', 'AllowPrefix' => true],
+ 'Morgen' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Morgen', 'AllowPrefix' => false],
+ 'mi2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Miles', 'AllowPrefix' => false],
+ 'mi^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Miles', 'AllowPrefix' => false],
+ 'Nmi2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Nautical Miles', 'AllowPrefix' => false],
+ 'Nmi^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Nautical Miles', 'AllowPrefix' => false],
+ 'Pica2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Pica', 'AllowPrefix' => false],
+ 'Pica^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Pica', 'AllowPrefix' => false],
+ 'Picapt2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Pica', 'AllowPrefix' => false],
+ 'Picapt^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Pica', 'AllowPrefix' => false],
+ 'yd2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Yards', 'AllowPrefix' => false],
+ 'yd^2' => ['Group' => self::CATEGORY_AREA, 'UnitName' => 'Square Yards', 'AllowPrefix' => false],
+ // Information
+ 'byte' => ['Group' => self::CATEGORY_INFORMATION, 'UnitName' => 'Byte', 'AllowPrefix' => true],
+ 'bit' => ['Group' => self::CATEGORY_INFORMATION, 'UnitName' => 'Bit', 'AllowPrefix' => true],
+ // Speed
+ 'm/s' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Meters per second', 'AllowPrefix' => true],
+ 'm/sec' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Meters per second', 'AllowPrefix' => true],
+ 'm/h' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Meters per hour', 'AllowPrefix' => true],
+ 'm/hr' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Meters per hour', 'AllowPrefix' => true],
+ 'mph' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Miles per hour', 'AllowPrefix' => false],
+ 'admkn' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Admiralty Knot', 'AllowPrefix' => false],
+ 'kn' => ['Group' => self::CATEGORY_SPEED, 'UnitName' => 'Knot', 'AllowPrefix' => false],
+ ];
+
+ /**
+ * Details of the Multiplier prefixes that can be used with Units of Measure in CONVERTUOM().
+ *
+ * @var array
+ */
+ private static array $conversionMultipliers = [
+ 'Y' => ['multiplier' => 1E24, 'name' => 'yotta'],
+ 'Z' => ['multiplier' => 1E21, 'name' => 'zetta'],
+ 'E' => ['multiplier' => 1E18, 'name' => 'exa'],
+ 'P' => ['multiplier' => 1E15, 'name' => 'peta'],
+ 'T' => ['multiplier' => 1E12, 'name' => 'tera'],
+ 'G' => ['multiplier' => 1E9, 'name' => 'giga'],
+ 'M' => ['multiplier' => 1E6, 'name' => 'mega'],
+ 'k' => ['multiplier' => 1E3, 'name' => 'kilo'],
+ 'h' => ['multiplier' => 1E2, 'name' => 'hecto'],
+ 'e' => ['multiplier' => 1E1, 'name' => 'dekao'],
+ 'da' => ['multiplier' => 1E1, 'name' => 'dekao'],
+ 'd' => ['multiplier' => 1E-1, 'name' => 'deci'],
+ 'c' => ['multiplier' => 1E-2, 'name' => 'centi'],
+ 'm' => ['multiplier' => 1E-3, 'name' => 'milli'],
+ 'u' => ['multiplier' => 1E-6, 'name' => 'micro'],
+ 'n' => ['multiplier' => 1E-9, 'name' => 'nano'],
+ 'p' => ['multiplier' => 1E-12, 'name' => 'pico'],
+ 'f' => ['multiplier' => 1E-15, 'name' => 'femto'],
+ 'a' => ['multiplier' => 1E-18, 'name' => 'atto'],
+ 'z' => ['multiplier' => 1E-21, 'name' => 'zepto'],
+ 'y' => ['multiplier' => 1E-24, 'name' => 'yocto'],
+ ];
+
+ /**
+ * Details of the Multiplier prefixes that can be used with Units of Measure in CONVERTUOM().
+ *
+ ** @var array
+ */
+ private static array $binaryConversionMultipliers = [
+ 'Yi' => ['multiplier' => 2 ** 80, 'name' => 'yobi'],
+ 'Zi' => ['multiplier' => 2 ** 70, 'name' => 'zebi'],
+ 'Ei' => ['multiplier' => 2 ** 60, 'name' => 'exbi'],
+ 'Pi' => ['multiplier' => 2 ** 50, 'name' => 'pebi'],
+ 'Ti' => ['multiplier' => 2 ** 40, 'name' => 'tebi'],
+ 'Gi' => ['multiplier' => 2 ** 30, 'name' => 'gibi'],
+ 'Mi' => ['multiplier' => 2 ** 20, 'name' => 'mebi'],
+ 'ki' => ['multiplier' => 2 ** 10, 'name' => 'kibi'],
+ ];
+
+ /**
+ * Details of the Units of measure conversion factors, organised by group.
+ *
+ * @var array>
+ */
+ private static array $unitConversions = [
+ // Conversion uses gram (g) as an intermediate unit
+ self::CATEGORY_WEIGHT_AND_MASS => [
+ 'g' => 1.0,
+ 'sg' => 6.85217658567918E-05,
+ 'lbm' => 2.20462262184878E-03,
+ 'u' => 6.02214179421676E+23,
+ 'ozm' => 3.52739619495804E-02,
+ 'grain' => 1.54323583529414E+01,
+ 'cwt' => 2.20462262184878E-05,
+ 'shweight' => 2.20462262184878E-05,
+ 'uk_cwt' => 1.96841305522212E-05,
+ 'lcwt' => 1.96841305522212E-05,
+ 'hweight' => 1.96841305522212E-05,
+ 'stone' => 1.57473044417770E-04,
+ 'ton' => 1.10231131092439E-06,
+ 'uk_ton' => 9.84206527611061E-07,
+ 'LTON' => 9.84206527611061E-07,
+ 'brton' => 9.84206527611061E-07,
+ ],
+ // Conversion uses meter (m) as an intermediate unit
+ self::CATEGORY_DISTANCE => [
+ 'm' => 1.0,
+ 'mi' => 6.21371192237334E-04,
+ 'Nmi' => 5.39956803455724E-04,
+ 'in' => 3.93700787401575E+01,
+ 'ft' => 3.28083989501312E+00,
+ 'yd' => 1.09361329833771E+00,
+ 'ang' => 1.0E+10,
+ 'ell' => 8.74890638670166E-01,
+ 'ly' => 1.05700083402462E-16,
+ 'parsec' => 3.24077928966473E-17,
+ 'pc' => 3.24077928966473E-17,
+ 'Pica' => 2.83464566929134E+03,
+ 'Picapt' => 2.83464566929134E+03,
+ 'pica' => 2.36220472440945E+02,
+ 'survey_mi' => 6.21369949494950E-04,
+ ],
+ // Conversion uses second (s) as an intermediate unit
+ self::CATEGORY_TIME => [
+ 'yr' => 3.16880878140289E-08,
+ 'day' => 1.15740740740741E-05,
+ 'd' => 1.15740740740741E-05,
+ 'hr' => 2.77777777777778E-04,
+ 'mn' => 1.66666666666667E-02,
+ 'min' => 1.66666666666667E-02,
+ 'sec' => 1.0,
+ 's' => 1.0,
+ ],
+ // Conversion uses Pascal (Pa) as an intermediate unit
+ self::CATEGORY_PRESSURE => [
+ 'Pa' => 1.0,
+ 'p' => 1.0,
+ 'atm' => 9.86923266716013E-06,
+ 'at' => 9.86923266716013E-06,
+ 'mmHg' => 7.50063755419211E-03,
+ 'psi' => 1.45037737730209E-04,
+ 'Torr' => 7.50061682704170E-03,
+ ],
+ // Conversion uses Newton (N) as an intermediate unit
+ self::CATEGORY_FORCE => [
+ 'N' => 1.0,
+ 'dyn' => 1.0E+5,
+ 'dy' => 1.0E+5,
+ 'lbf' => 2.24808923655339E-01,
+ 'pond' => 1.01971621297793E+02,
+ ],
+ // Conversion uses Joule (J) as an intermediate unit
+ self::CATEGORY_ENERGY => [
+ 'J' => 1.0,
+ 'e' => 9.99999519343231E+06,
+ 'c' => 2.39006249473467E-01,
+ 'cal' => 2.38846190642017E-01,
+ 'eV' => 6.24145700000000E+18,
+ 'ev' => 6.24145700000000E+18,
+ 'HPh' => 3.72506430801000E-07,
+ 'hh' => 3.72506430801000E-07,
+ 'Wh' => 2.77777916238711E-04,
+ 'wh' => 2.77777916238711E-04,
+ 'flb' => 2.37304222192651E+01,
+ 'BTU' => 9.47815067349015E-04,
+ 'btu' => 9.47815067349015E-04,
+ ],
+ // Conversion uses Horsepower (HP) as an intermediate unit
+ self::CATEGORY_POWER => [
+ 'HP' => 1.0,
+ 'h' => 1.0,
+ 'W' => 7.45699871582270E+02,
+ 'w' => 7.45699871582270E+02,
+ 'PS' => 1.01386966542400E+00,
+ ],
+ // Conversion uses Tesla (T) as an intermediate unit
+ self::CATEGORY_MAGNETISM => [
+ 'T' => 1.0,
+ 'ga' => 10000.0,
+ ],
+ // Conversion uses litre (l) as an intermediate unit
+ self::CATEGORY_VOLUME => [
+ 'l' => 1.0,
+ 'L' => 1.0,
+ 'lt' => 1.0,
+ 'tsp' => 2.02884136211058E+02,
+ 'tspm' => 2.0E+02,
+ 'tbs' => 6.76280454036860E+01,
+ 'oz' => 3.38140227018430E+01,
+ 'cup' => 4.22675283773038E+00,
+ 'pt' => 2.11337641886519E+00,
+ 'us_pt' => 2.11337641886519E+00,
+ 'uk_pt' => 1.75975398639270E+00,
+ 'qt' => 1.05668820943259E+00,
+ 'uk_qt' => 8.79876993196351E-01,
+ 'gal' => 2.64172052358148E-01,
+ 'uk_gal' => 2.19969248299088E-01,
+ 'ang3' => 1.0E+27,
+ 'ang^3' => 1.0E+27,
+ 'barrel' => 6.28981077043211E-03,
+ 'bushel' => 2.83775932584017E-02,
+ 'in3' => 6.10237440947323E+01,
+ 'in^3' => 6.10237440947323E+01,
+ 'ft3' => 3.53146667214886E-02,
+ 'ft^3' => 3.53146667214886E-02,
+ 'ly3' => 1.18093498844171E-51,
+ 'ly^3' => 1.18093498844171E-51,
+ 'm3' => 1.0E-03,
+ 'm^3' => 1.0E-03,
+ 'mi3' => 2.39912758578928E-13,
+ 'mi^3' => 2.39912758578928E-13,
+ 'yd3' => 1.30795061931439E-03,
+ 'yd^3' => 1.30795061931439E-03,
+ 'Nmi3' => 1.57426214685811E-13,
+ 'Nmi^3' => 1.57426214685811E-13,
+ 'Pica3' => 2.27769904358706E+07,
+ 'Pica^3' => 2.27769904358706E+07,
+ 'Picapt3' => 2.27769904358706E+07,
+ 'Picapt^3' => 2.27769904358706E+07,
+ 'GRT' => 3.53146667214886E-04,
+ 'regton' => 3.53146667214886E-04,
+ 'MTON' => 8.82866668037215E-04,
+ ],
+ // Conversion uses hectare (ha) as an intermediate unit
+ self::CATEGORY_AREA => [
+ 'ha' => 1.0,
+ 'uk_acre' => 2.47105381467165E+00,
+ 'us_acre' => 2.47104393046628E+00,
+ 'ang2' => 1.0E+24,
+ 'ang^2' => 1.0E+24,
+ 'ar' => 1.0E+02,
+ 'ft2' => 1.07639104167097E+05,
+ 'ft^2' => 1.07639104167097E+05,
+ 'in2' => 1.55000310000620E+07,
+ 'in^2' => 1.55000310000620E+07,
+ 'ly2' => 1.11725076312873E-28,
+ 'ly^2' => 1.11725076312873E-28,
+ 'm2' => 1.0E+04,
+ 'm^2' => 1.0E+04,
+ 'Morgen' => 4.0E+00,
+ 'mi2' => 3.86102158542446E-03,
+ 'mi^2' => 3.86102158542446E-03,
+ 'Nmi2' => 2.91553349598123E-03,
+ 'Nmi^2' => 2.91553349598123E-03,
+ 'Pica2' => 8.03521607043214E+10,
+ 'Pica^2' => 8.03521607043214E+10,
+ 'Picapt2' => 8.03521607043214E+10,
+ 'Picapt^2' => 8.03521607043214E+10,
+ 'yd2' => 1.19599004630108E+04,
+ 'yd^2' => 1.19599004630108E+04,
+ ],
+ // Conversion uses bit (bit) as an intermediate unit
+ self::CATEGORY_INFORMATION => [
+ 'bit' => 1.0,
+ 'byte' => 0.125,
+ ],
+ // Conversion uses Meters per Second (m/s) as an intermediate unit
+ self::CATEGORY_SPEED => [
+ 'm/s' => 1.0,
+ 'm/sec' => 1.0,
+ 'm/h' => 3.60E+03,
+ 'm/hr' => 3.60E+03,
+ 'mph' => 2.23693629205440E+00,
+ 'admkn' => 1.94260256941567E+00,
+ 'kn' => 1.94384449244060E+00,
+ ],
+ ];
+
+ /**
+ * getConversionGroups
+ * Returns a list of the different conversion groups for UOM conversions.
+ */
+ public static function getConversionCategories(): array
+ {
+ $conversionGroups = [];
+ foreach (self::$conversionUnits as $conversionUnit) {
+ $conversionGroups[] = $conversionUnit['Group'];
+ }
+
+ return array_merge(array_unique($conversionGroups));
+ }
+
+ /**
+ * getConversionGroupUnits
+ * Returns an array of units of measure, for a specified conversion group, or for all groups.
+ *
+ * @param ?string $category The group whose units of measure you want to retrieve
+ */
+ public static function getConversionCategoryUnits(?string $category = null): array
+ {
+ $conversionGroups = [];
+ foreach (self::$conversionUnits as $conversionUnit => $conversionGroup) {
+ if (($category === null) || ($conversionGroup['Group'] == $category)) {
+ $conversionGroups[$conversionGroup['Group']][] = $conversionUnit;
+ }
+ }
+
+ return $conversionGroups;
+ }
+
+ /**
+ * getConversionGroupUnitDetails.
+ *
+ * @param ?string $category The group whose units of measure you want to retrieve
+ */
+ public static function getConversionCategoryUnitDetails(?string $category = null): array
+ {
+ $conversionGroups = [];
+ foreach (self::$conversionUnits as $conversionUnit => $conversionGroup) {
+ if (($category === null) || ($conversionGroup['Group'] == $category)) {
+ $conversionGroups[$conversionGroup['Group']][] = [
+ 'unit' => $conversionUnit,
+ 'description' => $conversionGroup['UnitName'],
+ ];
+ }
+ }
+
+ return $conversionGroups;
+ }
+
+ /**
+ * getConversionMultipliers
+ * Returns an array of the Multiplier prefixes that can be used with Units of Measure in CONVERTUOM().
+ *
+ * @return mixed[]
+ */
+ public static function getConversionMultipliers(): array
+ {
+ return self::$conversionMultipliers;
+ }
+
+ /**
+ * getBinaryConversionMultipliers
+ * Returns an array of the additional Multiplier prefixes that can be used with Information Units of Measure in CONVERTUOM().
+ *
+ * @return mixed[]
+ */
+ public static function getBinaryConversionMultipliers(): array
+ {
+ return self::$binaryConversionMultipliers;
+ }
+
+ /**
+ * CONVERT.
+ *
+ * Converts a number from one measurement system to another.
+ * For example, CONVERT can translate a table of distances in miles to a table of distances
+ * in kilometers.
+ *
+ * Excel Function:
+ * CONVERT(value,fromUOM,toUOM)
+ *
+ * @param array|float|int|string $value the value in fromUOM to convert
+ * Or can be an array of values
+ * @param array|string $fromUOM the units for value
+ * Or can be an array of values
+ * @param array|string $toUOM the units for the result
+ * Or can be an array of values
+ *
+ * @return array|float|string Result, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function CONVERT($value, $fromUOM, $toUOM)
+ {
+ if (is_array($value) || is_array($fromUOM) || is_array($toUOM)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $fromUOM, $toUOM);
+ }
+
+ if (!is_numeric($value)) {
+ return ExcelError::VALUE();
+ }
+
+ try {
+ [$fromUOM, $fromCategory, $fromMultiplier] = self::getUOMDetails($fromUOM);
+ [$toUOM, $toCategory, $toMultiplier] = self::getUOMDetails($toUOM);
+ } catch (Exception) {
+ return ExcelError::NA();
+ }
+
+ if ($fromCategory !== $toCategory) {
+ return ExcelError::NA();
+ }
+
+ // @var float $value
+ $value *= $fromMultiplier;
+
+ if (($fromUOM === $toUOM) && ($fromMultiplier === $toMultiplier)) {
+ // We've already factored $fromMultiplier into the value, so we need
+ // to reverse it again
+ return $value / $fromMultiplier;
+ } elseif ($fromUOM === $toUOM) {
+ return $value / $toMultiplier;
+ } elseif ($fromCategory === self::CATEGORY_TEMPERATURE) {
+ return self::convertTemperature($fromUOM, $toUOM, $value);
+ }
+
+ $baseValue = $value * (1.0 / self::$unitConversions[$fromCategory][$fromUOM]);
+
+ return ($baseValue * self::$unitConversions[$fromCategory][$toUOM]) / $toMultiplier;
+ }
+
+ private static function getUOMDetails(string $uom): array
+ {
+ if (isset(self::$conversionUnits[$uom])) {
+ $unitCategory = self::$conversionUnits[$uom]['Group'];
+
+ return [$uom, $unitCategory, 1.0];
+ }
+
+ // Check 1-character standard metric multiplier prefixes
+ $multiplierType = substr($uom, 0, 1);
+ $uom = substr($uom, 1);
+ if (isset(self::$conversionUnits[$uom], self::$conversionMultipliers[$multiplierType])) {
+ if (self::$conversionUnits[$uom]['AllowPrefix'] === false) {
+ throw new Exception('Prefix not allowed for UoM');
+ }
+ $unitCategory = self::$conversionUnits[$uom]['Group'];
+
+ return [$uom, $unitCategory, self::$conversionMultipliers[$multiplierType]['multiplier']];
+ }
+
+ $multiplierType .= substr($uom, 0, 1);
+ $uom = substr($uom, 1);
+
+ // Check 2-character standard metric multiplier prefixes
+ if (isset(self::$conversionUnits[$uom], self::$conversionMultipliers[$multiplierType])) {
+ if (self::$conversionUnits[$uom]['AllowPrefix'] === false) {
+ throw new Exception('Prefix not allowed for UoM');
+ }
+ $unitCategory = self::$conversionUnits[$uom]['Group'];
+
+ return [$uom, $unitCategory, self::$conversionMultipliers[$multiplierType]['multiplier']];
+ }
+
+ // Check 2-character binary multiplier prefixes
+ if (isset(self::$conversionUnits[$uom], self::$binaryConversionMultipliers[$multiplierType])) {
+ if (self::$conversionUnits[$uom]['AllowPrefix'] === false) {
+ throw new Exception('Prefix not allowed for UoM');
+ }
+ $unitCategory = self::$conversionUnits[$uom]['Group'];
+ if ($unitCategory !== 'Information') {
+ throw new Exception('Binary Prefix is only allowed for Information UoM');
+ }
+
+ return [$uom, $unitCategory, self::$binaryConversionMultipliers[$multiplierType]['multiplier']];
+ }
+
+ throw new Exception('UoM Not Found');
+ }
+
+ protected static function convertTemperature(string $fromUOM, string $toUOM, float|int $value): float|int
+ {
+ $fromUOM = self::resolveTemperatureSynonyms($fromUOM);
+ $toUOM = self::resolveTemperatureSynonyms($toUOM);
+
+ if ($fromUOM === $toUOM) {
+ return $value;
+ }
+
+ // Convert to Kelvin
+ switch ($fromUOM) {
+ case 'F':
+ $value = ($value - 32) / 1.8 + 273.15;
+
+ break;
+ case 'C':
+ $value += 273.15;
+
+ break;
+ case 'Rank':
+ $value /= 1.8;
+
+ break;
+ case 'Reau':
+ $value = $value * 1.25 + 273.15;
+
+ break;
+ }
+
+ // Convert from Kelvin
+ switch ($toUOM) {
+ case 'F':
+ $value = ($value - 273.15) * 1.8 + 32.00;
+
+ break;
+ case 'C':
+ $value -= 273.15;
+
+ break;
+ case 'Rank':
+ $value *= 1.8;
+
+ break;
+ case 'Reau':
+ $value = ($value - 273.15) * 0.80000;
+
+ break;
+ }
+
+ return $value;
+ }
+
+ private static function resolveTemperatureSynonyms(string $uom): string
+ {
+ return match ($uom) {
+ 'fah' => 'F',
+ 'cel' => 'C',
+ 'kel' => 'K',
+ default => $uom,
+ };
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/EngineeringValidations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/EngineeringValidations.php
new file mode 100644
index 00000000..7e5118ff
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/EngineeringValidations.php
@@ -0,0 +1,27 @@
+ 2.2) {
+ return 1 - self::makeFloat(ErfC::ERFC($value));
+ }
+ $sum = $term = $value;
+ $xsqr = ($value * $value);
+ $j = 1;
+ do {
+ $term *= $xsqr / $j;
+ $sum -= $term / (2 * $j + 1);
+ ++$j;
+ $term *= $xsqr / $j;
+ $sum += $term / (2 * $j + 1);
+ ++$j;
+ if ($sum == 0.0) {
+ break;
+ }
+ } while (abs($term / $sum) > Functions::PRECISION);
+
+ return self::TWO_SQRT_PI * $sum;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ErfC.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ErfC.php
new file mode 100644
index 00000000..4365fecc
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Engineering/ErfC.php
@@ -0,0 +1,77 @@
+ Functions::PRECISION);
+
+ return self::ONE_SQRT_PI * exp(-$value * $value) * $q2;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Exception.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Exception.php
new file mode 100644
index 00000000..ea893d69
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Exception.php
@@ -0,0 +1,22 @@
+line = $line;
+ $e->file = $file;
+
+ throw $e;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/ExceptionHandler.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/ExceptionHandler.php
new file mode 100644
index 00000000..890da60b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/ExceptionHandler.php
@@ -0,0 +1,24 @@
+getMessage();
+ }
+
+ $yearFracx = DateTimeExcel\YearFrac::fraction($purchased, $firstPeriod, $basis);
+ if (is_string($yearFracx)) {
+ return $yearFracx;
+ }
+ /** @var float $yearFrac */
+ $yearFrac = $yearFracx;
+
+ $amortiseCoeff = self::getAmortizationCoefficient($rate);
+
+ $rate *= $amortiseCoeff;
+ $rate = (float) (string) $rate; // ugly way to avoid rounding problem
+ $fNRate = round($yearFrac * $rate * $cost, 0);
+ $cost -= $fNRate;
+ $fRest = $cost - $salvage;
+
+ for ($n = 0; $n < $period; ++$n) {
+ $fNRate = round($rate * $cost, 0);
+ $fRest -= $fNRate;
+
+ if ($fRest < 0.0) {
+ return match ($period - $n) {
+ 1 => round($cost * 0.5, 0),
+ default => 0.0,
+ };
+ }
+ $cost -= $fNRate;
+ }
+
+ return $fNRate;
+ }
+
+ /**
+ * AMORLINC.
+ *
+ * Returns the depreciation for each accounting period.
+ * This function is provided for the French accounting system. If an asset is purchased in
+ * the middle of the accounting period, the prorated depreciation is taken into account.
+ *
+ * Excel Function:
+ * AMORLINC(cost,purchased,firstPeriod,salvage,period,rate[,basis])
+ *
+ * @param mixed $cost The cost of the asset as a float
+ * @param mixed $purchased Date of the purchase of the asset
+ * @param mixed $firstPeriod Date of the end of the first period
+ * @param mixed $salvage The salvage value at the end of the life of the asset
+ * @param mixed $period The period as a float
+ * @param mixed $rate Rate of depreciation as float
+ * @param mixed $basis Integer indicating the type of day count to use.
+ * 0 or omitted US (NASD) 30/360
+ * 1 Actual/actual
+ * 2 Actual/360
+ * 3 Actual/365
+ * 4 European 30/360
+ *
+ * @return float|string (string containing the error type if there is an error)
+ */
+ public static function AMORLINC(
+ mixed $cost,
+ mixed $purchased,
+ mixed $firstPeriod,
+ mixed $salvage,
+ mixed $period,
+ mixed $rate,
+ mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ ): string|float {
+ $cost = Functions::flattenSingleValue($cost);
+ $purchased = Functions::flattenSingleValue($purchased);
+ $firstPeriod = Functions::flattenSingleValue($firstPeriod);
+ $salvage = Functions::flattenSingleValue($salvage);
+ $period = Functions::flattenSingleValue($period);
+ $rate = Functions::flattenSingleValue($rate);
+ $basis = ($basis === null)
+ ? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ : Functions::flattenSingleValue($basis);
+
+ try {
+ $cost = FinancialValidations::validateFloat($cost);
+ $purchased = FinancialValidations::validateDate($purchased);
+ $firstPeriod = FinancialValidations::validateDate($firstPeriod);
+ $salvage = FinancialValidations::validateFloat($salvage);
+ $period = FinancialValidations::validateFloat($period);
+ $rate = FinancialValidations::validateFloat($rate);
+ $basis = FinancialValidations::validateBasis($basis);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $fOneRate = $cost * $rate;
+ $fCostDelta = $cost - $salvage;
+ // Note, quirky variation for leap years on the YEARFRAC for this function
+ $purchasedYear = DateTimeExcel\DateParts::year($purchased);
+ $yearFracx = DateTimeExcel\YearFrac::fraction($purchased, $firstPeriod, $basis);
+ if (is_string($yearFracx)) {
+ return $yearFracx;
+ }
+ /** @var float $yearFrac */
+ $yearFrac = $yearFracx;
+
+ if (
+ $basis == FinancialConstants::BASIS_DAYS_PER_YEAR_ACTUAL
+ && $yearFrac < 1
+ && DateTimeExcel\Helpers::isLeapYear(Functions::scalar($purchasedYear))
+ ) {
+ $yearFrac *= 365 / 366;
+ }
+
+ $f0Rate = $yearFrac * $rate * $cost;
+ $nNumOfFullPeriods = (int) (($cost - $salvage - $f0Rate) / $fOneRate);
+
+ if ($period == 0) {
+ return $f0Rate;
+ } elseif ($period <= $nNumOfFullPeriods) {
+ return $fOneRate;
+ } elseif ($period == ($nNumOfFullPeriods + 1)) {
+ return $fCostDelta - $fOneRate * $nNumOfFullPeriods - $f0Rate;
+ }
+
+ return 0.0;
+ }
+
+ private static function getAmortizationCoefficient(float $rate): float
+ {
+ // The depreciation coefficients are:
+ // Life of assets (1/rate) Depreciation coefficient
+ // Less than 3 years 1
+ // Between 3 and 4 years 1.5
+ // Between 5 and 6 years 2
+ // More than 6 years 2.5
+ $fUsePer = 1.0 / $rate;
+
+ if ($fUsePer < 3.0) {
+ return 1.0;
+ } elseif ($fUsePer < 4.0) {
+ return 1.5;
+ } elseif ($fUsePer <= 6.0) {
+ return 2.0;
+ }
+
+ return 2.5;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/CashFlowValidations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/CashFlowValidations.php
new file mode 100644
index 00000000..f5719b69
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/CashFlowValidations.php
@@ -0,0 +1,41 @@
+getMessage();
+ }
+
+ return self::calculateFutureValue($rate, $numberOfPeriods, $payment, $presentValue, $type);
+ }
+
+ /**
+ * PV.
+ *
+ * Returns the Present Value of a cash flow with constant payments and interest rate (annuities).
+ *
+ * @param mixed $rate Interest rate per period
+ * @param mixed $numberOfPeriods Number of periods as an integer
+ * @param mixed $payment Periodic payment (annuity)
+ * @param mixed $futureValue Future Value
+ * @param mixed $type Payment type: 0 = at the end of each period, 1 = at the beginning of each period
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function presentValue(
+ mixed $rate,
+ mixed $numberOfPeriods,
+ mixed $payment = 0.0,
+ mixed $futureValue = 0.0,
+ mixed $type = FinancialConstants::PAYMENT_END_OF_PERIOD
+ ): string|float {
+ $rate = Functions::flattenSingleValue($rate);
+ $numberOfPeriods = Functions::flattenSingleValue($numberOfPeriods);
+ $payment = ($payment === null) ? 0.0 : Functions::flattenSingleValue($payment);
+ $futureValue = ($futureValue === null) ? 0.0 : Functions::flattenSingleValue($futureValue);
+ $type = ($type === null) ? FinancialConstants::PAYMENT_END_OF_PERIOD : Functions::flattenSingleValue($type);
+
+ try {
+ $rate = CashFlowValidations::validateRate($rate);
+ $numberOfPeriods = CashFlowValidations::validateInt($numberOfPeriods);
+ $payment = CashFlowValidations::validateFloat($payment);
+ $futureValue = CashFlowValidations::validateFutureValue($futureValue);
+ $type = CashFlowValidations::validatePeriodType($type);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Validate parameters
+ if ($numberOfPeriods < 0) {
+ return ExcelError::NAN();
+ }
+
+ return self::calculatePresentValue($rate, $numberOfPeriods, $payment, $futureValue, $type);
+ }
+
+ /**
+ * NPER.
+ *
+ * Returns the number of periods for a cash flow with constant periodic payments (annuities), and interest rate.
+ *
+ * @param mixed $rate Interest rate per period
+ * @param mixed $payment Periodic payment (annuity)
+ * @param mixed $presentValue Present Value
+ * @param mixed $futureValue Future Value
+ * @param mixed $type Payment type: 0 = at the end of each period, 1 = at the beginning of each period
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function periods(
+ mixed $rate,
+ mixed $payment,
+ mixed $presentValue,
+ mixed $futureValue = 0.0,
+ mixed $type = FinancialConstants::PAYMENT_END_OF_PERIOD
+ ) {
+ $rate = Functions::flattenSingleValue($rate);
+ $payment = Functions::flattenSingleValue($payment);
+ $presentValue = Functions::flattenSingleValue($presentValue);
+ $futureValue = ($futureValue === null) ? 0.0 : Functions::flattenSingleValue($futureValue);
+ $type = ($type === null) ? FinancialConstants::PAYMENT_END_OF_PERIOD : Functions::flattenSingleValue($type);
+
+ try {
+ $rate = CashFlowValidations::validateRate($rate);
+ $payment = CashFlowValidations::validateFloat($payment);
+ $presentValue = CashFlowValidations::validatePresentValue($presentValue);
+ $futureValue = CashFlowValidations::validateFutureValue($futureValue);
+ $type = CashFlowValidations::validatePeriodType($type);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Validate parameters
+ if ($payment == 0.0) {
+ return ExcelError::NAN();
+ }
+
+ return self::calculatePeriods($rate, $payment, $presentValue, $futureValue, $type);
+ }
+
+ private static function calculateFutureValue(
+ float $rate,
+ int $numberOfPeriods,
+ float $payment,
+ float $presentValue,
+ int $type
+ ): float {
+ if ($rate !== null && $rate != 0) {
+ return -$presentValue
+ * (1 + $rate) ** $numberOfPeriods - $payment * (1 + $rate * $type) * ((1 + $rate) ** $numberOfPeriods - 1)
+ / $rate;
+ }
+
+ return -$presentValue - $payment * $numberOfPeriods;
+ }
+
+ private static function calculatePresentValue(
+ float $rate,
+ int $numberOfPeriods,
+ float $payment,
+ float $futureValue,
+ int $type
+ ): float {
+ if ($rate != 0.0) {
+ return (-$payment * (1 + $rate * $type)
+ * (((1 + $rate) ** $numberOfPeriods - 1) / $rate) - $futureValue) / (1 + $rate) ** $numberOfPeriods;
+ }
+
+ return -$futureValue - $payment * $numberOfPeriods;
+ }
+
+ private static function calculatePeriods(
+ float $rate,
+ float $payment,
+ float $presentValue,
+ float $futureValue,
+ int $type
+ ): string|float {
+ if ($rate != 0.0) {
+ if ($presentValue == 0.0) {
+ return ExcelError::NAN();
+ }
+
+ return log(($payment * (1 + $rate * $type) / $rate - $futureValue)
+ / ($presentValue + $payment * (1 + $rate * $type) / $rate)) / log(1 + $rate);
+ }
+
+ return (-$presentValue - $futureValue) / $payment;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Cumulative.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Cumulative.php
new file mode 100644
index 00000000..94359090
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Cumulative.php
@@ -0,0 +1,138 @@
+getMessage();
+ }
+
+ // Validate parameters
+ if ($start < 1 || $start > $end) {
+ return ExcelError::NAN();
+ }
+
+ // Calculate
+ $interest = 0;
+ for ($per = $start; $per <= $end; ++$per) {
+ $ipmt = Interest::payment($rate, $per, $periods, $presentValue, 0, $type);
+ if (is_string($ipmt)) {
+ return $ipmt;
+ }
+
+ $interest += $ipmt;
+ }
+
+ return $interest;
+ }
+
+ /**
+ * CUMPRINC.
+ *
+ * Returns the cumulative principal paid on a loan between the start and end periods.
+ *
+ * Excel Function:
+ * CUMPRINC(rate,nper,pv,start,end[,type])
+ *
+ * @param mixed $rate The Interest rate
+ * @param mixed $periods The total number of payment periods as an integer
+ * @param mixed $presentValue Present Value
+ * @param mixed $start The first period in the calculation.
+ * Payment periods are numbered beginning with 1.
+ * @param mixed $end the last period in the calculation
+ * @param mixed $type A number 0 or 1 and indicates when payments are due:
+ * 0 or omitted At the end of the period.
+ * 1 At the beginning of the period.
+ */
+ public static function principal(
+ mixed $rate,
+ mixed $periods,
+ mixed $presentValue,
+ mixed $start,
+ mixed $end,
+ mixed $type = FinancialConstants::PAYMENT_END_OF_PERIOD
+ ): string|float|int {
+ $rate = Functions::flattenSingleValue($rate);
+ $periods = Functions::flattenSingleValue($periods);
+ $presentValue = Functions::flattenSingleValue($presentValue);
+ $start = Functions::flattenSingleValue($start);
+ $end = Functions::flattenSingleValue($end);
+ $type = ($type === null) ? FinancialConstants::PAYMENT_END_OF_PERIOD : Functions::flattenSingleValue($type);
+
+ try {
+ $rate = CashFlowValidations::validateRate($rate);
+ $periods = CashFlowValidations::validateInt($periods);
+ $presentValue = CashFlowValidations::validatePresentValue($presentValue);
+ $start = CashFlowValidations::validateInt($start);
+ $end = CashFlowValidations::validateInt($end);
+ $type = CashFlowValidations::validatePeriodType($type);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Validate parameters
+ if ($start < 1 || $start > $end) {
+ return ExcelError::VALUE();
+ }
+
+ // Calculate
+ $principal = 0;
+ for ($per = $start; $per <= $end; ++$per) {
+ $ppmt = Payments::interestPayment($rate, $per, $periods, $presentValue, 0, $type);
+ if (is_string($ppmt)) {
+ return $ppmt;
+ }
+
+ $principal += $ppmt;
+ }
+
+ return $principal;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Interest.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Interest.php
new file mode 100644
index 00000000..ad68ec13
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Interest.php
@@ -0,0 +1,213 @@
+getMessage();
+ }
+
+ // Validate parameters
+ if ($period <= 0 || $period > $numberOfPeriods) {
+ return ExcelError::NAN();
+ }
+
+ // Calculate
+ $interestAndPrincipal = new InterestAndPrincipal(
+ $interestRate,
+ $period,
+ $numberOfPeriods,
+ $presentValue,
+ $futureValue,
+ $type
+ );
+
+ return $interestAndPrincipal->interest();
+ }
+
+ /**
+ * ISPMT.
+ *
+ * Returns the interest payment for an investment based on an interest rate and a constant payment schedule.
+ *
+ * Excel Function:
+ * =ISPMT(interest_rate, period, number_payments, pv)
+ *
+ * @param mixed $interestRate is the interest rate for the investment
+ * @param mixed $period is the period to calculate the interest rate. It must be betweeen 1 and number_payments.
+ * @param mixed $numberOfPeriods is the number of payments for the annuity
+ * @param mixed $principleRemaining is the loan amount or present value of the payments
+ */
+ public static function schedulePayment(mixed $interestRate, mixed $period, mixed $numberOfPeriods, mixed $principleRemaining): string|float
+ {
+ $interestRate = Functions::flattenSingleValue($interestRate);
+ $period = Functions::flattenSingleValue($period);
+ $numberOfPeriods = Functions::flattenSingleValue($numberOfPeriods);
+ $principleRemaining = Functions::flattenSingleValue($principleRemaining);
+
+ try {
+ $interestRate = CashFlowValidations::validateRate($interestRate);
+ $period = CashFlowValidations::validateInt($period);
+ $numberOfPeriods = CashFlowValidations::validateInt($numberOfPeriods);
+ $principleRemaining = CashFlowValidations::validateFloat($principleRemaining);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Validate parameters
+ if ($period <= 0 || $period > $numberOfPeriods) {
+ return ExcelError::NAN();
+ }
+
+ // Return value
+ $returnValue = 0;
+
+ // Calculate
+ $principlePayment = ($principleRemaining * 1.0) / ($numberOfPeriods * 1.0);
+ for ($i = 0; $i <= $period; ++$i) {
+ $returnValue = $interestRate * $principleRemaining * -1;
+ $principleRemaining -= $principlePayment;
+ // principle needs to be 0 after the last payment, don't let floating point screw it up
+ if ($i == $numberOfPeriods) {
+ $returnValue = 0.0;
+ }
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * RATE.
+ *
+ * Returns the interest rate per period of an annuity.
+ * RATE is calculated by iteration and can have zero or more solutions.
+ * If the successive results of RATE do not converge to within 0.0000001 after 20 iterations,
+ * RATE returns the #NUM! error value.
+ *
+ * Excel Function:
+ * RATE(nper,pmt,pv[,fv[,type[,guess]]])
+ *
+ * @param mixed $numberOfPeriods The total number of payment periods in an annuity
+ * @param mixed $payment The payment made each period and cannot change over the life of the annuity.
+ * Typically, pmt includes principal and interest but no other fees or taxes.
+ * @param mixed $presentValue The present value - the total amount that a series of future payments is worth now
+ * @param mixed $futureValue The future value, or a cash balance you want to attain after the last payment is made.
+ * If fv is omitted, it is assumed to be 0 (the future value of a loan,
+ * for example, is 0).
+ * @param mixed $type A number 0 or 1 and indicates when payments are due:
+ * 0 or omitted At the end of the period.
+ * 1 At the beginning of the period.
+ * @param mixed $guess Your guess for what the rate will be.
+ * If you omit guess, it is assumed to be 10 percent.
+ */
+ public static function rate(
+ mixed $numberOfPeriods,
+ mixed $payment,
+ mixed $presentValue,
+ mixed $futureValue = 0.0,
+ mixed $type = FinancialConstants::PAYMENT_END_OF_PERIOD,
+ mixed $guess = 0.1
+ ): string|float {
+ $numberOfPeriods = Functions::flattenSingleValue($numberOfPeriods);
+ $payment = Functions::flattenSingleValue($payment);
+ $presentValue = Functions::flattenSingleValue($presentValue);
+ $futureValue = ($futureValue === null) ? 0.0 : Functions::flattenSingleValue($futureValue);
+ $type = ($type === null) ? FinancialConstants::PAYMENT_END_OF_PERIOD : Functions::flattenSingleValue($type);
+ $guess = ($guess === null) ? 0.1 : Functions::flattenSingleValue($guess);
+
+ try {
+ $numberOfPeriods = CashFlowValidations::validateFloat($numberOfPeriods);
+ $payment = CashFlowValidations::validateFloat($payment);
+ $presentValue = CashFlowValidations::validatePresentValue($presentValue);
+ $futureValue = CashFlowValidations::validateFutureValue($futureValue);
+ $type = CashFlowValidations::validatePeriodType($type);
+ $guess = CashFlowValidations::validateFloat($guess);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $rate = $guess;
+ // rest of code adapted from python/numpy
+ $close = false;
+ $iter = 0;
+ while (!$close && $iter < self::FINANCIAL_MAX_ITERATIONS) {
+ $nextdiff = self::rateNextGuess($rate, $numberOfPeriods, $payment, $presentValue, $futureValue, $type);
+ if (!is_numeric($nextdiff)) {
+ break;
+ }
+ $rate1 = $rate - $nextdiff;
+ $close = abs($rate1 - $rate) < self::FINANCIAL_PRECISION;
+ ++$iter;
+ $rate = $rate1;
+ }
+
+ return $close ? $rate : ExcelError::NAN();
+ }
+
+ private static function rateNextGuess(float $rate, float $numberOfPeriods, float $payment, float $presentValue, float $futureValue, int $type): string|float
+ {
+ if ($rate == 0.0) {
+ return ExcelError::NAN();
+ }
+ $tt1 = ($rate + 1) ** $numberOfPeriods;
+ $tt2 = ($rate + 1) ** ($numberOfPeriods - 1);
+ $numerator = $futureValue + $tt1 * $presentValue + $payment * ($tt1 - 1) * ($rate * $type + 1) / $rate;
+ $denominator = $numberOfPeriods * $tt2 * $presentValue - $payment * ($tt1 - 1)
+ * ($rate * $type + 1) / ($rate * $rate) + $numberOfPeriods
+ * $payment * $tt2 * ($rate * $type + 1) / $rate + $payment * ($tt1 - 1) * $type / $rate;
+ if ($denominator == 0) {
+ return ExcelError::NAN();
+ }
+
+ return $numerator / $denominator;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/InterestAndPrincipal.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/InterestAndPrincipal.php
new file mode 100644
index 00000000..ea9abb98
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/InterestAndPrincipal.php
@@ -0,0 +1,44 @@
+interest = $interest;
+ $this->principal = $principal;
+ }
+
+ public function interest(): float
+ {
+ return $this->interest;
+ }
+
+ public function principal(): float
+ {
+ return $this->principal;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Payments.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Payments.php
new file mode 100644
index 00000000..41e88f9a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Constant/Periodic/Payments.php
@@ -0,0 +1,116 @@
+getMessage();
+ }
+
+ // Calculate
+ if ($interestRate != 0.0) {
+ return (-$futureValue - $presentValue * (1 + $interestRate) ** $numberOfPeriods)
+ / (1 + $interestRate * $type) / (((1 + $interestRate) ** $numberOfPeriods - 1) / $interestRate);
+ }
+
+ return (-$presentValue - $futureValue) / $numberOfPeriods;
+ }
+
+ /**
+ * PPMT.
+ *
+ * Returns the interest payment for a given period for an investment based on periodic, constant payments
+ * and a constant interest rate.
+ *
+ * @param mixed $interestRate Interest rate per period
+ * @param mixed $period Period for which we want to find the interest
+ * @param mixed $numberOfPeriods Number of periods
+ * @param mixed $presentValue Present Value
+ * @param mixed $futureValue Future Value
+ * @param mixed $type Payment type: 0 = at the end of each period, 1 = at the beginning of each period
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function interestPayment(
+ mixed $interestRate,
+ mixed $period,
+ mixed $numberOfPeriods,
+ mixed $presentValue,
+ mixed $futureValue = 0,
+ mixed $type = FinancialConstants::PAYMENT_END_OF_PERIOD
+ ): string|float {
+ $interestRate = Functions::flattenSingleValue($interestRate);
+ $period = Functions::flattenSingleValue($period);
+ $numberOfPeriods = Functions::flattenSingleValue($numberOfPeriods);
+ $presentValue = Functions::flattenSingleValue($presentValue);
+ $futureValue = ($futureValue === null) ? 0.0 : Functions::flattenSingleValue($futureValue);
+ $type = ($type === null) ? FinancialConstants::PAYMENT_END_OF_PERIOD : Functions::flattenSingleValue($type);
+
+ try {
+ $interestRate = CashFlowValidations::validateRate($interestRate);
+ $period = CashFlowValidations::validateInt($period);
+ $numberOfPeriods = CashFlowValidations::validateInt($numberOfPeriods);
+ $presentValue = CashFlowValidations::validatePresentValue($presentValue);
+ $futureValue = CashFlowValidations::validateFutureValue($futureValue);
+ $type = CashFlowValidations::validatePeriodType($type);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Validate parameters
+ if ($period <= 0 || $period > $numberOfPeriods) {
+ return ExcelError::NAN();
+ }
+
+ // Calculate
+ $interestAndPrincipal = new InterestAndPrincipal(
+ $interestRate,
+ $period,
+ $numberOfPeriods,
+ $presentValue,
+ $futureValue,
+ $type
+ );
+
+ return $interestAndPrincipal->principal();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Single.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Single.php
new file mode 100644
index 00000000..6f60a2af
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Single.php
@@ -0,0 +1,107 @@
+getMessage();
+ }
+
+ return $principal;
+ }
+
+ /**
+ * PDURATION.
+ *
+ * Calculates the number of periods required for an investment to reach a specified value.
+ *
+ * @param mixed $rate Interest rate per period
+ * @param mixed $presentValue Present Value
+ * @param mixed $futureValue Future Value
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function periods(mixed $rate, mixed $presentValue, mixed $futureValue): string|float
+ {
+ $rate = Functions::flattenSingleValue($rate);
+ $presentValue = Functions::flattenSingleValue($presentValue);
+ $futureValue = Functions::flattenSingleValue($futureValue);
+
+ try {
+ $rate = CashFlowValidations::validateRate($rate);
+ $presentValue = CashFlowValidations::validatePresentValue($presentValue);
+ $futureValue = CashFlowValidations::validateFutureValue($futureValue);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Validate parameters
+ if ($rate <= 0.0 || $presentValue <= 0.0 || $futureValue <= 0.0) {
+ return ExcelError::NAN();
+ }
+
+ return (log($futureValue) - log($presentValue)) / log(1 + $rate);
+ }
+
+ /**
+ * RRI.
+ *
+ * Calculates the interest rate required for an investment to grow to a specified future value .
+ *
+ * @param array|float $periods The number of periods over which the investment is made
+ * @param array|float $presentValue Present Value
+ * @param array|float $futureValue Future Value
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function interestRate(array|float $periods = 0.0, array|float $presentValue = 0.0, array|float $futureValue = 0.0): string|float
+ {
+ $periods = Functions::flattenSingleValue($periods);
+ $presentValue = Functions::flattenSingleValue($presentValue);
+ $futureValue = Functions::flattenSingleValue($futureValue);
+
+ try {
+ $periods = CashFlowValidations::validateFloat($periods);
+ $presentValue = CashFlowValidations::validatePresentValue($presentValue);
+ $futureValue = CashFlowValidations::validateFutureValue($futureValue);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Validate parameters
+ if ($periods <= 0.0 || $presentValue <= 0.0 || $futureValue < 0.0) {
+ return ExcelError::NAN();
+ }
+
+ return ($futureValue / $presentValue) ** (1 / $periods) - 1;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Variable/NonPeriodic.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Variable/NonPeriodic.php
new file mode 100644
index 00000000..8c6f615b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Variable/NonPeriodic.php
@@ -0,0 +1,301 @@
+ 1;
+ $datesIsArray = count($dates) > 1;
+ if (!$valuesIsArray && !$datesIsArray) {
+ return ExcelError::NA();
+ }
+ if (count($values) != count($dates)) {
+ return ExcelError::NAN();
+ }
+
+ $datesCount = count($dates);
+ for ($i = 0; $i < $datesCount; ++$i) {
+ try {
+ $dates[$i] = DateTimeExcel\Helpers::getDateValue($dates[$i]);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+ }
+
+ return self::xirrPart2($values);
+ }
+
+ private static function xirrPart2(array &$values): string
+ {
+ $valCount = count($values);
+ $foundpos = false;
+ $foundneg = false;
+ for ($i = 0; $i < $valCount; ++$i) {
+ $fld = $values[$i];
+ if (!is_numeric($fld)) {
+ return ExcelError::VALUE();
+ } elseif ($fld > 0) {
+ $foundpos = true;
+ } elseif ($fld < 0) {
+ $foundneg = true;
+ }
+ }
+ if (!self::bothNegAndPos($foundneg, $foundpos)) {
+ return ExcelError::NAN();
+ }
+
+ return '';
+ }
+
+ private static function xirrPart3(array $values, array $dates, float $x1, float $x2): float|string
+ {
+ $f = self::xnpvOrdered($x1, $values, $dates, false);
+ if ($f < 0.0) {
+ $rtb = $x1;
+ $dx = $x2 - $x1;
+ } else {
+ $rtb = $x2;
+ $dx = $x1 - $x2;
+ }
+
+ $rslt = ExcelError::VALUE();
+ for ($i = 0; $i < self::FINANCIAL_MAX_ITERATIONS; ++$i) {
+ $dx *= 0.5;
+ $x_mid = $rtb + $dx;
+ $f_mid = (float) self::xnpvOrdered($x_mid, $values, $dates, false);
+ if ($f_mid <= 0.0) {
+ $rtb = $x_mid;
+ }
+ if ((abs($f_mid) < self::FINANCIAL_PRECISION) || (abs($dx) < self::FINANCIAL_PRECISION)) {
+ $rslt = $x_mid;
+
+ break;
+ }
+ }
+
+ return $rslt;
+ }
+
+ private static function xirrBisection(array $values, array $dates, float $x1, float $x2): string|float
+ {
+ $rslt = ExcelError::NAN();
+ for ($i = 0; $i < self::FINANCIAL_MAX_ITERATIONS; ++$i) {
+ $rslt = ExcelError::NAN();
+ $f1 = self::xnpvOrdered($x1, $values, $dates, false, true);
+ $f2 = self::xnpvOrdered($x2, $values, $dates, false, true);
+ if (!is_numeric($f1) || !is_numeric($f2)) {
+ break;
+ }
+ $f1 = (float) $f1;
+ $f2 = (float) $f2;
+ if (abs($f1) < self::FINANCIAL_PRECISION && abs($f2) < self::FINANCIAL_PRECISION) {
+ break;
+ }
+ if ($f1 * $f2 > 0) {
+ break;
+ }
+ $rslt = ($x1 + $x2) / 2;
+ $f3 = self::xnpvOrdered($rslt, $values, $dates, false, true);
+ if (!is_float($f3)) {
+ break;
+ }
+ if ($f3 * $f1 < 0) {
+ $x2 = $rslt;
+ } else {
+ $x1 = $rslt;
+ }
+ if (abs($f3) < self::FINANCIAL_PRECISION) {
+ break;
+ }
+ }
+
+ return $rslt;
+ }
+
+ private static function xnpvOrdered(mixed $rate, mixed $values, mixed $dates, bool $ordered = true, bool $capAtNegative1 = false): float|string
+ {
+ $rate = Functions::flattenSingleValue($rate);
+ $values = Functions::flattenArray($values);
+ $dates = Functions::flattenArray($dates);
+ $valCount = count($values);
+
+ try {
+ self::validateXnpv($rate, $values, $dates);
+ if ($capAtNegative1 && $rate <= -1) {
+ $rate = -1.0 + 1.0E-10;
+ }
+ $date0 = DateTimeExcel\Helpers::getDateValue($dates[0]);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $xnpv = 0.0;
+ for ($i = 0; $i < $valCount; ++$i) {
+ if (!is_numeric($values[$i])) {
+ return ExcelError::VALUE();
+ }
+
+ try {
+ $datei = DateTimeExcel\Helpers::getDateValue($dates[$i]);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+ if ($date0 > $datei) {
+ $dif = $ordered ? ExcelError::NAN() : -((int) DateTimeExcel\Difference::interval($datei, $date0, 'd'));
+ } else {
+ $dif = Functions::scalar(DateTimeExcel\Difference::interval($date0, $datei, 'd'));
+ }
+ if (!is_numeric($dif)) {
+ return $dif;
+ }
+ if ($rate <= -1.0) {
+ $xnpv += -abs($values[$i]) / (-1 - $rate) ** ($dif / 365);
+ } else {
+ $xnpv += $values[$i] / (1 + $rate) ** ($dif / 365);
+ }
+ }
+
+ return is_finite($xnpv) ? $xnpv : ExcelError::VALUE();
+ }
+
+ private static function validateXnpv(mixed $rate, array $values, array $dates): void
+ {
+ if (!is_numeric($rate)) {
+ throw new Exception(ExcelError::VALUE());
+ }
+ $valCount = count($values);
+ if ($valCount != count($dates)) {
+ throw new Exception(ExcelError::NAN());
+ }
+ if ($valCount > 1 && ((min($values) > 0) || (max($values) < 0))) {
+ throw new Exception(ExcelError::NAN());
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Variable/Periodic.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Variable/Periodic.php
new file mode 100644
index 00000000..21e537be
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/CashFlow/Variable/Periodic.php
@@ -0,0 +1,157 @@
+ 0.0) {
+ return ExcelError::VALUE();
+ }
+
+ $f = self::presentValue($x1, $values);
+ if ($f < 0.0) {
+ $rtb = $x1;
+ $dx = $x2 - $x1;
+ } else {
+ $rtb = $x2;
+ $dx = $x1 - $x2;
+ }
+
+ for ($i = 0; $i < self::FINANCIAL_MAX_ITERATIONS; ++$i) {
+ $dx *= 0.5;
+ $x_mid = $rtb + $dx;
+ $f_mid = self::presentValue($x_mid, $values);
+ if ($f_mid <= 0.0) {
+ $rtb = $x_mid;
+ }
+ if ((abs($f_mid) < self::FINANCIAL_PRECISION) || (abs($dx) < self::FINANCIAL_PRECISION)) {
+ return $x_mid;
+ }
+ }
+
+ return ExcelError::VALUE();
+ }
+
+ /**
+ * MIRR.
+ *
+ * Returns the modified internal rate of return for a series of periodic cash flows. MIRR considers both
+ * the cost of the investment and the interest received on reinvestment of cash.
+ *
+ * Excel Function:
+ * MIRR(values,finance_rate, reinvestment_rate)
+ *
+ * @param mixed $values An array or a reference to cells that contain a series of payments and
+ * income occurring at regular intervals.
+ * Payments are negative value, income is positive values.
+ * @param mixed $financeRate The interest rate you pay on the money used in the cash flows
+ * @param mixed $reinvestmentRate The interest rate you receive on the cash flows as you reinvest them
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function modifiedRate(mixed $values, mixed $financeRate, mixed $reinvestmentRate): string|float
+ {
+ if (!is_array($values)) {
+ return ExcelError::DIV0();
+ }
+ $values = Functions::flattenArray($values);
+ $financeRate = Functions::flattenSingleValue($financeRate);
+ $reinvestmentRate = Functions::flattenSingleValue($reinvestmentRate);
+ $n = count($values);
+
+ $rr = 1.0 + $reinvestmentRate;
+ $fr = 1.0 + $financeRate;
+
+ $npvPos = $npvNeg = 0.0;
+ foreach ($values as $i => $v) {
+ if ($v >= 0) {
+ $npvPos += $v / $rr ** $i;
+ } else {
+ $npvNeg += $v / $fr ** $i;
+ }
+ }
+
+ if ($npvNeg === 0.0 || $npvPos === 0.0) {
+ return ExcelError::DIV0();
+ }
+
+ $mirr = ((-$npvPos * $rr ** $n)
+ / ($npvNeg * ($rr))) ** (1.0 / ($n - 1)) - 1.0;
+
+ return is_finite($mirr) ? $mirr : ExcelError::NAN();
+ }
+
+ /**
+ * NPV.
+ *
+ * Returns the Net Present Value of a cash flow series given a discount rate.
+ *
+ * @param array $args
+ */
+ public static function presentValue(mixed $rate, ...$args): int|float
+ {
+ $returnValue = 0;
+
+ $rate = Functions::flattenSingleValue($rate);
+ $aArgs = Functions::flattenArray($args);
+
+ // Calculate
+ $countArgs = count($aArgs);
+ for ($i = 1; $i <= $countArgs; ++$i) {
+ // Is it a numeric value?
+ if (is_numeric($aArgs[$i - 1])) {
+ $returnValue += $aArgs[$i - 1] / (1 + $rate) ** $i;
+ }
+ }
+
+ return $returnValue;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Constants.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Constants.php
new file mode 100644
index 00000000..17740b0a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Constants.php
@@ -0,0 +1,19 @@
+getMessage();
+ }
+
+ $daysPerYear = Helpers::daysPerYear(Functions::scalar(DateTimeExcel\DateParts::year($settlement)), $basis);
+ if (is_string($daysPerYear)) {
+ return ExcelError::VALUE();
+ }
+ $prev = self::couponFirstPeriodDate($settlement, $maturity, $frequency, self::PERIOD_DATE_PREVIOUS);
+
+ if ($basis === FinancialConstants::BASIS_DAYS_PER_YEAR_ACTUAL) {
+ return abs((float) DateTimeExcel\Days::between($prev, $settlement));
+ }
+
+ return (float) DateTimeExcel\YearFrac::fraction($prev, $settlement, $basis) * $daysPerYear;
+ }
+
+ /**
+ * COUPDAYS.
+ *
+ * Returns the number of days in the coupon period that contains the settlement date.
+ *
+ * Excel Function:
+ * COUPDAYS(settlement,maturity,frequency[,basis])
+ *
+ * @param mixed $settlement The security's settlement date.
+ * The security settlement date is the date after the issue
+ * date when the security is traded to the buyer.
+ * @param mixed $maturity The security's maturity date.
+ * The maturity date is the date when the security expires.
+ * @param mixed $frequency The number of coupon payments per year.
+ * Valid frequency values are:
+ * 1 Annual
+ * 2 Semi-Annual
+ * 4 Quarterly
+ * @param mixed $basis The type of day count to use (int).
+ * 0 or omitted US (NASD) 30/360
+ * 1 Actual/actual
+ * 2 Actual/360
+ * 3 Actual/365
+ * 4 European 30/360
+ */
+ public static function COUPDAYS(
+ mixed $settlement,
+ mixed $maturity,
+ mixed $frequency,
+ mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ ): string|int|float {
+ $settlement = Functions::flattenSingleValue($settlement);
+ $maturity = Functions::flattenSingleValue($maturity);
+ $frequency = Functions::flattenSingleValue($frequency);
+ $basis = ($basis === null)
+ ? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ : Functions::flattenSingleValue($basis);
+
+ try {
+ $settlement = FinancialValidations::validateSettlementDate($settlement);
+ $maturity = FinancialValidations::validateMaturityDate($maturity);
+ self::validateCouponPeriod($settlement, $maturity);
+ $frequency = FinancialValidations::validateFrequency($frequency);
+ $basis = FinancialValidations::validateBasis($basis);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ switch ($basis) {
+ case FinancialConstants::BASIS_DAYS_PER_YEAR_365:
+ // Actual/365
+ return 365 / $frequency;
+ case FinancialConstants::BASIS_DAYS_PER_YEAR_ACTUAL:
+ // Actual/actual
+ if ($frequency == FinancialConstants::FREQUENCY_ANNUAL) {
+ $daysPerYear = (int) Helpers::daysPerYear(Functions::scalar(DateTimeExcel\DateParts::year($settlement)), $basis);
+
+ return $daysPerYear / $frequency;
+ }
+ $prev = self::couponFirstPeriodDate($settlement, $maturity, $frequency, self::PERIOD_DATE_PREVIOUS);
+ $next = self::couponFirstPeriodDate($settlement, $maturity, $frequency, self::PERIOD_DATE_NEXT);
+
+ return $next - $prev;
+ default:
+ // US (NASD) 30/360, Actual/360 or European 30/360
+ return 360 / $frequency;
+ }
+ }
+
+ /**
+ * COUPDAYSNC.
+ *
+ * Returns the number of days from the settlement date to the next coupon date.
+ *
+ * Excel Function:
+ * COUPDAYSNC(settlement,maturity,frequency[,basis])
+ *
+ * @param mixed $settlement The security's settlement date.
+ * The security settlement date is the date after the issue
+ * date when the security is traded to the buyer.
+ * @param mixed $maturity The security's maturity date.
+ * The maturity date is the date when the security expires.
+ * @param mixed $frequency The number of coupon payments per year.
+ * Valid frequency values are:
+ * 1 Annual
+ * 2 Semi-Annual
+ * 4 Quarterly
+ * @param mixed $basis The type of day count to use (int) .
+ * 0 or omitted US (NASD) 30/360
+ * 1 Actual/actual
+ * 2 Actual/360
+ * 3 Actual/365
+ * 4 European 30/360
+ */
+ public static function COUPDAYSNC(
+ mixed $settlement,
+ mixed $maturity,
+ mixed $frequency,
+ mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ ): string|float {
+ $settlement = Functions::flattenSingleValue($settlement);
+ $maturity = Functions::flattenSingleValue($maturity);
+ $frequency = Functions::flattenSingleValue($frequency);
+ $basis = ($basis === null)
+ ? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ : Functions::flattenSingleValue($basis);
+
+ try {
+ $settlement = FinancialValidations::validateSettlementDate($settlement);
+ $maturity = FinancialValidations::validateMaturityDate($maturity);
+ self::validateCouponPeriod($settlement, $maturity);
+ $frequency = FinancialValidations::validateFrequency($frequency);
+ $basis = FinancialValidations::validateBasis($basis);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ /** @var int $daysPerYear */
+ $daysPerYear = Helpers::daysPerYear(Functions::Scalar(DateTimeExcel\DateParts::year($settlement)), $basis);
+ $next = self::couponFirstPeriodDate($settlement, $maturity, $frequency, self::PERIOD_DATE_NEXT);
+
+ if ($basis === FinancialConstants::BASIS_DAYS_PER_YEAR_NASD) {
+ $settlementDate = Date::excelToDateTimeObject($settlement);
+ $settlementEoM = Helpers::isLastDayOfMonth($settlementDate);
+ if ($settlementEoM) {
+ ++$settlement;
+ }
+ }
+
+ return (float) DateTimeExcel\YearFrac::fraction($settlement, $next, $basis) * $daysPerYear;
+ }
+
+ /**
+ * COUPNCD.
+ *
+ * Returns the next coupon date after the settlement date.
+ *
+ * Excel Function:
+ * COUPNCD(settlement,maturity,frequency[,basis])
+ *
+ * @param mixed $settlement The security's settlement date.
+ * The security settlement date is the date after the issue
+ * date when the security is traded to the buyer.
+ * @param mixed $maturity The security's maturity date.
+ * The maturity date is the date when the security expires.
+ * @param mixed $frequency The number of coupon payments per year.
+ * Valid frequency values are:
+ * 1 Annual
+ * 2 Semi-Annual
+ * 4 Quarterly
+ * @param mixed $basis The type of day count to use (int).
+ * 0 or omitted US (NASD) 30/360
+ * 1 Actual/actual
+ * 2 Actual/360
+ * 3 Actual/365
+ * 4 European 30/360
+ *
+ * @return float|string Excel date/time serial value or error message
+ */
+ public static function COUPNCD(
+ mixed $settlement,
+ mixed $maturity,
+ mixed $frequency,
+ mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ ): string|float {
+ $settlement = Functions::flattenSingleValue($settlement);
+ $maturity = Functions::flattenSingleValue($maturity);
+ $frequency = Functions::flattenSingleValue($frequency);
+ $basis = ($basis === null)
+ ? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ : Functions::flattenSingleValue($basis);
+
+ try {
+ $settlement = FinancialValidations::validateSettlementDate($settlement);
+ $maturity = FinancialValidations::validateMaturityDate($maturity);
+ self::validateCouponPeriod($settlement, $maturity);
+ $frequency = FinancialValidations::validateFrequency($frequency);
+ FinancialValidations::validateBasis($basis);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return self::couponFirstPeriodDate($settlement, $maturity, $frequency, self::PERIOD_DATE_NEXT);
+ }
+
+ /**
+ * COUPNUM.
+ *
+ * Returns the number of coupons payable between the settlement date and maturity date,
+ * rounded up to the nearest whole coupon.
+ *
+ * Excel Function:
+ * COUPNUM(settlement,maturity,frequency[,basis])
+ *
+ * @param mixed $settlement The security's settlement date.
+ * The security settlement date is the date after the issue
+ * date when the security is traded to the buyer.
+ * @param mixed $maturity The security's maturity date.
+ * The maturity date is the date when the security expires.
+ * @param mixed $frequency The number of coupon payments per year.
+ * Valid frequency values are:
+ * 1 Annual
+ * 2 Semi-Annual
+ * 4 Quarterly
+ * @param mixed $basis The type of day count to use (int).
+ * 0 or omitted US (NASD) 30/360
+ * 1 Actual/actual
+ * 2 Actual/360
+ * 3 Actual/365
+ * 4 European 30/360
+ */
+ public static function COUPNUM(
+ mixed $settlement,
+ mixed $maturity,
+ mixed $frequency,
+ mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ ): string|int {
+ $settlement = Functions::flattenSingleValue($settlement);
+ $maturity = Functions::flattenSingleValue($maturity);
+ $frequency = Functions::flattenSingleValue($frequency);
+ $basis = ($basis === null)
+ ? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ : Functions::flattenSingleValue($basis);
+
+ try {
+ $settlement = FinancialValidations::validateSettlementDate($settlement);
+ $maturity = FinancialValidations::validateMaturityDate($maturity);
+ self::validateCouponPeriod($settlement, $maturity);
+ $frequency = FinancialValidations::validateFrequency($frequency);
+ FinancialValidations::validateBasis($basis);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $yearsBetweenSettlementAndMaturity = DateTimeExcel\YearFrac::fraction(
+ $settlement,
+ $maturity,
+ FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ );
+
+ return (int) ceil((float) $yearsBetweenSettlementAndMaturity * $frequency);
+ }
+
+ /**
+ * COUPPCD.
+ *
+ * Returns the previous coupon date before the settlement date.
+ *
+ * Excel Function:
+ * COUPPCD(settlement,maturity,frequency[,basis])
+ *
+ * @param mixed $settlement The security's settlement date.
+ * The security settlement date is the date after the issue
+ * date when the security is traded to the buyer.
+ * @param mixed $maturity The security's maturity date.
+ * The maturity date is the date when the security expires.
+ * @param mixed $frequency The number of coupon payments per year.
+ * Valid frequency values are:
+ * 1 Annual
+ * 2 Semi-Annual
+ * 4 Quarterly
+ * @param mixed $basis The type of day count to use (int).
+ * 0 or omitted US (NASD) 30/360
+ * 1 Actual/actual
+ * 2 Actual/360
+ * 3 Actual/365
+ * 4 European 30/360
+ *
+ * @return float|string Excel date/time serial value or error message
+ */
+ public static function COUPPCD(
+ mixed $settlement,
+ mixed $maturity,
+ mixed $frequency,
+ mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ ): string|float {
+ $settlement = Functions::flattenSingleValue($settlement);
+ $maturity = Functions::flattenSingleValue($maturity);
+ $frequency = Functions::flattenSingleValue($frequency);
+ $basis = ($basis === null)
+ ? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ : Functions::flattenSingleValue($basis);
+
+ try {
+ $settlement = FinancialValidations::validateSettlementDate($settlement);
+ $maturity = FinancialValidations::validateMaturityDate($maturity);
+ self::validateCouponPeriod($settlement, $maturity);
+ $frequency = FinancialValidations::validateFrequency($frequency);
+ FinancialValidations::validateBasis($basis);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return self::couponFirstPeriodDate($settlement, $maturity, $frequency, self::PERIOD_DATE_PREVIOUS);
+ }
+
+ private static function monthsDiff(DateTime $result, int $months, string $plusOrMinus, int $day, bool $lastDayFlag): void
+ {
+ $result->setDate((int) $result->format('Y'), (int) $result->format('m'), 1);
+ $result->modify("$plusOrMinus $months months");
+ $daysInMonth = (int) $result->format('t');
+ $result->setDate((int) $result->format('Y'), (int) $result->format('m'), $lastDayFlag ? $daysInMonth : min($day, $daysInMonth));
+ }
+
+ private static function couponFirstPeriodDate(float $settlement, float $maturity, int $frequency, bool $next): float
+ {
+ $months = 12 / $frequency;
+
+ $result = Date::excelToDateTimeObject($maturity);
+ $day = (int) $result->format('d');
+ $lastDayFlag = Helpers::isLastDayOfMonth($result);
+
+ while ($settlement < Date::PHPToExcel($result)) {
+ self::monthsDiff($result, $months, '-', $day, $lastDayFlag);
+ }
+ if ($next === true) {
+ self::monthsDiff($result, $months, '+', $day, $lastDayFlag);
+ }
+
+ return (float) Date::PHPToExcel($result);
+ }
+
+ private static function validateCouponPeriod(float $settlement, float $maturity): void
+ {
+ if ($settlement >= $maturity) {
+ throw new Exception(ExcelError::NAN());
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Depreciation.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Depreciation.php
new file mode 100644
index 00000000..6ef18999
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Depreciation.php
@@ -0,0 +1,265 @@
+getMessage();
+ }
+
+ if ($cost === self::$zeroPointZero) {
+ return 0.0;
+ }
+
+ // Set Fixed Depreciation Rate
+ $fixedDepreciationRate = 1 - ($salvage / $cost) ** (1 / $life);
+ $fixedDepreciationRate = round($fixedDepreciationRate, 3);
+
+ // Loop through each period calculating the depreciation
+ // TODO Handle period value between 0 and 1 (e.g. 0.5)
+ $previousDepreciation = 0;
+ $depreciation = 0;
+ for ($per = 1; $per <= $period; ++$per) {
+ if ($per == 1) {
+ $depreciation = $cost * $fixedDepreciationRate * $month / 12;
+ } elseif ($per == ($life + 1)) {
+ $depreciation = ($cost - $previousDepreciation) * $fixedDepreciationRate * (12 - $month) / 12;
+ } else {
+ $depreciation = ($cost - $previousDepreciation) * $fixedDepreciationRate;
+ }
+ $previousDepreciation += $depreciation;
+ }
+
+ return $depreciation;
+ }
+
+ /**
+ * DDB.
+ *
+ * Returns the depreciation of an asset for a specified period using the
+ * double-declining balance method or some other method you specify.
+ *
+ * Excel Function:
+ * DDB(cost,salvage,life,period[,factor])
+ *
+ * @param mixed $cost Initial cost of the asset
+ * @param mixed $salvage Value at the end of the depreciation.
+ * (Sometimes called the salvage value of the asset)
+ * @param mixed $life Number of periods over which the asset is depreciated.
+ * (Sometimes called the useful life of the asset)
+ * @param mixed $period The period for which you want to calculate the
+ * depreciation. Period must use the same units as life.
+ * @param mixed $factor The rate at which the balance declines.
+ * If factor is omitted, it is assumed to be 2 (the
+ * double-declining balance method).
+ */
+ public static function DDB(mixed $cost, mixed $salvage, mixed $life, mixed $period, mixed $factor = 2.0): float|string
+ {
+ $cost = Functions::flattenSingleValue($cost);
+ $salvage = Functions::flattenSingleValue($salvage);
+ $life = Functions::flattenSingleValue($life);
+ $period = Functions::flattenSingleValue($period);
+ $factor = Functions::flattenSingleValue($factor);
+
+ try {
+ $cost = self::validateCost($cost);
+ $salvage = self::validateSalvage($salvage);
+ $life = self::validateLife($life);
+ $period = self::validatePeriod($period);
+ $factor = self::validateFactor($factor);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($period > $life) {
+ return ExcelError::NAN();
+ }
+
+ // Loop through each period calculating the depreciation
+ // TODO Handling for fractional $period values
+ $previousDepreciation = 0;
+ $depreciation = 0;
+ for ($per = 1; $per <= $period; ++$per) {
+ $depreciation = min(
+ ($cost - $previousDepreciation) * ($factor / $life),
+ ($cost - $salvage - $previousDepreciation)
+ );
+ $previousDepreciation += $depreciation;
+ }
+
+ return $depreciation;
+ }
+
+ /**
+ * SLN.
+ *
+ * Returns the straight-line depreciation of an asset for one period
+ *
+ * @param mixed $cost Initial cost of the asset
+ * @param mixed $salvage Value at the end of the depreciation
+ * @param mixed $life Number of periods over which the asset is depreciated
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function SLN(mixed $cost, mixed $salvage, mixed $life): string|float
+ {
+ $cost = Functions::flattenSingleValue($cost);
+ $salvage = Functions::flattenSingleValue($salvage);
+ $life = Functions::flattenSingleValue($life);
+
+ try {
+ $cost = self::validateCost($cost, true);
+ $salvage = self::validateSalvage($salvage, true);
+ $life = self::validateLife($life, true);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($life === self::$zeroPointZero) {
+ return ExcelError::DIV0();
+ }
+
+ return ($cost - $salvage) / $life;
+ }
+
+ /**
+ * SYD.
+ *
+ * Returns the sum-of-years' digits depreciation of an asset for a specified period.
+ *
+ * @param mixed $cost Initial cost of the asset
+ * @param mixed $salvage Value at the end of the depreciation
+ * @param mixed $life Number of periods over which the asset is depreciated
+ * @param mixed $period Period
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function SYD(mixed $cost, mixed $salvage, mixed $life, mixed $period): string|float
+ {
+ $cost = Functions::flattenSingleValue($cost);
+ $salvage = Functions::flattenSingleValue($salvage);
+ $life = Functions::flattenSingleValue($life);
+ $period = Functions::flattenSingleValue($period);
+
+ try {
+ $cost = self::validateCost($cost, true);
+ $salvage = self::validateSalvage($salvage);
+ $life = self::validateLife($life);
+ $period = self::validatePeriod($period);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($period > $life) {
+ return ExcelError::NAN();
+ }
+
+ $syd = (($cost - $salvage) * ($life - $period + 1) * 2) / ($life * ($life + 1));
+
+ return $syd;
+ }
+
+ private static function validateCost(mixed $cost, bool $negativeValueAllowed = false): float
+ {
+ $cost = FinancialValidations::validateFloat($cost);
+ if ($cost < 0.0 && $negativeValueAllowed === false) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $cost;
+ }
+
+ private static function validateSalvage(mixed $salvage, bool $negativeValueAllowed = false): float
+ {
+ $salvage = FinancialValidations::validateFloat($salvage);
+ if ($salvage < 0.0 && $negativeValueAllowed === false) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $salvage;
+ }
+
+ private static function validateLife(mixed $life, bool $negativeValueAllowed = false): float
+ {
+ $life = FinancialValidations::validateFloat($life);
+ if ($life < 0.0 && $negativeValueAllowed === false) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $life;
+ }
+
+ private static function validatePeriod(mixed $period, bool $negativeValueAllowed = false): float
+ {
+ $period = FinancialValidations::validateFloat($period);
+ if ($period <= 0.0 && $negativeValueAllowed === false) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $period;
+ }
+
+ private static function validateMonth(mixed $month): int
+ {
+ $month = FinancialValidations::validateInt($month);
+ if ($month < 1) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $month;
+ }
+
+ private static function validateFactor(mixed $factor): float
+ {
+ $factor = FinancialValidations::validateFloat($factor);
+ if ($factor <= 0.0) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $factor;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Dollar.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Dollar.php
new file mode 100644
index 00000000..b0581f66
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Dollar.php
@@ -0,0 +1,127 @@
+getMessage();
+ }
+
+ // Additional parameter validations
+ if ($fraction < 0) {
+ return ExcelError::NAN();
+ }
+ if ($fraction == 0) {
+ return ExcelError::DIV0();
+ }
+
+ $dollars = ($fractionalDollar < 0) ? ceil($fractionalDollar) : floor($fractionalDollar);
+ $cents = fmod($fractionalDollar, 1.0);
+ $cents /= $fraction;
+ $cents *= 10 ** ceil(log10($fraction));
+
+ return $dollars + $cents;
+ }
+
+ /**
+ * DOLLARFR.
+ *
+ * Converts a dollar price expressed as a decimal number into a dollar price
+ * expressed as a fraction.
+ * Fractional dollar numbers are sometimes used for security prices.
+ *
+ * Excel Function:
+ * DOLLARFR(decimal_dollar,fraction)
+ *
+ * @param mixed $decimalDollar Decimal Dollar
+ * Or can be an array of values
+ * @param mixed $fraction Fraction
+ * Or can be an array of values
+ */
+ public static function fractional(mixed $decimalDollar = null, mixed $fraction = 0): array|string|float
+ {
+ if (is_array($decimalDollar) || is_array($fraction)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $decimalDollar, $fraction);
+ }
+
+ try {
+ $decimalDollar = FinancialValidations::validateFloat(
+ Functions::flattenSingleValue($decimalDollar) ?? 0.0
+ );
+ $fraction = FinancialValidations::validateInt(Functions::flattenSingleValue($fraction));
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Additional parameter validations
+ if ($fraction < 0) {
+ return ExcelError::NAN();
+ }
+ if ($fraction == 0) {
+ return ExcelError::DIV0();
+ }
+
+ $dollars = ($decimalDollar < 0.0) ? ceil($decimalDollar) : floor($decimalDollar);
+ $cents = fmod($decimalDollar, 1);
+ $cents *= $fraction;
+ $cents *= 10 ** (-ceil(log10($fraction)));
+
+ return $dollars + $cents;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/FinancialValidations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/FinancialValidations.php
new file mode 100644
index 00000000..e596fc30
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/FinancialValidations.php
@@ -0,0 +1,122 @@
+ 4)) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $basis;
+ }
+
+ public static function validatePrice(mixed $price): float
+ {
+ $price = self::validateFloat($price);
+ if ($price < 0.0) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $price;
+ }
+
+ public static function validateParValue(mixed $parValue): float
+ {
+ $parValue = self::validateFloat($parValue);
+ if ($parValue < 0.0) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $parValue;
+ }
+
+ public static function validateYield(mixed $yield): float
+ {
+ $yield = self::validateFloat($yield);
+ if ($yield < 0.0) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $yield;
+ }
+
+ public static function validateDiscount(mixed $discount): float
+ {
+ $discount = self::validateFloat($discount);
+ if ($discount <= 0.0) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $discount;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Helpers.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Helpers.php
new file mode 100644
index 00000000..aa287129
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Helpers.php
@@ -0,0 +1,58 @@
+format('d') === $date->format('t');
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/InterestRate.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/InterestRate.php
new file mode 100644
index 00000000..2916df6b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/InterestRate.php
@@ -0,0 +1,71 @@
+getMessage();
+ }
+
+ if ($nominalRate <= 0 || $periodsPerYear < 1) {
+ return ExcelError::NAN();
+ }
+
+ return ((1 + $nominalRate / $periodsPerYear) ** $periodsPerYear) - 1;
+ }
+
+ /**
+ * NOMINAL.
+ *
+ * Returns the nominal interest rate given the effective rate and the number of compounding payments per year.
+ *
+ * @param mixed $effectiveRate Effective interest rate as a float
+ * @param mixed $periodsPerYear Integer number of compounding payments per year
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function nominal(mixed $effectiveRate = 0, mixed $periodsPerYear = 0): string|float
+ {
+ $effectiveRate = Functions::flattenSingleValue($effectiveRate);
+ $periodsPerYear = Functions::flattenSingleValue($periodsPerYear);
+
+ try {
+ $effectiveRate = FinancialValidations::validateFloat($effectiveRate);
+ $periodsPerYear = FinancialValidations::validateInt($periodsPerYear);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($effectiveRate <= 0 || $periodsPerYear < 1) {
+ return ExcelError::NAN();
+ }
+
+ // Calculate
+ return $periodsPerYear * (($effectiveRate + 1) ** (1 / $periodsPerYear) - 1);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/AccruedInterest.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/AccruedInterest.php
new file mode 100644
index 00000000..eb57abfc
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/AccruedInterest.php
@@ -0,0 +1,151 @@
+getMessage();
+ }
+
+ $daysBetweenIssueAndSettlement = Functions::scalar(YearFrac::fraction($issue, $settlement, $basis));
+ if (!is_numeric($daysBetweenIssueAndSettlement)) {
+ // return date error
+ return $daysBetweenIssueAndSettlement;
+ }
+ $daysBetweenFirstInterestAndSettlement = Functions::scalar(YearFrac::fraction($firstInterest, $settlement, $basis));
+ if (!is_numeric($daysBetweenFirstInterestAndSettlement)) {
+ // return date error
+ return $daysBetweenFirstInterestAndSettlement;
+ }
+
+ return $parValue * $rate * $daysBetweenIssueAndSettlement;
+ }
+
+ /**
+ * ACCRINTM.
+ *
+ * Returns the accrued interest for a security that pays interest at maturity.
+ *
+ * Excel Function:
+ * ACCRINTM(issue,settlement,rate[,par[,basis]])
+ *
+ * @param mixed $issue The security's issue date
+ * @param mixed $settlement The security's settlement (or maturity) date
+ * @param mixed $rate The security's annual coupon rate
+ * @param mixed $parValue The security's par value.
+ * If you omit parValue, ACCRINT uses $1,000.
+ * @param mixed $basis The type of day count to use.
+ * 0 or omitted US (NASD) 30/360
+ * 1 Actual/actual
+ * 2 Actual/360
+ * 3 Actual/365
+ * 4 European 30/360
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function atMaturity(
+ mixed $issue,
+ mixed $settlement,
+ mixed $rate,
+ mixed $parValue = 1000,
+ mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ ) {
+ $issue = Functions::flattenSingleValue($issue);
+ $settlement = Functions::flattenSingleValue($settlement);
+ $rate = Functions::flattenSingleValue($rate);
+ $parValue = ($parValue === null) ? 1000 : Functions::flattenSingleValue($parValue);
+ $basis = ($basis === null)
+ ? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ : Functions::flattenSingleValue($basis);
+
+ try {
+ $issue = SecurityValidations::validateIssueDate($issue);
+ $settlement = SecurityValidations::validateSettlementDate($settlement);
+ SecurityValidations::validateSecurityPeriod($issue, $settlement);
+ $rate = SecurityValidations::validateRate($rate);
+ $parValue = SecurityValidations::validateParValue($parValue);
+ $basis = SecurityValidations::validateBasis($basis);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $daysBetweenIssueAndSettlement = Functions::scalar(YearFrac::fraction($issue, $settlement, $basis));
+ if (!is_numeric($daysBetweenIssueAndSettlement)) {
+ // return date error
+ return $daysBetweenIssueAndSettlement;
+ }
+
+ return $parValue * $rate * $daysBetweenIssueAndSettlement;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Price.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Price.php
new file mode 100644
index 00000000..b07b2c9f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Price.php
@@ -0,0 +1,283 @@
+getMessage();
+ }
+
+ $dsc = (float) Coupons::COUPDAYSNC($settlement, $maturity, $frequency, $basis);
+ $e = (float) Coupons::COUPDAYS($settlement, $maturity, $frequency, $basis);
+ $n = (int) Coupons::COUPNUM($settlement, $maturity, $frequency, $basis);
+ $a = (float) Coupons::COUPDAYBS($settlement, $maturity, $frequency, $basis);
+
+ $baseYF = 1.0 + ($yield / $frequency);
+ $rfp = 100 * ($rate / $frequency);
+ $de = $dsc / $e;
+
+ $result = $redemption / $baseYF ** (--$n + $de);
+ for ($k = 0; $k <= $n; ++$k) {
+ $result += $rfp / ($baseYF ** ($k + $de));
+ }
+ $result -= $rfp * ($a / $e);
+
+ return $result;
+ }
+
+ /**
+ * PRICEDISC.
+ *
+ * Returns the price per $100 face value of a discounted security.
+ *
+ * @param mixed $settlement The security's settlement date.
+ * The security settlement date is the date after the issue date when the security
+ * is traded to the buyer.
+ * @param mixed $maturity The security's maturity date.
+ * The maturity date is the date when the security expires.
+ * @param mixed $discount The security's discount rate
+ * @param mixed $redemption The security's redemption value per $100 face value
+ * @param mixed $basis The type of day count to use.
+ * 0 or omitted US (NASD) 30/360
+ * 1 Actual/actual
+ * 2 Actual/360
+ * 3 Actual/365
+ * 4 European 30/360
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function priceDiscounted(
+ mixed $settlement,
+ mixed $maturity,
+ mixed $discount,
+ mixed $redemption,
+ mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ ) {
+ $settlement = Functions::flattenSingleValue($settlement);
+ $maturity = Functions::flattenSingleValue($maturity);
+ $discount = Functions::flattenSingleValue($discount);
+ $redemption = Functions::flattenSingleValue($redemption);
+ $basis = ($basis === null)
+ ? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ : Functions::flattenSingleValue($basis);
+
+ try {
+ $settlement = SecurityValidations::validateSettlementDate($settlement);
+ $maturity = SecurityValidations::validateMaturityDate($maturity);
+ SecurityValidations::validateSecurityPeriod($settlement, $maturity);
+ $discount = SecurityValidations::validateDiscount($discount);
+ $redemption = SecurityValidations::validateRedemption($redemption);
+ $basis = SecurityValidations::validateBasis($basis);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $daysBetweenSettlementAndMaturity = Functions::scalar(DateTimeExcel\YearFrac::fraction($settlement, $maturity, $basis));
+ if (!is_numeric($daysBetweenSettlementAndMaturity)) {
+ // return date error
+ return $daysBetweenSettlementAndMaturity;
+ }
+
+ return $redemption * (1 - $discount * $daysBetweenSettlementAndMaturity);
+ }
+
+ /**
+ * PRICEMAT.
+ *
+ * Returns the price per $100 face value of a security that pays interest at maturity.
+ *
+ * @param mixed $settlement The security's settlement date.
+ * The security's settlement date is the date after the issue date when the
+ * security is traded to the buyer.
+ * @param mixed $maturity The security's maturity date.
+ * The maturity date is the date when the security expires.
+ * @param mixed $issue The security's issue date
+ * @param mixed $rate The security's interest rate at date of issue
+ * @param mixed $yield The security's annual yield
+ * @param mixed $basis The type of day count to use.
+ * 0 or omitted US (NASD) 30/360
+ * 1 Actual/actual
+ * 2 Actual/360
+ * 3 Actual/365
+ * 4 European 30/360
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function priceAtMaturity(
+ mixed $settlement,
+ mixed $maturity,
+ mixed $issue,
+ mixed $rate,
+ mixed $yield,
+ mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ ) {
+ $settlement = Functions::flattenSingleValue($settlement);
+ $maturity = Functions::flattenSingleValue($maturity);
+ $issue = Functions::flattenSingleValue($issue);
+ $rate = Functions::flattenSingleValue($rate);
+ $yield = Functions::flattenSingleValue($yield);
+ $basis = ($basis === null)
+ ? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ : Functions::flattenSingleValue($basis);
+
+ try {
+ $settlement = SecurityValidations::validateSettlementDate($settlement);
+ $maturity = SecurityValidations::validateMaturityDate($maturity);
+ SecurityValidations::validateSecurityPeriod($settlement, $maturity);
+ $issue = SecurityValidations::validateIssueDate($issue);
+ $rate = SecurityValidations::validateRate($rate);
+ $yield = SecurityValidations::validateYield($yield);
+ $basis = SecurityValidations::validateBasis($basis);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $daysPerYear = Helpers::daysPerYear(Functions::scalar(DateTimeExcel\DateParts::year($settlement)), $basis);
+ if (!is_numeric($daysPerYear)) {
+ return $daysPerYear;
+ }
+ $daysBetweenIssueAndSettlement = Functions::scalar(DateTimeExcel\YearFrac::fraction($issue, $settlement, $basis));
+ if (!is_numeric($daysBetweenIssueAndSettlement)) {
+ // return date error
+ return $daysBetweenIssueAndSettlement;
+ }
+ $daysBetweenIssueAndSettlement *= $daysPerYear;
+ $daysBetweenIssueAndMaturity = Functions::scalar(DateTimeExcel\YearFrac::fraction($issue, $maturity, $basis));
+ if (!is_numeric($daysBetweenIssueAndMaturity)) {
+ // return date error
+ return $daysBetweenIssueAndMaturity;
+ }
+ $daysBetweenIssueAndMaturity *= $daysPerYear;
+ $daysBetweenSettlementAndMaturity = Functions::scalar(DateTimeExcel\YearFrac::fraction($settlement, $maturity, $basis));
+ if (!is_numeric($daysBetweenSettlementAndMaturity)) {
+ // return date error
+ return $daysBetweenSettlementAndMaturity;
+ }
+ $daysBetweenSettlementAndMaturity *= $daysPerYear;
+
+ return (100 + (($daysBetweenIssueAndMaturity / $daysPerYear) * $rate * 100))
+ / (1 + (($daysBetweenSettlementAndMaturity / $daysPerYear) * $yield))
+ - (($daysBetweenIssueAndSettlement / $daysPerYear) * $rate * 100);
+ }
+
+ /**
+ * RECEIVED.
+ *
+ * Returns the amount received at maturity for a fully invested Security.
+ *
+ * @param mixed $settlement The security's settlement date.
+ * The security settlement date is the date after the issue date when the security
+ * is traded to the buyer.
+ * @param mixed $maturity The security's maturity date.
+ * The maturity date is the date when the security expires.
+ * @param mixed $investment The amount invested in the security
+ * @param mixed $discount The security's discount rate
+ * @param mixed $basis The type of day count to use.
+ * 0 or omitted US (NASD) 30/360
+ * 1 Actual/actual
+ * 2 Actual/360
+ * 3 Actual/365
+ * 4 European 30/360
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function received(
+ mixed $settlement,
+ mixed $maturity,
+ mixed $investment,
+ mixed $discount,
+ mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ ) {
+ $settlement = Functions::flattenSingleValue($settlement);
+ $maturity = Functions::flattenSingleValue($maturity);
+ $investment = Functions::flattenSingleValue($investment);
+ $discount = Functions::flattenSingleValue($discount);
+ $basis = ($basis === null)
+ ? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ : Functions::flattenSingleValue($basis);
+
+ try {
+ $settlement = SecurityValidations::validateSettlementDate($settlement);
+ $maturity = SecurityValidations::validateMaturityDate($maturity);
+ SecurityValidations::validateSecurityPeriod($settlement, $maturity);
+ $investment = SecurityValidations::validateFloat($investment);
+ $discount = SecurityValidations::validateDiscount($discount);
+ $basis = SecurityValidations::validateBasis($basis);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($investment <= 0) {
+ return ExcelError::NAN();
+ }
+ $daysBetweenSettlementAndMaturity = DateTimeExcel\YearFrac::fraction($settlement, $maturity, $basis);
+ if (!is_numeric($daysBetweenSettlementAndMaturity)) {
+ // return date error
+ return Functions::scalar($daysBetweenSettlementAndMaturity);
+ }
+
+ return $investment / (1 - ($discount * $daysBetweenSettlementAndMaturity));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Rates.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Rates.php
new file mode 100644
index 00000000..2989a29b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Rates.php
@@ -0,0 +1,134 @@
+getMessage();
+ }
+
+ if ($price <= 0.0) {
+ return ExcelError::NAN();
+ }
+
+ $daysBetweenSettlementAndMaturity = Functions::scalar(DateTimeExcel\YearFrac::fraction($settlement, $maturity, $basis));
+ if (!is_numeric($daysBetweenSettlementAndMaturity)) {
+ // return date error
+ return $daysBetweenSettlementAndMaturity;
+ }
+
+ return (1 - $price / $redemption) / $daysBetweenSettlementAndMaturity;
+ }
+
+ /**
+ * INTRATE.
+ *
+ * Returns the interest rate for a fully invested security.
+ *
+ * Excel Function:
+ * INTRATE(settlement,maturity,investment,redemption[,basis])
+ *
+ * @param mixed $settlement The security's settlement date.
+ * The security settlement date is the date after the issue date when the security
+ * is traded to the buyer.
+ * @param mixed $maturity The security's maturity date.
+ * The maturity date is the date when the security expires.
+ * @param mixed $investment the amount invested in the security
+ * @param mixed $redemption the amount to be received at maturity
+ * @param mixed $basis The type of day count to use.
+ * 0 or omitted US (NASD) 30/360
+ * 1 Actual/actual
+ * 2 Actual/360
+ * 3 Actual/365
+ * 4 European 30/360
+ */
+ public static function interest(
+ mixed $settlement,
+ mixed $maturity,
+ mixed $investment,
+ mixed $redemption,
+ mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ ): float|string {
+ $settlement = Functions::flattenSingleValue($settlement);
+ $maturity = Functions::flattenSingleValue($maturity);
+ $investment = Functions::flattenSingleValue($investment);
+ $redemption = Functions::flattenSingleValue($redemption);
+ $basis = ($basis === null)
+ ? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ : Functions::flattenSingleValue($basis);
+
+ try {
+ $settlement = SecurityValidations::validateSettlementDate($settlement);
+ $maturity = SecurityValidations::validateMaturityDate($maturity);
+ SecurityValidations::validateSecurityPeriod($settlement, $maturity);
+ $investment = SecurityValidations::validateFloat($investment);
+ $redemption = SecurityValidations::validateRedemption($redemption);
+ $basis = SecurityValidations::validateBasis($basis);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($investment <= 0) {
+ return ExcelError::NAN();
+ }
+
+ $daysBetweenSettlementAndMaturity = Functions::scalar(DateTimeExcel\YearFrac::fraction($settlement, $maturity, $basis));
+ if (!is_numeric($daysBetweenSettlementAndMaturity)) {
+ // return date error
+ return $daysBetweenSettlementAndMaturity;
+ }
+
+ return (($redemption / $investment) - 1) / ($daysBetweenSettlementAndMaturity);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/SecurityValidations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/SecurityValidations.php
new file mode 100644
index 00000000..a0804cb8
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/SecurityValidations.php
@@ -0,0 +1,32 @@
+= $maturity) {
+ throw new Exception(ExcelError::NAN());
+ }
+ }
+
+ public static function validateRedemption(mixed $redemption): float
+ {
+ $redemption = self::validateFloat($redemption);
+ if ($redemption <= 0.0) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $redemption;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Yields.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Yields.php
new file mode 100644
index 00000000..a4c5a48f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/Securities/Yields.php
@@ -0,0 +1,153 @@
+getMessage();
+ }
+
+ $daysPerYear = Helpers::daysPerYear(Functions::scalar(DateTimeExcel\DateParts::year($settlement)), $basis);
+ if (!is_numeric($daysPerYear)) {
+ return $daysPerYear;
+ }
+ $daysBetweenSettlementAndMaturity = Functions::scalar(DateTimeExcel\YearFrac::fraction($settlement, $maturity, $basis));
+ if (!is_numeric($daysBetweenSettlementAndMaturity)) {
+ // return date error
+ return $daysBetweenSettlementAndMaturity;
+ }
+ $daysBetweenSettlementAndMaturity *= $daysPerYear;
+
+ return (($redemption - $price) / $price) * ($daysPerYear / $daysBetweenSettlementAndMaturity);
+ }
+
+ /**
+ * YIELDMAT.
+ *
+ * Returns the annual yield of a security that pays interest at maturity.
+ *
+ * @param mixed $settlement The security's settlement date.
+ * The security's settlement date is the date after the issue date when the security
+ * is traded to the buyer.
+ * @param mixed $maturity The security's maturity date.
+ * The maturity date is the date when the security expires.
+ * @param mixed $issue The security's issue date
+ * @param mixed $rate The security's interest rate at date of issue
+ * @param mixed $price The security's price per $100 face value
+ * @param mixed $basis The type of day count to use.
+ * 0 or omitted US (NASD) 30/360
+ * 1 Actual/actual
+ * 2 Actual/360
+ * 3 Actual/365
+ * 4 European 30/360
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function yieldAtMaturity(
+ mixed $settlement,
+ mixed $maturity,
+ mixed $issue,
+ mixed $rate,
+ mixed $price,
+ mixed $basis = FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ ) {
+ $settlement = Functions::flattenSingleValue($settlement);
+ $maturity = Functions::flattenSingleValue($maturity);
+ $issue = Functions::flattenSingleValue($issue);
+ $rate = Functions::flattenSingleValue($rate);
+ $price = Functions::flattenSingleValue($price);
+ $basis = ($basis === null)
+ ? FinancialConstants::BASIS_DAYS_PER_YEAR_NASD
+ : Functions::flattenSingleValue($basis);
+
+ try {
+ $settlement = SecurityValidations::validateSettlementDate($settlement);
+ $maturity = SecurityValidations::validateMaturityDate($maturity);
+ SecurityValidations::validateSecurityPeriod($settlement, $maturity);
+ $issue = SecurityValidations::validateIssueDate($issue);
+ $rate = SecurityValidations::validateRate($rate);
+ $price = SecurityValidations::validatePrice($price);
+ $basis = SecurityValidations::validateBasis($basis);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $daysPerYear = Helpers::daysPerYear(Functions::scalar(DateTimeExcel\DateParts::year($settlement)), $basis);
+ if (!is_numeric($daysPerYear)) {
+ return $daysPerYear;
+ }
+ $daysBetweenIssueAndSettlement = Functions::scalar(DateTimeExcel\YearFrac::fraction($issue, $settlement, $basis));
+ if (!is_numeric($daysBetweenIssueAndSettlement)) {
+ // return date error
+ return $daysBetweenIssueAndSettlement;
+ }
+ $daysBetweenIssueAndSettlement *= $daysPerYear;
+ $daysBetweenIssueAndMaturity = Functions::scalar(DateTimeExcel\YearFrac::fraction($issue, $maturity, $basis));
+ if (!is_numeric($daysBetweenIssueAndMaturity)) {
+ // return date error
+ return $daysBetweenIssueAndMaturity;
+ }
+ $daysBetweenIssueAndMaturity *= $daysPerYear;
+ $daysBetweenSettlementAndMaturity = Functions::scalar(DateTimeExcel\YearFrac::fraction($settlement, $maturity, $basis));
+ if (!is_numeric($daysBetweenSettlementAndMaturity)) {
+ // return date error
+ return $daysBetweenSettlementAndMaturity;
+ }
+ $daysBetweenSettlementAndMaturity *= $daysPerYear;
+
+ return ((1 + (($daysBetweenIssueAndMaturity / $daysPerYear) * $rate)
+ - (($price / 100) + (($daysBetweenIssueAndSettlement / $daysPerYear) * $rate)))
+ / (($price / 100) + (($daysBetweenIssueAndSettlement / $daysPerYear) * $rate)))
+ * ($daysPerYear / $daysBetweenSettlementAndMaturity);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/TreasuryBill.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/TreasuryBill.php
new file mode 100644
index 00000000..699efcc6
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Financial/TreasuryBill.php
@@ -0,0 +1,146 @@
+getMessage();
+ }
+
+ if ($discount <= 0) {
+ return ExcelError::NAN();
+ }
+
+ $daysBetweenSettlementAndMaturity = $maturity - $settlement;
+ $daysPerYear = Helpers::daysPerYear(
+ Functions::scalar(DateTimeExcel\DateParts::year($maturity)),
+ FinancialConstants::BASIS_DAYS_PER_YEAR_ACTUAL
+ );
+
+ if ($daysBetweenSettlementAndMaturity > $daysPerYear || $daysBetweenSettlementAndMaturity < 0) {
+ return ExcelError::NAN();
+ }
+
+ return (365 * $discount) / (360 - $discount * $daysBetweenSettlementAndMaturity);
+ }
+
+ /**
+ * TBILLPRICE.
+ *
+ * Returns the price per $100 face value for a Treasury bill.
+ *
+ * @param mixed $settlement The Treasury bill's settlement date.
+ * The Treasury bill's settlement date is the date after the issue date
+ * when the Treasury bill is traded to the buyer.
+ * @param mixed $maturity The Treasury bill's maturity date.
+ * The maturity date is the date when the Treasury bill expires.
+ * @param mixed $discount The Treasury bill's discount rate
+ *
+ * @return float|string Result, or a string containing an error
+ */
+ public static function price(mixed $settlement, mixed $maturity, mixed $discount): string|float
+ {
+ $settlement = Functions::flattenSingleValue($settlement);
+ $maturity = Functions::flattenSingleValue($maturity);
+ $discount = Functions::flattenSingleValue($discount);
+
+ try {
+ $settlement = FinancialValidations::validateSettlementDate($settlement);
+ $maturity = FinancialValidations::validateMaturityDate($maturity);
+ $discount = FinancialValidations::validateFloat($discount);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($discount <= 0) {
+ return ExcelError::NAN();
+ }
+
+ $daysBetweenSettlementAndMaturity = $maturity - $settlement;
+ $daysPerYear = Helpers::daysPerYear(
+ Functions::scalar(DateTimeExcel\DateParts::year($maturity)),
+ FinancialConstants::BASIS_DAYS_PER_YEAR_ACTUAL
+ );
+
+ if ($daysBetweenSettlementAndMaturity > $daysPerYear || $daysBetweenSettlementAndMaturity < 0) {
+ return ExcelError::NAN();
+ }
+
+ $price = 100 * (1 - (($discount * $daysBetweenSettlementAndMaturity) / 360));
+ if ($price < 0.0) {
+ return ExcelError::NAN();
+ }
+
+ return $price;
+ }
+
+ /**
+ * TBILLYIELD.
+ *
+ * Returns the yield for a Treasury bill.
+ *
+ * @param mixed $settlement The Treasury bill's settlement date.
+ * The Treasury bill's settlement date is the date after the issue date when
+ * the Treasury bill is traded to the buyer.
+ * @param mixed $maturity The Treasury bill's maturity date.
+ * The maturity date is the date when the Treasury bill expires.
+ * @param float|string $price The Treasury bill's price per $100 face value
+ */
+ public static function yield(mixed $settlement, mixed $maturity, $price): string|float
+ {
+ $settlement = Functions::flattenSingleValue($settlement);
+ $maturity = Functions::flattenSingleValue($maturity);
+ $price = Functions::flattenSingleValue($price);
+
+ try {
+ $settlement = FinancialValidations::validateSettlementDate($settlement);
+ $maturity = FinancialValidations::validateMaturityDate($maturity);
+ $price = FinancialValidations::validatePrice($price);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $daysBetweenSettlementAndMaturity = $maturity - $settlement;
+ $daysPerYear = Helpers::daysPerYear(
+ Functions::scalar(DateTimeExcel\DateParts::year($maturity)),
+ FinancialConstants::BASIS_DAYS_PER_YEAR_ACTUAL
+ );
+
+ if ($daysBetweenSettlementAndMaturity > $daysPerYear || $daysBetweenSettlementAndMaturity < 0) {
+ return ExcelError::NAN();
+ }
+
+ return ((100 - $price) / $price) * (360 / $daysBetweenSettlementAndMaturity);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/FormulaParser.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/FormulaParser.php
new file mode 100644
index 00000000..9868b828
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/FormulaParser.php
@@ -0,0 +1,616 @@
+<';
+ const OPERATORS_POSTFIX = '%';
+
+ /**
+ * Formula.
+ */
+ private string $formula;
+
+ /**
+ * Tokens.
+ *
+ * @var FormulaToken[]
+ */
+ private array $tokens = [];
+
+ /**
+ * Create a new FormulaParser.
+ *
+ * @param ?string $formula Formula to parse
+ */
+ public function __construct(?string $formula = '')
+ {
+ // Check parameters
+ if ($formula === null) {
+ throw new Exception('Invalid parameter passed: formula');
+ }
+
+ // Initialise values
+ $this->formula = trim($formula);
+ // Parse!
+ $this->parseToTokens();
+ }
+
+ /**
+ * Get Formula.
+ */
+ public function getFormula(): string
+ {
+ return $this->formula;
+ }
+
+ /**
+ * Get Token.
+ *
+ * @param int $id Token id
+ */
+ public function getToken(int $id = 0): FormulaToken
+ {
+ if (isset($this->tokens[$id])) {
+ return $this->tokens[$id];
+ }
+
+ throw new Exception("Token with id $id does not exist.");
+ }
+
+ /**
+ * Get Token count.
+ */
+ public function getTokenCount(): int
+ {
+ return count($this->tokens);
+ }
+
+ /**
+ * Get Tokens.
+ *
+ * @return FormulaToken[]
+ */
+ public function getTokens(): array
+ {
+ return $this->tokens;
+ }
+
+ /**
+ * Parse to tokens.
+ */
+ private function parseToTokens(): void
+ {
+ // No attempt is made to verify formulas; assumes formulas are derived from Excel, where
+ // they can only exist if valid; stack overflows/underflows sunk as nulls without exceptions.
+
+ // Check if the formula has a valid starting =
+ $formulaLength = strlen($this->formula);
+ if ($formulaLength < 2 || $this->formula[0] != '=') {
+ return;
+ }
+
+ // Helper variables
+ $tokens1 = $tokens2 = $stack = [];
+ $inString = $inPath = $inRange = $inError = false;
+ $nextToken = null;
+ //$token = $previousToken = null;
+
+ $index = 1;
+ $value = '';
+
+ $ERRORS = ['#NULL!', '#DIV/0!', '#VALUE!', '#REF!', '#NAME?', '#NUM!', '#N/A'];
+ $COMPARATORS_MULTI = ['>=', '<=', '<>'];
+
+ while ($index < $formulaLength) {
+ // state-dependent character evaluation (order is important)
+
+ // double-quoted strings
+ // embeds are doubled
+ // end marks token
+ if ($inString) {
+ if ($this->formula[$index] == self::QUOTE_DOUBLE) {
+ if ((($index + 2) <= $formulaLength) && ($this->formula[$index + 1] == self::QUOTE_DOUBLE)) {
+ $value .= self::QUOTE_DOUBLE;
+ ++$index;
+ } else {
+ $inString = false;
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_OPERAND, FormulaToken::TOKEN_SUBTYPE_TEXT);
+ $value = '';
+ }
+ } else {
+ $value .= $this->formula[$index];
+ }
+ ++$index;
+
+ continue;
+ }
+
+ // single-quoted strings (links)
+ // embeds are double
+ // end does not mark a token
+ if ($inPath) {
+ if ($this->formula[$index] == self::QUOTE_SINGLE) {
+ if ((($index + 2) <= $formulaLength) && ($this->formula[$index + 1] == self::QUOTE_SINGLE)) {
+ $value .= self::QUOTE_SINGLE;
+ ++$index;
+ } else {
+ $inPath = false;
+ }
+ } else {
+ $value .= $this->formula[$index];
+ }
+ ++$index;
+
+ continue;
+ }
+
+ // bracked strings (R1C1 range index or linked workbook name)
+ // no embeds (changed to "()" by Excel)
+ // end does not mark a token
+ if ($inRange) {
+ if ($this->formula[$index] == self::BRACKET_CLOSE) {
+ $inRange = false;
+ }
+ $value .= $this->formula[$index];
+ ++$index;
+
+ continue;
+ }
+
+ // error values
+ // end marks a token, determined from absolute list of values
+ if ($inError) {
+ $value .= $this->formula[$index];
+ ++$index;
+ if (in_array($value, $ERRORS)) {
+ $inError = false;
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_OPERAND, FormulaToken::TOKEN_SUBTYPE_ERROR);
+ $value = '';
+ }
+
+ continue;
+ }
+
+ // scientific notation check
+ if (str_contains(self::OPERATORS_SN, $this->formula[$index])) {
+ if (strlen($value) > 1) {
+ if (preg_match('/^[1-9]{1}(\\.\\d+)?E{1}$/', $this->formula[$index]) != 0) {
+ $value .= $this->formula[$index];
+ ++$index;
+
+ continue;
+ }
+ }
+ }
+
+ // independent character evaluation (order not important)
+
+ // establish state-dependent character evaluations
+ if ($this->formula[$index] == self::QUOTE_DOUBLE) {
+ if ($value !== '') {
+ // unexpected
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_UNKNOWN);
+ $value = '';
+ }
+ $inString = true;
+ ++$index;
+
+ continue;
+ }
+
+ if ($this->formula[$index] == self::QUOTE_SINGLE) {
+ if ($value !== '') {
+ // unexpected
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_UNKNOWN);
+ $value = '';
+ }
+ $inPath = true;
+ ++$index;
+
+ continue;
+ }
+
+ if ($this->formula[$index] == self::BRACKET_OPEN) {
+ $inRange = true;
+ $value .= self::BRACKET_OPEN;
+ ++$index;
+
+ continue;
+ }
+
+ if ($this->formula[$index] == self::ERROR_START) {
+ if ($value !== '') {
+ // unexpected
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_UNKNOWN);
+ $value = '';
+ }
+ $inError = true;
+ $value .= self::ERROR_START;
+ ++$index;
+
+ continue;
+ }
+
+ // mark start and end of arrays and array rows
+ if ($this->formula[$index] == self::BRACE_OPEN) {
+ if ($value !== '') {
+ // unexpected
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_UNKNOWN);
+ $value = '';
+ }
+
+ $tmp = new FormulaToken('ARRAY', FormulaToken::TOKEN_TYPE_FUNCTION, FormulaToken::TOKEN_SUBTYPE_START);
+ $tokens1[] = $tmp;
+ $stack[] = clone $tmp;
+
+ $tmp = new FormulaToken('ARRAYROW', FormulaToken::TOKEN_TYPE_FUNCTION, FormulaToken::TOKEN_SUBTYPE_START);
+ $tokens1[] = $tmp;
+ $stack[] = clone $tmp;
+
+ ++$index;
+
+ continue;
+ }
+
+ if ($this->formula[$index] == self::SEMICOLON) {
+ if ($value !== '') {
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_OPERAND);
+ $value = '';
+ }
+
+ /** @var FormulaToken $tmp */
+ $tmp = array_pop($stack);
+ $tmp->setValue('');
+ $tmp->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_STOP);
+ $tokens1[] = $tmp;
+
+ $tmp = new FormulaToken(',', FormulaToken::TOKEN_TYPE_ARGUMENT);
+ $tokens1[] = $tmp;
+
+ $tmp = new FormulaToken('ARRAYROW', FormulaToken::TOKEN_TYPE_FUNCTION, FormulaToken::TOKEN_SUBTYPE_START);
+ $tokens1[] = $tmp;
+ $stack[] = clone $tmp;
+
+ ++$index;
+
+ continue;
+ }
+
+ if ($this->formula[$index] == self::BRACE_CLOSE) {
+ if ($value !== '') {
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_OPERAND);
+ $value = '';
+ }
+
+ /** @var FormulaToken $tmp */
+ $tmp = array_pop($stack);
+ $tmp->setValue('');
+ $tmp->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_STOP);
+ $tokens1[] = $tmp;
+
+ /** @var FormulaToken $tmp */
+ $tmp = array_pop($stack);
+ $tmp->setValue('');
+ $tmp->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_STOP);
+ $tokens1[] = $tmp;
+
+ ++$index;
+
+ continue;
+ }
+
+ // trim white-space
+ if ($this->formula[$index] == self::WHITESPACE) {
+ if ($value !== '') {
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_OPERAND);
+ $value = '';
+ }
+ $tokens1[] = new FormulaToken('', FormulaToken::TOKEN_TYPE_WHITESPACE);
+ ++$index;
+ while (($this->formula[$index] == self::WHITESPACE) && ($index < $formulaLength)) {
+ ++$index;
+ }
+
+ continue;
+ }
+
+ // multi-character comparators
+ if (($index + 2) <= $formulaLength) {
+ if (in_array(substr($this->formula, $index, 2), $COMPARATORS_MULTI)) {
+ if ($value !== '') {
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_OPERAND);
+ $value = '';
+ }
+ $tokens1[] = new FormulaToken(substr($this->formula, $index, 2), FormulaToken::TOKEN_TYPE_OPERATORINFIX, FormulaToken::TOKEN_SUBTYPE_LOGICAL);
+ $index += 2;
+
+ continue;
+ }
+ }
+
+ // standard infix operators
+ if (str_contains(self::OPERATORS_INFIX, $this->formula[$index])) {
+ if ($value !== '') {
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_OPERAND);
+ $value = '';
+ }
+ $tokens1[] = new FormulaToken($this->formula[$index], FormulaToken::TOKEN_TYPE_OPERATORINFIX);
+ ++$index;
+
+ continue;
+ }
+
+ // standard postfix operators (only one)
+ if (str_contains(self::OPERATORS_POSTFIX, $this->formula[$index])) {
+ if ($value !== '') {
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_OPERAND);
+ $value = '';
+ }
+ $tokens1[] = new FormulaToken($this->formula[$index], FormulaToken::TOKEN_TYPE_OPERATORPOSTFIX);
+ ++$index;
+
+ continue;
+ }
+
+ // start subexpression or function
+ if ($this->formula[$index] == self::PAREN_OPEN) {
+ if ($value !== '') {
+ $tmp = new FormulaToken($value, FormulaToken::TOKEN_TYPE_FUNCTION, FormulaToken::TOKEN_SUBTYPE_START);
+ $tokens1[] = $tmp;
+ $stack[] = clone $tmp;
+ $value = '';
+ } else {
+ $tmp = new FormulaToken('', FormulaToken::TOKEN_TYPE_SUBEXPRESSION, FormulaToken::TOKEN_SUBTYPE_START);
+ $tokens1[] = $tmp;
+ $stack[] = clone $tmp;
+ }
+ ++$index;
+
+ continue;
+ }
+
+ // function, subexpression, or array parameters, or operand unions
+ if ($this->formula[$index] == self::COMMA) {
+ if ($value !== '') {
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_OPERAND);
+ $value = '';
+ }
+
+ /** @var FormulaToken $tmp */
+ $tmp = array_pop($stack);
+ $tmp->setValue('');
+ $tmp->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_STOP);
+ $stack[] = $tmp;
+
+ if ($tmp->getTokenType() == FormulaToken::TOKEN_TYPE_FUNCTION) {
+ $tokens1[] = new FormulaToken(',', FormulaToken::TOKEN_TYPE_OPERATORINFIX, FormulaToken::TOKEN_SUBTYPE_UNION);
+ } else {
+ $tokens1[] = new FormulaToken(',', FormulaToken::TOKEN_TYPE_ARGUMENT);
+ }
+ ++$index;
+
+ continue;
+ }
+
+ // stop subexpression
+ if ($this->formula[$index] == self::PAREN_CLOSE) {
+ if ($value !== '') {
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_OPERAND);
+ $value = '';
+ }
+
+ /** @var FormulaToken $tmp */
+ $tmp = array_pop($stack);
+ $tmp->setValue('');
+ $tmp->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_STOP);
+ $tokens1[] = $tmp;
+
+ ++$index;
+
+ continue;
+ }
+
+ // token accumulation
+ $value .= $this->formula[$index];
+ ++$index;
+ }
+
+ // dump remaining accumulation
+ if ($value !== '') {
+ $tokens1[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_OPERAND);
+ }
+
+ // move tokenList to new set, excluding unnecessary white-space tokens and converting necessary ones to intersections
+ $tokenCount = count($tokens1);
+ for ($i = 0; $i < $tokenCount; ++$i) {
+ $token = $tokens1[$i];
+ if (isset($tokens1[$i - 1])) {
+ $previousToken = $tokens1[$i - 1];
+ } else {
+ $previousToken = null;
+ }
+ if (isset($tokens1[$i + 1])) {
+ $nextToken = $tokens1[$i + 1];
+ } else {
+ $nextToken = null;
+ }
+
+ if ($token->getTokenType() != FormulaToken::TOKEN_TYPE_WHITESPACE) {
+ $tokens2[] = $token;
+
+ continue;
+ }
+
+ if ($previousToken === null) {
+ continue;
+ }
+
+ if (
+ !(
+ (($previousToken->getTokenType() == FormulaToken::TOKEN_TYPE_FUNCTION) && ($previousToken->getTokenSubType() == FormulaToken::TOKEN_SUBTYPE_STOP))
+ || (($previousToken->getTokenType() == FormulaToken::TOKEN_TYPE_SUBEXPRESSION) && ($previousToken->getTokenSubType() == FormulaToken::TOKEN_SUBTYPE_STOP))
+ || ($previousToken->getTokenType() == FormulaToken::TOKEN_TYPE_OPERAND)
+ )
+ ) {
+ continue;
+ }
+
+ if ($nextToken === null) {
+ continue;
+ }
+
+ if (
+ !(
+ (($nextToken->getTokenType() == FormulaToken::TOKEN_TYPE_FUNCTION) && ($nextToken->getTokenSubType() == FormulaToken::TOKEN_SUBTYPE_START))
+ || (($nextToken->getTokenType() == FormulaToken::TOKEN_TYPE_SUBEXPRESSION) && ($nextToken->getTokenSubType() == FormulaToken::TOKEN_SUBTYPE_START))
+ || ($nextToken->getTokenType() == FormulaToken::TOKEN_TYPE_OPERAND)
+ )
+ ) {
+ continue;
+ }
+
+ $tokens2[] = new FormulaToken($value, FormulaToken::TOKEN_TYPE_OPERATORINFIX, FormulaToken::TOKEN_SUBTYPE_INTERSECTION);
+ }
+
+ // move tokens to final list, switching infix "-" operators to prefix when appropriate, switching infix "+" operators
+ // to noop when appropriate, identifying operand and infix-operator subtypes, and pulling "@" from function names
+ $this->tokens = [];
+
+ $tokenCount = count($tokens2);
+ for ($i = 0; $i < $tokenCount; ++$i) {
+ $token = $tokens2[$i];
+ if (isset($tokens2[$i - 1])) {
+ $previousToken = $tokens2[$i - 1];
+ } else {
+ $previousToken = null;
+ }
+
+ if ($token->getTokenType() == FormulaToken::TOKEN_TYPE_OPERATORINFIX && $token->getValue() == '-') {
+ if ($i == 0) {
+ $token->setTokenType(FormulaToken::TOKEN_TYPE_OPERATORPREFIX);
+ } elseif (
+ (($previousToken?->getTokenType() == FormulaToken::TOKEN_TYPE_FUNCTION)
+ && ($previousToken?->getTokenSubType() == FormulaToken::TOKEN_SUBTYPE_STOP))
+ || (($previousToken?->getTokenType() == FormulaToken::TOKEN_TYPE_SUBEXPRESSION)
+ && ($previousToken?->getTokenSubType() == FormulaToken::TOKEN_SUBTYPE_STOP))
+ || ($previousToken?->getTokenType() == FormulaToken::TOKEN_TYPE_OPERATORPOSTFIX)
+ || ($previousToken?->getTokenType() == FormulaToken::TOKEN_TYPE_OPERAND)
+ ) {
+ $token->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_MATH);
+ } else {
+ $token->setTokenType(FormulaToken::TOKEN_TYPE_OPERATORPREFIX);
+ }
+
+ $this->tokens[] = $token;
+
+ continue;
+ }
+
+ if ($token->getTokenType() == FormulaToken::TOKEN_TYPE_OPERATORINFIX && $token->getValue() == '+') {
+ if ($i == 0) {
+ continue;
+ } elseif (
+ (($previousToken?->getTokenType() == FormulaToken::TOKEN_TYPE_FUNCTION)
+ && ($previousToken?->getTokenSubType() == FormulaToken::TOKEN_SUBTYPE_STOP))
+ || (($previousToken?->getTokenType() == FormulaToken::TOKEN_TYPE_SUBEXPRESSION)
+ && ($previousToken?->getTokenSubType() == FormulaToken::TOKEN_SUBTYPE_STOP))
+ || ($previousToken?->getTokenType() == FormulaToken::TOKEN_TYPE_OPERATORPOSTFIX)
+ || ($previousToken?->getTokenType() == FormulaToken::TOKEN_TYPE_OPERAND)
+ ) {
+ $token->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_MATH);
+ } else {
+ continue;
+ }
+
+ $this->tokens[] = $token;
+
+ continue;
+ }
+
+ if (
+ $token->getTokenType() == FormulaToken::TOKEN_TYPE_OPERATORINFIX
+ && $token->getTokenSubType() == FormulaToken::TOKEN_SUBTYPE_NOTHING
+ ) {
+ if (str_contains('<>=', substr($token->getValue(), 0, 1))) {
+ $token->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_LOGICAL);
+ } elseif ($token->getValue() == '&') {
+ $token->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_CONCATENATION);
+ } else {
+ $token->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_MATH);
+ }
+
+ $this->tokens[] = $token;
+
+ continue;
+ }
+
+ if (
+ $token->getTokenType() == FormulaToken::TOKEN_TYPE_OPERAND
+ && $token->getTokenSubType() == FormulaToken::TOKEN_SUBTYPE_NOTHING
+ ) {
+ if (!is_numeric($token->getValue())) {
+ if (strtoupper($token->getValue()) == 'TRUE' || strtoupper($token->getValue()) == 'FALSE') {
+ $token->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_LOGICAL);
+ } else {
+ $token->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_RANGE);
+ }
+ } else {
+ $token->setTokenSubType(FormulaToken::TOKEN_SUBTYPE_NUMBER);
+ }
+
+ $this->tokens[] = $token;
+
+ continue;
+ }
+
+ if ($token->getTokenType() == FormulaToken::TOKEN_TYPE_FUNCTION) {
+ if ($token->getValue() !== '') {
+ if (str_starts_with($token->getValue(), '@')) {
+ $token->setValue(substr($token->getValue(), 1));
+ }
+ }
+ }
+
+ $this->tokens[] = $token;
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/FormulaToken.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/FormulaToken.php
new file mode 100644
index 00000000..cc7d48fc
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/FormulaToken.php
@@ -0,0 +1,131 @@
+value = $value;
+ $this->tokenType = $tokenType;
+ $this->tokenSubType = $tokenSubType;
+ }
+
+ /**
+ * Get Value.
+ */
+ public function getValue(): string
+ {
+ return $this->value;
+ }
+
+ /**
+ * Set Value.
+ */
+ public function setValue(string $value): void
+ {
+ $this->value = $value;
+ }
+
+ /**
+ * Get Token Type (represented by TOKEN_TYPE_*).
+ */
+ public function getTokenType(): string
+ {
+ return $this->tokenType;
+ }
+
+ /**
+ * Set Token Type (represented by TOKEN_TYPE_*).
+ */
+ public function setTokenType(string $value): void
+ {
+ $this->tokenType = $value;
+ }
+
+ /**
+ * Get Token SubType (represented by TOKEN_SUBTYPE_*).
+ */
+ public function getTokenSubType(): string
+ {
+ return $this->tokenSubType;
+ }
+
+ /**
+ * Set Token SubType (represented by TOKEN_SUBTYPE_*).
+ */
+ public function setTokenSubType(string $value): void
+ {
+ $this->tokenSubType = $value;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Functions.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Functions.php
new file mode 100644
index 00000000..77f8317a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Functions.php
@@ -0,0 +1,324 @@
+ 0);
+ }
+
+ public static function isValue(mixed $idx): bool
+ {
+ return substr_count($idx, '.') === 0;
+ }
+
+ public static function isCellValue(mixed $idx): bool
+ {
+ return substr_count($idx, '.') > 1;
+ }
+
+ public static function ifCondition(mixed $condition): string
+ {
+ $condition = self::flattenSingleValue($condition);
+
+ if ($condition === '' || $condition === null) {
+ return '=""';
+ }
+ if (!is_string($condition) || !in_array($condition[0], ['>', '<', '='], true)) {
+ $condition = self::operandSpecialHandling($condition);
+ if (is_bool($condition)) {
+ return '=' . ($condition ? 'TRUE' : 'FALSE');
+ } elseif (!is_numeric($condition)) {
+ if ($condition !== '""') { // Not an empty string
+ // Escape any quotes in the string value
+ $condition = (string) preg_replace('/"/ui', '""', $condition);
+ }
+ $condition = Calculation::wrapResult(strtoupper($condition));
+ }
+
+ return str_replace('""""', '""', '=' . $condition);
+ }
+ preg_match('/(=|<[>=]?|>=?)(.*)/', $condition, $matches);
+ [, $operator, $operand] = $matches;
+
+ $operand = self::operandSpecialHandling($operand);
+ if (is_numeric(trim($operand, '"'))) {
+ $operand = trim($operand, '"');
+ } elseif (!is_numeric($operand) && $operand !== 'FALSE' && $operand !== 'TRUE') {
+ $operand = str_replace('"', '""', $operand);
+ $operand = Calculation::wrapResult(strtoupper($operand));
+ }
+
+ return str_replace('""""', '""', $operator . $operand);
+ }
+
+ private static function operandSpecialHandling(mixed $operand): mixed
+ {
+ if (is_numeric($operand) || is_bool($operand)) {
+ return $operand;
+ } elseif (strtoupper($operand) === Calculation::getTRUE() || strtoupper($operand) === Calculation::getFALSE()) {
+ return strtoupper($operand);
+ }
+
+ // Check for percentage
+ if (preg_match('/^\-?\d*\.?\d*\s?\%$/', $operand)) {
+ return ((float) rtrim($operand, '%')) / 100;
+ }
+
+ // Check for dates
+ if (($dateValueOperand = Date::stringToExcel($operand)) !== false) {
+ return $dateValueOperand;
+ }
+
+ return $operand;
+ }
+
+ /**
+ * Convert a multi-dimensional array to a simple 1-dimensional array.
+ *
+ * @param mixed $array Array to be flattened
+ *
+ * @return array Flattened array
+ */
+ public static function flattenArray(mixed $array): array
+ {
+ if (!is_array($array)) {
+ return (array) $array;
+ }
+
+ $flattened = [];
+ $stack = array_values($array);
+
+ while (!empty($stack)) {
+ $value = array_shift($stack);
+
+ if (is_array($value)) {
+ array_unshift($stack, ...array_values($value));
+ } else {
+ $flattened[] = $value;
+ }
+ }
+
+ return $flattened;
+ }
+
+ public static function scalar(mixed $value): mixed
+ {
+ if (!is_array($value)) {
+ return $value;
+ }
+
+ do {
+ $value = array_pop($value);
+ } while (is_array($value));
+
+ return $value;
+ }
+
+ /**
+ * Convert a multi-dimensional array to a simple 1-dimensional array, but retain an element of indexing.
+ *
+ * @param array|mixed $array Array to be flattened
+ *
+ * @return array Flattened array
+ */
+ public static function flattenArrayIndexed($array): array
+ {
+ if (!is_array($array)) {
+ return (array) $array;
+ }
+
+ $arrayValues = [];
+ foreach ($array as $k1 => $value) {
+ if (is_array($value)) {
+ foreach ($value as $k2 => $val) {
+ if (is_array($val)) {
+ foreach ($val as $k3 => $v) {
+ $arrayValues[$k1 . '.' . $k2 . '.' . $k3] = $v;
+ }
+ } else {
+ $arrayValues[$k1 . '.' . $k2] = $val;
+ }
+ }
+ } else {
+ $arrayValues[$k1] = $value;
+ }
+ }
+
+ return $arrayValues;
+ }
+
+ /**
+ * Convert an array to a single scalar value by extracting the first element.
+ *
+ * @param mixed $value Array or scalar value
+ */
+ public static function flattenSingleValue(mixed $value): mixed
+ {
+ while (is_array($value)) {
+ $value = array_shift($value);
+ }
+
+ return $value;
+ }
+
+ public static function expandDefinedName(string $coordinate, Cell $cell): string
+ {
+ $worksheet = $cell->getWorksheet();
+ $spreadsheet = $worksheet->getParentOrThrow();
+ // Uppercase coordinate
+ $pCoordinatex = strtoupper($coordinate);
+ // Eliminate leading equal sign
+ $pCoordinatex = (string) preg_replace('/^=/', '', $pCoordinatex);
+ $defined = $spreadsheet->getDefinedName($pCoordinatex, $worksheet);
+ if ($defined !== null) {
+ $worksheet2 = $defined->getWorkSheet();
+ if (!$defined->isFormula() && $worksheet2 !== null) {
+ $coordinate = "'" . $worksheet2->getTitle() . "'!"
+ . (string) preg_replace('/^=/', '', str_replace('$', '', $defined->getValue()));
+ }
+ }
+
+ return $coordinate;
+ }
+
+ public static function trimTrailingRange(string $coordinate): string
+ {
+ return (string) preg_replace('/:[\\w\$]+$/', '', $coordinate);
+ }
+
+ public static function trimSheetFromCellReference(string $coordinate): string
+ {
+ if (str_contains($coordinate, '!')) {
+ $coordinate = substr($coordinate, strrpos($coordinate, '!') + 1);
+ }
+
+ return $coordinate;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Information/ErrorValue.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Information/ErrorValue.php
new file mode 100644
index 00000000..f3a74627
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Information/ErrorValue.php
@@ -0,0 +1,72 @@
+
+ */
+ public const ERROR_CODES = [
+ 'null' => '#NULL!', // 1
+ 'divisionbyzero' => '#DIV/0!', // 2
+ 'value' => '#VALUE!', // 3
+ 'reference' => '#REF!', // 4
+ 'name' => '#NAME?', // 5
+ 'num' => '#NUM!', // 6
+ 'na' => '#N/A', // 7
+ 'gettingdata' => '#GETTING_DATA', // 8
+ 'spill' => '#SPILL!', // 9
+ 'connect' => '#CONNECT!', //10
+ 'blocked' => '#BLOCKED!', //11
+ 'unknown' => '#UNKNOWN!', //12
+ 'field' => '#FIELD!', //13
+ 'calculation' => '#CALC!', //14
+ ];
+
+ public static function throwError(mixed $value): string
+ {
+ return in_array($value, self::ERROR_CODES, true) ? $value : self::ERROR_CODES['value'];
+ }
+
+ /**
+ * ERROR_TYPE.
+ *
+ * @param mixed $value Value to check
+ */
+ public static function type(mixed $value = ''): array|int|string
+ {
+ if (is_array($value)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);
+ }
+
+ $i = 1;
+ foreach (self::ERROR_CODES as $errorCode) {
+ if ($value === $errorCode) {
+ return $i;
+ }
+ ++$i;
+ }
+
+ return self::NA();
+ }
+
+ /**
+ * NULL.
+ *
+ * Returns the error value #NULL!
+ *
+ * @return string #NULL!
+ */
+ public static function null(): string
+ {
+ return self::ERROR_CODES['null'];
+ }
+
+ /**
+ * NaN.
+ *
+ * Returns the error value #NUM!
+ *
+ * @return string #NUM!
+ */
+ public static function NAN(): string
+ {
+ return self::ERROR_CODES['num'];
+ }
+
+ /**
+ * REF.
+ *
+ * Returns the error value #REF!
+ *
+ * @return string #REF!
+ */
+ public static function REF(): string
+ {
+ return self::ERROR_CODES['reference'];
+ }
+
+ /**
+ * NA.
+ *
+ * Excel Function:
+ * =NA()
+ *
+ * Returns the error value #N/A
+ * #N/A is the error value that means "no value is available."
+ *
+ * @return string #N/A!
+ */
+ public static function NA(): string
+ {
+ return self::ERROR_CODES['na'];
+ }
+
+ /**
+ * VALUE.
+ *
+ * Returns the error value #VALUE!
+ *
+ * @return string #VALUE!
+ */
+ public static function VALUE(): string
+ {
+ return self::ERROR_CODES['value'];
+ }
+
+ /**
+ * NAME.
+ *
+ * Returns the error value #NAME?
+ *
+ * @return string #NAME?
+ */
+ public static function NAME(): string
+ {
+ return self::ERROR_CODES['name'];
+ }
+
+ /**
+ * DIV0.
+ *
+ * @return string #DIV/0!
+ */
+ public static function DIV0(): string
+ {
+ return self::ERROR_CODES['divisionbyzero'];
+ }
+
+ /**
+ * CALC.
+ *
+ * @return string #CALC!
+ */
+ public static function CALC(): string
+ {
+ return self::ERROR_CODES['calculation'];
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Information/Value.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Information/Value.php
new file mode 100644
index 00000000..c9a7a0af
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Information/Value.php
@@ -0,0 +1,317 @@
+getCoordinate()) {
+ return false;
+ }
+
+ $cellValue = Functions::trimTrailingRange($value);
+ if (preg_match('/^' . Calculation::CALCULATION_REGEXP_CELLREF . '$/ui', $cellValue) === 1) {
+ [$worksheet, $cellValue] = Worksheet::extractSheetTitle($cellValue, true);
+ if (!empty($worksheet) && $cell->getWorksheet()->getParentOrThrow()->getSheetByName($worksheet) === null) {
+ return false;
+ }
+ [$column, $row] = Coordinate::indexesFromString($cellValue ?? '');
+ if ($column > 16384 || $row > 1048576) {
+ return false;
+ }
+
+ return true;
+ }
+
+ $namedRange = $cell->getWorksheet()->getParentOrThrow()->getNamedRange($value);
+
+ return $namedRange instanceof NamedRange;
+ }
+
+ /**
+ * IS_EVEN.
+ *
+ * @param mixed $value Value to check
+ * Or can be an array of values
+ *
+ * @return array|bool|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function isEven(mixed $value = null): array|string|bool
+ {
+ if (is_array($value)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);
+ }
+
+ if ($value === null) {
+ return ExcelError::NAME();
+ } elseif ((is_bool($value)) || ((is_string($value)) && (!is_numeric($value)))) {
+ return ExcelError::VALUE();
+ }
+
+ return ((int) fmod($value, 2)) === 0;
+ }
+
+ /**
+ * IS_ODD.
+ *
+ * @param mixed $value Value to check
+ * Or can be an array of values
+ *
+ * @return array|bool|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function isOdd(mixed $value = null): array|string|bool
+ {
+ if (is_array($value)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);
+ }
+
+ if ($value === null) {
+ return ExcelError::NAME();
+ } elseif ((is_bool($value)) || ((is_string($value)) && (!is_numeric($value)))) {
+ return ExcelError::VALUE();
+ }
+
+ return ((int) fmod($value, 2)) !== 0;
+ }
+
+ /**
+ * IS_NUMBER.
+ *
+ * @param mixed $value Value to check
+ * Or can be an array of values
+ *
+ * @return array|bool If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function isNumber(mixed $value = null): array|bool
+ {
+ if (is_array($value)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);
+ }
+
+ if (is_string($value)) {
+ return false;
+ }
+
+ return is_numeric($value);
+ }
+
+ /**
+ * IS_LOGICAL.
+ *
+ * @param mixed $value Value to check
+ * Or can be an array of values
+ *
+ * @return array|bool If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function isLogical(mixed $value = null): array|bool
+ {
+ if (is_array($value)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);
+ }
+
+ return is_bool($value);
+ }
+
+ /**
+ * IS_TEXT.
+ *
+ * @param mixed $value Value to check
+ * Or can be an array of values
+ *
+ * @return array|bool If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function isText(mixed $value = null): array|bool
+ {
+ if (is_array($value)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);
+ }
+
+ return is_string($value) && !ErrorValue::isError($value);
+ }
+
+ /**
+ * IS_NONTEXT.
+ *
+ * @param mixed $value Value to check
+ * Or can be an array of values
+ *
+ * @return array|bool If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function isNonText(mixed $value = null): array|bool
+ {
+ if (is_array($value)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);
+ }
+
+ return !self::isText($value);
+ }
+
+ /**
+ * ISFORMULA.
+ *
+ * @param mixed $cellReference The cell to check
+ * @param ?Cell $cell The current cell (containing this formula)
+ */
+ public static function isFormula(mixed $cellReference = '', ?Cell $cell = null): array|bool|string
+ {
+ if ($cell === null) {
+ return ExcelError::REF();
+ }
+
+ $fullCellReference = Functions::expandDefinedName((string) $cellReference, $cell);
+
+ if (str_contains($cellReference, '!')) {
+ $cellReference = Functions::trimSheetFromCellReference($cellReference);
+ $cellReferences = Coordinate::extractAllCellReferencesInRange($cellReference);
+ if (count($cellReferences) > 1) {
+ return self::evaluateArrayArgumentsSubset([self::class, __FUNCTION__], 1, $cellReferences, $cell);
+ }
+ }
+
+ $fullCellReference = Functions::trimTrailingRange($fullCellReference);
+
+ preg_match('/^' . Calculation::CALCULATION_REGEXP_CELLREF . '$/i', $fullCellReference, $matches);
+
+ $fullCellReference = $matches[6] . $matches[7];
+ $worksheetName = str_replace("''", "'", trim($matches[2], "'"));
+
+ $worksheet = (!empty($worksheetName))
+ ? $cell->getWorksheet()->getParentOrThrow()->getSheetByName($worksheetName)
+ : $cell->getWorksheet();
+
+ return ($worksheet !== null) ? $worksheet->getCell($fullCellReference)->isFormula() : ExcelError::REF();
+ }
+
+ /**
+ * N.
+ *
+ * Returns a value converted to a number
+ *
+ * @param null|mixed $value The value you want converted
+ *
+ * @return number|string N converts values listed in the following table
+ * If value is or refers to N returns
+ * A number That number value
+ * A date The Excel serialized number of that date
+ * TRUE 1
+ * FALSE 0
+ * An error value The error value
+ * Anything else 0
+ */
+ public static function asNumber($value = null)
+ {
+ while (is_array($value)) {
+ $value = array_shift($value);
+ }
+
+ switch (gettype($value)) {
+ case 'double':
+ case 'float':
+ case 'integer':
+ return $value;
+ case 'boolean':
+ return (int) $value;
+ case 'string':
+ // Errors
+ if (($value !== '') && ($value[0] == '#')) {
+ return $value;
+ }
+
+ break;
+ }
+
+ return 0;
+ }
+
+ /**
+ * TYPE.
+ *
+ * Returns a number that identifies the type of a value
+ *
+ * @param null|mixed $value The value you want tested
+ *
+ * @return int N converts values listed in the following table
+ * If value is or refers to N returns
+ * A number 1
+ * Text 2
+ * Logical Value 4
+ * An error value 16
+ * Array or Matrix 64
+ */
+ public static function type($value = null): int
+ {
+ $value = Functions::flattenArrayIndexed($value);
+ if (is_array($value) && (count($value) > 1)) {
+ end($value);
+ $a = key($value);
+ // Range of cells is an error
+ if (Functions::isCellValue($a)) {
+ return 16;
+ // Test for Matrix
+ } elseif (Functions::isMatrixValue($a)) {
+ return 64;
+ }
+ } elseif (empty($value)) {
+ // Empty Cell
+ return 1;
+ }
+
+ $value = Functions::flattenSingleValue($value);
+ if (($value === null) || (is_float($value)) || (is_int($value))) {
+ return 1;
+ } elseif (is_bool($value)) {
+ return 4;
+ } elseif (is_array($value)) {
+ return 64;
+ } elseif (is_string($value)) {
+ // Errors
+ if (($value !== '') && ($value[0] == '#')) {
+ return 16;
+ }
+
+ return 2;
+ }
+
+ return 0;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Internal/MakeMatrix.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Internal/MakeMatrix.php
new file mode 100644
index 00000000..22c95e86
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Internal/MakeMatrix.php
@@ -0,0 +1,12 @@
+ 0) {
+ $targetValue = Functions::flattenSingleValue($arguments[0]);
+ $argc = count($arguments) - 1;
+ $switchCount = floor($argc / 2);
+ $hasDefaultClause = $argc % 2 !== 0;
+ $defaultClause = $argc % 2 === 0 ? null : $arguments[$argc];
+
+ $switchSatisfied = false;
+ if ($switchCount > 0) {
+ for ($index = 0; $index < $switchCount; ++$index) {
+ if ($targetValue == Functions::flattenSingleValue($arguments[$index * 2 + 1])) {
+ $result = $arguments[$index * 2 + 2];
+ $switchSatisfied = true;
+
+ break;
+ }
+ }
+ }
+
+ if ($switchSatisfied !== true) {
+ $result = $hasDefaultClause ? $defaultClause : ExcelError::NA();
+ }
+ }
+
+ return $result;
+ }
+
+ /**
+ * IFERROR.
+ *
+ * Excel Function:
+ * =IFERROR(testValue,errorpart)
+ *
+ * @param mixed $testValue Value to check, is also the value returned when no error
+ * Or can be an array of values
+ * @param mixed $errorpart Value to return when testValue is an error condition
+ * Note that this can be an array value to be returned
+ *
+ * @return mixed The value of errorpart or testValue determined by error condition
+ * If an array of values is passed as the $testValue argument, then the returned result will also be
+ * an array with the same dimensions
+ */
+ public static function IFERROR(mixed $testValue = '', mixed $errorpart = ''): mixed
+ {
+ if (is_array($testValue)) {
+ return self::evaluateArrayArgumentsSubset([self::class, __FUNCTION__], 1, $testValue, $errorpart);
+ }
+
+ $errorpart = $errorpart ?? '';
+ $testValue = $testValue ?? 0; // this is how Excel handles empty cell
+
+ return self::statementIf(ErrorValue::isError($testValue), $errorpart, $testValue);
+ }
+
+ /**
+ * IFNA.
+ *
+ * Excel Function:
+ * =IFNA(testValue,napart)
+ *
+ * @param mixed $testValue Value to check, is also the value returned when not an NA
+ * Or can be an array of values
+ * @param mixed $napart Value to return when testValue is an NA condition
+ * Note that this can be an array value to be returned
+ *
+ * @return mixed The value of errorpart or testValue determined by error condition
+ * If an array of values is passed as the $testValue argument, then the returned result will also be
+ * an array with the same dimensions
+ */
+ public static function IFNA(mixed $testValue = '', mixed $napart = ''): mixed
+ {
+ if (is_array($testValue)) {
+ return self::evaluateArrayArgumentsSubset([self::class, __FUNCTION__], 1, $testValue, $napart);
+ }
+
+ $napart = $napart ?? '';
+ $testValue = $testValue ?? 0; // this is how Excel handles empty cell
+
+ return self::statementIf(ErrorValue::isNa($testValue), $napart, $testValue);
+ }
+
+ /**
+ * IFS.
+ *
+ * Excel Function:
+ * =IFS(testValue1;returnIfTrue1;testValue2;returnIfTrue2;...;testValue_n;returnIfTrue_n)
+ *
+ * testValue1 ... testValue_n
+ * Conditions to Evaluate
+ * returnIfTrue1 ... returnIfTrue_n
+ * Value returned if corresponding testValue (nth) was true
+ *
+ * @param mixed ...$arguments Statement arguments
+ * Note that this can be an array value to be returned
+ *
+ * @return mixed|string The value of returnIfTrue_n, if testValue_n was true. #N/A if none of testValues was true
+ */
+ public static function IFS(mixed ...$arguments)
+ {
+ $argumentCount = count($arguments);
+
+ if ($argumentCount % 2 != 0) {
+ return ExcelError::NA();
+ }
+ // We use instance of Exception as a falseValue in order to prevent string collision with value in cell
+ $falseValueException = new Exception();
+ for ($i = 0; $i < $argumentCount; $i += 2) {
+ $testValue = ($arguments[$i] === null) ? '' : Functions::flattenSingleValue($arguments[$i]);
+ $returnIfTrue = ($arguments[$i + 1] === null) ? '' : $arguments[$i + 1];
+ $result = self::statementIf($testValue, $returnIfTrue, $falseValueException);
+
+ if ($result !== $falseValueException) {
+ return $result;
+ }
+ }
+
+ return ExcelError::NA();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Logical/Operations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Logical/Operations.php
new file mode 100644
index 00000000..16bb5dd4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Logical/Operations.php
@@ -0,0 +1,163 @@
+ $trueValueCount === $count);
+ }
+
+ /**
+ * LOGICAL_OR.
+ *
+ * Returns boolean TRUE if any argument is TRUE; returns FALSE if all arguments are FALSE.
+ *
+ * Excel Function:
+ * =OR(logical1[,logical2[, ...]])
+ *
+ * The arguments must evaluate to logical values such as TRUE or FALSE, or the arguments must be arrays
+ * or references that contain logical values.
+ *
+ * Boolean arguments are treated as True or False as appropriate
+ * Integer or floating point arguments are treated as True, except for 0 or 0.0 which are False
+ * If any argument value is a string, or a Null, the function returns a #VALUE! error, unless the string
+ * holds the value TRUE or FALSE, in which case it is evaluated as the corresponding boolean value
+ *
+ * @param mixed $args Data values
+ *
+ * @return bool|string the logical OR of the arguments
+ */
+ public static function logicalOr(mixed ...$args)
+ {
+ return self::countTrueValues($args, fn (int $trueValueCount): bool => $trueValueCount > 0);
+ }
+
+ /**
+ * LOGICAL_XOR.
+ *
+ * Returns the Exclusive Or logical operation for one or more supplied conditions.
+ * i.e. the Xor function returns TRUE if an odd number of the supplied conditions evaluate to TRUE,
+ * and FALSE otherwise.
+ *
+ * Excel Function:
+ * =XOR(logical1[,logical2[, ...]])
+ *
+ * The arguments must evaluate to logical values such as TRUE or FALSE, or the arguments must be arrays
+ * or references that contain logical values.
+ *
+ * Boolean arguments are treated as True or False as appropriate
+ * Integer or floating point arguments are treated as True, except for 0 or 0.0 which are False
+ * If any argument value is a string, or a Null, the function returns a #VALUE! error, unless the string
+ * holds the value TRUE or FALSE, in which case it is evaluated as the corresponding boolean value
+ *
+ * @param mixed $args Data values
+ *
+ * @return bool|string the logical XOR of the arguments
+ */
+ public static function logicalXor(mixed ...$args)
+ {
+ return self::countTrueValues($args, fn (int $trueValueCount): bool => $trueValueCount % 2 === 1);
+ }
+
+ /**
+ * NOT.
+ *
+ * Returns the boolean inverse of the argument.
+ *
+ * Excel Function:
+ * =NOT(logical)
+ *
+ * The argument must evaluate to a logical value such as TRUE or FALSE
+ *
+ * Boolean arguments are treated as True or False as appropriate
+ * Integer or floating point arguments are treated as True, except for 0 or 0.0 which are False
+ * If any argument value is a string, or a Null, the function returns a #VALUE! error, unless the string
+ * holds the value TRUE or FALSE, in which case it is evaluated as the corresponding boolean value
+ *
+ * @param mixed $logical A value or expression that can be evaluated to TRUE or FALSE
+ * Or can be an array of values
+ *
+ * @return array|bool|string the boolean inverse of the argument
+ * If an array of values is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function NOT(mixed $logical = false): array|bool|string
+ {
+ if (is_array($logical)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $logical);
+ }
+
+ if (is_string($logical)) {
+ $logical = mb_strtoupper($logical, 'UTF-8');
+ if (($logical == 'TRUE') || ($logical == Calculation::getTRUE())) {
+ return false;
+ } elseif (($logical == 'FALSE') || ($logical == Calculation::getFALSE())) {
+ return true;
+ }
+
+ return ExcelError::VALUE();
+ }
+
+ return !$logical;
+ }
+
+ private static function countTrueValues(array $args, callable $func): bool|string
+ {
+ $trueValueCount = 0;
+ $count = 0;
+
+ $aArgs = Functions::flattenArrayIndexed($args);
+ foreach ($aArgs as $k => $arg) {
+ ++$count;
+ // Is it a boolean value?
+ if (is_bool($arg)) {
+ $trueValueCount += $arg;
+ } elseif (is_string($arg)) {
+ $isLiteral = !Functions::isCellValue($k);
+ $arg = mb_strtoupper($arg, 'UTF-8');
+ if ($isLiteral && ($arg == 'TRUE' || $arg == Calculation::getTRUE())) {
+ ++$trueValueCount;
+ } elseif ($isLiteral && ($arg == 'FALSE' || $arg == Calculation::getFALSE())) {
+ //$trueValueCount += 0;
+ } else {
+ --$count;
+ }
+ } elseif (is_int($arg) || is_float($arg)) {
+ $trueValueCount += (int) ($arg != 0);
+ } else {
+ --$count;
+ }
+ }
+
+ return ($count === 0) ? ExcelError::VALUE() : $func($trueValueCount, $count);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Address.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Address.php
new file mode 100644
index 00000000..0a5347b8
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Address.php
@@ -0,0 +1,123 @@
+ '') {
+ if (str_contains($sheetName, ' ') || str_contains($sheetName, '[')) {
+ $sheetName = "'{$sheetName}'";
+ }
+ $sheetName .= '!';
+ }
+
+ return $sheetName;
+ }
+
+ private static function formatAsA1(int $row, int $column, int $relativity, string $sheetName): string
+ {
+ $rowRelative = $columnRelative = '$';
+ if (($relativity == self::ADDRESS_COLUMN_RELATIVE) || ($relativity == self::ADDRESS_RELATIVE)) {
+ $columnRelative = '';
+ }
+ if (($relativity == self::ADDRESS_ROW_RELATIVE) || ($relativity == self::ADDRESS_RELATIVE)) {
+ $rowRelative = '';
+ }
+ $column = Coordinate::stringFromColumnIndex($column);
+
+ return "{$sheetName}{$columnRelative}{$column}{$rowRelative}{$row}";
+ }
+
+ private static function formatAsR1C1(int $row, int $column, int $relativity, string $sheetName): string
+ {
+ if (($relativity == self::ADDRESS_COLUMN_RELATIVE) || ($relativity == self::ADDRESS_RELATIVE)) {
+ $column = "[{$column}]";
+ }
+ if (($relativity == self::ADDRESS_ROW_RELATIVE) || ($relativity == self::ADDRESS_RELATIVE)) {
+ $row = "[{$row}]";
+ }
+ [$rowChar, $colChar] = AddressHelper::getRowAndColumnChars();
+
+ return "{$sheetName}$rowChar{$row}$colChar{$column}";
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/ExcelMatch.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/ExcelMatch.php
new file mode 100644
index 00000000..43e89c9b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/ExcelMatch.php
@@ -0,0 +1,249 @@
+getMessage();
+ }
+
+ // MATCH() is not case sensitive, so we convert lookup value to be lower cased if it's a string type.
+ if (is_string($lookupValue)) {
+ $lookupValue = StringHelper::strToLower($lookupValue);
+ }
+
+ $valueKey = match ($matchType) {
+ self::MATCHTYPE_LARGEST_VALUE => self::matchLargestValue($lookupArray, $lookupValue, $keySet),
+ self::MATCHTYPE_FIRST_VALUE => self::matchFirstValue($lookupArray, $lookupValue),
+ default => self::matchSmallestValue($lookupArray, $lookupValue),
+ };
+
+ if ($valueKey !== null) {
+ return ++$valueKey;
+ }
+
+ // Unsuccessful in finding a match, return #N/A error value
+ return ExcelError::NA();
+ }
+
+ private static function matchFirstValue(array $lookupArray, mixed $lookupValue): int|string|null
+ {
+ if (is_string($lookupValue)) {
+ $valueIsString = true;
+ $wildcard = WildcardMatch::wildcard($lookupValue);
+ } else {
+ $valueIsString = false;
+ $wildcard = '';
+ }
+
+ $valueIsNumeric = is_int($lookupValue) || is_float($lookupValue);
+ foreach ($lookupArray as $i => $lookupArrayValue) {
+ if (
+ $valueIsString
+ && is_string($lookupArrayValue)
+ ) {
+ if (WildcardMatch::compare($lookupArrayValue, $wildcard)) {
+ return $i; // wildcard match
+ }
+ } else {
+ if ($lookupArrayValue === $lookupValue) {
+ return $i; // exact match
+ }
+ if (
+ $valueIsNumeric
+ && (is_float($lookupArrayValue) || is_int($lookupArrayValue))
+ && $lookupArrayValue == $lookupValue
+ ) {
+ return $i; // exact match
+ }
+ }
+ }
+
+ return null;
+ }
+
+ private static function matchLargestValue(array $lookupArray, mixed $lookupValue, array $keySet): mixed
+ {
+ if (is_string($lookupValue)) {
+ if (Functions::getCompatibilityMode() === Functions::COMPATIBILITY_OPENOFFICE) {
+ $wildcard = WildcardMatch::wildcard($lookupValue);
+ foreach (array_reverse($lookupArray) as $i => $lookupArrayValue) {
+ if (is_string($lookupArrayValue) && WildcardMatch::compare($lookupArrayValue, $wildcard)) {
+ return $i;
+ }
+ }
+ } else {
+ foreach ($lookupArray as $i => $lookupArrayValue) {
+ if ($lookupArrayValue === $lookupValue) {
+ return $keySet[$i];
+ }
+ }
+ }
+ }
+ $valueIsNumeric = is_int($lookupValue) || is_float($lookupValue);
+ foreach ($lookupArray as $i => $lookupArrayValue) {
+ if ($valueIsNumeric && (is_int($lookupArrayValue) || is_float($lookupArrayValue))) {
+ if ($lookupArrayValue <= $lookupValue) {
+ return array_search($i, $keySet);
+ }
+ }
+ $typeMatch = gettype($lookupValue) === gettype($lookupArrayValue);
+ if ($typeMatch && ($lookupArrayValue <= $lookupValue)) {
+ return array_search($i, $keySet);
+ }
+ }
+
+ return null;
+ }
+
+ private static function matchSmallestValue(array $lookupArray, mixed $lookupValue): int|string|null
+ {
+ $valueKey = null;
+ if (is_string($lookupValue)) {
+ if (Functions::getCompatibilityMode() === Functions::COMPATIBILITY_OPENOFFICE) {
+ $wildcard = WildcardMatch::wildcard($lookupValue);
+ foreach ($lookupArray as $i => $lookupArrayValue) {
+ if (is_string($lookupArrayValue) && WildcardMatch::compare($lookupArrayValue, $wildcard)) {
+ return $i;
+ }
+ }
+ }
+ }
+
+ $valueIsNumeric = is_int($lookupValue) || is_float($lookupValue);
+ // The basic algorithm is:
+ // Iterate and keep the highest match until the next element is smaller than the searched value.
+ // Return immediately if perfect match is found
+ foreach ($lookupArray as $i => $lookupArrayValue) {
+ $typeMatch = gettype($lookupValue) === gettype($lookupArrayValue);
+ $bothNumeric = $valueIsNumeric && (is_int($lookupArrayValue) || is_float($lookupArrayValue));
+
+ if ($lookupArrayValue === $lookupValue) {
+ // Another "special" case. If a perfect match is found,
+ // the algorithm gives up immediately
+ return $i;
+ }
+ if ($bothNumeric && $lookupValue == $lookupArrayValue) {
+ return $i; // exact match, as above
+ }
+ if (($typeMatch || $bothNumeric) && $lookupArrayValue >= $lookupValue) {
+ $valueKey = $i;
+ } elseif ($typeMatch && $lookupArrayValue < $lookupValue) {
+ //Excel algorithm gives up immediately if the first element is smaller than the searched value
+ break;
+ }
+ }
+
+ return $valueKey;
+ }
+
+ private static function validateLookupValue(mixed $lookupValue): void
+ {
+ // Lookup_value type has to be number, text, or logical values
+ if ((!is_numeric($lookupValue)) && (!is_string($lookupValue)) && (!is_bool($lookupValue))) {
+ throw new Exception(ExcelError::NA());
+ }
+ }
+
+ private static function validateMatchType(mixed $matchType): int
+ {
+ // Match_type is 0, 1 or -1
+ // However Excel accepts other numeric values,
+ // including numeric strings and floats.
+ // It seems to just be interested in the sign.
+ if (!is_numeric($matchType)) {
+ throw new Exception(ExcelError::Value());
+ }
+ if ($matchType > 0) {
+ return self::MATCHTYPE_LARGEST_VALUE;
+ }
+ if ($matchType < 0) {
+ return self::MATCHTYPE_SMALLEST_VALUE;
+ }
+
+ return self::MATCHTYPE_FIRST_VALUE;
+ }
+
+ private static function validateLookupArray(array $lookupArray): void
+ {
+ // Lookup_array should not be empty
+ $lookupArraySize = count($lookupArray);
+ if ($lookupArraySize <= 0) {
+ throw new Exception(ExcelError::NA());
+ }
+ }
+
+ private static function prepareLookupArray(array $lookupArray, mixed $matchType): array
+ {
+ // Lookup_array should contain only number, text, or logical values, or empty (null) cells
+ foreach ($lookupArray as $i => $value) {
+ // check the type of the value
+ if ((!is_numeric($value)) && (!is_string($value)) && (!is_bool($value)) && ($value !== null)) {
+ throw new Exception(ExcelError::NA());
+ }
+ // Convert strings to lowercase for case-insensitive testing
+ if (is_string($value)) {
+ $lookupArray[$i] = StringHelper::strToLower($value);
+ }
+ if (
+ ($value === null)
+ && (($matchType == self::MATCHTYPE_LARGEST_VALUE) || ($matchType == self::MATCHTYPE_SMALLEST_VALUE))
+ ) {
+ unset($lookupArray[$i]);
+ }
+ }
+
+ return $lookupArray;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Filter.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Filter.php
new file mode 100644
index 00000000..e3b6cbe5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Filter.php
@@ -0,0 +1,72 @@
+ (bool) $matchArray[$index],
+ ARRAY_FILTER_USE_KEY
+ );
+ }
+
+ private static function filterByColumn(array $lookupArray, array $matchArray): array
+ {
+ $lookupArray = Matrix::transpose($lookupArray);
+
+ if (count($matchArray) === 1) {
+ $matchArray = array_pop($matchArray);
+ }
+
+ array_walk(
+ $matchArray,
+ function (&$value): void {
+ $value = [$value];
+ }
+ );
+
+ $result = self::filterByRow($lookupArray, $matchArray);
+
+ return Matrix::transpose($result);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Formula.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Formula.php
new file mode 100644
index 00000000..5c7f4051
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Formula.php
@@ -0,0 +1,41 @@
+getWorksheet()->getParentOrThrow()->getSheetByName($worksheetName)
+ : $cell->getWorksheet();
+
+ if (
+ $worksheet === null
+ || !$worksheet->cellExists($cellReference)
+ || !$worksheet->getCell($cellReference)->isFormula()
+ ) {
+ return ExcelError::NA();
+ }
+
+ return $worksheet->getCell($cellReference)->getValue();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/HLookup.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/HLookup.php
new file mode 100644
index 00000000..fd83700b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/HLookup.php
@@ -0,0 +1,121 @@
+getMessage();
+ }
+
+ $f = array_keys($lookupArray);
+ $firstRow = reset($f);
+ if ((!is_array($lookupArray[$firstRow])) || ($indexNumber > count($lookupArray))) {
+ return ExcelError::REF();
+ }
+
+ $firstkey = $f[0] - 1;
+ $returnColumn = $firstkey + $indexNumber;
+ $firstColumn = array_shift($f) ?? 1;
+ $rowNumber = self::hLookupSearch($lookupValue, $lookupArray, $firstColumn, $notExactMatch);
+
+ if ($rowNumber !== null) {
+ // otherwise return the appropriate value
+ return $lookupArray[$returnColumn][Coordinate::stringFromColumnIndex($rowNumber)];
+ }
+
+ return ExcelError::NA();
+ }
+
+ /**
+ * @param mixed $lookupValue The value that you want to match in lookup_array
+ * @param int|string $column
+ */
+ private static function hLookupSearch(mixed $lookupValue, array $lookupArray, $column, bool $notExactMatch): ?int
+ {
+ $lookupLower = StringHelper::strToLower((string) $lookupValue);
+
+ $rowNumber = null;
+ foreach ($lookupArray[$column] as $rowKey => $rowData) {
+ // break if we have passed possible keys
+ $bothNumeric = is_numeric($lookupValue) && is_numeric($rowData);
+ $bothNotNumeric = !is_numeric($lookupValue) && !is_numeric($rowData);
+ $cellDataLower = StringHelper::strToLower((string) $rowData);
+
+ if (
+ $notExactMatch
+ && (($bothNumeric && $rowData > $lookupValue) || ($bothNotNumeric && $cellDataLower > $lookupLower))
+ ) {
+ break;
+ }
+
+ $rowNumber = self::checkMatch(
+ $bothNumeric,
+ $bothNotNumeric,
+ $notExactMatch,
+ Coordinate::columnIndexFromString($rowKey),
+ $cellDataLower,
+ $lookupLower,
+ $rowNumber
+ );
+ }
+
+ return $rowNumber;
+ }
+
+ private static function convertLiteralArray(array $lookupArray): array
+ {
+ if (array_key_exists(0, $lookupArray)) {
+ $lookupArray2 = [];
+ $row = 0;
+ foreach ($lookupArray as $arrayVal) {
+ ++$row;
+ if (!is_array($arrayVal)) {
+ $arrayVal = [$arrayVal];
+ }
+ $arrayVal2 = [];
+ foreach ($arrayVal as $key2 => $val2) {
+ $index = Coordinate::stringFromColumnIndex($key2 + 1);
+ $arrayVal2[$index] = $val2;
+ }
+ $lookupArray2[$row] = $arrayVal2;
+ }
+ $lookupArray = $lookupArray2;
+ }
+
+ return $lookupArray;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Helpers.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Helpers.php
new file mode 100644
index 00000000..191144bf
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Helpers.php
@@ -0,0 +1,74 @@
+getWorkSheet();
+ $sheetTitle = ($workSheet === null) ? '' : $workSheet->getTitle();
+ $value = (string) preg_replace('/^=/', '', $namedRange->getValue());
+ self::adjustSheetTitle($sheetTitle, $value);
+ $cellAddress1 = $sheetTitle . $value;
+ $cellAddress = $cellAddress1;
+ $a1 = self::CELLADDRESS_USE_A1;
+ }
+ if (str_contains($cellAddress, ':')) {
+ [$cellAddress1, $cellAddress2] = explode(':', $cellAddress);
+ }
+ $cellAddress = self::convertR1C1($cellAddress1, $cellAddress2, $a1, $baseRow, $baseCol);
+
+ return [$cellAddress1, $cellAddress2, $cellAddress];
+ }
+
+ public static function extractWorksheet(string $cellAddress, Cell $cell): array
+ {
+ $sheetName = '';
+ if (str_contains($cellAddress, '!')) {
+ [$sheetName, $cellAddress] = Worksheet::extractSheetTitle($cellAddress, true);
+ $sheetName = trim($sheetName, "'");
+ }
+
+ $worksheet = ($sheetName !== '')
+ ? $cell->getWorksheet()->getParentOrThrow()->getSheetByName($sheetName)
+ : $cell->getWorksheet();
+
+ return [$cellAddress, $worksheet, $sheetName];
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Hyperlink.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Hyperlink.php
new file mode 100644
index 00000000..455442a8
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Hyperlink.php
@@ -0,0 +1,41 @@
+getHyperlink()->setUrl($linkURL);
+ $cell->getHyperlink()->setTooltip($displayName);
+
+ return $displayName;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Indirect.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Indirect.php
new file mode 100644
index 00000000..d53900d4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Indirect.php
@@ -0,0 +1,128 @@
+getCoordinate());
+
+ try {
+ $a1 = self::a1Format($a1fmt);
+ $cellAddress = self::validateAddress($cellAddress);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ [$cellAddress, $worksheet, $sheetName] = Helpers::extractWorksheet($cellAddress, $cell);
+
+ if (preg_match('/^' . Calculation::CALCULATION_REGEXP_COLUMNRANGE_RELATIVE . '$/miu', $cellAddress, $matches)) {
+ $cellAddress = self::handleRowColumnRanges($worksheet, ...explode(':', $cellAddress));
+ } elseif (preg_match('/^' . Calculation::CALCULATION_REGEXP_ROWRANGE_RELATIVE . '$/miu', $cellAddress, $matches)) {
+ $cellAddress = self::handleRowColumnRanges($worksheet, ...explode(':', $cellAddress));
+ }
+
+ try {
+ [$cellAddress1, $cellAddress2, $cellAddress] = Helpers::extractCellAddresses($cellAddress, $a1, $cell->getWorkSheet(), $sheetName, $baseRow, $baseCol);
+ } catch (Exception) {
+ return ExcelError::REF();
+ }
+
+ if (
+ (!preg_match('/^' . Calculation::CALCULATION_REGEXP_CELLREF . '$/miu', $cellAddress1, $matches))
+ || (($cellAddress2 !== null) && (!preg_match('/^' . Calculation::CALCULATION_REGEXP_CELLREF . '$/miu', $cellAddress2, $matches)))
+ ) {
+ return ExcelError::REF();
+ }
+
+ return self::extractRequiredCells($worksheet, $cellAddress);
+ }
+
+ /**
+ * Extract range values.
+ *
+ * @return array Array of values in range if range contains more than one element.
+ * Otherwise, a single value is returned.
+ */
+ private static function extractRequiredCells(?Worksheet $worksheet, string $cellAddress): array
+ {
+ return Calculation::getInstance($worksheet !== null ? $worksheet->getParent() : null)
+ ->extractCellRange($cellAddress, $worksheet, false);
+ }
+
+ private static function handleRowColumnRanges(?Worksheet $worksheet, string $start, string $end): string
+ {
+ // Being lazy, we're only checking a single row/column to get the max
+ if (ctype_digit($start) && $start <= 1048576) {
+ // Max 16,384 columns for Excel2007
+ $endColRef = ($worksheet !== null) ? $worksheet->getHighestDataColumn((int) $start) : AddressRange::MAX_COLUMN;
+
+ return "A{$start}:{$endColRef}{$end}";
+ } elseif (ctype_alpha($start) && strlen($start) <= 3) {
+ // Max 1,048,576 rows for Excel2007
+ $endRowRef = ($worksheet !== null) ? $worksheet->getHighestDataRow($start) : AddressRange::MAX_ROW;
+
+ return "{$start}1:{$end}{$endRowRef}";
+ }
+
+ return "{$start}:{$end}";
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Lookup.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Lookup.php
new file mode 100644
index 00000000..b1876207
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Lookup.php
@@ -0,0 +1,105 @@
+ 1) || (!$hasResultVector && $lookupRows === 2 && $lookupColumns !== 2)) {
+ $lookupVector = Matrix::transpose($lookupVector);
+ $lookupRows = self::rowCount($lookupVector);
+ $lookupColumns = self::columnCount($lookupVector);
+ }
+
+ $resultVector = self::verifyResultVector($resultVector ?? $lookupVector);
+
+ if ($lookupRows === 2 && !$hasResultVector) {
+ $resultVector = array_pop($lookupVector);
+ $lookupVector = array_shift($lookupVector);
+ }
+
+ if ($lookupColumns !== 2) {
+ $lookupVector = self::verifyLookupValues($lookupVector, $resultVector);
+ }
+
+ return VLookup::lookup($lookupValue, $lookupVector, 2);
+ }
+
+ private static function verifyLookupValues(array $lookupVector, array $resultVector): array
+ {
+ foreach ($lookupVector as &$value) {
+ if (is_array($value)) {
+ $k = array_keys($value);
+ $key1 = $key2 = array_shift($k);
+ ++$key2;
+ $dataValue1 = $value[$key1];
+ } else {
+ $key1 = 0;
+ $key2 = 1;
+ $dataValue1 = $value;
+ }
+
+ $dataValue2 = array_shift($resultVector);
+ if (is_array($dataValue2)) {
+ $dataValue2 = array_shift($dataValue2);
+ }
+ $value = [$key1 => $dataValue1, $key2 => $dataValue2];
+ }
+ unset($value);
+
+ return $lookupVector;
+ }
+
+ private static function verifyResultVector(array $resultVector): array
+ {
+ $resultRows = self::rowCount($resultVector);
+ $resultColumns = self::columnCount($resultVector);
+
+ // we correctly orient our results
+ if ($resultRows === 1 && $resultColumns > 1) {
+ $resultVector = Matrix::transpose($resultVector);
+ }
+
+ return $resultVector;
+ }
+
+ private static function rowCount(array $dataArray): int
+ {
+ return count($dataArray);
+ }
+
+ private static function columnCount(array $dataArray): int
+ {
+ $rowKeys = array_keys($dataArray);
+ $row = array_shift($rowKeys);
+
+ return count($dataArray[$row]);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/LookupBase.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/LookupBase.php
new file mode 100644
index 00000000..7d21cce0
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/LookupBase.php
@@ -0,0 +1,64 @@
+ 1
+ && (count($values, COUNT_NORMAL) === 1 || count($values, COUNT_RECURSIVE) === count($values, COUNT_NORMAL));
+ }
+
+ /**
+ * TRANSPOSE.
+ *
+ * @param array|mixed $matrixData A matrix of values
+ */
+ public static function transpose($matrixData): array
+ {
+ $returnMatrix = [];
+ if (!is_array($matrixData)) {
+ $matrixData = [[$matrixData]];
+ }
+
+ $column = 0;
+ foreach ($matrixData as $matrixRow) {
+ $row = 0;
+ foreach ($matrixRow as $matrixCell) {
+ $returnMatrix[$row][$column] = $matrixCell;
+ ++$row;
+ }
+ ++$column;
+ }
+
+ return $returnMatrix;
+ }
+
+ /**
+ * INDEX.
+ *
+ * Uses an index to choose a value from a reference or array
+ *
+ * Excel Function:
+ * =INDEX(range_array, row_num, [column_num], [area_num])
+ *
+ * @param mixed $matrix A range of cells or an array constant
+ * @param mixed $rowNum The row in the array or range from which to return a value.
+ * If row_num is omitted, column_num is required.
+ * Or can be an array of values
+ * @param mixed $columnNum The column in the array or range from which to return a value.
+ * If column_num is omitted, row_num is required.
+ * Or can be an array of values
+ *
+ * TODO Provide support for area_num, currently not supported
+ *
+ * @return mixed the value of a specified cell or array of cells
+ * If an array of values is passed as the $rowNum and/or $columnNum arguments, then the returned result
+ * will also be an array with the same dimensions
+ */
+ public static function index(mixed $matrix, mixed $rowNum = 0, mixed $columnNum = null): mixed
+ {
+ if (is_array($rowNum) || is_array($columnNum)) {
+ return self::evaluateArrayArgumentsSubsetFrom([self::class, __FUNCTION__], 1, $matrix, $rowNum, $columnNum);
+ }
+
+ $rowNum = $rowNum ?? 0;
+ $columnNum = $columnNum ?? 0;
+
+ try {
+ $rowNum = LookupRefValidations::validatePositiveInt($rowNum);
+ $columnNum = LookupRefValidations::validatePositiveInt($columnNum);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if (is_array($matrix) && count($matrix) === 1 && $rowNum > 1) {
+ $matrixKey = array_keys($matrix)[0];
+ if (is_array($matrix[$matrixKey])) {
+ $tempMatrix = [];
+ foreach ($matrix[$matrixKey] as $key => $value) {
+ $tempMatrix[$key] = [$value];
+ }
+ $matrix = $tempMatrix;
+ }
+ }
+
+ if (!is_array($matrix) || ($rowNum > count($matrix))) {
+ return ExcelError::REF();
+ }
+
+ $rowKeys = array_keys($matrix);
+ $columnKeys = @array_keys($matrix[$rowKeys[0]]);
+
+ if ($columnNum > count($columnKeys)) {
+ return ExcelError::REF();
+ }
+
+ if ($columnNum === 0) {
+ return self::extractRowValue($matrix, $rowKeys, $rowNum);
+ }
+
+ $columnNum = $columnKeys[--$columnNum];
+ if ($rowNum === 0) {
+ return array_map(
+ fn ($value): array => [$value],
+ array_column($matrix, $columnNum)
+ );
+ }
+ $rowNum = $rowKeys[--$rowNum];
+
+ return $matrix[$rowNum][$columnNum];
+ }
+
+ private static function extractRowValue(array $matrix, array $rowKeys, int $rowNum): mixed
+ {
+ if ($rowNum === 0) {
+ return $matrix;
+ }
+
+ $rowNum = $rowKeys[--$rowNum];
+ $row = $matrix[$rowNum];
+ if (is_array($row)) {
+ return [$rowNum => $row];
+ }
+
+ return $row;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Offset.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Offset.php
new file mode 100644
index 00000000..260ccc3a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Offset.php
@@ -0,0 +1,148 @@
+getParent() : null)
+ ->extractCellRange($cellAddress, $worksheet, false);
+ }
+
+ private static function extractWorksheet(?string $cellAddress, Cell $cell): array
+ {
+ $cellAddress = self::assessCellAddress($cellAddress ?? '', $cell);
+
+ $sheetName = '';
+ if (str_contains($cellAddress, '!')) {
+ [$sheetName, $cellAddress] = Worksheet::extractSheetTitle($cellAddress, true);
+ $sheetName = trim($sheetName, "'");
+ }
+
+ $worksheet = ($sheetName !== '')
+ ? $cell->getWorksheet()->getParentOrThrow()->getSheetByName($sheetName)
+ : $cell->getWorksheet();
+
+ return [$cellAddress, $worksheet];
+ }
+
+ private static function assessCellAddress(string $cellAddress, Cell $cell): string
+ {
+ if (preg_match('/^' . Calculation::CALCULATION_REGEXP_DEFINEDNAME . '$/mui', $cellAddress) !== false) {
+ $cellAddress = Functions::expandDefinedName($cellAddress, $cell);
+ }
+
+ return $cellAddress;
+ }
+
+ private static function adjustEndCellColumnForWidth(string $endCellColumn, mixed $width, int $startCellColumn, mixed $columns): int
+ {
+ $endCellColumn = Coordinate::columnIndexFromString($endCellColumn) - 1;
+ if (($width !== null) && (!is_object($width))) {
+ $endCellColumn = $startCellColumn + (int) $width - 1;
+ } else {
+ $endCellColumn += (int) $columns;
+ }
+
+ return $endCellColumn;
+ }
+
+ private static function adustEndCellRowForHeight(mixed $height, int $startCellRow, mixed $rows, mixed $endCellRow): int
+ {
+ if (($height !== null) && (!is_object($height))) {
+ $endCellRow = $startCellRow + (int) $height - 1;
+ } else {
+ $endCellRow += (int) $rows;
+ }
+
+ return $endCellRow;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/RowColumnInformation.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/RowColumnInformation.php
new file mode 100644
index 00000000..ea3ce44c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/RowColumnInformation.php
@@ -0,0 +1,210 @@
+getColumn()) : 1;
+ }
+
+ /**
+ * COLUMN.
+ *
+ * Returns the column number of the given cell reference
+ * If the cell reference is a range of cells, COLUMN returns the column numbers of each column
+ * in the reference as a horizontal array.
+ * If cell reference is omitted, and the function is being called through the calculation engine,
+ * then it is assumed to be the reference of the cell in which the COLUMN function appears;
+ * otherwise this function returns 1.
+ *
+ * Excel Function:
+ * =COLUMN([cellAddress])
+ *
+ * @param null|array|string $cellAddress A reference to a range of cells for which you want the column numbers
+ *
+ * @return int|int[]
+ */
+ public static function COLUMN($cellAddress = null, ?Cell $cell = null): int|array
+ {
+ if (self::cellAddressNullOrWhitespace($cellAddress)) {
+ return self::cellColumn($cell);
+ }
+
+ if (is_array($cellAddress)) {
+ foreach ($cellAddress as $columnKey => $value) {
+ $columnKey = (string) preg_replace('/[^a-z]/i', '', $columnKey);
+
+ return Coordinate::columnIndexFromString($columnKey);
+ }
+
+ return self::cellColumn($cell);
+ }
+
+ $cellAddress = $cellAddress ?? '';
+ if ($cell != null) {
+ [,, $sheetName] = Helpers::extractWorksheet($cellAddress, $cell);
+ [,, $cellAddress] = Helpers::extractCellAddresses($cellAddress, true, $cell->getWorksheet(), $sheetName);
+ }
+ [, $cellAddress] = Worksheet::extractSheetTitle($cellAddress, true);
+ $cellAddress ??= '';
+
+ if (str_contains($cellAddress, ':')) {
+ [$startAddress, $endAddress] = explode(':', $cellAddress);
+ $startAddress = (string) preg_replace('/[^a-z]/i', '', $startAddress);
+ $endAddress = (string) preg_replace('/[^a-z]/i', '', $endAddress);
+
+ return range(
+ Coordinate::columnIndexFromString($startAddress),
+ Coordinate::columnIndexFromString($endAddress)
+ );
+ }
+
+ $cellAddress = (string) preg_replace('/[^a-z]/i', '', $cellAddress);
+
+ return Coordinate::columnIndexFromString($cellAddress);
+ }
+
+ /**
+ * COLUMNS.
+ *
+ * Returns the number of columns in an array or reference.
+ *
+ * Excel Function:
+ * =COLUMNS(cellAddress)
+ *
+ * @param null|array|string $cellAddress An array or array formula, or a reference to a range of cells
+ * for which you want the number of columns
+ *
+ * @return int|string The number of columns in cellAddress, or a string if arguments are invalid
+ */
+ public static function COLUMNS($cellAddress = null)
+ {
+ if (self::cellAddressNullOrWhitespace($cellAddress)) {
+ return 1;
+ }
+ if (!is_array($cellAddress)) {
+ return ExcelError::VALUE();
+ }
+
+ reset($cellAddress);
+ $isMatrix = (is_numeric(key($cellAddress)));
+ [$columns, $rows] = Calculation::getMatrixDimensions($cellAddress);
+
+ if ($isMatrix) {
+ return $rows;
+ }
+
+ return $columns;
+ }
+
+ private static function cellRow(?Cell $cell): int
+ {
+ return ($cell !== null) ? $cell->getRow() : 1;
+ }
+
+ /**
+ * ROW.
+ *
+ * Returns the row number of the given cell reference
+ * If the cell reference is a range of cells, ROW returns the row numbers of each row in the reference
+ * as a vertical array.
+ * If cell reference is omitted, and the function is being called through the calculation engine,
+ * then it is assumed to be the reference of the cell in which the ROW function appears;
+ * otherwise this function returns 1.
+ *
+ * Excel Function:
+ * =ROW([cellAddress])
+ *
+ * @param null|array|string $cellAddress A reference to a range of cells for which you want the row numbers
+ *
+ * @return int|mixed[]
+ */
+ public static function ROW($cellAddress = null, ?Cell $cell = null): int|array
+ {
+ if (self::cellAddressNullOrWhitespace($cellAddress)) {
+ return self::cellRow($cell);
+ }
+
+ if (is_array($cellAddress)) {
+ foreach ($cellAddress as $rowKey => $rowValue) {
+ foreach ($rowValue as $columnKey => $cellValue) {
+ return (int) preg_replace('/\D/', '', $rowKey);
+ }
+ }
+
+ return self::cellRow($cell);
+ }
+
+ $cellAddress = $cellAddress ?? '';
+ if ($cell !== null) {
+ [,, $sheetName] = Helpers::extractWorksheet($cellAddress, $cell);
+ [,, $cellAddress] = Helpers::extractCellAddresses($cellAddress, true, $cell->getWorksheet(), $sheetName);
+ }
+ [, $cellAddress] = Worksheet::extractSheetTitle($cellAddress, true);
+ $cellAddress ??= '';
+ if (str_contains($cellAddress, ':')) {
+ [$startAddress, $endAddress] = explode(':', $cellAddress);
+ $startAddress = (int) (string) preg_replace('/\D/', '', $startAddress);
+ $endAddress = (int) (string) preg_replace('/\D/', '', $endAddress);
+
+ return array_map(
+ fn ($value): array => [$value],
+ range($startAddress, $endAddress)
+ );
+ }
+ [$cellAddress] = explode(':', $cellAddress);
+
+ return (int) preg_replace('/\D/', '', $cellAddress);
+ }
+
+ /**
+ * ROWS.
+ *
+ * Returns the number of rows in an array or reference.
+ *
+ * Excel Function:
+ * =ROWS(cellAddress)
+ *
+ * @param null|array|string $cellAddress An array or array formula, or a reference to a range of cells
+ * for which you want the number of rows
+ *
+ * @return int|string The number of rows in cellAddress, or a string if arguments are invalid
+ */
+ public static function ROWS($cellAddress = null)
+ {
+ if (self::cellAddressNullOrWhitespace($cellAddress)) {
+ return 1;
+ }
+ if (!is_array($cellAddress)) {
+ return ExcelError::VALUE();
+ }
+
+ reset($cellAddress);
+ $isMatrix = (is_numeric(key($cellAddress)));
+ [$columns, $rows] = Calculation::getMatrixDimensions($cellAddress);
+
+ if ($isMatrix) {
+ return $columns;
+ }
+
+ return $rows;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Selection.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Selection.php
new file mode 100644
index 00000000..53396c9c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Selection.php
@@ -0,0 +1,51 @@
+ $entryCount)) {
+ return ExcelError::VALUE();
+ }
+
+ if (is_array($chooseArgs[$chosenEntry])) {
+ return Functions::flattenArray($chooseArgs[$chosenEntry]);
+ }
+
+ return $chooseArgs[$chosenEntry];
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Sort.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Sort.php
new file mode 100644
index 00000000..9ad47b4e
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Sort.php
@@ -0,0 +1,309 @@
+getMessage();
+ }
+
+ // We want a simple, enumrated array of arrays where we can reference column by its index number.
+ $sortArray = array_values(array_map('array_values', $sortArray));
+
+ return ($byColumn === true)
+ ? self::sortByColumn($sortArray, $sortIndex, $sortOrder)
+ : self::sortByRow($sortArray, $sortIndex, $sortOrder);
+ }
+
+ /**
+ * SORTBY
+ * The SORTBY function sorts the contents of a range or array based on the values in a corresponding range or array.
+ * The returned array is the same shape as the provided array argument.
+ * Both $sortIndex and $sortOrder can be arrays, to provide multi-level sorting.
+ *
+ * @param mixed $sortArray The range of cells being sorted
+ * @param mixed $args
+ * At least one additional argument must be provided, The vector or range to sort on
+ * After that, arguments are passed as pairs:
+ * sort order: ascending or descending
+ * Ascending = 1 (self::ORDER_ASCENDING)
+ * Descending = -1 (self::ORDER_DESCENDING)
+ * additional arrays or ranges for multi-level sorting
+ *
+ * @return mixed The sorted values from the sort range
+ */
+ public static function sortBy(mixed $sortArray, mixed ...$args): mixed
+ {
+ if (!is_array($sortArray)) {
+ // Scalars are always returned "as is"
+ return $sortArray;
+ }
+
+ $sortArray = self::enumerateArrayKeys($sortArray);
+
+ $lookupArraySize = count($sortArray);
+ $argumentCount = count($args);
+
+ try {
+ $sortBy = $sortOrder = [];
+ for ($i = 0; $i < $argumentCount; $i += 2) {
+ $sortBy[] = self::validateSortVector($args[$i], $lookupArraySize);
+ $sortOrder[] = self::validateSortOrder($args[$i + 1] ?? self::ORDER_ASCENDING);
+ }
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return self::processSortBy($sortArray, $sortBy, $sortOrder);
+ }
+
+ private static function enumerateArrayKeys(array $sortArray): array
+ {
+ array_walk(
+ $sortArray,
+ function (&$columns): void {
+ if (is_array($columns)) {
+ $columns = array_values($columns);
+ }
+ }
+ );
+
+ return array_values($sortArray);
+ }
+
+ private static function validateScalarArgumentsForSort(mixed &$sortIndex, mixed &$sortOrder, int $sortArraySize): void
+ {
+ if (is_array($sortIndex) || is_array($sortOrder)) {
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ $sortIndex = self::validatePositiveInt($sortIndex, false);
+
+ if ($sortIndex > $sortArraySize) {
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ $sortOrder = self::validateSortOrder($sortOrder);
+ }
+
+ private static function validateSortVector(mixed $sortVector, int $sortArraySize): array
+ {
+ if (!is_array($sortVector)) {
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ // It doesn't matter if it's a row or a column vectors, it works either way
+ $sortVector = Functions::flattenArray($sortVector);
+ if (count($sortVector) !== $sortArraySize) {
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ return $sortVector;
+ }
+
+ private static function validateSortOrder(mixed $sortOrder): int
+ {
+ $sortOrder = self::validateInt($sortOrder);
+ if (($sortOrder == self::ORDER_ASCENDING || $sortOrder === self::ORDER_DESCENDING) === false) {
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ return $sortOrder;
+ }
+
+ private static function validateArrayArgumentsForSort(array &$sortIndex, mixed &$sortOrder, int $sortArraySize): void
+ {
+ // It doesn't matter if they're row or column vectors, it works either way
+ $sortIndex = Functions::flattenArray($sortIndex);
+ $sortOrder = Functions::flattenArray($sortOrder);
+
+ if (
+ count($sortOrder) === 0 || count($sortOrder) > $sortArraySize
+ || (count($sortOrder) > count($sortIndex))
+ ) {
+ throw new Exception(ExcelError::VALUE());
+ }
+
+ if (count($sortIndex) > count($sortOrder)) {
+ // If $sortOrder has fewer elements than $sortIndex, then the last order element is repeated.
+ $sortOrder = array_merge(
+ $sortOrder,
+ array_fill(0, count($sortIndex) - count($sortOrder), array_pop($sortOrder))
+ );
+ }
+
+ foreach ($sortIndex as $key => &$value) {
+ self::validateScalarArgumentsForSort($value, $sortOrder[$key], $sortArraySize);
+ }
+ }
+
+ private static function prepareSortVectorValues(array $sortVector): array
+ {
+ // Strings should be sorted case-insensitive; with booleans converted to locale-strings
+ return array_map(
+ function ($value) {
+ if (is_bool($value)) {
+ return ($value) ? Calculation::getTRUE() : Calculation::getFALSE();
+ } elseif (is_string($value)) {
+ return StringHelper::strToLower($value);
+ }
+
+ return $value;
+ },
+ $sortVector
+ );
+ }
+
+ /**
+ * @param array[] $sortIndex
+ * @param int[] $sortOrder
+ */
+ private static function processSortBy(array $sortArray, array $sortIndex, array $sortOrder): array
+ {
+ $sortArguments = [];
+ $sortData = [];
+ foreach ($sortIndex as $index => $sortValues) {
+ $sortData[] = $sortValues;
+ $sortArguments[] = self::prepareSortVectorValues($sortValues);
+ $sortArguments[] = $sortOrder[$index] === self::ORDER_ASCENDING ? SORT_ASC : SORT_DESC;
+ }
+
+ $sortVector = self::executeVectorSortQuery($sortData, $sortArguments);
+
+ return self::sortLookupArrayFromVector($sortArray, $sortVector);
+ }
+
+ /**
+ * @param int[] $sortIndex
+ * @param int[] $sortOrder
+ */
+ private static function sortByRow(array $sortArray, array $sortIndex, array $sortOrder): array
+ {
+ $sortVector = self::buildVectorForSort($sortArray, $sortIndex, $sortOrder);
+
+ return self::sortLookupArrayFromVector($sortArray, $sortVector);
+ }
+
+ /**
+ * @param int[] $sortIndex
+ * @param int[] $sortOrder
+ */
+ private static function sortByColumn(array $sortArray, array $sortIndex, array $sortOrder): array
+ {
+ $sortArray = Matrix::transpose($sortArray);
+ $result = self::sortByRow($sortArray, $sortIndex, $sortOrder);
+
+ return Matrix::transpose($result);
+ }
+
+ /**
+ * @param int[] $sortIndex
+ * @param int[] $sortOrder
+ */
+ private static function buildVectorForSort(array $sortArray, array $sortIndex, array $sortOrder): array
+ {
+ $sortArguments = [];
+ $sortData = [];
+ foreach ($sortIndex as $index => $sortIndexValue) {
+ $sortValues = array_column($sortArray, $sortIndexValue - 1);
+ $sortData[] = $sortValues;
+ $sortArguments[] = self::prepareSortVectorValues($sortValues);
+ $sortArguments[] = $sortOrder[$index] === self::ORDER_ASCENDING ? SORT_ASC : SORT_DESC;
+ }
+
+ $sortData = self::executeVectorSortQuery($sortData, $sortArguments);
+
+ return $sortData;
+ }
+
+ private static function executeVectorSortQuery(array $sortData, array $sortArguments): array
+ {
+ $sortData = Matrix::transpose($sortData);
+
+ // We need to set an index that can be retained, as array_multisort doesn't maintain numeric keys.
+ $sortDataIndexed = [];
+ foreach ($sortData as $key => $value) {
+ $sortDataIndexed[Coordinate::stringFromColumnIndex($key + 1)] = $value;
+ }
+ unset($sortData);
+
+ $sortArguments[] = &$sortDataIndexed;
+
+ array_multisort(...$sortArguments);
+
+ // After the sort, we restore the numeric keys that will now be in the correct, sorted order
+ $sortedData = [];
+ foreach (array_keys($sortDataIndexed) as $key) {
+ $sortedData[] = Coordinate::columnIndexFromString($key) - 1;
+ }
+
+ return $sortedData;
+ }
+
+ private static function sortLookupArrayFromVector(array $sortArray, array $sortVector): array
+ {
+ // Building a new array in the correct (sorted) order works; but may be memory heavy for larger arrays
+ $sortedArray = [];
+ foreach ($sortVector as $index) {
+ $sortedArray[] = $sortArray[$index];
+ }
+
+ return $sortedArray;
+
+// uksort(
+// $lookupArray,
+// function (int $a, int $b) use (array $sortVector) {
+// return $sortVector[$a] <=> $sortVector[$b];
+// }
+// );
+//
+// return $lookupArray;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Unique.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Unique.php
new file mode 100644
index 00000000..220be2d1
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/Unique.php
@@ -0,0 +1,131 @@
+ count($flattenedLookupVector, COUNT_RECURSIVE) + 1) {
+ // We're looking at a full column check (multiple rows)
+ $transpose = Matrix::transpose($lookupVector);
+ $result = self::uniqueByRow($transpose, $exactlyOnce);
+
+ return (is_array($result)) ? Matrix::transpose($result) : $result;
+ }
+
+ $result = self::countValuesCaseInsensitive($flattenedLookupVector);
+
+ if ($exactlyOnce === true) {
+ $result = self::exactlyOnceFilter($result);
+ }
+
+ if (count($result) === 0) {
+ return ExcelError::CALC();
+ }
+
+ $result = array_keys($result);
+
+ return $result;
+ }
+
+ private static function countValuesCaseInsensitive(array $caseSensitiveLookupValues): array
+ {
+ $caseInsensitiveCounts = array_count_values(
+ array_map(
+ fn (string $value): string => StringHelper::strToUpper($value),
+ $caseSensitiveLookupValues
+ )
+ );
+
+ $caseSensitiveCounts = [];
+ foreach ($caseInsensitiveCounts as $caseInsensitiveKey => $count) {
+ if (is_numeric($caseInsensitiveKey)) {
+ $caseSensitiveCounts[$caseInsensitiveKey] = $count;
+ } else {
+ foreach ($caseSensitiveLookupValues as $caseSensitiveValue) {
+ if ($caseInsensitiveKey === StringHelper::strToUpper($caseSensitiveValue)) {
+ $caseSensitiveCounts[$caseSensitiveValue] = $count;
+
+ break;
+ }
+ }
+ }
+ }
+
+ return $caseSensitiveCounts;
+ }
+
+ private static function exactlyOnceFilter(array $values): array
+ {
+ return array_filter(
+ $values,
+ fn ($value): bool => $value === 1
+ );
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/VLookup.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/VLookup.php
new file mode 100644
index 00000000..247074cf
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/LookupRef/VLookup.php
@@ -0,0 +1,117 @@
+getMessage();
+ }
+
+ $f = array_keys($lookupArray);
+ $firstRow = array_pop($f);
+ if ((!is_array($lookupArray[$firstRow])) || ($indexNumber > count($lookupArray[$firstRow]))) {
+ return ExcelError::REF();
+ }
+ $columnKeys = array_keys($lookupArray[$firstRow]);
+ $returnColumn = $columnKeys[--$indexNumber];
+ $firstColumn = array_shift($columnKeys) ?? 1;
+
+ if (!$notExactMatch) {
+ /** @var callable $callable */
+ $callable = [self::class, 'vlookupSort'];
+ uasort($lookupArray, $callable);
+ }
+
+ $rowNumber = self::vLookupSearch($lookupValue, $lookupArray, $firstColumn, $notExactMatch);
+
+ if ($rowNumber !== null) {
+ // return the appropriate value
+ return $lookupArray[$rowNumber][$returnColumn];
+ }
+
+ return ExcelError::NA();
+ }
+
+ private static function vlookupSort(array $a, array $b): int
+ {
+ reset($a);
+ $firstColumn = key($a);
+ $aLower = StringHelper::strToLower((string) $a[$firstColumn]);
+ $bLower = StringHelper::strToLower((string) $b[$firstColumn]);
+
+ if ($aLower == $bLower) {
+ return 0;
+ }
+
+ return ($aLower < $bLower) ? -1 : 1;
+ }
+
+ /**
+ * @param mixed $lookupValue The value that you want to match in lookup_array
+ * @param int|string $column
+ */
+ private static function vLookupSearch(mixed $lookupValue, array $lookupArray, $column, bool $notExactMatch): ?int
+ {
+ $lookupLower = StringHelper::strToLower((string) $lookupValue);
+
+ $rowNumber = null;
+ foreach ($lookupArray as $rowKey => $rowData) {
+ $bothNumeric = is_numeric($lookupValue) && is_numeric($rowData[$column]);
+ $bothNotNumeric = !is_numeric($lookupValue) && !is_numeric($rowData[$column]);
+ $cellDataLower = StringHelper::strToLower((string) $rowData[$column]);
+
+ // break if we have passed possible keys
+ if (
+ $notExactMatch
+ && (($bothNumeric && ($rowData[$column] > $lookupValue))
+ || ($bothNotNumeric && ($cellDataLower > $lookupLower)))
+ ) {
+ break;
+ }
+
+ $rowNumber = self::checkMatch(
+ $bothNumeric,
+ $bothNotNumeric,
+ $notExactMatch,
+ $rowKey,
+ $cellDataLower,
+ $lookupLower,
+ $rowNumber
+ );
+ }
+
+ return $rowNumber;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Absolute.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Absolute.php
new file mode 100644
index 00000000..03e61399
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Absolute.php
@@ -0,0 +1,37 @@
+getMessage();
+ }
+
+ return abs($number);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Angle.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Angle.php
new file mode 100644
index 00000000..e7de7aac
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Angle.php
@@ -0,0 +1,63 @@
+getMessage();
+ }
+
+ return rad2deg($number);
+ }
+
+ /**
+ * RADIANS.
+ *
+ * Returns the result of builtin function deg2rad after validating args.
+ *
+ * @param mixed $number Should be numeric, or can be an array of numbers
+ *
+ * @return array|float|string Rounded number
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function toRadians(mixed $number): array|string|float
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return deg2rad($number);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Arabic.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Arabic.php
new file mode 100644
index 00000000..98c3e3dc
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Arabic.php
@@ -0,0 +1,92 @@
+ 1000,
+ 'D' => 500,
+ 'C' => 100,
+ 'L' => 50,
+ 'X' => 10,
+ 'V' => 5,
+ 'I' => 1,
+ ];
+
+ /**
+ * Recursively calculate the arabic value of a roman numeral.
+ */
+ private static function calculateArabic(array $roman, int &$sum = 0, int $subtract = 0): int
+ {
+ $numeral = array_shift($roman);
+ if (!isset(self::ROMAN_LOOKUP[$numeral])) {
+ throw new Exception('Invalid character detected');
+ }
+
+ $arabic = self::ROMAN_LOOKUP[$numeral];
+ if (count($roman) > 0 && isset(self::ROMAN_LOOKUP[$roman[0]]) && $arabic < self::ROMAN_LOOKUP[$roman[0]]) {
+ $subtract += $arabic;
+ } else {
+ $sum += ($arabic - $subtract);
+ $subtract = 0;
+ }
+
+ if (count($roman) > 0) {
+ self::calculateArabic($roman, $sum, $subtract);
+ }
+
+ return $sum;
+ }
+
+ /**
+ * ARABIC.
+ *
+ * Converts a Roman numeral to an Arabic numeral.
+ *
+ * Excel Function:
+ * ARABIC(text)
+ *
+ * @param string|string[] $roman Should be a string, or can be an array of strings
+ *
+ * @return array|int|string the arabic numberal contrived from the roman numeral
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function evaluate(mixed $roman): array|int|string
+ {
+ if (is_array($roman)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $roman);
+ }
+
+ // An empty string should return 0
+ $roman = substr(trim(strtoupper((string) $roman)), 0, 255);
+ if ($roman === '') {
+ return 0;
+ }
+
+ // Convert the roman numeral to an arabic number
+ $negativeNumber = $roman[0] === '-';
+ if ($negativeNumber) {
+ $roman = substr($roman, 1);
+ }
+
+ try {
+ $arabic = self::calculateArabic(str_split($roman));
+ } catch (Exception) {
+ return ExcelError::VALUE(); // Invalid character detected
+ }
+
+ if ($negativeNumber) {
+ $arabic *= -1; // The number should be negative
+ }
+
+ return $arabic;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Base.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Base.php
new file mode 100644
index 00000000..7eda72c3
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Base.php
@@ -0,0 +1,65 @@
+getMessage();
+ }
+
+ return self::calculate($number, $radix, $minLength);
+ }
+
+ private static function calculate(float $number, int $radix, mixed $minLength): string
+ {
+ if ($minLength === null || is_numeric($minLength)) {
+ if ($number < 0 || $number >= 2 ** 53 || $radix < 2 || $radix > 36) {
+ return ExcelError::NAN(); // Numeric range constraints
+ }
+
+ $outcome = strtoupper((string) base_convert("$number", 10, $radix));
+ if ($minLength !== null) {
+ $outcome = str_pad($outcome, (int) $minLength, '0', STR_PAD_LEFT); // String padding
+ }
+
+ return $outcome;
+ }
+
+ return ExcelError::VALUE();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Ceiling.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Ceiling.php
new file mode 100644
index 00000000..365ec2e9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Ceiling.php
@@ -0,0 +1,165 @@
+getMessage();
+ }
+
+ return self::argumentsOk((float) $number, (float) $significance);
+ }
+
+ /**
+ * CEILING.MATH.
+ *
+ * Round a number down to the nearest integer or to the nearest multiple of significance.
+ *
+ * Excel Function:
+ * CEILING.MATH(number[,significance[,mode]])
+ *
+ * @param mixed $number Number to round
+ * Or can be an array of values
+ * @param mixed $significance Significance
+ * Or can be an array of values
+ * @param array|int $mode direction to round negative numbers
+ * Or can be an array of values
+ *
+ * @return array|float|string Rounded Number, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function math(mixed $number, mixed $significance = null, $mode = 0): array|string|float
+ {
+ if (is_array($number) || is_array($significance) || is_array($mode)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $significance, $mode);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ $significance = Helpers::validateNumericNullSubstitution($significance, ($number < 0) ? -1 : 1);
+ $mode = Helpers::validateNumericNullSubstitution($mode, null);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if (empty($significance * $number)) {
+ return 0.0;
+ }
+ if (self::ceilingMathTest((float) $significance, (float) $number, (int) $mode)) {
+ return floor($number / $significance) * $significance;
+ }
+
+ return ceil($number / $significance) * $significance;
+ }
+
+ /**
+ * CEILING.PRECISE.
+ *
+ * Rounds number up, away from zero, to the nearest multiple of significance.
+ *
+ * Excel Function:
+ * CEILING.PRECISE(number[,significance])
+ *
+ * @param mixed $number the number you want to round
+ * Or can be an array of values
+ * @param array|float $significance the multiple to which you want to round
+ * Or can be an array of values
+ *
+ * @return array|float|string Rounded Number, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function precise(mixed $number, $significance = 1): array|string|float
+ {
+ if (is_array($number) || is_array($significance)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $significance);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ $significance = Helpers::validateNumericNullSubstitution($significance, null);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if (!$significance) {
+ return 0.0;
+ }
+ $result = $number / abs($significance);
+
+ return ceil($result) * $significance * (($significance < 0) ? -1 : 1);
+ }
+
+ /**
+ * Let CEILINGMATH complexity pass Scrutinizer.
+ */
+ private static function ceilingMathTest(float $significance, float $number, int $mode): bool
+ {
+ return ($significance < 0) || ($number < 0 && !empty($mode));
+ }
+
+ /**
+ * Avoid Scrutinizer problems concerning complexity.
+ */
+ private static function argumentsOk(float $number, float $significance): float|string
+ {
+ if (empty($number * $significance)) {
+ return 0.0;
+ }
+ if (Helpers::returnSign($number) == Helpers::returnSign($significance)) {
+ return ceil($number / $significance) * $significance;
+ }
+
+ return ExcelError::NAN();
+ }
+
+ private static function floorCheck1Arg(): void
+ {
+ $compatibility = Functions::getCompatibilityMode();
+ if ($compatibility === Functions::COMPATIBILITY_EXCEL) {
+ throw new Exception('Excel requires 2 arguments for CEILING');
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Combinations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Combinations.php
new file mode 100644
index 00000000..99eb05a5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Combinations.php
@@ -0,0 +1,103 @@
+getMessage();
+ }
+
+ /** @var float */
+ $quotient = Factorial::fact($numObjs);
+ /** @var float */
+ $divisor1 = Factorial::fact($numObjs - $numInSet);
+ /** @var float */
+ $divisor2 = Factorial::fact($numInSet);
+
+ return round($quotient / ($divisor1 * $divisor2));
+ }
+
+ /**
+ * COMBINA.
+ *
+ * Returns the number of combinations for a given number of items. Use COMBIN to
+ * determine the total possible number of groups for a given number of items.
+ *
+ * Excel Function:
+ * COMBINA(numObjs,numInSet)
+ *
+ * @param mixed $numObjs Number of different objects, or can be an array of numbers
+ * @param mixed $numInSet Number of objects in each combination, or can be an array of numbers
+ *
+ * @return array|float|int|string Number of combinations, or a string containing an error
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function withRepetition(mixed $numObjs, mixed $numInSet): array|int|string|float
+ {
+ if (is_array($numObjs) || is_array($numInSet)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $numObjs, $numInSet);
+ }
+
+ try {
+ $numObjs = Helpers::validateNumericNullSubstitution($numObjs, null);
+ $numInSet = Helpers::validateNumericNullSubstitution($numInSet, null);
+ Helpers::validateNotNegative($numInSet);
+ Helpers::validateNotNegative($numObjs);
+ $numObjs = (int) $numObjs;
+ $numInSet = (int) $numInSet;
+ // Microsoft documentation says following is true, but Excel
+ // does not enforce this restriction.
+ //Helpers::validateNotNegative($numObjs - $numInSet);
+ if ($numObjs === 0) {
+ Helpers::validateNotNegative(-$numInSet);
+
+ return 1;
+ }
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ /** @var float */
+ $quotient = Factorial::fact($numObjs + $numInSet - 1);
+ /** @var float */
+ $divisor1 = Factorial::fact($numObjs - 1);
+ /** @var float */
+ $divisor2 = Factorial::fact($numInSet);
+
+ return round($quotient / ($divisor1 * $divisor2));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Exp.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Exp.php
new file mode 100644
index 00000000..ea67d5fd
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Exp.php
@@ -0,0 +1,37 @@
+getMessage();
+ }
+
+ return exp($number);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Factorial.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Factorial.php
new file mode 100644
index 00000000..7bbd4d8b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Factorial.php
@@ -0,0 +1,126 @@
+getMessage();
+ }
+
+ $factLoop = floor($factVal);
+ if ($factVal > $factLoop) {
+ if (Functions::getCompatibilityMode() == Functions::COMPATIBILITY_GNUMERIC) {
+ return Statistical\Distributions\Gamma::gammaValue($factVal + 1);
+ }
+ }
+
+ $factorial = 1;
+ while ($factLoop > 1) {
+ $factorial *= $factLoop--;
+ }
+
+ return $factorial;
+ }
+
+ /**
+ * FACTDOUBLE.
+ *
+ * Returns the double factorial of a number.
+ *
+ * Excel Function:
+ * FACTDOUBLE(factVal)
+ *
+ * @param array|float $factVal Factorial Value, or can be an array of numbers
+ *
+ * @return array|float|int|string Double Factorial, or a string containing an error
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function factDouble($factVal): array|string|float|int
+ {
+ if (is_array($factVal)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $factVal);
+ }
+
+ try {
+ $factVal = Helpers::validateNumericNullSubstitution($factVal, 0);
+ Helpers::validateNotNegative($factVal);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $factLoop = floor($factVal);
+ $factorial = 1;
+ while ($factLoop > 1) {
+ $factorial *= $factLoop;
+ $factLoop -= 2;
+ }
+
+ return $factorial;
+ }
+
+ /**
+ * MULTINOMIAL.
+ *
+ * Returns the ratio of the factorial of a sum of values to the product of factorials.
+ *
+ * @param mixed[] $args An array of mixed values for the Data Series
+ *
+ * @return float|int|string The result, or a string containing an error
+ */
+ public static function multinomial(...$args): string|int|float
+ {
+ $summer = 0;
+ $divisor = 1;
+
+ try {
+ // Loop through arguments
+ foreach (Functions::flattenArray($args) as $argx) {
+ $arg = Helpers::validateNumericNullSubstitution($argx, null);
+ Helpers::validateNotNegative($arg);
+ $arg = (int) $arg;
+ $summer += $arg;
+ $divisor *= self::fact($arg);
+ }
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $summer = self::fact($summer);
+
+ return is_numeric($summer) ? ($summer / $divisor) : ExcelError::VALUE();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Floor.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Floor.php
new file mode 100644
index 00000000..83cf0515
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Floor.php
@@ -0,0 +1,191 @@
+getMessage();
+ }
+
+ return self::argumentsOk((float) $number, (float) $significance);
+ }
+
+ /**
+ * FLOOR.MATH.
+ *
+ * Round a number down to the nearest integer or to the nearest multiple of significance.
+ *
+ * Excel Function:
+ * FLOOR.MATH(number[,significance[,mode]])
+ *
+ * @param mixed $number Number to round
+ * Or can be an array of values
+ * @param mixed $significance Significance
+ * Or can be an array of values
+ * @param mixed $mode direction to round negative numbers
+ * Or can be an array of values
+ *
+ * @return array|float|string Rounded Number, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function math(mixed $number, mixed $significance = null, mixed $mode = 0)
+ {
+ if (is_array($number) || is_array($significance) || is_array($mode)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $significance, $mode);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ $significance = Helpers::validateNumericNullSubstitution($significance, ($number < 0) ? -1 : 1);
+ $mode = Helpers::validateNumericNullSubstitution($mode, null);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return self::argsOk((float) $number, (float) $significance, (int) $mode);
+ }
+
+ /**
+ * FLOOR.PRECISE.
+ *
+ * Rounds number down, toward zero, to the nearest multiple of significance.
+ *
+ * Excel Function:
+ * FLOOR.PRECISE(number[,significance])
+ *
+ * @param array|float $number Number to round
+ * Or can be an array of values
+ * @param array|float $significance Significance
+ * Or can be an array of values
+ *
+ * @return array|float|string Rounded Number, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function precise($number, $significance = 1)
+ {
+ if (is_array($number) || is_array($significance)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $significance);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ $significance = Helpers::validateNumericNullSubstitution($significance, null);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return self::argumentsOkPrecise((float) $number, (float) $significance);
+ }
+
+ /**
+ * Avoid Scrutinizer problems concerning complexity.
+ */
+ private static function argumentsOkPrecise(float $number, float $significance): string|float
+ {
+ if ($significance == 0.0) {
+ return ExcelError::DIV0();
+ }
+ if ($number == 0.0) {
+ return 0.0;
+ }
+
+ return floor($number / abs($significance)) * abs($significance);
+ }
+
+ /**
+ * Avoid Scrutinizer complexity problems.
+ *
+ * @return float|string Rounded Number, or a string containing an error
+ */
+ private static function argsOk(float $number, float $significance, int $mode): string|float
+ {
+ if (!$significance) {
+ return ExcelError::DIV0();
+ }
+ if (!$number) {
+ return 0.0;
+ }
+ if (self::floorMathTest($number, $significance, $mode)) {
+ return ceil($number / $significance) * $significance;
+ }
+
+ return floor($number / $significance) * $significance;
+ }
+
+ /**
+ * Let FLOORMATH complexity pass Scrutinizer.
+ */
+ private static function floorMathTest(float $number, float $significance, int $mode): bool
+ {
+ return Helpers::returnSign($significance) == -1 || (Helpers::returnSign($number) == -1 && !empty($mode));
+ }
+
+ /**
+ * Avoid Scrutinizer problems concerning complexity.
+ */
+ private static function argumentsOk(float $number, float $significance): string|float
+ {
+ if ($significance == 0.0) {
+ return ExcelError::DIV0();
+ }
+ if ($number == 0.0) {
+ return 0.0;
+ }
+ if (Helpers::returnSign($significance) == 1) {
+ return floor($number / $significance) * $significance;
+ }
+ if (Helpers::returnSign($number) == -1 && Helpers::returnSign($significance) == -1) {
+ return floor($number / $significance) * $significance;
+ }
+
+ return ExcelError::NAN();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Gcd.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Gcd.php
new file mode 100644
index 00000000..f2aedb60
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Gcd.php
@@ -0,0 +1,65 @@
+getMessage();
+ }
+
+ if (count($arrayArgs) <= 0) {
+ return ExcelError::VALUE();
+ }
+ $gcd = (int) array_pop($arrayArgs);
+ do {
+ $gcd = self::evaluateGCD($gcd, (int) array_pop($arrayArgs));
+ } while (!empty($arrayArgs));
+
+ return $gcd;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Helpers.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Helpers.php
new file mode 100644
index 00000000..57e05b19
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Helpers.php
@@ -0,0 +1,111 @@
+= 0.
+ */
+ public static function validateNotNegative(float|int $number, ?string $except = null): void
+ {
+ if ($number >= 0) {
+ return;
+ }
+
+ throw new Exception($except ?? ExcelError::NAN());
+ }
+
+ /**
+ * Confirm number > 0.
+ */
+ public static function validatePositive(float|int $number, ?string $except = null): void
+ {
+ if ($number > 0) {
+ return;
+ }
+
+ throw new Exception($except ?? ExcelError::NAN());
+ }
+
+ /**
+ * Confirm number != 0.
+ */
+ public static function validateNotZero(float|int $number): void
+ {
+ if ($number) {
+ return;
+ }
+
+ throw new Exception(ExcelError::DIV0());
+ }
+
+ public static function returnSign(float $number): int
+ {
+ return $number ? (($number > 0) ? 1 : -1) : 0;
+ }
+
+ public static function getEven(float $number): float
+ {
+ $significance = 2 * self::returnSign($number);
+
+ return $significance ? (ceil($number / $significance) * $significance) : 0;
+ }
+
+ /**
+ * Return NAN or value depending on argument.
+ */
+ public static function numberOrNan(float $result): float|string
+ {
+ return is_nan($result) ? ExcelError::NAN() : $result;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/IntClass.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/IntClass.php
new file mode 100644
index 00000000..76bbced8
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/IntClass.php
@@ -0,0 +1,40 @@
+getMessage();
+ }
+
+ return (int) floor($number);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Lcm.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Lcm.php
new file mode 100644
index 00000000..979b6df2
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Lcm.php
@@ -0,0 +1,111 @@
+ 1; --$i) {
+ if (($value % $i) == 0) {
+ $factorArray = array_merge($factorArray, self::factors($value / $i));
+ $factorArray = array_merge($factorArray, self::factors($i));
+ if ($i <= sqrt($value)) {
+ break;
+ }
+ }
+ }
+ if (!empty($factorArray)) {
+ rsort($factorArray);
+
+ return $factorArray;
+ }
+
+ return [(int) $value];
+ }
+
+ /**
+ * LCM.
+ *
+ * Returns the lowest common multiplier of a series of numbers
+ * The least common multiple is the smallest positive integer that is a multiple
+ * of all integer arguments number1, number2, and so on. Use LCM to add fractions
+ * with different denominators.
+ *
+ * Excel Function:
+ * LCM(number1[,number2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ *
+ * @return int|string Lowest Common Multiplier, or a string containing an error
+ */
+ public static function evaluate(mixed ...$args): int|string
+ {
+ try {
+ $arrayArgs = [];
+ $anyZeros = 0;
+ $anyNonNulls = 0;
+ foreach (Functions::flattenArray($args) as $value1) {
+ $anyNonNulls += (int) ($value1 !== null);
+ $value = Helpers::validateNumericNullSubstitution($value1, 1);
+ Helpers::validateNotNegative($value);
+ $arrayArgs[] = (int) $value;
+ $anyZeros += (int) !((bool) $value);
+ }
+ self::testNonNulls($anyNonNulls);
+ if ($anyZeros) {
+ return 0;
+ }
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $returnValue = 1;
+ $allPoweredFactors = [];
+ // Loop through arguments
+ foreach ($arrayArgs as $value) {
+ $myFactors = self::factors(floor($value));
+ $myCountedFactors = array_count_values($myFactors);
+ $myPoweredFactors = [];
+ foreach ($myCountedFactors as $myCountedFactor => $myCountedPower) {
+ $myPoweredFactors[$myCountedFactor] = $myCountedFactor ** $myCountedPower;
+ }
+ self::processPoweredFactors($allPoweredFactors, $myPoweredFactors);
+ }
+ foreach ($allPoweredFactors as $allPoweredFactor) {
+ $returnValue *= (int) $allPoweredFactor;
+ }
+
+ return $returnValue;
+ }
+
+ private static function processPoweredFactors(array &$allPoweredFactors, array &$myPoweredFactors): void
+ {
+ foreach ($myPoweredFactors as $myPoweredValue => $myPoweredFactor) {
+ if (isset($allPoweredFactors[$myPoweredValue])) {
+ if ($allPoweredFactors[$myPoweredValue] < $myPoweredFactor) {
+ $allPoweredFactors[$myPoweredValue] = $myPoweredFactor;
+ }
+ } else {
+ $allPoweredFactors[$myPoweredValue] = $myPoweredFactor;
+ }
+ }
+ }
+
+ private static function testNonNulls(int $anyNonNulls): void
+ {
+ if (!$anyNonNulls) {
+ throw new Exception(ExcelError::VALUE());
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Logarithms.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Logarithms.php
new file mode 100644
index 00000000..3de0a2bb
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Logarithms.php
@@ -0,0 +1,102 @@
+getMessage();
+ }
+
+ return log($number, $base);
+ }
+
+ /**
+ * LOG10.
+ *
+ * Returns the result of builtin function log after validating args.
+ *
+ * @param mixed $number Should be numeric
+ * Or can be an array of values
+ *
+ * @return array|float|string Rounded number
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function base10(mixed $number): array|string|float
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ Helpers::validatePositive($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return log10($number);
+ }
+
+ /**
+ * LN.
+ *
+ * Returns the result of builtin function log after validating args.
+ *
+ * @param mixed $number Should be numeric
+ * Or can be an array of values
+ *
+ * @return array|float|string Rounded number
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function natural(mixed $number): array|string|float
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ Helpers::validatePositive($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return log($number);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/MatrixFunctions.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/MatrixFunctions.php
new file mode 100644
index 00000000..fad01086
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/MatrixFunctions.php
@@ -0,0 +1,179 @@
+getMessage();
+ }
+
+ if ($step === 0) {
+ return array_chunk(
+ array_fill(0, $rows * $columns, $start),
+ max($columns, 1)
+ );
+ }
+
+ return array_chunk(
+ range($start, $start + (($rows * $columns - 1) * $step), $step),
+ max($columns, 1)
+ );
+ }
+
+ /**
+ * MDETERM.
+ *
+ * Returns the matrix determinant of an array.
+ *
+ * Excel Function:
+ * MDETERM(array)
+ *
+ * @param mixed $matrixValues A matrix of values
+ *
+ * @return float|string The result, or a string containing an error
+ */
+ public static function determinant(mixed $matrixValues)
+ {
+ try {
+ $matrix = self::getMatrix($matrixValues);
+
+ return $matrix->determinant();
+ } catch (MatrixException) {
+ return ExcelError::VALUE();
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+ }
+
+ /**
+ * MINVERSE.
+ *
+ * Returns the inverse matrix for the matrix stored in an array.
+ *
+ * Excel Function:
+ * MINVERSE(array)
+ *
+ * @param mixed $matrixValues A matrix of values
+ *
+ * @return array|string The result, or a string containing an error
+ */
+ public static function inverse(mixed $matrixValues): array|string
+ {
+ try {
+ $matrix = self::getMatrix($matrixValues);
+
+ return $matrix->inverse()->toArray();
+ } catch (MatrixDiv0Exception) {
+ return ExcelError::NAN();
+ } catch (MatrixException) {
+ return ExcelError::VALUE();
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+ }
+
+ /**
+ * MMULT.
+ *
+ * @param mixed $matrixData1 A matrix of values
+ * @param mixed $matrixData2 A matrix of values
+ *
+ * @return array|string The result, or a string containing an error
+ */
+ public static function multiply(mixed $matrixData1, mixed $matrixData2): array|string
+ {
+ try {
+ $matrixA = self::getMatrix($matrixData1);
+ $matrixB = self::getMatrix($matrixData2);
+
+ return $matrixA->multiply($matrixB)->toArray();
+ } catch (MatrixException) {
+ return ExcelError::VALUE();
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+ }
+
+ /**
+ * MUnit.
+ *
+ * @param mixed $dimension Number of rows and columns
+ *
+ * @return array|string The result, or a string containing an error
+ */
+ public static function identity(mixed $dimension)
+ {
+ try {
+ $dimension = (int) Helpers::validateNumericNullBool($dimension);
+ Helpers::validatePositive($dimension, ExcelError::VALUE());
+ $matrix = Builder::createIdentityMatrix($dimension, 0)->toArray();
+
+ return $matrix;
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Operations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Operations.php
new file mode 100644
index 00000000..0eca549b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Operations.php
@@ -0,0 +1,155 @@
+getMessage();
+ }
+
+ if (($dividend < 0.0) && ($divisor > 0.0)) {
+ return $divisor - fmod(abs($dividend), $divisor);
+ }
+ if (($dividend > 0.0) && ($divisor < 0.0)) {
+ return $divisor + fmod($dividend, abs($divisor));
+ }
+
+ return fmod($dividend, $divisor);
+ }
+
+ /**
+ * POWER.
+ *
+ * Computes x raised to the power y.
+ *
+ * @param null|array|bool|float|int|string $x Or can be an array of values
+ * @param null|array|bool|float|int|string $y Or can be an array of values
+ *
+ * @return array|float|int|string The result, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function power(null|array|bool|float|int|string $x, null|array|bool|float|int|string $y): array|float|int|string
+ {
+ if (is_array($x) || is_array($y)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $x, $y);
+ }
+
+ try {
+ $x = Helpers::validateNumericNullBool($x);
+ $y = Helpers::validateNumericNullBool($y);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Validate parameters
+ if (!$x && !$y) {
+ return ExcelError::NAN();
+ }
+ if (!$x && $y < 0.0) {
+ return ExcelError::DIV0();
+ }
+
+ // Return
+ $result = $x ** $y;
+
+ return Helpers::numberOrNan($result);
+ }
+
+ /**
+ * PRODUCT.
+ *
+ * PRODUCT returns the product of all the values and cells referenced in the argument list.
+ *
+ * Excel Function:
+ * PRODUCT(value1[,value2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ */
+ public static function product(mixed ...$args): string|float
+ {
+ $args = array_filter(
+ Functions::flattenArray($args),
+ fn ($value): bool => $value !== null
+ );
+
+ // Return value
+ $returnValue = (count($args) === 0) ? 0.0 : 1.0;
+
+ // Loop through arguments
+ foreach ($args as $arg) {
+ // Is it a numeric value?
+ if (is_numeric($arg)) {
+ $returnValue *= $arg;
+ } else {
+ return ExcelError::throwError($arg);
+ }
+ }
+
+ return (float) $returnValue;
+ }
+
+ /**
+ * QUOTIENT.
+ *
+ * QUOTIENT function returns the integer portion of a division. Numerator is the divided number
+ * and denominator is the divisor.
+ *
+ * Excel Function:
+ * QUOTIENT(value1,value2)
+ *
+ * @param mixed $numerator Expect float|int
+ * Or can be an array of values
+ * @param mixed $denominator Expect float|int
+ * Or can be an array of values
+ *
+ * @return array|int|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function quotient(mixed $numerator, mixed $denominator): array|string|int
+ {
+ if (is_array($numerator) || is_array($denominator)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $numerator, $denominator);
+ }
+
+ try {
+ $numerator = Helpers::validateNumericNullSubstitution($numerator, 0);
+ $denominator = Helpers::validateNumericNullSubstitution($denominator, 0);
+ Helpers::validateNotZero($denominator);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return (int) ($numerator / $denominator);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Random.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Random.php
new file mode 100644
index 00000000..5d351677
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Random.php
@@ -0,0 +1,99 @@
+getMessage();
+ }
+
+ return mt_rand($min, $max);
+ }
+
+ /**
+ * RANDARRAY.
+ *
+ * Generates a list of sequential numbers in an array.
+ *
+ * Excel Function:
+ * RANDARRAY([rows],[columns],[start],[step])
+ *
+ * @param mixed $rows the number of rows to return, defaults to 1
+ * @param mixed $columns the number of columns to return, defaults to 1
+ * @param mixed $min the minimum number to be returned, defaults to 0
+ * @param mixed $max the maximum number to be returned, defaults to 1
+ * @param bool $wholeNumber the type of numbers to return:
+ * False - Decimal numbers to 15 decimal places. (default)
+ * True - Whole (integer) numbers
+ *
+ * @return array|string The resulting array, or a string containing an error
+ */
+ public static function randArray(mixed $rows = 1, mixed $columns = 1, mixed $min = 0, mixed $max = 1, bool $wholeNumber = false): string|array
+ {
+ try {
+ $rows = (int) Helpers::validateNumericNullSubstitution($rows, 1);
+ Helpers::validatePositive($rows);
+ $columns = (int) Helpers::validateNumericNullSubstitution($columns, 1);
+ Helpers::validatePositive($columns);
+ $min = Helpers::validateNumericNullSubstitution($min, 1);
+ $max = Helpers::validateNumericNullSubstitution($max, 1);
+
+ if ($max <= $min) {
+ return ExcelError::VALUE();
+ }
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return array_chunk(
+ array_map(
+ function () use ($min, $max, $wholeNumber): int|float {
+ return $wholeNumber
+ ? mt_rand((int) $min, (int) $max)
+ : (mt_rand() / mt_getrandmax()) * ($max - $min) + $min;
+ },
+ array_fill(0, $rows * $columns, $min)
+ ),
+ max($columns, 1)
+ );
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Roman.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Roman.php
new file mode 100644
index 00000000..7c6f8e78
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Roman.php
@@ -0,0 +1,846 @@
+ ['VL'],
+ 46 => ['VLI'],
+ 47 => ['VLII'],
+ 48 => ['VLIII'],
+ 49 => ['VLIV', 'IL'],
+ 95 => ['VC'],
+ 96 => ['VCI'],
+ 97 => ['VCII'],
+ 98 => ['VCIII'],
+ 99 => ['VCIV', 'IC'],
+ 145 => ['CVL'],
+ 146 => ['CVLI'],
+ 147 => ['CVLII'],
+ 148 => ['CVLIII'],
+ 149 => ['CVLIV', 'CIL'],
+ 195 => ['CVC'],
+ 196 => ['CVCI'],
+ 197 => ['CVCII'],
+ 198 => ['CVCIII'],
+ 199 => ['CVCIV', 'CIC'],
+ 245 => ['CCVL'],
+ 246 => ['CCVLI'],
+ 247 => ['CCVLII'],
+ 248 => ['CCVLIII'],
+ 249 => ['CCVLIV', 'CCIL'],
+ 295 => ['CCVC'],
+ 296 => ['CCVCI'],
+ 297 => ['CCVCII'],
+ 298 => ['CCVCIII'],
+ 299 => ['CCVCIV', 'CCIC'],
+ 345 => ['CCCVL'],
+ 346 => ['CCCVLI'],
+ 347 => ['CCCVLII'],
+ 348 => ['CCCVLIII'],
+ 349 => ['CCCVLIV', 'CCCIL'],
+ 395 => ['CCCVC'],
+ 396 => ['CCCVCI'],
+ 397 => ['CCCVCII'],
+ 398 => ['CCCVCIII'],
+ 399 => ['CCCVCIV', 'CCCIC'],
+ 445 => ['CDVL'],
+ 446 => ['CDVLI'],
+ 447 => ['CDVLII'],
+ 448 => ['CDVLIII'],
+ 449 => ['CDVLIV', 'CDIL'],
+ 450 => ['LD'],
+ 451 => ['LDI'],
+ 452 => ['LDII'],
+ 453 => ['LDIII'],
+ 454 => ['LDIV'],
+ 455 => ['LDV'],
+ 456 => ['LDVI'],
+ 457 => ['LDVII'],
+ 458 => ['LDVIII'],
+ 459 => ['LDIX'],
+ 460 => ['LDX'],
+ 461 => ['LDXI'],
+ 462 => ['LDXII'],
+ 463 => ['LDXIII'],
+ 464 => ['LDXIV'],
+ 465 => ['LDXV'],
+ 466 => ['LDXVI'],
+ 467 => ['LDXVII'],
+ 468 => ['LDXVIII'],
+ 469 => ['LDXIX'],
+ 470 => ['LDXX'],
+ 471 => ['LDXXI'],
+ 472 => ['LDXXII'],
+ 473 => ['LDXXIII'],
+ 474 => ['LDXXIV'],
+ 475 => ['LDXXV'],
+ 476 => ['LDXXVI'],
+ 477 => ['LDXXVII'],
+ 478 => ['LDXXVIII'],
+ 479 => ['LDXXIX'],
+ 480 => ['LDXXX'],
+ 481 => ['LDXXXI'],
+ 482 => ['LDXXXII'],
+ 483 => ['LDXXXIII'],
+ 484 => ['LDXXXIV'],
+ 485 => ['LDXXXV'],
+ 486 => ['LDXXXVI'],
+ 487 => ['LDXXXVII'],
+ 488 => ['LDXXXVIII'],
+ 489 => ['LDXXXIX'],
+ 490 => ['LDXL', 'XD'],
+ 491 => ['LDXLI', 'XDI'],
+ 492 => ['LDXLII', 'XDII'],
+ 493 => ['LDXLIII', 'XDIII'],
+ 494 => ['LDXLIV', 'XDIV'],
+ 495 => ['LDVL', 'XDV', 'VD'],
+ 496 => ['LDVLI', 'XDVI', 'VDI'],
+ 497 => ['LDVLII', 'XDVII', 'VDII'],
+ 498 => ['LDVLIII', 'XDVIII', 'VDIII'],
+ 499 => ['LDVLIV', 'XDIX', 'VDIV', 'ID'],
+ 545 => ['DVL'],
+ 546 => ['DVLI'],
+ 547 => ['DVLII'],
+ 548 => ['DVLIII'],
+ 549 => ['DVLIV', 'DIL'],
+ 595 => ['DVC'],
+ 596 => ['DVCI'],
+ 597 => ['DVCII'],
+ 598 => ['DVCIII'],
+ 599 => ['DVCIV', 'DIC'],
+ 645 => ['DCVL'],
+ 646 => ['DCVLI'],
+ 647 => ['DCVLII'],
+ 648 => ['DCVLIII'],
+ 649 => ['DCVLIV', 'DCIL'],
+ 695 => ['DCVC'],
+ 696 => ['DCVCI'],
+ 697 => ['DCVCII'],
+ 698 => ['DCVCIII'],
+ 699 => ['DCVCIV', 'DCIC'],
+ 745 => ['DCCVL'],
+ 746 => ['DCCVLI'],
+ 747 => ['DCCVLII'],
+ 748 => ['DCCVLIII'],
+ 749 => ['DCCVLIV', 'DCCIL'],
+ 795 => ['DCCVC'],
+ 796 => ['DCCVCI'],
+ 797 => ['DCCVCII'],
+ 798 => ['DCCVCIII'],
+ 799 => ['DCCVCIV', 'DCCIC'],
+ 845 => ['DCCCVL'],
+ 846 => ['DCCCVLI'],
+ 847 => ['DCCCVLII'],
+ 848 => ['DCCCVLIII'],
+ 849 => ['DCCCVLIV', 'DCCCIL'],
+ 895 => ['DCCCVC'],
+ 896 => ['DCCCVCI'],
+ 897 => ['DCCCVCII'],
+ 898 => ['DCCCVCIII'],
+ 899 => ['DCCCVCIV', 'DCCCIC'],
+ 945 => ['CMVL'],
+ 946 => ['CMVLI'],
+ 947 => ['CMVLII'],
+ 948 => ['CMVLIII'],
+ 949 => ['CMVLIV', 'CMIL'],
+ 950 => ['LM'],
+ 951 => ['LMI'],
+ 952 => ['LMII'],
+ 953 => ['LMIII'],
+ 954 => ['LMIV'],
+ 955 => ['LMV'],
+ 956 => ['LMVI'],
+ 957 => ['LMVII'],
+ 958 => ['LMVIII'],
+ 959 => ['LMIX'],
+ 960 => ['LMX'],
+ 961 => ['LMXI'],
+ 962 => ['LMXII'],
+ 963 => ['LMXIII'],
+ 964 => ['LMXIV'],
+ 965 => ['LMXV'],
+ 966 => ['LMXVI'],
+ 967 => ['LMXVII'],
+ 968 => ['LMXVIII'],
+ 969 => ['LMXIX'],
+ 970 => ['LMXX'],
+ 971 => ['LMXXI'],
+ 972 => ['LMXXII'],
+ 973 => ['LMXXIII'],
+ 974 => ['LMXXIV'],
+ 975 => ['LMXXV'],
+ 976 => ['LMXXVI'],
+ 977 => ['LMXXVII'],
+ 978 => ['LMXXVIII'],
+ 979 => ['LMXXIX'],
+ 980 => ['LMXXX'],
+ 981 => ['LMXXXI'],
+ 982 => ['LMXXXII'],
+ 983 => ['LMXXXIII'],
+ 984 => ['LMXXXIV'],
+ 985 => ['LMXXXV'],
+ 986 => ['LMXXXVI'],
+ 987 => ['LMXXXVII'],
+ 988 => ['LMXXXVIII'],
+ 989 => ['LMXXXIX'],
+ 990 => ['LMXL', 'XM'],
+ 991 => ['LMXLI', 'XMI'],
+ 992 => ['LMXLII', 'XMII'],
+ 993 => ['LMXLIII', 'XMIII'],
+ 994 => ['LMXLIV', 'XMIV'],
+ 995 => ['LMVL', 'XMV', 'VM'],
+ 996 => ['LMVLI', 'XMVI', 'VMI'],
+ 997 => ['LMVLII', 'XMVII', 'VMII'],
+ 998 => ['LMVLIII', 'XMVIII', 'VMIII'],
+ 999 => ['LMVLIV', 'XMIX', 'VMIV', 'IM'],
+ 1045 => ['MVL'],
+ 1046 => ['MVLI'],
+ 1047 => ['MVLII'],
+ 1048 => ['MVLIII'],
+ 1049 => ['MVLIV', 'MIL'],
+ 1095 => ['MVC'],
+ 1096 => ['MVCI'],
+ 1097 => ['MVCII'],
+ 1098 => ['MVCIII'],
+ 1099 => ['MVCIV', 'MIC'],
+ 1145 => ['MCVL'],
+ 1146 => ['MCVLI'],
+ 1147 => ['MCVLII'],
+ 1148 => ['MCVLIII'],
+ 1149 => ['MCVLIV', 'MCIL'],
+ 1195 => ['MCVC'],
+ 1196 => ['MCVCI'],
+ 1197 => ['MCVCII'],
+ 1198 => ['MCVCIII'],
+ 1199 => ['MCVCIV', 'MCIC'],
+ 1245 => ['MCCVL'],
+ 1246 => ['MCCVLI'],
+ 1247 => ['MCCVLII'],
+ 1248 => ['MCCVLIII'],
+ 1249 => ['MCCVLIV', 'MCCIL'],
+ 1295 => ['MCCVC'],
+ 1296 => ['MCCVCI'],
+ 1297 => ['MCCVCII'],
+ 1298 => ['MCCVCIII'],
+ 1299 => ['MCCVCIV', 'MCCIC'],
+ 1345 => ['MCCCVL'],
+ 1346 => ['MCCCVLI'],
+ 1347 => ['MCCCVLII'],
+ 1348 => ['MCCCVLIII'],
+ 1349 => ['MCCCVLIV', 'MCCCIL'],
+ 1395 => ['MCCCVC'],
+ 1396 => ['MCCCVCI'],
+ 1397 => ['MCCCVCII'],
+ 1398 => ['MCCCVCIII'],
+ 1399 => ['MCCCVCIV', 'MCCCIC'],
+ 1445 => ['MCDVL'],
+ 1446 => ['MCDVLI'],
+ 1447 => ['MCDVLII'],
+ 1448 => ['MCDVLIII'],
+ 1449 => ['MCDVLIV', 'MCDIL'],
+ 1450 => ['MLD'],
+ 1451 => ['MLDI'],
+ 1452 => ['MLDII'],
+ 1453 => ['MLDIII'],
+ 1454 => ['MLDIV'],
+ 1455 => ['MLDV'],
+ 1456 => ['MLDVI'],
+ 1457 => ['MLDVII'],
+ 1458 => ['MLDVIII'],
+ 1459 => ['MLDIX'],
+ 1460 => ['MLDX'],
+ 1461 => ['MLDXI'],
+ 1462 => ['MLDXII'],
+ 1463 => ['MLDXIII'],
+ 1464 => ['MLDXIV'],
+ 1465 => ['MLDXV'],
+ 1466 => ['MLDXVI'],
+ 1467 => ['MLDXVII'],
+ 1468 => ['MLDXVIII'],
+ 1469 => ['MLDXIX'],
+ 1470 => ['MLDXX'],
+ 1471 => ['MLDXXI'],
+ 1472 => ['MLDXXII'],
+ 1473 => ['MLDXXIII'],
+ 1474 => ['MLDXXIV'],
+ 1475 => ['MLDXXV'],
+ 1476 => ['MLDXXVI'],
+ 1477 => ['MLDXXVII'],
+ 1478 => ['MLDXXVIII'],
+ 1479 => ['MLDXXIX'],
+ 1480 => ['MLDXXX'],
+ 1481 => ['MLDXXXI'],
+ 1482 => ['MLDXXXII'],
+ 1483 => ['MLDXXXIII'],
+ 1484 => ['MLDXXXIV'],
+ 1485 => ['MLDXXXV'],
+ 1486 => ['MLDXXXVI'],
+ 1487 => ['MLDXXXVII'],
+ 1488 => ['MLDXXXVIII'],
+ 1489 => ['MLDXXXIX'],
+ 1490 => ['MLDXL', 'MXD'],
+ 1491 => ['MLDXLI', 'MXDI'],
+ 1492 => ['MLDXLII', 'MXDII'],
+ 1493 => ['MLDXLIII', 'MXDIII'],
+ 1494 => ['MLDXLIV', 'MXDIV'],
+ 1495 => ['MLDVL', 'MXDV', 'MVD'],
+ 1496 => ['MLDVLI', 'MXDVI', 'MVDI'],
+ 1497 => ['MLDVLII', 'MXDVII', 'MVDII'],
+ 1498 => ['MLDVLIII', 'MXDVIII', 'MVDIII'],
+ 1499 => ['MLDVLIV', 'MXDIX', 'MVDIV', 'MID'],
+ 1545 => ['MDVL'],
+ 1546 => ['MDVLI'],
+ 1547 => ['MDVLII'],
+ 1548 => ['MDVLIII'],
+ 1549 => ['MDVLIV', 'MDIL'],
+ 1595 => ['MDVC'],
+ 1596 => ['MDVCI'],
+ 1597 => ['MDVCII'],
+ 1598 => ['MDVCIII'],
+ 1599 => ['MDVCIV', 'MDIC'],
+ 1645 => ['MDCVL'],
+ 1646 => ['MDCVLI'],
+ 1647 => ['MDCVLII'],
+ 1648 => ['MDCVLIII'],
+ 1649 => ['MDCVLIV', 'MDCIL'],
+ 1695 => ['MDCVC'],
+ 1696 => ['MDCVCI'],
+ 1697 => ['MDCVCII'],
+ 1698 => ['MDCVCIII'],
+ 1699 => ['MDCVCIV', 'MDCIC'],
+ 1745 => ['MDCCVL'],
+ 1746 => ['MDCCVLI'],
+ 1747 => ['MDCCVLII'],
+ 1748 => ['MDCCVLIII'],
+ 1749 => ['MDCCVLIV', 'MDCCIL'],
+ 1795 => ['MDCCVC'],
+ 1796 => ['MDCCVCI'],
+ 1797 => ['MDCCVCII'],
+ 1798 => ['MDCCVCIII'],
+ 1799 => ['MDCCVCIV', 'MDCCIC'],
+ 1845 => ['MDCCCVL'],
+ 1846 => ['MDCCCVLI'],
+ 1847 => ['MDCCCVLII'],
+ 1848 => ['MDCCCVLIII'],
+ 1849 => ['MDCCCVLIV', 'MDCCCIL'],
+ 1895 => ['MDCCCVC'],
+ 1896 => ['MDCCCVCI'],
+ 1897 => ['MDCCCVCII'],
+ 1898 => ['MDCCCVCIII'],
+ 1899 => ['MDCCCVCIV', 'MDCCCIC'],
+ 1945 => ['MCMVL'],
+ 1946 => ['MCMVLI'],
+ 1947 => ['MCMVLII'],
+ 1948 => ['MCMVLIII'],
+ 1949 => ['MCMVLIV', 'MCMIL'],
+ 1950 => ['MLM'],
+ 1951 => ['MLMI'],
+ 1952 => ['MLMII'],
+ 1953 => ['MLMIII'],
+ 1954 => ['MLMIV'],
+ 1955 => ['MLMV'],
+ 1956 => ['MLMVI'],
+ 1957 => ['MLMVII'],
+ 1958 => ['MLMVIII'],
+ 1959 => ['MLMIX'],
+ 1960 => ['MLMX'],
+ 1961 => ['MLMXI'],
+ 1962 => ['MLMXII'],
+ 1963 => ['MLMXIII'],
+ 1964 => ['MLMXIV'],
+ 1965 => ['MLMXV'],
+ 1966 => ['MLMXVI'],
+ 1967 => ['MLMXVII'],
+ 1968 => ['MLMXVIII'],
+ 1969 => ['MLMXIX'],
+ 1970 => ['MLMXX'],
+ 1971 => ['MLMXXI'],
+ 1972 => ['MLMXXII'],
+ 1973 => ['MLMXXIII'],
+ 1974 => ['MLMXXIV'],
+ 1975 => ['MLMXXV'],
+ 1976 => ['MLMXXVI'],
+ 1977 => ['MLMXXVII'],
+ 1978 => ['MLMXXVIII'],
+ 1979 => ['MLMXXIX'],
+ 1980 => ['MLMXXX'],
+ 1981 => ['MLMXXXI'],
+ 1982 => ['MLMXXXII'],
+ 1983 => ['MLMXXXIII'],
+ 1984 => ['MLMXXXIV'],
+ 1985 => ['MLMXXXV'],
+ 1986 => ['MLMXXXVI'],
+ 1987 => ['MLMXXXVII'],
+ 1988 => ['MLMXXXVIII'],
+ 1989 => ['MLMXXXIX'],
+ 1990 => ['MLMXL', 'MXM'],
+ 1991 => ['MLMXLI', 'MXMI'],
+ 1992 => ['MLMXLII', 'MXMII'],
+ 1993 => ['MLMXLIII', 'MXMIII'],
+ 1994 => ['MLMXLIV', 'MXMIV'],
+ 1995 => ['MLMVL', 'MXMV', 'MVM'],
+ 1996 => ['MLMVLI', 'MXMVI', 'MVMI'],
+ 1997 => ['MLMVLII', 'MXMVII', 'MVMII'],
+ 1998 => ['MLMVLIII', 'MXMVIII', 'MVMIII'],
+ 1999 => ['MLMVLIV', 'MXMIX', 'MVMIV', 'MIM'],
+ 2045 => ['MMVL'],
+ 2046 => ['MMVLI'],
+ 2047 => ['MMVLII'],
+ 2048 => ['MMVLIII'],
+ 2049 => ['MMVLIV', 'MMIL'],
+ 2095 => ['MMVC'],
+ 2096 => ['MMVCI'],
+ 2097 => ['MMVCII'],
+ 2098 => ['MMVCIII'],
+ 2099 => ['MMVCIV', 'MMIC'],
+ 2145 => ['MMCVL'],
+ 2146 => ['MMCVLI'],
+ 2147 => ['MMCVLII'],
+ 2148 => ['MMCVLIII'],
+ 2149 => ['MMCVLIV', 'MMCIL'],
+ 2195 => ['MMCVC'],
+ 2196 => ['MMCVCI'],
+ 2197 => ['MMCVCII'],
+ 2198 => ['MMCVCIII'],
+ 2199 => ['MMCVCIV', 'MMCIC'],
+ 2245 => ['MMCCVL'],
+ 2246 => ['MMCCVLI'],
+ 2247 => ['MMCCVLII'],
+ 2248 => ['MMCCVLIII'],
+ 2249 => ['MMCCVLIV', 'MMCCIL'],
+ 2295 => ['MMCCVC'],
+ 2296 => ['MMCCVCI'],
+ 2297 => ['MMCCVCII'],
+ 2298 => ['MMCCVCIII'],
+ 2299 => ['MMCCVCIV', 'MMCCIC'],
+ 2345 => ['MMCCCVL'],
+ 2346 => ['MMCCCVLI'],
+ 2347 => ['MMCCCVLII'],
+ 2348 => ['MMCCCVLIII'],
+ 2349 => ['MMCCCVLIV', 'MMCCCIL'],
+ 2395 => ['MMCCCVC'],
+ 2396 => ['MMCCCVCI'],
+ 2397 => ['MMCCCVCII'],
+ 2398 => ['MMCCCVCIII'],
+ 2399 => ['MMCCCVCIV', 'MMCCCIC'],
+ 2445 => ['MMCDVL'],
+ 2446 => ['MMCDVLI'],
+ 2447 => ['MMCDVLII'],
+ 2448 => ['MMCDVLIII'],
+ 2449 => ['MMCDVLIV', 'MMCDIL'],
+ 2450 => ['MMLD'],
+ 2451 => ['MMLDI'],
+ 2452 => ['MMLDII'],
+ 2453 => ['MMLDIII'],
+ 2454 => ['MMLDIV'],
+ 2455 => ['MMLDV'],
+ 2456 => ['MMLDVI'],
+ 2457 => ['MMLDVII'],
+ 2458 => ['MMLDVIII'],
+ 2459 => ['MMLDIX'],
+ 2460 => ['MMLDX'],
+ 2461 => ['MMLDXI'],
+ 2462 => ['MMLDXII'],
+ 2463 => ['MMLDXIII'],
+ 2464 => ['MMLDXIV'],
+ 2465 => ['MMLDXV'],
+ 2466 => ['MMLDXVI'],
+ 2467 => ['MMLDXVII'],
+ 2468 => ['MMLDXVIII'],
+ 2469 => ['MMLDXIX'],
+ 2470 => ['MMLDXX'],
+ 2471 => ['MMLDXXI'],
+ 2472 => ['MMLDXXII'],
+ 2473 => ['MMLDXXIII'],
+ 2474 => ['MMLDXXIV'],
+ 2475 => ['MMLDXXV'],
+ 2476 => ['MMLDXXVI'],
+ 2477 => ['MMLDXXVII'],
+ 2478 => ['MMLDXXVIII'],
+ 2479 => ['MMLDXXIX'],
+ 2480 => ['MMLDXXX'],
+ 2481 => ['MMLDXXXI'],
+ 2482 => ['MMLDXXXII'],
+ 2483 => ['MMLDXXXIII'],
+ 2484 => ['MMLDXXXIV'],
+ 2485 => ['MMLDXXXV'],
+ 2486 => ['MMLDXXXVI'],
+ 2487 => ['MMLDXXXVII'],
+ 2488 => ['MMLDXXXVIII'],
+ 2489 => ['MMLDXXXIX'],
+ 2490 => ['MMLDXL', 'MMXD'],
+ 2491 => ['MMLDXLI', 'MMXDI'],
+ 2492 => ['MMLDXLII', 'MMXDII'],
+ 2493 => ['MMLDXLIII', 'MMXDIII'],
+ 2494 => ['MMLDXLIV', 'MMXDIV'],
+ 2495 => ['MMLDVL', 'MMXDV', 'MMVD'],
+ 2496 => ['MMLDVLI', 'MMXDVI', 'MMVDI'],
+ 2497 => ['MMLDVLII', 'MMXDVII', 'MMVDII'],
+ 2498 => ['MMLDVLIII', 'MMXDVIII', 'MMVDIII'],
+ 2499 => ['MMLDVLIV', 'MMXDIX', 'MMVDIV', 'MMID'],
+ 2545 => ['MMDVL'],
+ 2546 => ['MMDVLI'],
+ 2547 => ['MMDVLII'],
+ 2548 => ['MMDVLIII'],
+ 2549 => ['MMDVLIV', 'MMDIL'],
+ 2595 => ['MMDVC'],
+ 2596 => ['MMDVCI'],
+ 2597 => ['MMDVCII'],
+ 2598 => ['MMDVCIII'],
+ 2599 => ['MMDVCIV', 'MMDIC'],
+ 2645 => ['MMDCVL'],
+ 2646 => ['MMDCVLI'],
+ 2647 => ['MMDCVLII'],
+ 2648 => ['MMDCVLIII'],
+ 2649 => ['MMDCVLIV', 'MMDCIL'],
+ 2695 => ['MMDCVC'],
+ 2696 => ['MMDCVCI'],
+ 2697 => ['MMDCVCII'],
+ 2698 => ['MMDCVCIII'],
+ 2699 => ['MMDCVCIV', 'MMDCIC'],
+ 2745 => ['MMDCCVL'],
+ 2746 => ['MMDCCVLI'],
+ 2747 => ['MMDCCVLII'],
+ 2748 => ['MMDCCVLIII'],
+ 2749 => ['MMDCCVLIV', 'MMDCCIL'],
+ 2795 => ['MMDCCVC'],
+ 2796 => ['MMDCCVCI'],
+ 2797 => ['MMDCCVCII'],
+ 2798 => ['MMDCCVCIII'],
+ 2799 => ['MMDCCVCIV', 'MMDCCIC'],
+ 2845 => ['MMDCCCVL'],
+ 2846 => ['MMDCCCVLI'],
+ 2847 => ['MMDCCCVLII'],
+ 2848 => ['MMDCCCVLIII'],
+ 2849 => ['MMDCCCVLIV', 'MMDCCCIL'],
+ 2895 => ['MMDCCCVC'],
+ 2896 => ['MMDCCCVCI'],
+ 2897 => ['MMDCCCVCII'],
+ 2898 => ['MMDCCCVCIII'],
+ 2899 => ['MMDCCCVCIV', 'MMDCCCIC'],
+ 2945 => ['MMCMVL'],
+ 2946 => ['MMCMVLI'],
+ 2947 => ['MMCMVLII'],
+ 2948 => ['MMCMVLIII'],
+ 2949 => ['MMCMVLIV', 'MMCMIL'],
+ 2950 => ['MMLM'],
+ 2951 => ['MMLMI'],
+ 2952 => ['MMLMII'],
+ 2953 => ['MMLMIII'],
+ 2954 => ['MMLMIV'],
+ 2955 => ['MMLMV'],
+ 2956 => ['MMLMVI'],
+ 2957 => ['MMLMVII'],
+ 2958 => ['MMLMVIII'],
+ 2959 => ['MMLMIX'],
+ 2960 => ['MMLMX'],
+ 2961 => ['MMLMXI'],
+ 2962 => ['MMLMXII'],
+ 2963 => ['MMLMXIII'],
+ 2964 => ['MMLMXIV'],
+ 2965 => ['MMLMXV'],
+ 2966 => ['MMLMXVI'],
+ 2967 => ['MMLMXVII'],
+ 2968 => ['MMLMXVIII'],
+ 2969 => ['MMLMXIX'],
+ 2970 => ['MMLMXX'],
+ 2971 => ['MMLMXXI'],
+ 2972 => ['MMLMXXII'],
+ 2973 => ['MMLMXXIII'],
+ 2974 => ['MMLMXXIV'],
+ 2975 => ['MMLMXXV'],
+ 2976 => ['MMLMXXVI'],
+ 2977 => ['MMLMXXVII'],
+ 2978 => ['MMLMXXVIII'],
+ 2979 => ['MMLMXXIX'],
+ 2980 => ['MMLMXXX'],
+ 2981 => ['MMLMXXXI'],
+ 2982 => ['MMLMXXXII'],
+ 2983 => ['MMLMXXXIII'],
+ 2984 => ['MMLMXXXIV'],
+ 2985 => ['MMLMXXXV'],
+ 2986 => ['MMLMXXXVI'],
+ 2987 => ['MMLMXXXVII'],
+ 2988 => ['MMLMXXXVIII'],
+ 2989 => ['MMLMXXXIX'],
+ 2990 => ['MMLMXL', 'MMXM'],
+ 2991 => ['MMLMXLI', 'MMXMI'],
+ 2992 => ['MMLMXLII', 'MMXMII'],
+ 2993 => ['MMLMXLIII', 'MMXMIII'],
+ 2994 => ['MMLMXLIV', 'MMXMIV'],
+ 2995 => ['MMLMVL', 'MMXMV', 'MMVM'],
+ 2996 => ['MMLMVLI', 'MMXMVI', 'MMVMI'],
+ 2997 => ['MMLMVLII', 'MMXMVII', 'MMVMII'],
+ 2998 => ['MMLMVLIII', 'MMXMVIII', 'MMVMIII'],
+ 2999 => ['MMLMVLIV', 'MMXMIX', 'MMVMIV', 'MMIM'],
+ 3045 => ['MMMVL'],
+ 3046 => ['MMMVLI'],
+ 3047 => ['MMMVLII'],
+ 3048 => ['MMMVLIII'],
+ 3049 => ['MMMVLIV', 'MMMIL'],
+ 3095 => ['MMMVC'],
+ 3096 => ['MMMVCI'],
+ 3097 => ['MMMVCII'],
+ 3098 => ['MMMVCIII'],
+ 3099 => ['MMMVCIV', 'MMMIC'],
+ 3145 => ['MMMCVL'],
+ 3146 => ['MMMCVLI'],
+ 3147 => ['MMMCVLII'],
+ 3148 => ['MMMCVLIII'],
+ 3149 => ['MMMCVLIV', 'MMMCIL'],
+ 3195 => ['MMMCVC'],
+ 3196 => ['MMMCVCI'],
+ 3197 => ['MMMCVCII'],
+ 3198 => ['MMMCVCIII'],
+ 3199 => ['MMMCVCIV', 'MMMCIC'],
+ 3245 => ['MMMCCVL'],
+ 3246 => ['MMMCCVLI'],
+ 3247 => ['MMMCCVLII'],
+ 3248 => ['MMMCCVLIII'],
+ 3249 => ['MMMCCVLIV', 'MMMCCIL'],
+ 3295 => ['MMMCCVC'],
+ 3296 => ['MMMCCVCI'],
+ 3297 => ['MMMCCVCII'],
+ 3298 => ['MMMCCVCIII'],
+ 3299 => ['MMMCCVCIV', 'MMMCCIC'],
+ 3345 => ['MMMCCCVL'],
+ 3346 => ['MMMCCCVLI'],
+ 3347 => ['MMMCCCVLII'],
+ 3348 => ['MMMCCCVLIII'],
+ 3349 => ['MMMCCCVLIV', 'MMMCCCIL'],
+ 3395 => ['MMMCCCVC'],
+ 3396 => ['MMMCCCVCI'],
+ 3397 => ['MMMCCCVCII'],
+ 3398 => ['MMMCCCVCIII'],
+ 3399 => ['MMMCCCVCIV', 'MMMCCCIC'],
+ 3445 => ['MMMCDVL'],
+ 3446 => ['MMMCDVLI'],
+ 3447 => ['MMMCDVLII'],
+ 3448 => ['MMMCDVLIII'],
+ 3449 => ['MMMCDVLIV', 'MMMCDIL'],
+ 3450 => ['MMMLD'],
+ 3451 => ['MMMLDI'],
+ 3452 => ['MMMLDII'],
+ 3453 => ['MMMLDIII'],
+ 3454 => ['MMMLDIV'],
+ 3455 => ['MMMLDV'],
+ 3456 => ['MMMLDVI'],
+ 3457 => ['MMMLDVII'],
+ 3458 => ['MMMLDVIII'],
+ 3459 => ['MMMLDIX'],
+ 3460 => ['MMMLDX'],
+ 3461 => ['MMMLDXI'],
+ 3462 => ['MMMLDXII'],
+ 3463 => ['MMMLDXIII'],
+ 3464 => ['MMMLDXIV'],
+ 3465 => ['MMMLDXV'],
+ 3466 => ['MMMLDXVI'],
+ 3467 => ['MMMLDXVII'],
+ 3468 => ['MMMLDXVIII'],
+ 3469 => ['MMMLDXIX'],
+ 3470 => ['MMMLDXX'],
+ 3471 => ['MMMLDXXI'],
+ 3472 => ['MMMLDXXII'],
+ 3473 => ['MMMLDXXIII'],
+ 3474 => ['MMMLDXXIV'],
+ 3475 => ['MMMLDXXV'],
+ 3476 => ['MMMLDXXVI'],
+ 3477 => ['MMMLDXXVII'],
+ 3478 => ['MMMLDXXVIII'],
+ 3479 => ['MMMLDXXIX'],
+ 3480 => ['MMMLDXXX'],
+ 3481 => ['MMMLDXXXI'],
+ 3482 => ['MMMLDXXXII'],
+ 3483 => ['MMMLDXXXIII'],
+ 3484 => ['MMMLDXXXIV'],
+ 3485 => ['MMMLDXXXV'],
+ 3486 => ['MMMLDXXXVI'],
+ 3487 => ['MMMLDXXXVII'],
+ 3488 => ['MMMLDXXXVIII'],
+ 3489 => ['MMMLDXXXIX'],
+ 3490 => ['MMMLDXL', 'MMMXD'],
+ 3491 => ['MMMLDXLI', 'MMMXDI'],
+ 3492 => ['MMMLDXLII', 'MMMXDII'],
+ 3493 => ['MMMLDXLIII', 'MMMXDIII'],
+ 3494 => ['MMMLDXLIV', 'MMMXDIV'],
+ 3495 => ['MMMLDVL', 'MMMXDV', 'MMMVD'],
+ 3496 => ['MMMLDVLI', 'MMMXDVI', 'MMMVDI'],
+ 3497 => ['MMMLDVLII', 'MMMXDVII', 'MMMVDII'],
+ 3498 => ['MMMLDVLIII', 'MMMXDVIII', 'MMMVDIII'],
+ 3499 => ['MMMLDVLIV', 'MMMXDIX', 'MMMVDIV', 'MMMID'],
+ 3545 => ['MMMDVL'],
+ 3546 => ['MMMDVLI'],
+ 3547 => ['MMMDVLII'],
+ 3548 => ['MMMDVLIII'],
+ 3549 => ['MMMDVLIV', 'MMMDIL'],
+ 3595 => ['MMMDVC'],
+ 3596 => ['MMMDVCI'],
+ 3597 => ['MMMDVCII'],
+ 3598 => ['MMMDVCIII'],
+ 3599 => ['MMMDVCIV', 'MMMDIC'],
+ 3645 => ['MMMDCVL'],
+ 3646 => ['MMMDCVLI'],
+ 3647 => ['MMMDCVLII'],
+ 3648 => ['MMMDCVLIII'],
+ 3649 => ['MMMDCVLIV', 'MMMDCIL'],
+ 3695 => ['MMMDCVC'],
+ 3696 => ['MMMDCVCI'],
+ 3697 => ['MMMDCVCII'],
+ 3698 => ['MMMDCVCIII'],
+ 3699 => ['MMMDCVCIV', 'MMMDCIC'],
+ 3745 => ['MMMDCCVL'],
+ 3746 => ['MMMDCCVLI'],
+ 3747 => ['MMMDCCVLII'],
+ 3748 => ['MMMDCCVLIII'],
+ 3749 => ['MMMDCCVLIV', 'MMMDCCIL'],
+ 3795 => ['MMMDCCVC'],
+ 3796 => ['MMMDCCVCI'],
+ 3797 => ['MMMDCCVCII'],
+ 3798 => ['MMMDCCVCIII'],
+ 3799 => ['MMMDCCVCIV', 'MMMDCCIC'],
+ 3845 => ['MMMDCCCVL'],
+ 3846 => ['MMMDCCCVLI'],
+ 3847 => ['MMMDCCCVLII'],
+ 3848 => ['MMMDCCCVLIII'],
+ 3849 => ['MMMDCCCVLIV', 'MMMDCCCIL'],
+ 3895 => ['MMMDCCCVC'],
+ 3896 => ['MMMDCCCVCI'],
+ 3897 => ['MMMDCCCVCII'],
+ 3898 => ['MMMDCCCVCIII'],
+ 3899 => ['MMMDCCCVCIV', 'MMMDCCCIC'],
+ 3945 => ['MMMCMVL'],
+ 3946 => ['MMMCMVLI'],
+ 3947 => ['MMMCMVLII'],
+ 3948 => ['MMMCMVLIII'],
+ 3949 => ['MMMCMVLIV', 'MMMCMIL'],
+ 3950 => ['MMMLM'],
+ 3951 => ['MMMLMI'],
+ 3952 => ['MMMLMII'],
+ 3953 => ['MMMLMIII'],
+ 3954 => ['MMMLMIV'],
+ 3955 => ['MMMLMV'],
+ 3956 => ['MMMLMVI'],
+ 3957 => ['MMMLMVII'],
+ 3958 => ['MMMLMVIII'],
+ 3959 => ['MMMLMIX'],
+ 3960 => ['MMMLMX'],
+ 3961 => ['MMMLMXI'],
+ 3962 => ['MMMLMXII'],
+ 3963 => ['MMMLMXIII'],
+ 3964 => ['MMMLMXIV'],
+ 3965 => ['MMMLMXV'],
+ 3966 => ['MMMLMXVI'],
+ 3967 => ['MMMLMXVII'],
+ 3968 => ['MMMLMXVIII'],
+ 3969 => ['MMMLMXIX'],
+ 3970 => ['MMMLMXX'],
+ 3971 => ['MMMLMXXI'],
+ 3972 => ['MMMLMXXII'],
+ 3973 => ['MMMLMXXIII'],
+ 3974 => ['MMMLMXXIV'],
+ 3975 => ['MMMLMXXV'],
+ 3976 => ['MMMLMXXVI'],
+ 3977 => ['MMMLMXXVII'],
+ 3978 => ['MMMLMXXVIII'],
+ 3979 => ['MMMLMXXIX'],
+ 3980 => ['MMMLMXXX'],
+ 3981 => ['MMMLMXXXI'],
+ 3982 => ['MMMLMXXXII'],
+ 3983 => ['MMMLMXXXIII'],
+ 3984 => ['MMMLMXXXIV'],
+ 3985 => ['MMMLMXXXV'],
+ 3986 => ['MMMLMXXXVI'],
+ 3987 => ['MMMLMXXXVII'],
+ 3988 => ['MMMLMXXXVIII'],
+ 3989 => ['MMMLMXXXIX'],
+ 3990 => ['MMMLMXL', 'MMMXM'],
+ 3991 => ['MMMLMXLI', 'MMMXMI'],
+ 3992 => ['MMMLMXLII', 'MMMXMII'],
+ 3993 => ['MMMLMXLIII', 'MMMXMIII'],
+ 3994 => ['MMMLMXLIV', 'MMMXMIV'],
+ 3995 => ['MMMLMVL', 'MMMXMV', 'MMMVM'],
+ 3996 => ['MMMLMVLI', 'MMMXMVI', 'MMMVMI'],
+ 3997 => ['MMMLMVLII', 'MMMXMVII', 'MMMVMII'],
+ 3998 => ['MMMLMVLIII', 'MMMXMVIII', 'MMMVMIII'],
+ 3999 => ['MMMLMVLIV', 'MMMXMIX', 'MMMVMIV', 'MMMIM'],
+ ];
+
+ private const THOUSANDS = ['', 'M', 'MM', 'MMM'];
+ private const HUNDREDS = ['', 'C', 'CC', 'CCC', 'CD', 'D', 'DC', 'DCC', 'DCCC', 'CM'];
+ private const TENS = ['', 'X', 'XX', 'XXX', 'XL', 'L', 'LX', 'LXX', 'LXXX', 'XC'];
+ private const ONES = ['', 'I', 'II', 'III', 'IV', 'V', 'VI', 'VII', 'VIII', 'IX'];
+ const MAX_ROMAN_VALUE = 3999;
+ const MAX_ROMAN_STYLE = 4;
+
+ private static function valueOk(int $aValue, int $style): string
+ {
+ $origValue = $aValue;
+ $m = \intdiv($aValue, 1000);
+ $aValue %= 1000;
+ $c = \intdiv($aValue, 100);
+ $aValue %= 100;
+ $t = \intdiv($aValue, 10);
+ $aValue %= 10;
+ $result = self::THOUSANDS[$m] . self::HUNDREDS[$c] . self::TENS[$t] . self::ONES[$aValue];
+ if ($style > 0) {
+ if (array_key_exists($origValue, self::VALUES)) {
+ $arr = self::VALUES[$origValue];
+ $idx = min($style, count($arr)) - 1;
+ $result = $arr[$idx];
+ }
+ }
+
+ return $result;
+ }
+
+ private static function styleOk(int $aValue, int $style): string
+ {
+ return ($aValue < 0 || $aValue > self::MAX_ROMAN_VALUE) ? ExcelError::VALUE() : self::valueOk($aValue, $style);
+ }
+
+ public static function calculateRoman(int $aValue, int $style): string
+ {
+ return ($style < 0 || $style > self::MAX_ROMAN_STYLE) ? ExcelError::VALUE() : self::styleOk($aValue, $style);
+ }
+
+ /**
+ * ROMAN.
+ *
+ * Converts a number to Roman numeral
+ *
+ * @param mixed $aValue Number to convert
+ * Or can be an array of numbers
+ * @param mixed $style Number indicating one of five possible forms
+ * Or can be an array of styles
+ *
+ * @return array|string Roman numeral, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function evaluate(mixed $aValue, mixed $style = 0): array|string
+ {
+ if (is_array($aValue) || is_array($style)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $aValue, $style);
+ }
+
+ try {
+ $aValue = Helpers::validateNumericNullBool($aValue);
+ if (is_bool($style)) {
+ $style = $style ? 0 : 4;
+ }
+ $style = Helpers::validateNumericNullSubstitution($style, null);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return self::calculateRoman((int) $aValue, (int) $style);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Round.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Round.php
new file mode 100644
index 00000000..e0e03ae9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Round.php
@@ -0,0 +1,236 @@
+getMessage();
+ }
+
+ return round($number, (int) $precision);
+ }
+
+ /**
+ * ROUNDUP.
+ *
+ * Rounds a number up to a specified number of decimal places
+ *
+ * @param array|float $number Number to round, or can be an array of numbers
+ * @param array|int $digits Number of digits to which you want to round $number, or can be an array of numbers
+ *
+ * @return array|float|string Rounded Number, or a string containing an error
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function up($number, $digits): array|string|float
+ {
+ if (is_array($number) || is_array($digits)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $digits);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ $digits = (int) Helpers::validateNumericNullSubstitution($digits, null);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($number == 0.0) {
+ return 0.0;
+ }
+
+ if (PHP_VERSION_ID >= 80400) {
+ return round(
+ (float) (string) $number,
+ $digits,
+ RoundingMode::AwayFromZero //* @phpstan-ignore-line
+ );
+ }
+
+ if ($number < 0.0) {
+ return round($number - 0.5 * 0.1 ** $digits, $digits, PHP_ROUND_HALF_DOWN);
+ }
+
+ return round($number + 0.5 * 0.1 ** $digits, $digits, PHP_ROUND_HALF_DOWN);
+ }
+
+ /**
+ * ROUNDDOWN.
+ *
+ * Rounds a number down to a specified number of decimal places
+ *
+ * @param null|array|float|string $number Number to round, or can be an array of numbers
+ * @param array|float|int|string $digits Number of digits to which you want to round $number, or can be an array of numbers
+ *
+ * @return array|float|string Rounded Number, or a string containing an error
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function down($number, $digits): array|string|float
+ {
+ if (is_array($number) || is_array($digits)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $digits);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ $digits = (int) Helpers::validateNumericNullSubstitution($digits, null);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($number == 0.0) {
+ return 0.0;
+ }
+
+ if (PHP_VERSION_ID >= 80400) {
+ return round(
+ (float) (string) $number,
+ $digits,
+ RoundingMode::TowardsZero //* @phpstan-ignore-line
+ );
+ }
+
+ if ($number < 0.0) {
+ return round($number + 0.5 * 0.1 ** $digits, $digits, PHP_ROUND_HALF_UP);
+ }
+
+ return round($number - 0.5 * 0.1 ** $digits, $digits, PHP_ROUND_HALF_UP);
+ }
+
+ /**
+ * MROUND.
+ *
+ * Rounds a number to the nearest multiple of a specified value
+ *
+ * @param mixed $number Expect float. Number to round, or can be an array of numbers
+ * @param mixed $multiple Expect int. Multiple to which you want to round, or can be an array of numbers.
+ *
+ * @return array|float|int|string Rounded Number, or a string containing an error
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function multiple(mixed $number, mixed $multiple): array|string|int|float
+ {
+ if (is_array($number) || is_array($multiple)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $number, $multiple);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullSubstitution($number, 0);
+ $multiple = Helpers::validateNumericNullSubstitution($multiple, null);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($number == 0 || $multiple == 0) {
+ return 0;
+ }
+ if ((Helpers::returnSign($number)) == (Helpers::returnSign($multiple))) {
+ $multiplier = 1 / $multiple;
+
+ return round($number * $multiplier) / $multiplier;
+ }
+
+ return ExcelError::NAN();
+ }
+
+ /**
+ * EVEN.
+ *
+ * Returns number rounded up to the nearest even integer.
+ * You can use this function for processing items that come in twos. For example,
+ * a packing crate accepts rows of one or two items. The crate is full when
+ * the number of items, rounded up to the nearest two, matches the crate's
+ * capacity.
+ *
+ * Excel Function:
+ * EVEN(number)
+ *
+ * @param array|float $number Number to round, or can be an array of numbers
+ *
+ * @return array|float|string Rounded Number, or a string containing an error
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function even($number): array|string|float
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return Helpers::getEven($number);
+ }
+
+ /**
+ * ODD.
+ *
+ * Returns number rounded up to the nearest odd integer.
+ *
+ * @param array|float $number Number to round, or can be an array of numbers
+ *
+ * @return array|float|int|string Rounded Number, or a string containing an error
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function odd($number): array|string|int|float
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $significance = Helpers::returnSign($number);
+ if ($significance == 0) {
+ return 1;
+ }
+
+ $result = ceil($number / $significance) * $significance;
+ if ($result == Helpers::getEven($result)) {
+ $result += $significance;
+ }
+
+ return $result;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/SeriesSum.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/SeriesSum.php
new file mode 100644
index 00000000..bb100901
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/SeriesSum.php
@@ -0,0 +1,53 @@
+getMessage();
+ }
+
+ return $returnValue;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sign.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sign.php
new file mode 100644
index 00000000..86a55092
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sign.php
@@ -0,0 +1,38 @@
+getMessage();
+ }
+
+ return Helpers::returnSign($number);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sqrt.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sqrt.php
new file mode 100644
index 00000000..18289f7b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sqrt.php
@@ -0,0 +1,64 @@
+getMessage();
+ }
+
+ return Helpers::numberOrNan(sqrt($number));
+ }
+
+ /**
+ * SQRTPI.
+ *
+ * Returns the square root of (number * pi).
+ *
+ * @param array|float $number Number, or can be an array of numbers
+ *
+ * @return array|float|string Square Root of Number * Pi, or a string containing an error
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function pi($number): array|string|float
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullSubstitution($number, 0);
+ Helpers::validateNotNegative($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return sqrt($number * M_PI);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Subtotal.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Subtotal.php
new file mode 100644
index 00000000..cfced9e4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Subtotal.php
@@ -0,0 +1,127 @@
+getWorksheet()->getRowDimension($row)->getVisible();
+ },
+ ARRAY_FILTER_USE_KEY
+ );
+ }
+
+ protected static function filterFormulaArgs(mixed $cellReference, mixed $args): array
+ {
+ return array_filter(
+ $args,
+ function ($index) use ($cellReference): bool {
+ $explodeArray = explode('.', $index);
+ $row = $explodeArray[1] ?? '';
+ $column = $explodeArray[2] ?? '';
+ $retVal = true;
+ if ($cellReference->getWorksheet()->cellExists($column . $row)) {
+ //take this cell out if it contains the SUBTOTAL or AGGREGATE functions in a formula
+ $isFormula = $cellReference->getWorksheet()->getCell($column . $row)->isFormula();
+ $cellFormula = !preg_match(
+ '/^=.*\b(SUBTOTAL|AGGREGATE)\s*\(/i',
+ $cellReference->getWorksheet()->getCell($column . $row)->getValue() ?? ''
+ );
+
+ $retVal = !$isFormula || $cellFormula;
+ }
+
+ return $retVal;
+ },
+ ARRAY_FILTER_USE_KEY
+ );
+ }
+
+ /**
+ * @var array
+ */
+ private const CALL_FUNCTIONS = [
+ 1 => [Statistical\Averages::class, 'average'], // 1 and 101
+ [Statistical\Counts::class, 'COUNT'], // 2 and 102
+ [Statistical\Counts::class, 'COUNTA'], // 3 and 103
+ [Statistical\Maximum::class, 'max'], // 4 and 104
+ [Statistical\Minimum::class, 'min'], // 5 and 105
+ [Operations::class, 'product'], // 6 and 106
+ [Statistical\StandardDeviations::class, 'STDEV'], // 7 and 107
+ [Statistical\StandardDeviations::class, 'STDEVP'], // 8 and 108
+ [Sum::class, 'sumIgnoringStrings'], // 9 and 109
+ [Statistical\Variances::class, 'VAR'], // 10 and 110
+ [Statistical\Variances::class, 'VARP'], // 111 and 111
+ ];
+
+ /**
+ * SUBTOTAL.
+ *
+ * Returns a subtotal in a list or database.
+ *
+ * @param mixed $functionType
+ * A number 1 to 11 that specifies which function to
+ * use in calculating subtotals within a range
+ * list
+ * Numbers 101 to 111 shadow the functions of 1 to 11
+ * but ignore any values in the range that are
+ * in hidden rows
+ * @param mixed[] $args A mixed data series of values
+ */
+ public static function evaluate(mixed $functionType, ...$args): float|int|string
+ {
+ $cellReference = array_pop($args);
+ $bArgs = Functions::flattenArrayIndexed($args);
+ $aArgs = [];
+ // int keys must come before string keys for PHP 8.0+
+ // Otherwise, PHP thinks positional args follow keyword
+ // in the subsequent call to call_user_func_array.
+ // Fortunately, order of args is unimportant to Subtotal.
+ foreach ($bArgs as $key => $value) {
+ if (is_int($key)) {
+ $aArgs[$key] = $value;
+ }
+ }
+ foreach ($bArgs as $key => $value) {
+ if (!is_int($key)) {
+ $aArgs[$key] = $value;
+ }
+ }
+
+ try {
+ $subtotal = (int) Helpers::validateNumericNullBool($functionType);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ // Calculate
+ if ($subtotal > 100) {
+ $aArgs = self::filterHiddenArgs($cellReference, $aArgs);
+ $subtotal -= 100;
+ }
+
+ $aArgs = self::filterFormulaArgs($cellReference, $aArgs);
+ if (array_key_exists($subtotal, self::CALL_FUNCTIONS)) {
+ $call = self::CALL_FUNCTIONS[$subtotal];
+
+ return call_user_func_array($call, $aArgs);
+ }
+
+ return ExcelError::VALUE();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sum.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sum.php
new file mode 100644
index 00000000..f939d9e7
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Sum.php
@@ -0,0 +1,110 @@
+ $arg) {
+ // Is it a numeric value?
+ if (is_numeric($arg)) {
+ $returnValue += $arg;
+ } elseif (is_bool($arg)) {
+ $returnValue += (int) $arg;
+ } elseif (ErrorValue::isError($arg)) {
+ return $arg;
+ } elseif ($arg !== null && !Functions::isCellValue($k)) {
+ // ignore non-numerics from cell, but fail as literals (except null)
+ return ExcelError::VALUE();
+ }
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * SUMPRODUCT.
+ *
+ * Excel Function:
+ * SUMPRODUCT(value1[,value2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ *
+ * @return float|int|string The result, or a string containing an error
+ */
+ public static function product(mixed ...$args): string|int|float
+ {
+ $arrayList = $args;
+
+ $wrkArray = Functions::flattenArray(array_shift($arrayList));
+ $wrkCellCount = count($wrkArray);
+
+ for ($i = 0; $i < $wrkCellCount; ++$i) {
+ if ((!is_numeric($wrkArray[$i])) || (is_string($wrkArray[$i]))) {
+ $wrkArray[$i] = 0;
+ }
+ }
+
+ foreach ($arrayList as $matrixData) {
+ $array2 = Functions::flattenArray($matrixData);
+ $count = count($array2);
+ if ($wrkCellCount != $count) {
+ return ExcelError::VALUE();
+ }
+
+ foreach ($array2 as $i => $val) {
+ if ((!is_numeric($val)) || (is_string($val))) {
+ $val = 0;
+ }
+ $wrkArray[$i] *= $val;
+ }
+ }
+
+ return array_sum($wrkArray);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/SumSquares.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/SumSquares.php
new file mode 100644
index 00000000..b2e9cea2
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/SumSquares.php
@@ -0,0 +1,133 @@
+getMessage();
+ }
+
+ return $returnValue;
+ }
+
+ private static function getCount(array $array1, array $array2): int
+ {
+ $count = count($array1);
+ if ($count !== count($array2)) {
+ throw new Exception(ExcelError::NA());
+ }
+
+ return $count;
+ }
+
+ /**
+ * These functions accept only numeric arguments, not even strings which are numeric.
+ */
+ private static function numericNotString(mixed $item): bool
+ {
+ return is_numeric($item) && !is_string($item);
+ }
+
+ /**
+ * SUMX2MY2.
+ *
+ * @param mixed[] $matrixData1 Matrix #1
+ * @param mixed[] $matrixData2 Matrix #2
+ */
+ public static function sumXSquaredMinusYSquared(array $matrixData1, array $matrixData2): string|int|float
+ {
+ try {
+ $array1 = Functions::flattenArray($matrixData1);
+ $array2 = Functions::flattenArray($matrixData2);
+ $count = self::getCount($array1, $array2);
+
+ $result = 0;
+ for ($i = 0; $i < $count; ++$i) {
+ if (self::numericNotString($array1[$i]) && self::numericNotString($array2[$i])) {
+ $result += ($array1[$i] * $array1[$i]) - ($array2[$i] * $array2[$i]);
+ }
+ }
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return $result;
+ }
+
+ /**
+ * SUMX2PY2.
+ *
+ * @param mixed[] $matrixData1 Matrix #1
+ * @param mixed[] $matrixData2 Matrix #2
+ */
+ public static function sumXSquaredPlusYSquared(array $matrixData1, array $matrixData2): string|int|float
+ {
+ try {
+ $array1 = Functions::flattenArray($matrixData1);
+ $array2 = Functions::flattenArray($matrixData2);
+ $count = self::getCount($array1, $array2);
+
+ $result = 0;
+ for ($i = 0; $i < $count; ++$i) {
+ if (self::numericNotString($array1[$i]) && self::numericNotString($array2[$i])) {
+ $result += ($array1[$i] * $array1[$i]) + ($array2[$i] * $array2[$i]);
+ }
+ }
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return $result;
+ }
+
+ /**
+ * SUMXMY2.
+ *
+ * @param mixed[] $matrixData1 Matrix #1
+ * @param mixed[] $matrixData2 Matrix #2
+ */
+ public static function sumXMinusYSquared(array $matrixData1, array $matrixData2): string|int|float
+ {
+ try {
+ $array1 = Functions::flattenArray($matrixData1);
+ $array2 = Functions::flattenArray($matrixData2);
+ $count = self::getCount($array1, $array2);
+
+ $result = 0;
+ for ($i = 0; $i < $count; ++$i) {
+ if (self::numericNotString($array1[$i]) && self::numericNotString($array2[$i])) {
+ $result += ($array1[$i] - $array2[$i]) * ($array1[$i] - $array2[$i]);
+ }
+ }
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return $result;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cosecant.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cosecant.php
new file mode 100644
index 00000000..845b6c14
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cosecant.php
@@ -0,0 +1,64 @@
+getMessage();
+ }
+
+ return Helpers::verySmallDenominator(1.0, sin($angle));
+ }
+
+ /**
+ * CSCH.
+ *
+ * Returns the hyperbolic cosecant of an angle.
+ *
+ * @param array|float $angle Number, or can be an array of numbers
+ *
+ * @return array|float|string The hyperbolic cosecant of the angle
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function csch($angle)
+ {
+ if (is_array($angle)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $angle);
+ }
+
+ try {
+ $angle = Helpers::validateNumericNullBool($angle);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return Helpers::verySmallDenominator(1.0, sinh($angle));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cosine.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cosine.php
new file mode 100644
index 00000000..733e3d61
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cosine.php
@@ -0,0 +1,116 @@
+getMessage();
+ }
+
+ return cos($number);
+ }
+
+ /**
+ * COSH.
+ *
+ * Returns the result of builtin function cosh after validating args.
+ *
+ * @param mixed $number Should be numeric, or can be an array of numbers
+ *
+ * @return array|float|string hyperbolic cosine
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function cosh(mixed $number): array|string|float
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return cosh($number);
+ }
+
+ /**
+ * ACOS.
+ *
+ * Returns the arccosine of a number.
+ *
+ * @param array|float $number Number, or can be an array of numbers
+ *
+ * @return array|float|string The arccosine of the number
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function acos($number)
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return Helpers::numberOrNan(acos($number));
+ }
+
+ /**
+ * ACOSH.
+ *
+ * Returns the arc inverse hyperbolic cosine of a number.
+ *
+ * @param array|float $number Number, or can be an array of numbers
+ *
+ * @return array|float|string The inverse hyperbolic cosine of the number, or an error string
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function acosh($number)
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return Helpers::numberOrNan(acosh($number));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cotangent.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cotangent.php
new file mode 100644
index 00000000..861159a3
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Cotangent.php
@@ -0,0 +1,118 @@
+getMessage();
+ }
+
+ return Helpers::verySmallDenominator(cos($angle), sin($angle));
+ }
+
+ /**
+ * COTH.
+ *
+ * Returns the hyperbolic cotangent of an angle.
+ *
+ * @param array|float $angle Number, or can be an array of numbers
+ *
+ * @return array|float|string The hyperbolic cotangent of the angle
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function coth($angle)
+ {
+ if (is_array($angle)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $angle);
+ }
+
+ try {
+ $angle = Helpers::validateNumericNullBool($angle);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return Helpers::verySmallDenominator(1.0, tanh($angle));
+ }
+
+ /**
+ * ACOT.
+ *
+ * Returns the arccotangent of a number.
+ *
+ * @param array|float $number Number, or can be an array of numbers
+ *
+ * @return array|float|string The arccotangent of the number
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function acot($number): array|string|float
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return (M_PI / 2) - atan($number);
+ }
+
+ /**
+ * ACOTH.
+ *
+ * Returns the hyperbolic arccotangent of a number.
+ *
+ * @param array|float $number Number, or can be an array of numbers
+ *
+ * @return array|float|string The hyperbolic arccotangent of the number
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function acoth($number)
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $result = ($number === 1) ? NAN : (log(($number + 1) / ($number - 1)) / 2);
+
+ return Helpers::numberOrNan($result);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Secant.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Secant.php
new file mode 100644
index 00000000..2d26e5dd
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Secant.php
@@ -0,0 +1,64 @@
+getMessage();
+ }
+
+ return Helpers::verySmallDenominator(1.0, cos($angle));
+ }
+
+ /**
+ * SECH.
+ *
+ * Returns the hyperbolic secant of an angle.
+ *
+ * @param array|float $angle Number, or can be an array of numbers
+ *
+ * @return array|float|string The hyperbolic secant of the angle
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function sech($angle)
+ {
+ if (is_array($angle)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $angle);
+ }
+
+ try {
+ $angle = Helpers::validateNumericNullBool($angle);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return Helpers::verySmallDenominator(1.0, cosh($angle));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Sine.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Sine.php
new file mode 100644
index 00000000..924466e9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Sine.php
@@ -0,0 +1,116 @@
+getMessage();
+ }
+
+ return sin($angle);
+ }
+
+ /**
+ * SINH.
+ *
+ * Returns the result of builtin function sinh after validating args.
+ *
+ * @param mixed $angle Should be numeric, or can be an array of numbers
+ *
+ * @return array|float|string hyperbolic sine
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function sinh(mixed $angle): array|string|float
+ {
+ if (is_array($angle)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $angle);
+ }
+
+ try {
+ $angle = Helpers::validateNumericNullBool($angle);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return sinh($angle);
+ }
+
+ /**
+ * ASIN.
+ *
+ * Returns the arcsine of a number.
+ *
+ * @param array|float $number Number, or can be an array of numbers
+ *
+ * @return array|float|string The arcsine of the number
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function asin($number)
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return Helpers::numberOrNan(asin($number));
+ }
+
+ /**
+ * ASINH.
+ *
+ * Returns the inverse hyperbolic sine of a number.
+ *
+ * @param array|float $number Number, or can be an array of numbers
+ *
+ * @return array|float|string The inverse hyperbolic sine of the number
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function asinh($number)
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return Helpers::numberOrNan(asinh($number));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Tangent.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Tangent.php
new file mode 100644
index 00000000..9d6775f4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trig/Tangent.php
@@ -0,0 +1,160 @@
+getMessage();
+ }
+
+ return Helpers::verySmallDenominator(sin($angle), cos($angle));
+ }
+
+ /**
+ * TANH.
+ *
+ * Returns the result of builtin function sinh after validating args.
+ *
+ * @param mixed $angle Should be numeric, or can be an array of numbers
+ *
+ * @return array|float|string hyperbolic tangent
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function tanh(mixed $angle): array|string|float
+ {
+ if (is_array($angle)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $angle);
+ }
+
+ try {
+ $angle = Helpers::validateNumericNullBool($angle);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return tanh($angle);
+ }
+
+ /**
+ * ATAN.
+ *
+ * Returns the arctangent of a number.
+ *
+ * @param array|float $number Number, or can be an array of numbers
+ *
+ * @return array|float|string The arctangent of the number
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function atan($number)
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return Helpers::numberOrNan(atan($number));
+ }
+
+ /**
+ * ATANH.
+ *
+ * Returns the inverse hyperbolic tangent of a number.
+ *
+ * @param array|float $number Number, or can be an array of numbers
+ *
+ * @return array|float|string The inverse hyperbolic tangent of the number
+ * If an array of numbers is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function atanh($number)
+ {
+ if (is_array($number)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $number);
+ }
+
+ try {
+ $number = Helpers::validateNumericNullBool($number);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return Helpers::numberOrNan(atanh($number));
+ }
+
+ /**
+ * ATAN2.
+ *
+ * This function calculates the arc tangent of the two variables x and y. It is similar to
+ * calculating the arc tangent of y ÷ x, except that the signs of both arguments are used
+ * to determine the quadrant of the result.
+ * The arctangent is the angle from the x-axis to a line containing the origin (0, 0) and a
+ * point with coordinates (xCoordinate, yCoordinate). The angle is given in radians between
+ * -pi and pi, excluding -pi.
+ *
+ * Note that the Excel ATAN2() function accepts its arguments in the reverse order to the standard
+ * PHP atan2() function, so we need to reverse them here before calling the PHP atan() function.
+ *
+ * Excel Function:
+ * ATAN2(xCoordinate,yCoordinate)
+ *
+ * @param mixed $xCoordinate should be float, the x-coordinate of the point, or can be an array of numbers
+ * @param mixed $yCoordinate should be float, the y-coordinate of the point, or can be an array of numbers
+ *
+ * @return array|float|string The inverse tangent of the specified x- and y-coordinates, or a string containing an error
+ * If an array of numbers is passed as one of the arguments, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function atan2(mixed $xCoordinate, mixed $yCoordinate): array|string|float
+ {
+ if (is_array($xCoordinate) || is_array($yCoordinate)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $xCoordinate, $yCoordinate);
+ }
+
+ try {
+ $xCoordinate = Helpers::validateNumericNullBool($xCoordinate);
+ $yCoordinate = Helpers::validateNumericNullBool($yCoordinate);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if (($xCoordinate == 0) && ($yCoordinate == 0)) {
+ return ExcelError::DIV0();
+ }
+
+ return atan2($yCoordinate, $xCoordinate);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trunc.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trunc.php
new file mode 100644
index 00000000..096b27a5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/MathTrig/Trunc.php
@@ -0,0 +1,36 @@
+ $arg) {
+ $arg = self::testAcceptedBoolean($arg, $k);
+ // Is it a numeric value?
+ // Strings containing numeric values are only counted if they are string literals (not cell values)
+ // and then only in MS Excel and in Open Office, not in Gnumeric
+ if ((is_string($arg)) && (!is_numeric($arg)) && (!Functions::isCellValue($k))) {
+ return ExcelError::VALUE();
+ }
+ if (self::isAcceptedCountable($arg, $k)) {
+ $returnValue += abs($arg - $aMean);
+ ++$aCount;
+ }
+ }
+
+ // Return
+ if ($aCount === 0) {
+ return ExcelError::DIV0();
+ }
+
+ return $returnValue / $aCount;
+ }
+
+ /**
+ * AVERAGE.
+ *
+ * Returns the average (arithmetic mean) of the arguments
+ *
+ * Excel Function:
+ * AVERAGE(value1[,value2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ *
+ * @return float|int|string (string if result is an error)
+ */
+ public static function average(mixed ...$args): string|int|float
+ {
+ $returnValue = $aCount = 0;
+
+ // Loop through arguments
+ foreach (Functions::flattenArrayIndexed($args) as $k => $arg) {
+ $arg = self::testAcceptedBoolean($arg, $k);
+ // Is it a numeric value?
+ // Strings containing numeric values are only counted if they are string literals (not cell values)
+ // and then only in MS Excel and in Open Office, not in Gnumeric
+ if ((is_string($arg)) && (!is_numeric($arg)) && (!Functions::isCellValue($k))) {
+ return ExcelError::VALUE();
+ }
+ if (self::isAcceptedCountable($arg, $k)) {
+ $returnValue += $arg;
+ ++$aCount;
+ }
+ }
+
+ // Return
+ if ($aCount > 0) {
+ return $returnValue / $aCount;
+ }
+
+ return ExcelError::DIV0();
+ }
+
+ /**
+ * AVERAGEA.
+ *
+ * Returns the average of its arguments, including numbers, text, and logical values
+ *
+ * Excel Function:
+ * AVERAGEA(value1[,value2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ *
+ * @return float|int|string (string if result is an error)
+ */
+ public static function averageA(mixed ...$args): string|int|float
+ {
+ $returnValue = null;
+
+ $aCount = 0;
+ // Loop through arguments
+ foreach (Functions::flattenArrayIndexed($args) as $k => $arg) {
+ if (is_numeric($arg)) {
+ // do nothing
+ } elseif (is_bool($arg)) {
+ $arg = (int) $arg;
+ } elseif (!Functions::isMatrixValue($k)) {
+ $arg = 0;
+ } else {
+ return ExcelError::VALUE();
+ }
+ $returnValue += $arg;
+ ++$aCount;
+ }
+
+ if ($aCount > 0) {
+ return $returnValue / $aCount;
+ }
+
+ return ExcelError::DIV0();
+ }
+
+ /**
+ * MEDIAN.
+ *
+ * Returns the median of the given numbers. The median is the number in the middle of a set of numbers.
+ *
+ * Excel Function:
+ * MEDIAN(value1[,value2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ *
+ * @return float|string The result, or a string containing an error
+ */
+ public static function median(mixed ...$args): float|string
+ {
+ $aArgs = Functions::flattenArray($args);
+
+ $returnValue = ExcelError::NAN();
+
+ $aArgs = self::filterArguments($aArgs);
+ $valueCount = count($aArgs);
+ if ($valueCount > 0) {
+ sort($aArgs, SORT_NUMERIC);
+ $valueCount = $valueCount / 2;
+ if ($valueCount == floor($valueCount)) {
+ $returnValue = ($aArgs[$valueCount--] + $aArgs[$valueCount]) / 2;
+ } else {
+ $valueCount = floor($valueCount);
+ $returnValue = $aArgs[$valueCount];
+ }
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * MODE.
+ *
+ * Returns the most frequently occurring, or repetitive, value in an array or range of data
+ *
+ * Excel Function:
+ * MODE(value1[,value2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ *
+ * @return float|string The result, or a string containing an error
+ */
+ public static function mode(mixed ...$args): float|string
+ {
+ $returnValue = ExcelError::NA();
+
+ // Loop through arguments
+ $aArgs = Functions::flattenArray($args);
+ $aArgs = self::filterArguments($aArgs);
+
+ if (!empty($aArgs)) {
+ return self::modeCalc($aArgs);
+ }
+
+ return $returnValue;
+ }
+
+ protected static function filterArguments(array $args): array
+ {
+ return array_filter(
+ $args,
+ function ($value): bool {
+ // Is it a numeric value?
+ return is_numeric($value) && (!is_string($value));
+ }
+ );
+ }
+
+ /**
+ * Special variant of array_count_values that isn't limited to strings and integers,
+ * but can work with floating point numbers as values.
+ */
+ private static function modeCalc(array $data): float|string
+ {
+ $frequencyArray = [];
+ $index = 0;
+ $maxfreq = 0;
+ $maxfreqkey = '';
+ $maxfreqdatum = '';
+ foreach ($data as $datum) {
+ $found = false;
+ ++$index;
+ foreach ($frequencyArray as $key => $value) {
+ if ((string) $value['value'] == (string) $datum) {
+ ++$frequencyArray[$key]['frequency'];
+ $freq = $frequencyArray[$key]['frequency'];
+ if ($freq > $maxfreq) {
+ $maxfreq = $freq;
+ $maxfreqkey = $key;
+ $maxfreqdatum = $datum;
+ } elseif ($freq == $maxfreq) {
+ if ($frequencyArray[$key]['index'] < $frequencyArray[$maxfreqkey]['index']) {
+ $maxfreqkey = $key;
+ $maxfreqdatum = $datum;
+ }
+ }
+ $found = true;
+
+ break;
+ }
+ }
+
+ if ($found === false) {
+ $frequencyArray[] = [
+ 'value' => $datum,
+ 'frequency' => 1,
+ 'index' => $index,
+ ];
+ }
+ }
+
+ if ($maxfreq <= 1) {
+ return ExcelError::NA();
+ }
+
+ return $maxfreqdatum;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Averages/Mean.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Averages/Mean.php
new file mode 100644
index 00000000..2051675c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Averages/Mean.php
@@ -0,0 +1,126 @@
+ 0)) {
+ $aCount = Counts::COUNT($aArgs);
+ if (Minimum::min($aArgs) > 0) {
+ return $aMean ** (1 / $aCount);
+ }
+ }
+
+ return ExcelError::NAN();
+ }
+
+ /**
+ * HARMEAN.
+ *
+ * Returns the harmonic mean of a data set. The harmonic mean is the reciprocal of the
+ * arithmetic mean of reciprocals.
+ *
+ * Excel Function:
+ * HARMEAN(value1[,value2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ */
+ public static function harmonic(mixed ...$args): string|float|int
+ {
+ // Loop through arguments
+ $aArgs = Functions::flattenArray($args);
+ if (Minimum::min($aArgs) < 0) {
+ return ExcelError::NAN();
+ }
+
+ $returnValue = 0;
+ $aCount = 0;
+ foreach ($aArgs as $arg) {
+ // Is it a numeric value?
+ if ((is_numeric($arg)) && (!is_string($arg))) {
+ if ($arg <= 0) {
+ return ExcelError::NAN();
+ }
+ $returnValue += (1 / $arg);
+ ++$aCount;
+ }
+ }
+
+ // Return
+ if ($aCount > 0) {
+ return 1 / ($returnValue / $aCount);
+ }
+
+ return ExcelError::NA();
+ }
+
+ /**
+ * TRIMMEAN.
+ *
+ * Returns the mean of the interior of a data set. TRIMMEAN calculates the mean
+ * taken by excluding a percentage of data points from the top and bottom tails
+ * of a data set.
+ *
+ * Excel Function:
+ * TRIMEAN(value1[,value2[, ...]], $discard)
+ *
+ * @param mixed $args Data values
+ */
+ public static function trim(mixed ...$args): float|string
+ {
+ $aArgs = Functions::flattenArray($args);
+
+ // Calculate
+ $percent = array_pop($aArgs);
+
+ if ((is_numeric($percent)) && (!is_string($percent))) {
+ if (($percent < 0) || ($percent > 1)) {
+ return ExcelError::NAN();
+ }
+
+ $mArgs = [];
+ foreach ($aArgs as $arg) {
+ // Is it a numeric value?
+ if ((is_numeric($arg)) && (!is_string($arg))) {
+ $mArgs[] = $arg;
+ }
+ }
+
+ $discard = floor(Counts::COUNT($mArgs) * $percent / 2);
+ sort($mArgs);
+
+ for ($i = 0; $i < $discard; ++$i) {
+ array_pop($mArgs);
+ array_shift($mArgs);
+ }
+
+ return Averages::average($mArgs);
+ }
+
+ return ExcelError::VALUE();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Conditional.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Conditional.php
new file mode 100644
index 00000000..ae98c608
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Conditional.php
@@ -0,0 +1,293 @@
+ $value !== null && $value !== ''
+ );
+
+ $range = array_merge([[self::CONDITION_COLUMN_NAME]], array_chunk($range, 1));
+ $condition = array_merge([[self::CONDITION_COLUMN_NAME]], [[$condition]]);
+
+ return DCount::evaluate($range, null, $condition, false);
+ }
+
+ /**
+ * COUNTIFS.
+ *
+ * Counts the number of cells that contain numbers within the list of arguments
+ *
+ * Excel Function:
+ * COUNTIFS(criteria_range1, criteria1, [criteria_range2, criteria2]…)
+ *
+ * @param mixed $args Pairs of Ranges and Criteria
+ */
+ public static function COUNTIFS(mixed ...$args): int|string
+ {
+ if (empty($args)) {
+ return 0;
+ } elseif (count($args) === 2) {
+ return self::COUNTIF(...$args);
+ }
+
+ $database = self::buildDatabase(...$args);
+ $conditions = self::buildConditionSet(...$args);
+
+ return DCount::evaluate($database, null, $conditions, false);
+ }
+
+ /**
+ * MAXIFS.
+ *
+ * Returns the maximum value within a range of cells that contain numbers within the list of arguments
+ *
+ * Excel Function:
+ * MAXIFS(max_range, criteria_range1, criteria1, [criteria_range2, criteria2]…)
+ *
+ * @param mixed $args Pairs of Ranges and Criteria
+ */
+ public static function MAXIFS(mixed ...$args): null|float|string
+ {
+ if (empty($args)) {
+ return 0.0;
+ }
+
+ $conditions = self::buildConditionSetForValueRange(...$args);
+ $database = self::buildDatabaseWithValueRange(...$args);
+
+ return DMax::evaluate($database, self::VALUE_COLUMN_NAME, $conditions, false);
+ }
+
+ /**
+ * MINIFS.
+ *
+ * Returns the minimum value within a range of cells that contain numbers within the list of arguments
+ *
+ * Excel Function:
+ * MINIFS(min_range, criteria_range1, criteria1, [criteria_range2, criteria2]…)
+ *
+ * @param mixed $args Pairs of Ranges and Criteria
+ */
+ public static function MINIFS(mixed ...$args): null|float|string
+ {
+ if (empty($args)) {
+ return 0.0;
+ }
+
+ $conditions = self::buildConditionSetForValueRange(...$args);
+ $database = self::buildDatabaseWithValueRange(...$args);
+
+ return DMin::evaluate($database, self::VALUE_COLUMN_NAME, $conditions, false);
+ }
+
+ /**
+ * SUMIF.
+ *
+ * Totals the values of cells that contain numbers within the list of arguments
+ *
+ * Excel Function:
+ * SUMIF(range, criteria, [sum_range])
+ *
+ * @param array $range Data values
+ */
+ public static function SUMIF(array $range, mixed $condition, array $sumRange = []): null|float|string
+ {
+ $database = self::databaseFromRangeAndValue($range, $sumRange);
+ $condition = [[self::CONDITION_COLUMN_NAME, self::VALUE_COLUMN_NAME], [$condition, null]];
+
+ return DSum::evaluate($database, self::VALUE_COLUMN_NAME, $condition);
+ }
+
+ /**
+ * SUMIFS.
+ *
+ * Counts the number of cells that contain numbers within the list of arguments
+ *
+ * Excel Function:
+ * SUMIFS(average_range, criteria_range1, criteria1, [criteria_range2, criteria2]…)
+ *
+ * @param mixed $args Pairs of Ranges and Criteria
+ */
+ public static function SUMIFS(mixed ...$args): null|float|string
+ {
+ if (empty($args)) {
+ return 0.0;
+ } elseif (count($args) === 3) {
+ return self::SUMIF($args[1], $args[2], $args[0]);
+ }
+
+ $conditions = self::buildConditionSetForValueRange(...$args);
+ $database = self::buildDatabaseWithValueRange(...$args);
+
+ return DSum::evaluate($database, self::VALUE_COLUMN_NAME, $conditions);
+ }
+
+ /** @param array $args */
+ private static function buildConditionSet(...$args): array
+ {
+ $conditions = self::buildConditions(1, ...$args);
+
+ return array_map(null, ...$conditions);
+ }
+
+ /** @param array $args */
+ private static function buildConditionSetForValueRange(...$args): array
+ {
+ $conditions = self::buildConditions(2, ...$args);
+
+ if (count($conditions) === 1) {
+ return array_map(
+ fn ($value): array => [$value],
+ $conditions[0]
+ );
+ }
+
+ return array_map(null, ...$conditions);
+ }
+
+ /** @param array $args */
+ private static function buildConditions(int $startOffset, ...$args): array
+ {
+ $conditions = [];
+
+ $pairCount = 1;
+ $argumentCount = count($args);
+ for ($argument = $startOffset; $argument < $argumentCount; $argument += 2) {
+ $conditions[] = array_merge([sprintf(self::CONDITIONAL_COLUMN_NAME, $pairCount)], [$args[$argument]]);
+ ++$pairCount;
+ }
+
+ return $conditions;
+ }
+
+ /** @param array $args */
+ private static function buildDatabase(...$args): array
+ {
+ $database = [];
+
+ return self::buildDataSet(0, $database, ...$args);
+ }
+
+ /** @param array $args */
+ private static function buildDatabaseWithValueRange(...$args): array
+ {
+ $database = [];
+ $database[] = array_merge(
+ [self::VALUE_COLUMN_NAME],
+ Functions::flattenArray($args[0])
+ );
+
+ return self::buildDataSet(1, $database, ...$args);
+ }
+
+ /** @param array $args */
+ private static function buildDataSet(int $startOffset, array $database, ...$args): array
+ {
+ $pairCount = 1;
+ $argumentCount = count($args);
+ for ($argument = $startOffset; $argument < $argumentCount; $argument += 2) {
+ $database[] = array_merge(
+ [sprintf(self::CONDITIONAL_COLUMN_NAME, $pairCount)],
+ Functions::flattenArray($args[$argument])
+ );
+ ++$pairCount;
+ }
+
+ return array_map(null, ...$database);
+ }
+
+ private static function databaseFromRangeAndValue(array $range, array $valueRange = []): array
+ {
+ $range = Functions::flattenArray($range);
+
+ $valueRange = Functions::flattenArray($valueRange);
+ if (empty($valueRange)) {
+ $valueRange = $range;
+ }
+
+ $database = array_map(null, array_merge([self::CONDITION_COLUMN_NAME], $range), array_merge([self::VALUE_COLUMN_NAME], $valueRange));
+
+ return $database;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Confidence.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Confidence.php
new file mode 100644
index 00000000..492438ad
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Confidence.php
@@ -0,0 +1,51 @@
+getMessage();
+ }
+
+ if (($alpha <= 0) || ($alpha >= 1) || ($stdDev <= 0) || ($size < 1)) {
+ return ExcelError::NAN();
+ }
+ /** @var float $temp */
+ $temp = Distributions\StandardNormal::inverse(1 - $alpha / 2);
+
+ return Functions::scalar($temp * $stdDev / sqrt($size));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Counts.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Counts.php
new file mode 100644
index 00000000..20ed6349
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Counts.php
@@ -0,0 +1,96 @@
+ $arg) {
+ $arg = self::testAcceptedBoolean($arg, $k);
+ // Is it a numeric value?
+ // Strings containing numeric values are only counted if they are string literals (not cell values)
+ // and then only in MS Excel and in Open Office, not in Gnumeric
+ if (self::isAcceptedCountable($arg, $k, true)) {
+ ++$returnValue;
+ }
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * COUNTA.
+ *
+ * Counts the number of cells that are not empty within the list of arguments
+ *
+ * Excel Function:
+ * COUNTA(value1[,value2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ */
+ public static function COUNTA(mixed ...$args): int
+ {
+ $returnValue = 0;
+
+ // Loop through arguments
+ $aArgs = Functions::flattenArrayIndexed($args);
+ foreach ($aArgs as $k => $arg) {
+ // Nulls are counted if literals, but not if cell values
+ if ($arg !== null || (!Functions::isCellValue($k))) {
+ ++$returnValue;
+ }
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * COUNTBLANK.
+ *
+ * Counts the number of empty cells within the list of arguments
+ *
+ * Excel Function:
+ * COUNTBLANK(value1[,value2[, ...]])
+ *
+ * @param mixed $range Data values
+ */
+ public static function COUNTBLANK(mixed $range): int
+ {
+ if ($range === null) {
+ return 1;
+ }
+ if (!is_array($range) || array_key_exists(0, $range)) {
+ throw new CalcException('Must specify range of cells, not any kind of literal');
+ }
+ $returnValue = 0;
+
+ // Loop through arguments
+ $aArgs = Functions::flattenArray($range);
+ foreach ($aArgs as $arg) {
+ // Is it a blank cell?
+ if (($arg === null) || ((is_string($arg)) && ($arg == ''))) {
+ ++$returnValue;
+ }
+ }
+
+ return $returnValue;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Deviations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Deviations.php
new file mode 100644
index 00000000..77c0d38f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Deviations.php
@@ -0,0 +1,138 @@
+ $arg) {
+ // Is it a numeric value?
+ if (
+ (is_bool($arg))
+ && ((!Functions::isCellValue($k))
+ || (Functions::getCompatibilityMode() == Functions::COMPATIBILITY_OPENOFFICE))
+ ) {
+ $arg = (int) $arg;
+ }
+ if ((is_numeric($arg)) && (!is_string($arg))) {
+ $returnValue += ($arg - $aMean) ** 2;
+ ++$aCount;
+ }
+ }
+
+ return $aCount === 0 ? ExcelError::VALUE() : $returnValue;
+ }
+
+ /**
+ * KURT.
+ *
+ * Returns the kurtosis of a data set. Kurtosis characterizes the relative peakedness
+ * or flatness of a distribution compared with the normal distribution. Positive
+ * kurtosis indicates a relatively peaked distribution. Negative kurtosis indicates a
+ * relatively flat distribution.
+ *
+ * @param array ...$args Data Series
+ */
+ public static function kurtosis(...$args): string|int|float
+ {
+ $aArgs = Functions::flattenArrayIndexed($args);
+ $mean = Averages::average($aArgs);
+ if (!is_numeric($mean)) {
+ return ExcelError::DIV0();
+ }
+ $stdDev = (float) StandardDeviations::STDEV($aArgs);
+
+ if ($stdDev > 0) {
+ $count = $summer = 0;
+
+ foreach ($aArgs as $k => $arg) {
+ if ((is_bool($arg)) && (!Functions::isMatrixValue($k))) {
+ } else {
+ // Is it a numeric value?
+ if ((is_numeric($arg)) && (!is_string($arg))) {
+ $summer += (($arg - $mean) / $stdDev) ** 4;
+ ++$count;
+ }
+ }
+ }
+
+ if ($count > 3) {
+ return $summer * ($count * ($count + 1)
+ / (($count - 1) * ($count - 2) * ($count - 3))) - (3 * ($count - 1) ** 2
+ / (($count - 2) * ($count - 3)));
+ }
+ }
+
+ return ExcelError::DIV0();
+ }
+
+ /**
+ * SKEW.
+ *
+ * Returns the skewness of a distribution. Skewness characterizes the degree of asymmetry
+ * of a distribution around its mean. Positive skewness indicates a distribution with an
+ * asymmetric tail extending toward more positive values. Negative skewness indicates a
+ * distribution with an asymmetric tail extending toward more negative values.
+ *
+ * @param array ...$args Data Series
+ *
+ * @return float|int|string The result, or a string containing an error
+ */
+ public static function skew(...$args): string|int|float
+ {
+ $aArgs = Functions::flattenArrayIndexed($args);
+ $mean = Averages::average($aArgs);
+ if (!is_numeric($mean)) {
+ return ExcelError::DIV0();
+ }
+ $stdDev = StandardDeviations::STDEV($aArgs);
+ if ($stdDev === 0.0 || is_string($stdDev)) {
+ return ExcelError::DIV0();
+ }
+
+ $count = $summer = 0;
+ // Loop through arguments
+ foreach ($aArgs as $k => $arg) {
+ if ((is_bool($arg)) && (!Functions::isMatrixValue($k))) {
+ } elseif (!is_numeric($arg)) {
+ return ExcelError::VALUE();
+ } else {
+ // Is it a numeric value?
+ if ((is_numeric($arg)) && (!is_string($arg))) {
+ $summer += (($arg - $mean) / $stdDev) ** 3;
+ ++$count;
+ }
+ }
+ }
+
+ if ($count > 2) {
+ return $summer * ($count / (($count - 1) * ($count - 2)));
+ }
+
+ return ExcelError::DIV0();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Beta.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Beta.php
new file mode 100644
index 00000000..16817ce6
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Beta.php
@@ -0,0 +1,279 @@
+getMessage();
+ }
+
+ if ($rMin > $rMax) {
+ $tmp = $rMin;
+ $rMin = $rMax;
+ $rMax = $tmp;
+ }
+ if (($value < $rMin) || ($value > $rMax) || ($alpha <= 0) || ($beta <= 0) || ($rMin == $rMax)) {
+ return ExcelError::NAN();
+ }
+
+ $value -= $rMin;
+ $value /= ($rMax - $rMin);
+
+ return self::incompleteBeta($value, $alpha, $beta);
+ }
+
+ /**
+ * BETAINV.
+ *
+ * Returns the inverse of the Beta distribution.
+ *
+ * @param mixed $probability Float probability at which you want to evaluate the distribution
+ * Or can be an array of values
+ * @param mixed $alpha Parameter to the distribution as a float
+ * Or can be an array of values
+ * @param mixed $beta Parameter to the distribution as a float
+ * Or can be an array of values
+ * @param mixed $rMin Minimum value as a float
+ * Or can be an array of values
+ * @param mixed $rMax Maximum value as a float
+ * Or can be an array of values
+ *
+ * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function inverse(mixed $probability, mixed $alpha, mixed $beta, mixed $rMin = 0.0, mixed $rMax = 1.0): array|string|float
+ {
+ if (is_array($probability) || is_array($alpha) || is_array($beta) || is_array($rMin) || is_array($rMax)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $probability, $alpha, $beta, $rMin, $rMax);
+ }
+
+ $rMin = $rMin ?? 0.0;
+ $rMax = $rMax ?? 1.0;
+
+ try {
+ $probability = DistributionValidations::validateProbability($probability);
+ $alpha = DistributionValidations::validateFloat($alpha);
+ $beta = DistributionValidations::validateFloat($beta);
+ $rMax = DistributionValidations::validateFloat($rMax);
+ $rMin = DistributionValidations::validateFloat($rMin);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($rMin > $rMax) {
+ $tmp = $rMin;
+ $rMin = $rMax;
+ $rMax = $tmp;
+ }
+ if (($alpha <= 0) || ($beta <= 0) || ($rMin == $rMax) || ($probability <= 0.0)) {
+ return ExcelError::NAN();
+ }
+
+ return self::calculateInverse($probability, $alpha, $beta, $rMin, $rMax);
+ }
+
+ private static function calculateInverse(float $probability, float $alpha, float $beta, float $rMin, float $rMax): string|float
+ {
+ $a = 0;
+ $b = 2;
+ $guess = ($a + $b) / 2;
+
+ $i = 0;
+ while ((($b - $a) > Functions::PRECISION) && (++$i <= self::MAX_ITERATIONS)) {
+ $guess = ($a + $b) / 2;
+ $result = self::distribution($guess, $alpha, $beta);
+ if (($result === $probability) || ($result === 0.0)) {
+ $b = $a;
+ } elseif ($result > $probability) {
+ $b = $guess;
+ } else {
+ $a = $guess;
+ }
+ }
+
+ if ($i === self::MAX_ITERATIONS) {
+ return ExcelError::NA();
+ }
+
+ return round($rMin + $guess * ($rMax - $rMin), 12);
+ }
+
+ /**
+ * Incomplete beta function.
+ *
+ * @author Jaco van Kooten
+ * @author Paul Meagher
+ *
+ * The computation is based on formulas from Numerical Recipes, Chapter 6.4 (W.H. Press et al, 1992).
+ *
+ * @param float $x require 0<=x<=1
+ * @param float $p require p>0
+ * @param float $q require q>0
+ *
+ * @return float 0 if x<0, p<=0, q<=0 or p+q>2.55E305 and 1 if x>1 to avoid errors and over/underflow
+ */
+ public static function incompleteBeta(float $x, float $p, float $q): float
+ {
+ if ($x <= 0.0) {
+ return 0.0;
+ } elseif ($x >= 1.0) {
+ return 1.0;
+ } elseif (($p <= 0.0) || ($q <= 0.0) || (($p + $q) > self::LOG_GAMMA_X_MAX_VALUE)) {
+ return 0.0;
+ }
+
+ $beta_gam = exp((0 - self::logBeta($p, $q)) + $p * log($x) + $q * log(1.0 - $x));
+ if ($x < ($p + 1.0) / ($p + $q + 2.0)) {
+ return $beta_gam * self::betaFraction($x, $p, $q) / $p;
+ }
+
+ return 1.0 - ($beta_gam * self::betaFraction(1 - $x, $q, $p) / $q);
+ }
+
+ // Function cache for logBeta function
+
+ private static float $logBetaCacheP = 0.0;
+
+ private static float $logBetaCacheQ = 0.0;
+
+ private static float $logBetaCacheResult = 0.0;
+
+ /**
+ * The natural logarithm of the beta function.
+ *
+ * @param float $p require p>0
+ * @param float $q require q>0
+ *
+ * @return float 0 if p<=0, q<=0 or p+q>2.55E305 to avoid errors and over/underflow
+ *
+ * @author Jaco van Kooten
+ */
+ private static function logBeta(float $p, float $q): float
+ {
+ if ($p != self::$logBetaCacheP || $q != self::$logBetaCacheQ) {
+ self::$logBetaCacheP = $p;
+ self::$logBetaCacheQ = $q;
+ if (($p <= 0.0) || ($q <= 0.0) || (($p + $q) > self::LOG_GAMMA_X_MAX_VALUE)) {
+ self::$logBetaCacheResult = 0.0;
+ } else {
+ self::$logBetaCacheResult = Gamma::logGamma($p) + Gamma::logGamma($q) - Gamma::logGamma($p + $q);
+ }
+ }
+
+ return self::$logBetaCacheResult;
+ }
+
+ /**
+ * Evaluates of continued fraction part of incomplete beta function.
+ * Based on an idea from Numerical Recipes (W.H. Press et al, 1992).
+ *
+ * @author Jaco van Kooten
+ */
+ private static function betaFraction(float $x, float $p, float $q): float
+ {
+ $c = 1.0;
+ $sum_pq = $p + $q;
+ $p_plus = $p + 1.0;
+ $p_minus = $p - 1.0;
+ $h = 1.0 - $sum_pq * $x / $p_plus;
+ if (abs($h) < self::XMININ) {
+ $h = self::XMININ;
+ }
+ $h = 1.0 / $h;
+ $frac = $h;
+ $m = 1;
+ $delta = 0.0;
+ while ($m <= self::MAX_ITERATIONS && abs($delta - 1.0) > Functions::PRECISION) {
+ $m2 = 2 * $m;
+ // even index for d
+ $d = $m * ($q - $m) * $x / (($p_minus + $m2) * ($p + $m2));
+ $h = 1.0 + $d * $h;
+ if (abs($h) < self::XMININ) {
+ $h = self::XMININ;
+ }
+ $h = 1.0 / $h;
+ $c = 1.0 + $d / $c;
+ if (abs($c) < self::XMININ) {
+ $c = self::XMININ;
+ }
+ $frac *= $h * $c;
+ // odd index for d
+ $d = -($p + $m) * ($sum_pq + $m) * $x / (($p + $m2) * ($p_plus + $m2));
+ $h = 1.0 + $d * $h;
+ if (abs($h) < self::XMININ) {
+ $h = self::XMININ;
+ }
+ $h = 1.0 / $h;
+ $c = 1.0 + $d / $c;
+ if (abs($c) < self::XMININ) {
+ $c = self::XMININ;
+ }
+ $delta = $h * $c;
+ $frac *= $delta;
+ ++$m;
+ }
+
+ return $frac;
+ }
+
+ /*
+ private static function betaValue(float $a, float $b): float
+ {
+ return (Gamma::gammaValue($a) * Gamma::gammaValue($b)) /
+ Gamma::gammaValue($a + $b);
+ }
+
+ private static function regularizedIncompleteBeta(float $value, float $a, float $b): float
+ {
+ return self::incompleteBeta($value, $a, $b) / self::betaValue($a, $b);
+ }
+ */
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Binomial.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Binomial.php
new file mode 100644
index 00000000..2ce3fd5a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Binomial.php
@@ -0,0 +1,231 @@
+getMessage();
+ }
+
+ if (($value < 0) || ($value > $trials)) {
+ return ExcelError::NAN();
+ }
+
+ if ($cumulative) {
+ return self::calculateCumulativeBinomial($value, $trials, $probability);
+ }
+ /** @var float $comb */
+ $comb = Combinations::withoutRepetition($trials, $value);
+
+ return $comb * $probability ** $value
+ * (1 - $probability) ** ($trials - $value);
+ }
+
+ /**
+ * BINOM.DIST.RANGE.
+ *
+ * Returns returns the Binomial Distribution probability for the number of successes from a specified number
+ * of trials falling into a specified range.
+ *
+ * @param mixed $trials Integer number of trials
+ * Or can be an array of values
+ * @param mixed $probability Probability of success on each trial as a float
+ * Or can be an array of values
+ * @param mixed $successes The integer number of successes in trials
+ * Or can be an array of values
+ * @param mixed $limit Upper limit for successes in trials as null, or an integer
+ * If null, then this will indicate the same as the number of Successes
+ * Or can be an array of values
+ *
+ * @return array|float|int|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function range(mixed $trials, mixed $probability, mixed $successes, mixed $limit = null): array|string|float|int
+ {
+ if (is_array($trials) || is_array($probability) || is_array($successes) || is_array($limit)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $trials, $probability, $successes, $limit);
+ }
+
+ $limit = $limit ?? $successes;
+
+ try {
+ $trials = DistributionValidations::validateInt($trials);
+ $probability = DistributionValidations::validateProbability($probability);
+ $successes = DistributionValidations::validateInt($successes);
+ $limit = DistributionValidations::validateInt($limit);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if (($successes < 0) || ($successes > $trials)) {
+ return ExcelError::NAN();
+ }
+ if (($limit < 0) || ($limit > $trials) || $limit < $successes) {
+ return ExcelError::NAN();
+ }
+
+ $summer = 0;
+ for ($i = $successes; $i <= $limit; ++$i) {
+ /** @var float $comb */
+ $comb = Combinations::withoutRepetition($trials, $i);
+ $summer += $comb * $probability ** $i
+ * (1 - $probability) ** ($trials - $i);
+ }
+
+ return $summer;
+ }
+
+ /**
+ * NEGBINOMDIST.
+ *
+ * Returns the negative binomial distribution. NEGBINOMDIST returns the probability that
+ * there will be number_f failures before the number_s-th success, when the constant
+ * probability of a success is probability_s. This function is similar to the binomial
+ * distribution, except that the number of successes is fixed, and the number of trials is
+ * variable. Like the binomial, trials are assumed to be independent.
+ *
+ * @param mixed $failures Number of Failures as an integer
+ * Or can be an array of values
+ * @param mixed $successes Threshold number of Successes as an integer
+ * Or can be an array of values
+ * @param mixed $probability Probability of success on each trial as a float
+ * Or can be an array of values
+ *
+ * @return array|float|string The result, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ *
+ * TODO Add support for the cumulative flag not present for NEGBINOMDIST, but introduced for NEGBINOM.DIST
+ * The cumulative default should be false to reflect the behaviour of NEGBINOMDIST
+ */
+ public static function negative(mixed $failures, mixed $successes, mixed $probability): array|string|float
+ {
+ if (is_array($failures) || is_array($successes) || is_array($probability)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $failures, $successes, $probability);
+ }
+
+ try {
+ $failures = DistributionValidations::validateInt($failures);
+ $successes = DistributionValidations::validateInt($successes);
+ $probability = DistributionValidations::validateProbability($probability);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if (($failures < 0) || ($successes < 1)) {
+ return ExcelError::NAN();
+ }
+ if (Functions::getCompatibilityMode() == Functions::COMPATIBILITY_GNUMERIC) {
+ if (($failures + $successes - 1) <= 0) {
+ return ExcelError::NAN();
+ }
+ }
+ /** @var float $comb */
+ $comb = Combinations::withoutRepetition($failures + $successes - 1, $successes - 1);
+
+ return $comb
+ * ($probability ** $successes) * ((1 - $probability) ** $failures);
+ }
+
+ /**
+ * BINOM.INV.
+ *
+ * Returns the smallest value for which the cumulative binomial distribution is greater
+ * than or equal to a criterion value
+ *
+ * @param mixed $trials number of Bernoulli trials as an integer
+ * Or can be an array of values
+ * @param mixed $probability probability of a success on each trial as a float
+ * Or can be an array of values
+ * @param mixed $alpha criterion value as a float
+ * Or can be an array of values
+ *
+ * @return array|int|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function inverse(mixed $trials, mixed $probability, mixed $alpha): array|string|int
+ {
+ if (is_array($trials) || is_array($probability) || is_array($alpha)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $trials, $probability, $alpha);
+ }
+
+ try {
+ $trials = DistributionValidations::validateInt($trials);
+ $probability = DistributionValidations::validateProbability($probability);
+ $alpha = DistributionValidations::validateFloat($alpha);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($trials < 0) {
+ return ExcelError::NAN();
+ } elseif (($alpha < 0.0) || ($alpha > 1.0)) {
+ return ExcelError::NAN();
+ }
+
+ $successes = 0;
+ while ($successes <= $trials) {
+ $result = self::calculateCumulativeBinomial($successes, $trials, $probability);
+ if ($result >= $alpha) {
+ break;
+ }
+ ++$successes;
+ }
+
+ return $successes;
+ }
+
+ private static function calculateCumulativeBinomial(int $value, int $trials, float $probability): float|int
+ {
+ $summer = 0;
+ for ($i = 0; $i <= $value; ++$i) {
+ /** @var float $comb */
+ $comb = Combinations::withoutRepetition($trials, $i);
+ $summer += $comb * $probability ** $i
+ * (1 - $probability) ** ($trials - $i);
+ }
+
+ return $summer;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/ChiSquared.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/ChiSquared.php
new file mode 100644
index 00000000..49b0dfc9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/ChiSquared.php
@@ -0,0 +1,331 @@
+getMessage();
+ }
+
+ if ($degrees < 1) {
+ return ExcelError::NAN();
+ }
+ if ($value < 0) {
+ if (Functions::getCompatibilityMode() == Functions::COMPATIBILITY_GNUMERIC) {
+ return 1;
+ }
+
+ return ExcelError::NAN();
+ }
+
+ return 1 - (Gamma::incompleteGamma($degrees / 2, $value / 2) / Gamma::gammaValue($degrees / 2));
+ }
+
+ /**
+ * CHIDIST.
+ *
+ * Returns the one-tailed probability of the chi-squared distribution.
+ *
+ * @param mixed $value Float value for which we want the probability
+ * Or can be an array of values
+ * @param mixed $degrees Integer degrees of freedom
+ * Or can be an array of values
+ * @param mixed $cumulative Boolean value indicating if we want the cdf (true) or the pdf (false)
+ * Or can be an array of values
+ *
+ * @return array|float|int|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function distributionLeftTail(mixed $value, mixed $degrees, mixed $cumulative): array|string|int|float
+ {
+ if (is_array($value) || is_array($degrees) || is_array($cumulative)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $degrees, $cumulative);
+ }
+
+ try {
+ $value = DistributionValidations::validateFloat($value);
+ $degrees = DistributionValidations::validateInt($degrees);
+ $cumulative = DistributionValidations::validateBool($cumulative);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($degrees < 1) {
+ return ExcelError::NAN();
+ }
+ if ($value < 0) {
+ if (Functions::getCompatibilityMode() == Functions::COMPATIBILITY_GNUMERIC) {
+ return 1;
+ }
+
+ return ExcelError::NAN();
+ }
+
+ if ($cumulative === true) {
+ $temp = self::distributionRightTail($value, $degrees);
+
+ return 1 - (is_numeric($temp) ? $temp : 0);
+ }
+
+ return ($value ** (($degrees / 2) - 1) * exp(-$value / 2))
+ / ((2 ** ($degrees / 2)) * Gamma::gammaValue($degrees / 2));
+ }
+
+ /**
+ * CHIINV.
+ *
+ * Returns the inverse of the right-tailed probability of the chi-squared distribution.
+ *
+ * @param mixed $probability Float probability at which you want to evaluate the distribution
+ * Or can be an array of values
+ * @param mixed $degrees Integer degrees of freedom
+ * Or can be an array of values
+ *
+ * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function inverseRightTail(mixed $probability, mixed $degrees)
+ {
+ if (is_array($probability) || is_array($degrees)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $probability, $degrees);
+ }
+
+ try {
+ $probability = DistributionValidations::validateProbability($probability);
+ $degrees = DistributionValidations::validateInt($degrees);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($degrees < 1) {
+ return ExcelError::NAN();
+ }
+
+ $callback = function ($value) use ($degrees): float {
+ return 1 - (Gamma::incompleteGamma($degrees / 2, $value / 2)
+ / Gamma::gammaValue($degrees / 2));
+ };
+
+ $newtonRaphson = new NewtonRaphson($callback);
+
+ return $newtonRaphson->execute($probability);
+ }
+
+ /**
+ * CHIINV.
+ *
+ * Returns the inverse of the left-tailed probability of the chi-squared distribution.
+ *
+ * @param mixed $probability Float probability at which you want to evaluate the distribution
+ * Or can be an array of values
+ * @param mixed $degrees Integer degrees of freedom
+ * Or can be an array of values
+ *
+ * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function inverseLeftTail(mixed $probability, mixed $degrees): array|string|float
+ {
+ if (is_array($probability) || is_array($degrees)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $probability, $degrees);
+ }
+
+ try {
+ $probability = DistributionValidations::validateProbability($probability);
+ $degrees = DistributionValidations::validateInt($degrees);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($degrees < 1) {
+ return ExcelError::NAN();
+ }
+
+ return self::inverseLeftTailCalculation($probability, $degrees);
+ }
+
+ /**
+ * CHITEST.
+ *
+ * Uses the chi-square test to calculate the probability that the differences between two supplied data sets
+ * (of observed and expected frequencies), are likely to be simply due to sampling error,
+ * or if they are likely to be real.
+ *
+ * @param mixed $actual an array of observed frequencies
+ * @param mixed $expected an array of expected frequencies
+ */
+ public static function test(mixed $actual, mixed $expected): float|string
+ {
+ $rows = count($actual);
+ $actual = Functions::flattenArray($actual);
+ $expected = Functions::flattenArray($expected);
+ $columns = intdiv(count($actual), $rows);
+
+ $countActuals = count($actual);
+ $countExpected = count($expected);
+ if ($countActuals !== $countExpected || $countActuals === 1) {
+ return ExcelError::NAN();
+ }
+
+ $result = 0.0;
+ for ($i = 0; $i < $countActuals; ++$i) {
+ if ($expected[$i] == 0.0) {
+ return ExcelError::DIV0();
+ } elseif ($expected[$i] < 0.0) {
+ return ExcelError::NAN();
+ }
+ $result += (($actual[$i] - $expected[$i]) ** 2) / $expected[$i];
+ }
+
+ $degrees = self::degrees($rows, $columns);
+
+ $result = Functions::scalar(self::distributionRightTail($result, $degrees));
+
+ return $result;
+ }
+
+ protected static function degrees(int $rows, int $columns): int
+ {
+ if ($rows === 1) {
+ return $columns - 1;
+ } elseif ($columns === 1) {
+ return $rows - 1;
+ }
+
+ return ($columns - 1) * ($rows - 1);
+ }
+
+ private static function inverseLeftTailCalculation(float $probability, int $degrees): float
+ {
+ // bracket the root
+ $min = 0;
+ $sd = sqrt(2.0 * $degrees);
+ $max = 2 * $sd;
+ $s = -1;
+
+ while ($s * self::pchisq($max, $degrees) > $probability * $s) {
+ $min = $max;
+ $max += 2 * $sd;
+ }
+
+ // Find root using bisection
+ $chi2 = 0.5 * ($min + $max);
+
+ while (($max - $min) > self::EPS * $chi2) {
+ if ($s * self::pchisq($chi2, $degrees) > $probability * $s) {
+ $min = $chi2;
+ } else {
+ $max = $chi2;
+ }
+ $chi2 = 0.5 * ($min + $max);
+ }
+
+ return $chi2;
+ }
+
+ private static function pchisq(float $chi2, int $degrees): float
+ {
+ return self::gammp($degrees, 0.5 * $chi2);
+ }
+
+ private static function gammp(int $n, float $x): float
+ {
+ if ($x < 0.5 * $n + 1) {
+ return self::gser($n, $x);
+ }
+
+ return 1 - self::gcf($n, $x);
+ }
+
+ // Return the incomplete gamma function P(n/2,x) evaluated by
+ // series representation. Algorithm from numerical recipe.
+ // Assume that n is a positive integer and x>0, won't check arguments.
+ // Relative error controlled by the eps parameter
+ private static function gser(int $n, float $x): float
+ {
+ /** @var float $gln */
+ $gln = Gamma::ln($n / 2);
+ $a = 0.5 * $n;
+ $ap = $a;
+ $sum = 1.0 / $a;
+ $del = $sum;
+ for ($i = 1; $i < 101; ++$i) {
+ ++$ap;
+ $del = $del * $x / $ap;
+ $sum += $del;
+ if ($del < $sum * self::EPS) {
+ break;
+ }
+ }
+
+ return $sum * exp(-$x + $a * log($x) - $gln);
+ }
+
+ // Return the incomplete gamma function Q(n/2,x) evaluated by
+ // its continued fraction representation. Algorithm from numerical recipe.
+ // Assume that n is a postive integer and x>0, won't check arguments.
+ // Relative error controlled by the eps parameter
+ private static function gcf(int $n, float $x): float
+ {
+ /** @var float $gln */
+ $gln = Gamma::ln($n / 2);
+ $a = 0.5 * $n;
+ $b = $x + 1 - $a;
+ $fpmin = 1.e-300;
+ $c = 1 / $fpmin;
+ $d = 1 / $b;
+ $h = $d;
+ for ($i = 1; $i < 101; ++$i) {
+ $an = -$i * ($i - $a);
+ $b += 2;
+ $d = $an * $d + $b;
+ if (abs($d) < $fpmin) {
+ $d = $fpmin;
+ }
+ $c = $b + $an / $c;
+ if (abs($c) < $fpmin) {
+ $c = $fpmin;
+ }
+ $d = 1 / $d;
+ $del = $d * $c;
+ $h = $h * $del;
+ if (abs($del - 1) < self::EPS) {
+ break;
+ }
+ }
+
+ return $h * exp(-$x + $a * log($x) - $gln);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/DistributionValidations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/DistributionValidations.php
new file mode 100644
index 00000000..61c62f6a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/DistributionValidations.php
@@ -0,0 +1,21 @@
+ 1.0) {
+ throw new Exception(ExcelError::NAN());
+ }
+
+ return $probability;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Exponential.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Exponential.php
new file mode 100644
index 00000000..55264737
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Exponential.php
@@ -0,0 +1,54 @@
+getMessage();
+ }
+
+ if (($value < 0) || ($lambda < 0)) {
+ return ExcelError::NAN();
+ }
+
+ if ($cumulative === true) {
+ return 1 - exp(0 - $value * $lambda);
+ }
+
+ return $lambda * exp(0 - $value * $lambda);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/F.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/F.php
new file mode 100644
index 00000000..aa7a19dc
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/F.php
@@ -0,0 +1,63 @@
+getMessage();
+ }
+
+ if ($value < 0 || $u < 1 || $v < 1) {
+ return ExcelError::NAN();
+ }
+
+ if ($cumulative) {
+ $adjustedValue = ($u * $value) / ($u * $value + $v);
+
+ return Beta::incompleteBeta($adjustedValue, $u / 2, $v / 2);
+ }
+
+ return (Gamma::gammaValue(($v + $u) / 2)
+ / (Gamma::gammaValue($u / 2) * Gamma::gammaValue($v / 2)))
+ * (($u / $v) ** ($u / 2))
+ * (($value ** (($u - 2) / 2)) / ((1 + ($u / $v) * $value) ** (($u + $v) / 2)));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Fisher.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Fisher.php
new file mode 100644
index 00000000..9ad10dbc
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Fisher.php
@@ -0,0 +1,72 @@
+getMessage();
+ }
+
+ if (($value <= -1) || ($value >= 1)) {
+ return ExcelError::NAN();
+ }
+
+ return 0.5 * log((1 + $value) / (1 - $value));
+ }
+
+ /**
+ * FISHERINV.
+ *
+ * Returns the inverse of the Fisher transformation. Use this transformation when
+ * analyzing correlations between ranges or arrays of data. If y = FISHER(x), then
+ * FISHERINV(y) = x.
+ *
+ * @param mixed $probability Float probability at which you want to evaluate the distribution
+ * Or can be an array of values
+ *
+ * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function inverse(mixed $probability): array|string|float
+ {
+ if (is_array($probability)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $probability);
+ }
+
+ try {
+ DistributionValidations::validateFloat($probability);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ return (exp(2 * $probability) - 1) / (exp(2 * $probability) + 1);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Gamma.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Gamma.php
new file mode 100644
index 00000000..babe937d
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Gamma.php
@@ -0,0 +1,148 @@
+getMessage();
+ }
+
+ if ((((int) $value) == ((float) $value)) && $value <= 0.0) {
+ return ExcelError::NAN();
+ }
+
+ return self::gammaValue($value);
+ }
+
+ /**
+ * GAMMADIST.
+ *
+ * Returns the gamma distribution.
+ *
+ * @param mixed $value Float Value at which you want to evaluate the distribution
+ * Or can be an array of values
+ * @param mixed $a Parameter to the distribution as a float
+ * Or can be an array of values
+ * @param mixed $b Parameter to the distribution as a float
+ * Or can be an array of values
+ * @param mixed $cumulative Boolean value indicating if we want the cdf (true) or the pdf (false)
+ * Or can be an array of values
+ *
+ * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function distribution(mixed $value, mixed $a, mixed $b, mixed $cumulative)
+ {
+ if (is_array($value) || is_array($a) || is_array($b) || is_array($cumulative)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $a, $b, $cumulative);
+ }
+
+ try {
+ $value = DistributionValidations::validateFloat($value);
+ $a = DistributionValidations::validateFloat($a);
+ $b = DistributionValidations::validateFloat($b);
+ $cumulative = DistributionValidations::validateBool($cumulative);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if (($value < 0) || ($a <= 0) || ($b <= 0)) {
+ return ExcelError::NAN();
+ }
+
+ return self::calculateDistribution($value, $a, $b, $cumulative);
+ }
+
+ /**
+ * GAMMAINV.
+ *
+ * Returns the inverse of the Gamma distribution.
+ *
+ * @param mixed $probability Float probability at which you want to evaluate the distribution
+ * Or can be an array of values
+ * @param mixed $alpha Parameter to the distribution as a float
+ * Or can be an array of values
+ * @param mixed $beta Parameter to the distribution as a float
+ * Or can be an array of values
+ *
+ * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function inverse(mixed $probability, mixed $alpha, mixed $beta)
+ {
+ if (is_array($probability) || is_array($alpha) || is_array($beta)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $probability, $alpha, $beta);
+ }
+
+ try {
+ $probability = DistributionValidations::validateProbability($probability);
+ $alpha = DistributionValidations::validateFloat($alpha);
+ $beta = DistributionValidations::validateFloat($beta);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if (($alpha <= 0.0) || ($beta <= 0.0)) {
+ return ExcelError::NAN();
+ }
+
+ return self::calculateInverse($probability, $alpha, $beta);
+ }
+
+ /**
+ * GAMMALN.
+ *
+ * Returns the natural logarithm of the gamma function.
+ *
+ * @param mixed $value Float Value at which you want to evaluate the distribution
+ * Or can be an array of values
+ *
+ * @return array|float|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function ln(mixed $value): array|string|float
+ {
+ if (is_array($value)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);
+ }
+
+ try {
+ $value = DistributionValidations::validateFloat($value);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($value <= 0) {
+ return ExcelError::NAN();
+ }
+
+ return log(self::gammaValue($value));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/GammaBase.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/GammaBase.php
new file mode 100644
index 00000000..6ce99d8b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/GammaBase.php
@@ -0,0 +1,388 @@
+ Functions::PRECISION) && (++$i <= self::MAX_ITERATIONS)) {
+ // Apply Newton-Raphson step
+ $result = self::calculateDistribution($x, $alpha, $beta, true);
+ if (!is_float($result)) {
+ return ExcelError::NA();
+ }
+ $error = $result - $probability;
+
+ if ($error == 0.0) {
+ $dx = 0;
+ } elseif ($error < 0.0) {
+ $xLo = $x;
+ } else {
+ $xHi = $x;
+ }
+
+ $pdf = self::calculateDistribution($x, $alpha, $beta, false);
+ // Avoid division by zero
+ if (!is_float($pdf)) {
+ return ExcelError::NA();
+ }
+ if ($pdf !== 0.0) {
+ $dx = $error / $pdf;
+ $xNew = $x - $dx;
+ }
+
+ // If the NR fails to converge (which for example may be the
+ // case if the initial guess is too rough) we apply a bisection
+ // step to determine a more narrow interval around the root.
+ if (($xNew < $xLo) || ($xNew > $xHi) || ($pdf == 0.0)) {
+ $xNew = ($xLo + $xHi) / 2;
+ $dx = $xNew - $x;
+ }
+ $x = $xNew;
+ }
+
+ if ($i === self::MAX_ITERATIONS) {
+ return ExcelError::NA();
+ }
+
+ return $x;
+ }
+
+ //
+ // Implementation of the incomplete Gamma function
+ //
+ public static function incompleteGamma(float $a, float $x): float
+ {
+ static $max = 32;
+ $summer = 0;
+ for ($n = 0; $n <= $max; ++$n) {
+ $divisor = $a;
+ for ($i = 1; $i <= $n; ++$i) {
+ $divisor *= ($a + $i);
+ }
+ $summer += ($x ** $n / $divisor);
+ }
+
+ return $x ** $a * exp(0 - $x) * $summer;
+ }
+
+ //
+ // Implementation of the Gamma function
+ //
+ public static function gammaValue(float $value): float
+ {
+ if ($value == 0.0) {
+ return 0;
+ }
+
+ static $p0 = 1.000000000190015;
+ static $p = [
+ 1 => 76.18009172947146,
+ 2 => -86.50532032941677,
+ 3 => 24.01409824083091,
+ 4 => -1.231739572450155,
+ 5 => 1.208650973866179e-3,
+ 6 => -5.395239384953e-6,
+ ];
+
+ $y = $x = $value;
+ $tmp = $x + 5.5;
+ $tmp -= ($x + 0.5) * log($tmp);
+
+ $summer = $p0;
+ for ($j = 1; $j <= 6; ++$j) {
+ $summer += ($p[$j] / ++$y);
+ }
+
+ return exp(0 - $tmp + log(self::SQRT2PI * $summer / $x));
+ }
+
+ private const LG_D1 = -0.5772156649015328605195174;
+
+ private const LG_D2 = 0.4227843350984671393993777;
+
+ private const LG_D4 = 1.791759469228055000094023;
+
+ private const LG_P1 = [
+ 4.945235359296727046734888,
+ 201.8112620856775083915565,
+ 2290.838373831346393026739,
+ 11319.67205903380828685045,
+ 28557.24635671635335736389,
+ 38484.96228443793359990269,
+ 26377.48787624195437963534,
+ 7225.813979700288197698961,
+ ];
+
+ private const LG_P2 = [
+ 4.974607845568932035012064,
+ 542.4138599891070494101986,
+ 15506.93864978364947665077,
+ 184793.2904445632425417223,
+ 1088204.76946882876749847,
+ 3338152.967987029735917223,
+ 5106661.678927352456275255,
+ 3074109.054850539556250927,
+ ];
+
+ private const LG_P4 = [
+ 14745.02166059939948905062,
+ 2426813.369486704502836312,
+ 121475557.4045093227939592,
+ 2663432449.630976949898078,
+ 29403789566.34553899906876,
+ 170266573776.5398868392998,
+ 492612579337.743088758812,
+ 560625185622.3951465078242,
+ ];
+
+ private const LG_Q1 = [
+ 67.48212550303777196073036,
+ 1113.332393857199323513008,
+ 7738.757056935398733233834,
+ 27639.87074403340708898585,
+ 54993.10206226157329794414,
+ 61611.22180066002127833352,
+ 36351.27591501940507276287,
+ 8785.536302431013170870835,
+ ];
+
+ private const LG_Q2 = [
+ 183.0328399370592604055942,
+ 7765.049321445005871323047,
+ 133190.3827966074194402448,
+ 1136705.821321969608938755,
+ 5267964.117437946917577538,
+ 13467014.54311101692290052,
+ 17827365.30353274213975932,
+ 9533095.591844353613395747,
+ ];
+
+ private const LG_Q4 = [
+ 2690.530175870899333379843,
+ 639388.5654300092398984238,
+ 41355999.30241388052042842,
+ 1120872109.61614794137657,
+ 14886137286.78813811542398,
+ 101680358627.2438228077304,
+ 341747634550.7377132798597,
+ 446315818741.9713286462081,
+ ];
+
+ private const LG_C = [
+ -0.001910444077728,
+ 8.4171387781295e-4,
+ -5.952379913043012e-4,
+ 7.93650793500350248e-4,
+ -0.002777777777777681622553,
+ 0.08333333333333333331554247,
+ 0.0057083835261,
+ ];
+
+ // Rough estimate of the fourth root of logGamma_xBig
+ private const LG_FRTBIG = 2.25e76;
+
+ private const PNT68 = 0.6796875;
+
+ // Function cache for logGamma
+
+ private static float $logGammaCacheResult = 0.0;
+
+ private static float $logGammaCacheX = 0.0;
+
+ /**
+ * logGamma function.
+ *
+ * Original author was Jaco van Kooten. Ported to PHP by Paul Meagher.
+ *
+ * The natural logarithm of the gamma function.
+ * Based on public domain NETLIB (Fortran) code by W. J. Cody and L. Stoltz
+ * Applied Mathematics Division
+ * Argonne National Laboratory
+ * Argonne, IL 60439
+ *
+ * References:
+ *
+ * W. J. Cody and K. E. Hillstrom, 'Chebyshev Approximations for the Natural
+ * Logarithm of the Gamma Function,' Math. Comp. 21, 1967, pp. 198-203.
+ * K. E. Hillstrom, ANL/AMD Program ANLC366S, DGAMMA/DLGAMA, May, 1969.
+ * Hart, Et. Al., Computer Approximations, Wiley and sons, New York, 1968.
+ *
+ *
+ *
+ * From the original documentation:
+ *
+ *
+ * This routine calculates the LOG(GAMMA) function for a positive real argument X.
+ * Computation is based on an algorithm outlined in references 1 and 2.
+ * The program uses rational functions that theoretically approximate LOG(GAMMA)
+ * to at least 18 significant decimal digits. The approximation for X > 12 is from
+ * reference 3, while approximations for X < 12.0 are similar to those in reference
+ * 1, but are unpublished. The accuracy achieved depends on the arithmetic system,
+ * the compiler, the intrinsic functions, and proper selection of the
+ * machine-dependent constants.
+ *
+ *
+ * Error returns:
+ * The program returns the value XINF for X .LE. 0.0 or when overflow would occur.
+ * The computation is believed to be free of underflow and overflow.
+ *
+ *
+ * @version 1.1
+ *
+ * @author Jaco van Kooten
+ *
+ * @return float MAX_VALUE for x < 0.0 or when overflow would occur, i.e. x > 2.55E305
+ */
+ public static function logGamma(float $x): float
+ {
+ if ($x == self::$logGammaCacheX) {
+ return self::$logGammaCacheResult;
+ }
+
+ $y = $x;
+ if ($y > 0.0 && $y <= self::LOG_GAMMA_X_MAX_VALUE) {
+ if ($y <= self::EPS) {
+ $res = -log($y);
+ } elseif ($y <= 1.5) {
+ $res = self::logGamma1($y);
+ } elseif ($y <= 4.0) {
+ $res = self::logGamma2($y);
+ } elseif ($y <= 12.0) {
+ $res = self::logGamma3($y);
+ } else {
+ $res = self::logGamma4($y);
+ }
+ } else {
+ // --------------------------
+ // Return for bad arguments
+ // --------------------------
+ $res = self::MAX_VALUE;
+ }
+
+ // ------------------------------
+ // Final adjustments and return
+ // ------------------------------
+ self::$logGammaCacheX = $x;
+ self::$logGammaCacheResult = $res;
+
+ return $res;
+ }
+
+ private static function logGamma1(float $y): float
+ {
+ // ---------------------
+ // EPS .LT. X .LE. 1.5
+ // ---------------------
+ if ($y < self::PNT68) {
+ $corr = -log($y);
+ $xm1 = $y;
+ } else {
+ $corr = 0.0;
+ $xm1 = $y - 1.0;
+ }
+
+ $xden = 1.0;
+ $xnum = 0.0;
+ if ($y <= 0.5 || $y >= self::PNT68) {
+ for ($i = 0; $i < 8; ++$i) {
+ $xnum = $xnum * $xm1 + self::LG_P1[$i];
+ $xden = $xden * $xm1 + self::LG_Q1[$i];
+ }
+
+ return $corr + $xm1 * (self::LG_D1 + $xm1 * ($xnum / $xden));
+ }
+
+ $xm2 = $y - 1.0;
+ for ($i = 0; $i < 8; ++$i) {
+ $xnum = $xnum * $xm2 + self::LG_P2[$i];
+ $xden = $xden * $xm2 + self::LG_Q2[$i];
+ }
+
+ return $corr + $xm2 * (self::LG_D2 + $xm2 * ($xnum / $xden));
+ }
+
+ private static function logGamma2(float $y): float
+ {
+ // ---------------------
+ // 1.5 .LT. X .LE. 4.0
+ // ---------------------
+ $xm2 = $y - 2.0;
+ $xden = 1.0;
+ $xnum = 0.0;
+ for ($i = 0; $i < 8; ++$i) {
+ $xnum = $xnum * $xm2 + self::LG_P2[$i];
+ $xden = $xden * $xm2 + self::LG_Q2[$i];
+ }
+
+ return $xm2 * (self::LG_D2 + $xm2 * ($xnum / $xden));
+ }
+
+ protected static function logGamma3(float $y): float
+ {
+ // ----------------------
+ // 4.0 .LT. X .LE. 12.0
+ // ----------------------
+ $xm4 = $y - 4.0;
+ $xden = -1.0;
+ $xnum = 0.0;
+ for ($i = 0; $i < 8; ++$i) {
+ $xnum = $xnum * $xm4 + self::LG_P4[$i];
+ $xden = $xden * $xm4 + self::LG_Q4[$i];
+ }
+
+ return self::LG_D4 + $xm4 * ($xnum / $xden);
+ }
+
+ protected static function logGamma4(float $y): float
+ {
+ // ---------------------------------
+ // Evaluate for argument .GE. 12.0
+ // ---------------------------------
+ $res = 0.0;
+ if ($y <= self::LG_FRTBIG) {
+ $res = self::LG_C[6];
+ $ysq = $y * $y;
+ for ($i = 0; $i < 6; ++$i) {
+ $res = $res / $ysq + self::LG_C[$i];
+ }
+ $res /= $y;
+ $corr = log($y);
+ $res = $res + log(self::SQRT2PI) - 0.5 * $corr;
+ $res += $y * ($corr - 1.0);
+ }
+
+ return $res;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/HyperGeometric.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/HyperGeometric.php
new file mode 100644
index 00000000..345ea81b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/HyperGeometric.php
@@ -0,0 +1,75 @@
+getMessage();
+ }
+
+ if (($sampleSuccesses < 0) || ($sampleSuccesses > $sampleNumber) || ($sampleSuccesses > $populationSuccesses)) {
+ return ExcelError::NAN();
+ }
+ if (($sampleNumber <= 0) || ($sampleNumber > $populationNumber)) {
+ return ExcelError::NAN();
+ }
+ if (($populationSuccesses <= 0) || ($populationSuccesses > $populationNumber)) {
+ return ExcelError::NAN();
+ }
+
+ $successesPopulationAndSample = (float) Combinations::withoutRepetition($populationSuccesses, $sampleSuccesses);
+ $numbersPopulationAndSample = (float) Combinations::withoutRepetition($populationNumber, $sampleNumber);
+ $adjustedPopulationAndSample = (float) Combinations::withoutRepetition(
+ $populationNumber - $populationSuccesses,
+ $sampleNumber - $sampleSuccesses
+ );
+
+ return $successesPopulationAndSample * $adjustedPopulationAndSample / $numbersPopulationAndSample;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/LogNormal.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/LogNormal.php
new file mode 100644
index 00000000..50f02e41
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/LogNormal.php
@@ -0,0 +1,139 @@
+getMessage();
+ }
+
+ if (($value <= 0) || ($stdDev <= 0)) {
+ return ExcelError::NAN();
+ }
+
+ return StandardNormal::cumulative((log($value) - $mean) / $stdDev);
+ }
+
+ /**
+ * LOGNORM.DIST.
+ *
+ * Returns the lognormal distribution of x, where ln(x) is normally distributed
+ * with parameters mean and standard_dev.
+ *
+ * @param mixed $value Float value for which we want the probability
+ * Or can be an array of values
+ * @param mixed $mean Mean value as a float
+ * Or can be an array of values
+ * @param mixed $stdDev Standard Deviation as a float
+ * Or can be an array of values
+ * @param mixed $cumulative Boolean value indicating if we want the cdf (true) or the pdf (false)
+ * Or can be an array of values
+ *
+ * @return array|float|string The result, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function distribution(mixed $value, mixed $mean, mixed $stdDev, mixed $cumulative = false)
+ {
+ if (is_array($value) || is_array($mean) || is_array($stdDev) || is_array($cumulative)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $mean, $stdDev, $cumulative);
+ }
+
+ try {
+ $value = DistributionValidations::validateFloat($value);
+ $mean = DistributionValidations::validateFloat($mean);
+ $stdDev = DistributionValidations::validateFloat($stdDev);
+ $cumulative = DistributionValidations::validateBool($cumulative);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if (($value <= 0) || ($stdDev <= 0)) {
+ return ExcelError::NAN();
+ }
+
+ if ($cumulative === true) {
+ return StandardNormal::distribution((log($value) - $mean) / $stdDev, true);
+ }
+
+ return (1 / (sqrt(2 * M_PI) * $stdDev * $value))
+ * exp(0 - ((log($value) - $mean) ** 2 / (2 * $stdDev ** 2)));
+ }
+
+ /**
+ * LOGINV.
+ *
+ * Returns the inverse of the lognormal cumulative distribution
+ *
+ * @param mixed $probability Float probability for which we want the value
+ * Or can be an array of values
+ * @param mixed $mean Mean Value as a float
+ * Or can be an array of values
+ * @param mixed $stdDev Standard Deviation as a float
+ * Or can be an array of values
+ *
+ * @return array|float|string The result, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ *
+ * @TODO Try implementing P J Acklam's refinement algorithm for greater
+ * accuracy if I can get my head round the mathematics
+ * (as described at) http://home.online.no/~pjacklam/notes/invnorm/
+ */
+ public static function inverse(mixed $probability, mixed $mean, mixed $stdDev): array|string|float
+ {
+ if (is_array($probability) || is_array($mean) || is_array($stdDev)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $probability, $mean, $stdDev);
+ }
+
+ try {
+ $probability = DistributionValidations::validateProbability($probability);
+ $mean = DistributionValidations::validateFloat($mean);
+ $stdDev = DistributionValidations::validateFloat($stdDev);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($stdDev <= 0) {
+ return ExcelError::NAN();
+ }
+ /** @var float $inverse */
+ $inverse = StandardNormal::inverse($probability);
+
+ return exp($mean + $stdDev * $inverse);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/NewtonRaphson.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/NewtonRaphson.php
new file mode 100644
index 00000000..647c0c46
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/NewtonRaphson.php
@@ -0,0 +1,64 @@
+callback = $callback;
+ }
+
+ public function execute(float $probability): string|int|float
+ {
+ $xLo = 100;
+ $xHi = 0;
+
+ $dx = 1;
+ $x = $xNew = 1;
+ $i = 0;
+
+ while ((abs($dx) > Functions::PRECISION) && ($i++ < self::MAX_ITERATIONS)) {
+ // Apply Newton-Raphson step
+ $result = call_user_func($this->callback, $x);
+ $error = $result - $probability;
+
+ if ($error == 0.0) {
+ $dx = 0;
+ } elseif ($error < 0.0) {
+ $xLo = $x;
+ } else {
+ $xHi = $x;
+ }
+
+ // Avoid division by zero
+ if ($result != 0.0) {
+ $dx = $error / $result;
+ $xNew = $x - $dx;
+ }
+
+ // If the NR fails to converge (which for example may be the
+ // case if the initial guess is too rough) we apply a bisection
+ // step to determine a more narrow interval around the root.
+ if (($xNew < $xLo) || ($xNew > $xHi) || ($result == 0.0)) {
+ $xNew = ($xLo + $xHi) / 2;
+ $dx = $xNew - $x;
+ }
+ $x = $xNew;
+ }
+
+ if ($i == self::MAX_ITERATIONS) {
+ return ExcelError::NA();
+ }
+
+ return $x;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Normal.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Normal.php
new file mode 100644
index 00000000..8d08d57a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Normal.php
@@ -0,0 +1,180 @@
+getMessage();
+ }
+
+ if ($stdDev < 0) {
+ return ExcelError::NAN();
+ }
+
+ if ($cumulative) {
+ return 0.5 * (1 + Engineering\Erf::erfValue(($value - $mean) / ($stdDev * sqrt(2))));
+ }
+
+ return (1 / (self::SQRT2PI * $stdDev)) * exp(0 - (($value - $mean) ** 2 / (2 * ($stdDev * $stdDev))));
+ }
+
+ /**
+ * NORMINV.
+ *
+ * Returns the inverse of the normal cumulative distribution for the specified mean and standard deviation.
+ *
+ * @param mixed $probability Float probability for which we want the value
+ * Or can be an array of values
+ * @param mixed $mean Mean Value as a float
+ * Or can be an array of values
+ * @param mixed $stdDev Standard Deviation as a float
+ * Or can be an array of values
+ *
+ * @return array|float|string The result, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function inverse(mixed $probability, mixed $mean, mixed $stdDev): array|string|float
+ {
+ if (is_array($probability) || is_array($mean) || is_array($stdDev)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $probability, $mean, $stdDev);
+ }
+
+ try {
+ $probability = DistributionValidations::validateProbability($probability);
+ $mean = DistributionValidations::validateFloat($mean);
+ $stdDev = DistributionValidations::validateFloat($stdDev);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($stdDev < 0) {
+ return ExcelError::NAN();
+ }
+
+ return (self::inverseNcdf($probability) * $stdDev) + $mean;
+ }
+
+ /*
+ * inverse_ncdf.php
+ * -------------------
+ * begin : Friday, January 16, 2004
+ * copyright : (C) 2004 Michael Nickerson
+ * email : nickersonm@yahoo.com
+ *
+ */
+ private static function inverseNcdf(float $p): float
+ {
+ // Inverse ncdf approximation by Peter J. Acklam, implementation adapted to
+ // PHP by Michael Nickerson, using Dr. Thomas Ziegler's C implementation as
+ // a guide. http://home.online.no/~pjacklam/notes/invnorm/index.html
+ // I have not checked the accuracy of this implementation. Be aware that PHP
+ // will truncate the coeficcients to 14 digits.
+
+ // You have permission to use and distribute this function freely for
+ // whatever purpose you want, but please show common courtesy and give credit
+ // where credit is due.
+
+ // Input paramater is $p - probability - where 0 < p < 1.
+
+ // Coefficients in rational approximations
+ static $a = [
+ 1 => -3.969683028665376e+01,
+ 2 => 2.209460984245205e+02,
+ 3 => -2.759285104469687e+02,
+ 4 => 1.383577518672690e+02,
+ 5 => -3.066479806614716e+01,
+ 6 => 2.506628277459239e+00,
+ ];
+
+ static $b = [
+ 1 => -5.447609879822406e+01,
+ 2 => 1.615858368580409e+02,
+ 3 => -1.556989798598866e+02,
+ 4 => 6.680131188771972e+01,
+ 5 => -1.328068155288572e+01,
+ ];
+
+ static $c = [
+ 1 => -7.784894002430293e-03,
+ 2 => -3.223964580411365e-01,
+ 3 => -2.400758277161838e+00,
+ 4 => -2.549732539343734e+00,
+ 5 => 4.374664141464968e+00,
+ 6 => 2.938163982698783e+00,
+ ];
+
+ static $d = [
+ 1 => 7.784695709041462e-03,
+ 2 => 3.224671290700398e-01,
+ 3 => 2.445134137142996e+00,
+ 4 => 3.754408661907416e+00,
+ ];
+
+ // Define lower and upper region break-points.
+ $p_low = 0.02425; //Use lower region approx. below this
+ $p_high = 1 - $p_low; //Use upper region approx. above this
+
+ if (0 < $p && $p < $p_low) {
+ // Rational approximation for lower region.
+ $q = sqrt(-2 * log($p));
+
+ return ((((($c[1] * $q + $c[2]) * $q + $c[3]) * $q + $c[4]) * $q + $c[5]) * $q + $c[6])
+ / (((($d[1] * $q + $d[2]) * $q + $d[3]) * $q + $d[4]) * $q + 1);
+ } elseif ($p_high < $p && $p < 1) {
+ // Rational approximation for upper region.
+ $q = sqrt(-2 * log(1 - $p));
+
+ return -((((($c[1] * $q + $c[2]) * $q + $c[3]) * $q + $c[4]) * $q + $c[5]) * $q + $c[6])
+ / (((($d[1] * $q + $d[2]) * $q + $d[3]) * $q + $d[4]) * $q + 1);
+ }
+
+ // Rational approximation for central region.
+ $q = $p - 0.5;
+ $r = $q * $q;
+
+ return ((((($a[1] * $r + $a[2]) * $r + $a[3]) * $r + $a[4]) * $r + $a[5]) * $r + $a[6]) * $q
+ / ((((($b[1] * $r + $b[2]) * $r + $b[3]) * $r + $b[4]) * $r + $b[5]) * $r + 1);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Poisson.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Poisson.php
new file mode 100644
index 00000000..931568ee
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Poisson.php
@@ -0,0 +1,66 @@
+getMessage();
+ }
+
+ if (($value < 0) || ($mean < 0)) {
+ return ExcelError::NAN();
+ }
+
+ if ($cumulative) {
+ $summer = 0;
+ $floor = floor($value);
+ for ($i = 0; $i <= $floor; ++$i) {
+ /** @var float $fact */
+ $fact = MathTrig\Factorial::fact($i);
+ $summer += $mean ** $i / $fact;
+ }
+
+ return exp(0 - $mean) * $summer;
+ }
+ /** @var float $fact */
+ $fact = MathTrig\Factorial::fact($value);
+
+ return (exp(0 - $mean) * $mean ** $value) / $fact;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/StandardNormal.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/StandardNormal.php
new file mode 100644
index 00000000..cb2c646f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/StandardNormal.php
@@ -0,0 +1,158 @@
+getMessage();
+ }
+
+ if (($value < 0) || ($degrees < 1) || ($tails < 1) || ($tails > 2)) {
+ return ExcelError::NAN();
+ }
+
+ return self::calculateDistribution($value, $degrees, $tails);
+ }
+
+ /**
+ * TINV.
+ *
+ * Returns the one-tailed probability of the chi-squared distribution.
+ *
+ * @param mixed $probability Float probability for the function
+ * Or can be an array of values
+ * @param mixed $degrees Integer value for degrees of freedom
+ * Or can be an array of values
+ *
+ * @return array|float|string The result, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function inverse(mixed $probability, mixed $degrees)
+ {
+ if (is_array($probability) || is_array($degrees)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $probability, $degrees);
+ }
+
+ try {
+ $probability = DistributionValidations::validateProbability($probability);
+ $degrees = DistributionValidations::validateInt($degrees);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($degrees <= 0) {
+ return ExcelError::NAN();
+ }
+
+ $callback = fn ($value) => self::distribution($value, $degrees, 2);
+
+ $newtonRaphson = new NewtonRaphson($callback);
+
+ return $newtonRaphson->execute($probability);
+ }
+
+ private static function calculateDistribution(float $value, int $degrees, int $tails): float
+ {
+ // tdist, which finds the probability that corresponds to a given value
+ // of t with k degrees of freedom. This algorithm is translated from a
+ // pascal function on p81 of "Statistical Computing in Pascal" by D
+ // Cooke, A H Craven & G M Clark (1985: Edward Arnold (Pubs.) Ltd:
+ // London). The above Pascal algorithm is itself a translation of the
+ // fortran algoritm "AS 3" by B E Cooper of the Atlas Computer
+ // Laboratory as reported in (among other places) "Applied Statistics
+ // Algorithms", editied by P Griffiths and I D Hill (1985; Ellis
+ // Horwood Ltd.; W. Sussex, England).
+ $tterm = $degrees;
+ $ttheta = atan2($value, sqrt($tterm));
+ $tc = cos($ttheta);
+ $ts = sin($ttheta);
+
+ if (($degrees % 2) === 1) {
+ $ti = 3;
+ $tterm = $tc;
+ } else {
+ $ti = 2;
+ $tterm = 1;
+ }
+
+ $tsum = $tterm;
+ while ($ti < $degrees) {
+ $tterm *= $tc * $tc * ($ti - 1) / $ti;
+ $tsum += $tterm;
+ $ti += 2;
+ }
+
+ $tsum *= $ts;
+ if (($degrees % 2) == 1) {
+ $tsum = Functions::M_2DIVPI * ($tsum + $ttheta);
+ }
+
+ $tValue = 0.5 * (1 + $tsum);
+ if ($tails == 1) {
+ return 1 - abs($tValue);
+ }
+
+ return 1 - abs((1 - $tValue) - $tValue);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Weibull.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Weibull.php
new file mode 100644
index 00000000..2f20b624
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Distributions/Weibull.php
@@ -0,0 +1,57 @@
+getMessage();
+ }
+
+ if (($value < 0) || ($alpha <= 0) || ($beta <= 0)) {
+ return ExcelError::NAN();
+ }
+
+ if ($cumulative) {
+ return 1 - exp(0 - ($value / $beta) ** $alpha);
+ }
+
+ return ($alpha / $beta ** $alpha) * $value ** ($alpha - 1) * exp(0 - ($value / $beta) ** $alpha);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/MaxMinBase.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/MaxMinBase.php
new file mode 100644
index 00000000..a722fbd9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/MaxMinBase.php
@@ -0,0 +1,17 @@
+ $returnValue)) {
+ $returnValue = $arg;
+ }
+ }
+ }
+
+ if ($returnValue === null) {
+ return 0;
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * MAXA.
+ *
+ * Returns the greatest value in a list of arguments, including numbers, text, and logical values
+ *
+ * Excel Function:
+ * MAXA(value1[,value2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ */
+ public static function maxA(mixed ...$args): float|int|string
+ {
+ $returnValue = null;
+
+ // Loop through arguments
+ $aArgs = Functions::flattenArray($args);
+ foreach ($aArgs as $arg) {
+ if (ErrorValue::isError($arg)) {
+ $returnValue = $arg;
+
+ break;
+ }
+ // Is it a numeric value?
+ if ((is_numeric($arg)) || (is_bool($arg)) || ((is_string($arg) && ($arg != '')))) {
+ $arg = self::datatypeAdjustmentAllowStrings($arg);
+ if (($returnValue === null) || ($arg > $returnValue)) {
+ $returnValue = $arg;
+ }
+ }
+ }
+
+ if ($returnValue === null) {
+ return 0;
+ }
+
+ return $returnValue;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Minimum.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Minimum.php
new file mode 100644
index 00000000..fcb77c63
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Minimum.php
@@ -0,0 +1,85 @@
+getMessage();
+ }
+
+ if (($entry < 0) || ($entry > 1)) {
+ return ExcelError::NAN();
+ }
+
+ $mArgs = self::percentileFilterValues($aArgs);
+ $mValueCount = count($mArgs);
+ if ($mValueCount > 0) {
+ sort($mArgs);
+ $count = Counts::COUNT($mArgs);
+ $index = $entry * ($count - 1);
+ $iBase = floor($index);
+ if ($index == $iBase) {
+ return $mArgs[$index];
+ }
+ $iNext = $iBase + 1;
+ $iProportion = $index - $iBase;
+
+ return $mArgs[$iBase] + (($mArgs[$iNext] - $mArgs[$iBase]) * $iProportion);
+ }
+
+ return ExcelError::NAN();
+ }
+
+ /**
+ * PERCENTRANK.
+ *
+ * Returns the rank of a value in a data set as a percentage of the data set.
+ * Note that the returned rank is simply rounded to the appropriate significant digits,
+ * rather than floored (as MS Excel), so value 3 for a value set of 1, 2, 3, 4 will return
+ * 0.667 rather than 0.666
+ *
+ * @param mixed $valueSet An array of (float) values, or a reference to, a list of numbers
+ * @param mixed $value The number whose rank you want to find
+ * @param mixed $significance The (integer) number of significant digits for the returned percentage value
+ *
+ * @return float|string (string if result is an error)
+ */
+ public static function PERCENTRANK(mixed $valueSet, mixed $value, mixed $significance = 3): string|float
+ {
+ $valueSet = Functions::flattenArray($valueSet);
+ $value = Functions::flattenSingleValue($value);
+ $significance = ($significance === null) ? 3 : Functions::flattenSingleValue($significance);
+
+ try {
+ $value = StatisticalValidations::validateFloat($value);
+ $significance = StatisticalValidations::validateInt($significance);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $valueSet = self::rankFilterValues($valueSet);
+ $valueCount = count($valueSet);
+ if ($valueCount == 0) {
+ return ExcelError::NA();
+ }
+ sort($valueSet, SORT_NUMERIC);
+
+ $valueAdjustor = $valueCount - 1;
+ if (($value < $valueSet[0]) || ($value > $valueSet[$valueAdjustor])) {
+ return ExcelError::NA();
+ }
+
+ $pos = array_search($value, $valueSet);
+ if ($pos === false) {
+ $pos = 0;
+ $testValue = $valueSet[0];
+ while ($testValue < $value) {
+ $testValue = $valueSet[++$pos];
+ }
+ --$pos;
+ $pos += (($value - $valueSet[$pos]) / ($testValue - $valueSet[$pos]));
+ }
+
+ return round(((float) $pos) / $valueAdjustor, $significance);
+ }
+
+ /**
+ * QUARTILE.
+ *
+ * Returns the quartile of a data set.
+ *
+ * Excel Function:
+ * QUARTILE(value1[,value2[, ...]],entry)
+ *
+ * @param mixed $args Data values
+ *
+ * @return float|string The result, or a string containing an error
+ */
+ public static function QUARTILE(mixed ...$args)
+ {
+ $aArgs = Functions::flattenArray($args);
+ $entry = array_pop($aArgs);
+
+ try {
+ $entry = StatisticalValidations::validateFloat($entry);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $entry = floor($entry);
+ $entry /= 4;
+ if (($entry < 0) || ($entry > 1)) {
+ return ExcelError::NAN();
+ }
+
+ return self::PERCENTILE($aArgs, $entry);
+ }
+
+ /**
+ * RANK.
+ *
+ * Returns the rank of a number in a list of numbers.
+ *
+ * @param mixed $value The number whose rank you want to find
+ * @param mixed $valueSet An array of float values, or a reference to, a list of numbers
+ * @param mixed $order Order to sort the values in the value set
+ *
+ * @return float|string The result, or a string containing an error (0 = Descending, 1 = Ascending)
+ */
+ public static function RANK(mixed $value, mixed $valueSet, mixed $order = self::RANK_SORT_DESCENDING)
+ {
+ $value = Functions::flattenSingleValue($value);
+ $valueSet = Functions::flattenArray($valueSet);
+ $order = ($order === null) ? self::RANK_SORT_DESCENDING : Functions::flattenSingleValue($order);
+
+ try {
+ $value = StatisticalValidations::validateFloat($value);
+ $order = StatisticalValidations::validateInt($order);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $valueSet = self::rankFilterValues($valueSet);
+ if ($order === self::RANK_SORT_DESCENDING) {
+ rsort($valueSet, SORT_NUMERIC);
+ } else {
+ sort($valueSet, SORT_NUMERIC);
+ }
+
+ $pos = array_search($value, $valueSet);
+ if ($pos === false) {
+ return ExcelError::NA();
+ }
+
+ return ++$pos;
+ }
+
+ protected static function percentileFilterValues(array $dataSet): array
+ {
+ return array_filter(
+ $dataSet,
+ fn ($value): bool => is_numeric($value) && !is_string($value)
+ );
+ }
+
+ protected static function rankFilterValues(array $dataSet): array
+ {
+ return array_filter(
+ $dataSet,
+ fn ($value): bool => is_numeric($value)
+ );
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Permutations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Permutations.php
new file mode 100644
index 00000000..06e3b798
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Permutations.php
@@ -0,0 +1,100 @@
+getMessage();
+ }
+
+ if ($numObjs < $numInSet) {
+ return ExcelError::NAN();
+ }
+ /** @var float|int|string */
+ $result1 = MathTrig\Factorial::fact($numObjs);
+ if (is_string($result1)) {
+ return $result1;
+ }
+ /** @var float|int|string */
+ $result2 = MathTrig\Factorial::fact($numObjs - $numInSet);
+ if (is_string($result2)) {
+ return $result2;
+ }
+ $result = round($result1 / $result2);
+
+ return IntOrFloat::evaluate($result);
+ }
+
+ /**
+ * PERMUTATIONA.
+ *
+ * Returns the number of permutations for a given number of objects (with repetitions)
+ * that can be selected from the total objects.
+ *
+ * @param mixed $numObjs Integer number of different objects
+ * Or can be an array of values
+ * @param mixed $numInSet Integer number of objects in each permutation
+ * Or can be an array of values
+ *
+ * @return array|float|int|string Number of permutations, or a string containing an error
+ * If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function PERMUTATIONA(mixed $numObjs, mixed $numInSet)
+ {
+ if (is_array($numObjs) || is_array($numInSet)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $numObjs, $numInSet);
+ }
+
+ try {
+ $numObjs = StatisticalValidations::validateInt($numObjs);
+ $numInSet = StatisticalValidations::validateInt($numInSet);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ if ($numObjs < 0 || $numInSet < 0) {
+ return ExcelError::NAN();
+ }
+
+ $result = $numObjs ** $numInSet;
+
+ return IntOrFloat::evaluate($result);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Size.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Size.php
new file mode 100644
index 00000000..71594bdf
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/Size.php
@@ -0,0 +1,97 @@
+= $count) {
+ return ExcelError::NAN();
+ }
+ rsort($mArgs);
+
+ return $mArgs[$entry];
+ }
+
+ return ExcelError::VALUE();
+ }
+
+ /**
+ * SMALL.
+ *
+ * Returns the nth smallest value in a data set. You can use this function to
+ * select a value based on its relative standing.
+ *
+ * Excel Function:
+ * SMALL(value1[,value2[, ...]],entry)
+ *
+ * @param mixed $args Data values
+ *
+ * @return float|string The result, or a string containing an error
+ */
+ public static function small(mixed ...$args)
+ {
+ $aArgs = Functions::flattenArray($args);
+
+ $entry = array_pop($aArgs);
+
+ if ((is_numeric($entry)) && (!is_string($entry))) {
+ $entry = (int) floor($entry);
+
+ $mArgs = self::filter($aArgs);
+ $count = Counts::COUNT($mArgs);
+ --$entry;
+ if ($count === 0 || $entry < 0 || $entry >= $count) {
+ return ExcelError::NAN();
+ }
+ sort($mArgs);
+
+ return $mArgs[$entry];
+ }
+
+ return ExcelError::VALUE();
+ }
+
+ /**
+ * @param mixed[] $args Data values
+ */
+ protected static function filter(array $args): array
+ {
+ $mArgs = [];
+
+ foreach ($args as $arg) {
+ // Is it a numeric value?
+ if ((is_numeric($arg)) && (!is_string($arg))) {
+ $mArgs[] = $arg;
+ }
+ }
+
+ return $mArgs;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/StandardDeviations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/StandardDeviations.php
new file mode 100644
index 00000000..3d4ea305
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/StandardDeviations.php
@@ -0,0 +1,89 @@
+getMessage();
+ }
+
+ if ($stdDev <= 0) {
+ return ExcelError::NAN();
+ }
+
+ return ($value - $mean) / $stdDev;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/StatisticalValidations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/StatisticalValidations.php
new file mode 100644
index 00000000..59ad7eef
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/StatisticalValidations.php
@@ -0,0 +1,36 @@
+ $value) {
+ if ((is_bool($value)) || (is_string($value)) || ($value === null)) {
+ unset($array1[$key], $array2[$key]);
+ }
+ }
+ }
+
+ /**
+ * @param mixed $array1 should be array, but scalar is made into one
+ * @param mixed $array2 should be array, but scalar is made into one
+ */
+ private static function checkTrendArrays(mixed &$array1, mixed &$array2): void
+ {
+ if (!is_array($array1)) {
+ $array1 = [$array1];
+ }
+ if (!is_array($array2)) {
+ $array2 = [$array2];
+ }
+
+ $array1 = Functions::flattenArray($array1);
+ $array2 = Functions::flattenArray($array2);
+
+ self::filterTrendValues($array1, $array2);
+ self::filterTrendValues($array2, $array1);
+
+ // Reset the array indexes
+ $array1 = array_merge($array1);
+ $array2 = array_merge($array2);
+ }
+
+ protected static function validateTrendArrays(array $yValues, array $xValues): void
+ {
+ $yValueCount = count($yValues);
+ $xValueCount = count($xValues);
+
+ if (($yValueCount === 0) || ($yValueCount !== $xValueCount)) {
+ throw new Exception(ExcelError::NA());
+ } elseif ($yValueCount === 1) {
+ throw new Exception(ExcelError::DIV0());
+ }
+ }
+
+ /**
+ * CORREL.
+ *
+ * Returns covariance, the average of the products of deviations for each data point pair.
+ *
+ * @param mixed $yValues array of mixed Data Series Y
+ * @param null|mixed $xValues array of mixed Data Series X
+ */
+ public static function CORREL(mixed $yValues, $xValues = null): float|string
+ {
+ if (($xValues === null) || (!is_array($yValues)) || (!is_array($xValues))) {
+ return ExcelError::VALUE();
+ }
+
+ try {
+ self::checkTrendArrays($yValues, $xValues);
+ self::validateTrendArrays($yValues, $xValues);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $bestFitLinear = Trend::calculate(Trend::TREND_LINEAR, $yValues, $xValues);
+
+ return $bestFitLinear->getCorrelation();
+ }
+
+ /**
+ * COVAR.
+ *
+ * Returns covariance, the average of the products of deviations for each data point pair.
+ *
+ * @param mixed[] $yValues array of mixed Data Series Y
+ * @param mixed[] $xValues array of mixed Data Series X
+ */
+ public static function COVAR(array $yValues, array $xValues): float|string
+ {
+ try {
+ self::checkTrendArrays($yValues, $xValues);
+ self::validateTrendArrays($yValues, $xValues);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $bestFitLinear = Trend::calculate(Trend::TREND_LINEAR, $yValues, $xValues);
+
+ return $bestFitLinear->getCovariance();
+ }
+
+ /**
+ * FORECAST.
+ *
+ * Calculates, or predicts, a future value by using existing values.
+ * The predicted value is a y-value for a given x-value.
+ *
+ * @param mixed $xValue Float value of X for which we want to find Y
+ * Or can be an array of values
+ * @param mixed[] $yValues array of mixed Data Series Y
+ * @param mixed[] $xValues array of mixed Data Series X
+ *
+ * @return array|bool|float|string If an array of numbers is passed as an argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function FORECAST(mixed $xValue, array $yValues, array $xValues)
+ {
+ if (is_array($xValue)) {
+ return self::evaluateArrayArgumentsSubset([self::class, __FUNCTION__], 1, $xValue, $yValues, $xValues);
+ }
+
+ try {
+ $xValue = StatisticalValidations::validateFloat($xValue);
+ self::checkTrendArrays($yValues, $xValues);
+ self::validateTrendArrays($yValues, $xValues);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $bestFitLinear = Trend::calculate(Trend::TREND_LINEAR, $yValues, $xValues);
+
+ return $bestFitLinear->getValueOfYForX($xValue);
+ }
+
+ /**
+ * GROWTH.
+ *
+ * Returns values along a predicted exponential Trend
+ *
+ * @param mixed[] $yValues Data Series Y
+ * @param mixed[] $xValues Data Series X
+ * @param mixed[] $newValues Values of X for which we want to find Y
+ * @param mixed $const A logical (boolean) value specifying whether to force the intersect to equal 0 or not
+ *
+ * @return array>>
+ */
+ public static function GROWTH(array $yValues, array $xValues = [], array $newValues = [], mixed $const = true): array
+ {
+ $yValues = Functions::flattenArray($yValues);
+ $xValues = Functions::flattenArray($xValues);
+ $newValues = Functions::flattenArray($newValues);
+ $const = ($const === null) ? true : (bool) Functions::flattenSingleValue($const);
+
+ $bestFitExponential = Trend::calculate(Trend::TREND_EXPONENTIAL, $yValues, $xValues, $const);
+ if (empty($newValues)) {
+ $newValues = $bestFitExponential->getXValues();
+ }
+
+ $returnArray = [];
+ foreach ($newValues as $xValue) {
+ $returnArray[0][] = [$bestFitExponential->getValueOfYForX($xValue)];
+ }
+
+ return $returnArray;
+ }
+
+ /**
+ * INTERCEPT.
+ *
+ * Calculates the point at which a line will intersect the y-axis by using existing x-values and y-values.
+ *
+ * @param mixed[] $yValues Data Series Y
+ * @param mixed[] $xValues Data Series X
+ */
+ public static function INTERCEPT(array $yValues, array $xValues): float|string
+ {
+ try {
+ self::checkTrendArrays($yValues, $xValues);
+ self::validateTrendArrays($yValues, $xValues);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $bestFitLinear = Trend::calculate(Trend::TREND_LINEAR, $yValues, $xValues);
+
+ return $bestFitLinear->getIntersect();
+ }
+
+ /**
+ * LINEST.
+ *
+ * Calculates the statistics for a line by using the "least squares" method to calculate a straight line
+ * that best fits your data, and then returns an array that describes the line.
+ *
+ * @param mixed[] $yValues Data Series Y
+ * @param null|mixed[] $xValues Data Series X
+ * @param mixed $const A logical (boolean) value specifying whether to force the intersect to equal 0 or not
+ * @param mixed $stats A logical (boolean) value specifying whether to return additional regression statistics
+ *
+ * @return array|string The result, or a string containing an error
+ */
+ public static function LINEST(array $yValues, ?array $xValues = null, mixed $const = true, mixed $stats = false): string|array
+ {
+ $const = ($const === null) ? true : (bool) Functions::flattenSingleValue($const);
+ $stats = ($stats === null) ? false : (bool) Functions::flattenSingleValue($stats);
+ if ($xValues === null) {
+ $xValues = $yValues;
+ }
+
+ try {
+ self::checkTrendArrays($yValues, $xValues);
+ self::validateTrendArrays($yValues, $xValues);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $bestFitLinear = Trend::calculate(Trend::TREND_LINEAR, $yValues, $xValues, $const);
+
+ if ($stats === true) {
+ return [
+ [
+ $bestFitLinear->getSlope(),
+ $bestFitLinear->getIntersect(),
+ ],
+ [
+ $bestFitLinear->getSlopeSE(),
+ ($const === false) ? ExcelError::NA() : $bestFitLinear->getIntersectSE(),
+ ],
+ [
+ $bestFitLinear->getGoodnessOfFit(),
+ $bestFitLinear->getStdevOfResiduals(),
+ ],
+ [
+ $bestFitLinear->getF(),
+ $bestFitLinear->getDFResiduals(),
+ ],
+ [
+ $bestFitLinear->getSSRegression(),
+ $bestFitLinear->getSSResiduals(),
+ ],
+ ];
+ }
+
+ return [
+ $bestFitLinear->getSlope(),
+ $bestFitLinear->getIntersect(),
+ ];
+ }
+
+ /**
+ * LOGEST.
+ *
+ * Calculates an exponential curve that best fits the X and Y data series,
+ * and then returns an array that describes the line.
+ *
+ * @param mixed[] $yValues Data Series Y
+ * @param null|mixed[] $xValues Data Series X
+ * @param mixed $const A logical (boolean) value specifying whether to force the intersect to equal 0 or not
+ * @param mixed $stats A logical (boolean) value specifying whether to return additional regression statistics
+ *
+ * @return array|string The result, or a string containing an error
+ */
+ public static function LOGEST(array $yValues, ?array $xValues = null, mixed $const = true, mixed $stats = false): string|array
+ {
+ $const = ($const === null) ? true : (bool) Functions::flattenSingleValue($const);
+ $stats = ($stats === null) ? false : (bool) Functions::flattenSingleValue($stats);
+ if ($xValues === null) {
+ $xValues = $yValues;
+ }
+
+ try {
+ self::checkTrendArrays($yValues, $xValues);
+ self::validateTrendArrays($yValues, $xValues);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ foreach ($yValues as $value) {
+ if ($value < 0.0) {
+ return ExcelError::NAN();
+ }
+ }
+
+ $bestFitExponential = Trend::calculate(Trend::TREND_EXPONENTIAL, $yValues, $xValues, $const);
+
+ if ($stats === true) {
+ return [
+ [
+ $bestFitExponential->getSlope(),
+ $bestFitExponential->getIntersect(),
+ ],
+ [
+ $bestFitExponential->getSlopeSE(),
+ ($const === false) ? ExcelError::NA() : $bestFitExponential->getIntersectSE(),
+ ],
+ [
+ $bestFitExponential->getGoodnessOfFit(),
+ $bestFitExponential->getStdevOfResiduals(),
+ ],
+ [
+ $bestFitExponential->getF(),
+ $bestFitExponential->getDFResiduals(),
+ ],
+ [
+ $bestFitExponential->getSSRegression(),
+ $bestFitExponential->getSSResiduals(),
+ ],
+ ];
+ }
+
+ return [
+ $bestFitExponential->getSlope(),
+ $bestFitExponential->getIntersect(),
+ ];
+ }
+
+ /**
+ * RSQ.
+ *
+ * Returns the square of the Pearson product moment correlation coefficient through data points
+ * in known_y's and known_x's.
+ *
+ * @param mixed[] $yValues Data Series Y
+ * @param mixed[] $xValues Data Series X
+ *
+ * @return float|string The result, or a string containing an error
+ */
+ public static function RSQ(array $yValues, array $xValues)
+ {
+ try {
+ self::checkTrendArrays($yValues, $xValues);
+ self::validateTrendArrays($yValues, $xValues);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $bestFitLinear = Trend::calculate(Trend::TREND_LINEAR, $yValues, $xValues);
+
+ return $bestFitLinear->getGoodnessOfFit();
+ }
+
+ /**
+ * SLOPE.
+ *
+ * Returns the slope of the linear regression line through data points in known_y's and known_x's.
+ *
+ * @param mixed[] $yValues Data Series Y
+ * @param mixed[] $xValues Data Series X
+ *
+ * @return float|string The result, or a string containing an error
+ */
+ public static function SLOPE(array $yValues, array $xValues)
+ {
+ try {
+ self::checkTrendArrays($yValues, $xValues);
+ self::validateTrendArrays($yValues, $xValues);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $bestFitLinear = Trend::calculate(Trend::TREND_LINEAR, $yValues, $xValues);
+
+ return $bestFitLinear->getSlope();
+ }
+
+ /**
+ * STEYX.
+ *
+ * Returns the standard error of the predicted y-value for each x in the regression.
+ *
+ * @param mixed[] $yValues Data Series Y
+ * @param mixed[] $xValues Data Series X
+ */
+ public static function STEYX(array $yValues, array $xValues): float|string
+ {
+ try {
+ self::checkTrendArrays($yValues, $xValues);
+ self::validateTrendArrays($yValues, $xValues);
+ } catch (Exception $e) {
+ return $e->getMessage();
+ }
+
+ $bestFitLinear = Trend::calculate(Trend::TREND_LINEAR, $yValues, $xValues);
+
+ return $bestFitLinear->getStdevOfResiduals();
+ }
+
+ /**
+ * TREND.
+ *
+ * Returns values along a linear Trend
+ *
+ * @param mixed[] $yValues Data Series Y
+ * @param mixed[] $xValues Data Series X
+ * @param mixed[] $newValues Values of X for which we want to find Y
+ * @param mixed $const A logical (boolean) value specifying whether to force the intersect to equal 0 or not
+ *
+ * @return array>>
+ */
+ public static function TREND(array $yValues, array $xValues = [], array $newValues = [], mixed $const = true): array
+ {
+ $yValues = Functions::flattenArray($yValues);
+ $xValues = Functions::flattenArray($xValues);
+ $newValues = Functions::flattenArray($newValues);
+ $const = ($const === null) ? true : (bool) Functions::flattenSingleValue($const);
+
+ $bestFitLinear = Trend::calculate(Trend::TREND_LINEAR, $yValues, $xValues, $const);
+ if (empty($newValues)) {
+ $newValues = $bestFitLinear->getXValues();
+ }
+
+ $returnArray = [];
+ foreach ($newValues as $xValue) {
+ $returnArray[0][] = [$bestFitLinear->getValueOfYForX($xValue)];
+ }
+
+ return $returnArray;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/VarianceBase.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/VarianceBase.php
new file mode 100644
index 00000000..d5646cf9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Statistical/VarianceBase.php
@@ -0,0 +1,28 @@
+ 1) {
+ $summerA *= $aCount;
+ $summerB *= $summerB;
+
+ return ($summerA - $summerB) / ($aCount * ($aCount - 1));
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * VARA.
+ *
+ * Estimates variance based on a sample, including numbers, text, and logical values
+ *
+ * Excel Function:
+ * VARA(value1[,value2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ *
+ * @return float|string (string if result is an error)
+ */
+ public static function VARA(mixed ...$args): string|float
+ {
+ $returnValue = ExcelError::DIV0();
+
+ $summerA = $summerB = 0.0;
+
+ // Loop through arguments
+ $aArgs = Functions::flattenArrayIndexed($args);
+ $aCount = 0;
+ foreach ($aArgs as $k => $arg) {
+ if ((is_string($arg)) && (Functions::isValue($k))) {
+ return ExcelError::VALUE();
+ } elseif ((is_string($arg)) && (!Functions::isMatrixValue($k))) {
+ } else {
+ // Is it a numeric value?
+ if ((is_numeric($arg)) || (is_bool($arg)) || ((is_string($arg) && ($arg != '')))) {
+ $arg = self::datatypeAdjustmentAllowStrings($arg);
+ $summerA += ($arg * $arg);
+ $summerB += $arg;
+ ++$aCount;
+ }
+ }
+ }
+
+ if ($aCount > 1) {
+ $summerA *= $aCount;
+ $summerB *= $summerB;
+
+ return ($summerA - $summerB) / ($aCount * ($aCount - 1));
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * VARP.
+ *
+ * Calculates variance based on the entire population
+ *
+ * Excel Function:
+ * VARP(value1[,value2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ *
+ * @return float|string (string if result is an error)
+ */
+ public static function VARP(mixed ...$args): float|string
+ {
+ // Return value
+ $returnValue = ExcelError::DIV0();
+
+ $summerA = $summerB = 0.0;
+
+ // Loop through arguments
+ $aArgs = Functions::flattenArray($args);
+ $aCount = 0;
+ foreach ($aArgs as $arg) {
+ $arg = self::datatypeAdjustmentBooleans($arg);
+
+ // Is it a numeric value?
+ if ((is_numeric($arg)) && (!is_string($arg))) {
+ $summerA += ($arg * $arg);
+ $summerB += $arg;
+ ++$aCount;
+ }
+ }
+
+ if ($aCount > 0) {
+ $summerA *= $aCount;
+ $summerB *= $summerB;
+
+ return ($summerA - $summerB) / ($aCount * $aCount);
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * VARPA.
+ *
+ * Calculates variance based on the entire population, including numbers, text, and logical values
+ *
+ * Excel Function:
+ * VARPA(value1[,value2[, ...]])
+ *
+ * @param mixed ...$args Data values
+ *
+ * @return float|string (string if result is an error)
+ */
+ public static function VARPA(mixed ...$args): string|float
+ {
+ $returnValue = ExcelError::DIV0();
+
+ $summerA = $summerB = 0.0;
+
+ // Loop through arguments
+ $aArgs = Functions::flattenArrayIndexed($args);
+ $aCount = 0;
+ foreach ($aArgs as $k => $arg) {
+ if ((is_string($arg)) && (Functions::isValue($k))) {
+ return ExcelError::VALUE();
+ } elseif ((is_string($arg)) && (!Functions::isMatrixValue($k))) {
+ } else {
+ // Is it a numeric value?
+ if ((is_numeric($arg)) || (is_bool($arg)) || ((is_string($arg) && ($arg != '')))) {
+ $arg = self::datatypeAdjustmentAllowStrings($arg);
+ $summerA += ($arg * $arg);
+ $summerB += $arg;
+ ++$aCount;
+ }
+ }
+ }
+
+ if ($aCount > 0) {
+ $summerA *= $aCount;
+ $summerB *= $summerB;
+
+ return ($summerA - $summerB) / ($aCount * $aCount);
+ }
+
+ return $returnValue;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/CaseConvert.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/CaseConvert.php
new file mode 100644
index 00000000..6667bac5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/CaseConvert.php
@@ -0,0 +1,90 @@
+getMessage();
+ }
+
+ return StringHelper::strToLower($mixedCaseValue);
+ }
+
+ /**
+ * UPPERCASE.
+ *
+ * Converts a string value to upper case.
+ *
+ * @param mixed $mixedCaseValue The string value to convert to upper case
+ * Or can be an array of values
+ *
+ * @return array|string If an array of values is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function upper(mixed $mixedCaseValue): array|string
+ {
+ if (is_array($mixedCaseValue)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $mixedCaseValue);
+ }
+
+ try {
+ $mixedCaseValue = Helpers::extractString($mixedCaseValue, true);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+
+ return StringHelper::strToUpper($mixedCaseValue);
+ }
+
+ /**
+ * PROPERCASE.
+ *
+ * Converts a string value to proper or title case.
+ *
+ * @param mixed $mixedCaseValue The string value to convert to title case
+ * Or can be an array of values
+ *
+ * @return array|string If an array of values is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function proper(mixed $mixedCaseValue): array|string
+ {
+ if (is_array($mixedCaseValue)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $mixedCaseValue);
+ }
+
+ try {
+ $mixedCaseValue = Helpers::extractString($mixedCaseValue, true);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+
+ return StringHelper::strToTitle($mixedCaseValue);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/CharacterConvert.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/CharacterConvert.php
new file mode 100644
index 00000000..06d0f900
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/CharacterConvert.php
@@ -0,0 +1,92 @@
+getMessage();
+ }
+
+ $min = Functions::getCompatibilityMode() === Functions::COMPATIBILITY_OPENOFFICE ? 0 : 1;
+ if ($character < $min || $character > 255) {
+ return ExcelError::VALUE();
+ }
+ $result = iconv('UCS-4LE', 'UTF-8', pack('V', $character));
+
+ return ($result === false) ? '' : $result;
+ }
+
+ /**
+ * CODE.
+ *
+ * @param mixed $characters String character to convert to its ASCII value
+ * Or can be an array of values
+ *
+ * @return array|int|string A string if arguments are invalid
+ * If an array of values is passed as the argument, then the returned result will also be an array
+ * with the same dimensions
+ */
+ public static function code(mixed $characters): array|string|int
+ {
+ if (is_array($characters)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $characters);
+ }
+
+ try {
+ $characters = Helpers::extractString($characters, true);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+
+ if ($characters === '') {
+ return ExcelError::VALUE();
+ }
+
+ $character = $characters;
+ if (mb_strlen($characters, 'UTF-8') > 1) {
+ $character = mb_substr($characters, 0, 1, 'UTF-8');
+ }
+
+ return self::unicodeToOrd($character);
+ }
+
+ private static function unicodeToOrd(string $character): int
+ {
+ $retVal = 0;
+ $iconv = iconv('UTF-8', 'UCS-4LE', $character);
+ if ($iconv !== false) {
+ $result = unpack('V', $iconv);
+ if (is_array($result) && isset($result[1])) {
+ $retVal = $result[1];
+ }
+ }
+
+ return $retVal;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Concatenate.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Concatenate.php
new file mode 100644
index 00000000..78940ed1
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Concatenate.php
@@ -0,0 +1,137 @@
+ DataType::MAX_STRING_LENGTH) {
+ $returnValue = ExcelError::CALC();
+
+ break;
+ }
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * TEXTJOIN.
+ *
+ * @param mixed $delimiter The delimter to use between the joined arguments
+ * Or can be an array of values
+ * @param mixed $ignoreEmpty true/false Flag indicating whether empty arguments should be skipped
+ * Or can be an array of values
+ * @param mixed $args The values to join
+ *
+ * @return array|string The joined string
+ * If an array of values is passed for the $delimiter or $ignoreEmpty arguments, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function TEXTJOIN(mixed $delimiter = '', mixed $ignoreEmpty = true, mixed ...$args): array|string
+ {
+ if (is_array($delimiter) || is_array($ignoreEmpty)) {
+ return self::evaluateArrayArgumentsSubset(
+ [self::class, __FUNCTION__],
+ 2,
+ $delimiter,
+ $ignoreEmpty,
+ ...$args
+ );
+ }
+
+ $delimiter ??= '';
+ $ignoreEmpty ??= true;
+ $aArgs = Functions::flattenArray($args);
+ $returnValue = self::evaluateTextJoinArray($ignoreEmpty, $aArgs);
+
+ $returnValue ??= implode($delimiter, $aArgs);
+ if (StringHelper::countCharacters($returnValue) > DataType::MAX_STRING_LENGTH) {
+ $returnValue = ExcelError::CALC();
+ }
+
+ return $returnValue;
+ }
+
+ private static function evaluateTextJoinArray(bool $ignoreEmpty, array &$aArgs): ?string
+ {
+ foreach ($aArgs as $key => &$arg) {
+ $value = Helpers::extractString($arg);
+ if (ErrorValue::isError($value, true)) {
+ return $value;
+ }
+
+ if ($ignoreEmpty === true && ((is_string($arg) && trim($arg) === '') || $arg === null)) {
+ unset($aArgs[$key]);
+ } elseif (is_bool($arg)) {
+ $arg = Helpers::convertBooleanValue($arg);
+ }
+ }
+
+ return null;
+ }
+
+ /**
+ * REPT.
+ *
+ * Returns the result of builtin function round after validating args.
+ *
+ * @param mixed $stringValue The value to repeat
+ * Or can be an array of values
+ * @param mixed $repeatCount The number of times the string value should be repeated
+ * Or can be an array of values
+ *
+ * @return array|string The repeated string
+ * If an array of values is passed for the $stringValue or $repeatCount arguments, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function builtinREPT(mixed $stringValue, mixed $repeatCount): array|string
+ {
+ if (is_array($stringValue) || is_array($repeatCount)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $stringValue, $repeatCount);
+ }
+
+ $stringValue = Helpers::extractString($stringValue);
+
+ if (!is_numeric($repeatCount) || $repeatCount < 0) {
+ $returnValue = ExcelError::VALUE();
+ } elseif (ErrorValue::isError($stringValue, true)) {
+ $returnValue = $stringValue;
+ } else {
+ $returnValue = str_repeat($stringValue, (int) $repeatCount);
+ if (StringHelper::countCharacters($returnValue) > DataType::MAX_STRING_LENGTH) {
+ $returnValue = ExcelError::VALUE(); // note VALUE not CALC
+ }
+ }
+
+ return $returnValue;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Extract.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Extract.php
new file mode 100644
index 00000000..1dfb724c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Extract.php
@@ -0,0 +1,282 @@
+getMessage();
+ }
+
+ return mb_substr($value, 0, $chars, 'UTF-8');
+ }
+
+ /**
+ * MID.
+ *
+ * @param mixed $value String value from which to extract characters
+ * Or can be an array of values
+ * @param mixed $start Integer offset of the first character that we want to extract
+ * Or can be an array of values
+ * @param mixed $chars The number of characters to extract (as an integer)
+ * Or can be an array of values
+ *
+ * @return array|string The joined string
+ * If an array of values is passed for the $value, $start or $chars arguments, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function mid(mixed $value, mixed $start, mixed $chars): array|string
+ {
+ if (is_array($value) || is_array($start) || is_array($chars)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $start, $chars);
+ }
+
+ try {
+ $value = Helpers::extractString($value, true);
+ $start = Helpers::extractInt($start, 1);
+ $chars = Helpers::extractInt($chars, 0);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+
+ return mb_substr($value, --$start, $chars, 'UTF-8');
+ }
+
+ /**
+ * RIGHT.
+ *
+ * @param mixed $value String value from which to extract characters
+ * Or can be an array of values
+ * @param mixed $chars The number of characters to extract (as an integer)
+ * Or can be an array of values
+ *
+ * @return array|string The joined string
+ * If an array of values is passed for the $value or $chars arguments, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function right(mixed $value, mixed $chars = 1): array|string
+ {
+ if (is_array($value) || is_array($chars)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $chars);
+ }
+
+ try {
+ $value = Helpers::extractString($value, true);
+ $chars = Helpers::extractInt($chars, 0, 1);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+
+ return mb_substr($value, mb_strlen($value, 'UTF-8') - $chars, $chars, 'UTF-8');
+ }
+
+ /**
+ * TEXTBEFORE.
+ *
+ * @param mixed $text the text that you're searching
+ * Or can be an array of values
+ * @param null|array|string $delimiter the text that marks the point before which you want to extract
+ * Multiple delimiters can be passed as an array of string values
+ * @param mixed $instance The instance of the delimiter after which you want to extract the text.
+ * By default, this is the first instance (1).
+ * A negative value means start searching from the end of the text string.
+ * Or can be an array of values
+ * @param mixed $matchMode Determines whether the match is case-sensitive or not.
+ * 0 - Case-sensitive
+ * 1 - Case-insensitive
+ * Or can be an array of values
+ * @param mixed $matchEnd Treats the end of text as a delimiter.
+ * 0 - Don't match the delimiter against the end of the text.
+ * 1 - Match the delimiter against the end of the text.
+ * Or can be an array of values
+ * @param mixed $ifNotFound value to return if no match is found
+ * The default is a #N/A Error
+ * Or can be an array of values
+ *
+ * @return array|string the string extracted from text before the delimiter; or the $ifNotFound value
+ * If an array of values is passed for any of the arguments, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function before(mixed $text, $delimiter, mixed $instance = 1, mixed $matchMode = 0, mixed $matchEnd = 0, mixed $ifNotFound = '#N/A'): array|string
+ {
+ if (is_array($text) || is_array($instance) || is_array($matchMode) || is_array($matchEnd) || is_array($ifNotFound)) {
+ return self::evaluateArrayArgumentsIgnore([self::class, __FUNCTION__], 1, $text, $delimiter, $instance, $matchMode, $matchEnd, $ifNotFound);
+ }
+
+ try {
+ $text = Helpers::extractString($text ?? '', true);
+ Helpers::extractString(Functions::flattenSingleValue($delimiter ?? ''), true);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+
+ $instance = (int) $instance;
+ $matchMode = (int) $matchMode;
+ $matchEnd = (int) $matchEnd;
+
+ $split = self::validateTextBeforeAfter($text, $delimiter, $instance, $matchMode, $matchEnd, $ifNotFound);
+ if (is_string($split)) {
+ return $split;
+ }
+ if (Helpers::extractString(Functions::flattenSingleValue($delimiter ?? '')) === '') {
+ return ($instance > 0) ? '' : $text;
+ }
+
+ // Adjustment for a match as the first element of the split
+ $flags = self::matchFlags($matchMode);
+ $delimiter = self::buildDelimiter($delimiter);
+ $adjust = preg_match('/^' . $delimiter . "\$/{$flags}", $split[0]);
+ $oddReverseAdjustment = count($split) % 2;
+
+ $split = ($instance < 0)
+ ? array_slice($split, 0, max(count($split) - (abs($instance) * 2 - 1) - $adjust - $oddReverseAdjustment, 0))
+ : array_slice($split, 0, $instance * 2 - 1 - $adjust);
+
+ return implode('', $split);
+ }
+
+ /**
+ * TEXTAFTER.
+ *
+ * @param mixed $text the text that you're searching
+ * @param null|array|string $delimiter the text that marks the point before which you want to extract
+ * Multiple delimiters can be passed as an array of string values
+ * @param mixed $instance The instance of the delimiter after which you want to extract the text.
+ * By default, this is the first instance (1).
+ * A negative value means start searching from the end of the text string.
+ * Or can be an array of values
+ * @param mixed $matchMode Determines whether the match is case-sensitive or not.
+ * 0 - Case-sensitive
+ * 1 - Case-insensitive
+ * Or can be an array of values
+ * @param mixed $matchEnd Treats the end of text as a delimiter.
+ * 0 - Don't match the delimiter against the end of the text.
+ * 1 - Match the delimiter against the end of the text.
+ * Or can be an array of values
+ * @param mixed $ifNotFound value to return if no match is found
+ * The default is a #N/A Error
+ * Or can be an array of values
+ *
+ * @return array|string the string extracted from text before the delimiter; or the $ifNotFound value
+ * If an array of values is passed for any of the arguments, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function after(mixed $text, $delimiter, mixed $instance = 1, mixed $matchMode = 0, mixed $matchEnd = 0, mixed $ifNotFound = '#N/A'): array|string
+ {
+ if (is_array($text) || is_array($instance) || is_array($matchMode) || is_array($matchEnd) || is_array($ifNotFound)) {
+ return self::evaluateArrayArgumentsIgnore([self::class, __FUNCTION__], 1, $text, $delimiter, $instance, $matchMode, $matchEnd, $ifNotFound);
+ }
+
+ try {
+ $text = Helpers::extractString($text ?? '', true);
+ Helpers::extractString(Functions::flattenSingleValue($delimiter ?? ''), true);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+
+ $instance = (int) $instance;
+ $matchMode = (int) $matchMode;
+ $matchEnd = (int) $matchEnd;
+
+ $split = self::validateTextBeforeAfter($text, $delimiter, $instance, $matchMode, $matchEnd, $ifNotFound);
+ if (is_string($split)) {
+ return $split;
+ }
+ if (Helpers::extractString(Functions::flattenSingleValue($delimiter ?? '')) === '') {
+ return ($instance < 0) ? '' : $text;
+ }
+
+ // Adjustment for a match as the first element of the split
+ $flags = self::matchFlags($matchMode);
+ $delimiter = self::buildDelimiter($delimiter);
+ $adjust = preg_match('/^' . $delimiter . "\$/{$flags}", $split[0]);
+ $oddReverseAdjustment = count($split) % 2;
+
+ $split = ($instance < 0)
+ ? array_slice($split, count($split) - ((int) abs($instance + 1) * 2) - $adjust - $oddReverseAdjustment)
+ : array_slice($split, $instance * 2 - $adjust);
+
+ return implode('', $split);
+ }
+
+ private static function validateTextBeforeAfter(string $text, null|array|string $delimiter, int $instance, int $matchMode, int $matchEnd, mixed $ifNotFound): array|string
+ {
+ $flags = self::matchFlags($matchMode);
+ $delimiter = self::buildDelimiter($delimiter);
+
+ if (preg_match('/' . $delimiter . "/{$flags}", $text) === 0 && $matchEnd === 0) {
+ return $ifNotFound;
+ }
+
+ $split = preg_split('/' . $delimiter . "/{$flags}", $text, 0, PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE);
+ if ($split === false) {
+ return ExcelError::NA();
+ }
+
+ if ($instance === 0 || abs($instance) > StringHelper::countCharacters($text)) {
+ return ExcelError::VALUE();
+ }
+
+ if ($matchEnd === 0 && (abs($instance) > floor(count($split) / 2))) {
+ return ExcelError::NA();
+ } elseif ($matchEnd !== 0 && (abs($instance) - 1 > ceil(count($split) / 2))) {
+ return ExcelError::NA();
+ }
+
+ return $split;
+ }
+
+ /**
+ * @param null|array|string $delimiter the text that marks the point before which you want to extract
+ * Multiple delimiters can be passed as an array of string values
+ */
+ private static function buildDelimiter($delimiter): string
+ {
+ if (is_array($delimiter)) {
+ $delimiter = Functions::flattenArray($delimiter);
+ $quotedDelimiters = array_map(
+ fn ($delimiter): string => preg_quote($delimiter ?? '', '/'),
+ $delimiter
+ );
+ $delimiters = implode('|', $quotedDelimiters);
+
+ return '(' . $delimiters . ')';
+ }
+
+ return '(' . preg_quote($delimiter ?? '', '/') . ')';
+ }
+
+ private static function matchFlags(int $matchMode): string
+ {
+ return ($matchMode === 0) ? 'mu' : 'miu';
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Format.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Format.php
new file mode 100644
index 00000000..0560b376
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Format.php
@@ -0,0 +1,322 @@
+getMessage();
+ }
+
+ $mask = '$#,##0';
+ if ($decimals > 0) {
+ $mask .= '.' . str_repeat('0', $decimals);
+ } else {
+ $round = 10 ** abs($decimals);
+ if ($value < 0) {
+ $round = 0 - $round;
+ }
+ /** @var float|int|string */
+ $value = MathTrig\Round::multiple($value, $round);
+ }
+ $mask = "{$mask};-{$mask}";
+
+ return NumberFormat::toFormattedString($value, $mask);
+ }
+
+ /**
+ * FIXED.
+ *
+ * @param mixed $value The value to format
+ * Or can be an array of values
+ * @param mixed $decimals Integer value for the number of decimal places that should be formatted
+ * Or can be an array of values
+ * @param mixed $noCommas Boolean value indicating whether the value should have thousands separators or not
+ * Or can be an array of values
+ *
+ * @return array|string If an array of values is passed for either of the arguments, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function FIXEDFORMAT(mixed $value, mixed $decimals = 2, mixed $noCommas = false): array|string
+ {
+ if (is_array($value) || is_array($decimals) || is_array($noCommas)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $decimals, $noCommas);
+ }
+
+ try {
+ $value = Helpers::extractFloat($value);
+ $decimals = Helpers::extractInt($decimals, -100, 0, true);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+
+ $valueResult = round($value, $decimals);
+ if ($decimals < 0) {
+ $decimals = 0;
+ }
+ if ($noCommas === false) {
+ $valueResult = number_format(
+ $valueResult,
+ $decimals,
+ StringHelper::getDecimalSeparator(),
+ StringHelper::getThousandsSeparator()
+ );
+ }
+
+ return (string) $valueResult;
+ }
+
+ /**
+ * TEXT.
+ *
+ * @param mixed $value The value to format
+ * Or can be an array of values
+ * @param mixed $format A string with the Format mask that should be used
+ * Or can be an array of values
+ *
+ * @return array|string If an array of values is passed for either of the arguments, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function TEXTFORMAT(mixed $value, mixed $format): array|string
+ {
+ if (is_array($value) || is_array($format)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $format);
+ }
+
+ try {
+ $value = Helpers::extractString($value, true);
+ $format = Helpers::extractString($format, true);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+
+ $format = (string) NumberFormat::convertSystemFormats($format);
+
+ if (!is_numeric($value) && Date::isDateTimeFormatCode($format)) {
+ $value1 = DateTimeExcel\DateValue::fromString($value);
+ $value2 = DateTimeExcel\TimeValue::fromString($value);
+ /** @var float|int|string */
+ $value = (is_numeric($value1) && is_numeric($value2)) ? ($value1 + $value2) : (is_numeric($value1) ? $value2 : $value1);
+ }
+
+ return (string) NumberFormat::toFormattedString($value, $format);
+ }
+
+ /**
+ * @param mixed $value Value to check
+ */
+ private static function convertValue(mixed $value, bool $spacesMeanZero = false): mixed
+ {
+ $value = $value ?? 0;
+ if (is_bool($value)) {
+ if (Functions::getCompatibilityMode() === Functions::COMPATIBILITY_OPENOFFICE) {
+ $value = (int) $value;
+ } else {
+ throw new CalcExp(ExcelError::VALUE());
+ }
+ }
+ if (is_string($value)) {
+ $value = trim($value);
+ if (ErrorValue::isError($value, true)) {
+ throw new CalcExp($value);
+ }
+ if ($spacesMeanZero && $value === '') {
+ $value = 0;
+ }
+ }
+
+ return $value;
+ }
+
+ /**
+ * VALUE.
+ *
+ * @param mixed $value Value to check
+ * Or can be an array of values
+ *
+ * @return array|DateTimeInterface|float|int|string A string if arguments are invalid
+ * If an array of values is passed for the argument, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function VALUE(mixed $value = '')
+ {
+ if (is_array($value)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);
+ }
+
+ try {
+ $value = self::convertValue($value);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+ if (!is_numeric($value)) {
+ $numberValue = str_replace(
+ StringHelper::getThousandsSeparator(),
+ '',
+ trim($value, " \t\n\r\0\x0B" . StringHelper::getCurrencyCode())
+ );
+ if ($numberValue === '') {
+ return ExcelError::VALUE();
+ }
+ if (is_numeric($numberValue)) {
+ return (float) $numberValue;
+ }
+
+ $dateSetting = Functions::getReturnDateType();
+ Functions::setReturnDateType(Functions::RETURNDATE_EXCEL);
+
+ if (str_contains($value, ':')) {
+ $timeValue = Functions::scalar(DateTimeExcel\TimeValue::fromString($value));
+ if ($timeValue !== ExcelError::VALUE()) {
+ Functions::setReturnDateType($dateSetting);
+
+ return $timeValue;
+ }
+ }
+ $dateValue = Functions::scalar(DateTimeExcel\DateValue::fromString($value));
+ if ($dateValue !== ExcelError::VALUE()) {
+ Functions::setReturnDateType($dateSetting);
+
+ return $dateValue;
+ }
+ Functions::setReturnDateType($dateSetting);
+
+ return ExcelError::VALUE();
+ }
+
+ return (float) $value;
+ }
+
+ /**
+ * VALUETOTEXT.
+ *
+ * @param mixed $value The value to format
+ * Or can be an array of values
+ *
+ * @return array|string If an array of values is passed for either of the arguments, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function valueToText(mixed $value, mixed $format = false): array|string
+ {
+ if (is_array($value) || is_array($format)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $format);
+ }
+
+ $format = (bool) $format;
+
+ if (is_object($value) && $value instanceof RichText) {
+ $value = $value->getPlainText();
+ }
+ if (is_string($value)) {
+ $value = ($format === true) ? Calculation::wrapResult($value) : $value;
+ $value = str_replace("\n", '', $value);
+ } elseif (is_bool($value)) {
+ $value = Calculation::getLocaleBoolean($value ? 'TRUE' : 'FALSE');
+ }
+
+ return (string) $value;
+ }
+
+ private static function getDecimalSeparator(mixed $decimalSeparator): string
+ {
+ return empty($decimalSeparator) ? StringHelper::getDecimalSeparator() : (string) $decimalSeparator;
+ }
+
+ private static function getGroupSeparator(mixed $groupSeparator): string
+ {
+ return empty($groupSeparator) ? StringHelper::getThousandsSeparator() : (string) $groupSeparator;
+ }
+
+ /**
+ * NUMBERVALUE.
+ *
+ * @param mixed $value The value to format
+ * Or can be an array of values
+ * @param mixed $decimalSeparator A string with the decimal separator to use, defaults to locale defined value
+ * Or can be an array of values
+ * @param mixed $groupSeparator A string with the group/thousands separator to use, defaults to locale defined value
+ * Or can be an array of values
+ */
+ public static function NUMBERVALUE(mixed $value = '', mixed $decimalSeparator = null, mixed $groupSeparator = null): array|string|float
+ {
+ if (is_array($value) || is_array($decimalSeparator) || is_array($groupSeparator)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $decimalSeparator, $groupSeparator);
+ }
+
+ try {
+ $value = self::convertValue($value, true);
+ $decimalSeparator = self::getDecimalSeparator($decimalSeparator);
+ $groupSeparator = self::getGroupSeparator($groupSeparator);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+
+ if (!is_numeric($value)) {
+ $decimalPositions = preg_match_all('/' . preg_quote($decimalSeparator, '/') . '/', $value, $matches, PREG_OFFSET_CAPTURE);
+ if ($decimalPositions > 1) {
+ return ExcelError::VALUE();
+ }
+ $decimalOffset = array_pop($matches[0])[1] ?? null;
+ if ($decimalOffset === null || strpos($value, $groupSeparator, $decimalOffset) !== false) {
+ return ExcelError::VALUE();
+ }
+
+ $value = str_replace([$groupSeparator, $decimalSeparator], ['', '.'], $value);
+
+ // Handle the special case of trailing % signs
+ $percentageString = rtrim($value, '%');
+ if (!is_numeric($percentageString)) {
+ return ExcelError::VALUE();
+ }
+
+ $percentageAdjustment = strlen($value) - strlen($percentageString);
+ if ($percentageAdjustment) {
+ $value = (float) $percentageString;
+ $value /= 10 ** ($percentageAdjustment * 2);
+ }
+ }
+
+ return is_array($value) ? ExcelError::VALUE() : (float) $value;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Helpers.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Helpers.php
new file mode 100644
index 00000000..719de04a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Helpers.php
@@ -0,0 +1,92 @@
+getMessage();
+ }
+ $returnValue = $left . $newText . $right;
+ if (StringHelper::countCharacters($returnValue) > DataType::MAX_STRING_LENGTH) {
+ $returnValue = ExcelError::VALUE();
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * SUBSTITUTE.
+ *
+ * @param mixed $text The text string value to modify
+ * Or can be an array of values
+ * @param mixed $fromText The string value that we want to replace in $text
+ * Or can be an array of values
+ * @param mixed $toText The string value that we want to replace with in $text
+ * Or can be an array of values
+ * @param mixed $instance Integer instance Number for the occurrence of frmText to change
+ * Or can be an array of values
+ *
+ * @return array|string If an array of values is passed for either of the arguments, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function substitute(mixed $text = '', mixed $fromText = '', mixed $toText = '', mixed $instance = null): array|string
+ {
+ if (is_array($text) || is_array($fromText) || is_array($toText) || is_array($instance)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $text, $fromText, $toText, $instance);
+ }
+
+ try {
+ $text = Helpers::extractString($text, true);
+ $fromText = Helpers::extractString($fromText, true);
+ $toText = Helpers::extractString($toText, true);
+ if ($instance === null) {
+ $returnValue = str_replace($fromText, $toText, $text);
+ } else {
+ if (is_bool($instance)) {
+ if ($instance === false || Functions::getCompatibilityMode() !== Functions::COMPATIBILITY_OPENOFFICE) {
+ return ExcelError::Value();
+ }
+ $instance = 1;
+ }
+ $instance = Helpers::extractInt($instance, 1, 0, true);
+ $returnValue = self::executeSubstitution($text, $fromText, $toText, $instance);
+ }
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+ if (StringHelper::countCharacters($returnValue) > DataType::MAX_STRING_LENGTH) {
+ $returnValue = ExcelError::VALUE();
+ }
+
+ return $returnValue;
+ }
+
+ private static function executeSubstitution(string $text, string $fromText, string $toText, int $instance): string
+ {
+ $pos = -1;
+ while ($instance > 0) {
+ $pos = mb_strpos($text, $fromText, $pos + 1, 'UTF-8');
+ if ($pos === false) {
+ return $text;
+ }
+ --$instance;
+ }
+
+ return Functions::scalar(self::REPLACE($text, ++$pos, StringHelper::countCharacters($fromText), $toText));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Search.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Search.php
new file mode 100644
index 00000000..663d49fc
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Search.php
@@ -0,0 +1,97 @@
+getMessage();
+ }
+
+ if (StringHelper::countCharacters($haystack) >= $offset) {
+ if (StringHelper::countCharacters($needle) === 0) {
+ return $offset;
+ }
+
+ $pos = mb_strpos($haystack, $needle, --$offset, 'UTF-8');
+ if ($pos !== false) {
+ return ++$pos;
+ }
+ }
+
+ return ExcelError::VALUE();
+ }
+
+ /**
+ * SEARCH (case insensitive search).
+ *
+ * @param mixed $needle The string to look for
+ * Or can be an array of values
+ * @param mixed $haystack The string in which to look
+ * Or can be an array of values
+ * @param mixed $offset Integer offset within $haystack to start searching from
+ * Or can be an array of values
+ *
+ * @return array|int|string The offset where the first occurrence of needle was found in the haystack
+ * If an array of values is passed for the $value or $chars arguments, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function insensitive(mixed $needle, mixed $haystack, mixed $offset = 1): array|string|int
+ {
+ if (is_array($needle) || is_array($haystack) || is_array($offset)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $needle, $haystack, $offset);
+ }
+
+ try {
+ $needle = Helpers::extractString($needle, true);
+ $haystack = Helpers::extractString($haystack, true);
+ $offset = Helpers::extractInt($offset, 1, 0, true);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+
+ if (StringHelper::countCharacters($haystack) >= $offset) {
+ if (StringHelper::countCharacters($needle) === 0) {
+ return $offset;
+ }
+
+ $pos = mb_stripos($haystack, $needle, --$offset, 'UTF-8');
+ if ($pos !== false) {
+ return ++$pos;
+ }
+ }
+
+ return ExcelError::VALUE();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Text.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Text.php
new file mode 100644
index 00000000..f988a6c1
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Text.php
@@ -0,0 +1,245 @@
+getMessage();
+ }
+
+ return mb_strlen($value, 'UTF-8');
+ }
+
+ /**
+ * Compares two text strings and returns TRUE if they are exactly the same, FALSE otherwise.
+ * EXACT is case-sensitive but ignores formatting differences.
+ * Use EXACT to test text being entered into a document.
+ *
+ * @param mixed $value1 String Value
+ * Or can be an array of values
+ * @param mixed $value2 String Value
+ * Or can be an array of values
+ *
+ * @return array|bool|string If an array of values is passed for either of the arguments, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function exact(mixed $value1, mixed $value2): array|bool|string
+ {
+ if (is_array($value1) || is_array($value2)) {
+ return self::evaluateArrayArguments([self::class, __FUNCTION__], $value1, $value2);
+ }
+
+ try {
+ $value1 = Helpers::extractString($value1, true);
+ $value2 = Helpers::extractString($value2, true);
+ } catch (CalcExp $e) {
+ return $e->getMessage();
+ }
+
+ return $value2 === $value1;
+ }
+
+ /**
+ * T.
+ *
+ * @param mixed $testValue Value to check
+ * Or can be an array of values
+ *
+ * @return array|string If an array of values is passed for the argument, then the returned result
+ * will also be an array with matching dimensions
+ */
+ public static function test(mixed $testValue = ''): array|string
+ {
+ if (is_array($testValue)) {
+ return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $testValue);
+ }
+
+ if (is_string($testValue)) {
+ return $testValue;
+ }
+
+ return '';
+ }
+
+ /**
+ * TEXTSPLIT.
+ *
+ * @param mixed $text the text that you're searching
+ * @param null|array|string $columnDelimiter The text that marks the point where to spill the text across columns.
+ * Multiple delimiters can be passed as an array of string values
+ * @param null|array|string $rowDelimiter The text that marks the point where to spill the text down rows.
+ * Multiple delimiters can be passed as an array of string values
+ * @param bool $ignoreEmpty Specify FALSE to create an empty cell when two delimiters are consecutive.
+ * true = create empty cells
+ * false = skip empty cells
+ * Defaults to TRUE, which creates an empty cell
+ * @param bool $matchMode Determines whether the match is case-sensitive or not.
+ * true = case-sensitive
+ * false = case-insensitive
+ * By default, a case-sensitive match is done.
+ * @param mixed $padding The value with which to pad the result.
+ * The default is #N/A.
+ *
+ * @return array|string the array built from the text, split by the row and column delimiters, or an error string
+ */
+ public static function split(mixed $text, $columnDelimiter = null, $rowDelimiter = null, bool $ignoreEmpty = false, bool $matchMode = true, mixed $padding = '#N/A'): array|string
+ {
+ $text = Functions::flattenSingleValue($text);
+ if (ErrorValue::isError($text, true)) {
+ return $text;
+ }
+
+ $flags = self::matchFlags($matchMode);
+
+ if ($rowDelimiter !== null) {
+ $delimiter = self::buildDelimiter($rowDelimiter);
+ $rows = ($delimiter === '()')
+ ? [$text]
+ : preg_split("/{$delimiter}/{$flags}", $text);
+ } else {
+ $rows = [$text];
+ }
+
+ /** @var array $rows */
+ if ($ignoreEmpty === true) {
+ $rows = array_values(array_filter(
+ $rows,
+ fn ($row): bool => $row !== ''
+ ));
+ }
+
+ if ($columnDelimiter !== null) {
+ $delimiter = self::buildDelimiter($columnDelimiter);
+ array_walk(
+ $rows,
+ function (&$row) use ($delimiter, $flags, $ignoreEmpty): void {
+ $row = ($delimiter === '()')
+ ? [$row]
+ : preg_split("/{$delimiter}/{$flags}", $row);
+ /** @var array $row */
+ if ($ignoreEmpty === true) {
+ $row = array_values(array_filter(
+ $row,
+ fn ($value): bool => $value !== ''
+ ));
+ }
+ }
+ );
+ if ($ignoreEmpty === true) {
+ $rows = array_values(array_filter(
+ $rows,
+ fn ($row): bool => $row !== [] && $row !== ['']
+ ));
+ }
+ }
+
+ return self::applyPadding($rows, $padding);
+ }
+
+ private static function applyPadding(array $rows, mixed $padding): array
+ {
+ $columnCount = array_reduce(
+ $rows,
+ fn (int $counter, array $row): int => max($counter, count($row)),
+ 0
+ );
+
+ return array_map(
+ function (array $row) use ($columnCount, $padding): array {
+ return (count($row) < $columnCount)
+ ? array_merge($row, array_fill(0, $columnCount - count($row), $padding))
+ : $row;
+ },
+ $rows
+ );
+ }
+
+ /**
+ * @param null|array|string $delimiter the text that marks the point before which you want to split
+ * Multiple delimiters can be passed as an array of string values
+ */
+ private static function buildDelimiter($delimiter): string
+ {
+ $valueSet = Functions::flattenArray($delimiter);
+
+ if (is_array($delimiter) && count($valueSet) > 1) {
+ $quotedDelimiters = array_map(
+ fn ($delimiter): string => preg_quote($delimiter ?? '', '/'),
+ $valueSet
+ );
+ $delimiters = implode('|', $quotedDelimiters);
+
+ return '(' . $delimiters . ')';
+ }
+
+ return '(' . preg_quote(Functions::flattenSingleValue($delimiter), '/') . ')';
+ }
+
+ private static function matchFlags(bool $matchMode): string
+ {
+ return ($matchMode === true) ? 'miu' : 'mu';
+ }
+
+ public static function fromArray(array $array, int $format = 0): string
+ {
+ $result = [];
+ foreach ($array as $row) {
+ $cells = [];
+ foreach ($row as $cellValue) {
+ $value = ($format === 1) ? self::formatValueMode1($cellValue) : self::formatValueMode0($cellValue);
+ $cells[] = $value;
+ }
+ $result[] = implode(($format === 1) ? ',' : ', ', $cells);
+ }
+
+ $result = implode(($format === 1) ? ';' : ', ', $result);
+
+ return ($format === 1) ? '{' . $result . '}' : $result;
+ }
+
+ private static function formatValueMode0(mixed $cellValue): string
+ {
+ if (is_bool($cellValue)) {
+ return Calculation::getLocaleBoolean($cellValue ? 'TRUE' : 'FALSE');
+ }
+
+ return (string) $cellValue;
+ }
+
+ private static function formatValueMode1(mixed $cellValue): string
+ {
+ if (is_string($cellValue) && ErrorValue::isError($cellValue) === false) {
+ return Calculation::FORMULA_STRING_QUOTE . $cellValue . Calculation::FORMULA_STRING_QUOTE;
+ } elseif (is_bool($cellValue)) {
+ return Calculation::getLocaleBoolean($cellValue ? 'TRUE' : 'FALSE');
+ }
+
+ return (string) $cellValue;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Trim.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Trim.php
new file mode 100644
index 00000000..d8f17062
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/TextData/Trim.php
@@ -0,0 +1,50 @@
+branchPruner = $branchPruner;
+ }
+
+ /**
+ * Return the number of entries on the stack.
+ */
+ public function count(): int
+ {
+ return $this->count;
+ }
+
+ /**
+ * Push a new entry onto the stack.
+ */
+ public function push(string $type, mixed $value, ?string $reference = null): void
+ {
+ $stackItem = $this->getStackItem($type, $value, $reference);
+ $this->stack[$this->count++] = $stackItem;
+
+ if ($type === 'Function') {
+ $localeFunction = Calculation::localeFunc($value);
+ if ($localeFunction != $value) {
+ $this->stack[($this->count - 1)]['localeValue'] = $localeFunction;
+ }
+ }
+ }
+
+ public function pushStackItem(array $stackItem): void
+ {
+ $this->stack[$this->count++] = $stackItem;
+ }
+
+ public function getStackItem(string $type, mixed $value, ?string $reference = null): array
+ {
+ $stackItem = [
+ 'type' => $type,
+ 'value' => $value,
+ 'reference' => $reference,
+ ];
+
+ // will store the result under this alias
+ $storeKey = $this->branchPruner->currentCondition();
+ if (isset($storeKey) || $reference === 'NULL') {
+ $stackItem['storeKey'] = $storeKey;
+ }
+
+ // will only run computation if the matching store key is true
+ $onlyIf = $this->branchPruner->currentOnlyIf();
+ if (isset($onlyIf) || $reference === 'NULL') {
+ $stackItem['onlyIf'] = $onlyIf;
+ }
+
+ // will only run computation if the matching store key is false
+ $onlyIfNot = $this->branchPruner->currentOnlyIfNot();
+ if (isset($onlyIfNot) || $reference === 'NULL') {
+ $stackItem['onlyIfNot'] = $onlyIfNot;
+ }
+
+ return $stackItem;
+ }
+
+ /**
+ * Pop the last entry from the stack.
+ */
+ public function pop(): ?array
+ {
+ if ($this->count > 0) {
+ return $this->stack[--$this->count];
+ }
+
+ return null;
+ }
+
+ /**
+ * Return an entry from the stack without removing it.
+ */
+ public function last(int $n = 1): ?array
+ {
+ if ($this->count - $n < 0) {
+ return null;
+ }
+
+ return $this->stack[$this->count - $n];
+ }
+
+ /**
+ * Clear the stack.
+ */
+ public function clear(): void
+ {
+ $this->stack = [];
+ $this->count = 0;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Web/Service.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Web/Service.php
new file mode 100644
index 00000000..55813414
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/Web/Service.php
@@ -0,0 +1,73 @@
+ 2048) {
+ return ExcelError::VALUE(); // Invalid URL length
+ }
+
+ if (!preg_match('/^http[s]?:\/\//', $url)) {
+ return ExcelError::VALUE(); // Invalid protocol
+ }
+
+ // Get results from the the webservice
+ $client = Settings::getHttpClient();
+ $requestFactory = Settings::getRequestFactory();
+ $request = $requestFactory->createRequest('GET', $url);
+
+ try {
+ $response = $client->sendRequest($request);
+ } catch (ClientExceptionInterface) {
+ return ExcelError::VALUE(); // cURL error
+ }
+
+ if ($response->getStatusCode() != 200) {
+ return ExcelError::VALUE(); // cURL error
+ }
+
+ $output = $response->getBody()->getContents();
+ if (strlen($output) > 32767) {
+ return ExcelError::VALUE(); // Output not a string or too long
+ }
+
+ return $output;
+ }
+
+ /**
+ * URLENCODE.
+ *
+ * Returns data from a web service on the Internet or Intranet.
+ *
+ * Excel Function:
+ * urlEncode(text)
+ *
+ * @return string the url encoded output
+ */
+ public static function urlEncode(mixed $text): string
+ {
+ if (!is_string($text)) {
+ return ExcelError::VALUE();
+ }
+
+ return str_replace('+', '%20', urlencode($text));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/Translations.xlsx b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/Translations.xlsx
new file mode 100644
index 00000000..080d5e7a
Binary files /dev/null and b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/Translations.xlsx differ
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/bg/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/bg/config
new file mode 100644
index 00000000..689203c5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/bg/config
@@ -0,0 +1,24 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## български (Bulgarian)
+##
+############################################################
+
+ArgumentSeparator = ;
+##
+## (For future use)
+##
+currencySymbol = лв
+
+##
+## Error Codes
+##
+NULL = #ПРАЗНО!
+DIV0 = #ДЕЛ/0!
+VALUE = #СТОЙНОСТ!
+REF = #РЕФ!
+NAME = #ИМЕ?
+NUM = #ЧИСЛО!
+NA = #Н/Д
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/bg/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/bg/functions
new file mode 100644
index 00000000..ec56433c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/bg/functions
@@ -0,0 +1,409 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## български (Bulgarian)
+##
+############################################################
+
+
+##
+## Функции Куб (Cube Functions)
+##
+CUBEKPIMEMBER = КУБЭЛЕМЕНТКИП
+CUBEMEMBER = КУБЭЛЕМЕНТ
+CUBEMEMBERPROPERTY = КУБСВОЙСТВОЭЛЕМЕНТА
+CUBERANKEDMEMBER = КУБПОРЭЛЕМЕНТ
+CUBESET = КУБМНОЖ
+CUBESETCOUNT = КУБЧИСЛОЭЛМНОЖ
+CUBEVALUE = КУБЗНАЧЕНИЕ
+
+##
+## Функции для работы с базами данных (Database Functions)
+##
+DAVERAGE = ДСРЗНАЧ
+DCOUNT = БСЧЁТ
+DCOUNTA = БСЧЁТА
+DGET = БИЗВЛЕЧЬ
+DMAX = ДМАКС
+DMIN = ДМИН
+DPRODUCT = БДПРОИЗВЕД
+DSTDEV = ДСТАНДОТКЛ
+DSTDEVP = ДСТАНДОТКЛП
+DSUM = БДСУММ
+DVAR = БДДИСП
+DVARP = БДДИСПП
+
+##
+## Функции даты и времени (Date & Time Functions)
+##
+DATE = ДАТА
+DATEVALUE = ДАТАЗНАЧ
+DAY = ДЕНЬ
+DAYS360 = ДНЕЙ360
+EDATE = ДАТАМЕС
+EOMONTH = КОНМЕСЯЦА
+HOUR = ЧАС
+MINUTE = МИНУТЫ
+MONTH = МЕСЯЦ
+NETWORKDAYS = ЧИСТРАБДНИ
+NOW = ТДАТА
+SECOND = СЕКУНДЫ
+TIME = ВРЕМЯ
+TIMEVALUE = ВРЕМЗНАЧ
+TODAY = СЕГОДНЯ
+WEEKDAY = ДЕНЬНЕД
+WEEKNUM = НОМНЕДЕЛИ
+WORKDAY = РАБДЕНЬ
+YEAR = ГОД
+YEARFRAC = ДОЛЯГОДА
+
+##
+## Инженерные функции (Engineering Functions)
+##
+BESSELI = БЕССЕЛЬ.I
+BESSELJ = БЕССЕЛЬ.J
+BESSELK = БЕССЕЛЬ.K
+BESSELY = БЕССЕЛЬ.Y
+BIN2DEC = ДВ.В.ДЕС
+BIN2HEX = ДВ.В.ШЕСТН
+BIN2OCT = ДВ.В.ВОСЬМ
+COMPLEX = КОМПЛЕКСН
+CONVERT = ПРЕОБР
+DEC2BIN = ДЕС.В.ДВ
+DEC2HEX = ДЕС.В.ШЕСТН
+DEC2OCT = ДЕС.В.ВОСЬМ
+DELTA = ДЕЛЬТА
+ERF = ФОШ
+ERFC = ДФОШ
+GESTEP = ПОРОГ
+HEX2BIN = ШЕСТН.В.ДВ
+HEX2DEC = ШЕСТН.В.ДЕС
+HEX2OCT = ШЕСТН.В.ВОСЬМ
+IMABS = МНИМ.ABS
+IMAGINARY = МНИМ.ЧАСТЬ
+IMARGUMENT = МНИМ.АРГУМЕНТ
+IMCONJUGATE = МНИМ.СОПРЯЖ
+IMCOS = МНИМ.COS
+IMDIV = МНИМ.ДЕЛ
+IMEXP = МНИМ.EXP
+IMLN = МНИМ.LN
+IMLOG10 = МНИМ.LOG10
+IMLOG2 = МНИМ.LOG2
+IMPOWER = МНИМ.СТЕПЕНЬ
+IMPRODUCT = МНИМ.ПРОИЗВЕД
+IMREAL = МНИМ.ВЕЩ
+IMSIN = МНИМ.SIN
+IMSQRT = МНИМ.КОРЕНЬ
+IMSUB = МНИМ.РАЗН
+IMSUM = МНИМ.СУММ
+OCT2BIN = ВОСЬМ.В.ДВ
+OCT2DEC = ВОСЬМ.В.ДЕС
+OCT2HEX = ВОСЬМ.В.ШЕСТН
+
+##
+## Финансовые функции (Financial Functions)
+##
+ACCRINT = НАКОПДОХОД
+ACCRINTM = НАКОПДОХОДПОГАШ
+AMORDEGRC = АМОРУМ
+AMORLINC = АМОРУВ
+COUPDAYBS = ДНЕЙКУПОНДО
+COUPDAYS = ДНЕЙКУПОН
+COUPDAYSNC = ДНЕЙКУПОНПОСЛЕ
+COUPNCD = ДАТАКУПОНПОСЛЕ
+COUPNUM = ЧИСЛКУПОН
+COUPPCD = ДАТАКУПОНДО
+CUMIPMT = ОБЩПЛАТ
+CUMPRINC = ОБЩДОХОД
+DB = ФУО
+DDB = ДДОБ
+DISC = СКИДКА
+DOLLARDE = РУБЛЬ.ДЕС
+DOLLARFR = РУБЛЬ.ДРОБЬ
+DURATION = ДЛИТ
+EFFECT = ЭФФЕКТ
+FV = БС
+FVSCHEDULE = БЗРАСПИС
+INTRATE = ИНОРМА
+IPMT = ПРПЛТ
+IRR = ВСД
+ISPMT = ПРОЦПЛАТ
+MDURATION = МДЛИТ
+MIRR = МВСД
+NOMINAL = НОМИНАЛ
+NPER = КПЕР
+NPV = ЧПС
+ODDFPRICE = ЦЕНАПЕРВНЕРЕГ
+ODDFYIELD = ДОХОДПЕРВНЕРЕГ
+ODDLPRICE = ЦЕНАПОСЛНЕРЕГ
+ODDLYIELD = ДОХОДПОСЛНЕРЕГ
+PMT = ПЛТ
+PPMT = ОСПЛТ
+PRICE = ЦЕНА
+PRICEDISC = ЦЕНАСКИДКА
+PRICEMAT = ЦЕНАПОГАШ
+PV = ПС
+RATE = СТАВКА
+RECEIVED = ПОЛУЧЕНО
+SLN = АПЛ
+SYD = АСЧ
+TBILLEQ = РАВНОКЧЕК
+TBILLPRICE = ЦЕНАКЧЕК
+TBILLYIELD = ДОХОДКЧЕК
+VDB = ПУО
+XIRR = ЧИСТВНДОХ
+XNPV = ЧИСТНЗ
+YIELD = ДОХОД
+YIELDDISC = ДОХОДСКИДКА
+YIELDMAT = ДОХОДПОГАШ
+
+##
+## Информационные функции (Information Functions)
+##
+CELL = ЯЧЕЙКА
+ERROR.TYPE = ТИП.ОШИБКИ
+INFO = ИНФОРМ
+ISBLANK = ЕПУСТО
+ISERR = ЕОШ
+ISERROR = ЕОШИБКА
+ISEVEN = ЕЧЁТН
+ISLOGICAL = ЕЛОГИЧ
+ISNA = ЕНД
+ISNONTEXT = ЕНЕТЕКСТ
+ISNUMBER = ЕЧИСЛО
+ISODD = ЕНЕЧЁТ
+ISREF = ЕССЫЛКА
+ISTEXT = ЕТЕКСТ
+N = Ч
+NA = НД
+TYPE = ТИП
+
+##
+## Логические функции (Logical Functions)
+##
+AND = И
+FALSE = ЛОЖЬ
+IF = ЕСЛИ
+IFERROR = ЕСЛИОШИБКА
+NOT = НЕ
+OR = ИЛИ
+TRUE = ИСТИНА
+
+##
+## Функции ссылки и поиска (Lookup & Reference Functions)
+##
+ADDRESS = АДРЕС
+AREAS = ОБЛАСТИ
+CHOOSE = ВЫБОР
+COLUMN = СТОЛБЕЦ
+COLUMNS = ЧИСЛСТОЛБ
+GETPIVOTDATA = ПОЛУЧИТЬ.ДАННЫЕ.СВОДНОЙ.ТАБЛИЦЫ
+HLOOKUP = ГПР
+HYPERLINK = ГИПЕРССЫЛКА
+INDEX = ИНДЕКС
+INDIRECT = ДВССЫЛ
+LOOKUP = ПРОСМОТР
+MATCH = ПОИСКПОЗ
+OFFSET = СМЕЩ
+ROW = СТРОКА
+ROWS = ЧСТРОК
+RTD = ДРВ
+TRANSPOSE = ТРАНСП
+VLOOKUP = ВПР
+
+##
+## Математические и тригонометрические функции (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = ACOS
+ACOSH = ACOSH
+ASIN = ASIN
+ASINH = ASINH
+ATAN = ATAN
+ATAN2 = ATAN2
+ATANH = ATANH
+COMBIN = ЧИСЛКОМБ
+COS = COS
+COSH = COSH
+DEGREES = ГРАДУСЫ
+EVEN = ЧЁТН
+EXP = EXP
+FACT = ФАКТР
+FACTDOUBLE = ДВФАКТР
+GCD = НОД
+INT = ЦЕЛОЕ
+LCM = НОК
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = МОПРЕД
+MINVERSE = МОБР
+MMULT = МУМНОЖ
+MOD = ОСТАТ
+MROUND = ОКРУГЛТ
+MULTINOMIAL = МУЛЬТИНОМ
+ODD = НЕЧЁТ
+PI = ПИ
+POWER = СТЕПЕНЬ
+PRODUCT = ПРОИЗВЕД
+QUOTIENT = ЧАСТНОЕ
+RADIANS = РАДИАНЫ
+RAND = СЛЧИС
+RANDBETWEEN = СЛУЧМЕЖДУ
+ROMAN = РИМСКОЕ
+ROUND = ОКРУГЛ
+ROUNDDOWN = ОКРУГЛВНИЗ
+ROUNDUP = ОКРУГЛВВЕРХ
+SERIESSUM = РЯД.СУММ
+SIGN = ЗНАК
+SIN = SIN
+SINH = SINH
+SQRT = КОРЕНЬ
+SQRTPI = КОРЕНЬПИ
+SUBTOTAL = ПРОМЕЖУТОЧНЫЕ.ИТОГИ
+SUM = СУММ
+SUMIF = СУММЕСЛИ
+SUMIFS = СУММЕСЛИМН
+SUMPRODUCT = СУММПРОИЗВ
+SUMSQ = СУММКВ
+SUMX2MY2 = СУММРАЗНКВ
+SUMX2PY2 = СУММСУММКВ
+SUMXMY2 = СУММКВРАЗН
+TAN = TAN
+TANH = TANH
+TRUNC = ОТБР
+
+##
+## Статистические функции (Statistical Functions)
+##
+AVEDEV = СРОТКЛ
+AVERAGE = СРЗНАЧ
+AVERAGEA = СРЗНАЧА
+AVERAGEIF = СРЗНАЧЕСЛИ
+AVERAGEIFS = СРЗНАЧЕСЛИМН
+CORREL = КОРРЕЛ
+COUNT = СЧЁТ
+COUNTA = СЧЁТЗ
+COUNTBLANK = СЧИТАТЬПУСТОТЫ
+COUNTIF = СЧЁТЕСЛИ
+COUNTIFS = СЧЁТЕСЛИМН
+DEVSQ = КВАДРОТКЛ
+FISHER = ФИШЕР
+FISHERINV = ФИШЕРОБР
+FREQUENCY = ЧАСТОТА
+GAMMALN = ГАММАНЛОГ
+GEOMEAN = СРГЕОМ
+GROWTH = РОСТ
+HARMEAN = СРГАРМ
+INTERCEPT = ОТРЕЗОК
+KURT = ЭКСЦЕСС
+LARGE = НАИБОЛЬШИЙ
+LINEST = ЛИНЕЙН
+LOGEST = ЛГРФПРИБЛ
+MAX = МАКС
+MAXA = МАКСА
+MEDIAN = МЕДИАНА
+MIN = МИН
+MINA = МИНА
+PEARSON = ПИРСОН
+PERMUT = ПЕРЕСТ
+PROB = ВЕРОЯТНОСТЬ
+RSQ = КВПИРСОН
+SKEW = СКОС
+SLOPE = НАКЛОН
+SMALL = НАИМЕНЬШИЙ
+STANDARDIZE = НОРМАЛИЗАЦИЯ
+STDEVA = СТАНДОТКЛОНА
+STDEVPA = СТАНДОТКЛОНПА
+STEYX = СТОШYX
+TREND = ТЕНДЕНЦИЯ
+TRIMMEAN = УРЕЗСРЕДНЕЕ
+VARA = ДИСПА
+VARPA = ДИСПРА
+
+##
+## Текстовые функции (Text Functions)
+##
+ASC = ASC
+BAHTTEXT = БАТТЕКСТ
+CHAR = СИМВОЛ
+CLEAN = ПЕЧСИМВ
+CODE = КОДСИМВ
+DOLLAR = РУБЛЬ
+EXACT = СОВПАД
+FIND = НАЙТИ
+FINDB = НАЙТИБ
+FIXED = ФИКСИРОВАННЫЙ
+LEFT = ЛЕВСИМВ
+LEFTB = ЛЕВБ
+LEN = ДЛСТР
+LENB = ДЛИНБ
+LOWER = СТРОЧН
+MID = ПСТР
+MIDB = ПСТРБ
+PHONETIC = PHONETIC
+PROPER = ПРОПНАЧ
+REPLACE = ЗАМЕНИТЬ
+REPLACEB = ЗАМЕНИТЬБ
+REPT = ПОВТОР
+RIGHT = ПРАВСИМВ
+RIGHTB = ПРАВБ
+SEARCH = ПОИСК
+SEARCHB = ПОИСКБ
+SUBSTITUTE = ПОДСТАВИТЬ
+T = Т
+TEXT = ТЕКСТ
+TRIM = СЖПРОБЕЛЫ
+UPPER = ПРОПИСН
+VALUE = ЗНАЧЕН
+
+##
+## (Web Functions)
+##
+
+##
+## (Compatibility Functions)
+##
+BETADIST = БЕТАРАСП
+BETAINV = БЕТАОБР
+BINOMDIST = БИНОМРАСП
+CEILING = ОКРВВЕРХ
+CHIDIST = ХИ2РАСП
+CHIINV = ХИ2ОБР
+CHITEST = ХИ2ТЕСТ
+CONCATENATE = СЦЕПИТЬ
+CONFIDENCE = ДОВЕРИТ
+COVAR = КОВАР
+CRITBINOM = КРИТБИНОМ
+EXPONDIST = ЭКСПРАСП
+FDIST = FРАСП
+FINV = FРАСПОБР
+FLOOR = ОКРВНИЗ
+FORECAST = ПРЕДСКАЗ
+FTEST = ФТЕСТ
+GAMMADIST = ГАММАРАСП
+GAMMAINV = ГАММАОБР
+HYPGEOMDIST = ГИПЕРГЕОМЕТ
+LOGINV = ЛОГНОРМОБР
+LOGNORMDIST = ЛОГНОРМРАСП
+MODE = МОДА
+NEGBINOMDIST = ОТРБИНОМРАСП
+NORMDIST = НОРМРАСП
+NORMINV = НОРМОБР
+NORMSDIST = НОРМСТРАСП
+NORMSINV = НОРМСТОБР
+PERCENTILE = ПЕРСЕНТИЛЬ
+PERCENTRANK = ПРОЦЕНТРАНГ
+POISSON = ПУАССОН
+QUARTILE = КВАРТИЛЬ
+RANK = РАНГ
+STDEV = СТАНДОТКЛОН
+STDEVP = СТАНДОТКЛОНП
+TDIST = СТЬЮДРАСП
+TINV = СТЬЮДРАСПОБР
+TTEST = ТТЕСТ
+VAR = ДИСП
+VARP = ДИСПР
+WEIBULL = ВЕЙБУЛЛ
+ZTEST = ZТЕСТ
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/cs/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/cs/config
new file mode 100644
index 00000000..49f40fcb
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/cs/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Ceština (Czech)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL
+DIV0 = #DĚLENÍ_NULOU!
+VALUE = #HODNOTA!
+REF = #ODKAZ!
+NAME = #NÁZEV?
+NUM = #ČÍSLO!
+NA = #NENÍ_K_DISPOZICI
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/cs/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/cs/functions
new file mode 100644
index 00000000..49c4945c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/cs/functions
@@ -0,0 +1,520 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Ceština (Czech)
+##
+############################################################
+
+
+##
+## Funkce pro práci s datovými krychlemi (Cube Functions)
+##
+CUBEKPIMEMBER = CUBEKPIMEMBER
+CUBEMEMBER = CUBEMEMBER
+CUBEMEMBERPROPERTY = CUBEMEMBERPROPERTY
+CUBERANKEDMEMBER = CUBERANKEDMEMBER
+CUBESET = CUBESET
+CUBESETCOUNT = CUBESETCOUNT
+CUBEVALUE = CUBEVALUE
+
+##
+## Funkce databáze (Database Functions)
+##
+DAVERAGE = DPRŮMĚR
+DCOUNT = DPOČET
+DCOUNTA = DPOČET2
+DGET = DZÍSKAT
+DMAX = DMAX
+DMIN = DMIN
+DPRODUCT = DSOUČIN
+DSTDEV = DSMODCH.VÝBĚR
+DSTDEVP = DSMODCH
+DSUM = DSUMA
+DVAR = DVAR.VÝBĚR
+DVARP = DVAR
+
+##
+## Funkce data a času (Date & Time Functions)
+##
+DATE = DATUM
+DATEVALUE = DATUMHODN
+DAY = DEN
+DAYS = DAYS
+DAYS360 = ROK360
+EDATE = EDATE
+EOMONTH = EOMONTH
+HOUR = HODINA
+ISOWEEKNUM = ISOWEEKNUM
+MINUTE = MINUTA
+MONTH = MĚSÍC
+NETWORKDAYS = NETWORKDAYS
+NETWORKDAYS.INTL = NETWORKDAYS.INTL
+NOW = NYNÍ
+SECOND = SEKUNDA
+TIME = ČAS
+TIMEVALUE = ČASHODN
+TODAY = DNES
+WEEKDAY = DENTÝDNE
+WEEKNUM = WEEKNUM
+WORKDAY = WORKDAY
+WORKDAY.INTL = WORKDAY.INTL
+YEAR = ROK
+YEARFRAC = YEARFRAC
+
+##
+## Inženýrské funkce (Engineering Functions)
+##
+BESSELI = BESSELI
+BESSELJ = BESSELJ
+BESSELK = BESSELK
+BESSELY = BESSELY
+BIN2DEC = BIN2DEC
+BIN2HEX = BIN2HEX
+BIN2OCT = BIN2OCT
+BITAND = BITAND
+BITLSHIFT = BITLSHIFT
+BITOR = BITOR
+BITRSHIFT = BITRSHIFT
+BITXOR = BITXOR
+COMPLEX = COMPLEX
+CONVERT = CONVERT
+DEC2BIN = DEC2BIN
+DEC2HEX = DEC2HEX
+DEC2OCT = DEC2OCT
+DELTA = DELTA
+ERF = ERF
+ERF.PRECISE = ERF.PRECISE
+ERFC = ERFC
+ERFC.PRECISE = ERFC.PRECISE
+GESTEP = GESTEP
+HEX2BIN = HEX2BIN
+HEX2DEC = HEX2DEC
+HEX2OCT = HEX2OCT
+IMABS = IMABS
+IMAGINARY = IMAGINARY
+IMARGUMENT = IMARGUMENT
+IMCONJUGATE = IMCONJUGATE
+IMCOS = IMCOS
+IMCOSH = IMCOSH
+IMCOT = IMCOT
+IMCSC = IMCSC
+IMCSCH = IMCSCH
+IMDIV = IMDIV
+IMEXP = IMEXP
+IMLN = IMLN
+IMLOG10 = IMLOG10
+IMLOG2 = IMLOG2
+IMPOWER = IMPOWER
+IMPRODUCT = IMPRODUCT
+IMREAL = IMREAL
+IMSEC = IMSEC
+IMSECH = IMSECH
+IMSIN = IMSIN
+IMSINH = IMSINH
+IMSQRT = IMSQRT
+IMSUB = IMSUB
+IMSUM = IMSUM
+IMTAN = IMTAN
+OCT2BIN = OCT2BIN
+OCT2DEC = OCT2DEC
+OCT2HEX = OCT2HEX
+
+##
+## Finanční funkce (Financial Functions)
+##
+ACCRINT = ACCRINT
+ACCRINTM = ACCRINTM
+AMORDEGRC = AMORDEGRC
+AMORLINC = AMORLINC
+COUPDAYBS = COUPDAYBS
+COUPDAYS = COUPDAYS
+COUPDAYSNC = COUPDAYSNC
+COUPNCD = COUPNCD
+COUPNUM = COUPNUM
+COUPPCD = COUPPCD
+CUMIPMT = CUMIPMT
+CUMPRINC = CUMPRINC
+DB = ODPIS.ZRYCH
+DDB = ODPIS.ZRYCH2
+DISC = DISC
+DOLLARDE = DOLLARDE
+DOLLARFR = DOLLARFR
+DURATION = DURATION
+EFFECT = EFFECT
+FV = BUDHODNOTA
+FVSCHEDULE = FVSCHEDULE
+INTRATE = INTRATE
+IPMT = PLATBA.ÚROK
+IRR = MÍRA.VÝNOSNOSTI
+ISPMT = ISPMT
+MDURATION = MDURATION
+MIRR = MOD.MÍRA.VÝNOSNOSTI
+NOMINAL = NOMINAL
+NPER = POČET.OBDOBÍ
+NPV = ČISTÁ.SOUČHODNOTA
+ODDFPRICE = ODDFPRICE
+ODDFYIELD = ODDFYIELD
+ODDLPRICE = ODDLPRICE
+ODDLYIELD = ODDLYIELD
+PDURATION = PDURATION
+PMT = PLATBA
+PPMT = PLATBA.ZÁKLAD
+PRICE = PRICE
+PRICEDISC = PRICEDISC
+PRICEMAT = PRICEMAT
+PV = SOUČHODNOTA
+RATE = ÚROKOVÁ.MÍRA
+RECEIVED = RECEIVED
+RRI = RRI
+SLN = ODPIS.LIN
+SYD = ODPIS.NELIN
+TBILLEQ = TBILLEQ
+TBILLPRICE = TBILLPRICE
+TBILLYIELD = TBILLYIELD
+VDB = ODPIS.ZA.INT
+XIRR = XIRR
+XNPV = XNPV
+YIELD = YIELD
+YIELDDISC = YIELDDISC
+YIELDMAT = YIELDMAT
+
+##
+## Informační funkce (Information Functions)
+##
+CELL = POLÍČKO
+ERROR.TYPE = CHYBA.TYP
+INFO = O.PROSTŘEDÍ
+ISBLANK = JE.PRÁZDNÉ
+ISERR = JE.CHYBA
+ISERROR = JE.CHYBHODN
+ISEVEN = ISEVEN
+ISFORMULA = ISFORMULA
+ISLOGICAL = JE.LOGHODN
+ISNA = JE.NEDEF
+ISNONTEXT = JE.NETEXT
+ISNUMBER = JE.ČISLO
+ISODD = ISODD
+ISREF = JE.ODKAZ
+ISTEXT = JE.TEXT
+N = N
+NA = NEDEF
+SHEET = SHEET
+SHEETS = SHEETS
+TYPE = TYP
+
+##
+## Logické funkce (Logical Functions)
+##
+AND = A
+FALSE = NEPRAVDA
+IF = KDYŽ
+IFERROR = IFERROR
+IFNA = IFNA
+IFS = IFS
+NOT = NE
+OR = NEBO
+SWITCH = SWITCH
+TRUE = PRAVDA
+XOR = XOR
+
+##
+## Vyhledávací funkce a funkce pro odkazy (Lookup & Reference Functions)
+##
+ADDRESS = ODKAZ
+AREAS = POČET.BLOKŮ
+CHOOSE = ZVOLIT
+COLUMN = SLOUPEC
+COLUMNS = SLOUPCE
+FORMULATEXT = FORMULATEXT
+GETPIVOTDATA = ZÍSKATKONTDATA
+HLOOKUP = VVYHLEDAT
+HYPERLINK = HYPERTEXTOVÝ.ODKAZ
+INDEX = INDEX
+INDIRECT = NEPŘÍMÝ.ODKAZ
+LOOKUP = VYHLEDAT
+MATCH = POZVYHLEDAT
+OFFSET = POSUN
+ROW = ŘÁDEK
+ROWS = ŘÁDKY
+RTD = RTD
+TRANSPOSE = TRANSPOZICE
+VLOOKUP = SVYHLEDAT
+
+##
+## Matematické a trigonometrické funkce (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = ARCCOS
+ACOSH = ARCCOSH
+ACOT = ACOT
+ACOTH = ACOTH
+AGGREGATE = AGGREGATE
+ARABIC = ARABIC
+ASIN = ARCSIN
+ASINH = ARCSINH
+ATAN = ARCTG
+ATAN2 = ARCTG2
+ATANH = ARCTGH
+BASE = BASE
+CEILING.MATH = CEILING.MATH
+COMBIN = KOMBINACE
+COMBINA = COMBINA
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = CSC
+CSCH = CSCH
+DECIMAL = DECIMAL
+DEGREES = DEGREES
+EVEN = ZAOKROUHLIT.NA.SUDÉ
+EXP = EXP
+FACT = FAKTORIÁL
+FACTDOUBLE = FACTDOUBLE
+FLOOR.MATH = FLOOR.MATH
+GCD = GCD
+INT = CELÁ.ČÁST
+LCM = LCM
+LN = LN
+LOG = LOGZ
+LOG10 = LOG
+MDETERM = DETERMINANT
+MINVERSE = INVERZE
+MMULT = SOUČIN.MATIC
+MOD = MOD
+MROUND = MROUND
+MULTINOMIAL = MULTINOMIAL
+MUNIT = MUNIT
+ODD = ZAOKROUHLIT.NA.LICHÉ
+PI = PI
+POWER = POWER
+PRODUCT = SOUČIN
+QUOTIENT = QUOTIENT
+RADIANS = RADIANS
+RAND = NÁHČÍSLO
+RANDBETWEEN = RANDBETWEEN
+ROMAN = ROMAN
+ROUND = ZAOKROUHLIT
+ROUNDDOWN = ROUNDDOWN
+ROUNDUP = ROUNDUP
+SEC = SEC
+SECH = SECH
+SERIESSUM = SERIESSUM
+SIGN = SIGN
+SIN = SIN
+SINH = SINH
+SQRT = ODMOCNINA
+SQRTPI = SQRTPI
+SUBTOTAL = SUBTOTAL
+SUM = SUMA
+SUMIF = SUMIF
+SUMIFS = SUMIFS
+SUMPRODUCT = SOUČIN.SKALÁRNÍ
+SUMSQ = SUMA.ČTVERCŮ
+SUMX2MY2 = SUMX2MY2
+SUMX2PY2 = SUMX2PY2
+SUMXMY2 = SUMXMY2
+TAN = TG
+TANH = TGH
+TRUNC = USEKNOUT
+
+##
+## Statistické funkce (Statistical Functions)
+##
+AVEDEV = PRŮMODCHYLKA
+AVERAGE = PRŮMĚR
+AVERAGEA = AVERAGEA
+AVERAGEIF = AVERAGEIF
+AVERAGEIFS = AVERAGEIFS
+BETA.DIST = BETA.DIST
+BETA.INV = BETA.INV
+BINOM.DIST = BINOM.DIST
+BINOM.DIST.RANGE = BINOM.DIST.RANGE
+BINOM.INV = BINOM.INV
+CHISQ.DIST = CHISQ.DIST
+CHISQ.DIST.RT = CHISQ.DIST.RT
+CHISQ.INV = CHISQ.INV
+CHISQ.INV.RT = CHISQ.INV.RT
+CHISQ.TEST = CHISQ.TEST
+CONFIDENCE.NORM = CONFIDENCE.NORM
+CONFIDENCE.T = CONFIDENCE.T
+CORREL = CORREL
+COUNT = POČET
+COUNTA = POČET2
+COUNTBLANK = COUNTBLANK
+COUNTIF = COUNTIF
+COUNTIFS = COUNTIFS
+COVARIANCE.P = COVARIANCE.P
+COVARIANCE.S = COVARIANCE.S
+DEVSQ = DEVSQ
+EXPON.DIST = EXPON.DIST
+F.DIST = F.DIST
+F.DIST.RT = F.DIST.RT
+F.INV = F.INV
+F.INV.RT = F.INV.RT
+F.TEST = F.TEST
+FISHER = FISHER
+FISHERINV = FISHERINV
+FORECAST.ETS = FORECAST.ETS
+FORECAST.ETS.CONFINT = FORECAST.ETS.CONFINT
+FORECAST.ETS.SEASONALITY = FORECAST.ETS.SEASONALITY
+FORECAST.ETS.STAT = FORECAST.ETS.STAT
+FORECAST.LINEAR = FORECAST.LINEAR
+FREQUENCY = ČETNOSTI
+GAMMA = GAMMA
+GAMMA.DIST = GAMMA.DIST
+GAMMA.INV = GAMMA.INV
+GAMMALN = GAMMALN
+GAMMALN.PRECISE = GAMMALN.PRECISE
+GAUSS = GAUSS
+GEOMEAN = GEOMEAN
+GROWTH = LOGLINTREND
+HARMEAN = HARMEAN
+HYPGEOM.DIST = HYPGEOM.DIST
+INTERCEPT = INTERCEPT
+KURT = KURT
+LARGE = LARGE
+LINEST = LINREGRESE
+LOGEST = LOGLINREGRESE
+LOGNORM.DIST = LOGNORM.DIST
+LOGNORM.INV = LOGNORM.INV
+MAX = MAX
+MAXA = MAXA
+MAXIFS = MAXIFS
+MEDIAN = MEDIAN
+MIN = MIN
+MINA = MINA
+MINIFS = MINIFS
+MODE.MULT = MODE.MULT
+MODE.SNGL = MODE.SNGL
+NEGBINOM.DIST = NEGBINOM.DIST
+NORM.DIST = NORM.DIST
+NORM.INV = NORM.INV
+NORM.S.DIST = NORM.S.DIST
+NORM.S.INV = NORM.S.INV
+PEARSON = PEARSON
+PERCENTILE.EXC = PERCENTIL.EXC
+PERCENTILE.INC = PERCENTIL.INC
+PERCENTRANK.EXC = PERCENTRANK.EXC
+PERCENTRANK.INC = PERCENTRANK.INC
+PERMUT = PERMUTACE
+PERMUTATIONA = PERMUTATIONA
+PHI = PHI
+POISSON.DIST = POISSON.DIST
+PROB = PROB
+QUARTILE.EXC = QUARTIL.EXC
+QUARTILE.INC = QUARTIL.INC
+RANK.AVG = RANK.AVG
+RANK.EQ = RANK.EQ
+RSQ = RKQ
+SKEW = SKEW
+SKEW.P = SKEW.P
+SLOPE = SLOPE
+SMALL = SMALL
+STANDARDIZE = STANDARDIZE
+STDEV.P = SMODCH.P
+STDEV.S = SMODCH.VÝBĚR.S
+STDEVA = STDEVA
+STDEVPA = STDEVPA
+STEYX = STEYX
+T.DIST = T.DIST
+T.DIST.2T = T.DIST.2T
+T.DIST.RT = T.DIST.RT
+T.INV = T.INV
+T.INV.2T = T.INV.2T
+T.TEST = T.TEST
+TREND = LINTREND
+TRIMMEAN = TRIMMEAN
+VAR.P = VAR.P
+VAR.S = VAR.S
+VARA = VARA
+VARPA = VARPA
+WEIBULL.DIST = WEIBULL.DIST
+Z.TEST = Z.TEST
+
+##
+## Textové funkce (Text Functions)
+##
+BAHTTEXT = BAHTTEXT
+CHAR = ZNAK
+CLEAN = VYČISTIT
+CODE = KÓD
+CONCAT = CONCAT
+DOLLAR = KČ
+EXACT = STEJNÉ
+FIND = NAJÍT
+FIXED = ZAOKROUHLIT.NA.TEXT
+LEFT = ZLEVA
+LEN = DÉLKA
+LOWER = MALÁ
+MID = ČÁST
+NUMBERVALUE = NUMBERVALUE
+PHONETIC = ZVUKOVÉ
+PROPER = VELKÁ2
+REPLACE = NAHRADIT
+REPT = OPAKOVAT
+RIGHT = ZPRAVA
+SEARCH = HLEDAT
+SUBSTITUTE = DOSADIT
+T = T
+TEXT = HODNOTA.NA.TEXT
+TEXTJOIN = TEXTJOIN
+TRIM = PROČISTIT
+UNICHAR = UNICHAR
+UNICODE = UNICODE
+UPPER = VELKÁ
+VALUE = HODNOTA
+
+##
+## Webové funkce (Web Functions)
+##
+ENCODEURL = ENCODEURL
+FILTERXML = FILTERXML
+WEBSERVICE = WEBSERVICE
+
+##
+## Funkce pro kompatibilitu (Compatibility Functions)
+##
+BETADIST = BETADIST
+BETAINV = BETAINV
+BINOMDIST = BINOMDIST
+CEILING = ZAOKR.NAHORU
+CHIDIST = CHIDIST
+CHIINV = CHIINV
+CHITEST = CHITEST
+CONCATENATE = CONCATENATE
+CONFIDENCE = CONFIDENCE
+COVAR = COVAR
+CRITBINOM = CRITBINOM
+EXPONDIST = EXPONDIST
+FDIST = FDIST
+FINV = FINV
+FLOOR = ZAOKR.DOLŮ
+FORECAST = FORECAST
+FTEST = FTEST
+GAMMADIST = GAMMADIST
+GAMMAINV = GAMMAINV
+HYPGEOMDIST = HYPGEOMDIST
+LOGINV = LOGINV
+LOGNORMDIST = LOGNORMDIST
+MODE = MODE
+NEGBINOMDIST = NEGBINOMDIST
+NORMDIST = NORMDIST
+NORMINV = NORMINV
+NORMSDIST = NORMSDIST
+NORMSINV = NORMSINV
+PERCENTILE = PERCENTIL
+PERCENTRANK = PERCENTRANK
+POISSON = POISSON
+QUARTILE = QUARTIL
+RANK = RANK
+STDEV = SMODCH.VÝBĚR
+STDEVP = SMODCH
+TDIST = TDIST
+TINV = TINV
+TTEST = TTEST
+VAR = VAR.VÝBĚR
+VARP = VAR
+WEIBULL = WEIBULL
+ZTEST = ZTEST
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/da/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/da/config
new file mode 100644
index 00000000..284b2490
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/da/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Dansk (Danish)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL = #NUL!
+DIV0
+VALUE = #VÆRDI!
+REF = #REFERENCE!
+NAME = #NAVN?
+NUM
+NA = #I/T
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/da/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/da/functions
new file mode 100644
index 00000000..03b68c9b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/da/functions
@@ -0,0 +1,538 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Dansk (Danish)
+##
+############################################################
+
+
+##
+## Kubefunktioner (Cube Functions)
+##
+CUBEKPIMEMBER = KUBE.KPI.MEDLEM
+CUBEMEMBER = KUBEMEDLEM
+CUBEMEMBERPROPERTY = KUBEMEDLEM.EGENSKAB
+CUBERANKEDMEMBER = KUBERANGERET.MEDLEM
+CUBESET = KUBESÆT
+CUBESETCOUNT = KUBESÆT.ANTAL
+CUBEVALUE = KUBEVÆRDI
+
+##
+## Databasefunktioner (Database Functions)
+##
+DAVERAGE = DMIDDEL
+DCOUNT = DTÆL
+DCOUNTA = DTÆLV
+DGET = DHENT
+DMAX = DMAKS
+DMIN = DMIN
+DPRODUCT = DPRODUKT
+DSTDEV = DSTDAFV
+DSTDEVP = DSTDAFVP
+DSUM = DSUM
+DVAR = DVARIANS
+DVARP = DVARIANSP
+
+##
+## Dato- og klokkeslætfunktioner (Date & Time Functions)
+##
+DATE = DATO
+DATEDIF = DATO.FORSKEL
+DATESTRING = DATOSTRENG
+DATEVALUE = DATOVÆRDI
+DAY = DAG
+DAYS = DAGE
+DAYS360 = DAGE360
+EDATE = EDATO
+EOMONTH = SLUT.PÅ.MÅNED
+HOUR = TIME
+ISOWEEKNUM = ISOUGE.NR
+MINUTE = MINUT
+MONTH = MÅNED
+NETWORKDAYS = ANTAL.ARBEJDSDAGE
+NETWORKDAYS.INTL = ANTAL.ARBEJDSDAGE.INTL
+NOW = NU
+SECOND = SEKUND
+THAIDAYOFWEEK = THAILANDSKUGEDAG
+THAIMONTHOFYEAR = THAILANDSKMÅNED
+THAIYEAR = THAILANDSKÅR
+TIME = TID
+TIMEVALUE = TIDSVÆRDI
+TODAY = IDAG
+WEEKDAY = UGEDAG
+WEEKNUM = UGE.NR
+WORKDAY = ARBEJDSDAG
+WORKDAY.INTL = ARBEJDSDAG.INTL
+YEAR = ÅR
+YEARFRAC = ÅR.BRØK
+
+##
+## Tekniske funktioner (Engineering Functions)
+##
+BESSELI = BESSELI
+BESSELJ = BESSELJ
+BESSELK = BESSELK
+BESSELY = BESSELY
+BIN2DEC = BIN.TIL.DEC
+BIN2HEX = BIN.TIL.HEX
+BIN2OCT = BIN.TIL.OKT
+BITAND = BITOG
+BITLSHIFT = BITLSKIFT
+BITOR = BITELLER
+BITRSHIFT = BITRSKIFT
+BITXOR = BITXELLER
+COMPLEX = KOMPLEKS
+CONVERT = KONVERTER
+DEC2BIN = DEC.TIL.BIN
+DEC2HEX = DEC.TIL.HEX
+DEC2OCT = DEC.TIL.OKT
+DELTA = DELTA
+ERF = FEJLFUNK
+ERF.PRECISE = ERF.PRECISE
+ERFC = FEJLFUNK.KOMP
+ERFC.PRECISE = ERFC.PRECISE
+GESTEP = GETRIN
+HEX2BIN = HEX.TIL.BIN
+HEX2DEC = HEX.TIL.DEC
+HEX2OCT = HEX.TIL.OKT
+IMABS = IMAGABS
+IMAGINARY = IMAGINÆR
+IMARGUMENT = IMAGARGUMENT
+IMCONJUGATE = IMAGKONJUGERE
+IMCOS = IMAGCOS
+IMCOSH = IMAGCOSH
+IMCOT = IMAGCOT
+IMCSC = IMAGCSC
+IMCSCH = IMAGCSCH
+IMDIV = IMAGDIV
+IMEXP = IMAGEKSP
+IMLN = IMAGLN
+IMLOG10 = IMAGLOG10
+IMLOG2 = IMAGLOG2
+IMPOWER = IMAGPOTENS
+IMPRODUCT = IMAGPRODUKT
+IMREAL = IMAGREELT
+IMSEC = IMAGSEC
+IMSECH = IMAGSECH
+IMSIN = IMAGSIN
+IMSINH = IMAGSINH
+IMSQRT = IMAGKVROD
+IMSUB = IMAGSUB
+IMSUM = IMAGSUM
+IMTAN = IMAGTAN
+OCT2BIN = OKT.TIL.BIN
+OCT2DEC = OKT.TIL.DEC
+OCT2HEX = OKT.TIL.HEX
+
+##
+## Finansielle funktioner (Financial Functions)
+##
+ACCRINT = PÅLØBRENTE
+ACCRINTM = PÅLØBRENTE.UDLØB
+AMORDEGRC = AMORDEGRC
+AMORLINC = AMORLINC
+COUPDAYBS = KUPONDAGE.SA
+COUPDAYS = KUPONDAGE.A
+COUPDAYSNC = KUPONDAGE.ANK
+COUPNCD = KUPONDAG.NÆSTE
+COUPNUM = KUPONBETALINGER
+COUPPCD = KUPONDAG.FORRIGE
+CUMIPMT = AKKUM.RENTE
+CUMPRINC = AKKUM.HOVEDSTOL
+DB = DB
+DDB = DSA
+DISC = DISKONTO
+DOLLARDE = KR.DECIMAL
+DOLLARFR = KR.BRØK
+DURATION = VARIGHED
+EFFECT = EFFEKTIV.RENTE
+FV = FV
+FVSCHEDULE = FVTABEL
+INTRATE = RENTEFOD
+IPMT = R.YDELSE
+IRR = IA
+ISPMT = ISPMT
+MDURATION = MVARIGHED
+MIRR = MIA
+NOMINAL = NOMINEL
+NPER = NPER
+NPV = NUTIDSVÆRDI
+ODDFPRICE = ULIGE.KURS.PÅLYDENDE
+ODDFYIELD = ULIGE.FØRSTE.AFKAST
+ODDLPRICE = ULIGE.SIDSTE.KURS
+ODDLYIELD = ULIGE.SIDSTE.AFKAST
+PDURATION = PVARIGHED
+PMT = YDELSE
+PPMT = H.YDELSE
+PRICE = KURS
+PRICEDISC = KURS.DISKONTO
+PRICEMAT = KURS.UDLØB
+PV = NV
+RATE = RENTE
+RECEIVED = MODTAGET.VED.UDLØB
+RRI = RRI
+SLN = LA
+SYD = ÅRSAFSKRIVNING
+TBILLEQ = STATSOBLIGATION
+TBILLPRICE = STATSOBLIGATION.KURS
+TBILLYIELD = STATSOBLIGATION.AFKAST
+VDB = VSA
+XIRR = INTERN.RENTE
+XNPV = NETTO.NUTIDSVÆRDI
+YIELD = AFKAST
+YIELDDISC = AFKAST.DISKONTO
+YIELDMAT = AFKAST.UDLØBSDATO
+
+##
+## Informationsfunktioner (Information Functions)
+##
+CELL = CELLE
+ERROR.TYPE = FEJLTYPE
+INFO = INFO
+ISBLANK = ER.TOM
+ISERR = ER.FJL
+ISERROR = ER.FEJL
+ISEVEN = ER.LIGE
+ISFORMULA = ER.FORMEL
+ISLOGICAL = ER.LOGISK
+ISNA = ER.IKKE.TILGÆNGELIG
+ISNONTEXT = ER.IKKE.TEKST
+ISNUMBER = ER.TAL
+ISODD = ER.ULIGE
+ISREF = ER.REFERENCE
+ISTEXT = ER.TEKST
+N = TAL
+NA = IKKE.TILGÆNGELIG
+SHEET = ARK
+SHEETS = ARK.FLERE
+TYPE = VÆRDITYPE
+
+##
+## Logiske funktioner (Logical Functions)
+##
+AND = OG
+FALSE = FALSK
+IF = HVIS
+IFERROR = HVIS.FEJL
+IFNA = HVISIT
+IFS = HVISER
+NOT = IKKE
+OR = ELLER
+SWITCH = SKIFT
+TRUE = SAND
+XOR = XELLER
+
+##
+## Opslags- og referencefunktioner (Lookup & Reference Functions)
+##
+ADDRESS = ADRESSE
+AREAS = OMRÅDER
+CHOOSE = VÆLG
+COLUMN = KOLONNE
+COLUMNS = KOLONNER
+FORMULATEXT = FORMELTEKST
+GETPIVOTDATA = GETPIVOTDATA
+HLOOKUP = VOPSLAG
+HYPERLINK = HYPERLINK
+INDEX = INDEKS
+INDIRECT = INDIREKTE
+LOOKUP = SLÅ.OP
+MATCH = SAMMENLIGN
+OFFSET = FORSKYDNING
+ROW = RÆKKE
+ROWS = RÆKKER
+RTD = RTD
+TRANSPOSE = TRANSPONER
+VLOOKUP = LOPSLAG
+*RC = RK
+
+##
+## Matematiske og trigonometriske funktioner (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = ARCCOS
+ACOSH = ARCCOSH
+ACOT = ARCCOT
+ACOTH = ARCCOTH
+AGGREGATE = SAMLING
+ARABIC = ARABISK
+ASIN = ARCSIN
+ASINH = ARCSINH
+ATAN = ARCTAN
+ATAN2 = ARCTAN2
+ATANH = ARCTANH
+BASE = BASIS
+CEILING.MATH = LOFT.MAT
+CEILING.PRECISE = LOFT.PRECISE
+COMBIN = KOMBIN
+COMBINA = KOMBINA
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = CSC
+CSCH = CSCH
+DECIMAL = DECIMAL
+DEGREES = GRADER
+ECMA.CEILING = ECMA.LOFT
+EVEN = LIGE
+EXP = EKSP
+FACT = FAKULTET
+FACTDOUBLE = DOBBELT.FAKULTET
+FLOOR.MATH = AFRUND.BUND.MAT
+FLOOR.PRECISE = AFRUND.GULV.PRECISE
+GCD = STØRSTE.FÆLLES.DIVISOR
+INT = HELTAL
+ISO.CEILING = ISO.LOFT
+LCM = MINDSTE.FÆLLES.MULTIPLUM
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = MDETERM
+MINVERSE = MINVERT
+MMULT = MPRODUKT
+MOD = REST
+MROUND = MAFRUND
+MULTINOMIAL = MULTINOMIAL
+MUNIT = MENHED
+ODD = ULIGE
+PI = PI
+POWER = POTENS
+PRODUCT = PRODUKT
+QUOTIENT = KVOTIENT
+RADIANS = RADIANER
+RAND = SLUMP
+RANDBETWEEN = SLUMPMELLEM
+ROMAN = ROMERTAL
+ROUND = AFRUND
+ROUNDBAHTDOWN = RUNDBAHTNED
+ROUNDBAHTUP = RUNDBAHTOP
+ROUNDDOWN = RUND.NED
+ROUNDUP = RUND.OP
+SEC = SEC
+SECH = SECH
+SERIESSUM = SERIESUM
+SIGN = FORTEGN
+SIN = SIN
+SINH = SINH
+SQRT = KVROD
+SQRTPI = KVRODPI
+SUBTOTAL = SUBTOTAL
+SUM = SUM
+SUMIF = SUM.HVIS
+SUMIFS = SUM.HVISER
+SUMPRODUCT = SUMPRODUKT
+SUMSQ = SUMKV
+SUMX2MY2 = SUMX2MY2
+SUMX2PY2 = SUMX2PY2
+SUMXMY2 = SUMXMY2
+TAN = TAN
+TANH = TANH
+TRUNC = AFKORT
+
+##
+## Statistiske funktioner (Statistical Functions)
+##
+AVEDEV = MAD
+AVERAGE = MIDDEL
+AVERAGEA = MIDDELV
+AVERAGEIF = MIDDEL.HVIS
+AVERAGEIFS = MIDDEL.HVISER
+BETA.DIST = BETA.FORDELING
+BETA.INV = BETA.INV
+BINOM.DIST = BINOMIAL.FORDELING
+BINOM.DIST.RANGE = BINOMIAL.DIST.INTERVAL
+BINOM.INV = BINOMIAL.INV
+CHISQ.DIST = CHI2.FORDELING
+CHISQ.DIST.RT = CHI2.FORD.RT
+CHISQ.INV = CHI2.INV
+CHISQ.INV.RT = CHI2.INV.RT
+CHISQ.TEST = CHI2.TEST
+CONFIDENCE.NORM = KONFIDENS.NORM
+CONFIDENCE.T = KONFIDENST
+CORREL = KORRELATION
+COUNT = TÆL
+COUNTA = TÆLV
+COUNTBLANK = ANTAL.BLANKE
+COUNTIF = TÆL.HVIS
+COUNTIFS = TÆL.HVISER
+COVARIANCE.P = KOVARIANS.P
+COVARIANCE.S = KOVARIANS.S
+DEVSQ = SAK
+EXPON.DIST = EKSP.FORDELING
+F.DIST = F.FORDELING
+F.DIST.RT = F.FORDELING.RT
+F.INV = F.INV
+F.INV.RT = F.INV.RT
+F.TEST = F.TEST
+FISHER = FISHER
+FISHERINV = FISHERINV
+FORECAST.ETS = PROGNOSE.ETS
+FORECAST.ETS.CONFINT = PROGNOSE.ETS.CONFINT
+FORECAST.ETS.SEASONALITY = PROGNOSE.ETS.SÆSONUDSVING
+FORECAST.ETS.STAT = PROGNOSE.ETS.STAT
+FORECAST.LINEAR = PROGNOSE.LINEÆR
+FREQUENCY = FREKVENS
+GAMMA = GAMMA
+GAMMA.DIST = GAMMA.FORDELING
+GAMMA.INV = GAMMA.INV
+GAMMALN = GAMMALN
+GAMMALN.PRECISE = GAMMALN.PRECISE
+GAUSS = GAUSS
+GEOMEAN = GEOMIDDELVÆRDI
+GROWTH = FORØGELSE
+HARMEAN = HARMIDDELVÆRDI
+HYPGEOM.DIST = HYPGEO.FORDELING
+INTERCEPT = SKÆRING
+KURT = TOPSTEJL
+LARGE = STØRSTE
+LINEST = LINREGR
+LOGEST = LOGREGR
+LOGNORM.DIST = LOGNORM.FORDELING
+LOGNORM.INV = LOGNORM.INV
+MAX = MAKS
+MAXA = MAKSV
+MAXIFS = MAKSHVISER
+MEDIAN = MEDIAN
+MIN = MIN
+MINA = MINV
+MINIFS = MINHVISER
+MODE.MULT = HYPPIGST.FLERE
+MODE.SNGL = HYPPIGST.ENKELT
+NEGBINOM.DIST = NEGBINOM.FORDELING
+NORM.DIST = NORMAL.FORDELING
+NORM.INV = NORM.INV
+NORM.S.DIST = STANDARD.NORM.FORDELING
+NORM.S.INV = STANDARD.NORM.INV
+PEARSON = PEARSON
+PERCENTILE.EXC = FRAKTIL.UDELAD
+PERCENTILE.INC = FRAKTIL.MEDTAG
+PERCENTRANK.EXC = PROCENTPLADS.UDELAD
+PERCENTRANK.INC = PROCENTPLADS.MEDTAG
+PERMUT = PERMUT
+PERMUTATIONA = PERMUTATIONA
+PHI = PHI
+POISSON.DIST = POISSON.FORDELING
+PROB = SANDSYNLIGHED
+QUARTILE.EXC = KVARTIL.UDELAD
+QUARTILE.INC = KVARTIL.MEDTAG
+RANK.AVG = PLADS.GNSN
+RANK.EQ = PLADS.LIGE
+RSQ = FORKLARINGSGRAD
+SKEW = SKÆVHED
+SKEW.P = SKÆVHED.P
+SLOPE = STIGNING
+SMALL = MINDSTE
+STANDARDIZE = STANDARDISER
+STDEV.P = STDAFV.P
+STDEV.S = STDAFV.S
+STDEVA = STDAFVV
+STDEVPA = STDAFVPV
+STEYX = STFYX
+T.DIST = T.FORDELING
+T.DIST.2T = T.FORDELING.2T
+T.DIST.RT = T.FORDELING.RT
+T.INV = T.INV
+T.INV.2T = T.INV.2T
+T.TEST = T.TEST
+TREND = TENDENS
+TRIMMEAN = TRIMMIDDELVÆRDI
+VAR.P = VARIANS.P
+VAR.S = VARIANS.S
+VARA = VARIANSV
+VARPA = VARIANSPV
+WEIBULL.DIST = WEIBULL.FORDELING
+Z.TEST = Z.TEST
+
+##
+## Tekstfunktioner (Text Functions)
+##
+BAHTTEXT = BAHTTEKST
+CHAR = TEGN
+CLEAN = RENS
+CODE = KODE
+CONCAT = CONCAT
+DOLLAR = KR
+EXACT = EKSAKT
+FIND = FIND
+FIXED = FAST
+ISTHAIDIGIT = ERTHAILANDSKCIFFER
+LEFT = VENSTRE
+LEN = LÆNGDE
+LOWER = SMÅ.BOGSTAVER
+MID = MIDT
+NUMBERSTRING = TALSTRENG
+NUMBERVALUE = TALVÆRDI
+PHONETIC = FONETISK
+PROPER = STORT.FORBOGSTAV
+REPLACE = ERSTAT
+REPT = GENTAG
+RIGHT = HØJRE
+SEARCH = SØG
+SUBSTITUTE = UDSKIFT
+T = T
+TEXT = TEKST
+TEXTJOIN = TEKST.KOMBINER
+THAIDIGIT = THAILANDSKCIFFER
+THAINUMSOUND = THAILANDSKNUMLYD
+THAINUMSTRING = THAILANDSKNUMSTRENG
+THAISTRINGLENGTH = THAILANDSKSTRENGLÆNGDE
+TRIM = FJERN.OVERFLØDIGE.BLANKE
+UNICHAR = UNICHAR
+UNICODE = UNICODE
+UPPER = STORE.BOGSTAVER
+VALUE = VÆRDI
+
+##
+## Webfunktioner (Web Functions)
+##
+ENCODEURL = KODNINGSURL
+FILTERXML = FILTRERXML
+WEBSERVICE = WEBTJENESTE
+
+##
+## Kompatibilitetsfunktioner (Compatibility Functions)
+##
+BETADIST = BETAFORDELING
+BETAINV = BETAINV
+BINOMDIST = BINOMIALFORDELING
+CEILING = AFRUND.LOFT
+CHIDIST = CHIFORDELING
+CHIINV = CHIINV
+CHITEST = CHITEST
+CONCATENATE = SAMMENKÆDNING
+CONFIDENCE = KONFIDENSINTERVAL
+COVAR = KOVARIANS
+CRITBINOM = KRITBINOM
+EXPONDIST = EKSPFORDELING
+FDIST = FFORDELING
+FINV = FINV
+FLOOR = AFRUND.GULV
+FORECAST = PROGNOSE
+FTEST = FTEST
+GAMMADIST = GAMMAFORDELING
+GAMMAINV = GAMMAINV
+HYPGEOMDIST = HYPGEOFORDELING
+LOGINV = LOGINV
+LOGNORMDIST = LOGNORMFORDELING
+MODE = HYPPIGST
+NEGBINOMDIST = NEGBINOMFORDELING
+NORMDIST = NORMFORDELING
+NORMINV = NORMINV
+NORMSDIST = STANDARDNORMFORDELING
+NORMSINV = STANDARDNORMINV
+PERCENTILE = FRAKTIL
+PERCENTRANK = PROCENTPLADS
+POISSON = POISSON
+QUARTILE = KVARTIL
+RANK = PLADS
+STDEV = STDAFV
+STDEVP = STDAFVP
+TDIST = TFORDELING
+TINV = TINV
+TTEST = TTEST
+VAR = VARIANS
+VARP = VARIANSP
+WEIBULL = WEIBULL
+ZTEST = ZTEST
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/de/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/de/config
new file mode 100644
index 00000000..4ca2b82b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/de/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Deutsch (German)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL
+DIV0
+VALUE = #WERT!
+REF = #BEZUG!
+NAME
+NUM = #ZAHL!
+NA = #NV
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/de/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/de/functions
new file mode 100644
index 00000000..d49fc5f1
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/de/functions
@@ -0,0 +1,534 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Deutsch (German)
+##
+############################################################
+
+
+##
+## Cubefunktionen (Cube Functions)
+##
+CUBEKPIMEMBER = CUBEKPIELEMENT
+CUBEMEMBER = CUBEELEMENT
+CUBEMEMBERPROPERTY = CUBEELEMENTEIGENSCHAFT
+CUBERANKEDMEMBER = CUBERANGELEMENT
+CUBESET = CUBEMENGE
+CUBESETCOUNT = CUBEMENGENANZAHL
+CUBEVALUE = CUBEWERT
+
+##
+## Datenbankfunktionen (Database Functions)
+##
+DAVERAGE = DBMITTELWERT
+DCOUNT = DBANZAHL
+DCOUNTA = DBANZAHL2
+DGET = DBAUSZUG
+DMAX = DBMAX
+DMIN = DBMIN
+DPRODUCT = DBPRODUKT
+DSTDEV = DBSTDABW
+DSTDEVP = DBSTDABWN
+DSUM = DBSUMME
+DVAR = DBVARIANZ
+DVARP = DBVARIANZEN
+
+##
+## Datums- und Uhrzeitfunktionen (Date & Time Functions)
+##
+DATE = DATUM
+DATEVALUE = DATWERT
+DAY = TAG
+DAYS = TAGE
+DAYS360 = TAGE360
+EDATE = EDATUM
+EOMONTH = MONATSENDE
+HOUR = STUNDE
+ISOWEEKNUM = ISOKALENDERWOCHE
+MINUTE = MINUTE
+MONTH = MONAT
+NETWORKDAYS = NETTOARBEITSTAGE
+NETWORKDAYS.INTL = NETTOARBEITSTAGE.INTL
+NOW = JETZT
+SECOND = SEKUNDE
+THAIDAYOFWEEK = THAIWOCHENTAG
+THAIMONTHOFYEAR = THAIMONATDESJAHRES
+THAIYEAR = THAIJAHR
+TIME = ZEIT
+TIMEVALUE = ZEITWERT
+TODAY = HEUTE
+WEEKDAY = WOCHENTAG
+WEEKNUM = KALENDERWOCHE
+WORKDAY = ARBEITSTAG
+WORKDAY.INTL = ARBEITSTAG.INTL
+YEAR = JAHR
+YEARFRAC = BRTEILJAHRE
+
+##
+## Technische Funktionen (Engineering Functions)
+##
+BESSELI = BESSELI
+BESSELJ = BESSELJ
+BESSELK = BESSELK
+BESSELY = BESSELY
+BIN2DEC = BININDEZ
+BIN2HEX = BININHEX
+BIN2OCT = BININOKT
+BITAND = BITUND
+BITLSHIFT = BITLVERSCHIEB
+BITOR = BITODER
+BITRSHIFT = BITRVERSCHIEB
+BITXOR = BITXODER
+COMPLEX = KOMPLEXE
+CONVERT = UMWANDELN
+DEC2BIN = DEZINBIN
+DEC2HEX = DEZINHEX
+DEC2OCT = DEZINOKT
+DELTA = DELTA
+ERF = GAUSSFEHLER
+ERF.PRECISE = GAUSSF.GENAU
+ERFC = GAUSSFKOMPL
+ERFC.PRECISE = GAUSSFKOMPL.GENAU
+GESTEP = GGANZZAHL
+HEX2BIN = HEXINBIN
+HEX2DEC = HEXINDEZ
+HEX2OCT = HEXINOKT
+IMABS = IMABS
+IMAGINARY = IMAGINÄRTEIL
+IMARGUMENT = IMARGUMENT
+IMCONJUGATE = IMKONJUGIERTE
+IMCOS = IMCOS
+IMCOSH = IMCOSHYP
+IMCOT = IMCOT
+IMCSC = IMCOSEC
+IMCSCH = IMCOSECHYP
+IMDIV = IMDIV
+IMEXP = IMEXP
+IMLN = IMLN
+IMLOG10 = IMLOG10
+IMLOG2 = IMLOG2
+IMPOWER = IMAPOTENZ
+IMPRODUCT = IMPRODUKT
+IMREAL = IMREALTEIL
+IMSEC = IMSEC
+IMSECH = IMSECHYP
+IMSIN = IMSIN
+IMSINH = IMSINHYP
+IMSQRT = IMWURZEL
+IMSUB = IMSUB
+IMSUM = IMSUMME
+IMTAN = IMTAN
+OCT2BIN = OKTINBIN
+OCT2DEC = OKTINDEZ
+OCT2HEX = OKTINHEX
+
+##
+## Finanzmathematische Funktionen (Financial Functions)
+##
+ACCRINT = AUFGELZINS
+ACCRINTM = AUFGELZINSF
+AMORDEGRC = AMORDEGRK
+AMORLINC = AMORLINEARK
+COUPDAYBS = ZINSTERMTAGVA
+COUPDAYS = ZINSTERMTAGE
+COUPDAYSNC = ZINSTERMTAGNZ
+COUPNCD = ZINSTERMNZ
+COUPNUM = ZINSTERMZAHL
+COUPPCD = ZINSTERMVZ
+CUMIPMT = KUMZINSZ
+CUMPRINC = KUMKAPITAL
+DB = GDA2
+DDB = GDA
+DISC = DISAGIO
+DOLLARDE = NOTIERUNGDEZ
+DOLLARFR = NOTIERUNGBRU
+DURATION = DURATION
+EFFECT = EFFEKTIV
+FV = ZW
+FVSCHEDULE = ZW2
+INTRATE = ZINSSATZ
+IPMT = ZINSZ
+IRR = IKV
+ISPMT = ISPMT
+MDURATION = MDURATION
+MIRR = QIKV
+NOMINAL = NOMINAL
+NPER = ZZR
+NPV = NBW
+ODDFPRICE = UNREGER.KURS
+ODDFYIELD = UNREGER.REND
+ODDLPRICE = UNREGLE.KURS
+ODDLYIELD = UNREGLE.REND
+PDURATION = PDURATION
+PMT = RMZ
+PPMT = KAPZ
+PRICE = KURS
+PRICEDISC = KURSDISAGIO
+PRICEMAT = KURSFÄLLIG
+PV = BW
+RATE = ZINS
+RECEIVED = AUSZAHLUNG
+RRI = ZSATZINVEST
+SLN = LIA
+SYD = DIA
+TBILLEQ = TBILLÄQUIV
+TBILLPRICE = TBILLKURS
+TBILLYIELD = TBILLRENDITE
+VDB = VDB
+XIRR = XINTZINSFUSS
+XNPV = XKAPITALWERT
+YIELD = RENDITE
+YIELDDISC = RENDITEDIS
+YIELDMAT = RENDITEFÄLL
+
+##
+## Informationsfunktionen (Information Functions)
+##
+CELL = ZELLE
+ERROR.TYPE = FEHLER.TYP
+INFO = INFO
+ISBLANK = ISTLEER
+ISERR = ISTFEHL
+ISERROR = ISTFEHLER
+ISEVEN = ISTGERADE
+ISFORMULA = ISTFORMEL
+ISLOGICAL = ISTLOG
+ISNA = ISTNV
+ISNONTEXT = ISTKTEXT
+ISNUMBER = ISTZAHL
+ISODD = ISTUNGERADE
+ISREF = ISTBEZUG
+ISTEXT = ISTTEXT
+N = N
+NA = NV
+SHEET = BLATT
+SHEETS = BLÄTTER
+TYPE = TYP
+
+##
+## Logische Funktionen (Logical Functions)
+##
+AND = UND
+FALSE = FALSCH
+IF = WENN
+IFERROR = WENNFEHLER
+IFNA = WENNNV
+IFS = WENNS
+NOT = NICHT
+OR = ODER
+SWITCH = ERSTERWERT
+TRUE = WAHR
+XOR = XODER
+
+##
+## Nachschlage- und Verweisfunktionen (Lookup & Reference Functions)
+##
+ADDRESS = ADRESSE
+AREAS = BEREICHE
+CHOOSE = WAHL
+COLUMN = SPALTE
+COLUMNS = SPALTEN
+FORMULATEXT = FORMELTEXT
+GETPIVOTDATA = PIVOTDATENZUORDNEN
+HLOOKUP = WVERWEIS
+HYPERLINK = HYPERLINK
+INDEX = INDEX
+INDIRECT = INDIREKT
+LOOKUP = VERWEIS
+MATCH = VERGLEICH
+OFFSET = BEREICH.VERSCHIEBEN
+ROW = ZEILE
+ROWS = ZEILEN
+RTD = RTD
+TRANSPOSE = MTRANS
+VLOOKUP = SVERWEIS
+*RC = ZS
+
+##
+## Mathematische und trigonometrische Funktionen (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = ARCCOS
+ACOSH = ARCCOSHYP
+ACOT = ARCCOT
+ACOTH = ARCCOTHYP
+AGGREGATE = AGGREGAT
+ARABIC = ARABISCH
+ASIN = ARCSIN
+ASINH = ARCSINHYP
+ATAN = ARCTAN
+ATAN2 = ARCTAN2
+ATANH = ARCTANHYP
+BASE = BASIS
+CEILING.MATH = OBERGRENZE.MATHEMATIK
+CEILING.PRECISE = OBERGRENZE.GENAU
+COMBIN = KOMBINATIONEN
+COMBINA = KOMBINATIONEN2
+COS = COS
+COSH = COSHYP
+COT = COT
+COTH = COTHYP
+CSC = COSEC
+CSCH = COSECHYP
+DECIMAL = DEZIMAL
+DEGREES = GRAD
+ECMA.CEILING = ECMA.OBERGRENZE
+EVEN = GERADE
+EXP = EXP
+FACT = FAKULTÄT
+FACTDOUBLE = ZWEIFAKULTÄT
+FLOOR.MATH = UNTERGRENZE.MATHEMATIK
+FLOOR.PRECISE = UNTERGRENZE.GENAU
+GCD = GGT
+INT = GANZZAHL
+ISO.CEILING = ISO.OBERGRENZE
+LCM = KGV
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = MDET
+MINVERSE = MINV
+MMULT = MMULT
+MOD = REST
+MROUND = VRUNDEN
+MULTINOMIAL = POLYNOMIAL
+MUNIT = MEINHEIT
+ODD = UNGERADE
+PI = PI
+POWER = POTENZ
+PRODUCT = PRODUKT
+QUOTIENT = QUOTIENT
+RADIANS = BOGENMASS
+RAND = ZUFALLSZAHL
+RANDBETWEEN = ZUFALLSBEREICH
+ROMAN = RÖMISCH
+ROUND = RUNDEN
+ROUNDBAHTDOWN = RUNDBAHTNED
+ROUNDBAHTUP = BAHTAUFRUNDEN
+ROUNDDOWN = ABRUNDEN
+ROUNDUP = AUFRUNDEN
+SEC = SEC
+SECH = SECHYP
+SERIESSUM = POTENZREIHE
+SIGN = VORZEICHEN
+SIN = SIN
+SINH = SINHYP
+SQRT = WURZEL
+SQRTPI = WURZELPI
+SUBTOTAL = TEILERGEBNIS
+SUM = SUMME
+SUMIF = SUMMEWENN
+SUMIFS = SUMMEWENNS
+SUMPRODUCT = SUMMENPRODUKT
+SUMSQ = QUADRATESUMME
+SUMX2MY2 = SUMMEX2MY2
+SUMX2PY2 = SUMMEX2PY2
+SUMXMY2 = SUMMEXMY2
+TAN = TAN
+TANH = TANHYP
+TRUNC = KÜRZEN
+
+##
+## Statistische Funktionen (Statistical Functions)
+##
+AVEDEV = MITTELABW
+AVERAGE = MITTELWERT
+AVERAGEA = MITTELWERTA
+AVERAGEIF = MITTELWERTWENN
+AVERAGEIFS = MITTELWERTWENNS
+BETA.DIST = BETA.VERT
+BETA.INV = BETA.INV
+BINOM.DIST = BINOM.VERT
+BINOM.DIST.RANGE = BINOM.VERT.BEREICH
+BINOM.INV = BINOM.INV
+CHISQ.DIST = CHIQU.VERT
+CHISQ.DIST.RT = CHIQU.VERT.RE
+CHISQ.INV = CHIQU.INV
+CHISQ.INV.RT = CHIQU.INV.RE
+CHISQ.TEST = CHIQU.TEST
+CONFIDENCE.NORM = KONFIDENZ.NORM
+CONFIDENCE.T = KONFIDENZ.T
+CORREL = KORREL
+COUNT = ANZAHL
+COUNTA = ANZAHL2
+COUNTBLANK = ANZAHLLEEREZELLEN
+COUNTIF = ZÄHLENWENN
+COUNTIFS = ZÄHLENWENNS
+COVARIANCE.P = KOVARIANZ.P
+COVARIANCE.S = KOVARIANZ.S
+DEVSQ = SUMQUADABW
+EXPON.DIST = EXPON.VERT
+F.DIST = F.VERT
+F.DIST.RT = F.VERT.RE
+F.INV = F.INV
+F.INV.RT = F.INV.RE
+F.TEST = F.TEST
+FISHER = FISHER
+FISHERINV = FISHERINV
+FORECAST.ETS = PROGNOSE.ETS
+FORECAST.ETS.CONFINT = PROGNOSE.ETS.KONFINT
+FORECAST.ETS.SEASONALITY = PROGNOSE.ETS.SAISONALITÄT
+FORECAST.ETS.STAT = PROGNOSE.ETS.STAT
+FORECAST.LINEAR = PROGNOSE.LINEAR
+FREQUENCY = HÄUFIGKEIT
+GAMMA = GAMMA
+GAMMA.DIST = GAMMA.VERT
+GAMMA.INV = GAMMA.INV
+GAMMALN = GAMMALN
+GAMMALN.PRECISE = GAMMALN.GENAU
+GAUSS = GAUSS
+GEOMEAN = GEOMITTEL
+GROWTH = VARIATION
+HARMEAN = HARMITTEL
+HYPGEOM.DIST = HYPGEOM.VERT
+INTERCEPT = ACHSENABSCHNITT
+KURT = KURT
+LARGE = KGRÖSSTE
+LINEST = RGP
+LOGEST = RKP
+LOGNORM.DIST = LOGNORM.VERT
+LOGNORM.INV = LOGNORM.INV
+MAX = MAX
+MAXA = MAXA
+MAXIFS = MAXWENNS
+MEDIAN = MEDIAN
+MIN = MIN
+MINA = MINA
+MINIFS = MINWENNS
+MODE.MULT = MODUS.VIELF
+MODE.SNGL = MODUS.EINF
+NEGBINOM.DIST = NEGBINOM.VERT
+NORM.DIST = NORM.VERT
+NORM.INV = NORM.INV
+NORM.S.DIST = NORM.S.VERT
+NORM.S.INV = NORM.S.INV
+PEARSON = PEARSON
+PERCENTILE.EXC = QUANTIL.EXKL
+PERCENTILE.INC = QUANTIL.INKL
+PERCENTRANK.EXC = QUANTILSRANG.EXKL
+PERCENTRANK.INC = QUANTILSRANG.INKL
+PERMUT = VARIATIONEN
+PERMUTATIONA = VARIATIONEN2
+PHI = PHI
+POISSON.DIST = POISSON.VERT
+PROB = WAHRSCHBEREICH
+QUARTILE.EXC = QUARTILE.EXKL
+QUARTILE.INC = QUARTILE.INKL
+RANK.AVG = RANG.MITTELW
+RANK.EQ = RANG.GLEICH
+RSQ = BESTIMMTHEITSMASS
+SKEW = SCHIEFE
+SKEW.P = SCHIEFE.P
+SLOPE = STEIGUNG
+SMALL = KKLEINSTE
+STANDARDIZE = STANDARDISIERUNG
+STDEV.P = STABW.N
+STDEV.S = STABW.S
+STDEVA = STABWA
+STDEVPA = STABWNA
+STEYX = STFEHLERYX
+T.DIST = T.VERT
+T.DIST.2T = T.VERT.2S
+T.DIST.RT = T.VERT.RE
+T.INV = T.INV
+T.INV.2T = T.INV.2S
+T.TEST = T.TEST
+TREND = TREND
+TRIMMEAN = GESTUTZTMITTEL
+VAR.P = VAR.P
+VAR.S = VAR.S
+VARA = VARIANZA
+VARPA = VARIANZENA
+WEIBULL.DIST = WEIBULL.VERT
+Z.TEST = G.TEST
+
+##
+## Textfunktionen (Text Functions)
+##
+BAHTTEXT = BAHTTEXT
+CHAR = ZEICHEN
+CLEAN = SÄUBERN
+CODE = CODE
+CONCAT = TEXTKETTE
+DOLLAR = DM
+EXACT = IDENTISCH
+FIND = FINDEN
+FIXED = FEST
+ISTHAIDIGIT = ISTTHAIZAHLENWORT
+LEFT = LINKS
+LEN = LÄNGE
+LOWER = KLEIN
+MID = TEIL
+NUMBERVALUE = ZAHLENWERT
+PROPER = GROSS2
+REPLACE = ERSETZEN
+REPT = WIEDERHOLEN
+RIGHT = RECHTS
+SEARCH = SUCHEN
+SUBSTITUTE = WECHSELN
+T = T
+TEXT = TEXT
+TEXTJOIN = TEXTVERKETTEN
+THAIDIGIT = THAIZAHLENWORT
+THAINUMSOUND = THAIZAHLSOUND
+THAINUMSTRING = THAILANDSKNUMSTRENG
+THAISTRINGLENGTH = THAIZEICHENFOLGENLÄNGE
+TRIM = GLÄTTEN
+UNICHAR = UNIZEICHEN
+UNICODE = UNICODE
+UPPER = GROSS
+VALUE = WERT
+
+##
+## Webfunktionen (Web Functions)
+##
+ENCODEURL = URLCODIEREN
+FILTERXML = XMLFILTERN
+WEBSERVICE = WEBDIENST
+
+##
+## Kompatibilitätsfunktionen (Compatibility Functions)
+##
+BETADIST = BETAVERT
+BETAINV = BETAINV
+BINOMDIST = BINOMVERT
+CEILING = OBERGRENZE
+CHIDIST = CHIVERT
+CHIINV = CHIINV
+CHITEST = CHITEST
+CONCATENATE = VERKETTEN
+CONFIDENCE = KONFIDENZ
+COVAR = KOVAR
+CRITBINOM = KRITBINOM
+EXPONDIST = EXPONVERT
+FDIST = FVERT
+FINV = FINV
+FLOOR = UNTERGRENZE
+FORECAST = SCHÄTZER
+FTEST = FTEST
+GAMMADIST = GAMMAVERT
+GAMMAINV = GAMMAINV
+HYPGEOMDIST = HYPGEOMVERT
+LOGINV = LOGINV
+LOGNORMDIST = LOGNORMVERT
+MODE = MODALWERT
+NEGBINOMDIST = NEGBINOMVERT
+NORMDIST = NORMVERT
+NORMINV = NORMINV
+NORMSDIST = STANDNORMVERT
+NORMSINV = STANDNORMINV
+PERCENTILE = QUANTIL
+PERCENTRANK = QUANTILSRANG
+POISSON = POISSON
+QUARTILE = QUARTILE
+RANK = RANG
+STDEV = STABW
+STDEVP = STABWN
+TDIST = TVERT
+TINV = TINV
+TTEST = TTEST
+VAR = VARIANZ
+VARP = VARIANZEN
+WEIBULL = WEIBULL
+ZTEST = GTEST
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/en/uk/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/en/uk/config
new file mode 100644
index 00000000..4e068ab0
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/en/uk/config
@@ -0,0 +1,24 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## English-UK (English-UK)
+##
+############################################################
+
+ArgumentSeparator = ,
+##
+## (For future use)
+##
+currencySymbol = £
+
+##
+## Error Codes
+##
+NULL
+DIV0
+VALUE
+REF
+NAME
+NUM
+NA
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/es/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/es/config
new file mode 100644
index 00000000..fe044efa
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/es/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Español (Spanish)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL = #¡NULO!
+DIV0 = #¡DIV/0!
+VALUE = #¡VALOR!
+REF = #¡REF!
+NAME = #¿NOMBRE?
+NUM = #¡NUM!
+NA
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/es/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/es/functions
new file mode 100644
index 00000000..88012aa1
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/es/functions
@@ -0,0 +1,538 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Español (Spanish)
+##
+############################################################
+
+
+##
+## Funciones de cubo (Cube Functions)
+##
+CUBEKPIMEMBER = MIEMBROKPICUBO
+CUBEMEMBER = MIEMBROCUBO
+CUBEMEMBERPROPERTY = PROPIEDADMIEMBROCUBO
+CUBERANKEDMEMBER = MIEMBRORANGOCUBO
+CUBESET = CONJUNTOCUBO
+CUBESETCOUNT = RECUENTOCONJUNTOCUBO
+CUBEVALUE = VALORCUBO
+
+##
+## Funciones de base de datos (Database Functions)
+##
+DAVERAGE = BDPROMEDIO
+DCOUNT = BDCONTAR
+DCOUNTA = BDCONTARA
+DGET = BDEXTRAER
+DMAX = BDMAX
+DMIN = BDMIN
+DPRODUCT = BDPRODUCTO
+DSTDEV = BDDESVEST
+DSTDEVP = BDDESVESTP
+DSUM = BDSUMA
+DVAR = BDVAR
+DVARP = BDVARP
+
+##
+## Funciones de fecha y hora (Date & Time Functions)
+##
+DATE = FECHA
+DATEDIF = SIFECHA
+DATESTRING = CADENA.FECHA
+DATEVALUE = FECHANUMERO
+DAY = DIA
+DAYS = DIAS
+DAYS360 = DIAS360
+EDATE = FECHA.MES
+EOMONTH = FIN.MES
+HOUR = HORA
+ISOWEEKNUM = ISO.NUM.DE.SEMANA
+MINUTE = MINUTO
+MONTH = MES
+NETWORKDAYS = DIAS.LAB
+NETWORKDAYS.INTL = DIAS.LAB.INTL
+NOW = AHORA
+SECOND = SEGUNDO
+THAIDAYOFWEEK = DIASEMTAI
+THAIMONTHOFYEAR = MESAÑOTAI
+THAIYEAR = AÑOTAI
+TIME = NSHORA
+TIMEVALUE = HORANUMERO
+TODAY = HOY
+WEEKDAY = DIASEM
+WEEKNUM = NUM.DE.SEMANA
+WORKDAY = DIA.LAB
+WORKDAY.INTL = DIA.LAB.INTL
+YEAR = AÑO
+YEARFRAC = FRAC.AÑO
+
+##
+## Funciones de ingeniería (Engineering Functions)
+##
+BESSELI = BESSELI
+BESSELJ = BESSELJ
+BESSELK = BESSELK
+BESSELY = BESSELY
+BIN2DEC = BIN.A.DEC
+BIN2HEX = BIN.A.HEX
+BIN2OCT = BIN.A.OCT
+BITAND = BIT.Y
+BITLSHIFT = BIT.DESPLIZQDA
+BITOR = BIT.O
+BITRSHIFT = BIT.DESPLDCHA
+BITXOR = BIT.XO
+COMPLEX = COMPLEJO
+CONVERT = CONVERTIR
+DEC2BIN = DEC.A.BIN
+DEC2HEX = DEC.A.HEX
+DEC2OCT = DEC.A.OCT
+DELTA = DELTA
+ERF = FUN.ERROR
+ERF.PRECISE = FUN.ERROR.EXACTO
+ERFC = FUN.ERROR.COMPL
+ERFC.PRECISE = FUN.ERROR.COMPL.EXACTO
+GESTEP = MAYOR.O.IGUAL
+HEX2BIN = HEX.A.BIN
+HEX2DEC = HEX.A.DEC
+HEX2OCT = HEX.A.OCT
+IMABS = IM.ABS
+IMAGINARY = IMAGINARIO
+IMARGUMENT = IM.ANGULO
+IMCONJUGATE = IM.CONJUGADA
+IMCOS = IM.COS
+IMCOSH = IM.COSH
+IMCOT = IM.COT
+IMCSC = IM.CSC
+IMCSCH = IM.CSCH
+IMDIV = IM.DIV
+IMEXP = IM.EXP
+IMLN = IM.LN
+IMLOG10 = IM.LOG10
+IMLOG2 = IM.LOG2
+IMPOWER = IM.POT
+IMPRODUCT = IM.PRODUCT
+IMREAL = IM.REAL
+IMSEC = IM.SEC
+IMSECH = IM.SECH
+IMSIN = IM.SENO
+IMSINH = IM.SENOH
+IMSQRT = IM.RAIZ2
+IMSUB = IM.SUSTR
+IMSUM = IM.SUM
+IMTAN = IM.TAN
+OCT2BIN = OCT.A.BIN
+OCT2DEC = OCT.A.DEC
+OCT2HEX = OCT.A.HEX
+
+##
+## Funciones financieras (Financial Functions)
+##
+ACCRINT = INT.ACUM
+ACCRINTM = INT.ACUM.V
+AMORDEGRC = AMORTIZ.PROGRE
+AMORLINC = AMORTIZ.LIN
+COUPDAYBS = CUPON.DIAS.L1
+COUPDAYS = CUPON.DIAS
+COUPDAYSNC = CUPON.DIAS.L2
+COUPNCD = CUPON.FECHA.L2
+COUPNUM = CUPON.NUM
+COUPPCD = CUPON.FECHA.L1
+CUMIPMT = PAGO.INT.ENTRE
+CUMPRINC = PAGO.PRINC.ENTRE
+DB = DB
+DDB = DDB
+DISC = TASA.DESC
+DOLLARDE = MONEDA.DEC
+DOLLARFR = MONEDA.FRAC
+DURATION = DURACION
+EFFECT = INT.EFECTIVO
+FV = VF
+FVSCHEDULE = VF.PLAN
+INTRATE = TASA.INT
+IPMT = PAGOINT
+IRR = TIR
+ISPMT = INT.PAGO.DIR
+MDURATION = DURACION.MODIF
+MIRR = TIRM
+NOMINAL = TASA.NOMINAL
+NPER = NPER
+NPV = VNA
+ODDFPRICE = PRECIO.PER.IRREGULAR.1
+ODDFYIELD = RENDTO.PER.IRREGULAR.1
+ODDLPRICE = PRECIO.PER.IRREGULAR.2
+ODDLYIELD = RENDTO.PER.IRREGULAR.2
+PDURATION = P.DURACION
+PMT = PAGO
+PPMT = PAGOPRIN
+PRICE = PRECIO
+PRICEDISC = PRECIO.DESCUENTO
+PRICEMAT = PRECIO.VENCIMIENTO
+PV = VA
+RATE = TASA
+RECEIVED = CANTIDAD.RECIBIDA
+RRI = RRI
+SLN = SLN
+SYD = SYD
+TBILLEQ = LETRA.DE.TEST.EQV.A.BONO
+TBILLPRICE = LETRA.DE.TES.PRECIO
+TBILLYIELD = LETRA.DE.TES.RENDTO
+VDB = DVS
+XIRR = TIR.NO.PER
+XNPV = VNA.NO.PER
+YIELD = RENDTO
+YIELDDISC = RENDTO.DESC
+YIELDMAT = RENDTO.VENCTO
+
+##
+## Funciones de información (Information Functions)
+##
+CELL = CELDA
+ERROR.TYPE = TIPO.DE.ERROR
+INFO = INFO
+ISBLANK = ESBLANCO
+ISERR = ESERR
+ISERROR = ESERROR
+ISEVEN = ES.PAR
+ISFORMULA = ESFORMULA
+ISLOGICAL = ESLOGICO
+ISNA = ESNOD
+ISNONTEXT = ESNOTEXTO
+ISNUMBER = ESNUMERO
+ISODD = ES.IMPAR
+ISREF = ESREF
+ISTEXT = ESTEXTO
+N = N
+NA = NOD
+SHEET = HOJA
+SHEETS = HOJAS
+TYPE = TIPO
+
+##
+## Funciones lógicas (Logical Functions)
+##
+AND = Y
+FALSE = FALSO
+IF = SI
+IFERROR = SI.ERROR
+IFNA = SI.ND
+IFS = SI.CONJUNTO
+NOT = NO
+OR = O
+SWITCH = CAMBIAR
+TRUE = VERDADERO
+XOR = XO
+
+##
+## Funciones de búsqueda y referencia (Lookup & Reference Functions)
+##
+ADDRESS = DIRECCION
+AREAS = AREAS
+CHOOSE = ELEGIR
+COLUMN = COLUMNA
+COLUMNS = COLUMNAS
+FORMULATEXT = FORMULATEXTO
+GETPIVOTDATA = IMPORTARDATOSDINAMICOS
+HLOOKUP = BUSCARH
+HYPERLINK = HIPERVINCULO
+INDEX = INDICE
+INDIRECT = INDIRECTO
+LOOKUP = BUSCAR
+MATCH = COINCIDIR
+OFFSET = DESREF
+ROW = FILA
+ROWS = FILAS
+RTD = RDTR
+TRANSPOSE = TRANSPONER
+VLOOKUP = BUSCARV
+*RC = FC
+
+##
+## Funciones matemáticas y trigonométricas (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = ACOS
+ACOSH = ACOSH
+ACOT = ACOT
+ACOTH = ACOTH
+AGGREGATE = AGREGAR
+ARABIC = NUMERO.ARABE
+ASIN = ASENO
+ASINH = ASENOH
+ATAN = ATAN
+ATAN2 = ATAN2
+ATANH = ATANH
+BASE = BASE
+CEILING.MATH = MULTIPLO.SUPERIOR.MAT
+CEILING.PRECISE = MULTIPLO.SUPERIOR.EXACTO
+COMBIN = COMBINAT
+COMBINA = COMBINA
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = CSC
+CSCH = CSCH
+DECIMAL = CONV.DECIMAL
+DEGREES = GRADOS
+ECMA.CEILING = MULTIPLO.SUPERIOR.ECMA
+EVEN = REDONDEA.PAR
+EXP = EXP
+FACT = FACT
+FACTDOUBLE = FACT.DOBLE
+FLOOR.MATH = MULTIPLO.INFERIOR.MAT
+FLOOR.PRECISE = MULTIPLO.INFERIOR.EXACTO
+GCD = M.C.D
+INT = ENTERO
+ISO.CEILING = MULTIPLO.SUPERIOR.ISO
+LCM = M.C.M
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = MDETERM
+MINVERSE = MINVERSA
+MMULT = MMULT
+MOD = RESIDUO
+MROUND = REDOND.MULT
+MULTINOMIAL = MULTINOMIAL
+MUNIT = M.UNIDAD
+ODD = REDONDEA.IMPAR
+PI = PI
+POWER = POTENCIA
+PRODUCT = PRODUCTO
+QUOTIENT = COCIENTE
+RADIANS = RADIANES
+RAND = ALEATORIO
+RANDBETWEEN = ALEATORIO.ENTRE
+ROMAN = NUMERO.ROMANO
+ROUND = REDONDEAR
+ROUNDBAHTDOWN = REDONDEAR.BAHT.MAS
+ROUNDBAHTUP = REDONDEAR.BAHT.MENOS
+ROUNDDOWN = REDONDEAR.MENOS
+ROUNDUP = REDONDEAR.MAS
+SEC = SEC
+SECH = SECH
+SERIESSUM = SUMA.SERIES
+SIGN = SIGNO
+SIN = SENO
+SINH = SENOH
+SQRT = RAIZ
+SQRTPI = RAIZ2PI
+SUBTOTAL = SUBTOTALES
+SUM = SUMA
+SUMIF = SUMAR.SI
+SUMIFS = SUMAR.SI.CONJUNTO
+SUMPRODUCT = SUMAPRODUCTO
+SUMSQ = SUMA.CUADRADOS
+SUMX2MY2 = SUMAX2MENOSY2
+SUMX2PY2 = SUMAX2MASY2
+SUMXMY2 = SUMAXMENOSY2
+TAN = TAN
+TANH = TANH
+TRUNC = TRUNCAR
+
+##
+## Funciones estadísticas (Statistical Functions)
+##
+AVEDEV = DESVPROM
+AVERAGE = PROMEDIO
+AVERAGEA = PROMEDIOA
+AVERAGEIF = PROMEDIO.SI
+AVERAGEIFS = PROMEDIO.SI.CONJUNTO
+BETA.DIST = DISTR.BETA.N
+BETA.INV = INV.BETA.N
+BINOM.DIST = DISTR.BINOM.N
+BINOM.DIST.RANGE = DISTR.BINOM.SERIE
+BINOM.INV = INV.BINOM
+CHISQ.DIST = DISTR.CHICUAD
+CHISQ.DIST.RT = DISTR.CHICUAD.CD
+CHISQ.INV = INV.CHICUAD
+CHISQ.INV.RT = INV.CHICUAD.CD
+CHISQ.TEST = PRUEBA.CHICUAD
+CONFIDENCE.NORM = INTERVALO.CONFIANZA.NORM
+CONFIDENCE.T = INTERVALO.CONFIANZA.T
+CORREL = COEF.DE.CORREL
+COUNT = CONTAR
+COUNTA = CONTARA
+COUNTBLANK = CONTAR.BLANCO
+COUNTIF = CONTAR.SI
+COUNTIFS = CONTAR.SI.CONJUNTO
+COVARIANCE.P = COVARIANCE.P
+COVARIANCE.S = COVARIANZA.M
+DEVSQ = DESVIA2
+EXPON.DIST = DISTR.EXP.N
+F.DIST = DISTR.F.N
+F.DIST.RT = DISTR.F.CD
+F.INV = INV.F
+F.INV.RT = INV.F.CD
+F.TEST = PRUEBA.F.N
+FISHER = FISHER
+FISHERINV = PRUEBA.FISHER.INV
+FORECAST.ETS = PRONOSTICO.ETS
+FORECAST.ETS.CONFINT = PRONOSTICO.ETS.CONFINT
+FORECAST.ETS.SEASONALITY = PRONOSTICO.ETS.ESTACIONALIDAD
+FORECAST.ETS.STAT = PRONOSTICO.ETS.STAT
+FORECAST.LINEAR = PRONOSTICO.LINEAL
+FREQUENCY = FRECUENCIA
+GAMMA = GAMMA
+GAMMA.DIST = DISTR.GAMMA.N
+GAMMA.INV = INV.GAMMA
+GAMMALN = GAMMA.LN
+GAMMALN.PRECISE = GAMMA.LN.EXACTO
+GAUSS = GAUSS
+GEOMEAN = MEDIA.GEOM
+GROWTH = CRECIMIENTO
+HARMEAN = MEDIA.ARMO
+HYPGEOM.DIST = DISTR.HIPERGEOM.N
+INTERCEPT = INTERSECCION.EJE
+KURT = CURTOSIS
+LARGE = K.ESIMO.MAYOR
+LINEST = ESTIMACION.LINEAL
+LOGEST = ESTIMACION.LOGARITMICA
+LOGNORM.DIST = DISTR.LOGNORM
+LOGNORM.INV = INV.LOGNORM
+MAX = MAX
+MAXA = MAXA
+MAXIFS = MAX.SI.CONJUNTO
+MEDIAN = MEDIANA
+MIN = MIN
+MINA = MINA
+MINIFS = MIN.SI.CONJUNTO
+MODE.MULT = MODA.VARIOS
+MODE.SNGL = MODA.UNO
+NEGBINOM.DIST = NEGBINOM.DIST
+NORM.DIST = DISTR.NORM.N
+NORM.INV = INV.NORM
+NORM.S.DIST = DISTR.NORM.ESTAND.N
+NORM.S.INV = INV.NORM.ESTAND
+PEARSON = PEARSON
+PERCENTILE.EXC = PERCENTIL.EXC
+PERCENTILE.INC = PERCENTIL.INC
+PERCENTRANK.EXC = RANGO.PERCENTIL.EXC
+PERCENTRANK.INC = RANGO.PERCENTIL.INC
+PERMUT = PERMUTACIONES
+PERMUTATIONA = PERMUTACIONES.A
+PHI = FI
+POISSON.DIST = POISSON.DIST
+PROB = PROBABILIDAD
+QUARTILE.EXC = CUARTIL.EXC
+QUARTILE.INC = CUARTIL.INC
+RANK.AVG = JERARQUIA.MEDIA
+RANK.EQ = JERARQUIA.EQV
+RSQ = COEFICIENTE.R2
+SKEW = COEFICIENTE.ASIMETRIA
+SKEW.P = COEFICIENTE.ASIMETRIA.P
+SLOPE = PENDIENTE
+SMALL = K.ESIMO.MENOR
+STANDARDIZE = NORMALIZACION
+STDEV.P = DESVEST.P
+STDEV.S = DESVEST.M
+STDEVA = DESVESTA
+STDEVPA = DESVESTPA
+STEYX = ERROR.TIPICO.XY
+T.DIST = DISTR.T.N
+T.DIST.2T = DISTR.T.2C
+T.DIST.RT = DISTR.T.CD
+T.INV = INV.T
+T.INV.2T = INV.T.2C
+T.TEST = PRUEBA.T.N
+TREND = TENDENCIA
+TRIMMEAN = MEDIA.ACOTADA
+VAR.P = VAR.P
+VAR.S = VAR.S
+VARA = VARA
+VARPA = VARPA
+WEIBULL.DIST = DISTR.WEIBULL
+Z.TEST = PRUEBA.Z.N
+
+##
+## Funciones de texto (Text Functions)
+##
+BAHTTEXT = TEXTOBAHT
+CHAR = CARACTER
+CLEAN = LIMPIAR
+CODE = CODIGO
+CONCAT = CONCAT
+DOLLAR = MONEDA
+EXACT = IGUAL
+FIND = ENCONTRAR
+FIXED = DECIMAL
+ISTHAIDIGIT = ESDIGITOTAI
+LEFT = IZQUIERDA
+LEN = LARGO
+LOWER = MINUSC
+MID = EXTRAE
+NUMBERSTRING = CADENA.NUMERO
+NUMBERVALUE = VALOR.NUMERO
+PHONETIC = FONETICO
+PROPER = NOMPROPIO
+REPLACE = REEMPLAZAR
+REPT = REPETIR
+RIGHT = DERECHA
+SEARCH = HALLAR
+SUBSTITUTE = SUSTITUIR
+T = T
+TEXT = TEXTO
+TEXTJOIN = UNIRCADENAS
+THAIDIGIT = DIGITOTAI
+THAINUMSOUND = SONNUMTAI
+THAINUMSTRING = CADENANUMTAI
+THAISTRINGLENGTH = LONGCADENATAI
+TRIM = ESPACIOS
+UNICHAR = UNICAR
+UNICODE = UNICODE
+UPPER = MAYUSC
+VALUE = VALOR
+
+##
+## Funciones web (Web Functions)
+##
+ENCODEURL = URLCODIF
+FILTERXML = XMLFILTRO
+WEBSERVICE = SERVICIOWEB
+
+##
+## Funciones de compatibilidad (Compatibility Functions)
+##
+BETADIST = DISTR.BETA
+BETAINV = DISTR.BETA.INV
+BINOMDIST = DISTR.BINOM
+CEILING = MULTIPLO.SUPERIOR
+CHIDIST = DISTR.CHI
+CHIINV = PRUEBA.CHI.INV
+CHITEST = PRUEBA.CHI
+CONCATENATE = CONCATENAR
+CONFIDENCE = INTERVALO.CONFIANZA
+COVAR = COVAR
+CRITBINOM = BINOM.CRIT
+EXPONDIST = DISTR.EXP
+FDIST = DISTR.F
+FINV = DISTR.F.INV
+FLOOR = MULTIPLO.INFERIOR
+FORECAST = PRONOSTICO
+FTEST = PRUEBA.F
+GAMMADIST = DISTR.GAMMA
+GAMMAINV = DISTR.GAMMA.INV
+HYPGEOMDIST = DISTR.HIPERGEOM
+LOGINV = DISTR.LOG.INV
+LOGNORMDIST = DISTR.LOG.NORM
+MODE = MODA
+NEGBINOMDIST = NEGBINOMDIST
+NORMDIST = DISTR.NORM
+NORMINV = DISTR.NORM.INV
+NORMSDIST = DISTR.NORM.ESTAND
+NORMSINV = DISTR.NORM.ESTAND.INV
+PERCENTILE = PERCENTIL
+PERCENTRANK = RANGO.PERCENTIL
+POISSON = POISSON
+QUARTILE = CUARTIL
+RANK = JERARQUIA
+STDEV = DESVEST
+STDEVP = DESVESTP
+TDIST = DISTR.T
+TINV = DISTR.T.INV
+TTEST = PRUEBA.T
+VAR = VAR
+VARP = VARP
+WEIBULL = DIST.WEIBULL
+ZTEST = PRUEBA.Z
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/fi/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/fi/config
new file mode 100644
index 00000000..5388f939
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/fi/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Suomi (Finnish)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL = #TYHJÄ!
+DIV0 = #JAKO/0!
+VALUE = #ARVO!
+REF = #VIITTAUS!
+NAME = #NIMI?
+NUM = #LUKU!
+NA = #PUUTTUU!
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/fi/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/fi/functions
new file mode 100644
index 00000000..18f7c8c8
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/fi/functions
@@ -0,0 +1,538 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Suomi (Finnish)
+##
+############################################################
+
+
+##
+## Kuutiofunktiot (Cube Functions)
+##
+CUBEKPIMEMBER = KUUTIOKPIJÄSEN
+CUBEMEMBER = KUUTIONJÄSEN
+CUBEMEMBERPROPERTY = KUUTIONJÄSENENOMINAISUUS
+CUBERANKEDMEMBER = KUUTIONLUOKITELTUJÄSEN
+CUBESET = KUUTIOJOUKKO
+CUBESETCOUNT = KUUTIOJOUKKOJENMÄÄRÄ
+CUBEVALUE = KUUTIONARVO
+
+##
+## Tietokantafunktiot (Database Functions)
+##
+DAVERAGE = TKESKIARVO
+DCOUNT = TLASKE
+DCOUNTA = TLASKEA
+DGET = TNOUDA
+DMAX = TMAKS
+DMIN = TMIN
+DPRODUCT = TTULO
+DSTDEV = TKESKIHAJONTA
+DSTDEVP = TKESKIHAJONTAP
+DSUM = TSUMMA
+DVAR = TVARIANSSI
+DVARP = TVARIANSSIP
+
+##
+## Päivämäärä- ja aikafunktiot (Date & Time Functions)
+##
+DATE = PÄIVÄYS
+DATEDIF = PVMERO
+DATESTRING = PVMMERKKIJONO
+DATEVALUE = PÄIVÄYSARVO
+DAY = PÄIVÄ
+DAYS = PÄIVÄT
+DAYS360 = PÄIVÄT360
+EDATE = PÄIVÄ.KUUKAUSI
+EOMONTH = KUUKAUSI.LOPPU
+HOUR = TUNNIT
+ISOWEEKNUM = VIIKKO.ISO.NRO
+MINUTE = MINUUTIT
+MONTH = KUUKAUSI
+NETWORKDAYS = TYÖPÄIVÄT
+NETWORKDAYS.INTL = TYÖPÄIVÄT.KANSVÄL
+NOW = NYT
+SECOND = SEKUNNIT
+THAIDAYOFWEEK = THAI.VIIKONPÄIVÄ
+THAIMONTHOFYEAR = THAI.KUUKAUSI
+THAIYEAR = THAI.VUOSI
+TIME = AIKA
+TIMEVALUE = AIKA_ARVO
+TODAY = TÄMÄ.PÄIVÄ
+WEEKDAY = VIIKONPÄIVÄ
+WEEKNUM = VIIKKO.NRO
+WORKDAY = TYÖPÄIVÄ
+WORKDAY.INTL = TYÖPÄIVÄ.KANSVÄL
+YEAR = VUOSI
+YEARFRAC = VUOSI.OSA
+
+##
+## Tekniset funktiot (Engineering Functions)
+##
+BESSELI = BESSELI
+BESSELJ = BESSELJ
+BESSELK = BESSELK
+BESSELY = BESSELY
+BIN2DEC = BINDES
+BIN2HEX = BINHEKSA
+BIN2OCT = BINOKT
+BITAND = BITTI.JA
+BITLSHIFT = BITTI.SIIRTO.V
+BITOR = BITTI.TAI
+BITRSHIFT = BITTI.SIIRTO.O
+BITXOR = BITTI.EHDOTON.TAI
+COMPLEX = KOMPLEKSI
+CONVERT = MUUNNA
+DEC2BIN = DESBIN
+DEC2HEX = DESHEKSA
+DEC2OCT = DESOKT
+DELTA = SAMA.ARVO
+ERF = VIRHEFUNKTIO
+ERF.PRECISE = VIRHEFUNKTIO.TARKKA
+ERFC = VIRHEFUNKTIO.KOMPLEMENTTI
+ERFC.PRECISE = VIRHEFUNKTIO.KOMPLEMENTTI.TARKKA
+GESTEP = RAJA
+HEX2BIN = HEKSABIN
+HEX2DEC = HEKSADES
+HEX2OCT = HEKSAOKT
+IMABS = KOMPLEKSI.ABS
+IMAGINARY = KOMPLEKSI.IMAG
+IMARGUMENT = KOMPLEKSI.ARG
+IMCONJUGATE = KOMPLEKSI.KONJ
+IMCOS = KOMPLEKSI.COS
+IMCOSH = IMCOSH
+IMCOT = KOMPLEKSI.COT
+IMCSC = KOMPLEKSI.KOSEK
+IMCSCH = KOMPLEKSI.KOSEKH
+IMDIV = KOMPLEKSI.OSAM
+IMEXP = KOMPLEKSI.EKSP
+IMLN = KOMPLEKSI.LN
+IMLOG10 = KOMPLEKSI.LOG10
+IMLOG2 = KOMPLEKSI.LOG2
+IMPOWER = KOMPLEKSI.POT
+IMPRODUCT = KOMPLEKSI.TULO
+IMREAL = KOMPLEKSI.REAALI
+IMSEC = KOMPLEKSI.SEK
+IMSECH = KOMPLEKSI.SEKH
+IMSIN = KOMPLEKSI.SIN
+IMSINH = KOMPLEKSI.SINH
+IMSQRT = KOMPLEKSI.NELIÖJ
+IMSUB = KOMPLEKSI.EROTUS
+IMSUM = KOMPLEKSI.SUM
+IMTAN = KOMPLEKSI.TAN
+OCT2BIN = OKTBIN
+OCT2DEC = OKTDES
+OCT2HEX = OKTHEKSA
+
+##
+## Rahoitusfunktiot (Financial Functions)
+##
+ACCRINT = KERTYNYT.KORKO
+ACCRINTM = KERTYNYT.KORKO.LOPUSSA
+AMORDEGRC = AMORDEGRC
+AMORLINC = AMORLINC
+COUPDAYBS = KORKOPÄIVÄT.ALUSTA
+COUPDAYS = KORKOPÄIVÄT
+COUPDAYSNC = KORKOPÄIVÄT.SEURAAVA
+COUPNCD = KORKOPÄIVÄ.SEURAAVA
+COUPNUM = KORKOPÄIVÄ.JAKSOT
+COUPPCD = KORKOPÄIVÄ.EDELLINEN
+CUMIPMT = MAKSETTU.KORKO
+CUMPRINC = MAKSETTU.LYHENNYS
+DB = DB
+DDB = DDB
+DISC = DISKONTTOKORKO
+DOLLARDE = VALUUTTA.DES
+DOLLARFR = VALUUTTA.MURTO
+DURATION = KESTO
+EFFECT = KORKO.EFEKT
+FV = TULEVA.ARVO
+FVSCHEDULE = TULEVA.ARVO.ERIKORKO
+INTRATE = KORKO.ARVOPAPERI
+IPMT = IPMT
+IRR = SISÄINEN.KORKO
+ISPMT = ISPMT
+MDURATION = KESTO.MUUNN
+MIRR = MSISÄINEN
+NOMINAL = KORKO.VUOSI
+NPER = NJAKSO
+NPV = NNA
+ODDFPRICE = PARITON.ENS.NIMELLISARVO
+ODDFYIELD = PARITON.ENS.TUOTTO
+ODDLPRICE = PARITON.VIIM.NIMELLISARVO
+ODDLYIELD = PARITON.VIIM.TUOTTO
+PDURATION = KESTO.JAKSO
+PMT = MAKSU
+PPMT = PPMT
+PRICE = HINTA
+PRICEDISC = HINTA.DISK
+PRICEMAT = HINTA.LUNASTUS
+PV = NA
+RATE = KORKO
+RECEIVED = SAATU.HINTA
+RRI = TOT.ROI
+SLN = STP
+SYD = VUOSIPOISTO
+TBILLEQ = OBLIG.TUOTTOPROS
+TBILLPRICE = OBLIG.HINTA
+TBILLYIELD = OBLIG.TUOTTO
+VDB = VDB
+XIRR = SISÄINEN.KORKO.JAKSOTON
+XNPV = NNA.JAKSOTON
+YIELD = TUOTTO
+YIELDDISC = TUOTTO.DISK
+YIELDMAT = TUOTTO.ERÄP
+
+##
+## Tietofunktiot (Information Functions)
+##
+CELL = SOLU
+ERROR.TYPE = VIRHEEN.LAJI
+INFO = KUVAUS
+ISBLANK = ONTYHJÄ
+ISERR = ONVIRH
+ISERROR = ONVIRHE
+ISEVEN = ONPARILLINEN
+ISFORMULA = ONKAAVA
+ISLOGICAL = ONTOTUUS
+ISNA = ONPUUTTUU
+ISNONTEXT = ONEI_TEKSTI
+ISNUMBER = ONLUKU
+ISODD = ONPARITON
+ISREF = ONVIITT
+ISTEXT = ONTEKSTI
+N = N
+NA = PUUTTUU
+SHEET = TAULUKKO
+SHEETS = TAULUKOT
+TYPE = TYYPPI
+
+##
+## Loogiset funktiot (Logical Functions)
+##
+AND = JA
+FALSE = EPÄTOSI
+IF = JOS
+IFERROR = JOSVIRHE
+IFNA = JOSPUUTTUU
+IFS = JOSS
+NOT = EI
+OR = TAI
+SWITCH = MUUTA
+TRUE = TOSI
+XOR = EHDOTON.TAI
+
+##
+## Haku- ja viitefunktiot (Lookup & Reference Functions)
+##
+ADDRESS = OSOITE
+AREAS = ALUEET
+CHOOSE = VALITSE.INDEKSI
+COLUMN = SARAKE
+COLUMNS = SARAKKEET
+FORMULATEXT = KAAVA.TEKSTI
+GETPIVOTDATA = NOUDA.PIVOT.TIEDOT
+HLOOKUP = VHAKU
+HYPERLINK = HYPERLINKKI
+INDEX = INDEKSI
+INDIRECT = EPÄSUORA
+LOOKUP = HAKU
+MATCH = VASTINE
+OFFSET = SIIRTYMÄ
+ROW = RIVI
+ROWS = RIVIT
+RTD = RTD
+TRANSPOSE = TRANSPONOI
+VLOOKUP = PHAKU
+*RC = RS
+
+##
+## Matemaattiset ja trigonometriset funktiot (Math & Trig Functions)
+##
+ABS = ITSEISARVO
+ACOS = ACOS
+ACOSH = ACOSH
+ACOT = ACOT
+ACOTH = ACOTH
+AGGREGATE = KOOSTE
+ARABIC = ARABIA
+ASIN = ASIN
+ASINH = ASINH
+ATAN = ATAN
+ATAN2 = ATAN2
+ATANH = ATANH
+BASE = PERUS
+CEILING.MATH = PYÖRISTÄ.KERR.YLÖS.MATEMAATTINEN
+CEILING.PRECISE = PYÖRISTÄ.KERR.YLÖS.TARKKA
+COMBIN = KOMBINAATIO
+COMBINA = KOMBINAATIOA
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = KOSEK
+CSCH = KOSEKH
+DECIMAL = DESIMAALI
+DEGREES = ASTEET
+ECMA.CEILING = ECMA.PYÖRISTÄ.KERR.YLÖS
+EVEN = PARILLINEN
+EXP = EKSPONENTTI
+FACT = KERTOMA
+FACTDOUBLE = KERTOMA.OSA
+FLOOR.MATH = PYÖRISTÄ.KERR.ALAS.MATEMAATTINEN
+FLOOR.PRECISE = PYÖRISTÄ.KERR.ALAS.TARKKA
+GCD = SUURIN.YHT.TEKIJÄ
+INT = KOKONAISLUKU
+ISO.CEILING = ISO.PYÖRISTÄ.KERR.YLÖS
+LCM = PIENIN.YHT.JAETTAVA
+LN = LUONNLOG
+LOG = LOG
+LOG10 = LOG10
+MDETERM = MDETERM
+MINVERSE = MKÄÄNTEINEN
+MMULT = MKERRO
+MOD = JAKOJ
+MROUND = PYÖRISTÄ.KERR
+MULTINOMIAL = MULTINOMI
+MUNIT = YKSIKKÖM
+ODD = PARITON
+PI = PII
+POWER = POTENSSI
+PRODUCT = TULO
+QUOTIENT = OSAMÄÄRÄ
+RADIANS = RADIAANIT
+RAND = SATUNNAISLUKU
+RANDBETWEEN = SATUNNAISLUKU.VÄLILTÄ
+ROMAN = ROMAN
+ROUND = PYÖRISTÄ
+ROUNDBAHTDOWN = PYÖRISTÄ.BAHT.ALAS
+ROUNDBAHTUP = PYÖRISTÄ.BAHT.YLÖS
+ROUNDDOWN = PYÖRISTÄ.DES.ALAS
+ROUNDUP = PYÖRISTÄ.DES.YLÖS
+SEC = SEK
+SECH = SEKH
+SERIESSUM = SARJA.SUMMA
+SIGN = ETUMERKKI
+SIN = SIN
+SINH = SINH
+SQRT = NELIÖJUURI
+SQRTPI = NELIÖJUURI.PII
+SUBTOTAL = VÄLISUMMA
+SUM = SUMMA
+SUMIF = SUMMA.JOS
+SUMIFS = SUMMA.JOS.JOUKKO
+SUMPRODUCT = TULOJEN.SUMMA
+SUMSQ = NELIÖSUMMA
+SUMX2MY2 = NELIÖSUMMIEN.EROTUS
+SUMX2PY2 = NELIÖSUMMIEN.SUMMA
+SUMXMY2 = EROTUSTEN.NELIÖSUMMA
+TAN = TAN
+TANH = TANH
+TRUNC = KATKAISE
+
+##
+## Tilastolliset funktiot (Statistical Functions)
+##
+AVEDEV = KESKIPOIKKEAMA
+AVERAGE = KESKIARVO
+AVERAGEA = KESKIARVOA
+AVERAGEIF = KESKIARVO.JOS
+AVERAGEIFS = KESKIARVO.JOS.JOUKKO
+BETA.DIST = BEETA.JAKAUMA
+BETA.INV = BEETA.KÄÄNT
+BINOM.DIST = BINOMI.JAKAUMA
+BINOM.DIST.RANGE = BINOMI.JAKAUMA.ALUE
+BINOM.INV = BINOMIJAKAUMA.KÄÄNT
+CHISQ.DIST = CHINELIÖ.JAKAUMA
+CHISQ.DIST.RT = CHINELIÖ.JAKAUMA.OH
+CHISQ.INV = CHINELIÖ.KÄÄNT
+CHISQ.INV.RT = CHINELIÖ.KÄÄNT.OH
+CHISQ.TEST = CHINELIÖ.TESTI
+CONFIDENCE.NORM = LUOTTAMUSVÄLI.NORM
+CONFIDENCE.T = LUOTTAMUSVÄLI.T
+CORREL = KORRELAATIO
+COUNT = LASKE
+COUNTA = LASKE.A
+COUNTBLANK = LASKE.TYHJÄT
+COUNTIF = LASKE.JOS
+COUNTIFS = LASKE.JOS.JOUKKO
+COVARIANCE.P = KOVARIANSSI.P
+COVARIANCE.S = KOVARIANSSI.S
+DEVSQ = OIKAISTU.NELIÖSUMMA
+EXPON.DIST = EKSPONENTIAALI.JAKAUMA
+F.DIST = F.JAKAUMA
+F.DIST.RT = F.JAKAUMA.OH
+F.INV = F.KÄÄNT
+F.INV.RT = F.KÄÄNT.OH
+F.TEST = F.TESTI
+FISHER = FISHER
+FISHERINV = FISHER.KÄÄNT
+FORECAST.ETS = ENNUSTE.ETS
+FORECAST.ETS.CONFINT = ENNUSTE.ETS.CONFINT
+FORECAST.ETS.SEASONALITY = ENNUSTE.ETS.KAUSIVAIHTELU
+FORECAST.ETS.STAT = ENNUSTE.ETS.STAT
+FORECAST.LINEAR = ENNUSTE.LINEAARINEN
+FREQUENCY = TAAJUUS
+GAMMA = GAMMA
+GAMMA.DIST = GAMMA.JAKAUMA
+GAMMA.INV = GAMMA.JAKAUMA.KÄÄNT
+GAMMALN = GAMMALN
+GAMMALN.PRECISE = GAMMALN.TARKKA
+GAUSS = GAUSS
+GEOMEAN = KESKIARVO.GEOM
+GROWTH = KASVU
+HARMEAN = KESKIARVO.HARM
+HYPGEOM.DIST = HYPERGEOM_JAKAUMA
+INTERCEPT = LEIKKAUSPISTE
+KURT = KURT
+LARGE = SUURI
+LINEST = LINREGR
+LOGEST = LOGREGR
+LOGNORM.DIST = LOGNORM_JAKAUMA
+LOGNORM.INV = LOGNORM.KÄÄNT
+MAX = MAKS
+MAXA = MAKSA
+MAXIFS = MAKS.JOS
+MEDIAN = MEDIAANI
+MIN = MIN
+MINA = MINA
+MINIFS = MIN.JOS
+MODE.MULT = MOODI.USEA
+MODE.SNGL = MOODI.YKSI
+NEGBINOM.DIST = BINOMI.JAKAUMA.NEG
+NORM.DIST = NORMAALI.JAKAUMA
+NORM.INV = NORMAALI.JAKAUMA.KÄÄNT
+NORM.S.DIST = NORM_JAKAUMA.NORMIT
+NORM.S.INV = NORM_JAKAUMA.KÄÄNT
+PEARSON = PEARSON
+PERCENTILE.EXC = PROSENTTIPISTE.ULK
+PERCENTILE.INC = PROSENTTIPISTE.SIS
+PERCENTRANK.EXC = PROSENTTIJÄRJESTYS.ULK
+PERCENTRANK.INC = PROSENTTIJÄRJESTYS.SIS
+PERMUT = PERMUTAATIO
+PERMUTATIONA = PERMUTAATIOA
+PHI = FII
+POISSON.DIST = POISSON.JAKAUMA
+PROB = TODENNÄKÖISYYS
+QUARTILE.EXC = NELJÄNNES.ULK
+QUARTILE.INC = NELJÄNNES.SIS
+RANK.AVG = ARVON.MUKAAN.KESKIARVO
+RANK.EQ = ARVON.MUKAAN.TASAN
+RSQ = PEARSON.NELIÖ
+SKEW = JAKAUMAN.VINOUS
+SKEW.P = JAKAUMAN.VINOUS.POP
+SLOPE = KULMAKERROIN
+SMALL = PIENI
+STANDARDIZE = NORMITA
+STDEV.P = KESKIHAJONTA.P
+STDEV.S = KESKIHAJONTA.S
+STDEVA = KESKIHAJONTAA
+STDEVPA = KESKIHAJONTAPA
+STEYX = KESKIVIRHE
+T.DIST = T.JAKAUMA
+T.DIST.2T = T.JAKAUMA.2S
+T.DIST.RT = T.JAKAUMA.OH
+T.INV = T.KÄÄNT
+T.INV.2T = T.KÄÄNT.2S
+T.TEST = T.TESTI
+TREND = SUUNTAUS
+TRIMMEAN = KESKIARVO.TASATTU
+VAR.P = VAR.P
+VAR.S = VAR.S
+VARA = VARA
+VARPA = VARPA
+WEIBULL.DIST = WEIBULL.JAKAUMA
+Z.TEST = Z.TESTI
+
+##
+## Tekstifunktiot (Text Functions)
+##
+BAHTTEXT = BAHTTEKSTI
+CHAR = MERKKI
+CLEAN = SIIVOA
+CODE = KOODI
+CONCAT = YHDISTÄ
+DOLLAR = VALUUTTA
+EXACT = VERTAA
+FIND = ETSI
+FIXED = KIINTEÄ
+ISTHAIDIGIT = ON.THAI.NUMERO
+LEFT = VASEN
+LEN = PITUUS
+LOWER = PIENET
+MID = POIMI.TEKSTI
+NUMBERSTRING = NROMERKKIJONO
+NUMBERVALUE = NROARVO
+PHONETIC = FONEETTINEN
+PROPER = ERISNIMI
+REPLACE = KORVAA
+REPT = TOISTA
+RIGHT = OIKEA
+SEARCH = KÄY.LÄPI
+SUBSTITUTE = VAIHDA
+T = T
+TEXT = TEKSTI
+TEXTJOIN = TEKSTI.YHDISTÄ
+THAIDIGIT = THAI.NUMERO
+THAINUMSOUND = THAI.LUKU.ÄÄNI
+THAINUMSTRING = THAI.LUKU.MERKKIJONO
+THAISTRINGLENGTH = THAI.MERKKIJONON.PITUUS
+TRIM = POISTA.VÄLIT
+UNICHAR = UNICODEMERKKI
+UNICODE = UNICODE
+UPPER = ISOT
+VALUE = ARVO
+
+##
+## Verkkofunktiot (Web Functions)
+##
+ENCODEURL = URLKOODAUS
+FILTERXML = SUODATA.XML
+WEBSERVICE = VERKKOPALVELU
+
+##
+## Yhteensopivuusfunktiot (Compatibility Functions)
+##
+BETADIST = BEETAJAKAUMA
+BETAINV = BEETAJAKAUMA.KÄÄNT
+BINOMDIST = BINOMIJAKAUMA
+CEILING = PYÖRISTÄ.KERR.YLÖS
+CHIDIST = CHIJAKAUMA
+CHIINV = CHIJAKAUMA.KÄÄNT
+CHITEST = CHITESTI
+CONCATENATE = KETJUTA
+CONFIDENCE = LUOTTAMUSVÄLI
+COVAR = KOVARIANSSI
+CRITBINOM = BINOMIJAKAUMA.KRIT
+EXPONDIST = EKSPONENTIAALIJAKAUMA
+FDIST = FJAKAUMA
+FINV = FJAKAUMA.KÄÄNT
+FLOOR = PYÖRISTÄ.KERR.ALAS
+FORECAST = ENNUSTE
+FTEST = FTESTI
+GAMMADIST = GAMMAJAKAUMA
+GAMMAINV = GAMMAJAKAUMA.KÄÄNT
+HYPGEOMDIST = HYPERGEOM.JAKAUMA
+LOGINV = LOGNORM.JAKAUMA.KÄÄNT
+LOGNORMDIST = LOGNORM.JAKAUMA
+MODE = MOODI
+NEGBINOMDIST = BINOMIJAKAUMA.NEG
+NORMDIST = NORM.JAKAUMA
+NORMINV = NORM.JAKAUMA.KÄÄNT
+NORMSDIST = NORM.JAKAUMA.NORMIT
+NORMSINV = NORM.JAKAUMA.NORMIT.KÄÄNT
+PERCENTILE = PROSENTTIPISTE
+PERCENTRANK = PROSENTTIJÄRJESTYS
+POISSON = POISSON
+QUARTILE = NELJÄNNES
+RANK = ARVON.MUKAAN
+STDEV = KESKIHAJONTA
+STDEVP = KESKIHAJONTAP
+TDIST = TJAKAUMA
+TINV = TJAKAUMA.KÄÄNT
+TTEST = TTESTI
+VAR = VAR
+VARP = VARP
+WEIBULL = WEIBULL
+ZTEST = ZTESTI
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/fr/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/fr/config
new file mode 100644
index 00000000..bdac4121
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/fr/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Français (French)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL = #NUL!
+DIV0
+VALUE = #VALEUR!
+REF
+NAME = #NOM?
+NUM = #NOMBRE!
+NA
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/fr/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/fr/functions
new file mode 100644
index 00000000..621cb0db
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/fr/functions
@@ -0,0 +1,525 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Français (French)
+##
+############################################################
+
+
+##
+## Fonctions Cube (Cube Functions)
+##
+CUBEKPIMEMBER = MEMBREKPICUBE
+CUBEMEMBER = MEMBRECUBE
+CUBEMEMBERPROPERTY = PROPRIETEMEMBRECUBE
+CUBERANKEDMEMBER = RANGMEMBRECUBE
+CUBESET = JEUCUBE
+CUBESETCOUNT = NBJEUCUBE
+CUBEVALUE = VALEURCUBE
+
+##
+## Fonctions de base de données (Database Functions)
+##
+DAVERAGE = BDMOYENNE
+DCOUNT = BDNB
+DCOUNTA = BDNBVAL
+DGET = BDLIRE
+DMAX = BDMAX
+DMIN = BDMIN
+DPRODUCT = BDPRODUIT
+DSTDEV = BDECARTYPE
+DSTDEVP = BDECARTYPEP
+DSUM = BDSOMME
+DVAR = BDVAR
+DVARP = BDVARP
+
+##
+## Fonctions de date et d’heure (Date & Time Functions)
+##
+DATE = DATE
+DATEVALUE = DATEVAL
+DAY = JOUR
+DAYS = JOURS
+DAYS360 = JOURS360
+EDATE = MOIS.DECALER
+EOMONTH = FIN.MOIS
+HOUR = HEURE
+ISOWEEKNUM = NO.SEMAINE.ISO
+MINUTE = MINUTE
+MONTH = MOIS
+NETWORKDAYS = NB.JOURS.OUVRES
+NETWORKDAYS.INTL = NB.JOURS.OUVRES.INTL
+NOW = MAINTENANT
+SECOND = SECONDE
+TIME = TEMPS
+TIMEVALUE = TEMPSVAL
+TODAY = AUJOURDHUI
+WEEKDAY = JOURSEM
+WEEKNUM = NO.SEMAINE
+WORKDAY = SERIE.JOUR.OUVRE
+WORKDAY.INTL = SERIE.JOUR.OUVRE.INTL
+YEAR = ANNEE
+YEARFRAC = FRACTION.ANNEE
+
+##
+## Fonctions d’ingénierie (Engineering Functions)
+##
+BESSELI = BESSELI
+BESSELJ = BESSELJ
+BESSELK = BESSELK
+BESSELY = BESSELY
+BIN2DEC = BINDEC
+BIN2HEX = BINHEX
+BIN2OCT = BINOCT
+BITAND = BITET
+BITLSHIFT = BITDECALG
+BITOR = BITOU
+BITRSHIFT = BITDECALD
+BITXOR = BITOUEXCLUSIF
+COMPLEX = COMPLEXE
+CONVERT = CONVERT
+DEC2BIN = DECBIN
+DEC2HEX = DECHEX
+DEC2OCT = DECOCT
+DELTA = DELTA
+ERF = ERF
+ERF.PRECISE = ERF.PRECIS
+ERFC = ERFC
+ERFC.PRECISE = ERFC.PRECIS
+GESTEP = SUP.SEUIL
+HEX2BIN = HEXBIN
+HEX2DEC = HEXDEC
+HEX2OCT = HEXOCT
+IMABS = COMPLEXE.MODULE
+IMAGINARY = COMPLEXE.IMAGINAIRE
+IMARGUMENT = COMPLEXE.ARGUMENT
+IMCONJUGATE = COMPLEXE.CONJUGUE
+IMCOS = COMPLEXE.COS
+IMCOSH = COMPLEXE.COSH
+IMCOT = COMPLEXE.COT
+IMCSC = COMPLEXE.CSC
+IMCSCH = COMPLEXE.CSCH
+IMDIV = COMPLEXE.DIV
+IMEXP = COMPLEXE.EXP
+IMLN = COMPLEXE.LN
+IMLOG10 = COMPLEXE.LOG10
+IMLOG2 = COMPLEXE.LOG2
+IMPOWER = COMPLEXE.PUISSANCE
+IMPRODUCT = COMPLEXE.PRODUIT
+IMREAL = COMPLEXE.REEL
+IMSEC = COMPLEXE.SEC
+IMSECH = COMPLEXE.SECH
+IMSIN = COMPLEXE.SIN
+IMSINH = COMPLEXE.SINH
+IMSQRT = COMPLEXE.RACINE
+IMSUB = COMPLEXE.DIFFERENCE
+IMSUM = COMPLEXE.SOMME
+IMTAN = COMPLEXE.TAN
+OCT2BIN = OCTBIN
+OCT2DEC = OCTDEC
+OCT2HEX = OCTHEX
+
+##
+## Fonctions financières (Financial Functions)
+##
+ACCRINT = INTERET.ACC
+ACCRINTM = INTERET.ACC.MAT
+AMORDEGRC = AMORDEGRC
+AMORLINC = AMORLINC
+COUPDAYBS = NB.JOURS.COUPON.PREC
+COUPDAYS = NB.JOURS.COUPONS
+COUPDAYSNC = NB.JOURS.COUPON.SUIV
+COUPNCD = DATE.COUPON.SUIV
+COUPNUM = NB.COUPONS
+COUPPCD = DATE.COUPON.PREC
+CUMIPMT = CUMUL.INTER
+CUMPRINC = CUMUL.PRINCPER
+DB = DB
+DDB = DDB
+DISC = TAUX.ESCOMPTE
+DOLLARDE = PRIX.DEC
+DOLLARFR = PRIX.FRAC
+DURATION = DUREE
+EFFECT = TAUX.EFFECTIF
+FV = VC
+FVSCHEDULE = VC.PAIEMENTS
+INTRATE = TAUX.INTERET
+IPMT = INTPER
+IRR = TRI
+ISPMT = ISPMT
+MDURATION = DUREE.MODIFIEE
+MIRR = TRIM
+NOMINAL = TAUX.NOMINAL
+NPER = NPM
+NPV = VAN
+ODDFPRICE = PRIX.PCOUPON.IRREG
+ODDFYIELD = REND.PCOUPON.IRREG
+ODDLPRICE = PRIX.DCOUPON.IRREG
+ODDLYIELD = REND.DCOUPON.IRREG
+PDURATION = PDUREE
+PMT = VPM
+PPMT = PRINCPER
+PRICE = PRIX.TITRE
+PRICEDISC = VALEUR.ENCAISSEMENT
+PRICEMAT = PRIX.TITRE.ECHEANCE
+PV = VA
+RATE = TAUX
+RECEIVED = VALEUR.NOMINALE
+RRI = TAUX.INT.EQUIV
+SLN = AMORLIN
+SYD = SYD
+TBILLEQ = TAUX.ESCOMPTE.R
+TBILLPRICE = PRIX.BON.TRESOR
+TBILLYIELD = RENDEMENT.BON.TRESOR
+VDB = VDB
+XIRR = TRI.PAIEMENTS
+XNPV = VAN.PAIEMENTS
+YIELD = RENDEMENT.TITRE
+YIELDDISC = RENDEMENT.SIMPLE
+YIELDMAT = RENDEMENT.TITRE.ECHEANCE
+
+##
+## Fonctions d’information (Information Functions)
+##
+CELL = CELLULE
+ERROR.TYPE = TYPE.ERREUR
+INFO = INFORMATIONS
+ISBLANK = ESTVIDE
+ISERR = ESTERR
+ISERROR = ESTERREUR
+ISEVEN = EST.PAIR
+ISFORMULA = ESTFORMULE
+ISLOGICAL = ESTLOGIQUE
+ISNA = ESTNA
+ISNONTEXT = ESTNONTEXTE
+ISNUMBER = ESTNUM
+ISODD = EST.IMPAIR
+ISREF = ESTREF
+ISTEXT = ESTTEXTE
+N = N
+NA = NA
+SHEET = FEUILLE
+SHEETS = FEUILLES
+TYPE = TYPE
+
+##
+## Fonctions logiques (Logical Functions)
+##
+AND = ET
+FALSE = FAUX
+IF = SI
+IFERROR = SIERREUR
+IFNA = SI.NON.DISP
+IFS = SI.CONDITIONS
+NOT = NON
+OR = OU
+SWITCH = SI.MULTIPLE
+TRUE = VRAI
+XOR = OUX
+
+##
+## Fonctions de recherche et de référence (Lookup & Reference Functions)
+##
+ADDRESS = ADRESSE
+AREAS = ZONES
+CHOOSE = CHOISIR
+COLUMN = COLONNE
+COLUMNS = COLONNES
+FORMULATEXT = FORMULETEXTE
+GETPIVOTDATA = LIREDONNEESTABCROISDYNAMIQUE
+HLOOKUP = RECHERCHEH
+HYPERLINK = LIEN_HYPERTEXTE
+INDEX = INDEX
+INDIRECT = INDIRECT
+LOOKUP = RECHERCHE
+MATCH = EQUIV
+OFFSET = DECALER
+ROW = LIGNE
+ROWS = LIGNES
+RTD = RTD
+TRANSPOSE = TRANSPOSE
+VLOOKUP = RECHERCHEV
+*RC = LC
+
+##
+## Fonctions mathématiques et trigonométriques (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = ACOS
+ACOSH = ACOSH
+ACOT = ACOT
+ACOTH = ACOTH
+AGGREGATE = AGREGAT
+ARABIC = CHIFFRE.ARABE
+ASIN = ASIN
+ASINH = ASINH
+ATAN = ATAN
+ATAN2 = ATAN2
+ATANH = ATANH
+BASE = BASE
+CEILING.MATH = PLAFOND.MATH
+CEILING.PRECISE = PLAFOND.PRECIS
+COMBIN = COMBIN
+COMBINA = COMBINA
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = CSC
+CSCH = CSCH
+DECIMAL = DECIMAL
+DEGREES = DEGRES
+ECMA.CEILING = ECMA.PLAFOND
+EVEN = PAIR
+EXP = EXP
+FACT = FACT
+FACTDOUBLE = FACTDOUBLE
+FLOOR.MATH = PLANCHER.MATH
+FLOOR.PRECISE = PLANCHER.PRECIS
+GCD = PGCD
+INT = ENT
+ISO.CEILING = ISO.PLAFOND
+LCM = PPCM
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = DETERMAT
+MINVERSE = INVERSEMAT
+MMULT = PRODUITMAT
+MOD = MOD
+MROUND = ARRONDI.AU.MULTIPLE
+MULTINOMIAL = MULTINOMIALE
+MUNIT = MATRICE.UNITAIRE
+ODD = IMPAIR
+PI = PI
+POWER = PUISSANCE
+PRODUCT = PRODUIT
+QUOTIENT = QUOTIENT
+RADIANS = RADIANS
+RAND = ALEA
+RANDBETWEEN = ALEA.ENTRE.BORNES
+ROMAN = ROMAIN
+ROUND = ARRONDI
+ROUNDDOWN = ARRONDI.INF
+ROUNDUP = ARRONDI.SUP
+SEC = SEC
+SECH = SECH
+SERIESSUM = SOMME.SERIES
+SIGN = SIGNE
+SIN = SIN
+SINH = SINH
+SQRT = RACINE
+SQRTPI = RACINE.PI
+SUBTOTAL = SOUS.TOTAL
+SUM = SOMME
+SUMIF = SOMME.SI
+SUMIFS = SOMME.SI.ENS
+SUMPRODUCT = SOMMEPROD
+SUMSQ = SOMME.CARRES
+SUMX2MY2 = SOMME.X2MY2
+SUMX2PY2 = SOMME.X2PY2
+SUMXMY2 = SOMME.XMY2
+TAN = TAN
+TANH = TANH
+TRUNC = TRONQUE
+
+##
+## Fonctions statistiques (Statistical Functions)
+##
+AVEDEV = ECART.MOYEN
+AVERAGE = MOYENNE
+AVERAGEA = AVERAGEA
+AVERAGEIF = MOYENNE.SI
+AVERAGEIFS = MOYENNE.SI.ENS
+BETA.DIST = LOI.BETA.N
+BETA.INV = BETA.INVERSE.N
+BINOM.DIST = LOI.BINOMIALE.N
+BINOM.DIST.RANGE = LOI.BINOMIALE.SERIE
+BINOM.INV = LOI.BINOMIALE.INVERSE
+CHISQ.DIST = LOI.KHIDEUX.N
+CHISQ.DIST.RT = LOI.KHIDEUX.DROITE
+CHISQ.INV = LOI.KHIDEUX.INVERSE
+CHISQ.INV.RT = LOI.KHIDEUX.INVERSE.DROITE
+CHISQ.TEST = CHISQ.TEST
+CONFIDENCE.NORM = INTERVALLE.CONFIANCE.NORMAL
+CONFIDENCE.T = INTERVALLE.CONFIANCE.STUDENT
+CORREL = COEFFICIENT.CORRELATION
+COUNT = NB
+COUNTA = NBVAL
+COUNTBLANK = NB.VIDE
+COUNTIF = NB.SI
+COUNTIFS = NB.SI.ENS
+COVARIANCE.P = COVARIANCE.PEARSON
+COVARIANCE.S = COVARIANCE.STANDARD
+DEVSQ = SOMME.CARRES.ECARTS
+EXPON.DIST = LOI.EXPONENTIELLE.N
+F.DIST = LOI.F.N
+F.DIST.RT = LOI.F.DROITE
+F.INV = INVERSE.LOI.F.N
+F.INV.RT = INVERSE.LOI.F.DROITE
+F.TEST = F.TEST
+FISHER = FISHER
+FISHERINV = FISHER.INVERSE
+FORECAST.ETS = PREVISION.ETS
+FORECAST.ETS.CONFINT = PREVISION.ETS.CONFINT
+FORECAST.ETS.SEASONALITY = PREVISION.ETS.CARACTERESAISONNIER
+FORECAST.ETS.STAT = PREVISION.ETS.STAT
+FORECAST.LINEAR = PREVISION.LINEAIRE
+FREQUENCY = FREQUENCE
+GAMMA = GAMMA
+GAMMA.DIST = LOI.GAMMA.N
+GAMMA.INV = LOI.GAMMA.INVERSE.N
+GAMMALN = LNGAMMA
+GAMMALN.PRECISE = LNGAMMA.PRECIS
+GAUSS = GAUSS
+GEOMEAN = MOYENNE.GEOMETRIQUE
+GROWTH = CROISSANCE
+HARMEAN = MOYENNE.HARMONIQUE
+HYPGEOM.DIST = LOI.HYPERGEOMETRIQUE.N
+INTERCEPT = ORDONNEE.ORIGINE
+KURT = KURTOSIS
+LARGE = GRANDE.VALEUR
+LINEST = DROITEREG
+LOGEST = LOGREG
+LOGNORM.DIST = LOI.LOGNORMALE.N
+LOGNORM.INV = LOI.LOGNORMALE.INVERSE.N
+MAX = MAX
+MAXA = MAXA
+MAXIFS = MAX.SI
+MEDIAN = MEDIANE
+MIN = MIN
+MINA = MINA
+MINIFS = MIN.SI
+MODE.MULT = MODE.MULTIPLE
+MODE.SNGL = MODE.SIMPLE
+NEGBINOM.DIST = LOI.BINOMIALE.NEG.N
+NORM.DIST = LOI.NORMALE.N
+NORM.INV = LOI.NORMALE.INVERSE.N
+NORM.S.DIST = LOI.NORMALE.STANDARD.N
+NORM.S.INV = LOI.NORMALE.STANDARD.INVERSE.N
+PEARSON = PEARSON
+PERCENTILE.EXC = CENTILE.EXCLURE
+PERCENTILE.INC = CENTILE.INCLURE
+PERCENTRANK.EXC = RANG.POURCENTAGE.EXCLURE
+PERCENTRANK.INC = RANG.POURCENTAGE.INCLURE
+PERMUT = PERMUTATION
+PERMUTATIONA = PERMUTATIONA
+PHI = PHI
+POISSON.DIST = LOI.POISSON.N
+PROB = PROBABILITE
+QUARTILE.EXC = QUARTILE.EXCLURE
+QUARTILE.INC = QUARTILE.INCLURE
+RANK.AVG = MOYENNE.RANG
+RANK.EQ = EQUATION.RANG
+RSQ = COEFFICIENT.DETERMINATION
+SKEW = COEFFICIENT.ASYMETRIE
+SKEW.P = COEFFICIENT.ASYMETRIE.P
+SLOPE = PENTE
+SMALL = PETITE.VALEUR
+STANDARDIZE = CENTREE.REDUITE
+STDEV.P = ECARTYPE.PEARSON
+STDEV.S = ECARTYPE.STANDARD
+STDEVA = STDEVA
+STDEVPA = STDEVPA
+STEYX = ERREUR.TYPE.XY
+T.DIST = LOI.STUDENT.N
+T.DIST.2T = LOI.STUDENT.BILATERALE
+T.DIST.RT = LOI.STUDENT.DROITE
+T.INV = LOI.STUDENT.INVERSE.N
+T.INV.2T = LOI.STUDENT.INVERSE.BILATERALE
+T.TEST = T.TEST
+TREND = TENDANCE
+TRIMMEAN = MOYENNE.REDUITE
+VAR.P = VAR.P.N
+VAR.S = VAR.S
+VARA = VARA
+VARPA = VARPA
+WEIBULL.DIST = LOI.WEIBULL.N
+Z.TEST = Z.TEST
+
+##
+## Fonctions de texte (Text Functions)
+##
+BAHTTEXT = BAHTTEXT
+CHAR = CAR
+CLEAN = EPURAGE
+CODE = CODE
+CONCAT = CONCAT
+DOLLAR = DEVISE
+EXACT = EXACT
+FIND = TROUVE
+FIXED = CTXT
+LEFT = GAUCHE
+LEN = NBCAR
+LOWER = MINUSCULE
+MID = STXT
+NUMBERVALUE = VALEURNOMBRE
+PHONETIC = PHONETIQUE
+PROPER = NOMPROPRE
+REPLACE = REMPLACER
+REPT = REPT
+RIGHT = DROITE
+SEARCH = CHERCHE
+SUBSTITUTE = SUBSTITUE
+T = T
+TEXT = TEXTE
+TEXTJOIN = JOINDRE.TEXTE
+TRIM = SUPPRESPACE
+UNICHAR = UNICAR
+UNICODE = UNICODE
+UPPER = MAJUSCULE
+VALUE = CNUM
+
+##
+## Fonctions web (Web Functions)
+##
+ENCODEURL = URLENCODAGE
+FILTERXML = FILTRE.XML
+WEBSERVICE = SERVICEWEB
+
+##
+## Fonctions de compatibilité (Compatibility Functions)
+##
+BETADIST = LOI.BETA
+BETAINV = BETA.INVERSE
+BINOMDIST = LOI.BINOMIALE
+CEILING = PLAFOND
+CHIDIST = LOI.KHIDEUX
+CHIINV = KHIDEUX.INVERSE
+CHITEST = TEST.KHIDEUX
+CONCATENATE = CONCATENER
+CONFIDENCE = INTERVALLE.CONFIANCE
+COVAR = COVARIANCE
+CRITBINOM = CRITERE.LOI.BINOMIALE
+EXPONDIST = LOI.EXPONENTIELLE
+FDIST = LOI.F
+FINV = INVERSE.LOI.F
+FLOOR = PLANCHER
+FORECAST = PREVISION
+FTEST = TEST.F
+GAMMADIST = LOI.GAMMA
+GAMMAINV = LOI.GAMMA.INVERSE
+HYPGEOMDIST = LOI.HYPERGEOMETRIQUE
+LOGINV = LOI.LOGNORMALE.INVERSE
+LOGNORMDIST = LOI.LOGNORMALE
+MODE = MODE
+NEGBINOMDIST = LOI.BINOMIALE.NEG
+NORMDIST = LOI.NORMALE
+NORMINV = LOI.NORMALE.INVERSE
+NORMSDIST = LOI.NORMALE.STANDARD
+NORMSINV = LOI.NORMALE.STANDARD.INVERSE
+PERCENTILE = CENTILE
+PERCENTRANK = RANG.POURCENTAGE
+POISSON = LOI.POISSON
+QUARTILE = QUARTILE
+RANK = RANG
+STDEV = ECARTYPE
+STDEVP = ECARTYPEP
+TDIST = LOI.STUDENT
+TINV = LOI.STUDENT.INVERSE
+TTEST = TEST.STUDENT
+VAR = VAR
+VARP = VAR.P
+WEIBULL = LOI.WEIBULL
+ZTEST = TEST.Z
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/hu/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/hu/config
new file mode 100644
index 00000000..dc585d71
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/hu/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Magyar (Hungarian)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL = #NULLA!
+DIV0 = #ZÉRÓOSZTÓ!
+VALUE = #ÉRTÉK!
+REF = #HIV!
+NAME = #NÉV?
+NUM = #SZÁM!
+NA = #HIÁNYZIK
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/hu/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/hu/functions
new file mode 100644
index 00000000..4a375ea2
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/hu/functions
@@ -0,0 +1,538 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Magyar (Hungarian)
+##
+############################################################
+
+
+##
+## Kockafüggvények (Cube Functions)
+##
+CUBEKPIMEMBER = KOCKA.FŐTELJMUT
+CUBEMEMBER = KOCKA.TAG
+CUBEMEMBERPROPERTY = KOCKA.TAG.TUL
+CUBERANKEDMEMBER = KOCKA.HALM.ELEM
+CUBESET = KOCKA.HALM
+CUBESETCOUNT = KOCKA.HALM.DB
+CUBEVALUE = KOCKA.ÉRTÉK
+
+##
+## Adatbázis-kezelő függvények (Database Functions)
+##
+DAVERAGE = AB.ÁTLAG
+DCOUNT = AB.DARAB
+DCOUNTA = AB.DARAB2
+DGET = AB.MEZŐ
+DMAX = AB.MAX
+DMIN = AB.MIN
+DPRODUCT = AB.SZORZAT
+DSTDEV = AB.SZÓRÁS
+DSTDEVP = AB.SZÓRÁS2
+DSUM = AB.SZUM
+DVAR = AB.VAR
+DVARP = AB.VAR2
+
+##
+## Dátumfüggvények (Date & Time Functions)
+##
+DATE = DÁTUM
+DATEDIF = DÁTUMTÓLIG
+DATESTRING = DÁTUMSZÖVEG
+DATEVALUE = DÁTUMÉRTÉK
+DAY = NAP
+DAYS = NAPOK
+DAYS360 = NAP360
+EDATE = KALK.DÁTUM
+EOMONTH = HÓNAP.UTOLSÓ.NAP
+HOUR = ÓRA
+ISOWEEKNUM = ISO.HÉT.SZÁMA
+MINUTE = PERCEK
+MONTH = HÓNAP
+NETWORKDAYS = ÖSSZ.MUNKANAP
+NETWORKDAYS.INTL = ÖSSZ.MUNKANAP.INTL
+NOW = MOST
+SECOND = MPERC
+THAIDAYOFWEEK = THAIHÉTNAPJA
+THAIMONTHOFYEAR = THAIHÓNAP
+THAIYEAR = THAIÉV
+TIME = IDŐ
+TIMEVALUE = IDŐÉRTÉK
+TODAY = MA
+WEEKDAY = HÉT.NAPJA
+WEEKNUM = HÉT.SZÁMA
+WORKDAY = KALK.MUNKANAP
+WORKDAY.INTL = KALK.MUNKANAP.INTL
+YEAR = ÉV
+YEARFRAC = TÖRTÉV
+
+##
+## Mérnöki függvények (Engineering Functions)
+##
+BESSELI = BESSELI
+BESSELJ = BESSELJ
+BESSELK = BESSELK
+BESSELY = BESSELY
+BIN2DEC = BIN.DEC
+BIN2HEX = BIN.HEX
+BIN2OCT = BIN.OKT
+BITAND = BIT.ÉS
+BITLSHIFT = BIT.BAL.ELTOL
+BITOR = BIT.VAGY
+BITRSHIFT = BIT.JOBB.ELTOL
+BITXOR = BIT.XVAGY
+COMPLEX = KOMPLEX
+CONVERT = KONVERTÁLÁS
+DEC2BIN = DEC.BIN
+DEC2HEX = DEC.HEX
+DEC2OCT = DEC.OKT
+DELTA = DELTA
+ERF = HIBAF
+ERF.PRECISE = HIBAF.PONTOS
+ERFC = HIBAF.KOMPLEMENTER
+ERFC.PRECISE = HIBAFKOMPLEMENTER.PONTOS
+GESTEP = KÜSZÖBNÉL.NAGYOBB
+HEX2BIN = HEX.BIN
+HEX2DEC = HEX.DEC
+HEX2OCT = HEX.OKT
+IMABS = KÉPZ.ABSZ
+IMAGINARY = KÉPZETES
+IMARGUMENT = KÉPZ.ARGUMENT
+IMCONJUGATE = KÉPZ.KONJUGÁLT
+IMCOS = KÉPZ.COS
+IMCOSH = KÉPZ.COSH
+IMCOT = KÉPZ.COT
+IMCSC = KÉPZ.CSC
+IMCSCH = KÉPZ.CSCH
+IMDIV = KÉPZ.HÁNYAD
+IMEXP = KÉPZ.EXP
+IMLN = KÉPZ.LN
+IMLOG10 = KÉPZ.LOG10
+IMLOG2 = KÉPZ.LOG2
+IMPOWER = KÉPZ.HATV
+IMPRODUCT = KÉPZ.SZORZAT
+IMREAL = KÉPZ.VALÓS
+IMSEC = KÉPZ.SEC
+IMSECH = KÉPZ.SECH
+IMSIN = KÉPZ.SIN
+IMSINH = KÉPZ.SINH
+IMSQRT = KÉPZ.GYÖK
+IMSUB = KÉPZ.KÜL
+IMSUM = KÉPZ.ÖSSZEG
+IMTAN = KÉPZ.TAN
+OCT2BIN = OKT.BIN
+OCT2DEC = OKT.DEC
+OCT2HEX = OKT.HEX
+
+##
+## Pénzügyi függvények (Financial Functions)
+##
+ACCRINT = IDŐSZAKI.KAMAT
+ACCRINTM = LEJÁRATI.KAMAT
+AMORDEGRC = ÉRTÉKCSÖKK.TÉNYEZŐVEL
+AMORLINC = ÉRTÉKCSÖKK
+COUPDAYBS = SZELVÉNYIDŐ.KEZDETTŐL
+COUPDAYS = SZELVÉNYIDŐ
+COUPDAYSNC = SZELVÉNYIDŐ.KIFIZETÉSTŐL
+COUPNCD = ELSŐ.SZELVÉNYDÁTUM
+COUPNUM = SZELVÉNYSZÁM
+COUPPCD = UTOLSÓ.SZELVÉNYDÁTUM
+CUMIPMT = ÖSSZES.KAMAT
+CUMPRINC = ÖSSZES.TŐKERÉSZ
+DB = KCS2
+DDB = KCSA
+DISC = LESZÁM
+DOLLARDE = FORINT.DEC
+DOLLARFR = FORINT.TÖRT
+DURATION = KAMATÉRZ
+EFFECT = TÉNYLEGES
+FV = JBÉ
+FVSCHEDULE = KJÉ
+INTRATE = KAMATRÁTA
+IPMT = RRÉSZLET
+IRR = BMR
+ISPMT = LRÉSZLETKAMAT
+MDURATION = MKAMATÉRZ
+MIRR = MEGTÉRÜLÉS
+NOMINAL = NÉVLEGES
+NPER = PER.SZÁM
+NPV = NMÉ
+ODDFPRICE = ELTÉRŐ.EÁR
+ODDFYIELD = ELTÉRŐ.EHOZAM
+ODDLPRICE = ELTÉRŐ.UÁR
+ODDLYIELD = ELTÉRŐ.UHOZAM
+PDURATION = KAMATÉRZ.PER
+PMT = RÉSZLET
+PPMT = PRÉSZLET
+PRICE = ÁR
+PRICEDISC = ÁR.LESZÁM
+PRICEMAT = ÁR.LEJÁRAT
+PV = MÉ
+RATE = RÁTA
+RECEIVED = KAPOTT
+RRI = MR
+SLN = LCSA
+SYD = ÉSZÖ
+TBILLEQ = KJEGY.EGYENÉRT
+TBILLPRICE = KJEGY.ÁR
+TBILLYIELD = KJEGY.HOZAM
+VDB = ÉCSRI
+XIRR = XBMR
+XNPV = XNJÉ
+YIELD = HOZAM
+YIELDDISC = HOZAM.LESZÁM
+YIELDMAT = HOZAM.LEJÁRAT
+
+##
+## Információs függvények (Information Functions)
+##
+CELL = CELLA
+ERROR.TYPE = HIBA.TÍPUS
+INFO = INFÓ
+ISBLANK = ÜRES
+ISERR = HIBA.E
+ISERROR = HIBÁS
+ISEVEN = PÁROSE
+ISFORMULA = KÉPLET
+ISLOGICAL = LOGIKAI
+ISNA = NINCS
+ISNONTEXT = NEM.SZÖVEG
+ISNUMBER = SZÁM
+ISODD = PÁRATLANE
+ISREF = HIVATKOZÁS
+ISTEXT = SZÖVEG.E
+N = S
+NA = HIÁNYZIK
+SHEET = LAP
+SHEETS = LAPOK
+TYPE = TÍPUS
+
+##
+## Logikai függvények (Logical Functions)
+##
+AND = ÉS
+FALSE = HAMIS
+IF = HA
+IFERROR = HAHIBA
+IFNA = HAHIÁNYZIK
+IFS = HAELSŐIGAZ
+NOT = NEM
+OR = VAGY
+SWITCH = ÁTVÁLT
+TRUE = IGAZ
+XOR = XVAGY
+
+##
+## Keresési és hivatkozási függvények (Lookup & Reference Functions)
+##
+ADDRESS = CÍM
+AREAS = TERÜLET
+CHOOSE = VÁLASZT
+COLUMN = OSZLOP
+COLUMNS = OSZLOPOK
+FORMULATEXT = KÉPLETSZÖVEG
+GETPIVOTDATA = KIMUTATÁSADATOT.VESZ
+HLOOKUP = VKERES
+HYPERLINK = HIPERHIVATKOZÁS
+INDEX = INDEX
+INDIRECT = INDIREKT
+LOOKUP = KERES
+MATCH = HOL.VAN
+OFFSET = ELTOLÁS
+ROW = SOR
+ROWS = SOROK
+RTD = VIA
+TRANSPOSE = TRANSZPONÁLÁS
+VLOOKUP = FKERES
+*RC = SO
+
+##
+## Matematikai és trigonometrikus függvények (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = ARCCOS
+ACOSH = ACOSH
+ACOT = ARCCOT
+ACOTH = ARCCOTH
+AGGREGATE = ÖSSZESÍT
+ARABIC = ARAB
+ASIN = ARCSIN
+ASINH = ASINH
+ATAN = ARCTAN
+ATAN2 = ARCTAN2
+ATANH = ATANH
+BASE = ALAP
+CEILING.MATH = PLAFON.MAT
+CEILING.PRECISE = PLAFON.PONTOS
+COMBIN = KOMBINÁCIÓK
+COMBINA = KOMBINÁCIÓK.ISM
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = CSC
+CSCH = CSCH
+DECIMAL = TIZEDES
+DEGREES = FOK
+ECMA.CEILING = ECMA.PLAFON
+EVEN = PÁROS
+EXP = KITEVŐ
+FACT = FAKT
+FACTDOUBLE = FAKTDUPLA
+FLOOR.MATH = PADLÓ.MAT
+FLOOR.PRECISE = PADLÓ.PONTOS
+GCD = LKO
+INT = INT
+ISO.CEILING = ISO.PLAFON
+LCM = LKT
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = MDETERM
+MINVERSE = INVERZ.MÁTRIX
+MMULT = MSZORZAT
+MOD = MARADÉK
+MROUND = TÖBBSZ.KEREKÍT
+MULTINOMIAL = SZORHÁNYFAKT
+MUNIT = MMÁTRIX
+ODD = PÁRATLAN
+PI = PI
+POWER = HATVÁNY
+PRODUCT = SZORZAT
+QUOTIENT = KVÓCIENS
+RADIANS = RADIÁN
+RAND = VÉL
+RANDBETWEEN = VÉLETLEN.KÖZÖTT
+ROMAN = RÓMAI
+ROUND = KEREKÍTÉS
+ROUNDBAHTDOWN = BAHTKEREK.LE
+ROUNDBAHTUP = BAHTKEREK.FEL
+ROUNDDOWN = KEREK.LE
+ROUNDUP = KEREK.FEL
+SEC = SEC
+SECH = SECH
+SERIESSUM = SORÖSSZEG
+SIGN = ELŐJEL
+SIN = SIN
+SINH = SINH
+SQRT = GYÖK
+SQRTPI = GYÖKPI
+SUBTOTAL = RÉSZÖSSZEG
+SUM = SZUM
+SUMIF = SZUMHA
+SUMIFS = SZUMHATÖBB
+SUMPRODUCT = SZORZATÖSSZEG
+SUMSQ = NÉGYZETÖSSZEG
+SUMX2MY2 = SZUMX2BŐLY2
+SUMX2PY2 = SZUMX2MEGY2
+SUMXMY2 = SZUMXBŐLY2
+TAN = TAN
+TANH = TANH
+TRUNC = CSONK
+
+##
+## Statisztikai függvények (Statistical Functions)
+##
+AVEDEV = ÁTL.ELTÉRÉS
+AVERAGE = ÁTLAG
+AVERAGEA = ÁTLAGA
+AVERAGEIF = ÁTLAGHA
+AVERAGEIFS = ÁTLAGHATÖBB
+BETA.DIST = BÉTA.ELOSZL
+BETA.INV = BÉTA.INVERZ
+BINOM.DIST = BINOM.ELOSZL
+BINOM.DIST.RANGE = BINOM.ELOSZL.TART
+BINOM.INV = BINOM.INVERZ
+CHISQ.DIST = KHINÉGYZET.ELOSZLÁS
+CHISQ.DIST.RT = KHINÉGYZET.ELOSZLÁS.JOBB
+CHISQ.INV = KHINÉGYZET.INVERZ
+CHISQ.INV.RT = KHINÉGYZET.INVERZ.JOBB
+CHISQ.TEST = KHINÉGYZET.PRÓBA
+CONFIDENCE.NORM = MEGBÍZHATÓSÁG.NORM
+CONFIDENCE.T = MEGBÍZHATÓSÁG.T
+CORREL = KORREL
+COUNT = DARAB
+COUNTA = DARAB2
+COUNTBLANK = DARABÜRES
+COUNTIF = DARABTELI
+COUNTIFS = DARABHATÖBB
+COVARIANCE.P = KOVARIANCIA.S
+COVARIANCE.S = KOVARIANCIA.M
+DEVSQ = SQ
+EXPON.DIST = EXP.ELOSZL
+F.DIST = F.ELOSZL
+F.DIST.RT = F.ELOSZLÁS.JOBB
+F.INV = F.INVERZ
+F.INV.RT = F.INVERZ.JOBB
+F.TEST = F.PRÓB
+FISHER = FISHER
+FISHERINV = INVERZ.FISHER
+FORECAST.ETS = ELŐREJELZÉS.ESIM
+FORECAST.ETS.CONFINT = ELŐREJELZÉS.ESIM.KONFINT
+FORECAST.ETS.SEASONALITY = ELŐREJELZÉS.ESIM.SZEZONALITÁS
+FORECAST.ETS.STAT = ELŐREJELZÉS.ESIM.STAT
+FORECAST.LINEAR = ELŐREJELZÉS.LINEÁRIS
+FREQUENCY = GYAKORISÁG
+GAMMA = GAMMA
+GAMMA.DIST = GAMMA.ELOSZL
+GAMMA.INV = GAMMA.INVERZ
+GAMMALN = GAMMALN
+GAMMALN.PRECISE = GAMMALN.PONTOS
+GAUSS = GAUSS
+GEOMEAN = MÉRTANI.KÖZÉP
+GROWTH = NÖV
+HARMEAN = HARM.KÖZÉP
+HYPGEOM.DIST = HIPGEOM.ELOSZLÁS
+INTERCEPT = METSZ
+KURT = CSÚCSOSSÁG
+LARGE = NAGY
+LINEST = LIN.ILL
+LOGEST = LOG.ILL
+LOGNORM.DIST = LOGNORM.ELOSZLÁS
+LOGNORM.INV = LOGNORM.INVERZ
+MAX = MAX
+MAXA = MAXA
+MAXIFS = MAXHA
+MEDIAN = MEDIÁN
+MIN = MIN
+MINA = MIN2
+MINIFS = MINHA
+MODE.MULT = MÓDUSZ.TÖBB
+MODE.SNGL = MÓDUSZ.EGY
+NEGBINOM.DIST = NEGBINOM.ELOSZLÁS
+NORM.DIST = NORM.ELOSZLÁS
+NORM.INV = NORM.INVERZ
+NORM.S.DIST = NORM.S.ELOSZLÁS
+NORM.S.INV = NORM.S.INVERZ
+PEARSON = PEARSON
+PERCENTILE.EXC = PERCENTILIS.KIZÁR
+PERCENTILE.INC = PERCENTILIS.TARTALMAZ
+PERCENTRANK.EXC = SZÁZALÉKRANG.KIZÁR
+PERCENTRANK.INC = SZÁZALÉKRANG.TARTALMAZ
+PERMUT = VARIÁCIÓK
+PERMUTATIONA = VARIÁCIÓK.ISM
+PHI = FI
+POISSON.DIST = POISSON.ELOSZLÁS
+PROB = VALÓSZÍNŰSÉG
+QUARTILE.EXC = KVARTILIS.KIZÁR
+QUARTILE.INC = KVARTILIS.TARTALMAZ
+RANK.AVG = RANG.ÁTL
+RANK.EQ = RANG.EGY
+RSQ = RNÉGYZET
+SKEW = FERDESÉG
+SKEW.P = FERDESÉG.P
+SLOPE = MEREDEKSÉG
+SMALL = KICSI
+STANDARDIZE = NORMALIZÁLÁS
+STDEV.P = SZÓR.S
+STDEV.S = SZÓR.M
+STDEVA = SZÓRÁSA
+STDEVPA = SZÓRÁSPA
+STEYX = STHIBAYX
+T.DIST = T.ELOSZL
+T.DIST.2T = T.ELOSZLÁS.2SZ
+T.DIST.RT = T.ELOSZLÁS.JOBB
+T.INV = T.INVERZ
+T.INV.2T = T.INVERZ.2SZ
+T.TEST = T.PRÓB
+TREND = TREND
+TRIMMEAN = RÉSZÁTLAG
+VAR.P = VAR.S
+VAR.S = VAR.M
+VARA = VARA
+VARPA = VARPA
+WEIBULL.DIST = WEIBULL.ELOSZLÁS
+Z.TEST = Z.PRÓB
+
+##
+## Szövegműveletekhez használható függvények (Text Functions)
+##
+BAHTTEXT = BAHTSZÖVEG
+CHAR = KARAKTER
+CLEAN = TISZTÍT
+CODE = KÓD
+CONCAT = FŰZ
+DOLLAR = FORINT
+EXACT = AZONOS
+FIND = SZÖVEG.TALÁL
+FIXED = FIX
+ISTHAIDIGIT = ON.THAI.NUMERO
+LEFT = BAL
+LEN = HOSSZ
+LOWER = KISBETŰ
+MID = KÖZÉP
+NUMBERSTRING = SZÁM.BETŰVEL
+NUMBERVALUE = SZÁMÉRTÉK
+PHONETIC = FONETIKUS
+PROPER = TNÉV
+REPLACE = CSERE
+REPT = SOKSZOR
+RIGHT = JOBB
+SEARCH = SZÖVEG.KERES
+SUBSTITUTE = HELYETTE
+T = T
+TEXT = SZÖVEG
+TEXTJOIN = SZÖVEGÖSSZEFŰZÉS
+THAIDIGIT = THAISZÁM
+THAINUMSOUND = THAISZÁMHANG
+THAINUMSTRING = THAISZÁMKAR
+THAISTRINGLENGTH = THAIKARHOSSZ
+TRIM = KIMETSZ
+UNICHAR = UNIKARAKTER
+UNICODE = UNICODE
+UPPER = NAGYBETŰS
+VALUE = ÉRTÉK
+
+##
+## Webes függvények (Web Functions)
+##
+ENCODEURL = URL.KÓDOL
+FILTERXML = XMLSZŰRÉS
+WEBSERVICE = WEBSZOLGÁLTATÁS
+
+##
+## Kompatibilitási függvények (Compatibility Functions)
+##
+BETADIST = BÉTA.ELOSZLÁS
+BETAINV = INVERZ.BÉTA
+BINOMDIST = BINOM.ELOSZLÁS
+CEILING = PLAFON
+CHIDIST = KHI.ELOSZLÁS
+CHIINV = INVERZ.KHI
+CHITEST = KHI.PRÓBA
+CONCATENATE = ÖSSZEFŰZ
+CONFIDENCE = MEGBÍZHATÓSÁG
+COVAR = KOVAR
+CRITBINOM = KRITBINOM
+EXPONDIST = EXP.ELOSZLÁS
+FDIST = F.ELOSZLÁS
+FINV = INVERZ.F
+FLOOR = PADLÓ
+FORECAST = ELŐREJELZÉS
+FTEST = F.PRÓBA
+GAMMADIST = GAMMA.ELOSZLÁS
+GAMMAINV = INVERZ.GAMMA
+HYPGEOMDIST = HIPERGEOM.ELOSZLÁS
+LOGINV = INVERZ.LOG.ELOSZLÁS
+LOGNORMDIST = LOG.ELOSZLÁS
+MODE = MÓDUSZ
+NEGBINOMDIST = NEGBINOM.ELOSZL
+NORMDIST = NORM.ELOSZL
+NORMINV = INVERZ.NORM
+NORMSDIST = STNORMELOSZL
+NORMSINV = INVERZ.STNORM
+PERCENTILE = PERCENTILIS
+PERCENTRANK = SZÁZALÉKRANG
+POISSON = POISSON
+QUARTILE = KVARTILIS
+RANK = SORSZÁM
+STDEV = SZÓRÁS
+STDEVP = SZÓRÁSP
+TDIST = T.ELOSZLÁS
+TINV = INVERZ.T
+TTEST = T.PRÓBA
+VAR = VAR
+VARP = VARP
+WEIBULL = WEIBULL
+ZTEST = Z.PRÓBA
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/it/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/it/config
new file mode 100644
index 00000000..5c1e4955
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/it/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Italiano (Italian)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL
+DIV0
+VALUE = #VALORE!
+REF = #RIF!
+NAME = #NOME?
+NUM
+NA = #N/D
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/it/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/it/functions
new file mode 100644
index 00000000..c14ed85f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/it/functions
@@ -0,0 +1,537 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Italiano (Italian)
+##
+############################################################
+
+
+##
+## Funzioni cubo (Cube Functions)
+##
+CUBEKPIMEMBER = MEMBRO.KPI.CUBO
+CUBEMEMBER = MEMBRO.CUBO
+CUBEMEMBERPROPERTY = PROPRIETÀ.MEMBRO.CUBO
+CUBERANKEDMEMBER = MEMBRO.CUBO.CON.RANGO
+CUBESET = SET.CUBO
+CUBESETCOUNT = CONTA.SET.CUBO
+CUBEVALUE = VALORE.CUBO
+
+##
+## Funzioni di database (Database Functions)
+##
+DAVERAGE = DB.MEDIA
+DCOUNT = DB.CONTA.NUMERI
+DCOUNTA = DB.CONTA.VALORI
+DGET = DB.VALORI
+DMAX = DB.MAX
+DMIN = DB.MIN
+DPRODUCT = DB.PRODOTTO
+DSTDEV = DB.DEV.ST
+DSTDEVP = DB.DEV.ST.POP
+DSUM = DB.SOMMA
+DVAR = DB.VAR
+DVARP = DB.VAR.POP
+
+##
+## Funzioni data e ora (Date & Time Functions)
+##
+DATE = DATA
+DATEDIF = DATA.DIFF
+DATESTRING = DATA.STRINGA
+DATEVALUE = DATA.VALORE
+DAY = GIORNO
+DAYS = GIORNI
+DAYS360 = GIORNO360
+EDATE = DATA.MESE
+EOMONTH = FINE.MESE
+HOUR = ORA
+ISOWEEKNUM = NUM.SETTIMANA.ISO
+MINUTE = MINUTO
+MONTH = MESE
+NETWORKDAYS = GIORNI.LAVORATIVI.TOT
+NETWORKDAYS.INTL = GIORNI.LAVORATIVI.TOT.INTL
+NOW = ADESSO
+SECOND = SECONDO
+THAIDAYOFWEEK = THAIGIORNODELLASETTIMANA
+THAIMONTHOFYEAR = THAIMESEDELLANNO
+THAIYEAR = THAIANNO
+TIME = ORARIO
+TIMEVALUE = ORARIO.VALORE
+TODAY = OGGI
+WEEKDAY = GIORNO.SETTIMANA
+WEEKNUM = NUM.SETTIMANA
+WORKDAY = GIORNO.LAVORATIVO
+WORKDAY.INTL = GIORNO.LAVORATIVO.INTL
+YEAR = ANNO
+YEARFRAC = FRAZIONE.ANNO
+
+##
+## Funzioni ingegneristiche (Engineering Functions)
+##
+BESSELI = BESSEL.I
+BESSELJ = BESSEL.J
+BESSELK = BESSEL.K
+BESSELY = BESSEL.Y
+BIN2DEC = BINARIO.DECIMALE
+BIN2HEX = BINARIO.HEX
+BIN2OCT = BINARIO.OCT
+BITAND = BITAND
+BITLSHIFT = BIT.SPOSTA.SX
+BITOR = BITOR
+BITRSHIFT = BIT.SPOSTA.DX
+BITXOR = BITXOR
+COMPLEX = COMPLESSO
+CONVERT = CONVERTI
+DEC2BIN = DECIMALE.BINARIO
+DEC2HEX = DECIMALE.HEX
+DEC2OCT = DECIMALE.OCT
+DELTA = DELTA
+ERF = FUNZ.ERRORE
+ERF.PRECISE = FUNZ.ERRORE.PRECISA
+ERFC = FUNZ.ERRORE.COMP
+ERFC.PRECISE = FUNZ.ERRORE.COMP.PRECISA
+GESTEP = SOGLIA
+HEX2BIN = HEX.BINARIO
+HEX2DEC = HEX.DECIMALE
+HEX2OCT = HEX.OCT
+IMABS = COMP.MODULO
+IMAGINARY = COMP.IMMAGINARIO
+IMARGUMENT = COMP.ARGOMENTO
+IMCONJUGATE = COMP.CONIUGATO
+IMCOS = COMP.COS
+IMCOSH = COMP.COSH
+IMCOT = COMP.COT
+IMCSC = COMP.CSC
+IMCSCH = COMP.CSCH
+IMDIV = COMP.DIV
+IMEXP = COMP.EXP
+IMLN = COMP.LN
+IMLOG10 = COMP.LOG10
+IMLOG2 = COMP.LOG2
+IMPOWER = COMP.POTENZA
+IMPRODUCT = COMP.PRODOTTO
+IMREAL = COMP.PARTE.REALE
+IMSEC = COMP.SEC
+IMSECH = COMP.SECH
+IMSIN = COMP.SEN
+IMSINH = COMP.SENH
+IMSQRT = COMP.RADQ
+IMSUB = COMP.DIFF
+IMSUM = COMP.SOMMA
+IMTAN = COMP.TAN
+OCT2BIN = OCT.BINARIO
+OCT2DEC = OCT.DECIMALE
+OCT2HEX = OCT.HEX
+
+##
+## Funzioni finanziarie (Financial Functions)
+##
+ACCRINT = INT.MATURATO.PER
+ACCRINTM = INT.MATURATO.SCAD
+AMORDEGRC = AMMORT.DEGR
+AMORLINC = AMMORT.PER
+COUPDAYBS = GIORNI.CED.INIZ.LIQ
+COUPDAYS = GIORNI.CED
+COUPDAYSNC = GIORNI.CED.NUOVA
+COUPNCD = DATA.CED.SUCC
+COUPNUM = NUM.CED
+COUPPCD = DATA.CED.PREC
+CUMIPMT = INT.CUMUL
+CUMPRINC = CAP.CUM
+DB = AMMORT.FISSO
+DDB = AMMORT
+DISC = TASSO.SCONTO
+DOLLARDE = VALUTA.DEC
+DOLLARFR = VALUTA.FRAZ
+DURATION = DURATA
+EFFECT = EFFETTIVO
+FV = VAL.FUT
+FVSCHEDULE = VAL.FUT.CAPITALE
+INTRATE = TASSO.INT
+IPMT = INTERESSI
+IRR = TIR.COST
+ISPMT = INTERESSE.RATA
+MDURATION = DURATA.M
+MIRR = TIR.VAR
+NOMINAL = NOMINALE
+NPER = NUM.RATE
+NPV = VAN
+ODDFPRICE = PREZZO.PRIMO.IRR
+ODDFYIELD = REND.PRIMO.IRR
+ODDLPRICE = PREZZO.ULTIMO.IRR
+ODDLYIELD = REND.ULTIMO.IRR
+PDURATION = DURATA.P
+PMT = RATA
+PPMT = P.RATA
+PRICE = PREZZO
+PRICEDISC = PREZZO.SCONT
+PRICEMAT = PREZZO.SCAD
+PV = VA
+RATE = TASSO
+RECEIVED = RICEV.SCAD
+RRI = RIT.INVEST.EFFETT
+SLN = AMMORT.COST
+SYD = AMMORT.ANNUO
+TBILLEQ = BOT.EQUIV
+TBILLPRICE = BOT.PREZZO
+TBILLYIELD = BOT.REND
+VDB = AMMORT.VAR
+XIRR = TIR.X
+XNPV = VAN.X
+YIELD = REND
+YIELDDISC = REND.TITOLI.SCONT
+YIELDMAT = REND.SCAD
+
+##
+## Funzioni relative alle informazioni (Information Functions)
+##
+CELL = CELLA
+ERROR.TYPE = ERRORE.TIPO
+INFO = AMBIENTE.INFO
+ISBLANK = VAL.VUOTO
+ISERR = VAL.ERR
+ISERROR = VAL.ERRORE
+ISEVEN = VAL.PARI
+ISFORMULA = VAL.FORMULA
+ISLOGICAL = VAL.LOGICO
+ISNA = VAL.NON.DISP
+ISNONTEXT = VAL.NON.TESTO
+ISNUMBER = VAL.NUMERO
+ISODD = VAL.DISPARI
+ISREF = VAL.RIF
+ISTEXT = VAL.TESTO
+N = NUM
+NA = NON.DISP
+SHEET = FOGLIO
+SHEETS = FOGLI
+TYPE = TIPO
+
+##
+## Funzioni logiche (Logical Functions)
+##
+AND = E
+FALSE = FALSO
+IF = SE
+IFERROR = SE.ERRORE
+IFNA = SE.NON.DISP.
+IFS = PIÙ.SE
+NOT = NON
+OR = O
+SWITCH = SWITCH
+TRUE = VERO
+XOR = XOR
+
+##
+## Funzioni di ricerca e di riferimento (Lookup & Reference Functions)
+##
+ADDRESS = INDIRIZZO
+AREAS = AREE
+CHOOSE = SCEGLI
+COLUMN = RIF.COLONNA
+COLUMNS = COLONNE
+FORMULATEXT = TESTO.FORMULA
+GETPIVOTDATA = INFO.DATI.TAB.PIVOT
+HLOOKUP = CERCA.ORIZZ
+HYPERLINK = COLLEG.IPERTESTUALE
+INDEX = INDICE
+INDIRECT = INDIRETTO
+LOOKUP = CERCA
+MATCH = CONFRONTA
+OFFSET = SCARTO
+ROW = RIF.RIGA
+ROWS = RIGHE
+RTD = DATITEMPOREALE
+TRANSPOSE = MATR.TRASPOSTA
+VLOOKUP = CERCA.VERT
+
+##
+## Funzioni matematiche e trigonometriche (Math & Trig Functions)
+##
+ABS = ASS
+ACOS = ARCCOS
+ACOSH = ARCCOSH
+ACOT = ARCCOT
+ACOTH = ARCCOTH
+AGGREGATE = AGGREGA
+ARABIC = ARABO
+ASIN = ARCSEN
+ASINH = ARCSENH
+ATAN = ARCTAN
+ATAN2 = ARCTAN.2
+ATANH = ARCTANH
+BASE = BASE
+CEILING.MATH = ARROTONDA.ECCESSO.MAT
+CEILING.PRECISE = ARROTONDA.ECCESSO.PRECISA
+COMBIN = COMBINAZIONE
+COMBINA = COMBINAZIONE.VALORI
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = CSC
+CSCH = CSCH
+DECIMAL = DECIMALE
+DEGREES = GRADI
+ECMA.CEILING = ECMA.ARROTONDA.ECCESSO
+EVEN = PARI
+EXP = EXP
+FACT = FATTORIALE
+FACTDOUBLE = FATT.DOPPIO
+FLOOR.MATH = ARROTONDA.DIFETTO.MAT
+FLOOR.PRECISE = ARROTONDA.DIFETTO.PRECISA
+GCD = MCD
+INT = INT
+ISO.CEILING = ISO.ARROTONDA.ECCESSO
+LCM = MCM
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = MATR.DETERM
+MINVERSE = MATR.INVERSA
+MMULT = MATR.PRODOTTO
+MOD = RESTO
+MROUND = ARROTONDA.MULTIPLO
+MULTINOMIAL = MULTINOMIALE
+MUNIT = MATR.UNIT
+ODD = DISPARI
+PI = PI.GRECO
+POWER = POTENZA
+PRODUCT = PRODOTTO
+QUOTIENT = QUOZIENTE
+RADIANS = RADIANTI
+RAND = CASUALE
+RANDBETWEEN = CASUALE.TRA
+ROMAN = ROMANO
+ROUND = ARROTONDA
+ROUNDBAHTDOWN = ARROTBAHTGIU
+ROUNDBAHTUP = ARROTBAHTSU
+ROUNDDOWN = ARROTONDA.PER.DIF
+ROUNDUP = ARROTONDA.PER.ECC
+SEC = SEC
+SECH = SECH
+SERIESSUM = SOMMA.SERIE
+SIGN = SEGNO
+SIN = SEN
+SINH = SENH
+SQRT = RADQ
+SQRTPI = RADQ.PI.GRECO
+SUBTOTAL = SUBTOTALE
+SUM = SOMMA
+SUMIF = SOMMA.SE
+SUMIFS = SOMMA.PIÙ.SE
+SUMPRODUCT = MATR.SOMMA.PRODOTTO
+SUMSQ = SOMMA.Q
+SUMX2MY2 = SOMMA.DIFF.Q
+SUMX2PY2 = SOMMA.SOMMA.Q
+SUMXMY2 = SOMMA.Q.DIFF
+TAN = TAN
+TANH = TANH
+TRUNC = TRONCA
+
+##
+## Funzioni statistiche (Statistical Functions)
+##
+AVEDEV = MEDIA.DEV
+AVERAGE = MEDIA
+AVERAGEA = MEDIA.VALORI
+AVERAGEIF = MEDIA.SE
+AVERAGEIFS = MEDIA.PIÙ.SE
+BETA.DIST = DISTRIB.BETA.N
+BETA.INV = INV.BETA.N
+BINOM.DIST = DISTRIB.BINOM.N
+BINOM.DIST.RANGE = INTERVALLO.DISTRIB.BINOM.N.
+BINOM.INV = INV.BINOM
+CHISQ.DIST = DISTRIB.CHI.QUAD
+CHISQ.DIST.RT = DISTRIB.CHI.QUAD.DS
+CHISQ.INV = INV.CHI.QUAD
+CHISQ.INV.RT = INV.CHI.QUAD.DS
+CHISQ.TEST = TEST.CHI.QUAD
+CONFIDENCE.NORM = CONFIDENZA.NORM
+CONFIDENCE.T = CONFIDENZA.T
+CORREL = CORRELAZIONE
+COUNT = CONTA.NUMERI
+COUNTA = CONTA.VALORI
+COUNTBLANK = CONTA.VUOTE
+COUNTIF = CONTA.SE
+COUNTIFS = CONTA.PIÙ.SE
+COVARIANCE.P = COVARIANZA.P
+COVARIANCE.S = COVARIANZA.C
+DEVSQ = DEV.Q
+EXPON.DIST = DISTRIB.EXP.N
+F.DIST = DISTRIBF
+F.DIST.RT = DISTRIB.F.DS
+F.INV = INVF
+F.INV.RT = INV.F.DS
+F.TEST = TESTF
+FISHER = FISHER
+FISHERINV = INV.FISHER
+FORECAST.ETS = PREVISIONE.ETS
+FORECAST.ETS.CONFINT = PREVISIONE.ETS.INTCONF
+FORECAST.ETS.SEASONALITY = PREVISIONE.ETS.STAGIONALITÀ
+FORECAST.ETS.STAT = PREVISIONE.ETS.STAT
+FORECAST.LINEAR = PREVISIONE.LINEARE
+FREQUENCY = FREQUENZA
+GAMMA = GAMMA
+GAMMA.DIST = DISTRIB.GAMMA.N
+GAMMA.INV = INV.GAMMA.N
+GAMMALN = LN.GAMMA
+GAMMALN.PRECISE = LN.GAMMA.PRECISA
+GAUSS = GAUSS
+GEOMEAN = MEDIA.GEOMETRICA
+GROWTH = CRESCITA
+HARMEAN = MEDIA.ARMONICA
+HYPGEOM.DIST = DISTRIB.IPERGEOM.N
+INTERCEPT = INTERCETTA
+KURT = CURTOSI
+LARGE = GRANDE
+LINEST = REGR.LIN
+LOGEST = REGR.LOG
+LOGNORM.DIST = DISTRIB.LOGNORM.N
+LOGNORM.INV = INV.LOGNORM.N
+MAX = MAX
+MAXA = MAX.VALORI
+MAXIFS = MAX.PIÙ.SE
+MEDIAN = MEDIANA
+MIN = MIN
+MINA = MIN.VALORI
+MINIFS = MIN.PIÙ.SE
+MODE.MULT = MODA.MULT
+MODE.SNGL = MODA.SNGL
+NEGBINOM.DIST = DISTRIB.BINOM.NEG.N
+NORM.DIST = DISTRIB.NORM.N
+NORM.INV = INV.NORM.N
+NORM.S.DIST = DISTRIB.NORM.ST.N
+NORM.S.INV = INV.NORM.S
+PEARSON = PEARSON
+PERCENTILE.EXC = ESC.PERCENTILE
+PERCENTILE.INC = INC.PERCENTILE
+PERCENTRANK.EXC = ESC.PERCENT.RANGO
+PERCENTRANK.INC = INC.PERCENT.RANGO
+PERMUT = PERMUTAZIONE
+PERMUTATIONA = PERMUTAZIONE.VALORI
+PHI = PHI
+POISSON.DIST = DISTRIB.POISSON
+PROB = PROBABILITÀ
+QUARTILE.EXC = ESC.QUARTILE
+QUARTILE.INC = INC.QUARTILE
+RANK.AVG = RANGO.MEDIA
+RANK.EQ = RANGO.UG
+RSQ = RQ
+SKEW = ASIMMETRIA
+SKEW.P = ASIMMETRIA.P
+SLOPE = PENDENZA
+SMALL = PICCOLO
+STANDARDIZE = NORMALIZZA
+STDEV.P = DEV.ST.P
+STDEV.S = DEV.ST.C
+STDEVA = DEV.ST.VALORI
+STDEVPA = DEV.ST.POP.VALORI
+STEYX = ERR.STD.YX
+T.DIST = DISTRIB.T.N
+T.DIST.2T = DISTRIB.T.2T
+T.DIST.RT = DISTRIB.T.DS
+T.INV = INVT
+T.INV.2T = INV.T.2T
+T.TEST = TESTT
+TREND = TENDENZA
+TRIMMEAN = MEDIA.TRONCATA
+VAR.P = VAR.P
+VAR.S = VAR.C
+VARA = VAR.VALORI
+VARPA = VAR.POP.VALORI
+WEIBULL.DIST = DISTRIB.WEIBULL
+Z.TEST = TESTZ
+
+##
+## Funzioni di testo (Text Functions)
+##
+BAHTTEXT = BAHTTESTO
+CHAR = CODICE.CARATT
+CLEAN = LIBERA
+CODE = CODICE
+CONCAT = CONCAT
+DOLLAR = VALUTA
+EXACT = IDENTICO
+FIND = TROVA
+FIXED = FISSO
+ISTHAIDIGIT = ÈTHAICIFRA
+LEFT = SINISTRA
+LEN = LUNGHEZZA
+LOWER = MINUSC
+MID = STRINGA.ESTRAI
+NUMBERSTRING = NUMERO.STRINGA
+NUMBERVALUE = NUMERO.VALORE
+PHONETIC = FURIGANA
+PROPER = MAIUSC.INIZ
+REPLACE = RIMPIAZZA
+REPT = RIPETI
+RIGHT = DESTRA
+SEARCH = RICERCA
+SUBSTITUTE = SOSTITUISCI
+T = T
+TEXT = TESTO
+TEXTJOIN = TESTO.UNISCI
+THAIDIGIT = THAICIFRA
+THAINUMSOUND = THAINUMSUONO
+THAINUMSTRING = THAISZÁMKAR
+THAISTRINGLENGTH = THAILUNGSTRINGA
+TRIM = ANNULLA.SPAZI
+UNICHAR = CARATT.UNI
+UNICODE = UNICODE
+UPPER = MAIUSC
+VALUE = VALORE
+
+##
+## Funzioni Web (Web Functions)
+##
+ENCODEURL = CODIFICA.URL
+FILTERXML = FILTRO.XML
+WEBSERVICE = SERVIZIO.WEB
+
+##
+## Funzioni di compatibilità (Compatibility Functions)
+##
+BETADIST = DISTRIB.BETA
+BETAINV = INV.BETA
+BINOMDIST = DISTRIB.BINOM
+CEILING = ARROTONDA.ECCESSO
+CHIDIST = DISTRIB.CHI
+CHIINV = INV.CHI
+CHITEST = TEST.CHI
+CONCATENATE = CONCATENA
+CONFIDENCE = CONFIDENZA
+COVAR = COVARIANZA
+CRITBINOM = CRIT.BINOM
+EXPONDIST = DISTRIB.EXP
+FDIST = DISTRIB.F
+FINV = INV.F
+FLOOR = ARROTONDA.DIFETTO
+FORECAST = PREVISIONE
+FTEST = TEST.F
+GAMMADIST = DISTRIB.GAMMA
+GAMMAINV = INV.GAMMA
+HYPGEOMDIST = DISTRIB.IPERGEOM
+LOGINV = INV.LOGNORM
+LOGNORMDIST = DISTRIB.LOGNORM
+MODE = MODA
+NEGBINOMDIST = DISTRIB.BINOM.NEG
+NORMDIST = DISTRIB.NORM
+NORMINV = INV.NORM
+NORMSDIST = DISTRIB.NORM.ST
+NORMSINV = INV.NORM.ST
+PERCENTILE = PERCENTILE
+PERCENTRANK = PERCENT.RANGO
+POISSON = POISSON
+QUARTILE = QUARTILE
+RANK = RANGO
+STDEV = DEV.ST
+STDEVP = DEV.ST.POP
+TDIST = DISTRIB.T
+TINV = INV.T
+TTEST = TEST.T
+VAR = VAR
+VARP = VAR.POP
+WEIBULL = WEIBULL
+ZTEST = TEST.Z
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/nb/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/nb/config
new file mode 100644
index 00000000..a7f3be17
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/nb/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Norsk Bokmål (Norwegian Bokmål)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL
+DIV0
+VALUE = #VERDI!
+REF
+NAME = #NAVN?
+NUM
+NA = #N/D
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/nb/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/nb/functions
new file mode 100644
index 00000000..d352e1f4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/nb/functions
@@ -0,0 +1,539 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Norsk Bokmål (Norwegian Bokmål)
+##
+############################################################
+
+
+##
+## Kubefunksjoner (Cube Functions)
+##
+CUBEKPIMEMBER = KUBEKPIMEDLEM
+CUBEMEMBER = KUBEMEDLEM
+CUBEMEMBERPROPERTY = KUBEMEDLEMEGENSKAP
+CUBERANKEDMEMBER = KUBERANGERTMEDLEM
+CUBESET = KUBESETT
+CUBESETCOUNT = KUBESETTANTALL
+CUBEVALUE = KUBEVERDI
+
+##
+## Databasefunksjoner (Database Functions)
+##
+DAVERAGE = DGJENNOMSNITT
+DCOUNT = DANTALL
+DCOUNTA = DANTALLA
+DGET = DHENT
+DMAX = DMAKS
+DMIN = DMIN
+DPRODUCT = DPRODUKT
+DSTDEV = DSTDAV
+DSTDEVP = DSTDAVP
+DSUM = DSUMMER
+DVAR = DVARIANS
+DVARP = DVARIANSP
+
+##
+## Dato- og tidsfunksjoner (Date & Time Functions)
+##
+DATE = DATO
+DATEDIF = DATODIFF
+DATESTRING = DATOSTRENG
+DATEVALUE = DATOVERDI
+DAY = DAG
+DAYS = DAGER
+DAYS360 = DAGER360
+EDATE = DAG.ETTER
+EOMONTH = MÅNEDSSLUTT
+HOUR = TIME
+ISOWEEKNUM = ISOUKENR
+MINUTE = MINUTT
+MONTH = MÅNED
+NETWORKDAYS = NETT.ARBEIDSDAGER
+NETWORKDAYS.INTL = NETT.ARBEIDSDAGER.INTL
+NOW = NÅ
+SECOND = SEKUND
+THAIDAYOFWEEK = THAIUKEDAG
+THAIMONTHOFYEAR = THAIMÅNED
+THAIYEAR = THAIÅR
+TIME = TID
+TIMEVALUE = TIDSVERDI
+TODAY = IDAG
+WEEKDAY = UKEDAG
+WEEKNUM = UKENR
+WORKDAY = ARBEIDSDAG
+WORKDAY.INTL = ARBEIDSDAG.INTL
+YEAR = ÅR
+YEARFRAC = ÅRDEL
+
+##
+## Tekniske funksjoner (Engineering Functions)
+##
+BESSELI = BESSELI
+BESSELJ = BESSELJ
+BESSELK = BESSELK
+BESSELY = BESSELY
+BIN2DEC = BINTILDES
+BIN2HEX = BINTILHEKS
+BIN2OCT = BINTILOKT
+BITAND = BITOG
+BITLSHIFT = BITVFORSKYV
+BITOR = BITELLER
+BITRSHIFT = BITHFORSKYV
+BITXOR = BITEKSKLUSIVELLER
+COMPLEX = KOMPLEKS
+CONVERT = KONVERTER
+DEC2BIN = DESTILBIN
+DEC2HEX = DESTILHEKS
+DEC2OCT = DESTILOKT
+DELTA = DELTA
+ERF = FEILF
+ERF.PRECISE = FEILF.PRESIS
+ERFC = FEILFK
+ERFC.PRECISE = FEILFK.PRESIS
+GESTEP = GRENSEVERDI
+HEX2BIN = HEKSTILBIN
+HEX2DEC = HEKSTILDES
+HEX2OCT = HEKSTILOKT
+IMABS = IMABS
+IMAGINARY = IMAGINÆR
+IMARGUMENT = IMARGUMENT
+IMCONJUGATE = IMKONJUGERT
+IMCOS = IMCOS
+IMCOSH = IMCOSH
+IMCOT = IMCOT
+IMCSC = IMCSC
+IMCSCH = IMCSCH
+IMDIV = IMDIV
+IMEXP = IMEKSP
+IMLN = IMLN
+IMLOG10 = IMLOG10
+IMLOG2 = IMLOG2
+IMPOWER = IMOPPHØY
+IMPRODUCT = IMPRODUKT
+IMREAL = IMREELL
+IMSEC = IMSEC
+IMSECH = IMSECH
+IMSIN = IMSIN
+IMSINH = IMSINH
+IMSQRT = IMROT
+IMSUB = IMSUB
+IMSUM = IMSUMMER
+IMTAN = IMTAN
+OCT2BIN = OKTTILBIN
+OCT2DEC = OKTTILDES
+OCT2HEX = OKTTILHEKS
+
+##
+## Økonomiske funksjoner (Financial Functions)
+##
+ACCRINT = PÅLØPT.PERIODISK.RENTE
+ACCRINTM = PÅLØPT.FORFALLSRENTE
+AMORDEGRC = AMORDEGRC
+AMORLINC = AMORLINC
+COUPDAYBS = OBLIG.DAGER.FF
+COUPDAYS = OBLIG.DAGER
+COUPDAYSNC = OBLIG.DAGER.NF
+COUPNCD = OBLIG.DAGER.EF
+COUPNUM = OBLIG.ANTALL
+COUPPCD = OBLIG.DAG.FORRIGE
+CUMIPMT = SAMLET.RENTE
+CUMPRINC = SAMLET.HOVEDSTOL
+DB = DAVSKR
+DDB = DEGRAVS
+DISC = DISKONTERT
+DOLLARDE = DOLLARDE
+DOLLARFR = DOLLARBR
+DURATION = VARIGHET
+EFFECT = EFFEKTIV.RENTE
+FV = SLUTTVERDI
+FVSCHEDULE = SVPLAN
+INTRATE = RENTESATS
+IPMT = RAVDRAG
+IRR = IR
+ISPMT = ER.AVDRAG
+MDURATION = MVARIGHET
+MIRR = MODIR
+NOMINAL = NOMINELL
+NPER = PERIODER
+NPV = NNV
+ODDFPRICE = AVVIKFP.PRIS
+ODDFYIELD = AVVIKFP.AVKASTNING
+ODDLPRICE = AVVIKSP.PRIS
+ODDLYIELD = AVVIKSP.AVKASTNING
+PDURATION = PVARIGHET
+PMT = AVDRAG
+PPMT = AMORT
+PRICE = PRIS
+PRICEDISC = PRIS.DISKONTERT
+PRICEMAT = PRIS.FORFALL
+PV = NÅVERDI
+RATE = RENTE
+RECEIVED = MOTTATT.AVKAST
+RRI = REALISERT.AVKASTNING
+SLN = LINAVS
+SYD = ÅRSAVS
+TBILLEQ = TBILLEKV
+TBILLPRICE = TBILLPRIS
+TBILLYIELD = TBILLAVKASTNING
+VDB = VERDIAVS
+XIRR = XIR
+XNPV = XNNV
+YIELD = AVKAST
+YIELDDISC = AVKAST.DISKONTERT
+YIELDMAT = AVKAST.FORFALL
+
+##
+## Informasjonsfunksjoner (Information Functions)
+##
+CELL = CELLE
+ERROR.TYPE = FEIL.TYPE
+INFO = INFO
+ISBLANK = ERTOM
+ISERR = ERF
+ISERROR = ERFEIL
+ISEVEN = ERPARTALL
+ISFORMULA = ERFORMEL
+ISLOGICAL = ERLOGISK
+ISNA = ERIT
+ISNONTEXT = ERIKKETEKST
+ISNUMBER = ERTALL
+ISODD = ERODDE
+ISREF = ERREF
+ISTEXT = ERTEKST
+N = N
+NA = IT
+SHEET = ARK
+SHEETS = ANTALL.ARK
+TYPE = VERDITYPE
+
+##
+## Logiske funksjoner (Logical Functions)
+##
+AND = OG
+FALSE = USANN
+IF = HVIS
+IFERROR = HVISFEIL
+IFNA = HVIS.IT
+IFS = HVIS.SETT
+NOT = IKKE
+OR = ELLER
+SWITCH = BRYTER
+TRUE = SANN
+XOR = EKSKLUSIVELLER
+
+##
+## Oppslag- og referansefunksjoner (Lookup & Reference Functions)
+##
+ADDRESS = ADRESSE
+AREAS = OMRÅDER
+CHOOSE = VELG
+COLUMN = KOLONNE
+COLUMNS = KOLONNER
+FORMULATEXT = FORMELTEKST
+GETPIVOTDATA = HENTPIVOTDATA
+HLOOKUP = FINN.KOLONNE
+HYPERLINK = HYPERKOBLING
+INDEX = INDEKS
+INDIRECT = INDIREKTE
+LOOKUP = SLÅ.OPP
+MATCH = SAMMENLIGNE
+OFFSET = FORSKYVNING
+ROW = RAD
+ROWS = RADER
+RTD = RTD
+TRANSPOSE = TRANSPONER
+VLOOKUP = FINN.RAD
+*RC = RK
+
+##
+## Matematikk- og trigonometrifunksjoner (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = ARCCOS
+ACOSH = ARCCOSH
+ACOT = ACOT
+ACOTH = ACOTH
+AGGREGATE = MENGDE
+ARABIC = ARABISK
+ASIN = ARCSIN
+ASINH = ARCSINH
+ATAN = ARCTAN
+ATAN2 = ARCTAN2
+ATANH = ARCTANH
+BASE = GRUNNTALL
+CEILING.MATH = AVRUND.GJELDENDE.MULTIPLUM.OPP.MATEMATISK
+CEILING.PRECISE = AVRUND.GJELDENDE.MULTIPLUM.PRESIS
+COMBIN = KOMBINASJON
+COMBINA = KOMBINASJONA
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = CSC
+CSCH = CSCH
+DECIMAL = DESIMAL
+DEGREES = GRADER
+ECMA.CEILING = ECMA.AVRUND.GJELDENDE.MULTIPLUM
+EVEN = AVRUND.TIL.PARTALL
+EXP = EKSP
+FACT = FAKULTET
+FACTDOUBLE = DOBBELFAKT
+FLOOR.MATH = AVRUND.GJELDENDE.MULTIPLUM.NED.MATEMATISK
+FLOOR.PRECISE = AVRUND.GJELDENDE.MULTIPLUM.NED.PRESIS
+GCD = SFF
+INT = HELTALL
+ISO.CEILING = ISO.AVRUND.GJELDENDE.MULTIPLUM
+LCM = MFM
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = MDETERM
+MINVERSE = MINVERS
+MMULT = MMULT
+MOD = REST
+MROUND = MRUND
+MULTINOMIAL = MULTINOMINELL
+MUNIT = MENHET
+ODD = AVRUND.TIL.ODDETALL
+PI = PI
+POWER = OPPHØYD.I
+PRODUCT = PRODUKT
+QUOTIENT = KVOTIENT
+RADIANS = RADIANER
+RAND = TILFELDIG
+RANDBETWEEN = TILFELDIGMELLOM
+ROMAN = ROMERTALL
+ROUND = AVRUND
+ROUNDBAHTDOWN = RUNDAVBAHTNEDOVER
+ROUNDBAHTUP = RUNDAVBAHTOPPOVER
+ROUNDDOWN = AVRUND.NED
+ROUNDUP = AVRUND.OPP
+SEC = SEC
+SECH = SECH
+SERIESSUM = SUMMER.REKKE
+SIGN = FORTEGN
+SIN = SIN
+SINH = SINH
+SQRT = ROT
+SQRTPI = ROTPI
+SUBTOTAL = DELSUM
+SUM = SUMMER
+SUMIF = SUMMERHVIS
+SUMIFS = SUMMER.HVIS.SETT
+SUMPRODUCT = SUMMERPRODUKT
+SUMSQ = SUMMERKVADRAT
+SUMX2MY2 = SUMMERX2MY2
+SUMX2PY2 = SUMMERX2PY2
+SUMXMY2 = SUMMERXMY2
+TAN = TAN
+TANH = TANH
+TRUNC = AVKORT
+
+##
+## Statistiske funksjoner (Statistical Functions)
+##
+AVEDEV = GJENNOMSNITTSAVVIK
+AVERAGE = GJENNOMSNITT
+AVERAGEA = GJENNOMSNITTA
+AVERAGEIF = GJENNOMSNITTHVIS
+AVERAGEIFS = GJENNOMSNITT.HVIS.SETT
+BETA.DIST = BETA.FORDELING.N
+BETA.INV = BETA.INV
+BINOM.DIST = BINOM.FORDELING.N
+BINOM.DIST.RANGE = BINOM.FORDELING.OMRÅDE
+BINOM.INV = BINOM.INV
+CHISQ.DIST = KJIKVADRAT.FORDELING
+CHISQ.DIST.RT = KJIKVADRAT.FORDELING.H
+CHISQ.INV = KJIKVADRAT.INV
+CHISQ.INV.RT = KJIKVADRAT.INV.H
+CHISQ.TEST = KJIKVADRAT.TEST
+CONFIDENCE.NORM = KONFIDENS.NORM
+CONFIDENCE.T = KONFIDENS.T
+CORREL = KORRELASJON
+COUNT = ANTALL
+COUNTA = ANTALLA
+COUNTBLANK = TELLBLANKE
+COUNTIF = ANTALL.HVIS
+COUNTIFS = ANTALL.HVIS.SETT
+COVARIANCE.P = KOVARIANS.P
+COVARIANCE.S = KOVARIANS.S
+DEVSQ = AVVIK.KVADRERT
+EXPON.DIST = EKSP.FORDELING.N
+F.DIST = F.FORDELING
+F.DIST.RT = F.FORDELING.H
+F.INV = F.INV
+F.INV.RT = F.INV.H
+F.TEST = F.TEST
+FISHER = FISHER
+FISHERINV = FISHERINV
+FORECAST.ETS = PROGNOSE.ETS
+FORECAST.ETS.CONFINT = PROGNOSE.ETS.CONFINT
+FORECAST.ETS.SEASONALITY = PROGNOSE.ETS.SESONGAVHENGIGHET
+FORECAST.ETS.STAT = PROGNOSE.ETS.STAT
+FORECAST.LINEAR = PROGNOSE.LINEÆR
+FREQUENCY = FREKVENS
+GAMMA = GAMMA
+GAMMA.DIST = GAMMA.FORDELING
+GAMMA.INV = GAMMA.INV
+GAMMALN = GAMMALN
+GAMMALN.PRECISE = GAMMALN.PRESIS
+GAUSS = GAUSS
+GEOMEAN = GJENNOMSNITT.GEOMETRISK
+GROWTH = VEKST
+HARMEAN = GJENNOMSNITT.HARMONISK
+HYPGEOM.DIST = HYPGEOM.FORDELING.N
+INTERCEPT = SKJÆRINGSPUNKT
+KURT = KURT
+LARGE = N.STØRST
+LINEST = RETTLINJE
+LOGEST = KURVE
+LOGNORM.DIST = LOGNORM.FORDELING
+LOGNORM.INV = LOGNORM.INV
+MAX = STØRST
+MAXA = MAKSA
+MAXIFS = MAKS.HVIS.SETT
+MEDIAN = MEDIAN
+MIN = MIN
+MINA = MINA
+MINIFS = MIN.HVIS.SETT
+MODE.MULT = MODUS.MULT
+MODE.SNGL = MODUS.SNGL
+NEGBINOM.DIST = NEGBINOM.FORDELING.N
+NORM.DIST = NORM.FORDELING
+NORM.INV = NORM.INV
+NORM.S.DIST = NORM.S.FORDELING
+NORM.S.INV = NORM.S.INV
+PEARSON = PEARSON
+PERCENTILE.EXC = PERSENTIL.EKS
+PERCENTILE.INC = PERSENTIL.INK
+PERCENTRANK.EXC = PROSENTDEL.EKS
+PERCENTRANK.INC = PROSENTDEL.INK
+PERMUT = PERMUTER
+PERMUTATIONA = PERMUTASJONA
+PHI = PHI
+POISSON.DIST = POISSON.FORDELING
+PROB = SANNSYNLIG
+QUARTILE.EXC = KVARTIL.EKS
+QUARTILE.INC = KVARTIL.INK
+RANK.AVG = RANG.GJSN
+RANK.EQ = RANG.EKV
+RSQ = RKVADRAT
+SKEW = SKJEVFORDELING
+SKEW.P = SKJEVFORDELING.P
+SLOPE = STIGNINGSTALL
+SMALL = N.MINST
+STANDARDIZE = NORMALISER
+STDEV.P = STDAV.P
+STDEV.S = STDAV.S
+STDEVA = STDAVVIKA
+STDEVPA = STDAVVIKPA
+STEYX = STANDARDFEIL
+T.DIST = T.FORDELING
+T.DIST.2T = T.FORDELING.2T
+T.DIST.RT = T.FORDELING.H
+T.INV = T.INV
+T.INV.2T = T.INV.2T
+T.TEST = T.TEST
+TREND = TREND
+TRIMMEAN = TRIMMET.GJENNOMSNITT
+VAR.P = VARIANS.P
+VAR.S = VARIANS.S
+VARA = VARIANSA
+VARPA = VARIANSPA
+WEIBULL.DIST = WEIBULL.DIST.N
+Z.TEST = Z.TEST
+
+##
+## Tekstfunksjoner (Text Functions)
+##
+ASC = STIGENDE
+BAHTTEXT = BAHTTEKST
+CHAR = TEGNKODE
+CLEAN = RENSK
+CODE = KODE
+CONCAT = KJED.SAMMEN
+DOLLAR = VALUTA
+EXACT = EKSAKT
+FIND = FINN
+FIXED = FASTSATT
+ISTHAIDIGIT = ERTHAISIFFER
+LEFT = VENSTRE
+LEN = LENGDE
+LOWER = SMÅ
+MID = DELTEKST
+NUMBERSTRING = TALLSTRENG
+NUMBERVALUE = TALLVERDI
+PHONETIC = FURIGANA
+PROPER = STOR.FORBOKSTAV
+REPLACE = ERSTATT
+REPT = GJENTA
+RIGHT = HØYRE
+SEARCH = SØK
+SUBSTITUTE = BYTT.UT
+T = T
+TEXT = TEKST
+TEXTJOIN = TEKST.KOMBINER
+THAIDIGIT = THAISIFFER
+THAINUMSOUND = THAINUMLYD
+THAINUMSTRING = THAINUMSTRENG
+THAISTRINGLENGTH = THAISTRENGLENGDE
+TRIM = TRIMME
+UNICHAR = UNICODETEGN
+UNICODE = UNICODE
+UPPER = STORE
+VALUE = VERDI
+
+##
+## Nettfunksjoner (Web Functions)
+##
+ENCODEURL = URL.KODE
+FILTERXML = FILTRERXML
+WEBSERVICE = NETTJENESTE
+
+##
+## Kompatibilitetsfunksjoner (Compatibility Functions)
+##
+BETADIST = BETA.FORDELING
+BETAINV = INVERS.BETA.FORDELING
+BINOMDIST = BINOM.FORDELING
+CEILING = AVRUND.GJELDENDE.MULTIPLUM
+CHIDIST = KJI.FORDELING
+CHIINV = INVERS.KJI.FORDELING
+CHITEST = KJI.TEST
+CONCATENATE = KJEDE.SAMMEN
+CONFIDENCE = KONFIDENS
+COVAR = KOVARIANS
+CRITBINOM = GRENSE.BINOM
+EXPONDIST = EKSP.FORDELING
+FDIST = FFORDELING
+FINV = FFORDELING.INVERS
+FLOOR = AVRUND.GJELDENDE.MULTIPLUM.NED
+FORECAST = PROGNOSE
+FTEST = FTEST
+GAMMADIST = GAMMAFORDELING
+GAMMAINV = GAMMAINV
+HYPGEOMDIST = HYPGEOM.FORDELING
+LOGINV = LOGINV
+LOGNORMDIST = LOGNORMFORD
+MODE = MODUS
+NEGBINOMDIST = NEGBINOM.FORDELING
+NORMDIST = NORMALFORDELING
+NORMINV = NORMINV
+NORMSDIST = NORMSFORDELING
+NORMSINV = NORMSINV
+PERCENTILE = PERSENTIL
+PERCENTRANK = PROSENTDEL
+POISSON = POISSON
+QUARTILE = KVARTIL
+RANK = RANG
+STDEV = STDAV
+STDEVP = STDAVP
+TDIST = TFORDELING
+TINV = TINV
+TTEST = TTEST
+VAR = VARIANS
+VARP = VARIANSP
+WEIBULL = WEIBULL.FORDELING
+ZTEST = ZTEST
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/nl/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/nl/config
new file mode 100644
index 00000000..370567a7
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/nl/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Nederlands (Dutch)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL = #LEEG!
+DIV0 = #DEEL/0!
+VALUE = #WAARDE!
+REF = #VERW!
+NAME = #NAAM?
+NUM = #GETAL!
+NA = #N/B
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/nl/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/nl/functions
new file mode 100644
index 00000000..ce0b30cc
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/nl/functions
@@ -0,0 +1,537 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Nederlands (Dutch)
+##
+############################################################
+
+
+##
+## Kubusfuncties (Cube Functions)
+##
+CUBEKPIMEMBER = KUBUSKPILID
+CUBEMEMBER = KUBUSLID
+CUBEMEMBERPROPERTY = KUBUSLIDEIGENSCHAP
+CUBERANKEDMEMBER = KUBUSGERANGSCHIKTLID
+CUBESET = KUBUSSET
+CUBESETCOUNT = KUBUSSETAANTAL
+CUBEVALUE = KUBUSWAARDE
+
+##
+## Databasefuncties (Database Functions)
+##
+DAVERAGE = DBGEMIDDELDE
+DCOUNT = DBAANTAL
+DCOUNTA = DBAANTALC
+DGET = DBLEZEN
+DMAX = DBMAX
+DMIN = DBMIN
+DPRODUCT = DBPRODUCT
+DSTDEV = DBSTDEV
+DSTDEVP = DBSTDEVP
+DSUM = DBSOM
+DVAR = DBVAR
+DVARP = DBVARP
+
+##
+## Datum- en tijdfuncties (Date & Time Functions)
+##
+DATE = DATUM
+DATESTRING = DATUMNOTATIE
+DATEVALUE = DATUMWAARDE
+DAY = DAG
+DAYS = DAGEN
+DAYS360 = DAGEN360
+EDATE = ZELFDE.DAG
+EOMONTH = LAATSTE.DAG
+HOUR = UUR
+ISOWEEKNUM = ISO.WEEKNUMMER
+MINUTE = MINUUT
+MONTH = MAAND
+NETWORKDAYS = NETTO.WERKDAGEN
+NETWORKDAYS.INTL = NETWERKDAGEN.INTL
+NOW = NU
+SECOND = SECONDE
+THAIDAYOFWEEK = THAIS.WEEKDAG
+THAIMONTHOFYEAR = THAIS.MAAND.VAN.JAAR
+THAIYEAR = THAIS.JAAR
+TIME = TIJD
+TIMEVALUE = TIJDWAARDE
+TODAY = VANDAAG
+WEEKDAY = WEEKDAG
+WEEKNUM = WEEKNUMMER
+WORKDAY = WERKDAG
+WORKDAY.INTL = WERKDAG.INTL
+YEAR = JAAR
+YEARFRAC = JAAR.DEEL
+
+##
+## Technische functies (Engineering Functions)
+##
+BESSELI = BESSEL.I
+BESSELJ = BESSEL.J
+BESSELK = BESSEL.K
+BESSELY = BESSEL.Y
+BIN2DEC = BIN.N.DEC
+BIN2HEX = BIN.N.HEX
+BIN2OCT = BIN.N.OCT
+BITAND = BIT.EN
+BITLSHIFT = BIT.VERSCHUIF.LINKS
+BITOR = BIT.OF
+BITRSHIFT = BIT.VERSCHUIF.RECHTS
+BITXOR = BIT.EX.OF
+COMPLEX = COMPLEX
+CONVERT = CONVERTEREN
+DEC2BIN = DEC.N.BIN
+DEC2HEX = DEC.N.HEX
+DEC2OCT = DEC.N.OCT
+DELTA = DELTA
+ERF = FOUTFUNCTIE
+ERF.PRECISE = FOUTFUNCTIE.NAUWKEURIG
+ERFC = FOUT.COMPLEMENT
+ERFC.PRECISE = FOUT.COMPLEMENT.NAUWKEURIG
+GESTEP = GROTER.DAN
+HEX2BIN = HEX.N.BIN
+HEX2DEC = HEX.N.DEC
+HEX2OCT = HEX.N.OCT
+IMABS = C.ABS
+IMAGINARY = C.IM.DEEL
+IMARGUMENT = C.ARGUMENT
+IMCONJUGATE = C.TOEGEVOEGD
+IMCOS = C.COS
+IMCOSH = C.COSH
+IMCOT = C.COT
+IMCSC = C.COSEC
+IMCSCH = C.COSECH
+IMDIV = C.QUOTIENT
+IMEXP = C.EXP
+IMLN = C.LN
+IMLOG10 = C.LOG10
+IMLOG2 = C.LOG2
+IMPOWER = C.MACHT
+IMPRODUCT = C.PRODUCT
+IMREAL = C.REEEL.DEEL
+IMSEC = C.SEC
+IMSECH = C.SECH
+IMSIN = C.SIN
+IMSINH = C.SINH
+IMSQRT = C.WORTEL
+IMSUB = C.VERSCHIL
+IMSUM = C.SOM
+IMTAN = C.TAN
+OCT2BIN = OCT.N.BIN
+OCT2DEC = OCT.N.DEC
+OCT2HEX = OCT.N.HEX
+
+##
+## Financiële functies (Financial Functions)
+##
+ACCRINT = SAMENG.RENTE
+ACCRINTM = SAMENG.RENTE.V
+AMORDEGRC = AMORDEGRC
+AMORLINC = AMORLINC
+COUPDAYBS = COUP.DAGEN.BB
+COUPDAYS = COUP.DAGEN
+COUPDAYSNC = COUP.DAGEN.VV
+COUPNCD = COUP.DATUM.NB
+COUPNUM = COUP.AANTAL
+COUPPCD = COUP.DATUM.VB
+CUMIPMT = CUM.RENTE
+CUMPRINC = CUM.HOOFDSOM
+DB = DB
+DDB = DDB
+DISC = DISCONTO
+DOLLARDE = EURO.DE
+DOLLARFR = EURO.BR
+DURATION = DUUR
+EFFECT = EFFECT.RENTE
+FV = TW
+FVSCHEDULE = TOEK.WAARDE2
+INTRATE = RENTEPERCENTAGE
+IPMT = IBET
+IRR = IR
+ISPMT = ISBET
+MDURATION = AANG.DUUR
+MIRR = GIR
+NOMINAL = NOMINALE.RENTE
+NPER = NPER
+NPV = NHW
+ODDFPRICE = AFW.ET.PRIJS
+ODDFYIELD = AFW.ET.REND
+ODDLPRICE = AFW.LT.PRIJS
+ODDLYIELD = AFW.LT.REND
+PDURATION = PDUUR
+PMT = BET
+PPMT = PBET
+PRICE = PRIJS.NOM
+PRICEDISC = PRIJS.DISCONTO
+PRICEMAT = PRIJS.VERVALDAG
+PV = HW
+RATE = RENTE
+RECEIVED = OPBRENGST
+RRI = RRI
+SLN = LIN.AFSCHR
+SYD = SYD
+TBILLEQ = SCHATK.OBL
+TBILLPRICE = SCHATK.PRIJS
+TBILLYIELD = SCHATK.REND
+VDB = VDB
+XIRR = IR.SCHEMA
+XNPV = NHW2
+YIELD = RENDEMENT
+YIELDDISC = REND.DISCONTO
+YIELDMAT = REND.VERVAL
+
+##
+## Informatiefuncties (Information Functions)
+##
+CELL = CEL
+ERROR.TYPE = TYPE.FOUT
+INFO = INFO
+ISBLANK = ISLEEG
+ISERR = ISFOUT2
+ISERROR = ISFOUT
+ISEVEN = IS.EVEN
+ISFORMULA = ISFORMULE
+ISLOGICAL = ISLOGISCH
+ISNA = ISNB
+ISNONTEXT = ISGEENTEKST
+ISNUMBER = ISGETAL
+ISODD = IS.ONEVEN
+ISREF = ISVERWIJZING
+ISTEXT = ISTEKST
+N = N
+NA = NB
+SHEET = BLAD
+SHEETS = BLADEN
+TYPE = TYPE
+
+##
+## Logische functies (Logical Functions)
+##
+AND = EN
+FALSE = ONWAAR
+IF = ALS
+IFERROR = ALS.FOUT
+IFNA = ALS.NB
+IFS = ALS.VOORWAARDEN
+NOT = NIET
+OR = OF
+SWITCH = SCHAKELEN
+TRUE = WAAR
+XOR = EX.OF
+
+##
+## Zoek- en verwijzingsfuncties (Lookup & Reference Functions)
+##
+ADDRESS = ADRES
+AREAS = BEREIKEN
+CHOOSE = KIEZEN
+COLUMN = KOLOM
+COLUMNS = KOLOMMEN
+FORMULATEXT = FORMULETEKST
+GETPIVOTDATA = DRAAITABEL.OPHALEN
+HLOOKUP = HORIZ.ZOEKEN
+HYPERLINK = HYPERLINK
+INDEX = INDEX
+INDIRECT = INDIRECT
+LOOKUP = ZOEKEN
+MATCH = VERGELIJKEN
+OFFSET = VERSCHUIVING
+ROW = RIJ
+ROWS = RIJEN
+RTD = RTG
+TRANSPOSE = TRANSPONEREN
+VLOOKUP = VERT.ZOEKEN
+*RC = RK
+
+##
+## Wiskundige en trigonometrische functies (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = BOOGCOS
+ACOSH = BOOGCOSH
+ACOT = BOOGCOT
+ACOTH = BOOGCOTH
+AGGREGATE = AGGREGAAT
+ARABIC = ARABISCH
+ASIN = BOOGSIN
+ASINH = BOOGSINH
+ATAN = BOOGTAN
+ATAN2 = BOOGTAN2
+ATANH = BOOGTANH
+BASE = BASIS
+CEILING.MATH = AFRONDEN.BOVEN.WISK
+CEILING.PRECISE = AFRONDEN.BOVEN.NAUWKEURIG
+COMBIN = COMBINATIES
+COMBINA = COMBIN.A
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = COSEC
+CSCH = COSECH
+DECIMAL = DECIMAAL
+DEGREES = GRADEN
+ECMA.CEILING = ECMA.AFRONDEN.BOVEN
+EVEN = EVEN
+EXP = EXP
+FACT = FACULTEIT
+FACTDOUBLE = DUBBELE.FACULTEIT
+FLOOR.MATH = AFRONDEN.BENEDEN.WISK
+FLOOR.PRECISE = AFRONDEN.BENEDEN.NAUWKEURIG
+GCD = GGD
+INT = INTEGER
+ISO.CEILING = ISO.AFRONDEN.BOVEN
+LCM = KGV
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = DETERMINANTMAT
+MINVERSE = INVERSEMAT
+MMULT = PRODUCTMAT
+MOD = REST
+MROUND = AFRONDEN.N.VEELVOUD
+MULTINOMIAL = MULTINOMIAAL
+MUNIT = EENHEIDMAT
+ODD = ONEVEN
+PI = PI
+POWER = MACHT
+PRODUCT = PRODUCT
+QUOTIENT = QUOTIENT
+RADIANS = RADIALEN
+RAND = ASELECT
+RANDBETWEEN = ASELECTTUSSEN
+ROMAN = ROMEINS
+ROUND = AFRONDEN
+ROUNDBAHTDOWN = BAHT.AFR.NAAR.BENEDEN
+ROUNDBAHTUP = BAHT.AFR.NAAR.BOVEN
+ROUNDDOWN = AFRONDEN.NAAR.BENEDEN
+ROUNDUP = AFRONDEN.NAAR.BOVEN
+SEC = SEC
+SECH = SECH
+SERIESSUM = SOM.MACHTREEKS
+SIGN = POS.NEG
+SIN = SIN
+SINH = SINH
+SQRT = WORTEL
+SQRTPI = WORTEL.PI
+SUBTOTAL = SUBTOTAAL
+SUM = SOM
+SUMIF = SOM.ALS
+SUMIFS = SOMMEN.ALS
+SUMPRODUCT = SOMPRODUCT
+SUMSQ = KWADRATENSOM
+SUMX2MY2 = SOM.X2MINY2
+SUMX2PY2 = SOM.X2PLUSY2
+SUMXMY2 = SOM.XMINY.2
+TAN = TAN
+TANH = TANH
+TRUNC = GEHEEL
+
+##
+## Statistische functies (Statistical Functions)
+##
+AVEDEV = GEM.DEVIATIE
+AVERAGE = GEMIDDELDE
+AVERAGEA = GEMIDDELDEA
+AVERAGEIF = GEMIDDELDE.ALS
+AVERAGEIFS = GEMIDDELDEN.ALS
+BETA.DIST = BETA.VERD
+BETA.INV = BETA.INV
+BINOM.DIST = BINOM.VERD
+BINOM.DIST.RANGE = BINOM.VERD.BEREIK
+BINOM.INV = BINOMIALE.INV
+CHISQ.DIST = CHIKW.VERD
+CHISQ.DIST.RT = CHIKW.VERD.RECHTS
+CHISQ.INV = CHIKW.INV
+CHISQ.INV.RT = CHIKW.INV.RECHTS
+CHISQ.TEST = CHIKW.TEST
+CONFIDENCE.NORM = VERTROUWELIJKHEID.NORM
+CONFIDENCE.T = VERTROUWELIJKHEID.T
+CORREL = CORRELATIE
+COUNT = AANTAL
+COUNTA = AANTALARG
+COUNTBLANK = AANTAL.LEGE.CELLEN
+COUNTIF = AANTAL.ALS
+COUNTIFS = AANTALLEN.ALS
+COVARIANCE.P = COVARIANTIE.P
+COVARIANCE.S = COVARIANTIE.S
+DEVSQ = DEV.KWAD
+EXPON.DIST = EXPON.VERD.N
+F.DIST = F.VERD
+F.DIST.RT = F.VERD.RECHTS
+F.INV = F.INV
+F.INV.RT = F.INV.RECHTS
+F.TEST = F.TEST
+FISHER = FISHER
+FISHERINV = FISHER.INV
+FORECAST.ETS = VOORSPELLEN.ETS
+FORECAST.ETS.CONFINT = VOORSPELLEN.ETS.CONFINT
+FORECAST.ETS.SEASONALITY = VOORSPELLEN.ETS.SEASONALITY
+FORECAST.ETS.STAT = FORECAST.ETS.STAT
+FORECAST.LINEAR = VOORSPELLEN.LINEAR
+FREQUENCY = INTERVAL
+GAMMA = GAMMA
+GAMMA.DIST = GAMMA.VERD.N
+GAMMA.INV = GAMMA.INV.N
+GAMMALN = GAMMA.LN
+GAMMALN.PRECISE = GAMMA.LN.NAUWKEURIG
+GAUSS = GAUSS
+GEOMEAN = MEETK.GEM
+GROWTH = GROEI
+HARMEAN = HARM.GEM
+HYPGEOM.DIST = HYPGEOM.VERD
+INTERCEPT = SNIJPUNT
+KURT = KURTOSIS
+LARGE = GROOTSTE
+LINEST = LIJNSCH
+LOGEST = LOGSCH
+LOGNORM.DIST = LOGNORM.VERD
+LOGNORM.INV = LOGNORM.INV
+MAX = MAX
+MAXA = MAXA
+MAXIFS = MAX.ALS.VOORWAARDEN
+MEDIAN = MEDIAAN
+MIN = MIN
+MINA = MINA
+MINIFS = MIN.ALS.VOORWAARDEN
+MODE.MULT = MODUS.MEERV
+MODE.SNGL = MODUS.ENKELV
+NEGBINOM.DIST = NEGBINOM.VERD
+NORM.DIST = NORM.VERD.N
+NORM.INV = NORM.INV.N
+NORM.S.DIST = NORM.S.VERD
+NORM.S.INV = NORM.S.INV
+PEARSON = PEARSON
+PERCENTILE.EXC = PERCENTIEL.EXC
+PERCENTILE.INC = PERCENTIEL.INC
+PERCENTRANK.EXC = PROCENTRANG.EXC
+PERCENTRANK.INC = PROCENTRANG.INC
+PERMUT = PERMUTATIES
+PERMUTATIONA = PERMUTATIE.A
+PHI = PHI
+POISSON.DIST = POISSON.VERD
+PROB = KANS
+QUARTILE.EXC = KWARTIEL.EXC
+QUARTILE.INC = KWARTIEL.INC
+RANK.AVG = RANG.GEMIDDELDE
+RANK.EQ = RANG.GELIJK
+RSQ = R.KWADRAAT
+SKEW = SCHEEFHEID
+SKEW.P = SCHEEFHEID.P
+SLOPE = RICHTING
+SMALL = KLEINSTE
+STANDARDIZE = NORMALISEREN
+STDEV.P = STDEV.P
+STDEV.S = STDEV.S
+STDEVA = STDEVA
+STDEVPA = STDEVPA
+STEYX = STAND.FOUT.YX
+T.DIST = T.DIST
+T.DIST.2T = T.VERD.2T
+T.DIST.RT = T.VERD.RECHTS
+T.INV = T.INV
+T.INV.2T = T.INV.2T
+T.TEST = T.TEST
+TREND = TREND
+TRIMMEAN = GETRIMD.GEM
+VAR.P = VAR.P
+VAR.S = VAR.S
+VARA = VARA
+VARPA = VARPA
+WEIBULL.DIST = WEIBULL.VERD
+Z.TEST = Z.TEST
+
+##
+## Tekstfuncties (Text Functions)
+##
+BAHTTEXT = BAHT.TEKST
+CHAR = TEKEN
+CLEAN = WISSEN.CONTROL
+CODE = CODE
+CONCAT = TEKST.SAMENV
+DOLLAR = EURO
+EXACT = GELIJK
+FIND = VIND.ALLES
+FIXED = VAST
+ISTHAIDIGIT = IS.THAIS.CIJFER
+LEFT = LINKS
+LEN = LENGTE
+LOWER = KLEINE.LETTERS
+MID = DEEL
+NUMBERSTRING = GETALNOTATIE
+NUMBERVALUE = NUMERIEKE.WAARDE
+PHONETIC = FONETISCH
+PROPER = BEGINLETTERS
+REPLACE = VERVANGEN
+REPT = HERHALING
+RIGHT = RECHTS
+SEARCH = VIND.SPEC
+SUBSTITUTE = SUBSTITUEREN
+T = T
+TEXT = TEKST
+TEXTJOIN = TEKST.COMBINEREN
+THAIDIGIT = THAIS.CIJFER
+THAINUMSOUND = THAIS.GETAL.GELUID
+THAINUMSTRING = THAIS.GETAL.REEKS
+THAISTRINGLENGTH = THAIS.REEKS.LENGTE
+TRIM = SPATIES.WISSEN
+UNICHAR = UNITEKEN
+UNICODE = UNICODE
+UPPER = HOOFDLETTERS
+VALUE = WAARDE
+
+##
+## Webfuncties (Web Functions)
+##
+ENCODEURL = URL.CODEREN
+FILTERXML = XML.FILTEREN
+WEBSERVICE = WEBSERVICE
+
+##
+## Compatibiliteitsfuncties (Compatibility Functions)
+##
+BETADIST = BETAVERD
+BETAINV = BETAINV
+BINOMDIST = BINOMIALE.VERD
+CEILING = AFRONDEN.BOVEN
+CHIDIST = CHI.KWADRAAT
+CHIINV = CHI.KWADRAAT.INV
+CHITEST = CHI.TOETS
+CONCATENATE = TEKST.SAMENVOEGEN
+CONFIDENCE = BETROUWBAARHEID
+COVAR = COVARIANTIE
+CRITBINOM = CRIT.BINOM
+EXPONDIST = EXPON.VERD
+FDIST = F.VERDELING
+FINV = F.INVERSE
+FLOOR = AFRONDEN.BENEDEN
+FORECAST = VOORSPELLEN
+FTEST = F.TOETS
+GAMMADIST = GAMMA.VERD
+GAMMAINV = GAMMA.INV
+HYPGEOMDIST = HYPERGEO.VERD
+LOGINV = LOG.NORM.INV
+LOGNORMDIST = LOG.NORM.VERD
+MODE = MODUS
+NEGBINOMDIST = NEG.BINOM.VERD
+NORMDIST = NORM.VERD
+NORMINV = NORM.INV
+NORMSDIST = STAND.NORM.VERD
+NORMSINV = STAND.NORM.INV
+PERCENTILE = PERCENTIEL
+PERCENTRANK = PERCENT.RANG
+POISSON = POISSON
+QUARTILE = KWARTIEL
+RANK = RANG
+STDEV = STDEV
+STDEVP = STDEVP
+TDIST = T.VERD
+TINV = TINV
+TTEST = T.TOETS
+VAR = VAR
+VARP = VARP
+WEIBULL = WEIBULL
+ZTEST = Z.TOETS
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pl/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pl/config
new file mode 100644
index 00000000..1d8468ba
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pl/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Jezyk polski (Polish)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL = #ZERO!
+DIV0 = #DZIEL/0!
+VALUE = #ARG!
+REF = #ADR!
+NAME = #NAZWA?
+NUM = #LICZBA!
+NA = #N/D!
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pl/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pl/functions
new file mode 100644
index 00000000..d1b43b2e
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pl/functions
@@ -0,0 +1,536 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Jezyk polski (Polish)
+##
+############################################################
+
+
+##
+## Funkcje baz danych (Cube Functions)
+##
+CUBEKPIMEMBER = ELEMENT.KPI.MODUŁU
+CUBEMEMBER = ELEMENT.MODUŁU
+CUBEMEMBERPROPERTY = WŁAŚCIWOŚĆ.ELEMENTU.MODUŁU
+CUBERANKEDMEMBER = USZEREGOWANY.ELEMENT.MODUŁU
+CUBESET = ZESTAW.MODUŁÓW
+CUBESETCOUNT = LICZNIK.MODUŁÓW.ZESTAWU
+CUBEVALUE = WARTOŚĆ.MODUŁU
+
+##
+## Funkcje baz danych (Database Functions)
+##
+DAVERAGE = BD.ŚREDNIA
+DCOUNT = BD.ILE.REKORDÓW
+DCOUNTA = BD.ILE.REKORDÓW.A
+DGET = BD.POLE
+DMAX = BD.MAX
+DMIN = BD.MIN
+DPRODUCT = BD.ILOCZYN
+DSTDEV = BD.ODCH.STANDARD
+DSTDEVP = BD.ODCH.STANDARD.POPUL
+DSUM = BD.SUMA
+DVAR = BD.WARIANCJA
+DVARP = BD.WARIANCJA.POPUL
+
+##
+## Funkcje daty i godziny (Date & Time Functions)
+##
+DATE = DATA
+DATEDIF = DATA.RÓŻNICA
+DATESTRING = DATA.CIĄG.ZNAK
+DATEVALUE = DATA.WARTOŚĆ
+DAY = DZIEŃ
+DAYS = DNI
+DAYS360 = DNI.360
+EDATE = NR.SER.DATY
+EOMONTH = NR.SER.OST.DN.MIES
+HOUR = GODZINA
+ISOWEEKNUM = ISO.NUM.TYG
+MINUTE = MINUTA
+MONTH = MIESIĄC
+NETWORKDAYS = DNI.ROBOCZE
+NETWORKDAYS.INTL = DNI.ROBOCZE.NIESTAND
+NOW = TERAZ
+SECOND = SEKUNDA
+THAIDAYOFWEEK = TAJ.DZIEŃ.TYGODNIA
+THAIMONTHOFYEAR = TAJ.MIESIĄC.ROKU
+THAIYEAR = TAJ.ROK
+TIME = CZAS
+TIMEVALUE = CZAS.WARTOŚĆ
+TODAY = DZIŚ
+WEEKDAY = DZIEŃ.TYG
+WEEKNUM = NUM.TYG
+WORKDAY = DZIEŃ.ROBOCZY
+WORKDAY.INTL = DZIEŃ.ROBOCZY.NIESTAND
+YEAR = ROK
+YEARFRAC = CZĘŚĆ.ROKU
+
+##
+## Funkcje inżynierskie (Engineering Functions)
+##
+BESSELI = BESSEL.I
+BESSELJ = BESSEL.J
+BESSELK = BESSEL.K
+BESSELY = BESSEL.Y
+BIN2DEC = DWÓJK.NA.DZIES
+BIN2HEX = DWÓJK.NA.SZESN
+BIN2OCT = DWÓJK.NA.ÓSM
+BITAND = BITAND
+BITLSHIFT = BIT.PRZESUNIĘCIE.W.LEWO
+BITOR = BITOR
+BITRSHIFT = BIT.PRZESUNIĘCIE.W.PRAWO
+BITXOR = BITXOR
+COMPLEX = LICZBA.ZESP
+CONVERT = KONWERTUJ
+DEC2BIN = DZIES.NA.DWÓJK
+DEC2HEX = DZIES.NA.SZESN
+DEC2OCT = DZIES.NA.ÓSM
+DELTA = CZY.RÓWNE
+ERF = FUNKCJA.BŁ
+ERF.PRECISE = FUNKCJA.BŁ.DOKŁ
+ERFC = KOMP.FUNKCJA.BŁ
+ERFC.PRECISE = KOMP.FUNKCJA.BŁ.DOKŁ
+GESTEP = SPRAWDŹ.PRÓG
+HEX2BIN = SZESN.NA.DWÓJK
+HEX2DEC = SZESN.NA.DZIES
+HEX2OCT = SZESN.NA.ÓSM
+IMABS = MODUŁ.LICZBY.ZESP
+IMAGINARY = CZ.UROJ.LICZBY.ZESP
+IMARGUMENT = ARG.LICZBY.ZESP
+IMCONJUGATE = SPRZĘŻ.LICZBY.ZESP
+IMCOS = COS.LICZBY.ZESP
+IMCOSH = COSH.LICZBY.ZESP
+IMCOT = COT.LICZBY.ZESP
+IMCSC = CSC.LICZBY.ZESP
+IMCSCH = CSCH.LICZBY.ZESP
+IMDIV = ILORAZ.LICZB.ZESP
+IMEXP = EXP.LICZBY.ZESP
+IMLN = LN.LICZBY.ZESP
+IMLOG10 = LOG10.LICZBY.ZESP
+IMLOG2 = LOG2.LICZBY.ZESP
+IMPOWER = POTĘGA.LICZBY.ZESP
+IMPRODUCT = ILOCZYN.LICZB.ZESP
+IMREAL = CZ.RZECZ.LICZBY.ZESP
+IMSEC = SEC.LICZBY.ZESP
+IMSECH = SECH.LICZBY.ZESP
+IMSIN = SIN.LICZBY.ZESP
+IMSINH = SINH.LICZBY.ZESP
+IMSQRT = PIERWIASTEK.LICZBY.ZESP
+IMSUB = RÓŻN.LICZB.ZESP
+IMSUM = SUMA.LICZB.ZESP
+IMTAN = TAN.LICZBY.ZESP
+OCT2BIN = ÓSM.NA.DWÓJK
+OCT2DEC = ÓSM.NA.DZIES
+OCT2HEX = ÓSM.NA.SZESN
+
+##
+## Funkcje finansowe (Financial Functions)
+##
+ACCRINT = NAL.ODS
+ACCRINTM = NAL.ODS.WYKUP
+AMORDEGRC = AMORT.NIELIN
+AMORLINC = AMORT.LIN
+COUPDAYBS = WYPŁ.DNI.OD.POCZ
+COUPDAYS = WYPŁ.DNI
+COUPDAYSNC = WYPŁ.DNI.NAST
+COUPNCD = WYPŁ.DATA.NAST
+COUPNUM = WYPŁ.LICZBA
+COUPPCD = WYPŁ.DATA.POPRZ
+CUMIPMT = SPŁAC.ODS
+CUMPRINC = SPŁAC.KAPIT
+DB = DB
+DDB = DDB
+DISC = STOPA.DYSK
+DOLLARDE = CENA.DZIES
+DOLLARFR = CENA.UŁAM
+DURATION = ROCZ.PRZYCH
+EFFECT = EFEKTYWNA
+FV = FV
+FVSCHEDULE = WART.PRZYSZŁ.KAP
+INTRATE = STOPA.PROC
+IPMT = IPMT
+IRR = IRR
+ISPMT = ISPMT
+MDURATION = ROCZ.PRZYCH.M
+MIRR = MIRR
+NOMINAL = NOMINALNA
+NPER = NPER
+NPV = NPV
+ODDFPRICE = CENA.PIERW.OKR
+ODDFYIELD = RENT.PIERW.OKR
+ODDLPRICE = CENA.OST.OKR
+ODDLYIELD = RENT.OST.OKR
+PDURATION = O.CZAS.TRWANIA
+PMT = PMT
+PPMT = PPMT
+PRICE = CENA
+PRICEDISC = CENA.DYSK
+PRICEMAT = CENA.WYKUP
+PV = PV
+RATE = RATE
+RECEIVED = KWOTA.WYKUP
+RRI = RÓWNOW.STOPA.PROC
+SLN = SLN
+SYD = SYD
+TBILLEQ = RENT.EKW.BS
+TBILLPRICE = CENA.BS
+TBILLYIELD = RENT.BS
+VDB = VDB
+XIRR = XIRR
+XNPV = XNPV
+YIELD = RENTOWNOŚĆ
+YIELDDISC = RENT.DYSK
+YIELDMAT = RENT.WYKUP
+
+##
+## Funkcje informacyjne (Information Functions)
+##
+CELL = KOMÓRKA
+ERROR.TYPE = NR.BŁĘDU
+INFO = INFO
+ISBLANK = CZY.PUSTA
+ISERR = CZY.BŁ
+ISERROR = CZY.BŁĄD
+ISEVEN = CZY.PARZYSTE
+ISFORMULA = CZY.FORMUŁA
+ISLOGICAL = CZY.LOGICZNA
+ISNA = CZY.BRAK
+ISNONTEXT = CZY.NIE.TEKST
+ISNUMBER = CZY.LICZBA
+ISODD = CZY.NIEPARZYSTE
+ISREF = CZY.ADR
+ISTEXT = CZY.TEKST
+N = N
+NA = BRAK
+SHEET = ARKUSZ
+SHEETS = ARKUSZE
+TYPE = TYP
+
+##
+## Funkcje logiczne (Logical Functions)
+##
+AND = ORAZ
+FALSE = FAŁSZ
+IF = JEŻELI
+IFERROR = JEŻELI.BŁĄD
+IFNA = JEŻELI.ND
+IFS = WARUNKI
+NOT = NIE
+OR = LUB
+SWITCH = PRZEŁĄCZ
+TRUE = PRAWDA
+XOR = XOR
+
+##
+## Funkcje wyszukiwania i odwołań (Lookup & Reference Functions)
+##
+ADDRESS = ADRES
+AREAS = OBSZARY
+CHOOSE = WYBIERZ
+COLUMN = NR.KOLUMNY
+COLUMNS = LICZBA.KOLUMN
+FORMULATEXT = FORMUŁA.TEKST
+GETPIVOTDATA = WEŹDANETABELI
+HLOOKUP = WYSZUKAJ.POZIOMO
+HYPERLINK = HIPERŁĄCZE
+INDEX = INDEKS
+INDIRECT = ADR.POŚR
+LOOKUP = WYSZUKAJ
+MATCH = PODAJ.POZYCJĘ
+OFFSET = PRZESUNIĘCIE
+ROW = WIERSZ
+ROWS = ILE.WIERSZY
+RTD = DANE.CZASU.RZECZ
+TRANSPOSE = TRANSPONUJ
+VLOOKUP = WYSZUKAJ.PIONOWO
+
+##
+## Funkcje matematyczne i trygonometryczne (Math & Trig Functions)
+##
+ABS = MODUŁ.LICZBY
+ACOS = ACOS
+ACOSH = ACOSH
+ACOT = ACOT
+ACOTH = ACOTH
+AGGREGATE = AGREGUJ
+ARABIC = ARABSKIE
+ASIN = ASIN
+ASINH = ASINH
+ATAN = ATAN
+ATAN2 = ATAN2
+ATANH = ATANH
+BASE = PODSTAWA
+CEILING.MATH = ZAOKR.W.GÓRĘ.MATEMATYCZNE
+CEILING.PRECISE = ZAOKR.W.GÓRĘ.DOKŁ
+COMBIN = KOMBINACJE
+COMBINA = KOMBINACJE.A
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = CSC
+CSCH = CSCH
+DECIMAL = DZIESIĘTNA
+DEGREES = STOPNIE
+ECMA.CEILING = ECMA.ZAOKR.W.GÓRĘ
+EVEN = ZAOKR.DO.PARZ
+EXP = EXP
+FACT = SILNIA
+FACTDOUBLE = SILNIA.DWUKR
+FLOOR.MATH = ZAOKR.W.DÓŁ.MATEMATYCZNE
+FLOOR.PRECISE = ZAOKR.W.DÓŁ.DOKŁ
+GCD = NAJW.WSP.DZIEL
+INT = ZAOKR.DO.CAŁK
+ISO.CEILING = ISO.ZAOKR.W.GÓRĘ
+LCM = NAJMN.WSP.WIEL
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = WYZNACZNIK.MACIERZY
+MINVERSE = MACIERZ.ODW
+MMULT = MACIERZ.ILOCZYN
+MOD = MOD
+MROUND = ZAOKR.DO.WIELOKR
+MULTINOMIAL = WIELOMIAN
+MUNIT = MACIERZ.JEDNOSTKOWA
+ODD = ZAOKR.DO.NPARZ
+PI = PI
+POWER = POTĘGA
+PRODUCT = ILOCZYN
+QUOTIENT = CZ.CAŁK.DZIELENIA
+RADIANS = RADIANY
+RAND = LOS
+RANDBETWEEN = LOS.ZAKR
+ROMAN = RZYMSKIE
+ROUND = ZAOKR
+ROUNDBAHTDOWN = ZAOKR.DÓŁ.BAT
+ROUNDBAHTUP = ZAOKR.GÓRA.BAT
+ROUNDDOWN = ZAOKR.DÓŁ
+ROUNDUP = ZAOKR.GÓRA
+SEC = SEC
+SECH = SECH
+SERIESSUM = SUMA.SZER.POT
+SIGN = ZNAK.LICZBY
+SIN = SIN
+SINH = SINH
+SQRT = PIERWIASTEK
+SQRTPI = PIERW.PI
+SUBTOTAL = SUMY.CZĘŚCIOWE
+SUM = SUMA
+SUMIF = SUMA.JEŻELI
+SUMIFS = SUMA.WARUNKÓW
+SUMPRODUCT = SUMA.ILOCZYNÓW
+SUMSQ = SUMA.KWADRATÓW
+SUMX2MY2 = SUMA.X2.M.Y2
+SUMX2PY2 = SUMA.X2.P.Y2
+SUMXMY2 = SUMA.XMY.2
+TAN = TAN
+TANH = TANH
+TRUNC = LICZBA.CAŁK
+
+##
+## Funkcje statystyczne (Statistical Functions)
+##
+AVEDEV = ODCH.ŚREDNIE
+AVERAGE = ŚREDNIA
+AVERAGEA = ŚREDNIA.A
+AVERAGEIF = ŚREDNIA.JEŻELI
+AVERAGEIFS = ŚREDNIA.WARUNKÓW
+BETA.DIST = ROZKŁ.BETA
+BETA.INV = ROZKŁ.BETA.ODWR
+BINOM.DIST = ROZKŁ.DWUM
+BINOM.DIST.RANGE = ROZKŁ.DWUM.ZAKRES
+BINOM.INV = ROZKŁ.DWUM.ODWR
+CHISQ.DIST = ROZKŁ.CHI
+CHISQ.DIST.RT = ROZKŁ.CHI.PS
+CHISQ.INV = ROZKŁ.CHI.ODWR
+CHISQ.INV.RT = ROZKŁ.CHI.ODWR.PS
+CHISQ.TEST = CHI.TEST
+CONFIDENCE.NORM = UFNOŚĆ.NORM
+CONFIDENCE.T = UFNOŚĆ.T
+CORREL = WSP.KORELACJI
+COUNT = ILE.LICZB
+COUNTA = ILE.NIEPUSTYCH
+COUNTBLANK = LICZ.PUSTE
+COUNTIF = LICZ.JEŻELI
+COUNTIFS = LICZ.WARUNKI
+COVARIANCE.P = KOWARIANCJA.POPUL
+COVARIANCE.S = KOWARIANCJA.PRÓBKI
+DEVSQ = ODCH.KWADRATOWE
+EXPON.DIST = ROZKŁ.EXP
+F.DIST = ROZKŁ.F
+F.DIST.RT = ROZKŁ.F.PS
+F.INV = ROZKŁ.F.ODWR
+F.INV.RT = ROZKŁ.F.ODWR.PS
+F.TEST = F.TEST
+FISHER = ROZKŁAD.FISHER
+FISHERINV = ROZKŁAD.FISHER.ODW
+FORECAST.ETS = REGLINX.ETS
+FORECAST.ETS.CONFINT = REGLINX.ETS.CONFINT
+FORECAST.ETS.SEASONALITY = REGLINX.ETS.SEZONOWOŚĆ
+FORECAST.ETS.STAT = REGLINX.ETS.STATYSTYKA
+FORECAST.LINEAR = REGLINX.LINIOWA
+FREQUENCY = CZĘSTOŚĆ
+GAMMA = GAMMA
+GAMMA.DIST = ROZKŁ.GAMMA
+GAMMA.INV = ROZKŁ.GAMMA.ODWR
+GAMMALN = ROZKŁAD.LIN.GAMMA
+GAMMALN.PRECISE = ROZKŁAD.LIN.GAMMA.DOKŁ
+GAUSS = GAUSS
+GEOMEAN = ŚREDNIA.GEOMETRYCZNA
+GROWTH = REGEXPW
+HARMEAN = ŚREDNIA.HARMONICZNA
+HYPGEOM.DIST = ROZKŁ.HIPERGEOM
+INTERCEPT = ODCIĘTA
+KURT = KURTOZA
+LARGE = MAX.K
+LINEST = REGLINP
+LOGEST = REGEXPP
+LOGNORM.DIST = ROZKŁ.LOG
+LOGNORM.INV = ROZKŁ.LOG.ODWR
+MAX = MAX
+MAXA = MAX.A
+MAXIFS = MAKS.WARUNKÓW
+MEDIAN = MEDIANA
+MIN = MIN
+MINA = MIN.A
+MINIFS = MIN.WARUNKÓW
+MODE.MULT = WYST.NAJCZĘŚCIEJ.TABL
+MODE.SNGL = WYST.NAJCZĘŚCIEJ.WART
+NEGBINOM.DIST = ROZKŁ.DWUM.PRZEC
+NORM.DIST = ROZKŁ.NORMALNY
+NORM.INV = ROZKŁ.NORMALNY.ODWR
+NORM.S.DIST = ROZKŁ.NORMALNY.S
+NORM.S.INV = ROZKŁ.NORMALNY.S.ODWR
+PEARSON = PEARSON
+PERCENTILE.EXC = PERCENTYL.PRZEDZ.OTW
+PERCENTILE.INC = PERCENTYL.PRZEDZ.ZAMK
+PERCENTRANK.EXC = PROC.POZ.PRZEDZ.OTW
+PERCENTRANK.INC = PROC.POZ.PRZEDZ.ZAMK
+PERMUT = PERMUTACJE
+PERMUTATIONA = PERMUTACJE.A
+PHI = PHI
+POISSON.DIST = ROZKŁ.POISSON
+PROB = PRAWDPD
+QUARTILE.EXC = KWARTYL.PRZEDZ.OTW
+QUARTILE.INC = KWARTYL.PRZEDZ.ZAMK
+RANK.AVG = POZYCJA.ŚR
+RANK.EQ = POZYCJA.NAJW
+RSQ = R.KWADRAT
+SKEW = SKOŚNOŚĆ
+SKEW.P = SKOŚNOŚĆ.P
+SLOPE = NACHYLENIE
+SMALL = MIN.K
+STANDARDIZE = NORMALIZUJ
+STDEV.P = ODCH.STAND.POPUL
+STDEV.S = ODCH.STANDARD.PRÓBKI
+STDEVA = ODCH.STANDARDOWE.A
+STDEVPA = ODCH.STANDARD.POPUL.A
+STEYX = REGBŁSTD
+T.DIST = ROZKŁ.T
+T.DIST.2T = ROZKŁ.T.DS
+T.DIST.RT = ROZKŁ.T.PS
+T.INV = ROZKŁ.T.ODWR
+T.INV.2T = ROZKŁ.T.ODWR.DS
+T.TEST = T.TEST
+TREND = REGLINW
+TRIMMEAN = ŚREDNIA.WEWN
+VAR.P = WARIANCJA.POP
+VAR.S = WARIANCJA.PRÓBKI
+VARA = WARIANCJA.A
+VARPA = WARIANCJA.POPUL.A
+WEIBULL.DIST = ROZKŁ.WEIBULL
+Z.TEST = Z.TEST
+
+##
+## Funkcje tekstowe (Text Functions)
+##
+BAHTTEXT = BAT.TEKST
+CHAR = ZNAK
+CLEAN = OCZYŚĆ
+CODE = KOD
+CONCAT = ZŁĄCZ.TEKST
+DOLLAR = KWOTA
+EXACT = PORÓWNAJ
+FIND = ZNAJDŹ
+FIXED = ZAOKR.DO.TEKST
+ISTHAIDIGIT = CZY.CYFRA.TAJ
+LEFT = LEWY
+LEN = DŁ
+LOWER = LITERY.MAŁE
+MID = FRAGMENT.TEKSTU
+NUMBERSTRING = LICZBA.CIĄG.ZNAK
+NUMBERVALUE = WARTOŚĆ.LICZBOWA
+PROPER = Z.WIELKIEJ.LITERY
+REPLACE = ZASTĄP
+REPT = POWT
+RIGHT = PRAWY
+SEARCH = SZUKAJ.TEKST
+SUBSTITUTE = PODSTAW
+T = T
+TEXT = TEKST
+TEXTJOIN = POŁĄCZ.TEKSTY
+THAIDIGIT = TAJ.CYFRA
+THAINUMSOUND = TAJ.DŹWIĘK.NUM
+THAINUMSTRING = TAJ.CIĄG.NUM
+THAISTRINGLENGTH = TAJ.DŁUGOŚĆ.CIĄGU
+TRIM = USUŃ.ZBĘDNE.ODSTĘPY
+UNICHAR = ZNAK.UNICODE
+UNICODE = UNICODE
+UPPER = LITERY.WIELKIE
+VALUE = WARTOŚĆ
+
+##
+## Funkcje sieci Web (Web Functions)
+##
+ENCODEURL = ENCODEURL
+FILTERXML = FILTERXML
+WEBSERVICE = WEBSERVICE
+
+##
+## Funkcje zgodności (Compatibility Functions)
+##
+BETADIST = ROZKŁAD.BETA
+BETAINV = ROZKŁAD.BETA.ODW
+BINOMDIST = ROZKŁAD.DWUM
+CEILING = ZAOKR.W.GÓRĘ
+CHIDIST = ROZKŁAD.CHI
+CHIINV = ROZKŁAD.CHI.ODW
+CHITEST = TEST.CHI
+CONCATENATE = ZŁĄCZ.TEKSTY
+CONFIDENCE = UFNOŚĆ
+COVAR = KOWARIANCJA
+CRITBINOM = PRÓG.ROZKŁAD.DWUM
+EXPONDIST = ROZKŁAD.EXP
+FDIST = ROZKŁAD.F
+FINV = ROZKŁAD.F.ODW
+FLOOR = ZAOKR.W.DÓŁ
+FORECAST = REGLINX
+FTEST = TEST.F
+GAMMADIST = ROZKŁAD.GAMMA
+GAMMAINV = ROZKŁAD.GAMMA.ODW
+HYPGEOMDIST = ROZKŁAD.HIPERGEOM
+LOGINV = ROZKŁAD.LOG.ODW
+LOGNORMDIST = ROZKŁAD.LOG
+MODE = WYST.NAJCZĘŚCIEJ
+NEGBINOMDIST = ROZKŁAD.DWUM.PRZEC
+NORMDIST = ROZKŁAD.NORMALNY
+NORMINV = ROZKŁAD.NORMALNY.ODW
+NORMSDIST = ROZKŁAD.NORMALNY.S
+NORMSINV = ROZKŁAD.NORMALNY.S.ODW
+PERCENTILE = PERCENTYL
+PERCENTRANK = PROCENT.POZYCJA
+POISSON = ROZKŁAD.POISSON
+QUARTILE = KWARTYL
+RANK = POZYCJA
+STDEV = ODCH.STANDARDOWE
+STDEVP = ODCH.STANDARD.POPUL
+TDIST = ROZKŁAD.T
+TINV = ROZKŁAD.T.ODW
+TTEST = TEST.T
+VAR = WARIANCJA
+VARP = WARIANCJA.POPUL
+WEIBULL = ROZKŁAD.WEIBULL
+ZTEST = TEST.Z
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pt/br/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pt/br/config
new file mode 100644
index 00000000..c39057c7
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pt/br/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Português Brasileiro (Brazilian Portuguese)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL = #NULO!
+DIV0
+VALUE = #VALOR!
+REF
+NAME = #NOME?
+NUM = #NÚM!
+NA = #N/D
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pt/br/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pt/br/functions
new file mode 100644
index 00000000..5781b0c7
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pt/br/functions
@@ -0,0 +1,528 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Português Brasileiro (Brazilian Portuguese)
+##
+############################################################
+
+
+##
+## Funções de cubo (Cube Functions)
+##
+CUBEKPIMEMBER = MEMBROKPICUBO
+CUBEMEMBER = MEMBROCUBO
+CUBEMEMBERPROPERTY = PROPRIEDADEMEMBROCUBO
+CUBERANKEDMEMBER = MEMBROCLASSIFICADOCUBO
+CUBESET = CONJUNTOCUBO
+CUBESETCOUNT = CONTAGEMCONJUNTOCUBO
+CUBEVALUE = VALORCUBO
+
+##
+## Funções de banco de dados (Database Functions)
+##
+DAVERAGE = BDMÉDIA
+DCOUNT = BDCONTAR
+DCOUNTA = BDCONTARA
+DGET = BDEXTRAIR
+DMAX = BDMÁX
+DMIN = BDMÍN
+DPRODUCT = BDMULTIPL
+DSTDEV = BDEST
+DSTDEVP = BDDESVPA
+DSUM = BDSOMA
+DVAR = BDVAREST
+DVARP = BDVARP
+
+##
+## Funções de data e hora (Date & Time Functions)
+##
+DATE = DATA
+DATEDIF = DATADIF
+DATESTRING = DATA.SÉRIE
+DATEVALUE = DATA.VALOR
+DAY = DIA
+DAYS = DIAS
+DAYS360 = DIAS360
+EDATE = DATAM
+EOMONTH = FIMMÊS
+HOUR = HORA
+ISOWEEKNUM = NÚMSEMANAISO
+MINUTE = MINUTO
+MONTH = MÊS
+NETWORKDAYS = DIATRABALHOTOTAL
+NETWORKDAYS.INTL = DIATRABALHOTOTAL.INTL
+NOW = AGORA
+SECOND = SEGUNDO
+TIME = TEMPO
+TIMEVALUE = VALOR.TEMPO
+TODAY = HOJE
+WEEKDAY = DIA.DA.SEMANA
+WEEKNUM = NÚMSEMANA
+WORKDAY = DIATRABALHO
+WORKDAY.INTL = DIATRABALHO.INTL
+YEAR = ANO
+YEARFRAC = FRAÇÃOANO
+
+##
+## Funções de engenharia (Engineering Functions)
+##
+BESSELI = BESSELI
+BESSELJ = BESSELJ
+BESSELK = BESSELK
+BESSELY = BESSELY
+BIN2DEC = BINADEC
+BIN2HEX = BINAHEX
+BIN2OCT = BINAOCT
+BITAND = BITAND
+BITLSHIFT = DESLOCESQBIT
+BITOR = BITOR
+BITRSHIFT = DESLOCDIRBIT
+BITXOR = BITXOR
+COMPLEX = COMPLEXO
+CONVERT = CONVERTER
+DEC2BIN = DECABIN
+DEC2HEX = DECAHEX
+DEC2OCT = DECAOCT
+DELTA = DELTA
+ERF = FUNERRO
+ERF.PRECISE = FUNERRO.PRECISO
+ERFC = FUNERROCOMPL
+ERFC.PRECISE = FUNERROCOMPL.PRECISO
+GESTEP = DEGRAU
+HEX2BIN = HEXABIN
+HEX2DEC = HEXADEC
+HEX2OCT = HEXAOCT
+IMABS = IMABS
+IMAGINARY = IMAGINÁRIO
+IMARGUMENT = IMARG
+IMCONJUGATE = IMCONJ
+IMCOS = IMCOS
+IMCOSH = IMCOSH
+IMCOT = IMCOT
+IMCSC = IMCOSEC
+IMCSCH = IMCOSECH
+IMDIV = IMDIV
+IMEXP = IMEXP
+IMLN = IMLN
+IMLOG10 = IMLOG10
+IMLOG2 = IMLOG2
+IMPOWER = IMPOT
+IMPRODUCT = IMPROD
+IMREAL = IMREAL
+IMSEC = IMSEC
+IMSECH = IMSECH
+IMSIN = IMSENO
+IMSINH = IMSENH
+IMSQRT = IMRAIZ
+IMSUB = IMSUBTR
+IMSUM = IMSOMA
+IMTAN = IMTAN
+OCT2BIN = OCTABIN
+OCT2DEC = OCTADEC
+OCT2HEX = OCTAHEX
+
+##
+## Funções financeiras (Financial Functions)
+##
+ACCRINT = JUROSACUM
+ACCRINTM = JUROSACUMV
+AMORDEGRC = AMORDEGRC
+AMORLINC = AMORLINC
+COUPDAYBS = CUPDIASINLIQ
+COUPDAYS = CUPDIAS
+COUPDAYSNC = CUPDIASPRÓX
+COUPNCD = CUPDATAPRÓX
+COUPNUM = CUPNÚM
+COUPPCD = CUPDATAANT
+CUMIPMT = PGTOJURACUM
+CUMPRINC = PGTOCAPACUM
+DB = BD
+DDB = BDD
+DISC = DESC
+DOLLARDE = MOEDADEC
+DOLLARFR = MOEDAFRA
+DURATION = DURAÇÃO
+EFFECT = EFETIVA
+FV = VF
+FVSCHEDULE = VFPLANO
+INTRATE = TAXAJUROS
+IPMT = IPGTO
+IRR = TIR
+ISPMT = ÉPGTO
+MDURATION = MDURAÇÃO
+MIRR = MTIR
+NOMINAL = NOMINAL
+NPER = NPER
+NPV = VPL
+ODDFPRICE = PREÇOPRIMINC
+ODDFYIELD = LUCROPRIMINC
+ODDLPRICE = PREÇOÚLTINC
+ODDLYIELD = LUCROÚLTINC
+PDURATION = DURAÇÃOP
+PMT = PGTO
+PPMT = PPGTO
+PRICE = PREÇO
+PRICEDISC = PREÇODESC
+PRICEMAT = PREÇOVENC
+PV = VP
+RATE = TAXA
+RECEIVED = RECEBER
+RRI = TAXAJURO
+SLN = DPD
+SYD = SDA
+TBILLEQ = OTN
+TBILLPRICE = OTNVALOR
+TBILLYIELD = OTNLUCRO
+VDB = BDV
+XIRR = XTIR
+XNPV = XVPL
+YIELD = LUCRO
+YIELDDISC = LUCRODESC
+YIELDMAT = LUCROVENC
+
+##
+## Funções de informação (Information Functions)
+##
+CELL = CÉL
+ERROR.TYPE = TIPO.ERRO
+INFO = INFORMAÇÃO
+ISBLANK = ÉCÉL.VAZIA
+ISERR = ÉERRO
+ISERROR = ÉERROS
+ISEVEN = ÉPAR
+ISFORMULA = ÉFÓRMULA
+ISLOGICAL = ÉLÓGICO
+ISNA = É.NÃO.DISP
+ISNONTEXT = É.NÃO.TEXTO
+ISNUMBER = ÉNÚM
+ISODD = ÉIMPAR
+ISREF = ÉREF
+ISTEXT = ÉTEXTO
+N = N
+NA = NÃO.DISP
+SHEET = PLAN
+SHEETS = PLANS
+TYPE = TIPO
+
+##
+## Funções lógicas (Logical Functions)
+##
+AND = E
+FALSE = FALSO
+IF = SE
+IFERROR = SEERRO
+IFNA = SENÃODISP
+IFS = SES
+NOT = NÃO
+OR = OU
+SWITCH = PARÂMETRO
+TRUE = VERDADEIRO
+XOR = XOR
+
+##
+## Funções de pesquisa e referência (Lookup & Reference Functions)
+##
+ADDRESS = ENDEREÇO
+AREAS = ÁREAS
+CHOOSE = ESCOLHER
+COLUMN = COL
+COLUMNS = COLS
+FORMULATEXT = FÓRMULATEXTO
+GETPIVOTDATA = INFODADOSTABELADINÂMICA
+HLOOKUP = PROCH
+HYPERLINK = HIPERLINK
+INDEX = ÍNDICE
+INDIRECT = INDIRETO
+LOOKUP = PROC
+MATCH = CORRESP
+OFFSET = DESLOC
+ROW = LIN
+ROWS = LINS
+RTD = RTD
+TRANSPOSE = TRANSPOR
+VLOOKUP = PROCV
+*RC = LC
+
+##
+## Funções matemáticas e trigonométricas (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = ACOS
+ACOSH = ACOSH
+ACOT = ACOT
+ACOTH = ACOTH
+AGGREGATE = AGREGAR
+ARABIC = ARÁBICO
+ASIN = ASEN
+ASINH = ASENH
+ATAN = ATAN
+ATAN2 = ATAN2
+ATANH = ATANH
+BASE = BASE
+CEILING.MATH = TETO.MAT
+CEILING.PRECISE = TETO.PRECISO
+COMBIN = COMBIN
+COMBINA = COMBINA
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = COSEC
+CSCH = COSECH
+DECIMAL = DECIMAL
+DEGREES = GRAUS
+ECMA.CEILING = ECMA.TETO
+EVEN = PAR
+EXP = EXP
+FACT = FATORIAL
+FACTDOUBLE = FATDUPLO
+FLOOR.MATH = ARREDMULTB.MAT
+FLOOR.PRECISE = ARREDMULTB.PRECISO
+GCD = MDC
+INT = INT
+ISO.CEILING = ISO.TETO
+LCM = MMC
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = MATRIZ.DETERM
+MINVERSE = MATRIZ.INVERSO
+MMULT = MATRIZ.MULT
+MOD = MOD
+MROUND = MARRED
+MULTINOMIAL = MULTINOMIAL
+MUNIT = MUNIT
+ODD = ÍMPAR
+PI = PI
+POWER = POTÊNCIA
+PRODUCT = MULT
+QUOTIENT = QUOCIENTE
+RADIANS = RADIANOS
+RAND = ALEATÓRIO
+RANDBETWEEN = ALEATÓRIOENTRE
+ROMAN = ROMANO
+ROUND = ARRED
+ROUNDDOWN = ARREDONDAR.PARA.BAIXO
+ROUNDUP = ARREDONDAR.PARA.CIMA
+SEC = SEC
+SECH = SECH
+SERIESSUM = SOMASEQÜÊNCIA
+SIGN = SINAL
+SIN = SEN
+SINH = SENH
+SQRT = RAIZ
+SQRTPI = RAIZPI
+SUBTOTAL = SUBTOTAL
+SUM = SOMA
+SUMIF = SOMASE
+SUMIFS = SOMASES
+SUMPRODUCT = SOMARPRODUTO
+SUMSQ = SOMAQUAD
+SUMX2MY2 = SOMAX2DY2
+SUMX2PY2 = SOMAX2SY2
+SUMXMY2 = SOMAXMY2
+TAN = TAN
+TANH = TANH
+TRUNC = TRUNCAR
+
+##
+## Funções estatísticas (Statistical Functions)
+##
+AVEDEV = DESV.MÉDIO
+AVERAGE = MÉDIA
+AVERAGEA = MÉDIAA
+AVERAGEIF = MÉDIASE
+AVERAGEIFS = MÉDIASES
+BETA.DIST = DIST.BETA
+BETA.INV = INV.BETA
+BINOM.DIST = DISTR.BINOM
+BINOM.DIST.RANGE = INTERV.DISTR.BINOM
+BINOM.INV = INV.BINOM
+CHISQ.DIST = DIST.QUIQUA
+CHISQ.DIST.RT = DIST.QUIQUA.CD
+CHISQ.INV = INV.QUIQUA
+CHISQ.INV.RT = INV.QUIQUA.CD
+CHISQ.TEST = TESTE.QUIQUA
+CONFIDENCE.NORM = INT.CONFIANÇA.NORM
+CONFIDENCE.T = INT.CONFIANÇA.T
+CORREL = CORREL
+COUNT = CONT.NÚM
+COUNTA = CONT.VALORES
+COUNTBLANK = CONTAR.VAZIO
+COUNTIF = CONT.SE
+COUNTIFS = CONT.SES
+COVARIANCE.P = COVARIAÇÃO.P
+COVARIANCE.S = COVARIAÇÃO.S
+DEVSQ = DESVQ
+EXPON.DIST = DISTR.EXPON
+F.DIST = DIST.F
+F.DIST.RT = DIST.F.CD
+F.INV = INV.F
+F.INV.RT = INV.F.CD
+F.TEST = TESTE.F
+FISHER = FISHER
+FISHERINV = FISHERINV
+FORECAST.ETS = PREVISÃO.ETS
+FORECAST.ETS.CONFINT = PREVISÃO.ETS.CONFINT
+FORECAST.ETS.SEASONALITY = PREVISÃO.ETS.SAZONALIDADE
+FORECAST.ETS.STAT = PREVISÃO.ETS.STAT
+FORECAST.LINEAR = PREVISÃO.LINEAR
+FREQUENCY = FREQÜÊNCIA
+GAMMA = GAMA
+GAMMA.DIST = DIST.GAMA
+GAMMA.INV = INV.GAMA
+GAMMALN = LNGAMA
+GAMMALN.PRECISE = LNGAMA.PRECISO
+GAUSS = GAUSS
+GEOMEAN = MÉDIA.GEOMÉTRICA
+GROWTH = CRESCIMENTO
+HARMEAN = MÉDIA.HARMÔNICA
+HYPGEOM.DIST = DIST.HIPERGEOM.N
+INTERCEPT = INTERCEPÇÃO
+KURT = CURT
+LARGE = MAIOR
+LINEST = PROJ.LIN
+LOGEST = PROJ.LOG
+LOGNORM.DIST = DIST.LOGNORMAL.N
+LOGNORM.INV = INV.LOGNORMAL
+MAX = MÁXIMO
+MAXA = MÁXIMOA
+MAXIFS = MÁXIMOSES
+MEDIAN = MED
+MIN = MÍNIMO
+MINA = MÍNIMOA
+MINIFS = MÍNIMOSES
+MODE.MULT = MODO.MULT
+MODE.SNGL = MODO.ÚNICO
+NEGBINOM.DIST = DIST.BIN.NEG.N
+NORM.DIST = DIST.NORM.N
+NORM.INV = INV.NORM.N
+NORM.S.DIST = DIST.NORMP.N
+NORM.S.INV = INV.NORMP.N
+PEARSON = PEARSON
+PERCENTILE.EXC = PERCENTIL.EXC
+PERCENTILE.INC = PERCENTIL.INC
+PERCENTRANK.EXC = ORDEM.PORCENTUAL.EXC
+PERCENTRANK.INC = ORDEM.PORCENTUAL.INC
+PERMUT = PERMUT
+PERMUTATIONA = PERMUTAS
+PHI = PHI
+POISSON.DIST = DIST.POISSON
+PROB = PROB
+QUARTILE.EXC = QUARTIL.EXC
+QUARTILE.INC = QUARTIL.INC
+RANK.AVG = ORDEM.MÉD
+RANK.EQ = ORDEM.EQ
+RSQ = RQUAD
+SKEW = DISTORÇÃO
+SKEW.P = DISTORÇÃO.P
+SLOPE = INCLINAÇÃO
+SMALL = MENOR
+STANDARDIZE = PADRONIZAR
+STDEV.P = DESVPAD.P
+STDEV.S = DESVPAD.A
+STDEVA = DESVPADA
+STDEVPA = DESVPADPA
+STEYX = EPADYX
+T.DIST = DIST.T
+T.DIST.2T = DIST.T.BC
+T.DIST.RT = DIST.T.CD
+T.INV = INV.T
+T.INV.2T = INV.T.BC
+T.TEST = TESTE.T
+TREND = TENDÊNCIA
+TRIMMEAN = MÉDIA.INTERNA
+VAR.P = VAR.P
+VAR.S = VAR.A
+VARA = VARA
+VARPA = VARPA
+WEIBULL.DIST = DIST.WEIBULL
+Z.TEST = TESTE.Z
+
+##
+## Funções de texto (Text Functions)
+##
+BAHTTEXT = BAHTTEXT
+CHAR = CARACT
+CLEAN = TIRAR
+CODE = CÓDIGO
+CONCAT = CONCAT
+DOLLAR = MOEDA
+EXACT = EXATO
+FIND = PROCURAR
+FIXED = DEF.NÚM.DEC
+LEFT = ESQUERDA
+LEN = NÚM.CARACT
+LOWER = MINÚSCULA
+MID = EXT.TEXTO
+NUMBERSTRING = SEQÜÊNCIA.NÚMERO
+NUMBERVALUE = VALORNUMÉRICO
+PHONETIC = FONÉTICA
+PROPER = PRI.MAIÚSCULA
+REPLACE = MUDAR
+REPT = REPT
+RIGHT = DIREITA
+SEARCH = LOCALIZAR
+SUBSTITUTE = SUBSTITUIR
+T = T
+TEXT = TEXTO
+TEXTJOIN = UNIRTEXTO
+TRIM = ARRUMAR
+UNICHAR = CARACTUNICODE
+UNICODE = UNICODE
+UPPER = MAIÚSCULA
+VALUE = VALOR
+
+##
+## Funções da Web (Web Functions)
+##
+ENCODEURL = CODIFURL
+FILTERXML = FILTROXML
+WEBSERVICE = SERVIÇOWEB
+
+##
+## Funções de compatibilidade (Compatibility Functions)
+##
+BETADIST = DISTBETA
+BETAINV = BETA.ACUM.INV
+BINOMDIST = DISTRBINOM
+CEILING = TETO
+CHIDIST = DIST.QUI
+CHIINV = INV.QUI
+CHITEST = TESTE.QUI
+CONCATENATE = CONCATENAR
+CONFIDENCE = INT.CONFIANÇA
+COVAR = COVAR
+CRITBINOM = CRIT.BINOM
+EXPONDIST = DISTEXPON
+FDIST = DISTF
+FINV = INVF
+FLOOR = ARREDMULTB
+FORECAST = PREVISÃO
+FTEST = TESTEF
+GAMMADIST = DISTGAMA
+GAMMAINV = INVGAMA
+HYPGEOMDIST = DIST.HIPERGEOM
+LOGINV = INVLOG
+LOGNORMDIST = DIST.LOGNORMAL
+MODE = MODO
+NEGBINOMDIST = DIST.BIN.NEG
+NORMDIST = DISTNORM
+NORMINV = INV.NORM
+NORMSDIST = DISTNORMP
+NORMSINV = INV.NORMP
+PERCENTILE = PERCENTIL
+PERCENTRANK = ORDEM.PORCENTUAL
+POISSON = POISSON
+QUARTILE = QUARTIL
+RANK = ORDEM
+STDEV = DESVPAD
+STDEVP = DESVPADP
+TDIST = DISTT
+TINV = INVT
+TTEST = TESTET
+VAR = VAR
+VARP = VARP
+WEIBULL = WEIBULL
+ZTEST = TESTEZ
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pt/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pt/config
new file mode 100644
index 00000000..e661830b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pt/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Português (Portuguese)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL = #NULO!
+DIV0
+VALUE = #VALOR!
+REF
+NAME = #NOME?
+NUM = #NÚM!
+NA = #N/D
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pt/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pt/functions
new file mode 100644
index 00000000..70a3bb0c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/pt/functions
@@ -0,0 +1,538 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Português (Portuguese)
+##
+############################################################
+
+
+##
+## Funções de cubo (Cube Functions)
+##
+CUBEKPIMEMBER = MEMBROKPICUBO
+CUBEMEMBER = MEMBROCUBO
+CUBEMEMBERPROPERTY = PROPRIEDADEMEMBROCUBO
+CUBERANKEDMEMBER = MEMBROCLASSIFICADOCUBO
+CUBESET = CONJUNTOCUBO
+CUBESETCOUNT = CONTARCONJUNTOCUBO
+CUBEVALUE = VALORCUBO
+
+##
+## Funções de base de dados (Database Functions)
+##
+DAVERAGE = BDMÉDIA
+DCOUNT = BDCONTAR
+DCOUNTA = BDCONTAR.VAL
+DGET = BDOBTER
+DMAX = BDMÁX
+DMIN = BDMÍN
+DPRODUCT = BDMULTIPL
+DSTDEV = BDDESVPAD
+DSTDEVP = BDDESVPADP
+DSUM = BDSOMA
+DVAR = BDVAR
+DVARP = BDVARP
+
+##
+## Funções de data e hora (Date & Time Functions)
+##
+DATE = DATA
+DATEDIF = DATADIF
+DATESTRING = DATA.CADEIA
+DATEVALUE = DATA.VALOR
+DAY = DIA
+DAYS = DIAS
+DAYS360 = DIAS360
+EDATE = DATAM
+EOMONTH = FIMMÊS
+HOUR = HORA
+ISOWEEKNUM = NUMSEMANAISO
+MINUTE = MINUTO
+MONTH = MÊS
+NETWORKDAYS = DIATRABALHOTOTAL
+NETWORKDAYS.INTL = DIATRABALHOTOTAL.INTL
+NOW = AGORA
+SECOND = SEGUNDO
+THAIDAYOFWEEK = DIA.DA.SEMANA.TAILANDÊS
+THAIMONTHOFYEAR = MÊS.DO.ANO.TAILANDÊS
+THAIYEAR = ANO.TAILANDÊS
+TIME = TEMPO
+TIMEVALUE = VALOR.TEMPO
+TODAY = HOJE
+WEEKDAY = DIA.SEMANA
+WEEKNUM = NÚMSEMANA
+WORKDAY = DIATRABALHO
+WORKDAY.INTL = DIATRABALHO.INTL
+YEAR = ANO
+YEARFRAC = FRAÇÃOANO
+
+##
+## Funções de engenharia (Engineering Functions)
+##
+BESSELI = BESSELI
+BESSELJ = BESSELJ
+BESSELK = BESSELK
+BESSELY = BESSELY
+BIN2DEC = BINADEC
+BIN2HEX = BINAHEX
+BIN2OCT = BINAOCT
+BITAND = BIT.E
+BITLSHIFT = BITDESL.ESQ
+BITOR = BIT.OU
+BITRSHIFT = BITDESL.DIR
+BITXOR = BIT.XOU
+COMPLEX = COMPLEXO
+CONVERT = CONVERTER
+DEC2BIN = DECABIN
+DEC2HEX = DECAHEX
+DEC2OCT = DECAOCT
+DELTA = DELTA
+ERF = FUNCERRO
+ERF.PRECISE = FUNCERRO.PRECISO
+ERFC = FUNCERROCOMPL
+ERFC.PRECISE = FUNCERROCOMPL.PRECISO
+GESTEP = DEGRAU
+HEX2BIN = HEXABIN
+HEX2DEC = HEXADEC
+HEX2OCT = HEXAOCT
+IMABS = IMABS
+IMAGINARY = IMAGINÁRIO
+IMARGUMENT = IMARG
+IMCONJUGATE = IMCONJ
+IMCOS = IMCOS
+IMCOSH = IMCOSH
+IMCOT = IMCOT
+IMCSC = IMCSC
+IMCSCH = IMCSCH
+IMDIV = IMDIV
+IMEXP = IMEXP
+IMLN = IMLN
+IMLOG10 = IMLOG10
+IMLOG2 = IMLOG2
+IMPOWER = IMPOT
+IMPRODUCT = IMPROD
+IMREAL = IMREAL
+IMSEC = IMSEC
+IMSECH = IMSECH
+IMSIN = IMSENO
+IMSINH = IMSENOH
+IMSQRT = IMRAIZ
+IMSUB = IMSUBTR
+IMSUM = IMSOMA
+IMTAN = IMTAN
+OCT2BIN = OCTABIN
+OCT2DEC = OCTADEC
+OCT2HEX = OCTAHEX
+
+##
+## Funções financeiras (Financial Functions)
+##
+ACCRINT = JUROSACUM
+ACCRINTM = JUROSACUMV
+AMORDEGRC = AMORDEGRC
+AMORLINC = AMORLINC
+COUPDAYBS = CUPDIASINLIQ
+COUPDAYS = CUPDIAS
+COUPDAYSNC = CUPDIASPRÓX
+COUPNCD = CUPDATAPRÓX
+COUPNUM = CUPNÚM
+COUPPCD = CUPDATAANT
+CUMIPMT = PGTOJURACUM
+CUMPRINC = PGTOCAPACUM
+DB = BD
+DDB = BDD
+DISC = DESC
+DOLLARDE = MOEDADEC
+DOLLARFR = MOEDAFRA
+DURATION = DURAÇÃO
+EFFECT = EFETIVA
+FV = VF
+FVSCHEDULE = VFPLANO
+INTRATE = TAXAJUROS
+IPMT = IPGTO
+IRR = TIR
+ISPMT = É.PGTO
+MDURATION = MDURAÇÃO
+MIRR = MTIR
+NOMINAL = NOMINAL
+NPER = NPER
+NPV = VAL
+ODDFPRICE = PREÇOPRIMINC
+ODDFYIELD = LUCROPRIMINC
+ODDLPRICE = PREÇOÚLTINC
+ODDLYIELD = LUCROÚLTINC
+PDURATION = PDURAÇÃO
+PMT = PGTO
+PPMT = PPGTO
+PRICE = PREÇO
+PRICEDISC = PREÇODESC
+PRICEMAT = PREÇOVENC
+PV = VA
+RATE = TAXA
+RECEIVED = RECEBER
+RRI = DEVOLVERTAXAJUROS
+SLN = AMORT
+SYD = AMORTD
+TBILLEQ = OTN
+TBILLPRICE = OTNVALOR
+TBILLYIELD = OTNLUCRO
+VDB = BDV
+XIRR = XTIR
+XNPV = XVAL
+YIELD = LUCRO
+YIELDDISC = LUCRODESC
+YIELDMAT = LUCROVENC
+
+##
+## Funções de informação (Information Functions)
+##
+CELL = CÉL
+ERROR.TYPE = TIPO.ERRO
+INFO = INFORMAÇÃO
+ISBLANK = É.CÉL.VAZIA
+ISERR = É.ERROS
+ISERROR = É.ERRO
+ISEVEN = ÉPAR
+ISFORMULA = É.FORMULA
+ISLOGICAL = É.LÓGICO
+ISNA = É.NÃO.DISP
+ISNONTEXT = É.NÃO.TEXTO
+ISNUMBER = É.NÚM
+ISODD = ÉÍMPAR
+ISREF = É.REF
+ISTEXT = É.TEXTO
+N = N
+NA = NÃO.DISP
+SHEET = FOLHA
+SHEETS = FOLHAS
+TYPE = TIPO
+
+##
+## Funções lógicas (Logical Functions)
+##
+AND = E
+FALSE = FALSO
+IF = SE
+IFERROR = SE.ERRO
+IFNA = SEND
+IFS = SE.S
+NOT = NÃO
+OR = OU
+SWITCH = PARÂMETRO
+TRUE = VERDADEIRO
+XOR = XOU
+
+##
+## Funções de pesquisa e referência (Lookup & Reference Functions)
+##
+ADDRESS = ENDEREÇO
+AREAS = ÁREAS
+CHOOSE = SELECIONAR
+COLUMN = COL
+COLUMNS = COLS
+FORMULATEXT = FÓRMULA.TEXTO
+GETPIVOTDATA = OBTERDADOSDIN
+HLOOKUP = PROCH
+HYPERLINK = HIPERLIGAÇÃO
+INDEX = ÍNDICE
+INDIRECT = INDIRETO
+LOOKUP = PROC
+MATCH = CORRESP
+OFFSET = DESLOCAMENTO
+ROW = LIN
+ROWS = LINS
+RTD = RTD
+TRANSPOSE = TRANSPOR
+VLOOKUP = PROCV
+*RC = LC
+
+##
+## Funções matemáticas e trigonométricas (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = ACOS
+ACOSH = ACOSH
+ACOT = ACOT
+ACOTH = ACOTH
+AGGREGATE = AGREGAR
+ARABIC = ÁRABE
+ASIN = ASEN
+ASINH = ASENH
+ATAN = ATAN
+ATAN2 = ATAN2
+ATANH = ATANH
+BASE = BASE
+CEILING.MATH = ARRED.EXCESSO.MAT
+CEILING.PRECISE = ARRED.EXCESSO.PRECISO
+COMBIN = COMBIN
+COMBINA = COMBIN.R
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = CSC
+CSCH = CSCH
+DECIMAL = DECIMAL
+DEGREES = GRAUS
+ECMA.CEILING = ARRED.EXCESSO.ECMA
+EVEN = PAR
+EXP = EXP
+FACT = FATORIAL
+FACTDOUBLE = FATDUPLO
+FLOOR.MATH = ARRED.DEFEITO.MAT
+FLOOR.PRECISE = ARRED.DEFEITO.PRECISO
+GCD = MDC
+INT = INT
+ISO.CEILING = ARRED.EXCESSO.ISO
+LCM = MMC
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = MATRIZ.DETERM
+MINVERSE = MATRIZ.INVERSA
+MMULT = MATRIZ.MULT
+MOD = RESTO
+MROUND = MARRED
+MULTINOMIAL = POLINOMIAL
+MUNIT = UNIDM
+ODD = ÍMPAR
+PI = PI
+POWER = POTÊNCIA
+PRODUCT = PRODUTO
+QUOTIENT = QUOCIENTE
+RADIANS = RADIANOS
+RAND = ALEATÓRIO
+RANDBETWEEN = ALEATÓRIOENTRE
+ROMAN = ROMANO
+ROUND = ARRED
+ROUNDBAHTDOWN = ARREDOND.BAHT.BAIXO
+ROUNDBAHTUP = ARREDOND.BAHT.CIMA
+ROUNDDOWN = ARRED.PARA.BAIXO
+ROUNDUP = ARRED.PARA.CIMA
+SEC = SEC
+SECH = SECH
+SERIESSUM = SOMASÉRIE
+SIGN = SINAL
+SIN = SEN
+SINH = SENH
+SQRT = RAIZQ
+SQRTPI = RAIZPI
+SUBTOTAL = SUBTOTAL
+SUM = SOMA
+SUMIF = SOMA.SE
+SUMIFS = SOMA.SE.S
+SUMPRODUCT = SOMARPRODUTO
+SUMSQ = SOMARQUAD
+SUMX2MY2 = SOMAX2DY2
+SUMX2PY2 = SOMAX2SY2
+SUMXMY2 = SOMAXMY2
+TAN = TAN
+TANH = TANH
+TRUNC = TRUNCAR
+
+##
+## Funções estatísticas (Statistical Functions)
+##
+AVEDEV = DESV.MÉDIO
+AVERAGE = MÉDIA
+AVERAGEA = MÉDIAA
+AVERAGEIF = MÉDIA.SE
+AVERAGEIFS = MÉDIA.SE.S
+BETA.DIST = DIST.BETA
+BETA.INV = INV.BETA
+BINOM.DIST = DISTR.BINOM
+BINOM.DIST.RANGE = DIST.BINOM.INTERVALO
+BINOM.INV = INV.BINOM
+CHISQ.DIST = DIST.CHIQ
+CHISQ.DIST.RT = DIST.CHIQ.DIR
+CHISQ.INV = INV.CHIQ
+CHISQ.INV.RT = INV.CHIQ.DIR
+CHISQ.TEST = TESTE.CHIQ
+CONFIDENCE.NORM = INT.CONFIANÇA.NORM
+CONFIDENCE.T = INT.CONFIANÇA.T
+CORREL = CORREL
+COUNT = CONTAR
+COUNTA = CONTAR.VAL
+COUNTBLANK = CONTAR.VAZIO
+COUNTIF = CONTAR.SE
+COUNTIFS = CONTAR.SE.S
+COVARIANCE.P = COVARIÂNCIA.P
+COVARIANCE.S = COVARIÂNCIA.S
+DEVSQ = DESVQ
+EXPON.DIST = DIST.EXPON
+F.DIST = DIST.F
+F.DIST.RT = DIST.F.DIR
+F.INV = INV.F
+F.INV.RT = INV.F.DIR
+F.TEST = TESTE.F
+FISHER = FISHER
+FISHERINV = FISHERINV
+FORECAST.ETS = PREVISÃO.ETS
+FORECAST.ETS.CONFINT = PREVISÃO.ETS.CONFINT
+FORECAST.ETS.SEASONALITY = PREVISÃO.ETS.SAZONALIDADE
+FORECAST.ETS.STAT = PREVISÃO.ETS.ESTATÍSTICA
+FORECAST.LINEAR = PREVISÃO.LINEAR
+FREQUENCY = FREQUÊNCIA
+GAMMA = GAMA
+GAMMA.DIST = DIST.GAMA
+GAMMA.INV = INV.GAMA
+GAMMALN = LNGAMA
+GAMMALN.PRECISE = LNGAMA.PRECISO
+GAUSS = GAUSS
+GEOMEAN = MÉDIA.GEOMÉTRICA
+GROWTH = CRESCIMENTO
+HARMEAN = MÉDIA.HARMÓNICA
+HYPGEOM.DIST = DIST.HIPGEOM
+INTERCEPT = INTERCETAR
+KURT = CURT
+LARGE = MAIOR
+LINEST = PROJ.LIN
+LOGEST = PROJ.LOG
+LOGNORM.DIST = DIST.NORMLOG
+LOGNORM.INV = INV.NORMALLOG
+MAX = MÁXIMO
+MAXA = MÁXIMOA
+MAXIFS = MÁXIMO.SE.S
+MEDIAN = MED
+MIN = MÍNIMO
+MINA = MÍNIMOA
+MINIFS = MÍNIMO.SE.S
+MODE.MULT = MODO.MÚLT
+MODE.SNGL = MODO.SIMPLES
+NEGBINOM.DIST = DIST.BINOM.NEG
+NORM.DIST = DIST.NORMAL
+NORM.INV = INV.NORMAL
+NORM.S.DIST = DIST.S.NORM
+NORM.S.INV = INV.S.NORM
+PEARSON = PEARSON
+PERCENTILE.EXC = PERCENTIL.EXC
+PERCENTILE.INC = PERCENTIL.INC
+PERCENTRANK.EXC = ORDEM.PERCENTUAL.EXC
+PERCENTRANK.INC = ORDEM.PERCENTUAL.INC
+PERMUT = PERMUTAR
+PERMUTATIONA = PERMUTAR.R
+PHI = PHI
+POISSON.DIST = DIST.POISSON
+PROB = PROB
+QUARTILE.EXC = QUARTIL.EXC
+QUARTILE.INC = QUARTIL.INC
+RANK.AVG = ORDEM.MÉD
+RANK.EQ = ORDEM.EQ
+RSQ = RQUAD
+SKEW = DISTORÇÃO
+SKEW.P = DISTORÇÃO.P
+SLOPE = DECLIVE
+SMALL = MENOR
+STANDARDIZE = NORMALIZAR
+STDEV.P = DESVPAD.P
+STDEV.S = DESVPAD.S
+STDEVA = DESVPADA
+STDEVPA = DESVPADPA
+STEYX = EPADYX
+T.DIST = DIST.T
+T.DIST.2T = DIST.T.2C
+T.DIST.RT = DIST.T.DIR
+T.INV = INV.T
+T.INV.2T = INV.T.2C
+T.TEST = TESTE.T
+TREND = TENDÊNCIA
+TRIMMEAN = MÉDIA.INTERNA
+VAR.P = VAR.P
+VAR.S = VAR.S
+VARA = VARA
+VARPA = VARPA
+WEIBULL.DIST = DIST.WEIBULL
+Z.TEST = TESTE.Z
+
+##
+## Funções de texto (Text Functions)
+##
+BAHTTEXT = TEXTO.BAHT
+CHAR = CARÁT
+CLEAN = LIMPARB
+CODE = CÓDIGO
+CONCAT = CONCAT
+DOLLAR = MOEDA
+EXACT = EXATO
+FIND = LOCALIZAR
+FIXED = FIXA
+ISTHAIDIGIT = É.DÍGITO.TAILANDÊS
+LEFT = ESQUERDA
+LEN = NÚM.CARAT
+LOWER = MINÚSCULAS
+MID = SEG.TEXTO
+NUMBERSTRING = NÚMERO.CADEIA
+NUMBERVALUE = VALOR.NÚMERO
+PHONETIC = FONÉTICA
+PROPER = INICIAL.MAIÚSCULA
+REPLACE = SUBSTITUIR
+REPT = REPETIR
+RIGHT = DIREITA
+SEARCH = PROCURAR
+SUBSTITUTE = SUBST
+T = T
+TEXT = TEXTO
+TEXTJOIN = UNIRTEXTO
+THAIDIGIT = DÍGITO.TAILANDÊS
+THAINUMSOUND = SOM.NÚM.TAILANDÊS
+THAINUMSTRING = CADEIA.NÚM.TAILANDÊS
+THAISTRINGLENGTH = COMP.CADEIA.TAILANDÊS
+TRIM = COMPACTAR
+UNICHAR = UNICARÁT
+UNICODE = UNICODE
+UPPER = MAIÚSCULAS
+VALUE = VALOR
+
+##
+## Funções da Web (Web Functions)
+##
+ENCODEURL = CODIFICAÇÃOURL
+FILTERXML = FILTRARXML
+WEBSERVICE = SERVIÇOWEB
+
+##
+## Funções de compatibilidade (Compatibility Functions)
+##
+BETADIST = DISTBETA
+BETAINV = BETA.ACUM.INV
+BINOMDIST = DISTRBINOM
+CEILING = ARRED.EXCESSO
+CHIDIST = DIST.CHI
+CHIINV = INV.CHI
+CHITEST = TESTE.CHI
+CONCATENATE = CONCATENAR
+CONFIDENCE = INT.CONFIANÇA
+COVAR = COVAR
+CRITBINOM = CRIT.BINOM
+EXPONDIST = DISTEXPON
+FDIST = DISTF
+FINV = INVF
+FLOOR = ARRED.DEFEITO
+FORECAST = PREVISÃO
+FTEST = TESTEF
+GAMMADIST = DISTGAMA
+GAMMAINV = INVGAMA
+HYPGEOMDIST = DIST.HIPERGEOM
+LOGINV = INVLOG
+LOGNORMDIST = DIST.NORMALLOG
+MODE = MODA
+NEGBINOMDIST = DIST.BIN.NEG
+NORMDIST = DIST.NORM
+NORMINV = INV.NORM
+NORMSDIST = DIST.NORMP
+NORMSINV = INV.NORMP
+PERCENTILE = PERCENTIL
+PERCENTRANK = ORDEM.PERCENTUAL
+POISSON = POISSON
+QUARTILE = QUARTIL
+RANK = ORDEM
+STDEV = DESVPAD
+STDEVP = DESVPADP
+TDIST = DISTT
+TINV = INVT
+TTEST = TESTET
+VAR = VAR
+VARP = VARP
+WEIBULL = WEIBULL
+ZTEST = TESTEZ
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/ru/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/ru/config
new file mode 100644
index 00000000..2a5a0db8
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/ru/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## русский язык (Russian)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL = #ПУСТО!
+DIV0 = #ДЕЛ/0!
+VALUE = #ЗНАЧ!
+REF = #ССЫЛКА!
+NAME = #ИМЯ?
+NUM = #ЧИСЛО!
+NA = #Н/Д
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/ru/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/ru/functions
new file mode 100644
index 00000000..9f05d5af
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/ru/functions
@@ -0,0 +1,555 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## русский язык (Russian)
+##
+############################################################
+
+
+##
+## Функции кубов (Cube Functions)
+##
+CUBEKPIMEMBER = КУБЭЛЕМЕНТКИП
+CUBEMEMBER = КУБЭЛЕМЕНТ
+CUBEMEMBERPROPERTY = КУБСВОЙСТВОЭЛЕМЕНТА
+CUBERANKEDMEMBER = КУБПОРЭЛЕМЕНТ
+CUBESET = КУБМНОЖ
+CUBESETCOUNT = КУБЧИСЛОЭЛМНОЖ
+CUBEVALUE = КУБЗНАЧЕНИЕ
+
+##
+## Функции для работы с базами данных (Database Functions)
+##
+DAVERAGE = ДСРЗНАЧ
+DCOUNT = БСЧЁТ
+DCOUNTA = БСЧЁТА
+DGET = БИЗВЛЕЧЬ
+DMAX = ДМАКС
+DMIN = ДМИН
+DPRODUCT = БДПРОИЗВЕД
+DSTDEV = ДСТАНДОТКЛ
+DSTDEVP = ДСТАНДОТКЛП
+DSUM = БДСУММ
+DVAR = БДДИСП
+DVARP = БДДИСПП
+
+##
+## Функции даты и времени (Date & Time Functions)
+##
+DATE = ДАТА
+DATEDIF = РАЗНДАТ
+DATESTRING = СТРОКАДАННЫХ
+DATEVALUE = ДАТАЗНАЧ
+DAY = ДЕНЬ
+DAYS = ДНИ
+DAYS360 = ДНЕЙ360
+EDATE = ДАТАМЕС
+EOMONTH = КОНМЕСЯЦА
+HOUR = ЧАС
+ISOWEEKNUM = НОМНЕДЕЛИ.ISO
+MINUTE = МИНУТЫ
+MONTH = МЕСЯЦ
+NETWORKDAYS = ЧИСТРАБДНИ
+NETWORKDAYS.INTL = ЧИСТРАБДНИ.МЕЖД
+NOW = ТДАТА
+SECOND = СЕКУНДЫ
+THAIDAYOFWEEK = ТАЙДЕНЬНЕД
+THAIMONTHOFYEAR = ТАЙМЕСЯЦ
+THAIYEAR = ТАЙГОД
+TIME = ВРЕМЯ
+TIMEVALUE = ВРЕМЗНАЧ
+TODAY = СЕГОДНЯ
+WEEKDAY = ДЕНЬНЕД
+WEEKNUM = НОМНЕДЕЛИ
+WORKDAY = РАБДЕНЬ
+WORKDAY.INTL = РАБДЕНЬ.МЕЖД
+YEAR = ГОД
+YEARFRAC = ДОЛЯГОДА
+
+##
+## Инженерные функции (Engineering Functions)
+##
+BESSELI = БЕССЕЛЬ.I
+BESSELJ = БЕССЕЛЬ.J
+BESSELK = БЕССЕЛЬ.K
+BESSELY = БЕССЕЛЬ.Y
+BIN2DEC = ДВ.В.ДЕС
+BIN2HEX = ДВ.В.ШЕСТН
+BIN2OCT = ДВ.В.ВОСЬМ
+BITAND = БИТ.И
+BITLSHIFT = БИТ.СДВИГЛ
+BITOR = БИТ.ИЛИ
+BITRSHIFT = БИТ.СДВИГП
+BITXOR = БИТ.ИСКЛИЛИ
+COMPLEX = КОМПЛЕКСН
+CONVERT = ПРЕОБР
+DEC2BIN = ДЕС.В.ДВ
+DEC2HEX = ДЕС.В.ШЕСТН
+DEC2OCT = ДЕС.В.ВОСЬМ
+DELTA = ДЕЛЬТА
+ERF = ФОШ
+ERF.PRECISE = ФОШ.ТОЧН
+ERFC = ДФОШ
+ERFC.PRECISE = ДФОШ.ТОЧН
+GESTEP = ПОРОГ
+HEX2BIN = ШЕСТН.В.ДВ
+HEX2DEC = ШЕСТН.В.ДЕС
+HEX2OCT = ШЕСТН.В.ВОСЬМ
+IMABS = МНИМ.ABS
+IMAGINARY = МНИМ.ЧАСТЬ
+IMARGUMENT = МНИМ.АРГУМЕНТ
+IMCONJUGATE = МНИМ.СОПРЯЖ
+IMCOS = МНИМ.COS
+IMCOSH = МНИМ.COSH
+IMCOT = МНИМ.COT
+IMCSC = МНИМ.CSC
+IMCSCH = МНИМ.CSCH
+IMDIV = МНИМ.ДЕЛ
+IMEXP = МНИМ.EXP
+IMLN = МНИМ.LN
+IMLOG10 = МНИМ.LOG10
+IMLOG2 = МНИМ.LOG2
+IMPOWER = МНИМ.СТЕПЕНЬ
+IMPRODUCT = МНИМ.ПРОИЗВЕД
+IMREAL = МНИМ.ВЕЩ
+IMSEC = МНИМ.SEC
+IMSECH = МНИМ.SECH
+IMSIN = МНИМ.SIN
+IMSINH = МНИМ.SINH
+IMSQRT = МНИМ.КОРЕНЬ
+IMSUB = МНИМ.РАЗН
+IMSUM = МНИМ.СУММ
+IMTAN = МНИМ.TAN
+OCT2BIN = ВОСЬМ.В.ДВ
+OCT2DEC = ВОСЬМ.В.ДЕС
+OCT2HEX = ВОСЬМ.В.ШЕСТН
+
+##
+## Финансовые функции (Financial Functions)
+##
+ACCRINT = НАКОПДОХОД
+ACCRINTM = НАКОПДОХОДПОГАШ
+AMORDEGRC = АМОРУМ
+AMORLINC = АМОРУВ
+COUPDAYBS = ДНЕЙКУПОНДО
+COUPDAYS = ДНЕЙКУПОН
+COUPDAYSNC = ДНЕЙКУПОНПОСЛЕ
+COUPNCD = ДАТАКУПОНПОСЛЕ
+COUPNUM = ЧИСЛКУПОН
+COUPPCD = ДАТАКУПОНДО
+CUMIPMT = ОБЩПЛАТ
+CUMPRINC = ОБЩДОХОД
+DB = ФУО
+DDB = ДДОБ
+DISC = СКИДКА
+DOLLARDE = РУБЛЬ.ДЕС
+DOLLARFR = РУБЛЬ.ДРОБЬ
+DURATION = ДЛИТ
+EFFECT = ЭФФЕКТ
+FV = БС
+FVSCHEDULE = БЗРАСПИС
+INTRATE = ИНОРМА
+IPMT = ПРПЛТ
+IRR = ВСД
+ISPMT = ПРОЦПЛАТ
+MDURATION = МДЛИТ
+MIRR = МВСД
+NOMINAL = НОМИНАЛ
+NPER = КПЕР
+NPV = ЧПС
+ODDFPRICE = ЦЕНАПЕРВНЕРЕГ
+ODDFYIELD = ДОХОДПЕРВНЕРЕГ
+ODDLPRICE = ЦЕНАПОСЛНЕРЕГ
+ODDLYIELD = ДОХОДПОСЛНЕРЕГ
+PDURATION = ПДЛИТ
+PMT = ПЛТ
+PPMT = ОСПЛТ
+PRICE = ЦЕНА
+PRICEDISC = ЦЕНАСКИДКА
+PRICEMAT = ЦЕНАПОГАШ
+PV = ПС
+RATE = СТАВКА
+RECEIVED = ПОЛУЧЕНО
+RRI = ЭКВ.СТАВКА
+SLN = АПЛ
+SYD = АСЧ
+TBILLEQ = РАВНОКЧЕК
+TBILLPRICE = ЦЕНАКЧЕК
+TBILLYIELD = ДОХОДКЧЕК
+USDOLLAR = ДОЛЛСША
+VDB = ПУО
+XIRR = ЧИСТВНДОХ
+XNPV = ЧИСТНЗ
+YIELD = ДОХОД
+YIELDDISC = ДОХОДСКИДКА
+YIELDMAT = ДОХОДПОГАШ
+
+##
+## Информационные функции (Information Functions)
+##
+CELL = ЯЧЕЙКА
+ERROR.TYPE = ТИП.ОШИБКИ
+INFO = ИНФОРМ
+ISBLANK = ЕПУСТО
+ISERR = ЕОШ
+ISERROR = ЕОШИБКА
+ISEVEN = ЕЧЁТН
+ISFORMULA = ЕФОРМУЛА
+ISLOGICAL = ЕЛОГИЧ
+ISNA = ЕНД
+ISNONTEXT = ЕНЕТЕКСТ
+ISNUMBER = ЕЧИСЛО
+ISODD = ЕНЕЧЁТ
+ISREF = ЕССЫЛКА
+ISTEXT = ЕТЕКСТ
+N = Ч
+NA = НД
+SHEET = ЛИСТ
+SHEETS = ЛИСТЫ
+TYPE = ТИП
+
+##
+## Логические функции (Logical Functions)
+##
+AND = И
+FALSE = ЛОЖЬ
+IF = ЕСЛИ
+IFERROR = ЕСЛИОШИБКА
+IFNA = ЕСНД
+IFS = УСЛОВИЯ
+NOT = НЕ
+OR = ИЛИ
+SWITCH = ПЕРЕКЛЮЧ
+TRUE = ИСТИНА
+XOR = ИСКЛИЛИ
+
+##
+## Функции ссылки и поиска (Lookup & Reference Functions)
+##
+ADDRESS = АДРЕС
+AREAS = ОБЛАСТИ
+CHOOSE = ВЫБОР
+COLUMN = СТОЛБЕЦ
+COLUMNS = ЧИСЛСТОЛБ
+FILTER = ФИЛЬТР
+FORMULATEXT = Ф.ТЕКСТ
+GETPIVOTDATA = ПОЛУЧИТЬ.ДАННЫЕ.СВОДНОЙ.ТАБЛИЦЫ
+HLOOKUP = ГПР
+HYPERLINK = ГИПЕРССЫЛКА
+INDEX = ИНДЕКС
+INDIRECT = ДВССЫЛ
+LOOKUP = ПРОСМОТР
+MATCH = ПОИСКПОЗ
+OFFSET = СМЕЩ
+ROW = СТРОКА
+ROWS = ЧСТРОК
+RTD = ДРВ
+SORT = СОРТ
+SORTBY = СОРТПО
+TRANSPOSE = ТРАНСП
+UNIQUE = УНИК
+VLOOKUP = ВПР
+XLOOKUP = ПРОСМОТРX
+XMATCH = ПОИСКПОЗX
+
+##
+## Математические и тригонометрические функции (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = ACOS
+ACOSH = ACOSH
+ACOT = ACOT
+ACOTH = ACOTH
+AGGREGATE = АГРЕГАТ
+ARABIC = АРАБСКОЕ
+ASIN = ASIN
+ASINH = ASINH
+ATAN = ATAN
+ATAN2 = ATAN2
+ATANH = ATANH
+BASE = ОСНОВАНИЕ
+CEILING.MATH = ОКРВВЕРХ.МАТ
+CEILING.PRECISE = ОКРВВЕРХ.ТОЧН
+COMBIN = ЧИСЛКОМБ
+COMBINA = ЧИСЛКОМБА
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = CSC
+CSCH = CSCH
+DECIMAL = ДЕС
+DEGREES = ГРАДУСЫ
+ECMA.CEILING = ECMA.ОКРВВЕРХ
+EVEN = ЧЁТН
+EXP = EXP
+FACT = ФАКТР
+FACTDOUBLE = ДВФАКТР
+FLOOR.MATH = ОКРВНИЗ.МАТ
+FLOOR.PRECISE = ОКРВНИЗ.ТОЧН
+GCD = НОД
+INT = ЦЕЛОЕ
+ISO.CEILING = ISO.ОКРВВЕРХ
+LCM = НОК
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = МОПРЕД
+MINVERSE = МОБР
+MMULT = МУМНОЖ
+MOD = ОСТАТ
+MROUND = ОКРУГЛТ
+MULTINOMIAL = МУЛЬТИНОМ
+MUNIT = МЕДИН
+ODD = НЕЧЁТ
+PI = ПИ
+POWER = СТЕПЕНЬ
+PRODUCT = ПРОИЗВЕД
+QUOTIENT = ЧАСТНОЕ
+RADIANS = РАДИАНЫ
+RAND = СЛЧИС
+RANDARRAY = СЛУЧМАССИВ
+RANDBETWEEN = СЛУЧМЕЖДУ
+ROMAN = РИМСКОЕ
+ROUND = ОКРУГЛ
+ROUNDBAHTDOWN = ОКРУГЛБАТВНИЗ
+ROUNDBAHTUP = ОКРУГЛБАТВВЕРХ
+ROUNDDOWN = ОКРУГЛВНИЗ
+ROUNDUP = ОКРУГЛВВЕРХ
+SEC = SEC
+SECH = SECH
+SERIESSUM = РЯД.СУММ
+SEQUENCE = ПОСЛЕДОВ
+SIGN = ЗНАК
+SIN = SIN
+SINH = SINH
+SQRT = КОРЕНЬ
+SQRTPI = КОРЕНЬПИ
+SUBTOTAL = ПРОМЕЖУТОЧНЫЕ.ИТОГИ
+SUM = СУММ
+SUMIF = СУММЕСЛИ
+SUMIFS = СУММЕСЛИМН
+SUMPRODUCT = СУММПРОИЗВ
+SUMSQ = СУММКВ
+SUMX2MY2 = СУММРАЗНКВ
+SUMX2PY2 = СУММСУММКВ
+SUMXMY2 = СУММКВРАЗН
+TAN = TAN
+TANH = TANH
+TRUNC = ОТБР
+
+##
+## Статистические функции (Statistical Functions)
+##
+AVEDEV = СРОТКЛ
+AVERAGE = СРЗНАЧ
+AVERAGEA = СРЗНАЧА
+AVERAGEIF = СРЗНАЧЕСЛИ
+AVERAGEIFS = СРЗНАЧЕСЛИМН
+BETA.DIST = БЕТА.РАСП
+BETA.INV = БЕТА.ОБР
+BINOM.DIST = БИНОМ.РАСП
+BINOM.DIST.RANGE = БИНОМ.РАСП.ДИАП
+BINOM.INV = БИНОМ.ОБР
+CHISQ.DIST = ХИ2.РАСП
+CHISQ.DIST.RT = ХИ2.РАСП.ПХ
+CHISQ.INV = ХИ2.ОБР
+CHISQ.INV.RT = ХИ2.ОБР.ПХ
+CHISQ.TEST = ХИ2.ТЕСТ
+CONFIDENCE.NORM = ДОВЕРИТ.НОРМ
+CONFIDENCE.T = ДОВЕРИТ.СТЬЮДЕНТ
+CORREL = КОРРЕЛ
+COUNT = СЧЁТ
+COUNTA = СЧЁТЗ
+COUNTBLANK = СЧИТАТЬПУСТОТЫ
+COUNTIF = СЧЁТЕСЛИ
+COUNTIFS = СЧЁТЕСЛИМН
+COVARIANCE.P = КОВАРИАЦИЯ.Г
+COVARIANCE.S = КОВАРИАЦИЯ.В
+DEVSQ = КВАДРОТКЛ
+EXPON.DIST = ЭКСП.РАСП
+F.DIST = F.РАСП
+F.DIST.RT = F.РАСП.ПХ
+F.INV = F.ОБР
+F.INV.RT = F.ОБР.ПХ
+F.TEST = F.ТЕСТ
+FISHER = ФИШЕР
+FISHERINV = ФИШЕРОБР
+FORECAST.ETS = ПРЕДСКАЗ.ETS
+FORECAST.ETS.CONFINT = ПРЕДСКАЗ.ЕTS.ДОВИНТЕРВАЛ
+FORECAST.ETS.SEASONALITY = ПРЕДСКАЗ.ETS.СЕЗОННОСТЬ
+FORECAST.ETS.STAT = ПРЕДСКАЗ.ETS.СТАТ
+FORECAST.LINEAR = ПРЕДСКАЗ.ЛИНЕЙН
+FREQUENCY = ЧАСТОТА
+GAMMA = ГАММА
+GAMMA.DIST = ГАММА.РАСП
+GAMMA.INV = ГАММА.ОБР
+GAMMALN = ГАММАНЛОГ
+GAMMALN.PRECISE = ГАММАНЛОГ.ТОЧН
+GAUSS = ГАУСС
+GEOMEAN = СРГЕОМ
+GROWTH = РОСТ
+HARMEAN = СРГАРМ
+HYPGEOM.DIST = ГИПЕРГЕОМ.РАСП
+INTERCEPT = ОТРЕЗОК
+KURT = ЭКСЦЕСС
+LARGE = НАИБОЛЬШИЙ
+LINEST = ЛИНЕЙН
+LOGEST = ЛГРФПРИБЛ
+LOGNORM.DIST = ЛОГНОРМ.РАСП
+LOGNORM.INV = ЛОГНОРМ.ОБР
+MAX = МАКС
+MAXA = МАКСА
+MAXIFS = МАКСЕСЛИ
+MEDIAN = МЕДИАНА
+MIN = МИН
+MINA = МИНА
+MINIFS = МИНЕСЛИ
+MODE.MULT = МОДА.НСК
+MODE.SNGL = МОДА.ОДН
+NEGBINOM.DIST = ОТРБИНОМ.РАСП
+NORM.DIST = НОРМ.РАСП
+NORM.INV = НОРМ.ОБР
+NORM.S.DIST = НОРМ.СТ.РАСП
+NORM.S.INV = НОРМ.СТ.ОБР
+PEARSON = PEARSON
+PERCENTILE.EXC = ПРОЦЕНТИЛЬ.ИСКЛ
+PERCENTILE.INC = ПРОЦЕНТИЛЬ.ВКЛ
+PERCENTRANK.EXC = ПРОЦЕНТРАНГ.ИСКЛ
+PERCENTRANK.INC = ПРОЦЕНТРАНГ.ВКЛ
+PERMUT = ПЕРЕСТ
+PERMUTATIONA = ПЕРЕСТА
+PHI = ФИ
+POISSON.DIST = ПУАССОН.РАСП
+PROB = ВЕРОЯТНОСТЬ
+QUARTILE.EXC = КВАРТИЛЬ.ИСКЛ
+QUARTILE.INC = КВАРТИЛЬ.ВКЛ
+RANK.AVG = РАНГ.СР
+RANK.EQ = РАНГ.РВ
+RSQ = КВПИРСОН
+SKEW = СКОС
+SKEW.P = СКОС.Г
+SLOPE = НАКЛОН
+SMALL = НАИМЕНЬШИЙ
+STANDARDIZE = НОРМАЛИЗАЦИЯ
+STDEV.P = СТАНДОТКЛОН.Г
+STDEV.S = СТАНДОТКЛОН.В
+STDEVA = СТАНДОТКЛОНА
+STDEVPA = СТАНДОТКЛОНПА
+STEYX = СТОШYX
+T.DIST = СТЬЮДЕНТ.РАСП
+T.DIST.2T = СТЬЮДЕНТ.РАСП.2Х
+T.DIST.RT = СТЬЮДЕНТ.РАСП.ПХ
+T.INV = СТЬЮДЕНТ.ОБР
+T.INV.2T = СТЬЮДЕНТ.ОБР.2Х
+T.TEST = СТЬЮДЕНТ.ТЕСТ
+TREND = ТЕНДЕНЦИЯ
+TRIMMEAN = УРЕЗСРЕДНЕЕ
+VAR.P = ДИСП.Г
+VAR.S = ДИСП.В
+VARA = ДИСПА
+VARPA = ДИСПРА
+WEIBULL.DIST = ВЕЙБУЛЛ.РАСП
+Z.TEST = Z.ТЕСТ
+
+##
+## Текстовые функции (Text Functions)
+##
+ARRAYTOTEXT = МАССИВВТЕКСТ
+BAHTTEXT = БАТТЕКСТ
+CHAR = СИМВОЛ
+CLEAN = ПЕЧСИМВ
+CODE = КОДСИМВ
+CONCAT = СЦЕП
+DBCS = БДЦС
+DOLLAR = РУБЛЬ
+EXACT = СОВПАД
+FIND = НАЙТИ
+FINDB = НАЙТИБ
+FIXED = ФИКСИРОВАННЫЙ
+ISTHAIDIGIT = ЕТАЙЦИФРЫ
+LEFT = ЛЕВСИМВ
+LEFTB = ЛЕВБ
+LEN = ДЛСТР
+LENB = ДЛИНБ
+LOWER = СТРОЧН
+MID = ПСТР
+MIDB = ПСТРБ
+NUMBERSTRING = СТРОКАЧИСЕЛ
+NUMBERVALUE = ЧЗНАЧ
+PROPER = ПРОПНАЧ
+REPLACE = ЗАМЕНИТЬ
+REPLACEB = ЗАМЕНИТЬБ
+REPT = ПОВТОР
+RIGHT = ПРАВСИМВ
+RIGHTB = ПРАВБ
+SEARCH = ПОИСК
+SEARCHB = ПОИСКБ
+SUBSTITUTE = ПОДСТАВИТЬ
+T = Т
+TEXT = ТЕКСТ
+TEXTJOIN = ОБЪЕДИНИТЬ
+THAIDIGIT = ТАЙЦИФРА
+THAINUMSOUND = ТАЙЧИСЛОВЗВУК
+THAINUMSTRING = ТАЙЧИСЛОВСТРОКУ
+THAISTRINGLENGTH = ТАЙДЛИНАСТРОКИ
+TRIM = СЖПРОБЕЛЫ
+UNICHAR = ЮНИСИМВ
+UNICODE = UNICODE
+UPPER = ПРОПИСН
+VALUE = ЗНАЧЕН
+VALUETOTEXT = ЗНАЧЕНИЕВТЕКСТ
+
+##
+## Веб-функции (Web Functions)
+##
+ENCODEURL = КОДИР.URL
+FILTERXML = ФИЛЬТР.XML
+WEBSERVICE = ВЕБСЛУЖБА
+
+##
+## Функции совместимости (Compatibility Functions)
+##
+BETADIST = БЕТАРАСП
+BETAINV = БЕТАОБР
+BINOMDIST = БИНОМРАСП
+CEILING = ОКРВВЕРХ
+CHIDIST = ХИ2РАСП
+CHIINV = ХИ2ОБР
+CHITEST = ХИ2ТЕСТ
+CONCATENATE = СЦЕПИТЬ
+CONFIDENCE = ДОВЕРИТ
+COVAR = КОВАР
+CRITBINOM = КРИТБИНОМ
+EXPONDIST = ЭКСПРАСП
+FDIST = FРАСП
+FINV = FРАСПОБР
+FLOOR = ОКРВНИЗ
+FORECAST = ПРЕДСКАЗ
+FTEST = ФТЕСТ
+GAMMADIST = ГАММАРАСП
+GAMMAINV = ГАММАОБР
+HYPGEOMDIST = ГИПЕРГЕОМЕТ
+LOGINV = ЛОГНОРМОБР
+LOGNORMDIST = ЛОГНОРМРАСП
+MODE = МОДА
+NEGBINOMDIST = ОТРБИНОМРАСП
+NORMDIST = НОРМРАСП
+NORMINV = НОРМОБР
+NORMSDIST = НОРМСТРАСП
+NORMSINV = НОРМСТОБР
+PERCENTILE = ПЕРСЕНТИЛЬ
+PERCENTRANK = ПРОЦЕНТРАНГ
+POISSON = ПУАССОН
+QUARTILE = КВАРТИЛЬ
+RANK = РАНГ
+STDEV = СТАНДОТКЛОН
+STDEVP = СТАНДОТКЛОНП
+TDIST = СТЬЮДРАСП
+TINV = СТЬЮДРАСПОБР
+TTEST = ТТЕСТ
+VAR = ДИСП
+VARP = ДИСПР
+WEIBULL = ВЕЙБУЛЛ
+ZTEST = ZТЕСТ
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/sv/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/sv/config
new file mode 100644
index 00000000..c7440f71
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/sv/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Svenska (Swedish)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL = #SKÄRNING!
+DIV0 = #DIVISION/0!
+VALUE = #VÄRDEFEL!
+REF = #REFERENS!
+NAME = #NAMN?
+NUM = #OGILTIGT!
+NA = #SAKNAS!
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/sv/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/sv/functions
new file mode 100644
index 00000000..491ecfb9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/sv/functions
@@ -0,0 +1,533 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Svenska (Swedish)
+##
+############################################################
+
+
+##
+## Kubfunktioner (Cube Functions)
+##
+CUBEKPIMEMBER = KUBKPIMEDLEM
+CUBEMEMBER = KUBMEDLEM
+CUBEMEMBERPROPERTY = KUBMEDLEMSEGENSKAP
+CUBERANKEDMEMBER = KUBRANGORDNADMEDLEM
+CUBESET = KUBUPPSÄTTNING
+CUBESETCOUNT = KUBUPPSÄTTNINGANTAL
+CUBEVALUE = KUBVÄRDE
+
+##
+## Databasfunktioner (Database Functions)
+##
+DAVERAGE = DMEDEL
+DCOUNT = DANTAL
+DCOUNTA = DANTALV
+DGET = DHÄMTA
+DMAX = DMAX
+DMIN = DMIN
+DPRODUCT = DPRODUKT
+DSTDEV = DSTDAV
+DSTDEVP = DSTDAVP
+DSUM = DSUMMA
+DVAR = DVARIANS
+DVARP = DVARIANSP
+
+##
+## Tid- och datumfunktioner (Date & Time Functions)
+##
+DATE = DATUM
+DATEVALUE = DATUMVÄRDE
+DAY = DAG
+DAYS = DAGAR
+DAYS360 = DAGAR360
+EDATE = EDATUM
+EOMONTH = SLUTMÅNAD
+HOUR = TIMME
+ISOWEEKNUM = ISOVECKONR
+MINUTE = MINUT
+MONTH = MÅNAD
+NETWORKDAYS = NETTOARBETSDAGAR
+NETWORKDAYS.INTL = NETTOARBETSDAGAR.INT
+NOW = NU
+SECOND = SEKUND
+THAIDAYOFWEEK = THAIVECKODAG
+THAIMONTHOFYEAR = THAIMÅNAD
+THAIYEAR = THAIÅR
+TIME = KLOCKSLAG
+TIMEVALUE = TIDVÄRDE
+TODAY = IDAG
+WEEKDAY = VECKODAG
+WEEKNUM = VECKONR
+WORKDAY = ARBETSDAGAR
+WORKDAY.INTL = ARBETSDAGAR.INT
+YEAR = ÅR
+YEARFRAC = ÅRDEL
+
+##
+## Tekniska funktioner (Engineering Functions)
+##
+BESSELI = BESSELI
+BESSELJ = BESSELJ
+BESSELK = BESSELK
+BESSELY = BESSELY
+BIN2DEC = BIN.TILL.DEC
+BIN2HEX = BIN.TILL.HEX
+BIN2OCT = BIN.TILL.OKT
+BITAND = BITOCH
+BITLSHIFT = BITVSKIFT
+BITOR = BITELLER
+BITRSHIFT = BITHSKIFT
+BITXOR = BITXELLER
+COMPLEX = KOMPLEX
+CONVERT = KONVERTERA
+DEC2BIN = DEC.TILL.BIN
+DEC2HEX = DEC.TILL.HEX
+DEC2OCT = DEC.TILL.OKT
+DELTA = DELTA
+ERF = FELF
+ERF.PRECISE = FELF.EXAKT
+ERFC = FELFK
+ERFC.PRECISE = FELFK.EXAKT
+GESTEP = SLSTEG
+HEX2BIN = HEX.TILL.BIN
+HEX2DEC = HEX.TILL.DEC
+HEX2OCT = HEX.TILL.OKT
+IMABS = IMABS
+IMAGINARY = IMAGINÄR
+IMARGUMENT = IMARGUMENT
+IMCONJUGATE = IMKONJUGAT
+IMCOS = IMCOS
+IMCOSH = IMCOSH
+IMCOT = IMCOT
+IMCSC = IMCSC
+IMCSCH = IMCSCH
+IMDIV = IMDIV
+IMEXP = IMEUPPHÖJT
+IMLN = IMLN
+IMLOG10 = IMLOG10
+IMLOG2 = IMLOG2
+IMPOWER = IMUPPHÖJT
+IMPRODUCT = IMPRODUKT
+IMREAL = IMREAL
+IMSEC = IMSEK
+IMSECH = IMSEKH
+IMSIN = IMSIN
+IMSINH = IMSINH
+IMSQRT = IMROT
+IMSUB = IMDIFF
+IMSUM = IMSUM
+IMTAN = IMTAN
+OCT2BIN = OKT.TILL.BIN
+OCT2DEC = OKT.TILL.DEC
+OCT2HEX = OKT.TILL.HEX
+
+##
+## Finansiella funktioner (Financial Functions)
+##
+ACCRINT = UPPLRÄNTA
+ACCRINTM = UPPLOBLRÄNTA
+AMORDEGRC = AMORDEGRC
+AMORLINC = AMORLINC
+COUPDAYBS = KUPDAGBB
+COUPDAYS = KUPDAGB
+COUPDAYSNC = KUPDAGNK
+COUPNCD = KUPNKD
+COUPNUM = KUPANT
+COUPPCD = KUPFKD
+CUMIPMT = KUMRÄNTA
+CUMPRINC = KUMPRIS
+DB = DB
+DDB = DEGAVSKR
+DISC = DISK
+DOLLARDE = DECTAL
+DOLLARFR = BRÅK
+DURATION = LÖPTID
+EFFECT = EFFRÄNTA
+FV = SLUTVÄRDE
+FVSCHEDULE = FÖRRÄNTNING
+INTRATE = ÅRSRÄNTA
+IPMT = RBETALNING
+IRR = IR
+ISPMT = RALÅN
+MDURATION = MLÖPTID
+MIRR = MODIR
+NOMINAL = NOMRÄNTA
+NPER = PERIODER
+NPV = NETNUVÄRDE
+ODDFPRICE = UDDAFPRIS
+ODDFYIELD = UDDAFAVKASTNING
+ODDLPRICE = UDDASPRIS
+ODDLYIELD = UDDASAVKASTNING
+PDURATION = PLÖPTID
+PMT = BETALNING
+PPMT = AMORT
+PRICE = PRIS
+PRICEDISC = PRISDISK
+PRICEMAT = PRISFÖRF
+PV = NUVÄRDE
+RATE = RÄNTA
+RECEIVED = BELOPP
+RRI = AVKPÅINVEST
+SLN = LINAVSKR
+SYD = ÅRSAVSKR
+TBILLEQ = SSVXEKV
+TBILLPRICE = SSVXPRIS
+TBILLYIELD = SSVXRÄNTA
+VDB = VDEGRAVSKR
+XIRR = XIRR
+XNPV = XNUVÄRDE
+YIELD = NOMAVK
+YIELDDISC = NOMAVKDISK
+YIELDMAT = NOMAVKFÖRF
+
+##
+## Informationsfunktioner (Information Functions)
+##
+CELL = CELL
+ERROR.TYPE = FEL.TYP
+INFO = INFO
+ISBLANK = ÄRTOM
+ISERR = ÄRF
+ISERROR = ÄRFEL
+ISEVEN = ÄRJÄMN
+ISFORMULA = ÄRFORMEL
+ISLOGICAL = ÄRLOGISK
+ISNA = ÄRSAKNAD
+ISNONTEXT = ÄREJTEXT
+ISNUMBER = ÄRTAL
+ISODD = ÄRUDDA
+ISREF = ÄRREF
+ISTEXT = ÄRTEXT
+N = N
+NA = SAKNAS
+SHEET = BLAD
+SHEETS = ANTALBLAD
+TYPE = VÄRDETYP
+
+##
+## Logiska funktioner (Logical Functions)
+##
+AND = OCH
+FALSE = FALSKT
+IF = OM
+IFERROR = OMFEL
+IFNA = OMSAKNAS
+IFS = IFS
+NOT = ICKE
+OR = ELLER
+SWITCH = VÄXLA
+TRUE = SANT
+XOR = XELLER
+
+##
+## Sök- och referensfunktioner (Lookup & Reference Functions)
+##
+ADDRESS = ADRESS
+AREAS = OMRÅDEN
+CHOOSE = VÄLJ
+COLUMN = KOLUMN
+COLUMNS = KOLUMNER
+FORMULATEXT = FORMELTEXT
+GETPIVOTDATA = HÄMTA.PIVOTDATA
+HLOOKUP = LETAKOLUMN
+HYPERLINK = HYPERLÄNK
+INDEX = INDEX
+INDIRECT = INDIREKT
+LOOKUP = LETAUPP
+MATCH = PASSA
+OFFSET = FÖRSKJUTNING
+ROW = RAD
+ROWS = RADER
+RTD = RTD
+TRANSPOSE = TRANSPONERA
+VLOOKUP = LETARAD
+*RC = RK
+
+##
+## Matematiska och trigonometriska funktioner (Math & Trig Functions)
+##
+ABS = ABS
+ACOS = ARCCOS
+ACOSH = ARCCOSH
+ACOT = ARCCOT
+ACOTH = ARCCOTH
+AGGREGATE = MÄNGD
+ARABIC = ARABISKA
+ASIN = ARCSIN
+ASINH = ARCSINH
+ATAN = ARCTAN
+ATAN2 = ARCTAN2
+ATANH = ARCTANH
+BASE = BAS
+CEILING.MATH = RUNDA.UPP.MATEMATISKT
+CEILING.PRECISE = RUNDA.UPP.EXAKT
+COMBIN = KOMBIN
+COMBINA = KOMBINA
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = CSC
+CSCH = CSCH
+DECIMAL = DECIMAL
+DEGREES = GRADER
+ECMA.CEILING = ECMA.RUNDA.UPP
+EVEN = JÄMN
+EXP = EXP
+FACT = FAKULTET
+FACTDOUBLE = DUBBELFAKULTET
+FLOOR.MATH = RUNDA.NER.MATEMATISKT
+FLOOR.PRECISE = RUNDA.NER.EXAKT
+GCD = SGD
+INT = HELTAL
+ISO.CEILING = ISO.RUNDA.UPP
+LCM = MGM
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = MDETERM
+MINVERSE = MINVERT
+MMULT = MMULT
+MOD = REST
+MROUND = MAVRUNDA
+MULTINOMIAL = MULTINOMIAL
+MUNIT = MENHET
+ODD = UDDA
+PI = PI
+POWER = UPPHÖJT.TILL
+PRODUCT = PRODUKT
+QUOTIENT = KVOT
+RADIANS = RADIANER
+RAND = SLUMP
+RANDBETWEEN = SLUMP.MELLAN
+ROMAN = ROMERSK
+ROUND = AVRUNDA
+ROUNDBAHTDOWN = AVRUNDABAHTNEDÅT
+ROUNDBAHTUP = AVRUNDABAHTUPPÅT
+ROUNDDOWN = AVRUNDA.NEDÅT
+ROUNDUP = AVRUNDA.UPPÅT
+SEC = SEK
+SECH = SEKH
+SERIESSUM = SERIESUMMA
+SIGN = TECKEN
+SIN = SIN
+SINH = SINH
+SQRT = ROT
+SQRTPI = ROTPI
+SUBTOTAL = DELSUMMA
+SUM = SUMMA
+SUMIF = SUMMA.OM
+SUMIFS = SUMMA.OMF
+SUMPRODUCT = PRODUKTSUMMA
+SUMSQ = KVADRATSUMMA
+SUMX2MY2 = SUMMAX2MY2
+SUMX2PY2 = SUMMAX2PY2
+SUMXMY2 = SUMMAXMY2
+TAN = TAN
+TANH = TANH
+TRUNC = AVKORTA
+
+##
+## Statistiska funktioner (Statistical Functions)
+##
+AVEDEV = MEDELAVV
+AVERAGE = MEDEL
+AVERAGEA = AVERAGEA
+AVERAGEIF = MEDEL.OM
+AVERAGEIFS = MEDEL.OMF
+BETA.DIST = BETA.FÖRD
+BETA.INV = BETA.INV
+BINOM.DIST = BINOM.FÖRD
+BINOM.DIST.RANGE = BINOM.FÖRD.INTERVALL
+BINOM.INV = BINOM.INV
+CHISQ.DIST = CHI2.FÖRD
+CHISQ.DIST.RT = CHI2.FÖRD.RT
+CHISQ.INV = CHI2.INV
+CHISQ.INV.RT = CHI2.INV.RT
+CHISQ.TEST = CHI2.TEST
+CONFIDENCE.NORM = KONFIDENS.NORM
+CONFIDENCE.T = KONFIDENS.T
+CORREL = KORREL
+COUNT = ANTAL
+COUNTA = ANTALV
+COUNTBLANK = ANTAL.TOMMA
+COUNTIF = ANTAL.OM
+COUNTIFS = ANTAL.OMF
+COVARIANCE.P = KOVARIANS.P
+COVARIANCE.S = KOVARIANS.S
+DEVSQ = KVADAVV
+EXPON.DIST = EXPON.FÖRD
+F.DIST = F.FÖRD
+F.DIST.RT = F.FÖRD.RT
+F.INV = F.INV
+F.INV.RT = F.INV.RT
+F.TEST = F.TEST
+FISHER = FISHER
+FISHERINV = FISHERINV
+FORECAST.ETS = PROGNOS.ETS
+FORECAST.ETS.CONFINT = PROGNOS.ETS.KONFINT
+FORECAST.ETS.SEASONALITY = PROGNOS.ETS.SÄSONGSBEROENDE
+FORECAST.ETS.STAT = PROGNOS.ETS.STAT
+FORECAST.LINEAR = PROGNOS.LINJÄR
+FREQUENCY = FREKVENS
+GAMMA = GAMMA
+GAMMA.DIST = GAMMA.FÖRD
+GAMMA.INV = GAMMA.INV
+GAMMALN = GAMMALN
+GAMMALN.PRECISE = GAMMALN.EXAKT
+GAUSS = GAUSS
+GEOMEAN = GEOMEDEL
+GROWTH = EXPTREND
+HARMEAN = HARMMEDEL
+HYPGEOM.DIST = HYPGEOM.FÖRD
+INTERCEPT = SKÄRNINGSPUNKT
+KURT = TOPPIGHET
+LARGE = STÖRSTA
+LINEST = REGR
+LOGEST = EXPREGR
+LOGNORM.DIST = LOGNORM.FÖRD
+LOGNORM.INV = LOGNORM.INV
+MAX = MAX
+MAXA = MAXA
+MAXIFS = MAXIFS
+MEDIAN = MEDIAN
+MIN = MIN
+MINA = MINA
+MINIFS = MINIFS
+MODE.MULT = TYPVÄRDE.FLERA
+MODE.SNGL = TYPVÄRDE.ETT
+NEGBINOM.DIST = NEGBINOM.FÖRD
+NORM.DIST = NORM.FÖRD
+NORM.INV = NORM.INV
+NORM.S.DIST = NORM.S.FÖRD
+NORM.S.INV = NORM.S.INV
+PEARSON = PEARSON
+PERCENTILE.EXC = PERCENTIL.EXK
+PERCENTILE.INC = PERCENTIL.INK
+PERCENTRANK.EXC = PROCENTRANG.EXK
+PERCENTRANK.INC = PROCENTRANG.INK
+PERMUT = PERMUT
+PERMUTATIONA = PERMUTATIONA
+PHI = PHI
+POISSON.DIST = POISSON.FÖRD
+PROB = SANNOLIKHET
+QUARTILE.EXC = KVARTIL.EXK
+QUARTILE.INC = KVARTIL.INK
+RANK.AVG = RANG.MED
+RANK.EQ = RANG.EKV
+RSQ = RKV
+SKEW = SNEDHET
+SKEW.P = SNEDHET.P
+SLOPE = LUTNING
+SMALL = MINSTA
+STANDARDIZE = STANDARDISERA
+STDEV.P = STDAV.P
+STDEV.S = STDAV.S
+STDEVA = STDEVA
+STDEVPA = STDEVPA
+STEYX = STDFELYX
+T.DIST = T.FÖRD
+T.DIST.2T = T.FÖRD.2T
+T.DIST.RT = T.FÖRD.RT
+T.INV = T.INV
+T.INV.2T = T.INV.2T
+T.TEST = T.TEST
+TREND = TREND
+TRIMMEAN = TRIMMEDEL
+VAR.P = VARIANS.P
+VAR.S = VARIANS.S
+VARA = VARA
+VARPA = VARPA
+WEIBULL.DIST = WEIBULL.FÖRD
+Z.TEST = Z.TEST
+
+##
+## Textfunktioner (Text Functions)
+##
+BAHTTEXT = BAHTTEXT
+CHAR = TECKENKOD
+CLEAN = STÄDA
+CODE = KOD
+CONCAT = SAMMAN
+DOLLAR = VALUTA
+EXACT = EXAKT
+FIND = HITTA
+FIXED = FASTTAL
+LEFT = VÄNSTER
+LEN = LÄNGD
+LOWER = GEMENER
+MID = EXTEXT
+NUMBERVALUE = TALVÄRDE
+PROPER = INITIAL
+REPLACE = ERSÄTT
+REPT = REP
+RIGHT = HÖGER
+SEARCH = SÖK
+SUBSTITUTE = BYT.UT
+T = T
+TEXT = TEXT
+TEXTJOIN = TEXTJOIN
+THAIDIGIT = THAISIFFRA
+THAINUMSOUND = THAITALLJUD
+THAINUMSTRING = THAITALSTRÄNG
+THAISTRINGLENGTH = THAISTRÄNGLÄNGD
+TRIM = RENSA
+UNICHAR = UNITECKENKOD
+UNICODE = UNICODE
+UPPER = VERSALER
+VALUE = TEXTNUM
+
+##
+## Webbfunktioner (Web Functions)
+##
+ENCODEURL = KODAWEBBADRESS
+FILTERXML = FILTRERAXML
+WEBSERVICE = WEBBTJÄNST
+
+##
+## Kompatibilitetsfunktioner (Compatibility Functions)
+##
+BETADIST = BETAFÖRD
+BETAINV = BETAINV
+BINOMDIST = BINOMFÖRD
+CEILING = RUNDA.UPP
+CHIDIST = CHI2FÖRD
+CHIINV = CHI2INV
+CHITEST = CHI2TEST
+CONCATENATE = SAMMANFOGA
+CONFIDENCE = KONFIDENS
+COVAR = KOVAR
+CRITBINOM = KRITBINOM
+EXPONDIST = EXPONFÖRD
+FDIST = FFÖRD
+FINV = FINV
+FLOOR = RUNDA.NER
+FORECAST = PREDIKTION
+FTEST = FTEST
+GAMMADIST = GAMMAFÖRD
+GAMMAINV = GAMMAINV
+HYPGEOMDIST = HYPGEOMFÖRD
+LOGINV = LOGINV
+LOGNORMDIST = LOGNORMFÖRD
+MODE = TYPVÄRDE
+NEGBINOMDIST = NEGBINOMFÖRD
+NORMDIST = NORMFÖRD
+NORMINV = NORMINV
+NORMSDIST = NORMSFÖRD
+NORMSINV = NORMSINV
+PERCENTILE = PERCENTIL
+PERCENTRANK = PROCENTRANG
+POISSON = POISSON
+QUARTILE = KVARTIL
+RANK = RANG
+STDEV = STDAV
+STDEVP = STDAVP
+TDIST = TFÖRD
+TINV = TINV
+TTEST = TTEST
+VAR = VARIANS
+VARP = VARIANSP
+WEIBULL = WEIBULL
+ZTEST = ZTEST
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/tr/config b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/tr/config
new file mode 100644
index 00000000..63d22fd0
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/tr/config
@@ -0,0 +1,20 @@
+############################################################
+##
+## PhpSpreadsheet - locale settings
+##
+## Türkçe (Turkish)
+##
+############################################################
+
+ArgumentSeparator = ;
+
+##
+## Error Codes
+##
+NULL = #BOŞ!
+DIV0 = #SAYI/0!
+VALUE = #DEĞER!
+REF = #BAŞV!
+NAME = #AD?
+NUM = #SAYI!
+NA = #YOK
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/tr/functions b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/tr/functions
new file mode 100644
index 00000000..f872274f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Calculation/locale/tr/functions
@@ -0,0 +1,537 @@
+############################################################
+##
+## PhpSpreadsheet - function name translations
+##
+## Türkçe (Turkish)
+##
+############################################################
+
+
+##
+## Küp işlevleri (Cube Functions)
+##
+CUBEKPIMEMBER = KÜPKPIÜYESİ
+CUBEMEMBER = KÜPÜYESİ
+CUBEMEMBERPROPERTY = KÜPÜYEÖZELLİĞİ
+CUBERANKEDMEMBER = DERECELİKÜPÜYESİ
+CUBESET = KÜPKÜMESİ
+CUBESETCOUNT = KÜPKÜMESAYISI
+CUBEVALUE = KÜPDEĞERİ
+
+##
+## Veritabanı işlevleri (Database Functions)
+##
+DAVERAGE = VSEÇORT
+DCOUNT = VSEÇSAY
+DCOUNTA = VSEÇSAYDOLU
+DGET = VAL
+DMAX = VSEÇMAK
+DMIN = VSEÇMİN
+DPRODUCT = VSEÇÇARP
+DSTDEV = VSEÇSTDSAPMA
+DSTDEVP = VSEÇSTDSAPMAS
+DSUM = VSEÇTOPLA
+DVAR = VSEÇVAR
+DVARP = VSEÇVARS
+
+##
+## Tarih ve saat işlevleri (Date & Time Functions)
+##
+DATE = TARİH
+DATEDIF = ETARİHLİ
+DATESTRING = TARİHDİZİ
+DATEVALUE = TARİHSAYISI
+DAY = GÜN
+DAYS = GÜNSAY
+DAYS360 = GÜN360
+EDATE = SERİTARİH
+EOMONTH = SERİAY
+HOUR = SAAT
+ISOWEEKNUM = ISOHAFTASAY
+MINUTE = DAKİKA
+MONTH = AY
+NETWORKDAYS = TAMİŞGÜNÜ
+NETWORKDAYS.INTL = TAMİŞGÜNÜ.ULUSL
+NOW = ŞİMDİ
+SECOND = SANİYE
+THAIDAYOFWEEK = TAYHAFTANINGÜNÜ
+THAIMONTHOFYEAR = TAYYILINAYI
+THAIYEAR = TAYYILI
+TIME = ZAMAN
+TIMEVALUE = ZAMANSAYISI
+TODAY = BUGÜN
+WEEKDAY = HAFTANINGÜNÜ
+WEEKNUM = HAFTASAY
+WORKDAY = İŞGÜNÜ
+WORKDAY.INTL = İŞGÜNÜ.ULUSL
+YEAR = YIL
+YEARFRAC = YILORAN
+
+##
+## Mühendislik işlevleri (Engineering Functions)
+##
+BESSELI = BESSELI
+BESSELJ = BESSELJ
+BESSELK = BESSELK
+BESSELY = BESSELY
+BIN2DEC = BIN2DEC
+BIN2HEX = BIN2HEX
+BIN2OCT = BIN2OCT
+BITAND = BİTVE
+BITLSHIFT = BİTSOLAKAYDIR
+BITOR = BİTVEYA
+BITRSHIFT = BİTSAĞAKAYDIR
+BITXOR = BİTÖZELVEYA
+COMPLEX = KARMAŞIK
+CONVERT = ÇEVİR
+DEC2BIN = DEC2BIN
+DEC2HEX = DEC2HEX
+DEC2OCT = DEC2OCT
+DELTA = DELTA
+ERF = HATAİŞLEV
+ERF.PRECISE = HATAİŞLEV.DUYARLI
+ERFC = TÜMHATAİŞLEV
+ERFC.PRECISE = TÜMHATAİŞLEV.DUYARLI
+GESTEP = BESINIR
+HEX2BIN = HEX2BIN
+HEX2DEC = HEX2DEC
+HEX2OCT = HEX2OCT
+IMABS = SANMUTLAK
+IMAGINARY = SANAL
+IMARGUMENT = SANBAĞ_DEĞİŞKEN
+IMCONJUGATE = SANEŞLENEK
+IMCOS = SANCOS
+IMCOSH = SANCOSH
+IMCOT = SANCOT
+IMCSC = SANCSC
+IMCSCH = SANCSCH
+IMDIV = SANBÖL
+IMEXP = SANÜS
+IMLN = SANLN
+IMLOG10 = SANLOG10
+IMLOG2 = SANLOG2
+IMPOWER = SANKUVVET
+IMPRODUCT = SANÇARP
+IMREAL = SANGERÇEK
+IMSEC = SANSEC
+IMSECH = SANSECH
+IMSIN = SANSIN
+IMSINH = SANSINH
+IMSQRT = SANKAREKÖK
+IMSUB = SANTOPLA
+IMSUM = SANÇIKAR
+IMTAN = SANTAN
+OCT2BIN = OCT2BIN
+OCT2DEC = OCT2DEC
+OCT2HEX = OCT2HEX
+
+##
+## Finansal işlevler (Financial Functions)
+##
+ACCRINT = GERÇEKFAİZ
+ACCRINTM = GERÇEKFAİZV
+AMORDEGRC = AMORDEGRC
+AMORLINC = AMORLINC
+COUPDAYBS = KUPONGÜNBD
+COUPDAYS = KUPONGÜN
+COUPDAYSNC = KUPONGÜNDSK
+COUPNCD = KUPONGÜNSKT
+COUPNUM = KUPONSAYI
+COUPPCD = KUPONGÜNÖKT
+CUMIPMT = TOPÖDENENFAİZ
+CUMPRINC = TOPANAPARA
+DB = AZALANBAKİYE
+DDB = ÇİFTAZALANBAKİYE
+DISC = İNDİRİM
+DOLLARDE = LİRAON
+DOLLARFR = LİRAKES
+DURATION = SÜRE
+EFFECT = ETKİN
+FV = GD
+FVSCHEDULE = GDPROGRAM
+INTRATE = FAİZORANI
+IPMT = FAİZTUTARI
+IRR = İÇ_VERİM_ORANI
+ISPMT = ISPMT
+MDURATION = MSÜRE
+MIRR = D_İÇ_VERİM_ORANI
+NOMINAL = NOMİNAL
+NPER = TAKSİT_SAYISI
+NPV = NBD
+ODDFPRICE = TEKYDEĞER
+ODDFYIELD = TEKYÖDEME
+ODDLPRICE = TEKSDEĞER
+ODDLYIELD = TEKSÖDEME
+PDURATION = PSÜRE
+PMT = DEVRESEL_ÖDEME
+PPMT = ANA_PARA_ÖDEMESİ
+PRICE = DEĞER
+PRICEDISC = DEĞERİND
+PRICEMAT = DEĞERVADE
+PV = BD
+RATE = FAİZ_ORANI
+RECEIVED = GETİRİ
+RRI = GERÇEKLEŞENYATIRIMGETİRİSİ
+SLN = DA
+SYD = YAT
+TBILLEQ = HTAHEŞ
+TBILLPRICE = HTAHDEĞER
+TBILLYIELD = HTAHÖDEME
+VDB = DAB
+XIRR = AİÇVERİMORANI
+XNPV = ANBD
+YIELD = ÖDEME
+YIELDDISC = ÖDEMEİND
+YIELDMAT = ÖDEMEVADE
+
+##
+## Bilgi işlevleri (Information Functions)
+##
+CELL = HÜCRE
+ERROR.TYPE = HATA.TİPİ
+INFO = BİLGİ
+ISBLANK = EBOŞSA
+ISERR = EHATA
+ISERROR = EHATALIYSA
+ISEVEN = ÇİFTMİ
+ISFORMULA = EFORMÜLSE
+ISLOGICAL = EMANTIKSALSA
+ISNA = EYOKSA
+ISNONTEXT = EMETİNDEĞİLSE
+ISNUMBER = ESAYIYSA
+ISODD = TEKMİ
+ISREF = EREFSE
+ISTEXT = EMETİNSE
+N = S
+NA = YOKSAY
+SHEET = SAYFA
+SHEETS = SAYFALAR
+TYPE = TÜR
+
+##
+## Mantıksal işlevler (Logical Functions)
+##
+AND = VE
+FALSE = YANLIŞ
+IF = EĞER
+IFERROR = EĞERHATA
+IFNA = EĞERYOKSA
+IFS = ÇOKEĞER
+NOT = DEĞİL
+OR = YADA
+SWITCH = İLKEŞLEŞEN
+TRUE = DOĞRU
+XOR = ÖZELVEYA
+
+##
+## Arama ve başvuru işlevleri (Lookup & Reference Functions)
+##
+ADDRESS = ADRES
+AREAS = ALANSAY
+CHOOSE = ELEMAN
+COLUMN = SÜTUN
+COLUMNS = SÜTUNSAY
+FORMULATEXT = FORMÜLMETNİ
+GETPIVOTDATA = ÖZETVERİAL
+HLOOKUP = YATAYARA
+HYPERLINK = KÖPRÜ
+INDEX = İNDİS
+INDIRECT = DOLAYLI
+LOOKUP = ARA
+MATCH = KAÇINCI
+OFFSET = KAYDIR
+ROW = SATIR
+ROWS = SATIRSAY
+RTD = GZV
+TRANSPOSE = DEVRİK_DÖNÜŞÜM
+VLOOKUP = DÜŞEYARA
+
+##
+## Matematik ve trigonometri işlevleri (Math & Trig Functions)
+##
+ABS = MUTLAK
+ACOS = ACOS
+ACOSH = ACOSH
+ACOT = ACOT
+ACOTH = ACOTH
+AGGREGATE = TOPLAMA
+ARABIC = ARAP
+ASIN = ASİN
+ASINH = ASİNH
+ATAN = ATAN
+ATAN2 = ATAN2
+ATANH = ATANH
+BASE = TABAN
+CEILING.MATH = TAVANAYUVARLA.MATEMATİK
+CEILING.PRECISE = TAVANAYUVARLA.DUYARLI
+COMBIN = KOMBİNASYON
+COMBINA = KOMBİNASYONA
+COS = COS
+COSH = COSH
+COT = COT
+COTH = COTH
+CSC = CSC
+CSCH = CSCH
+DECIMAL = ONDALIK
+DEGREES = DERECE
+ECMA.CEILING = ECMA.TAVAN
+EVEN = ÇİFT
+EXP = ÜS
+FACT = ÇARPINIM
+FACTDOUBLE = ÇİFTFAKTÖR
+FLOOR.MATH = TABANAYUVARLA.MATEMATİK
+FLOOR.PRECISE = TABANAYUVARLA.DUYARLI
+GCD = OBEB
+INT = TAMSAYI
+ISO.CEILING = ISO.TAVAN
+LCM = OKEK
+LN = LN
+LOG = LOG
+LOG10 = LOG10
+MDETERM = DETERMİNANT
+MINVERSE = DİZEY_TERS
+MMULT = DÇARP
+MOD = MOD
+MROUND = KYUVARLA
+MULTINOMIAL = ÇOKTERİMLİ
+MUNIT = BİRİMMATRİS
+ODD = TEK
+PI = Pİ
+POWER = KUVVET
+PRODUCT = ÇARPIM
+QUOTIENT = BÖLÜM
+RADIANS = RADYAN
+RAND = S_SAYI_ÜRET
+RANDBETWEEN = RASTGELEARADA
+ROMAN = ROMEN
+ROUND = YUVARLA
+ROUNDBAHTDOWN = BAHTAŞAĞIYUVARLA
+ROUNDBAHTUP = BAHTYUKARIYUVARLA
+ROUNDDOWN = AŞAĞIYUVARLA
+ROUNDUP = YUKARIYUVARLA
+SEC = SEC
+SECH = SECH
+SERIESSUM = SERİTOPLA
+SIGN = İŞARET
+SIN = SİN
+SINH = SİNH
+SQRT = KAREKÖK
+SQRTPI = KAREKÖKPİ
+SUBTOTAL = ALTTOPLAM
+SUM = TOPLA
+SUMIF = ETOPLA
+SUMIFS = ÇOKETOPLA
+SUMPRODUCT = TOPLA.ÇARPIM
+SUMSQ = TOPKARE
+SUMX2MY2 = TOPX2EY2
+SUMX2PY2 = TOPX2AY2
+SUMXMY2 = TOPXEY2
+TAN = TAN
+TANH = TANH
+TRUNC = NSAT
+
+##
+## İstatistik işlevleri (Statistical Functions)
+##
+AVEDEV = ORTSAP
+AVERAGE = ORTALAMA
+AVERAGEA = ORTALAMAA
+AVERAGEIF = EĞERORTALAMA
+AVERAGEIFS = ÇOKEĞERORTALAMA
+BETA.DIST = BETA.DAĞ
+BETA.INV = BETA.TERS
+BINOM.DIST = BİNOM.DAĞ
+BINOM.DIST.RANGE = BİNOM.DAĞ.ARALIK
+BINOM.INV = BİNOM.TERS
+CHISQ.DIST = KİKARE.DAĞ
+CHISQ.DIST.RT = KİKARE.DAĞ.SAĞK
+CHISQ.INV = KİKARE.TERS
+CHISQ.INV.RT = KİKARE.TERS.SAĞK
+CHISQ.TEST = KİKARE.TEST
+CONFIDENCE.NORM = GÜVENİLİRLİK.NORM
+CONFIDENCE.T = GÜVENİLİRLİK.T
+CORREL = KORELASYON
+COUNT = BAĞ_DEĞ_SAY
+COUNTA = BAĞ_DEĞ_DOLU_SAY
+COUNTBLANK = BOŞLUKSAY
+COUNTIF = EĞERSAY
+COUNTIFS = ÇOKEĞERSAY
+COVARIANCE.P = KOVARYANS.P
+COVARIANCE.S = KOVARYANS.S
+DEVSQ = SAPKARE
+EXPON.DIST = ÜSTEL.DAĞ
+F.DIST = F.DAĞ
+F.DIST.RT = F.DAĞ.SAĞK
+F.INV = F.TERS
+F.INV.RT = F.TERS.SAĞK
+F.TEST = F.TEST
+FISHER = FISHER
+FISHERINV = FISHERTERS
+FORECAST.ETS = TAHMİN.ETS
+FORECAST.ETS.CONFINT = TAHMİN.ETS.GVNARAL
+FORECAST.ETS.SEASONALITY = TAHMİN.ETS.MEVSİMSELLİK
+FORECAST.ETS.STAT = TAHMİN.ETS.İSTAT
+FORECAST.LINEAR = TAHMİN.DOĞRUSAL
+FREQUENCY = SIKLIK
+GAMMA = GAMA
+GAMMA.DIST = GAMA.DAĞ
+GAMMA.INV = GAMA.TERS
+GAMMALN = GAMALN
+GAMMALN.PRECISE = GAMALN.DUYARLI
+GAUSS = GAUSS
+GEOMEAN = GEOORT
+GROWTH = BÜYÜME
+HARMEAN = HARORT
+HYPGEOM.DIST = HİPERGEOM.DAĞ
+INTERCEPT = KESMENOKTASI
+KURT = BASIKLIK
+LARGE = BÜYÜK
+LINEST = DOT
+LOGEST = LOT
+LOGNORM.DIST = LOGNORM.DAĞ
+LOGNORM.INV = LOGNORM.TERS
+MAX = MAK
+MAXA = MAKA
+MAXIFS = ÇOKEĞERMAK
+MEDIAN = ORTANCA
+MIN = MİN
+MINA = MİNA
+MINIFS = ÇOKEĞERMİN
+MODE.MULT = ENÇOK_OLAN.ÇOK
+MODE.SNGL = ENÇOK_OLAN.TEK
+NEGBINOM.DIST = NEGBİNOM.DAĞ
+NORM.DIST = NORM.DAĞ
+NORM.INV = NORM.TERS
+NORM.S.DIST = NORM.S.DAĞ
+NORM.S.INV = NORM.S.TERS
+PEARSON = PEARSON
+PERCENTILE.EXC = YÜZDEBİRLİK.HRC
+PERCENTILE.INC = YÜZDEBİRLİK.DHL
+PERCENTRANK.EXC = YÜZDERANK.HRC
+PERCENTRANK.INC = YÜZDERANK.DHL
+PERMUT = PERMÜTASYON
+PERMUTATIONA = PERMÜTASYONA
+PHI = PHI
+POISSON.DIST = POISSON.DAĞ
+PROB = OLASILIK
+QUARTILE.EXC = DÖRTTEBİRLİK.HRC
+QUARTILE.INC = DÖRTTEBİRLİK.DHL
+RANK.AVG = RANK.ORT
+RANK.EQ = RANK.EŞİT
+RSQ = RKARE
+SKEW = ÇARPIKLIK
+SKEW.P = ÇARPIKLIK.P
+SLOPE = EĞİM
+SMALL = KÜÇÜK
+STANDARDIZE = STANDARTLAŞTIRMA
+STDEV.P = STDSAPMA.P
+STDEV.S = STDSAPMA.S
+STDEVA = STDSAPMAA
+STDEVPA = STDSAPMASA
+STEYX = STHYX
+T.DIST = T.DAĞ
+T.DIST.2T = T.DAĞ.2K
+T.DIST.RT = T.DAĞ.SAĞK
+T.INV = T.TERS
+T.INV.2T = T.TERS.2K
+T.TEST = T.TEST
+TREND = EĞİLİM
+TRIMMEAN = KIRPORTALAMA
+VAR.P = VAR.P
+VAR.S = VAR.S
+VARA = VARA
+VARPA = VARSA
+WEIBULL.DIST = WEIBULL.DAĞ
+Z.TEST = Z.TEST
+
+##
+## Metin işlevleri (Text Functions)
+##
+BAHTTEXT = BAHTMETİN
+CHAR = DAMGA
+CLEAN = TEMİZ
+CODE = KOD
+CONCAT = ARALIKBİRLEŞTİR
+DOLLAR = LİRA
+EXACT = ÖZDEŞ
+FIND = BUL
+FIXED = SAYIDÜZENLE
+ISTHAIDIGIT = TAYRAKAMIYSA
+LEFT = SOLDAN
+LEN = UZUNLUK
+LOWER = KÜÇÜKHARF
+MID = PARÇAAL
+NUMBERSTRING = SAYIDİZİ
+NUMBERVALUE = SAYIDEĞERİ
+PHONETIC = SES
+PROPER = YAZIM.DÜZENİ
+REPLACE = DEĞİŞTİR
+REPT = YİNELE
+RIGHT = SAĞDAN
+SEARCH = MBUL
+SUBSTITUTE = YERİNEKOY
+T = M
+TEXT = METNEÇEVİR
+TEXTJOIN = METİNBİRLEŞTİR
+THAIDIGIT = TAYRAKAM
+THAINUMSOUND = TAYSAYISES
+THAINUMSTRING = TAYSAYIDİZE
+THAISTRINGLENGTH = TAYDİZEUZUNLUĞU
+TRIM = KIRP
+UNICHAR = UNICODEKARAKTERİ
+UNICODE = UNICODE
+UPPER = BÜYÜKHARF
+VALUE = SAYIYAÇEVİR
+
+##
+## Metin işlevleri (Web Functions)
+##
+ENCODEURL = URLKODLA
+FILTERXML = XMLFİLTRELE
+WEBSERVICE = WEBHİZMETİ
+
+##
+## Uyumluluk işlevleri (Compatibility Functions)
+##
+BETADIST = BETADAĞ
+BETAINV = BETATERS
+BINOMDIST = BİNOMDAĞ
+CEILING = TAVANAYUVARLA
+CHIDIST = KİKAREDAĞ
+CHIINV = KİKARETERS
+CHITEST = KİKARETEST
+CONCATENATE = BİRLEŞTİR
+CONFIDENCE = GÜVENİRLİK
+COVAR = KOVARYANS
+CRITBINOM = KRİTİKBİNOM
+EXPONDIST = ÜSTELDAĞ
+FDIST = FDAĞ
+FINV = FTERS
+FLOOR = TABANAYUVARLA
+FORECAST = TAHMİN
+FTEST = FTEST
+GAMMADIST = GAMADAĞ
+GAMMAINV = GAMATERS
+HYPGEOMDIST = HİPERGEOMDAĞ
+LOGINV = LOGTERS
+LOGNORMDIST = LOGNORMDAĞ
+MODE = ENÇOK_OLAN
+NEGBINOMDIST = NEGBİNOMDAĞ
+NORMDIST = NORMDAĞ
+NORMINV = NORMTERS
+NORMSDIST = NORMSDAĞ
+NORMSINV = NORMSTERS
+PERCENTILE = YÜZDEBİRLİK
+PERCENTRANK = YÜZDERANK
+POISSON = POISSON
+QUARTILE = DÖRTTEBİRLİK
+RANK = RANK
+STDEV = STDSAPMA
+STDEVP = STDSAPMAS
+TDIST = TDAĞ
+TINV = TTERS
+TTEST = TTEST
+VAR = VAR
+VARP = VARS
+WEIBULL = WEIBULL
+ZTEST = ZTEST
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/AddressHelper.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/AddressHelper.php
new file mode 100644
index 00000000..923f9417
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/AddressHelper.php
@@ -0,0 +1,177 @@
+setValueExplicit(true, DataType::TYPE_BOOL);
+
+ return true;
+ } elseif (StringHelper::strToUpper($value) === Calculation::getFALSE()) {
+ $cell->setValueExplicit(false, DataType::TYPE_BOOL);
+
+ return true;
+ }
+
+ // Check for fractions
+ if (preg_match('~^([+-]?)\s*(\d+)\s*/\s*(\d+)$~', $value, $matches)) {
+ return $this->setProperFraction($matches, $cell);
+ } elseif (preg_match('~^([+-]?)(\d+)\s+(\d+)\s*/\s*(\d+)$~', $value, $matches)) {
+ return $this->setImproperFraction($matches, $cell);
+ }
+
+ $decimalSeparatorNoPreg = StringHelper::getDecimalSeparator();
+ $decimalSeparator = preg_quote($decimalSeparatorNoPreg, '/');
+ $thousandsSeparator = preg_quote(StringHelper::getThousandsSeparator(), '/');
+
+ // Check for percentage
+ if (preg_match('/^\-?\d*' . $decimalSeparator . '?\d*\s?\%$/', (string) preg_replace('/(\d)' . $thousandsSeparator . '(\d)/u', '$1$2', $value))) {
+ return $this->setPercentage((string) preg_replace('/(\d)' . $thousandsSeparator . '(\d)/u', '$1$2', $value), $cell);
+ }
+
+ // Check for currency
+ if (preg_match(FormattedNumber::currencyMatcherRegexp(), (string) preg_replace('/(\d)' . $thousandsSeparator . '(\d)/u', '$1$2', $value), $matches, PREG_UNMATCHED_AS_NULL)) {
+ // Convert value to number
+ $sign = ($matches['PrefixedSign'] ?? $matches['PrefixedSign2'] ?? $matches['PostfixedSign']) ?? null;
+ $currencyCode = $matches['PrefixedCurrency'] ?? $matches['PostfixedCurrency'];
+ /** @var string */
+ $temp = str_replace([$decimalSeparatorNoPreg, $currencyCode, ' ', '-'], ['.', '', '', ''], (string) preg_replace('/(\d)' . $thousandsSeparator . '(\d)/u', '$1$2', $value));
+ $value = (float) ($sign . trim($temp));
+
+ return $this->setCurrency($value, $cell, $currencyCode ?? '');
+ }
+
+ // Check for time without seconds e.g. '9:45', '09:45'
+ if (preg_match('/^(\d|[0-1]\d|2[0-3]):[0-5]\d$/', $value)) {
+ return $this->setTimeHoursMinutes($value, $cell);
+ }
+
+ // Check for time with seconds '9:45:59', '09:45:59'
+ if (preg_match('/^(\d|[0-1]\d|2[0-3]):[0-5]\d:[0-5]\d$/', $value)) {
+ return $this->setTimeHoursMinutesSeconds($value, $cell);
+ }
+
+ // Check for datetime, e.g. '2008-12-31', '2008-12-31 15:59', '2008-12-31 15:59:10'
+ if (($d = Date::stringToExcel($value)) !== false) {
+ // Convert value to number
+ $cell->setValueExplicit($d, DataType::TYPE_NUMERIC);
+ // Determine style. Either there is a time part or not. Look for ':'
+ if (str_contains($value, ':')) {
+ $formatCode = 'yyyy-mm-dd h:mm';
+ } else {
+ $formatCode = 'yyyy-mm-dd';
+ }
+ $cell->getWorksheet()->getStyle($cell->getCoordinate())
+ ->getNumberFormat()->setFormatCode($formatCode);
+
+ return true;
+ }
+
+ // Check for newline character "\n"
+ if (str_contains($value, "\n")) {
+ $cell->setValueExplicit($value, DataType::TYPE_STRING);
+ // Set style
+ $cell->getWorksheet()->getStyle($cell->getCoordinate())
+ ->getAlignment()->setWrapText(true);
+
+ return true;
+ }
+ }
+
+ // Not bound yet? Use parent...
+ return parent::bindValue($cell, $value);
+ }
+
+ protected function setImproperFraction(array $matches, Cell $cell): bool
+ {
+ // Convert value to number
+ $value = $matches[2] + ($matches[3] / $matches[4]);
+ if ($matches[1] === '-') {
+ $value = 0 - $value;
+ }
+ $cell->setValueExplicit((float) $value, DataType::TYPE_NUMERIC);
+
+ // Build the number format mask based on the size of the matched values
+ $dividend = str_repeat('?', strlen($matches[3]));
+ $divisor = str_repeat('?', strlen($matches[4]));
+ $fractionMask = "# {$dividend}/{$divisor}";
+ // Set style
+ $cell->getWorksheet()->getStyle($cell->getCoordinate())
+ ->getNumberFormat()->setFormatCode($fractionMask);
+
+ return true;
+ }
+
+ protected function setProperFraction(array $matches, Cell $cell): bool
+ {
+ // Convert value to number
+ $value = $matches[2] / $matches[3];
+ if ($matches[1] === '-') {
+ $value = 0 - $value;
+ }
+ $cell->setValueExplicit((float) $value, DataType::TYPE_NUMERIC);
+
+ // Build the number format mask based on the size of the matched values
+ $dividend = str_repeat('?', strlen($matches[2]));
+ $divisor = str_repeat('?', strlen($matches[3]));
+ $fractionMask = "{$dividend}/{$divisor}";
+ // Set style
+ $cell->getWorksheet()->getStyle($cell->getCoordinate())
+ ->getNumberFormat()->setFormatCode($fractionMask);
+
+ return true;
+ }
+
+ protected function setPercentage(string $value, Cell $cell): bool
+ {
+ // Convert value to number
+ $value = ((float) str_replace('%', '', $value)) / 100;
+ $cell->setValueExplicit($value, DataType::TYPE_NUMERIC);
+
+ // Set style
+ $cell->getWorksheet()->getStyle($cell->getCoordinate())
+ ->getNumberFormat()->setFormatCode(NumberFormat::FORMAT_PERCENTAGE_00);
+
+ return true;
+ }
+
+ protected function setCurrency(float $value, Cell $cell, string $currencyCode): bool
+ {
+ $cell->setValueExplicit($value, DataType::TYPE_NUMERIC);
+ // Set style
+ $cell->getWorksheet()->getStyle($cell->getCoordinate())
+ ->getNumberFormat()->setFormatCode(
+ str_replace('$', '[$' . $currencyCode . ']', NumberFormat::FORMAT_CURRENCY_USD)
+ );
+
+ return true;
+ }
+
+ protected function setTimeHoursMinutes(string $value, Cell $cell): bool
+ {
+ // Convert value to number
+ [$hours, $minutes] = explode(':', $value);
+ $hours = (int) $hours;
+ $minutes = (int) $minutes;
+ $days = ($hours / 24) + ($minutes / 1440);
+ $cell->setValueExplicit($days, DataType::TYPE_NUMERIC);
+
+ // Set style
+ $cell->getWorksheet()->getStyle($cell->getCoordinate())
+ ->getNumberFormat()->setFormatCode(NumberFormat::FORMAT_DATE_TIME3);
+
+ return true;
+ }
+
+ protected function setTimeHoursMinutesSeconds(string $value, Cell $cell): bool
+ {
+ // Convert value to number
+ [$hours, $minutes, $seconds] = explode(':', $value);
+ $hours = (int) $hours;
+ $minutes = (int) $minutes;
+ $seconds = (int) $seconds;
+ $days = ($hours / 24) + ($minutes / 1440) + ($seconds / 86400);
+ $cell->setValueExplicit($days, DataType::TYPE_NUMERIC);
+
+ // Set style
+ $cell->getWorksheet()->getStyle($cell->getCoordinate())
+ ->getNumberFormat()->setFormatCode(NumberFormat::FORMAT_DATE_TIME4);
+
+ return true;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Cell.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Cell.php
new file mode 100644
index 00000000..f10af3ab
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Cell.php
@@ -0,0 +1,863 @@
+parent;
+ if ($parent === null) {
+ throw new SpreadsheetException('Cannot update when cell is not bound to a worksheet');
+ }
+ $parent->update($this);
+
+ return $this;
+ }
+
+ public function detach(): void
+ {
+ $this->parent = null;
+ }
+
+ public function attach(Cells $parent): void
+ {
+ $this->parent = $parent;
+ }
+
+ /**
+ * Create a new Cell.
+ *
+ * @throws SpreadsheetException
+ */
+ public function __construct(mixed $value, ?string $dataType, Worksheet $worksheet)
+ {
+ // Initialise cell value
+ $this->value = $value;
+
+ // Set worksheet cache
+ $this->parent = $worksheet->getCellCollection();
+
+ // Set datatype?
+ if ($dataType !== null) {
+ if ($dataType == DataType::TYPE_STRING2) {
+ $dataType = DataType::TYPE_STRING;
+ }
+ $this->dataType = $dataType;
+ } elseif (self::getValueBinder()->bindValue($this, $value) === false) {
+ throw new SpreadsheetException('Value could not be bound to cell.');
+ }
+ $this->ignoredErrors = new IgnoredErrors();
+ }
+
+ /**
+ * Get cell coordinate column.
+ *
+ * @throws SpreadsheetException
+ */
+ public function getColumn(): string
+ {
+ $parent = $this->parent;
+ if ($parent === null) {
+ throw new SpreadsheetException('Cannot get column when cell is not bound to a worksheet');
+ }
+
+ return $parent->getCurrentColumn();
+ }
+
+ /**
+ * Get cell coordinate row.
+ *
+ * @throws SpreadsheetException
+ */
+ public function getRow(): int
+ {
+ $parent = $this->parent;
+ if ($parent === null) {
+ throw new SpreadsheetException('Cannot get row when cell is not bound to a worksheet');
+ }
+
+ return $parent->getCurrentRow();
+ }
+
+ /**
+ * Get cell coordinate.
+ *
+ * @throws SpreadsheetException
+ */
+ public function getCoordinate(): string
+ {
+ $parent = $this->parent;
+ if ($parent !== null) {
+ $coordinate = $parent->getCurrentCoordinate();
+ } else {
+ $coordinate = null;
+ }
+ if ($coordinate === null) {
+ throw new SpreadsheetException('Coordinate no longer exists');
+ }
+
+ return $coordinate;
+ }
+
+ /**
+ * Get cell value.
+ */
+ public function getValue(): mixed
+ {
+ return $this->value;
+ }
+
+ public function getValueString(): string
+ {
+ $value = $this->value;
+
+ return ($value === '' || is_scalar($value) || $value instanceof Stringable) ? "$value" : '';
+ }
+
+ /**
+ * Get cell value with formatting.
+ */
+ public function getFormattedValue(): string
+ {
+ $currentCalendar = SharedDate::getExcelCalendar();
+ SharedDate::setExcelCalendar($this->getWorksheet()->getParent()?->getExcelCalendar());
+ $formattedValue = (string) NumberFormat::toFormattedString(
+ $this->getCalculatedValue(),
+ (string) $this->getStyle()->getNumberFormat()->getFormatCode(true)
+ );
+ SharedDate::setExcelCalendar($currentCalendar);
+
+ return $formattedValue;
+ }
+
+ protected static function updateIfCellIsTableHeader(?Worksheet $workSheet, self $cell, mixed $oldValue, mixed $newValue): void
+ {
+ $oldValue = (is_scalar($oldValue) || $oldValue instanceof Stringable) ? ((string) $oldValue) : null;
+ $newValue = (is_scalar($newValue) || $newValue instanceof Stringable) ? ((string) $newValue) : null;
+ if (StringHelper::strToLower($oldValue ?? '') === StringHelper::strToLower($newValue ?? '') || $workSheet === null) {
+ return;
+ }
+
+ foreach ($workSheet->getTableCollection() as $table) {
+ /** @var Table $table */
+ if ($cell->isInRange($table->getRange())) {
+ $rangeRowsColumns = Coordinate::getRangeBoundaries($table->getRange());
+ if ($cell->getRow() === (int) $rangeRowsColumns[0][1]) {
+ Table\Column::updateStructuredReferences($workSheet, $oldValue, $newValue);
+ }
+
+ return;
+ }
+ }
+ }
+
+ /**
+ * Set cell value.
+ *
+ * Sets the value for a cell, automatically determining the datatype using the value binder
+ *
+ * @param mixed $value Value
+ * @param null|IValueBinder $binder Value Binder to override the currently set Value Binder
+ *
+ * @throws SpreadsheetException
+ */
+ public function setValue(mixed $value, ?IValueBinder $binder = null): self
+ {
+ $binder ??= self::getValueBinder();
+ if (!$binder->bindValue($this, $value)) {
+ throw new SpreadsheetException('Value could not be bound to cell.');
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set the value for a cell, with the explicit data type passed to the method (bypassing any use of the value binder).
+ *
+ * @param mixed $value Value
+ * @param string $dataType Explicit data type, see DataType::TYPE_*
+ * Note that PhpSpreadsheet does not validate that the value and datatype are consistent, in using this
+ * method, then it is your responsibility as an end-user developer to validate that the value and
+ * the datatype match.
+ * If you do mismatch value and datatype, then the value you enter may be changed to match the datatype
+ * that you specify.
+ *
+ * @throws SpreadsheetException
+ */
+ public function setValueExplicit(mixed $value, string $dataType = DataType::TYPE_STRING): self
+ {
+ $oldValue = $this->value;
+ $quotePrefix = false;
+
+ // set the value according to data type
+ switch ($dataType) {
+ case DataType::TYPE_NULL:
+ $this->value = null;
+
+ break;
+ case DataType::TYPE_STRING2:
+ $dataType = DataType::TYPE_STRING;
+ // no break
+ case DataType::TYPE_STRING:
+ // Synonym for string
+ if (is_string($value) && strlen($value) > 1 && $value[0] === '=') {
+ $quotePrefix = true;
+ }
+ // no break
+ case DataType::TYPE_INLINE:
+ // Rich text
+ if ($value !== null && !is_scalar($value) && !($value instanceof Stringable)) {
+ throw new SpreadsheetException('Invalid unstringable value for datatype Inline/String/String2');
+ }
+ $this->value = DataType::checkString(($value instanceof RichText) ? $value : ((string) $value));
+
+ break;
+ case DataType::TYPE_NUMERIC:
+ if (is_string($value) && !is_numeric($value)) {
+ throw new SpreadsheetException('Invalid numeric value for datatype Numeric');
+ }
+ $this->value = 0 + $value;
+
+ break;
+ case DataType::TYPE_FORMULA:
+ if ($value !== null && !is_scalar($value) && !($value instanceof Stringable)) {
+ throw new SpreadsheetException('Invalid unstringable value for datatype Formula');
+ }
+ $this->value = (string) $value;
+
+ break;
+ case DataType::TYPE_BOOL:
+ $this->value = (bool) $value;
+
+ break;
+ case DataType::TYPE_ISO_DATE:
+ $this->value = SharedDate::convertIsoDate($value);
+ $dataType = DataType::TYPE_NUMERIC;
+
+ break;
+ case DataType::TYPE_ERROR:
+ $this->value = DataType::checkErrorCode($value);
+
+ break;
+ default:
+ throw new SpreadsheetException('Invalid datatype: ' . $dataType);
+ }
+
+ // set the datatype
+ $this->dataType = $dataType;
+
+ $this->updateInCollection();
+ $cellCoordinate = $this->getCoordinate();
+ self::updateIfCellIsTableHeader($this->getParent()?->getParent(), $this, $oldValue, $value);
+ $worksheet = $this->getWorksheet();
+ $spreadsheet = $worksheet->getParent();
+ if (isset($spreadsheet) && $spreadsheet->getIndex($worksheet, true) >= 0) {
+ $originalSelected = $worksheet->getSelectedCells();
+ $activeSheetIndex = $spreadsheet->getActiveSheetIndex();
+ $style = $this->getStyle();
+ $oldQuotePrefix = $style->getQuotePrefix();
+ if ($oldQuotePrefix !== $quotePrefix) {
+ $style->setQuotePrefix($quotePrefix);
+ }
+ $worksheet->setSelectedCells($originalSelected);
+ if ($activeSheetIndex >= 0) {
+ $spreadsheet->setActiveSheetIndex($activeSheetIndex);
+ }
+ }
+
+ return $this->getParent()?->get($cellCoordinate) ?? $this;
+ }
+
+ public const CALCULATE_DATE_TIME_ASIS = 0;
+ public const CALCULATE_DATE_TIME_FLOAT = 1;
+ public const CALCULATE_TIME_FLOAT = 2;
+
+ private static int $calculateDateTimeType = self::CALCULATE_DATE_TIME_ASIS;
+
+ public static function getCalculateDateTimeType(): int
+ {
+ return self::$calculateDateTimeType;
+ }
+
+ /** @throws CalculationException */
+ public static function setCalculateDateTimeType(int $calculateDateTimeType): void
+ {
+ self::$calculateDateTimeType = match ($calculateDateTimeType) {
+ self::CALCULATE_DATE_TIME_ASIS, self::CALCULATE_DATE_TIME_FLOAT, self::CALCULATE_TIME_FLOAT => $calculateDateTimeType,
+ default => throw new CalculationException("Invalid value $calculateDateTimeType for calculated date time type"),
+ };
+ }
+
+ /**
+ * Convert date, time, or datetime from int to float if desired.
+ */
+ private function convertDateTimeInt(mixed $result): mixed
+ {
+ if (is_int($result)) {
+ if (self::$calculateDateTimeType === self::CALCULATE_TIME_FLOAT) {
+ if (SharedDate::isDateTime($this, $result, false)) {
+ $result = (float) $result;
+ }
+ } elseif (self::$calculateDateTimeType === self::CALCULATE_DATE_TIME_FLOAT) {
+ if (SharedDate::isDateTime($this, $result, true)) {
+ $result = (float) $result;
+ }
+ }
+ }
+
+ return $result;
+ }
+
+ /**
+ * Get calculated cell value converted to string.
+ */
+ public function getCalculatedValueString(): string
+ {
+ $value = $this->getCalculatedValue();
+
+ return ($value === '' || is_scalar($value) || $value instanceof Stringable) ? "$value" : '';
+ }
+
+ /**
+ * Get calculated cell value.
+ *
+ * @param bool $resetLog Whether the calculation engine logger should be reset or not
+ *
+ * @throws CalculationException
+ */
+ public function getCalculatedValue(bool $resetLog = true): mixed
+ {
+ if ($this->dataType === DataType::TYPE_FORMULA) {
+ try {
+ $currentCalendar = SharedDate::getExcelCalendar();
+ SharedDate::setExcelCalendar($this->getWorksheet()->getParent()?->getExcelCalendar());
+ $index = $this->getWorksheet()->getParentOrThrow()->getActiveSheetIndex();
+ $selected = $this->getWorksheet()->getSelectedCells();
+ $result = Calculation::getInstance(
+ $this->getWorksheet()->getParent()
+ )->calculateCellValue($this, $resetLog);
+ $result = $this->convertDateTimeInt($result);
+ $this->getWorksheet()->setSelectedCells($selected);
+ $this->getWorksheet()->getParentOrThrow()->setActiveSheetIndex($index);
+ // We don't yet handle array returns
+ if (is_array($result)) {
+ while (is_array($result)) {
+ $result = array_shift($result);
+ }
+ }
+ } catch (SpreadsheetException $ex) {
+ SharedDate::setExcelCalendar($currentCalendar);
+ if (($ex->getMessage() === 'Unable to access External Workbook') && ($this->calculatedValue !== null)) {
+ return $this->calculatedValue; // Fallback for calculations referencing external files.
+ } elseif (preg_match('/[Uu]ndefined (name|offset: 2|array key 2)/', $ex->getMessage()) === 1) {
+ return ExcelError::NAME();
+ }
+
+ throw new CalculationException(
+ $this->getWorksheet()->getTitle() . '!' . $this->getCoordinate() . ' -> ' . $ex->getMessage(),
+ $ex->getCode(),
+ $ex
+ );
+ }
+ SharedDate::setExcelCalendar($currentCalendar);
+
+ if ($result === Functions::NOT_YET_IMPLEMENTED) {
+ return $this->calculatedValue; // Fallback if calculation engine does not support the formula.
+ }
+
+ return $result;
+ } elseif ($this->value instanceof RichText) {
+ return $this->value->getPlainText();
+ }
+
+ return $this->convertDateTimeInt($this->value);
+ }
+
+ /**
+ * Set old calculated value (cached).
+ *
+ * @param mixed $originalValue Value
+ */
+ public function setCalculatedValue(mixed $originalValue, bool $tryNumeric = true): self
+ {
+ if ($originalValue !== null) {
+ $this->calculatedValue = ($tryNumeric && is_numeric($originalValue)) ? (0 + $originalValue) : $originalValue;
+ }
+
+ return $this->updateInCollection();
+ }
+
+ /**
+ * Get old calculated value (cached)
+ * This returns the value last calculated by MS Excel or whichever spreadsheet program was used to
+ * create the original spreadsheet file.
+ * Note that this value is not guaranteed to reflect the actual calculated value because it is
+ * possible that auto-calculation was disabled in the original spreadsheet, and underlying data
+ * values used by the formula have changed since it was last calculated.
+ */
+ public function getOldCalculatedValue(): mixed
+ {
+ return $this->calculatedValue;
+ }
+
+ /**
+ * Get cell data type.
+ */
+ public function getDataType(): string
+ {
+ return $this->dataType;
+ }
+
+ /**
+ * Set cell data type.
+ *
+ * @param string $dataType see DataType::TYPE_*
+ */
+ public function setDataType(string $dataType): self
+ {
+ $this->setValueExplicit($this->value, $dataType);
+
+ return $this;
+ }
+
+ /**
+ * Identify if the cell contains a formula.
+ */
+ public function isFormula(): bool
+ {
+ return $this->dataType === DataType::TYPE_FORMULA && $this->getStyle()->getQuotePrefix() === false;
+ }
+
+ /**
+ * Does this cell contain Data validation rules?
+ *
+ * @throws SpreadsheetException
+ */
+ public function hasDataValidation(): bool
+ {
+ if (!isset($this->parent)) {
+ throw new SpreadsheetException('Cannot check for data validation when cell is not bound to a worksheet');
+ }
+
+ return $this->getWorksheet()->dataValidationExists($this->getCoordinate());
+ }
+
+ /**
+ * Get Data validation rules.
+ *
+ * @throws SpreadsheetException
+ */
+ public function getDataValidation(): DataValidation
+ {
+ if (!isset($this->parent)) {
+ throw new SpreadsheetException('Cannot get data validation for cell that is not bound to a worksheet');
+ }
+
+ return $this->getWorksheet()->getDataValidation($this->getCoordinate());
+ }
+
+ /**
+ * Set Data validation rules.
+ *
+ * @throws SpreadsheetException
+ */
+ public function setDataValidation(?DataValidation $dataValidation = null): self
+ {
+ if (!isset($this->parent)) {
+ throw new SpreadsheetException('Cannot set data validation for cell that is not bound to a worksheet');
+ }
+
+ $this->getWorksheet()->setDataValidation($this->getCoordinate(), $dataValidation);
+
+ return $this->updateInCollection();
+ }
+
+ /**
+ * Does this cell contain valid value?
+ */
+ public function hasValidValue(): bool
+ {
+ $validator = new DataValidator();
+
+ return $validator->isValid($this);
+ }
+
+ /**
+ * Does this cell contain a Hyperlink?
+ *
+ * @throws SpreadsheetException
+ */
+ public function hasHyperlink(): bool
+ {
+ if (!isset($this->parent)) {
+ throw new SpreadsheetException('Cannot check for hyperlink when cell is not bound to a worksheet');
+ }
+
+ return $this->getWorksheet()->hyperlinkExists($this->getCoordinate());
+ }
+
+ /**
+ * Get Hyperlink.
+ *
+ * @throws SpreadsheetException
+ */
+ public function getHyperlink(): Hyperlink
+ {
+ if (!isset($this->parent)) {
+ throw new SpreadsheetException('Cannot get hyperlink for cell that is not bound to a worksheet');
+ }
+
+ return $this->getWorksheet()->getHyperlink($this->getCoordinate());
+ }
+
+ /**
+ * Set Hyperlink.
+ *
+ * @throws SpreadsheetException
+ */
+ public function setHyperlink(?Hyperlink $hyperlink = null): self
+ {
+ if (!isset($this->parent)) {
+ throw new SpreadsheetException('Cannot set hyperlink for cell that is not bound to a worksheet');
+ }
+
+ $this->getWorksheet()->setHyperlink($this->getCoordinate(), $hyperlink);
+
+ return $this->updateInCollection();
+ }
+
+ /**
+ * Get cell collection.
+ */
+ public function getParent(): ?Cells
+ {
+ return $this->parent;
+ }
+
+ /**
+ * Get parent worksheet.
+ *
+ * @throws SpreadsheetException
+ */
+ public function getWorksheet(): Worksheet
+ {
+ $parent = $this->parent;
+ if ($parent !== null) {
+ $worksheet = $parent->getParent();
+ } else {
+ $worksheet = null;
+ }
+
+ if ($worksheet === null) {
+ throw new SpreadsheetException('Worksheet no longer exists');
+ }
+
+ return $worksheet;
+ }
+
+ public function getWorksheetOrNull(): ?Worksheet
+ {
+ $parent = $this->parent;
+ if ($parent !== null) {
+ $worksheet = $parent->getParent();
+ } else {
+ $worksheet = null;
+ }
+
+ return $worksheet;
+ }
+
+ /**
+ * Is this cell in a merge range.
+ */
+ public function isInMergeRange(): bool
+ {
+ return (bool) $this->getMergeRange();
+ }
+
+ /**
+ * Is this cell the master (top left cell) in a merge range (that holds the actual data value).
+ */
+ public function isMergeRangeValueCell(): bool
+ {
+ if ($mergeRange = $this->getMergeRange()) {
+ $mergeRange = Coordinate::splitRange($mergeRange);
+ [$startCell] = $mergeRange[0];
+
+ return $this->getCoordinate() === $startCell;
+ }
+
+ return false;
+ }
+
+ /**
+ * If this cell is in a merge range, then return the range.
+ *
+ * @return false|string
+ */
+ public function getMergeRange()
+ {
+ foreach ($this->getWorksheet()->getMergeCells() as $mergeRange) {
+ if ($this->isInRange($mergeRange)) {
+ return $mergeRange;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Get cell style.
+ */
+ public function getStyle(): Style
+ {
+ return $this->getWorksheet()->getStyle($this->getCoordinate());
+ }
+
+ /**
+ * Get cell style.
+ */
+ public function getAppliedStyle(): Style
+ {
+ if ($this->getWorksheet()->conditionalStylesExists($this->getCoordinate()) === false) {
+ return $this->getStyle();
+ }
+ $range = $this->getWorksheet()->getConditionalRange($this->getCoordinate());
+ if ($range === null) {
+ return $this->getStyle();
+ }
+
+ $matcher = new CellStyleAssessor($this, $range);
+
+ return $matcher->matchConditions($this->getWorksheet()->getConditionalStyles($this->getCoordinate()));
+ }
+
+ /**
+ * Re-bind parent.
+ */
+ public function rebindParent(Worksheet $parent): self
+ {
+ $this->parent = $parent->getCellCollection();
+
+ return $this->updateInCollection();
+ }
+
+ /**
+ * Is cell in a specific range?
+ *
+ * @param string $range Cell range (e.g. A1:A1)
+ */
+ public function isInRange(string $range): bool
+ {
+ [$rangeStart, $rangeEnd] = Coordinate::rangeBoundaries($range);
+
+ // Translate properties
+ $myColumn = Coordinate::columnIndexFromString($this->getColumn());
+ $myRow = $this->getRow();
+
+ // Verify if cell is in range
+ return ($rangeStart[0] <= $myColumn) && ($rangeEnd[0] >= $myColumn)
+ && ($rangeStart[1] <= $myRow) && ($rangeEnd[1] >= $myRow);
+ }
+
+ /**
+ * Compare 2 cells.
+ *
+ * @param Cell $a Cell a
+ * @param Cell $b Cell b
+ *
+ * @return int Result of comparison (always -1 or 1, never zero!)
+ */
+ public static function compareCells(self $a, self $b): int
+ {
+ if ($a->getRow() < $b->getRow()) {
+ return -1;
+ } elseif ($a->getRow() > $b->getRow()) {
+ return 1;
+ } elseif (Coordinate::columnIndexFromString($a->getColumn()) < Coordinate::columnIndexFromString($b->getColumn())) {
+ return -1;
+ }
+
+ return 1;
+ }
+
+ /**
+ * Get value binder to use.
+ */
+ public static function getValueBinder(): IValueBinder
+ {
+ if (self::$valueBinder === null) {
+ self::$valueBinder = new DefaultValueBinder();
+ }
+
+ return self::$valueBinder;
+ }
+
+ /**
+ * Set value binder to use.
+ */
+ public static function setValueBinder(IValueBinder $binder): void
+ {
+ self::$valueBinder = $binder;
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $vars = get_object_vars($this);
+ foreach ($vars as $propertyName => $propertyValue) {
+ if ((is_object($propertyValue)) && ($propertyName !== 'parent')) {
+ $this->$propertyName = clone $propertyValue;
+ } else {
+ $this->$propertyName = $propertyValue;
+ }
+ }
+ }
+
+ /**
+ * Get index to cellXf.
+ */
+ public function getXfIndex(): int
+ {
+ return $this->xfIndex;
+ }
+
+ /**
+ * Set index to cellXf.
+ */
+ public function setXfIndex(int $indexValue): self
+ {
+ $this->xfIndex = $indexValue;
+
+ return $this->updateInCollection();
+ }
+
+ /**
+ * Set the formula attributes.
+ *
+ * @return $this
+ */
+ public function setFormulaAttributes(mixed $attributes): self
+ {
+ $this->formulaAttributes = $attributes;
+
+ return $this;
+ }
+
+ /**
+ * Get the formula attributes.
+ */
+ public function getFormulaAttributes(): mixed
+ {
+ return $this->formulaAttributes;
+ }
+
+ /**
+ * Convert to string.
+ */
+ public function __toString(): string
+ {
+ $retVal = $this->value;
+
+ return ($retVal === null || is_scalar($retVal) || $retVal instanceof Stringable) ? ((string) $retVal) : '';
+ }
+
+ public function getIgnoredErrors(): IgnoredErrors
+ {
+ return $this->ignoredErrors;
+ }
+
+ public function isLocked(): bool
+ {
+ $protected = $this->parent?->getParent()?->getProtection()?->getSheet();
+ if ($protected !== true) {
+ return false;
+ }
+ $locked = $this->getStyle()->getProtection()->getLocked();
+
+ return $locked !== Protection::PROTECTION_UNPROTECTED;
+ }
+
+ public function isHiddenOnFormulaBar(): bool
+ {
+ if ($this->getDataType() !== DataType::TYPE_FORMULA) {
+ return false;
+ }
+ $protected = $this->parent?->getParent()?->getProtection()?->getSheet();
+ if ($protected !== true) {
+ return false;
+ }
+ $hidden = $this->getStyle()->getProtection()->getHidden();
+
+ return $hidden !== Protection::PROTECTION_UNPROTECTED;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/CellAddress.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/CellAddress.php
new file mode 100644
index 00000000..ab6258e6
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/CellAddress.php
@@ -0,0 +1,148 @@
+cellAddress = str_replace('$', '', $cellAddress);
+ [$this->columnId, $this->rowId, $this->columnName] = Coordinate::indexesFromString($this->cellAddress);
+ $this->worksheet = $worksheet;
+ }
+
+ public function __destruct()
+ {
+ unset($this->worksheet);
+ }
+
+ /**
+ * @phpstan-assert int|numeric-string $columnId
+ * @phpstan-assert int|numeric-string $rowId
+ */
+ private static function validateColumnAndRow(int|string $columnId, int|string $rowId): void
+ {
+ if (!is_numeric($columnId) || $columnId <= 0 || !is_numeric($rowId) || $rowId <= 0) {
+ throw new Exception('Row and Column Ids must be positive integer values');
+ }
+ }
+
+ public static function fromColumnAndRow(int|string $columnId, int|string $rowId, ?Worksheet $worksheet = null): self
+ {
+ self::validateColumnAndRow($columnId, $rowId);
+
+ return new self(Coordinate::stringFromColumnIndex($columnId) . $rowId, $worksheet);
+ }
+
+ public static function fromColumnRowArray(array $array, ?Worksheet $worksheet = null): self
+ {
+ [$columnId, $rowId] = $array;
+
+ return self::fromColumnAndRow($columnId, $rowId, $worksheet);
+ }
+
+ public static function fromCellAddress(string $cellAddress, ?Worksheet $worksheet = null): self
+ {
+ return new self($cellAddress, $worksheet);
+ }
+
+ /**
+ * The returned address string will contain the worksheet name as well, if available,
+ * (ie. if a Worksheet was provided to the constructor).
+ * e.g. "'Mark''s Worksheet'!C5".
+ */
+ public function fullCellAddress(): string
+ {
+ if ($this->worksheet !== null) {
+ $title = str_replace("'", "''", $this->worksheet->getTitle());
+
+ return "'{$title}'!{$this->cellAddress}";
+ }
+
+ return $this->cellAddress;
+ }
+
+ public function worksheet(): ?Worksheet
+ {
+ return $this->worksheet;
+ }
+
+ /**
+ * The returned address string will contain just the column/row address,
+ * (even if a Worksheet was provided to the constructor).
+ * e.g. "C5".
+ */
+ public function cellAddress(): string
+ {
+ return $this->cellAddress;
+ }
+
+ public function rowId(): int
+ {
+ return $this->rowId;
+ }
+
+ public function columnId(): int
+ {
+ return $this->columnId;
+ }
+
+ public function columnName(): string
+ {
+ return $this->columnName;
+ }
+
+ public function nextRow(int $offset = 1): self
+ {
+ $newRowId = $this->rowId + $offset;
+ if ($newRowId < 1) {
+ $newRowId = 1;
+ }
+
+ return self::fromColumnAndRow($this->columnId, $newRowId);
+ }
+
+ public function previousRow(int $offset = 1): self
+ {
+ return $this->nextRow(0 - $offset);
+ }
+
+ public function nextColumn(int $offset = 1): self
+ {
+ $newColumnId = $this->columnId + $offset;
+ if ($newColumnId < 1) {
+ $newColumnId = 1;
+ }
+
+ return self::fromColumnAndRow($newColumnId, $this->rowId);
+ }
+
+ public function previousColumn(int $offset = 1): self
+ {
+ return $this->nextColumn(0 - $offset);
+ }
+
+ /**
+ * The returned address string will contain the worksheet name as well, if available,
+ * (ie. if a Worksheet was provided to the constructor).
+ * e.g. "'Mark''s Worksheet'!C5".
+ */
+ public function __toString(): string
+ {
+ return $this->fullCellAddress();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/CellRange.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/CellRange.php
new file mode 100644
index 00000000..677009db
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/CellRange.php
@@ -0,0 +1,134 @@
+
+ */
+class CellRange implements AddressRange, Stringable
+{
+ protected CellAddress $from;
+
+ protected CellAddress $to;
+
+ public function __construct(CellAddress $from, CellAddress $to)
+ {
+ $this->validateFromTo($from, $to);
+ }
+
+ private function validateFromTo(CellAddress $from, CellAddress $to): void
+ {
+ // Identify actual top-left and bottom-right values (in case we've been given top-right and bottom-left)
+ $firstColumn = min($from->columnId(), $to->columnId());
+ $firstRow = min($from->rowId(), $to->rowId());
+ $lastColumn = max($from->columnId(), $to->columnId());
+ $lastRow = max($from->rowId(), $to->rowId());
+
+ $fromWorksheet = $from->worksheet();
+ $toWorksheet = $to->worksheet();
+ $this->validateWorksheets($fromWorksheet, $toWorksheet);
+
+ $this->from = $this->cellAddressWrapper($firstColumn, $firstRow, $fromWorksheet);
+ $this->to = $this->cellAddressWrapper($lastColumn, $lastRow, $toWorksheet);
+ }
+
+ private function validateWorksheets(?Worksheet $fromWorksheet, ?Worksheet $toWorksheet): void
+ {
+ if ($fromWorksheet !== null && $toWorksheet !== null) {
+ // We could simply compare worksheets rather than worksheet titles; but at some point we may introduce
+ // support for 3d ranges; and at that point we drop this check and let the validation fall through
+ // to the check for same workbook; but unless we check on titles, this test will also detect if the
+ // worksheets are in different spreadsheets, and the next check will never execute or throw its
+ // own exception.
+ if ($fromWorksheet->getTitle() !== $toWorksheet->getTitle()) {
+ throw new Exception('3d Cell Ranges are not supported');
+ } elseif ($fromWorksheet->getParent() !== $toWorksheet->getParent()) {
+ throw new Exception('Worksheets must be in the same spreadsheet');
+ }
+ }
+ }
+
+ private function cellAddressWrapper(int $column, int $row, ?Worksheet $worksheet = null): CellAddress
+ {
+ $cellAddress = Coordinate::stringFromColumnIndex($column) . (string) $row;
+
+ return new class ($cellAddress, $worksheet) extends CellAddress {
+ public function nextRow(int $offset = 1): CellAddress
+ {
+ /** @var CellAddress $result */
+ $result = parent::nextRow($offset);
+ $this->rowId = $result->rowId;
+ $this->cellAddress = $result->cellAddress;
+
+ return $this;
+ }
+
+ public function previousRow(int $offset = 1): CellAddress
+ {
+ /** @var CellAddress $result */
+ $result = parent::previousRow($offset);
+ $this->rowId = $result->rowId;
+ $this->cellAddress = $result->cellAddress;
+
+ return $this;
+ }
+
+ public function nextColumn(int $offset = 1): CellAddress
+ {
+ /** @var CellAddress $result */
+ $result = parent::nextColumn($offset);
+ $this->columnId = $result->columnId;
+ $this->columnName = $result->columnName;
+ $this->cellAddress = $result->cellAddress;
+
+ return $this;
+ }
+
+ public function previousColumn(int $offset = 1): CellAddress
+ {
+ /** @var CellAddress $result */
+ $result = parent::previousColumn($offset);
+ $this->columnId = $result->columnId;
+ $this->columnName = $result->columnName;
+ $this->cellAddress = $result->cellAddress;
+
+ return $this;
+ }
+ };
+ }
+
+ public function from(): CellAddress
+ {
+ // Re-order from/to in case the cell addresses have been modified
+ $this->validateFromTo($this->from, $this->to);
+
+ return $this->from;
+ }
+
+ public function to(): CellAddress
+ {
+ // Re-order from/to in case the cell addresses have been modified
+ $this->validateFromTo($this->from, $this->to);
+
+ return $this->to;
+ }
+
+ public function __toString(): string
+ {
+ // Re-order from/to in case the cell addresses have been modified
+ $this->validateFromTo($this->from, $this->to);
+
+ if ($this->from->cellAddress() === $this->to->cellAddress()) {
+ return "{$this->from->fullCellAddress()}";
+ }
+
+ $fromAddress = $this->from->fullCellAddress();
+ $toAddress = $this->to->cellAddress();
+
+ return "{$fromAddress}:{$toAddress}";
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/ColumnRange.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/ColumnRange.php
new file mode 100644
index 00000000..7f32a05c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/ColumnRange.php
@@ -0,0 +1,125 @@
+
+ */
+class ColumnRange implements AddressRange, Stringable
+{
+ protected ?Worksheet $worksheet;
+
+ protected int $from;
+
+ protected int $to;
+
+ public function __construct(string $from, ?string $to = null, ?Worksheet $worksheet = null)
+ {
+ $this->validateFromTo(
+ Coordinate::columnIndexFromString($from),
+ Coordinate::columnIndexFromString($to ?? $from)
+ );
+ $this->worksheet = $worksheet;
+ }
+
+ public function __destruct()
+ {
+ $this->worksheet = null;
+ }
+
+ public static function fromColumnIndexes(int $from, int $to, ?Worksheet $worksheet = null): self
+ {
+ return new self(Coordinate::stringFromColumnIndex($from), Coordinate::stringFromColumnIndex($to), $worksheet);
+ }
+
+ /**
+ * @param array $array
+ */
+ public static function fromArray(array $array, ?Worksheet $worksheet = null): self
+ {
+ array_walk(
+ $array,
+ function (&$column): void {
+ $column = is_numeric($column) ? Coordinate::stringFromColumnIndex((int) $column) : $column;
+ }
+ );
+ /** @var string $from */
+ /** @var string $to */
+ [$from, $to] = $array;
+
+ return new self($from, $to, $worksheet);
+ }
+
+ private function validateFromTo(int $from, int $to): void
+ {
+ // Identify actual top and bottom values (in case we've been given bottom and top)
+ $this->from = min($from, $to);
+ $this->to = max($from, $to);
+ }
+
+ public function columnCount(): int
+ {
+ return $this->to - $this->from + 1;
+ }
+
+ public function shiftDown(int $offset = 1): self
+ {
+ $newFrom = $this->from + $offset;
+ $newFrom = ($newFrom < 1) ? 1 : $newFrom;
+
+ $newTo = $this->to + $offset;
+ $newTo = ($newTo < 1) ? 1 : $newTo;
+
+ return self::fromColumnIndexes($newFrom, $newTo, $this->worksheet);
+ }
+
+ public function shiftUp(int $offset = 1): self
+ {
+ return $this->shiftDown(0 - $offset);
+ }
+
+ public function from(): string
+ {
+ return Coordinate::stringFromColumnIndex($this->from);
+ }
+
+ public function to(): string
+ {
+ return Coordinate::stringFromColumnIndex($this->to);
+ }
+
+ public function fromIndex(): int
+ {
+ return $this->from;
+ }
+
+ public function toIndex(): int
+ {
+ return $this->to;
+ }
+
+ public function toCellRange(): CellRange
+ {
+ return new CellRange(
+ CellAddress::fromColumnAndRow($this->from, 1, $this->worksheet),
+ CellAddress::fromColumnAndRow($this->to, AddressRange::MAX_ROW)
+ );
+ }
+
+ public function __toString(): string
+ {
+ $from = $this->from();
+ $to = $this->to();
+
+ if ($this->worksheet !== null) {
+ $title = str_replace("'", "''", $this->worksheet->getTitle());
+
+ return "'{$title}'!{$from}:{$to}";
+ }
+
+ return "{$from}:{$to}";
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Coordinate.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Coordinate.php
new file mode 100644
index 00000000..313cc3d9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Coordinate.php
@@ -0,0 +1,716 @@
+\$?[A-Z]{1,3})(?\$?\d{1,7})$/i';
+ public const FULL_REFERENCE_REGEX = '/^(?:(?[^!]*)!)?(?(?[$]?[A-Z]{1,3}[$]?\d{1,7})(?:\:(?[$]?[A-Z]{1,3}[$]?\d{1,7}))?)$/i';
+
+ /**
+ * Default range variable constant.
+ *
+ * @var string
+ */
+ const DEFAULT_RANGE = 'A1:A1';
+
+ /**
+ * Convert string coordinate to [0 => int column index, 1 => int row index].
+ *
+ * @param string $cellAddress eg: 'A1'
+ *
+ * @return array{0: string, 1: string} Array containing column and row (indexes 0 and 1)
+ */
+ public static function coordinateFromString(string $cellAddress): array
+ {
+ if (preg_match(self::A1_COORDINATE_REGEX, $cellAddress, $matches)) {
+ return [$matches['col'], $matches['row']];
+ } elseif (self::coordinateIsRange($cellAddress)) {
+ throw new Exception('Cell coordinate string can not be a range of cells');
+ } elseif ($cellAddress == '') {
+ throw new Exception('Cell coordinate can not be zero-length string');
+ }
+
+ throw new Exception('Invalid cell coordinate ' . $cellAddress);
+ }
+
+ /**
+ * Convert string coordinate to [0 => int column index, 1 => int row index, 2 => string column string].
+ *
+ * @param string $coordinates eg: 'A1', '$B$12'
+ *
+ * @return array{0: int, 1: int, 2: string} Array containing column and row index, and column string
+ */
+ public static function indexesFromString(string $coordinates): array
+ {
+ [$column, $row] = self::coordinateFromString($coordinates);
+ $column = ltrim($column, '$');
+
+ return [
+ self::columnIndexFromString($column),
+ (int) ltrim($row, '$'),
+ $column,
+ ];
+ }
+
+ /**
+ * Checks if a Cell Address represents a range of cells.
+ *
+ * @param string $cellAddress eg: 'A1' or 'A1:A2' or 'A1:A2,C1:C2'
+ *
+ * @return bool Whether the coordinate represents a range of cells
+ */
+ public static function coordinateIsRange(string $cellAddress): bool
+ {
+ return str_contains($cellAddress, ':') || str_contains($cellAddress, ',');
+ }
+
+ /**
+ * Make string row, column or cell coordinate absolute.
+ *
+ * @param int|string $cellAddress e.g. 'A' or '1' or 'A1'
+ * Note that this value can be a row or column reference as well as a cell reference
+ *
+ * @return string Absolute coordinate e.g. '$A' or '$1' or '$A$1'
+ */
+ public static function absoluteReference(int|string $cellAddress): string
+ {
+ $cellAddress = (string) $cellAddress;
+ if (self::coordinateIsRange($cellAddress)) {
+ throw new Exception('Cell coordinate string can not be a range of cells');
+ }
+
+ // Split out any worksheet name from the reference
+ [$worksheet, $cellAddress] = Worksheet::extractSheetTitle($cellAddress, true);
+ if ($worksheet > '') {
+ $worksheet .= '!';
+ }
+
+ // Create absolute coordinate
+ $cellAddress = "$cellAddress";
+ if (ctype_digit($cellAddress)) {
+ return $worksheet . '$' . $cellAddress;
+ } elseif (ctype_alpha($cellAddress)) {
+ return $worksheet . '$' . strtoupper($cellAddress);
+ }
+
+ return $worksheet . self::absoluteCoordinate($cellAddress);
+ }
+
+ /**
+ * Make string coordinate absolute.
+ *
+ * @param string $cellAddress e.g. 'A1'
+ *
+ * @return string Absolute coordinate e.g. '$A$1'
+ */
+ public static function absoluteCoordinate(string $cellAddress): string
+ {
+ if (self::coordinateIsRange($cellAddress)) {
+ throw new Exception('Cell coordinate string can not be a range of cells');
+ }
+
+ // Split out any worksheet name from the coordinate
+ [$worksheet, $cellAddress] = Worksheet::extractSheetTitle($cellAddress, true);
+ if ($worksheet > '') {
+ $worksheet .= '!';
+ }
+
+ // Create absolute coordinate
+ [$column, $row] = self::coordinateFromString($cellAddress ?? 'A1');
+ $column = ltrim($column, '$');
+ $row = ltrim($row, '$');
+
+ return $worksheet . '$' . $column . '$' . $row;
+ }
+
+ /**
+ * Split range into coordinate strings.
+ *
+ * @param string $range e.g. 'B4:D9' or 'B4:D9,H2:O11' or 'B4'
+ *
+ * @return array Array containing one or more arrays containing one or two coordinate strings
+ * e.g. ['B4','D9'] or [['B4','D9'], ['H2','O11']]
+ * or ['B4']
+ */
+ public static function splitRange(string $range): array
+ {
+ // Ensure $pRange is a valid range
+ if (empty($range)) {
+ $range = self::DEFAULT_RANGE;
+ }
+
+ $exploded = explode(',', $range);
+ $outArray = [];
+ foreach ($exploded as $value) {
+ $outArray[] = explode(':', $value);
+ }
+
+ return $outArray;
+ }
+
+ /**
+ * Build range from coordinate strings.
+ *
+ * @param array $range Array containing one or more arrays containing one or two coordinate strings
+ *
+ * @return string String representation of $pRange
+ */
+ public static function buildRange(array $range): string
+ {
+ // Verify range
+ if (empty($range) || !is_array($range[0])) {
+ throw new Exception('Range does not contain any information');
+ }
+
+ // Build range
+ $counter = count($range);
+ for ($i = 0; $i < $counter; ++$i) {
+ $range[$i] = implode(':', $range[$i]);
+ }
+
+ return implode(',', $range);
+ }
+
+ /**
+ * Calculate range boundaries.
+ *
+ * @param string $range Cell range, Single Cell, Row/Column Range (e.g. A1:A1, B2, B:C, 2:3)
+ *
+ * @return array Range coordinates [Start Cell, End Cell]
+ * where Start Cell and End Cell are arrays (Column Number, Row Number)
+ */
+ public static function rangeBoundaries(string $range): array
+ {
+ // Ensure $pRange is a valid range
+ if (empty($range)) {
+ $range = self::DEFAULT_RANGE;
+ }
+
+ // Uppercase coordinate
+ $range = strtoupper($range);
+
+ // Extract range
+ if (!str_contains($range, ':')) {
+ $rangeA = $rangeB = $range;
+ } else {
+ [$rangeA, $rangeB] = explode(':', $range);
+ }
+
+ if (is_numeric($rangeA) && is_numeric($rangeB)) {
+ $rangeA = 'A' . $rangeA;
+ $rangeB = AddressRange::MAX_COLUMN . $rangeB;
+ }
+
+ if (ctype_alpha($rangeA) && ctype_alpha($rangeB)) {
+ $rangeA = $rangeA . '1';
+ $rangeB = $rangeB . AddressRange::MAX_ROW;
+ }
+
+ // Calculate range outer borders
+ $rangeStart = self::coordinateFromString($rangeA);
+ $rangeEnd = self::coordinateFromString($rangeB);
+
+ // Translate column into index
+ $rangeStart[0] = self::columnIndexFromString($rangeStart[0]);
+ $rangeEnd[0] = self::columnIndexFromString($rangeEnd[0]);
+
+ return [$rangeStart, $rangeEnd];
+ }
+
+ /**
+ * Calculate range dimension.
+ *
+ * @param string $range Cell range, Single Cell, Row/Column Range (e.g. A1:A1, B2, B:C, 2:3)
+ *
+ * @return array Range dimension (width, height)
+ */
+ public static function rangeDimension(string $range): array
+ {
+ // Calculate range outer borders
+ [$rangeStart, $rangeEnd] = self::rangeBoundaries($range);
+
+ return [($rangeEnd[0] - $rangeStart[0] + 1), ($rangeEnd[1] - $rangeStart[1] + 1)];
+ }
+
+ /**
+ * Calculate range boundaries.
+ *
+ * @param string $range Cell range, Single Cell, Row/Column Range (e.g. A1:A1, B2, B:C, 2:3)
+ *
+ * @return array Range coordinates [Start Cell, End Cell]
+ * where Start Cell and End Cell are arrays [Column ID, Row Number]
+ */
+ public static function getRangeBoundaries(string $range): array
+ {
+ [$rangeA, $rangeB] = self::rangeBoundaries($range);
+
+ return [
+ [self::stringFromColumnIndex($rangeA[0]), $rangeA[1]],
+ [self::stringFromColumnIndex($rangeB[0]), $rangeB[1]],
+ ];
+ }
+
+ /**
+ * Check if cell or range reference is valid and return an array with type of reference (cell or range), worksheet (if it was given)
+ * and the coordinate or the first coordinate and second coordinate if it is a range.
+ *
+ * @param string $reference Coordinate or Range (e.g. A1:A1, B2, B:C, 2:3)
+ *
+ * @return array reference data
+ */
+ private static function validateReferenceAndGetData($reference): array
+ {
+ $data = [];
+ preg_match(self::FULL_REFERENCE_REGEX, $reference, $matches);
+ if (count($matches) === 0) {
+ return ['type' => 'invalid'];
+ }
+
+ if (isset($matches['secondCoordinate'])) {
+ $data['type'] = 'range';
+ $data['firstCoordinate'] = str_replace('$', '', $matches['firstCoordinate']);
+ $data['secondCoordinate'] = str_replace('$', '', $matches['secondCoordinate']);
+ } else {
+ $data['type'] = 'coordinate';
+ $data['coordinate'] = str_replace('$', '', $matches['firstCoordinate']);
+ }
+
+ $worksheet = $matches['worksheet'];
+ if ($worksheet !== '') {
+ if (substr($worksheet, 0, 1) === "'" && substr($worksheet, -1, 1) === "'") {
+ $worksheet = substr($worksheet, 1, -1);
+ }
+ $data['worksheet'] = strtolower($worksheet);
+ }
+ $data['localReference'] = str_replace('$', '', $matches['localReference']);
+
+ return $data;
+ }
+
+ /**
+ * Check if coordinate is inside a range.
+ *
+ * @param string $range Cell range, Single Cell, Row/Column Range (e.g. A1:A1, B2, B:C, 2:3)
+ * @param string $coordinate Cell coordinate (e.g. A1)
+ *
+ * @return bool true if coordinate is inside range
+ */
+ public static function coordinateIsInsideRange(string $range, string $coordinate): bool
+ {
+ $rangeData = self::validateReferenceAndGetData($range);
+ if ($rangeData['type'] === 'invalid') {
+ throw new Exception('First argument needs to be a range');
+ }
+
+ $coordinateData = self::validateReferenceAndGetData($coordinate);
+ if ($coordinateData['type'] === 'invalid') {
+ throw new Exception('Second argument needs to be a single coordinate');
+ }
+
+ if (isset($coordinateData['worksheet']) && !isset($rangeData['worksheet'])) {
+ return false;
+ }
+ if (!isset($coordinateData['worksheet']) && isset($rangeData['worksheet'])) {
+ return false;
+ }
+
+ if (isset($coordinateData['worksheet'], $rangeData['worksheet'])) {
+ if ($coordinateData['worksheet'] !== $rangeData['worksheet']) {
+ return false;
+ }
+ }
+
+ $boundaries = self::rangeBoundaries($rangeData['localReference']);
+ $coordinates = self::indexesFromString($coordinateData['localReference']);
+
+ $columnIsInside = $boundaries[0][0] <= $coordinates[0] && $coordinates[0] <= $boundaries[1][0];
+ if (!$columnIsInside) {
+ return false;
+ }
+ $rowIsInside = $boundaries[0][1] <= $coordinates[1] && $coordinates[1] <= $boundaries[1][1];
+ if (!$rowIsInside) {
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * Column index from string.
+ *
+ * @param ?string $columnAddress eg 'A'
+ *
+ * @return int Column index (A = 1)
+ */
+ public static function columnIndexFromString(?string $columnAddress): int
+ {
+ // Using a lookup cache adds a slight memory overhead, but boosts speed
+ // caching using a static within the method is faster than a class static,
+ // though it's additional memory overhead
+ static $indexCache = [];
+ $columnAddress = $columnAddress ?? '';
+
+ if (isset($indexCache[$columnAddress])) {
+ return $indexCache[$columnAddress];
+ }
+ // It's surprising how costly the strtoupper() and ord() calls actually are, so we use a lookup array
+ // rather than use ord() and make it case insensitive to get rid of the strtoupper() as well.
+ // Because it's a static, there's no significant memory overhead either.
+ static $columnLookup = [
+ 'A' => 1, 'B' => 2, 'C' => 3, 'D' => 4, 'E' => 5, 'F' => 6, 'G' => 7, 'H' => 8, 'I' => 9, 'J' => 10,
+ 'K' => 11, 'L' => 12, 'M' => 13, 'N' => 14, 'O' => 15, 'P' => 16, 'Q' => 17, 'R' => 18, 'S' => 19,
+ 'T' => 20, 'U' => 21, 'V' => 22, 'W' => 23, 'X' => 24, 'Y' => 25, 'Z' => 26,
+ 'a' => 1, 'b' => 2, 'c' => 3, 'd' => 4, 'e' => 5, 'f' => 6, 'g' => 7, 'h' => 8, 'i' => 9, 'j' => 10,
+ 'k' => 11, 'l' => 12, 'm' => 13, 'n' => 14, 'o' => 15, 'p' => 16, 'q' => 17, 'r' => 18, 's' => 19,
+ 't' => 20, 'u' => 21, 'v' => 22, 'w' => 23, 'x' => 24, 'y' => 25, 'z' => 26,
+ ];
+
+ // We also use the language construct isset() rather than the more costly strlen() function to match the
+ // length of $columnAddress for improved performance
+ if (isset($columnAddress[0])) {
+ if (!isset($columnAddress[1])) {
+ $indexCache[$columnAddress] = $columnLookup[$columnAddress];
+
+ return $indexCache[$columnAddress];
+ } elseif (!isset($columnAddress[2])) {
+ $indexCache[$columnAddress] = $columnLookup[$columnAddress[0]] * 26
+ + $columnLookup[$columnAddress[1]];
+
+ return $indexCache[$columnAddress];
+ } elseif (!isset($columnAddress[3])) {
+ $indexCache[$columnAddress] = $columnLookup[$columnAddress[0]] * 676
+ + $columnLookup[$columnAddress[1]] * 26
+ + $columnLookup[$columnAddress[2]];
+
+ return $indexCache[$columnAddress];
+ }
+ }
+
+ throw new Exception(
+ 'Column string index can not be ' . ((isset($columnAddress[0])) ? 'longer than 3 characters' : 'empty')
+ );
+ }
+
+ /**
+ * String from column index.
+ *
+ * @param int|numeric-string $columnIndex Column index (A = 1)
+ */
+ public static function stringFromColumnIndex(int|string $columnIndex): string
+ {
+ static $indexCache = [];
+ static $lookupCache = ' ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+
+ if (!isset($indexCache[$columnIndex])) {
+ $indexValue = $columnIndex;
+ $base26 = '';
+ do {
+ $characterValue = ($indexValue % 26) ?: 26;
+ $indexValue = ($indexValue - $characterValue) / 26;
+ $base26 = $lookupCache[$characterValue] . $base26;
+ } while ($indexValue > 0);
+ $indexCache[$columnIndex] = $base26;
+ }
+
+ return $indexCache[$columnIndex];
+ }
+
+ /**
+ * Extract all cell references in range, which may be comprised of multiple cell ranges.
+ *
+ * @param string $cellRange Range: e.g. 'A1' or 'A1:C10' or 'A1:E10,A20:E25' or 'A1:E5 C3:G7' or 'A1:C1,A3:C3 B1:C3'
+ *
+ * @return array Array containing single cell references
+ */
+ public static function extractAllCellReferencesInRange(string $cellRange): array
+ {
+ if (substr_count($cellRange, '!') > 1) {
+ throw new Exception('3-D Range References are not supported');
+ }
+
+ [$worksheet, $cellRange] = Worksheet::extractSheetTitle($cellRange, true);
+ $quoted = '';
+ if ($worksheet) {
+ $quoted = Worksheet::nameRequiresQuotes($worksheet) ? "'" : '';
+ if (str_starts_with($worksheet, "'") && str_ends_with($worksheet, "'")) {
+ $worksheet = substr($worksheet, 1, -1);
+ }
+ $worksheet = str_replace("'", "''", $worksheet);
+ }
+ [$ranges, $operators] = self::getCellBlocksFromRangeString($cellRange ?? 'A1');
+
+ $cells = [];
+ foreach ($ranges as $range) {
+ $cells[] = self::getReferencesForCellBlock($range);
+ }
+
+ $cells = self::processRangeSetOperators($operators, $cells);
+
+ if (empty($cells)) {
+ return [];
+ }
+
+ $cellList = array_merge(...$cells);
+
+ return array_map(
+ fn ($cellAddress) => ($worksheet !== '') ? "{$quoted}{$worksheet}{$quoted}!{$cellAddress}" : $cellAddress,
+ self::sortCellReferenceArray($cellList)
+ );
+ }
+
+ private static function processRangeSetOperators(array $operators, array $cells): array
+ {
+ $operatorCount = count($operators);
+ for ($offset = 0; $offset < $operatorCount; ++$offset) {
+ $operator = $operators[$offset];
+ if ($operator !== ' ') {
+ continue;
+ }
+
+ $cells[$offset] = array_intersect($cells[$offset], $cells[$offset + 1]);
+ unset($operators[$offset], $cells[$offset + 1]);
+ $operators = array_values($operators);
+ $cells = array_values($cells);
+ --$offset;
+ --$operatorCount;
+ }
+
+ return $cells;
+ }
+
+ private static function sortCellReferenceArray(array $cellList): array
+ {
+ // Sort the result by column and row
+ $sortKeys = [];
+ foreach ($cellList as $coordinate) {
+ $column = '';
+ $row = 0;
+ sscanf($coordinate, '%[A-Z]%d', $column, $row);
+ $key = (--$row * 16384) + self::columnIndexFromString((string) $column);
+ $sortKeys[$key] = $coordinate;
+ }
+ ksort($sortKeys);
+
+ return array_values($sortKeys);
+ }
+
+ /**
+ * Get all cell references applying union and intersection.
+ *
+ * @param string $cellBlock A cell range e.g. A1:B5,D1:E5 B2:C4
+ *
+ * @return string A string without intersection operator.
+ * If there was no intersection to begin with, return original argument.
+ * Otherwise, return cells and/or cell ranges in that range separated by comma.
+ */
+ public static function resolveUnionAndIntersection(string $cellBlock, string $implodeCharacter = ','): string
+ {
+ $cellBlock = preg_replace('/ +/', ' ', trim($cellBlock)) ?? $cellBlock;
+ $cellBlock = preg_replace('/ ,/', ',', $cellBlock) ?? $cellBlock;
+ $cellBlock = preg_replace('/, /', ',', $cellBlock) ?? $cellBlock;
+ $array1 = [];
+ $blocks = explode(',', $cellBlock);
+ foreach ($blocks as $block) {
+ $block0 = explode(' ', $block);
+ if (count($block0) === 1) {
+ $array1 = array_merge($array1, $block0);
+ } else {
+ $blockIdx = -1;
+ $array2 = [];
+ foreach ($block0 as $block00) {
+ ++$blockIdx;
+ if ($blockIdx === 0) {
+ $array2 = self::getReferencesForCellBlock($block00);
+ } else {
+ $array2 = array_intersect($array2, self::getReferencesForCellBlock($block00));
+ }
+ }
+ $array1 = array_merge($array1, $array2);
+ }
+ }
+
+ return implode($implodeCharacter, $array1);
+ }
+
+ /**
+ * Get all cell references for an individual cell block.
+ *
+ * @param string $cellBlock A cell range e.g. A4:B5
+ *
+ * @return array All individual cells in that range
+ */
+ private static function getReferencesForCellBlock(string $cellBlock): array
+ {
+ $returnValue = [];
+
+ // Single cell?
+ if (!self::coordinateIsRange($cellBlock)) {
+ return (array) $cellBlock;
+ }
+
+ // Range...
+ $ranges = self::splitRange($cellBlock);
+ foreach ($ranges as $range) {
+ // Single cell?
+ if (!isset($range[1])) {
+ $returnValue[] = $range[0];
+
+ continue;
+ }
+
+ // Range...
+ [$rangeStart, $rangeEnd] = $range;
+ [$startColumn, $startRow] = self::coordinateFromString($rangeStart);
+ [$endColumn, $endRow] = self::coordinateFromString($rangeEnd);
+ $startColumnIndex = self::columnIndexFromString($startColumn);
+ $endColumnIndex = self::columnIndexFromString($endColumn);
+ ++$endColumnIndex;
+
+ // Current data
+ $currentColumnIndex = $startColumnIndex;
+ $currentRow = $startRow;
+
+ self::validateRange($cellBlock, $startColumnIndex, $endColumnIndex, (int) $currentRow, (int) $endRow);
+
+ // Loop cells
+ while ($currentColumnIndex < $endColumnIndex) {
+ while ($currentRow <= $endRow) {
+ $returnValue[] = self::stringFromColumnIndex($currentColumnIndex) . $currentRow;
+ ++$currentRow;
+ }
+ ++$currentColumnIndex;
+ $currentRow = $startRow;
+ }
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * Convert an associative array of single cell coordinates to values to an associative array
+ * of cell ranges to values. Only adjacent cell coordinates with the same
+ * value will be merged. If the value is an object, it must implement the method getHashCode().
+ *
+ * For example, this function converts:
+ *
+ * [ 'A1' => 'x', 'A2' => 'x', 'A3' => 'x', 'A4' => 'y' ]
+ *
+ * to:
+ *
+ * [ 'A1:A3' => 'x', 'A4' => 'y' ]
+ *
+ * @param array $coordinateCollection associative array mapping coordinates to values
+ *
+ * @return array associative array mapping coordinate ranges to valuea
+ */
+ public static function mergeRangesInCollection(array $coordinateCollection): array
+ {
+ $hashedValues = [];
+ $mergedCoordCollection = [];
+
+ foreach ($coordinateCollection as $coord => $value) {
+ if (self::coordinateIsRange($coord)) {
+ $mergedCoordCollection[$coord] = $value;
+
+ continue;
+ }
+
+ [$column, $row] = self::coordinateFromString($coord);
+ $row = (int) (ltrim($row, '$'));
+ $hashCode = $column . '-' . ((is_object($value) && method_exists($value, 'getHashCode')) ? $value->getHashCode() : $value);
+
+ if (!isset($hashedValues[$hashCode])) {
+ $hashedValues[$hashCode] = (object) [
+ 'value' => $value,
+ 'col' => $column,
+ 'rows' => [$row],
+ ];
+ } else {
+ $hashedValues[$hashCode]->rows[] = $row;
+ }
+ }
+
+ ksort($hashedValues);
+
+ foreach ($hashedValues as $hashedValue) {
+ sort($hashedValue->rows);
+ $rowStart = null;
+ $rowEnd = null;
+ $ranges = [];
+
+ foreach ($hashedValue->rows as $row) {
+ if ($rowStart === null) {
+ $rowStart = $row;
+ $rowEnd = $row;
+ } elseif ($rowEnd === $row - 1) {
+ $rowEnd = $row;
+ } else {
+ if ($rowStart == $rowEnd) {
+ $ranges[] = $hashedValue->col . $rowStart;
+ } else {
+ $ranges[] = $hashedValue->col . $rowStart . ':' . $hashedValue->col . $rowEnd;
+ }
+
+ $rowStart = $row;
+ $rowEnd = $row;
+ }
+ }
+
+ if ($rowStart !== null) {
+ if ($rowStart == $rowEnd) {
+ $ranges[] = $hashedValue->col . $rowStart;
+ } else {
+ $ranges[] = $hashedValue->col . $rowStart . ':' . $hashedValue->col . $rowEnd;
+ }
+ }
+
+ foreach ($ranges as $range) {
+ $mergedCoordCollection[$range] = $hashedValue->value;
+ }
+ }
+
+ return $mergedCoordCollection;
+ }
+
+ /**
+ * Get the individual cell blocks from a range string, removing any $ characters.
+ * then splitting by operators and returning an array with ranges and operators.
+ *
+ * @return array[]
+ */
+ private static function getCellBlocksFromRangeString(string $rangeString): array
+ {
+ $rangeString = str_replace('$', '', strtoupper($rangeString));
+
+ // split range sets on intersection (space) or union (,) operators
+ $tokens = preg_split('/([ ,])/', $rangeString, -1, PREG_SPLIT_DELIM_CAPTURE) ?: [];
+ $split = array_chunk($tokens, 2);
+ $ranges = array_column($split, 0);
+ $operators = array_column($split, 1);
+
+ return [$ranges, $operators];
+ }
+
+ /**
+ * Check that the given range is valid, i.e. that the start column and row are not greater than the end column and
+ * row.
+ *
+ * @param string $cellBlock The original range, for displaying a meaningful error message
+ */
+ private static function validateRange(string $cellBlock, int $startColumnIndex, int $endColumnIndex, int $currentRow, int $endRow): void
+ {
+ if ($startColumnIndex >= $endColumnIndex || $currentRow > $endRow) {
+ throw new Exception('Invalid range: "' . $cellBlock . '"');
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataType.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataType.php
new file mode 100644
index 00000000..a213725c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataType.php
@@ -0,0 +1,90 @@
+
+ */
+ private static array $errorCodes = [
+ '#NULL!' => 0,
+ '#DIV/0!' => 1,
+ '#VALUE!' => 2,
+ '#REF!' => 3,
+ '#NAME?' => 4,
+ '#NUM!' => 5,
+ '#N/A' => 6,
+ '#CALC!' => 7,
+ ];
+
+ public const MAX_STRING_LENGTH = 32767;
+
+ /**
+ * Get list of error codes.
+ *
+ * @return array
+ */
+ public static function getErrorCodes(): array
+ {
+ return self::$errorCodes;
+ }
+
+ /**
+ * Check a string that it satisfies Excel requirements.
+ *
+ * @param null|RichText|string $textValue Value to sanitize to an Excel string
+ *
+ * @return RichText|string Sanitized value
+ */
+ public static function checkString(null|RichText|string $textValue): RichText|string
+ {
+ if ($textValue instanceof RichText) {
+ // TODO: Sanitize Rich-Text string (max. character count is 32,767)
+ return $textValue;
+ }
+
+ // string must never be longer than 32,767 characters, truncate if necessary
+ $textValue = StringHelper::substring((string) $textValue, 0, self::MAX_STRING_LENGTH);
+
+ // we require that newline is represented as "\n" in core, not as "\r\n" or "\r"
+ $textValue = str_replace(["\r\n", "\r"], "\n", $textValue);
+
+ return $textValue;
+ }
+
+ /**
+ * Check a value that it is a valid error code.
+ *
+ * @param mixed $value Value to sanitize to an Excel error code
+ *
+ * @return string Sanitized value
+ */
+ public static function checkErrorCode(mixed $value): string
+ {
+ $value = (is_scalar($value) || $value instanceof Stringable) ? ((string) $value) : '#NULL!';
+
+ if (!isset(self::$errorCodes[$value])) {
+ $value = '#NULL!';
+ }
+
+ return $value;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataValidation.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataValidation.php
new file mode 100644
index 00000000..9a5f44e3
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataValidation.php
@@ -0,0 +1,421 @@
+formula1;
+ }
+
+ /**
+ * Set Formula 1.
+ *
+ * @return $this
+ */
+ public function setFormula1(string $formula): static
+ {
+ $this->formula1 = $formula;
+
+ return $this;
+ }
+
+ /**
+ * Get Formula 2.
+ */
+ public function getFormula2(): string
+ {
+ return $this->formula2;
+ }
+
+ /**
+ * Set Formula 2.
+ *
+ * @return $this
+ */
+ public function setFormula2(string $formula): static
+ {
+ $this->formula2 = $formula;
+
+ return $this;
+ }
+
+ /**
+ * Get Type.
+ */
+ public function getType(): string
+ {
+ return $this->type;
+ }
+
+ /**
+ * Set Type.
+ *
+ * @return $this
+ */
+ public function setType(string $type): static
+ {
+ $this->type = $type;
+
+ return $this;
+ }
+
+ /**
+ * Get Error style.
+ */
+ public function getErrorStyle(): string
+ {
+ return $this->errorStyle;
+ }
+
+ /**
+ * Set Error style.
+ *
+ * @param string $errorStyle see self::STYLE_*
+ *
+ * @return $this
+ */
+ public function setErrorStyle(string $errorStyle): static
+ {
+ $this->errorStyle = $errorStyle;
+
+ return $this;
+ }
+
+ /**
+ * Get Operator.
+ */
+ public function getOperator(): string
+ {
+ return $this->operator;
+ }
+
+ /**
+ * Set Operator.
+ *
+ * @return $this
+ */
+ public function setOperator(string $operator): static
+ {
+ $this->operator = ($operator === '') ? self::DEFAULT_OPERATOR : $operator;
+
+ return $this;
+ }
+
+ /**
+ * Get Allow Blank.
+ */
+ public function getAllowBlank(): bool
+ {
+ return $this->allowBlank;
+ }
+
+ /**
+ * Set Allow Blank.
+ *
+ * @return $this
+ */
+ public function setAllowBlank(bool $allowBlank): static
+ {
+ $this->allowBlank = $allowBlank;
+
+ return $this;
+ }
+
+ /**
+ * Get Show DropDown.
+ */
+ public function getShowDropDown(): bool
+ {
+ return $this->showDropDown;
+ }
+
+ /**
+ * Set Show DropDown.
+ *
+ * @return $this
+ */
+ public function setShowDropDown(bool $showDropDown): static
+ {
+ $this->showDropDown = $showDropDown;
+
+ return $this;
+ }
+
+ /**
+ * Get Show InputMessage.
+ */
+ public function getShowInputMessage(): bool
+ {
+ return $this->showInputMessage;
+ }
+
+ /**
+ * Set Show InputMessage.
+ *
+ * @return $this
+ */
+ public function setShowInputMessage(bool $showInputMessage): static
+ {
+ $this->showInputMessage = $showInputMessage;
+
+ return $this;
+ }
+
+ /**
+ * Get Show ErrorMessage.
+ */
+ public function getShowErrorMessage(): bool
+ {
+ return $this->showErrorMessage;
+ }
+
+ /**
+ * Set Show ErrorMessage.
+ *
+ * @return $this
+ */
+ public function setShowErrorMessage(bool $showErrorMessage): static
+ {
+ $this->showErrorMessage = $showErrorMessage;
+
+ return $this;
+ }
+
+ /**
+ * Get Error title.
+ */
+ public function getErrorTitle(): string
+ {
+ return $this->errorTitle;
+ }
+
+ /**
+ * Set Error title.
+ *
+ * @return $this
+ */
+ public function setErrorTitle(string $errorTitle): static
+ {
+ $this->errorTitle = $errorTitle;
+
+ return $this;
+ }
+
+ /**
+ * Get Error.
+ */
+ public function getError(): string
+ {
+ return $this->error;
+ }
+
+ /**
+ * Set Error.
+ *
+ * @return $this
+ */
+ public function setError(string $error): static
+ {
+ $this->error = $error;
+
+ return $this;
+ }
+
+ /**
+ * Get Prompt title.
+ */
+ public function getPromptTitle(): string
+ {
+ return $this->promptTitle;
+ }
+
+ /**
+ * Set Prompt title.
+ *
+ * @return $this
+ */
+ public function setPromptTitle(string $promptTitle): static
+ {
+ $this->promptTitle = $promptTitle;
+
+ return $this;
+ }
+
+ /**
+ * Get Prompt.
+ */
+ public function getPrompt(): string
+ {
+ return $this->prompt;
+ }
+
+ /**
+ * Set Prompt.
+ *
+ * @return $this
+ */
+ public function setPrompt(string $prompt): static
+ {
+ $this->prompt = $prompt;
+
+ return $this;
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ return md5(
+ $this->formula1
+ . $this->formula2
+ . $this->type
+ . $this->errorStyle
+ . $this->operator
+ . ($this->allowBlank ? 't' : 'f')
+ . ($this->showDropDown ? 't' : 'f')
+ . ($this->showInputMessage ? 't' : 'f')
+ . ($this->showErrorMessage ? 't' : 'f')
+ . $this->errorTitle
+ . $this->error
+ . $this->promptTitle
+ . $this->prompt
+ . $this->sqref
+ . __CLASS__
+ );
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $vars = get_object_vars($this);
+ foreach ($vars as $key => $value) {
+ if (is_object($value)) {
+ $this->$key = clone $value;
+ } else {
+ $this->$key = $value;
+ }
+ }
+ }
+
+ private ?string $sqref = null;
+
+ public function getSqref(): ?string
+ {
+ return $this->sqref;
+ }
+
+ public function setSqref(?string $str): self
+ {
+ $this->sqref = $str;
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataValidator.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataValidator.php
new file mode 100644
index 00000000..63ef8999
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DataValidator.php
@@ -0,0 +1,117 @@
+hasDataValidation() || $cell->getDataValidation()->getType() === DataValidation::TYPE_NONE) {
+ return true;
+ }
+
+ $cellValue = $cell->getValue();
+ $dataValidation = $cell->getDataValidation();
+
+ if (!$dataValidation->getAllowBlank() && ($cellValue === null || $cellValue === '')) {
+ return false;
+ }
+
+ $returnValue = false;
+ $type = $dataValidation->getType();
+ if ($type === DataValidation::TYPE_LIST) {
+ $returnValue = $this->isValueInList($cell);
+ } elseif ($type === DataValidation::TYPE_WHOLE) {
+ if (!is_numeric($cellValue) || fmod((float) $cellValue, 1) != 0) {
+ $returnValue = false;
+ } else {
+ $returnValue = $this->numericOperator($dataValidation, (int) $cellValue);
+ }
+ } elseif ($type === DataValidation::TYPE_DECIMAL || $type === DataValidation::TYPE_DATE || $type === DataValidation::TYPE_TIME) {
+ if (!is_numeric($cellValue)) {
+ $returnValue = false;
+ } else {
+ $returnValue = $this->numericOperator($dataValidation, (float) $cellValue);
+ }
+ } elseif ($type === DataValidation::TYPE_TEXTLENGTH) {
+ $returnValue = $this->numericOperator($dataValidation, mb_strlen($cell->getValueString()));
+ }
+
+ return $returnValue;
+ }
+
+ private function numericOperator(DataValidation $dataValidation, int|float $cellValue): bool
+ {
+ $operator = $dataValidation->getOperator();
+ $formula1 = $dataValidation->getFormula1();
+ $formula2 = $dataValidation->getFormula2();
+ $returnValue = false;
+ if ($operator === DataValidation::OPERATOR_BETWEEN) {
+ $returnValue = $cellValue >= $formula1 && $cellValue <= $formula2;
+ } elseif ($operator === DataValidation::OPERATOR_NOTBETWEEN) {
+ $returnValue = $cellValue < $formula1 || $cellValue > $formula2;
+ } elseif ($operator === DataValidation::OPERATOR_EQUAL) {
+ $returnValue = $cellValue == $formula1;
+ } elseif ($operator === DataValidation::OPERATOR_NOTEQUAL) {
+ $returnValue = $cellValue != $formula1;
+ } elseif ($operator === DataValidation::OPERATOR_LESSTHAN) {
+ $returnValue = $cellValue < $formula1;
+ } elseif ($operator === DataValidation::OPERATOR_LESSTHANOREQUAL) {
+ $returnValue = $cellValue <= $formula1;
+ } elseif ($operator === DataValidation::OPERATOR_GREATERTHAN) {
+ $returnValue = $cellValue > $formula1;
+ } elseif ($operator === DataValidation::OPERATOR_GREATERTHANOREQUAL) {
+ $returnValue = $cellValue >= $formula1;
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * Does this cell contain valid value, based on list?
+ *
+ * @param Cell $cell Cell to check the value
+ */
+ private function isValueInList(Cell $cell): bool
+ {
+ $cellValueString = $cell->getValueString();
+ $dataValidation = $cell->getDataValidation();
+
+ $formula1 = $dataValidation->getFormula1();
+ if (!empty($formula1)) {
+ // inline values list
+ if ($formula1[0] === '"') {
+ return in_array(strtolower($cellValueString), explode(',', strtolower(trim($formula1, '"'))), true);
+ } elseif (strpos($formula1, ':') > 0) {
+ // values list cells
+ $matchFormula = '=MATCH(' . $cell->getCoordinate() . ', ' . $formula1 . ', 0)';
+ $calculation = Calculation::getInstance($cell->getWorksheet()->getParent());
+
+ try {
+ $result = $calculation->calculateFormula($matchFormula, $cell->getCoordinate(), $cell);
+ while (is_array($result)) {
+ $result = array_pop($result);
+ }
+
+ return $result !== ExcelError::NA();
+ } catch (Exception) {
+ return false;
+ }
+ }
+ }
+
+ return true;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DefaultValueBinder.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DefaultValueBinder.php
new file mode 100644
index 00000000..f36934ed
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/DefaultValueBinder.php
@@ -0,0 +1,111 @@
+format('Y-m-d H:i:s');
+ } elseif ($value instanceof Stringable) {
+ $value = (string) $value;
+ } else {
+ throw new SpreadsheetException('Unable to bind unstringable ' . gettype($value));
+ }
+
+ // Set value explicit
+ $cell->setValueExplicit($value, static::dataTypeForValue($value));
+
+ // Done!
+ return true;
+ }
+
+ /**
+ * DataType for value.
+ */
+ public static function dataTypeForValue(mixed $value): string
+ {
+ // Match the value against a few data types
+ if ($value === null) {
+ return DataType::TYPE_NULL;
+ }
+ if (is_float($value) || is_int($value)) {
+ return DataType::TYPE_NUMERIC;
+ }
+ if (is_bool($value)) {
+ return DataType::TYPE_BOOL;
+ }
+ if ($value === '') {
+ return DataType::TYPE_STRING;
+ }
+ if ($value instanceof RichText) {
+ return DataType::TYPE_INLINE;
+ }
+ if ($value instanceof Stringable) {
+ $value = (string) $value;
+ }
+ if (!is_string($value)) {
+ $gettype = is_object($value) ? get_class($value) : gettype($value);
+
+ throw new SpreadsheetException("unusable type $gettype");
+ }
+ if (strlen($value) > 1 && $value[0] === '=') {
+ $calculation = new Calculation();
+ $calculation->disableBranchPruning();
+
+ try {
+ if (empty($calculation->parseFormula($value))) {
+ return DataType::TYPE_STRING;
+ }
+ } catch (CalculationException $e) {
+ $message = $e->getMessage();
+ if (
+ $message === 'Formula Error: An unexpected error occurred'
+ || str_contains($message, 'has no operands')
+ ) {
+ return DataType::TYPE_STRING;
+ }
+ }
+
+ return DataType::TYPE_FORMULA;
+ }
+ if (preg_match('/^[\+\-]?(\d+\\.?\d*|\d*\\.?\d+)([Ee][\-\+]?[0-2]?\d{1,3})?$/', $value)) {
+ $tValue = ltrim($value, '+-');
+ if (strlen($tValue) > 1 && $tValue[0] === '0' && $tValue[1] !== '.') {
+ return DataType::TYPE_STRING;
+ } elseif ((!str_contains($value, '.')) && ($value > PHP_INT_MAX)) {
+ return DataType::TYPE_STRING;
+ } elseif (!is_numeric($value)) {
+ return DataType::TYPE_STRING;
+ }
+
+ return DataType::TYPE_NUMERIC;
+ }
+ $errorCodes = DataType::getErrorCodes();
+ if (isset($errorCodes[$value])) {
+ return DataType::TYPE_ERROR;
+ }
+
+ return DataType::TYPE_STRING;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Hyperlink.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Hyperlink.php
new file mode 100644
index 00000000..3117a7d8
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/Hyperlink.php
@@ -0,0 +1,96 @@
+url = $url;
+ $this->tooltip = $tooltip;
+ }
+
+ /**
+ * Get URL.
+ */
+ public function getUrl(): string
+ {
+ return $this->url;
+ }
+
+ /**
+ * Set URL.
+ *
+ * @return $this
+ */
+ public function setUrl(string $url): static
+ {
+ $this->url = $url;
+
+ return $this;
+ }
+
+ /**
+ * Get tooltip.
+ */
+ public function getTooltip(): string
+ {
+ return $this->tooltip;
+ }
+
+ /**
+ * Set tooltip.
+ *
+ * @return $this
+ */
+ public function setTooltip(string $tooltip): static
+ {
+ $this->tooltip = $tooltip;
+
+ return $this;
+ }
+
+ /**
+ * Is this hyperlink internal? (to another worksheet).
+ */
+ public function isInternal(): bool
+ {
+ return str_contains($this->url, 'sheet://');
+ }
+
+ public function getTypeHyperlink(): string
+ {
+ return $this->isInternal() ? '' : 'External';
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ return md5(
+ $this->url
+ . $this->tooltip
+ . __CLASS__
+ );
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/IValueBinder.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/IValueBinder.php
new file mode 100644
index 00000000..b2f7e91a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/IValueBinder.php
@@ -0,0 +1,14 @@
+numberStoredAsText = $value;
+
+ return $this;
+ }
+
+ public function getNumberStoredAsText(): bool
+ {
+ return $this->numberStoredAsText;
+ }
+
+ public function setFormula(bool $value): self
+ {
+ $this->formula = $value;
+
+ return $this;
+ }
+
+ public function getFormula(): bool
+ {
+ return $this->formula;
+ }
+
+ public function setTwoDigitTextYear(bool $value): self
+ {
+ $this->twoDigitTextYear = $value;
+
+ return $this;
+ }
+
+ public function getTwoDigitTextYear(): bool
+ {
+ return $this->twoDigitTextYear;
+ }
+
+ public function setEvalError(bool $value): self
+ {
+ $this->evalError = $value;
+
+ return $this;
+ }
+
+ public function getEvalError(): bool
+ {
+ return $this->evalError;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/RowRange.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/RowRange.php
new file mode 100644
index 00000000..4ed232a9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/RowRange.php
@@ -0,0 +1,93 @@
+
+ */
+class RowRange implements AddressRange, Stringable
+{
+ protected ?Worksheet $worksheet;
+
+ protected int $from;
+
+ protected int $to;
+
+ public function __construct(int $from, ?int $to = null, ?Worksheet $worksheet = null)
+ {
+ $this->validateFromTo($from, $to ?? $from);
+ $this->worksheet = $worksheet;
+ }
+
+ public function __destruct()
+ {
+ $this->worksheet = null;
+ }
+
+ public static function fromArray(array $array, ?Worksheet $worksheet = null): self
+ {
+ [$from, $to] = $array;
+
+ return new self($from, $to, $worksheet);
+ }
+
+ private function validateFromTo(int $from, int $to): void
+ {
+ // Identify actual top and bottom values (in case we've been given bottom and top)
+ $this->from = min($from, $to);
+ $this->to = max($from, $to);
+ }
+
+ public function from(): int
+ {
+ return $this->from;
+ }
+
+ public function to(): int
+ {
+ return $this->to;
+ }
+
+ public function rowCount(): int
+ {
+ return $this->to - $this->from + 1;
+ }
+
+ public function shiftRight(int $offset = 1): self
+ {
+ $newFrom = $this->from + $offset;
+ $newFrom = ($newFrom < 1) ? 1 : $newFrom;
+
+ $newTo = $this->to + $offset;
+ $newTo = ($newTo < 1) ? 1 : $newTo;
+
+ return new self($newFrom, $newTo, $this->worksheet);
+ }
+
+ public function shiftLeft(int $offset = 1): self
+ {
+ return $this->shiftRight(0 - $offset);
+ }
+
+ public function toCellRange(): CellRange
+ {
+ return new CellRange(
+ CellAddress::fromColumnAndRow(Coordinate::columnIndexFromString('A'), $this->from, $this->worksheet),
+ CellAddress::fromColumnAndRow(Coordinate::columnIndexFromString(AddressRange::MAX_COLUMN), $this->to)
+ );
+ }
+
+ public function __toString(): string
+ {
+ if ($this->worksheet !== null) {
+ $title = str_replace("'", "''", $this->worksheet->getTitle());
+
+ return "'{$title}'!{$this->from}:{$this->to}";
+ }
+
+ return "{$this->from}:{$this->to}";
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/StringValueBinder.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/StringValueBinder.php
new file mode 100644
index 00000000..d86cdabd
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Cell/StringValueBinder.php
@@ -0,0 +1,115 @@
+convertNull = $suppressConversion;
+
+ return $this;
+ }
+
+ public function setBooleanConversion(bool $suppressConversion = false): self
+ {
+ $this->convertBoolean = $suppressConversion;
+
+ return $this;
+ }
+
+ public function getBooleanConversion(): bool
+ {
+ return $this->convertBoolean;
+ }
+
+ public function setNumericConversion(bool $suppressConversion = false): self
+ {
+ $this->convertNumeric = $suppressConversion;
+
+ return $this;
+ }
+
+ public function setFormulaConversion(bool $suppressConversion = false): self
+ {
+ $this->convertFormula = $suppressConversion;
+
+ return $this;
+ }
+
+ public function setConversionForAllValueTypes(bool $suppressConversion = false): self
+ {
+ $this->convertNull = $suppressConversion;
+ $this->convertBoolean = $suppressConversion;
+ $this->convertNumeric = $suppressConversion;
+ $this->convertFormula = $suppressConversion;
+
+ return $this;
+ }
+
+ /**
+ * Bind value to a cell.
+ *
+ * @param Cell $cell Cell to bind value to
+ * @param mixed $value Value to bind in cell
+ */
+ public function bindValue(Cell $cell, mixed $value): bool
+ {
+ if (is_object($value)) {
+ return $this->bindObjectValue($cell, $value);
+ }
+ if ($value !== null && !is_scalar($value)) {
+ throw new SpreadsheetException('Unable to bind unstringable ' . gettype($value));
+ }
+
+ // sanitize UTF-8 strings
+ if (is_string($value)) {
+ $value = StringHelper::sanitizeUTF8($value);
+ }
+
+ if ($value === null && $this->convertNull === false) {
+ $cell->setValueExplicit($value, DataType::TYPE_NULL);
+ } elseif (is_bool($value) && $this->convertBoolean === false) {
+ $cell->setValueExplicit($value, DataType::TYPE_BOOL);
+ } elseif ((is_int($value) || is_float($value)) && $this->convertNumeric === false) {
+ $cell->setValueExplicit($value, DataType::TYPE_NUMERIC);
+ } elseif (is_string($value) && strlen($value) > 1 && $value[0] === '=' && $this->convertFormula === false && parent::dataTypeForValue($value) === DataType::TYPE_FORMULA) {
+ $cell->setValueExplicit($value, DataType::TYPE_FORMULA);
+ } else {
+ $cell->setValueExplicit((string) $value, DataType::TYPE_STRING);
+ }
+
+ return true;
+ }
+
+ protected function bindObjectValue(Cell $cell, object $value): bool
+ {
+ // Handle any objects that might be injected
+ if ($value instanceof DateTimeInterface) {
+ $value = $value->format('Y-m-d H:i:s');
+ $cell->setValueExplicit($value, DataType::TYPE_STRING);
+ } elseif ($value instanceof RichText) {
+ $cell->setValueExplicit($value, DataType::TYPE_INLINE);
+ } elseif ($value instanceof Stringable) {
+ $cell->setValueExplicit((string) $value, DataType::TYPE_STRING);
+ } else {
+ throw new SpreadsheetException('Unable to bind unstringable object of type ' . get_class($value));
+ }
+
+ return true;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/CellReferenceHelper.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/CellReferenceHelper.php
new file mode 100644
index 00000000..b2f18f6d
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/CellReferenceHelper.php
@@ -0,0 +1,119 @@
+beforeCellAddress = str_replace('$', '', $beforeCellAddress);
+ $this->numberOfColumns = $numberOfColumns;
+ $this->numberOfRows = $numberOfRows;
+
+ // Get coordinate of $beforeCellAddress
+ [$beforeColumn, $beforeRow] = Coordinate::coordinateFromString($beforeCellAddress);
+ $this->beforeColumn = Coordinate::columnIndexFromString($beforeColumn);
+ $this->beforeRow = (int) $beforeRow;
+ }
+
+ public function beforeCellAddress(): string
+ {
+ return $this->beforeCellAddress;
+ }
+
+ public function refreshRequired(string $beforeCellAddress, int $numberOfColumns, int $numberOfRows): bool
+ {
+ return $this->beforeCellAddress !== $beforeCellAddress
+ || $this->numberOfColumns !== $numberOfColumns
+ || $this->numberOfRows !== $numberOfRows;
+ }
+
+ public function updateCellReference(string $cellReference = 'A1', bool $includeAbsoluteReferences = false, bool $onlyAbsoluteReferences = false): string
+ {
+ if (Coordinate::coordinateIsRange($cellReference)) {
+ throw new Exception('Only single cell references may be passed to this method.');
+ }
+
+ // Get coordinate of $cellReference
+ [$newColumn, $newRow] = Coordinate::coordinateFromString($cellReference);
+ $newColumnIndex = Coordinate::columnIndexFromString(str_replace('$', '', $newColumn));
+ $newRowIndex = (int) str_replace('$', '', $newRow);
+
+ $absoluteColumn = $newColumn[0] === '$' ? '$' : '';
+ $absoluteRow = $newRow[0] === '$' ? '$' : '';
+ // Verify which parts should be updated
+ if ($onlyAbsoluteReferences === true) {
+ $updateColumn = (($absoluteColumn === '$') && $newColumnIndex >= $this->beforeColumn);
+ $updateRow = (($absoluteRow === '$') && $newRowIndex >= $this->beforeRow);
+ } elseif ($includeAbsoluteReferences === false) {
+ $updateColumn = (($absoluteColumn !== '$') && $newColumnIndex >= $this->beforeColumn);
+ $updateRow = (($absoluteRow !== '$') && $newRowIndex >= $this->beforeRow);
+ } else {
+ $updateColumn = ($newColumnIndex >= $this->beforeColumn);
+ $updateRow = ($newRowIndex >= $this->beforeRow);
+ }
+
+ // Create new column reference
+ if ($updateColumn) {
+ $newColumn = $this->updateColumnReference($newColumnIndex, $absoluteColumn);
+ }
+
+ // Create new row reference
+ if ($updateRow) {
+ $newRow = $this->updateRowReference($newRowIndex, $absoluteRow);
+ }
+
+ // Return new reference
+ return "{$newColumn}{$newRow}";
+ }
+
+ public function cellAddressInDeleteRange(string $cellAddress): bool
+ {
+ [$cellColumn, $cellRow] = Coordinate::coordinateFromString($cellAddress);
+ $cellColumnIndex = Coordinate::columnIndexFromString($cellColumn);
+ // Is cell within the range of rows/columns if we're deleting
+ if (
+ $this->numberOfRows < 0
+ && ($cellRow >= ($this->beforeRow + $this->numberOfRows))
+ && ($cellRow < $this->beforeRow)
+ ) {
+ return true;
+ } elseif (
+ $this->numberOfColumns < 0
+ && ($cellColumnIndex >= ($this->beforeColumn + $this->numberOfColumns))
+ && ($cellColumnIndex < $this->beforeColumn)
+ ) {
+ return true;
+ }
+
+ return false;
+ }
+
+ protected function updateColumnReference(int $newColumnIndex, string $absoluteColumn): string
+ {
+ $newColumn = Coordinate::stringFromColumnIndex(min($newColumnIndex + $this->numberOfColumns, AddressRange::MAX_COLUMN_INT));
+
+ return "{$absoluteColumn}{$newColumn}";
+ }
+
+ protected function updateRowReference(int $newRowIndex, string $absoluteRow): string
+ {
+ $newRow = $newRowIndex + $this->numberOfRows;
+ $newRow = ($newRow > AddressRange::MAX_ROW) ? AddressRange::MAX_ROW : $newRow;
+
+ return "{$absoluteRow}{$newRow}";
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Axis.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Axis.php
new file mode 100644
index 00000000..dc1fca4f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Axis.php
@@ -0,0 +1,344 @@
+fillColor = new ChartColor();
+ }
+
+ /**
+ * Chart Major Gridlines as.
+ */
+ private ?GridLines $majorGridlines = null;
+
+ /**
+ * Chart Minor Gridlines as.
+ */
+ private ?GridLines $minorGridlines = null;
+
+ /**
+ * Axis Number.
+ *
+ * @var array{format: string, source_linked: int, numeric: ?bool}
+ */
+ private array $axisNumber = [
+ 'format' => self::FORMAT_CODE_GENERAL,
+ 'source_linked' => 1,
+ 'numeric' => null,
+ ];
+
+ private string $axisType = '';
+
+ private ?AxisText $axisText = null;
+
+ private ?Title $dispUnitsTitle = null;
+
+ /**
+ * Axis Options.
+ *
+ * @var array
+ */
+ private array $axisOptions = [
+ 'minimum' => null,
+ 'maximum' => null,
+ 'major_unit' => null,
+ 'minor_unit' => null,
+ 'orientation' => self::ORIENTATION_NORMAL,
+ 'minor_tick_mark' => self::TICK_MARK_NONE,
+ 'major_tick_mark' => self::TICK_MARK_NONE,
+ 'axis_labels' => self::AXIS_LABELS_NEXT_TO,
+ 'horizontal_crosses' => self::HORIZONTAL_CROSSES_AUTOZERO,
+ 'horizontal_crosses_value' => null,
+ 'textRotation' => null,
+ 'hidden' => null,
+ 'majorTimeUnit' => self::TIME_UNIT_YEARS,
+ 'minorTimeUnit' => self::TIME_UNIT_MONTHS,
+ 'baseTimeUnit' => self::TIME_UNIT_DAYS,
+ 'logBase' => null,
+ 'dispUnitsBuiltIn' => null,
+ ];
+ public const DISP_UNITS_HUNDREDS = 'hundreds';
+ public const DISP_UNITS_THOUSANDS = 'thousands';
+ public const DISP_UNITS_TEN_THOUSANDS = 'tenThousands';
+ public const DISP_UNITS_HUNDRED_THOUSANDS = 'hundredThousands';
+ public const DISP_UNITS_MILLIONS = 'millions';
+ public const DISP_UNITS_TEN_MILLIONS = 'tenMillions';
+ public const DISP_UNITS_HUNDRED_MILLIONS = 'hundredMillions';
+ public const DISP_UNITS_BILLIONS = 'billions';
+ public const DISP_UNITS_TRILLIONS = 'trillions';
+ public const TRILLION_INDEX = (PHP_INT_SIZE > 4) ? 1000000000000 : '1000000000000';
+ public const DISP_UNITS_BUILTIN_INT = [
+ 100 => self::DISP_UNITS_HUNDREDS,
+ 1000 => self::DISP_UNITS_THOUSANDS,
+ 10000 => self::DISP_UNITS_TEN_THOUSANDS,
+ 100000 => self::DISP_UNITS_HUNDRED_THOUSANDS,
+ 1000000 => self::DISP_UNITS_MILLIONS,
+ 10000000 => self::DISP_UNITS_TEN_MILLIONS,
+ 100000000 => self::DISP_UNITS_HUNDRED_MILLIONS,
+ 1000000000 => self::DISP_UNITS_BILLIONS,
+ self::TRILLION_INDEX => self::DISP_UNITS_TRILLIONS, // overflow for 32-bit
+ ];
+
+ /**
+ * Fill Properties.
+ */
+ private ChartColor $fillColor;
+
+ private const NUMERIC_FORMAT = [
+ Properties::FORMAT_CODE_NUMBER,
+ Properties::FORMAT_CODE_DATE,
+ Properties::FORMAT_CODE_DATE_ISO8601,
+ ];
+
+ private bool $noFill = false;
+
+ /**
+ * Get Series Data Type.
+ */
+ public function setAxisNumberProperties(string $format_code, ?bool $numeric = null, int $sourceLinked = 0): void
+ {
+ $format = $format_code;
+ $this->axisNumber['format'] = $format;
+ $this->axisNumber['source_linked'] = $sourceLinked;
+ if (is_bool($numeric)) {
+ $this->axisNumber['numeric'] = $numeric;
+ } elseif (in_array($format, self::NUMERIC_FORMAT, true)) {
+ $this->axisNumber['numeric'] = true;
+ }
+ }
+
+ /**
+ * Get Axis Number Format Data Type.
+ */
+ public function getAxisNumberFormat(): string
+ {
+ return $this->axisNumber['format'];
+ }
+
+ /**
+ * Get Axis Number Source Linked.
+ */
+ public function getAxisNumberSourceLinked(): string
+ {
+ return (string) $this->axisNumber['source_linked'];
+ }
+
+ public function getAxisIsNumericFormat(): bool
+ {
+ return $this->axisType === self::AXIS_TYPE_DATE || (bool) $this->axisNumber['numeric'];
+ }
+
+ public function setAxisOption(string $key, null|float|int|string $value): void
+ {
+ if ($value !== null && $value !== '') {
+ $this->axisOptions[$key] = (string) $value;
+ }
+ }
+
+ /**
+ * Set Axis Options Properties.
+ */
+ public function setAxisOptionsProperties(
+ string $axisLabels,
+ ?string $horizontalCrossesValue = null,
+ ?string $horizontalCrosses = null,
+ ?string $axisOrientation = null,
+ ?string $majorTmt = null,
+ ?string $minorTmt = null,
+ null|float|int|string $minimum = null,
+ null|float|int|string $maximum = null,
+ null|float|int|string $majorUnit = null,
+ null|float|int|string $minorUnit = null,
+ null|float|int|string $textRotation = null,
+ ?string $hidden = null,
+ ?string $baseTimeUnit = null,
+ ?string $majorTimeUnit = null,
+ ?string $minorTimeUnit = null,
+ null|float|int|string $logBase = null,
+ ?string $dispUnitsBuiltIn = null
+ ): void {
+ $this->axisOptions['axis_labels'] = $axisLabels;
+ $this->setAxisOption('horizontal_crosses_value', $horizontalCrossesValue);
+ $this->setAxisOption('horizontal_crosses', $horizontalCrosses);
+ $this->setAxisOption('orientation', $axisOrientation);
+ $this->setAxisOption('major_tick_mark', $majorTmt);
+ $this->setAxisOption('minor_tick_mark', $minorTmt);
+ $this->setAxisOption('minimum', $minimum);
+ $this->setAxisOption('maximum', $maximum);
+ $this->setAxisOption('major_unit', $majorUnit);
+ $this->setAxisOption('minor_unit', $minorUnit);
+ $this->setAxisOption('textRotation', $textRotation);
+ $this->setAxisOption('hidden', $hidden);
+ $this->setAxisOption('baseTimeUnit', $baseTimeUnit);
+ $this->setAxisOption('majorTimeUnit', $majorTimeUnit);
+ $this->setAxisOption('minorTimeUnit', $minorTimeUnit);
+ $this->setAxisOption('logBase', $logBase);
+ $this->setAxisOption('dispUnitsBuiltIn', $dispUnitsBuiltIn);
+ }
+
+ /**
+ * Get Axis Options Property.
+ */
+ public function getAxisOptionsProperty(string $property): ?string
+ {
+ if ($property === 'textRotation') {
+ if ($this->axisText !== null) {
+ if ($this->axisText->getRotation() !== null) {
+ return (string) $this->axisText->getRotation();
+ }
+ }
+ }
+
+ return $this->axisOptions[$property];
+ }
+
+ /**
+ * Set Axis Orientation Property.
+ */
+ public function setAxisOrientation(string $orientation): void
+ {
+ $this->axisOptions['orientation'] = (string) $orientation;
+ }
+
+ public function getAxisType(): string
+ {
+ return $this->axisType;
+ }
+
+ public function setAxisType(string $type): self
+ {
+ if ($type === self::AXIS_TYPE_CATEGORY || $type === self::AXIS_TYPE_VALUE || $type === self::AXIS_TYPE_DATE) {
+ $this->axisType = $type;
+ } else {
+ $this->axisType = '';
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set Fill Property.
+ */
+ public function setFillParameters(?string $color, ?int $alpha = null, ?string $AlphaType = ChartColor::EXCEL_COLOR_TYPE_RGB): void
+ {
+ $this->fillColor->setColorProperties($color, $alpha, $AlphaType);
+ }
+
+ /**
+ * Get Fill Property.
+ */
+ public function getFillProperty(string $property): string
+ {
+ return (string) $this->fillColor->getColorProperty($property);
+ }
+
+ public function getFillColorObject(): ChartColor
+ {
+ return $this->fillColor;
+ }
+
+ private string $crossBetween = ''; // 'between' or 'midCat' might be better
+
+ public function setCrossBetween(string $crossBetween): self
+ {
+ $this->crossBetween = $crossBetween;
+
+ return $this;
+ }
+
+ public function getCrossBetween(): string
+ {
+ return $this->crossBetween;
+ }
+
+ public function getMajorGridlines(): ?GridLines
+ {
+ return $this->majorGridlines;
+ }
+
+ public function getMinorGridlines(): ?GridLines
+ {
+ return $this->minorGridlines;
+ }
+
+ public function setMajorGridlines(?GridLines $gridlines): self
+ {
+ $this->majorGridlines = $gridlines;
+
+ return $this;
+ }
+
+ public function setMinorGridlines(?GridLines $gridlines): self
+ {
+ $this->minorGridlines = $gridlines;
+
+ return $this;
+ }
+
+ public function getAxisText(): ?AxisText
+ {
+ return $this->axisText;
+ }
+
+ public function setAxisText(?AxisText $axisText): self
+ {
+ $this->axisText = $axisText;
+
+ return $this;
+ }
+
+ public function setNoFill(bool $noFill): self
+ {
+ $this->noFill = $noFill;
+
+ return $this;
+ }
+
+ public function getNoFill(): bool
+ {
+ return $this->noFill;
+ }
+
+ public function setDispUnitsTitle(?Title $dispUnitsTitle): self
+ {
+ $this->dispUnitsTitle = $dispUnitsTitle;
+
+ return $this;
+ }
+
+ public function getDispUnitsTitle(): ?Title
+ {
+ return $this->dispUnitsTitle;
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ parent::__clone();
+ $this->majorGridlines = ($this->majorGridlines === null) ? null : clone $this->majorGridlines;
+ $this->majorGridlines = ($this->minorGridlines === null) ? null : clone $this->minorGridlines;
+ $this->axisText = ($this->axisText === null) ? null : clone $this->axisText;
+ $this->dispUnitsTitle = ($this->dispUnitsTitle === null) ? null : clone $this->dispUnitsTitle;
+ $this->fillColor = clone $this->fillColor;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/AxisText.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/AxisText.php
new file mode 100644
index 00000000..09d6b2a5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/AxisText.php
@@ -0,0 +1,63 @@
+font = new Font();
+ $this->font->setSize(null, true);
+ }
+
+ public function setRotation(?int $rotation): self
+ {
+ $this->rotation = $rotation;
+
+ return $this;
+ }
+
+ public function getRotation(): ?int
+ {
+ return $this->rotation;
+ }
+
+ public function getFillColorObject(): ChartColor
+ {
+ $fillColor = $this->font->getChartColor();
+ if ($fillColor === null) {
+ $fillColor = new ChartColor();
+ $this->font->setChartColorFromObject($fillColor);
+ }
+
+ return $fillColor;
+ }
+
+ public function getFont(): Font
+ {
+ return $this->font;
+ }
+
+ public function setFont(Font $font): self
+ {
+ $this->font = $font;
+
+ return $this;
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ parent::__clone();
+ $this->font = clone $this->font;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Chart.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Chart.php
new file mode 100644
index 00000000..dae43c95
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Chart.php
@@ -0,0 +1,770 @@
+name = $name;
+ $this->title = $title;
+ $this->legend = $legend;
+ $this->xAxisLabel = $xAxisLabel;
+ $this->yAxisLabel = $yAxisLabel;
+ $this->plotArea = $plotArea;
+ $this->plotVisibleOnly = $plotVisibleOnly;
+ $this->displayBlanksAs = $displayBlanksAs;
+ $this->xAxis = $xAxis ?? new Axis();
+ $this->yAxis = $yAxis ?? new Axis();
+ if ($majorGridlines !== null) {
+ $this->yAxis->setMajorGridlines($majorGridlines);
+ }
+ if ($minorGridlines !== null) {
+ $this->yAxis->setMinorGridlines($minorGridlines);
+ }
+ $this->fillColor = new ChartColor();
+ $this->borderLines = new GridLines();
+ }
+
+ public function __destruct()
+ {
+ $this->worksheet = null;
+ }
+
+ /**
+ * Get Name.
+ */
+ public function getName(): string
+ {
+ return $this->name;
+ }
+
+ public function setName(string $name): self
+ {
+ $this->name = $name;
+
+ return $this;
+ }
+
+ /**
+ * Get Worksheet.
+ */
+ public function getWorksheet(): ?Worksheet
+ {
+ return $this->worksheet;
+ }
+
+ /**
+ * Set Worksheet.
+ *
+ * @return $this
+ */
+ public function setWorksheet(?Worksheet $worksheet = null): static
+ {
+ $this->worksheet = $worksheet;
+
+ return $this;
+ }
+
+ public function getTitle(): ?Title
+ {
+ return $this->title;
+ }
+
+ /**
+ * Set Title.
+ *
+ * @return $this
+ */
+ public function setTitle(Title $title): static
+ {
+ $this->title = $title;
+
+ return $this;
+ }
+
+ public function getLegend(): ?Legend
+ {
+ return $this->legend;
+ }
+
+ /**
+ * Set Legend.
+ *
+ * @return $this
+ */
+ public function setLegend(Legend $legend): static
+ {
+ $this->legend = $legend;
+
+ return $this;
+ }
+
+ public function getXAxisLabel(): ?Title
+ {
+ return $this->xAxisLabel;
+ }
+
+ /**
+ * Set X-Axis Label.
+ *
+ * @return $this
+ */
+ public function setXAxisLabel(Title $label): static
+ {
+ $this->xAxisLabel = $label;
+
+ return $this;
+ }
+
+ public function getYAxisLabel(): ?Title
+ {
+ return $this->yAxisLabel;
+ }
+
+ /**
+ * Set Y-Axis Label.
+ *
+ * @return $this
+ */
+ public function setYAxisLabel(Title $label): static
+ {
+ $this->yAxisLabel = $label;
+
+ return $this;
+ }
+
+ public function getPlotArea(): ?PlotArea
+ {
+ return $this->plotArea;
+ }
+
+ public function getPlotAreaOrThrow(): PlotArea
+ {
+ $plotArea = $this->getPlotArea();
+ if ($plotArea !== null) {
+ return $plotArea;
+ }
+
+ throw new Exception('Chart has no PlotArea');
+ }
+
+ /**
+ * Set Plot Area.
+ */
+ public function setPlotArea(PlotArea $plotArea): self
+ {
+ $this->plotArea = $plotArea;
+
+ return $this;
+ }
+
+ /**
+ * Get Plot Visible Only.
+ */
+ public function getPlotVisibleOnly(): bool
+ {
+ return $this->plotVisibleOnly;
+ }
+
+ /**
+ * Set Plot Visible Only.
+ *
+ * @return $this
+ */
+ public function setPlotVisibleOnly(bool $plotVisibleOnly): static
+ {
+ $this->plotVisibleOnly = $plotVisibleOnly;
+
+ return $this;
+ }
+
+ /**
+ * Get Display Blanks as.
+ */
+ public function getDisplayBlanksAs(): string
+ {
+ return $this->displayBlanksAs;
+ }
+
+ /**
+ * Set Display Blanks as.
+ *
+ * @return $this
+ */
+ public function setDisplayBlanksAs(string $displayBlanksAs): static
+ {
+ $this->displayBlanksAs = $displayBlanksAs;
+
+ return $this;
+ }
+
+ public function getChartAxisY(): Axis
+ {
+ return $this->yAxis;
+ }
+
+ /**
+ * Set yAxis.
+ */
+ public function setChartAxisY(?Axis $axis): self
+ {
+ $this->yAxis = $axis ?? new Axis();
+
+ return $this;
+ }
+
+ public function getChartAxisX(): Axis
+ {
+ return $this->xAxis;
+ }
+
+ /**
+ * Set xAxis.
+ */
+ public function setChartAxisX(?Axis $axis): self
+ {
+ $this->xAxis = $axis ?? new Axis();
+
+ return $this;
+ }
+
+ /**
+ * Set the Top Left position for the chart.
+ *
+ * @return $this
+ */
+ public function setTopLeftPosition(string $cellAddress, ?int $xOffset = null, ?int $yOffset = null): static
+ {
+ $this->topLeftCellRef = $cellAddress;
+ if ($xOffset !== null) {
+ $this->setTopLeftXOffset($xOffset);
+ }
+ if ($yOffset !== null) {
+ $this->setTopLeftYOffset($yOffset);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get the top left position of the chart.
+ *
+ * Returns ['cell' => string cell address, 'xOffset' => int, 'yOffset' => int].
+ *
+ * @return array{cell: string, xOffset: int, yOffset: int} an associative array containing the cell address, X-Offset and Y-Offset from the top left of that cell
+ */
+ public function getTopLeftPosition(): array
+ {
+ return [
+ 'cell' => $this->topLeftCellRef,
+ 'xOffset' => $this->topLeftXOffset,
+ 'yOffset' => $this->topLeftYOffset,
+ ];
+ }
+
+ /**
+ * Get the cell address where the top left of the chart is fixed.
+ */
+ public function getTopLeftCell(): string
+ {
+ return $this->topLeftCellRef;
+ }
+
+ /**
+ * Set the Top Left cell position for the chart.
+ *
+ * @return $this
+ */
+ public function setTopLeftCell(string $cellAddress): static
+ {
+ $this->topLeftCellRef = $cellAddress;
+
+ return $this;
+ }
+
+ /**
+ * Set the offset position within the Top Left cell for the chart.
+ *
+ * @return $this
+ */
+ public function setTopLeftOffset(?int $xOffset, ?int $yOffset): static
+ {
+ if ($xOffset !== null) {
+ $this->setTopLeftXOffset($xOffset);
+ }
+
+ if ($yOffset !== null) {
+ $this->setTopLeftYOffset($yOffset);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get the offset position within the Top Left cell for the chart.
+ *
+ * @return int[]
+ */
+ public function getTopLeftOffset(): array
+ {
+ return [
+ 'X' => $this->topLeftXOffset,
+ 'Y' => $this->topLeftYOffset,
+ ];
+ }
+
+ /**
+ * @return $this
+ */
+ public function setTopLeftXOffset(int $xOffset): static
+ {
+ $this->topLeftXOffset = $xOffset;
+
+ return $this;
+ }
+
+ public function getTopLeftXOffset(): int
+ {
+ return $this->topLeftXOffset;
+ }
+
+ /**
+ * @return $this
+ */
+ public function setTopLeftYOffset(int $yOffset): static
+ {
+ $this->topLeftYOffset = $yOffset;
+
+ return $this;
+ }
+
+ public function getTopLeftYOffset(): int
+ {
+ return $this->topLeftYOffset;
+ }
+
+ /**
+ * Set the Bottom Right position of the chart.
+ *
+ * @return $this
+ */
+ public function setBottomRightPosition(string $cellAddress = '', ?int $xOffset = null, ?int $yOffset = null): static
+ {
+ $this->bottomRightCellRef = $cellAddress;
+ if ($xOffset !== null) {
+ $this->setBottomRightXOffset($xOffset);
+ }
+ if ($yOffset !== null) {
+ $this->setBottomRightYOffset($yOffset);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get the bottom right position of the chart.
+ *
+ * @return array an associative array containing the cell address, X-Offset and Y-Offset from the top left of that cell
+ */
+ public function getBottomRightPosition(): array
+ {
+ return [
+ 'cell' => $this->bottomRightCellRef,
+ 'xOffset' => $this->bottomRightXOffset,
+ 'yOffset' => $this->bottomRightYOffset,
+ ];
+ }
+
+ /**
+ * Set the Bottom Right cell for the chart.
+ *
+ * @return $this
+ */
+ public function setBottomRightCell(string $cellAddress = ''): static
+ {
+ $this->bottomRightCellRef = $cellAddress;
+
+ return $this;
+ }
+
+ /**
+ * Get the cell address where the bottom right of the chart is fixed.
+ */
+ public function getBottomRightCell(): string
+ {
+ return $this->bottomRightCellRef;
+ }
+
+ /**
+ * Set the offset position within the Bottom Right cell for the chart.
+ *
+ * @return $this
+ */
+ public function setBottomRightOffset(?int $xOffset, ?int $yOffset): static
+ {
+ if ($xOffset !== null) {
+ $this->setBottomRightXOffset($xOffset);
+ }
+
+ if ($yOffset !== null) {
+ $this->setBottomRightYOffset($yOffset);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get the offset position within the Bottom Right cell for the chart.
+ *
+ * @return int[]
+ */
+ public function getBottomRightOffset(): array
+ {
+ return [
+ 'X' => $this->bottomRightXOffset,
+ 'Y' => $this->bottomRightYOffset,
+ ];
+ }
+
+ /**
+ * @return $this
+ */
+ public function setBottomRightXOffset(int $xOffset): static
+ {
+ $this->bottomRightXOffset = $xOffset;
+
+ return $this;
+ }
+
+ public function getBottomRightXOffset(): int
+ {
+ return $this->bottomRightXOffset;
+ }
+
+ /**
+ * @return $this
+ */
+ public function setBottomRightYOffset(int $yOffset): static
+ {
+ $this->bottomRightYOffset = $yOffset;
+
+ return $this;
+ }
+
+ public function getBottomRightYOffset(): int
+ {
+ return $this->bottomRightYOffset;
+ }
+
+ public function refresh(): void
+ {
+ if ($this->worksheet !== null && $this->plotArea !== null) {
+ $this->plotArea->refresh($this->worksheet);
+ }
+ }
+
+ /**
+ * Render the chart to given file (or stream).
+ *
+ * @param ?string $outputDestination Name of the file render to
+ *
+ * @return bool true on success
+ */
+ public function render(?string $outputDestination = null): bool
+ {
+ if ($outputDestination == 'php://output') {
+ $outputDestination = null;
+ }
+
+ $libraryName = Settings::getChartRenderer();
+ if ($libraryName === null) {
+ return false;
+ }
+
+ // Ensure that data series values are up-to-date before we render
+ $this->refresh();
+
+ $renderer = new $libraryName($this);
+
+ return $renderer->render($outputDestination);
+ }
+
+ public function getRotX(): ?int
+ {
+ return $this->rotX;
+ }
+
+ public function setRotX(?int $rotX): self
+ {
+ $this->rotX = $rotX;
+
+ return $this;
+ }
+
+ public function getRotY(): ?int
+ {
+ return $this->rotY;
+ }
+
+ public function setRotY(?int $rotY): self
+ {
+ $this->rotY = $rotY;
+
+ return $this;
+ }
+
+ public function getRAngAx(): ?int
+ {
+ return $this->rAngAx;
+ }
+
+ public function setRAngAx(?int $rAngAx): self
+ {
+ $this->rAngAx = $rAngAx;
+
+ return $this;
+ }
+
+ public function getPerspective(): ?int
+ {
+ return $this->perspective;
+ }
+
+ public function setPerspective(?int $perspective): self
+ {
+ $this->perspective = $perspective;
+
+ return $this;
+ }
+
+ public function getOneCellAnchor(): bool
+ {
+ return $this->oneCellAnchor;
+ }
+
+ public function setOneCellAnchor(bool $oneCellAnchor): self
+ {
+ $this->oneCellAnchor = $oneCellAnchor;
+
+ return $this;
+ }
+
+ public function getAutoTitleDeleted(): bool
+ {
+ return $this->autoTitleDeleted;
+ }
+
+ public function setAutoTitleDeleted(bool $autoTitleDeleted): self
+ {
+ $this->autoTitleDeleted = $autoTitleDeleted;
+
+ return $this;
+ }
+
+ public function getNoFill(): bool
+ {
+ return $this->noFill;
+ }
+
+ public function setNoFill(bool $noFill): self
+ {
+ $this->noFill = $noFill;
+
+ return $this;
+ }
+
+ public function getRoundedCorners(): bool
+ {
+ return $this->roundedCorners;
+ }
+
+ public function setRoundedCorners(?bool $roundedCorners): self
+ {
+ if ($roundedCorners !== null) {
+ $this->roundedCorners = $roundedCorners;
+ }
+
+ return $this;
+ }
+
+ public function getBorderLines(): GridLines
+ {
+ return $this->borderLines;
+ }
+
+ public function setBorderLines(GridLines $borderLines): self
+ {
+ $this->borderLines = $borderLines;
+
+ return $this;
+ }
+
+ public function getFillColor(): ChartColor
+ {
+ return $this->fillColor;
+ }
+
+ public function setRenderedWidth(?float $width): self
+ {
+ $this->renderedWidth = $width;
+
+ return $this;
+ }
+
+ public function getRenderedWidth(): ?float
+ {
+ return $this->renderedWidth;
+ }
+
+ public function setRenderedHeight(?float $height): self
+ {
+ $this->renderedHeight = $height;
+
+ return $this;
+ }
+
+ public function getRenderedHeight(): ?float
+ {
+ return $this->renderedHeight;
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $this->worksheet = null;
+ $this->title = ($this->title === null) ? null : clone $this->title;
+ $this->legend = ($this->legend === null) ? null : clone $this->legend;
+ $this->xAxisLabel = ($this->xAxisLabel === null) ? null : clone $this->xAxisLabel;
+ $this->yAxisLabel = ($this->yAxisLabel === null) ? null : clone $this->yAxisLabel;
+ $this->plotArea = ($this->plotArea === null) ? null : clone $this->plotArea;
+ $this->xAxis = clone $this->xAxis;
+ $this->yAxis = clone $this->yAxis;
+ $this->borderLines = clone $this->borderLines;
+ $this->fillColor = clone $this->fillColor;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/ChartColor.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/ChartColor.php
new file mode 100644
index 00000000..d6306de6
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/ChartColor.php
@@ -0,0 +1,160 @@
+setColorPropertiesArray($value);
+ } else {
+ $this->setColorProperties($value, $alpha, $type, $brightness);
+ }
+ }
+
+ public function getValue(): string
+ {
+ return $this->value;
+ }
+
+ public function setValue(string $value): self
+ {
+ $this->value = $value;
+
+ return $this;
+ }
+
+ public function getType(): string
+ {
+ return $this->type;
+ }
+
+ public function setType(string $type): self
+ {
+ $this->type = $type;
+
+ return $this;
+ }
+
+ public function getAlpha(): ?int
+ {
+ return $this->alpha;
+ }
+
+ public function setAlpha(?int $alpha): self
+ {
+ $this->alpha = $alpha;
+
+ return $this;
+ }
+
+ public function getBrightness(): ?int
+ {
+ return $this->brightness;
+ }
+
+ public function setBrightness(?int $brightness): self
+ {
+ $this->brightness = $brightness;
+
+ return $this;
+ }
+
+ public function setColorProperties(?string $color, null|float|int|string $alpha = null, ?string $type = null, null|float|int|string $brightness = null): self
+ {
+ if (empty($type) && !empty($color)) {
+ if (str_starts_with($color, '*')) {
+ $type = 'schemeClr';
+ $color = substr($color, 1);
+ } elseif (str_starts_with($color, '/')) {
+ $type = 'prstClr';
+ $color = substr($color, 1);
+ } elseif (preg_match('/^[0-9A-Fa-f]{6}$/', $color) === 1) {
+ $type = 'srgbClr';
+ }
+ }
+ if ($color !== null) {
+ $this->setValue("$color");
+ }
+ if ($type !== null) {
+ $this->setType($type);
+ }
+ if ($alpha === null) {
+ $this->setAlpha(null);
+ } elseif (is_numeric($alpha)) {
+ $this->setAlpha((int) $alpha);
+ }
+ if ($brightness === null) {
+ $this->setBrightness(null);
+ } elseif (is_numeric($brightness)) {
+ $this->setBrightness((int) $brightness);
+ }
+
+ return $this;
+ }
+
+ public function setColorPropertiesArray(array $color): self
+ {
+ return $this->setColorProperties(
+ $color['value'] ?? '',
+ $color['alpha'] ?? null,
+ $color['type'] ?? null,
+ $color['brightness'] ?? null
+ );
+ }
+
+ public function isUsable(): bool
+ {
+ return $this->type !== '' && $this->value !== '';
+ }
+
+ /**
+ * Get Color Property.
+ */
+ public function getColorProperty(string $propertyName): null|int|string
+ {
+ $retVal = null;
+ if ($propertyName === 'value') {
+ $retVal = $this->value;
+ } elseif ($propertyName === 'type') {
+ $retVal = $this->type;
+ } elseif ($propertyName === 'alpha') {
+ $retVal = $this->alpha;
+ } elseif ($propertyName === 'brightness') {
+ $retVal = $this->brightness;
+ }
+
+ return $retVal;
+ }
+
+ public static function alphaToXml(int $alpha): string
+ {
+ return (string) (100 - $alpha) . '000';
+ }
+
+ public static function alphaFromXml(float|int|string $alpha): int
+ {
+ return 100 - ((int) $alpha / 1000);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/DataSeries.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/DataSeries.php
new file mode 100644
index 00000000..c7a92820
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/DataSeries.php
@@ -0,0 +1,412 @@
+plotType = $plotType;
+ $this->plotGrouping = $plotGrouping;
+ $this->plotOrder = $plotOrder;
+ $keys = array_keys($plotValues);
+ $this->plotValues = $plotValues;
+ if (!isset($plotLabel[$keys[0]])) {
+ $plotLabel[$keys[0]] = new DataSeriesValues();
+ }
+ $this->plotLabel = $plotLabel;
+
+ if (!isset($plotCategory[$keys[0]])) {
+ $plotCategory[$keys[0]] = new DataSeriesValues();
+ }
+ $this->plotCategory = $plotCategory;
+
+ $this->smoothLine = (bool) $smoothLine;
+ $this->plotStyle = $plotStyle;
+
+ if ($plotDirection === null) {
+ $plotDirection = self::DIRECTION_COL;
+ }
+ $this->plotDirection = $plotDirection;
+ }
+
+ /**
+ * Get Plot Type.
+ */
+ public function getPlotType(): ?string
+ {
+ return $this->plotType;
+ }
+
+ /**
+ * Set Plot Type.
+ *
+ * @return $this
+ */
+ public function setPlotType(string $plotType): static
+ {
+ $this->plotType = $plotType;
+
+ return $this;
+ }
+
+ /**
+ * Get Plot Grouping Type.
+ */
+ public function getPlotGrouping(): ?string
+ {
+ return $this->plotGrouping;
+ }
+
+ /**
+ * Set Plot Grouping Type.
+ *
+ * @return $this
+ */
+ public function setPlotGrouping(string $groupingType): static
+ {
+ $this->plotGrouping = $groupingType;
+
+ return $this;
+ }
+
+ /**
+ * Get Plot Direction.
+ */
+ public function getPlotDirection(): string
+ {
+ return $this->plotDirection;
+ }
+
+ /**
+ * Set Plot Direction.
+ *
+ * @return $this
+ */
+ public function setPlotDirection(string $plotDirection): static
+ {
+ $this->plotDirection = $plotDirection;
+
+ return $this;
+ }
+
+ /**
+ * Get Plot Order.
+ *
+ * @return int[]
+ */
+ public function getPlotOrder(): array
+ {
+ return $this->plotOrder;
+ }
+
+ /**
+ * Get Plot Labels.
+ *
+ * @return DataSeriesValues[]
+ */
+ public function getPlotLabels(): array
+ {
+ return $this->plotLabel;
+ }
+
+ /**
+ * Get Plot Label by Index.
+ *
+ * @return DataSeriesValues|false
+ */
+ public function getPlotLabelByIndex(int $index): bool|DataSeriesValues
+ {
+ $keys = array_keys($this->plotLabel);
+ if (in_array($index, $keys)) {
+ return $this->plotLabel[$index];
+ }
+
+ return false;
+ }
+
+ /**
+ * Get Plot Categories.
+ *
+ * @return DataSeriesValues[]
+ */
+ public function getPlotCategories(): array
+ {
+ return $this->plotCategory;
+ }
+
+ /**
+ * Get Plot Category by Index.
+ *
+ * @return DataSeriesValues|false
+ */
+ public function getPlotCategoryByIndex(int $index): bool|DataSeriesValues
+ {
+ $keys = array_keys($this->plotCategory);
+ if (in_array($index, $keys)) {
+ return $this->plotCategory[$index];
+ } elseif (isset($keys[$index])) {
+ return $this->plotCategory[$keys[$index]];
+ }
+
+ return false;
+ }
+
+ /**
+ * Get Plot Style.
+ */
+ public function getPlotStyle(): ?string
+ {
+ return $this->plotStyle;
+ }
+
+ /**
+ * Set Plot Style.
+ *
+ * @return $this
+ */
+ public function setPlotStyle(?string $plotStyle): static
+ {
+ $this->plotStyle = $plotStyle;
+
+ return $this;
+ }
+
+ /**
+ * Get Plot Values.
+ *
+ * @return DataSeriesValues[]
+ */
+ public function getPlotValues(): array
+ {
+ return $this->plotValues;
+ }
+
+ /**
+ * Get Plot Values by Index.
+ *
+ * @return DataSeriesValues|false
+ */
+ public function getPlotValuesByIndex(int $index): bool|DataSeriesValues
+ {
+ $keys = array_keys($this->plotValues);
+ if (in_array($index, $keys)) {
+ return $this->plotValues[$index];
+ }
+
+ return false;
+ }
+
+ /**
+ * Get Plot Bubble Sizes.
+ *
+ * @return DataSeriesValues[]
+ */
+ public function getPlotBubbleSizes(): array
+ {
+ return $this->plotBubbleSizes;
+ }
+
+ /**
+ * Set Plot Bubble Sizes.
+ *
+ * @param DataSeriesValues[] $plotBubbleSizes
+ */
+ public function setPlotBubbleSizes(array $plotBubbleSizes): self
+ {
+ $this->plotBubbleSizes = $plotBubbleSizes;
+
+ return $this;
+ }
+
+ /**
+ * Get Number of Plot Series.
+ */
+ public function getPlotSeriesCount(): int
+ {
+ return count($this->plotValues);
+ }
+
+ /**
+ * Get Smooth Line.
+ */
+ public function getSmoothLine(): bool
+ {
+ return $this->smoothLine;
+ }
+
+ /**
+ * Set Smooth Line.
+ *
+ * @return $this
+ */
+ public function setSmoothLine(bool $smoothLine): static
+ {
+ $this->smoothLine = $smoothLine;
+
+ return $this;
+ }
+
+ public function refresh(Worksheet $worksheet): void
+ {
+ foreach ($this->plotValues as $plotValues) {
+ if ($plotValues !== null) {
+ $plotValues->refresh($worksheet, true);
+ }
+ }
+ foreach ($this->plotLabel as $plotValues) {
+ if ($plotValues !== null) {
+ $plotValues->refresh($worksheet, true);
+ }
+ }
+ foreach ($this->plotCategory as $plotValues) {
+ if ($plotValues !== null) {
+ $plotValues->refresh($worksheet, false);
+ }
+ }
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $plotLabels = $this->plotLabel;
+ $this->plotLabel = [];
+ foreach ($plotLabels as $plotLabel) {
+ $this->plotLabel[] = $plotLabel;
+ }
+ $plotCategories = $this->plotCategory;
+ $this->plotCategory = [];
+ foreach ($plotCategories as $plotCategory) {
+ $this->plotCategory[] = clone $plotCategory;
+ }
+ $plotValues = $this->plotValues;
+ $this->plotValues = [];
+ foreach ($plotValues as $plotValue) {
+ $this->plotValues[] = clone $plotValue;
+ }
+ $plotBubbleSizes = $this->plotBubbleSizes;
+ $this->plotBubbleSizes = [];
+ foreach ($plotBubbleSizes as $plotBubbleSize) {
+ $this->plotBubbleSizes[] = clone $plotBubbleSize;
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/DataSeriesValues.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/DataSeriesValues.php
new file mode 100644
index 00000000..70f90bf7
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/DataSeriesValues.php
@@ -0,0 +1,571 @@
+markerFillColor = new ChartColor();
+ $this->markerBorderColor = new ChartColor();
+ $this->setDataType($dataType);
+ $this->dataSource = $dataSource;
+ $this->formatCode = $formatCode;
+ $this->pointCount = $pointCount;
+ $this->dataValues = $dataValues;
+ $this->pointMarker = $marker;
+ if ($fillColor !== null) {
+ $this->setFillColor($fillColor);
+ }
+ if (is_numeric($pointSize)) {
+ $this->pointSize = (int) $pointSize;
+ }
+ }
+
+ /**
+ * Get Series Data Type.
+ */
+ public function getDataType(): string
+ {
+ return $this->dataType;
+ }
+
+ /**
+ * Set Series Data Type.
+ *
+ * @param string $dataType Datatype of this data series
+ * Typical values are:
+ * DataSeriesValues::DATASERIES_TYPE_STRING
+ * Normally used for axis point values
+ * DataSeriesValues::DATASERIES_TYPE_NUMBER
+ * Normally used for chart data values
+ *
+ * @return $this
+ */
+ public function setDataType(string $dataType): static
+ {
+ if (!in_array($dataType, self::DATA_TYPE_VALUES)) {
+ throw new Exception('Invalid datatype for chart data series values');
+ }
+ $this->dataType = $dataType;
+
+ return $this;
+ }
+
+ /**
+ * Get Series Data Source (formula).
+ */
+ public function getDataSource(): ?string
+ {
+ return $this->dataSource;
+ }
+
+ /**
+ * Set Series Data Source (formula).
+ *
+ * @return $this
+ */
+ public function setDataSource(?string $dataSource): static
+ {
+ $this->dataSource = $dataSource;
+
+ return $this;
+ }
+
+ /**
+ * Get Point Marker.
+ */
+ public function getPointMarker(): ?string
+ {
+ return $this->pointMarker;
+ }
+
+ /**
+ * Set Point Marker.
+ *
+ * @return $this
+ */
+ public function setPointMarker(string $marker): static
+ {
+ $this->pointMarker = $marker;
+
+ return $this;
+ }
+
+ public function getMarkerFillColor(): ChartColor
+ {
+ return $this->markerFillColor;
+ }
+
+ public function getMarkerBorderColor(): ChartColor
+ {
+ return $this->markerBorderColor;
+ }
+
+ /**
+ * Get Point Size.
+ */
+ public function getPointSize(): int
+ {
+ return $this->pointSize;
+ }
+
+ /**
+ * Set Point Size.
+ *
+ * @return $this
+ */
+ public function setPointSize(int $size = 3): static
+ {
+ $this->pointSize = $size;
+
+ return $this;
+ }
+
+ /**
+ * Get Series Format Code.
+ */
+ public function getFormatCode(): ?string
+ {
+ return $this->formatCode;
+ }
+
+ /**
+ * Set Series Format Code.
+ *
+ * @return $this
+ */
+ public function setFormatCode(string $formatCode): static
+ {
+ $this->formatCode = $formatCode;
+
+ return $this;
+ }
+
+ /**
+ * Get Series Point Count.
+ */
+ public function getPointCount(): int
+ {
+ return $this->pointCount;
+ }
+
+ /**
+ * Get fill color object.
+ *
+ * @return null|ChartColor|ChartColor[]
+ */
+ public function getFillColorObject()
+ {
+ return $this->fillColor;
+ }
+
+ private function stringToChartColor(string $fillString): ChartColor
+ {
+ $value = $type = '';
+ if (str_starts_with($fillString, '*')) {
+ $type = 'schemeClr';
+ $value = substr($fillString, 1);
+ } elseif (str_starts_with($fillString, '/')) {
+ $type = 'prstClr';
+ $value = substr($fillString, 1);
+ } elseif ($fillString !== '') {
+ $type = 'srgbClr';
+ $value = $fillString;
+ $this->validateColor($value);
+ }
+
+ return new ChartColor($value, null, $type);
+ }
+
+ private function chartColorToString(ChartColor $chartColor): string
+ {
+ $type = (string) $chartColor->getColorProperty('type');
+ $value = (string) $chartColor->getColorProperty('value');
+ if ($type === '' || $value === '') {
+ return '';
+ }
+ if ($type === 'schemeClr') {
+ return "*$value";
+ }
+ if ($type === 'prstClr') {
+ return "/$value";
+ }
+
+ return $value;
+ }
+
+ /**
+ * Get fill color.
+ *
+ * @return string|string[] HEX color or array with HEX colors
+ */
+ public function getFillColor(): string|array
+ {
+ if ($this->fillColor === null) {
+ return '';
+ }
+ if (is_array($this->fillColor)) {
+ $array = [];
+ foreach ($this->fillColor as $chartColor) {
+ $array[] = $this->chartColorToString($chartColor);
+ }
+
+ return $array;
+ }
+
+ return $this->chartColorToString($this->fillColor);
+ }
+
+ /**
+ * Set fill color for series.
+ *
+ * @param ChartColor|ChartColor[]|string|string[] $color HEX color or array with HEX colors
+ *
+ * @return $this
+ */
+ public function setFillColor($color): static
+ {
+ if (is_array($color)) {
+ $this->fillColor = [];
+ foreach ($color as $fillString) {
+ if ($fillString instanceof ChartColor) {
+ $this->fillColor[] = $fillString;
+ } else {
+ $this->fillColor[] = $this->stringToChartColor($fillString);
+ }
+ }
+ } elseif ($color instanceof ChartColor) {
+ $this->fillColor = $color;
+ } else {
+ $this->fillColor = $this->stringToChartColor($color);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Method for validating hex color.
+ *
+ * @param string $color value for color
+ *
+ * @return bool true if validation was successful
+ */
+ private function validateColor(string $color): bool
+ {
+ if (!preg_match('/^[a-f0-9]{6}$/i', $color)) {
+ throw new Exception(sprintf('Invalid hex color for chart series (color: "%s")', $color));
+ }
+
+ return true;
+ }
+
+ /**
+ * Get line width for series.
+ */
+ public function getLineWidth(): null|float|int
+ {
+ return $this->lineStyleProperties['width'];
+ }
+
+ /**
+ * Set line width for the series.
+ *
+ * @return $this
+ */
+ public function setLineWidth(null|float|int $width): static
+ {
+ $this->lineStyleProperties['width'] = $width;
+
+ return $this;
+ }
+
+ /**
+ * Identify if the Data Series is a multi-level or a simple series.
+ */
+ public function isMultiLevelSeries(): ?bool
+ {
+ if (!empty($this->dataValues)) {
+ return is_array(array_values($this->dataValues)[0]);
+ }
+
+ return null;
+ }
+
+ /**
+ * Return the level count of a multi-level Data Series.
+ */
+ public function multiLevelCount(): int
+ {
+ $levelCount = 0;
+ foreach (($this->dataValues ?? []) as $dataValueSet) {
+ $levelCount = max($levelCount, count($dataValueSet));
+ }
+
+ return $levelCount;
+ }
+
+ /**
+ * Get Series Data Values.
+ */
+ public function getDataValues(): ?array
+ {
+ return $this->dataValues;
+ }
+
+ /**
+ * Get the first Series Data value.
+ */
+ public function getDataValue(): mixed
+ {
+ if ($this->dataValues === null) {
+ return null;
+ }
+ $count = count($this->dataValues);
+ if ($count == 0) {
+ return null;
+ } elseif ($count == 1) {
+ return $this->dataValues[0];
+ }
+
+ return $this->dataValues;
+ }
+
+ /**
+ * Set Series Data Values.
+ *
+ * @return $this
+ */
+ public function setDataValues(array $dataValues): static
+ {
+ $this->dataValues = Functions::flattenArray($dataValues);
+ $this->pointCount = count($dataValues);
+
+ return $this;
+ }
+
+ public function refresh(Worksheet $worksheet, bool $flatten = true): void
+ {
+ if ($this->dataSource !== null) {
+ $calcEngine = Calculation::getInstance($worksheet->getParent());
+ $newDataValues = Calculation::unwrapResult(
+ $calcEngine->_calculateFormulaValue(
+ '=' . $this->dataSource,
+ null,
+ $worksheet->getCell('A1')
+ )
+ );
+ if ($flatten) {
+ $this->dataValues = Functions::flattenArray($newDataValues);
+ foreach ($this->dataValues as &$dataValue) {
+ if (is_string($dataValue) && !empty($dataValue) && $dataValue[0] == '#') {
+ $dataValue = 0.0;
+ }
+ }
+ unset($dataValue);
+ } else {
+ [$worksheet, $cellRange] = Worksheet::extractSheetTitle($this->dataSource, true);
+ $dimensions = Coordinate::rangeDimension(str_replace('$', '', $cellRange ?? ''));
+ if (($dimensions[0] == 1) || ($dimensions[1] == 1)) {
+ $this->dataValues = Functions::flattenArray($newDataValues);
+ } else {
+ /** @var array */
+ $newDataValuesx = $newDataValues;
+ $newArray = array_values(array_shift($newDataValuesx) ?? []);
+ foreach ($newArray as $i => $newDataSet) {
+ $newArray[$i] = [$newDataSet];
+ }
+
+ foreach ($newDataValuesx as $newDataSet) {
+ $i = 0;
+ foreach ($newDataSet as $newDataVal) {
+ array_unshift($newArray[$i++], $newDataVal);
+ }
+ }
+ $this->dataValues = $newArray;
+ }
+ }
+ $this->pointCount = count($this->dataValues);
+ }
+ }
+
+ public function getScatterLines(): bool
+ {
+ return $this->scatterLines;
+ }
+
+ public function setScatterLines(bool $scatterLines): self
+ {
+ $this->scatterLines = $scatterLines;
+
+ return $this;
+ }
+
+ public function getBubble3D(): bool
+ {
+ return $this->bubble3D;
+ }
+
+ public function setBubble3D(bool $bubble3D): self
+ {
+ $this->bubble3D = $bubble3D;
+
+ return $this;
+ }
+
+ /**
+ * Smooth Line. Must be specified for both DataSeries and DataSeriesValues.
+ */
+ private bool $smoothLine = false;
+
+ /**
+ * Get Smooth Line.
+ */
+ public function getSmoothLine(): bool
+ {
+ return $this->smoothLine;
+ }
+
+ /**
+ * Set Smooth Line.
+ *
+ * @return $this
+ */
+ public function setSmoothLine(bool $smoothLine): static
+ {
+ $this->smoothLine = $smoothLine;
+
+ return $this;
+ }
+
+ public function getLabelLayout(): ?Layout
+ {
+ return $this->labelLayout;
+ }
+
+ public function setLabelLayout(?Layout $labelLayout): self
+ {
+ $this->labelLayout = $labelLayout;
+
+ return $this;
+ }
+
+ public function setTrendLines(array $trendLines): self
+ {
+ $this->trendLines = $trendLines;
+
+ return $this;
+ }
+
+ public function getTrendLines(): array
+ {
+ return $this->trendLines;
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ parent::__clone();
+ $this->markerFillColor = clone $this->markerFillColor;
+ $this->markerBorderColor = clone $this->markerBorderColor;
+ if (is_array($this->fillColor)) {
+ $fillColor = $this->fillColor;
+ $this->fillColor = [];
+ foreach ($fillColor as $color) {
+ $this->fillColor[] = clone $color;
+ }
+ } elseif ($this->fillColor instanceof ChartColor) {
+ $this->fillColor = clone $this->fillColor;
+ }
+ $this->labelLayout = ($this->labelLayout === null) ? null : clone $this->labelLayout;
+ $trendLines = $this->trendLines;
+ $this->trendLines = [];
+ foreach ($trendLines as $trendLine) {
+ $this->trendLines[] = clone $trendLine;
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Exception.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Exception.php
new file mode 100644
index 00000000..3f95b599
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Exception.php
@@ -0,0 +1,9 @@
+layoutTarget = $layout['layoutTarget'];
+ }
+ if (isset($layout['xMode'])) {
+ $this->xMode = $layout['xMode'];
+ }
+ if (isset($layout['yMode'])) {
+ $this->yMode = $layout['yMode'];
+ }
+ if (isset($layout['x'])) {
+ $this->xPos = (float) $layout['x'];
+ }
+ if (isset($layout['y'])) {
+ $this->yPos = (float) $layout['y'];
+ }
+ if (isset($layout['w'])) {
+ $this->width = (float) $layout['w'];
+ }
+ if (isset($layout['h'])) {
+ $this->height = (float) $layout['h'];
+ }
+ if (isset($layout['dLblPos'])) {
+ $this->dLblPos = (string) $layout['dLblPos'];
+ }
+ if (isset($layout['numFmtCode'])) {
+ $this->numFmtCode = (string) $layout['numFmtCode'];
+ }
+ $this->initBoolean($layout, 'showLegendKey');
+ $this->initBoolean($layout, 'showVal');
+ $this->initBoolean($layout, 'showCatName');
+ $this->initBoolean($layout, 'showSerName');
+ $this->initBoolean($layout, 'showPercent');
+ $this->initBoolean($layout, 'showBubbleSize');
+ $this->initBoolean($layout, 'showLeaderLines');
+ $this->initBoolean($layout, 'numFmtLinked');
+ $this->initColor($layout, 'labelFillColor');
+ $this->initColor($layout, 'labelBorderColor');
+ $labelFont = $layout['labelFont'] ?? null;
+ if ($labelFont instanceof Font) {
+ $this->labelFont = $labelFont;
+ }
+ $labelFontColor = $layout['labelFontColor'] ?? null;
+ if ($labelFontColor instanceof ChartColor) {
+ $this->setLabelFontColor($labelFontColor);
+ }
+ $labelEffects = $layout['labelEffects'] ?? null;
+ if ($labelEffects instanceof Properties) {
+ $this->labelEffects = $labelEffects;
+ }
+ }
+
+ private function initBoolean(array $layout, string $name): void
+ {
+ if (isset($layout[$name])) {
+ $this->$name = (bool) $layout[$name];
+ }
+ }
+
+ private function initColor(array $layout, string $name): void
+ {
+ if (isset($layout[$name]) && $layout[$name] instanceof ChartColor) {
+ $this->$name = $layout[$name];
+ }
+ }
+
+ /**
+ * Get Layout Target.
+ */
+ public function getLayoutTarget(): ?string
+ {
+ return $this->layoutTarget;
+ }
+
+ /**
+ * Set Layout Target.
+ *
+ * @return $this
+ */
+ public function setLayoutTarget(?string $target): static
+ {
+ $this->layoutTarget = $target;
+
+ return $this;
+ }
+
+ /**
+ * Get X-Mode.
+ */
+ public function getXMode(): ?string
+ {
+ return $this->xMode;
+ }
+
+ /**
+ * Set X-Mode.
+ *
+ * @return $this
+ */
+ public function setXMode(?string $mode): static
+ {
+ $this->xMode = (string) $mode;
+
+ return $this;
+ }
+
+ /**
+ * Get Y-Mode.
+ */
+ public function getYMode(): ?string
+ {
+ return $this->yMode;
+ }
+
+ /**
+ * Set Y-Mode.
+ *
+ * @return $this
+ */
+ public function setYMode(?string $mode): static
+ {
+ $this->yMode = (string) $mode;
+
+ return $this;
+ }
+
+ /**
+ * Get X-Position.
+ */
+ public function getXPosition(): null|float|int
+ {
+ return $this->xPos;
+ }
+
+ /**
+ * Set X-Position.
+ *
+ * @return $this
+ */
+ public function setXPosition(float $position): static
+ {
+ $this->xPos = $position;
+
+ return $this;
+ }
+
+ /**
+ * Get Y-Position.
+ */
+ public function getYPosition(): ?float
+ {
+ return $this->yPos;
+ }
+
+ /**
+ * Set Y-Position.
+ *
+ * @return $this
+ */
+ public function setYPosition(float $position): static
+ {
+ $this->yPos = $position;
+
+ return $this;
+ }
+
+ /**
+ * Get Width.
+ */
+ public function getWidth(): ?float
+ {
+ return $this->width;
+ }
+
+ /**
+ * Set Width.
+ *
+ * @return $this
+ */
+ public function setWidth(?float $width): static
+ {
+ $this->width = $width;
+
+ return $this;
+ }
+
+ /**
+ * Get Height.
+ */
+ public function getHeight(): ?float
+ {
+ return $this->height;
+ }
+
+ /**
+ * Set Height.
+ *
+ * @return $this
+ */
+ public function setHeight(?float $height): static
+ {
+ $this->height = $height;
+
+ return $this;
+ }
+
+ public function getShowLegendKey(): ?bool
+ {
+ return $this->showLegendKey;
+ }
+
+ /**
+ * Set show legend key
+ * Specifies that legend keys should be shown in data labels.
+ */
+ public function setShowLegendKey(?bool $showLegendKey): self
+ {
+ $this->showLegendKey = $showLegendKey;
+
+ return $this;
+ }
+
+ public function getShowVal(): ?bool
+ {
+ return $this->showVal;
+ }
+
+ /**
+ * Set show val
+ * Specifies that the value should be shown in data labels.
+ */
+ public function setShowVal(?bool $showDataLabelValues): self
+ {
+ $this->showVal = $showDataLabelValues;
+
+ return $this;
+ }
+
+ public function getShowCatName(): ?bool
+ {
+ return $this->showCatName;
+ }
+
+ /**
+ * Set show cat name
+ * Specifies that the category name should be shown in data labels.
+ */
+ public function setShowCatName(?bool $showCategoryName): self
+ {
+ $this->showCatName = $showCategoryName;
+
+ return $this;
+ }
+
+ public function getShowSerName(): ?bool
+ {
+ return $this->showSerName;
+ }
+
+ /**
+ * Set show data series name.
+ * Specifies that the series name should be shown in data labels.
+ */
+ public function setShowSerName(?bool $showSeriesName): self
+ {
+ $this->showSerName = $showSeriesName;
+
+ return $this;
+ }
+
+ public function getShowPercent(): ?bool
+ {
+ return $this->showPercent;
+ }
+
+ /**
+ * Set show percentage.
+ * Specifies that the percentage should be shown in data labels.
+ */
+ public function setShowPercent(?bool $showPercentage): self
+ {
+ $this->showPercent = $showPercentage;
+
+ return $this;
+ }
+
+ public function getShowBubbleSize(): ?bool
+ {
+ return $this->showBubbleSize;
+ }
+
+ /**
+ * Set show bubble size.
+ * Specifies that the bubble size should be shown in data labels.
+ */
+ public function setShowBubbleSize(?bool $showBubbleSize): self
+ {
+ $this->showBubbleSize = $showBubbleSize;
+
+ return $this;
+ }
+
+ public function getShowLeaderLines(): ?bool
+ {
+ return $this->showLeaderLines;
+ }
+
+ /**
+ * Set show leader lines.
+ * Specifies that leader lines should be shown in data labels.
+ */
+ public function setShowLeaderLines(?bool $showLeaderLines): self
+ {
+ $this->showLeaderLines = $showLeaderLines;
+
+ return $this;
+ }
+
+ public function getLabelFillColor(): ?ChartColor
+ {
+ return $this->labelFillColor;
+ }
+
+ public function setLabelFillColor(?ChartColor $chartColor): self
+ {
+ $this->labelFillColor = $chartColor;
+
+ return $this;
+ }
+
+ public function getLabelBorderColor(): ?ChartColor
+ {
+ return $this->labelBorderColor;
+ }
+
+ public function setLabelBorderColor(?ChartColor $chartColor): self
+ {
+ $this->labelBorderColor = $chartColor;
+
+ return $this;
+ }
+
+ public function getLabelFont(): ?Font
+ {
+ return $this->labelFont;
+ }
+
+ public function getLabelEffects(): ?Properties
+ {
+ return $this->labelEffects;
+ }
+
+ public function getLabelFontColor(): ?ChartColor
+ {
+ if ($this->labelFont === null) {
+ return null;
+ }
+
+ return $this->labelFont->getChartColor();
+ }
+
+ public function setLabelFontColor(?ChartColor $chartColor): self
+ {
+ if ($this->labelFont === null) {
+ $this->labelFont = new Font();
+ $this->labelFont->setSize(null, true);
+ }
+ $this->labelFont->setChartColorFromObject($chartColor);
+
+ return $this;
+ }
+
+ public function getDLblPos(): string
+ {
+ return $this->dLblPos;
+ }
+
+ public function setDLblPos(string $dLblPos): self
+ {
+ $this->dLblPos = $dLblPos;
+
+ return $this;
+ }
+
+ public function getNumFmtCode(): string
+ {
+ return $this->numFmtCode;
+ }
+
+ public function setNumFmtCode(string $numFmtCode): self
+ {
+ $this->numFmtCode = $numFmtCode;
+
+ return $this;
+ }
+
+ public function getNumFmtLinked(): bool
+ {
+ return $this->numFmtLinked;
+ }
+
+ public function setNumFmtLinked(bool $numFmtLinked): self
+ {
+ $this->numFmtLinked = $numFmtLinked;
+
+ return $this;
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $this->labelFillColor = ($this->labelFillColor === null) ? null : clone $this->labelFillColor;
+ $this->labelBorderColor = ($this->labelBorderColor === null) ? null : clone $this->labelBorderColor;
+ $this->labelFont = ($this->labelFont === null) ? null : clone $this->labelFont;
+ $this->labelEffects = ($this->labelEffects === null) ? null : clone $this->labelEffects;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Legend.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Legend.php
new file mode 100644
index 00000000..7736fb7a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Legend.php
@@ -0,0 +1,174 @@
+ self::POSITION_BOTTOM,
+ self::XL_LEGEND_POSITION_CORNER => self::POSITION_TOPRIGHT,
+ self::XL_LEGEND_POSITION_CUSTOM => '??',
+ self::XL_LEGEND_POSITION_LEFT => self::POSITION_LEFT,
+ self::XL_LEGEND_POSITION_RIGHT => self::POSITION_RIGHT,
+ self::XL_LEGEND_POSITION_TOP => self::POSITION_TOP,
+ ];
+
+ /**
+ * Legend position.
+ */
+ private string $position = self::POSITION_RIGHT;
+
+ /**
+ * Allow overlay of other elements?
+ */
+ private bool $overlay = true;
+
+ /**
+ * Legend Layout.
+ */
+ private ?Layout $layout;
+
+ private GridLines $borderLines;
+
+ private ChartColor $fillColor;
+
+ private ?AxisText $legendText = null;
+
+ /**
+ * Create a new Legend.
+ */
+ public function __construct(string $position = self::POSITION_RIGHT, ?Layout $layout = null, bool $overlay = false)
+ {
+ $this->setPosition($position);
+ $this->layout = $layout;
+ $this->setOverlay($overlay);
+ $this->borderLines = new GridLines();
+ $this->fillColor = new ChartColor();
+ }
+
+ public function getFillColor(): ChartColor
+ {
+ return $this->fillColor;
+ }
+
+ /**
+ * Get legend position as an excel string value.
+ */
+ public function getPosition(): string
+ {
+ return $this->position;
+ }
+
+ /**
+ * Get legend position using an excel string value.
+ *
+ * @param string $position see self::POSITION_*
+ */
+ public function setPosition(string $position): bool
+ {
+ if (!in_array($position, self::POSITION_XLREF)) {
+ return false;
+ }
+
+ $this->position = $position;
+
+ return true;
+ }
+
+ /**
+ * Get legend position as an Excel internal numeric value.
+ */
+ public function getPositionXL(): false|int
+ {
+ return array_search($this->position, self::POSITION_XLREF);
+ }
+
+ /**
+ * Set legend position using an Excel internal numeric value.
+ *
+ * @param int $positionXL see self::XL_LEGEND_POSITION_*
+ */
+ public function setPositionXL(int $positionXL): bool
+ {
+ if (!isset(self::POSITION_XLREF[$positionXL])) {
+ return false;
+ }
+
+ $this->position = self::POSITION_XLREF[$positionXL];
+
+ return true;
+ }
+
+ /**
+ * Get allow overlay of other elements?
+ */
+ public function getOverlay(): bool
+ {
+ return $this->overlay;
+ }
+
+ /**
+ * Set allow overlay of other elements?
+ */
+ public function setOverlay(bool $overlay): void
+ {
+ $this->overlay = $overlay;
+ }
+
+ /**
+ * Get Layout.
+ */
+ public function getLayout(): ?Layout
+ {
+ return $this->layout;
+ }
+
+ public function getLegendText(): ?AxisText
+ {
+ return $this->legendText;
+ }
+
+ public function setLegendText(?AxisText $legendText): self
+ {
+ $this->legendText = $legendText;
+
+ return $this;
+ }
+
+ public function getBorderLines(): GridLines
+ {
+ return $this->borderLines;
+ }
+
+ public function setBorderLines(GridLines $borderLines): self
+ {
+ $this->borderLines = $borderLines;
+
+ return $this;
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $this->layout = ($this->layout === null) ? null : clone $this->layout;
+ $this->legendText = ($this->legendText === null) ? null : clone $this->legendText;
+ $this->borderLines = clone $this->borderLines;
+ $this->fillColor = clone $this->fillColor;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/PlotArea.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/PlotArea.php
new file mode 100644
index 00000000..228afad4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/PlotArea.php
@@ -0,0 +1,207 @@
+layout = $layout;
+ $this->plotSeries = $plotSeries;
+ }
+
+ public function getLayout(): ?Layout
+ {
+ return $this->layout;
+ }
+
+ /**
+ * Get Number of Plot Groups.
+ */
+ public function getPlotGroupCount(): int
+ {
+ return count($this->plotSeries);
+ }
+
+ /**
+ * Get Number of Plot Series.
+ */
+ public function getPlotSeriesCount(): int|float
+ {
+ $seriesCount = 0;
+ foreach ($this->plotSeries as $plot) {
+ $seriesCount += $plot->getPlotSeriesCount();
+ }
+
+ return $seriesCount;
+ }
+
+ /**
+ * Get Plot Series.
+ *
+ * @return DataSeries[]
+ */
+ public function getPlotGroup(): array
+ {
+ return $this->plotSeries;
+ }
+
+ /**
+ * Get Plot Series by Index.
+ */
+ public function getPlotGroupByIndex(int $index): DataSeries
+ {
+ return $this->plotSeries[$index];
+ }
+
+ /**
+ * Set Plot Series.
+ *
+ * @param DataSeries[] $plotSeries
+ *
+ * @return $this
+ */
+ public function setPlotSeries(array $plotSeries): static
+ {
+ $this->plotSeries = $plotSeries;
+
+ return $this;
+ }
+
+ public function refresh(Worksheet $worksheet): void
+ {
+ foreach ($this->plotSeries as $plotSeries) {
+ $plotSeries->refresh($worksheet);
+ }
+ }
+
+ public function setNoFill(bool $noFill): self
+ {
+ $this->noFill = $noFill;
+
+ return $this;
+ }
+
+ public function getNoFill(): bool
+ {
+ return $this->noFill;
+ }
+
+ public function setGradientFillProperties(array $gradientFillStops, ?float $gradientFillAngle): self
+ {
+ $this->gradientFillStops = $gradientFillStops;
+ $this->gradientFillAngle = $gradientFillAngle;
+
+ return $this;
+ }
+
+ /**
+ * Get gradientFillAngle.
+ */
+ public function getGradientFillAngle(): ?float
+ {
+ return $this->gradientFillAngle;
+ }
+
+ /**
+ * Get gradientFillStops.
+ */
+ public function getGradientFillStops(): array
+ {
+ return $this->gradientFillStops;
+ }
+
+ private ?int $gapWidth = null;
+
+ private bool $useUpBars = false;
+
+ private bool $useDownBars = false;
+
+ public function getGapWidth(): ?int
+ {
+ return $this->gapWidth;
+ }
+
+ public function setGapWidth(?int $gapWidth): self
+ {
+ $this->gapWidth = $gapWidth;
+
+ return $this;
+ }
+
+ public function getUseUpBars(): bool
+ {
+ return $this->useUpBars;
+ }
+
+ public function setUseUpBars(bool $useUpBars): self
+ {
+ $this->useUpBars = $useUpBars;
+
+ return $this;
+ }
+
+ public function getUseDownBars(): bool
+ {
+ return $this->useDownBars;
+ }
+
+ public function setUseDownBars(bool $useDownBars): self
+ {
+ $this->useDownBars = $useDownBars;
+
+ return $this;
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $this->layout = ($this->layout === null) ? null : clone $this->layout;
+ $plotSeries = $this->plotSeries;
+ $this->plotSeries = [];
+ foreach ($plotSeries as $series) {
+ $this->plotSeries[] = clone $series;
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Properties.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Properties.php
new file mode 100644
index 00000000..3e02a964
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Properties.php
@@ -0,0 +1,900 @@
+ null,
+ ];
+
+ protected array $shadowProperties = self::PRESETS_OPTIONS[0];
+
+ protected ChartColor $shadowColor;
+
+ public function __construct()
+ {
+ $this->lineColor = new ChartColor();
+ $this->glowColor = new ChartColor();
+ $this->shadowColor = new ChartColor();
+ $this->shadowColor->setType(ChartColor::EXCEL_COLOR_TYPE_STANDARD);
+ $this->shadowColor->setValue('black');
+ $this->shadowColor->setAlpha(40);
+ }
+
+ /**
+ * Get Object State.
+ */
+ public function getObjectState(): bool
+ {
+ return $this->objectState;
+ }
+
+ /**
+ * Change Object State to True.
+ *
+ * @return $this
+ */
+ public function activateObject()
+ {
+ $this->objectState = true;
+
+ return $this;
+ }
+
+ public static function pointsToXml(float $width): string
+ {
+ return (string) (int) ($width * self::POINTS_WIDTH_MULTIPLIER);
+ }
+
+ public static function xmlToPoints(string $width): float
+ {
+ return ((float) $width) / self::POINTS_WIDTH_MULTIPLIER;
+ }
+
+ public static function angleToXml(float $angle): string
+ {
+ return (string) (int) ($angle * self::ANGLE_MULTIPLIER);
+ }
+
+ public static function xmlToAngle(string $angle): float
+ {
+ return ((float) $angle) / self::ANGLE_MULTIPLIER;
+ }
+
+ public static function tenthOfPercentToXml(float $value): string
+ {
+ return (string) (int) ($value * self::PERCENTAGE_MULTIPLIER);
+ }
+
+ public static function xmlToTenthOfPercent(string $value): float
+ {
+ return ((float) $value) / self::PERCENTAGE_MULTIPLIER;
+ }
+
+ protected function setColorProperties(?string $color, null|float|int|string $alpha, ?string $colorType): array
+ {
+ return [
+ 'type' => $colorType,
+ 'value' => $color,
+ 'alpha' => ($alpha === null) ? null : (int) $alpha,
+ ];
+ }
+
+ protected const PRESETS_OPTIONS = [
+ //NONE
+ 0 => [
+ 'presets' => self::SHADOW_PRESETS_NOSHADOW,
+ 'effect' => null,
+ //'color' => [
+ // 'type' => ChartColor::EXCEL_COLOR_TYPE_STANDARD,
+ // 'value' => 'black',
+ // 'alpha' => 40,
+ //],
+ 'size' => [
+ 'sx' => null,
+ 'sy' => null,
+ 'kx' => null,
+ 'ky' => null,
+ ],
+ 'blur' => null,
+ 'direction' => null,
+ 'distance' => null,
+ 'algn' => null,
+ 'rotWithShape' => null,
+ ],
+ //OUTER
+ 1 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 38100 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 2700000 / self::ANGLE_MULTIPLIER,
+ 'algn' => 'tl',
+ 'rotWithShape' => '0',
+ ],
+ 2 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 38100 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 5400000 / self::ANGLE_MULTIPLIER,
+ 'algn' => 't',
+ 'rotWithShape' => '0',
+ ],
+ 3 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 38100 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 8100000 / self::ANGLE_MULTIPLIER,
+ 'algn' => 'tr',
+ 'rotWithShape' => '0',
+ ],
+ 4 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 38100 / self::POINTS_WIDTH_MULTIPLIER,
+ 'algn' => 'l',
+ 'rotWithShape' => '0',
+ ],
+ 5 => [
+ 'effect' => 'outerShdw',
+ 'size' => [
+ 'sx' => 102000 / self::PERCENTAGE_MULTIPLIER,
+ 'sy' => 102000 / self::PERCENTAGE_MULTIPLIER,
+ ],
+ 'blur' => 63500 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 38100 / self::POINTS_WIDTH_MULTIPLIER,
+ 'algn' => 'ctr',
+ 'rotWithShape' => '0',
+ ],
+ 6 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 38100 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 10800000 / self::ANGLE_MULTIPLIER,
+ 'algn' => 'r',
+ 'rotWithShape' => '0',
+ ],
+ 7 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 38100 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 18900000 / self::ANGLE_MULTIPLIER,
+ 'algn' => 'bl',
+ 'rotWithShape' => '0',
+ ],
+ 8 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 38100 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 16200000 / self::ANGLE_MULTIPLIER,
+ 'rotWithShape' => '0',
+ ],
+ 9 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 38100 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 13500000 / self::ANGLE_MULTIPLIER,
+ 'algn' => 'br',
+ 'rotWithShape' => '0',
+ ],
+ //INNER
+ 10 => [
+ 'effect' => 'innerShdw',
+ 'blur' => 63500 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 2700000 / self::ANGLE_MULTIPLIER,
+ ],
+ 11 => [
+ 'effect' => 'innerShdw',
+ 'blur' => 63500 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 5400000 / self::ANGLE_MULTIPLIER,
+ ],
+ 12 => [
+ 'effect' => 'innerShdw',
+ 'blur' => 63500 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 8100000 / self::ANGLE_MULTIPLIER,
+ ],
+ 13 => [
+ 'effect' => 'innerShdw',
+ 'blur' => 63500 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ ],
+ 14 => [
+ 'effect' => 'innerShdw',
+ 'blur' => 114300 / self::POINTS_WIDTH_MULTIPLIER,
+ ],
+ 15 => [
+ 'effect' => 'innerShdw',
+ 'blur' => 63500 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 10800000 / self::ANGLE_MULTIPLIER,
+ ],
+ 16 => [
+ 'effect' => 'innerShdw',
+ 'blur' => 63500 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 18900000 / self::ANGLE_MULTIPLIER,
+ ],
+ 17 => [
+ 'effect' => 'innerShdw',
+ 'blur' => 63500 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 16200000 / self::ANGLE_MULTIPLIER,
+ ],
+ 18 => [
+ 'effect' => 'innerShdw',
+ 'blur' => 63500 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 50800 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 13500000 / self::ANGLE_MULTIPLIER,
+ ],
+ //perspective
+ 19 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 152400 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 317500 / self::POINTS_WIDTH_MULTIPLIER,
+ 'size' => [
+ 'sx' => 90000 / self::PERCENTAGE_MULTIPLIER,
+ 'sy' => -19000 / self::PERCENTAGE_MULTIPLIER,
+ ],
+ 'direction' => 5400000 / self::ANGLE_MULTIPLIER,
+ 'rotWithShape' => '0',
+ ],
+ 20 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 76200 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 18900000 / self::ANGLE_MULTIPLIER,
+ 'size' => [
+ 'sy' => 23000 / self::PERCENTAGE_MULTIPLIER,
+ 'kx' => -1200000 / self::ANGLE_MULTIPLIER,
+ ],
+ 'algn' => 'bl',
+ 'rotWithShape' => '0',
+ ],
+ 21 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 76200 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 13500000 / self::ANGLE_MULTIPLIER,
+ 'size' => [
+ 'sy' => 23000 / self::PERCENTAGE_MULTIPLIER,
+ 'kx' => 1200000 / self::ANGLE_MULTIPLIER,
+ ],
+ 'algn' => 'br',
+ 'rotWithShape' => '0',
+ ],
+ 22 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 76200 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 12700 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 2700000 / self::ANGLE_MULTIPLIER,
+ 'size' => [
+ 'sy' => -23000 / self::PERCENTAGE_MULTIPLIER,
+ 'kx' => -800400 / self::ANGLE_MULTIPLIER,
+ ],
+ 'algn' => 'bl',
+ 'rotWithShape' => '0',
+ ],
+ 23 => [
+ 'effect' => 'outerShdw',
+ 'blur' => 76200 / self::POINTS_WIDTH_MULTIPLIER,
+ 'distance' => 12700 / self::POINTS_WIDTH_MULTIPLIER,
+ 'direction' => 8100000 / self::ANGLE_MULTIPLIER,
+ 'size' => [
+ 'sy' => -23000 / self::PERCENTAGE_MULTIPLIER,
+ 'kx' => 800400 / self::ANGLE_MULTIPLIER,
+ ],
+ 'algn' => 'br',
+ 'rotWithShape' => '0',
+ ],
+ ];
+
+ protected function getShadowPresetsMap(int $presetsOption): array
+ {
+ return self::PRESETS_OPTIONS[$presetsOption] ?? self::PRESETS_OPTIONS[0];
+ }
+
+ /**
+ * Get value of array element.
+ */
+ protected function getArrayElementsValue(array $properties, array|int|string $elements): mixed
+ {
+ $reference = &$properties;
+ if (!is_array($elements)) {
+ return $reference[$elements];
+ }
+
+ foreach ($elements as $keys) {
+ $reference = &$reference[$keys];
+ }
+
+ return $reference;
+ }
+
+ /**
+ * Set Glow Properties.
+ */
+ public function setGlowProperties(float $size, ?string $colorValue = null, ?int $colorAlpha = null, ?string $colorType = null): void
+ {
+ $this
+ ->activateObject()
+ ->setGlowSize($size);
+ $this->glowColor->setColorPropertiesArray(
+ [
+ 'value' => $colorValue,
+ 'type' => $colorType,
+ 'alpha' => $colorAlpha,
+ ]
+ );
+ }
+
+ /**
+ * Get Glow Property.
+ */
+ public function getGlowProperty(array|string $property): null|array|float|int|string
+ {
+ $retVal = null;
+ if ($property === 'size') {
+ $retVal = $this->glowSize;
+ } elseif ($property === 'color') {
+ $retVal = [
+ 'value' => $this->glowColor->getColorProperty('value'),
+ 'type' => $this->glowColor->getColorProperty('type'),
+ 'alpha' => $this->glowColor->getColorProperty('alpha'),
+ ];
+ } elseif (is_array($property) && count($property) >= 2 && $property[0] === 'color') {
+ $retVal = $this->glowColor->getColorProperty($property[1]);
+ }
+
+ return $retVal;
+ }
+
+ /**
+ * Get Glow Color Property.
+ */
+ public function getGlowColor(string $propertyName): null|int|string
+ {
+ return $this->glowColor->getColorProperty($propertyName);
+ }
+
+ public function getGlowColorObject(): ChartColor
+ {
+ return $this->glowColor;
+ }
+
+ /**
+ * Get Glow Size.
+ */
+ public function getGlowSize(): ?float
+ {
+ return $this->glowSize;
+ }
+
+ /**
+ * Set Glow Size.
+ *
+ * @return $this
+ */
+ protected function setGlowSize(?float $size)
+ {
+ $this->glowSize = $size;
+
+ return $this;
+ }
+
+ /**
+ * Set Soft Edges Size.
+ */
+ public function setSoftEdges(?float $size): void
+ {
+ if ($size !== null) {
+ $this->activateObject();
+ $this->softEdges['size'] = $size;
+ }
+ }
+
+ /**
+ * Get Soft Edges Size.
+ */
+ public function getSoftEdgesSize(): ?float
+ {
+ return $this->softEdges['size'];
+ }
+
+ public function setShadowProperty(string $propertyName, mixed $value): self
+ {
+ $this->activateObject();
+ if ($propertyName === 'color' && is_array($value)) {
+ $this->shadowColor->setColorPropertiesArray($value);
+ } else {
+ $this->shadowProperties[$propertyName] = $value;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set Shadow Properties.
+ */
+ public function setShadowProperties(int $presets, ?string $colorValue = null, ?string $colorType = null, null|float|int|string $colorAlpha = null, ?float $blur = null, ?int $angle = null, ?float $distance = null): void
+ {
+ $this->activateObject()->setShadowPresetsProperties((int) $presets);
+ if ($presets === 0) {
+ $this->shadowColor->setType(ChartColor::EXCEL_COLOR_TYPE_STANDARD);
+ $this->shadowColor->setValue('black');
+ $this->shadowColor->setAlpha(40);
+ }
+ if ($colorValue !== null) {
+ $this->shadowColor->setValue($colorValue);
+ }
+ if ($colorType !== null) {
+ $this->shadowColor->setType($colorType);
+ }
+ if (is_numeric($colorAlpha)) {
+ $this->shadowColor->setAlpha((int) $colorAlpha);
+ }
+ $this
+ ->setShadowBlur($blur)
+ ->setShadowAngle($angle)
+ ->setShadowDistance($distance);
+ }
+
+ /**
+ * Set Shadow Presets Properties.
+ *
+ * @return $this
+ */
+ protected function setShadowPresetsProperties(int $presets)
+ {
+ $this->shadowProperties['presets'] = $presets;
+ $this->setShadowPropertiesMapValues($this->getShadowPresetsMap($presets));
+
+ return $this;
+ }
+
+ protected const SHADOW_ARRAY_KEYS = ['size', 'color'];
+
+ /**
+ * Set Shadow Properties Values.
+ *
+ * @return $this
+ */
+ protected function setShadowPropertiesMapValues(array $propertiesMap, ?array &$reference = null)
+ {
+ $base_reference = $reference;
+ foreach ($propertiesMap as $property_key => $property_val) {
+ if (is_array($property_val)) {
+ if (in_array($property_key, self::SHADOW_ARRAY_KEYS, true)) {
+ $reference = &$this->shadowProperties[$property_key];
+ $this->setShadowPropertiesMapValues($property_val, $reference);
+ }
+ } else {
+ if ($base_reference === null) {
+ $this->shadowProperties[$property_key] = $property_val;
+ } else {
+ $reference[$property_key] = $property_val;
+ }
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set Shadow Blur.
+ *
+ * @return $this
+ */
+ protected function setShadowBlur(?float $blur)
+ {
+ if ($blur !== null) {
+ $this->shadowProperties['blur'] = $blur;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set Shadow Angle.
+ *
+ * @return $this
+ */
+ protected function setShadowAngle(null|float|int|string $angle)
+ {
+ if (is_numeric($angle)) {
+ $this->shadowProperties['direction'] = $angle;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set Shadow Distance.
+ *
+ * @return $this
+ */
+ protected function setShadowDistance(?float $distance)
+ {
+ if ($distance !== null) {
+ $this->shadowProperties['distance'] = $distance;
+ }
+
+ return $this;
+ }
+
+ public function getShadowColorObject(): ChartColor
+ {
+ return $this->shadowColor;
+ }
+
+ /**
+ * Get Shadow Property.
+ *
+ * @param string|string[] $elements
+ */
+ public function getShadowProperty($elements): array|string|null
+ {
+ if ($elements === 'color') {
+ return [
+ 'value' => $this->shadowColor->getValue(),
+ 'type' => $this->shadowColor->getType(),
+ 'alpha' => $this->shadowColor->getAlpha(),
+ ];
+ }
+ $retVal = $this->getArrayElementsValue($this->shadowProperties, $elements);
+ if (is_scalar($retVal)) {
+ $retVal = (string) $retVal;
+ } elseif ($retVal !== null && !is_array($retVal)) {
+ // @codeCoverageIgnoreStart
+ throw new Exception('Unexpected value for shadowProperty');
+ // @codeCoverageIgnoreEnd
+ }
+
+ return $retVal;
+ }
+
+ public function getShadowArray(): array
+ {
+ $array = $this->shadowProperties;
+ if ($this->getShadowColorObject()->isUsable()) {
+ $array['color'] = $this->getShadowProperty('color');
+ }
+
+ return $array;
+ }
+
+ protected ChartColor $lineColor;
+
+ protected array $lineStyleProperties = [
+ 'width' => null, //'9525',
+ 'compound' => '', //self::LINE_STYLE_COMPOUND_SIMPLE,
+ 'dash' => '', //self::LINE_STYLE_DASH_SOLID,
+ 'cap' => '', //self::LINE_STYLE_CAP_FLAT,
+ 'join' => '', //self::LINE_STYLE_JOIN_BEVEL,
+ 'arrow' => [
+ 'head' => [
+ 'type' => '', //self::LINE_STYLE_ARROW_TYPE_NOARROW,
+ 'size' => '', //self::LINE_STYLE_ARROW_SIZE_5,
+ 'w' => '',
+ 'len' => '',
+ ],
+ 'end' => [
+ 'type' => '', //self::LINE_STYLE_ARROW_TYPE_NOARROW,
+ 'size' => '', //self::LINE_STYLE_ARROW_SIZE_8,
+ 'w' => '',
+ 'len' => '',
+ ],
+ ],
+ ];
+
+ public function copyLineStyles(self $otherProperties): void
+ {
+ $this->lineStyleProperties = $otherProperties->lineStyleProperties;
+ $this->lineColor = $otherProperties->lineColor;
+ $this->glowSize = $otherProperties->glowSize;
+ $this->glowColor = $otherProperties->glowColor;
+ $this->softEdges = $otherProperties->softEdges;
+ $this->shadowProperties = $otherProperties->shadowProperties;
+ }
+
+ public function getLineColor(): ChartColor
+ {
+ return $this->lineColor;
+ }
+
+ /**
+ * Set Line Color Properties.
+ */
+ public function setLineColorProperties(?string $value, ?int $alpha = null, ?string $colorType = null): void
+ {
+ $this->activateObject();
+ $this->lineColor->setColorPropertiesArray(
+ $this->setColorProperties(
+ $value,
+ $alpha,
+ $colorType
+ )
+ );
+ }
+
+ /**
+ * Get Line Color Property.
+ */
+ public function getLineColorProperty(string $propertyName): null|int|string
+ {
+ return $this->lineColor->getColorProperty($propertyName);
+ }
+
+ /**
+ * Set Line Style Properties.
+ */
+ public function setLineStyleProperties(
+ null|float|int|string $lineWidth = null,
+ ?string $compoundType = '',
+ ?string $dashType = '',
+ ?string $capType = '',
+ ?string $joinType = '',
+ ?string $headArrowType = '',
+ int $headArrowSize = 0,
+ ?string $endArrowType = '',
+ int $endArrowSize = 0,
+ ?string $headArrowWidth = '',
+ ?string $headArrowLength = '',
+ ?string $endArrowWidth = '',
+ ?string $endArrowLength = ''
+ ): void {
+ $this->activateObject();
+ if (is_numeric($lineWidth)) {
+ $this->lineStyleProperties['width'] = $lineWidth;
+ }
+ if ($compoundType !== '') {
+ $this->lineStyleProperties['compound'] = $compoundType;
+ }
+ if ($dashType !== '') {
+ $this->lineStyleProperties['dash'] = $dashType;
+ }
+ if ($capType !== '') {
+ $this->lineStyleProperties['cap'] = $capType;
+ }
+ if ($joinType !== '') {
+ $this->lineStyleProperties['join'] = $joinType;
+ }
+ if ($headArrowType !== '') {
+ $this->lineStyleProperties['arrow']['head']['type'] = $headArrowType;
+ }
+ if (isset(self::ARROW_SIZES[$headArrowSize])) {
+ $this->lineStyleProperties['arrow']['head']['size'] = $headArrowSize;
+ $this->lineStyleProperties['arrow']['head']['w'] = self::ARROW_SIZES[$headArrowSize]['w'];
+ $this->lineStyleProperties['arrow']['head']['len'] = self::ARROW_SIZES[$headArrowSize]['len'];
+ }
+ if ($endArrowType !== '') {
+ $this->lineStyleProperties['arrow']['end']['type'] = $endArrowType;
+ }
+ if (isset(self::ARROW_SIZES[$endArrowSize])) {
+ $this->lineStyleProperties['arrow']['end']['size'] = $endArrowSize;
+ $this->lineStyleProperties['arrow']['end']['w'] = self::ARROW_SIZES[$endArrowSize]['w'];
+ $this->lineStyleProperties['arrow']['end']['len'] = self::ARROW_SIZES[$endArrowSize]['len'];
+ }
+ if ($headArrowWidth !== '') {
+ $this->lineStyleProperties['arrow']['head']['w'] = $headArrowWidth;
+ }
+ if ($headArrowLength !== '') {
+ $this->lineStyleProperties['arrow']['head']['len'] = $headArrowLength;
+ }
+ if ($endArrowWidth !== '') {
+ $this->lineStyleProperties['arrow']['end']['w'] = $endArrowWidth;
+ }
+ if ($endArrowLength !== '') {
+ $this->lineStyleProperties['arrow']['end']['len'] = $endArrowLength;
+ }
+ }
+
+ public function getLineStyleArray(): array
+ {
+ return $this->lineStyleProperties;
+ }
+
+ public function setLineStyleArray(array $lineStyleProperties = []): self
+ {
+ $this->activateObject();
+ $this->lineStyleProperties['width'] = $lineStyleProperties['width'] ?? null;
+ $this->lineStyleProperties['compound'] = $lineStyleProperties['compound'] ?? '';
+ $this->lineStyleProperties['dash'] = $lineStyleProperties['dash'] ?? '';
+ $this->lineStyleProperties['cap'] = $lineStyleProperties['cap'] ?? '';
+ $this->lineStyleProperties['join'] = $lineStyleProperties['join'] ?? '';
+ $this->lineStyleProperties['arrow']['head']['type'] = $lineStyleProperties['arrow']['head']['type'] ?? '';
+ $this->lineStyleProperties['arrow']['head']['size'] = $lineStyleProperties['arrow']['head']['size'] ?? '';
+ $this->lineStyleProperties['arrow']['head']['w'] = $lineStyleProperties['arrow']['head']['w'] ?? '';
+ $this->lineStyleProperties['arrow']['head']['len'] = $lineStyleProperties['arrow']['head']['len'] ?? '';
+ $this->lineStyleProperties['arrow']['end']['type'] = $lineStyleProperties['arrow']['end']['type'] ?? '';
+ $this->lineStyleProperties['arrow']['end']['size'] = $lineStyleProperties['arrow']['end']['size'] ?? '';
+ $this->lineStyleProperties['arrow']['end']['w'] = $lineStyleProperties['arrow']['end']['w'] ?? '';
+ $this->lineStyleProperties['arrow']['end']['len'] = $lineStyleProperties['arrow']['end']['len'] ?? '';
+
+ return $this;
+ }
+
+ public function setLineStyleProperty(string $propertyName, mixed $value): self
+ {
+ $this->activateObject();
+ $this->lineStyleProperties[$propertyName] = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get Line Style Property.
+ */
+ public function getLineStyleProperty(array|string $elements): ?string
+ {
+ $retVal = $this->getArrayElementsValue($this->lineStyleProperties, $elements);
+ if (is_scalar($retVal)) {
+ $retVal = (string) $retVal;
+ } elseif ($retVal !== null) {
+ // @codeCoverageIgnoreStart
+ throw new Exception('Unexpected value for lineStyleProperty');
+ // @codeCoverageIgnoreEnd
+ }
+
+ return $retVal;
+ }
+
+ protected const ARROW_SIZES = [
+ 1 => ['w' => 'sm', 'len' => 'sm'],
+ 2 => ['w' => 'sm', 'len' => 'med'],
+ 3 => ['w' => 'sm', 'len' => 'lg'],
+ 4 => ['w' => 'med', 'len' => 'sm'],
+ 5 => ['w' => 'med', 'len' => 'med'],
+ 6 => ['w' => 'med', 'len' => 'lg'],
+ 7 => ['w' => 'lg', 'len' => 'sm'],
+ 8 => ['w' => 'lg', 'len' => 'med'],
+ 9 => ['w' => 'lg', 'len' => 'lg'],
+ ];
+
+ /**
+ * Get Line Style Arrow Size.
+ */
+ protected function getLineStyleArrowSize(int $arraySelector, string $arrayKaySelector): string
+ {
+ return self::ARROW_SIZES[$arraySelector][$arrayKaySelector] ?? '';
+ }
+
+ /**
+ * Get Line Style Arrow Parameters.
+ */
+ public function getLineStyleArrowParameters(string $arrowSelector, string $propertySelector): string
+ {
+ return $this->getLineStyleArrowSize($this->lineStyleProperties['arrow'][$arrowSelector]['size'], $propertySelector);
+ }
+
+ /**
+ * Get Line Style Arrow Width.
+ */
+ public function getLineStyleArrowWidth(string $arrow): ?string
+ {
+ return $this->getLineStyleProperty(['arrow', $arrow, 'w']);
+ }
+
+ /**
+ * Get Line Style Arrow Excel Length.
+ */
+ public function getLineStyleArrowLength(string $arrow): ?string
+ {
+ return $this->getLineStyleProperty(['arrow', $arrow, 'len']);
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $this->lineColor = clone $this->lineColor;
+ $this->glowColor = clone $this->glowColor;
+ $this->shadowColor = clone $this->shadowColor;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/IRenderer.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/IRenderer.php
new file mode 100644
index 00000000..ae28ff4f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/IRenderer.php
@@ -0,0 +1,22 @@
+graph = null;
+ $this->chart = $chart;
+
+ self::$markSet = [
+ 'diamond' => MARK_DIAMOND,
+ 'square' => MARK_SQUARE,
+ 'triangle' => MARK_UTRIANGLE,
+ 'x' => MARK_X,
+ 'star' => MARK_STAR,
+ 'dot' => MARK_FILLEDCIRCLE,
+ 'dash' => MARK_DTRIANGLE,
+ 'circle' => MARK_CIRCLE,
+ 'plus' => MARK_CROSS,
+ ];
+ }
+
+ private function getGraphWidth(): float
+ {
+ return $this->chart->getRenderedWidth() ?? self::DEFAULT_WIDTH;
+ }
+
+ private function getGraphHeight(): float
+ {
+ return $this->chart->getRenderedHeight() ?? self::DEFAULT_HEIGHT;
+ }
+
+ /**
+ * This method should be overriden in descendants to do real JpGraph library initialization.
+ */
+ abstract protected static function init(): void;
+
+ private function formatPointMarker($seriesPlot, $markerID)
+ {
+ $plotMarkKeys = array_keys(self::$markSet);
+ if ($markerID === null) {
+ // Use default plot marker (next marker in the series)
+ self::$plotMark %= count(self::$markSet);
+ $seriesPlot->mark->SetType(self::$markSet[$plotMarkKeys[self::$plotMark++]]);
+ } elseif ($markerID !== 'none') {
+ // Use specified plot marker (if it exists)
+ if (isset(self::$markSet[$markerID])) {
+ $seriesPlot->mark->SetType(self::$markSet[$markerID]);
+ } else {
+ // If the specified plot marker doesn't exist, use default plot marker (next marker in the series)
+ self::$plotMark %= count(self::$markSet);
+ $seriesPlot->mark->SetType(self::$markSet[$plotMarkKeys[self::$plotMark++]]);
+ }
+ } else {
+ // Hide plot marker
+ $seriesPlot->mark->Hide();
+ }
+ $seriesPlot->mark->SetColor(self::$colourSet[self::$plotColour]);
+ $seriesPlot->mark->SetFillColor(self::$colourSet[self::$plotColour]);
+ $seriesPlot->SetColor(self::$colourSet[self::$plotColour++]);
+
+ return $seriesPlot;
+ }
+
+ private function formatDataSetLabels(int $groupID, array $datasetLabels, $rotation = '')
+ {
+ $datasetLabelFormatCode = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotCategoryByIndex(0)->getFormatCode() ?? '';
+ // Retrieve any label formatting code
+ $datasetLabelFormatCode = stripslashes($datasetLabelFormatCode);
+
+ $testCurrentIndex = 0;
+ foreach ($datasetLabels as $i => $datasetLabel) {
+ if (is_array($datasetLabel)) {
+ if ($rotation == 'bar') {
+ $datasetLabels[$i] = implode(' ', $datasetLabel);
+ } else {
+ $datasetLabel = array_reverse($datasetLabel);
+ $datasetLabels[$i] = implode("\n", $datasetLabel);
+ }
+ } else {
+ // Format labels according to any formatting code
+ if ($datasetLabelFormatCode !== null) {
+ $datasetLabels[$i] = NumberFormat::toFormattedString($datasetLabel, $datasetLabelFormatCode);
+ }
+ }
+ ++$testCurrentIndex;
+ }
+
+ return $datasetLabels;
+ }
+
+ private function percentageSumCalculation(int $groupID, $seriesCount)
+ {
+ $sumValues = [];
+ // Adjust our values to a percentage value across all series in the group
+ for ($i = 0; $i < $seriesCount; ++$i) {
+ if ($i == 0) {
+ $sumValues = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($i)->getDataValues();
+ } else {
+ $nextValues = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($i)->getDataValues();
+ foreach ($nextValues as $k => $value) {
+ if (isset($sumValues[$k])) {
+ $sumValues[$k] += $value;
+ } else {
+ $sumValues[$k] = $value;
+ }
+ }
+ }
+ }
+
+ return $sumValues;
+ }
+
+ private function percentageAdjustValues(array $dataValues, array $sumValues)
+ {
+ foreach ($dataValues as $k => $dataValue) {
+ $dataValues[$k] = $dataValue / $sumValues[$k] * 100;
+ }
+
+ return $dataValues;
+ }
+
+ private function getCaption($captionElement)
+ {
+ // Read any caption
+ $caption = ($captionElement !== null) ? $captionElement->getCaption() : null;
+ // Test if we have a title caption to display
+ if ($caption !== null) {
+ // If we do, it could be a plain string or an array
+ if (is_array($caption)) {
+ // Implode an array to a plain string
+ $caption = implode('', $caption);
+ }
+ }
+
+ return $caption;
+ }
+
+ private function renderTitle(): void
+ {
+ $title = $this->getCaption($this->chart->getTitle());
+ if ($title !== null) {
+ $this->graph->title->Set($title);
+ }
+ }
+
+ private function renderLegend(): void
+ {
+ $legend = $this->chart->getLegend();
+ if ($legend !== null) {
+ $legendPosition = $legend->getPosition();
+ switch ($legendPosition) {
+ case 'r':
+ $this->graph->legend->SetPos(0.01, 0.5, 'right', 'center'); // right
+ $this->graph->legend->SetColumns(1);
+
+ break;
+ case 'l':
+ $this->graph->legend->SetPos(0.01, 0.5, 'left', 'center'); // left
+ $this->graph->legend->SetColumns(1);
+
+ break;
+ case 't':
+ $this->graph->legend->SetPos(0.5, 0.01, 'center', 'top'); // top
+
+ break;
+ case 'b':
+ $this->graph->legend->SetPos(0.5, 0.99, 'center', 'bottom'); // bottom
+
+ break;
+ default:
+ $this->graph->legend->SetPos(0.01, 0.01, 'right', 'top'); // top-right
+ $this->graph->legend->SetColumns(1);
+
+ break;
+ }
+ } else {
+ $this->graph->legend->Hide();
+ }
+ }
+
+ private function renderCartesianPlotArea(string $type = 'textlin'): void
+ {
+ $this->graph = new Graph($this->getGraphWidth(), $this->getGraphHeight());
+ $this->graph->SetScale($type);
+
+ $this->renderTitle();
+
+ // Rotate for bar rather than column chart
+ $rotation = $this->chart->getPlotArea()->getPlotGroupByIndex(0)->getPlotDirection();
+ $reverse = $rotation == 'bar';
+
+ $xAxisLabel = $this->chart->getXAxisLabel();
+ if ($xAxisLabel !== null) {
+ $title = $this->getCaption($xAxisLabel);
+ if ($title !== null) {
+ $this->graph->xaxis->SetTitle($title, 'center');
+ $this->graph->xaxis->title->SetMargin(35);
+ if ($reverse) {
+ $this->graph->xaxis->title->SetAngle(90);
+ $this->graph->xaxis->title->SetMargin(90);
+ }
+ }
+ }
+
+ $yAxisLabel = $this->chart->getYAxisLabel();
+ if ($yAxisLabel !== null) {
+ $title = $this->getCaption($yAxisLabel);
+ if ($title !== null) {
+ $this->graph->yaxis->SetTitle($title, 'center');
+ if ($reverse) {
+ $this->graph->yaxis->title->SetAngle(0);
+ $this->graph->yaxis->title->SetMargin(-55);
+ }
+ }
+ }
+ }
+
+ private function renderPiePlotArea(): void
+ {
+ $this->graph = new PieGraph($this->getGraphWidth(), $this->getGraphHeight());
+
+ $this->renderTitle();
+ }
+
+ private function renderRadarPlotArea(): void
+ {
+ $this->graph = new RadarGraph($this->getGraphWidth(), $this->getGraphHeight());
+ $this->graph->SetScale('lin');
+
+ $this->renderTitle();
+ }
+
+ private function getDataLabel(int $groupId, int $index): mixed
+ {
+ $plotLabel = $this->chart->getPlotArea()->getPlotGroupByIndex($groupId)->getPlotLabelByIndex($index);
+ if (!$plotLabel) {
+ return '';
+ }
+
+ return $plotLabel->getDataValue();
+ }
+
+ private function renderPlotLine(int $groupID, bool $filled = false, bool $combination = false): void
+ {
+ $grouping = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotGrouping();
+
+ $index = array_keys($this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotOrder())[0];
+ $labelCount = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($index)->getPointCount();
+ if ($labelCount > 0) {
+ $datasetLabels = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotCategoryByIndex(0)->getDataValues();
+ $datasetLabels = $this->formatDataSetLabels($groupID, $datasetLabels);
+ $this->graph->xaxis->SetTickLabels($datasetLabels);
+ }
+
+ $seriesCount = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotSeriesCount();
+ $seriesPlots = [];
+ if ($grouping == 'percentStacked') {
+ $sumValues = $this->percentageSumCalculation($groupID, $seriesCount);
+ } else {
+ $sumValues = [];
+ }
+
+ // Loop through each data series in turn
+ for ($i = 0; $i < $seriesCount; ++$i) {
+ $index = array_keys($this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotOrder())[$i];
+ $dataValues = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($index)->getDataValues();
+ $marker = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($index)->getPointMarker();
+
+ if ($grouping == 'percentStacked') {
+ $dataValues = $this->percentageAdjustValues($dataValues, $sumValues);
+ }
+
+ // Fill in any missing values in the $dataValues array
+ $testCurrentIndex = 0;
+ foreach ($dataValues as $k => $dataValue) {
+ while ($k != $testCurrentIndex) {
+ $dataValues[$testCurrentIndex] = null;
+ ++$testCurrentIndex;
+ }
+ ++$testCurrentIndex;
+ }
+
+ $seriesPlot = new LinePlot($dataValues);
+ if ($combination) {
+ $seriesPlot->SetBarCenter();
+ }
+
+ if ($filled) {
+ $seriesPlot->SetFilled(true);
+ $seriesPlot->SetColor('black');
+ $seriesPlot->SetFillColor(self::$colourSet[self::$plotColour++]);
+ } else {
+ // Set the appropriate plot marker
+ $this->formatPointMarker($seriesPlot, $marker);
+ }
+
+ $seriesPlot->SetLegend($this->getDataLabel($groupID, $index));
+
+ $seriesPlots[] = $seriesPlot;
+ }
+
+ if ($grouping == 'standard') {
+ $groupPlot = $seriesPlots;
+ } else {
+ $groupPlot = new AccLinePlot($seriesPlots);
+ }
+ $this->graph->Add($groupPlot);
+ }
+
+ private function renderPlotBar(int $groupID, ?string $dimensions = '2d'): void
+ {
+ $rotation = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotDirection();
+ // Rotate for bar rather than column chart
+ if (($groupID == 0) && ($rotation == 'bar')) {
+ $this->graph->Set90AndMargin();
+ }
+ $grouping = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotGrouping();
+
+ $index = array_keys($this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotOrder())[0];
+ $labelCount = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($index)->getPointCount();
+ if ($labelCount > 0) {
+ $datasetLabels = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotCategoryByIndex(0)->getDataValues();
+ $datasetLabels = $this->formatDataSetLabels($groupID, $datasetLabels, $rotation);
+ // Rotate for bar rather than column chart
+ if ($rotation == 'bar') {
+ $datasetLabels = array_reverse($datasetLabels);
+ $this->graph->yaxis->SetPos('max');
+ $this->graph->yaxis->SetLabelAlign('center', 'top');
+ $this->graph->yaxis->SetLabelSide(SIDE_RIGHT);
+ }
+ $this->graph->xaxis->SetTickLabels($datasetLabels);
+ }
+
+ $seriesCount = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotSeriesCount();
+ $seriesPlots = [];
+ if ($grouping == 'percentStacked') {
+ $sumValues = $this->percentageSumCalculation($groupID, $seriesCount);
+ } else {
+ $sumValues = [];
+ }
+
+ // Loop through each data series in turn
+ for ($j = 0; $j < $seriesCount; ++$j) {
+ $index = array_keys($this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotOrder())[$j];
+ $dataValues = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($index)->getDataValues();
+ if ($grouping == 'percentStacked') {
+ $dataValues = $this->percentageAdjustValues($dataValues, $sumValues);
+ }
+
+ // Fill in any missing values in the $dataValues array
+ $testCurrentIndex = 0;
+ foreach ($dataValues as $k => $dataValue) {
+ while ($k != $testCurrentIndex) {
+ $dataValues[$testCurrentIndex] = null;
+ ++$testCurrentIndex;
+ }
+ ++$testCurrentIndex;
+ }
+
+ // Reverse the $dataValues order for bar rather than column chart
+ if ($rotation == 'bar') {
+ $dataValues = array_reverse($dataValues);
+ }
+ $seriesPlot = new BarPlot($dataValues);
+ $seriesPlot->SetColor('black');
+ $seriesPlot->SetFillColor(self::$colourSet[self::$plotColour++]);
+ if ($dimensions == '3d') {
+ $seriesPlot->SetShadow();
+ }
+
+ $seriesPlot->SetLegend($this->getDataLabel($groupID, $j));
+
+ $seriesPlots[] = $seriesPlot;
+ }
+ // Reverse the plot order for bar rather than column chart
+ if (($rotation == 'bar') && ($grouping != 'percentStacked')) {
+ $seriesPlots = array_reverse($seriesPlots);
+ }
+
+ if ($grouping == 'clustered') {
+ $groupPlot = new GroupBarPlot($seriesPlots);
+ } elseif ($grouping == 'standard') {
+ $groupPlot = new GroupBarPlot($seriesPlots);
+ } else {
+ $groupPlot = new AccBarPlot($seriesPlots);
+ if ($dimensions == '3d') {
+ $groupPlot->SetShadow();
+ }
+ }
+
+ $this->graph->Add($groupPlot);
+ }
+
+ private function renderPlotScatter(int $groupID, bool $bubble): void
+ {
+ $scatterStyle = $bubbleSize = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotStyle();
+
+ $seriesCount = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotSeriesCount();
+
+ // Loop through each data series in turn
+ for ($i = 0; $i < $seriesCount; ++$i) {
+ $plotCategoryByIndex = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotCategoryByIndex($i);
+ if ($plotCategoryByIndex === false) {
+ $plotCategoryByIndex = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotCategoryByIndex(0);
+ }
+ $dataValuesY = $plotCategoryByIndex->getDataValues();
+ $dataValuesX = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($i)->getDataValues();
+
+ $redoDataValuesY = true;
+ if ($bubble) {
+ if (!$bubbleSize) {
+ $bubbleSize = '10';
+ }
+ $redoDataValuesY = false;
+ foreach ($dataValuesY as $dataValueY) {
+ if (!is_int($dataValueY) && !is_float($dataValueY)) {
+ $redoDataValuesY = true;
+
+ break;
+ }
+ }
+ }
+ if ($redoDataValuesY) {
+ foreach ($dataValuesY as $k => $dataValueY) {
+ $dataValuesY[$k] = $k;
+ }
+ }
+
+ $seriesPlot = new ScatterPlot($dataValuesX, $dataValuesY);
+ if ($scatterStyle == 'lineMarker') {
+ $seriesPlot->SetLinkPoints();
+ $seriesPlot->link->SetColor(self::$colourSet[self::$plotColour]);
+ } elseif ($scatterStyle == 'smoothMarker') {
+ $spline = new Spline($dataValuesY, $dataValuesX);
+ [$splineDataY, $splineDataX] = $spline->Get(count($dataValuesX) * $this->getGraphWidth() / 20);
+ $lplot = new LinePlot($splineDataX, $splineDataY);
+ $lplot->SetColor(self::$colourSet[self::$plotColour]);
+
+ $this->graph->Add($lplot);
+ }
+
+ if ($bubble) {
+ $this->formatPointMarker($seriesPlot, 'dot');
+ $seriesPlot->mark->SetColor('black');
+ $seriesPlot->mark->SetSize($bubbleSize);
+ } else {
+ $marker = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($i)->getPointMarker();
+ $this->formatPointMarker($seriesPlot, $marker);
+ }
+ $seriesPlot->SetLegend($this->getDataLabel($groupID, $i));
+
+ $this->graph->Add($seriesPlot);
+ }
+ }
+
+ private function renderPlotRadar(int $groupID): void
+ {
+ $radarStyle = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotStyle();
+
+ $seriesCount = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotSeriesCount();
+
+ // Loop through each data series in turn
+ for ($i = 0; $i < $seriesCount; ++$i) {
+ $dataValuesY = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotCategoryByIndex($i)->getDataValues();
+ $dataValuesX = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($i)->getDataValues();
+ $marker = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($i)->getPointMarker();
+
+ $dataValues = [];
+ foreach ($dataValuesY as $k => $dataValueY) {
+ $dataValues[$k] = is_array($dataValueY) ? implode(' ', array_reverse($dataValueY)) : $dataValueY;
+ }
+ $tmp = array_shift($dataValues);
+ $dataValues[] = $tmp;
+ $tmp = array_shift($dataValuesX);
+ $dataValuesX[] = $tmp;
+
+ $this->graph->SetTitles(array_reverse($dataValues));
+
+ $seriesPlot = new RadarPlot(array_reverse($dataValuesX));
+
+ $seriesPlot->SetColor(self::$colourSet[self::$plotColour++]);
+ if ($radarStyle == 'filled') {
+ $seriesPlot->SetFillColor(self::$colourSet[self::$plotColour]);
+ }
+ $this->formatPointMarker($seriesPlot, $marker);
+ $seriesPlot->SetLegend($this->getDataLabel($groupID, $i));
+
+ $this->graph->Add($seriesPlot);
+ }
+ }
+
+ private function renderPlotContour(int $groupID): void
+ {
+ $seriesCount = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotSeriesCount();
+
+ $dataValues = [];
+ // Loop through each data series in turn
+ for ($i = 0; $i < $seriesCount; ++$i) {
+ $dataValuesX = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($i)->getDataValues();
+
+ $dataValues[$i] = $dataValuesX;
+ }
+ $seriesPlot = new ContourPlot($dataValues);
+
+ $this->graph->Add($seriesPlot);
+ }
+
+ private function renderPlotStock(int $groupID): void
+ {
+ $seriesCount = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotSeriesCount();
+ $plotOrder = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotOrder();
+
+ $dataValues = [];
+ // Loop through each data series in turn and build the plot arrays
+ foreach ($plotOrder as $i => $v) {
+ $dataValuesX = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($v);
+ if ($dataValuesX === false) {
+ continue;
+ }
+ $dataValuesX = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($v)->getDataValues();
+ foreach ($dataValuesX as $j => $dataValueX) {
+ $dataValues[$plotOrder[$i]][$j] = $dataValueX;
+ }
+ }
+ if (empty($dataValues)) {
+ return;
+ }
+
+ $dataValuesPlot = [];
+ // Flatten the plot arrays to a single dimensional array to work with jpgraph
+ $jMax = count($dataValues[0]);
+ for ($j = 0; $j < $jMax; ++$j) {
+ for ($i = 0; $i < $seriesCount; ++$i) {
+ $dataValuesPlot[] = $dataValues[$i][$j] ?? null;
+ }
+ }
+
+ // Set the x-axis labels
+ $labelCount = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex(0)->getPointCount();
+ if ($labelCount > 0) {
+ $datasetLabels = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotCategoryByIndex(0)->getDataValues();
+ $datasetLabels = $this->formatDataSetLabels($groupID, $datasetLabels);
+ $this->graph->xaxis->SetTickLabels($datasetLabels);
+ }
+
+ $seriesPlot = new StockPlot($dataValuesPlot);
+ $seriesPlot->SetWidth(20);
+
+ $this->graph->Add($seriesPlot);
+ }
+
+ private function renderAreaChart($groupCount): void
+ {
+ $this->renderCartesianPlotArea();
+
+ for ($i = 0; $i < $groupCount; ++$i) {
+ $this->renderPlotLine($i, true, false);
+ }
+ }
+
+ private function renderLineChart($groupCount): void
+ {
+ $this->renderCartesianPlotArea();
+
+ for ($i = 0; $i < $groupCount; ++$i) {
+ $this->renderPlotLine($i, false, false);
+ }
+ }
+
+ private function renderBarChart($groupCount, ?string $dimensions = '2d'): void
+ {
+ $this->renderCartesianPlotArea();
+
+ for ($i = 0; $i < $groupCount; ++$i) {
+ $this->renderPlotBar($i, $dimensions);
+ }
+ }
+
+ private function renderScatterChart($groupCount): void
+ {
+ $this->renderCartesianPlotArea('linlin');
+
+ for ($i = 0; $i < $groupCount; ++$i) {
+ $this->renderPlotScatter($i, false);
+ }
+ }
+
+ private function renderBubbleChart($groupCount): void
+ {
+ $this->renderCartesianPlotArea('linlin');
+
+ for ($i = 0; $i < $groupCount; ++$i) {
+ $this->renderPlotScatter($i, true);
+ }
+ }
+
+ private function renderPieChart($groupCount, ?string $dimensions = '2d', bool $doughnut = false, bool $multiplePlots = false): void
+ {
+ $this->renderPiePlotArea();
+
+ $iLimit = ($multiplePlots) ? $groupCount : 1;
+ for ($groupID = 0; $groupID < $iLimit; ++$groupID) {
+ $exploded = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotStyle();
+ $datasetLabels = [];
+ if ($groupID == 0) {
+ $labelCount = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex(0)->getPointCount();
+ if ($labelCount > 0) {
+ $datasetLabels = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotCategoryByIndex(0)->getDataValues();
+ $datasetLabels = $this->formatDataSetLabels($groupID, $datasetLabels);
+ }
+ }
+
+ $seriesCount = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotSeriesCount();
+ // For pie charts, we only display the first series: doughnut charts generally display all series
+ $jLimit = ($multiplePlots) ? $seriesCount : 1;
+ // Loop through each data series in turn
+ for ($j = 0; $j < $jLimit; ++$j) {
+ $dataValues = $this->chart->getPlotArea()->getPlotGroupByIndex($groupID)->getPlotValuesByIndex($j)->getDataValues();
+
+ // Fill in any missing values in the $dataValues array
+ $testCurrentIndex = 0;
+ foreach ($dataValues as $k => $dataValue) {
+ while ($k != $testCurrentIndex) {
+ $dataValues[$testCurrentIndex] = null;
+ ++$testCurrentIndex;
+ }
+ ++$testCurrentIndex;
+ }
+
+ if ($dimensions == '3d') {
+ $seriesPlot = new PiePlot3D($dataValues);
+ } else {
+ if ($doughnut) {
+ $seriesPlot = new PiePlotC($dataValues);
+ } else {
+ $seriesPlot = new PiePlot($dataValues);
+ }
+ }
+
+ if ($multiplePlots) {
+ $seriesPlot->SetSize(($jLimit - $j) / ($jLimit * 4));
+ }
+
+ if ($doughnut && method_exists($seriesPlot, 'SetMidColor')) {
+ $seriesPlot->SetMidColor('white');
+ }
+
+ $seriesPlot->SetColor(self::$colourSet[self::$plotColour++]);
+ if (count($datasetLabels) > 0) {
+ $seriesPlot->SetLabels(array_fill(0, count($datasetLabels), ''));
+ }
+ if ($dimensions != '3d') {
+ $seriesPlot->SetGuideLines(false);
+ }
+ if ($j == 0) {
+ if ($exploded) {
+ $seriesPlot->ExplodeAll();
+ }
+ $seriesPlot->SetLegends($datasetLabels);
+ }
+
+ $this->graph->Add($seriesPlot);
+ }
+ }
+ }
+
+ private function renderRadarChart($groupCount): void
+ {
+ $this->renderRadarPlotArea();
+
+ for ($groupID = 0; $groupID < $groupCount; ++$groupID) {
+ $this->renderPlotRadar($groupID);
+ }
+ }
+
+ private function renderStockChart($groupCount): void
+ {
+ $this->renderCartesianPlotArea('intint');
+
+ for ($groupID = 0; $groupID < $groupCount; ++$groupID) {
+ $this->renderPlotStock($groupID);
+ }
+ }
+
+ private function renderContourChart($groupCount): void
+ {
+ $this->renderCartesianPlotArea('intint');
+
+ for ($i = 0; $i < $groupCount; ++$i) {
+ $this->renderPlotContour($i);
+ }
+ }
+
+ private function renderCombinationChart($groupCount, $outputDestination): bool
+ {
+ $this->renderCartesianPlotArea();
+
+ for ($i = 0; $i < $groupCount; ++$i) {
+ $dimensions = null;
+ $chartType = $this->chart->getPlotArea()->getPlotGroupByIndex($i)->getPlotType();
+ switch ($chartType) {
+ case 'area3DChart':
+ case 'areaChart':
+ $this->renderPlotLine($i, true, true);
+
+ break;
+ case 'bar3DChart':
+ $dimensions = '3d';
+ // no break
+ case 'barChart':
+ $this->renderPlotBar($i, $dimensions);
+
+ break;
+ case 'line3DChart':
+ case 'lineChart':
+ $this->renderPlotLine($i, false, true);
+
+ break;
+ case 'scatterChart':
+ $this->renderPlotScatter($i, false);
+
+ break;
+ case 'bubbleChart':
+ $this->renderPlotScatter($i, true);
+
+ break;
+ default:
+ $this->graph = null;
+
+ return false;
+ }
+ }
+
+ $this->renderLegend();
+
+ $this->graph->Stroke($outputDestination);
+
+ return true;
+ }
+
+ public function render(?string $outputDestination): bool
+ {
+ self::$plotColour = 0;
+
+ $groupCount = $this->chart->getPlotArea()->getPlotGroupCount();
+
+ $dimensions = null;
+ if ($groupCount == 1) {
+ $chartType = $this->chart->getPlotArea()->getPlotGroupByIndex(0)->getPlotType();
+ } else {
+ $chartTypes = [];
+ for ($i = 0; $i < $groupCount; ++$i) {
+ $chartTypes[] = $this->chart->getPlotArea()->getPlotGroupByIndex($i)->getPlotType();
+ }
+ $chartTypes = array_unique($chartTypes);
+ if (count($chartTypes) == 1) {
+ $chartType = array_pop($chartTypes);
+ } elseif (count($chartTypes) == 0) {
+ echo 'Chart is not yet implemented ';
+
+ return false;
+ } else {
+ return $this->renderCombinationChart($groupCount, $outputDestination);
+ }
+ }
+
+ switch ($chartType) {
+ case 'area3DChart':
+ $dimensions = '3d';
+ // no break
+ case 'areaChart':
+ $this->renderAreaChart($groupCount);
+
+ break;
+ case 'bar3DChart':
+ $dimensions = '3d';
+ // no break
+ case 'barChart':
+ $this->renderBarChart($groupCount, $dimensions);
+
+ break;
+ case 'line3DChart':
+ $dimensions = '3d';
+ // no break
+ case 'lineChart':
+ $this->renderLineChart($groupCount);
+
+ break;
+ case 'pie3DChart':
+ $dimensions = '3d';
+ // no break
+ case 'pieChart':
+ $this->renderPieChart($groupCount, $dimensions, false, false);
+
+ break;
+ case 'doughnut3DChart':
+ $dimensions = '3d';
+ // no break
+ case 'doughnutChart':
+ $this->renderPieChart($groupCount, $dimensions, true, true);
+
+ break;
+ case 'scatterChart':
+ $this->renderScatterChart($groupCount);
+
+ break;
+ case 'bubbleChart':
+ $this->renderBubbleChart($groupCount);
+
+ break;
+ case 'radarChart':
+ $this->renderRadarChart($groupCount);
+
+ break;
+ case 'surface3DChart':
+ case 'surfaceChart':
+ $this->renderContourChart($groupCount);
+
+ break;
+ case 'stockChart':
+ $this->renderStockChart($groupCount);
+
+ break;
+ default:
+ echo $chartType . ' is not yet implemented ';
+
+ return false;
+ }
+ $this->renderLegend();
+
+ $this->graph->Stroke($outputDestination);
+
+ return true;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/MtJpGraphRenderer.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/MtJpGraphRenderer.php
new file mode 100644
index 00000000..96979203
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/Renderer/MtJpGraphRenderer.php
@@ -0,0 +1,38 @@
+|RichText|string
+ */
+ private array|RichText|string $caption;
+
+ /**
+ * Allow overlay of other elements?
+ */
+ private bool $overlay = true;
+
+ /**
+ * Title Layout.
+ */
+ private ?Layout $layout;
+
+ private string $cellReference = '';
+
+ private ?Font $font = null;
+
+ /**
+ * Create a new Title.
+ */
+ public function __construct(array|RichText|string $caption = '', ?Layout $layout = null, bool $overlay = false)
+ {
+ $this->caption = $caption;
+ $this->layout = $layout;
+ $this->setOverlay($overlay);
+ }
+
+ /**
+ * Get caption.
+ */
+ public function getCaption(): array|RichText|string
+ {
+ return $this->caption;
+ }
+
+ public function getCaptionText(?Spreadsheet $spreadsheet = null): string
+ {
+ if ($spreadsheet !== null) {
+ $caption = $this->getCalculatedTitle($spreadsheet);
+ if ($caption !== null) {
+ return $caption;
+ }
+ }
+ $caption = $this->caption;
+ if (is_string($caption)) {
+ return $caption;
+ }
+ if ($caption instanceof RichText) {
+ return $caption->getPlainText();
+ }
+ $retVal = '';
+ foreach ($caption as $textx) {
+ /** @var RichText|string $text */
+ $text = $textx;
+ if ($text instanceof RichText) {
+ $retVal .= $text->getPlainText();
+ } else {
+ $retVal .= $text;
+ }
+ }
+
+ return $retVal;
+ }
+
+ /**
+ * Set caption.
+ *
+ * @return $this
+ */
+ public function setCaption(array|RichText|string $caption): static
+ {
+ $this->caption = $caption;
+
+ return $this;
+ }
+
+ /**
+ * Get allow overlay of other elements?
+ */
+ public function getOverlay(): bool
+ {
+ return $this->overlay;
+ }
+
+ /**
+ * Set allow overlay of other elements?
+ */
+ public function setOverlay(bool $overlay): self
+ {
+ $this->overlay = $overlay;
+
+ return $this;
+ }
+
+ public function getLayout(): ?Layout
+ {
+ return $this->layout;
+ }
+
+ public function setCellReference(string $cellReference): self
+ {
+ $this->cellReference = $cellReference;
+
+ return $this;
+ }
+
+ public function getCellReference(): string
+ {
+ return $this->cellReference;
+ }
+
+ public function getCalculatedTitle(?Spreadsheet $spreadsheet): ?string
+ {
+ preg_match(self::TITLE_CELL_REFERENCE, $this->cellReference, $matches);
+ if (count($matches) === 0 || $spreadsheet === null) {
+ return null;
+ }
+ $sheetName = preg_replace("/^'(.*)'$/", '$1', $matches[1]) ?? '';
+
+ return $spreadsheet->getSheetByName($sheetName)?->getCell($matches[2] . $matches[3])?->getFormattedValue();
+ }
+
+ public function getFont(): ?Font
+ {
+ return $this->font;
+ }
+
+ public function setFont(?Font $font): self
+ {
+ $this->font = $font;
+
+ return $this;
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $this->layout = ($this->layout === null) ? null : clone $this->layout;
+ $this->font = ($this->font === null) ? null : clone $this->font;
+ if (is_array($this->caption)) {
+ $captions = $this->caption;
+ $this->caption = [];
+ foreach ($captions as $caption) {
+ $this->caption[] = is_object($caption) ? (clone $caption) : $caption;
+ }
+ } else {
+ $this->caption = is_object($this->caption) ? (clone $this->caption) : $this->caption;
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/TrendLine.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/TrendLine.php
new file mode 100644
index 00000000..5814fea4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Chart/TrendLine.php
@@ -0,0 +1,217 @@
+setTrendLineProperties(
+ $trendLineType,
+ $order,
+ $period,
+ $dispRSqr,
+ $dispEq,
+ $backward,
+ $forward,
+ $intercept,
+ $name
+ );
+ }
+
+ public function getTrendLineType(): string
+ {
+ return $this->trendLineType;
+ }
+
+ public function setTrendLineType(string $trendLineType): self
+ {
+ $this->trendLineType = $trendLineType;
+
+ return $this;
+ }
+
+ public function getOrder(): int
+ {
+ return $this->order;
+ }
+
+ public function setOrder(int $order): self
+ {
+ $this->order = $order;
+
+ return $this;
+ }
+
+ public function getPeriod(): int
+ {
+ return $this->period;
+ }
+
+ public function setPeriod(int $period): self
+ {
+ $this->period = $period;
+
+ return $this;
+ }
+
+ public function getDispRSqr(): bool
+ {
+ return $this->dispRSqr;
+ }
+
+ public function setDispRSqr(bool $dispRSqr): self
+ {
+ $this->dispRSqr = $dispRSqr;
+
+ return $this;
+ }
+
+ public function getDispEq(): bool
+ {
+ return $this->dispEq;
+ }
+
+ public function setDispEq(bool $dispEq): self
+ {
+ $this->dispEq = $dispEq;
+
+ return $this;
+ }
+
+ public function getName(): string
+ {
+ return $this->name;
+ }
+
+ public function setName(string $name): self
+ {
+ $this->name = $name;
+
+ return $this;
+ }
+
+ public function getBackward(): float
+ {
+ return $this->backward;
+ }
+
+ public function setBackward(float $backward): self
+ {
+ $this->backward = $backward;
+
+ return $this;
+ }
+
+ public function getForward(): float
+ {
+ return $this->forward;
+ }
+
+ public function setForward(float $forward): self
+ {
+ $this->forward = $forward;
+
+ return $this;
+ }
+
+ public function getIntercept(): float
+ {
+ return $this->intercept;
+ }
+
+ public function setIntercept(float $intercept): self
+ {
+ $this->intercept = $intercept;
+
+ return $this;
+ }
+
+ public function setTrendLineProperties(
+ ?string $trendLineType = null,
+ ?int $order = 0,
+ ?int $period = 0,
+ ?bool $dispRSqr = false,
+ ?bool $dispEq = false,
+ ?float $backward = null,
+ ?float $forward = null,
+ ?float $intercept = null,
+ ?string $name = null
+ ): self {
+ if (!empty($trendLineType)) {
+ $this->setTrendLineType($trendLineType);
+ }
+ if ($order !== null) {
+ $this->setOrder($order);
+ }
+ if ($period !== null) {
+ $this->setPeriod($period);
+ }
+ if ($dispRSqr !== null) {
+ $this->setDispRSqr($dispRSqr);
+ }
+ if ($dispEq !== null) {
+ $this->setDispEq($dispEq);
+ }
+ if ($backward !== null) {
+ $this->setBackward($backward);
+ }
+ if ($forward !== null) {
+ $this->setForward($forward);
+ }
+ if ($intercept !== null) {
+ $this->setIntercept($intercept);
+ }
+ if ($name !== null) {
+ $this->setName($name);
+ }
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/Cells.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/Cells.php
new file mode 100644
index 00000000..c1174532
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/Cells.php
@@ -0,0 +1,475 @@
+parent = $parent;
+ $this->cache = $cache;
+ $this->cachePrefix = $this->getUniqueID();
+ }
+
+ /**
+ * Return the parent worksheet for this cell collection.
+ */
+ public function getParent(): ?Worksheet
+ {
+ return $this->parent;
+ }
+
+ /**
+ * Whether the collection holds a cell for the given coordinate.
+ *
+ * @param string $cellCoordinate Coordinate of the cell to check
+ */
+ public function has(string $cellCoordinate): bool
+ {
+ return ($cellCoordinate === $this->currentCoordinate) || isset($this->index[$cellCoordinate]);
+ }
+
+ /**
+ * Add or update a cell in the collection.
+ *
+ * @param Cell $cell Cell to update
+ */
+ public function update(Cell $cell): Cell
+ {
+ return $this->add($cell->getCoordinate(), $cell);
+ }
+
+ /**
+ * Delete a cell in cache identified by coordinate.
+ *
+ * @param string $cellCoordinate Coordinate of the cell to delete
+ */
+ public function delete(string $cellCoordinate): void
+ {
+ if ($cellCoordinate === $this->currentCoordinate && $this->currentCell !== null) {
+ $this->currentCell->detach();
+ $this->currentCoordinate = null;
+ $this->currentCell = null;
+ $this->currentCellIsDirty = false;
+ }
+
+ unset($this->index[$cellCoordinate]);
+
+ // Delete the entry from cache
+ $this->cache->delete($this->cachePrefix . $cellCoordinate);
+ }
+
+ /**
+ * Get a list of all cell coordinates currently held in the collection.
+ *
+ * @return string[]
+ */
+ public function getCoordinates(): array
+ {
+ return array_keys($this->index);
+ }
+
+ /**
+ * Get a sorted list of all cell coordinates currently held in the collection by row and column.
+ *
+ * @return string[]
+ */
+ public function getSortedCoordinates(): array
+ {
+ asort($this->index);
+
+ return array_keys($this->index);
+ }
+
+ /**
+ * Get a sorted list of all cell coordinates currently held in the collection by index (16384*row+column).
+ *
+ * @return int[]
+ */
+ public function getSortedCoordinatesInt(): array
+ {
+ asort($this->index);
+
+ return array_values($this->index);
+ }
+
+ /**
+ * Return the cell coordinate of the currently active cell object.
+ */
+ public function getCurrentCoordinate(): ?string
+ {
+ return $this->currentCoordinate;
+ }
+
+ /**
+ * Return the column coordinate of the currently active cell object.
+ */
+ public function getCurrentColumn(): string
+ {
+ $column = 0;
+ $row = '';
+ sscanf($this->currentCoordinate ?? '', '%[A-Z]%d', $column, $row);
+
+ return (string) $column;
+ }
+
+ /**
+ * Return the row coordinate of the currently active cell object.
+ */
+ public function getCurrentRow(): int
+ {
+ $column = 0;
+ $row = '';
+ sscanf($this->currentCoordinate ?? '', '%[A-Z]%d', $column, $row);
+
+ return (int) $row;
+ }
+
+ /**
+ * Get highest worksheet column and highest row that have cell records.
+ *
+ * @return array Highest column name and highest row number
+ */
+ public function getHighestRowAndColumn(): array
+ {
+ // Lookup highest column and highest row
+ $maxRow = $maxColumn = 1;
+ foreach ($this->index as $coordinate) {
+ $row = (int) floor(($coordinate - 1) / self::MAX_COLUMN_ID) + 1;
+ $maxRow = ($maxRow > $row) ? $maxRow : $row;
+ $column = ($coordinate % self::MAX_COLUMN_ID) ?: self::MAX_COLUMN_ID;
+ $maxColumn = ($maxColumn > $column) ? $maxColumn : $column;
+ }
+
+ return [
+ 'row' => $maxRow,
+ 'column' => Coordinate::stringFromColumnIndex($maxColumn),
+ ];
+ }
+
+ /**
+ * Get highest worksheet column.
+ *
+ * @param null|int|string $row Return the highest column for the specified row,
+ * or the highest column of any row if no row number is passed
+ *
+ * @return string Highest column name
+ */
+ public function getHighestColumn($row = null): string
+ {
+ if ($row === null) {
+ return $this->getHighestRowAndColumn()['column'];
+ }
+
+ $row = (int) $row;
+ if ($row <= 0) {
+ throw new PhpSpreadsheetException('Row number must be a positive integer');
+ }
+
+ $maxColumn = 1;
+ $toRow = $row * self::MAX_COLUMN_ID;
+ $fromRow = --$row * self::MAX_COLUMN_ID;
+ foreach ($this->index as $coordinate) {
+ if ($coordinate < $fromRow || $coordinate >= $toRow) {
+ continue;
+ }
+ $column = ($coordinate % self::MAX_COLUMN_ID) ?: self::MAX_COLUMN_ID;
+ $maxColumn = $maxColumn > $column ? $maxColumn : $column;
+ }
+
+ return Coordinate::stringFromColumnIndex($maxColumn);
+ }
+
+ /**
+ * Get highest worksheet row.
+ *
+ * @param null|string $column Return the highest row for the specified column,
+ * or the highest row of any column if no column letter is passed
+ *
+ * @return int Highest row number
+ */
+ public function getHighestRow(?string $column = null): int
+ {
+ if ($column === null) {
+ return $this->getHighestRowAndColumn()['row'];
+ }
+
+ $maxRow = 1;
+ $columnIndex = Coordinate::columnIndexFromString($column);
+ foreach ($this->index as $coordinate) {
+ if ($coordinate % self::MAX_COLUMN_ID !== $columnIndex) {
+ continue;
+ }
+ $row = (int) floor($coordinate / self::MAX_COLUMN_ID) + 1;
+ $maxRow = ($maxRow > $row) ? $maxRow : $row;
+ }
+
+ return $maxRow;
+ }
+
+ /**
+ * Generate a unique ID for cache referencing.
+ *
+ * @return string Unique Reference
+ */
+ private function getUniqueID(): string
+ {
+ $cacheType = Settings::getCache();
+
+ return ($cacheType instanceof Memory\SimpleCache1 || $cacheType instanceof Memory\SimpleCache3)
+ ? random_bytes(7) . ':'
+ : uniqid('phpspreadsheet.', true) . '.';
+ }
+
+ /**
+ * Clone the cell collection.
+ */
+ public function cloneCellCollection(Worksheet $worksheet): static
+ {
+ $this->storeCurrentCell();
+ $newCollection = clone $this;
+
+ $newCollection->parent = $worksheet;
+ $newCollection->cachePrefix = $newCollection->getUniqueID();
+
+ foreach ($this->index as $key => $value) {
+ $newCollection->index[$key] = $value;
+ $stored = $newCollection->cache->set(
+ $newCollection->cachePrefix . $key,
+ clone $this->getCache($key)
+ );
+ if ($stored === false) {
+ $this->destructIfNeeded($newCollection, 'Failed to copy cells in cache');
+ }
+ }
+
+ return $newCollection;
+ }
+
+ /**
+ * Remove a row, deleting all cells in that row.
+ *
+ * @param int|string $row Row number to remove
+ */
+ public function removeRow($row): void
+ {
+ $this->storeCurrentCell();
+ $row = (int) $row;
+ if ($row <= 0) {
+ throw new PhpSpreadsheetException('Row number must be a positive integer');
+ }
+
+ $toRow = $row * self::MAX_COLUMN_ID;
+ $fromRow = --$row * self::MAX_COLUMN_ID;
+ foreach ($this->index as $coordinate) {
+ if ($coordinate >= $fromRow && $coordinate < $toRow) {
+ $row = (int) floor($coordinate / self::MAX_COLUMN_ID) + 1;
+ $column = Coordinate::stringFromColumnIndex($coordinate % self::MAX_COLUMN_ID);
+ $this->delete("{$column}{$row}");
+ }
+ }
+ }
+
+ /**
+ * Remove a column, deleting all cells in that column.
+ *
+ * @param string $column Column ID to remove
+ */
+ public function removeColumn(string $column): void
+ {
+ $this->storeCurrentCell();
+
+ $columnIndex = Coordinate::columnIndexFromString($column);
+ foreach ($this->index as $coordinate) {
+ if ($coordinate % self::MAX_COLUMN_ID === $columnIndex) {
+ $row = (int) floor($coordinate / self::MAX_COLUMN_ID) + 1;
+ $column = Coordinate::stringFromColumnIndex($coordinate % self::MAX_COLUMN_ID);
+ $this->delete("{$column}{$row}");
+ }
+ }
+ }
+
+ /**
+ * Store cell data in cache for the current cell object if it's "dirty",
+ * and the 'nullify' the current cell object.
+ */
+ private function storeCurrentCell(): void
+ {
+ if ($this->currentCellIsDirty && isset($this->currentCoordinate, $this->currentCell)) {
+ $this->currentCell->detach();
+
+ $stored = $this->cache->set($this->cachePrefix . $this->currentCoordinate, $this->currentCell);
+ if ($stored === false) {
+ $this->destructIfNeeded($this, "Failed to store cell {$this->currentCoordinate} in cache");
+ }
+ $this->currentCellIsDirty = false;
+ }
+
+ $this->currentCoordinate = null;
+ $this->currentCell = null;
+ }
+
+ private function destructIfNeeded(self $cells, string $message): void
+ {
+ $cells->__destruct();
+
+ throw new PhpSpreadsheetException($message);
+ }
+
+ /**
+ * Add or update a cell identified by its coordinate into the collection.
+ *
+ * @param string $cellCoordinate Coordinate of the cell to update
+ * @param Cell $cell Cell to update
+ */
+ public function add(string $cellCoordinate, Cell $cell): Cell
+ {
+ if ($cellCoordinate !== $this->currentCoordinate) {
+ $this->storeCurrentCell();
+ }
+ $column = 0;
+ $row = '';
+ sscanf($cellCoordinate, '%[A-Z]%d', $column, $row);
+ $this->index[$cellCoordinate] = (--$row * self::MAX_COLUMN_ID) + Coordinate::columnIndexFromString((string) $column);
+
+ $this->currentCoordinate = $cellCoordinate;
+ $this->currentCell = $cell;
+ $this->currentCellIsDirty = true;
+
+ return $cell;
+ }
+
+ /**
+ * Get cell at a specific coordinate.
+ *
+ * @param string $cellCoordinate Coordinate of the cell
+ *
+ * @return null|Cell Cell that was found, or null if not found
+ */
+ public function get(string $cellCoordinate): ?Cell
+ {
+ if ($cellCoordinate === $this->currentCoordinate) {
+ return $this->currentCell;
+ }
+ $this->storeCurrentCell();
+
+ // Return null if requested entry doesn't exist in collection
+ if ($this->has($cellCoordinate) === false) {
+ return null;
+ }
+
+ $cell = $this->getcache($cellCoordinate);
+
+ // Set current entry to the requested entry
+ $this->currentCoordinate = $cellCoordinate;
+ $this->currentCell = $cell;
+ // Re-attach this as the cell's parent
+ $this->currentCell->attach($this);
+
+ // Return requested entry
+ return $this->currentCell;
+ }
+
+ /**
+ * Clear the cell collection and disconnect from our parent.
+ */
+ public function unsetWorksheetCells(): void
+ {
+ if ($this->currentCell !== null) {
+ $this->currentCell->detach();
+ $this->currentCell = null;
+ $this->currentCoordinate = null;
+ }
+
+ // Flush the cache
+ $this->__destruct();
+
+ $this->index = [];
+
+ // detach ourself from the worksheet, so that it can then delete this object successfully
+ $this->parent = null;
+ }
+
+ /**
+ * Destroy this cell collection.
+ */
+ public function __destruct()
+ {
+ $this->cache->deleteMultiple($this->getAllCacheKeys());
+ $this->parent = null;
+ }
+
+ /**
+ * Returns all known cache keys.
+ *
+ * @return iterable
+ */
+ private function getAllCacheKeys(): iterable
+ {
+ foreach ($this->index as $coordinate => $value) {
+ yield $this->cachePrefix . $coordinate;
+ }
+ }
+
+ private function getCache(string $cellCoordinate): Cell
+ {
+ $cell = $this->cache->get($this->cachePrefix . $cellCoordinate);
+ if (!($cell instanceof Cell)) {
+ throw new PhpSpreadsheetException("Cell entry {$cellCoordinate} no longer exists in cache. This probably means that the cache was cleared by someone else.");
+ }
+
+ return $cell;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/CellsFactory.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/CellsFactory.php
new file mode 100644
index 00000000..b3833bd8
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/CellsFactory.php
@@ -0,0 +1,20 @@
+cache = [];
+
+ return true;
+ }
+
+ public function delete($key): bool
+ {
+ unset($this->cache[$key]);
+
+ return true;
+ }
+
+ public function deleteMultiple($keys): bool
+ {
+ foreach ($keys as $key) {
+ $this->delete($key);
+ }
+
+ return true;
+ }
+
+ public function get($key, $default = null): mixed
+ {
+ if ($this->has($key)) {
+ return $this->cache[$key];
+ }
+
+ return $default;
+ }
+
+ public function getMultiple($keys, $default = null): iterable
+ {
+ $results = [];
+ foreach ($keys as $key) {
+ $results[$key] = $this->get($key, $default);
+ }
+
+ return $results;
+ }
+
+ public function has($key): bool
+ {
+ return array_key_exists($key, $this->cache);
+ }
+
+ public function set($key, $value, $ttl = null): bool
+ {
+ $this->cache[$key] = $value;
+
+ return true;
+ }
+
+ public function setMultiple($values, $ttl = null): bool
+ {
+ foreach ($values as $key => $value) {
+ $this->set($key, $value);
+ }
+
+ return true;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/Memory/SimpleCache3.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/Memory/SimpleCache3.php
new file mode 100644
index 00000000..7b6c460b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Collection/Memory/SimpleCache3.php
@@ -0,0 +1,80 @@
+cache = [];
+
+ return true;
+ }
+
+ public function delete(string $key): bool
+ {
+ unset($this->cache[$key]);
+
+ return true;
+ }
+
+ public function deleteMultiple(iterable $keys): bool
+ {
+ foreach ($keys as $key) {
+ $this->delete($key);
+ }
+
+ return true;
+ }
+
+ public function get(string $key, mixed $default = null): mixed
+ {
+ if ($this->has($key)) {
+ return $this->cache[$key];
+ }
+
+ return $default;
+ }
+
+ public function getMultiple(iterable $keys, mixed $default = null): iterable
+ {
+ $results = [];
+ foreach ($keys as $key) {
+ $results[$key] = $this->get($key, $default);
+ }
+
+ return $results;
+ }
+
+ public function has(string $key): bool
+ {
+ return array_key_exists($key, $this->cache);
+ }
+
+ public function set(string $key, mixed $value, null|int|DateInterval $ttl = null): bool
+ {
+ $this->cache[$key] = $value;
+
+ return true;
+ }
+
+ public function setMultiple(iterable $values, null|int|DateInterval $ttl = null): bool
+ {
+ foreach ($values as $key => $value) {
+ $this->set($key, $value);
+ }
+
+ return true;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Comment.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Comment.php
new file mode 100644
index 00000000..2e18270c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Comment.php
@@ -0,0 +1,358 @@
+author = 'Author';
+ $this->text = new RichText();
+ $this->fillColor = new Color('FFFFFFE1');
+ $this->alignment = Alignment::HORIZONTAL_GENERAL;
+ $this->backgroundImage = new Drawing();
+ }
+
+ /**
+ * Get Author.
+ */
+ public function getAuthor(): string
+ {
+ return $this->author;
+ }
+
+ /**
+ * Set Author.
+ */
+ public function setAuthor(string $author): self
+ {
+ $this->author = $author;
+
+ return $this;
+ }
+
+ /**
+ * Get Rich text comment.
+ */
+ public function getText(): RichText
+ {
+ return $this->text;
+ }
+
+ /**
+ * Set Rich text comment.
+ */
+ public function setText(RichText $text): self
+ {
+ $this->text = $text;
+
+ return $this;
+ }
+
+ /**
+ * Get comment width (CSS style, i.e. XXpx or YYpt).
+ */
+ public function getWidth(): string
+ {
+ return $this->width;
+ }
+
+ /**
+ * Set comment width (CSS style, i.e. XXpx or YYpt). Default unit is pt.
+ */
+ public function setWidth(string $width): self
+ {
+ $width = new Size($width);
+ if ($width->valid()) {
+ $this->width = (string) $width;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get comment height (CSS style, i.e. XXpx or YYpt).
+ */
+ public function getHeight(): string
+ {
+ return $this->height;
+ }
+
+ /**
+ * Set comment height (CSS style, i.e. XXpx or YYpt). Default unit is pt.
+ */
+ public function setHeight(string $height): self
+ {
+ $height = new Size($height);
+ if ($height->valid()) {
+ $this->height = (string) $height;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get left margin (CSS style, i.e. XXpx or YYpt).
+ */
+ public function getMarginLeft(): string
+ {
+ return $this->marginLeft;
+ }
+
+ /**
+ * Set left margin (CSS style, i.e. XXpx or YYpt). Default unit is pt.
+ */
+ public function setMarginLeft(string $margin): self
+ {
+ $margin = new Size($margin);
+ if ($margin->valid()) {
+ $this->marginLeft = (string) $margin;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get top margin (CSS style, i.e. XXpx or YYpt).
+ */
+ public function getMarginTop(): string
+ {
+ return $this->marginTop;
+ }
+
+ /**
+ * Set top margin (CSS style, i.e. XXpx or YYpt). Default unit is pt.
+ */
+ public function setMarginTop(string $margin): self
+ {
+ $margin = new Size($margin);
+ if ($margin->valid()) {
+ $this->marginTop = (string) $margin;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Is the comment visible by default?
+ */
+ public function getVisible(): bool
+ {
+ return $this->visible;
+ }
+
+ /**
+ * Set comment default visibility.
+ */
+ public function setVisible(bool $visibility): self
+ {
+ $this->visible = $visibility;
+
+ return $this;
+ }
+
+ /**
+ * Set fill color.
+ */
+ public function setFillColor(Color $color): self
+ {
+ $this->fillColor = $color;
+
+ return $this;
+ }
+
+ /**
+ * Get fill color.
+ */
+ public function getFillColor(): Color
+ {
+ return $this->fillColor;
+ }
+
+ public function setAlignment(string $alignment): self
+ {
+ $this->alignment = $alignment;
+
+ return $this;
+ }
+
+ public function getAlignment(): string
+ {
+ return $this->alignment;
+ }
+
+ public function setTextboxDirection(string $textboxDirection): self
+ {
+ $this->textboxDirection = $textboxDirection;
+
+ return $this;
+ }
+
+ public function getTextboxDirection(): string
+ {
+ return $this->textboxDirection;
+ }
+
+ /**
+ * Get hash code.
+ */
+ public function getHashCode(): string
+ {
+ return md5(
+ $this->author
+ . $this->text->getHashCode()
+ . $this->width
+ . $this->height
+ . $this->marginLeft
+ . $this->marginTop
+ . ($this->visible ? 1 : 0)
+ . $this->fillColor->getHashCode()
+ . $this->alignment
+ . $this->textboxDirection
+ . ($this->hasBackgroundImage() ? $this->backgroundImage->getHashCode() : '')
+ . __CLASS__
+ );
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $vars = get_object_vars($this);
+ foreach ($vars as $key => $value) {
+ if (is_object($value)) {
+ $this->$key = clone $value;
+ } else {
+ $this->$key = $value;
+ }
+ }
+ }
+
+ /**
+ * Convert to string.
+ */
+ public function __toString(): string
+ {
+ return $this->text->getPlainText();
+ }
+
+ /**
+ * Check is background image exists.
+ */
+ public function hasBackgroundImage(): bool
+ {
+ $path = $this->backgroundImage->getPath();
+
+ if (empty($path)) {
+ return false;
+ }
+
+ return getimagesize($path) !== false;
+ }
+
+ /**
+ * Returns background image.
+ */
+ public function getBackgroundImage(): Drawing
+ {
+ return $this->backgroundImage;
+ }
+
+ /**
+ * Sets background image.
+ */
+ public function setBackgroundImage(Drawing $objDrawing): self
+ {
+ if (!array_key_exists($objDrawing->getType(), Drawing::IMAGE_TYPES_CONVERTION_MAP)) {
+ throw new PhpSpreadsheetException('Unsupported image type in comment background. Supported types: PNG, JPEG, BMP, GIF.');
+ }
+ $this->backgroundImage = $objDrawing;
+
+ return $this;
+ }
+
+ /**
+ * Sets size of comment as size of background image.
+ */
+ public function setSizeAsBackgroundImage(): self
+ {
+ if ($this->hasBackgroundImage()) {
+ $this->setWidth(SharedDrawing::pixelsToPoints($this->backgroundImage->getWidth()) . 'pt');
+ $this->setHeight(SharedDrawing::pixelsToPoints($this->backgroundImage->getHeight()) . 'pt');
+ }
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/DefinedName.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/DefinedName.php
new file mode 100644
index 00000000..686e56e1
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/DefinedName.php
@@ -0,0 +1,269 @@
+worksheet).
+ */
+ protected bool $localOnly;
+
+ /**
+ * Scope.
+ */
+ protected ?Worksheet $scope;
+
+ /**
+ * Whether this is a named range or a named formula.
+ */
+ protected bool $isFormula;
+
+ /**
+ * Create a new Defined Name.
+ */
+ public function __construct(
+ string $name,
+ ?Worksheet $worksheet = null,
+ ?string $value = null,
+ bool $localOnly = false,
+ ?Worksheet $scope = null
+ ) {
+ if ($worksheet === null) {
+ $worksheet = $scope;
+ }
+
+ // Set local members
+ $this->name = $name;
+ $this->worksheet = $worksheet;
+ $this->value = (string) $value;
+ $this->localOnly = $localOnly;
+ // If local only, then the scope will be set to worksheet unless a scope is explicitly set
+ $this->scope = ($localOnly === true) ? (($scope === null) ? $worksheet : $scope) : null;
+ // If the range string contains characters that aren't associated with the range definition (A-Z,1-9
+ // for cell references, and $, or the range operators (colon comma or space), quotes and ! for
+ // worksheet names
+ // then this is treated as a named formula, and not a named range
+ $this->isFormula = self::testIfFormula($this->value);
+ }
+
+ public function __destruct()
+ {
+ $this->worksheet = null;
+ $this->scope = null;
+ }
+
+ /**
+ * Create a new defined name, either a range or a formula.
+ */
+ public static function createInstance(
+ string $name,
+ ?Worksheet $worksheet = null,
+ ?string $value = null,
+ bool $localOnly = false,
+ ?Worksheet $scope = null
+ ): self {
+ $value = (string) $value;
+ $isFormula = self::testIfFormula($value);
+ if ($isFormula) {
+ return new NamedFormula($name, $worksheet, $value, $localOnly, $scope);
+ }
+
+ return new NamedRange($name, $worksheet, $value, $localOnly, $scope);
+ }
+
+ public static function testIfFormula(string $value): bool
+ {
+ if (str_starts_with($value, '=')) {
+ $value = substr($value, 1);
+ }
+
+ if (is_numeric($value)) {
+ return true;
+ }
+
+ $segMatcher = false;
+ foreach (explode("'", $value) as $subVal) {
+ // Only test in alternate array entries (the non-quoted blocks)
+ $segMatcher = $segMatcher === false;
+ if (
+ $segMatcher
+ && (preg_match('/' . self::REGEXP_IDENTIFY_FORMULA . '/miu', $subVal))
+ ) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Get name.
+ */
+ public function getName(): string
+ {
+ return $this->name;
+ }
+
+ /**
+ * Set name.
+ */
+ public function setName(string $name): self
+ {
+ if (!empty($name)) {
+ // Old title
+ $oldTitle = $this->name;
+
+ // Re-attach
+ if ($this->worksheet !== null) {
+ $this->worksheet->getParentOrThrow()->removeNamedRange($this->name, $this->worksheet);
+ }
+ $this->name = $name;
+
+ if ($this->worksheet !== null) {
+ $this->worksheet->getParentOrThrow()->addDefinedName($this);
+ }
+
+ if ($this->worksheet !== null) {
+ // New title
+ $newTitle = $this->name;
+ ReferenceHelper::getInstance()->updateNamedFormulae($this->worksheet->getParentOrThrow(), $oldTitle, $newTitle);
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get worksheet.
+ */
+ public function getWorksheet(): ?Worksheet
+ {
+ return $this->worksheet;
+ }
+
+ /**
+ * Set worksheet.
+ */
+ public function setWorksheet(?Worksheet $worksheet): self
+ {
+ $this->worksheet = $worksheet;
+
+ return $this;
+ }
+
+ /**
+ * Get range or formula value.
+ */
+ public function getValue(): string
+ {
+ return $this->value;
+ }
+
+ /**
+ * Set range or formula value.
+ */
+ public function setValue(string $value): self
+ {
+ $this->value = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get localOnly.
+ */
+ public function getLocalOnly(): bool
+ {
+ return $this->localOnly;
+ }
+
+ /**
+ * Set localOnly.
+ */
+ public function setLocalOnly(bool $localScope): self
+ {
+ $this->localOnly = $localScope;
+ $this->scope = $localScope ? $this->worksheet : null;
+
+ return $this;
+ }
+
+ /**
+ * Get scope.
+ */
+ public function getScope(): ?Worksheet
+ {
+ return $this->scope;
+ }
+
+ /**
+ * Set scope.
+ */
+ public function setScope(?Worksheet $worksheet): self
+ {
+ $this->scope = $worksheet;
+ $this->localOnly = $worksheet !== null;
+
+ return $this;
+ }
+
+ /**
+ * Identify whether this is a named range or a named formula.
+ */
+ public function isFormula(): bool
+ {
+ return $this->isFormula;
+ }
+
+ /**
+ * Resolve a named range to a regular cell range or formula.
+ */
+ public static function resolveName(string $definedName, Worksheet $worksheet, string $sheetName = ''): ?self
+ {
+ if ($sheetName === '') {
+ $worksheet2 = $worksheet;
+ } else {
+ $worksheet2 = $worksheet->getParentOrThrow()->getSheetByName($sheetName);
+ if ($worksheet2 === null) {
+ return null;
+ }
+ }
+
+ return $worksheet->getParentOrThrow()->getDefinedName($definedName, $worksheet2);
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $vars = get_object_vars($this);
+ foreach ($vars as $key => $value) {
+ if (is_object($value)) {
+ $this->$key = clone $value;
+ } else {
+ $this->$key = $value;
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Document/Properties.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Document/Properties.php
new file mode 100644
index 00000000..57621691
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Document/Properties.php
@@ -0,0 +1,509 @@
+lastModifiedBy = $this->creator;
+ $this->created = self::intOrFloatTimestamp(null);
+ $this->modified = $this->created;
+ }
+
+ /**
+ * Get Creator.
+ */
+ public function getCreator(): string
+ {
+ return $this->creator;
+ }
+
+ /**
+ * Set Creator.
+ *
+ * @return $this
+ */
+ public function setCreator(string $creator): self
+ {
+ $this->creator = $creator;
+
+ return $this;
+ }
+
+ /**
+ * Get Last Modified By.
+ */
+ public function getLastModifiedBy(): string
+ {
+ return $this->lastModifiedBy;
+ }
+
+ /**
+ * Set Last Modified By.
+ *
+ * @return $this
+ */
+ public function setLastModifiedBy(string $modifiedBy): self
+ {
+ $this->lastModifiedBy = $modifiedBy;
+
+ return $this;
+ }
+
+ private static function intOrFloatTimestamp(null|bool|float|int|string $timestamp): float|int
+ {
+ if ($timestamp === null || is_bool($timestamp)) {
+ $timestamp = (float) (new DateTime())->format('U');
+ } elseif (is_string($timestamp)) {
+ if (is_numeric($timestamp)) {
+ $timestamp = (float) $timestamp;
+ } else {
+ $timestamp = (string) preg_replace('/[.][0-9]*$/', '', $timestamp);
+ $timestamp = (string) preg_replace('/^(\\d{4})- (\\d)/', '$1-0$2', $timestamp);
+ $timestamp = (string) preg_replace('/^(\\d{4}-\\d{2})- (\\d)/', '$1-0$2', $timestamp);
+ $timestamp = (float) (new DateTime($timestamp))->format('U');
+ }
+ }
+
+ return IntOrFloat::evaluate($timestamp);
+ }
+
+ /**
+ * Get Created.
+ */
+ public function getCreated(): float|int
+ {
+ return $this->created;
+ }
+
+ /**
+ * Set Created.
+ *
+ * @return $this
+ */
+ public function setCreated(null|float|int|string $timestamp): self
+ {
+ $this->created = self::intOrFloatTimestamp($timestamp);
+
+ return $this;
+ }
+
+ /**
+ * Get Modified.
+ */
+ public function getModified(): float|int
+ {
+ return $this->modified;
+ }
+
+ /**
+ * Set Modified.
+ *
+ * @return $this
+ */
+ public function setModified(null|float|int|string $timestamp): self
+ {
+ $this->modified = self::intOrFloatTimestamp($timestamp);
+
+ return $this;
+ }
+
+ /**
+ * Get Title.
+ */
+ public function getTitle(): string
+ {
+ return $this->title;
+ }
+
+ /**
+ * Set Title.
+ *
+ * @return $this
+ */
+ public function setTitle(string $title): self
+ {
+ $this->title = $title;
+
+ return $this;
+ }
+
+ /**
+ * Get Description.
+ */
+ public function getDescription(): string
+ {
+ return $this->description;
+ }
+
+ /**
+ * Set Description.
+ *
+ * @return $this
+ */
+ public function setDescription(string $description): self
+ {
+ $this->description = $description;
+
+ return $this;
+ }
+
+ /**
+ * Get Subject.
+ */
+ public function getSubject(): string
+ {
+ return $this->subject;
+ }
+
+ /**
+ * Set Subject.
+ *
+ * @return $this
+ */
+ public function setSubject(string $subject): self
+ {
+ $this->subject = $subject;
+
+ return $this;
+ }
+
+ /**
+ * Get Keywords.
+ */
+ public function getKeywords(): string
+ {
+ return $this->keywords;
+ }
+
+ /**
+ * Set Keywords.
+ *
+ * @return $this
+ */
+ public function setKeywords(string $keywords): self
+ {
+ $this->keywords = $keywords;
+
+ return $this;
+ }
+
+ /**
+ * Get Category.
+ */
+ public function getCategory(): string
+ {
+ return $this->category;
+ }
+
+ /**
+ * Set Category.
+ *
+ * @return $this
+ */
+ public function setCategory(string $category): self
+ {
+ $this->category = $category;
+
+ return $this;
+ }
+
+ /**
+ * Get Company.
+ */
+ public function getCompany(): string
+ {
+ return $this->company;
+ }
+
+ /**
+ * Set Company.
+ *
+ * @return $this
+ */
+ public function setCompany(string $company): self
+ {
+ $this->company = $company;
+
+ return $this;
+ }
+
+ /**
+ * Get Manager.
+ */
+ public function getManager(): string
+ {
+ return $this->manager;
+ }
+
+ /**
+ * Set Manager.
+ *
+ * @return $this
+ */
+ public function setManager(string $manager): self
+ {
+ $this->manager = $manager;
+
+ return $this;
+ }
+
+ /**
+ * Get a List of Custom Property Names.
+ *
+ * @return string[]
+ */
+ public function getCustomProperties(): array
+ {
+ return array_keys($this->customProperties);
+ }
+
+ /**
+ * Check if a Custom Property is defined.
+ */
+ public function isCustomPropertySet(string $propertyName): bool
+ {
+ return array_key_exists($propertyName, $this->customProperties);
+ }
+
+ /**
+ * Get a Custom Property Value.
+ */
+ public function getCustomPropertyValue(string $propertyName): bool|int|float|string|null
+ {
+ if (isset($this->customProperties[$propertyName])) {
+ return $this->customProperties[$propertyName]['value'];
+ }
+
+ return null;
+ }
+
+ /**
+ * Get a Custom Property Type.
+ */
+ public function getCustomPropertyType(string $propertyName): ?string
+ {
+ return $this->customProperties[$propertyName]['type'] ?? null;
+ }
+
+ private function identifyPropertyType(bool|int|float|string|null $propertyValue): string
+ {
+ if (is_float($propertyValue)) {
+ return self::PROPERTY_TYPE_FLOAT;
+ }
+ if (is_int($propertyValue)) {
+ return self::PROPERTY_TYPE_INTEGER;
+ }
+ if (is_bool($propertyValue)) {
+ return self::PROPERTY_TYPE_BOOLEAN;
+ }
+
+ return self::PROPERTY_TYPE_STRING;
+ }
+
+ /**
+ * Set a Custom Property.
+ *
+ * @param ?string $propertyType see `self::VALID_PROPERTY_TYPE_LIST`
+ *
+ * @return $this
+ */
+ public function setCustomProperty(string $propertyName, bool|int|float|string|null $propertyValue = '', ?string $propertyType = null): self
+ {
+ if (($propertyType === null) || (!in_array($propertyType, self::VALID_PROPERTY_TYPE_LIST))) {
+ $propertyType = $this->identifyPropertyType($propertyValue);
+ }
+
+ $this->customProperties[$propertyName] = [
+ 'value' => self::convertProperty($propertyValue, $propertyType),
+ 'type' => $propertyType,
+ ];
+
+ return $this;
+ }
+
+ private const PROPERTY_TYPE_ARRAY = [
+ 'i' => self::PROPERTY_TYPE_INTEGER, // Integer
+ 'i1' => self::PROPERTY_TYPE_INTEGER, // 1-Byte Signed Integer
+ 'i2' => self::PROPERTY_TYPE_INTEGER, // 2-Byte Signed Integer
+ 'i4' => self::PROPERTY_TYPE_INTEGER, // 4-Byte Signed Integer
+ 'i8' => self::PROPERTY_TYPE_INTEGER, // 8-Byte Signed Integer
+ 'int' => self::PROPERTY_TYPE_INTEGER, // Integer
+ 'ui1' => self::PROPERTY_TYPE_INTEGER, // 1-Byte Unsigned Integer
+ 'ui2' => self::PROPERTY_TYPE_INTEGER, // 2-Byte Unsigned Integer
+ 'ui4' => self::PROPERTY_TYPE_INTEGER, // 4-Byte Unsigned Integer
+ 'ui8' => self::PROPERTY_TYPE_INTEGER, // 8-Byte Unsigned Integer
+ 'uint' => self::PROPERTY_TYPE_INTEGER, // Unsigned Integer
+ 'f' => self::PROPERTY_TYPE_FLOAT, // Real Number
+ 'r4' => self::PROPERTY_TYPE_FLOAT, // 4-Byte Real Number
+ 'r8' => self::PROPERTY_TYPE_FLOAT, // 8-Byte Real Number
+ 'decimal' => self::PROPERTY_TYPE_FLOAT, // Decimal
+ 's' => self::PROPERTY_TYPE_STRING, // String
+ 'empty' => self::PROPERTY_TYPE_STRING, // Empty
+ 'null' => self::PROPERTY_TYPE_STRING, // Null
+ 'lpstr' => self::PROPERTY_TYPE_STRING, // LPSTR
+ 'lpwstr' => self::PROPERTY_TYPE_STRING, // LPWSTR
+ 'bstr' => self::PROPERTY_TYPE_STRING, // Basic String
+ 'd' => self::PROPERTY_TYPE_DATE, // Date and Time
+ 'date' => self::PROPERTY_TYPE_DATE, // Date and Time
+ 'filetime' => self::PROPERTY_TYPE_DATE, // File Time
+ 'b' => self::PROPERTY_TYPE_BOOLEAN, // Boolean
+ 'bool' => self::PROPERTY_TYPE_BOOLEAN, // Boolean
+ ];
+
+ private const SPECIAL_TYPES = [
+ 'empty' => '',
+ 'null' => null,
+ ];
+
+ /**
+ * Convert property to form desired by Excel.
+ */
+ public static function convertProperty(bool|int|float|string|null $propertyValue, string $propertyType): bool|int|float|string|null
+ {
+ return self::SPECIAL_TYPES[$propertyType] ?? self::convertProperty2($propertyValue, $propertyType);
+ }
+
+ /**
+ * Convert property to form desired by Excel.
+ */
+ private static function convertProperty2(bool|int|float|string|null $propertyValue, string $type): bool|int|float|string|null
+ {
+ $propertyType = self::convertPropertyType($type);
+ switch ($propertyType) {
+ case self::PROPERTY_TYPE_INTEGER:
+ $intValue = (int) $propertyValue;
+
+ return ($type[0] === 'u') ? abs($intValue) : $intValue;
+ case self::PROPERTY_TYPE_FLOAT:
+ return (float) $propertyValue;
+ case self::PROPERTY_TYPE_DATE:
+ return self::intOrFloatTimestamp($propertyValue);
+ case self::PROPERTY_TYPE_BOOLEAN:
+ return is_bool($propertyValue) ? $propertyValue : ($propertyValue === 'true');
+ default: // includes string
+ return $propertyValue;
+ }
+ }
+
+ public static function convertPropertyType(string $propertyType): string
+ {
+ return self::PROPERTY_TYPE_ARRAY[$propertyType] ?? self::PROPERTY_TYPE_UNKNOWN;
+ }
+
+ public function getHyperlinkBase(): string
+ {
+ return $this->hyperlinkBase;
+ }
+
+ public function setHyperlinkBase(string $hyperlinkBase): self
+ {
+ $this->hyperlinkBase = $hyperlinkBase;
+
+ return $this;
+ }
+
+ public function getViewport(): string
+ {
+ return $this->viewport;
+ }
+
+ public const SUGGESTED_VIEWPORT = 'width=device-width, initial-scale=1';
+
+ public function setViewport(string $viewport): self
+ {
+ $this->viewport = $viewport;
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Document/Security.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Document/Security.php
new file mode 100644
index 00000000..31a32beb
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Document/Security.php
@@ -0,0 +1,140 @@
+lockRevision
+ || $this->lockStructure
+ || $this->lockWindows;
+ }
+
+ public function getLockRevision(): bool
+ {
+ return $this->lockRevision;
+ }
+
+ public function setLockRevision(?bool $locked): self
+ {
+ if ($locked !== null) {
+ $this->lockRevision = $locked;
+ }
+
+ return $this;
+ }
+
+ public function getLockStructure(): bool
+ {
+ return $this->lockStructure;
+ }
+
+ public function setLockStructure(?bool $locked): self
+ {
+ if ($locked !== null) {
+ $this->lockStructure = $locked;
+ }
+
+ return $this;
+ }
+
+ public function getLockWindows(): bool
+ {
+ return $this->lockWindows;
+ }
+
+ public function setLockWindows(?bool $locked): self
+ {
+ if ($locked !== null) {
+ $this->lockWindows = $locked;
+ }
+
+ return $this;
+ }
+
+ public function getRevisionsPassword(): string
+ {
+ return $this->revisionsPassword;
+ }
+
+ /**
+ * Set RevisionsPassword.
+ *
+ * @param bool $alreadyHashed If the password has already been hashed, set this to true
+ *
+ * @return $this
+ */
+ public function setRevisionsPassword(?string $password, bool $alreadyHashed = false): static
+ {
+ if ($password !== null) {
+ if (!$alreadyHashed) {
+ $password = PasswordHasher::hashPassword($password);
+ }
+ $this->revisionsPassword = $password;
+ }
+
+ return $this;
+ }
+
+ public function getWorkbookPassword(): string
+ {
+ return $this->workbookPassword;
+ }
+
+ /**
+ * Set WorkbookPassword.
+ *
+ * @param bool $alreadyHashed If the password has already been hashed, set this to true
+ *
+ * @return $this
+ */
+ public function setWorkbookPassword(?string $password, bool $alreadyHashed = false): static
+ {
+ if ($password !== null) {
+ if (!$alreadyHashed) {
+ $password = PasswordHasher::hashPassword($password);
+ }
+ $this->workbookPassword = $password;
+ }
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Exception.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Exception.php
new file mode 100644
index 00000000..34915807
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Exception.php
@@ -0,0 +1,9 @@
+
+ */
+ protected array $items = [];
+
+ /**
+ * HashTable key map.
+ *
+ * @var array
+ */
+ protected array $keyMap = [];
+
+ /**
+ * Create a new HashTable.
+ *
+ * @param T[] $source Optional source array to create HashTable from
+ */
+ public function __construct(?array $source = [])
+ {
+ if ($source !== null) {
+ // Create HashTable
+ $this->addFromSource($source);
+ }
+ }
+
+ /**
+ * Add HashTable items from source.
+ *
+ * @param T[] $source Source array to create HashTable from
+ */
+ public function addFromSource(?array $source = null): void
+ {
+ // Check if an array was passed
+ if ($source === null) {
+ return;
+ }
+
+ foreach ($source as $item) {
+ $this->add($item);
+ }
+ }
+
+ /**
+ * Add HashTable item.
+ *
+ * @param T $source Item to add
+ */
+ public function add(IComparable $source): void
+ {
+ $hash = $source->getHashCode();
+ if (!isset($this->items[$hash])) {
+ $this->items[$hash] = $source;
+ $this->keyMap[count($this->items) - 1] = $hash;
+ }
+ }
+
+ /**
+ * Remove HashTable item.
+ *
+ * @param T $source Item to remove
+ */
+ public function remove(IComparable $source): void
+ {
+ $hash = $source->getHashCode();
+ if (isset($this->items[$hash])) {
+ unset($this->items[$hash]);
+
+ $deleteKey = -1;
+ foreach ($this->keyMap as $key => $value) {
+ if ($deleteKey >= 0) {
+ $this->keyMap[$key - 1] = $value;
+ }
+
+ if ($value == $hash) {
+ $deleteKey = $key;
+ }
+ }
+ unset($this->keyMap[count($this->keyMap) - 1]);
+ }
+ }
+
+ /**
+ * Clear HashTable.
+ */
+ public function clear(): void
+ {
+ $this->items = [];
+ $this->keyMap = [];
+ }
+
+ /**
+ * Count.
+ */
+ public function count(): int
+ {
+ return count($this->items);
+ }
+
+ /**
+ * Get index for hash code.
+ */
+ public function getIndexForHashCode(string $hashCode): false|int
+ {
+ return array_search($hashCode, $this->keyMap, true);
+ }
+
+ /**
+ * Get by index.
+ *
+ * @return null|T
+ */
+ public function getByIndex(int $index): ?IComparable
+ {
+ if (isset($this->keyMap[$index])) {
+ return $this->getByHashCode($this->keyMap[$index]);
+ }
+
+ return null;
+ }
+
+ /**
+ * Get by hashcode.
+ *
+ * @return null|T
+ */
+ public function getByHashCode(string $hashCode): ?IComparable
+ {
+ if (isset($this->items[$hashCode])) {
+ return $this->items[$hashCode];
+ }
+
+ return null;
+ }
+
+ /**
+ * HashTable to array.
+ *
+ * @return T[]
+ */
+ public function toArray(): array
+ {
+ return $this->items;
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $vars = get_object_vars($this);
+ foreach ($vars as $key => $value) {
+ // each member of this class is an array
+ if (is_array($value)) {
+ $array1 = $value;
+ foreach ($array1 as $key1 => $value1) {
+ if (is_object($value1)) {
+ $array1[$key1] = clone $value1;
+ }
+ }
+ $this->$key = $array1;
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Dimension.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Dimension.php
new file mode 100644
index 00000000..a729dfdf
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Dimension.php
@@ -0,0 +1,110 @@
+ 96.0 / 2.54,
+ self::UOM_MILLIMETERS => 96.0 / 25.4,
+ self::UOM_INCHES => 96.0,
+ self::UOM_PIXELS => 1.0,
+ self::UOM_POINTS => 96.0 / 72,
+ self::UOM_PICA => 96.0 * 12 / 72,
+ ];
+
+ /**
+ * Based on a standard column width of 8.54 units in MS Excel.
+ */
+ const RELATIVE_UNITS = [
+ 'em' => 10.0 / 8.54,
+ 'ex' => 10.0 / 8.54,
+ 'ch' => 10.0 / 8.54,
+ 'rem' => 10.0 / 8.54,
+ 'vw' => 8.54,
+ 'vh' => 8.54,
+ 'vmin' => 8.54,
+ 'vmax' => 8.54,
+ '%' => 8.54 / 100,
+ ];
+
+ /**
+ * @var float|int If this is a width, then size is measured in pixels (if is set)
+ * or in Excel's default column width units if $unit is null.
+ * If this is a height, then size is measured in pixels ()
+ * or in points () if $unit is null.
+ */
+ protected float|int $size;
+
+ protected ?string $unit = null;
+
+ /**
+ * Phpstan bug has been fixed; this function allows us to
+ * pass Phpstan whether fixed or not.
+ */
+ private static function stanBugFixed(array|int|null $value): array
+ {
+ return is_array($value) ? $value : [null, null];
+ }
+
+ public function __construct(string $dimension)
+ {
+ [$size, $unit] = self::stanBugFixed(sscanf($dimension, '%[1234567890.]%s'));
+ $unit = strtolower(trim($unit ?? ''));
+ $size = (float) $size;
+
+ // If a UoM is specified, then convert the size to pixels for internal storage
+ if (isset(self::ABSOLUTE_UNITS[$unit])) {
+ $size *= self::ABSOLUTE_UNITS[$unit];
+ $this->unit = self::UOM_PIXELS;
+ } elseif (isset(self::RELATIVE_UNITS[$unit])) {
+ $size *= self::RELATIVE_UNITS[$unit];
+ $size = round($size, 4);
+ }
+
+ $this->size = $size;
+ }
+
+ public function width(): float
+ {
+ return (float) ($this->unit === null)
+ ? $this->size
+ : round(Drawing::pixelsToCellDimension((int) $this->size, new Font(false)), 4);
+ }
+
+ public function height(): float
+ {
+ return (float) ($this->unit === null)
+ ? $this->size
+ : $this->toUnit(self::UOM_POINTS);
+ }
+
+ public function toUnit(string $unitOfMeasure): float
+ {
+ $unitOfMeasure = strtolower($unitOfMeasure);
+ if (!array_key_exists($unitOfMeasure, self::ABSOLUTE_UNITS)) {
+ throw new Exception("{$unitOfMeasure} is not a vaid unit of measure");
+ }
+
+ $size = $this->size;
+ if ($this->unit === null) {
+ $size = Drawing::cellDimensionToPixels($size, new Font(false));
+ }
+
+ return $size / self::ABSOLUTE_UNITS[$unitOfMeasure];
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Downloader.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Downloader.php
new file mode 100644
index 00000000..41bfe6fb
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Downloader.php
@@ -0,0 +1,101 @@
+ 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+ 'xls' => 'application/vnd.ms-excel',
+ 'ods' => 'application/vnd.oasis.opendocument.spreadsheet',
+ 'csv' => 'text/csv',
+ 'html' => 'text/html',
+ 'pdf' => 'application/pdf',
+ ];
+
+ public function __construct(string $folder, string $filename, ?string $filetype = null)
+ {
+ if ((is_dir($folder) === false) || (is_readable($folder) === false)) {
+ throw new Exception('Folder is not accessible');
+ }
+ $filepath = "{$folder}/{$filename}";
+ $this->filepath = (string) realpath($filepath);
+ $this->filename = basename($filepath);
+ if ((file_exists($this->filepath) === false) || (is_readable($this->filepath) === false)) {
+ throw new Exception('File not found, or cannot be read');
+ }
+
+ $filetype ??= pathinfo($filename, PATHINFO_EXTENSION);
+ if (array_key_exists(strtolower($filetype), self::CONTENT_TYPES) === false) {
+ throw new Exception('Invalid filetype: cannot be downloaded');
+ }
+ $this->filetype = strtolower($filetype);
+ }
+
+ public function download(): void
+ {
+ $this->headers();
+
+ readfile($this->filepath);
+ }
+
+ public function headers(): void
+ {
+ // I cannot tell what this ob_clean is paired with.
+ // I have never seen a problem with it, but someone has - issue 3739.
+ // Perhaps it should be removed altogether,
+ // but making it conditional seems harmless, and safer.
+ if ((int) ob_get_length() > 0) {
+ ob_clean();
+ }
+
+ $this->contentType();
+ $this->contentDisposition();
+ $this->cacheHeaders();
+ $this->fileSize();
+
+ flush();
+ }
+
+ protected function contentType(): void
+ {
+ header('Content-Type: ' . self::CONTENT_TYPES[$this->filetype]);
+ }
+
+ protected function contentDisposition(): void
+ {
+ header('Content-Disposition: attachment;filename="' . $this->filename . '"');
+ }
+
+ protected function cacheHeaders(): void
+ {
+ header('Cache-Control: max-age=0');
+ // If you're serving to IE 9, then the following may be needed
+ header('Cache-Control: max-age=1');
+
+ // If you're serving to IE over SSL, then the following may be needed
+ header('Expires: Mon, 26 Jul 1997 05:00:00 GMT'); // Date in the past
+ header('Last-Modified: ' . gmdate('D, d M Y H:i:s') . ' GMT'); // always modified
+ header('Cache-Control: cache, must-revalidate'); // HTTP/1.1
+ header('Pragma: public'); // HTTP/1.0
+ }
+
+ protected function fileSize(): void
+ {
+ header('Content-Length: ' . filesize($this->filepath));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Handler.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Handler.php
new file mode 100644
index 00000000..fb1b9a04
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Handler.php
@@ -0,0 +1,45 @@
+ 'f0f8ff',
+ 'antiquewhite' => 'faebd7',
+ 'antiquewhite1' => 'ffefdb',
+ 'antiquewhite2' => 'eedfcc',
+ 'antiquewhite3' => 'cdc0b0',
+ 'antiquewhite4' => '8b8378',
+ 'aqua' => '00ffff',
+ 'aquamarine1' => '7fffd4',
+ 'aquamarine2' => '76eec6',
+ 'aquamarine4' => '458b74',
+ 'azure1' => 'f0ffff',
+ 'azure2' => 'e0eeee',
+ 'azure3' => 'c1cdcd',
+ 'azure4' => '838b8b',
+ 'beige' => 'f5f5dc',
+ 'bisque1' => 'ffe4c4',
+ 'bisque2' => 'eed5b7',
+ 'bisque3' => 'cdb79e',
+ 'bisque4' => '8b7d6b',
+ 'black' => '000000',
+ 'blanchedalmond' => 'ffebcd',
+ 'blue' => '0000ff',
+ 'blue1' => '0000ff',
+ 'blue2' => '0000ee',
+ 'blue4' => '00008b',
+ 'blueviolet' => '8a2be2',
+ 'brown' => 'a52a2a',
+ 'brown1' => 'ff4040',
+ 'brown2' => 'ee3b3b',
+ 'brown3' => 'cd3333',
+ 'brown4' => '8b2323',
+ 'burlywood' => 'deb887',
+ 'burlywood1' => 'ffd39b',
+ 'burlywood2' => 'eec591',
+ 'burlywood3' => 'cdaa7d',
+ 'burlywood4' => '8b7355',
+ 'cadetblue' => '5f9ea0',
+ 'cadetblue1' => '98f5ff',
+ 'cadetblue2' => '8ee5ee',
+ 'cadetblue3' => '7ac5cd',
+ 'cadetblue4' => '53868b',
+ 'chartreuse1' => '7fff00',
+ 'chartreuse2' => '76ee00',
+ 'chartreuse3' => '66cd00',
+ 'chartreuse4' => '458b00',
+ 'chocolate' => 'd2691e',
+ 'chocolate1' => 'ff7f24',
+ 'chocolate2' => 'ee7621',
+ 'chocolate3' => 'cd661d',
+ 'coral' => 'ff7f50',
+ 'coral1' => 'ff7256',
+ 'coral2' => 'ee6a50',
+ 'coral3' => 'cd5b45',
+ 'coral4' => '8b3e2f',
+ 'cornflowerblue' => '6495ed',
+ 'cornsilk1' => 'fff8dc',
+ 'cornsilk2' => 'eee8cd',
+ 'cornsilk3' => 'cdc8b1',
+ 'cornsilk4' => '8b8878',
+ 'cyan1' => '00ffff',
+ 'cyan2' => '00eeee',
+ 'cyan3' => '00cdcd',
+ 'cyan4' => '008b8b',
+ 'darkgoldenrod' => 'b8860b',
+ 'darkgoldenrod1' => 'ffb90f',
+ 'darkgoldenrod2' => 'eead0e',
+ 'darkgoldenrod3' => 'cd950c',
+ 'darkgoldenrod4' => '8b6508',
+ 'darkgreen' => '006400',
+ 'darkkhaki' => 'bdb76b',
+ 'darkolivegreen' => '556b2f',
+ 'darkolivegreen1' => 'caff70',
+ 'darkolivegreen2' => 'bcee68',
+ 'darkolivegreen3' => 'a2cd5a',
+ 'darkolivegreen4' => '6e8b3d',
+ 'darkorange' => 'ff8c00',
+ 'darkorange1' => 'ff7f00',
+ 'darkorange2' => 'ee7600',
+ 'darkorange3' => 'cd6600',
+ 'darkorange4' => '8b4500',
+ 'darkorchid' => '9932cc',
+ 'darkorchid1' => 'bf3eff',
+ 'darkorchid2' => 'b23aee',
+ 'darkorchid3' => '9a32cd',
+ 'darkorchid4' => '68228b',
+ 'darksalmon' => 'e9967a',
+ 'darkseagreen' => '8fbc8f',
+ 'darkseagreen1' => 'c1ffc1',
+ 'darkseagreen2' => 'b4eeb4',
+ 'darkseagreen3' => '9bcd9b',
+ 'darkseagreen4' => '698b69',
+ 'darkslateblue' => '483d8b',
+ 'darkslategray' => '2f4f4f',
+ 'darkslategray1' => '97ffff',
+ 'darkslategray2' => '8deeee',
+ 'darkslategray3' => '79cdcd',
+ 'darkslategray4' => '528b8b',
+ 'darkturquoise' => '00ced1',
+ 'darkviolet' => '9400d3',
+ 'deeppink1' => 'ff1493',
+ 'deeppink2' => 'ee1289',
+ 'deeppink3' => 'cd1076',
+ 'deeppink4' => '8b0a50',
+ 'deepskyblue1' => '00bfff',
+ 'deepskyblue2' => '00b2ee',
+ 'deepskyblue3' => '009acd',
+ 'deepskyblue4' => '00688b',
+ 'dimgray' => '696969',
+ 'dodgerblue1' => '1e90ff',
+ 'dodgerblue2' => '1c86ee',
+ 'dodgerblue3' => '1874cd',
+ 'dodgerblue4' => '104e8b',
+ 'firebrick' => 'b22222',
+ 'firebrick1' => 'ff3030',
+ 'firebrick2' => 'ee2c2c',
+ 'firebrick3' => 'cd2626',
+ 'firebrick4' => '8b1a1a',
+ 'floralwhite' => 'fffaf0',
+ 'forestgreen' => '228b22',
+ 'fuchsia' => 'ff00ff',
+ 'gainsboro' => 'dcdcdc',
+ 'ghostwhite' => 'f8f8ff',
+ 'gold1' => 'ffd700',
+ 'gold2' => 'eec900',
+ 'gold3' => 'cdad00',
+ 'gold4' => '8b7500',
+ 'goldenrod' => 'daa520',
+ 'goldenrod1' => 'ffc125',
+ 'goldenrod2' => 'eeb422',
+ 'goldenrod3' => 'cd9b1d',
+ 'goldenrod4' => '8b6914',
+ 'gray' => 'bebebe',
+ 'gray1' => '030303',
+ 'gray10' => '1a1a1a',
+ 'gray11' => '1c1c1c',
+ 'gray12' => '1f1f1f',
+ 'gray13' => '212121',
+ 'gray14' => '242424',
+ 'gray15' => '262626',
+ 'gray16' => '292929',
+ 'gray17' => '2b2b2b',
+ 'gray18' => '2e2e2e',
+ 'gray19' => '303030',
+ 'gray2' => '050505',
+ 'gray20' => '333333',
+ 'gray21' => '363636',
+ 'gray22' => '383838',
+ 'gray23' => '3b3b3b',
+ 'gray24' => '3d3d3d',
+ 'gray25' => '404040',
+ 'gray26' => '424242',
+ 'gray27' => '454545',
+ 'gray28' => '474747',
+ 'gray29' => '4a4a4a',
+ 'gray3' => '080808',
+ 'gray30' => '4d4d4d',
+ 'gray31' => '4f4f4f',
+ 'gray32' => '525252',
+ 'gray33' => '545454',
+ 'gray34' => '575757',
+ 'gray35' => '595959',
+ 'gray36' => '5c5c5c',
+ 'gray37' => '5e5e5e',
+ 'gray38' => '616161',
+ 'gray39' => '636363',
+ 'gray4' => '0a0a0a',
+ 'gray40' => '666666',
+ 'gray41' => '696969',
+ 'gray42' => '6b6b6b',
+ 'gray43' => '6e6e6e',
+ 'gray44' => '707070',
+ 'gray45' => '737373',
+ 'gray46' => '757575',
+ 'gray47' => '787878',
+ 'gray48' => '7a7a7a',
+ 'gray49' => '7d7d7d',
+ 'gray5' => '0d0d0d',
+ 'gray50' => '7f7f7f',
+ 'gray51' => '828282',
+ 'gray52' => '858585',
+ 'gray53' => '878787',
+ 'gray54' => '8a8a8a',
+ 'gray55' => '8c8c8c',
+ 'gray56' => '8f8f8f',
+ 'gray57' => '919191',
+ 'gray58' => '949494',
+ 'gray59' => '969696',
+ 'gray6' => '0f0f0f',
+ 'gray60' => '999999',
+ 'gray61' => '9c9c9c',
+ 'gray62' => '9e9e9e',
+ 'gray63' => 'a1a1a1',
+ 'gray64' => 'a3a3a3',
+ 'gray65' => 'a6a6a6',
+ 'gray66' => 'a8a8a8',
+ 'gray67' => 'ababab',
+ 'gray68' => 'adadad',
+ 'gray69' => 'b0b0b0',
+ 'gray7' => '121212',
+ 'gray70' => 'b3b3b3',
+ 'gray71' => 'b5b5b5',
+ 'gray72' => 'b8b8b8',
+ 'gray73' => 'bababa',
+ 'gray74' => 'bdbdbd',
+ 'gray75' => 'bfbfbf',
+ 'gray76' => 'c2c2c2',
+ 'gray77' => 'c4c4c4',
+ 'gray78' => 'c7c7c7',
+ 'gray79' => 'c9c9c9',
+ 'gray8' => '141414',
+ 'gray80' => 'cccccc',
+ 'gray81' => 'cfcfcf',
+ 'gray82' => 'd1d1d1',
+ 'gray83' => 'd4d4d4',
+ 'gray84' => 'd6d6d6',
+ 'gray85' => 'd9d9d9',
+ 'gray86' => 'dbdbdb',
+ 'gray87' => 'dedede',
+ 'gray88' => 'e0e0e0',
+ 'gray89' => 'e3e3e3',
+ 'gray9' => '171717',
+ 'gray90' => 'e5e5e5',
+ 'gray91' => 'e8e8e8',
+ 'gray92' => 'ebebeb',
+ 'gray93' => 'ededed',
+ 'gray94' => 'f0f0f0',
+ 'gray95' => 'f2f2f2',
+ 'gray97' => 'f7f7f7',
+ 'gray98' => 'fafafa',
+ 'gray99' => 'fcfcfc',
+ 'green' => '00ff00',
+ 'green1' => '00ff00',
+ 'green2' => '00ee00',
+ 'green3' => '00cd00',
+ 'green4' => '008b00',
+ 'greenyellow' => 'adff2f',
+ 'honeydew1' => 'f0fff0',
+ 'honeydew2' => 'e0eee0',
+ 'honeydew3' => 'c1cdc1',
+ 'honeydew4' => '838b83',
+ 'hotpink' => 'ff69b4',
+ 'hotpink1' => 'ff6eb4',
+ 'hotpink2' => 'ee6aa7',
+ 'hotpink3' => 'cd6090',
+ 'hotpink4' => '8b3a62',
+ 'indianred' => 'cd5c5c',
+ 'indianred1' => 'ff6a6a',
+ 'indianred2' => 'ee6363',
+ 'indianred3' => 'cd5555',
+ 'indianred4' => '8b3a3a',
+ 'ivory1' => 'fffff0',
+ 'ivory2' => 'eeeee0',
+ 'ivory3' => 'cdcdc1',
+ 'ivory4' => '8b8b83',
+ 'khaki' => 'f0e68c',
+ 'khaki1' => 'fff68f',
+ 'khaki2' => 'eee685',
+ 'khaki3' => 'cdc673',
+ 'khaki4' => '8b864e',
+ 'lavender' => 'e6e6fa',
+ 'lavenderblush1' => 'fff0f5',
+ 'lavenderblush2' => 'eee0e5',
+ 'lavenderblush3' => 'cdc1c5',
+ 'lavenderblush4' => '8b8386',
+ 'lawngreen' => '7cfc00',
+ 'lemonchiffon1' => 'fffacd',
+ 'lemonchiffon2' => 'eee9bf',
+ 'lemonchiffon3' => 'cdc9a5',
+ 'lemonchiffon4' => '8b8970',
+ 'light' => 'eedd82',
+ 'lightblue' => 'add8e6',
+ 'lightblue1' => 'bfefff',
+ 'lightblue2' => 'b2dfee',
+ 'lightblue3' => '9ac0cd',
+ 'lightblue4' => '68838b',
+ 'lightcoral' => 'f08080',
+ 'lightcyan1' => 'e0ffff',
+ 'lightcyan2' => 'd1eeee',
+ 'lightcyan3' => 'b4cdcd',
+ 'lightcyan4' => '7a8b8b',
+ 'lightgoldenrod1' => 'ffec8b',
+ 'lightgoldenrod2' => 'eedc82',
+ 'lightgoldenrod3' => 'cdbe70',
+ 'lightgoldenrod4' => '8b814c',
+ 'lightgoldenrodyellow' => 'fafad2',
+ 'lightgray' => 'd3d3d3',
+ 'lightpink' => 'ffb6c1',
+ 'lightpink1' => 'ffaeb9',
+ 'lightpink2' => 'eea2ad',
+ 'lightpink3' => 'cd8c95',
+ 'lightpink4' => '8b5f65',
+ 'lightsalmon1' => 'ffa07a',
+ 'lightsalmon2' => 'ee9572',
+ 'lightsalmon3' => 'cd8162',
+ 'lightsalmon4' => '8b5742',
+ 'lightseagreen' => '20b2aa',
+ 'lightskyblue' => '87cefa',
+ 'lightskyblue1' => 'b0e2ff',
+ 'lightskyblue2' => 'a4d3ee',
+ 'lightskyblue3' => '8db6cd',
+ 'lightskyblue4' => '607b8b',
+ 'lightslateblue' => '8470ff',
+ 'lightslategray' => '778899',
+ 'lightsteelblue' => 'b0c4de',
+ 'lightsteelblue1' => 'cae1ff',
+ 'lightsteelblue2' => 'bcd2ee',
+ 'lightsteelblue3' => 'a2b5cd',
+ 'lightsteelblue4' => '6e7b8b',
+ 'lightyellow1' => 'ffffe0',
+ 'lightyellow2' => 'eeeed1',
+ 'lightyellow3' => 'cdcdb4',
+ 'lightyellow4' => '8b8b7a',
+ 'lime' => '00ff00',
+ 'limegreen' => '32cd32',
+ 'linen' => 'faf0e6',
+ 'magenta' => 'ff00ff',
+ 'magenta2' => 'ee00ee',
+ 'magenta3' => 'cd00cd',
+ 'magenta4' => '8b008b',
+ 'maroon' => 'b03060',
+ 'maroon1' => 'ff34b3',
+ 'maroon2' => 'ee30a7',
+ 'maroon3' => 'cd2990',
+ 'maroon4' => '8b1c62',
+ 'medium' => '66cdaa',
+ 'mediumaquamarine' => '66cdaa',
+ 'mediumblue' => '0000cd',
+ 'mediumorchid' => 'ba55d3',
+ 'mediumorchid1' => 'e066ff',
+ 'mediumorchid2' => 'd15fee',
+ 'mediumorchid3' => 'b452cd',
+ 'mediumorchid4' => '7a378b',
+ 'mediumpurple' => '9370db',
+ 'mediumpurple1' => 'ab82ff',
+ 'mediumpurple2' => '9f79ee',
+ 'mediumpurple3' => '8968cd',
+ 'mediumpurple4' => '5d478b',
+ 'mediumseagreen' => '3cb371',
+ 'mediumslateblue' => '7b68ee',
+ 'mediumspringgreen' => '00fa9a',
+ 'mediumturquoise' => '48d1cc',
+ 'mediumvioletred' => 'c71585',
+ 'midnightblue' => '191970',
+ 'mintcream' => 'f5fffa',
+ 'mistyrose1' => 'ffe4e1',
+ 'mistyrose2' => 'eed5d2',
+ 'mistyrose3' => 'cdb7b5',
+ 'mistyrose4' => '8b7d7b',
+ 'moccasin' => 'ffe4b5',
+ 'navajowhite1' => 'ffdead',
+ 'navajowhite2' => 'eecfa1',
+ 'navajowhite3' => 'cdb38b',
+ 'navajowhite4' => '8b795e',
+ 'navy' => '000080',
+ 'navyblue' => '000080',
+ 'oldlace' => 'fdf5e6',
+ 'olive' => '808000',
+ 'olivedrab' => '6b8e23',
+ 'olivedrab1' => 'c0ff3e',
+ 'olivedrab2' => 'b3ee3a',
+ 'olivedrab4' => '698b22',
+ 'orange' => 'ffa500',
+ 'orange1' => 'ffa500',
+ 'orange2' => 'ee9a00',
+ 'orange3' => 'cd8500',
+ 'orange4' => '8b5a00',
+ 'orangered1' => 'ff4500',
+ 'orangered2' => 'ee4000',
+ 'orangered3' => 'cd3700',
+ 'orangered4' => '8b2500',
+ 'orchid' => 'da70d6',
+ 'orchid1' => 'ff83fa',
+ 'orchid2' => 'ee7ae9',
+ 'orchid3' => 'cd69c9',
+ 'orchid4' => '8b4789',
+ 'pale' => 'db7093',
+ 'palegoldenrod' => 'eee8aa',
+ 'palegreen' => '98fb98',
+ 'palegreen1' => '9aff9a',
+ 'palegreen2' => '90ee90',
+ 'palegreen3' => '7ccd7c',
+ 'palegreen4' => '548b54',
+ 'paleturquoise' => 'afeeee',
+ 'paleturquoise1' => 'bbffff',
+ 'paleturquoise2' => 'aeeeee',
+ 'paleturquoise3' => '96cdcd',
+ 'paleturquoise4' => '668b8b',
+ 'palevioletred' => 'db7093',
+ 'palevioletred1' => 'ff82ab',
+ 'palevioletred2' => 'ee799f',
+ 'palevioletred3' => 'cd6889',
+ 'palevioletred4' => '8b475d',
+ 'papayawhip' => 'ffefd5',
+ 'peachpuff1' => 'ffdab9',
+ 'peachpuff2' => 'eecbad',
+ 'peachpuff3' => 'cdaf95',
+ 'peachpuff4' => '8b7765',
+ 'pink' => 'ffc0cb',
+ 'pink1' => 'ffb5c5',
+ 'pink2' => 'eea9b8',
+ 'pink3' => 'cd919e',
+ 'pink4' => '8b636c',
+ 'plum' => 'dda0dd',
+ 'plum1' => 'ffbbff',
+ 'plum2' => 'eeaeee',
+ 'plum3' => 'cd96cd',
+ 'plum4' => '8b668b',
+ 'powderblue' => 'b0e0e6',
+ 'purple' => 'a020f0',
+ 'rebeccapurple' => '663399',
+ 'purple1' => '9b30ff',
+ 'purple2' => '912cee',
+ 'purple3' => '7d26cd',
+ 'purple4' => '551a8b',
+ 'red' => 'ff0000',
+ 'red1' => 'ff0000',
+ 'red2' => 'ee0000',
+ 'red3' => 'cd0000',
+ 'red4' => '8b0000',
+ 'rosybrown' => 'bc8f8f',
+ 'rosybrown1' => 'ffc1c1',
+ 'rosybrown2' => 'eeb4b4',
+ 'rosybrown3' => 'cd9b9b',
+ 'rosybrown4' => '8b6969',
+ 'royalblue' => '4169e1',
+ 'royalblue1' => '4876ff',
+ 'royalblue2' => '436eee',
+ 'royalblue3' => '3a5fcd',
+ 'royalblue4' => '27408b',
+ 'saddlebrown' => '8b4513',
+ 'salmon' => 'fa8072',
+ 'salmon1' => 'ff8c69',
+ 'salmon2' => 'ee8262',
+ 'salmon3' => 'cd7054',
+ 'salmon4' => '8b4c39',
+ 'sandybrown' => 'f4a460',
+ 'seagreen1' => '54ff9f',
+ 'seagreen2' => '4eee94',
+ 'seagreen3' => '43cd80',
+ 'seagreen4' => '2e8b57',
+ 'seashell1' => 'fff5ee',
+ 'seashell2' => 'eee5de',
+ 'seashell3' => 'cdc5bf',
+ 'seashell4' => '8b8682',
+ 'sienna' => 'a0522d',
+ 'sienna1' => 'ff8247',
+ 'sienna2' => 'ee7942',
+ 'sienna3' => 'cd6839',
+ 'sienna4' => '8b4726',
+ 'silver' => 'c0c0c0',
+ 'skyblue' => '87ceeb',
+ 'skyblue1' => '87ceff',
+ 'skyblue2' => '7ec0ee',
+ 'skyblue3' => '6ca6cd',
+ 'skyblue4' => '4a708b',
+ 'slateblue' => '6a5acd',
+ 'slateblue1' => '836fff',
+ 'slateblue2' => '7a67ee',
+ 'slateblue3' => '6959cd',
+ 'slateblue4' => '473c8b',
+ 'slategray' => '708090',
+ 'slategray1' => 'c6e2ff',
+ 'slategray2' => 'b9d3ee',
+ 'slategray3' => '9fb6cd',
+ 'slategray4' => '6c7b8b',
+ 'snow1' => 'fffafa',
+ 'snow2' => 'eee9e9',
+ 'snow3' => 'cdc9c9',
+ 'snow4' => '8b8989',
+ 'springgreen1' => '00ff7f',
+ 'springgreen2' => '00ee76',
+ 'springgreen3' => '00cd66',
+ 'springgreen4' => '008b45',
+ 'steelblue' => '4682b4',
+ 'steelblue1' => '63b8ff',
+ 'steelblue2' => '5cacee',
+ 'steelblue3' => '4f94cd',
+ 'steelblue4' => '36648b',
+ 'tan' => 'd2b48c',
+ 'tan1' => 'ffa54f',
+ 'tan2' => 'ee9a49',
+ 'tan3' => 'cd853f',
+ 'tan4' => '8b5a2b',
+ 'teal' => '008080',
+ 'thistle' => 'd8bfd8',
+ 'thistle1' => 'ffe1ff',
+ 'thistle2' => 'eed2ee',
+ 'thistle3' => 'cdb5cd',
+ 'thistle4' => '8b7b8b',
+ 'tomato1' => 'ff6347',
+ 'tomato2' => 'ee5c42',
+ 'tomato3' => 'cd4f39',
+ 'tomato4' => '8b3626',
+ 'turquoise' => '40e0d0',
+ 'turquoise1' => '00f5ff',
+ 'turquoise2' => '00e5ee',
+ 'turquoise3' => '00c5cd',
+ 'turquoise4' => '00868b',
+ 'violet' => 'ee82ee',
+ 'violetred' => 'd02090',
+ 'violetred1' => 'ff3e96',
+ 'violetred2' => 'ee3a8c',
+ 'violetred3' => 'cd3278',
+ 'violetred4' => '8b2252',
+ 'wheat' => 'f5deb3',
+ 'wheat1' => 'ffe7ba',
+ 'wheat2' => 'eed8ae',
+ 'wheat3' => 'cdba96',
+ 'wheat4' => '8b7e66',
+ 'white' => 'ffffff',
+ 'whitesmoke' => 'f5f5f5',
+ 'yellow' => 'ffff00',
+ 'yellow1' => 'ffff00',
+ 'yellow2' => 'eeee00',
+ 'yellow3' => 'cdcd00',
+ 'yellow4' => '8b8b00',
+ 'yellowgreen' => '9acd32',
+ ];
+
+ private ?string $face = null;
+
+ private ?string $size = null;
+
+ private ?string $color = null;
+
+ private bool $bold = false;
+
+ private bool $italic = false;
+
+ private bool $underline = false;
+
+ private bool $superscript = false;
+
+ private bool $subscript = false;
+
+ private bool $strikethrough = false;
+
+ /** @var callable[] */
+ private array $startTagCallbacks = [
+ 'font' => [self::class, 'startFontTag'],
+ 'b' => [self::class, 'startBoldTag'],
+ 'strong' => [self::class, 'startBoldTag'],
+ 'i' => [self::class, 'startItalicTag'],
+ 'em' => [self::class, 'startItalicTag'],
+ 'u' => [self::class, 'startUnderlineTag'],
+ 'ins' => [self::class, 'startUnderlineTag'],
+ 'del' => [self::class, 'startStrikethruTag'],
+ 'sup' => [self::class, 'startSuperscriptTag'],
+ 'sub' => [self::class, 'startSubscriptTag'],
+ ];
+
+ /** @var callable[] */
+ private array $endTagCallbacks = [
+ 'font' => [self::class, 'endFontTag'],
+ 'b' => [self::class, 'endBoldTag'],
+ 'strong' => [self::class, 'endBoldTag'],
+ 'i' => [self::class, 'endItalicTag'],
+ 'em' => [self::class, 'endItalicTag'],
+ 'u' => [self::class, 'endUnderlineTag'],
+ 'ins' => [self::class, 'endUnderlineTag'],
+ 'del' => [self::class, 'endStrikethruTag'],
+ 'sup' => [self::class, 'endSuperscriptTag'],
+ 'sub' => [self::class, 'endSubscriptTag'],
+ 'br' => [self::class, 'breakTag'],
+ 'p' => [self::class, 'breakTag'],
+ 'h1' => [self::class, 'breakTag'],
+ 'h2' => [self::class, 'breakTag'],
+ 'h3' => [self::class, 'breakTag'],
+ 'h4' => [self::class, 'breakTag'],
+ 'h5' => [self::class, 'breakTag'],
+ 'h6' => [self::class, 'breakTag'],
+ ];
+
+ private array $stack = [];
+
+ public string $stringData = '';
+
+ private RichText $richTextObject;
+
+ private bool $preserveWhiteSpace = false;
+
+ private function initialise(): void
+ {
+ $this->face = $this->size = $this->color = null;
+ $this->bold = $this->italic = $this->underline = $this->superscript = $this->subscript = $this->strikethrough = false;
+
+ $this->stack = [];
+
+ $this->stringData = '';
+ }
+
+ /**
+ * Parse HTML formatting and return the resulting RichText.
+ */
+ public function toRichTextObject(string $html, bool $preserveWhiteSpace = false): RichText
+ {
+ $this->initialise();
+
+ // Create a new DOM object
+ $dom = new DOMDocument();
+ // Load the HTML file into the DOM object
+ // Note the use of error suppression, because typically this will be an html fragment, so not fully valid markup
+ $prefix = '';
+ @$dom->loadHTML($prefix . $html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
+ // Discard excess white space
+ $dom->preserveWhiteSpace = false;
+
+ $this->richTextObject = new RichText();
+ $this->preserveWhiteSpace = $preserveWhiteSpace;
+ $this->parseElements($dom);
+ $this->preserveWhiteSpace = false;
+
+ // Clean any further spurious whitespace
+ $this->cleanWhitespace();
+
+ return $this->richTextObject;
+ }
+
+ private function cleanWhitespace(): void
+ {
+ foreach ($this->richTextObject->getRichTextElements() as $key => $element) {
+ $text = $element->getText();
+ // Trim any leading spaces on the first run
+ if ($key == 0) {
+ $text = ltrim($text);
+ }
+ // Trim any spaces immediately after a line break
+ $text = (string) preg_replace('/\n */mu', "\n", $text);
+ $element->setText($text);
+ }
+ }
+
+ private function buildTextRun(): void
+ {
+ $text = $this->stringData;
+ if (trim($text) === '') {
+ return;
+ }
+
+ $richtextRun = $this->richTextObject->createTextRun($this->stringData);
+ $font = $richtextRun->getFont();
+ if ($font !== null) {
+ if ($this->face) {
+ $font->setName($this->face);
+ }
+ if ($this->size) {
+ $font->setSize($this->size);
+ }
+ if ($this->color) {
+ $font->setColor(new Color('ff' . $this->color));
+ }
+ if ($this->bold) {
+ $font->setBold(true);
+ }
+ if ($this->italic) {
+ $font->setItalic(true);
+ }
+ if ($this->underline) {
+ $font->setUnderline(Font::UNDERLINE_SINGLE);
+ }
+ if ($this->superscript) {
+ $font->setSuperscript(true);
+ }
+ if ($this->subscript) {
+ $font->setSubscript(true);
+ }
+ if ($this->strikethrough) {
+ $font->setStrikethrough(true);
+ }
+ }
+ $this->stringData = '';
+ }
+
+ private function rgbToColour(string $rgbValue): string
+ {
+ preg_match_all('/\d+/', $rgbValue, $values);
+ foreach ($values[0] as &$value) {
+ $value = str_pad(dechex((int) $value), 2, '0', STR_PAD_LEFT);
+ }
+
+ return implode('', $values[0]);
+ }
+
+ public static function colourNameLookup(string $colorName): string
+ {
+ return self::COLOUR_MAP[$colorName] ?? '';
+ }
+
+ protected function startFontTag(DOMElement $tag): void
+ {
+ $attrs = $tag->attributes;
+ if ($attrs !== null) {
+ /** @var DOMAttr $attribute */
+ foreach ($attrs as $attribute) {
+ $attributeName = strtolower($attribute->name);
+ $attributeName = preg_replace('/^html:/', '', $attributeName) ?? $attributeName; // in case from Xml spreadsheet
+ $attributeValue = $attribute->value;
+
+ if ($attributeName == 'color') {
+ if (preg_match('/rgb\s*\(/', $attributeValue)) {
+ $this->$attributeName = $this->rgbToColour($attributeValue);
+ } elseif (str_starts_with(trim($attributeValue), '#')) {
+ $this->$attributeName = ltrim($attributeValue, '#');
+ } else {
+ $this->$attributeName = static::colourNameLookup($attributeValue);
+ }
+ } else {
+ $this->$attributeName = $attributeValue;
+ }
+ }
+ }
+ }
+
+ protected function endFontTag(): void
+ {
+ $this->face = $this->size = $this->color = null;
+ }
+
+ protected function startBoldTag(): void
+ {
+ $this->bold = true;
+ }
+
+ protected function endBoldTag(): void
+ {
+ $this->bold = false;
+ }
+
+ protected function startItalicTag(): void
+ {
+ $this->italic = true;
+ }
+
+ protected function endItalicTag(): void
+ {
+ $this->italic = false;
+ }
+
+ protected function startUnderlineTag(): void
+ {
+ $this->underline = true;
+ }
+
+ protected function endUnderlineTag(): void
+ {
+ $this->underline = false;
+ }
+
+ protected function startSubscriptTag(): void
+ {
+ $this->subscript = true;
+ }
+
+ protected function endSubscriptTag(): void
+ {
+ $this->subscript = false;
+ }
+
+ protected function startSuperscriptTag(): void
+ {
+ $this->superscript = true;
+ }
+
+ protected function endSuperscriptTag(): void
+ {
+ $this->superscript = false;
+ }
+
+ protected function startStrikethruTag(): void
+ {
+ $this->strikethrough = true;
+ }
+
+ protected function endStrikethruTag(): void
+ {
+ $this->strikethrough = false;
+ }
+
+ public function breakTag(): void
+ {
+ $this->stringData .= "\n";
+ }
+
+ private function parseTextNode(DOMText $textNode): void
+ {
+ if ($this->preserveWhiteSpace) {
+ $domText = $textNode->nodeValue ?? '';
+ } else {
+ $domText = (string) preg_replace(
+ '/\s+/u',
+ ' ',
+ str_replace(["\r", "\n"], ' ', $textNode->nodeValue ?? '')
+ );
+ }
+ $this->stringData .= $domText;
+ $this->buildTextRun();
+ }
+
+ public function addStartTagCallback(string $tag, callable $callback): void
+ {
+ $this->startTagCallbacks[$tag] = $callback;
+ }
+
+ public function addEndTagCallback(string $tag, callable $callback): void
+ {
+ $this->endTagCallbacks[$tag] = $callback;
+ }
+
+ /** @param callable[] $callbacks */
+ private function handleCallback(DOMElement $element, string $callbackTag, array $callbacks): void
+ {
+ if (isset($callbacks[$callbackTag])) {
+ $elementHandler = $callbacks[$callbackTag];
+ if (is_callable($elementHandler)) {
+ call_user_func($elementHandler, $element, $this);
+ }
+ }
+ }
+
+ private function parseElementNode(DOMElement $element): void
+ {
+ $callbackTag = strtolower($element->nodeName);
+ $this->stack[] = $callbackTag;
+
+ $this->handleCallback($element, $callbackTag, $this->startTagCallbacks);
+
+ $this->parseElements($element);
+ array_pop($this->stack);
+
+ $this->handleCallback($element, $callbackTag, $this->endTagCallbacks);
+ }
+
+ private function parseElements(DOMNode $element): void
+ {
+ foreach ($element->childNodes as $child) {
+ if ($child instanceof DOMText) {
+ $this->parseTextNode($child);
+ } elseif ($child instanceof DOMElement) {
+ $this->parseElementNode($child);
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Sample.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Sample.php
new file mode 100644
index 00000000..eded9ae4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Sample.php
@@ -0,0 +1,295 @@
+getScriptFilename() === 'index';
+ }
+
+ /**
+ * Return the page title.
+ */
+ public function getPageTitle(): string
+ {
+ return $this->isIndex() ? 'PHPSpreadsheet' : $this->getScriptFilename();
+ }
+
+ /**
+ * Return the page heading.
+ */
+ public function getPageHeading(): string
+ {
+ return $this->isIndex() ? '' : '' . str_replace('_', ' ', $this->getScriptFilename()) . ' ';
+ }
+
+ /**
+ * Returns an array of all known samples.
+ *
+ * @return string[][] [$name => $path]
+ */
+ public function getSamples(): array
+ {
+ // Populate samples
+ $baseDir = realpath(__DIR__ . '/../../../samples');
+ if ($baseDir === false) {
+ // @codeCoverageIgnoreStart
+ throw new RuntimeException('realpath returned false');
+ // @codeCoverageIgnoreEnd
+ }
+ $directory = new RecursiveDirectoryIterator($baseDir);
+ $iterator = new RecursiveIteratorIterator($directory);
+ $regex = new RegexIterator($iterator, '/^.+\.php$/', RecursiveRegexIterator::GET_MATCH);
+
+ $files = [];
+ /** @var string[] $file */
+ foreach ($regex as $file) {
+ $file = str_replace(str_replace('\\', '/', $baseDir) . '/', '', str_replace('\\', '/', $file[0]));
+ $info = pathinfo($file);
+ $category = str_replace('_', ' ', $info['dirname'] ?? '');
+ $name = str_replace('_', ' ', (string) preg_replace('/(|\.php)/', '', $info['filename']));
+ if (!in_array($category, ['.', 'bootstrap', 'templates']) && $name !== 'Header') {
+ if (!isset($files[$category])) {
+ $files[$category] = [];
+ }
+ $files[$category][$name] = $file;
+ }
+ }
+
+ // Sort everything
+ ksort($files);
+ foreach ($files as &$f) {
+ asort($f);
+ }
+
+ return $files;
+ }
+
+ /**
+ * Write documents.
+ *
+ * @param string[] $writers
+ */
+ public function write(Spreadsheet $spreadsheet, string $filename, array $writers = ['Xlsx', 'Xls'], bool $withCharts = false, ?callable $writerCallback = null, bool $resetActiveSheet = true): void
+ {
+ // Set active sheet index to the first sheet, so Excel opens this as the first sheet
+ if ($resetActiveSheet) {
+ $spreadsheet->setActiveSheetIndex(0);
+ }
+
+ // Write documents
+ foreach ($writers as $writerType) {
+ $path = $this->getFilename($filename, mb_strtolower($writerType));
+ $writer = IOFactory::createWriter($spreadsheet, $writerType);
+ $writer->setIncludeCharts($withCharts);
+ if ($writerCallback !== null) {
+ $writerCallback($writer);
+ }
+ $callStartTime = microtime(true);
+ $writer->save($path);
+ $this->logWrite($writer, $path, $callStartTime);
+ if ($this->isCli() === false) {
+ // @codeCoverageIgnoreStart
+ echo 'Download ' . basename($path) . ' ';
+ // @codeCoverageIgnoreEnd
+ }
+ }
+
+ $this->logEndingNotes();
+ }
+
+ protected function isDirOrMkdir(string $folder): bool
+ {
+ return \is_dir($folder) || \mkdir($folder);
+ }
+
+ /**
+ * Returns the temporary directory and make sure it exists.
+ */
+ public function getTemporaryFolder(): string
+ {
+ $tempFolder = sys_get_temp_dir() . '/phpspreadsheet';
+ if (!$this->isDirOrMkdir($tempFolder)) {
+ throw new RuntimeException(sprintf('Directory "%s" was not created', $tempFolder));
+ }
+
+ return $tempFolder;
+ }
+
+ /**
+ * Returns the filename that should be used for sample output.
+ */
+ public function getFilename(string $filename, string $extension = 'xlsx'): string
+ {
+ $originalExtension = pathinfo($filename, PATHINFO_EXTENSION);
+
+ return $this->getTemporaryFolder() . '/' . str_replace('.' . $originalExtension, '.' . $extension, basename($filename));
+ }
+
+ /**
+ * Return a random temporary file name.
+ */
+ public function getTemporaryFilename(string $extension = 'xlsx'): string
+ {
+ $temporaryFilename = tempnam($this->getTemporaryFolder(), 'phpspreadsheet-');
+ if ($temporaryFilename === false) {
+ // @codeCoverageIgnoreStart
+ throw new RuntimeException('tempnam returned false');
+ // @codeCoverageIgnoreEnd
+ }
+ unlink($temporaryFilename);
+
+ return $temporaryFilename . '.' . $extension;
+ }
+
+ public function log(string $message): void
+ {
+ $eol = $this->isCli() ? PHP_EOL : ' ';
+ echo ($this->isCli() ? date('H:i:s ') : '') . $message . $eol;
+ }
+
+ /**
+ * Render chart as part of running chart samples in browser.
+ * Charts are not rendered in unit tests, which are command line.
+ *
+ * @codeCoverageIgnore
+ */
+ public function renderChart(Chart $chart, string $fileName, ?Spreadsheet $spreadsheet = null): void
+ {
+ if ($this->isCli() === true) {
+ return;
+ }
+ Settings::setChartRenderer(MtJpGraphRenderer::class);
+
+ $fileName = $this->getFilename($fileName, 'png');
+ $title = $chart->getTitle();
+ $caption = null;
+ if ($title !== null) {
+ $calculatedTitle = $title->getCalculatedTitle($spreadsheet);
+ if ($calculatedTitle !== null) {
+ $caption = $title->getCaption();
+ $title->setCaption($calculatedTitle);
+ }
+ }
+
+ try {
+ $chart->render($fileName);
+ $this->log('Rendered image: ' . $fileName);
+ $imageData = @file_get_contents($fileName);
+ if ($imageData !== false) {
+ echo '';
+ } else {
+ $this->log('Unable to open chart' . PHP_EOL);
+ }
+ } catch (Throwable $e) {
+ $this->log('Error rendering chart: ' . $e->getMessage() . PHP_EOL);
+ }
+ if (isset($title, $caption)) {
+ $title->setCaption($caption);
+ }
+ Settings::unsetChartRenderer();
+ }
+
+ public function titles(string $category, string $functionName, ?string $description = null): void
+ {
+ $this->log(sprintf('%s Functions:', $category));
+ $description === null
+ ? $this->log(sprintf('Function: %s()', rtrim($functionName, '()')))
+ : $this->log(sprintf('Function: %s() - %s.', rtrim($functionName, '()'), rtrim($description, '.')));
+ }
+
+ public function displayGrid(array $matrix): void
+ {
+ $renderer = new TextGrid($matrix, $this->isCli());
+ echo $renderer->render();
+ }
+
+ public function logCalculationResult(
+ Worksheet $worksheet,
+ string $functionName,
+ string $formulaCell,
+ ?string $descriptionCell = null
+ ): void {
+ if ($descriptionCell !== null) {
+ $this->log($worksheet->getCell($descriptionCell)->getValueString());
+ }
+ $this->log($worksheet->getCell($formulaCell)->getValueString());
+ $this->log(sprintf('%s() Result is ', $functionName) . $worksheet->getCell($formulaCell)->getCalculatedValueString());
+ }
+
+ /**
+ * Log ending notes.
+ */
+ public function logEndingNotes(): void
+ {
+ // Do not show execution time for index
+ $this->log('Peak memory usage: ' . (memory_get_peak_usage(true) / 1024 / 1024) . 'MB');
+ }
+
+ /**
+ * Log a line about the write operation.
+ */
+ public function logWrite(IWriter $writer, string $path, float $callStartTime): void
+ {
+ $callEndTime = microtime(true);
+ $callTime = $callEndTime - $callStartTime;
+ $reflection = new ReflectionClass($writer);
+ $format = $reflection->getShortName();
+
+ $codePath = $this->isCli() ? $path : "$path";
+ $message = "Write {$format} format to {$codePath} in " . sprintf('%.4f', $callTime) . ' seconds';
+
+ $this->log($message);
+ }
+
+ /**
+ * Log a line about the read operation.
+ */
+ public function logRead(string $format, string $path, float $callStartTime): void
+ {
+ $callEndTime = microtime(true);
+ $callTime = $callEndTime - $callStartTime;
+ $message = "Read {$format} format from {$path} in " . sprintf('%.4f', $callTime) . ' seconds';
+
+ $this->log($message);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Size.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Size.php
new file mode 100644
index 00000000..575ed890
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/Size.php
@@ -0,0 +1,45 @@
+\d*\.?\d+)(?Ppt|px|em)?$/i';
+
+ protected bool $valid;
+
+ protected string $size = '';
+
+ protected string $unit = '';
+
+ public function __construct(string $size)
+ {
+ $this->valid = (bool) preg_match(self::REGEXP_SIZE_VALIDATION, $size, $matches);
+ if ($this->valid) {
+ $this->size = $matches['size'];
+ $this->unit = $matches['unit'] ?? 'pt';
+ }
+ }
+
+ public function valid(): bool
+ {
+ return $this->valid;
+ }
+
+ public function size(): string
+ {
+ return $this->size;
+ }
+
+ public function unit(): string
+ {
+ return $this->unit;
+ }
+
+ public function __toString(): string
+ {
+ return $this->size . $this->unit;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/TextGrid.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/TextGrid.php
new file mode 100644
index 00000000..f706b58f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Helper/TextGrid.php
@@ -0,0 +1,124 @@
+rows = array_keys($matrix);
+ $this->columns = array_keys($matrix[$this->rows[0]]);
+
+ $matrix = array_values($matrix);
+ array_walk(
+ $matrix,
+ function (&$row): void {
+ $row = array_values($row);
+ }
+ );
+
+ $this->matrix = $matrix;
+ $this->isCli = $isCli;
+ }
+
+ public function render(): string
+ {
+ $this->gridDisplay = $this->isCli ? '' : '';
+
+ $maxRow = max($this->rows);
+ $maxRowLength = mb_strlen((string) $maxRow) + 1;
+ $columnWidths = $this->getColumnWidths();
+
+ $this->renderColumnHeader($maxRowLength, $columnWidths);
+ $this->renderRows($maxRowLength, $columnWidths);
+ $this->renderFooter($maxRowLength, $columnWidths);
+
+ $this->gridDisplay .= $this->isCli ? '' : ' ';
+
+ return $this->gridDisplay;
+ }
+
+ private function renderRows(int $maxRowLength, array $columnWidths): void
+ {
+ foreach ($this->matrix as $row => $rowData) {
+ $this->gridDisplay .= '|' . str_pad((string) $this->rows[$row], $maxRowLength, ' ', STR_PAD_LEFT) . ' ';
+ $this->renderCells($rowData, $columnWidths);
+ $this->gridDisplay .= '|' . PHP_EOL;
+ }
+ }
+
+ private function renderCells(array $rowData, array $columnWidths): void
+ {
+ foreach ($rowData as $column => $cell) {
+ $displayCell = ($this->isCli) ? (string) $cell : htmlentities((string) $cell);
+ $this->gridDisplay .= '| ';
+ $this->gridDisplay .= $displayCell . str_repeat(' ', $columnWidths[$column] - mb_strlen($cell ?? '') + 1);
+ }
+ }
+
+ private function renderColumnHeader(int $maxRowLength, array $columnWidths): void
+ {
+ $this->gridDisplay .= str_repeat(' ', $maxRowLength + 2);
+ foreach ($this->columns as $column => $reference) {
+ $this->gridDisplay .= '+-' . str_repeat('-', $columnWidths[$column] + 1);
+ }
+ $this->gridDisplay .= '+' . PHP_EOL;
+
+ $this->gridDisplay .= str_repeat(' ', $maxRowLength + 2);
+ foreach ($this->columns as $column => $reference) {
+ $this->gridDisplay .= '| ' . str_pad((string) $reference, $columnWidths[$column] + 1, ' ');
+ }
+ $this->gridDisplay .= '|' . PHP_EOL;
+
+ $this->renderFooter($maxRowLength, $columnWidths);
+ }
+
+ private function renderFooter(int $maxRowLength, array $columnWidths): void
+ {
+ $this->gridDisplay .= '+' . str_repeat('-', $maxRowLength + 1);
+ foreach ($this->columns as $column => $reference) {
+ $this->gridDisplay .= '+-';
+ $this->gridDisplay .= str_pad((string) '', $columnWidths[$column] + 1, '-');
+ }
+ $this->gridDisplay .= '+' . PHP_EOL;
+ }
+
+ private function getColumnWidths(): array
+ {
+ $columnCount = count($this->matrix, COUNT_RECURSIVE) / count($this->matrix);
+ $columnWidths = [];
+ for ($column = 0; $column < $columnCount; ++$column) {
+ $columnWidths[] = $this->getColumnWidth(array_column($this->matrix, $column));
+ }
+
+ return $columnWidths;
+ }
+
+ private function getColumnWidth(array $columnData): int
+ {
+ $columnWidth = 0;
+ $columnData = array_values($columnData);
+
+ foreach ($columnData as $columnValue) {
+ if (is_string($columnValue)) {
+ $columnWidth = max($columnWidth, mb_strlen($columnValue));
+ } elseif (is_bool($columnValue)) {
+ $columnWidth = max($columnWidth, mb_strlen($columnValue ? 'TRUE' : 'FALSE'));
+ }
+
+ $columnWidth = max($columnWidth, mb_strlen((string) $columnWidth));
+ }
+
+ return $columnWidth;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/IComparable.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/IComparable.php
new file mode 100644
index 00000000..64b451ed
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/IComparable.php
@@ -0,0 +1,13 @@
+> */
+ private static array $readers = [
+ self::READER_XLSX => Reader\Xlsx::class,
+ self::READER_XLS => Reader\Xls::class,
+ self::READER_XML => Reader\Xml::class,
+ self::READER_ODS => Reader\Ods::class,
+ self::READER_SLK => Reader\Slk::class,
+ self::READER_GNUMERIC => Reader\Gnumeric::class,
+ self::READER_HTML => Reader\Html::class,
+ self::READER_CSV => Reader\Csv::class,
+ ];
+
+ /** @var array> */
+ private static array $writers = [
+ self::WRITER_XLS => Writer\Xls::class,
+ self::WRITER_XLSX => Writer\Xlsx::class,
+ self::WRITER_ODS => Writer\Ods::class,
+ self::WRITER_CSV => Writer\Csv::class,
+ self::WRITER_HTML => Writer\Html::class,
+ 'Tcpdf' => Writer\Pdf\Tcpdf::class,
+ 'Dompdf' => Writer\Pdf\Dompdf::class,
+ 'Mpdf' => Writer\Pdf\Mpdf::class,
+ ];
+
+ /**
+ * Create Writer\IWriter.
+ */
+ public static function createWriter(Spreadsheet $spreadsheet, string $writerType): IWriter
+ {
+ if (!isset(self::$writers[$writerType])) {
+ throw new Writer\Exception("No writer found for type $writerType");
+ }
+
+ // Instantiate writer
+ $className = self::$writers[$writerType];
+
+ return new $className($spreadsheet);
+ }
+
+ /**
+ * Create IReader.
+ */
+ public static function createReader(string $readerType): IReader
+ {
+ if (!isset(self::$readers[$readerType])) {
+ throw new Reader\Exception("No reader found for type $readerType");
+ }
+
+ // Instantiate reader
+ $className = self::$readers[$readerType];
+
+ return new $className();
+ }
+
+ /**
+ * Loads Spreadsheet from file using automatic Reader\IReader resolution.
+ *
+ * @param string $filename The name of the spreadsheet file
+ * @param int $flags the optional second parameter flags may be used to identify specific elements
+ * that should be loaded, but which won't be loaded by default, using these values:
+ * IReader::LOAD_WITH_CHARTS - Include any charts that are defined in the loaded file.
+ * IReader::READ_DATA_ONLY - Read cell values only, not formatting or merge structure.
+ * IReader::IGNORE_EMPTY_CELLS - Don't load empty cells into the model.
+ * @param string[] $readers An array of Readers to use to identify the file type. By default, load() will try
+ * all possible Readers until it finds a match; but this allows you to pass in a
+ * list of Readers so it will only try the subset that you specify here.
+ * Values in this list can be any of the constant values defined in the set
+ * IOFactory::READER_*.
+ */
+ public static function load(string $filename, int $flags = 0, ?array $readers = null): Spreadsheet
+ {
+ $reader = self::createReaderForFile($filename, $readers);
+
+ return $reader->load($filename, $flags);
+ }
+
+ /**
+ * Identify file type using automatic IReader resolution.
+ */
+ public static function identify(string $filename, ?array $readers = null): string
+ {
+ $reader = self::createReaderForFile($filename, $readers);
+ $className = $reader::class;
+ $classType = explode('\\', $className);
+ unset($reader);
+
+ return array_pop($classType);
+ }
+
+ /**
+ * Create Reader\IReader for file using automatic IReader resolution.
+ *
+ * @param string[] $readers An array of Readers to use to identify the file type. By default, load() will try
+ * all possible Readers until it finds a match; but this allows you to pass in a
+ * list of Readers so it will only try the subset that you specify here.
+ * Values in this list can be any of the constant values defined in the set
+ * IOFactory::READER_*.
+ */
+ public static function createReaderForFile(string $filename, ?array $readers = null): IReader
+ {
+ File::assertFile($filename);
+
+ $testReaders = self::$readers;
+ if ($readers !== null) {
+ $readers = array_map('strtoupper', $readers);
+ $testReaders = array_filter(
+ self::$readers,
+ fn (string $readerType): bool => in_array(strtoupper($readerType), $readers, true),
+ ARRAY_FILTER_USE_KEY
+ );
+ }
+
+ // First, lucky guess by inspecting file extension
+ $guessedReader = self::getReaderTypeFromExtension($filename);
+ if (($guessedReader !== null) && array_key_exists($guessedReader, $testReaders)) {
+ $reader = self::createReader($guessedReader);
+
+ // Let's see if we are lucky
+ if ($reader->canRead($filename)) {
+ return $reader;
+ }
+ }
+
+ // If we reach here then "lucky guess" didn't give any result
+ // Try walking through all the options in self::$readers (or the selected subset)
+ foreach ($testReaders as $readerType => $class) {
+ // Ignore our original guess, we know that won't work
+ if ($readerType !== $guessedReader) {
+ $reader = self::createReader($readerType);
+ if ($reader->canRead($filename)) {
+ return $reader;
+ }
+ }
+ }
+
+ throw new Reader\Exception('Unable to identify a reader for this file');
+ }
+
+ /**
+ * Guess a reader type from the file extension, if any.
+ */
+ private static function getReaderTypeFromExtension(string $filename): ?string
+ {
+ $pathinfo = pathinfo($filename);
+ if (!isset($pathinfo['extension'])) {
+ return null;
+ }
+
+ return match (strtolower($pathinfo['extension'])) {
+ // Excel (OfficeOpenXML) Spreadsheet
+ 'xlsx',
+ // Excel (OfficeOpenXML) Macro Spreadsheet (macros will be discarded)
+ 'xlsm',
+ // Excel (OfficeOpenXML) Template
+ 'xltx',
+ // Excel (OfficeOpenXML) Macro Template (macros will be discarded)
+ 'xltm' => 'Xlsx',
+ // Excel (BIFF) Spreadsheet
+ 'xls',
+ // Excel (BIFF) Template
+ 'xlt' => 'Xls',
+ // Open/Libre Offic Calc
+ 'ods',
+ // Open/Libre Offic Calc Template
+ 'ots' => 'Ods',
+ 'slk' => 'Slk',
+ // Excel 2003 SpreadSheetML
+ 'xml' => 'Xml',
+ 'gnumeric' => 'Gnumeric',
+ 'htm', 'html' => 'Html',
+ // Do nothing
+ // We must not try to use CSV reader since it loads
+ // all files including Excel files etc.
+ 'csv' => null,
+ default => null,
+ };
+ }
+
+ /**
+ * Register a writer with its type and class name.
+ *
+ * @param class-string $writerClass
+ */
+ public static function registerWriter(string $writerType, string $writerClass): void
+ {
+ if (!is_a($writerClass, IWriter::class, true)) {
+ throw new Writer\Exception('Registered writers must implement ' . IWriter::class);
+ }
+
+ self::$writers[$writerType] = $writerClass;
+ }
+
+ /**
+ * Register a reader with its type and class name.
+ */
+ public static function registerReader(string $readerType, string $readerClass): void
+ {
+ if (!is_a($readerClass, IReader::class, true)) {
+ throw new Reader\Exception('Registered readers must implement ' . IReader::class);
+ }
+
+ self::$readers[$readerType] = $readerClass;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/NamedFormula.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/NamedFormula.php
new file mode 100644
index 00000000..500151f0
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/NamedFormula.php
@@ -0,0 +1,45 @@
+value;
+ }
+
+ /**
+ * Set the formula value.
+ */
+ public function setFormula(string $formula): self
+ {
+ if (!empty($formula)) {
+ $this->value = $formula;
+ }
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/NamedRange.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/NamedRange.php
new file mode 100644
index 00000000..819ddeac
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/NamedRange.php
@@ -0,0 +1,55 @@
+value;
+ }
+
+ /**
+ * Set the range value.
+ */
+ public function setRange(string $range): self
+ {
+ if (!empty($range)) {
+ $this->value = $range;
+ }
+
+ return $this;
+ }
+
+ public function getCellsInRange(): array
+ {
+ $range = $this->value;
+ if (str_starts_with($range, '=')) {
+ $range = substr($range, 1);
+ }
+
+ return Coordinate::extractAllCellReferencesInRange($range);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/BaseReader.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/BaseReader.php
new file mode 100644
index 00000000..1408f7bf
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/BaseReader.php
@@ -0,0 +1,245 @@
+readFilter = new DefaultReadFilter();
+ }
+
+ public function getReadDataOnly(): bool
+ {
+ return $this->readDataOnly;
+ }
+
+ public function setReadDataOnly(bool $readCellValuesOnly): self
+ {
+ $this->readDataOnly = $readCellValuesOnly;
+
+ return $this;
+ }
+
+ public function getReadEmptyCells(): bool
+ {
+ return $this->readEmptyCells;
+ }
+
+ public function setReadEmptyCells(bool $readEmptyCells): self
+ {
+ $this->readEmptyCells = $readEmptyCells;
+
+ return $this;
+ }
+
+ public function getIgnoreRowsWithNoCells(): bool
+ {
+ return $this->ignoreRowsWithNoCells;
+ }
+
+ public function setIgnoreRowsWithNoCells(bool $ignoreRowsWithNoCells): self
+ {
+ $this->ignoreRowsWithNoCells = $ignoreRowsWithNoCells;
+
+ return $this;
+ }
+
+ public function getIncludeCharts(): bool
+ {
+ return $this->includeCharts;
+ }
+
+ public function setIncludeCharts(bool $includeCharts): self
+ {
+ $this->includeCharts = $includeCharts;
+
+ return $this;
+ }
+
+ public function getLoadSheetsOnly(): ?array
+ {
+ return $this->loadSheetsOnly;
+ }
+
+ public function setLoadSheetsOnly(string|array|null $sheetList): self
+ {
+ if ($sheetList === null) {
+ return $this->setLoadAllSheets();
+ }
+
+ $this->loadSheetsOnly = is_array($sheetList) ? $sheetList : [$sheetList];
+
+ return $this;
+ }
+
+ public function setLoadAllSheets(): self
+ {
+ $this->loadSheetsOnly = null;
+
+ return $this;
+ }
+
+ public function getReadFilter(): IReadFilter
+ {
+ return $this->readFilter;
+ }
+
+ public function setReadFilter(IReadFilter $readFilter): self
+ {
+ $this->readFilter = $readFilter;
+
+ return $this;
+ }
+
+ public function getSecurityScanner(): ?XmlScanner
+ {
+ return $this->securityScanner;
+ }
+
+ public function getSecurityScannerOrThrow(): XmlScanner
+ {
+ if ($this->securityScanner === null) {
+ throw new ReaderException('Security scanner is unexpectedly null');
+ }
+
+ return $this->securityScanner;
+ }
+
+ protected function processFlags(int $flags): void
+ {
+ if (((bool) ($flags & self::LOAD_WITH_CHARTS)) === true) {
+ $this->setIncludeCharts(true);
+ }
+ if (((bool) ($flags & self::READ_DATA_ONLY)) === true) {
+ $this->setReadDataOnly(true);
+ }
+ if (((bool) ($flags & self::SKIP_EMPTY_CELLS) || (bool) ($flags & self::IGNORE_EMPTY_CELLS)) === true) {
+ $this->setReadEmptyCells(false);
+ }
+ if (((bool) ($flags & self::IGNORE_ROWS_WITH_NO_CELLS)) === true) {
+ $this->setIgnoreRowsWithNoCells(true);
+ }
+ }
+
+ protected function loadSpreadsheetFromFile(string $filename): Spreadsheet
+ {
+ throw new PhpSpreadsheetException('Reader classes must implement their own loadSpreadsheetFromFile() method');
+ }
+
+ /**
+ * Loads Spreadsheet from file.
+ *
+ * @param int $flags the optional second parameter flags may be used to identify specific elements
+ * that should be loaded, but which won't be loaded by default, using these values:
+ * IReader::LOAD_WITH_CHARTS - Include any charts that are defined in the loaded file
+ */
+ public function load(string $filename, int $flags = 0): Spreadsheet
+ {
+ $this->processFlags($flags);
+
+ try {
+ return $this->loadSpreadsheetFromFile($filename);
+ } catch (ReaderException $e) {
+ throw $e;
+ }
+ }
+
+ /**
+ * Open file for reading.
+ */
+ protected function openFile(string $filename): void
+ {
+ $fileHandle = false;
+ if ($filename) {
+ File::assertFile($filename);
+
+ // Open file
+ $fileHandle = fopen($filename, 'rb');
+ }
+ if ($fileHandle === false) {
+ throw new ReaderException('Could not open file ' . $filename . ' for reading.');
+ }
+
+ $this->fileHandle = $fileHandle;
+ }
+
+ /**
+ * Return worksheet info (Name, Last Column Letter, Last Column Index, Total Rows, Total Columns).
+ */
+ public function listWorksheetInfo(string $filename): array
+ {
+ throw new PhpSpreadsheetException('Reader classes must implement their own listWorksheetInfo() method');
+ }
+
+ /**
+ * Returns names of the worksheets from a file,
+ * possibly without parsing the whole file to a Spreadsheet object.
+ * Readers will often have a more efficient method with which
+ * they can override this method.
+ */
+ public function listWorksheetNames(string $filename): array
+ {
+ $returnArray = [];
+ $info = $this->listWorksheetInfo($filename);
+ foreach ($info as $infoArray) {
+ if (isset($infoArray['worksheetName'])) {
+ $returnArray[] = $infoArray['worksheetName'];
+ }
+ }
+
+ return $returnArray;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Csv.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Csv.php
new file mode 100644
index 00000000..1c88e0b0
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Csv.php
@@ -0,0 +1,745 @@
+inputEncoding = $encoding;
+
+ return $this;
+ }
+
+ public function getInputEncoding(): string
+ {
+ return $this->inputEncoding;
+ }
+
+ public function setFallbackEncoding(string $fallbackEncoding): self
+ {
+ $this->fallbackEncoding = $fallbackEncoding;
+
+ return $this;
+ }
+
+ public function getFallbackEncoding(): string
+ {
+ return $this->fallbackEncoding;
+ }
+
+ /**
+ * Move filepointer past any BOM marker.
+ */
+ protected function skipBOM(): void
+ {
+ rewind($this->fileHandle);
+
+ if (fgets($this->fileHandle, self::UTF8_BOM_LEN + 1) !== self::UTF8_BOM) {
+ rewind($this->fileHandle);
+ }
+ }
+
+ /**
+ * Identify any separator that is explicitly set in the file.
+ */
+ protected function checkSeparator(): void
+ {
+ $line = fgets($this->fileHandle);
+ if ($line === false) {
+ return;
+ }
+
+ if ((strlen(trim($line, "\r\n")) == 5) && (stripos($line, 'sep=') === 0)) {
+ $this->delimiter = substr($line, 4, 1);
+
+ return;
+ }
+
+ $this->skipBOM();
+ }
+
+ /**
+ * Infer the separator if it isn't explicitly set in the file or specified by the user.
+ */
+ protected function inferSeparator(): void
+ {
+ if ($this->delimiter !== null) {
+ return;
+ }
+
+ $inferenceEngine = new Delimiter($this->fileHandle, $this->escapeCharacter ?? self::$defaultEscapeCharacter, $this->enclosure);
+
+ // If number of lines is 0, nothing to infer : fall back to the default
+ if ($inferenceEngine->linesCounted() === 0) {
+ $this->delimiter = $inferenceEngine->getDefaultDelimiter();
+ $this->skipBOM();
+
+ return;
+ }
+
+ $this->delimiter = $inferenceEngine->infer();
+
+ // If no delimiter could be detected, fall back to the default
+ if ($this->delimiter === null) {
+ $this->delimiter = $inferenceEngine->getDefaultDelimiter();
+ }
+
+ $this->skipBOM();
+ }
+
+ /**
+ * Return worksheet info (Name, Last Column Letter, Last Column Index, Total Rows, Total Columns).
+ */
+ public function listWorksheetInfo(string $filename): array
+ {
+ // Open file
+ $this->openFileOrMemory($filename);
+ $fileHandle = $this->fileHandle;
+
+ // Skip BOM, if any
+ $this->skipBOM();
+ $this->checkSeparator();
+ $this->inferSeparator();
+
+ $worksheetInfo = [];
+ $worksheetInfo[0]['worksheetName'] = 'Worksheet';
+ $worksheetInfo[0]['lastColumnLetter'] = 'A';
+ $worksheetInfo[0]['lastColumnIndex'] = 0;
+ $worksheetInfo[0]['totalRows'] = 0;
+ $worksheetInfo[0]['totalColumns'] = 0;
+ $delimiter = $this->delimiter ?? '';
+
+ // Loop through each line of the file in turn
+ $rowData = self::getCsv($fileHandle, 0, $delimiter, $this->enclosure, $this->escapeCharacter);
+ while (is_array($rowData)) {
+ ++$worksheetInfo[0]['totalRows'];
+ $worksheetInfo[0]['lastColumnIndex'] = max($worksheetInfo[0]['lastColumnIndex'], count($rowData) - 1);
+ $rowData = self::getCsv($fileHandle, 0, $delimiter, $this->enclosure, $this->escapeCharacter);
+ }
+
+ $worksheetInfo[0]['lastColumnLetter'] = Coordinate::stringFromColumnIndex($worksheetInfo[0]['lastColumnIndex'] + 1);
+ $worksheetInfo[0]['totalColumns'] = $worksheetInfo[0]['lastColumnIndex'] + 1;
+
+ // Close file
+ fclose($fileHandle);
+
+ return $worksheetInfo;
+ }
+
+ /**
+ * Loads Spreadsheet from file.
+ */
+ protected function loadSpreadsheetFromFile(string $filename): Spreadsheet
+ {
+ // Create new Spreadsheet
+ $spreadsheet = new Spreadsheet();
+
+ // Load into this instance
+ return $this->loadIntoExisting($filename, $spreadsheet);
+ }
+
+ /**
+ * Loads Spreadsheet from string.
+ */
+ public function loadSpreadsheetFromString(string $contents): Spreadsheet
+ {
+ // Create new Spreadsheet
+ $spreadsheet = new Spreadsheet();
+
+ // Load into this instance
+ return $this->loadStringOrFile('data://text/plain,' . urlencode($contents), $spreadsheet, true);
+ }
+
+ private function openFileOrMemory(string $filename): void
+ {
+ // Open file
+ $fhandle = $this->canRead($filename);
+ if (!$fhandle) {
+ throw new ReaderException($filename . ' is an Invalid Spreadsheet file.');
+ }
+ if ($this->inputEncoding === 'UTF-8') {
+ $encoding = self::guessEncodingBom($filename);
+ if ($encoding !== '') {
+ $this->inputEncoding = $encoding;
+ }
+ }
+ if ($this->inputEncoding === self::GUESS_ENCODING) {
+ $this->inputEncoding = self::guessEncoding($filename, $this->fallbackEncoding);
+ }
+ $this->openFile($filename);
+ if ($this->inputEncoding !== 'UTF-8') {
+ fclose($this->fileHandle);
+ $entireFile = file_get_contents($filename);
+ $fileHandle = fopen('php://memory', 'r+b');
+ if ($fileHandle !== false && $entireFile !== false) {
+ $this->fileHandle = $fileHandle;
+ $data = StringHelper::convertEncoding($entireFile, 'UTF-8', $this->inputEncoding);
+ fwrite($this->fileHandle, $data);
+ $this->skipBOM();
+ }
+ }
+ }
+
+ public function setTestAutoDetect(bool $value): self
+ {
+ $this->testAutodetect = $value;
+
+ return $this;
+ }
+
+ private function setAutoDetect(?string $value): ?string
+ {
+ $retVal = null;
+ if ($value !== null && $this->testAutodetect && PHP_VERSION_ID < 90000) {
+ $retVal2 = @ini_set('auto_detect_line_endings', $value);
+ if (is_string($retVal2)) {
+ $retVal = $retVal2;
+ }
+ }
+
+ return $retVal;
+ }
+
+ public function castFormattedNumberToNumeric(
+ bool $castFormattedNumberToNumeric,
+ bool $preserveNumericFormatting = false
+ ): void {
+ $this->castFormattedNumberToNumeric = $castFormattedNumberToNumeric;
+ $this->preserveNumericFormatting = $preserveNumericFormatting;
+ }
+
+ /**
+ * Open data uri for reading.
+ */
+ private function openDataUri(string $filename): void
+ {
+ $fileHandle = fopen($filename, 'rb');
+ if ($fileHandle === false) {
+ // @codeCoverageIgnoreStart
+ throw new ReaderException('Could not open file ' . $filename . ' for reading.');
+ // @codeCoverageIgnoreEnd
+ }
+
+ $this->fileHandle = $fileHandle;
+ }
+
+ /**
+ * Loads PhpSpreadsheet from file into PhpSpreadsheet instance.
+ */
+ public function loadIntoExisting(string $filename, Spreadsheet $spreadsheet): Spreadsheet
+ {
+ return $this->loadStringOrFile($filename, $spreadsheet, false);
+ }
+
+ /**
+ * Loads PhpSpreadsheet from file into PhpSpreadsheet instance.
+ */
+ private function loadStringOrFile(string $filename, Spreadsheet $spreadsheet, bool $dataUri): Spreadsheet
+ {
+ // Deprecated in Php8.1
+ $iniset = $this->setAutoDetect('1');
+
+ try {
+ $this->loadStringOrFile2($filename, $spreadsheet, $dataUri);
+ $this->setAutoDetect($iniset);
+ } catch (Throwable $e) {
+ $this->setAutoDetect($iniset);
+
+ throw $e;
+ }
+
+ return $spreadsheet;
+ }
+
+ private function loadStringOrFile2(string $filename, Spreadsheet $spreadsheet, bool $dataUri): void
+ {
+ // Open file
+ if ($dataUri) {
+ $this->openDataUri($filename);
+ } else {
+ $this->openFileOrMemory($filename);
+ }
+ $fileHandle = $this->fileHandle;
+
+ // Skip BOM, if any
+ $this->skipBOM();
+ $this->checkSeparator();
+ $this->inferSeparator();
+
+ // Create new PhpSpreadsheet object
+ while ($spreadsheet->getSheetCount() <= $this->sheetIndex) {
+ $spreadsheet->createSheet();
+ }
+ $sheet = $spreadsheet->setActiveSheetIndex($this->sheetIndex);
+ if ($this->sheetNameIsFileName) {
+ $sheet->setTitle(substr(basename($filename, '.csv'), 0, Worksheet::SHEET_TITLE_MAXIMUM_LENGTH));
+ }
+
+ // Set our starting row based on whether we're in contiguous mode or not
+ $currentRow = 1;
+ $outRow = 0;
+
+ // Loop through each line of the file in turn
+ $delimiter = $this->delimiter ?? '';
+ $rowData = self::getCsv($fileHandle, 0, $delimiter, $this->enclosure, $this->escapeCharacter);
+ $valueBinder = Cell::getValueBinder();
+ $preserveBooleanString = method_exists($valueBinder, 'getBooleanConversion') && $valueBinder->getBooleanConversion();
+ $this->getTrue = Calculation::getTRUE();
+ $this->getFalse = Calculation::getFALSE();
+ $this->thousandsSeparator = StringHelper::getThousandsSeparator();
+ $this->decimalSeparator = StringHelper::getDecimalSeparator();
+ while (is_array($rowData)) {
+ $noOutputYet = true;
+ $columnLetter = 'A';
+ foreach ($rowData as $rowDatum) {
+ if ($preserveBooleanString) {
+ $rowDatum = $rowDatum ?? '';
+ } else {
+ $this->convertBoolean($rowDatum);
+ }
+ $numberFormatMask = $this->castFormattedNumberToNumeric ? $this->convertFormattedNumber($rowDatum) : '';
+ if (($rowDatum !== '' || $this->preserveNullString) && $this->readFilter->readCell($columnLetter, $currentRow)) {
+ if ($this->contiguous) {
+ if ($noOutputYet) {
+ $noOutputYet = false;
+ ++$outRow;
+ }
+ } else {
+ $outRow = $currentRow;
+ }
+ // Set basic styling for the value (Note that this could be overloaded by styling in a value binder)
+ if ($numberFormatMask !== '') {
+ $sheet->getStyle($columnLetter . $outRow)
+ ->getNumberFormat()
+ ->setFormatCode($numberFormatMask);
+ }
+ // Set cell value
+ $sheet->getCell($columnLetter . $outRow)->setValue($rowDatum);
+ }
+ ++$columnLetter;
+ }
+ $rowData = self::getCsv($fileHandle, 0, $delimiter, $this->enclosure, $this->escapeCharacter);
+ ++$currentRow;
+ }
+
+ // Close file
+ fclose($fileHandle);
+ }
+
+ /**
+ * Convert string true/false to boolean, and null to null-string.
+ */
+ private function convertBoolean(mixed &$rowDatum): void
+ {
+ if (is_string($rowDatum)) {
+ if (strcasecmp($this->getTrue, $rowDatum) === 0 || strcasecmp('true', $rowDatum) === 0) {
+ $rowDatum = true;
+ } elseif (strcasecmp($this->getFalse, $rowDatum) === 0 || strcasecmp('false', $rowDatum) === 0) {
+ $rowDatum = false;
+ }
+ } else {
+ $rowDatum = $rowDatum ?? '';
+ }
+ }
+
+ /**
+ * Convert numeric strings to int or float values.
+ */
+ private function convertFormattedNumber(mixed &$rowDatum): string
+ {
+ $numberFormatMask = '';
+ if ($this->castFormattedNumberToNumeric === true && is_string($rowDatum)) {
+ $numeric = str_replace(
+ [$this->thousandsSeparator, $this->decimalSeparator],
+ ['', '.'],
+ $rowDatum
+ );
+
+ if (is_numeric($numeric)) {
+ $decimalPos = strpos($rowDatum, $this->decimalSeparator);
+ if ($this->preserveNumericFormatting === true) {
+ $numberFormatMask = (str_contains($rowDatum, $this->thousandsSeparator))
+ ? '#,##0' : '0';
+ if ($decimalPos !== false) {
+ $decimals = strlen($rowDatum) - $decimalPos - 1;
+ $numberFormatMask .= '.' . str_repeat('0', min($decimals, 6));
+ }
+ }
+
+ $rowDatum = ($decimalPos !== false) ? (float) $numeric : (int) $numeric;
+ }
+ }
+
+ return $numberFormatMask;
+ }
+
+ public function getDelimiter(): ?string
+ {
+ return $this->delimiter;
+ }
+
+ public function setDelimiter(?string $delimiter): self
+ {
+ $this->delimiter = $delimiter;
+
+ return $this;
+ }
+
+ public function getEnclosure(): string
+ {
+ return $this->enclosure;
+ }
+
+ public function setEnclosure(string $enclosure): self
+ {
+ if ($enclosure == '') {
+ $enclosure = '"';
+ }
+ $this->enclosure = $enclosure;
+
+ return $this;
+ }
+
+ public function getSheetIndex(): int
+ {
+ return $this->sheetIndex;
+ }
+
+ public function setSheetIndex(int $indexValue): self
+ {
+ $this->sheetIndex = $indexValue;
+
+ return $this;
+ }
+
+ public function setContiguous(bool $contiguous): self
+ {
+ $this->contiguous = $contiguous;
+
+ return $this;
+ }
+
+ public function getContiguous(): bool
+ {
+ return $this->contiguous;
+ }
+
+ /**
+ * Php9 intends to drop support for this parameter in fgetcsv.
+ * Not yet ready to mark deprecated in order to give users
+ * a migration path.
+ */
+ public function setEscapeCharacter(string $escapeCharacter): self
+ {
+ if (PHP_VERSION_ID >= 90000 && $escapeCharacter !== '') {
+ throw new ReaderException('Escape character must be null string for Php9+');
+ }
+
+ $this->escapeCharacter = $escapeCharacter;
+
+ return $this;
+ }
+
+ public function getEscapeCharacter(): string
+ {
+ return $this->escapeCharacter ?? self::$defaultEscapeCharacter;
+ }
+
+ /**
+ * Can the current IReader read the file?
+ */
+ public function canRead(string $filename): bool
+ {
+ // Check if file exists
+ try {
+ $this->openFile($filename);
+ } catch (ReaderException) {
+ return false;
+ }
+
+ fclose($this->fileHandle);
+
+ // Trust file extension if any
+ $extension = strtolower(pathinfo($filename, PATHINFO_EXTENSION));
+ if (in_array($extension, ['csv', 'tsv'])) {
+ return true;
+ }
+
+ // Attempt to guess mimetype
+ $type = mime_content_type($filename);
+ $supportedTypes = [
+ 'application/csv',
+ 'text/csv',
+ 'text/plain',
+ 'inode/x-empty',
+ 'text/html',
+ ];
+
+ return in_array($type, $supportedTypes, true);
+ }
+
+ private static function guessEncodingTestNoBom(string &$encoding, string &$contents, string $compare, string $setEncoding): void
+ {
+ if ($encoding === '') {
+ $pos = strpos($contents, $compare);
+ if ($pos !== false && $pos % strlen($compare) === 0) {
+ $encoding = $setEncoding;
+ }
+ }
+ }
+
+ private static function guessEncodingNoBom(string $filename): string
+ {
+ $encoding = '';
+ $contents = file_get_contents($filename);
+ self::guessEncodingTestNoBom($encoding, $contents, self::UTF32BE_LF, 'UTF-32BE');
+ self::guessEncodingTestNoBom($encoding, $contents, self::UTF32LE_LF, 'UTF-32LE');
+ self::guessEncodingTestNoBom($encoding, $contents, self::UTF16BE_LF, 'UTF-16BE');
+ self::guessEncodingTestNoBom($encoding, $contents, self::UTF16LE_LF, 'UTF-16LE');
+ if ($encoding === '' && preg_match('//u', $contents) === 1) {
+ $encoding = 'UTF-8';
+ }
+
+ return $encoding;
+ }
+
+ private static function guessEncodingTestBom(string &$encoding, string $first4, string $compare, string $setEncoding): void
+ {
+ if ($encoding === '') {
+ if (str_starts_with($first4, $compare)) {
+ $encoding = $setEncoding;
+ }
+ }
+ }
+
+ public static function guessEncodingBom(string $filename, ?string $convertString = null): string
+ {
+ $encoding = '';
+ $first4 = $convertString ?? (string) file_get_contents($filename, false, null, 0, 4);
+ self::guessEncodingTestBom($encoding, $first4, self::UTF8_BOM, 'UTF-8');
+ self::guessEncodingTestBom($encoding, $first4, self::UTF16BE_BOM, 'UTF-16BE');
+ self::guessEncodingTestBom($encoding, $first4, self::UTF32BE_BOM, 'UTF-32BE');
+ self::guessEncodingTestBom($encoding, $first4, self::UTF32LE_BOM, 'UTF-32LE');
+ self::guessEncodingTestBom($encoding, $first4, self::UTF16LE_BOM, 'UTF-16LE');
+
+ return $encoding;
+ }
+
+ public static function guessEncoding(string $filename, string $dflt = self::DEFAULT_FALLBACK_ENCODING): string
+ {
+ $encoding = self::guessEncodingBom($filename);
+ if ($encoding === '') {
+ $encoding = self::guessEncodingNoBom($filename);
+ }
+
+ return ($encoding === '') ? $dflt : $encoding;
+ }
+
+ public function setPreserveNullString(bool $value): self
+ {
+ $this->preserveNullString = $value;
+
+ return $this;
+ }
+
+ public function getPreserveNullString(): bool
+ {
+ return $this->preserveNullString;
+ }
+
+ public function setSheetNameIsFileName(bool $sheetNameIsFileName): self
+ {
+ $this->sheetNameIsFileName = $sheetNameIsFileName;
+
+ return $this;
+ }
+
+ /**
+ * Php8.4 deprecates use of anything other than null string
+ * as escape Character.
+ *
+ * @param resource $stream
+ * @param null|int<0, max> $length
+ *
+ * @return array|false
+ */
+ private static function getCsv(
+ $stream,
+ ?int $length = null,
+ string $separator = ',',
+ string $enclosure = '"',
+ ?string $escape = null
+ ): array|false {
+ $escape = $escape ?? self::$defaultEscapeCharacter;
+ if (PHP_VERSION_ID >= 80400 && $escape !== '') {
+ return @fgetcsv($stream, $length, $separator, $enclosure, $escape);
+ }
+
+ return fgetcsv($stream, $length, $separator, $enclosure, $escape);
+ }
+
+ public static function affectedByPhp9(
+ string $filename,
+ string $inputEncoding = 'UTF-8',
+ ?string $delimiter = null,
+ string $enclosure = '"',
+ string $escapeCharacter = '\\'
+ ): bool {
+ if (PHP_VERSION_ID < 70400 || PHP_VERSION_ID >= 90000) {
+ throw new ReaderException('Function valid only for Php7.4 or Php8'); // @codeCoverageIgnore
+ }
+ $reader1 = new self();
+ $reader1->setInputEncoding($inputEncoding)
+ ->setTestAutoDetect(true)
+ ->setEscapeCharacter($escapeCharacter)
+ ->setDelimiter($delimiter)
+ ->setEnclosure($enclosure);
+ $spreadsheet1 = $reader1->load($filename);
+ $sheet1 = $spreadsheet1->getActiveSheet();
+ $array1 = $sheet1->toArray(null, false, false);
+ $spreadsheet1->disconnectWorksheets();
+
+ $reader2 = new self();
+ $reader2->setInputEncoding($inputEncoding)
+ ->setTestAutoDetect(false)
+ ->setEscapeCharacter('')
+ ->setDelimiter($delimiter)
+ ->setEnclosure($enclosure);
+ $spreadsheet2 = $reader2->load($filename);
+ $sheet2 = $spreadsheet2->getActiveSheet();
+ $array2 = $sheet2->toArray(null, false, false);
+ $spreadsheet2->disconnectWorksheets();
+
+ return $array1 !== $array2;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Csv/Delimiter.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Csv/Delimiter.php
new file mode 100644
index 00000000..92ec0b5d
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Csv/Delimiter.php
@@ -0,0 +1,144 @@
+fileHandle = $fileHandle;
+ $this->escapeCharacter = $escapeCharacter;
+ $this->enclosure = $enclosure;
+
+ $this->countPotentialDelimiters();
+ }
+
+ public function getDefaultDelimiter(): string
+ {
+ return self::POTENTIAL_DELIMETERS[0];
+ }
+
+ public function linesCounted(): int
+ {
+ return $this->numberLines;
+ }
+
+ protected function countPotentialDelimiters(): void
+ {
+ $this->counts = array_fill_keys(self::POTENTIAL_DELIMETERS, []);
+ $delimiterKeys = array_flip(self::POTENTIAL_DELIMETERS);
+
+ // Count how many times each of the potential delimiters appears in each line
+ $this->numberLines = 0;
+ while (($line = $this->getNextLine()) !== false && (++$this->numberLines < 1000)) {
+ $this->countDelimiterValues($line, $delimiterKeys);
+ }
+ }
+
+ protected function countDelimiterValues(string $line, array $delimiterKeys): void
+ {
+ $splitString = str_split($line, 1);
+ if (is_array($splitString)) {
+ $distribution = array_count_values($splitString);
+ $countLine = array_intersect_key($distribution, $delimiterKeys);
+
+ foreach (self::POTENTIAL_DELIMETERS as $delimiter) {
+ $this->counts[$delimiter][] = $countLine[$delimiter] ?? 0;
+ }
+ }
+ }
+
+ public function infer(): ?string
+ {
+ // Calculate the mean square deviations for each delimiter
+ // (ignoring delimiters that haven't been found consistently)
+ $meanSquareDeviations = [];
+ $middleIdx = floor(($this->numberLines - 1) / 2);
+
+ foreach (self::POTENTIAL_DELIMETERS as $delimiter) {
+ $series = $this->counts[$delimiter];
+ sort($series);
+
+ $median = ($this->numberLines % 2)
+ ? $series[$middleIdx]
+ : ($series[$middleIdx] + $series[$middleIdx + 1]) / 2;
+
+ if ($median === 0) {
+ continue;
+ }
+
+ $meanSquareDeviations[$delimiter] = array_reduce(
+ $series,
+ fn ($sum, $value): int|float => $sum + ($value - $median) ** 2
+ ) / count($series);
+ }
+
+ // ... and pick the delimiter with the smallest mean square deviation
+ // (in case of ties, the order in potentialDelimiters is respected)
+ $min = INF;
+ foreach (self::POTENTIAL_DELIMETERS as $delimiter) {
+ if (!isset($meanSquareDeviations[$delimiter])) {
+ continue;
+ }
+
+ if ($meanSquareDeviations[$delimiter] < $min) {
+ $min = $meanSquareDeviations[$delimiter];
+ $this->delimiter = $delimiter;
+ }
+ }
+
+ return $this->delimiter;
+ }
+
+ /**
+ * Get the next full line from the file.
+ *
+ * @return false|string
+ */
+ public function getNextLine()
+ {
+ $line = '';
+ $enclosure = ($this->escapeCharacter === '' ? ''
+ : ('(?escapeCharacter, '/') . ')'))
+ . preg_quote($this->enclosure, '/');
+
+ do {
+ // Get the next line in the file
+ $newLine = fgets($this->fileHandle);
+
+ // Return false if there is no next line
+ if ($newLine === false) {
+ return false;
+ }
+
+ // Add the new line to the line passed in
+ $line = $line . $newLine;
+
+ // Drop everything that is enclosed to avoid counting false positives in enclosures
+ $line = (string) preg_replace('/(' . $enclosure . '.*' . $enclosure . ')/Us', '', $line);
+
+ // See if we have any enclosures left in the line
+ // if we still have an enclosure then we need to read the next line as well
+ } while (preg_match('/(' . $enclosure . ')/', $line) > 0);
+
+ return ($line !== '') ? $line : false;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/DefaultReadFilter.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/DefaultReadFilter.php
new file mode 100644
index 00000000..0c4b87b6
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/DefaultReadFilter.php
@@ -0,0 +1,18 @@
+ [
+ '10' => DataType::TYPE_NULL,
+ '20' => DataType::TYPE_BOOL,
+ '30' => DataType::TYPE_NUMERIC, // Integer doesn't exist in Excel
+ '40' => DataType::TYPE_NUMERIC, // Float
+ '50' => DataType::TYPE_ERROR,
+ '60' => DataType::TYPE_STRING,
+ //'70': // Cell Range
+ //'80': // Array
+ ],
+ ];
+
+ /**
+ * Create a new Gnumeric.
+ */
+ public function __construct()
+ {
+ parent::__construct();
+ $this->referenceHelper = ReferenceHelper::getInstance();
+ $this->securityScanner = XmlScanner::getInstance($this);
+ }
+
+ /**
+ * Can the current IReader read the file?
+ */
+ public function canRead(string $filename): bool
+ {
+ $data = null;
+ if (File::testFileNoThrow($filename)) {
+ $data = $this->gzfileGetContents($filename);
+ if (!str_contains($data, self::NAMESPACE_GNM)) {
+ $data = '';
+ }
+ }
+
+ return !empty($data);
+ }
+
+ private static function matchXml(XMLReader $xml, string $expectedLocalName): bool
+ {
+ return $xml->namespaceURI === self::NAMESPACE_GNM
+ && $xml->localName === $expectedLocalName
+ && $xml->nodeType === XMLReader::ELEMENT;
+ }
+
+ /**
+ * Reads names of the worksheets from a file, without parsing the whole file to a Spreadsheet object.
+ */
+ public function listWorksheetNames(string $filename): array
+ {
+ File::assertFile($filename);
+ if (!$this->canRead($filename)) {
+ throw new Exception($filename . ' is an invalid Gnumeric file.');
+ }
+
+ $xml = new XMLReader();
+ $contents = $this->gzfileGetContents($filename);
+ $xml->xml($contents);
+ $xml->setParserProperty(2, true);
+
+ $worksheetNames = [];
+ while ($xml->read()) {
+ if (self::matchXml($xml, 'SheetName')) {
+ $xml->read(); // Move onto the value node
+ $worksheetNames[] = (string) $xml->value;
+ } elseif (self::matchXml($xml, 'Sheets')) {
+ // break out of the loop once we've got our sheet names rather than parse the entire file
+ break;
+ }
+ }
+
+ return $worksheetNames;
+ }
+
+ /**
+ * Return worksheet info (Name, Last Column Letter, Last Column Index, Total Rows, Total Columns).
+ */
+ public function listWorksheetInfo(string $filename): array
+ {
+ File::assertFile($filename);
+ if (!$this->canRead($filename)) {
+ throw new Exception($filename . ' is an invalid Gnumeric file.');
+ }
+
+ $xml = new XMLReader();
+ $contents = $this->gzfileGetContents($filename);
+ $xml->xml($contents);
+ $xml->setParserProperty(2, true);
+
+ $worksheetInfo = [];
+ while ($xml->read()) {
+ if (self::matchXml($xml, 'Sheet')) {
+ $tmpInfo = [
+ 'worksheetName' => '',
+ 'lastColumnLetter' => 'A',
+ 'lastColumnIndex' => 0,
+ 'totalRows' => 0,
+ 'totalColumns' => 0,
+ ];
+
+ while ($xml->read()) {
+ if (self::matchXml($xml, 'Name')) {
+ $xml->read(); // Move onto the value node
+ $tmpInfo['worksheetName'] = (string) $xml->value;
+ } elseif (self::matchXml($xml, 'MaxCol')) {
+ $xml->read(); // Move onto the value node
+ $tmpInfo['lastColumnIndex'] = (int) $xml->value;
+ $tmpInfo['totalColumns'] = (int) $xml->value + 1;
+ } elseif (self::matchXml($xml, 'MaxRow')) {
+ $xml->read(); // Move onto the value node
+ $tmpInfo['totalRows'] = (int) $xml->value + 1;
+
+ break;
+ }
+ }
+ $tmpInfo['lastColumnLetter'] = Coordinate::stringFromColumnIndex($tmpInfo['lastColumnIndex'] + 1);
+ $worksheetInfo[] = $tmpInfo;
+ }
+ }
+
+ return $worksheetInfo;
+ }
+
+ private function gzfileGetContents(string $filename): string
+ {
+ $data = '';
+ $contents = @file_get_contents($filename);
+ if ($contents !== false) {
+ if (str_starts_with($contents, "\x1f\x8b")) {
+ // Check if gzlib functions are available
+ if (function_exists('gzdecode')) {
+ $contents = @gzdecode($contents);
+ if ($contents !== false) {
+ $data = $contents;
+ }
+ }
+ } else {
+ $data = $contents;
+ }
+ }
+ if ($data !== '') {
+ $data = $this->getSecurityScannerOrThrow()->scan($data);
+ }
+
+ return $data;
+ }
+
+ public static function gnumericMappings(): array
+ {
+ return array_merge(self::$mappings, Styles::$mappings);
+ }
+
+ private function processComments(SimpleXMLElement $sheet): void
+ {
+ if ((!$this->readDataOnly) && (isset($sheet->Objects))) {
+ foreach ($sheet->Objects->children(self::NAMESPACE_GNM) as $key => $comment) {
+ $commentAttributes = $comment->attributes();
+ // Only comment objects are handled at the moment
+ if ($commentAttributes && $commentAttributes->Text) {
+ $this->spreadsheet->getActiveSheet()->getComment((string) $commentAttributes->ObjectBound)
+ ->setAuthor((string) $commentAttributes->Author)
+ ->setText($this->parseRichText((string) $commentAttributes->Text));
+ }
+ }
+ }
+ }
+
+ private static function testSimpleXml(mixed $value): SimpleXMLElement
+ {
+ return ($value instanceof SimpleXMLElement) ? $value : new SimpleXMLElement(' ');
+ }
+
+ /**
+ * Loads Spreadsheet from file.
+ */
+ protected function loadSpreadsheetFromFile(string $filename): Spreadsheet
+ {
+ // Create new Spreadsheet
+ $spreadsheet = new Spreadsheet();
+ $spreadsheet->removeSheetByIndex(0);
+
+ // Load into this instance
+ return $this->loadIntoExisting($filename, $spreadsheet);
+ }
+
+ /**
+ * Loads from file into Spreadsheet instance.
+ */
+ public function loadIntoExisting(string $filename, Spreadsheet $spreadsheet): Spreadsheet
+ {
+ $this->spreadsheet = $spreadsheet;
+ File::assertFile($filename);
+ if (!$this->canRead($filename)) {
+ throw new Exception($filename . ' is an invalid Gnumeric file.');
+ }
+
+ $gFileData = $this->gzfileGetContents($filename);
+
+ /** @var XmlScanner */
+ $securityScanner = $this->securityScanner;
+ $xml2 = simplexml_load_string($securityScanner->scan($gFileData));
+ $xml = self::testSimpleXml($xml2);
+
+ $gnmXML = $xml->children(self::NAMESPACE_GNM);
+ (new Properties($this->spreadsheet))->readProperties($xml, $gnmXML);
+
+ $worksheetID = 0;
+ foreach ($gnmXML->Sheets->Sheet as $sheetOrNull) {
+ $sheet = self::testSimpleXml($sheetOrNull);
+ $worksheetName = (string) $sheet->Name;
+ if (is_array($this->loadSheetsOnly) && !in_array($worksheetName, $this->loadSheetsOnly, true)) {
+ continue;
+ }
+
+ $maxRow = $maxCol = 0;
+
+ // Create new Worksheet
+ $this->spreadsheet->createSheet();
+ $this->spreadsheet->setActiveSheetIndex($worksheetID);
+ // Use false for $updateFormulaCellReferences to prevent adjustment of worksheet references in formula
+ // cells... during the load, all formulae should be correct, and we're simply bringing the worksheet
+ // name in line with the formula, not the reverse
+ $this->spreadsheet->getActiveSheet()->setTitle($worksheetName, false, false);
+
+ $visibility = $sheet->attributes()['Visibility'] ?? 'GNM_SHEET_VISIBILITY_VISIBLE';
+ if ((string) $visibility !== 'GNM_SHEET_VISIBILITY_VISIBLE') {
+ $this->spreadsheet->getActiveSheet()->setSheetState(Worksheet::SHEETSTATE_HIDDEN);
+ }
+
+ if (!$this->readDataOnly) {
+ (new PageSetup($this->spreadsheet))
+ ->printInformation($sheet)
+ ->sheetMargins($sheet);
+ }
+
+ foreach ($sheet->Cells->Cell as $cellOrNull) {
+ $cell = self::testSimpleXml($cellOrNull);
+ $cellAttributes = self::testSimpleXml($cell->attributes());
+ $row = (int) $cellAttributes->Row + 1;
+ $column = (int) $cellAttributes->Col;
+
+ $maxRow = max($maxRow, $row);
+ $maxCol = max($maxCol, $column);
+
+ $column = Coordinate::stringFromColumnIndex($column + 1);
+
+ // Read cell?
+ if ($this->getReadFilter() !== null) {
+ if (!$this->getReadFilter()->readCell($column, $row, $worksheetName)) {
+ continue;
+ }
+ }
+
+ $this->loadCell($cell, $worksheetName, $cellAttributes, $column, $row);
+ }
+
+ if ($sheet->Styles !== null) {
+ (new Styles($this->spreadsheet, $this->readDataOnly))->read($sheet, $maxRow, $maxCol);
+ }
+
+ $this->processComments($sheet);
+ $this->processColumnWidths($sheet, $maxCol);
+ $this->processRowHeights($sheet, $maxRow);
+ $this->processMergedCells($sheet);
+ $this->processAutofilter($sheet);
+
+ $this->setSelectedCells($sheet);
+ ++$worksheetID;
+ }
+
+ $this->processDefinedNames($gnmXML);
+
+ $this->setSelectedSheet($gnmXML);
+
+ // Return
+ return $this->spreadsheet;
+ }
+
+ private function setSelectedSheet(SimpleXMLElement $gnmXML): void
+ {
+ if (isset($gnmXML->UIData)) {
+ $attributes = self::testSimpleXml($gnmXML->UIData->attributes());
+ $selectedSheet = (int) $attributes['SelectedTab'];
+ $this->spreadsheet->setActiveSheetIndex($selectedSheet);
+ }
+ }
+
+ private function setSelectedCells(?SimpleXMLElement $sheet): void
+ {
+ if ($sheet !== null && isset($sheet->Selections)) {
+ foreach ($sheet->Selections as $selection) {
+ $startCol = (int) ($selection->StartCol ?? 0);
+ $startRow = (int) ($selection->StartRow ?? 0) + 1;
+ $endCol = (int) ($selection->EndCol ?? $startCol);
+ $endRow = (int) ($selection->endRow ?? 0) + 1;
+
+ $startColumn = Coordinate::stringFromColumnIndex($startCol + 1);
+ $endColumn = Coordinate::stringFromColumnIndex($endCol + 1);
+
+ $startCell = "{$startColumn}{$startRow}";
+ $endCell = "{$endColumn}{$endRow}";
+ $selectedRange = $startCell . (($endCell !== $startCell) ? ':' . $endCell : '');
+ $this->spreadsheet->getActiveSheet()->setSelectedCell($selectedRange);
+
+ break;
+ }
+ }
+ }
+
+ private function processMergedCells(?SimpleXMLElement $sheet): void
+ {
+ // Handle Merged Cells in this worksheet
+ if ($sheet !== null && isset($sheet->MergedRegions)) {
+ foreach ($sheet->MergedRegions->Merge as $mergeCells) {
+ if (str_contains((string) $mergeCells, ':')) {
+ $this->spreadsheet->getActiveSheet()->mergeCells($mergeCells, Worksheet::MERGE_CELL_CONTENT_HIDE);
+ }
+ }
+ }
+ }
+
+ private function processAutofilter(?SimpleXMLElement $sheet): void
+ {
+ if ($sheet !== null && isset($sheet->Filters)) {
+ foreach ($sheet->Filters->Filter as $autofilter) {
+ if ($autofilter !== null) {
+ $attributes = $autofilter->attributes();
+ if (isset($attributes['Area'])) {
+ $this->spreadsheet->getActiveSheet()->setAutoFilter((string) $attributes['Area']);
+ }
+ }
+ }
+ }
+ }
+
+ private function setColumnWidth(int $whichColumn, float $defaultWidth): void
+ {
+ $columnDimension = $this->spreadsheet->getActiveSheet()
+ ->getColumnDimension(Coordinate::stringFromColumnIndex($whichColumn + 1));
+ if ($columnDimension !== null) {
+ $columnDimension->setWidth($defaultWidth);
+ }
+ }
+
+ private function setColumnInvisible(int $whichColumn): void
+ {
+ $columnDimension = $this->spreadsheet->getActiveSheet()
+ ->getColumnDimension(Coordinate::stringFromColumnIndex($whichColumn + 1));
+ if ($columnDimension !== null) {
+ $columnDimension->setVisible(false);
+ }
+ }
+
+ private function processColumnLoop(int $whichColumn, int $maxCol, ?SimpleXMLElement $columnOverride, float $defaultWidth): int
+ {
+ $columnOverride = self::testSimpleXml($columnOverride);
+ $columnAttributes = self::testSimpleXml($columnOverride->attributes());
+ $column = $columnAttributes['No'];
+ $columnWidth = ((float) $columnAttributes['Unit']) / 5.4;
+ $hidden = (isset($columnAttributes['Hidden'])) && ((string) $columnAttributes['Hidden'] == '1');
+ $columnCount = (int) ($columnAttributes['Count'] ?? 1);
+ while ($whichColumn < $column) {
+ $this->setColumnWidth($whichColumn, $defaultWidth);
+ ++$whichColumn;
+ }
+ while (($whichColumn < ($column + $columnCount)) && ($whichColumn <= $maxCol)) {
+ $this->setColumnWidth($whichColumn, $columnWidth);
+ if ($hidden) {
+ $this->setColumnInvisible($whichColumn);
+ }
+ ++$whichColumn;
+ }
+
+ return $whichColumn;
+ }
+
+ private function processColumnWidths(?SimpleXMLElement $sheet, int $maxCol): void
+ {
+ if ((!$this->readDataOnly) && $sheet !== null && (isset($sheet->Cols))) {
+ // Column Widths
+ $defaultWidth = 0;
+ $columnAttributes = $sheet->Cols->attributes();
+ if ($columnAttributes !== null) {
+ $defaultWidth = $columnAttributes['DefaultSizePts'] / 5.4;
+ }
+ $whichColumn = 0;
+ foreach ($sheet->Cols->ColInfo as $columnOverride) {
+ $whichColumn = $this->processColumnLoop($whichColumn, $maxCol, $columnOverride, $defaultWidth);
+ }
+ while ($whichColumn <= $maxCol) {
+ $this->setColumnWidth($whichColumn, $defaultWidth);
+ ++$whichColumn;
+ }
+ }
+ }
+
+ private function setRowHeight(int $whichRow, float $defaultHeight): void
+ {
+ $rowDimension = $this->spreadsheet->getActiveSheet()->getRowDimension($whichRow);
+ if ($rowDimension !== null) {
+ $rowDimension->setRowHeight($defaultHeight);
+ }
+ }
+
+ private function setRowInvisible(int $whichRow): void
+ {
+ $rowDimension = $this->spreadsheet->getActiveSheet()->getRowDimension($whichRow);
+ if ($rowDimension !== null) {
+ $rowDimension->setVisible(false);
+ }
+ }
+
+ private function processRowLoop(int $whichRow, int $maxRow, ?SimpleXMLElement $rowOverride, float $defaultHeight): int
+ {
+ $rowOverride = self::testSimpleXml($rowOverride);
+ $rowAttributes = self::testSimpleXml($rowOverride->attributes());
+ $row = $rowAttributes['No'];
+ $rowHeight = (float) $rowAttributes['Unit'];
+ $hidden = (isset($rowAttributes['Hidden'])) && ((string) $rowAttributes['Hidden'] == '1');
+ $rowCount = (int) ($rowAttributes['Count'] ?? 1);
+ while ($whichRow < $row) {
+ ++$whichRow;
+ $this->setRowHeight($whichRow, $defaultHeight);
+ }
+ while (($whichRow < ($row + $rowCount)) && ($whichRow < $maxRow)) {
+ ++$whichRow;
+ $this->setRowHeight($whichRow, $rowHeight);
+ if ($hidden) {
+ $this->setRowInvisible($whichRow);
+ }
+ }
+
+ return $whichRow;
+ }
+
+ private function processRowHeights(?SimpleXMLElement $sheet, int $maxRow): void
+ {
+ if ((!$this->readDataOnly) && $sheet !== null && (isset($sheet->Rows))) {
+ // Row Heights
+ $defaultHeight = 0;
+ $rowAttributes = $sheet->Rows->attributes();
+ if ($rowAttributes !== null) {
+ $defaultHeight = (float) $rowAttributes['DefaultSizePts'];
+ }
+ $whichRow = 0;
+
+ foreach ($sheet->Rows->RowInfo as $rowOverride) {
+ $whichRow = $this->processRowLoop($whichRow, $maxRow, $rowOverride, $defaultHeight);
+ }
+ // never executed, I can't figure out any circumstances
+ // under which it would be executed, and, even if
+ // such exist, I'm not convinced this is needed.
+ //while ($whichRow < $maxRow) {
+ // ++$whichRow;
+ // $this->spreadsheet->getActiveSheet()->getRowDimension($whichRow)->setRowHeight($defaultHeight);
+ //}
+ }
+ }
+
+ private function processDefinedNames(?SimpleXMLElement $gnmXML): void
+ {
+ // Loop through definedNames (global named ranges)
+ if ($gnmXML !== null && isset($gnmXML->Names)) {
+ foreach ($gnmXML->Names->Name as $definedName) {
+ $name = (string) $definedName->name;
+ $value = (string) $definedName->value;
+ if (stripos($value, '#REF!') !== false || empty($value)) {
+ continue;
+ }
+
+ [$worksheetName] = Worksheet::extractSheetTitle($value, true);
+ $worksheetName = trim($worksheetName, "'");
+ $worksheet = $this->spreadsheet->getSheetByName($worksheetName);
+ // Worksheet might still be null if we're only loading selected sheets rather than the full spreadsheet
+ if ($worksheet !== null) {
+ $this->spreadsheet->addDefinedName(DefinedName::createInstance($name, $worksheet, $value));
+ }
+ }
+ }
+ }
+
+ private function parseRichText(string $is): RichText
+ {
+ $value = new RichText();
+ $value->createText($is);
+
+ return $value;
+ }
+
+ private function loadCell(
+ SimpleXMLElement $cell,
+ string $worksheetName,
+ SimpleXMLElement $cellAttributes,
+ string $column,
+ int $row
+ ): void {
+ $ValueType = $cellAttributes->ValueType;
+ $ExprID = (string) $cellAttributes->ExprID;
+ $type = DataType::TYPE_FORMULA;
+ if ($ExprID > '') {
+ if (((string) $cell) > '') {
+ $this->expressions[$ExprID] = [
+ 'column' => $cellAttributes->Col,
+ 'row' => $cellAttributes->Row,
+ 'formula' => (string) $cell,
+ ];
+ } else {
+ $expression = $this->expressions[$ExprID];
+
+ $cell = $this->referenceHelper->updateFormulaReferences(
+ $expression['formula'],
+ 'A1',
+ $cellAttributes->Col - $expression['column'],
+ $cellAttributes->Row - $expression['row'],
+ $worksheetName
+ );
+ }
+ $type = DataType::TYPE_FORMULA;
+ } else {
+ $vtype = (string) $ValueType;
+ if (array_key_exists($vtype, self::$mappings['dataType'])) {
+ $type = self::$mappings['dataType'][$vtype];
+ }
+ if ($vtype === '20') { // Boolean
+ $cell = $cell == 'TRUE';
+ }
+ }
+
+ $this->spreadsheet->getActiveSheet()->getCell($column . $row)->setValueExplicit((string) $cell, $type);
+ if (isset($cellAttributes->ValueFormat)) {
+ $this->spreadsheet->getActiveSheet()->getCell($column . $row)
+ ->getStyle()->getNumberFormat()
+ ->setFormatCode((string) $cellAttributes->ValueFormat);
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/PageSetup.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/PageSetup.php
new file mode 100644
index 00000000..f12b742f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/PageSetup.php
@@ -0,0 +1,147 @@
+spreadsheet = $spreadsheet;
+ }
+
+ public function printInformation(SimpleXMLElement $sheet): self
+ {
+ if (isset($sheet->PrintInformation, $sheet->PrintInformation[0])) {
+ $printInformation = $sheet->PrintInformation[0];
+ $setup = $this->spreadsheet->getActiveSheet()->getPageSetup();
+
+ $attributes = $printInformation->Scale->attributes();
+ if (isset($attributes['percentage'])) {
+ $setup->setScale((int) $attributes['percentage']);
+ }
+ $pageOrder = (string) $printInformation->order;
+ if ($pageOrder === 'r_then_d') {
+ $setup->setPageOrder(WorksheetPageSetup::PAGEORDER_OVER_THEN_DOWN);
+ } elseif ($pageOrder === 'd_then_r') {
+ $setup->setPageOrder(WorksheetPageSetup::PAGEORDER_DOWN_THEN_OVER);
+ }
+ $orientation = (string) $printInformation->orientation;
+ if ($orientation !== '') {
+ $setup->setOrientation($orientation);
+ }
+ $attributes = $printInformation->hcenter->attributes();
+ if (isset($attributes['value'])) {
+ $setup->setHorizontalCentered((bool) (string) $attributes['value']);
+ }
+ $attributes = $printInformation->vcenter->attributes();
+ if (isset($attributes['value'])) {
+ $setup->setVerticalCentered((bool) (string) $attributes['value']);
+ }
+ }
+
+ return $this;
+ }
+
+ public function sheetMargins(SimpleXMLElement $sheet): self
+ {
+ if (isset($sheet->PrintInformation, $sheet->PrintInformation->Margins)) {
+ $marginSet = [
+ // Default Settings
+ 'top' => 0.75,
+ 'header' => 0.3,
+ 'left' => 0.7,
+ 'right' => 0.7,
+ 'bottom' => 0.75,
+ 'footer' => 0.3,
+ ];
+
+ $marginSet = $this->buildMarginSet($sheet, $marginSet);
+ $this->adjustMargins($marginSet);
+ }
+
+ return $this;
+ }
+
+ private function buildMarginSet(SimpleXMLElement $sheet, array $marginSet): array
+ {
+ foreach ($sheet->PrintInformation->Margins->children(Gnumeric::NAMESPACE_GNM) as $key => $margin) {
+ $marginAttributes = $margin->attributes();
+ $marginSize = ($marginAttributes['Points']) ?? 72; // Default is 72pt
+ // Convert value in points to inches
+ $marginSize = PageMargins::fromPoints((float) $marginSize);
+ $marginSet[$key] = $marginSize;
+ }
+
+ return $marginSet;
+ }
+
+ private function adjustMargins(array $marginSet): void
+ {
+ foreach ($marginSet as $key => $marginSize) {
+ // Gnumeric is quirky in the way it displays the header/footer values:
+ // header is actually the sum of top and header; footer is actually the sum of bottom and footer
+ // then top is actually the header value, and bottom is actually the footer value
+ switch ($key) {
+ case 'left':
+ case 'right':
+ $this->sheetMargin($key, $marginSize);
+
+ break;
+ case 'top':
+ $this->sheetMargin($key, $marginSet['header'] ?? 0);
+
+ break;
+ case 'bottom':
+ $this->sheetMargin($key, $marginSet['footer'] ?? 0);
+
+ break;
+ case 'header':
+ $this->sheetMargin($key, ($marginSet['top'] ?? 0) - $marginSize);
+
+ break;
+ case 'footer':
+ $this->sheetMargin($key, ($marginSet['bottom'] ?? 0) - $marginSize);
+
+ break;
+ }
+ }
+ }
+
+ private function sheetMargin(string $key, float $marginSize): void
+ {
+ switch ($key) {
+ case 'top':
+ $this->spreadsheet->getActiveSheet()->getPageMargins()->setTop($marginSize);
+
+ break;
+ case 'bottom':
+ $this->spreadsheet->getActiveSheet()->getPageMargins()->setBottom($marginSize);
+
+ break;
+ case 'left':
+ $this->spreadsheet->getActiveSheet()->getPageMargins()->setLeft($marginSize);
+
+ break;
+ case 'right':
+ $this->spreadsheet->getActiveSheet()->getPageMargins()->setRight($marginSize);
+
+ break;
+ case 'header':
+ $this->spreadsheet->getActiveSheet()->getPageMargins()->setHeader($marginSize);
+
+ break;
+ case 'footer':
+ $this->spreadsheet->getActiveSheet()->getPageMargins()->setFooter($marginSize);
+
+ break;
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/Properties.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/Properties.php
new file mode 100644
index 00000000..a60b4534
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/Properties.php
@@ -0,0 +1,161 @@
+spreadsheet = $spreadsheet;
+ }
+
+ private function docPropertiesOld(SimpleXMLElement $gnmXML): void
+ {
+ $docProps = $this->spreadsheet->getProperties();
+ foreach ($gnmXML->Summary->Item as $summaryItem) {
+ $propertyName = $summaryItem->name;
+ $propertyValue = $summaryItem->{'val-string'};
+ switch ($propertyName) {
+ case 'title':
+ $docProps->setTitle(trim($propertyValue));
+
+ break;
+ case 'comments':
+ $docProps->setDescription(trim($propertyValue));
+
+ break;
+ case 'keywords':
+ $docProps->setKeywords(trim($propertyValue));
+
+ break;
+ case 'category':
+ $docProps->setCategory(trim($propertyValue));
+
+ break;
+ case 'manager':
+ $docProps->setManager(trim($propertyValue));
+
+ break;
+ case 'author':
+ $docProps->setCreator(trim($propertyValue));
+ $docProps->setLastModifiedBy(trim($propertyValue));
+
+ break;
+ case 'company':
+ $docProps->setCompany(trim($propertyValue));
+
+ break;
+ }
+ }
+ }
+
+ private function docPropertiesDC(SimpleXMLElement $officePropertyDC): void
+ {
+ $docProps = $this->spreadsheet->getProperties();
+ foreach ($officePropertyDC as $propertyName => $propertyValue) {
+ $propertyValue = trim((string) $propertyValue);
+ switch ($propertyName) {
+ case 'title':
+ $docProps->setTitle($propertyValue);
+
+ break;
+ case 'subject':
+ $docProps->setSubject($propertyValue);
+
+ break;
+ case 'creator':
+ $docProps->setCreator($propertyValue);
+ $docProps->setLastModifiedBy($propertyValue);
+
+ break;
+ case 'date':
+ $creationDate = $propertyValue;
+ $docProps->setModified($creationDate);
+
+ break;
+ case 'description':
+ $docProps->setDescription($propertyValue);
+
+ break;
+ }
+ }
+ }
+
+ private function docPropertiesMeta(SimpleXMLElement $officePropertyMeta): void
+ {
+ $docProps = $this->spreadsheet->getProperties();
+ foreach ($officePropertyMeta as $propertyName => $propertyValue) {
+ if ($propertyValue !== null) {
+ $attributes = $propertyValue->attributes(Gnumeric::NAMESPACE_META);
+ $propertyValue = trim((string) $propertyValue);
+ switch ($propertyName) {
+ case 'keyword':
+ $docProps->setKeywords($propertyValue);
+
+ break;
+ case 'initial-creator':
+ $docProps->setCreator($propertyValue);
+ $docProps->setLastModifiedBy($propertyValue);
+
+ break;
+ case 'creation-date':
+ $creationDate = $propertyValue;
+ $docProps->setCreated($creationDate);
+
+ break;
+ case 'user-defined':
+ if ($attributes) {
+ [, $attrName] = explode(':', (string) $attributes['name']);
+ $this->userDefinedProperties($attrName, $propertyValue);
+ }
+
+ break;
+ }
+ }
+ }
+ }
+
+ private function userDefinedProperties(string $attrName, string $propertyValue): void
+ {
+ $docProps = $this->spreadsheet->getProperties();
+ switch ($attrName) {
+ case 'publisher':
+ $docProps->setCompany($propertyValue);
+
+ break;
+ case 'category':
+ $docProps->setCategory($propertyValue);
+
+ break;
+ case 'manager':
+ $docProps->setManager($propertyValue);
+
+ break;
+ }
+ }
+
+ public function readProperties(SimpleXMLElement $xml, SimpleXMLElement $gnmXML): void
+ {
+ $officeXML = $xml->children(Gnumeric::NAMESPACE_OFFICE);
+ if (!empty($officeXML)) {
+ $officeDocXML = $officeXML->{'document-meta'};
+ $officeDocMetaXML = $officeDocXML->meta;
+
+ foreach ($officeDocMetaXML as $officePropertyData) {
+ $officePropertyDC = $officePropertyData->children(Gnumeric::NAMESPACE_DC);
+ $this->docPropertiesDC($officePropertyDC);
+
+ $officePropertyMeta = $officePropertyData->children(Gnumeric::NAMESPACE_META);
+ $this->docPropertiesMeta($officePropertyMeta);
+ }
+ } elseif (isset($gnmXML->Summary)) {
+ $this->docPropertiesOld($gnmXML);
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/Styles.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/Styles.php
new file mode 100644
index 00000000..f901c4a9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Gnumeric/Styles.php
@@ -0,0 +1,273 @@
+ [
+ '0' => Border::BORDER_NONE,
+ '1' => Border::BORDER_THIN,
+ '2' => Border::BORDER_MEDIUM,
+ '3' => Border::BORDER_SLANTDASHDOT,
+ '4' => Border::BORDER_DASHED,
+ '5' => Border::BORDER_THICK,
+ '6' => Border::BORDER_DOUBLE,
+ '7' => Border::BORDER_DOTTED,
+ '8' => Border::BORDER_MEDIUMDASHED,
+ '9' => Border::BORDER_DASHDOT,
+ '10' => Border::BORDER_MEDIUMDASHDOT,
+ '11' => Border::BORDER_DASHDOTDOT,
+ '12' => Border::BORDER_MEDIUMDASHDOTDOT,
+ '13' => Border::BORDER_MEDIUMDASHDOTDOT,
+ ],
+ 'fillType' => [
+ '1' => Fill::FILL_SOLID,
+ '2' => Fill::FILL_PATTERN_DARKGRAY,
+ '3' => Fill::FILL_PATTERN_MEDIUMGRAY,
+ '4' => Fill::FILL_PATTERN_LIGHTGRAY,
+ '5' => Fill::FILL_PATTERN_GRAY125,
+ '6' => Fill::FILL_PATTERN_GRAY0625,
+ '7' => Fill::FILL_PATTERN_DARKHORIZONTAL, // horizontal stripe
+ '8' => Fill::FILL_PATTERN_DARKVERTICAL, // vertical stripe
+ '9' => Fill::FILL_PATTERN_DARKDOWN, // diagonal stripe
+ '10' => Fill::FILL_PATTERN_DARKUP, // reverse diagonal stripe
+ '11' => Fill::FILL_PATTERN_DARKGRID, // diagoanl crosshatch
+ '12' => Fill::FILL_PATTERN_DARKTRELLIS, // thick diagonal crosshatch
+ '13' => Fill::FILL_PATTERN_LIGHTHORIZONTAL,
+ '14' => Fill::FILL_PATTERN_LIGHTVERTICAL,
+ '15' => Fill::FILL_PATTERN_LIGHTUP,
+ '16' => Fill::FILL_PATTERN_LIGHTDOWN,
+ '17' => Fill::FILL_PATTERN_LIGHTGRID, // thin horizontal crosshatch
+ '18' => Fill::FILL_PATTERN_LIGHTTRELLIS, // thin diagonal crosshatch
+ ],
+ 'horizontal' => [
+ '1' => Alignment::HORIZONTAL_GENERAL,
+ '2' => Alignment::HORIZONTAL_LEFT,
+ '4' => Alignment::HORIZONTAL_RIGHT,
+ '8' => Alignment::HORIZONTAL_CENTER,
+ '16' => Alignment::HORIZONTAL_CENTER_CONTINUOUS,
+ '32' => Alignment::HORIZONTAL_JUSTIFY,
+ '64' => Alignment::HORIZONTAL_CENTER_CONTINUOUS,
+ ],
+ 'underline' => [
+ '1' => Font::UNDERLINE_SINGLE,
+ '2' => Font::UNDERLINE_DOUBLE,
+ '3' => Font::UNDERLINE_SINGLEACCOUNTING,
+ '4' => Font::UNDERLINE_DOUBLEACCOUNTING,
+ ],
+ 'vertical' => [
+ '1' => Alignment::VERTICAL_TOP,
+ '2' => Alignment::VERTICAL_BOTTOM,
+ '4' => Alignment::VERTICAL_CENTER,
+ '8' => Alignment::VERTICAL_JUSTIFY,
+ ],
+ ];
+
+ public function __construct(Spreadsheet $spreadsheet, bool $readDataOnly)
+ {
+ $this->spreadsheet = $spreadsheet;
+ $this->readDataOnly = $readDataOnly;
+ }
+
+ public function read(SimpleXMLElement $sheet, int $maxRow, int $maxCol): void
+ {
+ if ($sheet->Styles->StyleRegion !== null) {
+ $this->readStyles($sheet->Styles->StyleRegion, $maxRow, $maxCol);
+ }
+ }
+
+ private function readStyles(SimpleXMLElement $styleRegion, int $maxRow, int $maxCol): void
+ {
+ foreach ($styleRegion as $style) {
+ $styleAttributes = $style->attributes();
+ if ($styleAttributes !== null && ($styleAttributes['startRow'] <= $maxRow) && ($styleAttributes['startCol'] <= $maxCol)) {
+ $cellRange = $this->readStyleRange($styleAttributes, $maxCol, $maxRow);
+
+ $styleAttributes = $style->Style->attributes();
+
+ $styleArray = [];
+ // We still set the number format mask for date/time values, even if readDataOnly is true
+ // so that we can identify whether a float is a float or a date value
+ $formatCode = $styleAttributes ? (string) $styleAttributes['Format'] : null;
+ if ($formatCode && Date::isDateTimeFormatCode($formatCode)) {
+ $styleArray['numberFormat']['formatCode'] = $formatCode;
+ }
+ if ($this->readDataOnly === false && $styleAttributes !== null) {
+ // If readDataOnly is false, we set all formatting information
+ $styleArray['numberFormat']['formatCode'] = $formatCode;
+ $styleArray = $this->readStyle($styleArray, $styleAttributes, $style);
+ }
+ $this->spreadsheet->getActiveSheet()->getStyle($cellRange)->applyFromArray($styleArray);
+ }
+ }
+ }
+
+ private function addBorderDiagonal(SimpleXMLElement $srssb, array &$styleArray): void
+ {
+ if (isset($srssb->Diagonal, $srssb->{'Rev-Diagonal'})) {
+ $styleArray['borders']['diagonal'] = self::parseBorderAttributes($srssb->Diagonal->attributes());
+ $styleArray['borders']['diagonalDirection'] = Borders::DIAGONAL_BOTH;
+ } elseif (isset($srssb->Diagonal)) {
+ $styleArray['borders']['diagonal'] = self::parseBorderAttributes($srssb->Diagonal->attributes());
+ $styleArray['borders']['diagonalDirection'] = Borders::DIAGONAL_UP;
+ } elseif (isset($srssb->{'Rev-Diagonal'})) {
+ $styleArray['borders']['diagonal'] = self::parseBorderAttributes($srssb->{'Rev-Diagonal'}->attributes());
+ $styleArray['borders']['diagonalDirection'] = Borders::DIAGONAL_DOWN;
+ }
+ }
+
+ private function addBorderStyle(SimpleXMLElement $srssb, array &$styleArray, string $direction): void
+ {
+ $ucDirection = ucfirst($direction);
+ if (isset($srssb->$ucDirection)) {
+ $styleArray['borders'][$direction] = self::parseBorderAttributes($srssb->$ucDirection->attributes());
+ }
+ }
+
+ private function calcRotation(SimpleXMLElement $styleAttributes): int
+ {
+ $rotation = (int) $styleAttributes->Rotation;
+ if ($rotation >= 270 && $rotation <= 360) {
+ $rotation -= 360;
+ }
+ $rotation = (abs($rotation) > 90) ? 0 : $rotation;
+
+ return $rotation;
+ }
+
+ private static function addStyle(array &$styleArray, string $key, string $value): void
+ {
+ if (array_key_exists($value, self::$mappings[$key])) {
+ $styleArray[$key] = self::$mappings[$key][$value];
+ }
+ }
+
+ private static function addStyle2(array &$styleArray, string $key1, string $key, string $value): void
+ {
+ if (array_key_exists($value, self::$mappings[$key])) {
+ $styleArray[$key1][$key] = self::$mappings[$key][$value];
+ }
+ }
+
+ private static function parseBorderAttributes(?SimpleXMLElement $borderAttributes): array
+ {
+ $styleArray = [];
+ if ($borderAttributes !== null) {
+ if (isset($borderAttributes['Color'])) {
+ $styleArray['color']['rgb'] = self::parseGnumericColour($borderAttributes['Color']);
+ }
+
+ self::addStyle($styleArray, 'borderStyle', (string) $borderAttributes['Style']);
+ }
+
+ return $styleArray;
+ }
+
+ private static function parseGnumericColour(string $gnmColour): string
+ {
+ [$gnmR, $gnmG, $gnmB] = explode(':', $gnmColour);
+ $gnmR = substr(str_pad($gnmR, 4, '0', STR_PAD_RIGHT), 0, 2);
+ $gnmG = substr(str_pad($gnmG, 4, '0', STR_PAD_RIGHT), 0, 2);
+ $gnmB = substr(str_pad($gnmB, 4, '0', STR_PAD_RIGHT), 0, 2);
+
+ return $gnmR . $gnmG . $gnmB;
+ }
+
+ private function addColors(array &$styleArray, SimpleXMLElement $styleAttributes): void
+ {
+ $RGB = self::parseGnumericColour((string) $styleAttributes['Fore']);
+ $styleArray['font']['color']['rgb'] = $RGB;
+ $RGB = self::parseGnumericColour((string) $styleAttributes['Back']);
+ $shade = (string) $styleAttributes['Shade'];
+ if (($RGB !== '000000') || ($shade !== '0')) {
+ $RGB2 = self::parseGnumericColour((string) $styleAttributes['PatternColor']);
+ if ($shade === '1') {
+ $styleArray['fill']['startColor']['rgb'] = $RGB;
+ $styleArray['fill']['endColor']['rgb'] = $RGB2;
+ } else {
+ $styleArray['fill']['endColor']['rgb'] = $RGB;
+ $styleArray['fill']['startColor']['rgb'] = $RGB2;
+ }
+ self::addStyle2($styleArray, 'fill', 'fillType', $shade);
+ }
+ }
+
+ private function readStyleRange(SimpleXMLElement $styleAttributes, int $maxCol, int $maxRow): string
+ {
+ $startColumn = Coordinate::stringFromColumnIndex((int) $styleAttributes['startCol'] + 1);
+ $startRow = $styleAttributes['startRow'] + 1;
+
+ $endColumn = ($styleAttributes['endCol'] > $maxCol) ? $maxCol : (int) $styleAttributes['endCol'];
+ $endColumn = Coordinate::stringFromColumnIndex($endColumn + 1);
+
+ $endRow = 1 + (($styleAttributes['endRow'] > $maxRow) ? $maxRow : (int) $styleAttributes['endRow']);
+ $cellRange = $startColumn . $startRow . ':' . $endColumn . $endRow;
+
+ return $cellRange;
+ }
+
+ private function readStyle(array $styleArray, SimpleXMLElement $styleAttributes, SimpleXMLElement $style): array
+ {
+ self::addStyle2($styleArray, 'alignment', 'horizontal', (string) $styleAttributes['HAlign']);
+ self::addStyle2($styleArray, 'alignment', 'vertical', (string) $styleAttributes['VAlign']);
+ $styleArray['alignment']['wrapText'] = $styleAttributes['WrapText'] == '1';
+ $styleArray['alignment']['textRotation'] = $this->calcRotation($styleAttributes);
+ $styleArray['alignment']['shrinkToFit'] = $styleAttributes['ShrinkToFit'] == '1';
+ $styleArray['alignment']['indent'] = ((int) ($styleAttributes['Indent']) > 0) ? $styleAttributes['indent'] : 0;
+
+ $this->addColors($styleArray, $styleAttributes);
+
+ $fontAttributes = $style->Style->Font->attributes();
+ if ($fontAttributes !== null) {
+ $styleArray['font']['name'] = (string) $style->Style->Font;
+ $styleArray['font']['size'] = (int) ($fontAttributes['Unit']);
+ $styleArray['font']['bold'] = $fontAttributes['Bold'] == '1';
+ $styleArray['font']['italic'] = $fontAttributes['Italic'] == '1';
+ $styleArray['font']['strikethrough'] = $fontAttributes['StrikeThrough'] == '1';
+ self::addStyle2($styleArray, 'font', 'underline', (string) $fontAttributes['Underline']);
+
+ switch ($fontAttributes['Script']) {
+ case '1':
+ $styleArray['font']['superscript'] = true;
+
+ break;
+ case '-1':
+ $styleArray['font']['subscript'] = true;
+
+ break;
+ }
+ }
+
+ if (isset($style->Style->StyleBorder)) {
+ $srssb = $style->Style->StyleBorder;
+ $this->addBorderStyle($srssb, $styleArray, 'top');
+ $this->addBorderStyle($srssb, $styleArray, 'bottom');
+ $this->addBorderStyle($srssb, $styleArray, 'left');
+ $this->addBorderStyle($srssb, $styleArray, 'right');
+ $this->addBorderDiagonal($srssb, $styleArray);
+ }
+ // TO DO
+ /*
+ if (isset($style->Style->HyperLink)) {
+ $hyperlink = $style->Style->HyperLink->attributes();
+ }
+ */
+
+ return $styleArray;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Html.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Html.php
new file mode 100644
index 00000000..5d141891
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Html.php
@@ -0,0 +1,1156 @@
+ [
+ 'font' => [
+ 'bold' => true,
+ 'size' => 24,
+ ],
+ ], // Bold, 24pt
+ 'h2' => [
+ 'font' => [
+ 'bold' => true,
+ 'size' => 18,
+ ],
+ ], // Bold, 18pt
+ 'h3' => [
+ 'font' => [
+ 'bold' => true,
+ 'size' => 13.5,
+ ],
+ ], // Bold, 13.5pt
+ 'h4' => [
+ 'font' => [
+ 'bold' => true,
+ 'size' => 12,
+ ],
+ ], // Bold, 12pt
+ 'h5' => [
+ 'font' => [
+ 'bold' => true,
+ 'size' => 10,
+ ],
+ ], // Bold, 10pt
+ 'h6' => [
+ 'font' => [
+ 'bold' => true,
+ 'size' => 7.5,
+ ],
+ ], // Bold, 7.5pt
+ 'a' => [
+ 'font' => [
+ 'underline' => true,
+ 'color' => [
+ 'argb' => Color::COLOR_BLUE,
+ ],
+ ],
+ ], // Blue underlined
+ 'hr' => [
+ 'borders' => [
+ 'bottom' => [
+ 'borderStyle' => Border::BORDER_THIN,
+ 'color' => [
+ Color::COLOR_BLACK,
+ ],
+ ],
+ ],
+ ], // Bottom border
+ 'strong' => [
+ 'font' => [
+ 'bold' => true,
+ ],
+ ], // Bold
+ 'b' => [
+ 'font' => [
+ 'bold' => true,
+ ],
+ ], // Bold
+ 'i' => [
+ 'font' => [
+ 'italic' => true,
+ ],
+ ], // Italic
+ 'em' => [
+ 'font' => [
+ 'italic' => true,
+ ],
+ ], // Italic
+ ];
+
+ protected array $rowspan = [];
+
+ /**
+ * Create a new HTML Reader instance.
+ */
+ public function __construct()
+ {
+ parent::__construct();
+ $this->securityScanner = XmlScanner::getInstance($this);
+ }
+
+ /**
+ * Validate that the current file is an HTML file.
+ */
+ public function canRead(string $filename): bool
+ {
+ // Check if file exists
+ try {
+ $this->openFile($filename);
+ } catch (Exception) {
+ return false;
+ }
+
+ $beginning = preg_replace(self::STARTS_WITH_BOM, '', $this->readBeginning()) ?? '';
+
+ $startWithTag = self::startsWithTag($beginning);
+ $containsTags = self::containsTags($beginning);
+ $endsWithTag = self::endsWithTag($this->readEnding());
+
+ fclose($this->fileHandle);
+
+ return $startWithTag && $containsTags && $endsWithTag;
+ }
+
+ private function readBeginning(): string
+ {
+ fseek($this->fileHandle, 0);
+
+ return (string) fread($this->fileHandle, self::TEST_SAMPLE_SIZE);
+ }
+
+ private function readEnding(): string
+ {
+ $meta = stream_get_meta_data($this->fileHandle);
+ // Phpstan incorrectly flags following line for Php8.2-, corrected in 8.3
+ $filename = $meta['uri']; //@phpstan-ignore-line
+
+ $size = (int) filesize($filename);
+ if ($size === 0) {
+ return '';
+ }
+
+ $blockSize = self::TEST_SAMPLE_SIZE;
+ if ($size < $blockSize) {
+ $blockSize = $size;
+ }
+
+ fseek($this->fileHandle, $size - $blockSize);
+
+ return (string) fread($this->fileHandle, $blockSize);
+ }
+
+ private static function startsWithTag(string $data): bool
+ {
+ return str_starts_with(trim($data), '<');
+ }
+
+ private static function endsWithTag(string $data): bool
+ {
+ return str_ends_with(trim($data), '>');
+ }
+
+ private static function containsTags(string $data): bool
+ {
+ return strlen($data) !== strlen(strip_tags($data));
+ }
+
+ /**
+ * Loads Spreadsheet from file.
+ */
+ public function loadSpreadsheetFromFile(string $filename): Spreadsheet
+ {
+ // Create new Spreadsheet
+ $spreadsheet = new Spreadsheet();
+
+ // Load into this instance
+ return $this->loadIntoExisting($filename, $spreadsheet);
+ }
+
+ // Data Array used for testing only, should write to Spreadsheet object on completion of tests
+
+ protected array $dataArray = [];
+
+ protected int $tableLevel = 0;
+
+ protected array $nestedColumn = ['A'];
+
+ protected function setTableStartColumn(string $column): string
+ {
+ if ($this->tableLevel == 0) {
+ $column = 'A';
+ }
+ ++$this->tableLevel;
+ $this->nestedColumn[$this->tableLevel] = $column;
+
+ return $this->nestedColumn[$this->tableLevel];
+ }
+
+ protected function getTableStartColumn(): string
+ {
+ return $this->nestedColumn[$this->tableLevel];
+ }
+
+ protected function releaseTableStartColumn(): string
+ {
+ --$this->tableLevel;
+
+ return array_pop($this->nestedColumn);
+ }
+
+ /**
+ * Flush cell.
+ */
+ protected function flushCell(Worksheet $sheet, string $column, int|string $row, mixed &$cellContent, array $attributeArray): void
+ {
+ if (is_string($cellContent)) {
+ // Simple String content
+ if (trim($cellContent) > '') {
+ // Only actually write it if there's content in the string
+ // Write to worksheet to be done here...
+ // ... we return the cell, so we can mess about with styles more easily
+
+ // Set cell value explicitly if there is data-type attribute
+ if (isset($attributeArray['data-type'])) {
+ $datatype = $attributeArray['data-type'];
+ if (in_array($datatype, [DataType::TYPE_STRING, DataType::TYPE_STRING2, DataType::TYPE_INLINE])) {
+ //Prevent to Excel treat string with beginning equal sign or convert big numbers to scientific number
+ if (str_starts_with($cellContent, '=')) {
+ $sheet->getCell($column . $row)
+ ->getStyle()
+ ->setQuotePrefix(true);
+ }
+ }
+
+ //catching the Exception and ignoring the invalid data types
+ try {
+ $sheet->setCellValueExplicit($column . $row, $cellContent, $attributeArray['data-type']);
+ } catch (SpreadsheetException) {
+ $sheet->setCellValue($column . $row, $cellContent);
+ }
+ } else {
+ $sheet->setCellValue($column . $row, $cellContent);
+ }
+ $this->dataArray[$row][$column] = $cellContent;
+ }
+ } else {
+ // We have a Rich Text run
+ // TODO
+ $this->dataArray[$row][$column] = 'RICH TEXT: ' . $cellContent;
+ }
+ $cellContent = (string) '';
+ }
+
+ private function processDomElementBody(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child): void
+ {
+ $attributeArray = [];
+ /** @var DOMAttr $attribute */
+ foreach ($child->attributes as $attribute) {
+ $attributeArray[$attribute->name] = $attribute->value;
+ }
+
+ if ($child->nodeName === 'body') {
+ $row = 1;
+ $column = 'A';
+ $cellContent = '';
+ $this->tableLevel = 0;
+ $this->processDomElement($child, $sheet, $row, $column, $cellContent);
+ } else {
+ $this->processDomElementTitle($sheet, $row, $column, $cellContent, $child, $attributeArray);
+ }
+ }
+
+ private function processDomElementTitle(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child, array &$attributeArray): void
+ {
+ if ($child->nodeName === 'title') {
+ $this->processDomElement($child, $sheet, $row, $column, $cellContent);
+
+ try {
+ $sheet->setTitle($cellContent, true, true);
+ } catch (SpreadsheetException) {
+ // leave default title if too long or illegal chars
+ }
+ $cellContent = '';
+ } else {
+ $this->processDomElementSpanEtc($sheet, $row, $column, $cellContent, $child, $attributeArray);
+ }
+ }
+
+ private const SPAN_ETC = ['span', 'div', 'font', 'i', 'em', 'strong', 'b'];
+
+ private function processDomElementSpanEtc(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child, array &$attributeArray): void
+ {
+ if (in_array((string) $child->nodeName, self::SPAN_ETC, true)) {
+ if (isset($attributeArray['class']) && $attributeArray['class'] === 'comment') {
+ $sheet->getComment($column . $row)
+ ->getText()
+ ->createTextRun($child->textContent);
+ if (isset($attributeArray['dir']) && $attributeArray['dir'] === 'rtl') {
+ $sheet->getComment($column . $row)->setTextboxDirection(Comment::TEXTBOX_DIRECTION_RTL);
+ }
+ if (isset($attributeArray['style'])) {
+ $alignStyle = $attributeArray['style'];
+ if (preg_match('/\\btext-align:\\s*(left|right|center|justify)\\b/', $alignStyle, $matches) === 1) {
+ $sheet->getComment($column . $row)->setAlignment($matches[1]);
+ }
+ }
+ } else {
+ $this->processDomElement($child, $sheet, $row, $column, $cellContent);
+ }
+
+ if (isset($this->formats[$child->nodeName])) {
+ $sheet->getStyle($column . $row)->applyFromArray($this->formats[$child->nodeName]);
+ }
+ } else {
+ $this->processDomElementHr($sheet, $row, $column, $cellContent, $child, $attributeArray);
+ }
+ }
+
+ private function processDomElementHr(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child, array &$attributeArray): void
+ {
+ if ($child->nodeName === 'hr') {
+ $this->flushCell($sheet, $column, $row, $cellContent, $attributeArray);
+ ++$row;
+ if (isset($this->formats[$child->nodeName])) {
+ $sheet->getStyle($column . $row)->applyFromArray($this->formats[$child->nodeName]);
+ }
+ ++$row;
+ }
+ // fall through to br
+ $this->processDomElementBr($sheet, $row, $column, $cellContent, $child, $attributeArray);
+ }
+
+ private function processDomElementBr(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child, array &$attributeArray): void
+ {
+ if ($child->nodeName === 'br' || $child->nodeName === 'hr') {
+ if ($this->tableLevel > 0) {
+ // If we're inside a table, replace with a newline and set the cell to wrap
+ $cellContent .= "\n";
+ $sheet->getStyle($column . $row)->getAlignment()->setWrapText(true);
+ } else {
+ // Otherwise flush our existing content and move the row cursor on
+ $this->flushCell($sheet, $column, $row, $cellContent, $attributeArray);
+ ++$row;
+ }
+ } else {
+ $this->processDomElementA($sheet, $row, $column, $cellContent, $child, $attributeArray);
+ }
+ }
+
+ private function processDomElementA(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child, array &$attributeArray): void
+ {
+ if ($child->nodeName === 'a') {
+ foreach ($attributeArray as $attributeName => $attributeValue) {
+ switch ($attributeName) {
+ case 'href':
+ $sheet->getCell($column . $row)->getHyperlink()->setUrl($attributeValue);
+ if (isset($this->formats[$child->nodeName])) {
+ $sheet->getStyle($column . $row)->applyFromArray($this->formats[$child->nodeName]);
+ }
+
+ break;
+ case 'class':
+ if ($attributeValue === 'comment-indicator') {
+ break; // Ignore - it's just a red square.
+ }
+ }
+ }
+ // no idea why this should be needed
+ //$cellContent .= ' ';
+ $this->processDomElement($child, $sheet, $row, $column, $cellContent);
+ } else {
+ $this->processDomElementH1Etc($sheet, $row, $column, $cellContent, $child, $attributeArray);
+ }
+ }
+
+ private const H1_ETC = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'ol', 'ul', 'p'];
+
+ private function processDomElementH1Etc(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child, array &$attributeArray): void
+ {
+ if (in_array((string) $child->nodeName, self::H1_ETC, true)) {
+ if ($this->tableLevel > 0) {
+ // If we're inside a table, replace with a newline
+ $cellContent .= $cellContent ? "\n" : '';
+ $sheet->getStyle($column . $row)->getAlignment()->setWrapText(true);
+ $this->processDomElement($child, $sheet, $row, $column, $cellContent);
+ } else {
+ if ($cellContent > '') {
+ $this->flushCell($sheet, $column, $row, $cellContent, $attributeArray);
+ ++$row;
+ }
+ $this->processDomElement($child, $sheet, $row, $column, $cellContent);
+ $this->flushCell($sheet, $column, $row, $cellContent, $attributeArray);
+
+ if (isset($this->formats[$child->nodeName])) {
+ $sheet->getStyle($column . $row)->applyFromArray($this->formats[$child->nodeName]);
+ }
+
+ ++$row;
+ $column = 'A';
+ }
+ } else {
+ $this->processDomElementLi($sheet, $row, $column, $cellContent, $child, $attributeArray);
+ }
+ }
+
+ private function processDomElementLi(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child, array &$attributeArray): void
+ {
+ if ($child->nodeName === 'li') {
+ if ($this->tableLevel > 0) {
+ // If we're inside a table, replace with a newline
+ $cellContent .= $cellContent ? "\n" : '';
+ $this->processDomElement($child, $sheet, $row, $column, $cellContent);
+ } else {
+ if ($cellContent > '') {
+ $this->flushCell($sheet, $column, $row, $cellContent, $attributeArray);
+ }
+ ++$row;
+ $this->processDomElement($child, $sheet, $row, $column, $cellContent);
+ $this->flushCell($sheet, $column, $row, $cellContent, $attributeArray);
+ $column = 'A';
+ }
+ } else {
+ $this->processDomElementImg($sheet, $row, $column, $cellContent, $child, $attributeArray);
+ }
+ }
+
+ private function processDomElementImg(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child, array &$attributeArray): void
+ {
+ if ($child->nodeName === 'img') {
+ $this->insertImage($sheet, $column, $row, $attributeArray);
+ } else {
+ $this->processDomElementTable($sheet, $row, $column, $cellContent, $child, $attributeArray);
+ }
+ }
+
+ private string $currentColumn = 'A';
+
+ private function processDomElementTable(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child, array &$attributeArray): void
+ {
+ if ($child->nodeName === 'table') {
+ $this->currentColumn = 'A';
+ $this->flushCell($sheet, $column, $row, $cellContent, $attributeArray);
+ $column = $this->setTableStartColumn($column);
+ if ($this->tableLevel > 1 && $row > 1) {
+ --$row;
+ }
+ $this->processDomElement($child, $sheet, $row, $column, $cellContent);
+ $column = $this->releaseTableStartColumn();
+ if ($this->tableLevel > 1) {
+ ++$column;
+ } else {
+ ++$row;
+ }
+ } else {
+ $this->processDomElementTr($sheet, $row, $column, $cellContent, $child, $attributeArray);
+ }
+ }
+
+ private function processDomElementTr(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child, array &$attributeArray): void
+ {
+ if ($child->nodeName === 'col') {
+ $this->applyInlineStyle($sheet, -1, $this->currentColumn, $attributeArray);
+ ++$this->currentColumn;
+ } elseif ($child->nodeName === 'tr') {
+ $column = $this->getTableStartColumn();
+ $cellContent = '';
+ $this->processDomElement($child, $sheet, $row, $column, $cellContent);
+
+ if (isset($attributeArray['height'])) {
+ $sheet->getRowDimension($row)->setRowHeight($attributeArray['height']);
+ }
+
+ ++$row;
+ } else {
+ $this->processDomElementThTdOther($sheet, $row, $column, $cellContent, $child, $attributeArray);
+ }
+ }
+
+ private function processDomElementThTdOther(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child, array &$attributeArray): void
+ {
+ if ($child->nodeName !== 'td' && $child->nodeName !== 'th') {
+ $this->processDomElement($child, $sheet, $row, $column, $cellContent);
+ } else {
+ $this->processDomElementThTd($sheet, $row, $column, $cellContent, $child, $attributeArray);
+ }
+ }
+
+ private function processDomElementBgcolor(Worksheet $sheet, int $row, string $column, array $attributeArray): void
+ {
+ if (isset($attributeArray['bgcolor'])) {
+ $sheet->getStyle("$column$row")->applyFromArray(
+ [
+ 'fill' => [
+ 'fillType' => Fill::FILL_SOLID,
+ 'color' => ['rgb' => $this->getStyleColor($attributeArray['bgcolor'])],
+ ],
+ ]
+ );
+ }
+ }
+
+ private function processDomElementWidth(Worksheet $sheet, string $column, array $attributeArray): void
+ {
+ if (isset($attributeArray['width'])) {
+ $sheet->getColumnDimension($column)->setWidth((new CssDimension($attributeArray['width']))->width());
+ }
+ }
+
+ private function processDomElementHeight(Worksheet $sheet, int $row, array $attributeArray): void
+ {
+ if (isset($attributeArray['height'])) {
+ $sheet->getRowDimension($row)->setRowHeight((new CssDimension($attributeArray['height']))->height());
+ }
+ }
+
+ private function processDomElementAlign(Worksheet $sheet, int $row, string $column, array $attributeArray): void
+ {
+ if (isset($attributeArray['align'])) {
+ $sheet->getStyle($column . $row)->getAlignment()->setHorizontal($attributeArray['align']);
+ }
+ }
+
+ private function processDomElementVAlign(Worksheet $sheet, int $row, string $column, array $attributeArray): void
+ {
+ if (isset($attributeArray['valign'])) {
+ $sheet->getStyle($column . $row)->getAlignment()->setVertical($attributeArray['valign']);
+ }
+ }
+
+ private function processDomElementDataFormat(Worksheet $sheet, int $row, string $column, array $attributeArray): void
+ {
+ if (isset($attributeArray['data-format'])) {
+ $sheet->getStyle($column . $row)->getNumberFormat()->setFormatCode($attributeArray['data-format']);
+ }
+ }
+
+ private function processDomElementThTd(Worksheet $sheet, int &$row, string &$column, string &$cellContent, DOMElement $child, array &$attributeArray): void
+ {
+ while (isset($this->rowspan[$column . $row])) {
+ ++$column;
+ }
+ $this->processDomElement($child, $sheet, $row, $column, $cellContent);
+
+ // apply inline style
+ $this->applyInlineStyle($sheet, $row, $column, $attributeArray);
+
+ $this->flushCell($sheet, $column, $row, $cellContent, $attributeArray);
+
+ $this->processDomElementBgcolor($sheet, $row, $column, $attributeArray);
+ $this->processDomElementWidth($sheet, $column, $attributeArray);
+ $this->processDomElementHeight($sheet, $row, $attributeArray);
+ $this->processDomElementAlign($sheet, $row, $column, $attributeArray);
+ $this->processDomElementVAlign($sheet, $row, $column, $attributeArray);
+ $this->processDomElementDataFormat($sheet, $row, $column, $attributeArray);
+
+ if (isset($attributeArray['rowspan'], $attributeArray['colspan'])) {
+ //create merging rowspan and colspan
+ $columnTo = $column;
+ for ($i = 0; $i < (int) $attributeArray['colspan'] - 1; ++$i) {
+ ++$columnTo;
+ }
+ $range = $column . $row . ':' . $columnTo . ($row + (int) $attributeArray['rowspan'] - 1);
+ foreach (Coordinate::extractAllCellReferencesInRange($range) as $value) {
+ $this->rowspan[$value] = true;
+ }
+ $sheet->mergeCells($range);
+ $column = $columnTo;
+ } elseif (isset($attributeArray['rowspan'])) {
+ //create merging rowspan
+ $range = $column . $row . ':' . $column . ($row + (int) $attributeArray['rowspan'] - 1);
+ foreach (Coordinate::extractAllCellReferencesInRange($range) as $value) {
+ $this->rowspan[$value] = true;
+ }
+ $sheet->mergeCells($range);
+ } elseif (isset($attributeArray['colspan'])) {
+ //create merging colspan
+ $columnTo = $column;
+ for ($i = 0; $i < (int) $attributeArray['colspan'] - 1; ++$i) {
+ ++$columnTo;
+ }
+ $sheet->mergeCells($column . $row . ':' . $columnTo . $row);
+ $column = $columnTo;
+ }
+
+ ++$column;
+ }
+
+ protected function processDomElement(DOMNode $element, Worksheet $sheet, int &$row, string &$column, string &$cellContent): void
+ {
+ foreach ($element->childNodes as $child) {
+ if ($child instanceof DOMText) {
+ $domText = (string) preg_replace('/\s+/', ' ', trim($child->nodeValue ?? ''));
+ if ($domText === "\u{a0}") {
+ $domText = '';
+ }
+ if (is_string($cellContent)) {
+ // simply append the text if the cell content is a plain text string
+ $cellContent .= $domText;
+ }
+ // but if we have a rich text run instead, we need to append it correctly
+ // TODO
+ } elseif ($child instanceof DOMElement) {
+ $this->processDomElementBody($sheet, $row, $column, $cellContent, $child);
+ }
+ }
+ }
+
+ /**
+ * Loads PhpSpreadsheet from file into PhpSpreadsheet instance.
+ */
+ public function loadIntoExisting(string $filename, Spreadsheet $spreadsheet): Spreadsheet
+ {
+ // Validate
+ if (!$this->canRead($filename)) {
+ throw new Exception($filename . ' is an Invalid HTML file.');
+ }
+
+ // Create a new DOM object
+ $dom = new DOMDocument();
+
+ // Reload the HTML file into the DOM object
+ try {
+ $convert = $this->getSecurityScannerOrThrow()->scanFile($filename);
+ $convert = self::replaceNonAsciiIfNeeded($convert);
+ $loaded = ($convert === null) ? false : $dom->loadHTML($convert);
+ } catch (Throwable $e) {
+ $loaded = false;
+ }
+ if ($loaded === false) {
+ throw new Exception('Failed to load ' . $filename . ' as a DOM Document', 0, $e ?? null);
+ }
+ self::loadProperties($dom, $spreadsheet);
+
+ return $this->loadDocument($dom, $spreadsheet);
+ }
+
+ private static function loadProperties(DOMDocument $dom, Spreadsheet $spreadsheet): void
+ {
+ $properties = $spreadsheet->getProperties();
+ foreach ($dom->getElementsByTagName('meta') as $meta) {
+ $metaContent = (string) $meta->getAttribute('content');
+ if ($metaContent !== '') {
+ $metaName = (string) $meta->getAttribute('name');
+ switch ($metaName) {
+ case 'author':
+ $properties->setCreator($metaContent);
+
+ break;
+ case 'category':
+ $properties->setCategory($metaContent);
+
+ break;
+ case 'company':
+ $properties->setCompany($metaContent);
+
+ break;
+ case 'created':
+ $properties->setCreated($metaContent);
+
+ break;
+ case 'description':
+ $properties->setDescription($metaContent);
+
+ break;
+ case 'keywords':
+ $properties->setKeywords($metaContent);
+
+ break;
+ case 'lastModifiedBy':
+ $properties->setLastModifiedBy($metaContent);
+
+ break;
+ case 'manager':
+ $properties->setManager($metaContent);
+
+ break;
+ case 'modified':
+ $properties->setModified($metaContent);
+
+ break;
+ case 'subject':
+ $properties->setSubject($metaContent);
+
+ break;
+ case 'title':
+ $properties->setTitle($metaContent);
+
+ break;
+ case 'viewport':
+ $properties->setViewport($metaContent);
+
+ break;
+ default:
+ if (preg_match('/^custom[.](bool|date|float|int|string)[.](.+)$/', $metaName, $matches) === 1) {
+ match ($matches[1]) {
+ 'bool' => $properties->setCustomProperty($matches[2], (bool) $metaContent, Properties::PROPERTY_TYPE_BOOLEAN),
+ 'float' => $properties->setCustomProperty($matches[2], (float) $metaContent, Properties::PROPERTY_TYPE_FLOAT),
+ 'int' => $properties->setCustomProperty($matches[2], (int) $metaContent, Properties::PROPERTY_TYPE_INTEGER),
+ 'date' => $properties->setCustomProperty($matches[2], $metaContent, Properties::PROPERTY_TYPE_DATE),
+ // string
+ default => $properties->setCustomProperty($matches[2], $metaContent, Properties::PROPERTY_TYPE_STRING),
+ };
+ }
+ }
+ }
+ }
+ if (!empty($dom->baseURI)) {
+ $properties->setHyperlinkBase($dom->baseURI);
+ }
+ }
+
+ private static function replaceNonAscii(array $matches): string
+ {
+ return '' . mb_ord($matches[0], 'UTF-8') . ';';
+ }
+
+ private static function replaceNonAsciiIfNeeded(string $convert): ?string
+ {
+ if (preg_match(self::STARTS_WITH_BOM, $convert) !== 1 && preg_match(self::DECLARES_CHARSET, $convert) !== 1) {
+ $lowend = "\u{80}";
+ $highend = "\u{10ffff}";
+ $regexp = "/[$lowend-$highend]/u";
+ /** @var callable $callback */
+ $callback = [self::class, 'replaceNonAscii'];
+ $convert = preg_replace_callback($regexp, $callback, $convert);
+ }
+
+ return $convert;
+ }
+
+ /**
+ * Spreadsheet from content.
+ */
+ public function loadFromString(string $content, ?Spreadsheet $spreadsheet = null): Spreadsheet
+ {
+ // Create a new DOM object
+ $dom = new DOMDocument();
+
+ // Reload the HTML file into the DOM object
+ try {
+ $convert = $this->getSecurityScannerOrThrow()->scan($content);
+ $convert = self::replaceNonAsciiIfNeeded($convert);
+ $loaded = ($convert === null) ? false : $dom->loadHTML($convert);
+ } catch (Throwable $e) {
+ $loaded = false;
+ }
+ if ($loaded === false) {
+ throw new Exception('Failed to load content as a DOM Document', 0, $e ?? null);
+ }
+ $spreadsheet = $spreadsheet ?? new Spreadsheet();
+ self::loadProperties($dom, $spreadsheet);
+
+ return $this->loadDocument($dom, $spreadsheet);
+ }
+
+ /**
+ * Loads PhpSpreadsheet from DOMDocument into PhpSpreadsheet instance.
+ */
+ private function loadDocument(DOMDocument $document, Spreadsheet $spreadsheet): Spreadsheet
+ {
+ while ($spreadsheet->getSheetCount() <= $this->sheetIndex) {
+ $spreadsheet->createSheet();
+ }
+ $spreadsheet->setActiveSheetIndex($this->sheetIndex);
+
+ // Discard white space
+ $document->preserveWhiteSpace = false;
+
+ $row = 0;
+ $column = 'A';
+ $content = '';
+ $this->rowspan = [];
+ $this->processDomElement($document, $spreadsheet->getActiveSheet(), $row, $column, $content);
+
+ // Return
+ return $spreadsheet;
+ }
+
+ /**
+ * Get sheet index.
+ */
+ public function getSheetIndex(): int
+ {
+ return $this->sheetIndex;
+ }
+
+ /**
+ * Set sheet index.
+ *
+ * @param int $sheetIndex Sheet index
+ *
+ * @return $this
+ */
+ public function setSheetIndex(int $sheetIndex): static
+ {
+ $this->sheetIndex = $sheetIndex;
+
+ return $this;
+ }
+
+ /**
+ * Apply inline css inline style.
+ *
+ * NOTES :
+ * Currently only intended for td & th element,
+ * and only takes 'background-color' and 'color'; property with HEX color
+ *
+ * TODO :
+ * - Implement to other propertie, such as border
+ */
+ private function applyInlineStyle(Worksheet &$sheet, int $row, string $column, array $attributeArray): void
+ {
+ if (!isset($attributeArray['style'])) {
+ return;
+ }
+
+ if ($row <= 0 || $column === '') {
+ $cellStyle = new Style();
+ } elseif (isset($attributeArray['rowspan'], $attributeArray['colspan'])) {
+ $columnTo = $column;
+ for ($i = 0; $i < (int) $attributeArray['colspan'] - 1; ++$i) {
+ ++$columnTo;
+ }
+ $range = $column . $row . ':' . $columnTo . ($row + (int) $attributeArray['rowspan'] - 1);
+ $cellStyle = $sheet->getStyle($range);
+ } elseif (isset($attributeArray['rowspan'])) {
+ $range = $column . $row . ':' . $column . ($row + (int) $attributeArray['rowspan'] - 1);
+ $cellStyle = $sheet->getStyle($range);
+ } elseif (isset($attributeArray['colspan'])) {
+ $columnTo = $column;
+ for ($i = 0; $i < (int) $attributeArray['colspan'] - 1; ++$i) {
+ ++$columnTo;
+ }
+ $range = $column . $row . ':' . $columnTo . $row;
+ $cellStyle = $sheet->getStyle($range);
+ } else {
+ $cellStyle = $sheet->getStyle($column . $row);
+ }
+
+ // add color styles (background & text) from dom element,currently support : td & th, using ONLY inline css style with RGB color
+ $styles = explode(';', $attributeArray['style']);
+ foreach ($styles as $st) {
+ $value = explode(':', $st);
+ $styleName = isset($value[0]) ? trim($value[0]) : null;
+ $styleValue = isset($value[1]) ? trim($value[1]) : null;
+ $styleValueString = (string) $styleValue;
+
+ if (!$styleName) {
+ continue;
+ }
+
+ switch ($styleName) {
+ case 'background':
+ case 'background-color':
+ $styleColor = $this->getStyleColor($styleValueString);
+
+ if (!$styleColor) {
+ continue 2;
+ }
+
+ $cellStyle->applyFromArray(['fill' => ['fillType' => Fill::FILL_SOLID, 'color' => ['rgb' => $styleColor]]]);
+
+ break;
+ case 'color':
+ $styleColor = $this->getStyleColor($styleValueString);
+
+ if (!$styleColor) {
+ continue 2;
+ }
+
+ $cellStyle->applyFromArray(['font' => ['color' => ['rgb' => $styleColor]]]);
+
+ break;
+
+ case 'border':
+ $this->setBorderStyle($cellStyle, $styleValueString, 'allBorders');
+
+ break;
+
+ case 'border-top':
+ $this->setBorderStyle($cellStyle, $styleValueString, 'top');
+
+ break;
+
+ case 'border-bottom':
+ $this->setBorderStyle($cellStyle, $styleValueString, 'bottom');
+
+ break;
+
+ case 'border-left':
+ $this->setBorderStyle($cellStyle, $styleValueString, 'left');
+
+ break;
+
+ case 'border-right':
+ $this->setBorderStyle($cellStyle, $styleValueString, 'right');
+
+ break;
+
+ case 'font-size':
+ $cellStyle->getFont()->setSize(
+ (float) $styleValue
+ );
+
+ break;
+
+ case 'font-weight':
+ if ($styleValue === 'bold' || $styleValue >= 500) {
+ $cellStyle->getFont()->setBold(true);
+ }
+
+ break;
+
+ case 'font-style':
+ if ($styleValue === 'italic') {
+ $cellStyle->getFont()->setItalic(true);
+ }
+
+ break;
+
+ case 'font-family':
+ $cellStyle->getFont()->setName(str_replace('\'', '', $styleValueString));
+
+ break;
+
+ case 'text-decoration':
+ switch ($styleValue) {
+ case 'underline':
+ $cellStyle->getFont()->setUnderline(Font::UNDERLINE_SINGLE);
+
+ break;
+ case 'line-through':
+ $cellStyle->getFont()->setStrikethrough(true);
+
+ break;
+ }
+
+ break;
+
+ case 'text-align':
+ $cellStyle->getAlignment()->setHorizontal($styleValueString);
+
+ break;
+
+ case 'vertical-align':
+ $cellStyle->getAlignment()->setVertical($styleValueString);
+
+ break;
+
+ case 'width':
+ if ($column !== '') {
+ $sheet->getColumnDimension($column)->setWidth(
+ (new CssDimension($styleValue ?? ''))->width()
+ );
+ }
+
+ break;
+
+ case 'height':
+ if ($row > 0) {
+ $sheet->getRowDimension($row)->setRowHeight(
+ (new CssDimension($styleValue ?? ''))->height()
+ );
+ }
+
+ break;
+
+ case 'word-wrap':
+ $cellStyle->getAlignment()->setWrapText(
+ $styleValue === 'break-word'
+ );
+
+ break;
+
+ case 'text-indent':
+ $cellStyle->getAlignment()->setIndent(
+ (int) str_replace(['px'], '', $styleValueString)
+ );
+
+ break;
+ }
+ }
+ }
+
+ /**
+ * Check if has #, so we can get clean hex.
+ */
+ public function getStyleColor(?string $value): string
+ {
+ $value = (string) $value;
+ if (str_starts_with($value, '#')) {
+ return substr($value, 1);
+ }
+
+ return HelperHtml::colourNameLookup($value);
+ }
+
+ private function insertImage(Worksheet $sheet, string $column, int $row, array $attributes): void
+ {
+ if (!isset($attributes['src'])) {
+ return;
+ }
+
+ $src = urldecode($attributes['src']);
+ $width = isset($attributes['width']) ? (float) $attributes['width'] : null;
+ $height = isset($attributes['height']) ? (float) $attributes['height'] : null;
+ $name = $attributes['alt'] ?? null;
+
+ $drawing = new Drawing();
+ $drawing->setPath($src, false);
+ if ($drawing->getPath() === '') {
+ return;
+ }
+ $drawing->setWorksheet($sheet);
+ $drawing->setCoordinates($column . $row);
+ $drawing->setOffsetX(0);
+ $drawing->setOffsetY(10);
+ $drawing->setResizeProportional(true);
+
+ if ($name) {
+ $drawing->setName($name);
+ }
+
+ if ($width) {
+ $drawing->setWidth((int) $width);
+ }
+
+ if ($height) {
+ $drawing->setHeight((int) $height);
+ }
+
+ $sheet->getColumnDimension($column)->setWidth(
+ $drawing->getWidth() / 6
+ );
+
+ $sheet->getRowDimension($row)->setRowHeight(
+ $drawing->getHeight() * 0.9
+ );
+ }
+
+ private const BORDER_MAPPINGS = [
+ 'dash-dot' => Border::BORDER_DASHDOT,
+ 'dash-dot-dot' => Border::BORDER_DASHDOTDOT,
+ 'dashed' => Border::BORDER_DASHED,
+ 'dotted' => Border::BORDER_DOTTED,
+ 'double' => Border::BORDER_DOUBLE,
+ 'hair' => Border::BORDER_HAIR,
+ 'medium' => Border::BORDER_MEDIUM,
+ 'medium-dashed' => Border::BORDER_MEDIUMDASHED,
+ 'medium-dash-dot' => Border::BORDER_MEDIUMDASHDOT,
+ 'medium-dash-dot-dot' => Border::BORDER_MEDIUMDASHDOTDOT,
+ 'none' => Border::BORDER_NONE,
+ 'slant-dash-dot' => Border::BORDER_SLANTDASHDOT,
+ 'solid' => Border::BORDER_THIN,
+ 'thick' => Border::BORDER_THICK,
+ ];
+
+ public static function getBorderMappings(): array
+ {
+ return self::BORDER_MAPPINGS;
+ }
+
+ /**
+ * Map html border style to PhpSpreadsheet border style.
+ */
+ public function getBorderStyle(string $style): ?string
+ {
+ return self::BORDER_MAPPINGS[$style] ?? null;
+ }
+
+ private function setBorderStyle(Style $cellStyle, string $styleValue, string $type): void
+ {
+ if (trim($styleValue) === Border::BORDER_NONE) {
+ $borderStyle = Border::BORDER_NONE;
+ $color = null;
+ } else {
+ $borderArray = explode(' ', $styleValue);
+ $borderCount = count($borderArray);
+ if ($borderCount >= 3) {
+ $borderStyle = $borderArray[1];
+ $color = $borderArray[2];
+ } else {
+ $borderStyle = $borderArray[0];
+ $color = $borderArray[1] ?? null;
+ }
+ }
+
+ $cellStyle->applyFromArray([
+ 'borders' => [
+ $type => [
+ 'borderStyle' => $this->getBorderStyle($borderStyle),
+ 'color' => ['rgb' => $this->getStyleColor($color)],
+ ],
+ ],
+ ]);
+ }
+
+ /**
+ * Return worksheet info (Name, Last Column Letter, Last Column Index, Total Rows, Total Columns).
+ */
+ public function listWorksheetInfo(string $filename): array
+ {
+ $info = [];
+ $spreadsheet = new Spreadsheet();
+ $this->loadIntoExisting($filename, $spreadsheet);
+ foreach ($spreadsheet->getAllSheets() as $sheet) {
+ $newEntry = ['worksheetName' => $sheet->getTitle()];
+ $newEntry['lastColumnLetter'] = $sheet->getHighestDataColumn();
+ $newEntry['lastColumnIndex'] = Coordinate::columnIndexFromString($sheet->getHighestDataColumn()) - 1;
+ $newEntry['totalRows'] = $sheet->getHighestDataRow();
+ $newEntry['totalColumns'] = $newEntry['lastColumnIndex'] + 1;
+ $info[] = $newEntry;
+ }
+ $spreadsheet->disconnectWorksheets();
+
+ return $info;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/IReadFilter.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/IReadFilter.php
new file mode 100644
index 00000000..1fd12e56
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/IReadFilter.php
@@ -0,0 +1,15 @@
+securityScanner = XmlScanner::getInstance($this);
+ }
+
+ /**
+ * Can the current IReader read the file?
+ */
+ public function canRead(string $filename): bool
+ {
+ $mimeType = 'UNKNOWN';
+
+ // Load file
+
+ if (File::testFileNoThrow($filename, '')) {
+ $zip = new ZipArchive();
+ if ($zip->open($filename) === true) {
+ // check if it is an OOXML archive
+ $stat = $zip->statName('mimetype');
+ if (!empty($stat) && ($stat['size'] <= 255)) {
+ $mimeType = $zip->getFromName($stat['name']);
+ } elseif ($zip->statName('META-INF/manifest.xml')) {
+ $xml = simplexml_load_string(
+ $this->getSecurityScannerOrThrow()
+ ->scan(
+ $zip->getFromName(
+ 'META-INF/manifest.xml'
+ )
+ )
+ );
+ if ($xml !== false) {
+ $namespacesContent = $xml->getNamespaces(true);
+ if (isset($namespacesContent['manifest'])) {
+ $manifest = $xml->children($namespacesContent['manifest']);
+ foreach ($manifest as $manifestDataSet) {
+ $manifestAttributes = $manifestDataSet->attributes($namespacesContent['manifest']);
+ if ($manifestAttributes && $manifestAttributes->{'full-path'} == '/') {
+ $mimeType = (string) $manifestAttributes->{'media-type'};
+
+ break;
+ }
+ }
+ }
+ }
+ }
+
+ $zip->close();
+ }
+ }
+
+ return $mimeType === 'application/vnd.oasis.opendocument.spreadsheet';
+ }
+
+ /**
+ * Reads names of the worksheets from a file, without parsing the whole file to a PhpSpreadsheet object.
+ *
+ * @return string[]
+ */
+ public function listWorksheetNames(string $filename): array
+ {
+ File::assertFile($filename, self::INITIAL_FILE);
+
+ $worksheetNames = [];
+
+ $xml = new XMLReader();
+ $xml->xml(
+ $this->getSecurityScannerOrThrow()
+ ->scanFile('zip://' . realpath($filename) . '#' . self::INITIAL_FILE)
+ );
+ $xml->setParserProperty(2, true);
+
+ // Step into the first level of content of the XML
+ $xml->read();
+ while ($xml->read()) {
+ // Quickly jump through to the office:body node
+ while (self::getXmlName($xml) !== 'office:body') {
+ if ($xml->isEmptyElement) {
+ $xml->read();
+ } else {
+ $xml->next();
+ }
+ }
+ // Now read each node until we find our first table:table node
+ while ($xml->read()) {
+ $xmlName = self::getXmlName($xml);
+ if ($xmlName == 'table:table' && $xml->nodeType == XMLReader::ELEMENT) {
+ // Loop through each table:table node reading the table:name attribute for each worksheet name
+ do {
+ $worksheetName = $xml->getAttribute('table:name');
+ if (!empty($worksheetName)) {
+ $worksheetNames[] = $worksheetName;
+ }
+ $xml->next();
+ } while (self::getXmlName($xml) == 'table:table' && $xml->nodeType == XMLReader::ELEMENT);
+ }
+ }
+ }
+
+ return $worksheetNames;
+ }
+
+ /**
+ * Return worksheet info (Name, Last Column Letter, Last Column Index, Total Rows, Total Columns).
+ */
+ public function listWorksheetInfo(string $filename): array
+ {
+ File::assertFile($filename, self::INITIAL_FILE);
+
+ $worksheetInfo = [];
+
+ $xml = new XMLReader();
+ $xml->xml(
+ $this->getSecurityScannerOrThrow()
+ ->scanFile('zip://' . realpath($filename) . '#' . self::INITIAL_FILE)
+ );
+ $xml->setParserProperty(2, true);
+
+ // Step into the first level of content of the XML
+ $xml->read();
+ while ($xml->read()) {
+ // Quickly jump through to the office:body node
+ while (self::getXmlName($xml) !== 'office:body') {
+ if ($xml->isEmptyElement) {
+ $xml->read();
+ } else {
+ $xml->next();
+ }
+ }
+ // Now read each node until we find our first table:table node
+ while ($xml->read()) {
+ if (self::getXmlName($xml) == 'table:table' && $xml->nodeType == XMLReader::ELEMENT) {
+ $worksheetNames[] = $xml->getAttribute('table:name');
+
+ $tmpInfo = [
+ 'worksheetName' => $xml->getAttribute('table:name'),
+ 'lastColumnLetter' => 'A',
+ 'lastColumnIndex' => 0,
+ 'totalRows' => 0,
+ 'totalColumns' => 0,
+ ];
+
+ // Loop through each child node of the table:table element reading
+ $currCells = 0;
+ do {
+ $xml->read();
+ if (self::getXmlName($xml) == 'table:table-row' && $xml->nodeType == XMLReader::ELEMENT) {
+ $rowspan = $xml->getAttribute('table:number-rows-repeated');
+ $rowspan = empty($rowspan) ? 1 : $rowspan;
+ $tmpInfo['totalRows'] += $rowspan;
+ $tmpInfo['totalColumns'] = max($tmpInfo['totalColumns'], $currCells);
+ $currCells = 0;
+ // Step into the row
+ $xml->read();
+ do {
+ $doread = true;
+ if (self::getXmlName($xml) == 'table:table-cell' && $xml->nodeType == XMLReader::ELEMENT) {
+ if (!$xml->isEmptyElement) {
+ ++$currCells;
+ $xml->next();
+ $doread = false;
+ }
+ } elseif (self::getXmlName($xml) == 'table:covered-table-cell' && $xml->nodeType == XMLReader::ELEMENT) {
+ $mergeSize = $xml->getAttribute('table:number-columns-repeated');
+ $currCells += (int) $mergeSize;
+ }
+ if ($doread) {
+ $xml->read();
+ }
+ } while (self::getXmlName($xml) != 'table:table-row');
+ }
+ } while (self::getXmlName($xml) != 'table:table');
+
+ $tmpInfo['totalColumns'] = max($tmpInfo['totalColumns'], $currCells);
+ $tmpInfo['lastColumnIndex'] = $tmpInfo['totalColumns'] - 1;
+ $tmpInfo['lastColumnLetter'] = Coordinate::stringFromColumnIndex($tmpInfo['lastColumnIndex'] + 1);
+ $worksheetInfo[] = $tmpInfo;
+ }
+ }
+ }
+
+ return $worksheetInfo;
+ }
+
+ /**
+ * Counteract Phpstan caching.
+ *
+ * @phpstan-impure
+ */
+ private static function getXmlName(XMLReader $xml): string
+ {
+ return $xml->name;
+ }
+
+ /**
+ * Loads PhpSpreadsheet from file.
+ */
+ protected function loadSpreadsheetFromFile(string $filename): Spreadsheet
+ {
+ // Create new Spreadsheet
+ $spreadsheet = new Spreadsheet();
+ $spreadsheet->removeSheetByIndex(0);
+
+ // Load into this instance
+ return $this->loadIntoExisting($filename, $spreadsheet);
+ }
+
+ /**
+ * Loads PhpSpreadsheet from file into PhpSpreadsheet instance.
+ */
+ public function loadIntoExisting(string $filename, Spreadsheet $spreadsheet): Spreadsheet
+ {
+ File::assertFile($filename, self::INITIAL_FILE);
+
+ $zip = new ZipArchive();
+ $zip->open($filename);
+
+ // Meta
+
+ $xml = @simplexml_load_string(
+ $this->getSecurityScannerOrThrow()
+ ->scan($zip->getFromName('meta.xml'))
+ );
+ if ($xml === false) {
+ throw new Exception('Unable to read data from {$pFilename}');
+ }
+
+ $namespacesMeta = $xml->getNamespaces(true);
+
+ (new DocumentProperties($spreadsheet))->load($xml, $namespacesMeta);
+
+ // Styles
+
+ $dom = new DOMDocument('1.01', 'UTF-8');
+ $dom->loadXML(
+ $this->getSecurityScannerOrThrow()
+ ->scan($zip->getFromName('styles.xml'))
+ );
+
+ $pageSettings = new PageSettings($dom);
+
+ // Main Content
+
+ $dom = new DOMDocument('1.01', 'UTF-8');
+ $dom->loadXML(
+ $this->getSecurityScannerOrThrow()
+ ->scan($zip->getFromName(self::INITIAL_FILE))
+ );
+
+ $officeNs = (string) $dom->lookupNamespaceUri('office');
+ $tableNs = (string) $dom->lookupNamespaceUri('table');
+ $textNs = (string) $dom->lookupNamespaceUri('text');
+ $xlinkNs = (string) $dom->lookupNamespaceUri('xlink');
+ $styleNs = (string) $dom->lookupNamespaceUri('style');
+
+ $pageSettings->readStyleCrossReferences($dom);
+
+ $autoFilterReader = new AutoFilter($spreadsheet, $tableNs);
+ $definedNameReader = new DefinedNames($spreadsheet, $tableNs);
+ $columnWidths = [];
+ $automaticStyle0 = $dom->getElementsByTagNameNS($officeNs, 'automatic-styles')->item(0);
+ $automaticStyles = ($automaticStyle0 === null) ? [] : $automaticStyle0->getElementsByTagNameNS($styleNs, 'style');
+ foreach ($automaticStyles as $automaticStyle) {
+ $styleName = $automaticStyle->getAttributeNS($styleNs, 'name');
+ $styleFamily = $automaticStyle->getAttributeNS($styleNs, 'family');
+ if ($styleFamily === 'table-column') {
+ $tcprops = $automaticStyle->getElementsByTagNameNS($styleNs, 'table-column-properties');
+ if ($tcprops !== null) {
+ $tcprop = $tcprops->item(0);
+ if ($tcprop !== null) {
+ $columnWidth = $tcprop->getAttributeNs($styleNs, 'column-width');
+ $columnWidths[$styleName] = $columnWidth;
+ }
+ }
+ }
+ }
+
+ // Content
+ $item0 = $dom->getElementsByTagNameNS($officeNs, 'body')->item(0);
+ $spreadsheets = ($item0 === null) ? [] : $item0->getElementsByTagNameNS($officeNs, 'spreadsheet');
+
+ foreach ($spreadsheets as $workbookData) {
+ /** @var DOMElement $workbookData */
+ $tables = $workbookData->getElementsByTagNameNS($tableNs, 'table');
+
+ $worksheetID = 0;
+ foreach ($tables as $worksheetDataSet) {
+ /** @var DOMElement $worksheetDataSet */
+ $worksheetName = $worksheetDataSet->getAttributeNS($tableNs, 'name');
+
+ // Check loadSheetsOnly
+ if (
+ $this->loadSheetsOnly !== null
+ && $worksheetName
+ && !in_array($worksheetName, $this->loadSheetsOnly)
+ ) {
+ continue;
+ }
+
+ $worksheetStyleName = $worksheetDataSet->getAttributeNS($tableNs, 'style-name');
+
+ // Create sheet
+ $spreadsheet->createSheet();
+ $spreadsheet->setActiveSheetIndex($worksheetID);
+
+ if ($worksheetName || is_numeric($worksheetName)) {
+ // Use false for $updateFormulaCellReferences to prevent adjustment of worksheet references in
+ // formula cells... during the load, all formulae should be correct, and we're simply
+ // bringing the worksheet name in line with the formula, not the reverse
+ $spreadsheet->getActiveSheet()->setTitle((string) $worksheetName, false, false);
+ }
+
+ // Go through every child of table element
+ $rowID = 1;
+ $tableColumnIndex = 1;
+ foreach ($worksheetDataSet->childNodes as $childNode) {
+ /** @var DOMElement $childNode */
+
+ // Filter elements which are not under the "table" ns
+ if ($childNode->namespaceURI != $tableNs) {
+ continue;
+ }
+
+ $key = $childNode->nodeName;
+
+ // Remove ns from node name
+ if (str_contains($key, ':')) {
+ $keyChunks = explode(':', $key);
+ $key = array_pop($keyChunks);
+ }
+
+ switch ($key) {
+ case 'table-header-rows':
+ /// TODO :: Figure this out. This is only a partial implementation I guess.
+ // ($rowData it's not used at all and I'm not sure that PHPExcel
+ // has an API for this)
+
+// foreach ($rowData as $keyRowData => $cellData) {
+// $rowData = $cellData;
+// break;
+// }
+ break;
+ case 'table-column':
+ if ($childNode->hasAttributeNS($tableNs, 'number-columns-repeated')) {
+ $rowRepeats = (int) $childNode->getAttributeNS($tableNs, 'number-columns-repeated');
+ } else {
+ $rowRepeats = 1;
+ }
+ $tableStyleName = $childNode->getAttributeNS($tableNs, 'style-name');
+ if (isset($columnWidths[$tableStyleName])) {
+ $columnWidth = new HelperDimension($columnWidths[$tableStyleName]);
+ $tableColumnString = Coordinate::stringFromColumnIndex($tableColumnIndex);
+ for ($rowRepeats2 = $rowRepeats; $rowRepeats2 > 0; --$rowRepeats2) {
+ $spreadsheet->getActiveSheet()
+ ->getColumnDimension($tableColumnString)
+ ->setWidth($columnWidth->toUnit('cm'), 'cm');
+ ++$tableColumnString;
+ }
+ }
+ $tableColumnIndex += $rowRepeats;
+
+ break;
+ case 'table-row':
+ if ($childNode->hasAttributeNS($tableNs, 'number-rows-repeated')) {
+ $rowRepeats = (int) $childNode->getAttributeNS($tableNs, 'number-rows-repeated');
+ } else {
+ $rowRepeats = 1;
+ }
+
+ $columnID = 'A';
+ /** @var DOMElement|DOMText $cellData */
+ foreach ($childNode->childNodes as $cellData) {
+ if ($cellData instanceof DOMText) {
+ continue; // should just be whitespace
+ }
+ if ($this->getReadFilter() !== null) {
+ if (!$this->getReadFilter()->readCell($columnID, $rowID, $worksheetName)) {
+ if ($cellData->hasAttributeNS($tableNs, 'number-columns-repeated')) {
+ $colRepeats = (int) $cellData->getAttributeNS($tableNs, 'number-columns-repeated');
+ } else {
+ $colRepeats = 1;
+ }
+
+ for ($i = 0; $i < $colRepeats; ++$i) {
+ ++$columnID;
+ }
+
+ continue;
+ }
+ }
+
+ // Initialize variables
+ $formatting = $hyperlink = null;
+ $hasCalculatedValue = false;
+ $cellDataFormula = '';
+
+ if ($cellData->hasAttributeNS($tableNs, 'formula')) {
+ $cellDataFormula = $cellData->getAttributeNS($tableNs, 'formula');
+ $hasCalculatedValue = true;
+ }
+
+ // Annotations
+ $annotation = $cellData->getElementsByTagNameNS($officeNs, 'annotation');
+
+ if ($annotation->length > 0 && $annotation->item(0) !== null) {
+ $textNode = $annotation->item(0)->getElementsByTagNameNS($textNs, 'p');
+ $textNodeLength = $textNode->length;
+ $newLineOwed = false;
+ for ($textNodeIndex = 0; $textNodeIndex < $textNodeLength; ++$textNodeIndex) {
+ $textNodeItem = $textNode->item($textNodeIndex);
+ if ($textNodeItem !== null) {
+ $text = $this->scanElementForText($textNodeItem);
+ if ($newLineOwed) {
+ $spreadsheet->getActiveSheet()
+ ->getComment($columnID . $rowID)
+ ->getText()
+ ->createText("\n");
+ }
+ $newLineOwed = true;
+
+ $spreadsheet->getActiveSheet()
+ ->getComment($columnID . $rowID)
+ ->getText()
+ ->createText($this->parseRichText($text));
+ }
+ }
+ }
+
+ // Content
+
+ /** @var DOMElement[] $paragraphs */
+ $paragraphs = [];
+
+ foreach ($cellData->childNodes as $item) {
+ /** @var DOMElement $item */
+
+ // Filter text:p elements
+ if ($item->nodeName == 'text:p') {
+ $paragraphs[] = $item;
+ }
+ }
+
+ if (count($paragraphs) > 0) {
+ // Consolidate if there are multiple p records (maybe with spans as well)
+ $dataArray = [];
+
+ // Text can have multiple text:p and within those, multiple text:span.
+ // text:p newlines, but text:span does not.
+ // Also, here we assume there is no text data is span fields are specified, since
+ // we have no way of knowing proper positioning anyway.
+
+ foreach ($paragraphs as $pData) {
+ $dataArray[] = $this->scanElementForText($pData);
+ }
+ $allCellDataText = implode("\n", $dataArray);
+
+ $type = $cellData->getAttributeNS($officeNs, 'value-type');
+
+ switch ($type) {
+ case 'string':
+ $type = DataType::TYPE_STRING;
+ $dataValue = $allCellDataText;
+
+ foreach ($paragraphs as $paragraph) {
+ $link = $paragraph->getElementsByTagNameNS($textNs, 'a');
+ if ($link->length > 0 && $link->item(0) !== null) {
+ $hyperlink = $link->item(0)->getAttributeNS($xlinkNs, 'href');
+ }
+ }
+
+ break;
+ case 'boolean':
+ $type = DataType::TYPE_BOOL;
+ $dataValue = ($cellData->getAttributeNS($officeNs, 'boolean-value') === 'true') ? true : false;
+
+ break;
+ case 'percentage':
+ $type = DataType::TYPE_NUMERIC;
+ $dataValue = (float) $cellData->getAttributeNS($officeNs, 'value');
+
+ // percentage should always be float
+ //if (floor($dataValue) == $dataValue) {
+ // $dataValue = (int) $dataValue;
+ //}
+ $formatting = NumberFormat::FORMAT_PERCENTAGE_00;
+
+ break;
+ case 'currency':
+ $type = DataType::TYPE_NUMERIC;
+ $dataValue = (float) $cellData->getAttributeNS($officeNs, 'value');
+
+ if (floor($dataValue) == $dataValue) {
+ $dataValue = (int) $dataValue;
+ }
+ $formatting = NumberFormat::FORMAT_CURRENCY_USD_INTEGER;
+
+ break;
+ case 'float':
+ $type = DataType::TYPE_NUMERIC;
+ $dataValue = (float) $cellData->getAttributeNS($officeNs, 'value');
+
+ if (floor($dataValue) == $dataValue) {
+ if ($dataValue == (int) $dataValue) {
+ $dataValue = (int) $dataValue;
+ }
+ }
+
+ break;
+ case 'date':
+ $type = DataType::TYPE_NUMERIC;
+ $value = $cellData->getAttributeNS($officeNs, 'date-value');
+ $dataValue = Date::convertIsoDate($value);
+
+ if ($dataValue != floor($dataValue)) {
+ $formatting = NumberFormat::FORMAT_DATE_XLSX15
+ . ' '
+ . NumberFormat::FORMAT_DATE_TIME4;
+ } else {
+ $formatting = NumberFormat::FORMAT_DATE_XLSX15;
+ }
+
+ break;
+ case 'time':
+ $type = DataType::TYPE_NUMERIC;
+
+ $timeValue = $cellData->getAttributeNS($officeNs, 'time-value');
+
+ $dataValue = Date::PHPToExcel(
+ strtotime(
+ '01-01-1970 ' . implode(':', sscanf($timeValue, 'PT%dH%dM%dS') ?? [])
+ )
+ );
+ $formatting = NumberFormat::FORMAT_DATE_TIME4;
+
+ break;
+ default:
+ $dataValue = null;
+ }
+ } else {
+ $type = DataType::TYPE_NULL;
+ $dataValue = null;
+ }
+
+ if ($hasCalculatedValue) {
+ $type = DataType::TYPE_FORMULA;
+ $cellDataFormula = substr($cellDataFormula, strpos($cellDataFormula, ':=') + 1);
+ $cellDataFormula = FormulaTranslator::convertToExcelFormulaValue($cellDataFormula);
+ }
+
+ if ($cellData->hasAttributeNS($tableNs, 'number-columns-repeated')) {
+ $colRepeats = (int) $cellData->getAttributeNS($tableNs, 'number-columns-repeated');
+ } else {
+ $colRepeats = 1;
+ }
+
+ if ($type !== null) {
+ for ($i = 0; $i < $colRepeats; ++$i) {
+ if ($i > 0) {
+ ++$columnID;
+ }
+
+ if ($type !== DataType::TYPE_NULL) {
+ for ($rowAdjust = 0; $rowAdjust < $rowRepeats; ++$rowAdjust) {
+ $rID = $rowID + $rowAdjust;
+
+ $cell = $spreadsheet->getActiveSheet()
+ ->getCell($columnID . $rID);
+
+ // Set value
+ if ($hasCalculatedValue) {
+ $cell->setValueExplicit($cellDataFormula, $type);
+ } else {
+ $cell->setValueExplicit($dataValue, $type);
+ }
+
+ if ($hasCalculatedValue) {
+ $cell->setCalculatedValue($dataValue, $type === DataType::TYPE_NUMERIC);
+ }
+
+ // Set other properties
+ if ($formatting !== null) {
+ $spreadsheet->getActiveSheet()
+ ->getStyle($columnID . $rID)
+ ->getNumberFormat()
+ ->setFormatCode($formatting);
+ } else {
+ $spreadsheet->getActiveSheet()
+ ->getStyle($columnID . $rID)
+ ->getNumberFormat()
+ ->setFormatCode(NumberFormat::FORMAT_GENERAL);
+ }
+
+ if ($hyperlink !== null) {
+ if ($hyperlink[0] === '#') {
+ $hyperlink = 'sheet://' . substr($hyperlink, 1);
+ }
+ $cell->getHyperlink()
+ ->setUrl($hyperlink);
+ }
+ }
+ }
+ }
+ }
+
+ // Merged cells
+ $this->processMergedCells($cellData, $tableNs, $type, $columnID, $rowID, $spreadsheet);
+
+ ++$columnID;
+ }
+ $rowID += $rowRepeats;
+
+ break;
+ }
+ }
+ $pageSettings->setVisibilityForWorksheet($spreadsheet->getActiveSheet(), $worksheetStyleName);
+ $pageSettings->setPrintSettingsForWorksheet($spreadsheet->getActiveSheet(), $worksheetStyleName);
+ ++$worksheetID;
+ }
+
+ $autoFilterReader->read($workbookData);
+ $definedNameReader->read($workbookData);
+ }
+ $spreadsheet->setActiveSheetIndex(0);
+
+ if ($zip->locateName('settings.xml') !== false) {
+ $this->processSettings($zip, $spreadsheet);
+ }
+
+ // Return
+ return $spreadsheet;
+ }
+
+ private function processSettings(ZipArchive $zip, Spreadsheet $spreadsheet): void
+ {
+ $dom = new DOMDocument('1.01', 'UTF-8');
+ $dom->loadXML(
+ $this->getSecurityScannerOrThrow()
+ ->scan($zip->getFromName('settings.xml'))
+ );
+ //$xlinkNs = $dom->lookupNamespaceUri('xlink');
+ $configNs = (string) $dom->lookupNamespaceUri('config');
+ //$oooNs = $dom->lookupNamespaceUri('ooo');
+ $officeNs = (string) $dom->lookupNamespaceUri('office');
+ $settings = $dom->getElementsByTagNameNS($officeNs, 'settings')
+ ->item(0);
+ if ($settings !== null) {
+ $this->lookForActiveSheet($settings, $spreadsheet, $configNs);
+ $this->lookForSelectedCells($settings, $spreadsheet, $configNs);
+ }
+ }
+
+ private function lookForActiveSheet(DOMElement $settings, Spreadsheet $spreadsheet, string $configNs): void
+ {
+ /** @var DOMElement $t */
+ foreach ($settings->getElementsByTagNameNS($configNs, 'config-item') as $t) {
+ if ($t->getAttributeNs($configNs, 'name') === 'ActiveTable') {
+ try {
+ $spreadsheet->setActiveSheetIndexByName($t->nodeValue ?? '');
+ } catch (Throwable) {
+ // do nothing
+ }
+
+ break;
+ }
+ }
+ }
+
+ private function lookForSelectedCells(DOMElement $settings, Spreadsheet $spreadsheet, string $configNs): void
+ {
+ /** @var DOMElement $t */
+ foreach ($settings->getElementsByTagNameNS($configNs, 'config-item-map-named') as $t) {
+ if ($t->getAttributeNs($configNs, 'name') === 'Tables') {
+ foreach ($t->getElementsByTagNameNS($configNs, 'config-item-map-entry') as $ws) {
+ $setRow = $setCol = '';
+ $wsname = $ws->getAttributeNs($configNs, 'name');
+ foreach ($ws->getElementsByTagNameNS($configNs, 'config-item') as $configItem) {
+ $attrName = $configItem->getAttributeNs($configNs, 'name');
+ if ($attrName === 'CursorPositionX') {
+ $setCol = $configItem->nodeValue;
+ }
+ if ($attrName === 'CursorPositionY') {
+ $setRow = $configItem->nodeValue;
+ }
+ }
+ $this->setSelected($spreadsheet, $wsname, "$setCol", "$setRow");
+ }
+
+ break;
+ }
+ }
+ }
+
+ private function setSelected(Spreadsheet $spreadsheet, string $wsname, string $setCol, string $setRow): void
+ {
+ if (is_numeric($setCol) && is_numeric($setRow)) {
+ $sheet = $spreadsheet->getSheetByName($wsname);
+ if ($sheet !== null) {
+ $sheet->setSelectedCells([(int) $setCol + 1, (int) $setRow + 1]);
+ }
+ }
+ }
+
+ /**
+ * Recursively scan element.
+ */
+ protected function scanElementForText(DOMNode $element): string
+ {
+ $str = '';
+ foreach ($element->childNodes as $child) {
+ /** @var DOMNode $child */
+ if ($child->nodeType == XML_TEXT_NODE) {
+ $str .= $child->nodeValue;
+ } elseif ($child->nodeType == XML_ELEMENT_NODE && $child->nodeName == 'text:line-break') {
+ $str .= "\n";
+ } elseif ($child->nodeType == XML_ELEMENT_NODE && $child->nodeName == 'text:s') {
+ // It's a space
+
+ // Multiple spaces?
+ $attributes = $child->attributes;
+ /** @var ?DOMAttr $cAttr */
+ $cAttr = ($attributes === null) ? null : $attributes->getNamedItem('c');
+ $multiplier = self::getMultiplier($cAttr);
+ $str .= str_repeat(' ', $multiplier);
+ }
+
+ if ($child->hasChildNodes()) {
+ $str .= $this->scanElementForText($child);
+ }
+ }
+
+ return $str;
+ }
+
+ private static function getMultiplier(?DOMAttr $cAttr): int
+ {
+ if ($cAttr) {
+ $multiplier = (int) $cAttr->nodeValue;
+ } else {
+ $multiplier = 1;
+ }
+
+ return $multiplier;
+ }
+
+ private function parseRichText(string $is): RichText
+ {
+ $value = new RichText();
+ $value->createText($is);
+
+ return $value;
+ }
+
+ private function processMergedCells(
+ DOMElement $cellData,
+ string $tableNs,
+ string $type,
+ string $columnID,
+ int $rowID,
+ Spreadsheet $spreadsheet
+ ): void {
+ if (
+ $cellData->hasAttributeNS($tableNs, 'number-columns-spanned')
+ || $cellData->hasAttributeNS($tableNs, 'number-rows-spanned')
+ ) {
+ if (($type !== DataType::TYPE_NULL) || ($this->readDataOnly === false)) {
+ $columnTo = $columnID;
+
+ if ($cellData->hasAttributeNS($tableNs, 'number-columns-spanned')) {
+ $columnIndex = Coordinate::columnIndexFromString($columnID);
+ $columnIndex += (int) $cellData->getAttributeNS($tableNs, 'number-columns-spanned');
+ $columnIndex -= 2;
+
+ $columnTo = Coordinate::stringFromColumnIndex($columnIndex + 1);
+ }
+
+ $rowTo = $rowID;
+
+ if ($cellData->hasAttributeNS($tableNs, 'number-rows-spanned')) {
+ $rowTo = $rowTo + (int) $cellData->getAttributeNS($tableNs, 'number-rows-spanned') - 1;
+ }
+
+ $cellRange = $columnID . $rowID . ':' . $columnTo . $rowTo;
+ $spreadsheet->getActiveSheet()->mergeCells($cellRange, Worksheet::MERGE_CELL_CONTENT_HIDE);
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/AutoFilter.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/AutoFilter.php
new file mode 100644
index 00000000..1f5f975d
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/AutoFilter.php
@@ -0,0 +1,45 @@
+readAutoFilters($workbookData);
+ }
+
+ protected function readAutoFilters(DOMElement $workbookData): void
+ {
+ $databases = $workbookData->getElementsByTagNameNS($this->tableNs, 'database-ranges');
+
+ foreach ($databases as $autofilters) {
+ foreach ($autofilters->childNodes as $autofilter) {
+ $autofilterRange = $this->getAttributeValue($autofilter, 'target-range-address');
+ if ($autofilterRange !== null) {
+ $baseAddress = FormulaTranslator::convertToExcelAddressValue($autofilterRange);
+ $this->spreadsheet->getActiveSheet()->setAutoFilter($baseAddress);
+ }
+ }
+ }
+ }
+
+ protected function getAttributeValue(?DOMNode $node, string $attributeName): ?string
+ {
+ if ($node !== null && $node->attributes !== null) {
+ $attribute = $node->attributes->getNamedItemNS(
+ $this->tableNs,
+ $attributeName
+ );
+
+ if ($attribute !== null) {
+ return $attribute->nodeValue;
+ }
+ }
+
+ return null;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/BaseLoader.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/BaseLoader.php
new file mode 100644
index 00000000..c280c4ec
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/BaseLoader.php
@@ -0,0 +1,21 @@
+spreadsheet = $spreadsheet;
+ $this->tableNs = $tableNs;
+ }
+
+ abstract public function read(DOMElement $workbookData): void;
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/DefinedNames.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/DefinedNames.php
new file mode 100644
index 00000000..a99e3ea7
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/DefinedNames.php
@@ -0,0 +1,70 @@
+readDefinedRanges($workbookData);
+ $this->readDefinedExpressions($workbookData);
+ }
+
+ /**
+ * Read any Named Ranges that are defined in this spreadsheet.
+ */
+ protected function readDefinedRanges(DOMElement $workbookData): void
+ {
+ $namedRanges = $workbookData->getElementsByTagNameNS($this->tableNs, 'named-range');
+ foreach ($namedRanges as $definedNameElement) {
+ $definedName = $definedNameElement->getAttributeNS($this->tableNs, 'name');
+ $baseAddress = $definedNameElement->getAttributeNS($this->tableNs, 'base-cell-address');
+ $range = $definedNameElement->getAttributeNS($this->tableNs, 'cell-range-address');
+
+ /** @var non-empty-string $baseAddress */
+ $baseAddress = FormulaTranslator::convertToExcelAddressValue($baseAddress);
+ $range = FormulaTranslator::convertToExcelAddressValue($range);
+
+ $this->addDefinedName($baseAddress, $definedName, $range);
+ }
+ }
+
+ /**
+ * Read any Named Formulae that are defined in this spreadsheet.
+ */
+ protected function readDefinedExpressions(DOMElement $workbookData): void
+ {
+ $namedExpressions = $workbookData->getElementsByTagNameNS($this->tableNs, 'named-expression');
+ foreach ($namedExpressions as $definedNameElement) {
+ $definedName = $definedNameElement->getAttributeNS($this->tableNs, 'name');
+ $baseAddress = $definedNameElement->getAttributeNS($this->tableNs, 'base-cell-address');
+ $expression = $definedNameElement->getAttributeNS($this->tableNs, 'expression');
+
+ /** @var non-empty-string $baseAddress */
+ $baseAddress = FormulaTranslator::convertToExcelAddressValue($baseAddress);
+ $expression = substr($expression, strpos($expression, ':=') + 1);
+ $expression = FormulaTranslator::convertToExcelFormulaValue($expression);
+
+ $this->addDefinedName($baseAddress, $definedName, $expression);
+ }
+ }
+
+ /**
+ * Assess scope and store the Defined Name.
+ *
+ * @param non-empty-string $baseAddress
+ */
+ private function addDefinedName(string $baseAddress, string $definedName, string $value): void
+ {
+ [$sheetReference] = Worksheet::extractSheetTitle($baseAddress, true);
+ $worksheet = $this->spreadsheet->getSheetByName($sheetReference);
+ // Worksheet might still be null if we're only loading selected sheets rather than the full spreadsheet
+ if ($worksheet !== null) {
+ $this->spreadsheet->addDefinedName(DefinedName::createInstance((string) $definedName, $worksheet, $value));
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/FormulaTranslator.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/FormulaTranslator.php
new file mode 100644
index 00000000..27862d7a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/FormulaTranslator.php
@@ -0,0 +1,97 @@
+setDomNameSpaces($styleDom);
+ $this->readPageSettingStyles($styleDom);
+ $this->readStyleMasterLookup($styleDom);
+ }
+
+ private function setDomNameSpaces(DOMDocument $styleDom): void
+ {
+ $this->officeNs = (string) $styleDom->lookupNamespaceUri('office');
+ $this->stylesNs = (string) $styleDom->lookupNamespaceUri('style');
+ $this->stylesFo = (string) $styleDom->lookupNamespaceUri('fo');
+ $this->tableNs = (string) $styleDom->lookupNamespaceUri('table');
+ }
+
+ private function readPageSettingStyles(DOMDocument $styleDom): void
+ {
+ $item0 = $styleDom->getElementsByTagNameNS($this->officeNs, 'automatic-styles')->item(0);
+ $styles = ($item0 === null) ? [] : $item0->getElementsByTagNameNS($this->stylesNs, 'page-layout');
+
+ foreach ($styles as $styleSet) {
+ $styleName = $styleSet->getAttributeNS($this->stylesNs, 'name');
+ $pageLayoutProperties = $styleSet->getElementsByTagNameNS($this->stylesNs, 'page-layout-properties')->item(0);
+ $styleOrientation = $pageLayoutProperties?->getAttributeNS($this->stylesNs, 'print-orientation');
+ $styleScale = $pageLayoutProperties?->getAttributeNS($this->stylesNs, 'scale-to');
+ $stylePrintOrder = $pageLayoutProperties?->getAttributeNS($this->stylesNs, 'print-page-order');
+ $centered = $pageLayoutProperties?->getAttributeNS($this->stylesNs, 'table-centering');
+
+ $marginLeft = $pageLayoutProperties?->getAttributeNS($this->stylesFo, 'margin-left');
+ $marginRight = $pageLayoutProperties?->getAttributeNS($this->stylesFo, 'margin-right');
+ $marginTop = $pageLayoutProperties?->getAttributeNS($this->stylesFo, 'margin-top');
+ $marginBottom = $pageLayoutProperties?->getAttributeNS($this->stylesFo, 'margin-bottom');
+ $header = $styleSet->getElementsByTagNameNS($this->stylesNs, 'header-style')->item(0);
+ $headerProperties = $header?->getElementsByTagNameNS($this->stylesNs, 'header-footer-properties')?->item(0);
+ $marginHeader = $headerProperties?->getAttributeNS($this->stylesFo, 'min-height');
+ $footer = $styleSet->getElementsByTagNameNS($this->stylesNs, 'footer-style')->item(0);
+ $footerProperties = $footer?->getElementsByTagNameNS($this->stylesNs, 'header-footer-properties')?->item(0);
+ $marginFooter = $footerProperties?->getAttributeNS($this->stylesFo, 'min-height');
+
+ $this->pageLayoutStyles[$styleName] = (object) [
+ 'orientation' => $styleOrientation ?: PageSetup::ORIENTATION_DEFAULT,
+ 'scale' => $styleScale ?: 100,
+ 'printOrder' => $stylePrintOrder,
+ 'horizontalCentered' => $centered === 'horizontal' || $centered === 'both',
+ 'verticalCentered' => $centered === 'vertical' || $centered === 'both',
+ // margin size is already stored in inches, so no UOM conversion is required
+ 'marginLeft' => (float) ($marginLeft ?? 0.7),
+ 'marginRight' => (float) ($marginRight ?? 0.7),
+ 'marginTop' => (float) ($marginTop ?? 0.3),
+ 'marginBottom' => (float) ($marginBottom ?? 0.3),
+ 'marginHeader' => (float) ($marginHeader ?? 0.45),
+ 'marginFooter' => (float) ($marginFooter ?? 0.45),
+ ];
+ }
+ }
+
+ private function readStyleMasterLookup(DOMDocument $styleDom): void
+ {
+ $item0 = $styleDom->getElementsByTagNameNS($this->officeNs, 'master-styles')->item(0);
+ $styleMasterLookup = ($item0 === null) ? [] : $item0->getElementsByTagNameNS($this->stylesNs, 'master-page');
+
+ foreach ($styleMasterLookup as $styleMasterSet) {
+ $styleMasterName = $styleMasterSet->getAttributeNS($this->stylesNs, 'name');
+ $pageLayoutName = $styleMasterSet->getAttributeNS($this->stylesNs, 'page-layout-name');
+ $this->masterPrintStylesCrossReference[$styleMasterName] = $pageLayoutName;
+ }
+ }
+
+ public function readStyleCrossReferences(DOMDocument $contentDom): void
+ {
+ $item0 = $contentDom->getElementsByTagNameNS($this->officeNs, 'automatic-styles')->item(0);
+ $styleXReferences = ($item0 === null) ? [] : $item0->getElementsByTagNameNS($this->stylesNs, 'style');
+
+ foreach ($styleXReferences as $styleXreferenceSet) {
+ $styleXRefName = $styleXreferenceSet->getAttributeNS($this->stylesNs, 'name');
+ $stylePageLayoutName = $styleXreferenceSet->getAttributeNS($this->stylesNs, 'master-page-name');
+ $styleFamilyName = $styleXreferenceSet->getAttributeNS($this->stylesNs, 'family');
+ if (!empty($styleFamilyName) && $styleFamilyName === 'table') {
+ $styleVisibility = 'true';
+ foreach ($styleXreferenceSet->getElementsByTagNameNS($this->stylesNs, 'table-properties') as $tableProperties) {
+ $styleVisibility = $tableProperties->getAttributeNS($this->tableNs, 'display');
+ }
+ $this->tableStylesCrossReference[$styleXRefName] = $styleVisibility;
+ }
+ if (!empty($stylePageLayoutName)) {
+ $this->masterStylesCrossReference[$styleXRefName] = $stylePageLayoutName;
+ }
+ }
+ }
+
+ public function setVisibilityForWorksheet(Worksheet $worksheet, string $styleName): void
+ {
+ if (!array_key_exists($styleName, $this->tableStylesCrossReference)) {
+ return;
+ }
+
+ $worksheet->setSheetState(
+ $this->tableStylesCrossReference[$styleName] === 'false'
+ ? Worksheet::SHEETSTATE_HIDDEN
+ : Worksheet::SHEETSTATE_VISIBLE
+ );
+ }
+
+ public function setPrintSettingsForWorksheet(Worksheet $worksheet, string $styleName): void
+ {
+ if (!array_key_exists($styleName, $this->masterStylesCrossReference)) {
+ return;
+ }
+ $masterStyleName = $this->masterStylesCrossReference[$styleName];
+
+ if (!array_key_exists($masterStyleName, $this->masterPrintStylesCrossReference)) {
+ return;
+ }
+ $printSettingsIndex = $this->masterPrintStylesCrossReference[$masterStyleName];
+
+ if (!array_key_exists($printSettingsIndex, $this->pageLayoutStyles)) {
+ return;
+ }
+ $printSettings = $this->pageLayoutStyles[$printSettingsIndex];
+
+ $worksheet->getPageSetup()
+ ->setOrientation($printSettings->orientation ?? PageSetup::ORIENTATION_DEFAULT)
+ ->setPageOrder($printSettings->printOrder === 'ltr' ? PageSetup::PAGEORDER_OVER_THEN_DOWN : PageSetup::PAGEORDER_DOWN_THEN_OVER)
+ ->setScale((int) trim($printSettings->scale, '%'))
+ ->setHorizontalCentered($printSettings->horizontalCentered)
+ ->setVerticalCentered($printSettings->verticalCentered);
+
+ $worksheet->getPageMargins()
+ ->setLeft($printSettings->marginLeft)
+ ->setRight($printSettings->marginRight)
+ ->setTop($printSettings->marginTop)
+ ->setBottom($printSettings->marginBottom)
+ ->setHeader($printSettings->marginHeader)
+ ->setFooter($printSettings->marginFooter);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/Properties.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/Properties.php
new file mode 100644
index 00000000..a5f0c79f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Ods/Properties.php
@@ -0,0 +1,136 @@
+spreadsheet = $spreadsheet;
+ }
+
+ public function load(SimpleXMLElement $xml, array $namespacesMeta): void
+ {
+ $docProps = $this->spreadsheet->getProperties();
+ $officeProperty = $xml->children($namespacesMeta['office']);
+ foreach ($officeProperty as $officePropertyData) {
+ if (isset($namespacesMeta['dc'])) {
+ $officePropertiesDC = $officePropertyData->children($namespacesMeta['dc']);
+ $this->setCoreProperties($docProps, $officePropertiesDC);
+ }
+
+ $officePropertyMeta = null;
+ if (isset($namespacesMeta['dc'])) {
+ $officePropertyMeta = $officePropertyData->children($namespacesMeta['meta']);
+ }
+ $officePropertyMeta = $officePropertyMeta ?? [];
+ foreach ($officePropertyMeta as $propertyName => $propertyValue) {
+ $this->setMetaProperties($namespacesMeta, $propertyValue, $propertyName, $docProps);
+ }
+ }
+ }
+
+ private function setCoreProperties(DocumentProperties $docProps, SimpleXMLElement $officePropertyDC): void
+ {
+ foreach ($officePropertyDC as $propertyName => $propertyValue) {
+ $propertyValue = (string) $propertyValue;
+ switch ($propertyName) {
+ case 'title':
+ $docProps->setTitle($propertyValue);
+
+ break;
+ case 'subject':
+ $docProps->setSubject($propertyValue);
+
+ break;
+ case 'creator':
+ $docProps->setCreator($propertyValue);
+ $docProps->setLastModifiedBy($propertyValue);
+
+ break;
+ case 'date':
+ $docProps->setModified($propertyValue);
+
+ break;
+ case 'description':
+ $docProps->setDescription($propertyValue);
+
+ break;
+ }
+ }
+ }
+
+ private function setMetaProperties(
+ array $namespacesMeta,
+ SimpleXMLElement $propertyValue,
+ string $propertyName,
+ DocumentProperties $docProps
+ ): void {
+ $propertyValueAttributes = $propertyValue->attributes($namespacesMeta['meta']);
+ $propertyValue = (string) $propertyValue;
+ switch ($propertyName) {
+ case 'initial-creator':
+ $docProps->setCreator($propertyValue);
+
+ break;
+ case 'keyword':
+ $docProps->setKeywords($propertyValue);
+
+ break;
+ case 'creation-date':
+ $docProps->setCreated($propertyValue);
+
+ break;
+ case 'user-defined':
+ $name2 = (string) ($propertyValueAttributes['name'] ?? '');
+ if ($name2 === 'Company') {
+ $docProps->setCompany($propertyValue);
+ } elseif ($name2 === 'category') {
+ $docProps->setCategory($propertyValue);
+ } else {
+ $this->setUserDefinedProperty($propertyValueAttributes, $propertyValue, $docProps);
+ }
+
+ break;
+ }
+ }
+
+ private function setUserDefinedProperty(iterable $propertyValueAttributes, string $propertyValue, DocumentProperties $docProps): void
+ {
+ $propertyValueName = '';
+ $propertyValueType = DocumentProperties::PROPERTY_TYPE_STRING;
+ foreach ($propertyValueAttributes as $key => $value) {
+ if ($key == 'name') {
+ $propertyValueName = (string) $value;
+ } elseif ($key == 'value-type') {
+ switch ($value) {
+ case 'date':
+ $propertyValue = DocumentProperties::convertProperty($propertyValue, 'date');
+ $propertyValueType = DocumentProperties::PROPERTY_TYPE_DATE;
+
+ break;
+ case 'boolean':
+ $propertyValue = DocumentProperties::convertProperty($propertyValue, 'bool');
+ $propertyValueType = DocumentProperties::PROPERTY_TYPE_BOOLEAN;
+
+ break;
+ case 'float':
+ $propertyValue = DocumentProperties::convertProperty($propertyValue, 'r4');
+ $propertyValueType = DocumentProperties::PROPERTY_TYPE_FLOAT;
+
+ break;
+ default:
+ $propertyValueType = DocumentProperties::PROPERTY_TYPE_STRING;
+ }
+ }
+ }
+
+ $docProps->setCustomProperty($propertyValueName, $propertyValue, $propertyValueType);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Security/XmlScanner.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Security/XmlScanner.php
new file mode 100644
index 00000000..c4c85bdf
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Security/XmlScanner.php
@@ -0,0 +1,117 @@
+pattern = $pattern;
+ }
+
+ public static function getInstance(Reader\IReader $reader): self
+ {
+ $pattern = ($reader instanceof Reader\Html) ? 'callback = $callback;
+ }
+
+ private static function forceString(mixed $arg): string
+ {
+ return is_string($arg) ? $arg : '';
+ }
+
+ private function toUtf8(string $xml): string
+ {
+ $charset = $this->findCharSet($xml);
+ $foundUtf7 = $charset === 'UTF-7';
+ if ($charset !== 'UTF-8') {
+ $testStart = '/^.{0,4}\\s*pattern)) . '\\0*/';
+
+ $xml = "$xml";
+ if (preg_match($pattern, $xml)) {
+ throw new Reader\Exception('Detected use of ENTITY in XML, spreadsheet file load() aborted to prevent XXE/XEE attacks');
+ }
+
+ $xml = $this->toUtf8($xml);
+
+ if (preg_match($pattern, $xml)) {
+ throw new Reader\Exception('Detected use of ENTITY in XML, spreadsheet file load() aborted to prevent XXE/XEE attacks');
+ }
+
+ if ($this->callback !== null) {
+ $xml = call_user_func($this->callback, $xml);
+ }
+
+ return $xml;
+ }
+
+ /**
+ * Scan the XML for use of scan(file_get_contents($filestream));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Slk.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Slk.php
new file mode 100644
index 00000000..2a0b2fcd
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Slk.php
@@ -0,0 +1,566 @@
+openFile($filename);
+ } catch (ReaderException) {
+ return false;
+ }
+
+ // Read sample data (first 2 KB will do)
+ $data = (string) fread($this->fileHandle, 2048);
+
+ // Count delimiters in file
+ $delimiterCount = substr_count($data, ';');
+ $hasDelimiter = $delimiterCount > 0;
+
+ // Analyze first line looking for ID; signature
+ $lines = explode("\n", $data);
+ $hasId = str_starts_with($lines[0], 'ID;P');
+
+ fclose($this->fileHandle);
+
+ return $hasDelimiter && $hasId;
+ }
+
+ private function canReadOrBust(string $filename): void
+ {
+ if (!$this->canRead($filename)) {
+ throw new ReaderException($filename . ' is an Invalid SYLK file.');
+ }
+ $this->openFile($filename);
+ }
+
+ /**
+ * Return worksheet info (Name, Last Column Letter, Last Column Index, Total Rows, Total Columns).
+ */
+ public function listWorksheetInfo(string $filename): array
+ {
+ // Open file
+ $this->canReadOrBust($filename);
+ $fileHandle = $this->fileHandle;
+ rewind($fileHandle);
+
+ $worksheetInfo = [];
+ $worksheetInfo[0]['worksheetName'] = basename($filename, '.slk');
+
+ // loop through one row (line) at a time in the file
+ $rowIndex = 0;
+ $columnIndex = 0;
+ while (($rowData = fgets($fileHandle)) !== false) {
+ $columnIndex = 0;
+
+ // convert SYLK encoded $rowData to UTF-8
+ $rowData = StringHelper::SYLKtoUTF8($rowData);
+
+ // explode each row at semicolons while taking into account that literal semicolon (;)
+ // is escaped like this (;;)
+ $rowData = explode("\t", str_replace('¤', ';', str_replace(';', "\t", str_replace(';;', '¤', rtrim($rowData)))));
+
+ $dataType = array_shift($rowData);
+ if ($dataType == 'B') {
+ foreach ($rowData as $rowDatum) {
+ switch ($rowDatum[0]) {
+ case 'X':
+ $columnIndex = (int) substr($rowDatum, 1) - 1;
+
+ break;
+ case 'Y':
+ $rowIndex = (int) substr($rowDatum, 1);
+
+ break;
+ }
+ }
+
+ break;
+ }
+ }
+
+ $worksheetInfo[0]['lastColumnIndex'] = $columnIndex;
+ $worksheetInfo[0]['totalRows'] = $rowIndex;
+ $worksheetInfo[0]['lastColumnLetter'] = Coordinate::stringFromColumnIndex($worksheetInfo[0]['lastColumnIndex'] + 1);
+ $worksheetInfo[0]['totalColumns'] = $worksheetInfo[0]['lastColumnIndex'] + 1;
+
+ // Close file
+ fclose($fileHandle);
+
+ return $worksheetInfo;
+ }
+
+ /**
+ * Loads PhpSpreadsheet from file.
+ */
+ protected function loadSpreadsheetFromFile(string $filename): Spreadsheet
+ {
+ // Create new Spreadsheet
+ $spreadsheet = new Spreadsheet();
+
+ // Load into this instance
+ return $this->loadIntoExisting($filename, $spreadsheet);
+ }
+
+ private const COLOR_ARRAY = [
+ 'FF00FFFF', // 0 - cyan
+ 'FF000000', // 1 - black
+ 'FFFFFFFF', // 2 - white
+ 'FFFF0000', // 3 - red
+ 'FF00FF00', // 4 - green
+ 'FF0000FF', // 5 - blue
+ 'FFFFFF00', // 6 - yellow
+ 'FFFF00FF', // 7 - magenta
+ ];
+
+ private const FONT_STYLE_MAPPINGS = [
+ 'B' => 'bold',
+ 'I' => 'italic',
+ 'U' => 'underline',
+ ];
+
+ private function processFormula(string $rowDatum, bool &$hasCalculatedValue, string &$cellDataFormula, string $row, string $column): void
+ {
+ $cellDataFormula = '=' . substr($rowDatum, 1);
+ // Convert R1C1 style references to A1 style references (but only when not quoted)
+ $temp = explode('"', $cellDataFormula);
+ $key = false;
+ foreach ($temp as &$value) {
+ // Only count/replace in alternate array entries
+ $key = $key === false;
+ if ($key) {
+ preg_match_all('/(R(\[?-?\d*\]?))(C(\[?-?\d*\]?))/', $value, $cellReferences, PREG_SET_ORDER + PREG_OFFSET_CAPTURE);
+ // Reverse the matches array, otherwise all our offsets will become incorrect if we modify our way
+ // through the formula from left to right. Reversing means that we work right to left.through
+ // the formula
+ $cellReferences = array_reverse($cellReferences);
+ // Loop through each R1C1 style reference in turn, converting it to its A1 style equivalent,
+ // then modify the formula to use that new reference
+ foreach ($cellReferences as $cellReference) {
+ $rowReference = $cellReference[2][0];
+ // Empty R reference is the current row
+ if ($rowReference == '') {
+ $rowReference = $row;
+ }
+ // Bracketed R references are relative to the current row
+ if ($rowReference[0] == '[') {
+ $rowReference = (int) $row + (int) trim($rowReference, '[]');
+ }
+ $columnReference = $cellReference[4][0];
+ // Empty C reference is the current column
+ if ($columnReference == '') {
+ $columnReference = $column;
+ }
+ // Bracketed C references are relative to the current column
+ if ($columnReference[0] == '[') {
+ $columnReference = (int) $column + (int) trim($columnReference, '[]');
+ }
+ $A1CellReference = Coordinate::stringFromColumnIndex((int) $columnReference) . $rowReference;
+
+ $value = substr_replace($value, $A1CellReference, $cellReference[0][1], strlen($cellReference[0][0]));
+ }
+ }
+ }
+ unset($value);
+ // Then rebuild the formula string
+ $cellDataFormula = implode('"', $temp);
+ $hasCalculatedValue = true;
+ }
+
+ private function processCRecord(array $rowData, Spreadsheet &$spreadsheet, string &$row, string &$column): void
+ {
+ // Read cell value data
+ $hasCalculatedValue = false;
+ $tryNumeric = false;
+ $cellDataFormula = $cellData = '';
+ $sharedColumn = $sharedRow = -1;
+ $sharedFormula = false;
+ foreach ($rowData as $rowDatum) {
+ switch ($rowDatum[0]) {
+ case 'X':
+ $column = substr($rowDatum, 1);
+
+ break;
+ case 'Y':
+ $row = substr($rowDatum, 1);
+
+ break;
+ case 'K':
+ $cellData = substr($rowDatum, 1);
+ $tryNumeric = is_numeric($cellData);
+
+ break;
+ case 'E':
+ $this->processFormula($rowDatum, $hasCalculatedValue, $cellDataFormula, $row, $column);
+
+ break;
+ case 'A':
+ $comment = substr($rowDatum, 1);
+ $columnLetter = Coordinate::stringFromColumnIndex((int) $column);
+ $spreadsheet->getActiveSheet()
+ ->getComment("$columnLetter$row")
+ ->getText()
+ ->createText($comment);
+
+ break;
+ case 'C':
+ $sharedColumn = (int) substr($rowDatum, 1);
+
+ break;
+ case 'R':
+ $sharedRow = (int) substr($rowDatum, 1);
+
+ break;
+ case 'S':
+ $sharedFormula = true;
+
+ break;
+ }
+ }
+ if ($sharedFormula === true && $sharedRow >= 0 && $sharedColumn >= 0) {
+ $thisCoordinate = Coordinate::stringFromColumnIndex((int) $column) . $row;
+ $sharedCoordinate = Coordinate::stringFromColumnIndex($sharedColumn) . $sharedRow;
+ /** @var string */
+ $formula = $spreadsheet->getActiveSheet()->getCell($sharedCoordinate)->getValue();
+ $spreadsheet->getActiveSheet()->getCell($thisCoordinate)->setValue($formula);
+ $referenceHelper = ReferenceHelper::getInstance();
+ $newFormula = $referenceHelper->updateFormulaReferences($formula, 'A1', (int) $column - $sharedColumn, (int) $row - $sharedRow, '', true, false);
+ $spreadsheet->getActiveSheet()->getCell($thisCoordinate)->setValue($newFormula);
+ //$calc = $spreadsheet->getActiveSheet()->getCell($thisCoordinate)->getCalculatedValue();
+ //$spreadsheet->getActiveSheet()->getCell($thisCoordinate)->setCalculatedValue($calc);
+ $cellData = Calculation::unwrapResult($cellData);
+ $spreadsheet->getActiveSheet()->getCell($thisCoordinate)->setCalculatedValue($cellData, $tryNumeric);
+
+ return;
+ }
+ $columnLetter = Coordinate::stringFromColumnIndex((int) $column);
+ /** @var string */
+ $cellData = Calculation::unwrapResult($cellData);
+
+ // Set cell value
+ $this->processCFinal($spreadsheet, $hasCalculatedValue, $cellDataFormula, $cellData, "$columnLetter$row", $tryNumeric);
+ }
+
+ private function processCFinal(Spreadsheet &$spreadsheet, bool $hasCalculatedValue, string $cellDataFormula, string $cellData, string $coordinate, bool $tryNumeric): void
+ {
+ // Set cell value
+ $spreadsheet->getActiveSheet()->getCell($coordinate)->setValue(($hasCalculatedValue) ? $cellDataFormula : $cellData);
+ if ($hasCalculatedValue) {
+ $cellData = Calculation::unwrapResult($cellData);
+ $spreadsheet->getActiveSheet()->getCell($coordinate)->setCalculatedValue($cellData, $tryNumeric);
+ }
+ }
+
+ private function processFRecord(array $rowData, Spreadsheet &$spreadsheet, string &$row, string &$column): void
+ {
+ // Read cell formatting
+ $formatStyle = $columnWidth = '';
+ $startCol = $endCol = '';
+ $fontStyle = '';
+ $styleData = [];
+ foreach ($rowData as $rowDatum) {
+ switch ($rowDatum[0]) {
+ case 'C':
+ case 'X':
+ $column = substr($rowDatum, 1);
+
+ break;
+ case 'R':
+ case 'Y':
+ $row = substr($rowDatum, 1);
+
+ break;
+ case 'P':
+ $formatStyle = $rowDatum;
+
+ break;
+ case 'W':
+ [$startCol, $endCol, $columnWidth] = explode(' ', substr($rowDatum, 1));
+
+ break;
+ case 'S':
+ $this->styleSettings($rowDatum, $styleData, $fontStyle);
+
+ break;
+ }
+ }
+ $this->addFormats($spreadsheet, $formatStyle, $row, $column);
+ $this->addFonts($spreadsheet, $fontStyle, $row, $column);
+ $this->addStyle($spreadsheet, $styleData, $row, $column);
+ $this->addWidth($spreadsheet, $columnWidth, $startCol, $endCol);
+ }
+
+ private const STYLE_SETTINGS_FONT = ['D' => 'bold', 'I' => 'italic'];
+
+ private const STYLE_SETTINGS_BORDER = [
+ 'B' => 'bottom',
+ 'L' => 'left',
+ 'R' => 'right',
+ 'T' => 'top',
+ ];
+
+ private function styleSettings(string $rowDatum, array &$styleData, string &$fontStyle): void
+ {
+ $styleSettings = substr($rowDatum, 1);
+ $iMax = strlen($styleSettings);
+ for ($i = 0; $i < $iMax; ++$i) {
+ $char = $styleSettings[$i];
+ if (array_key_exists($char, self::STYLE_SETTINGS_FONT)) {
+ $styleData['font'][self::STYLE_SETTINGS_FONT[$char]] = true;
+ } elseif (array_key_exists($char, self::STYLE_SETTINGS_BORDER)) {
+ $styleData['borders'][self::STYLE_SETTINGS_BORDER[$char]]['borderStyle'] = Border::BORDER_THIN;
+ } elseif ($char == 'S') {
+ $styleData['fill']['fillType'] = Fill::FILL_PATTERN_GRAY125;
+ } elseif ($char == 'M') {
+ if (preg_match('/M([1-9]\\d*)/', $styleSettings, $matches)) {
+ $fontStyle = $matches[1];
+ }
+ }
+ }
+ }
+
+ private function addFormats(Spreadsheet &$spreadsheet, string $formatStyle, string $row, string $column): void
+ {
+ if ($formatStyle && $column > '' && $row > '') {
+ $columnLetter = Coordinate::stringFromColumnIndex((int) $column);
+ if (isset($this->formats[$formatStyle])) {
+ $spreadsheet->getActiveSheet()->getStyle($columnLetter . $row)->applyFromArray($this->formats[$formatStyle]);
+ }
+ }
+ }
+
+ private function addFonts(Spreadsheet &$spreadsheet, string $fontStyle, string $row, string $column): void
+ {
+ if ($fontStyle && $column > '' && $row > '') {
+ $columnLetter = Coordinate::stringFromColumnIndex((int) $column);
+ if (isset($this->fonts[$fontStyle])) {
+ $spreadsheet->getActiveSheet()->getStyle($columnLetter . $row)->applyFromArray($this->fonts[$fontStyle]);
+ }
+ }
+ }
+
+ private function addStyle(Spreadsheet &$spreadsheet, array $styleData, string $row, string $column): void
+ {
+ if ((!empty($styleData)) && $column > '' && $row > '') {
+ $columnLetter = Coordinate::stringFromColumnIndex((int) $column);
+ $spreadsheet->getActiveSheet()->getStyle($columnLetter . $row)->applyFromArray($styleData);
+ }
+ }
+
+ private function addWidth(Spreadsheet $spreadsheet, string $columnWidth, string $startCol, string $endCol): void
+ {
+ if ($columnWidth > '') {
+ if ($startCol == $endCol) {
+ $startCol = Coordinate::stringFromColumnIndex((int) $startCol);
+ $spreadsheet->getActiveSheet()->getColumnDimension($startCol)->setWidth((float) $columnWidth);
+ } else {
+ $startCol = Coordinate::stringFromColumnIndex((int) $startCol);
+ $endCol = Coordinate::stringFromColumnIndex((int) $endCol);
+ $spreadsheet->getActiveSheet()->getColumnDimension($startCol)->setWidth((float) $columnWidth);
+ do {
+ $spreadsheet->getActiveSheet()->getColumnDimension((string) ++$startCol)->setWidth((float) $columnWidth);
+ } while ($startCol !== $endCol);
+ }
+ }
+ }
+
+ private function processPRecord(array $rowData, Spreadsheet &$spreadsheet): void
+ {
+ // Read shared styles
+ $formatArray = [];
+ $fromFormats = ['\-', '\ '];
+ $toFormats = ['-', ' '];
+ foreach ($rowData as $rowDatum) {
+ switch ($rowDatum[0]) {
+ case 'P':
+ $formatArray['numberFormat']['formatCode'] = str_replace($fromFormats, $toFormats, substr($rowDatum, 1));
+
+ break;
+ case 'E':
+ case 'F':
+ $formatArray['font']['name'] = substr($rowDatum, 1);
+
+ break;
+ case 'M':
+ $formatArray['font']['size'] = ((float) substr($rowDatum, 1)) / 20;
+
+ break;
+ case 'L':
+ $this->processPColors($rowDatum, $formatArray);
+
+ break;
+ case 'S':
+ $this->processPFontStyles($rowDatum, $formatArray);
+
+ break;
+ }
+ }
+ $this->processPFinal($spreadsheet, $formatArray);
+ }
+
+ private function processPColors(string $rowDatum, array &$formatArray): void
+ {
+ if (preg_match('/L([1-9]\\d*)/', $rowDatum, $matches)) {
+ $fontColor = ((int) $matches[1]) % 8;
+ $formatArray['font']['color']['argb'] = self::COLOR_ARRAY[$fontColor];
+ }
+ }
+
+ private function processPFontStyles(string $rowDatum, array &$formatArray): void
+ {
+ $styleSettings = substr($rowDatum, 1);
+ $iMax = strlen($styleSettings);
+ for ($i = 0; $i < $iMax; ++$i) {
+ if (array_key_exists($styleSettings[$i], self::FONT_STYLE_MAPPINGS)) {
+ $formatArray['font'][self::FONT_STYLE_MAPPINGS[$styleSettings[$i]]] = true;
+ }
+ }
+ }
+
+ private function processPFinal(Spreadsheet &$spreadsheet, array $formatArray): void
+ {
+ if (array_key_exists('numberFormat', $formatArray)) {
+ $this->formats['P' . $this->format] = $formatArray;
+ ++$this->format;
+ } elseif (array_key_exists('font', $formatArray)) {
+ ++$this->fontcount;
+ $this->fonts[$this->fontcount] = $formatArray;
+ if ($this->fontcount === 1) {
+ $spreadsheet->getDefaultStyle()->applyFromArray($formatArray);
+ }
+ }
+ }
+
+ /**
+ * Loads PhpSpreadsheet from file into PhpSpreadsheet instance.
+ */
+ public function loadIntoExisting(string $filename, Spreadsheet $spreadsheet): Spreadsheet
+ {
+ // Open file
+ $this->canReadOrBust($filename);
+ $fileHandle = $this->fileHandle;
+ rewind($fileHandle);
+
+ // Create new Worksheets
+ while ($spreadsheet->getSheetCount() <= $this->sheetIndex) {
+ $spreadsheet->createSheet();
+ }
+ $spreadsheet->setActiveSheetIndex($this->sheetIndex);
+ $spreadsheet->getActiveSheet()->setTitle(substr(basename($filename, '.slk'), 0, Worksheet::SHEET_TITLE_MAXIMUM_LENGTH));
+
+ // Loop through file
+ $column = $row = '';
+
+ // loop through one row (line) at a time in the file
+ while (($rowDataTxt = fgets($fileHandle)) !== false) {
+ // convert SYLK encoded $rowData to UTF-8
+ $rowDataTxt = StringHelper::SYLKtoUTF8($rowDataTxt);
+
+ // explode each row at semicolons while taking into account that literal semicolon (;)
+ // is escaped like this (;;)
+ $rowData = explode("\t", str_replace('¤', ';', str_replace(';', "\t", str_replace(';;', '¤', rtrim($rowDataTxt)))));
+
+ $dataType = array_shift($rowData);
+ if ($dataType == 'P') {
+ // Read shared styles
+ $this->processPRecord($rowData, $spreadsheet);
+ } elseif ($dataType == 'C') {
+ // Read cell value data
+ $this->processCRecord($rowData, $spreadsheet, $row, $column);
+ } elseif ($dataType == 'F') {
+ // Read cell formatting
+ $this->processFRecord($rowData, $spreadsheet, $row, $column);
+ } else {
+ $this->columnRowFromRowData($rowData, $column, $row);
+ }
+ }
+
+ // Close file
+ fclose($fileHandle);
+
+ // Return
+ return $spreadsheet;
+ }
+
+ private function columnRowFromRowData(array $rowData, string &$column, string &$row): void
+ {
+ foreach ($rowData as $rowDatum) {
+ $char0 = $rowDatum[0];
+ if ($char0 === 'X' || $char0 == 'C') {
+ $column = substr($rowDatum, 1);
+ } elseif ($char0 === 'Y' || $char0 == 'R') {
+ $row = substr($rowDatum, 1);
+ }
+ }
+ }
+
+ /**
+ * Get sheet index.
+ */
+ public function getSheetIndex(): int
+ {
+ return $this->sheetIndex;
+ }
+
+ /**
+ * Set sheet index.
+ *
+ * @param int $sheetIndex Sheet index
+ *
+ * @return $this
+ */
+ public function setSheetIndex(int $sheetIndex): static
+ {
+ $this->sheetIndex = $sheetIndex;
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls.php
new file mode 100644
index 00000000..a6b4fb1c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls.php
@@ -0,0 +1,7645 @@
+ 0x00,
+ Border::BORDER_THIN, // => 0x01,
+ Border::BORDER_MEDIUM, // => 0x02,
+ Border::BORDER_DASHED, // => 0x03,
+ Border::BORDER_DOTTED, // => 0x04,
+ Border::BORDER_THICK, // => 0x05,
+ Border::BORDER_DOUBLE, // => 0x06,
+ Border::BORDER_HAIR, // => 0x07,
+ Border::BORDER_MEDIUMDASHED, // => 0x08,
+ Border::BORDER_DASHDOT, // => 0x09,
+ Border::BORDER_MEDIUMDASHDOT, // => 0x0A,
+ Border::BORDER_DASHDOTDOT, // => 0x0B,
+ Border::BORDER_MEDIUMDASHDOTDOT, // => 0x0C,
+ Border::BORDER_SLANTDASHDOT, // => 0x0D,
+ Border::BORDER_OMIT, // => 0x0E,
+ Border::BORDER_OMIT, // => 0x0F,
+ ];
+
+ /**
+ * Summary Information stream data.
+ */
+ private ?string $summaryInformation = null;
+
+ /**
+ * Extended Summary Information stream data.
+ */
+ private ?string $documentSummaryInformation = null;
+
+ /**
+ * Workbook stream data. (Includes workbook globals substream as well as sheet substreams).
+ */
+ private string $data;
+
+ /**
+ * Size in bytes of $this->data.
+ */
+ private int $dataSize;
+
+ /**
+ * Current position in stream.
+ */
+ private int $pos;
+
+ /**
+ * Workbook to be returned by the reader.
+ */
+ private Spreadsheet $spreadsheet;
+
+ /**
+ * Worksheet that is currently being built by the reader.
+ */
+ private Worksheet $phpSheet;
+
+ /**
+ * BIFF version.
+ */
+ private int $version = 0;
+
+ /**
+ * Codepage set in the Excel file being read. Only important for BIFF5 (Excel 5.0 - Excel 95)
+ * For BIFF8 (Excel 97 - Excel 2003) this will always have the value 'UTF-16LE'.
+ */
+ private string $codepage = '';
+
+ /**
+ * Shared formats.
+ */
+ private array $formats;
+
+ /**
+ * Shared fonts.
+ *
+ * @var Font[]
+ */
+ private array $objFonts;
+
+ /**
+ * Color palette.
+ */
+ private array $palette;
+
+ /**
+ * Worksheets.
+ */
+ private array $sheets;
+
+ /**
+ * External books.
+ */
+ private array $externalBooks;
+
+ /**
+ * REF structures. Only applies to BIFF8.
+ */
+ private array $ref;
+
+ /**
+ * External names.
+ */
+ private array $externalNames;
+
+ /**
+ * Defined names.
+ */
+ private array $definedname;
+
+ /**
+ * Shared strings. Only applies to BIFF8.
+ */
+ private array $sst;
+
+ /**
+ * Panes are frozen? (in sheet currently being read). See WINDOW2 record.
+ */
+ private bool $frozen;
+
+ /**
+ * Fit printout to number of pages? (in sheet currently being read). See SHEETPR record.
+ */
+ private bool $isFitToPages;
+
+ /**
+ * Objects. One OBJ record contributes with one entry.
+ */
+ private array $objs;
+
+ /**
+ * Text Objects. One TXO record corresponds with one entry.
+ */
+ private array $textObjects;
+
+ /**
+ * Cell Annotations (BIFF8).
+ */
+ private array $cellNotes;
+
+ /**
+ * The combined MSODRAWINGGROUP data.
+ */
+ private string $drawingGroupData;
+
+ /**
+ * The combined MSODRAWING data (per sheet).
+ */
+ private string $drawingData;
+
+ /**
+ * Keep track of XF index.
+ */
+ private int $xfIndex;
+
+ /**
+ * Mapping of XF index (that is a cell XF) to final index in cellXf collection.
+ */
+ private array $mapCellXfIndex;
+
+ /**
+ * Mapping of XF index (that is a style XF) to final index in cellStyleXf collection.
+ */
+ private array $mapCellStyleXfIndex;
+
+ /**
+ * The shared formulas in a sheet. One SHAREDFMLA record contributes with one value.
+ */
+ private array $sharedFormulas;
+
+ /**
+ * The shared formula parts in a sheet. One FORMULA record contributes with one value if it
+ * refers to a shared formula.
+ */
+ private array $sharedFormulaParts;
+
+ /**
+ * The type of encryption in use.
+ */
+ private int $encryption = 0;
+
+ /**
+ * The position in the stream after which contents are encrypted.
+ */
+ private int $encryptionStartPos = 0;
+
+ /**
+ * The current RC4 decryption object.
+ */
+ private ?Xls\RC4 $rc4Key = null;
+
+ /**
+ * The position in the stream that the RC4 decryption object was left at.
+ */
+ private int $rc4Pos = 0;
+
+ /**
+ * The current MD5 context state.
+ * It is never set in the program, so code which uses it is suspect.
+ */
+ private string $md5Ctxt; // @phpstan-ignore-line
+
+ private int $textObjRef;
+
+ private string $baseCell;
+
+ private bool $activeSheetSet = false;
+
+ /**
+ * Create a new Xls Reader instance.
+ */
+ public function __construct()
+ {
+ parent::__construct();
+ }
+
+ /**
+ * Can the current IReader read the file?
+ */
+ public function canRead(string $filename): bool
+ {
+ if (File::testFileNoThrow($filename) === false) {
+ return false;
+ }
+
+ try {
+ // Use ParseXL for the hard work.
+ $ole = new OLERead();
+
+ // get excel data
+ $ole->read($filename);
+ if ($ole->wrkbook === null) {
+ throw new Exception('The filename ' . $filename . ' is not recognised as a Spreadsheet file');
+ }
+
+ return true;
+ } catch (PhpSpreadsheetException) {
+ return false;
+ }
+ }
+
+ public function setCodepage(string $codepage): void
+ {
+ if (CodePage::validate($codepage) === false) {
+ throw new PhpSpreadsheetException('Unknown codepage: ' . $codepage);
+ }
+
+ $this->codepage = $codepage;
+ }
+
+ public function getCodepage(): string
+ {
+ return $this->codepage;
+ }
+
+ /**
+ * Reads names of the worksheets from a file, without parsing the whole file to a PhpSpreadsheet object.
+ */
+ public function listWorksheetNames(string $filename): array
+ {
+ File::assertFile($filename);
+
+ $worksheetNames = [];
+
+ // Read the OLE file
+ $this->loadOLE($filename);
+
+ // total byte size of Excel data (workbook global substream + sheet substreams)
+ $this->dataSize = strlen($this->data);
+
+ $this->pos = 0;
+ $this->sheets = [];
+
+ // Parse Workbook Global Substream
+ while ($this->pos < $this->dataSize) {
+ $code = self::getUInt2d($this->data, $this->pos);
+
+ match ($code) {
+ self::XLS_TYPE_BOF => $this->readBof(),
+ self::XLS_TYPE_SHEET => $this->readSheet(),
+ self::XLS_TYPE_EOF => $this->readDefault(),
+ self::XLS_TYPE_CODEPAGE => $this->readCodepage(),
+ default => $this->readDefault(),
+ };
+
+ if ($code === self::XLS_TYPE_EOF) {
+ break;
+ }
+ }
+
+ foreach ($this->sheets as $sheet) {
+ if ($sheet['sheetType'] != 0x00) {
+ // 0x00: Worksheet, 0x02: Chart, 0x06: Visual Basic module
+ continue;
+ }
+
+ $worksheetNames[] = $sheet['name'];
+ }
+
+ return $worksheetNames;
+ }
+
+ /**
+ * Return worksheet info (Name, Last Column Letter, Last Column Index, Total Rows, Total Columns).
+ */
+ public function listWorksheetInfo(string $filename): array
+ {
+ File::assertFile($filename);
+
+ $worksheetInfo = [];
+
+ // Read the OLE file
+ $this->loadOLE($filename);
+
+ // total byte size of Excel data (workbook global substream + sheet substreams)
+ $this->dataSize = strlen($this->data);
+
+ // initialize
+ $this->pos = 0;
+ $this->sheets = [];
+
+ // Parse Workbook Global Substream
+ while ($this->pos < $this->dataSize) {
+ $code = self::getUInt2d($this->data, $this->pos);
+
+ match ($code) {
+ self::XLS_TYPE_BOF => $this->readBof(),
+ self::XLS_TYPE_SHEET => $this->readSheet(),
+ self::XLS_TYPE_EOF => $this->readDefault(),
+ self::XLS_TYPE_CODEPAGE => $this->readCodepage(),
+ default => $this->readDefault(),
+ };
+
+ if ($code === self::XLS_TYPE_EOF) {
+ break;
+ }
+ }
+
+ // Parse the individual sheets
+ foreach ($this->sheets as $sheet) {
+ if ($sheet['sheetType'] != 0x00) {
+ // 0x00: Worksheet
+ // 0x02: Chart
+ // 0x06: Visual Basic module
+ continue;
+ }
+
+ $tmpInfo = [];
+ $tmpInfo['worksheetName'] = $sheet['name'];
+ $tmpInfo['lastColumnLetter'] = 'A';
+ $tmpInfo['lastColumnIndex'] = 0;
+ $tmpInfo['totalRows'] = 0;
+ $tmpInfo['totalColumns'] = 0;
+
+ $this->pos = $sheet['offset'];
+
+ while ($this->pos <= $this->dataSize - 4) {
+ $code = self::getUInt2d($this->data, $this->pos);
+
+ switch ($code) {
+ case self::XLS_TYPE_RK:
+ case self::XLS_TYPE_LABELSST:
+ case self::XLS_TYPE_NUMBER:
+ case self::XLS_TYPE_FORMULA:
+ case self::XLS_TYPE_BOOLERR:
+ case self::XLS_TYPE_LABEL:
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ $rowIndex = self::getUInt2d($recordData, 0) + 1;
+ $columnIndex = self::getUInt2d($recordData, 2);
+
+ $tmpInfo['totalRows'] = max($tmpInfo['totalRows'], $rowIndex);
+ $tmpInfo['lastColumnIndex'] = max($tmpInfo['lastColumnIndex'], $columnIndex);
+
+ break;
+ case self::XLS_TYPE_BOF:
+ $this->readBof();
+
+ break;
+ case self::XLS_TYPE_EOF:
+ $this->readDefault();
+
+ break 2;
+ default:
+ $this->readDefault();
+
+ break;
+ }
+ }
+
+ $tmpInfo['lastColumnLetter'] = Coordinate::stringFromColumnIndex($tmpInfo['lastColumnIndex'] + 1);
+ $tmpInfo['totalColumns'] = $tmpInfo['lastColumnIndex'] + 1;
+
+ $worksheetInfo[] = $tmpInfo;
+ }
+
+ return $worksheetInfo;
+ }
+
+ /**
+ * Loads PhpSpreadsheet from file.
+ */
+ protected function loadSpreadsheetFromFile(string $filename): Spreadsheet
+ {
+ // Read the OLE file
+ $this->loadOLE($filename);
+
+ // Initialisations
+ $this->spreadsheet = new Spreadsheet();
+ $this->spreadsheet->removeSheetByIndex(0); // remove 1st sheet
+ if (!$this->readDataOnly) {
+ $this->spreadsheet->removeCellStyleXfByIndex(0); // remove the default style
+ $this->spreadsheet->removeCellXfByIndex(0); // remove the default style
+ }
+
+ // Read the summary information stream (containing meta data)
+ $this->readSummaryInformation();
+
+ // Read the Additional document summary information stream (containing application-specific meta data)
+ $this->readDocumentSummaryInformation();
+
+ // total byte size of Excel data (workbook global substream + sheet substreams)
+ $this->dataSize = strlen($this->data);
+
+ // initialize
+ $this->pos = 0;
+ $this->codepage = $this->codepage ?: CodePage::DEFAULT_CODE_PAGE;
+ $this->formats = [];
+ $this->objFonts = [];
+ $this->palette = [];
+ $this->sheets = [];
+ $this->externalBooks = [];
+ $this->ref = [];
+ $this->definedname = [];
+ $this->sst = [];
+ $this->drawingGroupData = '';
+ $this->xfIndex = 0;
+ $this->mapCellXfIndex = [];
+ $this->mapCellStyleXfIndex = [];
+
+ // Parse Workbook Global Substream
+ while ($this->pos < $this->dataSize) {
+ $code = self::getUInt2d($this->data, $this->pos);
+
+ match ($code) {
+ self::XLS_TYPE_BOF => $this->readBof(),
+ self::XLS_TYPE_FILEPASS => $this->readFilepass(),
+ self::XLS_TYPE_CODEPAGE => $this->readCodepage(),
+ self::XLS_TYPE_DATEMODE => $this->readDateMode(),
+ self::XLS_TYPE_FONT => $this->readFont(),
+ self::XLS_TYPE_FORMAT => $this->readFormat(),
+ self::XLS_TYPE_XF => $this->readXf(),
+ self::XLS_TYPE_XFEXT => $this->readXfExt(),
+ self::XLS_TYPE_STYLE => $this->readStyle(),
+ self::XLS_TYPE_PALETTE => $this->readPalette(),
+ self::XLS_TYPE_SHEET => $this->readSheet(),
+ self::XLS_TYPE_EXTERNALBOOK => $this->readExternalBook(),
+ self::XLS_TYPE_EXTERNNAME => $this->readExternName(),
+ self::XLS_TYPE_EXTERNSHEET => $this->readExternSheet(),
+ self::XLS_TYPE_DEFINEDNAME => $this->readDefinedName(),
+ self::XLS_TYPE_MSODRAWINGGROUP => $this->readMsoDrawingGroup(),
+ self::XLS_TYPE_SST => $this->readSst(),
+ self::XLS_TYPE_EOF => $this->readDefault(),
+ default => $this->readDefault(),
+ };
+
+ if ($code === self::XLS_TYPE_EOF) {
+ break;
+ }
+ }
+
+ // Resolve indexed colors for font, fill, and border colors
+ // Cannot be resolved already in XF record, because PALETTE record comes afterwards
+ if (!$this->readDataOnly) {
+ foreach ($this->objFonts as $objFont) {
+ if (isset($objFont->colorIndex)) {
+ $color = Xls\Color::map($objFont->colorIndex, $this->palette, $this->version);
+ $objFont->getColor()->setRGB($color['rgb']);
+ }
+ }
+
+ foreach ($this->spreadsheet->getCellXfCollection() as $objStyle) {
+ // fill start and end color
+ $fill = $objStyle->getFill();
+
+ if (isset($fill->startcolorIndex)) {
+ $startColor = Xls\Color::map($fill->startcolorIndex, $this->palette, $this->version);
+ $fill->getStartColor()->setRGB($startColor['rgb']);
+ }
+ if (isset($fill->endcolorIndex)) {
+ $endColor = Xls\Color::map($fill->endcolorIndex, $this->palette, $this->version);
+ $fill->getEndColor()->setRGB($endColor['rgb']);
+ }
+
+ // border colors
+ $top = $objStyle->getBorders()->getTop();
+ $right = $objStyle->getBorders()->getRight();
+ $bottom = $objStyle->getBorders()->getBottom();
+ $left = $objStyle->getBorders()->getLeft();
+ $diagonal = $objStyle->getBorders()->getDiagonal();
+
+ if (isset($top->colorIndex)) {
+ $borderTopColor = Xls\Color::map($top->colorIndex, $this->palette, $this->version);
+ $top->getColor()->setRGB($borderTopColor['rgb']);
+ }
+ if (isset($right->colorIndex)) {
+ $borderRightColor = Xls\Color::map($right->colorIndex, $this->palette, $this->version);
+ $right->getColor()->setRGB($borderRightColor['rgb']);
+ }
+ if (isset($bottom->colorIndex)) {
+ $borderBottomColor = Xls\Color::map($bottom->colorIndex, $this->palette, $this->version);
+ $bottom->getColor()->setRGB($borderBottomColor['rgb']);
+ }
+ if (isset($left->colorIndex)) {
+ $borderLeftColor = Xls\Color::map($left->colorIndex, $this->palette, $this->version);
+ $left->getColor()->setRGB($borderLeftColor['rgb']);
+ }
+ if (isset($diagonal->colorIndex)) {
+ $borderDiagonalColor = Xls\Color::map($diagonal->colorIndex, $this->palette, $this->version);
+ $diagonal->getColor()->setRGB($borderDiagonalColor['rgb']);
+ }
+ }
+ }
+
+ // treat MSODRAWINGGROUP records, workbook-level Escher
+ $escherWorkbook = null;
+ if (!$this->readDataOnly && $this->drawingGroupData) {
+ $escher = new Escher();
+ $reader = new Xls\Escher($escher);
+ $escherWorkbook = $reader->load($this->drawingGroupData);
+ }
+
+ // Parse the individual sheets
+ $this->activeSheetSet = false;
+ foreach ($this->sheets as $sheet) {
+ $selectedCells = '';
+ if ($sheet['sheetType'] != 0x00) {
+ // 0x00: Worksheet, 0x02: Chart, 0x06: Visual Basic module
+ continue;
+ }
+
+ // check if sheet should be skipped
+ if (isset($this->loadSheetsOnly) && !in_array($sheet['name'], $this->loadSheetsOnly)) {
+ continue;
+ }
+
+ // add sheet to PhpSpreadsheet object
+ $this->phpSheet = $this->spreadsheet->createSheet();
+ // Use false for $updateFormulaCellReferences to prevent adjustment of worksheet references in formula
+ // cells... during the load, all formulae should be correct, and we're simply bringing the worksheet
+ // name in line with the formula, not the reverse
+ $this->phpSheet->setTitle($sheet['name'], false, false);
+ $this->phpSheet->setSheetState($sheet['sheetState']);
+
+ $this->pos = $sheet['offset'];
+
+ // Initialize isFitToPages. May change after reading SHEETPR record.
+ $this->isFitToPages = false;
+
+ // Initialize drawingData
+ $this->drawingData = '';
+
+ // Initialize objs
+ $this->objs = [];
+
+ // Initialize shared formula parts
+ $this->sharedFormulaParts = [];
+
+ // Initialize shared formulas
+ $this->sharedFormulas = [];
+
+ // Initialize text objs
+ $this->textObjects = [];
+
+ // Initialize cell annotations
+ $this->cellNotes = [];
+ $this->textObjRef = -1;
+
+ while ($this->pos <= $this->dataSize - 4) {
+ $code = self::getUInt2d($this->data, $this->pos);
+
+ switch ($code) {
+ case self::XLS_TYPE_BOF:
+ $this->readBof();
+
+ break;
+ case self::XLS_TYPE_PRINTGRIDLINES:
+ $this->readPrintGridlines();
+
+ break;
+ case self::XLS_TYPE_DEFAULTROWHEIGHT:
+ $this->readDefaultRowHeight();
+
+ break;
+ case self::XLS_TYPE_SHEETPR:
+ $this->readSheetPr();
+
+ break;
+ case self::XLS_TYPE_HORIZONTALPAGEBREAKS:
+ $this->readHorizontalPageBreaks();
+
+ break;
+ case self::XLS_TYPE_VERTICALPAGEBREAKS:
+ $this->readVerticalPageBreaks();
+
+ break;
+ case self::XLS_TYPE_HEADER:
+ $this->readHeader();
+
+ break;
+ case self::XLS_TYPE_FOOTER:
+ $this->readFooter();
+
+ break;
+ case self::XLS_TYPE_HCENTER:
+ $this->readHcenter();
+
+ break;
+ case self::XLS_TYPE_VCENTER:
+ $this->readVcenter();
+
+ break;
+ case self::XLS_TYPE_LEFTMARGIN:
+ $this->readLeftMargin();
+
+ break;
+ case self::XLS_TYPE_RIGHTMARGIN:
+ $this->readRightMargin();
+
+ break;
+ case self::XLS_TYPE_TOPMARGIN:
+ $this->readTopMargin();
+
+ break;
+ case self::XLS_TYPE_BOTTOMMARGIN:
+ $this->readBottomMargin();
+
+ break;
+ case self::XLS_TYPE_PAGESETUP:
+ $this->readPageSetup();
+
+ break;
+ case self::XLS_TYPE_PROTECT:
+ $this->readProtect();
+
+ break;
+ case self::XLS_TYPE_SCENPROTECT:
+ $this->readScenProtect();
+
+ break;
+ case self::XLS_TYPE_OBJECTPROTECT:
+ $this->readObjectProtect();
+
+ break;
+ case self::XLS_TYPE_PASSWORD:
+ $this->readPassword();
+
+ break;
+ case self::XLS_TYPE_DEFCOLWIDTH:
+ $this->readDefColWidth();
+
+ break;
+ case self::XLS_TYPE_COLINFO:
+ $this->readColInfo();
+
+ break;
+ case self::XLS_TYPE_DIMENSION:
+ $this->readDefault();
+
+ break;
+ case self::XLS_TYPE_ROW:
+ $this->readRow();
+
+ break;
+ case self::XLS_TYPE_DBCELL:
+ $this->readDefault();
+
+ break;
+ case self::XLS_TYPE_RK:
+ $this->readRk();
+
+ break;
+ case self::XLS_TYPE_LABELSST:
+ $this->readLabelSst();
+
+ break;
+ case self::XLS_TYPE_MULRK:
+ $this->readMulRk();
+
+ break;
+ case self::XLS_TYPE_NUMBER:
+ $this->readNumber();
+
+ break;
+ case self::XLS_TYPE_FORMULA:
+ $this->readFormula();
+
+ break;
+ case self::XLS_TYPE_SHAREDFMLA:
+ $this->readSharedFmla();
+
+ break;
+ case self::XLS_TYPE_BOOLERR:
+ $this->readBoolErr();
+
+ break;
+ case self::XLS_TYPE_MULBLANK:
+ $this->readMulBlank();
+
+ break;
+ case self::XLS_TYPE_LABEL:
+ $this->readLabel();
+
+ break;
+ case self::XLS_TYPE_BLANK:
+ $this->readBlank();
+
+ break;
+ case self::XLS_TYPE_MSODRAWING:
+ $this->readMsoDrawing();
+
+ break;
+ case self::XLS_TYPE_OBJ:
+ $this->readObj();
+
+ break;
+ case self::XLS_TYPE_WINDOW2:
+ $this->readWindow2();
+
+ break;
+ case self::XLS_TYPE_PAGELAYOUTVIEW:
+ $this->readPageLayoutView();
+
+ break;
+ case self::XLS_TYPE_SCL:
+ $this->readScl();
+
+ break;
+ case self::XLS_TYPE_PANE:
+ $this->readPane();
+
+ break;
+ case self::XLS_TYPE_SELECTION:
+ $selectedCells = $this->readSelection();
+
+ break;
+ case self::XLS_TYPE_MERGEDCELLS:
+ $this->readMergedCells();
+
+ break;
+ case self::XLS_TYPE_HYPERLINK:
+ $this->readHyperLink();
+
+ break;
+ case self::XLS_TYPE_DATAVALIDATIONS:
+ $this->readDataValidations();
+
+ break;
+ case self::XLS_TYPE_DATAVALIDATION:
+ $this->readDataValidation();
+
+ break;
+ case self::XLS_TYPE_CFHEADER:
+ $cellRangeAddresses = $this->readCFHeader();
+
+ break;
+ case self::XLS_TYPE_CFRULE:
+ $this->readCFRule($cellRangeAddresses ?? []);
+
+ break;
+ case self::XLS_TYPE_SHEETLAYOUT:
+ $this->readSheetLayout();
+
+ break;
+ case self::XLS_TYPE_SHEETPROTECTION:
+ $this->readSheetProtection();
+
+ break;
+ case self::XLS_TYPE_RANGEPROTECTION:
+ $this->readRangeProtection();
+
+ break;
+ case self::XLS_TYPE_NOTE:
+ $this->readNote();
+
+ break;
+ case self::XLS_TYPE_TXO:
+ $this->readTextObject();
+
+ break;
+ case self::XLS_TYPE_CONTINUE:
+ $this->readContinue();
+
+ break;
+ case self::XLS_TYPE_EOF:
+ $this->readDefault();
+
+ break 2;
+ default:
+ $this->readDefault();
+
+ break;
+ }
+ }
+
+ // treat MSODRAWING records, sheet-level Escher
+ if (!$this->readDataOnly && $this->drawingData) {
+ $escherWorksheet = new Escher();
+ $reader = new Xls\Escher($escherWorksheet);
+ $escherWorksheet = $reader->load($this->drawingData);
+
+ // get all spContainers in one long array, so they can be mapped to OBJ records
+ /** @var SpContainer[] $allSpContainers */
+ $allSpContainers = method_exists($escherWorksheet, 'getDgContainer') ? $escherWorksheet->getDgContainer()->getSpgrContainer()->getAllSpContainers() : [];
+ }
+
+ // treat OBJ records
+ foreach ($this->objs as $n => $obj) {
+ // the first shape container never has a corresponding OBJ record, hence $n + 1
+ if (isset($allSpContainers[$n + 1])) {
+ $spContainer = $allSpContainers[$n + 1];
+
+ // we skip all spContainers that are a part of a group shape since we cannot yet handle those
+ if ($spContainer->getNestingLevel() > 1) {
+ continue;
+ }
+
+ // calculate the width and height of the shape
+ /** @var int $startRow */
+ [$startColumn, $startRow] = Coordinate::coordinateFromString($spContainer->getStartCoordinates());
+ /** @var int $endRow */
+ [$endColumn, $endRow] = Coordinate::coordinateFromString($spContainer->getEndCoordinates());
+
+ $startOffsetX = $spContainer->getStartOffsetX();
+ $startOffsetY = $spContainer->getStartOffsetY();
+ $endOffsetX = $spContainer->getEndOffsetX();
+ $endOffsetY = $spContainer->getEndOffsetY();
+
+ $width = SharedXls::getDistanceX($this->phpSheet, $startColumn, $startOffsetX, $endColumn, $endOffsetX);
+ $height = SharedXls::getDistanceY($this->phpSheet, $startRow, $startOffsetY, $endRow, $endOffsetY);
+
+ // calculate offsetX and offsetY of the shape
+ $offsetX = (int) ($startOffsetX * SharedXls::sizeCol($this->phpSheet, $startColumn) / 1024);
+ $offsetY = (int) ($startOffsetY * SharedXls::sizeRow($this->phpSheet, $startRow) / 256);
+
+ switch ($obj['otObjType']) {
+ case 0x19:
+ // Note
+ if (isset($this->cellNotes[$obj['idObjID']])) {
+ //$cellNote = $this->cellNotes[$obj['idObjID']];
+
+ if (isset($this->textObjects[$obj['idObjID']])) {
+ $textObject = $this->textObjects[$obj['idObjID']];
+ $this->cellNotes[$obj['idObjID']]['objTextData'] = $textObject;
+ }
+ }
+
+ break;
+ case 0x08:
+ // picture
+ // get index to BSE entry (1-based)
+ $BSEindex = $spContainer->getOPT(0x0104);
+
+ // If there is no BSE Index, we will fail here and other fields are not read.
+ // Fix by checking here.
+ // TODO: Why is there no BSE Index? Is this a new Office Version? Password protected field?
+ // More likely : a uncompatible picture
+ if (!$BSEindex) {
+ continue 2;
+ }
+
+ if ($escherWorkbook) {
+ $BSECollection = method_exists($escherWorkbook, 'getDggContainer') ? $escherWorkbook->getDggContainer()->getBstoreContainer()->getBSECollection() : [];
+ $BSE = $BSECollection[$BSEindex - 1];
+ $blipType = $BSE->getBlipType();
+
+ // need check because some blip types are not supported by Escher reader such as EMF
+ if ($blip = $BSE->getBlip()) {
+ $ih = imagecreatefromstring($blip->getData());
+ if ($ih !== false) {
+ $drawing = new MemoryDrawing();
+ $drawing->setImageResource($ih);
+
+ // width, height, offsetX, offsetY
+ $drawing->setResizeProportional(false);
+ $drawing->setWidth($width);
+ $drawing->setHeight($height);
+ $drawing->setOffsetX($offsetX);
+ $drawing->setOffsetY($offsetY);
+
+ switch ($blipType) {
+ case BSE::BLIPTYPE_JPEG:
+ $drawing->setRenderingFunction(MemoryDrawing::RENDERING_JPEG);
+ $drawing->setMimeType(MemoryDrawing::MIMETYPE_JPEG);
+
+ break;
+ case BSE::BLIPTYPE_PNG:
+ imagealphablending($ih, false);
+ imagesavealpha($ih, true);
+ $drawing->setRenderingFunction(MemoryDrawing::RENDERING_PNG);
+ $drawing->setMimeType(MemoryDrawing::MIMETYPE_PNG);
+
+ break;
+ }
+
+ $drawing->setWorksheet($this->phpSheet);
+ $drawing->setCoordinates($spContainer->getStartCoordinates());
+ }
+ }
+ }
+
+ break;
+ default:
+ // other object type
+ break;
+ }
+ }
+ }
+
+ // treat SHAREDFMLA records
+ if ($this->version == self::XLS_BIFF8) {
+ foreach ($this->sharedFormulaParts as $cell => $baseCell) {
+ /** @var int $row */
+ [$column, $row] = Coordinate::coordinateFromString($cell);
+ if (($this->getReadFilter() !== null) && $this->getReadFilter()->readCell($column, $row, $this->phpSheet->getTitle())) {
+ $formula = $this->getFormulaFromStructure($this->sharedFormulas[$baseCell], $cell);
+ $this->phpSheet->getCell($cell)->setValueExplicit('=' . $formula, DataType::TYPE_FORMULA);
+ }
+ }
+ }
+
+ if (!empty($this->cellNotes)) {
+ foreach ($this->cellNotes as $note => $noteDetails) {
+ if (!isset($noteDetails['objTextData'])) {
+ if (isset($this->textObjects[$note])) {
+ $textObject = $this->textObjects[$note];
+ $noteDetails['objTextData'] = $textObject;
+ } else {
+ $noteDetails['objTextData']['text'] = '';
+ }
+ }
+ $cellAddress = str_replace('$', '', $noteDetails['cellRef']);
+ $this->phpSheet->getComment($cellAddress)->setAuthor($noteDetails['author'])->setText($this->parseRichText($noteDetails['objTextData']['text']));
+ }
+ }
+ if ($selectedCells !== '') {
+ $this->phpSheet->setSelectedCells($selectedCells);
+ }
+ }
+ if ($this->activeSheetSet === false) {
+ $this->spreadsheet->setActiveSheetIndex(0);
+ }
+
+ // add the named ranges (defined names)
+ foreach ($this->definedname as $definedName) {
+ if ($definedName['isBuiltInName']) {
+ switch ($definedName['name']) {
+ case pack('C', 0x06):
+ // print area
+ // in general, formula looks like this: Foo!$C$7:$J$66,Bar!$A$1:$IV$2
+ $ranges = explode(',', $definedName['formula']); // FIXME: what if sheetname contains comma?
+
+ $extractedRanges = [];
+ $sheetName = '';
+ /** @var non-empty-string $range */
+ foreach ($ranges as $range) {
+ // $range should look like one of these
+ // Foo!$C$7:$J$66
+ // Bar!$A$1:$IV$2
+ $explodes = Worksheet::extractSheetTitle($range, true);
+ $sheetName = trim($explodes[0], "'");
+ if (!str_contains($explodes[1], ':')) {
+ $explodes[1] = $explodes[1] . ':' . $explodes[1];
+ }
+ $extractedRanges[] = str_replace('$', '', $explodes[1]); // C7:J66
+ }
+ if ($docSheet = $this->spreadsheet->getSheetByName($sheetName)) {
+ $docSheet->getPageSetup()->setPrintArea(implode(',', $extractedRanges)); // C7:J66,A1:IV2
+ }
+
+ break;
+ case pack('C', 0x07):
+ // print titles (repeating rows)
+ // Assuming BIFF8, there are 3 cases
+ // 1. repeating rows
+ // formula looks like this: Sheet!$A$1:$IV$2
+ // rows 1-2 repeat
+ // 2. repeating columns
+ // formula looks like this: Sheet!$A$1:$B$65536
+ // columns A-B repeat
+ // 3. both repeating rows and repeating columns
+ // formula looks like this: Sheet!$A$1:$B$65536,Sheet!$A$1:$IV$2
+ $ranges = explode(',', $definedName['formula']); // FIXME: what if sheetname contains comma?
+ foreach ($ranges as $range) {
+ // $range should look like this one of these
+ // Sheet!$A$1:$B$65536
+ // Sheet!$A$1:$IV$2
+ if (str_contains($range, '!')) {
+ $explodes = Worksheet::extractSheetTitle($range, true);
+ if ($docSheet = $this->spreadsheet->getSheetByName($explodes[0])) {
+ $extractedRange = $explodes[1];
+ $extractedRange = str_replace('$', '', $extractedRange);
+
+ $coordinateStrings = explode(':', $extractedRange);
+ if (count($coordinateStrings) == 2) {
+ [$firstColumn, $firstRow] = Coordinate::coordinateFromString($coordinateStrings[0]);
+ [$lastColumn, $lastRow] = Coordinate::coordinateFromString($coordinateStrings[1]);
+
+ if ($firstColumn == 'A' && $lastColumn == 'IV') {
+ // then we have repeating rows
+ $docSheet->getPageSetup()->setRowsToRepeatAtTop([$firstRow, $lastRow]);
+ } elseif ($firstRow == 1 && $lastRow == 65536) {
+ // then we have repeating columns
+ $docSheet->getPageSetup()->setColumnsToRepeatAtLeft([$firstColumn, $lastColumn]);
+ }
+ }
+ }
+ }
+ }
+
+ break;
+ }
+ } else {
+ // Extract range
+ /** @var non-empty-string $formula */
+ $formula = $definedName['formula'];
+ if (str_contains($formula, '!')) {
+ $explodes = Worksheet::extractSheetTitle($formula, true);
+ if (
+ ($docSheet = $this->spreadsheet->getSheetByName($explodes[0]))
+ || ($docSheet = $this->spreadsheet->getSheetByName(trim($explodes[0], "'")))
+ ) {
+ $extractedRange = $explodes[1];
+
+ $localOnly = ($definedName['scope'] === 0) ? false : true;
+
+ $scope = ($definedName['scope'] === 0) ? null : $this->spreadsheet->getSheetByName($this->sheets[$definedName['scope'] - 1]['name']);
+
+ $this->spreadsheet->addNamedRange(new NamedRange((string) $definedName['name'], $docSheet, $extractedRange, $localOnly, $scope));
+ }
+ }
+ // Named Value
+ // TODO Provide support for named values
+ }
+ }
+ $this->data = '';
+
+ return $this->spreadsheet;
+ }
+
+ /**
+ * Read record data from stream, decrypting as required.
+ *
+ * @param string $data Data stream to read from
+ * @param int $pos Position to start reading from
+ * @param int $len Record data length
+ *
+ * @return string Record data
+ */
+ private function readRecordData(string $data, int $pos, int $len): string
+ {
+ $data = substr($data, $pos, $len);
+
+ // File not encrypted, or record before encryption start point
+ if ($this->encryption == self::MS_BIFF_CRYPTO_NONE || $pos < $this->encryptionStartPos) {
+ return $data;
+ }
+
+ $recordData = '';
+ if ($this->encryption == self::MS_BIFF_CRYPTO_RC4) {
+ $oldBlock = floor($this->rc4Pos / self::REKEY_BLOCK);
+ $block = (int) floor($pos / self::REKEY_BLOCK);
+ $endBlock = (int) floor(($pos + $len) / self::REKEY_BLOCK);
+
+ // Spin an RC4 decryptor to the right spot. If we have a decryptor sitting
+ // at a point earlier in the current block, re-use it as we can save some time.
+ if ($block != $oldBlock || $pos < $this->rc4Pos || !$this->rc4Key) {
+ $this->rc4Key = $this->makeKey($block, $this->md5Ctxt);
+ $step = $pos % self::REKEY_BLOCK;
+ } else {
+ $step = $pos - $this->rc4Pos;
+ }
+ $this->rc4Key->RC4(str_repeat("\0", $step));
+
+ // Decrypt record data (re-keying at the end of every block)
+ while ($block != $endBlock) {
+ $step = self::REKEY_BLOCK - ($pos % self::REKEY_BLOCK);
+ $recordData .= $this->rc4Key->RC4(substr($data, 0, $step));
+ $data = substr($data, $step);
+ $pos += $step;
+ $len -= $step;
+ ++$block;
+ $this->rc4Key = $this->makeKey($block, $this->md5Ctxt);
+ }
+ $recordData .= $this->rc4Key->RC4(substr($data, 0, $len));
+
+ // Keep track of the position of this decryptor.
+ // We'll try and re-use it later if we can to speed things up
+ $this->rc4Pos = $pos + $len;
+ } elseif ($this->encryption == self::MS_BIFF_CRYPTO_XOR) {
+ throw new Exception('XOr encryption not supported');
+ }
+
+ return $recordData;
+ }
+
+ /**
+ * Use OLE reader to extract the relevant data streams from the OLE file.
+ */
+ private function loadOLE(string $filename): void
+ {
+ // OLE reader
+ $ole = new OLERead();
+ // get excel data,
+ $ole->read($filename);
+ // Get workbook data: workbook stream + sheet streams
+ $this->data = $ole->getStream($ole->wrkbook); // @phpstan-ignore-line
+ // Get summary information data
+ $this->summaryInformation = $ole->getStream($ole->summaryInformation);
+ // Get additional document summary information data
+ $this->documentSummaryInformation = $ole->getStream($ole->documentSummaryInformation);
+ }
+
+ /**
+ * Read summary information.
+ */
+ private function readSummaryInformation(): void
+ {
+ if (!isset($this->summaryInformation)) {
+ return;
+ }
+
+ // offset: 0; size: 2; must be 0xFE 0xFF (UTF-16 LE byte order mark)
+ // offset: 2; size: 2;
+ // offset: 4; size: 2; OS version
+ // offset: 6; size: 2; OS indicator
+ // offset: 8; size: 16
+ // offset: 24; size: 4; section count
+ //$secCount = self::getInt4d($this->summaryInformation, 24);
+
+ // offset: 28; size: 16; first section's class id: e0 85 9f f2 f9 4f 68 10 ab 91 08 00 2b 27 b3 d9
+ // offset: 44; size: 4
+ $secOffset = self::getInt4d($this->summaryInformation, 44);
+
+ // section header
+ // offset: $secOffset; size: 4; section length
+ //$secLength = self::getInt4d($this->summaryInformation, $secOffset);
+
+ // offset: $secOffset+4; size: 4; property count
+ $countProperties = self::getInt4d($this->summaryInformation, $secOffset + 4);
+
+ // initialize code page (used to resolve string values)
+ $codePage = 'CP1252';
+
+ // offset: ($secOffset+8); size: var
+ // loop through property decarations and properties
+ for ($i = 0; $i < $countProperties; ++$i) {
+ // offset: ($secOffset+8) + (8 * $i); size: 4; property ID
+ $id = self::getInt4d($this->summaryInformation, ($secOffset + 8) + (8 * $i));
+
+ // Use value of property id as appropriate
+ // offset: ($secOffset+12) + (8 * $i); size: 4; offset from beginning of section (48)
+ $offset = self::getInt4d($this->summaryInformation, ($secOffset + 12) + (8 * $i));
+
+ $type = self::getInt4d($this->summaryInformation, $secOffset + $offset);
+
+ // initialize property value
+ $value = null;
+
+ // extract property value based on property type
+ switch ($type) {
+ case 0x02: // 2 byte signed integer
+ $value = self::getUInt2d($this->summaryInformation, $secOffset + 4 + $offset);
+
+ break;
+ case 0x03: // 4 byte signed integer
+ $value = self::getInt4d($this->summaryInformation, $secOffset + 4 + $offset);
+
+ break;
+ case 0x13: // 4 byte unsigned integer
+ // not needed yet, fix later if necessary
+ break;
+ case 0x1E: // null-terminated string prepended by dword string length
+ $byteLength = self::getInt4d($this->summaryInformation, $secOffset + 4 + $offset);
+ $value = substr($this->summaryInformation, $secOffset + 8 + $offset, $byteLength);
+ $value = StringHelper::convertEncoding($value, 'UTF-8', $codePage);
+ $value = rtrim($value);
+
+ break;
+ case 0x40: // Filetime (64-bit value representing the number of 100-nanosecond intervals since January 1, 1601)
+ // PHP-time
+ $value = OLE::OLE2LocalDate(substr($this->summaryInformation, $secOffset + 4 + $offset, 8));
+
+ break;
+ case 0x47: // Clipboard format
+ // not needed yet, fix later if necessary
+ break;
+ }
+
+ switch ($id) {
+ case 0x01: // Code Page
+ $codePage = CodePage::numberToName((int) $value);
+
+ break;
+ case 0x02: // Title
+ $this->spreadsheet->getProperties()->setTitle("$value");
+
+ break;
+ case 0x03: // Subject
+ $this->spreadsheet->getProperties()->setSubject("$value");
+
+ break;
+ case 0x04: // Author (Creator)
+ $this->spreadsheet->getProperties()->setCreator("$value");
+
+ break;
+ case 0x05: // Keywords
+ $this->spreadsheet->getProperties()->setKeywords("$value");
+
+ break;
+ case 0x06: // Comments (Description)
+ $this->spreadsheet->getProperties()->setDescription("$value");
+
+ break;
+ case 0x07: // Template
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x08: // Last Saved By (LastModifiedBy)
+ $this->spreadsheet->getProperties()->setLastModifiedBy("$value");
+
+ break;
+ case 0x09: // Revision
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x0A: // Total Editing Time
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x0B: // Last Printed
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x0C: // Created Date/Time
+ $this->spreadsheet->getProperties()->setCreated($value);
+
+ break;
+ case 0x0D: // Modified Date/Time
+ $this->spreadsheet->getProperties()->setModified($value);
+
+ break;
+ case 0x0E: // Number of Pages
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x0F: // Number of Words
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x10: // Number of Characters
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x11: // Thumbnail
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x12: // Name of creating application
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x13: // Security
+ // Not supported by PhpSpreadsheet
+ break;
+ }
+ }
+ }
+
+ /**
+ * Read additional document summary information.
+ */
+ private function readDocumentSummaryInformation(): void
+ {
+ if (!isset($this->documentSummaryInformation)) {
+ return;
+ }
+
+ // offset: 0; size: 2; must be 0xFE 0xFF (UTF-16 LE byte order mark)
+ // offset: 2; size: 2;
+ // offset: 4; size: 2; OS version
+ // offset: 6; size: 2; OS indicator
+ // offset: 8; size: 16
+ // offset: 24; size: 4; section count
+ //$secCount = self::getInt4d($this->documentSummaryInformation, 24);
+
+ // offset: 28; size: 16; first section's class id: 02 d5 cd d5 9c 2e 1b 10 93 97 08 00 2b 2c f9 ae
+ // offset: 44; size: 4; first section offset
+ $secOffset = self::getInt4d($this->documentSummaryInformation, 44);
+
+ // section header
+ // offset: $secOffset; size: 4; section length
+ //$secLength = self::getInt4d($this->documentSummaryInformation, $secOffset);
+
+ // offset: $secOffset+4; size: 4; property count
+ $countProperties = self::getInt4d($this->documentSummaryInformation, $secOffset + 4);
+
+ // initialize code page (used to resolve string values)
+ $codePage = 'CP1252';
+
+ // offset: ($secOffset+8); size: var
+ // loop through property decarations and properties
+ for ($i = 0; $i < $countProperties; ++$i) {
+ // offset: ($secOffset+8) + (8 * $i); size: 4; property ID
+ $id = self::getInt4d($this->documentSummaryInformation, ($secOffset + 8) + (8 * $i));
+
+ // Use value of property id as appropriate
+ // offset: 60 + 8 * $i; size: 4; offset from beginning of section (48)
+ $offset = self::getInt4d($this->documentSummaryInformation, ($secOffset + 12) + (8 * $i));
+
+ $type = self::getInt4d($this->documentSummaryInformation, $secOffset + $offset);
+
+ // initialize property value
+ $value = null;
+
+ // extract property value based on property type
+ switch ($type) {
+ case 0x02: // 2 byte signed integer
+ $value = self::getUInt2d($this->documentSummaryInformation, $secOffset + 4 + $offset);
+
+ break;
+ case 0x03: // 4 byte signed integer
+ $value = self::getInt4d($this->documentSummaryInformation, $secOffset + 4 + $offset);
+
+ break;
+ case 0x0B: // Boolean
+ $value = self::getUInt2d($this->documentSummaryInformation, $secOffset + 4 + $offset);
+ $value = ($value == 0 ? false : true);
+
+ break;
+ case 0x13: // 4 byte unsigned integer
+ // not needed yet, fix later if necessary
+ break;
+ case 0x1E: // null-terminated string prepended by dword string length
+ $byteLength = self::getInt4d($this->documentSummaryInformation, $secOffset + 4 + $offset);
+ $value = substr($this->documentSummaryInformation, $secOffset + 8 + $offset, $byteLength);
+ $value = StringHelper::convertEncoding($value, 'UTF-8', $codePage);
+ $value = rtrim($value);
+
+ break;
+ case 0x40: // Filetime (64-bit value representing the number of 100-nanosecond intervals since January 1, 1601)
+ // PHP-Time
+ $value = OLE::OLE2LocalDate(substr($this->documentSummaryInformation, $secOffset + 4 + $offset, 8));
+
+ break;
+ case 0x47: // Clipboard format
+ // not needed yet, fix later if necessary
+ break;
+ }
+
+ switch ($id) {
+ case 0x01: // Code Page
+ $codePage = CodePage::numberToName((int) $value);
+
+ break;
+ case 0x02: // Category
+ $this->spreadsheet->getProperties()->setCategory("$value");
+
+ break;
+ case 0x03: // Presentation Target
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x04: // Bytes
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x05: // Lines
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x06: // Paragraphs
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x07: // Slides
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x08: // Notes
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x09: // Hidden Slides
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x0A: // MM Clips
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x0B: // Scale Crop
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x0C: // Heading Pairs
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x0D: // Titles of Parts
+ // Not supported by PhpSpreadsheet
+ break;
+ case 0x0E: // Manager
+ $this->spreadsheet->getProperties()->setManager("$value");
+
+ break;
+ case 0x0F: // Company
+ $this->spreadsheet->getProperties()->setCompany("$value");
+
+ break;
+ case 0x10: // Links up-to-date
+ // Not supported by PhpSpreadsheet
+ break;
+ }
+ }
+ }
+
+ /**
+ * Reads a general type of BIFF record. Does nothing except for moving stream pointer forward to next record.
+ */
+ private function readDefault(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+ }
+
+ /**
+ * The NOTE record specifies a comment associated with a particular cell. In Excel 95 (BIFF7) and earlier versions,
+ * this record stores a note (cell note). This feature was significantly enhanced in Excel 97.
+ */
+ private function readNote(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->readDataOnly) {
+ return;
+ }
+
+ $cellAddress = $this->readBIFF8CellAddress(substr($recordData, 0, 4));
+ if ($this->version == self::XLS_BIFF8) {
+ $noteObjID = self::getUInt2d($recordData, 6);
+ $noteAuthor = self::readUnicodeStringLong(substr($recordData, 8));
+ $noteAuthor = $noteAuthor['value'];
+ $this->cellNotes[$noteObjID] = [
+ 'cellRef' => $cellAddress,
+ 'objectID' => $noteObjID,
+ 'author' => $noteAuthor,
+ ];
+ } else {
+ $extension = false;
+ if ($cellAddress == '$B$65536') {
+ // If the address row is -1 and the column is 0, (which translates as $B$65536) then this is a continuation
+ // note from the previous cell annotation. We're not yet handling this, so annotations longer than the
+ // max 2048 bytes will probably throw a wobbly.
+ //$row = self::getUInt2d($recordData, 0);
+ $extension = true;
+ $arrayKeys = array_keys($this->phpSheet->getComments());
+ $cellAddress = array_pop($arrayKeys);
+ }
+
+ $cellAddress = str_replace('$', '', (string) $cellAddress);
+ //$noteLength = self::getUInt2d($recordData, 4);
+ $noteText = trim(substr($recordData, 6));
+
+ if ($extension) {
+ // Concatenate this extension with the currently set comment for the cell
+ $comment = $this->phpSheet->getComment($cellAddress);
+ $commentText = $comment->getText()->getPlainText();
+ $comment->setText($this->parseRichText($commentText . $noteText));
+ } else {
+ // Set comment for the cell
+ $this->phpSheet->getComment($cellAddress)->setText($this->parseRichText($noteText));
+// ->setAuthor($author)
+ }
+ }
+ }
+
+ /**
+ * The TEXT Object record contains the text associated with a cell annotation.
+ */
+ private function readTextObject(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->readDataOnly) {
+ return;
+ }
+
+ // recordData consists of an array of subrecords looking like this:
+ // grbit: 2 bytes; Option Flags
+ // rot: 2 bytes; rotation
+ // cchText: 2 bytes; length of the text (in the first continue record)
+ // cbRuns: 2 bytes; length of the formatting (in the second continue record)
+ // followed by the continuation records containing the actual text and formatting
+ $grbitOpts = self::getUInt2d($recordData, 0);
+ $rot = self::getUInt2d($recordData, 2);
+ //$cchText = self::getUInt2d($recordData, 10);
+ $cbRuns = self::getUInt2d($recordData, 12);
+ $text = $this->getSplicedRecordData();
+
+ $textByte = $text['spliceOffsets'][1] - $text['spliceOffsets'][0] - 1;
+ $textStr = substr($text['recordData'], $text['spliceOffsets'][0] + 1, $textByte);
+ // get 1 byte
+ $is16Bit = ord($text['recordData'][0]);
+ // it is possible to use a compressed format,
+ // which omits the high bytes of all characters, if they are all zero
+ if (($is16Bit & 0x01) === 0) {
+ $textStr = StringHelper::ConvertEncoding($textStr, 'UTF-8', 'ISO-8859-1');
+ } else {
+ $textStr = $this->decodeCodepage($textStr);
+ }
+
+ $this->textObjects[$this->textObjRef] = [
+ 'text' => $textStr,
+ 'format' => substr($text['recordData'], $text['spliceOffsets'][1], $cbRuns),
+ 'alignment' => $grbitOpts,
+ 'rotation' => $rot,
+ ];
+ }
+
+ /**
+ * Read BOF.
+ */
+ private function readBof(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = substr($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 2; size: 2; type of the following data
+ $substreamType = self::getUInt2d($recordData, 2);
+
+ switch ($substreamType) {
+ case self::XLS_WORKBOOKGLOBALS:
+ $version = self::getUInt2d($recordData, 0);
+ if (($version != self::XLS_BIFF8) && ($version != self::XLS_BIFF7)) {
+ throw new Exception('Cannot read this Excel file. Version is too old.');
+ }
+ $this->version = $version;
+
+ break;
+ case self::XLS_WORKSHEET:
+ // do not use this version information for anything
+ // it is unreliable (OpenOffice doc, 5.8), use only version information from the global stream
+ break;
+ default:
+ // substream, e.g. chart
+ // just skip the entire substream
+ do {
+ $code = self::getUInt2d($this->data, $this->pos);
+ $this->readDefault();
+ } while ($code != self::XLS_TYPE_EOF && $this->pos < $this->dataSize);
+
+ break;
+ }
+ }
+
+ /**
+ * FILEPASS.
+ *
+ * This record is part of the File Protection Block. It
+ * contains information about the read/write password of the
+ * file. All record contents following this record will be
+ * encrypted.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ *
+ * The decryption functions and objects used from here on in
+ * are based on the source of Spreadsheet-ParseExcel:
+ * https://metacpan.org/release/Spreadsheet-ParseExcel
+ */
+ private function readFilepass(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+
+ if ($length != 54) {
+ throw new Exception('Unexpected file pass record length');
+ }
+
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->verifyPassword('VelvetSweatshop', substr($recordData, 6, 16), substr($recordData, 22, 16), substr($recordData, 38, 16), $this->md5Ctxt)) {
+ throw new Exception('Decryption password incorrect');
+ }
+
+ $this->encryption = self::MS_BIFF_CRYPTO_RC4;
+
+ // Decryption required from the record after next onwards
+ $this->encryptionStartPos = $this->pos + self::getUInt2d($this->data, $this->pos + 2);
+ }
+
+ /**
+ * Make an RC4 decryptor for the given block.
+ *
+ * @param int $block Block for which to create decrypto
+ * @param string $valContext MD5 context state
+ */
+ private function makeKey(int $block, string $valContext): Xls\RC4
+ {
+ $pwarray = str_repeat("\0", 64);
+
+ for ($i = 0; $i < 5; ++$i) {
+ $pwarray[$i] = $valContext[$i];
+ }
+
+ $pwarray[5] = chr($block & 0xFF);
+ $pwarray[6] = chr(($block >> 8) & 0xFF);
+ $pwarray[7] = chr(($block >> 16) & 0xFF);
+ $pwarray[8] = chr(($block >> 24) & 0xFF);
+
+ $pwarray[9] = "\x80";
+ $pwarray[56] = "\x48";
+
+ $md5 = new Xls\MD5();
+ $md5->add($pwarray);
+
+ $s = $md5->getContext();
+
+ return new Xls\RC4($s);
+ }
+
+ /**
+ * Verify RC4 file password.
+ *
+ * @param string $password Password to check
+ * @param string $docid Document id
+ * @param string $salt_data Salt data
+ * @param string $hashedsalt_data Hashed salt data
+ * @param string $valContext Set to the MD5 context of the value
+ *
+ * @return bool Success
+ */
+ private function verifyPassword(string $password, string $docid, string $salt_data, string $hashedsalt_data, string &$valContext): bool
+ {
+ $pwarray = str_repeat("\0", 64);
+
+ $iMax = strlen($password);
+ for ($i = 0; $i < $iMax; ++$i) {
+ $o = ord(substr($password, $i, 1));
+ $pwarray[2 * $i] = chr($o & 0xFF);
+ $pwarray[2 * $i + 1] = chr(($o >> 8) & 0xFF);
+ }
+ $pwarray[2 * $i] = chr(0x80);
+ $pwarray[56] = chr(($i << 4) & 0xFF);
+
+ $md5 = new Xls\MD5();
+ $md5->add($pwarray);
+
+ $mdContext1 = $md5->getContext();
+
+ $offset = 0;
+ $keyoffset = 0;
+ $tocopy = 5;
+
+ $md5->reset();
+
+ while ($offset != 16) {
+ if ((64 - $offset) < 5) {
+ $tocopy = 64 - $offset;
+ }
+ for ($i = 0; $i <= $tocopy; ++$i) {
+ $pwarray[$offset + $i] = $mdContext1[$keyoffset + $i];
+ }
+ $offset += $tocopy;
+
+ if ($offset == 64) {
+ $md5->add($pwarray);
+ $keyoffset = $tocopy;
+ $tocopy = 5 - $tocopy;
+ $offset = 0;
+
+ continue;
+ }
+
+ $keyoffset = 0;
+ $tocopy = 5;
+ for ($i = 0; $i < 16; ++$i) {
+ $pwarray[$offset + $i] = $docid[$i];
+ }
+ $offset += 16;
+ }
+
+ $pwarray[16] = "\x80";
+ for ($i = 0; $i < 47; ++$i) {
+ $pwarray[17 + $i] = "\0";
+ }
+ $pwarray[56] = "\x80";
+ $pwarray[57] = "\x0a";
+
+ $md5->add($pwarray);
+ $valContext = $md5->getContext();
+
+ $key = $this->makeKey(0, $valContext);
+
+ $salt = $key->RC4($salt_data);
+ $hashedsalt = $key->RC4($hashedsalt_data);
+
+ $salt .= "\x80" . str_repeat("\0", 47);
+ $salt[56] = "\x80";
+
+ $md5->reset();
+ $md5->add($salt);
+ $mdContext2 = $md5->getContext();
+
+ return $mdContext2 == $hashedsalt;
+ }
+
+ /**
+ * CODEPAGE.
+ *
+ * This record stores the text encoding used to write byte
+ * strings, stored as MS Windows code page identifier.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readCodepage(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; code page identifier
+ $codepage = self::getUInt2d($recordData, 0);
+
+ $this->codepage = CodePage::numberToName($codepage);
+ }
+
+ /**
+ * DATEMODE.
+ *
+ * This record specifies the base date for displaying date
+ * values. All dates are stored as count of days past this
+ * base date. In BIFF2-BIFF4 this record is part of the
+ * Calculation Settings Block. In BIFF5-BIFF8 it is
+ * stored in the Workbook Globals Substream.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readDateMode(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; 0 = base 1900, 1 = base 1904
+ Date::setExcelCalendar(Date::CALENDAR_WINDOWS_1900);
+ $this->spreadsheet->setExcelCalendar(Date::CALENDAR_WINDOWS_1900);
+ if (ord($recordData[0]) == 1) {
+ Date::setExcelCalendar(Date::CALENDAR_MAC_1904);
+ $this->spreadsheet->setExcelCalendar(Date::CALENDAR_MAC_1904);
+ }
+ }
+
+ /**
+ * Read a FONT record.
+ */
+ private function readFont(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ $objFont = new Font();
+
+ // offset: 0; size: 2; height of the font (in twips = 1/20 of a point)
+ $size = self::getUInt2d($recordData, 0);
+ $objFont->setSize($size / 20);
+
+ // offset: 2; size: 2; option flags
+ // bit: 0; mask 0x0001; bold (redundant in BIFF5-BIFF8)
+ // bit: 1; mask 0x0002; italic
+ $isItalic = (0x0002 & self::getUInt2d($recordData, 2)) >> 1;
+ if ($isItalic) {
+ $objFont->setItalic(true);
+ }
+
+ // bit: 2; mask 0x0004; underlined (redundant in BIFF5-BIFF8)
+ // bit: 3; mask 0x0008; strikethrough
+ $isStrike = (0x0008 & self::getUInt2d($recordData, 2)) >> 3;
+ if ($isStrike) {
+ $objFont->setStrikethrough(true);
+ }
+
+ // offset: 4; size: 2; colour index
+ $colorIndex = self::getUInt2d($recordData, 4);
+ $objFont->colorIndex = $colorIndex;
+
+ // offset: 6; size: 2; font weight
+ $weight = self::getUInt2d($recordData, 6); // regular=400 bold=700
+ if ($weight >= 550) {
+ $objFont->setBold(true);
+ }
+
+ // offset: 8; size: 2; escapement type
+ $escapement = self::getUInt2d($recordData, 8);
+ CellFont::escapement($objFont, $escapement);
+
+ // offset: 10; size: 1; underline type
+ $underlineType = ord($recordData[10]);
+ CellFont::underline($objFont, $underlineType);
+
+ // offset: 11; size: 1; font family
+ // offset: 12; size: 1; character set
+ // offset: 13; size: 1; not used
+ // offset: 14; size: var; font name
+ if ($this->version == self::XLS_BIFF8) {
+ $string = self::readUnicodeStringShort(substr($recordData, 14));
+ } else {
+ $string = $this->readByteStringShort(substr($recordData, 14));
+ }
+ $objFont->setName($string['value']);
+
+ $this->objFonts[] = $objFont;
+ }
+ }
+
+ /**
+ * FORMAT.
+ *
+ * This record contains information about a number format.
+ * All FORMAT records occur together in a sequential list.
+ *
+ * In BIFF2-BIFF4 other records referencing a FORMAT record
+ * contain a zero-based index into this list. From BIFF5 on
+ * the FORMAT record contains the index itself that will be
+ * used by other records.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readFormat(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ $indexCode = self::getUInt2d($recordData, 0);
+
+ if ($this->version == self::XLS_BIFF8) {
+ $string = self::readUnicodeStringLong(substr($recordData, 2));
+ } else {
+ // BIFF7
+ $string = $this->readByteStringShort(substr($recordData, 2));
+ }
+
+ $formatString = $string['value'];
+ // Apache Open Office sets wrong case writing to xls - issue 2239
+ if ($formatString === 'GENERAL') {
+ $formatString = NumberFormat::FORMAT_GENERAL;
+ }
+ $this->formats[$indexCode] = $formatString;
+ }
+ }
+
+ /**
+ * XF - Extended Format.
+ *
+ * This record contains formatting information for cells, rows, columns or styles.
+ * According to https://support.microsoft.com/en-us/help/147732 there are always at least 15 cell style XF
+ * and 1 cell XF.
+ * Inspection of Excel files generated by MS Office Excel shows that XF records 0-14 are cell style XF
+ * and XF record 15 is a cell XF
+ * We only read the first cell style XF and skip the remaining cell style XF records
+ * We read all cell XF records.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readXf(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ $objStyle = new Style();
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 2; Index to FONT record
+ if (self::getUInt2d($recordData, 0) < 4) {
+ $fontIndex = self::getUInt2d($recordData, 0);
+ } else {
+ // this has to do with that index 4 is omitted in all BIFF versions for some strange reason
+ // check the OpenOffice documentation of the FONT record
+ $fontIndex = self::getUInt2d($recordData, 0) - 1;
+ }
+ if (isset($this->objFonts[$fontIndex])) {
+ $objStyle->setFont($this->objFonts[$fontIndex]);
+ }
+
+ // offset: 2; size: 2; Index to FORMAT record
+ $numberFormatIndex = self::getUInt2d($recordData, 2);
+ if (isset($this->formats[$numberFormatIndex])) {
+ // then we have user-defined format code
+ $numberFormat = ['formatCode' => $this->formats[$numberFormatIndex]];
+ } elseif (($code = NumberFormat::builtInFormatCode($numberFormatIndex)) !== '') {
+ // then we have built-in format code
+ $numberFormat = ['formatCode' => $code];
+ } else {
+ // we set the general format code
+ $numberFormat = ['formatCode' => NumberFormat::FORMAT_GENERAL];
+ }
+ $objStyle->getNumberFormat()->setFormatCode($numberFormat['formatCode']);
+
+ // offset: 4; size: 2; XF type, cell protection, and parent style XF
+ // bit 2-0; mask 0x0007; XF_TYPE_PROT
+ $xfTypeProt = self::getUInt2d($recordData, 4);
+ // bit 0; mask 0x01; 1 = cell is locked
+ $isLocked = (0x01 & $xfTypeProt) >> 0;
+ $objStyle->getProtection()->setLocked($isLocked ? Protection::PROTECTION_INHERIT : Protection::PROTECTION_UNPROTECTED);
+
+ // bit 1; mask 0x02; 1 = Formula is hidden
+ $isHidden = (0x02 & $xfTypeProt) >> 1;
+ $objStyle->getProtection()->setHidden($isHidden ? Protection::PROTECTION_PROTECTED : Protection::PROTECTION_UNPROTECTED);
+
+ // bit 2; mask 0x04; 0 = Cell XF, 1 = Cell Style XF
+ $isCellStyleXf = (0x04 & $xfTypeProt) >> 2;
+
+ // offset: 6; size: 1; Alignment and text break
+ // bit 2-0, mask 0x07; horizontal alignment
+ $horAlign = (0x07 & ord($recordData[6])) >> 0;
+ Xls\Style\CellAlignment::horizontal($objStyle->getAlignment(), $horAlign);
+
+ // bit 3, mask 0x08; wrap text
+ $wrapText = (0x08 & ord($recordData[6])) >> 3;
+ Xls\Style\CellAlignment::wrap($objStyle->getAlignment(), $wrapText);
+
+ // bit 6-4, mask 0x70; vertical alignment
+ $vertAlign = (0x70 & ord($recordData[6])) >> 4;
+ Xls\Style\CellAlignment::vertical($objStyle->getAlignment(), $vertAlign);
+
+ if ($this->version == self::XLS_BIFF8) {
+ // offset: 7; size: 1; XF_ROTATION: Text rotation angle
+ $angle = ord($recordData[7]);
+ $rotation = 0;
+ if ($angle <= 90) {
+ $rotation = $angle;
+ } elseif ($angle <= 180) {
+ $rotation = 90 - $angle;
+ } elseif ($angle == Alignment::TEXTROTATION_STACK_EXCEL) {
+ $rotation = Alignment::TEXTROTATION_STACK_PHPSPREADSHEET;
+ }
+ $objStyle->getAlignment()->setTextRotation($rotation);
+
+ // offset: 8; size: 1; Indentation, shrink to cell size, and text direction
+ // bit: 3-0; mask: 0x0F; indent level
+ $indent = (0x0F & ord($recordData[8])) >> 0;
+ $objStyle->getAlignment()->setIndent($indent);
+
+ // bit: 4; mask: 0x10; 1 = shrink content to fit into cell
+ $shrinkToFit = (0x10 & ord($recordData[8])) >> 4;
+ switch ($shrinkToFit) {
+ case 0:
+ $objStyle->getAlignment()->setShrinkToFit(false);
+
+ break;
+ case 1:
+ $objStyle->getAlignment()->setShrinkToFit(true);
+
+ break;
+ }
+
+ // offset: 9; size: 1; Flags used for attribute groups
+
+ // offset: 10; size: 4; Cell border lines and background area
+ // bit: 3-0; mask: 0x0000000F; left style
+ if ($bordersLeftStyle = Xls\Style\Border::lookup((0x0000000F & self::getInt4d($recordData, 10)) >> 0)) {
+ $objStyle->getBorders()->getLeft()->setBorderStyle($bordersLeftStyle);
+ }
+ // bit: 7-4; mask: 0x000000F0; right style
+ if ($bordersRightStyle = Xls\Style\Border::lookup((0x000000F0 & self::getInt4d($recordData, 10)) >> 4)) {
+ $objStyle->getBorders()->getRight()->setBorderStyle($bordersRightStyle);
+ }
+ // bit: 11-8; mask: 0x00000F00; top style
+ if ($bordersTopStyle = Xls\Style\Border::lookup((0x00000F00 & self::getInt4d($recordData, 10)) >> 8)) {
+ $objStyle->getBorders()->getTop()->setBorderStyle($bordersTopStyle);
+ }
+ // bit: 15-12; mask: 0x0000F000; bottom style
+ if ($bordersBottomStyle = Xls\Style\Border::lookup((0x0000F000 & self::getInt4d($recordData, 10)) >> 12)) {
+ $objStyle->getBorders()->getBottom()->setBorderStyle($bordersBottomStyle);
+ }
+ // bit: 22-16; mask: 0x007F0000; left color
+ $objStyle->getBorders()->getLeft()->colorIndex = (0x007F0000 & self::getInt4d($recordData, 10)) >> 16;
+
+ // bit: 29-23; mask: 0x3F800000; right color
+ $objStyle->getBorders()->getRight()->colorIndex = (0x3F800000 & self::getInt4d($recordData, 10)) >> 23;
+
+ // bit: 30; mask: 0x40000000; 1 = diagonal line from top left to right bottom
+ $diagonalDown = (0x40000000 & self::getInt4d($recordData, 10)) >> 30 ? true : false;
+
+ // bit: 31; mask: 0x800000; 1 = diagonal line from bottom left to top right
+ $diagonalUp = (self::HIGH_ORDER_BIT & self::getInt4d($recordData, 10)) >> 31 ? true : false;
+
+ if ($diagonalUp === false) {
+ if ($diagonalDown === false) {
+ $objStyle->getBorders()->setDiagonalDirection(Borders::DIAGONAL_NONE);
+ } else {
+ $objStyle->getBorders()->setDiagonalDirection(Borders::DIAGONAL_DOWN);
+ }
+ } elseif ($diagonalDown === false) {
+ $objStyle->getBorders()->setDiagonalDirection(Borders::DIAGONAL_UP);
+ } else {
+ $objStyle->getBorders()->setDiagonalDirection(Borders::DIAGONAL_BOTH);
+ }
+
+ // offset: 14; size: 4;
+ // bit: 6-0; mask: 0x0000007F; top color
+ $objStyle->getBorders()->getTop()->colorIndex = (0x0000007F & self::getInt4d($recordData, 14)) >> 0;
+
+ // bit: 13-7; mask: 0x00003F80; bottom color
+ $objStyle->getBorders()->getBottom()->colorIndex = (0x00003F80 & self::getInt4d($recordData, 14)) >> 7;
+
+ // bit: 20-14; mask: 0x001FC000; diagonal color
+ $objStyle->getBorders()->getDiagonal()->colorIndex = (0x001FC000 & self::getInt4d($recordData, 14)) >> 14;
+
+ // bit: 24-21; mask: 0x01E00000; diagonal style
+ if ($bordersDiagonalStyle = Xls\Style\Border::lookup((0x01E00000 & self::getInt4d($recordData, 14)) >> 21)) {
+ $objStyle->getBorders()->getDiagonal()->setBorderStyle($bordersDiagonalStyle);
+ }
+
+ // bit: 31-26; mask: 0xFC000000 fill pattern
+ if ($fillType = FillPattern::lookup((self::FC000000 & self::getInt4d($recordData, 14)) >> 26)) {
+ $objStyle->getFill()->setFillType($fillType);
+ }
+ // offset: 18; size: 2; pattern and background colour
+ // bit: 6-0; mask: 0x007F; color index for pattern color
+ $objStyle->getFill()->startcolorIndex = (0x007F & self::getUInt2d($recordData, 18)) >> 0;
+
+ // bit: 13-7; mask: 0x3F80; color index for pattern background
+ $objStyle->getFill()->endcolorIndex = (0x3F80 & self::getUInt2d($recordData, 18)) >> 7;
+ } else {
+ // BIFF5
+
+ // offset: 7; size: 1; Text orientation and flags
+ $orientationAndFlags = ord($recordData[7]);
+
+ // bit: 1-0; mask: 0x03; XF_ORIENTATION: Text orientation
+ $xfOrientation = (0x03 & $orientationAndFlags) >> 0;
+ switch ($xfOrientation) {
+ case 0:
+ $objStyle->getAlignment()->setTextRotation(0);
+
+ break;
+ case 1:
+ $objStyle->getAlignment()->setTextRotation(Alignment::TEXTROTATION_STACK_PHPSPREADSHEET);
+
+ break;
+ case 2:
+ $objStyle->getAlignment()->setTextRotation(90);
+
+ break;
+ case 3:
+ $objStyle->getAlignment()->setTextRotation(-90);
+
+ break;
+ }
+
+ // offset: 8; size: 4; cell border lines and background area
+ $borderAndBackground = self::getInt4d($recordData, 8);
+
+ // bit: 6-0; mask: 0x0000007F; color index for pattern color
+ $objStyle->getFill()->startcolorIndex = (0x0000007F & $borderAndBackground) >> 0;
+
+ // bit: 13-7; mask: 0x00003F80; color index for pattern background
+ $objStyle->getFill()->endcolorIndex = (0x00003F80 & $borderAndBackground) >> 7;
+
+ // bit: 21-16; mask: 0x003F0000; fill pattern
+ $objStyle->getFill()->setFillType(FillPattern::lookup((0x003F0000 & $borderAndBackground) >> 16));
+
+ // bit: 24-22; mask: 0x01C00000; bottom line style
+ $objStyle->getBorders()->getBottom()->setBorderStyle(Xls\Style\Border::lookup((0x01C00000 & $borderAndBackground) >> 22));
+
+ // bit: 31-25; mask: 0xFE000000; bottom line color
+ $objStyle->getBorders()->getBottom()->colorIndex = (self::FE000000 & $borderAndBackground) >> 25;
+
+ // offset: 12; size: 4; cell border lines
+ $borderLines = self::getInt4d($recordData, 12);
+
+ // bit: 2-0; mask: 0x00000007; top line style
+ $objStyle->getBorders()->getTop()->setBorderStyle(Xls\Style\Border::lookup((0x00000007 & $borderLines) >> 0));
+
+ // bit: 5-3; mask: 0x00000038; left line style
+ $objStyle->getBorders()->getLeft()->setBorderStyle(Xls\Style\Border::lookup((0x00000038 & $borderLines) >> 3));
+
+ // bit: 8-6; mask: 0x000001C0; right line style
+ $objStyle->getBorders()->getRight()->setBorderStyle(Xls\Style\Border::lookup((0x000001C0 & $borderLines) >> 6));
+
+ // bit: 15-9; mask: 0x0000FE00; top line color index
+ $objStyle->getBorders()->getTop()->colorIndex = (0x0000FE00 & $borderLines) >> 9;
+
+ // bit: 22-16; mask: 0x007F0000; left line color index
+ $objStyle->getBorders()->getLeft()->colorIndex = (0x007F0000 & $borderLines) >> 16;
+
+ // bit: 29-23; mask: 0x3F800000; right line color index
+ $objStyle->getBorders()->getRight()->colorIndex = (0x3F800000 & $borderLines) >> 23;
+ }
+
+ // add cellStyleXf or cellXf and update mapping
+ if ($isCellStyleXf) {
+ // we only read one style XF record which is always the first
+ if ($this->xfIndex == 0) {
+ $this->spreadsheet->addCellStyleXf($objStyle);
+ $this->mapCellStyleXfIndex[$this->xfIndex] = 0;
+ }
+ } else {
+ // we read all cell XF records
+ $this->spreadsheet->addCellXf($objStyle);
+ $this->mapCellXfIndex[$this->xfIndex] = count($this->spreadsheet->getCellXfCollection()) - 1;
+ }
+
+ // update XF index for when we read next record
+ ++$this->xfIndex;
+ }
+ }
+
+ private function readXfExt(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 2; 0x087D = repeated header
+
+ // offset: 2; size: 2
+
+ // offset: 4; size: 8; not used
+
+ // offset: 12; size: 2; record version
+
+ // offset: 14; size: 2; index to XF record which this record modifies
+ $ixfe = self::getUInt2d($recordData, 14);
+
+ // offset: 16; size: 2; not used
+
+ // offset: 18; size: 2; number of extension properties that follow
+ //$cexts = self::getUInt2d($recordData, 18);
+
+ // start reading the actual extension data
+ $offset = 20;
+ while ($offset < $length) {
+ // extension type
+ $extType = self::getUInt2d($recordData, $offset);
+
+ // extension length
+ $cb = self::getUInt2d($recordData, $offset + 2);
+
+ // extension data
+ $extData = substr($recordData, $offset + 4, $cb);
+
+ switch ($extType) {
+ case 4: // fill start color
+ $xclfType = self::getUInt2d($extData, 0); // color type
+ $xclrValue = substr($extData, 4, 4); // color value (value based on color type)
+
+ if ($xclfType == 2) {
+ $rgb = sprintf('%02X%02X%02X', ord($xclrValue[0]), ord($xclrValue[1]), ord($xclrValue[2]));
+
+ // modify the relevant style property
+ if (isset($this->mapCellXfIndex[$ixfe])) {
+ $fill = $this->spreadsheet->getCellXfByIndex($this->mapCellXfIndex[$ixfe])->getFill();
+ $fill->getStartColor()->setRGB($rgb);
+ $fill->startcolorIndex = null; // normal color index does not apply, discard
+ }
+ }
+
+ break;
+ case 5: // fill end color
+ $xclfType = self::getUInt2d($extData, 0); // color type
+ $xclrValue = substr($extData, 4, 4); // color value (value based on color type)
+
+ if ($xclfType == 2) {
+ $rgb = sprintf('%02X%02X%02X', ord($xclrValue[0]), ord($xclrValue[1]), ord($xclrValue[2]));
+
+ // modify the relevant style property
+ if (isset($this->mapCellXfIndex[$ixfe])) {
+ $fill = $this->spreadsheet->getCellXfByIndex($this->mapCellXfIndex[$ixfe])->getFill();
+ $fill->getEndColor()->setRGB($rgb);
+ $fill->endcolorIndex = null; // normal color index does not apply, discard
+ }
+ }
+
+ break;
+ case 7: // border color top
+ $xclfType = self::getUInt2d($extData, 0); // color type
+ $xclrValue = substr($extData, 4, 4); // color value (value based on color type)
+
+ if ($xclfType == 2) {
+ $rgb = sprintf('%02X%02X%02X', ord($xclrValue[0]), ord($xclrValue[1]), ord($xclrValue[2]));
+
+ // modify the relevant style property
+ if (isset($this->mapCellXfIndex[$ixfe])) {
+ $top = $this->spreadsheet->getCellXfByIndex($this->mapCellXfIndex[$ixfe])->getBorders()->getTop();
+ $top->getColor()->setRGB($rgb);
+ $top->colorIndex = null; // normal color index does not apply, discard
+ }
+ }
+
+ break;
+ case 8: // border color bottom
+ $xclfType = self::getUInt2d($extData, 0); // color type
+ $xclrValue = substr($extData, 4, 4); // color value (value based on color type)
+
+ if ($xclfType == 2) {
+ $rgb = sprintf('%02X%02X%02X', ord($xclrValue[0]), ord($xclrValue[1]), ord($xclrValue[2]));
+
+ // modify the relevant style property
+ if (isset($this->mapCellXfIndex[$ixfe])) {
+ $bottom = $this->spreadsheet->getCellXfByIndex($this->mapCellXfIndex[$ixfe])->getBorders()->getBottom();
+ $bottom->getColor()->setRGB($rgb);
+ $bottom->colorIndex = null; // normal color index does not apply, discard
+ }
+ }
+
+ break;
+ case 9: // border color left
+ $xclfType = self::getUInt2d($extData, 0); // color type
+ $xclrValue = substr($extData, 4, 4); // color value (value based on color type)
+
+ if ($xclfType == 2) {
+ $rgb = sprintf('%02X%02X%02X', ord($xclrValue[0]), ord($xclrValue[1]), ord($xclrValue[2]));
+
+ // modify the relevant style property
+ if (isset($this->mapCellXfIndex[$ixfe])) {
+ $left = $this->spreadsheet->getCellXfByIndex($this->mapCellXfIndex[$ixfe])->getBorders()->getLeft();
+ $left->getColor()->setRGB($rgb);
+ $left->colorIndex = null; // normal color index does not apply, discard
+ }
+ }
+
+ break;
+ case 10: // border color right
+ $xclfType = self::getUInt2d($extData, 0); // color type
+ $xclrValue = substr($extData, 4, 4); // color value (value based on color type)
+
+ if ($xclfType == 2) {
+ $rgb = sprintf('%02X%02X%02X', ord($xclrValue[0]), ord($xclrValue[1]), ord($xclrValue[2]));
+
+ // modify the relevant style property
+ if (isset($this->mapCellXfIndex[$ixfe])) {
+ $right = $this->spreadsheet->getCellXfByIndex($this->mapCellXfIndex[$ixfe])->getBorders()->getRight();
+ $right->getColor()->setRGB($rgb);
+ $right->colorIndex = null; // normal color index does not apply, discard
+ }
+ }
+
+ break;
+ case 11: // border color diagonal
+ $xclfType = self::getUInt2d($extData, 0); // color type
+ $xclrValue = substr($extData, 4, 4); // color value (value based on color type)
+
+ if ($xclfType == 2) {
+ $rgb = sprintf('%02X%02X%02X', ord($xclrValue[0]), ord($xclrValue[1]), ord($xclrValue[2]));
+
+ // modify the relevant style property
+ if (isset($this->mapCellXfIndex[$ixfe])) {
+ $diagonal = $this->spreadsheet->getCellXfByIndex($this->mapCellXfIndex[$ixfe])->getBorders()->getDiagonal();
+ $diagonal->getColor()->setRGB($rgb);
+ $diagonal->colorIndex = null; // normal color index does not apply, discard
+ }
+ }
+
+ break;
+ case 13: // font color
+ $xclfType = self::getUInt2d($extData, 0); // color type
+ $xclrValue = substr($extData, 4, 4); // color value (value based on color type)
+
+ if ($xclfType == 2) {
+ $rgb = sprintf('%02X%02X%02X', ord($xclrValue[0]), ord($xclrValue[1]), ord($xclrValue[2]));
+
+ // modify the relevant style property
+ if (isset($this->mapCellXfIndex[$ixfe])) {
+ $font = $this->spreadsheet->getCellXfByIndex($this->mapCellXfIndex[$ixfe])->getFont();
+ $font->getColor()->setRGB($rgb);
+ $font->colorIndex = null; // normal color index does not apply, discard
+ }
+ }
+
+ break;
+ }
+
+ $offset += $cb;
+ }
+ }
+ }
+
+ /**
+ * Read STYLE record.
+ */
+ private function readStyle(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 2; index to XF record and flag for built-in style
+ $ixfe = self::getUInt2d($recordData, 0);
+
+ // bit: 11-0; mask 0x0FFF; index to XF record
+ //$xfIndex = (0x0FFF & $ixfe) >> 0;
+
+ // bit: 15; mask 0x8000; 0 = user-defined style, 1 = built-in style
+ $isBuiltIn = (bool) ((0x8000 & $ixfe) >> 15);
+
+ if ($isBuiltIn) {
+ // offset: 2; size: 1; identifier for built-in style
+ $builtInId = ord($recordData[2]);
+
+ switch ($builtInId) {
+ case 0x00:
+ // currently, we are not using this for anything
+ break;
+ default:
+ break;
+ }
+ }
+ // user-defined; not supported by PhpSpreadsheet
+ }
+ }
+
+ /**
+ * Read PALETTE record.
+ */
+ private function readPalette(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 2; number of following colors
+ $nm = self::getUInt2d($recordData, 0);
+
+ // list of RGB colors
+ for ($i = 0; $i < $nm; ++$i) {
+ $rgb = substr($recordData, 2 + 4 * $i, 4);
+ $this->palette[] = self::readRGB($rgb);
+ }
+ }
+ }
+
+ /**
+ * SHEET.
+ *
+ * This record is located in the Workbook Globals
+ * Substream and represents a sheet inside the workbook.
+ * One SHEET record is written for each sheet. It stores the
+ * sheet name and a stream offset to the BOF record of the
+ * respective Sheet Substream within the Workbook Stream.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readSheet(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // offset: 0; size: 4; absolute stream position of the BOF record of the sheet
+ // NOTE: not encrypted
+ $rec_offset = self::getInt4d($this->data, $this->pos + 4);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 4; size: 1; sheet state
+ $sheetState = match (ord($recordData[4])) {
+ 0x00 => Worksheet::SHEETSTATE_VISIBLE,
+ 0x01 => Worksheet::SHEETSTATE_HIDDEN,
+ 0x02 => Worksheet::SHEETSTATE_VERYHIDDEN,
+ default => Worksheet::SHEETSTATE_VISIBLE,
+ };
+
+ // offset: 5; size: 1; sheet type
+ $sheetType = ord($recordData[5]);
+
+ // offset: 6; size: var; sheet name
+ $rec_name = null;
+ if ($this->version == self::XLS_BIFF8) {
+ $string = self::readUnicodeStringShort(substr($recordData, 6));
+ $rec_name = $string['value'];
+ } elseif ($this->version == self::XLS_BIFF7) {
+ $string = $this->readByteStringShort(substr($recordData, 6));
+ $rec_name = $string['value'];
+ }
+
+ $this->sheets[] = [
+ 'name' => $rec_name,
+ 'offset' => $rec_offset,
+ 'sheetState' => $sheetState,
+ 'sheetType' => $sheetType,
+ ];
+ }
+
+ /**
+ * Read EXTERNALBOOK record.
+ */
+ private function readExternalBook(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset within record data
+ $offset = 0;
+
+ // there are 4 types of records
+ if (strlen($recordData) > 4) {
+ // external reference
+ // offset: 0; size: 2; number of sheet names ($nm)
+ $nm = self::getUInt2d($recordData, 0);
+ $offset += 2;
+
+ // offset: 2; size: var; encoded URL without sheet name (Unicode string, 16-bit length)
+ $encodedUrlString = self::readUnicodeStringLong(substr($recordData, 2));
+ $offset += $encodedUrlString['size'];
+
+ // offset: var; size: var; list of $nm sheet names (Unicode strings, 16-bit length)
+ $externalSheetNames = [];
+ for ($i = 0; $i < $nm; ++$i) {
+ $externalSheetNameString = self::readUnicodeStringLong(substr($recordData, $offset));
+ $externalSheetNames[] = $externalSheetNameString['value'];
+ $offset += $externalSheetNameString['size'];
+ }
+
+ // store the record data
+ $this->externalBooks[] = [
+ 'type' => 'external',
+ 'encodedUrl' => $encodedUrlString['value'],
+ 'externalSheetNames' => $externalSheetNames,
+ ];
+ } elseif (substr($recordData, 2, 2) == pack('CC', 0x01, 0x04)) {
+ // internal reference
+ // offset: 0; size: 2; number of sheet in this document
+ // offset: 2; size: 2; 0x01 0x04
+ $this->externalBooks[] = [
+ 'type' => 'internal',
+ ];
+ } elseif (substr($recordData, 0, 4) == pack('vCC', 0x0001, 0x01, 0x3A)) {
+ // add-in function
+ // offset: 0; size: 2; 0x0001
+ $this->externalBooks[] = [
+ 'type' => 'addInFunction',
+ ];
+ } elseif (substr($recordData, 0, 2) == pack('v', 0x0000)) {
+ // DDE links, OLE links
+ // offset: 0; size: 2; 0x0000
+ // offset: 2; size: var; encoded source document name
+ $this->externalBooks[] = [
+ 'type' => 'DDEorOLE',
+ ];
+ }
+ }
+
+ /**
+ * Read EXTERNNAME record.
+ */
+ private function readExternName(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // external sheet references provided for named cells
+ if ($this->version == self::XLS_BIFF8) {
+ // offset: 0; size: 2; options
+ //$options = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2;
+
+ // offset: 4; size: 2; not used
+
+ // offset: 6; size: var
+ $nameString = self::readUnicodeStringShort(substr($recordData, 6));
+
+ // offset: var; size: var; formula data
+ $offset = 6 + $nameString['size'];
+ $formula = $this->getFormulaFromStructure(substr($recordData, $offset));
+
+ $this->externalNames[] = [
+ 'name' => $nameString['value'],
+ 'formula' => $formula,
+ ];
+ }
+ }
+
+ /**
+ * Read EXTERNSHEET record.
+ */
+ private function readExternSheet(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // external sheet references provided for named cells
+ if ($this->version == self::XLS_BIFF8) {
+ // offset: 0; size: 2; number of following ref structures
+ $nm = self::getUInt2d($recordData, 0);
+ for ($i = 0; $i < $nm; ++$i) {
+ $this->ref[] = [
+ // offset: 2 + 6 * $i; index to EXTERNALBOOK record
+ 'externalBookIndex' => self::getUInt2d($recordData, 2 + 6 * $i),
+ // offset: 4 + 6 * $i; index to first sheet in EXTERNALBOOK record
+ 'firstSheetIndex' => self::getUInt2d($recordData, 4 + 6 * $i),
+ // offset: 6 + 6 * $i; index to last sheet in EXTERNALBOOK record
+ 'lastSheetIndex' => self::getUInt2d($recordData, 6 + 6 * $i),
+ ];
+ }
+ }
+ }
+
+ /**
+ * DEFINEDNAME.
+ *
+ * This record is part of a Link Table. It contains the name
+ * and the token array of an internal defined name. Token
+ * arrays of defined names contain tokens with aberrant
+ * token classes.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readDefinedName(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->version == self::XLS_BIFF8) {
+ // retrieves named cells
+
+ // offset: 0; size: 2; option flags
+ $opts = self::getUInt2d($recordData, 0);
+
+ // bit: 5; mask: 0x0020; 0 = user-defined name, 1 = built-in-name
+ $isBuiltInName = (0x0020 & $opts) >> 5;
+
+ // offset: 2; size: 1; keyboard shortcut
+
+ // offset: 3; size: 1; length of the name (character count)
+ $nlen = ord($recordData[3]);
+
+ // offset: 4; size: 2; size of the formula data (it can happen that this is zero)
+ // note: there can also be additional data, this is not included in $flen
+ $flen = self::getUInt2d($recordData, 4);
+
+ // offset: 8; size: 2; 0=Global name, otherwise index to sheet (1-based)
+ $scope = self::getUInt2d($recordData, 8);
+
+ // offset: 14; size: var; Name (Unicode string without length field)
+ $string = self::readUnicodeString(substr($recordData, 14), $nlen);
+
+ // offset: var; size: $flen; formula data
+ $offset = 14 + $string['size'];
+ $formulaStructure = pack('v', $flen) . substr($recordData, $offset);
+
+ try {
+ $formula = $this->getFormulaFromStructure($formulaStructure);
+ } catch (PhpSpreadsheetException) {
+ $formula = '';
+ $isBuiltInName = 0;
+ }
+
+ $this->definedname[] = [
+ 'isBuiltInName' => $isBuiltInName,
+ 'name' => $string['value'],
+ 'formula' => $formula,
+ 'scope' => $scope,
+ ];
+ }
+ }
+
+ /**
+ * Read MSODRAWINGGROUP record.
+ */
+ private function readMsoDrawingGroup(): void
+ {
+ //$length = self::getUInt2d($this->data, $this->pos + 2);
+
+ // get spliced record data
+ $splicedRecordData = $this->getSplicedRecordData();
+ $recordData = $splicedRecordData['recordData'];
+
+ $this->drawingGroupData .= $recordData;
+ }
+
+ /**
+ * SST - Shared String Table.
+ *
+ * This record contains a list of all strings used anywhere
+ * in the workbook. Each string occurs only once. The
+ * workbook uses indexes into the list to reference the
+ * strings.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readSst(): void
+ {
+ // offset within (spliced) record data
+ $pos = 0;
+
+ // Limit global SST position, further control for bad SST Length in BIFF8 data
+ $limitposSST = 0;
+
+ // get spliced record data
+ $splicedRecordData = $this->getSplicedRecordData();
+
+ $recordData = $splicedRecordData['recordData'];
+ $spliceOffsets = $splicedRecordData['spliceOffsets'];
+
+ // offset: 0; size: 4; total number of strings in the workbook
+ $pos += 4;
+
+ // offset: 4; size: 4; number of following strings ($nm)
+ $nm = self::getInt4d($recordData, 4);
+ $pos += 4;
+
+ // look up limit position
+ foreach ($spliceOffsets as $spliceOffset) {
+ // it can happen that the string is empty, therefore we need
+ // <= and not just <
+ if ($pos <= $spliceOffset) {
+ $limitposSST = $spliceOffset;
+ }
+ }
+
+ // loop through the Unicode strings (16-bit length)
+ for ($i = 0; $i < $nm && $pos < $limitposSST; ++$i) {
+ // number of characters in the Unicode string
+ $numChars = self::getUInt2d($recordData, $pos);
+ $pos += 2;
+
+ // option flags
+ $optionFlags = ord($recordData[$pos]);
+ ++$pos;
+
+ // bit: 0; mask: 0x01; 0 = compressed; 1 = uncompressed
+ $isCompressed = (($optionFlags & 0x01) == 0);
+
+ // bit: 2; mask: 0x02; 0 = ordinary; 1 = Asian phonetic
+ $hasAsian = (($optionFlags & 0x04) != 0);
+
+ // bit: 3; mask: 0x03; 0 = ordinary; 1 = Rich-Text
+ $hasRichText = (($optionFlags & 0x08) != 0);
+
+ $formattingRuns = 0;
+ if ($hasRichText) {
+ // number of Rich-Text formatting runs
+ $formattingRuns = self::getUInt2d($recordData, $pos);
+ $pos += 2;
+ }
+
+ $extendedRunLength = 0;
+ if ($hasAsian) {
+ // size of Asian phonetic setting
+ $extendedRunLength = self::getInt4d($recordData, $pos);
+ $pos += 4;
+ }
+
+ // expected byte length of character array if not split
+ $len = ($isCompressed) ? $numChars : $numChars * 2;
+
+ // look up limit position - Check it again to be sure that no error occurs when parsing SST structure
+ $limitpos = null;
+ foreach ($spliceOffsets as $spliceOffset) {
+ // it can happen that the string is empty, therefore we need
+ // <= and not just <
+ if ($pos <= $spliceOffset) {
+ $limitpos = $spliceOffset;
+
+ break;
+ }
+ }
+
+ if ($pos + $len <= $limitpos) {
+ // character array is not split between records
+
+ $retstr = substr($recordData, $pos, $len);
+ $pos += $len;
+ } else {
+ // character array is split between records
+
+ // first part of character array
+ $retstr = substr($recordData, $pos, $limitpos - $pos);
+
+ $bytesRead = $limitpos - $pos;
+
+ // remaining characters in Unicode string
+ $charsLeft = $numChars - (($isCompressed) ? $bytesRead : ($bytesRead / 2));
+
+ $pos = $limitpos;
+
+ // keep reading the characters
+ while ($charsLeft > 0) {
+ // look up next limit position, in case the string span more than one continue record
+ foreach ($spliceOffsets as $spliceOffset) {
+ if ($pos < $spliceOffset) {
+ $limitpos = $spliceOffset;
+
+ break;
+ }
+ }
+
+ // repeated option flags
+ // OpenOffice.org documentation 5.21
+ $option = ord($recordData[$pos]);
+ ++$pos;
+
+ if ($isCompressed && ($option == 0)) {
+ // 1st fragment compressed
+ // this fragment compressed
+ $len = min($charsLeft, $limitpos - $pos);
+ $retstr .= substr($recordData, $pos, $len);
+ $charsLeft -= $len;
+ $isCompressed = true;
+ } elseif (!$isCompressed && ($option != 0)) {
+ // 1st fragment uncompressed
+ // this fragment uncompressed
+ $len = min($charsLeft * 2, $limitpos - $pos);
+ $retstr .= substr($recordData, $pos, $len);
+ $charsLeft -= $len / 2;
+ $isCompressed = false;
+ } elseif (!$isCompressed && ($option == 0)) {
+ // 1st fragment uncompressed
+ // this fragment compressed
+ $len = min($charsLeft, $limitpos - $pos);
+ for ($j = 0; $j < $len; ++$j) {
+ $retstr .= $recordData[$pos + $j]
+ . chr(0);
+ }
+ $charsLeft -= $len;
+ $isCompressed = false;
+ } else {
+ // 1st fragment compressed
+ // this fragment uncompressed
+ $newstr = '';
+ $jMax = strlen($retstr);
+ for ($j = 0; $j < $jMax; ++$j) {
+ $newstr .= $retstr[$j] . chr(0);
+ }
+ $retstr = $newstr;
+ $len = min($charsLeft * 2, $limitpos - $pos);
+ $retstr .= substr($recordData, $pos, $len);
+ $charsLeft -= $len / 2;
+ $isCompressed = false;
+ }
+
+ $pos += $len;
+ }
+ }
+
+ // convert to UTF-8
+ $retstr = self::encodeUTF16($retstr, $isCompressed);
+
+ // read additional Rich-Text information, if any
+ $fmtRuns = [];
+ if ($hasRichText) {
+ // list of formatting runs
+ for ($j = 0; $j < $formattingRuns; ++$j) {
+ // first formatted character; zero-based
+ $charPos = self::getUInt2d($recordData, $pos + $j * 4);
+
+ // index to font record
+ $fontIndex = self::getUInt2d($recordData, $pos + 2 + $j * 4);
+
+ $fmtRuns[] = [
+ 'charPos' => $charPos,
+ 'fontIndex' => $fontIndex,
+ ];
+ }
+ $pos += 4 * $formattingRuns;
+ }
+
+ // read additional Asian phonetics information, if any
+ if ($hasAsian) {
+ // For Asian phonetic settings, we skip the extended string data
+ $pos += $extendedRunLength;
+ }
+
+ // store the shared sting
+ $this->sst[] = [
+ 'value' => $retstr,
+ 'fmtRuns' => $fmtRuns,
+ ];
+ }
+
+ // getSplicedRecordData() takes care of moving current position in data stream
+ }
+
+ /**
+ * Read PRINTGRIDLINES record.
+ */
+ private function readPrintGridlines(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->version == self::XLS_BIFF8 && !$this->readDataOnly) {
+ // offset: 0; size: 2; 0 = do not print sheet grid lines; 1 = print sheet gridlines
+ $printGridlines = (bool) self::getUInt2d($recordData, 0);
+ $this->phpSheet->setPrintGridlines($printGridlines);
+ }
+ }
+
+ /**
+ * Read DEFAULTROWHEIGHT record.
+ */
+ private function readDefaultRowHeight(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; option flags
+ // offset: 2; size: 2; default height for unused rows, (twips 1/20 point)
+ $height = self::getUInt2d($recordData, 2);
+ $this->phpSheet->getDefaultRowDimension()->setRowHeight($height / 20);
+ }
+
+ /**
+ * Read SHEETPR record.
+ */
+ private function readSheetPr(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2
+
+ // bit: 6; mask: 0x0040; 0 = outline buttons above outline group
+ $isSummaryBelow = (0x0040 & self::getUInt2d($recordData, 0)) >> 6;
+ $this->phpSheet->setShowSummaryBelow((bool) $isSummaryBelow);
+
+ // bit: 7; mask: 0x0080; 0 = outline buttons left of outline group
+ $isSummaryRight = (0x0080 & self::getUInt2d($recordData, 0)) >> 7;
+ $this->phpSheet->setShowSummaryRight((bool) $isSummaryRight);
+
+ // bit: 8; mask: 0x100; 0 = scale printout in percent, 1 = fit printout to number of pages
+ // this corresponds to radio button setting in page setup dialog in Excel
+ $this->isFitToPages = (bool) ((0x0100 & self::getUInt2d($recordData, 0)) >> 8);
+ }
+
+ /**
+ * Read HORIZONTALPAGEBREAKS record.
+ */
+ private function readHorizontalPageBreaks(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->version == self::XLS_BIFF8 && !$this->readDataOnly) {
+ // offset: 0; size: 2; number of the following row index structures
+ $nm = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 6 * $nm; list of $nm row index structures
+ for ($i = 0; $i < $nm; ++$i) {
+ $r = self::getUInt2d($recordData, 2 + 6 * $i);
+ $cf = self::getUInt2d($recordData, 2 + 6 * $i + 2);
+ //$cl = self::getUInt2d($recordData, 2 + 6 * $i + 4);
+
+ // not sure why two column indexes are necessary?
+ $this->phpSheet->setBreak([$cf + 1, $r], Worksheet::BREAK_ROW);
+ }
+ }
+ }
+
+ /**
+ * Read VERTICALPAGEBREAKS record.
+ */
+ private function readVerticalPageBreaks(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->version == self::XLS_BIFF8 && !$this->readDataOnly) {
+ // offset: 0; size: 2; number of the following column index structures
+ $nm = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 6 * $nm; list of $nm row index structures
+ for ($i = 0; $i < $nm; ++$i) {
+ $c = self::getUInt2d($recordData, 2 + 6 * $i);
+ $rf = self::getUInt2d($recordData, 2 + 6 * $i + 2);
+ //$rl = self::getUInt2d($recordData, 2 + 6 * $i + 4);
+
+ // not sure why two row indexes are necessary?
+ $this->phpSheet->setBreak([$c + 1, ($rf > 0) ? $rf : 1], Worksheet::BREAK_COLUMN);
+ }
+ }
+ }
+
+ /**
+ * Read HEADER record.
+ */
+ private function readHeader(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: var
+ // realized that $recordData can be empty even when record exists
+ if ($recordData) {
+ if ($this->version == self::XLS_BIFF8) {
+ $string = self::readUnicodeStringLong($recordData);
+ } else {
+ $string = $this->readByteStringShort($recordData);
+ }
+
+ $this->phpSheet->getHeaderFooter()->setOddHeader($string['value']);
+ $this->phpSheet->getHeaderFooter()->setEvenHeader($string['value']);
+ }
+ }
+ }
+
+ /**
+ * Read FOOTER record.
+ */
+ private function readFooter(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: var
+ // realized that $recordData can be empty even when record exists
+ if ($recordData) {
+ if ($this->version == self::XLS_BIFF8) {
+ $string = self::readUnicodeStringLong($recordData);
+ } else {
+ $string = $this->readByteStringShort($recordData);
+ }
+ $this->phpSheet->getHeaderFooter()->setOddFooter($string['value']);
+ $this->phpSheet->getHeaderFooter()->setEvenFooter($string['value']);
+ }
+ }
+ }
+
+ /**
+ * Read HCENTER record.
+ */
+ private function readHcenter(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 2; 0 = print sheet left aligned, 1 = print sheet centered horizontally
+ $isHorizontalCentered = (bool) self::getUInt2d($recordData, 0);
+
+ $this->phpSheet->getPageSetup()->setHorizontalCentered($isHorizontalCentered);
+ }
+ }
+
+ /**
+ * Read VCENTER record.
+ */
+ private function readVcenter(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 2; 0 = print sheet aligned at top page border, 1 = print sheet vertically centered
+ $isVerticalCentered = (bool) self::getUInt2d($recordData, 0);
+
+ $this->phpSheet->getPageSetup()->setVerticalCentered($isVerticalCentered);
+ }
+ }
+
+ /**
+ * Read LEFTMARGIN record.
+ */
+ private function readLeftMargin(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 8
+ $this->phpSheet->getPageMargins()->setLeft(self::extractNumber($recordData));
+ }
+ }
+
+ /**
+ * Read RIGHTMARGIN record.
+ */
+ private function readRightMargin(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 8
+ $this->phpSheet->getPageMargins()->setRight(self::extractNumber($recordData));
+ }
+ }
+
+ /**
+ * Read TOPMARGIN record.
+ */
+ private function readTopMargin(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 8
+ $this->phpSheet->getPageMargins()->setTop(self::extractNumber($recordData));
+ }
+ }
+
+ /**
+ * Read BOTTOMMARGIN record.
+ */
+ private function readBottomMargin(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 8
+ $this->phpSheet->getPageMargins()->setBottom(self::extractNumber($recordData));
+ }
+ }
+
+ /**
+ * Read PAGESETUP record.
+ */
+ private function readPageSetup(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 2; paper size
+ $paperSize = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; scaling factor
+ $scale = self::getUInt2d($recordData, 2);
+
+ // offset: 6; size: 2; fit worksheet width to this number of pages, 0 = use as many as needed
+ $fitToWidth = self::getUInt2d($recordData, 6);
+
+ // offset: 8; size: 2; fit worksheet height to this number of pages, 0 = use as many as needed
+ $fitToHeight = self::getUInt2d($recordData, 8);
+
+ // offset: 10; size: 2; option flags
+
+ // bit: 0; mask: 0x0001; 0=down then over, 1=over then down
+ $isOverThenDown = (0x0001 & self::getUInt2d($recordData, 10));
+
+ // bit: 1; mask: 0x0002; 0=landscape, 1=portrait
+ $isPortrait = (0x0002 & self::getUInt2d($recordData, 10)) >> 1;
+
+ // bit: 2; mask: 0x0004; 1= paper size, scaling factor, paper orient. not init
+ // when this bit is set, do not use flags for those properties
+ $isNotInit = (0x0004 & self::getUInt2d($recordData, 10)) >> 2;
+
+ if (!$isNotInit) {
+ $this->phpSheet->getPageSetup()->setPaperSize($paperSize);
+ $this->phpSheet->getPageSetup()->setPageOrder(((bool) $isOverThenDown) ? PageSetup::PAGEORDER_OVER_THEN_DOWN : PageSetup::PAGEORDER_DOWN_THEN_OVER);
+ $this->phpSheet->getPageSetup()->setOrientation(((bool) $isPortrait) ? PageSetup::ORIENTATION_PORTRAIT : PageSetup::ORIENTATION_LANDSCAPE);
+
+ $this->phpSheet->getPageSetup()->setScale($scale, false);
+ $this->phpSheet->getPageSetup()->setFitToPage((bool) $this->isFitToPages);
+ $this->phpSheet->getPageSetup()->setFitToWidth($fitToWidth, false);
+ $this->phpSheet->getPageSetup()->setFitToHeight($fitToHeight, false);
+ }
+
+ // offset: 16; size: 8; header margin (IEEE 754 floating-point value)
+ $marginHeader = self::extractNumber(substr($recordData, 16, 8));
+ $this->phpSheet->getPageMargins()->setHeader($marginHeader);
+
+ // offset: 24; size: 8; footer margin (IEEE 754 floating-point value)
+ $marginFooter = self::extractNumber(substr($recordData, 24, 8));
+ $this->phpSheet->getPageMargins()->setFooter($marginFooter);
+ }
+ }
+
+ /**
+ * PROTECT - Sheet protection (BIFF2 through BIFF8)
+ * if this record is omitted, then it also means no sheet protection.
+ */
+ private function readProtect(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->readDataOnly) {
+ return;
+ }
+
+ // offset: 0; size: 2;
+
+ // bit 0, mask 0x01; 1 = sheet is protected
+ $bool = (0x01 & self::getUInt2d($recordData, 0)) >> 0;
+ $this->phpSheet->getProtection()->setSheet((bool) $bool);
+ }
+
+ /**
+ * SCENPROTECT.
+ */
+ private function readScenProtect(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->readDataOnly) {
+ return;
+ }
+
+ // offset: 0; size: 2;
+
+ // bit: 0, mask 0x01; 1 = scenarios are protected
+ $bool = (0x01 & self::getUInt2d($recordData, 0)) >> 0;
+
+ $this->phpSheet->getProtection()->setScenarios((bool) $bool);
+ }
+
+ /**
+ * OBJECTPROTECT.
+ */
+ private function readObjectProtect(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->readDataOnly) {
+ return;
+ }
+
+ // offset: 0; size: 2;
+
+ // bit: 0, mask 0x01; 1 = objects are protected
+ $bool = (0x01 & self::getUInt2d($recordData, 0)) >> 0;
+
+ $this->phpSheet->getProtection()->setObjects((bool) $bool);
+ }
+
+ /**
+ * PASSWORD - Sheet protection (hashed) password (BIFF2 through BIFF8).
+ */
+ private function readPassword(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 2; 16-bit hash value of password
+ $password = strtoupper(dechex(self::getUInt2d($recordData, 0))); // the hashed password
+ $this->phpSheet->getProtection()->setPassword($password, true);
+ }
+ }
+
+ /**
+ * Read DEFCOLWIDTH record.
+ */
+ private function readDefColWidth(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; default column width
+ $width = self::getUInt2d($recordData, 0);
+ if ($width != 8) {
+ $this->phpSheet->getDefaultColumnDimension()->setWidth($width);
+ }
+ }
+
+ /**
+ * Read COLINFO record.
+ */
+ private function readColInfo(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 2; index to first column in range
+ $firstColumnIndex = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; index to last column in range
+ $lastColumnIndex = self::getUInt2d($recordData, 2);
+
+ // offset: 4; size: 2; width of the column in 1/256 of the width of the zero character
+ $width = self::getUInt2d($recordData, 4);
+
+ // offset: 6; size: 2; index to XF record for default column formatting
+ $xfIndex = self::getUInt2d($recordData, 6);
+
+ // offset: 8; size: 2; option flags
+ // bit: 0; mask: 0x0001; 1= columns are hidden
+ $isHidden = (0x0001 & self::getUInt2d($recordData, 8)) >> 0;
+
+ // bit: 10-8; mask: 0x0700; outline level of the columns (0 = no outline)
+ $level = (0x0700 & self::getUInt2d($recordData, 8)) >> 8;
+
+ // bit: 12; mask: 0x1000; 1 = collapsed
+ $isCollapsed = (bool) ((0x1000 & self::getUInt2d($recordData, 8)) >> 12);
+
+ // offset: 10; size: 2; not used
+
+ for ($i = $firstColumnIndex + 1; $i <= $lastColumnIndex + 1; ++$i) {
+ if ($lastColumnIndex == 255 || $lastColumnIndex == 256) {
+ $this->phpSheet->getDefaultColumnDimension()->setWidth($width / 256);
+
+ break;
+ }
+ $this->phpSheet->getColumnDimensionByColumn($i)->setWidth($width / 256);
+ $this->phpSheet->getColumnDimensionByColumn($i)->setVisible(!$isHidden);
+ $this->phpSheet->getColumnDimensionByColumn($i)->setOutlineLevel($level);
+ $this->phpSheet->getColumnDimensionByColumn($i)->setCollapsed($isCollapsed);
+ if (isset($this->mapCellXfIndex[$xfIndex])) {
+ $this->phpSheet->getColumnDimensionByColumn($i)->setXfIndex($this->mapCellXfIndex[$xfIndex]);
+ }
+ }
+ }
+ }
+
+ /**
+ * ROW.
+ *
+ * This record contains the properties of a single row in a
+ * sheet. Rows and cells in a sheet are divided into blocks
+ * of 32 rows.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readRow(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 2; index of this row
+ $r = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; index to column of the first cell which is described by a cell record
+
+ // offset: 4; size: 2; index to column of the last cell which is described by a cell record, increased by 1
+
+ // offset: 6; size: 2;
+
+ // bit: 14-0; mask: 0x7FFF; height of the row, in twips = 1/20 of a point
+ $height = (0x7FFF & self::getUInt2d($recordData, 6)) >> 0;
+
+ // bit: 15: mask: 0x8000; 0 = row has custom height; 1= row has default height
+ $useDefaultHeight = (0x8000 & self::getUInt2d($recordData, 6)) >> 15;
+
+ if (!$useDefaultHeight) {
+ $this->phpSheet->getRowDimension($r + 1)->setRowHeight($height / 20);
+ }
+
+ // offset: 8; size: 2; not used
+
+ // offset: 10; size: 2; not used in BIFF5-BIFF8
+
+ // offset: 12; size: 4; option flags and default row formatting
+
+ // bit: 2-0: mask: 0x00000007; outline level of the row
+ $level = (0x00000007 & self::getInt4d($recordData, 12)) >> 0;
+ $this->phpSheet->getRowDimension($r + 1)->setOutlineLevel($level);
+
+ // bit: 4; mask: 0x00000010; 1 = outline group start or ends here... and is collapsed
+ $isCollapsed = (bool) ((0x00000010 & self::getInt4d($recordData, 12)) >> 4);
+ $this->phpSheet->getRowDimension($r + 1)->setCollapsed($isCollapsed);
+
+ // bit: 5; mask: 0x00000020; 1 = row is hidden
+ $isHidden = (0x00000020 & self::getInt4d($recordData, 12)) >> 5;
+ $this->phpSheet->getRowDimension($r + 1)->setVisible(!$isHidden);
+
+ // bit: 7; mask: 0x00000080; 1 = row has explicit format
+ $hasExplicitFormat = (0x00000080 & self::getInt4d($recordData, 12)) >> 7;
+
+ // bit: 27-16; mask: 0x0FFF0000; only applies when hasExplicitFormat = 1; index to XF record
+ $xfIndex = (0x0FFF0000 & self::getInt4d($recordData, 12)) >> 16;
+
+ if ($hasExplicitFormat && isset($this->mapCellXfIndex[$xfIndex])) {
+ $this->phpSheet->getRowDimension($r + 1)->setXfIndex($this->mapCellXfIndex[$xfIndex]);
+ }
+ }
+ }
+
+ /**
+ * Read RK record
+ * This record represents a cell that contains an RK value
+ * (encoded integer or floating-point value). If a
+ * floating-point value cannot be encoded to an RK value,
+ * a NUMBER record will be written. This record replaces the
+ * record INTEGER written in BIFF2.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readRk(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; index to row
+ $row = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; index to column
+ $column = self::getUInt2d($recordData, 2);
+ $columnString = Coordinate::stringFromColumnIndex($column + 1);
+
+ // Read cell?
+ if (($this->getReadFilter() !== null) && $this->getReadFilter()->readCell($columnString, $row + 1, $this->phpSheet->getTitle())) {
+ // offset: 4; size: 2; index to XF record
+ $xfIndex = self::getUInt2d($recordData, 4);
+
+ // offset: 6; size: 4; RK value
+ $rknum = self::getInt4d($recordData, 6);
+ $numValue = self::getIEEE754($rknum);
+
+ $cell = $this->phpSheet->getCell($columnString . ($row + 1));
+ if (!$this->readDataOnly && isset($this->mapCellXfIndex[$xfIndex])) {
+ // add style information
+ $cell->setXfIndex($this->mapCellXfIndex[$xfIndex]);
+ }
+
+ // add cell
+ $cell->setValueExplicit($numValue, DataType::TYPE_NUMERIC);
+ }
+ }
+
+ /**
+ * Read LABELSST record
+ * This record represents a cell that contains a string. It
+ * replaces the LABEL record and RSTRING record used in
+ * BIFF2-BIFF5.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readLabelSst(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; index to row
+ $row = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; index to column
+ $column = self::getUInt2d($recordData, 2);
+ $columnString = Coordinate::stringFromColumnIndex($column + 1);
+
+ $cell = null;
+ // Read cell?
+ if (($this->getReadFilter() !== null) && $this->getReadFilter()->readCell($columnString, $row + 1, $this->phpSheet->getTitle())) {
+ // offset: 4; size: 2; index to XF record
+ $xfIndex = self::getUInt2d($recordData, 4);
+
+ // offset: 6; size: 4; index to SST record
+ $index = self::getInt4d($recordData, 6);
+
+ // add cell
+ if (($fmtRuns = $this->sst[$index]['fmtRuns']) && !$this->readDataOnly) {
+ // then we should treat as rich text
+ $richText = new RichText();
+ $charPos = 0;
+ $sstCount = count($this->sst[$index]['fmtRuns']);
+ for ($i = 0; $i <= $sstCount; ++$i) {
+ if (isset($fmtRuns[$i])) {
+ $text = StringHelper::substring($this->sst[$index]['value'], $charPos, $fmtRuns[$i]['charPos'] - $charPos);
+ $charPos = $fmtRuns[$i]['charPos'];
+ } else {
+ $text = StringHelper::substring($this->sst[$index]['value'], $charPos, StringHelper::countCharacters($this->sst[$index]['value']));
+ }
+
+ if (StringHelper::countCharacters($text) > 0) {
+ if ($i == 0) { // first text run, no style
+ $richText->createText($text);
+ } else {
+ $textRun = $richText->createTextRun($text);
+ if (isset($fmtRuns[$i - 1])) {
+ if ($fmtRuns[$i - 1]['fontIndex'] < 4) {
+ $fontIndex = $fmtRuns[$i - 1]['fontIndex'];
+ } else {
+ // this has to do with that index 4 is omitted in all BIFF versions for some stra nge reason
+ // check the OpenOffice documentation of the FONT record
+ $fontIndex = $fmtRuns[$i - 1]['fontIndex'] - 1;
+ }
+ if (array_key_exists($fontIndex, $this->objFonts) === false) {
+ $fontIndex = count($this->objFonts) - 1;
+ }
+ $textRun->setFont(clone $this->objFonts[$fontIndex]);
+ }
+ }
+ }
+ }
+ if ($this->readEmptyCells || trim($richText->getPlainText()) !== '') {
+ $cell = $this->phpSheet->getCell($columnString . ($row + 1));
+ $cell->setValueExplicit($richText, DataType::TYPE_STRING);
+ }
+ } else {
+ if ($this->readEmptyCells || trim($this->sst[$index]['value']) !== '') {
+ $cell = $this->phpSheet->getCell($columnString . ($row + 1));
+ $cell->setValueExplicit($this->sst[$index]['value'], DataType::TYPE_STRING);
+ }
+ }
+
+ if (!$this->readDataOnly && $cell !== null && isset($this->mapCellXfIndex[$xfIndex])) {
+ // add style information
+ $cell->setXfIndex($this->mapCellXfIndex[$xfIndex]);
+ }
+ }
+ }
+
+ /**
+ * Read MULRK record
+ * This record represents a cell range containing RK value
+ * cells. All cells are located in the same row.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readMulRk(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; index to row
+ $row = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; index to first column
+ $colFirst = self::getUInt2d($recordData, 2);
+
+ // offset: var; size: 2; index to last column
+ $colLast = self::getUInt2d($recordData, $length - 2);
+ $columns = $colLast - $colFirst + 1;
+
+ // offset within record data
+ $offset = 4;
+
+ for ($i = 1; $i <= $columns; ++$i) {
+ $columnString = Coordinate::stringFromColumnIndex($colFirst + $i);
+
+ // Read cell?
+ if (($this->getReadFilter() !== null) && $this->getReadFilter()->readCell($columnString, $row + 1, $this->phpSheet->getTitle())) {
+ // offset: var; size: 2; index to XF record
+ $xfIndex = self::getUInt2d($recordData, $offset);
+
+ // offset: var; size: 4; RK value
+ $numValue = self::getIEEE754(self::getInt4d($recordData, $offset + 2));
+ $cell = $this->phpSheet->getCell($columnString . ($row + 1));
+ if (!$this->readDataOnly && isset($this->mapCellXfIndex[$xfIndex])) {
+ // add style
+ $cell->setXfIndex($this->mapCellXfIndex[$xfIndex]);
+ }
+
+ // add cell value
+ $cell->setValueExplicit($numValue, DataType::TYPE_NUMERIC);
+ }
+
+ $offset += 6;
+ }
+ }
+
+ /**
+ * Read NUMBER record
+ * This record represents a cell that contains a
+ * floating-point value.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readNumber(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; index to row
+ $row = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size 2; index to column
+ $column = self::getUInt2d($recordData, 2);
+ $columnString = Coordinate::stringFromColumnIndex($column + 1);
+
+ // Read cell?
+ if (($this->getReadFilter() !== null) && $this->getReadFilter()->readCell($columnString, $row + 1, $this->phpSheet->getTitle())) {
+ // offset 4; size: 2; index to XF record
+ $xfIndex = self::getUInt2d($recordData, 4);
+
+ $numValue = self::extractNumber(substr($recordData, 6, 8));
+
+ $cell = $this->phpSheet->getCell($columnString . ($row + 1));
+ if (!$this->readDataOnly && isset($this->mapCellXfIndex[$xfIndex])) {
+ // add cell style
+ $cell->setXfIndex($this->mapCellXfIndex[$xfIndex]);
+ }
+
+ // add cell value
+ $cell->setValueExplicit($numValue, DataType::TYPE_NUMERIC);
+ }
+ }
+
+ /**
+ * Read FORMULA record + perhaps a following STRING record if formula result is a string
+ * This record contains the token array and the result of a
+ * formula cell.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readFormula(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; row index
+ $row = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; col index
+ $column = self::getUInt2d($recordData, 2);
+ $columnString = Coordinate::stringFromColumnIndex($column + 1);
+
+ // offset: 20: size: variable; formula structure
+ $formulaStructure = substr($recordData, 20);
+
+ // offset: 14: size: 2; option flags, recalculate always, recalculate on open etc.
+ $options = self::getUInt2d($recordData, 14);
+
+ // bit: 0; mask: 0x0001; 1 = recalculate always
+ // bit: 1; mask: 0x0002; 1 = calculate on open
+ // bit: 2; mask: 0x0008; 1 = part of a shared formula
+ $isPartOfSharedFormula = (bool) (0x0008 & $options);
+
+ // WARNING:
+ // We can apparently not rely on $isPartOfSharedFormula. Even when $isPartOfSharedFormula = true
+ // the formula data may be ordinary formula data, therefore we need to check
+ // explicitly for the tExp token (0x01)
+ $isPartOfSharedFormula = $isPartOfSharedFormula && ord($formulaStructure[2]) == 0x01;
+
+ if ($isPartOfSharedFormula) {
+ // part of shared formula which means there will be a formula with a tExp token and nothing else
+ // get the base cell, grab tExp token
+ $baseRow = self::getUInt2d($formulaStructure, 3);
+ $baseCol = self::getUInt2d($formulaStructure, 5);
+ $this->baseCell = Coordinate::stringFromColumnIndex($baseCol + 1) . ($baseRow + 1);
+ }
+
+ // Read cell?
+ if (($this->getReadFilter() !== null) && $this->getReadFilter()->readCell($columnString, $row + 1, $this->phpSheet->getTitle())) {
+ if ($isPartOfSharedFormula) {
+ // formula is added to this cell after the sheet has been read
+ $this->sharedFormulaParts[$columnString . ($row + 1)] = $this->baseCell;
+ }
+
+ // offset: 16: size: 4; not used
+
+ // offset: 4; size: 2; XF index
+ $xfIndex = self::getUInt2d($recordData, 4);
+
+ // offset: 6; size: 8; result of the formula
+ if ((ord($recordData[6]) == 0) && (ord($recordData[12]) == 255) && (ord($recordData[13]) == 255)) {
+ // String formula. Result follows in appended STRING record
+ $dataType = DataType::TYPE_STRING;
+
+ // read possible SHAREDFMLA record
+ $code = self::getUInt2d($this->data, $this->pos);
+ if ($code == self::XLS_TYPE_SHAREDFMLA) {
+ $this->readSharedFmla();
+ }
+
+ // read STRING record
+ $value = $this->readString();
+ } elseif (
+ (ord($recordData[6]) == 1)
+ && (ord($recordData[12]) == 255)
+ && (ord($recordData[13]) == 255)
+ ) {
+ // Boolean formula. Result is in +2; 0=false, 1=true
+ $dataType = DataType::TYPE_BOOL;
+ $value = (bool) ord($recordData[8]);
+ } elseif (
+ (ord($recordData[6]) == 2)
+ && (ord($recordData[12]) == 255)
+ && (ord($recordData[13]) == 255)
+ ) {
+ // Error formula. Error code is in +2
+ $dataType = DataType::TYPE_ERROR;
+ $value = Xls\ErrorCode::lookup(ord($recordData[8]));
+ } elseif (
+ (ord($recordData[6]) == 3)
+ && (ord($recordData[12]) == 255)
+ && (ord($recordData[13]) == 255)
+ ) {
+ // Formula result is a null string
+ $dataType = DataType::TYPE_NULL;
+ $value = '';
+ } else {
+ // forumla result is a number, first 14 bytes like _NUMBER record
+ $dataType = DataType::TYPE_NUMERIC;
+ $value = self::extractNumber(substr($recordData, 6, 8));
+ }
+
+ $cell = $this->phpSheet->getCell($columnString . ($row + 1));
+ if (!$this->readDataOnly && isset($this->mapCellXfIndex[$xfIndex])) {
+ // add cell style
+ $cell->setXfIndex($this->mapCellXfIndex[$xfIndex]);
+ }
+
+ // store the formula
+ if (!$isPartOfSharedFormula) {
+ // not part of shared formula
+ // add cell value. If we can read formula, populate with formula, otherwise just used cached value
+ try {
+ if ($this->version != self::XLS_BIFF8) {
+ throw new Exception('Not BIFF8. Can only read BIFF8 formulas');
+ }
+ $formula = $this->getFormulaFromStructure($formulaStructure); // get formula in human language
+ $cell->setValueExplicit('=' . $formula, DataType::TYPE_FORMULA);
+ } catch (PhpSpreadsheetException) {
+ $cell->setValueExplicit($value, $dataType);
+ }
+ } else {
+ if ($this->version == self::XLS_BIFF8) {
+ // do nothing at this point, formula id added later in the code
+ } else {
+ $cell->setValueExplicit($value, $dataType);
+ }
+ }
+
+ // store the cached calculated value
+ $cell->setCalculatedValue($value, $dataType === DataType::TYPE_NUMERIC);
+ }
+ }
+
+ /**
+ * Read a SHAREDFMLA record. This function just stores the binary shared formula in the reader,
+ * which usually contains relative references.
+ * These will be used to construct the formula in each shared formula part after the sheet is read.
+ */
+ private function readSharedFmla(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0, size: 6; cell range address of the area used by the shared formula, not used for anything
+ //$cellRange = substr($recordData, 0, 6);
+ //$cellRange = $this->readBIFF5CellRangeAddressFixed($cellRange); // note: even BIFF8 uses BIFF5 syntax
+
+ // offset: 6, size: 1; not used
+
+ // offset: 7, size: 1; number of existing FORMULA records for this shared formula
+ //$no = ord($recordData[7]);
+
+ // offset: 8, size: var; Binary token array of the shared formula
+ $formula = substr($recordData, 8);
+
+ // at this point we only store the shared formula for later use
+ $this->sharedFormulas[$this->baseCell] = $formula;
+ }
+
+ /**
+ * Read a STRING record from current stream position and advance the stream pointer to next record
+ * This record is used for storing result from FORMULA record when it is a string, and
+ * it occurs directly after the FORMULA record.
+ *
+ * @return string The string contents as UTF-8
+ */
+ private function readString(): string
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->version == self::XLS_BIFF8) {
+ $string = self::readUnicodeStringLong($recordData);
+ $value = $string['value'];
+ } else {
+ $string = $this->readByteStringLong($recordData);
+ $value = $string['value'];
+ }
+
+ return $value;
+ }
+
+ /**
+ * Read BOOLERR record
+ * This record represents a Boolean value or error value
+ * cell.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readBoolErr(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; row index
+ $row = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; column index
+ $column = self::getUInt2d($recordData, 2);
+ $columnString = Coordinate::stringFromColumnIndex($column + 1);
+
+ // Read cell?
+ if (($this->getReadFilter() !== null) && $this->getReadFilter()->readCell($columnString, $row + 1, $this->phpSheet->getTitle())) {
+ // offset: 4; size: 2; index to XF record
+ $xfIndex = self::getUInt2d($recordData, 4);
+
+ // offset: 6; size: 1; the boolean value or error value
+ $boolErr = ord($recordData[6]);
+
+ // offset: 7; size: 1; 0=boolean; 1=error
+ $isError = ord($recordData[7]);
+
+ $cell = $this->phpSheet->getCell($columnString . ($row + 1));
+ switch ($isError) {
+ case 0: // boolean
+ $value = (bool) $boolErr;
+
+ // add cell value
+ $cell->setValueExplicit($value, DataType::TYPE_BOOL);
+
+ break;
+ case 1: // error type
+ $value = Xls\ErrorCode::lookup($boolErr);
+
+ // add cell value
+ $cell->setValueExplicit($value, DataType::TYPE_ERROR);
+
+ break;
+ }
+
+ if (!$this->readDataOnly && isset($this->mapCellXfIndex[$xfIndex])) {
+ // add cell style
+ $cell->setXfIndex($this->mapCellXfIndex[$xfIndex]);
+ }
+ }
+ }
+
+ /**
+ * Read MULBLANK record
+ * This record represents a cell range of empty cells. All
+ * cells are located in the same row.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readMulBlank(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; index to row
+ $row = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; index to first column
+ $fc = self::getUInt2d($recordData, 2);
+
+ // offset: 4; size: 2 x nc; list of indexes to XF records
+ // add style information
+ if (!$this->readDataOnly && $this->readEmptyCells) {
+ for ($i = 0; $i < $length / 2 - 3; ++$i) {
+ $columnString = Coordinate::stringFromColumnIndex($fc + $i + 1);
+
+ // Read cell?
+ if (($this->getReadFilter() !== null) && $this->getReadFilter()->readCell($columnString, $row + 1, $this->phpSheet->getTitle())) {
+ $xfIndex = self::getUInt2d($recordData, 4 + 2 * $i);
+ if (isset($this->mapCellXfIndex[$xfIndex])) {
+ $this->phpSheet->getCell($columnString . ($row + 1))->setXfIndex($this->mapCellXfIndex[$xfIndex]);
+ }
+ }
+ }
+ }
+
+ // offset: 6; size 2; index to last column (not needed)
+ }
+
+ /**
+ * Read LABEL record
+ * This record represents a cell that contains a string. In
+ * BIFF8 it is usually replaced by the LABELSST record.
+ * Excel still uses this record, if it copies unformatted
+ * text cells to the clipboard.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readLabel(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; index to row
+ $row = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; index to column
+ $column = self::getUInt2d($recordData, 2);
+ $columnString = Coordinate::stringFromColumnIndex($column + 1);
+
+ // Read cell?
+ if (($this->getReadFilter() !== null) && $this->getReadFilter()->readCell($columnString, $row + 1, $this->phpSheet->getTitle())) {
+ // offset: 4; size: 2; XF index
+ $xfIndex = self::getUInt2d($recordData, 4);
+
+ // add cell value
+ // todo: what if string is very long? continue record
+ if ($this->version == self::XLS_BIFF8) {
+ $string = self::readUnicodeStringLong(substr($recordData, 6));
+ $value = $string['value'];
+ } else {
+ $string = $this->readByteStringLong(substr($recordData, 6));
+ $value = $string['value'];
+ }
+ if ($this->readEmptyCells || trim($value) !== '') {
+ $cell = $this->phpSheet->getCell($columnString . ($row + 1));
+ $cell->setValueExplicit($value, DataType::TYPE_STRING);
+
+ if (!$this->readDataOnly && isset($this->mapCellXfIndex[$xfIndex])) {
+ // add cell style
+ $cell->setXfIndex($this->mapCellXfIndex[$xfIndex]);
+ }
+ }
+ }
+ }
+
+ /**
+ * Read BLANK record.
+ */
+ private function readBlank(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; row index
+ $row = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; col index
+ $col = self::getUInt2d($recordData, 2);
+ $columnString = Coordinate::stringFromColumnIndex($col + 1);
+
+ // Read cell?
+ if (($this->getReadFilter() !== null) && $this->getReadFilter()->readCell($columnString, $row + 1, $this->phpSheet->getTitle())) {
+ // offset: 4; size: 2; XF index
+ $xfIndex = self::getUInt2d($recordData, 4);
+
+ // add style information
+ if (!$this->readDataOnly && $this->readEmptyCells && isset($this->mapCellXfIndex[$xfIndex])) {
+ $this->phpSheet->getCell($columnString . ($row + 1))->setXfIndex($this->mapCellXfIndex[$xfIndex]);
+ }
+ }
+ }
+
+ /**
+ * Read MSODRAWING record.
+ */
+ private function readMsoDrawing(): void
+ {
+ //$length = self::getUInt2d($this->data, $this->pos + 2);
+
+ // get spliced record data
+ $splicedRecordData = $this->getSplicedRecordData();
+ $recordData = $splicedRecordData['recordData'];
+
+ $this->drawingData .= $recordData;
+ }
+
+ /**
+ * Read OBJ record.
+ */
+ private function readObj(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->readDataOnly || $this->version != self::XLS_BIFF8) {
+ return;
+ }
+
+ // recordData consists of an array of subrecords looking like this:
+ // ft: 2 bytes; ftCmo type (0x15)
+ // cb: 2 bytes; size in bytes of ftCmo data
+ // ot: 2 bytes; Object Type
+ // id: 2 bytes; Object id number
+ // grbit: 2 bytes; Option Flags
+ // data: var; subrecord data
+
+ // for now, we are just interested in the second subrecord containing the object type
+ $ftCmoType = self::getUInt2d($recordData, 0);
+ $cbCmoSize = self::getUInt2d($recordData, 2);
+ $otObjType = self::getUInt2d($recordData, 4);
+ $idObjID = self::getUInt2d($recordData, 6);
+ $grbitOpts = self::getUInt2d($recordData, 6);
+
+ $this->objs[] = [
+ 'ftCmoType' => $ftCmoType,
+ 'cbCmoSize' => $cbCmoSize,
+ 'otObjType' => $otObjType,
+ 'idObjID' => $idObjID,
+ 'grbitOpts' => $grbitOpts,
+ ];
+ $this->textObjRef = $idObjID;
+ }
+
+ /**
+ * Read WINDOW2 record.
+ */
+ private function readWindow2(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; option flags
+ $options = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; index to first visible row
+ //$firstVisibleRow = self::getUInt2d($recordData, 2);
+
+ // offset: 4; size: 2; index to first visible colum
+ //$firstVisibleColumn = self::getUInt2d($recordData, 4);
+ $zoomscaleInPageBreakPreview = 0;
+ $zoomscaleInNormalView = 0;
+ if ($this->version === self::XLS_BIFF8) {
+ // offset: 8; size: 2; not used
+ // offset: 10; size: 2; cached magnification factor in page break preview (in percent); 0 = Default (60%)
+ // offset: 12; size: 2; cached magnification factor in normal view (in percent); 0 = Default (100%)
+ // offset: 14; size: 4; not used
+ if (!isset($recordData[10])) {
+ $zoomscaleInPageBreakPreview = 0;
+ } else {
+ $zoomscaleInPageBreakPreview = self::getUInt2d($recordData, 10);
+ }
+
+ if ($zoomscaleInPageBreakPreview === 0) {
+ $zoomscaleInPageBreakPreview = 60;
+ }
+
+ if (!isset($recordData[12])) {
+ $zoomscaleInNormalView = 0;
+ } else {
+ $zoomscaleInNormalView = self::getUInt2d($recordData, 12);
+ }
+
+ if ($zoomscaleInNormalView === 0) {
+ $zoomscaleInNormalView = 100;
+ }
+ }
+
+ // bit: 1; mask: 0x0002; 0 = do not show gridlines, 1 = show gridlines
+ $showGridlines = (bool) ((0x0002 & $options) >> 1);
+ $this->phpSheet->setShowGridlines($showGridlines);
+
+ // bit: 2; mask: 0x0004; 0 = do not show headers, 1 = show headers
+ $showRowColHeaders = (bool) ((0x0004 & $options) >> 2);
+ $this->phpSheet->setShowRowColHeaders($showRowColHeaders);
+
+ // bit: 3; mask: 0x0008; 0 = panes are not frozen, 1 = panes are frozen
+ $this->frozen = (bool) ((0x0008 & $options) >> 3);
+
+ // bit: 6; mask: 0x0040; 0 = columns from left to right, 1 = columns from right to left
+ $this->phpSheet->setRightToLeft((bool) ((0x0040 & $options) >> 6));
+
+ // bit: 10; mask: 0x0400; 0 = sheet not active, 1 = sheet active
+ $isActive = (bool) ((0x0400 & $options) >> 10);
+ if ($isActive) {
+ $this->spreadsheet->setActiveSheetIndex($this->spreadsheet->getIndex($this->phpSheet));
+ $this->activeSheetSet = true;
+ }
+
+ // bit: 11; mask: 0x0800; 0 = normal view, 1 = page break view
+ $isPageBreakPreview = (bool) ((0x0800 & $options) >> 11);
+
+ //FIXME: set $firstVisibleRow and $firstVisibleColumn
+
+ if ($this->phpSheet->getSheetView()->getView() !== SheetView::SHEETVIEW_PAGE_LAYOUT) {
+ //NOTE: this setting is inferior to page layout view(Excel2007-)
+ $view = $isPageBreakPreview ? SheetView::SHEETVIEW_PAGE_BREAK_PREVIEW : SheetView::SHEETVIEW_NORMAL;
+ $this->phpSheet->getSheetView()->setView($view);
+ if ($this->version === self::XLS_BIFF8) {
+ $zoomScale = $isPageBreakPreview ? $zoomscaleInPageBreakPreview : $zoomscaleInNormalView;
+ $this->phpSheet->getSheetView()->setZoomScale($zoomScale);
+ $this->phpSheet->getSheetView()->setZoomScaleNormal($zoomscaleInNormalView);
+ }
+ }
+ }
+
+ /**
+ * Read PLV Record(Created by Excel2007 or upper).
+ */
+ private function readPageLayoutView(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; rt
+ //->ignore
+ //$rt = self::getUInt2d($recordData, 0);
+ // offset: 2; size: 2; grbitfr
+ //->ignore
+ //$grbitFrt = self::getUInt2d($recordData, 2);
+ // offset: 4; size: 8; reserved
+ //->ignore
+
+ // offset: 12; size 2; zoom scale
+ $wScalePLV = self::getUInt2d($recordData, 12);
+ // offset: 14; size 2; grbit
+ $grbit = self::getUInt2d($recordData, 14);
+
+ // decomprise grbit
+ $fPageLayoutView = $grbit & 0x01;
+ //$fRulerVisible = ($grbit >> 1) & 0x01; //no support
+ //$fWhitespaceHidden = ($grbit >> 3) & 0x01; //no support
+
+ if ($fPageLayoutView === 1) {
+ $this->phpSheet->getSheetView()->setView(SheetView::SHEETVIEW_PAGE_LAYOUT);
+ $this->phpSheet->getSheetView()->setZoomScale($wScalePLV); //set by Excel2007 only if SHEETVIEW_PAGE_LAYOUT
+ }
+ //otherwise, we cannot know whether SHEETVIEW_PAGE_LAYOUT or SHEETVIEW_PAGE_BREAK_PREVIEW.
+ }
+
+ /**
+ * Read SCL record.
+ */
+ private function readScl(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // offset: 0; size: 2; numerator of the view magnification
+ $numerator = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; numerator of the view magnification
+ $denumerator = self::getUInt2d($recordData, 2);
+
+ // set the zoom scale (in percent)
+ $this->phpSheet->getSheetView()->setZoomScale($numerator * 100 / $denumerator);
+ }
+
+ /**
+ * Read PANE record.
+ */
+ private function readPane(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 2; position of vertical split
+ $px = self::getUInt2d($recordData, 0);
+
+ // offset: 2; size: 2; position of horizontal split
+ $py = self::getUInt2d($recordData, 2);
+
+ // offset: 4; size: 2; top most visible row in the bottom pane
+ $rwTop = self::getUInt2d($recordData, 4);
+
+ // offset: 6; size: 2; first visible left column in the right pane
+ $colLeft = self::getUInt2d($recordData, 6);
+
+ if ($this->frozen) {
+ // frozen panes
+ $cell = Coordinate::stringFromColumnIndex($px + 1) . ($py + 1);
+ $topLeftCell = Coordinate::stringFromColumnIndex($colLeft + 1) . ($rwTop + 1);
+ $this->phpSheet->freezePane($cell, $topLeftCell);
+ }
+ // unfrozen panes; split windows; not supported by PhpSpreadsheet core
+ }
+ }
+
+ /**
+ * Read SELECTION record. There is one such record for each pane in the sheet.
+ */
+ private function readSelection(): string
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+ $selectedCells = '';
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 1; pane identifier
+ //$paneId = ord($recordData[0]);
+
+ // offset: 1; size: 2; index to row of the active cell
+ //$r = self::getUInt2d($recordData, 1);
+
+ // offset: 3; size: 2; index to column of the active cell
+ //$c = self::getUInt2d($recordData, 3);
+
+ // offset: 5; size: 2; index into the following cell range list to the
+ // entry that contains the active cell
+ //$index = self::getUInt2d($recordData, 5);
+
+ // offset: 7; size: var; cell range address list containing all selected cell ranges
+ $data = substr($recordData, 7);
+ $cellRangeAddressList = $this->readBIFF5CellRangeAddressList($data); // note: also BIFF8 uses BIFF5 syntax
+
+ $selectedCells = $cellRangeAddressList['cellRangeAddresses'][0];
+
+ // first row '1' + last row '16384' indicates that full column is selected (apparently also in BIFF8!)
+ if (preg_match('/^([A-Z]+1\:[A-Z]+)16384$/', $selectedCells)) {
+ $selectedCells = (string) preg_replace('/^([A-Z]+1\:[A-Z]+)16384$/', '${1}1048576', $selectedCells);
+ }
+
+ // first row '1' + last row '65536' indicates that full column is selected
+ if (preg_match('/^([A-Z]+1\:[A-Z]+)65536$/', $selectedCells)) {
+ $selectedCells = (string) preg_replace('/^([A-Z]+1\:[A-Z]+)65536$/', '${1}1048576', $selectedCells);
+ }
+
+ // first column 'A' + last column 'IV' indicates that full row is selected
+ if (preg_match('/^(A\d+\:)IV(\d+)$/', $selectedCells)) {
+ $selectedCells = (string) preg_replace('/^(A\d+\:)IV(\d+)$/', '${1}XFD${2}', $selectedCells);
+ }
+
+ $this->phpSheet->setSelectedCells($selectedCells);
+ }
+
+ return $selectedCells;
+ }
+
+ private function includeCellRangeFiltered(string $cellRangeAddress): bool
+ {
+ $includeCellRange = true;
+ if ($this->getReadFilter() !== null) {
+ $includeCellRange = false;
+ $rangeBoundaries = Coordinate::getRangeBoundaries($cellRangeAddress);
+ ++$rangeBoundaries[1][0];
+ for ($row = $rangeBoundaries[0][1]; $row <= $rangeBoundaries[1][1]; ++$row) {
+ for ($column = $rangeBoundaries[0][0]; $column != $rangeBoundaries[1][0]; ++$column) {
+ if ($this->getReadFilter()->readCell($column, $row, $this->phpSheet->getTitle())) {
+ $includeCellRange = true;
+
+ break 2;
+ }
+ }
+ }
+ }
+
+ return $includeCellRange;
+ }
+
+ /**
+ * MERGEDCELLS.
+ *
+ * This record contains the addresses of merged cell ranges
+ * in the current sheet.
+ *
+ * -- "OpenOffice.org's Documentation of the Microsoft
+ * Excel File Format"
+ */
+ private function readMergedCells(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->version == self::XLS_BIFF8 && !$this->readDataOnly) {
+ $cellRangeAddressList = $this->readBIFF8CellRangeAddressList($recordData);
+ foreach ($cellRangeAddressList['cellRangeAddresses'] as $cellRangeAddress) {
+ if (
+ (str_contains($cellRangeAddress, ':'))
+ && ($this->includeCellRangeFiltered($cellRangeAddress))
+ ) {
+ $this->phpSheet->mergeCells($cellRangeAddress, Worksheet::MERGE_CELL_CONTENT_HIDE);
+ }
+ }
+ }
+ }
+
+ /**
+ * Read HYPERLINK record.
+ */
+ private function readHyperLink(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer forward to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 8; cell range address of all cells containing this hyperlink
+ try {
+ $cellRange = $this->readBIFF8CellRangeAddressFixed($recordData);
+ } catch (PhpSpreadsheetException) {
+ return;
+ }
+
+ // offset: 8, size: 16; GUID of StdLink
+
+ // offset: 24, size: 4; unknown value
+
+ // offset: 28, size: 4; option flags
+ // bit: 0; mask: 0x00000001; 0 = no link or extant, 1 = file link or URL
+ $isFileLinkOrUrl = (0x00000001 & self::getUInt2d($recordData, 28)) >> 0;
+
+ // bit: 1; mask: 0x00000002; 0 = relative path, 1 = absolute path or URL
+ //$isAbsPathOrUrl = (0x00000001 & self::getUInt2d($recordData, 28)) >> 1;
+
+ // bit: 2 (and 4); mask: 0x00000014; 0 = no description
+ $hasDesc = (0x00000014 & self::getUInt2d($recordData, 28)) >> 2;
+
+ // bit: 3; mask: 0x00000008; 0 = no text, 1 = has text
+ $hasText = (0x00000008 & self::getUInt2d($recordData, 28)) >> 3;
+
+ // bit: 7; mask: 0x00000080; 0 = no target frame, 1 = has target frame
+ $hasFrame = (0x00000080 & self::getUInt2d($recordData, 28)) >> 7;
+
+ // bit: 8; mask: 0x00000100; 0 = file link or URL, 1 = UNC path (inc. server name)
+ $isUNC = (0x00000100 & self::getUInt2d($recordData, 28)) >> 8;
+
+ // offset within record data
+ $offset = 32;
+
+ if ($hasDesc) {
+ // offset: 32; size: var; character count of description text
+ $dl = self::getInt4d($recordData, 32);
+ // offset: 36; size: var; character array of description text, no Unicode string header, always 16-bit characters, zero terminated
+ //$desc = self::encodeUTF16(substr($recordData, 36, 2 * ($dl - 1)), false);
+ $offset += 4 + 2 * $dl;
+ }
+ if ($hasFrame) {
+ $fl = self::getInt4d($recordData, $offset);
+ $offset += 4 + 2 * $fl;
+ }
+
+ // detect type of hyperlink (there are 4 types)
+ $hyperlinkType = null;
+
+ if ($isUNC) {
+ $hyperlinkType = 'UNC';
+ } elseif (!$isFileLinkOrUrl) {
+ $hyperlinkType = 'workbook';
+ } elseif (ord($recordData[$offset]) == 0x03) {
+ $hyperlinkType = 'local';
+ } elseif (ord($recordData[$offset]) == 0xE0) {
+ $hyperlinkType = 'URL';
+ }
+
+ switch ($hyperlinkType) {
+ case 'URL':
+ // section 5.58.2: Hyperlink containing a URL
+ // e.g. http://example.org/index.php
+
+ // offset: var; size: 16; GUID of URL Moniker
+ $offset += 16;
+ // offset: var; size: 4; size (in bytes) of character array of the URL including trailing zero word
+ $us = self::getInt4d($recordData, $offset);
+ $offset += 4;
+ // offset: var; size: $us; character array of the URL, no Unicode string header, always 16-bit characters, zero-terminated
+ $url = self::encodeUTF16(substr($recordData, $offset, $us - 2), false);
+ $nullOffset = strpos($url, chr(0x00));
+ if ($nullOffset) {
+ $url = substr($url, 0, $nullOffset);
+ }
+ $url .= $hasText ? '#' : '';
+ $offset += $us;
+
+ break;
+ case 'local':
+ // section 5.58.3: Hyperlink to local file
+ // examples:
+ // mydoc.txt
+ // ../../somedoc.xls#Sheet!A1
+
+ // offset: var; size: 16; GUI of File Moniker
+ $offset += 16;
+
+ // offset: var; size: 2; directory up-level count.
+ $upLevelCount = self::getUInt2d($recordData, $offset);
+ $offset += 2;
+
+ // offset: var; size: 4; character count of the shortened file path and name, including trailing zero word
+ $sl = self::getInt4d($recordData, $offset);
+ $offset += 4;
+
+ // offset: var; size: sl; character array of the shortened file path and name in 8.3-DOS-format (compressed Unicode string)
+ $shortenedFilePath = substr($recordData, $offset, $sl);
+ $shortenedFilePath = self::encodeUTF16($shortenedFilePath, true);
+ $shortenedFilePath = substr($shortenedFilePath, 0, -1); // remove trailing zero
+
+ $offset += $sl;
+
+ // offset: var; size: 24; unknown sequence
+ $offset += 24;
+
+ // extended file path
+ // offset: var; size: 4; size of the following file link field including string lenth mark
+ $sz = self::getInt4d($recordData, $offset);
+ $offset += 4;
+
+ $extendedFilePath = '';
+ // only present if $sz > 0
+ if ($sz > 0) {
+ // offset: var; size: 4; size of the character array of the extended file path and name
+ $xl = self::getInt4d($recordData, $offset);
+ $offset += 4;
+
+ // offset: var; size 2; unknown
+ $offset += 2;
+
+ // offset: var; size $xl; character array of the extended file path and name.
+ $extendedFilePath = substr($recordData, $offset, $xl);
+ $extendedFilePath = self::encodeUTF16($extendedFilePath, false);
+ $offset += $xl;
+ }
+
+ // construct the path
+ $url = str_repeat('..\\', $upLevelCount);
+ $url .= ($sz > 0) ? $extendedFilePath : $shortenedFilePath; // use extended path if available
+ $url .= $hasText ? '#' : '';
+
+ break;
+ case 'UNC':
+ // section 5.58.4: Hyperlink to a File with UNC (Universal Naming Convention) Path
+ // todo: implement
+ return;
+ case 'workbook':
+ // section 5.58.5: Hyperlink to the Current Workbook
+ // e.g. Sheet2!B1:C2, stored in text mark field
+ $url = 'sheet://';
+
+ break;
+ default:
+ return;
+ }
+
+ if ($hasText) {
+ // offset: var; size: 4; character count of text mark including trailing zero word
+ $tl = self::getInt4d($recordData, $offset);
+ $offset += 4;
+ // offset: var; size: var; character array of the text mark without the # sign, no Unicode header, always 16-bit characters, zero-terminated
+ $text = self::encodeUTF16(substr($recordData, $offset, 2 * ($tl - 1)), false);
+ $url .= $text;
+ }
+
+ // apply the hyperlink to all the relevant cells
+ foreach (Coordinate::extractAllCellReferencesInRange($cellRange) as $coordinate) {
+ $this->phpSheet->getCell($coordinate)->getHyperLink()->setUrl($url);
+ }
+ }
+ }
+
+ /**
+ * Read DATAVALIDATIONS record.
+ */
+ private function readDataValidations(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ //$recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer forward to next record
+ $this->pos += 4 + $length;
+ }
+
+ /**
+ * Read DATAVALIDATION record.
+ */
+ private function readDataValidation(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer forward to next record
+ $this->pos += 4 + $length;
+
+ if ($this->readDataOnly) {
+ return;
+ }
+
+ // offset: 0; size: 4; Options
+ $options = self::getInt4d($recordData, 0);
+
+ // bit: 0-3; mask: 0x0000000F; type
+ $type = (0x0000000F & $options) >> 0;
+ $type = Xls\DataValidationHelper::type($type);
+
+ // bit: 4-6; mask: 0x00000070; error type
+ $errorStyle = (0x00000070 & $options) >> 4;
+ $errorStyle = Xls\DataValidationHelper::errorStyle($errorStyle);
+
+ // bit: 7; mask: 0x00000080; 1= formula is explicit (only applies to list)
+ // I have only seen cases where this is 1
+ //$explicitFormula = (0x00000080 & $options) >> 7;
+
+ // bit: 8; mask: 0x00000100; 1= empty cells allowed
+ $allowBlank = (0x00000100 & $options) >> 8;
+
+ // bit: 9; mask: 0x00000200; 1= suppress drop down arrow in list type validity
+ $suppressDropDown = (0x00000200 & $options) >> 9;
+
+ // bit: 18; mask: 0x00040000; 1= show prompt box if cell selected
+ $showInputMessage = (0x00040000 & $options) >> 18;
+
+ // bit: 19; mask: 0x00080000; 1= show error box if invalid values entered
+ $showErrorMessage = (0x00080000 & $options) >> 19;
+
+ // bit: 20-23; mask: 0x00F00000; condition operator
+ $operator = (0x00F00000 & $options) >> 20;
+ $operator = Xls\DataValidationHelper::operator($operator);
+
+ if ($type === null || $errorStyle === null || $operator === null) {
+ return;
+ }
+
+ // offset: 4; size: var; title of the prompt box
+ $offset = 4;
+ $string = self::readUnicodeStringLong(substr($recordData, $offset));
+ $promptTitle = $string['value'] !== chr(0) ? $string['value'] : '';
+ $offset += $string['size'];
+
+ // offset: var; size: var; title of the error box
+ $string = self::readUnicodeStringLong(substr($recordData, $offset));
+ $errorTitle = $string['value'] !== chr(0) ? $string['value'] : '';
+ $offset += $string['size'];
+
+ // offset: var; size: var; text of the prompt box
+ $string = self::readUnicodeStringLong(substr($recordData, $offset));
+ $prompt = $string['value'] !== chr(0) ? $string['value'] : '';
+ $offset += $string['size'];
+
+ // offset: var; size: var; text of the error box
+ $string = self::readUnicodeStringLong(substr($recordData, $offset));
+ $error = $string['value'] !== chr(0) ? $string['value'] : '';
+ $offset += $string['size'];
+
+ // offset: var; size: 2; size of the formula data for the first condition
+ $sz1 = self::getUInt2d($recordData, $offset);
+ $offset += 2;
+
+ // offset: var; size: 2; not used
+ $offset += 2;
+
+ // offset: var; size: $sz1; formula data for first condition (without size field)
+ $formula1 = substr($recordData, $offset, $sz1);
+ $formula1 = pack('v', $sz1) . $formula1; // prepend the length
+
+ try {
+ $formula1 = $this->getFormulaFromStructure($formula1);
+
+ // in list type validity, null characters are used as item separators
+ if ($type == DataValidation::TYPE_LIST) {
+ $formula1 = str_replace(chr(0), ',', $formula1);
+ }
+ } catch (PhpSpreadsheetException $e) {
+ return;
+ }
+ $offset += $sz1;
+
+ // offset: var; size: 2; size of the formula data for the first condition
+ $sz2 = self::getUInt2d($recordData, $offset);
+ $offset += 2;
+
+ // offset: var; size: 2; not used
+ $offset += 2;
+
+ // offset: var; size: $sz2; formula data for second condition (without size field)
+ $formula2 = substr($recordData, $offset, $sz2);
+ $formula2 = pack('v', $sz2) . $formula2; // prepend the length
+
+ try {
+ $formula2 = $this->getFormulaFromStructure($formula2);
+ } catch (PhpSpreadsheetException) {
+ return;
+ }
+ $offset += $sz2;
+
+ // offset: var; size: var; cell range address list with
+ $cellRangeAddressList = $this->readBIFF8CellRangeAddressList(substr($recordData, $offset));
+ $cellRangeAddresses = $cellRangeAddressList['cellRangeAddresses'];
+
+ foreach ($cellRangeAddresses as $cellRange) {
+ $stRange = $this->phpSheet->shrinkRangeToFit($cellRange);
+ foreach (Coordinate::extractAllCellReferencesInRange($stRange) as $coordinate) {
+ $objValidation = $this->phpSheet->getCell($coordinate)->getDataValidation();
+ $objValidation->setType($type);
+ $objValidation->setErrorStyle($errorStyle);
+ $objValidation->setAllowBlank((bool) $allowBlank);
+ $objValidation->setShowInputMessage((bool) $showInputMessage);
+ $objValidation->setShowErrorMessage((bool) $showErrorMessage);
+ $objValidation->setShowDropDown(!$suppressDropDown);
+ $objValidation->setOperator($operator);
+ $objValidation->setErrorTitle($errorTitle);
+ $objValidation->setError($error);
+ $objValidation->setPromptTitle($promptTitle);
+ $objValidation->setPrompt($prompt);
+ $objValidation->setFormula1($formula1);
+ $objValidation->setFormula2($formula2);
+ }
+ }
+ }
+
+ /**
+ * Read SHEETLAYOUT record. Stores sheet tab color information.
+ */
+ private function readSheetLayout(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if (!$this->readDataOnly) {
+ // offset: 0; size: 2; repeated record identifier 0x0862
+
+ // offset: 2; size: 10; not used
+
+ // offset: 12; size: 4; size of record data
+ // Excel 2003 uses size of 0x14 (documented), Excel 2007 uses size of 0x28 (not documented?)
+ $sz = self::getInt4d($recordData, 12);
+
+ switch ($sz) {
+ case 0x14:
+ // offset: 16; size: 2; color index for sheet tab
+ $colorIndex = self::getUInt2d($recordData, 16);
+ $color = Xls\Color::map($colorIndex, $this->palette, $this->version);
+ $this->phpSheet->getTabColor()->setRGB($color['rgb']);
+
+ break;
+ case 0x28:
+ // TODO: Investigate structure for .xls SHEETLAYOUT record as saved by MS Office Excel 2007
+ return;
+ }
+ }
+ }
+
+ /**
+ * Read SHEETPROTECTION record (FEATHEADR).
+ */
+ private function readSheetProtection(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ if ($this->readDataOnly) {
+ return;
+ }
+
+ // offset: 0; size: 2; repeated record header
+
+ // offset: 2; size: 2; FRT cell reference flag (=0 currently)
+
+ // offset: 4; size: 8; Currently not used and set to 0
+
+ // offset: 12; size: 2; Shared feature type index (2=Enhanced Protetion, 4=SmartTag)
+ $isf = self::getUInt2d($recordData, 12);
+ if ($isf != 2) {
+ return;
+ }
+
+ // offset: 14; size: 1; =1 since this is a feat header
+
+ // offset: 15; size: 4; size of rgbHdrSData
+
+ // rgbHdrSData, assume "Enhanced Protection"
+ // offset: 19; size: 2; option flags
+ $options = self::getUInt2d($recordData, 19);
+
+ // bit: 0; mask 0x0001; 1 = user may edit objects, 0 = users must not edit objects
+ // Note - do not negate $bool
+ $bool = (0x0001 & $options) >> 0;
+ $this->phpSheet->getProtection()->setObjects((bool) $bool);
+
+ // bit: 1; mask 0x0002; edit scenarios
+ // Note - do not negate $bool
+ $bool = (0x0002 & $options) >> 1;
+ $this->phpSheet->getProtection()->setScenarios((bool) $bool);
+
+ // bit: 2; mask 0x0004; format cells
+ $bool = (0x0004 & $options) >> 2;
+ $this->phpSheet->getProtection()->setFormatCells(!$bool);
+
+ // bit: 3; mask 0x0008; format columns
+ $bool = (0x0008 & $options) >> 3;
+ $this->phpSheet->getProtection()->setFormatColumns(!$bool);
+
+ // bit: 4; mask 0x0010; format rows
+ $bool = (0x0010 & $options) >> 4;
+ $this->phpSheet->getProtection()->setFormatRows(!$bool);
+
+ // bit: 5; mask 0x0020; insert columns
+ $bool = (0x0020 & $options) >> 5;
+ $this->phpSheet->getProtection()->setInsertColumns(!$bool);
+
+ // bit: 6; mask 0x0040; insert rows
+ $bool = (0x0040 & $options) >> 6;
+ $this->phpSheet->getProtection()->setInsertRows(!$bool);
+
+ // bit: 7; mask 0x0080; insert hyperlinks
+ $bool = (0x0080 & $options) >> 7;
+ $this->phpSheet->getProtection()->setInsertHyperlinks(!$bool);
+
+ // bit: 8; mask 0x0100; delete columns
+ $bool = (0x0100 & $options) >> 8;
+ $this->phpSheet->getProtection()->setDeleteColumns(!$bool);
+
+ // bit: 9; mask 0x0200; delete rows
+ $bool = (0x0200 & $options) >> 9;
+ $this->phpSheet->getProtection()->setDeleteRows(!$bool);
+
+ // bit: 10; mask 0x0400; select locked cells
+ // Note that this is opposite of most of above.
+ $bool = (0x0400 & $options) >> 10;
+ $this->phpSheet->getProtection()->setSelectLockedCells((bool) $bool);
+
+ // bit: 11; mask 0x0800; sort cell range
+ $bool = (0x0800 & $options) >> 11;
+ $this->phpSheet->getProtection()->setSort(!$bool);
+
+ // bit: 12; mask 0x1000; auto filter
+ $bool = (0x1000 & $options) >> 12;
+ $this->phpSheet->getProtection()->setAutoFilter(!$bool);
+
+ // bit: 13; mask 0x2000; pivot tables
+ $bool = (0x2000 & $options) >> 13;
+ $this->phpSheet->getProtection()->setPivotTables(!$bool);
+
+ // bit: 14; mask 0x4000; select unlocked cells
+ // Note that this is opposite of most of above.
+ $bool = (0x4000 & $options) >> 14;
+ $this->phpSheet->getProtection()->setSelectUnlockedCells((bool) $bool);
+
+ // offset: 21; size: 2; not used
+ }
+
+ /**
+ * Read RANGEPROTECTION record
+ * Reading of this record is based on Microsoft Office Excel 97-2000 Binary File Format Specification,
+ * where it is referred to as FEAT record.
+ */
+ private function readRangeProtection(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ // local pointer in record data
+ $offset = 0;
+
+ if (!$this->readDataOnly) {
+ $offset += 12;
+
+ // offset: 12; size: 2; shared feature type, 2 = enhanced protection, 4 = smart tag
+ $isf = self::getUInt2d($recordData, 12);
+ if ($isf != 2) {
+ // we only read FEAT records of type 2
+ return;
+ }
+ $offset += 2;
+
+ $offset += 5;
+
+ // offset: 19; size: 2; count of ref ranges this feature is on
+ $cref = self::getUInt2d($recordData, 19);
+ $offset += 2;
+
+ $offset += 6;
+
+ // offset: 27; size: 8 * $cref; list of cell ranges (like in hyperlink record)
+ $cellRanges = [];
+ for ($i = 0; $i < $cref; ++$i) {
+ try {
+ $cellRange = $this->readBIFF8CellRangeAddressFixed(substr($recordData, 27 + 8 * $i, 8));
+ } catch (PhpSpreadsheetException) {
+ return;
+ }
+ $cellRanges[] = $cellRange;
+ $offset += 8;
+ }
+
+ // offset: var; size: var; variable length of feature specific data
+ //$rgbFeat = substr($recordData, $offset);
+ $offset += 4;
+
+ // offset: var; size: 4; the encrypted password (only 16-bit although field is 32-bit)
+ $wPassword = self::getInt4d($recordData, $offset);
+ $offset += 4;
+
+ // Apply range protection to sheet
+ if ($cellRanges) {
+ $this->phpSheet->protectCells(implode(' ', $cellRanges), ($wPassword === 0) ? '' : strtoupper(dechex($wPassword)), true);
+ }
+ }
+ }
+
+ /**
+ * Read a free CONTINUE record. Free CONTINUE record may be a camouflaged MSODRAWING record
+ * When MSODRAWING data on a sheet exceeds 8224 bytes, CONTINUE records are used instead. Undocumented.
+ * In this case, we must treat the CONTINUE record as a MSODRAWING record.
+ */
+ private function readContinue(): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // check if we are reading drawing data
+ // this is in case a free CONTINUE record occurs in other circumstances we are unaware of
+ if ($this->drawingData == '') {
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ return;
+ }
+
+ // check if record data is at least 4 bytes long, otherwise there is no chance this is MSODRAWING data
+ if ($length < 4) {
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+
+ return;
+ }
+
+ // dirty check to see if CONTINUE record could be a camouflaged MSODRAWING record
+ // look inside CONTINUE record to see if it looks like a part of an Escher stream
+ // we know that Escher stream may be split at least at
+ // 0xF003 MsofbtSpgrContainer
+ // 0xF004 MsofbtSpContainer
+ // 0xF00D MsofbtClientTextbox
+ $validSplitPoints = [0xF003, 0xF004, 0xF00D]; // add identifiers if we find more
+
+ $splitPoint = self::getUInt2d($recordData, 2);
+ if (in_array($splitPoint, $validSplitPoints)) {
+ // get spliced record data (and move pointer to next record)
+ $splicedRecordData = $this->getSplicedRecordData();
+ $this->drawingData .= $splicedRecordData['recordData'];
+
+ return;
+ }
+
+ // move stream pointer to next record
+ $this->pos += 4 + $length;
+ }
+
+ /**
+ * Reads a record from current position in data stream and continues reading data as long as CONTINUE
+ * records are found. Splices the record data pieces and returns the combined string as if record data
+ * is in one piece.
+ * Moves to next current position in data stream to start of next record different from a CONtINUE record.
+ */
+ private function getSplicedRecordData(): array
+ {
+ $data = '';
+ $spliceOffsets = [];
+
+ $i = 0;
+ $spliceOffsets[0] = 0;
+
+ do {
+ ++$i;
+
+ // offset: 0; size: 2; identifier
+ //$identifier = self::getUInt2d($this->data, $this->pos);
+ // offset: 2; size: 2; length
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $data .= $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ $spliceOffsets[$i] = $spliceOffsets[$i - 1] + $length;
+
+ $this->pos += 4 + $length;
+ $nextIdentifier = self::getUInt2d($this->data, $this->pos);
+ } while ($nextIdentifier == self::XLS_TYPE_CONTINUE);
+
+ return [
+ 'recordData' => $data,
+ 'spliceOffsets' => $spliceOffsets,
+ ];
+ }
+
+ /**
+ * Convert formula structure into human readable Excel formula like 'A3+A5*5'.
+ *
+ * @param string $formulaStructure The complete binary data for the formula
+ * @param string $baseCell Base cell, only needed when formula contains tRefN tokens, e.g. with shared formulas
+ *
+ * @return string Human readable formula
+ */
+ private function getFormulaFromStructure(string $formulaStructure, string $baseCell = 'A1'): string
+ {
+ // offset: 0; size: 2; size of the following formula data
+ $sz = self::getUInt2d($formulaStructure, 0);
+
+ // offset: 2; size: sz
+ $formulaData = substr($formulaStructure, 2, $sz);
+
+ // offset: 2 + sz; size: variable (optional)
+ if (strlen($formulaStructure) > 2 + $sz) {
+ $additionalData = substr($formulaStructure, 2 + $sz);
+ } else {
+ $additionalData = '';
+ }
+
+ return $this->getFormulaFromData($formulaData, $additionalData, $baseCell);
+ }
+
+ /**
+ * Take formula data and additional data for formula and return human readable formula.
+ *
+ * @param string $formulaData The binary data for the formula itself
+ * @param string $additionalData Additional binary data going with the formula
+ * @param string $baseCell Base cell, only needed when formula contains tRefN tokens, e.g. with shared formulas
+ *
+ * @return string Human readable formula
+ */
+ private function getFormulaFromData(string $formulaData, string $additionalData = '', string $baseCell = 'A1'): string
+ {
+ // start parsing the formula data
+ $tokens = [];
+
+ while ($formulaData !== '' && $token = $this->getNextToken($formulaData, $baseCell)) {
+ $tokens[] = $token;
+ $formulaData = substr($formulaData, $token['size']);
+ }
+
+ $formulaString = $this->createFormulaFromTokens($tokens, $additionalData);
+
+ return $formulaString;
+ }
+
+ /**
+ * Take array of tokens together with additional data for formula and return human readable formula.
+ *
+ * @param string $additionalData Additional binary data going with the formula
+ *
+ * @return string Human readable formula
+ */
+ private function createFormulaFromTokens(array $tokens, string $additionalData): string
+ {
+ // empty formula?
+ if (empty($tokens)) {
+ return '';
+ }
+
+ $formulaStrings = [];
+ foreach ($tokens as $token) {
+ // initialize spaces
+ $space0 = $space0 ?? ''; // spaces before next token, not tParen
+ $space1 = $space1 ?? ''; // carriage returns before next token, not tParen
+ $space2 = $space2 ?? ''; // spaces before opening parenthesis
+ $space3 = $space3 ?? ''; // carriage returns before opening parenthesis
+ $space4 = $space4 ?? ''; // spaces before closing parenthesis
+ $space5 = $space5 ?? ''; // carriage returns before closing parenthesis
+
+ switch ($token['name']) {
+ case 'tAdd': // addition
+ case 'tConcat': // addition
+ case 'tDiv': // division
+ case 'tEQ': // equality
+ case 'tGE': // greater than or equal
+ case 'tGT': // greater than
+ case 'tIsect': // intersection
+ case 'tLE': // less than or equal
+ case 'tList': // less than or equal
+ case 'tLT': // less than
+ case 'tMul': // multiplication
+ case 'tNE': // multiplication
+ case 'tPower': // power
+ case 'tRange': // range
+ case 'tSub': // subtraction
+ $op2 = array_pop($formulaStrings);
+ $op1 = array_pop($formulaStrings);
+ $formulaStrings[] = "$op1$space1$space0{$token['data']}$op2";
+ unset($space0, $space1);
+
+ break;
+ case 'tUplus': // unary plus
+ case 'tUminus': // unary minus
+ $op = array_pop($formulaStrings);
+ $formulaStrings[] = "$space1$space0{$token['data']}$op";
+ unset($space0, $space1);
+
+ break;
+ case 'tPercent': // percent sign
+ $op = array_pop($formulaStrings);
+ $formulaStrings[] = "$op$space1$space0{$token['data']}";
+ unset($space0, $space1);
+
+ break;
+ case 'tAttrVolatile': // indicates volatile function
+ case 'tAttrIf':
+ case 'tAttrSkip':
+ case 'tAttrChoose':
+ // token is only important for Excel formula evaluator
+ // do nothing
+ break;
+ case 'tAttrSpace': // space / carriage return
+ // space will be used when next token arrives, do not alter formulaString stack
+ switch ($token['data']['spacetype']) {
+ case 'type0':
+ $space0 = str_repeat(' ', $token['data']['spacecount']);
+
+ break;
+ case 'type1':
+ $space1 = str_repeat("\n", $token['data']['spacecount']);
+
+ break;
+ case 'type2':
+ $space2 = str_repeat(' ', $token['data']['spacecount']);
+
+ break;
+ case 'type3':
+ $space3 = str_repeat("\n", $token['data']['spacecount']);
+
+ break;
+ case 'type4':
+ $space4 = str_repeat(' ', $token['data']['spacecount']);
+
+ break;
+ case 'type5':
+ $space5 = str_repeat("\n", $token['data']['spacecount']);
+
+ break;
+ }
+
+ break;
+ case 'tAttrSum': // SUM function with one parameter
+ $op = array_pop($formulaStrings);
+ $formulaStrings[] = "{$space1}{$space0}SUM($op)";
+ unset($space0, $space1);
+
+ break;
+ case 'tFunc': // function with fixed number of arguments
+ case 'tFuncV': // function with variable number of arguments
+ if ($token['data']['function'] != '') {
+ // normal function
+ $ops = []; // array of operators
+ for ($i = 0; $i < $token['data']['args']; ++$i) {
+ $ops[] = array_pop($formulaStrings);
+ }
+ $ops = array_reverse($ops);
+ $formulaStrings[] = "$space1$space0{$token['data']['function']}(" . implode(',', $ops) . ')';
+ unset($space0, $space1);
+ } else {
+ // add-in function
+ $ops = []; // array of operators
+ for ($i = 0; $i < $token['data']['args'] - 1; ++$i) {
+ $ops[] = array_pop($formulaStrings);
+ }
+ $ops = array_reverse($ops);
+ $function = array_pop($formulaStrings);
+ $formulaStrings[] = "$space1$space0$function(" . implode(',', $ops) . ')';
+ unset($space0, $space1);
+ }
+
+ break;
+ case 'tParen': // parenthesis
+ $expression = array_pop($formulaStrings);
+ $formulaStrings[] = "$space3$space2($expression$space5$space4)";
+ unset($space2, $space3, $space4, $space5);
+
+ break;
+ case 'tArray': // array constant
+ $constantArray = self::readBIFF8ConstantArray($additionalData);
+ $formulaStrings[] = $space1 . $space0 . $constantArray['value'];
+ $additionalData = substr($additionalData, $constantArray['size']); // bite of chunk of additional data
+ unset($space0, $space1);
+
+ break;
+ case 'tMemArea':
+ // bite off chunk of additional data
+ $cellRangeAddressList = $this->readBIFF8CellRangeAddressList($additionalData);
+ $additionalData = substr($additionalData, $cellRangeAddressList['size']);
+ $formulaStrings[] = "$space1$space0{$token['data']}";
+ unset($space0, $space1);
+
+ break;
+ case 'tArea': // cell range address
+ case 'tBool': // boolean
+ case 'tErr': // error code
+ case 'tInt': // integer
+ case 'tMemErr':
+ case 'tMemFunc':
+ case 'tMissArg':
+ case 'tName':
+ case 'tNameX':
+ case 'tNum': // number
+ case 'tRef': // single cell reference
+ case 'tRef3d': // 3d cell reference
+ case 'tArea3d': // 3d cell range reference
+ case 'tRefN':
+ case 'tAreaN':
+ case 'tStr': // string
+ $formulaStrings[] = "$space1$space0{$token['data']}";
+ unset($space0, $space1);
+
+ break;
+ }
+ }
+ $formulaString = $formulaStrings[0];
+
+ return $formulaString;
+ }
+
+ /**
+ * Fetch next token from binary formula data.
+ *
+ * @param string $formulaData Formula data
+ * @param string $baseCell Base cell, only needed when formula contains tRefN tokens, e.g. with shared formulas
+ */
+ private function getNextToken(string $formulaData, string $baseCell = 'A1'): array
+ {
+ // offset: 0; size: 1; token id
+ $id = ord($formulaData[0]); // token id
+ $name = false; // initialize token name
+
+ switch ($id) {
+ case 0x03:
+ $name = 'tAdd';
+ $size = 1;
+ $data = '+';
+
+ break;
+ case 0x04:
+ $name = 'tSub';
+ $size = 1;
+ $data = '-';
+
+ break;
+ case 0x05:
+ $name = 'tMul';
+ $size = 1;
+ $data = '*';
+
+ break;
+ case 0x06:
+ $name = 'tDiv';
+ $size = 1;
+ $data = '/';
+
+ break;
+ case 0x07:
+ $name = 'tPower';
+ $size = 1;
+ $data = '^';
+
+ break;
+ case 0x08:
+ $name = 'tConcat';
+ $size = 1;
+ $data = '&';
+
+ break;
+ case 0x09:
+ $name = 'tLT';
+ $size = 1;
+ $data = '<';
+
+ break;
+ case 0x0A:
+ $name = 'tLE';
+ $size = 1;
+ $data = '<=';
+
+ break;
+ case 0x0B:
+ $name = 'tEQ';
+ $size = 1;
+ $data = '=';
+
+ break;
+ case 0x0C:
+ $name = 'tGE';
+ $size = 1;
+ $data = '>=';
+
+ break;
+ case 0x0D:
+ $name = 'tGT';
+ $size = 1;
+ $data = '>';
+
+ break;
+ case 0x0E:
+ $name = 'tNE';
+ $size = 1;
+ $data = '<>';
+
+ break;
+ case 0x0F:
+ $name = 'tIsect';
+ $size = 1;
+ $data = ' ';
+
+ break;
+ case 0x10:
+ $name = 'tList';
+ $size = 1;
+ $data = ',';
+
+ break;
+ case 0x11:
+ $name = 'tRange';
+ $size = 1;
+ $data = ':';
+
+ break;
+ case 0x12:
+ $name = 'tUplus';
+ $size = 1;
+ $data = '+';
+
+ break;
+ case 0x13:
+ $name = 'tUminus';
+ $size = 1;
+ $data = '-';
+
+ break;
+ case 0x14:
+ $name = 'tPercent';
+ $size = 1;
+ $data = '%';
+
+ break;
+ case 0x15: // parenthesis
+ $name = 'tParen';
+ $size = 1;
+ $data = null;
+
+ break;
+ case 0x16: // missing argument
+ $name = 'tMissArg';
+ $size = 1;
+ $data = '';
+
+ break;
+ case 0x17: // string
+ $name = 'tStr';
+ // offset: 1; size: var; Unicode string, 8-bit string length
+ $string = self::readUnicodeStringShort(substr($formulaData, 1));
+ $size = 1 + $string['size'];
+ $data = self::UTF8toExcelDoubleQuoted($string['value']);
+
+ break;
+ case 0x19: // Special attribute
+ // offset: 1; size: 1; attribute type flags:
+ switch (ord($formulaData[1])) {
+ case 0x01:
+ $name = 'tAttrVolatile';
+ $size = 4;
+ $data = null;
+
+ break;
+ case 0x02:
+ $name = 'tAttrIf';
+ $size = 4;
+ $data = null;
+
+ break;
+ case 0x04:
+ $name = 'tAttrChoose';
+ // offset: 2; size: 2; number of choices in the CHOOSE function ($nc, number of parameters decreased by 1)
+ $nc = self::getUInt2d($formulaData, 2);
+ // offset: 4; size: 2 * $nc
+ // offset: 4 + 2 * $nc; size: 2
+ $size = 2 * $nc + 6;
+ $data = null;
+
+ break;
+ case 0x08:
+ $name = 'tAttrSkip';
+ $size = 4;
+ $data = null;
+
+ break;
+ case 0x10:
+ $name = 'tAttrSum';
+ $size = 4;
+ $data = null;
+
+ break;
+ case 0x40:
+ case 0x41:
+ $name = 'tAttrSpace';
+ $size = 4;
+ // offset: 2; size: 2; space type and position
+ $spacetype = match (ord($formulaData[2])) {
+ 0x00 => 'type0',
+ 0x01 => 'type1',
+ 0x02 => 'type2',
+ 0x03 => 'type3',
+ 0x04 => 'type4',
+ 0x05 => 'type5',
+ default => throw new Exception('Unrecognized space type in tAttrSpace token'),
+ };
+ // offset: 3; size: 1; number of inserted spaces/carriage returns
+ $spacecount = ord($formulaData[3]);
+
+ $data = ['spacetype' => $spacetype, 'spacecount' => $spacecount];
+
+ break;
+ default:
+ throw new Exception('Unrecognized attribute flag in tAttr token');
+ }
+
+ break;
+ case 0x1C: // error code
+ // offset: 1; size: 1; error code
+ $name = 'tErr';
+ $size = 2;
+ $data = Xls\ErrorCode::lookup(ord($formulaData[1]));
+
+ break;
+ case 0x1D: // boolean
+ // offset: 1; size: 1; 0 = false, 1 = true;
+ $name = 'tBool';
+ $size = 2;
+ $data = ord($formulaData[1]) ? 'TRUE' : 'FALSE';
+
+ break;
+ case 0x1E: // integer
+ // offset: 1; size: 2; unsigned 16-bit integer
+ $name = 'tInt';
+ $size = 3;
+ $data = self::getUInt2d($formulaData, 1);
+
+ break;
+ case 0x1F: // number
+ // offset: 1; size: 8;
+ $name = 'tNum';
+ $size = 9;
+ $data = self::extractNumber(substr($formulaData, 1));
+ $data = str_replace(',', '.', (string) $data); // in case non-English locale
+
+ break;
+ case 0x20: // array constant
+ case 0x40:
+ case 0x60:
+ // offset: 1; size: 7; not used
+ $name = 'tArray';
+ $size = 8;
+ $data = null;
+
+ break;
+ case 0x21: // function with fixed number of arguments
+ case 0x41:
+ case 0x61:
+ $name = 'tFunc';
+ $size = 3;
+ // offset: 1; size: 2; index to built-in sheet function
+ switch (self::getUInt2d($formulaData, 1)) {
+ case 2:
+ $function = 'ISNA';
+ $args = 1;
+
+ break;
+ case 3:
+ $function = 'ISERROR';
+ $args = 1;
+
+ break;
+ case 10:
+ $function = 'NA';
+ $args = 0;
+
+ break;
+ case 15:
+ $function = 'SIN';
+ $args = 1;
+
+ break;
+ case 16:
+ $function = 'COS';
+ $args = 1;
+
+ break;
+ case 17:
+ $function = 'TAN';
+ $args = 1;
+
+ break;
+ case 18:
+ $function = 'ATAN';
+ $args = 1;
+
+ break;
+ case 19:
+ $function = 'PI';
+ $args = 0;
+
+ break;
+ case 20:
+ $function = 'SQRT';
+ $args = 1;
+
+ break;
+ case 21:
+ $function = 'EXP';
+ $args = 1;
+
+ break;
+ case 22:
+ $function = 'LN';
+ $args = 1;
+
+ break;
+ case 23:
+ $function = 'LOG10';
+ $args = 1;
+
+ break;
+ case 24:
+ $function = 'ABS';
+ $args = 1;
+
+ break;
+ case 25:
+ $function = 'INT';
+ $args = 1;
+
+ break;
+ case 26:
+ $function = 'SIGN';
+ $args = 1;
+
+ break;
+ case 27:
+ $function = 'ROUND';
+ $args = 2;
+
+ break;
+ case 30:
+ $function = 'REPT';
+ $args = 2;
+
+ break;
+ case 31:
+ $function = 'MID';
+ $args = 3;
+
+ break;
+ case 32:
+ $function = 'LEN';
+ $args = 1;
+
+ break;
+ case 33:
+ $function = 'VALUE';
+ $args = 1;
+
+ break;
+ case 34:
+ $function = 'TRUE';
+ $args = 0;
+
+ break;
+ case 35:
+ $function = 'FALSE';
+ $args = 0;
+
+ break;
+ case 38:
+ $function = 'NOT';
+ $args = 1;
+
+ break;
+ case 39:
+ $function = 'MOD';
+ $args = 2;
+
+ break;
+ case 40:
+ $function = 'DCOUNT';
+ $args = 3;
+
+ break;
+ case 41:
+ $function = 'DSUM';
+ $args = 3;
+
+ break;
+ case 42:
+ $function = 'DAVERAGE';
+ $args = 3;
+
+ break;
+ case 43:
+ $function = 'DMIN';
+ $args = 3;
+
+ break;
+ case 44:
+ $function = 'DMAX';
+ $args = 3;
+
+ break;
+ case 45:
+ $function = 'DSTDEV';
+ $args = 3;
+
+ break;
+ case 48:
+ $function = 'TEXT';
+ $args = 2;
+
+ break;
+ case 61:
+ $function = 'MIRR';
+ $args = 3;
+
+ break;
+ case 63:
+ $function = 'RAND';
+ $args = 0;
+
+ break;
+ case 65:
+ $function = 'DATE';
+ $args = 3;
+
+ break;
+ case 66:
+ $function = 'TIME';
+ $args = 3;
+
+ break;
+ case 67:
+ $function = 'DAY';
+ $args = 1;
+
+ break;
+ case 68:
+ $function = 'MONTH';
+ $args = 1;
+
+ break;
+ case 69:
+ $function = 'YEAR';
+ $args = 1;
+
+ break;
+ case 71:
+ $function = 'HOUR';
+ $args = 1;
+
+ break;
+ case 72:
+ $function = 'MINUTE';
+ $args = 1;
+
+ break;
+ case 73:
+ $function = 'SECOND';
+ $args = 1;
+
+ break;
+ case 74:
+ $function = 'NOW';
+ $args = 0;
+
+ break;
+ case 75:
+ $function = 'AREAS';
+ $args = 1;
+
+ break;
+ case 76:
+ $function = 'ROWS';
+ $args = 1;
+
+ break;
+ case 77:
+ $function = 'COLUMNS';
+ $args = 1;
+
+ break;
+ case 83:
+ $function = 'TRANSPOSE';
+ $args = 1;
+
+ break;
+ case 86:
+ $function = 'TYPE';
+ $args = 1;
+
+ break;
+ case 97:
+ $function = 'ATAN2';
+ $args = 2;
+
+ break;
+ case 98:
+ $function = 'ASIN';
+ $args = 1;
+
+ break;
+ case 99:
+ $function = 'ACOS';
+ $args = 1;
+
+ break;
+ case 105:
+ $function = 'ISREF';
+ $args = 1;
+
+ break;
+ case 111:
+ $function = 'CHAR';
+ $args = 1;
+
+ break;
+ case 112:
+ $function = 'LOWER';
+ $args = 1;
+
+ break;
+ case 113:
+ $function = 'UPPER';
+ $args = 1;
+
+ break;
+ case 114:
+ $function = 'PROPER';
+ $args = 1;
+
+ break;
+ case 117:
+ $function = 'EXACT';
+ $args = 2;
+
+ break;
+ case 118:
+ $function = 'TRIM';
+ $args = 1;
+
+ break;
+ case 119:
+ $function = 'REPLACE';
+ $args = 4;
+
+ break;
+ case 121:
+ $function = 'CODE';
+ $args = 1;
+
+ break;
+ case 126:
+ $function = 'ISERR';
+ $args = 1;
+
+ break;
+ case 127:
+ $function = 'ISTEXT';
+ $args = 1;
+
+ break;
+ case 128:
+ $function = 'ISNUMBER';
+ $args = 1;
+
+ break;
+ case 129:
+ $function = 'ISBLANK';
+ $args = 1;
+
+ break;
+ case 130:
+ $function = 'T';
+ $args = 1;
+
+ break;
+ case 131:
+ $function = 'N';
+ $args = 1;
+
+ break;
+ case 140:
+ $function = 'DATEVALUE';
+ $args = 1;
+
+ break;
+ case 141:
+ $function = 'TIMEVALUE';
+ $args = 1;
+
+ break;
+ case 142:
+ $function = 'SLN';
+ $args = 3;
+
+ break;
+ case 143:
+ $function = 'SYD';
+ $args = 4;
+
+ break;
+ case 162:
+ $function = 'CLEAN';
+ $args = 1;
+
+ break;
+ case 163:
+ $function = 'MDETERM';
+ $args = 1;
+
+ break;
+ case 164:
+ $function = 'MINVERSE';
+ $args = 1;
+
+ break;
+ case 165:
+ $function = 'MMULT';
+ $args = 2;
+
+ break;
+ case 184:
+ $function = 'FACT';
+ $args = 1;
+
+ break;
+ case 189:
+ $function = 'DPRODUCT';
+ $args = 3;
+
+ break;
+ case 190:
+ $function = 'ISNONTEXT';
+ $args = 1;
+
+ break;
+ case 195:
+ $function = 'DSTDEVP';
+ $args = 3;
+
+ break;
+ case 196:
+ $function = 'DVARP';
+ $args = 3;
+
+ break;
+ case 198:
+ $function = 'ISLOGICAL';
+ $args = 1;
+
+ break;
+ case 199:
+ $function = 'DCOUNTA';
+ $args = 3;
+
+ break;
+ case 207:
+ $function = 'REPLACEB';
+ $args = 4;
+
+ break;
+ case 210:
+ $function = 'MIDB';
+ $args = 3;
+
+ break;
+ case 211:
+ $function = 'LENB';
+ $args = 1;
+
+ break;
+ case 212:
+ $function = 'ROUNDUP';
+ $args = 2;
+
+ break;
+ case 213:
+ $function = 'ROUNDDOWN';
+ $args = 2;
+
+ break;
+ case 214:
+ $function = 'ASC';
+ $args = 1;
+
+ break;
+ case 215:
+ $function = 'DBCS';
+ $args = 1;
+
+ break;
+ case 221:
+ $function = 'TODAY';
+ $args = 0;
+
+ break;
+ case 229:
+ $function = 'SINH';
+ $args = 1;
+
+ break;
+ case 230:
+ $function = 'COSH';
+ $args = 1;
+
+ break;
+ case 231:
+ $function = 'TANH';
+ $args = 1;
+
+ break;
+ case 232:
+ $function = 'ASINH';
+ $args = 1;
+
+ break;
+ case 233:
+ $function = 'ACOSH';
+ $args = 1;
+
+ break;
+ case 234:
+ $function = 'ATANH';
+ $args = 1;
+
+ break;
+ case 235:
+ $function = 'DGET';
+ $args = 3;
+
+ break;
+ case 244:
+ $function = 'INFO';
+ $args = 1;
+
+ break;
+ case 252:
+ $function = 'FREQUENCY';
+ $args = 2;
+
+ break;
+ case 261:
+ $function = 'ERROR.TYPE';
+ $args = 1;
+
+ break;
+ case 271:
+ $function = 'GAMMALN';
+ $args = 1;
+
+ break;
+ case 273:
+ $function = 'BINOMDIST';
+ $args = 4;
+
+ break;
+ case 274:
+ $function = 'CHIDIST';
+ $args = 2;
+
+ break;
+ case 275:
+ $function = 'CHIINV';
+ $args = 2;
+
+ break;
+ case 276:
+ $function = 'COMBIN';
+ $args = 2;
+
+ break;
+ case 277:
+ $function = 'CONFIDENCE';
+ $args = 3;
+
+ break;
+ case 278:
+ $function = 'CRITBINOM';
+ $args = 3;
+
+ break;
+ case 279:
+ $function = 'EVEN';
+ $args = 1;
+
+ break;
+ case 280:
+ $function = 'EXPONDIST';
+ $args = 3;
+
+ break;
+ case 281:
+ $function = 'FDIST';
+ $args = 3;
+
+ break;
+ case 282:
+ $function = 'FINV';
+ $args = 3;
+
+ break;
+ case 283:
+ $function = 'FISHER';
+ $args = 1;
+
+ break;
+ case 284:
+ $function = 'FISHERINV';
+ $args = 1;
+
+ break;
+ case 285:
+ $function = 'FLOOR';
+ $args = 2;
+
+ break;
+ case 286:
+ $function = 'GAMMADIST';
+ $args = 4;
+
+ break;
+ case 287:
+ $function = 'GAMMAINV';
+ $args = 3;
+
+ break;
+ case 288:
+ $function = 'CEILING';
+ $args = 2;
+
+ break;
+ case 289:
+ $function = 'HYPGEOMDIST';
+ $args = 4;
+
+ break;
+ case 290:
+ $function = 'LOGNORMDIST';
+ $args = 3;
+
+ break;
+ case 291:
+ $function = 'LOGINV';
+ $args = 3;
+
+ break;
+ case 292:
+ $function = 'NEGBINOMDIST';
+ $args = 3;
+
+ break;
+ case 293:
+ $function = 'NORMDIST';
+ $args = 4;
+
+ break;
+ case 294:
+ $function = 'NORMSDIST';
+ $args = 1;
+
+ break;
+ case 295:
+ $function = 'NORMINV';
+ $args = 3;
+
+ break;
+ case 296:
+ $function = 'NORMSINV';
+ $args = 1;
+
+ break;
+ case 297:
+ $function = 'STANDARDIZE';
+ $args = 3;
+
+ break;
+ case 298:
+ $function = 'ODD';
+ $args = 1;
+
+ break;
+ case 299:
+ $function = 'PERMUT';
+ $args = 2;
+
+ break;
+ case 300:
+ $function = 'POISSON';
+ $args = 3;
+
+ break;
+ case 301:
+ $function = 'TDIST';
+ $args = 3;
+
+ break;
+ case 302:
+ $function = 'WEIBULL';
+ $args = 4;
+
+ break;
+ case 303:
+ $function = 'SUMXMY2';
+ $args = 2;
+
+ break;
+ case 304:
+ $function = 'SUMX2MY2';
+ $args = 2;
+
+ break;
+ case 305:
+ $function = 'SUMX2PY2';
+ $args = 2;
+
+ break;
+ case 306:
+ $function = 'CHITEST';
+ $args = 2;
+
+ break;
+ case 307:
+ $function = 'CORREL';
+ $args = 2;
+
+ break;
+ case 308:
+ $function = 'COVAR';
+ $args = 2;
+
+ break;
+ case 309:
+ $function = 'FORECAST';
+ $args = 3;
+
+ break;
+ case 310:
+ $function = 'FTEST';
+ $args = 2;
+
+ break;
+ case 311:
+ $function = 'INTERCEPT';
+ $args = 2;
+
+ break;
+ case 312:
+ $function = 'PEARSON';
+ $args = 2;
+
+ break;
+ case 313:
+ $function = 'RSQ';
+ $args = 2;
+
+ break;
+ case 314:
+ $function = 'STEYX';
+ $args = 2;
+
+ break;
+ case 315:
+ $function = 'SLOPE';
+ $args = 2;
+
+ break;
+ case 316:
+ $function = 'TTEST';
+ $args = 4;
+
+ break;
+ case 325:
+ $function = 'LARGE';
+ $args = 2;
+
+ break;
+ case 326:
+ $function = 'SMALL';
+ $args = 2;
+
+ break;
+ case 327:
+ $function = 'QUARTILE';
+ $args = 2;
+
+ break;
+ case 328:
+ $function = 'PERCENTILE';
+ $args = 2;
+
+ break;
+ case 331:
+ $function = 'TRIMMEAN';
+ $args = 2;
+
+ break;
+ case 332:
+ $function = 'TINV';
+ $args = 2;
+
+ break;
+ case 337:
+ $function = 'POWER';
+ $args = 2;
+
+ break;
+ case 342:
+ $function = 'RADIANS';
+ $args = 1;
+
+ break;
+ case 343:
+ $function = 'DEGREES';
+ $args = 1;
+
+ break;
+ case 346:
+ $function = 'COUNTIF';
+ $args = 2;
+
+ break;
+ case 347:
+ $function = 'COUNTBLANK';
+ $args = 1;
+
+ break;
+ case 350:
+ $function = 'ISPMT';
+ $args = 4;
+
+ break;
+ case 351:
+ $function = 'DATEDIF';
+ $args = 3;
+
+ break;
+ case 352:
+ $function = 'DATESTRING';
+ $args = 1;
+
+ break;
+ case 353:
+ $function = 'NUMBERSTRING';
+ $args = 2;
+
+ break;
+ case 360:
+ $function = 'PHONETIC';
+ $args = 1;
+
+ break;
+ case 368:
+ $function = 'BAHTTEXT';
+ $args = 1;
+
+ break;
+ default:
+ throw new Exception('Unrecognized function in formula');
+ }
+ $data = ['function' => $function, 'args' => $args];
+
+ break;
+ case 0x22: // function with variable number of arguments
+ case 0x42:
+ case 0x62:
+ $name = 'tFuncV';
+ $size = 4;
+ // offset: 1; size: 1; number of arguments
+ $args = ord($formulaData[1]);
+ // offset: 2: size: 2; index to built-in sheet function
+ $index = self::getUInt2d($formulaData, 2);
+ $function = match ($index) {
+ 0 => 'COUNT',
+ 1 => 'IF',
+ 4 => 'SUM',
+ 5 => 'AVERAGE',
+ 6 => 'MIN',
+ 7 => 'MAX',
+ 8 => 'ROW',
+ 9 => 'COLUMN',
+ 11 => 'NPV',
+ 12 => 'STDEV',
+ 13 => 'DOLLAR',
+ 14 => 'FIXED',
+ 28 => 'LOOKUP',
+ 29 => 'INDEX',
+ 36 => 'AND',
+ 37 => 'OR',
+ 46 => 'VAR',
+ 49 => 'LINEST',
+ 50 => 'TREND',
+ 51 => 'LOGEST',
+ 52 => 'GROWTH',
+ 56 => 'PV',
+ 57 => 'FV',
+ 58 => 'NPER',
+ 59 => 'PMT',
+ 60 => 'RATE',
+ 62 => 'IRR',
+ 64 => 'MATCH',
+ 70 => 'WEEKDAY',
+ 78 => 'OFFSET',
+ 82 => 'SEARCH',
+ 100 => 'CHOOSE',
+ 101 => 'HLOOKUP',
+ 102 => 'VLOOKUP',
+ 109 => 'LOG',
+ 115 => 'LEFT',
+ 116 => 'RIGHT',
+ 120 => 'SUBSTITUTE',
+ 124 => 'FIND',
+ 125 => 'CELL',
+ 144 => 'DDB',
+ 148 => 'INDIRECT',
+ 167 => 'IPMT',
+ 168 => 'PPMT',
+ 169 => 'COUNTA',
+ 183 => 'PRODUCT',
+ 193 => 'STDEVP',
+ 194 => 'VARP',
+ 197 => 'TRUNC',
+ 204 => 'USDOLLAR',
+ 205 => 'FINDB',
+ 206 => 'SEARCHB',
+ 208 => 'LEFTB',
+ 209 => 'RIGHTB',
+ 216 => 'RANK',
+ 219 => 'ADDRESS',
+ 220 => 'DAYS360',
+ 222 => 'VDB',
+ 227 => 'MEDIAN',
+ 228 => 'SUMPRODUCT',
+ 247 => 'DB',
+ 255 => '',
+ 269 => 'AVEDEV',
+ 270 => 'BETADIST',
+ 272 => 'BETAINV',
+ 317 => 'PROB',
+ 318 => 'DEVSQ',
+ 319 => 'GEOMEAN',
+ 320 => 'HARMEAN',
+ 321 => 'SUMSQ',
+ 322 => 'KURT',
+ 323 => 'SKEW',
+ 324 => 'ZTEST',
+ 329 => 'PERCENTRANK',
+ 330 => 'MODE',
+ 336 => 'CONCATENATE',
+ 344 => 'SUBTOTAL',
+ 345 => 'SUMIF',
+ 354 => 'ROMAN',
+ 358 => 'GETPIVOTDATA',
+ 359 => 'HYPERLINK',
+ 361 => 'AVERAGEA',
+ 362 => 'MAXA',
+ 363 => 'MINA',
+ 364 => 'STDEVPA',
+ 365 => 'VARPA',
+ 366 => 'STDEVA',
+ 367 => 'VARA',
+ default => throw new Exception('Unrecognized function in formula'),
+ };
+ $data = ['function' => $function, 'args' => $args];
+
+ break;
+ case 0x23: // index to defined name
+ case 0x43:
+ case 0x63:
+ $name = 'tName';
+ $size = 5;
+ // offset: 1; size: 2; one-based index to definedname record
+ $definedNameIndex = self::getUInt2d($formulaData, 1) - 1;
+ // offset: 2; size: 2; not used
+ $data = $this->definedname[$definedNameIndex]['name'] ?? '';
+
+ break;
+ case 0x24: // single cell reference e.g. A5
+ case 0x44:
+ case 0x64:
+ $name = 'tRef';
+ $size = 5;
+ $data = $this->readBIFF8CellAddress(substr($formulaData, 1, 4));
+
+ break;
+ case 0x25: // cell range reference to cells in the same sheet (2d)
+ case 0x45:
+ case 0x65:
+ $name = 'tArea';
+ $size = 9;
+ $data = $this->readBIFF8CellRangeAddress(substr($formulaData, 1, 8));
+
+ break;
+ case 0x26: // Constant reference sub-expression
+ case 0x46:
+ case 0x66:
+ $name = 'tMemArea';
+ // offset: 1; size: 4; not used
+ // offset: 5; size: 2; size of the following subexpression
+ $subSize = self::getUInt2d($formulaData, 5);
+ $size = 7 + $subSize;
+ $data = $this->getFormulaFromData(substr($formulaData, 7, $subSize));
+
+ break;
+ case 0x27: // Deleted constant reference sub-expression
+ case 0x47:
+ case 0x67:
+ $name = 'tMemErr';
+ // offset: 1; size: 4; not used
+ // offset: 5; size: 2; size of the following subexpression
+ $subSize = self::getUInt2d($formulaData, 5);
+ $size = 7 + $subSize;
+ $data = $this->getFormulaFromData(substr($formulaData, 7, $subSize));
+
+ break;
+ case 0x29: // Variable reference sub-expression
+ case 0x49:
+ case 0x69:
+ $name = 'tMemFunc';
+ // offset: 1; size: 2; size of the following sub-expression
+ $subSize = self::getUInt2d($formulaData, 1);
+ $size = 3 + $subSize;
+ $data = $this->getFormulaFromData(substr($formulaData, 3, $subSize));
+
+ break;
+ case 0x2C: // Relative 2d cell reference reference, used in shared formulas and some other places
+ case 0x4C:
+ case 0x6C:
+ $name = 'tRefN';
+ $size = 5;
+ $data = $this->readBIFF8CellAddressB(substr($formulaData, 1, 4), $baseCell);
+
+ break;
+ case 0x2D: // Relative 2d range reference
+ case 0x4D:
+ case 0x6D:
+ $name = 'tAreaN';
+ $size = 9;
+ $data = $this->readBIFF8CellRangeAddressB(substr($formulaData, 1, 8), $baseCell);
+
+ break;
+ case 0x39: // External name
+ case 0x59:
+ case 0x79:
+ $name = 'tNameX';
+ $size = 7;
+ // offset: 1; size: 2; index to REF entry in EXTERNSHEET record
+ // offset: 3; size: 2; one-based index to DEFINEDNAME or EXTERNNAME record
+ $index = self::getUInt2d($formulaData, 3);
+ // assume index is to EXTERNNAME record
+ $data = $this->externalNames[$index - 1]['name'] ?? '';
+
+ // offset: 5; size: 2; not used
+ break;
+ case 0x3A: // 3d reference to cell
+ case 0x5A:
+ case 0x7A:
+ $name = 'tRef3d';
+ $size = 7;
+
+ try {
+ // offset: 1; size: 2; index to REF entry
+ $sheetRange = $this->readSheetRangeByRefIndex(self::getUInt2d($formulaData, 1));
+ // offset: 3; size: 4; cell address
+ $cellAddress = $this->readBIFF8CellAddress(substr($formulaData, 3, 4));
+
+ $data = "$sheetRange!$cellAddress";
+ } catch (PhpSpreadsheetException) {
+ // deleted sheet reference
+ $data = '#REF!';
+ }
+
+ break;
+ case 0x3B: // 3d reference to cell range
+ case 0x5B:
+ case 0x7B:
+ $name = 'tArea3d';
+ $size = 11;
+
+ try {
+ // offset: 1; size: 2; index to REF entry
+ $sheetRange = $this->readSheetRangeByRefIndex(self::getUInt2d($formulaData, 1));
+ // offset: 3; size: 8; cell address
+ $cellRangeAddress = $this->readBIFF8CellRangeAddress(substr($formulaData, 3, 8));
+
+ $data = "$sheetRange!$cellRangeAddress";
+ } catch (PhpSpreadsheetException) {
+ // deleted sheet reference
+ $data = '#REF!';
+ }
+
+ break;
+ // Unknown cases // don't know how to deal with
+ default:
+ throw new Exception('Unrecognized token ' . sprintf('%02X', $id) . ' in formula');
+ }
+
+ return [
+ 'id' => $id,
+ 'name' => $name,
+ 'size' => $size,
+ 'data' => $data,
+ ];
+ }
+
+ /**
+ * Reads a cell address in BIFF8 e.g. 'A2' or '$A$2'
+ * section 3.3.4.
+ */
+ private function readBIFF8CellAddress(string $cellAddressStructure): string
+ {
+ // offset: 0; size: 2; index to row (0... 65535) (or offset (-32768... 32767))
+ $row = self::getUInt2d($cellAddressStructure, 0) + 1;
+
+ // offset: 2; size: 2; index to column or column offset + relative flags
+ // bit: 7-0; mask 0x00FF; column index
+ $column = Coordinate::stringFromColumnIndex((0x00FF & self::getUInt2d($cellAddressStructure, 2)) + 1);
+
+ // bit: 14; mask 0x4000; (1 = relative column index, 0 = absolute column index)
+ if (!(0x4000 & self::getUInt2d($cellAddressStructure, 2))) {
+ $column = '$' . $column;
+ }
+ // bit: 15; mask 0x8000; (1 = relative row index, 0 = absolute row index)
+ if (!(0x8000 & self::getUInt2d($cellAddressStructure, 2))) {
+ $row = '$' . $row;
+ }
+
+ return $column . $row;
+ }
+
+ /**
+ * Reads a cell address in BIFF8 for shared formulas. Uses positive and negative values for row and column
+ * to indicate offsets from a base cell
+ * section 3.3.4.
+ *
+ * @param string $baseCell Base cell, only needed when formula contains tRefN tokens, e.g. with shared formulas
+ */
+ private function readBIFF8CellAddressB(string $cellAddressStructure, string $baseCell = 'A1'): string
+ {
+ [$baseCol, $baseRow] = Coordinate::coordinateFromString($baseCell);
+ $baseCol = Coordinate::columnIndexFromString($baseCol) - 1;
+ $baseRow = (int) $baseRow;
+
+ // offset: 0; size: 2; index to row (0... 65535) (or offset (-32768... 32767))
+ $rowIndex = self::getUInt2d($cellAddressStructure, 0);
+ $row = self::getUInt2d($cellAddressStructure, 0) + 1;
+
+ // bit: 14; mask 0x4000; (1 = relative column index, 0 = absolute column index)
+ if (!(0x4000 & self::getUInt2d($cellAddressStructure, 2))) {
+ // offset: 2; size: 2; index to column or column offset + relative flags
+ // bit: 7-0; mask 0x00FF; column index
+ $colIndex = 0x00FF & self::getUInt2d($cellAddressStructure, 2);
+
+ $column = Coordinate::stringFromColumnIndex($colIndex + 1);
+ $column = '$' . $column;
+ } else {
+ // offset: 2; size: 2; index to column or column offset + relative flags
+ // bit: 7-0; mask 0x00FF; column index
+ $relativeColIndex = 0x00FF & self::getInt2d($cellAddressStructure, 2);
+ $colIndex = $baseCol + $relativeColIndex;
+ $colIndex = ($colIndex < 256) ? $colIndex : $colIndex - 256;
+ $colIndex = ($colIndex >= 0) ? $colIndex : $colIndex + 256;
+ $column = Coordinate::stringFromColumnIndex($colIndex + 1);
+ }
+
+ // bit: 15; mask 0x8000; (1 = relative row index, 0 = absolute row index)
+ if (!(0x8000 & self::getUInt2d($cellAddressStructure, 2))) {
+ $row = '$' . $row;
+ } else {
+ $rowIndex = ($rowIndex <= 32767) ? $rowIndex : $rowIndex - 65536;
+ $row = $baseRow + $rowIndex;
+ }
+
+ return $column . $row;
+ }
+
+ /**
+ * Reads a cell range address in BIFF5 e.g. 'A2:B6' or 'A1'
+ * always fixed range
+ * section 2.5.14.
+ */
+ private function readBIFF5CellRangeAddressFixed(string $subData): string
+ {
+ // offset: 0; size: 2; index to first row
+ $fr = self::getUInt2d($subData, 0) + 1;
+
+ // offset: 2; size: 2; index to last row
+ $lr = self::getUInt2d($subData, 2) + 1;
+
+ // offset: 4; size: 1; index to first column
+ $fc = ord($subData[4]);
+
+ // offset: 5; size: 1; index to last column
+ $lc = ord($subData[5]);
+
+ // check values
+ if ($fr > $lr || $fc > $lc) {
+ throw new Exception('Not a cell range address');
+ }
+
+ // column index to letter
+ $fc = Coordinate::stringFromColumnIndex($fc + 1);
+ $lc = Coordinate::stringFromColumnIndex($lc + 1);
+
+ if ($fr == $lr && $fc == $lc) {
+ return "$fc$fr";
+ }
+
+ return "$fc$fr:$lc$lr";
+ }
+
+ /**
+ * Reads a cell range address in BIFF8 e.g. 'A2:B6' or 'A1'
+ * always fixed range
+ * section 2.5.14.
+ */
+ private function readBIFF8CellRangeAddressFixed(string $subData): string
+ {
+ // offset: 0; size: 2; index to first row
+ $fr = self::getUInt2d($subData, 0) + 1;
+
+ // offset: 2; size: 2; index to last row
+ $lr = self::getUInt2d($subData, 2) + 1;
+
+ // offset: 4; size: 2; index to first column
+ $fc = self::getUInt2d($subData, 4);
+
+ // offset: 6; size: 2; index to last column
+ $lc = self::getUInt2d($subData, 6);
+
+ // check values
+ if ($fr > $lr || $fc > $lc) {
+ throw new Exception('Not a cell range address');
+ }
+
+ // column index to letter
+ $fc = Coordinate::stringFromColumnIndex($fc + 1);
+ $lc = Coordinate::stringFromColumnIndex($lc + 1);
+
+ if ($fr == $lr && $fc == $lc) {
+ return "$fc$fr";
+ }
+
+ return "$fc$fr:$lc$lr";
+ }
+
+ /**
+ * Reads a cell range address in BIFF8 e.g. 'A2:B6' or '$A$2:$B$6'
+ * there are flags indicating whether column/row index is relative
+ * section 3.3.4.
+ */
+ private function readBIFF8CellRangeAddress(string $subData): string
+ {
+ // todo: if cell range is just a single cell, should this funciton
+ // not just return e.g. 'A1' and not 'A1:A1' ?
+
+ // offset: 0; size: 2; index to first row (0... 65535) (or offset (-32768... 32767))
+ $fr = self::getUInt2d($subData, 0) + 1;
+
+ // offset: 2; size: 2; index to last row (0... 65535) (or offset (-32768... 32767))
+ $lr = self::getUInt2d($subData, 2) + 1;
+
+ // offset: 4; size: 2; index to first column or column offset + relative flags
+
+ // bit: 7-0; mask 0x00FF; column index
+ $fc = Coordinate::stringFromColumnIndex((0x00FF & self::getUInt2d($subData, 4)) + 1);
+
+ // bit: 14; mask 0x4000; (1 = relative column index, 0 = absolute column index)
+ if (!(0x4000 & self::getUInt2d($subData, 4))) {
+ $fc = '$' . $fc;
+ }
+
+ // bit: 15; mask 0x8000; (1 = relative row index, 0 = absolute row index)
+ if (!(0x8000 & self::getUInt2d($subData, 4))) {
+ $fr = '$' . $fr;
+ }
+
+ // offset: 6; size: 2; index to last column or column offset + relative flags
+
+ // bit: 7-0; mask 0x00FF; column index
+ $lc = Coordinate::stringFromColumnIndex((0x00FF & self::getUInt2d($subData, 6)) + 1);
+
+ // bit: 14; mask 0x4000; (1 = relative column index, 0 = absolute column index)
+ if (!(0x4000 & self::getUInt2d($subData, 6))) {
+ $lc = '$' . $lc;
+ }
+
+ // bit: 15; mask 0x8000; (1 = relative row index, 0 = absolute row index)
+ if (!(0x8000 & self::getUInt2d($subData, 6))) {
+ $lr = '$' . $lr;
+ }
+
+ return "$fc$fr:$lc$lr";
+ }
+
+ /**
+ * Reads a cell range address in BIFF8 for shared formulas. Uses positive and negative values for row and column
+ * to indicate offsets from a base cell
+ * section 3.3.4.
+ *
+ * @param string $baseCell Base cell
+ *
+ * @return string Cell range address
+ */
+ private function readBIFF8CellRangeAddressB(string $subData, string $baseCell = 'A1'): string
+ {
+ [$baseCol, $baseRow] = Coordinate::indexesFromString($baseCell);
+ $baseCol = $baseCol - 1;
+
+ // TODO: if cell range is just a single cell, should this funciton
+ // not just return e.g. 'A1' and not 'A1:A1' ?
+
+ // offset: 0; size: 2; first row
+ $frIndex = self::getUInt2d($subData, 0); // adjust below
+
+ // offset: 2; size: 2; relative index to first row (0... 65535) should be treated as offset (-32768... 32767)
+ $lrIndex = self::getUInt2d($subData, 2); // adjust below
+
+ // bit: 14; mask 0x4000; (1 = relative column index, 0 = absolute column index)
+ if (!(0x4000 & self::getUInt2d($subData, 4))) {
+ // absolute column index
+ // offset: 4; size: 2; first column with relative/absolute flags
+ // bit: 7-0; mask 0x00FF; column index
+ $fcIndex = 0x00FF & self::getUInt2d($subData, 4);
+ $fc = Coordinate::stringFromColumnIndex($fcIndex + 1);
+ $fc = '$' . $fc;
+ } else {
+ // column offset
+ // offset: 4; size: 2; first column with relative/absolute flags
+ // bit: 7-0; mask 0x00FF; column index
+ $relativeFcIndex = 0x00FF & self::getInt2d($subData, 4);
+ $fcIndex = $baseCol + $relativeFcIndex;
+ $fcIndex = ($fcIndex < 256) ? $fcIndex : $fcIndex - 256;
+ $fcIndex = ($fcIndex >= 0) ? $fcIndex : $fcIndex + 256;
+ $fc = Coordinate::stringFromColumnIndex($fcIndex + 1);
+ }
+
+ // bit: 15; mask 0x8000; (1 = relative row index, 0 = absolute row index)
+ if (!(0x8000 & self::getUInt2d($subData, 4))) {
+ // absolute row index
+ $fr = $frIndex + 1;
+ $fr = '$' . $fr;
+ } else {
+ // row offset
+ $frIndex = ($frIndex <= 32767) ? $frIndex : $frIndex - 65536;
+ $fr = $baseRow + $frIndex;
+ }
+
+ // bit: 14; mask 0x4000; (1 = relative column index, 0 = absolute column index)
+ if (!(0x4000 & self::getUInt2d($subData, 6))) {
+ // absolute column index
+ // offset: 6; size: 2; last column with relative/absolute flags
+ // bit: 7-0; mask 0x00FF; column index
+ $lcIndex = 0x00FF & self::getUInt2d($subData, 6);
+ $lc = Coordinate::stringFromColumnIndex($lcIndex + 1);
+ $lc = '$' . $lc;
+ } else {
+ // column offset
+ // offset: 4; size: 2; first column with relative/absolute flags
+ // bit: 7-0; mask 0x00FF; column index
+ $relativeLcIndex = 0x00FF & self::getInt2d($subData, 4);
+ $lcIndex = $baseCol + $relativeLcIndex;
+ $lcIndex = ($lcIndex < 256) ? $lcIndex : $lcIndex - 256;
+ $lcIndex = ($lcIndex >= 0) ? $lcIndex : $lcIndex + 256;
+ $lc = Coordinate::stringFromColumnIndex($lcIndex + 1);
+ }
+
+ // bit: 15; mask 0x8000; (1 = relative row index, 0 = absolute row index)
+ if (!(0x8000 & self::getUInt2d($subData, 6))) {
+ // absolute row index
+ $lr = $lrIndex + 1;
+ $lr = '$' . $lr;
+ } else {
+ // row offset
+ $lrIndex = ($lrIndex <= 32767) ? $lrIndex : $lrIndex - 65536;
+ $lr = $baseRow + $lrIndex;
+ }
+
+ return "$fc$fr:$lc$lr";
+ }
+
+ /**
+ * Read BIFF8 cell range address list
+ * section 2.5.15.
+ */
+ private function readBIFF8CellRangeAddressList(string $subData): array
+ {
+ $cellRangeAddresses = [];
+
+ // offset: 0; size: 2; number of the following cell range addresses
+ $nm = self::getUInt2d($subData, 0);
+
+ $offset = 2;
+ // offset: 2; size: 8 * $nm; list of $nm (fixed) cell range addresses
+ for ($i = 0; $i < $nm; ++$i) {
+ $cellRangeAddresses[] = $this->readBIFF8CellRangeAddressFixed(substr($subData, $offset, 8));
+ $offset += 8;
+ }
+
+ return [
+ 'size' => 2 + 8 * $nm,
+ 'cellRangeAddresses' => $cellRangeAddresses,
+ ];
+ }
+
+ /**
+ * Read BIFF5 cell range address list
+ * section 2.5.15.
+ */
+ private function readBIFF5CellRangeAddressList(string $subData): array
+ {
+ $cellRangeAddresses = [];
+
+ // offset: 0; size: 2; number of the following cell range addresses
+ $nm = self::getUInt2d($subData, 0);
+
+ $offset = 2;
+ // offset: 2; size: 6 * $nm; list of $nm (fixed) cell range addresses
+ for ($i = 0; $i < $nm; ++$i) {
+ $cellRangeAddresses[] = $this->readBIFF5CellRangeAddressFixed(substr($subData, $offset, 6));
+ $offset += 6;
+ }
+
+ return [
+ 'size' => 2 + 6 * $nm,
+ 'cellRangeAddresses' => $cellRangeAddresses,
+ ];
+ }
+
+ /**
+ * Get a sheet range like Sheet1:Sheet3 from REF index
+ * Note: If there is only one sheet in the range, one gets e.g Sheet1
+ * It can also happen that the REF structure uses the -1 (FFFF) code to indicate deleted sheets,
+ * in which case an Exception is thrown.
+ */
+ private function readSheetRangeByRefIndex(int $index): string|false
+ {
+ if (isset($this->ref[$index])) {
+ $type = $this->externalBooks[$this->ref[$index]['externalBookIndex']]['type'];
+
+ switch ($type) {
+ case 'internal':
+ // check if we have a deleted 3d reference
+ if ($this->ref[$index]['firstSheetIndex'] == 0xFFFF || $this->ref[$index]['lastSheetIndex'] == 0xFFFF) {
+ throw new Exception('Deleted sheet reference');
+ }
+
+ // we have normal sheet range (collapsed or uncollapsed)
+ $firstSheetName = $this->sheets[$this->ref[$index]['firstSheetIndex']]['name'];
+ $lastSheetName = $this->sheets[$this->ref[$index]['lastSheetIndex']]['name'];
+
+ if ($firstSheetName == $lastSheetName) {
+ // collapsed sheet range
+ $sheetRange = $firstSheetName;
+ } else {
+ $sheetRange = "$firstSheetName:$lastSheetName";
+ }
+
+ // escape the single-quotes
+ $sheetRange = str_replace("'", "''", $sheetRange);
+
+ // if there are special characters, we need to enclose the range in single-quotes
+ // todo: check if we have identified the whole set of special characters
+ // it seems that the following characters are not accepted for sheet names
+ // and we may assume that they are not present: []*/:\?
+ if (preg_match("/[ !\"@#£$%&{()}<>=+'|^,;-]/u", $sheetRange)) {
+ $sheetRange = "'$sheetRange'";
+ }
+
+ return $sheetRange;
+ default:
+ // TODO: external sheet support
+ throw new Exception('Xls reader only supports internal sheets in formulas');
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * read BIFF8 constant value array from array data
+ * returns e.g. ['value' => '{1,2;3,4}', 'size' => 40]
+ * section 2.5.8.
+ */
+ private static function readBIFF8ConstantArray(string $arrayData): array
+ {
+ // offset: 0; size: 1; number of columns decreased by 1
+ $nc = ord($arrayData[0]);
+
+ // offset: 1; size: 2; number of rows decreased by 1
+ $nr = self::getUInt2d($arrayData, 1);
+ $size = 3; // initialize
+ $arrayData = substr($arrayData, 3);
+
+ // offset: 3; size: var; list of ($nc + 1) * ($nr + 1) constant values
+ $matrixChunks = [];
+ for ($r = 1; $r <= $nr + 1; ++$r) {
+ $items = [];
+ for ($c = 1; $c <= $nc + 1; ++$c) {
+ $constant = self::readBIFF8Constant($arrayData);
+ $items[] = $constant['value'];
+ $arrayData = substr($arrayData, $constant['size']);
+ $size += $constant['size'];
+ }
+ $matrixChunks[] = implode(',', $items); // looks like e.g. '1,"hello"'
+ }
+ $matrix = '{' . implode(';', $matrixChunks) . '}';
+
+ return [
+ 'value' => $matrix,
+ 'size' => $size,
+ ];
+ }
+
+ /**
+ * read BIFF8 constant value which may be 'Empty Value', 'Number', 'String Value', 'Boolean Value', 'Error Value'
+ * section 2.5.7
+ * returns e.g. ['value' => '5', 'size' => 9].
+ */
+ private static function readBIFF8Constant(string $valueData): array
+ {
+ // offset: 0; size: 1; identifier for type of constant
+ $identifier = ord($valueData[0]);
+
+ switch ($identifier) {
+ case 0x00: // empty constant (what is this?)
+ $value = '';
+ $size = 9;
+
+ break;
+ case 0x01: // number
+ // offset: 1; size: 8; IEEE 754 floating-point value
+ $value = self::extractNumber(substr($valueData, 1, 8));
+ $size = 9;
+
+ break;
+ case 0x02: // string value
+ // offset: 1; size: var; Unicode string, 16-bit string length
+ $string = self::readUnicodeStringLong(substr($valueData, 1));
+ $value = '"' . $string['value'] . '"';
+ $size = 1 + $string['size'];
+
+ break;
+ case 0x04: // boolean
+ // offset: 1; size: 1; 0 = FALSE, 1 = TRUE
+ if (ord($valueData[1])) {
+ $value = 'TRUE';
+ } else {
+ $value = 'FALSE';
+ }
+ $size = 9;
+
+ break;
+ case 0x10: // error code
+ // offset: 1; size: 1; error code
+ $value = Xls\ErrorCode::lookup(ord($valueData[1]));
+ $size = 9;
+
+ break;
+ default:
+ throw new PhpSpreadsheetException('Unsupported BIFF8 constant');
+ }
+
+ return [
+ 'value' => $value,
+ 'size' => $size,
+ ];
+ }
+
+ /**
+ * Extract RGB color
+ * OpenOffice.org's Documentation of the Microsoft Excel File Format, section 2.5.4.
+ *
+ * @param string $rgb Encoded RGB value (4 bytes)
+ */
+ private static function readRGB(string $rgb): array
+ {
+ // offset: 0; size 1; Red component
+ $r = ord($rgb[0]);
+
+ // offset: 1; size: 1; Green component
+ $g = ord($rgb[1]);
+
+ // offset: 2; size: 1; Blue component
+ $b = ord($rgb[2]);
+
+ // HEX notation, e.g. 'FF00FC'
+ $rgb = sprintf('%02X%02X%02X', $r, $g, $b);
+
+ return ['rgb' => $rgb];
+ }
+
+ /**
+ * Read byte string (8-bit string length)
+ * OpenOffice documentation: 2.5.2.
+ */
+ private function readByteStringShort(string $subData): array
+ {
+ // offset: 0; size: 1; length of the string (character count)
+ $ln = ord($subData[0]);
+
+ // offset: 1: size: var; character array (8-bit characters)
+ $value = $this->decodeCodepage(substr($subData, 1, $ln));
+
+ return [
+ 'value' => $value,
+ 'size' => 1 + $ln, // size in bytes of data structure
+ ];
+ }
+
+ /**
+ * Read byte string (16-bit string length)
+ * OpenOffice documentation: 2.5.2.
+ */
+ private function readByteStringLong(string $subData): array
+ {
+ // offset: 0; size: 2; length of the string (character count)
+ $ln = self::getUInt2d($subData, 0);
+
+ // offset: 2: size: var; character array (8-bit characters)
+ $value = $this->decodeCodepage(substr($subData, 2));
+
+ //return $string;
+ return [
+ 'value' => $value,
+ 'size' => 2 + $ln, // size in bytes of data structure
+ ];
+ }
+
+ /**
+ * Extracts an Excel Unicode short string (8-bit string length)
+ * OpenOffice documentation: 2.5.3
+ * function will automatically find out where the Unicode string ends.
+ */
+ private static function readUnicodeStringShort(string $subData): array
+ {
+ // offset: 0: size: 1; length of the string (character count)
+ $characterCount = ord($subData[0]);
+
+ $string = self::readUnicodeString(substr($subData, 1), $characterCount);
+
+ // add 1 for the string length
+ ++$string['size'];
+
+ return $string;
+ }
+
+ /**
+ * Extracts an Excel Unicode long string (16-bit string length)
+ * OpenOffice documentation: 2.5.3
+ * this function is under construction, needs to support rich text, and Asian phonetic settings.
+ */
+ private static function readUnicodeStringLong(string $subData): array
+ {
+ // offset: 0: size: 2; length of the string (character count)
+ $characterCount = self::getUInt2d($subData, 0);
+
+ $string = self::readUnicodeString(substr($subData, 2), $characterCount);
+
+ // add 2 for the string length
+ $string['size'] += 2;
+
+ return $string;
+ }
+
+ /**
+ * Read Unicode string with no string length field, but with known character count
+ * this function is under construction, needs to support rich text, and Asian phonetic settings
+ * OpenOffice.org's Documentation of the Microsoft Excel File Format, section 2.5.3.
+ */
+ private static function readUnicodeString(string $subData, int $characterCount): array
+ {
+ // offset: 0: size: 1; option flags
+ // bit: 0; mask: 0x01; character compression (0 = compressed 8-bit, 1 = uncompressed 16-bit)
+ $isCompressed = !((0x01 & ord($subData[0])) >> 0);
+
+ // bit: 2; mask: 0x04; Asian phonetic settings
+ //$hasAsian = (0x04) & ord($subData[0]) >> 2;
+
+ // bit: 3; mask: 0x08; Rich-Text settings
+ //$hasRichText = (0x08) & ord($subData[0]) >> 3;
+
+ // offset: 1: size: var; character array
+ // this offset assumes richtext and Asian phonetic settings are off which is generally wrong
+ // needs to be fixed
+ $value = self::encodeUTF16(substr($subData, 1, $isCompressed ? $characterCount : 2 * $characterCount), $isCompressed);
+
+ return [
+ 'value' => $value,
+ 'size' => $isCompressed ? 1 + $characterCount : 1 + 2 * $characterCount, // the size in bytes including the option flags
+ ];
+ }
+
+ /**
+ * Convert UTF-8 string to string surounded by double quotes. Used for explicit string tokens in formulas.
+ * Example: hello"world --> "hello""world".
+ *
+ * @param string $value UTF-8 encoded string
+ */
+ private static function UTF8toExcelDoubleQuoted(string $value): string
+ {
+ return '"' . str_replace('"', '""', $value) . '"';
+ }
+
+ /**
+ * Reads first 8 bytes of a string and return IEEE 754 float.
+ *
+ * @param string $data Binary string that is at least 8 bytes long
+ */
+ private static function extractNumber(string $data): int|float
+ {
+ $rknumhigh = self::getInt4d($data, 4);
+ $rknumlow = self::getInt4d($data, 0);
+ $sign = ($rknumhigh & self::HIGH_ORDER_BIT) >> 31;
+ $exp = (($rknumhigh & 0x7FF00000) >> 20) - 1023;
+ $mantissa = (0x100000 | ($rknumhigh & 0x000FFFFF));
+ $mantissalow1 = ($rknumlow & self::HIGH_ORDER_BIT) >> 31;
+ $mantissalow2 = ($rknumlow & 0x7FFFFFFF);
+ $value = $mantissa / 2 ** (20 - $exp);
+
+ if ($mantissalow1 != 0) {
+ $value += 1 / 2 ** (21 - $exp);
+ }
+
+ if ($mantissalow2 != 0) {
+ $value += $mantissalow2 / 2 ** (52 - $exp);
+ }
+ if ($sign) {
+ $value *= -1;
+ }
+
+ return $value;
+ }
+
+ private static function getIEEE754(int $rknum): float|int
+ {
+ if (($rknum & 0x02) != 0) {
+ $value = $rknum >> 2;
+ } else {
+ // changes by mmp, info on IEEE754 encoding from
+ // research.microsoft.com/~hollasch/cgindex/coding/ieeefloat.html
+ // The RK format calls for using only the most significant 30 bits
+ // of the 64 bit floating point value. The other 34 bits are assumed
+ // to be 0 so we use the upper 30 bits of $rknum as follows...
+ $sign = ($rknum & self::HIGH_ORDER_BIT) >> 31;
+ $exp = ($rknum & 0x7FF00000) >> 20;
+ $mantissa = (0x100000 | ($rknum & 0x000FFFFC));
+ $value = $mantissa / 2 ** (20 - ($exp - 1023));
+ if ($sign) {
+ $value = -1 * $value;
+ }
+ //end of changes by mmp
+ }
+ if (($rknum & 0x01) != 0) {
+ $value /= 100;
+ }
+
+ return $value;
+ }
+
+ /**
+ * Get UTF-8 string from (compressed or uncompressed) UTF-16 string.
+ */
+ private static function encodeUTF16(string $string, bool $compressed = false): string
+ {
+ if ($compressed) {
+ $string = self::uncompressByteString($string);
+ }
+
+ return StringHelper::convertEncoding($string, 'UTF-8', 'UTF-16LE');
+ }
+
+ /**
+ * Convert UTF-16 string in compressed notation to uncompressed form. Only used for BIFF8.
+ */
+ private static function uncompressByteString(string $string): string
+ {
+ $uncompressedString = '';
+ $strLen = strlen($string);
+ for ($i = 0; $i < $strLen; ++$i) {
+ $uncompressedString .= $string[$i] . "\0";
+ }
+
+ return $uncompressedString;
+ }
+
+ /**
+ * Convert string to UTF-8. Only used for BIFF5.
+ */
+ private function decodeCodepage(string $string): string
+ {
+ return StringHelper::convertEncoding($string, 'UTF-8', $this->codepage);
+ }
+
+ /**
+ * Read 16-bit unsigned integer.
+ */
+ public static function getUInt2d(string $data, int $pos): int
+ {
+ return ord($data[$pos]) | (ord($data[$pos + 1]) << 8);
+ }
+
+ /**
+ * Read 16-bit signed integer.
+ */
+ public static function getInt2d(string $data, int $pos): int
+ {
+ return unpack('s', $data[$pos] . $data[$pos + 1])[1]; // @phpstan-ignore-line
+ }
+
+ /**
+ * Read 32-bit signed integer.
+ */
+ public static function getInt4d(string $data, int $pos): int
+ {
+ // FIX: represent numbers correctly on 64-bit system
+ // http://sourceforge.net/tracker/index.php?func=detail&aid=1487372&group_id=99160&atid=623334
+ // Changed by Andreas Rehm 2006 to ensure correct result of the <<24 block on 32 and 64bit systems
+ $_or_24 = ord($data[$pos + 3]);
+ if ($_or_24 >= 128) {
+ // negative number
+ $_ord_24 = -abs((256 - $_or_24) << 24);
+ } else {
+ $_ord_24 = ($_or_24 & 127) << 24;
+ }
+
+ return ord($data[$pos]) | (ord($data[$pos + 1]) << 8) | (ord($data[$pos + 2]) << 16) | $_ord_24;
+ }
+
+ private function parseRichText(string $is): RichText
+ {
+ $value = new RichText();
+ $value->createText($is);
+
+ return $value;
+ }
+
+ /**
+ * Phpstan 1.4.4 complains that this property is never read.
+ * So, we might be able to get rid of it altogether.
+ * For now, however, this function makes it readable,
+ * which satisfies Phpstan.
+ *
+ * @codeCoverageIgnore
+ */
+ public function getMapCellStyleXfIndex(): array
+ {
+ return $this->mapCellStyleXfIndex;
+ }
+
+ /**
+ * Parse conditional formatting blocks.
+ *
+ * @see https://www.openoffice.org/sc/excelfileformat.pdf Search for CFHEADER followed by CFRULE
+ */
+ private function readCFHeader(): array
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer forward to next record
+ $this->pos += 4 + $length;
+
+ if ($this->readDataOnly) {
+ return [];
+ }
+
+ // offset: 0; size: 2; Rule Count
+// $ruleCount = self::getUInt2d($recordData, 0);
+
+ // offset: var; size: var; cell range address list with
+ $cellRangeAddressList = ($this->version == self::XLS_BIFF8)
+ ? $this->readBIFF8CellRangeAddressList(substr($recordData, 12))
+ : $this->readBIFF5CellRangeAddressList(substr($recordData, 12));
+ $cellRangeAddresses = $cellRangeAddressList['cellRangeAddresses'];
+
+ return $cellRangeAddresses;
+ }
+
+ private function readCFRule(array $cellRangeAddresses): void
+ {
+ $length = self::getUInt2d($this->data, $this->pos + 2);
+ $recordData = $this->readRecordData($this->data, $this->pos + 4, $length);
+
+ // move stream pointer forward to next record
+ $this->pos += 4 + $length;
+
+ if ($this->readDataOnly) {
+ return;
+ }
+
+ // offset: 0; size: 2; Options
+ $cfRule = self::getUInt2d($recordData, 0);
+
+ // bit: 8-15; mask: 0x00FF; type
+ $type = (0x00FF & $cfRule) >> 0;
+ $type = ConditionalFormatting::type($type);
+
+ // bit: 0-7; mask: 0xFF00; type
+ $operator = (0xFF00 & $cfRule) >> 8;
+ $operator = ConditionalFormatting::operator($operator);
+
+ if ($type === null || $operator === null) {
+ return;
+ }
+
+ // offset: 2; size: 2; Size1
+ $size1 = self::getUInt2d($recordData, 2);
+
+ // offset: 4; size: 2; Size2
+ $size2 = self::getUInt2d($recordData, 4);
+
+ // offset: 6; size: 4; Options
+ $options = self::getInt4d($recordData, 6);
+
+ $style = new Style(false, true); // non-supervisor, conditional
+ $noFormatSet = true;
+ //$this->getCFStyleOptions($options, $style);
+
+ $hasFontRecord = (bool) ((0x04000000 & $options) >> 26);
+ $hasAlignmentRecord = (bool) ((0x08000000 & $options) >> 27);
+ $hasBorderRecord = (bool) ((0x10000000 & $options) >> 28);
+ $hasFillRecord = (bool) ((0x20000000 & $options) >> 29);
+ $hasProtectionRecord = (bool) ((0x40000000 & $options) >> 30);
+ // note unexpected values for following 4
+ $hasBorderLeft = !(bool) (0x00000400 & $options);
+ $hasBorderRight = !(bool) (0x00000800 & $options);
+ $hasBorderTop = !(bool) (0x00001000 & $options);
+ $hasBorderBottom = !(bool) (0x00002000 & $options);
+
+ $offset = 12;
+
+ if ($hasFontRecord === true) {
+ $fontStyle = substr($recordData, $offset, 118);
+ $this->getCFFontStyle($fontStyle, $style);
+ $offset += 118;
+ $noFormatSet = false;
+ }
+
+ if ($hasAlignmentRecord === true) {
+ //$alignmentStyle = substr($recordData, $offset, 8);
+ //$this->getCFAlignmentStyle($alignmentStyle, $style);
+ $offset += 8;
+ }
+
+ if ($hasBorderRecord === true) {
+ $borderStyle = substr($recordData, $offset, 8);
+ $this->getCFBorderStyle($borderStyle, $style, $hasBorderLeft, $hasBorderRight, $hasBorderTop, $hasBorderBottom);
+ $offset += 8;
+ $noFormatSet = false;
+ }
+
+ if ($hasFillRecord === true) {
+ $fillStyle = substr($recordData, $offset, 4);
+ $this->getCFFillStyle($fillStyle, $style);
+ $offset += 4;
+ $noFormatSet = false;
+ }
+
+ if ($hasProtectionRecord === true) {
+ //$protectionStyle = substr($recordData, $offset, 4);
+ //$this->getCFProtectionStyle($protectionStyle, $style);
+ $offset += 2;
+ }
+
+ $formula1 = $formula2 = null;
+ if ($size1 > 0) {
+ $formula1 = $this->readCFFormula($recordData, $offset, $size1);
+ if ($formula1 === null) {
+ return;
+ }
+
+ $offset += $size1;
+ }
+
+ if ($size2 > 0) {
+ $formula2 = $this->readCFFormula($recordData, $offset, $size2);
+ if ($formula2 === null) {
+ return;
+ }
+
+ $offset += $size2;
+ }
+
+ $this->setCFRules($cellRangeAddresses, $type, $operator, $formula1, $formula2, $style, $noFormatSet);
+ }
+
+ /*private function getCFStyleOptions(int $options, Style $style): void
+ {
+ }*/
+
+ private function getCFFontStyle(string $options, Style $style): void
+ {
+ $fontSize = self::getInt4d($options, 64);
+ if ($fontSize !== -1) {
+ $style->getFont()->setSize($fontSize / 20); // Convert twips to points
+ }
+ $options68 = self::getInt4d($options, 68);
+ $options88 = self::getInt4d($options, 88);
+
+ if (($options88 & 2) === 0) {
+ $bold = self::getUInt2d($options, 72); // 400 = normal, 700 = bold
+ if ($bold !== 0) {
+ $style->getFont()->setBold($bold >= 550);
+ }
+ if (($options68 & 2) !== 0) {
+ $style->getFont()->setItalic(true);
+ }
+ }
+ if (($options88 & 0x80) === 0) {
+ if (($options68 & 0x80) !== 0) {
+ $style->getFont()->setStrikethrough(true);
+ }
+ }
+
+ $color = self::getInt4d($options, 80);
+
+ if ($color !== -1) {
+ $style->getFont()->getColor()->setRGB(Xls\Color::map($color, $this->palette, $this->version)['rgb']);
+ }
+ }
+
+ /*private function getCFAlignmentStyle(string $options, Style $style): void
+ {
+ }*/
+
+ private function getCFBorderStyle(string $options, Style $style, bool $hasBorderLeft, bool $hasBorderRight, bool $hasBorderTop, bool $hasBorderBottom): void
+ {
+ $valueArray = unpack('V', $options);
+ $value = is_array($valueArray) ? $valueArray[1] : 0;
+ $left = $value & 15;
+ $right = ($value >> 4) & 15;
+ $top = ($value >> 8) & 15;
+ $bottom = ($value >> 12) & 15;
+ $leftc = ($value >> 16) & 0x7F;
+ $rightc = ($value >> 23) & 0x7F;
+ $valueArray = unpack('V', substr($options, 4));
+ $value = is_array($valueArray) ? $valueArray[1] : 0;
+ $topc = $value & 0x7F;
+ $bottomc = ($value & 0x3F80) >> 7;
+ if ($hasBorderLeft) {
+ $style->getBorders()->getLeft()
+ ->setBorderStyle(self::BORDER_STYLE_MAP[$left]);
+ $style->getBorders()->getLeft()->getColor()
+ ->setRGB(Xls\Color::map($leftc, $this->palette, $this->version)['rgb']);
+ }
+ if ($hasBorderRight) {
+ $style->getBorders()->getRight()
+ ->setBorderStyle(self::BORDER_STYLE_MAP[$right]);
+ $style->getBorders()->getRight()->getColor()
+ ->setRGB(Xls\Color::map($rightc, $this->palette, $this->version)['rgb']);
+ }
+ if ($hasBorderTop) {
+ $style->getBorders()->getTop()
+ ->setBorderStyle(self::BORDER_STYLE_MAP[$top]);
+ $style->getBorders()->getTop()->getColor()
+ ->setRGB(Xls\Color::map($topc, $this->palette, $this->version)['rgb']);
+ }
+ if ($hasBorderBottom) {
+ $style->getBorders()->getBottom()
+ ->setBorderStyle(self::BORDER_STYLE_MAP[$bottom]);
+ $style->getBorders()->getBottom()->getColor()
+ ->setRGB(Xls\Color::map($bottomc, $this->palette, $this->version)['rgb']);
+ }
+ }
+
+ private function getCFFillStyle(string $options, Style $style): void
+ {
+ $fillPattern = self::getUInt2d($options, 0);
+ // bit: 10-15; mask: 0xFC00; type
+ $fillPattern = (0xFC00 & $fillPattern) >> 10;
+ $fillPattern = FillPattern::lookup($fillPattern);
+ $fillPattern = $fillPattern === Fill::FILL_NONE ? Fill::FILL_SOLID : $fillPattern;
+
+ if ($fillPattern !== Fill::FILL_NONE) {
+ $style->getFill()->setFillType($fillPattern);
+
+ $fillColors = self::getUInt2d($options, 2);
+
+ // bit: 0-6; mask: 0x007F; type
+ $color1 = (0x007F & $fillColors) >> 0;
+
+ // bit: 7-13; mask: 0x3F80; type
+ $color2 = (0x3F80 & $fillColors) >> 7;
+ if ($fillPattern === Fill::FILL_SOLID) {
+ $style->getFill()->getStartColor()->setRGB(Xls\Color::map($color2, $this->palette, $this->version)['rgb']);
+ } else {
+ $style->getFill()->getStartColor()->setRGB(Xls\Color::map($color1, $this->palette, $this->version)['rgb']);
+ $style->getFill()->getEndColor()->setRGB(Xls\Color::map($color2, $this->palette, $this->version)['rgb']);
+ }
+ }
+ }
+
+ /*private function getCFProtectionStyle(string $options, Style $style): void
+ {
+ }*/
+
+ private function readCFFormula(string $recordData, int $offset, int $size): float|int|string|null
+ {
+ try {
+ $formula = substr($recordData, $offset, $size);
+ $formula = pack('v', $size) . $formula; // prepend the length
+
+ $formula = $this->getFormulaFromStructure($formula);
+ if (is_numeric($formula)) {
+ return (str_contains($formula, '.')) ? (float) $formula : (int) $formula;
+ }
+
+ return $formula;
+ } catch (PhpSpreadsheetException) {
+ return null;
+ }
+ }
+
+ private function setCFRules(array $cellRanges, string $type, string $operator, null|float|int|string $formula1, null|float|int|string $formula2, Style $style, bool $noFormatSet): void
+ {
+ foreach ($cellRanges as $cellRange) {
+ $conditional = new Conditional();
+ $conditional->setNoFormatSet($noFormatSet);
+ $conditional->setConditionType($type);
+ $conditional->setOperatorType($operator);
+ $conditional->setStopIfTrue(true);
+ if ($formula1 !== null) {
+ $conditional->addCondition($formula1);
+ }
+ if ($formula2 !== null) {
+ $conditional->addCondition($formula2);
+ }
+ $conditional->setStyle($style);
+
+ $conditionalStyles = $this->phpSheet->getStyle($cellRange)->getConditionalStyles();
+ $conditionalStyles[] = $conditional;
+
+ $this->phpSheet->getStyle($cellRange)->setConditionalStyles($conditionalStyles);
+ }
+ }
+
+ public function getVersion(): int
+ {
+ return $this->version;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color.php
new file mode 100644
index 00000000..6fd346bf
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color.php
@@ -0,0 +1,35 @@
+ 'FF0000']
+ */
+ public static function map(int $color, array $palette, int $version): array
+ {
+ if ($color <= 0x07 || $color >= 0x40) {
+ // special built-in color
+ return Color\BuiltIn::lookup($color);
+ } elseif (isset($palette[$color - 8])) {
+ // palette color, color index 0x08 maps to pallete index 0
+ return $palette[$color - 8];
+ }
+
+ // default color table
+ if ($version == Xls::XLS_BIFF8) {
+ return Color\BIFF8::lookup($color);
+ }
+
+ // BIFF5
+ return Color\BIFF5::lookup($color);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BIFF5.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BIFF5.php
new file mode 100644
index 00000000..2c0790c9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BIFF5.php
@@ -0,0 +1,73 @@
+ '000000',
+ 0x09 => 'FFFFFF',
+ 0x0A => 'FF0000',
+ 0x0B => '00FF00',
+ 0x0C => '0000FF',
+ 0x0D => 'FFFF00',
+ 0x0E => 'FF00FF',
+ 0x0F => '00FFFF',
+ 0x10 => '800000',
+ 0x11 => '008000',
+ 0x12 => '000080',
+ 0x13 => '808000',
+ 0x14 => '800080',
+ 0x15 => '008080',
+ 0x16 => 'C0C0C0',
+ 0x17 => '808080',
+ 0x18 => '8080FF',
+ 0x19 => '802060',
+ 0x1A => 'FFFFC0',
+ 0x1B => 'A0E0F0',
+ 0x1C => '600080',
+ 0x1D => 'FF8080',
+ 0x1E => '0080C0',
+ 0x1F => 'C0C0FF',
+ 0x20 => '000080',
+ 0x21 => 'FF00FF',
+ 0x22 => 'FFFF00',
+ 0x23 => '00FFFF',
+ 0x24 => '800080',
+ 0x25 => '800000',
+ 0x26 => '008080',
+ 0x27 => '0000FF',
+ 0x28 => '00CFFF',
+ 0x29 => '69FFFF',
+ 0x2A => 'E0FFE0',
+ 0x2B => 'FFFF80',
+ 0x2C => 'A6CAF0',
+ 0x2D => 'DD9CB3',
+ 0x2E => 'B38FEE',
+ 0x2F => 'E3E3E3',
+ 0x30 => '2A6FF9',
+ 0x31 => '3FB8CD',
+ 0x32 => '488436',
+ 0x33 => '958C41',
+ 0x34 => '8E5E42',
+ 0x35 => 'A0627A',
+ 0x36 => '624FAC',
+ 0x37 => '969696',
+ 0x38 => '1D2FBE',
+ 0x39 => '286676',
+ 0x3A => '004500',
+ 0x3B => '453E01',
+ 0x3C => '6A2813',
+ 0x3D => '85396A',
+ 0x3E => '4A3285',
+ 0x3F => '424242',
+ ];
+
+ /**
+ * Map color array from BIFF5 built-in color index.
+ */
+ public static function lookup(int $color): array
+ {
+ return ['rgb' => self::BIFF5_COLOR_MAP[$color] ?? '000000'];
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BIFF8.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BIFF8.php
new file mode 100644
index 00000000..914034df
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BIFF8.php
@@ -0,0 +1,73 @@
+ '000000',
+ 0x09 => 'FFFFFF',
+ 0x0A => 'FF0000',
+ 0x0B => '00FF00',
+ 0x0C => '0000FF',
+ 0x0D => 'FFFF00',
+ 0x0E => 'FF00FF',
+ 0x0F => '00FFFF',
+ 0x10 => '800000',
+ 0x11 => '008000',
+ 0x12 => '000080',
+ 0x13 => '808000',
+ 0x14 => '800080',
+ 0x15 => '008080',
+ 0x16 => 'C0C0C0',
+ 0x17 => '808080',
+ 0x18 => '9999FF',
+ 0x19 => '993366',
+ 0x1A => 'FFFFCC',
+ 0x1B => 'CCFFFF',
+ 0x1C => '660066',
+ 0x1D => 'FF8080',
+ 0x1E => '0066CC',
+ 0x1F => 'CCCCFF',
+ 0x20 => '000080',
+ 0x21 => 'FF00FF',
+ 0x22 => 'FFFF00',
+ 0x23 => '00FFFF',
+ 0x24 => '800080',
+ 0x25 => '800000',
+ 0x26 => '008080',
+ 0x27 => '0000FF',
+ 0x28 => '00CCFF',
+ 0x29 => 'CCFFFF',
+ 0x2A => 'CCFFCC',
+ 0x2B => 'FFFF99',
+ 0x2C => '99CCFF',
+ 0x2D => 'FF99CC',
+ 0x2E => 'CC99FF',
+ 0x2F => 'FFCC99',
+ 0x30 => '3366FF',
+ 0x31 => '33CCCC',
+ 0x32 => '99CC00',
+ 0x33 => 'FFCC00',
+ 0x34 => 'FF9900',
+ 0x35 => 'FF6600',
+ 0x36 => '666699',
+ 0x37 => '969696',
+ 0x38 => '003366',
+ 0x39 => '339966',
+ 0x3A => '003300',
+ 0x3B => '333300',
+ 0x3C => '993300',
+ 0x3D => '993366',
+ 0x3E => '333399',
+ 0x3F => '333333',
+ ];
+
+ /**
+ * Map color array from BIFF8 built-in color index.
+ */
+ public static function lookup(int $color): array
+ {
+ return ['rgb' => self::BIFF8_COLOR_MAP[$color] ?? '000000'];
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BuiltIn.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BuiltIn.php
new file mode 100644
index 00000000..a715b110
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Color/BuiltIn.php
@@ -0,0 +1,29 @@
+ '000000',
+ 0x01 => 'FFFFFF',
+ 0x02 => 'FF0000',
+ 0x03 => '00FF00',
+ 0x04 => '0000FF',
+ 0x05 => 'FFFF00',
+ 0x06 => 'FF00FF',
+ 0x07 => '00FFFF',
+ 0x40 => '000000', // system window text color
+ 0x41 => 'FFFFFF', // system window background color
+ ];
+
+ /**
+ * Map built-in color to RGB value.
+ *
+ * @param int $color Indexed color
+ */
+ public static function lookup(int $color): array
+ {
+ return ['rgb' => self::BUILTIN_COLOR_MAP[$color] ?? '000000'];
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/ConditionalFormatting.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/ConditionalFormatting.php
new file mode 100644
index 00000000..fbd31d56
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/ConditionalFormatting.php
@@ -0,0 +1,49 @@
+
+ */
+ private static array $types = [
+ 0x01 => Conditional::CONDITION_CELLIS,
+ 0x02 => Conditional::CONDITION_EXPRESSION,
+ ];
+
+ /**
+ * @var array
+ */
+ private static array $operators = [
+ 0x00 => Conditional::OPERATOR_NONE,
+ 0x01 => Conditional::OPERATOR_BETWEEN,
+ 0x02 => Conditional::OPERATOR_NOTBETWEEN,
+ 0x03 => Conditional::OPERATOR_EQUAL,
+ 0x04 => Conditional::OPERATOR_NOTEQUAL,
+ 0x05 => Conditional::OPERATOR_GREATERTHAN,
+ 0x06 => Conditional::OPERATOR_LESSTHAN,
+ 0x07 => Conditional::OPERATOR_GREATERTHANOREQUAL,
+ 0x08 => Conditional::OPERATOR_LESSTHANOREQUAL,
+ ];
+
+ public static function type(int $type): ?string
+ {
+ if (isset(self::$types[$type])) {
+ return self::$types[$type];
+ }
+
+ return null;
+ }
+
+ public static function operator(int $operator): ?string
+ {
+ if (isset(self::$operators[$operator])) {
+ return self::$operators[$operator];
+ }
+
+ return null;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/DataValidationHelper.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/DataValidationHelper.php
new file mode 100644
index 00000000..874e6994
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/DataValidationHelper.php
@@ -0,0 +1,72 @@
+
+ */
+ private static array $types = [
+ 0x00 => DataValidation::TYPE_NONE,
+ 0x01 => DataValidation::TYPE_WHOLE,
+ 0x02 => DataValidation::TYPE_DECIMAL,
+ 0x03 => DataValidation::TYPE_LIST,
+ 0x04 => DataValidation::TYPE_DATE,
+ 0x05 => DataValidation::TYPE_TIME,
+ 0x06 => DataValidation::TYPE_TEXTLENGTH,
+ 0x07 => DataValidation::TYPE_CUSTOM,
+ ];
+
+ /**
+ * @var array
+ */
+ private static array $errorStyles = [
+ 0x00 => DataValidation::STYLE_STOP,
+ 0x01 => DataValidation::STYLE_WARNING,
+ 0x02 => DataValidation::STYLE_INFORMATION,
+ ];
+
+ /**
+ * @var array
+ */
+ private static array $operators = [
+ 0x00 => DataValidation::OPERATOR_BETWEEN,
+ 0x01 => DataValidation::OPERATOR_NOTBETWEEN,
+ 0x02 => DataValidation::OPERATOR_EQUAL,
+ 0x03 => DataValidation::OPERATOR_NOTEQUAL,
+ 0x04 => DataValidation::OPERATOR_GREATERTHAN,
+ 0x05 => DataValidation::OPERATOR_LESSTHAN,
+ 0x06 => DataValidation::OPERATOR_GREATERTHANOREQUAL,
+ 0x07 => DataValidation::OPERATOR_LESSTHANOREQUAL,
+ ];
+
+ public static function type(int $type): ?string
+ {
+ if (isset(self::$types[$type])) {
+ return self::$types[$type];
+ }
+
+ return null;
+ }
+
+ public static function errorStyle(int $errorStyle): ?string
+ {
+ if (isset(self::$errorStyles[$errorStyle])) {
+ return self::$errorStyles[$errorStyle];
+ }
+
+ return null;
+ }
+
+ public static function operator(int $operator): ?string
+ {
+ if (isset(self::$operators[$operator])) {
+ return self::$operators[$operator];
+ }
+
+ return null;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/ErrorCode.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/ErrorCode.php
new file mode 100644
index 00000000..fa8f8cd5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/ErrorCode.php
@@ -0,0 +1,24 @@
+ '#NULL!',
+ 0x07 => '#DIV/0!',
+ 0x0F => '#VALUE!',
+ 0x17 => '#REF!',
+ 0x1D => '#NAME?',
+ 0x24 => '#NUM!',
+ 0x2A => '#N/A',
+ ];
+
+ /**
+ * Map error code, e.g. '#N/A'.
+ */
+ public static function lookup(int $code): string|bool
+ {
+ return self::ERROR_CODE_MAP[$code] ?? false;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Escher.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Escher.php
new file mode 100644
index 00000000..094c19e8
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Escher.php
@@ -0,0 +1,607 @@
+object = $object;
+ }
+
+ private const WHICH_ROUTINE = [
+ self::DGGCONTAINER => 'readDggContainer',
+ self::DGG => 'readDgg',
+ self::BSTORECONTAINER => 'readBstoreContainer',
+ self::BSE => 'readBSE',
+ self::BLIPJPEG => 'readBlipJPEG',
+ self::BLIPPNG => 'readBlipPNG',
+ self::OPT => 'readOPT',
+ self::TERTIARYOPT => 'readTertiaryOPT',
+ self::SPLITMENUCOLORS => 'readSplitMenuColors',
+ self::DGCONTAINER => 'readDgContainer',
+ self::DG => 'readDg',
+ self::SPGRCONTAINER => 'readSpgrContainer',
+ self::SPCONTAINER => 'readSpContainer',
+ self::SPGR => 'readSpgr',
+ self::SP => 'readSp',
+ self::CLIENTTEXTBOX => 'readClientTextbox',
+ self::CLIENTANCHOR => 'readClientAnchor',
+ self::CLIENTDATA => 'readClientData',
+ ];
+
+ /**
+ * Load Escher stream data. May be a partial Escher stream.
+ */
+ public function load(string $data): BSE|BstoreContainer|DgContainer|DggContainer|\PhpOffice\PhpSpreadsheet\Shared\Escher|SpContainer|SpgrContainer
+ {
+ $this->data = $data;
+
+ // total byte size of Excel data (workbook global substream + sheet substreams)
+ $this->dataSize = strlen($this->data);
+
+ $this->pos = 0;
+
+ // Parse Escher stream
+ while ($this->pos < $this->dataSize) {
+ // offset: 2; size: 2: Record Type
+ $fbt = Xls::getUInt2d($this->data, $this->pos + 2);
+ $routine = self::WHICH_ROUTINE[$fbt] ?? 'readDefault';
+ if (method_exists($this, $routine)) {
+ $this->$routine();
+ }
+ }
+
+ return $this->object;
+ }
+
+ /**
+ * Read a generic record.
+ */
+ private function readDefault(): void
+ {
+ // offset 0; size: 2; recVer and recInstance
+ //$verInstance = Xls::getUInt2d($this->data, $this->pos);
+
+ // offset: 2; size: 2: Record Type
+ //$fbt = Xls::getUInt2d($this->data, $this->pos + 2);
+
+ // bit: 0-3; mask: 0x000F; recVer
+ //$recVer = (0x000F & $verInstance) >> 0;
+
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ //$recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+ }
+
+ /**
+ * Read DggContainer record (Drawing Group Container).
+ */
+ private function readDggContainer(): void
+ {
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ $recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+
+ // record is a container, read contents
+ $dggContainer = new DggContainer();
+ $this->applyAttribute('setDggContainer', $dggContainer);
+ $reader = new self($dggContainer);
+ $reader->load($recordData);
+ }
+
+ /**
+ * Read Dgg record (Drawing Group).
+ */
+ private function readDgg(): void
+ {
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ //$recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+ }
+
+ /**
+ * Read BstoreContainer record (Blip Store Container).
+ */
+ private function readBstoreContainer(): void
+ {
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ $recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+
+ // record is a container, read contents
+ $bstoreContainer = new BstoreContainer();
+ $this->applyAttribute('setBstoreContainer', $bstoreContainer);
+ $reader = new self($bstoreContainer);
+ $reader->load($recordData);
+ }
+
+ /**
+ * Read BSE record.
+ */
+ private function readBSE(): void
+ {
+ // offset: 0; size: 2; recVer and recInstance
+
+ // bit: 4-15; mask: 0xFFF0; recInstance
+ $recInstance = (0xFFF0 & Xls::getUInt2d($this->data, $this->pos)) >> 4;
+
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ $recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+
+ // add BSE to BstoreContainer
+ $BSE = new BSE();
+ $this->applyAttribute('addBSE', $BSE);
+
+ $BSE->setBLIPType($recInstance);
+
+ // offset: 0; size: 1; btWin32 (MSOBLIPTYPE)
+ //$btWin32 = ord($recordData[0]);
+
+ // offset: 1; size: 1; btWin32 (MSOBLIPTYPE)
+ //$btMacOS = ord($recordData[1]);
+
+ // offset: 2; size: 16; MD4 digest
+ //$rgbUid = substr($recordData, 2, 16);
+
+ // offset: 18; size: 2; tag
+ //$tag = Xls::getUInt2d($recordData, 18);
+
+ // offset: 20; size: 4; size of BLIP in bytes
+ //$size = Xls::getInt4d($recordData, 20);
+
+ // offset: 24; size: 4; number of references to this BLIP
+ //$cRef = Xls::getInt4d($recordData, 24);
+
+ // offset: 28; size: 4; MSOFO file offset
+ //$foDelay = Xls::getInt4d($recordData, 28);
+
+ // offset: 32; size: 1; unused1
+ //$unused1 = ord($recordData[32]);
+
+ // offset: 33; size: 1; size of nameData in bytes (including null terminator)
+ $cbName = ord($recordData[33]);
+
+ // offset: 34; size: 1; unused2
+ //$unused2 = ord($recordData[34]);
+
+ // offset: 35; size: 1; unused3
+ //$unused3 = ord($recordData[35]);
+
+ // offset: 36; size: $cbName; nameData
+ //$nameData = substr($recordData, 36, $cbName);
+
+ // offset: 36 + $cbName, size: var; the BLIP data
+ $blipData = substr($recordData, 36 + $cbName);
+
+ // record is a container, read contents
+ $reader = new self($BSE);
+ $reader->load($blipData);
+ }
+
+ /**
+ * Read BlipJPEG record. Holds raw JPEG image data.
+ */
+ private function readBlipJPEG(): void
+ {
+ // offset: 0; size: 2; recVer and recInstance
+
+ // bit: 4-15; mask: 0xFFF0; recInstance
+ $recInstance = (0xFFF0 & Xls::getUInt2d($this->data, $this->pos)) >> 4;
+
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ $recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+
+ $pos = 0;
+
+ // offset: 0; size: 16; rgbUid1 (MD4 digest of)
+ //$rgbUid1 = substr($recordData, 0, 16);
+ $pos += 16;
+
+ // offset: 16; size: 16; rgbUid2 (MD4 digest), only if $recInstance = 0x46B or 0x6E3
+ if (in_array($recInstance, [0x046B, 0x06E3])) {
+ //$rgbUid2 = substr($recordData, 16, 16);
+ $pos += 16;
+ }
+
+ // offset: var; size: 1; tag
+ //$tag = ord($recordData[$pos]);
+ ++$pos;
+
+ // offset: var; size: var; the raw image data
+ $data = substr($recordData, $pos);
+
+ $blip = new Blip();
+ $blip->setData($data);
+
+ $this->applyAttribute('setBlip', $blip);
+ }
+
+ /**
+ * Read BlipPNG record. Holds raw PNG image data.
+ */
+ private function readBlipPNG(): void
+ {
+ // offset: 0; size: 2; recVer and recInstance
+
+ // bit: 4-15; mask: 0xFFF0; recInstance
+ $recInstance = (0xFFF0 & Xls::getUInt2d($this->data, $this->pos)) >> 4;
+
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ $recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+
+ $pos = 0;
+
+ // offset: 0; size: 16; rgbUid1 (MD4 digest of)
+ //$rgbUid1 = substr($recordData, 0, 16);
+ $pos += 16;
+
+ // offset: 16; size: 16; rgbUid2 (MD4 digest), only if $recInstance = 0x46B or 0x6E3
+ if ($recInstance == 0x06E1) {
+ //$rgbUid2 = substr($recordData, 16, 16);
+ $pos += 16;
+ }
+
+ // offset: var; size: 1; tag
+ //$tag = ord($recordData[$pos]);
+ ++$pos;
+
+ // offset: var; size: var; the raw image data
+ $data = substr($recordData, $pos);
+
+ $blip = new Blip();
+ $blip->setData($data);
+
+ $this->applyAttribute('setBlip', $blip);
+ }
+
+ /**
+ * Read OPT record. This record may occur within DggContainer record or SpContainer.
+ */
+ private function readOPT(): void
+ {
+ // offset: 0; size: 2; recVer and recInstance
+
+ // bit: 4-15; mask: 0xFFF0; recInstance
+ $recInstance = (0xFFF0 & Xls::getUInt2d($this->data, $this->pos)) >> 4;
+
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ $recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+
+ $this->readOfficeArtRGFOPTE($recordData, $recInstance);
+ }
+
+ /**
+ * Read TertiaryOPT record.
+ */
+ private function readTertiaryOPT(): void
+ {
+ // offset: 0; size: 2; recVer and recInstance
+
+ // bit: 4-15; mask: 0xFFF0; recInstance
+ //$recInstance = (0xFFF0 & Xls::getUInt2d($this->data, $this->pos)) >> 4;
+
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ //$recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+ }
+
+ /**
+ * Read SplitMenuColors record.
+ */
+ private function readSplitMenuColors(): void
+ {
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ //$recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+ }
+
+ /**
+ * Read DgContainer record (Drawing Container).
+ */
+ private function readDgContainer(): void
+ {
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ $recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+
+ // record is a container, read contents
+ $dgContainer = new DgContainer();
+ $this->applyAttribute('setDgContainer', $dgContainer);
+ $reader = new self($dgContainer);
+ $reader->load($recordData);
+ }
+
+ /**
+ * Read Dg record (Drawing).
+ */
+ private function readDg(): void
+ {
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ //$recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+ }
+
+ /**
+ * Read SpgrContainer record (Shape Group Container).
+ */
+ private function readSpgrContainer(): void
+ {
+ // context is either context DgContainer or SpgrContainer
+
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ $recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+
+ // record is a container, read contents
+ $spgrContainer = new SpgrContainer();
+
+ if ($this->object instanceof DgContainer) {
+ // DgContainer
+ $this->object->setSpgrContainer($spgrContainer);
+ } elseif ($this->object instanceof SpgrContainer) {
+ // SpgrContainer
+ $this->object->addChild($spgrContainer);
+ }
+
+ $reader = new self($spgrContainer);
+ $reader->load($recordData);
+ }
+
+ /**
+ * Read SpContainer record (Shape Container).
+ */
+ private function readSpContainer(): void
+ {
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ $recordData = substr($this->data, $this->pos + 8, $length);
+
+ // add spContainer to spgrContainer
+ $spContainer = new SpContainer();
+ $this->applyAttribute('addChild', $spContainer);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+
+ // record is a container, read contents
+ $reader = new self($spContainer);
+ $reader->load($recordData);
+ }
+
+ /**
+ * Read Spgr record (Shape Group).
+ */
+ private function readSpgr(): void
+ {
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ //$recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+ }
+
+ /**
+ * Read Sp record (Shape).
+ */
+ private function readSp(): void
+ {
+ // offset: 0; size: 2; recVer and recInstance
+
+ // bit: 4-15; mask: 0xFFF0; recInstance
+ //$recInstance = (0xFFF0 & Xls::getUInt2d($this->data, $this->pos)) >> 4;
+
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ //$recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+ }
+
+ /**
+ * Read ClientTextbox record.
+ */
+ private function readClientTextbox(): void
+ {
+ // offset: 0; size: 2; recVer and recInstance
+
+ // bit: 4-15; mask: 0xFFF0; recInstance
+ //$recInstance = (0xFFF0 & Xls::getUInt2d($this->data, $this->pos)) >> 4;
+
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ //$recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+ }
+
+ /**
+ * Read ClientAnchor record. This record holds information about where the shape is anchored in worksheet.
+ */
+ private function readClientAnchor(): void
+ {
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ $recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+
+ // offset: 2; size: 2; upper-left corner column index (0-based)
+ $c1 = Xls::getUInt2d($recordData, 2);
+
+ // offset: 4; size: 2; upper-left corner horizontal offset in 1/1024 of column width
+ $startOffsetX = Xls::getUInt2d($recordData, 4);
+
+ // offset: 6; size: 2; upper-left corner row index (0-based)
+ $r1 = Xls::getUInt2d($recordData, 6);
+
+ // offset: 8; size: 2; upper-left corner vertical offset in 1/256 of row height
+ $startOffsetY = Xls::getUInt2d($recordData, 8);
+
+ // offset: 10; size: 2; bottom-right corner column index (0-based)
+ $c2 = Xls::getUInt2d($recordData, 10);
+
+ // offset: 12; size: 2; bottom-right corner horizontal offset in 1/1024 of column width
+ $endOffsetX = Xls::getUInt2d($recordData, 12);
+
+ // offset: 14; size: 2; bottom-right corner row index (0-based)
+ $r2 = Xls::getUInt2d($recordData, 14);
+
+ // offset: 16; size: 2; bottom-right corner vertical offset in 1/256 of row height
+ $endOffsetY = Xls::getUInt2d($recordData, 16);
+
+ $this->applyAttribute('setStartCoordinates', Coordinate::stringFromColumnIndex($c1 + 1) . ($r1 + 1));
+ $this->applyAttribute('setStartOffsetX', $startOffsetX);
+ $this->applyAttribute('setStartOffsetY', $startOffsetY);
+ $this->applyAttribute('setEndCoordinates', Coordinate::stringFromColumnIndex($c2 + 1) . ($r2 + 1));
+ $this->applyAttribute('setEndOffsetX', $endOffsetX);
+ $this->applyAttribute('setEndOffsetY', $endOffsetY);
+ }
+
+ private function applyAttribute(string $name, mixed $value): void
+ {
+ if (method_exists($this->object, $name)) {
+ $this->object->$name($value);
+ }
+ }
+
+ /**
+ * Read ClientData record.
+ */
+ private function readClientData(): void
+ {
+ $length = Xls::getInt4d($this->data, $this->pos + 4);
+ //$recordData = substr($this->data, $this->pos + 8, $length);
+
+ // move stream pointer to next record
+ $this->pos += 8 + $length;
+ }
+
+ /**
+ * Read OfficeArtRGFOPTE table of property-value pairs.
+ *
+ * @param string $data Binary data
+ * @param int $n Number of properties
+ */
+ private function readOfficeArtRGFOPTE(string $data, int $n): void
+ {
+ $splicedComplexData = substr($data, 6 * $n);
+
+ // loop through property-value pairs
+ for ($i = 0; $i < $n; ++$i) {
+ // read 6 bytes at a time
+ $fopte = substr($data, 6 * $i, 6);
+
+ // offset: 0; size: 2; opid
+ $opid = Xls::getUInt2d($fopte, 0);
+
+ // bit: 0-13; mask: 0x3FFF; opid.opid
+ $opidOpid = (0x3FFF & $opid) >> 0;
+
+ // bit: 14; mask 0x4000; 1 = value in op field is BLIP identifier
+ //$opidFBid = (0x4000 & $opid) >> 14;
+
+ // bit: 15; mask 0x8000; 1 = this is a complex property, op field specifies size of complex data
+ $opidFComplex = (0x8000 & $opid) >> 15;
+
+ // offset: 2; size: 4; the value for this property
+ $op = Xls::getInt4d($fopte, 2);
+
+ if ($opidFComplex) {
+ $complexData = substr($splicedComplexData, 0, $op);
+ $splicedComplexData = substr($splicedComplexData, $op);
+
+ // we store string value with complex data
+ $value = $complexData;
+ } else {
+ // we store integer value
+ $value = $op;
+ }
+
+ if (method_exists($this->object, 'setOPT')) {
+ $this->object->setOPT($opidOpid, $value);
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/MD5.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/MD5.php
new file mode 100644
index 00000000..7da2eeee
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/MD5.php
@@ -0,0 +1,193 @@
+reset();
+ }
+
+ /**
+ * Reset the MD5 stream context.
+ */
+ public function reset(): void
+ {
+ $this->a = 0x67452301;
+ $this->b = self::signedInt(0xEFCDAB89);
+ $this->c = self::signedInt(0x98BADCFE);
+ $this->d = 0x10325476;
+ }
+
+ /**
+ * Get MD5 stream context.
+ */
+ public function getContext(): string
+ {
+ $s = '';
+ foreach (['a', 'b', 'c', 'd'] as $i) {
+ $v = $this->{$i};
+ $s .= chr($v & 0xFF);
+ $s .= chr(($v >> 8) & 0xFF);
+ $s .= chr(($v >> 16) & 0xFF);
+ $s .= chr(($v >> 24) & 0xFF);
+ }
+
+ return $s;
+ }
+
+ /**
+ * Add data to context.
+ *
+ * @param string $data Data to add
+ */
+ public function add(string $data): void
+ {
+ // @phpstan-ignore-next-line
+ $words = array_values(unpack('V16', $data));
+
+ $A = $this->a;
+ $B = $this->b;
+ $C = $this->c;
+ $D = $this->d;
+
+ $F = [self::class, 'f'];
+ $G = [self::class, 'g'];
+ $H = [self::class, 'h'];
+ $I = [self::class, 'i'];
+
+ // ROUND 1
+ self::step($F, $A, $B, $C, $D, $words[0], 7, 0xD76AA478);
+ self::step($F, $D, $A, $B, $C, $words[1], 12, 0xE8C7B756);
+ self::step($F, $C, $D, $A, $B, $words[2], 17, 0x242070DB);
+ self::step($F, $B, $C, $D, $A, $words[3], 22, 0xC1BDCEEE);
+ self::step($F, $A, $B, $C, $D, $words[4], 7, 0xF57C0FAF);
+ self::step($F, $D, $A, $B, $C, $words[5], 12, 0x4787C62A);
+ self::step($F, $C, $D, $A, $B, $words[6], 17, 0xA8304613);
+ self::step($F, $B, $C, $D, $A, $words[7], 22, 0xFD469501);
+ self::step($F, $A, $B, $C, $D, $words[8], 7, 0x698098D8);
+ self::step($F, $D, $A, $B, $C, $words[9], 12, 0x8B44F7AF);
+ self::step($F, $C, $D, $A, $B, $words[10], 17, 0xFFFF5BB1);
+ self::step($F, $B, $C, $D, $A, $words[11], 22, 0x895CD7BE);
+ self::step($F, $A, $B, $C, $D, $words[12], 7, 0x6B901122);
+ self::step($F, $D, $A, $B, $C, $words[13], 12, 0xFD987193);
+ self::step($F, $C, $D, $A, $B, $words[14], 17, 0xA679438E);
+ self::step($F, $B, $C, $D, $A, $words[15], 22, 0x49B40821);
+
+ // ROUND 2
+ self::step($G, $A, $B, $C, $D, $words[1], 5, 0xF61E2562);
+ self::step($G, $D, $A, $B, $C, $words[6], 9, 0xC040B340);
+ self::step($G, $C, $D, $A, $B, $words[11], 14, 0x265E5A51);
+ self::step($G, $B, $C, $D, $A, $words[0], 20, 0xE9B6C7AA);
+ self::step($G, $A, $B, $C, $D, $words[5], 5, 0xD62F105D);
+ self::step($G, $D, $A, $B, $C, $words[10], 9, 0x02441453);
+ self::step($G, $C, $D, $A, $B, $words[15], 14, 0xD8A1E681);
+ self::step($G, $B, $C, $D, $A, $words[4], 20, 0xE7D3FBC8);
+ self::step($G, $A, $B, $C, $D, $words[9], 5, 0x21E1CDE6);
+ self::step($G, $D, $A, $B, $C, $words[14], 9, 0xC33707D6);
+ self::step($G, $C, $D, $A, $B, $words[3], 14, 0xF4D50D87);
+ self::step($G, $B, $C, $D, $A, $words[8], 20, 0x455A14ED);
+ self::step($G, $A, $B, $C, $D, $words[13], 5, 0xA9E3E905);
+ self::step($G, $D, $A, $B, $C, $words[2], 9, 0xFCEFA3F8);
+ self::step($G, $C, $D, $A, $B, $words[7], 14, 0x676F02D9);
+ self::step($G, $B, $C, $D, $A, $words[12], 20, 0x8D2A4C8A);
+
+ // ROUND 3
+ self::step($H, $A, $B, $C, $D, $words[5], 4, 0xFFFA3942);
+ self::step($H, $D, $A, $B, $C, $words[8], 11, 0x8771F681);
+ self::step($H, $C, $D, $A, $B, $words[11], 16, 0x6D9D6122);
+ self::step($H, $B, $C, $D, $A, $words[14], 23, 0xFDE5380C);
+ self::step($H, $A, $B, $C, $D, $words[1], 4, 0xA4BEEA44);
+ self::step($H, $D, $A, $B, $C, $words[4], 11, 0x4BDECFA9);
+ self::step($H, $C, $D, $A, $B, $words[7], 16, 0xF6BB4B60);
+ self::step($H, $B, $C, $D, $A, $words[10], 23, 0xBEBFBC70);
+ self::step($H, $A, $B, $C, $D, $words[13], 4, 0x289B7EC6);
+ self::step($H, $D, $A, $B, $C, $words[0], 11, 0xEAA127FA);
+ self::step($H, $C, $D, $A, $B, $words[3], 16, 0xD4EF3085);
+ self::step($H, $B, $C, $D, $A, $words[6], 23, 0x04881D05);
+ self::step($H, $A, $B, $C, $D, $words[9], 4, 0xD9D4D039);
+ self::step($H, $D, $A, $B, $C, $words[12], 11, 0xE6DB99E5);
+ self::step($H, $C, $D, $A, $B, $words[15], 16, 0x1FA27CF8);
+ self::step($H, $B, $C, $D, $A, $words[2], 23, 0xC4AC5665);
+
+ // ROUND 4
+ self::step($I, $A, $B, $C, $D, $words[0], 6, 0xF4292244);
+ self::step($I, $D, $A, $B, $C, $words[7], 10, 0x432AFF97);
+ self::step($I, $C, $D, $A, $B, $words[14], 15, 0xAB9423A7);
+ self::step($I, $B, $C, $D, $A, $words[5], 21, 0xFC93A039);
+ self::step($I, $A, $B, $C, $D, $words[12], 6, 0x655B59C3);
+ self::step($I, $D, $A, $B, $C, $words[3], 10, 0x8F0CCC92);
+ self::step($I, $C, $D, $A, $B, $words[10], 15, 0xFFEFF47D);
+ self::step($I, $B, $C, $D, $A, $words[1], 21, 0x85845DD1);
+ self::step($I, $A, $B, $C, $D, $words[8], 6, 0x6FA87E4F);
+ self::step($I, $D, $A, $B, $C, $words[15], 10, 0xFE2CE6E0);
+ self::step($I, $C, $D, $A, $B, $words[6], 15, 0xA3014314);
+ self::step($I, $B, $C, $D, $A, $words[13], 21, 0x4E0811A1);
+ self::step($I, $A, $B, $C, $D, $words[4], 6, 0xF7537E82);
+ self::step($I, $D, $A, $B, $C, $words[11], 10, 0xBD3AF235);
+ self::step($I, $C, $D, $A, $B, $words[2], 15, 0x2AD7D2BB);
+ self::step($I, $B, $C, $D, $A, $words[9], 21, 0xEB86D391);
+
+ $this->a = ($this->a + $A) & self::$allOneBits;
+ $this->b = ($this->b + $B) & self::$allOneBits;
+ $this->c = ($this->c + $C) & self::$allOneBits;
+ $this->d = ($this->d + $D) & self::$allOneBits;
+ }
+
+ private static function f(int $X, int $Y, int $Z): int
+ {
+ return ($X & $Y) | ((~$X) & $Z); // X AND Y OR NOT X AND Z
+ }
+
+ private static function g(int $X, int $Y, int $Z): int
+ {
+ return ($X & $Z) | ($Y & (~$Z)); // X AND Z OR Y AND NOT Z
+ }
+
+ private static function h(int $X, int $Y, int $Z): int
+ {
+ return $X ^ $Y ^ $Z; // X XOR Y XOR Z
+ }
+
+ private static function i(int $X, int $Y, int $Z): int
+ {
+ return $Y ^ ($X | (~$Z)); // Y XOR (X OR NOT Z)
+ }
+
+ /** @param float|int $t may be float on 32-bit system */
+ private static function step(callable $func, int &$A, int $B, int $C, int $D, int $M, int $s, $t): void
+ {
+ $t = self::signedInt($t);
+ $A = (int) ($A + call_user_func($func, $B, $C, $D) + $M + $t) & self::$allOneBits;
+ $A = self::rotate($A, $s);
+ $A = (int) ($B + $A) & self::$allOneBits;
+ }
+
+ /** @param float|int $result may be float on 32-bit system */
+ private static function signedInt($result): int
+ {
+ return is_int($result) ? $result : (int) (PHP_INT_MIN + $result - 1 - PHP_INT_MAX);
+ }
+
+ private static function rotate(int $decimal, int $bits): int
+ {
+ $binary = str_pad(decbin($decimal), 32, '0', STR_PAD_LEFT);
+
+ return self::signedInt(bindec(substr($binary, $bits) . substr($binary, 0, $bits)));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/RC4.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/RC4.php
new file mode 100644
index 00000000..663f3672
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/RC4.php
@@ -0,0 +1,59 @@
+i = 0; $this->i < 256; ++$this->i) {
+ $this->s[$this->i] = $this->i;
+ }
+
+ $this->j = 0;
+ for ($this->i = 0; $this->i < 256; ++$this->i) {
+ $this->j = ($this->j + $this->s[$this->i] + ord($key[$this->i % $len])) % 256;
+ $t = $this->s[$this->i];
+ $this->s[$this->i] = $this->s[$this->j];
+ $this->s[$this->j] = $t;
+ }
+ $this->i = $this->j = 0;
+ }
+
+ /**
+ * Symmetric decryption/encryption function.
+ *
+ * @param string $data Data to encrypt/decrypt
+ */
+ public function RC4(string $data): string
+ {
+ $len = strlen($data);
+ for ($c = 0; $c < $len; ++$c) {
+ $this->i = ($this->i + 1) % 256;
+ $this->j = ($this->j + $this->s[$this->i]) % 256;
+ $t = $this->s[$this->i];
+ $this->s[$this->i] = $this->s[$this->j];
+ $this->s[$this->j] = $t;
+
+ $t = ($this->s[$this->i] + $this->s[$this->j]) % 256;
+
+ $data[$c] = chr(ord($data[$c]) ^ $this->s[$t]);
+ }
+
+ return $data;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/Border.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/Border.php
new file mode 100644
index 00000000..97cebbd4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/Border.php
@@ -0,0 +1,37 @@
+
+ */
+ protected static array $borderStyleMap = [
+ 0x00 => StyleBorder::BORDER_NONE,
+ 0x01 => StyleBorder::BORDER_THIN,
+ 0x02 => StyleBorder::BORDER_MEDIUM,
+ 0x03 => StyleBorder::BORDER_DASHED,
+ 0x04 => StyleBorder::BORDER_DOTTED,
+ 0x05 => StyleBorder::BORDER_THICK,
+ 0x06 => StyleBorder::BORDER_DOUBLE,
+ 0x07 => StyleBorder::BORDER_HAIR,
+ 0x08 => StyleBorder::BORDER_MEDIUMDASHED,
+ 0x09 => StyleBorder::BORDER_DASHDOT,
+ 0x0A => StyleBorder::BORDER_MEDIUMDASHDOT,
+ 0x0B => StyleBorder::BORDER_DASHDOTDOT,
+ 0x0C => StyleBorder::BORDER_MEDIUMDASHDOTDOT,
+ 0x0D => StyleBorder::BORDER_SLANTDASHDOT,
+ ];
+
+ public static function lookup(int $index): string
+ {
+ if (isset(self::$borderStyleMap[$index])) {
+ return self::$borderStyleMap[$index];
+ }
+
+ return StyleBorder::BORDER_NONE;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/CellAlignment.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/CellAlignment.php
new file mode 100644
index 00000000..6b89d27e
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/CellAlignment.php
@@ -0,0 +1,50 @@
+
+ */
+ protected static array $horizontalAlignmentMap = [
+ 0 => Alignment::HORIZONTAL_GENERAL,
+ 1 => Alignment::HORIZONTAL_LEFT,
+ 2 => Alignment::HORIZONTAL_CENTER,
+ 3 => Alignment::HORIZONTAL_RIGHT,
+ 4 => Alignment::HORIZONTAL_FILL,
+ 5 => Alignment::HORIZONTAL_JUSTIFY,
+ 6 => Alignment::HORIZONTAL_CENTER_CONTINUOUS,
+ ];
+
+ /**
+ * @var array
+ */
+ protected static array $verticalAlignmentMap = [
+ 0 => Alignment::VERTICAL_TOP,
+ 1 => Alignment::VERTICAL_CENTER,
+ 2 => Alignment::VERTICAL_BOTTOM,
+ 3 => Alignment::VERTICAL_JUSTIFY,
+ ];
+
+ public static function horizontal(Alignment $alignment, int $horizontal): void
+ {
+ if (array_key_exists($horizontal, self::$horizontalAlignmentMap)) {
+ $alignment->setHorizontal(self::$horizontalAlignmentMap[$horizontal]);
+ }
+ }
+
+ public static function vertical(Alignment $alignment, int $vertical): void
+ {
+ if (array_key_exists($vertical, self::$verticalAlignmentMap)) {
+ $alignment->setVertical(self::$verticalAlignmentMap[$vertical]);
+ }
+ }
+
+ public static function wrap(Alignment $alignment, int $wrap): void
+ {
+ $alignment->setWrapText((bool) $wrap);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/CellFont.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/CellFont.php
new file mode 100644
index 00000000..2c6d2f7f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/CellFont.php
@@ -0,0 +1,39 @@
+setSuperscript(true);
+
+ break;
+ case 0x0002:
+ $font->setSubscript(true);
+
+ break;
+ }
+ }
+
+ /**
+ * @var array
+ */
+ protected static array $underlineMap = [
+ 0x01 => Font::UNDERLINE_SINGLE,
+ 0x02 => Font::UNDERLINE_DOUBLE,
+ 0x21 => Font::UNDERLINE_SINGLEACCOUNTING,
+ 0x22 => Font::UNDERLINE_DOUBLEACCOUNTING,
+ ];
+
+ public static function underline(Font $font, int $underline): void
+ {
+ if (array_key_exists($underline, self::$underlineMap)) {
+ $font->setUnderline(self::$underlineMap[$underline]);
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/FillPattern.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/FillPattern.php
new file mode 100644
index 00000000..4e379509
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xls/Style/FillPattern.php
@@ -0,0 +1,46 @@
+
+ */
+ protected static array $fillPatternMap = [
+ 0x00 => Fill::FILL_NONE,
+ 0x01 => Fill::FILL_SOLID,
+ 0x02 => Fill::FILL_PATTERN_MEDIUMGRAY,
+ 0x03 => Fill::FILL_PATTERN_DARKGRAY,
+ 0x04 => Fill::FILL_PATTERN_LIGHTGRAY,
+ 0x05 => Fill::FILL_PATTERN_DARKHORIZONTAL,
+ 0x06 => Fill::FILL_PATTERN_DARKVERTICAL,
+ 0x07 => Fill::FILL_PATTERN_DARKDOWN,
+ 0x08 => Fill::FILL_PATTERN_DARKUP,
+ 0x09 => Fill::FILL_PATTERN_DARKGRID,
+ 0x0A => Fill::FILL_PATTERN_DARKTRELLIS,
+ 0x0B => Fill::FILL_PATTERN_LIGHTHORIZONTAL,
+ 0x0C => Fill::FILL_PATTERN_LIGHTVERTICAL,
+ 0x0D => Fill::FILL_PATTERN_LIGHTDOWN,
+ 0x0E => Fill::FILL_PATTERN_LIGHTUP,
+ 0x0F => Fill::FILL_PATTERN_LIGHTGRID,
+ 0x10 => Fill::FILL_PATTERN_LIGHTTRELLIS,
+ 0x11 => Fill::FILL_PATTERN_GRAY125,
+ 0x12 => Fill::FILL_PATTERN_GRAY0625,
+ ];
+
+ /**
+ * Get fill pattern from index
+ * OpenOffice documentation: 2.5.12.
+ */
+ public static function lookup(int $index): string
+ {
+ if (isset(self::$fillPatternMap[$index])) {
+ return self::$fillPatternMap[$index];
+ }
+
+ return Fill::FILL_NONE;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx.php
new file mode 100644
index 00000000..2b052d00
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx.php
@@ -0,0 +1,2368 @@
+referenceHelper = ReferenceHelper::getInstance();
+ $this->securityScanner = XmlScanner::getInstance($this);
+ }
+
+ /**
+ * Can the current IReader read the file?
+ */
+ public function canRead(string $filename): bool
+ {
+ if (!File::testFileNoThrow($filename, self::INITIAL_FILE)) {
+ return false;
+ }
+
+ $result = false;
+ $this->zip = $zip = new ZipArchive();
+
+ if ($zip->open($filename) === true) {
+ [$workbookBasename] = $this->getWorkbookBaseName();
+ $result = !empty($workbookBasename);
+
+ $zip->close();
+ }
+
+ return $result;
+ }
+
+ public static function testSimpleXml(mixed $value): SimpleXMLElement
+ {
+ return ($value instanceof SimpleXMLElement) ? $value : new SimpleXMLElement(' ');
+ }
+
+ public static function getAttributes(?SimpleXMLElement $value, string $ns = ''): SimpleXMLElement
+ {
+ return self::testSimpleXml($value === null ? $value : $value->attributes($ns));
+ }
+
+ // Phpstan thinks, correctly, that xpath can return false.
+ private static function xpathNoFalse(SimpleXMLElement $sxml, string $path): array
+ {
+ return self::falseToArray($sxml->xpath($path));
+ }
+
+ public static function falseToArray(mixed $value): array
+ {
+ return is_array($value) ? $value : [];
+ }
+
+ private function loadZip(string $filename, string $ns = '', bool $replaceUnclosedBr = false): SimpleXMLElement
+ {
+ $contents = $this->getFromZipArchive($this->zip, $filename);
+ if ($replaceUnclosedBr) {
+ $contents = str_replace(' ', ' ', $contents);
+ }
+ $rels = @simplexml_load_string(
+ $this->getSecurityScannerOrThrow()->scan($contents),
+ 'SimpleXMLElement',
+ 0,
+ $ns
+ );
+
+ return self::testSimpleXml($rels);
+ }
+
+ // This function is just to identify cases where I'm not sure
+ // why empty namespace is required.
+ private function loadZipNonamespace(string $filename, string $ns): SimpleXMLElement
+ {
+ $contents = $this->getFromZipArchive($this->zip, $filename);
+ $rels = simplexml_load_string(
+ $this->getSecurityScannerOrThrow()->scan($contents),
+ 'SimpleXMLElement',
+ 0,
+ ($ns === '' ? $ns : '')
+ );
+
+ return self::testSimpleXml($rels);
+ }
+
+ private const REL_TO_MAIN = [
+ Namespaces::PURL_OFFICE_DOCUMENT => Namespaces::PURL_MAIN,
+ Namespaces::THUMBNAIL => '',
+ ];
+
+ private const REL_TO_DRAWING = [
+ Namespaces::PURL_RELATIONSHIPS => Namespaces::PURL_DRAWING,
+ ];
+
+ private const REL_TO_CHART = [
+ Namespaces::PURL_RELATIONSHIPS => Namespaces::PURL_CHART,
+ ];
+
+ /**
+ * Reads names of the worksheets from a file, without parsing the whole file to a Spreadsheet object.
+ */
+ public function listWorksheetNames(string $filename): array
+ {
+ File::assertFile($filename, self::INITIAL_FILE);
+
+ $worksheetNames = [];
+
+ $this->zip = $zip = new ZipArchive();
+ $zip->open($filename);
+
+ // The files we're looking at here are small enough that simpleXML is more efficient than XMLReader
+ $rels = $this->loadZip(self::INITIAL_FILE, Namespaces::RELATIONSHIPS);
+ foreach ($rels->Relationship as $relx) {
+ $rel = self::getAttributes($relx);
+ $relType = (string) $rel['Type'];
+ $mainNS = self::REL_TO_MAIN[$relType] ?? Namespaces::MAIN;
+ if ($mainNS !== '') {
+ $xmlWorkbook = $this->loadZip((string) $rel['Target'], $mainNS);
+
+ if ($xmlWorkbook->sheets) {
+ foreach ($xmlWorkbook->sheets->sheet as $eleSheet) {
+ // Check if sheet should be skipped
+ $worksheetNames[] = (string) self::getAttributes($eleSheet)['name'];
+ }
+ }
+ }
+ }
+
+ $zip->close();
+
+ return $worksheetNames;
+ }
+
+ /**
+ * Return worksheet info (Name, Last Column Letter, Last Column Index, Total Rows, Total Columns).
+ */
+ public function listWorksheetInfo(string $filename): array
+ {
+ File::assertFile($filename, self::INITIAL_FILE);
+
+ $worksheetInfo = [];
+
+ $this->zip = $zip = new ZipArchive();
+ $zip->open($filename);
+
+ $rels = $this->loadZip(self::INITIAL_FILE, Namespaces::RELATIONSHIPS);
+ foreach ($rels->Relationship as $relx) {
+ $rel = self::getAttributes($relx);
+ $relType = (string) $rel['Type'];
+ $mainNS = self::REL_TO_MAIN[$relType] ?? Namespaces::MAIN;
+ if ($mainNS !== '') {
+ $relTarget = (string) $rel['Target'];
+ $dir = dirname($relTarget);
+ $namespace = dirname($relType);
+ $relsWorkbook = $this->loadZip("$dir/_rels/" . basename($relTarget) . '.rels', Namespaces::RELATIONSHIPS);
+
+ $worksheets = [];
+ foreach ($relsWorkbook->Relationship as $elex) {
+ $ele = self::getAttributes($elex);
+ if (
+ ((string) $ele['Type'] === "$namespace/worksheet")
+ || ((string) $ele['Type'] === "$namespace/chartsheet")
+ ) {
+ $worksheets[(string) $ele['Id']] = $ele['Target'];
+ }
+ }
+
+ $xmlWorkbook = $this->loadZip($relTarget, $mainNS);
+ if ($xmlWorkbook->sheets) {
+ $dir = dirname($relTarget);
+
+ /** @var SimpleXMLElement $eleSheet */
+ foreach ($xmlWorkbook->sheets->sheet as $eleSheet) {
+ $tmpInfo = [
+ 'worksheetName' => (string) self::getAttributes($eleSheet)['name'],
+ 'lastColumnLetter' => 'A',
+ 'lastColumnIndex' => 0,
+ 'totalRows' => 0,
+ 'totalColumns' => 0,
+ ];
+
+ $fileWorksheet = (string) $worksheets[(string) self::getArrayItem(self::getAttributes($eleSheet, $namespace), 'id')];
+ $fileWorksheetPath = str_starts_with($fileWorksheet, '/') ? substr($fileWorksheet, 1) : "$dir/$fileWorksheet";
+
+ $xml = new XMLReader();
+ $xml->xml(
+ $this->getSecurityScannerOrThrow()
+ ->scan(
+ $this->getFromZipArchive(
+ $this->zip,
+ $fileWorksheetPath
+ )
+ )
+ );
+ $xml->setParserProperty(2, true);
+
+ $currCells = 0;
+ while ($xml->read()) {
+ if ($xml->localName == 'row' && $xml->nodeType == XMLReader::ELEMENT && $xml->namespaceURI === $mainNS) {
+ $row = $xml->getAttribute('r');
+ $tmpInfo['totalRows'] = $row;
+ $tmpInfo['totalColumns'] = max($tmpInfo['totalColumns'], $currCells);
+ $currCells = 0;
+ } elseif ($xml->localName == 'c' && $xml->nodeType == XMLReader::ELEMENT && $xml->namespaceURI === $mainNS) {
+ $cell = $xml->getAttribute('r');
+ $currCells = $cell ? max($currCells, Coordinate::indexesFromString($cell)[0]) : ($currCells + 1);
+ }
+ }
+ $tmpInfo['totalColumns'] = max($tmpInfo['totalColumns'], $currCells);
+ $xml->close();
+
+ $tmpInfo['lastColumnIndex'] = $tmpInfo['totalColumns'] - 1;
+ $tmpInfo['lastColumnLetter'] = Coordinate::stringFromColumnIndex($tmpInfo['lastColumnIndex'] + 1);
+
+ $worksheetInfo[] = $tmpInfo;
+ }
+ }
+ }
+ }
+
+ $zip->close();
+
+ return $worksheetInfo;
+ }
+
+ private static function castToBoolean(SimpleXMLElement $c): bool
+ {
+ $value = isset($c->v) ? (string) $c->v : null;
+ if ($value == '0') {
+ return false;
+ } elseif ($value == '1') {
+ return true;
+ }
+
+ return (bool) $c->v;
+ }
+
+ private static function castToError(?SimpleXMLElement $c): ?string
+ {
+ return isset($c, $c->v) ? (string) $c->v : null;
+ }
+
+ private static function castToString(?SimpleXMLElement $c): ?string
+ {
+ return isset($c, $c->v) ? (string) $c->v : null;
+ }
+
+ private function castToFormula(?SimpleXMLElement $c, string $r, string &$cellDataType, mixed &$value, mixed &$calculatedValue, string $castBaseType, bool $updateSharedCells = true): void
+ {
+ if ($c === null) {
+ return;
+ }
+ $attr = $c->f->attributes();
+ $cellDataType = DataType::TYPE_FORMULA;
+ $value = "={$c->f}";
+ $calculatedValue = self::$castBaseType($c);
+
+ // Shared formula?
+ if (isset($attr['t']) && strtolower((string) $attr['t']) == 'shared') {
+ $instance = (string) $attr['si'];
+
+ if (!isset($this->sharedFormulae[(string) $attr['si']])) {
+ $this->sharedFormulae[$instance] = new SharedFormula($r, $value);
+ } elseif ($updateSharedCells === true) {
+ // It's only worth the overhead of adjusting the shared formula for this cell if we're actually loading
+ // the cell, which may not be the case if we're using a read filter.
+ $master = Coordinate::indexesFromString($this->sharedFormulae[$instance]->master());
+ $current = Coordinate::indexesFromString($r);
+
+ $difference = [0, 0];
+ $difference[0] = $current[0] - $master[0];
+ $difference[1] = $current[1] - $master[1];
+
+ $value = $this->referenceHelper->updateFormulaReferences($this->sharedFormulae[$instance]->formula(), 'A1', $difference[0], $difference[1]);
+ }
+ }
+ }
+
+ private function fileExistsInArchive(ZipArchive $archive, string $fileName = ''): bool
+ {
+ // Root-relative paths
+ if (str_contains($fileName, '//')) {
+ $fileName = substr($fileName, strpos($fileName, '//') + 1);
+ }
+ $fileName = File::realpath($fileName);
+
+ // Sadly, some 3rd party xlsx generators don't use consistent case for filenaming
+ // so we need to load case-insensitively from the zip file
+
+ // Apache POI fixes
+ $contents = $archive->locateName($fileName, ZipArchive::FL_NOCASE);
+ if ($contents === false) {
+ $contents = $archive->locateName(substr($fileName, 1), ZipArchive::FL_NOCASE);
+ }
+
+ return $contents !== false;
+ }
+
+ private function getFromZipArchive(ZipArchive $archive, string $fileName = ''): string
+ {
+ // Root-relative paths
+ if (str_contains($fileName, '//')) {
+ $fileName = substr($fileName, strpos($fileName, '//') + 1);
+ }
+ // Relative paths generated by dirname($filename) when $filename
+ // has no path (i.e.files in root of the zip archive)
+ $fileName = (string) preg_replace('/^\.\//', '', $fileName);
+ $fileName = File::realpath($fileName);
+
+ // Sadly, some 3rd party xlsx generators don't use consistent case for filenaming
+ // so we need to load case-insensitively from the zip file
+
+ $contents = $archive->getFromName($fileName, 0, ZipArchive::FL_NOCASE);
+
+ // Apache POI fixes
+ if ($contents === false) {
+ $contents = $archive->getFromName(substr($fileName, 1), 0, ZipArchive::FL_NOCASE);
+ }
+
+ // Has the file been saved with Windoze directory separators rather than unix?
+ if ($contents === false) {
+ $contents = $archive->getFromName(str_replace('/', '\\', $fileName), 0, ZipArchive::FL_NOCASE);
+ }
+
+ return ($contents === false) ? '' : $contents;
+ }
+
+ /**
+ * Loads Spreadsheet from file.
+ */
+ protected function loadSpreadsheetFromFile(string $filename): Spreadsheet
+ {
+ File::assertFile($filename, self::INITIAL_FILE);
+
+ // Initialisations
+ $excel = new Spreadsheet();
+ $excel->removeSheetByIndex(0);
+ $addingFirstCellStyleXf = true;
+ $addingFirstCellXf = true;
+
+ $unparsedLoadedData = [];
+
+ $this->zip = $zip = new ZipArchive();
+ $zip->open($filename);
+
+ // Read the theme first, because we need the colour scheme when reading the styles
+ [$workbookBasename, $xmlNamespaceBase] = $this->getWorkbookBaseName();
+ $drawingNS = self::REL_TO_DRAWING[$xmlNamespaceBase] ?? Namespaces::DRAWINGML;
+ $chartNS = self::REL_TO_CHART[$xmlNamespaceBase] ?? Namespaces::CHART;
+ $wbRels = $this->loadZip("xl/_rels/{$workbookBasename}.rels", Namespaces::RELATIONSHIPS);
+ $theme = null;
+ $this->styleReader = new Styles();
+ foreach ($wbRels->Relationship as $relx) {
+ $rel = self::getAttributes($relx);
+ $relTarget = (string) $rel['Target'];
+ if (str_starts_with($relTarget, '/xl/')) {
+ $relTarget = substr($relTarget, 4);
+ }
+ switch ($rel['Type']) {
+ case "$xmlNamespaceBase/theme":
+ if (!$this->fileExistsInArchive($zip, "xl/{$relTarget}")) {
+ break; // issue3770
+ }
+ $themeOrderArray = ['lt1', 'dk1', 'lt2', 'dk2'];
+ $themeOrderAdditional = count($themeOrderArray);
+
+ $xmlTheme = $this->loadZip("xl/{$relTarget}", $drawingNS);
+ $xmlThemeName = self::getAttributes($xmlTheme);
+ $xmlTheme = $xmlTheme->children($drawingNS);
+ $themeName = (string) $xmlThemeName['name'];
+
+ $colourScheme = self::getAttributes($xmlTheme->themeElements->clrScheme);
+ $colourSchemeName = (string) $colourScheme['name'];
+ $excel->getTheme()->setThemeColorName($colourSchemeName);
+ $colourScheme = $xmlTheme->themeElements->clrScheme->children($drawingNS);
+
+ $themeColours = [];
+ foreach ($colourScheme as $k => $xmlColour) {
+ $themePos = array_search($k, $themeOrderArray);
+ if ($themePos === false) {
+ $themePos = $themeOrderAdditional++;
+ }
+ if (isset($xmlColour->sysClr)) {
+ $xmlColourData = self::getAttributes($xmlColour->sysClr);
+ $themeColours[$themePos] = (string) $xmlColourData['lastClr'];
+ $excel->getTheme()->setThemeColor($k, (string) $xmlColourData['lastClr']);
+ } elseif (isset($xmlColour->srgbClr)) {
+ $xmlColourData = self::getAttributes($xmlColour->srgbClr);
+ $themeColours[$themePos] = (string) $xmlColourData['val'];
+ $excel->getTheme()->setThemeColor($k, (string) $xmlColourData['val']);
+ }
+ }
+ $theme = new Theme($themeName, $colourSchemeName, $themeColours);
+ $this->styleReader->setTheme($theme);
+
+ $fontScheme = self::getAttributes($xmlTheme->themeElements->fontScheme);
+ $fontSchemeName = (string) $fontScheme['name'];
+ $excel->getTheme()->setThemeFontName($fontSchemeName);
+ $majorFonts = [];
+ $minorFonts = [];
+ $fontScheme = $xmlTheme->themeElements->fontScheme->children($drawingNS);
+ $majorLatin = self::getAttributes($fontScheme->majorFont->latin)['typeface'] ?? '';
+ $majorEastAsian = self::getAttributes($fontScheme->majorFont->ea)['typeface'] ?? '';
+ $majorComplexScript = self::getAttributes($fontScheme->majorFont->cs)['typeface'] ?? '';
+ $minorLatin = self::getAttributes($fontScheme->minorFont->latin)['typeface'] ?? '';
+ $minorEastAsian = self::getAttributes($fontScheme->minorFont->ea)['typeface'] ?? '';
+ $minorComplexScript = self::getAttributes($fontScheme->minorFont->cs)['typeface'] ?? '';
+
+ foreach ($fontScheme->majorFont->font as $xmlFont) {
+ $fontAttributes = self::getAttributes($xmlFont);
+ $script = (string) ($fontAttributes['script'] ?? '');
+ if (!empty($script)) {
+ $majorFonts[$script] = (string) ($fontAttributes['typeface'] ?? '');
+ }
+ }
+ foreach ($fontScheme->minorFont->font as $xmlFont) {
+ $fontAttributes = self::getAttributes($xmlFont);
+ $script = (string) ($fontAttributes['script'] ?? '');
+ if (!empty($script)) {
+ $minorFonts[$script] = (string) ($fontAttributes['typeface'] ?? '');
+ }
+ }
+ $excel->getTheme()->setMajorFontValues($majorLatin, $majorEastAsian, $majorComplexScript, $majorFonts);
+ $excel->getTheme()->setMinorFontValues($minorLatin, $minorEastAsian, $minorComplexScript, $minorFonts);
+
+ break;
+ }
+ }
+
+ $rels = $this->loadZip(self::INITIAL_FILE, Namespaces::RELATIONSHIPS);
+
+ $propertyReader = new PropertyReader($this->getSecurityScannerOrThrow(), $excel->getProperties());
+ $charts = $chartDetails = [];
+ foreach ($rels->Relationship as $relx) {
+ $rel = self::getAttributes($relx);
+ $relTarget = (string) $rel['Target'];
+ // issue 3553
+ if ($relTarget[0] === '/') {
+ $relTarget = substr($relTarget, 1);
+ }
+ $relType = (string) $rel['Type'];
+ $mainNS = self::REL_TO_MAIN[$relType] ?? Namespaces::MAIN;
+ switch ($relType) {
+ case Namespaces::CORE_PROPERTIES:
+ $propertyReader->readCoreProperties($this->getFromZipArchive($zip, $relTarget));
+
+ break;
+ case "$xmlNamespaceBase/extended-properties":
+ $propertyReader->readExtendedProperties($this->getFromZipArchive($zip, $relTarget));
+
+ break;
+ case "$xmlNamespaceBase/custom-properties":
+ $propertyReader->readCustomProperties($this->getFromZipArchive($zip, $relTarget));
+
+ break;
+ //Ribbon
+ case Namespaces::EXTENSIBILITY:
+ $customUI = $relTarget;
+ if ($customUI) {
+ $this->readRibbon($excel, $customUI, $zip);
+ }
+
+ break;
+ case "$xmlNamespaceBase/officeDocument":
+ $dir = dirname($relTarget);
+
+ // Do not specify namespace in next stmt - do it in Xpath
+ $relsWorkbook = $this->loadZip("$dir/_rels/" . basename($relTarget) . '.rels', Namespaces::RELATIONSHIPS);
+ $relsWorkbook->registerXPathNamespace('rel', Namespaces::RELATIONSHIPS);
+
+ $worksheets = [];
+ $macros = $customUI = null;
+ foreach ($relsWorkbook->Relationship as $elex) {
+ $ele = self::getAttributes($elex);
+ switch ($ele['Type']) {
+ case Namespaces::WORKSHEET:
+ case Namespaces::PURL_WORKSHEET:
+ $worksheets[(string) $ele['Id']] = $ele['Target'];
+
+ break;
+ case Namespaces::CHARTSHEET:
+ if ($this->includeCharts === true) {
+ $worksheets[(string) $ele['Id']] = $ele['Target'];
+ }
+
+ break;
+ // a vbaProject ? (: some macros)
+ case Namespaces::VBA:
+ $macros = $ele['Target'];
+
+ break;
+ }
+ }
+
+ if ($macros !== null) {
+ $macrosCode = $this->getFromZipArchive($zip, 'xl/vbaProject.bin'); //vbaProject.bin always in 'xl' dir and always named vbaProject.bin
+ if ($macrosCode !== false) {
+ $excel->setMacrosCode($macrosCode);
+ $excel->setHasMacros(true);
+ //short-circuit : not reading vbaProject.bin.rel to get Signature =>allways vbaProjectSignature.bin in 'xl' dir
+ $Certificate = $this->getFromZipArchive($zip, 'xl/vbaProjectSignature.bin');
+ if ($Certificate !== false) {
+ $excel->setMacrosCertificate($Certificate);
+ }
+ }
+ }
+
+ $relType = "rel:Relationship[@Type='"
+ . "$xmlNamespaceBase/styles"
+ . "']";
+ $xpath = self::getArrayItem(self::xpathNoFalse($relsWorkbook, $relType));
+
+ if ($xpath === null) {
+ $xmlStyles = self::testSimpleXml(null);
+ } else {
+ $stylesTarget = (string) $xpath['Target'];
+ $stylesTarget = str_starts_with($stylesTarget, '/') ? substr($stylesTarget, 1) : "$dir/$stylesTarget";
+ $xmlStyles = $this->loadZip($stylesTarget, $mainNS);
+ }
+
+ $palette = self::extractPalette($xmlStyles);
+ $this->styleReader->setWorkbookPalette($palette);
+ $fills = self::extractStyles($xmlStyles, 'fills', 'fill');
+ $fonts = self::extractStyles($xmlStyles, 'fonts', 'font');
+ $borders = self::extractStyles($xmlStyles, 'borders', 'border');
+ $xfTags = self::extractStyles($xmlStyles, 'cellXfs', 'xf');
+ $cellXfTags = self::extractStyles($xmlStyles, 'cellStyleXfs', 'xf');
+
+ $styles = [];
+ $cellStyles = [];
+ $numFmts = null;
+ if (/*$xmlStyles && */ $xmlStyles->numFmts[0]) {
+ $numFmts = $xmlStyles->numFmts[0];
+ }
+ if (isset($numFmts) && ($numFmts !== null)) {
+ $numFmts->registerXPathNamespace('sml', $mainNS);
+ }
+ $this->styleReader->setNamespace($mainNS);
+ if (!$this->readDataOnly/* && $xmlStyles*/) {
+ foreach ($xfTags as $xfTag) {
+ $xf = self::getAttributes($xfTag);
+ $numFmt = null;
+
+ if ($xf['numFmtId']) {
+ if (isset($numFmts)) {
+ $tmpNumFmt = self::getArrayItem($numFmts->xpath("sml:numFmt[@numFmtId=$xf[numFmtId]]"));
+
+ if (isset($tmpNumFmt['formatCode'])) {
+ $numFmt = (string) $tmpNumFmt['formatCode'];
+ }
+ }
+
+ // We shouldn't override any of the built-in MS Excel values (values below id 164)
+ // But there's a lot of naughty homebrew xlsx writers that do use "reserved" id values that aren't actually used
+ // So we make allowance for them rather than lose formatting masks
+ if (
+ $numFmt === null
+ && (int) $xf['numFmtId'] < 164
+ && NumberFormat::builtInFormatCode((int) $xf['numFmtId']) !== ''
+ ) {
+ $numFmt = NumberFormat::builtInFormatCode((int) $xf['numFmtId']);
+ }
+ }
+ $quotePrefix = (bool) (string) ($xf['quotePrefix'] ?? '');
+
+ $style = (object) [
+ 'numFmt' => $numFmt ?? NumberFormat::FORMAT_GENERAL,
+ 'font' => $fonts[(int) ($xf['fontId'])],
+ 'fill' => $fills[(int) ($xf['fillId'])],
+ 'border' => $borders[(int) ($xf['borderId'])],
+ 'alignment' => $xfTag->alignment,
+ 'protection' => $xfTag->protection,
+ 'quotePrefix' => $quotePrefix,
+ ];
+ $styles[] = $style;
+
+ // add style to cellXf collection
+ $objStyle = new Style();
+ $this->styleReader->readStyle($objStyle, $style);
+ if ($addingFirstCellXf) {
+ $excel->removeCellXfByIndex(0); // remove the default style
+ $addingFirstCellXf = false;
+ }
+ $excel->addCellXf($objStyle);
+ }
+
+ foreach ($cellXfTags as $xfTag) {
+ $xf = self::getAttributes($xfTag);
+ $numFmt = NumberFormat::FORMAT_GENERAL;
+ if ($numFmts && $xf['numFmtId']) {
+ $tmpNumFmt = self::getArrayItem($numFmts->xpath("sml:numFmt[@numFmtId=$xf[numFmtId]]"));
+ if (isset($tmpNumFmt['formatCode'])) {
+ $numFmt = (string) $tmpNumFmt['formatCode'];
+ } elseif ((int) $xf['numFmtId'] < 165) {
+ $numFmt = NumberFormat::builtInFormatCode((int) $xf['numFmtId']);
+ }
+ }
+
+ $quotePrefix = (bool) (string) ($xf['quotePrefix'] ?? '');
+
+ $cellStyle = (object) [
+ 'numFmt' => $numFmt,
+ 'font' => $fonts[(int) ($xf['fontId'])],
+ 'fill' => $fills[((int) $xf['fillId'])],
+ 'border' => $borders[(int) ($xf['borderId'])],
+ 'alignment' => $xfTag->alignment,
+ 'protection' => $xfTag->protection,
+ 'quotePrefix' => $quotePrefix,
+ ];
+ $cellStyles[] = $cellStyle;
+
+ // add style to cellStyleXf collection
+ $objStyle = new Style();
+ $this->styleReader->readStyle($objStyle, $cellStyle);
+ if ($addingFirstCellStyleXf) {
+ $excel->removeCellStyleXfByIndex(0); // remove the default style
+ $addingFirstCellStyleXf = false;
+ }
+ $excel->addCellStyleXf($objStyle);
+ }
+ }
+ $this->styleReader->setStyleXml($xmlStyles);
+ $this->styleReader->setNamespace($mainNS);
+ $this->styleReader->setStyleBaseData($theme, $styles, $cellStyles);
+ $dxfs = $this->styleReader->dxfs($this->readDataOnly);
+ $styles = $this->styleReader->styles();
+
+ // Read content after setting the styles
+ $sharedStrings = [];
+ $relType = "rel:Relationship[@Type='"
+ //. Namespaces::SHARED_STRINGS
+ . "$xmlNamespaceBase/sharedStrings"
+ . "']";
+ $xpath = self::getArrayItem($relsWorkbook->xpath($relType));
+
+ if ($xpath) {
+ $sharedStringsTarget = (string) $xpath['Target'];
+ $sharedStringsTarget = str_starts_with($sharedStringsTarget, '/') ? substr($sharedStringsTarget, 1) : "$dir/$sharedStringsTarget";
+ $xmlStrings = $this->loadZip($sharedStringsTarget, $mainNS);
+ if (isset($xmlStrings->si)) {
+ foreach ($xmlStrings->si as $val) {
+ if (isset($val->t)) {
+ $sharedStrings[] = StringHelper::controlCharacterOOXML2PHP((string) $val->t);
+ } elseif (isset($val->r)) {
+ $sharedStrings[] = $this->parseRichText($val);
+ } else {
+ $sharedStrings[] = '';
+ }
+ }
+ }
+ }
+
+ $xmlWorkbook = $this->loadZipNoNamespace($relTarget, $mainNS);
+ $xmlWorkbookNS = $this->loadZip($relTarget, $mainNS);
+
+ // Set base date
+ $excel->setExcelCalendar(Date::CALENDAR_WINDOWS_1900);
+ if ($xmlWorkbookNS->workbookPr) {
+ Date::setExcelCalendar(Date::CALENDAR_WINDOWS_1900);
+ $attrs1904 = self::getAttributes($xmlWorkbookNS->workbookPr);
+ if (isset($attrs1904['date1904'])) {
+ if (self::boolean((string) $attrs1904['date1904'])) {
+ Date::setExcelCalendar(Date::CALENDAR_MAC_1904);
+ $excel->setExcelCalendar(Date::CALENDAR_MAC_1904);
+ }
+ }
+ }
+
+ // Set protection
+ $this->readProtection($excel, $xmlWorkbook);
+
+ $sheetId = 0; // keep track of new sheet id in final workbook
+ $oldSheetId = -1; // keep track of old sheet id in final workbook
+ $countSkippedSheets = 0; // keep track of number of skipped sheets
+ $mapSheetId = []; // mapping of sheet ids from old to new
+
+ $charts = $chartDetails = [];
+
+ if ($xmlWorkbookNS->sheets) {
+ /** @var SimpleXMLElement $eleSheet */
+ foreach ($xmlWorkbookNS->sheets->sheet as $eleSheet) {
+ $eleSheetAttr = self::getAttributes($eleSheet);
+ ++$oldSheetId;
+
+ // Check if sheet should be skipped
+ if (is_array($this->loadSheetsOnly) && !in_array((string) $eleSheetAttr['name'], $this->loadSheetsOnly)) {
+ ++$countSkippedSheets;
+ $mapSheetId[$oldSheetId] = null;
+
+ continue;
+ }
+
+ $sheetReferenceId = (string) self::getArrayItem(self::getAttributes($eleSheet, $xmlNamespaceBase), 'id');
+ if (isset($worksheets[$sheetReferenceId]) === false) {
+ ++$countSkippedSheets;
+ $mapSheetId[$oldSheetId] = null;
+
+ continue;
+ }
+ // Map old sheet id in original workbook to new sheet id.
+ // They will differ if loadSheetsOnly() is being used
+ $mapSheetId[$oldSheetId] = $oldSheetId - $countSkippedSheets;
+
+ // Load sheet
+ $docSheet = $excel->createSheet();
+ // Use false for $updateFormulaCellReferences to prevent adjustment of worksheet
+ // references in formula cells... during the load, all formulae should be correct,
+ // and we're simply bringing the worksheet name in line with the formula, not the
+ // reverse
+ $docSheet->setTitle((string) $eleSheetAttr['name'], false, false);
+
+ $fileWorksheet = (string) $worksheets[$sheetReferenceId];
+ // issue 3665 adds test for /.
+ // This broke XlsxRootZipFilesTest,
+ // but Excel reports an error with that file.
+ // Testing dir for . avoids this problem.
+ // It might be better just to drop the test.
+ if ($fileWorksheet[0] == '/' && $dir !== '.') {
+ $fileWorksheet = substr($fileWorksheet, strlen($dir) + 2);
+ }
+ $xmlSheet = $this->loadZipNoNamespace("$dir/$fileWorksheet", $mainNS);
+ $xmlSheetNS = $this->loadZip("$dir/$fileWorksheet", $mainNS);
+
+ // Shared Formula table is unique to each Worksheet, so we need to reset it here
+ $this->sharedFormulae = [];
+
+ if (isset($eleSheetAttr['state']) && (string) $eleSheetAttr['state'] != '') {
+ $docSheet->setSheetState((string) $eleSheetAttr['state']);
+ }
+ if ($xmlSheetNS) {
+ $xmlSheetMain = $xmlSheetNS->children($mainNS);
+ // Setting Conditional Styles adjusts selected cells, so we need to execute this
+ // before reading the sheet view data to get the actual selected cells
+ if (!$this->readDataOnly && ($xmlSheet->conditionalFormatting)) {
+ (new ConditionalStyles($docSheet, $xmlSheet, $dxfs, $this->styleReader))->load();
+ }
+ if (!$this->readDataOnly && $xmlSheet->extLst) {
+ (new ConditionalStyles($docSheet, $xmlSheet, $dxfs, $this->styleReader))->loadFromExt();
+ }
+ if (isset($xmlSheetMain->sheetViews, $xmlSheetMain->sheetViews->sheetView)) {
+ $sheetViews = new SheetViews($xmlSheetMain->sheetViews->sheetView, $docSheet);
+ $sheetViews->load();
+ }
+
+ $sheetViewOptions = new SheetViewOptions($docSheet, $xmlSheetNS);
+ $sheetViewOptions->load($this->readDataOnly, $this->styleReader);
+
+ (new ColumnAndRowAttributes($docSheet, $xmlSheetNS))
+ ->load($this->getReadFilter(), $this->readDataOnly, $this->ignoreRowsWithNoCells);
+ }
+
+ $holdSelectedCells = $docSheet->getSelectedCells();
+ if ($xmlSheetNS && $xmlSheetNS->sheetData && $xmlSheetNS->sheetData->row) {
+ $cIndex = 1; // Cell Start from 1
+ foreach ($xmlSheetNS->sheetData->row as $row) {
+ $rowIndex = 1;
+ foreach ($row->c as $c) {
+ $cAttr = self::getAttributes($c);
+ $r = (string) $cAttr['r'];
+ if ($r == '') {
+ $r = Coordinate::stringFromColumnIndex($rowIndex) . $cIndex;
+ }
+ $cellDataType = (string) $cAttr['t'];
+ $originalCellDataTypeNumeric = $cellDataType === '';
+ $value = null;
+ $calculatedValue = null;
+
+ // Read cell?
+ if ($this->getReadFilter() !== null) {
+ $coordinates = Coordinate::coordinateFromString($r);
+
+ if (!$this->getReadFilter()->readCell($coordinates[0], (int) $coordinates[1], $docSheet->getTitle())) {
+ // Normally, just testing for the f attribute should identify this cell as containing a formula
+ // that we need to read, even though it is outside of the filter range, in case it is a shared formula.
+ // But in some cases, this attribute isn't set; so we need to delve a level deeper and look at
+ // whether or not the cell has a child formula element that is shared.
+ if (isset($cAttr->f) || (isset($c->f, $c->f->attributes()['t']) && strtolower((string) $c->f->attributes()['t']) === 'shared')) {
+ $this->castToFormula($c, $r, $cellDataType, $value, $calculatedValue, 'castToError', false);
+ }
+ ++$rowIndex;
+
+ continue;
+ }
+ }
+
+ // Read cell!
+ switch ($cellDataType) {
+ case 's':
+ if ((string) $c->v != '') {
+ $value = $sharedStrings[(int) ($c->v)];
+
+ if ($value instanceof RichText) {
+ $value = clone $value;
+ }
+ } else {
+ $value = '';
+ }
+
+ break;
+ case 'b':
+ if (!isset($c->f)) {
+ if (isset($c->v)) {
+ $value = self::castToBoolean($c);
+ } else {
+ $value = null;
+ $cellDataType = DataType::TYPE_NULL;
+ }
+ } else {
+ // Formula
+ $this->castToFormula($c, $r, $cellDataType, $value, $calculatedValue, 'castToBoolean');
+ if (isset($c->f['t'])) {
+ $att = $c->f;
+ $docSheet->getCell($r)->setFormulaAttributes($att);
+ }
+ }
+
+ break;
+ case 'inlineStr':
+ if (isset($c->f)) {
+ $this->castToFormula($c, $r, $cellDataType, $value, $calculatedValue, 'castToError');
+ } else {
+ $value = $this->parseRichText($c->is);
+ }
+
+ break;
+ case 'e':
+ if (!isset($c->f)) {
+ $value = self::castToError($c);
+ } else {
+ // Formula
+ $this->castToFormula($c, $r, $cellDataType, $value, $calculatedValue, 'castToError');
+ }
+
+ break;
+ default:
+ if (!isset($c->f)) {
+ $value = self::castToString($c);
+ } else {
+ // Formula
+ $this->castToFormula($c, $r, $cellDataType, $value, $calculatedValue, 'castToString');
+ if (isset($c->f['t'])) {
+ $attributes = $c->f['t'];
+ $docSheet->getCell($r)->setFormulaAttributes(['t' => (string) $attributes]);
+ }
+ }
+
+ break;
+ }
+
+ // read empty cells or the cells are not empty
+ if ($this->readEmptyCells || ($value !== null && $value !== '')) {
+ // Rich text?
+ if ($value instanceof RichText && $this->readDataOnly) {
+ $value = $value->getPlainText();
+ }
+
+ $cell = $docSheet->getCell($r);
+ // Assign value
+ if ($cellDataType != '') {
+ // it is possible, that datatype is numeric but with an empty string, which result in an error
+ if ($cellDataType === DataType::TYPE_NUMERIC && ($value === '' || $value === null)) {
+ $cellDataType = DataType::TYPE_NULL;
+ }
+ if ($cellDataType !== DataType::TYPE_NULL) {
+ $cell->setValueExplicit($value, $cellDataType);
+ }
+ } else {
+ $cell->setValue($value);
+ }
+ if ($calculatedValue !== null) {
+ $cell->setCalculatedValue($calculatedValue, $originalCellDataTypeNumeric);
+ }
+
+ // Style information?
+ if (!$this->readDataOnly) {
+ $cAttrS = (int) ($cAttr['s'] ?? 0);
+ // no style index means 0, it seems
+ $cAttrS = isset($styles[$cAttrS]) ? $cAttrS : 0;
+ $cell->setXfIndex($cAttrS);
+ // issue 3495
+ if ($cellDataType === DataType::TYPE_FORMULA && $styles[$cAttrS]->quotePrefix === true) {
+ $holdSelected = $docSheet->getSelectedCells();
+ $cell->getStyle()->setQuotePrefix(false);
+ $docSheet->setSelectedCells($holdSelected);
+ }
+ }
+ }
+ ++$rowIndex;
+ }
+ ++$cIndex;
+ }
+ }
+ $docSheet->setSelectedCells($holdSelectedCells);
+ if ($xmlSheetNS && $xmlSheetNS->ignoredErrors) {
+ foreach ($xmlSheetNS->ignoredErrors->ignoredError as $ignoredErrorx) {
+ $ignoredError = self::testSimpleXml($ignoredErrorx);
+ $this->processIgnoredErrors($ignoredError, $docSheet);
+ }
+ }
+
+ if (!$this->readDataOnly && $xmlSheetNS && $xmlSheetNS->sheetProtection) {
+ $protAttr = $xmlSheetNS->sheetProtection->attributes() ?? [];
+ foreach ($protAttr as $key => $value) {
+ $method = 'set' . ucfirst($key);
+ $docSheet->getProtection()->$method(self::boolean((string) $value));
+ }
+ }
+
+ if ($xmlSheet) {
+ $this->readSheetProtection($docSheet, $xmlSheet);
+ }
+
+ if ($this->readDataOnly === false) {
+ $this->readAutoFilter($xmlSheetNS, $docSheet);
+ $this->readBackgroundImage($xmlSheetNS, $docSheet, dirname("$dir/$fileWorksheet") . '/_rels/' . basename($fileWorksheet) . '.rels');
+ }
+
+ $this->readTables($xmlSheetNS, $docSheet, $dir, $fileWorksheet, $zip, $mainNS);
+
+ if ($xmlSheetNS && $xmlSheetNS->mergeCells && $xmlSheetNS->mergeCells->mergeCell && !$this->readDataOnly) {
+ foreach ($xmlSheetNS->mergeCells->mergeCell as $mergeCellx) {
+ $mergeCell = $mergeCellx->attributes();
+ $mergeRef = (string) ($mergeCell['ref'] ?? '');
+ if (str_contains($mergeRef, ':')) {
+ $docSheet->mergeCells($mergeRef, Worksheet::MERGE_CELL_CONTENT_HIDE);
+ }
+ }
+ }
+
+ if ($xmlSheet && !$this->readDataOnly) {
+ $unparsedLoadedData = (new PageSetup($docSheet, $xmlSheet))->load($unparsedLoadedData);
+ }
+
+ if ($xmlSheet !== false && isset($xmlSheet->extLst->ext)) {
+ foreach ($xmlSheet->extLst->ext as $extlst) {
+ $extAttrs = $extlst->attributes() ?? [];
+ $extUri = (string) ($extAttrs['uri'] ?? '');
+ if ($extUri !== '{CCE6A557-97BC-4b89-ADB6-D9C93CAAB3DF}') {
+ continue;
+ }
+ // Create dataValidations node if does not exists, maybe is better inside the foreach ?
+ if (!$xmlSheet->dataValidations) {
+ $xmlSheet->addChild('dataValidations');
+ }
+
+ foreach ($extlst->children(Namespaces::DATA_VALIDATIONS1)->dataValidations->dataValidation as $item) {
+ $item = self::testSimpleXml($item);
+ $node = self::testSimpleXml($xmlSheet->dataValidations)->addChild('dataValidation');
+ foreach ($item->attributes() ?? [] as $attr) {
+ $node->addAttribute($attr->getName(), $attr);
+ }
+ $node->addAttribute('sqref', $item->children(Namespaces::DATA_VALIDATIONS2)->sqref);
+ if (isset($item->formula1)) {
+ $childNode = $node->addChild('formula1');
+ if ($childNode !== null) { // null should never happen
+ // see https://github.com/phpstan/phpstan/issues/8236
+ $childNode[0] = (string) $item->formula1->children(Namespaces::DATA_VALIDATIONS2)->f; // @phpstan-ignore-line
+ }
+ }
+ }
+ }
+ }
+
+ if ($xmlSheet && $xmlSheet->dataValidations && !$this->readDataOnly) {
+ (new DataValidations($docSheet, $xmlSheet))->load();
+ }
+
+ // unparsed sheet AlternateContent
+ if ($xmlSheet && !$this->readDataOnly) {
+ $mc = $xmlSheet->children(Namespaces::COMPATIBILITY);
+ if ($mc->AlternateContent) {
+ foreach ($mc->AlternateContent as $alternateContent) {
+ $alternateContent = self::testSimpleXml($alternateContent);
+ $unparsedLoadedData['sheets'][$docSheet->getCodeName()]['AlternateContents'][] = $alternateContent->asXML();
+ }
+ }
+ }
+
+ // Add hyperlinks
+ if (!$this->readDataOnly) {
+ $hyperlinkReader = new Hyperlinks($docSheet);
+ // Locate hyperlink relations
+ $relationsFileName = dirname("$dir/$fileWorksheet") . '/_rels/' . basename($fileWorksheet) . '.rels';
+ if ($zip->locateName($relationsFileName) !== false) {
+ $relsWorksheet = $this->loadZip($relationsFileName, Namespaces::RELATIONSHIPS);
+ $hyperlinkReader->readHyperlinks($relsWorksheet);
+ }
+
+ // Loop through hyperlinks
+ if ($xmlSheetNS && $xmlSheetNS->children($mainNS)->hyperlinks) {
+ $hyperlinkReader->setHyperlinks($xmlSheetNS->children($mainNS)->hyperlinks);
+ }
+ }
+
+ // Add comments
+ $comments = [];
+ $vmlComments = [];
+ if (!$this->readDataOnly) {
+ // Locate comment relations
+ $commentRelations = dirname("$dir/$fileWorksheet") . '/_rels/' . basename($fileWorksheet) . '.rels';
+ if ($zip->locateName($commentRelations) !== false) {
+ $relsWorksheet = $this->loadZip($commentRelations, Namespaces::RELATIONSHIPS);
+ foreach ($relsWorksheet->Relationship as $elex) {
+ $ele = self::getAttributes($elex);
+ if ($ele['Type'] == Namespaces::COMMENTS) {
+ $comments[(string) $ele['Id']] = (string) $ele['Target'];
+ }
+ if ($ele['Type'] == Namespaces::VML) {
+ $vmlComments[(string) $ele['Id']] = (string) $ele['Target'];
+ }
+ }
+ }
+
+ // Loop through comments
+ foreach ($comments as $relName => $relPath) {
+ // Load comments file
+ $relPath = File::realpath(dirname("$dir/$fileWorksheet") . '/' . $relPath);
+ // okay to ignore namespace - using xpath
+ $commentsFile = $this->loadZip($relPath, '');
+
+ // Utility variables
+ $authors = [];
+ $commentsFile->registerXpathNamespace('com', $mainNS);
+ $authorPath = self::xpathNoFalse($commentsFile, 'com:authors/com:author');
+ foreach ($authorPath as $author) {
+ $authors[] = (string) $author;
+ }
+
+ // Loop through contents
+ $contentPath = self::xpathNoFalse($commentsFile, 'com:commentList/com:comment');
+ foreach ($contentPath as $comment) {
+ $commentx = $comment->attributes();
+ $commentModel = $docSheet->getComment((string) $commentx['ref']);
+ if (isset($commentx['authorId'])) {
+ $commentModel->setAuthor($authors[(int) $commentx['authorId']]);
+ }
+ $commentModel->setText($this->parseRichText($comment->children($mainNS)->text));
+ }
+ }
+
+ // later we will remove from it real vmlComments
+ $unparsedVmlDrawings = $vmlComments;
+ $vmlDrawingContents = [];
+
+ // Loop through VML comments
+ foreach ($vmlComments as $relName => $relPath) {
+ // Load VML comments file
+ $relPath = File::realpath(dirname("$dir/$fileWorksheet") . '/' . $relPath);
+
+ try {
+ // no namespace okay - processed with Xpath
+ $vmlCommentsFile = $this->loadZip($relPath, '', true);
+ $vmlCommentsFile->registerXPathNamespace('v', Namespaces::URN_VML);
+ } catch (Throwable) {
+ //Ignore unparsable vmlDrawings. Later they will be moved from $unparsedVmlDrawings to $unparsedLoadedData
+ continue;
+ }
+
+ // Locate VML drawings image relations
+ $drowingImages = [];
+ $VMLDrawingsRelations = dirname($relPath) . '/_rels/' . basename($relPath) . '.rels';
+ $vmlDrawingContents[$relName] = $this->getSecurityScannerOrThrow()->scan($this->getFromZipArchive($zip, $relPath));
+ if ($zip->locateName($VMLDrawingsRelations) !== false) {
+ $relsVMLDrawing = $this->loadZip($VMLDrawingsRelations, Namespaces::RELATIONSHIPS);
+ foreach ($relsVMLDrawing->Relationship as $elex) {
+ $ele = self::getAttributes($elex);
+ if ($ele['Type'] == Namespaces::IMAGE) {
+ $drowingImages[(string) $ele['Id']] = (string) $ele['Target'];
+ }
+ }
+ }
+
+ $shapes = self::xpathNoFalse($vmlCommentsFile, '//v:shape');
+ foreach ($shapes as $shape) {
+ $shape->registerXPathNamespace('v', Namespaces::URN_VML);
+
+ if (isset($shape['style'])) {
+ $style = (string) $shape['style'];
+ $fillColor = strtoupper(substr((string) $shape['fillcolor'], 1));
+ $column = null;
+ $row = null;
+ $textHAlign = null;
+ $fillImageRelId = null;
+ $fillImageTitle = '';
+
+ $clientData = $shape->xpath('.//x:ClientData');
+ $textboxDirection = '';
+ $textboxPath = $shape->xpath('.//v:textbox');
+ $textbox = (string) ($textboxPath[0]['style'] ?? '');
+ if (preg_match('/rtl/i', $textbox) === 1) {
+ $textboxDirection = Comment::TEXTBOX_DIRECTION_RTL;
+ } elseif (preg_match('/ltr/i', $textbox) === 1) {
+ $textboxDirection = Comment::TEXTBOX_DIRECTION_LTR;
+ }
+ if (is_array($clientData) && !empty($clientData)) {
+ $clientData = $clientData[0];
+
+ if (isset($clientData['ObjectType']) && (string) $clientData['ObjectType'] == 'Note') {
+ $temp = $clientData->xpath('.//x:Row');
+ if (is_array($temp)) {
+ $row = $temp[0];
+ }
+
+ $temp = $clientData->xpath('.//x:Column');
+ if (is_array($temp)) {
+ $column = $temp[0];
+ }
+ $temp = $clientData->xpath('.//x:TextHAlign');
+ if (!empty($temp)) {
+ $textHAlign = strtolower($temp[0]);
+ }
+ }
+ }
+ $rowx = (string) $row;
+ $colx = (string) $column;
+ if (is_numeric($rowx) && is_numeric($colx) && $textHAlign !== null) {
+ $docSheet->getComment([1 + (int) $colx, 1 + (int) $rowx], false)->setAlignment((string) $textHAlign);
+ }
+ if (is_numeric($rowx) && is_numeric($colx) && $textboxDirection !== '') {
+ $docSheet->getComment([1 + (int) $colx, 1 + (int) $rowx], false)->setTextboxDirection($textboxDirection);
+ }
+
+ $fillImageRelNode = $shape->xpath('.//v:fill/@o:relid');
+ if (is_array($fillImageRelNode) && !empty($fillImageRelNode)) {
+ $fillImageRelNode = $fillImageRelNode[0];
+
+ if (isset($fillImageRelNode['relid'])) {
+ $fillImageRelId = (string) $fillImageRelNode['relid'];
+ }
+ }
+
+ $fillImageTitleNode = $shape->xpath('.//v:fill/@o:title');
+ if (is_array($fillImageTitleNode) && !empty($fillImageTitleNode)) {
+ $fillImageTitleNode = $fillImageTitleNode[0];
+
+ if (isset($fillImageTitleNode['title'])) {
+ $fillImageTitle = (string) $fillImageTitleNode['title'];
+ }
+ }
+
+ if (($column !== null) && ($row !== null)) {
+ // Set comment properties
+ $comment = $docSheet->getComment([$column + 1, $row + 1]);
+ $comment->getFillColor()->setRGB($fillColor);
+ if (isset($drowingImages[$fillImageRelId])) {
+ $objDrawing = new \PhpOffice\PhpSpreadsheet\Worksheet\Drawing();
+ $objDrawing->setName($fillImageTitle);
+ $imagePath = str_replace(['../', '/xl/'], 'xl/', $drowingImages[$fillImageRelId]);
+ $objDrawing->setPath(
+ 'zip://' . File::realpath($filename) . '#' . $imagePath,
+ true,
+ $zip
+ );
+ $comment->setBackgroundImage($objDrawing);
+ }
+
+ // Parse style
+ $styleArray = explode(';', str_replace(' ', '', $style));
+ foreach ($styleArray as $stylePair) {
+ $stylePair = explode(':', $stylePair);
+
+ if ($stylePair[0] == 'margin-left') {
+ $comment->setMarginLeft($stylePair[1]);
+ }
+ if ($stylePair[0] == 'margin-top') {
+ $comment->setMarginTop($stylePair[1]);
+ }
+ if ($stylePair[0] == 'width') {
+ $comment->setWidth($stylePair[1]);
+ }
+ if ($stylePair[0] == 'height') {
+ $comment->setHeight($stylePair[1]);
+ }
+ if ($stylePair[0] == 'visibility') {
+ $comment->setVisible($stylePair[1] == 'visible');
+ }
+ }
+
+ unset($unparsedVmlDrawings[$relName]);
+ }
+ }
+ }
+ }
+
+ // unparsed vmlDrawing
+ if ($unparsedVmlDrawings) {
+ foreach ($unparsedVmlDrawings as $rId => $relPath) {
+ $rId = substr($rId, 3); // rIdXXX
+ $unparsedVmlDrawing = &$unparsedLoadedData['sheets'][$docSheet->getCodeName()]['vmlDrawings'];
+ $unparsedVmlDrawing[$rId] = [];
+ $unparsedVmlDrawing[$rId]['filePath'] = self::dirAdd("$dir/$fileWorksheet", $relPath);
+ $unparsedVmlDrawing[$rId]['relFilePath'] = $relPath;
+ $unparsedVmlDrawing[$rId]['content'] = $this->getSecurityScannerOrThrow()->scan($this->getFromZipArchive($zip, $unparsedVmlDrawing[$rId]['filePath']));
+ unset($unparsedVmlDrawing);
+ }
+ }
+
+ // Header/footer images
+ if ($xmlSheetNS && $xmlSheetNS->legacyDrawingHF) {
+ $vmlHfRid = '';
+ $vmlHfRidAttr = $xmlSheetNS->legacyDrawingHF->attributes(Namespaces::SCHEMA_OFFICE_DOCUMENT);
+ if ($vmlHfRidAttr !== null && isset($vmlHfRidAttr['id'])) {
+ $vmlHfRid = (string) $vmlHfRidAttr['id'][0];
+ }
+ if ($zip->locateName(dirname("$dir/$fileWorksheet") . '/_rels/' . basename($fileWorksheet) . '.rels') !== false) {
+ $relsWorksheet = $this->loadZipNoNamespace(dirname("$dir/$fileWorksheet") . '/_rels/' . basename($fileWorksheet) . '.rels', Namespaces::RELATIONSHIPS);
+ $vmlRelationship = '';
+
+ foreach ($relsWorksheet->Relationship as $ele) {
+ if ((string) $ele['Type'] == Namespaces::VML && (string) $ele['Id'] === $vmlHfRid) {
+ $vmlRelationship = self::dirAdd("$dir/$fileWorksheet", $ele['Target']);
+
+ break;
+ }
+ }
+
+ if ($vmlRelationship != '') {
+ // Fetch linked images
+ $relsVML = $this->loadZipNoNamespace(dirname($vmlRelationship) . '/_rels/' . basename($vmlRelationship) . '.rels', Namespaces::RELATIONSHIPS);
+ $drawings = [];
+ if (isset($relsVML->Relationship)) {
+ foreach ($relsVML->Relationship as $ele) {
+ if ($ele['Type'] == Namespaces::IMAGE) {
+ $drawings[(string) $ele['Id']] = self::dirAdd($vmlRelationship, $ele['Target']);
+ }
+ }
+ }
+ // Fetch VML document
+ $vmlDrawing = $this->loadZipNoNamespace($vmlRelationship, '');
+ $vmlDrawing->registerXPathNamespace('v', Namespaces::URN_VML);
+
+ $hfImages = [];
+
+ $shapes = self::xpathNoFalse($vmlDrawing, '//v:shape');
+ foreach ($shapes as $idx => $shape) {
+ $shape->registerXPathNamespace('v', Namespaces::URN_VML);
+ $imageData = $shape->xpath('//v:imagedata');
+
+ if (empty($imageData)) {
+ continue;
+ }
+
+ $imageData = $imageData[$idx];
+
+ $imageData = self::getAttributes($imageData, Namespaces::URN_MSOFFICE);
+ $style = self::toCSSArray((string) $shape['style']);
+
+ if (array_key_exists((string) $imageData['relid'], $drawings)) {
+ $shapeId = (string) $shape['id'];
+ $hfImages[$shapeId] = new HeaderFooterDrawing();
+ if (isset($imageData['title'])) {
+ $hfImages[$shapeId]->setName((string) $imageData['title']);
+ }
+
+ $hfImages[$shapeId]->setPath('zip://' . File::realpath($filename) . '#' . $drawings[(string) $imageData['relid']], false, $zip);
+ $hfImages[$shapeId]->setResizeProportional(false);
+ $hfImages[$shapeId]->setWidth($style['width']);
+ $hfImages[$shapeId]->setHeight($style['height']);
+ if (isset($style['margin-left'])) {
+ $hfImages[$shapeId]->setOffsetX($style['margin-left']);
+ }
+ $hfImages[$shapeId]->setOffsetY($style['margin-top']);
+ $hfImages[$shapeId]->setResizeProportional(true);
+ }
+ }
+
+ $docSheet->getHeaderFooter()->setImages($hfImages);
+ }
+ }
+ }
+ }
+
+ // TODO: Autoshapes from twoCellAnchors!
+ $drawingFilename = dirname("$dir/$fileWorksheet")
+ . '/_rels/'
+ . basename($fileWorksheet)
+ . '.rels';
+ if (str_starts_with($drawingFilename, 'xl//xl/')) {
+ $drawingFilename = substr($drawingFilename, 4);
+ }
+ if (str_starts_with($drawingFilename, '/xl//xl/')) {
+ $drawingFilename = substr($drawingFilename, 5);
+ }
+ if ($zip->locateName($drawingFilename) !== false) {
+ $relsWorksheet = $this->loadZip($drawingFilename, Namespaces::RELATIONSHIPS);
+ $drawings = [];
+ foreach ($relsWorksheet->Relationship as $elex) {
+ $ele = self::getAttributes($elex);
+ if ((string) $ele['Type'] === "$xmlNamespaceBase/drawing") {
+ $eleTarget = (string) $ele['Target'];
+ if (str_starts_with($eleTarget, '/xl/')) {
+ $drawings[(string) $ele['Id']] = substr($eleTarget, 1);
+ } else {
+ $drawings[(string) $ele['Id']] = self::dirAdd("$dir/$fileWorksheet", $ele['Target']);
+ }
+ }
+ }
+
+ if ($xmlSheetNS->drawing && !$this->readDataOnly) {
+ $unparsedDrawings = [];
+ $fileDrawing = null;
+ foreach ($xmlSheetNS->drawing as $drawing) {
+ $drawingRelId = (string) self::getArrayItem(self::getAttributes($drawing, $xmlNamespaceBase), 'id');
+ $fileDrawing = $drawings[$drawingRelId];
+ $drawingFilename = dirname($fileDrawing) . '/_rels/' . basename($fileDrawing) . '.rels';
+ $relsDrawing = $this->loadZip($drawingFilename, Namespaces::RELATIONSHIPS);
+
+ $images = [];
+ $hyperlinks = [];
+ if ($relsDrawing && $relsDrawing->Relationship) {
+ foreach ($relsDrawing->Relationship as $elex) {
+ $ele = self::getAttributes($elex);
+ $eleType = (string) $ele['Type'];
+ if ($eleType === Namespaces::HYPERLINK) {
+ $hyperlinks[(string) $ele['Id']] = (string) $ele['Target'];
+ }
+ if ($eleType === "$xmlNamespaceBase/image") {
+ $eleTarget = (string) $ele['Target'];
+ if (str_starts_with($eleTarget, '/xl/')) {
+ $eleTarget = substr($eleTarget, 1);
+ $images[(string) $ele['Id']] = $eleTarget;
+ } else {
+ $images[(string) $ele['Id']] = self::dirAdd($fileDrawing, $eleTarget);
+ }
+ } elseif ($eleType === "$xmlNamespaceBase/chart") {
+ if ($this->includeCharts) {
+ $eleTarget = (string) $ele['Target'];
+ if (str_starts_with($eleTarget, '/xl/')) {
+ $index = substr($eleTarget, 1);
+ } else {
+ $index = self::dirAdd($fileDrawing, $eleTarget);
+ }
+ $charts[$index] = [
+ 'id' => (string) $ele['Id'],
+ 'sheet' => $docSheet->getTitle(),
+ ];
+ }
+ }
+ }
+ }
+
+ $xmlDrawing = $this->loadZipNoNamespace($fileDrawing, '');
+ $xmlDrawingChildren = $xmlDrawing->children(Namespaces::SPREADSHEET_DRAWING);
+
+ if ($xmlDrawingChildren->oneCellAnchor) {
+ foreach ($xmlDrawingChildren->oneCellAnchor as $oneCellAnchor) {
+ $oneCellAnchor = self::testSimpleXml($oneCellAnchor);
+ if ($oneCellAnchor->pic->blipFill) {
+ /** @var SimpleXMLElement $blip */
+ $blip = $oneCellAnchor->pic->blipFill->children(Namespaces::DRAWINGML)->blip;
+ /** @var SimpleXMLElement $xfrm */
+ $xfrm = $oneCellAnchor->pic->spPr->children(Namespaces::DRAWINGML)->xfrm;
+ /** @var SimpleXMLElement $outerShdw */
+ $outerShdw = $oneCellAnchor->pic->spPr->children(Namespaces::DRAWINGML)->effectLst->outerShdw;
+
+ $objDrawing = new \PhpOffice\PhpSpreadsheet\Worksheet\Drawing();
+ $objDrawing->setName((string) self::getArrayItem(self::getAttributes($oneCellAnchor->pic->nvPicPr->cNvPr), 'name'));
+ $objDrawing->setDescription((string) self::getArrayItem(self::getAttributes($oneCellAnchor->pic->nvPicPr->cNvPr), 'descr'));
+ $embedImageKey = (string) self::getArrayItem(
+ self::getAttributes($blip, $xmlNamespaceBase),
+ 'embed'
+ );
+ if (isset($images[$embedImageKey])) {
+ $objDrawing->setPath(
+ 'zip://' . File::realpath($filename) . '#'
+ . $images[$embedImageKey],
+ false,
+ $zip
+ );
+ } else {
+ $linkImageKey = (string) self::getArrayItem(
+ $blip->attributes('http://schemas.openxmlformats.org/officeDocument/2006/relationships'),
+ 'link'
+ );
+ if (isset($images[$linkImageKey])) {
+ $url = str_replace('xl/drawings/', '', $images[$linkImageKey]);
+ $objDrawing->setPath($url, false);
+ }
+ if ($objDrawing->getPath() === '') {
+ continue;
+ }
+ }
+ $objDrawing->setCoordinates(Coordinate::stringFromColumnIndex(((int) $oneCellAnchor->from->col) + 1) . ($oneCellAnchor->from->row + 1));
+
+ $objDrawing->setOffsetX((int) Drawing::EMUToPixels($oneCellAnchor->from->colOff));
+ $objDrawing->setOffsetY(Drawing::EMUToPixels($oneCellAnchor->from->rowOff));
+ $objDrawing->setResizeProportional(false);
+ $objDrawing->setWidth(Drawing::EMUToPixels(self::getArrayItem(self::getAttributes($oneCellAnchor->ext), 'cx')));
+ $objDrawing->setHeight(Drawing::EMUToPixels(self::getArrayItem(self::getAttributes($oneCellAnchor->ext), 'cy')));
+ if ($xfrm) {
+ $objDrawing->setRotation((int) Drawing::angleToDegrees(self::getArrayItem(self::getAttributes($xfrm), 'rot')));
+ $objDrawing->setFlipVertical((bool) self::getArrayItem(self::getAttributes($xfrm), 'flipV'));
+ $objDrawing->setFlipHorizontal((bool) self::getArrayItem(self::getAttributes($xfrm), 'flipH'));
+ }
+ if ($outerShdw) {
+ $shadow = $objDrawing->getShadow();
+ $shadow->setVisible(true);
+ $shadow->setBlurRadius(Drawing::EMUToPixels(self::getArrayItem(self::getAttributes($outerShdw), 'blurRad')));
+ $shadow->setDistance(Drawing::EMUToPixels(self::getArrayItem(self::getAttributes($outerShdw), 'dist')));
+ $shadow->setDirection(Drawing::angleToDegrees(self::getArrayItem(self::getAttributes($outerShdw), 'dir')));
+ $shadow->setAlignment((string) self::getArrayItem(self::getAttributes($outerShdw), 'algn'));
+ $clr = $outerShdw->srgbClr ?? $outerShdw->prstClr;
+ $shadow->getColor()->setRGB(self::getArrayItem(self::getAttributes($clr), 'val'));
+ $shadow->setAlpha(self::getArrayItem(self::getAttributes($clr->alpha), 'val') / 1000);
+ }
+
+ $this->readHyperLinkDrawing($objDrawing, $oneCellAnchor, $hyperlinks);
+
+ $objDrawing->setWorksheet($docSheet);
+ } elseif ($this->includeCharts && $oneCellAnchor->graphicFrame) {
+ // Exported XLSX from Google Sheets positions charts with a oneCellAnchor
+ $coordinates = Coordinate::stringFromColumnIndex(((int) $oneCellAnchor->from->col) + 1) . ($oneCellAnchor->from->row + 1);
+ $offsetX = Drawing::EMUToPixels($oneCellAnchor->from->colOff);
+ $offsetY = Drawing::EMUToPixels($oneCellAnchor->from->rowOff);
+ $width = Drawing::EMUToPixels(self::getArrayItem(self::getAttributes($oneCellAnchor->ext), 'cx'));
+ $height = Drawing::EMUToPixels(self::getArrayItem(self::getAttributes($oneCellAnchor->ext), 'cy'));
+
+ $graphic = $oneCellAnchor->graphicFrame->children(Namespaces::DRAWINGML)->graphic;
+ /** @var SimpleXMLElement $chartRef */
+ $chartRef = $graphic->graphicData->children(Namespaces::CHART)->chart;
+ $thisChart = (string) self::getAttributes($chartRef, $xmlNamespaceBase);
+
+ $chartDetails[$docSheet->getTitle() . '!' . $thisChart] = [
+ 'fromCoordinate' => $coordinates,
+ 'fromOffsetX' => $offsetX,
+ 'fromOffsetY' => $offsetY,
+ 'width' => $width,
+ 'height' => $height,
+ 'worksheetTitle' => $docSheet->getTitle(),
+ 'oneCellAnchor' => true,
+ ];
+ }
+ }
+ }
+ if ($xmlDrawingChildren->twoCellAnchor) {
+ foreach ($xmlDrawingChildren->twoCellAnchor as $twoCellAnchor) {
+ $twoCellAnchor = self::testSimpleXml($twoCellAnchor);
+ if ($twoCellAnchor->pic->blipFill) {
+ $objDrawing = new \PhpOffice\PhpSpreadsheet\Worksheet\Drawing();
+ $blip = $twoCellAnchor->pic->blipFill->children(Namespaces::DRAWINGML)->blip;
+ if (isset($twoCellAnchor->pic->blipFill->children(Namespaces::DRAWINGML)->srcRect)) {
+ $objDrawing->setSrcRect($twoCellAnchor->pic->blipFill->children(Namespaces::DRAWINGML)->srcRect->attributes());
+ }
+ $xfrm = $twoCellAnchor->pic->spPr->children(Namespaces::DRAWINGML)->xfrm;
+ $outerShdw = $twoCellAnchor->pic->spPr->children(Namespaces::DRAWINGML)->effectLst->outerShdw;
+ $editAs = $twoCellAnchor->attributes();
+ if (isset($editAs, $editAs['editAs'])) {
+ $objDrawing->setEditAs($editAs['editAs']);
+ }
+ $objDrawing->setName((string) self::getArrayItem(self::getAttributes($twoCellAnchor->pic->nvPicPr->cNvPr), 'name'));
+ $objDrawing->setDescription((string) self::getArrayItem(self::getAttributes($twoCellAnchor->pic->nvPicPr->cNvPr), 'descr'));
+ $embedImageKey = (string) self::getArrayItem(
+ self::getAttributes($blip, $xmlNamespaceBase),
+ 'embed'
+ );
+ if (isset($images[$embedImageKey])) {
+ $objDrawing->setPath(
+ 'zip://' . File::realpath($filename) . '#'
+ . $images[$embedImageKey],
+ false,
+ $zip
+ );
+ } else {
+ $linkImageKey = (string) self::getArrayItem(
+ $blip->attributes('http://schemas.openxmlformats.org/officeDocument/2006/relationships'),
+ 'link'
+ );
+ if (isset($images[$linkImageKey])) {
+ $url = str_replace('xl/drawings/', '', $images[$linkImageKey]);
+ $objDrawing->setPath($url, false);
+ }
+ if ($objDrawing->getPath() === '') {
+ continue;
+ }
+ }
+ $objDrawing->setCoordinates(Coordinate::stringFromColumnIndex(((int) $twoCellAnchor->from->col) + 1) . ($twoCellAnchor->from->row + 1));
+
+ $objDrawing->setOffsetX(Drawing::EMUToPixels($twoCellAnchor->from->colOff));
+ $objDrawing->setOffsetY(Drawing::EMUToPixels($twoCellAnchor->from->rowOff));
+
+ $objDrawing->setCoordinates2(Coordinate::stringFromColumnIndex(((int) $twoCellAnchor->to->col) + 1) . ($twoCellAnchor->to->row + 1));
+
+ $objDrawing->setOffsetX2(Drawing::EMUToPixels($twoCellAnchor->to->colOff));
+ $objDrawing->setOffsetY2(Drawing::EMUToPixels($twoCellAnchor->to->rowOff));
+
+ $objDrawing->setResizeProportional(false);
+
+ if ($xfrm) {
+ $objDrawing->setWidth(Drawing::EMUToPixels(self::getArrayItem(self::getAttributes($xfrm->ext), 'cx')));
+ $objDrawing->setHeight(Drawing::EMUToPixels(self::getArrayItem(self::getAttributes($xfrm->ext), 'cy')));
+ $objDrawing->setRotation(Drawing::angleToDegrees(self::getArrayItem(self::getAttributes($xfrm), 'rot')));
+ $objDrawing->setFlipVertical((bool) self::getArrayItem(self::getAttributes($xfrm), 'flipV'));
+ $objDrawing->setFlipHorizontal((bool) self::getArrayItem(self::getAttributes($xfrm), 'flipH'));
+ }
+ if ($outerShdw) {
+ $shadow = $objDrawing->getShadow();
+ $shadow->setVisible(true);
+ $shadow->setBlurRadius(Drawing::EMUToPixels(self::getArrayItem(self::getAttributes($outerShdw), 'blurRad')));
+ $shadow->setDistance(Drawing::EMUToPixels(self::getArrayItem(self::getAttributes($outerShdw), 'dist')));
+ $shadow->setDirection(Drawing::angleToDegrees(self::getArrayItem(self::getAttributes($outerShdw), 'dir')));
+ $shadow->setAlignment((string) self::getArrayItem(self::getAttributes($outerShdw), 'algn'));
+ $clr = $outerShdw->srgbClr ?? $outerShdw->prstClr;
+ $shadow->getColor()->setRGB(self::getArrayItem(self::getAttributes($clr), 'val'));
+ $shadow->setAlpha(self::getArrayItem(self::getAttributes($clr->alpha), 'val') / 1000);
+ }
+
+ $this->readHyperLinkDrawing($objDrawing, $twoCellAnchor, $hyperlinks);
+
+ $objDrawing->setWorksheet($docSheet);
+ } elseif (($this->includeCharts) && ($twoCellAnchor->graphicFrame)) {
+ $fromCoordinate = Coordinate::stringFromColumnIndex(((int) $twoCellAnchor->from->col) + 1) . ($twoCellAnchor->from->row + 1);
+ $fromOffsetX = Drawing::EMUToPixels($twoCellAnchor->from->colOff);
+ $fromOffsetY = Drawing::EMUToPixels($twoCellAnchor->from->rowOff);
+ $toCoordinate = Coordinate::stringFromColumnIndex(((int) $twoCellAnchor->to->col) + 1) . ($twoCellAnchor->to->row + 1);
+ $toOffsetX = Drawing::EMUToPixels($twoCellAnchor->to->colOff);
+ $toOffsetY = Drawing::EMUToPixels($twoCellAnchor->to->rowOff);
+ $graphic = $twoCellAnchor->graphicFrame->children(Namespaces::DRAWINGML)->graphic;
+ /** @var SimpleXMLElement $chartRef */
+ $chartRef = $graphic->graphicData->children(Namespaces::CHART)->chart;
+ $thisChart = (string) self::getAttributes($chartRef, $xmlNamespaceBase);
+
+ $chartDetails[$docSheet->getTitle() . '!' . $thisChart] = [
+ 'fromCoordinate' => $fromCoordinate,
+ 'fromOffsetX' => $fromOffsetX,
+ 'fromOffsetY' => $fromOffsetY,
+ 'toCoordinate' => $toCoordinate,
+ 'toOffsetX' => $toOffsetX,
+ 'toOffsetY' => $toOffsetY,
+ 'worksheetTitle' => $docSheet->getTitle(),
+ ];
+ }
+ }
+ }
+ if ($xmlDrawingChildren->absoluteAnchor) {
+ foreach ($xmlDrawingChildren->absoluteAnchor as $absoluteAnchor) {
+ if (($this->includeCharts) && ($absoluteAnchor->graphicFrame)) {
+ $graphic = $absoluteAnchor->graphicFrame->children(Namespaces::DRAWINGML)->graphic;
+ /** @var SimpleXMLElement $chartRef */
+ $chartRef = $graphic->graphicData->children(Namespaces::CHART)->chart;
+ $thisChart = (string) self::getAttributes($chartRef, $xmlNamespaceBase);
+ $width = Drawing::EMUToPixels((int) self::getArrayItem(self::getAttributes($absoluteAnchor->ext), 'cx')[0]);
+ $height = Drawing::EMUToPixels((int) self::getArrayItem(self::getAttributes($absoluteAnchor->ext), 'cy')[0]);
+
+ $chartDetails[$docSheet->getTitle() . '!' . $thisChart] = [
+ 'fromCoordinate' => 'A1',
+ 'fromOffsetX' => 0,
+ 'fromOffsetY' => 0,
+ 'width' => $width,
+ 'height' => $height,
+ 'worksheetTitle' => $docSheet->getTitle(),
+ ];
+ }
+ }
+ }
+ if (empty($relsDrawing) && $xmlDrawing->count() == 0) {
+ // Save Drawing without rels and children as unparsed
+ $unparsedDrawings[$drawingRelId] = $xmlDrawing->asXML();
+ }
+ }
+
+ // store original rId of drawing files
+ $unparsedLoadedData['sheets'][$docSheet->getCodeName()]['drawingOriginalIds'] = [];
+ foreach ($relsWorksheet->Relationship as $elex) {
+ $ele = self::getAttributes($elex);
+ if ((string) $ele['Type'] === "$xmlNamespaceBase/drawing") {
+ $drawingRelId = (string) $ele['Id'];
+ $unparsedLoadedData['sheets'][$docSheet->getCodeName()]['drawingOriginalIds'][(string) $ele['Target']] = $drawingRelId;
+ if (isset($unparsedDrawings[$drawingRelId])) {
+ $unparsedLoadedData['sheets'][$docSheet->getCodeName()]['Drawings'][$drawingRelId] = $unparsedDrawings[$drawingRelId];
+ }
+ }
+ }
+ if ($xmlSheet->legacyDrawing && !$this->readDataOnly) {
+ foreach ($xmlSheet->legacyDrawing as $drawing) {
+ $drawingRelId = (string) self::getArrayItem(self::getAttributes($drawing, $xmlNamespaceBase), 'id');
+ if (isset($vmlDrawingContents[$drawingRelId])) {
+ $unparsedLoadedData['sheets'][$docSheet->getCodeName()]['legacyDrawing'] = $vmlDrawingContents[$drawingRelId];
+ }
+ }
+ }
+
+ // unparsed drawing AlternateContent
+ $xmlAltDrawing = $this->loadZip((string) $fileDrawing, Namespaces::COMPATIBILITY);
+
+ if ($xmlAltDrawing->AlternateContent) {
+ foreach ($xmlAltDrawing->AlternateContent as $alternateContent) {
+ $alternateContent = self::testSimpleXml($alternateContent);
+ $unparsedLoadedData['sheets'][$docSheet->getCodeName()]['drawingAlternateContents'][] = $alternateContent->asXML();
+ }
+ }
+ }
+ }
+
+ $this->readFormControlProperties($excel, $dir, $fileWorksheet, $docSheet, $unparsedLoadedData);
+ $this->readPrinterSettings($excel, $dir, $fileWorksheet, $docSheet, $unparsedLoadedData);
+
+ // Loop through definedNames
+ if ($xmlWorkbook->definedNames) {
+ foreach ($xmlWorkbook->definedNames->definedName as $definedName) {
+ // Extract range
+ $extractedRange = (string) $definedName;
+ if (($spos = strpos($extractedRange, '!')) !== false) {
+ $extractedRange = substr($extractedRange, 0, $spos) . str_replace('$', '', substr($extractedRange, $spos));
+ } else {
+ $extractedRange = str_replace('$', '', $extractedRange);
+ }
+
+ // Valid range?
+ if ($extractedRange == '') {
+ continue;
+ }
+
+ // Some definedNames are only applicable if we are on the same sheet...
+ if ((string) $definedName['localSheetId'] != '' && (string) $definedName['localSheetId'] == $oldSheetId) {
+ // Switch on type
+ switch ((string) $definedName['name']) {
+ case '_xlnm._FilterDatabase':
+ if ((string) $definedName['hidden'] !== '1') {
+ $extractedRange = explode(',', $extractedRange);
+ foreach ($extractedRange as $range) {
+ $autoFilterRange = $range;
+ if (str_contains($autoFilterRange, ':')) {
+ $docSheet->getAutoFilter()->setRange($autoFilterRange);
+ }
+ }
+ }
+
+ break;
+ case '_xlnm.Print_Titles':
+ // Split $extractedRange
+ $extractedRange = explode(',', $extractedRange);
+
+ // Set print titles
+ foreach ($extractedRange as $range) {
+ $matches = [];
+ $range = str_replace('$', '', $range);
+
+ // check for repeating columns, e g. 'A:A' or 'A:D'
+ if (preg_match('/!?([A-Z]+)\:([A-Z]+)$/', $range, $matches)) {
+ $docSheet->getPageSetup()->setColumnsToRepeatAtLeft([$matches[1], $matches[2]]);
+ } elseif (preg_match('/!?(\d+)\:(\d+)$/', $range, $matches)) {
+ // check for repeating rows, e.g. '1:1' or '1:5'
+ $docSheet->getPageSetup()->setRowsToRepeatAtTop([$matches[1], $matches[2]]);
+ }
+ }
+
+ break;
+ case '_xlnm.Print_Area':
+ $rangeSets = preg_split("/('?(?:.*?)'?(?:![A-Z0-9]+:[A-Z0-9]+)),?/", $extractedRange, -1, PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE) ?: [];
+ $newRangeSets = [];
+ foreach ($rangeSets as $rangeSet) {
+ [, $rangeSet] = Worksheet::extractSheetTitle($rangeSet, true);
+ if (empty($rangeSet)) {
+ continue;
+ }
+ if (!str_contains($rangeSet, ':')) {
+ $rangeSet = $rangeSet . ':' . $rangeSet;
+ }
+ $newRangeSets[] = str_replace('$', '', $rangeSet);
+ }
+ if (count($newRangeSets) > 0) {
+ $docSheet->getPageSetup()->setPrintArea(implode(',', $newRangeSets));
+ }
+
+ break;
+ default:
+ break;
+ }
+ }
+ }
+ }
+
+ // Next sheet id
+ ++$sheetId;
+ }
+
+ // Loop through definedNames
+ if ($xmlWorkbook->definedNames) {
+ foreach ($xmlWorkbook->definedNames->definedName as $definedName) {
+ // Extract range
+ $extractedRange = (string) $definedName;
+
+ // Valid range?
+ if ($extractedRange == '') {
+ continue;
+ }
+
+ // Some definedNames are only applicable if we are on the same sheet...
+ if ((string) $definedName['localSheetId'] != '') {
+ // Local defined name
+ // Switch on type
+ switch ((string) $definedName['name']) {
+ case '_xlnm._FilterDatabase':
+ case '_xlnm.Print_Titles':
+ case '_xlnm.Print_Area':
+ break;
+ default:
+ if ($mapSheetId[(int) $definedName['localSheetId']] !== null) {
+ $range = Worksheet::extractSheetTitle($extractedRange, true);
+ $scope = $excel->getSheet($mapSheetId[(int) $definedName['localSheetId']]);
+ if (str_contains((string) $definedName, '!')) {
+ $range[0] = str_replace("''", "'", $range[0]);
+ $range[0] = str_replace("'", '', $range[0]);
+ if ($worksheet = $excel->getSheetByName($range[0])) {
+ $excel->addDefinedName(DefinedName::createInstance((string) $definedName['name'], $worksheet, $extractedRange, true, $scope));
+ } else {
+ $excel->addDefinedName(DefinedName::createInstance((string) $definedName['name'], $scope, $extractedRange, true, $scope));
+ }
+ } else {
+ $excel->addDefinedName(DefinedName::createInstance((string) $definedName['name'], $scope, $extractedRange, true));
+ }
+ }
+
+ break;
+ }
+ } elseif (!isset($definedName['localSheetId'])) {
+ // "Global" definedNames
+ $locatedSheet = null;
+ if (str_contains((string) $definedName, '!')) {
+ // Modify range, and extract the first worksheet reference
+ // Need to split on a comma or a space if not in quotes, and extract the first part.
+ $definedNameValueParts = preg_split("/[ ,](?=([^']*'[^']*')*[^']*$)/miuU", $extractedRange);
+ if (is_array($definedNameValueParts)) {
+ // Extract sheet name
+ [$extractedSheetName] = Worksheet::extractSheetTitle((string) $definedNameValueParts[0], true);
+ $extractedSheetName = trim((string) $extractedSheetName, "'");
+
+ // Locate sheet
+ $locatedSheet = $excel->getSheetByName($extractedSheetName);
+ }
+ }
+
+ if ($locatedSheet === null && !DefinedName::testIfFormula($extractedRange)) {
+ $extractedRange = '#REF!';
+ }
+ $excel->addDefinedName(DefinedName::createInstance((string) $definedName['name'], $locatedSheet, $extractedRange, false));
+ }
+ }
+ }
+ }
+
+ (new WorkbookView($excel))->viewSettings($xmlWorkbook, $mainNS, $mapSheetId, $this->readDataOnly);
+
+ break;
+ }
+ }
+
+ if (!$this->readDataOnly) {
+ $contentTypes = $this->loadZip('[Content_Types].xml');
+
+ // Default content types
+ foreach ($contentTypes->Default as $contentType) {
+ switch ($contentType['ContentType']) {
+ case 'application/vnd.openxmlformats-officedocument.spreadsheetml.printerSettings':
+ $unparsedLoadedData['default_content_types'][(string) $contentType['Extension']] = (string) $contentType['ContentType'];
+
+ break;
+ }
+ }
+
+ // Override content types
+ foreach ($contentTypes->Override as $contentType) {
+ switch ($contentType['ContentType']) {
+ case 'application/vnd.openxmlformats-officedocument.drawingml.chart+xml':
+ if ($this->includeCharts) {
+ $chartEntryRef = ltrim((string) $contentType['PartName'], '/');
+ $chartElements = $this->loadZip($chartEntryRef);
+ $chartReader = new Chart($chartNS, $drawingNS);
+ $objChart = $chartReader->readChart($chartElements, basename($chartEntryRef, '.xml'));
+ if (isset($charts[$chartEntryRef])) {
+ $chartPositionRef = $charts[$chartEntryRef]['sheet'] . '!' . $charts[$chartEntryRef]['id'];
+ if (isset($chartDetails[$chartPositionRef]) && $excel->getSheetByName($charts[$chartEntryRef]['sheet']) !== null) {
+ $excel->getSheetByName($charts[$chartEntryRef]['sheet'])->addChart($objChart);
+ $objChart->setWorksheet($excel->getSheetByName($charts[$chartEntryRef]['sheet']));
+ // For oneCellAnchor or absoluteAnchor positioned charts,
+ // toCoordinate is not in the data. Does it need to be calculated?
+ if (array_key_exists('toCoordinate', $chartDetails[$chartPositionRef])) {
+ // twoCellAnchor
+ $objChart->setTopLeftPosition($chartDetails[$chartPositionRef]['fromCoordinate'], $chartDetails[$chartPositionRef]['fromOffsetX'], $chartDetails[$chartPositionRef]['fromOffsetY']);
+ $objChart->setBottomRightPosition($chartDetails[$chartPositionRef]['toCoordinate'], $chartDetails[$chartPositionRef]['toOffsetX'], $chartDetails[$chartPositionRef]['toOffsetY']);
+ } else {
+ // oneCellAnchor or absoluteAnchor (e.g. Chart sheet)
+ $objChart->setTopLeftPosition($chartDetails[$chartPositionRef]['fromCoordinate'], $chartDetails[$chartPositionRef]['fromOffsetX'], $chartDetails[$chartPositionRef]['fromOffsetY']);
+ $objChart->setBottomRightPosition('', $chartDetails[$chartPositionRef]['width'], $chartDetails[$chartPositionRef]['height']);
+ if (array_key_exists('oneCellAnchor', $chartDetails[$chartPositionRef])) {
+ $objChart->setOneCellAnchor($chartDetails[$chartPositionRef]['oneCellAnchor']);
+ }
+ }
+ }
+ }
+ }
+
+ break;
+
+ // unparsed
+ case 'application/vnd.ms-excel.controlproperties+xml':
+ $unparsedLoadedData['override_content_types'][(string) $contentType['PartName']] = (string) $contentType['ContentType'];
+
+ break;
+ }
+ }
+ }
+
+ $excel->setUnparsedLoadedData($unparsedLoadedData);
+
+ $zip->close();
+
+ return $excel;
+ }
+
+ private function parseRichText(?SimpleXMLElement $is): RichText
+ {
+ $value = new RichText();
+
+ if (isset($is->t)) {
+ $value->createText(StringHelper::controlCharacterOOXML2PHP((string) $is->t));
+ } elseif ($is !== null) {
+ if (is_object($is->r)) {
+ /** @var SimpleXMLElement $run */
+ foreach ($is->r as $run) {
+ if (!isset($run->rPr)) {
+ $value->createText(StringHelper::controlCharacterOOXML2PHP((string) $run->t));
+ } else {
+ $objText = $value->createTextRun(StringHelper::controlCharacterOOXML2PHP((string) $run->t));
+ $objFont = $objText->getFont() ?? new StyleFont();
+
+ if (isset($run->rPr->rFont)) {
+ $attr = $run->rPr->rFont->attributes();
+ if (isset($attr['val'])) {
+ $objFont->setName((string) $attr['val']);
+ }
+ }
+ if (isset($run->rPr->sz)) {
+ $attr = $run->rPr->sz->attributes();
+ if (isset($attr['val'])) {
+ $objFont->setSize((float) $attr['val']);
+ }
+ }
+ if (isset($run->rPr->color)) {
+ $objFont->setColor(new Color($this->styleReader->readColor($run->rPr->color)));
+ }
+ if (isset($run->rPr->b)) {
+ $attr = $run->rPr->b->attributes();
+ if (
+ (isset($attr['val']) && self::boolean((string) $attr['val']))
+ || (!isset($attr['val']))
+ ) {
+ $objFont->setBold(true);
+ }
+ }
+ if (isset($run->rPr->i)) {
+ $attr = $run->rPr->i->attributes();
+ if (
+ (isset($attr['val']) && self::boolean((string) $attr['val']))
+ || (!isset($attr['val']))
+ ) {
+ $objFont->setItalic(true);
+ }
+ }
+ if (isset($run->rPr->vertAlign)) {
+ $attr = $run->rPr->vertAlign->attributes();
+ if (isset($attr['val'])) {
+ $vertAlign = strtolower((string) $attr['val']);
+ if ($vertAlign == 'superscript') {
+ $objFont->setSuperscript(true);
+ }
+ if ($vertAlign == 'subscript') {
+ $objFont->setSubscript(true);
+ }
+ }
+ }
+ if (isset($run->rPr->u)) {
+ $attr = $run->rPr->u->attributes();
+ if (!isset($attr['val'])) {
+ $objFont->setUnderline(StyleFont::UNDERLINE_SINGLE);
+ } else {
+ $objFont->setUnderline((string) $attr['val']);
+ }
+ }
+ if (isset($run->rPr->strike)) {
+ $attr = $run->rPr->strike->attributes();
+ if (
+ (isset($attr['val']) && self::boolean((string) $attr['val']))
+ || (!isset($attr['val']))
+ ) {
+ $objFont->setStrikethrough(true);
+ }
+ }
+ }
+ }
+ }
+ }
+
+ return $value;
+ }
+
+ private function readRibbon(Spreadsheet $excel, string $customUITarget, ZipArchive $zip): void
+ {
+ $baseDir = dirname($customUITarget);
+ $nameCustomUI = basename($customUITarget);
+ // get the xml file (ribbon)
+ $localRibbon = $this->getFromZipArchive($zip, $customUITarget);
+ $customUIImagesNames = [];
+ $customUIImagesBinaries = [];
+ // something like customUI/_rels/customUI.xml.rels
+ $pathRels = $baseDir . '/_rels/' . $nameCustomUI . '.rels';
+ $dataRels = $this->getFromZipArchive($zip, $pathRels);
+ if ($dataRels) {
+ // exists and not empty if the ribbon have some pictures (other than internal MSO)
+ $UIRels = simplexml_load_string(
+ $this->getSecurityScannerOrThrow()
+ ->scan($dataRels)
+ );
+ if (false !== $UIRels) {
+ // we need to save id and target to avoid parsing customUI.xml and "guess" if it's a pseudo callback who load the image
+ foreach ($UIRels->Relationship as $ele) {
+ if ((string) $ele['Type'] === Namespaces::SCHEMA_OFFICE_DOCUMENT . '/image') {
+ // an image ?
+ $customUIImagesNames[(string) $ele['Id']] = (string) $ele['Target'];
+ $customUIImagesBinaries[(string) $ele['Target']] = $this->getFromZipArchive($zip, $baseDir . '/' . (string) $ele['Target']);
+ }
+ }
+ }
+ }
+ if ($localRibbon) {
+ $excel->setRibbonXMLData($customUITarget, $localRibbon);
+ if (count($customUIImagesNames) > 0 && count($customUIImagesBinaries) > 0) {
+ $excel->setRibbonBinObjects($customUIImagesNames, $customUIImagesBinaries);
+ } else {
+ $excel->setRibbonBinObjects(null, null);
+ }
+ } else {
+ $excel->setRibbonXMLData(null, null);
+ $excel->setRibbonBinObjects(null, null);
+ }
+ }
+
+ private static function getArrayItem(null|array|bool|SimpleXMLElement $array, int|string $key = 0): mixed
+ {
+ return ($array === null || is_bool($array)) ? null : ($array[$key] ?? null);
+ }
+
+ private static function dirAdd(null|SimpleXMLElement|string $base, null|SimpleXMLElement|string $add): string
+ {
+ $base = (string) $base;
+ $add = (string) $add;
+
+ return (string) preg_replace('~[^/]+/\.\./~', '', dirname($base) . "/$add");
+ }
+
+ private static function toCSSArray(string $style): array
+ {
+ $style = self::stripWhiteSpaceFromStyleString($style);
+
+ $temp = explode(';', $style);
+ $style = [];
+ foreach ($temp as $item) {
+ $item = explode(':', $item);
+
+ if (str_contains($item[1], 'px')) {
+ $item[1] = str_replace('px', '', $item[1]);
+ }
+ if (str_contains($item[1], 'pt')) {
+ $item[1] = str_replace('pt', '', $item[1]);
+ $item[1] = (string) Font::fontSizeToPixels((int) $item[1]);
+ }
+ if (str_contains($item[1], 'in')) {
+ $item[1] = str_replace('in', '', $item[1]);
+ $item[1] = (string) Font::inchSizeToPixels((int) $item[1]);
+ }
+ if (str_contains($item[1], 'cm')) {
+ $item[1] = str_replace('cm', '', $item[1]);
+ $item[1] = (string) Font::centimeterSizeToPixels((int) $item[1]);
+ }
+
+ $style[$item[0]] = $item[1];
+ }
+
+ return $style;
+ }
+
+ public static function stripWhiteSpaceFromStyleString(string $string): string
+ {
+ return trim(str_replace(["\r", "\n", ' '], '', $string), ';');
+ }
+
+ private static function boolean(string $value): bool
+ {
+ if (is_numeric($value)) {
+ return (bool) $value;
+ }
+
+ return $value === 'true' || $value === 'TRUE';
+ }
+
+ private function readHyperLinkDrawing(\PhpOffice\PhpSpreadsheet\Worksheet\Drawing $objDrawing, SimpleXMLElement $cellAnchor, array $hyperlinks): void
+ {
+ $hlinkClick = $cellAnchor->pic->nvPicPr->cNvPr->children(Namespaces::DRAWINGML)->hlinkClick;
+
+ if ($hlinkClick->count() === 0) {
+ return;
+ }
+
+ $hlinkId = (string) self::getAttributes($hlinkClick, Namespaces::SCHEMA_OFFICE_DOCUMENT)['id'];
+ $hyperlink = new Hyperlink(
+ $hyperlinks[$hlinkId],
+ (string) self::getArrayItem(self::getAttributes($cellAnchor->pic->nvPicPr->cNvPr), 'name')
+ );
+ $objDrawing->setHyperlink($hyperlink);
+ }
+
+ private function readProtection(Spreadsheet $excel, SimpleXMLElement $xmlWorkbook): void
+ {
+ if (!$xmlWorkbook->workbookProtection) {
+ return;
+ }
+
+ $excel->getSecurity()->setLockRevision(self::getLockValue($xmlWorkbook->workbookProtection, 'lockRevision'));
+ $excel->getSecurity()->setLockStructure(self::getLockValue($xmlWorkbook->workbookProtection, 'lockStructure'));
+ $excel->getSecurity()->setLockWindows(self::getLockValue($xmlWorkbook->workbookProtection, 'lockWindows'));
+
+ if ($xmlWorkbook->workbookProtection['revisionsPassword']) {
+ $excel->getSecurity()->setRevisionsPassword(
+ (string) $xmlWorkbook->workbookProtection['revisionsPassword'],
+ true
+ );
+ }
+
+ if ($xmlWorkbook->workbookProtection['workbookPassword']) {
+ $excel->getSecurity()->setWorkbookPassword(
+ (string) $xmlWorkbook->workbookProtection['workbookPassword'],
+ true
+ );
+ }
+ }
+
+ private static function getLockValue(SimpleXMLElement $protection, string $key): ?bool
+ {
+ $returnValue = null;
+ $protectKey = $protection[$key];
+ if (!empty($protectKey)) {
+ $protectKey = (string) $protectKey;
+ $returnValue = $protectKey !== 'false' && (bool) $protectKey;
+ }
+
+ return $returnValue;
+ }
+
+ private function readFormControlProperties(Spreadsheet $excel, string $dir, string $fileWorksheet, Worksheet $docSheet, array &$unparsedLoadedData): void
+ {
+ $zip = $this->zip;
+ if ($zip->locateName(dirname("$dir/$fileWorksheet") . '/_rels/' . basename($fileWorksheet) . '.rels') === false) {
+ return;
+ }
+
+ $filename = dirname("$dir/$fileWorksheet") . '/_rels/' . basename($fileWorksheet) . '.rels';
+ $relsWorksheet = $this->loadZipNoNamespace($filename, Namespaces::RELATIONSHIPS);
+ $ctrlProps = [];
+ foreach ($relsWorksheet->Relationship as $ele) {
+ if ((string) $ele['Type'] === Namespaces::SCHEMA_OFFICE_DOCUMENT . '/ctrlProp') {
+ $ctrlProps[(string) $ele['Id']] = $ele;
+ }
+ }
+
+ $unparsedCtrlProps = &$unparsedLoadedData['sheets'][$docSheet->getCodeName()]['ctrlProps'];
+ foreach ($ctrlProps as $rId => $ctrlProp) {
+ $rId = substr($rId, 3); // rIdXXX
+ $unparsedCtrlProps[$rId] = [];
+ $unparsedCtrlProps[$rId]['filePath'] = self::dirAdd("$dir/$fileWorksheet", $ctrlProp['Target']);
+ $unparsedCtrlProps[$rId]['relFilePath'] = (string) $ctrlProp['Target'];
+ $unparsedCtrlProps[$rId]['content'] = $this->getSecurityScannerOrThrow()->scan($this->getFromZipArchive($zip, $unparsedCtrlProps[$rId]['filePath']));
+ }
+ unset($unparsedCtrlProps);
+ }
+
+ private function readPrinterSettings(Spreadsheet $excel, string $dir, string $fileWorksheet, Worksheet $docSheet, array &$unparsedLoadedData): void
+ {
+ $zip = $this->zip;
+ if ($zip->locateName(dirname("$dir/$fileWorksheet") . '/_rels/' . basename($fileWorksheet) . '.rels') === false) {
+ return;
+ }
+
+ $filename = dirname("$dir/$fileWorksheet") . '/_rels/' . basename($fileWorksheet) . '.rels';
+ $relsWorksheet = $this->loadZipNoNamespace($filename, Namespaces::RELATIONSHIPS);
+ $sheetPrinterSettings = [];
+ foreach ($relsWorksheet->Relationship as $ele) {
+ if ((string) $ele['Type'] === Namespaces::SCHEMA_OFFICE_DOCUMENT . '/printerSettings') {
+ $sheetPrinterSettings[(string) $ele['Id']] = $ele;
+ }
+ }
+
+ $unparsedPrinterSettings = &$unparsedLoadedData['sheets'][$docSheet->getCodeName()]['printerSettings'];
+ foreach ($sheetPrinterSettings as $rId => $printerSettings) {
+ $rId = substr($rId, 3); // rIdXXX
+ if (!str_ends_with($rId, 'ps')) {
+ $rId = $rId . 'ps'; // rIdXXX, add 'ps' suffix to avoid identical resource identifier collision with unparsed vmlDrawing
+ }
+ $unparsedPrinterSettings[$rId] = [];
+ $target = (string) str_replace('/xl/', '../', (string) $printerSettings['Target']);
+ $unparsedPrinterSettings[$rId]['filePath'] = self::dirAdd("$dir/$fileWorksheet", $target);
+ $unparsedPrinterSettings[$rId]['relFilePath'] = $target;
+ $unparsedPrinterSettings[$rId]['content'] = $this->getSecurityScannerOrThrow()->scan($this->getFromZipArchive($zip, $unparsedPrinterSettings[$rId]['filePath']));
+ }
+ unset($unparsedPrinterSettings);
+ }
+
+ private function getWorkbookBaseName(): array
+ {
+ $workbookBasename = '';
+ $xmlNamespaceBase = '';
+
+ // check if it is an OOXML archive
+ $rels = $this->loadZip(self::INITIAL_FILE);
+ foreach ($rels->children(Namespaces::RELATIONSHIPS)->Relationship as $rel) {
+ $rel = self::getAttributes($rel);
+ $type = (string) $rel['Type'];
+ switch ($type) {
+ case Namespaces::OFFICE_DOCUMENT:
+ case Namespaces::PURL_OFFICE_DOCUMENT:
+ $basename = basename((string) $rel['Target']);
+ $xmlNamespaceBase = dirname($type);
+ if (preg_match('/workbook.*\.xml/', $basename)) {
+ $workbookBasename = $basename;
+ }
+
+ break;
+ }
+ }
+
+ return [$workbookBasename, $xmlNamespaceBase];
+ }
+
+ private function readSheetProtection(Worksheet $docSheet, SimpleXMLElement $xmlSheet): void
+ {
+ if ($this->readDataOnly || !$xmlSheet->sheetProtection) {
+ return;
+ }
+
+ $algorithmName = (string) $xmlSheet->sheetProtection['algorithmName'];
+ $protection = $docSheet->getProtection();
+ $protection->setAlgorithm($algorithmName);
+
+ if ($algorithmName) {
+ $protection->setPassword((string) $xmlSheet->sheetProtection['hashValue'], true);
+ $protection->setSalt((string) $xmlSheet->sheetProtection['saltValue']);
+ $protection->setSpinCount((int) $xmlSheet->sheetProtection['spinCount']);
+ } else {
+ $protection->setPassword((string) $xmlSheet->sheetProtection['password'], true);
+ }
+
+ if ($xmlSheet->protectedRanges->protectedRange) {
+ foreach ($xmlSheet->protectedRanges->protectedRange as $protectedRange) {
+ $docSheet->protectCells((string) $protectedRange['sqref'], (string) $protectedRange['password'], true, (string) $protectedRange['name'], (string) $protectedRange['securityDescriptor']);
+ }
+ }
+ }
+
+ private function readAutoFilter(
+ SimpleXMLElement $xmlSheet,
+ Worksheet $docSheet
+ ): void {
+ if ($xmlSheet && $xmlSheet->autoFilter) {
+ (new AutoFilter($docSheet, $xmlSheet))->load();
+ }
+ }
+
+ private function readBackgroundImage(
+ SimpleXMLElement $xmlSheet,
+ Worksheet $docSheet,
+ string $relsName
+ ): void {
+ if ($xmlSheet && $xmlSheet->picture) {
+ $id = (string) self::getArrayItem(self::getAttributes($xmlSheet->picture, Namespaces::SCHEMA_OFFICE_DOCUMENT), 'id');
+ $rels = $this->loadZip($relsName);
+ foreach ($rels->Relationship as $rel) {
+ $attrs = $rel->attributes() ?? [];
+ $rid = (string) ($attrs['Id'] ?? '');
+ $target = (string) ($attrs['Target'] ?? '');
+ if ($rid === $id && substr($target, 0, 2) === '..') {
+ $target = 'xl' . substr($target, 2);
+ $content = $this->getFromZipArchive($this->zip, $target);
+ $docSheet->setBackgroundImage($content);
+ }
+ }
+ }
+ }
+
+ private function readTables(
+ SimpleXMLElement $xmlSheet,
+ Worksheet $docSheet,
+ string $dir,
+ string $fileWorksheet,
+ ZipArchive $zip,
+ string $namespaceTable
+ ): void {
+ if ($xmlSheet && $xmlSheet->tableParts) {
+ $attributes = $xmlSheet->tableParts->attributes() ?? ['count' => 0];
+ if (((int) $attributes['count']) > 0) {
+ $this->readTablesInTablesFile($xmlSheet, $dir, $fileWorksheet, $zip, $docSheet, $namespaceTable);
+ }
+ }
+ }
+
+ private function readTablesInTablesFile(
+ SimpleXMLElement $xmlSheet,
+ string $dir,
+ string $fileWorksheet,
+ ZipArchive $zip,
+ Worksheet $docSheet,
+ string $namespaceTable
+ ): void {
+ foreach ($xmlSheet->tableParts->tablePart as $tablePart) {
+ $relation = self::getAttributes($tablePart, Namespaces::SCHEMA_OFFICE_DOCUMENT);
+ $tablePartRel = (string) $relation['id'];
+ $relationsFileName = dirname("$dir/$fileWorksheet") . '/_rels/' . basename($fileWorksheet) . '.rels';
+
+ if ($zip->locateName($relationsFileName) !== false) {
+ $relsTableReferences = $this->loadZip($relationsFileName, Namespaces::RELATIONSHIPS);
+ foreach ($relsTableReferences->Relationship as $relationship) {
+ $relationshipAttributes = self::getAttributes($relationship, '');
+
+ if ((string) $relationshipAttributes['Id'] === $tablePartRel) {
+ $relationshipFileName = (string) $relationshipAttributes['Target'];
+ $relationshipFilePath = dirname("$dir/$fileWorksheet") . '/' . $relationshipFileName;
+ $relationshipFilePath = File::realpath($relationshipFilePath);
+
+ if ($this->fileExistsInArchive($this->zip, $relationshipFilePath)) {
+ $tableXml = $this->loadZip($relationshipFilePath, $namespaceTable);
+ (new TableReader($docSheet, $tableXml))->load();
+ }
+ }
+ }
+ }
+ }
+ }
+
+ private static function extractStyles(?SimpleXMLElement $sxml, string $node1, string $node2): array
+ {
+ $array = [];
+ if ($sxml && $sxml->{$node1}->{$node2}) {
+ foreach ($sxml->{$node1}->{$node2} as $node) {
+ $array[] = $node;
+ }
+ }
+
+ return $array;
+ }
+
+ private static function extractPalette(?SimpleXMLElement $sxml): array
+ {
+ $array = [];
+ if ($sxml && $sxml->colors->indexedColors) {
+ foreach ($sxml->colors->indexedColors->rgbColor as $node) {
+ if ($node !== null) {
+ $attr = $node->attributes();
+ if (isset($attr['rgb'])) {
+ $array[] = (string) $attr['rgb'];
+ }
+ }
+ }
+ }
+
+ return $array;
+ }
+
+ private function processIgnoredErrors(SimpleXMLElement $xml, Worksheet $sheet): void
+ {
+ $attributes = self::getAttributes($xml);
+ $sqref = (string) ($attributes['sqref'] ?? '');
+ $numberStoredAsText = (string) ($attributes['numberStoredAsText'] ?? '');
+ $formula = (string) ($attributes['formula'] ?? '');
+ $twoDigitTextYear = (string) ($attributes['twoDigitTextYear'] ?? '');
+ $evalError = (string) ($attributes['evalError'] ?? '');
+ if (!empty($sqref)) {
+ $explodedSqref = explode(' ', $sqref);
+ $pattern1 = '/^([A-Z]{1,3})([0-9]{1,7})(:([A-Z]{1,3})([0-9]{1,7}))?$/';
+ foreach ($explodedSqref as $sqref1) {
+ if (preg_match($pattern1, $sqref1, $matches) === 1) {
+ $firstRow = $matches[2];
+ $firstCol = $matches[1];
+ if (array_key_exists(3, $matches)) {
+ $lastCol = $matches[4];
+ $lastRow = $matches[5];
+ } else {
+ $lastCol = $firstCol;
+ $lastRow = $firstRow;
+ }
+ ++$lastCol;
+ for ($row = $firstRow; $row <= $lastRow; ++$row) {
+ for ($col = $firstCol; $col !== $lastCol; ++$col) {
+ if ($numberStoredAsText === '1') {
+ $sheet->getCell("$col$row")->getIgnoredErrors()->setNumberStoredAsText(true);
+ }
+ if ($formula === '1') {
+ $sheet->getCell("$col$row")->getIgnoredErrors()->setFormula(true);
+ }
+ if ($twoDigitTextYear === '1') {
+ $sheet->getCell("$col$row")->getIgnoredErrors()->setTwoDigitTextYear(true);
+ }
+ if ($evalError === '1') {
+ $sheet->getCell("$col$row")->getIgnoredErrors()->setEvalError(true);
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/AutoFilter.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/AutoFilter.php
new file mode 100644
index 00000000..49fe3609
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/AutoFilter.php
@@ -0,0 +1,161 @@
+parent = $parent;
+ $this->worksheetXml = $worksheetXml;
+ }
+
+ public function load(): void
+ {
+ // Remove all "$" in the auto filter range
+ $attrs = $this->worksheetXml->autoFilter->attributes() ?? [];
+ $autoFilterRange = (string) preg_replace('/\$/', '', $attrs['ref'] ?? '');
+ if (str_contains($autoFilterRange, ':')) {
+ $this->readAutoFilter($autoFilterRange);
+ }
+ }
+
+ private function readAutoFilter(string $autoFilterRange): void
+ {
+ $autoFilter = $this->parent->getAutoFilter();
+ $autoFilter->setRange($autoFilterRange);
+
+ foreach ($this->worksheetXml->autoFilter->filterColumn as $filterColumn) {
+ $attributes = $filterColumn->attributes() ?? [];
+ $column = $autoFilter->getColumnByOffset((int) ($attributes['colId'] ?? 0));
+ // Check for standard filters
+ if ($filterColumn->filters) {
+ $column->setFilterType(Column::AUTOFILTER_FILTERTYPE_FILTER);
+ $filters = Xlsx::testSimpleXml($filterColumn->filters->attributes());
+ if ((isset($filters['blank'])) && ((int) $filters['blank'] == 1)) {
+ // Operator is undefined, but always treated as EQUAL
+ $column->createRule()->setRule('', '')->setRuleType(Rule::AUTOFILTER_RULETYPE_FILTER);
+ }
+ // Standard filters are always an OR join, so no join rule needs to be set
+ // Entries can be either filter elements
+ foreach ($filterColumn->filters->filter as $filterRule) {
+ // Operator is undefined, but always treated as EQUAL
+ $attr2 = $filterRule->attributes() ?? ['val' => ''];
+ $column->createRule()->setRule('', (string) $attr2['val'])->setRuleType(Rule::AUTOFILTER_RULETYPE_FILTER);
+ }
+
+ // Or Date Group elements
+ $this->readDateRangeAutoFilter($filterColumn->filters, $column);
+ }
+
+ // Check for custom filters
+ $this->readCustomAutoFilter($filterColumn, $column);
+ // Check for dynamic filters
+ $this->readDynamicAutoFilter($filterColumn, $column);
+ // Check for dynamic filters
+ $this->readTopTenAutoFilter($filterColumn, $column);
+ }
+ $autoFilter->setEvaluated(true);
+ }
+
+ private function readDateRangeAutoFilter(SimpleXMLElement $filters, Column $column): void
+ {
+ foreach ($filters->dateGroupItem as $dateGroupItemx) {
+ // Operator is undefined, but always treated as EQUAL
+ $dateGroupItem = $dateGroupItemx->attributes();
+ if ($dateGroupItem !== null) {
+ $column->createRule()->setRule(
+ '',
+ [
+ 'year' => (string) $dateGroupItem['year'],
+ 'month' => (string) $dateGroupItem['month'],
+ 'day' => (string) $dateGroupItem['day'],
+ 'hour' => (string) $dateGroupItem['hour'],
+ 'minute' => (string) $dateGroupItem['minute'],
+ 'second' => (string) $dateGroupItem['second'],
+ ],
+ (string) $dateGroupItem['dateTimeGrouping']
+ )->setRuleType(Rule::AUTOFILTER_RULETYPE_DATEGROUP);
+ }
+ }
+ }
+
+ private function readCustomAutoFilter(?SimpleXMLElement $filterColumn, Column $column): void
+ {
+ if (isset($filterColumn, $filterColumn->customFilters)) {
+ $column->setFilterType(Column::AUTOFILTER_FILTERTYPE_CUSTOMFILTER);
+ $customFilters = $filterColumn->customFilters;
+ $attributes = $customFilters->attributes();
+ // Custom filters can an AND or an OR join;
+ // and there should only ever be one or two entries
+ if ((isset($attributes['and'])) && ((string) $attributes['and'] === '1')) {
+ $column->setJoin(Column::AUTOFILTER_COLUMN_JOIN_AND);
+ }
+ foreach ($customFilters->customFilter as $filterRule) {
+ $attr2 = $filterRule->attributes() ?? ['operator' => '', 'val' => ''];
+ $column->createRule()->setRule(
+ (string) $attr2['operator'],
+ (string) $attr2['val']
+ )->setRuleType(Rule::AUTOFILTER_RULETYPE_CUSTOMFILTER);
+ }
+ }
+ }
+
+ private function readDynamicAutoFilter(?SimpleXMLElement $filterColumn, Column $column): void
+ {
+ if (isset($filterColumn, $filterColumn->dynamicFilter)) {
+ $column->setFilterType(Column::AUTOFILTER_FILTERTYPE_DYNAMICFILTER);
+ // We should only ever have one dynamic filter
+ foreach ($filterColumn->dynamicFilter as $filterRule) {
+ // Operator is undefined, but always treated as EQUAL
+ $attr2 = $filterRule->attributes() ?? [];
+ $column->createRule()->setRule(
+ '',
+ (string) ($attr2['val'] ?? ''),
+ (string) ($attr2['type'] ?? '')
+ )->setRuleType(Rule::AUTOFILTER_RULETYPE_DYNAMICFILTER);
+ if (isset($attr2['val'])) {
+ $column->setAttribute('val', (string) $attr2['val']);
+ }
+ if (isset($attr2['maxVal'])) {
+ $column->setAttribute('maxVal', (string) $attr2['maxVal']);
+ }
+ }
+ }
+ }
+
+ private function readTopTenAutoFilter(?SimpleXMLElement $filterColumn, Column $column): void
+ {
+ if (isset($filterColumn, $filterColumn->top10)) {
+ $column->setFilterType(Column::AUTOFILTER_FILTERTYPE_TOPTENFILTER);
+ // We should only ever have one top10 filter
+ foreach ($filterColumn->top10 as $filterRule) {
+ $attr2 = $filterRule->attributes() ?? [];
+ $column->createRule()->setRule(
+ (
+ ((isset($attr2['percent'])) && ((string) $attr2['percent'] === '1'))
+ ? Rule::AUTOFILTER_COLUMN_RULE_TOPTEN_PERCENT
+ : Rule::AUTOFILTER_COLUMN_RULE_TOPTEN_BY_VALUE
+ ),
+ (string) ($attr2['val'] ?? ''),
+ (
+ ((isset($attr2['top'])) && ((string) $attr2['top'] === '1'))
+ ? Rule::AUTOFILTER_COLUMN_RULE_TOPTEN_TOP
+ : Rule::AUTOFILTER_COLUMN_RULE_TOPTEN_BOTTOM
+ )
+ )->setRuleType(Rule::AUTOFILTER_RULETYPE_TOPTENFILTER);
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/BaseParserClass.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/BaseParserClass.php
new file mode 100644
index 00000000..beea6bb5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/BaseParserClass.php
@@ -0,0 +1,21 @@
+cNamespace = $cNamespace;
+ $this->aNamespace = $aNamespace;
+ }
+
+ private static function getAttributeString(SimpleXMLElement $component, string $name): string|null
+ {
+ $attributes = $component->attributes();
+ if (@isset($attributes[$name])) {
+ return (string) $attributes[$name];
+ }
+
+ return null;
+ }
+
+ private static function getAttributeInteger(SimpleXMLElement $component, string $name): int|null
+ {
+ $attributes = $component->attributes();
+ if (@isset($attributes[$name])) {
+ return (int) $attributes[$name];
+ }
+
+ return null;
+ }
+
+ private static function getAttributeBoolean(SimpleXMLElement $component, string $name): bool|null
+ {
+ $attributes = $component->attributes();
+ if (@isset($attributes[$name])) {
+ $value = (string) $attributes[$name];
+
+ return $value === 'true' || $value === '1';
+ }
+
+ return null;
+ }
+
+ private static function getAttributeFloat(SimpleXMLElement $component, string $name): float|null
+ {
+ $attributes = $component->attributes();
+ if (@isset($attributes[$name])) {
+ return (float) $attributes[$name];
+ }
+
+ return null;
+ }
+
+ public function readChart(SimpleXMLElement $chartElements, string $chartName): \PhpOffice\PhpSpreadsheet\Chart\Chart
+ {
+ $chartElementsC = $chartElements->children($this->cNamespace);
+
+ $XaxisLabel = $YaxisLabel = $legend = $title = null;
+ $dispBlanksAs = null;
+ $plotVisOnly = false;
+ $plotArea = null;
+ $rotX = $rotY = $rAngAx = $perspective = null;
+ $xAxis = new Axis();
+ $yAxis = new Axis();
+ $autoTitleDeleted = null;
+ $chartNoFill = false;
+ $chartBorderLines = null;
+ $chartFillColor = null;
+ $gradientArray = [];
+ $gradientLin = null;
+ $roundedCorners = false;
+ $gapWidth = null;
+ $useUpBars = null;
+ $useDownBars = null;
+ foreach ($chartElementsC as $chartElementKey => $chartElement) {
+ switch ($chartElementKey) {
+ case 'spPr':
+ $children = $chartElementsC->spPr->children($this->aNamespace);
+ if (isset($children->noFill)) {
+ $chartNoFill = true;
+ }
+ if (isset($children->solidFill)) {
+ $chartFillColor = $this->readColor($children->solidFill);
+ }
+ if (isset($children->ln)) {
+ $chartBorderLines = new GridLines();
+ $this->readLineStyle($chartElementsC, $chartBorderLines);
+ }
+
+ break;
+ case 'roundedCorners':
+ /** @var bool $roundedCorners */
+ $roundedCorners = self::getAttributeBoolean($chartElementsC->roundedCorners, 'val');
+
+ break;
+ case 'chart':
+ foreach ($chartElement as $chartDetailsKey => $chartDetails) {
+ $chartDetails = Xlsx::testSimpleXml($chartDetails);
+ switch ($chartDetailsKey) {
+ case 'autoTitleDeleted':
+ /** @var bool $autoTitleDeleted */
+ $autoTitleDeleted = self::getAttributeBoolean($chartElementsC->chart->autoTitleDeleted, 'val');
+
+ break;
+ case 'view3D':
+ $rotX = self::getAttributeInteger($chartDetails->rotX, 'val');
+ $rotY = self::getAttributeInteger($chartDetails->rotY, 'val');
+ $rAngAx = self::getAttributeInteger($chartDetails->rAngAx, 'val');
+ $perspective = self::getAttributeInteger($chartDetails->perspective, 'val');
+
+ break;
+ case 'plotArea':
+ $plotAreaLayout = $XaxisLabel = $YaxisLabel = null;
+ $plotSeries = $plotAttributes = [];
+ $catAxRead = false;
+ $plotNoFill = false;
+ foreach ($chartDetails as $chartDetailKey => $chartDetail) {
+ $chartDetail = Xlsx::testSimpleXml($chartDetail);
+ switch ($chartDetailKey) {
+ case 'spPr':
+ $possibleNoFill = $chartDetails->spPr->children($this->aNamespace);
+ if (isset($possibleNoFill->noFill)) {
+ $plotNoFill = true;
+ }
+ if (isset($possibleNoFill->gradFill->gsLst)) {
+ foreach ($possibleNoFill->gradFill->gsLst->gs as $gradient) {
+ $gradient = Xlsx::testSimpleXml($gradient);
+ /** @var float $pos */
+ $pos = self::getAttributeFloat($gradient, 'pos');
+ $gradientArray[] = [
+ $pos / ChartProperties::PERCENTAGE_MULTIPLIER,
+ new ChartColor($this->readColor($gradient)),
+ ];
+ }
+ }
+ if (isset($possibleNoFill->gradFill->lin)) {
+ $gradientLin = ChartProperties::XmlToAngle((string) self::getAttributeString($possibleNoFill->gradFill->lin, 'ang'));
+ }
+
+ break;
+ case 'layout':
+ $plotAreaLayout = $this->chartLayoutDetails($chartDetail);
+
+ break;
+ case Axis::AXIS_TYPE_CATEGORY:
+ case Axis::AXIS_TYPE_DATE:
+ $catAxRead = true;
+ if (isset($chartDetail->title)) {
+ $XaxisLabel = $this->chartTitle($chartDetail->title->children($this->cNamespace));
+ }
+ $xAxis->setAxisType($chartDetailKey);
+ $this->readEffects($chartDetail, $xAxis);
+ $this->readLineStyle($chartDetail, $xAxis);
+ if (isset($chartDetail->spPr)) {
+ $sppr = $chartDetail->spPr->children($this->aNamespace);
+ if (isset($sppr->solidFill)) {
+ $axisColorArray = $this->readColor($sppr->solidFill);
+ $xAxis->setFillParameters($axisColorArray['value'], $axisColorArray['alpha'], $axisColorArray['type']);
+ }
+ if (isset($chartDetail->spPr->ln->noFill)) {
+ $xAxis->setNoFill(true);
+ }
+ }
+ if (isset($chartDetail->majorGridlines)) {
+ $majorGridlines = new GridLines();
+ if (isset($chartDetail->majorGridlines->spPr)) {
+ $this->readEffects($chartDetail->majorGridlines, $majorGridlines);
+ $this->readLineStyle($chartDetail->majorGridlines, $majorGridlines);
+ }
+ $xAxis->setMajorGridlines($majorGridlines);
+ }
+ if (isset($chartDetail->minorGridlines)) {
+ $minorGridlines = new GridLines();
+ $minorGridlines->activateObject();
+ if (isset($chartDetail->minorGridlines->spPr)) {
+ $this->readEffects($chartDetail->minorGridlines, $minorGridlines);
+ $this->readLineStyle($chartDetail->minorGridlines, $minorGridlines);
+ }
+ $xAxis->setMinorGridlines($minorGridlines);
+ }
+ $this->setAxisProperties($chartDetail, $xAxis);
+
+ break;
+ case Axis::AXIS_TYPE_VALUE:
+ $whichAxis = null;
+ $axPos = null;
+ if (isset($chartDetail->axPos)) {
+ $axPos = self::getAttributeString($chartDetail->axPos, 'val');
+ }
+ if ($catAxRead) {
+ $whichAxis = $yAxis;
+ $yAxis->setAxisType($chartDetailKey);
+ } elseif (!empty($axPos)) {
+ switch ($axPos) {
+ case 't':
+ case 'b':
+ $whichAxis = $xAxis;
+ $xAxis->setAxisType($chartDetailKey);
+
+ break;
+ case 'r':
+ case 'l':
+ $whichAxis = $yAxis;
+ $yAxis->setAxisType($chartDetailKey);
+
+ break;
+ }
+ }
+ if (isset($chartDetail->title)) {
+ $axisLabel = $this->chartTitle($chartDetail->title->children($this->cNamespace));
+
+ switch ($axPos) {
+ case 't':
+ case 'b':
+ $XaxisLabel = $axisLabel;
+
+ break;
+ case 'r':
+ case 'l':
+ $YaxisLabel = $axisLabel;
+
+ break;
+ }
+ }
+ $this->readEffects($chartDetail, $whichAxis);
+ $this->readLineStyle($chartDetail, $whichAxis);
+ if ($whichAxis !== null && isset($chartDetail->spPr)) {
+ $sppr = $chartDetail->spPr->children($this->aNamespace);
+ if (isset($sppr->solidFill)) {
+ $axisColorArray = $this->readColor($sppr->solidFill);
+ $whichAxis->setFillParameters($axisColorArray['value'], $axisColorArray['alpha'], $axisColorArray['type']);
+ }
+ if (isset($sppr->ln->noFill)) {
+ $whichAxis->setNoFill(true);
+ }
+ }
+ if ($whichAxis !== null && isset($chartDetail->majorGridlines)) {
+ $majorGridlines = new GridLines();
+ if (isset($chartDetail->majorGridlines->spPr)) {
+ $this->readEffects($chartDetail->majorGridlines, $majorGridlines);
+ $this->readLineStyle($chartDetail->majorGridlines, $majorGridlines);
+ }
+ $whichAxis->setMajorGridlines($majorGridlines);
+ }
+ if ($whichAxis !== null && isset($chartDetail->minorGridlines)) {
+ $minorGridlines = new GridLines();
+ $minorGridlines->activateObject();
+ if (isset($chartDetail->minorGridlines->spPr)) {
+ $this->readEffects($chartDetail->minorGridlines, $minorGridlines);
+ $this->readLineStyle($chartDetail->minorGridlines, $minorGridlines);
+ }
+ $whichAxis->setMinorGridlines($minorGridlines);
+ }
+ $this->setAxisProperties($chartDetail, $whichAxis);
+
+ break;
+ case 'barChart':
+ case 'bar3DChart':
+ $barDirection = self::getAttributeString($chartDetail->barDir, 'val');
+ $plotSer = $this->chartDataSeries($chartDetail, $chartDetailKey);
+ $plotSer->setPlotDirection("$barDirection");
+ $plotSeries[] = $plotSer;
+ $plotAttributes = $this->readChartAttributes($chartDetail);
+
+ break;
+ case 'lineChart':
+ case 'line3DChart':
+ $plotSeries[] = $this->chartDataSeries($chartDetail, $chartDetailKey);
+ $plotAttributes = $this->readChartAttributes($chartDetail);
+
+ break;
+ case 'areaChart':
+ case 'area3DChart':
+ $plotSeries[] = $this->chartDataSeries($chartDetail, $chartDetailKey);
+ $plotAttributes = $this->readChartAttributes($chartDetail);
+
+ break;
+ case 'doughnutChart':
+ case 'pieChart':
+ case 'pie3DChart':
+ $explosion = self::getAttributeString($chartDetail->ser->explosion, 'val');
+ $plotSer = $this->chartDataSeries($chartDetail, $chartDetailKey);
+ $plotSer->setPlotStyle("$explosion");
+ $plotSeries[] = $plotSer;
+ $plotAttributes = $this->readChartAttributes($chartDetail);
+
+ break;
+ case 'scatterChart':
+ /** @var string $scatterStyle */
+ $scatterStyle = self::getAttributeString($chartDetail->scatterStyle, 'val');
+ $plotSer = $this->chartDataSeries($chartDetail, $chartDetailKey);
+ $plotSer->setPlotStyle($scatterStyle);
+ $plotSeries[] = $plotSer;
+ $plotAttributes = $this->readChartAttributes($chartDetail);
+
+ break;
+ case 'bubbleChart':
+ $bubbleScale = self::getAttributeInteger($chartDetail->bubbleScale, 'val');
+ $plotSer = $this->chartDataSeries($chartDetail, $chartDetailKey);
+ $plotSer->setPlotStyle("$bubbleScale");
+ $plotSeries[] = $plotSer;
+ $plotAttributes = $this->readChartAttributes($chartDetail);
+
+ break;
+ case 'radarChart':
+ /** @var string $radarStyle */
+ $radarStyle = self::getAttributeString($chartDetail->radarStyle, 'val');
+ $plotSer = $this->chartDataSeries($chartDetail, $chartDetailKey);
+ $plotSer->setPlotStyle($radarStyle);
+ $plotSeries[] = $plotSer;
+ $plotAttributes = $this->readChartAttributes($chartDetail);
+
+ break;
+ case 'surfaceChart':
+ case 'surface3DChart':
+ $wireFrame = self::getAttributeBoolean($chartDetail->wireframe, 'val');
+ $plotSer = $this->chartDataSeries($chartDetail, $chartDetailKey);
+ $plotSer->setPlotStyle("$wireFrame");
+ $plotSeries[] = $plotSer;
+ $plotAttributes = $this->readChartAttributes($chartDetail);
+
+ break;
+ case 'stockChart':
+ $plotSeries[] = $this->chartDataSeries($chartDetail, $chartDetailKey);
+ if (isset($chartDetail->upDownBars->gapWidth)) {
+ $gapWidth = self::getAttributeInteger($chartDetail->upDownBars->gapWidth, 'val');
+ }
+ if (isset($chartDetail->upDownBars->upBars)) {
+ $useUpBars = true;
+ }
+ if (isset($chartDetail->upDownBars->downBars)) {
+ $useDownBars = true;
+ }
+ $plotAttributes = $this->readChartAttributes($chartDetail);
+
+ break;
+ }
+ }
+ if ($plotAreaLayout == null) {
+ $plotAreaLayout = new Layout();
+ }
+ $plotArea = new PlotArea($plotAreaLayout, $plotSeries);
+ $this->setChartAttributes($plotAreaLayout, $plotAttributes);
+ if ($plotNoFill) {
+ $plotArea->setNoFill(true);
+ }
+ if (!empty($gradientArray)) {
+ $plotArea->setGradientFillProperties($gradientArray, $gradientLin);
+ }
+ if (is_int($gapWidth)) {
+ $plotArea->setGapWidth($gapWidth);
+ }
+ if ($useUpBars === true) {
+ $plotArea->setUseUpBars(true);
+ }
+ if ($useDownBars === true) {
+ $plotArea->setUseDownBars(true);
+ }
+
+ break;
+ case 'plotVisOnly':
+ $plotVisOnly = (bool) self::getAttributeString($chartDetails, 'val');
+
+ break;
+ case 'dispBlanksAs':
+ $dispBlanksAs = self::getAttributeString($chartDetails, 'val');
+
+ break;
+ case 'title':
+ $title = $this->chartTitle($chartDetails);
+
+ break;
+ case 'legend':
+ $legendPos = 'r';
+ $legendLayout = null;
+ $legendOverlay = false;
+ $legendBorderLines = null;
+ $legendFillColor = null;
+ $legendText = null;
+ $addLegendText = false;
+ foreach ($chartDetails as $chartDetailKey => $chartDetail) {
+ $chartDetail = Xlsx::testSimpleXml($chartDetail);
+ switch ($chartDetailKey) {
+ case 'legendPos':
+ $legendPos = self::getAttributeString($chartDetail, 'val');
+
+ break;
+ case 'overlay':
+ $legendOverlay = self::getAttributeBoolean($chartDetail, 'val');
+
+ break;
+ case 'layout':
+ $legendLayout = $this->chartLayoutDetails($chartDetail);
+
+ break;
+ case 'spPr':
+ $children = $chartDetails->spPr->children($this->aNamespace);
+ if (isset($children->solidFill)) {
+ $legendFillColor = $this->readColor($children->solidFill);
+ }
+ if (isset($children->ln)) {
+ $legendBorderLines = new GridLines();
+ $this->readLineStyle($chartDetails, $legendBorderLines);
+ }
+
+ break;
+ case 'txPr':
+ $children = $chartDetails->txPr->children($this->aNamespace);
+ $addLegendText = false;
+ $legendText = new AxisText();
+ if (isset($children->p->pPr->defRPr->solidFill)) {
+ $colorArray = $this->readColor($children->p->pPr->defRPr->solidFill);
+ $legendText->getFillColorObject()->setColorPropertiesArray($colorArray);
+ $addLegendText = true;
+ }
+ if (isset($children->p->pPr->defRPr->effectLst)) {
+ $this->readEffects($children->p->pPr->defRPr, $legendText, false);
+ $addLegendText = true;
+ }
+
+ break;
+ }
+ }
+ $legend = new Legend("$legendPos", $legendLayout, (bool) $legendOverlay);
+ if ($legendFillColor !== null) {
+ $legend->getFillColor()->setColorPropertiesArray($legendFillColor);
+ }
+ if ($legendBorderLines !== null) {
+ $legend->setBorderLines($legendBorderLines);
+ }
+ if ($addLegendText) {
+ $legend->setLegendText($legendText);
+ }
+
+ break;
+ }
+ }
+ }
+ }
+ $chart = new \PhpOffice\PhpSpreadsheet\Chart\Chart($chartName, $title, $legend, $plotArea, $plotVisOnly, (string) $dispBlanksAs, $XaxisLabel, $YaxisLabel, $xAxis, $yAxis);
+ if ($chartNoFill) {
+ $chart->setNoFill(true);
+ }
+ if ($chartFillColor !== null) {
+ $chart->getFillColor()->setColorPropertiesArray($chartFillColor);
+ }
+ if ($chartBorderLines !== null) {
+ $chart->setBorderLines($chartBorderLines);
+ }
+ $chart->setRoundedCorners($roundedCorners);
+ if (is_bool($autoTitleDeleted)) {
+ $chart->setAutoTitleDeleted($autoTitleDeleted);
+ }
+ if (is_int($rotX)) {
+ $chart->setRotX($rotX);
+ }
+ if (is_int($rotY)) {
+ $chart->setRotY($rotY);
+ }
+ if (is_int($rAngAx)) {
+ $chart->setRAngAx($rAngAx);
+ }
+ if (is_int($perspective)) {
+ $chart->setPerspective($perspective);
+ }
+
+ return $chart;
+ }
+
+ private function chartTitle(SimpleXMLElement $titleDetails): Title
+ {
+ $caption = '';
+ $titleLayout = null;
+ $titleOverlay = false;
+ $titleFormula = null;
+ $titleFont = null;
+ foreach ($titleDetails as $titleDetailKey => $chartDetail) {
+ $chartDetail = Xlsx::testSimpleXml($chartDetail);
+ switch ($titleDetailKey) {
+ case 'tx':
+ $caption = [];
+ if (isset($chartDetail->rich)) {
+ $titleDetails = $chartDetail->rich->children($this->aNamespace);
+ foreach ($titleDetails as $titleKey => $titleDetail) {
+ $titleDetail = Xlsx::testSimpleXml($titleDetail);
+ switch ($titleKey) {
+ case 'p':
+ $titleDetailPart = $titleDetail->children($this->aNamespace);
+ $caption[] = $this->parseRichText($titleDetailPart);
+ }
+ }
+ } elseif (isset($chartDetail->strRef->strCache)) {
+ foreach ($chartDetail->strRef->strCache->pt as $pt) {
+ if (isset($pt->v)) {
+ $caption[] = (string) $pt->v;
+ }
+ }
+ if (isset($chartDetail->strRef->f)) {
+ $titleFormula = (string) $chartDetail->strRef->f;
+ }
+ }
+
+ break;
+ case 'overlay':
+ $titleOverlay = self::getAttributeBoolean($chartDetail, 'val');
+
+ break;
+ case 'layout':
+ $titleLayout = $this->chartLayoutDetails($chartDetail);
+
+ break;
+ case 'txPr':
+ if (isset($chartDetail->children($this->aNamespace)->p)) {
+ $titleFont = $this->parseFont($chartDetail->children($this->aNamespace)->p);
+ }
+
+ break;
+ }
+ }
+ $title = new Title($caption, $titleLayout, (bool) $titleOverlay);
+ if (!empty($titleFormula)) {
+ $title->setCellReference($titleFormula);
+ }
+ if ($titleFont !== null) {
+ $title->setFont($titleFont);
+ }
+
+ return $title;
+ }
+
+ private function chartLayoutDetails(SimpleXMLElement $chartDetail): ?Layout
+ {
+ if (!isset($chartDetail->manualLayout)) {
+ return null;
+ }
+ $details = $chartDetail->manualLayout->children($this->cNamespace);
+ if ($details === null) {
+ return null;
+ }
+ $layout = [];
+ foreach ($details as $detailKey => $detail) {
+ $detail = Xlsx::testSimpleXml($detail);
+ $layout[$detailKey] = self::getAttributeString($detail, 'val');
+ }
+
+ return new Layout($layout);
+ }
+
+ private function chartDataSeries(SimpleXMLElement $chartDetail, string $plotType): DataSeries
+ {
+ $multiSeriesType = null;
+ $smoothLine = false;
+ $seriesLabel = $seriesCategory = $seriesValues = $plotOrder = $seriesBubbles = [];
+ $plotDirection = null;
+
+ $seriesDetailSet = $chartDetail->children($this->cNamespace);
+ foreach ($seriesDetailSet as $seriesDetailKey => $seriesDetails) {
+ switch ($seriesDetailKey) {
+ case 'grouping':
+ $multiSeriesType = self::getAttributeString($chartDetail->grouping, 'val');
+
+ break;
+ case 'ser':
+ $marker = null;
+ $seriesIndex = '';
+ $fillColor = null;
+ $pointSize = null;
+ $noFill = false;
+ $bubble3D = false;
+ $dptColors = [];
+ $markerFillColor = null;
+ $markerBorderColor = null;
+ $lineStyle = null;
+ $labelLayout = null;
+ $trendLines = [];
+ foreach ($seriesDetails as $seriesKey => $seriesDetail) {
+ $seriesDetail = Xlsx::testSimpleXml($seriesDetail);
+ switch ($seriesKey) {
+ case 'idx':
+ $seriesIndex = self::getAttributeInteger($seriesDetail, 'val');
+
+ break;
+ case 'order':
+ $seriesOrder = self::getAttributeInteger($seriesDetail, 'val');
+ if ($seriesOrder !== null) {
+ $plotOrder[$seriesIndex] = $seriesOrder;
+ }
+
+ break;
+ case 'tx':
+ $temp = $this->chartDataSeriesValueSet($seriesDetail);
+ if ($temp !== null) {
+ $seriesLabel[$seriesIndex] = $temp;
+ }
+
+ break;
+ case 'spPr':
+ $children = $seriesDetail->children($this->aNamespace);
+ if (isset($children->ln)) {
+ $ln = $children->ln;
+ if (is_countable($ln->noFill) && count($ln->noFill) === 1) {
+ $noFill = true;
+ }
+ $lineStyle = new GridLines();
+ $this->readLineStyle($seriesDetails, $lineStyle);
+ }
+ if (isset($children->effectLst)) {
+ if ($lineStyle === null) {
+ $lineStyle = new GridLines();
+ }
+ $this->readEffects($seriesDetails, $lineStyle);
+ }
+ if (isset($children->solidFill)) {
+ $fillColor = new ChartColor($this->readColor($children->solidFill));
+ }
+
+ break;
+ case 'dPt':
+ $dptIdx = (int) self::getAttributeString($seriesDetail->idx, 'val');
+ if (isset($seriesDetail->spPr)) {
+ $children = $seriesDetail->spPr->children($this->aNamespace);
+ if (isset($children->solidFill)) {
+ $arrayColors = $this->readColor($children->solidFill);
+ $dptColors[$dptIdx] = new ChartColor($arrayColors);
+ }
+ }
+
+ break;
+ case 'trendline':
+ $trendLine = new TrendLine();
+ $this->readLineStyle($seriesDetail, $trendLine);
+ $trendLineType = self::getAttributeString($seriesDetail->trendlineType, 'val');
+ $dispRSqr = self::getAttributeBoolean($seriesDetail->dispRSqr, 'val');
+ $dispEq = self::getAttributeBoolean($seriesDetail->dispEq, 'val');
+ $order = self::getAttributeInteger($seriesDetail->order, 'val');
+ $period = self::getAttributeInteger($seriesDetail->period, 'val');
+ $forward = self::getAttributeFloat($seriesDetail->forward, 'val');
+ $backward = self::getAttributeFloat($seriesDetail->backward, 'val');
+ $intercept = self::getAttributeFloat($seriesDetail->intercept, 'val');
+ $name = (string) $seriesDetail->name;
+ $trendLine->setTrendLineProperties(
+ $trendLineType,
+ $order,
+ $period,
+ $dispRSqr,
+ $dispEq,
+ $backward,
+ $forward,
+ $intercept,
+ $name
+ );
+ $trendLines[] = $trendLine;
+
+ break;
+ case 'marker':
+ $marker = self::getAttributeString($seriesDetail->symbol, 'val');
+ $pointSize = self::getAttributeString($seriesDetail->size, 'val');
+ $pointSize = is_numeric($pointSize) ? ((int) $pointSize) : null;
+ if (isset($seriesDetail->spPr)) {
+ $children = $seriesDetail->spPr->children($this->aNamespace);
+ if (isset($children->solidFill)) {
+ $markerFillColor = $this->readColor($children->solidFill);
+ }
+ if (isset($children->ln->solidFill)) {
+ $markerBorderColor = $this->readColor($children->ln->solidFill);
+ }
+ }
+
+ break;
+ case 'smooth':
+ $smoothLine = self::getAttributeBoolean($seriesDetail, 'val') ?? false;
+
+ break;
+ case 'cat':
+ $temp = $this->chartDataSeriesValueSet($seriesDetail);
+ if ($temp !== null) {
+ $seriesCategory[$seriesIndex] = $temp;
+ }
+
+ break;
+ case 'val':
+ $temp = $this->chartDataSeriesValueSet($seriesDetail, "$marker", $fillColor, "$pointSize");
+ if ($temp !== null) {
+ $seriesValues[$seriesIndex] = $temp;
+ }
+
+ break;
+ case 'xVal':
+ $temp = $this->chartDataSeriesValueSet($seriesDetail, "$marker", $fillColor, "$pointSize");
+ if ($temp !== null) {
+ $seriesCategory[$seriesIndex] = $temp;
+ }
+
+ break;
+ case 'yVal':
+ $temp = $this->chartDataSeriesValueSet($seriesDetail, "$marker", $fillColor, "$pointSize");
+ if ($temp !== null) {
+ $seriesValues[$seriesIndex] = $temp;
+ }
+
+ break;
+ case 'bubbleSize':
+ $seriesBubble = $this->chartDataSeriesValueSet($seriesDetail, "$marker", $fillColor, "$pointSize");
+ if ($seriesBubble !== null) {
+ $seriesBubbles[$seriesIndex] = $seriesBubble;
+ }
+
+ break;
+ case 'bubble3D':
+ $bubble3D = self::getAttributeBoolean($seriesDetail, 'val');
+
+ break;
+ case 'dLbls':
+ $labelLayout = new Layout($this->readChartAttributes($seriesDetails));
+
+ break;
+ }
+ }
+ if ($labelLayout) {
+ if (isset($seriesLabel[$seriesIndex])) {
+ $seriesLabel[$seriesIndex]->setLabelLayout($labelLayout);
+ }
+ if (isset($seriesCategory[$seriesIndex])) {
+ $seriesCategory[$seriesIndex]->setLabelLayout($labelLayout);
+ }
+ if (isset($seriesValues[$seriesIndex])) {
+ $seriesValues[$seriesIndex]->setLabelLayout($labelLayout);
+ }
+ }
+ if ($noFill) {
+ if (isset($seriesLabel[$seriesIndex])) {
+ $seriesLabel[$seriesIndex]->setScatterLines(false);
+ }
+ if (isset($seriesCategory[$seriesIndex])) {
+ $seriesCategory[$seriesIndex]->setScatterLines(false);
+ }
+ if (isset($seriesValues[$seriesIndex])) {
+ $seriesValues[$seriesIndex]->setScatterLines(false);
+ }
+ }
+ if ($lineStyle !== null) {
+ if (isset($seriesLabel[$seriesIndex])) {
+ $seriesLabel[$seriesIndex]->copyLineStyles($lineStyle);
+ }
+ if (isset($seriesCategory[$seriesIndex])) {
+ $seriesCategory[$seriesIndex]->copyLineStyles($lineStyle);
+ }
+ if (isset($seriesValues[$seriesIndex])) {
+ $seriesValues[$seriesIndex]->copyLineStyles($lineStyle);
+ }
+ }
+ if ($bubble3D) {
+ if (isset($seriesLabel[$seriesIndex])) {
+ $seriesLabel[$seriesIndex]->setBubble3D($bubble3D);
+ }
+ if (isset($seriesCategory[$seriesIndex])) {
+ $seriesCategory[$seriesIndex]->setBubble3D($bubble3D);
+ }
+ if (isset($seriesValues[$seriesIndex])) {
+ $seriesValues[$seriesIndex]->setBubble3D($bubble3D);
+ }
+ }
+ if (!empty($dptColors)) {
+ if (isset($seriesLabel[$seriesIndex])) {
+ $seriesLabel[$seriesIndex]->setFillColor($dptColors);
+ }
+ if (isset($seriesCategory[$seriesIndex])) {
+ $seriesCategory[$seriesIndex]->setFillColor($dptColors);
+ }
+ if (isset($seriesValues[$seriesIndex])) {
+ $seriesValues[$seriesIndex]->setFillColor($dptColors);
+ }
+ }
+ if ($markerFillColor !== null) {
+ if (isset($seriesLabel[$seriesIndex])) {
+ $seriesLabel[$seriesIndex]->getMarkerFillColor()->setColorPropertiesArray($markerFillColor);
+ }
+ if (isset($seriesCategory[$seriesIndex])) {
+ $seriesCategory[$seriesIndex]->getMarkerFillColor()->setColorPropertiesArray($markerFillColor);
+ }
+ if (isset($seriesValues[$seriesIndex])) {
+ $seriesValues[$seriesIndex]->getMarkerFillColor()->setColorPropertiesArray($markerFillColor);
+ }
+ }
+ if ($markerBorderColor !== null) {
+ if (isset($seriesLabel[$seriesIndex])) {
+ $seriesLabel[$seriesIndex]->getMarkerBorderColor()->setColorPropertiesArray($markerBorderColor);
+ }
+ if (isset($seriesCategory[$seriesIndex])) {
+ $seriesCategory[$seriesIndex]->getMarkerBorderColor()->setColorPropertiesArray($markerBorderColor);
+ }
+ if (isset($seriesValues[$seriesIndex])) {
+ $seriesValues[$seriesIndex]->getMarkerBorderColor()->setColorPropertiesArray($markerBorderColor);
+ }
+ }
+ if ($smoothLine) {
+ if (isset($seriesLabel[$seriesIndex])) {
+ $seriesLabel[$seriesIndex]->setSmoothLine(true);
+ }
+ if (isset($seriesCategory[$seriesIndex])) {
+ $seriesCategory[$seriesIndex]->setSmoothLine(true);
+ }
+ if (isset($seriesValues[$seriesIndex])) {
+ $seriesValues[$seriesIndex]->setSmoothLine(true);
+ }
+ }
+ if (!empty($trendLines)) {
+ if (isset($seriesLabel[$seriesIndex])) {
+ $seriesLabel[$seriesIndex]->setTrendLines($trendLines);
+ }
+ if (isset($seriesCategory[$seriesIndex])) {
+ $seriesCategory[$seriesIndex]->setTrendLines($trendLines);
+ }
+ if (isset($seriesValues[$seriesIndex])) {
+ $seriesValues[$seriesIndex]->setTrendLines($trendLines);
+ }
+ }
+ }
+ }
+ $series = new DataSeries($plotType, $multiSeriesType, $plotOrder, $seriesLabel, $seriesCategory, $seriesValues, $plotDirection, $smoothLine);
+ $series->setPlotBubbleSizes($seriesBubbles);
+
+ return $series;
+ }
+
+ private function chartDataSeriesValueSet(SimpleXMLElement $seriesDetail, ?string $marker = null, ?ChartColor $fillColor = null, ?string $pointSize = null): ?DataSeriesValues
+ {
+ if (isset($seriesDetail->strRef)) {
+ $seriesSource = (string) $seriesDetail->strRef->f;
+ $seriesValues = new DataSeriesValues(DataSeriesValues::DATASERIES_TYPE_STRING, $seriesSource, null, 0, null, $marker, $fillColor, "$pointSize");
+
+ if (isset($seriesDetail->strRef->strCache)) {
+ $seriesData = $this->chartDataSeriesValues($seriesDetail->strRef->strCache->children($this->cNamespace), 's');
+ $seriesValues
+ ->setFormatCode($seriesData['formatCode'])
+ ->setDataValues($seriesData['dataValues']);
+ }
+
+ return $seriesValues;
+ } elseif (isset($seriesDetail->numRef)) {
+ $seriesSource = (string) $seriesDetail->numRef->f;
+ $seriesValues = new DataSeriesValues(DataSeriesValues::DATASERIES_TYPE_NUMBER, $seriesSource, null, 0, null, $marker, $fillColor, "$pointSize");
+ if (isset($seriesDetail->numRef->numCache)) {
+ $seriesData = $this->chartDataSeriesValues($seriesDetail->numRef->numCache->children($this->cNamespace));
+ $seriesValues
+ ->setFormatCode($seriesData['formatCode'])
+ ->setDataValues($seriesData['dataValues']);
+ }
+
+ return $seriesValues;
+ } elseif (isset($seriesDetail->multiLvlStrRef)) {
+ $seriesSource = (string) $seriesDetail->multiLvlStrRef->f;
+ $seriesValues = new DataSeriesValues(DataSeriesValues::DATASERIES_TYPE_STRING, $seriesSource, null, 0, null, $marker, $fillColor, "$pointSize");
+
+ if (isset($seriesDetail->multiLvlStrRef->multiLvlStrCache)) {
+ $seriesData = $this->chartDataSeriesValuesMultiLevel($seriesDetail->multiLvlStrRef->multiLvlStrCache->children($this->cNamespace), 's');
+ $seriesValues
+ ->setFormatCode($seriesData['formatCode'])
+ ->setDataValues($seriesData['dataValues']);
+ }
+
+ return $seriesValues;
+ } elseif (isset($seriesDetail->multiLvlNumRef)) {
+ $seriesSource = (string) $seriesDetail->multiLvlNumRef->f;
+ $seriesValues = new DataSeriesValues(DataSeriesValues::DATASERIES_TYPE_STRING, $seriesSource, null, 0, null, $marker, $fillColor, "$pointSize");
+
+ if (isset($seriesDetail->multiLvlNumRef->multiLvlNumCache)) {
+ $seriesData = $this->chartDataSeriesValuesMultiLevel($seriesDetail->multiLvlNumRef->multiLvlNumCache->children($this->cNamespace), 's');
+ $seriesValues
+ ->setFormatCode($seriesData['formatCode'])
+ ->setDataValues($seriesData['dataValues']);
+ }
+
+ return $seriesValues;
+ }
+
+ if (isset($seriesDetail->v)) {
+ return new DataSeriesValues(
+ DataSeriesValues::DATASERIES_TYPE_STRING,
+ null,
+ null,
+ 1,
+ [(string) $seriesDetail->v]
+ );
+ }
+
+ return null;
+ }
+
+ private function chartDataSeriesValues(SimpleXMLElement $seriesValueSet, string $dataType = 'n'): array
+ {
+ $seriesVal = [];
+ $formatCode = '';
+ $pointCount = 0;
+
+ foreach ($seriesValueSet as $seriesValueIdx => $seriesValue) {
+ $seriesValue = Xlsx::testSimpleXml($seriesValue);
+ switch ($seriesValueIdx) {
+ case 'ptCount':
+ $pointCount = self::getAttributeInteger($seriesValue, 'val');
+
+ break;
+ case 'formatCode':
+ $formatCode = (string) $seriesValue;
+
+ break;
+ case 'pt':
+ $pointVal = self::getAttributeInteger($seriesValue, 'idx');
+ if ($dataType == 's') {
+ $seriesVal[$pointVal] = (string) $seriesValue->v;
+ } elseif ((string) $seriesValue->v === ExcelError::NA()) {
+ $seriesVal[$pointVal] = null;
+ } else {
+ $seriesVal[$pointVal] = (float) $seriesValue->v;
+ }
+
+ break;
+ }
+ }
+
+ return [
+ 'formatCode' => $formatCode,
+ 'pointCount' => $pointCount,
+ 'dataValues' => $seriesVal,
+ ];
+ }
+
+ private function chartDataSeriesValuesMultiLevel(SimpleXMLElement $seriesValueSet, string $dataType = 'n'): array
+ {
+ $seriesVal = [];
+ $formatCode = '';
+ $pointCount = 0;
+
+ foreach ($seriesValueSet->lvl as $seriesLevelIdx => $seriesLevel) {
+ foreach ($seriesLevel as $seriesValueIdx => $seriesValue) {
+ $seriesValue = Xlsx::testSimpleXml($seriesValue);
+ switch ($seriesValueIdx) {
+ case 'ptCount':
+ $pointCount = self::getAttributeInteger($seriesValue, 'val');
+
+ break;
+ case 'formatCode':
+ $formatCode = (string) $seriesValue;
+
+ break;
+ case 'pt':
+ $pointVal = self::getAttributeInteger($seriesValue, 'idx');
+ if ($dataType == 's') {
+ $seriesVal[$pointVal][] = (string) $seriesValue->v;
+ } elseif ((string) $seriesValue->v === ExcelError::NA()) {
+ $seriesVal[$pointVal] = null;
+ } else {
+ $seriesVal[$pointVal][] = (float) $seriesValue->v;
+ }
+
+ break;
+ }
+ }
+ }
+
+ return [
+ 'formatCode' => $formatCode,
+ 'pointCount' => $pointCount,
+ 'dataValues' => $seriesVal,
+ ];
+ }
+
+ private function parseRichText(SimpleXMLElement $titleDetailPart): RichText
+ {
+ $value = new RichText();
+ $defaultFontSize = null;
+ $defaultBold = null;
+ $defaultItalic = null;
+ $defaultUnderscore = null;
+ $defaultStrikethrough = null;
+ $defaultBaseline = null;
+ $defaultFontName = null;
+ $defaultLatin = null;
+ $defaultEastAsian = null;
+ $defaultComplexScript = null;
+ $defaultFontColor = null;
+ if (isset($titleDetailPart->pPr->defRPr)) {
+ $defaultFontSize = self::getAttributeInteger($titleDetailPart->pPr->defRPr, 'sz');
+ $defaultBold = self::getAttributeBoolean($titleDetailPart->pPr->defRPr, 'b');
+ $defaultItalic = self::getAttributeBoolean($titleDetailPart->pPr->defRPr, 'i');
+ $defaultUnderscore = self::getAttributeString($titleDetailPart->pPr->defRPr, 'u');
+ $defaultStrikethrough = self::getAttributeString($titleDetailPart->pPr->defRPr, 'strike');
+ $defaultBaseline = self::getAttributeInteger($titleDetailPart->pPr->defRPr, 'baseline');
+ if (isset($titleDetailPart->defRPr->rFont['val'])) {
+ $defaultFontName = (string) $titleDetailPart->defRPr->rFont['val'];
+ }
+ if (isset($titleDetailPart->pPr->defRPr->latin)) {
+ $defaultLatin = self::getAttributeString($titleDetailPart->pPr->defRPr->latin, 'typeface');
+ }
+ if (isset($titleDetailPart->pPr->defRPr->ea)) {
+ $defaultEastAsian = self::getAttributeString($titleDetailPart->pPr->defRPr->ea, 'typeface');
+ }
+ if (isset($titleDetailPart->pPr->defRPr->cs)) {
+ $defaultComplexScript = self::getAttributeString($titleDetailPart->pPr->defRPr->cs, 'typeface');
+ }
+ if (isset($titleDetailPart->pPr->defRPr->solidFill)) {
+ $defaultFontColor = $this->readColor($titleDetailPart->pPr->defRPr->solidFill);
+ }
+ }
+ foreach ($titleDetailPart as $titleDetailElementKey => $titleDetailElement) {
+ if (
+ (string) $titleDetailElementKey !== 'r'
+ || !isset($titleDetailElement->t)
+ ) {
+ continue;
+ }
+ $objText = $value->createTextRun((string) $titleDetailElement->t);
+ if ($objText->getFont() === null) {
+ // @codeCoverageIgnoreStart
+ continue;
+ // @codeCoverageIgnoreEnd
+ }
+ $fontSize = null;
+ $bold = null;
+ $italic = null;
+ $underscore = null;
+ $strikethrough = null;
+ $baseline = null;
+ $fontName = null;
+ $latinName = null;
+ $eastAsian = null;
+ $complexScript = null;
+ $fontColor = null;
+ $underlineColor = null;
+ if (isset($titleDetailElement->rPr)) {
+ // not used now, not sure it ever was, grandfathering
+ if (isset($titleDetailElement->rPr->rFont['val'])) {
+ // @codeCoverageIgnoreStart
+ $fontName = (string) $titleDetailElement->rPr->rFont['val'];
+ // @codeCoverageIgnoreEnd
+ }
+ if (isset($titleDetailElement->rPr->latin)) {
+ $latinName = self::getAttributeString($titleDetailElement->rPr->latin, 'typeface');
+ }
+ if (isset($titleDetailElement->rPr->ea)) {
+ $eastAsian = self::getAttributeString($titleDetailElement->rPr->ea, 'typeface');
+ }
+ if (isset($titleDetailElement->rPr->cs)) {
+ $complexScript = self::getAttributeString($titleDetailElement->rPr->cs, 'typeface');
+ }
+ $fontSize = self::getAttributeInteger($titleDetailElement->rPr, 'sz');
+
+ // not used now, not sure it ever was, grandfathering
+ if (isset($titleDetailElement->rPr->solidFill)) {
+ $fontColor = $this->readColor($titleDetailElement->rPr->solidFill);
+ }
+
+ $bold = self::getAttributeBoolean($titleDetailElement->rPr, 'b');
+ $italic = self::getAttributeBoolean($titleDetailElement->rPr, 'i');
+ $baseline = self::getAttributeInteger($titleDetailElement->rPr, 'baseline');
+ $underscore = self::getAttributeString($titleDetailElement->rPr, 'u');
+ if (isset($titleDetailElement->rPr->uFill->solidFill)) {
+ $underlineColor = $this->readColor($titleDetailElement->rPr->uFill->solidFill);
+ }
+
+ $strikethrough = self::getAttributeString($titleDetailElement->rPr, 'strike');
+ }
+
+ $fontFound = false;
+ $latinName = $latinName ?? $defaultLatin;
+ if ($latinName !== null) {
+ $objText->getFont()->setLatin($latinName);
+ $fontFound = true;
+ }
+ $eastAsian = $eastAsian ?? $defaultEastAsian;
+ if ($eastAsian !== null) {
+ $objText->getFont()->setEastAsian($eastAsian);
+ $fontFound = true;
+ }
+ $complexScript = $complexScript ?? $defaultComplexScript;
+ if ($complexScript !== null) {
+ $objText->getFont()->setComplexScript($complexScript);
+ $fontFound = true;
+ }
+ $fontName = $fontName ?? $defaultFontName;
+ if ($fontName !== null) {
+ // @codeCoverageIgnoreStart
+ $objText->getFont()->setName($fontName);
+ $fontFound = true;
+ // @codeCoverageIgnoreEnd
+ }
+
+ $fontSize = $fontSize ?? $defaultFontSize;
+ if (is_int($fontSize)) {
+ $objText->getFont()->setSize(floor($fontSize / 100));
+ $fontFound = true;
+ } else {
+ $objText->getFont()->setSize(null, true);
+ }
+
+ $fontColor = $fontColor ?? $defaultFontColor;
+ if (!empty($fontColor)) {
+ $objText->getFont()->setChartColor($fontColor);
+ $fontFound = true;
+ }
+
+ $bold = $bold ?? $defaultBold;
+ if ($bold !== null) {
+ $objText->getFont()->setBold($bold);
+ $fontFound = true;
+ }
+
+ $italic = $italic ?? $defaultItalic;
+ if ($italic !== null) {
+ $objText->getFont()->setItalic($italic);
+ $fontFound = true;
+ }
+
+ $baseline = $baseline ?? $defaultBaseline;
+ if ($baseline !== null) {
+ $objText->getFont()->setBaseLine($baseline);
+ if ($baseline > 0) {
+ $objText->getFont()->setSuperscript(true);
+ } elseif ($baseline < 0) {
+ $objText->getFont()->setSubscript(true);
+ }
+ $fontFound = true;
+ }
+
+ $underscore = $underscore ?? $defaultUnderscore;
+ if ($underscore !== null) {
+ if ($underscore == 'sng') {
+ $objText->getFont()->setUnderline(Font::UNDERLINE_SINGLE);
+ } elseif ($underscore == 'dbl') {
+ $objText->getFont()->setUnderline(Font::UNDERLINE_DOUBLE);
+ } elseif ($underscore !== '') {
+ $objText->getFont()->setUnderline($underscore);
+ } else {
+ $objText->getFont()->setUnderline(Font::UNDERLINE_NONE);
+ }
+ $fontFound = true;
+ if ($underlineColor) {
+ $objText->getFont()->setUnderlineColor($underlineColor);
+ }
+ }
+
+ $strikethrough = $strikethrough ?? $defaultStrikethrough;
+ if ($strikethrough !== null) {
+ $objText->getFont()->setStrikeType($strikethrough);
+ if ($strikethrough == 'noStrike') {
+ $objText->getFont()->setStrikethrough(false);
+ } else {
+ $objText->getFont()->setStrikethrough(true);
+ }
+ $fontFound = true;
+ }
+ if ($fontFound === false) {
+ $objText->setFont(null);
+ }
+ }
+
+ return $value;
+ }
+
+ private function parseFont(SimpleXMLElement $titleDetailPart): ?Font
+ {
+ if (!isset($titleDetailPart->pPr->defRPr)) {
+ return null;
+ }
+ $fontArray = [];
+ $fontArray['size'] = self::getAttributeInteger($titleDetailPart->pPr->defRPr, 'sz');
+ $fontArray['bold'] = self::getAttributeBoolean($titleDetailPart->pPr->defRPr, 'b');
+ $fontArray['italic'] = self::getAttributeBoolean($titleDetailPart->pPr->defRPr, 'i');
+ $fontArray['underscore'] = self::getAttributeString($titleDetailPart->pPr->defRPr, 'u');
+ $fontArray['strikethrough'] = self::getAttributeString($titleDetailPart->pPr->defRPr, 'strike');
+ $fontArray['cap'] = self::getAttributeString($titleDetailPart->pPr->defRPr, 'cap');
+
+ if (isset($titleDetailPart->pPr->defRPr->latin)) {
+ $fontArray['latin'] = self::getAttributeString($titleDetailPart->pPr->defRPr->latin, 'typeface');
+ }
+ if (isset($titleDetailPart->pPr->defRPr->ea)) {
+ $fontArray['eastAsian'] = self::getAttributeString($titleDetailPart->pPr->defRPr->ea, 'typeface');
+ }
+ if (isset($titleDetailPart->pPr->defRPr->cs)) {
+ $fontArray['complexScript'] = self::getAttributeString($titleDetailPart->pPr->defRPr->cs, 'typeface');
+ }
+ if (isset($titleDetailPart->pPr->defRPr->solidFill)) {
+ $fontArray['chartColor'] = new ChartColor($this->readColor($titleDetailPart->pPr->defRPr->solidFill));
+ }
+ $font = new Font();
+ $font->setSize(null, true);
+ $font->applyFromArray($fontArray);
+
+ return $font;
+ }
+
+ private function readChartAttributes(?SimpleXMLElement $chartDetail): array
+ {
+ $plotAttributes = [];
+ if (isset($chartDetail->dLbls)) {
+ if (isset($chartDetail->dLbls->dLblPos)) {
+ $plotAttributes['dLblPos'] = self::getAttributeString($chartDetail->dLbls->dLblPos, 'val');
+ }
+ if (isset($chartDetail->dLbls->numFmt)) {
+ $plotAttributes['numFmtCode'] = self::getAttributeString($chartDetail->dLbls->numFmt, 'formatCode');
+ $plotAttributes['numFmtLinked'] = self::getAttributeBoolean($chartDetail->dLbls->numFmt, 'sourceLinked');
+ }
+ if (isset($chartDetail->dLbls->showLegendKey)) {
+ $plotAttributes['showLegendKey'] = self::getAttributeString($chartDetail->dLbls->showLegendKey, 'val');
+ }
+ if (isset($chartDetail->dLbls->showVal)) {
+ $plotAttributes['showVal'] = self::getAttributeString($chartDetail->dLbls->showVal, 'val');
+ }
+ if (isset($chartDetail->dLbls->showCatName)) {
+ $plotAttributes['showCatName'] = self::getAttributeString($chartDetail->dLbls->showCatName, 'val');
+ }
+ if (isset($chartDetail->dLbls->showSerName)) {
+ $plotAttributes['showSerName'] = self::getAttributeString($chartDetail->dLbls->showSerName, 'val');
+ }
+ if (isset($chartDetail->dLbls->showPercent)) {
+ $plotAttributes['showPercent'] = self::getAttributeString($chartDetail->dLbls->showPercent, 'val');
+ }
+ if (isset($chartDetail->dLbls->showBubbleSize)) {
+ $plotAttributes['showBubbleSize'] = self::getAttributeString($chartDetail->dLbls->showBubbleSize, 'val');
+ }
+ if (isset($chartDetail->dLbls->showLeaderLines)) {
+ $plotAttributes['showLeaderLines'] = self::getAttributeString($chartDetail->dLbls->showLeaderLines, 'val');
+ }
+ if (isset($chartDetail->dLbls->spPr)) {
+ $sppr = $chartDetail->dLbls->spPr->children($this->aNamespace);
+ if (isset($sppr->solidFill)) {
+ $plotAttributes['labelFillColor'] = new ChartColor($this->readColor($sppr->solidFill));
+ }
+ if (isset($sppr->ln->solidFill)) {
+ $plotAttributes['labelBorderColor'] = new ChartColor($this->readColor($sppr->ln->solidFill));
+ }
+ }
+ if (isset($chartDetail->dLbls->txPr)) {
+ $txpr = $chartDetail->dLbls->txPr->children($this->aNamespace);
+ if (isset($txpr->p)) {
+ $plotAttributes['labelFont'] = $this->parseFont($txpr->p);
+ if (isset($txpr->p->pPr->defRPr->effectLst)) {
+ $labelEffects = new GridLines();
+ $this->readEffects($txpr->p->pPr->defRPr, $labelEffects, false);
+ $plotAttributes['labelEffects'] = $labelEffects;
+ }
+ }
+ }
+ }
+
+ return $plotAttributes;
+ }
+
+ private function setChartAttributes(Layout $plotArea, array $plotAttributes): void
+ {
+ foreach ($plotAttributes as $plotAttributeKey => $plotAttributeValue) {
+ switch ($plotAttributeKey) {
+ case 'showLegendKey':
+ $plotArea->setShowLegendKey($plotAttributeValue);
+
+ break;
+ case 'showVal':
+ $plotArea->setShowVal($plotAttributeValue);
+
+ break;
+ case 'showCatName':
+ $plotArea->setShowCatName($plotAttributeValue);
+
+ break;
+ case 'showSerName':
+ $plotArea->setShowSerName($plotAttributeValue);
+
+ break;
+ case 'showPercent':
+ $plotArea->setShowPercent($plotAttributeValue);
+
+ break;
+ case 'showBubbleSize':
+ $plotArea->setShowBubbleSize($plotAttributeValue);
+
+ break;
+ case 'showLeaderLines':
+ $plotArea->setShowLeaderLines($plotAttributeValue);
+
+ break;
+ }
+ }
+ }
+
+ private function readEffects(SimpleXMLElement $chartDetail, ?ChartProperties $chartObject, bool $getSppr = true): void
+ {
+ if (!isset($chartObject)) {
+ return;
+ }
+ if ($getSppr) {
+ if (!isset($chartDetail->spPr)) {
+ return;
+ }
+ $sppr = $chartDetail->spPr->children($this->aNamespace);
+ } else {
+ $sppr = $chartDetail;
+ }
+ if (isset($sppr->effectLst->glow)) {
+ $axisGlowSize = (float) self::getAttributeInteger($sppr->effectLst->glow, 'rad') / ChartProperties::POINTS_WIDTH_MULTIPLIER;
+ if ($axisGlowSize != 0.0) {
+ $colorArray = $this->readColor($sppr->effectLst->glow);
+ $chartObject->setGlowProperties($axisGlowSize, $colorArray['value'], $colorArray['alpha'], $colorArray['type']);
+ }
+ }
+
+ if (isset($sppr->effectLst->softEdge)) {
+ $softEdgeSize = self::getAttributeString($sppr->effectLst->softEdge, 'rad');
+ if (is_numeric($softEdgeSize)) {
+ $chartObject->setSoftEdges((float) ChartProperties::xmlToPoints($softEdgeSize));
+ }
+ }
+
+ $type = '';
+ foreach (self::SHADOW_TYPES as $shadowType) {
+ if (isset($sppr->effectLst->$shadowType)) {
+ $type = $shadowType;
+
+ break;
+ }
+ }
+ if ($type !== '') {
+ $blur = self::getAttributeString($sppr->effectLst->$type, 'blurRad');
+ $blur = is_numeric($blur) ? ChartProperties::xmlToPoints($blur) : null;
+ $dist = self::getAttributeString($sppr->effectLst->$type, 'dist');
+ $dist = is_numeric($dist) ? ChartProperties::xmlToPoints($dist) : null;
+ $direction = self::getAttributeString($sppr->effectLst->$type, 'dir');
+ $direction = is_numeric($direction) ? ChartProperties::xmlToAngle($direction) : null;
+ $algn = self::getAttributeString($sppr->effectLst->$type, 'algn');
+ $rot = self::getAttributeString($sppr->effectLst->$type, 'rotWithShape');
+ $size = [];
+ foreach (['sx', 'sy'] as $sizeType) {
+ $sizeValue = self::getAttributeString($sppr->effectLst->$type, $sizeType);
+ if (is_numeric($sizeValue)) {
+ $size[$sizeType] = ChartProperties::xmlToTenthOfPercent((string) $sizeValue);
+ } else {
+ $size[$sizeType] = null;
+ }
+ }
+ foreach (['kx', 'ky'] as $sizeType) {
+ $sizeValue = self::getAttributeString($sppr->effectLst->$type, $sizeType);
+ if (is_numeric($sizeValue)) {
+ $size[$sizeType] = ChartProperties::xmlToAngle((string) $sizeValue);
+ } else {
+ $size[$sizeType] = null;
+ }
+ }
+ $colorArray = $this->readColor($sppr->effectLst->$type);
+ $chartObject
+ ->setShadowProperty('effect', $type)
+ ->setShadowProperty('blur', $blur)
+ ->setShadowProperty('direction', $direction)
+ ->setShadowProperty('distance', $dist)
+ ->setShadowProperty('algn', $algn)
+ ->setShadowProperty('rotWithShape', $rot)
+ ->setShadowProperty('size', $size)
+ ->setShadowProperty('color', $colorArray);
+ }
+ }
+
+ private const SHADOW_TYPES = [
+ 'outerShdw',
+ 'innerShdw',
+ ];
+
+ private function readColor(SimpleXMLElement $colorXml): array
+ {
+ $result = [
+ 'type' => null,
+ 'value' => null,
+ 'alpha' => null,
+ 'brightness' => null,
+ ];
+ foreach (ChartColor::EXCEL_COLOR_TYPES as $type) {
+ if (isset($colorXml->$type)) {
+ $result['type'] = $type;
+ $result['value'] = self::getAttributeString($colorXml->$type, 'val');
+ if (isset($colorXml->$type->alpha)) {
+ $alpha = self::getAttributeString($colorXml->$type->alpha, 'val');
+ if (is_numeric($alpha)) {
+ $result['alpha'] = ChartColor::alphaFromXml($alpha);
+ }
+ }
+ if (isset($colorXml->$type->lumMod)) {
+ $brightness = self::getAttributeString($colorXml->$type->lumMod, 'val');
+ if (is_numeric($brightness)) {
+ $result['brightness'] = ChartColor::alphaFromXml($brightness);
+ }
+ }
+
+ break;
+ }
+ }
+
+ return $result;
+ }
+
+ private function readLineStyle(SimpleXMLElement $chartDetail, ?ChartProperties $chartObject): void
+ {
+ if (!isset($chartObject, $chartDetail->spPr)) {
+ return;
+ }
+ $sppr = $chartDetail->spPr->children($this->aNamespace);
+
+ if (!isset($sppr->ln)) {
+ return;
+ }
+ $lineWidth = null;
+ $lineWidthTemp = self::getAttributeString($sppr->ln, 'w');
+ if (is_numeric($lineWidthTemp)) {
+ $lineWidth = ChartProperties::xmlToPoints($lineWidthTemp);
+ }
+ /** @var string $compoundType */
+ $compoundType = self::getAttributeString($sppr->ln, 'cmpd');
+ /** @var string $dashType */
+ $dashType = self::getAttributeString($sppr->ln->prstDash, 'val');
+ /** @var string $capType */
+ $capType = self::getAttributeString($sppr->ln, 'cap');
+ if (isset($sppr->ln->miter)) {
+ $joinType = ChartProperties::LINE_STYLE_JOIN_MITER;
+ } elseif (isset($sppr->ln->bevel)) {
+ $joinType = ChartProperties::LINE_STYLE_JOIN_BEVEL;
+ } else {
+ $joinType = '';
+ }
+ $headArrowSize = 0;
+ $endArrowSize = 0;
+ $headArrowType = self::getAttributeString($sppr->ln->headEnd, 'type');
+ $headArrowWidth = self::getAttributeString($sppr->ln->headEnd, 'w');
+ $headArrowLength = self::getAttributeString($sppr->ln->headEnd, 'len');
+ $endArrowType = self::getAttributeString($sppr->ln->tailEnd, 'type');
+ $endArrowWidth = self::getAttributeString($sppr->ln->tailEnd, 'w');
+ $endArrowLength = self::getAttributeString($sppr->ln->tailEnd, 'len');
+ $chartObject->setLineStyleProperties(
+ $lineWidth,
+ $compoundType,
+ $dashType,
+ $capType,
+ $joinType,
+ $headArrowType,
+ $headArrowSize,
+ $endArrowType,
+ $endArrowSize,
+ $headArrowWidth,
+ $headArrowLength,
+ $endArrowWidth,
+ $endArrowLength
+ );
+ $colorArray = $this->readColor($sppr->ln->solidFill);
+ $chartObject->getLineColor()->setColorPropertiesArray($colorArray);
+ }
+
+ private function setAxisProperties(SimpleXMLElement $chartDetail, ?Axis $whichAxis): void
+ {
+ if (!isset($whichAxis)) {
+ return;
+ }
+ if (isset($chartDetail->delete)) {
+ $whichAxis->setAxisOption('hidden', (string) self::getAttributeString($chartDetail->delete, 'val'));
+ }
+ if (isset($chartDetail->numFmt)) {
+ $whichAxis->setAxisNumberProperties(
+ (string) self::getAttributeString($chartDetail->numFmt, 'formatCode'),
+ null,
+ (int) self::getAttributeInteger($chartDetail->numFmt, 'sourceLinked')
+ );
+ }
+ if (isset($chartDetail->crossBetween)) {
+ $whichAxis->setCrossBetween((string) self::getAttributeString($chartDetail->crossBetween, 'val'));
+ }
+ if (isset($chartDetail->dispUnits, $chartDetail->dispUnits->builtInUnit)) {
+ $whichAxis->setAxisOption('dispUnitsBuiltIn', (string) self::getAttributeString($chartDetail->dispUnits->builtInUnit, 'val'));
+ if (isset($chartDetail->dispUnits->dispUnitsLbl)) {
+ $whichAxis->setDispUnitsTitle(new Title());
+ // TODO parse title elements
+ }
+ }
+ if (isset($chartDetail->majorTickMark)) {
+ $whichAxis->setAxisOption('major_tick_mark', (string) self::getAttributeString($chartDetail->majorTickMark, 'val'));
+ }
+ if (isset($chartDetail->minorTickMark)) {
+ $whichAxis->setAxisOption('minor_tick_mark', (string) self::getAttributeString($chartDetail->minorTickMark, 'val'));
+ }
+ if (isset($chartDetail->tickLblPos)) {
+ $whichAxis->setAxisOption('axis_labels', (string) self::getAttributeString($chartDetail->tickLblPos, 'val'));
+ }
+ if (isset($chartDetail->crosses)) {
+ $whichAxis->setAxisOption('horizontal_crosses', (string) self::getAttributeString($chartDetail->crosses, 'val'));
+ }
+ if (isset($chartDetail->crossesAt)) {
+ $whichAxis->setAxisOption('horizontal_crosses_value', (string) self::getAttributeString($chartDetail->crossesAt, 'val'));
+ }
+ if (isset($chartDetail->scaling->logBase)) {
+ $whichAxis->setAxisOption('logBase', (string) self::getAttributeString($chartDetail->scaling->logBase, 'val'));
+ }
+ if (isset($chartDetail->scaling->orientation)) {
+ $whichAxis->setAxisOption('orientation', (string) self::getAttributeString($chartDetail->scaling->orientation, 'val'));
+ }
+ if (isset($chartDetail->scaling->max)) {
+ $whichAxis->setAxisOption('maximum', (string) self::getAttributeString($chartDetail->scaling->max, 'val'));
+ }
+ if (isset($chartDetail->scaling->min)) {
+ $whichAxis->setAxisOption('minimum', (string) self::getAttributeString($chartDetail->scaling->min, 'val'));
+ }
+ if (isset($chartDetail->scaling->min)) {
+ $whichAxis->setAxisOption('minimum', (string) self::getAttributeString($chartDetail->scaling->min, 'val'));
+ }
+ if (isset($chartDetail->majorUnit)) {
+ $whichAxis->setAxisOption('major_unit', (string) self::getAttributeString($chartDetail->majorUnit, 'val'));
+ }
+ if (isset($chartDetail->minorUnit)) {
+ $whichAxis->setAxisOption('minor_unit', (string) self::getAttributeString($chartDetail->minorUnit, 'val'));
+ }
+ if (isset($chartDetail->baseTimeUnit)) {
+ $whichAxis->setAxisOption('baseTimeUnit', (string) self::getAttributeString($chartDetail->baseTimeUnit, 'val'));
+ }
+ if (isset($chartDetail->majorTimeUnit)) {
+ $whichAxis->setAxisOption('majorTimeUnit', (string) self::getAttributeString($chartDetail->majorTimeUnit, 'val'));
+ }
+ if (isset($chartDetail->minorTimeUnit)) {
+ $whichAxis->setAxisOption('minorTimeUnit', (string) self::getAttributeString($chartDetail->minorTimeUnit, 'val'));
+ }
+ if (isset($chartDetail->txPr)) {
+ $children = $chartDetail->txPr->children($this->aNamespace);
+ $addAxisText = false;
+ $axisText = new AxisText();
+ if (isset($children->bodyPr)) {
+ $textRotation = self::getAttributeString($children->bodyPr, 'rot');
+ if (is_numeric($textRotation)) {
+ $axisText->setRotation((int) ChartProperties::xmlToAngle($textRotation));
+ $addAxisText = true;
+ }
+ }
+ if (isset($children->p->pPr->defRPr)) {
+ $font = $this->parseFont($children->p);
+ if ($font !== null) {
+ $axisText->setFont($font);
+ $addAxisText = true;
+ }
+ }
+ if (isset($children->p->pPr->defRPr->effectLst)) {
+ $this->readEffects($children->p->pPr->defRPr, $axisText, false);
+ $addAxisText = true;
+ }
+ if ($addAxisText) {
+ $whichAxis->setAxisText($axisText);
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/ColumnAndRowAttributes.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/ColumnAndRowAttributes.php
new file mode 100644
index 00000000..cf9046ce
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/ColumnAndRowAttributes.php
@@ -0,0 +1,219 @@
+worksheet = $workSheet;
+ $this->worksheetXml = $worksheetXml;
+ }
+
+ /**
+ * Set Worksheet column attributes by attributes array passed.
+ *
+ * @param string $columnAddress A, B, ... DX, ...
+ * @param array $columnAttributes array of attributes (indexes are attribute name, values are value)
+ * 'xfIndex', 'visible', 'collapsed', 'outlineLevel', 'width', ... ?
+ */
+ private function setColumnAttributes(string $columnAddress, array $columnAttributes): void
+ {
+ if (isset($columnAttributes['xfIndex'])) {
+ $this->worksheet->getColumnDimension($columnAddress)->setXfIndex($columnAttributes['xfIndex']);
+ }
+ if (isset($columnAttributes['visible'])) {
+ $this->worksheet->getColumnDimension($columnAddress)->setVisible($columnAttributes['visible']);
+ }
+ if (isset($columnAttributes['collapsed'])) {
+ $this->worksheet->getColumnDimension($columnAddress)->setCollapsed($columnAttributes['collapsed']);
+ }
+ if (isset($columnAttributes['outlineLevel'])) {
+ $this->worksheet->getColumnDimension($columnAddress)->setOutlineLevel($columnAttributes['outlineLevel']);
+ }
+ if (isset($columnAttributes['width'])) {
+ $this->worksheet->getColumnDimension($columnAddress)->setWidth($columnAttributes['width']);
+ }
+ }
+
+ /**
+ * Set Worksheet row attributes by attributes array passed.
+ *
+ * @param int $rowNumber 1, 2, 3, ... 99, ...
+ * @param array $rowAttributes array of attributes (indexes are attribute name, values are value)
+ * 'xfIndex', 'visible', 'collapsed', 'outlineLevel', 'rowHeight', ... ?
+ */
+ private function setRowAttributes(int $rowNumber, array $rowAttributes): void
+ {
+ if (isset($rowAttributes['xfIndex'])) {
+ $this->worksheet->getRowDimension($rowNumber)->setXfIndex($rowAttributes['xfIndex']);
+ }
+ if (isset($rowAttributes['visible'])) {
+ $this->worksheet->getRowDimension($rowNumber)->setVisible($rowAttributes['visible']);
+ }
+ if (isset($rowAttributes['collapsed'])) {
+ $this->worksheet->getRowDimension($rowNumber)->setCollapsed($rowAttributes['collapsed']);
+ }
+ if (isset($rowAttributes['outlineLevel'])) {
+ $this->worksheet->getRowDimension($rowNumber)->setOutlineLevel($rowAttributes['outlineLevel']);
+ }
+ if (isset($rowAttributes['rowHeight'])) {
+ $this->worksheet->getRowDimension($rowNumber)->setRowHeight($rowAttributes['rowHeight']);
+ }
+ }
+
+ public function load(?IReadFilter $readFilter = null, bool $readDataOnly = false, bool $ignoreRowsWithNoCells = false): void
+ {
+ if ($this->worksheetXml === null) {
+ return;
+ }
+
+ $columnsAttributes = [];
+ $rowsAttributes = [];
+ if (isset($this->worksheetXml->cols)) {
+ $columnsAttributes = $this->readColumnAttributes($this->worksheetXml->cols, $readDataOnly);
+ }
+
+ if ($this->worksheetXml->sheetData && $this->worksheetXml->sheetData->row) {
+ $rowsAttributes = $this->readRowAttributes($this->worksheetXml->sheetData->row, $readDataOnly, $ignoreRowsWithNoCells);
+ }
+
+ if ($readFilter !== null && $readFilter::class === DefaultReadFilter::class) {
+ $readFilter = null;
+ }
+
+ // set columns/rows attributes
+ $columnsAttributesAreSet = [];
+ foreach ($columnsAttributes as $columnCoordinate => $columnAttributes) {
+ if (
+ $readFilter === null
+ || !$this->isFilteredColumn($readFilter, $columnCoordinate, $rowsAttributes)
+ ) {
+ if (!isset($columnsAttributesAreSet[$columnCoordinate])) {
+ $this->setColumnAttributes($columnCoordinate, $columnAttributes);
+ $columnsAttributesAreSet[$columnCoordinate] = true;
+ }
+ }
+ }
+
+ $rowsAttributesAreSet = [];
+ foreach ($rowsAttributes as $rowCoordinate => $rowAttributes) {
+ if (
+ $readFilter === null
+ || !$this->isFilteredRow($readFilter, $rowCoordinate, $columnsAttributes)
+ ) {
+ if (!isset($rowsAttributesAreSet[$rowCoordinate])) {
+ $this->setRowAttributes($rowCoordinate, $rowAttributes);
+ $rowsAttributesAreSet[$rowCoordinate] = true;
+ }
+ }
+ }
+ }
+
+ private function isFilteredColumn(IReadFilter $readFilter, string $columnCoordinate, array $rowsAttributes): bool
+ {
+ foreach ($rowsAttributes as $rowCoordinate => $rowAttributes) {
+ if (!$readFilter->readCell($columnCoordinate, $rowCoordinate, $this->worksheet->getTitle())) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ private function readColumnAttributes(SimpleXMLElement $worksheetCols, bool $readDataOnly): array
+ {
+ $columnAttributes = [];
+
+ foreach ($worksheetCols->col as $columnx) {
+ $column = $columnx->attributes();
+ if ($column !== null) {
+ $startColumn = Coordinate::stringFromColumnIndex((int) $column['min']);
+ $endColumn = Coordinate::stringFromColumnIndex((int) $column['max']);
+ ++$endColumn;
+ for ($columnAddress = $startColumn; $columnAddress !== $endColumn; ++$columnAddress) {
+ $columnAttributes[$columnAddress] = $this->readColumnRangeAttributes($column, $readDataOnly);
+
+ if ((int) ($column['max']) == 16384) {
+ break;
+ }
+ }
+ }
+ }
+
+ return $columnAttributes;
+ }
+
+ private function readColumnRangeAttributes(?SimpleXMLElement $column, bool $readDataOnly): array
+ {
+ $columnAttributes = [];
+ if ($column !== null) {
+ if (isset($column['style']) && !$readDataOnly) {
+ $columnAttributes['xfIndex'] = (int) $column['style'];
+ }
+ if (isset($column['hidden']) && self::boolean($column['hidden'])) {
+ $columnAttributes['visible'] = false;
+ }
+ if (isset($column['collapsed']) && self::boolean($column['collapsed'])) {
+ $columnAttributes['collapsed'] = true;
+ }
+ if (isset($column['outlineLevel']) && ((int) $column['outlineLevel']) > 0) {
+ $columnAttributes['outlineLevel'] = (int) $column['outlineLevel'];
+ }
+ if (isset($column['width'])) {
+ $columnAttributes['width'] = (float) $column['width'];
+ }
+ }
+
+ return $columnAttributes;
+ }
+
+ private function isFilteredRow(IReadFilter $readFilter, int $rowCoordinate, array $columnsAttributes): bool
+ {
+ foreach ($columnsAttributes as $columnCoordinate => $columnAttributes) {
+ if (!$readFilter->readCell($columnCoordinate, $rowCoordinate, $this->worksheet->getTitle())) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ private function readRowAttributes(SimpleXMLElement $worksheetRow, bool $readDataOnly, bool $ignoreRowsWithNoCells): array
+ {
+ $rowAttributes = [];
+
+ foreach ($worksheetRow as $rowx) {
+ $row = $rowx->attributes();
+ if ($row !== null && (!$ignoreRowsWithNoCells || isset($rowx->c))) {
+ if (isset($row['ht']) && !$readDataOnly) {
+ $rowAttributes[(int) $row['r']]['rowHeight'] = (float) $row['ht'];
+ }
+ if (isset($row['hidden']) && self::boolean($row['hidden'])) {
+ $rowAttributes[(int) $row['r']]['visible'] = false;
+ }
+ if (isset($row['collapsed']) && self::boolean($row['collapsed'])) {
+ $rowAttributes[(int) $row['r']]['collapsed'] = true;
+ }
+ if (isset($row['outlineLevel']) && (int) $row['outlineLevel'] > 0) {
+ $rowAttributes[(int) $row['r']]['outlineLevel'] = (int) $row['outlineLevel'];
+ }
+ if (isset($row['s']) && !$readDataOnly) {
+ $rowAttributes[(int) $row['r']]['xfIndex'] = (int) $row['s'];
+ }
+ }
+ }
+
+ return $rowAttributes;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/ConditionalStyles.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/ConditionalStyles.php
new file mode 100644
index 00000000..cb562ef6
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/ConditionalStyles.php
@@ -0,0 +1,336 @@
+worksheet = $workSheet;
+ $this->worksheetXml = $worksheetXml;
+ $this->dxfs = $dxfs;
+ $this->styleReader = $styleReader;
+ }
+
+ public function load(): void
+ {
+ $selectedCells = $this->worksheet->getSelectedCells();
+
+ $this->setConditionalStyles(
+ $this->worksheet,
+ $this->readConditionalStyles($this->worksheetXml),
+ $this->worksheetXml->extLst
+ );
+
+ $this->worksheet->setSelectedCells($selectedCells);
+ }
+
+ public function loadFromExt(): void
+ {
+ $selectedCells = $this->worksheet->getSelectedCells();
+
+ $this->ns = $this->worksheetXml->getNamespaces(true);
+ $this->setConditionalsFromExt(
+ $this->readConditionalsFromExt($this->worksheetXml->extLst)
+ );
+
+ $this->worksheet->setSelectedCells($selectedCells);
+ }
+
+ private function setConditionalsFromExt(array $conditionals): void
+ {
+ foreach ($conditionals as $conditionalRange => $cfRules) {
+ ksort($cfRules);
+ // Priority is used as the key for sorting; but may not start at 0,
+ // so we use array_values to reset the index after sorting.
+ $this->worksheet->getStyle($conditionalRange)
+ ->setConditionalStyles(array_values($cfRules));
+ }
+ }
+
+ private function readConditionalsFromExt(SimpleXMLElement $extLst): array
+ {
+ $conditionals = [];
+ if (!isset($extLst->ext)) {
+ return $conditionals;
+ }
+
+ foreach ($extLst->ext as $extlstcond) {
+ $extAttrs = $extlstcond->attributes() ?? [];
+ $extUri = (string) ($extAttrs['uri'] ?? '');
+ if ($extUri !== '{78C0D931-6437-407d-A8EE-F0AAD7539E65}') {
+ continue;
+ }
+ $conditionalFormattingRuleXml = $extlstcond->children($this->ns['x14']);
+ if (!$conditionalFormattingRuleXml->conditionalFormattings) {
+ return [];
+ }
+
+ foreach ($conditionalFormattingRuleXml->children($this->ns['x14']) as $extFormattingXml) {
+ $extFormattingRangeXml = $extFormattingXml->children($this->ns['xm']);
+ if (!$extFormattingRangeXml->sqref) {
+ continue;
+ }
+
+ $sqref = (string) $extFormattingRangeXml->sqref;
+ $extCfRuleXml = $extFormattingXml->cfRule;
+
+ $attributes = $extCfRuleXml->attributes();
+ if (!$attributes) {
+ continue;
+ }
+ $conditionType = (string) $attributes->type;
+ if (
+ !Conditional::isValidConditionType($conditionType)
+ || $conditionType === Conditional::CONDITION_DATABAR
+ ) {
+ continue;
+ }
+
+ $priority = (int) $attributes->priority;
+
+ $conditional = $this->readConditionalRuleFromExt($extCfRuleXml, $attributes);
+ $cfStyle = $this->readStyleFromExt($extCfRuleXml);
+ $conditional->setStyle($cfStyle);
+ $conditionals[$sqref][$priority] = $conditional;
+ }
+ }
+
+ return $conditionals;
+ }
+
+ private function readConditionalRuleFromExt(SimpleXMLElement $cfRuleXml, SimpleXMLElement $attributes): Conditional
+ {
+ $conditionType = (string) $attributes->type;
+ $operatorType = (string) $attributes->operator;
+
+ $operands = [];
+ foreach ($cfRuleXml->children($this->ns['xm']) as $cfRuleOperandsXml) {
+ $operands[] = (string) $cfRuleOperandsXml;
+ }
+
+ $conditional = new Conditional();
+ $conditional->setConditionType($conditionType);
+ $conditional->setOperatorType($operatorType);
+ if (
+ $conditionType === Conditional::CONDITION_CONTAINSTEXT
+ || $conditionType === Conditional::CONDITION_NOTCONTAINSTEXT
+ || $conditionType === Conditional::CONDITION_BEGINSWITH
+ || $conditionType === Conditional::CONDITION_ENDSWITH
+ || $conditionType === Conditional::CONDITION_TIMEPERIOD
+ ) {
+ $conditional->setText(array_pop($operands) ?? '');
+ }
+ $conditional->setConditions($operands);
+
+ return $conditional;
+ }
+
+ private function readStyleFromExt(SimpleXMLElement $extCfRuleXml): Style
+ {
+ $cfStyle = new Style(false, true);
+ if ($extCfRuleXml->dxf) {
+ $styleXML = $extCfRuleXml->dxf->children();
+
+ if ($styleXML->borders) {
+ $this->styleReader->readBorderStyle($cfStyle->getBorders(), $styleXML->borders);
+ }
+ if ($styleXML->fill) {
+ $this->styleReader->readFillStyle($cfStyle->getFill(), $styleXML->fill);
+ }
+ }
+
+ return $cfStyle;
+ }
+
+ private function readConditionalStyles(SimpleXMLElement $xmlSheet): array
+ {
+ $conditionals = [];
+ foreach ($xmlSheet->conditionalFormatting as $conditional) {
+ foreach ($conditional->cfRule as $cfRule) {
+ if (Conditional::isValidConditionType((string) $cfRule['type']) && (!isset($cfRule['dxfId']) || isset($this->dxfs[(int) ($cfRule['dxfId'])]))) {
+ $conditionals[(string) $conditional['sqref']][(int) ($cfRule['priority'])] = $cfRule;
+ } elseif ((string) $cfRule['type'] == Conditional::CONDITION_DATABAR) {
+ $conditionals[(string) $conditional['sqref']][(int) ($cfRule['priority'])] = $cfRule;
+ }
+ }
+ }
+
+ return $conditionals;
+ }
+
+ private function setConditionalStyles(Worksheet $worksheet, array $conditionals, SimpleXMLElement $xmlExtLst): void
+ {
+ foreach ($conditionals as $cellRangeReference => $cfRules) {
+ ksort($cfRules);
+ $conditionalStyles = $this->readStyleRules($cfRules, $xmlExtLst);
+
+ // Extract all cell references in $cellRangeReference
+ // N.B. In Excel UI, intersection is space and union is comma.
+ // But in Xml, intersection is comma and union is space.
+ $cellRangeReference = str_replace(['$', ' ', ',', '^'], ['', '^', ' ', ','], strtoupper($cellRangeReference));
+ $worksheet->getStyle($cellRangeReference)->setConditionalStyles($conditionalStyles);
+ }
+ }
+
+ private function readStyleRules(array $cfRules, SimpleXMLElement $extLst): array
+ {
+ $conditionalFormattingRuleExtensions = ConditionalFormattingRuleExtension::parseExtLstXml($extLst);
+ $conditionalStyles = [];
+
+ /** @var SimpleXMLElement $cfRule */
+ foreach ($cfRules as $cfRule) {
+ $objConditional = new Conditional();
+ $objConditional->setConditionType((string) $cfRule['type']);
+ $objConditional->setOperatorType((string) $cfRule['operator']);
+ $objConditional->setNoFormatSet(!isset($cfRule['dxfId']));
+
+ if ((string) $cfRule['text'] != '') {
+ $objConditional->setText((string) $cfRule['text']);
+ } elseif ((string) $cfRule['timePeriod'] != '') {
+ $objConditional->setText((string) $cfRule['timePeriod']);
+ }
+
+ if (isset($cfRule['stopIfTrue']) && (int) $cfRule['stopIfTrue'] === 1) {
+ $objConditional->setStopIfTrue(true);
+ }
+
+ if (count($cfRule->formula) >= 1) {
+ foreach ($cfRule->formula as $formulax) {
+ $formula = (string) $formulax;
+ if ($formula === 'TRUE') {
+ $objConditional->addCondition(true);
+ } elseif ($formula === 'FALSE') {
+ $objConditional->addCondition(false);
+ } else {
+ $objConditional->addCondition($formula);
+ }
+ }
+ } else {
+ $objConditional->addCondition('');
+ }
+
+ if (isset($cfRule->dataBar)) {
+ $objConditional->setDataBar(
+ $this->readDataBarOfConditionalRule($cfRule, $conditionalFormattingRuleExtensions)
+ );
+ } elseif (isset($cfRule->colorScale)) {
+ $objConditional->setColorScale(
+ $this->readColorScale($cfRule)
+ );
+ } elseif (isset($cfRule['dxfId'])) {
+ $objConditional->setStyle(clone $this->dxfs[(int) ($cfRule['dxfId'])]);
+ }
+
+ $conditionalStyles[] = $objConditional;
+ }
+
+ return $conditionalStyles;
+ }
+
+ private function readDataBarOfConditionalRule(SimpleXMLElement $cfRule, array $conditionalFormattingRuleExtensions): ConditionalDataBar
+ {
+ $dataBar = new ConditionalDataBar();
+ //dataBar attribute
+ if (isset($cfRule->dataBar['showValue'])) {
+ $dataBar->setShowValue((bool) $cfRule->dataBar['showValue']);
+ }
+
+ //dataBar children
+ //conditionalFormatValueObjects
+ $cfvoXml = $cfRule->dataBar->cfvo;
+ $cfvoIndex = 0;
+ foreach ((count($cfvoXml) > 1 ? $cfvoXml : [$cfvoXml]) as $cfvo) { //* @phpstan-ignore-line
+ if ($cfvoIndex === 0) {
+ $dataBar->setMinimumConditionalFormatValueObject(new ConditionalFormatValueObject((string) $cfvo['type'], (string) $cfvo['val']));
+ }
+ if ($cfvoIndex === 1) {
+ $dataBar->setMaximumConditionalFormatValueObject(new ConditionalFormatValueObject((string) $cfvo['type'], (string) $cfvo['val']));
+ }
+ ++$cfvoIndex;
+ }
+
+ //color
+ if (isset($cfRule->dataBar->color)) {
+ $dataBar->setColor($this->styleReader->readColor($cfRule->dataBar->color));
+ }
+ //extLst
+ $this->readDataBarExtLstOfConditionalRule($dataBar, $cfRule, $conditionalFormattingRuleExtensions);
+
+ return $dataBar;
+ }
+
+ private function readColorScale(SimpleXMLElement|stdClass $cfRule): ConditionalColorScale
+ {
+ $colorScale = new ConditionalColorScale();
+ $count = count($cfRule->colorScale->cfvo);
+ $idx = 0;
+ foreach ($cfRule->colorScale->cfvo as $cfvoXml) {
+ $attr = $cfvoXml->attributes() ?? [];
+ $type = (string) ($attr['type'] ?? '');
+ $val = $attr['val'] ?? null;
+ if ($idx === 0) {
+ $method = 'setMinimumConditionalFormatValueObject';
+ } elseif ($idx === 1 && $count === 3) {
+ $method = 'setMidpointConditionalFormatValueObject';
+ } else {
+ $method = 'setMaximumConditionalFormatValueObject';
+ }
+ if ($type !== 'formula') {
+ $colorScale->$method(new ConditionalFormatValueObject($type, $val));
+ } else {
+ $colorScale->$method(new ConditionalFormatValueObject($type, null, $val));
+ }
+ ++$idx;
+ }
+ $idx = 0;
+ foreach ($cfRule->colorScale->color as $color) {
+ $rgb = $this->styleReader->readColor($color);
+ if ($idx === 0) {
+ $colorScale->setMinimumColor(new Color($rgb));
+ } elseif ($idx === 1 && $count === 3) {
+ $colorScale->setMidpointColor(new Color($rgb));
+ } else {
+ $colorScale->setMaximumColor(new Color($rgb));
+ }
+ ++$idx;
+ }
+
+ return $colorScale;
+ }
+
+ private function readDataBarExtLstOfConditionalRule(ConditionalDataBar $dataBar, SimpleXMLElement $cfRule, array $conditionalFormattingRuleExtensions): void
+ {
+ if (isset($cfRule->extLst)) {
+ $ns = $cfRule->extLst->getNamespaces(true);
+ foreach ((count($cfRule->extLst) > 0 ? $cfRule->extLst->ext : [$cfRule->extLst->ext]) as $ext) { //* @phpstan-ignore-line
+ $extId = (string) $ext->children($ns['x14'])->id;
+ if (isset($conditionalFormattingRuleExtensions[$extId]) && (string) $ext['uri'] === '{B025F937-C7B1-47D3-B67F-A62EFF666E3E}') {
+ $dataBar->setConditionalFormattingRuleExt($conditionalFormattingRuleExtensions[$extId]);
+ }
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/DataValidations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/DataValidations.php
new file mode 100644
index 00000000..d494dc9d
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/DataValidations.php
@@ -0,0 +1,65 @@
+worksheet = $workSheet;
+ $this->worksheetXml = $worksheetXml;
+ }
+
+ public function load(): void
+ {
+ foreach ($this->worksheetXml->dataValidations->dataValidation as $dataValidation) {
+ // Uppercase coordinate
+ $range = strtoupper((string) $dataValidation['sqref']);
+ $rangeSet = explode(' ', $range);
+ foreach ($rangeSet as $range) {
+ if (preg_match('/^[A-Z]{1,3}\\d{1,7}/', $range, $matches) === 1) {
+ // Ensure left/top row of range exists, thereby
+ // adjusting high row/column.
+ $this->worksheet->getCell($matches[0]);
+ }
+ }
+ }
+ foreach ($this->worksheetXml->dataValidations->dataValidation as $dataValidation) {
+ // Uppercase coordinate
+ $range = strtoupper((string) $dataValidation['sqref']);
+ $rangeSet = explode(' ', $range);
+ foreach ($rangeSet as $range) {
+ $stRange = $this->worksheet->shrinkRangeToFit($range);
+
+ // Extract all cell references in $range
+ foreach (Coordinate::extractAllCellReferencesInRange($stRange) as $reference) {
+ // Create validation
+ $docValidation = $this->worksheet->getCell($reference)->getDataValidation();
+ $docValidation->setType((string) $dataValidation['type']);
+ $docValidation->setErrorStyle((string) $dataValidation['errorStyle']);
+ $docValidation->setOperator((string) $dataValidation['operator']);
+ $docValidation->setAllowBlank(filter_var($dataValidation['allowBlank'], FILTER_VALIDATE_BOOLEAN));
+ // showDropDown is inverted (works as hideDropDown if true)
+ $docValidation->setShowDropDown(!filter_var($dataValidation['showDropDown'], FILTER_VALIDATE_BOOLEAN));
+ $docValidation->setShowInputMessage(filter_var($dataValidation['showInputMessage'], FILTER_VALIDATE_BOOLEAN));
+ $docValidation->setShowErrorMessage(filter_var($dataValidation['showErrorMessage'], FILTER_VALIDATE_BOOLEAN));
+ $docValidation->setErrorTitle((string) $dataValidation['errorTitle']);
+ $docValidation->setError((string) $dataValidation['error']);
+ $docValidation->setPromptTitle((string) $dataValidation['promptTitle']);
+ $docValidation->setPrompt((string) $dataValidation['prompt']);
+ $docValidation->setFormula1((string) $dataValidation->formula1);
+ $docValidation->setFormula2((string) $dataValidation->formula2);
+ $docValidation->setSqref($range);
+ }
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Hyperlinks.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Hyperlinks.php
new file mode 100644
index 00000000..0c5b9a1b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Hyperlinks.php
@@ -0,0 +1,64 @@
+worksheet = $workSheet;
+ }
+
+ public function readHyperlinks(SimpleXMLElement $relsWorksheet): void
+ {
+ foreach ($relsWorksheet->children(Namespaces::RELATIONSHIPS)->Relationship as $elementx) {
+ $element = Xlsx::getAttributes($elementx);
+ if ($element->Type == Namespaces::HYPERLINK) {
+ $this->hyperlinks[(string) $element->Id] = (string) $element->Target;
+ }
+ }
+ }
+
+ public function setHyperlinks(SimpleXMLElement $worksheetXml): void
+ {
+ foreach ($worksheetXml->children(Namespaces::MAIN)->hyperlink as $hyperlink) {
+ if ($hyperlink !== null) {
+ $this->setHyperlink($hyperlink, $this->worksheet);
+ }
+ }
+ }
+
+ private function setHyperlink(SimpleXMLElement $hyperlink, Worksheet $worksheet): void
+ {
+ // Link url
+ $linkRel = Xlsx::getAttributes($hyperlink, Namespaces::SCHEMA_OFFICE_DOCUMENT);
+
+ $attributes = Xlsx::getAttributes($hyperlink);
+ foreach (Coordinate::extractAllCellReferencesInRange($attributes->ref) as $cellReference) {
+ $cell = $worksheet->getCell($cellReference);
+ if (isset($linkRel['id'])) {
+ $hyperlinkUrl = $this->hyperlinks[(string) $linkRel['id']] ?? null;
+ if (isset($attributes['location'])) {
+ $hyperlinkUrl .= '#' . (string) $attributes['location'];
+ }
+ $cell->getHyperlink()->setUrl($hyperlinkUrl);
+ } elseif (isset($attributes['location'])) {
+ $cell->getHyperlink()->setUrl('sheet://' . (string) $attributes['location']);
+ }
+
+ // Tooltip
+ if (isset($attributes['tooltip'])) {
+ $cell->getHyperlink()->setTooltip((string) $attributes['tooltip']);
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Namespaces.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Namespaces.php
new file mode 100644
index 00000000..fa3e57e7
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Namespaces.php
@@ -0,0 +1,118 @@
+worksheet = $workSheet;
+ $this->worksheetXml = $worksheetXml;
+ }
+
+ public function load(array $unparsedLoadedData): array
+ {
+ $worksheetXml = $this->worksheetXml;
+ if ($worksheetXml === null) {
+ return $unparsedLoadedData;
+ }
+
+ $this->margins($worksheetXml, $this->worksheet);
+ $unparsedLoadedData = $this->pageSetup($worksheetXml, $this->worksheet, $unparsedLoadedData);
+ $this->headerFooter($worksheetXml, $this->worksheet);
+ $this->pageBreaks($worksheetXml, $this->worksheet);
+
+ return $unparsedLoadedData;
+ }
+
+ private function margins(SimpleXMLElement $xmlSheet, Worksheet $worksheet): void
+ {
+ if ($xmlSheet->pageMargins) {
+ $docPageMargins = $worksheet->getPageMargins();
+ $docPageMargins->setLeft((float) ($xmlSheet->pageMargins['left']));
+ $docPageMargins->setRight((float) ($xmlSheet->pageMargins['right']));
+ $docPageMargins->setTop((float) ($xmlSheet->pageMargins['top']));
+ $docPageMargins->setBottom((float) ($xmlSheet->pageMargins['bottom']));
+ $docPageMargins->setHeader((float) ($xmlSheet->pageMargins['header']));
+ $docPageMargins->setFooter((float) ($xmlSheet->pageMargins['footer']));
+ }
+ }
+
+ private function pageSetup(SimpleXMLElement $xmlSheet, Worksheet $worksheet, array $unparsedLoadedData): array
+ {
+ if ($xmlSheet->pageSetup) {
+ $docPageSetup = $worksheet->getPageSetup();
+
+ if (isset($xmlSheet->pageSetup['orientation'])) {
+ $docPageSetup->setOrientation((string) $xmlSheet->pageSetup['orientation']);
+ }
+ if (isset($xmlSheet->pageSetup['paperSize'])) {
+ $docPageSetup->setPaperSize((int) ($xmlSheet->pageSetup['paperSize']));
+ }
+ if (isset($xmlSheet->pageSetup['scale'])) {
+ $docPageSetup->setScale((int) ($xmlSheet->pageSetup['scale']), false);
+ }
+ if (isset($xmlSheet->pageSetup['fitToHeight']) && (int) ($xmlSheet->pageSetup['fitToHeight']) >= 0) {
+ $docPageSetup->setFitToHeight((int) ($xmlSheet->pageSetup['fitToHeight']), false);
+ }
+ if (isset($xmlSheet->pageSetup['fitToWidth']) && (int) ($xmlSheet->pageSetup['fitToWidth']) >= 0) {
+ $docPageSetup->setFitToWidth((int) ($xmlSheet->pageSetup['fitToWidth']), false);
+ }
+ if (
+ isset($xmlSheet->pageSetup['firstPageNumber'], $xmlSheet->pageSetup['useFirstPageNumber'])
+ && self::boolean((string) $xmlSheet->pageSetup['useFirstPageNumber'])
+ ) {
+ $docPageSetup->setFirstPageNumber((int) ($xmlSheet->pageSetup['firstPageNumber']));
+ }
+ if (isset($xmlSheet->pageSetup['pageOrder'])) {
+ $docPageSetup->setPageOrder((string) $xmlSheet->pageSetup['pageOrder']);
+ }
+
+ $relAttributes = $xmlSheet->pageSetup->attributes(Namespaces::SCHEMA_OFFICE_DOCUMENT);
+ if (isset($relAttributes['id'])) {
+ $relid = (string) $relAttributes['id'];
+ if (!str_ends_with($relid, 'ps')) {
+ $relid .= 'ps';
+ }
+ $unparsedLoadedData['sheets'][$worksheet->getCodeName()]['pageSetupRelId'] = $relid;
+ }
+ }
+
+ return $unparsedLoadedData;
+ }
+
+ private function headerFooter(SimpleXMLElement $xmlSheet, Worksheet $worksheet): void
+ {
+ if ($xmlSheet->headerFooter) {
+ $docHeaderFooter = $worksheet->getHeaderFooter();
+
+ if (
+ isset($xmlSheet->headerFooter['differentOddEven'])
+ && self::boolean((string) $xmlSheet->headerFooter['differentOddEven'])
+ ) {
+ $docHeaderFooter->setDifferentOddEven(true);
+ } else {
+ $docHeaderFooter->setDifferentOddEven(false);
+ }
+ if (
+ isset($xmlSheet->headerFooter['differentFirst'])
+ && self::boolean((string) $xmlSheet->headerFooter['differentFirst'])
+ ) {
+ $docHeaderFooter->setDifferentFirst(true);
+ } else {
+ $docHeaderFooter->setDifferentFirst(false);
+ }
+ if (
+ isset($xmlSheet->headerFooter['scaleWithDoc'])
+ && !self::boolean((string) $xmlSheet->headerFooter['scaleWithDoc'])
+ ) {
+ $docHeaderFooter->setScaleWithDocument(false);
+ } else {
+ $docHeaderFooter->setScaleWithDocument(true);
+ }
+ if (
+ isset($xmlSheet->headerFooter['alignWithMargins'])
+ && !self::boolean((string) $xmlSheet->headerFooter['alignWithMargins'])
+ ) {
+ $docHeaderFooter->setAlignWithMargins(false);
+ } else {
+ $docHeaderFooter->setAlignWithMargins(true);
+ }
+
+ $docHeaderFooter->setOddHeader((string) $xmlSheet->headerFooter->oddHeader);
+ $docHeaderFooter->setOddFooter((string) $xmlSheet->headerFooter->oddFooter);
+ $docHeaderFooter->setEvenHeader((string) $xmlSheet->headerFooter->evenHeader);
+ $docHeaderFooter->setEvenFooter((string) $xmlSheet->headerFooter->evenFooter);
+ $docHeaderFooter->setFirstHeader((string) $xmlSheet->headerFooter->firstHeader);
+ $docHeaderFooter->setFirstFooter((string) $xmlSheet->headerFooter->firstFooter);
+ }
+ }
+
+ private function pageBreaks(SimpleXMLElement $xmlSheet, Worksheet $worksheet): void
+ {
+ if ($xmlSheet->rowBreaks && $xmlSheet->rowBreaks->brk) {
+ $this->rowBreaks($xmlSheet, $worksheet);
+ }
+ if ($xmlSheet->colBreaks && $xmlSheet->colBreaks->brk) {
+ $this->columnBreaks($xmlSheet, $worksheet);
+ }
+ }
+
+ private function rowBreaks(SimpleXMLElement $xmlSheet, Worksheet $worksheet): void
+ {
+ foreach ($xmlSheet->rowBreaks->brk as $brk) {
+ $rowBreakMax = isset($brk['max']) ? ((int) $brk['max']) : -1;
+ if ($brk['man']) {
+ $worksheet->setBreak("A{$brk['id']}", Worksheet::BREAK_ROW, $rowBreakMax);
+ }
+ }
+ }
+
+ private function columnBreaks(SimpleXMLElement $xmlSheet, Worksheet $worksheet): void
+ {
+ foreach ($xmlSheet->colBreaks->brk as $brk) {
+ if ($brk['man']) {
+ $worksheet->setBreak(
+ Coordinate::stringFromColumnIndex(((int) $brk['id']) + 1) . '1',
+ Worksheet::BREAK_COLUMN
+ );
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Properties.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Properties.php
new file mode 100644
index 00000000..1a0517b1
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Properties.php
@@ -0,0 +1,95 @@
+securityScanner = $securityScanner;
+ $this->docProps = $docProps;
+ }
+
+ private function extractPropertyData(string $propertyData): ?SimpleXMLElement
+ {
+ // okay to omit namespace because everything will be processed by xpath
+ $obj = simplexml_load_string(
+ $this->securityScanner->scan($propertyData)
+ );
+
+ return $obj === false ? null : $obj;
+ }
+
+ public function readCoreProperties(string $propertyData): void
+ {
+ $xmlCore = $this->extractPropertyData($propertyData);
+
+ if (is_object($xmlCore)) {
+ $xmlCore->registerXPathNamespace('dc', Namespaces::DC_ELEMENTS);
+ $xmlCore->registerXPathNamespace('dcterms', Namespaces::DC_TERMS);
+ $xmlCore->registerXPathNamespace('cp', Namespaces::CORE_PROPERTIES2);
+
+ $this->docProps->setCreator($this->getArrayItem($xmlCore->xpath('dc:creator')));
+ $this->docProps->setLastModifiedBy($this->getArrayItem($xmlCore->xpath('cp:lastModifiedBy')));
+ $this->docProps->setCreated($this->getArrayItem($xmlCore->xpath('dcterms:created'))); //! respect xsi:type
+ $this->docProps->setModified($this->getArrayItem($xmlCore->xpath('dcterms:modified'))); //! respect xsi:type
+ $this->docProps->setTitle($this->getArrayItem($xmlCore->xpath('dc:title')));
+ $this->docProps->setDescription($this->getArrayItem($xmlCore->xpath('dc:description')));
+ $this->docProps->setSubject($this->getArrayItem($xmlCore->xpath('dc:subject')));
+ $this->docProps->setKeywords($this->getArrayItem($xmlCore->xpath('cp:keywords')));
+ $this->docProps->setCategory($this->getArrayItem($xmlCore->xpath('cp:category')));
+ }
+ }
+
+ public function readExtendedProperties(string $propertyData): void
+ {
+ $xmlCore = $this->extractPropertyData($propertyData);
+
+ if (is_object($xmlCore)) {
+ if (isset($xmlCore->Company)) {
+ $this->docProps->setCompany((string) $xmlCore->Company);
+ }
+ if (isset($xmlCore->Manager)) {
+ $this->docProps->setManager((string) $xmlCore->Manager);
+ }
+ if (isset($xmlCore->HyperlinkBase)) {
+ $this->docProps->setHyperlinkBase((string) $xmlCore->HyperlinkBase);
+ }
+ }
+ }
+
+ public function readCustomProperties(string $propertyData): void
+ {
+ $xmlCore = $this->extractPropertyData($propertyData);
+
+ if (is_object($xmlCore)) {
+ foreach ($xmlCore as $xmlProperty) {
+ /** @var SimpleXMLElement $xmlProperty */
+ $cellDataOfficeAttributes = $xmlProperty->attributes();
+ if (isset($cellDataOfficeAttributes['name'])) {
+ $propertyName = (string) $cellDataOfficeAttributes['name'];
+ $cellDataOfficeChildren = $xmlProperty->children('http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes');
+
+ $attributeType = $cellDataOfficeChildren->getName();
+ $attributeValue = (string) $cellDataOfficeChildren->{$attributeType};
+ $attributeValue = DocumentProperties::convertProperty($attributeValue, $attributeType);
+ $attributeType = DocumentProperties::convertPropertyType($attributeType);
+ $this->docProps->setCustomProperty($propertyName, $attributeValue, $attributeType);
+ }
+ }
+ }
+ }
+
+ private function getArrayItem(null|array|false $array): string
+ {
+ return is_array($array) ? (string) ($array[0] ?? '') : '';
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SharedFormula.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SharedFormula.php
new file mode 100644
index 00000000..fb7a3932
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SharedFormula.php
@@ -0,0 +1,26 @@
+master = $master;
+ $this->formula = $formula;
+ }
+
+ public function master(): string
+ {
+ return $this->master;
+ }
+
+ public function formula(): string
+ {
+ return $this->formula;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SheetViewOptions.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SheetViewOptions.php
new file mode 100644
index 00000000..9d71443f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SheetViewOptions.php
@@ -0,0 +1,139 @@
+worksheet = $workSheet;
+ $this->worksheetXml = $worksheetXml;
+ }
+
+ public function load(bool $readDataOnly, Styles $styleReader): void
+ {
+ if ($this->worksheetXml === null) {
+ return;
+ }
+
+ if (isset($this->worksheetXml->sheetPr)) {
+ $sheetPr = $this->worksheetXml->sheetPr;
+ $this->tabColor($sheetPr, $styleReader);
+ $this->codeName($sheetPr);
+ $this->outlines($sheetPr);
+ $this->pageSetup($sheetPr);
+ }
+
+ if (isset($this->worksheetXml->sheetFormatPr)) {
+ $this->sheetFormat($this->worksheetXml->sheetFormatPr);
+ }
+
+ if (!$readDataOnly && isset($this->worksheetXml->printOptions)) {
+ $this->printOptions($this->worksheetXml->printOptions);
+ }
+ }
+
+ private function tabColor(SimpleXMLElement $sheetPr, Styles $styleReader): void
+ {
+ if (isset($sheetPr->tabColor)) {
+ $this->worksheet->getTabColor()->setARGB($styleReader->readColor($sheetPr->tabColor));
+ }
+ }
+
+ private function codeName(SimpleXMLElement $sheetPrx): void
+ {
+ $sheetPr = $sheetPrx->attributes() ?? [];
+ if (isset($sheetPr['codeName'])) {
+ $this->worksheet->setCodeName((string) $sheetPr['codeName'], false);
+ }
+ }
+
+ private function outlines(SimpleXMLElement $sheetPr): void
+ {
+ if (isset($sheetPr->outlinePr)) {
+ $attr = $sheetPr->outlinePr->attributes() ?? [];
+ if (
+ isset($attr['summaryRight'])
+ && !self::boolean((string) $attr['summaryRight'])
+ ) {
+ $this->worksheet->setShowSummaryRight(false);
+ } else {
+ $this->worksheet->setShowSummaryRight(true);
+ }
+
+ if (
+ isset($attr['summaryBelow'])
+ && !self::boolean((string) $attr['summaryBelow'])
+ ) {
+ $this->worksheet->setShowSummaryBelow(false);
+ } else {
+ $this->worksheet->setShowSummaryBelow(true);
+ }
+ }
+ }
+
+ private function pageSetup(SimpleXMLElement $sheetPr): void
+ {
+ if (isset($sheetPr->pageSetUpPr)) {
+ $attr = $sheetPr->pageSetUpPr->attributes() ?? [];
+ if (
+ isset($attr['fitToPage'])
+ && !self::boolean((string) $attr['fitToPage'])
+ ) {
+ $this->worksheet->getPageSetup()->setFitToPage(false);
+ } else {
+ $this->worksheet->getPageSetup()->setFitToPage(true);
+ }
+ }
+ }
+
+ private function sheetFormat(SimpleXMLElement $sheetFormatPrx): void
+ {
+ $sheetFormatPr = $sheetFormatPrx->attributes() ?? [];
+ if (
+ isset($sheetFormatPr['customHeight'])
+ && self::boolean((string) $sheetFormatPr['customHeight'])
+ && isset($sheetFormatPr['defaultRowHeight'])
+ ) {
+ $this->worksheet->getDefaultRowDimension()
+ ->setRowHeight((float) $sheetFormatPr['defaultRowHeight']);
+ }
+
+ if (isset($sheetFormatPr['defaultColWidth'])) {
+ $this->worksheet->getDefaultColumnDimension()
+ ->setWidth((float) $sheetFormatPr['defaultColWidth']);
+ }
+
+ if (
+ isset($sheetFormatPr['zeroHeight'])
+ && ((string) $sheetFormatPr['zeroHeight'] === '1')
+ ) {
+ $this->worksheet->getDefaultRowDimension()->setZeroHeight(true);
+ }
+ }
+
+ private function printOptions(SimpleXMLElement $printOptionsx): void
+ {
+ $printOptions = $printOptionsx->attributes() ?? [];
+ // Spec is weird. gridLines (default false)
+ // and gridLinesSet (default true) must both be true.
+ if (isset($printOptions['gridLines']) && self::boolean((string) $printOptions['gridLines'])) {
+ if (!isset($printOptions['gridLinesSet']) || self::boolean((string) $printOptions['gridLinesSet'])) {
+ $this->worksheet->setPrintGridlines(true);
+ }
+ }
+ if (isset($printOptions['horizontalCentered']) && self::boolean((string) $printOptions['horizontalCentered'])) {
+ $this->worksheet->getPageSetup()->setHorizontalCentered(true);
+ }
+ if (isset($printOptions['verticalCentered']) && self::boolean((string) $printOptions['verticalCentered'])) {
+ $this->worksheet->getPageSetup()->setVerticalCentered(true);
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SheetViews.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SheetViews.php
new file mode 100644
index 00000000..7c4b8b28
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/SheetViews.php
@@ -0,0 +1,199 @@
+sheetViewXml = $sheetViewXml;
+ $this->sheetViewAttributes = Xlsx::testSimpleXml($sheetViewXml->attributes());
+ $this->worksheet = $workSheet;
+ }
+
+ public function load(): void
+ {
+ $this->topLeft();
+ $this->zoomScale();
+ $this->view();
+ $this->gridLines();
+ $this->headers();
+ $this->direction();
+ $this->showZeros();
+
+ $usesPanes = false;
+ if (isset($this->sheetViewXml->pane)) {
+ $this->pane();
+ $usesPanes = true;
+ }
+ if (isset($this->sheetViewXml->selection)) {
+ foreach ($this->sheetViewXml->selection as $selection) {
+ $this->selection($selection, $usesPanes);
+ }
+ }
+ }
+
+ private function zoomScale(): void
+ {
+ if (isset($this->sheetViewAttributes->zoomScale)) {
+ $zoomScale = (int) ($this->sheetViewAttributes->zoomScale);
+ if ($zoomScale <= 0) {
+ // setZoomScale will throw an Exception if the scale is less than or equals 0
+ // that is OK when manually creating documents, but we should be able to read all documents
+ $zoomScale = 100;
+ }
+
+ $this->worksheet->getSheetView()->setZoomScale($zoomScale);
+ }
+
+ if (isset($this->sheetViewAttributes->zoomScaleNormal)) {
+ $zoomScaleNormal = (int) ($this->sheetViewAttributes->zoomScaleNormal);
+ if ($zoomScaleNormal <= 0) {
+ // setZoomScaleNormal will throw an Exception if the scale is less than or equals 0
+ // that is OK when manually creating documents, but we should be able to read all documents
+ $zoomScaleNormal = 100;
+ }
+
+ $this->worksheet->getSheetView()->setZoomScaleNormal($zoomScaleNormal);
+ }
+
+ if (isset($this->sheetViewAttributes->zoomScalePageLayoutView)) {
+ $zoomScaleNormal = (int) ($this->sheetViewAttributes->zoomScalePageLayoutView);
+ if ($zoomScaleNormal > 0) {
+ $this->worksheet->getSheetView()->setZoomScalePageLayoutView($zoomScaleNormal);
+ }
+ }
+
+ if (isset($this->sheetViewAttributes->zoomScaleSheetLayoutView)) {
+ $zoomScaleNormal = (int) ($this->sheetViewAttributes->zoomScaleSheetLayoutView);
+ if ($zoomScaleNormal > 0) {
+ $this->worksheet->getSheetView()->setZoomScaleSheetLayoutView($zoomScaleNormal);
+ }
+ }
+ }
+
+ private function view(): void
+ {
+ if (isset($this->sheetViewAttributes->view)) {
+ $this->worksheet->getSheetView()->setView((string) $this->sheetViewAttributes->view);
+ }
+ }
+
+ private function topLeft(): void
+ {
+ if (isset($this->sheetViewAttributes->topLeftCell)) {
+ $this->worksheet->setTopLeftCell($this->sheetViewAttributes->topLeftCell);
+ }
+ }
+
+ private function gridLines(): void
+ {
+ if (isset($this->sheetViewAttributes->showGridLines)) {
+ $this->worksheet->setShowGridLines(
+ self::boolean((string) $this->sheetViewAttributes->showGridLines)
+ );
+ }
+ }
+
+ private function headers(): void
+ {
+ if (isset($this->sheetViewAttributes->showRowColHeaders)) {
+ $this->worksheet->setShowRowColHeaders(
+ self::boolean((string) $this->sheetViewAttributes->showRowColHeaders)
+ );
+ }
+ }
+
+ private function direction(): void
+ {
+ if (isset($this->sheetViewAttributes->rightToLeft)) {
+ $this->worksheet->setRightToLeft(
+ self::boolean((string) $this->sheetViewAttributes->rightToLeft)
+ );
+ }
+ }
+
+ private function showZeros(): void
+ {
+ if (isset($this->sheetViewAttributes->showZeros)) {
+ $this->worksheet->getSheetView()->setShowZeros(
+ self::boolean((string) $this->sheetViewAttributes->showZeros)
+ );
+ }
+ }
+
+ private function pane(): void
+ {
+ $xSplit = 0;
+ $ySplit = 0;
+ $topLeftCell = null;
+ $paneAttributes = $this->sheetViewXml->pane->attributes();
+
+ if (isset($paneAttributes->xSplit)) {
+ $xSplit = (int) ($paneAttributes->xSplit);
+ $this->worksheet->setXSplit($xSplit);
+ }
+
+ if (isset($paneAttributes->ySplit)) {
+ $ySplit = (int) ($paneAttributes->ySplit);
+ $this->worksheet->setYSplit($ySplit);
+ }
+ $paneState = isset($paneAttributes->state) ? ((string) $paneAttributes->state) : '';
+ $this->worksheet->setPaneState($paneState);
+ if (isset($paneAttributes->topLeftCell)) {
+ $topLeftCell = (string) $paneAttributes->topLeftCell;
+ $this->worksheet->setPaneTopLeftCell($topLeftCell);
+ if ($paneState === Worksheet::PANE_FROZEN) {
+ $this->worksheet->setTopLeftCell($topLeftCell);
+ }
+ }
+ $activePane = isset($paneAttributes->activePane) ? ((string) $paneAttributes->activePane) : 'topLeft';
+ $this->worksheet->setActivePane($activePane);
+ $this->activePane = $activePane;
+ if ($paneState === Worksheet::PANE_FROZEN || $paneState === Worksheet::PANE_FROZENSPLIT) {
+ $this->worksheet->freezePane(
+ Coordinate::stringFromColumnIndex($xSplit + 1) . ($ySplit + 1),
+ $topLeftCell,
+ $paneState === Worksheet::PANE_FROZENSPLIT
+ );
+ }
+ }
+
+ private function selection(?SimpleXMLElement $selection, bool $usesPanes): void
+ {
+ $attributes = ($selection === null) ? null : $selection->attributes();
+ if ($attributes !== null) {
+ $position = (string) $attributes->pane;
+ if ($usesPanes && $position === '') {
+ $position = 'topLeft';
+ }
+ $activeCell = (string) $attributes->activeCell;
+ $sqref = (string) $attributes->sqref;
+ $sqref = explode(' ', $sqref);
+ $sqref = $sqref[0];
+ if ($position === '') {
+ $this->worksheet->setSelectedCells($sqref);
+ } else {
+ $pane = new Pane($position, $sqref, $activeCell);
+ $this->worksheet->setPane($position, $pane);
+ if ($position === $this->activePane && $sqref !== '') {
+ $this->worksheet->setSelectedCells($sqref);
+ }
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Styles.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Styles.php
new file mode 100644
index 00000000..0672854a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Styles.php
@@ -0,0 +1,434 @@
+namespace = $namespace;
+ }
+
+ public function setWorkbookPalette(array $palette): void
+ {
+ $this->workbookPalette = $palette;
+ }
+
+ private function getStyleAttributes(SimpleXMLElement $value): SimpleXMLElement
+ {
+ $attr = $value->attributes('');
+ if ($attr === null || count($attr) === 0) {
+ $attr = $value->attributes($this->namespace);
+ }
+
+ return Xlsx::testSimpleXml($attr);
+ }
+
+ public function setStyleXml(SimpleXMLElement $styleXml): void
+ {
+ $this->styleXml = $styleXml;
+ }
+
+ public function setTheme(Theme $theme): void
+ {
+ $this->theme = $theme;
+ }
+
+ public function setStyleBaseData(?Theme $theme = null, array $styles = [], array $cellStyles = []): void
+ {
+ $this->theme = $theme;
+ $this->styles = $styles;
+ $this->cellStyles = $cellStyles;
+ }
+
+ public function readFontStyle(Font $fontStyle, SimpleXMLElement $fontStyleXml): void
+ {
+ if (isset($fontStyleXml->name)) {
+ $attr = $this->getStyleAttributes($fontStyleXml->name);
+ if (isset($attr['val'])) {
+ $fontStyle->setName((string) $attr['val']);
+ }
+ }
+ if (isset($fontStyleXml->sz)) {
+ $attr = $this->getStyleAttributes($fontStyleXml->sz);
+ if (isset($attr['val'])) {
+ $fontStyle->setSize((float) $attr['val']);
+ }
+ }
+ if (isset($fontStyleXml->b)) {
+ $attr = $this->getStyleAttributes($fontStyleXml->b);
+ $fontStyle->setBold(!isset($attr['val']) || self::boolean((string) $attr['val']));
+ }
+ if (isset($fontStyleXml->i)) {
+ $attr = $this->getStyleAttributes($fontStyleXml->i);
+ $fontStyle->setItalic(!isset($attr['val']) || self::boolean((string) $attr['val']));
+ }
+ if (isset($fontStyleXml->strike)) {
+ $attr = $this->getStyleAttributes($fontStyleXml->strike);
+ $fontStyle->setStrikethrough(!isset($attr['val']) || self::boolean((string) $attr['val']));
+ }
+ $fontStyle->getColor()->setARGB($this->readColor($fontStyleXml->color));
+
+ if (isset($fontStyleXml->u)) {
+ $attr = $this->getStyleAttributes($fontStyleXml->u);
+ if (!isset($attr['val'])) {
+ $fontStyle->setUnderline(Font::UNDERLINE_SINGLE);
+ } else {
+ $fontStyle->setUnderline((string) $attr['val']);
+ }
+ }
+ if (isset($fontStyleXml->vertAlign)) {
+ $attr = $this->getStyleAttributes($fontStyleXml->vertAlign);
+ if (isset($attr['val'])) {
+ $verticalAlign = strtolower((string) $attr['val']);
+ if ($verticalAlign === 'superscript') {
+ $fontStyle->setSuperscript(true);
+ } elseif ($verticalAlign === 'subscript') {
+ $fontStyle->setSubscript(true);
+ }
+ }
+ }
+ if (isset($fontStyleXml->scheme)) {
+ $attr = $this->getStyleAttributes($fontStyleXml->scheme);
+ $fontStyle->setScheme((string) $attr['val']);
+ }
+ }
+
+ private function readNumberFormat(NumberFormat $numfmtStyle, SimpleXMLElement $numfmtStyleXml): void
+ {
+ if ((string) $numfmtStyleXml['formatCode'] !== '') {
+ $numfmtStyle->setFormatCode(self::formatGeneral((string) $numfmtStyleXml['formatCode']));
+
+ return;
+ }
+ $numfmt = $this->getStyleAttributes($numfmtStyleXml);
+ if (isset($numfmt['formatCode'])) {
+ $numfmtStyle->setFormatCode(self::formatGeneral((string) $numfmt['formatCode']));
+ }
+ }
+
+ public function readFillStyle(Fill $fillStyle, SimpleXMLElement $fillStyleXml): void
+ {
+ if ($fillStyleXml->gradientFill) {
+ /** @var SimpleXMLElement $gradientFill */
+ $gradientFill = $fillStyleXml->gradientFill[0];
+ $attr = $this->getStyleAttributes($gradientFill);
+ if (!empty($attr['type'])) {
+ $fillStyle->setFillType((string) $attr['type']);
+ }
+ $fillStyle->setRotation((float) ($attr['degree']));
+ $gradientFill->registerXPathNamespace('sml', Namespaces::MAIN);
+ $fillStyle->getStartColor()->setARGB($this->readColor(self::getArrayItem($gradientFill->xpath('sml:stop[@position=0]'))->color)); //* @phpstan-ignore-line
+ $fillStyle->getEndColor()->setARGB($this->readColor(self::getArrayItem($gradientFill->xpath('sml:stop[@position=1]'))->color)); //* @phpstan-ignore-line
+ } elseif ($fillStyleXml->patternFill) {
+ $defaultFillStyle = Fill::FILL_NONE;
+ if ($fillStyleXml->patternFill->fgColor) {
+ $fillStyle->getStartColor()->setARGB($this->readColor($fillStyleXml->patternFill->fgColor, true));
+ $defaultFillStyle = Fill::FILL_SOLID;
+ }
+ if ($fillStyleXml->patternFill->bgColor) {
+ $fillStyle->getEndColor()->setARGB($this->readColor($fillStyleXml->patternFill->bgColor, true));
+ $defaultFillStyle = Fill::FILL_SOLID;
+ }
+
+ $type = '';
+ if ((string) $fillStyleXml->patternFill['patternType'] !== '') {
+ $type = (string) $fillStyleXml->patternFill['patternType'];
+ } else {
+ $attr = $this->getStyleAttributes($fillStyleXml->patternFill);
+ $type = (string) $attr['patternType'];
+ }
+ $patternType = ($type === '') ? $defaultFillStyle : $type;
+
+ $fillStyle->setFillType($patternType);
+ }
+ }
+
+ public function readBorderStyle(Borders $borderStyle, SimpleXMLElement $borderStyleXml): void
+ {
+ $diagonalUp = $this->getAttribute($borderStyleXml, 'diagonalUp');
+ $diagonalUp = self::boolean($diagonalUp);
+ $diagonalDown = $this->getAttribute($borderStyleXml, 'diagonalDown');
+ $diagonalDown = self::boolean($diagonalDown);
+ if ($diagonalUp === false) {
+ if ($diagonalDown === false) {
+ $borderStyle->setDiagonalDirection(Borders::DIAGONAL_NONE);
+ } else {
+ $borderStyle->setDiagonalDirection(Borders::DIAGONAL_DOWN);
+ }
+ } elseif ($diagonalDown === false) {
+ $borderStyle->setDiagonalDirection(Borders::DIAGONAL_UP);
+ } else {
+ $borderStyle->setDiagonalDirection(Borders::DIAGONAL_BOTH);
+ }
+
+ if (isset($borderStyleXml->left)) {
+ $this->readBorder($borderStyle->getLeft(), $borderStyleXml->left);
+ }
+ if (isset($borderStyleXml->right)) {
+ $this->readBorder($borderStyle->getRight(), $borderStyleXml->right);
+ }
+ if (isset($borderStyleXml->top)) {
+ $this->readBorder($borderStyle->getTop(), $borderStyleXml->top);
+ }
+ if (isset($borderStyleXml->bottom)) {
+ $this->readBorder($borderStyle->getBottom(), $borderStyleXml->bottom);
+ }
+ if (isset($borderStyleXml->diagonal)) {
+ $this->readBorder($borderStyle->getDiagonal(), $borderStyleXml->diagonal);
+ }
+ }
+
+ private function getAttribute(SimpleXMLElement $xml, string $attribute): string
+ {
+ $style = '';
+ if ((string) $xml[$attribute] !== '') {
+ $style = (string) $xml[$attribute];
+ } else {
+ $attr = $this->getStyleAttributes($xml);
+ if (isset($attr[$attribute])) {
+ $style = (string) $attr[$attribute];
+ }
+ }
+
+ return $style;
+ }
+
+ private function readBorder(Border $border, SimpleXMLElement $borderXml): void
+ {
+ $style = $this->getAttribute($borderXml, 'style');
+ if ($style !== '') {
+ $border->setBorderStyle((string) $style);
+ } else {
+ $border->setBorderStyle(Border::BORDER_NONE);
+ }
+ if (isset($borderXml->color)) {
+ $border->getColor()->setARGB($this->readColor($borderXml->color));
+ }
+ }
+
+ public function readAlignmentStyle(Alignment $alignment, SimpleXMLElement $alignmentXml): void
+ {
+ $horizontal = (string) $this->getAttribute($alignmentXml, 'horizontal');
+ if ($horizontal !== '') {
+ $alignment->setHorizontal($horizontal);
+ }
+ $vertical = (string) $this->getAttribute($alignmentXml, 'vertical');
+ if ($vertical !== '') {
+ $alignment->setVertical($vertical);
+ }
+
+ $textRotation = (int) $this->getAttribute($alignmentXml, 'textRotation');
+ if ($textRotation > 90) {
+ $textRotation = 90 - $textRotation;
+ }
+ $alignment->setTextRotation($textRotation);
+
+ $wrapText = $this->getAttribute($alignmentXml, 'wrapText');
+ $alignment->setWrapText(self::boolean((string) $wrapText));
+ $shrinkToFit = $this->getAttribute($alignmentXml, 'shrinkToFit');
+ $alignment->setShrinkToFit(self::boolean((string) $shrinkToFit));
+ $indent = (int) $this->getAttribute($alignmentXml, 'indent');
+ $alignment->setIndent(max($indent, 0));
+ $readingOrder = (int) $this->getAttribute($alignmentXml, 'readingOrder');
+ $alignment->setReadOrder(max($readingOrder, 0));
+ }
+
+ private static function formatGeneral(string $formatString): string
+ {
+ if ($formatString === 'GENERAL') {
+ $formatString = NumberFormat::FORMAT_GENERAL;
+ }
+
+ return $formatString;
+ }
+
+ /**
+ * Read style.
+ */
+ public function readStyle(Style $docStyle, SimpleXMLElement|stdClass $style): void
+ {
+ if ($style instanceof SimpleXMLElement) {
+ $this->readNumberFormat($docStyle->getNumberFormat(), $style->numFmt);
+ } else {
+ $docStyle->getNumberFormat()->setFormatCode(self::formatGeneral((string) $style->numFmt));
+ }
+
+ if (isset($style->font)) {
+ $this->readFontStyle($docStyle->getFont(), $style->font);
+ }
+
+ if (isset($style->fill)) {
+ $this->readFillStyle($docStyle->getFill(), $style->fill);
+ }
+
+ if (isset($style->border)) {
+ $this->readBorderStyle($docStyle->getBorders(), $style->border);
+ }
+
+ if (isset($style->alignment)) {
+ $this->readAlignmentStyle($docStyle->getAlignment(), $style->alignment);
+ }
+
+ // protection
+ if (isset($style->protection)) {
+ $this->readProtectionLocked($docStyle, $style->protection);
+ $this->readProtectionHidden($docStyle, $style->protection);
+ }
+
+ // top-level style settings
+ if (isset($style->quotePrefix)) {
+ $docStyle->setQuotePrefix((bool) $style->quotePrefix);
+ }
+ }
+
+ /**
+ * Read protection locked attribute.
+ */
+ public function readProtectionLocked(Style $docStyle, SimpleXMLElement $style): void
+ {
+ $locked = '';
+ if ((string) $style['locked'] !== '') {
+ $locked = (string) $style['locked'];
+ } else {
+ $attr = $this->getStyleAttributes($style);
+ if (isset($attr['locked'])) {
+ $locked = (string) $attr['locked'];
+ }
+ }
+ if ($locked !== '') {
+ if (self::boolean($locked)) {
+ $docStyle->getProtection()->setLocked(Protection::PROTECTION_PROTECTED);
+ } else {
+ $docStyle->getProtection()->setLocked(Protection::PROTECTION_UNPROTECTED);
+ }
+ }
+ }
+
+ /**
+ * Read protection hidden attribute.
+ */
+ public function readProtectionHidden(Style $docStyle, SimpleXMLElement $style): void
+ {
+ $hidden = '';
+ if ((string) $style['hidden'] !== '') {
+ $hidden = (string) $style['hidden'];
+ } else {
+ $attr = $this->getStyleAttributes($style);
+ if (isset($attr['hidden'])) {
+ $hidden = (string) $attr['hidden'];
+ }
+ }
+ if ($hidden !== '') {
+ if (self::boolean((string) $hidden)) {
+ $docStyle->getProtection()->setHidden(Protection::PROTECTION_PROTECTED);
+ } else {
+ $docStyle->getProtection()->setHidden(Protection::PROTECTION_UNPROTECTED);
+ }
+ }
+ }
+
+ public function readColor(SimpleXMLElement $color, bool $background = false): string
+ {
+ $attr = $this->getStyleAttributes($color);
+ if (isset($attr['rgb'])) {
+ return (string) $attr['rgb'];
+ }
+ if (isset($attr['indexed'])) {
+ $indexedColor = (int) $attr['indexed'];
+ if ($indexedColor >= count($this->workbookPalette)) {
+ return Color::indexedColor($indexedColor - 7, $background)->getARGB() ?? '';
+ }
+
+ return Color::indexedColor($indexedColor, $background, $this->workbookPalette)->getARGB() ?? '';
+ }
+ if (isset($attr['theme'])) {
+ if ($this->theme !== null) {
+ $returnColour = $this->theme->getColourByIndex((int) $attr['theme']);
+ if (isset($attr['tint'])) {
+ $tintAdjust = (float) $attr['tint'];
+ $returnColour = Color::changeBrightness($returnColour ?? '', $tintAdjust);
+ }
+
+ return 'FF' . $returnColour;
+ }
+ }
+
+ return ($background) ? 'FFFFFFFF' : 'FF000000';
+ }
+
+ public function dxfs(bool $readDataOnly = false): array
+ {
+ $dxfs = [];
+ if (!$readDataOnly && $this->styleXml) {
+ // Conditional Styles
+ if ($this->styleXml->dxfs) {
+ foreach ($this->styleXml->dxfs->dxf as $dxf) {
+ $style = new Style(false, true);
+ $this->readStyle($style, $dxf);
+ $dxfs[] = $style;
+ }
+ }
+ // Cell Styles
+ if ($this->styleXml->cellStyles) {
+ foreach ($this->styleXml->cellStyles->cellStyle as $cellStylex) {
+ $cellStyle = Xlsx::getAttributes($cellStylex);
+ if ((int) ($cellStyle['builtinId']) == 0) {
+ if (isset($this->cellStyles[(int) ($cellStyle['xfId'])])) {
+ // Set default style
+ $style = new Style();
+ $this->readStyle($style, $this->cellStyles[(int) ($cellStyle['xfId'])]);
+
+ // normal style, currently not using it for anything
+ }
+ }
+ }
+ }
+ }
+
+ return $dxfs;
+ }
+
+ public function styles(): array
+ {
+ return $this->styles;
+ }
+
+ /**
+ * Get array item.
+ *
+ * @param mixed $array (usually array, in theory can be false)
+ */
+ private static function getArrayItem(mixed $array): ?SimpleXMLElement
+ {
+ return is_array($array) ? ($array[0] ?? null) : null;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/TableReader.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/TableReader.php
new file mode 100644
index 00000000..a63c817d
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/TableReader.php
@@ -0,0 +1,116 @@
+worksheet = $workSheet;
+ $this->tableXml = $tableXml;
+ }
+
+ /**
+ * Loads Table into the Worksheet.
+ */
+ public function load(): void
+ {
+ $this->tableAttributes = $this->tableXml->attributes() ?? [];
+ // Remove all "$" in the table range
+ $tableRange = (string) preg_replace('/\$/', '', $this->tableAttributes['ref'] ?? '');
+ if (str_contains($tableRange, ':')) {
+ $this->readTable($tableRange);
+ }
+ }
+
+ /**
+ * Read Table from xml.
+ */
+ private function readTable(string $tableRange): void
+ {
+ $table = new Table($tableRange);
+ $table->setName((string) ($this->tableAttributes['displayName'] ?? ''));
+ $table->setShowHeaderRow(((string) ($this->tableAttributes['headerRowCount'] ?? '')) !== '0');
+ $table->setShowTotalsRow(((string) ($this->tableAttributes['totalsRowCount'] ?? '')) === '1');
+
+ $this->readTableAutoFilter($table, $this->tableXml->autoFilter);
+ $this->readTableColumns($table, $this->tableXml->tableColumns);
+ $this->readTableStyle($table, $this->tableXml->tableStyleInfo);
+
+ (new AutoFilter($table, $this->tableXml))->load();
+ $this->worksheet->addTable($table);
+ }
+
+ /**
+ * Reads TableAutoFilter from xml.
+ */
+ private function readTableAutoFilter(Table $table, SimpleXMLElement $autoFilterXml): void
+ {
+ if ($autoFilterXml->filterColumn === null) {
+ $table->setAllowFilter(false);
+
+ return;
+ }
+
+ foreach ($autoFilterXml->filterColumn as $filterColumn) {
+ $attributes = $filterColumn->attributes() ?? ['colId' => 0, 'hiddenButton' => 0];
+ $column = $table->getColumnByOffset((int) $attributes['colId']);
+ $column->setShowFilterButton(((string) $attributes['hiddenButton']) !== '1');
+ }
+ }
+
+ /**
+ * Reads TableColumns from xml.
+ */
+ private function readTableColumns(Table $table, SimpleXMLElement $tableColumnsXml): void
+ {
+ $offset = 0;
+ foreach ($tableColumnsXml->tableColumn as $tableColumn) {
+ $attributes = $tableColumn->attributes() ?? ['totalsRowLabel' => 0, 'totalsRowFunction' => 0];
+ $column = $table->getColumnByOffset($offset++);
+
+ if ($table->getShowTotalsRow()) {
+ if ($attributes['totalsRowLabel']) {
+ $column->setTotalsRowLabel((string) $attributes['totalsRowLabel']);
+ }
+
+ if ($attributes['totalsRowFunction']) {
+ $column->setTotalsRowFunction((string) $attributes['totalsRowFunction']);
+ }
+ }
+
+ if ($tableColumn->calculatedColumnFormula) {
+ $column->setColumnFormula((string) $tableColumn->calculatedColumnFormula);
+ }
+ }
+ }
+
+ /**
+ * Reads TableStyle from xml.
+ */
+ private function readTableStyle(Table $table, SimpleXMLElement $tableStyleInfoXml): void
+ {
+ $tableStyle = new TableStyle();
+ $attributes = $tableStyleInfoXml->attributes();
+ if ($attributes !== null) {
+ $tableStyle->setTheme((string) $attributes['name']);
+ $tableStyle->setShowRowStripes((string) $attributes['showRowStripes'] === '1');
+ $tableStyle->setShowColumnStripes((string) $attributes['showColumnStripes'] === '1');
+ $tableStyle->setShowFirstColumn((string) $attributes['showFirstColumn'] === '1');
+ $tableStyle->setShowLastColumn((string) $attributes['showLastColumn'] === '1');
+ }
+ $table->setStyle($tableStyle);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Theme.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Theme.php
new file mode 100644
index 00000000..4a31c3e1
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/Theme.php
@@ -0,0 +1,64 @@
+themeName = $themeName;
+ $this->colourSchemeName = $colourSchemeName;
+ $this->colourMap = $colourMap;
+ }
+
+ /**
+ * Not called by Reader, never accessible any other time.
+ *
+ * @codeCoverageIgnore
+ */
+ public function getThemeName(): string
+ {
+ return $this->themeName;
+ }
+
+ /**
+ * Not called by Reader, never accessible any other time.
+ *
+ * @codeCoverageIgnore
+ */
+ public function getColourSchemeName(): string
+ {
+ return $this->colourSchemeName;
+ }
+
+ /**
+ * Get colour Map Value by Position.
+ */
+ public function getColourByIndex(int $index): ?string
+ {
+ return $this->colourMap[$index] ?? null;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/WorkbookView.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/WorkbookView.php
new file mode 100644
index 00000000..70146ed4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx/WorkbookView.php
@@ -0,0 +1,141 @@
+spreadsheet = $spreadsheet;
+ }
+
+ public function viewSettings(SimpleXMLElement $xmlWorkbook, string $mainNS, array $mapSheetId, bool $readDataOnly): void
+ {
+ // Default active sheet index to the first loaded worksheet from the file
+ $this->spreadsheet->setActiveSheetIndex(0);
+
+ $workbookView = $xmlWorkbook->children($mainNS)->bookViews->workbookView;
+ if ($readDataOnly !== true && !empty($workbookView)) {
+ $workbookViewAttributes = self::testSimpleXml(self::getAttributes($workbookView));
+ // active sheet index
+ $activeTab = (int) $workbookViewAttributes->activeTab; // refers to old sheet index
+ // keep active sheet index if sheet is still loaded, else first sheet is set as the active worksheet
+ if (isset($mapSheetId[$activeTab]) && $mapSheetId[$activeTab] !== null) {
+ $this->spreadsheet->setActiveSheetIndex($mapSheetId[$activeTab]);
+ }
+
+ $this->horizontalScroll($workbookViewAttributes);
+ $this->verticalScroll($workbookViewAttributes);
+ $this->sheetTabs($workbookViewAttributes);
+ $this->minimized($workbookViewAttributes);
+ $this->autoFilterDateGrouping($workbookViewAttributes);
+ $this->firstSheet($workbookViewAttributes);
+ $this->visibility($workbookViewAttributes);
+ $this->tabRatio($workbookViewAttributes);
+ }
+ }
+
+ public static function testSimpleXml(mixed $value): SimpleXMLElement
+ {
+ return ($value instanceof SimpleXMLElement)
+ ? $value
+ : new SimpleXMLElement(' ');
+ }
+
+ public static function getAttributes(?SimpleXMLElement $value, string $ns = ''): SimpleXMLElement
+ {
+ return self::testSimpleXml($value === null ? $value : $value->attributes($ns));
+ }
+
+ /**
+ * Convert an 'xsd:boolean' XML value to a PHP boolean value.
+ * A valid 'xsd:boolean' XML value can be one of the following
+ * four values: 'true', 'false', '1', '0'. It is case sensitive.
+ *
+ * Note that just doing '(bool) $xsdBoolean' is not safe,
+ * since '(bool) "false"' returns true.
+ *
+ * @see https://www.w3.org/TR/xmlschema11-2/#boolean
+ *
+ * @param string $xsdBoolean An XML string value of type 'xsd:boolean'
+ *
+ * @return bool Boolean value
+ */
+ private function castXsdBooleanToBool(string $xsdBoolean): bool
+ {
+ if ($xsdBoolean === 'false') {
+ return false;
+ }
+
+ return (bool) $xsdBoolean;
+ }
+
+ private function horizontalScroll(SimpleXMLElement $workbookViewAttributes): void
+ {
+ if (isset($workbookViewAttributes->showHorizontalScroll)) {
+ $showHorizontalScroll = (string) $workbookViewAttributes->showHorizontalScroll;
+ $this->spreadsheet->setShowHorizontalScroll($this->castXsdBooleanToBool($showHorizontalScroll));
+ }
+ }
+
+ private function verticalScroll(SimpleXMLElement $workbookViewAttributes): void
+ {
+ if (isset($workbookViewAttributes->showVerticalScroll)) {
+ $showVerticalScroll = (string) $workbookViewAttributes->showVerticalScroll;
+ $this->spreadsheet->setShowVerticalScroll($this->castXsdBooleanToBool($showVerticalScroll));
+ }
+ }
+
+ private function sheetTabs(SimpleXMLElement $workbookViewAttributes): void
+ {
+ if (isset($workbookViewAttributes->showSheetTabs)) {
+ $showSheetTabs = (string) $workbookViewAttributes->showSheetTabs;
+ $this->spreadsheet->setShowSheetTabs($this->castXsdBooleanToBool($showSheetTabs));
+ }
+ }
+
+ private function minimized(SimpleXMLElement $workbookViewAttributes): void
+ {
+ if (isset($workbookViewAttributes->minimized)) {
+ $minimized = (string) $workbookViewAttributes->minimized;
+ $this->spreadsheet->setMinimized($this->castXsdBooleanToBool($minimized));
+ }
+ }
+
+ private function autoFilterDateGrouping(SimpleXMLElement $workbookViewAttributes): void
+ {
+ if (isset($workbookViewAttributes->autoFilterDateGrouping)) {
+ $autoFilterDateGrouping = (string) $workbookViewAttributes->autoFilterDateGrouping;
+ $this->spreadsheet->setAutoFilterDateGrouping($this->castXsdBooleanToBool($autoFilterDateGrouping));
+ }
+ }
+
+ private function firstSheet(SimpleXMLElement $workbookViewAttributes): void
+ {
+ if (isset($workbookViewAttributes->firstSheet)) {
+ $firstSheet = (string) $workbookViewAttributes->firstSheet;
+ $this->spreadsheet->setFirstSheetIndex((int) $firstSheet);
+ }
+ }
+
+ private function visibility(SimpleXMLElement $workbookViewAttributes): void
+ {
+ if (isset($workbookViewAttributes->visibility)) {
+ $visibility = (string) $workbookViewAttributes->visibility;
+ $this->spreadsheet->setVisibility($visibility);
+ }
+ }
+
+ private function tabRatio(SimpleXMLElement $workbookViewAttributes): void
+ {
+ if (isset($workbookViewAttributes->tabRatio)) {
+ $tabRatio = (string) $workbookViewAttributes->tabRatio;
+ $this->spreadsheet->setTabRatio((int) $tabRatio);
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml.php
new file mode 100644
index 00000000..2a68f16b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml.php
@@ -0,0 +1,716 @@
+securityScanner = XmlScanner::getInstance($this);
+ }
+
+ private string $fileContents = '';
+
+ private string $xmlFailMessage = '';
+
+ public static function xmlMappings(): array
+ {
+ return array_merge(
+ Style\Fill::FILL_MAPPINGS,
+ Style\Border::BORDER_MAPPINGS
+ );
+ }
+
+ /**
+ * Can the current IReader read the file?
+ */
+ public function canRead(string $filename): bool
+ {
+ // Office xmlns:o="urn:schemas-microsoft-com:office:office"
+ // Excel xmlns:x="urn:schemas-microsoft-com:office:excel"
+ // XML Spreadsheet xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet"
+ // Spreadsheet component xmlns:c="urn:schemas-microsoft-com:office:component:spreadsheet"
+ // XML schema xmlns:s="uuid:BDC6E3F0-6DA3-11d1-A2A3-00AA00C14882"
+ // XML data type xmlns:dt="uuid:C2F41010-65B3-11d1-A29F-00AA00C14882"
+ // MS-persist recordset xmlns:rs="urn:schemas-microsoft-com:rowset"
+ // Rowset xmlns:z="#RowsetSchema"
+ //
+
+ $signature = [
+ 'getSecurityScannerOrThrow()->scan($data);
+
+ // Why?
+ //$data = str_replace("'", '"', $data); // fix headers with single quote
+
+ $valid = true;
+ foreach ($signature as $match) {
+ // every part of the signature must be present
+ if (!str_contains($data, $match)) {
+ $valid = false;
+
+ break;
+ }
+ }
+ $this->fileContents = $data;
+
+ return $valid;
+ }
+
+ /**
+ * Check if the file is a valid SimpleXML.
+ *
+ * @return false|SimpleXMLElement
+ *
+ * @deprecated 2.0.1 Should never have had public visibility
+ *
+ * @codeCoverageIgnore
+ */
+ public function trySimpleXMLLoadString(string $filename, string $fileOrString = 'file'): SimpleXMLElement|bool
+ {
+ return $this->trySimpleXMLLoadStringPrivate($filename, $fileOrString);
+ }
+
+ /** @return false|SimpleXMLElement */
+ private function trySimpleXMLLoadStringPrivate(string $filename, string $fileOrString = 'file'): SimpleXMLElement|bool
+ {
+ $this->xmlFailMessage = "Cannot load invalid XML $fileOrString: " . $filename;
+ $xml = false;
+
+ try {
+ $data = $this->fileContents;
+ $continue = true;
+ if ($data === '' && $fileOrString === 'file') {
+ if ($filename === '') {
+ $this->xmlFailMessage = 'Cannot load empty path';
+ $continue = false;
+ } else {
+ $datax = @file_get_contents($filename);
+ $data = $datax ?: '';
+ $continue = $datax !== false;
+ }
+ }
+ if ($continue) {
+ $xml = @simplexml_load_string(
+ $this->getSecurityScannerOrThrow()->scan($data)
+ );
+ }
+ } catch (Throwable $e) {
+ throw new Exception($this->xmlFailMessage, 0, $e);
+ }
+ $this->fileContents = '';
+
+ return $xml;
+ }
+
+ /**
+ * Reads names of the worksheets from a file, without parsing the whole file to a Spreadsheet object.
+ */
+ public function listWorksheetNames(string $filename): array
+ {
+ File::assertFile($filename);
+ if (!$this->canRead($filename)) {
+ throw new Exception($filename . ' is an Invalid Spreadsheet file.');
+ }
+
+ $worksheetNames = [];
+
+ $xml = $this->trySimpleXMLLoadStringPrivate($filename);
+ if ($xml === false) {
+ throw new Exception("Problem reading {$filename}");
+ }
+
+ $xml_ss = $xml->children(self::NAMESPACES_SS);
+ foreach ($xml_ss->Worksheet as $worksheet) {
+ $worksheet_ss = self::getAttributes($worksheet, self::NAMESPACES_SS);
+ $worksheetNames[] = (string) $worksheet_ss['Name'];
+ }
+
+ return $worksheetNames;
+ }
+
+ /**
+ * Return worksheet info (Name, Last Column Letter, Last Column Index, Total Rows, Total Columns).
+ */
+ public function listWorksheetInfo(string $filename): array
+ {
+ File::assertFile($filename);
+ if (!$this->canRead($filename)) {
+ throw new Exception($filename . ' is an Invalid Spreadsheet file.');
+ }
+
+ $worksheetInfo = [];
+
+ $xml = $this->trySimpleXMLLoadStringPrivate($filename);
+ if ($xml === false) {
+ throw new Exception("Problem reading {$filename}");
+ }
+
+ $worksheetID = 1;
+ $xml_ss = $xml->children(self::NAMESPACES_SS);
+ foreach ($xml_ss->Worksheet as $worksheet) {
+ $worksheet_ss = self::getAttributes($worksheet, self::NAMESPACES_SS);
+
+ $tmpInfo = [];
+ $tmpInfo['worksheetName'] = '';
+ $tmpInfo['lastColumnLetter'] = 'A';
+ $tmpInfo['lastColumnIndex'] = 0;
+ $tmpInfo['totalRows'] = 0;
+ $tmpInfo['totalColumns'] = 0;
+
+ $tmpInfo['worksheetName'] = "Worksheet_{$worksheetID}";
+ if (isset($worksheet_ss['Name'])) {
+ $tmpInfo['worksheetName'] = (string) $worksheet_ss['Name'];
+ }
+
+ if (isset($worksheet->Table->Row)) {
+ $rowIndex = 0;
+
+ foreach ($worksheet->Table->Row as $rowData) {
+ $columnIndex = 0;
+ $rowHasData = false;
+
+ foreach ($rowData->Cell as $cell) {
+ if (isset($cell->Data)) {
+ $tmpInfo['lastColumnIndex'] = max($tmpInfo['lastColumnIndex'], $columnIndex);
+ $rowHasData = true;
+ }
+
+ ++$columnIndex;
+ }
+
+ ++$rowIndex;
+
+ if ($rowHasData) {
+ $tmpInfo['totalRows'] = max($tmpInfo['totalRows'], $rowIndex);
+ }
+ }
+ }
+
+ $tmpInfo['lastColumnLetter'] = Coordinate::stringFromColumnIndex($tmpInfo['lastColumnIndex'] + 1);
+ $tmpInfo['totalColumns'] = $tmpInfo['lastColumnIndex'] + 1;
+
+ $worksheetInfo[] = $tmpInfo;
+ ++$worksheetID;
+ }
+
+ return $worksheetInfo;
+ }
+
+ /**
+ * Loads Spreadsheet from string.
+ */
+ public function loadSpreadsheetFromString(string $contents): Spreadsheet
+ {
+ // Create new Spreadsheet
+ $spreadsheet = new Spreadsheet();
+ $spreadsheet->removeSheetByIndex(0);
+
+ // Load into this instance
+ return $this->loadIntoExisting($contents, $spreadsheet, true);
+ }
+
+ /**
+ * Loads Spreadsheet from file.
+ */
+ protected function loadSpreadsheetFromFile(string $filename): Spreadsheet
+ {
+ // Create new Spreadsheet
+ $spreadsheet = new Spreadsheet();
+ $spreadsheet->removeSheetByIndex(0);
+
+ // Load into this instance
+ return $this->loadIntoExisting($filename, $spreadsheet);
+ }
+
+ /**
+ * Loads from file or contents into Spreadsheet instance.
+ *
+ * @param string $filename file name if useContents is false else file contents
+ */
+ public function loadIntoExisting(string $filename, Spreadsheet $spreadsheet, bool $useContents = false): Spreadsheet
+ {
+ if ($useContents) {
+ $this->fileContents = $filename;
+ $fileOrString = 'string';
+ } else {
+ File::assertFile($filename);
+ if (!$this->canRead($filename)) {
+ throw new Exception($filename . ' is an Invalid Spreadsheet file.');
+ }
+ $fileOrString = 'file';
+ }
+
+ $xml = $this->trySimpleXMLLoadStringPrivate($filename, $fileOrString);
+ if ($xml === false) {
+ throw new Exception($this->xmlFailMessage);
+ }
+
+ $namespaces = $xml->getNamespaces(true);
+
+ (new Properties($spreadsheet))->readProperties($xml, $namespaces);
+
+ $this->styles = (new Style())->parseStyles($xml, $namespaces);
+ if (isset($this->styles['Default'])) {
+ $spreadsheet->getCellXfCollection()[0]->applyFromArray($this->styles['Default']);
+ }
+
+ $worksheetID = 0;
+ $xml_ss = $xml->children(self::NAMESPACES_SS);
+
+ /** @var null|SimpleXMLElement $worksheetx */
+ foreach ($xml_ss->Worksheet as $worksheetx) {
+ $worksheet = $worksheetx ?? new SimpleXMLElement(' ');
+ $worksheet_ss = self::getAttributes($worksheet, self::NAMESPACES_SS);
+
+ if (
+ isset($this->loadSheetsOnly, $worksheet_ss['Name'])
+ && (!in_array($worksheet_ss['Name'], $this->loadSheetsOnly))
+ ) {
+ continue;
+ }
+
+ // Create new Worksheet
+ $spreadsheet->createSheet();
+ $spreadsheet->setActiveSheetIndex($worksheetID);
+ $worksheetName = '';
+ if (isset($worksheet_ss['Name'])) {
+ $worksheetName = (string) $worksheet_ss['Name'];
+ // Use false for $updateFormulaCellReferences to prevent adjustment of worksheet references in
+ // formula cells... during the load, all formulae should be correct, and we're simply bringing
+ // the worksheet name in line with the formula, not the reverse
+ $spreadsheet->getActiveSheet()->setTitle($worksheetName, false, false);
+ }
+ if (isset($worksheet_ss['Protected'])) {
+ $protection = (string) $worksheet_ss['Protected'] === '1';
+ $spreadsheet->getActiveSheet()->getProtection()->setSheet($protection);
+ }
+
+ // locally scoped defined names
+ if (isset($worksheet->Names[0])) {
+ foreach ($worksheet->Names[0] as $definedName) {
+ $definedName_ss = self::getAttributes($definedName, self::NAMESPACES_SS);
+ $name = (string) $definedName_ss['Name'];
+ $definedValue = (string) $definedName_ss['RefersTo'];
+ $convertedValue = AddressHelper::convertFormulaToA1($definedValue);
+ if ($convertedValue[0] === '=') {
+ $convertedValue = substr($convertedValue, 1);
+ }
+ $spreadsheet->addDefinedName(DefinedName::createInstance($name, $spreadsheet->getActiveSheet(), $convertedValue, true));
+ }
+ }
+
+ $columnID = 'A';
+ if (isset($worksheet->Table->Column)) {
+ foreach ($worksheet->Table->Column as $columnData) {
+ $columnData_ss = self::getAttributes($columnData, self::NAMESPACES_SS);
+ $colspan = 0;
+ if (isset($columnData_ss['Span'])) {
+ $spanAttr = (string) $columnData_ss['Span'];
+ if (is_numeric($spanAttr)) {
+ $colspan = max(0, (int) $spanAttr);
+ }
+ }
+ if (isset($columnData_ss['Index'])) {
+ $columnID = Coordinate::stringFromColumnIndex((int) $columnData_ss['Index']);
+ }
+ $columnWidth = null;
+ if (isset($columnData_ss['Width'])) {
+ $columnWidth = $columnData_ss['Width'];
+ }
+ $columnVisible = null;
+ if (isset($columnData_ss['Hidden'])) {
+ $columnVisible = ((string) $columnData_ss['Hidden']) !== '1';
+ }
+ while ($colspan >= 0) {
+ if (isset($columnWidth)) {
+ $spreadsheet->getActiveSheet()->getColumnDimension($columnID)->setWidth($columnWidth / 5.4);
+ }
+ if (isset($columnVisible)) {
+ $spreadsheet->getActiveSheet()->getColumnDimension($columnID)->setVisible($columnVisible);
+ }
+ ++$columnID;
+ --$colspan;
+ }
+ }
+ }
+
+ $rowID = 1;
+ if (isset($worksheet->Table->Row)) {
+ $additionalMergedCells = 0;
+ foreach ($worksheet->Table->Row as $rowData) {
+ $rowHasData = false;
+ $row_ss = self::getAttributes($rowData, self::NAMESPACES_SS);
+ if (isset($row_ss['Index'])) {
+ $rowID = (int) $row_ss['Index'];
+ }
+ if (isset($row_ss['Hidden'])) {
+ $rowVisible = ((string) $row_ss['Hidden']) !== '1';
+ $spreadsheet->getActiveSheet()->getRowDimension($rowID)->setVisible($rowVisible);
+ }
+
+ $columnID = 'A';
+ foreach ($rowData->Cell as $cell) {
+ $cell_ss = self::getAttributes($cell, self::NAMESPACES_SS);
+ if (isset($cell_ss['Index'])) {
+ $columnID = Coordinate::stringFromColumnIndex((int) $cell_ss['Index']);
+ }
+ $cellRange = $columnID . $rowID;
+
+ if ($this->getReadFilter() !== null) {
+ if (!$this->getReadFilter()->readCell($columnID, $rowID, $worksheetName)) {
+ ++$columnID;
+
+ continue;
+ }
+ }
+
+ if (isset($cell_ss['HRef'])) {
+ $spreadsheet->getActiveSheet()->getCell($cellRange)->getHyperlink()->setUrl((string) $cell_ss['HRef']);
+ }
+
+ if ((isset($cell_ss['MergeAcross'])) || (isset($cell_ss['MergeDown']))) {
+ $columnTo = $columnID;
+ if (isset($cell_ss['MergeAcross'])) {
+ $additionalMergedCells += (int) $cell_ss['MergeAcross'];
+ $columnTo = Coordinate::stringFromColumnIndex((int) (Coordinate::columnIndexFromString($columnID) + $cell_ss['MergeAcross']));
+ }
+ $rowTo = $rowID;
+ if (isset($cell_ss['MergeDown'])) {
+ $rowTo = $rowTo + $cell_ss['MergeDown'];
+ }
+ $cellRange .= ':' . $columnTo . $rowTo;
+ $spreadsheet->getActiveSheet()->mergeCells($cellRange, Worksheet::MERGE_CELL_CONTENT_HIDE);
+ }
+
+ $hasCalculatedValue = false;
+ $cellDataFormula = '';
+ if (isset($cell_ss['Formula'])) {
+ $cellDataFormula = $cell_ss['Formula'];
+ $hasCalculatedValue = true;
+ }
+ if (isset($cell->Data)) {
+ $cellData = $cell->Data;
+ $cellValue = (string) $cellData;
+ $type = DataType::TYPE_NULL;
+ $cellData_ss = self::getAttributes($cellData, self::NAMESPACES_SS);
+ if (isset($cellData_ss['Type'])) {
+ $cellDataType = $cellData_ss['Type'];
+ switch ($cellDataType) {
+ /*
+ const TYPE_STRING = 's';
+ const TYPE_FORMULA = 'f';
+ const TYPE_NUMERIC = 'n';
+ const TYPE_BOOL = 'b';
+ const TYPE_NULL = 'null';
+ const TYPE_INLINE = 'inlineStr';
+ const TYPE_ERROR = 'e';
+ */
+ case 'String':
+ $type = DataType::TYPE_STRING;
+ $rich = $cellData->children('http://www.w3.org/TR/REC-html40');
+ if ($rich) {
+ // in case of HTML content we extract the payload
+ // and convert it into a rich text object
+ $content = $cellData->asXML() ?: '';
+ $html = new HelperHtml();
+ $cellValue = $html->toRichTextObject($content, true);
+ }
+
+ break;
+ case 'Number':
+ $type = DataType::TYPE_NUMERIC;
+ $cellValue = (float) $cellValue;
+ if (floor($cellValue) == $cellValue) {
+ $cellValue = (int) $cellValue;
+ }
+
+ break;
+ case 'Boolean':
+ $type = DataType::TYPE_BOOL;
+ $cellValue = ($cellValue != 0);
+
+ break;
+ case 'DateTime':
+ $type = DataType::TYPE_NUMERIC;
+ $dateTime = new DateTime($cellValue, new DateTimeZone('UTC'));
+ $cellValue = Date::PHPToExcel($dateTime);
+
+ break;
+ case 'Error':
+ $type = DataType::TYPE_ERROR;
+ $hasCalculatedValue = false;
+
+ break;
+ }
+ }
+
+ $originalType = $type;
+ if ($hasCalculatedValue) {
+ $type = DataType::TYPE_FORMULA;
+ $columnNumber = Coordinate::columnIndexFromString($columnID);
+ $cellDataFormula = AddressHelper::convertFormulaToA1($cellDataFormula, $rowID, $columnNumber);
+ }
+
+ $spreadsheet->getActiveSheet()->getCell($columnID . $rowID)->setValueExplicit((($hasCalculatedValue) ? $cellDataFormula : $cellValue), $type);
+ if ($hasCalculatedValue) {
+ $spreadsheet->getActiveSheet()->getCell($columnID . $rowID)->setCalculatedValue($cellValue, $originalType === DataType::TYPE_NUMERIC);
+ }
+ $rowHasData = true;
+ }
+
+ if (isset($cell->Comment)) {
+ $this->parseCellComment($cell->Comment, $spreadsheet, $columnID, $rowID);
+ }
+
+ if (isset($cell_ss['StyleID'])) {
+ $style = (string) $cell_ss['StyleID'];
+ if ((isset($this->styles[$style])) && (!empty($this->styles[$style]))) {
+ //if (!$spreadsheet->getActiveSheet()->cellExists($columnID . $rowID)) {
+ // $spreadsheet->getActiveSheet()->getCell($columnID . $rowID)->setValue(null);
+ //}
+ $spreadsheet->getActiveSheet()->getStyle($cellRange)
+ ->applyFromArray($this->styles[$style]);
+ }
+ }
+ ++$columnID;
+ while ($additionalMergedCells > 0) {
+ ++$columnID;
+ --$additionalMergedCells;
+ }
+ }
+
+ if ($rowHasData) {
+ if (isset($row_ss['Height'])) {
+ $rowHeight = $row_ss['Height'];
+ $spreadsheet->getActiveSheet()->getRowDimension($rowID)->setRowHeight((float) $rowHeight);
+ }
+ }
+
+ ++$rowID;
+ }
+ }
+
+ $dataValidations = new Xml\DataValidations();
+ $dataValidations->loadDataValidations($worksheet, $spreadsheet);
+ $xmlX = $worksheet->children(Namespaces::URN_EXCEL);
+ if (isset($xmlX->WorksheetOptions)) {
+ if (isset($xmlX->WorksheetOptions->ShowPageBreakZoom)) {
+ $spreadsheet->getActiveSheet()->getSheetView()->setView(SheetView::SHEETVIEW_PAGE_BREAK_PREVIEW);
+ }
+ if (isset($xmlX->WorksheetOptions->Zoom)) {
+ $zoomScaleNormal = (int) $xmlX->WorksheetOptions->Zoom;
+ if ($zoomScaleNormal > 0) {
+ $spreadsheet->getActiveSheet()->getSheetView()->setZoomScaleNormal($zoomScaleNormal);
+ $spreadsheet->getActiveSheet()->getSheetView()->setZoomScale($zoomScaleNormal);
+ }
+ }
+ if (isset($xmlX->WorksheetOptions->PageBreakZoom)) {
+ $zoomScaleNormal = (int) $xmlX->WorksheetOptions->PageBreakZoom;
+ if ($zoomScaleNormal > 0) {
+ $spreadsheet->getActiveSheet()->getSheetView()->setZoomScaleSheetLayoutView($zoomScaleNormal);
+ }
+ }
+ if (isset($xmlX->WorksheetOptions->ShowPageBreakZoom)) {
+ $spreadsheet->getActiveSheet()->getSheetView()->setView(SheetView::SHEETVIEW_PAGE_BREAK_PREVIEW);
+ }
+ if (isset($xmlX->WorksheetOptions->FreezePanes)) {
+ $freezeRow = $freezeColumn = 1;
+ if (isset($xmlX->WorksheetOptions->SplitHorizontal)) {
+ $freezeRow = (int) $xmlX->WorksheetOptions->SplitHorizontal + 1;
+ }
+ if (isset($xmlX->WorksheetOptions->SplitVertical)) {
+ $freezeColumn = (int) $xmlX->WorksheetOptions->SplitVertical + 1;
+ }
+ $leftTopRow = (string) $xmlX->WorksheetOptions->TopRowBottomPane;
+ $leftTopColumn = (string) $xmlX->WorksheetOptions->LeftColumnRightPane;
+ if (is_numeric($leftTopRow) && is_numeric($leftTopColumn)) {
+ $leftTopCoordinate = Coordinate::stringFromColumnIndex((int) $leftTopColumn + 1) . (string) ($leftTopRow + 1);
+ $spreadsheet->getActiveSheet()->freezePane(Coordinate::stringFromColumnIndex($freezeColumn) . (string) $freezeRow, $leftTopCoordinate, !isset($xmlX->WorksheetOptions->FrozenNoSplit));
+ } else {
+ $spreadsheet->getActiveSheet()->freezePane(Coordinate::stringFromColumnIndex($freezeColumn) . (string) $freezeRow, null, !isset($xmlX->WorksheetOptions->FrozenNoSplit));
+ }
+ } elseif (isset($xmlX->WorksheetOptions->SplitVertical) || isset($xmlX->WorksheetOptions->SplitHorizontal)) {
+ if (isset($xmlX->WorksheetOptions->SplitHorizontal)) {
+ $ySplit = (int) $xmlX->WorksheetOptions->SplitHorizontal;
+ $spreadsheet->getActiveSheet()->setYSplit($ySplit);
+ }
+ if (isset($xmlX->WorksheetOptions->SplitVertical)) {
+ $xSplit = (int) $xmlX->WorksheetOptions->SplitVertical;
+ $spreadsheet->getActiveSheet()->setXSplit($xSplit);
+ }
+ if (isset($xmlX->WorksheetOptions->LeftColumnVisible) || isset($xmlX->WorksheetOptions->TopRowVisible)) {
+ $leftTopColumn = $leftTopRow = 1;
+ if (isset($xmlX->WorksheetOptions->LeftColumnVisible)) {
+ $leftTopColumn = 1 + (int) $xmlX->WorksheetOptions->LeftColumnVisible;
+ }
+ if (isset($xmlX->WorksheetOptions->TopRowVisible)) {
+ $leftTopRow = 1 + (int) $xmlX->WorksheetOptions->TopRowVisible;
+ }
+ $leftTopCoordinate = Coordinate::stringFromColumnIndex($leftTopColumn) . "$leftTopRow";
+ $spreadsheet->getActiveSheet()->setTopLeftCell($leftTopCoordinate);
+ }
+
+ $leftTopColumn = $leftTopRow = 1;
+ if (isset($xmlX->WorksheetOptions->LeftColumnRightPane)) {
+ $leftTopColumn = 1 + (int) $xmlX->WorksheetOptions->LeftColumnRightPane;
+ }
+ if (isset($xmlX->WorksheetOptions->TopRowBottomPane)) {
+ $leftTopRow = 1 + (int) $xmlX->WorksheetOptions->TopRowBottomPane;
+ }
+ $leftTopCoordinate = Coordinate::stringFromColumnIndex($leftTopColumn) . "$leftTopRow";
+ $spreadsheet->getActiveSheet()->setPaneTopLeftCell($leftTopCoordinate);
+ }
+ (new PageSettings($xmlX))->loadPageSettings($spreadsheet);
+ if (isset($xmlX->WorksheetOptions->TopRowVisible, $xmlX->WorksheetOptions->LeftColumnVisible)) {
+ $leftTopRow = (string) $xmlX->WorksheetOptions->TopRowVisible;
+ $leftTopColumn = (string) $xmlX->WorksheetOptions->LeftColumnVisible;
+ if (is_numeric($leftTopRow) && is_numeric($leftTopColumn)) {
+ $leftTopCoordinate = Coordinate::stringFromColumnIndex((int) $leftTopColumn + 1) . (string) ($leftTopRow + 1);
+ $spreadsheet->getActiveSheet()->setTopLeftCell($leftTopCoordinate);
+ }
+ }
+ $rangeCalculated = false;
+ if (isset($xmlX->WorksheetOptions->Panes->Pane->RangeSelection)) {
+ if (1 === preg_match('/^R(\d+)C(\d+):R(\d+)C(\d+)$/', (string) $xmlX->WorksheetOptions->Panes->Pane->RangeSelection, $selectionMatches)) {
+ $selectedCell = Coordinate::stringFromColumnIndex((int) $selectionMatches[2])
+ . $selectionMatches[1]
+ . ':'
+ . Coordinate::stringFromColumnIndex((int) $selectionMatches[4])
+ . $selectionMatches[3];
+ $spreadsheet->getActiveSheet()->setSelectedCells($selectedCell);
+ $rangeCalculated = true;
+ }
+ }
+ if (!$rangeCalculated) {
+ if (isset($xmlX->WorksheetOptions->Panes->Pane->ActiveRow)) {
+ $activeRow = (string) $xmlX->WorksheetOptions->Panes->Pane->ActiveRow;
+ } else {
+ $activeRow = 0;
+ }
+ if (isset($xmlX->WorksheetOptions->Panes->Pane->ActiveCol)) {
+ $activeColumn = (string) $xmlX->WorksheetOptions->Panes->Pane->ActiveCol;
+ } else {
+ $activeColumn = 0;
+ }
+ if (is_numeric($activeRow) && is_numeric($activeColumn)) {
+ $selectedCell = Coordinate::stringFromColumnIndex((int) $activeColumn + 1) . (string) ($activeRow + 1);
+ $spreadsheet->getActiveSheet()->setSelectedCells($selectedCell);
+ }
+ }
+ }
+ if (isset($xmlX->PageBreaks)) {
+ if (isset($xmlX->PageBreaks->ColBreaks)) {
+ foreach ($xmlX->PageBreaks->ColBreaks->ColBreak as $colBreak) {
+ $colBreak = (string) $colBreak->Column;
+ $spreadsheet->getActiveSheet()->setBreak([1 + (int) $colBreak, 1], Worksheet::BREAK_COLUMN);
+ }
+ }
+ if (isset($xmlX->PageBreaks->RowBreaks)) {
+ foreach ($xmlX->PageBreaks->RowBreaks->RowBreak as $rowBreak) {
+ $rowBreak = (string) $rowBreak->Row;
+ $spreadsheet->getActiveSheet()->setBreak([1, (int) $rowBreak], Worksheet::BREAK_ROW);
+ }
+ }
+ }
+ ++$worksheetID;
+ }
+
+ // Globally scoped defined names
+ $activeSheetIndex = 0;
+ if (isset($xml->ExcelWorkbook->ActiveSheet)) {
+ $activeSheetIndex = (int) (string) $xml->ExcelWorkbook->ActiveSheet;
+ }
+ $activeWorksheet = $spreadsheet->setActiveSheetIndex($activeSheetIndex);
+ if (isset($xml->Names[0])) {
+ foreach ($xml->Names[0] as $definedName) {
+ $definedName_ss = self::getAttributes($definedName, self::NAMESPACES_SS);
+ $name = (string) $definedName_ss['Name'];
+ $definedValue = (string) $definedName_ss['RefersTo'];
+ $convertedValue = AddressHelper::convertFormulaToA1($definedValue);
+ if ($convertedValue[0] === '=') {
+ $convertedValue = substr($convertedValue, 1);
+ }
+ $spreadsheet->addDefinedName(DefinedName::createInstance($name, $activeWorksheet, $convertedValue));
+ }
+ }
+
+ // Return
+ return $spreadsheet;
+ }
+
+ protected function parseCellComment(
+ SimpleXMLElement $comment,
+ Spreadsheet $spreadsheet,
+ string $columnID,
+ int $rowID
+ ): void {
+ $commentAttributes = $comment->attributes(self::NAMESPACES_SS);
+ $author = 'unknown';
+ if (isset($commentAttributes->Author)) {
+ $author = (string) $commentAttributes->Author;
+ }
+
+ $node = $comment->Data->asXML();
+ $annotation = strip_tags((string) $node);
+ $spreadsheet->getActiveSheet()->getComment($columnID . $rowID)
+ ->setAuthor($author)
+ ->setText($this->parseRichText($annotation));
+ }
+
+ protected function parseRichText(string $annotation): RichText
+ {
+ $value = new RichText();
+
+ $value->createText($annotation);
+
+ return $value;
+ }
+
+ private static function getAttributes(?SimpleXMLElement $simple, string $node): SimpleXMLElement
+ {
+ return ($simple === null)
+ ? new SimpleXMLElement(' ')
+ : ($simple->attributes($node) ?? new SimpleXMLElement(' '));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/DataValidations.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/DataValidations.php
new file mode 100644
index 00000000..531f8c35
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/DataValidations.php
@@ -0,0 +1,177 @@
+ DataValidation::OPERATOR_BETWEEN,
+ 'equal' => DataValidation::OPERATOR_EQUAL,
+ 'greater' => DataValidation::OPERATOR_GREATERTHAN,
+ 'greaterorequal' => DataValidation::OPERATOR_GREATERTHANOREQUAL,
+ 'less' => DataValidation::OPERATOR_LESSTHAN,
+ 'lessorequal' => DataValidation::OPERATOR_LESSTHANOREQUAL,
+ 'notbetween' => DataValidation::OPERATOR_NOTBETWEEN,
+ 'notequal' => DataValidation::OPERATOR_NOTEQUAL,
+ ];
+
+ private const TYPE_MAPPINGS = [
+ 'textlength' => DataValidation::TYPE_TEXTLENGTH,
+ ];
+
+ private int $thisRow = 0;
+
+ private int $thisColumn = 0;
+
+ private function replaceR1C1(array $matches): string
+ {
+ return AddressHelper::convertToA1($matches[0], $this->thisRow, $this->thisColumn, false);
+ }
+
+ public function loadDataValidations(SimpleXMLElement $worksheet, Spreadsheet $spreadsheet): void
+ {
+ $xmlX = $worksheet->children(Namespaces::URN_EXCEL);
+ $sheet = $spreadsheet->getActiveSheet();
+ /** @var callable $pregCallback */
+ $pregCallback = [$this, 'replaceR1C1'];
+ foreach ($xmlX->DataValidation as $dataValidation) {
+ $cells = [];
+ $validation = new DataValidation();
+
+ // set defaults
+ $validation->setShowDropDown(true);
+ $validation->setShowInputMessage(true);
+ $validation->setShowErrorMessage(true);
+ $validation->setShowDropDown(true);
+ $this->thisRow = 1;
+ $this->thisColumn = 1;
+
+ foreach ($dataValidation as $tagName => $tagValue) {
+ $tagValue = (string) $tagValue;
+ $tagValueLower = strtolower($tagValue);
+ switch ($tagName) {
+ case 'Range':
+ foreach (explode(',', $tagValue) as $range) {
+ $cell = '';
+ if (preg_match('/^R(\d+)C(\d+):R(\d+)C(\d+)$/', (string) $range, $selectionMatches) === 1) {
+ // range
+ $firstCell = Coordinate::stringFromColumnIndex((int) $selectionMatches[2])
+ . $selectionMatches[1];
+ $cell = $firstCell
+ . ':'
+ . Coordinate::stringFromColumnIndex((int) $selectionMatches[4])
+ . $selectionMatches[3];
+ $this->thisRow = (int) $selectionMatches[1];
+ $this->thisColumn = (int) $selectionMatches[2];
+ $sheet->getCell($firstCell);
+ } elseif (preg_match('/^R(\d+)C(\d+)$/', (string) $range, $selectionMatches) === 1) {
+ // cell
+ $cell = Coordinate::stringFromColumnIndex((int) $selectionMatches[2])
+ . $selectionMatches[1];
+ $sheet->getCell($cell);
+ $this->thisRow = (int) $selectionMatches[1];
+ $this->thisColumn = (int) $selectionMatches[2];
+ } elseif (preg_match('/^C(\d+)$/', (string) $range, $selectionMatches) === 1) {
+ // column
+ $firstCell = Coordinate::stringFromColumnIndex((int) $selectionMatches[1])
+ . '1';
+ $cell = $firstCell
+ . ':'
+ . Coordinate::stringFromColumnIndex((int) $selectionMatches[1])
+ . ((string) AddressRange::MAX_ROW);
+ $this->thisColumn = (int) $selectionMatches[1];
+ $sheet->getCell($firstCell);
+ } elseif (preg_match('/^R(\d+)$/', (string) $range, $selectionMatches)) {
+ // row
+ $firstCell = 'A'
+ . $selectionMatches[1];
+ $cell = $firstCell
+ . ':'
+ . AddressRange::MAX_COLUMN
+ . $selectionMatches[1];
+ $this->thisRow = (int) $selectionMatches[1];
+ $sheet->getCell($firstCell);
+ }
+
+ $validation->setSqref($cell);
+ $stRange = $sheet->shrinkRangeToFit($cell);
+ $cells = array_merge($cells, Coordinate::extractAllCellReferencesInRange($stRange));
+ }
+
+ break;
+ case 'Type':
+ $validation->setType(self::TYPE_MAPPINGS[$tagValueLower] ?? $tagValueLower);
+
+ break;
+ case 'Qualifier':
+ $validation->setOperator(self::OPERATOR_MAPPINGS[$tagValueLower] ?? $tagValueLower);
+
+ break;
+ case 'InputTitle':
+ $validation->setPromptTitle($tagValue);
+
+ break;
+ case 'InputMessage':
+ $validation->setPrompt($tagValue);
+
+ break;
+ case 'InputHide':
+ $validation->setShowInputMessage(false);
+
+ break;
+ case 'ErrorStyle':
+ $validation->setErrorStyle($tagValueLower);
+
+ break;
+ case 'ErrorTitle':
+ $validation->setErrorTitle($tagValue);
+
+ break;
+ case 'ErrorMessage':
+ $validation->setError($tagValue);
+
+ break;
+ case 'ErrorHide':
+ $validation->setShowErrorMessage(false);
+
+ break;
+ case 'ComboHide':
+ $validation->setShowDropDown(false);
+
+ break;
+ case 'UseBlank':
+ $validation->setAllowBlank(true);
+
+ break;
+ case 'CellRangeList':
+ // FIXME missing FIXME
+
+ break;
+ case 'Min':
+ case 'Value':
+ $tagValue = (string) preg_replace_callback(AddressHelper::R1C1_COORDINATE_REGEX, $pregCallback, $tagValue);
+ $validation->setFormula1($tagValue);
+
+ break;
+ case 'Max':
+ $tagValue = (string) preg_replace_callback(AddressHelper::R1C1_COORDINATE_REGEX, $pregCallback, $tagValue);
+ $validation->setFormula2($tagValue);
+
+ break;
+ }
+ }
+
+ foreach ($cells as $cell) {
+ $sheet->getCell($cell)->setDataValidation(clone $validation);
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/PageSettings.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/PageSettings.php
new file mode 100644
index 00000000..8f9d4645
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/PageSettings.php
@@ -0,0 +1,130 @@
+pageSetup($xmlX, $this->getPrintDefaults());
+ $this->printSettings = $this->printSetup($xmlX, $printSettings);
+ }
+
+ public function loadPageSettings(Spreadsheet $spreadsheet): void
+ {
+ $spreadsheet->getActiveSheet()->getPageSetup()
+ ->setPaperSize($this->printSettings->paperSize)
+ ->setOrientation($this->printSettings->orientation)
+ ->setScale($this->printSettings->scale)
+ ->setVerticalCentered($this->printSettings->verticalCentered)
+ ->setHorizontalCentered($this->printSettings->horizontalCentered)
+ ->setPageOrder($this->printSettings->printOrder);
+ $spreadsheet->getActiveSheet()->getPageMargins()
+ ->setTop($this->printSettings->topMargin)
+ ->setHeader($this->printSettings->headerMargin)
+ ->setLeft($this->printSettings->leftMargin)
+ ->setRight($this->printSettings->rightMargin)
+ ->setBottom($this->printSettings->bottomMargin)
+ ->setFooter($this->printSettings->footerMargin);
+ }
+
+ private function getPrintDefaults(): stdClass
+ {
+ return (object) [
+ 'paperSize' => 9,
+ 'orientation' => PageSetup::ORIENTATION_DEFAULT,
+ 'scale' => 100,
+ 'horizontalCentered' => false,
+ 'verticalCentered' => false,
+ 'printOrder' => PageSetup::PAGEORDER_DOWN_THEN_OVER,
+ 'topMargin' => 0.75,
+ 'headerMargin' => 0.3,
+ 'leftMargin' => 0.7,
+ 'rightMargin' => 0.7,
+ 'bottomMargin' => 0.75,
+ 'footerMargin' => 0.3,
+ ];
+ }
+
+ private function pageSetup(SimpleXMLElement $xmlX, stdClass $printDefaults): stdClass
+ {
+ if (isset($xmlX->WorksheetOptions->PageSetup)) {
+ foreach ($xmlX->WorksheetOptions->PageSetup as $pageSetupData) {
+ foreach ($pageSetupData as $pageSetupKey => $pageSetupValue) {
+ $pageSetupAttributes = $pageSetupValue->attributes(Namespaces::URN_EXCEL);
+ if ($pageSetupAttributes !== null) {
+ switch ($pageSetupKey) {
+ case 'Layout':
+ $this->setLayout($printDefaults, $pageSetupAttributes);
+
+ break;
+ case 'Header':
+ $printDefaults->headerMargin = (float) $pageSetupAttributes->Margin ?: 1.0;
+
+ break;
+ case 'Footer':
+ $printDefaults->footerMargin = (float) $pageSetupAttributes->Margin ?: 1.0;
+
+ break;
+ case 'PageMargins':
+ $this->setMargins($printDefaults, $pageSetupAttributes);
+
+ break;
+ }
+ }
+ }
+ }
+ }
+
+ return $printDefaults;
+ }
+
+ private function printSetup(SimpleXMLElement $xmlX, stdClass $printDefaults): stdClass
+ {
+ if (isset($xmlX->WorksheetOptions->Print)) {
+ foreach ($xmlX->WorksheetOptions->Print as $printData) {
+ foreach ($printData as $printKey => $printValue) {
+ switch ($printKey) {
+ case 'LeftToRight':
+ $printDefaults->printOrder = PageSetup::PAGEORDER_OVER_THEN_DOWN;
+
+ break;
+ case 'PaperSizeIndex':
+ $printDefaults->paperSize = (int) $printValue ?: 9;
+
+ break;
+ case 'Scale':
+ $printDefaults->scale = (int) $printValue ?: 100;
+
+ break;
+ }
+ }
+ }
+ }
+
+ return $printDefaults;
+ }
+
+ private function setLayout(stdClass $printDefaults, SimpleXMLElement $pageSetupAttributes): void
+ {
+ $printDefaults->orientation = (string) strtolower($pageSetupAttributes->Orientation ?? '') ?: PageSetup::ORIENTATION_PORTRAIT;
+ $printDefaults->horizontalCentered = (bool) $pageSetupAttributes->CenterHorizontal ?: false;
+ $printDefaults->verticalCentered = (bool) $pageSetupAttributes->CenterVertical ?: false;
+ }
+
+ private function setMargins(stdClass $printDefaults, SimpleXMLElement $pageSetupAttributes): void
+ {
+ $printDefaults->leftMargin = (float) $pageSetupAttributes->Left ?: 1.0;
+ $printDefaults->rightMargin = (float) $pageSetupAttributes->Right ?: 1.0;
+ $printDefaults->topMargin = (float) $pageSetupAttributes->Top ?: 1.0;
+ $printDefaults->bottomMargin = (float) $pageSetupAttributes->Bottom ?: 1.0;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Properties.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Properties.php
new file mode 100644
index 00000000..17e11213
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Properties.php
@@ -0,0 +1,155 @@
+spreadsheet = $spreadsheet;
+ }
+
+ public function readProperties(SimpleXMLElement $xml, array $namespaces): void
+ {
+ $this->readStandardProperties($xml);
+ $this->readCustomProperties($xml, $namespaces);
+ }
+
+ protected function readStandardProperties(SimpleXMLElement $xml): void
+ {
+ if (isset($xml->DocumentProperties[0])) {
+ $docProps = $this->spreadsheet->getProperties();
+
+ foreach ($xml->DocumentProperties[0] as $propertyName => $propertyValue) {
+ $propertyValue = (string) $propertyValue;
+
+ $this->processStandardProperty($docProps, $propertyName, $propertyValue);
+ }
+ }
+ }
+
+ protected function readCustomProperties(SimpleXMLElement $xml, array $namespaces): void
+ {
+ if (isset($xml->CustomDocumentProperties) && is_iterable($xml->CustomDocumentProperties[0])) {
+ $docProps = $this->spreadsheet->getProperties();
+
+ foreach ($xml->CustomDocumentProperties[0] as $propertyName => $propertyValue) {
+ $propertyAttributes = self::getAttributes($propertyValue, $namespaces['dt']);
+ $propertyName = (string) preg_replace_callback('/_x([0-9a-f]{4})_/i', [$this, 'hex2str'], $propertyName);
+
+ $this->processCustomProperty($docProps, $propertyName, $propertyValue, $propertyAttributes);
+ }
+ }
+ }
+
+ protected function processStandardProperty(
+ DocumentProperties $docProps,
+ string $propertyName,
+ string $stringValue
+ ): void {
+ switch ($propertyName) {
+ case 'Title':
+ $docProps->setTitle($stringValue);
+
+ break;
+ case 'Subject':
+ $docProps->setSubject($stringValue);
+
+ break;
+ case 'Author':
+ $docProps->setCreator($stringValue);
+
+ break;
+ case 'Created':
+ $docProps->setCreated($stringValue);
+
+ break;
+ case 'LastAuthor':
+ $docProps->setLastModifiedBy($stringValue);
+
+ break;
+ case 'LastSaved':
+ $docProps->setModified($stringValue);
+
+ break;
+ case 'Company':
+ $docProps->setCompany($stringValue);
+
+ break;
+ case 'Category':
+ $docProps->setCategory($stringValue);
+
+ break;
+ case 'Manager':
+ $docProps->setManager($stringValue);
+
+ break;
+ case 'HyperlinkBase':
+ $docProps->setHyperlinkBase($stringValue);
+
+ break;
+ case 'Keywords':
+ $docProps->setKeywords($stringValue);
+
+ break;
+ case 'Description':
+ $docProps->setDescription($stringValue);
+
+ break;
+ }
+ }
+
+ protected function processCustomProperty(
+ DocumentProperties $docProps,
+ string $propertyName,
+ ?SimpleXMLElement $propertyValue,
+ SimpleXMLElement $propertyAttributes
+ ): void {
+ switch ((string) $propertyAttributes) {
+ case 'boolean':
+ $propertyType = DocumentProperties::PROPERTY_TYPE_BOOLEAN;
+ $propertyValue = (bool) (string) $propertyValue;
+
+ break;
+ case 'integer':
+ $propertyType = DocumentProperties::PROPERTY_TYPE_INTEGER;
+ $propertyValue = (int) $propertyValue;
+
+ break;
+ case 'float':
+ $propertyType = DocumentProperties::PROPERTY_TYPE_FLOAT;
+ $propertyValue = (float) $propertyValue;
+
+ break;
+ case 'dateTime.tz':
+ case 'dateTime.iso8601tz':
+ $propertyType = DocumentProperties::PROPERTY_TYPE_DATE;
+ $propertyValue = trim((string) $propertyValue);
+
+ break;
+ default:
+ $propertyType = DocumentProperties::PROPERTY_TYPE_STRING;
+ $propertyValue = trim((string) $propertyValue);
+
+ break;
+ }
+
+ $docProps->setCustomProperty($propertyName, $propertyValue, $propertyType);
+ }
+
+ protected function hex2str(array $hex): string
+ {
+ return mb_chr((int) hexdec($hex[1]), 'UTF-8');
+ }
+
+ private static function getAttributes(?SimpleXMLElement $simple, string $node): SimpleXMLElement
+ {
+ return ($simple === null) ? new SimpleXMLElement(' ') : ($simple->attributes($node) ?? new SimpleXMLElement(' '));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style.php
new file mode 100644
index 00000000..c6b51494
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style.php
@@ -0,0 +1,107 @@
+children('urn:schemas-microsoft-com:office:spreadsheet');
+ $stylesXml = $children->Styles[0];
+ if (!isset($stylesXml) || !is_iterable($stylesXml)) {
+ return [];
+ }
+
+ $alignmentStyleParser = new Style\Alignment();
+ $borderStyleParser = new Style\Border();
+ $fontStyleParser = new Style\Font();
+ $fillStyleParser = new Style\Fill();
+ $numberFormatStyleParser = new Style\NumberFormat();
+
+ foreach ($stylesXml as $style) {
+ $style_ss = self::getAttributes($style, $namespaces['ss']);
+ $styleID = (string) $style_ss['ID'];
+ $this->styles[$styleID] = $this->styles['Default'] ?? [];
+
+ $alignment = $border = $font = $fill = $numberFormat = $protection = [];
+
+ foreach ($style as $styleType => $styleDatax) {
+ $styleData = self::getSxml($styleDatax);
+ $styleAttributes = $styleData->attributes($namespaces['ss']);
+
+ switch ($styleType) {
+ case 'Alignment':
+ if ($styleAttributes) {
+ $alignment = $alignmentStyleParser->parseStyle($styleAttributes);
+ }
+
+ break;
+ case 'Borders':
+ $border = $borderStyleParser->parseStyle($styleData, $namespaces);
+
+ break;
+ case 'Font':
+ if ($styleAttributes) {
+ $font = $fontStyleParser->parseStyle($styleAttributes);
+ }
+
+ break;
+ case 'Interior':
+ if ($styleAttributes) {
+ $fill = $fillStyleParser->parseStyle($styleAttributes);
+ }
+
+ break;
+ case 'NumberFormat':
+ if ($styleAttributes) {
+ $numberFormat = $numberFormatStyleParser->parseStyle($styleAttributes);
+ }
+
+ break;
+ case 'Protection':
+ $locked = $hidden = null;
+ $styleAttributesP = $styleData->attributes($namespaces['x']);
+ if (isset($styleAttributes['Protected'])) {
+ $locked = ((bool) (string) $styleAttributes['Protected']) ? Protection::PROTECTION_PROTECTED : Protection::PROTECTION_UNPROTECTED;
+ }
+ if (isset($styleAttributesP['HideFormula'])) {
+ $hidden = ((bool) (string) $styleAttributesP['HideFormula']) ? Protection::PROTECTION_PROTECTED : Protection::PROTECTION_UNPROTECTED;
+ }
+ if ($locked !== null || $hidden !== null) {
+ $protection['protection'] = [];
+ if ($locked !== null) {
+ $protection['protection']['locked'] = $locked;
+ }
+ if ($hidden !== null) {
+ $protection['protection']['hidden'] = $hidden;
+ }
+ }
+
+ break;
+ }
+ }
+
+ $this->styles[$styleID] = array_merge($alignment, $border, $font, $fill, $numberFormat, $protection);
+ }
+
+ return $this->styles;
+ }
+
+ private static function getAttributes(?SimpleXMLElement $simple, string $node): SimpleXMLElement
+ {
+ return ($simple === null) ? new SimpleXMLElement(' ') : ($simple->attributes($node) ?? new SimpleXMLElement(' '));
+ }
+
+ private static function getSxml(?SimpleXMLElement $simple): SimpleXMLElement
+ {
+ return ($simple !== null) ? $simple : new SimpleXMLElement(' ');
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Alignment.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Alignment.php
new file mode 100644
index 00000000..d1363548
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Alignment.php
@@ -0,0 +1,58 @@
+ $styleAttributeValue) {
+ $styleAttributeValue = (string) $styleAttributeValue;
+ switch ($styleAttributeKey) {
+ case 'Vertical':
+ if (self::identifyFixedStyleValue(self::VERTICAL_ALIGNMENT_STYLES, $styleAttributeValue)) {
+ $style['alignment']['vertical'] = $styleAttributeValue;
+ }
+
+ break;
+ case 'Horizontal':
+ if (self::identifyFixedStyleValue(self::HORIZONTAL_ALIGNMENT_STYLES, $styleAttributeValue)) {
+ $style['alignment']['horizontal'] = $styleAttributeValue;
+ }
+
+ break;
+ case 'WrapText':
+ $style['alignment']['wrapText'] = true;
+
+ break;
+ case 'Rotate':
+ $style['alignment']['textRotation'] = $styleAttributeValue;
+
+ break;
+ }
+ }
+
+ return $style;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Border.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Border.php
new file mode 100644
index 00000000..dfde17ae
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Border.php
@@ -0,0 +1,110 @@
+ [
+ 'continuous' => BorderStyle::BORDER_HAIR,
+ 'dash' => BorderStyle::BORDER_DASHED,
+ 'dashdot' => BorderStyle::BORDER_DASHDOT,
+ 'dashdotdot' => BorderStyle::BORDER_DASHDOTDOT,
+ 'dot' => BorderStyle::BORDER_DOTTED,
+ 'double' => BorderStyle::BORDER_DOUBLE,
+ '0continuous' => BorderStyle::BORDER_HAIR,
+ '0dash' => BorderStyle::BORDER_DASHED,
+ '0dashdot' => BorderStyle::BORDER_DASHDOT,
+ '0dashdotdot' => BorderStyle::BORDER_DASHDOTDOT,
+ '0dot' => BorderStyle::BORDER_DOTTED,
+ '0double' => BorderStyle::BORDER_DOUBLE,
+ '1continuous' => BorderStyle::BORDER_THIN,
+ '1dash' => BorderStyle::BORDER_DASHED,
+ '1dashdot' => BorderStyle::BORDER_DASHDOT,
+ '1dashdotdot' => BorderStyle::BORDER_DASHDOTDOT,
+ '1dot' => BorderStyle::BORDER_DOTTED,
+ '1double' => BorderStyle::BORDER_DOUBLE,
+ '2continuous' => BorderStyle::BORDER_MEDIUM,
+ '2dash' => BorderStyle::BORDER_MEDIUMDASHED,
+ '2dashdot' => BorderStyle::BORDER_MEDIUMDASHDOT,
+ '2dashdotdot' => BorderStyle::BORDER_MEDIUMDASHDOTDOT,
+ '2dot' => BorderStyle::BORDER_DOTTED,
+ '2double' => BorderStyle::BORDER_DOUBLE,
+ '3continuous' => BorderStyle::BORDER_THICK,
+ '3dash' => BorderStyle::BORDER_MEDIUMDASHED,
+ '3dashdot' => BorderStyle::BORDER_MEDIUMDASHDOT,
+ '3dashdotdot' => BorderStyle::BORDER_MEDIUMDASHDOTDOT,
+ '3dot' => BorderStyle::BORDER_DOTTED,
+ '3double' => BorderStyle::BORDER_DOUBLE,
+ ],
+ ];
+
+ public function parseStyle(SimpleXMLElement $styleData, array $namespaces): array
+ {
+ $style = [];
+
+ $diagonalDirection = '';
+ $borderPosition = '';
+ foreach ($styleData->Border as $borderStyle) {
+ $borderAttributes = self::getAttributes($borderStyle, $namespaces['ss']);
+ $thisBorder = [];
+ $styleType = (string) $borderAttributes->Weight;
+ $styleType .= strtolower((string) $borderAttributes->LineStyle);
+ $thisBorder['borderStyle'] = self::BORDER_MAPPINGS['borderStyle'][$styleType] ?? BorderStyle::BORDER_NONE;
+
+ foreach ($borderAttributes as $borderStyleKey => $borderStyleValuex) {
+ $borderStyleValue = (string) $borderStyleValuex;
+ switch ($borderStyleKey) {
+ case 'Position':
+ [$borderPosition, $diagonalDirection]
+ = $this->parsePosition($borderStyleValue, $diagonalDirection);
+
+ break;
+ case 'Color':
+ $borderColour = substr($borderStyleValue, 1);
+ $thisBorder['color']['rgb'] = $borderColour;
+
+ break;
+ }
+ }
+
+ if ($borderPosition) {
+ $style['borders'][$borderPosition] = $thisBorder;
+ } elseif ($diagonalDirection) {
+ $style['borders']['diagonalDirection'] = $diagonalDirection;
+ $style['borders']['diagonal'] = $thisBorder;
+ }
+ }
+
+ return $style;
+ }
+
+ protected function parsePosition(string $borderStyleValue, string $diagonalDirection): array
+ {
+ $borderStyleValue = strtolower($borderStyleValue);
+
+ if (in_array($borderStyleValue, self::BORDER_POSITIONS)) {
+ $borderPosition = $borderStyleValue;
+ } elseif ($borderStyleValue === 'diagonalleft') {
+ $diagonalDirection = $diagonalDirection ? Borders::DIAGONAL_BOTH : Borders::DIAGONAL_DOWN;
+ } elseif ($borderStyleValue === 'diagonalright') {
+ $diagonalDirection = $diagonalDirection ? Borders::DIAGONAL_BOTH : Borders::DIAGONAL_UP;
+ }
+
+ return [$borderPosition ?? null, $diagonalDirection];
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Fill.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Fill.php
new file mode 100644
index 00000000..9a612152
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Fill.php
@@ -0,0 +1,63 @@
+ [
+ 'solid' => FillStyles::FILL_SOLID,
+ 'gray75' => FillStyles::FILL_PATTERN_DARKGRAY,
+ 'gray50' => FillStyles::FILL_PATTERN_MEDIUMGRAY,
+ 'gray25' => FillStyles::FILL_PATTERN_LIGHTGRAY,
+ 'gray125' => FillStyles::FILL_PATTERN_GRAY125,
+ 'gray0625' => FillStyles::FILL_PATTERN_GRAY0625,
+ 'horzstripe' => FillStyles::FILL_PATTERN_DARKHORIZONTAL, // horizontal stripe
+ 'vertstripe' => FillStyles::FILL_PATTERN_DARKVERTICAL, // vertical stripe
+ 'reversediagstripe' => FillStyles::FILL_PATTERN_DARKUP, // reverse diagonal stripe
+ 'diagstripe' => FillStyles::FILL_PATTERN_DARKDOWN, // diagonal stripe
+ 'diagcross' => FillStyles::FILL_PATTERN_DARKGRID, // diagoanl crosshatch
+ 'thickdiagcross' => FillStyles::FILL_PATTERN_DARKTRELLIS, // thick diagonal crosshatch
+ 'thinhorzstripe' => FillStyles::FILL_PATTERN_LIGHTHORIZONTAL,
+ 'thinvertstripe' => FillStyles::FILL_PATTERN_LIGHTVERTICAL,
+ 'thinreversediagstripe' => FillStyles::FILL_PATTERN_LIGHTUP,
+ 'thindiagstripe' => FillStyles::FILL_PATTERN_LIGHTDOWN,
+ 'thinhorzcross' => FillStyles::FILL_PATTERN_LIGHTGRID, // thin horizontal crosshatch
+ 'thindiagcross' => FillStyles::FILL_PATTERN_LIGHTTRELLIS, // thin diagonal crosshatch
+ ],
+ ];
+
+ public function parseStyle(SimpleXMLElement $styleAttributes): array
+ {
+ $style = [];
+
+ foreach ($styleAttributes as $styleAttributeKey => $styleAttributeValuex) {
+ $styleAttributeValue = (string) $styleAttributeValuex;
+ switch ($styleAttributeKey) {
+ case 'Color':
+ $style['fill']['endColor']['rgb'] = substr($styleAttributeValue, 1);
+ $style['fill']['startColor']['rgb'] = substr($styleAttributeValue, 1);
+
+ break;
+ case 'PatternColor':
+ $style['fill']['startColor']['rgb'] = substr($styleAttributeValue, 1);
+
+ break;
+ case 'Pattern':
+ $lcStyleAttributeValue = strtolower((string) $styleAttributeValue);
+ $style['fill']['fillType']
+ = self::FILL_MAPPINGS['fillType'][$lcStyleAttributeValue] ?? FillStyles::FILL_NONE;
+
+ break;
+ }
+ }
+
+ return $style;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Font.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Font.php
new file mode 100644
index 00000000..5f824889
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/Font.php
@@ -0,0 +1,79 @@
+ $styleAttributeValue) {
+ $styleAttributeValue = (string) $styleAttributeValue;
+ switch ($styleAttributeKey) {
+ case 'FontName':
+ $style['font']['name'] = $styleAttributeValue;
+
+ break;
+ case 'Size':
+ $style['font']['size'] = $styleAttributeValue;
+
+ break;
+ case 'Color':
+ $style['font']['color']['rgb'] = substr($styleAttributeValue, 1);
+
+ break;
+ case 'Bold':
+ $style['font']['bold'] = $styleAttributeValue === '1';
+
+ break;
+ case 'Italic':
+ $style['font']['italic'] = $styleAttributeValue === '1';
+
+ break;
+ case 'Underline':
+ $style = $this->parseUnderline($style, $styleAttributeValue);
+
+ break;
+ case 'VerticalAlign':
+ $style = $this->parseVerticalAlign($style, $styleAttributeValue);
+
+ break;
+ }
+ }
+
+ return $style;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/NumberFormat.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/NumberFormat.php
new file mode 100644
index 00000000..a31aa9eb
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/NumberFormat.php
@@ -0,0 +1,33 @@
+ $styleAttributeValue) {
+ $styleAttributeValue = str_replace($fromFormats, $toFormats, $styleAttributeValue);
+
+ switch ($styleAttributeValue) {
+ case 'Short Date':
+ $styleAttributeValue = 'dd/mm/yyyy';
+
+ break;
+ }
+
+ if ($styleAttributeValue > '') {
+ $style['numberFormat']['formatCode'] = $styleAttributeValue;
+ }
+ }
+
+ return $style;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/StyleBase.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/StyleBase.php
new file mode 100644
index 00000000..8103a71c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xml/Style/StyleBase.php
@@ -0,0 +1,30 @@
+') : ($simple->attributes($node) ?? new SimpleXMLElement(' '));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/ReferenceHelper.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/ReferenceHelper.php
new file mode 100644
index 00000000..45c131b6
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/ReferenceHelper.php
@@ -0,0 +1,1233 @@
+getBreaks();
+ ($numberOfColumns > 0 || $numberOfRows > 0)
+ ? uksort($aBreaks, [self::class, 'cellReverseSort'])
+ : uksort($aBreaks, [self::class, 'cellSort']);
+
+ foreach ($aBreaks as $cellAddress => $value) {
+ /** @var CellReferenceHelper */
+ $cellReferenceHelper = $this->cellReferenceHelper;
+ if ($cellReferenceHelper->cellAddressInDeleteRange($cellAddress) === true) {
+ // If we're deleting, then clear any defined breaks that are within the range
+ // of rows/columns that we're deleting
+ $worksheet->setBreak($cellAddress, Worksheet::BREAK_NONE);
+ } else {
+ // Otherwise update any affected breaks by inserting a new break at the appropriate point
+ // and removing the old affected break
+ $newReference = $this->updateCellReference($cellAddress);
+ if ($cellAddress !== $newReference) {
+ $worksheet->setBreak($newReference, $value)
+ ->setBreak($cellAddress, Worksheet::BREAK_NONE);
+ }
+ }
+ }
+ }
+
+ /**
+ * Update cell comments when inserting/deleting rows/columns.
+ *
+ * @param Worksheet $worksheet The worksheet that we're editing
+ */
+ protected function adjustComments(Worksheet $worksheet): void
+ {
+ $aComments = $worksheet->getComments();
+ $aNewComments = []; // the new array of all comments
+
+ foreach ($aComments as $cellAddress => &$value) {
+ // Any comments inside a deleted range will be ignored
+ /** @var CellReferenceHelper */
+ $cellReferenceHelper = $this->cellReferenceHelper;
+ if ($cellReferenceHelper->cellAddressInDeleteRange($cellAddress) === false) {
+ // Otherwise build a new array of comments indexed by the adjusted cell reference
+ $newReference = $this->updateCellReference($cellAddress);
+ $aNewComments[$newReference] = $value;
+ }
+ }
+ // Replace the comments array with the new set of comments
+ $worksheet->setComments($aNewComments);
+ }
+
+ /**
+ * Update hyperlinks when inserting/deleting rows/columns.
+ *
+ * @param Worksheet $worksheet The worksheet that we're editing
+ * @param int $numberOfColumns Number of columns to insert/delete (negative values indicate deletion)
+ * @param int $numberOfRows Number of rows to insert/delete (negative values indicate deletion)
+ */
+ protected function adjustHyperlinks(Worksheet $worksheet, int $numberOfColumns, int $numberOfRows): void
+ {
+ $aHyperlinkCollection = $worksheet->getHyperlinkCollection();
+ ($numberOfColumns > 0 || $numberOfRows > 0)
+ ? uksort($aHyperlinkCollection, [self::class, 'cellReverseSort'])
+ : uksort($aHyperlinkCollection, [self::class, 'cellSort']);
+
+ foreach ($aHyperlinkCollection as $cellAddress => $value) {
+ $newReference = $this->updateCellReference($cellAddress);
+ /** @var CellReferenceHelper */
+ $cellReferenceHelper = $this->cellReferenceHelper;
+ if ($cellReferenceHelper->cellAddressInDeleteRange($cellAddress) === true) {
+ $worksheet->setHyperlink($cellAddress, null);
+ } elseif ($cellAddress !== $newReference) {
+ $worksheet->setHyperlink($newReference, $value);
+ $worksheet->setHyperlink($cellAddress, null);
+ }
+ }
+ }
+
+ /**
+ * Update conditional formatting styles when inserting/deleting rows/columns.
+ *
+ * @param Worksheet $worksheet The worksheet that we're editing
+ * @param int $numberOfColumns Number of columns to insert/delete (negative values indicate deletion)
+ * @param int $numberOfRows Number of rows to insert/delete (negative values indicate deletion)
+ */
+ protected function adjustConditionalFormatting(Worksheet $worksheet, int $numberOfColumns, int $numberOfRows): void
+ {
+ $aStyles = $worksheet->getConditionalStylesCollection();
+ ($numberOfColumns > 0 || $numberOfRows > 0)
+ ? uksort($aStyles, [self::class, 'cellReverseSort'])
+ : uksort($aStyles, [self::class, 'cellSort']);
+
+ foreach ($aStyles as $cellAddress => $cfRules) {
+ $worksheet->removeConditionalStyles($cellAddress);
+ $newReference = $this->updateCellReference($cellAddress);
+
+ foreach ($cfRules as &$cfRule) {
+ /** @var Conditional $cfRule */
+ $conditions = $cfRule->getConditions();
+ foreach ($conditions as &$condition) {
+ if (is_string($condition)) {
+ /** @var CellReferenceHelper */
+ $cellReferenceHelper = $this->cellReferenceHelper;
+ $condition = $this->updateFormulaReferences(
+ $condition,
+ $cellReferenceHelper->beforeCellAddress(),
+ $numberOfColumns,
+ $numberOfRows,
+ $worksheet->getTitle(),
+ true
+ );
+ }
+ }
+ $cfRule->setConditions($conditions);
+ }
+ $worksheet->setConditionalStyles($newReference, $cfRules);
+ }
+ }
+
+ /**
+ * Update data validations when inserting/deleting rows/columns.
+ *
+ * @param Worksheet $worksheet The worksheet that we're editing
+ * @param int $numberOfColumns Number of columns to insert/delete (negative values indicate deletion)
+ * @param int $numberOfRows Number of rows to insert/delete (negative values indicate deletion)
+ */
+ protected function adjustDataValidations(Worksheet $worksheet, int $numberOfColumns, int $numberOfRows): void
+ {
+ $aDataValidationCollection = $worksheet->getDataValidationCollection();
+ ($numberOfColumns > 0 || $numberOfRows > 0)
+ ? uksort($aDataValidationCollection, [self::class, 'cellReverseSort'])
+ : uksort($aDataValidationCollection, [self::class, 'cellSort']);
+
+ foreach ($aDataValidationCollection as $cellAddress => $dataValidation) {
+ $newReference = $this->updateCellReference($cellAddress);
+ if ($cellAddress !== $newReference) {
+ $dataValidation->setSqref($newReference);
+ $worksheet->setDataValidation($newReference, $dataValidation);
+ $worksheet->setDataValidation($cellAddress, null);
+ }
+ }
+ }
+
+ /**
+ * Update merged cells when inserting/deleting rows/columns.
+ *
+ * @param Worksheet $worksheet The worksheet that we're editing
+ */
+ protected function adjustMergeCells(Worksheet $worksheet): void
+ {
+ $aMergeCells = $worksheet->getMergeCells();
+ $aNewMergeCells = []; // the new array of all merge cells
+ foreach ($aMergeCells as $cellAddress => &$value) {
+ $newReference = $this->updateCellReference($cellAddress);
+ $aNewMergeCells[$newReference] = $newReference;
+ }
+ $worksheet->setMergeCells($aNewMergeCells); // replace the merge cells array
+ }
+
+ /**
+ * Update protected cells when inserting/deleting rows/columns.
+ *
+ * @param Worksheet $worksheet The worksheet that we're editing
+ * @param int $numberOfColumns Number of columns to insert/delete (negative values indicate deletion)
+ * @param int $numberOfRows Number of rows to insert/delete (negative values indicate deletion)
+ */
+ protected function adjustProtectedCells(Worksheet $worksheet, int $numberOfColumns, int $numberOfRows): void
+ {
+ $aProtectedCells = $worksheet->getProtectedCells();
+ ($numberOfColumns > 0 || $numberOfRows > 0)
+ ? uksort($aProtectedCells, [self::class, 'cellReverseSort'])
+ : uksort($aProtectedCells, [self::class, 'cellSort']);
+ foreach ($aProtectedCells as $cellAddress => $value) {
+ $newReference = $this->updateCellReference($cellAddress);
+ if ($cellAddress !== $newReference) {
+ $worksheet->protectCells($newReference, $value, true);
+ $worksheet->unprotectCells($cellAddress);
+ }
+ }
+ }
+
+ /**
+ * Update column dimensions when inserting/deleting rows/columns.
+ *
+ * @param Worksheet $worksheet The worksheet that we're editing
+ */
+ protected function adjustColumnDimensions(Worksheet $worksheet): void
+ {
+ $aColumnDimensions = array_reverse($worksheet->getColumnDimensions(), true);
+ if (!empty($aColumnDimensions)) {
+ foreach ($aColumnDimensions as $objColumnDimension) {
+ $newReference = $this->updateCellReference($objColumnDimension->getColumnIndex() . '1');
+ [$newReference] = Coordinate::coordinateFromString($newReference);
+ if ($objColumnDimension->getColumnIndex() !== $newReference) {
+ $objColumnDimension->setColumnIndex($newReference);
+ }
+ }
+
+ $worksheet->refreshColumnDimensions();
+ }
+ }
+
+ /**
+ * Update row dimensions when inserting/deleting rows/columns.
+ *
+ * @param Worksheet $worksheet The worksheet that we're editing
+ * @param int $beforeRow Number of the row we're inserting/deleting before
+ * @param int $numberOfRows Number of rows to insert/delete (negative values indicate deletion)
+ */
+ protected function adjustRowDimensions(Worksheet $worksheet, int $beforeRow, int $numberOfRows): void
+ {
+ $aRowDimensions = array_reverse($worksheet->getRowDimensions(), true);
+ if (!empty($aRowDimensions)) {
+ foreach ($aRowDimensions as $objRowDimension) {
+ $newReference = $this->updateCellReference('A' . $objRowDimension->getRowIndex());
+ [, $newReference] = Coordinate::coordinateFromString($newReference);
+ $newRoweference = (int) $newReference;
+ if ($objRowDimension->getRowIndex() !== $newRoweference) {
+ $objRowDimension->setRowIndex($newRoweference);
+ }
+ }
+
+ $worksheet->refreshRowDimensions();
+
+ $copyDimension = $worksheet->getRowDimension($beforeRow - 1);
+ for ($i = $beforeRow; $i <= $beforeRow - 1 + $numberOfRows; ++$i) {
+ $newDimension = $worksheet->getRowDimension($i);
+ $newDimension->setRowHeight($copyDimension->getRowHeight());
+ $newDimension->setVisible($copyDimension->getVisible());
+ $newDimension->setOutlineLevel($copyDimension->getOutlineLevel());
+ $newDimension->setCollapsed($copyDimension->getCollapsed());
+ }
+ }
+ }
+
+ /**
+ * Insert a new column or row, updating all possible related data.
+ *
+ * @param string $beforeCellAddress Insert before this cell address (e.g. 'A1')
+ * @param int $numberOfColumns Number of columns to insert/delete (negative values indicate deletion)
+ * @param int $numberOfRows Number of rows to insert/delete (negative values indicate deletion)
+ * @param Worksheet $worksheet The worksheet that we're editing
+ */
+ public function insertNewBefore(
+ string $beforeCellAddress,
+ int $numberOfColumns,
+ int $numberOfRows,
+ Worksheet $worksheet
+ ): void {
+ $remove = ($numberOfColumns < 0 || $numberOfRows < 0);
+
+ if (
+ $this->cellReferenceHelper === null
+ || $this->cellReferenceHelper->refreshRequired($beforeCellAddress, $numberOfColumns, $numberOfRows)
+ ) {
+ $this->cellReferenceHelper = new CellReferenceHelper($beforeCellAddress, $numberOfColumns, $numberOfRows);
+ }
+
+ // Get coordinate of $beforeCellAddress
+ [$beforeColumn, $beforeRow, $beforeColumnString] = Coordinate::indexesFromString($beforeCellAddress);
+
+ // Clear cells if we are removing columns or rows
+ $highestColumn = $worksheet->getHighestColumn();
+ $highestDataColumn = $worksheet->getHighestDataColumn();
+ $highestRow = $worksheet->getHighestRow();
+ $highestDataRow = $worksheet->getHighestDataRow();
+
+ // 1. Clear column strips if we are removing columns
+ if ($numberOfColumns < 0 && $beforeColumn - 2 + $numberOfColumns > 0) {
+ $this->clearColumnStrips($highestRow, $beforeColumn, $numberOfColumns, $worksheet);
+ }
+
+ // 2. Clear row strips if we are removing rows
+ if ($numberOfRows < 0 && $beforeRow - 1 + $numberOfRows > 0) {
+ $this->clearRowStrips($highestColumn, $beforeColumn, $beforeRow, $numberOfRows, $worksheet);
+ }
+
+ // Find missing coordinates. This is important when inserting or deleting column before the last column
+ $startRow = $startCol = 1;
+ $startColString = 'A';
+ if ($numberOfRows === 0) {
+ $startCol = $beforeColumn;
+ $startColString = $beforeColumnString;
+ } elseif ($numberOfColumns === 0) {
+ $startRow = $beforeRow;
+ }
+ $highColumn = Coordinate::columnIndexFromString($highestDataColumn);
+ for ($row = $startRow; $row <= $highestDataRow; ++$row) {
+ for ($col = $startCol, $colString = $startColString; $col <= $highColumn; ++$col, ++$colString) {
+ $worksheet->getCell("$colString$row"); // create cell if it doesn't exist
+ }
+ }
+
+ $allCoordinates = $worksheet->getCoordinates();
+ if ($remove) {
+ // It's faster to reverse and pop than to use unshift, especially with large cell collections
+ $allCoordinates = array_reverse($allCoordinates);
+ }
+
+ // Loop through cells, bottom-up, and change cell coordinate
+ while ($coordinate = array_pop($allCoordinates)) {
+ $cell = $worksheet->getCell($coordinate);
+ $cellIndex = Coordinate::columnIndexFromString($cell->getColumn());
+
+ if ($cellIndex - 1 + $numberOfColumns < 0) {
+ continue;
+ }
+
+ // New coordinate
+ $newCoordinate = Coordinate::stringFromColumnIndex($cellIndex + $numberOfColumns) . ($cell->getRow() + $numberOfRows);
+
+ // Should the cell be updated? Move value and cellXf index from one cell to another.
+ if (($cellIndex >= $beforeColumn) && ($cell->getRow() >= $beforeRow)) {
+ // Update cell styles
+ $worksheet->getCell($newCoordinate)->setXfIndex($cell->getXfIndex());
+
+ // Insert this cell at its new location
+ if ($cell->getDataType() === DataType::TYPE_FORMULA) {
+ // Formula should be adjusted
+ $worksheet->getCell($newCoordinate)
+ ->setValue($this->updateFormulaReferences($cell->getValueString(), $beforeCellAddress, $numberOfColumns, $numberOfRows, $worksheet->getTitle(), true));
+ } else {
+ // Cell value should not be adjusted
+ $worksheet->getCell($newCoordinate)->setValueExplicit($cell->getValue(), $cell->getDataType());
+ }
+
+ // Clear the original cell
+ $worksheet->getCellCollection()->delete($coordinate);
+ } else {
+ /* We don't need to update styles for rows/columns before our insertion position,
+ but we do still need to adjust any formulae in those cells */
+ if ($cell->getDataType() === DataType::TYPE_FORMULA) {
+ // Formula should be adjusted
+ $cell->setValue($this->updateFormulaReferences($cell->getValueString(), $beforeCellAddress, $numberOfColumns, $numberOfRows, $worksheet->getTitle(), true));
+ }
+ }
+ }
+
+ // Duplicate styles for the newly inserted cells
+ $highestColumn = $worksheet->getHighestColumn();
+ $highestRow = $worksheet->getHighestRow();
+
+ if ($numberOfColumns > 0 && $beforeColumn - 2 > 0) {
+ $this->duplicateStylesByColumn($worksheet, $beforeColumn, $beforeRow, $highestRow, $numberOfColumns);
+ }
+
+ if ($numberOfRows > 0 && $beforeRow - 1 > 0) {
+ $this->duplicateStylesByRow($worksheet, $beforeColumn, $beforeRow, $highestColumn, $numberOfRows);
+ }
+
+ // Update worksheet: column dimensions
+ $this->adjustColumnDimensions($worksheet);
+
+ // Update worksheet: row dimensions
+ $this->adjustRowDimensions($worksheet, $beforeRow, $numberOfRows);
+
+ // Update worksheet: page breaks
+ $this->adjustPageBreaks($worksheet, $numberOfColumns, $numberOfRows);
+
+ // Update worksheet: comments
+ $this->adjustComments($worksheet);
+
+ // Update worksheet: hyperlinks
+ $this->adjustHyperlinks($worksheet, $numberOfColumns, $numberOfRows);
+
+ // Update worksheet: conditional formatting styles
+ $this->adjustConditionalFormatting($worksheet, $numberOfColumns, $numberOfRows);
+
+ // Update worksheet: data validations
+ $this->adjustDataValidations($worksheet, $numberOfColumns, $numberOfRows);
+
+ // Update worksheet: merge cells
+ $this->adjustMergeCells($worksheet);
+
+ // Update worksheet: protected cells
+ $this->adjustProtectedCells($worksheet, $numberOfColumns, $numberOfRows);
+
+ // Update worksheet: autofilter
+ $this->adjustAutoFilter($worksheet, $beforeCellAddress, $numberOfColumns);
+
+ // Update worksheet: table
+ $this->adjustTable($worksheet, $beforeCellAddress, $numberOfColumns);
+
+ // Update worksheet: freeze pane
+ if ($worksheet->getFreezePane()) {
+ $splitCell = $worksheet->getFreezePane();
+ $topLeftCell = $worksheet->getTopLeftCell() ?? '';
+
+ $splitCell = $this->updateCellReference($splitCell);
+ $topLeftCell = $this->updateCellReference($topLeftCell);
+
+ $worksheet->freezePane($splitCell, $topLeftCell);
+ }
+
+ // Page setup
+ if ($worksheet->getPageSetup()->isPrintAreaSet()) {
+ $worksheet->getPageSetup()->setPrintArea(
+ $this->updateCellReference($worksheet->getPageSetup()->getPrintArea())
+ );
+ }
+
+ // Update worksheet: drawings
+ $aDrawings = $worksheet->getDrawingCollection();
+ foreach ($aDrawings as $objDrawing) {
+ $newReference = $this->updateCellReference($objDrawing->getCoordinates());
+ if ($objDrawing->getCoordinates() != $newReference) {
+ $objDrawing->setCoordinates($newReference);
+ }
+ if ($objDrawing->getCoordinates2() !== '') {
+ $newReference = $this->updateCellReference($objDrawing->getCoordinates2());
+ if ($objDrawing->getCoordinates2() != $newReference) {
+ $objDrawing->setCoordinates2($newReference);
+ }
+ }
+ }
+
+ // Update workbook: define names
+ if (count($worksheet->getParentOrThrow()->getDefinedNames()) > 0) {
+ $this->updateDefinedNames($worksheet, $beforeCellAddress, $numberOfColumns, $numberOfRows);
+ }
+
+ // Garbage collect
+ $worksheet->garbageCollect();
+ }
+
+ private static function matchSheetName(?string $match, string $worksheetName): bool
+ {
+ return $match === null || $match === '' || $match === "'\u{fffc}'" || $match === "'\u{fffb}'" || strcasecmp(trim($match, "'"), $worksheetName) === 0;
+ }
+
+ private static function sheetnameBeforeCells(string $match, string $worksheetName, string $cells): string
+ {
+ $toString = ($match > '') ? "$match!" : '';
+
+ return str_replace(["\u{fffc}", "'\u{fffb}'"], $worksheetName, $toString) . $cells;
+ }
+
+ /**
+ * Update references within formulas.
+ *
+ * @param string $formula Formula to update
+ * @param string $beforeCellAddress Insert before this one
+ * @param int $numberOfColumns Number of columns to insert
+ * @param int $numberOfRows Number of rows to insert
+ * @param string $worksheetName Worksheet name/title
+ *
+ * @return string Updated formula
+ */
+ public function updateFormulaReferences(
+ string $formula = '',
+ string $beforeCellAddress = 'A1',
+ int $numberOfColumns = 0,
+ int $numberOfRows = 0,
+ string $worksheetName = '',
+ bool $includeAbsoluteReferences = false,
+ bool $onlyAbsoluteReferences = false
+ ): string {
+ $callback = fn (array $matches): string => (strcasecmp(trim($matches[2], "'"), $worksheetName) === 0) ? (($matches[2][0] === "'") ? "'\u{fffc}'!" : "'\u{fffb}'!") : "'\u{fffd}'!";
+ if (
+ $this->cellReferenceHelper === null
+ || $this->cellReferenceHelper->refreshRequired($beforeCellAddress, $numberOfColumns, $numberOfRows)
+ ) {
+ $this->cellReferenceHelper = new CellReferenceHelper($beforeCellAddress, $numberOfColumns, $numberOfRows);
+ }
+
+ // Update cell references in the formula
+ $formulaBlocks = explode('"', $formula);
+ $i = false;
+ foreach ($formulaBlocks as &$formulaBlock) {
+ // Ignore blocks that were enclosed in quotes (alternating entries in the $formulaBlocks array after the explode)
+ $i = $i === false;
+ if ($i) {
+ $adjustCount = 0;
+ $newCellTokens = $cellTokens = [];
+ // Search for row ranges (e.g. 'Sheet1'!3:5 or 3:5) with or without $ absolutes (e.g. $3:5)
+ $formulaBlockx = ' ' . (preg_replace_callback(self::SHEETNAME_PART_WITH_SLASHES, $callback, $formulaBlock) ?? $formulaBlock) . ' ';
+ $matchCount = preg_match_all('/' . self::REFHELPER_REGEXP_ROWRANGE . '/mui', $formulaBlockx, $matches, PREG_SET_ORDER);
+ if ($matchCount > 0) {
+ foreach ($matches as $match) {
+ $fromString = self::sheetnameBeforeCells($match[2], $worksheetName, "{$match[3]}:{$match[4]}");
+ $modified3 = substr($this->updateCellReference('$A' . $match[3], $includeAbsoluteReferences, $onlyAbsoluteReferences), 2);
+ $modified4 = substr($this->updateCellReference('$A' . $match[4], $includeAbsoluteReferences, $onlyAbsoluteReferences), 2);
+
+ if ($match[3] . ':' . $match[4] !== $modified3 . ':' . $modified4) {
+ if (self::matchSheetName($match[2], $worksheetName)) {
+ $toString = self::sheetnameBeforeCells($match[2], $worksheetName, "$modified3:$modified4");
+ // Max worksheet size is 1,048,576 rows by 16,384 columns in Excel 2007, so our adjustments need to be at least one digit more
+ $column = 100000;
+ $row = 10000000 + (int) trim($match[3], '$');
+ $cellIndex = "{$column}{$row}";
+
+ $newCellTokens[$cellIndex] = preg_quote($toString, '/');
+ $cellTokens[$cellIndex] = '/(? 0) {
+ foreach ($matches as $match) {
+ $fromString = self::sheetnameBeforeCells($match[2], $worksheetName, "{$match[3]}:{$match[4]}");
+ $modified3 = substr($this->updateCellReference($match[3] . '$1', $includeAbsoluteReferences, $onlyAbsoluteReferences), 0, -2);
+ $modified4 = substr($this->updateCellReference($match[4] . '$1', $includeAbsoluteReferences, $onlyAbsoluteReferences), 0, -2);
+
+ if ($match[3] . ':' . $match[4] !== $modified3 . ':' . $modified4) {
+ if (self::matchSheetName($match[2], $worksheetName)) {
+ $toString = self::sheetnameBeforeCells($match[2], $worksheetName, "$modified3:$modified4");
+ // Max worksheet size is 1,048,576 rows by 16,384 columns in Excel 2007, so our adjustments need to be at least one digit more
+ $column = Coordinate::columnIndexFromString(trim($match[3], '$')) + 100000;
+ $row = 10000000;
+ $cellIndex = "{$column}{$row}";
+
+ $newCellTokens[$cellIndex] = preg_quote($toString, '/');
+ $cellTokens[$cellIndex] = '/(? 0) {
+ foreach ($matches as $match) {
+ $fromString = self::sheetnameBeforeCells($match[2], $worksheetName, "{$match[3]}:{$match[4]}");
+ $modified3 = $this->updateCellReference($match[3], $includeAbsoluteReferences, $onlyAbsoluteReferences);
+ $modified4 = $this->updateCellReference($match[4], $includeAbsoluteReferences, $onlyAbsoluteReferences);
+
+ if ($match[3] . $match[4] !== $modified3 . $modified4) {
+ if (self::matchSheetName($match[2], $worksheetName)) {
+ $toString = self::sheetnameBeforeCells($match[2], $worksheetName, "$modified3:$modified4");
+ [$column, $row] = Coordinate::coordinateFromString($match[3]);
+ // Max worksheet size is 1,048,576 rows by 16,384 columns in Excel 2007, so our adjustments need to be at least one digit more
+ $column = Coordinate::columnIndexFromString(trim($column, '$')) + 100000;
+ $row = (int) trim($row, '$') + 10000000;
+ $cellIndex = "{$column}{$row}";
+
+ $newCellTokens[$cellIndex] = preg_quote($toString, '/');
+ $cellTokens[$cellIndex] = '/(? 0) {
+ foreach ($matches as $match) {
+ $fromString = self::sheetnameBeforeCells($match[2], $worksheetName, "{$match[3]}");
+
+ $modified3 = $this->updateCellReference($match[3], $includeAbsoluteReferences, $onlyAbsoluteReferences);
+ if ($match[3] !== $modified3) {
+ if (self::matchSheetName($match[2], $worksheetName)) {
+ $toString = self::sheetnameBeforeCells($match[2], $worksheetName, "$modified3");
+ [$column, $row] = Coordinate::coordinateFromString($match[3]);
+ $columnAdditionalIndex = $column[0] === '$' ? 1 : 0;
+ $rowAdditionalIndex = $row[0] === '$' ? 1 : 0;
+ // Max worksheet size is 1,048,576 rows by 16,384 columns in Excel 2007, so our adjustments need to be at least one digit more
+ $column = Coordinate::columnIndexFromString(trim($column, '$')) + 100000;
+ $row = (int) trim($row, '$') + 10000000;
+ $cellIndex = $row . $rowAdditionalIndex . $column . $columnAdditionalIndex;
+
+ $newCellTokens[$cellIndex] = preg_quote($toString, '/');
+ $cellTokens[$cellIndex] = '/(? 0) {
+ if ($numberOfColumns > 0 || $numberOfRows > 0) {
+ krsort($cellTokens);
+ krsort($newCellTokens);
+ } else {
+ ksort($cellTokens);
+ ksort($newCellTokens);
+ } // Update cell references in the formula
+ $formulaBlock = str_replace('\\', '', (string) preg_replace($cellTokens, $newCellTokens, $formulaBlock));
+ }
+ }
+ }
+ unset($formulaBlock);
+
+ // Then rebuild the formula string
+ return implode('"', $formulaBlocks);
+ }
+
+ /**
+ * Update all cell references within a formula, irrespective of worksheet.
+ */
+ public function updateFormulaReferencesAnyWorksheet(string $formula = '', int $numberOfColumns = 0, int $numberOfRows = 0): string
+ {
+ $formula = $this->updateCellReferencesAllWorksheets($formula, $numberOfColumns, $numberOfRows);
+
+ if ($numberOfColumns !== 0) {
+ $formula = $this->updateColumnRangesAllWorksheets($formula, $numberOfColumns);
+ }
+
+ if ($numberOfRows !== 0) {
+ $formula = $this->updateRowRangesAllWorksheets($formula, $numberOfRows);
+ }
+
+ return $formula;
+ }
+
+ private function updateCellReferencesAllWorksheets(string $formula, int $numberOfColumns, int $numberOfRows): string
+ {
+ $splitCount = preg_match_all(
+ '/' . Calculation::CALCULATION_REGEXP_CELLREF_RELATIVE . '/mui',
+ $formula,
+ $splitRanges,
+ PREG_OFFSET_CAPTURE
+ );
+
+ $columnLengths = array_map('strlen', array_column($splitRanges[6], 0));
+ $rowLengths = array_map('strlen', array_column($splitRanges[7], 0));
+ $columnOffsets = array_column($splitRanges[6], 1);
+ $rowOffsets = array_column($splitRanges[7], 1);
+
+ $columns = $splitRanges[6];
+ $rows = $splitRanges[7];
+
+ while ($splitCount > 0) {
+ --$splitCount;
+ $columnLength = $columnLengths[$splitCount];
+ $rowLength = $rowLengths[$splitCount];
+ $columnOffset = $columnOffsets[$splitCount];
+ $rowOffset = $rowOffsets[$splitCount];
+ $column = $columns[$splitCount][0];
+ $row = $rows[$splitCount][0];
+
+ if (!empty($column) && $column[0] !== '$') {
+ $column = ((Coordinate::columnIndexFromString($column) + $numberOfColumns) % AddressRange::MAX_COLUMN_INT) ?: AddressRange::MAX_COLUMN_INT;
+ $column = Coordinate::stringFromColumnIndex($column);
+ $rowOffset -= ($columnLength - strlen($column));
+ $formula = substr($formula, 0, $columnOffset) . $column . substr($formula, $columnOffset + $columnLength);
+ }
+ if (!empty($row) && $row[0] !== '$') {
+ $row = (((int) $row + $numberOfRows) % AddressRange::MAX_ROW) ?: AddressRange::MAX_ROW;
+ $formula = substr($formula, 0, $rowOffset) . $row . substr($formula, $rowOffset + $rowLength);
+ }
+ }
+
+ return $formula;
+ }
+
+ private function updateColumnRangesAllWorksheets(string $formula, int $numberOfColumns): string
+ {
+ $splitCount = preg_match_all(
+ '/' . Calculation::CALCULATION_REGEXP_COLUMNRANGE_RELATIVE . '/mui',
+ $formula,
+ $splitRanges,
+ PREG_OFFSET_CAPTURE
+ );
+
+ $fromColumnLengths = array_map('strlen', array_column($splitRanges[1], 0));
+ $fromColumnOffsets = array_column($splitRanges[1], 1);
+ $toColumnLengths = array_map('strlen', array_column($splitRanges[2], 0));
+ $toColumnOffsets = array_column($splitRanges[2], 1);
+
+ $fromColumns = $splitRanges[1];
+ $toColumns = $splitRanges[2];
+
+ while ($splitCount > 0) {
+ --$splitCount;
+ $fromColumnLength = $fromColumnLengths[$splitCount];
+ $toColumnLength = $toColumnLengths[$splitCount];
+ $fromColumnOffset = $fromColumnOffsets[$splitCount];
+ $toColumnOffset = $toColumnOffsets[$splitCount];
+ $fromColumn = $fromColumns[$splitCount][0];
+ $toColumn = $toColumns[$splitCount][0];
+
+ if (!empty($fromColumn) && $fromColumn[0] !== '$') {
+ $fromColumn = Coordinate::stringFromColumnIndex(Coordinate::columnIndexFromString($fromColumn) + $numberOfColumns);
+ $formula = substr($formula, 0, $fromColumnOffset) . $fromColumn . substr($formula, $fromColumnOffset + $fromColumnLength);
+ }
+ if (!empty($toColumn) && $toColumn[0] !== '$') {
+ $toColumn = Coordinate::stringFromColumnIndex(Coordinate::columnIndexFromString($toColumn) + $numberOfColumns);
+ $formula = substr($formula, 0, $toColumnOffset) . $toColumn . substr($formula, $toColumnOffset + $toColumnLength);
+ }
+ }
+
+ return $formula;
+ }
+
+ private function updateRowRangesAllWorksheets(string $formula, int $numberOfRows): string
+ {
+ $splitCount = preg_match_all(
+ '/' . Calculation::CALCULATION_REGEXP_ROWRANGE_RELATIVE . '/mui',
+ $formula,
+ $splitRanges,
+ PREG_OFFSET_CAPTURE
+ );
+
+ $fromRowLengths = array_map('strlen', array_column($splitRanges[1], 0));
+ $fromRowOffsets = array_column($splitRanges[1], 1);
+ $toRowLengths = array_map('strlen', array_column($splitRanges[2], 0));
+ $toRowOffsets = array_column($splitRanges[2], 1);
+
+ $fromRows = $splitRanges[1];
+ $toRows = $splitRanges[2];
+
+ while ($splitCount > 0) {
+ --$splitCount;
+ $fromRowLength = $fromRowLengths[$splitCount];
+ $toRowLength = $toRowLengths[$splitCount];
+ $fromRowOffset = $fromRowOffsets[$splitCount];
+ $toRowOffset = $toRowOffsets[$splitCount];
+ $fromRow = $fromRows[$splitCount][0];
+ $toRow = $toRows[$splitCount][0];
+
+ if (!empty($fromRow) && $fromRow[0] !== '$') {
+ $fromRow = (int) $fromRow + $numberOfRows;
+ $formula = substr($formula, 0, $fromRowOffset) . $fromRow . substr($formula, $fromRowOffset + $fromRowLength);
+ }
+ if (!empty($toRow) && $toRow[0] !== '$') {
+ $toRow = (int) $toRow + $numberOfRows;
+ $formula = substr($formula, 0, $toRowOffset) . $toRow . substr($formula, $toRowOffset + $toRowLength);
+ }
+ }
+
+ return $formula;
+ }
+
+ /**
+ * Update cell reference.
+ *
+ * @param string $cellReference Cell address or range of addresses
+ *
+ * @return string Updated cell range
+ */
+ private function updateCellReference(string $cellReference = 'A1', bool $includeAbsoluteReferences = false, bool $onlyAbsoluteReferences = false): string
+ {
+ // Is it in another worksheet? Will not have to update anything.
+ if (str_contains($cellReference, '!')) {
+ return $cellReference;
+ }
+ // Is it a range or a single cell?
+ if (!Coordinate::coordinateIsRange($cellReference)) {
+ // Single cell
+ /** @var CellReferenceHelper */
+ $cellReferenceHelper = $this->cellReferenceHelper;
+
+ return $cellReferenceHelper->updateCellReference($cellReference, $includeAbsoluteReferences, $onlyAbsoluteReferences);
+ }
+
+ // Range
+ return $this->updateCellRange($cellReference, $includeAbsoluteReferences, $onlyAbsoluteReferences);
+ }
+
+ /**
+ * Update named formulae (i.e. containing worksheet references / named ranges).
+ *
+ * @param Spreadsheet $spreadsheet Object to update
+ * @param string $oldName Old name (name to replace)
+ * @param string $newName New name
+ */
+ public function updateNamedFormulae(Spreadsheet $spreadsheet, string $oldName = '', string $newName = ''): void
+ {
+ if ($oldName == '') {
+ return;
+ }
+
+ foreach ($spreadsheet->getWorksheetIterator() as $sheet) {
+ foreach ($sheet->getCoordinates(false) as $coordinate) {
+ $cell = $sheet->getCell($coordinate);
+ if ($cell->getDataType() === DataType::TYPE_FORMULA) {
+ $formula = $cell->getValueString();
+ if (str_contains($formula, $oldName)) {
+ $formula = str_replace("'" . $oldName . "'!", "'" . $newName . "'!", $formula);
+ $formula = str_replace($oldName . '!', $newName . '!', $formula);
+ $cell->setValueExplicit($formula, DataType::TYPE_FORMULA);
+ }
+ }
+ }
+ }
+ }
+
+ private function updateDefinedNames(Worksheet $worksheet, string $beforeCellAddress, int $numberOfColumns, int $numberOfRows): void
+ {
+ foreach ($worksheet->getParentOrThrow()->getDefinedNames() as $definedName) {
+ if ($definedName->isFormula() === false) {
+ $this->updateNamedRange($definedName, $worksheet, $beforeCellAddress, $numberOfColumns, $numberOfRows);
+ } else {
+ $this->updateNamedFormula($definedName, $worksheet, $beforeCellAddress, $numberOfColumns, $numberOfRows);
+ }
+ }
+ }
+
+ private function updateNamedRange(DefinedName $definedName, Worksheet $worksheet, string $beforeCellAddress, int $numberOfColumns, int $numberOfRows): void
+ {
+ $cellAddress = $definedName->getValue();
+ $asFormula = ($cellAddress[0] === '=');
+ if ($definedName->getWorksheet() !== null && $definedName->getWorksheet()->getHashInt() === $worksheet->getHashInt()) {
+ /**
+ * If we delete the entire range that is referenced by a Named Range, MS Excel sets the value to #REF!
+ * PhpSpreadsheet still only does a basic adjustment, so the Named Range will still reference Cells.
+ * Note that this applies only when deleting columns/rows; subsequent insertion won't fix the #REF!
+ * TODO Can we work out a method to identify Named Ranges that cease to be valid, so that we can replace
+ * them with a #REF!
+ */
+ if ($asFormula === true) {
+ $formula = $this->updateFormulaReferences($cellAddress, $beforeCellAddress, $numberOfColumns, $numberOfRows, $worksheet->getTitle(), true, true);
+ $definedName->setValue($formula);
+ } else {
+ $definedName->setValue($this->updateCellReference(ltrim($cellAddress, '='), true));
+ }
+ }
+ }
+
+ private function updateNamedFormula(DefinedName $definedName, Worksheet $worksheet, string $beforeCellAddress, int $numberOfColumns, int $numberOfRows): void
+ {
+ if ($definedName->getWorksheet() !== null && $definedName->getWorksheet()->getHashInt() === $worksheet->getHashInt()) {
+ /**
+ * If we delete the entire range that is referenced by a Named Formula, MS Excel sets the value to #REF!
+ * PhpSpreadsheet still only does a basic adjustment, so the Named Formula will still reference Cells.
+ * Note that this applies only when deleting columns/rows; subsequent insertion won't fix the #REF!
+ * TODO Can we work out a method to identify Named Ranges that cease to be valid, so that we can replace
+ * them with a #REF!
+ */
+ $formula = $definedName->getValue();
+ $formula = $this->updateFormulaReferences($formula, $beforeCellAddress, $numberOfColumns, $numberOfRows, $worksheet->getTitle(), true);
+ $definedName->setValue($formula);
+ }
+ }
+
+ /**
+ * Update cell range.
+ *
+ * @param string $cellRange Cell range (e.g. 'B2:D4', 'B:C' or '2:3')
+ *
+ * @return string Updated cell range
+ */
+ private function updateCellRange(string $cellRange = 'A1:A1', bool $includeAbsoluteReferences = false, bool $onlyAbsoluteReferences = false): string
+ {
+ if (!Coordinate::coordinateIsRange($cellRange)) {
+ throw new Exception('Only cell ranges may be passed to this method.');
+ }
+
+ // Update range
+ $range = Coordinate::splitRange($cellRange);
+ $ic = count($range);
+ for ($i = 0; $i < $ic; ++$i) {
+ $jc = count($range[$i]);
+ for ($j = 0; $j < $jc; ++$j) {
+ /** @var CellReferenceHelper */
+ $cellReferenceHelper = $this->cellReferenceHelper;
+ if (ctype_alpha($range[$i][$j])) {
+ $range[$i][$j] = Coordinate::coordinateFromString(
+ $cellReferenceHelper->updateCellReference($range[$i][$j] . '1', $includeAbsoluteReferences, $onlyAbsoluteReferences)
+ )[0];
+ } elseif (ctype_digit($range[$i][$j])) {
+ $range[$i][$j] = Coordinate::coordinateFromString(
+ $cellReferenceHelper->updateCellReference('A' . $range[$i][$j], $includeAbsoluteReferences, $onlyAbsoluteReferences)
+ )[1];
+ } else {
+ $range[$i][$j] = $cellReferenceHelper->updateCellReference($range[$i][$j], $includeAbsoluteReferences, $onlyAbsoluteReferences);
+ }
+ }
+ }
+
+ // Recreate range string
+ return Coordinate::buildRange($range);
+ }
+
+ private function clearColumnStrips(int $highestRow, int $beforeColumn, int $numberOfColumns, Worksheet $worksheet): void
+ {
+ $startColumnId = Coordinate::stringFromColumnIndex($beforeColumn + $numberOfColumns);
+ $endColumnId = Coordinate::stringFromColumnIndex($beforeColumn);
+
+ for ($row = 1; $row <= $highestRow - 1; ++$row) {
+ for ($column = $startColumnId; $column !== $endColumnId; ++$column) {
+ $coordinate = $column . $row;
+ $this->clearStripCell($worksheet, $coordinate);
+ }
+ }
+ }
+
+ private function clearRowStrips(string $highestColumn, int $beforeColumn, int $beforeRow, int $numberOfRows, Worksheet $worksheet): void
+ {
+ $startColumnId = Coordinate::stringFromColumnIndex($beforeColumn);
+ ++$highestColumn;
+
+ for ($column = $startColumnId; $column !== $highestColumn; ++$column) {
+ for ($row = $beforeRow + $numberOfRows; $row <= $beforeRow - 1; ++$row) {
+ $coordinate = $column . $row;
+ $this->clearStripCell($worksheet, $coordinate);
+ }
+ }
+ }
+
+ private function clearStripCell(Worksheet $worksheet, string $coordinate): void
+ {
+ $worksheet->removeConditionalStyles($coordinate);
+ $worksheet->setHyperlink($coordinate);
+ $worksheet->setDataValidation($coordinate);
+ $worksheet->removeComment($coordinate);
+
+ if ($worksheet->cellExists($coordinate)) {
+ $worksheet->getCell($coordinate)->setValueExplicit(null, DataType::TYPE_NULL);
+ $worksheet->getCell($coordinate)->setXfIndex(0);
+ }
+ }
+
+ private function adjustAutoFilter(Worksheet $worksheet, string $beforeCellAddress, int $numberOfColumns): void
+ {
+ $autoFilter = $worksheet->getAutoFilter();
+ $autoFilterRange = $autoFilter->getRange();
+ if (!empty($autoFilterRange)) {
+ if ($numberOfColumns !== 0) {
+ $autoFilterColumns = $autoFilter->getColumns();
+ if (count($autoFilterColumns) > 0) {
+ $column = '';
+ $row = 0;
+ sscanf($beforeCellAddress, '%[A-Z]%d', $column, $row);
+ $columnIndex = Coordinate::columnIndexFromString((string) $column);
+ [$rangeStart, $rangeEnd] = Coordinate::rangeBoundaries($autoFilterRange);
+ if ($columnIndex <= $rangeEnd[0]) {
+ if ($numberOfColumns < 0) {
+ $this->adjustAutoFilterDeleteRules($columnIndex, $numberOfColumns, $autoFilterColumns, $autoFilter);
+ }
+ $startCol = ($columnIndex > $rangeStart[0]) ? $columnIndex : $rangeStart[0];
+
+ // Shuffle columns in autofilter range
+ if ($numberOfColumns > 0) {
+ $this->adjustAutoFilterInsert($startCol, $numberOfColumns, $rangeEnd[0], $autoFilter);
+ } else {
+ $this->adjustAutoFilterDelete($startCol, $numberOfColumns, $rangeEnd[0], $autoFilter);
+ }
+ }
+ }
+ }
+
+ $worksheet->setAutoFilter(
+ $this->updateCellReference($autoFilterRange)
+ );
+ }
+ }
+
+ private function adjustAutoFilterDeleteRules(int $columnIndex, int $numberOfColumns, array $autoFilterColumns, AutoFilter $autoFilter): void
+ {
+ // If we're actually deleting any columns that fall within the autofilter range,
+ // then we delete any rules for those columns
+ $deleteColumn = $columnIndex + $numberOfColumns - 1;
+ $deleteCount = abs($numberOfColumns);
+
+ for ($i = 1; $i <= $deleteCount; ++$i) {
+ $columnName = Coordinate::stringFromColumnIndex($deleteColumn + 1);
+ if (isset($autoFilterColumns[$columnName])) {
+ $autoFilter->clearColumn($columnName);
+ }
+ ++$deleteColumn;
+ }
+ }
+
+ private function adjustAutoFilterInsert(int $startCol, int $numberOfColumns, int $rangeEnd, AutoFilter $autoFilter): void
+ {
+ $startColRef = $startCol;
+ $endColRef = $rangeEnd;
+ $toColRef = $rangeEnd + $numberOfColumns;
+
+ do {
+ $autoFilter->shiftColumn(Coordinate::stringFromColumnIndex($endColRef), Coordinate::stringFromColumnIndex($toColRef));
+ --$endColRef;
+ --$toColRef;
+ } while ($startColRef <= $endColRef);
+ }
+
+ private function adjustAutoFilterDelete(int $startCol, int $numberOfColumns, int $rangeEnd, AutoFilter $autoFilter): void
+ {
+ // For delete, we shuffle from beginning to end to avoid overwriting
+ $startColID = Coordinate::stringFromColumnIndex($startCol);
+ $toColID = Coordinate::stringFromColumnIndex($startCol + $numberOfColumns);
+ $endColID = Coordinate::stringFromColumnIndex($rangeEnd + 1);
+
+ do {
+ $autoFilter->shiftColumn($startColID, $toColID);
+ ++$startColID;
+ ++$toColID;
+ } while ($startColID !== $endColID);
+ }
+
+ private function adjustTable(Worksheet $worksheet, string $beforeCellAddress, int $numberOfColumns): void
+ {
+ $tableCollection = $worksheet->getTableCollection();
+
+ foreach ($tableCollection as $table) {
+ $tableRange = $table->getRange();
+ if (!empty($tableRange)) {
+ if ($numberOfColumns !== 0) {
+ $tableColumns = $table->getColumns();
+ if (count($tableColumns) > 0) {
+ $column = '';
+ $row = 0;
+ sscanf($beforeCellAddress, '%[A-Z]%d', $column, $row);
+ $columnIndex = Coordinate::columnIndexFromString((string) $column);
+ [$rangeStart, $rangeEnd] = Coordinate::rangeBoundaries($tableRange);
+ if ($columnIndex <= $rangeEnd[0]) {
+ if ($numberOfColumns < 0) {
+ $this->adjustTableDeleteRules($columnIndex, $numberOfColumns, $tableColumns, $table);
+ }
+ $startCol = ($columnIndex > $rangeStart[0]) ? $columnIndex : $rangeStart[0];
+
+ // Shuffle columns in table range
+ if ($numberOfColumns > 0) {
+ $this->adjustTableInsert($startCol, $numberOfColumns, $rangeEnd[0], $table);
+ } else {
+ $this->adjustTableDelete($startCol, $numberOfColumns, $rangeEnd[0], $table);
+ }
+ }
+ }
+ }
+
+ $table->setRange($this->updateCellReference($tableRange));
+ }
+ }
+ }
+
+ private function adjustTableDeleteRules(int $columnIndex, int $numberOfColumns, array $tableColumns, Table $table): void
+ {
+ // If we're actually deleting any columns that fall within the table range,
+ // then we delete any rules for those columns
+ $deleteColumn = $columnIndex + $numberOfColumns - 1;
+ $deleteCount = abs($numberOfColumns);
+
+ for ($i = 1; $i <= $deleteCount; ++$i) {
+ $columnName = Coordinate::stringFromColumnIndex($deleteColumn + 1);
+ if (isset($tableColumns[$columnName])) {
+ $table->clearColumn($columnName);
+ }
+ ++$deleteColumn;
+ }
+ }
+
+ private function adjustTableInsert(int $startCol, int $numberOfColumns, int $rangeEnd, Table $table): void
+ {
+ $startColRef = $startCol;
+ $endColRef = $rangeEnd;
+ $toColRef = $rangeEnd + $numberOfColumns;
+
+ do {
+ $table->shiftColumn(Coordinate::stringFromColumnIndex($endColRef), Coordinate::stringFromColumnIndex($toColRef));
+ --$endColRef;
+ --$toColRef;
+ } while ($startColRef <= $endColRef);
+ }
+
+ private function adjustTableDelete(int $startCol, int $numberOfColumns, int $rangeEnd, Table $table): void
+ {
+ // For delete, we shuffle from beginning to end to avoid overwriting
+ $startColID = Coordinate::stringFromColumnIndex($startCol);
+ $toColID = Coordinate::stringFromColumnIndex($startCol + $numberOfColumns);
+ $endColID = Coordinate::stringFromColumnIndex($rangeEnd + 1);
+
+ do {
+ $table->shiftColumn($startColID, $toColID);
+ ++$startColID;
+ ++$toColID;
+ } while ($startColID !== $endColID);
+ }
+
+ private function duplicateStylesByColumn(Worksheet $worksheet, int $beforeColumn, int $beforeRow, int $highestRow, int $numberOfColumns): void
+ {
+ $beforeColumnName = Coordinate::stringFromColumnIndex($beforeColumn - 1);
+ for ($i = $beforeRow; $i <= $highestRow - 1; ++$i) {
+ // Style
+ $coordinate = $beforeColumnName . $i;
+ if ($worksheet->cellExists($coordinate)) {
+ $xfIndex = $worksheet->getCell($coordinate)->getXfIndex();
+ for ($j = $beforeColumn; $j <= $beforeColumn - 1 + $numberOfColumns; ++$j) {
+ if (!empty($xfIndex) || $worksheet->cellExists([$j, $i])) {
+ $worksheet->getCell([$j, $i])->setXfIndex($xfIndex);
+ }
+ }
+ }
+ }
+ }
+
+ private function duplicateStylesByRow(Worksheet $worksheet, int $beforeColumn, int $beforeRow, string $highestColumn, int $numberOfRows): void
+ {
+ $highestColumnIndex = Coordinate::columnIndexFromString($highestColumn);
+ for ($i = $beforeColumn; $i <= $highestColumnIndex; ++$i) {
+ // Style
+ $coordinate = Coordinate::stringFromColumnIndex($i) . ($beforeRow - 1);
+ if ($worksheet->cellExists($coordinate)) {
+ $xfIndex = $worksheet->getCell($coordinate)->getXfIndex();
+ for ($j = $beforeRow; $j <= $beforeRow - 1 + $numberOfRows; ++$j) {
+ if (!empty($xfIndex) || $worksheet->cellExists([$i, $j])) {
+ $worksheet->getCell(Coordinate::stringFromColumnIndex($i) . $j)->setXfIndex($xfIndex);
+ }
+ }
+ }
+ }
+ }
+
+ /**
+ * __clone implementation. Cloning should not be allowed in a Singleton!
+ */
+ final public function __clone()
+ {
+ throw new Exception('Cloning a Singleton is not allowed!');
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/ITextElement.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/ITextElement.php
new file mode 100644
index 00000000..548e68ba
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/ITextElement.php
@@ -0,0 +1,34 @@
+richTextElements = [];
+
+ // Rich-Text string attached to cell?
+ if ($cell !== null) {
+ // Add cell text and style
+ if ($cell->getValueString() !== '') {
+ $objRun = new Run($cell->getValueString());
+ $objRun->setFont(clone $cell->getWorksheet()->getStyle($cell->getCoordinate())->getFont());
+ $this->addText($objRun);
+ }
+
+ // Set parent value
+ $cell->setValueExplicit($this, DataType::TYPE_STRING);
+ }
+ }
+
+ /**
+ * Add text.
+ *
+ * @param ITextElement $text Rich text element
+ *
+ * @return $this
+ */
+ public function addText(ITextElement $text): static
+ {
+ $this->richTextElements[] = $text;
+
+ return $this;
+ }
+
+ /**
+ * Create text.
+ *
+ * @param string $text Text
+ */
+ public function createText(string $text): TextElement
+ {
+ $objText = new TextElement($text);
+ $this->addText($objText);
+
+ return $objText;
+ }
+
+ /**
+ * Create text run.
+ *
+ * @param string $text Text
+ */
+ public function createTextRun(string $text): Run
+ {
+ $objText = new Run($text);
+ $this->addText($objText);
+
+ return $objText;
+ }
+
+ /**
+ * Get plain text.
+ */
+ public function getPlainText(): string
+ {
+ // Return value
+ $returnValue = '';
+
+ // Loop through all ITextElements
+ foreach ($this->richTextElements as $text) {
+ $returnValue .= $text->getText();
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * Convert to string.
+ */
+ public function __toString(): string
+ {
+ return $this->getPlainText();
+ }
+
+ /**
+ * Get Rich Text elements.
+ *
+ * @return ITextElement[]
+ */
+ public function getRichTextElements(): array
+ {
+ return $this->richTextElements;
+ }
+
+ /**
+ * Set Rich Text elements.
+ *
+ * @param ITextElement[] $textElements Array of elements
+ *
+ * @return $this
+ */
+ public function setRichTextElements(array $textElements): static
+ {
+ $this->richTextElements = $textElements;
+
+ return $this;
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ $hashElements = '';
+ foreach ($this->richTextElements as $element) {
+ $hashElements .= $element->getHashCode();
+ }
+
+ return md5(
+ $hashElements
+ . __CLASS__
+ );
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $vars = get_object_vars($this);
+ foreach ($vars as $key => $value) {
+ $newValue = is_object($value) ? (clone $value) : $value;
+ if (is_array($value)) {
+ $newValue = [];
+ foreach ($value as $key2 => $value2) {
+ $newValue[$key2] = is_object($value2) ? (clone $value2) : $value2;
+ }
+ }
+ $this->$key = $newValue;
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/Run.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/Run.php
new file mode 100644
index 00000000..6a6ccdd4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/Run.php
@@ -0,0 +1,71 @@
+font = new Font();
+ }
+
+ /**
+ * Get font.
+ */
+ public function getFont(): ?Font
+ {
+ return $this->font;
+ }
+
+ public function getFontOrThrow(): Font
+ {
+ if ($this->font === null) {
+ throw new SpreadsheetException('unexpected null font');
+ }
+
+ return $this->font;
+ }
+
+ /**
+ * Set font.
+ *
+ * @param ?Font $font Font
+ *
+ * @return $this
+ */
+ public function setFont(?Font $font = null): static
+ {
+ $this->font = $font;
+
+ return $this;
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ return md5(
+ $this->getText()
+ . (($this->font === null) ? '' : $this->font->getHashCode())
+ . __CLASS__
+ );
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/TextElement.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/TextElement.php
new file mode 100644
index 00000000..e509d272
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/RichText/TextElement.php
@@ -0,0 +1,69 @@
+text = $text;
+ }
+
+ /**
+ * Get text.
+ *
+ * @return string Text
+ */
+ public function getText(): string
+ {
+ return $this->text;
+ }
+
+ /**
+ * Set text.
+ *
+ * @param string $text Text
+ *
+ * @return $this
+ */
+ public function setText(string $text): self
+ {
+ $this->text = $text;
+
+ return $this;
+ }
+
+ /**
+ * Get font. For this class, the return value is always null.
+ */
+ public function getFont(): ?Font
+ {
+ return null;
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ return md5(
+ $this->text
+ . __CLASS__
+ );
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Settings.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Settings.php
new file mode 100644
index 00000000..d32ef7c4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Settings.php
@@ -0,0 +1,189 @@
+
+ */
+ private static ?string $chartRenderer = null;
+
+ /**
+ * Default options for libxml loader.
+ */
+ private static ?int $libXmlLoaderOptions = null;
+
+ /**
+ * The cache implementation to be used for cell collection.
+ */
+ private static ?CacheInterface $cache = null;
+
+ /**
+ * The HTTP client implementation to be used for network request.
+ */
+ private static ?ClientInterface $httpClient = null;
+
+ private static ?RequestFactoryInterface $requestFactory = null;
+
+ /**
+ * Set the locale code to use for formula translations and any special formatting.
+ *
+ * @param string $locale The locale code to use (e.g. "fr" or "pt_br" or "en_uk")
+ *
+ * @return bool Success or failure
+ */
+ public static function setLocale(string $locale): bool
+ {
+ return Calculation::getInstance()->setLocale($locale);
+ }
+
+ public static function getLocale(): string
+ {
+ return Calculation::getInstance()->getLocale();
+ }
+
+ /**
+ * Identify to PhpSpreadsheet the external library to use for rendering charts.
+ *
+ * @param class-string $rendererClassName Class name of the chart renderer
+ * eg: PhpOffice\PhpSpreadsheet\Chart\Renderer\JpGraph
+ */
+ public static function setChartRenderer(string $rendererClassName): void
+ {
+ if (!is_a($rendererClassName, IRenderer::class, true)) {
+ throw new Exception('Chart renderer must implement ' . IRenderer::class);
+ }
+
+ self::$chartRenderer = $rendererClassName;
+ }
+
+ public static function unsetChartRenderer(): void
+ {
+ self::$chartRenderer = null;
+ }
+
+ /**
+ * Return the Chart Rendering Library that PhpSpreadsheet is currently configured to use.
+ *
+ * @return null|class-string Class name of the chart renderer
+ * eg: PhpOffice\PhpSpreadsheet\Chart\Renderer\JpGraph
+ */
+ public static function getChartRenderer(): ?string
+ {
+ return self::$chartRenderer;
+ }
+
+ public static function htmlEntityFlags(): int
+ {
+ return ENT_COMPAT;
+ }
+
+ /**
+ * Set default options for libxml loader.
+ *
+ * @param ?int $options Default options for libxml loader
+ *
+ * @deprecated 3.5.0 no longer needed
+ */
+ public static function setLibXmlLoaderOptions(?int $options): int
+ {
+ if ($options === null) {
+ $options = defined('LIBXML_DTDLOAD') ? (LIBXML_DTDLOAD | LIBXML_DTDATTR) : 0;
+ }
+ self::$libXmlLoaderOptions = $options;
+
+ return $options;
+ }
+
+ /**
+ * Get default options for libxml loader.
+ * Defaults to LIBXML_DTDLOAD | LIBXML_DTDATTR when not set explicitly.
+ *
+ * @return int Default options for libxml loader
+ *
+ * @deprecated 3.5.0 no longer needed
+ */
+ public static function getLibXmlLoaderOptions(): int
+ {
+ return self::$libXmlLoaderOptions ?? (defined('LIBXML_DTDLOAD') ? (LIBXML_DTDLOAD | LIBXML_DTDATTR) : 0);
+ }
+
+ /**
+ * Sets the implementation of cache that should be used for cell collection.
+ */
+ public static function setCache(?CacheInterface $cache): void
+ {
+ self::$cache = $cache;
+ }
+
+ /**
+ * Gets the implementation of cache that is being used for cell collection.
+ */
+ public static function getCache(): CacheInterface
+ {
+ if (!self::$cache) {
+ self::$cache = self::useSimpleCacheVersion3() ? new Memory\SimpleCache3() : new Memory\SimpleCache1();
+ }
+
+ return self::$cache;
+ }
+
+ public static function useSimpleCacheVersion3(): bool
+ {
+ return (new ReflectionClass(CacheInterface::class))->getMethod('get')->getReturnType() !== null;
+ }
+
+ /**
+ * Set the HTTP client implementation to be used for network request.
+ */
+ public static function setHttpClient(ClientInterface $httpClient, RequestFactoryInterface $requestFactory): void
+ {
+ self::$httpClient = $httpClient;
+ self::$requestFactory = $requestFactory;
+ }
+
+ /**
+ * Unset the HTTP client configuration.
+ */
+ public static function unsetHttpClient(): void
+ {
+ self::$httpClient = null;
+ self::$requestFactory = null;
+ }
+
+ /**
+ * Get the HTTP client implementation to be used for network request.
+ */
+ public static function getHttpClient(): ClientInterface
+ {
+ if (!self::$httpClient || !self::$requestFactory) {
+ throw new Exception('HTTP client must be configured via Settings::setHttpClient() to be able to use WEBSERVICE function.');
+ }
+
+ return self::$httpClient;
+ }
+
+ /**
+ * Get the HTTP request factory.
+ */
+ public static function getRequestFactory(): RequestFactoryInterface
+ {
+ if (!self::$httpClient || !self::$requestFactory) {
+ throw new Exception('HTTP client must be configured via Settings::setHttpClient() to be able to use WEBSERVICE function.');
+ }
+
+ return self::$requestFactory;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/CodePage.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/CodePage.php
new file mode 100644
index 00000000..307f8d93
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/CodePage.php
@@ -0,0 +1,113 @@
+ 'CP1252', // CodePage is not always correctly set when the xls file was saved by Apple's Numbers program
+ 367 => 'ASCII', // ASCII
+ 437 => 'CP437', // OEM US
+ //720 => 'notsupported', // OEM Arabic
+ 737 => 'CP737', // OEM Greek
+ 775 => 'CP775', // OEM Baltic
+ 850 => 'CP850', // OEM Latin I
+ 852 => 'CP852', // OEM Latin II (Central European)
+ 855 => 'CP855', // OEM Cyrillic
+ 857 => 'CP857', // OEM Turkish
+ 858 => 'CP858', // OEM Multilingual Latin I with Euro
+ 860 => 'CP860', // OEM Portugese
+ 861 => 'CP861', // OEM Icelandic
+ 862 => 'CP862', // OEM Hebrew
+ 863 => 'CP863', // OEM Canadian (French)
+ 864 => 'CP864', // OEM Arabic
+ 865 => 'CP865', // OEM Nordic
+ 866 => 'CP866', // OEM Cyrillic (Russian)
+ 869 => 'CP869', // OEM Greek (Modern)
+ 874 => 'CP874', // ANSI Thai
+ 932 => 'CP932', // ANSI Japanese Shift-JIS
+ 936 => 'CP936', // ANSI Chinese Simplified GBK
+ 949 => 'CP949', // ANSI Korean (Wansung)
+ 950 => 'CP950', // ANSI Chinese Traditional BIG5
+ 1200 => 'UTF-16LE', // UTF-16 (BIFF8)
+ 1250 => 'CP1250', // ANSI Latin II (Central European)
+ 1251 => 'CP1251', // ANSI Cyrillic
+ 1252 => 'CP1252', // ANSI Latin I (BIFF4-BIFF7)
+ 1253 => 'CP1253', // ANSI Greek
+ 1254 => 'CP1254', // ANSI Turkish
+ 1255 => 'CP1255', // ANSI Hebrew
+ 1256 => 'CP1256', // ANSI Arabic
+ 1257 => 'CP1257', // ANSI Baltic
+ 1258 => 'CP1258', // ANSI Vietnamese
+ 1361 => 'CP1361', // ANSI Korean (Johab)
+ 10000 => 'MAC', // Apple Roman
+ 10001 => 'CP932', // Macintosh Japanese
+ 10002 => 'CP950', // Macintosh Chinese Traditional
+ 10003 => 'CP1361', // Macintosh Korean
+ 10004 => 'MACARABIC', // Apple Arabic
+ 10005 => 'MACHEBREW', // Apple Hebrew
+ 10006 => 'MACGREEK', // Macintosh Greek
+ 10007 => 'MACCYRILLIC', // Macintosh Cyrillic
+ 10008 => 'CP936', // Macintosh - Simplified Chinese (GB 2312)
+ 10010 => 'MACROMANIA', // Macintosh Romania
+ 10017 => 'MACUKRAINE', // Macintosh Ukraine
+ 10021 => 'MACTHAI', // Macintosh Thai
+ 10029 => ['MACCENTRALEUROPE', 'MAC-CENTRALEUROPE'], // Macintosh Central Europe
+ 10079 => 'MACICELAND', // Macintosh Icelandic
+ 10081 => 'MACTURKISH', // Macintosh Turkish
+ 10082 => 'MACCROATIAN', // Macintosh Croatian
+ 21010 => 'UTF-16LE', // UTF-16 (BIFF8) This isn't correct, but some Excel writer libraries erroneously use Codepage 21010 for UTF-16LE
+ 32768 => 'MAC', // Apple Roman
+ //32769 => 'unsupported', // ANSI Latin I (BIFF2-BIFF3)
+ 65000 => 'UTF-7', // Unicode (UTF-7)
+ 65001 => 'UTF-8', // Unicode (UTF-8)
+ 99999 => ['unsupported'], // Unicode (UTF-8)
+ ];
+
+ public static function validate(string $codePage): bool
+ {
+ return in_array($codePage, self::$pageArray, true);
+ }
+
+ /**
+ * Convert Microsoft Code Page Identifier to Code Page Name which iconv
+ * and mbstring understands.
+ *
+ * @param int $codePage Microsoft Code Page Indentifier
+ *
+ * @return string Code Page Name
+ */
+ public static function numberToName(int $codePage): string
+ {
+ if (array_key_exists($codePage, self::$pageArray)) {
+ $value = self::$pageArray[$codePage];
+ if (is_array($value)) {
+ foreach ($value as $encoding) {
+ if (@iconv('UTF-8', $encoding, ' ') !== false) {
+ self::$pageArray[$codePage] = $encoding;
+
+ return $encoding;
+ }
+ }
+
+ throw new PhpSpreadsheetException("Code page $codePage not implemented on this system.");
+ } else {
+ return $value;
+ }
+ }
+ if ($codePage == 720 || $codePage == 32769) {
+ throw new PhpSpreadsheetException("Code page $codePage not supported."); // OEM Arabic
+ }
+
+ throw new PhpSpreadsheetException('Unknown codepage: ' . $codePage);
+ }
+
+ public static function getEncodings(): array
+ {
+ return self::$pageArray;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Date.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Date.php
new file mode 100644
index 00000000..b8feeb9c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Date.php
@@ -0,0 +1,547 @@
+ 'January',
+ 'Feb' => 'February',
+ 'Mar' => 'March',
+ 'Apr' => 'April',
+ 'May' => 'May',
+ 'Jun' => 'June',
+ 'Jul' => 'July',
+ 'Aug' => 'August',
+ 'Sep' => 'September',
+ 'Oct' => 'October',
+ 'Nov' => 'November',
+ 'Dec' => 'December',
+ ];
+
+ /**
+ * @var string[]
+ */
+ public static array $numberSuffixes = [
+ 'st',
+ 'nd',
+ 'rd',
+ 'th',
+ ];
+
+ /**
+ * Base calendar year to use for calculations
+ * Value is either CALENDAR_WINDOWS_1900 (1900) or CALENDAR_MAC_1904 (1904).
+ */
+ protected static int $excelCalendar = self::CALENDAR_WINDOWS_1900;
+
+ /**
+ * Default timezone to use for DateTime objects.
+ */
+ protected static ?DateTimeZone $defaultTimeZone = null;
+
+ /**
+ * Set the Excel calendar (Windows 1900 or Mac 1904).
+ *
+ * @param ?int $baseYear Excel base date (1900 or 1904)
+ *
+ * @return bool Success or failure
+ */
+ public static function setExcelCalendar(?int $baseYear): bool
+ {
+ if (
+ ($baseYear === self::CALENDAR_WINDOWS_1900)
+ || ($baseYear === self::CALENDAR_MAC_1904)
+ ) {
+ self::$excelCalendar = $baseYear;
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * Return the Excel calendar (Windows 1900 or Mac 1904).
+ *
+ * @return int Excel base date (1900 or 1904)
+ */
+ public static function getExcelCalendar(): int
+ {
+ return self::$excelCalendar;
+ }
+
+ /**
+ * Set the Default timezone to use for dates.
+ *
+ * @param null|DateTimeZone|string $timeZone The timezone to set for all Excel datetimestamp to PHP DateTime Object conversions
+ *
+ * @return bool Success or failure
+ */
+ public static function setDefaultTimezone($timeZone): bool
+ {
+ try {
+ $timeZone = self::validateTimeZone($timeZone);
+ self::$defaultTimeZone = $timeZone;
+ $retval = true;
+ } catch (PhpSpreadsheetException) {
+ $retval = false;
+ }
+
+ return $retval;
+ }
+
+ /**
+ * Return the Default timezone, or UTC if default not set.
+ */
+ public static function getDefaultTimezone(): DateTimeZone
+ {
+ return self::$defaultTimeZone ?? new DateTimeZone('UTC');
+ }
+
+ /**
+ * Return the Default timezone, or local timezone if default is not set.
+ */
+ public static function getDefaultOrLocalTimezone(): DateTimeZone
+ {
+ return self::$defaultTimeZone ?? new DateTimeZone(date_default_timezone_get());
+ }
+
+ /**
+ * Return the Default timezone even if null.
+ */
+ public static function getDefaultTimezoneOrNull(): ?DateTimeZone
+ {
+ return self::$defaultTimeZone;
+ }
+
+ /**
+ * Validate a timezone.
+ *
+ * @param null|DateTimeZone|string $timeZone The timezone to validate, either as a timezone string or object
+ *
+ * @return ?DateTimeZone The timezone as a timezone object
+ */
+ private static function validateTimeZone($timeZone): ?DateTimeZone
+ {
+ if ($timeZone instanceof DateTimeZone || $timeZone === null) {
+ return $timeZone;
+ }
+ if (in_array($timeZone, DateTimeZone::listIdentifiers(DateTimeZone::ALL_WITH_BC))) {
+ return new DateTimeZone($timeZone);
+ }
+
+ throw new PhpSpreadsheetException('Invalid timezone');
+ }
+
+ /**
+ * @param mixed $value Converts a date/time in ISO-8601 standard format date string to an Excel
+ * serialized timestamp.
+ * See https://en.wikipedia.org/wiki/ISO_8601 for details of the ISO-8601 standard format.
+ */
+ public static function convertIsoDate(mixed $value): float|int
+ {
+ if (!is_string($value)) {
+ throw new Exception('Non-string value supplied for Iso Date conversion');
+ }
+
+ $date = new DateTime($value);
+ $dateErrors = DateTime::getLastErrors();
+
+ if (is_array($dateErrors) && ($dateErrors['warning_count'] > 0 || $dateErrors['error_count'] > 0)) {
+ throw new Exception("Invalid string $value supplied for datatype Date");
+ }
+
+ $newValue = self::PHPToExcel($date);
+ if ($newValue === false) {
+ throw new Exception("Invalid string $value supplied for datatype Date");
+ }
+
+ if (preg_match('/^\\s*\\d?\\d:\\d\\d(:\\d\\d([.]\\d+)?)?\\s*(am|pm)?\\s*$/i', $value) == 1) {
+ $newValue = fmod($newValue, 1.0);
+ }
+
+ return $newValue;
+ }
+
+ /**
+ * Convert a MS serialized datetime value from Excel to a PHP Date/Time object.
+ *
+ * @param float|int $excelTimestamp MS Excel serialized date/time value
+ * @param null|DateTimeZone|string $timeZone The timezone to assume for the Excel timestamp,
+ * if you don't want to treat it as a UTC value
+ * Use the default (UTC) unless you absolutely need a conversion
+ *
+ * @return DateTime PHP date/time object
+ */
+ public static function excelToDateTimeObject(float|int $excelTimestamp, null|DateTimeZone|string $timeZone = null): DateTime
+ {
+ $timeZone = ($timeZone === null) ? self::getDefaultTimezone() : self::validateTimeZone($timeZone);
+ if (Functions::getCompatibilityMode() == Functions::COMPATIBILITY_EXCEL) {
+ if ($excelTimestamp < 1 && self::$excelCalendar === self::CALENDAR_WINDOWS_1900) {
+ // Unix timestamp base date
+ $baseDate = new DateTime('1970-01-01', $timeZone);
+ } else {
+ // MS Excel calendar base dates
+ if (self::$excelCalendar == self::CALENDAR_WINDOWS_1900) {
+ // Allow adjustment for 1900 Leap Year in MS Excel
+ $baseDate = ($excelTimestamp < 60) ? new DateTime('1899-12-31', $timeZone) : new DateTime('1899-12-30', $timeZone);
+ } else {
+ $baseDate = new DateTime('1904-01-01', $timeZone);
+ }
+ }
+ } else {
+ $baseDate = new DateTime('1899-12-30', $timeZone);
+ }
+
+ $days = floor($excelTimestamp);
+ $partDay = $excelTimestamp - $days;
+ $hms = 86400 * $partDay;
+ $microseconds = (int) round(fmod($hms, 1) * 1000000);
+ $hms = (int) floor($hms);
+ $hours = intdiv($hms, 3600);
+ $hms -= $hours * 3600;
+ $minutes = intdiv($hms, 60);
+ $seconds = $hms % 60;
+
+ if ($days >= 0) {
+ $days = '+' . $days;
+ }
+ $interval = $days . ' days';
+
+ return $baseDate->modify($interval)
+ ->setTime($hours, $minutes, $seconds, $microseconds);
+ }
+
+ /**
+ * Convert a MS serialized datetime value from Excel to a unix timestamp.
+ * The use of Unix timestamps, and therefore this function, is discouraged.
+ * They are not Y2038-safe on a 32-bit system, and have no timezone info.
+ *
+ * @param float|int $excelTimestamp MS Excel serialized date/time value
+ * @param null|DateTimeZone|string $timeZone The timezone to assume for the Excel timestamp,
+ * if you don't want to treat it as a UTC value
+ * Use the default (UTC) unless you absolutely need a conversion
+ *
+ * @return int Unix timetamp for this date/time
+ */
+ public static function excelToTimestamp($excelTimestamp, $timeZone = null): int
+ {
+ $dto = self::excelToDateTimeObject($excelTimestamp, $timeZone);
+ self::roundMicroseconds($dto);
+
+ return (int) $dto->format('U');
+ }
+
+ /**
+ * Convert a date from PHP to an MS Excel serialized date/time value.
+ *
+ * @param mixed $dateValue PHP DateTime object or a string - Unix timestamp is also permitted, but discouraged;
+ * not Y2038-safe on a 32-bit system, and no timezone info
+ *
+ * @return false|float Excel date/time value
+ * or boolean FALSE on failure
+ */
+ public static function PHPToExcel(mixed $dateValue)
+ {
+ if ((is_object($dateValue)) && ($dateValue instanceof DateTimeInterface)) {
+ return self::dateTimeToExcel($dateValue);
+ } elseif (is_numeric($dateValue)) {
+ return self::timestampToExcel($dateValue);
+ } elseif (is_string($dateValue)) {
+ return self::stringToExcel($dateValue);
+ }
+
+ return false;
+ }
+
+ /**
+ * Convert a PHP DateTime object to an MS Excel serialized date/time value.
+ *
+ * @param DateTimeInterface $dateValue PHP DateTime object
+ *
+ * @return float MS Excel serialized date/time value
+ */
+ public static function dateTimeToExcel(DateTimeInterface $dateValue): float
+ {
+ $seconds = (float) sprintf('%d.%06d', $dateValue->format('s'), $dateValue->format('u'));
+
+ return self::formattedPHPToExcel(
+ (int) $dateValue->format('Y'),
+ (int) $dateValue->format('m'),
+ (int) $dateValue->format('d'),
+ (int) $dateValue->format('H'),
+ (int) $dateValue->format('i'),
+ $seconds
+ );
+ }
+
+ /**
+ * Convert a Unix timestamp to an MS Excel serialized date/time value.
+ * The use of Unix timestamps, and therefore this function, is discouraged.
+ * They are not Y2038-safe on a 32-bit system, and have no timezone info.
+ *
+ * @param float|int|string $unixTimestamp Unix Timestamp
+ *
+ * @return false|float MS Excel serialized date/time value
+ */
+ public static function timestampToExcel($unixTimestamp): bool|float
+ {
+ if (!is_numeric($unixTimestamp)) {
+ return false;
+ }
+
+ return self::dateTimeToExcel(new DateTime('@' . $unixTimestamp));
+ }
+
+ /**
+ * formattedPHPToExcel.
+ *
+ * @return float Excel date/time value
+ */
+ public static function formattedPHPToExcel(int $year, int $month, int $day, int $hours = 0, int $minutes = 0, float|int $seconds = 0): float
+ {
+ if (self::$excelCalendar == self::CALENDAR_WINDOWS_1900) {
+ //
+ // Fudge factor for the erroneous fact that the year 1900 is treated as a Leap Year in MS Excel
+ // This affects every date following 28th February 1900
+ //
+ $excel1900isLeapYear = true;
+ if (($year == 1900) && ($month <= 2)) {
+ $excel1900isLeapYear = false;
+ }
+ $myexcelBaseDate = 2415020;
+ } else {
+ $myexcelBaseDate = 2416481;
+ $excel1900isLeapYear = false;
+ }
+
+ // Julian base date Adjustment
+ if ($month > 2) {
+ $month -= 3;
+ } else {
+ $month += 9;
+ --$year;
+ }
+
+ // Calculate the Julian Date, then subtract the Excel base date (JD 2415020 = 31-Dec-1899 Giving Excel Date of 0)
+ $century = (int) substr((string) $year, 0, 2);
+ $decade = (int) substr((string) $year, 2, 2);
+ $excelDate = floor((146097 * $century) / 4) + floor((1461 * $decade) / 4) + floor((153 * $month + 2) / 5) + $day + 1721119 - $myexcelBaseDate + $excel1900isLeapYear;
+
+ $excelTime = (($hours * 3600) + ($minutes * 60) + $seconds) / 86400;
+
+ return (float) $excelDate + $excelTime;
+ }
+
+ /**
+ * Is a given cell a date/time?
+ */
+ public static function isDateTime(Cell $cell, mixed $value = null, bool $dateWithoutTimeOkay = true): bool
+ {
+ $result = false;
+ $worksheet = $cell->getWorksheetOrNull();
+ $spreadsheet = ($worksheet === null) ? null : $worksheet->getParent();
+ if ($worksheet !== null && $spreadsheet !== null) {
+ $index = $spreadsheet->getActiveSheetIndex();
+ $selected = $worksheet->getSelectedCells();
+
+ try {
+ $result = is_numeric($value ?? $cell->getCalculatedValue())
+ && self::isDateTimeFormat(
+ $worksheet->getStyle(
+ $cell->getCoordinate()
+ )->getNumberFormat(),
+ $dateWithoutTimeOkay
+ );
+ } catch (Exception) {
+ // Result is already false, so no need to actually do anything here
+ }
+ $worksheet->setSelectedCells($selected);
+ $spreadsheet->setActiveSheetIndex($index);
+ }
+
+ return $result;
+ }
+
+ /**
+ * Is a given NumberFormat code a date/time format code?
+ */
+ public static function isDateTimeFormat(NumberFormat $excelFormatCode, bool $dateWithoutTimeOkay = true): bool
+ {
+ return self::isDateTimeFormatCode((string) $excelFormatCode->getFormatCode(), $dateWithoutTimeOkay);
+ }
+
+ private const POSSIBLE_DATETIME_FORMAT_CHARACTERS = 'eymdHs';
+ private const POSSIBLE_TIME_FORMAT_CHARACTERS = 'Hs'; // note - no 'm' due to ambiguity
+
+ /**
+ * Is a given number format code a date/time?
+ */
+ public static function isDateTimeFormatCode(string $excelFormatCode, bool $dateWithoutTimeOkay = true): bool
+ {
+ if (strtolower($excelFormatCode) === strtolower(NumberFormat::FORMAT_GENERAL)) {
+ // "General" contains an epoch letter 'e', so we trap for it explicitly here (case-insensitive check)
+ return false;
+ }
+ if (preg_match('/[0#]E[+-]0/i', $excelFormatCode)) {
+ // Scientific format
+ return false;
+ }
+
+ // Switch on formatcode
+ $excelFormatCode = (string) NumberFormat::convertSystemFormats($excelFormatCode);
+ if (in_array($excelFormatCode, NumberFormat::DATE_TIME_OR_DATETIME_ARRAY, true)) {
+ return $dateWithoutTimeOkay || in_array($excelFormatCode, NumberFormat::TIME_OR_DATETIME_ARRAY);
+ }
+
+ // Typically number, currency or accounting (or occasionally fraction) formats
+ if ((str_starts_with($excelFormatCode, '_')) || (str_starts_with($excelFormatCode, '0 '))) {
+ return false;
+ }
+ // Some "special formats" provided in German Excel versions were detected as date time value,
+ // so filter them out here - "\C\H\-00000" (Switzerland) and "\D-00000" (Germany).
+ if (str_contains($excelFormatCode, '-00000')) {
+ return false;
+ }
+ $possibleFormatCharacters = $dateWithoutTimeOkay ? self::POSSIBLE_DATETIME_FORMAT_CHARACTERS : self::POSSIBLE_TIME_FORMAT_CHARACTERS;
+ // Try checking for any of the date formatting characters that don't appear within square braces
+ if (preg_match('/(^|\])[^\[]*[' . $possibleFormatCharacters . ']/i', $excelFormatCode)) {
+ // We might also have a format mask containing quoted strings...
+ // we don't want to test for any of our characters within the quoted blocks
+ if (str_contains($excelFormatCode, '"')) {
+ $segMatcher = false;
+ foreach (explode('"', $excelFormatCode) as $subVal) {
+ // Only test in alternate array entries (the non-quoted blocks)
+ $segMatcher = $segMatcher === false;
+ if (
+ $segMatcher
+ && (preg_match('/(^|\])[^\[]*[' . $possibleFormatCharacters . ']/i', $subVal))
+ ) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ return true;
+ }
+
+ // No date...
+ return false;
+ }
+
+ /**
+ * Convert a date/time string to Excel time.
+ *
+ * @param string $dateValue Examples: '2009-12-31', '2009-12-31 15:59', '2009-12-31 15:59:10'
+ *
+ * @return false|float Excel date/time serial value
+ */
+ public static function stringToExcel(string $dateValue): bool|float
+ {
+ if (strlen($dateValue) < 2) {
+ return false;
+ }
+ if (!preg_match('/^(\d{1,4}[ \.\/\-][A-Z]{3,9}([ \.\/\-]\d{1,4})?|[A-Z]{3,9}[ \.\/\-]\d{1,4}([ \.\/\-]\d{1,4})?|\d{1,4}[ \.\/\-]\d{1,4}([ \.\/\-]\d{1,4})?)( \d{1,2}:\d{1,2}(:\d{1,2})?)?$/iu', $dateValue)) {
+ return false;
+ }
+
+ $dateValueNew = DateTimeExcel\DateValue::fromString($dateValue);
+
+ if (!is_float($dateValueNew)) {
+ return false;
+ }
+
+ if (str_contains($dateValue, ':')) {
+ $timeValue = DateTimeExcel\TimeValue::fromString($dateValue);
+ if (!is_float($timeValue)) {
+ return false;
+ }
+ $dateValueNew += $timeValue;
+ }
+
+ return $dateValueNew;
+ }
+
+ /**
+ * Converts a month name (either a long or a short name) to a month number.
+ *
+ * @param string $monthName Month name or abbreviation
+ *
+ * @return int|string Month number (1 - 12), or the original string argument if it isn't a valid month name
+ */
+ public static function monthStringToNumber(string $monthName)
+ {
+ $monthIndex = 1;
+ foreach (self::$monthNames as $shortMonthName => $longMonthName) {
+ if (($monthName === $longMonthName) || ($monthName === $shortMonthName)) {
+ return $monthIndex;
+ }
+ ++$monthIndex;
+ }
+
+ return $monthName;
+ }
+
+ /**
+ * Strips an ordinal from a numeric value.
+ *
+ * @param string $day Day number with an ordinal
+ *
+ * @return int|string The integer value with any ordinal stripped, or the original string argument if it isn't a valid numeric
+ */
+ public static function dayStringToNumber(string $day)
+ {
+ $strippedDayValue = (str_replace(self::$numberSuffixes, '', $day));
+ if (is_numeric($strippedDayValue)) {
+ return (int) $strippedDayValue;
+ }
+
+ return $day;
+ }
+
+ public static function dateTimeFromTimestamp(string $date, ?DateTimeZone $timeZone = null): DateTime
+ {
+ $dtobj = DateTime::createFromFormat('U', $date) ?: new DateTime();
+ $dtobj->setTimeZone($timeZone ?? self::getDefaultOrLocalTimezone());
+
+ return $dtobj;
+ }
+
+ public static function formattedDateTimeFromTimestamp(string $date, string $format, ?DateTimeZone $timeZone = null): string
+ {
+ $dtobj = self::dateTimeFromTimestamp($date, $timeZone);
+
+ return $dtobj->format($format);
+ }
+
+ public static function roundMicroseconds(DateTime $dti): void
+ {
+ $microseconds = (int) $dti->format('u');
+ if ($microseconds >= 500000) {
+ $dti->modify('+1 second');
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Drawing.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Drawing.php
new file mode 100644
index 00000000..4eef7911
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Drawing.php
@@ -0,0 +1,152 @@
+getName();
+ $size = $defaultFont->getSize();
+
+ if (isset(Font::DEFAULT_COLUMN_WIDTHS[$name][$size])) {
+ // Exact width can be determined
+ return $pixelValue * Font::DEFAULT_COLUMN_WIDTHS[$name][$size]['width']
+ / Font::DEFAULT_COLUMN_WIDTHS[$name][$size]['px'];
+ }
+
+ // We don't have data for this particular font and size, use approximation by
+ // extrapolating from Calibri 11
+ return $pixelValue * 11 * Font::DEFAULT_COLUMN_WIDTHS['Calibri'][11]['width']
+ / Font::DEFAULT_COLUMN_WIDTHS['Calibri'][11]['px'] / $size;
+ }
+
+ /**
+ * Convert column width from (intrinsic) Excel units to pixels.
+ *
+ * @param float $cellWidth Value in cell dimension
+ * @param \PhpOffice\PhpSpreadsheet\Style\Font $defaultFont Default font of the workbook
+ *
+ * @return int Value in pixels
+ */
+ public static function cellDimensionToPixels(float $cellWidth, \PhpOffice\PhpSpreadsheet\Style\Font $defaultFont): int
+ {
+ // Font name and size
+ $name = $defaultFont->getName();
+ $size = $defaultFont->getSize();
+
+ if (isset(Font::DEFAULT_COLUMN_WIDTHS[$name][$size])) {
+ // Exact width can be determined
+ $colWidth = $cellWidth * Font::DEFAULT_COLUMN_WIDTHS[$name][$size]['px']
+ / Font::DEFAULT_COLUMN_WIDTHS[$name][$size]['width'];
+ } else {
+ // We don't have data for this particular font and size, use approximation by
+ // extrapolating from Calibri 11
+ $colWidth = $cellWidth * $size * Font::DEFAULT_COLUMN_WIDTHS['Calibri'][11]['px']
+ / Font::DEFAULT_COLUMN_WIDTHS['Calibri'][11]['width'] / 11;
+ }
+
+ // Round pixels to closest integer
+ $colWidth = (int) round($colWidth);
+
+ return $colWidth;
+ }
+
+ /**
+ * Convert pixels to points.
+ *
+ * @param int $pixelValue Value in pixels
+ *
+ * @return float Value in points
+ */
+ public static function pixelsToPoints(int $pixelValue): float
+ {
+ return $pixelValue * 0.75;
+ }
+
+ /**
+ * Convert points to pixels.
+ *
+ * @param float|int $pointValue Value in points
+ *
+ * @return int Value in pixels
+ */
+ public static function pointsToPixels($pointValue): int
+ {
+ if ($pointValue != 0) {
+ return (int) ceil($pointValue / 0.75);
+ }
+
+ return 0;
+ }
+
+ /**
+ * Convert degrees to angle.
+ *
+ * @param int $degrees Degrees
+ *
+ * @return int Angle
+ */
+ public static function degreesToAngle(int $degrees): int
+ {
+ return (int) round($degrees * 60000);
+ }
+
+ /**
+ * Convert angle to degrees.
+ *
+ * @param int|SimpleXMLElement $angle Angle
+ *
+ * @return int Degrees
+ */
+ public static function angleToDegrees($angle): int
+ {
+ $angle = (int) $angle;
+ if ($angle != 0) {
+ return (int) round($angle / 60000);
+ }
+
+ return 0;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher.php
new file mode 100644
index 00000000..9eb9956a
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher.php
@@ -0,0 +1,48 @@
+dggContainer;
+ }
+
+ /**
+ * Set Drawing Group Container.
+ */
+ public function setDggContainer(Escher\DggContainer $dggContainer): Escher\DggContainer
+ {
+ return $this->dggContainer = $dggContainer;
+ }
+
+ /**
+ * Get Drawing Container.
+ */
+ public function getDgContainer(): ?Escher\DgContainer
+ {
+ return $this->dgContainer;
+ }
+
+ /**
+ * Set Drawing Container.
+ */
+ public function setDgContainer(Escher\DgContainer $dgContainer): Escher\DgContainer
+ {
+ return $this->dgContainer = $dgContainer;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer.php
new file mode 100644
index 00000000..0f4b7a86
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer.php
@@ -0,0 +1,60 @@
+dgId;
+ }
+
+ public function setDgId(int $value): void
+ {
+ $this->dgId = $value;
+ }
+
+ public function getLastSpId(): ?int
+ {
+ return $this->lastSpId;
+ }
+
+ public function setLastSpId(int $value): void
+ {
+ $this->lastSpId = $value;
+ }
+
+ public function getSpgrContainer(): ?SpgrContainer
+ {
+ return $this->spgrContainer;
+ }
+
+ public function getSpgrContainerOrThrow(): SpgrContainer
+ {
+ if ($this->spgrContainer !== null) {
+ return $this->spgrContainer;
+ }
+
+ throw new SpreadsheetException('spgrContainer is unexpectedly null');
+ }
+
+ public function setSpgrContainer(SpgrContainer $spgrContainer): SpgrContainer
+ {
+ return $this->spgrContainer = $spgrContainer;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer/SpgrContainer.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer/SpgrContainer.php
new file mode 100644
index 00000000..84363ab2
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer/SpgrContainer.php
@@ -0,0 +1,71 @@
+parent = $parent;
+ }
+
+ /**
+ * Get the parent Shape Group Container if any.
+ */
+ public function getParent(): ?self
+ {
+ return $this->parent;
+ }
+
+ /**
+ * Add a child. This will be either spgrContainer or spContainer.
+ *
+ * @param SpgrContainer|SpgrContainer\SpContainer $child child to be added
+ */
+ public function addChild(mixed $child): void
+ {
+ $this->children[] = $child;
+ $child->setParent($this);
+ }
+
+ /**
+ * Get collection of Shape Containers.
+ */
+ public function getChildren(): array
+ {
+ return $this->children;
+ }
+
+ /**
+ * Recursively get all spContainers within this spgrContainer.
+ *
+ * @return SpgrContainer\SpContainer[]
+ */
+ public function getAllSpContainers(): array
+ {
+ $allSpContainers = [];
+
+ foreach ($this->children as $child) {
+ if ($child instanceof self) {
+ $allSpContainers = array_merge($allSpContainers, $child->getAllSpContainers());
+ } else {
+ $allSpContainers[] = $child;
+ }
+ }
+
+ return $allSpContainers;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer/SpgrContainer/SpContainer.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer/SpgrContainer/SpContainer.php
new file mode 100644
index 00000000..c462d454
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DgContainer/SpgrContainer/SpContainer.php
@@ -0,0 +1,300 @@
+parent = $parent;
+ }
+
+ /**
+ * Get the parent Shape Group Container.
+ */
+ public function getParent(): SpgrContainer
+ {
+ return $this->parent;
+ }
+
+ /**
+ * Set whether this is a group shape.
+ */
+ public function setSpgr(bool $value): void
+ {
+ $this->spgr = $value;
+ }
+
+ /**
+ * Get whether this is a group shape.
+ */
+ public function getSpgr(): bool
+ {
+ return $this->spgr;
+ }
+
+ /**
+ * Set the shape type.
+ */
+ public function setSpType(int $value): void
+ {
+ $this->spType = $value;
+ }
+
+ /**
+ * Get the shape type.
+ */
+ public function getSpType(): int
+ {
+ return $this->spType;
+ }
+
+ /**
+ * Set the shape flag.
+ */
+ public function setSpFlag(int $value): void
+ {
+ $this->spFlag = $value;
+ }
+
+ /**
+ * Get the shape flag.
+ */
+ public function getSpFlag(): int
+ {
+ return $this->spFlag;
+ }
+
+ /**
+ * Set the shape index.
+ */
+ public function setSpId(int $value): void
+ {
+ $this->spId = $value;
+ }
+
+ /**
+ * Get the shape index.
+ */
+ public function getSpId(): int
+ {
+ return $this->spId;
+ }
+
+ /**
+ * Set an option for the Shape Group Container.
+ *
+ * @param int $property The number specifies the option
+ */
+ public function setOPT(int $property, mixed $value): void
+ {
+ $this->OPT[$property] = $value;
+ }
+
+ /**
+ * Get an option for the Shape Group Container.
+ *
+ * @param int $property The number specifies the option
+ */
+ public function getOPT(int $property): mixed
+ {
+ if (isset($this->OPT[$property])) {
+ return $this->OPT[$property];
+ }
+
+ return null;
+ }
+
+ /**
+ * Get the collection of options.
+ */
+ public function getOPTCollection(): array
+ {
+ return $this->OPT;
+ }
+
+ /**
+ * Set cell coordinates of upper-left corner of shape.
+ *
+ * @param string $value eg: 'A1'
+ */
+ public function setStartCoordinates(string $value): void
+ {
+ $this->startCoordinates = $value;
+ }
+
+ /**
+ * Get cell coordinates of upper-left corner of shape.
+ */
+ public function getStartCoordinates(): string
+ {
+ return $this->startCoordinates;
+ }
+
+ /**
+ * Set offset in x-direction of upper-left corner of shape measured in 1/1024 of column width.
+ */
+ public function setStartOffsetX(int|float $startOffsetX): void
+ {
+ $this->startOffsetX = $startOffsetX;
+ }
+
+ /**
+ * Get offset in x-direction of upper-left corner of shape measured in 1/1024 of column width.
+ */
+ public function getStartOffsetX(): int|float
+ {
+ return $this->startOffsetX;
+ }
+
+ /**
+ * Set offset in y-direction of upper-left corner of shape measured in 1/256 of row height.
+ */
+ public function setStartOffsetY(int|float $startOffsetY): void
+ {
+ $this->startOffsetY = $startOffsetY;
+ }
+
+ /**
+ * Get offset in y-direction of upper-left corner of shape measured in 1/256 of row height.
+ */
+ public function getStartOffsetY(): int|float
+ {
+ return $this->startOffsetY;
+ }
+
+ /**
+ * Set cell coordinates of bottom-right corner of shape.
+ *
+ * @param string $value eg: 'A1'
+ */
+ public function setEndCoordinates(string $value): void
+ {
+ $this->endCoordinates = $value;
+ }
+
+ /**
+ * Get cell coordinates of bottom-right corner of shape.
+ */
+ public function getEndCoordinates(): string
+ {
+ return $this->endCoordinates;
+ }
+
+ /**
+ * Set offset in x-direction of bottom-right corner of shape measured in 1/1024 of column width.
+ */
+ public function setEndOffsetX(int|float $endOffsetX): void
+ {
+ $this->endOffsetX = $endOffsetX;
+ }
+
+ /**
+ * Get offset in x-direction of bottom-right corner of shape measured in 1/1024 of column width.
+ */
+ public function getEndOffsetX(): int|float
+ {
+ return $this->endOffsetX;
+ }
+
+ /**
+ * Set offset in y-direction of bottom-right corner of shape measured in 1/256 of row height.
+ */
+ public function setEndOffsetY(int|float $endOffsetY): void
+ {
+ $this->endOffsetY = $endOffsetY;
+ }
+
+ /**
+ * Get offset in y-direction of bottom-right corner of shape measured in 1/256 of row height.
+ */
+ public function getEndOffsetY(): int|float
+ {
+ return $this->endOffsetY;
+ }
+
+ /**
+ * Get the nesting level of this spContainer. This is the number of spgrContainers between this spContainer and
+ * the dgContainer. A value of 1 = immediately within first spgrContainer
+ * Higher nesting level occurs if and only if spContainer is part of a shape group.
+ *
+ * @return int Nesting level
+ */
+ public function getNestingLevel(): int
+ {
+ $nestingLevel = 0;
+
+ $parent = $this->getParent();
+ while ($parent instanceof SpgrContainer) {
+ ++$nestingLevel;
+ $parent = $parent->getParent();
+ }
+
+ return $nestingLevel;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer.php
new file mode 100644
index 00000000..d0bf1bb5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer.php
@@ -0,0 +1,140 @@
+spIdMax;
+ }
+
+ /**
+ * Set maximum shape index of all shapes in all drawings (plus one).
+ */
+ public function setSpIdMax(int $value): void
+ {
+ $this->spIdMax = $value;
+ }
+
+ /**
+ * Get total number of drawings saved.
+ */
+ public function getCDgSaved(): int
+ {
+ return $this->cDgSaved;
+ }
+
+ /**
+ * Set total number of drawings saved.
+ */
+ public function setCDgSaved(int $value): void
+ {
+ $this->cDgSaved = $value;
+ }
+
+ /**
+ * Get total number of shapes saved (including group shapes).
+ */
+ public function getCSpSaved(): int
+ {
+ return $this->cSpSaved;
+ }
+
+ /**
+ * Set total number of shapes saved (including group shapes).
+ */
+ public function setCSpSaved(int $value): void
+ {
+ $this->cSpSaved = $value;
+ }
+
+ /**
+ * Get BLIP Store Container.
+ */
+ public function getBstoreContainer(): ?DggContainer\BstoreContainer
+ {
+ return $this->bstoreContainer;
+ }
+
+ /**
+ * Set BLIP Store Container.
+ */
+ public function setBstoreContainer(DggContainer\BstoreContainer $bstoreContainer): void
+ {
+ $this->bstoreContainer = $bstoreContainer;
+ }
+
+ /**
+ * Set an option for the drawing group.
+ *
+ * @param int $property The number specifies the option
+ */
+ public function setOPT(int $property, mixed $value): void
+ {
+ $this->OPT[$property] = $value;
+ }
+
+ /**
+ * Get an option for the drawing group.
+ *
+ * @param int $property The number specifies the option
+ */
+ public function getOPT(int $property): mixed
+ {
+ if (isset($this->OPT[$property])) {
+ return $this->OPT[$property];
+ }
+
+ return null;
+ }
+
+ /**
+ * Get identifier clusters.
+ */
+ public function getIDCLs(): array
+ {
+ return $this->IDCLs;
+ }
+
+ /**
+ * Set identifier clusters. [ => , ...].
+ */
+ public function setIDCLs(array $IDCLs): void
+ {
+ $this->IDCLs = $IDCLs;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer.php
new file mode 100644
index 00000000..2d13b42d
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer.php
@@ -0,0 +1,32 @@
+BSECollection[] = $BSE;
+ $BSE->setParent($this);
+ }
+
+ /**
+ * Get the collection of BLIP Store Entries.
+ *
+ * @return BstoreContainer\BSE[]
+ */
+ public function getBSECollection(): array
+ {
+ return $this->BSECollection;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer/BSE.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer/BSE.php
new file mode 100644
index 00000000..98e3656c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer/BSE.php
@@ -0,0 +1,81 @@
+parent = $parent;
+ }
+
+ public function getParent(): BstoreContainer
+ {
+ return $this->parent;
+ }
+
+ /**
+ * Get the BLIP.
+ */
+ public function getBlip(): ?BSE\Blip
+ {
+ return $this->blip;
+ }
+
+ /**
+ * Set the BLIP.
+ */
+ public function setBlip(BSE\Blip $blip): void
+ {
+ $this->blip = $blip;
+ $blip->setParent($this);
+ }
+
+ /**
+ * Get the BLIP type.
+ */
+ public function getBlipType(): int
+ {
+ return $this->blipType;
+ }
+
+ /**
+ * Set the BLIP type.
+ */
+ public function setBlipType(int $blipType): void
+ {
+ $this->blipType = $blipType;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer/BSE/Blip.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer/BSE/Blip.php
new file mode 100644
index 00000000..763bfe57
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Escher/DggContainer/BstoreContainer/BSE/Blip.php
@@ -0,0 +1,50 @@
+data;
+ }
+
+ /**
+ * Set the raw image data.
+ */
+ public function setData(string $data): void
+ {
+ $this->data = $data;
+ }
+
+ /**
+ * Set parent BSE.
+ */
+ public function setParent(BSE $parent): void
+ {
+ $this->parent = $parent;
+ }
+
+ /**
+ * Get parent BSE.
+ */
+ public function getParent(): BSE
+ {
+ return $this->parent;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/File.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/File.php
new file mode 100644
index 00000000..022c1bb0
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/File.php
@@ -0,0 +1,195 @@
+open($zipFile);
+ if ($res === true) {
+ $returnValue = ($zip->getFromName($archiveFile) !== false);
+ $zip->close();
+
+ return $returnValue;
+ }
+ }
+
+ return false;
+ }
+
+ return file_exists($filename);
+ }
+
+ /**
+ * Returns canonicalized absolute pathname, also for ZIP archives.
+ */
+ public static function realpath(string $filename): string
+ {
+ // Returnvalue
+ $returnValue = '';
+
+ // Try using realpath()
+ if (file_exists($filename)) {
+ $returnValue = realpath($filename) ?: '';
+ }
+
+ // Found something?
+ if ($returnValue === '') {
+ $pathArray = explode('/', $filename);
+ while (in_array('..', $pathArray) && $pathArray[0] != '..') {
+ $iMax = count($pathArray);
+ for ($i = 1; $i < $iMax; ++$i) {
+ if ($pathArray[$i] == '..') {
+ array_splice($pathArray, $i - 1, 2);
+
+ break;
+ }
+ }
+ }
+ $returnValue = implode('/', $pathArray);
+ }
+
+ // Return
+ return $returnValue;
+ }
+
+ /**
+ * Get the systems temporary directory.
+ */
+ public static function sysGetTempDir(): string
+ {
+ $path = sys_get_temp_dir();
+ if (self::$useUploadTempDirectory) {
+ // use upload-directory when defined to allow running on environments having very restricted
+ // open_basedir configs
+ if (ini_get('upload_tmp_dir') !== false) {
+ if ($temp = ini_get('upload_tmp_dir')) {
+ if (file_exists($temp)) {
+ $path = $temp;
+ }
+ }
+ }
+ }
+
+ return realpath($path) ?: '';
+ }
+
+ public static function temporaryFilename(): string
+ {
+ $filename = tempnam(self::sysGetTempDir(), 'phpspreadsheet');
+ if ($filename === false) {
+ throw new Exception('Could not create temporary file');
+ }
+
+ return $filename;
+ }
+
+ /**
+ * Assert that given path is an existing file and is readable, otherwise throw exception.
+ */
+ public static function assertFile(string $filename, string $zipMember = ''): void
+ {
+ if (!is_file($filename)) {
+ throw new ReaderException('File "' . $filename . '" does not exist.');
+ }
+
+ if (!is_readable($filename)) {
+ throw new ReaderException('Could not open "' . $filename . '" for reading.');
+ }
+
+ if ($zipMember !== '') {
+ $zipfile = "zip://$filename#$zipMember";
+ if (!self::fileExists($zipfile)) {
+ // Has the file been saved with Windoze directory separators rather than unix?
+ $zipfile = "zip://$filename#" . str_replace('/', '\\', $zipMember);
+ if (!self::fileExists($zipfile)) {
+ throw new ReaderException("Could not find zip member $zipfile");
+ }
+ }
+ }
+ }
+
+ /**
+ * Same as assertFile, except return true/false and don't throw Exception.
+ */
+ public static function testFileNoThrow(string $filename, ?string $zipMember = null): bool
+ {
+ if (!is_file($filename)) {
+ return false;
+ }
+ if (!is_readable($filename)) {
+ return false;
+ }
+ if ($zipMember === null) {
+ return true;
+ }
+ // validate zip, but don't check specific member
+ if ($zipMember === '') {
+ return self::validateZipFirst4($filename);
+ }
+
+ $zipfile = "zip://$filename#$zipMember";
+ if (self::fileExists($zipfile)) {
+ return true;
+ }
+
+ // Has the file been saved with Windoze directory separators rather than unix?
+ $zipfile = "zip://$filename#" . str_replace('/', '\\', $zipMember);
+
+ return self::fileExists($zipfile);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Font.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Font.php
new file mode 100644
index 00000000..8a1225b1
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Font.php
@@ -0,0 +1,718 @@
+ [
+ 'x' => self::ARIAL,
+ 'xb' => self::ARIAL_BOLD,
+ 'xi' => self::ARIAL_ITALIC,
+ 'xbi' => self::ARIAL_BOLD_ITALIC,
+ ],
+ 'Calibri' => [
+ 'x' => self::CALIBRI,
+ 'xb' => self::CALIBRI_BOLD,
+ 'xi' => self::CALIBRI_ITALIC,
+ 'xbi' => self::CALIBRI_BOLD_ITALIC,
+ ],
+ 'Comic Sans MS' => [
+ 'x' => self::COMIC_SANS_MS,
+ 'xb' => self::COMIC_SANS_MS_BOLD,
+ 'xi' => self::COMIC_SANS_MS,
+ 'xbi' => self::COMIC_SANS_MS_BOLD,
+ ],
+ 'Courier New' => [
+ 'x' => self::COURIER_NEW,
+ 'xb' => self::COURIER_NEW_BOLD,
+ 'xi' => self::COURIER_NEW_ITALIC,
+ 'xbi' => self::COURIER_NEW_BOLD_ITALIC,
+ ],
+ 'Georgia' => [
+ 'x' => self::GEORGIA,
+ 'xb' => self::GEORGIA_BOLD,
+ 'xi' => self::GEORGIA_ITALIC,
+ 'xbi' => self::GEORGIA_BOLD_ITALIC,
+ ],
+ 'Impact' => [
+ 'x' => self::IMPACT,
+ 'xb' => self::IMPACT,
+ 'xi' => self::IMPACT,
+ 'xbi' => self::IMPACT,
+ ],
+ 'Liberation Sans' => [
+ 'x' => self::LIBERATION_SANS,
+ 'xb' => self::LIBERATION_SANS_BOLD,
+ 'xi' => self::LIBERATION_SANS_ITALIC,
+ 'xbi' => self::LIBERATION_SANS_BOLD_ITALIC,
+ ],
+ 'Lucida Console' => [
+ 'x' => self::LUCIDA_CONSOLE,
+ 'xb' => self::LUCIDA_CONSOLE,
+ 'xi' => self::LUCIDA_CONSOLE,
+ 'xbi' => self::LUCIDA_CONSOLE,
+ ],
+ 'Lucida Sans Unicode' => [
+ 'x' => self::LUCIDA_SANS_UNICODE,
+ 'xb' => self::LUCIDA_SANS_UNICODE,
+ 'xi' => self::LUCIDA_SANS_UNICODE,
+ 'xbi' => self::LUCIDA_SANS_UNICODE,
+ ],
+ 'Microsoft Sans Serif' => [
+ 'x' => self::MICROSOFT_SANS_SERIF,
+ 'xb' => self::MICROSOFT_SANS_SERIF,
+ 'xi' => self::MICROSOFT_SANS_SERIF,
+ 'xbi' => self::MICROSOFT_SANS_SERIF,
+ ],
+ 'Palatino Linotype' => [
+ 'x' => self::PALATINO_LINOTYPE,
+ 'xb' => self::PALATINO_LINOTYPE_BOLD,
+ 'xi' => self::PALATINO_LINOTYPE_ITALIC,
+ 'xbi' => self::PALATINO_LINOTYPE_BOLD_ITALIC,
+ ],
+ 'Symbol' => [
+ 'x' => self::SYMBOL,
+ 'xb' => self::SYMBOL,
+ 'xi' => self::SYMBOL,
+ 'xbi' => self::SYMBOL,
+ ],
+ 'Tahoma' => [
+ 'x' => self::TAHOMA,
+ 'xb' => self::TAHOMA_BOLD,
+ 'xi' => self::TAHOMA,
+ 'xbi' => self::TAHOMA_BOLD,
+ ],
+ 'Times New Roman' => [
+ 'x' => self::TIMES_NEW_ROMAN,
+ 'xb' => self::TIMES_NEW_ROMAN_BOLD,
+ 'xi' => self::TIMES_NEW_ROMAN_ITALIC,
+ 'xbi' => self::TIMES_NEW_ROMAN_BOLD_ITALIC,
+ ],
+ 'Trebuchet MS' => [
+ 'x' => self::TREBUCHET_MS,
+ 'xb' => self::TREBUCHET_MS_BOLD,
+ 'xi' => self::TREBUCHET_MS_ITALIC,
+ 'xbi' => self::TREBUCHET_MS_BOLD_ITALIC,
+ ],
+ 'Verdana' => [
+ 'x' => self::VERDANA,
+ 'xb' => self::VERDANA_BOLD,
+ 'xi' => self::VERDANA_ITALIC,
+ 'xbi' => self::VERDANA_BOLD_ITALIC,
+ ],
+ ];
+
+ /**
+ * Array that can be used to supplement FONT_FILE_NAMES for calculating exact width.
+ *
+ * @var array>
+ */
+ private static array $extraFontArray = [];
+
+ /** @param array> $extraFontArray */
+ public static function setExtraFontArray(array $extraFontArray): void
+ {
+ self::$extraFontArray = $extraFontArray;
+ }
+
+ /** @return array> */
+ public static function getExtraFontArray(): array
+ {
+ return self::$extraFontArray;
+ }
+
+ /**
+ * AutoSize method.
+ */
+ private static string $autoSizeMethod = self::AUTOSIZE_METHOD_APPROX;
+
+ /**
+ * Path to folder containing TrueType font .ttf files.
+ */
+ private static string $trueTypeFontPath = '';
+
+ /**
+ * How wide is a default column for a given default font and size?
+ * Empirical data found by inspecting real Excel files and reading off the pixel width
+ * in Microsoft Office Excel 2007.
+ * Added height in points.
+ */
+ public const DEFAULT_COLUMN_WIDTHS = [
+ 'Arial' => [
+ 1 => ['px' => 24, 'width' => 12.00000000, 'height' => 5.25],
+ 2 => ['px' => 24, 'width' => 12.00000000, 'height' => 5.25],
+ 3 => ['px' => 32, 'width' => 10.66406250, 'height' => 6.0],
+
+ 4 => ['px' => 32, 'width' => 10.66406250, 'height' => 6.75],
+ 5 => ['px' => 40, 'width' => 10.00000000, 'height' => 8.25],
+ 6 => ['px' => 48, 'width' => 9.59765625, 'height' => 8.25],
+ 7 => ['px' => 48, 'width' => 9.59765625, 'height' => 9.0],
+ 8 => ['px' => 56, 'width' => 9.33203125, 'height' => 11.25],
+ 9 => ['px' => 64, 'width' => 9.14062500, 'height' => 12.0],
+ 10 => ['px' => 64, 'width' => 9.14062500, 'height' => 12.75],
+ ],
+ 'Calibri' => [
+ 1 => ['px' => 24, 'width' => 12.00000000, 'height' => 5.25],
+ 2 => ['px' => 24, 'width' => 12.00000000, 'height' => 5.25],
+ 3 => ['px' => 32, 'width' => 10.66406250, 'height' => 6.00],
+ 4 => ['px' => 32, 'width' => 10.66406250, 'height' => 6.75],
+ 5 => ['px' => 40, 'width' => 10.00000000, 'height' => 8.25],
+ 6 => ['px' => 48, 'width' => 9.59765625, 'height' => 8.25],
+ 7 => ['px' => 48, 'width' => 9.59765625, 'height' => 9.0],
+ 8 => ['px' => 56, 'width' => 9.33203125, 'height' => 11.25],
+ 9 => ['px' => 56, 'width' => 9.33203125, 'height' => 12.0],
+ 10 => ['px' => 64, 'width' => 9.14062500, 'height' => 12.75],
+ 11 => ['px' => 64, 'width' => 9.14062500, 'height' => 15.0],
+ ],
+ 'Verdana' => [
+ 1 => ['px' => 24, 'width' => 12.00000000, 'height' => 5.25],
+ 2 => ['px' => 24, 'width' => 12.00000000, 'height' => 5.25],
+ 3 => ['px' => 32, 'width' => 10.66406250, 'height' => 6.0],
+ 4 => ['px' => 32, 'width' => 10.66406250, 'height' => 6.75],
+ 5 => ['px' => 40, 'width' => 10.00000000, 'height' => 8.25],
+ 6 => ['px' => 48, 'width' => 9.59765625, 'height' => 8.25],
+ 7 => ['px' => 48, 'width' => 9.59765625, 'height' => 9.0],
+ 8 => ['px' => 64, 'width' => 9.14062500, 'height' => 10.5],
+ 9 => ['px' => 72, 'width' => 9.00000000, 'height' => 11.25],
+ 10 => ['px' => 72, 'width' => 9.00000000, 'height' => 12.75],
+ ],
+ ];
+
+ /**
+ * Set autoSize method.
+ *
+ * @param string $method see self::AUTOSIZE_METHOD_*
+ *
+ * @return bool Success or failure
+ */
+ public static function setAutoSizeMethod(string $method): bool
+ {
+ if (!in_array($method, self::AUTOSIZE_METHODS)) {
+ return false;
+ }
+ self::$autoSizeMethod = $method;
+
+ return true;
+ }
+
+ /**
+ * Get autoSize method.
+ */
+ public static function getAutoSizeMethod(): string
+ {
+ return self::$autoSizeMethod;
+ }
+
+ /**
+ * Set the path to the folder containing .ttf files. There should be a trailing slash.
+ * Path will be recursively searched for font file.
+ * Typical locations on various platforms:
+ *
+ * C:/Windows/Fonts/
+ * /usr/share/fonts/truetype/
+ * ~/.fonts/
+ * .
+ */
+ public static function setTrueTypeFontPath(string $folderPath): void
+ {
+ self::$trueTypeFontPath = $folderPath;
+ }
+
+ /**
+ * Get the path to the folder containing .ttf files.
+ */
+ public static function getTrueTypeFontPath(): string
+ {
+ return self::$trueTypeFontPath;
+ }
+
+ /**
+ * Pad amount for exact in pixels; use best guess if null.
+ */
+ private static null|float|int $paddingAmountExact = null;
+
+ /**
+ * Set pad amount for exact in pixels; use best guess if null.
+ */
+ public static function setPaddingAmountExact(null|float|int $paddingAmountExact): void
+ {
+ self::$paddingAmountExact = $paddingAmountExact;
+ }
+
+ /**
+ * Get pad amount for exact in pixels; or null if using best guess.
+ */
+ public static function getPaddingAmountExact(): null|float|int
+ {
+ return self::$paddingAmountExact;
+ }
+
+ /**
+ * Calculate an (approximate) OpenXML column width, based on font size and text contained.
+ *
+ * @param FontStyle $font Font object
+ * @param null|RichText|string $cellText Text to calculate width
+ * @param int $rotation Rotation angle
+ * @param null|FontStyle $defaultFont Font object
+ * @param bool $filterAdjustment Add space for Autofilter or Table dropdown
+ */
+ public static function calculateColumnWidth(
+ FontStyle $font,
+ $cellText = '',
+ int $rotation = 0,
+ ?FontStyle $defaultFont = null,
+ bool $filterAdjustment = false,
+ int $indentAdjustment = 0
+ ): float {
+ // If it is rich text, use plain text
+ if ($cellText instanceof RichText) {
+ $cellText = $cellText->getPlainText();
+ }
+
+ // Special case if there are one or more newline characters ("\n")
+ $cellText = (string) $cellText;
+ if (str_contains($cellText, "\n")) {
+ $lineTexts = explode("\n", $cellText);
+ $lineWidths = [];
+ foreach ($lineTexts as $lineText) {
+ $lineWidths[] = self::calculateColumnWidth($font, $lineText, $rotation = 0, $defaultFont, $filterAdjustment);
+ }
+
+ return max($lineWidths); // width of longest line in cell
+ }
+
+ // Try to get the exact text width in pixels
+ $approximate = self::$autoSizeMethod === self::AUTOSIZE_METHOD_APPROX;
+ $columnWidth = 0;
+ if (!$approximate) {
+ try {
+ $columnWidthAdjust = ceil(
+ self::getTextWidthPixelsExact(
+ str_repeat('n', 1 * (($filterAdjustment ? 3 : 1) + ($indentAdjustment * 2))),
+ $font,
+ 0
+ ) * 1.07
+ );
+
+ // Width of text in pixels excl. padding
+ // and addition because Excel adds some padding, just use approx width of 'n' glyph
+ $columnWidth = self::getTextWidthPixelsExact($cellText, $font, $rotation) + (self::$paddingAmountExact ?? $columnWidthAdjust);
+ } catch (PhpSpreadsheetException) {
+ $approximate = true;
+ }
+ }
+
+ if ($approximate) {
+ $columnWidthAdjust = self::getTextWidthPixelsApprox(
+ str_repeat('n', 1 * (($filterAdjustment ? 3 : 1) + ($indentAdjustment * 2))),
+ $font,
+ 0
+ );
+ // Width of text in pixels excl. padding, approximation
+ // and addition because Excel adds some padding, just use approx width of 'n' glyph
+ $columnWidth = self::getTextWidthPixelsApprox($cellText, $font, $rotation) + $columnWidthAdjust;
+ }
+
+ // Convert from pixel width to column width
+ $columnWidth = Drawing::pixelsToCellDimension((int) $columnWidth, $defaultFont ?? new FontStyle());
+
+ // Return
+ return round($columnWidth, 4);
+ }
+
+ /**
+ * Get GD text width in pixels for a string of text in a certain font at a certain rotation angle.
+ */
+ public static function getTextWidthPixelsExact(string $text, FontStyle $font, int $rotation = 0): float
+ {
+ // font size should really be supplied in pixels in GD2,
+ // but since GD2 seems to assume 72dpi, pixels and points are the same
+ $fontFile = self::getTrueTypeFontFileFromFont($font);
+ $textBox = imagettfbbox($font->getSize() ?? 10.0, $rotation, $fontFile, $text);
+ if ($textBox === false) {
+ // @codeCoverageIgnoreStart
+ throw new PhpSpreadsheetException('imagettfbbox failed');
+ // @codeCoverageIgnoreEnd
+ }
+
+ // Get corners positions
+ $lowerLeftCornerX = $textBox[0];
+ $lowerRightCornerX = $textBox[2];
+ $upperRightCornerX = $textBox[4];
+ $upperLeftCornerX = $textBox[6];
+
+ // Consider the rotation when calculating the width
+ return round(max($lowerRightCornerX - $upperLeftCornerX, $upperRightCornerX - $lowerLeftCornerX), 4);
+ }
+
+ /**
+ * Get approximate width in pixels for a string of text in a certain font at a certain rotation angle.
+ *
+ * @return int Text width in pixels (no padding added)
+ */
+ public static function getTextWidthPixelsApprox(string $columnText, FontStyle $font, int $rotation = 0): int
+ {
+ $fontName = $font->getName();
+ $fontSize = $font->getSize();
+
+ // Calculate column width in pixels.
+ // We assume fixed glyph width, but count double for "fullwidth" characters.
+ // Result varies with font name and size.
+ switch ($fontName) {
+ case 'Arial':
+ // value 8 was set because of experience in different exports at Arial 10 font.
+ $columnWidth = (int) (8 * StringHelper::countCharactersDbcs($columnText));
+ $columnWidth = $columnWidth * $fontSize / 10; // extrapolate from font size
+
+ break;
+ case 'Verdana':
+ // value 8 was found via interpolation by inspecting real Excel files with Verdana 10 font.
+ $columnWidth = (int) (8 * StringHelper::countCharactersDbcs($columnText));
+ $columnWidth = $columnWidth * $fontSize / 10; // extrapolate from font size
+
+ break;
+ default:
+ // just assume Calibri
+ // value 8.26 was found via interpolation by inspecting real Excel files with Calibri 11 font.
+ $columnWidth = (int) (8.26 * StringHelper::countCharactersDbcs($columnText));
+ $columnWidth = $columnWidth * $fontSize / 11; // extrapolate from font size
+
+ break;
+ }
+
+ // Calculate approximate rotated column width
+ if ($rotation !== 0) {
+ if ($rotation == Alignment::TEXTROTATION_STACK_PHPSPREADSHEET) {
+ // stacked text
+ $columnWidth = 4; // approximation
+ } else {
+ // rotated text
+ $columnWidth = $columnWidth * cos(deg2rad($rotation))
+ + $fontSize * abs(sin(deg2rad($rotation))) / 5; // approximation
+ }
+ }
+
+ // pixel width is an integer
+ return (int) $columnWidth;
+ }
+
+ /**
+ * Calculate an (approximate) pixel size, based on a font points size.
+ *
+ * @param float|int $fontSizeInPoints Font size (in points)
+ *
+ * @return int Font size (in pixels)
+ */
+ public static function fontSizeToPixels(float|int $fontSizeInPoints): int
+ {
+ return (int) ((4 / 3) * $fontSizeInPoints);
+ }
+
+ /**
+ * Calculate an (approximate) pixel size, based on inch size.
+ *
+ * @param float|int $sizeInInch Font size (in inch)
+ *
+ * @return float|int Size (in pixels)
+ */
+ public static function inchSizeToPixels(int|float $sizeInInch): int|float
+ {
+ return $sizeInInch * 96;
+ }
+
+ /**
+ * Calculate an (approximate) pixel size, based on centimeter size.
+ *
+ * @param float|int $sizeInCm Font size (in centimeters)
+ *
+ * @return float Size (in pixels)
+ */
+ public static function centimeterSizeToPixels(int|float $sizeInCm): float
+ {
+ return $sizeInCm * 37.795275591;
+ }
+
+ /**
+ * Returns the font path given the font.
+ *
+ * @return string Path to TrueType font file
+ */
+ public static function getTrueTypeFontFileFromFont(FontStyle $font, bool $checkPath = true): string
+ {
+ if ($checkPath && (!file_exists(self::$trueTypeFontPath) || !is_dir(self::$trueTypeFontPath))) {
+ throw new PhpSpreadsheetException('Valid directory to TrueType Font files not specified');
+ }
+
+ $name = $font->getName();
+ $fontArray = array_merge(self::FONT_FILE_NAMES, self::$extraFontArray);
+ if (!isset($fontArray[$name])) {
+ throw new PhpSpreadsheetException('Unknown font name "' . $name . '". Cannot map to TrueType font file');
+ }
+ $bold = $font->getBold();
+ $italic = $font->getItalic();
+ $index = 'x';
+ if ($bold) {
+ $index .= 'b';
+ }
+ if ($italic) {
+ $index .= 'i';
+ }
+ $fontFile = $fontArray[$name][$index];
+
+ $separator = '';
+ if (mb_strlen(self::$trueTypeFontPath) > 1 && mb_substr(self::$trueTypeFontPath, -1) !== '/' && mb_substr(self::$trueTypeFontPath, -1) !== '\\') {
+ $separator = DIRECTORY_SEPARATOR;
+ }
+ $fontFileAbsolute = preg_match('~^([A-Za-z]:)?[/\\\\]~', $fontFile) === 1;
+ if (!$fontFileAbsolute) {
+ $fontFile = self::findFontFile(self::$trueTypeFontPath, $fontFile) ?? self::$trueTypeFontPath . $separator . $fontFile;
+ }
+
+ // Check if file actually exists
+ if ($checkPath && !file_exists($fontFile) && !$fontFileAbsolute) {
+ $alternateName = $name;
+ if ($index !== 'x' && $fontArray[$name][$index] !== $fontArray[$name]['x']) {
+ // Bold but no italic:
+ // Comic Sans
+ // Tahoma
+ // Neither bold nor italic:
+ // Impact
+ // Lucida Console
+ // Lucida Sans Unicode
+ // Microsoft Sans Serif
+ // Symbol
+ if ($index === 'xb') {
+ $alternateName .= ' Bold';
+ } elseif ($index === 'xi') {
+ $alternateName .= ' Italic';
+ } elseif ($fontArray[$name]['xb'] === $fontArray[$name]['xbi']) {
+ $alternateName .= ' Bold';
+ } else {
+ $alternateName .= ' Bold Italic';
+ }
+ }
+ $fontFile = self::$trueTypeFontPath . $separator . $alternateName . '.ttf';
+ if (!file_exists($fontFile)) {
+ throw new PhpSpreadsheetException('TrueType Font file not found');
+ }
+ }
+
+ return $fontFile;
+ }
+
+ public const CHARSET_FROM_FONT_NAME = [
+ 'EucrosiaUPC' => self::CHARSET_ANSI_THAI,
+ 'Wingdings' => self::CHARSET_SYMBOL,
+ 'Wingdings 2' => self::CHARSET_SYMBOL,
+ 'Wingdings 3' => self::CHARSET_SYMBOL,
+ ];
+
+ /**
+ * Returns the associated charset for the font name.
+ *
+ * @param string $fontName Font name
+ *
+ * @return int Character set code
+ */
+ public static function getCharsetFromFontName(string $fontName): int
+ {
+ return self::CHARSET_FROM_FONT_NAME[$fontName] ?? self::CHARSET_ANSI_LATIN;
+ }
+
+ /**
+ * Get the effective column width for columns without a column dimension or column with width -1
+ * For example, for Calibri 11 this is 9.140625 (64 px).
+ *
+ * @param FontStyle $font The workbooks default font
+ * @param bool $returnAsPixels true = return column width in pixels, false = return in OOXML units
+ *
+ * @return ($returnAsPixels is true ? int : float) Column width
+ */
+ public static function getDefaultColumnWidthByFont(FontStyle $font, bool $returnAsPixels = false): float|int
+ {
+ if (isset(self::DEFAULT_COLUMN_WIDTHS[$font->getName()][$font->getSize()])) {
+ // Exact width can be determined
+ $columnWidth = $returnAsPixels
+ ? self::DEFAULT_COLUMN_WIDTHS[$font->getName()][$font->getSize()]['px']
+ : self::DEFAULT_COLUMN_WIDTHS[$font->getName()][$font->getSize()]['width'];
+ } else {
+ // We don't have data for this particular font and size, use approximation by
+ // extrapolating from Calibri 11
+ $columnWidth = $returnAsPixels
+ ? self::DEFAULT_COLUMN_WIDTHS['Calibri'][11]['px']
+ : self::DEFAULT_COLUMN_WIDTHS['Calibri'][11]['width'];
+ $columnWidth = $columnWidth * $font->getSize() / 11;
+
+ // Round pixels to closest integer
+ if ($returnAsPixels) {
+ $columnWidth = (int) round($columnWidth);
+ }
+ }
+
+ return $columnWidth;
+ }
+
+ /**
+ * Get the effective row height for rows without a row dimension or rows with height -1
+ * For example, for Calibri 11 this is 15 points.
+ *
+ * @param FontStyle $font The workbooks default font
+ *
+ * @return float Row height in points
+ */
+ public static function getDefaultRowHeightByFont(FontStyle $font): float
+ {
+ $name = $font->getName();
+ $size = $font->getSize();
+ if (isset(self::DEFAULT_COLUMN_WIDTHS[$name][$size])) {
+ $rowHeight = self::DEFAULT_COLUMN_WIDTHS[$name][$size]['height'];
+ } elseif ($name === 'Arial' || $name === 'Verdana') {
+ $rowHeight = self::DEFAULT_COLUMN_WIDTHS[$name][10]['height'] * $size / 10.0;
+ } else {
+ $rowHeight = self::DEFAULT_COLUMN_WIDTHS['Calibri'][11]['height'] * $size / 11.0;
+ }
+
+ return $rowHeight;
+ }
+
+ private static function findFontFile(string $startDirectory, string $desiredFont): ?string
+ {
+ $fontPath = null;
+ if ($startDirectory === '') {
+ return null;
+ }
+ if (file_exists("$startDirectory/$desiredFont")) {
+ $fontPath = "$startDirectory/$desiredFont";
+ } else {
+ $iterations = 0;
+ $it = new RecursiveDirectoryIterator(
+ $startDirectory,
+ RecursiveDirectoryIterator::SKIP_DOTS
+ | RecursiveDirectoryIterator::FOLLOW_SYMLINKS
+ );
+ foreach (
+ new RecursiveIteratorIterator(
+ $it,
+ RecursiveIteratorIterator::LEAVES_ONLY,
+ RecursiveIteratorIterator::CATCH_GET_CHILD
+ ) as $filex
+ ) {
+ /** @var string */
+ $file = $filex;
+ if (basename($file) === $desiredFont) {
+ $fontPath = $file;
+
+ break;
+ }
+ ++$iterations;
+ if ($iterations > 5000) {
+ // @codeCoverageIgnoreStart
+ break;
+ // @codeCoverageIgnoreEnd
+ }
+ }
+ }
+
+ return $fontPath;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/IntOrFloat.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/IntOrFloat.php
new file mode 100644
index 00000000..2e20c9c3
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/IntOrFloat.php
@@ -0,0 +1,17 @@
+ |
+// | Based on OLE::Storage_Lite by Kawai, Takanori |
+// +----------------------------------------------------------------------+
+//
+
+use PhpOffice\PhpSpreadsheet\Exception;
+use PhpOffice\PhpSpreadsheet\Reader\Exception as ReaderException;
+use PhpOffice\PhpSpreadsheet\Shared\OLE\ChainedBlockStream;
+use PhpOffice\PhpSpreadsheet\Shared\OLE\PPS\Root;
+
+/*
+ * Array for storing OLE instances that are accessed from
+ * OLE_ChainedBlockStream::stream_open().
+ *
+ * @var array
+ */
+$GLOBALS['_OLE_INSTANCES'] = [];
+
+/**
+ * OLE package base class.
+ *
+ * @author Xavier Noguer
+ * @author Christian Schmidt
+ */
+class OLE
+{
+ const OLE_PPS_TYPE_ROOT = 5;
+ const OLE_PPS_TYPE_DIR = 1;
+ const OLE_PPS_TYPE_FILE = 2;
+ const OLE_DATA_SIZE_SMALL = 0x1000;
+ const OLE_LONG_INT_SIZE = 4;
+ const OLE_PPS_SIZE = 0x80;
+
+ /**
+ * The file handle for reading an OLE container.
+ *
+ * @var resource
+ */
+ public $_file_handle;
+
+ /**
+ * Array of PPS's found on the OLE container.
+ */
+ public array $_list = [];
+
+ /**
+ * Root directory of OLE container.
+ */
+ public Root $root;
+
+ /**
+ * Big Block Allocation Table.
+ *
+ * @var array (blockId => nextBlockId)
+ */
+ public array $bbat;
+
+ /**
+ * Short Block Allocation Table.
+ *
+ * @var array (blockId => nextBlockId)
+ */
+ public array $sbat;
+
+ /**
+ * Size of big blocks. This is usually 512.
+ *
+ * @var int number of octets per block
+ */
+ public int $bigBlockSize;
+
+ /**
+ * Size of small blocks. This is usually 64.
+ *
+ * @var int number of octets per block
+ */
+ public int $smallBlockSize;
+
+ /**
+ * Threshold for big blocks.
+ */
+ public int $bigBlockThreshold;
+
+ /**
+ * Reads an OLE container from the contents of the file given.
+ *
+ * @acces public
+ *
+ * @return bool true on success, PEAR_Error on failure
+ */
+ public function read(string $filename): bool
+ {
+ $fh = @fopen($filename, 'rb');
+ if ($fh === false) {
+ throw new ReaderException("Can't open file $filename");
+ }
+ $this->_file_handle = $fh;
+
+ $signature = fread($fh, 8);
+ if ("\xD0\xCF\x11\xE0\xA1\xB1\x1A\xE1" != $signature) {
+ throw new ReaderException("File doesn't seem to be an OLE container.");
+ }
+ fseek($fh, 28);
+ if (fread($fh, 2) != "\xFE\xFF") {
+ // This shouldn't be a problem in practice
+ throw new ReaderException('Only Little-Endian encoding is supported.');
+ }
+ // Size of blocks and short blocks in bytes
+ $this->bigBlockSize = 2 ** self::readInt2($fh);
+ $this->smallBlockSize = 2 ** self::readInt2($fh);
+
+ // Skip UID, revision number and version number
+ fseek($fh, 44);
+ // Number of blocks in Big Block Allocation Table
+ $bbatBlockCount = self::readInt4($fh);
+
+ // Root chain 1st block
+ $directoryFirstBlockId = self::readInt4($fh);
+
+ // Skip unused bytes
+ fseek($fh, 56);
+ // Streams shorter than this are stored using small blocks
+ $this->bigBlockThreshold = self::readInt4($fh);
+ // Block id of first sector in Short Block Allocation Table
+ $sbatFirstBlockId = self::readInt4($fh);
+ // Number of blocks in Short Block Allocation Table
+ $sbbatBlockCount = self::readInt4($fh);
+ // Block id of first sector in Master Block Allocation Table
+ $mbatFirstBlockId = self::readInt4($fh);
+ // Number of blocks in Master Block Allocation Table
+ $mbbatBlockCount = self::readInt4($fh);
+ $this->bbat = [];
+
+ // Remaining 4 * 109 bytes of current block is beginning of Master
+ // Block Allocation Table
+ $mbatBlocks = [];
+ for ($i = 0; $i < 109; ++$i) {
+ $mbatBlocks[] = self::readInt4($fh);
+ }
+
+ // Read rest of Master Block Allocation Table (if any is left)
+ $pos = $this->getBlockOffset($mbatFirstBlockId);
+ for ($i = 0; $i < $mbbatBlockCount; ++$i) {
+ fseek($fh, $pos);
+ for ($j = 0; $j < $this->bigBlockSize / 4 - 1; ++$j) {
+ $mbatBlocks[] = self::readInt4($fh);
+ }
+ // Last block id in each block points to next block
+ $pos = $this->getBlockOffset(self::readInt4($fh));
+ }
+
+ // Read Big Block Allocation Table according to chain specified by $mbatBlocks
+ for ($i = 0; $i < $bbatBlockCount; ++$i) {
+ $pos = $this->getBlockOffset($mbatBlocks[$i]);
+ fseek($fh, $pos);
+ for ($j = 0; $j < $this->bigBlockSize / 4; ++$j) {
+ $this->bbat[] = self::readInt4($fh);
+ }
+ }
+
+ // Read short block allocation table (SBAT)
+ $this->sbat = [];
+ $shortBlockCount = $sbbatBlockCount * $this->bigBlockSize / 4;
+ $sbatFh = $this->getStream($sbatFirstBlockId);
+ for ($blockId = 0; $blockId < $shortBlockCount; ++$blockId) {
+ $this->sbat[$blockId] = self::readInt4($sbatFh);
+ }
+ fclose($sbatFh);
+
+ $this->readPpsWks($directoryFirstBlockId);
+
+ return true;
+ }
+
+ /**
+ * @param int $blockId byte offset from beginning of file
+ */
+ public function getBlockOffset(int $blockId): int
+ {
+ return 512 + $blockId * $this->bigBlockSize;
+ }
+
+ /**
+ * Returns a stream for use with fread() etc. External callers should
+ * use \PhpOffice\PhpSpreadsheet\Shared\OLE\PPS\File::getStream().
+ *
+ * @param int|OLE\PPS $blockIdOrPps block id or PPS
+ *
+ * @return resource read-only stream
+ */
+ public function getStream($blockIdOrPps)
+ {
+ static $isRegistered = false;
+ if (!$isRegistered) {
+ stream_wrapper_register('ole-chainedblockstream', ChainedBlockStream::class);
+ $isRegistered = true;
+ }
+
+ // Store current instance in global array, so that it can be accessed
+ // in OLE_ChainedBlockStream::stream_open().
+ // Object is removed from self::$instances in OLE_Stream::close().
+ $GLOBALS['_OLE_INSTANCES'][] = $this;
+ $keys = array_keys($GLOBALS['_OLE_INSTANCES']);
+ $instanceId = end($keys);
+
+ $path = 'ole-chainedblockstream://oleInstanceId=' . $instanceId;
+ if ($blockIdOrPps instanceof OLE\PPS) {
+ $path .= '&blockId=' . $blockIdOrPps->startBlock;
+ $path .= '&size=' . $blockIdOrPps->Size;
+ } else {
+ $path .= '&blockId=' . $blockIdOrPps;
+ }
+
+ $resource = fopen($path, 'rb');
+ if ($resource === false) {
+ throw new Exception("Unable to open stream $path");
+ }
+
+ return $resource;
+ }
+
+ /**
+ * Reads a signed char.
+ *
+ * @param resource $fileHandle file handle
+ */
+ private static function readInt1($fileHandle): int
+ {
+ [, $tmp] = unpack('c', fread($fileHandle, 1) ?: '') ?: [0, 0];
+
+ return $tmp;
+ }
+
+ /**
+ * Reads an unsigned short (2 octets).
+ *
+ * @param resource $fileHandle file handle
+ */
+ private static function readInt2($fileHandle): int
+ {
+ [, $tmp] = unpack('v', fread($fileHandle, 2) ?: '') ?: [0, 0];
+
+ return $tmp;
+ }
+
+ private const SIGNED_4OCTET_LIMIT = 2147483648;
+
+ private const SIGNED_4OCTET_SUBTRACT = 2 * self::SIGNED_4OCTET_LIMIT;
+
+ /**
+ * Reads long (4 octets), interpreted as if signed on 32-bit system.
+ *
+ * @param resource $fileHandle file handle
+ */
+ private static function readInt4($fileHandle): int
+ {
+ [, $tmp] = unpack('V', fread($fileHandle, 4) ?: '') ?: [0, 0];
+ if ($tmp >= self::SIGNED_4OCTET_LIMIT) {
+ $tmp -= self::SIGNED_4OCTET_SUBTRACT;
+ }
+
+ return $tmp;
+ }
+
+ /**
+ * Gets information about all PPS's on the OLE container from the PPS WK's
+ * creates an OLE_PPS object for each one.
+ *
+ * @param int $blockId the block id of the first block
+ *
+ * @return bool true on success, PEAR_Error on failure
+ */
+ public function readPpsWks(int $blockId): bool
+ {
+ $fh = $this->getStream($blockId);
+ for ($pos = 0; true; $pos += 128) {
+ fseek($fh, $pos, SEEK_SET);
+ $nameUtf16 = (string) fread($fh, 64);
+ $nameLength = self::readInt2($fh);
+ $nameUtf16 = substr($nameUtf16, 0, $nameLength - 2);
+ // Simple conversion from UTF-16LE to ISO-8859-1
+ $name = str_replace("\x00", '', $nameUtf16);
+ $type = self::readInt1($fh);
+ switch ($type) {
+ case self::OLE_PPS_TYPE_ROOT:
+ $pps = new Root(null, null, []);
+ $this->root = $pps;
+
+ break;
+ case self::OLE_PPS_TYPE_DIR:
+ $pps = new OLE\PPS(null, null, null, null, null, null, null, null, null, []);
+
+ break;
+ case self::OLE_PPS_TYPE_FILE:
+ $pps = new OLE\PPS\File($name);
+
+ break;
+ default:
+ throw new Exception('Unsupported PPS type');
+ }
+ fseek($fh, 1, SEEK_CUR);
+ $pps->Type = $type;
+ $pps->Name = $name;
+ $pps->PrevPps = self::readInt4($fh);
+ $pps->NextPps = self::readInt4($fh);
+ $pps->DirPps = self::readInt4($fh);
+ fseek($fh, 20, SEEK_CUR);
+ $pps->Time1st = self::OLE2LocalDate((string) fread($fh, 8));
+ $pps->Time2nd = self::OLE2LocalDate((string) fread($fh, 8));
+ $pps->startBlock = self::readInt4($fh);
+ $pps->Size = self::readInt4($fh);
+ $pps->No = count($this->_list);
+ $this->_list[] = $pps;
+
+ // check if the PPS tree (starting from root) is complete
+ if (isset($this->root) && $this->ppsTreeComplete($this->root->No)) {
+ break;
+ }
+ }
+ fclose($fh);
+
+ // Initialize $pps->children on directories
+ foreach ($this->_list as $pps) {
+ if ($pps->Type == self::OLE_PPS_TYPE_DIR || $pps->Type == self::OLE_PPS_TYPE_ROOT) {
+ $nos = [$pps->DirPps];
+ $pps->children = [];
+ while (!empty($nos)) {
+ $no = array_pop($nos);
+ if ($no != -1) {
+ $childPps = $this->_list[$no];
+ $nos[] = $childPps->PrevPps;
+ $nos[] = $childPps->NextPps;
+ $pps->children[] = $childPps;
+ }
+ }
+ }
+ }
+
+ return true;
+ }
+
+ /**
+ * It checks whether the PPS tree is complete (all PPS's read)
+ * starting with the given PPS (not necessarily root).
+ *
+ * @param int $index The index of the PPS from which we are checking
+ *
+ * @return bool Whether the PPS tree for the given PPS is complete
+ */
+ private function ppsTreeComplete(int $index): bool
+ {
+ return isset($this->_list[$index])
+ && ($pps = $this->_list[$index])
+ && ($pps->PrevPps == -1
+ || $this->ppsTreeComplete($pps->PrevPps))
+ && ($pps->NextPps == -1
+ || $this->ppsTreeComplete($pps->NextPps))
+ && ($pps->DirPps == -1
+ || $this->ppsTreeComplete($pps->DirPps));
+ }
+
+ /**
+ * Checks whether a PPS is a File PPS or not.
+ * If there is no PPS for the index given, it will return false.
+ *
+ * @param int $index The index for the PPS
+ *
+ * @return bool true if it's a File PPS, false otherwise
+ */
+ public function isFile(int $index): bool
+ {
+ if (isset($this->_list[$index])) {
+ return $this->_list[$index]->Type == self::OLE_PPS_TYPE_FILE;
+ }
+
+ return false;
+ }
+
+ /**
+ * Checks whether a PPS is a Root PPS or not.
+ * If there is no PPS for the index given, it will return false.
+ *
+ * @param int $index the index for the PPS
+ *
+ * @return bool true if it's a Root PPS, false otherwise
+ */
+ public function isRoot(int $index): bool
+ {
+ if (isset($this->_list[$index])) {
+ return $this->_list[$index]->Type == self::OLE_PPS_TYPE_ROOT;
+ }
+
+ return false;
+ }
+
+ /**
+ * Gives the total number of PPS's found in the OLE container.
+ *
+ * @return int The total number of PPS's found in the OLE container
+ */
+ public function ppsTotal(): int
+ {
+ return count($this->_list);
+ }
+
+ /**
+ * Gets data from a PPS
+ * If there is no PPS for the index given, it will return an empty string.
+ *
+ * @param int $index The index for the PPS
+ * @param int $position The position from which to start reading
+ * (relative to the PPS)
+ * @param int $length The amount of bytes to read (at most)
+ *
+ * @return string The binary string containing the data requested
+ *
+ * @see OLE_PPS_File::getStream()
+ */
+ public function getData(int $index, int $position, int $length): string
+ {
+ // if position is not valid return empty string
+ if (!isset($this->_list[$index]) || ($position >= $this->_list[$index]->Size) || ($position < 0)) {
+ return '';
+ }
+ $fh = $this->getStream($this->_list[$index]);
+ $data = (string) stream_get_contents($fh, $length, $position);
+ fclose($fh);
+
+ return $data;
+ }
+
+ /**
+ * Gets the data length from a PPS
+ * If there is no PPS for the index given, it will return 0.
+ *
+ * @param int $index The index for the PPS
+ *
+ * @return int The amount of bytes in data the PPS has
+ */
+ public function getDataLength(int $index): int
+ {
+ if (isset($this->_list[$index])) {
+ return $this->_list[$index]->Size;
+ }
+
+ return 0;
+ }
+
+ /**
+ * Utility function to transform ASCII text to Unicode.
+ *
+ * @param string $ascii The ASCII string to transform
+ *
+ * @return string The string in Unicode
+ */
+ public static function ascToUcs(string $ascii): string
+ {
+ $rawname = '';
+ $iMax = strlen($ascii);
+ for ($i = 0; $i < $iMax; ++$i) {
+ $rawname .= $ascii[$i]
+ . "\x00";
+ }
+
+ return $rawname;
+ }
+
+ /**
+ * Utility function
+ * Returns a string for the OLE container with the date given.
+ *
+ * @param float|int $date A timestamp
+ *
+ * @return string The string for the OLE container
+ */
+ public static function localDateToOLE($date): string
+ {
+ if (!$date) {
+ return "\x00\x00\x00\x00\x00\x00\x00\x00";
+ }
+ $dateTime = Date::dateTimeFromTimestamp("$date");
+
+ // days from 1-1-1601 until the beggining of UNIX era
+ $days = 134774;
+ // calculate seconds
+ $big_date = $days * 24 * 3600 + (float) $dateTime->format('U');
+ // multiply just to make MS happy
+ $big_date *= 10000000;
+
+ // Make HEX string
+ $res = '';
+
+ $factor = 2 ** 56;
+ while ($factor >= 1) {
+ $hex = (int) floor($big_date / $factor);
+ $res = pack('c', $hex) . $res;
+ $big_date = fmod($big_date, $factor);
+ $factor /= 256;
+ }
+
+ return $res;
+ }
+
+ /**
+ * Returns a timestamp from an OLE container's date.
+ *
+ * @param string $oleTimestamp A binary string with the encoded date
+ *
+ * @return float|int The Unix timestamp corresponding to the string
+ */
+ public static function OLE2LocalDate(string $oleTimestamp)
+ {
+ if (strlen($oleTimestamp) != 8) {
+ throw new ReaderException('Expecting 8 byte string');
+ }
+
+ // convert to units of 100 ns since 1601:
+ $unpackedTimestamp = unpack('v4', $oleTimestamp) ?: [];
+ $timestampHigh = (float) $unpackedTimestamp[4] * 65536 + (float) $unpackedTimestamp[3];
+ $timestampLow = (float) $unpackedTimestamp[2] * 65536 + (float) $unpackedTimestamp[1];
+
+ // translate to seconds since 1601:
+ $timestampHigh /= 10000000;
+ $timestampLow /= 10000000;
+
+ // days from 1601 to 1970:
+ $days = 134774;
+
+ // translate to seconds since 1970:
+ $unixTimestamp = floor(65536.0 * 65536.0 * $timestampHigh + $timestampLow - $days * 24 * 3600 + 0.5);
+
+ return IntOrFloat::evaluate($unixTimestamp);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/ChainedBlockStream.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/ChainedBlockStream.php
new file mode 100644
index 00000000..61bd6acb
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/ChainedBlockStream.php
@@ -0,0 +1,187 @@
+params);
+ if (!isset($this->params['oleInstanceId'], $this->params['blockId'], $GLOBALS['_OLE_INSTANCES'][$this->params['oleInstanceId']])) {
+ if ($options & STREAM_REPORT_ERRORS) {
+ trigger_error('OLE stream not found', E_USER_WARNING);
+ }
+
+ return false;
+ }
+ $this->ole = $GLOBALS['_OLE_INSTANCES'][$this->params['oleInstanceId']];
+
+ $blockId = $this->params['blockId'];
+ $this->data = '';
+ if (isset($this->params['size']) && $this->params['size'] < $this->ole->bigBlockThreshold && $blockId != $this->ole->root->startBlock) {
+ // Block id refers to small blocks
+ $rootPos = $this->ole->getBlockOffset($this->ole->root->startBlock);
+ while ($blockId != -2) {
+ $pos = $rootPos + $blockId * $this->ole->bigBlockSize;
+ $blockId = $this->ole->sbat[$blockId];
+ fseek($this->ole->_file_handle, $pos);
+ $this->data .= fread($this->ole->_file_handle, $this->ole->bigBlockSize);
+ }
+ } else {
+ // Block id refers to big blocks
+ while ($blockId != -2) {
+ $pos = $this->ole->getBlockOffset($blockId);
+ fseek($this->ole->_file_handle, $pos);
+ $this->data .= fread($this->ole->_file_handle, $this->ole->bigBlockSize);
+ $blockId = $this->ole->bbat[$blockId];
+ }
+ }
+ if (isset($this->params['size'])) {
+ $this->data = substr($this->data, 0, $this->params['size']);
+ }
+
+ if ($options & STREAM_USE_PATH) {
+ $openedPath = $path;
+ }
+
+ return true;
+ }
+
+ /**
+ * Implements support for fclose().
+ */
+ public function stream_close(): void // @codingStandardsIgnoreLine
+ {
+ $this->ole = null;
+ unset($GLOBALS['_OLE_INSTANCES']);
+ }
+
+ /**
+ * Implements support for fread(), fgets() etc.
+ *
+ * @param int $count maximum number of bytes to read
+ *
+ * @return false|string
+ */
+ public function stream_read(int $count): bool|string // @codingStandardsIgnoreLine
+ {
+ if ($this->stream_eof()) {
+ return false;
+ }
+ $s = substr($this->data, (int) $this->pos, $count);
+ $this->pos += $count;
+
+ return $s;
+ }
+
+ /**
+ * Implements support for feof().
+ *
+ * @return bool TRUE if the file pointer is at EOF; otherwise FALSE
+ */
+ public function stream_eof(): bool // @codingStandardsIgnoreLine
+ {
+ return $this->pos >= strlen($this->data);
+ }
+
+ /**
+ * Returns the position of the file pointer, i.e. its offset into the file
+ * stream. Implements support for ftell().
+ */
+ public function stream_tell(): int // @codingStandardsIgnoreLine
+ {
+ return $this->pos;
+ }
+
+ /**
+ * Implements support for fseek().
+ *
+ * @param int $offset byte offset
+ * @param int $whence SEEK_SET, SEEK_CUR or SEEK_END
+ */
+ public function stream_seek(int $offset, int $whence): bool // @codingStandardsIgnoreLine
+ {
+ if ($whence == SEEK_SET && $offset >= 0) {
+ $this->pos = $offset;
+ } elseif ($whence == SEEK_CUR && -$offset <= $this->pos) {
+ $this->pos += $offset;
+ } elseif ($whence == SEEK_END && -$offset <= count($this->data)) { // @phpstan-ignore-line
+ $this->pos = strlen($this->data) + $offset;
+ } else {
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * Implements support for fstat(). Currently the only supported field is
+ * "size".
+ */
+ public function stream_stat(): array // @codingStandardsIgnoreLine
+ {
+ return [
+ 'size' => strlen($this->data),
+ ];
+ }
+
+ // Methods used by stream_wrapper_register() that are not implemented:
+ // bool stream_flush ( void )
+ // int stream_write ( string data )
+ // bool rename ( string path_from, string path_to )
+ // bool mkdir ( string path, int mode, int options )
+ // bool rmdir ( string path, int options )
+ // bool dir_opendir ( string path, int options )
+ // array url_stat ( string path, int flags )
+ // string dir_readdir ( void )
+ // bool dir_rewinddir ( void )
+ // bool dir_closedir ( void )
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS.php
new file mode 100644
index 00000000..3a77c78c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS.php
@@ -0,0 +1,207 @@
+ |
+// | Based on OLE::Storage_Lite by Kawai, Takanori |
+// +----------------------------------------------------------------------+
+//
+use PhpOffice\PhpSpreadsheet\Shared\OLE;
+
+/**
+ * Class for creating PPS's for OLE containers.
+ *
+ * @author Xavier Noguer
+ */
+class PPS
+{
+ private const ALL_ONE_BITS = (PHP_INT_SIZE > 4) ? 0xFFFFFFFF : -1;
+
+ /**
+ * The PPS index.
+ */
+ public int $No;
+
+ /**
+ * The PPS name (in Unicode).
+ */
+ public string $Name;
+
+ /**
+ * The PPS type. Dir, Root or File.
+ */
+ public int $Type;
+
+ /**
+ * The index of the previous PPS.
+ */
+ public int $PrevPps;
+
+ /**
+ * The index of the next PPS.
+ */
+ public int $NextPps;
+
+ /**
+ * The index of it's first child if this is a Dir or Root PPS.
+ */
+ public int $DirPps;
+
+ /**
+ * A timestamp.
+ */
+ public float|int $Time1st;
+
+ /**
+ * A timestamp.
+ */
+ public float|int $Time2nd;
+
+ /**
+ * Starting block (small or big) for this PPS's data inside the container.
+ */
+ public ?int $startBlock = null;
+
+ /**
+ * The size of the PPS's data (in bytes).
+ */
+ public int $Size;
+
+ /**
+ * The PPS's data (only used if it's not using a temporary file).
+ */
+ public string $_data = '';
+
+ /**
+ * Array of child PPS's (only used by Root and Dir PPS's).
+ */
+ public array $children = [];
+
+ /**
+ * Pointer to OLE container.
+ */
+ public OLE $ole;
+
+ /**
+ * The constructor.
+ *
+ * @param ?int $No The PPS index
+ * @param ?string $name The PPS name
+ * @param ?int $type The PPS type. Dir, Root or File
+ * @param ?int $prev The index of the previous PPS
+ * @param ?int $next The index of the next PPS
+ * @param ?int $dir The index of it's first child if this is a Dir or Root PPS
+ * @param null|float|int $time_1st A timestamp
+ * @param null|float|int $time_2nd A timestamp
+ * @param ?string $data The (usually binary) source data of the PPS
+ * @param array $children Array containing children PPS for this PPS
+ */
+ public function __construct(?int $No, ?string $name, ?int $type, ?int $prev, ?int $next, ?int $dir, $time_1st, $time_2nd, ?string $data, array $children)
+ {
+ $this->No = (int) $No;
+ $this->Name = (string) $name;
+ $this->Type = (int) $type;
+ $this->PrevPps = (int) $prev;
+ $this->NextPps = (int) $next;
+ $this->DirPps = (int) $dir;
+ $this->Time1st = $time_1st ?? 0;
+ $this->Time2nd = $time_2nd ?? 0;
+ $this->_data = (string) $data;
+ $this->children = $children;
+ $this->Size = strlen((string) $data);
+ }
+
+ /**
+ * Returns the amount of data saved for this PPS.
+ *
+ * @return int The amount of data (in bytes)
+ */
+ public function getDataLen(): int
+ {
+ //if (!isset($this->_data)) {
+ // return 0;
+ //}
+
+ return strlen($this->_data);
+ }
+
+ /**
+ * Returns a string with the PPS's WK (What is a WK?).
+ *
+ * @return string The binary string
+ */
+ public function getPpsWk(): string
+ {
+ $ret = str_pad($this->Name, 64, "\x00");
+
+ $ret .= pack('v', strlen($this->Name) + 2) // 66
+ . pack('c', $this->Type) // 67
+ . pack('c', 0x00) //UK // 68
+ . pack('V', $this->PrevPps) //Prev // 72
+ . pack('V', $this->NextPps) //Next // 76
+ . pack('V', $this->DirPps) //Dir // 80
+ . "\x00\x09\x02\x00" // 84
+ . "\x00\x00\x00\x00" // 88
+ . "\xc0\x00\x00\x00" // 92
+ . "\x00\x00\x00\x46" // 96 // Seems to be ok only for Root
+ . "\x00\x00\x00\x00" // 100
+ . OLE::localDateToOLE($this->Time1st) // 108
+ . OLE::localDateToOLE($this->Time2nd) // 116
+ . pack('V', $this->startBlock ?? 0) // 120
+ . pack('V', $this->Size) // 124
+ . pack('V', 0); // 128
+
+ return $ret;
+ }
+
+ /**
+ * Updates index and pointers to previous, next and children PPS's for this
+ * PPS. I don't think it'll work with Dir PPS's.
+ *
+ * @param array $raList Reference to the array of PPS's for the whole OLE
+ * container
+ *
+ * @return int The index for this PPS
+ */
+ public static function savePpsSetPnt(array &$raList, mixed $to_save, int $depth = 0): int
+ {
+ if (!is_array($to_save) || (empty($to_save))) {
+ return self::ALL_ONE_BITS;
+ } elseif (count($to_save) == 1) {
+ $cnt = count($raList);
+ // If the first entry, it's the root... Don't clone it!
+ $raList[$cnt] = ($depth == 0) ? $to_save[0] : clone $to_save[0];
+ $raList[$cnt]->No = $cnt;
+ $raList[$cnt]->PrevPps = self::ALL_ONE_BITS;
+ $raList[$cnt]->NextPps = self::ALL_ONE_BITS;
+ $raList[$cnt]->DirPps = self::savePpsSetPnt($raList, @$raList[$cnt]->children, $depth++);
+ } else {
+ $iPos = (int) floor(count($to_save) / 2);
+ $aPrev = array_slice($to_save, 0, $iPos);
+ $aNext = array_slice($to_save, $iPos + 1);
+ $cnt = count($raList);
+ // If the first entry, it's the root... Don't clone it!
+ $raList[$cnt] = ($depth == 0) ? $to_save[$iPos] : clone $to_save[$iPos];
+ $raList[$cnt]->No = $cnt;
+ $raList[$cnt]->PrevPps = self::savePpsSetPnt($raList, $aPrev, $depth++);
+ $raList[$cnt]->NextPps = self::savePpsSetPnt($raList, $aNext, $depth++);
+ $raList[$cnt]->DirPps = self::savePpsSetPnt($raList, @$raList[$cnt]->children, $depth++);
+ }
+
+ return $cnt;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS/File.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS/File.php
new file mode 100644
index 00000000..0798e3b5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS/File.php
@@ -0,0 +1,62 @@
+ |
+// | Based on OLE::Storage_Lite by Kawai, Takanori |
+// +----------------------------------------------------------------------+
+//
+use PhpOffice\PhpSpreadsheet\Shared\OLE;
+use PhpOffice\PhpSpreadsheet\Shared\OLE\PPS;
+
+/**
+ * Class for creating File PPS's for OLE containers.
+ *
+ * @author Xavier Noguer
+ */
+class File extends PPS
+{
+ /**
+ * The constructor.
+ *
+ * @param string $name The name of the file (in Unicode)
+ *
+ * @see OLE::ascToUcs()
+ */
+ public function __construct(string $name)
+ {
+ parent::__construct(null, $name, OLE::OLE_PPS_TYPE_FILE, null, null, null, null, null, '', []);
+ }
+
+ /**
+ * Initialization method. Has to be called right after OLE_PPS_File().
+ */
+ public function init(): bool
+ {
+ return true;
+ }
+
+ /**
+ * Append data to PPS.
+ *
+ * @param string $data The data to append
+ */
+ public function append(string $data): void
+ {
+ $this->_data .= $data;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS/Root.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS/Root.php
new file mode 100644
index 00000000..64de77f4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLE/PPS/Root.php
@@ -0,0 +1,406 @@
+ |
+// | Based on OLE::Storage_Lite by Kawai, Takanori |
+// +----------------------------------------------------------------------+
+//
+use PhpOffice\PhpSpreadsheet\Shared\OLE;
+use PhpOffice\PhpSpreadsheet\Shared\OLE\PPS;
+
+/**
+ * Class for creating Root PPS's for OLE containers.
+ *
+ * @author Xavier Noguer
+ */
+class Root extends PPS
+{
+ /**
+ * @var resource
+ */
+ private $fileHandle;
+
+ private ?int $smallBlockSize = null;
+
+ private ?int $bigBlockSize = null;
+
+ /**
+ * @param null|float|int $time_1st A timestamp
+ * @param null|float|int $time_2nd A timestamp
+ * @param File[] $raChild
+ */
+ public function __construct($time_1st, $time_2nd, array $raChild)
+ {
+ parent::__construct(null, OLE::ascToUcs('Root Entry'), OLE::OLE_PPS_TYPE_ROOT, null, null, null, $time_1st, $time_2nd, null, $raChild);
+ }
+
+ /**
+ * Method for saving the whole OLE container (including files).
+ * In fact, if called with an empty argument (or '-'), it saves to a
+ * temporary file and then outputs it's contents to stdout.
+ * If a resource pointer to a stream created by fopen() is passed
+ * it will be used, but you have to close such stream by yourself.
+ *
+ * @param resource $fileHandle the name of the file or stream where to save the OLE container
+ *
+ * @return bool true on success
+ */
+ public function save($fileHandle): bool
+ {
+ $this->fileHandle = $fileHandle;
+
+ // Initial Setting for saving
+ $this->bigBlockSize = (int) (2 ** (
+ (isset($this->bigBlockSize)) ? self::adjust2($this->bigBlockSize) : 9
+ ));
+ $this->smallBlockSize = (int) (2 ** (
+ (isset($this->smallBlockSize)) ? self::adjust2($this->smallBlockSize) : 6
+ ));
+
+ // Make an array of PPS's (for Save)
+ $aList = [];
+ PPS::savePpsSetPnt($aList, [$this]);
+ // calculate values for header
+ [$iSBDcnt, $iBBcnt, $iPPScnt] = $this->calcSize($aList); //, $rhInfo);
+ // Save Header
+ $this->saveHeader((int) $iSBDcnt, (int) $iBBcnt, (int) $iPPScnt);
+
+ // Make Small Data string (write SBD)
+ $this->_data = $this->makeSmallData($aList);
+
+ // Write BB
+ $this->saveBigData((int) $iSBDcnt, $aList);
+ // Write PPS
+ $this->savePps($aList);
+ // Write Big Block Depot and BDList and Adding Header informations
+ $this->saveBbd((int) $iSBDcnt, (int) $iBBcnt, (int) $iPPScnt);
+
+ return true;
+ }
+
+ /**
+ * Calculate some numbers.
+ *
+ * @param array $raList Reference to an array of PPS's
+ *
+ * @return float[] The array of numbers
+ */
+ private function calcSize(array &$raList): array
+ {
+ // Calculate Basic Setting
+ [$iSBDcnt, $iBBcnt, $iPPScnt] = [0, 0, 0];
+ $iSBcnt = 0;
+ $iCount = count($raList);
+ for ($i = 0; $i < $iCount; ++$i) {
+ if ($raList[$i]->Type == OLE::OLE_PPS_TYPE_FILE) {
+ $raList[$i]->Size = $raList[$i]->getDataLen();
+ if ($raList[$i]->Size < OLE::OLE_DATA_SIZE_SMALL) {
+ $iSBcnt += floor($raList[$i]->Size / $this->smallBlockSize)
+ + (($raList[$i]->Size % $this->smallBlockSize) ? 1 : 0);
+ } else {
+ $iBBcnt += (floor($raList[$i]->Size / $this->bigBlockSize)
+ + (($raList[$i]->Size % $this->bigBlockSize) ? 1 : 0));
+ }
+ }
+ }
+ $iSmallLen = $iSBcnt * $this->smallBlockSize;
+ $iSlCnt = floor($this->bigBlockSize / OLE::OLE_LONG_INT_SIZE);
+ $iSBDcnt = floor($iSBcnt / $iSlCnt) + (($iSBcnt % $iSlCnt) ? 1 : 0);
+ $iBBcnt += (floor($iSmallLen / $this->bigBlockSize)
+ + (($iSmallLen % $this->bigBlockSize) ? 1 : 0));
+ $iCnt = count($raList);
+ $iBdCnt = $this->bigBlockSize / OLE::OLE_PPS_SIZE;
+ $iPPScnt = (floor($iCnt / $iBdCnt) + (($iCnt % $iBdCnt) ? 1 : 0));
+
+ return [$iSBDcnt, $iBBcnt, $iPPScnt];
+ }
+
+ /**
+ * Helper function for caculating a magic value for block sizes.
+ *
+ * @param int $i2 The argument
+ *
+ * @see save()
+ */
+ private static function adjust2(int $i2): float
+ {
+ $iWk = log($i2) / log(2);
+
+ return ($iWk > floor($iWk)) ? floor($iWk) + 1 : $iWk;
+ }
+
+ /**
+ * Save OLE header.
+ */
+ private function saveHeader(int $iSBDcnt, int $iBBcnt, int $iPPScnt): void
+ {
+ $FILE = $this->fileHandle;
+
+ // Calculate Basic Setting
+ $iBlCnt = $this->bigBlockSize / OLE::OLE_LONG_INT_SIZE;
+ $i1stBdL = ($this->bigBlockSize - 0x4C) / OLE::OLE_LONG_INT_SIZE;
+
+ $iBdExL = 0;
+ $iAll = $iBBcnt + $iPPScnt + $iSBDcnt;
+ $iAllW = $iAll;
+ $iBdCntW = floor($iAllW / $iBlCnt) + (($iAllW % $iBlCnt) ? 1 : 0);
+ $iBdCnt = floor(($iAll + $iBdCntW) / $iBlCnt) + ((($iAllW + $iBdCntW) % $iBlCnt) ? 1 : 0);
+
+ // Calculate BD count
+ if ($iBdCnt > $i1stBdL) {
+ while (1) {
+ ++$iBdExL;
+ ++$iAllW;
+ $iBdCntW = floor($iAllW / $iBlCnt) + (($iAllW % $iBlCnt) ? 1 : 0);
+ $iBdCnt = floor(($iAllW + $iBdCntW) / $iBlCnt) + ((($iAllW + $iBdCntW) % $iBlCnt) ? 1 : 0);
+ if ($iBdCnt <= ($iBdExL * $iBlCnt + $i1stBdL)) {
+ break;
+ }
+ }
+ }
+
+ // Save Header
+ fwrite(
+ $FILE,
+ "\xD0\xCF\x11\xE0\xA1\xB1\x1A\xE1"
+ . "\x00\x00\x00\x00"
+ . "\x00\x00\x00\x00"
+ . "\x00\x00\x00\x00"
+ . "\x00\x00\x00\x00"
+ . pack('v', 0x3B)
+ . pack('v', 0x03)
+ . pack('v', -2)
+ . pack('v', 9)
+ . pack('v', 6)
+ . pack('v', 0)
+ . "\x00\x00\x00\x00"
+ . "\x00\x00\x00\x00"
+ . pack('V', $iBdCnt)
+ . pack('V', $iBBcnt + $iSBDcnt) //ROOT START
+ . pack('V', 0)
+ . pack('V', 0x1000)
+ . pack('V', $iSBDcnt ? 0 : -2) //Small Block Depot
+ . pack('V', $iSBDcnt)
+ );
+ // Extra BDList Start, Count
+ if ($iBdCnt < $i1stBdL) {
+ fwrite(
+ $FILE,
+ pack('V', -2) // Extra BDList Start
+ . pack('V', 0)// Extra BDList Count
+ );
+ } else {
+ fwrite($FILE, pack('V', $iAll + $iBdCnt) . pack('V', $iBdExL));
+ }
+
+ // BDList
+ for ($i = 0; $i < $i1stBdL && $i < $iBdCnt; ++$i) {
+ fwrite($FILE, pack('V', $iAll + $i));
+ }
+ if ($i < $i1stBdL) {
+ $jB = $i1stBdL - $i;
+ for ($j = 0; $j < $jB; ++$j) {
+ fwrite($FILE, (pack('V', -1)));
+ }
+ }
+ }
+
+ /**
+ * Saving big data (PPS's with data bigger than \PhpOffice\PhpSpreadsheet\Shared\OLE::OLE_DATA_SIZE_SMALL).
+ *
+ * @param array $raList Reference to array of PPS's
+ */
+ private function saveBigData(int $iStBlk, array &$raList): void
+ {
+ $FILE = $this->fileHandle;
+
+ // cycle through PPS's
+ $iCount = count($raList);
+ for ($i = 0; $i < $iCount; ++$i) {
+ if ($raList[$i]->Type != OLE::OLE_PPS_TYPE_DIR) {
+ $raList[$i]->Size = $raList[$i]->getDataLen();
+ if (($raList[$i]->Size >= OLE::OLE_DATA_SIZE_SMALL) || (($raList[$i]->Type == OLE::OLE_PPS_TYPE_ROOT) && isset($raList[$i]->_data))) {
+ fwrite($FILE, $raList[$i]->_data);
+
+ if ($raList[$i]->Size % $this->bigBlockSize) {
+ fwrite($FILE, str_repeat("\x00", $this->bigBlockSize - ($raList[$i]->Size % $this->bigBlockSize)));
+ }
+ // Set For PPS
+ $raList[$i]->startBlock = $iStBlk;
+ $iStBlk
+ += (floor($raList[$i]->Size / $this->bigBlockSize)
+ + (($raList[$i]->Size % $this->bigBlockSize) ? 1 : 0));
+ }
+ }
+ }
+ }
+
+ /**
+ * get small data (PPS's with data smaller than \PhpOffice\PhpSpreadsheet\Shared\OLE::OLE_DATA_SIZE_SMALL).
+ *
+ * @param array $raList Reference to array of PPS's
+ */
+ private function makeSmallData(array &$raList): string
+ {
+ $sRes = '';
+ $FILE = $this->fileHandle;
+ $iSmBlk = 0;
+
+ $iCount = count($raList);
+ for ($i = 0; $i < $iCount; ++$i) {
+ // Make SBD, small data string
+ if ($raList[$i]->Type == OLE::OLE_PPS_TYPE_FILE) {
+ if ($raList[$i]->Size <= 0) {
+ continue;
+ }
+ if ($raList[$i]->Size < OLE::OLE_DATA_SIZE_SMALL) {
+ $iSmbCnt = floor($raList[$i]->Size / $this->smallBlockSize)
+ + (($raList[$i]->Size % $this->smallBlockSize) ? 1 : 0);
+ // Add to SBD
+ $jB = $iSmbCnt - 1;
+ for ($j = 0; $j < $jB; ++$j) {
+ fwrite($FILE, pack('V', $j + $iSmBlk + 1));
+ }
+ fwrite($FILE, pack('V', -2));
+
+ // Add to Data String(this will be written for RootEntry)
+ $sRes .= $raList[$i]->_data;
+ if ($raList[$i]->Size % $this->smallBlockSize) {
+ $sRes .= str_repeat("\x00", $this->smallBlockSize - ($raList[$i]->Size % $this->smallBlockSize));
+ }
+ // Set for PPS
+ $raList[$i]->startBlock = $iSmBlk;
+ $iSmBlk += $iSmbCnt;
+ }
+ }
+ }
+ $iSbCnt = floor($this->bigBlockSize / OLE::OLE_LONG_INT_SIZE);
+ if ($iSmBlk % $iSbCnt) {
+ $iB = $iSbCnt - ($iSmBlk % $iSbCnt);
+ for ($i = 0; $i < $iB; ++$i) {
+ fwrite($FILE, pack('V', -1));
+ }
+ }
+
+ return $sRes;
+ }
+
+ /**
+ * Saves all the PPS's WKs.
+ *
+ * @param array $raList Reference to an array with all PPS's
+ */
+ private function savePps(array &$raList): void
+ {
+ // Save each PPS WK
+ $iC = count($raList);
+ for ($i = 0; $i < $iC; ++$i) {
+ fwrite($this->fileHandle, $raList[$i]->getPpsWk());
+ }
+ // Adjust for Block
+ $iCnt = count($raList);
+ $iBCnt = $this->bigBlockSize / OLE::OLE_PPS_SIZE;
+ if ($iCnt % $iBCnt) {
+ fwrite($this->fileHandle, str_repeat("\x00", ($iBCnt - ($iCnt % $iBCnt)) * OLE::OLE_PPS_SIZE));
+ }
+ }
+
+ /**
+ * Saving Big Block Depot.
+ */
+ private function saveBbd(int $iSbdSize, int $iBsize, int $iPpsCnt): void
+ {
+ $FILE = $this->fileHandle;
+ // Calculate Basic Setting
+ $iBbCnt = $this->bigBlockSize / OLE::OLE_LONG_INT_SIZE;
+ $i1stBdL = ($this->bigBlockSize - 0x4C) / OLE::OLE_LONG_INT_SIZE;
+
+ $iBdExL = 0;
+ $iAll = $iBsize + $iPpsCnt + $iSbdSize;
+ $iAllW = $iAll;
+ $iBdCntW = floor($iAllW / $iBbCnt) + (($iAllW % $iBbCnt) ? 1 : 0);
+ $iBdCnt = floor(($iAll + $iBdCntW) / $iBbCnt) + ((($iAllW + $iBdCntW) % $iBbCnt) ? 1 : 0);
+ // Calculate BD count
+ if ($iBdCnt > $i1stBdL) {
+ while (1) {
+ ++$iBdExL;
+ ++$iAllW;
+ $iBdCntW = floor($iAllW / $iBbCnt) + (($iAllW % $iBbCnt) ? 1 : 0);
+ $iBdCnt = floor(($iAllW + $iBdCntW) / $iBbCnt) + ((($iAllW + $iBdCntW) % $iBbCnt) ? 1 : 0);
+ if ($iBdCnt <= ($iBdExL * $iBbCnt + $i1stBdL)) {
+ break;
+ }
+ }
+ }
+
+ // Making BD
+ // Set for SBD
+ if ($iSbdSize > 0) {
+ for ($i = 0; $i < ($iSbdSize - 1); ++$i) {
+ fwrite($FILE, pack('V', $i + 1));
+ }
+ fwrite($FILE, pack('V', -2));
+ }
+ // Set for B
+ for ($i = 0; $i < ($iBsize - 1); ++$i) {
+ fwrite($FILE, pack('V', $i + $iSbdSize + 1));
+ }
+ fwrite($FILE, pack('V', -2));
+
+ // Set for PPS
+ for ($i = 0; $i < ($iPpsCnt - 1); ++$i) {
+ fwrite($FILE, pack('V', $i + $iSbdSize + $iBsize + 1));
+ }
+ fwrite($FILE, pack('V', -2));
+ // Set for BBD itself ( 0xFFFFFFFD : BBD)
+ for ($i = 0; $i < $iBdCnt; ++$i) {
+ fwrite($FILE, pack('V', 0xFFFFFFFD));
+ }
+ // Set for ExtraBDList
+ for ($i = 0; $i < $iBdExL; ++$i) {
+ fwrite($FILE, pack('V', 0xFFFFFFFC));
+ }
+ // Adjust for Block
+ if (($iAllW + $iBdCnt) % $iBbCnt) {
+ $iBlock = ($iBbCnt - (($iAllW + $iBdCnt) % $iBbCnt));
+ for ($i = 0; $i < $iBlock; ++$i) {
+ fwrite($FILE, pack('V', -1));
+ }
+ }
+ // Extra BDList
+ if ($iBdCnt > $i1stBdL) {
+ $iN = 0;
+ $iNb = 0;
+ for ($i = $i1stBdL; $i < $iBdCnt; $i++, ++$iN) {
+ if ($iN >= ($iBbCnt - 1)) {
+ $iN = 0;
+ ++$iNb;
+ fwrite($FILE, pack('V', $iAll + $iBdCnt + $iNb));
+ }
+ fwrite($FILE, pack('V', $iBsize + $iSbdSize + $iPpsCnt + $i));
+ }
+ if (($iBdCnt - $i1stBdL) % ($iBbCnt - 1)) {
+ $iB = ($iBbCnt - 1) - (($iBdCnt - $i1stBdL) % ($iBbCnt - 1));
+ for ($i = 0; $i < $iB; ++$i) {
+ fwrite($FILE, pack('V', -1));
+ }
+ }
+ fwrite($FILE, pack('V', -2));
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLERead.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLERead.php
new file mode 100644
index 00000000..645dbf77
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/OLERead.php
@@ -0,0 +1,307 @@
+data = (string) file_get_contents($filename, false, null, 0, 8);
+
+ // Check OLE identifier
+ $identifierOle = pack('CCCCCCCC', 0xD0, 0xCF, 0x11, 0xE0, 0xA1, 0xB1, 0x1A, 0xE1);
+ if ($this->data != $identifierOle) {
+ throw new ReaderException('The filename ' . $filename . ' is not recognised as an OLE file');
+ }
+
+ // Get the file data
+ $this->data = (string) file_get_contents($filename);
+
+ // Total number of sectors used for the SAT
+ $this->numBigBlockDepotBlocks = self::getInt4d($this->data, self::NUM_BIG_BLOCK_DEPOT_BLOCKS_POS);
+
+ // SecID of the first sector of the directory stream
+ $this->rootStartBlock = self::getInt4d($this->data, self::ROOT_START_BLOCK_POS);
+
+ // SecID of the first sector of the SSAT (or -2 if not extant)
+ $this->sbdStartBlock = self::getInt4d($this->data, self::SMALL_BLOCK_DEPOT_BLOCK_POS);
+
+ // SecID of the first sector of the MSAT (or -2 if no additional sectors are used)
+ $this->extensionBlock = self::getInt4d($this->data, self::EXTENSION_BLOCK_POS);
+
+ // Total number of sectors used by MSAT
+ $this->numExtensionBlocks = self::getInt4d($this->data, self::NUM_EXTENSION_BLOCK_POS);
+
+ $bigBlockDepotBlocks = [];
+ $pos = self::BIG_BLOCK_DEPOT_BLOCKS_POS;
+
+ $bbdBlocks = $this->numBigBlockDepotBlocks;
+
+ if ($this->numExtensionBlocks !== 0) {
+ $bbdBlocks = (self::BIG_BLOCK_SIZE - self::BIG_BLOCK_DEPOT_BLOCKS_POS) / 4;
+ }
+
+ for ($i = 0; $i < $bbdBlocks; ++$i) {
+ $bigBlockDepotBlocks[$i] = self::getInt4d($this->data, $pos);
+ $pos += 4;
+ }
+
+ for ($j = 0; $j < $this->numExtensionBlocks; ++$j) {
+ $pos = ($this->extensionBlock + 1) * self::BIG_BLOCK_SIZE;
+ $blocksToRead = min($this->numBigBlockDepotBlocks - $bbdBlocks, self::BIG_BLOCK_SIZE / 4 - 1);
+
+ for ($i = $bbdBlocks; $i < $bbdBlocks + $blocksToRead; ++$i) {
+ $bigBlockDepotBlocks[$i] = self::getInt4d($this->data, $pos);
+ $pos += 4;
+ }
+
+ $bbdBlocks += $blocksToRead;
+ if ($bbdBlocks < $this->numBigBlockDepotBlocks) {
+ $this->extensionBlock = self::getInt4d($this->data, $pos);
+ }
+ }
+
+ $pos = 0;
+ $this->bigBlockChain = '';
+ $bbs = self::BIG_BLOCK_SIZE / 4;
+ for ($i = 0; $i < $this->numBigBlockDepotBlocks; ++$i) {
+ $pos = ($bigBlockDepotBlocks[$i] + 1) * self::BIG_BLOCK_SIZE;
+
+ $this->bigBlockChain .= substr($this->data, $pos, 4 * $bbs);
+ $pos += 4 * $bbs;
+ }
+
+ $sbdBlock = $this->sbdStartBlock;
+ $this->smallBlockChain = '';
+ while ($sbdBlock != -2) {
+ $pos = ($sbdBlock + 1) * self::BIG_BLOCK_SIZE;
+
+ $this->smallBlockChain .= substr($this->data, $pos, 4 * $bbs);
+ $pos += 4 * $bbs;
+
+ $sbdBlock = self::getInt4d($this->bigBlockChain, $sbdBlock * 4);
+ }
+
+ // read the directory stream
+ $block = $this->rootStartBlock;
+ $this->entry = $this->readData($block);
+
+ $this->readPropertySets();
+ }
+
+ /**
+ * Extract binary stream data.
+ */
+ public function getStream(?int $stream): ?string
+ {
+ if ($stream === null) {
+ return null;
+ }
+
+ $streamData = '';
+
+ if ($this->props[$stream]['size'] < self::SMALL_BLOCK_THRESHOLD) {
+ $rootdata = $this->readData($this->props[$this->rootentry]['startBlock']);
+
+ $block = $this->props[$stream]['startBlock'];
+
+ while ($block != -2) {
+ $pos = $block * self::SMALL_BLOCK_SIZE;
+ $streamData .= substr($rootdata, $pos, self::SMALL_BLOCK_SIZE);
+
+ $block = self::getInt4d($this->smallBlockChain, $block * 4);
+ }
+
+ return $streamData;
+ }
+ $numBlocks = $this->props[$stream]['size'] / self::BIG_BLOCK_SIZE;
+ if ($this->props[$stream]['size'] % self::BIG_BLOCK_SIZE != 0) {
+ ++$numBlocks;
+ }
+
+ if ($numBlocks == 0) {
+ return '';
+ }
+
+ $block = $this->props[$stream]['startBlock'];
+
+ while ($block != -2) {
+ $pos = ($block + 1) * self::BIG_BLOCK_SIZE;
+ $streamData .= substr($this->data, $pos, self::BIG_BLOCK_SIZE);
+ $block = self::getInt4d($this->bigBlockChain, $block * 4);
+ }
+
+ return $streamData;
+ }
+
+ /**
+ * Read a standard stream (by joining sectors using information from SAT).
+ *
+ * @param int $block Sector ID where the stream starts
+ *
+ * @return string Data for standard stream
+ */
+ private function readData(int $block): string
+ {
+ $data = '';
+
+ while ($block != -2) {
+ $pos = ($block + 1) * self::BIG_BLOCK_SIZE;
+ $data .= substr($this->data, $pos, self::BIG_BLOCK_SIZE);
+ $block = self::getInt4d($this->bigBlockChain, $block * 4);
+ }
+
+ return $data;
+ }
+
+ /**
+ * Read entries in the directory stream.
+ */
+ private function readPropertySets(): void
+ {
+ $offset = 0;
+
+ // loop through entires, each entry is 128 bytes
+ $entryLen = strlen($this->entry);
+ while ($offset < $entryLen) {
+ // entry data (128 bytes)
+ $d = substr($this->entry, $offset, self::PROPERTY_STORAGE_BLOCK_SIZE);
+
+ // size in bytes of name
+ $nameSize = ord($d[self::SIZE_OF_NAME_POS]) | (ord($d[self::SIZE_OF_NAME_POS + 1]) << 8);
+
+ // type of entry
+ $type = ord($d[self::TYPE_POS]);
+
+ // sectorID of first sector or short sector, if this entry refers to a stream (the case with workbook)
+ // sectorID of first sector of the short-stream container stream, if this entry is root entry
+ $startBlock = self::getInt4d($d, self::START_BLOCK_POS);
+
+ $size = self::getInt4d($d, self::SIZE_POS);
+
+ $name = str_replace("\x00", '', substr($d, 0, $nameSize));
+
+ $this->props[] = [
+ 'name' => $name,
+ 'type' => $type,
+ 'startBlock' => $startBlock,
+ 'size' => $size,
+ ];
+
+ // tmp helper to simplify checks
+ $upName = strtoupper($name);
+
+ // Workbook directory entry (BIFF5 uses Book, BIFF8 uses Workbook)
+ if (($upName === 'WORKBOOK') || ($upName === 'BOOK')) {
+ $this->wrkbook = count($this->props) - 1;
+ } elseif ($upName === 'ROOT ENTRY' || $upName === 'R') {
+ // Root entry
+ $this->rootentry = count($this->props) - 1;
+ }
+
+ // Summary information
+ if ($name == chr(5) . 'SummaryInformation') {
+ $this->summaryInformation = count($this->props) - 1;
+ }
+
+ // Additional Document Summary information
+ if ($name == chr(5) . 'DocumentSummaryInformation') {
+ $this->documentSummaryInformation = count($this->props) - 1;
+ }
+
+ $offset += self::PROPERTY_STORAGE_BLOCK_SIZE;
+ }
+ }
+
+ /**
+ * Read 4 bytes of data at specified position.
+ */
+ private static function getInt4d(string $data, int $pos): int
+ {
+ if ($pos < 0) {
+ // Invalid position
+ throw new ReaderException('Parameter pos=' . $pos . ' is invalid.');
+ }
+
+ $len = strlen($data);
+ if ($len < $pos + 4) {
+ $data .= str_repeat("\0", $pos + 4 - $len);
+ }
+
+ // FIX: represent numbers correctly on 64-bit system
+ // http://sourceforge.net/tracker/index.php?func=detail&aid=1487372&group_id=99160&atid=623334
+ // Changed by Andreas Rehm 2006 to ensure correct result of the <<24 block on 32 and 64bit systems
+ $_or_24 = ord($data[$pos + 3]);
+ if ($_or_24 >= 128) {
+ // negative number
+ $_ord_24 = -abs((256 - $_or_24) << 24);
+ } else {
+ $_ord_24 = ($_or_24 & 127) << 24;
+ }
+
+ return ord($data[$pos]) | (ord($data[$pos + 1]) << 8) | (ord($data[$pos + 2]) << 16) | $_ord_24;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/PasswordHasher.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/PasswordHasher.php
new file mode 100644
index 00000000..fcdbc982
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/PasswordHasher.php
@@ -0,0 +1,106 @@
+ 'md2',
+ Protection::ALGORITHM_MD4 => 'md4',
+ Protection::ALGORITHM_MD5 => 'md5',
+ Protection::ALGORITHM_SHA_1 => 'sha1',
+ Protection::ALGORITHM_SHA_256 => 'sha256',
+ Protection::ALGORITHM_SHA_384 => 'sha384',
+ Protection::ALGORITHM_SHA_512 => 'sha512',
+ Protection::ALGORITHM_RIPEMD_128 => 'ripemd128',
+ Protection::ALGORITHM_RIPEMD_160 => 'ripemd160',
+ Protection::ALGORITHM_WHIRLPOOL => 'whirlpool',
+ ];
+
+ if (array_key_exists($algorithmName, $mapping)) {
+ return $mapping[$algorithmName];
+ }
+
+ throw new SpException('Unsupported password algorithm: ' . $algorithmName);
+ }
+
+ /**
+ * Create a password hash from a given string.
+ *
+ * This method is based on the spec at:
+ * https://interoperability.blob.core.windows.net/files/MS-OFFCRYPTO/[MS-OFFCRYPTO].pdf
+ * 2.3.7.1 Binary Document Password Verifier Derivation Method 1
+ *
+ * It replaces a method based on the algorithm provided by
+ * Daniel Rentz of OpenOffice and the PEAR package
+ * Spreadsheet_Excel_Writer by Xavier Noguer .
+ *
+ * @param string $password Password to hash
+ */
+ private static function defaultHashPassword(string $password): string
+ {
+ $verifier = 0;
+ $pwlen = strlen($password);
+ $passwordArray = pack('c', $pwlen) . $password;
+ for ($i = $pwlen; $i >= 0; --$i) {
+ $intermediate1 = (($verifier & 0x4000) === 0) ? 0 : 1;
+ $intermediate2 = 2 * $verifier;
+ $intermediate2 = $intermediate2 & 0x7FFF;
+ $intermediate3 = $intermediate1 | $intermediate2;
+ $verifier = $intermediate3 ^ ord($passwordArray[$i]);
+ }
+ $verifier ^= 0xCE4B;
+
+ return strtoupper(dechex($verifier));
+ }
+
+ /**
+ * Create a password hash from a given string by a specific algorithm.
+ *
+ * 2.4.2.4 ISO Write Protection Method
+ *
+ * @see https://docs.microsoft.com/en-us/openspecs/office_file_formats/ms-offcrypto/1357ea58-646e-4483-92ef-95d718079d6f
+ *
+ * @param string $password Password to hash
+ * @param string $algorithm Hash algorithm used to compute the password hash value
+ * @param string $salt Pseudorandom string
+ * @param int $spinCount Number of times to iterate on a hash of a password
+ *
+ * @return string Hashed password
+ */
+ public static function hashPassword(string $password, string $algorithm = '', string $salt = '', int $spinCount = 10000): string
+ {
+ if (strlen($password) > self::MAX_PASSWORD_LENGTH) {
+ throw new SpException('Password exceeds ' . self::MAX_PASSWORD_LENGTH . ' characters');
+ }
+ $phpAlgorithm = self::getAlgorithm($algorithm);
+ if (!$phpAlgorithm) {
+ return self::defaultHashPassword($password);
+ }
+
+ $saltValue = base64_decode($salt);
+ $encodedPassword = mb_convert_encoding($password, 'UCS-2LE', 'UTF-8');
+
+ $hashValue = hash($phpAlgorithm, $saltValue . $encodedPassword, true);
+ for ($i = 0; $i < $spinCount; ++$i) {
+ $hashValue = hash($phpAlgorithm, $hashValue . pack('L', $i), true);
+ }
+
+ return base64_encode($hashValue);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/StringHelper.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/StringHelper.php
new file mode 100644
index 00000000..aac3836c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/StringHelper.php
@@ -0,0 +1,650 @@
+ chr(0),
+ "\x1B 1" => chr(1),
+ "\x1B 2" => chr(2),
+ "\x1B 3" => chr(3),
+ "\x1B 4" => chr(4),
+ "\x1B 5" => chr(5),
+ "\x1B 6" => chr(6),
+ "\x1B 7" => chr(7),
+ "\x1B 8" => chr(8),
+ "\x1B 9" => chr(9),
+ "\x1B :" => chr(10),
+ "\x1B ;" => chr(11),
+ "\x1B <" => chr(12),
+ "\x1B =" => chr(13),
+ "\x1B >" => chr(14),
+ "\x1B ?" => chr(15),
+ "\x1B!0" => chr(16),
+ "\x1B!1" => chr(17),
+ "\x1B!2" => chr(18),
+ "\x1B!3" => chr(19),
+ "\x1B!4" => chr(20),
+ "\x1B!5" => chr(21),
+ "\x1B!6" => chr(22),
+ "\x1B!7" => chr(23),
+ "\x1B!8" => chr(24),
+ "\x1B!9" => chr(25),
+ "\x1B!:" => chr(26),
+ "\x1B!;" => chr(27),
+ "\x1B!<" => chr(28),
+ "\x1B!=" => chr(29),
+ "\x1B!>" => chr(30),
+ "\x1B!?" => chr(31),
+ "\x1B'?" => chr(127),
+ "\x1B(0" => '€', // 128 in CP1252
+ "\x1B(2" => '‚', // 130 in CP1252
+ "\x1B(3" => 'ƒ', // 131 in CP1252
+ "\x1B(4" => '„', // 132 in CP1252
+ "\x1B(5" => '…', // 133 in CP1252
+ "\x1B(6" => '†', // 134 in CP1252
+ "\x1B(7" => '‡', // 135 in CP1252
+ "\x1B(8" => 'ˆ', // 136 in CP1252
+ "\x1B(9" => '‰', // 137 in CP1252
+ "\x1B(:" => 'Š', // 138 in CP1252
+ "\x1B(;" => '‹', // 139 in CP1252
+ "\x1BNj" => 'Œ', // 140 in CP1252
+ "\x1B(>" => 'Ž', // 142 in CP1252
+ "\x1B)1" => '‘', // 145 in CP1252
+ "\x1B)2" => '’', // 146 in CP1252
+ "\x1B)3" => '“', // 147 in CP1252
+ "\x1B)4" => '”', // 148 in CP1252
+ "\x1B)5" => '•', // 149 in CP1252
+ "\x1B)6" => '–', // 150 in CP1252
+ "\x1B)7" => '—', // 151 in CP1252
+ "\x1B)8" => '˜', // 152 in CP1252
+ "\x1B)9" => '™', // 153 in CP1252
+ "\x1B):" => 'š', // 154 in CP1252
+ "\x1B);" => '›', // 155 in CP1252
+ "\x1BNz" => 'œ', // 156 in CP1252
+ "\x1B)>" => 'ž', // 158 in CP1252
+ "\x1B)?" => 'Ÿ', // 159 in CP1252
+ "\x1B*0" => ' ', // 160 in CP1252
+ "\x1BN!" => '¡', // 161 in CP1252
+ "\x1BN\"" => '¢', // 162 in CP1252
+ "\x1BN#" => '£', // 163 in CP1252
+ "\x1BN(" => '¤', // 164 in CP1252
+ "\x1BN%" => '¥', // 165 in CP1252
+ "\x1B*6" => '¦', // 166 in CP1252
+ "\x1BN'" => '§', // 167 in CP1252
+ "\x1BNH " => '¨', // 168 in CP1252
+ "\x1BNS" => '©', // 169 in CP1252
+ "\x1BNc" => 'ª', // 170 in CP1252
+ "\x1BN+" => '«', // 171 in CP1252
+ "\x1B*<" => '¬', // 172 in CP1252
+ "\x1B*=" => '', // 173 in CP1252
+ "\x1BNR" => '®', // 174 in CP1252
+ "\x1B*?" => '¯', // 175 in CP1252
+ "\x1BN0" => '°', // 176 in CP1252
+ "\x1BN1" => '±', // 177 in CP1252
+ "\x1BN2" => '²', // 178 in CP1252
+ "\x1BN3" => '³', // 179 in CP1252
+ "\x1BNB " => '´', // 180 in CP1252
+ "\x1BN5" => 'µ', // 181 in CP1252
+ "\x1BN6" => '¶', // 182 in CP1252
+ "\x1BN7" => '·', // 183 in CP1252
+ "\x1B+8" => '¸', // 184 in CP1252
+ "\x1BNQ" => '¹', // 185 in CP1252
+ "\x1BNk" => 'º', // 186 in CP1252
+ "\x1BN;" => '»', // 187 in CP1252
+ "\x1BN<" => '¼', // 188 in CP1252
+ "\x1BN=" => '½', // 189 in CP1252
+ "\x1BN>" => '¾', // 190 in CP1252
+ "\x1BN?" => '¿', // 191 in CP1252
+ "\x1BNAA" => 'À', // 192 in CP1252
+ "\x1BNBA" => 'Á', // 193 in CP1252
+ "\x1BNCA" => 'Â', // 194 in CP1252
+ "\x1BNDA" => 'Ã', // 195 in CP1252
+ "\x1BNHA" => 'Ä', // 196 in CP1252
+ "\x1BNJA" => 'Å', // 197 in CP1252
+ "\x1BNa" => 'Æ', // 198 in CP1252
+ "\x1BNKC" => 'Ç', // 199 in CP1252
+ "\x1BNAE" => 'È', // 200 in CP1252
+ "\x1BNBE" => 'É', // 201 in CP1252
+ "\x1BNCE" => 'Ê', // 202 in CP1252
+ "\x1BNHE" => 'Ë', // 203 in CP1252
+ "\x1BNAI" => 'Ì', // 204 in CP1252
+ "\x1BNBI" => 'Í', // 205 in CP1252
+ "\x1BNCI" => 'Î', // 206 in CP1252
+ "\x1BNHI" => 'Ï', // 207 in CP1252
+ "\x1BNb" => 'Ð', // 208 in CP1252
+ "\x1BNDN" => 'Ñ', // 209 in CP1252
+ "\x1BNAO" => 'Ò', // 210 in CP1252
+ "\x1BNBO" => 'Ó', // 211 in CP1252
+ "\x1BNCO" => 'Ô', // 212 in CP1252
+ "\x1BNDO" => 'Õ', // 213 in CP1252
+ "\x1BNHO" => 'Ö', // 214 in CP1252
+ "\x1B-7" => '×', // 215 in CP1252
+ "\x1BNi" => 'Ø', // 216 in CP1252
+ "\x1BNAU" => 'Ù', // 217 in CP1252
+ "\x1BNBU" => 'Ú', // 218 in CP1252
+ "\x1BNCU" => 'Û', // 219 in CP1252
+ "\x1BNHU" => 'Ü', // 220 in CP1252
+ "\x1B-=" => 'Ý', // 221 in CP1252
+ "\x1BNl" => 'Þ', // 222 in CP1252
+ "\x1BN{" => 'ß', // 223 in CP1252
+ "\x1BNAa" => 'à', // 224 in CP1252
+ "\x1BNBa" => 'á', // 225 in CP1252
+ "\x1BNCa" => 'â', // 226 in CP1252
+ "\x1BNDa" => 'ã', // 227 in CP1252
+ "\x1BNHa" => 'ä', // 228 in CP1252
+ "\x1BNJa" => 'å', // 229 in CP1252
+ "\x1BNq" => 'æ', // 230 in CP1252
+ "\x1BNKc" => 'ç', // 231 in CP1252
+ "\x1BNAe" => 'è', // 232 in CP1252
+ "\x1BNBe" => 'é', // 233 in CP1252
+ "\x1BNCe" => 'ê', // 234 in CP1252
+ "\x1BNHe" => 'ë', // 235 in CP1252
+ "\x1BNAi" => 'ì', // 236 in CP1252
+ "\x1BNBi" => 'í', // 237 in CP1252
+ "\x1BNCi" => 'î', // 238 in CP1252
+ "\x1BNHi" => 'ï', // 239 in CP1252
+ "\x1BNs" => 'ð', // 240 in CP1252
+ "\x1BNDn" => 'ñ', // 241 in CP1252
+ "\x1BNAo" => 'ò', // 242 in CP1252
+ "\x1BNBo" => 'ó', // 243 in CP1252
+ "\x1BNCo" => 'ô', // 244 in CP1252
+ "\x1BNDo" => 'õ', // 245 in CP1252
+ "\x1BNHo" => 'ö', // 246 in CP1252
+ "\x1B/7" => '÷', // 247 in CP1252
+ "\x1BNy" => 'ø', // 248 in CP1252
+ "\x1BNAu" => 'ù', // 249 in CP1252
+ "\x1BNBu" => 'ú', // 250 in CP1252
+ "\x1BNCu" => 'û', // 251 in CP1252
+ "\x1BNHu" => 'ü', // 252 in CP1252
+ "\x1B/=" => 'ý', // 253 in CP1252
+ "\x1BN|" => 'þ', // 254 in CP1252
+ "\x1BNHy" => 'ÿ', // 255 in CP1252
+ ];
+ }
+
+ /**
+ * Get whether iconv extension is available.
+ */
+ public static function getIsIconvEnabled(): bool
+ {
+ if (isset(self::$isIconvEnabled)) {
+ return self::$isIconvEnabled;
+ }
+
+ // Assume no problems with iconv
+ self::$isIconvEnabled = true;
+
+ // Fail if iconv doesn't exist
+ if (!function_exists('iconv')) {
+ self::$isIconvEnabled = false;
+ } elseif (!@iconv('UTF-8', 'UTF-16LE', 'x')) {
+ // Sometimes iconv is not working, and e.g. iconv('UTF-8', 'UTF-16LE', 'x') just returns false,
+ self::$isIconvEnabled = false;
+ } elseif (defined('PHP_OS') && @stristr(PHP_OS, 'AIX') && defined('ICONV_IMPL') && (@strcasecmp(ICONV_IMPL, 'unknown') == 0) && defined('ICONV_VERSION') && (@strcasecmp(ICONV_VERSION, 'unknown') == 0)) {
+ // CUSTOM: IBM AIX iconv() does not work
+ self::$isIconvEnabled = false;
+ }
+
+ // Deactivate iconv default options if they fail (as seen on IMB i)
+ if (self::$isIconvEnabled && !@iconv('UTF-8', 'UTF-16LE' . self::$iconvOptions, 'x')) {
+ self::$iconvOptions = '';
+ }
+
+ return self::$isIconvEnabled;
+ }
+
+ private static function buildCharacterSets(): void
+ {
+ if (empty(self::$controlCharacters)) {
+ self::buildControlCharacters();
+ }
+
+ if (empty(self::$SYLKCharacters)) {
+ self::buildSYLKCharacters();
+ }
+ }
+
+ /**
+ * Convert from OpenXML escaped control character to PHP control character.
+ *
+ * Excel 2007 team:
+ * ----------------
+ * That's correct, control characters are stored directly in the shared-strings table.
+ * We do encode characters that cannot be represented in XML using the following escape sequence:
+ * _xHHHH_ where H represents a hexadecimal character in the character's value...
+ * So you could end up with something like _x0008_ in a string (either in a cell value ()
+ * element or in the shared string element.
+ *
+ * @param string $textValue Value to unescape
+ */
+ public static function controlCharacterOOXML2PHP(string $textValue): string
+ {
+ self::buildCharacterSets();
+
+ return str_replace(array_keys(self::$controlCharacters), array_values(self::$controlCharacters), $textValue);
+ }
+
+ /**
+ * Convert from PHP control character to OpenXML escaped control character.
+ *
+ * Excel 2007 team:
+ * ----------------
+ * That's correct, control characters are stored directly in the shared-strings table.
+ * We do encode characters that cannot be represented in XML using the following escape sequence:
+ * _xHHHH_ where H represents a hexadecimal character in the character's value...
+ * So you could end up with something like _x0008_ in a string (either in a cell value ()
+ * element or in the shared string element.
+ *
+ * @param string $textValue Value to escape
+ */
+ public static function controlCharacterPHP2OOXML(string $textValue): string
+ {
+ self::buildCharacterSets();
+
+ return str_replace(array_values(self::$controlCharacters), array_keys(self::$controlCharacters), $textValue);
+ }
+
+ /**
+ * Try to sanitize UTF8, replacing invalid sequences with Unicode substitution characters.
+ */
+ public static function sanitizeUTF8(string $textValue): string
+ {
+ $textValue = str_replace(["\xef\xbf\xbe", "\xef\xbf\xbf"], "\xef\xbf\xbd", $textValue);
+ $subst = mb_substitute_character(); // default is question mark
+ mb_substitute_character(65533); // Unicode substitution character
+ // Phpstan does not think this can return false.
+ $returnValue = mb_convert_encoding($textValue, 'UTF-8', 'UTF-8');
+ mb_substitute_character($subst);
+
+ return $returnValue;
+ }
+
+ /**
+ * Check if a string contains UTF8 data.
+ */
+ public static function isUTF8(string $textValue): bool
+ {
+ return $textValue === self::sanitizeUTF8($textValue);
+ }
+
+ /**
+ * Formats a numeric value as a string for output in various output writers forcing
+ * point as decimal separator in case locale is other than English.
+ */
+ public static function formatNumber(float|int|string|null $numericValue): string
+ {
+ if (is_float($numericValue)) {
+ return str_replace(',', '.', (string) $numericValue);
+ }
+
+ return (string) $numericValue;
+ }
+
+ /**
+ * Converts a UTF-8 string into BIFF8 Unicode string data (8-bit string length)
+ * Writes the string using uncompressed notation, no rich text, no Asian phonetics
+ * If mbstring extension is not available, ASCII is assumed, and compressed notation is used
+ * although this will give wrong results for non-ASCII strings
+ * see OpenOffice.org's Documentation of the Microsoft Excel File Format, sect. 2.5.3.
+ *
+ * @param string $textValue UTF-8 encoded string
+ * @param array $arrcRuns Details of rich text runs in $value
+ */
+ public static function UTF8toBIFF8UnicodeShort(string $textValue, array $arrcRuns = []): string
+ {
+ // character count
+ $ln = self::countCharacters($textValue, 'UTF-8');
+ // option flags
+ if (empty($arrcRuns)) {
+ $data = pack('CC', $ln, 0x0001);
+ // characters
+ $data .= self::convertEncoding($textValue, 'UTF-16LE', 'UTF-8');
+ } else {
+ $data = pack('vC', $ln, 0x09);
+ $data .= pack('v', count($arrcRuns));
+ // characters
+ $data .= self::convertEncoding($textValue, 'UTF-16LE', 'UTF-8');
+ foreach ($arrcRuns as $cRun) {
+ $data .= pack('v', $cRun['strlen']);
+ $data .= pack('v', $cRun['fontidx']);
+ }
+ }
+
+ return $data;
+ }
+
+ /**
+ * Converts a UTF-8 string into BIFF8 Unicode string data (16-bit string length)
+ * Writes the string using uncompressed notation, no rich text, no Asian phonetics
+ * If mbstring extension is not available, ASCII is assumed, and compressed notation is used
+ * although this will give wrong results for non-ASCII strings
+ * see OpenOffice.org's Documentation of the Microsoft Excel File Format, sect. 2.5.3.
+ *
+ * @param string $textValue UTF-8 encoded string
+ */
+ public static function UTF8toBIFF8UnicodeLong(string $textValue): string
+ {
+ // characters
+ $chars = self::convertEncoding($textValue, 'UTF-16LE', 'UTF-8');
+ $ln = (int) (strlen($chars) / 2); // N.B. - strlen, not mb_strlen issue #642
+
+ return pack('vC', $ln, 0x0001) . $chars;
+ }
+
+ /**
+ * Convert string from one encoding to another.
+ *
+ * @param string $to Encoding to convert to, e.g. 'UTF-8'
+ * @param string $from Encoding to convert from, e.g. 'UTF-16LE'
+ */
+ public static function convertEncoding(string $textValue, string $to, string $from): string
+ {
+ if (self::getIsIconvEnabled()) {
+ $result = iconv($from, $to . self::$iconvOptions, $textValue);
+ if (false !== $result) {
+ return $result;
+ }
+ }
+
+ return mb_convert_encoding($textValue, $to, $from);
+ }
+
+ /**
+ * Get character count.
+ *
+ * @param string $encoding Encoding
+ *
+ * @return int Character count
+ */
+ public static function countCharacters(string $textValue, string $encoding = 'UTF-8'): int
+ {
+ return mb_strlen($textValue, $encoding);
+ }
+
+ /**
+ * Get character count using mb_strwidth rather than mb_strlen.
+ *
+ * @param string $encoding Encoding
+ *
+ * @return int Character count
+ */
+ public static function countCharactersDbcs(string $textValue, string $encoding = 'UTF-8'): int
+ {
+ return mb_strwidth($textValue, $encoding);
+ }
+
+ /**
+ * Get a substring of a UTF-8 encoded string.
+ *
+ * @param string $textValue UTF-8 encoded string
+ * @param int $offset Start offset
+ * @param ?int $length Maximum number of characters in substring
+ */
+ public static function substring(string $textValue, int $offset, ?int $length = 0): string
+ {
+ return mb_substr($textValue, $offset, $length, 'UTF-8');
+ }
+
+ /**
+ * Convert a UTF-8 encoded string to upper case.
+ *
+ * @param string $textValue UTF-8 encoded string
+ */
+ public static function strToUpper(string $textValue): string
+ {
+ return mb_convert_case($textValue, MB_CASE_UPPER, 'UTF-8');
+ }
+
+ /**
+ * Convert a UTF-8 encoded string to lower case.
+ *
+ * @param string $textValue UTF-8 encoded string
+ */
+ public static function strToLower(string $textValue): string
+ {
+ return mb_convert_case($textValue, MB_CASE_LOWER, 'UTF-8');
+ }
+
+ /**
+ * Convert a UTF-8 encoded string to title/proper case
+ * (uppercase every first character in each word, lower case all other characters).
+ *
+ * @param string $textValue UTF-8 encoded string
+ */
+ public static function strToTitle(string $textValue): string
+ {
+ return mb_convert_case($textValue, MB_CASE_TITLE, 'UTF-8');
+ }
+
+ public static function mbIsUpper(string $character): bool
+ {
+ return mb_strtolower($character, 'UTF-8') !== $character;
+ }
+
+ /**
+ * Splits a UTF-8 string into an array of individual characters.
+ */
+ public static function mbStrSplit(string $string): array
+ {
+ // Split at all position not after the start: ^
+ // and not before the end: $
+ $split = preg_split('/(? $v) {
+ $textValue = str_replace($k, $v, $textValue);
+ }
+
+ return $textValue;
+ }
+
+ /**
+ * Retrieve any leading numeric part of a string, or return the full string if no leading numeric
+ * (handles basic integer or float, but not exponent or non decimal).
+ *
+ * @return float|string string or only the leading numeric part of the string
+ */
+ public static function testStringAsNumeric(string $textValue): float|string
+ {
+ if (is_numeric($textValue)) {
+ return $textValue;
+ }
+ $v = (float) $textValue;
+
+ return (is_numeric(substr($textValue, 0, strlen((string) $v)))) ? $v : $textValue;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/TimeZone.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/TimeZone.php
new file mode 100644
index 00000000..f6e8500b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/TimeZone.php
@@ -0,0 +1,75 @@
+setTimeZone(new DateTimeZone($timezoneName));
+
+ return $dtobj->getOffset();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/BestFit.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/BestFit.php
new file mode 100644
index 00000000..f9dacfb8
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/BestFit.php
@@ -0,0 +1,425 @@
+error;
+ }
+
+ public function getBestFitType(): string
+ {
+ return $this->bestFitType;
+ }
+
+ /**
+ * Return the Y-Value for a specified value of X.
+ *
+ * @param float $xValue X-Value
+ *
+ * @return float Y-Value
+ */
+ abstract public function getValueOfYForX(float $xValue): float;
+
+ /**
+ * Return the X-Value for a specified value of Y.
+ *
+ * @param float $yValue Y-Value
+ *
+ * @return float X-Value
+ */
+ abstract public function getValueOfXForY(float $yValue): float;
+
+ /**
+ * Return the original set of X-Values.
+ *
+ * @return float[] X-Values
+ */
+ public function getXValues(): array
+ {
+ return $this->xValues;
+ }
+
+ /**
+ * Return the Equation of the best-fit line.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ abstract public function getEquation(int $dp = 0): string;
+
+ /**
+ * Return the Slope of the line.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getSlope(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->slope, $dp);
+ }
+
+ return $this->slope;
+ }
+
+ /**
+ * Return the standard error of the Slope.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getSlopeSE(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->slopeSE, $dp);
+ }
+
+ return $this->slopeSE;
+ }
+
+ /**
+ * Return the Value of X where it intersects Y = 0.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getIntersect(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->intersect, $dp);
+ }
+
+ return $this->intersect;
+ }
+
+ /**
+ * Return the standard error of the Intersect.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getIntersectSE(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->intersectSE, $dp);
+ }
+
+ return $this->intersectSE;
+ }
+
+ /**
+ * Return the goodness of fit for this regression.
+ *
+ * @param int $dp Number of places of decimal precision to return
+ */
+ public function getGoodnessOfFit(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->goodnessOfFit, $dp);
+ }
+
+ return $this->goodnessOfFit;
+ }
+
+ /**
+ * Return the goodness of fit for this regression.
+ *
+ * @param int $dp Number of places of decimal precision to return
+ */
+ public function getGoodnessOfFitPercent(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->goodnessOfFit * 100, $dp);
+ }
+
+ return $this->goodnessOfFit * 100;
+ }
+
+ /**
+ * Return the standard deviation of the residuals for this regression.
+ *
+ * @param int $dp Number of places of decimal precision to return
+ */
+ public function getStdevOfResiduals(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->stdevOfResiduals, $dp);
+ }
+
+ return $this->stdevOfResiduals;
+ }
+
+ /**
+ * @param int $dp Number of places of decimal precision to return
+ */
+ public function getSSRegression(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->SSRegression, $dp);
+ }
+
+ return $this->SSRegression;
+ }
+
+ /**
+ * @param int $dp Number of places of decimal precision to return
+ */
+ public function getSSResiduals(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->SSResiduals, $dp);
+ }
+
+ return $this->SSResiduals;
+ }
+
+ /**
+ * @param int $dp Number of places of decimal precision to return
+ */
+ public function getDFResiduals(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->DFResiduals, $dp);
+ }
+
+ return $this->DFResiduals;
+ }
+
+ /**
+ * @param int $dp Number of places of decimal precision to return
+ */
+ public function getF(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->f, $dp);
+ }
+
+ return $this->f;
+ }
+
+ /**
+ * @param int $dp Number of places of decimal precision to return
+ */
+ public function getCovariance(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->covariance, $dp);
+ }
+
+ return $this->covariance;
+ }
+
+ /**
+ * @param int $dp Number of places of decimal precision to return
+ */
+ public function getCorrelation(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round($this->correlation, $dp);
+ }
+
+ return $this->correlation;
+ }
+
+ /**
+ * @return float[]
+ */
+ public function getYBestFitValues(): array
+ {
+ return $this->yBestFitValues;
+ }
+
+ protected function calculateGoodnessOfFit(float $sumX, float $sumY, float $sumX2, float $sumY2, float $sumXY, float $meanX, float $meanY, bool|int $const): void
+ {
+ $SSres = $SScov = $SStot = $SSsex = 0.0;
+ foreach ($this->xValues as $xKey => $xValue) {
+ $bestFitY = $this->yBestFitValues[$xKey] = $this->getValueOfYForX($xValue);
+
+ $SSres += ($this->yValues[$xKey] - $bestFitY) * ($this->yValues[$xKey] - $bestFitY);
+ if ($const === true) {
+ $SStot += ($this->yValues[$xKey] - $meanY) * ($this->yValues[$xKey] - $meanY);
+ } else {
+ $SStot += $this->yValues[$xKey] * $this->yValues[$xKey];
+ }
+ $SScov += ($this->xValues[$xKey] - $meanX) * ($this->yValues[$xKey] - $meanY);
+ if ($const === true) {
+ $SSsex += ($this->xValues[$xKey] - $meanX) * ($this->xValues[$xKey] - $meanX);
+ } else {
+ $SSsex += $this->xValues[$xKey] * $this->xValues[$xKey];
+ }
+ }
+
+ $this->SSResiduals = $SSres;
+ $this->DFResiduals = $this->valueCount - 1 - ($const === true ? 1 : 0);
+
+ if ($this->DFResiduals == 0.0) {
+ $this->stdevOfResiduals = 0.0;
+ } else {
+ $this->stdevOfResiduals = sqrt($SSres / $this->DFResiduals);
+ }
+
+ if ($SStot == 0.0 || $SSres == $SStot) {
+ $this->goodnessOfFit = 1;
+ } else {
+ $this->goodnessOfFit = 1 - ($SSres / $SStot);
+ }
+
+ $this->SSRegression = $this->goodnessOfFit * $SStot;
+ $this->covariance = $SScov / $this->valueCount;
+ $this->correlation = ($this->valueCount * $sumXY - $sumX * $sumY) / sqrt(($this->valueCount * $sumX2 - $sumX ** 2) * ($this->valueCount * $sumY2 - $sumY ** 2));
+ $this->slopeSE = $this->stdevOfResiduals / sqrt($SSsex);
+ $this->intersectSE = $this->stdevOfResiduals * sqrt(1 / ($this->valueCount - ($sumX * $sumX) / $sumX2));
+ if ($this->SSResiduals != 0.0) {
+ if ($this->DFResiduals == 0.0) {
+ $this->f = 0.0;
+ } else {
+ $this->f = $this->SSRegression / ($this->SSResiduals / $this->DFResiduals);
+ }
+ } else {
+ if ($this->DFResiduals == 0.0) {
+ $this->f = 0.0;
+ } else {
+ $this->f = $this->SSRegression / $this->DFResiduals;
+ }
+ }
+ }
+
+ /** @return float|int */
+ private function sumSquares(array $values)
+ {
+ return array_sum(
+ array_map(
+ fn ($value): float|int => $value ** 2,
+ $values
+ )
+ );
+ }
+
+ /**
+ * @param float[] $yValues
+ * @param float[] $xValues
+ */
+ protected function leastSquareFit(array $yValues, array $xValues, bool $const): void
+ {
+ // calculate sums
+ $sumValuesX = array_sum($xValues);
+ $sumValuesY = array_sum($yValues);
+ $meanValueX = $sumValuesX / $this->valueCount;
+ $meanValueY = $sumValuesY / $this->valueCount;
+ $sumSquaresX = $this->sumSquares($xValues);
+ $sumSquaresY = $this->sumSquares($yValues);
+ $mBase = $mDivisor = 0.0;
+ $xy_sum = 0.0;
+ for ($i = 0; $i < $this->valueCount; ++$i) {
+ $xy_sum += $xValues[$i] * $yValues[$i];
+
+ if ($const === true) {
+ $mBase += ($xValues[$i] - $meanValueX) * ($yValues[$i] - $meanValueY);
+ $mDivisor += ($xValues[$i] - $meanValueX) * ($xValues[$i] - $meanValueX);
+ } else {
+ $mBase += $xValues[$i] * $yValues[$i];
+ $mDivisor += $xValues[$i] * $xValues[$i];
+ }
+ }
+
+ // calculate slope
+ $this->slope = $mBase / $mDivisor;
+
+ // calculate intersect
+ $this->intersect = ($const === true) ? $meanValueY - ($this->slope * $meanValueX) : 0.0;
+
+ $this->calculateGoodnessOfFit($sumValuesX, $sumValuesY, $sumSquaresX, $sumSquaresY, $xy_sum, $meanValueX, $meanValueY, $const);
+ }
+
+ /**
+ * Define the regression.
+ *
+ * @param float[] $yValues The set of Y-values for this regression
+ * @param float[] $xValues The set of X-values for this regression
+ */
+ public function __construct(array $yValues, array $xValues = [])
+ {
+ // Calculate number of points
+ $yValueCount = count($yValues);
+ $xValueCount = count($xValues);
+
+ // Define X Values if necessary
+ if ($xValueCount === 0) {
+ $xValues = range(1, $yValueCount);
+ } elseif ($yValueCount !== $xValueCount) {
+ // Ensure both arrays of points are the same size
+ $this->error = true;
+ }
+
+ $this->valueCount = $yValueCount;
+ $this->xValues = $xValues;
+ $this->yValues = $yValues;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/ExponentialBestFit.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/ExponentialBestFit.php
new file mode 100644
index 00000000..ed2d8896
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/ExponentialBestFit.php
@@ -0,0 +1,108 @@
+getIntersect() * $this->getSlope() ** ($xValue - $this->xOffset);
+ }
+
+ /**
+ * Return the X-Value for a specified value of Y.
+ *
+ * @param float $yValue Y-Value
+ *
+ * @return float X-Value
+ */
+ public function getValueOfXForY(float $yValue): float
+ {
+ return log(($yValue + $this->yOffset) / $this->getIntersect()) / log($this->getSlope());
+ }
+
+ /**
+ * Return the Equation of the best-fit line.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getEquation(int $dp = 0): string
+ {
+ $slope = $this->getSlope($dp);
+ $intersect = $this->getIntersect($dp);
+
+ return 'Y = ' . $intersect . ' * ' . $slope . '^X';
+ }
+
+ /**
+ * Return the Slope of the line.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getSlope(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round(exp($this->slope), $dp);
+ }
+
+ return exp($this->slope);
+ }
+
+ /**
+ * Return the Value of X where it intersects Y = 0.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getIntersect(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round(exp($this->intersect), $dp);
+ }
+
+ return exp($this->intersect);
+ }
+
+ /**
+ * Execute the regression and calculate the goodness of fit for a set of X and Y data values.
+ *
+ * @param float[] $yValues The set of Y-values for this regression
+ * @param float[] $xValues The set of X-values for this regression
+ */
+ private function exponentialRegression(array $yValues, array $xValues, bool $const): void
+ {
+ $adjustedYValues = array_map(
+ fn ($value): float => ($value < 0.0) ? 0 - log(abs($value)) : log($value),
+ $yValues
+ );
+
+ $this->leastSquareFit($adjustedYValues, $xValues, $const);
+ }
+
+ /**
+ * Define the regression and calculate the goodness of fit for a set of X and Y data values.
+ *
+ * @param float[] $yValues The set of Y-values for this regression
+ * @param float[] $xValues The set of X-values for this regression
+ */
+ public function __construct(array $yValues, array $xValues = [], bool $const = true)
+ {
+ parent::__construct($yValues, $xValues);
+
+ if (!$this->error) {
+ $this->exponentialRegression($yValues, $xValues, (bool) $const);
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/LinearBestFit.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/LinearBestFit.php
new file mode 100644
index 00000000..8a540800
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/LinearBestFit.php
@@ -0,0 +1,75 @@
+getIntersect() + $this->getSlope() * $xValue;
+ }
+
+ /**
+ * Return the X-Value for a specified value of Y.
+ *
+ * @param float $yValue Y-Value
+ *
+ * @return float X-Value
+ */
+ public function getValueOfXForY(float $yValue): float
+ {
+ return ($yValue - $this->getIntersect()) / $this->getSlope();
+ }
+
+ /**
+ * Return the Equation of the best-fit line.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getEquation(int $dp = 0): string
+ {
+ $slope = $this->getSlope($dp);
+ $intersect = $this->getIntersect($dp);
+
+ return 'Y = ' . $intersect . ' + ' . $slope . ' * X';
+ }
+
+ /**
+ * Execute the regression and calculate the goodness of fit for a set of X and Y data values.
+ *
+ * @param float[] $yValues The set of Y-values for this regression
+ * @param float[] $xValues The set of X-values for this regression
+ */
+ private function linearRegression(array $yValues, array $xValues, bool $const): void
+ {
+ $this->leastSquareFit($yValues, $xValues, $const);
+ }
+
+ /**
+ * Define the regression and calculate the goodness of fit for a set of X and Y data values.
+ *
+ * @param float[] $yValues The set of Y-values for this regression
+ * @param float[] $xValues The set of X-values for this regression
+ */
+ public function __construct(array $yValues, array $xValues = [], bool $const = true)
+ {
+ parent::__construct($yValues, $xValues);
+
+ if (!$this->error) {
+ $this->linearRegression($yValues, $xValues, (bool) $const);
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/LogarithmicBestFit.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/LogarithmicBestFit.php
new file mode 100644
index 00000000..3dec61b2
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/LogarithmicBestFit.php
@@ -0,0 +1,80 @@
+getIntersect() + $this->getSlope() * log($xValue - $this->xOffset);
+ }
+
+ /**
+ * Return the X-Value for a specified value of Y.
+ *
+ * @param float $yValue Y-Value
+ *
+ * @return float X-Value
+ */
+ public function getValueOfXForY(float $yValue): float
+ {
+ return exp(($yValue - $this->getIntersect()) / $this->getSlope());
+ }
+
+ /**
+ * Return the Equation of the best-fit line.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getEquation(int $dp = 0): string
+ {
+ $slope = $this->getSlope($dp);
+ $intersect = $this->getIntersect($dp);
+
+ return 'Y = ' . $slope . ' * log(' . $intersect . ' * X)';
+ }
+
+ /**
+ * Execute the regression and calculate the goodness of fit for a set of X and Y data values.
+ *
+ * @param float[] $yValues The set of Y-values for this regression
+ * @param float[] $xValues The set of X-values for this regression
+ */
+ private function logarithmicRegression(array $yValues, array $xValues, bool $const): void
+ {
+ $adjustedYValues = array_map(
+ fn ($value): float => ($value < 0.0) ? 0 - log(abs($value)) : log($value),
+ $yValues
+ );
+
+ $this->leastSquareFit($adjustedYValues, $xValues, $const);
+ }
+
+ /**
+ * Define the regression and calculate the goodness of fit for a set of X and Y data values.
+ *
+ * @param float[] $yValues The set of Y-values for this regression
+ * @param float[] $xValues The set of X-values for this regression
+ */
+ public function __construct(array $yValues, array $xValues = [], bool $const = true)
+ {
+ parent::__construct($yValues, $xValues);
+
+ if (!$this->error) {
+ $this->logarithmicRegression($yValues, $xValues, (bool) $const);
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/PolynomialBestFit.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/PolynomialBestFit.php
new file mode 100644
index 00000000..911a9c34
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/PolynomialBestFit.php
@@ -0,0 +1,205 @@
+slope is specified where an array is expected in several places.
+// But it seems that it should always be float.
+// This code is probably not exercised at all in unit tests.
+class PolynomialBestFit extends BestFit
+{
+ /**
+ * Algorithm type to use for best-fit
+ * (Name of this Trend class).
+ */
+ protected string $bestFitType = 'polynomial';
+
+ /**
+ * Polynomial order.
+ */
+ protected int $order = 0;
+
+ /**
+ * Return the order of this polynomial.
+ */
+ public function getOrder(): int
+ {
+ return $this->order;
+ }
+
+ /**
+ * Return the Y-Value for a specified value of X.
+ *
+ * @param float $xValue X-Value
+ *
+ * @return float Y-Value
+ */
+ public function getValueOfYForX(float $xValue): float
+ {
+ $retVal = $this->getIntersect();
+ $slope = $this->getSlope();
+ // Phpstan and Scrutinizer are both correct - getSlope returns float, not array.
+ // @phpstan-ignore-next-line
+ foreach ($slope as $key => $value) {
+ if ($value != 0.0) {
+ $retVal += $value * $xValue ** ($key + 1);
+ }
+ }
+
+ return $retVal;
+ }
+
+ /**
+ * Return the X-Value for a specified value of Y.
+ *
+ * @param float $yValue Y-Value
+ *
+ * @return float X-Value
+ */
+ public function getValueOfXForY(float $yValue): float
+ {
+ return ($yValue - $this->getIntersect()) / $this->getSlope();
+ }
+
+ /**
+ * Return the Equation of the best-fit line.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getEquation(int $dp = 0): string
+ {
+ $slope = $this->getSlope($dp);
+ $intersect = $this->getIntersect($dp);
+
+ $equation = 'Y = ' . $intersect;
+ // Phpstan and Scrutinizer are both correct - getSlope returns float, not array.
+ // @phpstan-ignore-next-line
+ foreach ($slope as $key => $value) {
+ if ($value != 0.0) {
+ $equation .= ' + ' . $value . ' * X';
+ if ($key > 0) {
+ $equation .= '^' . ($key + 1);
+ }
+ }
+ }
+
+ return $equation;
+ }
+
+ /**
+ * Return the Slope of the line.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getSlope(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ $coefficients = [];
+ //* @phpstan-ignore-next-line
+ foreach ($this->slope as $coefficient) {
+ $coefficients[] = round($coefficient, $dp);
+ }
+
+ // @phpstan-ignore-next-line
+ return $coefficients;
+ }
+
+ return $this->slope;
+ }
+
+ public function getCoefficients(int $dp = 0): array
+ {
+ // Phpstan and Scrutinizer are both correct - getSlope returns float, not array.
+ // @phpstan-ignore-next-line
+ return array_merge([$this->getIntersect($dp)], $this->getSlope($dp));
+ }
+
+ /**
+ * Execute the regression and calculate the goodness of fit for a set of X and Y data values.
+ *
+ * @param int $order Order of Polynomial for this regression
+ * @param float[] $yValues The set of Y-values for this regression
+ * @param float[] $xValues The set of X-values for this regression
+ */
+ private function polynomialRegression(int $order, array $yValues, array $xValues): void
+ {
+ // calculate sums
+ $x_sum = array_sum($xValues);
+ $y_sum = array_sum($yValues);
+ $xx_sum = $xy_sum = $yy_sum = 0;
+ for ($i = 0; $i < $this->valueCount; ++$i) {
+ $xy_sum += $xValues[$i] * $yValues[$i];
+ $xx_sum += $xValues[$i] * $xValues[$i];
+ $yy_sum += $yValues[$i] * $yValues[$i];
+ }
+ /*
+ * This routine uses logic from the PHP port of polyfit version 0.1
+ * written by Michael Bommarito and Paul Meagher
+ *
+ * The function fits a polynomial function of order $order through
+ * a series of x-y data points using least squares.
+ *
+ */
+ $A = [];
+ $B = [];
+ for ($i = 0; $i < $this->valueCount; ++$i) {
+ for ($j = 0; $j <= $order; ++$j) {
+ $A[$i][$j] = $xValues[$i] ** $j;
+ }
+ }
+ for ($i = 0; $i < $this->valueCount; ++$i) {
+ $B[$i] = [$yValues[$i]];
+ }
+ $matrixA = new Matrix($A);
+ $matrixB = new Matrix($B);
+ $C = $matrixA->solve($matrixB);
+
+ $coefficients = [];
+ for ($i = 0; $i < $C->rows; ++$i) {
+ $r = $C->getValue($i + 1, 1); // row and column are origin-1
+ if (!is_numeric($r) || abs($r) <= 10 ** (-9)) {
+ $r = 0;
+ } else {
+ $r += 0;
+ }
+ $coefficients[] = $r;
+ }
+
+ $this->intersect = (float) array_shift($coefficients);
+ // Phpstan is correct
+ //* @phpstan-ignore-next-line
+ $this->slope = $coefficients;
+
+ $this->calculateGoodnessOfFit($x_sum, $y_sum, $xx_sum, $yy_sum, $xy_sum, 0, 0, 0);
+ foreach ($this->xValues as $xKey => $xValue) {
+ $this->yBestFitValues[$xKey] = $this->getValueOfYForX($xValue);
+ }
+ }
+
+ /**
+ * Define the regression and calculate the goodness of fit for a set of X and Y data values.
+ *
+ * @param int $order Order of Polynomial for this regression
+ * @param float[] $yValues The set of Y-values for this regression
+ * @param float[] $xValues The set of X-values for this regression
+ */
+ public function __construct(int $order, array $yValues, array $xValues = [])
+ {
+ parent::__construct($yValues, $xValues);
+
+ if (!$this->error) {
+ if ($order < $this->valueCount) {
+ $this->bestFitType .= '_' . $order;
+ $this->order = $order;
+ $this->polynomialRegression($order, $yValues, $xValues);
+ if (($this->getGoodnessOfFit() < 0.0) || ($this->getGoodnessOfFit() > 1.0)) {
+ $this->error = true;
+ }
+ } else {
+ $this->error = true;
+ }
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/PowerBestFit.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/PowerBestFit.php
new file mode 100644
index 00000000..56b5a12b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/PowerBestFit.php
@@ -0,0 +1,98 @@
+getIntersect() * ($xValue - $this->xOffset) ** $this->getSlope();
+ }
+
+ /**
+ * Return the X-Value for a specified value of Y.
+ *
+ * @param float $yValue Y-Value
+ *
+ * @return float X-Value
+ */
+ public function getValueOfXForY(float $yValue): float
+ {
+ return (($yValue + $this->yOffset) / $this->getIntersect()) ** (1 / $this->getSlope());
+ }
+
+ /**
+ * Return the Equation of the best-fit line.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getEquation(int $dp = 0): string
+ {
+ $slope = $this->getSlope($dp);
+ $intersect = $this->getIntersect($dp);
+
+ return 'Y = ' . $intersect . ' * X^' . $slope;
+ }
+
+ /**
+ * Return the Value of X where it intersects Y = 0.
+ *
+ * @param int $dp Number of places of decimal precision to display
+ */
+ public function getIntersect(int $dp = 0): float
+ {
+ if ($dp != 0) {
+ return round(exp($this->intersect), $dp);
+ }
+
+ return exp($this->intersect);
+ }
+
+ /**
+ * Execute the regression and calculate the goodness of fit for a set of X and Y data values.
+ *
+ * @param float[] $yValues The set of Y-values for this regression
+ * @param float[] $xValues The set of X-values for this regression
+ */
+ private function powerRegression(array $yValues, array $xValues, bool $const): void
+ {
+ $adjustedYValues = array_map(
+ fn ($value): float => ($value < 0.0) ? 0 - log(abs($value)) : log($value),
+ $yValues
+ );
+ $adjustedXValues = array_map(
+ fn ($value): float => ($value < 0.0) ? 0 - log(abs($value)) : log($value),
+ $xValues
+ );
+
+ $this->leastSquareFit($adjustedYValues, $adjustedXValues, $const);
+ }
+
+ /**
+ * Define the regression and calculate the goodness of fit for a set of X and Y data values.
+ *
+ * @param float[] $yValues The set of Y-values for this regression
+ * @param float[] $xValues The set of X-values for this regression
+ */
+ public function __construct(array $yValues, array $xValues = [], bool $const = true)
+ {
+ parent::__construct($yValues, $xValues);
+
+ if (!$this->error) {
+ $this->powerRegression($yValues, $xValues, (bool) $const);
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/Trend.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/Trend.php
new file mode 100644
index 00000000..dc879430
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Trend/Trend.php
@@ -0,0 +1,122 @@
+getGoodnessOfFit();
+ }
+ if ($trendType != self::TREND_BEST_FIT_NO_POLY) {
+ foreach (self::$trendTypePolynomialOrders as $trendMethod) {
+ $order = (int) substr($trendMethod, -1);
+ $bestFit[$trendMethod] = new PolynomialBestFit($order, $yValues, $xValues);
+ if ($bestFit[$trendMethod]->getError()) {
+ unset($bestFit[$trendMethod]);
+ } else {
+ $bestFitValue[$trendMethod] = $bestFit[$trendMethod]->getGoodnessOfFit();
+ }
+ }
+ }
+ // Determine which of our Trend lines is the best fit, and then we return the instance of that Trend class
+ arsort($bestFitValue);
+ $bestFitType = key($bestFitValue);
+
+ return $bestFit[$bestFitType];
+ default:
+ return false;
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/XMLWriter.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/XMLWriter.php
new file mode 100644
index 00000000..2703e98e
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/XMLWriter.php
@@ -0,0 +1,96 @@
+openMemory();
+ } else {
+ // Create temporary filename
+ if ($temporaryStorageFolder === null) {
+ $temporaryStorageFolder = File::sysGetTempDir();
+ }
+ $this->tempFileName = (string) @tempnam($temporaryStorageFolder, 'xml');
+
+ // Open storage
+ if (empty($this->tempFileName) || $this->openUri($this->tempFileName) === false) {
+ // Fallback to memory...
+ $this->openMemory();
+ }
+ }
+
+ // Set default values
+ if (self::$debugEnabled) {
+ $this->setIndent(true);
+ }
+ }
+
+ /**
+ * Destructor.
+ */
+ public function __destruct()
+ {
+ // Unlink temporary files
+ // There is nothing reasonable to do if unlink fails.
+ if ($this->tempFileName != '') {
+ @unlink($this->tempFileName);
+ }
+ }
+
+ public function __wakeup(): void
+ {
+ $this->tempFileName = '';
+
+ throw new SpreadsheetException('Unserialize not permitted');
+ }
+
+ /**
+ * Get written data.
+ */
+ public function getData(): string
+ {
+ if ($this->tempFileName == '') {
+ return $this->outputMemory(true);
+ }
+ $this->flush();
+
+ return file_get_contents($this->tempFileName) ?: '';
+ }
+
+ /**
+ * Wrapper method for writeRaw.
+ *
+ * @param null|string|string[] $rawTextData
+ */
+ public function writeRawData($rawTextData): bool
+ {
+ if (is_array($rawTextData)) {
+ $rawTextData = implode("\n", $rawTextData);
+ }
+
+ return $this->writeRaw(htmlspecialchars($rawTextData ?? ''));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Xls.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Xls.php
new file mode 100644
index 00000000..cdb1bf24
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/Xls.php
@@ -0,0 +1,273 @@
+getParentOrThrow()->getDefaultStyle()->getFont();
+
+ $columnDimensions = $worksheet->getColumnDimensions();
+
+ // first find the true column width in pixels (uncollapsed and unhidden)
+ if (isset($columnDimensions[$col]) && $columnDimensions[$col]->getWidth() != -1) {
+ // then we have column dimension with explicit width
+ $columnDimension = $columnDimensions[$col];
+ $width = $columnDimension->getWidth();
+ $pixelWidth = Drawing::cellDimensionToPixels($width, $font);
+ } elseif ($worksheet->getDefaultColumnDimension()->getWidth() != -1) {
+ // then we have default column dimension with explicit width
+ $defaultColumnDimension = $worksheet->getDefaultColumnDimension();
+ $width = $defaultColumnDimension->getWidth();
+ $pixelWidth = Drawing::cellDimensionToPixels($width, $font);
+ } else {
+ // we don't even have any default column dimension. Width depends on default font
+ $pixelWidth = Font::getDefaultColumnWidthByFont($font, true);
+ }
+
+ // now find the effective column width in pixels
+ if (isset($columnDimensions[$col]) && !$columnDimensions[$col]->getVisible()) {
+ $effectivePixelWidth = 0;
+ } else {
+ $effectivePixelWidth = $pixelWidth;
+ }
+
+ return $effectivePixelWidth;
+ }
+
+ /**
+ * Convert the height of a cell from user's units to pixels. By interpolation
+ * the relationship is: y = 4/3x. If the height hasn't been set by the user we
+ * use the default value. If the row is hidden we use a value of zero.
+ *
+ * @param Worksheet $worksheet The sheet
+ * @param int $row The row index (1-based)
+ *
+ * @return int The width in pixels
+ */
+ public static function sizeRow(Worksheet $worksheet, int $row = 1): int
+ {
+ // default font of the workbook
+ $font = $worksheet->getParentOrThrow()->getDefaultStyle()->getFont();
+
+ $rowDimensions = $worksheet->getRowDimensions();
+
+ // first find the true row height in pixels (uncollapsed and unhidden)
+ if (isset($rowDimensions[$row]) && $rowDimensions[$row]->getRowHeight() != -1) {
+ // then we have a row dimension
+ $rowDimension = $rowDimensions[$row];
+ $rowHeight = $rowDimension->getRowHeight();
+ $pixelRowHeight = (int) ceil(4 * $rowHeight / 3); // here we assume Arial 10
+ } elseif ($worksheet->getDefaultRowDimension()->getRowHeight() != -1) {
+ // then we have a default row dimension with explicit height
+ $defaultRowDimension = $worksheet->getDefaultRowDimension();
+ $pixelRowHeight = $defaultRowDimension->getRowHeight(Dimension::UOM_PIXELS);
+ } else {
+ // we don't even have any default row dimension. Height depends on default font
+ $pointRowHeight = Font::getDefaultRowHeightByFont($font);
+ $pixelRowHeight = Font::fontSizeToPixels((int) $pointRowHeight);
+ }
+
+ // now find the effective row height in pixels
+ if (isset($rowDimensions[$row]) && !$rowDimensions[$row]->getVisible()) {
+ $effectivePixelRowHeight = 0;
+ } else {
+ $effectivePixelRowHeight = $pixelRowHeight;
+ }
+
+ return (int) $effectivePixelRowHeight;
+ }
+
+ /**
+ * Get the horizontal distance in pixels between two anchors
+ * The distanceX is found as sum of all the spanning columns widths minus correction for the two offsets.
+ *
+ * @param float|int $startOffsetX Offset within start cell measured in 1/1024 of the cell width
+ * @param float|int $endOffsetX Offset within end cell measured in 1/1024 of the cell width
+ *
+ * @return int Horizontal measured in pixels
+ */
+ public static function getDistanceX(Worksheet $worksheet, string $startColumn = 'A', float|int $startOffsetX = 0, string $endColumn = 'A', float|int $endOffsetX = 0): int
+ {
+ $distanceX = 0;
+
+ // add the widths of the spanning columns
+ $startColumnIndex = Coordinate::columnIndexFromString($startColumn);
+ $endColumnIndex = Coordinate::columnIndexFromString($endColumn);
+ for ($i = $startColumnIndex; $i <= $endColumnIndex; ++$i) {
+ $distanceX += self::sizeCol($worksheet, Coordinate::stringFromColumnIndex($i));
+ }
+
+ // correct for offsetX in startcell
+ $distanceX -= (int) floor(self::sizeCol($worksheet, $startColumn) * $startOffsetX / 1024);
+
+ // correct for offsetX in endcell
+ $distanceX -= (int) floor(self::sizeCol($worksheet, $endColumn) * (1 - $endOffsetX / 1024));
+
+ return $distanceX;
+ }
+
+ /**
+ * Get the vertical distance in pixels between two anchors
+ * The distanceY is found as sum of all the spanning rows minus two offsets.
+ *
+ * @param int $startRow (1-based)
+ * @param float|int $startOffsetY Offset within start cell measured in 1/256 of the cell height
+ * @param int $endRow (1-based)
+ * @param float|int $endOffsetY Offset within end cell measured in 1/256 of the cell height
+ *
+ * @return int Vertical distance measured in pixels
+ */
+ public static function getDistanceY(Worksheet $worksheet, int $startRow = 1, float|int $startOffsetY = 0, int $endRow = 1, float|int $endOffsetY = 0): int
+ {
+ $distanceY = 0;
+
+ // add the widths of the spanning rows
+ for ($row = $startRow; $row <= $endRow; ++$row) {
+ $distanceY += self::sizeRow($worksheet, $row);
+ }
+
+ // correct for offsetX in startcell
+ $distanceY -= (int) floor(self::sizeRow($worksheet, $startRow) * $startOffsetY / 256);
+
+ // correct for offsetX in endcell
+ $distanceY -= (int) floor(self::sizeRow($worksheet, $endRow) * (1 - $endOffsetY / 256));
+
+ return $distanceY;
+ }
+
+ /**
+ * Convert 1-cell anchor coordinates to 2-cell anchor coordinates
+ * This function is ported from PEAR Spreadsheet_Writer_Excel with small modifications.
+ *
+ * Calculate the vertices that define the position of the image as required by
+ * the OBJ record.
+ *
+ * +------------+------------+
+ * | A | B |
+ * +-----+------------+------------+
+ * | |(x1,y1) | |
+ * | 1 |(A1)._______|______ |
+ * | | | | |
+ * | | | | |
+ * +-----+----| BITMAP |-----+
+ * | | | | |
+ * | 2 | |______________. |
+ * | | | (B2)|
+ * | | | (x2,y2)|
+ * +---- +------------+------------+
+ *
+ * Example of a bitmap that covers some of the area from cell A1 to cell B2.
+ *
+ * Based on the width and height of the bitmap we need to calculate 8 vars:
+ * $col_start, $row_start, $col_end, $row_end, $x1, $y1, $x2, $y2.
+ * The width and height of the cells are also variable and have to be taken into
+ * account.
+ * The values of $col_start and $row_start are passed in from the calling
+ * function. The values of $col_end and $row_end are calculated by subtracting
+ * the width and height of the bitmap from the width and height of the
+ * underlying cells.
+ * The vertices are expressed as a percentage of the underlying cell width as
+ * follows (rhs values are in pixels):
+ *
+ * x1 = X / W *1024
+ * y1 = Y / H *256
+ * x2 = (X-1) / W *1024
+ * y2 = (Y-1) / H *256
+ *
+ * Where: X is distance from the left side of the underlying cell
+ * Y is distance from the top of the underlying cell
+ * W is the width of the cell
+ * H is the height of the cell
+ *
+ * @param string $coordinates E.g. 'A1'
+ * @param int $offsetX Horizontal offset in pixels
+ * @param int $offsetY Vertical offset in pixels
+ * @param int $width Width in pixels
+ * @param int $height Height in pixels
+ */
+ public static function oneAnchor2twoAnchor(Worksheet $worksheet, string $coordinates, int $offsetX, int $offsetY, int $width, int $height): ?array
+ {
+ [$col_start, $row] = Coordinate::indexesFromString($coordinates);
+ $row_start = $row - 1;
+
+ $x1 = $offsetX;
+ $y1 = $offsetY;
+
+ // Initialise end cell to the same as the start cell
+ $col_end = $col_start; // Col containing lower right corner of object
+ $row_end = $row_start; // Row containing bottom right corner of object
+
+ // Zero the specified offset if greater than the cell dimensions
+ if ($x1 >= self::sizeCol($worksheet, Coordinate::stringFromColumnIndex($col_start))) {
+ $x1 = 0;
+ }
+ if ($y1 >= self::sizeRow($worksheet, $row_start + 1)) {
+ $y1 = 0;
+ }
+
+ $width = $width + $x1 - 1;
+ $height = $height + $y1 - 1;
+
+ // Subtract the underlying cell widths to find the end cell of the image
+ while ($width >= self::sizeCol($worksheet, Coordinate::stringFromColumnIndex($col_end))) {
+ $width -= self::sizeCol($worksheet, Coordinate::stringFromColumnIndex($col_end));
+ ++$col_end;
+ }
+
+ // Subtract the underlying cell heights to find the end cell of the image
+ while ($height >= self::sizeRow($worksheet, $row_end + 1)) {
+ $height -= self::sizeRow($worksheet, $row_end + 1);
+ ++$row_end;
+ }
+
+ // Bitmap isn't allowed to start or finish in a hidden cell, i.e. a cell
+ // with zero height or width.
+ if (self::sizeCol($worksheet, Coordinate::stringFromColumnIndex($col_start)) == 0) {
+ return null;
+ }
+ if (self::sizeCol($worksheet, Coordinate::stringFromColumnIndex($col_end)) == 0) {
+ return null;
+ }
+ if (self::sizeRow($worksheet, $row_start + 1) == 0) {
+ return null;
+ }
+ if (self::sizeRow($worksheet, $row_end + 1) == 0) {
+ return null;
+ }
+
+ // Convert the pixel values to the percentage value expected by Excel
+ $x1 = $x1 / self::sizeCol($worksheet, Coordinate::stringFromColumnIndex($col_start)) * 1024;
+ $y1 = $y1 / self::sizeRow($worksheet, $row_start + 1) * 256;
+ $x2 = ($width + 1) / self::sizeCol($worksheet, Coordinate::stringFromColumnIndex($col_end)) * 1024; // Distance to right side of object
+ $y2 = ($height + 1) / self::sizeRow($worksheet, $row_end + 1) * 256; // Distance to bottom of object
+
+ $startCoordinates = Coordinate::stringFromColumnIndex($col_start) . ($row_start + 1);
+ $endCoordinates = Coordinate::stringFromColumnIndex($col_end) . ($row_end + 1);
+
+ return [
+ 'startCoordinates' => $startCoordinates,
+ 'startOffsetX' => $x1,
+ 'startOffsetY' => $y1,
+ 'endCoordinates' => $endCoordinates,
+ 'endOffsetX' => $x2,
+ 'endOffsetY' => $y2,
+ ];
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Spreadsheet.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Spreadsheet.php
new file mode 100644
index 00000000..dc228d28
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Spreadsheet.php
@@ -0,0 +1,1600 @@
+theme;
+ }
+
+ /**
+ * The workbook has macros ?
+ */
+ public function hasMacros(): bool
+ {
+ return $this->hasMacros;
+ }
+
+ /**
+ * Define if a workbook has macros.
+ *
+ * @param bool $hasMacros true|false
+ */
+ public function setHasMacros(bool $hasMacros): void
+ {
+ $this->hasMacros = (bool) $hasMacros;
+ }
+
+ /**
+ * Set the macros code.
+ *
+ * @param string $macroCode string|null
+ */
+ public function setMacrosCode(string $macroCode): void
+ {
+ $this->macrosCode = $macroCode;
+ $this->setHasMacros($macroCode !== null);
+ }
+
+ /**
+ * Return the macros code.
+ */
+ public function getMacrosCode(): ?string
+ {
+ return $this->macrosCode;
+ }
+
+ /**
+ * Set the macros certificate.
+ */
+ public function setMacrosCertificate(?string $certificate): void
+ {
+ $this->macrosCertificate = $certificate;
+ }
+
+ /**
+ * Is the project signed ?
+ *
+ * @return bool true|false
+ */
+ public function hasMacrosCertificate(): bool
+ {
+ return $this->macrosCertificate !== null;
+ }
+
+ /**
+ * Return the macros certificate.
+ */
+ public function getMacrosCertificate(): ?string
+ {
+ return $this->macrosCertificate;
+ }
+
+ /**
+ * Remove all macros, certificate from spreadsheet.
+ */
+ public function discardMacros(): void
+ {
+ $this->hasMacros = false;
+ $this->macrosCode = null;
+ $this->macrosCertificate = null;
+ }
+
+ /**
+ * set ribbon XML data.
+ */
+ public function setRibbonXMLData(mixed $target, mixed $xmlData): void
+ {
+ if (is_string($target) && is_string($xmlData)) {
+ $this->ribbonXMLData = ['target' => $target, 'data' => $xmlData];
+ } else {
+ $this->ribbonXMLData = null;
+ }
+ }
+
+ /**
+ * retrieve ribbon XML Data.
+ */
+ public function getRibbonXMLData(string $what = 'all'): null|array|string //we need some constants here...
+ {
+ $returnData = null;
+ $what = strtolower($what);
+ switch ($what) {
+ case 'all':
+ $returnData = $this->ribbonXMLData;
+
+ break;
+ case 'target':
+ case 'data':
+ if (is_array($this->ribbonXMLData)) {
+ $returnData = $this->ribbonXMLData[$what];
+ }
+
+ break;
+ }
+
+ return $returnData;
+ }
+
+ /**
+ * store binaries ribbon objects (pictures).
+ */
+ public function setRibbonBinObjects(mixed $binObjectsNames, mixed $binObjectsData): void
+ {
+ if ($binObjectsNames !== null && $binObjectsData !== null) {
+ $this->ribbonBinObjects = ['names' => $binObjectsNames, 'data' => $binObjectsData];
+ } else {
+ $this->ribbonBinObjects = null;
+ }
+ }
+
+ /**
+ * List of unparsed loaded data for export to same format with better compatibility.
+ * It has to be minimized when the library start to support currently unparsed data.
+ *
+ * @internal
+ */
+ public function getUnparsedLoadedData(): array
+ {
+ return $this->unparsedLoadedData;
+ }
+
+ /**
+ * List of unparsed loaded data for export to same format with better compatibility.
+ * It has to be minimized when the library start to support currently unparsed data.
+ *
+ * @internal
+ */
+ public function setUnparsedLoadedData(array $unparsedLoadedData): void
+ {
+ $this->unparsedLoadedData = $unparsedLoadedData;
+ }
+
+ /**
+ * retrieve Binaries Ribbon Objects.
+ */
+ public function getRibbonBinObjects(string $what = 'all'): ?array
+ {
+ $ReturnData = null;
+ $what = strtolower($what);
+ switch ($what) {
+ case 'all':
+ return $this->ribbonBinObjects;
+ case 'names':
+ case 'data':
+ if (is_array($this->ribbonBinObjects) && isset($this->ribbonBinObjects[$what])) {
+ $ReturnData = $this->ribbonBinObjects[$what];
+ }
+
+ break;
+ case 'types':
+ if (
+ is_array($this->ribbonBinObjects)
+ && isset($this->ribbonBinObjects['data']) && is_array($this->ribbonBinObjects['data'])
+ ) {
+ $tmpTypes = array_keys($this->ribbonBinObjects['data']);
+ $ReturnData = array_unique(array_map(fn (string $path): string => pathinfo($path, PATHINFO_EXTENSION), $tmpTypes));
+ } else {
+ $ReturnData = []; // the caller want an array... not null if empty
+ }
+
+ break;
+ }
+
+ return $ReturnData;
+ }
+
+ /**
+ * This workbook have a custom UI ?
+ */
+ public function hasRibbon(): bool
+ {
+ return $this->ribbonXMLData !== null;
+ }
+
+ /**
+ * This workbook have additionnal object for the ribbon ?
+ */
+ public function hasRibbonBinObjects(): bool
+ {
+ return $this->ribbonBinObjects !== null;
+ }
+
+ /**
+ * Check if a sheet with a specified code name already exists.
+ *
+ * @param string $codeName Name of the worksheet to check
+ */
+ public function sheetCodeNameExists(string $codeName): bool
+ {
+ return $this->getSheetByCodeName($codeName) !== null;
+ }
+
+ /**
+ * Get sheet by code name. Warning : sheet don't have always a code name !
+ *
+ * @param string $codeName Sheet name
+ */
+ public function getSheetByCodeName(string $codeName): ?Worksheet
+ {
+ $worksheetCount = count($this->workSheetCollection);
+ for ($i = 0; $i < $worksheetCount; ++$i) {
+ if ($this->workSheetCollection[$i]->getCodeName() == $codeName) {
+ return $this->workSheetCollection[$i];
+ }
+ }
+
+ return null;
+ }
+
+ /**
+ * Create a new PhpSpreadsheet with one Worksheet.
+ */
+ public function __construct()
+ {
+ $this->uniqueID = uniqid('', true);
+ $this->calculationEngine = new Calculation($this);
+ $this->theme = new Theme();
+
+ // Initialise worksheet collection and add one worksheet
+ $this->workSheetCollection = [];
+ $this->workSheetCollection[] = new Worksheet($this);
+ $this->activeSheetIndex = 0;
+
+ // Create document properties
+ $this->properties = new Properties();
+
+ // Create document security
+ $this->security = new Security();
+
+ // Set defined names
+ $this->definedNames = [];
+
+ // Create the cellXf supervisor
+ $this->cellXfSupervisor = new Style(true);
+ $this->cellXfSupervisor->bindParent($this);
+
+ // Create the default style
+ $this->addCellXf(new Style());
+ $this->addCellStyleXf(new Style());
+ }
+
+ /**
+ * Code to execute when this worksheet is unset().
+ */
+ public function __destruct()
+ {
+ $this->disconnectWorksheets();
+ $this->calculationEngine = null;
+ $this->cellXfCollection = [];
+ $this->cellStyleXfCollection = [];
+ $this->definedNames = [];
+ }
+
+ /**
+ * Disconnect all worksheets from this PhpSpreadsheet workbook object,
+ * typically so that the PhpSpreadsheet object can be unset.
+ */
+ public function disconnectWorksheets(): void
+ {
+ foreach ($this->workSheetCollection as $worksheet) {
+ $worksheet->disconnectCells();
+ unset($worksheet);
+ }
+ $this->workSheetCollection = [];
+ }
+
+ /**
+ * Return the calculation engine for this worksheet.
+ */
+ public function getCalculationEngine(): ?Calculation
+ {
+ return $this->calculationEngine;
+ }
+
+ /**
+ * Get properties.
+ */
+ public function getProperties(): Properties
+ {
+ return $this->properties;
+ }
+
+ /**
+ * Set properties.
+ */
+ public function setProperties(Properties $documentProperties): void
+ {
+ $this->properties = $documentProperties;
+ }
+
+ /**
+ * Get security.
+ */
+ public function getSecurity(): Security
+ {
+ return $this->security;
+ }
+
+ /**
+ * Set security.
+ */
+ public function setSecurity(Security $documentSecurity): void
+ {
+ $this->security = $documentSecurity;
+ }
+
+ /**
+ * Get active sheet.
+ */
+ public function getActiveSheet(): Worksheet
+ {
+ return $this->getSheet($this->activeSheetIndex);
+ }
+
+ /**
+ * Create sheet and add it to this workbook.
+ *
+ * @param null|int $sheetIndex Index where sheet should go (0,1,..., or null for last)
+ */
+ public function createSheet(?int $sheetIndex = null): Worksheet
+ {
+ $newSheet = new Worksheet($this);
+ $this->addSheet($newSheet, $sheetIndex, true);
+
+ return $newSheet;
+ }
+
+ /**
+ * Check if a sheet with a specified name already exists.
+ *
+ * @param string $worksheetName Name of the worksheet to check
+ */
+ public function sheetNameExists(string $worksheetName): bool
+ {
+ return $this->getSheetByName($worksheetName) !== null;
+ }
+
+ /**
+ * Add sheet.
+ *
+ * @param Worksheet $worksheet The worksheet to add
+ * @param null|int $sheetIndex Index where sheet should go (0,1,..., or null for last)
+ */
+ public function addSheet(Worksheet $worksheet, ?int $sheetIndex = null, bool $retitleIfNeeded = false): Worksheet
+ {
+ if ($retitleIfNeeded) {
+ $title = $worksheet->getTitle();
+ if ($this->sheetNameExists($title)) {
+ $i = 1;
+ $newTitle = "$title $i";
+ while ($this->sheetNameExists($newTitle)) {
+ ++$i;
+ $newTitle = "$title $i";
+ }
+ $worksheet->setTitle($newTitle);
+ }
+ }
+ if ($this->sheetNameExists($worksheet->getTitle())) {
+ throw new Exception(
+ "Workbook already contains a worksheet named '{$worksheet->getTitle()}'. Rename this worksheet first."
+ );
+ }
+
+ if ($sheetIndex === null) {
+ if ($this->activeSheetIndex < 0) {
+ $this->activeSheetIndex = 0;
+ }
+ $this->workSheetCollection[] = $worksheet;
+ } else {
+ // Insert the sheet at the requested index
+ array_splice(
+ $this->workSheetCollection,
+ $sheetIndex,
+ 0,
+ [$worksheet]
+ );
+
+ // Adjust active sheet index if necessary
+ if ($this->activeSheetIndex >= $sheetIndex) {
+ ++$this->activeSheetIndex;
+ }
+ if ($this->activeSheetIndex < 0) {
+ $this->activeSheetIndex = 0;
+ }
+ }
+
+ if ($worksheet->getParent() === null) {
+ $worksheet->rebindParent($this);
+ }
+
+ return $worksheet;
+ }
+
+ /**
+ * Remove sheet by index.
+ *
+ * @param int $sheetIndex Index position of the worksheet to remove
+ */
+ public function removeSheetByIndex(int $sheetIndex): void
+ {
+ $numSheets = count($this->workSheetCollection);
+ if ($sheetIndex > $numSheets - 1) {
+ throw new Exception(
+ "You tried to remove a sheet by the out of bounds index: {$sheetIndex}. The actual number of sheets is {$numSheets}."
+ );
+ }
+ array_splice($this->workSheetCollection, $sheetIndex, 1);
+
+ // Adjust active sheet index if necessary
+ if (
+ ($this->activeSheetIndex >= $sheetIndex)
+ && ($this->activeSheetIndex > 0 || $numSheets <= 1)
+ ) {
+ --$this->activeSheetIndex;
+ }
+ }
+
+ /**
+ * Get sheet by index.
+ *
+ * @param int $sheetIndex Sheet index
+ */
+ public function getSheet(int $sheetIndex): Worksheet
+ {
+ if (!isset($this->workSheetCollection[$sheetIndex])) {
+ $numSheets = $this->getSheetCount();
+
+ throw new Exception(
+ "Your requested sheet index: {$sheetIndex} is out of bounds. The actual number of sheets is {$numSheets}."
+ );
+ }
+
+ return $this->workSheetCollection[$sheetIndex];
+ }
+
+ /**
+ * Get all sheets.
+ *
+ * @return Worksheet[]
+ */
+ public function getAllSheets(): array
+ {
+ return $this->workSheetCollection;
+ }
+
+ /**
+ * Get sheet by name.
+ *
+ * @param string $worksheetName Sheet name
+ */
+ public function getSheetByName(string $worksheetName): ?Worksheet
+ {
+ $worksheetCount = count($this->workSheetCollection);
+ for ($i = 0; $i < $worksheetCount; ++$i) {
+ if (strcasecmp($this->workSheetCollection[$i]->getTitle(), trim($worksheetName, "'")) === 0) {
+ return $this->workSheetCollection[$i];
+ }
+ }
+
+ return null;
+ }
+
+ /**
+ * Get sheet by name, throwing exception if not found.
+ */
+ public function getSheetByNameOrThrow(string $worksheetName): Worksheet
+ {
+ $worksheet = $this->getSheetByName($worksheetName);
+ if ($worksheet === null) {
+ throw new Exception("Sheet $worksheetName does not exist.");
+ }
+
+ return $worksheet;
+ }
+
+ /**
+ * Get index for sheet.
+ *
+ * @return int index
+ */
+ public function getIndex(Worksheet $worksheet, bool $noThrow = false): int
+ {
+ $wsHash = $worksheet->getHashInt();
+ foreach ($this->workSheetCollection as $key => $value) {
+ if ($value->getHashInt() === $wsHash) {
+ return $key;
+ }
+ }
+ if ($noThrow) {
+ return -1;
+ }
+
+ throw new Exception('Sheet does not exist.');
+ }
+
+ /**
+ * Set index for sheet by sheet name.
+ *
+ * @param string $worksheetName Sheet name to modify index for
+ * @param int $newIndexPosition New index for the sheet
+ *
+ * @return int New sheet index
+ */
+ public function setIndexByName(string $worksheetName, int $newIndexPosition): int
+ {
+ $oldIndex = $this->getIndex($this->getSheetByNameOrThrow($worksheetName));
+ $worksheet = array_splice(
+ $this->workSheetCollection,
+ $oldIndex,
+ 1
+ );
+ array_splice(
+ $this->workSheetCollection,
+ $newIndexPosition,
+ 0,
+ $worksheet
+ );
+
+ return $newIndexPosition;
+ }
+
+ /**
+ * Get sheet count.
+ */
+ public function getSheetCount(): int
+ {
+ return count($this->workSheetCollection);
+ }
+
+ /**
+ * Get active sheet index.
+ *
+ * @return int Active sheet index
+ */
+ public function getActiveSheetIndex(): int
+ {
+ return $this->activeSheetIndex;
+ }
+
+ /**
+ * Set active sheet index.
+ *
+ * @param int $worksheetIndex Active sheet index
+ */
+ public function setActiveSheetIndex(int $worksheetIndex): Worksheet
+ {
+ $numSheets = count($this->workSheetCollection);
+
+ if ($worksheetIndex > $numSheets - 1) {
+ throw new Exception(
+ "You tried to set a sheet active by the out of bounds index: {$worksheetIndex}. The actual number of sheets is {$numSheets}."
+ );
+ }
+ $this->activeSheetIndex = $worksheetIndex;
+
+ return $this->getActiveSheet();
+ }
+
+ /**
+ * Set active sheet index by name.
+ *
+ * @param string $worksheetName Sheet title
+ */
+ public function setActiveSheetIndexByName(string $worksheetName): Worksheet
+ {
+ if (($worksheet = $this->getSheetByName($worksheetName)) instanceof Worksheet) {
+ $this->setActiveSheetIndex($this->getIndex($worksheet));
+
+ return $worksheet;
+ }
+
+ throw new Exception('Workbook does not contain sheet:' . $worksheetName);
+ }
+
+ /**
+ * Get sheet names.
+ *
+ * @return string[]
+ */
+ public function getSheetNames(): array
+ {
+ $returnValue = [];
+ $worksheetCount = $this->getSheetCount();
+ for ($i = 0; $i < $worksheetCount; ++$i) {
+ $returnValue[] = $this->getSheet($i)->getTitle();
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * Add external sheet.
+ *
+ * @param Worksheet $worksheet External sheet to add
+ * @param null|int $sheetIndex Index where sheet should go (0,1,..., or null for last)
+ */
+ public function addExternalSheet(Worksheet $worksheet, ?int $sheetIndex = null): Worksheet
+ {
+ if ($this->sheetNameExists($worksheet->getTitle())) {
+ throw new Exception("Workbook already contains a worksheet named '{$worksheet->getTitle()}'. Rename the external sheet first.");
+ }
+
+ // count how many cellXfs there are in this workbook currently, we will need this below
+ $countCellXfs = count($this->cellXfCollection);
+
+ // copy all the shared cellXfs from the external workbook and append them to the current
+ foreach ($worksheet->getParentOrThrow()->getCellXfCollection() as $cellXf) {
+ $this->addCellXf(clone $cellXf);
+ }
+
+ // move sheet to this workbook
+ $worksheet->rebindParent($this);
+
+ // update the cellXfs
+ foreach ($worksheet->getCoordinates(false) as $coordinate) {
+ $cell = $worksheet->getCell($coordinate);
+ $cell->setXfIndex($cell->getXfIndex() + $countCellXfs);
+ }
+
+ // update the column dimensions Xfs
+ foreach ($worksheet->getColumnDimensions() as $columnDimension) {
+ $columnDimension->setXfIndex($columnDimension->getXfIndex() + $countCellXfs);
+ }
+
+ // update the row dimensions Xfs
+ foreach ($worksheet->getRowDimensions() as $rowDimension) {
+ $xfIndex = $rowDimension->getXfIndex();
+ if ($xfIndex !== null) {
+ $rowDimension->setXfIndex($xfIndex + $countCellXfs);
+ }
+ }
+
+ return $this->addSheet($worksheet, $sheetIndex);
+ }
+
+ /**
+ * Get an array of all Named Ranges.
+ *
+ * @return DefinedName[]
+ */
+ public function getNamedRanges(): array
+ {
+ return array_filter(
+ $this->definedNames,
+ fn (DefinedName $definedName): bool => $definedName->isFormula() === self::DEFINED_NAME_IS_RANGE
+ );
+ }
+
+ /**
+ * Get an array of all Named Formulae.
+ *
+ * @return DefinedName[]
+ */
+ public function getNamedFormulae(): array
+ {
+ return array_filter(
+ $this->definedNames,
+ fn (DefinedName $definedName): bool => $definedName->isFormula() === self::DEFINED_NAME_IS_FORMULA
+ );
+ }
+
+ /**
+ * Get an array of all Defined Names (both named ranges and named formulae).
+ *
+ * @return DefinedName[]
+ */
+ public function getDefinedNames(): array
+ {
+ return $this->definedNames;
+ }
+
+ /**
+ * Add a named range.
+ * If a named range with this name already exists, then this will replace the existing value.
+ */
+ public function addNamedRange(NamedRange $namedRange): void
+ {
+ $this->addDefinedName($namedRange);
+ }
+
+ /**
+ * Add a named formula.
+ * If a named formula with this name already exists, then this will replace the existing value.
+ */
+ public function addNamedFormula(NamedFormula $namedFormula): void
+ {
+ $this->addDefinedName($namedFormula);
+ }
+
+ /**
+ * Add a defined name (either a named range or a named formula).
+ * If a defined named with this name already exists, then this will replace the existing value.
+ */
+ public function addDefinedName(DefinedName $definedName): void
+ {
+ $upperCaseName = StringHelper::strToUpper($definedName->getName());
+ if ($definedName->getScope() == null) {
+ // global scope
+ $this->definedNames[$upperCaseName] = $definedName;
+ } else {
+ // local scope
+ $this->definedNames[$definedName->getScope()->getTitle() . '!' . $upperCaseName] = $definedName;
+ }
+ }
+
+ /**
+ * Get named range.
+ *
+ * @param null|Worksheet $worksheet Scope. Use null for global scope
+ */
+ public function getNamedRange(string $namedRange, ?Worksheet $worksheet = null): ?NamedRange
+ {
+ $returnValue = null;
+
+ if ($namedRange !== '') {
+ $namedRange = StringHelper::strToUpper($namedRange);
+ // first look for global named range
+ $returnValue = $this->getGlobalDefinedNameByType($namedRange, self::DEFINED_NAME_IS_RANGE);
+ // then look for local named range (has priority over global named range if both names exist)
+ $returnValue = $this->getLocalDefinedNameByType($namedRange, self::DEFINED_NAME_IS_RANGE, $worksheet) ?: $returnValue;
+ }
+
+ return $returnValue instanceof NamedRange ? $returnValue : null;
+ }
+
+ /**
+ * Get named formula.
+ *
+ * @param null|Worksheet $worksheet Scope. Use null for global scope
+ */
+ public function getNamedFormula(string $namedFormula, ?Worksheet $worksheet = null): ?NamedFormula
+ {
+ $returnValue = null;
+
+ if ($namedFormula !== '') {
+ $namedFormula = StringHelper::strToUpper($namedFormula);
+ // first look for global named formula
+ $returnValue = $this->getGlobalDefinedNameByType($namedFormula, self::DEFINED_NAME_IS_FORMULA);
+ // then look for local named formula (has priority over global named formula if both names exist)
+ $returnValue = $this->getLocalDefinedNameByType($namedFormula, self::DEFINED_NAME_IS_FORMULA, $worksheet) ?: $returnValue;
+ }
+
+ return $returnValue instanceof NamedFormula ? $returnValue : null;
+ }
+
+ private function getGlobalDefinedNameByType(string $name, bool $type): ?DefinedName
+ {
+ if (isset($this->definedNames[$name]) && $this->definedNames[$name]->isFormula() === $type) {
+ return $this->definedNames[$name];
+ }
+
+ return null;
+ }
+
+ private function getLocalDefinedNameByType(string $name, bool $type, ?Worksheet $worksheet = null): ?DefinedName
+ {
+ if (
+ ($worksheet !== null) && isset($this->definedNames[$worksheet->getTitle() . '!' . $name])
+ && $this->definedNames[$worksheet->getTitle() . '!' . $name]->isFormula() === $type
+ ) {
+ return $this->definedNames[$worksheet->getTitle() . '!' . $name];
+ }
+
+ return null;
+ }
+
+ /**
+ * Get named range.
+ *
+ * @param null|Worksheet $worksheet Scope. Use null for global scope
+ */
+ public function getDefinedName(string $definedName, ?Worksheet $worksheet = null): ?DefinedName
+ {
+ $returnValue = null;
+
+ if ($definedName !== '') {
+ $definedName = StringHelper::strToUpper($definedName);
+ // first look for global defined name
+ if (isset($this->definedNames[$definedName])) {
+ $returnValue = $this->definedNames[$definedName];
+ }
+
+ // then look for local defined name (has priority over global defined name if both names exist)
+ if (($worksheet !== null) && isset($this->definedNames[$worksheet->getTitle() . '!' . $definedName])) {
+ $returnValue = $this->definedNames[$worksheet->getTitle() . '!' . $definedName];
+ }
+ }
+
+ return $returnValue;
+ }
+
+ /**
+ * Remove named range.
+ *
+ * @param null|Worksheet $worksheet scope: use null for global scope
+ *
+ * @return $this
+ */
+ public function removeNamedRange(string $namedRange, ?Worksheet $worksheet = null): self
+ {
+ if ($this->getNamedRange($namedRange, $worksheet) === null) {
+ return $this;
+ }
+
+ return $this->removeDefinedName($namedRange, $worksheet);
+ }
+
+ /**
+ * Remove named formula.
+ *
+ * @param null|Worksheet $worksheet scope: use null for global scope
+ *
+ * @return $this
+ */
+ public function removeNamedFormula(string $namedFormula, ?Worksheet $worksheet = null): self
+ {
+ if ($this->getNamedFormula($namedFormula, $worksheet) === null) {
+ return $this;
+ }
+
+ return $this->removeDefinedName($namedFormula, $worksheet);
+ }
+
+ /**
+ * Remove defined name.
+ *
+ * @param null|Worksheet $worksheet scope: use null for global scope
+ *
+ * @return $this
+ */
+ public function removeDefinedName(string $definedName, ?Worksheet $worksheet = null): self
+ {
+ $definedName = StringHelper::strToUpper($definedName);
+
+ if ($worksheet === null) {
+ if (isset($this->definedNames[$definedName])) {
+ unset($this->definedNames[$definedName]);
+ }
+ } else {
+ if (isset($this->definedNames[$worksheet->getTitle() . '!' . $definedName])) {
+ unset($this->definedNames[$worksheet->getTitle() . '!' . $definedName]);
+ } elseif (isset($this->definedNames[$definedName])) {
+ unset($this->definedNames[$definedName]);
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get worksheet iterator.
+ */
+ public function getWorksheetIterator(): Iterator
+ {
+ return new Iterator($this);
+ }
+
+ /**
+ * Copy workbook (!= clone!).
+ */
+ public function copy(): self
+ {
+ $filename = File::temporaryFilename();
+ $writer = new XlsxWriter($this);
+ $writer->setIncludeCharts(true);
+ $writer->save($filename);
+
+ $reader = new XlsxReader();
+ $reader->setIncludeCharts(true);
+ $reloadedSpreadsheet = $reader->load($filename);
+ unlink($filename);
+
+ return $reloadedSpreadsheet;
+ }
+
+ public function __clone()
+ {
+ throw new Exception(
+ 'Do not use clone on spreadsheet. Use spreadsheet->copy() instead.'
+ );
+ }
+
+ /**
+ * Get the workbook collection of cellXfs.
+ *
+ * @return Style[]
+ */
+ public function getCellXfCollection(): array
+ {
+ return $this->cellXfCollection;
+ }
+
+ /**
+ * Get cellXf by index.
+ */
+ public function getCellXfByIndex(int $cellStyleIndex): Style
+ {
+ return $this->cellXfCollection[$cellStyleIndex];
+ }
+
+ /**
+ * Get cellXf by hash code.
+ *
+ * @return false|Style
+ */
+ public function getCellXfByHashCode(string $hashcode): bool|Style
+ {
+ foreach ($this->cellXfCollection as $cellXf) {
+ if ($cellXf->getHashCode() === $hashcode) {
+ return $cellXf;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Check if style exists in style collection.
+ */
+ public function cellXfExists(Style $cellStyleIndex): bool
+ {
+ return in_array($cellStyleIndex, $this->cellXfCollection, true);
+ }
+
+ /**
+ * Get default style.
+ */
+ public function getDefaultStyle(): Style
+ {
+ if (isset($this->cellXfCollection[0])) {
+ return $this->cellXfCollection[0];
+ }
+
+ throw new Exception('No default style found for this workbook');
+ }
+
+ /**
+ * Add a cellXf to the workbook.
+ */
+ public function addCellXf(Style $style): void
+ {
+ $this->cellXfCollection[] = $style;
+ $style->setIndex(count($this->cellXfCollection) - 1);
+ }
+
+ /**
+ * Remove cellXf by index. It is ensured that all cells get their xf index updated.
+ *
+ * @param int $cellStyleIndex Index to cellXf
+ */
+ public function removeCellXfByIndex(int $cellStyleIndex): void
+ {
+ if ($cellStyleIndex > count($this->cellXfCollection) - 1) {
+ throw new Exception('CellXf index is out of bounds.');
+ }
+
+ // first remove the cellXf
+ array_splice($this->cellXfCollection, $cellStyleIndex, 1);
+
+ // then update cellXf indexes for cells
+ foreach ($this->workSheetCollection as $worksheet) {
+ foreach ($worksheet->getCoordinates(false) as $coordinate) {
+ $cell = $worksheet->getCell($coordinate);
+ $xfIndex = $cell->getXfIndex();
+ if ($xfIndex > $cellStyleIndex) {
+ // decrease xf index by 1
+ $cell->setXfIndex($xfIndex - 1);
+ } elseif ($xfIndex == $cellStyleIndex) {
+ // set to default xf index 0
+ $cell->setXfIndex(0);
+ }
+ }
+ }
+ }
+
+ /**
+ * Get the cellXf supervisor.
+ */
+ public function getCellXfSupervisor(): Style
+ {
+ return $this->cellXfSupervisor;
+ }
+
+ /**
+ * Get the workbook collection of cellStyleXfs.
+ *
+ * @return Style[]
+ */
+ public function getCellStyleXfCollection(): array
+ {
+ return $this->cellStyleXfCollection;
+ }
+
+ /**
+ * Get cellStyleXf by index.
+ *
+ * @param int $cellStyleIndex Index to cellXf
+ */
+ public function getCellStyleXfByIndex(int $cellStyleIndex): Style
+ {
+ return $this->cellStyleXfCollection[$cellStyleIndex];
+ }
+
+ /**
+ * Get cellStyleXf by hash code.
+ *
+ * @return false|Style
+ */
+ public function getCellStyleXfByHashCode(string $hashcode): bool|Style
+ {
+ foreach ($this->cellStyleXfCollection as $cellStyleXf) {
+ if ($cellStyleXf->getHashCode() === $hashcode) {
+ return $cellStyleXf;
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Add a cellStyleXf to the workbook.
+ */
+ public function addCellStyleXf(Style $style): void
+ {
+ $this->cellStyleXfCollection[] = $style;
+ $style->setIndex(count($this->cellStyleXfCollection) - 1);
+ }
+
+ /**
+ * Remove cellStyleXf by index.
+ *
+ * @param int $cellStyleIndex Index to cellXf
+ */
+ public function removeCellStyleXfByIndex(int $cellStyleIndex): void
+ {
+ if ($cellStyleIndex > count($this->cellStyleXfCollection) - 1) {
+ throw new Exception('CellStyleXf index is out of bounds.');
+ }
+ array_splice($this->cellStyleXfCollection, $cellStyleIndex, 1);
+ }
+
+ /**
+ * Eliminate all unneeded cellXf and afterwards update the xfIndex for all cells
+ * and columns in the workbook.
+ */
+ public function garbageCollect(): void
+ {
+ // how many references are there to each cellXf ?
+ $countReferencesCellXf = [];
+ foreach ($this->cellXfCollection as $index => $cellXf) {
+ $countReferencesCellXf[$index] = 0;
+ }
+
+ foreach ($this->getWorksheetIterator() as $sheet) {
+ // from cells
+ foreach ($sheet->getCoordinates(false) as $coordinate) {
+ $cell = $sheet->getCell($coordinate);
+ ++$countReferencesCellXf[$cell->getXfIndex()];
+ }
+
+ // from row dimensions
+ foreach ($sheet->getRowDimensions() as $rowDimension) {
+ if ($rowDimension->getXfIndex() !== null) {
+ ++$countReferencesCellXf[$rowDimension->getXfIndex()];
+ }
+ }
+
+ // from column dimensions
+ foreach ($sheet->getColumnDimensions() as $columnDimension) {
+ ++$countReferencesCellXf[$columnDimension->getXfIndex()];
+ }
+ }
+
+ // remove cellXfs without references and create mapping so we can update xfIndex
+ // for all cells and columns
+ $countNeededCellXfs = 0;
+ $map = [];
+ foreach ($this->cellXfCollection as $index => $cellXf) {
+ if ($countReferencesCellXf[$index] > 0 || $index == 0) { // we must never remove the first cellXf
+ ++$countNeededCellXfs;
+ } else {
+ unset($this->cellXfCollection[$index]);
+ }
+ $map[$index] = $countNeededCellXfs - 1;
+ }
+ $this->cellXfCollection = array_values($this->cellXfCollection);
+
+ // update the index for all cellXfs
+ foreach ($this->cellXfCollection as $i => $cellXf) {
+ $cellXf->setIndex($i);
+ }
+
+ // make sure there is always at least one cellXf (there should be)
+ if (empty($this->cellXfCollection)) {
+ $this->cellXfCollection[] = new Style();
+ }
+
+ // update the xfIndex for all cells, row dimensions, column dimensions
+ foreach ($this->getWorksheetIterator() as $sheet) {
+ // for all cells
+ foreach ($sheet->getCoordinates(false) as $coordinate) {
+ $cell = $sheet->getCell($coordinate);
+ $cell->setXfIndex($map[$cell->getXfIndex()]);
+ }
+
+ // for all row dimensions
+ foreach ($sheet->getRowDimensions() as $rowDimension) {
+ if ($rowDimension->getXfIndex() !== null) {
+ $rowDimension->setXfIndex($map[$rowDimension->getXfIndex()]);
+ }
+ }
+
+ // for all column dimensions
+ foreach ($sheet->getColumnDimensions() as $columnDimension) {
+ $columnDimension->setXfIndex($map[$columnDimension->getXfIndex()]);
+ }
+
+ // also do garbage collection for all the sheets
+ $sheet->garbageCollect();
+ }
+ }
+
+ /**
+ * Return the unique ID value assigned to this spreadsheet workbook.
+ */
+ public function getID(): string
+ {
+ return $this->uniqueID;
+ }
+
+ /**
+ * Get the visibility of the horizonal scroll bar in the application.
+ *
+ * @return bool True if horizonal scroll bar is visible
+ */
+ public function getShowHorizontalScroll(): bool
+ {
+ return $this->showHorizontalScroll;
+ }
+
+ /**
+ * Set the visibility of the horizonal scroll bar in the application.
+ *
+ * @param bool $showHorizontalScroll True if horizonal scroll bar is visible
+ */
+ public function setShowHorizontalScroll(bool $showHorizontalScroll): void
+ {
+ $this->showHorizontalScroll = (bool) $showHorizontalScroll;
+ }
+
+ /**
+ * Get the visibility of the vertical scroll bar in the application.
+ *
+ * @return bool True if vertical scroll bar is visible
+ */
+ public function getShowVerticalScroll(): bool
+ {
+ return $this->showVerticalScroll;
+ }
+
+ /**
+ * Set the visibility of the vertical scroll bar in the application.
+ *
+ * @param bool $showVerticalScroll True if vertical scroll bar is visible
+ */
+ public function setShowVerticalScroll(bool $showVerticalScroll): void
+ {
+ $this->showVerticalScroll = (bool) $showVerticalScroll;
+ }
+
+ /**
+ * Get the visibility of the sheet tabs in the application.
+ *
+ * @return bool True if the sheet tabs are visible
+ */
+ public function getShowSheetTabs(): bool
+ {
+ return $this->showSheetTabs;
+ }
+
+ /**
+ * Set the visibility of the sheet tabs in the application.
+ *
+ * @param bool $showSheetTabs True if sheet tabs are visible
+ */
+ public function setShowSheetTabs(bool $showSheetTabs): void
+ {
+ $this->showSheetTabs = (bool) $showSheetTabs;
+ }
+
+ /**
+ * Return whether the workbook window is minimized.
+ *
+ * @return bool true if workbook window is minimized
+ */
+ public function getMinimized(): bool
+ {
+ return $this->minimized;
+ }
+
+ /**
+ * Set whether the workbook window is minimized.
+ *
+ * @param bool $minimized true if workbook window is minimized
+ */
+ public function setMinimized(bool $minimized): void
+ {
+ $this->minimized = (bool) $minimized;
+ }
+
+ /**
+ * Return whether to group dates when presenting the user with
+ * filtering optiomd in the user interface.
+ *
+ * @return bool true if workbook window is minimized
+ */
+ public function getAutoFilterDateGrouping(): bool
+ {
+ return $this->autoFilterDateGrouping;
+ }
+
+ /**
+ * Set whether to group dates when presenting the user with
+ * filtering optiomd in the user interface.
+ *
+ * @param bool $autoFilterDateGrouping true if workbook window is minimized
+ */
+ public function setAutoFilterDateGrouping(bool $autoFilterDateGrouping): void
+ {
+ $this->autoFilterDateGrouping = (bool) $autoFilterDateGrouping;
+ }
+
+ /**
+ * Return the first sheet in the book view.
+ *
+ * @return int First sheet in book view
+ */
+ public function getFirstSheetIndex(): int
+ {
+ return $this->firstSheetIndex;
+ }
+
+ /**
+ * Set the first sheet in the book view.
+ *
+ * @param int $firstSheetIndex First sheet in book view
+ */
+ public function setFirstSheetIndex(int $firstSheetIndex): void
+ {
+ if ($firstSheetIndex >= 0) {
+ $this->firstSheetIndex = (int) $firstSheetIndex;
+ } else {
+ throw new Exception('First sheet index must be a positive integer.');
+ }
+ }
+
+ /**
+ * Return the visibility status of the workbook.
+ *
+ * This may be one of the following three values:
+ * - visibile
+ *
+ * @return string Visible status
+ */
+ public function getVisibility(): string
+ {
+ return $this->visibility;
+ }
+
+ /**
+ * Set the visibility status of the workbook.
+ *
+ * Valid values are:
+ * - 'visible' (self::VISIBILITY_VISIBLE):
+ * Workbook window is visible
+ * - 'hidden' (self::VISIBILITY_HIDDEN):
+ * Workbook window is hidden, but can be shown by the user
+ * via the user interface
+ * - 'veryHidden' (self::VISIBILITY_VERY_HIDDEN):
+ * Workbook window is hidden and cannot be shown in the
+ * user interface.
+ *
+ * @param null|string $visibility visibility status of the workbook
+ */
+ public function setVisibility(?string $visibility): void
+ {
+ if ($visibility === null) {
+ $visibility = self::VISIBILITY_VISIBLE;
+ }
+
+ if (in_array($visibility, self::WORKBOOK_VIEW_VISIBILITY_VALUES)) {
+ $this->visibility = $visibility;
+ } else {
+ throw new Exception('Invalid visibility value.');
+ }
+ }
+
+ /**
+ * Get the ratio between the workbook tabs bar and the horizontal scroll bar.
+ * TabRatio is assumed to be out of 1000 of the horizontal window width.
+ *
+ * @return int Ratio between the workbook tabs bar and the horizontal scroll bar
+ */
+ public function getTabRatio(): int
+ {
+ return $this->tabRatio;
+ }
+
+ /**
+ * Set the ratio between the workbook tabs bar and the horizontal scroll bar
+ * TabRatio is assumed to be out of 1000 of the horizontal window width.
+ *
+ * @param int $tabRatio Ratio between the tabs bar and the horizontal scroll bar
+ */
+ public function setTabRatio(int $tabRatio): void
+ {
+ if ($tabRatio >= 0 && $tabRatio <= 1000) {
+ $this->tabRatio = (int) $tabRatio;
+ } else {
+ throw new Exception('Tab ratio must be between 0 and 1000.');
+ }
+ }
+
+ public function reevaluateAutoFilters(bool $resetToMax): void
+ {
+ foreach ($this->workSheetCollection as $sheet) {
+ $filter = $sheet->getAutoFilter();
+ if (!empty($filter->getRange())) {
+ if ($resetToMax) {
+ $filter->setRangeToMaxRow();
+ }
+ $filter->showHideRows();
+ }
+ }
+ }
+
+ /**
+ * @throws Exception
+ */
+ public function __serialize(): array
+ {
+ throw new Exception('Spreadsheet objects cannot be serialized');
+ }
+
+ /**
+ * @throws Exception
+ */
+ public function jsonSerialize(): mixed
+ {
+ throw new Exception('Spreadsheet objects cannot be json encoded');
+ }
+
+ public function resetThemeFonts(): void
+ {
+ $majorFontLatin = $this->theme->getMajorFontLatin();
+ $minorFontLatin = $this->theme->getMinorFontLatin();
+ foreach ($this->cellXfCollection as $cellStyleXf) {
+ $scheme = $cellStyleXf->getFont()->getScheme();
+ if ($scheme === 'major') {
+ $cellStyleXf->getFont()->setName($majorFontLatin)->setScheme($scheme);
+ } elseif ($scheme === 'minor') {
+ $cellStyleXf->getFont()->setName($minorFontLatin)->setScheme($scheme);
+ }
+ }
+ foreach ($this->cellStyleXfCollection as $cellStyleXf) {
+ $scheme = $cellStyleXf->getFont()->getScheme();
+ if ($scheme === 'major') {
+ $cellStyleXf->getFont()->setName($majorFontLatin)->setScheme($scheme);
+ } elseif ($scheme === 'minor') {
+ $cellStyleXf->getFont()->setName($minorFontLatin)->setScheme($scheme);
+ }
+ }
+ }
+
+ public function getTableByName(string $tableName): ?Table
+ {
+ $table = null;
+ foreach ($this->workSheetCollection as $sheet) {
+ $table = $sheet->getTableByName($tableName);
+ if ($table !== null) {
+ break;
+ }
+ }
+
+ return $table;
+ }
+
+ /**
+ * @return bool Success or failure
+ */
+ public function setExcelCalendar(int $baseYear): bool
+ {
+ if (($baseYear === Date::CALENDAR_WINDOWS_1900) || ($baseYear === Date::CALENDAR_MAC_1904)) {
+ $this->excelCalendar = $baseYear;
+
+ return true;
+ }
+
+ return false;
+ }
+
+ /**
+ * @return int Excel base date (1900 or 1904)
+ */
+ public function getExcelCalendar(): int
+ {
+ return $this->excelCalendar;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Alignment.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Alignment.php
new file mode 100644
index 00000000..3aed77c6
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Alignment.php
@@ -0,0 +1,501 @@
+ self::HORIZONTAL_LEFT,
+ self::HORIZONTAL_RIGHT => self::HORIZONTAL_RIGHT,
+ self::HORIZONTAL_CENTER => self::HORIZONTAL_CENTER,
+ self::HORIZONTAL_CENTER_CONTINUOUS => self::HORIZONTAL_CENTER_CONTINUOUS,
+ self::HORIZONTAL_JUSTIFY => self::HORIZONTAL_JUSTIFY,
+ self::HORIZONTAL_FILL => self::HORIZONTAL_FILL,
+ self::HORIZONTAL_DISTRIBUTED => self::HORIZONTAL_DISTRIBUTED,
+ ];
+ // Mapping for horizontal alignment CSS
+ const HORIZONTAL_ALIGNMENT_FOR_HTML = [
+ self::HORIZONTAL_LEFT => self::HORIZONTAL_LEFT,
+ self::HORIZONTAL_RIGHT => self::HORIZONTAL_RIGHT,
+ self::HORIZONTAL_CENTER => self::HORIZONTAL_CENTER,
+ self::HORIZONTAL_CENTER_CONTINUOUS => self::HORIZONTAL_CENTER,
+ self::HORIZONTAL_JUSTIFY => self::HORIZONTAL_JUSTIFY,
+ //self::HORIZONTAL_FILL => self::HORIZONTAL_FILL, // no reasonable equivalent for fill
+ self::HORIZONTAL_DISTRIBUTED => self::HORIZONTAL_JUSTIFY,
+ ];
+
+ // Vertical alignment styles
+ const VERTICAL_BOTTOM = 'bottom';
+ const VERTICAL_TOP = 'top';
+ const VERTICAL_CENTER = 'center';
+ const VERTICAL_JUSTIFY = 'justify';
+ const VERTICAL_DISTRIBUTED = 'distributed'; // Excel2007 only
+ // Vertical alignment CSS
+ private const VERTICAL_BASELINE = 'baseline';
+ private const VERTICAL_MIDDLE = 'middle';
+ private const VERTICAL_SUB = 'sub';
+ private const VERTICAL_SUPER = 'super';
+ private const VERTICAL_TEXT_BOTTOM = 'text-bottom';
+ private const VERTICAL_TEXT_TOP = 'text-top';
+
+ // Mapping for vertical alignment
+ const VERTICAL_ALIGNMENT_FOR_XLSX = [
+ self::VERTICAL_BOTTOM => self::VERTICAL_BOTTOM,
+ self::VERTICAL_TOP => self::VERTICAL_TOP,
+ self::VERTICAL_CENTER => self::VERTICAL_CENTER,
+ self::VERTICAL_JUSTIFY => self::VERTICAL_JUSTIFY,
+ self::VERTICAL_DISTRIBUTED => self::VERTICAL_DISTRIBUTED,
+ // css settings that arent't in sync with Excel
+ self::VERTICAL_BASELINE => self::VERTICAL_BOTTOM,
+ self::VERTICAL_MIDDLE => self::VERTICAL_CENTER,
+ self::VERTICAL_SUB => self::VERTICAL_BOTTOM,
+ self::VERTICAL_SUPER => self::VERTICAL_TOP,
+ self::VERTICAL_TEXT_BOTTOM => self::VERTICAL_BOTTOM,
+ self::VERTICAL_TEXT_TOP => self::VERTICAL_TOP,
+ ];
+
+ // Mapping for vertical alignment for Html
+ const VERTICAL_ALIGNMENT_FOR_HTML = [
+ self::VERTICAL_BOTTOM => self::VERTICAL_BOTTOM,
+ self::VERTICAL_TOP => self::VERTICAL_TOP,
+ self::VERTICAL_CENTER => self::VERTICAL_MIDDLE,
+ self::VERTICAL_JUSTIFY => self::VERTICAL_MIDDLE,
+ self::VERTICAL_DISTRIBUTED => self::VERTICAL_MIDDLE,
+ // css settings that arent't in sync with Excel
+ self::VERTICAL_BASELINE => self::VERTICAL_BASELINE,
+ self::VERTICAL_MIDDLE => self::VERTICAL_MIDDLE,
+ self::VERTICAL_SUB => self::VERTICAL_SUB,
+ self::VERTICAL_SUPER => self::VERTICAL_SUPER,
+ self::VERTICAL_TEXT_BOTTOM => self::VERTICAL_TEXT_BOTTOM,
+ self::VERTICAL_TEXT_TOP => self::VERTICAL_TEXT_TOP,
+ ];
+
+ // Read order
+ const READORDER_CONTEXT = 0;
+ const READORDER_LTR = 1;
+ const READORDER_RTL = 2;
+
+ // Special value for Text Rotation
+ const TEXTROTATION_STACK_EXCEL = 255;
+ const TEXTROTATION_STACK_PHPSPREADSHEET = -165; // 90 - 255
+
+ /**
+ * Horizontal alignment.
+ */
+ protected ?string $horizontal = self::HORIZONTAL_GENERAL;
+
+ /**
+ * Vertical alignment.
+ */
+ protected ?string $vertical = self::VERTICAL_BOTTOM;
+
+ /**
+ * Text rotation.
+ */
+ protected ?int $textRotation = 0;
+
+ /**
+ * Wrap text.
+ */
+ protected bool $wrapText = false;
+
+ /**
+ * Shrink to fit.
+ */
+ protected bool $shrinkToFit = false;
+
+ /**
+ * Indent - only possible with horizontal alignment left and right.
+ */
+ protected int $indent = 0;
+
+ /**
+ * Read order.
+ */
+ protected int $readOrder = 0;
+
+ /**
+ * Create a new Alignment.
+ *
+ * @param bool $isSupervisor Flag indicating if this is a supervisor or not
+ * Leave this value at default unless you understand exactly what
+ * its ramifications are
+ * @param bool $isConditional Flag indicating if this is a conditional style or not
+ * Leave this value at default unless you understand exactly what
+ * its ramifications are
+ */
+ public function __construct(bool $isSupervisor = false, bool $isConditional = false)
+ {
+ // Supervisor?
+ parent::__construct($isSupervisor);
+
+ if ($isConditional) {
+ $this->horizontal = null;
+ $this->vertical = null;
+ $this->textRotation = null;
+ }
+ }
+
+ /**
+ * Get the shared style component for the currently active cell in currently active sheet.
+ * Only used for style supervisor.
+ */
+ public function getSharedComponent(): self
+ {
+ /** @var Style $parent */
+ $parent = $this->parent;
+
+ return $parent->getSharedComponent()->getAlignment();
+ }
+
+ /**
+ * Build style array from subcomponents.
+ */
+ public function getStyleArray(array $array): array
+ {
+ return ['alignment' => $array];
+ }
+
+ /**
+ * Apply styles from array.
+ *
+ *
+ * $spreadsheet->getActiveSheet()->getStyle('B2')->getAlignment()->applyFromArray(
+ * [
+ * 'horizontal' => \PhpOffice\PhpSpreadsheet\Style\Alignment::HORIZONTAL_CENTER,
+ * 'vertical' => \PhpOffice\PhpSpreadsheet\Style\Alignment::VERTICAL_CENTER,
+ * 'textRotation' => 0,
+ * 'wrapText' => TRUE
+ * ]
+ * );
+ *
+ *
+ * @param array $styleArray Array containing style information
+ *
+ * @return $this
+ */
+ public function applyFromArray(array $styleArray): static
+ {
+ if ($this->isSupervisor) {
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())
+ ->applyFromArray($this->getStyleArray($styleArray));
+ } else {
+ if (isset($styleArray['horizontal'])) {
+ $this->setHorizontal($styleArray['horizontal']);
+ }
+ if (isset($styleArray['vertical'])) {
+ $this->setVertical($styleArray['vertical']);
+ }
+ if (isset($styleArray['textRotation'])) {
+ $this->setTextRotation($styleArray['textRotation']);
+ }
+ if (isset($styleArray['wrapText'])) {
+ $this->setWrapText($styleArray['wrapText']);
+ }
+ if (isset($styleArray['shrinkToFit'])) {
+ $this->setShrinkToFit($styleArray['shrinkToFit']);
+ }
+ if (isset($styleArray['indent'])) {
+ $this->setIndent($styleArray['indent']);
+ }
+ if (isset($styleArray['readOrder'])) {
+ $this->setReadOrder($styleArray['readOrder']);
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Horizontal.
+ */
+ public function getHorizontal(): null|string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getHorizontal();
+ }
+
+ return $this->horizontal;
+ }
+
+ /**
+ * Set Horizontal.
+ *
+ * @param string $horizontalAlignment see self::HORIZONTAL_*
+ *
+ * @return $this
+ */
+ public function setHorizontal(string $horizontalAlignment): static
+ {
+ $horizontalAlignment = strtolower($horizontalAlignment);
+ if ($horizontalAlignment === self::HORIZONTAL_CENTER_CONTINUOUS_LC) {
+ $horizontalAlignment = self::HORIZONTAL_CENTER_CONTINUOUS;
+ }
+
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['horizontal' => $horizontalAlignment]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->horizontal = $horizontalAlignment;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Vertical.
+ */
+ public function getVertical(): null|string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getVertical();
+ }
+
+ return $this->vertical;
+ }
+
+ /**
+ * Set Vertical.
+ *
+ * @param string $verticalAlignment see self::VERTICAL_*
+ *
+ * @return $this
+ */
+ public function setVertical(string $verticalAlignment): static
+ {
+ $verticalAlignment = strtolower($verticalAlignment);
+
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['vertical' => $verticalAlignment]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->vertical = $verticalAlignment;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get TextRotation.
+ */
+ public function getTextRotation(): null|int
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getTextRotation();
+ }
+
+ return $this->textRotation;
+ }
+
+ /**
+ * Set TextRotation.
+ *
+ * @return $this
+ */
+ public function setTextRotation(int $angleInDegrees): static
+ {
+ // Excel2007 value 255 => PhpSpreadsheet value -165
+ if ($angleInDegrees == self::TEXTROTATION_STACK_EXCEL) {
+ $angleInDegrees = self::TEXTROTATION_STACK_PHPSPREADSHEET;
+ }
+
+ // Set rotation
+ if (($angleInDegrees >= -90 && $angleInDegrees <= 90) || $angleInDegrees == self::TEXTROTATION_STACK_PHPSPREADSHEET) {
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['textRotation' => $angleInDegrees]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->textRotation = $angleInDegrees;
+ }
+ } else {
+ throw new PhpSpreadsheetException('Text rotation should be a value between -90 and 90.');
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Wrap Text.
+ */
+ public function getWrapText(): bool
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getWrapText();
+ }
+
+ return $this->wrapText;
+ }
+
+ /**
+ * Set Wrap Text.
+ *
+ * @return $this
+ */
+ public function setWrapText(bool $wrapped): static
+ {
+ if ($wrapped == '') {
+ $wrapped = false;
+ }
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['wrapText' => $wrapped]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->wrapText = $wrapped;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Shrink to fit.
+ */
+ public function getShrinkToFit(): bool
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getShrinkToFit();
+ }
+
+ return $this->shrinkToFit;
+ }
+
+ /**
+ * Set Shrink to fit.
+ *
+ * @return $this
+ */
+ public function setShrinkToFit(bool $shrink): static
+ {
+ if ($shrink == '') {
+ $shrink = false;
+ }
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['shrinkToFit' => $shrink]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->shrinkToFit = $shrink;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get indent.
+ */
+ public function getIndent(): int
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getIndent();
+ }
+
+ return $this->indent;
+ }
+
+ /**
+ * Set indent.
+ *
+ * @return $this
+ */
+ public function setIndent(int $indent): static
+ {
+ if ($indent > 0) {
+ if (
+ $this->getHorizontal() != self::HORIZONTAL_GENERAL
+ && $this->getHorizontal() != self::HORIZONTAL_LEFT
+ && $this->getHorizontal() != self::HORIZONTAL_RIGHT
+ && $this->getHorizontal() != self::HORIZONTAL_DISTRIBUTED
+ ) {
+ $indent = 0; // indent not supported
+ }
+ }
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['indent' => $indent]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->indent = $indent;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get read order.
+ */
+ public function getReadOrder(): int
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getReadOrder();
+ }
+
+ return $this->readOrder;
+ }
+
+ /**
+ * Set read order.
+ *
+ * @return $this
+ */
+ public function setReadOrder(int $readOrder): static
+ {
+ if ($readOrder < 0 || $readOrder > 2) {
+ $readOrder = 0;
+ }
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['readOrder' => $readOrder]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->readOrder = $readOrder;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getHashCode();
+ }
+
+ return md5(
+ $this->horizontal
+ . $this->vertical
+ . $this->textRotation
+ . ($this->wrapText ? 't' : 'f')
+ . ($this->shrinkToFit ? 't' : 'f')
+ . $this->indent
+ . $this->readOrder
+ . __CLASS__
+ );
+ }
+
+ protected function exportArray1(): array
+ {
+ $exportedArray = [];
+ $this->exportArray2($exportedArray, 'horizontal', $this->getHorizontal());
+ $this->exportArray2($exportedArray, 'indent', $this->getIndent());
+ $this->exportArray2($exportedArray, 'readOrder', $this->getReadOrder());
+ $this->exportArray2($exportedArray, 'shrinkToFit', $this->getShrinkToFit());
+ $this->exportArray2($exportedArray, 'textRotation', $this->getTextRotation());
+ $this->exportArray2($exportedArray, 'vertical', $this->getVertical());
+ $this->exportArray2($exportedArray, 'wrapText', $this->getWrapText());
+
+ return $exportedArray;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Border.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Border.php
new file mode 100644
index 00000000..07162566
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Border.php
@@ -0,0 +1,221 @@
+color = new Color(Color::COLOR_BLACK, $isSupervisor);
+
+ // bind parent if we are a supervisor
+ if ($isSupervisor) {
+ $this->color->bindParent($this, 'color');
+ }
+ if ($isConditional) {
+ $this->borderStyle = self::BORDER_OMIT;
+ }
+ }
+
+ /**
+ * Get the shared style component for the currently active cell in currently active sheet.
+ * Only used for style supervisor.
+ */
+ public function getSharedComponent(): self
+ {
+ /** @var Style $parent */
+ $parent = $this->parent;
+
+ /** @var Borders $sharedComponent */
+ $sharedComponent = $parent->getSharedComponent();
+
+ return match ($this->parentPropertyName) {
+ 'bottom' => $sharedComponent->getBottom(),
+ 'diagonal' => $sharedComponent->getDiagonal(),
+ 'left' => $sharedComponent->getLeft(),
+ 'right' => $sharedComponent->getRight(),
+ 'top' => $sharedComponent->getTop(),
+ default => throw new PhpSpreadsheetException('Cannot get shared component for a pseudo-border.'),
+ };
+ }
+
+ /**
+ * Build style array from subcomponents.
+ */
+ public function getStyleArray(array $array): array
+ {
+ /** @var Style $parent */
+ $parent = $this->parent;
+
+ return $parent->getStyleArray([$this->parentPropertyName => $array]);
+ }
+
+ /**
+ * Apply styles from array.
+ *
+ *
+ * $spreadsheet->getActiveSheet()->getStyle('B2')->getBorders()->getTop()->applyFromArray(
+ * [
+ * 'borderStyle' => Border::BORDER_DASHDOT,
+ * 'color' => [
+ * 'rgb' => '808080'
+ * ]
+ * ]
+ * );
+ *
+ *
+ * @param array $styleArray Array containing style information
+ *
+ * @return $this
+ */
+ public function applyFromArray(array $styleArray): static
+ {
+ if ($this->isSupervisor) {
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($this->getStyleArray($styleArray));
+ } else {
+ if (isset($styleArray['borderStyle'])) {
+ $this->setBorderStyle($styleArray['borderStyle']);
+ }
+ if (isset($styleArray['color'])) {
+ $this->getColor()->applyFromArray($styleArray['color']);
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Border style.
+ */
+ public function getBorderStyle(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getBorderStyle();
+ }
+
+ return $this->borderStyle;
+ }
+
+ /**
+ * Set Border style.
+ *
+ * @param bool|string $style When passing a boolean, FALSE equates Border::BORDER_NONE
+ * and TRUE to Border::BORDER_MEDIUM
+ *
+ * @return $this
+ */
+ public function setBorderStyle(bool|string $style): static
+ {
+ if (empty($style)) {
+ $style = self::BORDER_NONE;
+ } elseif (is_bool($style)) {
+ $style = self::BORDER_MEDIUM;
+ }
+
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['borderStyle' => $style]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->borderStyle = $style;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Border Color.
+ */
+ public function getColor(): Color
+ {
+ return $this->color;
+ }
+
+ /**
+ * Set Border Color.
+ *
+ * @return $this
+ */
+ public function setColor(Color $color): static
+ {
+ // make sure parameter is a real color and not a supervisor
+ $color = $color->getIsSupervisor() ? $color->getSharedComponent() : $color;
+
+ if ($this->isSupervisor) {
+ $styleArray = $this->getColor()->getStyleArray(['argb' => $color->getARGB()]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->color = $color;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getHashCode();
+ }
+
+ return md5(
+ $this->borderStyle
+ . $this->color->getHashCode()
+ . __CLASS__
+ );
+ }
+
+ protected function exportArray1(): array
+ {
+ $exportedArray = [];
+ $this->exportArray2($exportedArray, 'borderStyle', $this->getBorderStyle());
+ $this->exportArray2($exportedArray, 'color', $this->getColor());
+
+ return $exportedArray;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Borders.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Borders.php
new file mode 100644
index 00000000..93a95e67
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Borders.php
@@ -0,0 +1,374 @@
+left = new Border($isSupervisor, $isConditional);
+ $this->right = new Border($isSupervisor, $isConditional);
+ $this->top = new Border($isSupervisor, $isConditional);
+ $this->bottom = new Border($isSupervisor, $isConditional);
+ $this->diagonal = new Border($isSupervisor, $isConditional);
+ $this->diagonalDirection = self::DIAGONAL_NONE;
+
+ // Specially for supervisor
+ if ($isSupervisor) {
+ // Initialize pseudo-borders
+ $this->allBorders = new Border(true, $isConditional);
+ $this->outline = new Border(true, $isConditional);
+ $this->inside = new Border(true, $isConditional);
+ $this->vertical = new Border(true, $isConditional);
+ $this->horizontal = new Border(true, $isConditional);
+
+ // bind parent if we are a supervisor
+ $this->left->bindParent($this, 'left');
+ $this->right->bindParent($this, 'right');
+ $this->top->bindParent($this, 'top');
+ $this->bottom->bindParent($this, 'bottom');
+ $this->diagonal->bindParent($this, 'diagonal');
+ $this->allBorders->bindParent($this, 'allBorders');
+ $this->outline->bindParent($this, 'outline');
+ $this->inside->bindParent($this, 'inside');
+ $this->vertical->bindParent($this, 'vertical');
+ $this->horizontal->bindParent($this, 'horizontal');
+ }
+ }
+
+ /**
+ * Get the shared style component for the currently active cell in currently active sheet.
+ * Only used for style supervisor.
+ */
+ public function getSharedComponent(): self
+ {
+ /** @var Style $parent */
+ $parent = $this->parent;
+
+ return $parent->getSharedComponent()->getBorders();
+ }
+
+ /**
+ * Build style array from subcomponents.
+ */
+ public function getStyleArray(array $array): array
+ {
+ return ['borders' => $array];
+ }
+
+ /**
+ * Apply styles from array.
+ *
+ *
+ * $spreadsheet->getActiveSheet()->getStyle('B2')->getBorders()->applyFromArray(
+ * [
+ * 'bottom' => [
+ * 'borderStyle' => Border::BORDER_DASHDOT,
+ * 'color' => [
+ * 'rgb' => '808080'
+ * ]
+ * ],
+ * 'top' => [
+ * 'borderStyle' => Border::BORDER_DASHDOT,
+ * 'color' => [
+ * 'rgb' => '808080'
+ * ]
+ * ]
+ * ]
+ * );
+ *
+ *
+ *
+ * $spreadsheet->getActiveSheet()->getStyle('B2')->getBorders()->applyFromArray(
+ * [
+ * 'allBorders' => [
+ * 'borderStyle' => Border::BORDER_DASHDOT,
+ * 'color' => [
+ * 'rgb' => '808080'
+ * ]
+ * ]
+ * ]
+ * );
+ *
+ *
+ * @param array $styleArray Array containing style information
+ *
+ * @return $this
+ */
+ public function applyFromArray(array $styleArray): static
+ {
+ if ($this->isSupervisor) {
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($this->getStyleArray($styleArray));
+ } else {
+ if (isset($styleArray['left'])) {
+ $this->getLeft()->applyFromArray($styleArray['left']);
+ }
+ if (isset($styleArray['right'])) {
+ $this->getRight()->applyFromArray($styleArray['right']);
+ }
+ if (isset($styleArray['top'])) {
+ $this->getTop()->applyFromArray($styleArray['top']);
+ }
+ if (isset($styleArray['bottom'])) {
+ $this->getBottom()->applyFromArray($styleArray['bottom']);
+ }
+ if (isset($styleArray['diagonal'])) {
+ $this->getDiagonal()->applyFromArray($styleArray['diagonal']);
+ }
+ if (isset($styleArray['diagonalDirection'])) {
+ $this->setDiagonalDirection($styleArray['diagonalDirection']);
+ }
+ if (isset($styleArray['allBorders'])) {
+ $this->getLeft()->applyFromArray($styleArray['allBorders']);
+ $this->getRight()->applyFromArray($styleArray['allBorders']);
+ $this->getTop()->applyFromArray($styleArray['allBorders']);
+ $this->getBottom()->applyFromArray($styleArray['allBorders']);
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Left.
+ */
+ public function getLeft(): Border
+ {
+ return $this->left;
+ }
+
+ /**
+ * Get Right.
+ */
+ public function getRight(): Border
+ {
+ return $this->right;
+ }
+
+ /**
+ * Get Top.
+ */
+ public function getTop(): Border
+ {
+ return $this->top;
+ }
+
+ /**
+ * Get Bottom.
+ */
+ public function getBottom(): Border
+ {
+ return $this->bottom;
+ }
+
+ /**
+ * Get Diagonal.
+ */
+ public function getDiagonal(): Border
+ {
+ return $this->diagonal;
+ }
+
+ /**
+ * Get AllBorders (pseudo-border). Only applies to supervisor.
+ */
+ public function getAllBorders(): Border
+ {
+ if (!$this->isSupervisor) {
+ throw new PhpSpreadsheetException('Can only get pseudo-border for supervisor.');
+ }
+
+ return $this->allBorders;
+ }
+
+ /**
+ * Get Outline (pseudo-border). Only applies to supervisor.
+ */
+ public function getOutline(): Border
+ {
+ if (!$this->isSupervisor) {
+ throw new PhpSpreadsheetException('Can only get pseudo-border for supervisor.');
+ }
+
+ return $this->outline;
+ }
+
+ /**
+ * Get Inside (pseudo-border). Only applies to supervisor.
+ */
+ public function getInside(): Border
+ {
+ if (!$this->isSupervisor) {
+ throw new PhpSpreadsheetException('Can only get pseudo-border for supervisor.');
+ }
+
+ return $this->inside;
+ }
+
+ /**
+ * Get Vertical (pseudo-border). Only applies to supervisor.
+ */
+ public function getVertical(): Border
+ {
+ if (!$this->isSupervisor) {
+ throw new PhpSpreadsheetException('Can only get pseudo-border for supervisor.');
+ }
+
+ return $this->vertical;
+ }
+
+ /**
+ * Get Horizontal (pseudo-border). Only applies to supervisor.
+ */
+ public function getHorizontal(): Border
+ {
+ if (!$this->isSupervisor) {
+ throw new PhpSpreadsheetException('Can only get pseudo-border for supervisor.');
+ }
+
+ return $this->horizontal;
+ }
+
+ /**
+ * Get DiagonalDirection.
+ */
+ public function getDiagonalDirection(): int
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getDiagonalDirection();
+ }
+
+ return $this->diagonalDirection;
+ }
+
+ /**
+ * Set DiagonalDirection.
+ *
+ * @param int $direction see self::DIAGONAL_*
+ *
+ * @return $this
+ */
+ public function setDiagonalDirection(int $direction): static
+ {
+ if ($direction == '') {
+ $direction = self::DIAGONAL_NONE;
+ }
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['diagonalDirection' => $direction]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->diagonalDirection = $direction;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getHashcode();
+ }
+
+ return md5(
+ $this->getLeft()->getHashCode()
+ . $this->getRight()->getHashCode()
+ . $this->getTop()->getHashCode()
+ . $this->getBottom()->getHashCode()
+ . $this->getDiagonal()->getHashCode()
+ . $this->getDiagonalDirection()
+ . __CLASS__
+ );
+ }
+
+ protected function exportArray1(): array
+ {
+ $exportedArray = [];
+ $this->exportArray2($exportedArray, 'bottom', $this->getBottom());
+ $this->exportArray2($exportedArray, 'diagonal', $this->getDiagonal());
+ $this->exportArray2($exportedArray, 'diagonalDirection', $this->getDiagonalDirection());
+ $this->exportArray2($exportedArray, 'left', $this->getLeft());
+ $this->exportArray2($exportedArray, 'right', $this->getRight());
+ $this->exportArray2($exportedArray, 'top', $this->getTop());
+
+ return $exportedArray;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Color.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Color.php
new file mode 100644
index 00000000..6f9db8a2
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Color.php
@@ -0,0 +1,418 @@
+ self::COLOR_BLACK,
+ 'White' => self::COLOR_WHITE,
+ 'Red' => self::COLOR_RED,
+ 'Green' => self::COLOR_GREEN,
+ 'Blue' => self::COLOR_BLUE,
+ 'Yellow' => self::COLOR_YELLOW,
+ 'Magenta' => self::COLOR_MAGENTA,
+ 'Cyan' => self::COLOR_CYAN,
+ ];
+
+ const VALIDATE_ARGB_SIZE = 8;
+ const VALIDATE_RGB_SIZE = 6;
+ const VALIDATE_COLOR_6 = '/^[A-F0-9]{6}$/i';
+ const VALIDATE_COLOR_8 = '/^[A-F0-9]{8}$/i';
+
+ private const INDEXED_COLORS = [
+ 1 => 'FF000000', // System Colour #1 - Black
+ 2 => 'FFFFFFFF', // System Colour #2 - White
+ 3 => 'FFFF0000', // System Colour #3 - Red
+ 4 => 'FF00FF00', // System Colour #4 - Green
+ 5 => 'FF0000FF', // System Colour #5 - Blue
+ 6 => 'FFFFFF00', // System Colour #6 - Yellow
+ 7 => 'FFFF00FF', // System Colour #7- Magenta
+ 8 => 'FF00FFFF', // System Colour #8- Cyan
+ 9 => 'FF800000', // Standard Colour #9
+ 10 => 'FF008000', // Standard Colour #10
+ 11 => 'FF000080', // Standard Colour #11
+ 12 => 'FF808000', // Standard Colour #12
+ 13 => 'FF800080', // Standard Colour #13
+ 14 => 'FF008080', // Standard Colour #14
+ 15 => 'FFC0C0C0', // Standard Colour #15
+ 16 => 'FF808080', // Standard Colour #16
+ 17 => 'FF9999FF', // Chart Fill Colour #17
+ 18 => 'FF993366', // Chart Fill Colour #18
+ 19 => 'FFFFFFCC', // Chart Fill Colour #19
+ 20 => 'FFCCFFFF', // Chart Fill Colour #20
+ 21 => 'FF660066', // Chart Fill Colour #21
+ 22 => 'FFFF8080', // Chart Fill Colour #22
+ 23 => 'FF0066CC', // Chart Fill Colour #23
+ 24 => 'FFCCCCFF', // Chart Fill Colour #24
+ 25 => 'FF000080', // Chart Line Colour #25
+ 26 => 'FFFF00FF', // Chart Line Colour #26
+ 27 => 'FFFFFF00', // Chart Line Colour #27
+ 28 => 'FF00FFFF', // Chart Line Colour #28
+ 29 => 'FF800080', // Chart Line Colour #29
+ 30 => 'FF800000', // Chart Line Colour #30
+ 31 => 'FF008080', // Chart Line Colour #31
+ 32 => 'FF0000FF', // Chart Line Colour #32
+ 33 => 'FF00CCFF', // Standard Colour #33
+ 34 => 'FFCCFFFF', // Standard Colour #34
+ 35 => 'FFCCFFCC', // Standard Colour #35
+ 36 => 'FFFFFF99', // Standard Colour #36
+ 37 => 'FF99CCFF', // Standard Colour #37
+ 38 => 'FFFF99CC', // Standard Colour #38
+ 39 => 'FFCC99FF', // Standard Colour #39
+ 40 => 'FFFFCC99', // Standard Colour #40
+ 41 => 'FF3366FF', // Standard Colour #41
+ 42 => 'FF33CCCC', // Standard Colour #42
+ 43 => 'FF99CC00', // Standard Colour #43
+ 44 => 'FFFFCC00', // Standard Colour #44
+ 45 => 'FFFF9900', // Standard Colour #45
+ 46 => 'FFFF6600', // Standard Colour #46
+ 47 => 'FF666699', // Standard Colour #47
+ 48 => 'FF969696', // Standard Colour #48
+ 49 => 'FF003366', // Standard Colour #49
+ 50 => 'FF339966', // Standard Colour #50
+ 51 => 'FF003300', // Standard Colour #51
+ 52 => 'FF333300', // Standard Colour #52
+ 53 => 'FF993300', // Standard Colour #53
+ 54 => 'FF993366', // Standard Colour #54
+ 55 => 'FF333399', // Standard Colour #55
+ 56 => 'FF333333', // Standard Colour #56
+ ];
+
+ /**
+ * ARGB - Alpha RGB.
+ */
+ protected ?string $argb = null;
+
+ private bool $hasChanged = false;
+
+ /**
+ * Create a new Color.
+ *
+ * @param string $colorValue ARGB value for the colour, or named colour
+ * @param bool $isSupervisor Flag indicating if this is a supervisor or not
+ * Leave this value at default unless you understand exactly what
+ * its ramifications are
+ * @param bool $isConditional Flag indicating if this is a conditional style or not
+ * Leave this value at default unless you understand exactly what
+ * its ramifications are
+ */
+ public function __construct(string $colorValue = self::COLOR_BLACK, bool $isSupervisor = false, bool $isConditional = false)
+ {
+ // Supervisor?
+ parent::__construct($isSupervisor);
+
+ // Initialise values
+ if (!$isConditional) {
+ $this->argb = $this->validateColor($colorValue) ?: self::COLOR_BLACK;
+ }
+ }
+
+ /**
+ * Get the shared style component for the currently active cell in currently active sheet.
+ * Only used for style supervisor.
+ */
+ public function getSharedComponent(): self
+ {
+ /** @var Style $parent */
+ $parent = $this->parent;
+ /** @var Border|Fill $sharedComponent */
+ $sharedComponent = $parent->getSharedComponent();
+ if ($sharedComponent instanceof Fill) {
+ if ($this->parentPropertyName === 'endColor') {
+ return $sharedComponent->getEndColor();
+ }
+
+ return $sharedComponent->getStartColor();
+ }
+
+ return $sharedComponent->getColor();
+ }
+
+ /**
+ * Build style array from subcomponents.
+ */
+ public function getStyleArray(array $array): array
+ {
+ /** @var Style $parent */
+ $parent = $this->parent;
+
+ return $parent->getStyleArray([$this->parentPropertyName => $array]);
+ }
+
+ /**
+ * Apply styles from array.
+ *
+ *
+ * $spreadsheet->getActiveSheet()->getStyle('B2')->getFont()->getColor()->applyFromArray(['rgb' => '808080']);
+ *
+ *
+ * @param array $styleArray Array containing style information
+ *
+ * @return $this
+ */
+ public function applyFromArray(array $styleArray): static
+ {
+ if ($this->isSupervisor) {
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($this->getStyleArray($styleArray));
+ } else {
+ if (isset($styleArray['rgb'])) {
+ $this->setRGB($styleArray['rgb']);
+ }
+ if (isset($styleArray['argb'])) {
+ $this->setARGB($styleArray['argb']);
+ }
+ }
+
+ return $this;
+ }
+
+ private function validateColor(?string $colorValue): string
+ {
+ if ($colorValue === null || $colorValue === '') {
+ return self::COLOR_BLACK;
+ }
+ $named = ucfirst(strtolower($colorValue));
+ if (array_key_exists($named, self::NAMED_COLOR_TRANSLATIONS)) {
+ return self::NAMED_COLOR_TRANSLATIONS[$named];
+ }
+ if (preg_match(self::VALIDATE_COLOR_8, $colorValue) === 1) {
+ return $colorValue;
+ }
+ if (preg_match(self::VALIDATE_COLOR_6, $colorValue) === 1) {
+ return 'FF' . $colorValue;
+ }
+
+ return '';
+ }
+
+ /**
+ * Get ARGB.
+ */
+ public function getARGB(): ?string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getARGB();
+ }
+
+ return $this->argb;
+ }
+
+ /**
+ * Set ARGB.
+ *
+ * @param ?string $colorValue ARGB value, or a named color
+ *
+ * @return $this
+ */
+ public function setARGB(?string $colorValue = self::COLOR_BLACK): static
+ {
+ $this->hasChanged = true;
+ $colorValue = $this->validateColor($colorValue);
+ if ($colorValue === '') {
+ return $this;
+ }
+
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['argb' => $colorValue]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->argb = $colorValue;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get RGB.
+ */
+ public function getRGB(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getRGB();
+ }
+
+ return substr($this->argb ?? '', 2);
+ }
+
+ /**
+ * Set RGB.
+ *
+ * @param ?string $colorValue RGB value, or a named color
+ *
+ * @return $this
+ */
+ public function setRGB(?string $colorValue = self::COLOR_BLACK): static
+ {
+ return $this->setARGB($colorValue);
+ }
+
+ /**
+ * Get a specified colour component of an RGB value.
+ *
+ * @param string $rgbValue The colour as an RGB value (e.g. FF00CCCC or CCDDEE
+ * @param int $offset Position within the RGB value to extract
+ * @param bool $hex Flag indicating whether the component should be returned as a hex or a
+ * decimal value
+ *
+ * @return int|string The extracted colour component
+ */
+ private static function getColourComponent(string $rgbValue, int $offset, bool $hex = true): string|int
+ {
+ $colour = substr($rgbValue, $offset, 2) ?: '';
+ if (preg_match('/^[0-9a-f]{2}$/i', $colour) !== 1) {
+ $colour = '00';
+ }
+
+ return ($hex) ? $colour : (int) hexdec($colour);
+ }
+
+ /**
+ * Get the red colour component of an RGB value.
+ *
+ * @param string $rgbValue The colour as an RGB value (e.g. FF00CCCC or CCDDEE
+ * @param bool $hex Flag indicating whether the component should be returned as a hex or a
+ * decimal value
+ *
+ * @return int|string The red colour component
+ */
+ public static function getRed(string $rgbValue, bool $hex = true)
+ {
+ return self::getColourComponent($rgbValue, strlen($rgbValue) - 6, $hex);
+ }
+
+ /**
+ * Get the green colour component of an RGB value.
+ *
+ * @param string $rgbValue The colour as an RGB value (e.g. FF00CCCC or CCDDEE
+ * @param bool $hex Flag indicating whether the component should be returned as a hex or a
+ * decimal value
+ *
+ * @return int|string The green colour component
+ */
+ public static function getGreen(string $rgbValue, bool $hex = true)
+ {
+ return self::getColourComponent($rgbValue, strlen($rgbValue) - 4, $hex);
+ }
+
+ /**
+ * Get the blue colour component of an RGB value.
+ *
+ * @param string $rgbValue The colour as an RGB value (e.g. FF00CCCC or CCDDEE
+ * @param bool $hex Flag indicating whether the component should be returned as a hex or a
+ * decimal value
+ *
+ * @return int|string The blue colour component
+ */
+ public static function getBlue(string $rgbValue, bool $hex = true)
+ {
+ return self::getColourComponent($rgbValue, strlen($rgbValue) - 2, $hex);
+ }
+
+ /**
+ * Adjust the brightness of a color.
+ *
+ * @param string $hexColourValue The colour as an RGBA or RGB value (e.g. FF00CCCC or CCDDEE)
+ * @param float $adjustPercentage The percentage by which to adjust the colour as a float from -1 to 1
+ *
+ * @return string The adjusted colour as an RGBA or RGB value (e.g. FF00CCCC or CCDDEE)
+ */
+ public static function changeBrightness(string $hexColourValue, float $adjustPercentage): string
+ {
+ $rgba = (strlen($hexColourValue) === 8);
+ $adjustPercentage = max(-1.0, min(1.0, $adjustPercentage));
+
+ /** @var int $red */
+ $red = self::getRed($hexColourValue, false);
+ /** @var int $green */
+ $green = self::getGreen($hexColourValue, false);
+ /** @var int $blue */
+ $blue = self::getBlue($hexColourValue, false);
+
+ return (($rgba) ? 'FF' : '') . RgbTint::rgbAndTintToRgb($red, $green, $blue, $adjustPercentage);
+ }
+
+ /**
+ * Get indexed color.
+ *
+ * @param int $colorIndex Index entry point into the colour array
+ * @param bool $background Flag to indicate whether default background or foreground colour
+ * should be returned if the indexed colour doesn't exist
+ */
+ public static function indexedColor(int $colorIndex, bool $background = false, ?array $palette = null): self
+ {
+ // Clean parameter
+ $colorIndex = (int) $colorIndex;
+
+ if (empty($palette)) {
+ if (isset(self::INDEXED_COLORS[$colorIndex])) {
+ return new self(self::INDEXED_COLORS[$colorIndex]);
+ }
+ } else {
+ if (isset($palette[$colorIndex])) {
+ return new self($palette[$colorIndex]);
+ }
+ }
+
+ return ($background) ? new self(self::COLOR_WHITE) : new self(self::COLOR_BLACK);
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getHashCode();
+ }
+
+ return md5(
+ $this->argb
+ . __CLASS__
+ );
+ }
+
+ protected function exportArray1(): array
+ {
+ $exportedArray = [];
+ $this->exportArray2($exportedArray, 'argb', $this->getARGB());
+
+ return $exportedArray;
+ }
+
+ public function getHasChanged(): bool
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->hasChanged;
+ }
+
+ return $this->hasChanged;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Conditional.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Conditional.php
new file mode 100644
index 00000000..01a4d8a9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Conditional.php
@@ -0,0 +1,337 @@
+style = new Style(false, true);
+ }
+
+ public function getNoFormatSet(): bool
+ {
+ return $this->noFormatSet;
+ }
+
+ public function setNoFormatSet(bool $noFormatSet): self
+ {
+ $this->noFormatSet = $noFormatSet;
+
+ return $this;
+ }
+
+ /**
+ * Get Condition type.
+ */
+ public function getConditionType(): string
+ {
+ return $this->conditionType;
+ }
+
+ /**
+ * Set Condition type.
+ *
+ * @param string $type Condition type, see self::CONDITION_*
+ *
+ * @return $this
+ */
+ public function setConditionType(string $type): static
+ {
+ $this->conditionType = $type;
+
+ return $this;
+ }
+
+ /**
+ * Get Operator type.
+ */
+ public function getOperatorType(): string
+ {
+ return $this->operatorType;
+ }
+
+ /**
+ * Set Operator type.
+ *
+ * @param string $type Conditional operator type, see self::OPERATOR_*
+ *
+ * @return $this
+ */
+ public function setOperatorType(string $type): static
+ {
+ $this->operatorType = $type;
+
+ return $this;
+ }
+
+ /**
+ * Get text.
+ */
+ public function getText(): string
+ {
+ return $this->text;
+ }
+
+ /**
+ * Set text.
+ *
+ * @return $this
+ */
+ public function setText(string $text): static
+ {
+ $this->text = $text;
+
+ return $this;
+ }
+
+ /**
+ * Get StopIfTrue.
+ */
+ public function getStopIfTrue(): bool
+ {
+ return $this->stopIfTrue;
+ }
+
+ /**
+ * Set StopIfTrue.
+ *
+ * @return $this
+ */
+ public function setStopIfTrue(bool $stopIfTrue): static
+ {
+ $this->stopIfTrue = $stopIfTrue;
+
+ return $this;
+ }
+
+ /**
+ * Get Conditions.
+ *
+ * @return (bool|float|int|string)[]
+ */
+ public function getConditions(): array
+ {
+ return $this->condition;
+ }
+
+ /**
+ * Set Conditions.
+ *
+ * @param bool|(bool|float|int|string)[]|float|int|string $conditions Condition
+ *
+ * @return $this
+ */
+ public function setConditions($conditions): static
+ {
+ if (!is_array($conditions)) {
+ $conditions = [$conditions];
+ }
+ $this->condition = $conditions;
+
+ return $this;
+ }
+
+ /**
+ * Add Condition.
+ *
+ * @param bool|float|int|string $condition Condition
+ *
+ * @return $this
+ */
+ public function addCondition($condition): static
+ {
+ $this->condition[] = $condition;
+
+ return $this;
+ }
+
+ /**
+ * Get Style.
+ */
+ public function getStyle(): Style
+ {
+ return $this->style;
+ }
+
+ /**
+ * Set Style.
+ *
+ * @return $this
+ */
+ public function setStyle(Style $style): static
+ {
+ $this->style = $style;
+
+ return $this;
+ }
+
+ public function getDataBar(): ?ConditionalDataBar
+ {
+ return $this->dataBar;
+ }
+
+ public function setDataBar(ConditionalDataBar $dataBar): static
+ {
+ $this->dataBar = $dataBar;
+
+ return $this;
+ }
+
+ public function getColorScale(): ?ConditionalColorScale
+ {
+ return $this->colorScale;
+ }
+
+ public function setColorScale(ConditionalColorScale $colorScale): static
+ {
+ $this->colorScale = $colorScale;
+
+ return $this;
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ return md5(
+ $this->conditionType
+ . $this->operatorType
+ . implode(';', $this->condition)
+ . $this->style->getHashCode()
+ . __CLASS__
+ );
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $vars = get_object_vars($this);
+ foreach ($vars as $key => $value) {
+ if (is_object($value)) {
+ $this->$key = clone $value;
+ } else {
+ $this->$key = $value;
+ }
+ }
+ }
+
+ /**
+ * Verify if param is valid condition type.
+ */
+ public static function isValidConditionType(string $type): bool
+ {
+ return in_array($type, self::CONDITION_TYPES);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/CellMatcher.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/CellMatcher.php
new file mode 100644
index 00000000..2a279075
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/CellMatcher.php
@@ -0,0 +1,271 @@
+ '=',
+ Conditional::OPERATOR_GREATERTHAN => '>',
+ Conditional::OPERATOR_GREATERTHANOREQUAL => '>=',
+ Conditional::OPERATOR_LESSTHAN => '<',
+ Conditional::OPERATOR_LESSTHANOREQUAL => '<=',
+ Conditional::OPERATOR_NOTEQUAL => '<>',
+ ];
+
+ public const COMPARISON_RANGE_OPERATORS = [
+ Conditional::OPERATOR_BETWEEN => 'IF(AND(A1>=%s,A1<=%s),TRUE,FALSE)',
+ Conditional::OPERATOR_NOTBETWEEN => 'IF(AND(A1>=%s,A1<=%s),FALSE,TRUE)',
+ ];
+
+ public const COMPARISON_DUPLICATES_OPERATORS = [
+ Conditional::CONDITION_DUPLICATES => "COUNTIF('%s'!%s,%s)>1",
+ Conditional::CONDITION_UNIQUE => "COUNTIF('%s'!%s,%s)=1",
+ ];
+
+ protected Cell $cell;
+
+ protected int $cellRow;
+
+ protected Worksheet $worksheet;
+
+ protected int $cellColumn;
+
+ protected string $conditionalRange;
+
+ protected string $referenceCell;
+
+ protected int $referenceRow;
+
+ protected int $referenceColumn;
+
+ protected Calculation $engine;
+
+ public function __construct(Cell $cell, string $conditionalRange)
+ {
+ $this->cell = $cell;
+ $this->worksheet = $cell->getWorksheet();
+ [$this->cellColumn, $this->cellRow] = Coordinate::indexesFromString($this->cell->getCoordinate());
+ $this->setReferenceCellForExpressions($conditionalRange);
+
+ $this->engine = Calculation::getInstance($this->worksheet->getParent());
+ }
+
+ protected function setReferenceCellForExpressions(string $conditionalRange): void
+ {
+ $conditionalRange = Coordinate::splitRange(str_replace('$', '', strtoupper($conditionalRange)));
+ [$this->referenceCell] = $conditionalRange[0];
+
+ [$this->referenceColumn, $this->referenceRow] = Coordinate::indexesFromString($this->referenceCell);
+
+ // Convert our conditional range to an absolute conditional range, so it can be used "pinned" in formulae
+ $rangeSets = [];
+ foreach ($conditionalRange as $rangeSet) {
+ $absoluteRangeSet = array_map(
+ [Coordinate::class, 'absoluteCoordinate'],
+ $rangeSet
+ );
+ $rangeSets[] = implode(':', $absoluteRangeSet);
+ }
+ $this->conditionalRange = implode(',', $rangeSets);
+ }
+
+ public function evaluateConditional(Conditional $conditional): bool
+ {
+ // Some calculations may modify the stored cell; so reset it before every evaluation.
+ $cellColumn = Coordinate::stringFromColumnIndex($this->cellColumn);
+ $cellAddress = "{$cellColumn}{$this->cellRow}";
+ $this->cell = $this->worksheet->getCell($cellAddress);
+
+ return match ($conditional->getConditionType()) {
+ Conditional::CONDITION_CELLIS => $this->processOperatorComparison($conditional),
+ Conditional::CONDITION_DUPLICATES, Conditional::CONDITION_UNIQUE => $this->processDuplicatesComparison($conditional),
+ // Expression is NOT(ISERROR(SEARCH("",)))
+ Conditional::CONDITION_CONTAINSTEXT,
+ // Expression is ISERROR(SEARCH("",))
+ Conditional::CONDITION_NOTCONTAINSTEXT,
+ // Expression is LEFT(,LEN(""))=""
+ Conditional::CONDITION_BEGINSWITH,
+ // Expression is RIGHT(,LEN(""))=""
+ Conditional::CONDITION_ENDSWITH,
+ // Expression is LEN(TRIM())=0
+ Conditional::CONDITION_CONTAINSBLANKS,
+ // Expression is LEN(TRIM())>0
+ Conditional::CONDITION_NOTCONTAINSBLANKS,
+ // Expression is ISERROR()
+ Conditional::CONDITION_CONTAINSERRORS,
+ // Expression is NOT(ISERROR())
+ Conditional::CONDITION_NOTCONTAINSERRORS,
+ // Expression varies, depending on specified timePeriod value, e.g.
+ // Yesterday FLOOR(,1)=TODAY()-1
+ // Today FLOOR(,1)=TODAY()
+ // Tomorrow FLOOR(,1)=TODAY()+1
+ // Last 7 Days AND(TODAY()-FLOOR(,1)<=6,FLOOR(,1)<=TODAY())
+ Conditional::CONDITION_TIMEPERIOD,
+ Conditional::CONDITION_EXPRESSION => $this->processExpression($conditional),
+ default => false,
+ };
+ }
+
+ protected function wrapValue(mixed $value): float|int|string
+ {
+ if (!is_numeric($value)) {
+ if (is_bool($value)) {
+ return $value ? 'TRUE' : 'FALSE';
+ } elseif ($value === null) {
+ return 'NULL';
+ }
+
+ return '"' . $value . '"';
+ }
+
+ return $value;
+ }
+
+ protected function wrapCellValue(): float|int|string
+ {
+ return $this->wrapValue($this->cell->getCalculatedValue());
+ }
+
+ protected function conditionCellAdjustment(array $matches): float|int|string
+ {
+ $column = $matches[6];
+ $row = $matches[7];
+
+ if (!str_contains($column, '$')) {
+ $column = Coordinate::columnIndexFromString($column);
+ $column += $this->cellColumn - $this->referenceColumn;
+ $column = Coordinate::stringFromColumnIndex($column);
+ }
+
+ if (!str_contains($row, '$')) {
+ $row += $this->cellRow - $this->referenceRow;
+ }
+
+ if (!empty($matches[4])) {
+ $worksheet = $this->worksheet->getParentOrThrow()->getSheetByName(trim($matches[4], "'"));
+ if ($worksheet === null) {
+ return $this->wrapValue(null);
+ }
+
+ return $this->wrapValue(
+ $worksheet
+ ->getCell(str_replace('$', '', "{$column}{$row}"))
+ ->getCalculatedValue()
+ );
+ }
+
+ return $this->wrapValue(
+ $this->worksheet
+ ->getCell(str_replace('$', '', "{$column}{$row}"))
+ ->getCalculatedValue()
+ );
+ }
+
+ protected function cellConditionCheck(string $condition): string
+ {
+ $splitCondition = explode(Calculation::FORMULA_STRING_QUOTE, $condition);
+ $i = false;
+ foreach ($splitCondition as &$value) {
+ // Only count/replace in alternating array entries (ie. not in quoted strings)
+ $i = $i === false;
+ if ($i) {
+ $value = (string) preg_replace_callback(
+ '/' . Calculation::CALCULATION_REGEXP_CELLREF_RELATIVE . '/i',
+ [$this, 'conditionCellAdjustment'],
+ $value
+ );
+ }
+ }
+ unset($value);
+
+ // Then rebuild the condition string to return it
+ return implode(Calculation::FORMULA_STRING_QUOTE, $splitCondition);
+ }
+
+ protected function adjustConditionsForCellReferences(array $conditions): array
+ {
+ return array_map(
+ [$this, 'cellConditionCheck'],
+ $conditions
+ );
+ }
+
+ protected function processOperatorComparison(Conditional $conditional): bool
+ {
+ if (array_key_exists($conditional->getOperatorType(), self::COMPARISON_RANGE_OPERATORS)) {
+ return $this->processRangeOperator($conditional);
+ }
+
+ $operator = self::COMPARISON_OPERATORS[$conditional->getOperatorType()];
+ $conditions = $this->adjustConditionsForCellReferences($conditional->getConditions());
+ $expression = sprintf('%s%s%s', (string) $this->wrapCellValue(), $operator, (string) array_pop($conditions));
+
+ return $this->evaluateExpression($expression);
+ }
+
+ protected function processRangeOperator(Conditional $conditional): bool
+ {
+ $conditions = $this->adjustConditionsForCellReferences($conditional->getConditions());
+ sort($conditions);
+ $expression = sprintf(
+ (string) preg_replace(
+ '/\bA1\b/i',
+ (string) $this->wrapCellValue(),
+ self::COMPARISON_RANGE_OPERATORS[$conditional->getOperatorType()]
+ ),
+ ...$conditions
+ );
+
+ return $this->evaluateExpression($expression);
+ }
+
+ protected function processDuplicatesComparison(Conditional $conditional): bool
+ {
+ $worksheetName = $this->cell->getWorksheet()->getTitle();
+
+ $expression = sprintf(
+ self::COMPARISON_DUPLICATES_OPERATORS[$conditional->getConditionType()],
+ $worksheetName,
+ $this->conditionalRange,
+ $this->cellConditionCheck($this->cell->getCalculatedValueString())
+ );
+
+ return $this->evaluateExpression($expression);
+ }
+
+ protected function processExpression(Conditional $conditional): bool
+ {
+ $conditions = $this->adjustConditionsForCellReferences($conditional->getConditions());
+ $expression = array_pop($conditions);
+
+ $expression = (string) preg_replace(
+ '/\b' . $this->referenceCell . '\b/i',
+ (string) $this->wrapCellValue(),
+ $expression
+ );
+
+ return $this->evaluateExpression($expression);
+ }
+
+ protected function evaluateExpression(string $expression): bool
+ {
+ $expression = "={$expression}";
+
+ try {
+ $this->engine->flushInstance();
+ $result = (bool) $this->engine->calculateFormula($expression);
+ } catch (Exception) {
+ return false;
+ }
+
+ return $result;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/CellStyleAssessor.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/CellStyleAssessor.php
new file mode 100644
index 00000000..bcf59dee
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/CellStyleAssessor.php
@@ -0,0 +1,38 @@
+cellMatcher = new CellMatcher($cell, $conditionalRange);
+ $this->styleMerger = new StyleMerger($cell->getStyle());
+ }
+
+ /**
+ * @param Conditional[] $conditionalStyles
+ */
+ public function matchConditions(array $conditionalStyles = []): Style
+ {
+ foreach ($conditionalStyles as $conditional) {
+ if ($this->cellMatcher->evaluateConditional($conditional) === true) {
+ // Merging the conditional style into the base style goes in here
+ $this->styleMerger->mergeStyle($conditional->getStyle());
+ if ($conditional->getStopIfTrue() === true) {
+ break;
+ }
+ }
+ }
+
+ return $this->styleMerger->getStyle();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalColorScale.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalColorScale.php
new file mode 100644
index 00000000..7fcc0803
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalColorScale.php
@@ -0,0 +1,92 @@
+minimumConditionalFormatValueObject;
+ }
+
+ public function setMinimumConditionalFormatValueObject(ConditionalFormatValueObject $minimumConditionalFormatValueObject): self
+ {
+ $this->minimumConditionalFormatValueObject = $minimumConditionalFormatValueObject;
+
+ return $this;
+ }
+
+ public function getMidpointConditionalFormatValueObject(): ?ConditionalFormatValueObject
+ {
+ return $this->midpointConditionalFormatValueObject;
+ }
+
+ public function setMidpointConditionalFormatValueObject(ConditionalFormatValueObject $midpointConditionalFormatValueObject): self
+ {
+ $this->midpointConditionalFormatValueObject = $midpointConditionalFormatValueObject;
+
+ return $this;
+ }
+
+ public function getMaximumConditionalFormatValueObject(): ?ConditionalFormatValueObject
+ {
+ return $this->maximumConditionalFormatValueObject;
+ }
+
+ public function setMaximumConditionalFormatValueObject(ConditionalFormatValueObject $maximumConditionalFormatValueObject): self
+ {
+ $this->maximumConditionalFormatValueObject = $maximumConditionalFormatValueObject;
+
+ return $this;
+ }
+
+ public function getMinimumColor(): ?Color
+ {
+ return $this->minimumColor;
+ }
+
+ public function setMinimumColor(Color $minimumColor): self
+ {
+ $this->minimumColor = $minimumColor;
+
+ return $this;
+ }
+
+ public function getMidpointColor(): ?Color
+ {
+ return $this->midpointColor;
+ }
+
+ public function setMidpointColor(Color $midpointColor): self
+ {
+ $this->midpointColor = $midpointColor;
+
+ return $this;
+ }
+
+ public function getMaximumColor(): ?Color
+ {
+ return $this->maximumColor;
+ }
+
+ public function setMaximumColor(Color $maximumColor): self
+ {
+ $this->maximumColor = $maximumColor;
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalDataBar.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalDataBar.php
new file mode 100644
index 00000000..370f1025
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalDataBar.php
@@ -0,0 +1,76 @@
+showValue;
+ }
+
+ public function setShowValue(bool $showValue): self
+ {
+ $this->showValue = $showValue;
+
+ return $this;
+ }
+
+ public function getMinimumConditionalFormatValueObject(): ?ConditionalFormatValueObject
+ {
+ return $this->minimumConditionalFormatValueObject;
+ }
+
+ public function setMinimumConditionalFormatValueObject(ConditionalFormatValueObject $minimumConditionalFormatValueObject): self
+ {
+ $this->minimumConditionalFormatValueObject = $minimumConditionalFormatValueObject;
+
+ return $this;
+ }
+
+ public function getMaximumConditionalFormatValueObject(): ?ConditionalFormatValueObject
+ {
+ return $this->maximumConditionalFormatValueObject;
+ }
+
+ public function setMaximumConditionalFormatValueObject(ConditionalFormatValueObject $maximumConditionalFormatValueObject): self
+ {
+ $this->maximumConditionalFormatValueObject = $maximumConditionalFormatValueObject;
+
+ return $this;
+ }
+
+ public function getColor(): string
+ {
+ return $this->color;
+ }
+
+ public function setColor(string $color): self
+ {
+ $this->color = $color;
+
+ return $this;
+ }
+
+ public function getConditionalFormattingRuleExt(): ?ConditionalFormattingRuleExtension
+ {
+ return $this->conditionalFormattingRuleExt;
+ }
+
+ public function setConditionalFormattingRuleExt(ConditionalFormattingRuleExtension $conditionalFormattingRuleExt): self
+ {
+ $this->conditionalFormattingRuleExt = $conditionalFormattingRuleExt;
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalDataBarExtension.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalDataBarExtension.php
new file mode 100644
index 00000000..28cd94bb
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalDataBarExtension.php
@@ -0,0 +1,235 @@
+ attributes */
+ private int $minLength;
+
+ private int $maxLength;
+
+ private ?bool $border = null;
+
+ private ?bool $gradient = null;
+
+ private ?string $direction = null;
+
+ private ?bool $negativeBarBorderColorSameAsPositive = null;
+
+ private ?string $axisPosition = null;
+
+ // children
+
+ private ConditionalFormatValueObject $maximumConditionalFormatValueObject;
+
+ private ConditionalFormatValueObject $minimumConditionalFormatValueObject;
+
+ private ?string $borderColor = null;
+
+ private ?string $negativeFillColor = null;
+
+ private ?string $negativeBorderColor = null;
+
+ private array $axisColor = [
+ 'rgb' => null,
+ 'theme' => null,
+ 'tint' => null,
+ ];
+
+ public function getXmlAttributes(): array
+ {
+ $ret = [];
+ foreach (['minLength', 'maxLength', 'direction', 'axisPosition'] as $attrKey) {
+ if (null !== $this->{$attrKey}) {
+ $ret[$attrKey] = $this->{$attrKey};
+ }
+ }
+ foreach (['border', 'gradient', 'negativeBarBorderColorSameAsPositive'] as $attrKey) {
+ if (null !== $this->{$attrKey}) {
+ $ret[$attrKey] = $this->{$attrKey} ? '1' : '0';
+ }
+ }
+
+ return $ret;
+ }
+
+ public function getXmlElements(): array
+ {
+ $ret = [];
+ $elms = ['borderColor', 'negativeFillColor', 'negativeBorderColor'];
+ foreach ($elms as $elmKey) {
+ if (null !== $this->{$elmKey}) {
+ $ret[$elmKey] = ['rgb' => $this->{$elmKey}];
+ }
+ }
+ foreach (array_filter($this->axisColor) as $attrKey => $axisColorAttr) {
+ if (!isset($ret['axisColor'])) {
+ $ret['axisColor'] = [];
+ }
+ $ret['axisColor'][$attrKey] = $axisColorAttr;
+ }
+
+ return $ret;
+ }
+
+ public function getMinLength(): int
+ {
+ return $this->minLength;
+ }
+
+ public function setMinLength(int $minLength): self
+ {
+ $this->minLength = $minLength;
+
+ return $this;
+ }
+
+ public function getMaxLength(): int
+ {
+ return $this->maxLength;
+ }
+
+ public function setMaxLength(int $maxLength): self
+ {
+ $this->maxLength = $maxLength;
+
+ return $this;
+ }
+
+ public function getBorder(): ?bool
+ {
+ return $this->border;
+ }
+
+ public function setBorder(bool $border): self
+ {
+ $this->border = $border;
+
+ return $this;
+ }
+
+ public function getGradient(): ?bool
+ {
+ return $this->gradient;
+ }
+
+ public function setGradient(bool $gradient): self
+ {
+ $this->gradient = $gradient;
+
+ return $this;
+ }
+
+ public function getDirection(): ?string
+ {
+ return $this->direction;
+ }
+
+ public function setDirection(string $direction): self
+ {
+ $this->direction = $direction;
+
+ return $this;
+ }
+
+ public function getNegativeBarBorderColorSameAsPositive(): ?bool
+ {
+ return $this->negativeBarBorderColorSameAsPositive;
+ }
+
+ public function setNegativeBarBorderColorSameAsPositive(bool $negativeBarBorderColorSameAsPositive): self
+ {
+ $this->negativeBarBorderColorSameAsPositive = $negativeBarBorderColorSameAsPositive;
+
+ return $this;
+ }
+
+ public function getAxisPosition(): ?string
+ {
+ return $this->axisPosition;
+ }
+
+ public function setAxisPosition(string $axisPosition): self
+ {
+ $this->axisPosition = $axisPosition;
+
+ return $this;
+ }
+
+ public function getMaximumConditionalFormatValueObject(): ConditionalFormatValueObject
+ {
+ return $this->maximumConditionalFormatValueObject;
+ }
+
+ public function setMaximumConditionalFormatValueObject(ConditionalFormatValueObject $maximumConditionalFormatValueObject): self
+ {
+ $this->maximumConditionalFormatValueObject = $maximumConditionalFormatValueObject;
+
+ return $this;
+ }
+
+ public function getMinimumConditionalFormatValueObject(): ConditionalFormatValueObject
+ {
+ return $this->minimumConditionalFormatValueObject;
+ }
+
+ public function setMinimumConditionalFormatValueObject(ConditionalFormatValueObject $minimumConditionalFormatValueObject): self
+ {
+ $this->minimumConditionalFormatValueObject = $minimumConditionalFormatValueObject;
+
+ return $this;
+ }
+
+ public function getBorderColor(): ?string
+ {
+ return $this->borderColor;
+ }
+
+ public function setBorderColor(string $borderColor): self
+ {
+ $this->borderColor = $borderColor;
+
+ return $this;
+ }
+
+ public function getNegativeFillColor(): ?string
+ {
+ return $this->negativeFillColor;
+ }
+
+ public function setNegativeFillColor(string $negativeFillColor): self
+ {
+ $this->negativeFillColor = $negativeFillColor;
+
+ return $this;
+ }
+
+ public function getNegativeBorderColor(): ?string
+ {
+ return $this->negativeBorderColor;
+ }
+
+ public function setNegativeBorderColor(string $negativeBorderColor): self
+ {
+ $this->negativeBorderColor = $negativeBorderColor;
+
+ return $this;
+ }
+
+ public function getAxisColor(): array
+ {
+ return $this->axisColor;
+ }
+
+ public function setAxisColor(mixed $rgb, mixed $theme = null, mixed $tint = null): self
+ {
+ $this->axisColor = [
+ 'rgb' => $rgb,
+ 'theme' => $theme,
+ 'tint' => $tint,
+ ];
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalFormatValueObject.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalFormatValueObject.php
new file mode 100644
index 00000000..e6d1035f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalFormatValueObject.php
@@ -0,0 +1,55 @@
+type = $type;
+ $this->value = $value;
+ $this->cellFormula = $cellFormula;
+ }
+
+ public function getType(): string
+ {
+ return $this->type;
+ }
+
+ public function setType(string $type): self
+ {
+ $this->type = $type;
+
+ return $this;
+ }
+
+ public function getValue(): null|float|int|string
+ {
+ return $this->value;
+ }
+
+ public function setValue(null|float|int|string $value): self
+ {
+ $this->value = $value;
+
+ return $this;
+ }
+
+ public function getCellFormula(): ?string
+ {
+ return $this->cellFormula;
+ }
+
+ public function setCellFormula(?string $cellFormula): self
+ {
+ $this->cellFormula = $cellFormula;
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalFormattingRuleExtension.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalFormattingRuleExtension.php
new file mode 100644
index 00000000..c6c648ba
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/ConditionalFormattingRuleExtension.php
@@ -0,0 +1,212 @@
+id = '{' . $this->generateUuid() . '}';
+ } else {
+ $this->id = $id;
+ }
+ $this->cfRule = $cfRule;
+ }
+
+ private function generateUuid(): string
+ {
+ $chars = str_split('xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx');
+
+ foreach ($chars as $i => $char) {
+ if ($char === 'x') {
+ $chars[$i] = dechex(random_int(0, 15));
+ } elseif ($char === 'y') {
+ $chars[$i] = dechex(random_int(8, 11));
+ }
+ }
+
+ return implode('', $chars);
+ }
+
+ public static function parseExtLstXml(?SimpleXMLElement $extLstXml): array
+ {
+ $conditionalFormattingRuleExtensions = [];
+ $conditionalFormattingRuleExtensionXml = null;
+ if ($extLstXml instanceof SimpleXMLElement) {
+ foreach ((count($extLstXml) > 0 ? $extLstXml : [$extLstXml]) as $extLst) {
+ //this uri is conditionalFormattings
+ //https://docs.microsoft.com/en-us/openspecs/office_standards/ms-xlsx/07d607af-5618-4ca2-b683-6a78dc0d9627
+ if (isset($extLst->ext['uri']) && (string) $extLst->ext['uri'] === '{78C0D931-6437-407d-A8EE-F0AAD7539E65}') {
+ $conditionalFormattingRuleExtensionXml = $extLst->ext;
+ }
+ }
+
+ if ($conditionalFormattingRuleExtensionXml) {
+ $ns = $conditionalFormattingRuleExtensionXml->getNamespaces(true);
+ $extFormattingsXml = $conditionalFormattingRuleExtensionXml->children($ns['x14']);
+
+ foreach ($extFormattingsXml->children($ns['x14']) as $extFormattingXml) {
+ $extCfRuleXml = $extFormattingXml->cfRule;
+ $attributes = $extCfRuleXml->attributes();
+ if (!$attributes || ((string) $attributes->type) !== Conditional::CONDITION_DATABAR) {
+ continue;
+ }
+
+ $extFormattingRuleObj = new self((string) $attributes->id);
+ $extFormattingRuleObj->setSqref((string) $extFormattingXml->children($ns['xm'])->sqref);
+ $conditionalFormattingRuleExtensions[$extFormattingRuleObj->getId()] = $extFormattingRuleObj;
+
+ $extDataBarObj = new ConditionalDataBarExtension();
+ $extFormattingRuleObj->setDataBarExt($extDataBarObj);
+ $dataBarXml = $extCfRuleXml->dataBar;
+ self::parseExtDataBarAttributesFromXml($extDataBarObj, $dataBarXml);
+ self::parseExtDataBarElementChildrenFromXml($extDataBarObj, $dataBarXml, $ns);
+ }
+ }
+ }
+
+ return $conditionalFormattingRuleExtensions;
+ }
+
+ private static function parseExtDataBarAttributesFromXml(
+ ConditionalDataBarExtension $extDataBarObj,
+ SimpleXMLElement $dataBarXml
+ ): void {
+ $dataBarAttribute = $dataBarXml->attributes();
+ if ($dataBarAttribute === null) {
+ return;
+ }
+ if ($dataBarAttribute->minLength) {
+ $extDataBarObj->setMinLength((int) $dataBarAttribute->minLength);
+ }
+ if ($dataBarAttribute->maxLength) {
+ $extDataBarObj->setMaxLength((int) $dataBarAttribute->maxLength);
+ }
+ if ($dataBarAttribute->border) {
+ $extDataBarObj->setBorder((bool) (string) $dataBarAttribute->border);
+ }
+ if ($dataBarAttribute->gradient) {
+ $extDataBarObj->setGradient((bool) (string) $dataBarAttribute->gradient);
+ }
+ if ($dataBarAttribute->direction) {
+ $extDataBarObj->setDirection((string) $dataBarAttribute->direction);
+ }
+ if ($dataBarAttribute->negativeBarBorderColorSameAsPositive) {
+ $extDataBarObj->setNegativeBarBorderColorSameAsPositive((bool) (string) $dataBarAttribute->negativeBarBorderColorSameAsPositive);
+ }
+ if ($dataBarAttribute->axisPosition) {
+ $extDataBarObj->setAxisPosition((string) $dataBarAttribute->axisPosition);
+ }
+ }
+
+ private static function parseExtDataBarElementChildrenFromXml(ConditionalDataBarExtension $extDataBarObj, SimpleXMLElement $dataBarXml, array $ns): void
+ {
+ if ($dataBarXml->borderColor) {
+ $attributes = $dataBarXml->borderColor->attributes();
+ if ($attributes !== null) {
+ $extDataBarObj->setBorderColor((string) $attributes['rgb']);
+ }
+ }
+ if ($dataBarXml->negativeFillColor) {
+ $attributes = $dataBarXml->negativeFillColor->attributes();
+ if ($attributes !== null) {
+ $extDataBarObj->setNegativeFillColor((string) $attributes['rgb']);
+ }
+ }
+ if ($dataBarXml->negativeBorderColor) {
+ $attributes = $dataBarXml->negativeBorderColor->attributes();
+ if ($attributes !== null) {
+ $extDataBarObj->setNegativeBorderColor((string) $attributes['rgb']);
+ }
+ }
+ if ($dataBarXml->axisColor) {
+ $axisColorAttr = $dataBarXml->axisColor->attributes();
+ if ($axisColorAttr !== null) {
+ $extDataBarObj->setAxisColor((string) $axisColorAttr['rgb'], (string) $axisColorAttr['theme'], (string) $axisColorAttr['tint']);
+ }
+ }
+ $cfvoIndex = 0;
+ foreach ($dataBarXml->cfvo as $cfvo) {
+ $f = (string) $cfvo->children($ns['xm'])->f;
+ $attributes = $cfvo->attributes();
+ if (!($attributes)) {
+ continue;
+ }
+
+ if ($cfvoIndex === 0) {
+ $extDataBarObj->setMinimumConditionalFormatValueObject(new ConditionalFormatValueObject((string) $attributes['type'], null, (empty($f) ? null : $f)));
+ }
+ if ($cfvoIndex === 1) {
+ $extDataBarObj->setMaximumConditionalFormatValueObject(new ConditionalFormatValueObject((string) $attributes['type'], null, (empty($f) ? null : $f)));
+ }
+ ++$cfvoIndex;
+ }
+ }
+
+ public function getId(): string
+ {
+ return $this->id;
+ }
+
+ public function setId(string $id): self
+ {
+ $this->id = $id;
+
+ return $this;
+ }
+
+ public function getCfRule(): string
+ {
+ return $this->cfRule;
+ }
+
+ public function setCfRule(string $cfRule): self
+ {
+ $this->cfRule = $cfRule;
+
+ return $this;
+ }
+
+ public function getDataBarExt(): ConditionalDataBarExtension
+ {
+ return $this->dataBar;
+ }
+
+ public function setDataBarExt(ConditionalDataBarExtension $dataBar): self
+ {
+ $this->dataBar = $dataBar;
+
+ return $this;
+ }
+
+ public function getSqref(): string
+ {
+ return $this->sqref;
+ }
+
+ public function setSqref(string $sqref): self
+ {
+ $this->sqref = $sqref;
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/StyleMerger.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/StyleMerger.php
new file mode 100644
index 00000000..9388848e
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/StyleMerger.php
@@ -0,0 +1,115 @@
+baseStyle = $baseStyle;
+ }
+
+ public function getStyle(): Style
+ {
+ return $this->baseStyle;
+ }
+
+ public function mergeStyle(Style $style): void
+ {
+ if ($style->getNumberFormat() !== null && $style->getNumberFormat()->getFormatCode() !== null) {
+ $this->baseStyle->getNumberFormat()->setFormatCode($style->getNumberFormat()->getFormatCode());
+ }
+
+ if ($style->getFont() !== null) {
+ $this->mergeFontStyle($this->baseStyle->getFont(), $style->getFont());
+ }
+
+ if ($style->getFill() !== null) {
+ $this->mergeFillStyle($this->baseStyle->getFill(), $style->getFill());
+ }
+
+ if ($style->getBorders() !== null) {
+ $this->mergeBordersStyle($this->baseStyle->getBorders(), $style->getBorders());
+ }
+ }
+
+ protected function mergeFontStyle(Font $baseFontStyle, Font $fontStyle): void
+ {
+ if ($fontStyle->getBold() !== null) {
+ $baseFontStyle->setBold($fontStyle->getBold());
+ }
+
+ if ($fontStyle->getItalic() !== null) {
+ $baseFontStyle->setItalic($fontStyle->getItalic());
+ }
+
+ if ($fontStyle->getStrikethrough() !== null) {
+ $baseFontStyle->setStrikethrough($fontStyle->getStrikethrough());
+ }
+
+ if ($fontStyle->getUnderline() !== null) {
+ $baseFontStyle->setUnderline($fontStyle->getUnderline());
+ }
+
+ if ($fontStyle->getColor() !== null && $fontStyle->getColor()->getARGB() !== null) {
+ $baseFontStyle->setColor($fontStyle->getColor());
+ }
+ }
+
+ protected function mergeFillStyle(Fill $baseFillStyle, Fill $fillStyle): void
+ {
+ if ($fillStyle->getFillType() !== null) {
+ $baseFillStyle->setFillType($fillStyle->getFillType());
+ }
+
+ //if ($fillStyle->getRotation() !== null) {
+ $baseFillStyle->setRotation($fillStyle->getRotation());
+ //}
+
+ if ($fillStyle->getStartColor() !== null && $fillStyle->getStartColor()->getARGB() !== null) {
+ $baseFillStyle->setStartColor($fillStyle->getStartColor());
+ }
+
+ if ($fillStyle->getEndColor() !== null && $fillStyle->getEndColor()->getARGB() !== null) {
+ $baseFillStyle->setEndColor($fillStyle->getEndColor());
+ }
+ }
+
+ protected function mergeBordersStyle(Borders $baseBordersStyle, Borders $bordersStyle): void
+ {
+ if ($bordersStyle->getTop() !== null) {
+ $this->mergeBorderStyle($baseBordersStyle->getTop(), $bordersStyle->getTop());
+ }
+
+ if ($bordersStyle->getBottom() !== null) {
+ $this->mergeBorderStyle($baseBordersStyle->getBottom(), $bordersStyle->getBottom());
+ }
+
+ if ($bordersStyle->getLeft() !== null) {
+ $this->mergeBorderStyle($baseBordersStyle->getLeft(), $bordersStyle->getLeft());
+ }
+
+ if ($bordersStyle->getRight() !== null) {
+ $this->mergeBorderStyle($baseBordersStyle->getRight(), $bordersStyle->getRight());
+ }
+ }
+
+ protected function mergeBorderStyle(Border $baseBorderStyle, Border $borderStyle): void
+ {
+ //if ($borderStyle->getBorderStyle() !== null) {
+ $baseBorderStyle->setBorderStyle($borderStyle->getBorderStyle());
+ //}
+
+ if ($borderStyle->getColor() !== null && $borderStyle->getColor()->getARGB() !== null) {
+ $baseBorderStyle->setColor($borderStyle->getColor());
+ }
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard.php
new file mode 100644
index 00000000..2791a2b9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard.php
@@ -0,0 +1,66 @@
+cellRange = $cellRange;
+ }
+
+ public function newRule(string $ruleType): WizardInterface
+ {
+ return match ($ruleType) {
+ self::CELL_VALUE => new Wizard\CellValue($this->cellRange),
+ self::TEXT_VALUE => new Wizard\TextValue($this->cellRange),
+ self::BLANKS => new Wizard\Blanks($this->cellRange, true),
+ self::NOT_BLANKS => new Wizard\Blanks($this->cellRange, false),
+ self::ERRORS => new Wizard\Errors($this->cellRange, true),
+ self::NOT_ERRORS => new Wizard\Errors($this->cellRange, false),
+ self::EXPRESSION, self::FORMULA => new Wizard\Expression($this->cellRange),
+ self::DATES_OCCURRING => new Wizard\DateValue($this->cellRange),
+ self::DUPLICATES => new Wizard\Duplicates($this->cellRange, false),
+ self::UNIQUE => new Wizard\Duplicates($this->cellRange, true),
+ default => throw new Exception('No wizard exists for this CF rule type'),
+ };
+ }
+
+ public static function fromConditional(Conditional $conditional, string $cellRange = 'A1'): WizardInterface
+ {
+ $conditionalType = $conditional->getConditionType();
+
+ return match ($conditionalType) {
+ Conditional::CONDITION_CELLIS => Wizard\CellValue::fromConditional($conditional, $cellRange),
+ Conditional::CONDITION_CONTAINSTEXT, Conditional::CONDITION_NOTCONTAINSTEXT, Conditional::CONDITION_BEGINSWITH, Conditional::CONDITION_ENDSWITH => Wizard\TextValue::fromConditional($conditional, $cellRange),
+ Conditional::CONDITION_CONTAINSBLANKS, Conditional::CONDITION_NOTCONTAINSBLANKS => Wizard\Blanks::fromConditional($conditional, $cellRange),
+ Conditional::CONDITION_CONTAINSERRORS, Conditional::CONDITION_NOTCONTAINSERRORS => Wizard\Errors::fromConditional($conditional, $cellRange),
+ Conditional::CONDITION_TIMEPERIOD => Wizard\DateValue::fromConditional($conditional, $cellRange),
+ Conditional::CONDITION_EXPRESSION => Wizard\Expression::fromConditional($conditional, $cellRange),
+ Conditional::CONDITION_DUPLICATES, Conditional::CONDITION_UNIQUE => Wizard\Duplicates::fromConditional($conditional, $cellRange),
+ default => throw new Exception('No wizard exists for this CF rule type'),
+ };
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Blanks.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Blanks.php
new file mode 100644
index 00000000..5a8fe9b9
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Blanks.php
@@ -0,0 +1,95 @@
+ false,
+ 'isBlank' => true,
+ 'notEmpty' => false,
+ 'empty' => true,
+ ];
+
+ protected const EXPRESSIONS = [
+ Wizard::NOT_BLANKS => 'LEN(TRIM(%s))>0',
+ Wizard::BLANKS => 'LEN(TRIM(%s))=0',
+ ];
+
+ protected bool $inverse;
+
+ public function __construct(string $cellRange, bool $inverse = false)
+ {
+ parent::__construct($cellRange);
+ $this->inverse = $inverse;
+ }
+
+ protected function inverse(bool $inverse): void
+ {
+ $this->inverse = $inverse;
+ }
+
+ protected function getExpression(): void
+ {
+ $this->expression = sprintf(
+ self::EXPRESSIONS[$this->inverse ? Wizard::BLANKS : Wizard::NOT_BLANKS],
+ $this->referenceCell
+ );
+ }
+
+ public function getConditional(): Conditional
+ {
+ $this->getExpression();
+
+ $conditional = new Conditional();
+ $conditional->setConditionType(
+ $this->inverse ? Conditional::CONDITION_CONTAINSBLANKS : Conditional::CONDITION_NOTCONTAINSBLANKS
+ );
+ $conditional->setConditions([$this->expression]);
+ $conditional->setStyle($this->getStyle());
+ $conditional->setStopIfTrue($this->getStopIfTrue());
+
+ return $conditional;
+ }
+
+ public static function fromConditional(Conditional $conditional, string $cellRange = 'A1'): WizardInterface
+ {
+ if (
+ $conditional->getConditionType() !== Conditional::CONDITION_CONTAINSBLANKS
+ && $conditional->getConditionType() !== Conditional::CONDITION_NOTCONTAINSBLANKS
+ ) {
+ throw new Exception('Conditional is not a Blanks CF Rule conditional');
+ }
+
+ $wizard = new self($cellRange);
+ $wizard->style = $conditional->getStyle();
+ $wizard->stopIfTrue = $conditional->getStopIfTrue();
+ $wizard->inverse = $conditional->getConditionType() === Conditional::CONDITION_CONTAINSBLANKS;
+
+ return $wizard;
+ }
+
+ /**
+ * @param mixed[] $arguments
+ */
+ public function __call(string $methodName, array $arguments): self
+ {
+ if (!array_key_exists($methodName, self::OPERATORS)) {
+ throw new Exception('Invalid Operation for Blanks CF Rule Wizard');
+ }
+
+ $this->inverse(self::OPERATORS[$methodName]);
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/CellValue.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/CellValue.php
new file mode 100644
index 00000000..63f360b4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/CellValue.php
@@ -0,0 +1,186 @@
+ Conditional::OPERATOR_EQUAL,
+ 'notEquals' => Conditional::OPERATOR_NOTEQUAL,
+ 'greaterThan' => Conditional::OPERATOR_GREATERTHAN,
+ 'greaterThanOrEqual' => Conditional::OPERATOR_GREATERTHANOREQUAL,
+ 'lessThan' => Conditional::OPERATOR_LESSTHAN,
+ 'lessThanOrEqual' => Conditional::OPERATOR_LESSTHANOREQUAL,
+ 'between' => Conditional::OPERATOR_BETWEEN,
+ 'notBetween' => Conditional::OPERATOR_NOTBETWEEN,
+ ];
+
+ protected const SINGLE_OPERATORS = CellMatcher::COMPARISON_OPERATORS;
+
+ protected const RANGE_OPERATORS = CellMatcher::COMPARISON_RANGE_OPERATORS;
+
+ protected string $operator = Conditional::OPERATOR_EQUAL;
+
+ protected array $operand = [0];
+
+ /**
+ * @var string[]
+ */
+ protected array $operandValueType = [];
+
+ public function __construct(string $cellRange)
+ {
+ parent::__construct($cellRange);
+ }
+
+ protected function operator(string $operator): void
+ {
+ if ((!isset(self::SINGLE_OPERATORS[$operator])) && (!isset(self::RANGE_OPERATORS[$operator]))) {
+ throw new Exception('Invalid Operator for Cell Value CF Rule Wizard');
+ }
+
+ $this->operator = $operator;
+ }
+
+ protected function operand(int $index, mixed $operand, string $operandValueType = Wizard::VALUE_TYPE_LITERAL): void
+ {
+ if (is_string($operand)) {
+ $operand = $this->validateOperand($operand, $operandValueType);
+ }
+
+ $this->operand[$index] = $operand;
+ $this->operandValueType[$index] = $operandValueType;
+ }
+
+ /** @param null|bool|float|int|string $value value to be wrapped */
+ protected function wrapValue(mixed $value, string $operandValueType): float|int|string
+ {
+ if (!is_numeric($value) && !is_bool($value) && null !== $value) {
+ if ($operandValueType === Wizard::VALUE_TYPE_LITERAL) {
+ return '"' . str_replace('"', '""', $value) . '"';
+ }
+
+ return $this->cellConditionCheck($value);
+ }
+
+ if (null === $value) {
+ $value = 'NULL';
+ } elseif (is_bool($value)) {
+ $value = $value ? 'TRUE' : 'FALSE';
+ }
+
+ return $value;
+ }
+
+ public function getConditional(): Conditional
+ {
+ if (!isset(self::RANGE_OPERATORS[$this->operator])) {
+ unset($this->operand[1], $this->operandValueType[1]);
+ }
+ $values = array_map([$this, 'wrapValue'], $this->operand, $this->operandValueType);
+
+ $conditional = new Conditional();
+ $conditional->setConditionType(Conditional::CONDITION_CELLIS);
+ $conditional->setOperatorType($this->operator);
+ $conditional->setConditions($values);
+ $conditional->setStyle($this->getStyle());
+ $conditional->setStopIfTrue($this->getStopIfTrue());
+
+ return $conditional;
+ }
+
+ protected static function unwrapString(string $condition): string
+ {
+ if ((str_starts_with($condition, '"')) && (str_starts_with(strrev($condition), '"'))) {
+ $condition = substr($condition, 1, -1);
+ }
+
+ return str_replace('""', '"', $condition);
+ }
+
+ public static function fromConditional(Conditional $conditional, string $cellRange = 'A1'): WizardInterface
+ {
+ if ($conditional->getConditionType() !== Conditional::CONDITION_CELLIS) {
+ throw new Exception('Conditional is not a Cell Value CF Rule conditional');
+ }
+
+ $wizard = new self($cellRange);
+ $wizard->style = $conditional->getStyle();
+ $wizard->stopIfTrue = $conditional->getStopIfTrue();
+
+ $wizard->operator = $conditional->getOperatorType();
+ $conditions = $conditional->getConditions();
+ foreach ($conditions as $index => $condition) {
+ // Best-guess to try and identify if the text is a string literal, a cell reference or a formula?
+ $operandValueType = Wizard::VALUE_TYPE_LITERAL;
+ if (is_string($condition)) {
+ if (Calculation::keyInExcelConstants($condition)) {
+ $condition = Calculation::getExcelConstants($condition);
+ } elseif (preg_match('/^' . Calculation::CALCULATION_REGEXP_CELLREF_RELATIVE . '$/i', $condition)) {
+ $operandValueType = Wizard::VALUE_TYPE_CELL;
+ $condition = self::reverseAdjustCellRef($condition, $cellRange);
+ } elseif (
+ preg_match('/\(\)/', $condition)
+ || preg_match('/' . Calculation::CALCULATION_REGEXP_CELLREF_RELATIVE . '/i', $condition)
+ ) {
+ $operandValueType = Wizard::VALUE_TYPE_FORMULA;
+ $condition = self::reverseAdjustCellRef($condition, $cellRange);
+ } else {
+ $condition = self::unwrapString($condition);
+ }
+ }
+ $wizard->operand($index, $condition, $operandValueType);
+ }
+
+ return $wizard;
+ }
+
+ /**
+ * @param mixed[] $arguments
+ */
+ public function __call(string $methodName, array $arguments): self
+ {
+ if (!isset(self::MAGIC_OPERATIONS[$methodName]) && $methodName !== 'and') {
+ throw new Exception('Invalid Operator for Cell Value CF Rule Wizard');
+ }
+
+ if ($methodName === 'and') {
+ if (!isset(self::RANGE_OPERATORS[$this->operator])) {
+ throw new Exception('AND Value is only appropriate for range operators');
+ }
+
+ $this->operand(1, ...$arguments);
+
+ return $this;
+ }
+
+ $this->operator(self::MAGIC_OPERATIONS[$methodName]);
+ //$this->operand(0, ...$arguments);
+ if (count($arguments) < 2) {
+ $this->operand(0, $arguments[0]);
+ } else {
+ /** @var string */
+ $arg1 = $arguments[1];
+ $this->operand(0, $arguments[0], $arg1);
+ }
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/DateValue.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/DateValue.php
new file mode 100644
index 00000000..23477e9c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/DateValue.php
@@ -0,0 +1,109 @@
+ Conditional::TIMEPERIOD_YESTERDAY,
+ 'today' => Conditional::TIMEPERIOD_TODAY,
+ 'tomorrow' => Conditional::TIMEPERIOD_TOMORROW,
+ 'lastSevenDays' => Conditional::TIMEPERIOD_LAST_7_DAYS,
+ 'last7Days' => Conditional::TIMEPERIOD_LAST_7_DAYS,
+ 'lastWeek' => Conditional::TIMEPERIOD_LAST_WEEK,
+ 'thisWeek' => Conditional::TIMEPERIOD_THIS_WEEK,
+ 'nextWeek' => Conditional::TIMEPERIOD_NEXT_WEEK,
+ 'lastMonth' => Conditional::TIMEPERIOD_LAST_MONTH,
+ 'thisMonth' => Conditional::TIMEPERIOD_THIS_MONTH,
+ 'nextMonth' => Conditional::TIMEPERIOD_NEXT_MONTH,
+ ];
+
+ protected const EXPRESSIONS = [
+ Conditional::TIMEPERIOD_YESTERDAY => 'FLOOR(%s,1)=TODAY()-1',
+ Conditional::TIMEPERIOD_TODAY => 'FLOOR(%s,1)=TODAY()',
+ Conditional::TIMEPERIOD_TOMORROW => 'FLOOR(%s,1)=TODAY()+1',
+ Conditional::TIMEPERIOD_LAST_7_DAYS => 'AND(TODAY()-FLOOR(%s,1)<=6,FLOOR(%s,1)<=TODAY())',
+ Conditional::TIMEPERIOD_LAST_WEEK => 'AND(TODAY()-ROUNDDOWN(%s,0)>=(WEEKDAY(TODAY())),TODAY()-ROUNDDOWN(%s,0)<(WEEKDAY(TODAY())+7))',
+ Conditional::TIMEPERIOD_THIS_WEEK => 'AND(TODAY()-ROUNDDOWN(%s,0)<=WEEKDAY(TODAY())-1,ROUNDDOWN(%s,0)-TODAY()<=7-WEEKDAY(TODAY()))',
+ Conditional::TIMEPERIOD_NEXT_WEEK => 'AND(ROUNDDOWN(%s,0)-TODAY()>(7-WEEKDAY(TODAY())),ROUNDDOWN(%s,0)-TODAY()<(15-WEEKDAY(TODAY())))',
+ Conditional::TIMEPERIOD_LAST_MONTH => 'AND(MONTH(%s)=MONTH(EDATE(TODAY(),0-1)),YEAR(%s)=YEAR(EDATE(TODAY(),0-1)))',
+ Conditional::TIMEPERIOD_THIS_MONTH => 'AND(MONTH(%s)=MONTH(TODAY()),YEAR(%s)=YEAR(TODAY()))',
+ Conditional::TIMEPERIOD_NEXT_MONTH => 'AND(MONTH(%s)=MONTH(EDATE(TODAY(),0+1)),YEAR(%s)=YEAR(EDATE(TODAY(),0+1)))',
+ ];
+
+ protected string $operator;
+
+ public function __construct(string $cellRange)
+ {
+ parent::__construct($cellRange);
+ }
+
+ protected function operator(string $operator): void
+ {
+ $this->operator = $operator;
+ }
+
+ protected function setExpression(): void
+ {
+ $referenceCount = substr_count(self::EXPRESSIONS[$this->operator], '%s');
+ $references = array_fill(0, $referenceCount, $this->referenceCell);
+ $this->expression = sprintf(self::EXPRESSIONS[$this->operator], ...$references);
+ }
+
+ public function getConditional(): Conditional
+ {
+ $this->setExpression();
+
+ $conditional = new Conditional();
+ $conditional->setConditionType(Conditional::CONDITION_TIMEPERIOD);
+ $conditional->setText($this->operator);
+ $conditional->setConditions([$this->expression]);
+ $conditional->setStyle($this->getStyle());
+ $conditional->setStopIfTrue($this->getStopIfTrue());
+
+ return $conditional;
+ }
+
+ public static function fromConditional(Conditional $conditional, string $cellRange = 'A1'): WizardInterface
+ {
+ if ($conditional->getConditionType() !== Conditional::CONDITION_TIMEPERIOD) {
+ throw new Exception('Conditional is not a Date Value CF Rule conditional');
+ }
+
+ $wizard = new self($cellRange);
+ $wizard->style = $conditional->getStyle();
+ $wizard->stopIfTrue = $conditional->getStopIfTrue();
+ $wizard->operator = $conditional->getText();
+
+ return $wizard;
+ }
+
+ /**
+ * @param mixed[] $arguments
+ */
+ public function __call(string $methodName, array $arguments): self
+ {
+ if (!isset(self::MAGIC_OPERATIONS[$methodName])) {
+ throw new Exception('Invalid Operation for Date Value CF Rule Wizard');
+ }
+
+ $this->operator(self::MAGIC_OPERATIONS[$methodName]);
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Duplicates.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Duplicates.php
new file mode 100644
index 00000000..0fbeddbb
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Duplicates.php
@@ -0,0 +1,74 @@
+ false,
+ 'unique' => true,
+ ];
+
+ protected bool $inverse;
+
+ public function __construct(string $cellRange, bool $inverse = false)
+ {
+ parent::__construct($cellRange);
+ $this->inverse = $inverse;
+ }
+
+ protected function inverse(bool $inverse): void
+ {
+ $this->inverse = $inverse;
+ }
+
+ public function getConditional(): Conditional
+ {
+ $conditional = new Conditional();
+ $conditional->setConditionType(
+ $this->inverse ? Conditional::CONDITION_UNIQUE : Conditional::CONDITION_DUPLICATES
+ );
+ $conditional->setStyle($this->getStyle());
+ $conditional->setStopIfTrue($this->getStopIfTrue());
+
+ return $conditional;
+ }
+
+ public static function fromConditional(Conditional $conditional, string $cellRange = 'A1'): WizardInterface
+ {
+ if (
+ $conditional->getConditionType() !== Conditional::CONDITION_DUPLICATES
+ && $conditional->getConditionType() !== Conditional::CONDITION_UNIQUE
+ ) {
+ throw new Exception('Conditional is not a Duplicates CF Rule conditional');
+ }
+
+ $wizard = new self($cellRange);
+ $wizard->style = $conditional->getStyle();
+ $wizard->stopIfTrue = $conditional->getStopIfTrue();
+ $wizard->inverse = $conditional->getConditionType() === Conditional::CONDITION_UNIQUE;
+
+ return $wizard;
+ }
+
+ /**
+ * @param mixed[] $arguments
+ */
+ public function __call(string $methodName, array $arguments): self
+ {
+ if (!array_key_exists($methodName, self::OPERATORS)) {
+ throw new Exception('Invalid Operation for Errors CF Rule Wizard');
+ }
+
+ $this->inverse(self::OPERATORS[$methodName]);
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Errors.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Errors.php
new file mode 100644
index 00000000..03a2381d
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Errors.php
@@ -0,0 +1,91 @@
+ false,
+ 'isError' => true,
+ ];
+
+ protected const EXPRESSIONS = [
+ Wizard::NOT_ERRORS => 'NOT(ISERROR(%s))',
+ Wizard::ERRORS => 'ISERROR(%s)',
+ ];
+
+ protected bool $inverse;
+
+ public function __construct(string $cellRange, bool $inverse = false)
+ {
+ parent::__construct($cellRange);
+ $this->inverse = $inverse;
+ }
+
+ protected function inverse(bool $inverse): void
+ {
+ $this->inverse = $inverse;
+ }
+
+ protected function getExpression(): void
+ {
+ $this->expression = sprintf(
+ self::EXPRESSIONS[$this->inverse ? Wizard::ERRORS : Wizard::NOT_ERRORS],
+ $this->referenceCell
+ );
+ }
+
+ public function getConditional(): Conditional
+ {
+ $this->getExpression();
+
+ $conditional = new Conditional();
+ $conditional->setConditionType(
+ $this->inverse ? Conditional::CONDITION_CONTAINSERRORS : Conditional::CONDITION_NOTCONTAINSERRORS
+ );
+ $conditional->setConditions([$this->expression]);
+ $conditional->setStyle($this->getStyle());
+ $conditional->setStopIfTrue($this->getStopIfTrue());
+
+ return $conditional;
+ }
+
+ public static function fromConditional(Conditional $conditional, string $cellRange = 'A1'): WizardInterface
+ {
+ if (
+ $conditional->getConditionType() !== Conditional::CONDITION_CONTAINSERRORS
+ && $conditional->getConditionType() !== Conditional::CONDITION_NOTCONTAINSERRORS
+ ) {
+ throw new Exception('Conditional is not an Errors CF Rule conditional');
+ }
+
+ $wizard = new self($cellRange);
+ $wizard->style = $conditional->getStyle();
+ $wizard->stopIfTrue = $conditional->getStopIfTrue();
+ $wizard->inverse = $conditional->getConditionType() === Conditional::CONDITION_CONTAINSERRORS;
+
+ return $wizard;
+ }
+
+ /**
+ * @param mixed[] $arguments
+ */
+ public function __call(string $methodName, array $arguments): self
+ {
+ if (!array_key_exists($methodName, self::OPERATORS)) {
+ throw new Exception('Invalid Operation for Errors CF Rule Wizard');
+ }
+
+ $this->inverse(self::OPERATORS[$methodName]);
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Expression.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Expression.php
new file mode 100644
index 00000000..3f954411
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/Expression.php
@@ -0,0 +1,69 @@
+validateOperand($expression, Wizard::VALUE_TYPE_FORMULA);
+ $this->expression = $expression;
+
+ return $this;
+ }
+
+ public function getConditional(): Conditional
+ {
+ $expression = $this->adjustConditionsForCellReferences([$this->expression]);
+
+ $conditional = new Conditional();
+ $conditional->setConditionType(Conditional::CONDITION_EXPRESSION);
+ $conditional->setConditions($expression);
+ $conditional->setStyle($this->getStyle());
+ $conditional->setStopIfTrue($this->getStopIfTrue());
+
+ return $conditional;
+ }
+
+ public static function fromConditional(Conditional $conditional, string $cellRange = 'A1'): WizardInterface
+ {
+ if ($conditional->getConditionType() !== Conditional::CONDITION_EXPRESSION) {
+ throw new Exception('Conditional is not an Expression CF Rule conditional');
+ }
+
+ $wizard = new self($cellRange);
+ $wizard->style = $conditional->getStyle();
+ $wizard->stopIfTrue = $conditional->getStopIfTrue();
+ $wizard->expression = self::reverseAdjustCellRef((string) ($conditional->getConditions()[0]), $cellRange);
+
+ return $wizard;
+ }
+
+ /**
+ * @param string[] $arguments
+ */
+ public function __call(string $methodName, array $arguments): self
+ {
+ if ($methodName !== 'formula') {
+ throw new Exception('Invalid Operation for Expression CF Rule Wizard');
+ }
+
+ $this->expression(...$arguments);
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/TextValue.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/TextValue.php
new file mode 100644
index 00000000..b25c4f42
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/TextValue.php
@@ -0,0 +1,164 @@
+ Conditional::OPERATOR_CONTAINSTEXT,
+ 'doesntContain' => Conditional::OPERATOR_NOTCONTAINS,
+ 'doesNotContain' => Conditional::OPERATOR_NOTCONTAINS,
+ 'beginsWith' => Conditional::OPERATOR_BEGINSWITH,
+ 'startsWith' => Conditional::OPERATOR_BEGINSWITH,
+ 'endsWith' => Conditional::OPERATOR_ENDSWITH,
+ ];
+
+ protected const OPERATORS = [
+ Conditional::OPERATOR_CONTAINSTEXT => Conditional::CONDITION_CONTAINSTEXT,
+ Conditional::OPERATOR_NOTCONTAINS => Conditional::CONDITION_NOTCONTAINSTEXT,
+ Conditional::OPERATOR_BEGINSWITH => Conditional::CONDITION_BEGINSWITH,
+ Conditional::OPERATOR_ENDSWITH => Conditional::CONDITION_ENDSWITH,
+ ];
+
+ protected const EXPRESSIONS = [
+ Conditional::OPERATOR_CONTAINSTEXT => 'NOT(ISERROR(SEARCH(%s,%s)))',
+ Conditional::OPERATOR_NOTCONTAINS => 'ISERROR(SEARCH(%s,%s))',
+ Conditional::OPERATOR_BEGINSWITH => 'LEFT(%s,LEN(%s))=%s',
+ Conditional::OPERATOR_ENDSWITH => 'RIGHT(%s,LEN(%s))=%s',
+ ];
+
+ protected string $operator;
+
+ protected string $operand;
+
+ protected string $operandValueType;
+
+ public function __construct(string $cellRange)
+ {
+ parent::__construct($cellRange);
+ }
+
+ protected function operator(string $operator): void
+ {
+ if (!isset(self::OPERATORS[$operator])) {
+ throw new Exception('Invalid Operator for Text Value CF Rule Wizard');
+ }
+
+ $this->operator = $operator;
+ }
+
+ protected function operand(string $operand, string $operandValueType = Wizard::VALUE_TYPE_LITERAL): void
+ {
+ $operand = $this->validateOperand($operand, $operandValueType);
+
+ $this->operand = $operand;
+ $this->operandValueType = $operandValueType;
+ }
+
+ protected function wrapValue(string $value): string
+ {
+ return '"' . $value . '"';
+ }
+
+ protected function setExpression(): void
+ {
+ $operand = $this->operandValueType === Wizard::VALUE_TYPE_LITERAL
+ ? $this->wrapValue(str_replace('"', '""', $this->operand))
+ : $this->cellConditionCheck($this->operand);
+
+ if (
+ $this->operator === Conditional::OPERATOR_CONTAINSTEXT
+ || $this->operator === Conditional::OPERATOR_NOTCONTAINS
+ ) {
+ $this->expression = sprintf(self::EXPRESSIONS[$this->operator], $operand, $this->referenceCell);
+ } else {
+ $this->expression = sprintf(self::EXPRESSIONS[$this->operator], $this->referenceCell, $operand, $operand);
+ }
+ }
+
+ public function getConditional(): Conditional
+ {
+ $this->setExpression();
+
+ $conditional = new Conditional();
+ $conditional->setConditionType(self::OPERATORS[$this->operator]);
+ $conditional->setOperatorType($this->operator);
+ $conditional->setText(
+ $this->operandValueType !== Wizard::VALUE_TYPE_LITERAL
+ ? $this->cellConditionCheck($this->operand)
+ : $this->operand
+ );
+ $conditional->setConditions([$this->expression]);
+ $conditional->setStyle($this->getStyle());
+ $conditional->setStopIfTrue($this->getStopIfTrue());
+
+ return $conditional;
+ }
+
+ public static function fromConditional(Conditional $conditional, string $cellRange = 'A1'): WizardInterface
+ {
+ if (!in_array($conditional->getConditionType(), self::OPERATORS, true)) {
+ throw new Exception('Conditional is not a Text Value CF Rule conditional');
+ }
+
+ $wizard = new self($cellRange);
+ $wizard->operator = (string) array_search($conditional->getConditionType(), self::OPERATORS, true);
+ $wizard->style = $conditional->getStyle();
+ $wizard->stopIfTrue = $conditional->getStopIfTrue();
+
+ // Best-guess to try and identify if the text is a string literal, a cell reference or a formula?
+ $wizard->operandValueType = Wizard::VALUE_TYPE_LITERAL;
+ $condition = $conditional->getText();
+ if (preg_match('/^' . Calculation::CALCULATION_REGEXP_CELLREF_RELATIVE . '$/i', $condition)) {
+ $wizard->operandValueType = Wizard::VALUE_TYPE_CELL;
+ $condition = self::reverseAdjustCellRef($condition, $cellRange);
+ } elseif (
+ preg_match('/\(\)/', $condition)
+ || preg_match('/' . Calculation::CALCULATION_REGEXP_CELLREF_RELATIVE . '/i', $condition)
+ ) {
+ $wizard->operandValueType = Wizard::VALUE_TYPE_FORMULA;
+ }
+ $wizard->operand = $condition;
+
+ return $wizard;
+ }
+
+ /**
+ * @param mixed[] $arguments
+ */
+ public function __call(string $methodName, array $arguments): self
+ {
+ if (!isset(self::MAGIC_OPERATIONS[$methodName])) {
+ throw new Exception('Invalid Operation for Text Value CF Rule Wizard');
+ }
+
+ $this->operator(self::MAGIC_OPERATIONS[$methodName]);
+ //$this->operand(...$arguments);
+ if (count($arguments) < 2) {
+ /** @var string */
+ $arg0 = $arguments[0];
+ $this->operand($arg0);
+ } else {
+ /** @var string */
+ $arg0 = $arguments[0];
+ /** @var string */
+ $arg1 = $arguments[1];
+ $this->operand($arg0, $arg1);
+ }
+
+ return $this;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/WizardAbstract.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/WizardAbstract.php
new file mode 100644
index 00000000..953a5593
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/WizardAbstract.php
@@ -0,0 +1,176 @@
+setCellRange($cellRange);
+ }
+
+ public function getCellRange(): string
+ {
+ return $this->cellRange;
+ }
+
+ public function setCellRange(string $cellRange): void
+ {
+ $this->cellRange = $cellRange;
+ $this->setReferenceCellForExpressions($cellRange);
+ }
+
+ protected function setReferenceCellForExpressions(string $conditionalRange): void
+ {
+ $conditionalRange = Coordinate::splitRange(str_replace('$', '', strtoupper($conditionalRange)));
+ [$this->referenceCell] = $conditionalRange[0];
+
+ [$this->referenceColumn, $this->referenceRow] = Coordinate::indexesFromString($this->referenceCell);
+ }
+
+ public function getStopIfTrue(): bool
+ {
+ return $this->stopIfTrue;
+ }
+
+ public function setStopIfTrue(bool $stopIfTrue): void
+ {
+ $this->stopIfTrue = $stopIfTrue;
+ }
+
+ public function getStyle(): Style
+ {
+ return $this->style ?? new Style(false, true);
+ }
+
+ public function setStyle(Style $style): void
+ {
+ $this->style = $style;
+ }
+
+ protected function validateOperand(string $operand, string $operandValueType = Wizard::VALUE_TYPE_LITERAL): string
+ {
+ if (
+ $operandValueType === Wizard::VALUE_TYPE_LITERAL
+ && str_starts_with($operand, '"')
+ && str_ends_with($operand, '"')
+ ) {
+ $operand = str_replace('""', '"', substr($operand, 1, -1));
+ } elseif ($operandValueType === Wizard::VALUE_TYPE_FORMULA && str_starts_with($operand, '=')) {
+ $operand = substr($operand, 1);
+ }
+
+ return $operand;
+ }
+
+ protected static function reverseCellAdjustment(array $matches, int $referenceColumn, int $referenceRow): string
+ {
+ $worksheet = $matches[1];
+ $column = $matches[6];
+ $row = $matches[7];
+
+ if (!str_contains($column, '$')) {
+ $column = Coordinate::columnIndexFromString($column);
+ $column -= $referenceColumn - 1;
+ $column = Coordinate::stringFromColumnIndex($column);
+ }
+
+ if (!str_contains($row, '$')) {
+ $row -= $referenceRow - 1;
+ }
+
+ return "{$worksheet}{$column}{$row}";
+ }
+
+ public static function reverseAdjustCellRef(string $condition, string $cellRange): string
+ {
+ $conditionalRange = Coordinate::splitRange(str_replace('$', '', strtoupper($cellRange)));
+ [$referenceCell] = $conditionalRange[0];
+ [$referenceColumnIndex, $referenceRow] = Coordinate::indexesFromString($referenceCell);
+
+ $splitCondition = explode(Calculation::FORMULA_STRING_QUOTE, $condition);
+ $i = false;
+ foreach ($splitCondition as &$value) {
+ // Only count/replace in alternating array entries (ie. not in quoted strings)
+ $i = $i === false;
+ if ($i) {
+ $value = (string) preg_replace_callback(
+ '/' . Calculation::CALCULATION_REGEXP_CELLREF_RELATIVE . '/i',
+ fn ($matches): string => self::reverseCellAdjustment($matches, $referenceColumnIndex, $referenceRow),
+ $value
+ );
+ }
+ }
+ unset($value);
+
+ // Then rebuild the condition string to return it
+ return implode(Calculation::FORMULA_STRING_QUOTE, $splitCondition);
+ }
+
+ protected function conditionCellAdjustment(array $matches): string
+ {
+ $worksheet = $matches[1];
+ $column = $matches[6];
+ $row = $matches[7];
+
+ if (!str_contains($column, '$')) {
+ $column = Coordinate::columnIndexFromString($column);
+ $column += $this->referenceColumn - 1;
+ $column = Coordinate::stringFromColumnIndex($column);
+ }
+
+ if (!str_contains($row, '$')) {
+ $row += $this->referenceRow - 1;
+ }
+
+ return "{$worksheet}{$column}{$row}";
+ }
+
+ protected function cellConditionCheck(string $condition): string
+ {
+ $splitCondition = explode(Calculation::FORMULA_STRING_QUOTE, $condition);
+ $i = false;
+ foreach ($splitCondition as &$value) {
+ // Only count/replace in alternating array entries (ie. not in quoted strings)
+ $i = $i === false;
+ if ($i) {
+ $value = (string) preg_replace_callback(
+ '/' . Calculation::CALCULATION_REGEXP_CELLREF_RELATIVE . '/i',
+ [$this, 'conditionCellAdjustment'],
+ $value
+ );
+ }
+ }
+ unset($value);
+
+ // Then rebuild the condition string to return it
+ return implode(Calculation::FORMULA_STRING_QUOTE, $splitCondition);
+ }
+
+ protected function adjustConditionsForCellReferences(array $conditions): array
+ {
+ return array_map(
+ [$this, 'cellConditionCheck'],
+ $conditions
+ );
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/WizardInterface.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/WizardInterface.php
new file mode 100644
index 00000000..10ad57b2
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/ConditionalFormatting/Wizard/WizardInterface.php
@@ -0,0 +1,25 @@
+fillType = null;
+ }
+ $this->startColor = new Color(Color::COLOR_WHITE, $isSupervisor, $isConditional);
+ $this->endColor = new Color(Color::COLOR_BLACK, $isSupervisor, $isConditional);
+
+ // bind parent if we are a supervisor
+ if ($isSupervisor) {
+ $this->startColor->bindParent($this, 'startColor');
+ $this->endColor->bindParent($this, 'endColor');
+ }
+ }
+
+ /**
+ * Get the shared style component for the currently active cell in currently active sheet.
+ * Only used for style supervisor.
+ */
+ public function getSharedComponent(): self
+ {
+ /** @var Style $parent */
+ $parent = $this->parent;
+
+ return $parent->getSharedComponent()->getFill();
+ }
+
+ /**
+ * Build style array from subcomponents.
+ */
+ public function getStyleArray(array $array): array
+ {
+ return ['fill' => $array];
+ }
+
+ /**
+ * Apply styles from array.
+ *
+ *
+ * $spreadsheet->getActiveSheet()->getStyle('B2')->getFill()->applyFromArray(
+ * [
+ * 'fillType' => Fill::FILL_GRADIENT_LINEAR,
+ * 'rotation' => 0.0,
+ * 'startColor' => [
+ * 'rgb' => '000000'
+ * ],
+ * 'endColor' => [
+ * 'argb' => 'FFFFFFFF'
+ * ]
+ * ]
+ * );
+ *
+ *
+ * @param array $styleArray Array containing style information
+ *
+ * @return $this
+ */
+ public function applyFromArray(array $styleArray): static
+ {
+ if ($this->isSupervisor) {
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($this->getStyleArray($styleArray));
+ } else {
+ if (isset($styleArray['fillType'])) {
+ $this->setFillType($styleArray['fillType']);
+ }
+ if (isset($styleArray['rotation'])) {
+ $this->setRotation($styleArray['rotation']);
+ }
+ if (isset($styleArray['startColor'])) {
+ $this->getStartColor()->applyFromArray($styleArray['startColor']);
+ }
+ if (isset($styleArray['endColor'])) {
+ $this->getEndColor()->applyFromArray($styleArray['endColor']);
+ }
+ if (isset($styleArray['color'])) {
+ $this->getStartColor()->applyFromArray($styleArray['color']);
+ $this->getEndColor()->applyFromArray($styleArray['color']);
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Fill Type.
+ */
+ public function getFillType(): ?string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getFillType();
+ }
+
+ return $this->fillType;
+ }
+
+ /**
+ * Set Fill Type.
+ *
+ * @param string $fillType Fill type, see self::FILL_*
+ *
+ * @return $this
+ */
+ public function setFillType(string $fillType): static
+ {
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['fillType' => $fillType]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->fillType = $fillType;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Rotation.
+ */
+ public function getRotation(): float
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getRotation();
+ }
+
+ return $this->rotation;
+ }
+
+ /**
+ * Set Rotation.
+ *
+ * @return $this
+ */
+ public function setRotation(float $angleInDegrees): static
+ {
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['rotation' => $angleInDegrees]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->rotation = $angleInDegrees;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Start Color.
+ */
+ public function getStartColor(): Color
+ {
+ return $this->startColor;
+ }
+
+ /**
+ * Set Start Color.
+ *
+ * @return $this
+ */
+ public function setStartColor(Color $color): static
+ {
+ $this->colorChanged = true;
+ // make sure parameter is a real color and not a supervisor
+ $color = $color->getIsSupervisor() ? $color->getSharedComponent() : $color;
+
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStartColor()->getStyleArray(['argb' => $color->getARGB()]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->startColor = $color;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get End Color.
+ */
+ public function getEndColor(): Color
+ {
+ return $this->endColor;
+ }
+
+ /**
+ * Set End Color.
+ *
+ * @return $this
+ */
+ public function setEndColor(Color $color): static
+ {
+ $this->colorChanged = true;
+ // make sure parameter is a real color and not a supervisor
+ $color = $color->getIsSupervisor() ? $color->getSharedComponent() : $color;
+
+ if ($this->isSupervisor) {
+ $styleArray = $this->getEndColor()->getStyleArray(['argb' => $color->getARGB()]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->endColor = $color;
+ }
+
+ return $this;
+ }
+
+ public function getColorsChanged(): bool
+ {
+ if ($this->isSupervisor) {
+ $changed = $this->getSharedComponent()->colorChanged;
+ } else {
+ $changed = $this->colorChanged;
+ }
+
+ return $changed || $this->startColor->getHasChanged() || $this->endColor->getHasChanged();
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getHashCode();
+ }
+
+ // Note that we don't care about colours for fill type NONE, but could have duplicate NONEs with
+ // different hashes if we don't explicitly prevent this
+ return md5(
+ $this->getFillType()
+ . $this->getRotation()
+ . ($this->getFillType() !== self::FILL_NONE ? $this->getStartColor()->getHashCode() : '')
+ . ($this->getFillType() !== self::FILL_NONE ? $this->getEndColor()->getHashCode() : '')
+ . ((string) $this->getColorsChanged())
+ . __CLASS__
+ );
+ }
+
+ protected function exportArray1(): array
+ {
+ $exportedArray = [];
+ $this->exportArray2($exportedArray, 'fillType', $this->getFillType());
+ $this->exportArray2($exportedArray, 'rotation', $this->getRotation());
+ if ($this->getColorsChanged()) {
+ $this->exportArray2($exportedArray, 'endColor', $this->getEndColor());
+ $this->exportArray2($exportedArray, 'startColor', $this->getStartColor());
+ }
+
+ return $exportedArray;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Font.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Font.php
new file mode 100644
index 00000000..b96cfca6
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/Font.php
@@ -0,0 +1,833 @@
+name = null;
+ $this->size = null;
+ $this->bold = null;
+ $this->italic = null;
+ $this->superscript = null;
+ $this->subscript = null;
+ $this->underline = null;
+ $this->strikethrough = null;
+ $this->color = new Color(Color::COLOR_BLACK, $isSupervisor, $isConditional);
+ } else {
+ $this->color = new Color(Color::COLOR_BLACK, $isSupervisor);
+ }
+ // bind parent if we are a supervisor
+ if ($isSupervisor) {
+ $this->color->bindParent($this, 'color');
+ }
+ }
+
+ /**
+ * Get the shared style component for the currently active cell in currently active sheet.
+ * Only used for style supervisor.
+ */
+ public function getSharedComponent(): self
+ {
+ /** @var Style $parent */
+ $parent = $this->parent;
+
+ return $parent->getSharedComponent()->getFont();
+ }
+
+ /**
+ * Build style array from subcomponents.
+ */
+ public function getStyleArray(array $array): array
+ {
+ return ['font' => $array];
+ }
+
+ /**
+ * Apply styles from array.
+ *
+ *
+ * $spreadsheet->getActiveSheet()->getStyle('B2')->getFont()->applyFromArray(
+ * [
+ * 'name' => 'Arial',
+ * 'bold' => TRUE,
+ * 'italic' => FALSE,
+ * 'underline' => \PhpOffice\PhpSpreadsheet\Style\Font::UNDERLINE_DOUBLE,
+ * 'strikethrough' => FALSE,
+ * 'color' => [
+ * 'rgb' => '808080'
+ * ]
+ * ]
+ * );
+ *
+ *
+ * @param array $styleArray Array containing style information
+ *
+ * @return $this
+ */
+ public function applyFromArray(array $styleArray): static
+ {
+ if ($this->isSupervisor) {
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($this->getStyleArray($styleArray));
+ } else {
+ if (isset($styleArray['name'])) {
+ $this->setName($styleArray['name']);
+ }
+ if (isset($styleArray['latin'])) {
+ $this->setLatin($styleArray['latin']);
+ }
+ if (isset($styleArray['eastAsian'])) {
+ $this->setEastAsian($styleArray['eastAsian']);
+ }
+ if (isset($styleArray['complexScript'])) {
+ $this->setComplexScript($styleArray['complexScript']);
+ }
+ if (isset($styleArray['bold'])) {
+ $this->setBold($styleArray['bold']);
+ }
+ if (isset($styleArray['italic'])) {
+ $this->setItalic($styleArray['italic']);
+ }
+ if (isset($styleArray['superscript'])) {
+ $this->setSuperscript($styleArray['superscript']);
+ }
+ if (isset($styleArray['subscript'])) {
+ $this->setSubscript($styleArray['subscript']);
+ }
+ if (isset($styleArray['underline'])) {
+ $this->setUnderline($styleArray['underline']);
+ }
+ if (isset($styleArray['strikethrough'])) {
+ $this->setStrikethrough($styleArray['strikethrough']);
+ }
+ if (isset($styleArray['color'])) {
+ $this->getColor()->applyFromArray($styleArray['color']);
+ }
+ if (isset($styleArray['size'])) {
+ $this->setSize($styleArray['size']);
+ }
+ if (isset($styleArray['chartColor'])) {
+ $this->chartColor = $styleArray['chartColor'];
+ }
+ if (isset($styleArray['scheme'])) {
+ $this->setScheme($styleArray['scheme']);
+ }
+ if (isset($styleArray['cap'])) {
+ $this->setCap($styleArray['cap']);
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Name.
+ */
+ public function getName(): ?string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getName();
+ }
+
+ return $this->name;
+ }
+
+ public function getLatin(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getLatin();
+ }
+
+ return $this->latin;
+ }
+
+ public function getEastAsian(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getEastAsian();
+ }
+
+ return $this->eastAsian;
+ }
+
+ public function getComplexScript(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getComplexScript();
+ }
+
+ return $this->complexScript;
+ }
+
+ /**
+ * Set Name and turn off Scheme.
+ */
+ public function setName(string $fontname): self
+ {
+ if ($fontname == '') {
+ $fontname = 'Calibri';
+ }
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['name' => $fontname]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->name = $fontname;
+ }
+
+ return $this->setScheme('');
+ }
+
+ public function setLatin(string $fontname): self
+ {
+ if ($fontname == '') {
+ $fontname = 'Calibri';
+ }
+ if (!$this->isSupervisor) {
+ $this->latin = $fontname;
+ } else {
+ // should never be true
+ // @codeCoverageIgnoreStart
+ $styleArray = $this->getStyleArray(['latin' => $fontname]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ // @codeCoverageIgnoreEnd
+ }
+
+ return $this;
+ }
+
+ public function setEastAsian(string $fontname): self
+ {
+ if ($fontname == '') {
+ $fontname = 'Calibri';
+ }
+ if (!$this->isSupervisor) {
+ $this->eastAsian = $fontname;
+ } else {
+ // should never be true
+ // @codeCoverageIgnoreStart
+ $styleArray = $this->getStyleArray(['eastAsian' => $fontname]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ // @codeCoverageIgnoreEnd
+ }
+
+ return $this;
+ }
+
+ public function setComplexScript(string $fontname): self
+ {
+ if ($fontname == '') {
+ $fontname = 'Calibri';
+ }
+ if (!$this->isSupervisor) {
+ $this->complexScript = $fontname;
+ } else {
+ // should never be true
+ // @codeCoverageIgnoreStart
+ $styleArray = $this->getStyleArray(['complexScript' => $fontname]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ // @codeCoverageIgnoreEnd
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Size.
+ */
+ public function getSize(): ?float
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getSize();
+ }
+
+ return $this->size;
+ }
+
+ /**
+ * Set Size.
+ *
+ * @param mixed $sizeInPoints A float representing the value of a positive measurement in points (1/72 of an inch)
+ *
+ * @return $this
+ */
+ public function setSize(mixed $sizeInPoints, bool $nullOk = false): static
+ {
+ if (is_string($sizeInPoints) || is_int($sizeInPoints)) {
+ $sizeInPoints = (float) $sizeInPoints; // $pValue = 0 if given string is not numeric
+ }
+
+ // Size must be a positive floating point number
+ // ECMA-376-1:2016, part 1, chapter 18.4.11 sz (Font Size), p. 1536
+ if (!is_float($sizeInPoints) || !($sizeInPoints > 0)) {
+ if (!$nullOk || $sizeInPoints !== null) {
+ $sizeInPoints = 10.0;
+ }
+ }
+
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['size' => $sizeInPoints]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->size = $sizeInPoints;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Bold.
+ */
+ public function getBold(): ?bool
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getBold();
+ }
+
+ return $this->bold;
+ }
+
+ /**
+ * Set Bold.
+ *
+ * @return $this
+ */
+ public function setBold(bool $bold): static
+ {
+ if ($bold == '') {
+ $bold = false;
+ }
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['bold' => $bold]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->bold = $bold;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Italic.
+ */
+ public function getItalic(): ?bool
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getItalic();
+ }
+
+ return $this->italic;
+ }
+
+ /**
+ * Set Italic.
+ *
+ * @return $this
+ */
+ public function setItalic(bool $italic): static
+ {
+ if ($italic == '') {
+ $italic = false;
+ }
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['italic' => $italic]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->italic = $italic;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Superscript.
+ */
+ public function getSuperscript(): ?bool
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getSuperscript();
+ }
+
+ return $this->superscript;
+ }
+
+ /**
+ * Set Superscript.
+ *
+ * @return $this
+ */
+ public function setSuperscript(bool $superscript): static
+ {
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['superscript' => $superscript]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->superscript = $superscript;
+ if ($this->superscript) {
+ $this->subscript = false;
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Subscript.
+ */
+ public function getSubscript(): ?bool
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getSubscript();
+ }
+
+ return $this->subscript;
+ }
+
+ /**
+ * Set Subscript.
+ *
+ * @return $this
+ */
+ public function setSubscript(bool $subscript): static
+ {
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['subscript' => $subscript]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->subscript = $subscript;
+ if ($this->subscript) {
+ $this->superscript = false;
+ }
+ }
+
+ return $this;
+ }
+
+ public function getBaseLine(): int
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getBaseLine();
+ }
+
+ return $this->baseLine;
+ }
+
+ public function setBaseLine(int $baseLine): self
+ {
+ if (!$this->isSupervisor) {
+ $this->baseLine = $baseLine;
+ } else {
+ // should never be true
+ // @codeCoverageIgnoreStart
+ $styleArray = $this->getStyleArray(['baseLine' => $baseLine]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ // @codeCoverageIgnoreEnd
+ }
+
+ return $this;
+ }
+
+ public function getStrikeType(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getStrikeType();
+ }
+
+ return $this->strikeType;
+ }
+
+ public function setStrikeType(string $strikeType): self
+ {
+ if (!$this->isSupervisor) {
+ $this->strikeType = $strikeType;
+ } else {
+ // should never be true
+ // @codeCoverageIgnoreStart
+ $styleArray = $this->getStyleArray(['strikeType' => $strikeType]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ // @codeCoverageIgnoreEnd
+ }
+
+ return $this;
+ }
+
+ public function getUnderlineColor(): ?ChartColor
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getUnderlineColor();
+ }
+
+ return $this->underlineColor;
+ }
+
+ public function setUnderlineColor(array $colorArray): self
+ {
+ if (!$this->isSupervisor) {
+ $this->underlineColor = new ChartColor($colorArray);
+ } else {
+ // should never be true
+ // @codeCoverageIgnoreStart
+ $styleArray = $this->getStyleArray(['underlineColor' => $colorArray]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ // @codeCoverageIgnoreEnd
+ }
+
+ return $this;
+ }
+
+ public function getChartColor(): ?ChartColor
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getChartColor();
+ }
+
+ return $this->chartColor;
+ }
+
+ public function setChartColor(array $colorArray): self
+ {
+ if (!$this->isSupervisor) {
+ $this->chartColor = new ChartColor($colorArray);
+ } else {
+ // should never be true
+ // @codeCoverageIgnoreStart
+ $styleArray = $this->getStyleArray(['chartColor' => $colorArray]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ // @codeCoverageIgnoreEnd
+ }
+
+ return $this;
+ }
+
+ public function setChartColorFromObject(?ChartColor $chartColor): self
+ {
+ $this->chartColor = $chartColor;
+
+ return $this;
+ }
+
+ /**
+ * Get Underline.
+ */
+ public function getUnderline(): ?string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getUnderline();
+ }
+
+ return $this->underline;
+ }
+
+ /**
+ * Set Underline.
+ *
+ * @param bool|string $underlineStyle \PhpOffice\PhpSpreadsheet\Style\Font underline type
+ * If a boolean is passed, then TRUE equates to UNDERLINE_SINGLE,
+ * false equates to UNDERLINE_NONE
+ *
+ * @return $this
+ */
+ public function setUnderline($underlineStyle): static
+ {
+ if (is_bool($underlineStyle)) {
+ $underlineStyle = ($underlineStyle) ? self::UNDERLINE_SINGLE : self::UNDERLINE_NONE;
+ } elseif ($underlineStyle == '') {
+ $underlineStyle = self::UNDERLINE_NONE;
+ }
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['underline' => $underlineStyle]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->underline = $underlineStyle;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Strikethrough.
+ */
+ public function getStrikethrough(): ?bool
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getStrikethrough();
+ }
+
+ return $this->strikethrough;
+ }
+
+ /**
+ * Set Strikethrough.
+ *
+ * @return $this
+ */
+ public function setStrikethrough(bool $strikethru): static
+ {
+ if ($strikethru == '') {
+ $strikethru = false;
+ }
+
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['strikethrough' => $strikethru]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->strikethrough = $strikethru;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Color.
+ */
+ public function getColor(): Color
+ {
+ return $this->color;
+ }
+
+ /**
+ * Set Color.
+ *
+ * @return $this
+ */
+ public function setColor(Color $color): static
+ {
+ // make sure parameter is a real color and not a supervisor
+ $color = $color->getIsSupervisor() ? $color->getSharedComponent() : $color;
+
+ if ($this->isSupervisor) {
+ $styleArray = $this->getColor()->getStyleArray(['argb' => $color->getARGB()]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->color = $color;
+ }
+
+ return $this;
+ }
+
+ private function hashChartColor(?ChartColor $underlineColor): string
+ {
+ if ($underlineColor === null) {
+ return '';
+ }
+
+ return
+ $underlineColor->getValue()
+ . $underlineColor->getType()
+ . (string) $underlineColor->getAlpha();
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getHashCode();
+ }
+
+ return md5(
+ $this->name
+ . $this->size
+ . ($this->bold ? 't' : 'f')
+ . ($this->italic ? 't' : 'f')
+ . ($this->superscript ? 't' : 'f')
+ . ($this->subscript ? 't' : 'f')
+ . $this->underline
+ . ($this->strikethrough ? 't' : 'f')
+ . $this->color->getHashCode()
+ . $this->scheme
+ . implode(
+ '*',
+ [
+ $this->latin,
+ $this->eastAsian,
+ $this->complexScript,
+ $this->strikeType,
+ $this->hashChartColor($this->chartColor),
+ $this->hashChartColor($this->underlineColor),
+ (string) $this->baseLine,
+ (string) $this->cap,
+ ]
+ )
+ . __CLASS__
+ );
+ }
+
+ protected function exportArray1(): array
+ {
+ $exportedArray = [];
+ $this->exportArray2($exportedArray, 'baseLine', $this->getBaseLine());
+ $this->exportArray2($exportedArray, 'bold', $this->getBold());
+ $this->exportArray2($exportedArray, 'cap', $this->getCap());
+ $this->exportArray2($exportedArray, 'chartColor', $this->getChartColor());
+ $this->exportArray2($exportedArray, 'color', $this->getColor());
+ $this->exportArray2($exportedArray, 'complexScript', $this->getComplexScript());
+ $this->exportArray2($exportedArray, 'eastAsian', $this->getEastAsian());
+ $this->exportArray2($exportedArray, 'italic', $this->getItalic());
+ $this->exportArray2($exportedArray, 'latin', $this->getLatin());
+ $this->exportArray2($exportedArray, 'name', $this->getName());
+ $this->exportArray2($exportedArray, 'scheme', $this->getScheme());
+ $this->exportArray2($exportedArray, 'size', $this->getSize());
+ $this->exportArray2($exportedArray, 'strikethrough', $this->getStrikethrough());
+ $this->exportArray2($exportedArray, 'strikeType', $this->getStrikeType());
+ $this->exportArray2($exportedArray, 'subscript', $this->getSubscript());
+ $this->exportArray2($exportedArray, 'superscript', $this->getSuperscript());
+ $this->exportArray2($exportedArray, 'underline', $this->getUnderline());
+ $this->exportArray2($exportedArray, 'underlineColor', $this->getUnderlineColor());
+
+ return $exportedArray;
+ }
+
+ public function getScheme(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getScheme();
+ }
+
+ return $this->scheme;
+ }
+
+ public function setScheme(string $scheme): self
+ {
+ if ($scheme === '' || $scheme === 'major' || $scheme === 'minor') {
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['scheme' => $scheme]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->scheme = $scheme;
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set capitalization attribute. If not one of the permitted
+ * values (all, small, or none), set it to null.
+ * This will be honored only for the font for chart titles.
+ * None is distinguished from null because null will inherit
+ * the current value, whereas 'none' will override it.
+ */
+ public function setCap(string $cap): self
+ {
+ $this->cap = in_array($cap, self::VALID_CAPS, true) ? $cap : null;
+
+ return $this;
+ }
+
+ public function getCap(): ?string
+ {
+ return $this->cap;
+ }
+
+ /**
+ * Implement PHP __clone to create a deep clone, not just a shallow copy.
+ */
+ public function __clone()
+ {
+ $this->color = clone $this->color;
+ $this->chartColor = ($this->chartColor === null) ? null : clone $this->chartColor;
+ $this->underlineColor = ($this->underlineColor === null) ? null : clone $this->underlineColor;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat.php
new file mode 100644
index 00000000..9c9a5456
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat.php
@@ -0,0 +1,517 @@
+formatCode = null;
+ $this->builtInFormatCode = false;
+ }
+ }
+
+ /**
+ * Get the shared style component for the currently active cell in currently active sheet.
+ * Only used for style supervisor.
+ */
+ public function getSharedComponent(): self
+ {
+ /** @var Style $parent */
+ $parent = $this->parent;
+
+ return $parent->getSharedComponent()->getNumberFormat();
+ }
+
+ /**
+ * Build style array from subcomponents.
+ */
+ public function getStyleArray(array $array): array
+ {
+ return ['numberFormat' => $array];
+ }
+
+ /**
+ * Apply styles from array.
+ *
+ *
+ * $spreadsheet->getActiveSheet()->getStyle('B2')->getNumberFormat()->applyFromArray(
+ * [
+ * 'formatCode' => NumberFormat::FORMAT_CURRENCY_EUR_SIMPLE
+ * ]
+ * );
+ *
+ *
+ * @param array $styleArray Array containing style information
+ *
+ * @return $this
+ */
+ public function applyFromArray(array $styleArray): static
+ {
+ if ($this->isSupervisor) {
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($this->getStyleArray($styleArray));
+ } else {
+ if (isset($styleArray['formatCode'])) {
+ $this->setFormatCode($styleArray['formatCode']);
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Format Code.
+ */
+ public function getFormatCode(bool $extended = false): ?string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getFormatCode($extended);
+ }
+ $builtin = $this->getBuiltInFormatCode();
+ if (is_int($builtin)) {
+ if ($extended) {
+ if ($builtin === self::SHORT_DATE_INDEX) {
+ return self::$shortDateFormat;
+ }
+ if ($builtin === self::DATE_TIME_INDEX) {
+ return self::$dateTimeFormat;
+ }
+ }
+
+ return self::builtInFormatCode($builtin);
+ }
+
+ return $extended ? self::convertSystemFormats($this->formatCode) : $this->formatCode;
+ }
+
+ public static function convertSystemFormats(?string $formatCode): ?string
+ {
+ if (is_string($formatCode)) {
+ if (stripos($formatCode, self::FORMAT_SYSDATE_F800) !== false || stripos($formatCode, self::FORMAT_SYSDATE_X) !== false) {
+ return self::$longDateFormat;
+ }
+ if (stripos($formatCode, self::FORMAT_SYSTIME_F400) !== false || stripos($formatCode, self::FORMAT_SYSTIME_X) !== false) {
+ return self::$timeFormat;
+ }
+ }
+
+ return $formatCode;
+ }
+
+ /**
+ * Set Format Code.
+ *
+ * @param string $formatCode see self::FORMAT_*
+ *
+ * @return $this
+ */
+ public function setFormatCode(string $formatCode): static
+ {
+ if ($formatCode == '') {
+ $formatCode = self::FORMAT_GENERAL;
+ }
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['formatCode' => $formatCode]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->formatCode = $formatCode;
+ $this->builtInFormatCode = self::builtInFormatCodeIndex($formatCode);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Built-In Format Code.
+ *
+ * @return false|int
+ */
+ public function getBuiltInFormatCode()
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getBuiltInFormatCode();
+ }
+
+ return $this->builtInFormatCode;
+ }
+
+ /**
+ * Set Built-In Format Code.
+ *
+ * @param int $formatCodeIndex Id of the built-in format code to use
+ *
+ * @return $this
+ */
+ public function setBuiltInFormatCode(int $formatCodeIndex): static
+ {
+ if ($this->isSupervisor) {
+ $styleArray = $this->getStyleArray(['formatCode' => self::builtInFormatCode($formatCodeIndex)]);
+ $this->getActiveSheet()->getStyle($this->getSelectedCells())->applyFromArray($styleArray);
+ } else {
+ $this->builtInFormatCode = $formatCodeIndex;
+ $this->formatCode = self::builtInFormatCode($formatCodeIndex);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Fill built-in format codes.
+ */
+ private static function fillBuiltInFormatCodes(): void
+ {
+ // [MS-OI29500: Microsoft Office Implementation Information for ISO/IEC-29500 Standard Compliance]
+ // 18.8.30. numFmt (Number Format)
+ //
+ // The ECMA standard defines built-in format IDs
+ // 14: "mm-dd-yy"
+ // 22: "m/d/yy h:mm"
+ // 37: "#,##0 ;(#,##0)"
+ // 38: "#,##0 ;[Red](#,##0)"
+ // 39: "#,##0.00;(#,##0.00)"
+ // 40: "#,##0.00;[Red](#,##0.00)"
+ // 47: "mmss.0"
+ // KOR fmt 55: "yyyy-mm-dd"
+ // Excel defines built-in format IDs
+ // 14: "m/d/yyyy"
+ // 22: "m/d/yyyy h:mm"
+ // 37: "#,##0_);(#,##0)"
+ // 38: "#,##0_);[Red](#,##0)"
+ // 39: "#,##0.00_);(#,##0.00)"
+ // 40: "#,##0.00_);[Red](#,##0.00)"
+ // 47: "mm:ss.0"
+ // KOR fmt 55: "yyyy/mm/dd"
+
+ // Built-in format codes
+ if (empty(self::$builtInFormats)) {
+ self::$builtInFormats = [];
+
+ // General
+ self::$builtInFormats[0] = self::FORMAT_GENERAL;
+ self::$builtInFormats[1] = '0';
+ self::$builtInFormats[2] = '0.00';
+ self::$builtInFormats[3] = '#,##0';
+ self::$builtInFormats[4] = '#,##0.00';
+
+ self::$builtInFormats[9] = '0%';
+ self::$builtInFormats[10] = '0.00%';
+ self::$builtInFormats[11] = '0.00E+00';
+ self::$builtInFormats[12] = '# ?/?';
+ self::$builtInFormats[13] = '# ??/??';
+ self::$builtInFormats[14] = self::FORMAT_DATE_XLSX14_ACTUAL; // Despite ECMA 'mm-dd-yy';
+ self::$builtInFormats[15] = self::FORMAT_DATE_XLSX15;
+ self::$builtInFormats[16] = 'd-mmm';
+ self::$builtInFormats[17] = 'mmm-yy';
+ self::$builtInFormats[18] = 'h:mm AM/PM';
+ self::$builtInFormats[19] = 'h:mm:ss AM/PM';
+ self::$builtInFormats[20] = 'h:mm';
+ self::$builtInFormats[21] = 'h:mm:ss';
+ self::$builtInFormats[22] = self::FORMAT_DATE_XLSX22_ACTUAL; // Despite ECMA 'm/d/yy h:mm';
+
+ self::$builtInFormats[37] = '#,##0_);(#,##0)'; // Despite ECMA '#,##0 ;(#,##0)';
+ self::$builtInFormats[38] = '#,##0_);[Red](#,##0)'; // Despite ECMA '#,##0 ;[Red](#,##0)';
+ self::$builtInFormats[39] = '#,##0.00_);(#,##0.00)'; // Despite ECMA '#,##0.00;(#,##0.00)';
+ self::$builtInFormats[40] = '#,##0.00_);[Red](#,##0.00)'; // Despite ECMA '#,##0.00;[Red](#,##0.00)';
+
+ self::$builtInFormats[44] = '_("$"* #,##0.00_);_("$"* \(#,##0.00\);_("$"* "-"??_);_(@_)';
+ self::$builtInFormats[45] = 'mm:ss';
+ self::$builtInFormats[46] = '[h]:mm:ss';
+ self::$builtInFormats[47] = 'mm:ss.0'; // Despite ECMA 'mmss.0';
+ self::$builtInFormats[48] = '##0.0E+0';
+ self::$builtInFormats[49] = '@';
+
+ // CHT
+ self::$builtInFormats[27] = '[$-404]e/m/d';
+ self::$builtInFormats[30] = 'm/d/yy';
+ self::$builtInFormats[36] = '[$-404]e/m/d';
+ self::$builtInFormats[50] = '[$-404]e/m/d';
+ self::$builtInFormats[57] = '[$-404]e/m/d';
+
+ // THA
+ self::$builtInFormats[59] = 't0';
+ self::$builtInFormats[60] = 't0.00';
+ self::$builtInFormats[61] = 't#,##0';
+ self::$builtInFormats[62] = 't#,##0.00';
+ self::$builtInFormats[67] = 't0%';
+ self::$builtInFormats[68] = 't0.00%';
+ self::$builtInFormats[69] = 't# ?/?';
+ self::$builtInFormats[70] = 't# ??/??';
+
+ // JPN
+ self::$builtInFormats[28] = '[$-411]ggge"年"m"月"d"日"';
+ self::$builtInFormats[29] = '[$-411]ggge"年"m"月"d"日"';
+ self::$builtInFormats[31] = 'yyyy"年"m"月"d"日"';
+ self::$builtInFormats[32] = 'h"時"mm"分"';
+ self::$builtInFormats[33] = 'h"時"mm"分"ss"秒"';
+ self::$builtInFormats[34] = 'yyyy"年"m"月"';
+ self::$builtInFormats[35] = 'm"月"d"日"';
+ self::$builtInFormats[51] = '[$-411]ggge"年"m"月"d"日"';
+ self::$builtInFormats[52] = 'yyyy"年"m"月"';
+ self::$builtInFormats[53] = 'm"月"d"日"';
+ self::$builtInFormats[54] = '[$-411]ggge"年"m"月"d"日"';
+ self::$builtInFormats[55] = 'yyyy"年"m"月"';
+ self::$builtInFormats[56] = 'm"月"d"日"';
+ self::$builtInFormats[58] = '[$-411]ggge"年"m"月"d"日"';
+
+ // Flip array (for faster lookups)
+ self::$flippedBuiltInFormats = array_flip(self::$builtInFormats);
+ }
+ }
+
+ /**
+ * Get built-in format code.
+ */
+ public static function builtInFormatCode(int $index): string
+ {
+ // Clean parameter
+ $index = (int) $index;
+
+ // Ensure built-in format codes are available
+ self::fillBuiltInFormatCodes();
+
+ // Lookup format code
+ if (isset(self::$builtInFormats[$index])) {
+ return self::$builtInFormats[$index];
+ }
+
+ return '';
+ }
+
+ /**
+ * Get built-in format code index.
+ *
+ * @return false|int
+ */
+ public static function builtInFormatCodeIndex(string $formatCodeIndex)
+ {
+ // Ensure built-in format codes are available
+ self::fillBuiltInFormatCodes();
+
+ // Lookup format code
+ if (array_key_exists($formatCodeIndex, self::$flippedBuiltInFormats)) {
+ return self::$flippedBuiltInFormats[$formatCodeIndex];
+ }
+
+ return false;
+ }
+
+ /**
+ * Get hash code.
+ *
+ * @return string Hash code
+ */
+ public function getHashCode(): string
+ {
+ if ($this->isSupervisor) {
+ return $this->getSharedComponent()->getHashCode();
+ }
+
+ return md5(
+ $this->formatCode
+ . $this->builtInFormatCode
+ . __CLASS__
+ );
+ }
+
+ /**
+ * Convert a value in a pre-defined format to a PHP string.
+ *
+ * @param null|bool|float|int|RichText|string $value Value to format
+ * @param string $format Format code: see = self::FORMAT_* for predefined values;
+ * or can be any valid MS Excel custom format string
+ * @param ?array $callBack Callback function for additional formatting of string
+ *
+ * @return string Formatted string
+ */
+ public static function toFormattedString(mixed $value, string $format, ?array $callBack = null): string
+ {
+ return NumberFormat\Formatter::toFormattedString($value, $format, $callBack);
+ }
+
+ protected function exportArray1(): array
+ {
+ $exportedArray = [];
+ $this->exportArray2($exportedArray, 'formatCode', $this->getFormatCode());
+
+ return $exportedArray;
+ }
+
+ public static function getShortDateFormat(): string
+ {
+ return self::$shortDateFormat;
+ }
+
+ public static function setShortDateFormat(string $shortDateFormat): void
+ {
+ self::$shortDateFormat = $shortDateFormat;
+ }
+
+ public static function getLongDateFormat(): string
+ {
+ return self::$longDateFormat;
+ }
+
+ public static function setLongDateFormat(string $longDateFormat): void
+ {
+ self::$longDateFormat = $longDateFormat;
+ }
+
+ public static function getDateTimeFormat(): string
+ {
+ return self::$dateTimeFormat;
+ }
+
+ public static function setDateTimeFormat(string $dateTimeFormat): void
+ {
+ self::$dateTimeFormat = $dateTimeFormat;
+ }
+
+ public static function getTimeFormat(): string
+ {
+ return self::$timeFormat;
+ }
+
+ public static function setTimeFormat(string $timeFormat): void
+ {
+ self::$timeFormat = $timeFormat;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/BaseFormatter.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/BaseFormatter.php
new file mode 100644
index 00000000..165779ba
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/BaseFormatter.php
@@ -0,0 +1,25 @@
+ '',
+ // 12-hour suffix
+ 'am/pm' => 'A',
+ // 4-digit year
+ 'e' => 'Y',
+ 'yyyy' => 'Y',
+ // 2-digit year
+ 'yy' => 'y',
+ // first letter of month - no php equivalent
+ 'mmmmm' => 'M',
+ // full month name
+ 'mmmm' => 'F',
+ // short month name
+ 'mmm' => 'M',
+ // mm is minutes if time, but can also be month w/leading zero
+ // so we try to identify times be the inclusion of a : separator in the mask
+ // It isn't perfect, but the best way I know how
+ ':mm' => ':i',
+ 'mm:' => 'i:',
+ // full day of week name
+ 'dddd' => 'l',
+ // short day of week name
+ 'ddd' => 'D',
+ // days leading zero
+ 'dd' => 'd',
+ // days no leading zero
+ 'd' => 'j',
+ // fractional seconds - no php equivalent
+ '.s' => '',
+ ];
+
+ /**
+ * Search/replace values to convert Excel date/time format masks hours to PHP format masks (24 hr clock).
+ */
+ private const DATE_FORMAT_REPLACEMENTS24 = [
+ 'hh' => 'H',
+ 'h' => 'G',
+ // month leading zero
+ 'mm' => 'm',
+ // month no leading zero
+ 'm' => 'n',
+ // seconds
+ 'ss' => 's',
+ ];
+
+ /**
+ * Search/replace values to convert Excel date/time format masks hours to PHP format masks (12 hr clock).
+ */
+ private const DATE_FORMAT_REPLACEMENTS12 = [
+ 'hh' => 'h',
+ 'h' => 'g',
+ // month leading zero
+ 'mm' => 'm',
+ // month no leading zero
+ 'm' => 'n',
+ // seconds
+ 'ss' => 's',
+ ];
+
+ private const HOURS_IN_DAY = 24;
+ private const MINUTES_IN_DAY = 60 * self::HOURS_IN_DAY;
+ private const SECONDS_IN_DAY = 60 * self::MINUTES_IN_DAY;
+ private const INTERVAL_PRECISION = 10;
+ private const INTERVAL_LEADING_ZERO = [
+ '[hh]',
+ '[mm]',
+ '[ss]',
+ ];
+ private const INTERVAL_ROUND_PRECISION = [
+ // hours and minutes truncate
+ '[h]' => self::INTERVAL_PRECISION,
+ '[hh]' => self::INTERVAL_PRECISION,
+ '[m]' => self::INTERVAL_PRECISION,
+ '[mm]' => self::INTERVAL_PRECISION,
+ // seconds round
+ '[s]' => 0,
+ '[ss]' => 0,
+ ];
+ private const INTERVAL_MULTIPLIER = [
+ '[h]' => self::HOURS_IN_DAY,
+ '[hh]' => self::HOURS_IN_DAY,
+ '[m]' => self::MINUTES_IN_DAY,
+ '[mm]' => self::MINUTES_IN_DAY,
+ '[s]' => self::SECONDS_IN_DAY,
+ '[ss]' => self::SECONDS_IN_DAY,
+ ];
+
+ private static function tryInterval(bool &$seekingBracket, string &$block, mixed $value, string $format): void
+ {
+ if ($seekingBracket) {
+ if (str_contains($block, $format)) {
+ $hours = (string) (int) round(
+ self::INTERVAL_MULTIPLIER[$format] * $value,
+ self::INTERVAL_ROUND_PRECISION[$format]
+ );
+ if (strlen($hours) === 1 && in_array($format, self::INTERVAL_LEADING_ZERO, true)) {
+ $hours = "0$hours";
+ }
+ $block = str_replace($format, $hours, $block);
+ $seekingBracket = false;
+ }
+ }
+ }
+
+ /** @param float|int $value value to be formatted */
+ public static function format(mixed $value, string $format): string
+ {
+ // strip off first part containing e.g. [$-F800] or [$USD-409]
+ // general syntax: [$-]
+ // language info is in hexadecimal
+ // strip off chinese part like [DBNum1][$-804]
+ $format = (string) preg_replace('/^(\[DBNum\d\])*(\[\$[^\]]*\])/i', '', $format);
+
+ // OpenOffice.org uses upper-case number formats, e.g. 'YYYY', convert to lower-case;
+ // but we don't want to change any quoted strings
+ /** @var callable $callable */
+ $callable = [self::class, 'setLowercaseCallback'];
+ $format = (string) preg_replace_callback('/(?:^|")([^"]*)(?:$|")/', $callable, $format);
+
+ // Only process the non-quoted blocks for date format characters
+
+ $blocks = explode('"', $format);
+ foreach ($blocks as $key => &$block) {
+ if ($key % 2 == 0) {
+ $block = strtr($block, self::DATE_FORMAT_REPLACEMENTS);
+ if (!strpos($block, 'A')) {
+ // 24-hour time format
+ // when [h]:mm format, the [h] should replace to the hours of the value * 24
+ $seekingBracket = true;
+ self::tryInterval($seekingBracket, $block, $value, '[h]');
+ self::tryInterval($seekingBracket, $block, $value, '[hh]');
+ self::tryInterval($seekingBracket, $block, $value, '[mm]');
+ self::tryInterval($seekingBracket, $block, $value, '[m]');
+ self::tryInterval($seekingBracket, $block, $value, '[s]');
+ self::tryInterval($seekingBracket, $block, $value, '[ss]');
+ $block = strtr($block, self::DATE_FORMAT_REPLACEMENTS24);
+ } else {
+ // 12-hour time format
+ $block = strtr($block, self::DATE_FORMAT_REPLACEMENTS12);
+ }
+ }
+ }
+ $format = implode('"', $blocks);
+
+ // escape any quoted characters so that DateTime format() will render them correctly
+ /** @var callable $callback */
+ $callback = [self::class, 'escapeQuotesCallback'];
+ $format = (string) preg_replace_callback('/"(.*)"/U', $callback, $format);
+
+ $dateObj = Date::excelToDateTimeObject($value);
+ // If the colon preceding minute had been quoted, as happens in
+ // Excel 2003 XML formats, m will not have been changed to i above.
+ // Change it now.
+ $format = (string) \preg_replace('/\\\\:m/', ':i', $format);
+ $microseconds = (int) $dateObj->format('u');
+ if (str_contains($format, ':s.000')) {
+ $milliseconds = (int) round($microseconds / 1000.0);
+ if ($milliseconds === 1000) {
+ $milliseconds = 0;
+ $dateObj->modify('+1 second');
+ }
+ $dateObj->modify("-$microseconds microseconds");
+ $format = str_replace(':s.000', ':s.' . sprintf('%03d', $milliseconds), $format);
+ } elseif (str_contains($format, ':s.00')) {
+ $centiseconds = (int) round($microseconds / 10000.0);
+ if ($centiseconds === 100) {
+ $centiseconds = 0;
+ $dateObj->modify('+1 second');
+ }
+ $dateObj->modify("-$microseconds microseconds");
+ $format = str_replace(':s.00', ':s.' . sprintf('%02d', $centiseconds), $format);
+ } elseif (str_contains($format, ':s.0')) {
+ $deciseconds = (int) round($microseconds / 100000.0);
+ if ($deciseconds === 10) {
+ $deciseconds = 0;
+ $dateObj->modify('+1 second');
+ }
+ $dateObj->modify("-$microseconds microseconds");
+ $format = str_replace(':s.0', ':s.' . sprintf('%1d', $deciseconds), $format);
+ } else { // no fractional second
+ if ($microseconds >= 500000) {
+ $dateObj->modify('+1 second');
+ }
+ $dateObj->modify("-$microseconds microseconds");
+ }
+
+ return $dateObj->format($format);
+ }
+
+ private static function setLowercaseCallback(array $matches): string
+ {
+ return mb_strtolower($matches[0]);
+ }
+
+ private static function escapeQuotesCallback(array $matches): string
+ {
+ return '\\' . implode('\\', str_split($matches[1]));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Formatter.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Formatter.php
new file mode 100644
index 00000000..f2d492e5
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Formatter.php
@@ -0,0 +1,189 @@
+' => $value > $comparisonValue,
+ '<' => $value < $comparisonValue,
+ '<=' => $value <= $comparisonValue,
+ '<>' => $value != $comparisonValue,
+ '=' => $value == $comparisonValue,
+ default => $value >= $comparisonValue,
+ };
+ }
+
+ /** @param float|int|string $value value to be formatted */
+ private static function splitFormatForSectionSelection(array $sections, mixed $value): array
+ {
+ // Extract the relevant section depending on whether number is positive, negative, or zero?
+ // Text not supported yet.
+ // Here is how the sections apply to various values in Excel:
+ // 1 section: [POSITIVE/NEGATIVE/ZERO/TEXT]
+ // 2 sections: [POSITIVE/ZERO/TEXT] [NEGATIVE]
+ // 3 sections: [POSITIVE/TEXT] [NEGATIVE] [ZERO]
+ // 4 sections: [POSITIVE] [NEGATIVE] [ZERO] [TEXT]
+ $sectionCount = count($sections);
+ // Colour could be a named colour, or a numeric index entry in the colour-palette
+ $color_regex = '/\\[(' . implode('|', Color::NAMED_COLORS) . '|color\\s*(\\d+))\\]/mui';
+ $cond_regex = '/\\[(>|>=|<|<=|=|<>)([+-]?\\d+([.]\\d+)?)\\]/';
+ $colors = ['', '', '', '', ''];
+ $conditionOperations = ['', '', '', '', ''];
+ $conditionComparisonValues = [0, 0, 0, 0, 0];
+ for ($idx = 0; $idx < $sectionCount; ++$idx) {
+ if (preg_match($color_regex, $sections[$idx], $matches)) {
+ if (isset($matches[2])) {
+ $colors[$idx] = '#' . BIFF8::lookup((int) $matches[2] + 7)['rgb'];
+ } else {
+ $colors[$idx] = $matches[0];
+ }
+ $sections[$idx] = (string) preg_replace($color_regex, '', $sections[$idx]);
+ }
+ if (preg_match($cond_regex, $sections[$idx], $matches)) {
+ $conditionOperations[$idx] = $matches[1];
+ $conditionComparisonValues[$idx] = $matches[2];
+ $sections[$idx] = (string) preg_replace($cond_regex, '', $sections[$idx]);
+ }
+ }
+ $color = $colors[0];
+ $format = $sections[0];
+ $absval = $value;
+ switch ($sectionCount) {
+ case 2:
+ $absval = abs($value);
+ if (!self::splitFormatComparison($value, $conditionOperations[0], $conditionComparisonValues[0], '>=', 0)) {
+ $color = $colors[1];
+ $format = $sections[1];
+ }
+
+ break;
+ case 3:
+ case 4:
+ $absval = abs($value);
+ if (!self::splitFormatComparison($value, $conditionOperations[0], $conditionComparisonValues[0], '>', 0)) {
+ if (self::splitFormatComparison($value, $conditionOperations[1], $conditionComparisonValues[1], '<', 0)) {
+ $color = $colors[1];
+ $format = $sections[1];
+ } else {
+ $color = $colors[2];
+ $format = $sections[2];
+ }
+ }
+
+ break;
+ }
+
+ return [$color, $format, $absval];
+ }
+
+ /**
+ * Convert a value in a pre-defined format to a PHP string.
+ *
+ * @param null|bool|float|int|RichText|string $value Value to format
+ * @param string $format Format code: see = self::FORMAT_* for predefined values;
+ * or can be any valid MS Excel custom format string
+ * @param ?array $callBack Callback function for additional formatting of string
+ *
+ * @return string Formatted string
+ */
+ public static function toFormattedString($value, string $format, ?array $callBack = null): string
+ {
+ if (is_bool($value)) {
+ return $value ? Calculation::getTRUE() : Calculation::getFALSE();
+ }
+ // For now we do not treat strings in sections, although section 4 of a format code affects strings
+ // Process a single block format code containing @ for text substitution
+ if (preg_match(self::SECTION_SPLIT, $format) === 0 && preg_match(self::SYMBOL_AT, $format) === 1) {
+ return str_replace('"', '', preg_replace(self::SYMBOL_AT, (string) $value, $format) ?? '');
+ }
+
+ // If we have a text value, return it "as is"
+ if (!is_numeric($value)) {
+ return (string) $value;
+ }
+
+ // For 'General' format code, we just pass the value although this is not entirely the way Excel does it,
+ // it seems to round numbers to a total of 10 digits.
+ if (($format === NumberFormat::FORMAT_GENERAL) || ($format === NumberFormat::FORMAT_TEXT)) {
+ return self::adjustSeparators((string) $value);
+ }
+
+ // Ignore square-$-brackets prefix in format string, like "[$-411]ge.m.d", "[$-010419]0%", etc
+ $format = (string) preg_replace('/^\[\$-[^\]]*\]/', '', $format);
+
+ $format = (string) preg_replace_callback(
+ '/(["])(?:(?=(\\\\?))\\2.)*?\\1/u',
+ fn (array $matches): string => str_replace('.', chr(0x00), $matches[0]),
+ $format
+ );
+
+ // Convert any other escaped characters to quoted strings, e.g. (\T to "T")
+ $format = (string) preg_replace('/(\\\(((.)(?!((AM\/PM)|(A\/P))))|([^ ])))(?=(?:[^"]|"[^"]*")*$)/ui', '"${2}"', $format);
+
+ // Get the sections, there can be up to four sections, separated with a semi-colon (but only if not a quoted literal)
+ $sections = preg_split(self::SECTION_SPLIT, $format) ?: [];
+
+ [$colors, $format, $value] = self::splitFormatForSectionSelection($sections, $value);
+
+ // In Excel formats, "_" is used to add spacing,
+ // The following character indicates the size of the spacing, which we can't do in HTML, so we just use a standard space
+ $format = (string) preg_replace('/_.?/ui', ' ', $format);
+
+ // Let's begin inspecting the format and converting the value to a formatted string
+ if (
+ // Check for date/time characters (not inside quotes)
+ (preg_match('/(\[\$[A-Z]*-[0-9A-F]*\])*[hmsdy](?=(?:[^"]|"[^"]*")*$)/miu', $format))
+ // A date/time with a decimal time shouldn't have a digit placeholder before the decimal point
+ && (preg_match('/[0\?#]\.(?![^\[]*\])/miu', $format) === 0)
+ ) {
+ // datetime format
+ $value = DateFormatter::format($value, $format);
+ } else {
+ if (str_starts_with($format, '"') && str_ends_with($format, '"') && substr_count($format, '"') === 2) {
+ $value = substr($format, 1, -1);
+ } elseif (preg_match('/[0#, ]%/', $format)) {
+ // % number format - avoid weird '-0' problem
+ $value = PercentageFormatter::format(0 + (float) $value, $format);
+ } else {
+ $value = NumberFormatter::format($value, $format);
+ }
+ }
+
+ // Additional formatting provided by callback function
+ if ($callBack !== null) {
+ [$writerInstance, $function] = $callBack;
+ $value = $writerInstance->$function($value, $colors);
+ }
+
+ return str_replace(chr(0x00), '.', $value);
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/FractionFormatter.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/FractionFormatter.php
new file mode 100644
index 00000000..ff80aa2f
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/FractionFormatter.php
@@ -0,0 +1,70 @@
+ 0);
+
+ return [
+ implode('.', $masks),
+ implode('.', array_reverse($postDecimalMasks)),
+ ];
+ }
+
+ private static function processComplexNumberFormatMask(mixed $number, string $mask): string
+ {
+ /** @var string $result */
+ $result = $number;
+ $maskingBlockCount = preg_match_all('/0+/', $mask, $maskingBlocks, PREG_OFFSET_CAPTURE);
+
+ if ($maskingBlockCount > 1) {
+ $maskingBlocks = array_reverse($maskingBlocks[0]);
+
+ $offset = 0;
+ foreach ($maskingBlocks as $block) {
+ $size = strlen($block[0]);
+ $divisor = 10 ** $size;
+ $offset = $block[1];
+
+ /** @var float $numberFloat */
+ $numberFloat = $number;
+ $blockValue = sprintf("%0{$size}d", fmod($numberFloat, $divisor));
+ $number = floor($numberFloat / $divisor);
+ $mask = substr_replace($mask, $blockValue, $offset, $size);
+ }
+ /** @var string $numberString */
+ $numberString = $number;
+ if ($number > 0) {
+ $mask = substr_replace($mask, $numberString, $offset, 0);
+ }
+ $result = $mask;
+ }
+
+ return self::makeString($result);
+ }
+
+ private static function complexNumberFormatMask(mixed $number, string $mask, bool $splitOnPoint = true): string
+ {
+ /** @var float $numberFloat */
+ $numberFloat = $number;
+ if ($splitOnPoint) {
+ $masks = explode('.', $mask);
+ if (count($masks) <= 2) {
+ $decmask = $masks[1] ?? '';
+ $decpos = substr_count($decmask, '0');
+ $numberFloat = round($numberFloat, $decpos);
+ }
+ }
+ $sign = ($numberFloat < 0.0) ? '-' : '';
+ $number = self::f2s(abs($numberFloat));
+
+ if ($splitOnPoint && str_contains($mask, '.') && str_contains($number, '.')) {
+ $numbers = explode('.', $number);
+ $masks = explode('.', $mask);
+ if (count($masks) > 2) {
+ $masks = self::mergeComplexNumberFormatMasks($numbers, $masks);
+ }
+ $integerPart = self::complexNumberFormatMask($numbers[0], $masks[0], false);
+ $numlen = strlen($numbers[1]);
+ $msklen = strlen($masks[1]);
+ if ($numlen < $msklen) {
+ $numbers[1] .= str_repeat('0', $msklen - $numlen);
+ }
+ $decimalPart = strrev(self::complexNumberFormatMask(strrev($numbers[1]), strrev($masks[1]), false));
+ $decimalPart = substr($decimalPart, 0, $msklen);
+
+ return "{$sign}{$integerPart}.{$decimalPart}";
+ }
+
+ if (strlen($number) < strlen($mask)) {
+ $number = str_repeat('0', strlen($mask) - strlen($number)) . $number;
+ }
+ $result = self::processComplexNumberFormatMask($number, $mask);
+
+ return "{$sign}{$result}";
+ }
+
+ public static function f2s(float $f): string
+ {
+ return self::floatStringConvertScientific((string) $f);
+ }
+
+ public static function floatStringConvertScientific(string $s): string
+ {
+ // convert only normalized form of scientific notation:
+ // optional sign, single digit 1-9,
+ // decimal point and digits (allowed to be omitted),
+ // E (e permitted), optional sign, one or more digits
+ if (preg_match('/^([+-])?([1-9])([.]([0-9]+))?[eE]([+-]?[0-9]+)$/', $s, $matches) === 1) {
+ $exponent = (int) $matches[5];
+ $sign = ($matches[1] === '-') ? '-' : '';
+ if ($exponent >= 0) {
+ $exponentPlus1 = $exponent + 1;
+ $out = $matches[2] . $matches[4];
+ $len = strlen($out);
+ if ($len < $exponentPlus1) {
+ $out .= str_repeat('0', $exponentPlus1 - $len);
+ }
+ $out = substr($out, 0, $exponentPlus1) . ((strlen($out) === $exponentPlus1) ? '' : ('.' . substr($out, $exponentPlus1)));
+ $s = "$sign$out";
+ } else {
+ $s = $sign . '0.' . str_repeat('0', -$exponent - 1) . $matches[2] . $matches[4];
+ }
+ }
+
+ return $s;
+ }
+
+ private static function formatStraightNumericValue(mixed $value, string $format, array $matches, bool $useThousands): string
+ {
+ /** @var float $valueFloat */
+ $valueFloat = $value;
+ $left = $matches[1];
+ $dec = $matches[2];
+ $right = $matches[3];
+
+ // minimun width of formatted number (including dot)
+ $minWidth = strlen($left) + strlen($dec) + strlen($right);
+ if ($useThousands) {
+ $value = number_format(
+ $valueFloat,
+ strlen($right),
+ StringHelper::getDecimalSeparator(),
+ StringHelper::getThousandsSeparator()
+ );
+
+ return self::pregReplace(self::NUMBER_REGEX, $value, $format);
+ }
+
+ if (preg_match('/[0#]E[+-]0/i', $format)) {
+ // Scientific format
+ $decimals = strlen($right);
+ $size = $decimals + 3;
+
+ return sprintf("%{$size}.{$decimals}E", $valueFloat);
+ } elseif (preg_match('/0([^\d\.]+)0/', $format) || substr_count($format, '.') > 1) {
+ if ($valueFloat == floor($valueFloat) && substr_count($format, '.') === 1) {
+ $value *= 10 ** strlen(explode('.', $format)[1]);
+ }
+
+ $result = self::complexNumberFormatMask($value, $format);
+ if (str_contains($result, 'E')) {
+ // This is a hack and doesn't match Excel.
+ // It will, at least, be an accurate representation,
+ // even if formatted incorrectly.
+ // This is needed for absolute values >=1E18.
+ $result = self::f2s($valueFloat);
+ }
+
+ return $result;
+ }
+
+ $sprintf_pattern = "%0$minWidth." . strlen($right) . 'F';
+
+ /** @var float $valueFloat */
+ $valueFloat = $value;
+ $value = self::adjustSeparators(sprintf($sprintf_pattern, round($valueFloat, strlen($right))));
+
+ return self::pregReplace(self::NUMBER_REGEX, $value, $format);
+ }
+
+ /** @param float|int|numeric-string $value value to be formatted */
+ public static function format(mixed $value, string $format): string
+ {
+ // The "_" in this string has already been stripped out,
+ // so this test is never true. Furthermore, testing
+ // on Excel shows this format uses Euro symbol, not "EUR".
+ // if ($format === NumberFormat::FORMAT_CURRENCY_EUR_SIMPLE) {
+ // return 'EUR ' . sprintf('%1.2f', $value);
+ // }
+
+ $baseFormat = $format;
+
+ $useThousands = self::areThousandsRequired($format);
+ $scale = self::scaleThousandsMillions($format);
+
+ if (preg_match('/[#\?0]?.*[#\?0]\/(\?+|\d+|#)/', $format)) {
+ // It's a dirty hack; but replace # and 0 digit placeholders with ?
+ $format = (string) preg_replace('/[#0]+\//', '?/', $format);
+ $format = (string) preg_replace('/\/[#0]+/', '/?', $format);
+ $value = FractionFormatter::format($value, $format);
+ } else {
+ // Handle the number itself
+ // scale number
+ $value = $value / $scale;
+ $paddingPlaceholder = (str_contains($format, '?'));
+
+ // Replace # or ? with 0
+ $format = self::pregReplace('/[\\#\?](?=(?:[^"]*"[^"]*")*[^"]*\Z)/', '0', $format);
+ // Remove locale code [$-###] for an LCID
+ $format = self::pregReplace('/\[\$\-.*\]/', '', $format);
+
+ $n = '/\\[[^\\]]+\\]/';
+ $m = self::pregReplace($n, '', $format);
+
+ // Some non-number strings are quoted, so we'll get rid of the quotes, likewise any positional * symbols
+ $format = self::makeString(str_replace(['"', '*'], '', $format));
+ if (preg_match(self::NUMBER_REGEX, $m, $matches)) {
+ // There are placeholders for digits, so inject digits from the value into the mask
+ $value = self::formatStraightNumericValue($value, $format, $matches, $useThousands);
+ if ($paddingPlaceholder === true) {
+ $value = self::padValue($value, $baseFormat);
+ }
+ } elseif ($format !== NumberFormat::FORMAT_GENERAL) {
+ // Yes, I know that this is basically just a hack;
+ // if there's no placeholders for digits, just return the format mask "as is"
+ $value = self::makeString(str_replace('?', '', $format));
+ }
+ }
+
+ if (preg_match('/\[\$(.*)\]/u', $format, $m)) {
+ // Currency or Accounting
+ $currencyCode = $m[1];
+ [$currencyCode] = explode('-', $currencyCode);
+ if ($currencyCode == '') {
+ $currencyCode = StringHelper::getCurrencyCode();
+ }
+ $value = self::pregReplace('/\[\$([^\]]*)\]/u', $currencyCode, (string) $value);
+ }
+
+ if (
+ (str_contains((string) $value, '0.'))
+ && ((str_contains($baseFormat, '#.')) || (str_contains($baseFormat, '?.')))
+ ) {
+ $value = preg_replace('/(\b)0\.|([^\d])0\./', '${2}.', (string) $value);
+ }
+
+ return (string) $value;
+ }
+
+ private static function makeString(array|string $value): string
+ {
+ return is_array($value) ? '' : "$value";
+ }
+
+ private static function pregReplace(string $pattern, string $replacement, string $subject): string
+ {
+ return self::makeString(preg_replace($pattern, $replacement, $subject) ?? '');
+ }
+
+ public static function padValue(string $value, string $baseFormat): string
+ {
+ $preDecimal = $postDecimal = '';
+ $pregArray = preg_split('/\.(?=(?:[^"]*"[^"]*")*[^"]*\Z)/miu', $baseFormat . '.?');
+ if (is_array($pregArray)) {
+ $preDecimal = $pregArray[0] ?? '';
+ $postDecimal = $pregArray[1] ?? '';
+ }
+
+ $length = strlen($value);
+ if (str_contains($postDecimal, '?')) {
+ $value = str_pad(rtrim($value, '0. '), $length, ' ', STR_PAD_RIGHT);
+ }
+ if (str_contains($preDecimal, '?')) {
+ $value = str_pad(ltrim($value, '0, '), $length, ' ', STR_PAD_LEFT);
+ }
+
+ return $value;
+ }
+
+ /**
+ * Find out if we need thousands separator
+ * This is indicated by a comma enclosed by a digit placeholders: #, 0 or ?
+ */
+ public static function areThousandsRequired(string &$format): bool
+ {
+ $useThousands = (bool) preg_match('/([#\?0]),([#\?0])/', $format);
+ if ($useThousands) {
+ $format = self::pregReplace('/([#\?0]),([#\?0])/', '${1}${2}', $format);
+ }
+
+ return $useThousands;
+ }
+
+ /**
+ * Scale thousands, millions,...
+ * This is indicated by a number of commas after a digit placeholder: #, or 0.0,, or ?,.
+ */
+ public static function scaleThousandsMillions(string &$format): int
+ {
+ $scale = 1; // same as no scale
+ if (preg_match('/(#|0|\?)(,+)/', $format, $matches)) {
+ $scale = 1000 ** strlen($matches[2]);
+ // strip the commas
+ $format = self::pregReplace('/([#\?0]),+/', '${1}', $format);
+ }
+
+ return $scale;
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/PercentageFormatter.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/PercentageFormatter.php
new file mode 100644
index 00000000..bb5b3554
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/PercentageFormatter.php
@@ -0,0 +1,48 @@
+ 0);
+ $replacement = "0{$wholePartSize}.{$decimalPartSize}";
+ $mask = (string) preg_replace('/[#0,]+\.?[?#0,]*/ui', "%{$replacement}F{$placeHolders}", $format);
+
+ /** @var float $valueFloat */
+ $valueFloat = $value;
+
+ return self::adjustSeparators(sprintf($mask, round($valueFloat, $decimalPartSize)));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Accounting.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Accounting.php
new file mode 100644
index 00000000..43fd8cac
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Accounting.php
@@ -0,0 +1,102 @@
+setCurrencyCode($currencyCode);
+ $this->setThousandsSeparator($thousandsSeparator);
+ $this->setDecimals($decimals);
+ $this->setCurrencySymbolPosition($currencySymbolPosition);
+ $this->setCurrencySymbolSpacing($currencySymbolSpacing);
+ $this->setLocale($locale);
+ $this->stripLeadingRLM = $stripLeadingRLM;
+ }
+
+ /**
+ * @throws Exception if the Intl extension and ICU version don't support Accounting formats
+ */
+ protected function getLocaleFormat(): string
+ {
+ if (self::icuVersion() < 53.0) {
+ // @codeCoverageIgnoreStart
+ throw new Exception('The Intl extension does not support Accounting Formats without ICU 53');
+ // @codeCoverageIgnoreEnd
+ }
+
+ // Scrutinizer does not recognize CURRENCY_ACCOUNTING
+ $formatter = new Locale($this->fullLocale, NumberFormatter::CURRENCY_ACCOUNTING);
+ $mask = $formatter->format($this->stripLeadingRLM);
+ if ($this->decimals === 0) {
+ $mask = (string) preg_replace('/\.0+/miu', '', $mask);
+ }
+
+ return str_replace('¤', $this->formatCurrencyCode(), $mask);
+ }
+
+ public static function icuVersion(): float
+ {
+ [$major, $minor] = explode('.', INTL_ICU_VERSION);
+
+ return (float) "{$major}.{$minor}";
+ }
+
+ private function formatCurrencyCode(): string
+ {
+ if ($this->locale === null) {
+ return $this->currencyCode . '*';
+ }
+
+ return "[\${$this->currencyCode}-{$this->locale}]";
+ }
+
+ public function format(): string
+ {
+ if ($this->localeFormat !== null) {
+ return $this->localeFormat;
+ }
+
+ return sprintf(
+ '_-%s%s%s0%s%s%s_-',
+ $this->currencySymbolPosition === self::LEADING_SYMBOL ? $this->formatCurrencyCode() : null,
+ (
+ $this->currencySymbolPosition === self::LEADING_SYMBOL
+ && $this->currencySymbolSpacing === self::SYMBOL_WITH_SPACING
+ ) ? "\u{a0}" : '',
+ $this->thousandsSeparator ? '#,##' : null,
+ $this->decimals > 0 ? '.' . str_repeat('0', $this->decimals) : null,
+ (
+ $this->currencySymbolPosition === self::TRAILING_SYMBOL
+ && $this->currencySymbolSpacing === self::SYMBOL_WITH_SPACING
+ ) ? "\u{a0}" : '',
+ $this->currencySymbolPosition === self::TRAILING_SYMBOL ? $this->formatCurrencyCode() : null
+ );
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Currency.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Currency.php
new file mode 100644
index 00000000..bba4d250
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Currency.php
@@ -0,0 +1,125 @@
+setCurrencyCode($currencyCode);
+ $this->setThousandsSeparator($thousandsSeparator);
+ $this->setDecimals($decimals);
+ $this->setCurrencySymbolPosition($currencySymbolPosition);
+ $this->setCurrencySymbolSpacing($currencySymbolSpacing);
+ $this->setLocale($locale);
+ $this->stripLeadingRLM = $stripLeadingRLM;
+ }
+
+ public function setCurrencyCode(string $currencyCode): void
+ {
+ $this->currencyCode = $currencyCode;
+ }
+
+ public function setCurrencySymbolPosition(bool $currencySymbolPosition = self::LEADING_SYMBOL): void
+ {
+ $this->currencySymbolPosition = $currencySymbolPosition;
+ }
+
+ public function setCurrencySymbolSpacing(bool $currencySymbolSpacing = self::SYMBOL_WITHOUT_SPACING): void
+ {
+ $this->currencySymbolSpacing = $currencySymbolSpacing;
+ }
+
+ public function setStripLeadingRLM(bool $stripLeadingRLM): void
+ {
+ $this->stripLeadingRLM = $stripLeadingRLM;
+ }
+
+ protected function getLocaleFormat(): string
+ {
+ $formatter = new Locale($this->fullLocale, NumberFormatter::CURRENCY);
+ $mask = $formatter->format($this->stripLeadingRLM);
+ if ($this->decimals === 0) {
+ $mask = (string) preg_replace('/\.0+/miu', '', $mask);
+ }
+
+ return str_replace('¤', $this->formatCurrencyCode(), $mask);
+ }
+
+ private function formatCurrencyCode(): string
+ {
+ if ($this->locale === null) {
+ return $this->currencyCode;
+ }
+
+ return "[\${$this->currencyCode}-{$this->locale}]";
+ }
+
+ public function format(): string
+ {
+ if ($this->localeFormat !== null) {
+ return $this->localeFormat;
+ }
+
+ return sprintf(
+ '%s%s%s0%s%s%s',
+ $this->currencySymbolPosition === self::LEADING_SYMBOL ? $this->formatCurrencyCode() : null,
+ (
+ $this->currencySymbolPosition === self::LEADING_SYMBOL
+ && $this->currencySymbolSpacing === self::SYMBOL_WITH_SPACING
+ ) ? "\u{a0}" : '',
+ $this->thousandsSeparator ? '#,##' : null,
+ $this->decimals > 0 ? '.' . str_repeat('0', $this->decimals) : null,
+ (
+ $this->currencySymbolPosition === self::TRAILING_SYMBOL
+ && $this->currencySymbolSpacing === self::SYMBOL_WITH_SPACING
+ ) ? "\u{a0}" : '',
+ $this->currencySymbolPosition === self::TRAILING_SYMBOL ? $this->formatCurrencyCode() : null
+ );
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Date.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Date.php
new file mode 100644
index 00000000..61ac117b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Date.php
@@ -0,0 +1,125 @@
+separators = $this->padSeparatorArray(
+ is_array($separators) ? $separators : [$separators],
+ count($formatBlocks) - 1
+ );
+ $this->formatBlocks = array_map([$this, 'mapFormatBlocks'], $formatBlocks);
+ }
+
+ private function mapFormatBlocks(string $value): string
+ {
+ // Any date masking codes are returned as lower case values
+ if (in_array(mb_strtolower($value), self::DATE_BLOCKS, true)) {
+ return mb_strtolower($value);
+ }
+
+ // Wrap any string literals in quotes, so that they're clearly defined as string literals
+ return $this->wrapLiteral($value);
+ }
+
+ public function format(): string
+ {
+ return implode('', array_map([$this, 'intersperse'], $this->formatBlocks, $this->separators));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/DateTime.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/DateTime.php
new file mode 100644
index 00000000..c0fdeed4
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/DateTime.php
@@ -0,0 +1,46 @@
+
+ */
+ protected array $formatBlocks;
+
+ /**
+ * @param null|string|string[] $separators
+ * If you want to use only a single format block, then pass a null as the separator argument
+ * @param DateTimeWizard|string ...$formatBlocks
+ */
+ public function __construct($separators, ...$formatBlocks)
+ {
+ $this->separators = $this->padSeparatorArray(
+ is_array($separators) ? $separators : [$separators],
+ count($formatBlocks) - 1
+ );
+ $this->formatBlocks = array_map([$this, 'mapFormatBlocks'], $formatBlocks);
+ }
+
+ private function mapFormatBlocks(DateTimeWizard|string $value): string
+ {
+ // Any date masking codes are returned as lower case values
+ if ($value instanceof DateTimeWizard) {
+ return $value->__toString();
+ }
+
+ // Wrap any string literals in quotes, so that they're clearly defined as string literals
+ return $this->wrapLiteral($value);
+ }
+
+ public function format(): string
+ {
+ return implode('', array_map([$this, 'intersperse'], $this->formatBlocks, $this->separators));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/DateTimeWizard.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/DateTimeWizard.php
new file mode 100644
index 00000000..8cd7da7c
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/DateTimeWizard.php
@@ -0,0 +1,46 @@
+= ";
+
+ protected function padSeparatorArray(array $separators, int $count): array
+ {
+ $lastSeparator = array_pop($separators);
+
+ return $separators + array_fill(0, $count, $lastSeparator);
+ }
+
+ protected function escapeSingleCharacter(string $value): string
+ {
+ if (str_contains(self::NO_ESCAPING_NEEDED, $value)) {
+ return $value;
+ }
+
+ return "\\{$value}";
+ }
+
+ protected function wrapLiteral(string $value): string
+ {
+ if (mb_strlen($value, 'UTF-8') === 1) {
+ return $this->escapeSingleCharacter($value);
+ }
+
+ // Wrap any other string literals in quotes, so that they're clearly defined as string literals
+ return '"' . str_replace('"', '""', $value) . '"';
+ }
+
+ protected function intersperse(string $formatBlock, ?string $separator): string
+ {
+ return "{$formatBlock}{$separator}";
+ }
+
+ public function __toString(): string
+ {
+ return $this->format();
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Duration.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Duration.php
new file mode 100644
index 00000000..b81f77ac
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Duration.php
@@ -0,0 +1,153 @@
+ self::DAYS_DURATION,
+ self::HOURS_DURATION => self::HOURS_SHORT,
+ self::MINUTES_DURATION => self::MINUTES_LONG,
+ self::SECONDS_DURATION => self::SECONDS_LONG,
+ ];
+
+ protected const DURATION_DEFAULTS = [
+ self::HOURS_LONG => self::HOURS_DURATION,
+ self::HOURS_SHORT => self::HOURS_DURATION,
+ self::MINUTES_LONG => self::MINUTES_DURATION,
+ self::MINUTES_SHORT => self::MINUTES_DURATION,
+ self::SECONDS_LONG => self::SECONDS_DURATION,
+ self::SECONDS_SHORT => self::SECONDS_DURATION,
+ ];
+
+ public const SEPARATOR_COLON = ':';
+ public const SEPARATOR_SPACE_NONBREAKING = "\u{a0}";
+ public const SEPARATOR_SPACE = ' ';
+
+ public const DURATION_DEFAULT = [
+ self::HOURS_DURATION,
+ self::MINUTES_LONG,
+ self::SECONDS_LONG,
+ ];
+
+ /**
+ * @var string[]
+ */
+ protected array $separators;
+
+ /**
+ * @var string[]
+ */
+ protected array $formatBlocks;
+
+ protected bool $durationIsSet = false;
+
+ /**
+ * @param null|string|string[] $separators
+ * If you want to use the same separator for all format blocks, then it can be passed as a string literal;
+ * if you wish to use different separators, then they should be passed as an array.
+ * If you want to use only a single format block, then pass a null as the separator argument
+ */
+ public function __construct($separators = self::SEPARATOR_COLON, string ...$formatBlocks)
+ {
+ $separators ??= self::SEPARATOR_COLON;
+ $formatBlocks = (count($formatBlocks) === 0) ? self::DURATION_DEFAULT : $formatBlocks;
+
+ $this->separators = $this->padSeparatorArray(
+ is_array($separators) ? $separators : [$separators],
+ count($formatBlocks) - 1
+ );
+ $this->formatBlocks = array_map([$this, 'mapFormatBlocks'], $formatBlocks);
+
+ if ($this->durationIsSet === false) {
+ // We need at least one duration mask, so if none has been set we change the first mask element
+ // to a duration.
+ $this->formatBlocks[0] = self::DURATION_DEFAULTS[mb_strtolower($this->formatBlocks[0])];
+ }
+ }
+
+ private function mapFormatBlocks(string $value): string
+ {
+ // Any duration masking codes are returned as lower case values
+ if (in_array(mb_strtolower($value), self::DURATION_BLOCKS, true)) {
+ if (array_key_exists(mb_strtolower($value), self::DURATION_MASKS)) {
+ if ($this->durationIsSet) {
+ // We should only have a single duration mask, the first defined in the mask set,
+ // so convert any additional duration masks to standard time masks.
+ $value = self::DURATION_MASKS[mb_strtolower($value)];
+ }
+ $this->durationIsSet = true;
+ }
+
+ return mb_strtolower($value);
+ }
+
+ // Wrap any string literals in quotes, so that they're clearly defined as string literals
+ return $this->wrapLiteral($value);
+ }
+
+ public function format(): string
+ {
+ return implode('', array_map([$this, 'intersperse'], $this->formatBlocks, $this->separators));
+ }
+}
diff --git a/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Locale.php b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Locale.php
new file mode 100644
index 00000000..0c02286b
--- /dev/null
+++ b/api/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Style/NumberFormat/Wizard/Locale.php
@@ -0,0 +1,39 @@
+[a-z]{2})([-_](?P | | | | | | | | | | | | |