├── src
    ├── helpers.php
    ├── Http
    │   ├── Middleware
    │   │   ├── RegisterScript.php
    │   │   └── DumpHandler.php
    │   └── Controllers
    │   │   └── DatastarController.php
    ├── Helpers
    │   ├── Request.php
    │   ├── Action.php
    │   └── Datastar.php
    ├── Validation
    │   └── SignalValidator.php
    ├── Models
    │   └── Config.php
    ├── DatastarServiceProvider.php
    └── Services
    │   └── Sse.php
├── examples
    └── hello-world
    │   └── resources
    │       └── views
    │           ├── datastar
    │               └── hello-world.blade.php
    │           └── index.blade.php
├── LICENSE.md
├── phpunit.xml
├── config
    └── datastar.php
├── composer.json
├── CHANGELOG.md
├── README.md
└── public
    └── datastar
        └── 1.0.0-RC.6
            ├── datastar.js
            └── datastar-aliased.js


/src/helpers.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * @copyright Copyright (c) PutYourLightsOn
 4 |  */
 5 | 
 6 | use Putyourlightson\Datastar\Helpers\Datastar;
 7 | use Putyourlightson\Datastar\Services\Sse;
 8 | 
 9 | if (!function_exists('datastar')) {
10 |     function datastar(): Datastar
11 |     {
12 |         return new Datastar();
13 |     }
14 | }
15 | 
16 | if (!function_exists('sse')) {
17 |     function sse(): Sse
18 |     {
19 |         return app(Sse::class);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/examples/hello-world/resources/views/datastar/hello-world.blade.php:
--------------------------------------------------------------------------------
 1 | @php
 2 |     /** @var \Putyourlightson\Datastar\Models\Signals $signals */
 3 |     $delay = $signals['delay'] ?? 100;
 4 |     $message = 'Hello, world!';
 5 | @endphp
 6 | 
 7 | @for ($i = 0; $i < strlen($message); $i++)
 8 |     @patchelements
 9 |         <div id="message">
10 |             {{ substr($message, 0, $i + 1) }}
11 |         </div>
12 |     @endpatchelements
13 |     @php
14 |         // Sleep for the provided delay in milliseconds.
15 |         usleep($delay * 1000);
16 |     @endphp
17 | @endfor
18 | 


--------------------------------------------------------------------------------
/LICENSE.md:
--------------------------------------------------------------------------------
1 | Copyright © PutYourLightsOn
2 | 
3 | Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
4 | 
5 | The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
6 | 
7 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
8 | 


--------------------------------------------------------------------------------
/src/Http/Middleware/RegisterScript.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * @copyright Copyright (c) PutYourLightsOn
 4 |  */
 5 | 
 6 | namespace Putyourlightson\Datastar\Http\Middleware;
 7 | 
 8 | use Closure;
 9 | use Illuminate\Http\Request;
10 | use Symfony\Component\HttpFoundation\Response;
11 | 
12 | class RegisterScript
13 | {
14 |     public const VERSION = '1.0.0-RC.6';
15 | 
16 |     public function handle(Request $request, Closure $next): Response
17 |     {
18 |         $response = $next($request);
19 | 
20 |         if (!$response->isSuccessful()
21 |             || !str_contains($response->headers->get('content-type'), 'text/html')
22 |         ) {
23 |             return $response;
24 |         }
25 | 
26 |         $content = $response->getContent();
27 |         $path = asset('vendor/datastar/' . static::VERSION . '/datastar.js');
28 |         $asset = '<script type="module" src="' . $path . '"></script>';
29 |         $content = str_replace('</head>', $asset . '</head>', $content);
30 |         $response->setContent($content);
31 | 
32 |         return $response;
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/phpunit.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3 |          xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/11.5/phpunit.xsd"
 4 |          bootstrap="tests/bootstrap.php"
 5 |          colors="true"
 6 | >
 7 |     <testsuites>
 8 |         <testsuite name="Test Suite">
 9 |             <directory>tests</directory>
10 |         </testsuite>
11 |     </testsuites>
12 |     <source>
13 |         <include>
14 |             <directory>app</directory>
15 |         </include>
16 |     </source>
17 |     <php>
18 |         <env name="APP_ENV" value="testing"/>
19 |         <env name="APP_MAINTENANCE_DRIVER" value="file"/>
20 |         <env name="BCRYPT_ROUNDS" value="4"/>
21 |         <env name="CACHE_STORE" value="array"/>
22 |         <!-- <env name="DB_CONNECTION" value="sqlite"/> -->
23 |         <!-- <env name="DB_DATABASE" value=":memory:"/> -->
24 |         <env name="MAIL_MAILER" value="array"/>
25 |         <env name="PULSE_ENABLED" value="false"/>
26 |         <env name="QUEUE_CONNECTION" value="sync"/>
27 |         <env name="SESSION_DRIVER" value="array"/>
28 |         <env name="TELESCOPE_ENABLED" value="false"/>
29 |     </php>
30 | </phpunit>
31 | 


--------------------------------------------------------------------------------
/src/Helpers/Request.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * @copyright Copyright (c) PutYourLightsOn
 4 |  */
 5 | 
 6 | namespace Putyourlightson\Datastar\Helpers;
 7 | 
 8 | use Illuminate\Contracts\Translation\Translator;
 9 | use Illuminate\Support\Facades\Validator;
10 | use Putyourlightson\Datastar\Validation\SignalValidator;
11 | use starfederation\datastar\ServerSentEventGenerator;
12 | 
13 | class Request
14 | {
15 |     /**
16 |      * Returns a validator for the signals passed into the request.
17 |      */
18 |     public static function getValidator(array $rules, array $messages = [], array $attributes = []): SignalValidator
19 |     {
20 |         Validator::resolver(function(Translator $translator, array $data, array $rules, array $messages, array $attributes) {
21 |             return new SignalValidator($translator, $data, $rules, $messages, $attributes);
22 |         });
23 | 
24 |         /** @var SignalValidator $validator */
25 |         $validator = Validator::make(Request::readSignals(), $rules, $messages, $attributes);
26 | 
27 |         return $validator;
28 |     }
29 | 
30 |     /**
31 |      * Reads and returns the signals passed into the request.
32 |      */
33 |     public static function readSignals(): array
34 |     {
35 |         return ServerSentEventGenerator::readSignals();
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/config/datastar.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * @copyright Copyright (c) PutYourLightsOn
 4 |  */
 5 | 
 6 | return [
 7 |     /**
 8 |      * Whether to register the Datastar script on the front-end.
 9 |      */
10 |     'registerScript' => true,
11 | 
12 |     /**
13 |      * The name of the signals variable that will be injected into Datastar templates.
14 |      */
15 |     'signalsVariableName' => 'signals',
16 | 
17 |     /**
18 |      * The event options to override the Datastar defaults. Null values will be ignored.
19 |      */
20 |     'defaultEventOptions' => [
21 |         'retryDuration' => 1000,
22 |     ],
23 | 
24 |     /**
25 |      * The element options to override the Datastar defaults. Null values will be ignored.
26 |      */
27 |     'defaultElementOptions' => [
28 |         'settleDuration' => null,
29 |         'useViewTransition' => null,
30 |     ],
31 | 
32 |     /**
33 |      * The signal options to override the Datastar defaults. Null values will be ignored.
34 |      */
35 |     'defaultSignalOptions' => [
36 |         'onlyIfMissing' => null,
37 |     ],
38 | 
39 |     /**
40 |      * The execute script options to override the Datastar defaults. Null values will be ignored.
41 |      */
42 |     'defaultExecuteScriptOptions' => [
43 |         'autoRemove' => null,
44 |         'attributes' => null,
45 |     ],
46 | ];
47 | 


--------------------------------------------------------------------------------
/src/Http/Middleware/DumpHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * @copyright Copyright (c) PutYourLightsOn
 4 |  */
 5 | 
 6 | namespace Putyourlightson\Datastar\Http\Middleware;
 7 | 
 8 | use Closure;
 9 | use Illuminate\Foundation\Http\HtmlDumper;
10 | use Illuminate\Http\Request;
11 | use Symfony\Component\HttpFoundation\Response;
12 | use Symfony\Component\VarDumper\Cloner\VarCloner;
13 | use Symfony\Component\VarDumper\VarDumper;
14 | 
15 | class DumpHandler
16 | {
17 |     /**
18 |      * Handles calls to `dump()` and `dd()`.
19 |      */
20 |     public function handle(Request $request, Closure $next): Response
21 |     {
22 |         if (empty($request->headers->get('Datastar-Request'))) {
23 |             return $next($request);
24 |         }
25 | 
26 |         VarDumper::setHandler(function($var) {
27 |             $cloner = new VarCloner();
28 |             $dumper = new HtmlDumper(base_path(), config('view.compiled'));
29 | 
30 |             $stream = fopen('php://memory', 'r+');
31 |             $dumper->setOutput($stream);
32 |             $data = $cloner->cloneVar($var);
33 |             $dumper->dumpWithSource($data);
34 | 
35 |             rewind($stream);
36 |             $output = stream_get_contents($stream);
37 |             fclose($stream);
38 | 
39 |             if ($output !== false) {
40 |                 sse()->dump($output);
41 |             }
42 |         });
43 | 
44 |         return $next($request);
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "putyourlightson/laravel-datastar",
 3 |   "description": "A reactive hypermedia framework for Laravel.",
 4 |   "version": "1.0.0-RC.8",
 5 |   "type": "library",
 6 |   "license": "mit",
 7 |   "require": {
 8 |     "php": "^8.2",
 9 |     "laravel/framework": ">=11.0",
10 |     "starfederation/datastar-php": "^1.0.0-RC.3"
11 |   },
12 |   "require-dev": {
13 |     "craftcms/ecs": "dev-main",
14 |     "craftcms/phpstan": "dev-main",
15 |     "pestphp/pest": "^3.0"
16 |   },
17 |   "autoload": {
18 |     "psr-4": {
19 |       "Putyourlightson\\Datastar\\": "src/"
20 |     },
21 |     "files": [
22 |       "src/helpers.php"
23 |     ]
24 |   },
25 |   "extra": {
26 |     "laravel": {
27 |       "providers": [
28 |         "Putyourlightson\\Datastar\\DatastarServiceProvider"
29 |       ]
30 |     }
31 |   },
32 |   "scripts": {
33 |     "check-cs": "ecs check --ansi",
34 |     "fix-cs": "ecs check --ansi --fix",
35 |     "phpstan": "phpstan --memory-limit=1G",
36 |     "test": "vendor/bin/pest"
37 |   },
38 |   "config": {
39 |     "allow-plugins": {
40 |       "pestphp/pest-plugin": true
41 |     },
42 |     "optimize-autoloader": true,
43 |     "sort-packages": true
44 |   },
45 |   "support": {
46 |     "docs": "https://github.com/putyourlightson/laravel-datastar",
47 |     "source": "https://github.com/putyourlightson/laravel-datastar",
48 |     "issues": "https://github.com/putyourlightson/laravel-datastar/issues"
49 |   }
50 | }
51 | 


--------------------------------------------------------------------------------
/examples/hello-world/resources/views/index.blade.php:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en">
 3 | <head>
 4 |     <title>Datastar SDK Demo</title>
 5 |     <script src="https://unpkg.com/@tailwindcss/browser@4"></script>
 6 | </head>
 7 | <body class="bg-white dark:bg-gray-900 text-lg max-w-xl mx-auto my-16">
 8 |     <div data-signals-delay="400" class="bg-white dark:bg-gray-800 text-gray-500 dark:text-gray-400 rounded-lg px-6 py-8 ring shadow-xl ring-gray-900/5 space-y-2">
 9 |         <div class="flex justify-between items-center">
10 |             <h1 class="text-gray-900 dark:text-white text-3xl font-semibold">
11 |                 Datastar SDK Demo
12 |             </h1>
13 |             <img src="https://putyourlightson.com/assets/logos/datastar.svg" alt="Datastar Logo" width="64" height="64"/>
14 |         </div>
15 |         <p class="mt-2">
16 |             SSE events will be streamed from the backend to the frontend.
17 |         </p>
18 |         <div class="space-x-2">
19 |             <label for="delay">
20 |                 Delay in milliseconds
21 |             </label>
22 |             <input data-bind-delay id="delay" type="number" step="100" min="0" class="w-36 rounded-md border border-gray-300 px-3 py-2 placeholder-gray-400 shadow-sm focus:border-sky-500 focus:outline focus:outline-sky-500 dark:disabled:border-gray-700 dark:disabled:bg-gray-800/20" />
23 |         </div>
24 |         <button data-on-click="{{ datastar()->view('datastar.hello-world') }}" class="rounded-md bg-sky-500 px-5 py-2.5 leading-5 font-semibold text-white hover:bg-sky-700 hover:text-gray-100 cursor-pointer">
25 |             Start
26 |         </button>
27 |     </div>
28 |     <div class="my-16 text-8xl font-bold text-transparent" style="background: linear-gradient(to right in oklch, red, orange, yellow, green, blue, blue, violet); background-clip: text">
29 |         <div id="message">Hello, world!</div>
30 |     </div>
31 | </body>
32 | </html>
33 | 


--------------------------------------------------------------------------------
/src/Helpers/Action.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * @copyright Copyright (c) PutYourLightsOn
 4 |  */
 5 | 
 6 | namespace Putyourlightson\Datastar\Helpers;
 7 | 
 8 | class Action
 9 | {
10 |     /**
11 |      * Returns a Datastar action to a URI.
12 |      */
13 |     public static function getAction(string $method, string $uri, array|string $options): string
14 |     {
15 |         $args = ["'$uri'"];
16 | 
17 |         if ($method !== 'get') {
18 |             $options = self::addCsrfToken($options);
19 |         } else {
20 |             $options = is_array($options) ? json_encode($options) : $options;
21 |         }
22 | 
23 |         if (!empty($options)) {
24 |             $args[] = $options;
25 |         }
26 | 
27 |         $args = implode(', ', $args);
28 | 
29 |         return '@' . $method . '(' . $args . ')';
30 |     }
31 | 
32 |     private static function addCsrfToken(array|string $options): string
33 |     {
34 |         $csrfHeader = 'X-CSRF-TOKEN';
35 |         $token = csrf_token();
36 | 
37 |         if (is_array($options)) {
38 |             return self::addCsrfToArray($options, $csrfHeader, $token);
39 |         }
40 | 
41 |         return self::addCsrfToString($options, $csrfHeader, $token);
42 |     }
43 | 
44 |     private static function addCsrfToArray(array $options, string $csrfHeader, ?string $token): string
45 |     {
46 |         $headers = $options['headers'] ?? [];
47 |         $headers[$csrfHeader] = $token;
48 |         $options['headers'] = $headers;
49 | 
50 |         return json_encode($options);
51 |     }
52 | 
53 |     private static function addCsrfToString(string $options, string $csrfHeader, ?string $token): string
54 |     {
55 |         if (preg_match('/headers:\s*\{/i', $options)) {
56 |             return preg_replace(
57 |                 '/headers:\s*\{/i',
58 |                 'headers: {"' . $csrfHeader . '": "' . $token . '", ',
59 |                 $options
60 |             );
61 |         }
62 | 
63 |         if (preg_match('/}\s*$/', $options)) {
64 |             return preg_replace(
65 |                 '/}\s*$/',
66 |                 ', headers: {"' . $csrfHeader . '": "' . $token . '"}}',
67 |                 $options
68 |             );
69 |         }
70 | 
71 |         return json_encode(['headers' => [$csrfHeader => $token]]);
72 |     }
73 | }
74 | 


--------------------------------------------------------------------------------
/src/Validation/SignalValidator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * @copyright Copyright (c) PutYourLightsOn
 4 |  */
 5 | 
 6 | namespace Putyourlightson\Datastar\Validation;
 7 | 
 8 | use Illuminate\Validation\ValidationException;
 9 | use Illuminate\Validation\Validator;
10 | 
11 | class SignalValidator extends Validator
12 | {
13 |     public const ERROR_KEY = 'errors';
14 | 
15 |     /**
16 |      * @inheritdoc
17 |      */
18 |     public function validate(): array
19 |     {
20 |         $validated = [];
21 | 
22 |         try {
23 |             $validated = parent::validate();
24 |             $this->resetErrors();
25 |         } catch (ValidationException $exception) {
26 |             $this->sendErrorResponse($exception->errors());
27 |         }
28 | 
29 |         return $validated;
30 |     }
31 | 
32 |     /**
33 |      * @inheritdoc
34 |      */
35 |     public function validateWithBag(string $errorBag): array
36 |     {
37 |         $validated = [];
38 | 
39 |         try {
40 |             $validated = parent::validateWithBag($errorBag);
41 |             $this->resetErrors($errorBag);
42 |         } catch (ValidationException $exception) {
43 |             $this->sendErrorResponse($exception->errors(), $exception->errorBag);
44 |         }
45 | 
46 |         return $validated;
47 |     }
48 | 
49 |     /**
50 |      * @inheritdoc
51 |      */
52 |     public function validated(): array
53 |     {
54 |         $validated = [];
55 | 
56 |         try {
57 |             $validated = parent::validated();
58 |             $this->resetErrors();
59 |         } catch (ValidationException $exception) {
60 |             $this->sendErrorResponse($exception->errors());
61 |         }
62 | 
63 |         return $validated;
64 |     }
65 | 
66 |     /**
67 |      * Sends an error response with the validation errors.
68 |      */
69 |     private function sendErrorResponse(array $errors, string $errorBag = null): void
70 |     {
71 |         $errorKey = $errorBag ?? static::ERROR_KEY;
72 |         sse()->patchSignals([$errorKey => $errors])
73 |             ->getEventStream()
74 |             ->send();
75 | 
76 |         // Exit to prevent further processing of the request.
77 |         exit;
78 |     }
79 | 
80 |     /**
81 |      * Resets the errors in the specified error bag.
82 |      */
83 |     private function resetErrors(string $errorBag = null): void
84 |     {
85 |         $errorKey = $errorBag ?? static::ERROR_KEY;
86 |         $signals = array_fill_keys(array_keys($this->rules), null);
87 |         sse()->patchSignals([$errorKey => $signals]);
88 |     }
89 | }
90 | 


--------------------------------------------------------------------------------
/src/Models/Config.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * @copyright Copyright (c) PutYourLightsOn
  4 |  */
  5 | 
  6 | namespace Putyourlightson\Datastar\Models;
  7 | 
  8 | use Closure;
  9 | use Illuminate\Support\Facades\Validator;
 10 | use Illuminate\Validation\ValidationException;
 11 | 
 12 | class Config
 13 | {
 14 |     private const HASH_ALGORITHM = 'sha256';
 15 |     private const HASH_LENGTH = 64;
 16 | 
 17 |     public string|array $route = '';
 18 |     public array $params = [];
 19 | 
 20 |     /**
 21 |      * Creates a new instance from a hashed config string.
 22 |      */
 23 |     public static function fromHashed(string $config): ?self
 24 |     {
 25 |         $hash = substr($config, 0, self::HASH_LENGTH);
 26 |         $encoded = substr($config, self::HASH_LENGTH);
 27 |         $checksum = self::hash($encoded);
 28 | 
 29 |         if ($hash !== $checksum) {
 30 |             return null;
 31 |         }
 32 | 
 33 |         $attributes = json_decode($encoded, true);
 34 | 
 35 |         return new self($attributes);
 36 |     }
 37 | 
 38 |     /**
 39 |      * Hashes a string.
 40 |      */
 41 |     public static function hash(string $value): string
 42 |     {
 43 |         $key = app('encrypter')->getKey();
 44 | 
 45 |         return hash_hmac(self::HASH_ALGORITHM, $value, $key);
 46 |     }
 47 | 
 48 |     public function __construct(array $attributes = [])
 49 |     {
 50 |         foreach ($attributes as $key => $value) {
 51 |             $this->$key = $value;
 52 |         }
 53 |     }
 54 | 
 55 |     /**
 56 |      * Returns a hashed, JSON-encoded array of attributes.
 57 |      */
 58 |     public function getHashed(): string
 59 |     {
 60 |         $attributes = array_filter([
 61 |             'route' => $this->route,
 62 |             'params' => $this->params,
 63 |         ]);
 64 |         $encoded = json_encode($attributes);
 65 | 
 66 |         $checksum = self::hash($encoded);
 67 | 
 68 |         return $checksum . $encoded;
 69 |     }
 70 | 
 71 |     /**
 72 |      * Validates the model.
 73 |      */
 74 |     public function validate(): void
 75 |     {
 76 |         $validator = Validator::make([
 77 |             'route' => $this->route,
 78 |             'params' => $this->params,
 79 |         ], [
 80 |             'route' => 'required',
 81 |             'params' => function(string $attribute, mixed $params, Closure $fail) {
 82 |                 $this->validateParams($attribute, $params, $fail);
 83 |             },
 84 |         ]);
 85 | 
 86 |         if ($validator->fails()) {
 87 |             throw new ValidationException($validator);
 88 |         }
 89 |     }
 90 | 
 91 |     /**
 92 |      * Validates that none of the params are objects, recursively.
 93 |      */
 94 |     private function validateParams(string $attribute, mixed $params, Closure $fail): void
 95 |     {
 96 |         $signalsVariableName = config('datastar.signalsVariableName');
 97 | 
 98 |         foreach ($params as $key => $value) {
 99 |             if ($key === $signalsVariableName) {
100 |                 $fail('Param `' . $signalsVariableName . '` is reserved. Use a different name or modify the name of the signals variable using the `signalsVariableName` config setting.');
101 |                 return;
102 |             }
103 | 
104 |             if (is_object($value)) {
105 |                 $fail('Param `' . $key . '` is an object, which is a forbidden param type in the context of a Datastar request.');
106 |                 return;
107 |             }
108 | 
109 |             if (is_array($value)) {
110 |                 $this->validateParams($attribute, $value, $fail);
111 |             }
112 |         }
113 |     }
114 | }
115 | 


--------------------------------------------------------------------------------
/src/Helpers/Datastar.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * @copyright Copyright (c) PutYourLightsOn
  4 |  */
  5 | 
  6 | namespace Putyourlightson\Datastar\Helpers;
  7 | 
  8 | use Illuminate\Validation\ValidationException;
  9 | use Putyourlightson\Datastar\Http\Controllers\DatastarController;
 10 | use Putyourlightson\Datastar\Models\Config;
 11 | use Putyourlightson\Datastar\Services\Sse;
 12 | use Symfony\Component\HttpKernel\Exception\BadRequestHttpException;
 13 | 
 14 | class Datastar
 15 | {
 16 |     /**
 17 |      * Returns a Datastar `@get` action to render a view.
 18 |      */
 19 |     public function view(string $view, array $variables = [], array|string $options = []): string
 20 |     {
 21 |         $config = $this->getConfig($view, $variables);
 22 |         $uri = action([DatastarController::class, 'view'], ['config' => $config->getHashed()]);
 23 | 
 24 |         return $this->get($uri, $options);
 25 |     }
 26 | 
 27 |     /**
 28 |      * Returns a Datastar `@post` action to a controller action.
 29 |      */
 30 |     public function action(string|array $route, array $params = [], array|string $options = []): string
 31 |     {
 32 |         $config = $this->getConfig($route, $params);
 33 |         $uri = action([DatastarController::class, 'action'], ['config' => $config->getHashed()]);
 34 | 
 35 |         return $this->post($uri, $options);
 36 |     }
 37 | 
 38 |     /**
 39 |      * Returns a Datastar `@get` action to the given URI.
 40 |      */
 41 |     public function get(string $uri, array|string $options = []): string
 42 |     {
 43 |         return Action::getAction('get', $uri, $options);
 44 |     }
 45 | 
 46 |     /**
 47 |      * Returns a Datastar `@post` action to the given URI.
 48 |      */
 49 |     public function post(string $uri, array|string $options = []): string
 50 |     {
 51 |         return Action::getAction('post', $uri, $options);
 52 |     }
 53 | 
 54 |     /**
 55 |      * Returns a Datastar `@put` action to the given URI.
 56 |      */
 57 |     public function put(string $uri, array|string $options = []): string
 58 |     {
 59 |         return Action::getAction('put', $uri, $options);
 60 |     }
 61 | 
 62 |     /**
 63 |      * Returns a Datastar `@patch` action to the given URI.
 64 |      */
 65 |     public function patch(string $uri, array|string $options = []): string
 66 |     {
 67 |         return Action::getAction('patch', $uri, $options);
 68 |     }
 69 | 
 70 |     /**
 71 |      * Returns a Datastar `@delete` action to the given URI.
 72 |      */
 73 |     public function delete(string $uri, array|string $options = []): string
 74 |     {
 75 |         return Action::getAction('delete', $uri, $options);
 76 |     }
 77 | 
 78 |     /**
 79 |      * Reads and returns the signals passed into the request.
 80 |      */
 81 |     public function readSignals(): array
 82 |     {
 83 |         return Request::readSignals();
 84 |     }
 85 | 
 86 |     /**
 87 |      * Sets server sent event options.
 88 |      */
 89 |     public function setSseEventOptions(array $options = []): void
 90 |     {
 91 |         app(Sse::class)->setSseEventOptions($options);
 92 |     }
 93 | 
 94 | 
 95 |     /**
 96 |      * Returns a Datastar config for the given route and parameters.
 97 |      */
 98 |     private function getConfig(string|array $route, array $params = []): Config
 99 |     {
100 |         $config = new Config([
101 |             'route' => $route,
102 |             'params' => $params,
103 |         ]);
104 | 
105 |         try {
106 |             $config->validate();
107 |         } catch (ValidationException $exception) {
108 |             throw new BadRequestHttpException($exception->getMessage());
109 |         }
110 | 
111 |         return $config;
112 |     }
113 | }
114 | 


--------------------------------------------------------------------------------
/src/DatastarServiceProvider.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * @copyright Copyright (c) PutYourLightsOn
  4 |  */
  5 | 
  6 | namespace Putyourlightson\Datastar;
  7 | 
  8 | use Illuminate\Support\Facades\Blade;
  9 | use Illuminate\Support\Facades\Route;
 10 | use Illuminate\Support\ServiceProvider;
 11 | use Putyourlightson\Datastar\Http\Controllers\DatastarController;
 12 | use Putyourlightson\Datastar\Http\Middleware\DumpHandler;
 13 | use Putyourlightson\Datastar\Http\Middleware\RegisterScript;
 14 | use Putyourlightson\Datastar\Services\Sse;
 15 | 
 16 | class DatastarServiceProvider extends ServiceProvider
 17 | {
 18 |     public function register(): void
 19 |     {
 20 |         $this->mergeConfigFrom(__DIR__ . '/../config/datastar.php', 'datastar');
 21 | 
 22 |         $this->app->singleton(Sse::class, function() {
 23 |             return new Sse();
 24 |         });
 25 |     }
 26 | 
 27 |     public function boot(): void
 28 |     {
 29 |         $this->publishes([
 30 |             __DIR__ . '/../config/datastar.php' => config_path('datastar.php'),
 31 |         ], 'datastar-config');
 32 | 
 33 |         $this->publishes([
 34 |             __DIR__ . '/../public' => public_path('vendor'),
 35 |         ], 'public');
 36 | 
 37 |         $this->registerRoutes();
 38 |         $this->registerDumpHandler();
 39 |         $this->registerScript();
 40 |         $this->registerDirectives();
 41 |     }
 42 | 
 43 |     private function registerRoutes(): void
 44 |     {
 45 |         Route::middleware(['web'])->group(function() {
 46 |             Route::get('/datastar-controller/view', [DatastarController::class, 'view']);
 47 |             Route::post('/datastar-controller/action', [DatastarController::class, 'action']);
 48 |         });
 49 |     }
 50 | 
 51 |     private function registerDumpHandler(): void
 52 |     {
 53 |         $this->app['router']->pushMiddlewareToGroup('web', DumpHandler::class);
 54 |     }
 55 | 
 56 |     private function registerScript(): void
 57 |     {
 58 |         if (config('datastar.registerScript', true) === false) {
 59 |             return;
 60 |         }
 61 | 
 62 |         $this->app['router']->pushMiddlewareToGroup('web', RegisterScript::class);
 63 |     }
 64 | 
 65 |     /**
 66 |      * @uses Sse::patchElements()
 67 |      * @uses Sse::removeElements()
 68 |      * @uses Sse::patchSignals()
 69 |      * @uses Sse::executeScript()
 70 |      * @uses Sse::location()
 71 |      * @uses Sse::setSseInProcess
 72 |      */
 73 |     private function registerDirectives(): void
 74 |     {
 75 |         Blade::directive('patchelements', function(string $expression) {
 76 |             return $this->getDirective("setSseInProcess('patchElements', $expression); ob_start()");
 77 |         });
 78 | 
 79 |         Blade::directive('endpatchelements', function() {
 80 |             return $this->getDirective("patchElements(ob_get_clean())");
 81 |         });
 82 | 
 83 |         Blade::directive('removeelements', function(string $expression) {
 84 |             return $this->getDirective("removeElements($expression)");
 85 |         });
 86 | 
 87 |         Blade::directive('patchsignals', function(string $expression) {
 88 |             return $this->getDirective("patchSignals($expression)");
 89 |         });
 90 | 
 91 |         Blade::directive('executescript', function(string $expression) {
 92 |             return $this->getDirective("setSseInProcess('executeScript', $expression); ob_start()");
 93 |         });
 94 | 
 95 |         Blade::directive('endexecutescript', function() {
 96 |             return $this->getDirective("executeScript(ob_get_clean())");
 97 |         });
 98 | 
 99 |         Blade::directive('location', function(string $expression) {
100 |             return $this->getDirective("location($expression)");
101 |         });
102 |     }
103 | 
104 |     private function getDirective(string $expression): string
105 |     {
106 |         return "<?php app(\Putyourlightson\Datastar\Services\Sse::class)->$expression ?>";
107 |     }
108 | }
109 | 


--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
  1 | # Release Notes for Datastar
  2 | 
  3 | ## 1.0.0-RC.8 - 2025-10-26
  4 | 
  5 | > [!NOTE]
  6 | > The Datastar syntax has changed in this release. Please see the [release notes](https://github.com/starfederation/datastar/releases/tag/v1.0.0-RC.6) and modify your code accordingly.
  7 | 
  8 | - The package now includes Datastar [1.0.0-RC.6](https://github.com/starfederation/datastar/releases/tag/v1.0.0-RC.6).
  9 | 
 10 | ## 1.0.0-RC.7 - 2025-10-05
 11 | 
 12 | - Added a check before clearing the output buffer to ensure it exists ([#7](https://github.com/putyourlightson/laravel-datastar/issues/7)).
 13 | - Fixed source map filenames.
 14 | 
 15 | ## 1.0.0-RC.6 - 2025-08-23
 16 | 
 17 | - Improved error handling.
 18 | - Improved handling of calls to `dump()` and `dd()`.
 19 | 
 20 | ## 1.0.0-RC.5 - 2025-08-17
 21 | 
 22 | - The package now includes Datastar [1.0.0-RC.5](https://github.com/starfederation/datastar/releases/tag/v1.0.0-RC.5).
 23 | - Fixed a bug in which options were being double JSON encoded.
 24 | 
 25 | ## 1.0.0-RC.4 - 2025-08-12
 26 | 
 27 | - Made it possible to pass options in as string, for cases when JSON encoding is not desirable.
 28 | - Improved error handling.
 29 | 
 30 | ## 1.0.0-RC.3 - 2025-08-09
 31 | 
 32 | - The package now includes Datastar [1.0.0-RC.4](https://github.com/starfederation/datastar/releases/tag/v1.0.0-RC.4).
 33 | - The `datastar()->get()` and equivalent Blade directives now only support passing a route URI.
 34 | - Added the ability to render views in backend requests by passing a view path `path.to.view` to `datastar()->view()`.
 35 | - Added the ability to pass controller actions to backend requests by passing an array `['MyController', 'myAction']` to `datastar()->action()`.
 36 | - Added the `getValidator()` method to the `sse()` helper.
 37 | - Added the `validate()` and `validateWithBag()` methods to the `sse()` helper.
 38 | - Added the `shouldCloseSession()` method to the `sse()` helper that determines whether the session should be closed when the event stream begins.
 39 | - The session is now closed by default when the `getEventStream()` method is called, to prevent session locking.
 40 | - Replaced the `DatastarEventStream` trait with the `sse()` helper.
 41 | - Renamed the `getStreamedResponse()` method to `getEventStream()`.
 42 | - Renamed the `renderDatastarView()` method to `renderView()`.
 43 | 
 44 | ## 1.0.0-RC.2 - 2025-07-17
 45 | 
 46 | - The package now includes Datastar [1.0.0-RC.2](https://github.com/starfederation/datastar/releases/tag/v1.0.0-RC.2).
 47 | 
 48 | ## 1.0.0-RC.1 - 2025-07-15
 49 | 
 50 | - The package now requires Datastar [1.0.0-RC.1](https://github.com/starfederation/datastar/releases/tag/v1.0.0-RC.1).
 51 | - Renamed the `fragments` Blade directive to `patchelements`.
 52 | - Renamed the `removefragments` Blade directive to `removeelements`.
 53 | - Renamed the `mergesignals` Blade directive to `patchsignals`.
 54 | - Renamed the `defaultFragmentOptions` config setting to `defaultElementOptions`.
 55 | - Removed the `removesignals` Blade directive.
 56 | - Removed the `datastar()->getFragments()` helper method.
 57 | - Removed the `SignalsModel` class. The `signals` variable passed into Datastar templates is now a regular array. Use the `patchsignals` Twig tag to update and remove signals.
 58 | 
 59 | ## 1.0.0-beta.8 - 2025-04-15
 60 | 
 61 | ### Added
 62 | 
 63 | - Added a `datastar()->getFragments()` helper method that fetches and merge fragments into the DOM.
 64 | 
 65 | ## 1.0.0-beta.7 - 2025-04-09
 66 | 
 67 | ### Changed
 68 | 
 69 | - Update the Datastar library to version 1.0.0-beta.11. 
 70 | 
 71 | ## 1.0.0-beta.6 - 2025-03-01
 72 | 
 73 | ### Changed
 74 | 
 75 | - Update the Datastar library to version 1.0.0-beta.9. 
 76 | 
 77 | ## 1.0.0-beta.5 - 2025-02-25
 78 | 
 79 | ### Changed
 80 | 
 81 | - Update the Datastar library to version 1.0.0-beta.8. 
 82 | 
 83 | ## 1.0.0-beta.4 - 2025-02-14
 84 | 
 85 | ### Changed
 86 | 
 87 | - Update the Datastar library to version 1.0.0-beta.7. 
 88 | 
 89 | ## 1.0.0-beta.3 - 2025-02-12
 90 | 
 91 | ### Changed
 92 | 
 93 | - Extract methods into the SSE service class.
 94 | 
 95 | ## 1.0.0-beta.2 - 2025-02-02
 96 | 
 97 | ### Added
 98 | 
 99 | - Added the `location` Blade directive.
100 | 
101 | ## 1.0.0-beta.1 - 2025-01-13
102 | 
103 | - Initial beta release.
104 | 


--------------------------------------------------------------------------------
/src/Http/Controllers/DatastarController.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * @copyright Copyright (c) PutYourLightsOn
  4 |  */
  5 | 
  6 | namespace Putyourlightson\Datastar\Http\Controllers;
  7 | 
  8 | use Illuminate\Contracts\Routing\UrlRoutable;
  9 | use Illuminate\Database\Eloquent\Model;
 10 | use Illuminate\Routing\Controllers\HasMiddleware;
 11 | use Illuminate\Routing\Controllers\Middleware;
 12 | use Illuminate\Routing\Pipeline;
 13 | use Illuminate\Support\Facades\App;
 14 | use Putyourlightson\Datastar\Models\Config;
 15 | use ReflectionMethod;
 16 | use ReflectionNamedType;
 17 | use Symfony\Component\HttpFoundation\Response;
 18 | use Symfony\Component\HttpFoundation\StreamedResponse;
 19 | use Symfony\Component\HttpKernel\Exception\BadRequestHttpException;
 20 | 
 21 | class DatastarController
 22 | {
 23 |     /**
 24 |      * Renders a view in an event stream.
 25 |      */
 26 |     public function view(): StreamedResponse
 27 |     {
 28 |         $config = $this->getConfig();
 29 |         $view = $config->route;
 30 |         $variables = $config->params;
 31 | 
 32 |         return sse()->getEventStream(function() use ($view, $variables) {
 33 |             sse()->renderView($view, $variables);
 34 |         });
 35 |     }
 36 | 
 37 |     /**
 38 |      * Runs a controller action.
 39 |      */
 40 |     public function action(): ?Response
 41 |     {
 42 |         $config = $this->getConfig();
 43 | 
 44 |         $route = $config->route;
 45 |         $params = $config->params;
 46 |         $method = '__invoke';
 47 | 
 48 |         if (is_array($route)) {
 49 |             $route = $config->route[0] ?? null;
 50 |             if (empty($route)) {
 51 |                 throw new BadRequestHttpException('A controller must be specified in the route.');
 52 |             }
 53 | 
 54 |             $method = $config->route[1] ?? null;
 55 |             if (empty($method)) {
 56 |                 throw new BadRequestHttpException('A controller and method must be specified in the route.');
 57 |             }
 58 |         }
 59 | 
 60 |         if (!str_contains($route, '\\')) {
 61 |             $route = 'App\\Http\\Controllers\\' . $route;
 62 |         }
 63 | 
 64 |         if (!class_exists($route)) {
 65 |             throw new BadRequestHttpException("Controller `$route` does not exist. Make sure you’re using a valid namespace and that the class is autoloaded.");
 66 |         }
 67 | 
 68 |         $controller = app($route);
 69 | 
 70 |         if (!method_exists($controller, $method)) {
 71 |             throw new BadRequestHttpException("Method `$method` does not exist on controller `$route`.");
 72 |         }
 73 | 
 74 |         $params = $this->resolveRouteBindings($controller, $method, $params);
 75 | 
 76 |         $middlewareStack = $this->buildMiddlewareStack($controller, $method);
 77 | 
 78 |         return app(Pipeline::class)
 79 |             ->send(request())
 80 |             ->through($middlewareStack)
 81 |             ->then(function() use ($controller, $method, $params) {
 82 |                 return app()->call([$controller, $method], $params);
 83 |             });
 84 |     }
 85 | 
 86 |     /**
 87 |      * Returns the validated configuration from the request.
 88 |      *
 89 |      * @throws BadRequestHttpException if the configuration is invalid or tampered with.
 90 |      */
 91 |     private function getConfig(): Config
 92 |     {
 93 |         $hashedConfig = request()->input('config');
 94 |         $config = Config::fromHashed($hashedConfig);
 95 | 
 96 |         if ($config === null) {
 97 |             throw new BadRequestHttpException('Submitted data was tampered.');
 98 |         }
 99 | 
100 |         return $config;
101 |     }
102 | 
103 |     /**
104 |      * Resolves route bindings for the given controller and method.
105 |      */
106 |     private function resolveRouteBindings($controller, string $method, array $rawParams): array
107 |     {
108 |         $reflection = new ReflectionMethod($controller, $method);
109 |         $resolved = [];
110 | 
111 |         foreach ($reflection->getParameters() as $param) {
112 |             $name = $param->getName();
113 |             $type = $param->getType();
114 | 
115 |             if (!($type instanceof ReflectionNamedType) || $type->isBuiltin()) {
116 |                 $resolved[$name] = $rawParams[$name] ?? null;
117 |                 continue;
118 |             }
119 | 
120 |             $className = $type->getName();
121 | 
122 |             if (is_subclass_of($className, Model::class) && isset($rawParams[$name])) {
123 |                 /** @var UrlRoutable $instance */
124 |                 $instance = App::make($className);
125 |                 $resolved[$name] = $instance->resolveRouteBinding($rawParams[$name]);
126 |             } else {
127 |                 $resolved[$name] = $rawParams[$name] ?? App::make($className);
128 |             }
129 |         }
130 | 
131 |         return $resolved;
132 |     }
133 | 
134 |     /**
135 |      * Builds the middleware stack for the given controller and method.
136 |      */
137 |     private function buildMiddlewareStack(object $controller, string $method): array
138 |     {
139 |         if (!($controller instanceof HasMiddleware)) {
140 |             return [];
141 |         }
142 | 
143 |         $middlewareStack = [];
144 |         $aliases = app('router')->getMiddleware();
145 | 
146 |         foreach ($controller::middleware() as $middleware) {
147 |             if ($middleware instanceof Middleware) {
148 |                 if ($this->middlewareShouldApply($middleware, $method)) {
149 |                     if (is_callable($middleware->middleware)) {
150 |                         $resolved = $middleware->middleware;
151 |                     } elseif (is_string($middleware->middleware)) {
152 |                         $resolved = $aliases[$middleware->middleware] ?? $middleware->middleware;
153 |                     } else {
154 |                         throw new BadRequestHttpException('Invalid middleware type.');
155 |                     }
156 |                     $middlewareStack[] = $resolved;
157 |                 }
158 |             } else {
159 |                 $resolved = $aliases[$middleware] ?? $middleware;
160 |                 $middlewareStack[] = $resolved;
161 |             }
162 |         }
163 | 
164 |         return $middlewareStack;
165 |     }
166 | 
167 |     /**
168 |      * Returns whether middleware should apply to the given method.
169 |      */
170 |     private function middlewareShouldApply(Middleware $middleware, string $method): bool
171 |     {
172 |         if (!empty($middleware->only) && !in_array($method, $middleware->only)) {
173 |             return false;
174 |         }
175 | 
176 |         if (!empty($middleware->except) && in_array($method, $middleware->except)) {
177 |             return false;
178 |         }
179 | 
180 |         return true;
181 |     }
182 | }
183 | 


--------------------------------------------------------------------------------
/src/Services/Sse.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /**
  3 |  * @copyright Copyright (c) PutYourLightsOn
  4 |  */
  5 | 
  6 | namespace Putyourlightson\Datastar\Services;
  7 | 
  8 | use Exception;
  9 | use Illuminate\Contracts\Debug\ExceptionHandler;
 10 | use Putyourlightson\Datastar\Helpers\Request;
 11 | use Putyourlightson\Datastar\Validation\SignalValidator;
 12 | use starfederation\datastar\enums\ElementPatchMode;
 13 | use starfederation\datastar\events\EventInterface;
 14 | use starfederation\datastar\events\ExecuteScript;
 15 | use starfederation\datastar\events\Location;
 16 | use starfederation\datastar\events\PatchElements;
 17 | use starfederation\datastar\events\PatchSignals;
 18 | use starfederation\datastar\events\RemoveElements;
 19 | use starfederation\datastar\ServerSentEventGenerator;
 20 | use Symfony\Component\HttpFoundation\StreamedResponse;
 21 | use Throwable;
 22 | 
 23 | class Sse
 24 | {
 25 |     /**
 26 |      * Whether the response is a streamed response.
 27 |      */
 28 |     private bool $isStreamedResponse = false;
 29 | 
 30 |     /**
 31 |      * Whether the session should be closed when the event stream begins.
 32 |      * This is useful to allow other requests to be processed while the event stream is being sent.
 33 |      */
 34 |     private bool $shouldCloseSession = true;
 35 | 
 36 |     /**
 37 |      * Server sent events to send.
 38 |      *
 39 |      * @var EventInterface[]
 40 |      */
 41 |     private array $sseEvents = [];
 42 | 
 43 |     /**
 44 |      * Server sent event options to send.
 45 |      */
 46 |     private array $sseEventOptions = [];
 47 | 
 48 |     /**
 49 |      * The server sent event method currently in process.
 50 |      */
 51 |     private ?string $sseMethodInProcess = null;
 52 | 
 53 |     /**
 54 |      * The server sent event options currently in process.
 55 |      */
 56 |     private array|null $sseOptionsInProcess = [];
 57 | 
 58 |     /**
 59 |      * Returns an event stream.
 60 |      */
 61 |     public function getEventStream(?callable $callable = null): StreamedResponse
 62 |     {
 63 |         // Abort the process if the client closes the connection.
 64 |         ignore_user_abort(false);
 65 | 
 66 |         $this->isStreamedResponse = true;
 67 | 
 68 |         $eventStream = function() use ($callable) {
 69 |             if ($this->shouldCloseSession && session_status() === PHP_SESSION_ACTIVE) {
 70 |                 session_write_close();
 71 |             }
 72 | 
 73 |             echo $this->getEventOutput();
 74 |             if (ob_get_contents()) {
 75 |                 ob_flush();
 76 |             }
 77 |             flush();
 78 | 
 79 |             if (is_callable($callable)) {
 80 |                 try {
 81 |                     $callable();
 82 |                 } catch (Throwable $exception) {
 83 |                     $this->throwException($exception);
 84 |                 }
 85 |             }
 86 |         };
 87 | 
 88 |         return new StreamedResponse($eventStream, 200, ServerSentEventGenerator::headers());
 89 |     }
 90 | 
 91 |     /**
 92 |      * Returns the output of all events as a string.
 93 |      */
 94 |     public function getEventOutput(bool $reset = true): string
 95 |     {
 96 |         $data = '';
 97 |         foreach ($this->sseEvents as $event) {
 98 |             $data .= $event->getOutput();
 99 |         }
100 | 
101 |         if ($reset) {
102 |             $this->resetEvents();
103 |         }
104 | 
105 |         return $data;
106 |     }
107 | 
108 |     /**
109 |      * Returns a validator for the signals passed into the request.
110 |      */
111 |     public function getValidator(array $rules, array $messages = [], array $attributes = []): SignalValidator
112 |     {
113 |         return Request::getValidator($rules, $messages, $attributes);
114 |     }
115 | 
116 |     /**
117 |      * Validates the signals passed into the request.
118 |      */
119 |     public function validate(array $rules, array $messages = [], array $attributes = []): array
120 |     {
121 |         return Request::getValidator($rules, $messages, $attributes)
122 |             ->validate();
123 |     }
124 | 
125 |     /**
126 |      * Validates the signals passed into the request using a provided error bag.
127 |      */
128 |     public function validateWithBag(string $errorBag, array $rules, array $messages = [], array $attributes = []): array
129 |     {
130 |         return Request::getValidator($rules, $messages, $attributes)
131 |             ->validateWithBag($errorBag);
132 |     }
133 | 
134 |     /**
135 |      * Reads and returns the signals passed into the request.
136 |      */
137 |     public function readSignals(): array
138 |     {
139 |         return Request::readSignals();
140 |     }
141 | 
142 |     /**
143 |      * Patches elements into the DOM.
144 |      */
145 |     public function patchElements(string $data, array $options = []): static
146 |     {
147 |         $options = $this->patchEventOptions(
148 |             config('datastar.defaultElementOptions', []),
149 |             $this->sseEventOptions,
150 |             $options,
151 |         );
152 |         $event = new PatchElements($data, $options);
153 | 
154 |         $this->processEvent($event);
155 | 
156 |         return $this;
157 |     }
158 | 
159 |     /**
160 |      * Removes elements from the DOM.
161 |      */
162 |     public function removeElements(string $selector, array $options = []): static
163 |     {
164 |         $options = $this->patchEventOptions(
165 |             config('datastar.defaultElementOptions', []),
166 |             $this->sseEventOptions,
167 |             $options,
168 |         );
169 |         $event = new RemoveElements($selector, $options);
170 | 
171 |         $this->processEvent($event);
172 | 
173 |         return $this;
174 |     }
175 | 
176 |     /**
177 |      * Patches signals.
178 |      */
179 |     public function patchSignals(array $signals, array $options = []): static
180 |     {
181 |         $options = $this->patchEventOptions(
182 |             config('datastar.defaultSignalOptions', []),
183 |             $this->sseEventOptions,
184 |             $options,
185 |         );
186 |         $event = new PatchSignals($signals, $options);
187 | 
188 |         $this->processEvent($event);
189 | 
190 |         return $this;
191 |     }
192 | 
193 |     /**
194 |      * Executes JavaScript in the browser.
195 |      */
196 |     public function executeScript(string $script, array $options = []): static
197 |     {
198 |         $options = $this->patchEventOptions(
199 |             config('datastar.defaultExecuteScriptOptions', []),
200 |             $this->sseEventOptions,
201 |             $options,
202 |         );
203 |         $event = new ExecuteScript($script, $options);
204 | 
205 |         $this->processEvent($event);
206 | 
207 |         return $this;
208 |     }
209 | 
210 |     /**
211 |      * Redirects the browser by setting the location to the provided URI.
212 |      */
213 |     public function location(string $uri, array $options = []): static
214 |     {
215 |         $options = $this->patchEventOptions(
216 |             config('datastar.defaultExecuteScriptOptions', []),
217 |             $this->sseEventOptions,
218 |             $options,
219 |         );
220 |         $event = new Location($uri, $options);
221 | 
222 |         $this->processEvent($event);
223 | 
224 |         return $this;
225 |     }
226 | 
227 |     /**
228 |      * Renders a view.
229 |      */
230 |     public function renderView(string $view, array $variables = []): static
231 |     {
232 |         $signals = $this->readSignals();
233 |         $variables = array_merge(
234 |             [config('datastar.signalsVariableName', 'signals') => $signals],
235 |             $variables,
236 |         );
237 | 
238 |         if (strtolower(request()->header('Content-Type')) === 'application/json') {
239 |             // Clear out params to prevent them from being processed by controller actions.
240 |             request()->query->replace();
241 |             request()->request->replace();
242 |         }
243 | 
244 |         try {
245 |             $output = view($view, $variables)->render();
246 |             if (!empty(trim($output))) {
247 |                 $this->patchElements($output);
248 |             }
249 |         } catch (Throwable $exception) {
250 |             $this->throwException($exception);
251 |         }
252 | 
253 |         return $this;
254 |     }
255 | 
256 |     /**
257 |      * Resets the current events.
258 |      */
259 |     public function resetEvents(): static
260 |     {
261 |         $this->sseEvents = [];
262 | 
263 |         return $this;
264 |     }
265 | 
266 |     /**
267 |      * Sets server sent event options for the current request.
268 |      */
269 |     public function setSseEventOptions(array $options): static
270 |     {
271 |         $this->sseEventOptions = $options;
272 | 
273 |         return $this;
274 |     }
275 | 
276 |     /**
277 |      * Sets the server sent event method and options currently in process.
278 |      */
279 |     public function setSseInProcess(?string $method, array $options = []): static
280 |     {
281 |         $this->sseMethodInProcess = $method;
282 |         $this->sseOptionsInProcess = $options;
283 | 
284 |         return $this;
285 |     }
286 | 
287 |     /**
288 |      * Determines whether the session should be closed when the event stream begins.
289 |      */
290 |     public function shouldCloseSession(bool $value): static
291 |     {
292 |         $this->shouldCloseSession = $value;
293 | 
294 |         return $this;
295 |     }
296 | 
297 |     /**
298 |      * Patches an exception response or logs a console error.
299 |      *
300 |      * @phpstan-return never
301 |      */
302 |     public function throwException(Throwable $exception): void
303 |     {
304 |         $this->getEventStream(function() use ($exception) {
305 |             $exceptionHandler = app(ExceptionHandler::class);
306 |             if ($exceptionHandler->shouldReport($exception)) {
307 |                 $exceptionHandler->report($exception);
308 |             }
309 | 
310 |             if (config('app.debug')) {
311 |                 $response = $exceptionHandler->render(app('request'), $exception);
312 |                 $event = new PatchElements($response->getContent());
313 |             } else {
314 |                 $message = 'A server error occurred.';
315 |                 $event = new ExecuteScript('console.error(' . json_encode($message) . ');');
316 |             }
317 | 
318 |             echo $event->getOutput();
319 |         })->send();
320 | 
321 |         exit(1);
322 |     }
323 | 
324 |     /**
325 |      * Prepends dumped content to the `<body>` tag.
326 |      */
327 |     public function dump(string $output): void
328 |     {
329 |         $this->patchElements($output, [
330 |             'selector' => 'body',
331 |             'mode' => ElementPatchMode::Prepend,
332 |         ]);
333 | 
334 |         if (!$this->isStreamedResponse) {
335 |             $this->getEventStream()->send();
336 |         }
337 |     }
338 | 
339 |     /**
340 |      * Returns patch event options with null values removed.
341 |      */
342 |     private function patchEventOptions(array ...$optionSets): array
343 |     {
344 |         $options = array_merge(
345 |             config('datastar.defaultEventOptions', []),
346 |             $this->sseOptionsInProcess,
347 |         );
348 | 
349 |         $this->sseOptionsInProcess = [];
350 | 
351 |         foreach ($optionSets as $optionSet) {
352 |             $options = array_merge($options, $optionSet);
353 |         }
354 | 
355 |         return array_filter($options, fn($value) => $value !== null);
356 |     }
357 | 
358 |     /**
359 |      * Processes an event.
360 |      */
361 |     private function processEvent(EventInterface $event): void
362 |     {
363 |         $this->verifySseMethodInProcess($event);
364 | 
365 |         $this->sseEvents[] = $event;
366 | 
367 |         if ($this->isStreamedResponse) {
368 |             // Clean and end all existing output buffers.
369 |             while (ob_get_level() > 0) {
370 |                 ob_end_clean();
371 |             }
372 | 
373 |             echo $event->getOutput();
374 | 
375 |             if (ob_get_contents()) {
376 |                 ob_end_flush();
377 |             }
378 |             flush();
379 | 
380 |             // Start a new output buffer to capture any subsequent inline content.
381 |             ob_start();
382 |         }
383 | 
384 |         $this->setSseInProcess(null);
385 |     }
386 | 
387 |     /**
388 |      * Verifies that another SSE method is not already in process.
389 |      */
390 |     private function verifySseMethodInProcess(EventInterface $event): void
391 |     {
392 |         if ($this->sseMethodInProcess === null) {
393 |             return;
394 |         }
395 | 
396 |         $sseMethods = [
397 |             PatchElements::class => 'patchElements',
398 |             RemoveElements::class => 'removeElements',
399 |             PatchSignals::class => 'patchSignals',
400 |             ExecuteScript::class => 'executeScript',
401 |         ];
402 | 
403 |         $method = $sseMethods[$event::class] ?? null;
404 |         if ($method === null) {
405 |             return;
406 |         }
407 | 
408 |         if ($method !== $this->sseMethodInProcess) {
409 |             $message = 'The SSE method `' . $method . '` cannot be called when `' . $this->sseMethodInProcess . '` is already in process.';
410 |             if ($method === 'patchElements') {
411 |                 $message .= ' Ensure that you are not setting or removing signals inside `@patchelements` or `@executescript` directives.';
412 |             }
413 |             $this->throwException(new Exception($message));
414 |         }
415 |     }
416 | }
417 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | [![Stable Version](https://img.shields.io/packagist/v/putyourlightson/laravel-datastar?label=stable)]((https://packagist.org/packages/putyourlightson/laravel-datastar))
  2 | [![Total Downloads](https://img.shields.io/packagist/dt/putyourlightson/laravel-datastar)](https://packagist.org/packages/putyourlightson/laravel-datastar)
  3 | 
  4 | <p align="center"><img width="150" src="https://putyourlightson.com/assets/logos/datastar.svg"></p>
  5 | 
  6 | # Datastar Package for Laravel
  7 | 
  8 | ### A reactive hypermedia framework for Laravel.
  9 | 
 10 | > [!WARNING]
 11 | > Updating from a previous version? View the [release notes](https://github.com/putyourlightson/laravel-datastar/blob/develop/CHANGELOG.md).
 12 | 
 13 | This package integrates the [Datastar hypermedia framework](https://data-star.dev/) with [Laravel](https://laravel.com/), allowing you to create reactive frontends driven by Blade views _or_ controllers. It aims to replace the need for front-end frameworks such as React, Vue.js and Alpine.js + htmx, and instead lets you manage state and use logic from your Laravel backend.
 14 | 
 15 | Use-cases:
 16 | 
 17 | - Live search and filtering
 18 | - Loading more elements / Infinite scroll
 19 | - Paginating, ordering and filtering lists
 20 | - Submitting forms and running actions
 21 | - Pretty much anything to do with reactive front-ends
 22 | 
 23 | ## License
 24 | 
 25 | This package is licensed for free under the MIT License.
 26 | 
 27 | ## Requirements
 28 | 
 29 | This package requires [Laravel](https://laravel.com/) 11.0.0 or later.
 30 | 
 31 | ## Installation
 32 | 
 33 | Install manually using composer, then run the `artisan vendor:publish --tag=public` command to publish the public assets.
 34 | 
 35 | ```shell
 36 | composer require putyourlightson/laravel-datastar:^1.0.0-RC.3
 37 | 
 38 | php artisan vendor:publish --tag=public
 39 | ```
 40 | 
 41 | ## Overview
 42 | 
 43 | The Datastar package for Laravel allows you to handle backend requests by sending SSE events using [Blade directives](#blade-directives) in views _or_ [using controllers](#using-controllers). The former requires less setup and is more straightforward, while the latter provides more flexibility.
 44 | 
 45 | Here’s a trivial example that toggles some backend state using the Blade view `datastar/toggle.blade.php` to handle the request.
 46 | 
 47 | ```blade
 48 | {{-- main.blade.php --}}
 49 | 
 50 | <div data-signals:enabled="false">
 51 |     <div data-text="$enabled ? 'ON' : 'OFF'"></div>
 52 |     <button data-on:click="{{ datastar()->view('datastar.toggle') }}">
 53 |         <span id="button-text">Enable</span>
 54 |     </button>
 55 | </div>
 56 | ```
 57 | 
 58 | ```blade
 59 | {{-- datastar/toggle.blade.php --}}
 60 | 
 61 | @php
 62 |     $enabled = $signals['enabled'] ?? false;
 63 | @endphp
 64 | 
 65 | @patchsignals(['enabled' => !$enabled])
 66 | 
 67 | @patchelements
 68 |     <span id="button-text">
 69 |         {{ $enabled ? 'Enable' : 'Disable' }}
 70 |     </span>
 71 | @endpatchelements
 72 | ```
 73 | 
 74 | ## Usage
 75 | 
 76 | Start by reading the [Getting Started](https://data-star.dev/guide/getting_started) guide to learn how to use Datastar on the frontend. The Datastar package for Laravel only handles backend requests.
 77 | 
 78 | > [!TIP]
 79 | > The Datastar [VSCode extension](https://marketplace.visualstudio.com/items?itemName=starfederation.datastar-vscode) and [IntelliJ plugin](https://plugins.jetbrains.com/plugin/26072-datastar-support) have autocomplete for all `data-*` attributes.
 80 | 
 81 | When working with signals, note that you can convert a PHP array into a JSON object using the `json_encode` function.
 82 | 
 83 | ```blade
 84 | {{-- main.blade.php --}}
 85 | 
 86 | @php
 87 |     $signals = ['foo' => 1, 'bar' => 2];
 88 | @endphp
 89 | 
 90 | <div data-signals="{{ json_encode($signals) }}"></div>
 91 | ```
 92 | 
 93 | ### Datastar Helper
 94 | 
 95 | The `datastar()` helper function is available in Blade views and returns a `Datastar` helper that can be used to generate action requests to the Datastar controller. The Datastar controller can either render a view, run a controller action, or call a route, each of which respond by sending an event stream containing zero or more SSE events. 
 96 | 
 97 | [Signals](#signals) are also sent as part of the request, and are made available in Datastar views using the `$signals` variable.
 98 | 
 99 | #### `datastar()->view()`
100 | 
101 | Returns a `@get()` action request to render a view. The value should be a dot-separated path to a Blade view.
102 | 
103 | ```blade
104 | // Sends a `GET` request that renders a Blade view
105 | {{ datastar()->view('path.to.view') }}
106 | ```
107 | 
108 | Variables can be passed in as a second argument, that will be available in the rendered view.
109 | 
110 | > [!WARNING]
111 | > Variables are tamper-proof yet visible in the source code in plain text, so you should avoid passing in any sensitive data.
112 | > Only primitive data types can be used as variables: **strings**, **numbers**, **booleans** and **arrays**. Objects and models _cannot_ be used.
113 | 
114 | ```blade
115 | // Sends a `GET` request that renders a Blade view
116 | {{ datastar()->view('path.to.view', ['foo' => 'bar']) }}
117 | ```
118 | 
119 | Options can be passed into the `@get()` action using a third argument. 
120 | 
121 | ```blade
122 | // Sends a `GET` request that renders a Blade view
123 | {{ datastar()->view('path.to.view', ['foo' => 'bar'], ['contentType' => 'form']) }}
124 | ```
125 | 
126 | #### `datastar()->action()`
127 | 
128 | Returns a `@post()` action request to run a controller action. The value should be an array with a controller class name as the first value and an action name as the second. A CSRF token is automatically generated and sent along with the request.
129 | 
130 | ```blade
131 | // Sends a `POST` request that runs a controller action
132 | {{ datastar()->action(['MyController', 'update']) }}
133 | ```
134 | 
135 | Params can be passed in as a second argument, that will be available as arguments to the controller action
136 | 
137 | > [!WARNING]
138 | > Params are tamper-proof yet visible in the source code in plain text, so you should avoid passing in any sensitive data.
139 | > Only primitive data types can be used as params: **strings**, **numbers**, **booleans** and **arrays**. Objects and models _cannot_ be used. Route-model binding works with controller actions.
140 | 
141 | ```blade
142 | // Sends a `POST` request that runs a controller action
143 | {{ datastar()->action(['MyController', 'update'], ['foo' => 'bar']) }}
144 | ```
145 | 
146 | Options can be passed into the `@get()` action using a third argument. 
147 | 
148 | ```blade
149 | // Sends a `POST` request that runs a controller action
150 | {{ datastar()->action(['MyController', 'update'], ['foo' => 'bar'], ['contentType' => 'form']) }}
151 | ```
152 | 
153 | #### `datastar()->get()`
154 | 
155 | Returns a `@get()` action request that calls a route. The value must be a defined route.
156 | 
157 | ```blade
158 | // Sends a `GET` request to a route
159 | {{ datastar()->get('/uri') }}
160 | ```
161 | 
162 | Options can be passed into the `@get()` action using a second argument. 
163 | 
164 | ```blade
165 | // Sends a `GET` request to a route
166 | {{ datastar()->get('/uri', ['contentType' => 'form']) }}
167 | ```
168 | 
169 | #### `datastar()->post()`
170 | 
171 | Works the same as [`datastar()->get()`](#datastar-get) but returns a `@post()` action request that calls a route. A CSRF token is automatically generated and sent along with the request.
172 | 
173 | ```blade
174 | // Sends a `POST` request to a route
175 | {{ datastar()->post('/uri') }}
176 | ```
177 | 
178 | #### `datastar()->put()`
179 | 
180 | Works the same as [`datastar()->post()`](#datastar-post) but returns a `@put()` action request that calls a route.
181 | 
182 | ```blade
183 | // Sends a `PUT` request to a route
184 | {{ datastar()->put('/uri') }}
185 | ```
186 | 
187 | #### `datastar()->patch()`
188 | 
189 | Works the same as [`datastar()->post()`](#datastar-post) but returns a `@patch()` action request that calls a route.
190 | 
191 | ```blade
192 | // Sends a `PATCH` request to a route
193 | {{ datastar()->patch('/uri') }}
194 | ```
195 | 
196 | #### `datastar()->delete()`
197 | 
198 | Works the same as [`datastar()->post()`](#datastar-post) but returns a `@delete()` action request that calls a route.
199 | 
200 | ```blade
201 | // Sends a `DELETE` request to a route
202 | {{ datastar()->delete('/uri') }}
203 | ```
204 | 
205 | ### Blade Directives
206 | 
207 | Datastar Blade directives can patch and remove elements, patch signals, execute JavaScript and redirect the browser.
208 | 
209 | #### Patch Elements
210 | 
211 | The `@patchelements` directive allows you to [patch elements](https://data-star.dev/guide/getting_started#patching-elements) into the DOM.
212 | 
213 | ```blade
214 | {{-- main.blade.php --}}
215 | 
216 | <div id="results"></div>
217 | 
218 | <div id="search">
219 |     <button data-on:click="{{ datastar()->view('datastar.search') }}">
220 |         Search
221 |     </button>
222 | </div>
223 | ```
224 | 
225 | ```blade
226 | {{-- datastar/search.blade.php --}}
227 | 
228 | @patchelements
229 |     <div id="results">
230 |         ...
231 |     </div>
232 | @endpatchelements
233 | 
234 | @patchelements
235 |     <div id="search">
236 |         Search complete!
237 |     </div>
238 | @endpatchelements
239 | ```
240 | 
241 | This will swap the elements with the IDs `results` and `search` into the DOM. Note that elements with those IDs **must** already exist in the DOM, unless a mode is specified (see below).
242 | 
243 | ##### Element Patch Options
244 | 
245 | Elements are patched into the DOM based on element IDs, by default. It’s possible to pass other modes and other [element patch options](https://data-star.dev/reference/sse_events#datastar-patch-elements) in as an argument.
246 | 
247 | ```blade
248 | @patchelements(['selector' => '#list', 'mode' => 'append'])
249 |     <li>A new list item</li>
250 | @endpatchelements
251 | ```
252 | 
253 | ##### Automatic Element Patching
254 | 
255 | Any elements output in a Datastar template (outside any `@patchelements` tags) will be automatically wrapped in a `@patchelements` directive. This makes it possible to write your views in a way that makes them more reusable.
256 | 
257 | ```blade
258 | {{-- datastar/search.blade.php --}}
259 | 
260 | <div id="results"></div>
261 | ```
262 | 
263 | The view above is the equivalent of writing:
264 | 
265 | ```blade
266 | {{-- datastar/search.blade.php --}}
267 | 
268 | @patchelements
269 |     <div id="results"></div>
270 | @endpatchelements
271 | ```
272 | 
273 | While automatic element patching is convenient, it is less explicit and more restrictive (since [element patch options](#element-patch-options) cannot be used), so should only be used when appropriate.
274 | 
275 | #### Remove Elements
276 | 
277 | Elements can be removed from the DOM using the `@removeelements` directive, which accepts a CSS selector.
278 | 
279 | ```blade
280 | @removeelements('#list')
281 | ```
282 | 
283 | #### Patch Signals
284 | 
285 | The `@patchsignals` directive allows you to [patch signals](https://data-star.dev/guide/reactive_signals#patching-signals) into the frontend signals.
286 | 
287 | > [!NOTE]
288 | > Signals patches **cannot** be wrapped in `@patchelements` directives, since each patch creates a server-sent event which will conflict with the element’s contents.
289 | 
290 | ```blade
291 | {{- Sets the value of the `username` signal. -}}
292 | @patchsignals(['username' => 'johnny'])
293 | 
294 | {{- Sets multiple signal values using an array of key-value pairs. -}}
295 | @patchsignals(['username' => 'bobby', 'success' => true])
296 | 
297 | {{- Removes the `username` signal by setting it to `null`. -}}
298 | @patchsignals(['username' => null])
299 | ```
300 | 
301 | #### Signal Patch Options
302 | 
303 | It’s possible to pass [signal patch options](https://data-star.dev/reference/sse_events#datastar-patch-signals) in as a second argument.
304 | 
305 | ```blade
306 | @patchsignals(['username' => 'johnny'], ['onlyIfMissing' => true])
307 | ```
308 | 
309 | ### Executing JavaScript
310 | 
311 | The `@executescript` directive allows you to send JavaScript to the browser to be executed on the front-end.
312 | 
313 | ```blade
314 | @executescript
315 |     alert('Username is valid');
316 | @endexecutescript
317 | ```
318 | 
319 | #### Execute Script Options
320 | 
321 | It’s possible to pass execute script options in as an argument. They are applied to the `<script>` tag that is appended to the DOM.
322 | 
323 | ```blade
324 | @executescript(['autoRemove' => true, 'attributes' => ['defer' => true]])
325 |     alert('Username is valid');
326 | @endexecutescript
327 | ```
328 | 
329 | ### Redirecting
330 | 
331 | The `@location` directive allows you to redirect the page by updating `window.location` on the front-end.
332 | 
333 | ```blade
334 | @location('/guide')
335 | ```
336 | 
337 | #### Location Options
338 | 
339 | It’s possible to pass location options in as a second argument. They are applied to the `<script>` tag that is appended to the DOM.
340 | 
341 | ```blade
342 | @location('/guide', ['autoRemove' => true, 'attributes' => ['defer' => true]])
343 | ```
344 | 
345 | ### Using Controllers
346 | 
347 | You can send SSE events from your own controller using the `sse()` helper. No routes are required, as Datastar will handle routing to the controller action you specify when using the [Datastar helper](#datastar-helper).
348 | 
349 | ```blade
350 | {{-- main.blade.php --}}
351 | 
352 | // Sends a `POST` request that runs a controller action
353 | {{ datastar()->action(['MyController', 'update']) }}
354 | ```
355 | 
356 | ```php
357 | namespace App\Http\Controllers;
358 | 
359 | use Illuminate\Routing\Controller;
360 | use Symfony\Component\HttpFoundation\StreamedResponse;
361 | 
362 | class MyController extends Controller
363 | {
364 |     public function index(): StreamedResponse
365 |     {
366 |         $signals = sse()->readSignals();
367 | 
368 |         $enabled = $signals['enabled'] ?? false;
369 | 
370 |         sse()->patchSignals(['enabled' => !$enabled]);
371 | 
372 |         sse()->patchElements('
373 |             <span id="button-text">' . ($enabled ? 'Enable' : 'Disable') . '</span>
374 |         ');
375 |         
376 |         return sse()->getEventStream();
377 |     }
378 |     
379 |     public function view(): StreamedResponse
380 |     {
381 |         sse()->renderView('path.to.view');
382 |         
383 |         return sse()->getEventStream();
384 |     }
385 | }
386 | ```
387 | 
388 | Controller actions _must_ return a `StreamedResponse` created using the `getEventStream()` method.
389 | 
390 | ### `sse()` Helper
391 | 
392 | The `sse()` helper provides methods to patch elements, patch signals, execute scripts, redirect the browser and render Datastar views.
393 | 
394 | #### `patchElements()`
395 | 
396 | Patches elements into the DOM. Accepts [element patch options](#element-patch-options) as an optional second argument.
397 | 
398 | ```php
399 | sse()->patchElements('<div id="new-element">New element</div>');
400 | ```
401 | 
402 | #### `removeElements()`
403 | 
404 | Removes elements that match the provided selector from the DOM.
405 | 
406 | ```php
407 | sse()->removeElements('#list');
408 | ```
409 | 
410 | #### `patchSignals()`
411 | 
412 | Patches signals into the frontend. Accepts [signal patch options](#signal-patch-options) as an optional second argument.
413 | 
414 | ```php
415 | sse()->patchSignals(['foo' => 1, 'bar' => 2]);
416 | ```
417 | 
418 | #### `executeScript()`
419 | 
420 | Executes JavaScript in the browser. Accepts [execute script options](#execute-script-options) as an optional second argument, which are applied to the `<script>` tag that is appended to the DOM.
421 | 
422 | ```php
423 | sse()->executeScript('alert("Hello, world!")');
424 | ```
425 | 
426 | #### `location()`
427 | 
428 | Redirects the browser by setting the location to the provided URI. Accepts [location options](#location-options) as an optional second argument, which are applied to the `<script>` tag that is appended to the DOM.
429 | 
430 | ```php
431 | sse()->location('/guide');
432 | ```
433 | 
434 | #### `renderView()`
435 | 
436 | Renders a Datastar view. Accepts the view path as the first argument and an optional array of variables as the second argument. The Blade view should output Datastar directives.
437 | 
438 | ```php
439 | sse()->renderView('datastar.toggle', ['enabled' => true]);
440 | ```
441 | 
442 | ### Signals
443 | 
444 | Signals can be accessed within views rendered by Datastar using the signals variable, which is an array of signals received by the request that is automatically injected into the template.
445 | 
446 | > [!NOTE]
447 | > Signals patches **cannot** be wrapped in `@patchelements` directives, since each patch creates a server-sent event which will conflict with the element’s contents.
448 | 
449 | ```blade
450 | <input data-bind:username>
451 | <button data-on:click="{{ datastar()->get('path.to.view') }}">
452 |     Check
453 | </button>
454 | ```
455 | 
456 | ```blade
457 | @php
458 |     $username = $signals['username'];
459 | @endphp
460 | ```
461 | 
462 | If you ever need to read the signals in a request that is *not* handled by the Datastar package, you can do so as follows.
463 | 
464 | ```php
465 | @php
466 |     $signals = sse()->readSignals();
467 | @endphp
468 | ```
469 | 
470 | ---
471 | 
472 | Created by [PutYourLightsOn](https://putyourlightson.com/).
473 | 


--------------------------------------------------------------------------------
/public/datastar/1.0.0-RC.6/datastar.js:
--------------------------------------------------------------------------------
 1 | // Datastar v1.0.0-RC.6
 2 | var nt=/🖕JS_DS🚀/.source,De=nt.slice(0,5),Ve=nt.slice(4),q="datastar-fetch",z="datastar-signal-patch";var de=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/([a-z])([0-9]+)/gi,"$1-$2").replace(/([0-9]+)([a-z])/gi,"$1-$2").toLowerCase();var rt=e=>de(e).replace(/-/g,"_");var re=e=>{try{return JSON.parse(e)}catch{return Function(`return (${e})`)()}},st={camel:e=>e.replace(/-[a-z]/g,t=>t[1].toUpperCase()),snake:e=>e.replace(/-/g,"_"),pascal:e=>e[0].toUpperCase()+st.camel(e.slice(1))},R=(e,t,n="camel")=>{for(let r of t.get("case")||[n])e=st[r]?.(e)||e;return e},Q=e=>`data-${e}`;var _=Object.hasOwn??Object.prototype.hasOwnProperty.call;var se=e=>e!==null&&typeof e=="object"&&(Object.getPrototypeOf(e)===Object.prototype||Object.getPrototypeOf(e)===null),it=e=>{for(let t in e)if(_(e,t))return!1;return!0},Z=(e,t)=>{for(let n in e){let r=e[n];se(r)||Array.isArray(r)?Z(r,t):e[n]=t(r)}},Te=e=>{let t={};for(let[n,r]of e){let s=n.split("."),i=s.pop(),a=s.reduce((o,c)=>o[c]??={},t);a[i]=r}return t};var Ae=[],Ie=[],Fe=0,Re=0,$e=0,qe,G,we=0,w=()=>{Fe++},M=()=>{--Fe||(ct(),Y())},V=e=>{qe=G,G=e},I=()=>{G=qe,qe=void 0},me=e=>It.bind(0,{previousValue:e,t:e,e:1}),Ge=Symbol("computed"),Ne=e=>{let t=$t.bind(0,{e:17,getter:e});return t[Ge]=1,t},E=e=>{let t={d:e,e:2};G&&Be(t,G),V(t),w();try{t.d()}finally{M(),I()}return dt.bind(0,t)},ct=()=>{for(;Re<$e;){let e=Ie[Re];Ie[Re++]=void 0,ut(e,e.e&=-65)}Re=0,$e=0},ot=e=>"getter"in e?lt(e):ft(e,e.t),lt=e=>{V(e),mt(e);try{let t=e.t;return t!==(e.t=e.getter(t))}finally{I(),pt(e)}},ft=(e,t)=>(e.e=1,e.previousValue!==(e.previousValue=t)),je=e=>{let t=e.e;if(!(t&64)){e.e=t|64;let n=e.r;n?je(n.o):Ie[$e++]=e}},ut=(e,t)=>{if(t&16||t&32&&gt(e.s,e)){V(e),mt(e),w();try{e.d()}finally{M(),I(),pt(e)}return}t&32&&(e.e=t&-33);let n=e.s;for(;n;){let r=n.c,s=r.e;s&64&&ut(r,r.e=s&-65),n=n.i}},It=(e,...t)=>{if(t.length){if(e.t!==(e.t=t[0])){e.e=17;let r=e.r;return r&&(qt(r),Fe||ct()),!0}return!1}let n=e.t;if(e.e&16&&ft(e,n)){let r=e.r;r&&Le(r)}return G&&Be(e,G),n},$t=e=>{let t=e.e;if(t&16||t&32&&gt(e.s,e)){if(lt(e)){let n=e.r;n&&Le(n)}}else t&32&&(e.e=t&-33);return G&&Be(e,G),e.t},dt=e=>{let t=e.s;for(;t;)t=xe(t,e);let n=e.r;n&&xe(n),e.e=0},Be=(e,t)=>{let n=t.a;if(n&&n.c===e)return;let r=n?n.i:t.s;if(r&&r.c===e){r.m=we,t.a=r;return}let s=e.p;if(s&&s.m===we&&s.o===t)return;let i=t.a=e.p={m:we,c:e,o:t,l:n,i:r,f:s};r&&(r.l=i),n?n.i=i:t.s=i,s?s.n=i:e.r=i},xe=(e,t=e.o)=>{let n=e.c,r=e.l,s=e.i,i=e.n,a=e.f;if(s?s.l=r:t.a=r,r?r.i=s:t.s=s,i?i.f=a:n.p=a,a)a.n=i;else if(!(n.r=i))if("getter"in n){let o=n.s;if(o){n.e=17;do o=xe(o,n);while(o)}}else"previousValue"in n||dt(n);return s},qt=e=>{let t=e.n,n;e:for(;;){let r=e.o,s=r.e;if(s&60?s&12?s&4?!(s&48)&&Gt(e,r)?(r.e=s|40,s&=1):s=0:r.e=s&-9|32:s=0:r.e=s|32,s&2&&je(r),s&1){let i=r.r;if(i){let a=(e=i).n;a&&(n={t,u:n},t=a);continue}}if(e=t){t=e.n;continue}for(;n;)if(e=n.t,n=n.u,e){t=e.n;continue e}break}},mt=e=>{we++,e.a=void 0,e.e=e.e&-57|4},pt=e=>{let t=e.a,n=t?t.i:e.s;for(;n;)n=xe(n,e);e.e&=-5},gt=(e,t)=>{let n,r=0,s=!1;e:for(;;){let i=e.c,a=i.e;if(t.e&16)s=!0;else if((a&17)===17){if(ot(i)){let o=i.r;o.n&&Le(o),s=!0}}else if((a&33)===33){(e.n||e.f)&&(n={t:e,u:n}),e=i.s,t=i,++r;continue}if(!s){let o=e.i;if(o){e=o;continue}}for(;r--;){let o=t.r,c=o.n;if(c?(e=n.t,n=n.u):e=o,s){if(ot(t)){c&&Le(o),t=e.o;continue}s=!1}else t.e&=-33;if(t=e.o,e.i){e=e.i;continue e}}return s}},Le=e=>{do{let t=e.o,n=t.e;(n&48)===32&&(t.e=n|16,n&2&&je(t))}while(e=e.n)},Gt=(e,t)=>{let n=t.a;for(;n;){if(n===e)return!0;n=n.l}return!1},ie=e=>{let t=X,n=e.split(".");for(let r of n){if(t==null||!_(t,r))return;t=t[r]}return t},Me=(e,t="")=>{let n=Array.isArray(e);if(n||se(e)){let r=n?[]:{};for(let i in e)r[i]=me(Me(e[i],`${t+i}.`));let s=me(0);return new Proxy(r,{get(i,a){if(!(a==="toJSON"&&!_(r,a)))return n&&a in Array.prototype?(s(),r[a]):typeof a=="symbol"?r[a]:((!_(r,a)||r[a]()==null)&&(r[a]=me(""),Y(t+a,""),s(s()+1)),r[a]())},set(i,a,o){let c=t+a;if(n&&a==="length"){let l=r[a]-o;if(r[a]=o,l>0){let f={};for(let d=o;d<r[a];d++)f[d]=null;Y(t.slice(0,-1),f),s(s()+1)}}else _(r,a)?o==null?delete r[a]:_(o,Ge)?(r[a]=o,Y(c,"")):r[a](Me(o,`${c}.`))&&Y(c,o):o!=null&&(_(o,Ge)?(r[a]=o,Y(c,"")):(r[a]=me(Me(o,`${c}.`)),Y(c,o)),s(s()+1));return!0},deleteProperty(i,a){return delete r[a],s(s()+1),!0},ownKeys(){return s(),Reflect.ownKeys(r)},has(i,a){return s(),a in r}})}return e},Y=(e,t)=>{if(e!==void 0&&t!==void 0&&Ae.push([e,t]),!Fe&&Ae.length){let n=Te(Ae);Ae.length=0,document.dispatchEvent(new CustomEvent(z,{detail:n}))}},C=(e,{ifMissing:t}={})=>{w();for(let n in e)e[n]==null?t||delete X[n]:ht(e[n],n,X,"",t);M()},S=(e,t)=>C(Te(e),t),ht=(e,t,n,r,s)=>{if(se(e)){_(n,t)&&(se(n[t])||Array.isArray(n[t]))||(n[t]={});for(let i in e)e[i]==null?s||delete n[t][i]:ht(e[i],i,n[t],`${r+t}.`,s)}else s&&_(n,t)||(n[t]=e)},at=e=>typeof e=="string"?RegExp(e.replace(/^\/|\/$/g,"")):e,D=({include:e=/.*/,exclude:t=/(?!)/}={},n=X)=>{let r=at(e),s=at(t),i=[],a=[[n,""]];for(;a.length;){let[o,c]=a.pop();for(let l in o){let f=c+l;se(o[l])?a.push([o[l],`${f}.`]):r.test(f)&&!s.test(f)&&i.push([f,ie(f)])}}return Te(i)},X=Me({});var W=e=>e instanceof HTMLElement||e instanceof SVGElement||e instanceof MathMLElement;var jt="https://data-star.dev/errors",pe=(e,t,n={})=>{Object.assign(n,e);let r=new Error,s=rt(t),i=new URLSearchParams({metadata:JSON.stringify(n)}).toString(),a=JSON.stringify(n,null,2);return r.message=`${t}
 3 | More info: ${jt}/${s}?${i}
 4 | Context: ${a}`,r},Oe=new Map,vt=new Map,bt=new Map,Et=new Proxy({},{get:(e,t)=>Oe.get(t)?.apply,has:(e,t)=>Oe.has(t),ownKeys:()=>Reflect.ownKeys(Oe),set:()=>!1,deleteProperty:()=>!1}),ge=new Map,Ce=[],We=new Set,p=e=>{Ce.push(e),Ce.length===1&&setTimeout(()=>{for(let t of Ce)We.add(t.name),vt.set(t.name,t);Ce.length=0,Jt(),We.clear()})},O=e=>{Oe.set(e.name,e)};document.addEventListener(q,e=>{let t=bt.get(e.detail.type);t&&t.apply({error:pe.bind(0,{plugin:{type:"watcher",name:t.name},element:{id:e.target.id,tag:e.target.tagName}})},e.detail.argsRaw)});var he=e=>{bt.set(e.name,e)},yt=e=>{for(let t of e){let n=ge.get(t);if(ge.delete(t)){for(let r of n.values())r();n.clear()}}},St=Q("ignore"),Bt=`[${St}]`,Tt=e=>e.hasAttribute(`${St}__self`)||!!e.closest(Bt),Pe=(e,t)=>{for(let n of e)if(!Tt(n))for(let r in n.dataset)At(n,r.replace(/[A-Z]/g,"-$&").toLowerCase(),n.dataset[r],t)},Wt=e=>{for(let{target:t,type:n,attributeName:r,addedNodes:s,removedNodes:i}of e)if(n==="childList"){for(let a of i)W(a)&&(yt([a]),yt(a.querySelectorAll("*")));for(let a of s)W(a)&&(Pe([a]),Pe(a.querySelectorAll("*")))}else if(n==="attributes"&&r.startsWith("data-")&&W(t)&&!Tt(t)){let a=r.slice(5),o=t.getAttribute(r);if(o===null){let c=ge.get(t);c&&(c.get(a)?.(),c.delete(a))}else At(t,a,o)}},Ut=new MutationObserver(Wt),Jt=(e=document.documentElement)=>{W(e)&&Pe([e],!0),Pe(e.querySelectorAll("*"),!0),Ut.observe(e,{subtree:!0,childList:!0,attributes:!0})},At=(e,t,n,r)=>{{let s=t,[i,...a]=s.split("__"),[o,c]=i.split(/:(.+)/),l=vt.get(o);if((!r||We.has(o))&&l){let f={el:e,rawKey:s,mods:new Map,error:pe.bind(0,{plugin:{type:"attribute",name:l.name},element:{id:e.id,tag:e.tagName},expression:{rawKey:s,key:c,value:n}}),key:c,value:n,rx:void 0},d=l.requirement&&(typeof l.requirement=="string"?l.requirement:l.requirement.key)||"allowed",x=l.requirement&&(typeof l.requirement=="string"?l.requirement:l.requirement.value)||"allowed";if(c){if(d==="denied")throw f.error("KeyNotAllowed")}else if(d==="must")throw f.error("KeyRequired");if(n){if(x==="denied")throw f.error("ValueNotAllowed")}else if(x==="must")throw f.error("ValueRequired");if(d==="exclusive"||x==="exclusive"){if(c&&n)throw f.error("KeyAndValueProvided");if(!c&&!n)throw f.error("KeyOrValueRequired")}if(n){let m;f.rx=(...h)=>(m||(m=Kt(n,{returnsValue:l.returnsValue,argNames:l.argNames})),m(e,...h))}for(let m of a){let[h,...v]=m.split(".");f.mods.set(h,new Set(v))}let u=l.apply(f);if(u){let m=ge.get(e);m?m.get(s)?.():(m=new Map,ge.set(e,m)),m.set(s,u)}}}},Kt=(e,{returnsValue:t=!1,argNames:n=[]}={})=>{let r="";if(t){let o=/(\/(\\\/|[^/])*\/|"(\\"|[^"])*"|'(\\'|[^'])*'|`(\\`|[^`])*`|\(\s*((function)\s*\(\s*\)|(\(\s*\))\s*=>)\s*(?:\{[\s\S]*?\}|[^;){]*)\s*\)\s*\(\s*\)|[^;])+/gm,c=e.trim().match(o);if(c){let l=c.length-1,f=c[l].trim();f.startsWith("return")||(c[l]=`return (${f});`),r=c.join(`;
 5 | `)}}else r=e.trim();let s=new Map,i=RegExp(`(?:${De})(.*?)(?:${Ve})`,"gm"),a=0;for(let o of r.matchAll(i)){let c=o[1],l=`__escaped${a++}`;s.set(l,c),r=r.replace(De+c+Ve,l)}r=r.replace(/\$\['([a-zA-Z_$\d][\w$]*)'\]/g,"$$$1").replace(/\$([a-zA-Z_\d]\w*(?:[.-]\w+)*)/g,(o,c)=>c.split(".").reduce((l,f)=>`${l}['${f}']`,"$")).replace(/\[(\$[a-zA-Z_\d]\w*)\]/g,(o,c)=>`[$['${c.slice(1)}']]`),r=r.replaceAll(/@(\w+)\(/g,'__action("$1",evt,');for(let[o,c]of s)r=r.replace(o,c);try{let o=Function("el","$","__action","evt",...n,r);return(c,...l)=>{let f=(d,x,...u)=>{let m=pe.bind(0,{plugin:{type:"action",name:d},element:{id:c.id,tag:c.tagName},expression:{fnContent:r,value:e}}),h=Et[d];if(h)return h({el:c,evt:x,error:m},...u);throw m("UndefinedAction")};try{return o(c,X,f,void 0,...l)}catch(d){throw console.error(d),pe({element:{id:c.id,tag:c.tagName},expression:{fnContent:r,value:e},error:d.message},"ExecuteExpression")}}}catch(o){throw console.error(o),pe({expression:{fnContent:r,value:e},error:o.message},"GenerateExpression")}};var P=new Map,ae=new Set,oe=new Map,ye=new Set,ce=document.createElement("div");ce.hidden=!0;var ve=Q("ignore-morph"),zt=`[${ve}]`,Ke=(e,t,n="outer")=>{if(W(e)&&W(t)&&e.hasAttribute(ve)&&t.hasAttribute(ve)||e.parentElement?.closest(zt))return;let r=document.createElement("div");r.append(t),document.body.insertAdjacentElement("afterend",ce);let s=e.querySelectorAll("[id]");for(let{id:o,tagName:c}of s)oe.has(o)?ye.add(o):oe.set(o,c);e instanceof Element&&e.id&&(oe.has(e.id)?ye.add(e.id):oe.set(e.id,e.tagName)),ae.clear();let i=r.querySelectorAll("[id]");for(let{id:o,tagName:c}of i)ae.has(o)?ye.add(o):oe.get(o)===c&&ae.add(o);for(let o of ye)ae.delete(o);oe.clear(),ye.clear(),P.clear();let a=n==="outer"?e.parentElement:e;wt(a,s),wt(r,i),Mt(a,r,n==="outer"?e:null,e.nextSibling),ce.remove()},Mt=(e,t,n=null,r=null)=>{e instanceof HTMLTemplateElement&&t instanceof HTMLTemplateElement&&(e=e.content,t=t.content),n??=e.firstChild;for(let s of t.childNodes){if(n&&n!==r){let i=Qt(s,n,r);if(i){if(i!==n){let a=n;for(;a&&a!==i;){let o=a;a=a.nextSibling,Je(o)}}Ue(i,s),n=i.nextSibling;continue}}if(s instanceof Element&&ae.has(s.id)){let i=document.getElementById(s.id),a=i;for(;a=a.parentNode;){let o=P.get(a);o&&(o.delete(s.id),o.size||P.delete(a))}xt(e,i,n),Ue(i,s),n=i.nextSibling;continue}if(P.has(s)){let i=document.createElement(s.tagName);e.insertBefore(i,n),Ue(i,s),n=i.nextSibling}else{let i=document.importNode(s,!0);e.insertBefore(i,n),n=i.nextSibling}}for(;n&&n!==r;){let s=n;n=n.nextSibling,Je(s)}},Qt=(e,t,n)=>{let r=null,s=e.nextSibling,i=0,a=0,o=P.get(e)?.size||0,c=t;for(;c&&c!==n;){if(Rt(c,e)){let l=!1,f=P.get(c),d=P.get(e);if(d&&f){for(let x of f)if(d.has(x)){l=!0;break}}if(l)return c;if(!r&&!P.has(c)){if(!o)return c;r=c}}if(a+=P.get(c)?.size||0,a>o)break;r===null&&s&&Rt(c,s)&&(i++,s=s.nextSibling,i>=2&&(r=void 0)),c=c.nextSibling}return r||null},Rt=(e,t)=>e.nodeType===t.nodeType&&e.tagName===t.tagName&&(!e.id||e.id===t.id),Je=e=>{P.has(e)?xt(ce,e,null):e.parentNode?.removeChild(e)},xt=Je.call.bind(ce.moveBefore??ce.insertBefore),Zt=Q("preserve-attr"),Ue=(e,t)=>{let n=t.nodeType;if(n===1){let r=e,s=t;if(r.hasAttribute(ve)&&s.hasAttribute(ve))return e;r instanceof HTMLInputElement&&s instanceof HTMLInputElement&&s.type!=="file"?s.getAttribute("value")!==r.getAttribute("value")&&(r.value=s.getAttribute("value")??""):r instanceof HTMLTextAreaElement&&s instanceof HTMLTextAreaElement&&(s.value!==r.value&&(r.value=s.value),r.firstChild&&r.firstChild.nodeValue!==s.value&&(r.firstChild.nodeValue=s.value));let i=(t.getAttribute(Zt)??"").split(" ");for(let{name:a,value:o}of s.attributes)r.getAttribute(a)!==o&&!i.includes(a)&&r.setAttribute(a,o);for(let a=r.attributes.length-1;a>=0;a--){let{name:o}=r.attributes[a];!s.hasAttribute(o)&&!i.includes(o)&&r.removeAttribute(o)}r.isEqualNode(s)||Mt(r,s)}return(n===8||n===3)&&e.nodeValue!==t.nodeValue&&(e.nodeValue=t.nodeValue),e},wt=(e,t)=>{for(let n of t)if(ae.has(n.id)){let r=n;for(;r&&r!==e;){let s=P.get(r);s||(s=new Set,P.set(r,s)),s.add(n.id),r=r.parentElement}}};O({name:"peek",apply(e,t){V();try{return t()}finally{I()}}});O({name:"setAll",apply(e,t,n){V();let r=D(n);Z(r,()=>t),C(r),I()}});O({name:"toggleAll",apply(e,t){V();let n=D(t);Z(n,r=>!r),C(n),I()}});var He=new WeakMap,be=(e,t)=>O({name:e,apply:async({el:n,evt:r,error:s},i,{selector:a,headers:o,contentType:c="json",filterSignals:{include:l=/.*/,exclude:f=/(^|\.)_/}={},openWhenHidden:d=!1,retryInterval:x=1e3,retryScaler:u=2,retryMaxWaitMs:m=3e4,retryMaxCount:h=10,requestCancellation:v="auto"}={})=>{let L=v instanceof AbortController?v:new AbortController,A=v==="disabled";if(!A){let T=He.get(n);T&&(T.abort(),await Promise.resolve())}!A&&!(v instanceof AbortController)&&He.set(n,L);try{let T=new MutationObserver(j=>{for(let H of j)for(let B of H.removedNodes)B===n&&(L.abort(),K())});n.parentNode&&T.observe(n.parentNode,{childList:!0});let K=()=>{T.disconnect()};try{if(!i?.length)throw s("FetchNoUrlProvided",{action:O});let j={Accept:"text/event-stream, text/html, application/json","Datastar-Request":!0};c==="json"&&(j["Content-Type"]="application/json");let H=Object.assign({},j,o),B={method:t,headers:H,openWhenHidden:d,retryInterval:x,retryScaler:u,retryMaxWaitMs:m,retryMaxCount:h,signal:L.signal,onopen:async g=>{g.status>=400&&ee(Yt,n,{status:g.status.toString()})},onmessage:g=>{if(!g.event.startsWith("datastar"))return;let $=g.event,b={};for(let N of g.data.split(`
 6 | `)){let y=N.indexOf(" "),k=N.slice(0,y),ue=N.slice(y+1);(b[k]||=[]).push(ue)}let F=Object.fromEntries(Object.entries(b).map(([N,y])=>[N,y.join(`
 7 | `)]));ee($,n,F)},onerror:g=>{if(Lt(g))throw g("FetchExpectedTextEventStream",{url:i});g&&(console.error(g.message),ee(Xt,n,{message:g.message}))}},fe=new URL(i,document.baseURI),ne=new URLSearchParams(fe.search);if(c==="json"){let g=JSON.stringify(D({include:l,exclude:f}));t==="GET"?ne.set("datastar",g):B.body=g}else if(c==="form"){let g=a?document.querySelector(a):n.closest("form");if(!g)throw s("FetchFormNotFound",{action:O,selector:a});if(!g.checkValidity()){g.reportValidity(),K();return}let $=new FormData(g),b=n;if(n===g&&r instanceof SubmitEvent)b=r.submitter;else{let y=k=>k.preventDefault();g.addEventListener("submit",y),K=()=>{g.removeEventListener("submit",y),T.disconnect()}}if(b instanceof HTMLButtonElement){let y=b.getAttribute("name");y&&$.append(y,b.value)}let F=g.getAttribute("enctype")==="multipart/form-data";F||(H["Content-Type"]="application/x-www-form-urlencoded");let N=new URLSearchParams($);if(t==="GET")for(let[y,k]of N)ne.append(y,k);else F?B.body=$:B.body=N}else throw s("FetchInvalidContentType",{action:O,contentType:c});ee(ze,n,{}),fe.search=ne.toString();try{await on(fe.toString(),n,B)}catch(g){if(!Lt(g))throw s("FetchFailed",{method:t,url:i,error:g.message})}}finally{ee(Qe,n,{}),K()}}finally{He.get(n)===L&&He.delete(n)}}});be("delete","DELETE");be("get","GET");be("patch","PATCH");be("post","POST");be("put","PUT");var ze="started",Qe="finished",Yt="error",Xt="retrying",en="retries-failed",ee=(e,t,n)=>document.dispatchEvent(new CustomEvent(q,{detail:{type:e,el:t,argsRaw:n}})),Lt=e=>`${e}`.includes("text/event-stream"),tn=async(e,t)=>{let n=e.getReader(),r=await n.read();for(;!r.done;)t(r.value),r=await n.read()},nn=e=>{let t,n,r,s=!1;return i=>{t?t=sn(t,i):(t=i,n=0,r=-1);let a=t.length,o=0;for(;n<a;){s&&(t[n]===10&&(o=++n),s=!1);let c=-1;for(;n<a&&c===-1;++n)switch(t[n]){case 58:r===-1&&(r=n-o);break;case 13:s=!0;case 10:c=n;break}if(c===-1)break;e(t.subarray(o,c),r),o=n,r=-1}o===a?t=void 0:o&&(t=t.subarray(o),n-=o)}},rn=(e,t,n)=>{let r=Ft(),s=new TextDecoder;return(i,a)=>{if(!i.length)n?.(r),r=Ft();else if(a>0){let o=s.decode(i.subarray(0,a)),c=a+(i[a+1]===32?2:1),l=s.decode(i.subarray(c));switch(o){case"data":r.data=r.data?`${r.data}
 8 | ${l}`:l;break;case"event":r.event=l;break;case"id":e(r.id=l);break;case"retry":{let f=+l;Number.isNaN(f)||t(r.retry=f);break}}}}},sn=(e,t)=>{let n=new Uint8Array(e.length+t.length);return n.set(e),n.set(t,e.length),n},Ft=()=>({data:"",event:"",id:"",retry:void 0}),on=(e,t,{signal:n,headers:r,onopen:s,onmessage:i,onclose:a,onerror:o,openWhenHidden:c,fetch:l,retryInterval:f=1e3,retryScaler:d=2,retryMaxWaitMs:x=3e4,retryMaxCount:u=10,overrides:m,...h})=>new Promise((v,L)=>{let A={...r},T,K=()=>{T.abort(),document.hidden||$()};c||document.addEventListener("visibilitychange",K);let j=0,H=()=>{document.removeEventListener("visibilitychange",K),clearTimeout(j),T.abort()};n?.addEventListener("abort",()=>{H(),v()});let B=l||window.fetch,fe=s||(()=>{}),ne=0,g=f,$=async()=>{T=new AbortController;try{let b=await B(e,{...h,headers:A,signal:T.signal});ne=0,f=g,await fe(b);let F=async(y,k,ue,Ee,...Vt)=>{let tt={[ue]:await k.text()};for(let ke of Vt){let _e=k.headers.get(`datastar-${de(ke)}`);if(Ee){let Se=Ee[ke];Se&&(_e=typeof Se=="string"?Se:JSON.stringify(Se))}_e&&(tt[ke]=_e)}ee(y,t,tt),H(),v()},N=b.headers.get("Content-Type");if(N?.includes("text/html"))return await F("datastar-patch-elements",b,"elements",m,"selector","mode","useViewTransition");if(N?.includes("application/json"))return await F("datastar-patch-signals",b,"signals",m,"onlyIfMissing");if(N?.includes("text/javascript")){let y=document.createElement("script"),k=b.headers.get("datastar-script-attributes");if(k)for(let[ue,Ee]of Object.entries(JSON.parse(k)))y.setAttribute(ue,Ee);y.textContent=await b.text(),document.head.appendChild(y),H();return}await tn(b.body,nn(rn(y=>{y?A["last-event-id"]=y:delete A["last-event-id"]},y=>{g=f=y},i))),a?.(),H(),v()}catch(b){if(!T.signal.aborted)try{let F=o?.(b)||f;clearTimeout(j),j=setTimeout($,F),f=Math.min(f*d,x),++ne>=u?(ee(en,t,{}),H(),L("Max retries reached.")):console.error(`Datastar failed to reach ${e.toString()} retrying in ${F}ms.`)}catch(F){H(),L(F)}}};$()});p({name:"attr",requirement:{value:"must"},returnsValue:!0,apply({el:e,key:t,rx:n}){let r=(o,c)=>{c===""||c===!0?e.setAttribute(o,""):c===!1||c==null?e.removeAttribute(o):typeof c=="string"?e.setAttribute(o,c):e.setAttribute(o,JSON.stringify(c))},s=t?()=>{i.disconnect();let o=n();r(t,o),i.observe(e,{attributeFilter:[t]})}:()=>{i.disconnect();let o=n(),c=Object.keys(o);for(let l of c)r(l,o[l]);i.observe(e,{attributeFilter:c})},i=new MutationObserver(s),a=E(s);return()=>{i.disconnect(),a()}}});var an=/^data:(?<mime>[^;]+);base64,(?<contents>.*)$/,Nt=Symbol("empty"),Ct=Q("bind");p({name:"bind",requirement:"exclusive",apply({el:e,key:t,mods:n,value:r,error:s}){let i=t!=null?R(t,n):r,a=(u,m)=>m==="number"?+u.value:u.value,o=u=>{e.value=`${u}`};if(e instanceof HTMLInputElement)switch(e.type){case"range":case"number":a=(u,m)=>m==="string"?u.value:+u.value;break;case"checkbox":a=(u,m)=>u.value!=="on"?m==="boolean"?u.checked:u.checked?u.value:"":m==="string"?u.checked?u.value:"":u.checked,o=u=>{e.checked=typeof u=="string"?u===e.value:u};break;case"radio":e.getAttribute("name")?.length||e.setAttribute("name",i),a=(u,m)=>u.checked?m==="number"?+u.value:u.value:Nt,o=u=>{e.checked=u===(typeof u=="number"?+e.value:e.value)};break;case"file":{let u=()=>{let m=[...e.files||[]],h=[];Promise.all(m.map(v=>new Promise(L=>{let A=new FileReader;A.onload=()=>{if(typeof A.result!="string")throw s("InvalidFileResultType",{resultType:typeof A.result});let T=A.result.match(an);if(!T?.groups)throw s("InvalidDataUri",{result:A.result});h.push({name:v.name,contents:T.groups.contents,mime:T.groups.mime})},A.onloadend=()=>L(),A.readAsDataURL(v)}))).then(()=>{S([[i,h]])})};return e.addEventListener("change",u),e.addEventListener("input",u),()=>{e.removeEventListener("change",u),e.removeEventListener("input",u)}}}else if(e instanceof HTMLSelectElement){if(e.multiple){let u=new Map;a=m=>[...m.selectedOptions].map(h=>{let v=u.get(h.value);return v==="string"||v==null?h.value:+h.value}),o=m=>{for(let h of e.options)m.includes(h.value)?(u.set(h.value,"string"),h.selected=!0):m.includes(+h.value)?(u.set(h.value,"number"),h.selected=!0):h.selected=!1}}}else e instanceof HTMLTextAreaElement||(a=u=>"value"in u?u.value:u.getAttribute("value"),o=u=>{"value"in e?e.value=u:e.setAttribute("value",u)});let c=ie(i),l=typeof c,f=i;if(Array.isArray(c)&&!(e instanceof HTMLSelectElement&&e.multiple)){let u=t||r,m=document.querySelectorAll(`[${Ct}\\:${CSS.escape(u)}],[${Ct}="${CSS.escape(u)}"]`),h=[],v=0;for(let L of m){if(h.push([`${f}.${v}`,a(L,"none")]),e===L)break;v++}S(h,{ifMissing:!0}),f=`${f}.${v}`}else S([[f,a(e,l)]],{ifMissing:!0});let d=()=>{let u=ie(f);if(u!=null){let m=a(e,typeof u);m!==Nt&&S([[f,m]])}};e.addEventListener("input",d),e.addEventListener("change",d);let x=E(()=>{o(ie(f))});return()=>{x(),e.removeEventListener("input",d),e.removeEventListener("change",d)}}});p({name:"class",requirement:{value:"must"},returnsValue:!0,apply({key:e,el:t,mods:n,rx:r}){e&&(e=R(e,n,"kebab"));let s=()=>{i.disconnect();let o=e?{[e]:r()}:r();for(let c in o){let l=c.split(/\s+/).filter(f=>f.length>0);if(o[c])for(let f of l)t.classList.contains(f)||t.classList.add(f);else for(let f of l)t.classList.contains(f)&&t.classList.remove(f)}i.observe(t,{attributeFilter:["class"]})},i=new MutationObserver(s),a=E(s);return()=>{i.disconnect(),a();let o=e?{[e]:r()}:r();for(let c in o){let l=c.split(/\s+/).filter(f=>f.length>0);for(let f of l)t.classList.remove(f)}}}});p({name:"computed",requirement:{value:"must"},returnsValue:!0,apply({key:e,mods:t,rx:n,error:r}){if(e)S([[R(e,t),Ne(n)]]);else{let s=Object.assign({},n());Z(s,i=>{if(typeof i=="function")return Ne(i);throw r("ComputedExpectedFunction")}),C(s)}}});p({name:"effect",requirement:{key:"denied",value:"must"},apply:({rx:e})=>E(e)});p({name:"indicator",requirement:"exclusive",apply({el:e,key:t,mods:n,value:r}){let s=t!=null?R(t,n):r;S([[s,!1]]);let i=a=>{let{type:o,el:c}=a.detail;if(c===e)switch(o){case ze:S([[s,!0]]);break;case Qe:S([[s,!1]]);break}};return document.addEventListener(q,i),()=>{S([[s,!1]]),document.removeEventListener(q,i)}}});p({name:"json-signals",requirement:{key:"denied"},apply({el:e,value:t,mods:n}){let r=n.has("terse")?0:2,s={};t&&(s=re(t));let i=()=>{a.disconnect(),e.textContent=JSON.stringify(D(s),null,r),a.observe(e,{childList:!0,characterData:!0,subtree:!0})},a=new MutationObserver(i),o=E(i);return()=>{a.disconnect(),o()}}});var U=e=>{if(!e||e.size<=0)return 0;for(let t of e){if(t.endsWith("ms"))return+t.replace("ms","");if(t.endsWith("s"))return+t.replace("s","")*1e3;try{return Number.parseFloat(t)}catch{}}return 0},te=(e,t,n=!1)=>e?e.has(t.toLowerCase()):n;var Ze=(e,t)=>(...n)=>{setTimeout(()=>{e(...n)},t)},cn=(e,t,n=!1,r=!0)=>{let s=0;return(...i)=>{s&&clearTimeout(s),n&&!s&&e(...i),s=setTimeout(()=>{r&&e(...i),s&&clearTimeout(s),s=0},t)}},ln=(e,t,n=!0,r=!1)=>{let s=!1;return(...i)=>{s||(n&&e(...i),s=!0,setTimeout(()=>{r&&e(...i),s=!1},t))}},le=(e,t)=>{let n=t.get("delay");if(n){let i=U(n);e=Ze(e,i)}let r=t.get("debounce");if(r){let i=U(r),a=te(r,"leading",!1),o=!te(r,"notrailing",!1);e=cn(e,i,a,o)}let s=t.get("throttle");if(s){let i=U(s),a=!te(s,"noleading",!1),o=te(s,"trailing",!1);e=ln(e,i,a,o)}return e};var Ye=!!document.startViewTransition,J=(e,t)=>{if(t.has("viewtransition")&&Ye){let n=e;e=(...r)=>document.startViewTransition(()=>n(...r))}return e};p({name:"on",requirement:"must",argNames:["evt"],apply({el:e,key:t,mods:n,rx:r}){let s=e;n.has("window")&&(s=window);let i=c=>{c&&(n.has("prevent")&&c.preventDefault(),n.has("stop")&&c.stopPropagation()),w(),r(c),M()};i=J(i,n),i=le(i,n);let a={capture:n.has("capture"),passive:n.has("passive"),once:n.has("once")};if(n.has("outside")){s=document;let c=i;i=l=>{e.contains(l?.target)||c(l)}}let o=R(t,n,"kebab");if((o===q||o===z)&&(s=document),e instanceof HTMLFormElement&&o==="submit"){let c=i;i=l=>{l?.preventDefault(),c(l)}}return s.addEventListener(o,i,a),()=>{s.removeEventListener(o,i)}}});var Xe=new WeakSet;p({name:"on-intersect",requirement:{key:"denied",value:"must"},apply({el:e,mods:t,rx:n}){let r=()=>{w(),n(),M()};r=J(r,t),r=le(r,t);let s={threshold:0};t.has("full")?s.threshold=1:t.has("half")&&(s.threshold=.5);let i=new IntersectionObserver(a=>{for(let o of a)o.isIntersecting&&(r(),i&&Xe.has(e)&&i.disconnect())},s);return i.observe(e),t.has("once")&&Xe.add(e),()=>{t.has("once")||Xe.delete(e),i&&(i.disconnect(),i=null)}}});p({name:"on-interval",requirement:{key:"denied",value:"must"},apply({mods:e,rx:t}){let n=()=>{w(),t(),M()};n=J(n,e);let r=1e3,s=e.get("duration");s&&(r=U(s),te(s,"leading",!1)&&n());let i=setInterval(n,r);return()=>{clearInterval(i)}}});p({name:"init",requirement:{key:"denied",value:"must"},apply({rx:e,mods:t}){let n=()=>{w(),e(),M()};n=J(n,t);let r=0,s=t.get("delay");s&&(r=U(s),r>0&&(n=Ze(n,r))),n()}});p({name:"on-signal-patch",requirement:{value:"must"},argNames:["patch"],returnsValue:!0,apply({el:e,key:t,mods:n,rx:r,error:s}){if(t&&t!=="filter")throw s("KeyNotAllowed");let i=e.getAttribute("data-on-signal-patch-filter"),a={};i&&(a=re(i));let o=le(c=>{let l=D(a,c.detail);it(l)||(w(),r(l),M())},n);return document.addEventListener(z,o),()=>{document.removeEventListener(z,o)}}});p({name:"ref",requirement:"exclusive",apply({el:e,key:t,mods:n,value:r}){let s=t!=null?R(t,n):r;S([[s,e]])}});var Ot="none",Pt="display";p({name:"show",requirement:{key:"denied",value:"must"},returnsValue:!0,apply({el:e,rx:t}){let n=()=>{r.disconnect(),t()?e.style.display===Ot&&e.style.removeProperty(Pt):e.style.setProperty(Pt,Ot),r.observe(e,{attributeFilter:["style"]})},r=new MutationObserver(n),s=E(n);return()=>{r.disconnect(),s()}}});p({name:"signals",returnsValue:!0,apply({key:e,mods:t,rx:n}){let r=t.has("ifmissing");if(e)e=R(e,t),S([[e,n?.()]],{ifMissing:r});else{let s=Object.assign({},n?.());C(s,{ifMissing:r})}}});p({name:"style",requirement:{value:"must"},returnsValue:!0,apply({key:e,el:t,rx:n}){let{style:r}=t,s=new Map,i=(l,f)=>{let d=s.get(l);!f&&f!==0?d!==void 0&&(d?r.setProperty(l,d):r.removeProperty(l)):(d===void 0&&s.set(l,r.getPropertyValue(l)),r.setProperty(l,String(f)))},a=()=>{if(o.disconnect(),e)i(e,n());else{let l=n();for(let[f,d]of s)f in l||(d?r.setProperty(f,d):r.removeProperty(f));for(let f in l)i(de(f),l[f])}o.observe(t,{attributeFilter:["style"]})},o=new MutationObserver(a),c=E(a);return()=>{o.disconnect(),c();for(let[l,f]of s)f?r.setProperty(l,f):r.removeProperty(l)}}});p({name:"text",requirement:{key:"denied",value:"must"},returnsValue:!0,apply({el:e,rx:t}){let n=()=>{r.disconnect(),e.textContent=`${t()}`,r.observe(e,{childList:!0,characterData:!0,subtree:!0})},r=new MutationObserver(n),s=E(n);return()=>{r.disconnect(),s()}}});he({name:"datastar-patch-elements",apply(e,{elements:t="",selector:n="",mode:r="outer",useViewTransition:s}){switch(r){case"remove":case"outer":case"inner":case"replace":case"prepend":case"append":case"before":case"after":break;default:throw e.error("PatchElementsInvalidMode",{mode:r})}if(!n&&r!=="outer"&&r!=="replace")throw e.error("PatchElementsExpectedSelector");let i={mode:r,selector:n,elements:t,useViewTransition:s?.trim()==="true"};Ye&&s?document.startViewTransition(()=>Ht(e,i)):Ht(e,i)}});var Ht=({error:e},{elements:t,selector:n,mode:r})=>{let s=t.replace(/<svg(\s[^>]*>|>)([\s\S]*?)<\/svg>/gim,""),i=/<\/html>/.test(s),a=/<\/head>/.test(s),o=/<\/body>/.test(s),c=new DOMParser().parseFromString(i||a||o?t:`<body><template>${t}</template></body>`,"text/html"),l=document.createDocumentFragment();if(i?l.appendChild(c.documentElement):a&&o?(l.appendChild(c.head),l.appendChild(c.body)):a?l.appendChild(c.head):o?l.appendChild(c.body):l=c.querySelector("template").content,!n&&(r==="outer"||r==="replace"))for(let f of l.children){let d;if(f instanceof HTMLHtmlElement)d=document.documentElement;else if(f instanceof HTMLBodyElement)d=document.body;else if(f instanceof HTMLHeadElement)d=document.head;else if(d=document.getElementById(f.id),!d){console.warn(e("PatchElementsNoTargetsFound"),{element:{id:f.id}});continue}_t(r,f,[d])}else{let f=document.querySelectorAll(n);if(!f.length){console.warn(e("PatchElementsNoTargetsFound"),{selector:n});return}_t(r,l,f)}},et=new WeakSet;for(let e of document.querySelectorAll("script"))et.add(e);var Dt=e=>{let t=e instanceof HTMLScriptElement?[e]:e.querySelectorAll("script");for(let n of t)if(!et.has(n)){let r=document.createElement("script");for(let{name:s,value:i}of n.attributes)r.setAttribute(s,i);r.text=n.text,n.replaceWith(r),et.add(r)}},kt=(e,t,n)=>{for(let r of e){let s=t.cloneNode(!0);Dt(s),r[n](s)}},_t=(e,t,n)=>{switch(e){case"remove":for(let r of n)r.remove();break;case"outer":case"inner":for(let r of n)Ke(r,t.cloneNode(!0),e),Dt(r);break;case"replace":kt(n,t,"replaceWith");break;case"prepend":case"append":case"before":case"after":kt(n,t,e)}};he({name:"datastar-patch-signals",apply({error:e},{signals:t,onlyIfMissing:n}){if(t){let r=n?.trim()==="true";C(re(t),{ifMissing:r})}else throw e("PatchSignalsExpectedSignals")}});export{O as action,Et as actions,p as attribute,w as beginBatch,Ne as computed,E as effect,M as endBatch,D as filtered,ie as getPath,C as mergePatch,S as mergePaths,Ke as morph,X as root,me as signal,V as startPeeking,I as stopPeeking,he as watcher};
 9 | //# sourceMappingURL=datastar.js.map
10 | 


--------------------------------------------------------------------------------
/public/datastar/1.0.0-RC.6/datastar-aliased.js:
--------------------------------------------------------------------------------
 1 | // Datastar Aliased v1.0.0-RC.6
 2 | var nt=/🖕JS_DS🚀/.source,De=nt.slice(0,5),Ve=nt.slice(4),q="datastar-fetch",K="datastar-signal-patch";var de=e=>e.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/([a-z])([0-9]+)/gi,"$1-$2").replace(/([0-9]+)([a-z])/gi,"$1-$2").toLowerCase();var rt=e=>de(e).replace(/-/g,"_");var re=e=>{try{return JSON.parse(e)}catch{return Function(`return (${e})`)()}},st={camel:e=>e.replace(/-[a-z]/g,t=>t[1].toUpperCase()),snake:e=>e.replace(/-/g,"_"),pascal:e=>e[0].toUpperCase()+st.camel(e.slice(1))},R=(e,t,n="camel")=>{for(let r of t.get("case")||[n])e=st[r]?.(e)||e;return e},Q=e=>`data-star-${e}`;var _=Object.hasOwn??Object.prototype.hasOwnProperty.call;var se=e=>e!==null&&typeof e=="object"&&(Object.getPrototypeOf(e)===Object.prototype||Object.getPrototypeOf(e)===null),it=e=>{for(let t in e)if(_(e,t))return!1;return!0},Z=(e,t)=>{for(let n in e){let r=e[n];se(r)||Array.isArray(r)?Z(r,t):e[n]=t(r)}},Te=e=>{let t={};for(let[n,r]of e){let s=n.split("."),i=s.pop(),a=s.reduce((o,c)=>o[c]??={},t);a[i]=r}return t};var Ae=[],Ie=[],Fe=0,Re=0,$e=0,qe,G,we=0,w=()=>{Fe++},M=()=>{--Fe||(ct(),Y())},V=e=>{qe=G,G=e},I=()=>{G=qe,qe=void 0},me=e=>It.bind(0,{previousValue:e,t:e,e:1}),Ge=Symbol("computed"),Ne=e=>{let t=$t.bind(0,{e:17,getter:e});return t[Ge]=1,t},E=e=>{let t={d:e,e:2};G&&Be(t,G),V(t),w();try{t.d()}finally{M(),I()}return dt.bind(0,t)},ct=()=>{for(;Re<$e;){let e=Ie[Re];Ie[Re++]=void 0,ut(e,e.e&=-65)}Re=0,$e=0},ot=e=>"getter"in e?lt(e):ft(e,e.t),lt=e=>{V(e),mt(e);try{let t=e.t;return t!==(e.t=e.getter(t))}finally{I(),pt(e)}},ft=(e,t)=>(e.e=1,e.previousValue!==(e.previousValue=t)),je=e=>{let t=e.e;if(!(t&64)){e.e=t|64;let n=e.r;n?je(n.o):Ie[$e++]=e}},ut=(e,t)=>{if(t&16||t&32&&gt(e.s,e)){V(e),mt(e),w();try{e.d()}finally{M(),I(),pt(e)}return}t&32&&(e.e=t&-33);let n=e.s;for(;n;){let r=n.c,s=r.e;s&64&&ut(r,r.e=s&-65),n=n.i}},It=(e,...t)=>{if(t.length){if(e.t!==(e.t=t[0])){e.e=17;let r=e.r;return r&&(qt(r),Fe||ct()),!0}return!1}let n=e.t;if(e.e&16&&ft(e,n)){let r=e.r;r&&Le(r)}return G&&Be(e,G),n},$t=e=>{let t=e.e;if(t&16||t&32&&gt(e.s,e)){if(lt(e)){let n=e.r;n&&Le(n)}}else t&32&&(e.e=t&-33);return G&&Be(e,G),e.t},dt=e=>{let t=e.s;for(;t;)t=xe(t,e);let n=e.r;n&&xe(n),e.e=0},Be=(e,t)=>{let n=t.a;if(n&&n.c===e)return;let r=n?n.i:t.s;if(r&&r.c===e){r.m=we,t.a=r;return}let s=e.p;if(s&&s.m===we&&s.o===t)return;let i=t.a=e.p={m:we,c:e,o:t,l:n,i:r,f:s};r&&(r.l=i),n?n.i=i:t.s=i,s?s.n=i:e.r=i},xe=(e,t=e.o)=>{let n=e.c,r=e.l,s=e.i,i=e.n,a=e.f;if(s?s.l=r:t.a=r,r?r.i=s:t.s=s,i?i.f=a:n.p=a,a)a.n=i;else if(!(n.r=i))if("getter"in n){let o=n.s;if(o){n.e=17;do o=xe(o,n);while(o)}}else"previousValue"in n||dt(n);return s},qt=e=>{let t=e.n,n;e:for(;;){let r=e.o,s=r.e;if(s&60?s&12?s&4?!(s&48)&&Gt(e,r)?(r.e=s|40,s&=1):s=0:r.e=s&-9|32:s=0:r.e=s|32,s&2&&je(r),s&1){let i=r.r;if(i){let a=(e=i).n;a&&(n={t,u:n},t=a);continue}}if(e=t){t=e.n;continue}for(;n;)if(e=n.t,n=n.u,e){t=e.n;continue e}break}},mt=e=>{we++,e.a=void 0,e.e=e.e&-57|4},pt=e=>{let t=e.a,n=t?t.i:e.s;for(;n;)n=xe(n,e);e.e&=-5},gt=(e,t)=>{let n,r=0,s=!1;e:for(;;){let i=e.c,a=i.e;if(t.e&16)s=!0;else if((a&17)===17){if(ot(i)){let o=i.r;o.n&&Le(o),s=!0}}else if((a&33)===33){(e.n||e.f)&&(n={t:e,u:n}),e=i.s,t=i,++r;continue}if(!s){let o=e.i;if(o){e=o;continue}}for(;r--;){let o=t.r,c=o.n;if(c?(e=n.t,n=n.u):e=o,s){if(ot(t)){c&&Le(o),t=e.o;continue}s=!1}else t.e&=-33;if(t=e.o,e.i){e=e.i;continue e}}return s}},Le=e=>{do{let t=e.o,n=t.e;(n&48)===32&&(t.e=n|16,n&2&&je(t))}while(e=e.n)},Gt=(e,t)=>{let n=t.a;for(;n;){if(n===e)return!0;n=n.l}return!1},ie=e=>{let t=X,n=e.split(".");for(let r of n){if(t==null||!_(t,r))return;t=t[r]}return t},Me=(e,t="")=>{let n=Array.isArray(e);if(n||se(e)){let r=n?[]:{};for(let i in e)r[i]=me(Me(e[i],`${t+i}.`));let s=me(0);return new Proxy(r,{get(i,a){if(!(a==="toJSON"&&!_(r,a)))return n&&a in Array.prototype?(s(),r[a]):typeof a=="symbol"?r[a]:((!_(r,a)||r[a]()==null)&&(r[a]=me(""),Y(t+a,""),s(s()+1)),r[a]())},set(i,a,o){let c=t+a;if(n&&a==="length"){let l=r[a]-o;if(r[a]=o,l>0){let f={};for(let d=o;d<r[a];d++)f[d]=null;Y(t.slice(0,-1),f),s(s()+1)}}else _(r,a)?o==null?delete r[a]:_(o,Ge)?(r[a]=o,Y(c,"")):r[a](Me(o,`${c}.`))&&Y(c,o):o!=null&&(_(o,Ge)?(r[a]=o,Y(c,"")):(r[a]=me(Me(o,`${c}.`)),Y(c,o)),s(s()+1));return!0},deleteProperty(i,a){return delete r[a],s(s()+1),!0},ownKeys(){return s(),Reflect.ownKeys(r)},has(i,a){return s(),a in r}})}return e},Y=(e,t)=>{if(e!==void 0&&t!==void 0&&Ae.push([e,t]),!Fe&&Ae.length){let n=Te(Ae);Ae.length=0,document.dispatchEvent(new CustomEvent(K,{detail:n}))}},C=(e,{ifMissing:t}={})=>{w();for(let n in e)e[n]==null?t||delete X[n]:ht(e[n],n,X,"",t);M()},S=(e,t)=>C(Te(e),t),ht=(e,t,n,r,s)=>{if(se(e)){_(n,t)&&(se(n[t])||Array.isArray(n[t]))||(n[t]={});for(let i in e)e[i]==null?s||delete n[t][i]:ht(e[i],i,n[t],`${r+t}.`,s)}else s&&_(n,t)||(n[t]=e)},at=e=>typeof e=="string"?RegExp(e.replace(/^\/|\/$/g,"")):e,D=({include:e=/.*/,exclude:t=/(?!)/}={},n=X)=>{let r=at(e),s=at(t),i=[],a=[[n,""]];for(;a.length;){let[o,c]=a.pop();for(let l in o){let f=c+l;se(o[l])?a.push([o[l],`${f}.`]):r.test(f)&&!s.test(f)&&i.push([f,ie(f)])}}return Te(i)},X=Me({});var W=e=>e instanceof HTMLElement||e instanceof SVGElement||e instanceof MathMLElement;var jt="https://data-star.dev/errors",pe=(e,t,n={})=>{Object.assign(n,e);let r=new Error,s=rt(t),i=new URLSearchParams({metadata:JSON.stringify(n)}).toString(),a=JSON.stringify(n,null,2);return r.message=`${t}
 3 | More info: ${jt}/${s}?${i}
 4 | Context: ${a}`,r},Oe=new Map,vt=new Map,bt=new Map,Et=new Proxy({},{get:(e,t)=>Oe.get(t)?.apply,has:(e,t)=>Oe.has(t),ownKeys:()=>Reflect.ownKeys(Oe),set:()=>!1,deleteProperty:()=>!1}),ge=new Map,Ce=[],We=new Set,p=e=>{Ce.push(e),Ce.length===1&&setTimeout(()=>{for(let t of Ce)We.add(t.name),vt.set(t.name,t);Ce.length=0,Jt(),We.clear()})},O=e=>{Oe.set(e.name,e)};document.addEventListener(q,e=>{let t=bt.get(e.detail.type);t&&t.apply({error:pe.bind(0,{plugin:{type:"watcher",name:t.name},element:{id:e.target.id,tag:e.target.tagName}})},e.detail.argsRaw)});var he=e=>{bt.set(e.name,e)},yt=e=>{for(let t of e){let n=ge.get(t);if(ge.delete(t)){for(let r of n.values())r();n.clear()}}},St=Q("ignore"),Bt=`[${St}]`,Tt=e=>e.hasAttribute(`${St}__self`)||!!e.closest(Bt),Pe=(e,t)=>{for(let n of e)if(!Tt(n))for(let r in n.dataset)At(n,r.replace(/[A-Z]/g,"-$&").toLowerCase(),n.dataset[r],t)},Wt=e=>{for(let{target:t,type:n,attributeName:r,addedNodes:s,removedNodes:i}of e)if(n==="childList"){for(let a of i)W(a)&&(yt([a]),yt(a.querySelectorAll("*")));for(let a of s)W(a)&&(Pe([a]),Pe(a.querySelectorAll("*")))}else if(n==="attributes"&&r.startsWith("data-")&&W(t)&&!Tt(t)){let a=r.slice(5),o=t.getAttribute(r);if(o===null){let c=ge.get(t);c&&(c.get(a)?.(),c.delete(a))}else At(t,a,o)}},Ut=new MutationObserver(Wt),Jt=(e=document.documentElement)=>{W(e)&&Pe([e],!0),Pe(e.querySelectorAll("*"),!0),Ut.observe(e,{subtree:!0,childList:!0,attributes:!0})},At=(e,t,n,r)=>{if(t.startsWith("star-")){let s=t.slice(5),[i,...a]=s.split("__"),[o,c]=i.split(/:(.+)/),l=vt.get(o);if((!r||We.has(o))&&l){let f={el:e,rawKey:s,mods:new Map,error:pe.bind(0,{plugin:{type:"attribute",name:l.name},element:{id:e.id,tag:e.tagName},expression:{rawKey:s,key:c,value:n}}),key:c,value:n,rx:void 0},d=l.requirement&&(typeof l.requirement=="string"?l.requirement:l.requirement.key)||"allowed",x=l.requirement&&(typeof l.requirement=="string"?l.requirement:l.requirement.value)||"allowed";if(c){if(d==="denied")throw f.error("KeyNotAllowed")}else if(d==="must")throw f.error("KeyRequired");if(n){if(x==="denied")throw f.error("ValueNotAllowed")}else if(x==="must")throw f.error("ValueRequired");if(d==="exclusive"||x==="exclusive"){if(c&&n)throw f.error("KeyAndValueProvided");if(!c&&!n)throw f.error("KeyOrValueRequired")}if(n){let m;f.rx=(...h)=>(m||(m=zt(n,{returnsValue:l.returnsValue,argNames:l.argNames})),m(e,...h))}for(let m of a){let[h,...v]=m.split(".");f.mods.set(h,new Set(v))}let u=l.apply(f);if(u){let m=ge.get(e);m?m.get(s)?.():(m=new Map,ge.set(e,m)),m.set(s,u)}}}},zt=(e,{returnsValue:t=!1,argNames:n=[]}={})=>{let r="";if(t){let o=/(\/(\\\/|[^/])*\/|"(\\"|[^"])*"|'(\\'|[^'])*'|`(\\`|[^`])*`|\(\s*((function)\s*\(\s*\)|(\(\s*\))\s*=>)\s*(?:\{[\s\S]*?\}|[^;){]*)\s*\)\s*\(\s*\)|[^;])+/gm,c=e.trim().match(o);if(c){let l=c.length-1,f=c[l].trim();f.startsWith("return")||(c[l]=`return (${f});`),r=c.join(`;
 5 | `)}}else r=e.trim();let s=new Map,i=RegExp(`(?:${De})(.*?)(?:${Ve})`,"gm"),a=0;for(let o of r.matchAll(i)){let c=o[1],l=`__escaped${a++}`;s.set(l,c),r=r.replace(De+c+Ve,l)}r=r.replace(/\$\['([a-zA-Z_$\d][\w$]*)'\]/g,"$$$1").replace(/\$([a-zA-Z_\d]\w*(?:[.-]\w+)*)/g,(o,c)=>c.split(".").reduce((l,f)=>`${l}['${f}']`,"$")).replace(/\[(\$[a-zA-Z_\d]\w*)\]/g,(o,c)=>`[$['${c.slice(1)}']]`),r=r.replaceAll(/@(\w+)\(/g,'__action("$1",evt,');for(let[o,c]of s)r=r.replace(o,c);try{let o=Function("el","$","__action","evt",...n,r);return(c,...l)=>{let f=(d,x,...u)=>{let m=pe.bind(0,{plugin:{type:"action",name:d},element:{id:c.id,tag:c.tagName},expression:{fnContent:r,value:e}}),h=Et[d];if(h)return h({el:c,evt:x,error:m},...u);throw m("UndefinedAction")};try{return o(c,X,f,void 0,...l)}catch(d){throw console.error(d),pe({element:{id:c.id,tag:c.tagName},expression:{fnContent:r,value:e},error:d.message},"ExecuteExpression")}}}catch(o){throw console.error(o),pe({expression:{fnContent:r,value:e},error:o.message},"GenerateExpression")}};var P=new Map,ae=new Set,oe=new Map,ye=new Set,ce=document.createElement("div");ce.hidden=!0;var ve=Q("ignore-morph"),Kt=`[${ve}]`,ze=(e,t,n="outer")=>{if(W(e)&&W(t)&&e.hasAttribute(ve)&&t.hasAttribute(ve)||e.parentElement?.closest(Kt))return;let r=document.createElement("div");r.append(t),document.body.insertAdjacentElement("afterend",ce);let s=e.querySelectorAll("[id]");for(let{id:o,tagName:c}of s)oe.has(o)?ye.add(o):oe.set(o,c);e instanceof Element&&e.id&&(oe.has(e.id)?ye.add(e.id):oe.set(e.id,e.tagName)),ae.clear();let i=r.querySelectorAll("[id]");for(let{id:o,tagName:c}of i)ae.has(o)?ye.add(o):oe.get(o)===c&&ae.add(o);for(let o of ye)ae.delete(o);oe.clear(),ye.clear(),P.clear();let a=n==="outer"?e.parentElement:e;wt(a,s),wt(r,i),Mt(a,r,n==="outer"?e:null,e.nextSibling),ce.remove()},Mt=(e,t,n=null,r=null)=>{e instanceof HTMLTemplateElement&&t instanceof HTMLTemplateElement&&(e=e.content,t=t.content),n??=e.firstChild;for(let s of t.childNodes){if(n&&n!==r){let i=Qt(s,n,r);if(i){if(i!==n){let a=n;for(;a&&a!==i;){let o=a;a=a.nextSibling,Je(o)}}Ue(i,s),n=i.nextSibling;continue}}if(s instanceof Element&&ae.has(s.id)){let i=document.getElementById(s.id),a=i;for(;a=a.parentNode;){let o=P.get(a);o&&(o.delete(s.id),o.size||P.delete(a))}xt(e,i,n),Ue(i,s),n=i.nextSibling;continue}if(P.has(s)){let i=document.createElement(s.tagName);e.insertBefore(i,n),Ue(i,s),n=i.nextSibling}else{let i=document.importNode(s,!0);e.insertBefore(i,n),n=i.nextSibling}}for(;n&&n!==r;){let s=n;n=n.nextSibling,Je(s)}},Qt=(e,t,n)=>{let r=null,s=e.nextSibling,i=0,a=0,o=P.get(e)?.size||0,c=t;for(;c&&c!==n;){if(Rt(c,e)){let l=!1,f=P.get(c),d=P.get(e);if(d&&f){for(let x of f)if(d.has(x)){l=!0;break}}if(l)return c;if(!r&&!P.has(c)){if(!o)return c;r=c}}if(a+=P.get(c)?.size||0,a>o)break;r===null&&s&&Rt(c,s)&&(i++,s=s.nextSibling,i>=2&&(r=void 0)),c=c.nextSibling}return r||null},Rt=(e,t)=>e.nodeType===t.nodeType&&e.tagName===t.tagName&&(!e.id||e.id===t.id),Je=e=>{P.has(e)?xt(ce,e,null):e.parentNode?.removeChild(e)},xt=Je.call.bind(ce.moveBefore??ce.insertBefore),Zt=Q("preserve-attr"),Ue=(e,t)=>{let n=t.nodeType;if(n===1){let r=e,s=t;if(r.hasAttribute(ve)&&s.hasAttribute(ve))return e;r instanceof HTMLInputElement&&s instanceof HTMLInputElement&&s.type!=="file"?s.getAttribute("value")!==r.getAttribute("value")&&(r.value=s.getAttribute("value")??""):r instanceof HTMLTextAreaElement&&s instanceof HTMLTextAreaElement&&(s.value!==r.value&&(r.value=s.value),r.firstChild&&r.firstChild.nodeValue!==s.value&&(r.firstChild.nodeValue=s.value));let i=(t.getAttribute(Zt)??"").split(" ");for(let{name:a,value:o}of s.attributes)r.getAttribute(a)!==o&&!i.includes(a)&&r.setAttribute(a,o);for(let a=r.attributes.length-1;a>=0;a--){let{name:o}=r.attributes[a];!s.hasAttribute(o)&&!i.includes(o)&&r.removeAttribute(o)}r.isEqualNode(s)||Mt(r,s)}return(n===8||n===3)&&e.nodeValue!==t.nodeValue&&(e.nodeValue=t.nodeValue),e},wt=(e,t)=>{for(let n of t)if(ae.has(n.id)){let r=n;for(;r&&r!==e;){let s=P.get(r);s||(s=new Set,P.set(r,s)),s.add(n.id),r=r.parentElement}}};O({name:"peek",apply(e,t){V();try{return t()}finally{I()}}});O({name:"setAll",apply(e,t,n){V();let r=D(n);Z(r,()=>t),C(r),I()}});O({name:"toggleAll",apply(e,t){V();let n=D(t);Z(n,r=>!r),C(n),I()}});var He=new WeakMap,be=(e,t)=>O({name:e,apply:async({el:n,evt:r,error:s},i,{selector:a,headers:o,contentType:c="json",filterSignals:{include:l=/.*/,exclude:f=/(^|\.)_/}={},openWhenHidden:d=!1,retryInterval:x=1e3,retryScaler:u=2,retryMaxWaitMs:m=3e4,retryMaxCount:h=10,requestCancellation:v="auto"}={})=>{let L=v instanceof AbortController?v:new AbortController,A=v==="disabled";if(!A){let T=He.get(n);T&&(T.abort(),await Promise.resolve())}!A&&!(v instanceof AbortController)&&He.set(n,L);try{let T=new MutationObserver(j=>{for(let H of j)for(let B of H.removedNodes)B===n&&(L.abort(),z())});n.parentNode&&T.observe(n.parentNode,{childList:!0});let z=()=>{T.disconnect()};try{if(!i?.length)throw s("FetchNoUrlProvided",{action:O});let j={Accept:"text/event-stream, text/html, application/json","Datastar-Request":!0};c==="json"&&(j["Content-Type"]="application/json");let H=Object.assign({},j,o),B={method:t,headers:H,openWhenHidden:d,retryInterval:x,retryScaler:u,retryMaxWaitMs:m,retryMaxCount:h,signal:L.signal,onopen:async g=>{g.status>=400&&ee(Yt,n,{status:g.status.toString()})},onmessage:g=>{if(!g.event.startsWith("datastar"))return;let $=g.event,b={};for(let N of g.data.split(`
 6 | `)){let y=N.indexOf(" "),k=N.slice(0,y),ue=N.slice(y+1);(b[k]||=[]).push(ue)}let F=Object.fromEntries(Object.entries(b).map(([N,y])=>[N,y.join(`
 7 | `)]));ee($,n,F)},onerror:g=>{if(Lt(g))throw g("FetchExpectedTextEventStream",{url:i});g&&(console.error(g.message),ee(Xt,n,{message:g.message}))}},fe=new URL(i,document.baseURI),ne=new URLSearchParams(fe.search);if(c==="json"){let g=JSON.stringify(D({include:l,exclude:f}));t==="GET"?ne.set("datastar",g):B.body=g}else if(c==="form"){let g=a?document.querySelector(a):n.closest("form");if(!g)throw s("FetchFormNotFound",{action:O,selector:a});if(!g.checkValidity()){g.reportValidity(),z();return}let $=new FormData(g),b=n;if(n===g&&r instanceof SubmitEvent)b=r.submitter;else{let y=k=>k.preventDefault();g.addEventListener("submit",y),z=()=>{g.removeEventListener("submit",y),T.disconnect()}}if(b instanceof HTMLButtonElement){let y=b.getAttribute("name");y&&$.append(y,b.value)}let F=g.getAttribute("enctype")==="multipart/form-data";F||(H["Content-Type"]="application/x-www-form-urlencoded");let N=new URLSearchParams($);if(t==="GET")for(let[y,k]of N)ne.append(y,k);else F?B.body=$:B.body=N}else throw s("FetchInvalidContentType",{action:O,contentType:c});ee(Ke,n,{}),fe.search=ne.toString();try{await on(fe.toString(),n,B)}catch(g){if(!Lt(g))throw s("FetchFailed",{method:t,url:i,error:g.message})}}finally{ee(Qe,n,{}),z()}}finally{He.get(n)===L&&He.delete(n)}}});be("delete","DELETE");be("get","GET");be("patch","PATCH");be("post","POST");be("put","PUT");var Ke="started",Qe="finished",Yt="error",Xt="retrying",en="retries-failed",ee=(e,t,n)=>document.dispatchEvent(new CustomEvent(q,{detail:{type:e,el:t,argsRaw:n}})),Lt=e=>`${e}`.includes("text/event-stream"),tn=async(e,t)=>{let n=e.getReader(),r=await n.read();for(;!r.done;)t(r.value),r=await n.read()},nn=e=>{let t,n,r,s=!1;return i=>{t?t=sn(t,i):(t=i,n=0,r=-1);let a=t.length,o=0;for(;n<a;){s&&(t[n]===10&&(o=++n),s=!1);let c=-1;for(;n<a&&c===-1;++n)switch(t[n]){case 58:r===-1&&(r=n-o);break;case 13:s=!0;case 10:c=n;break}if(c===-1)break;e(t.subarray(o,c),r),o=n,r=-1}o===a?t=void 0:o&&(t=t.subarray(o),n-=o)}},rn=(e,t,n)=>{let r=Ft(),s=new TextDecoder;return(i,a)=>{if(!i.length)n?.(r),r=Ft();else if(a>0){let o=s.decode(i.subarray(0,a)),c=a+(i[a+1]===32?2:1),l=s.decode(i.subarray(c));switch(o){case"data":r.data=r.data?`${r.data}
 8 | ${l}`:l;break;case"event":r.event=l;break;case"id":e(r.id=l);break;case"retry":{let f=+l;Number.isNaN(f)||t(r.retry=f);break}}}}},sn=(e,t)=>{let n=new Uint8Array(e.length+t.length);return n.set(e),n.set(t,e.length),n},Ft=()=>({data:"",event:"",id:"",retry:void 0}),on=(e,t,{signal:n,headers:r,onopen:s,onmessage:i,onclose:a,onerror:o,openWhenHidden:c,fetch:l,retryInterval:f=1e3,retryScaler:d=2,retryMaxWaitMs:x=3e4,retryMaxCount:u=10,overrides:m,...h})=>new Promise((v,L)=>{let A={...r},T,z=()=>{T.abort(),document.hidden||$()};c||document.addEventListener("visibilitychange",z);let j=0,H=()=>{document.removeEventListener("visibilitychange",z),clearTimeout(j),T.abort()};n?.addEventListener("abort",()=>{H(),v()});let B=l||window.fetch,fe=s||(()=>{}),ne=0,g=f,$=async()=>{T=new AbortController;try{let b=await B(e,{...h,headers:A,signal:T.signal});ne=0,f=g,await fe(b);let F=async(y,k,ue,Ee,...Vt)=>{let tt={[ue]:await k.text()};for(let ke of Vt){let _e=k.headers.get(`datastar-${de(ke)}`);if(Ee){let Se=Ee[ke];Se&&(_e=typeof Se=="string"?Se:JSON.stringify(Se))}_e&&(tt[ke]=_e)}ee(y,t,tt),H(),v()},N=b.headers.get("Content-Type");if(N?.includes("text/html"))return await F("datastar-patch-elements",b,"elements",m,"selector","mode","useViewTransition");if(N?.includes("application/json"))return await F("datastar-patch-signals",b,"signals",m,"onlyIfMissing");if(N?.includes("text/javascript")){let y=document.createElement("script"),k=b.headers.get("datastar-script-attributes");if(k)for(let[ue,Ee]of Object.entries(JSON.parse(k)))y.setAttribute(ue,Ee);y.textContent=await b.text(),document.head.appendChild(y),H();return}await tn(b.body,nn(rn(y=>{y?A["last-event-id"]=y:delete A["last-event-id"]},y=>{g=f=y},i))),a?.(),H(),v()}catch(b){if(!T.signal.aborted)try{let F=o?.(b)||f;clearTimeout(j),j=setTimeout($,F),f=Math.min(f*d,x),++ne>=u?(ee(en,t,{}),H(),L("Max retries reached.")):console.error(`Datastar failed to reach ${e.toString()} retrying in ${F}ms.`)}catch(F){H(),L(F)}}};$()});p({name:"attr",requirement:{value:"must"},returnsValue:!0,apply({el:e,key:t,rx:n}){let r=(o,c)=>{c===""||c===!0?e.setAttribute(o,""):c===!1||c==null?e.removeAttribute(o):typeof c=="string"?e.setAttribute(o,c):e.setAttribute(o,JSON.stringify(c))},s=t?()=>{i.disconnect();let o=n();r(t,o),i.observe(e,{attributeFilter:[t]})}:()=>{i.disconnect();let o=n(),c=Object.keys(o);for(let l of c)r(l,o[l]);i.observe(e,{attributeFilter:c})},i=new MutationObserver(s),a=E(s);return()=>{i.disconnect(),a()}}});var an=/^data:(?<mime>[^;]+);base64,(?<contents>.*)$/,Nt=Symbol("empty"),Ct=Q("bind");p({name:"bind",requirement:"exclusive",apply({el:e,key:t,mods:n,value:r,error:s}){let i=t!=null?R(t,n):r,a=(u,m)=>m==="number"?+u.value:u.value,o=u=>{e.value=`${u}`};if(e instanceof HTMLInputElement)switch(e.type){case"range":case"number":a=(u,m)=>m==="string"?u.value:+u.value;break;case"checkbox":a=(u,m)=>u.value!=="on"?m==="boolean"?u.checked:u.checked?u.value:"":m==="string"?u.checked?u.value:"":u.checked,o=u=>{e.checked=typeof u=="string"?u===e.value:u};break;case"radio":e.getAttribute("name")?.length||e.setAttribute("name",i),a=(u,m)=>u.checked?m==="number"?+u.value:u.value:Nt,o=u=>{e.checked=u===(typeof u=="number"?+e.value:e.value)};break;case"file":{let u=()=>{let m=[...e.files||[]],h=[];Promise.all(m.map(v=>new Promise(L=>{let A=new FileReader;A.onload=()=>{if(typeof A.result!="string")throw s("InvalidFileResultType",{resultType:typeof A.result});let T=A.result.match(an);if(!T?.groups)throw s("InvalidDataUri",{result:A.result});h.push({name:v.name,contents:T.groups.contents,mime:T.groups.mime})},A.onloadend=()=>L(),A.readAsDataURL(v)}))).then(()=>{S([[i,h]])})};return e.addEventListener("change",u),e.addEventListener("input",u),()=>{e.removeEventListener("change",u),e.removeEventListener("input",u)}}}else if(e instanceof HTMLSelectElement){if(e.multiple){let u=new Map;a=m=>[...m.selectedOptions].map(h=>{let v=u.get(h.value);return v==="string"||v==null?h.value:+h.value}),o=m=>{for(let h of e.options)m.includes(h.value)?(u.set(h.value,"string"),h.selected=!0):m.includes(+h.value)?(u.set(h.value,"number"),h.selected=!0):h.selected=!1}}}else e instanceof HTMLTextAreaElement||(a=u=>"value"in u?u.value:u.getAttribute("value"),o=u=>{"value"in e?e.value=u:e.setAttribute("value",u)});let c=ie(i),l=typeof c,f=i;if(Array.isArray(c)&&!(e instanceof HTMLSelectElement&&e.multiple)){let u=t||r,m=document.querySelectorAll(`[${Ct}\\:${CSS.escape(u)}],[${Ct}="${CSS.escape(u)}"]`),h=[],v=0;for(let L of m){if(h.push([`${f}.${v}`,a(L,"none")]),e===L)break;v++}S(h,{ifMissing:!0}),f=`${f}.${v}`}else S([[f,a(e,l)]],{ifMissing:!0});let d=()=>{let u=ie(f);if(u!=null){let m=a(e,typeof u);m!==Nt&&S([[f,m]])}};e.addEventListener("input",d),e.addEventListener("change",d);let x=E(()=>{o(ie(f))});return()=>{x(),e.removeEventListener("input",d),e.removeEventListener("change",d)}}});p({name:"class",requirement:{value:"must"},returnsValue:!0,apply({key:e,el:t,mods:n,rx:r}){e&&(e=R(e,n,"kebab"));let s=()=>{i.disconnect();let o=e?{[e]:r()}:r();for(let c in o){let l=c.split(/\s+/).filter(f=>f.length>0);if(o[c])for(let f of l)t.classList.contains(f)||t.classList.add(f);else for(let f of l)t.classList.contains(f)&&t.classList.remove(f)}i.observe(t,{attributeFilter:["class"]})},i=new MutationObserver(s),a=E(s);return()=>{i.disconnect(),a();let o=e?{[e]:r()}:r();for(let c in o){let l=c.split(/\s+/).filter(f=>f.length>0);for(let f of l)t.classList.remove(f)}}}});p({name:"computed",requirement:{value:"must"},returnsValue:!0,apply({key:e,mods:t,rx:n,error:r}){if(e)S([[R(e,t),Ne(n)]]);else{let s=Object.assign({},n());Z(s,i=>{if(typeof i=="function")return Ne(i);throw r("ComputedExpectedFunction")}),C(s)}}});p({name:"effect",requirement:{key:"denied",value:"must"},apply:({rx:e})=>E(e)});p({name:"indicator",requirement:"exclusive",apply({el:e,key:t,mods:n,value:r}){let s=t!=null?R(t,n):r;S([[s,!1]]);let i=a=>{let{type:o,el:c}=a.detail;if(c===e)switch(o){case Ke:S([[s,!0]]);break;case Qe:S([[s,!1]]);break}};return document.addEventListener(q,i),()=>{S([[s,!1]]),document.removeEventListener(q,i)}}});p({name:"json-signals",requirement:{key:"denied"},apply({el:e,value:t,mods:n}){let r=n.has("terse")?0:2,s={};t&&(s=re(t));let i=()=>{a.disconnect(),e.textContent=JSON.stringify(D(s),null,r),a.observe(e,{childList:!0,characterData:!0,subtree:!0})},a=new MutationObserver(i),o=E(i);return()=>{a.disconnect(),o()}}});var U=e=>{if(!e||e.size<=0)return 0;for(let t of e){if(t.endsWith("ms"))return+t.replace("ms","");if(t.endsWith("s"))return+t.replace("s","")*1e3;try{return Number.parseFloat(t)}catch{}}return 0},te=(e,t,n=!1)=>e?e.has(t.toLowerCase()):n;var Ze=(e,t)=>(...n)=>{setTimeout(()=>{e(...n)},t)},cn=(e,t,n=!1,r=!0)=>{let s=0;return(...i)=>{s&&clearTimeout(s),n&&!s&&e(...i),s=setTimeout(()=>{r&&e(...i),s&&clearTimeout(s),s=0},t)}},ln=(e,t,n=!0,r=!1)=>{let s=!1;return(...i)=>{s||(n&&e(...i),s=!0,setTimeout(()=>{r&&e(...i),s=!1},t))}},le=(e,t)=>{let n=t.get("delay");if(n){let i=U(n);e=Ze(e,i)}let r=t.get("debounce");if(r){let i=U(r),a=te(r,"leading",!1),o=!te(r,"notrailing",!1);e=cn(e,i,a,o)}let s=t.get("throttle");if(s){let i=U(s),a=!te(s,"noleading",!1),o=te(s,"trailing",!1);e=ln(e,i,a,o)}return e};var Ye=!!document.startViewTransition,J=(e,t)=>{if(t.has("viewtransition")&&Ye){let n=e;e=(...r)=>document.startViewTransition(()=>n(...r))}return e};p({name:"on",requirement:"must",argNames:["evt"],apply({el:e,key:t,mods:n,rx:r}){let s=e;n.has("window")&&(s=window);let i=c=>{c&&(n.has("prevent")&&c.preventDefault(),n.has("stop")&&c.stopPropagation()),w(),r(c),M()};i=J(i,n),i=le(i,n);let a={capture:n.has("capture"),passive:n.has("passive"),once:n.has("once")};if(n.has("outside")){s=document;let c=i;i=l=>{e.contains(l?.target)||c(l)}}let o=R(t,n,"kebab");if((o===q||o===K)&&(s=document),e instanceof HTMLFormElement&&o==="submit"){let c=i;i=l=>{l?.preventDefault(),c(l)}}return s.addEventListener(o,i,a),()=>{s.removeEventListener(o,i)}}});var Xe=new WeakSet;p({name:"on-intersect",requirement:{key:"denied",value:"must"},apply({el:e,mods:t,rx:n}){let r=()=>{w(),n(),M()};r=J(r,t),r=le(r,t);let s={threshold:0};t.has("full")?s.threshold=1:t.has("half")&&(s.threshold=.5);let i=new IntersectionObserver(a=>{for(let o of a)o.isIntersecting&&(r(),i&&Xe.has(e)&&i.disconnect())},s);return i.observe(e),t.has("once")&&Xe.add(e),()=>{t.has("once")||Xe.delete(e),i&&(i.disconnect(),i=null)}}});p({name:"on-interval",requirement:{key:"denied",value:"must"},apply({mods:e,rx:t}){let n=()=>{w(),t(),M()};n=J(n,e);let r=1e3,s=e.get("duration");s&&(r=U(s),te(s,"leading",!1)&&n());let i=setInterval(n,r);return()=>{clearInterval(i)}}});p({name:"init",requirement:{key:"denied",value:"must"},apply({rx:e,mods:t}){let n=()=>{w(),e(),M()};n=J(n,t);let r=0,s=t.get("delay");s&&(r=U(s),r>0&&(n=Ze(n,r))),n()}});p({name:"on-signal-patch",requirement:{value:"must"},argNames:["patch"],returnsValue:!0,apply({el:e,key:t,mods:n,rx:r,error:s}){if(t&&t!=="filter")throw s("KeyNotAllowed");let i=e.getAttribute("data-on-signal-patch-filter"),a={};i&&(a=re(i));let o=le(c=>{let l=D(a,c.detail);it(l)||(w(),r(l),M())},n);return document.addEventListener(K,o),()=>{document.removeEventListener(K,o)}}});p({name:"ref",requirement:"exclusive",apply({el:e,key:t,mods:n,value:r}){let s=t!=null?R(t,n):r;S([[s,e]])}});var Ot="none",Pt="display";p({name:"show",requirement:{key:"denied",value:"must"},returnsValue:!0,apply({el:e,rx:t}){let n=()=>{r.disconnect(),t()?e.style.display===Ot&&e.style.removeProperty(Pt):e.style.setProperty(Pt,Ot),r.observe(e,{attributeFilter:["style"]})},r=new MutationObserver(n),s=E(n);return()=>{r.disconnect(),s()}}});p({name:"signals",returnsValue:!0,apply({key:e,mods:t,rx:n}){let r=t.has("ifmissing");if(e)e=R(e,t),S([[e,n?.()]],{ifMissing:r});else{let s=Object.assign({},n?.());C(s,{ifMissing:r})}}});p({name:"style",requirement:{value:"must"},returnsValue:!0,apply({key:e,el:t,rx:n}){let{style:r}=t,s=new Map,i=(l,f)=>{let d=s.get(l);!f&&f!==0?d!==void 0&&(d?r.setProperty(l,d):r.removeProperty(l)):(d===void 0&&s.set(l,r.getPropertyValue(l)),r.setProperty(l,String(f)))},a=()=>{if(o.disconnect(),e)i(e,n());else{let l=n();for(let[f,d]of s)f in l||(d?r.setProperty(f,d):r.removeProperty(f));for(let f in l)i(de(f),l[f])}o.observe(t,{attributeFilter:["style"]})},o=new MutationObserver(a),c=E(a);return()=>{o.disconnect(),c();for(let[l,f]of s)f?r.setProperty(l,f):r.removeProperty(l)}}});p({name:"text",requirement:{key:"denied",value:"must"},returnsValue:!0,apply({el:e,rx:t}){let n=()=>{r.disconnect(),e.textContent=`${t()}`,r.observe(e,{childList:!0,characterData:!0,subtree:!0})},r=new MutationObserver(n),s=E(n);return()=>{r.disconnect(),s()}}});he({name:"datastar-patch-elements",apply(e,{elements:t="",selector:n="",mode:r="outer",useViewTransition:s}){switch(r){case"remove":case"outer":case"inner":case"replace":case"prepend":case"append":case"before":case"after":break;default:throw e.error("PatchElementsInvalidMode",{mode:r})}if(!n&&r!=="outer"&&r!=="replace")throw e.error("PatchElementsExpectedSelector");let i={mode:r,selector:n,elements:t,useViewTransition:s?.trim()==="true"};Ye&&s?document.startViewTransition(()=>Ht(e,i)):Ht(e,i)}});var Ht=({error:e},{elements:t,selector:n,mode:r})=>{let s=t.replace(/<svg(\s[^>]*>|>)([\s\S]*?)<\/svg>/gim,""),i=/<\/html>/.test(s),a=/<\/head>/.test(s),o=/<\/body>/.test(s),c=new DOMParser().parseFromString(i||a||o?t:`<body><template>${t}</template></body>`,"text/html"),l=document.createDocumentFragment();if(i?l.appendChild(c.documentElement):a&&o?(l.appendChild(c.head),l.appendChild(c.body)):a?l.appendChild(c.head):o?l.appendChild(c.body):l=c.querySelector("template").content,!n&&(r==="outer"||r==="replace"))for(let f of l.children){let d;if(f instanceof HTMLHtmlElement)d=document.documentElement;else if(f instanceof HTMLBodyElement)d=document.body;else if(f instanceof HTMLHeadElement)d=document.head;else if(d=document.getElementById(f.id),!d){console.warn(e("PatchElementsNoTargetsFound"),{element:{id:f.id}});continue}_t(r,f,[d])}else{let f=document.querySelectorAll(n);if(!f.length){console.warn(e("PatchElementsNoTargetsFound"),{selector:n});return}_t(r,l,f)}},et=new WeakSet;for(let e of document.querySelectorAll("script"))et.add(e);var Dt=e=>{let t=e instanceof HTMLScriptElement?[e]:e.querySelectorAll("script");for(let n of t)if(!et.has(n)){let r=document.createElement("script");for(let{name:s,value:i}of n.attributes)r.setAttribute(s,i);r.text=n.text,n.replaceWith(r),et.add(r)}},kt=(e,t,n)=>{for(let r of e){let s=t.cloneNode(!0);Dt(s),r[n](s)}},_t=(e,t,n)=>{switch(e){case"remove":for(let r of n)r.remove();break;case"outer":case"inner":for(let r of n)ze(r,t.cloneNode(!0),e),Dt(r);break;case"replace":kt(n,t,"replaceWith");break;case"prepend":case"append":case"before":case"after":kt(n,t,e)}};he({name:"datastar-patch-signals",apply({error:e},{signals:t,onlyIfMissing:n}){if(t){let r=n?.trim()==="true";C(re(t),{ifMissing:r})}else throw e("PatchSignalsExpectedSignals")}});export{O as action,Et as actions,p as attribute,w as beginBatch,Ne as computed,E as effect,M as endBatch,D as filtered,ie as getPath,C as mergePatch,S as mergePaths,ze as morph,X as root,me as signal,V as startPeeking,I as stopPeeking,he as watcher};
 9 | //# sourceMappingURL=datastar-aliased.js.map
10 | 


--------------------------------------------------------------------------------