feat: bootstrap enum component

.agents/agents/README.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/README.md

.agents/agents/agents-maintainer.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/agents-maintainer.md

.agents/agents/changelog-maintainer.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/changelog-maintainer.md

.agents/agents/consumer-sync-auditor.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/consumer-sync-auditor.md

.agents/agents/docs-writer.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/docs-writer.md

.agents/agents/issue-editor.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/issue-editor.md

.agents/agents/issue-implementer.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/issue-implementer.md

.agents/agents/php-style-curator.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/php-style-curator.md

.agents/agents/quality-pipeline-auditor.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/quality-pipeline-auditor.md

.agents/agents/readme-maintainer.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/readme-maintainer.md

.agents/agents/review-guardian.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/review-guardian.md

.agents/agents/test-guardian.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/test-guardian.md

.agents/skills/changelog-generator

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/changelog-generator

.agents/skills/create-agentsmd

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/create-agentsmd

.agents/skills/github-issues

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/github-issues

.agents/skills/github-pull-request

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/github-pull-request

.agents/skills/package-readme

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/package-readme

.agents/skills/phpdoc-code-style

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/phpdoc-code-style

.agents/skills/phpunit-tests

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/phpunit-tests

.agents/skills/pull-request-review

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/pull-request-review

.agents/skills/sphinx-docs

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/sphinx-docs

.docheader

@@ -0,0 +1,13 @@
+/**
+ * Ergonomic utilities for PHP enums, including names, values, lookups, and option maps.
+ *
+ * This file is part of fast-forward/enum project.
+ *
+ * @author   Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
+ * @license  https://opensource.org/licenses/MIT MIT License
+ *
+ * @see      https://github.com/php-fast-forward/enum
+ * @see      https://github.com/php-fast-forward/enum/issues
+ * @see      https://php-fast-forward.github.io/enum/
+ * @see      https://datatracker.ietf.org/doc/html/rfc2119
+ */

.editorconfig

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

.gitattributes

@@ -0,0 +1,14 @@
+*                      text=auto
+/.agents/              export-ignore
+/.dev-tools/           export-ignore
+/.github/              export-ignore
+/docs/                 export-ignore
+/tests/                export-ignore
+/.editorconfig         export-ignore
+/.gitattributes        export-ignore
+/.gitignore            export-ignore
+/.gitmodules           export-ignore
+/.phpunit.result.cache export-ignore
+/AGENTS.md             export-ignore
+/phpunit.xml.dist      export-ignore
+/README.md             export-ignore

.github/CODEOWNERS

@@ -0,0 +1,12 @@
+# Generated by fast-forward/dev-tools
+#
+# Review the generated owners before committing this file.
+#
+# When no GitHub owners can be inferred automatically, replace the placeholder
+# example below with the usernames, teams, or emails that should review
+# changes in the consumer repository.
+#
+# Example:
+# * @your-github-user @your-org/platform-team
+
+* @php-fast-forward @coisa

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+github: php-fast-forward
+custom:
+  - 'https://www.paypal.com/donate/?business=JLDAF45XZ8D84'

.github/dependabot.yml

@@ -0,0 +1,23 @@
+version: 2
+updates:
+  - package-ecosystem: "composer"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "Composer"
+      include: "scope"
+    labels:
+      - "composer"
+      - "dependencies"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "GitHub Actions"
+      include: "scope"
+    labels:
+      - "github-actions"
+      - "continuous-integration"

.github/workflows/auto-assign.yml

@@ -0,0 +1,22 @@
+name: Auto assign
+
+on:
+  pull_request_target:
+    types: [opened, reopened, synchronize]
+  issues:
+    types: [opened, reopened]
+
+jobs:
+  auto-assign:
+    permissions:
+      issues: write
+      repository-projects: write
+      pull-requests: write
+    uses: php-fast-forward/dev-tools/.github/workflows/auto-assign.yml@main
+    with:
+      # project: 1
+      #
+      # Consumer repositories SHOULD set this to the target GitHub Project V2
+      # number. Repositories inside php-fast-forward MAY omit it and let the
+      # reusable workflow default to the first organization project.
+      project: ${{ vars.PROJECT || '' }}

.github/workflows/auto-resolve-conflicts.yml

@@ -0,0 +1,36 @@
+name: "Fast Forward Predictable Conflict Resolution"
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - ready_for_review
+  workflow_dispatch:
+    inputs:
+      base-ref:
+        description: Base branch inspected for open pull requests.
+        required: false
+        type: string
+        default: main
+      pull-request-number:
+        description: Optional pull request number to inspect. Leave empty to scan open pull requests targeting the base branch.
+        required: false
+        type: string
+        default: ''
+
+permissions:
+  actions: write
+  contents: write
+  pull-requests: write
+
+jobs:
+  auto-resolve-conflicts:
+    uses: php-fast-forward/dev-tools/.github/workflows/auto-resolve-conflicts.yml@main
+    with:
+      base-ref: ${{ inputs.base-ref || github.event.pull_request.base.ref || github.event.repository.default_branch || 'main' }}
+      pull-request-number: ${{ inputs.pull-request-number || github.event.pull_request.number || '' }}
+    secrets: inherit

