ferst-core 0.7.4 → 0.7.5

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/recipes.ts

@@ -39,4 +39,6 @@ export const recipes: GalleryEntry[] = [
   { 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/layouts/Base.astro

@@ -201,6 +201,7 @@ const metaDescription = description ?? identity.description;
       brandAlt={brandAlt}
       primaryNav={navigation.primary}
       dropdown={navigation.dropdown}
+      cta={navigation.cta}
     />
 
     <main class:list={['site-main', mainClass]} data-content-align={align}>
@@ -214,6 +215,7 @@ const metaDescription = description ?? identity.description;
     <SiteFooter
       facebookUrl={contact.facebookUrl}
       footerLinks={navigation.footer}
+      cta={navigation.cta}
       footerClass={footerClass}
       shortName={identity.shortName}
       tagline={identity.description}

package/lib/links.ts

@@ -10,3 +10,13 @@ export function linkIcon(href: string): IconKey {
   if (/^https?:\/\//i.test(href)) return 'globe';
   return 'arrow';
 }
+
+/** A tel: link from a number as an editor types it (spaces, brackets, a "(0)" dropped). */
+export function telHref(phone: string): string {
+  return 'tel:' + phone.replace(/\(0\)/g, '').replace(/[^\d+]/g, '');
+}
+
+/** A mailto: link, with an optional pre-filled subject. */
+export function mailtoHref(email: string, subject?: string): string {
+  return `mailto:${email}${subject ? `?subject=${encodeURIComponent(subject)}` : ''}`;
+}

package/lib/siteSettings.ts

@@ -1,60 +1,61 @@
-/**
- * Single accessor merging the site-settings content entries into one combined
- * object. Storage is split across small collections (identity+contact, logos,
- * navbar, footer, theme) so each is its own focused Sveltia CMS pane — see
- * `content/schemas.ts`. Consumers read one combined shape though, so this loader
- * re-assembles it (including the `navigation.primary` / `navigation.footer`
- * grouping) at read time — the only place that needs to know storage is split.
- *
- * `getEntry(...)` yields `data` typed per-collection when the entry exists, but
- * the content runtime doesn't always apply nested Zod defaults the way a plain
- * `schema.parse()` does. We re-parse each entry through its own schema so nested
- * defaults are fully populated, including when a file is missing.
- */
-import { getEntry } from 'astro:content';
-import {
-  footerSettingsSchema,
-  logoSettingsSchema,
-  navbarSettingsSchema,
-  siteSettingsSchema,
-  themeSettingsSchema,
-  type LogoSettings,
-  type NavLink,
-  type NavGroup,
-  type SiteSettings,
-  type ThemeSettings,
-} from '../content/schemas';
-
-export type LoadedSiteSettings = SiteSettings &
-  LogoSettings & {
-    navigation: { primary: NavLink[]; footer: NavLink[]; dropdown?: NavGroup };
-    /** Client-provided design-token overrides (empty objects if none). */
-    theme: ThemeSettings;
-  };
-
-let cached: LoadedSiteSettings | null = null;
-
-export async function loadSiteSettings(): Promise<LoadedSiteSettings> {
-  if (cached) return cached;
-
-  const [siteSettingsEntry, logoEntry, navbarEntry, footerEntry, themeEntry] = await Promise.all([
-    getEntry('siteSettings', 'index'),
-    getEntry('logoSettings', 'index'),
-    getEntry('navbarSettings', 'index'),
-    getEntry('footerSettings', 'index'),
-    getEntry('themeSettings', 'index'),
-  ]);
-
-  cached = {
-    ...siteSettingsSchema.parse(siteSettingsEntry?.data ?? {}),
-    ...logoSettingsSchema.parse(logoEntry?.data ?? {}),
-    navigation: {
-      primary: navbarSettingsSchema.parse(navbarEntry?.data ?? {}).primary,
-      footer: footerSettingsSchema.parse(footerEntry?.data ?? {}).footer,
-      dropdown: navbarSettingsSchema.parse(navbarEntry?.data ?? {}).dropdown,
-    },
-    theme: themeSettingsSchema.parse(themeEntry?.data ?? {}),
-  };
-
-  return cached;
-}
+/**
+ * Single accessor merging the site-settings content entries into one combined
+ * object. Storage is split across small collections (identity+contact, logos,
+ * navbar, footer, theme) so each is its own focused Sveltia CMS pane — see
+ * `content/schemas.ts`. Consumers read one combined shape though, so this loader
+ * re-assembles it (including the `navigation.primary` / `navigation.footer`
+ * grouping) at read time — the only place that needs to know storage is split.
+ *
+ * `getEntry(...)` yields `data` typed per-collection when the entry exists, but
+ * the content runtime doesn't always apply nested Zod defaults the way a plain
+ * `schema.parse()` does. We re-parse each entry through its own schema so nested
+ * defaults are fully populated, including when a file is missing.
+ */
+import { getEntry } from 'astro:content';
+import {
+  footerSettingsSchema,
+  logoSettingsSchema,
+  navbarSettingsSchema,
+  siteSettingsSchema,
+  themeSettingsSchema,
+  type LogoSettings,
+  type NavLink,
+  type NavGroup,
+  type SiteSettings,
+  type ThemeSettings,
+} from '../content/schemas';
+
+export type LoadedSiteSettings = SiteSettings &
+  LogoSettings & {
+    navigation: { primary: NavLink[]; footer: NavLink[]; dropdown?: NavGroup; cta: { label: string; href: string } | null };
+    /** Client-provided design-token overrides (empty objects if none). */
+    theme: ThemeSettings;
+  };
+
+let cached: LoadedSiteSettings | null = null;
+
+export async function loadSiteSettings(): Promise<LoadedSiteSettings> {
+  if (cached) return cached;
+
+  const [siteSettingsEntry, logoEntry, navbarEntry, footerEntry, themeEntry] = await Promise.all([
+    getEntry('siteSettings', 'index'),
+    getEntry('logoSettings', 'index'),
+    getEntry('navbarSettings', 'index'),
+    getEntry('footerSettings', 'index'),
+    getEntry('themeSettings', 'index'),
+  ]);
+
+  cached = {
+    ...siteSettingsSchema.parse(siteSettingsEntry?.data ?? {}),
+    ...logoSettingsSchema.parse(logoEntry?.data ?? {}),
+    navigation: {
+      primary: navbarSettingsSchema.parse(navbarEntry?.data ?? {}).primary,
+      footer: footerSettingsSchema.parse(footerEntry?.data ?? {}).footer,
+      dropdown: navbarSettingsSchema.parse(navbarEntry?.data ?? {}).dropdown,
+      cta: navbarSettingsSchema.parse(navbarEntry?.data ?? {}).cta,
+    },
+    theme: themeSettingsSchema.parse(themeEntry?.data ?? {}),
+  };
+
+  return cached;
+}

package/lib/slug.ts

@@ -0,0 +1,32 @@
+/**
+ * Readable anchor ids for headings and document sections (`/sacraments#confirmation`).
+ * `slugify` is pure; `uniqueSlug` de-duplicates within one page using a Set the caller
+ * keeps per request (Astro.locals), so two "Mass times" headings become `mass-times` and
+ * `mass-times-2`.
+ */
+export function slugify(text: string): string {
+  const s = text
+    .normalize('NFKD')
+    .replace(/[̀-ͯ]/g, '') // accents
+    .toLowerCase()
+    .replace(/['’]/g, '') // apostrophes join the word ("joachim's" → "joachims")
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .slice(0, 60)
+    .replace(/-+$/, '');
+  return s || 'section';
+}
+
+export function uniqueSlug(text: string, used: Set<string>): string {
+  const base = slugify(text);
+  let slug = base;
+  for (let n = 2; used.has(slug); n++) slug = `${base}-${n}`;
+  used.add(slug);
+  return slug;
+}
+
+/** The per-page Set of anchor ids already used, kept on Astro.locals. */
+export function pageSlugs(locals: unknown): Set<string> {
+  const bag = (locals ?? {}) as { __ferstSlugs?: Set<string> };
+  return (bag.__ferstSlugs ??= new Set<string>());
+}

package/lib/table.ts

@@ -0,0 +1,10 @@
+/**
+ * Which of a table's columns to show: those with content in at least one body row. A column
+ * that's empty everywhere (e.g. an unused "Evening") is dropped rather than shown blank.
+ * A header-only table keeps all its columns. Pure.
+ */
+export function filledColumns(columns: string[], rows: string[][]): number[] {
+  const all = columns.map((_, i) => i);
+  if (!rows.length) return all;
+  return all.filter((i) => rows.some((r) => (r[i] ?? '').trim() !== ''));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ferst-core",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "type": "module",
   "description": "Ferst Core — the shared, brand-agnostic client-site system: Astro components, layouts, content schemas, the layered config resolver, and a neutral styling architecture that every client overrides.",
   "license": "BUSL-1.1",