Cleaning up before 2.0.0-beta.1 😜

Author: Sibyx

.github/workflows/ci.yml

@@ -12,9 +12,9 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-version: ['8.1', '8.2', '8.3', '8.4']
+        php-version: ['8.1', '8.2', '8.3', '8.4', '8.5']
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2

.github/workflows/docs.yml

@@ -16,11 +16,11 @@ jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.12'
 

.gitignore

@@ -8,7 +8,6 @@ composer.lock
 /.phpunit.result.cache
 /.phpunit.cache
 coverage.xml
-/docs-output/
-/.phpdoc/
 /site/
-/.venv/
+/.venv/
+/.php-cs-fixer.cache

.php-cs-fixer.php

@@ -1,20 +1,25 @@
-
 <?php
 
-$finder = PhpCsFixer\Finder::create()
-    ->in(__DIR__)
-    ->ignoreDotFiles(true)
-    ->ignoreVCS(true)
-    ->exclude(['docs', 'vendor'])
-    ->files()
-    ->name('*.php')
+$finder = (new PhpCsFixer\Finder())
+	->in(__DIR__)
+	->ignoreDotFiles(true)
+	->ignoreVCS(true)
+	->exclude(['docs', 'vendor'])
+	->name('*.php')
 ;
 
-return PhpCsFixer\Config::create()
-    ->setUsingCache(true)
-    ->setFinder($finder)
-    ->setRules([
-        '@PSR2' => true,
-    ])
-    ->setIndent("\t")
-;
+return (new PhpCsFixer\Config())
+	->setUsingCache(true)
+	->setFinder($finder)
+	->setRules([
+		'@PSR12' => true,
+		'array_syntax' => ['syntax' => 'short'],
+		'no_unused_imports' => true,
+		'ordered_imports' => ['sort_algorithm' => 'alpha'],
+		'single_quote' => true,
+		'trailing_comma_in_multiline' => ['elements' => ['arguments', 'arrays', 'parameters']],
+		'no_whitespace_in_blank_line' => true,
+		'no_trailing_whitespace' => true,
+	])
+	->setIndent("\t")
+;

CHANGELOG.md

@@ -1,19 +1,39 @@
 # Changelog
 
-## 2.0.0 : TBD
-
-- **Changed** Support for PHP 8.1+ only
-- **Fixed** Added proper return type declarations to parser classes to fix deprecated messages in PHP 8.4
-- **Fixed** Patched vendor files to fix deprecation warnings about implicitly marking parameters as nullable:
-  - sebastian/cli-parser/src/Parser.php
-  - phpunit/phpunit/src/Util/Exporter.php
-  - sebastian/exporter/src/Exporter.php
-- **Fixed** Updated tests to be compatible with PHPUnit 12.x:
-  - Added missing tests to BoundsTest class
-  - Updated test annotations to use PHPUnit 12 attributes
-  - Fixed data provider usage in SerializationHelperTest
-  - Implemented missing GpxSerializable interface methods in Bounds class
-  - Updated phpunit.xml configuration
+## 2.0.0-beta.1 : 2025-03-09
+
+### Breaking Changes
+
+- **Changed**: `phpGPX` is now instance-based — `phpGPX::load()` (static) replaced by `(new phpGPX())->load()`
+- **Removed**: All static configuration properties (`$CALCULATE_STATS`, `$SORT_BY_TIMESTAMP`, `$PRETTY_PRINT`, etc.) — replaced by `Config` value object and analyzer constructors
+- **Removed**: `Summarizable` interface and `toArray()` — replaced by `JsonSerializable` returning GeoJSON (RFC 7946)
+- **Removed**: `GpxSerializable` interface — parsers handle XML serialization via Data Mapper pattern
+- **Removed**: `StatsCalculator` interface — replaced by Engine
+- **Removed**: `AbstractExtension` base class — replaced by `ExtensionInterface`
+- **Changed**: Point type constants (`Point::TRACKPOINT`, etc.) replaced by `PointType` enum
+- **Changed**: Extension access `$extensions->trackPointExtension` replaced by `$extensions->get(TrackPointExtension::class)`
+
+### Added
+
+- **Added**: Single-pass stats `Engine` with pluggable analyzers (`DistanceAnalyzer`, `ElevationAnalyzer`, `AltitudeAnalyzer`, `TimestampAnalyzer`, `BoundsAnalyzer`, `MovementAnalyzer`, `TrackPointExtensionAnalyzer`)
+- **Added**: `Engine::default()` factory with named parameters for common configuration
+- **Added**: `ExtensionRegistry` for registering custom extension parsers by namespace URI
+- **Added**: `ExtensionInterface` and `ExtensionParserInterface` for custom extensions
+- **Added**: `Config` value object for output configuration
+- **Added**: `AbstractParser` base class centralizing attribute mapping and XML handling
+- **Added**: mkdocs-material documentation site with PlantUML support
+- **Added**: Consolidated CI workflow (PHP 8.1–8.4 matrix) with Codecov integration
+
+### Changed
+
+- **Changed**: PHP 8.1+ required
+- **Changed**: `Extensions` model is now a keyed collection
+- **Changed**: Default Garmin TrackPointExtension v1 + v2 auto-registered via `ExtensionRegistry::default()`
+- **Changed**: All parsers refactored to extend `AbstractParser`
+- **Changed**: Strict typing on all model properties
+- **Changed**: Test suite restructured into `unit` and `integration` suites
+- **Changed**: PHPUnit 10+ with attributes (annotations removed)
+- **Changed**: Test fixtures standardized under `tests/Fixtures/`
 
 ## 1.3.0 : 2023-07-19
 

Dockerfile

@@ -1,7 +1,7 @@
 {
 	"name": "sibyx/phpgpx",
 	"type": "library",
-	"version": "1.3.0",
+	"version": "2.0.0-beta.1",
 	"description": "A simple PHP library for GPX manipulation",
 	"minimum-stability": "stable",
 	"keywords": [

composer.json

@@ -9,8 +9,8 @@
 - `tests/` - Test suite
   - `Unit/` - Unit tests for individual components
   - `Integration/` - Full file load/save round-trip tests
-  - `fixtures/` - GPX test fixture files
-- `docs/` - Documentation (Daux.io)
+  - `Fixtures/` - GPX and parser test fixture files
+- `docs/` - Documentation (mkdocs-material)
 
 ## Branches
 
@@ -27,4 +27,20 @@ composer install
 
 ## Code style
 
-The project uses PSR-2 with **tab indentation** (configured in `.php-cs-fixer.php`).
+The project follows **PSR-12** with **tab indentation**, enforced by [PHP CS Fixer](https://github.com/PHP-CS-Fixer/PHP-CS-Fixer) (configured in `.php-cs-fixer.php`).
+
+```bash
+# Check for style violations (dry run)
+composer cs-fix -- --dry-run
+
+# Auto-fix all files
+composer cs-fix
+```
+
+Key rules beyond PSR-12:
+
+- Short array syntax (`[]` not `array()`)
+- No unused imports
+- Alphabetically ordered imports
+- Single quotes for strings
+- Trailing commas in multiline arguments, arrays, and parameters