---
version: alpha
name: mastercard.com
description: "Light product system built on #f3f0ee with #f37338 as the primary CTA accent. Type anchored in mccom at 120px / weight 500. Extracted automatically from https://mastercard.com/ — rendered styles via getComputedStyle() + CSS custom properties (token-only values may not be painted)."
narrative: |
  mastercard.com is built on a warm, off-white canvas (rgb(243, 240, 238)).
  The system uses rgb(243, 115, 56) as the high-saturation accent for primary actions.
  Sharp 0px corners on CTAs — architectural restraint, engineering precision alongside mccom as the primary typeface.
  Mccom is paired with MarkOffcForMC for secondary roles.
  A layered elevation system (5 distinct shadows) building a clear front-to-back hierarchy.
  Motion is a first-class concern — 19 keyframe animations plus transition-driven interactions.

colors:
  background: "#f3f0ee"
  surface-1: "#f3f0ee"
  surface-2: "rgba(255, 255, 255, 0.8)"
  ink: "#141413"
  ink-muted: "rgba(20, 20, 19, 0.65)"
  ink-subtle: "#323231"
  primary: "#f37338"
  on-primary: "#111111"
  primary-hover: "#3e34d3"
  hairline: "#333333"
  semantic-error: "#ee0000"
  semantic-success: "#038a00"
  semantic-warning: "#f38b00"

typography:
  display-xl:
    fontFamily: "mccom, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 120px
    fontWeight: 500
    lineHeight: 1
    letterSpacing: -2.4px
  display-lg:
    fontFamily: "mccom, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 64px
    fontWeight: 500
    lineHeight: 1
    letterSpacing: -1.28px
  display-md:
    fontFamily: "mccom, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 24px
    fontWeight: 500
    lineHeight: 1.2
    letterSpacing: -0.48px
  headline:
    fontFamily: "mccom, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 14px
    fontWeight: 700
    lineHeight: 1
    letterSpacing: 0.56px
  body:
    fontFamily: "mccom, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 450
    lineHeight: 1.3
    letterSpacing: 0
  button:
    fontFamily: "mccom, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 500
    lineHeight: 1
    letterSpacing: 0
  mono:
    fontFamily: "mccom, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1
    letterSpacing: 0

rounded:
  none: 0px
  xs: 4px
  sm: 9px
  md: 20px
  lg: 30px
  xl: 40px
  pill: 999px

spacing:
  xxs: 2px
  xs: 4px
  sm: 6px
  md: 12px
  lg: 24px
  xl: 32px
  xxl: 76px

components:
  button-pill:
    backgroundColor: "transparent"
    textColor: "{colors.ink-muted}"
    typography: "{typography.body}"
    rounded: "{rounded.pill}"
  button-ghost:
    backgroundColor: "transparent"
    textColor: "{colors.ink-muted}"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 8px
  button-pill-2:
    backgroundColor: "transparent"
    textColor: "{colors.ink-muted}"
    typography: "{typography.body}"
    rounded: "{rounded.xl}"
    padding: 19px
  input-text-input:
    backgroundColor: "transparent"
    textColor: "#262627"
    typography: "{typography.body}"
    rounded: "{rounded.none}"
    padding: 0px 24px
  status-badge-tinted:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.surface-1}"
    typography: "{typography.headline}"
    rounded: "{rounded.xl}"
  tab-pill-tab:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.surface-1}"
    typography: "{typography.headline}"
    rounded: "{rounded.xl}"

extracted_at: "2026-06-11T05:01:29.792Z"
completeness: 77
scoreVersion: "v2"

---

# Design System — mastercard.com
> Extracted automatically by Prism from https://mastercard.com
> Date: 2026-06-11
> Viewport: Desktop 1440x900 + Mobile 390x844
> Values are extracted, not hand-written: rendered styles via getComputedStyle() + colors declared in CSS custom properties (token-only values are marked `(token)` and may not be painted).


## 0. Design DNA

**Density**: moderate  |  **Motion**: expressive  |  **Weight**: heavy  |  **Aesthetic**: product-neutral

| Dimension | Value | Signal |
|---|---|---|
| Canvas | neutral | `#f3f0ee` |
| Type posture | sans-led (mccom) | "Ensemble, les possibilités son" |
| Color assertion | dual-accent | #f37338 |
| Whitespace | moderate | section rhythm 48px |
| Interaction | expressive | 19 keyframes, 23 transitions |
| Radius language | 9px-rounded | from token scale |

**Prism fingerprint**: `neutral-canvas · sans-display · dual-accent · 9px-rounded · expressive-motion`

> **🤖 TL;DR for AI agents** (read this first — saves you scanning the full doc):
>
> - **Canvas**: `rgb(243, 240, 238)` is the page background. Every component composits against this.
> - **Accent**: `rgb(243, 115, 56)` for primary CTAs ONLY. Never decorative.
> - **Body type**: 16px (token: `typography.body`). Default for ALL text not in a heading role.
> - **Section rhythm**: 48px between major bands. Card padding: 24px.
> - **Default radius**: 9px on buttons/inputs. Pills (`9999px`) only for icon-buttons or status chips.
>
> **Before generating UI**: import this DESIGN.md, scan §2 (Color Palette) + §4 (Components) + §10 (Agent Guide). Skip §11–12 unless extending.

## 1. Visual Theme & Atmosphere

**Signature:** a full-bleed image backdrop in the hero. This is the brand's most recognizable visual — reproduce it, don't replace it with a generic card or flat panel.

mastercard.com's canvas is a warm, intentionally-tinted surface (`#f3f0ee`) — a refusal of the default white that immediately signals editorial intent. This isn't sterility, it's an invitation to read. 

Typography is anchored in **mccom**. Negative letter-spacing at display sizes (-1.28px at 64px) compresses headlines into engineered blocks, dense and precise. 

Body text reads in Near-Black (`#141413`) — softened from pure black, a small but deliberate detail that lowers reading friction. **Coral** (`#f37338`) is the single high-saturation color in the system — it earns its presence only on interactive elements, making CTAs and links the unmistakable focal points against the otherwise neutral palette. Elevation is built from multi-layer shadow stacks (5 distinct) — each combines several blurred layers at varying offsets to build a clear front-to-back hierarchy. 
Border radius varies from pill-shaped (fully rounded) to moderately rounded elements, creating visual rhythm. Motion design uses smooth easing curves for polished state transitions. 

