Add the first-party Data component

.php-cs-fixer.php

@@ -117,6 +117,7 @@
             ->exclude('src/testbench/workbench/storage')
             ->exclude('vendor')
             ->notPath('#^bin/#')
+            ->notPath('tests/Data/Fixtures/PhpDocTypeContext.php')
             ->notPath('tests/Foundation/Fixtures/fake-compiled-view.php')
             ->name('hypervel-test-profile')
             ->in(__DIR__)

composer.json

@@ -38,6 +38,7 @@
             "Hypervel\\Context\\": "src/context/src/",
             "Hypervel\\Coordinator\\": "src/coordinator/src/",
             "Hypervel\\Cookie\\": "src/cookie/src/",
+            "Hypervel\\Data\\": "src/data/src/",
             "Hypervel\\Database\\": "src/database/src/",
             "Hypervel\\Concurrency\\": "src/concurrency/src/",
             "Hypervel\\Coroutine\\": "src/coroutine/src/",
@@ -242,6 +243,7 @@
         "hypervel/coordinator": "self.version",
         "hypervel/cookie": "self.version",
         "hypervel/coroutine": "self.version",
+        "hypervel/data": "self.version",
         "hypervel/database": "self.version",
         "hypervel/di": "self.version",
         "hypervel/docs": "self.version",
@@ -349,6 +351,7 @@
                 "Hypervel\\Concurrency\\ConcurrencyServiceProvider",
                 "Hypervel\\Console\\ConsoleServiceProvider",
                 "Hypervel\\Cookie\\CookieServiceProvider",
+                "Hypervel\\Data\\DataServiceProvider",
                 "Hypervel\\Database\\DatabaseServiceProvider",
                 "Hypervel\\Encryption\\EncryptionServiceProvider",
                 "Hypervel\\Engine\\EngineServiceProvider",

docs/todo.md

@@ -42,6 +42,10 @@
 - Publish reproducible Hypervel 0.4 benchmarks on a dedicated documentation page before linking them from the introduction. Record the framework, PHP, Swoole, and dependency versions; use the same hardware and load-generation conditions for every runtime; publish the benchmark applications and configuration; and include the raw results, collection date, and limitations. Do not reuse the Hypervel 0.3 results as current data. Once the page is published, add it to `src/docs/documentation.md` and link to it from the introduction.
 - When the Hypervel 0.4 documentation is published, replace the versioned GitHub source links in both the `hypervel/components` and `hypervel/hypervel` READMEs with the corresponding hypervel.org documentation URLs. The documentation's `{{version}}` cross-links only resolve on the published site, so readers who follow the current links land on pages whose internal navigation is broken.
 
