# Product listing

A storefront grid with price, color and size filters, a sort menu, hover photo swaps, and quick add with a size row.

- ID: `product-listing`
- Import: `animui/product-listing`
- Category: block
- Runtime exports: `ProductListing`
- Declaration: `types/pro/product-listing.d.ts`
- Type provenance: reconstructed-from-docs-and-runtime
- Related: product-detail, cart-drawer

```tsx
import { ProductListing } from 'animui/product-listing';
```

This import example is not a complete render recipe: read the declaration below and its local references for required props, data, callbacks and provider context. Use `animui info product-listing` to resolve the local declaration graph. Global setup is in `llms.txt`.

```ts
/** Reconstructed from saved Arc documentation and runtime binding evidence; original TypeScript source was unavailable. */
import type { ComponentType, ReactNode, CSSProperties, Ref, ButtonHTMLAttributes, HTMLAttributes, ReactElement } from 'react';

export interface ProductListingProps {
  products?: string | number | boolean | ReactNode;
  colors?: string | number | boolean | ReactNode;
  sizes?: string | number | boolean | ReactNode;
  defaultSort?: string | number | boolean | ReactNode;
  onAddToCart?: () => void;
  defaultCartCount?: string | number | boolean | ReactNode;
  currency?: string | number | boolean | ReactNode;
  locale?: string | number | boolean | ReactNode;
  title?: string;
  className?: string;
}

export declare const ProductListing: ComponentType<ProductListingProps>;

export default ProductListing;
```