:root {
	/* ==========================================================================
	   Mapped tokens — public API for style.css + feature CSS (home, header, …)
	   Consume these. Do not use --brand-* in components.
	   Alias (--color-*, --font-*, --space-*) is an internal bridge only.
	   ========================================================================== */

	/* Document */
	--body-font-family: var(--font-body);
	--body-font-stretch: var(--font-body-stretch);
	--body-font-weight: var(--font-body-weight);
	--body-font-size: var(--font-body-size);
	--body-line-height: var(--font-body-leading);
	--body-font-variation: var(--font-body-variation);
	--body-color: var(--color-fg-body);

	/* Headings (Divi Text/Heading modules + HTML h1–h6) */
	--heading-font-family: var(--font-display);
	--heading-font-stretch: var(--font-display-stretch);
	--heading-font-weight: var(--font-display-weight);
	--heading-text-transform: var(--font-display-transform);
	--heading-font-variation: var(--font-display-variation);
	--heading-letter-spacing: 0;
	--heading-font-synthesis: none;
	--heading-color: var(--color-fg);

	--heading-h1-font-size: var(--font-h1-size);
	--heading-h1-line-height: var(--font-h1-leading);
	--heading-h2-font-size: var(--font-h2-size);
	--heading-h2-line-height: var(--font-h2-leading);
	--heading-h3-font-size: var(--font-h3-size);
	--heading-h3-line-height: var(--font-h3-leading);

	/* Buttons (Divi + Woo add to cart) */
	--button-font-family: var(--font-ui);
	--button-font-stretch: var(--font-button-stretch);
	--button-font-weight: var(--font-button-weight);
	--button-font-size: var(--font-button-size);
	--button-letter-spacing: var(--font-button-tracking);
	--button-text-transform: var(--font-button-transform);
	--button-font-variation: var(--font-button-variation);
	--button-font-synthesis: none;
	--button-background: var(--color-button-primary-bg);
	--button-color: var(--color-button-primary-fg);
	--button-border-radius: var(--radius);
	--button-border-width: var(--border-width);

	/* Nav */
	--nav-font-family: var(--font-ui);
	--nav-font-stretch: var(--font-nav-stretch);
	--nav-font-weight: var(--font-nav-weight);
	--nav-font-size: var(--font-nav-size);
	--nav-letter-spacing: var(--font-nav-tracking);
	--nav-text-transform: var(--font-nav-transform);
	--nav-font-variation: var(--font-button-variation);
	--nav-font-synthesis: none;
	--nav-color: var(--color-fg);

	/* Product — title (single + loop) */
	--product-title-font-family: var(--heading-font-family);
	--product-title-font-stretch: var(--heading-font-stretch);
	--product-title-font-weight: var(--heading-font-weight);
	--product-title-text-transform: var(--heading-text-transform);
	--product-title-font-variation: var(--heading-font-variation);
	--product-title-letter-spacing: var(--heading-letter-spacing);
	--product-title-font-synthesis: var(--heading-font-synthesis);
	--product-title-font-size: var(--heading-h1-font-size);
	--product-title-line-height: var(--heading-h1-line-height);
	--product-loop-title-font-size: var(--heading-h3-font-size);
	--product-loop-title-line-height: var(--heading-h3-line-height);

	/* Product — description / tabs */
	--product-description-font-family: var(--body-font-family);
	--product-description-font-stretch: var(--body-font-stretch);
	--product-description-color: var(--body-color);

	/* Product — price */
	--product-price-font-family: var(--font-label);
	--product-price-font-stretch: 100%;
	--product-price-font-variation: normal;
	--product-price-font-synthesis: none;
	--product-price-font-weight: var(--font-label-weight-medium);
	--product-price-font-size: var(--font-price-size);
	--product-price-color: var(--color-fg);

	/* Product — meta, SKU, breadcrumb */
	--product-meta-font-family: var(--font-label);
	--product-meta-font-stretch: 100%;
	--product-meta-font-variation: normal;
	--product-meta-font-synthesis: none;
	--product-meta-font-weight: var(--font-label-weight);
	--product-meta-font-size: var(--font-label-size);
	--product-meta-letter-spacing: var(--font-label-tracking);
	--product-meta-text-transform: var(--font-label-transform);
	--product-meta-color: var(--color-fg-muted);

	/* Product — sale badge */
	--product-badge-font-family: var(--font-label);
	--product-badge-font-weight: var(--font-label-weight);
	--product-badge-font-size: var(--font-label-size);
	--product-badge-letter-spacing: var(--font-label-tracking);
	--product-badge-text-transform: var(--font-label-transform);
	--product-badge-background: var(--color-badge-sale-bg);
	--product-badge-color: var(--color-badge-sale-fg);

	/* Product — add to cart (same as button) */
	--product-button-font-family: var(--button-font-family);
	--product-button-font-stretch: var(--button-font-stretch);
	--product-button-font-weight: var(--button-font-weight);
	--product-button-font-size: var(--button-font-size);
	--product-button-letter-spacing: var(--button-letter-spacing);
	--product-button-text-transform: var(--button-text-transform);
	--product-button-font-variation: var(--button-font-variation);
	--product-button-background: var(--button-background);
	--product-button-color: var(--button-color);

	/* Counters / timers / chrome labels (Plex Mono) */
	--label-font-family: var(--font-label);
	--label-font-stretch: 100%;
	--label-font-variation: normal;
	--label-font-synthesis: none;
	--label-font-size: var(--font-label-size);
	--label-font-size-lg: var(--font-label-size-lg);
	--label-font-weight: var(--font-label-weight);
	--label-font-weight-medium: var(--font-label-weight-medium);
	--label-letter-spacing: var(--font-label-tracking);
	--label-letter-spacing-badge: var(--font-label-tracking-badge);
	--label-text-transform: var(--font-label-transform);

	/* --------------------------------------------------------------------------
	   Feature CSS API — surfaces, type color, space, layout
	   (home-layout, header-mock, about-layout, future oi-* sheets)
	   -------------------------------------------------------------------------- */

	/* Surfaces */
	--surface-bg: var(--color-bg);
	--surface-bg-elevated: var(--color-bg-surface);
	--surface-bg-inverse: var(--color-bg-inverse);
	--surface-bg-photo: var(--color-bg-photo);
	--surface-card-inverse: var(--color-bg-card-inverse);

	/* Text */
	--text: var(--color-fg);
	--text-body: var(--color-fg-body);
	--text-secondary: var(--color-fg-secondary);
	--text-muted: var(--color-fg-muted);
	--text-on-accent: var(--color-fg-on-accent);
	--text-footer: var(--color-fg-footer);
	--text-inverse: var(--color-fg-inverse);
	--text-muted-inverse: var(--color-fg-muted-inverse);

	/* Accent / feedback */
	--accent: var(--color-accent);
	--accent-hover: var(--color-accent-text);
	--accent-on-dark: var(--color-accent-on-dark);
	--success: var(--color-success);

	/* Strokes */
	--stroke: var(--color-border);
	--stroke-subtle: var(--color-border-subtle);
	--stroke-input: var(--color-border-input);
	--stroke-inverse: var(--color-border-inverse);
	--stroke-width: var(--border-width);

	/* Layout */
	--layout-wide: var(--layout-max-wide);
	--layout-standard: var(--layout-max);
	--layout-gutter: var(--space-gutter);
	--layout-section: var(--space-section);
	--layout-logo: var(--logo-height);

	/* Spacing scale (wraps alias — avoids colliding redefines) */
	--gap-3xs: var(--space-3xs);
	--gap-2xs: var(--space-2xs);
	--gap-xs: var(--space-xs);
	--gap-sm: var(--space-sm);
	--gap-md: var(--space-md);
	--gap-lg: var(--space-lg);
	--gap-xl: var(--space-xl);

	/* Shared weights for feature CSS */
	--weight-medium: var(--brand-font-weight-medium);
	--weight-semibold: var(--brand-font-weight-semibold);
	--weight-bold: var(--brand-font-weight-bold);

	/* Header recipes */
	--header-top-bg: var(--accent);
	--header-top-color: var(--text-on-accent);
	--header-bar-border: var(--stroke-subtle);
	--header-cart-bg: var(--button-background);
	--header-cart-color: var(--button-color);
	--header-mega-bg: var(--surface-bg-elevated);
	--header-mega-border: var(--stroke);
}
