ferst-core 0.7.8 → 0.7.10

package/cms/config.template.yml

@@ -1,227 +1,232 @@
-# Sveltia CMS — the content editor for a Ferst site. SINGLE SOURCE: this file lives
-# in ferst-core and is written to dist/admin/config.yml at build by `ferst-cms-config`,
-# so every client's collections are identical and always match the engine. The client
-# repo commits NO config.yml — it is a build product, so it can never drift by hand.
-#
-# The backend repo (owner/name), git-proxy origin, its /git api_root and this
-# deployment's branch are injected at build by ferst-cms-config.
-backend:
-  name: github
-  repo: __REPO__
-  branch: __BRANCH__
-  base_url: __BASE_URL__
-  auth_endpoint: auth
-  api_root: __API_ROOT__
-
-media_folder: public/uploads
-public_folder: /uploads
-
-collections:
-  - name: settings
-    label: Site settings
-    files:
-      - name: theme
-        label: Design tokens
-        file: src/content/themeSettings/index.json
-        icon: palette
-        description: "Edit your brand in the Theme Studio, where you preview changes live before publishing — open portal.ferst.co.uk, choose this site, then the Design tab. The fields here still work as a fallback."
-        fields:
-          - { name: brand, label: Brand colour, widget: color, default: '#0E4D4A', hint: Buttons, links, icons, highlights. }
-          - { name: ink, label: Ink colour, widget: color, default: '#0C2123', hint: Headings and body text. }
-          - { name: surface, label: Surface colour, widget: color, default: '#FFFFFF', hint: Page background. }
-          - name: fonts
-            label: Typography
-            widget: object
-            collapsed: false
-            fields:
-              - name: heading
-                label: Heading font
-                widget: select
-                required: false
-                default: ''
-                options: &fonts
-                  - { label: 'Default (theme)', value: '' }
-                  - { label: 'Poppins', value: 'Poppins, system-ui, sans-serif' }
-                  - { label: 'Inter', value: 'Inter, system-ui, sans-serif' }
-                  - { label: 'Playfair Display', value: "'Playfair Display', Georgia, serif" }
-                  - { label: 'Georgia', value: "Georgia, 'Times New Roman', serif" }
-                  - { label: 'System', value: 'system-ui, sans-serif' }
-              - { name: body, label: Body font, widget: select, required: false, default: '', options: *fonts }
-              - { name: display, label: Display font, widget: select, required: false, default: '', options: *fonts }
-          - { name: corners, label: Corners, widget: select, default: rounded, options: [{ label: Sharp, value: sharp }, { label: Rounded, value: rounded }, { label: Soft, value: soft }] }
-          - { name: elevation, label: Elevation, widget: select, default: raised, options: [{ label: Raised, value: raised }, { label: Flat, value: flat }] }
-          - { name: stroke, label: Card stroke, widget: select, default: 'on', options: [{ label: 'On', value: 'on' }, { label: 'Off', value: 'off' }] }
-          - { name: fields, label: Input fields, widget: select, default: boxed, options: [{ label: Boxed, value: boxed }, { label: Filled, value: filled }, { label: Underline, value: underline }] }
-          - { name: darkDepth, label: Dark depth, widget: number, value_type: float, min: 0.14, max: 0.34, step: 0.01, default: 0.21 }
-          - { name: darkChroma, label: Dark colour intensity, widget: number, value_type: float, min: 0, max: 0.15, step: 0.01, default: 0.05 }
-          - name: darkOverrides
-            label: Dark colour overrides (optional)
-            widget: object
-            collapsed: true
-            fields:
-              - { name: ground, label: Ground, widget: string, required: false }
-              - { name: text, label: Text, widget: string, required: false }
-              - { name: accent, label: Accent, widget: string, required: false }
-
-      - name: identity
-        label: Identity & contact
-        file: src/content/siteSettings/index.json
-        icon: info
-        fields:
-          - name: identity
-            label: Identity
-            widget: object
-            fields:
-              - { name: siteTitle, label: Site title, widget: string }
-              - { name: shortName, label: Short name, widget: string }
-              - { name: description, label: Description, widget: text }
-              - { name: location, label: Location, widget: string, required: false }
-          - name: contact
-            label: Contact
-            widget: object
-            fields:
-              - { name: phoneDisplay, label: Phone (display), widget: string, required: false }
-              - { name: phoneTel, label: 'Phone (tel: digits)', widget: string, required: false }
-              - { name: email, label: Email, widget: string, required: false }
-              - { name: facebookUrl, label: Facebook URL, widget: string, required: false }
-
-      - name: logos
-        label: Logos
-        file: src/content/logoSettings/index.json
-        icon: image
-        fields:
-          - { name: primaryLogoLight, label: Header logo (light), widget: image, required: false }
-          - { name: primaryLogoDark, label: Header logo (dark), widget: image, required: false }
-          - { name: secondaryLogoLight, label: Footer logo (light), widget: image, required: false }
-          - { name: secondaryLogoDark, label: Footer logo (dark), widget: image, required: false }
-
-      - name: navbar
-        label: Navigation
-        file: src/content/navbarSettings/index.json
-        icon: menu
-        fields:
-          - name: primary
-            label: Primary links
-            widget: list
-            fields:
-              - { name: label, label: Label, widget: string }
-              - { name: href, label: Link, widget: string }
-          - name: cta
-            label: Header button
-            widget: object
-            required: false
-            hint: The button at the right of the header (and in the footer). Leave as Contact → /contact/ unless your contact page lives elsewhere.
-            fields:
-              - { name: label, label: Label, widget: string, default: Contact }
-              - { name: href, label: Link, widget: string, default: /contact/ }
-
-      - name: footer
-        label: Footer
-        file: src/content/footerSettings/index.json
-        icon: table_rows
-        fields:
-          - name: footer
-            label: Footer links
-            widget: list
-            fields:
-              - { name: label, label: Label, widget: string }
-              - { name: href, label: Link, widget: string }
-          - name: groups
-            label: Footer columns
-            widget: list
-            required: false
-            hint: Headed columns for policies, safeguarding, documents and forms — keep the main menu short.
-            fields:
-              - { name: heading, label: Heading, widget: string }
-              - name: links
-                label: Links
-                widget: list
-                fields:
-                  - { name: label, label: Label, widget: string }
-                  - { name: href, label: Link, widget: string }
-
-      - name: calendar-settings
-        label: Calendar
-        file: src/content/calendarSettings/index.json
-        icon: calendar_today
-        fields:
-          - { name: title, label: Heading, widget: string, default: Calendar }
-          - { name: intro, label: Intro, widget: text, required: false }
-          - { name: embedUrl, label: Embed URL, widget: string, required: false }
-          - { name: publicUrl, label: Public link, widget: string, required: false }
-          - { name: height, label: Height (px), widget: number, default: 700, value_type: int, min: 200, max: 2000 }
-          - { name: provider, label: Provider name, widget: string, default: Google Calendar }
-          - { name: weekStart, label: Week starts on, widget: select, default: monday, options: [{ label: "Monday", value: monday }, { label: "Sunday", value: sunday }] }
-
-  - name: posts
-    label: Posts
-    label_singular: Post
-    folder: src/content/posts
-    create: true
-    slug: "{{slug}}"
-    extension: md
-    format: frontmatter
-    icon: article
-    summary: "{{title}} — {{date}}"
-    sortable_fields: [date, title]
-    fields:
-      - { name: title, label: Title, widget: string }
-      - { name: date, label: Date, widget: datetime, picker_utc: true }
-      - { name: summary, label: Summary, widget: text, required: false }
-      - name: tags
-        label: Tags
-        widget: relation
-        required: false
-        collection: tags
-        value_field: "{{slug}}"
-        display_fields: [label]
-        search_fields: [label]
-        multiple: true
-      - { name: heroImage, label: Hero image, widget: image, required: false }
-      - { name: attachment, label: Attachment (e.g. PDF), widget: file, required: false }
-      - { name: draft, label: Draft, widget: boolean, default: false, required: false }
-      - { name: body, label: Body, widget: markdown, required: false }
-
-  - name: tags
-    label: Tags
-    label_singular: Tag
-    folder: src/content/tags
-    create: true
-    slug: "{{slug}}"
-    extension: json
-    format: json
-    icon: label
-    identifier_field: label
-    fields:
-      - { name: label, label: Label, widget: string }
-      - { name: description, label: Description, widget: text, required: false }
-      - { name: hidden, label: Hidden, widget: boolean, default: false, required: false }
-
-  - name: pages
-    label: Pages
-    label_singular: Page
-    description: "See each page and request a change — our team makes it and sends it back for you to check. You don't edit the page layout here."
-    folder: src/content/pages
-    extension: json
-    format: json
-    icon: description
-    nested: { depth: 3, summary: "{{title}}" }
-    summary: "{{title}}"
-    identifier_field: title
-    fields:
-      - { name: title, label: Page title, widget: string }
-      - name: requests
-        label: Requested changes
-        label_singular: Request
-        widget: list
-        required: false
-        summary: "{{fields.text}}"
-        fields:
-          - { name: text, label: "What would you like changed?", widget: text }
-          - { name: status, label: Status, widget: select, default: open, options: [{ label: Open, value: open }, { label: Done, value: done }] }
-      - { name: description, label: SEO description, widget: hidden, required: false }
-      - { name: heroImage, widget: hidden, required: false }
-      - { name: align, widget: hidden, required: false }
-      - { name: templateId, widget: hidden, required: false }
-      - { name: draft, widget: hidden, required: false }
-      - { name: blocks, widget: hidden }
+# Sveltia CMS — the content editor for a Ferst site. SINGLE SOURCE: this file lives
+# in ferst-core and is written to dist/admin/config.yml at build by `ferst-cms-config`,
+# so every client's collections are identical and always match the engine. The client
+# repo commits NO config.yml — it is a build product, so it can never drift by hand.
+#
+# The backend repo (owner/name), git-proxy origin, its /git api_root and this
+# deployment's branch are injected at build by ferst-cms-config.
+backend:
+  name: github
+  repo: __REPO__
+  branch: __BRANCH__
+  base_url: __BASE_URL__
+  auth_endpoint: auth
+  api_root: __API_ROOT__
+
+media_folder: public/uploads
+public_folder: /uploads
+
+collections:
+  - name: settings
+    label: Site settings
+    files:
+      - name: theme
+        label: Design tokens
+        file: src/content/themeSettings/index.json
+        icon: palette
+        description: "Edit your brand in the Theme Studio, where you preview changes live before publishing — open portal.ferst.co.uk, choose this site, then the Design tab. The fields here still work as a fallback."
+        fields:
+          - { name: brand, label: Brand colour, widget: color, default: '#0E4D4A', hint: Buttons, links, icons, highlights. }
+          - { name: ink, label: Ink colour, widget: color, default: '#0C2123', hint: Headings and body text. }
+          - { name: surface, label: Surface colour, widget: color, default: '#FFFFFF', hint: Page background. }
+          - name: fonts
+            label: Typography
+            widget: object
+            collapsed: false
+            fields:
+              - name: heading
+                label: Heading font
+                widget: select
+                required: false
+                default: ''
+                options: &fonts
+                  - { label: 'Default (theme)', value: '' }
+                  - { label: 'Poppins', value: 'Poppins, system-ui, sans-serif' }
+                  - { label: 'Inter', value: 'Inter, system-ui, sans-serif' }
+                  - { label: 'Playfair Display', value: "'Playfair Display', Georgia, serif" }
+                  - { label: 'Georgia', value: "Georgia, 'Times New Roman', serif" }
+                  - { label: 'System', value: 'system-ui, sans-serif' }
+              - { name: body, label: Body font, widget: select, required: false, default: '', options: *fonts }
+              - { name: display, label: Display font, widget: select, required: false, default: '', options: *fonts }
+          - { name: corners, label: Corners, widget: select, default: rounded, options: [{ label: Sharp, value: sharp }, { label: Rounded, value: rounded }, { label: Soft, value: soft }] }
+          - { name: elevation, label: Elevation, widget: select, default: raised, options: [{ label: Raised, value: raised }, { label: Flat, value: flat }] }
+          - { name: stroke, label: Card stroke, widget: select, default: 'on', options: [{ label: 'On', value: 'on' }, { label: 'Off', value: 'off' }] }
+          - { name: fields, label: Input fields, widget: select, default: boxed, options: [{ label: Boxed, value: boxed }, { label: Filled, value: filled }, { label: Underline, value: underline }] }
+          - { name: darkDepth, label: Dark depth, widget: number, value_type: float, min: 0.14, max: 0.34, step: 0.01, default: 0.21 }
+          - { name: darkChroma, label: Dark colour intensity, widget: number, value_type: float, min: 0, max: 0.15, step: 0.01, default: 0.05 }
+          - name: darkOverrides
+            label: Dark colour overrides (optional)
+            widget: object
+            collapsed: true
+            fields:
+              - { name: ground, label: Ground, widget: string, required: false }
+              - { name: text, label: Text, widget: string, required: false }
+              - { name: accent, label: Accent, widget: string, required: false }
+
+      - name: identity
+        label: Identity & contact
+        file: src/content/siteSettings/index.json
+        icon: info
+        fields:
+          - name: identity
+            label: Identity
+            widget: object
+            fields:
+              - { name: siteTitle, label: Site title, widget: string }
+              - { name: shortName, label: Short name, widget: string }
+              - { name: description, label: Description, widget: text }
+              - { name: location, label: Location, widget: string, required: false }
+          - name: contact
+            label: Contact
+            widget: object
+            fields:
+              - { name: phoneDisplay, label: Phone (display), widget: string, required: false }
+              - { name: phoneTel, label: 'Phone (tel: digits)', widget: string, required: false }
+              - { name: email, label: Email, widget: string, required: false }
+              - { name: facebookUrl, label: Facebook URL, widget: string, required: false }
+
+      - name: logos
+        label: Logos
+        file: src/content/logoSettings/index.json
+        icon: image
+        fields:
+          - { name: primaryLogoLight, label: Header logo (light), widget: image, required: false }
+          - { name: primaryLogoDark, label: Header logo (dark), widget: image, required: false }
+          - { name: secondaryLogoLight, label: Footer logo (light), widget: image, required: false }
+          - { name: secondaryLogoDark, label: Footer logo (dark), widget: image, required: false }
+
+      - name: navbar
+        label: Navigation
+        file: src/content/navbarSettings/index.json
+        icon: menu
+        fields:
+          - name: primary
+            label: Primary links
+            widget: list
+            fields:
+              - { name: label, label: Label, widget: string }
+              - { name: href, label: Link, widget: string }
+          - name: cta
+            label: Header button
+            widget: object
+            required: false
+            hint: The button at the right of the header (and in the footer). Leave as Contact → /contact/ unless your contact page lives elsewhere.
+            fields:
+              - { name: label, label: Label, widget: string, default: Contact }
+              - { name: href, label: Link, widget: string, default: /contact/ }
+
+      - name: footer
+        label: Footer
+        file: src/content/footerSettings/index.json
+        icon: table_rows
+        fields:
+          - name: footer
+            label: Footer links
+            widget: list
+            fields:
+              - { name: label, label: Label, widget: string }
+              - { name: href, label: Link, widget: string }
+          - name: groups
+            label: Footer columns
+            widget: list
+            required: false
+            hint: Headed columns for policies, safeguarding, documents and forms — keep the main menu short.
+            fields:
+              - { name: heading, label: Heading, widget: string }
+              - name: links
+                label: Links
+                widget: list
+                fields:
+                  - { name: label, label: Label, widget: string }
+                  - { name: href, label: Link, widget: string }
+
+      - name: calendar-settings
+        label: Calendar
+        file: src/content/calendarSettings/index.json
+        icon: calendar_today
+        fields:
+          - { name: title, label: Heading, widget: string, default: Calendar }
+          - { name: intro, label: Intro, widget: text, required: false }
+          - { name: embedUrl, label: Embed URL, widget: string, required: false }
+          - { name: publicUrl, label: Public link, widget: string, required: false }
+          - { name: height, label: Height (px), widget: number, default: 700, value_type: int, min: 200, max: 2000 }
+          - { name: provider, label: Provider name, widget: string, default: Google Calendar }
+          - { name: weekStart, label: Week starts on, widget: select, default: monday, options: [{ label: "Monday", value: monday }, { label: "Sunday", value: sunday }] }
+
+  - name: posts
+    label: Posts
+    label_singular: Post
+    folder: src/content/posts
+    create: true
+    slug: "{{slug}}"
+    extension: md
+    format: frontmatter
+    icon: article
+    summary: "{{title}} — {{date}}"
+    sortable_fields: [date, title]
+    fields:
+      - { name: title, label: Title, widget: string }
+      - { name: date, label: Date, widget: datetime, picker_utc: true }
+      - { name: summary, label: Summary, widget: text, required: false }
+      - name: tags
+        label: Tags
+        widget: relation
+        required: false
+        collection: tags
+        value_field: "{{slug}}"
+        display_fields: [label]
+        search_fields: [label]
+        multiple: true
+      - { name: heroImage, label: Hero image, widget: image, required: false }
+      - { name: attachment, label: Attachment (e.g. PDF), widget: file, required: false }
+      - { name: draft, label: Draft, widget: boolean, default: false, required: false }
+      - { name: body, label: Body, widget: markdown, required: false }
+
+  - name: tags
+    label: Tags
+    label_singular: Tag
+    folder: src/content/tags
+    create: true
+    slug: "{{slug}}"
+    extension: json
+    format: json
+    icon: label
+    identifier_field: label
+    fields:
+      - { name: label, label: Label, widget: string }
+      - { name: description, label: Description, widget: text, required: false }
+      - { name: hidden, label: Hidden, widget: boolean, default: false, required: false }
+
+  - name: pages
+    label: Pages
+    label_singular: Page
+    description: "See each page and request a change — our team makes it and sends it back for you to check. You don't edit the page layout here."
+    folder: src/content/pages
+    extension: json
+    format: json
+    icon: description
+    nested: { depth: 3, summary: "{{title}}" }
+    summary: "{{title}}"
+    identifier_field: title
+    fields:
+      - { name: title, label: Page title, widget: string }
+      - name: requests
+        label: Requested changes
+        label_singular: Request
+        widget: list
+        required: false
+        summary: "{{fields.text}}"
+        fields:
+          - { name: text, label: "What would you like changed?", widget: text }
+          - { name: status, label: Status, widget: select, default: open, options: [{ label: Open, value: open }, { label: Done, value: done }] }
+          # Stamped by the platform when the request is raised with the team (who, when, the
+          # tracking number). Hidden, but kept on every save so a request is raised only once.
+          - { name: issue, widget: hidden, required: false }
+          - { name: by, widget: hidden, required: false }
+          - { name: at, widget: hidden, required: false }
+      - { name: description, label: SEO description, widget: hidden, required: false }
+      - { name: heroImage, widget: hidden, required: false }
+      - { name: align, widget: hidden, required: false }
+      - { name: templateId, widget: hidden, required: false }
+      - { name: draft, widget: hidden, required: false }
+      - { name: blocks, widget: hidden }

