const { nodes, pageInfo } = await storefront.categories.list({ first: 20 });

nodes.map((category) => ({
  id: category.id,
  title: category.title,
  url: category.url,
  imageUrl: category.imageUrl,
  productCount: category.productCount,
}));

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

const { data, loading } = useCorvexData('collections', { limit: 8 });
// ou alias legado:
// useCorvexData('categories', { limit: 8 });

const categories = data?.nodes ?? [];

function normalizeCategories(data) {
  if (!data) return [];
  if (Array.isArray(data)) return data;
  if (Array.isArray(data.nodes)) return data.nodes;
  return [];
}

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

const categories = unwrapCorvexNodes(data);

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

const selectedIds = (settings.collections || [])
  .map(resolveCollectionRef)
  .filter(Boolean);

const { nodes } = await storefront.categories.list({ first: Math.max(20, selectedIds.length) });

const ordered = selectedIds.length
  ? nodes
      .filter((c) => selectedIds.includes(c.id))
      .sort((a, b) => selectedIds.indexOf(a.id) - selectedIds.indexOf(b.id))
  : nodes.slice(0, settings.maxItems ?? 8);

const category = await storefront.categories.get('verao');
// ou UUID
const categoryById = await storefront.categories.get('72a0c0d1-9c0d-41a0-a23c-64099ea04bfd');

useCorvexData('collection', { id: 'uuid-da-categoria' });
// aliases: category, collectionId, handle, slug

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

export const data = defineSectionData(async ({ storefront, settings }) => ({
  collections: await storefront.categories.list({
    first: settings.maxItems ?? 8,
  }),
}));

<img
  src={category.imageUrl || category.image?.url || ''}
  alt={category.image?.altText || category.title}
  loading="lazy"
/>