| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230 |
- <?php
-
- namespace App\StorePlan\Ai;
-
- use App\StorePlan\PlanSchema;
-
- /**
- * Applies the small "what to change" answer of a chat edit to an existing plan.
- *
- * The result is not trusted here. PlanWriter runs it through PlanValidator afterwards,
- * so a bad change is rejected instead of saved.
- */
- final class PlanChanges
- {
- /**
- * @param array<string, mixed> $plan
- * @param array<string, mixed> $changes
- * @return array<string, mixed>
- */
- public static function apply(array $plan, array $changes): 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']);
- }
-
- // Header and footer: a new variant and/or some content fields.
- foreach (['header', 'footer'] as $part) {
- if (is_array($changes[$part] ?? null) && is_array($plan[$part] ?? null)) {
- $plan[$part] = self::merge($plan[$part], $changes[$part]);
- }
- }
-
- $pages = array_values(array_filter($plan['pages'] ?? [], 'is_array'));
-
- // Remove whole pages. The home page can never be removed.
- $removePages = array_filter(self::list($changes, 'remove_pages'), 'is_string');
- $pages = array_values(array_filter(
- $pages,
- fn (array $page) => ($page['id'] ?? null) === PlanSchema::HOME_PAGE || ! in_array($page['id'] ?? null, $removePages, true),
- ));
-
- // Rename pages.
- foreach (self::list($changes, 'update_pages') as $update) {
- foreach ($pages as $index => $page) {
- if (is_array($update) && ($page['id'] ?? null) === ($update['id'] ?? null) && is_string($update['title'] ?? null)) {
- $pages[$index]['title'] = $update['title'];
- }
- }
- }
-
- // Add whole new pages, at the end.
- $addedPages = [];
-
- foreach (self::list($changes, 'add_pages') as $page) {
- if (is_array($page)) {
- $pages[] = $page;
- $addedPages[] = $page;
- }
- }
-
- // We do not rely on the AI to keep the menus right: links to removed pages go,
- // and every new page gets a link so shoppers can reach it.
- $plan = self::dropLinksTo($plan, array_diff($removePages, [PlanSchema::HOME_PAGE]));
-
- foreach ($addedPages as $page) {
- $plan = self::ensureLinkTo($plan, $page);
- }
- $remove = array_filter(self::list($changes, 'remove'), 'is_string');
- $order = array_values(array_filter(self::list($changes, 'order'), 'is_string'));
-
- foreach ($pages as $pageIndex => $page) {
- $sections = array_values(array_filter($page['sections'] ?? [], 'is_array'));
-
- // Update: change the variant and/or some content fields of existing sections.
- foreach (self::list($changes, 'update') as $update) {
- foreach ($sections as $index => $section) {
- if (is_array($update) && ($section['id'] ?? null) === ($update['id'] ?? null)) {
- $sections[$index] = self::merge($section, $update);
- }
- }
- }
-
- // 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 of the named page (the home page if none is named).
- foreach (self::list($changes, 'add') as $addition) {
- $section = is_array($addition) ? ($addition['section'] ?? null) : null;
-
- if (! is_array($section) || ($addition['page'] ?? PlanSchema::HOME_PAGE) !== ($page['id'] ?? null)) {
- 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 on the page whose sections it names exactly once each.
- $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);
- }
-
- $pages[$pageIndex]['sections'] = $sections;
- }
-
- $plan['pages'] = $pages;
-
- return $plan;
- }
-
- /**
- * Remove header and footer links that point to the given pages.
- *
- * @param array<string, mixed> $plan
- * @param array<int, string> $pageIds
- * @return array<string, mixed>
- */
- private static function dropLinksTo(array $plan, array $pageIds): array
- {
- if ($pageIds === []) {
- return $plan;
- }
-
- foreach (['header', 'footer'] as $part) {
- $links = $plan[$part]['content']['links'] ?? null;
-
- if (is_array($links)) {
- $plan[$part]['content']['links'] = array_values(array_filter(
- $links,
- fn (mixed $link) => ! is_array($link) || ! in_array(self::pageOf($link['href'] ?? null), $pageIds, true),
- ));
- }
- }
-
- return $plan;
- }
-
- /**
- * Make sure the header or the footer links to a new page. The header is used while it has room.
- *
- * @param array<string, mixed> $plan
- * @param array<mixed> $page
- * @return array<string, mixed>
- */
- private static function ensureLinkTo(array $plan, array $page): array
- {
- $id = $page['id'] ?? null;
- $title = $page['title'] ?? null;
-
- if (! is_string($id) || ! is_string($title)) {
- return $plan;
- }
-
- foreach (['header', 'footer'] as $part) {
- foreach ($plan[$part]['content']['links'] ?? [] as $link) {
- if (is_array($link) && self::pageOf($link['href'] ?? null) === $id) {
- return $plan;
- }
- }
- }
-
- // The limits match PlanSchema: 6 header links, 8 footer links.
- foreach (['header' => 6, 'footer' => 8] as $part => $limit) {
- $links = $plan[$part]['content']['links'] ?? null;
-
- if (is_array($links) && count($links) < $limit) {
- $plan[$part]['content']['links'][] = ['label' => mb_substr($title, 0, 30), 'href' => '/'.$id];
-
- return $plan;
- }
- }
-
- return $plan;
- }
-
- /**
- * The page id a link such as "/about" or "/about#team" points to, or null for any other kind of link.
- */
- private static function pageOf(mixed $href): ?string
- {
- if (! is_string($href) || ! str_starts_with($href, '/')) {
- return null;
- }
-
- return explode('/', ltrim((string) preg_replace('/[?#].*$/', '', $href), '/'))[0];
- }
-
- /**
- * Take a new variant and replace only the content fields that were given.
- *
- * @param array<string, mixed> $section
- * @param array<string, mixed> $update
- * @return array<string, mixed>
- */
- private static function merge(array $section, array $update): array
- {
- if (is_string($update['variant'] ?? null)) {
- $section['variant'] = $update['variant'];
- }
-
- if (is_array($update['content'] ?? null)) {
- $section['content'] = array_replace($section['content'] ?? [], $update['content']);
- }
-
- return $section;
- }
-
- /**
- * @param array<string, mixed> $changes
- * @return array<mixed>
- */
- private static function list(array $changes, string $key): array
- {
- return is_array($changes[$key] ?? null) ? $changes[$key] : [];
- }
- }
|