@cratis/cast 0.1.0 → 0.2.1

package/site/components/Skills.astro

@@ -2,10 +2,11 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { skills } from '../data';
+import type { CastView } from '../profile/CastView';
 import SectionHeader from './SectionHeader.astro';
 
 interface Props {
+  cast: CastView;
   index: string;
   title?: string;
   label?: string;
@@ -13,13 +14,15 @@ interface Props {
   compact?: boolean;
 }
 const { index, title = 'The *toolbox.*', label = 'Read model', compact = false } = Astro.props;
+const { cast } = Astro.props;
+const { skills } = cast;
 const groups = Object.entries(skills);
 const accents = ['bg-event', 'bg-command', 'bg-view', 'bg-accent'];
 ---
 
 <section id="skills" class:list={['relative pb-24 md:pb-36', compact ? '' : 'pt-24 md:pt-32']} aria-labelledby="skills-title">
   <div class="container-x">
-    <SectionHeader index={index} kind="view" label={label} title={title} id="skills-title" />
+    <SectionHeader host={cast.host} index={index} kind="view" label={label} title={title} id="skills-title" />
     <div class="grid grid-cols-1 gap-px overflow-hidden rounded-[1.25rem] border border-line bg-line sm:grid-cols-2 lg:grid-cols-3">
       {
         groups.map(([group, list], i) => (

package/site/components/Stats.astro

@@ -2,8 +2,13 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { stats as siteStats, cratis } from '../data';
-import { github, cratisRepos, mergedPrFloor, snapshotDate } from '../lib/github';
+import type { CastView } from '../profile/CastView';
+
+interface Props {
+  cast: CastView;
+}
+const { cast } = Astro.props;
+const { stats: siteStats, cratis, github, cratisRepos, mergedPrFloor, mergedPrStatus } = cast;
 
 type Stat = (typeof siteStats)[number];
 const rankOne = cratisRepos.filter((r) => r.rank === 1).length;
@@ -32,9 +37,9 @@ const accents = ['text-event', 'text-command', 'text-view', 'text-fg'];
               style={`--reveal-delay:${i * 80}ms`}
             >
               <dt class="order-2 max-w-[18ch] text-sm leading-snug text-fg-muted">{s.label}
-                {s.live === 'mergedPullRequests' && <span data-pr-status class="mt-1 block font-mono text-[0.6875rem] text-fg-faint">as of {snapshotDate()}</span>}
+                {s.live === 'mergedPullRequests' && <span data-pr-status class="mt-1 block font-mono text-[0.6875rem] text-fg-faint">{mergedPrStatus}</span>}
               </dt>
-              <dd class={`order-1 font-display text-[clamp(2.5rem,5vw,4rem)] leading-none font-[650] tracking-[-0.04em] tabular-nums ${accents[i % accents.length]}`}>
+              <dd class={`order-1 font-display whitespace-nowrap text-[clamp(2.5rem,5vw,4rem)] leading-none font-[650] tracking-[-0.04em] tabular-nums ${accents[i % accents.length]}`}>
                 {s.prefix}<span data-merged-prs={s.live === 'mergedPullRequests' ? 'number' : undefined} data-count={plain ? undefined : s.value}>{plain ? s.value : fmt.format(s.value)}</span>
                 {s.suffix && <span class="text-fg-faint">{s.suffix}</span>}
               </dd>

package/site/components/Talks.astro

@@ -2,17 +2,20 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { talks, community } from '../data';
+import type { CastView } from '../profile/CastView';
+import Inline from './Inline.astro';
 import { formatMonth } from '../lib/career';
-import { renderInline } from '../lib/inline';
 import SectionHeader from './SectionHeader.astro';
 
 interface Props {
+  cast: CastView;
   index: string;
   title?: string;
   label?: string;
 }
 const { index, title = 'Talks & *community.*', label = 'TalkGiven' } = Astro.props;
+const { cast } = Astro.props;
+const { talks, community } = cast;
 const talksNewest = [...talks].sort((a, b) => b.date.localeCompare(a.date));
 const day = (d: string) =>
   d.length === 10 ? new Date(`${d}T00:00:00Z`).toLocaleDateString('en-US', { day: 'numeric', month: 'short', year: 'numeric', timeZone: 'UTC' }) : formatMonth(d);
@@ -28,7 +31,7 @@ const languageName = (lang: string) => {
 <section id="talks" class="relative py-24 md:py-32" aria-labelledby="talks-title">
   <div class="container-x grid grid-cols-1 items-start gap-x-12 lg:grid-cols-12">
     <div class="lg:sticky lg:top-[calc(var(--nav-h)+2rem)] lg:col-span-5 [&>header]:mb-10 lg:[&>header]:mb-0">
-      <SectionHeader index={index} label={label} title={title} id="talks-title" />
+      <SectionHeader host={cast.host} index={index} label={label} title={title} id="talks-title" />
     </div>
     <div class="grid gap-4 lg:col-span-7">
       {talksNewest.length > 0 && <ul class="grid grid-cols-1 gap-4">
@@ -37,13 +40,13 @@ const languageName = (lang: string) => {
             const Tag = t.url ? 'a' : 'div';
             return (
               <li data-reveal>
-                <Tag href={t.url} rel={t.url ? 'noopener' : undefined} class:list={['panel flex h-full flex-col gap-4 p-6 md:p-7', t.url && 'glow group']}>
+                <Tag href={t.url} rel={t.url ? cast.host.rel : undefined} class:list={['panel flex h-full flex-col gap-4 p-6 md:p-7', t.url && 'glow group']}>
                   <span class="flex flex-wrap items-center justify-between gap-2 font-mono text-xs text-fg-faint">
                     <span class="note">TalkGiven</span>
                     <span><time datetime={t.date}>{day(t.date)}</time>{!t.lang.startsWith('en') && <> · in {languageName(t.lang)}</>}</span>
                   </span>
                   <span lang={t.lang} class="font-display text-2xl leading-tight font-[700] tracking-[-0.025em] transition-colors group-hover:text-event-soft md:text-[1.75rem]">{t.title}</span>
-                  <span class="text-fg-muted" set:html={renderInline(t.summary)} />
+                  <span class="text-fg-muted"><Inline text={t.summary} host={cast.host} /></span>
                   <span class="mt-auto flex flex-wrap items-center gap-x-2 gap-y-1 pt-2 text-sm text-fg-muted">
                     {t.url && <svg viewBox="0 0 16 16" class="size-4 text-event" fill="currentColor" aria-hidden="true"><path d="M5 3.5v9a.5.5 0 0 0 .77.42l7-4.5a.5.5 0 0 0 0-.84l-7-4.5A.5.5 0 0 0 5 3.5Z" /></svg>}
                     {t.url ? 'Watch · ' : ''}{t.host}

package/site/components/Terminal.astro

@@ -4,12 +4,17 @@
 
 // Shell for the interactive terminal. The behavior lives in scripts/terminal.ts and is
 // only downloaded the first time the terminal opens.
-import { person, projects } from '../data';
+import type { CastView } from '../profile/CastView';
+
+interface Props {
+  cast: CastView;
+}
+const { person, projects } = Astro.props.cast;
 const firstProject = projects[0]?.name;
 const chips = ['help', 'whoami', 'now', 'git log --oneline', 'stream tail', 'ls projects', ...(firstProject ? [`cat ${firstProject}`] : []), 'contact', 'replay'];
 ---
 
-<dialog class="term" data-terminal aria-label="Terminal" aria-describedby="term-hint" transition:persist="terminal">
+<dialog class="term" data-terminal aria-label="Terminal" aria-describedby="term-hint" transition:persist={`terminal-${person.handle.toLowerCase()}`}>
   <div class="shell panel flex flex-col overflow-hidden">
     <div class="flex items-center gap-3 border-b border-line px-4 py-2.5">
       <span class="flex gap-1.5" aria-hidden="true">

package/site/components/Writing.astro

@@ -2,18 +2,20 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+import type { CastView } from '../profile/CastView';
+import Inline from './Inline.astro';
 import SectionHeader from './SectionHeader.astro';
-import { posts, themes, blogSource, blogHost, blogFetchedAt, readingMinutes } from '../lib/blog';
-import { snapshotDate } from '../lib/github';
-import { renderInline } from '../lib/inline';
 
 interface Props {
+  cast: CastView;
   index: string;
   title?: string;
   label?: string;
   intro?: string;
 }
 const { index, title = 'Appended to the *blog.*', label = 'PostPublished', intro } = Astro.props;
+const { cast } = Astro.props;
+const { snapshotDate, posts, themes, blogSource, blogHost, blogFetchedAt, readingMinutes } = cast;
 const hours = Math.round(readingMinutes / 60);
 const INITIAL = 8;
 const series = [...new Set(posts.map((p) => p.series).filter(Boolean))];
@@ -22,10 +24,10 @@ const day = (d: string) => new Date(d).toLocaleDateString('en-US', { day: 'numer
 
 <section id="writing" class="relative py-24 md:py-36" aria-labelledby="writing-title">
   <div class="container-x">
-    <SectionHeader index={index} label={label} title={title} id="writing-title">
+    <SectionHeader host={cast.host} index={index} label={label} title={title} id="writing-title">
       <p class="mt-6 max-w-[62ch] text-lg leading-relaxed text-fg-muted">
-        {posts.length} {posts.length === 1 ? 'post' : 'posts'}{blogHost && <> on <a href={blogSource} class="text-fg underline decoration-line-strong hover:decoration-fg" rel="noopener">{blogHost}</a></>}{hours > 0 && <>, about {hours} {hours === 1 ? 'hour' : 'hours'} of reading</>}{series.length > 0 && <>, including the <span class="text-fg">{series[0]}</span> series</>}.
-        {intro && <Fragment set:html={' ' + renderInline(intro)} />}
+        {posts.length} {posts.length === 1 ? 'post' : 'posts'}{blogHost && <> on <a href={blogSource} class="text-fg underline decoration-line-strong hover:decoration-fg" rel={cast.host.rel}>{blogHost}</a></>}{hours > 0 && <>, about {hours} {hours === 1 ? 'hour' : 'hours'} of reading</>}{series.length > 0 && <>, including the <span class="text-fg">{series[0]}</span> series</>}.
+        {intro && <> <Inline text={intro} host={cast.host} /></>}
       </p>
     </SectionHeader>
 
@@ -46,7 +48,7 @@ const day = (d: string) => new Date(d).toLocaleDateString('en-US', { day: 'numer
       {
         posts.map((p, i) => (
           <li class:list={['post', i >= INITIAL && 'extra']} data-themes={p.themes.join(' ')}>
-            <a href={p.url} rel="noopener" class="group grid gap-x-6 gap-y-2 px-5 py-5 transition-colors hover:bg-fg/[0.02] md:grid-cols-[7rem_1fr_auto] md:px-7">
+            <a href={p.url} rel={cast.host.rel} class="group grid gap-x-6 gap-y-2 px-5 py-5 transition-colors hover:bg-fg/[0.02] md:grid-cols-[7rem_1fr_auto] md:px-7">
               <span class="font-mono text-xs leading-6 text-fg-faint">
                 {p.part !== undefined ? <>Part <span class="text-event">{String(p.part).padStart(2, '0')}</span></> : <span class="text-event">Overview</span>}
               </span>

package/site/data.ts

@@ -1,48 +1,11 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-// The one place components read cast.yaml and build-time data from.
+// The site's routes read the build's data here. Components never import it: they take the view as a prop,
+// so the Cast directory can render them for any member.
 import { config, github, writing, tier, sections, build, photo, photoUrl } from 'virtual:cast';
+import { siteHost } from './profile/CastHost';
+import { castView, type CastView } from './profile/CastView';
 
-export { config, github, writing, tier, sections, build, photo, photoUrl };
-
-export const person = config.person;
-export const now = config.now;
-export const careerEvents = config.career.events;
-export const cratis = config.cratis;
-export const projects = config.projects;
-export const talks = config.talks;
-export const community = config.community;
-export const education = config.education;
-export const certifications = config.certifications;
-export const skills = config.skills;
-export const agentic = config.agentic;
-export const eventModel = config.eventModel;
-export const stats = config.stats;
-
-/** First word of the display name: projections are named `<FirstName>.Now`, `<FirstName>.Career`. */
-export const firstName = person.name.split(/\s+/)[0] ?? person.handle;
-
-/** Known link names and how they read. Anything else is shown with its key. */
-const linkLabels: Record<string, string> = {
-    github: 'GitHub',
-    linkedin: 'LinkedIn',
-    mastodon: 'Mastodon',
-    bluesky: 'Bluesky',
-    x: 'X',
-    twitter: 'X',
-    youtube: 'YouTube',
-    website: 'Website',
-    blog: 'Blog',
-};
-
-/** Profile links with labels, GitHub first. */
-export const profileLinks: { key: string; label: string; url: string }[] = Object.entries(person.links)
-    .map(([key, url]) => ({ key, label: linkLabels[key.toLowerCase()] ?? key, url }))
-    .sort((left, right) => Number(right.key === 'github') - Number(left.key === 'github'));
-
-/** The GitHub profile URL: from links, else from the handle. */
-export const githubUrl = person.links['github'] ?? `https://github.com/${config.github.login}`;
-
-/** The organization whose merged pull requests feed the live feed. */
-export const feedOrg = config.github.orgs[0] ?? 'Cratis';
+/** This site's profile, rendered on its own site. */
+export const cast: CastView = castView({ config, github, writing, tier, sections, build, ...(photo ? { photo } : {}), ...(photoUrl ? { photoUrl } : {}) }, siteHost);

package/site/layouts/Base.astro

@@ -9,7 +9,8 @@ import '../styles/global.css';
 import interUrl from '@fontsource-variable/inter/files/inter-latin-wght-normal.woff2?url';
 import monoUrl from '@fontsource-variable/jetbrains-mono/files/jetbrains-mono-latin-wght-normal.woff2?url';
 import { ClientRouter } from 'astro:transitions';
-import { config, person, githubUrl, profileLinks } from '../data';
+import type { CastView } from '../profile/CastView';
+import { clientCast } from '../profile/clientCast';
 import { plainText } from '../lib/inline';
 import { accentTokens } from '../lib/accent';
 import { safeJson } from '../lib/safeJson';
@@ -17,17 +18,21 @@ import CommandPalette from '../components/CommandPalette.astro';
 import Terminal from '../components/Terminal.astro';
 
 interface Props {
+  cast: CastView;
   title: string;
   description: string;
-  /** Path of the OG image. */
+  /** Path of the OG image under the profile. Defaults to og.png on a Cast site and the portrait elsewhere. */
   image?: string;
   noindex?: boolean;
   bodyClass?: string;
 }
 
-const { title, description, image = '/og.png', noindex = false, bodyClass = '' } = Astro.props;
+const { cast, title, description, image, noindex = false, bodyClass = '' } = Astro.props;
+const { config, person, githubUrl, profileLinks, host } = cast;
 const canonical = new URL(Astro.url.pathname, Astro.site);
-const ogImage = new URL(image, Astro.site);
+const ogImageUrl = image ? cast.href(image) : host.siteFiles ? cast.href('og.png') : cast.photoUrl;
+const ogImage = ogImageUrl ? new URL(ogImageUrl, Astro.site) : undefined;
+const iconUrl = host.siteFiles ? cast.href('favicon.svg') : '/favicon.svg';
 const [firstName, ...rest] = (person.fullName ?? person.name).split(/\s+/);
 const themeMode = config.theme.mode;
 const accent = accentTokens(config.theme.accent);
@@ -39,8 +44,8 @@ const jsonLd = {
   alternateName: [person.fullName, person.handle].filter(Boolean),
   jobTitle: person.title,
   ...(person.email ? { email: `mailto:${person.email}` } : {}),
-  url: Astro.site?.toString(),
-  image: new URL('/apple-touch-icon.png', Astro.site).toString(),
+  url: host.siteFiles ? Astro.site?.toString() : config.site.url,
+  ...(host.siteFiles ? { image: new URL(cast.href('apple-touch-icon.png'), Astro.site).toString() } : cast.photoUrl ? { image: cast.photoUrl } : {}),
   ...(person.location ? { address: { '@type': 'PostalAddress', addressLocality: person.location.split(',')[0]?.trim(), ...(person.country ? { addressCountry: person.country } : {}) } } : {}),
   knowsAbout: person.interests,
   sameAs: [githubUrl, ...profileLinks.filter((link) => link.key !== 'github').map((link) => link.url)],
@@ -62,11 +67,17 @@ const jsonLd = {
     <meta name="generator" content={Astro.generator} />
     <meta name="cast:handle" content={person.handle} />
 
-    <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
-    <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
-    <link rel="sitemap" href="/sitemap-index.xml" />
-    <link rel="alternate" type="application/json" href="/cast.json" title="Cast profile" />
-    <link rel="alternate" type="text/plain" href="/llms.txt" title="Profile for AI agents" />
+    <link rel="icon" href={iconUrl} type="image/svg+xml" />
+    {
+      host.siteFiles && (
+        <>
+          <link rel="apple-touch-icon" href={cast.href('apple-touch-icon.png')} />
+          <link rel="sitemap" href={cast.href('sitemap-index.xml')} />
+          <link rel="alternate" type="application/json" href={cast.href('cast.json')} title="Cast profile" />
+          <link rel="alternate" type="text/plain" href={cast.href('llms.txt')} title="Profile for AI agents" />
+        </>
+      )
+    }
 
     <link rel="preload" href={interUrl} as="font" type="font/woff2" crossorigin />
     <link rel="preload" href={monoUrl} as="font" type="font/woff2" crossorigin />
@@ -76,17 +87,17 @@ const jsonLd = {
     <meta property="og:title" content={title} />
     <meta property="og:description" content={plainText(description)} />
     <meta property="og:url" content={canonical} />
-    <meta property="og:image" content={ogImage} />
-    <meta property="og:image:width" content="1200" />
-    <meta property="og:image:height" content="630" />
-    <meta property="og:image:alt" content={`${person.name}: ${plainText(person.tagline)}`} />
+    {ogImage && <meta property="og:image" content={ogImage} />}
+    {ogImage && host.siteFiles && <meta property="og:image:width" content="1200" />}
+    {ogImage && host.siteFiles && <meta property="og:image:height" content="630" />}
+    {ogImage && <meta property="og:image:alt" content={`${person.name}: ${plainText(person.tagline)}`} />}
     {firstName && <meta property="profile:first_name" content={firstName} />}
     {rest.length > 0 && <meta property="profile:last_name" content={rest[rest.length - 1]} />}
     <meta property="profile:username" content={person.handle} />
-    <meta name="twitter:card" content="summary_large_image" />
+    <meta name="twitter:card" content={host.siteFiles ? 'summary_large_image' : 'summary'} />
     <meta name="twitter:title" content={title} />
     <meta name="twitter:description" content={plainText(description)} />
-    <meta name="twitter:image" content={ogImage} />
+    {ogImage && <meta name="twitter:image" content={ogImage} />}
 
     <script type="application/ld+json" set:html={safeJson(jsonLd)} />
     <style set:html={`:root{--color-accent:${accent.dark};--color-accent-soft:${accent.darkSoft};--color-accent-ink:${accent.ink}}html[data-theme='light']{--color-accent:${accent.light};--color-accent-soft:${accent.lightSoft}}`}></style>
@@ -135,8 +146,9 @@ const jsonLd = {
       <slot />
     </main>
     <slot name="footer" />
-    <CommandPalette />
-    <Terminal />
+    <script type="application/json" data-cast-client set:html={safeJson(clientCast(cast))} />
+    <CommandPalette cast={cast} />
+    <Terminal cast={cast} />
     <script>
       import '../scripts/ambient';
     </script>

package/site/lib/blog.ts

@@ -1,15 +1,13 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-// Typed access to the writing captured at build time.
-import type { Post as RawPost } from '../../writing/WritingSnapshot';
-import { config, writing } from '../data';
+// Typed views over the writing captured at build time.
+import type { CastConfig } from '../../config/CastConfig';
+import type { Post as RawPost, WritingSnapshot } from '../../writing/WritingSnapshot';
 
 export type ThemeId = string;
 export type Post = RawPost & { headline: string; series?: string; part?: number; themes: ThemeId[] };
-
-/** Reading themes for the filter, each a set of tags, from cast.yaml. */
-export const themes: { id: ThemeId; label: string; tags: string[] }[] = config.writing.themes;
+export type WritingTheme = { id: ThemeId; label: string; tags: string[] };
 
 /** Splits "Title · Series, Part 3" into its parts. */
 function split(title: string): Pick<Post, 'headline' | 'series' | 'part'> {
@@ -19,14 +17,42 @@ function split(title: string): Pick<Post, 'headline' | 'series' | 'part'> {
     return series ? { headline: series[1]!, series: series[2]! } : { headline: title };
 }
 
-/** Newest first; posts published together keep their series order. */
-export const posts: Post[] = writing.posts
-    .map(post => ({ ...post, ...split(post.title), themes: themes.filter(theme => post.tags.some(tag => theme.tags.includes(tag))).map(theme => theme.id) }))
-    .sort((left, right) => right.date.slice(0, 10).localeCompare(left.date.slice(0, 10)) || (left.part ?? 0) - (right.part ?? 0));
+const hostOf = (url: string): string => {
+    try {
+        return new URL(url).host;
+    } catch {
+        return '';
+    }
+};
+
+/** What the writing sections read. */
+export type WritingView = {
+    /** Reading themes for the filter, each a set of tags, from cast.yaml. */
+    themes: WritingTheme[];
+    /** Newest first; posts published together keep their series order. */
+    posts: Post[];
+    /** The first source, for "on blog.example.com" links. */
+    blogSource: string;
+    blogHost: string;
+    blogFetchedAt?: string;
+    readingMinutes: number;
+    postsFor: (theme: ThemeId | undefined) => Post[];
+};
 
-/** The first source, for "on blog.example.com" links. */
-export const blogSource: string = writing.sources[0] ?? '';
-export const blogHost: string = blogSource ? new URL(blogSource).host : '';
-export const blogFetchedAt = writing.fetchedAt;
-export const readingMinutes = posts.reduce((total, post) => total + (post.minutes ?? 0), 0);
-export const postsFor = (theme: ThemeId | undefined): Post[] => (theme ? posts.filter(post => post.themes.includes(theme)) : []);
+/** Builds the writing view for one profile. */
+export function writingView(config: CastConfig, writing: WritingSnapshot): WritingView {
+    const themes = config.writing.themes;
+    const posts: Post[] = writing.posts
+        .map(post => ({ ...post, ...split(post.title), themes: themes.filter(theme => post.tags.some(tag => theme.tags.includes(tag))).map(theme => theme.id) }))
+        .sort((left, right) => right.date.slice(0, 10).localeCompare(left.date.slice(0, 10)) || (left.part ?? 0) - (right.part ?? 0));
+    const blogSource = writing.sources[0] ?? '';
+    return {
+        themes,
+        posts,
+        blogSource,
+        blogHost: blogSource ? hostOf(blogSource) : '',
+        ...(writing.fetchedAt ? { blogFetchedAt: writing.fetchedAt } : {}),
+        readingMinutes: posts.reduce((total, post) => total + (post.minutes ?? 0), 0),
+        postsFor: theme => (theme ? posts.filter(post => post.themes.includes(theme)) : []),
+    };
+}

package/site/lib/github.ts

@@ -1,23 +1,16 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-// Typed access to the GitHub data captured at build time.
+// Typed views over the GitHub data captured at build time.
 import type { z } from 'zod';
+import type { CastConfig } from '../../config/CastConfig';
 import type { cratisRepositorySchema, projectSchema } from '../../config/castSchema';
-import { config, cratis, github, projects } from '../data';
+import type { GitHubSnapshot } from '../../github/GitHubSnapshot';
 
 export type { PullRequest, ContributionWeek as Week } from '../../github/GitHubSnapshot';
 export type CratisRepo = z.output<typeof cratisRepositorySchema> & { role: string };
 export type Project = z.output<typeof projectSchema>;
 
-export { github };
-
-/** Merged pull requests across the configured organizations, falling back to a stat written in cast.yaml. */
-export const mergedPrTotal: number = github.mergedPullRequests.total || (config.stats.find(stat => stat.live === 'mergedPullRequests')?.value ?? 0);
-
-/** Floors to hundreds for an honest "3,100+" style figure. */
-export const mergedPrFloor: number = mergedPrTotal >= 100 ? Math.floor(mergedPrTotal / 100) * 100 : mergedPrTotal;
-
 const roleFor = (repo: z.output<typeof cratisRepositorySchema>, rank: number): string =>
     repo.founded
         ? (rank === 1 ? 'Founder & lead' : 'Founder')
@@ -27,29 +20,61 @@ const roleFor = (repo: z.output<typeof cratisRepositorySchema>, rank: number): s
                 ? (repo.group === 'client' ? '#2 contributor' : '#2 all-time')
                 : 'Contributor';
 
-/** Per-repository figures prefer the snapshot; values written in cast.yaml are fallbacks only. */
-export const cratisRepos: CratisRepo[] = (cratis?.repos ?? []).map(repo => {
-    const counts = repo.url ? github.repositories[`Cratis/${repo.name}`] : undefined;
-    if (!counts) return { ...repo, role: repo.role ?? roleFor(repo, repo.rank) };
-    return { ...repo, ...counts, role: roleFor(repo, counts.rank) };
-});
-
 /** owner/name of a github.com URL. */
 export const repositoryOf = (url: string): string | undefined => url.match(/^https:\/\/github\.com\/([^/]+\/[^/#?]+)/i)?.[1];
 
-/** Projects with versions taken from the latest GitHub release when one was captured. */
-export const liveProjects: Project[] = projects.map(project => {
-    const repository = repositoryOf(project.url);
-    const release = repository ? Object.entries(github.releases).find(([name]) => name.toLowerCase() === repository.toLowerCase())?.[1] : undefined;
-    return release ? { ...project, version: release.tag } : project;
-});
-
-/** Stars for an owner/name, if tracked. */
-export const starsFor = (repository: string): number | undefined =>
-    Object.entries(github.stars).find(([name]) => name.toLowerCase() === repository.toLowerCase())?.[1];
-
-export const snapshotDate = (date = github.fetchedAt): string =>
+/** Formats a capture date as "Oct 16, 2026", or "the last build" when unknown. */
+export const formatSnapshotDate = (date: string | undefined): string =>
     date ? new Date(date).toLocaleDateString('en-US', { day: 'numeric', month: 'short', year: 'numeric', timeZone: 'UTC' }) : 'the last build';
 
-/** Repository names in the live feed, most recent first, without duplicates. */
-export const liveRepos: string[] = [...new Set(github.mergedPullRequests.latest.map(pullRequest => pullRequest.repository.split('/')[1] ?? pullRequest.repository))];
+/** What the sections read from the GitHub snapshot, with cast.yaml values as fallbacks. */
+export type GitHubView = {
+    github: GitHubSnapshot;
+    /** Merged pull requests across the configured organizations, falling back to a stat written in cast.yaml. */
+    mergedPrTotal: number;
+    /** Where {@link mergedPrTotal} comes from: 'as of' the capture date, or 'self-reported' for the cast.yaml fallback. */
+    mergedPrStatus: string;
+    /** True when {@link mergedPrTotal} is the cast.yaml fallback: never captured, so never shown as a snapshot or as live. */
+    mergedPrSelfReported: boolean;
+    /** Floors to hundreds for an honest "3,100+" style figure. */
+    mergedPrFloor: number;
+    /** Per-repository figures prefer the snapshot; values written in cast.yaml are fallbacks only. */
+    cratisRepos: CratisRepo[];
+    /** Projects with versions taken from the latest GitHub release when one was captured. */
+    liveProjects: Project[];
+    /** Stars for an owner/name, if tracked. */
+    starsFor: (repository: string) => number | undefined;
+    /** The capture date of a snapshot, by default this one. */
+    snapshotDate: (date?: string) => string;
+    /** Repository names in the live feed, most recent first, without duplicates. */
+    liveRepos: string[];
+};
+
+/** Builds the GitHub view for one profile. */
+export function gitHubView(config: CastConfig, github: GitHubSnapshot): GitHubView {
+    const captured = github.mergedPullRequests.total;
+    // The cast.yaml figure was never captured: it carries no capture date, so it is labelled as the owner's own.
+    const mergedPrTotal = captured || (config.stats.find(stat => stat.live === 'mergedPullRequests')?.value ?? 0);
+    const cratisRepos = (config.cratis?.repos ?? []).map(repo => {
+        const counts = repo.url ? github.repositories[`Cratis/${repo.name}`] : undefined;
+        if (!counts) return { ...repo, role: repo.role ?? roleFor(repo, repo.rank) };
+        return { ...repo, ...counts, role: roleFor(repo, counts.rank) };
+    });
+    const liveProjects = config.projects.map(project => {
+        const repository = repositoryOf(project.url);
+        const release = repository ? Object.entries(github.releases).find(([name]) => name.toLowerCase() === repository.toLowerCase())?.[1] : undefined;
+        return release ? { ...project, version: release.tag } : project;
+    });
+    return {
+        github,
+        mergedPrTotal,
+        mergedPrStatus: captured ? `as of ${formatSnapshotDate(github.fetchedAt)}` : 'self-reported',
+        mergedPrSelfReported: !captured && mergedPrTotal > 0,
+        mergedPrFloor: mergedPrTotal >= 100 ? Math.floor(mergedPrTotal / 100) * 100 : mergedPrTotal,
+        cratisRepos,
+        liveProjects,
+        starsFor: repository => Object.entries(github.stars).find(([name]) => name.toLowerCase() === repository.toLowerCase())?.[1],
+        snapshotDate: (date = github.fetchedAt) => formatSnapshotDate(date),
+        liveRepos: [...new Set(github.mergedPullRequests.latest.map(pullRequest => pullRequest.repository.split('/')[1] ?? pullRequest.repository))],
+    };
+}

package/site/lib/inline.ts

@@ -1,21 +1,77 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+/** One piece of inline text: plain text, or markup with its own pieces inside. */
+export type InlineToken =
+    | { kind: 'text'; text: string }
+    | { kind: 'code'; text: string }
+    | { kind: 'em' | 'strong'; children: InlineToken[] }
+    | { kind: 'link'; href: string; children: InlineToken[] };
+
+type Pattern = { kind: 'code' | 'link' | 'strong' | 'em'; expression: RegExp };
+
+/** In order of precedence when two start at the same position. */
+const patterns: Pattern[] = [
+    { kind: 'code', expression: /`([^`]+)`/g },
+    { kind: 'link', expression: /\[([^\]]+)\]\(([^)\s]+)\)/g },
+    { kind: 'strong', expression: /\*\*([^*]+)\*\*/g },
+    { kind: 'em', expression: /\*([^*]+)\*/g },
+];
+
+/** Link targets inline text may use: http(s), mailto, a path or an anchor. Anything else stays plain text. */
+const allowedHref = /^(https?:\/\/[^\s]+|mailto:[^\s]+|\/[^\s]*|#[^\s]*)$/i;
+
+/**
+ * Parses the inline markup cast.yaml text may use into tokens: `*emphasis*` (the italic serif accent),
+ * `**strong**`, `` `code` `` and `[links](https://…)`. Tokens are rendered as elements with escaped text,
+ * never as HTML, so markup in member text cannot inject anything. Links to other schemes stay plain text.
+ */
+export function parseInline(text: string): InlineToken[] {
+    const tokens: InlineToken[] = [];
+    let position = 0;
+    while (position < text.length) {
+        let best: { pattern: Pattern; match: RegExpExecArray } | undefined;
+        for (const pattern of patterns) {
+            pattern.expression.lastIndex = position;
+            const match = pattern.expression.exec(text);
+            if (match && (!best || match.index < best.match.index)) best = { pattern, match };
+        }
+        if (!best) break;
+        const { pattern, match } = best;
+        if (match.index > position) tokens.push({ kind: 'text', text: text.slice(position, match.index) });
+        const inner = match[1]!;
+        if (pattern.kind === 'code') tokens.push({ kind: 'code', text: inner });
+        else if (pattern.kind === 'link') {
+            const href = match[2]!;
+            if (allowedHref.test(href)) tokens.push({ kind: 'link', href, children: parseInline(inner) });
+            else tokens.push({ kind: 'text', text: match[0] });
+        } else tokens.push({ kind: pattern.kind, children: parseInline(inner) });
+        position = match.index + match[0].length;
+    }
+    if (position < text.length) tokens.push({ kind: 'text', text: text.slice(position) });
+    return tokens;
+}
+
 const escapeHtml = (value: string): string =>
     value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
 
+const linkClass = 'text-fg underline decoration-line-strong hover:decoration-fg';
+
 /**
- * Renders the inline markup cast.yaml text may use, escaping everything else:
- * `*emphasis*` (the italic serif accent), `**strong**`, `` `code` `` and `[links](https://…)`.
+ * Renders inline markup to an HTML string with everything escaped, for outputs that are not Astro components.
+ * Components render `Inline.astro`, which builds elements from the same tokens.
  */
 export function renderInline(text: string, emphasisClass = 'serif'): string {
-    let html = escapeHtml(text);
-    html = html.replace(/`([^`]+)`/g, '<code class="inline-code">$1</code>');
-    html = html.replace(/\[([^\]]+)\]\((https?:\/\/[^)\s]+|\/[^)\s]*|#[^)\s]*|mailto:[^)\s]+)\)/g, (_, label: string, href: string) =>
-        `<a href="${href}" class="text-fg underline decoration-line-strong hover:decoration-fg"${href.startsWith('http') ? ' rel="noopener"' : ''}>${label}</a>`);
-    html = html.replace(/\*\*([^*]+)\*\*/g, '<strong class="text-fg font-semibold">$1</strong>');
-    html = html.replace(/\*([^*]+)\*/g, `<em class="${emphasisClass}">$1</em>`);
-    return html;
+    const render = (tokens: InlineToken[]): string => tokens.map(token => {
+        switch (token.kind) {
+            case 'text': return escapeHtml(token.text);
+            case 'code': return `<code class="inline-code">${escapeHtml(token.text)}</code>`;
+            case 'strong': return `<strong class="text-fg font-semibold">${render(token.children)}</strong>`;
+            case 'em': return `<em class="${escapeHtml(emphasisClass)}">${render(token.children)}</em>`;
+            case 'link': return `<a href="${escapeHtml(token.href)}" class="${linkClass}"${/^https?:/i.test(token.href) ? ' rel="noopener"' : ''}>${render(token.children)}</a>`;
+        }
+    }).join('');
+    return render(parseInline(text));
 }
 
 /** Removes inline markup, for meta tags, JSON and plain-text outputs. */