• Added asymmetric read/write support for reflection driver:

class Example
{
 // The mapper inferences:
 // - Type "string" for reading (normalization)
 // - Type "string|\Stringable" for writing (denormalization)
 public string $name {
 get => $this->name;
 set(string|\Stringable $name) => (string) $name;
 }
}

• Added asymmetric read/write support for attribute driver:

class Example
{
 #[MapType('T')] // Inferences T for read + write
 public string $name {
 #[MapType('U')] // Inferences T for reading (normalization)
 get => $this->name;
 #[MapType('V')] // Inferences V for writing (denormalization)
 set(string|\Stringable $name) => (string) $name;
 }
}

• Added support for custom error messages:

class Example
{
 #[OnTypeError(message: 'Name must be a string')]
 #[OnUndefinedError(message: 'Name is required')]
 public string $name;
}
// If specified via configs:
// 'properties' => [
// 'name' => [
// 'type_error_message' => 'Name must be a string',
// 'undefined_error_message' => 'Name is required',
// ],
// ...

• In case of empty object received, an error is now thrown indicating that it is an object {}, not an array [] as before.
• And more...

Full Changelog: 0.4.1...0.5.0

• Fix class inheritance
• Actualize and fix linter issues

Full Changelog: 0.4.0...0.4.1

• Added CallableTypeBuilder (see: #1)
• Added support of TypeLang v1.4
• Added stricter class type checks

New Contributors

• @root-aza made their first contribution in #1

Full Changelog: 0.3.0...0.4.0

Contributors

• @root-aza

• Added objects subtype normalization.
• Added Mapper::getType() and Mapper::getTypeByValue() public methods.
• Added array-like metadata drivers (with JSON Schema validation).
• A little more improvements

Full Changelog: 0.2.0...0.3.0

Features

• Added discriminator mapping (see #[DiscriminatorMap] attribute).
• Added property name mapping (see #[MapName] attribute).
• Added localobject "normalize as array" option (see #[NormalizeAsArray] attribute).
• Added object normalization property skipping options:
  • See #[SkipWhen] for using skipping expressions.
  • See #[SkipWhenEmpty] for empty(T) skipping expression.
  • See #[SkipWhenNull] for T === null skipping expression.
• The #[MapProperty] attribute renamed to #[MapType].
• Added debug tracing and logging options.
  • Use Configuration::$logger option for logger.
  • Use Configuration::$tracer option for tracing.
• Added value casting: Values ​​for normalization are now trusted by default and attempt to convert to the specified type, instead of strictly checking.

  See https://github.com/php-type-language/mapper/tree/master/tests/Feature/Type files for more information on the casting rules.

  • Use Configuration::$strictTypes option to enable or disable casting mode.

Types

• Added boolean alias of bool type.
• Added integer alias of int type.
• Added double and real aliases of float type.
• Added iterable, Iterator, Generator, Traversable and IteratorAggregate aliases for array normalization.
• Added object and stdClass types.
• Added UnitEnumType support.
• Temporary removed non-standard non-empty-string, numeric-string, class-string, positive-int, non-negative-int, negative-int and non-positive-int. Please temporarily add aliases to the string and int for them.

Other

• All runtime (mapping) exceptions and their hierarchy have been rewritten.
• All kernel have been rewritten (there are too many changes to list it all).

Full Changelog: 0.1.0...0.2.0

Please note, this is a pre-release to freeze the stable version, prepare documentation and evaluate the functionality.

Please wait for the major version 1.0.0 if you want to use it in production.
There may be backward compatibility breaks between minor versions 0.x!