astro-theme-popular 0.5.0 → 0.7.0

package/src/lib/ical.ts

@@ -0,0 +1,93 @@
+/** iCalendar feed helpers, mirroring the Hugo events/list.calendar.ics
+ *  template. DTSTART reuses parseEventTime (lib/eventld) so the feed and the
+ *  Event JSON-LD agree. Folding is byte-accurate at 75 octets. */
+import { parseEventTime } from './eventld';
+
+const pad = (n: number) => String(n).padStart(2, '0');
+const enc = new TextEncoder();
+
+function ymd(d: Date): string {
+  return `${d.getUTCFullYear()}${pad(d.getUTCMonth() + 1)}${pad(d.getUTCDate())}`;
+}
+
+export function icsEscape(s: string): string {
+  return s.replace(/\\/g, '\\\\').replace(/;/g, '\;').replace(/,/g, '\\,').replace(/\n/g, '\\n');
+}
+
+/** One content line, CRLF-terminated, folded at 75 octets (continuations
+ *  begin with a space, which counts toward the limit). */
+export function fold(line: string): string {
+  if (enc.encode(line).length <= 75) return line + '\r\n';
+  let out = '';
+  let cur = '';
+  let curBytes = 0;
+  let first = true;
+  for (const ch of line) {
+    const cb = enc.encode(ch).length;
+    const limit = first ? 75 : 74;
+    if (curBytes + cb > limit) {
+      out += (first ? '' : ' ') + cur + '\r\n';
+      first = false;
+      cur = ch;
+      curBytes = cb;
+    } else {
+      cur += ch;
+      curBytes += cb;
+    }
+  }
+  out += (first ? '' : ' ') + cur + '\r\n';
+  return out;
+}
+
+export interface IcsEvent {
+  title: string;
+  date: Date;
+  time?: string;
+  description?: string;
+  checkin?: string;
+  cancelled?: boolean;
+  venue?: { name: string; address?: string };
+  permalink: string;
+}
+
+export function buildIcs(
+  events: IcsEvent[],
+  opts: { siteTitle: string; dtstamp: string; durationMinutes: number },
+): string {
+  const L: string[] = [];
+  L.push(fold('BEGIN:VCALENDAR'));
+  L.push(fold('VERSION:2.0'));
+  L.push(fold(`PRODID:-//${opts.siteTitle}//Popular theme//EN`));
+  L.push(fold('CALSCALE:GREGORIAN'));
+  L.push(fold('METHOD:PUBLISH'));
+  L.push(fold(`X-WR-CALNAME:${opts.siteTitle} events`));
+  for (const e of events) {
+    L.push(fold('BEGIN:VEVENT'));
+    L.push(fold(`UID:${e.permalink}`));
+    L.push(fold(`DTSTAMP:${opts.dtstamp}`));
+    const hm = parseEventTime(e.time);
+    if (hm) {
+      const [h, m] = hm.split(':').map(Number);
+      L.push(fold(`DTSTART:${ymd(e.date)}T${pad(h)}${pad(m)}00`));
+      const total = h * 60 + m + opts.durationMinutes;
+      const end = new Date(Date.UTC(e.date.getUTCFullYear(), e.date.getUTCMonth(), e.date.getUTCDate()) + total * 60000);
+      L.push(fold(`DTEND:${ymd(end)}T${pad(end.getUTCHours())}${pad(end.getUTCMinutes())}00`));
+    } else {
+      L.push(fold(`DTSTART;VALUE=DATE:${ymd(e.date)}`));
+    }
+    L.push(fold(`SUMMARY:${icsEscape(e.title)}`));
+    if (e.venue) {
+      const loc = e.venue.address ? `${e.venue.name}, ${e.venue.address}` : e.venue.name;
+      L.push(fold(`LOCATION:${icsEscape(loc)}`));
+    }
+    let desc = (e.description ?? '').trim();
+    if (e.checkin) desc = `${desc}\n${e.checkin}`;
+    desc = `${desc}\n${e.permalink}`;
+    L.push(fold(`DESCRIPTION:${icsEscape(desc)}`));
+    L.push(fold(`URL:${e.permalink}`));
+    L.push(fold(`STATUS:${e.cancelled ? 'CANCELLED' : 'CONFIRMED'}`));
+    L.push(fold('END:VEVENT'));
+  }
+  L.push(fold('END:VCALENDAR'));
+  return L.join('');
+}