.github/workflows/changelog.yml

@@ -0,0 +1,47 @@
+name: "Fast Forward Changelog"
+
+on:
+  pull_request:
+    types: [opened, reopened, synchronize]
+  pull_request_target:
+    types: [closed]
+  workflow_dispatch:
+    inputs:
+      changelog-file:
+        description: Path to the managed changelog file.
+        required: false
+        type: string
+        default: CHANGELOG.md
+      project:
+        description: Optional GitHub Project V2 number used for project-board release transitions.
+        required: false
+        type: string
+        default: ''
+      version:
+        description: Optional version to promote. Leave empty to infer from Unreleased.
+        required: false
+        type: string
+        default: ''
+      release-branch-prefix:
+        description: Prefix used for release-preparation branches.
+        required: false
+        type: string
+        default: release/v
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  changelog:
+    uses: php-fast-forward/dev-tools/.github/workflows/changelog.yml@main
+    with:
+      changelog-file: ${{ inputs.changelog-file || 'CHANGELOG.md' }}
+      # project: 1
+      #
+      # Consumer repositories SHOULD set this when they want changelog-driven
+      # release transitions to update a specific GitHub Project V2 board.
+      project: ${{ inputs.project || vars.PROJECT || '' }}
+      version: ${{ inputs.version || '' }}
+      release-branch-prefix: ${{ inputs.release-branch-prefix || 'release/v' }}
+    secrets: inherit

.github/workflows/label-sync.yml

@@ -0,0 +1,15 @@
+name: Label sync
+
+on:
+  pull_request_target:
+    types: [opened, reopened, synchronize]
+  issues:
+    types: [opened, reopened]
+
+jobs:
+  label-sync:
+    permissions:
+      contents: read
+      issues: read
+      pull-requests: write
+    uses: php-fast-forward/dev-tools/.github/workflows/label-sync.yml@main

.github/workflows/reports.yml

@@ -0,0 +1,28 @@
+name: "Fast Forward Reports"
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, closed]
+  push:
+    branches:
+      - main
+  schedule:
+    - cron: '41 3 * * *'
+  workflow_dispatch:
+    inputs:
+      cleanup-previews:
+        description: Remove stale pull request previews without publishing production reports.
+        required: false
+        type: boolean
+        default: false
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  reports:
+    uses: php-fast-forward/dev-tools/.github/workflows/reports.yml@main
+    secrets: inherit
+    with:
+      cleanup-previews: ${{ inputs.cleanup-previews || false }}

.github/workflows/review.yml

@@ -0,0 +1,20 @@
+name: Rigorous Pull Request Review
+
+on:
+  pull_request_target:
+    types: [ready_for_review]
+  workflow_dispatch:
+    inputs:
+      pull-request-number:
+        description: Pull request number to review manually.
+        required: true
+        type: string
+
+jobs:
+  rigorous-review:
+    permissions:
+      contents: read
+      pull-requests: write
+    uses: php-fast-forward/dev-tools/.github/workflows/review.yml@main
+    with:
+      pull-request-number: ${{ github.event.pull_request.number || inputs.pull-request-number || '' }}

.github/workflows/tests.yml

@@ -0,0 +1,21 @@
+name: "Fast Forward Test Suite"
+
+on:
+  push:
+  workflow_dispatch:
+    inputs:
+      max-outdated:
+        description: Maximum number of outdated packages allowed by the dependencies command.
+        required: false
+        type: number
+        default: -1
+
+permissions:
+  contents: read
+
+jobs:
+  tests:
+    uses: php-fast-forward/dev-tools/.github/workflows/tests.yml@main
+    with:
+      max-outdated: ${{ inputs.max-outdated || -1 }}
+    secrets: inherit

.github/workflows/wiki-maintenance.yml

@@ -0,0 +1,26 @@
+name: "Fast Forward Wiki Maintenance"
+
+on:
+  pull_request_target:
+    types: [closed]
+  schedule:
+    - cron: '17 3 * * *'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: read
+
+concurrency:
+  group: fast-forward-wiki-maintenance-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  maintenance:
+    permissions:
+      contents: write
+      pull-requests: read
+    # This wrapper handles merged publication to the wiki master branch plus
+    # preview-branch cleanup. Pull-request preview generation lives in wiki.yml.
+    uses: php-fast-forward/dev-tools/.github/workflows/wiki-maintenance.yml@main
+    secrets: inherit