feat: remap PageSpeed audit links to ciphera.net/learn articles

lib/learn-links.ts

@@ -0,0 +1,30 @@
+/**
+ * Maps Google/Deque documentation URLs to ciphera.net/learn articles.
+ * Keys are normalized URLs (no protocol, no trailing slash, no query/hash).
+ * Add entries as new /learn articles are published on ciphera.net.
+ */
+const LEARN_URL_MAP: Record<string, string> = {
+  // Performance Metrics
+  'developer.chrome.com/docs/lighthouse/performance/first-contentful-paint': 'https://ciphera.net/learn/first-contentful-paint',
+  'developer.chrome.com/docs/lighthouse/performance/lighthouse-largest-contentful-paint': 'https://ciphera.net/learn/largest-contentful-paint',
+  'developer.chrome.com/docs/lighthouse/performance/lighthouse-total-blocking-time': 'https://ciphera.net/learn/total-blocking-time',
+  'web.dev/articles/cls': 'https://ciphera.net/learn/cumulative-layout-shift',
+  'developer.chrome.com/docs/lighthouse/performance/speed-index': 'https://ciphera.net/learn/speed-index',
+  'web.dev/articles/inp': 'https://ciphera.net/learn/interaction-to-next-paint',
+  'developer.chrome.com/docs/lighthouse/performance/interactive': 'https://ciphera.net/learn/time-to-interactive',
+  'developer.chrome.com/docs/lighthouse/performance/lighthouse-max-potential-fid': 'https://ciphera.net/learn/max-potential-first-input-delay',
+}
+
+function normalizeUrl(url: string): string {
+  try {
+    const u = new URL(url)
+    return (u.host + u.pathname).replace(/\/+$/, '')
+  } catch {
+    return url
+  }
+}
+
+export function remapLearnUrl(url: string): string {
+  const normalized = normalizeUrl(url)
+  return LEARN_URL_MAP[normalized] || url
+}