create-prisma-php-app 3.0.3 → 3.1.0

package/dist/bootstrap.php

@@ -22,7 +22,7 @@ use Lib\ErrorHandler;
 use Firebase\JWT\JWT;
 use Firebase\JWT\Key;
 
-final class Bootstrap
+final class Bootstrap extends RuntimeException
 {
     public static string $contentToInclude = '';
     public static array $layoutsToInclude = [];
@@ -35,12 +35,22 @@ final class Bootstrap
     public static bool $secondRequestC69CD = false;
     public static array $requestFilesData = [];
 
+    private string $context;
+
     private static array $fileExistCache = [];
     private static array $regexCache = [];
 
-    /**
-     * Main entry point to run the entire routing and rendering logic.
-     */
+    public function __construct(string $message, string $context = '', int $code = 0, ?Throwable $previous = null)
+    {
+        $this->context = $context;
+        parent::__construct($message, $code, $previous);
+    }
+
+    public function getContext(): string
+    {
+        return $this->context;
+    }
+
     public static function run(): void
     {
         // Load environment variables
@@ -1025,15 +1035,18 @@ try {
     }
 } catch (Throwable $e) {
     if (Bootstrap::isAjaxOrXFileRequestOrRouteFile()) {
-        $errorDetails = "Unhandled Exception: " . $e->getMessage() .
-            " in " . $e->getFile() .
-            " on line " . $e->getLine();
+        $errorDetails = json_encode([
+            'success' => false,
+            'error' => [
+                'type' => get_class($e),
+                'message' => $e->getMessage(),
+                'file' => $e->getFile(),
+                'line' => $e->getLine(),
+                'trace' => $e->getTraceAsString()
+            ]
+        ]);
     } else {
-        $errorDetails = "Unhandled Exception: " . htmlspecialchars($e->getMessage(), ENT_QUOTES, 'UTF-8');
-        $errorDetails .= "<br>File: " . htmlspecialchars($e->getFile(), ENT_QUOTES, 'UTF-8');
-        $errorDetails .= "<br>Line: " . htmlspecialchars((string)$e->getLine(), ENT_QUOTES, 'UTF-8');
-        $errorDetails .= "<br/>TraceAsString: " . htmlspecialchars($e->getTraceAsString(), ENT_QUOTES, 'UTF-8');
-        $errorDetails = "<div class='error'>{$errorDetails}</div>";
+        $errorDetails = ErrorHandler::formatExceptionForDisplay($e);
     }
     ErrorHandler::modifyOutputLayoutForError($errorDetails);
 }

package/dist/src/Lib/ErrorHandler.php

@@ -4,6 +4,8 @@ namespace Lib;
 
 use Bootstrap;
 use Lib\MainLayout;
+use Throwable;
+use Lib\PHPX\Exceptions\ComponentValidationException;
 
 class ErrorHandler
 {
@@ -123,4 +125,196 @@ class ErrorHandler
         }
         exit;
     }
