# Bloco: Listagem de produtos

Os produtos de uma loja com SKU, estoque e preço: busca, filtro por situação, as fichas do que está aplicado, seleção de linhas com a barra de ações e paginação.

Uma tela inteira, montada só com peças do @rivocode/ui e as regras da skill. Copie o arquivo, troque os dados de exemplo pelos da sua consulta e mantenha os quatro finais: dados, carregando, erro e vazio. Ele importa só de `@rivocode/ui`, `lucide-react` e `react`.

Peças: [PageHeader](https://ds.rivocode.com.br/componentes/page-header.md), [SearchInput](https://ds.rivocode.com.br/componentes/search-input.md), [Select](https://ds.rivocode.com.br/componentes/select.md), [FilterBar](https://ds.rivocode.com.br/componentes/filter-bar.md), [DataTable](https://ds.rivocode.com.br/componentes/data-table.md), [ActionBar](https://ds.rivocode.com.br/componentes/action-bar.md), [Badge](https://ds.rivocode.com.br/componentes/badge.md).

Padrões de UX que ele aplica: [Espera](https://ds.rivocode.com.br/padroes/espera.md), [Filtros e busca](https://ds.rivocode.com.br/padroes/filtros-e-busca.md), [Ações em lote](https://ds.rivocode.com.br/padroes/acoes-em-lote.md).

Ao vivo, no desktop e no celular: https://ds.rivocode.com.br/blocos#listagem

## Código

```tsx
import {
  ActionBar,
  Badge,
  Button,
  DataTable,
  FilterBar,
  PageHeader,
  QueryBoundary,
  SearchInput,
  Select,
  SelectContent,
  SelectItem,
  SelectTrigger,
  SelectValue,
  Skeleton,
  currency,
  useToast,
  type AppliedFilter,
  type Column,
} from '@rivocode/ui'
import { Archive, Download, Package, Plus, RotateCw, SearchX } from 'lucide-react'
import { useCallback, useEffect, useMemo, useRef, useState } from 'react'

type Product = {
  id: string
  name: string
  sku: string
  category: string
  stock: number
  price: number
  status: 'active' | 'low' | 'out' | 'paused'
}

const STATUS: Record<
  Product['status'],
  { label: string; tone: 'success' | 'warning' | 'danger' | 'neutral' }
> = {
  active: { label: 'À venda', tone: 'success' },
  low: { label: 'Estoque baixo', tone: 'warning' },
  out: { label: 'Esgotado', tone: 'danger' },
  paused: { label: 'Pausado', tone: 'neutral' },
}

const STATUS_ITEMS = [
  { label: 'Todas as situações', value: 'all' },
  { label: 'À venda', value: 'active' },
  { label: 'Estoque baixo', value: 'low' },
  { label: 'Esgotado', value: 'out' },
  { label: 'Pausado', value: 'paused' },
]

const PRODUCTS: Product[] = [
  { id: '1', name: 'Caneca de cerâmica 350 ml', sku: 'CAN-350-AZ', category: 'Cozinha', stock: 128, price: 49.9, status: 'active' },
  { id: '2', name: 'Camiseta de algodão orgânico', sku: 'CAM-ORG-M', category: 'Vestuário', stock: 6, price: 89.9, status: 'low' },
  { id: '3', name: 'Garrafa térmica 1 litro', sku: 'GAR-1L-PR', category: 'Cozinha', stock: 0, price: 139, status: 'out' },
  { id: '4', name: 'Mochila impermeável 20 L', sku: 'MOC-20-CZ', category: 'Acessórios', stock: 42, price: 219, status: 'active' },
  { id: '5', name: 'Caderno pontilhado A5', sku: 'CAD-A5-PT', category: 'Papelaria', stock: 310, price: 34.5, status: 'active' },
  { id: '6', name: 'Vela aromática de lavanda', sku: 'VEL-LAV-01', category: 'Casa', stock: 4, price: 59.9, status: 'low' },
  { id: '7', name: 'Ecobag de lona crua', sku: 'ECO-LON-01', category: 'Acessórios', stock: 75, price: 39.9, status: 'paused' },
  { id: '8', name: 'Kit de pincéis para aquarela', sku: 'PIN-AQ-12', category: 'Papelaria', stock: 23, price: 74.9, status: 'active' },
]

const COLUMNS: Column<Product>[] = [
  {
    key: 'name',
    header: 'Produto',
    sortable: true,
    cell: (product) => (
      <>
        {product.name}
        <span className="block text-xs text-fg-muted sm:hidden">{STATUS[product.status].label}</span>
      </>
    ),
  },
  {
    key: 'sku',
    header: 'SKU',
    hideOnMobile: true,
    cell: (product) => <span className="font-mono">{product.sku}</span>,
  },
  { key: 'category', header: 'Categoria', hideOnMobile: true, sortable: true },
  {
    key: 'stock',
    header: 'Estoque',
    align: 'right',
    sortable: true,
    cell: (product) => <span className="tabular-nums">{product.stock} un.</span>,
    total: (rows) => (
      <span className="tabular-nums">{rows.reduce((sum, row) => sum + row.stock, 0)} un.</span>
    ),
  },
  {
    key: 'price',
    header: 'Preço',
    align: 'right',
    sortable: true,
    hideOnMobile: true,
    cell: (product) => <span className="tabular-nums">{currency(product.price)}</span>,
  },
  {
    key: 'status',
    header: 'Situação',
    hideOnMobile: true,
    value: (product) => STATUS[product.status].label,
    cell: (product) => (
      <Badge tone={STATUS[product.status].tone} size="sm">
        {STATUS[product.status].label}
      </Badge>
    ),
  },
]

/** A consulta de mentira: troque pelo `useQuery` do seu app, com os mesmos quatro campos. */
function useProducts() {
  const [data, setData] = useState<Product[] | undefined>(undefined)
  const [isFetching, setFetching] = useState(true)
  const timer = useRef<ReturnType<typeof setTimeout>>(undefined)

  const refetch = useCallback(() => {
    setFetching(true)
    clearTimeout(timer.current)
    timer.current = setTimeout(() => {
      setData((current) => current ?? PRODUCTS)
      setFetching(false)
    }, 700)
  }, [])

  useEffect(() => {
    refetch()
    return () => clearTimeout(timer.current)
  }, [refetch])

  return { data, setData, isLoading: data === undefined, isError: false, isFetching, refetch }
}

/** O CSV das linhas marcadas, baixado pelo navegador. Troque pela exportacao do seu servidor se ela existir. */
function downloadCsv(products: Product[]) {
  const header = ['Produto', 'SKU', 'Categoria', 'Estoque', 'Preço', 'Situação']
  const lines = products.map((product) =>
    [
      product.name,
      product.sku,
      product.category,
      String(product.stock),
      String(product.price),
      STATUS[product.status].label,
    ]
      .map((cell) => `"${cell.replace(/"/g, '""')}"`)
      .join(';'),
  )
  const blob = new Blob([[header.join(';'), ...lines].join('\n')], { type: 'text/csv;charset=utf-8' })
  const url = URL.createObjectURL(blob)
  const link = document.createElement('a')
  link.href = url
  link.download = 'produtos.csv'
  link.click()
  URL.revokeObjectURL(url)
}

