chore: release 0.3.0

Author: Ardenexal

.phpbench/7ea/5/6/135269a570308183f5e3c64aad44f6d4eb810a43.xml

@@ -7,13 +7,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.3] - 2026-03-30
+## [0.3.0] - 2026-05-06
 
 ### Added
-- implement FHIR metadata cache warmer and configuration support
+- [IG Generation] `fhir:generate-ig` command for generating typed PHP classes from FHIR Implementation Guide StructureDefinitions
+- [IG Generation] `FHIRExtensionGenerator` for simple (single value type) and complex (sub-extension slices) typed extension classes
+- [IG Generation] `FHIRProfileGenerator` for profile subclasses with multi-level inheritance support
+- [IG Generation] `FHIRExtensionDefinition` and `FHIRProfile` metadata attributes for runtime introspection
+- [IG Generation] Transitive IG dependency package auto-loading into `BuilderContext` for cross-package type resolution
+- [IG Generation] FHIR R4B/R5 extension classes and FHIR R5 enums for various value sets
+- [IG Generation] Slice discriminator support
+- [Serialization] `FHIRIGTypeRegistry` for URL-to-class mapping of typed IG extension and profile subclasses
+- [Serialization] `FHIRIGRegistryCompilerPass` to scan the IG output directory and wire up the registry at compile time
+- [Serialization] `FHIRComplexExtensionInterface` with `fromSubExtensions()` factory for complex extension deserialization
+- [Serialization] `PropertyMetadataProvider` now walks the full class hierarchy so typed extension subclasses inherit `FhirProperty` metadata from parent classes
+- [Bundle] `fhir.ig.*` configuration keys (`namespace`, `output_directory`, `offline`, `packages`) in `config/packages/fhir.yaml`
+- [Bundle] FHIR metadata cache warmer with configurable `enable_cache_warmer` option
+- [Metadata] `FHIRExtensionInterface` providing a common `getExtensionUrl()` typing point across R4/R4B/R5
+- [Metadata] `FHIRExtensionsTrait` with lookup helpers: `findExtension`, `findExtensions`, `hasExtension`, `findExtensionByUrl`, `findExtensionsByUrl`
+- [FHIRPath] Benchmarks for FHIRPath evaluation and parsing
+- [Infrastructure] Deployment workflow and documentation for the demo app
+
+### Changed
+- [Serialization] Null checks and type casting added for primitives
+- [Serialization] Extensions and normalizers updated for versioning and deprecation handling
+- [Docs] `fhir:generate-ig` command, IG bundle configuration, and component guides documented in README
 
 ### Fixed
-- standardize formatting and indentation across multiple PHP files
+- [IG Generation] Base constraint profiles (vitalsigns, bp, bodyheight, etc.) now generated so IG profiles that extend them resolve correctly
+- [IG Generation] Slice parameter names conflicting with parent `Extension` properties now suffixed with `Slice` to avoid PHP property invariance compile errors
+- [Serialization] Base extensions registered in `FHIRIGTypeRegistry` so deserializer uses typed subclasses instead of falling back to `Extension`
+- [Serialization] Complex extension deserialization now uses `fromSubExtensions()` to correctly populate typed promoted properties
+- [Serialization] PHPStan and PHPUnit notice issues in serialization layer
+- [Infrastructure] Dockerfile updated with zip extension for Composer dist downloads
+- [Infrastructure] Demo `composer.lock` constrained to PHP 8.3 compatible packages
+- [FHIRPath] PHPDoc type hints improved in `FHIRPathEvaluator`
 
-[Unreleased]: https://github.com/Ardenexal/php-fhir-tools/compare/0.3...HEAD
-[0.3]: https://github.com/Ardenexal/php-fhir-tools/compare/0.2...0.3
+[Unreleased]: https://github.com/Ardenexal/FHIR-Structure-Definition-php-generator/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/Ardenexal/FHIR-Structure-Definition-php-generator/compare/0.2...v0.3.0
+[0.2]: https://github.com/Ardenexal/FHIR-Structure-Definition-php-generator/releases/tag/0.2

