.gitattributes

@@ -3,4 +3,9 @@
 /.gitattributes export-ignore
 /.gitignore export-ignore
 /phpunit.xml export-ignore
-/phpstan.neon export-ignore
+/phpstan.neon export-ignore
+/.php-cs-fixer.dist.php export-ignore
+/psalm.xml export-ignore
+/docker-compose.yml export-ignore
+/Dockerfile export-ignore
+/coverage.svg export-ignore

.github/PULL_REQUEST_TEMPLATE/FEATURE.md

@@ -0,0 +1,18 @@
+---
+name: New Feature
+labels: enhancement
+---
+
+## Requirements
+
+- [ ] Updated README.md
+- [ ] Add PHPUnit test
+- [ ] Added related lexoffice documentation
+
+## Description
+
+Tell us about the new feature
+
+## Related lexoffice documentation
+
+<insert related lexoffice documentation link here>

.github/workflows/codestyle.yml

@@ -0,0 +1,21 @@
+name: Run PHP-CS-Fixer
+
+on: [pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/cache@v3
+        with:
+          path: .php-cs-fixer.cache
+          key: ${{ runner.OS }}-${{ github.repository }}-phpcsfixer-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.OS }}-${{ github.repository }}-phpcsfixer-
+      
+      - uses: docker://oskarstark/php-cs-fixer-ga
+        with:
+          args: --diff --dry-run

.github/workflows/coverage-report.yml

@@ -0,0 +1,37 @@
+name: Coverage Report
+
+on:
+  push:
+    branches: [ development ]
+
+jobs:
+  coverage:
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: true
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.3
+          coverage: xdebug        
+
+      - name: Install dependencies
+        run: |
+          composer install --prefer-dist
+
+      - name: Execute tests with coverage
+        run: vendor/bin/phpunit  --configuration 'phpunit.xml' --coverage-cobertura=coverage-cobertura.xml
+
+      - name: Make Coverage Badge
+        uses: action-badges/cobertura-coverage-xml-badges@0.3.0
+        with:
+          file-name: coverage.svg
+          badge-branch: badges
+          github-token: '${{ secrets.GITHUB_TOKEN }}'
+          coverage-file-name: ./coverage-cobertura.xml

.github/workflows/phpstan.yml

@@ -1,4 +1,4 @@
-name: Run Shepherd
+name: Run PHPStan
 
 on: [pull_request]
 
@@ -12,6 +12,6 @@ jobs:
       - uses: php-actions/phpstan@v3
         with:
           path: src/ tests/
-          level: 9
+          level: 10
 
 

.github/workflows/psalm.yml

@@ -0,0 +1,25 @@
+name: Run Psalm
+
+on:
+  push:
+    branches: [ development ]
+  pull_request:
+    branches: [ development ]
+
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - if: ${{ github.event_name == 'pull_request' }}
+        uses: docker://ghcr.io/psalm/psalm-github-actions
+        with:
+          composer_require_dev: true
+
+      - if: ${{ github.event_name != 'pull_request' }}
+        uses: docker://ghcr.io/psalm/psalm-github-actions
+        with:
+          composer_require_dev: true
+          args: --shepherd

.github/workflows/tests.yml

@@ -14,7 +14,7 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        php: [8.3, 8.2, 8.1]
+        php: [8.4, 8.3, 8.2, 8.1]
         dependency-version: [prefer-lowest, prefer-stable]
 
     name: PHP${{ matrix.php }} - ${{ matrix.dependency-version }}

.gitignore

@@ -1,7 +1,8 @@
 /tests/cache/
+/coverage*
 
-# Created by https://www.toptal.com/developers/gitignore/api/windows,macos,linux,composer,phpunit,phpstorm+all,visualstudiocode
-# Edit at https://www.toptal.com/developers/gitignore?templates=windows,macos,linux,composer,phpunit,phpstorm+all,visualstudiocode
+# Created by https://www.toptal.com/developers/gitignore/api/windows,macos,linux,composer,phpunit,phpstorm+all,visualstudiocode,php-cs-fixer
+# Edit at https://www.toptal.com/developers/gitignore?templates=windows,macos,linux,composer,phpunit,phpstorm+all,visualstudiocode,php-cs-fixer
 
 ### Composer ###
 composer.phar
@@ -59,6 +60,16 @@ Temporary Items
 # iCloud generated files
 *.icloud
 
+### PHP-CS-Fixer ###
+# Covers PHP CS Fixer
+# Reference: https://cs.symfony.com/
+
+# Generated files
+.php-cs-fixer.cache
+
+# Local config See: https://cs.symfony.com/doc/config.html
+.php-cs-fixer.php
+
 ### PhpStorm+all ###
 # Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
 # Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
@@ -207,4 +218,4 @@ $RECYCLE.BIN/
 # Windows shortcuts
 *.lnk
 
-# End of https://www.toptal.com/developers/gitignore/api/windows,macos,linux,composer,phpunit,phpstorm+all,visualstudiocode
+# End of https://www.toptal.com/developers/gitignore/api/windows,macos,linux,composer,phpunit,phpstorm+all,visualstudiocode,php-cs-fixer

.php-cs-fixer.dist.php

