Releases

What’s Changed

• Fix missing Reference type during parameters serialization by @romalytvynenko in #1177

What’s Changed

• Fix Laravel Data property being rendered as a other type when one property input name (#[MapInputName]) and other property name collides (enum case)

What’s Changed

• Add #[IgnoreParam] attribute support by @WendellAdriel in #1176
• Add UI renderers support (Scalar, etc.) by @romalytvynenko in #1175

New Contributors

• @WendellAdriel made their first contribution in #1176

What’s Changed

• Improve inference: __ support, facades support, array destructuring support by @romalytvynenko in #1167 and #1172
• Add include/exclude filtering to scramble.api_path by @romalytvynenko in #1168
• Automatically document API authentication by @romalytvynenko in #1170
• Improve inference by dropping type of calls to non-existing methods in unions in #1171
• Added newCollection support on models by @romalytvynenko in #1171
• Add Responsable support by @romalytvynenko in #1173

What’s Changed

• Fix request media type for Laravel Data objects with file properties
• Fixed compatibility with Laravel Data 4.23 by @romalytvynenko in #104

What’s Changed

• Support real-time Facades by @jcsoriano in #1146
• Support type inference for method calls and property access on union types by @romalytvynenko in #1151
• Improve null coalescing operator inference by @romalytvynenko in #1152
• Improve performance for projects with many inline types by @romalytvynenko in #1163

New Contributors

• @jcsoriano made their first contribution in #1146

What’s Changed

• Bump Scramble to 0.13.22

What’s Changed

• Support custom field for confirmed rule by @cappuc in #1128
• Add support for $this in rule expressions and improve rules evaluation safety by @romalytvynenko in #1145

Security: addresses a potential code execution issue under specific conditions.

New Contributors

• @cappuc made their first contribution in #1128

Changes to the generated query parameters JSON schema

Parameter handling is aligned with JSON:API serialization rules and expressed using proper OpenAPI schema. Instead of documenting parameters like include as string with described values, they are now defined as arrays with enumerated items. With explode: false, these arrays are serialized as comma-separated values (e.g. include=foo,bar) while remaining arrays in the schema.

{
    "name": "fields[appointments]",
    "in": "query",
    "schema": {
        "type": "array",
        "items": {
            "type": "string",
            "enum": [
                "title",
                "description",
                "status",
                "created_at"
            ]
        }
    },
    "explode": false
}

Fallback to previous behavior is available via configuration. If you prefer the old approach where JSON:API array parameters are documented as string, you can switch the serialization strategy:

use Dedoc\Scramble\Scramble;
use Dedoc\Scramble\Enums\JsonApiArraySerialization;

Scramble::configure()
    ->jsonApi(
        arraySerialization: JsonApiArraySerialization::String,
    );

What’s changed

• Improved type inference for query builder instances. The model type is now inferred for the query builder generic, allowing Scramble to correctly document types from expressions like QueryBuilder::from(SomeModel::class)->get()->toResourceCollection().
• When documenting Query Builder parameters, Scramble now respects the jsonApi arraySerialization configuration when handling query array enum parameters (such as include, fields[*], sort), documenting them as arrays of specific enum values instead of listing available values in the description.
• Added compatibility with Laravel’s native JSON:API implementation: Query Builder parameters take precedence when present.
• When allowedFields is used, Scramble documents the fields query parameter as fields[${model table name here}] instead of fields, better aligning with the JSON:API specification.
• Improved relationship include documentation for AllowedInclude::relationship(...) in Laravel Query Builder 7.0+: Scramble no longer documents redundant include values like postsCount and postsExists when only posts should be available.

What’s Changed

• Fix relationship resource guessing when not explicitly provided and recognize JSON:API parameters when resource is transformed to response by @romalytvynenko in #1143

What’s Changed

• Add toResourceCollection support on paginators by @romalytvynenko in #1142

What’s Changed

• Add JSON:API resources support by @romalytvynenko in #1136
• Add model’s toResource and toResourceCollection methods support by @romalytvynenko in #1138
• Add attributes support on FormRequest (e.g. #[*Parameter], #[SchemaName]) by @romalytvynenko in #1141
• Fix variadic placeholder request inference error by @romalytvynenko in #1139

What’s Changed

• Fix memory leak in long-running processes (prevent extensions priority duplication) by @romalytvynenko in #1132

What’s Changed

• Fixed documenting of explicitly included (or not included) properties of nullable lazy properties

What’s Changed

• Improved type templates inference by @romalytvynenko in #1112
• Improve type inference so when (from Conditional trait) is supported by @romalytvynenko in #1113
• Soft delete methods support by @romalytvynenko in #1117
• Fix #[SchemaName] attribute not reflected in response description by @dbrekelmans in #1118
• Fix required rule on arrays not setting minItems: 1 by @dbrekelmans in #1120
• Fix enum placed on array instead of items in OpenAPI spec by @dbrekelmans in #1119

New Contributors

• @dbrekelmans made their first contribution in #1118

What’s Changed

• Improved support of lazy properties on data collections

What’s Changed

• Improve support of lazy data collection properties

What’s Changed

• Improve lazy properties
• Added ability to hide data properties only from a documentation using Scramble’s Hidden attribute by @romalytvynenko in #94
• Add Laravel 13.x support by @romalytvynenko in #95
• Add compatibility with Laravel Query Builder 7.0

What’s Changed

• Fixed array annotated properties breaking in input context

What’s Changed

• Fix documenting properties with array-kind annotations