function ListingSkeleton() {
  return (
    <div className="space-y-2">
      {[0, 1, 2, 3, 4, 5].map((row) => (
        <Skeleton key={row} className="h-10 w-full" />
      ))}
    </div>
  )
}

export default function ProductsPage() {
  const toast = useToast()
  const products = useProducts()
  const [search, setSearch] = useState('')
  const [status, setStatus] = useState('all')
  const [selected, setSelected] = useState<string[]>([])

  const rows = useMemo(
    () => (products.data ?? []).filter((product) => status === 'all' || product.status === status),
    [products.data, status],
  )

  const filters: AppliedFilter[] = [
    ...(search ? [{ id: 'search', label: 'Busca', value: search }] : []),
    ...(status !== 'all'
      ? [{ id: 'status', label: 'Situação', value: STATUS[status as Product['status']].label }]
      : []),
  ]

  const clear = () => {
    setSearch('')
    setStatus('all')
  }

  return (
    <div className="w-full space-y-4 bg-bg p-4 sm:p-6">
      <PageHeader
        title="Produtos"
        description="O catálogo da loja, com o que sobra no estoque e o preço de vitrine."
        actions={
          <>
            <Button
              variant="secondary"
              loading={products.isFetching && !products.isLoading}
              onClick={products.refetch}
            >
              <RotateCw size={16} aria-hidden="true" />
              Atualizar
            </Button>
            <Button render={<a href="/produtos/novo" />}>
              <Plus size={16} aria-hidden="true" />
              Novo produto
            </Button>
          </>
        }
      />

      <div className="space-y-3">
        <div className="flex flex-col gap-3 sm:flex-row">
          <SearchInput
            value={search}
            onChange={(event) => setSearch(event.target.value)}
            onClear={() => setSearch('')}
            placeholder="Nome, SKU ou categoria"
            aria-label="Buscar produto"
            className="min-w-0 flex-1"
          />
          <Select value={status} onValueChange={(value) => setStatus(String(value))} items={STATUS_ITEMS}>
            <SelectTrigger className="w-full sm:w-52" aria-label="Situação">
              <SelectValue />
            </SelectTrigger>
            <SelectContent>
              {STATUS_ITEMS.map((item) => (
                <SelectItem key={item.value} value={item.value}>
                  {item.label}
                </SelectItem>
              ))}
            </SelectContent>
          </Select>
        </div>

        <FilterBar
          filters={filters}
          onRemove={(filter) => (filter.id === 'search' ? setSearch('') : setStatus('all'))}
          onClear={clear}
        />
      </div>

      <QueryBoundary
        data={products.data}
        isLoading={products.isLoading}
        isError={products.isError}
        isFetching={products.isFetching}
        onRetry={products.refetch}
        isEmpty={products.data?.length === 0}
        errorTitle="Não foi possível carregar os produtos"
        errorMessage="A lista volta assim que a conexão voltar. Nenhum cadastro foi perdido."
        empty={{
          icon: <Package aria-hidden="true" />,
          title: 'Nenhum produto cadastrado',
          description: 'Cadastre o primeiro para ele aparecer na vitrine.',
          action: <Button render={<a href="/produtos/novo" />}>Novo produto</Button>,
        }}
        skeleton={<ListingSkeleton />}
      >
        {() => (
          <DataTable
            data={rows}
            columns={COLUMNS}
            rowKey={(product) => product.id}
            caption="Produtos"
            filter={search}
            pageSize={6}
            selectable
            value={selected}
            onValueChange={setSelected}
            noResultsMessage="Nenhum produto com esse nome, SKU ou categoria."
            empty={{
              icon: <SearchX aria-hidden="true" />,
              title: 'Nenhum produto nesta situação',
              description: 'Troque a situação no filtro, ou limpe os filtros para ver todos.',
              action: (
                <Button variant="secondary" size="sm" onClick={clear}>
                  Limpar filtros
                </Button>
              ),
            }}
          />
        )}
      </QueryBoundary>

      <ActionBar
        count={selected.length}
        onClear={() => setSelected([])}
        labels={{
          selected: (count) => (count === 1 ? '1 produto selecionado' : `${count} produtos selecionados`),
        }}
      >
        <Button
          variant="secondary"
          size="sm"
          onClick={() => downloadCsv(rows.filter((product) => selected.includes(product.id)))}
        >
          <Download size={14} aria-hidden="true" />
          Exportar
        </Button>
        <Button
          variant="secondary"
          size="sm"
          onClick={() => {
            products.setData((now) => now?.filter((product) => !selected.includes(product.id)))
            toast.add({
              title: selected.length === 1 ? 'Produto arquivado' : `${selected.length} produtos arquivados`,
              description: 'Saíram da vitrine, e os pedidos antigos continuam guardados.',
            })
            setSelected([])
          }}
        >
          <Archive size={14} aria-hidden="true" />
          Arquivar
        </Button>
      </ActionBar>
    </div>
  )
}
```
