<?php
/**
 * Content Studio: save a brief as a template.
 *
 * @package MazeAi
 * @since   0.1.4
 */

declare(strict_types=1);

namespace MazeAi\Http\Controllers;

defined('ABSPATH') || exit;

use MazeAi\I18n\StoredMessage;
use Illuminate\MazeAssistant\Http\JsonResponse;
use Illuminate\MazeAssistant\Http\Request;
use Illuminate\MazeAssistant\Routing\Controller;
use MazeAi\Kernel\Support\ToolContext;
use MazeAi\Modules\ContentStudio\Pipeline\InstructionSet;
use MazeAi\Modules\ContentStudio\Pipeline\Stages;
use MazeAi\Platform\Definitions;
use MazeAi\Platform\Extensions;
use MazeAi\Support\Redactor;
use MazeAi\Tools\Abilities\DefinitionAbilities;
use MazeAi\Tools\ToolRegistry;

/**
 * `POST /studios/content/templates` `{name, description?, base, values, action_id?}` (people who manage MazeGraph): the
 * filled-in brief becomes a template of this site. It is a definition of kind `template` like any other (decision
 * 044): data only, validated against the manifest schema, never code. It is saved through the same journaled,
 * undoable definition tool as the Extensions tab, as the person's own action (decision 045). Deleting one is
 * `DELETE /definitions/template/site/{name}`.
 *
 * @since 0.1.4
 */
class StudioTemplateController extends Controller
{
    public function __construct(protected Extensions $extensions)
    {
        parent::__construct();
    }

    public function store(Request $request, ToolRegistry $tools): JsonResponse
    {
        if (!$this->extensions->modules()->enabled(StudioRunController::MODULE)) {
            return $this->error(__('Content Studio is switched off. An administrator can switch it on in Tools → Extensions.', 'maze-graph'), 503);
        }
        $name = Redactor::cleanText((string) $request->input('name', ''));
        if ($name === '' || mb_strlen($name) > 80) {
            return $this->validationError(['name' => [__('Give the template a name of up to 80 characters.', 'maze-graph')]]);
        }
        $description = mb_substr(Redactor::cleanText((string) $request->input('description', '')), 0, 300);
        $base        = $this->extensions->definitions()->get('template', (string) $request->input('base', ''));
        if ($base === null || ($base['data']['studio'] ?? '') !== StudioRunController::STUDIO) {
            return $this->validationError(['base' => [__('Choose a Content Studio template to start from.', 'maze-graph')]]);
        }
        $values = is_array($request->input('values')) ? $request->input('values') : [];

        $slug       = sanitize_title($name);
        $definition = [
            'kind'         => 'template',
            'id'           => Definitions::STORED . '/' . ($slug !== '' ? substr($slug, 0, 40) : 'template'),
            'name'         => $name,
            'description'  => $description,
            'studio'       => StudioRunController::STUDIO,
            'post_type'    => (string) ($base['data']['post_type'] ?? 'post'),
            'source'       => (string) ($base['data']['source'] ?? 'none'),
            'fields'       => $this->fields((array) ($base['data']['fields'] ?? []), $values),
            'instructions' => (string) $base['data']['instructions'],
        ];
        // The stages and instructions the person set up on the brief travel with the template (decision 052).
        $fromPost = $definition['source'] === 'post';
        $optional = array_values(array_diff(Stages::resolve(is_array($request->input('stages')) ? $request->input('stages') : (array) ($base['data']['stages'] ?? []), $fromPost), [Stages::BRIEF, Stages::WRITE, Stages::HANDOFF]));
        $definition['stages'] = $optional;
        $slots = InstructionSet::cleanMap($request->input('instructions', $base['data']['stage_instructions'] ?? null));
        if ($slots !== []) {
            $definition['stage_instructions'] = $slots;
        }
        if (is_string($base['data']['agent'] ?? null)) {
            $definition['agent'] = $base['data']['agent'];
        }

        $key     = substr((string) preg_replace('/[^A-Za-z0-9-]/', '', (string) $request->input('action_id', '')), 0, 64);
        $outcome = $tools->execute(ToolContext::forPerson((int) get_current_user_id(), 'studio-template:' . ($key !== '' ? $key : wp_generate_uuid4())), DefinitionAbilities::SAVE, ['definition' => $definition]);
        if ($outcome->status !== 'ok') {
            return $this->error($outcome->error !== '' ? $outcome->error : __('The template could not be saved.', 'maze-graph'), 422);
        }

        return $this->ok(['id' => $definition['id'], 'change' => $outcome->ui['change'] ?? null, 'summary' => StoredMessage::render((string) ($outcome->ui['summary'] ?? ''))]);
    }

    /**
     * The base template's fields, each with the person's answer as its default when it is usable.
     *
     * @param array<int, mixed>        $fields
     * @param array<string, mixed>     $values
     * @return list<array<string, mixed>>
     */
    protected function fields(array $fields, array $values): array
    {
        $out = [];
        foreach ($fields as $field) {
            if (!is_array($field)) {
                continue;
            }
            $value = Redactor::cleanText(is_scalar($values[(string) $field['id']] ?? null) ? (string) $values[(string) $field['id']] : '');
            $type  = (string) ($field['type'] ?? 'text');
            if ($value !== '' && ($type !== 'select' || in_array($value, (array) ($field['options'] ?? []), true)) && mb_strlen($value) <= 2000) {
                $field['default'] = $type === 'number' && is_numeric($value) ? $value + 0 : $value;
            }
            $out[] = $field;
        }

        return $out;
    }
}