package/src/lib/inline-md.ts

@@ -0,0 +1,21 @@
+/** Minimal inline-markdown renderer for short, author-controlled config
+ *  strings (e.g. the notice banner, §5). Parity with Hugo's inline
+ *  `.RenderString`: supports links, bold, emphasis, and inline code, and
+ *  HTML-escapes everything else. Not a full Markdown parser; block syntax
+ *  (headings, lists, images) is intentionally out of scope. */
+const escapeHtml = (s: string): string =>
+  s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+
+export function inlineMarkdown(src: string): string {
+  let s = escapeHtml(src);
+  // [label](http(s)://… | /path) — only http(s) and root-relative targets
+  s = s.replace(
+    /\[([^\]]+)\]\((https?:\/\/[^\s)]+|\/[^\s)]*)\)/g,
+    (_m, label, href) =>
+      `<a href="${href}"${href.startsWith('/') ? '' : ' rel="noopener" target="_blank"'}>${label}</a>`,
+  );
+  s = s.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
+  s = s.replace(/(^|[^*])\*([^*]+)\*/g, '$1<em>$2</em>');
+  s = s.replace(/`([^`]+)`/g, '<code>$1</code>');
+  return s;
+}

package/src/lib/jsonld.ts

@@ -0,0 +1,48 @@
+/** Shared JSON-LD helpers for Organization and BlogPosting, mirroring
+ *  partials/jsonld-org.html and jsonld-blogpost.html. Keys are recursively
+ *  sorted so the emitted markup byte-matches Hugo's jsonify. */
+function sortKeys(v: any): any {
+  if (Array.isArray(v)) return v.map(sortKeys);
+  if (v && typeof v === 'object') {
+    return Object.fromEntries(Object.keys(v).sort().map((k) => [k, sortKeys(v[k])]));
+  }
+  return v;
+}
+export function jsonld(obj: Record<string, any>): string {
+  return JSON.stringify(sortKeys(obj));
+}
+
+export function buildOrgLd(i: {
+  name: string; url: string; logo?: string; description?: string; sameAs?: string[];
+}): Record<string, any> {
+  const ld: Record<string, any> = {
+    '@context': 'https://schema.org', '@type': 'Organization', name: i.name, url: i.url,
+  };
+  if (i.logo) ld.logo = i.logo;
+  if (i.description) ld.description = i.description;
+  if (i.sameAs && i.sameAs.length) ld.sameAs = i.sameAs;
+  return ld;
+}
+
+export function buildBlogPostingLd(i: {
+  title: string; datePublished: string; dateModified: string;
+  authors: string[]; image?: string; url: string; description?: string;
+  siteTitle: string; siteUrl: string;
+}): Record<string, any> {
+  const publisher = { '@type': 'Organization', name: i.siteTitle, url: i.siteUrl };
+  const author = i.authors.length
+    ? i.authors.map((name) => ({ '@type': 'Person', name }))
+    : [publisher];
+  const headline = i.title.length > 110 ? i.title.slice(0, 109) + '…' : i.title;
+  const ld: Record<string, any> = {
+    '@context': 'https://schema.org', '@type': 'BlogPosting', headline,
+    datePublished: i.datePublished, dateModified: i.dateModified, author,
+    url: i.url, publisher,
+  };
+  if (i.image) ld.image = i.image;
+  if (i.description) {
+    const d = i.description.trim();
+    ld.description = d.length > 300 ? d.slice(0, 299) + '…' : d;
+  }
+  return ld;
+}

package/src/lib/talks.ts

@@ -0,0 +1,87 @@
+/** §3 talk archive helpers, shared by the event page, the event row, and the
+ *  /talks/ index. A "talk" is either an entry in an event's talks[] array or,
+ *  for single-talk meetups, the event itself when it carries event-level
+ *  recording/slides. When talks[] is present it wins; event-level
+ *  recording/slides are ignored (not merged), matching the Hugo side. */
+import type { CollectionEntry } from 'astro:content';
+
+type EventData = CollectionEntry<'events'>['data'];
+
+export interface Talk {
+  title: string;
+  speakerSlug?: string; // resolved speaker-profile slug, for linking
+  speakerName?: string; // display name (profile title, or the free-text speaker)
+  recording?: string;
+  slides?: string;
+}
+
+export interface TalkRow extends Talk {
+  eventId: string;
+  eventTitle: string;
+  date: Date;
+  tags: string[];
+}
+
+/** True if an event has any recording (event-level or in a talk), for the
+ *  browsing cue on past-event rows. */
+export function eventHasRecording(d: EventData): boolean {
+  const talks = (d as { talks?: { recording?: string }[] }).talks;
+  if (talks?.length) return talks.some((t) => !!t.recording);
+  return !!(d as { recording?: string }).recording;
+}
+
+/** The talks for one event, normalized. speakers is the resolved collection so
+ *  a talk's speaker slug (or the event's first speaker, in the simple case)
+ *  becomes a linkable name; an unresolved slug warns and renders name-less. */
+export function eventTalks(
+  d: EventData,
+  speakers: CollectionEntry<'speakers'>[],
+  eventId: string,
+): Talk[] {
+  const nameOf = (slug?: string): string | undefined => {
+    if (!slug) return undefined;
+    const found = speakers.find((s) => s.id === slug);
+    if (!found) console.warn(`events/${eventId}: talk speaker "${slug}" matches no speaker page`);
+    return found?.data.title;
+  };
+  const anyD = d as EventData & {
+    talks?: Talk[]; recording?: string; slides?: string;
+  };
+  if (anyD.talks?.length) {
+    return anyD.talks.map((t) => ({
+      title: t.title,
+      speakerSlug: nameOf(t.speaker) ? t.speaker : undefined,
+      speakerName: nameOf(t.speaker),
+      recording: t.recording,
+      slides: t.slides,
+    }));
+  }
+  if (anyD.recording || anyD.slides) {
+    const slug = d.speakers[0];
+    const name = nameOf(slug) ?? d.speaker;
+    return [{
+      title: d.title,
+      speakerSlug: nameOf(slug) ? slug : undefined,
+      speakerName: name,
+      recording: anyD.recording,
+      slides: anyD.slides,
+    }];
+  }
+  return [];
+}
+
+/** Every talk across the given events, newest event first, for the /talks/
+ *  index. Each row carries its parent event's link, date, and tags (the tags
+ *  drive the shared blog-filter.js tag filter). */
+export function collectTalks(
+  events: CollectionEntry<'events'>[],
+  speakers: CollectionEntry<'speakers'>[],
+): TalkRow[] {
+  const rows: TalkRow[] = [];
+  for (const e of [...events].sort((a, b) => +b.data.date - +a.data.date)) {
+    for (const t of eventTalks(e.data, speakers, e.id)) {
+      rows.push({ ...t, eventId: e.id, eventTitle: e.data.title, date: e.data.date, tags: e.data.tags });
+    }
+  }
+  return rows;
+}

package/src/pages/[...slug].astro

@@ -5,7 +5,7 @@ import { STRINGS } from 'popular:config';
 import { render } from 'astro:content';
 import { safeCollection } from '../lib/collections';
 import BaseLayout from '../layouts/BaseLayout.astro';
-import PageHero from '../components/PageHero.astro';
+import PageHero from 'popular:component/PageHero';
 
 export async function getStaticPaths() {
   const pages = await safeCollection('pages');

package/src/pages/authors/[slug].astro

@@ -3,9 +3,9 @@ import { STRINGS } from 'popular:config';
 import { render } from 'astro:content';
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import PageHero from '../../components/PageHero.astro';
-import AuthorBox from '../../components/AuthorBox.astro';
-import PostCard from '../../components/PostCard.astro';
+import PageHero from 'popular:component/PageHero';
+import AuthorBox from 'popular:component/AuthorBox';
+import PostCard from 'popular:component/PostCard';
 
 export async function getStaticPaths() {
   const authors = await safeCollection('authors');
@@ -20,7 +20,7 @@ const posts = (await safeCollection('blog'))
 ---
 
 <BaseLayout title={entry.data.title} description={entry.data.bio}>
-  <PageHero eyebrow={STRINGS.eyebrowAuthor} title={entry.data.title} lead={entry.data.bio} />
+  <PageHero eyebrow={STRINGS.eyebrowAuthor} title={entry.data.title} />
   <section class="g-bg-white g-section">
     <div class="g-container">
       <div class="g-article" style="margin-bottom:var(--space-5)">

package/src/pages/blog/[...page].astro

@@ -1,8 +1,8 @@
 ---
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import PageHero from '../../components/PageHero.astro';
-import PostCard from '../../components/PostCard.astro';
+import PageHero from 'popular:component/PageHero';
+import PostCard from 'popular:component/PostCard';
 import Pagination from '../../components/Pagination.astro';
 import { SECTIONS, STRINGS, PAGINATION } from 'popular:config';
 

package/src/pages/blog/[slug].astro

@@ -2,8 +2,9 @@
 import { render } from 'astro:content';
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import AuthorBox from '../../components/AuthorBox.astro';
+import AuthorBox from 'popular:component/AuthorBox';
 import { SUPPORT, SITE, STRINGS, SECTIONS_MAP } from 'popular:config';
+import { buildBlogPostingLd, jsonld } from '../../lib/jsonld';
 import { tagSlug } from '../../lib/slugs';
 
 export async function getStaticPaths() {
@@ -32,12 +33,25 @@ const bylineNames = [
   ...d.guestAuthors.map((g) => g.name),
 ];
 if (!bylineNames.length && d.author) bylineNames.push(d.author);
+const siteUrl = new URL('/', Astro.site ?? Astro.url).href;
+const postLd = jsonld(buildBlogPostingLd({
+  title: d.title,
+  datePublished: d.date.toISOString().replace(/\.\d{3}Z$/, 'Z'),
+  dateModified: d.date.toISOString().replace(/\.\d{3}Z$/, 'Z'),
+  authors: bylineNames,
+  image: d.image ? new URL(d.image, Astro.site ?? Astro.url).href : undefined,
+  url: new URL(`/blog/${post.id}/`, Astro.site ?? Astro.url).href,
+  description: d.description,
+  siteTitle: SITE.title,
+  siteUrl,
+}));
 const byline = bylineNames.length > 1
   ? bylineNames.slice(0, -1).join(STRINGS.listSeparator) + STRINGS.listSeparatorFinal + bylineNames[bylineNames.length - 1]
   : bylineNames.join('');
 ---
 
 <BaseLayout title={d.title} description={d.description} image={d.image} article={{ published: d.date, authors: bylineNames, tags: d.tags }}>
+  <script type="application/ld+json" slot="head" set:html={postLd} />
   <article>
     <header class="g-pagehero">
       <div class="g-container" style="padding-block:var(--space-6) var(--space-5)">

package/src/pages/events/[...page].astro

@@ -1,9 +1,10 @@
 ---
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import PageHero from '../../components/PageHero.astro';
-import EventRow from '../../components/EventRow.astro';
+import PageHero from 'popular:component/PageHero';
+import EventRow from 'popular:component/EventRow';
 import Pagination from '../../components/Pagination.astro';
+import EventsEmpty from '../../components/EventsEmpty.astro';
 import { SECTIONS, STRINGS, PAGINATION } from 'popular:config';
 
 /* One route serves /events/ and /events/page/N/, matching the Hugo theme's
@@ -52,6 +53,7 @@ const groupByYear = (events: EventEntry[]) => {
         <span class="g-eyebrow">{STRINGS.comingUp}</span>
         <h2>{STRINGS.upcomingEvents}</h2>
         <p class="g-lead">{STRINGS.upcomingLead}</p>
+        <div class="g-row" style="margin-top:var(--space-3)"><a class="g-btn g-btn--outline g-btn--sm" href="/events/calendar.ics"><i class="fa-solid fa-calendar-plus" aria-hidden="true"></i> {STRINGS.subscribeCalendar}</a></div>
       </div>
       <div class="g-stack" style="margin-top:var(--space-4);gap:var(--space-3)">
         {groupByYear(upcoming).map((group) => (
@@ -60,9 +62,7 @@ const groupByYear = (events: EventEntry[]) => {
             {group.events.map((e) => <EventRow event={e} />)}
           </>
         ))}
-        {upcoming.length === 0 && (
-          <p class="g-lead">{STRINGS.noUpcomingEvents}</p>
-        )}
+        {upcoming.length === 0 && <EventsEmpty />}
       </div>
     </div>
   </section>

package/src/pages/events/[slug].astro

@@ -1,9 +1,11 @@
 ---
 import { SITE, STRINGS } from 'popular:config';
+import { buildEventLd, jsonld } from '../../lib/eventld';
 import { render } from 'astro:content';
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import AuthorBox from '../../components/AuthorBox.astro';
+import AuthorBox from 'popular:component/AuthorBox';
+import { eventTalks } from '../../lib/talks';
 
 export async function getStaticPaths() {
   const events = (await safeCollection('events')).filter((e) => !e.data.draft);
@@ -28,9 +30,38 @@ const speakerEntries = d.speakers.map((slug) => {
   if (!entry) throw new Error(`events/${event.id}: speaker "${slug}" matches no speaker page`);
   return entry;
 });
+
+/* §3 talks: multi-talk events render a Talks section; single-talk events
+   render recording/slides links inline in the meta block. */
+const talks = eventTalks(d, allSpeakers, event.id);
+const hasTalksArray = !!(d.talks && d.talks.length > 0);
+
+/* schema.org/Event JSON-LD (see lib/eventld; contract in PARITY.md). */
+const siteUrl = new URL('/', Astro.site ?? Astro.url).href;
+const permalink = new URL(`/events/${event.id}/`, Astro.site ?? Astro.url).href;
+const eventLd = jsonld(buildEventLd({
+  title: d.title,
+  date: d.date,
+  time: d.time,
+  description: d.description,
+  cancelled: (d as any).cancelled,
+  online: (d as any).online,
+  price: (d as any).price,
+  currency: (d as any).currency,
+  cost: (d as any).cost,
+  image: d.image ? new URL(d.image, Astro.site ?? Astro.url).href : undefined,
+  rsvp: d.rsvp,
+  permalink,
+  siteUrl,
+  siteTitle: SITE.title,
+  defaultCurrency: (SITE as Record<string, any>).seo?.currency ?? 'USD',
+  venue: venuePage ? { name: venuePage.data.title, address: venuePage.data.address } : undefined,
+  performers: speakerEntries.map((s) => s.data.title),
+}));
 ---
 
 <BaseLayout title={d.title} description={d.description} image={d.image}>
+  <script type="application/ld+json" slot="head" set:html={eventLd} />
   <article>
     <header class="g-pagehero">
       <div class="g-container" style="padding-block:var(--space-6) var(--space-5)">
@@ -40,7 +71,7 @@ const speakerEntries = d.speakers.map((slug) => {
           </a>
         </div>
         <span class="g-eyebrow">{dateStr}{d.time && ` · ${d.time}`}</span>
-        <h1 style="margin:.5rem 0 0">{d.title}</h1>
+        <h1 style="margin:.5rem 0 0">{d.title}{d.cancelled && <> <span class="g-badge g-badge--danger" style="vertical-align:middle;font-size:var(--text-sm)">{STRINGS.eventCancelled}</span></>}</h1>
       </div>
     </header>
     <div class="g-container g-section--sm">
@@ -49,7 +80,11 @@ const speakerEntries = d.speakers.map((slug) => {
         <span><i class="fa-solid fa-location-dot" aria-hidden="true"></i> {venuePage
           ? <><a href={`/venues/${venuePage.id}/`}>{venuePage.data.title}</a>{venuePage.data.address && ` · ${venuePage.data.address}`}</>
           : <>{d.venue ?? STRINGS.venueTba}{d.address && ` · ${d.address}`}</>}</span>
+        {venuePage?.data.wheelchair && <span><span class="g-badge g-badge--success g-badge--soft"><i class="fa-solid fa-wheelchair" aria-hidden="true"></i> {STRINGS.wheelchairAccessible}</span></span>}
+        {venuePage && (venuePage.data.transit || venuePage.data.parking || venuePage.data.access) && <span><a href={`/venues/${venuePage.id}/`}>{STRINGS.gettingThere}</a></span>}
         {d.speaker && <span><i class="fa-solid fa-microphone-lines" aria-hidden="true"></i> {d.speaker}</span>}
+        {!hasTalksArray && d.recording && <span><a href={d.recording} rel="noopener" target="_blank"><i class="fa-solid fa-circle-play" aria-hidden="true"></i> {STRINGS.watchRecording}</a></span>}
+        {!hasTalksArray && d.slides && <span><a href={d.slides} rel="noopener" target="_blank"><i class="fa-solid fa-file-lines" aria-hidden="true"></i> {STRINGS.viewSlides}</a></span>}
       </div>
 
       {(d.checkin || venueNotes) && (
@@ -71,6 +106,28 @@ const speakerEntries = d.speakers.map((slug) => {
         </>
       )}
 
+      {hasTalksArray && (
+        <>
+          <h2 style="font-size:var(--text-xl);margin:var(--space-5) 0 1rem">{STRINGS.talks}</h2>
+          <div class="g-stack" style="gap:var(--space-3)">
+            {talks.map((t) => (
+              <div class="g-talk">
+                <div class="g-talk__title">{t.title}</div>
+                {t.speakerName && (
+                  <div class="g-talk__by"><i class="fa-solid fa-microphone-lines" aria-hidden="true"></i> {t.speakerSlug ? <a href={`/speakers/${t.speakerSlug}/`}>{t.speakerName}</a> : t.speakerName}</div>
+                )}
+                {(t.recording || t.slides) && (
+                  <div class="g-row" style="gap:var(--space-2)">
+                    {t.recording && <a class="g-btn g-btn--sm g-btn--outline" href={t.recording} rel="noopener" target="_blank"><i class="fa-solid fa-circle-play" aria-hidden="true"></i> {STRINGS.watchRecording}</a>}
+                    {t.slides && <a class="g-btn g-btn--sm g-btn--ghost" href={t.slides} rel="noopener" target="_blank"><i class="fa-solid fa-file-lines" aria-hidden="true"></i> {STRINGS.viewSlides}</a>}
+                  </div>
+                )}
+              </div>
+            ))}
+          </div>
+        </>
+      )}
+
       {d.rsvp && (
         <div class="g-row" style="margin-top:var(--space-4)">
           <a class="g-btn g-btn--primary g-btn--lg" href={d.rsvp}><i class="fa-solid fa-calendar" aria-hidden="true"></i> {STRINGS.rsvpExternal}</a>

package/src/pages/events/calendar.ics.ts

@@ -0,0 +1,34 @@
+import type { APIRoute } from 'astro';
+import { getCollection } from 'astro:content';
+import { buildIcs } from '../../lib/ical';
+import { SITE } from 'popular:config';
+
+/* iCalendar feed: upcoming events plus the last 90 days. Mirrors the Hugo
+   events/list.calendar.ics template. */
+export const GET: APIRoute = async ({ site }) => {
+  const base = site ?? new URL('https://example.com');
+  const cutoff = Date.now() - 90 * 24 * 60 * 60 * 1000;
+  const events = (await getCollection('events'))
+    .filter((e) => !e.data.draft && +e.data.date >= cutoff)
+    .sort((a, b) => +a.data.date - +b.data.date);
+  const venues = await getCollection('venues');
+  const duration = (SITE as Record<string, any>).events?.defaultDurationMinutes ?? 120;
+  const dtstamp = new Date().toISOString().replace(/[-:]/g, '').replace(/\.\d{3}/, '');
+  const body = buildIcs(
+    events.map((e) => {
+      const v = e.data.venueRef ? venues.find((x) => x.id === e.data.venueRef) : undefined;
+      return {
+        title: e.data.title,
+        date: e.data.date,
+        time: e.data.time,
+        description: (e.data.description ?? '').trim(),
+        checkin: e.data.checkin,
+        cancelled: e.data.cancelled,
+        venue: v ? { name: v.data.title, address: v.data.address } : (e.data.venue ? { name: e.data.venue } : undefined),
+        permalink: new URL(`/events/${e.id}/`, base).href,
+      };
+    }),
+    { siteTitle: SITE.title, dtstamp, durationMinutes: duration },
+  );
+  return new Response(body, { headers: { 'Content-Type': 'text/calendar; charset=utf-8' } });
+};

package/src/pages/index.astro

@@ -2,9 +2,11 @@
 import { safeCollection } from '../lib/collections';
 import { formatStat, countSectionsIn } from '../lib/stats';
 import BaseLayout from '../layouts/BaseLayout.astro';
-import PostCard from '../components/PostCard.astro';
-import OrganizerCard from '../components/OrganizerCard.astro';
-import { HOME, SITE, STRINGS, SECTIONS_MAP } from 'popular:config';
+import PostCard from 'popular:component/PostCard';
+import OrganizerCard from 'popular:component/OrganizerCard';
+import EventsEmpty from '../components/EventsEmpty.astro';
+import { HOME, SITE, STRINGS, SECTIONS_MAP, SOCIAL } from 'popular:config';
+import { buildOrgLd, jsonld } from '../lib/jsonld';
 
 const now = new Date();
 const events = (await safeCollection('events')).filter((e) => !e.data.draft);
@@ -25,9 +27,18 @@ const nextVenue = next?.data.venueRef ? (await safeCollection('venues')).find((v
 const organizers = (await safeCollection(SECTIONS_MAP.team)).sort((a, b) => a.data.weight - b.data.weight);
 
 const h = HOME;
+const chat = (SITE as Record<string, any>).community?.chat;
+const orgLd = jsonld(buildOrgLd({
+  name: SITE.title,
+  url: new URL('/', Astro.site ?? Astro.url).href,
+  logo: SITE.logo ? new URL(SITE.logo, Astro.site ?? Astro.url).href : undefined,
+  description: SITE.description,
+  sameAs: SOCIAL.map((s) => s.url),
+}));
 ---
 
 <BaseLayout>
+  <script type="application/ld+json" slot="head" set:html={orgLd} />
   {h.hero && (
     <section class="g-hero">
       <div class="g-container g-hero__grid">
@@ -35,13 +46,18 @@ const h = HOME;
           {h.hero.eyebrow && <span class="g-eyebrow">{h.hero.eyebrow}</span>}
           <h1>{h.hero.title}</h1>
           {h.hero.lead && <p class="g-hero__lead">{h.hero.lead}</p>}
-          {h.hero.ctas && (
+          {(h.hero.ctas || chat) && (
             <div class="g-row">
-              {h.hero.ctas.map((c) => (
+              {(h.hero.ctas ?? []).map((c) => (
                 <a class={`g-btn g-btn--lg g-btn--${c.variant ?? 'primary'}`} href={c.url}>
                   {'icon' in c && c.icon && <i class={c.icon} aria-hidden="true"></i>}{c.label}
                 </a>
               ))}
+              {chat && (
+                <a class="g-btn g-btn--lg g-btn--secondary" href={chat.url} {...(chat.url.startsWith('/') ? {} : { rel: 'noopener', target: '_blank' })}>
+                  <i class="fa-solid fa-comments" aria-hidden="true"></i> {chat.label ?? STRINGS.joinChat}
+                </a>
+              )}
             </div>
           )}
         </div>
@@ -106,6 +122,12 @@ const h = HOME;
     </section>
   )}
 
+  {events.length > 0 && !next && (
+    <section class="g-bg-wash-soft g-section">
+      <div class="g-container"><EventsEmpty /></div>
+    </section>
+  )}
+
   {posts.length > 0 && (
     <section class="g-bg-white g-section">
       <div class="g-container">

package/src/pages/llms.txt.ts

@@ -0,0 +1,46 @@
+import type { APIRoute } from 'astro';
+import { getCollection } from 'astro:content';
+import { SITE } from 'popular:config';
+
+/* §8 llms.txt: a build-time plain-text summary for AI agents. Names the next
+   upcoming event (regenerated every build so it stays true), how to join, and
+   links to the key pages and the calendar feed. Mirrors Hugo's
+   layouts/index.llms.txt. Always generated (SEO/discovery plumbing, like
+   robots.txt). */
+export const GET: APIRoute = async ({ site }) => {
+  const base = site ?? new URL('https://example.com');
+  const abs = (p: string) => new URL(p, base).href;
+  const now = Date.now();
+
+  const events = (await getCollection('events'))
+    .filter((e) => !e.data.draft)
+    .sort((a, b) => +a.data.date - +b.data.date);
+  const next = events.find((e) => +e.data.date >= now);
+
+  const pageIds = new Set((await getCollection('pages')).map((p) => p.id));
+  const chat = (SITE as Record<string, any>).community?.chat as { url: string; label?: string } | undefined;
+  const talksOn = (SITE as Record<string, any>).talks === true;
+  const fmt = (d: Date) =>
+    d.toLocaleDateString(SITE.locale, { weekday: 'long', month: 'long', day: 'numeric', year: 'numeric' });
+
+  const lines: string[] = [`# ${SITE.title}`, ''];
+  if (SITE.description) lines.push(SITE.description, '');
+  lines.push(
+    next
+      ? `Next event: ${next.data.title} on ${fmt(next.data.date)}${next.data.time ? `, ${next.data.time}` : ''} (${abs(`/events/${next.id}/`)})`
+      : 'No upcoming events are scheduled right now.',
+    '',
+  );
+  if (chat) lines.push(`Join the community chat: ${chat.url}`, '');
+  lines.push('## Links');
+  if (pageIds.has('start')) lines.push(`Start here (newcomers): ${abs('/start/')}`);
+  if (pageIds.has('about')) lines.push(`About and FAQ: ${abs('/about/')}`);
+  lines.push(`Events: ${abs('/events/')}`);
+  lines.push(`Calendar feed (iCalendar): ${abs('/events/calendar.ics')}`);
+  if (talksOn) lines.push(`Talk archive: ${abs('/talks/')}`);
+  lines.push('', 'Built with the Popular theme.');
+
+  return new Response(lines.join('\n') + '\n', {
+    headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+  });
+};