**Key Characteristics:**
- Background: Off-White (`#f3f0ee`)
- Primary typeface: MarkForMCNrw
- Primary text: Near-Black (`#141413`)
- Accent: Coral (`#f37338`)
- Display: 64px weight 500, letter-spacing -1.28px
- Shadow system: 5 distinct elevation levels
- Custom fonts loaded: MarkForMCNrw, MarkForMCNrw-Medium, MarkForMCNrw-Bold, MarkOffcForMC, MarkOffcForMC-ExtraLight, MarkOffcForMC-Light, MarkOffcForMC-Medium, MarkOffcForMC-Bold, arial-unicode-base, arial-unicode-bold, arabic-font-base, arabic-font-narrow, arabic-font-extra-light, arabic-font-light, arabic-font-medium, arabic-font-bold, japanese-font-base, japanese-font-narrow, japanese-font-extra-light, japanese-font-light, japanese-font-medium, japanese-font-bold, georgian-font-base, georgian-font-narrow, georgian-font-extra-light, georgian-font-light, georgian-font-medium, georgian-font-bold, cyrillic-font-base, cyrillic-font-narrow, cyrillic-font-extra-light, cyrillic-font-light, cyrillic-font-medium, cyrillic-font-bold, greek-font-base, greek-font-narrow, greek-font-extra-light, greek-font-light, greek-font-medium, greek-font-bold, simplified-chinese-font-base, simplified-chinese-font-narrow, simplified-chinese-font-extra-light, simplified-chinese-font-light, simplified-chinese-font-medium, simplified-chinese-font-bold, traditional-chinese-font-base, traditional-chinese-font-narrow, traditional-chinese-font-extra-light, traditional-chinese-font-light, traditional-chinese-font-medium, traditional-chinese-font-bold, korean-font-base, korean-font-narrow, korean-font-extra-light, korean-font-light, korean-font-medium, korean-font-bold, thai-font-base, thai-font-narrow, thai-font-extra-light, thai-font-light, thai-font-medium, thai-font-bold, VideoJS, mccom, mccom-Narrow, SofiaSans, MarkForMC

## 2. Color Palette & Roles

### Background & Surface
- **Off-White** (`#f3f0ee`): Page background (primary)
- **Pure White** (`#ffffff`): Surface / elevated background
- **Off-White** (`#fcfbfa`): Surface / elevated background

### Text & Content
- **Near-Black** (`#141413`): Primary body text
- **Pure Black** (`#000000`): Secondary text
- **Near-Black** (`#262627`): Secondary text
- **Charcoal** (`#333333`): Secondary text
- **Translucent Charcoal (70%)** (`rgba(43, 51, 63, 0.7)`): Secondary text

### Accent & Interactive
- **Coral** (`#f37338`): Interactive / accent
- **#3e34d3** (`#3e34d3`): Interactive / accent
- **Translucent Slate Gray (50%)** (`rgba(115, 133, 159, 0.5)`): Interactive / accent

### Border & Divider
- **Light Grey** (`#d1cdc7`): Borders / dividers

### Full Extracted Palette
**13 colors rendered on the page** + **72** more declared in design tokens (CSS custom properties — not necessarily painted). (12 categorized above + 73 additional below.)
Rendered values are read via `getComputedStyle()`; token values come from CSS variable declarations. Third-party logo colors are filtered out.

- `#555250` — Charcoal
- `#ee0000` — Red *(token)*
- `#fadede` — Soft Pink *(token)*
- `rgba(177, 173, 166, 0.25)` — Translucent Cool Gray (25%) *(token)*
- `#331505` — Near Black *(token)*
- `#266555` — #266555 *(token)*
- `#777470` — Slate Grey *(token)*
- `#583300` — Chocolate *(token)*
- `#b00606` — #b00606 *(token)*
- `#87a740` — #87a740 *(token)*
- `#038a00` — #038a00 *(token)*
- `#e8e5e1` — Whitesmoke *(token)*
- `#cf4500` — #cf4500 *(token)*
- `#ffd863` — #ffd863 *(token)*
- `#323231` — Charcoal *(token)*
- `#332805` — Warm Brown *(token)*
- `#9a3a0a` — Chocolate *(token)*
- `#dff7df` — Beige *(token)*
- `#852d01` — Chocolate *(token)*
- `#f7ad4c` — Tangerine *(token)*
- `#ffc61e` — Amber *(token)*
- `#ff9898` — #ff9898 *(token)*
- `#f9d199` — #f9d199 *(token)*
- `#dcf5ef` — Light Gray *(token)*
- `#7cd87a` — #7cd87a *(token)*
- `#fff4d1` — Vibrant Yellow *(token)*
- `#25836d` — Teal *(token)*
- `#664f0c` — Chocolate *(token)*
- `#a82226` — #a82226 *(token)*
- `#f8ddde` — Soft Pink *(token)*
- `#330505` — Jet Black *(token)*
- `#444340` — Charcoal *(token)*
- *…+41 more in `raw-css.json` (`desktop.allColors`).*

### Gradients & Decorative Fills

- `linear-gradient(rgba(0, 0, 0, 0.8), rgba(255, 255, 255, 0))` — (modal)

### CSS Custom Properties (Design Tokens)

**Font Weight Token**
- `--made-font-weight-bold`: `700`
- `--ais-font-weight-medium`: `500`
- `--aa-font-weight-bold`: `700`
- `--aa-font-weight-medium`: `500`

**Font Family Token**
- `--made-font-family-eyebrow`: `MarkOffcForMC-Bold, MarkOffcForMC, Arial, Helvetica, sans-serif`
- `--made-font-family-medium`: `MarkOffcForMC-Medium, MarkOffcForMC, Arial, Helvetica, sans-serif`
- `--made-font-family-heading`: `MarkOffcForMC-Bold, MarkOffcForMC, Arial, Helvetica, sans-serif`
- `--aa-font-family`: ``

**Z-Index Token**
- `--aa-base-z-index`: `9999`
- `--made-z-index-dropdown`: `30`
- `--made-z-index-backdrop`: `40`
- `--ais-z-index-chat`: `9998`

**Font Size Token**
- `--made-font-size-03`: `0.8125rem`
- `--made-font-size-08`: `1.25rem`
- `--made-font-size-12`: `2.25rem`
- `--made-font-size-05`: `0.9375rem`

**Spacing Token**
- `--made-font-heading-letter-spacing-eyebrow-02`: `1.8px`
- `--ais-spacing-factor`: `1`
- `--made-space-12-x`: `3rem`
- `--made-space-17-x`: `4.25rem`

**Background**
- `--made-footer-color-background`: `#141413`
- `--made-color-background-primary`: `#cf4500`
- `--made-color-background-02`: `#e8e5e1`
- `--made-connect-color-background-api`: `#ffc61e`

**Text Color**
- `--made-color-text-placeholder`: `#777470`
- `--made-color-text-default-on-light`: `#141413`
- `--made-color-text-helper`: `#555250`
- `--made-color-text-inverse`: `#ffffff`

**Border Radius Token**
- `--ais-border-radius-sm`: `4px`
- `--made-border-radius-07`: `20px`
- `--made-border-radius-02`: `4px`
- `--made-border-radius-01`: `2px`

