sections/product-list/
├── schema.json
├── section.jsx
└── styles.css

{
  "type": "collection",
  "id": "collection",
  "label": "Filtrar por categoria/coleção",
  "info": "Vazio = todos os produtos"
}

import { defineSectionData } from '@corvex/theme-sdk';

export const data = defineSectionData(async ({ storefront, settings }) => ({
  products: await storefront.products.list({
    first: settings.limit ?? 8,
    collection: settings.collection || undefined,
    query: settings.query || undefined,
    featured: settings.featured || undefined,
    sortBy: settings.sortBy ?? 'BEST_SELLING',
    reverse: settings.reverse || undefined,
    inStock: settings.availableOnly ? true : undefined,
  }),
}));

import { useCorvexData } from '@corvex/theme-sdk';

function resolveCollectionRef(value) {
  if (!value) return null;
  if (typeof value === 'string') return value.trim() || null;
  return value.id || value.handle || null;
}

export default function ProductListSection({ collection = '', limit = 8, sortBy = 'BEST_SELLING', featured = false }) {
  const categoryId = resolveCollectionRef(collection);

  const { data, loading } = useCorvexData('products', {
    limit,
    sortBy,
    ...(categoryId && { collectionId: categoryId }),
    ...(featured && { featured: true }),
  });

  const products = data?.nodes ?? [];
  // ...
}

import ProductCard from '@corvex/snippets/product-card';

export default function ProductList({ settings, data }) {
  const products = data?.products?.nodes ?? [];

  if (!products.length) {
    return <p>Nenhum produto nesta coleção.</p>;
  }

  return (
    <section className="product-list">
      <h2>{settings.title}</h2>
      <div className="product-list__grid">
        {products.map((product) => (
          <ProductCard key={product.id} product={product} />
        ))}
      </div>
    </section>
  );
}

Lojista escolhe categoria "Games" no inspector
        ↓
settings.collection = "uuid-da-categoria"
        ↓
storefront.products.list({ collection: "uuid..." })
        ↓
GET /products?categoryId=uuid...
        ↓
Connection<Product> → section renderiza cards