@cratis/cast 0.0.1 → 0.1.0

package/site/styles/global.css

@@ -0,0 +1,508 @@
+/* Copyright (c) Cratis. All rights reserved.
+   Licensed under the MIT license. See LICENSE file in the project root for full license information. */
+
+/* Cratis Cast design system: the cratis.no ground and type, the Event Modeling sticky-note colors,
+   and one person accent (--color-accent) that defaults to Cratis violet. */
+@import 'tailwindcss';
+
+/* The engine ships its components as source; let Tailwind see them. */
+@source "../../";
+
+/* ---------------------------------------------------------------------------
+   Size-adjusted local fallbacks so swapping in the web fonts does not shift
+   layout. Values are tuned against Arial / Courier New metrics.
+--------------------------------------------------------------------------- */
+@font-face {
+  font-family: 'Inter Fallback';
+  src: local('Arial'), local('Helvetica Neue'), local('Helvetica');
+  size-adjust: 107.12%;
+  ascent-override: 90.44%;
+  descent-override: 22.52%;
+  line-gap-override: 0%;
+}
+@font-face {
+  font-family: 'Fraunces Fallback';
+  src: local('Georgia'), local('Times New Roman');
+  size-adjust: 104%;
+  ascent-override: 92%;
+  descent-override: 24%;
+  line-gap-override: 0%;
+}
+@font-face {
+  font-family: 'Mono Fallback';
+  src: local('Courier New'), local('Menlo');
+  size-adjust: 100%;
+  ascent-override: 102%;
+  descent-override: 30%;
+  line-gap-override: 0%;
+}
+
+@theme {
+  --font-sans: 'Inter Variable', 'Inter Fallback', ui-sans-serif, system-ui, sans-serif;
+  --font-display: 'Inter Variable', 'Inter Fallback', ui-sans-serif, system-ui, sans-serif;
+  --font-serif: 'Fraunces Variable', 'Fraunces Fallback', Georgia, serif;
+  --font-mono: 'JetBrains Mono Variable', 'Mono Fallback', ui-monospace, SFMono-Regular, Menlo, monospace;
+
+  /* The person's accent. Overridden per site from cast.yaml (theme.accent); defaults to Cratis violet. */
+  --color-accent: #8b5cf6;
+  --color-accent-soft: #c9baff;
+  --color-accent-ink: #ffffff;
+
+  /* Cratis brand pair, for the Cast mark and Core gradients. */
+  --color-violet: #8b5cf6;
+  --color-teal: #2dd4bf;
+
+  /* Event Modeling sticky-note language: command blue, event amber, read model teal. */
+  --color-event: #f2994a;
+  --color-event-soft: #f8bd85;
+  --color-command: #5b86f2;
+  --color-command-soft: #a3bbf8;
+  --color-view: #2dd4bf;
+  --color-view-soft: #8eeadc;
+
+  /* cratis.no ground */
+  --color-ink-950: #08080e;
+  --color-ink-900: #0c0c15;
+  --color-ink-850: #10101a;
+  --color-ink-800: #14141f;
+  --color-ink-700: #1d1d2b;
+  --color-fg: #f5f3f0;
+  --color-fg-muted: #a09fad;
+  --color-fg-faint: #7c7b8b;
+  --color-line: color-mix(in srgb, var(--color-fg) 8%, transparent);
+  --color-line-strong: color-mix(in srgb, var(--color-fg) 15%, transparent);
+
+  --ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);
+  --ease-spring: cubic-bezier(0.34, 1.56, 0.64, 1);
+
+  --animate-pop-in: pop-in 520ms var(--ease-spring) both;
+  --animate-pulse-dot: pulse-dot 2.4s ease-in-out infinite;
+
+  @keyframes pop-in {
+    0% { opacity: 0; transform: translateY(6px) scale(0.85); }
+    100% { opacity: 1; transform: none; }
+  }
+  @keyframes pulse-dot {
+    0%, 100% { box-shadow: 0 0 0 0 rgb(45 212 191 / 0.55); }
+    50% { box-shadow: 0 0 0 6px rgb(45 212 191 / 0); }
+  }
+}
+
+/* Light theme, designed rather than inverted (as on cratis.no): warm off-white ground, white panels,
+   accents darkened so text stays AA on paper. */
+html[data-theme='light'] {
+  color-scheme: light;
+  --color-event: #a8500c;
+  --color-event-soft: #8a4009;
+  --color-command: #2150cf;
+  --color-command-soft: #1b43ad;
+  --color-view: #0f766e;
+  --color-view-soft: #0b5e57;
+  --color-violet: #6d28d9;
+  --color-teal: #0f766e;
+  --color-ink-950: #faf9f6;
+  --color-ink-900: #ffffff;
+  --color-ink-850: #f5f2fc;
+  --color-ink-800: #efecf6;
+  --color-ink-700: #e2deec;
+  --color-fg: #17141f;
+  --color-fg-muted: #4e4a5c;
+  --color-fg-faint: #69657a;
+  --color-line: rgb(23 20 40 / 0.1);
+  --color-line-strong: rgb(23 20 40 / 0.2);
+}
+
+@layer base {
+  :root {
+    color-scheme: dark;
+    --nav-h: 4rem;
+  }
+  html {
+    background: var(--color-ink-950);
+    color: var(--color-fg);
+    font-family: var(--font-sans);
+    font-feature-settings: 'cv11', 'ss01', 'ss03';
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+    text-rendering: optimizeLegibility;
+    scroll-padding-top: var(--nav-h);
+  }
+  @media (prefers-reduced-motion: no-preference) {
+    html:not([data-motion='reduced']) {
+      scroll-behavior: smooth;
+    }
+  }
+  body {
+    min-height: 100dvh;
+    overflow-x: clip;
+  }
+  ::selection {
+    background: color-mix(in srgb, var(--color-accent) 40%, transparent);
+    color: var(--color-fg);
+  }
+  :focus-visible {
+    outline: 2px solid var(--color-command);
+    outline-offset: 3px;
+    border-radius: 6px;
+  }
+  h1, h2, h3, .font-display {
+    font-family: var(--font-display);
+    font-optical-sizing: auto;
+    text-wrap: balance;
+  }
+  code.inline-code {
+    font-family: var(--font-mono);
+    font-size: 0.85em;
+    padding: 0.08em 0.35em;
+    border-radius: 0.35em;
+    border: 1px solid var(--color-line);
+    background: color-mix(in srgb, var(--color-fg) 4%, transparent);
+  }
+  p {
+    text-wrap: pretty;
+  }
+  a {
+    text-underline-offset: 0.2em;
+  }
+}
+
+@layer components {
+  /* Film grain over everything; purely decorative. */
+  .grain::after {
+    content: '';
+    position: fixed;
+    inset: 0;
+    z-index: 60;
+    pointer-events: none;
+    opacity: 0.05;
+    background-image: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='160' height='160'><filter id='n'><feTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='3' stitchTiles='stitch'/><feColorMatrix values='0 0 0 0 1  0 0 0 0 1  0 0 0 0 1  0 0 0 0.9 0'/></filter><rect width='100%' height='100%' filter='url(%23n)'/></svg>");
+  }
+
+  /* The italic serif, the Cratis signature move: accent words in Fraunces, softly glowing. */
+  .serif {
+    font-family: var(--font-serif);
+    font-style: italic;
+    font-weight: 560;
+    letter-spacing: -0.01em;
+    color: var(--color-accent-soft);
+    text-shadow: 0 0 44px color-mix(in srgb, var(--color-accent) 45%, transparent);
+  }
+
+  .container-x {
+    width: 100%;
+    max-width: 76rem;
+    margin-inline: auto;
+    padding-inline: clamp(1.25rem, 4vw, 2.5rem);
+  }
+
+  .eyebrow {
+    font-family: var(--font-mono);
+    font-size: 0.75rem;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    color: var(--color-fg-muted);
+  }
+
+  .panel {
+    position: relative;
+    border-radius: 1.25rem;
+    border: 1px solid var(--color-line);
+    background:
+      linear-gradient(180deg, color-mix(in srgb, var(--color-fg) 3.5%, transparent), color-mix(in srgb, var(--color-fg) 1.2%, transparent)),
+      color-mix(in srgb, var(--color-ink-900) 72%, transparent);
+    box-shadow:
+      inset 0 1px 0 color-mix(in srgb, var(--color-fg) 5%, transparent),
+      0 30px 60px -30px rgb(0 0 0 / 0.6);
+    backdrop-filter: blur(14px) saturate(1.2);
+    -webkit-backdrop-filter: blur(14px) saturate(1.2);
+  }
+
+  /* Pointer-following glow border. JS sets --mx/--my on pointermove. */
+  .glow {
+    --mx: 50%;
+    --my: 50%;
+    --glow: var(--color-accent);
+  }
+  .glow::before {
+    content: '';
+    position: absolute;
+    inset: -1px;
+    border-radius: inherit;
+    padding: 1px;
+    background: radial-gradient(
+      420px circle at var(--mx) var(--my),
+      color-mix(in oklab, var(--glow) 85%, transparent),
+      transparent 45%
+    );
+    -webkit-mask: linear-gradient(#000 0 0) content-box, linear-gradient(#000 0 0);
+    -webkit-mask-composite: xor;
+    mask: linear-gradient(#000 0 0) content-box exclude, linear-gradient(#000 0 0);
+    opacity: 0;
+    transition: opacity 300ms ease;
+    pointer-events: none;
+  }
+  .glow::after {
+    content: '';
+    position: absolute;
+    inset: 0;
+    border-radius: inherit;
+    background: radial-gradient(
+      600px circle at var(--mx) var(--my),
+      color-mix(in oklab, var(--glow) 7%, transparent),
+      transparent 40%
+    );
+    opacity: 0;
+    transition: opacity 300ms ease;
+    pointer-events: none;
+  }
+  .glow:hover::before,
+  .glow:hover::after,
+  .glow:focus-within::before {
+    opacity: 1;
+  }
+
+  .tag {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.375rem;
+    border-radius: 999px;
+    border: 1px solid var(--color-line);
+    background: color-mix(in srgb, var(--color-fg) 2.5%, transparent);
+    padding: 0.25rem 0.65rem;
+    font-size: 0.8125rem;
+    line-height: 1.25rem;
+    color: var(--color-fg-muted);
+    white-space: nowrap;
+  }
+
+  .btn {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: 0.5rem;
+    height: 2.75rem;
+    padding-inline: 1.15rem;
+    border-radius: 0.8rem;
+    font-weight: 550;
+    font-size: 0.9375rem;
+    border: 1px solid var(--color-line-strong);
+    background: color-mix(in srgb, var(--color-fg) 4%, transparent);
+    color: var(--color-fg);
+    transition:
+      transform 180ms var(--ease-out-expo),
+      background-color 180ms ease,
+      border-color 180ms ease,
+      box-shadow 180ms ease;
+    white-space: nowrap;
+    cursor: pointer;
+  }
+  .btn:hover {
+    background: color-mix(in srgb, var(--color-fg) 8%, transparent);
+    border-color: color-mix(in srgb, var(--color-fg) 22%, transparent);
+  }
+  .btn:active {
+    transform: translateY(1px) scale(0.98);
+  }
+  .btn-primary {
+    background: var(--color-accent);
+    border-color: transparent;
+    color: var(--color-accent-ink);
+    box-shadow:
+      inset 0 1px 0 rgb(255 255 255 / 0.28),
+      0 10px 30px -10px color-mix(in srgb, var(--color-accent) 70%, transparent);
+  }
+  .btn-primary:hover {
+    background: color-mix(in srgb, var(--color-accent) 86%, #fff);
+    border-color: transparent;
+  }
+  .btn-sm {
+    height: 2.25rem;
+    padding-inline: 0.8rem;
+    border-radius: 0.65rem;
+    font-size: 0.8125rem;
+  }
+
+  .kbd {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-width: 1.4rem;
+    height: 1.4rem;
+    padding-inline: 0.3rem;
+    border-radius: 0.375rem;
+    border: 1px solid var(--color-line-strong);
+    border-bottom-width: 2px;
+    font-family: var(--font-mono);
+    font-size: 0.6875rem;
+    color: var(--color-fg-muted);
+    background: color-mix(in srgb, var(--color-fg) 3%, transparent);
+  }
+
+  /* Event Modeling sticky-note chips */
+  .note {
+    --note: var(--color-event);
+    display: inline-flex;
+    align-items: center;
+    gap: 0.4rem;
+    font-family: var(--font-mono);
+    font-size: 0.75rem;
+    font-weight: 500;
+    color: var(--note);
+  }
+  .note::before {
+    content: '';
+    width: 0.55rem;
+    height: 0.55rem;
+    border-radius: 2px;
+    background: var(--note);
+    box-shadow: 0 0 12px color-mix(in oklab, var(--note) 60%, transparent);
+  }
+  .note-command { --note: var(--color-command); }
+  .note-view { --note: var(--color-view); }
+
+  /* Filter chips (projects, writing). */
+  .filter {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.5rem;
+    height: 2.25rem;
+    padding-inline: 0.95rem;
+    border-radius: 999px;
+    border: 1px solid var(--color-line);
+    color: var(--color-fg-muted);
+    font-size: 0.875rem;
+    transition: all 200ms ease;
+    cursor: pointer;
+  }
+  .filter:hover {
+    color: var(--color-fg);
+    border-color: var(--color-line-strong);
+  }
+  .filter[aria-pressed='true'] {
+    color: var(--color-ink-950);
+    background: var(--color-fg);
+    border-color: var(--color-fg);
+  }
+  .section-title {
+    font-size: clamp(2.25rem, 5vw, 3.75rem);
+    line-height: 1.02;
+    letter-spacing: -0.035em;
+    font-weight: 800;
+  }
+
+  .link-quiet {
+    color: var(--color-fg-muted);
+    transition: color 150ms ease;
+  }
+  .link-quiet:hover {
+    color: var(--color-fg);
+  }
+
+  .sr-only-focusable:not(:focus) {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+  }
+
+  /* Reveal-on-scroll. Only hidden once JS has confirmed it will reveal. */
+  .js-motion [data-reveal] {
+    opacity: 0;
+    transform: translateY(18px);
+    transition:
+      opacity 900ms var(--ease-out-expo),
+      transform 900ms var(--ease-out-expo);
+    transition-delay: var(--reveal-delay, 0ms);
+  }
+  .js-motion [data-reveal].is-visible {
+    opacity: 1;
+    transform: none;
+  }
+  /* Section headings are scroll-driven where the browser supports it; elsewhere the
+     IntersectionObserver reveal above applies. */
+  @supports (animation-timeline: view()) {
+    .js-motion header[data-reveal] {
+      opacity: 1;
+      transform: none;
+      transition: none;
+    }
+    .js-motion header[data-reveal] > * {
+      animation: heading-in linear both;
+      animation-timeline: view();
+      animation-range: entry 5% cover 28%;
+    }
+    .js-motion header[data-reveal] > h2 {
+      animation-range: entry 10% cover 32%;
+    }
+  }
+  @keyframes heading-in {
+    from {
+      opacity: 0;
+      transform: translateY(28px);
+      filter: blur(6px);
+    }
+  }
+}
+
+/* Light-theme details that tokens alone do not cover. */
+html[data-theme='light'] .grain::after {
+  filter: invert(1);
+  opacity: 0.035;
+}
+html[data-theme='light'] .btn-primary,
+html[data-theme='light'] .btn-primary:hover {
+  color: #fff;
+  background: var(--color-accent);
+  box-shadow: inset 0 1px 0 rgb(255 255 255 / 0.25), 0 10px 30px -12px color-mix(in srgb, var(--color-accent) 55%, transparent);
+}
+html[data-theme='light'] .serif {
+  color: var(--color-accent);
+  text-shadow: none;
+}
+html[data-theme='light'] .panel {
+  box-shadow: inset 0 1px 0 rgb(255 255 255 / 0.7), 0 24px 50px -32px rgb(20 22 30 / 0.25);
+}
+html[data-theme='light'] ::backdrop {
+  background: rgb(20 22 30 / 0.28);
+}
+
+/* Smooth cross-fade when the theme flips (not on first paint). */
+html.theme-flip,
+html.theme-flip * {
+  transition:
+    background-color 400ms ease,
+    color 400ms ease,
+    border-color 400ms ease !important;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after {
+    animation-duration: 1ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 1ms !important;
+  }
+}
+html[data-motion='reduced'] *,
+html[data-motion='reduced'] *::before,
+html[data-motion='reduced'] *::after {
+  animation-duration: 1ms !important;
+  animation-iteration-count: 1 !important;
+  transition-duration: 1ms !important;
+}
+
+@media print {
+  :root {
+    color-scheme: light;
+  }
+  html,
+  body {
+    background: #fff !important;
+    color: #111 !important;
+    font-size: 8.8pt;
+  }
+  .grain::after {
+    display: none !important;
+  }
+}

package/virtual.d.ts

@@ -0,0 +1,15 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+declare module 'virtual:cast' {
+    type CastData = import('./integration/CastData').CastData;
+
+    export const config: CastData['config'];
+    export const sections: CastData['sections'];
+    export const github: CastData['github'];
+    export const writing: CastData['writing'];
+    export const tier: CastData['tier'];
+    export const photoUrl: CastData['photoUrl'];
+    export const build: CastData['build'];
+    export const photo: import('astro').ImageMetadata | undefined;
+}

package/writing/WritingSnapshot.ts

@@ -0,0 +1,20 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/** A post as captured from a feed or an author page. */
+export type Post = {
+    title: string;
+    url: string;
+    date: string;
+    minutes?: number;
+    description: string;
+    tags: string[];
+};
+
+/** Everything Cast captured from the configured writing sources. */
+export type WritingSnapshot = {
+    fetchedAt?: string;
+    /** Where the posts came from, for "on blog.example.com" links. */
+    sources: string[];
+    posts: Post[];
+};

package/writing/fetchWriting.ts

@@ -0,0 +1,54 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { z } from 'zod';
+import type { writingSourceSchema } from '../config/castSchema';
+import { mergePosts, parseFeed, parseStarlightAuthorPage } from './parse';
+import type { Post, WritingSnapshot } from './WritingSnapshot';
+
+type WritingSource = z.output<typeof writingSourceSchema>;
+const maximumPages = 10;
+
+async function text(url: URL): Promise<string | undefined> {
+    const response = await fetch(url, { headers: { 'user-agent': 'cratis-cast-build' }, signal: AbortSignal.timeout(20_000) });
+    if (response.status === 404) return undefined;
+    if (!response.ok) throw new Error(`${url} answered ${response.status}`);
+    return response.text();
+}
+
+async function starlightAuthor(authorPage: string): Promise<Post[]> {
+    const base = new URL(authorPage.endsWith('/') ? authorPage : `${authorPage}/`);
+    const posts: Post[] = [];
+    for (let page = 1; page <= maximumPages; page++) {
+        const html = await text(page === 1 ? base : new URL(`${page}/`, base));
+        if (!html) break;
+        const found = parseStarlightAuthorPage(html, base.origin);
+        if (found.length === 0) break;
+        posts.push(...found);
+        if (!html.includes(`${base.pathname}${page + 1}/`)) break;
+    }
+    return posts;
+}
+
+/** Captures posts from every source. Returns undefined when no source produced posts. Never throws. */
+export async function fetchWriting(sources: readonly WritingSource[], warn: (message: string) => void): Promise<WritingSnapshot | undefined> {
+    const posts: Post[] = [];
+    const origins: string[] = [];
+    for (const source of sources) {
+        try {
+            if ('rss' in source) {
+                const xml = await text(new URL(source.rss));
+                const found = xml ? parseFeed(xml, source.author) : [];
+                posts.push(...found);
+                origins.push(new URL(source.rss).origin);
+            } else {
+                posts.push(...await starlightAuthor(source.starlightBlogAuthor));
+                origins.push(source.starlightBlogAuthor);
+            }
+        } catch (error) {
+            warn(`writing source ${'rss' in source ? source.rss : source.starlightBlogAuthor}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (posts.length === 0) return undefined;
+    return { fetchedAt: new Date().toISOString(), sources: origins, posts: mergePosts(posts) };
+}

package/writing/parse.ts

@@ -0,0 +1,72 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { Post } from './WritingSnapshot';
+
+/** Strips tags, decodes the common entities and collapses whitespace. */
+export const decodeHtml = (value: string): string =>
+    value
+        .replace(/<!\[CDATA\[([\s\S]*?)\]\]>/g, '$1')
+        .replace(/<[^>]+>/g, '')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;|&#x27;|&apos;/g, '\'')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/\s+/g, ' ')
+        .trim();
+
+/** Parses the post previews on a Starlight Blog author page. Only links on `origin` are kept. */
+export function parseStarlightAuthorPage(html: string, origin: string): Post[] {
+    const posts: Post[] = [];
+    for (const block of html.split('<article class="sl-blog-preview').slice(1)) {
+        const href = block.match(/class="sl-blog-preview-link[^"]*" href="([^"]+)"/)?.[1];
+        const title = block.match(/<h2 class="sl-blog-preview-title[^"]*">([\s\S]*?)<\/h2>/)?.[1];
+        const date = block.match(/<time[^>]*datetime="([^"]+)"/)?.[1];
+        if (!href || !title || !date) continue;
+        const url = new URL(href, origin);
+        if (url.protocol !== 'https:' || url.origin !== origin) continue;
+        const minutes = Number(block.match(/(\d+) min read/)?.[1]) || undefined;
+        const excerpt = block.match(/sl-blog-preview-excerpt[^>]*>([\s\S]*?)<\/div>/)?.[1] ?? '';
+        const tags = [...block.matchAll(/class="sl-blog-tag[^"]*" href="[^"]*">([^<]+)<\/a>/g)].map(match => decodeHtml(match[1]!));
+        posts.push({ title: decodeHtml(title), url: url.toString(), date, minutes, description: decodeHtml(excerpt), tags });
+    }
+    return posts;
+}
+
+const tagValue = (block: string, name: string): string | undefined =>
+    block.match(new RegExp(`<${name}(?:\\s[^>]*)?>([\\s\\S]*?)</${name}>`, 'i'))?.[1];
+
+/** Parses RSS 2.0 items and Atom entries. With `author`, keeps only entries naming that author. */
+export function parseFeed(xml: string, author?: string): Post[] {
+    const blocks = [...xml.matchAll(/<(item|entry)[\s>][\s\S]*?<\/\1>/gi)].map(match => match[0]);
+    const posts: Post[] = [];
+    for (const block of blocks) {
+        const title = tagValue(block, 'title');
+        const link = block.match(/<link[^>]*href="([^"]+)"/i)?.[1] ?? tagValue(block, 'link');
+        const date = tagValue(block, 'pubDate') ?? tagValue(block, 'published') ?? tagValue(block, 'updated') ?? tagValue(block, 'dc:date');
+        if (!title || !link || !date) continue;
+        const authors = [tagValue(block, 'author'), tagValue(block, 'dc:creator'), tagValue(block, 'name')].filter(Boolean).map(value => decodeHtml(value!));
+        if (author && !authors.some(name => name.toLowerCase().includes(author.toLowerCase()))) continue;
+        let url: URL;
+        try {
+            url = new URL(decodeHtml(link));
+        } catch {
+            continue;
+        }
+        if (url.protocol !== 'https:' && url.protocol !== 'http:') continue;
+        const parsedDate = new Date(decodeHtml(date));
+        if (Number.isNaN(parsedDate.getTime())) continue;
+        const description = decodeHtml(tagValue(block, 'description') ?? tagValue(block, 'summary') ?? '').slice(0, 400);
+        const tags = [...block.matchAll(/<category(?:[^>]*term="([^"]+)"[^>]*\/?>|[^>]*>([\s\S]*?)<\/category>)/gi)]
+            .map(match => decodeHtml(match[1] ?? match[2] ?? '').toLowerCase().replace(/\s+/g, '-'))
+            .filter(Boolean);
+        posts.push({ title: decodeHtml(title), url: url.toString(), date: parsedDate.toISOString(), description, tags });
+    }
+    return posts;
+}
+
+/** Newest first, one entry per URL. */
+export const mergePosts = (posts: readonly Post[]): Post[] =>
+    [...new Map(posts.map(post => [post.url, post])).values()].sort((left, right) => right.date.localeCompare(left.date));