public async Task<IActionResult> Index(string? q)
{
    var articles = await _articles.SearchAsync(q);

    // Якщо запит від HTMX — повертаємо лише список (без Layout)
    if (Request.Headers.ContainsKey("HX-Request"))
        return PartialView("_ArticleList", articles);

    // Звичайний браузерний запит — повна сторінка з _Layout
    return View(articles);
}

namespace BlogApp.Extensions;

public static class HttpRequestExtensions
{
    /// <summary>Повертає true якщо запит ініційований HTMX</summary>
    public static bool IsHtmx(this HttpRequest request)
        => request.Headers.ContainsKey("HX-Request");

    /// <summary>URL сторінки у браузері на момент HTMX-запиту</summary>
    public static string? HtmxCurrentUrl(this HttpRequest request)
        => request.Headers.TryGetValue("HX-Current-URL", out var val)
            ? val.ToString() : null;

    /// <summary>Значення hx-target атрибута ініціатора</summary>
    public static string? HtmxTarget(this HttpRequest request)
        => request.Headers.TryGetValue("HX-Target", out var val)
            ? val.ToString() : null;

    /// <summary>Значення hx-trigger атрибута (id ініціюючого елемента)</summary>
    public static string? HtmxTrigger(this HttpRequest request)
        => request.Headers.TryGetValue("HX-Trigger", out var val)
            ? val.ToString() : null;
}

using BlogApp.Extensions;

public async Task<IActionResult> Index(string? q)
{
    var articles = await _articles.SearchAsync(q);

    return Request.IsHtmx()
        ? PartialView("_ArticleList", articles)
        : View(articles);
}

[HttpPost, ValidateAntiForgeryToken]
public async Task<IActionResult> Create(ProductCreateDto dto)
{
    if (!ModelState.IsValid)
        return Request.IsHtmx()
            ? PartialView("_CreateForm", dto)
            : View(dto);

    var product = await _service.CreateAsync(dto);

    if (Request.IsHtmx())
    {
        // Повна навігація — не AJAX-вставка у hx-target
        Response.Headers["HX-Redirect"] = Url.Action("Details", new { id = product.Id });
        return Ok(); // тіло ігнорується при HX-Redirect
    }

    return RedirectToAction(nameof(Details), new { id = product.Id });
}

[HttpPost]
public async Task<IActionResult> Add(int productId)
{
    await _cart.AddItemAsync(productId);
    // Всі підписники "cartUpdated" на сторінці оновляться самостійно
    Response.Headers["HX-Trigger"] = "cartUpdated";
    return PartialView("_AddToCartConfirmation");
}

<span id="cart-badge"
      hx-get="/cart/count"
      hx-trigger="cartUpdated from:body"
      hx-swap="innerHTML">0</span>

[HttpPost]
public IActionResult Submit(FormDto dto)
{
    if (!ModelState.IsValid)
    {
        // Перенаправити відповідь у глобальне вікно помилок
        Response.Headers["HX-Retarget"] = "#global-error-panel";
        Response.Headers["HX-Reswap"] = "innerHTML";
        Response.StatusCode = 422; // Unprocessable Entity
        return PartialView("_ValidationErrors", ModelState);
    }
    // ...
}

public class ProductController : Controller
{
    private readonly IProductRepository _products;

    public ProductController(IProductRepository products)
        => _products = products;

    // GET /products — повна сторінка при першому відкритті
    public async Task<IActionResult> Index()
    {
        var products = await _products.GetAllAsync();
        return View(products);
    }

    // GET /products/search?q=ноутбук — лише при HTMX-запиті
    [HttpGet]
    public async Task<IActionResult> Search(string? q)
    {
        var results = string.IsNullOrWhiteSpace(q)
            ? await _products.GetAllAsync()
            : await _products.SearchAsync(q);

        // Завжди повертаємо PartialView — цей endpoint лише для HTMX
        return PartialView("_ProductGrid", results);
    }
}

@model IReadOnlyList<Product>

<div class="container">
    <h1>Каталог товарів</h1>

    @* hx-trigger="input changed delay:300ms" — debounce 300мс, лише при зміні значення *@
    <div class="mb-4 position-relative">
        <input type="search"
               name="q"
               class="form-control form-control-lg"
               placeholder="Пошук за назвою..."
               hx-get="/products/search"
               hx-target="#product-grid"
               hx-trigger="input changed delay:300ms"
               hx-indicator="#search-spinner"
               hx-push-url="true"
               autocomplete="off">

        @* Спіннер — зникає автоматично після відповіді *@
        <div id="search-spinner" class="htmx-indicator position-absolute top-50 end-0
                                        translate-middle-y me-3">
            <div class="spinner-border spinner-border-sm text-secondary"></div>
        </div>
    </div>

    @* Початкові результати рендеряться сервером — SEO-дружньо *@
    <div id="product-grid">
        <partial name="_ProductGrid" model="Model"/>
    </div>
</div>

@model IReadOnlyList<Product>

