Initial commit

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,128 @@
+# 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, 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
+[email protected].
+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.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

.github/FUNDING.yml

@@ -0,0 +1,5 @@
+---
+
+github: wayofdev
+
+...

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,13 @@
+#### Steps required to reproduce the problem
+
+1.
+2.
+3.
+
+#### Expected Result
+
+*
+
+#### Actual Result
+
+*

.github/labeler.yml

@@ -0,0 +1,15 @@
+---
+
+# this file is for the labeler workflow job
+# Documentation https://github.com/marketplace/actions/labeler
+
+'type: documentation':
+ - assets/**/*
+ - .github/*
+ - ./*.md
+
+'type: maintenance':
+ - .github/**/*
+ - tests/**/*
+
+...

.github/workflows/apply-labels.yml

@@ -0,0 +1,23 @@
+---
+
+# This workflow will triage pull requests and apply a label based on the
+# paths that are modified in the pull request.
+#
+# To use this workflow, you will need to set up a .github/labeler.yml
+# file with configuration. For more information, see:
+# https://github.com/actions/labeler/blob/master/README.md
+
+on: # yamllint disable-line rule:truthy
+ pull_request:
+
+name: 🏷️ Add labels
+
+jobs:
+ label:
+ uses: wayofdev/gh-actions/.github/workflows/apply-labels.yml@master
+ with:
+ os: ubuntu-latest
+ secrets:
+ token: ${{ secrets.GITHUB_TOKEN }}
+
+...

.github/workflows/auto-merge-release.yaml

@@ -0,0 +1,26 @@
+---
+
+# https://github.com/peter-evans/enable-pull-request-automerge
+
+on: # yamllint disable-line rule:truthy
+ pull_request:
+
+permissions:
+ pull-requests: write
+ contents: write
+
+name: 🤞 Auto merge release
+
+jobs:
+ auto-merge:
+ uses: wayofdev/gh-actions/.github/workflows/auto-merge-release.yml@master
+ with:
+ os: ubuntu-latest
+ pull-request-number: ${{ github.event.pull_request.number }}
+ actor: lotyp
+ merge-method: merge
+ secrets:
+ # to trigger other workflows, pass PAT token instead of GITHUB_TOKEN
+ token: ${{ secrets.PERSONAL_GITHUB_TOKEN }}
+
+...

.github/workflows/ci.yml

@@ -0,0 +1,72 @@
+---
+
+on: # yamllint disable-line rule:truthy
+ pull_request:
+ branches:
+ - master
+
+name: 🔍 Continuous integration
+
+jobs:
+ integration:
+ runs-on: ${{ matrix.os }}
+ strategy:
+ fail-fast: true
+ matrix:
+ os: ["ubuntu-22.04"]
+ php: ["8.2"]
+
+ steps:
+ - name: 📦 Check out the codebase
+ uses: actions/checkout@v4
+
+ - name: 🛠️ Setup PHP
+ uses: shivammathur/setup-php@v2
+ with:
+ php-version: ${{ matrix.php }}
+ extensions: mbstring, fileinfo
+ ini-values: error_reporting=E_ALL
+ tools: composer:v2, pecl
+ coverage: xdebug
+
+ - name: 🛠️ Setup problem matchers
+ run: |
+ echo "::add-matcher::${{ runner.tool_cache }}/php.json"
+ echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
+
+ - name: ♻️ Restore cached dependencies
+ id: cached-composer-dependencies
+ uses: actions/cache@v4
+ with:
+ path: vendor
+ key: vendor-${{ runner.os }}-${{ hashFiles('**/composer.lock') }}-${{ matrix.php }}
+
+ - name: 📥 Install dependencies
+ if: steps.cached-composer-dependencies.outputs.cache-hit != 'true'
+ run: composer install
+
+ - name: 🛠️ Prepare environment
+ run: |
+ mkdir -p ./.build/php-cs-fixer
+ mkdir -p ./.build/phpstan
+ mkdir -p ./.build/phpunit
+
+ - name: 🚨 Run coding standards task
+ run: composer cs:diff
+ env:
+ PHP_CS_FIXER_IGNORE_ENV: true
+
+ - name: 🧪 Execute phpunit and pest tests
+ run: composer test:cc
+
+ - name: 🔍 Run static analysis using phpstan
+ run: composer stan:ci
+
+ - name: 📤 Upload coverage report to Codecov
+ uses: codecov/codecov-action@v4
+ with:
+ token: ${{ secrets.CODECOV_TOKEN }}
+ files: ./coverage.xml
+ verbose: true
+
+...

.github/workflows/create-arch-diagram.yml

@@ -0,0 +1,29 @@
+---
+
+# This workflow was added by CodeSee. Learn more at https://codesee.io/
+# This is v2.0 of this workflow file
+
+on: # yamllint disable-line rule:truthy
+ push:
+ branches:
+ - develop
+ pull_request_target:
+ types:
+ - opened
+ - synchronize
+ - reopened
+
+name: 🤖 CodeSee
+
+permissions: read-all
+
+jobs:
+ codesee:
+ uses: wayofdev/gh-actions/.github/workflows/create-arch-diagram.yml@master
+ with:
+ os: ubuntu-latest
+ continue-on-error: true
+ secrets:
+ codesee-token: ${{ secrets.CODESEE_ARCH_DIAG_API_TOKEN }}
+
+...

.github/workflows/create-release.yml

@@ -0,0 +1,23 @@
+---
+
+# https://github.com/wayofdev/gh-actions/blob/master/.github/workflows/create-release.yml
+# https://github.com/google-github-actions/release-please-action#release-types-supported
+
+on: # yamllint disable-line rule:truthy
+ push:
+ branches:
+ - master
+
+name: 📦 Create release
+
+jobs:
+ release:
+ uses: wayofdev/gh-actions/.github/workflows/create-release.yml@master
+ with:
+ os: ubuntu-latest
+ branch: master
+ package-name: laravel-package-tpl
+ secrets:
+ token: ${{ secrets.PERSONAL_GITHUB_TOKEN }}
+
+...

.github/workflows/shellcheck.yml

@@ -0,0 +1,20 @@
+---
+
+on: # yamllint disable-line rule:truthy
+ pull_request:
+
+name: 🐞 Differential shell-check
+
+permissions:
+ contents: read
+
+jobs:
+ shellcheck:
+ uses: wayofdev/gh-actions/.github/workflows/shellcheck.yml@master
+ with:
+ os: ubuntu-latest
+ severity: warning
+ secrets:
+ token: ${{ secrets.GITHUB_TOKEN }}
+
+...

.gitignore

@@ -0,0 +1,2 @@
+/vendor/
+/.build/