# VideoCard

> A title in a video catalogue as one link: its artwork in a landscape still or a portrait poster, a badge on the art, how much of it the viewer has watched, and its name and meta below.

```ts
import { VideoCard } from "@sdxc/ui/video";
```

Renders the card. The whole card is one link whose name is the title, so a row of them
reads as a list of titles; the art scales a little under the pointer and stays still under
reduced motion.

## Examples

```tsx
<VideoCard href="/title/tidewater" title="Tidewater" art={<img src={still} alt="" />} meta="S1 · E3" progress={0.4} progressLabel="40% watched" />
```

```tsx
<VideoCard shape="poster" href="/title/ember" title="Ember Line" art={<Poster />} badge="New" />
```

## Props

| Prop | Type | Description |
| --- | --- | --- |
| `href` | `string` | The link's destination: the title's page, or straight into playback. |
| `title` | `string` | The title's name, the card's accessible name and its first line. |
| `art` | `RemixNode` | The artwork, drawn edge to edge in the frame: an `<img>`, an `<svg>` or a gradient. |
| `shape?` | `"landscape" \| "poster"` | Default: `"landscape"`. |
| `meta?` | `RemixNode` | A short second line, such as "S2 · E4 · 38 min" or "2026 · Drama". |
| `badge?` | `RemixNode` | A label on the art, such as "New episodes". |
| `badgePlacement?` | `"top" \| "bottom"` | Which corner of the art the badge sits in. Default: `"top"` (the start of the top edge). |
| `progress?` | `number` | The share watched, from 0 to 1, drawn as a bar along the art's foot. |
| `progressLabel?` | `string` | What a screen reader hears for the bar, such as "38% watched"; required with `progress`. |

Also accepts everything in `Omit<TagProps<"a">, "children" | "title" | "href" | "role">`.


## Types

| Name | Values | What it decides |
| --- | --- | --- |
| `Shape` | `"landscape" \| "poster"` | `landscape` is a 16:9 still, `poster` a 2:3 key art. |

## Also exported

- `clampProgress`
