GraphQL improvements 🐝

Mark	Type	Count	Packages
	Features	2	graphql
	Bug Fixes	1	testing

Package graphql

Features

• New setting builder.allowed_directives to control which directives should be copied from the original field into generated (#132, c38d337)
• Support of extend scalar/etc X to add operators (c7bd1c4)

Package testing

Bug Fixes

• ScalarStrictComparator will respect $ignoreCase (b7919c9)

Serializer enums support and`@sortBy` fix ❄

Mark	Type	Count	Packages
	Features	2	serializer
	Bug Fixes	3	documentator, graphql
	Miscellaneous	1	documentator

Package documentator

Bug Fixes

• Added missed nikic/php-parser requirement + compatibility with v5 (4a76c86)
• requirements command will use local composer.json for HEAD (eaa095e)

Miscellaneous

• Removed phpdocumentor/reflection-docblock, the phpstan/phpdoc-parser will be used instead (67f1e62)

Package graphql

Bug Fixes

• @sortBy: Random order will be available only for Query and Eloquent builders (4fbf170)

Package serializer

Features

• BackedEnum support out the box (315737d)
• UnitEnum support (will be serialized/deserialized as/from the case name) (4f047cc)

Happy New Year 🎄

Mark	Type	Count	Packages
	Features	3	core, documentator, testing
	Bug Fixes	1	documentator
💀	Deprecations	2	queue, testing

Package core

Features

• Added WithSchedule trait to schedule tasks (simplified version of lara-asp-queue package) (4ee5687)

Package documentator

Features

• IncludeDocBlock (include:docblock) instruction (8aa9a66)

Bug Fixes

• lara-asp-documentator:preprocess help for instruction parameters (95e6b23)

Package queue

Deprecations 💀

• Package deprecated. Please use lastdragon-ru/lara-asp-core instead (c6a4d79)

Package testing

Features

• Added ScheduleAssertions::assertScheduled() to check that task is scheduled (40fb8f6)

Deprecations 💀

• CronableAssertions::assertCronableRegistered(), please use ScheduleAssertions::assertScheduled() instead (018e3c1)

No unicode in filenames 😞

Mark	Type	Count	Packages
	Bug Fixes	1	graphql

Package graphql

Bug Fixes

• Test file filename (unicode removed) (#107, e0ce983)

Formatter improvements 🥠

Mark	Type	Count	Packages
	Features	4	formatter, queue, testing
	Bug Fixes	2	formatter, queue
💀	Deprecations	5	core, graphql, migrator, testing
	Miscellaneous	2	serializer, testing

Package core

Deprecations 💀

• Dispatcher::getObservers() (d374202)
• LastDragon_ru\LaraASP\Core\Provider\Helper::callAfterBoot() (69b21c0)

Package formatter

Features

• More precise Formatter::filesize()/Formatter::disksize() (1047552 bytes will be converted to "1.00 MiB" instead of "1,023.00 KiB") (73dea41)
• New Formatter::disksize() to format bytes into units based on powers of 10 (kilobyte, megabyte, etc) (2ffb175)

Bug Fixes

• str_pad() => mb_str_pad() (c30c27b)

Package graphql

Deprecations 💀

• ClientException::getCategory() (efceb9d)

Package migrator

Deprecations 💀

• SmartMigrator::isAnonymousMigrationsSupported() (69e9ed3)

Package queue

Features

• failOnTimeout support (e7ab787)

Bug Fixes

• Removed deleteWhenMissingModels because it can be set only within the class itself (7507d15)

Package serializer

Miscellaneous

• Minimal version of symfony/property-info set to ^6.3.9 (b540c5a)

Package testing

Features

• LastDragon_ru\LaraASP\Testing\Concerns\Override($factory) can be also T|class-string<T> (54b1e74)

Deprecations 💀

• TestCase::getContainer(). Please use Container::getInstance() instead (8ac44f7)

Miscellaneous

• symfony/psr-http-message-bridge:^6.4.0 support (aea03f8)

More operators for `@searchBy` 🍪

Mark	Type	Count	Packages
	Features	1	graphql
	Bug Fixes	2	serializer

Package graphql

Features

• @searchby: notContains, notStartsWith, notEndsWith operators (#104, ca93702)

Package serializer

Bug Fixes

• AsSerializable setter type (it can differ from for getter) (b613ebd)
• SerializableNormalizer will place discriminator property at the beginning of the properties (470b9ed)

Serializer and Documentator improvements 🦀

Mark	Type	Count	Packages
	Features	7	documentator, serializer
	Bug Fixes	2	documentator, serializer
💀	Deprecations	2	core, documentator

Package core

Deprecations 💀

• InstanceCache (b21ca92)

Package documentator

Features

• Added depth parameter for IncludeDocumentList (include:document-list) instruction (41536fc)
• IncludeTemplate (include:template) instruction. IncludeFile (include:file) will not replace variables anymore (3165f2a)
• Parameterizable instructions (574cef2)
• Variables support for IncludeFile (include:file) instruction (e9c0df9)

Bug Fixes

• Normalization of Preprocessor hash calculation for parameters (117cc4e)

Deprecations 💀

• LastDragon_ru\LaraASP\Documentator\Preprocessor\Instruction (please use LastDragon_ru\LaraASP\Documentator\Preprocessor\Contracts\Instruction and its subclasses instead) (a5076ff)

Package serializer

Features

• AsSerializable eloquent cast (8b370e1)
• DiscriminatorMap support (for SerializableNormalizer) (cafa2eb)
• VersionMap attribute to add version for Serializable (5a22197)

Bug Fixes

• Serializer::serialize()/Serializer::deserialize() accept any object as it defined in docs (ecfb8d6)

The `@stream` directive and two new packages 🤠

Mark	Type	Count	Packages
☣	Breaking changes	16	eloquent, graphql, graphql-printer
	Features	11	*, documentator, graphql, graphql-printer, testing
	Performance Improvements	1	graphql
	Bug Fixes	10	documentator, eloquent, graphql, graphql-printer, testing
	Miscellaneous	1	*
	Code Refactoring	8	graphql

The new major release introduces the new @stream directive and two new packages: the Serializer and Documentator. Please also see 5.0.0-beta.0 and 5.0.0-beta.1 release notes.

All packages

Features

• PHP 8.3 Support (#103, 34296a9)

Miscellaneous

• Minimum version of Laravel Scout set to ^9.8.0 (9fb9df4)

Package documentator

Features

• requirements command will dump requirements for Metadata { version } equal to HEAD even if no git tag (993d002)

Bug Fixes

• Command processing for include:exec instruction (d47f127)
• HTML entities encoding for include:document-list and include:package-list (0d2bd41)
• missed artisan prefix for command usages (lara-asp-documentator:commands) (cfc9973)
• Missed EOF in Metadata.json (7b77228)

Package eloquent

Bug Fixes

• new ModelHelper(Model::class) will be identical to new ModelHelper(Model::query()) (makes no sense to create a query with invalid constraints for relations) (1e4e213) ☣

Package graphql

Features

• @stream directive (#101, 2382b6c)
• Added JsonString wrapper/helper (to return JSON without unnecessary validation) (6a6953d)
• JsonString scalar (06ad9be)
• TypeDefinition can be fully replaced via Container (TypeDefinition::getTypeName() became is non static) (0ee21c7) ☣
• @searchby: Scout support for NotIn operator (laravel/scout:>=10.3.0 required). (#98, f555270)

Performance Improvements

• AstManipulator::getTypeFullName() no unnecessary fetching for definitions (45f1cf6)

Bug Fixes

• AstManipulator::addTypeDefinition() will convert ScalarType into scalar and will add it into Document instead of TypeRegistry (3e23e8e)

Code Refactoring

• Added TypeSource::isUnion() (026f118) ☣
• Added TypeSource argument to BuilderInfoProvider::getBuilderInfo() (f29215a) ☣
• ArgumentNode support for AstManipulator::getName(); DirectiveNode support for AstManipulator::findArgument(), AstManipulator::getArgument() (cb29569) ☣
• BuilderInfoDetector internally will use TypeSource instead of Node (fb0b6f7) ☣
• BuilderInfoProvider::getBuilderInfo() can return only ?BuilderInfo (you can use BuilderInfo::create() to get a default instance for class) (630ff3b) ☣
• Directive::Name consts marked as final (757fd7d) ☣
• JsonString renamed to JsonStringType (8cf2761) ☣
• WithBuilderInfo trait converted into BuilderInfoDetector class (a819d8e) ☣

Package graphql-printer

Features

• New setting Settings::isAlwaysMultilineDirectives() (#82, 212b61c) ☣
• New setting Settings::isNormalizeDirectives() (default is false, because the order of directives may be important) (1db945b) ☣
• Settings::isNormalizeSchema() renamed to Settings::isNormalizeDefinitions() (cacf098) ☣

Bug Fixes

• Default value Settings::isNormalizeArguments() set to false because the order of arguments may be important (5198e6e)
• Exported type will be on the top of the document (#100, 5b9e5b2) ☣
• Object value will respect Settings::isAlwaysMultilineArguments() (4a8b916)

Package testing

Features

• New assertion WithQueryLog::assertQueryLogEquals() (3068f60)

Bug Fixes

• Scout v10.3.0 assertions fix (c03d563)

Scout v10.3.0 support

Mark	Type	Count	Packages
	Features	2	core, graphql
	Performance Improvements	1	formatter
	Bug Fixes	4	graphql, graphql-printer, migrator, testing

Package core

Features

• New helper ProviderWithViews (81eecca)

Package formatter

Performance Improvements

• Formatter registered as a singleton (via Container::scopedIf()) (65fe453)

Package graphql

Features

• @searchby: Scout support for NotIn operator (laravel/scout:>=10.3.0 required) (cd24d54)

Bug Fixes

• AstManipulator::addTypeDefinition() will convert ScalarType into scalar and will add it into Document instead of TypeRegistry (3647e1a)

Package graphql-printer

Bug Fixes

• Object value will respect Settings::isAlwaysMultilineArguments() (f09e251)

Package migrator

Bug Fixes

• Added missed AsCommand attribute (8a29642)

Package testing

Bug Fixes

• Scout v10.3.0 assertions fix (285dd15)

Documentation Preprocessor

Mark	Type	Count	Packages
☣	Breaking changes	3	core
	Features	9	core, documentator
	Performance Improvements	1	formatter
	Bug Fixes	8	documentator, migrator
	Miscellaneous	1	*
	Code Refactoring	3	core

All packages

Miscellaneous

• Minimum version of Laravel set to ^9.21.0 (6687343)

Package core

Features

• New helper ProviderWithViews (972ed3f)
• New package helper Viewer (9502ebe)

Code Refactoring

• Config, routes, translations and views moved into defaults directory (b4486e8) ☣
• LastDragon_ru\LaraASP\Core\Translator and LastDragon_ru\LaraASP\Core\Helpers\Translator (a5d98e4) ☣
• ProviderWith* traits moved into LastDragon_ru\LaraASP\Core\Provider\With* (39b2b22) ☣

Package documentator

Features

• Command lara-asp-documentator:commands to save commands help into Markdown files (6de62b4)
• Command lara-asp-documentator:preprocess to preprocess Markdown files (0fa1e6e)
• Command lara-asp-documentator:requirements to generate a table with the required versions of PHP/Laravel in Markdown format (2842250)
• IncludeExample::Limit increased to 50 lines (6a737fc)
• IncludeExample can include raw markdown output via <markdown>raw</markdown> tag (caaa368)
• New package (#96, cfbcd41)
• Required requirements for Requirements command can be specified in metadata.json (bdb767f)

Bug Fixes

• Empty Requirements output (e65dbad)
• IncludeExample will merge multiple LF while counting lines (e69abd8)
• PackageTranslator will use proper package name (bed2912)
• Requirements cache (9c183b0)
• Requirements command output will include header (92bdcd1)
• Requirements command will not include the required version if it is empty (4a62f86)
• Requirements command will work correctly inside repository (61c494d)

Package formatter

Performance Improvements

• Formatter registered as a singleton (via Container::scopedIf()) (2091790)

Package migrator

Bug Fixes

• Added missed AsCommand attribute (c61e830)