+
+    public static function formatExceptionForDisplay(Throwable $exception): string
+    {
+        // Handle specific exception types
+        if ($exception instanceof ComponentValidationException) {
+            return self::formatComponentValidationError($exception);
+        }
+
+        // Handle template compilation errors specifically
+        if (strpos($exception->getMessage(), 'Invalid prop') !== false) {
+            return self::formatTemplateCompilerError($exception);
+        }
+
+        // Generic exception formatting
+        return self::formatGenericException($exception);
+    }
+
+    private static function formatComponentValidationError(ComponentValidationException $exception): string
+    {
+        $message = htmlspecialchars($exception->getMessage(), ENT_QUOTES, 'UTF-8');
+        $file = htmlspecialchars($exception->getFile(), ENT_QUOTES, 'UTF-8');
+        $line = $exception->getLine();
+
+        // Get the details from the ComponentValidationException
+        $propName = method_exists($exception, 'getPropName') ? $exception->getPropName() : 'unknown';
+        $componentName = method_exists($exception, 'getComponentName') ? $exception->getComponentName() : 'unknown';
+        $availableProps = method_exists($exception, 'getAvailableProps') ? $exception->getAvailableProps() : [];
+
+        $availablePropsString = !empty($availableProps) ? implode(', ', $availableProps) : 'none defined';
+
+        return <<<HTML
+    <div class="error-container max-w-4xl mx-auto mt-8 bg-red-50 border border-red-200 rounded-lg shadow-lg">
+        <div class="bg-red-100 px-6 py-4 border-b border-red-200">
+            <h2 class="text-xl font-bold text-red-800 flex items-center">
+                <svg class="w-6 h-6 mr-2" fill="currentColor" viewBox="0 0 20 20">
+                    <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7 4a1 1 0 11-2 0 1 1 0 012 0zm-1-9a1 1 0 00-1 1v4a1 1 0 102 0V6a1 1 0 00-1-1z" clip-rule="evenodd"></path>
+                </svg>
+                Component Validation Error
+            </h2>
+        </div>
+        
+        <div class="p-6">
+            <div class="bg-white border border-red-200 rounded-lg p-4 mb-4">
+                <div class="mb-3">
+                    <span class="inline-block bg-red-100 text-red-800 px-3 py-1 rounded-full text-sm font-medium">
+                        Component: {$componentName}
+                    </span>
+                    <span class="inline-block bg-red-100 text-red-800 px-3 py-1 rounded-full text-sm font-medium ml-2">
+                        Invalid Prop: {$propName}
+                    </span>
+                </div>
+                <pre class="text-sm text-red-800 whitespace-pre-wrap font-mono">{$message}</pre>
+            </div>
+            
+            <div class="text-sm text-gray-600 mb-4">
+                <strong>File:</strong> <code class="bg-gray-100 px-2 py-1 rounded text-xs">{$file}</code><br />
+                <strong>Line:</strong> <span class="bg-gray-100 px-2 py-1 rounded text-xs">{$line}</span>
+            </div>
+            
+            <div class="bg-blue-50 border border-blue-200 rounded-lg p-4 mb-4">
+                <h4 class="font-medium text-blue-800 mb-2">💡 Available Props:</h4>
+                <p class="text-blue-700 text-sm">
+                    <code class="bg-blue-100 px-2 py-1 rounded text-xs">{$availablePropsString}</code>
+                </p>
+            </div>
+            
+            <div class="bg-green-50 border border-green-200 rounded-lg p-4 mb-4">
+                <h4 class="font-medium text-green-800 mb-2">🔧 Quick Fixes:</h4>
+                <ul class="text-green-700 text-sm space-y-1">
+                    <li>• Remove the '<code>{$propName}</code>' prop from your template</li>
+                    <li>• Add '<code>public \${$propName};</code>' to your <code>{$componentName}</code> component class</li>
+                    <li>• Use data attributes: '<code>data-{$propName}</code>' instead</li>
+                </ul>
+            </div>
+            
+            <details class="mt-4">
+                <summary class="cursor-pointer text-red-600 font-medium hover:text-red-800 select-none">
+                    Show Stack Trace
+                </summary>
+                <div class="mt-3 bg-gray-50 border border-gray-200 rounded p-4">
+                    <pre class="text-xs text-gray-700 overflow-auto whitespace-pre-wrap max-h-96">{$exception->getTraceAsString()}</pre>
+                </div>
+            </details>
+        </div>
+    </div>
+    HTML;
+    }
+
+    private static function formatTemplateCompilerError(Throwable $exception): string
+    {
+        $message = htmlspecialchars($exception->getMessage(), ENT_QUOTES, 'UTF-8');
+        $file = htmlspecialchars($exception->getFile(), ENT_QUOTES, 'UTF-8');
+        $line = $exception->getLine();
+
+        // Extract the component validation error details
+        if (preg_match("/Invalid prop '([^']+)' passed to component '([^']+)'/", $exception->getMessage(), $matches)) {
+            $invalidProp = $matches[1];
+            $componentName = $matches[2];
+
+            return <<<HTML
+        <div class="error-container max-w-4xl mx-auto mt-8 bg-red-50 border border-red-200 rounded-lg shadow-lg">
+            <div class="bg-red-100 px-6 py-4 border-b border-red-200">
+                <h2 class="text-xl font-bold text-red-800 flex items-center">
+                    <svg class="w-6 h-6 mr-2" fill="currentColor" viewBox="0 0 20 20">
+                        <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7 4a1 1 0 11-2 0 1 1 0 012 0zm-1-9a1 1 0 00-1 1v4a1 1 0 102 0V6a1 1 0 00-1-1z" clip-rule="evenodd"></path>
+                    </svg>
+                    Template Compilation Error
+                </h2>
+            </div>
+            
+            <div class="p-6">
+                <div class="bg-white border border-red-200 rounded-lg p-4 mb-4">
+                    <div class="mb-3">
+                        <span class="inline-block bg-red-100 text-red-800 px-3 py-1 rounded-full text-sm font-medium">
+                            Component: {$componentName}
+                        </span>
+                        <span class="inline-block bg-red-100 text-red-800 px-3 py-1 rounded-full text-sm font-medium ml-2">
+                            Invalid Prop: {$invalidProp}
+                        </span>
+                    </div>
+                    <p class="text-red-800 font-medium">{$message}</p>
+                </div>
+                
+                <div class="text-sm text-gray-600 mb-4">
+                    <strong>File:</strong> {$file}<br />
+                    <strong>Line:</strong> {$line}
+                </div>
+                
+                <div class="bg-blue-50 border border-blue-200 rounded-lg p-4 mb-4">
+                    <h4 class="font-medium text-blue-800 mb-2">💡 Quick Fix:</h4>
+                    <p class="text-blue-700 text-sm">
+                        Either remove the '<code>{$invalidProp}</code>' prop from your template, or add it as a public property to your <code>{$componentName}</code> component class.
+                    </p>
+                </div>
+                
+                <details class="mt-4">
+                    <summary class="cursor-pointer text-red-600 font-medium hover:text-red-800 select-none">
+                        Show Stack Trace
+                    </summary>
+                    <div class="mt-3 bg-gray-50 border border-gray-200 rounded p-4">
+                        <pre class="text-xs text-gray-700 overflow-auto whitespace-pre-wrap">{$exception->getTraceAsString()}</pre>
+                    </div>
+                </details>
+            </div>
+        </div>
+        HTML;
+        }
+
+        // Fallback to generic formatting
+        return self::formatGenericException($exception);
+    }
+
+    private static function formatGenericException(Throwable $exception): string
+    {
+        $type = htmlspecialchars(get_class($exception), ENT_QUOTES, 'UTF-8');
+        $message = htmlspecialchars($exception->getMessage(), ENT_QUOTES, 'UTF-8');
+        $file = htmlspecialchars($exception->getFile(), ENT_QUOTES, 'UTF-8');
+        $line = $exception->getLine();
+
+        return <<<HTML
+    <div class="error-container max-w-4xl mx-auto mt-8 bg-red-50 border border-red-200 rounded-lg shadow-lg">
+        <div class="bg-red-100 px-6 py-4 border-b border-red-200">
+            <h2 class="text-xl font-bold text-red-800 flex items-center">
+                <svg class="w-6 h-6 mr-2" fill="currentColor" viewBox="0 0 20 20">
+                    <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7 4a1 1 0 11-2 0 1 1 0 012 0zm-1-9a1 1 0 00-1 1v4a1 1 0 102 0V6a1 1 0 00-1-1z" clip-rule="evenodd"></path>
+                </svg>
+                {$type}
+            </h2>
+        </div>
+        
+        <div class="p-6">
+            <div class="bg-white border border-red-200 rounded-lg p-4 mb-4">
+                <p class="text-red-800 font-medium break-words">{$message}</p>
+            </div>
+            
+            <div class="text-sm text-gray-600 mb-4">
+                <strong>File:</strong> <code class="bg-gray-100 px-2 py-1 rounded text-xs">{$file}</code><br />
+                <strong>Line:</strong> <span class="bg-gray-100 px-2 py-1 rounded text-xs">{$line}</span>
+            </div>
+            
+            <details class="mt-4">
+                <summary class="cursor-pointer text-red-600 font-medium hover:text-red-800 select-none">
+                    Show Stack Trace
+                </summary>
+                <div class="mt-3 bg-gray-50 border border-gray-200 rounded p-4">
+                    <pre class="text-xs text-gray-700 overflow-auto whitespace-pre-wrap max-h-96">{$exception->getTraceAsString()}</pre>
+                </div>
+            </details>
+        </div>
+    </div>
+    HTML;
+    }
 }

