Edição inline

<?php

namespace App\Control\Tutor;

use App\Models\TutorDemo\TutorDemoCategoria;
use App\Models\TutorDemo\TutorDemoEstadoPedido;
use App\Support\Tutor\TutorDemoSeed;
use App\Support\Tutor\TutorPage;

/**
 * TutorGridsInlineAvancado — catálogo grids_inline_avancado.
 *
 * Os "componentes" citados no catálogo (mad-data-grid-edit-cell,
 * mad-data-grid-edit-inline) NÃO existem como tags autônomas — confirmado
 * via mad_props (ambos retornam "não encontrado") e mad_search_rules (zero
 * ocorrência no framework). São os dois modos de `edit-mode` do <mad-col>:
 * "click" (ícone lápis, abre o editor ao clicar na célula) e "inline"
 * (editor sempre visível, sem clique). O terceiro modo, "dblclick", é o
 * default quando `edit-mode` é omitido. O terceiro tag do catálogo,
 * <mad-col-edit>, é o filho tipado de <mad-col> que declara o widget do
 * editor (texto/número/data/select/dbcombo/...).
 *
 * A edição AQUI PERSISTE DE VERDADE: <mad-grid model="TutorDemoPedido">
 * (sem `self`) compila para \Mad\Grid\MadGrid::_renderFromConfig(), que
 * instancia um Mad\Grid\MadGrid próprio — e MadGrid extends MadDataGrid.
 * Ou seja, cada grid embutido nesta página já carrega
 * MadDataGrid::onInlineSave($id, $field, $value) pronto: clique/duplo-clique/
 * inline grava direto via `$modelClass::find($id)->$field = $value; ->save();`
 * — sem a página precisar herdar de MadDataGrid nem escrever handler algum.
 * tutor_pedidos é tabela sandbox do MAD Lab: seguro editar de verdade.
 */
class TutorGridsInlineAvancado extends TutorPage
{
    protected string $catalogKey = 'grids_inline_avancado';

    public function mount(array $params = []): void
    {
        TutorDemoSeed::ensure();
    }

    /** Opções do editor <mad-col-edit type="select"> (estado do pedido). */
    public function estadoOptions(): array
    {
        return TutorDemoEstadoPedido::query()->orderBy('ordem')->pluck('nome', 'id')->all();
    }

    /** Transform de leitura da coluna categoria_id — nome em vez do id cru. */
    public static function categoriaNome(mixed $value, object $row): string
    {
        return TutorDemoCategoria::query()->find($value)?->nome ?? '—';
    }
}

<x-tutor-page page="grids_inline_avancado">
    <mad-callout type="info" title="mad-data-grid-edit-cell / mad-data-grid-edit-inline não são tags" icon="info">
        Não existem componentes com esse nome — são os modos "click" e "inline" da prop
        <code>edit-mode</code> de <code>&lt;mad-col&gt;</code>. O terceiro modo, "dblclick", é o
        padrão quando <code>edit-mode</code> é omitido. Toda edição abaixo grava de verdade em
        <code>tutor_pedidos</code> (tabela sandbox do MAD Lab) via
        <code>MadDataGrid::onInlineSave</code>, que já vem pronto em qualquer
        <code>&lt;mad-grid model="..."&gt;</code>.
    </mad-callout>

    <x-tutor-demo demo="tutor.examples.grids-inline-avancado.clique"
        title="Clique para editar (edit-mode=click)"
        desc="Ícone de lápis abre o editor na célula. Texto (descrição) e dinheiro (valor) — persistência real via onInlineSave." />

    <x-tutor-demo demo="tutor.examples.grids-inline-avancado.inline"
        title="Sempre editável (edit-mode=inline)"
        desc="Editor de data sempre visível na célula, sem precisar clicar." />

    <x-tutor-demo demo="tutor.examples.grids-inline-avancado.select"
        title="Duplo-clique (padrão) + mad-col-edit type=select"
        desc="edit-mode omitido cai no padrão dblclick. Opções vêm de TutorGridsInlineAvancado::estadoOptions()."
        php="TutorGridsInlineAvancado::estadoOptions" />

    <x-tutor-demo demo="tutor.examples.grids-inline-avancado.dbcombo"
        title="Editor ligado a banco (mad-col-edit type=dbcombo)"
        desc="Dropdown com busca carregado de TutorDemoCategoria; transform mostra o nome quando a célula não está em edição."
        php="TutorGridsInlineAvancado::categoriaNome" />
</x-tutor-page>