Make it possible to configure a mapping of type namespaces based on xmlns

[veewee]

See #571

This is a breaking change, since it introduces a new way of configuring the code generation.
The models and contexts also changed.

Example:

use Phpro\SoapClient\CodeGenerator\Config\ClassMapConfig;
use Phpro\SoapClient\CodeGenerator\Config\ClientConfig;
use Phpro\SoapClient\CodeGenerator\Config\Destination;
use Phpro\SoapClient\CodeGenerator\Config\TypeNamespaceMap;
use Phpro\SoapClient\CodeGenerator\TypeNamespaceMap\Strategy\PrefixBasedTypeNamespaceStrategy;

return Config::create()
    ->setEngine($engine = DefaultEngineFactory::create(
        EngineOptions::defaults('your.wsdl')
    ))
    ->setTypeNamespaceMap(
        TypeNamespaceMap::create(fallback: new Destination('src/Type', 'App\\Type'))
           // Explicit mappings (generated during wizard : config setup)
            ->withMapping('http://xoev.de/schemata/xzufi/2_2_0', new Destination('src/Type/Xoev', 'App\\Type\\Xoev'))
            ->withMapping('http://www.opengis.net/gml/3.2', new Destination('src/Type/Gml', 'App\\Type\\Gml'))
            ->withMapping('http://www.isotc211.org/2005/gmd', new Destination('src/Type/Gmd', 'App\\Type\\Gmd'))
            ->withMapping('http://www.isotc211.org/2005/gmc', new Destination('src/Type/Gmc', 'App\\Type\\Gmc'))
            ->withMapping('http://www.isotc211.org/2005/gco', new Destination('src/Type/Gco', 'App\\Type\\Gco'))
            ->withMapping('http://www.isotc211.org/2005/gss', new Destination('src/Type/Gss', 'App\\Type\\Gss'))
            ->withMapping('http://www.isotc211.org/2005/gts', new Destination('src/Type/Gts', 'App\\Type\\Gts'))
            ->withMapping('http://www.w3.org/1999/xlink', new Destination('src/Type/Xlink', 'App\\Type\\Xlink'))

            // You could also specify a strategy that will be used if no mapping is found:
            ->withStrategy(new PrefixBasedTypeNamespaceStrategy())
    )
    ->setClient(new ClientConfig('MyClient', new Destination('src', 'App')))
    ->setClassMap(new ClassMapConfig('MyClassmap', new Destination('src', 'App')));

[Copilot]

Pull request overview

This pull request introduces a major breaking change (v4 to v5) that enables configuration of type namespace mappings based on XML namespaces (xmlns). The change addresses issue #571, which requested support for types in multiple namespaces using PHP 8.4's Clark notation.

Changes:

• Introduces new configuration value objects (Destination, ClientConfig, ClassMapConfig, TypeNamespaceMap) to replace scattered string-based configuration
• Implements XML namespace-aware type generation with explicit mappings and strategy-based resolution
• Makes duplicate type detection namespace-aware (types in different target PHP namespaces are no longer considered duplicates)
• Updates all model classes, contexts, generators, and console commands to work with the new configuration structure
• Adds comprehensive test coverage for new functionality
• Includes detailed documentation and upgrade guide

Reviewed changes

Copilot reviewed 113 out of 113 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
src/Phpro/SoapClient/CodeGenerator/Config/*	New configuration value objects and TypeNamespaceMap implementation
src/Phpro/SoapClient/CodeGenerator/Model/*	Updated to use TypeNamespaceMap instead of plain strings
src/Phpro/SoapClient/CodeGenerator/Context/*	Updated to use new config objects
src/Phpro/SoapClient/CodeGenerator/*Generator.php	Updated generators to work with new configuration
src/Phpro/SoapClient/Soap/Metadata/Manipulators/DuplicateTypes/*	Namespace-aware duplicate detection
src/Phpro/SoapClient/Console/Command/*	Updated commands to use new configuration
test/**/*Test.php	Comprehensive test coverage for changes
docs/**/*.md	Updated documentation and upgrade guide

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.