+## TypeScript
+
+- Port `spatie/typescript-transformer` as a general first-party Hypervel package, then add an optional Hypervel Data adapter that recognizes data classes and their existing mapping, Optional, lazy, and collection metadata. Keep TypeScript generation outside `hypervel/data`: the transformer must also support ordinary PHP classes and enums without making runtime data construction depend on filesystem discovery or code generation.
+
 ## Redis
 
 - Revisit the rate limiter's portable fixed-window Lua script once native bounded increment-with-expiry support is mature across the supported Redis-compatible ecosystem. Redis 8.8's `INCREX` can atomically reject increments above an upper bound and set expiry only for a new window, but Redis 8.6 and Valkey 9 do not provide it, [Valkey #3253](https://github.com/valkey-io/valkey/pull/3253) is still an open related proposal rather than equivalent `INCREX` support, and phpredis 6.3 exposes no typed `INCREX` method (while `rawCommand()` bypasses key prefixing and has different Redis Cluster routing semantics). Re-benchmark and switch only when Redis and Valkey expose equivalent semantics and phpredis has prefix-aware, cluster-aware client support; keep the corresponding focused `@TODO` beside the Lua script until then.

docs/upstream-sync/README.md

@@ -6,7 +6,7 @@ This guide governs how Hypervel stays current with upstream packages (Laravel fr
 
 When the user asks to run an upstream sync, sync session, upstream review, or similar. This guide **overrides** the `/hypervel-pr` skill's default first-time porting flow — follow the sync workflow below instead.
 
-For the mechanics of porting code (namespace changes, container conversion, service provider migration, listener conversion, type modernization, test porting), `docs/ai/porting.md` is authoritative. Re-read it before writing any code. This guide only covers the *surrounding* workflow — discovery, classification, commit structure, PR structure, state tracking.
+For the mechanics of porting code (namespace changes, container conversion, service provider migration, listener conversion, type modernization, test porting), the `Porting Packages` section of `AGENTS.md` is authoritative. Re-read it before writing any code. This guide only covers the *surrounding* workflow — discovery, classification, commit structure, PR structure, state tracking.
 
 ## Files in this directory
 
@@ -20,7 +20,7 @@ Deliberate, lasting differences from Laravel belong in the affected package READ
 - **Releases are walked one at a time, oldest to newest.** Never merge multiple releases' PRs into one flat list. Finish release N before opening release N+1.
 - **Never auto-decide a PR is skippable.** Propose classification, explain reasoning, wait for user approval. The user decides scope; you propose.
 - **One commit per upstream PR.** Separation is cheap; bad reverts are expensive.
-- **Stop-and-ask rules from `porting.md` apply in full** — source bugs, coroutine/container divergence, unusual dependencies, anything surprising.
+- **Stop-and-ask rules from `AGENTS.md` apply in full** — source bugs, coroutine/container divergence, unusual dependencies, anything surprising.
 
 ## Session workflow
 
@@ -72,7 +72,7 @@ Propose a classification and reasoning:
 
 Wait for user approval on every classification. Never silently skip.
 
-If porting: follow `docs/ai/porting.md` for the mechanics. Commit with:
+If porting: follow the `Porting Packages` section of `AGENTS.md` for the mechanics. Commit with:
 
 ```
 Port <repo-slug>#<pr-number>: <original PR title>

docs/upstream-sync/sync.yaml

@@ -85,6 +85,12 @@ orchestral/testbench:
   sync_date: null
   notes: Composer package is `orchestra/testbench` (different from gh slug).
 
+spatie/laravel-data:
+  repo_url: https://github.com/spatie/laravel-data
+  release: 4.23.0
+  sync_date: 2026-08-30
+  notes: Initial port also reviewed main through ce296f22 and the v5 draft at ed630ee1.
+
 spatie/laravel-permission:
   repo_url: https://github.com/spatie/laravel-permission
   release: null

src/container/README.md

@@ -9,6 +9,10 @@ Documentation: https://hypervel.org/docs/container
 
 Hypervel supports Laravel's named container APIs, but not container ArrayAccess or dynamic service properties. Use `make()` / `get()`, `bound()` / `has()`, `bind()`, and `instance()`. For temporary instance overrides, use `forgetInstance()` to restore the original binding. Hypervel does not expose arbitrary binding removal because registrations are worker-wide boot-time state.
 
+A contextual attribute's resolved value is authoritative, including `null`. Unlike Laravel, Hypervel does not fall through to class or primitive resolution, contextual bindings, or declared defaults after a contextual resolver returns `null`.
+
+`#[BindWhen]` conditions must depend only on boot-stable state. The first matching condition becomes a normal worker-lifetime binding; unmatched conditions remain eligible for reevaluation on later resolutions.
+
 Hypervel does not expose Laravel's protected per-parameter override helpers. Container subclasses that customize parameter override resolution should override `resolveRecipeParameters()`, which receives the current coroutine's resolution state and resolves the complete parameter list in one pass.
 
 Ported from: https://github.com/laravel/framework/tree/13.x/src/Illuminate/Container

src/container/composer.json

@@ -26,6 +26,7 @@
         "php": "^8.4",
         "ext-swoole": "^6.2.2",
         "psr/container": "^2.0.1",
+        "hypervel/collections": "^0.4",
         "hypervel/context": "^0.4",
         "hypervel/contracts": "^0.4",
         "hypervel/reflection": "^0.4"

src/container/src/Attributes/Authenticated.php

@@ -5,19 +5,26 @@
 namespace Hypervel\Container\Attributes;
 
 use Attribute;
-use Hypervel\Contracts\Auth\Authenticatable;
+use Hypervel\Container\Attributes\Concerns\ExtractsPropertyValue;
 use Hypervel\Contracts\Container\Container;
 use Hypervel\Contracts\Container\ExecutionScopedAttribute;
 use UnitEnum;
 
 #[Attribute(Attribute::TARGET_PARAMETER)]
 class Authenticated implements ExecutionScopedAttribute
 {
+    use ExtractsPropertyValue;
+
     /**
      * Create a new class instance.
+     *
+     * Property paths use data_get() and may invoke object accessors or lazy-load
+     * Eloquent relationships.
      */
-    public function __construct(public UnitEnum|string|null $guard = null)
-    {
+    public function __construct(
+        public UnitEnum|string|null $guard = null,
+        public ?string $property = null,
+    ) {
     }
 
     /**
@@ -31,8 +38,10 @@ public function isExecutionScoped(): bool
     /**
      * Resolve the currently authenticated user.
      */
-    public static function resolve(self $attribute, Container $container): ?Authenticatable
+    public static function resolve(self $attribute, Container $container): mixed
     {
-        return call_user_func($container->make('auth')->userResolver(), $attribute->guard);
+        $value = call_user_func($container->make('auth')->userResolver(), $attribute->guard);
+
+        return $attribute->extractPropertyValue($value, $attribute->property);
     }
 }

src/container/src/Attributes/BindWhen.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hypervel\Container\Attributes;
+
+use Attribute;
+use Closure;
+
+/**
+ * Define a binding selected by a boot-stable condition.
+ *
+ * A matching condition becomes a normal worker-lifetime container binding.
+ */
+#[Attribute(Attribute::TARGET_CLASS | Attribute::IS_REPEATABLE)]
+class BindWhen
+{
+    /**
+     * The concrete class to bind to.
+     *
+     * @var class-string
+     */
+    public string $concrete;
+
+    /**
+     * The condition that determines if the binding should apply.
+     *
+     * @var Closure(\Hypervel\Contracts\Container\Container): bool
+     */
+    public Closure $condition;
+
+    /**
+     * Create a new attribute instance.
+     *
+     * @param class-string $concrete
+     * @param Closure(\Hypervel\Contracts\Container\Container): bool $condition
+     */
+    public function __construct(string $concrete, Closure $condition)
+    {
+        $this->concrete = $concrete;
+        $this->condition = $condition;
+    }
+}

src/container/src/Attributes/Concerns/ExtractsPropertyValue.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hypervel\Container\Attributes\Concerns;
+
+use Hypervel\Contracts\Container\BindingResolutionException;
+
+trait ExtractsPropertyValue
+{
+    /**
+     * Extract a property path from a contextual value.
+     *
+     * @throws BindingResolutionException
+     */
+    protected function extractPropertyValue(mixed $value, ?string $property): mixed
+    {
+        if ($property === null) {
+            return $value;
+        }
+
+        if (is_scalar($value)) {
+            throw new BindingResolutionException(sprintf(
+                'Cannot extract property path [%s] from scalar [%s] resolved by [%s].',
+                $property,
+                get_debug_type($value),
+                static::class,
+            ));
+        }
+
+        return data_get($value, $property);
+    }
+}

src/container/src/Attributes/RequestAttribute.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hypervel\Container\Attributes;
+
+use Attribute;
+use Hypervel\Contracts\Container\Container;
+use Hypervel\Contracts\Container\ExecutionScopedAttribute;
+use ReflectionParameter;
+
+#[Attribute(Attribute::TARGET_PARAMETER)]
+class RequestAttribute implements ExecutionScopedAttribute
+{
+    /**
+     * Create a new class instance.
+     */
+    public function __construct(public string $parameter)
+    {
+    }
+
+    /**
+     * Determine whether the resolved value belongs to the current execution.
+     */
+    public function isExecutionScoped(): bool
+    {
+        return true;
+    }
+
+    /**
+     * Resolve the request attribute.
+     */
+    public static function resolve(self $attribute, Container $container, ReflectionParameter $parameter): mixed
+    {
+        return $container->make('request')->attributes->get($attribute->parameter);
+    }
+}

src/container/src/Attributes/RouteParameter.php

@@ -5,18 +5,26 @@
 namespace Hypervel\Container\Attributes;
 
 use Attribute;
+use Hypervel\Container\Attributes\Concerns\ExtractsPropertyValue;
 use Hypervel\Contracts\Container\Container;
 use Hypervel\Contracts\Container\ExecutionScopedAttribute;
 use ReflectionParameter;
 
 #[Attribute(Attribute::TARGET_PARAMETER)]
 class RouteParameter implements ExecutionScopedAttribute
 {
+    use ExtractsPropertyValue;
+
     /**
      * Create a new class instance.
+     *
+     * Property paths use data_get() and may invoke object accessors or lazy-load
+     * Eloquent relationships.
      */
-    public function __construct(public ?string $parameter = null)
-    {
+    public function __construct(
+        public ?string $parameter = null,
+        public ?string $property = null,
+    ) {
     }
 
     /**
@@ -32,6 +40,8 @@ public function isExecutionScoped(): bool
      */
     public static function resolve(self $attribute, Container $container, ReflectionParameter $parameter): mixed
     {
-        return $container->make('request')->route($attribute->parameter ?? $parameter->getName());
+        $value = $container->make('request')->route($attribute->parameter ?? $parameter->getName());
+
+        return $attribute->extractPropertyValue($value, $attribute->property);
     }
 }