@@ -0,0 +1,102 @@
+<?php declare(strict_types=1);
+
+$finder = PhpCsFixer\Finder::create()
+    ->files()
+    ->in(__DIR__ . '/src')
+    ->in(__DIR__ . '/tests');
+
+return (new PhpCsFixer\Config())
+    ->setFinder($finder)
+    ->setRiskyAllowed(true)
+    ->setRules([
+        '@PSR12' => true,
+        'declare_strict_types' => true,
+        'modernize_types_casting' => true,
+        'multiline_comment_opening_closing' => true,
+        'multiline_whitespace_before_semicolons' => true,
+        'native_type_declaration_casing' => true,
+        'ordered_imports' => ['imports_order' => ['class', 'function', 'const'], 'sort_algorithm' => 'alpha'],
+        'ordered_traits' => true,
+        'no_alias_functions' => true,
+        'no_alias_language_construct_call' => true,
+        'no_alternative_syntax' => true,
+        'no_binary_string' => true,
+        'no_blank_lines_after_phpdoc' => true,
+        'no_empty_comment' => true,
+        'no_empty_statement' => true,
+        'no_extra_blank_lines' => true,
+        'no_homoglyph_names' => true,
+        'no_leading_namespace_whitespace' => true,
+        'no_multiline_whitespace_around_double_arrow' => true,
+        'no_null_property_initialization' => true,
+        'no_short_bool_cast' => true,
+        'no_singleline_whitespace_before_semicolons' => true,
+        'no_spaces_around_offset' => true,
+        'no_superfluous_elseif' => true,
+        'no_superfluous_phpdoc_tags' => [
+            'allow_mixed' => true,
+        ],
+        'no_trailing_comma_in_singleline' => true,
+        'no_trailing_whitespace_in_string' => true,
+        'no_unneeded_braces' => true,
+        'no_unneeded_control_parentheses' => true,
+        'no_unneeded_import_alias' => true,
+        'no_unset_cast' => true,
+        'no_unset_on_property' => true,
+        'no_unused_imports' => true,
+        'no_useless_concat_operator' => true,
+        'no_useless_else' => true,
+        'no_useless_nullsafe_operator' => true,
+        'no_useless_return' => true,
+        'no_whitespace_before_comma_in_array' => true,
+        'non_printable_character' => true,
+        'normalize_index_brace' => true,
+        'php_unit_set_up_tear_down_visibility' => true,
+        'php_unit_test_case_static_method_calls' => [
+            'call_type' => 'this',
+        ],
+        'phpdoc_add_missing_param_annotation' => false,
+        'phpdoc_align' => true,
+        'phpdoc_annotation_without_dot' => true,
+        'phpdoc_indent' => true,
+        'phpdoc_inline_tag_normalizer' => true,
+        'phpdoc_no_access' => true,
+        'phpdoc_no_alias_tag' => true,
+        'phpdoc_no_empty_return' => true,
+        'phpdoc_no_package' => true,
+        'phpdoc_no_useless_inheritdoc' => true,
+        'phpdoc_order' => true,
+        'phpdoc_order_by_value' => [
+            'annotations' => [
+                'covers',
+                'dataProvider',
+                'throws',
+                'uses',
+            ],
+        ],
+        'phpdoc_param_order' => true,
+        'phpdoc_return_self_reference' => true,
+        'phpdoc_scalar' => true,
+        'phpdoc_separation' => true,
+        'phpdoc_single_line_var_spacing' => true,
+        'phpdoc_summary' => true,
+        'phpdoc_tag_casing' => true,
+        'phpdoc_tag_type' => true,
+        'phpdoc_to_comment' => false,
+        'phpdoc_trim' => true,
+        'simplified_null_return' => true,
+        'single_line_comment_spacing' => true,
+        'single_quote' => true,
+        'single_space_around_construct' => true,
+        'space_after_semicolon' => true,
+        'standardize_increment' => true,
+        'standardize_not_equals' => true,
+        'static_lambda' => true,
+        'strict_param' => true,
+        'string_length_to_empty'=> true,
+        'string_line_ending' => true,
+        'switch_continue_to_break' => true,
+        'trim_array_spaces' => true,
+        'whitespace_after_comma_in_array' => true,
+    ])
+    ->setLineEnding("\n");

Dockerfile

@@ -0,0 +1,34 @@
+FROM php:8.2-fpm
+
+ENV XDEBUG_MODE='coverage' \
+    XDEBUG_CONFIG='client_host=host.docker.internal output_dir=/var/www/tmp'
+
+# install non php modules
+RUN apt-get update \
+    && apt-get install --no-install-recommends -y \
+        libssl-dev \
+        libcurl4-openssl-dev \
+        libzip-dev \
+        libxml2-dev \
+        libonig-dev \
+        libc-client-dev \
+        libkrb5-dev \
+        zlib1g-dev \
+        zip \
+        unzip \
+        git \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install PHP Extension for PHPUnit und Composer
+RUN docker-php-ext-install \
+    zip \
+    mbstring \
+    xml \
+    curl
+
+RUN pecl install xdebug \
+    && docker-php-ext-enable xdebug;
+
+COPY --from=composer /usr/bin/composer /usr/bin/composer
+
+WORKDIR /var/www/html

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Sysix
+Copyright (c) 2023-2025 Sysix
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal