├── LICENSE.md
├── README.md
├── composer.json
├── qa
    ├── PHPStan
    │   ├── Extension
    │   │   ├── ApiAndInternalAnnotationCheck.php
    │   │   ├── ArgumentsMapperPHPStanExtension.php
    │   │   └── TreeMapperPHPStanExtension.php
    │   └── valinor-phpstan-configuration.php
    └── Psalm
    │   ├── Plugin
    │       ├── ArgumentsMapperPsalmPlugin.php
    │       └── TreeMapperPsalmPlugin.php
    │   └── ValinorPsalmPlugin.php
└── src
    ├── Cache
        ├── ChainCache.php
        ├── Exception
        │   ├── CacheDirectoryNotWritable.php
        │   ├── CompiledPhpCacheFileNotWritten.php
        │   ├── CorruptedCompiledPhpCacheFile.php
        │   └── InvalidSignatureToWarmup.php
        ├── FileSystemCache.php
        ├── FileWatchingCache.php
        ├── KeySanitizerCache.php
        ├── RuntimeCache.php
        ├── Warmup
        │   └── RecursiveCacheWarmupService.php
        └── WarmupCache.php
    ├── Compiler
        ├── Compiler.php
        ├── Library
        │   ├── NewAttributeNode.php
        │   └── TypeAcceptNode.php
        ├── Native
        │   ├── AnonymousClassNode.php
        │   ├── ArrayKeyAccessNode.php
        │   ├── ArrayNode.php
        │   ├── AssignNode.php
        │   ├── CallNode.php
        │   ├── CastNode.php
        │   ├── ClassNode.php
        │   ├── CloneNode.php
        │   ├── ClosureNode.php
        │   ├── ComplianceNode.php
        │   ├── DifferentNode.php
        │   ├── EqualsNode.php
        │   ├── ExpressionNode.php
        │   ├── ForEachNode.php
        │   ├── FunctionCallNode.php
        │   ├── FunctionNameNode.php
        │   ├── GreaterOrEqualsToNode.php
        │   ├── GreaterThanNode.php
        │   ├── IfNode.php
        │   ├── InstanceOfNode.php
        │   ├── LessOrEqualsToNode.php
        │   ├── LessThanNode.php
        │   ├── LogicalAndNode.php
        │   ├── LogicalOrNode.php
        │   ├── MatchNode.php
        │   ├── MethodCallNode.php
        │   ├── MethodNode.php
        │   ├── NegateNode.php
        │   ├── NewClassNode.php
        │   ├── ParameterDeclarationNode.php
        │   ├── PhpFileNode.php
        │   ├── PropertyDeclarationNode.php
        │   ├── PropertyNode.php
        │   ├── ReturnNode.php
        │   ├── ShortClosureNode.php
        │   ├── StaticAccessNode.php
        │   ├── StaticMethodCallNode.php
        │   ├── TernaryNode.php
        │   ├── ThrowNode.php
        │   ├── ValueNode.php
        │   ├── VariableAccessNode.php
        │   ├── VariableNode.php
        │   ├── WrapNode.php
        │   └── YieldNode.php
        └── Node.php
    ├── Definition
        ├── AttributeDefinition.php
        ├── Attributes.php
        ├── ClassDefinition.php
        ├── Exception
        │   ├── ClassTypeAliasesDuplication.php
        │   ├── ExtendTagTypeError.php
        │   ├── InvalidExtendTagClassName.php
        │   ├── InvalidExtendTagType.php
        │   ├── InvalidTypeAliasImportClass.php
        │   ├── InvalidTypeAliasImportClassType.php
        │   ├── SeveralExtendTagsFound.php
        │   └── UnknownTypeAliasImport.php
        ├── FunctionDefinition.php
        ├── FunctionObject.php
        ├── FunctionsContainer.php
        ├── MethodDefinition.php
        ├── Methods.php
        ├── ParameterDefinition.php
        ├── Parameters.php
        ├── Properties.php
        ├── PropertyDefinition.php
        └── Repository
        │   ├── AttributesRepository.php
        │   ├── Cache
        │       ├── CacheClassDefinitionRepository.php
        │       ├── CacheFunctionDefinitionRepository.php
        │       └── Compiler
        │       │   ├── AttributesCompiler.php
        │       │   ├── ClassDefinitionCompiler.php
        │       │   ├── Exception
        │       │       └── TypeCannotBeCompiled.php
        │       │   ├── FunctionDefinitionCompiler.php
        │       │   ├── MethodDefinitionCompiler.php
        │       │   ├── ParameterDefinitionCompiler.php
        │       │   ├── PropertyDefinitionCompiler.php
        │       │   └── TypeCompiler.php
        │   ├── ClassDefinitionRepository.php
        │   ├── FunctionDefinitionRepository.php
        │   └── Reflection
        │       ├── ReflectionAttributesRepository.php
        │       ├── ReflectionClassDefinitionRepository.php
        │       ├── ReflectionFunctionDefinitionRepository.php
        │       ├── ReflectionMethodDefinitionBuilder.php
        │       ├── ReflectionParameterDefinitionBuilder.php
        │       ├── ReflectionPropertyDefinitionBuilder.php
        │       └── TypeResolver
        │           ├── ClassImportedTypeAliasResolver.php
        │           ├── ClassLocalTypeAliasResolver.php
        │           ├── ClassParentTypeResolver.php
        │           ├── ClassTemplatesResolver.php
        │           ├── FunctionReturnTypeResolver.php
        │           ├── ParameterTypeResolver.php
        │           ├── PropertyTypeResolver.php
        │           └── ReflectionTypeResolver.php
    ├── Library
        ├── Container.php
        └── Settings.php
    ├── Mapper
        ├── ArgumentsMapper.php
        ├── ArgumentsMapperError.php
        ├── Exception
        │   ├── InvalidMappingTypeSignature.php
        │   ├── TypeErrorDuringArgumentsMapping.php
        │   └── TypeErrorDuringMapping.php
        ├── MappingError.php
        ├── Object
        │   ├── Argument.php
        │   ├── Arguments.php
        │   ├── ArgumentsValues.php
        │   ├── Constructor.php
        │   ├── DateTimeFormatConstructor.php
        │   ├── DynamicConstructor.php
        │   ├── Exception
        │   │   ├── CannotFindObjectBuilder.php
        │   │   ├── CannotInstantiateObject.php
        │   │   ├── CannotParseToDateTime.php
        │   │   ├── InvalidConstructorClassTypeParameter.php
        │   │   ├── InvalidConstructorMethodWithAttributeReturnType.php
        │   │   ├── InvalidConstructorReturnType.php
        │   │   ├── InvalidSource.php
        │   │   ├── MissingConstructorClassTypeParameter.php
        │   │   ├── ObjectBuildersCollision.php
        │   │   └── PermissiveTypeNotAllowed.php
        │   ├── Factory
        │   │   ├── CacheObjectBuilderFactory.php
        │   │   ├── ConstructorObjectBuilderFactory.php
        │   │   ├── DateTimeObjectBuilderFactory.php
        │   │   ├── DateTimeZoneObjectBuilderFactory.php
        │   │   ├── ObjectBuilderFactory.php
        │   │   ├── ReflectionObjectBuilderFactory.php
        │   │   ├── SortingObjectBuilderFactory.php
        │   │   └── StrictTypesObjectBuilderFactory.php
        │   ├── FunctionObjectBuilder.php
        │   ├── MethodArguments.php
        │   ├── MethodObjectBuilder.php
        │   ├── NativeConstructorObjectBuilder.php
        │   ├── NativeEnumObjectBuilder.php
        │   ├── ObjectBuilder.php
        │   └── ReflectionObjectBuilder.php
        ├── Source
        │   ├── Exception
        │   │   ├── FileExtensionNotHandled.php
        │   │   ├── InvalidJson.php
        │   │   ├── InvalidSource.php
        │   │   ├── InvalidYaml.php
        │   │   ├── SourceNotIterable.php
        │   │   ├── UnableToReadFile.php
        │   │   └── YamlExtensionNotEnabled.php
        │   ├── FileSource.php
        │   ├── IdentifiableSource.php
        │   ├── JsonSource.php
        │   ├── Modifier
        │   │   ├── CamelCaseKeys.php
        │   │   ├── Mapping.php
        │   │   └── PathMapping.php
        │   ├── Source.php
        │   └── YamlSource.php
        ├── Tree
        │   ├── Builder
        │   │   ├── ArrayNodeBuilder.php
        │   │   ├── InterfaceNodeBuilder.php
        │   │   ├── ListNodeBuilder.php
        │   │   ├── MixedNodeBuilder.php
        │   │   ├── NodeBuilder.php
        │   │   ├── NullNodeBuilder.php
        │   │   ├── ObjectImplementations.php
        │   │   ├── ObjectNodeBuilder.php
        │   │   ├── RootNodeBuilder.php
        │   │   ├── ScalarNodeBuilder.php
        │   │   ├── ShapedArrayNodeBuilder.php
        │   │   ├── TreeNode.php
        │   │   ├── TypeNodeBuilder.php
        │   │   ├── UndefinedObjectNodeBuilder.php
        │   │   ├── UnionNodeBuilder.php
        │   │   └── ValueAlteringNodeBuilder.php
        │   ├── Exception
        │   │   ├── CannotInferFinalClass.php
        │   │   ├── CannotMapToPermissiveType.php
        │   │   ├── CannotResolveObjectType.php
        │   │   ├── CannotResolveTypeFromUnion.php
        │   │   ├── CircularDependencyDetected.php
        │   │   ├── InterfaceHasBothConstructorAndInfer.php
        │   │   ├── InvalidAbstractObjectName.php
        │   │   ├── InvalidIterableKeyType.php
        │   │   ├── InvalidListKey.php
        │   │   ├── InvalidNodeHasNoMappedValue.php
        │   │   ├── InvalidNodeValue.php
        │   │   ├── InvalidResolvedImplementationValue.php
        │   │   ├── InvalidTraversableKey.php
        │   │   ├── MissingNodeValue.php
        │   │   ├── MissingObjectImplementationRegistration.php
        │   │   ├── ObjectImplementationCallbackError.php
        │   │   ├── ObjectImplementationNotRegistered.php
        │   │   ├── ResolvedImplementationIsNotAccepted.php
        │   │   ├── SourceIsNotNull.php
        │   │   ├── SourceMustBeIterable.php
        │   │   ├── SourceValueWasNotFilled.php
        │   │   ├── TooManyResolvedTypesFromUnion.php
        │   │   ├── UnexpectedKeysInSource.php
        │   │   └── UnresolvableShellType.php
        │   ├── Message
        │   │   ├── DefaultMessage.php
        │   │   ├── ErrorMessage.php
        │   │   ├── Formatter
        │   │   │   ├── AggregateMessageFormatter.php
        │   │   │   ├── CallbackMessageFormatter.php
        │   │   │   ├── LocaleMessageFormatter.php
        │   │   │   ├── MessageFormatter.php
        │   │   │   ├── MessageMapFormatter.php
        │   │   │   └── TranslationMessageFormatter.php
        │   │   ├── HasCode.php
        │   │   ├── HasParameters.php
        │   │   ├── Message.php
        │   │   ├── MessageBuilder.php
        │   │   ├── Messages.php
        │   │   ├── NodeMessage.php
        │   │   └── UserlandError.php
        │   ├── Node.php
        │   ├── NodeTraverser.php
        │   └── Shell.php
        ├── TreeMapper.php
        ├── TypeArgumentsMapper.php
        ├── TypeTreeMapper.php
        └── TypeTreeMapperError.php
    ├── MapperBuilder.php
    ├── Normalizer
        ├── ArrayNormalizer.php
        ├── AsTransformer.php
        ├── Exception
        │   ├── CircularReferenceFoundDuringNormalization.php
        │   ├── KeyTransformerHasTooManyParameters.php
        │   ├── KeyTransformerParameterInvalidType.php
        │   ├── TransformerHasInvalidCallableParameter.php
        │   ├── TransformerHasNoParameter.php
        │   ├── TransformerHasTooManyParameters.php
        │   └── TypeUnhandledByNormalizer.php
        ├── Format.php
        ├── Formatter
        │   ├── Exception
        │   │   └── CannotFormatInvalidTypeToJson.php
        │   └── JsonFormatter.php
        ├── JsonNormalizer.php
        ├── Normalizer.php
        ├── StreamNormalizer.php
        └── Transformer
        │   ├── CacheTransformer.php
        │   ├── Compiler
        │       ├── TransformerDefinition.php
        │       ├── TransformerDefinitionBuilder.php
        │       ├── TransformerRootNode.php
        │       └── TypeFormatter
        │       │   ├── ClassFormatter.php
        │       │   ├── DateTimeFormatter.php
        │       │   ├── DateTimeZoneFormatter.php
        │       │   ├── EnumFormatter.php
        │       │   ├── InterfaceFormatter.php
        │       │   ├── MixedFormatter.php
        │       │   ├── NullFormatter.php
        │       │   ├── RegisteredTransformersFormatter.php
        │       │   ├── ScalarFormatter.php
        │       │   ├── ShapedArrayFormatter.php
        │       │   ├── StdClassFormatter.php
        │       │   ├── TraversableFormatter.php
        │       │   ├── TypeFormatter.php
        │       │   ├── UnionFormatter.php
        │       │   ├── UnitEnumFormatter.php
        │       │   └── UnsureTypeFormatter.php
        │   ├── EmptyObject.php
        │   ├── EvaluatedTransformer.php
        │   ├── RecursiveTransformer.php
        │   ├── Transformer.php
        │   └── TransformerContainer.php
    ├── Type
        ├── BooleanType.php
        ├── ClassType.php
        ├── CombiningType.php
        ├── CompositeTraversableType.php
        ├── CompositeType.php
        ├── FixedType.php
        ├── FloatType.php
        ├── GenericType.php
        ├── IntegerType.php
        ├── ObjectType.php
        ├── Parser
        │   ├── CachedParser.php
        │   ├── Exception
        │   │   ├── Constant
        │   │   │   ├── ClassConstantCaseNotFound.php
        │   │   │   └── MissingClassConstantCase.php
        │   │   ├── Enum
        │   │   │   ├── EnumCaseNotFound.php
        │   │   │   ├── MissingEnumCase.php
        │   │   │   └── MissingSpecificEnumCase.php
        │   │   ├── Generic
        │   │   │   ├── AssignedGenericNotFound.php
        │   │   │   ├── CannotAssignGeneric.php
        │   │   │   ├── GenericClosingBracketMissing.php
        │   │   │   ├── GenericCommaMissing.php
        │   │   │   ├── InvalidAssignedGeneric.php
        │   │   │   └── MissingGenerics.php
        │   │   ├── InvalidIntersectionType.php
        │   │   ├── InvalidType.php
        │   │   ├── Iterable
        │   │   │   ├── ArrayClosingBracketMissing.php
        │   │   │   ├── ArrayCommaMissing.php
        │   │   │   ├── InvalidArrayKey.php
        │   │   │   ├── InvalidIterableKey.php
        │   │   │   ├── IterableClosingBracketMissing.php
        │   │   │   ├── IterableCommaMissing.php
        │   │   │   ├── ListClosingBracketMissing.php
        │   │   │   ├── ShapedArrayClosingBracketMissing.php
        │   │   │   ├── ShapedArrayColonTokenMissing.php
        │   │   │   ├── ShapedArrayCommaMissing.php
        │   │   │   ├── ShapedArrayElementDuplicatedKey.php
        │   │   │   ├── ShapedArrayElementTypeMissing.php
        │   │   │   ├── ShapedArrayEmptyElements.php
        │   │   │   ├── ShapedArrayInvalidUnsealedType.php
        │   │   │   ├── ShapedArrayUnexpectedTokenAfterSealedType.php
        │   │   │   ├── ShapedArrayWithoutElementsWithSealedType.php
        │   │   │   └── SimpleArrayClosingBracketMissing.php
        │   │   ├── Magic
        │   │   │   ├── ValueOfClosingBracketMissing.php
        │   │   │   ├── ValueOfIncorrectSubType.php
        │   │   │   └── ValueOfOpeningBracketMissing.php
        │   │   ├── MissingClosingQuoteChar.php
        │   │   ├── RightIntersectionTypeMissing.php
        │   │   ├── RightUnionTypeMissing.php
        │   │   ├── Scalar
        │   │   │   ├── ClassStringClosingBracketMissing.php
        │   │   │   ├── IntegerRangeInvalidMaxValue.php
        │   │   │   ├── IntegerRangeInvalidMinValue.php
        │   │   │   ├── IntegerRangeMissingClosingBracket.php
        │   │   │   ├── IntegerRangeMissingComma.php
        │   │   │   ├── IntegerRangeMissingMaxValue.php
        │   │   │   ├── IntegerRangeMissingMinValue.php
        │   │   │   ├── InvalidClassStringSubType.php
        │   │   │   ├── ReversedValuesForIntegerRange.php
        │   │   │   └── SameValueForIntegerRange.php
        │   │   ├── Template
        │   │   │   ├── DuplicatedTemplateName.php
        │   │   │   └── InvalidClassTemplate.php
        │   │   └── UnknownSymbol.php
        │   ├── Factory
        │   │   ├── LexingTypeParserFactory.php
        │   │   ├── Specifications
        │   │   │   ├── AliasSpecification.php
        │   │   │   ├── ClassContextSpecification.php
        │   │   │   ├── TypeAliasAssignerSpecification.php
        │   │   │   └── TypeParserSpecification.php
        │   │   └── TypeParserFactory.php
        │   ├── GenericCheckerParser.php
        │   ├── Lexer
        │   │   ├── Annotations.php
        │   │   ├── NativeLexer.php
        │   │   ├── SpecificationsLexer.php
        │   │   ├── Token
        │   │   │   ├── ArrayToken.php
        │   │   │   ├── CallableToken.php
        │   │   │   ├── CaseFinder.php
        │   │   │   ├── ClassNameToken.php
        │   │   │   ├── ClassStringToken.php
        │   │   │   ├── ClosingBracketToken.php
        │   │   │   ├── ClosingCurlyBracketToken.php
        │   │   │   ├── ClosingSquareBracketToken.php
        │   │   │   ├── ColonToken.php
        │   │   │   ├── CommaToken.php
        │   │   │   ├── DoubleColonToken.php
        │   │   │   ├── EnumNameToken.php
        │   │   │   ├── FloatValueToken.php
        │   │   │   ├── IntegerToken.php
        │   │   │   ├── IntegerValueToken.php
        │   │   │   ├── IntersectionToken.php
        │   │   │   ├── IterableToken.php
        │   │   │   ├── LeftTraversingToken.php
        │   │   │   ├── ListToken.php
        │   │   │   ├── NullableToken.php
        │   │   │   ├── ObjectToken.php
        │   │   │   ├── OpeningBracketToken.php
        │   │   │   ├── OpeningCurlyBracketToken.php
        │   │   │   ├── OpeningSquareBracketToken.php
        │   │   │   ├── StringValueToken.php
        │   │   │   ├── Token.php
        │   │   │   ├── TraversingToken.php
        │   │   │   ├── TripleDotsToken.php
        │   │   │   ├── TypeToken.php
        │   │   │   ├── UnionToken.php
        │   │   │   ├── VacantToken.php
        │   │   │   └── ValueOfToken.php
        │   │   ├── TokenStream.php
        │   │   ├── TokenizedAnnotation.php
        │   │   ├── TokensExtractor.php
        │   │   └── TypeLexer.php
        │   ├── LexingParser.php
        │   └── TypeParser.php
        ├── ScalarType.php
        ├── StringType.php
        ├── Type.php
        └── Types
        │   ├── ArrayKeyType.php
        │   ├── ArrayType.php
        │   ├── BooleanValueType.php
        │   ├── CallableType.php
        │   ├── ClassStringType.php
        │   ├── EnumType.php
        │   ├── Exception
        │       ├── ForbiddenMixedType.php
        │       └── InvalidUnionOfClassString.php
        │   ├── Factory
        │       ├── CannotBuildTypeFromValue.php
        │       └── ValueTypeFactory.php
        │   ├── FloatValueType.php
        │   ├── IntegerRangeType.php
        │   ├── IntegerValueType.php
        │   ├── InterfaceType.php
        │   ├── IntersectionType.php
        │   ├── IterableType.php
        │   ├── ListType.php
        │   ├── MixedType.php
        │   ├── NativeBooleanType.php
        │   ├── NativeClassType.php
        │   ├── NativeFloatType.php
        │   ├── NativeIntegerType.php
        │   ├── NativeStringType.php
        │   ├── NegativeIntegerType.php
        │   ├── NonEmptyArrayType.php
        │   ├── NonEmptyListType.php
        │   ├── NonEmptyStringType.php
        │   ├── NonNegativeIntegerType.php
        │   ├── NonPositiveIntegerType.php
        │   ├── NullType.php
        │   ├── NumericStringType.php
        │   ├── PositiveIntegerType.php
        │   ├── ScalarConcreteType.php
        │   ├── ShapedArrayElement.php
        │   ├── ShapedArrayType.php
        │   ├── StringValueType.php
        │   ├── UndefinedObjectType.php
        │   ├── UnionType.php
        │   └── UnresolvableType.php
    └── Utility
        ├── IsSingleton.php
        ├── Package.php
        ├── Polyfill.php
        ├── Priority
            ├── HasPriority.php
            └── PrioritizedList.php
        ├── Reflection
            ├── NamespaceFinder.php
            ├── PhpParser.php
            ├── Reflection.php
            └── TokenParser.php
        ├── String
            ├── StringCutter.php
            ├── StringFormatter.php
            └── StringFormatterError.php
        ├── TypeHelper.php
        └── ValueDumper.php


