From da250020ccbe4306c93d66ea673cee735e39c57b Mon Sep 17 00:00:00 2001
From: sayah mohamed jad <46792072+Sloyni@users.noreply.github.com>
Date: Tue, 17 Feb 2026 12:01:21 +0000
Subject: [PATCH] Add optional config migration for themes (#526)

---
 .../Controllers/Admin/ThemeController.php     | 34 ++++++++++++++++---
 1 file changed, 29 insertions(+), 5 deletions(-)

diff --git a/app/Http/Controllers/Admin/ThemeController.php b/app/Http/Controllers/Admin/ThemeController.php
index 15306c395..e75e6a261 100644
--- a/app/Http/Controllers/Admin/ThemeController.php
+++ b/app/Http/Controllers/Admin/ThemeController.php
@@ -83,8 +83,16 @@ public function update(string $theme)
 
                 if ($oldConfig !== null) {
                     $newConfig = $this->themes->readConfig($theme) ?? [];
+                    $migratePath = $this->themes->path('config/migrate.php', $theme);
+                    $mergeStrategy = $this->files->exists($migratePath)
+                        ? $this->files->getRequire($migratePath)
+                        : null;
 
-                    $this->themes->updateConfig($theme, array_merge($newConfig, $oldConfig));
+                    $mergedConfig = is_callable($mergeStrategy)
+                        ? $mergeStrategy($oldConfig, $newConfig)
+                        : array_merge($newConfig, $oldConfig);
+
+                    $this->themes->updateConfig($theme, $mergedConfig);
                 }
 
                 if ($this->themes->isLegacy($theme)) {
@@ -210,12 +218,28 @@ public function changeTheme($theme = null)
             ->with('success', trans('admin.themes.updated'));
     }
 
-    protected static function appendConfig(array $config, array $replacement)
+    protected static function appendConfig(array $config, array $replacement): array
     {
         foreach ($replacement as $key => $value) {
-            $config[$key] = is_array($value)
-                ? static::appendConfig($config[$key], $value)
-                : $value;
+            if (! is_array($value)) {
+                $config[$key] = $value;
+                continue;
+            }
+
+            // Replace instead of merge when `$replace` key is set to true
+            if ($value['$replace'] ?? false) {
+                unset($value['$replace']);
+                $config[$key] = $value;
+                continue;
+            }
+
+            // Replace numeric arrays (lists) instead of merging
+            if (array_is_list($value)) {
+                $config[$key] = $value;
+                continue;
+            }
+
+            $config[$key] = static::appendConfig($config[$key] ?? [], $value);
         }
 
         return $config;