Fix @JSON Blade directive parsing with nested structures

[elliota43]

Description

Fixes @json Blade directive incorrectly parsing complex expressions with nested structures. Replaces explode() with tokenizer-based parser that respects nesting depth.

Problem

The directive would split on commas inside nested arrays, closures, and method calls, causing parse errors.

Example (from original issue):

@json([
    'items' => $helpers['benefit']['getAll']()->map(fn($item) => [
        'icon' => $item->icon,
        'title' => (string)$item->title,
        'description' => (string)$item->description
    ]),
    'translation' => '%:booking.benefits%'
])

would incorrectly split on the comma inside the closure.

Solution

• Added parseArguments() method using PHP's tokenizer
• Tracks nesting depth (parentheses, brackets, braces)
• Only splits on commas at top level (depth === 0)
• Handles empty expressions (defaults to null)

Fully backwards compatible - defaults to same behavior as before.

Fixes #56331

[shaedrich]

You can shorten this to

Suggested change

	$parts = $this->parseArguments($this->stripParentheses($expression));
	$options = isset($parts[1]) ? trim($parts[1]) : $this->encodingOptions;
	$depth = isset($parts[2]) ? trim($parts[2]) : 512;
	return "<?php echo json_encode($parts[0], $options, $depth) ?>";
	// Ensure we have at least one argument, default to null if empty
	$data = $parts[0] ?? 'null';
	return "<?php echo json_encode($data, $options, $depth) ?>";
	[$data, $options, $depth] = $this->parseArguments($this->stripParentheses($expression)) + ['null', $this->encodingOptions, 512];
	return '<?php echo json_encode(' . $data . ', ' . trim($options) . ', ' . trim($depth) .') ?>";

or

Suggested change

	$parts = $this->parseArguments($this->stripParentheses($expression));
	$options = isset($parts[1]) ? trim($parts[1]) : $this->encodingOptions;
	$depth = isset($parts[2]) ? trim($parts[2]) : 512;
	return "<?php echo json_encode($parts[0], $options, $depth) ?>";
	// Ensure we have at least one argument, default to null if empty
	$data = $parts[0] ?? 'null';
	return "<?php echo json_encode($data, $options, $depth) ?>";
	[$data, $options, $depth] = $this->parseArguments($this->stripParentheses($expression)) + ['null', $this->encodingOptions, 512];
	return sprintf('<?php echo json_encode(%s, %d, %d); ?>', $data, trim($options), trim($depth));

if you want

[shaedrich]

You can narrow this further down:

Suggested change

	* @return array
	* @return array{0?: string, 1?: string, 2?: string}

[elliota43]

good call, thanks!

[shaedrich]

you're welcome!