---
import Default from '@astrojs/starlight/components/Head.astro';

import { brand } from '../lib/brand.mjs';

/**
 * Overrides Starlight's `Head` so the documentation carries the same brand wiring as the
 * marketing pages (§7).
 *
 * Starlight builds its own head, and without this the docs were a different site: they
 * linked `/favicon.svg` — a Starlight default that does not exist here, so every docs page
 * requested a 404 — carried no manifest, no OG card, and crucially no `/brand/theme.css`,
 * which meant a mounted theme recoloured the marketing pages and left the documentation
 * stock. Half a rebrand is arguably worse than none, because it looks like a bug in the
 * product rather than a step somebody missed.
 *
 * Starlight's own `favicon` option handles the .ico (see `astro.config.mjs`); everything
 * that option cannot express is here.
 */
---

<Default><slot /></Default>

<link rel="icon" href="/brand/favicon-32.png" type="image/png" sizes="32x32" />
<link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
<link rel="manifest" href="/manifest.webmanifest" />

<meta property="og:image" content={new URL('/brand/og-image.png', Astro.site)} />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:image:alt" content={`${brand.siteName} — ${brand.tagline}`} />
<meta name="twitter:card" content="summary_large_image" />

<!--
  The operator's stylesheet, last (§7). Its position no longer decides whether it wins —
  `tokens.css` lives in `@layer tokens` and this file is unlayered, so it takes precedence
  wherever the browser encounters it. That is deliberate: Astro emits its bundled
  stylesheets after the head markup, and an ordering-based mechanism silently stopped
  working the moment it did.
-->
<link rel="stylesheet" href="/brand/theme.css" />