/LICENSE.md:
--------------------------------------------------------------------------------
 1 | Copyright (c) 2021 Romain Canon
 2 | 
 3 | Permission is hereby granted, free of charge, to any person obtaining a copy of
 4 | this software and associated documentation files (the "Software"), to deal in
 5 | the Software without restriction, including without limitation the rights to
 6 | use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
 7 | the Software, and to permit persons to whom the Software is furnished to do so,
 8 | subject to the following conditions:
 9 | 
10 | The above copyright notice and this permission notice shall be included in all
11 | copies or substantial portions of the Software.
12 | 
13 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
15 | FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
16 | COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
17 | IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
18 | CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
19 | 


--------------------------------------------------------------------------------
/qa/PHPStan/valinor-phpstan-configuration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use CuyZ\Valinor\QA\PHPStan\Extension\ArgumentsMapperPHPStanExtension;
 4 | use CuyZ\Valinor\QA\PHPStan\Extension\TreeMapperPHPStanExtension;
 5 | 
 6 | require_once 'Extension/ArgumentsMapperPHPStanExtension.php';
 7 | require_once 'Extension/TreeMapperPHPStanExtension.php';
 8 | 
 9 | return [
10 |     'services' => [
11 |         [
12 |             'class' => TreeMapperPHPStanExtension::class,
13 |             'tags' => ['phpstan.broker.dynamicMethodReturnTypeExtension']
14 |         ], [
15 |             'class' => ArgumentsMapperPHPStanExtension::class,
16 |             'tags' => ['phpstan.broker.dynamicMethodReturnTypeExtension']
17 |         ],
18 |     ],
19 | ];
20 | 


--------------------------------------------------------------------------------
/qa/Psalm/ValinorPsalmPlugin.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace CuyZ\Valinor\QA\Psalm;
 4 | 
 5 | use CuyZ\Valinor\QA\Psalm\Plugin\ArgumentsMapperPsalmPlugin;
 6 | use CuyZ\Valinor\QA\Psalm\Plugin\TreeMapperPsalmPlugin;
 7 | use Psalm\Plugin\PluginEntryPointInterface;
 8 | use Psalm\Plugin\RegistrationInterface;
 9 | use SimpleXMLElement;