**Error / Destructive**
- `--made-color-red-error-05`: `#b00606`
- `--made-color-red-error-02`: `#ff9898`
- `--made-color-red-01`: `#f8ddde`
- `--made-color-red-error-07`: `#330505`

**Success**
- `--made-color-green-03`: `#87a740`
- `--made-color-green-success-02`: `#7cd87a`
- `--made-color-green-01`: `#e8f1d5`
- `--made-color-green-success-05`: `#097007`

**Motion Token**
- `--ais-transition-timing-function`: `cubic-bezier(0.4,0,0.2,1)`
- `--ais-transition-duration`: `0.3s`

**Warning**
- `--made-color-yellow-03`: `#ffd863`
- `--made-color-yellow-07`: `#332805`
- `--made-color-yellow-01`: `#fff4d1`
- `--made-color-yellow-06`: `#664f0c`

**Primary Brand Color**
- `--made-color-accent-01-darker`: `#331505`
- `--made-color-brand-primary`: `#cf4500`
- `--made-color-accent-01-default`: `#cf4500`
- `--made-color-accent-01-dark`: `#852d01`

**Border**
- `--made-table-color-border-resize`: `#777470`
- `--made-color-border-default-on-dark`: `#555250`
- `--made-connect-color-border-document`: `#b1ada6`
- `--made-forms-color-border-default`: `#555250`

**Shadow Token**
- `--made-shadow-toggle`: `0 5px 10px 0 rgba(20,20,19,0.15), 0 2px 2px 0 rgba(20,20,19,0.3)`
- `--ais-shadow-color-rgb`: `23,23,23`
- `--made-shadow-default`: `0 2px 10px 0 rgba(20,20,19,0.20)`
- `--ais-shadow-md`: `0px 0px 0px 1px rgba(23,23,23,0.05),0px 4px 8px -2px rgba(23,23,23,0.25)`

**Other tokens**
- `--made-font-body-family-narrow`: `MarkForMCNrw, MarkOffcForMC, Arial, Helvetica, sans-serif`
- `--made-color-feedback-border-error`: `#ee0000`
- `--made-color-feedback-error-light`: `#fadede`
- `--made-color-action-disabled-toggle`: `rgba(177, 173, 166, 0.25)`
- `--made-color-action-text-primary-active`: `#331505`
- `--aa-panel-border-color-alpha`: `0.3`
- `--made-color-teal-05`: `#266555`
- `--made-font-heading-line-height-eyebrow-01`: `1.25`

## 3. Typography Rules

### Font Families
- **Primary**: `mccom`
- **Secondary**: `MarkForMCNrw`
- **Font 3**: `MarkForMCNrw-Medium`
- **Font 4**: `MarkForMCNrw-Bold`
- **Font 5**: `MarkOffcForMC`

