$plan * @param array $changes * @return array */ public static function apply(array $plan, array $changes): array { $sections = array_values(array_filter($plan['sections'] ?? [], 'is_array')); // Theme: merge only the parts that were given. if (is_array($changes['theme'] ?? null) && is_array($plan['theme'] ?? null)) { $plan['theme'] = array_replace_recursive($plan['theme'], $changes['theme']); } // Update: change the variant and/or some content fields of existing sections. foreach (self::list($changes, 'update') as $update) { if (! is_array($update)) { continue; } foreach ($sections as $index => $section) { if (($section['id'] ?? null) !== ($update['id'] ?? null)) { continue; } if (is_string($update['variant'] ?? null)) { $sections[$index]['variant'] = $update['variant']; } if (is_array($update['content'] ?? null)) { $sections[$index]['content'] = array_replace($section['content'] ?? [], $update['content']); } } } // Remove. $remove = array_filter(self::list($changes, 'remove'), 'is_string'); if ($remove !== []) { $sections = array_values(array_filter( $sections, fn (array $section) => ! in_array($section['id'] ?? null, $remove, true), )); } // Add: after a named section, or at the end. foreach (self::list($changes, 'add') as $addition) { $section = is_array($addition) ? ($addition['section'] ?? null) : null; if (! is_array($section)) { continue; } $position = count($sections); foreach ($sections as $index => $existing) { if (($existing['id'] ?? null) === ($addition['after'] ?? null)) { $position = $index + 1; } } array_splice($sections, $position, 0, [$section]); } // Order: only used when it names every section exactly once. $order = array_values(array_filter(self::list($changes, 'order'), 'is_string')); $ids = array_column($sections, 'id'); if ($order !== [] && count($order) === count($ids) && array_diff($ids, $order) === [] && array_diff($order, $ids) === []) { $byId = array_column($sections, null, 'id'); $sections = array_map(fn (string $id) => $byId[$id], $order); } $plan['sections'] = $sections; return $plan; } /** * @param array $changes * @return array */ private static function list(array $changes, string $key): array { return is_array($changes[$key] ?? null) ? $changes[$key] : []; } }