10 | 
11 | class ValinorPsalmPlugin implements PluginEntryPointInterface
12 | {
13 |     public function __invoke(RegistrationInterface $api, ?SimpleXMLElement $config = null): void
14 |     {
15 |         require_once __DIR__ . '/Plugin/TreeMapperPsalmPlugin.php';
16 |         require_once __DIR__ . '/Plugin/ArgumentsMapperPsalmPlugin.php';
17 | 
18 |         $api->registerHooksFromClass(TreeMapperPsalmPlugin::class);
19 |         $api->registerHooksFromClass(ArgumentsMapperPsalmPlugin::class);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Cache/Exception/CacheDirectoryNotWritable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Cache\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class CacheDirectoryNotWritable extends RuntimeException
11 | {
12 |     public function __construct(string $directory)
13 |     {
14 |         parent::__construct(
15 |             "Provided directory `$directory` is not writable.",
16 |             1616445016
17 |         );
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Cache/Exception/CompiledPhpCacheFileNotWritten.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Cache\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class CompiledPhpCacheFileNotWritten extends RuntimeException
11 | {
12 |     public function __construct(string $file)
13 |     {
14 |         parent::__construct(
15 |             "File `$file` could not be written.",
16 |             1616445695
17 |         );
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Cache/Exception/CorruptedCompiledPhpCacheFile.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Cache\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class CorruptedCompiledPhpCacheFile extends RuntimeException
11 | {
12 |     public function __construct(string $filename)
13 |     {
14 |         parent::__construct(
15 |             "Compiled php cache file `$filename` has corrupted value.",
16 |             1628949607
17 |         );
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Cache/Exception/InvalidSignatureToWarmup.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Cache\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class InvalidSignatureToWarmup extends RuntimeException
12 | {
13 |     public function __construct(string $signature, InvalidType $exception)
14 |     {
15 |         parent::__construct(
16 |             "Cannot warm up invalid signature `$signature`: {$exception->getMessage()}",
17 |             1653330261,
18 |             $exception
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Cache/WarmupCache.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace CuyZ\Valinor\Cache;
 4 | 
 5 | use Psr\SimpleCache\CacheInterface;
 6 | 
 7 | /**
 8 |  * @internal
 9 |  *
10 |  * @template T
11 |  * @extends CacheInterface<T>
12 |  */
13 | interface WarmupCache extends CacheInterface
14 | {
15 |     public function warmup(): void;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Compiler/Compiler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler;
 6 | 
 7 | use function str_repeat;
 8 | use function str_replace;
 9 | 
10 | /** @internal */
11 | final class Compiler
12 | {
13 |     private string $code = '';
14 | 
15 |     /** @var non-negative-int */
16 |     private int $indentation = 0;
17 | 
18 |     public function compile(Node ...$nodes): self
19 |     {
20 |         $compiler = $this;
21 | 
22 |         while ($current = array_shift($nodes)) {
23 |             $compiler = $current->compile($compiler);
24 | 
25 |             if ($nodes !== []) {
26 |                 $compiler = $compiler->write("\n");
27 |             }
28 |         }
29 | 
30 |         return $compiler;
31 |     }
32 | 
33 |     public function sub(): self
34 |     {
35 |         return new self();
36 |     }
37 | 
38 |     public function write(string $code): self
39 |     {
40 |         $self = clone $this;
41 |         $self->code .= $code;
42 | 
43 |         return $self;
44 |     }
45 | 
46 |     public function indent(): self
47 |     {
48 |         $self = clone $this;
49 |         $self->indentation++;
50 | 
51 |         return $self;
52 |     }
53 | 
54 |     public function code(): string
55 |     {
56 |         $indent = str_repeat('    ', $this->indentation);
57 | 
58 |         return  $indent . str_replace("\n", "\n" . $indent, $this->code);
59 |     }
60 | }
61 | 


--------------------------------------------------------------------------------
/src/Compiler/Library/TypeAcceptNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Library;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
 9 | use CuyZ\Valinor\Compiler\Node;
10 | use CuyZ\Valinor\Type\Type;
11 | 
12 | /** @internal */
13 | final class TypeAcceptNode extends Node
14 | {
15 |     public function __construct(
16 |         private ComplianceNode $node,
17 |         private Type $type,
18 |     ) {}
19 | 
20 |     public function compile(Compiler $compiler): Compiler
21 |     {
22 |         return $compiler->compile($this->type->compiledAccept($this->node));
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/ArrayKeyAccessNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class ArrayKeyAccessNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $node,
15 |         private Node $key,
16 |     ) {}
17 | 
18 |     public function compile(Compiler $compiler): Compiler
19 |     {
20 |         $key = $compiler->sub()->compile($this->key)->code();
21 | 
22 |         return $compiler
23 |             ->compile($this->node)
24 |             ->write('[' . $key . ']');
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/ArrayNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | use function var_export;
11 | 
12 | /** @internal */
13 | final class ArrayNode extends Node
14 | {
15 |     public function __construct(
16 |         /** @var array<Node> */
17 |         private array $assignments
18 |     ) {}
19 | 
20 |     public function compile(Compiler $compiler): Compiler
21 |     {
22 |         if ($this->assignments === []) {
23 |             return $compiler->write('[]');
24 |         }
25 | 
26 |         $sub = [];
27 | 
28 |         foreach ($this->assignments as $key => $assignment) {
29 |             $sub[] = '    ' . var_export($key, true) . ' => ' . $compiler->sub()->compile($assignment)->code() . ",";
30 |         }
31 | 
32 |         $sub = implode("\n", $sub);
33 | 
34 |         return $compiler->write("[\n$sub\n]");
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/AssignNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class AssignNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $node,
15 |         private Node $value,
16 |     ) {}
17 | 
18 |     public function compile(Compiler $compiler): Compiler
19 |     {
20 |         return $compiler
21 |             ->compile($this->node)
22 |             ->write(' = ')
23 |             ->compile($this->value);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/CallNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | use function array_map;
11 | use function implode;
12 | 
13 | /** @internal */
14 | final class CallNode extends Node
15 | {
16 |     public function __construct(
17 |         private Node $node,
18 |         /** @var array<Node> */
19 |         private array $arguments = [],
20 |     ) {}
21 | 
22 |     public function compile(Compiler $compiler): Compiler
23 |     {
24 |         $compiler = $compiler
25 |             ->compile($this->node)
26 |             ->write('(');
27 | 
28 |         if ($this->arguments !== []) {
29 |             $arguments = array_map(
30 |                 fn (Node $argument) => $compiler->sub()->compile($argument)->code(),
31 |                 $this->arguments,
32 |             );
33 | 
34 |             $compiler = $compiler->write(implode(', ', $arguments));
35 |         }
36 | 
37 |         return $compiler->write(')');
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/CastNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class CastNode extends Node
12 | {
13 |     private function __construct(
14 |         private string $type,
15 |         private Node $node,
16 |     ) {}
17 | 
18 |     public static function toArray(Node $node): self
19 |     {
20 |         return new self('array', $node);
21 |     }
22 | 
23 |     public function compile(Compiler $compiler): Compiler
24 |     {
25 |         return $compiler
26 |             ->write('(' . $this->type . ')')
27 |             ->compile($this->node);
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/ClassNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class ClassNode extends Node
12 | {
13 |     public function __construct(
14 |         /** @var class-string */
15 |         private string $name,
16 |     ) {}
17 | 
18 |     /**
19 |      * @param non-empty-string $method
20 |      * @param array<Node> $arguments
21 |      */
22 |     public function callStaticMethod(
23 |         string $method,
24 |         array $arguments = [],
25 |     ): Node {
26 |         return new StaticMethodCallNode($this, $method, $arguments);
27 |     }
28 | 
29 |     public function compile(Compiler $compiler): Compiler
30 |     {
31 |         return $compiler->write($this->name);
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/CloneNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class CloneNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $node,
15 |     ) {}
16 | 
17 |     public function compile(Compiler $compiler): Compiler
18 |     {
19 |         return $compiler
20 |             ->write('clone ')
21 |             ->compile($this->node);
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/ClosureNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | use function array_map;
11 | use function implode;
12 | 
13 | /** @internal */
14 | final class ClosureNode extends Node
15 | {
16 |     /** @var list<string> */
17 |     private array $use = [];
18 | 
19 |     /** @var array<Node> */
20 |     private array $nodes;
21 | 
22 |     public function __construct(Node ...$nodes)
23 |     {
24 |         $this->nodes = $nodes;
25 |     }
26 | 
27 |     /**
28 |      * @no-named-arguments
29 |      * @param non-empty-string ...$names
30 |      */
31 |     public function uses(string ...$names): self
32 |     {
33 |         $self = clone $this;
34 |         $self->use = array_map(fn (string $name) => '$' . $name, $names);
35 | 
36 |         return $self;
37 |     }
38 | 
39 |     public function compile(Compiler $compiler): Compiler
40 |     {
41 |         $use = $this->use !== [] ? ' use (' . implode(', ', $this->use) . ')' : '';
42 | 
43 |         $body = $compiler->sub()->indent()->compile(...$this->nodes)->code();
44 | 
45 |         $code = <<<PHP
46 |         function ()$use {
47 |         $body
48 |         }
49 |         PHP;
50 | 
51 |         return $compiler->write($code);
52 |     }
53 | }
54 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/DifferentNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class DifferentNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $left,
15 |         private Node $right,
16 |     ) {}
17 | 
18 |     public function compile(Compiler $compiler): Compiler
19 |     {
20 |         return $compiler
21 |             ->compile($this->left)
22 |             ->write(' !== ')
23 |             ->compile($this->right);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/EqualsNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class EqualsNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $left,
15 |         private Node $right,
16 |     ) {}
17 | 
18 |     public function compile(Compiler $compiler): Compiler
19 |     {
20 |         return $compiler
21 |             ->compile($this->left)
22 |             ->write(' === ')
23 |             ->compile($this->right);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/ExpressionNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class ExpressionNode extends Node
12 | {
13 |     public function __construct(private Node $node) {}
14 | 
15 |     public function compile(Compiler $compiler): Compiler
16 |     {
17 |         return $compiler->write($compiler->sub()->compile($this->node)->code() . ';');
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/ForEachNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class ForEachNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $value,
15 |         /** @var non-empty-string */
16 |         private string $key,
17 |         /** @var non-empty-string */
18 |         private string $item,
19 |         private Node $body,
20 |     ) {}
21 | 
22 |     public function compile(Compiler $compiler): Compiler
23 |     {
24 |         $value = $compiler->sub()->compile($this->value)->code();
25 |         $body = $compiler->sub()->indent()->compile($this->body)->code();
26 | 
27 |         return $compiler->write(
28 |             <<<PHP
29 |             foreach ($value as $$this->key => $$this->item) {
30 |             $body
31 |             }
32 |             PHP
33 |         );
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/FunctionCallNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class FunctionCallNode extends Node
12 | {
13 |     public function __construct(
14 |         /** @var non-empty-string */
15 |         private string $name,
16 |         /** @var array<Node> */
17 |         private array $arguments = [],
18 |     ) {}
19 | 
20 |     public function compile(Compiler $compiler): Compiler
21 |     {
22 |         return $compiler
23 |             ->compile(new CallNode(new FunctionNameNode($this->name), $this->arguments));
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/FunctionNameNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | use function in_array;
11 | 
12 | /** @internal */
13 | final class FunctionNameNode extends Node
14 | {
15 |     private const RESERVED_FUNCTIONS = [
16 |         'isset',
17 |     ];
18 | 
19 |     public function __construct(
20 |         /** @var non-empty-string */
21 |         private string $name
22 |     ) {}
23 | 
24 |     public function compile(Compiler $compiler): Compiler
25 |     {
26 |         $function = in_array($this->name, self::RESERVED_FUNCTIONS, true)
27 |             ? $this->name
28 |             : '\\' . $this->name;
29 | 
30 |         return $compiler->write($function);
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/GreaterOrEqualsToNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class GreaterOrEqualsToNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $left,
15 |         private Node $right,
16 |     ) {}
17 | 
18 |     public function compile(Compiler $compiler): Compiler
19 |     {
20 |         return $compiler
21 |             ->compile($this->left)
22 |             ->write(' >= ')
23 |             ->compile($this->right);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/GreaterThanNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class GreaterThanNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $left,
15 |         private Node $right,
16 |     ) {}
17 | 
18 |     public function compile(Compiler $compiler): Compiler
19 |     {
20 |         return $compiler
21 |             ->compile($this->left)
22 |             ->write(' > ')
23 |             ->compile($this->right);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/IfNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class IfNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $condition,
15 |         private Node $body,
16 |     ) {}
17 | 
18 |     public function compile(Compiler $compiler): Compiler
19 |     {
20 |         $condition = $compiler->sub()->compile($this->condition)->code();
21 |         $body = $compiler->sub()->indent()->compile($this->body)->code();
22 | 
23 |         return $compiler->write(
24 |             <<<PHP
25 |             if ($condition) {
26 |             $body
27 |             }
28 |             PHP,
29 |         );
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/InstanceOfNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class InstanceOfNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $node,
15 |         /** @var class-string */
16 |         private string $className,
17 |     ) {}
18 | 
19 |     public function compile(Compiler $compiler): Compiler
20 |     {
21 |         $className = $this->className;
22 | 
23 |         return $compiler
24 |             ->compile($this->node)
25 |             ->write(' instanceof ')
26 |             ->write($className);
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/LessOrEqualsToNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class LessOrEqualsToNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $left,
15 |         private Node $right,
16 |     ) {}
17 | 
18 |     public function compile(Compiler $compiler): Compiler
19 |     {
20 |         return $compiler
21 |             ->compile($this->left)
22 |             ->write(' <= ')
23 |             ->compile($this->right);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/LessThanNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class LessThanNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $left,
15 |         private Node $right,
16 |     ) {}
17 | 
18 |     public function compile(Compiler $compiler): Compiler
19 |     {
20 |         return $compiler
21 |             ->compile($this->left)
22 |             ->write(' < ')
23 |             ->compile($this->right);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/LogicalAndNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class LogicalAndNode extends Node
12 | {
13 |     /** @var list<Node> */
14 |     private array $nodes;
15 | 
16 |     /**
17 |      * @no-named-arguments
18 |      */
19 |     public function __construct(Node ...$nodes)
20 |     {
21 |         $this->nodes = $nodes;
22 |     }
23 | 
24 |     public function compile(Compiler $compiler): Compiler
25 |     {
26 |         $nodes = $this->nodes;
27 | 
28 |         while ($node = array_shift($nodes)) {
29 |             $compiler = $compiler->compile($node);
30 | 
31 |             if ($nodes !== []) {
32 |                 $compiler = $compiler->write(' && ');
33 |             }
34 |         }
35 | 
36 |         return $compiler;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/LogicalOrNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class LogicalOrNode extends Node
12 | {
13 |     /** @var list<Node> */
14 |     private array $nodes;
15 | 
16 |     /**
17 |      * @no-named-arguments
18 |      */
19 |     public function __construct(Node ...$nodes)
20 |     {
21 |         $this->nodes = $nodes;
22 |     }
23 | 
24 |     public function compile(Compiler $compiler): Compiler
25 |     {
26 |         $nodes = $this->nodes;
27 | 
28 |         while ($node = array_shift($nodes)) {
29 |             $compiler = $compiler->compile($node);
30 | 
31 |             if ($nodes !== []) {
32 |                 $compiler = $compiler->write(' || ');
33 |             }
34 |         }
35 | 
36 |         return $compiler;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/MethodCallNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class MethodCallNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $node,
15 |         /** @var non-empty-string */
16 |         private string $method,
17 |         /** @var array<Node> */
18 |         private array $arguments = [],
19 |     ) {}
20 | 
21 |     public function compile(Compiler $compiler): Compiler
22 |     {
23 |         return $compiler->compile(
24 |             new CallNode(new VariableAccessNode($this->node, $this->method), $this->arguments)
25 |         );
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/NegateNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class NegateNode extends Node
12 | {
13 |     public function __construct(private Node $node) {}
14 | 
15 |     public function compile(Compiler $compiler): Compiler
16 |     {
17 |         return $compiler->write('! ')->compile($this->node);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/NewClassNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | use function array_map;
11 | 
12 | /** @internal */
13 | final class NewClassNode extends Node
14 | {
15 |     /** @var class-string */
16 |     private string $className;
17 | 
18 |     /** @var array<Node> */
19 |     private array $arguments;
20 | 
21 |     /**
22 |      * @param class-string $className
23 |      */
24 |     public function __construct(string $className, Node ...$arguments)
25 |     {
26 |         $this->className = $className;
27 |         $this->arguments = $arguments;
28 |     }
29 | 
30 |     public function compile(Compiler $compiler): Compiler
31 |     {
32 |         $arguments = array_map(
33 |             fn (Node $argument) => $compiler->sub()->compile($argument)->code(),
34 |             $this->arguments,
35 |         );
36 |         $arguments = implode(', ', $arguments);
37 | 
38 |         return $compiler->write("new {$this->className}($arguments)");
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/ParameterDeclarationNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class ParameterDeclarationNode extends Node
12 | {
13 |     public function __construct(
14 |         /** @var non-empty-string */
15 |         private string $name,
16 |         private string $type,
17 |     ) {}
18 | 
19 |     public function compile(Compiler $compiler): Compiler
20 |     {
21 |         return $compiler->write($this->type . ' $' . $this->name);
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/PhpFileNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class PhpFileNode extends Node
12 | {
13 |     /** @var array<Node> */
14 |     private array $nodes;
15 | 
16 |     public function __construct(Node ...$nodes)
17 |     {
18 |         $this->nodes = $nodes;
19 |     }
20 | 
21 |     public function compile(Compiler $compiler): Compiler
22 |     {
23 |         return $compiler
24 |             ->write("<?php\n\ndeclare(strict_types=1);\n\n")
25 |             ->compile(...$this->nodes);
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/PropertyDeclarationNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class PropertyDeclarationNode extends Node
12 | {
13 |     public function __construct(
14 |         /** @var non-empty-string */
15 |         private string $name,
16 |         private string $type,
17 |     ) {}
18 | 
19 |     public function compile(Compiler $compiler): Compiler
20 |     {
21 |         return $compiler->write('private ' . $this->type . ' $' . $this->name . ';');
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/PropertyNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class PropertyNode extends Node
12 | {
13 |     public function __construct(private string $name) {}
14 | 
15 |     public function compile(Compiler $compiler): Compiler
16 |     {
17 |         return $compiler->write('$this->' . $this->name);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/ReturnNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class ReturnNode extends Node
12 | {
13 |     public function __construct(private ?Node $node = null) {}
14 | 
15 |     public function compile(Compiler $compiler): Compiler
16 |     {
17 |         $code = $this->node ? ' ' . $compiler->sub()->compile($this->node)->code() : '';
18 | 
19 |         return $compiler->write("return$code;");
20 |     }
21 | 
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/ShortClosureNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class ShortClosureNode extends Node
12 | {
13 |     private Node $returnNode;
14 | 
15 |     /** @var array<ParameterDeclarationNode> */
16 |     private array $parameters = [];
17 | 
18 |     public function __construct(Node $returnNode)
19 |     {
20 |         $this->returnNode = $returnNode;
21 |     }
22 | 
23 |     public function witParameters(ParameterDeclarationNode ...$parameters): self
24 |     {
25 |         $self = clone $this;
26 |         $self->parameters = $parameters;
27 | 
28 |         return $self;
29 |     }
30 | 
31 |     public function compile(Compiler $compiler): Compiler
32 |     {
33 |         $parameters = implode(', ', array_map(
34 |             fn (ParameterDeclarationNode $parameter) => $compiler->sub()->compile($parameter)->code(),
35 |             $this->parameters,
36 |         ));
37 | 
38 |         $return = $compiler->sub()->compile($this->returnNode)->code();
39 | 
40 |         return $compiler->write(
41 |             <<<PHP
42 |             fn ($parameters) => $return
43 |             PHP,
44 |         );
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/StaticAccessNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class StaticAccessNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $left,
15 |         /** @var non-empty-string */
16 |         private string $name,
17 |     ) {}
18 | 
19 |     public function compile(Compiler $compiler): Compiler
20 |     {
21 |         return $compiler
22 |             ->compile($this->left)
23 |             ->write("::$this->name");
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/StaticMethodCallNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class StaticMethodCallNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $node,
15 |         /** @var non-empty-string */
16 |         private string $method,
17 |         /** @var array<Node> */
18 |         private array $arguments = [],
19 |     ) {}
20 | 
21 |     public function compile(Compiler $compiler): Compiler
22 |     {
23 |         return $compiler->compile(
24 |             new CallNode(new StaticAccessNode($this->node, $this->method), $this->arguments)
25 |         );
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/TernaryNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class TernaryNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $condition,
15 |         private Node $ifTrue,
16 |         private Node $ifFalse,
17 |     ) {}
18 | 
19 |     public function compile(Compiler $compiler): Compiler
20 |     {
21 |         return $compiler
22 |             ->compile($this->condition)
23 |             ->write(' ? ')
24 |             ->compile($this->ifTrue)
25 |             ->write(' : ')
26 |             ->compile($this->ifFalse);
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/ThrowNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class ThrowNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $node,
15 |     ) {}
16 | 
17 |     public function compile(Compiler $compiler): Compiler
18 |     {
19 |         return $compiler
20 |             ->write('throw ')
21 |             ->compile($this->node);
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/VariableAccessNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class VariableAccessNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $node,
15 |         /** @var non-empty-string */
16 |         private string $value
17 |     ) {}
18 | 
19 |     public function compile(Compiler $compiler): Compiler
20 |     {
21 |         return $compiler
22 |             ->compile($this->node)
23 |             ->write('->' . $this->value);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/VariableNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class VariableNode extends Node
12 | {
13 |     public function __construct(private string $name) {}
14 | 
15 |     public function compile(Compiler $compiler): Compiler
16 |     {
17 |         return $compiler->write('$' . $this->name);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/WrapNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class WrapNode extends Node
12 | {
13 |     public function __construct(private Node $node) {}
14 | 
15 |     public function compile(Compiler $compiler): Compiler
16 |     {
17 |         return $compiler
18 |             ->write('(')
19 |             ->compile($this->node)
20 |             ->write(')');
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Compiler/Native/YieldNode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Compiler\Native;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Compiler;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | 
10 | /** @internal */
11 | final class YieldNode extends Node
12 | {
13 |     public function __construct(
14 |         private Node $key,
15 |         private Node $value,
16 |     ) {}
17 | 
18 |     public function compile(Compiler $compiler): Compiler
19 |     {
20 |         return $compiler
21 |             ->write('yield ')
22 |             ->compile($this->key)
23 |             ->write(' => ')
24 |             ->compile($this->value);
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Definition/AttributeDefinition.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition;
 6 | 
 7 | /** @internal */
 8 | final class AttributeDefinition
 9 | {
10 |     public function __construct(
11 |         public readonly ClassDefinition $class,
12 |         /** @var list<mixed> */
13 |         public readonly array $arguments,
14 |     ) {}
15 | 
16 |     public function instantiate(): object
17 |     {
18 |         return new ($this->class->type->className())(...$this->arguments);
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Definition/ClassDefinition.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition;
 6 | 
 7 | use CuyZ\Valinor\Type\ObjectType;
 8 | 
 9 | /** @internal */
10 | final class ClassDefinition
11 | {
12 |     public function __construct(
13 |         /** @var class-string */
14 |         public readonly string $name,
15 |         public readonly ObjectType $type,
16 |         public readonly Attributes $attributes,
17 |         public readonly Properties $properties,
18 |         public readonly Methods $methods,
19 |         public readonly bool $isFinal,
20 |         public readonly bool $isAbstract,
21 |     ) {}
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Definition/Exception/ClassTypeAliasesDuplication.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Exception;
 6 | 
 7 | use LogicException;
 8 | 
 9 | use function implode;
10 | 
11 | /** @internal */
12 | final class ClassTypeAliasesDuplication extends LogicException
13 | {
14 |     /**
15 |      * @param class-string $className
16 |      */
17 |     public function __construct(string $className, string ...$names)
18 |     {
19 |         $names = implode('`, `', $names);
20 | 
21 |         parent::__construct(
22 |             "The following type aliases already exist in class `$className`: `$names`.",
23 |             1638477604
24 |         );
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Definition/Exception/ExtendTagTypeError.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use ReflectionClass;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class ExtendTagTypeError extends RuntimeException
13 | {
14 |     /**
15 |      * @param ReflectionClass<object> $reflection
16 |      */
17 |     public function __construct(ReflectionClass $reflection, InvalidType $previous)
18 |     {
19 |         parent::__construct(
20 |             "The `@extends` tag of the class `$reflection->name` is not valid: {$previous->getMessage()}",
21 |             1670193574,
22 |             $previous,
23 |         );
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Definition/Exception/InvalidExtendTagClassName.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | use ReflectionClass;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class InvalidExtendTagClassName extends RuntimeException
13 | {
14 |     /**
15 |      * @param ReflectionClass<object> $reflection
16 |      */
17 |     public function __construct(ReflectionClass $reflection, Type $invalidExtendTag)
18 |     {
19 |         /** @var ReflectionClass<object> $parentClass */
20 |         $parentClass = $reflection->getParentClass();
21 | 
22 |         parent::__construct(
23 |             "The `@extends` tag of the class `$reflection->name` has invalid class `{$invalidExtendTag->toString()}`, it should be `$parentClass->name`.",
24 |             1670183564,
25 |         );
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Definition/Exception/InvalidExtendTagType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | use ReflectionClass;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class InvalidExtendTagType extends RuntimeException
13 | {
14 |     /**
15 |      * @param ReflectionClass<object> $reflection
16 |      */
17 |     public function __construct(ReflectionClass $reflection, Type $invalidExtendTag)
18 |     {
19 |         /** @var ReflectionClass<object> $parentClass */
20 |         $parentClass = $reflection->getParentClass();
21 | 
22 |         parent::__construct(
23 |             "The `@extends` tag of the class `$reflection->name` has invalid type `{$invalidExtendTag->toString()}`, it should be `{$parentClass->name}`.",
24 |             1670181134,
25 |         );
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Definition/Exception/InvalidTypeAliasImportClass.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\ObjectType;
 8 | use LogicException;
 9 | 
10 | /** @internal */
11 | final class InvalidTypeAliasImportClass extends LogicException
12 | {
13 |     public function __construct(ObjectType $type, string $className)
14 |     {
15 |         parent::__construct(
16 |             "Cannot import a type alias from unknown class `$className` in class `{$type->className()}`.",
17 |             1638535486
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Definition/Exception/InvalidTypeAliasImportClassType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\ObjectType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use LogicException;
10 | 
11 | /** @internal */
12 | final class InvalidTypeAliasImportClassType extends LogicException
13 | {
14 |     public function __construct(ObjectType $classType, Type $type)
15 |     {
16 |         parent::__construct(
17 |             "Importing a type alias can only be done with classes, `{$type->toString()}` was given in class `{$classType->className()}`.",
18 |             1638535608
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Definition/Exception/SeveralExtendTagsFound.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Exception;
 6 | 
 7 | use ReflectionClass;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class SeveralExtendTagsFound extends RuntimeException
12 | {
13 |     /**
14 |      * @param ReflectionClass<object> $reflection
15 |      */
16 |     public function __construct(ReflectionClass $reflection)
17 |     {
18 |         parent::__construct(
19 |             "Only one `@extends` tag should be set for the class `$reflection->name`.",
20 |             1670195494,
21 |         );
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Definition/Exception/UnknownTypeAliasImport.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\ObjectType;
 8 | use LogicException;
 9 | 
10 | /** @internal */
11 | final class UnknownTypeAliasImport extends LogicException
12 | {
13 |     /**
14 |      * @param class-string $importClassName
15 |      */
16 |     public function __construct(ObjectType $type, string $importClassName, string $alias)
17 |     {
18 |         parent::__construct(
19 |             "Type alias `$alias` imported in `{$type->className()}` could not be found in `$importClassName`",
20 |             1638535757
21 |         );
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Definition/FunctionDefinition.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | 
 9 | /** @internal */
10 | final class FunctionDefinition
11 | {
12 |     public function __construct(
13 |         /** @var non-empty-string */
14 |         public readonly string $name,
15 |         /** @var non-empty-string */
16 |         public readonly string $signature,
17 |         public readonly Attributes $attributes,
18 |         /** @var non-empty-string|null */
19 |         public readonly ?string $fileName,
20 |         /** @var class-string|null */
21 |         public readonly ?string $class,
22 |         public readonly bool $isStatic,
23 |         public readonly bool $isClosure,
24 |         public readonly Parameters $parameters,
25 |         public readonly Type $returnType
26 |     ) {}
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Definition/FunctionObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition;
 6 | 
 7 | /** @internal */
 8 | final class FunctionObject
 9 | {
10 |     public readonly FunctionDefinition $definition;
11 | 
12 |     /** @var callable */
13 |     public readonly mixed $callback;
14 | 
15 |     public function __construct(FunctionDefinition $definition, callable $callback)
16 |     {
17 |         $this->definition = $definition;
18 |         $this->callback = $callback;
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Definition/MethodDefinition.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | 
 9 | /** @internal */
10 | final class MethodDefinition
11 | {
12 |     public function __construct(
13 |         /** @var non-empty-string */
14 |         public readonly string $name,
15 |         /** @var non-empty-string */
16 |         public readonly string $signature,
17 |         public readonly Attributes $attributes,
18 |         public readonly Parameters $parameters,
19 |         public readonly bool $isStatic,
20 |         public readonly bool $isPublic,
21 |         public readonly Type $returnType
22 |     ) {}
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Definition/ParameterDefinition.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | 
 9 | /** @internal */
10 | final class ParameterDefinition
11 | {
12 |     public function __construct(
13 |         /** @var non-empty-string */
14 |         public readonly string $name,
15 |         /** @var non-empty-string */
16 |         public readonly string $signature,
17 |         public readonly Type $type,
18 |         public readonly Type $nativeType,
19 |         public readonly bool $isOptional,
20 |         public readonly bool $isVariadic,
21 |         public readonly mixed $defaultValue,
22 |         public readonly Attributes $attributes
23 |     ) {}
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Definition/Properties.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition;
 6 | 
 7 | use Countable;
 8 | use IteratorAggregate;
 9 | use Traversable;
10 | 
11 | /**
12 |  * @internal
13 |  *
14 |  * @implements IteratorAggregate<string, PropertyDefinition>
15 |  */
16 | final class Properties implements IteratorAggregate, Countable
17 | {
18 |     /**  @var PropertyDefinition[] */
19 |     private array $properties = [];
20 | 
21 |     public function __construct(PropertyDefinition ...$properties)
22 |     {
23 |         foreach ($properties as $property) {
24 |             $this->properties[$property->name] = $property;
25 |         }
26 |     }
27 | 
28 |     public function has(string $name): bool
29 |     {
30 |         return isset($this->properties[$name]);
31 |     }
32 | 
33 |     public function get(string $name): PropertyDefinition
34 |     {
35 |         return $this->properties[$name];
36 |     }
37 | 
38 |     public function count(): int
39 |     {
40 |         return count($this->properties);
41 |     }
42 | 
43 |     /**
44 |      * @return Traversable<string, PropertyDefinition>
45 |      */
46 |     public function getIterator(): Traversable
47 |     {
48 |         yield from $this->properties;
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Definition/PropertyDefinition.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | 
 9 | /** @internal */
10 | final class PropertyDefinition
11 | {
12 |     public function __construct(
13 |         /** @var non-empty-string */
14 |         public readonly string $name,
15 |         /** @var non-empty-string */
16 |         public readonly string $signature,
17 |         public readonly Type $type,
18 |         public readonly Type $nativeType,
19 |         public readonly bool $hasDefaultValue,
20 |         public readonly mixed $defaultValue,
21 |         public readonly bool $isPublic,
22 |         public readonly Attributes $attributes
23 |     ) {}
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Definition/Repository/AttributesRepository.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Repository;
 6 | 
 7 | use CuyZ\Valinor\Definition\AttributeDefinition;
 8 | use ReflectionClass;
 9 | use ReflectionFunction;
10 | use ReflectionMethod;
11 | use ReflectionParameter;
12 | use ReflectionProperty;
13 | use Reflector;
14 | 
15 | /** @internal */
16 | interface AttributesRepository
17 | {
18 |     /**
19 |      * @param ReflectionClass<object>|ReflectionProperty|ReflectionMethod|ReflectionFunction|ReflectionParameter $reflection
20 |      * @return list<AttributeDefinition>
21 |      */
22 |     public function for(Reflector $reflection): array;
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Definition/Repository/Cache/CacheClassDefinitionRepository.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Repository\Cache;
 6 | 
 7 | use CuyZ\Valinor\Definition\ClassDefinition;
 8 | use CuyZ\Valinor\Definition\Repository\ClassDefinitionRepository;
 9 | use CuyZ\Valinor\Type\ObjectType;
10 | use Psr\SimpleCache\CacheInterface;
11 | 
12 | /** @internal */
13 | final class CacheClassDefinitionRepository implements ClassDefinitionRepository
14 | {
15 |     public function __construct(
16 |         private ClassDefinitionRepository $delegate,
17 |         /** @var CacheInterface<ClassDefinition> */
18 |         private CacheInterface $cache
19 |     ) {}
20 | 
21 |     public function for(ObjectType $type): ClassDefinition
22 |     {
23 |         // @infection-ignore-all
24 |         $key = "class-definition-\0" . $type->toString();
25 | 
26 |         $entry = $this->cache->get($key);
27 | 
28 |         if ($entry) {
29 |             return $entry;
30 |         }
31 | 
32 |         $class = $this->delegate->for($type);
33 | 
34 |         $this->cache->set($key, $class);
35 | 
36 |         return $class;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Definition/Repository/Cache/CacheFunctionDefinitionRepository.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Repository\Cache;
 6 | 
 7 | use CuyZ\Valinor\Definition\FunctionDefinition;
 8 | use CuyZ\Valinor\Definition\Repository\FunctionDefinitionRepository;
 9 | use CuyZ\Valinor\Utility\Reflection\Reflection;
10 | use Psr\SimpleCache\CacheInterface;
11 | 
12 | /** @internal */
13 | final class CacheFunctionDefinitionRepository implements FunctionDefinitionRepository
14 | {
15 |     public function __construct(
16 |         private FunctionDefinitionRepository $delegate,
17 |         /** @var CacheInterface<FunctionDefinition> */
18 |         private CacheInterface $cache
19 |     ) {}
20 | 
21 |     public function for(callable $function): FunctionDefinition
22 |     {
23 |         $reflection = Reflection::function($function);
24 | 
25 |         // @infection-ignore-all
26 |         $key = "function-definition-\0" . $reflection->getFileName() . ':' . $reflection->getStartLine() . '-' . $reflection->getEndLine();
27 | 
28 |         $entry = $this->cache->get($key);
29 | 
30 |         if ($entry) {
31 |             return $entry;
32 |         }
33 | 
34 |         $definition = $this->delegate->for($function);
35 | 
36 |         $this->cache->set($key, $definition);
37 | 
38 |         return $definition;
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Definition/Repository/Cache/Compiler/Exception/TypeCannotBeCompiled.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Repository\Cache\Compiler\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | use LogicException;
 9 | 
10 | /** @internal */
11 | final class TypeCannotBeCompiled extends LogicException
12 | {
13 |     public function __construct(Type $type)
14 |     {
15 |         $class = $type::class;
16 | 
17 |         parent::__construct(
18 |             "The type `$class` cannot be compiled.",
19 |             1616926126
20 |         );
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Definition/Repository/ClassDefinitionRepository.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Repository;
 6 | 
 7 | use CuyZ\Valinor\Definition\ClassDefinition;
 8 | use CuyZ\Valinor\Type\ObjectType;
 9 | 
10 | /** @internal */
11 | interface ClassDefinitionRepository
12 | {
13 |     public function for(ObjectType $type): ClassDefinition;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Definition/Repository/FunctionDefinitionRepository.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Repository;
 6 | 
 7 | use CuyZ\Valinor\Definition\FunctionDefinition;
 8 | 
 9 | /** @internal */
10 | interface FunctionDefinitionRepository
11 | {
12 |     public function for(callable $function): FunctionDefinition;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Definition/Repository/Reflection/TypeResolver/PropertyTypeResolver.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Definition\Repository\Reflection\TypeResolver;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\Annotations;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use ReflectionProperty;
10 | 
11 | /** @internal */
12 | final class PropertyTypeResolver
13 | {
14 |     public function __construct(private ReflectionTypeResolver $typeResolver) {}
15 | 
16 |     public function resolveTypeFor(ReflectionProperty $reflection): Type
17 |     {
18 |         $docBlockType = $this->extractTypeFromDocBlock($reflection);
19 | 
20 |         return $this->typeResolver->resolveType($reflection->getType(), $docBlockType);
21 |     }
22 | 
23 |     public function resolveNativeTypeFor(ReflectionProperty $reflection): Type
24 |     {
25 |         return $this->typeResolver->resolveNativeType($reflection->getType());
26 |     }
27 | 
28 |     public function extractTypeFromDocBlock(ReflectionProperty $reflection): ?string
29 |     {
30 |         $docBlock = $reflection->getDocComment();
31 | 
32 |         if ($docBlock === false) {
33 |             return null;
34 |         }
35 | 
36 |         return (new Annotations($docBlock))->firstOf(
37 |             '@phpstan-var',
38 |             '@psalm-var',
39 |             '@var',
40 |         )?->raw();
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Mapper/ArgumentsMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper;
 6 | 
 7 | /** @api */
 8 | interface ArgumentsMapper
 9 | {
10 |     /**
11 |      * @return array<string, mixed>
12 |      *
13 |      * @throws MappingError
14 |      */
15 |     public function mapArguments(callable $callable, mixed $source): array;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Mapper/Exception/InvalidMappingTypeSignature.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class InvalidMappingTypeSignature extends RuntimeException
12 | {
13 |     public function __construct(string $raw, InvalidType $exception)
14 |     {
15 |         parent::__construct(
16 |             "Could not parse the type `$raw` that should be mapped: {$exception->getMessage()}",
17 |             1630959692,
18 |             $exception
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Mapper/Exception/TypeErrorDuringArgumentsMapping.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\FunctionDefinition;
 8 | use CuyZ\Valinor\Mapper\Tree\Exception\UnresolvableShellType;
 9 | use LogicException;
10 | 
11 | /** @internal */
12 | final class TypeErrorDuringArgumentsMapping extends LogicException
13 | {
14 |     public function __construct(FunctionDefinition $function, UnresolvableShellType $exception)
15 |     {
16 |         parent::__construct(
17 |             "Could not map arguments of `$function->signature`: {$exception->getMessage()}",
18 |             1711534351,
19 |             $exception,
20 |         );
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Mapper/Exception/TypeErrorDuringMapping.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Exception;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Exception\UnresolvableShellType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use LogicException;
10 | 
11 | /** @internal */
12 | final class TypeErrorDuringMapping extends LogicException
13 | {
14 |     public function __construct(Type $type, UnresolvableShellType $exception)
15 |     {
16 |         parent::__construct(
17 |             "Error while trying to map to `{$type->toString()}`: {$exception->getMessage()}",
18 |             1711526329,
19 |             $exception,
20 |         );
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Mapper/MappingError.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Node;
 8 | use Throwable;
 9 | 
10 | /** @api */
11 | interface MappingError extends Throwable
12 | {
13 |     public function node(): Node;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/Exception/CannotInstantiateObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\ClassDefinition;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class CannotInstantiateObject extends RuntimeException
12 | {
13 |     public function __construct(ClassDefinition $class)
14 |     {
15 |         parent::__construct(
16 |             "No available constructor found for class `{$class->name}`.",
17 |             1646916477
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/Exception/CannotParseToDateTime.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object\Exception;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Message\ErrorMessage;
 8 | use CuyZ\Valinor\Mapper\Tree\Message\HasParameters;
 9 | use CuyZ\Valinor\Utility\String\StringFormatter;
10 | use RuntimeException;
11 | 
12 | /** @internal */
13 | final class CannotParseToDateTime extends RuntimeException implements ErrorMessage, HasParameters
14 | {
15 |     private string $body = 'Value {source_value} does not match any of the following formats: {formats}.';
16 | 
17 |     /** @var array<string, string> */
18 |     private array $parameters;
19 | 
20 |     /**
21 |      * @param non-empty-list<non-empty-string> $formats
22 |      */
23 |     public function __construct(array $formats)
24 |     {
25 |         $this->parameters = [
26 |             'formats' => '`' . implode('`, `', $formats) . '`',
27 |         ];
28 | 
29 |         parent::__construct(StringFormatter::for($this), 1630686564);
30 |     }
31 | 
32 |     public function body(): string
33 |     {
34 |         return $this->body;
35 |     }
36 | 
37 |     public function parameters(): array
38 |     {
39 |         return $this->parameters;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/Exception/InvalidConstructorClassTypeParameter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\FunctionDefinition;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use LogicException;
10 | 
11 | /** @internal */
12 | final class InvalidConstructorClassTypeParameter extends LogicException
13 | {
14 |     public function __construct(FunctionDefinition $function, Type $type)
15 |     {
16 |         parent::__construct(
17 |             "Invalid type `{$type->toString()}` for the first parameter of the constructor `{$function->signature}`, it should be of type `class-string`.",
18 |             1661517000
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/Exception/InvalidConstructorMethodWithAttributeReturnType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\MethodDefinition;
 8 | use CuyZ\Valinor\Type\Types\UnresolvableType;
 9 | use LogicException;
10 | 
11 | /** @internal */
12 | final class InvalidConstructorMethodWithAttributeReturnType extends LogicException
13 | {
14 |     /**
15 |      * @param class-string $expectedClassName
16 |      */
17 |     public function __construct(string $expectedClassName, MethodDefinition $method)
18 |     {
19 |         if ($method->returnType instanceof UnresolvableType) {
20 |             $message = $method->returnType->message();
21 |         } else {
22 |             $message = "Invalid return type `{$method->returnType->toString()}` for constructor `{$method->signature}`, it must be `$expectedClassName`.";
23 |         }
24 | 
25 |         parent::__construct($message, 1708104783);
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/Exception/InvalidConstructorReturnType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\FunctionDefinition;
 8 | use CuyZ\Valinor\Type\Types\UnresolvableType;
 9 | use LogicException;
10 | 
11 | /** @internal */
12 | final class InvalidConstructorReturnType extends LogicException
13 | {
14 |     public function __construct(FunctionDefinition $function)
15 |     {
16 |         if ($function->returnType instanceof UnresolvableType) {
17 |             $message = $function->returnType->message();
18 |         } else {
19 |             $message = "Invalid return type `{$function->returnType->toString()}` for constructor `{$function->signature}`, it must be a valid class name.";
20 |         }
21 | 
22 |         parent::__construct($message, 1659446121);
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/Exception/InvalidSource.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object\Exception;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Object\Arguments;
 8 | use CuyZ\Valinor\Mapper\Tree\Message\ErrorMessage;
 9 | use CuyZ\Valinor\Mapper\Tree\Message\HasParameters;
10 | use CuyZ\Valinor\Utility\String\StringFormatter;
11 | use CuyZ\Valinor\Utility\TypeHelper;
12 | use RuntimeException;
13 | 
14 | /** @internal */
15 | final class InvalidSource extends RuntimeException implements ErrorMessage, HasParameters
16 | {
17 |     private string $body;
18 | 
19 |     /** @var array<string, string> */
20 |     private array $parameters;
21 | 
22 |     public function __construct(mixed $source, Arguments $arguments)
23 |     {
24 |         $this->parameters = [
25 |             'expected_type' => TypeHelper::dumpArguments($arguments),
26 |         ];
27 | 
28 |         $this->body = $source === null
29 |             ? 'Cannot be empty and must be filled with a value matching type {expected_type}.'
30 |             : 'Value {source_value} does not match type {expected_type}.';
31 | 
32 |         parent::__construct(StringFormatter::for($this), 1632903281);
33 |     }
34 | 
35 |     public function body(): string
36 |     {
37 |         return $this->body;
38 |     }
39 | 
40 |     public function parameters(): array
41 |     {
42 |         return $this->parameters;
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/Exception/MissingConstructorClassTypeParameter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\FunctionDefinition;
 8 | use LogicException;
 9 | 
10 | /** @internal */
11 | final class MissingConstructorClassTypeParameter extends LogicException
12 | {
13 |     public function __construct(FunctionDefinition $function)
14 |     {
15 |         parent::__construct(
16 |             "Missing first parameter of type `class-string` for the constructor `{$function->signature}`.",
17 |             1661516853
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/Exception/ObjectBuildersCollision.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object\Exception;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Object\ObjectBuilder;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class ObjectBuildersCollision extends RuntimeException
12 | {
13 |     public function __construct(ObjectBuilder $builderA, ObjectBuilder $builderB)
14 |     {
15 |         parent::__construct(
16 |             "A type collision was detected between the constructors `{$builderA->signature()}` and `{$builderB->signature()}`.",
17 |             1654955787
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/Exception/PermissiveTypeNotAllowed.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | use LogicException;
 9 | 
10 | /** @internal */
11 | final class PermissiveTypeNotAllowed extends LogicException
12 | {
13 |     public function __construct(string $argumentSignature, Type $permissiveType)
14 |     {
15 |         parent::__construct(
16 |             "The type of `$argumentSignature` contains `{$permissiveType->toString()}`, which is not " .
17 |             "allowed in strict mode. If really needed, the `allowPermissiveTypes` setting can be used.",
18 |             1655389255,
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/Factory/CacheObjectBuilderFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object\Factory;
 6 | 
 7 | use CuyZ\Valinor\Definition\ClassDefinition;
 8 | use CuyZ\Valinor\Mapper\Object\ObjectBuilder;
 9 | use Psr\SimpleCache\CacheInterface;
10 | 
11 | /** @internal */
12 | final class CacheObjectBuilderFactory implements ObjectBuilderFactory
13 | {
14 |     public function __construct(
15 |         private ObjectBuilderFactory $delegate,
16 |         /** @var CacheInterface<list<ObjectBuilder>> */
17 |         private CacheInterface $cache
18 |     ) {}
19 | 
20 |     public function for(ClassDefinition $class): array
21 |     {
22 |         $signature = $class->type->toString();
23 | 
24 |         $entry = $this->cache->get($signature);
25 | 
26 |         if ($entry) {
27 |             return $entry;
28 |         }
29 | 
30 |         $builders = $this->delegate->for($class);
31 | 
32 |         $this->cache->set($signature, $builders);
33 | 
34 |         return $builders;
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/Factory/ObjectBuilderFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object\Factory;
 6 | 
 7 | use CuyZ\Valinor\Definition\ClassDefinition;
 8 | use CuyZ\Valinor\Mapper\Object\ObjectBuilder;
 9 | 
10 | /** @internal */
11 | interface ObjectBuilderFactory
12 | {
13 |     /**
14 |      * @return non-empty-list<ObjectBuilder>
15 |      */
16 |     public function for(ClassDefinition $class): array;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/Factory/ReflectionObjectBuilderFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object\Factory;
 6 | 
 7 | use CuyZ\Valinor\Definition\ClassDefinition;
 8 | use CuyZ\Valinor\Mapper\Object\ReflectionObjectBuilder;
 9 | 
10 | /** @internal */
11 | final class ReflectionObjectBuilderFactory implements ObjectBuilderFactory
12 | {
13 |     public function for(ClassDefinition $class): array
14 |     {
15 |         return [new ReflectionObjectBuilder($class)];
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/MethodArguments.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object;
 6 | 
 7 | use CuyZ\Valinor\Definition\Parameters;
 8 | use IteratorAggregate;
 9 | use Traversable;
10 | 
11 | use function array_values;
12 | 
13 | /**
14 |  * @internal
15 |  *
16 |  * @implements IteratorAggregate<mixed>
17 |  */
18 | final class MethodArguments implements IteratorAggregate
19 | {
20 |     /** @var list<mixed> */
21 |     private array $arguments = [];
22 | 
23 |     /**
24 |      * @param array<string, mixed> $arguments
25 |      */
26 |     public function __construct(Parameters $parameters, array $arguments)
27 |     {
28 |         foreach ($parameters as $parameter) {
29 |             $name = $parameter->name;
30 | 
31 |             if ($parameter->isVariadic) {
32 |                 $this->arguments = [...$this->arguments, ...array_values($arguments[$name])]; // @phpstan-ignore-line we know that the argument is iterable
33 |             } else {
34 |                 $this->arguments[] = $arguments[$name];
35 |             }
36 |         }
37 |     }
38 | 
39 |     public function getIterator(): Traversable
40 |     {
41 |         yield from $this->arguments;
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/MethodObjectBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object;
 6 | 
 7 | use CuyZ\Valinor\Definition\Parameters;
 8 | use CuyZ\Valinor\Mapper\Tree\Message\UserlandError;
 9 | use Exception;
10 | 
11 | /** @internal */
12 | final class MethodObjectBuilder implements ObjectBuilder
13 | {
14 |     private Arguments $arguments;
15 | 
16 |     public function __construct(
17 |         private string $className,
18 |         private string $methodName,
19 |         private Parameters $parameters
20 |     ) {}
21 | 
22 |     public function describeArguments(): Arguments
23 |     {
24 |         return $this->arguments ??= Arguments::fromParameters($this->parameters);
25 |     }
26 | 
27 |     public function build(array $arguments): object
28 |     {
29 |         $methodName = $this->methodName;
30 |         $arguments = new MethodArguments($this->parameters, $arguments);
31 | 
32 |         try {
33 |             return ($this->className)::$methodName(...$arguments); // @phpstan-ignore-line
34 |         } catch (Exception $exception) {
35 |             throw UserlandError::from($exception);
36 |         }
37 |     }
38 | 
39 |     public function signature(): string
40 |     {
41 |         return "$this->className::$this->methodName()";
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/NativeConstructorObjectBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object;
 6 | 
 7 | use CuyZ\Valinor\Definition\ClassDefinition;
 8 | use CuyZ\Valinor\Mapper\Tree\Message\UserlandError;
 9 | use Exception;
10 | 
11 | /** @internal */
12 | final class NativeConstructorObjectBuilder implements ObjectBuilder
13 | {
14 |     private Arguments $arguments;
15 | 
16 |     public function __construct(private ClassDefinition $class) {}
17 | 
18 |     public function describeArguments(): Arguments
19 |     {
20 |         return $this->arguments ??= Arguments::fromParameters($this->class->methods->constructor()->parameters);
21 |     }
22 | 
23 |     public function build(array $arguments): object
24 |     {
25 |         $className = $this->class->name;
26 |         $arguments = new MethodArguments($this->class->methods->constructor()->parameters, $arguments);
27 | 
28 |         try {
29 |             return new $className(...$arguments);
30 |         } catch (Exception $exception) {
31 |             throw UserlandError::from($exception);
32 |         }
33 |     }
34 | 
35 |     public function signature(): string
36 |     {
37 |         return $this->class->methods->constructor()->signature;
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/ObjectBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object;
 6 | 
 7 | /** @internal */
 8 | interface ObjectBuilder
 9 | {
10 |     public function describeArguments(): Arguments;
11 | 
12 |     /**
13 |      * @param array<string, mixed> $arguments
14 |      */
15 |     public function build(array $arguments): object;
16 | 
17 |     /**
18 |      * @return non-empty-string
19 |      */
20 |     public function signature(): string;
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Mapper/Object/ReflectionObjectBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Object;
 6 | 
 7 | use CuyZ\Valinor\Definition\ClassDefinition;
 8 | 
 9 | use function count;
10 | 
11 | /** @internal */
12 | final class ReflectionObjectBuilder implements ObjectBuilder
13 | {
14 |     private Arguments $arguments;
15 | 
16 |     public function __construct(private ClassDefinition $class) {}
17 | 
18 |     public function describeArguments(): Arguments
19 |     {
20 |         return $this->arguments ??= Arguments::fromProperties($this->class->properties);
21 |     }
22 | 
23 |     public function build(array $arguments): object
24 |     {
25 |         $object = new ($this->class->name)();
26 | 
27 |         if (count($arguments) > 0) {
28 |             (function () use ($arguments): void {
29 |                 foreach ($arguments as $name => $value) {
30 |                     $this->{$name} = $value; // @phpstan-ignore-line
31 |                 }
32 |             })->call($object);
33 |         }
34 | 
35 |         return $object;
36 |     }
37 | 
38 |     public function signature(): string
39 |     {
40 |         return $this->class->name . ' (properties)';
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Mapper/Source/Exception/FileExtensionNotHandled.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Source\Exception;
 6 | 
 7 | use LogicException;
 8 | 
 9 | /** @internal */
10 | final class FileExtensionNotHandled extends LogicException
11 | {
12 |     public function __construct(string $extension)
13 |     {
14 |         parent::__construct(
15 |             "The file extension `$extension` is not handled.",
16 |             1629991744
17 |         );
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Mapper/Source/Exception/InvalidJson.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Source\Exception;
 6 | 
 7 | use JsonException;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class InvalidJson extends RuntimeException implements InvalidSource
12 | {
13 |     public function __construct(private string $source, ?JsonException $previous = null)
14 |     {
15 |         parent::__construct(
16 |             'Invalid JSON source.',
17 |             1566307185,
18 |             $previous
19 |         );
20 |     }
21 | 
22 |     public function source(): string
23 |     {
24 |         return $this->source;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Mapper/Source/Exception/InvalidSource.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Source\Exception;
 6 | 
 7 | use Throwable;
 8 | 
 9 | /** @api */
10 | interface InvalidSource extends Throwable
11 | {
12 |     public function source(): mixed;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Mapper/Source/Exception/InvalidYaml.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Source\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class InvalidYaml extends RuntimeException implements InvalidSource
11 | {
12 |     public function __construct(private string $source)
13 |     {
14 |         parent::__construct(
15 |             'Invalid YAML source.',
16 |             1629990223
17 |         );
18 |     }
19 | 
20 |     public function source(): string
21 |     {
22 |         return $this->source;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Mapper/Source/Exception/SourceNotIterable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Source\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class SourceNotIterable extends RuntimeException implements InvalidSource
11 | {
12 |     public function __construct(private string $source)
13 |     {
14 |         parent::__construct(
15 |             'Invalid source, expected an iterable.',
16 |             1566307291
17 |         );
18 |     }
19 | 
20 |     public function source(): string
21 |     {
22 |         return $this->source;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Mapper/Source/Exception/UnableToReadFile.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Source\Exception;
 6 | 
 7 | use LogicException;
 8 | 
 9 | /** @internal */
10 | final class UnableToReadFile extends LogicException
11 | {
12 |     public function __construct(string $filename)
13 |     {
14 |         parent::__construct(
15 |             "Unable to read the file `$filename`.",
16 |             1629993117
17 |         );
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Mapper/Source/Exception/YamlExtensionNotEnabled.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Source\Exception;
 6 | 
 7 | use LogicException;
 8 | 
 9 | /**
10 |  * @internal
11 |  *
12 |  * @codeCoverageIgnore
13 |  * @infection-ignore-all
14 |  */
15 | final class YamlExtensionNotEnabled extends LogicException
16 | {
17 |     public function __construct()
18 |     {
19 |         parent::__construct(
20 |             "The PHP YAML extension is not enabled.",
21 |             1629990959
22 |         );
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Mapper/Source/IdentifiableSource.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Source;
 6 | 
 7 | /** @api */
 8 | interface IdentifiableSource
 9 | {
10 |     public function sourceName(): string;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Mapper/Source/Modifier/Mapping.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Source\Modifier;
 6 | 
 7 | /** @internal */
 8 | final class Mapping
 9 | {
10 |     /** @var array<string> */
11 |     private array $keys;
12 | 
13 |     private string $to;
14 | 
15 |     private int $depth;
16 | 
17 |     /**
18 |      * @param array<string> $keys
19 |      */
20 |     public function __construct(array $keys, string $to)
21 |     {
22 |         $this->keys = $keys;
23 |         $this->to = $to;
24 |         $this->depth = count($keys) - 1;
25 |     }
26 | 
27 |     public function matches(int|string $key, int $atDepth): bool
28 |     {
29 |         $from = $this->keys[$atDepth] ?? null;
30 | 
31 |         return $from === (string)$key || $from === '*';
32 |     }
33 | 
34 |     public function findMappedKey(int|string $key, int $atDepth): ?string
35 |     {
36 |         if ($atDepth < $this->depth
37 |             || !$this->matches($key, $atDepth)
38 |         ) {
39 |             return null;
40 |         }
41 | 
42 |         return $this->to;
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Builder/MixedNodeBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Builder;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Exception\CannotMapToPermissiveType;
 8 | use CuyZ\Valinor\Mapper\Tree\Shell;
 9 | use CuyZ\Valinor\Type\Types\MixedType;
10 | 
11 | /** @internal */
12 | final class MixedNodeBuilder implements NodeBuilder
13 | {
14 |     public function build(Shell $shell, RootNodeBuilder $rootBuilder): TreeNode
15 |     {
16 |         assert($shell->type() instanceof MixedType);
17 | 
18 |         if (! $shell->allowPermissiveTypes()) {
19 |             throw new CannotMapToPermissiveType($shell);
20 |         }
21 | 
22 |         return TreeNode::leaf($shell, $shell->value());
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Builder/NodeBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace CuyZ\Valinor\Mapper\Tree\Builder;
 4 | 
 5 | use CuyZ\Valinor\Mapper\Tree\Shell;
 6 | 
 7 | /** @internal */
 8 | interface NodeBuilder
 9 | {
10 |     public function build(Shell $shell, RootNodeBuilder $rootBuilder): TreeNode;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Builder/NullNodeBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Builder;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Exception\SourceIsNotNull;
 8 | use CuyZ\Valinor\Mapper\Tree\Shell;
 9 | use CuyZ\Valinor\Type\Types\NullType;
10 | 
11 | use function assert;
12 | 
13 | /** @internal */
14 | final class NullNodeBuilder implements NodeBuilder
15 | {
16 |     public function build(Shell $shell, RootNodeBuilder $rootBuilder): TreeNode
17 |     {
18 |         $type = $shell->type();
19 |         $value = $shell->value();
20 | 
21 |         assert($type instanceof NullType);
22 | 
23 |         if ($value !== null) {
24 |             return TreeNode::error($shell, new SourceIsNotNull());
25 |         }
26 | 
27 |         return TreeNode::leaf($shell, null);
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Builder/RootNodeBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Builder;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Exception\MissingNodeValue;
 8 | use CuyZ\Valinor\Mapper\Tree\Shell;
 9 | use CuyZ\Valinor\Type\Type;
10 | 
11 | /** @internal */
12 | final class RootNodeBuilder
13 | {
14 |     /**
15 |      * This property is used to detect circular references for objects.
16 |      */
17 |     public Type $currentRootType;
18 | 
19 |     public function __construct(private NodeBuilder $root) {}
20 | 
21 |     public function build(Shell $shell): TreeNode
22 |     {
23 |         if (! $shell->hasValue()) {
24 |             if (! $shell->allowUndefinedValues()) {
25 |                 return TreeNode::error($shell, new MissingNodeValue($shell->type()));
26 |             }
27 | 
28 |             $shell = $shell->withValue(null);
29 |         }
30 | 
31 |         return $this->root->build($shell, $this);
32 |     }
33 | 
34 |     public function withTypeAsCurrentRoot(Type $type): self
35 |     {
36 |         $self = clone $this;
37 |         $self->currentRootType = $type;
38 | 
39 |         return $self;
40 |     }
41 | 
42 |     public function typeWasSeen(Type $type): bool
43 |     {
44 |         return isset($this->currentRootType)
45 |             && $type->toString() === $this->currentRootType->toString();
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Builder/ScalarNodeBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Builder;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Shell;
 8 | use CuyZ\Valinor\Type\ScalarType;
 9 | 
10 | use function assert;
11 | 
12 | /** @internal */
13 | final class ScalarNodeBuilder implements NodeBuilder
14 | {
15 |     public function build(Shell $shell, RootNodeBuilder $rootBuilder): TreeNode
16 |     {
17 |         $type = $shell->type();
18 |         $value = $shell->value();
19 | 
20 |         assert($type instanceof ScalarType);
21 | 
22 |         if ($type->accepts($value)) {
23 |             return TreeNode::leaf($shell, $value);
24 |         }
25 | 
26 |         if (! $shell->allowScalarValueCasting() || ! $type->canCast($value)) {
27 |             return TreeNode::error($shell, $type->errorMessage());
28 |         }
29 | 
30 |         return TreeNode::leaf($shell, $type->cast($value));
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Builder/UndefinedObjectNodeBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Builder;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Exception\CannotMapToPermissiveType;
 8 | use CuyZ\Valinor\Mapper\Tree\Shell;
 9 | use CuyZ\Valinor\Type\Types\UndefinedObjectType;
10 | 
11 | use function assert;
12 | 
13 | /** @internal */
14 | final class UndefinedObjectNodeBuilder implements NodeBuilder
15 | {
16 |     public function build(Shell $shell, RootNodeBuilder $rootBuilder): TreeNode
17 |     {
18 |         assert($shell->type() instanceof UndefinedObjectType);
19 | 
20 |         if (! $shell->allowPermissiveTypes()) {
21 |             throw new CannotMapToPermissiveType($shell);
22 |         }
23 | 
24 |         return TreeNode::leaf($shell, $shell->value());
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Builder/ValueAlteringNodeBuilder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Builder;
 6 | 
 7 | use CuyZ\Valinor\Definition\FunctionsContainer;
 8 | use CuyZ\Valinor\Mapper\Tree\Shell;
 9 | 
10 | /** @internal */
11 | final class ValueAlteringNodeBuilder implements NodeBuilder
12 | {
13 |     public function __construct(
14 |         private NodeBuilder $delegate,
15 |         private FunctionsContainer $functions
16 |     ) {}
17 | 
18 |     public function build(Shell $shell, RootNodeBuilder $rootBuilder): TreeNode
19 |     {
20 |         $node = $this->delegate->build($shell, $rootBuilder);
21 | 
22 |         if (! $node->isValid()) {
23 |             return $node;
24 |         }
25 | 
26 |         $value = $node->value();
27 | 
28 |         foreach ($this->functions as $function) {
29 |             $parameters = $function->definition->parameters;
30 | 
31 |             if (count($parameters) === 0) {
32 |                 continue;
33 |             }
34 | 
35 |             $firstParameterType = $parameters->at(0)->type;
36 | 
37 |             if (! $firstParameterType->accepts($value)) {
38 |                 continue;
39 |             }
40 | 
41 |             $value = ($function->callback)($value);
42 |             $node = $node->withValue($value);
43 |         }
44 | 
45 |         return $node;
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/CannotInferFinalClass.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\FunctionDefinition;
 8 | use CuyZ\Valinor\Type\ClassType;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class CannotInferFinalClass extends RuntimeException
13 | {
14 |     public function __construct(ClassType $class, FunctionDefinition $function)
15 |     {
16 |         parent::__construct(
17 |             "Cannot infer final class `{$class->className()}` with function `$function->signature`.",
18 |             1671468163
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/CannotMapToPermissiveType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Shell;
 8 | use LogicException;
 9 | 
10 | /** @internal */
11 | final class CannotMapToPermissiveType extends LogicException
12 | {
13 |     public function __construct(Shell $shell)
14 |     {
15 |         $type = $shell->type()->toString();
16 | 
17 |         parent::__construct(
18 |             "Type `$type` at path `{$shell->path()}` is not allowed in strict mode. " .
19 |             "In case `$type` is really needed, the `allowPermissiveTypes` setting can be used.",
20 |             1736935538,
21 |         );
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/CannotResolveObjectType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class CannotResolveObjectType extends RuntimeException
11 | {
12 |     public function __construct(string $name)
13 |     {
14 |         parent::__construct(
15 |             "Impossible to resolve an implementation for `$name`.",
16 |             1618049116
17 |         );
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/CircularDependencyDetected.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Object\Argument;
 8 | use LogicException;
 9 | 
10 | /** @internal */
11 | final class CircularDependencyDetected extends LogicException
12 | {
13 |     public function __construct(Argument $argument)
14 |     {
15 |         parent::__construct(
16 |             "Circular dependency detected for `{$argument->signature()}`.",
17 |             1739903374,
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/InterfaceHasBothConstructorAndInfer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use LogicException;
 8 | 
 9 | /** @internal */
10 | final class InterfaceHasBothConstructorAndInfer extends LogicException
11 | {
12 |     /**
13 |      * @param interface-string $name
14 |      */
15 |     public function __construct(string $name)
16 |     {
17 |         parent::__construct(
18 |             "Interface `$name` is configured with at least one constructor but also has an infer configuration. Only one method can be used.",
19 |             1711915749,
20 |         );
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/InvalidAbstractObjectName.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class InvalidAbstractObjectName extends RuntimeException
11 | {
12 |     public function __construct(string $name)
13 |     {
14 |         parent::__construct(
15 |             "Invalid interface or class name `$name`.",
16 |             1653990369
17 |         );
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/InvalidIterableKeyType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | use function get_debug_type;
10 | 
11 | /** @internal */
12 | final class InvalidIterableKeyType extends RuntimeException
13 | {
14 |     public function __construct(mixed $key, string $path)
15 |     {
16 |         $type = get_debug_type($key);
17 | 
18 |         parent::__construct(
19 |             "Invalid key of type `$type` at path `$path`, only integers and strings are allowed.",
20 |             1737104770,
21 |         );
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/InvalidListKey.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Message\ErrorMessage;
 8 | use CuyZ\Valinor\Mapper\Tree\Message\HasParameters;
 9 | use CuyZ\Valinor\Utility\String\StringFormatter;
10 | use CuyZ\Valinor\Utility\ValueDumper;
11 | use RuntimeException;
12 | 
13 | /** @internal */
14 | final class InvalidListKey extends RuntimeException implements ErrorMessage, HasParameters
15 | {
16 |     private string $body = 'Invalid sequential key {key}, expected {expected}.';
17 | 
18 |     /** @var array<string, string> */
19 |     private array $parameters;
20 | 
21 |     public function __construct(int|string $key, int $expected)
22 |     {
23 |         $this->parameters = [
24 |             'key' => ValueDumper::dump($key),
25 |             'expected' => (string)$expected,
26 |         ];
27 | 
28 |         parent::__construct(StringFormatter::for($this), 1654273010);
29 |     }
30 | 
31 |     public function body(): string
32 |     {
33 |         return $this->body;
34 |     }
35 | 
36 |     public function parameters(): array
37 |     {
38 |         return $this->parameters;
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/InvalidNodeHasNoMappedValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class InvalidNodeHasNoMappedValue extends RuntimeException
11 | {
12 |     public function __construct(string $path)
13 |     {
14 |         parent::__construct(
15 |             "Cannot get mapped value for invalid node at path `$path`; use method `\$node->isValid()`.",
16 |             1657466305
17 |         );
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/InvalidNodeValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Message\ErrorMessage;
 8 | use CuyZ\Valinor\Mapper\Tree\Message\HasParameters;
 9 | use CuyZ\Valinor\Type\Type;
10 | use CuyZ\Valinor\Utility\String\StringFormatter;
11 | use CuyZ\Valinor\Utility\TypeHelper;
12 | use RuntimeException;
13 | 
14 | /** @internal */
15 | final class InvalidNodeValue extends RuntimeException implements ErrorMessage, HasParameters
16 | {
17 |     private string $body;
18 | 
19 |     /** @var array<string, string> */
20 |     private array $parameters;
21 | 
22 |     public function __construct(Type $type)
23 |     {
24 |         $this->parameters = [
25 |             'expected_type' => TypeHelper::dump($type),
26 |         ];
27 | 
28 |         $this->body = TypeHelper::containsObject($type)
29 |             ? 'Invalid value {source_value}.'
30 |             : 'Value {source_value} does not match type {expected_type}.';
31 | 
32 |         parent::__construct(StringFormatter::for($this), 1630678334);
33 |     }
34 | 
35 |     public function body(): string
36 |     {
37 |         return $this->body;
38 |     }
39 | 
40 |     public function parameters(): array
41 |     {
42 |         return $this->parameters;
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/InvalidResolvedImplementationValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Utility\ValueDumper;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class InvalidResolvedImplementationValue extends RuntimeException
12 | {
13 |     public function __construct(string $name, mixed $value)
14 |     {
15 |         $value = ValueDumper::dump($value);
16 | 
17 |         parent::__construct(
18 |             "Invalid value $value, expected a subtype of `$name`.",
19 |             1630091260
20 |         );
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/InvalidTraversableKey.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Message\ErrorMessage;
 8 | use CuyZ\Valinor\Mapper\Tree\Message\HasParameters;
 9 | use CuyZ\Valinor\Type\Types\ArrayKeyType;
10 | use CuyZ\Valinor\Utility\String\StringFormatter;
11 | use CuyZ\Valinor\Utility\TypeHelper;
12 | use CuyZ\Valinor\Utility\ValueDumper;
13 | use RuntimeException;
14 | 
15 | /** @internal */
16 | final class InvalidTraversableKey extends RuntimeException implements ErrorMessage, HasParameters
17 | {
18 |     private string $body = 'Key {key} does not match type {expected_type}.';
19 | 
20 |     /** @var array<string, string> */
21 |     private array $parameters;
22 | 
23 |     public function __construct(string|int $key, ArrayKeyType $type)
24 |     {
25 |         $this->parameters = [
26 |             'key' => ValueDumper::dump($key),
27 |             'expected_type' => TypeHelper::dump($type),
28 |         ];
29 | 
30 |         parent::__construct(StringFormatter::for($this), 1630946163);
31 |     }
32 | 
33 |     public function body(): string
34 |     {
35 |         return $this->body;
36 |     }
37 | 
38 |     public function parameters(): array
39 |     {
40 |         return $this->parameters;
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/MissingNodeValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Message\ErrorMessage;
 8 | use CuyZ\Valinor\Mapper\Tree\Message\HasParameters;
 9 | use CuyZ\Valinor\Type\Type;
10 | use CuyZ\Valinor\Utility\String\StringFormatter;
11 | use CuyZ\Valinor\Utility\TypeHelper;
12 | use RuntimeException;
13 | 
14 | /** @internal */
15 | final class MissingNodeValue extends RuntimeException implements ErrorMessage, HasParameters
16 | {
17 |     private string $body = 'Cannot be empty and must be filled with a value matching type {expected_type}.';
18 | 
19 |     /** @var array<string, string> */
20 |     private array $parameters;
21 | 
22 |     public function __construct(Type $type)
23 |     {
24 |         $this->parameters = [
25 |             'expected_type' => TypeHelper::dump($type),
26 |         ];
27 | 
28 |         parent::__construct(StringFormatter::for($this), 1655449641);
29 |     }
30 | 
31 |     public function body(): string
32 |     {
33 |         return $this->body;
34 |     }
35 | 
36 |     public function parameters(): array
37 |     {
38 |         return $this->parameters;
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/MissingObjectImplementationRegistration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\FunctionDefinition;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class MissingObjectImplementationRegistration extends RuntimeException
12 | {
13 |     public function __construct(string $name, FunctionDefinition $functionDefinition)
14 |     {
15 |         parent::__construct(
16 |             "No implementation of `$name` found with return type `{$functionDefinition->returnType->toString()}` of `$functionDefinition->signature`.",
17 |             1653990549
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/ObjectImplementationCallbackError.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use Exception;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class ObjectImplementationCallbackError extends RuntimeException
12 | {
13 |     public function __construct(string $name, private Exception $original)
14 |     {
15 |         parent::__construct(
16 |             "Error thrown when trying to get implementation of `$name`: " . $original->getMessage(),
17 |             1653983061,
18 |             $original
19 |         );
20 |     }
21 | 
22 |     public function original(): Exception
23 |     {
24 |         return $this->original;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/ObjectImplementationNotRegistered.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\ClassType;
 8 | use RuntimeException;
 9 | 
10 | use function array_map;
11 | use function implode;
12 | 
13 | /** @internal */
14 | final class ObjectImplementationNotRegistered extends RuntimeException
15 | {
16 |     /**
17 |      * @param non-empty-array<string, ClassType> $allowed
18 |      */
19 |     public function __construct(string $implementation, string $name, array $allowed)
20 |     {
21 |         $allowed = implode('`, `', array_map(fn (ClassType $type) => $type->toString(), $allowed));
22 | 
23 |         parent::__construct(
24 |             "Invalid implementation `$implementation` for `$name`, it should be one of `$allowed`.",
25 |             1653990989
26 |         );
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/ResolvedImplementationIsNotAccepted.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class ResolvedImplementationIsNotAccepted extends RuntimeException
12 | {
13 |     public function __construct(string $name, Type $incorrectType)
14 |     {
15 |         parent::__construct(
16 |             "Invalid implementation type `{$incorrectType->toString()}`, expected a subtype of `$name`.",
17 |             1618049487
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/SourceIsNotNull.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Message\ErrorMessage;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class SourceIsNotNull extends RuntimeException implements ErrorMessage
12 | {
13 |     private string $body;
14 | 
15 |     public function __construct()
16 |     {
17 |         $this->body = 'Value {source_value} is not null.';
18 | 
19 |         parent::__construct($this->body, 1710263908);
20 |     }
21 | 
22 |     public function body(): string
23 |     {
24 |         return $this->body;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/SourceValueWasNotFilled.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class SourceValueWasNotFilled extends RuntimeException
11 | {
12 |     public function __construct(string $path)
13 |     {
14 |         parent::__construct(
15 |             "Source was not filled at path `$path`; use method `\$node->sourceFilled()`.",
16 |             1657466107
17 |         );
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Exception/UnresolvableShellType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Types\UnresolvableType;
 8 | use LogicException;
 9 | 
10 | /** @internal */
11 | final class UnresolvableShellType extends LogicException
12 | {
13 |     public function __construct(UnresolvableType $type)
14 |     {
15 |         parent::__construct($type->message());
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Message/ErrorMessage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Message;
 6 | 
 7 | use Throwable;
 8 | 
 9 | /** @api */
10 | interface ErrorMessage extends Message, Throwable {}
11 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Message/Formatter/AggregateMessageFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Message\Formatter;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Message\NodeMessage;
 8 | 
 9 | /** @api */
10 | final class AggregateMessageFormatter implements MessageFormatter
11 | {
12 |     /** @var MessageFormatter[] */
13 |     private array $formatters;
14 | 
15 |     public function __construct(MessageFormatter ...$formatters)
16 |     {
17 |         $this->formatters = $formatters;
18 |     }
19 | 
20 |     public function format(NodeMessage $message): NodeMessage
21 |     {
22 |         foreach ($this->formatters as $formatter) {
23 |             $message = $formatter->format($message);
24 |         }
25 | 
26 |         return $message;
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Message/Formatter/CallbackMessageFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Message\Formatter;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Message\NodeMessage;
 8 | 
 9 | /**
10 |  * Can be used to easily customize a message with the given callback.
11 |  *
12 |  * Example:
13 |  *
14 |  * ```php
15 |  * // Customize the body of messages that have a certain code.
16 |  * $formatter = new CallbackMessageFormatter(
17 |  *     fn (NodeMessage $message) => match ($message->code()) {
18 |  *         'some_code_a',
19 |  *         'some_code_b',
20 |  *         'some_code_c' => $message->withBody('some new message body'),
21 |  *         default => $message
22 |  *     }
23 |  * );
24 |  *
25 |  * $message = $formatter->format($message);
26 |  * ```
27 |  *
28 |  * @api
29 |  */
30 | final class CallbackMessageFormatter implements MessageFormatter
31 | {
32 |     /** @var callable(NodeMessage): NodeMessage */
33 |     private $callback;
34 | 
35 |     /**
36 |      * @param callable(NodeMessage): NodeMessage $callback
37 |      */
38 |     public function __construct(callable $callback)
39 |     {
40 |         $this->callback = $callback;
41 |     }
42 | 
43 |     public function format(NodeMessage $message): NodeMessage
44 |     {
45 |         return ($this->callback)($message);
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Message/Formatter/LocaleMessageFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Message\Formatter;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Message\NodeMessage;
 8 | 
 9 | /** @api */
10 | final class LocaleMessageFormatter implements MessageFormatter
11 | {
12 |     public function __construct(private string $locale) {}
13 | 
14 |     public function format(NodeMessage $message): NodeMessage
15 |     {
16 |         return $message->withLocale($this->locale);
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Message/Formatter/MessageFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Message\Formatter;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Message\NodeMessage;
 8 | 
 9 | /** @api */
10 | interface MessageFormatter
11 | {
12 |     public function format(NodeMessage $message): NodeMessage;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Message/HasCode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Message;
 6 | 
 7 | /**
 8 |  * This interface can be implemented by a message to help to identify it with a
 9 |  * unique code.
10 |  *
11 |  * @api
12 |  */
13 | interface HasCode extends Message
14 | {
15 |     public function code(): string;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Message/HasParameters.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Message;
 6 | 
 7 | /**
 8 |  * This interface can be implemented by a message to provide parameters that can
 9 |  * be used as placeholders in the message's body.
10 |  *
11 |  * ```php
12 |  * use CuyZ\Valinor\Mapper\Tree\Message\Message;
13 |  * use CuyZ\Valinor\Mapper\Tree\Message\HasParameters;
14 |  *
15 |  * final class SomeMessage implements Message, HasParameters
16 |  * {
17 |  *     private string $someParameter;
18 |  *
19 |  *     public function __construct(string $someParameter)
20 |  *     {
21 |  *         $this->someParameter = $someParameter;
22 |  *     }
23 |  *
24 |  *     public function body(): string
25 |  *     {
26 |  *         return 'Some message with {some_parameter}';
27 |  *     }
28 |  *
29 |  *     public function parameters(): array
30 |  *     {
31 |  *         return [
32 |  *             'some_parameter' => $this->someParameter,
33 |  *         ];
34 |  *     }
35 |  * }
36 |  * ```
37 |  *
38 |  * @api
39 |  */
40 | interface HasParameters extends Message
41 | {
42 |     /**
43 |      * @return array<string, string>
44 |      */
45 |     public function parameters(): array;
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Message/Message.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Message;
 6 | 
 7 | /** @api */
 8 | interface Message
 9 | {
10 |     public function body(): string;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/Message/UserlandError.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree\Message;
 6 | 
 7 | use RuntimeException;
 8 | use Throwable;
 9 | 
10 | /** @internal */
11 | final class UserlandError extends RuntimeException implements ErrorMessage
12 | {
13 |     public static function from(Throwable $message): Message&Throwable
14 |     {
15 |         // @infection-ignore-all
16 |         return $message instanceof Message
17 |             ? $message
18 |             : new self('Invalid value.', 1657215570, $message);
19 |     }
20 | 
21 |     public function body(): string
22 |     {
23 |         return 'Invalid value.';
24 |     }
25 | 
26 |     public function previous(): Throwable
27 |     {
28 |         return $this->getPrevious(); // @phpstan-ignore-line
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Mapper/Tree/NodeTraverser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper\Tree;
 6 | 
 7 | /**
 8 |  * @api
 9 |  *
10 |  * @template T
11 |  */
12 | final class NodeTraverser
13 | {
14 |     /** @var callable(Node): T */
15 |     private $callback;
16 | 
17 |     /**
18 |      * @param callable(Node): T $callback
19 |      */
20 |     public function __construct(callable $callback)
21 |     {
22 |         $this->callback = $callback;
23 |     }
24 | 
25 |     /**
26 |      * @return iterable<T>
27 |      */
28 |     public function traverse(Node $node): iterable
29 |     {
30 |         return $this->recurse($node);
31 |     }
32 | 
33 |     /**
34 |      * @return iterable<T>
35 |      */
36 |     private function recurse(Node $node): iterable
37 |     {
38 |         yield ($this->callback)($node);
39 | 
40 |         foreach ($node->children() as $child) {
41 |             yield from $this->recurse($child);
42 |         }
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Mapper/TreeMapper.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper;
 6 | 
 7 | /** @api */
 8 | interface TreeMapper
 9 | {
10 |     /**
11 |      * @template T of object
12 |      *
13 |      * @param string|class-string<T> $signature
14 |      * @return T
15 |      * @phpstan-return (
16 |      *     $signature is class-string<T>
17 |      *         ? T
18 |      *         : ($signature is class-string ? object : mixed)
19 |      * )
20 |      *
21 |      * @throws MappingError
22 |      */
23 |     public function map(string $signature, mixed $source): mixed;
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Mapper/TypeTreeMapperError.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Mapper;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Message\Messages;
 8 | use CuyZ\Valinor\Mapper\Tree\Node;
 9 | use CuyZ\Valinor\Utility\ValueDumper;
10 | use RuntimeException;
11 | 
12 | /** @internal */
13 | final class TypeTreeMapperError extends RuntimeException implements MappingError
14 | {
15 |     public function __construct(private Node $node)
16 |     {
17 |         $errors = Messages::flattenFromNode($node)->errors();
18 |         $errorsCount = count($errors);
19 | 
20 |         if ($errorsCount === 1) {
21 |             $body = $errors
22 |                 ->toArray()[0]
23 |                 ->withParameter('root_type', $node->type())
24 |                 ->withBody("Could not map type `{root_type}`. An error occurred at path {node_path}: {original_message}")
25 |                 ->toString();
26 |         } else {
27 |             $source = ValueDumper::dump($node->sourceValue());
28 |             $body = "Could not map type `{$node->type()}` with value $source. A total of $errorsCount errors were encountered.";
29 |         }
30 | 
31 |         parent::__construct($body, 1617193185);
32 |     }
33 | 
34 |     public function node(): Node
35 |     {
36 |         return $this->node;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Normalizer/ArrayNormalizer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer;
 6 | 
 7 | use CuyZ\Valinor\Normalizer\Transformer\EmptyObject;
 8 | use CuyZ\Valinor\Normalizer\Transformer\Transformer;
 9 | 
10 | /**
11 |  * @api
12 |  *
13 |  * @implements Normalizer<array<mixed>|scalar|null>
14 |  */
15 | final class ArrayNormalizer implements Normalizer
16 | {
17 |     public function __construct(
18 |         private Transformer $transformer,
19 |     ) {}
20 | 
21 |     public function normalize(mixed $value): mixed
22 |     {
23 |         /** @var array<mixed>|scalar|null */
24 |         return $this->format(
25 |             $this->transformer->transform($value),
26 |         );
27 |     }
28 | 
29 |     private function format(mixed $value): mixed
30 |     {
31 |         if (is_iterable($value)) {
32 |             if (! is_array($value)) {
33 |                 $value = iterator_to_array($value);
34 |             }
35 | 
36 |             $value = array_map($this->format(...), $value);
37 |         } elseif ($value instanceof EmptyObject) {
38 |             return [];
39 |         }
40 | 
41 |         return $value;
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Normalizer/Exception/CircularReferenceFoundDuringNormalization.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class CircularReferenceFoundDuringNormalization extends RuntimeException
11 | {
12 |     public function __construct(object $object)
13 |     {
14 |         $class = $object::class;
15 | 
16 |         parent::__construct(
17 |             "A circular reference was detected with an object of type `$class`. Circular references are not supported by the normalizer.",
18 |             1695064016,
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Normalizer/Exception/KeyTransformerHasTooManyParameters.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\MethodDefinition;
 8 | use LogicException;
 9 | 
10 | /** @internal */
11 | final class KeyTransformerHasTooManyParameters extends LogicException
12 | {
13 |     public function __construct(MethodDefinition $method)
14 |     {
15 |         parent::__construct(
16 |             "Key transformer must have at most 1 parameter, {$method->parameters->count()} given for `$method->signature`.",
17 |             1701701102,
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Normalizer/Exception/KeyTransformerParameterInvalidType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\MethodDefinition;
 8 | use LogicException;
 9 | 
10 | /** @internal */
11 | final class KeyTransformerParameterInvalidType extends LogicException
12 | {
13 |     public function __construct(MethodDefinition $method)
14 |     {
15 |         parent::__construct(
16 |             "Key transformer parameter must be a string, {$method->parameters->at(0)->type->toString()} given for `$method->signature`.",
17 |             1701706316,
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Normalizer/Exception/TransformerHasInvalidCallableParameter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\FunctionDefinition;
 8 | use CuyZ\Valinor\Definition\MethodDefinition;
 9 | use CuyZ\Valinor\Type\Type;
10 | use LogicException;
11 | 
12 | /** @internal */
13 | final class TransformerHasInvalidCallableParameter extends LogicException
14 | {
15 |     public function __construct(MethodDefinition|FunctionDefinition $method, Type $parameterType)
16 |     {
17 |         parent::__construct(
18 |             "Transformer's second parameter must be a callable, `{$parameterType->toString()}` given for `$method->signature`.",
19 |             1695065710,
20 |         );
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Normalizer/Exception/TransformerHasNoParameter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\FunctionDefinition;
 8 | use CuyZ\Valinor\Definition\MethodDefinition;
 9 | use LogicException;
10 | 
11 | /** @internal */
12 | final class TransformerHasNoParameter extends LogicException
13 | {
14 |     public function __construct(MethodDefinition|FunctionDefinition $method)
15 |     {
16 |         parent::__construct(
17 |             "Transformer must have at least one parameter, none given for `$method->signature`.",
18 |             1695064946,
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Normalizer/Exception/TransformerHasTooManyParameters.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Exception;
 6 | 
 7 | use CuyZ\Valinor\Definition\FunctionDefinition;
 8 | use CuyZ\Valinor\Definition\MethodDefinition;
 9 | use LogicException;
10 | 
11 | /** @internal */
12 | final class TransformerHasTooManyParameters extends LogicException
13 | {
14 |     public function __construct(MethodDefinition|FunctionDefinition $method)
15 |     {
16 |         parent::__construct(
17 |             "Transformer must have at most 2 parameters, {$method->parameters->count()} given for `$method->signature`.",
18 |             1695065433,
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Normalizer/Exception/TypeUnhandledByNormalizer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | use function get_debug_type;
10 | 
11 | /** @internal */
12 | final class TypeUnhandledByNormalizer extends RuntimeException
13 | {
14 |     public function __construct(mixed $value)
15 |     {
16 |         $type = get_debug_type($value);
17 | 
18 |         parent::__construct(
19 |             "Value of type `$type` cannot be normalized.",
20 |             1695062925,
21 |         );
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Normalizer/Formatter/Exception/CannotFormatInvalidTypeToJson.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Formatter\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class CannotFormatInvalidTypeToJson extends RuntimeException
11 | {
12 |     public function __construct(mixed $value)
13 |     {
14 |         $type = get_debug_type($value);
15 | 
16 |         parent::__construct(
17 |             "Value of type `$type` cannot be normalized to JSON.",
18 |             1704749897,
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Normalizer/Normalizer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer;
 6 | 
 7 | /**
 8 |  * @api
 9 |  *
10 |  * @template-covariant T
11 |  */
12 | interface Normalizer
13 | {
14 |     /**
15 |      * A normalizer is a service that transforms a given input into scalar and
16 |      * array values, while preserving the original structure.
17 |      *
18 |      * This feature can be used to share information with other systems that use
19 |      * a data format (JSON, CSV, XML, etc.). The normalizer will take care of
20 |      * recursively transforming the data into a format that can be serialized.
21 |      *
22 |      * @return T
23 |      */
24 |     public function normalize(mixed $value): mixed;
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Normalizer/StreamNormalizer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer;
 6 | 
 7 | use CuyZ\Valinor\Normalizer\Formatter\JsonFormatter;
 8 | use CuyZ\Valinor\Normalizer\Transformer\Transformer;
 9 | 
10 | /**
11 |  * @api
12 |  *
13 |  * @implements Normalizer<resource>
14 |  */
15 | final class StreamNormalizer implements Normalizer
16 | {
17 |     public function __construct(
18 |         private Transformer $transformer,
19 |         private JsonFormatter $formatter,
20 |     ) {}
21 | 
22 |     public function normalize(mixed $value): mixed
23 |     {
24 |         $result = $this->transformer->transform($value);
25 | 
26 |         return $this->formatter->format($result);
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Normalizer/Transformer/Compiler/TypeFormatter/DateTimeFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Transformer\Compiler\TypeFormatter;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Native\AnonymousClassNode;
 8 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
 9 | use CuyZ\Valinor\Compiler\Node;
10 | use CuyZ\Valinor\Normalizer\Transformer\Compiler\TransformerDefinitionBuilder;
11 | 
12 | /** @internal */
13 | final class DateTimeFormatter implements TypeFormatter
14 | {
15 |     public function formatValueNode(ComplianceNode $valueNode): Node
16 |     {
17 |         return $valueNode->callMethod('format', [
18 |             Node::value('Y-m-d\\TH:i:s.uP'), // RFC 3339
19 |         ]);
20 |     }
21 | 
22 |     public function manipulateTransformerClass(AnonymousClassNode $class, TransformerDefinitionBuilder $definitionBuilder): AnonymousClassNode
23 |     {
24 |         return $class;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Normalizer/Transformer/Compiler/TypeFormatter/DateTimeZoneFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Transformer\Compiler\TypeFormatter;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Native\AnonymousClassNode;
 8 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
 9 | use CuyZ\Valinor\Compiler\Node;
10 | use CuyZ\Valinor\Normalizer\Transformer\Compiler\TransformerDefinitionBuilder;
11 | 
12 | /** @internal */
13 | final class DateTimeZoneFormatter implements TypeFormatter
14 | {
15 |     public function formatValueNode(ComplianceNode $valueNode): Node
16 |     {
17 |         return $valueNode->callMethod('getName');
18 |     }
19 | 
20 |     public function manipulateTransformerClass(AnonymousClassNode $class, TransformerDefinitionBuilder $definitionBuilder): AnonymousClassNode
21 |     {
22 |         return $class;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Normalizer/Transformer/Compiler/TypeFormatter/EnumFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Transformer\Compiler\TypeFormatter;
 6 | 
 7 | use BackedEnum;
 8 | use CuyZ\Valinor\Compiler\Native\AnonymousClassNode;
 9 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
10 | use CuyZ\Valinor\Compiler\Node;
11 | use CuyZ\Valinor\Normalizer\Transformer\Compiler\TransformerDefinitionBuilder;
12 | use CuyZ\Valinor\Type\Types\EnumType;
13 | 
14 | /** @internal */
15 | final class EnumFormatter implements TypeFormatter
16 | {
17 |     public function __construct(
18 |         private EnumType $type,
19 |     ) {}
20 | 
21 |     public function formatValueNode(ComplianceNode $valueNode): Node
22 |     {
23 |         return is_a($this->type->className(), BackedEnum::class, true)
24 |             ? $valueNode->access('value')
25 |             : $valueNode->access('name');
26 |     }
27 | 
28 |     public function manipulateTransformerClass(AnonymousClassNode $class, TransformerDefinitionBuilder $definitionBuilder): AnonymousClassNode
29 |     {
30 |         return $class;
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Normalizer/Transformer/Compiler/TypeFormatter/InterfaceFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Transformer\Compiler\TypeFormatter;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Native\AnonymousClassNode;
 8 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
 9 | use CuyZ\Valinor\Compiler\Node;
10 | use CuyZ\Valinor\Normalizer\Transformer\Compiler\TransformerDefinitionBuilder;
11 | use CuyZ\Valinor\Type\Types\InterfaceType;
12 | use DateTimeInterface;
13 | 
14 | /** @internal */
15 | final class InterfaceFormatter implements TypeFormatter
16 | {
17 |     public function __construct(
18 |         private InterfaceType $type,
19 |     ) {}
20 | 
21 |     public function formatValueNode(ComplianceNode $valueNode): Node
22 |     {
23 |         if ($this->type->className() === DateTimeInterface::class) {
24 |             return (new DateTimeFormatter())->formatValueNode($valueNode);
25 |         }
26 | 
27 |         return Node::this()
28 |             ->access('delegate')
29 |             ->callMethod('transform', [$valueNode]);
30 |     }
31 | 
32 |     public function manipulateTransformerClass(AnonymousClassNode $class, TransformerDefinitionBuilder $definitionBuilder): AnonymousClassNode
33 |     {
34 |         return $class;
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Normalizer/Transformer/Compiler/TypeFormatter/NullFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Transformer\Compiler\TypeFormatter;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Native\AnonymousClassNode;
 8 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
 9 | use CuyZ\Valinor\Compiler\Node;
10 | use CuyZ\Valinor\Normalizer\Transformer\Compiler\TransformerDefinitionBuilder;
11 | 
12 | /** @internal */
13 | final class NullFormatter implements TypeFormatter
14 | {
15 |     public function formatValueNode(ComplianceNode $valueNode): Node
16 |     {
17 |         return Node::value(null);
18 |     }
19 | 
20 |     public function manipulateTransformerClass(AnonymousClassNode $class, TransformerDefinitionBuilder $definitionBuilder): AnonymousClassNode
21 |     {
22 |         return $class;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Normalizer/Transformer/Compiler/TypeFormatter/ScalarFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Transformer\Compiler\TypeFormatter;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Native\AnonymousClassNode;
 8 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
 9 | use CuyZ\Valinor\Compiler\Node;
10 | use CuyZ\Valinor\Normalizer\Transformer\Compiler\TransformerDefinitionBuilder;
11 | 
12 | /** @internal */
13 | final class ScalarFormatter implements TypeFormatter
14 | {
15 |     public function formatValueNode(ComplianceNode $valueNode): Node
16 |     {
17 |         return $valueNode;
18 |     }
19 | 
20 |     public function manipulateTransformerClass(AnonymousClassNode $class, TransformerDefinitionBuilder $definitionBuilder): AnonymousClassNode
21 |     {
22 |         return $class;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Normalizer/Transformer/Compiler/TypeFormatter/TypeFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Transformer\Compiler\TypeFormatter;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Native\AnonymousClassNode;
 8 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
 9 | use CuyZ\Valinor\Compiler\Node;
10 | use CuyZ\Valinor\Normalizer\Transformer\Compiler\TransformerDefinitionBuilder;
11 | 
12 | /** @internal */
13 | interface TypeFormatter
14 | {
15 |     public function formatValueNode(ComplianceNode $valueNode): Node;
16 | 
17 |     public function manipulateTransformerClass(AnonymousClassNode $class, TransformerDefinitionBuilder $definitionBuilder): AnonymousClassNode;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Normalizer/Transformer/Compiler/TypeFormatter/UnitEnumFormatter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Transformer\Compiler\TypeFormatter;
 6 | 
 7 | use BackedEnum;
 8 | use CuyZ\Valinor\Compiler\Native\AnonymousClassNode;
 9 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
10 | use CuyZ\Valinor\Compiler\Node;
11 | use CuyZ\Valinor\Normalizer\Transformer\Compiler\TransformerDefinitionBuilder;
12 | 
13 | /** @internal */
14 | final class UnitEnumFormatter implements TypeFormatter
15 | {
16 |     public function formatValueNode(ComplianceNode $valueNode): Node
17 |     {
18 |         return Node::ternary(
19 |             condition: $valueNode->instanceOf(BackedEnum::class),
20 |             ifTrue: $valueNode->access('value'),
21 |             ifFalse: $valueNode->access('name'),
22 |         );
23 |     }
24 | 
25 |     public function manipulateTransformerClass(AnonymousClassNode $class, TransformerDefinitionBuilder $definitionBuilder): AnonymousClassNode
26 |     {
27 |         return $class;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Normalizer/Transformer/EmptyObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Transformer;
 6 | 
 7 | use CuyZ\Valinor\Utility\IsSingleton;
 8 | 
 9 | /** @internal */
10 | final class EmptyObject
11 | {
12 |     use IsSingleton;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Normalizer/Transformer/EvaluatedTransformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Transformer;
 6 | 
 7 | /** @internal */
 8 | final class EvaluatedTransformer
 9 | {
10 |     public function __construct(
11 |         public readonly string $code,
12 |     ) {}
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Normalizer/Transformer/Transformer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Normalizer\Transformer;
 6 | 
 7 | /** @internal */
 8 | interface Transformer
 9 | {
10 |     public function transform(mixed $value): mixed;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Type/BooleanType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type;
 6 | 
 7 | /** @internal */
 8 | interface BooleanType extends ScalarType
 9 | {
10 |     public function cast(mixed $value): bool;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Type/ClassType.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | declare(strict_types=1);
4 | 
5 | namespace CuyZ\Valinor\Type;
6 | 
7 | /** @internal */
8 | interface ClassType extends ObjectType {}
9 | 


--------------------------------------------------------------------------------
/src/Type/CombiningType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type;
 6 | 
 7 | /** @internal */
 8 | interface CombiningType extends CompositeType
 9 | {
10 |     public function isMatchedBy(Type $other): bool;
11 | 
12 |     /**
13 |      * @return non-empty-list<Type>
14 |      */
15 |     public function types(): array;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Type/CompositeTraversableType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type;
 6 | 
 7 | use CuyZ\Valinor\Type\Types\ArrayKeyType;
 8 | 
 9 | /** @internal */
10 | interface CompositeTraversableType extends CompositeType
11 | {
12 |     public function keyType(): ArrayKeyType;
13 | 
14 |     public function subType(): Type;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Type/CompositeType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type;
 6 | 
 7 | /** @internal */
 8 | interface CompositeType extends Type
 9 | {
10 |     /**
11 |      * @return list<Type>
12 |      */
13 |     public function traverse(): array;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Type/FixedType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace CuyZ\Valinor\Type;
 4 | 
 5 | /** @internal */
 6 | interface FixedType extends Type
 7 | {
 8 |     public function value(): bool|string|int|float;
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Type/FloatType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type;
 6 | 
 7 | /** @internal */
 8 | interface FloatType extends ScalarType
 9 | {
10 |     public function cast(mixed $value): float;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Type/GenericType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace CuyZ\Valinor\Type;
 4 | 
 5 | /** @internal */
 6 | interface GenericType extends ObjectType, CompositeType
 7 | {
 8 |     /**
 9 |      * @return class-string
10 |      */
11 |     public function className(): string;
12 | 
13 |     /**
14 |      * @return array<non-empty-string, Type>
15 |      */
16 |     public function generics(): array;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Type/IntegerType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type;
 6 | 
 7 | /** @internal */
 8 | interface IntegerType extends ScalarType
 9 | {
10 |     public function cast(mixed $value): int;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Type/ObjectType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type;
 6 | 
 7 | /** @internal */
 8 | interface ObjectType extends Type
 9 | {
10 |     /**
11 |      * @return class-string
12 |      */
13 |     public function className(): string;
14 | 
15 |     public function nativeType(): ObjectType;
16 | 
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Type/Parser/CachedParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | 
 9 | /** @internal */
10 | final class CachedParser implements TypeParser
11 | {
12 |     /** @var array<string, Type> */
13 |     private array $types = [];
14 | 
15 |     public function __construct(private TypeParser $delegate) {}
16 | 
17 |     public function parse(string $raw): Type
18 |     {
19 |         return $this->types[$raw] ??= $this->delegate->parse($raw);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Constant/ClassConstantCaseNotFound.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Constant;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class ClassConstantCaseNotFound extends RuntimeException implements InvalidType
12 | {
13 |     /**
14 |      * @param class-string $className
15 |      */
16 |     public function __construct(string $className, string $case)
17 |     {
18 |         $message = str_contains($case, '*')
19 |             ? "Cannot find class constant case with pattern `$className::$case`."
20 |             : "Unknown class constant case `$className::$case`.";
21 | 
22 |         parent::__construct($message, 1652189140);
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Constant/MissingClassConstantCase.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Constant;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class MissingClassConstantCase extends RuntimeException implements InvalidType
12 | {
13 |     /**
14 |      * @param class-string $className
15 |      */
16 |     public function __construct(string $className)
17 |     {
18 |         parent::__construct(
19 |             "Missing case name for class constant `$className::?`.",
20 |             1664905018
21 |         );
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Enum/EnumCaseNotFound.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Enum;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class EnumCaseNotFound extends RuntimeException implements InvalidType
12 | {
13 |     /**
14 |      * @param class-string $enumName
15 |      */
16 |     public function __construct(string $enumName, string $pattern)
17 |     {
18 |         $message = str_contains($pattern, '*')
19 |             ? "Cannot find enum case with pattern `$enumName::$pattern`."
20 |             : "Unknown enum case `$enumName::$pattern`.";
21 | 
22 |         parent::__construct($message, 1653468428);
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Enum/MissingEnumCase.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Enum;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | use UnitEnum;
10 | 
11 | /** @internal */
12 | final class MissingEnumCase extends RuntimeException implements InvalidType
13 | {
14 |     /**
15 |      * @param class-string<UnitEnum> $enumName
16 |      */
17 |     public function __construct(string $enumName)
18 |     {
19 |         parent::__construct(
20 |             "Missing case name for enum `$enumName::?`.",
21 |             1653468431
22 |         );
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Enum/MissingSpecificEnumCase.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Enum;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | use UnitEnum;
10 | 
11 | /** @internal */
12 | final class MissingSpecificEnumCase extends RuntimeException implements InvalidType
13 | {
14 |     /**
15 |      * @param class-string<UnitEnum> $enumName
16 |      */
17 |     public function __construct(string $enumName)
18 |     {
19 |         parent::__construct(
20 |             "Missing specific case for enum `$enumName::?` (cannot be `*`).",
21 |             1653468438
22 |         );
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Generic/AssignedGenericNotFound.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Generic;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | 
10 | use function implode;
11 | 
12 | /** @internal */
13 | final class AssignedGenericNotFound extends RuntimeException implements InvalidType
14 | {
15 |     public function __construct(string $className, string ...$templates)
16 |     {
17 |         $list = implode('`, `', $templates);
18 | 
19 |         parent::__construct(
20 |             "No generic was assigned to the template(s) `$list` for the class `$className`.",
21 |             1604656730
22 |         );
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Generic/CannotAssignGeneric.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Generic;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | use function array_map;
12 | use function implode;
13 | 
14 | /** @internal */
15 | final class CannotAssignGeneric extends RuntimeException implements InvalidType
16 | {
17 |     public function __construct(string $className, Type ...$generics)
18 |     {
19 |         $list = implode('`, `', array_map(fn (Type $type) => $type->toString(), $generics));
20 | 
21 |         parent::__construct(
22 |             "Could not find a template to assign the generic(s) `$list` for the class `$className`.",
23 |             1604660485
24 |         );
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Generic/GenericClosingBracketMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Generic;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | use function array_map;
12 | use function implode;
13 | 
14 | /** @internal */
15 | final class GenericClosingBracketMissing extends RuntimeException implements InvalidType
16 | {
17 |     /**
18 |      * @param class-string $className
19 |      * @param Type[] $generics
20 |      */
21 |     public function __construct(string $className, array $generics)
22 |     {
23 |         $signature = $className . '<' . implode(', ', array_map(fn (Type $type) => $type->toString(), $generics)) . '>';
24 | 
25 |         parent::__construct(
26 |             "The closing bracket is missing for the generic `$signature`.",
27 |             1604333677
28 |         );
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Generic/GenericCommaMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Generic;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | use function array_map;
12 | use function implode;
13 | 
14 | /** @internal */
15 | final class GenericCommaMissing extends RuntimeException implements InvalidType
16 | {
17 |     /**
18 |      * @param class-string $className
19 |      * @param Type[] $generics
20 |      */
21 |     public function __construct(string $className, array $generics)
22 |     {
23 |         $signature = $className . '<' . implode(', ', array_map(fn (Type $type) => $type->toString(), $generics)) . ', ?>';
24 | 
25 |         parent::__construct(
26 |             "A comma is missing for the generic `$signature`.",
27 |             1615829484
28 |         );
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Generic/InvalidAssignedGeneric.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Generic;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class InvalidAssignedGeneric extends RuntimeException implements InvalidType
13 | {
14 |     /**
15 |      * @param class-string $className
16 |      */
17 |     public function __construct(Type $generic, Type $template, string $name, string $className)
18 |     {
19 |         parent::__construct(
20 |             "The generic `{$generic->toString()}` is not a subtype of `{$template->toString()}` for " .
21 |             "the template `$name` of the class `$className`.",
22 |             1604613633
23 |         );
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Generic/MissingGenerics.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Generic;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | use function array_fill;
12 | use function array_map;
13 | use function count;
14 | use function implode;
15 | 
16 | /** @internal */
17 | final class MissingGenerics extends RuntimeException implements InvalidType
18 | {
19 |     /**
20 |      * @param class-string $className
21 |      * @param Type[] $generics
22 |      * @param array<non-empty-string> $templates
23 |      */
24 |     public function __construct(string $className, array $generics, array $templates)
25 |     {
26 |         /** @var positive-int $missing */
27 |         $missing = count($templates) - count($generics);
28 |         $generics = array_map(fn (Type $type) => $type->toString(), $generics);
29 |         $generics += array_fill(count($generics), $missing, '?');
30 | 
31 |         $signature = $className . '<' . implode(', ', $generics) . '>';
32 | 
33 |         parent::__construct(
34 |             "There are $missing missing generics for `$signature`.",
35 |             1618054357
36 |         );
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/InvalidIntersectionType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class InvalidIntersectionType extends RuntimeException implements InvalidType
12 | {
13 |     public function __construct(Type $type)
14 |     {
15 |         parent::__construct(
16 |             "Invalid intersection member `{$type->toString()}`, it must be a class name or an interface name.",
17 |             1608030163
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/InvalidType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception;
 6 | 
 7 | use Throwable;
 8 | 
 9 | /** @internal */
10 | interface InvalidType extends Throwable {}
11 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/ArrayClosingBracketMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Types\ArrayType;
 9 | use CuyZ\Valinor\Type\Types\NonEmptyArrayType;
10 | use RuntimeException;
11 | 
12 | /** @internal */
13 | final class ArrayClosingBracketMissing extends RuntimeException implements InvalidType
14 | {
15 |     public function __construct(ArrayType|NonEmptyArrayType $arrayType)
16 |     {
17 |         parent::__construct(
18 |             "The closing bracket is missing for `{$arrayType->toString()}`.",
19 |             1606483975
20 |         );
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/ArrayCommaMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use CuyZ\Valinor\Type\Types\ArrayType;
10 | use CuyZ\Valinor\Type\Types\NonEmptyArrayType;
11 | use RuntimeException;
12 | 
13 | /** @internal */
14 | final class ArrayCommaMissing extends RuntimeException implements InvalidType
15 | {
16 |     /**
17 |      * @param class-string<ArrayType|NonEmptyArrayType> $arrayType
18 |      */
19 |     public function __construct(string $arrayType, Type $type)
20 |     {
21 |         $signature = "array<{$type->toString()}, ?>";
22 | 
23 |         if ($arrayType === NonEmptyArrayType::class) {
24 |             $signature = "non-empty-array<{$type->toString()}, ?>";
25 |         }
26 | 
27 |         parent::__construct(
28 |             "A comma is missing for `$signature`.",
29 |             1606483614
30 |         );
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/InvalidArrayKey.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class InvalidArrayKey extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(Type $keyType)
15 |     {
16 |         parent::__construct(
17 |             "Invalid array key type `{$keyType->toString()}`, it must be a valid string or integer.",
18 |             1604335007
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/InvalidIterableKey.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class InvalidIterableKey extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(Type $keyType, Type $subType)
15 |     {
16 |         parent::__construct(
17 |             "Invalid key type `{$keyType->toString()}` for `iterable<{$keyType->toString()}, {$subType->toString()}>`. " .
18 |             "It must be one of `array-key`, `int` or `string`.",
19 |             1618994708
20 |         );
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/IterableClosingBracketMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class IterableClosingBracketMissing extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(Type $keyType, Type $subtype)
15 |     {
16 |         parent::__construct(
17 |             "The closing bracket is missing for `iterable<{$keyType->toString()}, {$subtype->toString()}>`.",
18 |             1618994728
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/IterableCommaMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class IterableCommaMissing extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(Type $type)
15 |     {
16 |         parent::__construct(
17 |             "A comma is missing for `iterable<{$type->toString()}, ?>`.",
18 |             1618994669
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/ListClosingBracketMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Types\ListType;
 9 | use CuyZ\Valinor\Type\Types\NonEmptyListType;
10 | use RuntimeException;
11 | 
12 | /** @internal */
13 | final class ListClosingBracketMissing extends RuntimeException implements InvalidType
14 | {
15 |     public function __construct(ListType|NonEmptyListType $listType)
16 |     {
17 |         parent::__construct(
18 |             "The closing bracket is missing for `{$listType->toString()}`.",
19 |             1634035071
20 |         );
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/ShapedArrayClosingBracketMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use CuyZ\Valinor\Type\Types\ShapedArrayElement;
10 | use RuntimeException;
11 | 
12 | use function implode;
13 | 
14 | /** @internal */
15 | final class ShapedArrayClosingBracketMissing extends RuntimeException implements InvalidType
16 | {
17 |     /**
18 |      * @param ShapedArrayElement[] $elements
19 |      */
20 |     public function __construct(array $elements, Type|null|false $unsealedType = null)
21 |     {
22 |         $signature = 'array{' . implode(', ', array_map(fn (ShapedArrayElement $element) => $element->toString(), $elements));
23 | 
24 |         if ($unsealedType === false) {
25 |             $signature .= ', ...';
26 |         } elseif ($unsealedType instanceof Type) {
27 |             $signature .= ', ...' . $unsealedType->toString();
28 |         }
29 | 
30 |         parent::__construct(
31 |             "Missing closing curly bracket in shaped array signature `$signature`.",
32 |             1631283658
33 |         );
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/ShapedArrayColonTokenMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use CuyZ\Valinor\Type\Types\ShapedArrayElement;
10 | use RuntimeException;
11 | 
12 | use function implode;
13 | 
14 | /** @internal */
15 | final class ShapedArrayColonTokenMissing extends RuntimeException implements InvalidType
16 | {
17 |     /**
18 |      * @param ShapedArrayElement[] $elements
19 |      */
20 |     public function __construct(array $elements, Type $type)
21 |     {
22 |         $signature = 'array{' . implode(', ', array_map(fn (ShapedArrayElement $element) => $element->toString(), $elements));
23 | 
24 |         if (! empty($elements)) {
25 |             $signature .= ', ';
26 |         }
27 | 
28 |         $signature .= "{$type->toString()}?";
29 | 
30 |         parent::__construct(
31 |             "A colon symbol is missing in shaped array signature `$signature`.",
32 |             1631283847
33 |         );
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/ShapedArrayCommaMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Types\ShapedArrayElement;
 9 | use RuntimeException;
10 | 
11 | use function implode;
12 | 
13 | /** @internal */
14 | final class ShapedArrayCommaMissing extends RuntimeException implements InvalidType
15 | {
16 |     /**
17 |      * @param ShapedArrayElement[] $elements
18 |      */
19 |     public function __construct(array $elements)
20 |     {
21 |         $signature = 'array{' . implode(', ', array_map(fn (ShapedArrayElement $element) => $element->toString(), $elements));
22 | 
23 |         parent::__construct(
24 |             "Comma missing in shaped array signature `$signature`.",
25 |             1631286589
26 |         );
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/ShapedArrayElementDuplicatedKey.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class ShapedArrayElementDuplicatedKey extends RuntimeException implements InvalidType
12 | {
13 |     public function __construct(string $key, string $signature)
14 |     {
15 |         parent::__construct(
16 |             "Key `$key` cannot be used several times in shaped array signature `$signature`.",
17 |             1631283279
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/ShapedArrayElementTypeMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Types\IntegerValueType;
 9 | use CuyZ\Valinor\Type\Types\ShapedArrayElement;
10 | use CuyZ\Valinor\Type\Types\StringValueType;
11 | use RuntimeException;
12 | 
13 | use function implode;
14 | 
15 | /** @internal */
16 | final class ShapedArrayElementTypeMissing extends RuntimeException implements InvalidType
17 | {
18 |     /**
19 |      * @param ShapedArrayElement[] $elements
20 |      */
21 |     public function __construct(array $elements, StringValueType|IntegerValueType $key, bool $optional)
22 |     {
23 |         $signature = 'array{' . implode(', ', array_map(fn (ShapedArrayElement $element) => $element->toString(), $elements));
24 | 
25 |         if (! empty($elements)) {
26 |             $signature .= ', ';
27 |         }
28 | 
29 |         $signature .= $key->value();
30 | 
31 |         if ($optional) {
32 |             $signature .= '?';
33 |         }
34 | 
35 |         $signature .= ':';
36 | 
37 |         parent::__construct(
38 |             "Missing element type in shaped array signature `$signature`.",
39 |             1631286250
40 |         );
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/ShapedArrayEmptyElements.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class ShapedArrayEmptyElements extends RuntimeException implements InvalidType
12 | {
13 |     public function __construct()
14 |     {
15 |         parent::__construct(
16 |             "Shaped array must define one or more elements, for instance `array{foo: string}`.",
17 |             1631286932
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/ShapedArrayInvalidUnsealedType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use CuyZ\Valinor\Type\Types\ShapedArrayElement;
10 | use RuntimeException;
11 | 
12 | use function implode;
13 | 
14 | /** @internal */
15 | final class ShapedArrayInvalidUnsealedType extends RuntimeException implements InvalidType
16 | {
17 |     /**
18 |      * @param ShapedArrayElement[] $elements
19 |      */
20 |     public function __construct(array $elements, Type $unsealedType)
21 |     {
22 |         $signature = 'array{';
23 |         $signature .= implode(', ', array_map(fn (ShapedArrayElement $element) => $element->toString(), $elements));
24 |         $signature .= ', ...' . $unsealedType->toString();
25 |         $signature .= '}';
26 | 
27 |         parent::__construct(
28 |             "Invalid unsealed type `{$unsealedType->toString()}` in shaped array signature `$signature`, it should be a valid array.",
29 |             1711618899,
30 |         );
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/ShapedArrayUnexpectedTokenAfterSealedType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Parser\Lexer\Token\Token;
 9 | use CuyZ\Valinor\Type\Type;
10 | use CuyZ\Valinor\Type\Types\ShapedArrayElement;
11 | use RuntimeException;
12 | 
13 | use function implode;
14 | 
15 | /** @internal */
16 | final class ShapedArrayUnexpectedTokenAfterSealedType extends RuntimeException implements InvalidType
17 | {
18 |     /**
19 |      * @param array<ShapedArrayElement> $elements
20 |      * @param list<Token> $unexpectedTokens
21 |      */
22 |     public function __construct(array $elements, Type $unsealedType, array $unexpectedTokens)
23 |     {
24 |         $unexpected = implode('', array_map(fn (Token $token) => $token->symbol(), $unexpectedTokens));
25 | 
26 |         $signature = 'array{';
27 |         $signature .= implode(', ', array_map(fn (ShapedArrayElement $element) => $element->toString(), $elements));
28 |         $signature .= ', ...' . $unsealedType->toString();
29 |         $signature .= $unexpected;
30 | 
31 |         parent::__construct(
32 |             "Unexpected `$unexpected` after sealed type in shaped array signature `$signature`, expected a `}`.",
33 |             1711618958,
34 |         );
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/ShapedArrayWithoutElementsWithSealedType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class ShapedArrayWithoutElementsWithSealedType extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(Type $unsealedType)
15 |     {
16 |         $signature = "array{...{$unsealedType->toString()}}";
17 | 
18 |         parent::__construct(
19 |             "Missing elements in shaped array signature `$signature`.",
20 |             1711629845,
21 |         );
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Iterable/SimpleArrayClosingBracketMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Iterable;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class SimpleArrayClosingBracketMissing extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(Type $subType)
15 |     {
16 |         parent::__construct(
17 |             "The closing bracket is missing for the array expression `{$subType->toString()}[]`.",
18 |             1606474266
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Magic/ValueOfClosingBracketMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Magic;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class ValueOfClosingBracketMissing extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(Type $type)
15 |     {
16 |         parent::__construct(
17 |             "The closing bracket is missing for `value-of<{$type->toString()}>`.",
18 |             1717702289
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Magic/ValueOfIncorrectSubType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Magic;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class ValueOfIncorrectSubType extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(Type $type)
15 |     {
16 |         parent::__construct(
17 |             "Invalid subtype `value-of<{$type->toString()}>`, it should be a `BackedEnum`.",
18 |             1717702683
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Magic/ValueOfOpeningBracketMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Magic;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class ValueOfOpeningBracketMissing extends RuntimeException implements InvalidType
12 | {
13 |     public function __construct()
14 |     {
15 |         parent::__construct(
16 |             "The opening bracket is missing for `value-of<...>`.",
17 |             1717702268
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/MissingClosingQuoteChar.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class MissingClosingQuoteChar extends RuntimeException implements InvalidType
11 | {
12 |     public function __construct(string $value)
13 |     {
14 |         parent::__construct(
15 |             "Closing quote is missing for `$value`.",
16 |             1666024605
17 |         );
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/RightIntersectionTypeMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class RightIntersectionTypeMissing extends RuntimeException implements InvalidType
12 | {
13 |     public function __construct(Type $type)
14 |     {
15 |         parent::__construct(
16 |             "Right type is missing for intersection `{$type->toString()}&?`.",
17 |             1631612575
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/RightUnionTypeMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class RightUnionTypeMissing extends RuntimeException implements InvalidType
12 | {
13 |     public function __construct(Type $type)
14 |     {
15 |         parent::__construct(
16 |             "Right type is missing for union `{$type->toString()}|?`.",
17 |             1631294715
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Scalar/ClassStringClosingBracketMissing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Scalar;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class ClassStringClosingBracketMissing extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(Type $type)
15 |     {
16 |         parent::__construct(
17 |             "The closing bracket is missing for the class string expression `class-string<{$type->toString()}>`.",
18 |             1606484169
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Scalar/IntegerRangeInvalidMaxValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Scalar;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use CuyZ\Valinor\Type\Types\IntegerValueType;
10 | use RuntimeException;
11 | 
12 | /** @internal */
13 | final class IntegerRangeInvalidMaxValue extends RuntimeException implements InvalidType
14 | {
15 |     public function __construct(IntegerValueType $min, Type $type)
16 |     {
17 |         parent::__construct(
18 |             "Invalid type `{$type->toString()}` for max value of integer range `int<{$min->value()}, ?>`, it must be either `max` or an integer value.",
19 |             1638788172
20 |         );
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Scalar/IntegerRangeInvalidMinValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Scalar;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class IntegerRangeInvalidMinValue extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(Type $type)
15 |     {
16 |         parent::__construct(
17 |             "Invalid type `{$type->toString()}` for min value of integer range, it must be either `min` or an integer value.",
18 |             1638787807
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Scalar/IntegerRangeMissingClosingBracket.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Scalar;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Types\IntegerValueType;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class IntegerRangeMissingClosingBracket extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(IntegerValueType $min, IntegerValueType $max)
15 |     {
16 |         parent::__construct(
17 |             "Missing closing bracket in integer range signature `int<{$min->value()}, {$max->value()}>`.",
18 |             1638788306
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Scalar/IntegerRangeMissingComma.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Scalar;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Types\IntegerValueType;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class IntegerRangeMissingComma extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(IntegerValueType $min)
15 |     {
16 |         parent::__construct(
17 |             "Missing comma in integer range signature `int<{$min->value()}, ?>`.",
18 |             1638787915
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Scalar/IntegerRangeMissingMaxValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Scalar;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Types\IntegerValueType;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class IntegerRangeMissingMaxValue extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(IntegerValueType $min)
15 |     {
16 |         parent::__construct(
17 |             "Missing max value for integer range, its signature must match `int<{$min->value()}, max>`.",
18 |             1638788092
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Scalar/IntegerRangeMissingMinValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Scalar;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class IntegerRangeMissingMinValue extends RuntimeException implements InvalidType
12 | {
13 |     public function __construct()
14 |     {
15 |         parent::__construct(
16 |             'Missing min value for integer range, its signature must match `int<min, max>`.',
17 |             1638787061
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Scalar/InvalidClassStringSubType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Scalar;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use RuntimeException;
10 | 
11 | /** @internal */
12 | final class InvalidClassStringSubType extends RuntimeException implements InvalidType
13 | {
14 |     public function __construct(Type $type)
15 |     {
16 |         parent::__construct(
17 |             "Invalid class string type `{$type->toString()}`, it must be a class name or an interface name.",
18 |             1608034138
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Scalar/ReversedValuesForIntegerRange.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Scalar;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class ReversedValuesForIntegerRange extends RuntimeException implements InvalidType
12 | {
13 |     public function __construct(int $min, int $max)
14 |     {
15 |         parent::__construct(
16 |             "The min value must be less than the max for integer range `int<$min, $max>`.",
17 |             1638787061
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Scalar/SameValueForIntegerRange.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Scalar;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use RuntimeException;
 9 | 
10 | /** @internal */
11 | final class SameValueForIntegerRange extends RuntimeException implements InvalidType
12 | {
13 |     public function __construct(int $value)
14 |     {
15 |         parent::__construct(
16 |             "The min and max values for integer range must be different, `$value` was given.",
17 |             1638786927
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Template/DuplicatedTemplateName.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Template;
 6 | 
 7 | use LogicException;
 8 | 
 9 | /** @internal */
10 | final class DuplicatedTemplateName extends LogicException
11 | {
12 |     /**
13 |      * @param class-string $className
14 |      */
15 |     public function __construct(string $className, string $template)
16 |     {
17 |         parent::__construct(
18 |             "The template `$template` in class `$className` was defined at least twice.",
19 |             1604612898
20 |         );
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/Template/InvalidClassTemplate.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception\Template;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use LogicException;
 9 | 
10 | /** @internal */
11 | final class InvalidClassTemplate extends LogicException implements InvalidType
12 | {
13 |     /**
14 |      * @param class-string $className
15 |      */
16 |     public function __construct(string $className, string $template, InvalidType $exception)
17 |     {
18 |         parent::__construct(
19 |             "Invalid template `$template` for class `$className`: {$exception->getMessage()}",
20 |             1630092678,
21 |             $exception
22 |         );
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Exception/UnknownSymbol.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Exception;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class UnknownSymbol extends RuntimeException implements InvalidType
11 | {
12 |     public function __construct(string $symbol)
13 |     {
14 |         parent::__construct("Cannot parse unknown symbol `$symbol`.");
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Factory/Specifications/ClassContextSpecification.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Factory\Specifications;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\Token\ObjectToken;
 8 | use CuyZ\Valinor\Type\Parser\Lexer\Token\TraversingToken;
 9 | 
10 | /** @internal */
11 | final class ClassContextSpecification implements TypeParserSpecification
12 | {
13 |     public function __construct(
14 |         /** @var class-string */
15 |         private string $className,
16 |     ) {}
17 | 
18 |     public function manipulateToken(TraversingToken $token): TraversingToken
19 |     {
20 |         if ($token->symbol() === 'self' || $token->symbol() === 'static') {
21 |             return new ObjectToken($this->className);
22 |         }
23 | 
24 |         return $token;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Factory/Specifications/TypeAliasAssignerSpecification.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Factory\Specifications;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\Token\TraversingToken;
 8 | use CuyZ\Valinor\Type\Parser\Lexer\Token\TypeToken;
 9 | use CuyZ\Valinor\Type\Type;
10 | 
11 | /** @internal */
12 | final class TypeAliasAssignerSpecification implements TypeParserSpecification
13 | {
14 |     public function __construct(
15 |         /** @var non-empty-array<string, Type> */
16 |         private array $aliases,
17 |     ) {}
18 | 
19 |     public function manipulateToken(TraversingToken $token): TraversingToken
20 |     {
21 |         $symbol = $token->symbol();
22 | 
23 |         if (isset($this->aliases[$symbol])) {
24 |             return TypeToken::withSymbol($this->aliases[$symbol], $symbol);
25 |         }
26 | 
27 |         return $token;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Factory/Specifications/TypeParserSpecification.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Factory\Specifications;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\Token\TraversingToken;
 8 | 
 9 | /** @internal */
10 | interface TypeParserSpecification
11 | {
12 |     public function manipulateToken(TraversingToken $token): TraversingToken;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Factory/TypeParserFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Factory;
 6 | 
 7 | use CuyZ\Valinor\Type\ObjectType;
 8 | use CuyZ\Valinor\Type\Parser\TypeParser;
 9 | use CuyZ\Valinor\Type\Type;
10 | use ReflectionFunction;
11 | 
12 | /** @internal */
13 | interface TypeParserFactory
14 | {
15 |     public function buildDefaultTypeParser(): TypeParser;
16 | 
17 |     /**
18 |      * @param class-string $className
19 |      */
20 |     public function buildNativeTypeParserForClass(string $className): TypeParser;
21 | 
22 |     /**
23 |      * @param array<string, Type> $aliases
24 |      */
25 |     public function buildAdvancedTypeParserForClass(ObjectType $type, array $aliases = []): TypeParser;
26 | 
27 |     public function buildNativeTypeParserForFunction(ReflectionFunction $reflection): TypeParser;
28 | 
29 |     public function buildAdvancedTypeParserForFunction(ReflectionFunction $reflection): TypeParser;
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/SpecificationsLexer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Factory\Specifications\TypeParserSpecification;
 8 | use CuyZ\Valinor\Type\Parser\Lexer\Token\Token;
 9 | use CuyZ\Valinor\Type\Parser\Lexer\Token\VacantToken;
10 | 
11 | /** @internal */
12 | final class SpecificationsLexer implements TypeLexer
13 | {
14 |     public function __construct(
15 |         /** @var array<TypeParserSpecification> */
16 |         private array $specifications,
17 |     ) {}
18 | 
19 |     public function tokenize(string $symbol): Token
20 |     {
21 |         return (new VacantToken($symbol, $this->specifications));
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/CallableToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\TokenStream;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use CuyZ\Valinor\Type\Types\CallableType;
10 | use CuyZ\Valinor\Utility\IsSingleton;
11 | 
12 | /** @internal */
13 | final class CallableToken implements TraversingToken
14 | {
15 |     use IsSingleton;
16 | 
17 |     public function traverse(TokenStream $stream): Type
18 |     {
19 |         return CallableType::get();
20 |     }
21 | 
22 |     public function symbol(): string
23 |     {
24 |         return 'callable';
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/ClosingBracketToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Utility\IsSingleton;
 8 | 
 9 | /** @internal */
10 | final class ClosingBracketToken implements Token
11 | {
12 |     use IsSingleton;
13 | 
14 |     public function symbol(): string
15 |     {
16 |         return '>';
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/ClosingCurlyBracketToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Utility\IsSingleton;
 8 | 
 9 | /** @internal */
10 | final class ClosingCurlyBracketToken implements Token
11 | {
12 |     use IsSingleton;
13 | 
14 |     public function symbol(): string
15 |     {
16 |         return '}';
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/ClosingSquareBracketToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Utility\IsSingleton;
 8 | 
 9 | /** @internal */
10 | final class ClosingSquareBracketToken implements Token
11 | {
12 |     use IsSingleton;
13 | 
14 |     public function symbol(): string
15 |     {
16 |         return ']';
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/ColonToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Utility\IsSingleton;
 8 | 
 9 | /** @internal */
10 | final class ColonToken implements Token
11 | {
12 |     use IsSingleton;
13 | 
14 |     public function symbol(): string
15 |     {
16 |         return ':';
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/CommaToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Utility\IsSingleton;
 8 | 
 9 | /** @internal */
10 | final class CommaToken implements Token
11 | {
12 |     use IsSingleton;
13 | 
14 |     public function symbol(): string
15 |     {
16 |         return ',';
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/DoubleColonToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Utility\IsSingleton;
 8 | 
 9 | /** @internal */
10 | final class DoubleColonToken implements Token
11 | {
12 |     use IsSingleton;
13 | 
14 |     public function symbol(): string
15 |     {
16 |         return '::';
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/FloatValueToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\TokenStream;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use CuyZ\Valinor\Type\Types\FloatValueType;
10 | 
11 | /** @internal */
12 | final class FloatValueToken implements TraversingToken
13 | {
14 |     public function __construct(private float $value) {}
15 | 
16 |     public function traverse(TokenStream $stream): Type
17 |     {
18 |         return new FloatValueType($this->value);
19 |     }
20 | 
21 |     public function symbol(): string
22 |     {
23 |         return (string)$this->value;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/IntegerValueToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\TokenStream;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use CuyZ\Valinor\Type\Types\IntegerValueType;
10 | 
11 | /** @internal */
12 | final class IntegerValueToken implements TraversingToken
13 | {
14 |     public function __construct(private int $value) {}
15 | 
16 |     public function traverse(TokenStream $stream): Type
17 |     {
18 |         return new IntegerValueType($this->value);
19 |     }
20 | 
21 |     public function symbol(): string
22 |     {
23 |         return (string)$this->value;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/LeftTraversingToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\TokenStream;
 8 | use CuyZ\Valinor\Type\Type;
 9 | 
10 | /** @internal */
11 | interface LeftTraversingToken extends Token
12 | {
13 |     public function traverse(Type $type, TokenStream $stream): Type;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/NullableToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\TokenStream;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use CuyZ\Valinor\Type\Types\NullType;
10 | use CuyZ\Valinor\Type\Types\UnionType;
11 | use CuyZ\Valinor\Utility\IsSingleton;
12 | 
13 | /** @internal */
14 | final class NullableToken implements TraversingToken
15 | {
16 |     use IsSingleton;
17 | 
18 |     public function traverse(TokenStream $stream): Type
19 |     {
20 |         return new UnionType(NullType::get(), $stream->read());
21 |     }
22 | 
23 |     public function symbol(): string
24 |     {
25 |         return '?';
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/ObjectToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\TokenStream;
 8 | use CuyZ\Valinor\Type\Type;
 9 | use CuyZ\Valinor\Utility\Reflection\Reflection;
10 | 
11 | /** @internal */
12 | final class ObjectToken implements TraversingToken
13 | {
14 |     public function __construct(
15 |         /** @var class-string */
16 |         private string $className,
17 |     ) {}
18 | 
19 |     public function traverse(TokenStream $stream): Type
20 |     {
21 |         return Reflection::enumExists($this->className)
22 |             ? (new EnumNameToken($this->className))->traverse($stream)
23 |             : (new ClassNameToken($this->className))->traverse($stream);
24 |     }
25 | 
26 |     public function symbol(): string
27 |     {
28 |         return $this->className;
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/OpeningBracketToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Utility\IsSingleton;
 8 | 
 9 | /** @internal */
10 | final class OpeningBracketToken implements Token
11 | {
12 |     use IsSingleton;
13 | 
14 |     public function symbol(): string
15 |     {
16 |         return '<';
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/OpeningCurlyBracketToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Utility\IsSingleton;
 8 | 
 9 | /** @internal */
10 | final class OpeningCurlyBracketToken implements Token
11 | {
12 |     use IsSingleton;
13 | 
14 |     public function symbol(): string
15 |     {
16 |         return '{';
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/OpeningSquareBracketToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\Iterable\SimpleArrayClosingBracketMissing;
 8 | use CuyZ\Valinor\Type\Parser\Lexer\TokenStream;
 9 | use CuyZ\Valinor\Type\Type;
10 | use CuyZ\Valinor\Type\Types\ArrayType;
11 | use CuyZ\Valinor\Utility\IsSingleton;
12 | 
13 | /** @internal */
14 | final class OpeningSquareBracketToken implements LeftTraversingToken
15 | {
16 |     use IsSingleton;
17 | 
18 |     public function traverse(Type $type, TokenStream $stream): Type
19 |     {
20 |         if ($stream->done() || ! $stream->forward() instanceof ClosingSquareBracketToken) {
21 |             throw new SimpleArrayClosingBracketMissing($type);
22 |         }
23 | 
24 |         return ArrayType::simple($type);
25 |     }
26 | 
27 |     public function symbol(): string
28 |     {
29 |         return '[';
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/StringValueToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\MissingClosingQuoteChar;
 8 | use CuyZ\Valinor\Type\Parser\Lexer\TokenStream;
 9 | use CuyZ\Valinor\Type\Type;
10 | use CuyZ\Valinor\Type\Types\StringValueType;
11 | 
12 | /** @internal */
13 | final class StringValueToken implements TraversingToken
14 | {
15 |     public function __construct(private string $value) {}
16 | 
17 |     public function traverse(TokenStream $stream): Type
18 |     {
19 |         $quoteType = $this->value[0];
20 | 
21 |         if ($this->value[-1] !== $quoteType) {
22 |             throw new MissingClosingQuoteChar($this->value);
23 |         }
24 | 
25 |         return StringValueType::from($this->value);
26 |     }
27 | 
28 |     public function symbol(): string
29 |     {
30 |         return $this->value;
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/Token.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | /** @internal */
 8 | interface Token
 9 | {
10 |     public function symbol(): string;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/TraversingToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\TokenStream;
 8 | use CuyZ\Valinor\Type\Type;
 9 | 
10 | /** @internal */
11 | interface TraversingToken extends Token
12 | {
13 |     public function traverse(TokenStream $stream): Type;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/TripleDotsToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Utility\IsSingleton;
 8 | 
 9 | /** @internal */
10 | final class TripleDotsToken implements Token
11 | {
12 |     use IsSingleton;
13 | 
14 |     public function symbol(): string
15 |     {
16 |         return '...';
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/TypeToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\TokenStream;
 8 | use CuyZ\Valinor\Type\Type;
 9 | 
10 | /** @internal */
11 | final class TypeToken implements TraversingToken
12 | {
13 |     private Type $type;
14 | 
15 |     private string $symbol;
16 | 
17 |     public function __construct(Type $type)
18 |     {
19 |         $this->type = $type;
20 |         $this->symbol = $type->toString();
21 |     }
22 | 
23 |     public static function withSymbol(Type $type, string $symbol): self
24 |     {
25 |         $self = new self($type);
26 |         $self->symbol = $symbol;
27 | 
28 |         return $self;
29 |     }
30 | 
31 |     public function traverse(TokenStream $stream): Type
32 |     {
33 |         return $this->type;
34 |     }
35 | 
36 |     public function symbol(): string
37 |     {
38 |         return $this->symbol;
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/Token/UnionToken.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer\Token;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\RightUnionTypeMissing;
 8 | use CuyZ\Valinor\Type\Parser\Lexer\TokenStream;
 9 | use CuyZ\Valinor\Type\Type;
10 | use CuyZ\Valinor\Type\Types\UnionType;
11 | use CuyZ\Valinor\Utility\IsSingleton;
12 | 
13 | /** @internal */
14 | final class UnionToken implements LeftTraversingToken
15 | {
16 |     use IsSingleton;
17 | 
18 |     public function traverse(Type $type, TokenStream $stream): Type
19 |     {
20 |         if ($stream->done()) {
21 |             throw new RightUnionTypeMissing($type);
22 |         }
23 | 
24 |         return new UnionType($type, $stream->read());
25 |     }
26 | 
27 |     public function symbol(): string
28 |     {
29 |         return '|';
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Type/Parser/Lexer/TypeLexer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser\Lexer;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Lexer\Token\Token;
 8 | 
 9 | /** @internal */
10 | interface TypeLexer
11 | {
12 |     public function tokenize(string $symbol): Token;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Type/Parser/LexingParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace CuyZ\Valinor\Type\Parser;
 4 | 
 5 | use CuyZ\Valinor\Type\Parser\Lexer\TokensExtractor;
 6 | use CuyZ\Valinor\Type\Parser\Lexer\TokenStream;
 7 | use CuyZ\Valinor\Type\Parser\Lexer\TypeLexer;
 8 | use CuyZ\Valinor\Type\Type;
 9 | 
10 | /** @internal */
11 | class LexingParser implements TypeParser
12 | {
13 |     public function __construct(private TypeLexer $lexer) {}
14 | 
15 |     public function parse(string $raw): Type
16 |     {
17 |         $tokens = array_map(
18 |             fn (string $symbol) => $this->lexer->tokenize($symbol),
19 |             (new TokensExtractor($raw))->filtered()
20 |         );
21 | 
22 |         return (new TokenStream(...$tokens))->read();
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Type/Parser/TypeParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Parser;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Type;
 9 | 
10 | /** @internal */
11 | interface TypeParser
12 | {
13 |     /**
14 |      * @throws InvalidType
15 |      */
16 |     public function parse(string $raw): Type;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Type/ScalarType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type;
 6 | 
 7 | use CuyZ\Valinor\Mapper\Tree\Message\ErrorMessage;
 8 | 
 9 | /** @internal */
10 | interface ScalarType extends Type
11 | {
12 |     public function canCast(mixed $value): bool;
13 | 
14 |     public function cast(mixed $value): bool|string|int|float;
15 | 
16 |     public function errorMessage(): ErrorMessage;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Type/StringType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type;
 6 | 
 7 | /** @internal */
 8 | interface StringType extends ScalarType
 9 | {
10 |     public function cast(mixed $value): string;
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Type/Type.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
 8 | 
 9 | /** @internal */
10 | interface Type
11 | {
12 |     public function accepts(mixed $value): bool;
13 | 
14 |     public function compiledAccept(ComplianceNode $node): ComplianceNode;
15 | 
16 |     public function matches(self $other): bool;
17 | 
18 |     public function nativeType(): Type;
19 | 
20 |     public function toString(): string;
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Types/CallableType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Types;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | use CuyZ\Valinor\Type\Type;
10 | use CuyZ\Valinor\Utility\IsSingleton;
11 | 
12 | use function is_callable;
13 | 
14 | /** @internal */
15 | final class CallableType implements Type
16 | {
17 |     use IsSingleton;
18 | 
19 |     public function accepts(mixed $value): bool
20 |     {
21 |         return is_callable($value);
22 |     }
23 | 
24 |     public function compiledAccept(ComplianceNode $node): ComplianceNode
25 |     {
26 |         return Node::functionCall('is_callable', [$node]);
27 |     }
28 | 
29 |     public function matches(Type $other): bool
30 |     {
31 |         if ($other instanceof UnionType) {
32 |             return $other->isMatchedBy($this);
33 |         }
34 | 
35 |         return $other instanceof self
36 |             || $other instanceof MixedType;
37 |     }
38 | 
39 |     public function nativeType(): Type
40 |     {
41 |         return $this;
42 |     }
43 | 
44 |     public function toString(): string
45 |     {
46 |         return 'callable';
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Type/Types/Exception/ForbiddenMixedType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Types\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use LogicException;
 9 | 
10 | /** @internal */
11 | final class ForbiddenMixedType extends LogicException implements InvalidType
12 | {
13 |     public function __construct()
14 |     {
15 |         parent::__construct(
16 |             "Type `mixed` can only be used as a standalone type and not as a union member.",
17 |             1608146262
18 |         );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Type/Types/Exception/InvalidUnionOfClassString.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Types\Exception;
 6 | 
 7 | use CuyZ\Valinor\Type\Parser\Exception\InvalidType;
 8 | use CuyZ\Valinor\Type\Types\UnionType;
 9 | use LogicException;
10 | 
11 | /** @internal */
12 | final class InvalidUnionOfClassString extends LogicException implements InvalidType
13 | {
14 |     public function __construct(UnionType $type)
15 |     {
16 |         parent::__construct(
17 |             "Type `{$type->toString()}` contains invalid class string element(s).",
18 |             1648830951
19 |         );
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Type/Types/Factory/CannotBuildTypeFromValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Types\Factory;
 6 | 
 7 | use LogicException;
 8 | 
 9 | use function gettype;
10 | 
11 | /** @internal */
12 | final class CannotBuildTypeFromValue extends LogicException
13 | {
14 |     public function __construct(mixed $value)
15 |     {
16 |         $type = gettype($value);
17 | 
18 |         parent::__construct(
19 |             "Cannot build type from value of type `$type`.",
20 |             1653592997
21 |         );
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Type/Types/MixedType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Types;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | use CuyZ\Valinor\Type\Type;
10 | use CuyZ\Valinor\Utility\IsSingleton;
11 | 
12 | /** @internal */
13 | final class MixedType implements Type
14 | {
15 |     use IsSingleton;
16 | 
17 |     public function accepts(mixed $value): bool
18 |     {
19 |         return true;
20 |     }
21 | 
22 |     public function compiledAccept(ComplianceNode $node): ComplianceNode
23 |     {
24 |         return Node::value(true);
25 |     }
26 | 
27 |     public function matches(Type $other): bool
28 |     {
29 |         return $other instanceof self;
30 |     }
31 | 
32 |     public function nativeType(): Type
33 |     {
34 |         return $this;
35 |     }
36 | 
37 |     public function toString(): string
38 |     {
39 |         return 'mixed';
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Type/Types/NullType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Types;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | use CuyZ\Valinor\Type\Type;
10 | use CuyZ\Valinor\Utility\IsSingleton;
11 | 
12 | /** @internal */
13 | final class NullType implements Type
14 | {
15 |     use IsSingleton;
16 | 
17 |     public function accepts(mixed $value): bool
18 |     {
19 |         return $value === null;
20 |     }
21 | 
22 |     public function compiledAccept(ComplianceNode $node): ComplianceNode
23 |     {
24 |         return $node->equals(Node::value(null));
25 |     }
26 | 
27 |     public function matches(Type $other): bool
28 |     {
29 |         if ($other instanceof UnionType) {
30 |             return $other->isMatchedBy($this);
31 |         }
32 | 
33 |         return $other instanceof self
34 |             || $other instanceof MixedType;
35 |     }
36 | 
37 |     public function nativeType(): Type
38 |     {
39 |         return $this;
40 |     }
41 | 
42 |     public function toString(): string
43 |     {
44 |         return 'null';
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Type/Types/ShapedArrayElement.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Types;
 6 | 
 7 | use CuyZ\Valinor\Type\Type;
 8 | 
 9 | /** @internal */
10 | final class ShapedArrayElement
11 | {
12 |     public function __construct(
13 |         private StringValueType|IntegerValueType $key,
14 |         private Type $type,
15 |         private bool $optional = false
16 |     ) {}
17 | 
18 |     public function key(): StringValueType|IntegerValueType
19 |     {
20 |         return $this->key;
21 |     }
22 | 
23 |     public function type(): Type
24 |     {
25 |         return $this->type;
26 |     }
27 | 
28 |     public function isOptional(): bool
29 |     {
30 |         return $this->optional;
31 |     }
32 | 
33 |     public function toString(): string
34 |     {
35 |         return $this->isOptional()
36 |             ? "{$this->key->toString()}?: {$this->type->toString()}"
37 |             : "{$this->key->toString()}: {$this->type->toString()}";
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Type/Types/UndefinedObjectType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Type\Types;
 6 | 
 7 | use CuyZ\Valinor\Compiler\Native\ComplianceNode;
 8 | use CuyZ\Valinor\Compiler\Node;
 9 | use CuyZ\Valinor\Type\ObjectType;
10 | use CuyZ\Valinor\Type\Type;
11 | use CuyZ\Valinor\Utility\IsSingleton;
12 | 
13 | use function is_object;
14 | 
15 | /** @internal */
16 | final class UndefinedObjectType implements Type
17 | {
18 |     use IsSingleton;
19 | 
20 |     public function accepts(mixed $value): bool
21 |     {
22 |         return is_object($value);
23 |     }
24 | 
25 |     public function compiledAccept(ComplianceNode $node): ComplianceNode
26 |     {
27 |         return Node::functionCall('is_object', [$node]);
28 |     }
29 | 
30 |     public function matches(Type $other): bool
31 |     {
32 |         if ($other instanceof UnionType) {
33 |             return $other->isMatchedBy($this);
34 |         }
35 | 
36 |         return $other instanceof self
37 |             || $other instanceof ObjectType
38 |             || $other instanceof IntersectionType
39 |             || $other instanceof MixedType;
40 |     }
41 | 
42 |     public function nativeType(): UndefinedObjectType
43 |     {
44 |         return $this;
45 |     }
46 | 
47 |     public function toString(): string
48 |     {
49 |         return 'object';
50 |     }
51 | }
52 | 


--------------------------------------------------------------------------------
/src/Utility/IsSingleton.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Utility;
 6 | 
 7 | /** @internal */
 8 | trait IsSingleton
 9 | {
10 |     private static self $instance;
11 | 
12 |     public static function get(): static
13 |     {
14 |         return self::$instance ??= new static();
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Utility/Package.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Utility;
 6 | 
 7 | use Composer\InstalledVersions;
 8 | 
 9 | /** @internal */
10 | final class Package
11 | {
12 |     private static string $version;
13 | 
14 |     public static function version(): string
15 |     {
16 |         /** @infection-ignore-all */
17 |         return self::$version ??= InstalledVersions::getVersion('cuyz/valinor') ?? 'unknown';
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Utility/Polyfill.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Utility;
 6 | 
 7 | /** @internal */
 8 | final class Polyfill
 9 | {
10 |     /**
11 |      * PHP8.4 use native function `array_all` instead.
12 |      *
13 |      * @param array<mixed> $array
14 |      */
15 |     public static function array_all(array $array, callable $callback): bool
16 |     {
17 |         foreach ($array as $key => $value) {
18 |             if (! $callback($value, $key)) {
19 |                 return false;
20 |             }
21 |         }
22 | 
23 |         return true;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Utility/Priority/HasPriority.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Utility\Priority;
 6 | 
 7 | /**
 8 |  * This interface can be implemented by objects which may be sorted
 9 |  * using @see \CuyZ\Valinor\Utility\Priority\PrioritizedList
10 |  *
11 |  * The higher the priority is for a given object, the more chance it has to
12 |  * be used first.
13 |  *
14 |  * @api
15 |  */
16 | interface HasPriority
17 | {
18 |     public function priority(): int;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Utility/Priority/PrioritizedList.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Utility\Priority;
 6 | 
 7 | use IteratorAggregate;
 8 | use Traversable;
 9 | 
10 | /**
11 |  * @api
12 |  *
13 |  * @template T of object
14 |  * @implements IteratorAggregate<T>
15 |  */
16 | final class PrioritizedList implements IteratorAggregate
17 | {
18 |     /** @var array<int, T[]> */
19 |     private array $objects = [];
20 | 
21 |     /**
22 |      * @param T ...$objects
23 |      */
24 |     public function __construct(object ...$objects)
25 |     {
26 |         foreach ($objects as $object) {
27 |             $this->objects[$this->priority($object)][] = $object;
28 |         }
29 | 
30 |         krsort($this->objects, SORT_NUMERIC);
31 |     }
32 | 
33 |     /**
34 |      * @return Traversable<T>
35 |      */
36 |     public function getIterator(): Traversable
37 |     {
38 |         foreach ($this->objects as $priority => $objects) {
39 |             foreach ($objects as $object) {
40 |                 yield $priority => $object;
41 |             }
42 |         }
43 |     }
44 | 
45 |     private function priority(object $object): int
46 |     {
47 |         return $object instanceof HasPriority
48 |             ? $object->priority()
49 |             : 0;
50 |     }
51 | }
52 | 


--------------------------------------------------------------------------------
/src/Utility/Reflection/NamespaceFinder.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Utility\Reflection;
 6 | 
 7 | use PhpToken;
 8 | 
 9 | /** @internal */
10 | final class NamespaceFinder
11 | {
12 |     public function findNamespace(string $content): ?string
13 |     {
14 |         $tokens = PhpToken::tokenize($content);
15 |         $tokensCount = count($tokens);
16 |         /* @infection-ignore-all Unneeded because of the nature of namespace-related token */
17 |         $pointer = $tokensCount - 1;
18 | 
19 |         while (! $tokens[$pointer]->is(T_NAMESPACE)) {
20 |             /* @infection-ignore-all Unneeded because of the nature of namespace-related token */
21 |             if ($pointer === 0) {
22 |                 return null;
23 |             }
24 | 
25 |             $pointer--;
26 |         }
27 | 
28 |         while (! $tokens[$pointer]->is([T_NAME_QUALIFIED, T_STRING])) {
29 |             $pointer++;
30 |         }
31 | 
32 |         return (string)$tokens[$pointer];
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Utility/String/StringFormatterError.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace CuyZ\Valinor\Utility\String;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | /** @internal */
10 | final class StringFormatterError extends RuntimeException
11 | {
12 |     public function __construct(string $body, string $message = '', ?\Throwable $previous = null)
13 |     {
14 |         if ($message !== '') {
15 |             $message = ": $message";
16 |         }
17 |         parent::__construct("Message formatter error using `$body`$message.", 1652901203, $previous);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------