Add package code

.editorconfig

@@ -0,0 +1,11 @@
+# editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true

.gitattributes

@@ -0,0 +1,10 @@
+/.github            export-ignore
+/.gitattributes     export-ignore
+/.gitignore         export-ignore
+/phpunit.xml.dist   export-ignore
+/tests              export-ignore
+/.editorconfig      export-ignore
+/.php_cs.dist.php   export-ignore
+/psalm.xml          export-ignore
+/psalm.xml.dist     export-ignore
+/UPGRADING.md       export-ignore

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,8 @@
+| Q             | A
+| ------------- | ---
+| Branch?       |
+| Bug fix?      | ✔️/❌
+| Breaks BC?    | ✔️/❌
+| New feature?  | ✔️/❌
+| Deprecations? | ✔️/❌
+| Issues        | #... <!-- prefix each issue number with "#" symbol, no need to create an issue if none exist, explain below instead -->

.github/dependabot.yml

@@ -0,0 +1,12 @@
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+
+    - package-ecosystem: "github-actions"
+      directory: "/"
+      schedule:
+          interval: "weekly"
+      labels:
+          - "dependencies"

.github/workflows/coding-standards.yml

@@ -0,0 +1,14 @@
+on:
+    pull_request: null
+    push:
+        branches:
+            - '*.*'
+
+name: cs
+
+jobs:
+    phpunit:
+        uses: spiral/gh-actions/.github/workflows/cs.yml@master
+        with:
+            os: >-
+                ['ubuntu-latest']

.github/workflows/phpunit.yml

@@ -0,0 +1,16 @@
+on:
+    pull_request: null
+    push:
+        branches:
+            - '*.*'
+
+name: phpunit
+
+jobs:
+    phpunit:
+        uses: spiral/gh-actions/.github/workflows/phpunit.yml@master
+        with:
+            os: >-
+                ['ubuntu-latest']
+            stability: >-
+                ['prefer-stable']

.github/workflows/psalm.yml

@@ -0,0 +1,14 @@
+on:
+    pull_request: null
+    push:
+        branches:
+            - '*.*'
+
+name: static analysis
+
+jobs:
+    psalm:
+        uses: spiral/gh-actions/.github/workflows/psalm.yml@master
+        with:
+            os: >-
+                ['ubuntu-latest']

.github/workflows/security.yml

@@ -0,0 +1,56 @@
+on:
+    pull_request: null
+    push:
+        branches:
+            - '*.*'
+
+name: build
+
+jobs:
+    security:
+        name: Security
+        runs-on: ${{ matrix.os }}
+
+        strategy:
+            fail-fast: false
+            matrix:
+                php: ['8.3']
+                os: [ubuntu-latest]
+
+        steps:
+            - name: Set Git To Use LF
+              run: |
+                  git config --global core.autocrlf false
+                  git config --global core.eol lf
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Setup PHP ${{ matrix.php }}
+              uses: shivammathur/setup-php@v2
+              with:
+                  php-version: ${{ matrix.php }}
+
+            - name: Validate Composer
+              run: composer validate
+
+            - name: Get Composer Cache Directory
+                # Docs: <https://github.com/actions/cache/blob/master/examples.md#php---composer>
+              id: composer-cache
+              run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+
+            - name: Restore Composer Cache
+              uses: actions/cache@v3
+              with:
+                  path: ${{ steps.composer-cache.outputs.dir }}
+                  key: ${{ runner.os }}-${{ matrix.php }}-composer-${{ hashFiles('**/composer.json') }}
+                  restore-keys: ${{ runner.os }}-${{ matrix.php }}-composer-
+
+            - name: Install Dependencies
+              uses: nick-invision/retry@v2
+              with:
+                  timeout_minutes: 5
+                  max_attempts: 5
+                  command: composer update --prefer-dist --no-interaction --no-progress
+
+            - name: Security Advisories
+              run: composer require --dev roave/security-advisories:dev-latest

.gitignore

@@ -0,0 +1,13 @@
+.idea
+.php_cs
+.php_cs.cache
+.phpunit.result.cache
+build
+composer.lock
+coverage
+docs
+phpunit.xml
+vendor
+node_modules
+.php-cs-fixer.cache
+.phpunit.cache

.php-cs-fixer.dist.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+if (!file_exists(__DIR__.'/src')) {
+    exit(0);
+}
+
+return (new PhpCsFixer\Config())
+    ->setRules([
+        '@PHP71Migration' => true,
+        '@PHPUnit75Migration:risky' => true,
+        '@Symfony' => true,
+        '@Symfony:risky' => true,
+        'protected_to_private' => false,
+        'phpdoc_to_comment' => false,
+        'single_line_throw' => false,
+        'native_constant_invocation' => ['strict' => false],
+        'nullable_type_declaration_for_default_null_value' => ['use_nullable_type_declaration' => false],
+        'modernize_strpos' => true,
+    ])
+    ->setRiskyAllowed(true)
+    ->setFinder(
+        (new PhpCsFixer\Finder())
+            ->in(__DIR__.'/src')
+            ->append([__FILE__])
+    )
+    ->setCacheFile('.php-cs-fixer.cache');

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) SpiralPackages
+
+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.