Datas e horas

<?php

namespace App\Control\Tutor;

use App\Support\Tutor\TutorPage;
use Mad\Filters\MadFilterable;
use Mad\Filters\MadFiltersTrait;
use Mad\Form\MadForm;
use Mad\Http\MadResponse;

/**
 * TutorFormsDatas — página "Datas e horas" do catálogo (mad-date-field,
 * mad-time-field, mad-datetime-field, mad-daterange-field,
 * mad-period-monthyear).
 *
 * Implementa MadFilterable via MadFiltersTrait só por causa do exemplo
 * "mes-ano": <mad-period-monthyear> lê $component->mes/->ano e chama
 * setMesAno() no host (ver packages/mad-framework/.../period-monthyear.blade.php)
 * — sem isso o preset renderiza mas não tem estado pra refletir. O trait
 * no-opa graciosamente sem $periodType/$database/etc declarados (só usados
 * por applyPeriodoToQuery(), que este controller nunca chama) e sem
 * $rememberFilters (sessão não é tocada).
 */
class TutorFormsDatas extends TutorPage implements MadFilterable
{
    use MadFiltersTrait;

    protected string $catalogKey = 'forms_datas';

    public function mount(array $params = []): void
    {
        $this->form = new MadForm('tutor_forms_datas');
    }

    /**
     * Submit do exemplo "Ação wire" — devolve data + hora recebidas (já no
     * formato de banco, prontas pra um Model Eloquent).
     */
    public function onSubmitDemo(): MadResponse
    {
        $data = $this->form->getData();

        $dataEvento = trim((string) ($data->data_wire ?? ''));
        $horaEvento = trim((string) ($data->hora_wire ?? ''));

        $resumo = ($dataEvento !== '' || $horaEvento !== '')
            ? "data={$dataEvento} | hora={$horaEvento}"
            : 'nenhum campo preenchido';

        return (new MadResponse())->toast("Form recebido: {$resumo}", 'success', 'onSubmitDemo');
    }
}

<x-tutor-page page="forms_datas">
    <x-tutor-demo demo="tutor.examples.forms-datas.basico"
        title="Data simples" desc="mad-date-field — storage yyyy-mm-dd, exibicao dd/mm/aaaa." />

    <x-tutor-demo demo="tutor.examples.forms-datas.limites"
        title="Limites (min/max) + data e hora" desc="min/max restringem o calendario; mad-datetime-field junta data e hora num campo so." />

    <x-tutor-demo demo="tutor.examples.forms-datas.hora"
        title="Hora" desc="mad-time-field — input nativo HTML5 type=time." />

    <x-tutor-demo demo="tutor.examples.forms-datas.periodo"
        title="Periodo com presets" desc="mad-daterange-field com a sidebar de atalhos ERP padrao." />

    <x-tutor-demo demo="tutor.examples.forms-datas.periodo-custom"
        title="Periodo com atalhos proprios" desc="custom_presets + max_span pra janelas especificas do negocio (safra, campanha)." />

    <x-tutor-demo demo="tutor.examples.forms-datas.mes-ano"
        title="Mes/ano (segmented)" desc="mad-period-monthyear — seletor de periodo usado dentro de mad-dash-filters; aqui funciona porque o controller implementa MadFilterable." />

    <x-tutor-demo demo="tutor.examples.forms-datas.wire-submit"
        title="Acao wire" desc="mad-form com submit real — devolve as datas recebidas via TutorFormsDatas::onSubmitDemo."
        php="TutorFormsDatas::onSubmitDemo" />
</x-tutor-page>