feat: Extend @php directive to support multiline blocks using @endphp

[benkhalife]

Description

Currently, Webrium View supports inline PHP execution using the @php( $a = 'b' ) syntax. While this works great for single-line expressions or variable assignments, it becomes hard to read and maintain when dealing with complex, multiline logic or defining multiple temporary variables.

To improve readability and developer flexibility, we should extend the current compiler to support multiline native PHP blocks using the @php and @endphp syntax, while maintaining backward compatibility with the existing inline syntax.

Current Syntax (Supported)

@php($counter = 1)

Proposed Syntax (To Be Added)

@php
    $counter = 1;
    $status = 'active';
    $role = 'admin';
@endphp

Expected Behavior

The compiler should be able to distinguish between the two formats:

1. If @php is followed by an opening parenthesis (, handle it as the current inline execution.

2. If @php is followed by a newline/whitespace, treat everything until @endphp as a raw PHP block and compile it into .

Checklist

• Update the @php regex pattern/parser to recognize both inline and multiline opening tags.
• Implement the @endphp closing tag compiler logic.
• Ensure the existing inline @php(...) syntax still works perfectly without breaking changes.
• Add unit tests for both inline and multiline @php blocks.
• Update documentation to showcase both methods.