package/src/pages/organizers/[...page].astro

@@ -1,8 +1,8 @@
 ---
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import PageHero from '../../components/PageHero.astro';
-import OrganizerCard from '../../components/OrganizerCard.astro';
+import PageHero from 'popular:component/PageHero';
+import OrganizerCard from 'popular:component/OrganizerCard';
 import Pagination from '../../components/Pagination.astro';
 import { SECTIONS, PAGINATION } from 'popular:config';
 

package/src/pages/organizers/[slug].astro

@@ -1,10 +1,10 @@
 ---
-import { STRINGS } from 'popular:config';
+import { STRINGS, SECTIONS_MAP } from 'popular:config';
 import { render } from 'astro:content';
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import PageHero from '../../components/PageHero.astro';
-import AuthorBox from '../../components/AuthorBox.astro';
+import PageHero from 'popular:component/PageHero';
+import AuthorBox from 'popular:component/AuthorBox';
 
 export async function getStaticPaths() {
   const organizers = await safeCollection('organizers');
@@ -17,7 +17,7 @@ const { Content } = await render(entry);
 ---
 
 <BaseLayout title={d.title} description={d.description}>
-  <PageHero eyebrow={d.role ?? STRINGS.eyebrowOrganizer} title={d.title} lead={d.description} />
+  <PageHero eyebrow={d.role ?? STRINGS.eyebrowOrganizer} backHref={`/${SECTIONS_MAP.team}/`} backLabel={STRINGS.allOrganizers} title={d.title} />
   <section class="g-bg-white g-section">
     <div class="g-container">
       <div class="g-article">