package/components/CalendarEmbed.astro

@@ -1,4 +1,5 @@
 ---
+import { inlineMarkdown } from '../lib/inline-markdown';
 /**
  * CalendarEmbed — a consent-gated external calendar embed (e.g. Google Calendar).
  * Nothing loads from the provider until the visitor clicks "Load calendar", so no
@@ -38,7 +39,7 @@ const safe = isSafeEmbedUrl(finalEmbedUrl);
 
 <section class="b-calendar">
   {title && <h2 class="b-calendar__title">{title}</h2>}
-  {intro && <p class="b-calendar__intro">{intro}</p>}
+  {intro && <p class="b-calendar__intro" set:html={inlineMarkdown(intro)} />}
 
   {!finalEmbedUrl ? (
     <p class="b-calendar__note">The calendar isn't set up yet.</p>

package/components/recipes/Hero.astro

@@ -23,11 +23,13 @@ interface Props {
   image?: { src: string; alt?: string };
   media?: { image?: string; images?: string[]; video?: string; poster?: string; overlay?: number; link?: string; linkLabel?: string };
   layout?: 'centered' | 'split' | 'media';
-  size?: 'standard' | 'tall' | 'screen';
+  size?: 'compact' | 'standard' | 'tall' | 'screen';
   parallax?: boolean;
   background?: 'none' | 'mesh';
+  fullBleed?: boolean;
+  focus?: string;
 }
-const { eyebrow, title, subtitle, cta, image, media, layout = 'centered', size = 'standard', parallax = false, background = 'none' } = Astro.props;
+const { eyebrow, title, subtitle, cta, image, media, layout = 'centered', size = 'standard', parallax = false, background = 'none', fullBleed = false, focus } = Astro.props;
 // A YouTube / Vimeo link plays as an embedded background (after consent); anything else
 // in `video` is a file for a native <video>.
 const embed = media?.video ? backgroundEmbed(media.video) : null;
@@ -55,7 +57,8 @@ const bgImage = isMedia && stillSrc ? `--hero-image: url('${stillSrc}')` : '';
   data-motion={motion}
   data-linked={bgLink ? 'true' : undefined}
   data-parallax={isMedia && parallax ? 'true' : undefined}
-  style={isMedia ? `--hero-overlay: ${overlay}; ${bgImage}` : undefined}
+  data-full-bleed={isMedia && fullBleed ? 'true' : undefined}
+  style={isMedia ? `--hero-overlay: ${overlay}; ${bgImage}${focus ? `; --hero-focus: ${focus}` : ''}` : undefined}
 >
   {isMedia && (
     <div class="b-hero__bg" aria-hidden="true">
@@ -307,6 +310,21 @@ const bgImage = isMedia && stillSrc ? `--hero-image: url('${stillSrc}')` : '';
     overflow: hidden;
     isolation: isolate;
   }
+  /* A narrow band for a short, wide header strip: close to the strip's own shape, so it
+     isn't cropped to its middle and blown up. Less padding and a smaller title to fit. */
+  .b-hero[data-size='compact'] {
+    min-height: clamp(8rem, 18vw, 16rem);
+    padding-block: clamp(1.25rem, 3vw, 2.25rem);
+  }
+  .b-hero[data-size='compact'] :global(h1) {
+    font-size: clamp(1.6rem, 3.4vw, 2.6rem);
+  }
+  /* Edge to edge across the screen, like a full-bleed banner. */
+  .b-hero[data-full-bleed='true'] {
+    width: 100vw;
+    margin-inline: calc(50% - 50vw);
+    border-radius: 0;
+  }
   .b-hero[data-size='tall'] {
     min-height: min(85vh, 52rem);
   }
