feat(Production): Complete production deployment infrastructure

- Add comprehensive health check system with multiple endpoints
- Add Prometheus metrics endpoint
- Add production logging configurations (5 strategies)
- Add complete deployment documentation suite:
  * QUICKSTART.md - 30-minute deployment guide
  * DEPLOYMENT_CHECKLIST.md - Printable verification checklist
  * DEPLOYMENT_WORKFLOW.md - Complete deployment lifecycle
  * PRODUCTION_DEPLOYMENT.md - Comprehensive technical reference
  * production-logging.md - Logging configuration guide
  * ANSIBLE_DEPLOYMENT.md - Infrastructure as Code automation
  * README.md - Navigation hub
  * DEPLOYMENT_SUMMARY.md - Executive summary
- Add deployment scripts and automation
- Add DEPLOYMENT_PLAN.md - Concrete plan for immediate deployment
- Update README with production-ready features

All production infrastructure is now complete and ready for deployment.

src/Framework/Design/ValueObjects/CssParseResult.php

@@ -4,7 +4,7 @@ declare(strict_types=1);
 
 namespace App\Framework\Design\ValueObjects;
 
-use App\Framework\Filesystem\FilePath;
+use App\Framework\Filesystem\ValueObjects\FilePath;
 
 /**
  * Ergebnis des CSS-Parsing-Prozesses

src/Framework/Design/ValueObjects/ThemeMode.php

@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+/**
+ * Theme Mode Enum
+ *
+ * Generic theme mode for any themeable component in the framework.
+ * Supports light, dark, and automatic (system preference) modes.
+ */
+enum ThemeMode: string
+{
+    case LIGHT = 'light';
+    case DARK = 'dark';
+    case AUTO = 'auto';
+
+    public function isLight(): bool
+    {
+        return $this === self::LIGHT;
+    }
+
+    public function isDark(): bool
+    {
+        return $this === self::DARK;
+    }
+
+    public function isAuto(): bool
+    {
+        return $this === self::AUTO;
+    }
+
+    /**
+     * Get CSS data-theme attribute value
+     */
+    public function toDataAttribute(): string
+    {
+        return match ($this) {
+            self::LIGHT => 'light',
+            self::DARK => 'dark',
+            self::AUTO => '', // No attribute for auto mode
+        };
+    }
+
+    /**
+     * Get CSS class name
+     */
+    public function toCssClass(string $prefix = 'theme'): string
+    {
+        return "{$prefix}-{$this->value}";
+    }
+}