@if (!Model.Any())
{
    <div class="alert alert-info">За вашим запитом нічого не знайдено.</div>
}
else
{
    <div class="row row-cols-1 row-cols-md-3 g-4">
        @foreach (var product in Model)
        {
            <div class="col">
                <div class="card h-100 shadow-sm">
                    <div class="card-body">
                        <h5 class="card-title">@product.Name</h5>
                        <p class="card-text text-muted">@product.Category</p>
                        <p class="card-text fw-bold">@product.Price.ToString("C")</p>
                    </div>
                </div>
            </div>
        }
    </div>
}

// GET /articles?page=1 — перша порція або наступні через revealed
[HttpGet]
public async Task<IActionResult> Index(int page = 1)
{
    const int pageSize = 10;
    var articles = await _articles.GetPageAsync(page, pageSize);
    var hasMore = await _articles.HasMoreAsync(page, pageSize);

    var vm = new ArticlePageViewModel(articles, page, hasMore);

    // Перша сторінка — повний View з Layout
    if (page == 1 && !Request.IsHtmx())
        return View(vm);

    // Наступні сторінки через HTMX — лише фрагмент
    return PartialView("_ArticlePage", vm);
}

@model ArticlePageViewModel

@* Статті поточної сторінки *@
@foreach (var article in Model.Articles)
{
    <article class="card mb-3 shadow-sm">
        <div class="card-body">
            <h2 class="h5">@article.Title</h2>
            <p class="text-muted small">@article.PublishedAt:d</p>
        </div>
    </article>
}

@* Sentinel-елемент — лише якщо є наступна сторінка *@
@if (Model.HasMore)
{
    @* При появі у viewport — завантажує наступну порцію і замінює сам себе *@
    <div hx-get="/articles?page=@(Model.Page + 1)"
         hx-trigger="revealed"
         hx-swap="outerHTML"
         class="d-flex justify-content-center py-4">
        <div class="spinner-border text-primary"></div>
    </div>
}

// GET /admin/products/{id}/row — рядок у режимі перегляду
[HttpGet, Route("admin/products/{id}/row")]
public async Task<IActionResult> Row(int id)
{
    var product = await _products.GetByIdAsync(id);
    return PartialView("_ProductRow", product);
}

// GET /admin/products/{id}/edit-row — рядок у режимі редагування
[HttpGet, Route("admin/products/{id}/edit-row")]
public async Task<IActionResult> EditRow(int id)
{
    var product = await _products.GetByIdAsync(id);
    return PartialView("_ProductEditRow", product);
}

// PATCH /admin/products/{id} — зберегти зміни
[HttpPatch, Route("admin/products/{id}")]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Update(int id, ProductUpdateDto dto)
{
    if (!ModelState.IsValid)
    {
        Response.StatusCode = 422;
        return PartialView("_ProductEditRow", dto);
    }
    var updated = await _products.UpdateAsync(id, dto);
    return PartialView("_ProductRow", updated);
}

@model Product

@* id="row-{id}" — дозволяє hx-target знайти цей рядок для заміни *@
<tr id="row-@Model.Id">
    <td>@Model.Name</td>
    <td>@Model.Price.ToString("C")</td>
    <td>@Model.Category</td>
    <td>
        @* Клік → замінює весь рядок на Edit-версію через outerHTML *@
        <button class="btn btn-sm btn-outline-primary"
                hx-get="/admin/products/@Model.Id/edit-row"
                hx-target="#row-@Model.Id"
                hx-swap="outerHTML">✏️</button>
    </td>
</tr>

@model Product

<tr id="row-@Model.Id">
    <td><input name="name" value="@Model.Name" class="form-control form-control-sm"></td>
    <td><input name="price" value="@Model.Price" type="number" class="form-control form-control-sm"></td>
    <td>@Model.Category</td>
    <td class="d-flex gap-1">
        @* ✓ Зберегти: PATCH + AntiForgery через meta-тег *@
        <button class="btn btn-sm btn-success"
                hx-patch="/admin/products/@Model.Id"
                hx-target="#row-@Model.Id"
                hx-swap="outerHTML"
                hx-include="closest tr">✓</button>
        @* ✕ Скасувати: повернути View-версію рядка *@
        <button class="btn btn-sm btn-outline-secondary"
                hx-get="/admin/products/@Model.Id/row"
                hx-target="#row-@Model.Id"
                hx-swap="outerHTML">✕</button>
    </td>
</tr>

// Глобальна обробка HTTP-помилок від HTMX
document.addEventListener("htmx:responseError", (event) => {
    const status = event.detail.xhr.status;
    const message = status === 403 ? "Доступ заборонено"
        : status === 404 ? "Ресурс не знайдено"
        : status >= 500 ? "Помилка сервера. Спробуйте пізніше."
        : "Сталася помилка.";

    // Показати toast або alert
    document.getElementById("error-toast").textContent = message;
    document.getElementById("error-toast").classList.add("show");
});