### Custom Fonts Loaded
- **MarkForMCNrw** weight normal (normal)
- **MarkForMCNrw-Medium** weight normal (normal)
- **MarkForMCNrw-Bold** weight normal (normal)
- **MarkOffcForMC** weight normal (normal)
- **MarkOffcForMC-ExtraLight** weight normal (normal)
- **MarkOffcForMC-Light** weight normal (normal)
- **MarkOffcForMC-Medium** weight normal (normal)
- **MarkOffcForMC-Bold** weight normal (normal)
- **arial-unicode-base** weight normal (normal)
- **arial-unicode-bold** weight normal (normal)
- **arabic-font-base** weight normal (normal)
- **arabic-font-narrow** weight normal (normal)
- **arabic-font-extra-light** weight normal (normal)
- **arabic-font-light** weight normal (normal)
- **arabic-font-medium** weight normal (normal)
- **arabic-font-bold** weight normal (normal)
- **japanese-font-base** weight normal (normal)
- **japanese-font-narrow** weight normal (normal)
- **japanese-font-extra-light** weight normal (normal)
- **japanese-font-light** weight normal (normal)
- **japanese-font-medium** weight normal (normal)
- **japanese-font-bold** weight normal (normal)
- **georgian-font-base** weight normal (normal)
- **georgian-font-narrow** weight normal (normal)
- **georgian-font-extra-light** weight normal (normal)
- **georgian-font-light** weight normal (normal)
- **georgian-font-medium** weight normal (normal)
- **georgian-font-bold** weight normal (normal)
- **cyrillic-font-base** weight normal (normal)
- **cyrillic-font-narrow** weight normal (normal)
- **cyrillic-font-extra-light** weight normal (normal)
- **cyrillic-font-light** weight normal (normal)
- **cyrillic-font-medium** weight normal (normal)
- **cyrillic-font-bold** weight normal (normal)
- **greek-font-base** weight normal (normal)
- **greek-font-narrow** weight normal (normal)
- **greek-font-extra-light** weight normal (normal)
- **greek-font-light** weight normal (normal)
- **greek-font-medium** weight normal (normal)
- **greek-font-bold** weight normal (normal)
- **simplified-chinese-font-base** weight normal (normal)
- **simplified-chinese-font-narrow** weight normal (normal)
- **simplified-chinese-font-extra-light** weight normal (normal)
- **simplified-chinese-font-light** weight normal (normal)
- **simplified-chinese-font-medium** weight normal (normal)
- **simplified-chinese-font-bold** weight normal (normal)
- **traditional-chinese-font-base** weight normal (normal)
- **traditional-chinese-font-narrow** weight normal (normal)
- **traditional-chinese-font-extra-light** weight normal (normal)
- **traditional-chinese-font-light** weight normal (normal)
- **traditional-chinese-font-medium** weight normal (normal)
- **traditional-chinese-font-bold** weight normal (normal)
- **korean-font-base** weight normal (normal)
- **korean-font-narrow** weight normal (normal)
- **korean-font-extra-light** weight normal (normal)
- **korean-font-light** weight normal (normal)
- **korean-font-medium** weight normal (normal)
- **korean-font-bold** weight normal (normal)
- **thai-font-base** weight normal (normal)
- **thai-font-narrow** weight normal (normal)
- **thai-font-extra-light** weight normal (normal)
- **thai-font-light** weight normal (normal)
- **thai-font-medium** weight normal (normal)
- **thai-font-bold** weight normal (normal)
- **VideoJS** weight normal (normal)
- **mccom-icons** weight normal (normal)
- **mccom** weight 100 (normal)
- **mccom** weight 350 (normal)
- **mccom** weight 450 (normal)
- **mccom** weight 500 (normal)
- **mccom** weight 700 (normal)
- **mccom-Narrow** weight 400 (normal)
- **SofiaSans** weight 100 (normal)
- **SofiaSans** weight 350 (normal)
- **SofiaSans** weight 400 (normal)
- **SofiaSans** weight 500 (normal)
- **SofiaSans** weight 700 (normal)
- **SofiaSans** weight 900 (normal)
- **swiper-icons** weight 400 (normal)
- **MarkForMC** weight 100 (normal)
- **MarkForMC** weight 350 (normal)
- **MarkForMC** weight 450 (normal)
- **MarkForMC** weight 500 (normal)
- **MarkForMC** weight 700 (normal)
- **** weight normal (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | mccom | 120px | 500 | 1 | -2.4px | Main headline (h3) |
| Section Heading | mccom | 64px | 500 | 1 | -1.28px | Section titles (h1) |
| Sub-heading | mccom | 24px | 500 | 1.2 | -0.48px | Third-level heading (h3) |
| Body | mccom | 16px | 450 | 1.3 | normal | Standard reading text |
| Button Large | mccom | 16px | 500 | 1 | normal | Button label (16px) |
| Input Large | mccom | 16px | 400 | 1 | normal | Form input (16px) |
| Label Heading | mccom | 14px | 700 | 1 | 0.56px | Small heading (H5) |

### Font Weight Scale

CSS custom properties define 10 explicit weight steps:
- `--made-font-weight-light`: `100` — Thin
- `--made-font-weight-default`: `400` — Regular
- `--ais-font-weight-medium`: `500` — Medium
- `--aa-font-weight-medium`: `500` — Medium
- `--made-font-weight-medium`: `500` — Medium
- `--ais-font-weight-semibold`: `600` — SemiBold
- `--aa-font-weight-semibold`: `600` — SemiBold
- `--made-font-weight-bold`: `700` — Bold
- `--aa-font-weight-bold`: `700` — Bold
- `--ais-font-weight-bold`: `700` — Bold

### Full Font Size Scale

Sizes detected in the design (descending): `120px`, `64px`, `36px`, `30px`, `24px`, `20px`, `18px`, `16px`, `14px`, `12px`, `10px`

> 6 size(s) detected outside the sampled hierarchy (36px, 30px, 20px, 18px, 12px, 10px). These appear on elements not in the sampled set — likely additional display sizes, marketing-section overrides, or third-party-widget styles.

### OpenType & Variable Font Features

The typography uses these OpenType features intentionally — this is a sophisticated type system, not a default fallback:

- **localized forms** (`locl`) — glyphs swapped based on script/locale

**Clone instruction:** Enable these in your CSS:
```css
body {
  font-feature-settings: "locl";
}
```

## 4. Component Stylings

### Buttons

**Pill**
- Background: `transparent`
- Text: `#141413` `{colors.ink-muted}`
- Padding: 0px
- Radius: 999px
- Font: 16px weight 500
- Use: Status pills, tags, chips

**Ghost**
- Background: `transparent`
- Text: `#141413` `{colors.ink-muted}`
- Padding: 8px
- Radius: 0px
- Font: 16px weight 500
- Use: Subtle action, toolbar, nav button

**Pill**
- Background: `transparent`
- Text: `#141413` `{colors.ink-muted}`
- Padding: 19px
- Radius: 99px
- Font: 16px weight 500
- Use: Status pills, tags, chips

### Inputs & Forms

**Text Input**
- Background: `transparent`
- Text: `#262627`
- Padding: 0px 24px
- Radius: 0px
- Border: 0px none rgb(38, 38, 39)
- Font: 16px weight 400
- Use: Text fields, search inputs

### Status Badges

**Tinted**
- Background: `#f37338` `{colors.primary}`
- Text: `#f3f0ee` `{colors.surface-1}`
- Padding: 0px
- Radius: 50px
- Font: 0px weight 450
- Use: Status indicator, label, pill

### Tabs

**Pill Tab**
- Background: `#f37338` `{colors.primary}`
- Text: `#f3f0ee` `{colors.surface-1}`
- Padding: 0px
- Radius: 50px
- Font: 0px weight 450
- Use: Navigation tabs, filter tabs


## 4b. Component Behaviors (State Matrix)

### Interaction State Narrative

- **FooterLink**:
  - **hover:** text #ffffff → #d1cdc7, border changes

*State transitions extracted via Playwright simulation — exact values in the YAML matrix below.*

```yaml
component-behaviors:
  button:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(20, 20, 19)"
  input:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(38, 38, 39)"
  link:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(20, 20, 19)"
  tab:
    default:
      bg: "rgb(20, 20, 19)"
      fg: "rgb(243, 240, 238)"
  badge:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(20, 20, 19)"
  footerLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(255, 255, 255)"
    hover:
      bg: "transparent"
      fg: "rgb(209, 205, 199)"
```

**Agent usage**: Validate generated components against this matrix. If your output's `:hover` state changes properties not listed here, you are off-brand.


## 4c. Component Vocabulary (Closed System)

*This brand uses ONLY the following component vocabulary. Introducing new variants without justification breaks the system's tonal coherence.*

### Buttons
- **2 shape(s)** in this system: `Pill`, `Ghost`
- **DO NOT introduce new buttons variants** without justification

### Inputs & Forms
- **1 shape(s)** in this system: `Text Input`
- **DO NOT introduce new inputs & forms variants** without justification

### Status Badges
- **1 shape(s)** in this system: `Tinted`
- **DO NOT introduce new status badges variants** without justification

### Tabs
- **1 shape(s)** in this system: `Pill Tab`
- **DO NOT introduce new tabs variants** without justification

## 5. Layout Principles

### Layout Type
**top-nav + content**

### Grid
Single column, centered content

### Max Width
680px

### Spacing System
Compact spacing — information density prioritized

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 4px |
| sm | 6px |
| md | 12px |
| base | 16px |
| lg | 24px |
| xl | 32px |
| 2xl | 48px |
| 3xl | 76px |

### Border Radius Scale
| Name | Value | Use |
|------|-------|-----|
| None | 0px | No rounding |
| Xs | 4px | Tiny corners (badges, micro elements) |
| Sm | 9px | Buttons, inputs, small elements |
| Md | 20px | Cards, containers |
| Lg | 30px | Large rounded elements, pill segments |
| Xl | 40px | Category strips, featured containers |
| Full | 999px | Pills, avatars, circular elements |

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Buttons | `999px` |
| Inputs & Forms | `0px` |
| Status Badges | `50px` |
| Tabs | `50px` |
| Page Body | `0px` |
| Primary Input | `0px` |

**Shape Personality**: Sharp + Pill Contrast — Angular precision with pill-shaped accents (status badges, tags). Creates strong visual hierarchy.

**Full Radius Spectrum**: 0px, 4px, 5px, 6px, 9px, 20px, 30px, 40px (from `allBorderRadii` scan)


## 5b. Spacing Rhythm Names

**Measured section padding**: bands use ~120px internal vertical padding (up to 500px) — **very airy / premium**. (Distinct from the gap *between* sections above.) Reproduce this generous vertical breathing room; cramped spacing is the #1 tell of a cheap clone.

*Named spacing tokens with explicit use cases. Use these names in YOUR code instead of raw pixels for consistency.*

| Name | Value | Use case |
|------|-------|----------|
| **hero** | `76px` | Top/bottom of full-bleed hero sections |
| **section** | `32px` | Between major bands (color change, content shift) |
| **subsection** | `24px` | Within a section, between content groups |
| **card** | `12px` | Card padding, list-item spacing |
| **compact** | `6px` | Form fields, tight clusters, badge padding |
| **micro** | `4px` | Icon-text gap, tag inner padding |

**Agent rule**: NEVER hardcode raw pixel values for spacing in generated UI. Always reference these named tokens (`spacing-rhythm.section`, etc.).

## 5c. Widget & Structure Library

Structural patterns extracted from the page DOM — these are the **blueprints** an agent should follow to reproduce the page architecture (not just CSS values).

**3/8 structural patterns detected.**

### Hero Pattern

- **Composition:** split-right-text — Split layout, media-left/text-right — image in left column, heading + body in right column. Less common variant.
- **Viewport coverage:** full-viewport hero (≥70% screen height)
- **Heading:** "Dynamiser les économies et autonomiser les personnes" — 64px left-aligned
- **Subheading:** "Libérer le potentiel des personnes, des entreprises et des gouvernements du monde entier."
- **Media:** present, positioned left
- **CTAs:** 2 (primary: "Précédent")
- **Clone instruction:** Reproduce the **split-right-text** layout. Use the heading font-size token at the documented size. Place media left of text.

### Card Grid Pattern

- **Card count:** 3 cards detected
- **Columns (desktop):** 1-up grid
- **Card dimensions:** 1240×623px (aspect 1.99:1)
- **Gap:** 0px between cards
- **Content:** ✗ no image + CTA
- **Clone instruction:** Build a 1-column grid (desktop) with cards at ~1.99:1 aspect ratio. Text/icon-only cards (no photography).

### Footer Pattern

- **Columns:** 4
- **Links:** 27 total
- **Height:** 716px
- **Includes:** ✗ no newsletter | ✓ social icons |  ✓ copyright
- **Clone instruction:** Build a 4-column footer with ~7 links per column, social media links, and a copyright line.

## 6. Depth & Elevation

| Level | Treatment | Use |
|-------|-----------|-----|
| Flat (Level 0) | No shadow | Page background, content blocks |
| Layered (Level 1) | <br>`rgba(0, 0, 0, 0.04) 0px 4px 24px 0px` | Cards, elevated surfaces |
| Layered (Level 2) | <br>`rgba(0, 0, 0, 0.08) 0px 24px 48px 0px` | Cards, elevated surfaces |
| Layered (Level 3) | <br>`rgba(0, 0, 0, 0.25) 0px 70px 110px 0px` | Cards, elevated surfaces |
| Layered (Level 4) | <br>`rgba(20, 20, 19, 0.2) 0px 2px 10px 0px` | Cards, elevated surfaces |

**Shadow Philosophy**: Multi-layered shadow system creating natural, atmospheric depth. Each shadow level combines multiple layers for realistic elevation.

## 7. Motion & Interaction

### Easing System

| CSS Variable | Curve | Semantic Name |
|--------------|-------|---------------|
| `--ais-transition-timing-function` | `cubic-bezier(0.4,0,0.2,1)` | Material Standard — Balanced |

### Duration Scale

| CSS Variable | Value | Tier |
|--------------|-------|------|
| `--ais-transition-duration` | `0.3s` | Normal |

### Copy-Paste Transition Snippets

**All Props**
```css
transition: top 0.5s ease-in-out;
```

**Opacity**
```css
transition: opacity 0.3s ease-in-out;
```

**Background**
```css
transition: background-color 0.3s ease-in-out, top 1s ease-in-out;
```

**All Props**
```css
transition: 0.5s ease-in-out;
```

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `cmp-search__loading-indicator-spin` | Rotate / Spin | transform | Loading indicator |
| `ais-fadeIn` | Fade | opacity | Element entrance |
| `ais-chat-loader-spinner` | Rotate / Spin | stroke-dasharray, stroke-dashoffset, transform | Loading indicator |
| `ais-chat-loader-skeleton` | Fade | opacity | Loading indicator |
| `ais-chat-loader-text` | Custom | background-position-x, background-position-y | Loading indicator |
| `ais-filter-suggestions-skeleton` | Fade | opacity | Loading placeholder |
| `vjs-spinner-show` | Custom | visibility | Loading indicator |
| `vjs-spinner-spin` | Rotate / Spin | transform | Loading indicator |
| `vjs-spinner-fade` | Custom | border-top-color | Loading indicator |
| `delay-overflow` | Custom | overflow-y | UI transition |
| `animate-image` | Custom | margin-left | UI transition |
| `animate-image-pill` | Fade | opacity, width | UI transition |
| `swiper-preloader-spin` | Rotate / Spin | transform | Loading indicator |
| `spin` | Rotate / Spin | transform | Loading indicator |
| `bottom-navigation-slide-in` | Slide | bottom, transform, position, z-index | Panel / drawer enter |
| `fadein` | Fade | opacity | Element entrance |
| `hero-text-reveal` | Slide | background-size, transform | UI transition |
| `dissolve` | Fade | opacity | UI transition |
| `onetrust-fade-in` | Fade | opacity | Element entrance |

### Motion Fingerprint

- **Speed Character**: Cinematic & Slow (median duration: `800ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 19 unique animations (19 total including variants)

> This design moves with cinematic & slow timing using custom cubic-bezier curves, creating a UI that feels slow and cinematic.

## 8. Do's and Don'ts

### Do
- Use Off-White (`#f3f0ee`) as the page background — it's intentionally not pure white
- Use Near-Black (`#141413`) for text — not pure black, it's warmer and more readable
- Use mccom as the primary typeface — it defines the brand personality
- Use negative letter-spacing (-1.28px) at display sizes for compressed, editorial headlines
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use full-pill radius (9999px) only for specific elements (avatars, pills, toggles)
- Use Coral (`#f37338`) as the primary accent — it's the brand's signature interactive color
- Use 99px border-radius on primary buttons — the brand uses generously-rounded CTAs
- Respect the 4px–32px spacing range — the design uses a wide scale for visual breathing room
- Make the hero full-viewport (≥70% screen height) — this design uses an immersive hero, not a tall navbar
- Build the hero as a split layout with media on the right — text and visual share equal weight
- Include exactly 2 CTAs in the hero (primary + secondary) — this design pattern is multi-action, not single-purpose
- Build a content-dense footer (4 columns, ~27 links) — this site treats the footer as a sitemap, not an afterthought

### Don't
- Don't use pure white (`#ffffff`) as a page background — the warm tone is part of the brand identity
- Don't use pure black (`#000000`) for text — the near-black adds warmth
- Don't substitute with generic sans-serif or serif — the custom font carries the brand
- Don't increase letter-spacing on headings — the type is designed to run tight at scale
- Don't invent new shadow values — use only the extracted shadow levels
- Don't apply pill radius on rectangular buttons or cards — it's reserved for specific interactive elements
- Don't introduce additional saturated accent colors — the palette is intentionally controlled
- Don't use sharp-cornered or pill buttons — 99px is the CTA border-radius standard


## 7b. Enforceable Brand Rules

*Structured Do/Don't with reasoning and validation tests. Agents can programmatically verify generated UI.*

```yaml
rules:
  - id: brand-canvas-001
    type: do
    rule: "Always use the page background `rgb(243, 240, 238)` as the base canvas"
    why: "Every component is designed to composit against this exact tone"
    test: "document.body.style.backgroundColor === 'rgb(243, 240, 238)'"
  - id: brand-accent-001
    type: do
    rule: "Reserve `rgb(243, 115, 56)` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"rgb(243, 115, 56)\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile | 375px | Single column, compact spacing |
| Mobile | 425px | Single column, compact spacing |
| Mobile Large | 610px | Expanded mobile layout |
| Mobile Large | 767px | Expanded mobile layout |
| Tablet | 1024px | Multi-column grids begin |
| Large Desktop | 1424px | Maximum content width |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `64px` | `48px` |
| heading | line-height | `64px` | `52.8px` |
| heading | letter-spacing | `-1.28px` | `-0.96px` |
| main | padding | `0px 12px` | `0px 8px` |

### Collapsing Strategy
- Headlines: 64px → 48px on mobile
- Container padding: 0px 12px → 0px 8px on mobile
- Navigation: horizontal links → hamburger menu on mobile
- Cards: multi-column → stacked vertical on mobile
- Footer: multi-column → stacked single column on mobile

### Touch Targets
- Buttons: 0px padding
- Navigation: adequate spacing between items
- Interactive elements: minimum 44px touch target recommended

### Collapsing Narrative

How the structural patterns adapt from desktop to mobile (extracted from both viewport extractions):

- **Hero collapses split-right-text → left-aligned** — composition shifts (verify on actual mobile render).
- **Hero CTAs:** 2 on desktop → 0 on mobile (secondary CTAs dropped on small screens).
- **Footer columns collapse:** 4 columns (desktop) → 1 column (mobile).


## 7c. Visual Effects & Dynamic Behavior

*The live/dynamic layer beyond static CSS — reproduce these, not flat substitutes. This is often what separates a faithful clone from a wireframe.*

- **Animated SVG** — path/line-draw animations.
- **Glassmorphism** — 1 frosted/blur layer(s) (e.g. `blur(7px)`).
- **Scroll-driven reveals** — content animates in on scroll (CSS scroll-timeline). Build fade/translate reveal-on-scroll for below-fold bands.

> **Motion fingerprint**: SVG animations, glassmorphism (1 layers), CSS scroll-driven animations

## 9b. Visual Tone & Photography

**Tone:** Mixed photography + illustration

A balanced mix of photographic content and vector graphics. Photos likely carry product/lifestyle context while SVG handles icons, logos, and decorative accents.

**Canonical Brand Image (OG):**
- /content/dam/mccom/shared/socialmedia/mastercard-og-image.png
  *This is the image shown when the site is shared on social media — represents the brand visual essence.*

**Hero Image (above-fold dominant visual):**
- Aspect: 2.07:1 (landscape (16:9-ish))
- Rendered size: 1282×620px
- Alt text: "A shopping cart superimposed on top of a mobile phone screen with blue and orange  dots being held by a person's hands ."
- *Use this aspect ratio + composition for your clone's hero — mimicking the proportion preserves the visual hierarchy.*

**Aspect Ratio Distribution:**
- Landscape (1.15–2.3): 6 (43%)
- Portrait (<0.87): 3 (21%)
- Square (0.87–1.15): 5 (36%)

**Media Format Mix:**
- JPG: 7 (typically photographic content)
- PNG: 1 (logos, transparent UI elements, mockups)
- GIF: 6 (animated content)

**Average rendered image size:** 747×598px
**Above-fold image count:** 0 / 14

**Decorative Patterns Detected:**
- 4 multi-stop linear gradients (mesh-like, 3+ color stops) — the brand leans on rich color transitions for visual depth
- **Glassmorphism** detected (`backdrop-filter: blur`) — layered transparent surfaces with blur, modern OS-like aesthetic

**Clone instruction for decorative work:** This is a gradient-rich design — invest in multi-stop CSS gradients (3+ color stops), not solid backgrounds.

**Imagery Guidance for clones:**
- Mix photography and illustration intentionally: photos for product/context, vectors for icons + decorative accents.
- Respect the format split — replacing JPGs with illustrations (or vice versa) will shift the brand tone.

## 10. Agent Prompt Guide

### Quick Reference
- Background: Off-White (`#f3f0ee`)
- Primary text: Near-Black (`#141413`)
- Accent: Coral (`#f37338`)
- Border: Charcoal (`#333333`)
- Font: mccom
- Body: 16px weight 450

### Example Component Prompts
- "Create a hero section on Off-White background (#f3f0ee). Headline at 64px mccom weight 500, line-height 1, letter-spacing -1.28px, color #141413."
- "Create the primary CTA button: `#f37338` background, `#141413` text, 999px border-radius, 12px 24px padding, 500 weight, mccom font."
- "Build navigation: sticky on `#f3f0ee`. mccom 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the light canvas to Off-White (`#f3f0ee`) — every component is composited against this exact base.
2. **Typography**: All type in mccom, weight range 100–700. Never exceed 700 — heavier weights break the brand's tonal restraint.
3. **Accent**: Coral (`#f37338`) — one accent, applied consistently to CTAs, active states, and links. Never introduce a second saturated color.
4. **Motion**: All transitions use `cubic-bezier(0.25,0.1,0.25,1)`. Timing: 300ms for micro-interactions, 300ms for layout changes. Never use linear for UI transitions — preserve the brand's easing personality.
5. **Shape**: CTAs at `0px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (4px–32px). All padding, margin, and gap values are multiples from this scale — no magic numbers.
7. **Tokens**: Import from §11 CSS Export (`--ca-*` vars). Never hardcode hex values — always reference a token so theming remains consistent.

## 11. CSS Design Tokens Raw Export

*Copy-paste ready `:root {}` block — all values extracted directly from the live site.*

```css
/* Colors */
:root {
  --ca-surface-1: #f3f0ee;
  --ca-surface-2: #ffffff;
  --ca-ink-muted: #141413;
  --ca-ink-subtle: #323231;
  --ca-primary: #f37338;
  --ca-on-primary: #111111;
  --ca-primary-hover: #3e34d3;
  --ca-hairline: #333333;
  --ca-semantic-error: #ee0000;
  --ca-semantic-success: #038a00;
  --ca-semantic-warning: #f38b00;
}

/* Typography */
:root {
  --ca-font-primary: "mccom", system-ui, sans-serif;
  --ca-text-display: 120px;
  --ca-text-heading: 64px;
  --ca-text-body: 16px;
  --ca-text-button: 16px;
  --ca-text-mono: 16px;
}

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 4px;
  --ca-space-sm: 6px;
  --ca-space-md: 12px;
  --ca-space-base: 16px;
  --ca-space-lg: 24px;
  --ca-space-xl: 32px;
  --ca-space-2xl: 48px;
  --ca-space-3xl: 76px;
  --ca-radius-none: 0px;
  --ca-radius-xs: 4px;
  --ca-radius-sm: 9px;
  --ca-radius-md: 20px;
  --ca-radius-lg: 30px;
  --ca-radius-xl: 40px;
  --ca-radius-full: 999px;
}
```


## 13. Page Structure Skeleton

*The actual layout the source site uses. Reproduce these sections in order to match the site structure.*

```yaml
page-skeleton:
  - section: hero
    tag: div
    classes: ["root", "container", "responsivegrid"]
    height: 9093px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["container", "responsivegrid", "mccom-full-width", "aem-GridColumn--default--12"]
    height: 807px
    width: full-bleed
    layout: block
    children: 1
  - section: feature-section
    tag: main
    classes: ["container", "responsivegrid", "aem-GridColumn--default--12"]
    height: 9093px
    width: full-bleed
    layout: block
    children: 1
    padding: "0px 12px"
  - section: feature-section
    tag: div
    height: 9093px
    width: full-bleed
    layout: block
    children: 1
  - section: feature-section
    tag: div
    height: 9093px
    width: 1416px
    layout: block
    children: 1
  - section: feature-section
    tag: div
    classes: ["container", "responsivegrid", "aem-GridColumn--default--12"]
    height: 9093px
    width: 1416px
    layout: block
    children: 1
  - section: feature-section
    tag: div
    height: 9093px
    width: 1416px
    layout: block
    children: 1
  - section: unknown
    tag: div
    height: 783px
    width: full-bleed
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["mccom-video-hero-container"]
    height: 783px
    width: 1392px
    layout: block
    children: 1
  - section: unknown
    tag: div
    classes: ["video-hero"]
    height: 783px
    width: full-bleed
    layout: block
    children: 1
    padding: "0px 24px"
  - section: unknown
    tag: div
    classes: ["video-js", "mccom-video-hero", "mccom-video-hero-skin", "vjs-fill"]
    height: 783px
    width: 1392px
    layout: block
    children: 8
    bg: "rgb(0, 0, 0)"
    vertical-padding: ~40px
  - section: navigation
    tag: div
    classes: ["panelcontainer"]
    height: 320px
    width: 1073px
    layout: grid: 2-col gap=normal
    children: 2
  - section: navigation
    tag: div
    classes: ["panelcontainer"]
    height: 192px
    width: 1073px
    layout: grid: 2-col gap=normal
    children: 2
  - section: navigation
    tag: div
    classes: ["panelcontainer"]
    height: 320px
    width: 1073px
    layout: grid: 2-col gap=normal
    children: 2
  - section: navigation
    tag: div
    classes: ["panelcontainer"]
    height: 256px
    width: 1073px
    layout: grid: 2-col gap=normal
    children: 2
  - section: navigation
    tag: div
    classes: ["panelcontainer"]
    height: 320px
    width: 1073px
    layout: grid: 2-col gap=normal
    children: 2
  - section: feature-section
    tag: div
    height: 714px
    width: 211px
    layout: block
    children: 1
  - section: feature-section
    tag: div
    classes: ["container", "responsivegrid", "mccom-max-width-lg", "mccom-margin-top-lg"]
    height: 1099px
    width: full-bleed
    layout: block
    children: 1
  - section: feature-section
    tag: div
    classes: ["teaser", "mccom-section-intro-default"]
    height: 266px
    width: 1240px
    layout: block
    children: 1
  - section: feature-section
    tag: div
    height: 1099px
    width: 1240px
    layout: block
    children: 2
  - section: feature-section
    tag: div
    classes: ["container", "responsivegrid", "mccom-margin-bottom-lg"]
    height: 266px
    width: 1240px
    layout: block
    children: 1
  - section: feature-section
    tag: div
    height: 266px
    width: 1240px
    layout: block
    children: 1
  - section: feature-section
    tag: div
    classes: ["carousel", "panelcontainer", "mccom-branded-intro"]
    height: 763px
    width: 1240px
    layout: block
    children: 1
  - section: feature-section
    tag: div
    classes: ["swiper-wrapper"]
    height: 599px
    width: 1240px
    layout: flex-row justify=normal
    children: 5
  - section: feature-section
    tag: div
    classes: ["container", "responsivegrid", "mccom-max-width-lg", "mccom-margin-top-lg"]
    height: 477px
    width: full-bleed
    layout: block
    children: 1
```

**Agent rule**: rebuild sections in this order (sorted by vertical position). Match the layout primitive (grid N-col / flex direction / block).


## 14. Copy Library (Real Content from Source)

*Actual text content extracted from the live page. Use these strings verbatim when reproducing the site — they carry the brand voice.*

```yaml
copy:
  section-headings:
    - "Commerce agentique 101"
  sub-headings:
    - "Ensemble, les possibilités sont priceless"
    - "Aperçus et Intelligence"
    - "Des avantages et des services qui soutiennent vos ambitions"
    - "Trouvez une carte qui vous convient"
    - "Des expériences qui éveillent vos passions"
  ctas:
    - "Pour vous"
  footer-links:
    - "Obtenir de l'aide"
    - "À propos"
    - "Carrières s’ouvre dans un nouvel onglet"
    - "Confidentialité et responsabilité des données"
    - "Confidentialité"
    - "LinkedIn"
```

**Agent rule**: reuse these exact strings when generating UI. Do NOT translate or rephrase — brand voice is preserved through the original wording.


## 15. Asset Inventory (Image Roles & Ratios)

*Image inventory classified by role and aspect ratio. When reproducing the site, allocate this number of assets per role.*

```yaml
assets:
  logo:
    count: 1
    avg-ratio: 1.63
    common-aspect: "~16:9 landscape"
    sample-alts:
      - "Mastercard brand symbol - a global technology company in the"
  hero:
    count: 3
    avg-ratio: 2.07
    common-aspect: "~16:9 landscape"
    sample-alts:
      - "A young woman holds a smartphone and looks at a digital mess"
      - "Des collègues réunis autour d'une table."
      - "A shopping cart superimposed on top of a mobile phone screen"
  product:
    count: 5
    avg-ratio: 1.00
    common-aspect: "~1:1 square"
    sample-alts:
      - "Personne effectuant un paiement avec une montre."
      - "Tapotement de la main sur l’écran."
      - "Propriétaire d'entreprise tapant sur une tablette."
  editorial:
    count: 3
    avg-ratio: 0.62
    common-aspect: "~9:16 portrait"
    sample-alts:
      - "Femme tapant sur un appareil mobile."
      - "Personne portant une ceinture de sécurité dans un véhicule s"
      - "Une femme ajuste la ceinture d'une cliente essayant une robe"
```

**Agent rule**: when generating placeholder images, match these counts and aspect ratios. Use neutral placeholder backgrounds for `product` (e.g. `#f5f5f5`), full-color photography hints for `hero` and `editorial`.


## 16. Component HTML Templates

*Suggested HTML markup for reproducing the key components — based on what was detected in the source DOM.*

### Button (primary action)
```html
<button class="btn btn-primary">
  Pour vous
</button>
```
_Source pattern detected: padding `8px` · radius `0px` · weight `500`_

**Agent rule**: use these markup skeletons as the structural baseline. Apply tokens from §2-3 for visual styling.


## 17. Content Architecture & Resources (Links by Purpose)

*The page's links classified by purpose — the information architecture to reproduce. Categories, featured images, devices and projects are extracted from the rendered DOM, not guessed.*

**By purpose:** **nav** 1 · **social** 4 · **footer** 21 · **download** 2 · **other** 16

**Signals:** 12/44 links carry a featured image · device mockups detected: laptop ×5, phone ×5, tablet ×1 · dominant link roles: footer-link (27), content-card (11), inline-link (5).


---
## Extraction Completeness: 77/100 (B)

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 17 | 25 | 12 named colors |
| Typography | 18 | 20 | 7 roles defined |
| Components | 16 | 20 | 4 specs extracted |
| Motion & Interaction | 12 | 15 | Keyframes |
| CSS Custom Properties | 10 | 10 | 517 vars |
| Responsive Breakpoints | 5 | 5 | 6 breakpoints |
| Variable Fonts | 0 | 5 | None detected |

## 12. Known Gaps & Confidence

Explicit list of what this extraction could NOT capture. Agents should not invent values for these — either skip the feature or use the documented baseline + heuristic fallback.

*Auto-detected extraction limitations — understand before building:*

- **Sparse component extraction** — fewer than 5 component types detected. Highly dynamic sections (modals, datepickers, carousels) require interaction to render and are not captured in a static pass.

*✅ No critical extraction gaps detected — high-confidence reproduction expected.*

### Per-section confidence

| Section | Confidence | Reason |
|---------|------------|--------|
| §1 Visual Theme | High | Body bg extracted via getComputedStyle() |
| §2 Colors | High | 517 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | High | 7 typography roles inferred |
| §4 Components | Medium | 4 component variants captured |
| §7 Motion | High | Keyframes + transitions |
| §8 Do's/Don'ts | High | 21 rules generated; design-decisions.json has evidence per rule |
| §9 Responsive | High | 6 breakpoints detected |
| §9b Photography | High | 14 images, hero present |

## 11.2 Measured Reality (CDP Engine)

Captured directly from Chrome's engine across **all 1009 rendered nodes** — not a sample. These are the values the page *actually paints*, weighted by how often they appear.

### Real Responsive Breakpoints
**32 breakpoints** read from the live `@media` rules (not guessed) — 14 most relevant:
`375px` · `388px` · `400px` · `425px` · `426px` · `530px` · `550px` · `575px` · `599px` · `600px` · `601px` · `610px` · `640px` · `680px` … (+18 more)

### Measured Design Scale
**Type scale by usage** (× = paint count): `16px`×748 · `14px`×127 · `36px`×36 · `20px`×22 · `12px`×17 · `10px`×13 · `32px`×12 · `2px`×6

**Radius scale** (× = paint count): `6px`×46 · `99px`×45 · `50%`×36 · `1000px`×30 · `20px`×27 · `40px`×23 · `999px`×12 · `80px`×3

**Weights** (× = paint count): `450`×588 · `500`×259 · `400`×125 · `700`×33 · `600`×2

**Layout gaps** (× = paint count): `12px`×19 · `16px`×4 · `32px`×1 · `40px`×1 · `8px`×1

**Elevation (real shadows)**:
```css
rgba(0, 0, 0, 0.04) 0px 4px 24px 0px
rgba(0, 0, 0, 0.08) 0px 24px 48px 0px
rgba(0, 0, 0, 0.25) 0px 70px 110px 0px
```

### Provenance — measured styles on key elements
Read from the live CSSOM (includes runtime-injected CSS). This is *what actually styles the page*, by element:

```css
@media screen body { background-color:var(--made-color-background-default); color:var(--made-color-text-default-on-light); font-family:var(--made-font-body-family-default) }
@media screen body { font-size:var(--made-font-body-size-default) }
body { font-size:1rem; font-family:"mccom","SofiaSans",Arial,sans-serif; font-weight:450; color:#141413; background:#f3f0ee; background-color:rgb(243, 240, 238) }
@media screen h1 { font-family:var(--made-font-heading-family-level-01); font-size:var(--made-font-heading-size-level-01); font-weight:var(--made-font-heading-weight-level-01) }
h1 { font-size:3rem; font-weight:500; font-family:"mccom","SofiaSans",Arial,sans-serif }
h1 { font-size:4rem; font-weight:500; font-family:"mccom","SofiaSans",Arial,sans-serif; color:#141413 }
@media screen h2 { font-family:var(--made-font-heading-family-level-02); font-size:var(--made-font-heading-size-level-02); font-weight:var(--made-font-heading-weight-level-02) }
h2 { font-size:2.5rem; font-weight:500; font-family:"mccom","SofiaSans",Arial,sans-serif }
h2 { font-size:2.25rem; font-weight:500; font-family:"mccom","SofiaSans",Arial,sans-serif; background-color:#fff; border-radius:40px }
h2 { transition:all 1000ms }
button { background-color:rgba(0,0,0,0); color:#141413; font-weight:500 }
button { background-color:rgba(0,0,0,0); color:#141413; font-weight:500; border-radius:999px }
```

> Selectors normalised to their semantic element — source class names are often build-hashed (`.bgDIHX`) and not reusable. The declarations + CSS vars are the transferable part.

---
*Generated by Prism — automated Playwright extraction + design analysis.*
*Source: https://mastercard.com | 2026-06-11T05:01:29.938Z*
*Values extracted via getComputedStyle() (rendered) + CSS custom properties (tokens, marked `(token)`). Token-only values may not be painted — verify against the live site before shipping.*