ferst-core 0.7.2 → 0.7.5

package/content/cookies.ts

@@ -110,3 +110,13 @@ export function scanCookieUses(input: CookieScanInput): CookiePolicyModel {
   ).map(({ blocks, calendar, ...use }) => use); // drop detection fields from the view model
   return { necessary: NECESSARY.map((u) => ({ ...u })), additional };
 }
+
+/** Every block `type` used in a list of blocks, walking container children
+ *  (`section` / `grid` / `stack`), so the policy sees an embed nested in a grid. */
+export function blockTypesIn(blocks: ReadonlyArray<{ type: string; blocks?: unknown }>, acc = new Set<string>()): Set<string> {
+  for (const b of blocks) {
+    acc.add(b.type);
+    if (Array.isArray(b.blocks)) blockTypesIn(b.blocks as Array<{ type: string; blocks?: unknown }>, acc);
+  }
+  return acc;
+}

package/content/schemas.ts

@@ -1,161 +1,167 @@
-// Pure Zod schemas for the site-settings collections the chrome reads (identity +
-// contact, logos, navigation, footer, theme tokens). Separated from config.ts so
-// they can be unit-tested without `astro:content`. The page CONTENT model is the
-// block palette in `content/blocks.ts` — a page is an ordered list of typed
-// blocks, not a bespoke per-page-type schema.
-import { z } from 'zod';
-
-const navLinkSchema = z.object({
-  label: z.string(),
-  href: z.string(),
-});
-
-/** One item inside a nav dropdown / mega panel (client-configured, generic). */
-const navGroupItemSchema = z.object({
-  title: z.string(),
-  desc: z.string().optional(),
-  href: z.string(),
-});
-
-/** An optional dropdown group in the primary nav (e.g. an "About" mega-menu
- *  or a "Services" menu). Entirely client-configured — the core ships none. */
-const navGroupSchema = z.object({
-  label: z.string(),
-  href: z.string(),
-  items: z.array(navGroupItemSchema).default([]),
-});
-
-const siteIdentitySchema = z
-  .object({
-    /** Used in <title> as " — {siteTitle}" and the description fallback. */
-    siteTitle: z.string().default('Your Site'),
-    /** Short brand label — used in alt text and the footer. */
-    shortName: z.string().default('Your Site'),
-    /** Default <meta name="description"> when a page doesn't supply its own. */
-    description: z.string().default('A website built with Ferst.'),
-    /** Town / city — appended to the brand in alt text. */
-    location: z.string().default(''),
-  })
-  .default({});
-
-const siteContactSchema = z
-  .object({
-    /** Human-readable phone number. Blank by default — client provides. */
-    phoneDisplay: z.string().default(''),
-    /** Digits-only form used in a `tel:` href. */
-    phoneTel: z.string().default(''),
-    email: z.string().default(''),
-    facebookUrl: z.string().default(''),
-  })
-  .default({});
-
-/** Site identity + contact details. Logos, navigation, footer and theme tokens
- *  each have their own collection (below) so each is a focused CMS pane. */
-export const siteSettingsSchema = z.object({
-  identity: siteIdentitySchema,
-  contact: siteContactSchema,
-});
-
-export const logoSettingsSchema = z.object({
-  /** Primary/header logo — light theme variant. Optional (SiteHeader falls back to a wordmark). */
-  primaryLogoLight: z.string().optional(),
-  /** Primary/header logo — dark theme variant. Optional. */
-  primaryLogoDark: z.string().optional(),
-  /** Secondary/footer logo — light theme variant (optional). */
-  secondaryLogoLight: z.string().optional(),
-  /** Secondary/footer logo — dark theme variant (optional). */
-  secondaryLogoDark: z.string().optional(),
-  /** Display name + target URL for the secondary/footer logo's link (optional). */
-  secondaryLogoLink: z
-    .object({
-      name: z.string().default(''),
-      url: z.string().default(''),
-    })
-    .default({}),
-});
-
-export const navbarSettingsSchema = z.object({
-  /** Simple top-level links. Empty by default — every client defines its own nav. */
-  primary: z.array(navLinkSchema).default([]),
-  /** Optional dropdown / mega-menu group. Rendered by SiteHeader only when present. */
-  dropdown: navGroupSchema.optional(),
-});
-
-export const footerSettingsSchema = z.object({
-  /** Footer legal/info nav. Empty by default — every client defines its own. */
-  footer: z.array(navLinkSchema).default([]),
-});
-
-/**
- * The brand — a client's design tokens, set in the CMS. The whole system is
- * built to derive from just THREE source colours: `brand` (interactive accent),
- * `ink` (text) and `surface` (background). `lib/themeTokens.ts` expands those
- * into ~40 working tokens (light via `color-mix`, dark via an OKLCH translation
- * — lightness flipped, hue kept, chroma damped so nothing turns neon), and
- * `Base.astro` emits the result as a `<style>` that layers over the core's
- * NEUTRAL defaults in `styles/theme.css`. Fonts and the four surface "knobs"
- * (corners / elevation / stroke / fields) are the rest of the site-wide look —
- * each set once, applied everywhere. `advanced.light/.dark` are a raw
- * per-token escape hatch (power users / AI composition / back-compat) layered
- * LAST. The core ships none of this — a brand lives in the client's repo (or
- * the CMS), never baked into the shared core.
- *
- * This shape is what the Sveltia token pane edits (apps/showcase/public/admin):
- * a client picks three colours + a font pairing + four knobs, not 40 tokens.
- */
-export const themeSettingsSchema = z.object({
-  /** Interactive accent — buttons, links, icons, highlights. Blank ⇒ neutral. */
-  brand: z.string().default(''),
-  /** Text colour — headings & body. Blank ⇒ neutral. */
-  ink: z.string().default(''),
-  /** Background — page, cards, sections (tints derived from it). Blank ⇒ neutral. */
-  surface: z.string().default(''),
-  /** Site-wide font pairing (role → CSS font-family stack). Blank ⇒ core default. */
-  fonts: z
-    .object({
-      heading: z.string().default(''),
-      body: z.string().default(''),
-      display: z.string().default(''),
-    })
-    .default({}),
-  /** Corner radius applied to every card / tile / input / button. */
-  corners: z.enum(['sharp', 'rounded', 'soft']).default('rounded'),
-  /** Card/tile elevation — `flat` removes the soft shadow site-wide. */
-  elevation: z.enum(['raised', 'flat']).default('raised'),
-  /** Card/tile stroke — `off` removes the 1px border site-wide. */
-  stroke: z.enum(['on', 'off']).default('on'),
-  /** Input treatment — a single site-wide choice (a `data-field` attr on <html>). */
-  fields: z.enum(['boxed', 'filled', 'underline']).default('boxed'),
-  /** Dark-mode formula knobs (root-derivation model). `darkDepth` = how light the
-   *  dark page background sits (OKLCH L); `darkChroma` = the cap on how much colour
-   *  the dark ground may carry. Both feed the AUTOMATIC dark roots. */
-  darkDepth: z.number().min(0.12).max(0.4).default(0.21),
-  darkChroma: z.number().min(0).max(0.15).default(0.05),
-  /** Explicit overrides for the three dark ROOTS. Each blank ⇒ the root is derived
-   *  from its light source by the formula; set ⇒ every dark token in that role
-   *  re-derives from this colour. Roots only (ground / text / accent) — never a
-   *  lone downstream token — so the palette can never fall out of sync. */
-  darkOverrides: z
-    .object({
-      ground: z.string().default(''),
-      text: z.string().default(''),
-      accent: z.string().default(''),
-    })
-    .default({}),
-  /** Raw per-token overrides, layered last. Rarely needed. */
-  advanced: z
-    .object({
-      light: z.record(z.string()).default({}),
-      dark: z.record(z.string()).default({}),
-    })
-    .default({}),
-});
-
-export type SiteSettings = z.infer<typeof siteSettingsSchema>;
-export type LogoSettings = z.infer<typeof logoSettingsSchema>;
-export type NavbarSettings = z.infer<typeof navbarSettingsSchema>;
-export type FooterSettings = z.infer<typeof footerSettingsSchema>;
-export type ThemeSettings = z.infer<typeof themeSettingsSchema>;
-export type NavLink = z.infer<typeof navLinkSchema>;
-export type NavGroup = z.infer<typeof navGroupSchema>;
-export type NavGroupItem = z.infer<typeof navGroupItemSchema>;
+// Pure Zod schemas for the site-settings collections the chrome reads (identity +
+// contact, logos, navigation, footer, theme tokens). Separated from config.ts so
+// they can be unit-tested without `astro:content`. The page CONTENT model is the
+// block palette in `content/blocks.ts` — a page is an ordered list of typed
+// blocks, not a bespoke per-page-type schema.
+import { z } from 'zod';
+
+const navLinkSchema = z.object({
+  label: z.string(),
+  href: z.string(),
+});
+
+/** One item inside a nav dropdown / mega panel (client-configured, generic). */
+const navGroupItemSchema = z.object({
+  title: z.string(),
+  desc: z.string().optional(),
+  href: z.string(),
+});
+
+/** An optional dropdown group in the primary nav (e.g. an "About" mega-menu
+ *  or a "Services" menu). Entirely client-configured — the core ships none. */
+const navGroupSchema = z.object({
+  label: z.string(),
+  href: z.string(),
+  items: z.array(navGroupItemSchema).default([]),
+});
+
+const siteIdentitySchema = z
+  .object({
+    /** Used in <title> as " — {siteTitle}" and the description fallback. */
+    siteTitle: z.string().default('Your Site'),
+    /** Short brand label — used in alt text and the footer. */
+    shortName: z.string().default('Your Site'),
+    /** Default <meta name="description"> when a page doesn't supply its own. */
+    description: z.string().default('A website built with Ferst.'),
+    /** Town / city — appended to the brand in alt text. */
+    location: z.string().default(''),
+  })
+  .default({});
+
+const siteContactSchema = z
+  .object({
+    /** Human-readable phone number. Blank by default — client provides. */
+    phoneDisplay: z.string().default(''),
+    /** Digits-only form used in a `tel:` href. */
+    phoneTel: z.string().default(''),
+    email: z.string().default(''),
+    facebookUrl: z.string().default(''),
+  })
+  .default({});
+
+/** Site identity + contact details. Logos, navigation, footer and theme tokens
+ *  each have their own collection (below) so each is a focused CMS pane. */
+export const siteSettingsSchema = z.object({
+  identity: siteIdentitySchema,
+  contact: siteContactSchema,
+});
+
+export const logoSettingsSchema = z.object({
+  /** Primary/header logo — light theme variant. Optional (SiteHeader falls back to a wordmark). */
+  primaryLogoLight: z.string().optional(),
+  /** Primary/header logo — dark theme variant. Optional. */
+  primaryLogoDark: z.string().optional(),
+  /** Secondary/footer logo — light theme variant (optional). */
+  secondaryLogoLight: z.string().optional(),
+  /** Secondary/footer logo — dark theme variant (optional). */
+  secondaryLogoDark: z.string().optional(),
+  /** Display name + target URL for the secondary/footer logo's link (optional). */
+  secondaryLogoLink: z
+    .object({
+      name: z.string().default(''),
+      url: z.string().default(''),
+    })
+    .default({}),
+});
+
+export const navbarSettingsSchema = z.object({
+  /** Simple top-level links. Empty by default — every client defines its own nav. */
+  primary: z.array(navLinkSchema).default([]),
+  /** Optional dropdown / mega-menu group. Rendered by SiteHeader only when present. */
+  dropdown: navGroupSchema.optional(),
+  /** The call-to-action button in the header (and footer). Contact → /contact/ unless set;
+   *  `null` hides it. */
+  cta: z
+    .object({ label: z.string(), href: z.string() })
+    .nullable()
+    .default({ label: 'Contact', href: '/contact/' }),
+});
+
+export const footerSettingsSchema = z.object({
+  /** Footer legal/info nav. Empty by default — every client defines its own. */
+  footer: z.array(navLinkSchema).default([]),
+});
+
+/**
+ * The brand — a client's design tokens, set in the CMS. The whole system is
+ * built to derive from just THREE source colours: `brand` (interactive accent),
+ * `ink` (text) and `surface` (background). `lib/themeTokens.ts` expands those
+ * into ~40 working tokens (light via `color-mix`, dark via an OKLCH translation
+ * — lightness flipped, hue kept, chroma damped so nothing turns neon), and
+ * `Base.astro` emits the result as a `<style>` that layers over the core's
+ * NEUTRAL defaults in `styles/theme.css`. Fonts and the four surface "knobs"
+ * (corners / elevation / stroke / fields) are the rest of the site-wide look —
+ * each set once, applied everywhere. `advanced.light/.dark` are a raw
+ * per-token escape hatch (power users / AI composition / back-compat) layered
+ * LAST. The core ships none of this — a brand lives in the client's repo (or
+ * the CMS), never baked into the shared core.
+ *
+ * This shape is what the Sveltia token pane edits (apps/showcase/public/admin):
+ * a client picks three colours + a font pairing + four knobs, not 40 tokens.
+ */
+export const themeSettingsSchema = z.object({
+  /** Interactive accent — buttons, links, icons, highlights. Blank ⇒ neutral. */
+  brand: z.string().default(''),
+  /** Text colour — headings & body. Blank ⇒ neutral. */
+  ink: z.string().default(''),
+  /** Background — page, cards, sections (tints derived from it). Blank ⇒ neutral. */
+  surface: z.string().default(''),
+  /** Site-wide font pairing (role → CSS font-family stack). Blank ⇒ core default. */
+  fonts: z
+    .object({
+      heading: z.string().default(''),
+      body: z.string().default(''),
+      display: z.string().default(''),
+    })
+    .default({}),
+  /** Corner radius applied to every card / tile / input / button. */
+  corners: z.enum(['sharp', 'rounded', 'soft']).default('rounded'),
+  /** Card/tile elevation — `flat` removes the soft shadow site-wide. */
+  elevation: z.enum(['raised', 'flat']).default('raised'),
+  /** Card/tile stroke — `off` removes the 1px border site-wide. */
+  stroke: z.enum(['on', 'off']).default('on'),
+  /** Input treatment — a single site-wide choice (a `data-field` attr on <html>). */
+  fields: z.enum(['boxed', 'filled', 'underline']).default('boxed'),
+  /** Dark-mode formula knobs (root-derivation model). `darkDepth` = how light the
+   *  dark page background sits (OKLCH L); `darkChroma` = the cap on how much colour
+   *  the dark ground may carry. Both feed the AUTOMATIC dark roots. */
+  darkDepth: z.number().min(0.12).max(0.4).default(0.21),
+  darkChroma: z.number().min(0).max(0.15).default(0.05),
+  /** Explicit overrides for the three dark ROOTS. Each blank ⇒ the root is derived
+   *  from its light source by the formula; set ⇒ every dark token in that role
+   *  re-derives from this colour. Roots only (ground / text / accent) — never a
+   *  lone downstream token — so the palette can never fall out of sync. */
+  darkOverrides: z
+    .object({
+      ground: z.string().default(''),
+      text: z.string().default(''),
+      accent: z.string().default(''),
+    })
+    .default({}),
+  /** Raw per-token overrides, layered last. Rarely needed. */
+  advanced: z
+    .object({
+      light: z.record(z.string()).default({}),
+      dark: z.record(z.string()).default({}),
+    })
+    .default({}),
+});
+
+export type SiteSettings = z.infer<typeof siteSettingsSchema>;
+export type LogoSettings = z.infer<typeof logoSettingsSchema>;
+export type NavbarSettings = z.infer<typeof navbarSettingsSchema>;
+export type FooterSettings = z.infer<typeof footerSettingsSchema>;
+export type ThemeSettings = z.infer<typeof themeSettingsSchema>;
+export type NavLink = z.infer<typeof navLinkSchema>;
+export type NavGroup = z.infer<typeof navGroupSchema>;
+export type NavGroupItem = z.infer<typeof navGroupItemSchema>;