CHANGELOG.md

@@ -8,6 +8,7 @@
 use Ardenexal\FHIRTools\Component\Metadata\Attribute\FHIRProfile;
 use Ardenexal\FHIRTools\Component\Metadata\Attribute\FHIRSliceDiscriminator;
 use Ardenexal\FHIRTools\Component\Serialization\FHIRIGTypeRegistry;
+use Ardenexal\FHIRTools\Component\Serialization\FHIRIGTypeRegistryFactory;
 use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\Finder\Finder;
@@ -34,21 +35,6 @@
  */
 class FHIRIGRegistryCompilerPass implements CompilerPassInterface
 {
-    /**
-     * Known base FHIR versions and the sentinel DataType\Extension class used to locate
-     * each version's Extension directory via reflection.
-     *
-     * The sentinel is the DataType\Extension class (not a namespace). Its file path is used
-     * to compute the sibling Extension/ directory: DataType/Extension.php → ../Extension/.
-     *
-     * @var array<string, class-string>
-     */
-    private const array BASE_VERSION_SENTINELS = [
-        'R4'  => 'Ardenexal\\FHIRTools\\Component\\Models\\R4\\DataType\\Extension',
-        'R4B' => 'Ardenexal\\FHIRTools\\Component\\Models\\R4B\\DataType\\Extension',
-        'R5'  => 'Ardenexal\\FHIRTools\\Component\\Models\\R5\\DataType\\Extension',
-    ];
-
     public function process(ContainerBuilder $container): void
     {
         if (!$container->hasDefinition(FHIRIGTypeRegistry::class)) {
@@ -71,7 +57,7 @@ public function process(ContainerBuilder $container): void
         //    Base extension classes (e.g. PGenderIdentityExtension) live here and also
         //    carry #[FHIRExtensionDefinition] attributes that must be registered so the
         //    deserializer can resolve them to their typed classes.
-        foreach ($this->resolveBaseExtensionDirectories() as $dir => $ns) {
+        foreach (FHIRIGTypeRegistryFactory::resolveBaseExtensionDirectories() as $dir => $ns) {
             $this->scanDirectoryIntoMappings($dir, $ns, $extensionMappings, $profileMappings, $sliceDiscriminatorMappings);
         }
 
@@ -90,11 +76,6 @@ public function process(ContainerBuilder $container): void
      * object instances. FHIRIGTypeRegistry hydrates them to SliceDiscriminator objects
      * in its constructor.
      *
-     * @param array<string, class-string>                                                                     $extensionMappings
-     * @param array<string, class-string>                                                                     $profileMappings
-     * @param array<string, list<array{type: string, path: string, value: mixed, targetClass: class-string}>> $sliceDiscriminatorMappings
-     */
-    /**
      * @param array<string, array<string, class-string>>                                                      $extensionMappings
      * @param array<string, class-string>                                                                     $profileMappings
      * @param array<string, list<array{type: string, path: string, value: mixed, targetClass: class-string}>> $sliceDiscriminatorMappings
@@ -173,43 +154,4 @@ private function scanDirectoryIntoMappings(
             }
         }
     }
-
-    /**
-     * Auto-detect base models Extension directories for each supported FHIR version.
-     *
-     * Uses reflection on known sentinel DataType\Extension classes to find their source
-     * files, then resolves the sibling Extension/ directory. This works in both the
-     * monorepo and consumer apps where the Models component is installed via Composer.
-     *
-     * @return array<string, string> directory path → namespace root
-     */
-    private function resolveBaseExtensionDirectories(): array
-    {
-        $dirs = [];
-
-        foreach (self::BASE_VERSION_SENTINELS as $version => $sentinelClass) {
-            if (!class_exists($sentinelClass)) {
-                continue; // Models for this version not installed — skip.
-            }
-
-            $sentinelFile = (new \ReflectionClass($sentinelClass))->getFileName();
-
-            if ($sentinelFile === false) {
-                continue;
-            }
-
-            // sentinel is in …/Models/src/{version}/DataType/Extension.php
-            // Extension classes are in …/Models/src/{version}/Extension/
-            $extensionDir = dirname(dirname($sentinelFile)) . DIRECTORY_SEPARATOR . 'Extension';
-
-            if (!is_dir($extensionDir)) {
-                continue;
-            }
-
-            $namespace           = "Ardenexal\\FHIRTools\\Component\\Models\\{$version}\\Extension";
-            $dirs[$extensionDir] = $namespace;
-        }
-
-        return $dirs;
-    }
 }

src/Bundle/FHIRBundle/src/DependencyInjection/Compiler/FHIRIGRegistryCompilerPass.php

@@ -172,7 +172,7 @@ private static function registerPsr4Autoloader(string $directory, string $namesp
      *
      * @return array<string, string> directory path → namespace root
      */
-    private static function resolveBaseExtensionDirectories(): array
+    public static function resolveBaseExtensionDirectories(): array
     {
         $dirs = [];
 

src/Component/Serialization/src/FHIRIGTypeRegistryFactory.php

@@ -44,7 +44,7 @@ public function __construct(
         protected readonly FHIRMetadataExtractorInterface $metadataExtractor,
         ?NormalizerInterface $normalizer = null,
         ?DenormalizerInterface $denormalizer = null,
-        string $fhirVersion = 'R4B',
+        string $fhirVersion = 'R4',
         protected ?FHIRIGTypeRegistry $igTypeRegistry = null,
     ) {
         $this->normalizer           = $normalizer;

src/Component/Serialization/src/Normalizer/AbstractFHIRNormalizer.php

@@ -29,7 +29,7 @@ public function __construct(
         FHIRMetadataExtractorInterface $metadataExtractor,
         ?NormalizerInterface $normalizer = null,
         ?DenormalizerInterface $denormalizer = null,
-        string $fhirVersion = 'R4B',
+        string $fhirVersion = 'R4',
         ?FHIRIGTypeRegistry $igTypeRegistry = null,
     ) {
         parent::__construct($metadataExtractor, $normalizer, $denormalizer, $fhirVersion, $igTypeRegistry);

src/Component/Serialization/src/Normalizer/FHIRBackboneElementNormalizer.php

@@ -35,7 +35,7 @@ public function __construct(
         private readonly FHIRTypeResolverInterface $typeResolver,
         ?NormalizerInterface $normalizer = null,
         ?DenormalizerInterface $denormalizer = null,
-        string $fhirVersion = 'R4B',
+        string $fhirVersion = 'R4',
         ?FHIRIGTypeRegistry $igTypeRegistry = null,
     ) {
         parent::__construct($metadataExtractor, $normalizer, $denormalizer, $fhirVersion, $igTypeRegistry);

src/Component/Serialization/src/Normalizer/FHIRComplexTypeNormalizer.php

@@ -34,7 +34,7 @@ public function __construct(
         FHIRMetadataExtractorInterface $metadataExtractor,
         ?NormalizerInterface $normalizer = null,
         ?DenormalizerInterface $denormalizer = null,
-        string $fhirVersion = 'R4B',
+        string $fhirVersion = 'R4',
         ?FHIRIGTypeRegistry $igTypeRegistry = null,
     ) {
         parent::__construct($metadataExtractor, $normalizer, $denormalizer, $fhirVersion, $igTypeRegistry);

src/Component/Serialization/src/Normalizer/FHIRPrimitiveTypeNormalizer.php

@@ -32,7 +32,7 @@ public function __construct(
         private readonly FHIRTypeResolverInterface $typeResolver,
         ?NormalizerInterface $normalizer = null,
         ?DenormalizerInterface $denormalizer = null,
-        string $fhirVersion = 'R4B',
+        string $fhirVersion = 'R4',
         ?FHIRIGTypeRegistry $igTypeRegistry = null,
     ) {
         parent::__construct($metadataExtractor, $normalizer, $denormalizer, $fhirVersion, $igTypeRegistry);