@@ -330,7 +348,7 @@ const bgImage = isMedia && stillSrc ? `--hero-image: url('${stillSrc}')` : '';
     z-index: -1;
     background-image: var(--hero-image, none);
     background-size: cover;
-    background-position: center;
+    background-position: var(--hero-focus, center);
     background-color: var(--bg-section);
   }
   /* Parallax: give the background room to drift without uncovering an edge. */
@@ -342,6 +360,7 @@ const bgImage = isMedia && stillSrc ? `--hero-image: url('${stillSrc}')` : '';
     width: 100%;
     height: 100%;
     object-fit: cover;
+    object-position: var(--hero-focus, center);
   }
   /* An embedded background player, sized to COVER the hero like object-fit (16:9 kept,
      overflow cropped). Never interactive; fades in once it has started. */
@@ -374,7 +393,7 @@ const bgImage = isMedia && stillSrc ? `--hero-image: url('${stillSrc}')` : '';
     position: absolute;
     inset: 0;
     background-size: cover;
-    background-position: center;
+    background-position: var(--hero-focus, center);
     opacity: 0;
     transition: opacity 1.6s ease-in-out;
   }

package/content/blocks.ts

@@ -146,9 +146,19 @@ export const heroBlock = z.object({
     })
     .optional(),
   layout: z.enum(['centered', 'split', 'media']).default('centered'),