package/examples/primitives.ts

@@ -9,6 +9,7 @@ export const primitives: GalleryEntry[] = [
   { type: 'heading', description: 'A section title, levels 1–6, optionally aligned.', block: { type: 'heading', text: 'A heading', level: 2 } },
   { type: 'heading', description: 'Optional gradient text — brand → derived accent-2 (falls back to solid ink where unsupported).', block: { type: 'heading', text: 'A gradient heading', level: 2, gradient: true } },
   { type: 'prose', description: 'Body text: blank lines start new paragraphs, `- ` / `1. ` lines make lists, and inline links (incl. phone and email), bold and italic render safely.', block: { type: 'prose', text: 'A paragraph of prose with **bold**, *italic* and a [link to the recipes](/recipes).\n\nFor a quick answer, [phone the office](tel:01234567890).\n\n- Lists from simple lines\n- With a [link](/primitives) inside' } },
+  { type: 'prose', description: 'The `lead` variant: the paragraph straight under the hero that introduces the page, larger and quieter than body text.', block: { type: 'prose', variant: 'lead', text: 'A lead paragraph introduces the page and invites the reader in.' } },
   { type: 'image', description: 'A responsive image with an optional caption. Corners follow the site by default.', block: { type: 'image', src: '/placeholder.svg', alt: 'Placeholder', caption: 'An image with a caption.' } },
   { type: 'image', description: 'Canonical framing options: soft corners + drop shadow + a fixed 16/9 ratio (image is cover-fit).', block: { type: 'image', src: '/showcase-hero.svg', alt: 'Abstract', radius: 'soft', shadow: true, ratio: '16/9', caption: 'radius: soft · shadow · ratio 16/9' } },
   { type: 'image', description: 'Square ratio with an outline stroke and sharp corners — same block, different canonical options.', block: { type: 'image', src: '/showcase-hero.svg', alt: 'Abstract', radius: 'none', border: true, ratio: 'square', caption: 'radius: none · stroke · square' } },
@@ -17,6 +18,7 @@ export const primitives: GalleryEntry[] = [
   { type: 'button', description: 'Filled CTA — the brand-accent call to action.', block: { type: 'button', label: 'Get started', href: '#', variant: 'cta' } },
   { type: 'button', description: 'Ghost — a quiet, borderless text button for tertiary actions.', block: { type: 'button', label: 'Learn more', href: '#', variant: 'ghost' } },
   { type: 'quote', description: 'A pull quote with an optional citation.', block: { type: 'quote', text: 'A memorable quotation, set apart.', cite: 'Someone' } },
+  { type: 'quote', description: 'A prayer, verse or poem: line breaks are kept as written, and inline formatting works.', block: { type: 'quote', text: 'Lord, make me an instrument of your peace:\nwhere there is hatred, let me sow love;\nwhere there is injury, *pardon*.', cite: 'Prayer of St Francis' } },
   { type: 'divider', description: 'A horizontal rule between sections.', block: { type: 'divider' } },
   { type: 'spacer', description: 'Vertical space (sm / md / lg) — invisible by design.', block: { type: 'spacer', size: 'lg' } },
   { type: 'section', description: 'A full-width band (background + width) holding child blocks.', block: { type: 'section', background: 'muted', width: 'normal', blocks: [{ type: 'heading', text: 'Inside a section', level: 3 }, { type: 'prose', text: 'Sections hold child blocks.' }] } },

package/examples/recipes.ts

@@ -33,5 +33,12 @@ export const recipes: GalleryEntry[] = [
   { type: 'contactCard', description: 'A branded "get in touch" band — a theme-adaptive panel (a section surface with a soft brand-gold corner wash) carrying a display-type title + subtitle on the left, contact channels as tappable tiles on the right, and a closing note across the bottom. Composes in both light and dark. The polished alternative to a plain notice box.', block: { type: 'contactCard', eyebrow: 'Parish office', title: 'Get in touch', subtitle: 'Parish Priest: Fr John Doe', note: 'For a quick reply, phone the office directly — email is best for non-urgent matters. See our [Safeguarding policy](/safeguarding).', items: [{ icon: 'map-pin', value: '1 Example Street\nPlaceholdertown EX4 3PL' }, { icon: 'phone', value: '01234 567890', href: 'tel:01234567890' }, { icon: 'email', value: 'office@st-placeholder.example', href: 'mailto:office@st-placeholder.example' }, { icon: 'link', value: 'Follow us on Facebook', href: 'https://facebook.com/' }] } },
   { type: 'locations', description: 'A "where to find us" grid — one or more places, each a neat tile with a consent-gated map on top and its name / address / directions below. Maps load once the visitor accepts the site cookie banner (shared consent, no per-tile gate). Replaces stacking bare map embeds.', block: { type: 'locations', title: 'Where to find us', columns: 2, items: [{ name: "St Placeholder's", address: '1 Example Street\nPlaceholdertown EX4 3PL', embedUrl: 'https://www.google.com/maps/embed?pb=!demo1', directionsUrl: 'https://maps.google.com/' }, { name: "St Sample's", address: '2 Sample Road\nPlaceholdertown', embedUrl: 'https://www.google.com/maps/embed?pb=!demo2', directionsUrl: 'https://maps.google.com/' }] } },
   { type: 'video', description: 'A consent-gated video — paste an ordinary YouTube (incl. a channel’s live page) or Vimeo link; it plays through the privacy-friendly embed only once the visitor agrees, with a “watch on YouTube” alternative. Fixed ratio, never overflows.', block: { type: 'video', title: 'Watch', caption: 'Sample video link.', url: 'https://www.youtube.com/watch?v=aqz-KE-bpKQ', ratio: '16/9' } },
+  { type: 'video', description: 'A channel’s live stream: it doesn’t auto-load (an off-air channel shows “unavailable”), so visitors see the schedule note, a link to the channel’s streams, and “Show the live stream”.', block: { type: 'video', title: 'Watch Mass live', url: 'https://www.youtube.com/channel/UCabcdefghijklmnopqrstuv/live', note: 'Live: **Sundays 10.15am** and holy days.' } },
   { type: 'documents', description: 'A list of files — newsletters, minutes, policies, forms — newest first, optionally grouped by year: type badge, title, date and note per row. Opens in the browser’s own viewer rather than an in-page one (better on phones).', block: { type: 'documents', title: 'Newsletters', intro: 'Every issue, newest first.', groupByYear: true, items: [{ title: 'Newsletter — Advent', file: '/files/sample-advent.pdf', date: '2026-11-30' }, { title: 'Newsletter — Harvest', file: '/files/sample-harvest.pdf', date: '2026-10-04', note: 'Includes the harvest appeal' }, { title: 'Newsletter — Christmas', file: '/files/sample-christmas.pdf', date: '2025-12-21' }, { title: 'Hall hire form', file: '/files/sample-hire-form.docx' }] } },
+  { type: 'linkRow', description: 'A titled row of contact links as pills: phone, email and web links each get the right icon from the link itself. With an optional intro and footnote. For a contact who doesn’t need a whole contact card.', block: { type: 'linkRow', title: 'Vocations', intro: 'Thinking about a vocation? Talk to the vocations director.', links: [{ label: '01234 567890', href: 'tel:01234567890' }, { label: 'vocations@example.org', href: 'mailto:vocations@example.org' }, { label: 'Vocations website', href: 'https://example.com/vocations' }], note: 'All enquiries are treated in confidence.' } },
+  { type: 'document', description: 'A policy or legal text as one block: sections numbered automatically, a contents list linking to each (sticky beside the text on wide screens), a “last updated” date, prose formatting in each section, print-friendly.', block: { type: 'document', intro: 'These conditions apply to every booking.', updated: '2026-10-04', sections: [{ title: 'Use of the hall', body: 'The hall may be used only for the purpose stated on the booking form.' }, { title: 'Bookings', body: 'Bookings are confirmed once the deposit is received.', items: ['Book through the office.', 'Bookings can’t be transferred.'] }, { title: 'Cancellation', body: 'Cancellations made less than **seven days** before the event forfeit the deposit.' }] } },
+  { type: 'timetable', description: 'Weekly times for one or more places (service times, opening hours, sessions): a card per place, days with no times left out, notes with links under each. Set `layout: "table"` to compare places side by side.', block: { type: 'timetable', title: 'Service times', places: [{ name: "St Placeholder's", address: '1 Example Street', schedule: [{ day: 'Saturday', times: ['6:00pm (vigil)'] }, { day: 'Sunday', times: ['8:30am', '10:30am'] }, { day: 'Weekdays', times: ['9:30am'] }], notes: 'Confessions on Saturdays from 5pm. See [how to find us](#find-us).' }, { name: "St Sample's", schedule: [{ day: 'Saturday', times: [] }, { day: 'Sunday', times: ['9:00am'] }], notes: 'No Saturday service.' }] } },
+  { type: 'timetable', description: 'The `table` layout: days down the side, one column per place; a day nobody uses is dropped.', block: { type: 'timetable', title: 'Opening hours', layout: 'table', places: [{ name: 'Library', schedule: [{ day: 'Monday', times: ['9am–5pm'] }, { day: 'Saturday', times: ['10am–1pm'] }] }, { name: 'Café', schedule: [{ day: 'Monday', times: ['8am–4pm'] }, { day: 'Sunday', times: [] }] }] } },
+  { type: 'contacts', description: 'A compact directory of people or offices: role as the card title, phone and email as tap targets (email with an optional subject), a shared note per group (e.g. office hours) instead of repeating it on every card.', block: { type: 'contacts', title: 'Who to contact', groups: [{ heading: 'Parish office', note: 'Office hours: **Mon–Fri 9am–1pm**.', contacts: [{ role: 'Parish Secretary', name: 'Anne Example', phone: '01234 567890', email: 'office@example.org', emailSubject: 'Parish enquiry' }, { role: 'Safeguarding Representative', email: 'safeguarding@example.org' }] }, { heading: 'Clergy', contacts: [{ role: 'Parish Priest', name: 'Fr John Example', phone: '01234 567891' }] }] } },
+  { type: 'mediaText', description: 'An image beside its text (start or end), stacking on a phone, the image keeping its shape. Text takes prose formatting; an optional button.', block: { type: 'mediaText', title: 'Getting married here', text: 'We are delighted that you are thinking of marrying in our church.\n\nPlease contact the parish office **at least six months** before the date.', image: { src: '/placeholder.svg', alt: 'The church interior decorated for a wedding', caption: 'The church, ready for a wedding' }, imageSide: 'end', cta: { label: 'Contact the office', href: '#' } } },
 ];

package/integration.mjs

@@ -1,64 +1,83 @@
-/**
- * ferst() — the Astro integration that makes a client site's ROUTING package-owned.
- *
- * A thin client adds `integrations: [ferst()]` to astro.config.mjs and carries
- * ZERO page files: the page catch-all (which also owns the home page), the
- * calendar route and the blog routes are injected from ferst-core. A routing fix
- * then ships as a package bump + rebuild — the same channel component fixes travel
- * through — instead of being hand-copied into every client repo.
- *
- * Irreducible caveat (Astro 5): content collections must be defined in the CONSUMER,
- * so the one-line `src/content/config.ts` re-export stays. "Zero page files" is
- * reachable; "zero files" is not. Explicit client `.astro` routes still win over
- * these injected ones, so a one-off hand-built page is always possible.
- *
- * The blog routes (posts index / individual post / tag pages) inject as a set:
- * the listing components (NewsList, PostsFilter) now live in core, so `/posts`,
- * `/posts/[...slug]` and `/posts/tag/[...tag]` all ship from the package. Turn
- * the whole capability off with `blog: false` (then a client wanting posts hand-
- * builds its own routes over `ferst-core/lib/posts`).
- *
- * @param {object} [options]
- * @param {boolean} [options.calendar=true] Inject the `/calendar` route.
- * @param {boolean} [options.blog=true] Inject the blog routes (`/posts`,
- *   `/posts/[...slug]`, `/posts/tag/[...tag]`).
- * @returns {import('astro').AstroIntegration}
- */
-export default function ferst(options = {}) {
-  const { calendar = true, blog = true } = options;
-  return {
-    name: 'ferst',
-    hooks: {
-      'astro:config:setup': ({ injectRoute }) => {
-        // Pages + home: the reserved `index` entry renders at `/`, every other
-        // `pages` entry at its own slug (see lib/pages.ts `getSiteRoutes`).
-        injectRoute({
-          pattern: '/[...slug]',
-          entrypoint: 'ferst-core/routes/[...slug].astro',
-        });
-        if (calendar) {
-          injectRoute({
-            pattern: '/calendar',
-            entrypoint: 'ferst-core/routes/calendar/index.astro',
-          });
-        }
-        if (blog) {
-          // The posts capability: index, individual post, and tag pages. Reads
-          // the `posts`/`tags`/`postsSettings` collections (content/collections.ts).
-          injectRoute({
-            pattern: '/posts',
-            entrypoint: 'ferst-core/routes/posts/index.astro',
-          });
-          injectRoute({
-            pattern: '/posts/[...slug]',
-            entrypoint: 'ferst-core/routes/posts/[...slug].astro',
-          });
-          injectRoute({
-            pattern: '/posts/tag/[...tag]',
-            entrypoint: 'ferst-core/routes/posts/tag/[...tag].astro',
-          });
-        }
-      },
-    },
-  };
-}
+/**
+ * ferst() — the Astro integration that makes a client site's ROUTING package-owned.
+ *
+ * A thin client adds `integrations: [ferst()]` to astro.config.mjs and carries
+ * ZERO page files: the page catch-all (which also owns the home page), the
+ * calendar route and the blog routes are injected from ferst-core. A routing fix
+ * then ships as a package bump + rebuild — the same channel component fixes travel
+ * through — instead of being hand-copied into every client repo.
+ *
+ * Irreducible caveat (Astro 5): content collections must be defined in the CONSUMER,
+ * so the one-line `src/content/config.ts` re-export stays. "Zero page files" is
+ * reachable; "zero files" is not. Explicit client `.astro` routes still win over
+ * these injected ones, so a one-off hand-built page is always possible.
+ *
+ * The blog routes (posts index / individual post / tag pages) inject as a set:
+ * the listing components (NewsList, PostsFilter) now live in core, so `/posts`,
+ * `/posts/[...slug]` and `/posts/tag/[...tag]` all ship from the package. Turn
+ * the whole capability off with `blog: false` (then a client wanting posts hand-
+ * builds its own routes over `ferst-core/lib/posts`).
+ *
+ * @param {object} [options]
+ * @param {boolean} [options.calendar=true] Inject the `/calendar` route.
+ * @param {boolean} [options.blog=true] Inject the blog routes (`/posts`,
+ *   `/posts/[...slug]`, `/posts/tag/[...tag]`).
+ * @param {boolean} [options.cookiePolicy=true] Inject `/cookie-policy` (the page the cookie
+ *   banner links to), generated from the blocks the site uses. Skipped automatically when
+ *   the site has its own `src/pages/cookie-policy.astro`.
+ * @returns {import('astro').AstroIntegration}
+ */
+import { existsSync } from 'node:fs';
+
+export default function ferst(options = {}) {
+  const { calendar = true, blog = true, cookiePolicy = true } = options;
+  return {
+    name: 'ferst',
+    hooks: {
+      'astro:config:setup': ({ injectRoute, config }) => {
+        // Pages + home: the reserved `index` entry renders at `/`, every other
+        // `pages` entry at its own slug (see lib/pages.ts `getSiteRoutes`).
+        injectRoute({
+          pattern: '/[...slug]',
+          entrypoint: 'ferst-core/routes/[...slug].astro',
+        });
+        if (calendar) {
+          injectRoute({
+            pattern: '/calendar',
+            entrypoint: 'ferst-core/routes/calendar/index.astro',
+          });
+        }
+        if (blog) {
+          // The posts capability: index, individual post, and tag pages. Reads
+          // the `posts`/`tags`/`postsSettings` collections (content/collections.ts).
+          injectRoute({
+            pattern: '/posts',
+            entrypoint: 'ferst-core/routes/posts/index.astro',
+          });
+          injectRoute({
+            pattern: '/posts/[...slug]',
+            entrypoint: 'ferst-core/routes/posts/[...slug].astro',
+          });
+          injectRoute({
+            pattern: '/posts/tag/[...tag]',
+            entrypoint: 'ferst-core/routes/posts/tag/[...tag].astro',
+          });
+          // Index pages 2+ (page 1 is /posts; tag pages paginate inside their own route).
+          injectRoute({
+            pattern: '/posts/page/[page]',
+            entrypoint: 'ferst-core/routes/posts/page/[page].astro',
+          });
+        }
+        // The cookie banner links here on every page, so it must always resolve. A site's
+        // own hand-built page wins (Astro would otherwise see two routes for one path).
+        const bespoke = config?.root && existsSync(new URL('src/pages/cookie-policy.astro', config.root));
+        if (cookiePolicy && !bespoke) {
+          injectRoute({
+            pattern: '/cookie-policy',
+            entrypoint: 'ferst-core/routes/cookie-policy.astro',
+          });
+        }
+      },
+    },
+  };
+}