package/dist/src/Lib/IncludeTracker.php

@@ -4,10 +4,6 @@ namespace Lib;
 
 use RuntimeException;
 use InvalidArgumentException;
-use Lib\PrismaPHPSettings;
-use DOMDocument;
-use DOMElement;
-use DOMXPath;
 use Lib\PHPX\TemplateCompiler;
 
 class IncludeTracker
@@ -15,7 +11,7 @@ class IncludeTracker
     public static array $sections = [];
 
     /**
-     * Includes and echoes a file wrapped in a unique pp-section-id container.
+     * Includes and echoes a file wrapped in a unique pp-component container.
      * Supported $mode values: 'include', 'include_once', 'require', 'require_once'
      *
      * @param string $filePath The path to the file to be included.
@@ -43,8 +39,6 @@ class IncludeTracker
         $wrapped  = self::wrapWithId($filePath, $html);
         $fragDom  = TemplateCompiler::convertToXml($wrapped);
 
-        self::prefixInlineHandlers($fragDom);
-
         $newHtml = TemplateCompiler::innerXml($fragDom);
 
         self::$sections[$filePath] = [
@@ -58,39 +52,6 @@ class IncludeTracker
     private static function wrapWithId(string $filePath, string $html): string
     {
         $id = 's' . base_convert(sprintf('%u', crc32($filePath)), 10, 36);
-        return "<div pp-section-id=\"$id\">\n$html\n</div>";
-    }
-
-    private static function prefixInlineHandlers(DOMDocument $doc): void
-    {
-        $xp = new DOMXPath($doc);
-
-        /** @var DOMElement $el */
-        foreach ($xp->query('//*') as $el) {
-            $handlers = [];
-
-            foreach (iterator_to_array($el->attributes) as $attr) {
-                $name = $attr->name;
-
-                if (!str_starts_with($name, 'on')) {
-                    continue;
-                }
-
-                $event = substr($name, 2);
-                if (
-                    !in_array($event, PrismaPHPSettings::$htmlEvents, true) ||
-                    trim($attr->value) === ''
-                ) {
-                    continue;
-                }
-
-                $handlers[$name] = $attr->value;
-                $el->removeAttribute($name);
-            }
-
-            foreach ($handlers as $origName => $value) {
-                $el->setAttribute("pp-inc-{$origName}", $value);
-            }
-        }
+        return "<div pp-component=\"$id\">\n$html\n</div>";
     }
 }

