Register custom shorthands

[jasonmccreary]

After presenting Blueprint at Laracon AU 2025 an attendee suggested a no-brainer feature - the ability to register custom shorthands.

This would be incredibly useful for teams that have a common set of columns or statements they define for models or controllers. It also aligns with Blueprint's type less, generate more motto.

Here's an example of registering a custom shorthand.

$blueprint = resolve(Blueprint::class);
$blueprint->registerShorthand('customShorthand', function ($indent) {
    return $indent . 'expanded: definition';
});

For now, the YAML returned from the callback must be complete. That is, it can not contain any shorthands. When returning multiple lines, be sure to indent each one.