ferst-core 0.7.7 → 0.7.9

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),
@@ -773,7 +783,30 @@ export type LeafBlock =
   | z.infer<typeof listBlock>;
 
 /** The full recursive block type: leaf primitives + layout containers. */
-export type Block = LeafBlock | RecipeBlock | SectionBlock | GridBlock | StackBlock;
+/**
+ * Alignment overrides every block takes, so a page's look can follow a client's preference
+ * from the page data alone. Defaults are the sensible visual choice (a block follows its
+ * page / section; a recipe's section title is centred).
+ *  - `align`: re-aligns the whole block — title, intro, text, and the icons, pills and
+ *    buttons in its cards — overriding the page / section for this one block.
+ *  - `headingAlign`: just a recipe's title + intro (e.g. a start-aligned title over centred
+ *    cards). Recipes without a section title ignore it.
+ * `heading`, `banner` and `section` already had `align` with this meaning and keep it.
+ */
+const alignOption = z.enum(['start', 'center', 'end']);
+export interface BlockLayout {
+  align?: 'start' | 'center' | 'end';
+  headingAlign?: 'start' | 'center' | 'end';
+}
+function withLayout<T extends z.AnyZodObject>(block: T): z.AnyZodObject {
+  const shape = block.shape as Record<string, unknown>;
+  return block.extend({
+    ...('align' in shape ? {} : { align: alignOption.optional() }),
+    headingAlign: alignOption.optional(),
+  });
+}
+
+export type Block = (LeafBlock | RecipeBlock | SectionBlock | GridBlock | StackBlock) & BlockLayout;
 export type BlockType = Block['type'];
 
 export const sectionBlock = z.object({
@@ -806,54 +839,57 @@ export const stackBlock = z.object({
  *  a member without a matching BlockRenderer registry entry is a TypeScript error
  *  (the exhaustiveness guard against a silent-undefined render crash). Cast to
  *  the recursive `Block` type because `z.lazy` fields can't be inferred. */
-export const blockSchema = z.discriminatedUnion('type', [
-  headingBlock,
-  proseBlock,
-  imageBlock,
-  buttonBlock,
-  quoteBlock,
-  dividerBlock,
-  spacerBlock,
-  badgeBlock,
-  statBlock,
-  listBlock,
-  heroBlock,
-  featureCardsBlock,
-  ctaBlock,
-  faqBlock,
-  galleryBlock,
-  testimonialBlock,
-  contactFormBlock,
-  formBlock,
-  accordionBlock,
-  tilesBlock,
-  bannerBlock,
-  statsBlock,
-  stepsBlock,
-  pricingBlock,
-  logosBlock,
-  tabsBlock,
-  announcementBlock,
-  bentoBlock,
-  marqueeBlock,
-  latestPostsBlock,
-  mapEmbedBlock,
-  tableBlock,
-  noticeBlock,
-  mediaCardsBlock,
-  contactCardBlock,
-  locationsBlock,
-  videoBlock,
-  documentsBlock,
-  linkRowBlock,
-  documentBlock,
-  timetableBlock,
-  contactsBlock,
-  mediaTextBlock,
-  sectionBlock,
-  gridBlock,
-  stackBlock,
-]) as unknown as z.ZodType<Block>;
+export const blockSchema = z.discriminatedUnion(
+  'type',
+  [
+    headingBlock,
+    proseBlock,
+    imageBlock,
+    buttonBlock,
+    quoteBlock,
+    dividerBlock,
+    spacerBlock,
+    badgeBlock,
+    statBlock,
+    listBlock,
+    heroBlock,
+    featureCardsBlock,
+    ctaBlock,
+    faqBlock,
+    galleryBlock,
+    testimonialBlock,
+    contactFormBlock,
+    formBlock,
+    accordionBlock,
+    tilesBlock,
+    bannerBlock,
+    statsBlock,
+    stepsBlock,
+    pricingBlock,
+    logosBlock,
+    tabsBlock,
+    announcementBlock,
+    bentoBlock,
+    marqueeBlock,
+    latestPostsBlock,
+    mapEmbedBlock,
+    tableBlock,
+    noticeBlock,
+    mediaCardsBlock,
+    contactCardBlock,
+    locationsBlock,
+    videoBlock,
+    documentsBlock,
+    linkRowBlock,
+    documentBlock,
+    timetableBlock,
+    contactsBlock,
+    mediaTextBlock,
+    sectionBlock,
+    gridBlock,
+    stackBlock,
+  ].map(withLayout) as unknown as [z.AnyZodObject, z.AnyZodObject, ...z.AnyZodObject[]],
+) as unknown as z.ZodType<Block>;
 
 /** A page = metadata + an ordered list of blocks. Stored as JSON in the client
  *  repo; the AI composes it, a human verifies. This is also the schema of the