package/dist/src/Lib/PHPX/Exceptions/ComponentValidationException.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace Lib\PHPX\Exceptions;
+
+use RuntimeException;
+
+class ComponentValidationException extends RuntimeException
+{
+    private string $propName;
+    private string $componentName;
+    private array $availableProps;
+
+    public function __construct(
+        string $propName,
+        string $componentName,
+        array $availableProps,
+        string $context = ''
+    ) {
+        $this->propName = $propName;
+        $this->componentName = $componentName;
+        $this->availableProps = $availableProps;
+
+        $availableList = implode(', ', $availableProps);
+
+        $message = "Invalid prop '{$propName}' for component '{$componentName}'.\n";
+        $message .= "Available props: {$availableList}";
+
+        if ($context) {
+            $message .= "\n{$context}";
+        }
+
+        parent::__construct($message);
+    }
+
+    public function getPropName(): string
+    {
+        return $this->propName;
+    }
+
+    public function getComponentName(): string
+    {
+        return $this->componentName;
+    }
+
+    public function getAvailableProps(): array
+    {
+        return $this->availableProps;
+    }
+}

package/dist/src/Lib/PHPX/PHPX.php

@@ -19,11 +19,6 @@ class PHPX implements IPHPX
      */
     public mixed $children;
 
-    /**
-     * @var string The CSS class for custom styling.
-     */
-    protected string $class;
-
     /**
      * @var array<string, mixed> The array representation of the HTML attributes.
      */