-  /** How much of the screen a `media` hero takes: `standard` (a band), `tall`,
-   *  or `screen` — the full first screen, edge to edge (e.g. a video opener). */
-  size: z.enum(['standard', 'tall', 'screen']).default('standard'),
+  /** How much of the screen a `media` hero takes: `compact` (a narrow band for a short,
+   *  wide header strip, e.g. 1000 × 175), `standard` (a band), `tall`, or `screen` — the
+   *  full first screen, edge to edge (e.g. a video opener). */
+  size: z.enum(['compact', 'standard', 'tall', 'screen']).default('standard'),
+  /** A `media` hero runs edge to edge across the screen, like a full-bleed banner
+   *  (`screen` always does). */
+  fullBleed: z.boolean().default(false),
+  /** Which part of the background image shows when it's cropped: one or two positions,
+   *  keywords or percentages (e.g. `center 30%`, `top`, `left 20%`). Default `center`. */
+  focus: z
+    .string()
+    .regex(/^(?:left|center|right|top|bottom|\d{1,3}%)(?: (?:left|center|right|top|bottom|\d{1,3}%))?$/, 'focus is one or two of left / center / right / top / bottom / a percentage, e.g. "center 30%"')
+    .optional(),
   /** A `media` hero's background drifts more slowly than the page as it scrolls (any
    *  background: image, slides or video). Off on touch devices and under reduced motion. */
   parallax: z.boolean().default(false),