@@ -38,27 +33,27 @@ class PHPX implements IPHPX
     {
         $this->props = $props;
         $this->children = $props['children'] ?? '';
-        $this->class = $props['class'] ?? '';
     }
 
     /**
      * Combines and returns the CSS classes for the component.
      *
      * This method merges the provided classes, which can be either strings or arrays of strings,
-     * with the component's `$class` property. It uses the `Utils::mergeClasses` method to ensure
-     * that the resulting CSS class string is optimized, with duplicate or conflicting classes removed.
+     * without automatically including the component's `$class` property. It uses the `Utils::mergeClasses`
+     * method to ensure that the resulting CSS class string is optimized, with duplicate or conflicting
+     * classes removed.
      *
      * ### Features:
      * - Accepts multiple arguments as strings or arrays of strings.
-     * - Automatically merges the provided classes with `$this->class`.
+     * - Only merges the classes provided as arguments (does not include `$this->class` automatically).
      * - Ensures the final CSS class string is well-formatted and free of conflicts.
      *
      * @param string|array ...$classes The CSS classes to be merged. Each argument can be a string or an array of strings.
-     * @return string A single CSS class string with the merged and optimized classes, including `$this->class`.
+     * @return string A single CSS class string with the merged and optimized classes.
      */
     protected function getMergeClasses(string|array ...$classes): string
     {
-        $all = array_merge($classes, [$this->class]);
+        $all = array_merge($classes);
 
         $expr = [];
         foreach ($all as &$chunk) {

package/dist/src/Lib/PHPX/TemplateCompiler.php

@@ -14,11 +14,11 @@ use DOMText;
 use RuntimeException;
 use Bootstrap;
 use LibXMLError;
-use DOMXPath;
 use ReflectionClass;
 use ReflectionProperty;
 use ReflectionType;
 use ReflectionNamedType;
+use Lib\PHPX\Exceptions\ComponentValidationException;
 
 class TemplateCompiler
 {
@@ -30,6 +30,11 @@ class TemplateCompiler
         'kbd'  => true,
         'var'  => true,
     ];
+    private const SYSTEM_PROPS = [
+        'children' => true,
+        'key' => true,
+        'ref' => true,
+    ];
 
     protected static array $classMappings = [];
     protected static array $selfClosingTags = [
@@ -56,6 +61,7 @@ class TemplateCompiler
     private static array $reflections       = [];
     private static array $constructors      = [];
     private static array $publicProperties  = [];
+    private static array $allowedProps = [];
 
     public static function compile(string $templateContent): string
     {
@@ -276,8 +282,8 @@ class TemplateCompiler
                 $node->setAttribute('type', 'text/php');
             }
 
-            if ($node->hasAttribute('pp-section-id')) {
-                self::$sectionStack[] = $node->getAttribute('pp-section-id');
+            if ($node->hasAttribute('pp-component')) {
+                self::$sectionStack[] = $node->getAttribute('pp-component');
                 $pushed = true;
             }
 
@@ -361,7 +367,6 @@ class TemplateCompiler
         string $componentName,
         array $incomingProps
     ): string {
-        $incomingProps = self::sanitizeIncomingProps($incomingProps);
         $mapping       = self::selectComponentMapping($componentName);
         $instance      = self::initializeComponentInstance($mapping, $incomingProps);
 
@@ -370,7 +375,7 @@ class TemplateCompiler
             $childHtml .= self::processNode($c);
         }
 
-        $instance->children = self::sanitizeEventAttributes($childHtml);
+        $instance->children = $childHtml;
 
         $baseId   = 's' . base_convert(sprintf('%u', crc32($mapping['className'])), 10, 36);
         $idx      = self::$componentInstanceCounts[$baseId] ?? 0;
@@ -379,55 +384,10 @@ class TemplateCompiler
 
         $html     = $instance->render();
         $fragDom  = self::convertToXml($html);
-        $xpath    = new DOMXPath($fragDom);
-
-        /** @var DOMElement $el */
-        foreach ($xpath->query('//*') as $el) {
-
-            $tag = $el->tagName;
-            if (ctype_upper($tag[0]) || isset(self::$classMappings[$tag])) {
-                continue;
-            }
-
-            $originalEvents  = [];
-            $componentEvents = [];
-
-            foreach (iterator_to_array($el->attributes) as $attr) {
-                $name  = $attr->name;
-                $value = $attr->value;
-
-                if (str_starts_with($name, 'pp-original-')) {
-                    $origName                   = substr($name, strlen('pp-original-'));
-                    $originalEvents[$origName]  = $value;
-                } elseif (str_starts_with($name, 'on')) {
-                    $event = substr($name, 2);
-                    if ($value !== '' && in_array($event, PrismaPHPSettings::$htmlEvents, true)) {
-                        $componentEvents[$name] = $value;
-                    }
-                }
-            }
-
-            foreach (array_keys($originalEvents)  as $k) $el->removeAttribute("pp-original-{$k}");
-            foreach (array_keys($componentEvents) as $k) $el->removeAttribute($k);
-
-            foreach ($componentEvents as $evAttr => $compValue) {
-                $el->setAttribute("data-pp-child-{$evAttr}", $compValue);
-
-                if (isset($originalEvents[$evAttr])) {
-                    $el->setAttribute("data-pp-parent-{$evAttr}", $originalEvents[$evAttr]);
-                    unset($originalEvents[$evAttr]);
-                }
-            }
-
-            foreach ($originalEvents as $name => $value) {
-                $el->setAttribute($name, $value);
-            }
-        }
-
         $root = $fragDom->documentElement;
         foreach ($root->childNodes as $c) {
             if ($c instanceof DOMElement) {
-                $c->setAttribute('pp-phpx-id', $sectionId);
+                $c->setAttribute('pp-component', $sectionId);
                 break;
             }
         }
@@ -444,53 +404,6 @@ class TemplateCompiler
         return $htmlOut;
     }
 
-    protected static function sanitizeIncomingProps(array $props): array
-    {
-        foreach ($props as $key => $val) {
-            if (str_starts_with($key, 'on')) {
-                $event = substr($key, 2);
-                if (in_array($event, PrismaPHPSettings::$htmlEvents, true) && trim((string)$val) !== '') {
-                    $props["pp-original-on{$event}"] = (string)$val;
-                    unset($props[$key]);
-                }
-            }
-        }
-
-        return $props;
-    }
-
-    protected static function sanitizeEventAttributes(string $html): string
-    {
-        $fragDom = self::convertToXml($html, false);
-        $xpath   = new DOMXPath($fragDom);
-
-        /** @var DOMElement $el */
-        foreach ($xpath->query('//*') as $el) {
-            foreach (iterator_to_array($el->attributes) as $attr) {
-                $name = strtolower($attr->name);
-
-                if (!str_starts_with($name, 'on')) {
-                    continue;
-                }
-
-                $event = substr($name, 2);
-                $value = trim($attr->value);
-
-                if ($value !== '' && in_array($event, PrismaPHPSettings::$htmlEvents, true)) {
-                    $el->setAttribute("pp-original-on{$event}", $value);
-                }
-
-                $el->removeAttribute($name);
-            }
-        }
-
-        $body = $fragDom->getElementsByTagName('body')[0] ?? null;
-
-        return $body instanceof DOMElement
-            ? self::innerXml($body)
-            : self::innerXml($fragDom);
-    }
-
     private static function selectComponentMapping(string $componentName): array
     {
         if (!isset(self::$classMappings[$componentName])) {
@@ -529,16 +442,20 @@ class TemplateCompiler
             throw new RuntimeException("Class {$className} not found");
         }
 
+        self::cacheClassReflection($className);
+
         if (!isset(self::$reflections[$className])) {
             $rc = new ReflectionClass($className);
             self::$reflections[$className]      = $rc;
             self::$constructors[$className]     = $rc->getConstructor();
             self::$publicProperties[$className] = array_filter(
                 $rc->getProperties(ReflectionProperty::IS_PUBLIC),
-                fn(ReflectionProperty $p) => ! $p->isStatic()
+                fn(ReflectionProperty $p) => !$p->isStatic()
             );
         }
 
+        self::validateComponentProps($className, $attributes);
+
         $ref  = self::$reflections[$className];
         $ctor = self::$constructors[$className];
         $inst = $ref->newInstanceWithoutConstructor();
@@ -560,6 +477,51 @@ class TemplateCompiler
         return $inst;
     }
 
+    private static function cacheClassReflection(string $className): void
+    {
+        if (isset(self::$reflections[$className])) {
+            return;
+        }
+
+        $rc = new ReflectionClass($className);
+        self::$reflections[$className] = $rc;
+        self::$constructors[$className] = $rc->getConstructor();
+
+        $publicProps = array_filter(
+            $rc->getProperties(ReflectionProperty::IS_PUBLIC),
+            fn(ReflectionProperty $p) => !$p->isStatic()
+        );
+        self::$publicProperties[$className] = $publicProps;
+
+        $allowed = self::SYSTEM_PROPS;
+        foreach ($publicProps as $prop) {
+            $allowed[$prop->getName()] = true;
+        }
+        self::$allowedProps[$className] = $allowed;
+    }
+
+    private static function validateComponentProps(string $className, array $attributes): void
+    {
+        foreach (self::$publicProperties[$className] as $prop) {
+            $name = $prop->getName();
+            $type = $prop->getType();
+
+            if (
+                $type instanceof ReflectionNamedType && $type->isBuiltin()
+                && ! $type->allowsNull()
+                && ! array_key_exists($name, $attributes)
+            ) {
+                throw new ComponentValidationException(
+                    $name,
+                    $className,
+                    array_map(fn($p) => $p->getName(), self::$publicProperties[$className])
+                );
+            }
+        }
+
+        return;
+    }
+
     private static function coerce(mixed $value, ?ReflectionType $type): mixed
     {
         if (!$type instanceof ReflectionNamedType || $type->isBuiltin() === false) {