@@ -919,8 +929,11 @@ export const pageSchema = z.object({
     .array(
       z.object({
         text: z.string(),
+        /** Stamped by the platform when the request becomes an issue in the site's repo:
+         *  when, who asked (from their session) and the issue number. */
         at: z.string().optional(),
         by: z.string().optional(),
+        issue: z.number().int().optional(),
         status: z.enum(['open', 'done']).default('open'),
       }),
     )

package/layouts/Base.astro

@@ -431,6 +431,7 @@ const metaDescription = description ?? identity.description;
       /* A full-bleed opener (a full-screen hero, a full-bleed banner) as the page's first
          block sits flush under the header, not below the main's top padding. */
       .site-main:has(> .b-hero[data-size='screen']:first-child),
+      .site-main:has(> .b-hero[data-full-bleed='true']:first-child),
       .site-main:has(> .b-banner[data-full-bleed='true']:first-child) {
         padding-block-start: 0;
       }

package/lib/inline-markdown.ts

@@ -69,3 +69,16 @@ export function inlineMarkdown(text: string | undefined | null): string {
   out += inlineFormat(escapeHtml(text.slice(last)));
   return out;
 }
+
+/** The words of formatted copy with the formatting gone (a link becomes its label): for
+ *  places that must be plain text, like a page's meta description. */
+export function plainText(text: string | undefined | null): string {
+  if (!text) return '';
+  return text
+    .replace(LINK_RE, '$1')
+    .replace(/\*\*([^*]+)\*\*/g, '$1')
+    .replace(/(^|[^*\w])\*(?![\s*])([^*]*?[^\s*])\*(?!\*)/g, '$1$2')
+    .replace(/(^|[^\w])_(?![\s_])([^_]*?[^\s_])_(?!\w)/g, '$1$2')
+    .replace(/\s*\n\s*/g, ' ')
+    .trim();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ferst-core",
-  "version": "0.7.8",
+  "version": "0.7.10",
   "type": "module",
   "description": "Ferst Core \u2014 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",

package/routes/calendar/index.astro

@@ -1,4 +1,5 @@
 ---
+import { plainText } from '../../lib/inline-markdown';
 /**
  * The calendar page (`/calendar`) — INJECTED by the ferst() integration. Consent-
  * gated by CalendarEmbed (nothing loads from Google until the visitor opts in).
@@ -12,7 +13,7 @@ import { getCalendarSettings } from '../../lib/calendar';
 const cal = await getCalendarSettings();
 ---
 
-<Base title={cal.title} description={cal.intro || undefined}>
+<Base title={cal.title} description={plainText(cal.intro) || undefined}>
   <CalendarEmbed
     title={cal.title}
     intro={cal.intro}