@weatherboard/cms 0.5.0 → 0.7.0

package/dist/portable/menu.d.ts

@@ -0,0 +1,69 @@
+import { MENU_LAYOUTS, MENU_DECORATIONS } from "./menu-options.js";
+export { MENU_LAYOUTS, MENU_DECORATIONS, MENU_LAYOUT_DEFAULTS } from "./menu-options.js";
+export type MenuLayout = (typeof MENU_LAYOUTS)[number];
+export type MenuDecoration = (typeof MENU_DECORATIONS)[number];
+/** CMS-owned saved shapes. `_key` remains the mapper's stable array identity. */
+export type MenuMoney = {
+    readonly minor: number;
+    readonly currency: string;
+};
+export type MenuPrice = {
+    readonly _key: string;
+    readonly amount: MenuMoney;
+    readonly label?: string;
+};
+export type MenuExtra = {
+    readonly _key: string;
+    readonly name: string;
+    readonly amount: MenuMoney;
+};
+export type MenuItem = {
+    readonly _key: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly prices: readonly MenuPrice[];
+    readonly priceNote?: string;
+    readonly extras: readonly MenuExtra[];
+    readonly dietary: readonly string[];
+    readonly allergenNote?: string;
+    readonly availability: "available" | "sold-out" | "hidden";
+};
+export type MenuSection = {
+    readonly _key: string;
+    readonly title: string;
+    readonly service?: string;
+    readonly items: readonly MenuItem[];
+};
+export type MenuVariant = {
+    readonly _key: string;
+    readonly label: string;
+    readonly note?: string;
+    readonly sections: readonly MenuSection[];
+};
+export type MenuDocument = {
+    /** The schema discriminator is required by the consuming site's mapper. */
+    readonly _type: "menu";
+    readonly _id: string;
+    readonly _rev: string;
+    /** The real published update date, preserved verbatim for stale displays. */
+    readonly _updatedAt: string;
+    readonly title: string;
+    readonly locationKeys: readonly string[];
+    readonly variants: readonly MenuVariant[];
+    readonly note?: string;
+    /** Approval is opaque to this reader. The site validates it with its contract. */
+    readonly signOff?: unknown;
+};
+export type MenuSectionInput = {
+    readonly kind: "menu";
+    readonly layout: MenuLayout;
+    readonly decoration: MenuDecoration;
+    readonly menu: MenuDocument;
+};
+/** Uses the same scoped type/id tags as every other CMS query. */
+export declare function menuTags(scope: string, id?: string): readonly string[];
+/** Validate saved field shapes without inferring approval or changing copy/order. */
+export declare function parseMenuDocument(document: unknown, where?: string): MenuDocument;
+/** Page references use the same single snapshot before checking their identity. */
+export declare function parseReferencedMenuDocument(document: unknown, where: string): MenuDocument | null;
+export declare function validMenuFallback(value: unknown): value is MenuDocument | null;

package/dist/portable/sections.d.cts

@@ -2,8 +2,8 @@
  * A-1915 (A-1739 M1c). The reader's half of the shared section set that
  * `@weatherboard/sanity-schema-base` declares in `src/sections.ts` (A-1889):
  * `page.sections[]`, drawn from the four home section types plus
- * `textMediaBlock`, `faqBlock` (items `faqItem`), `galleryBlock` and
- * `contactBlock`.
+ * `textMediaBlock`, `faqBlock` (items `faqItem`), `galleryBlock`,
+ * `contactBlock`, `textItemsBlock`, `stepsBlock` and `linkListBlock`.
  *
  * ===========================================================================
  * LAYOUTS ARE THE A-1876 VARIANT NAMES, EXACTLY
@@ -33,7 +33,8 @@
  *                               whose every photo was dropped, a contact
  *                               section switched off and empty) is skipped
  */
-import type { ActionInput, CompositionBlockInput, CopyInput } from "./site-content.cjs";
+import type { MenuSectionInput } from "./menu.cjs";
+import type { ActionInput, CompositionBlockInput, CopyInput, RichBody } from "./site-content.cjs";
 /** `Split`: text with media. */
 export declare const SPLIT_LAYOUTS: readonly ["media-end", "media-start", "media-below"];
 /** `HeadingList`: a heading column and a list column. */
@@ -59,6 +60,10 @@ export declare const READER_SECTION_KINDS: {
     readonly faqBlock: "faq";
     readonly galleryBlock: "gallery";
     readonly contactBlock: "contact";
+    readonly textItemsBlock: "text_items";
+    readonly stepsBlock: "steps";
+    readonly linkListBlock: "link_list";
+    readonly menuBlock: "menu";
 };
 /** A gallery is a `StaggerRow`, which holds two to four items. */
 export declare const READER_GALLERY_PHOTO_MIN = 2;
@@ -69,6 +74,7 @@ export declare const SECTION_WARNINGS: {
     readonly imageMissingAlt: "section.image.missing-alt";
     readonly imageMissingAsset: "section.image.missing-asset";
     readonly emptySkipped: "section.empty.skipped";
+    readonly menuUnavailable: "section.menu.unavailable";
 };
 export type SectionWarningCode = (typeof SECTION_WARNINGS)[keyof typeof SECTION_WARNINGS];
 /** A named warning and the path in the stored document it is about. Never copy. */
@@ -77,7 +83,10 @@ export type SectionWarning = {
     readonly where: string;
     readonly type: string;
 } | {
-    readonly code: Exclude<SectionWarningCode, typeof SECTION_WARNINGS.unknownType>;
+    readonly code: typeof SECTION_WARNINGS.menuUnavailable;
+    readonly where: string;
+} | {
+    readonly code: Exclude<SectionWarningCode, typeof SECTION_WARNINGS.unknownType | typeof SECTION_WARNINGS.menuUnavailable>;
     readonly where: string;
 };
 /** A Sanity image as a site needs it. `asset` is the image asset's id; `alt` is never empty. */
@@ -105,12 +114,15 @@ export type FaqSectionInput = {
     readonly kind: "faq";
     readonly anchor: string | null;
     readonly layout: HeadingListLayout;
-    readonly heading: CopyInput;
+    readonly heading: CopyInput | null;
     readonly tail: CopyInput | null;
     readonly intro: CopyInput | null;
     readonly items: readonly {
         readonly question: CopyInput;
-        readonly answer: CopyInput;
+        readonly answer: CopyInput | {
+            readonly kind: "rich";
+            readonly body: RichBody;
+        };
     }[];
 };
 export type GallerySectionInput = {
@@ -133,7 +145,38 @@ export type ContactSectionInput = {
     readonly action: ActionInput | null;
     readonly image: SectionImageInput | null;
 };
-export type NewSectionInput = TextMediaSectionInput | FaqSectionInput | GallerySectionInput | ContactSectionInput;
+export type TextItemsSectionInput = {
+    readonly kind: "text_items";
+    readonly anchor: string | null;
+    readonly layout: StaggerRowLayout;
+    readonly items: readonly {
+        readonly title: CopyInput;
+        readonly body: CopyInput;
+    }[];
+};
+export type StepsSectionInput = {
+    readonly kind: "steps";
+    readonly anchor: string | null;
+    readonly layout: HeadingListLayout;
+    readonly heading: CopyInput;
+    readonly intro: CopyInput;
+    readonly items: readonly {
+        readonly title: CopyInput;
+        readonly body: CopyInput;
+    }[];
+};
+export type LinkListSectionInput = {
+    readonly kind: "link_list";
+    readonly anchor: string | null;
+    readonly layout: HeadingListLayout;
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly links: readonly {
+        readonly title: string;
+        readonly href: string;
+    }[];
+};
+export type NewSectionInput = TextMediaSectionInput | FaqSectionInput | GallerySectionInput | ContactSectionInput | TextItemsSectionInput | StepsSectionInput | LinkListSectionInput | MenuSectionInput;
 /** One entry of `PageContent.sections`: a home section kind or one of the new kinds. */
 export type PageSectionInput = Exclude<CompositionBlockInput, {
     readonly kind: "campaign";

package/dist/portable/sections.d.mts

@@ -2,8 +2,8 @@
  * A-1915 (A-1739 M1c). The reader's half of the shared section set that
  * `@weatherboard/sanity-schema-base` declares in `src/sections.ts` (A-1889):
  * `page.sections[]`, drawn from the four home section types plus
- * `textMediaBlock`, `faqBlock` (items `faqItem`), `galleryBlock` and
- * `contactBlock`.
+ * `textMediaBlock`, `faqBlock` (items `faqItem`), `galleryBlock`,
+ * `contactBlock`, `textItemsBlock`, `stepsBlock` and `linkListBlock`.
  *
  * ===========================================================================
  * LAYOUTS ARE THE A-1876 VARIANT NAMES, EXACTLY
@@ -33,7 +33,8 @@
  *                               whose every photo was dropped, a contact
  *                               section switched off and empty) is skipped
  */
-import type { ActionInput, CompositionBlockInput, CopyInput } from "./site-content.mjs";
+import type { MenuSectionInput } from "./menu.mjs";
+import type { ActionInput, CompositionBlockInput, CopyInput, RichBody } from "./site-content.mjs";
 /** `Split`: text with media. */
 export declare const SPLIT_LAYOUTS: readonly ["media-end", "media-start", "media-below"];
 /** `HeadingList`: a heading column and a list column. */
@@ -59,6 +60,10 @@ export declare const READER_SECTION_KINDS: {
     readonly faqBlock: "faq";
     readonly galleryBlock: "gallery";
     readonly contactBlock: "contact";
+    readonly textItemsBlock: "text_items";
+    readonly stepsBlock: "steps";
+    readonly linkListBlock: "link_list";
+    readonly menuBlock: "menu";
 };
 /** A gallery is a `StaggerRow`, which holds two to four items. */
 export declare const READER_GALLERY_PHOTO_MIN = 2;
@@ -69,6 +74,7 @@ export declare const SECTION_WARNINGS: {
     readonly imageMissingAlt: "section.image.missing-alt";
     readonly imageMissingAsset: "section.image.missing-asset";
     readonly emptySkipped: "section.empty.skipped";
+    readonly menuUnavailable: "section.menu.unavailable";
 };
 export type SectionWarningCode = (typeof SECTION_WARNINGS)[keyof typeof SECTION_WARNINGS];
 /** A named warning and the path in the stored document it is about. Never copy. */
@@ -77,7 +83,10 @@ export type SectionWarning = {
     readonly where: string;
     readonly type: string;
 } | {
-    readonly code: Exclude<SectionWarningCode, typeof SECTION_WARNINGS.unknownType>;
+    readonly code: typeof SECTION_WARNINGS.menuUnavailable;
+    readonly where: string;
+} | {
+    readonly code: Exclude<SectionWarningCode, typeof SECTION_WARNINGS.unknownType | typeof SECTION_WARNINGS.menuUnavailable>;
     readonly where: string;
 };
 /** A Sanity image as a site needs it. `asset` is the image asset's id; `alt` is never empty. */
@@ -105,12 +114,15 @@ export type FaqSectionInput = {
     readonly kind: "faq";
     readonly anchor: string | null;
     readonly layout: HeadingListLayout;
-    readonly heading: CopyInput;
+    readonly heading: CopyInput | null;
     readonly tail: CopyInput | null;
     readonly intro: CopyInput | null;
     readonly items: readonly {
         readonly question: CopyInput;
-        readonly answer: CopyInput;
+        readonly answer: CopyInput | {
+            readonly kind: "rich";
+            readonly body: RichBody;
+        };
     }[];
 };
 export type GallerySectionInput = {
@@ -133,7 +145,38 @@ export type ContactSectionInput = {
     readonly action: ActionInput | null;
     readonly image: SectionImageInput | null;
 };
-export type NewSectionInput = TextMediaSectionInput | FaqSectionInput | GallerySectionInput | ContactSectionInput;
+export type TextItemsSectionInput = {
+    readonly kind: "text_items";
+    readonly anchor: string | null;
+    readonly layout: StaggerRowLayout;
+    readonly items: readonly {
+        readonly title: CopyInput;
+        readonly body: CopyInput;
+    }[];
+};
+export type StepsSectionInput = {
+    readonly kind: "steps";
+    readonly anchor: string | null;
+    readonly layout: HeadingListLayout;
+    readonly heading: CopyInput;
+    readonly intro: CopyInput;
+    readonly items: readonly {
+        readonly title: CopyInput;
+        readonly body: CopyInput;
+    }[];
+};
+export type LinkListSectionInput = {
+    readonly kind: "link_list";
+    readonly anchor: string | null;
+    readonly layout: HeadingListLayout;
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly links: readonly {
+        readonly title: string;
+        readonly href: string;
+    }[];
+};
+export type NewSectionInput = TextMediaSectionInput | FaqSectionInput | GallerySectionInput | ContactSectionInput | TextItemsSectionInput | StepsSectionInput | LinkListSectionInput | MenuSectionInput;
 /** One entry of `PageContent.sections`: a home section kind or one of the new kinds. */
 export type PageSectionInput = Exclude<CompositionBlockInput, {
     readonly kind: "campaign";

package/dist/portable/sections.d.ts

@@ -2,8 +2,8 @@
  * A-1915 (A-1739 M1c). The reader's half of the shared section set that
  * `@weatherboard/sanity-schema-base` declares in `src/sections.ts` (A-1889):
  * `page.sections[]`, drawn from the four home section types plus
- * `textMediaBlock`, `faqBlock` (items `faqItem`), `galleryBlock` and
- * `contactBlock`.
+ * `textMediaBlock`, `faqBlock` (items `faqItem`), `galleryBlock`,
+ * `contactBlock`, `textItemsBlock`, `stepsBlock` and `linkListBlock`.
  *
  * ===========================================================================
  * LAYOUTS ARE THE A-1876 VARIANT NAMES, EXACTLY
@@ -33,7 +33,8 @@
  *                               whose every photo was dropped, a contact
  *                               section switched off and empty) is skipped
  */
-import type { ActionInput, CompositionBlockInput, CopyInput } from "./site-content.js";
+import type { MenuSectionInput } from "./menu.js";
+import type { ActionInput, CompositionBlockInput, CopyInput, RichBody } from "./site-content.js";
 /** `Split`: text with media. */
 export declare const SPLIT_LAYOUTS: readonly ["media-end", "media-start", "media-below"];
 /** `HeadingList`: a heading column and a list column. */
@@ -59,6 +60,10 @@ export declare const READER_SECTION_KINDS: {
     readonly faqBlock: "faq";
     readonly galleryBlock: "gallery";
     readonly contactBlock: "contact";
+    readonly textItemsBlock: "text_items";
+    readonly stepsBlock: "steps";
+    readonly linkListBlock: "link_list";
+    readonly menuBlock: "menu";
 };
 /** A gallery is a `StaggerRow`, which holds two to four items. */
 export declare const READER_GALLERY_PHOTO_MIN = 2;
@@ -69,6 +74,7 @@ export declare const SECTION_WARNINGS: {
     readonly imageMissingAlt: "section.image.missing-alt";
     readonly imageMissingAsset: "section.image.missing-asset";
     readonly emptySkipped: "section.empty.skipped";
+    readonly menuUnavailable: "section.menu.unavailable";
 };
 export type SectionWarningCode = (typeof SECTION_WARNINGS)[keyof typeof SECTION_WARNINGS];
 /** A named warning and the path in the stored document it is about. Never copy. */
@@ -77,7 +83,10 @@ export type SectionWarning = {
     readonly where: string;
     readonly type: string;
 } | {
-    readonly code: Exclude<SectionWarningCode, typeof SECTION_WARNINGS.unknownType>;
+    readonly code: typeof SECTION_WARNINGS.menuUnavailable;
+    readonly where: string;
+} | {
+    readonly code: Exclude<SectionWarningCode, typeof SECTION_WARNINGS.unknownType | typeof SECTION_WARNINGS.menuUnavailable>;
     readonly where: string;
 };
 /** A Sanity image as a site needs it. `asset` is the image asset's id; `alt` is never empty. */
@@ -105,12 +114,15 @@ export type FaqSectionInput = {
     readonly kind: "faq";
     readonly anchor: string | null;
     readonly layout: HeadingListLayout;
-    readonly heading: CopyInput;
+    readonly heading: CopyInput | null;
     readonly tail: CopyInput | null;
     readonly intro: CopyInput | null;
     readonly items: readonly {
         readonly question: CopyInput;
-        readonly answer: CopyInput;
+        readonly answer: CopyInput | {
+            readonly kind: "rich";
+            readonly body: RichBody;
+        };
     }[];
 };
 export type GallerySectionInput = {
@@ -133,7 +145,38 @@ export type ContactSectionInput = {
     readonly action: ActionInput | null;
     readonly image: SectionImageInput | null;
 };
-export type NewSectionInput = TextMediaSectionInput | FaqSectionInput | GallerySectionInput | ContactSectionInput;
+export type TextItemsSectionInput = {
+    readonly kind: "text_items";
+    readonly anchor: string | null;
+    readonly layout: StaggerRowLayout;
+    readonly items: readonly {
+        readonly title: CopyInput;
+        readonly body: CopyInput;
+    }[];
+};
+export type StepsSectionInput = {
+    readonly kind: "steps";
+    readonly anchor: string | null;
+    readonly layout: HeadingListLayout;
+    readonly heading: CopyInput;
+    readonly intro: CopyInput;
+    readonly items: readonly {
+        readonly title: CopyInput;
+        readonly body: CopyInput;
+    }[];
+};
+export type LinkListSectionInput = {
+    readonly kind: "link_list";
+    readonly anchor: string | null;
+    readonly layout: HeadingListLayout;
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly links: readonly {
+        readonly title: string;
+        readonly href: string;
+    }[];
+};
+export type NewSectionInput = TextMediaSectionInput | FaqSectionInput | GallerySectionInput | ContactSectionInput | TextItemsSectionInput | StepsSectionInput | LinkListSectionInput | MenuSectionInput;
 /** One entry of `PageContent.sections`: a home section kind or one of the new kinds. */
 export type PageSectionInput = Exclude<CompositionBlockInput, {
     readonly kind: "campaign";

package/dist/portable/site-content.d.cts

@@ -20,9 +20,9 @@
  * anything writing over the API skips them entirely. So every document is
  * checked here again, and a malformed one is refused BY NAME
  * (`MalformedContentError`, code `malformed-content`) listing every problem
- * with its path, rather than rendered half-empty. A page that renders with a
- * missing headline and a page whose content is broken look identical to a
- * visitor; a build that fails naming `hero.headline` does not.
+ * with its path, rather than rendered half-empty. A missing home headline
+ * uses siteHero only when the home document explicitly selects it and that
+ * document supplies a valid heading. Otherwise the home page is refused.
  *
  * Absent is not malformed: `null` from `home()` means nobody has created the
  * home page yet, and a site decides what to do about that.
@@ -60,7 +60,7 @@
  * kinds, the A-1876 layout names and the warning codes.
  *
  * Two places the composition cannot carry a proposed marker: a `cta` block's
- * plain strings, and the campaign's title and body (which travel as Markdown).
+ * plain strings, and the campaign's title and body (which travel as rich body content).
  * There the text is returned plain and the line is still listed in
  * `proposedCopy`, which is the list a dashboard and a site both read for
  * approval. Nothing is dropped silently.
@@ -71,6 +71,30 @@ export type CopyInput = string | {
     readonly text: string;
     readonly copySource: "captured" | "proposed";
 };
+export type RichInline = {
+    readonly children: readonly {
+        readonly text: string;
+        readonly marks: readonly string[];
+    }[];
+    readonly markDefs: readonly {
+        readonly key: string;
+        readonly href: string;
+    }[];
+};
+export type RichBodyPart = {
+    readonly kind: "block";
+    readonly style: "normal" | "h2" | "h3" | "blockquote";
+    readonly listItem: "bullet" | "number" | null;
+    readonly level: number;
+    readonly content: RichInline;
+} | {
+    readonly kind: "heading";
+    readonly text: string;
+} | {
+    readonly kind: "table";
+    readonly rows: readonly (readonly RichInline[])[];
+};
+export type RichBody = string | readonly RichBodyPart[];
 export type ActionInput = {
     readonly label: CopyInput;
     readonly href: string;
@@ -110,12 +134,14 @@ export type CompositionBlockInput = {
 } | {
     readonly kind: "accent_band";
     readonly heading: CopyInput;
+    readonly tail?: CopyInput | null;
     readonly body: CopyInput;
     readonly action: ActionInput | null;
     readonly image: string | null;
 } | {
     readonly kind: "cta";
     readonly heading: string;
+    readonly image?: string | null;
     readonly body: string | null;
     readonly link: {
         readonly label: string;
@@ -136,16 +162,17 @@ export type ProposedCopy = {
 export type CampaignState = "shown" | "off" | "not-started" | "ended" | "none";
 export type HomeContent = {
     readonly composition: CompositionInput;
-    /** The page body as Markdown: the campaign's title and text when it is shown, otherwise empty. */
-    readonly body: string;
+    /** Campaign text as Markdown, or structured blocks and tables when it contains a table. */
+    readonly body: RichBody;
     readonly campaign: CampaignState;
     readonly proposedCopy: readonly ProposedCopy[];
 };
 export type PageContent = {
     readonly slug: string;
     readonly title: string;
+    readonly titleTail?: string;
     readonly composition: CompositionInput;
-    readonly body: string;
+    readonly body: RichBody;
     readonly migrated: boolean;
     readonly proposedCopy: readonly ProposedCopy[];
     /**
@@ -191,8 +218,10 @@ export declare const READER_SITE_SETTINGS_ID = "siteSettings";
  * upload one yet (the dashboard slice decides how), so one arriving means
  * something wrote the document by hand, and a page silently missing a picture
  * is the failure this reader exists to prevent.
+ * Text-only input remains a Markdown string. Input with a table produces
+ * ordered structured blocks and cells that never enter a Markdown parser.
  */
-export declare function portableTextToMarkdown(value: unknown): string;
+export declare function portableTextToMarkdown(value: unknown): RichBody;
 /** Whether a campaign is shown at `now`, and if not, why not. */
 export declare function campaignState(campaign: unknown, now: Date): CampaignState;
 /**
@@ -208,8 +237,10 @@ export declare function parseContentPage(document: unknown): PageContent;
 export declare function parseSiteSettings(document: unknown): SiteSettingsContent;
 /** By fixed id: a second home page at a random id is never read. */
 export declare const HOME_PAGE_DOCUMENT_QUERY = "*[_id == $id][0]";
-export declare const CONTENT_PAGES_QUERY = "*[_type == \"page\" && defined(slug.current)]|order(slug.current asc)";
-export declare const CONTENT_PAGE_BY_SLUG_QUERY = "*[_type == \"page\" && slug.current == $slug][0]";
+/** One snapshot contains both possible headline sources. */
+export declare const HOME_PAGE_WITH_SITE_HERO_QUERY = "*[_id == $id][0]{..., \"_siteHero\": *[_id == \"siteHero\" && _type == \"siteHero\"][0]{heading}}";
+export declare const CONTENT_PAGES_QUERY = "*[_type == \"page\" && defined(slug.current)]|order(slug.current asc){..., \"sections\": coalesce(sections[]{..., _type == \"menuBlock\" => {menu->{_type, _id, _rev, _updatedAt, title, locationKeys, note, signOff,\n  variants[]{_key, label, note, sections[]{_key, title, service, items[]{\n    _key, name, description, priceNote, dietary, allergenNote, availability,\n    prices[]{_key, label, amount{minor, currency}}, extras[]{_key, name, amount{minor, currency}}\n  }}}}}, _type == \"linkListBlock\" => {links[]{..., \"page\": page->{title, \"slug\": slug.current}}}}, sections)}";
+export declare const CONTENT_PAGE_BY_SLUG_QUERY = "*[_type == \"page\" && slug.current == $slug][0]{..., \"sections\": coalesce(sections[]{..., _type == \"menuBlock\" => {menu->{_type, _id, _rev, _updatedAt, title, locationKeys, note, signOff,\n  variants[]{_key, label, note, sections[]{_key, title, service, items[]{\n    _key, name, description, priceNote, dietary, allergenNote, availability,\n    prices[]{_key, label, amount{minor, currency}}, extras[]{_key, name, amount{minor, currency}}\n  }}}}}, _type == \"linkListBlock\" => {links[]{..., \"page\": page->{title, \"slug\": slug.current}}}}, sections)}";
 export interface SiteContentReader {
     /** `null` when no home page document exists yet. */
     home: (options: {

package/dist/portable/site-content.d.mts

@@ -20,9 +20,9 @@
  * anything writing over the API skips them entirely. So every document is
  * checked here again, and a malformed one is refused BY NAME
  * (`MalformedContentError`, code `malformed-content`) listing every problem
- * with its path, rather than rendered half-empty. A page that renders with a
- * missing headline and a page whose content is broken look identical to a
- * visitor; a build that fails naming `hero.headline` does not.
+ * with its path, rather than rendered half-empty. A missing home headline
+ * uses siteHero only when the home document explicitly selects it and that
+ * document supplies a valid heading. Otherwise the home page is refused.
  *
  * Absent is not malformed: `null` from `home()` means nobody has created the
  * home page yet, and a site decides what to do about that.
@@ -60,7 +60,7 @@
  * kinds, the A-1876 layout names and the warning codes.
  *
  * Two places the composition cannot carry a proposed marker: a `cta` block's
- * plain strings, and the campaign's title and body (which travel as Markdown).
+ * plain strings, and the campaign's title and body (which travel as rich body content).
  * There the text is returned plain and the line is still listed in
  * `proposedCopy`, which is the list a dashboard and a site both read for
  * approval. Nothing is dropped silently.
@@ -71,6 +71,30 @@ export type CopyInput = string | {
     readonly text: string;
     readonly copySource: "captured" | "proposed";
 };
+export type RichInline = {
+    readonly children: readonly {
+        readonly text: string;
+        readonly marks: readonly string[];
+    }[];
+    readonly markDefs: readonly {
+        readonly key: string;
+        readonly href: string;
+    }[];
+};
+export type RichBodyPart = {
+    readonly kind: "block";
+    readonly style: "normal" | "h2" | "h3" | "blockquote";
+    readonly listItem: "bullet" | "number" | null;
+    readonly level: number;
+    readonly content: RichInline;
+} | {
+    readonly kind: "heading";
+    readonly text: string;
+} | {
+    readonly kind: "table";
+    readonly rows: readonly (readonly RichInline[])[];
+};
+export type RichBody = string | readonly RichBodyPart[];
 export type ActionInput = {
     readonly label: CopyInput;
     readonly href: string;
@@ -110,12 +134,14 @@ export type CompositionBlockInput = {
 } | {
     readonly kind: "accent_band";
     readonly heading: CopyInput;
+    readonly tail?: CopyInput | null;
     readonly body: CopyInput;
     readonly action: ActionInput | null;
     readonly image: string | null;
 } | {
     readonly kind: "cta";
     readonly heading: string;
+    readonly image?: string | null;
     readonly body: string | null;
     readonly link: {
         readonly label: string;
@@ -136,16 +162,17 @@ export type ProposedCopy = {
 export type CampaignState = "shown" | "off" | "not-started" | "ended" | "none";
 export type HomeContent = {
     readonly composition: CompositionInput;
-    /** The page body as Markdown: the campaign's title and text when it is shown, otherwise empty. */
-    readonly body: string;
+    /** Campaign text as Markdown, or structured blocks and tables when it contains a table. */
+    readonly body: RichBody;
     readonly campaign: CampaignState;
     readonly proposedCopy: readonly ProposedCopy[];
 };
 export type PageContent = {
     readonly slug: string;
     readonly title: string;
+    readonly titleTail?: string;
     readonly composition: CompositionInput;
-    readonly body: string;
+    readonly body: RichBody;
     readonly migrated: boolean;
     readonly proposedCopy: readonly ProposedCopy[];
     /**
@@ -191,8 +218,10 @@ export declare const READER_SITE_SETTINGS_ID = "siteSettings";
  * upload one yet (the dashboard slice decides how), so one arriving means
  * something wrote the document by hand, and a page silently missing a picture
  * is the failure this reader exists to prevent.
+ * Text-only input remains a Markdown string. Input with a table produces
+ * ordered structured blocks and cells that never enter a Markdown parser.
  */
-export declare function portableTextToMarkdown(value: unknown): string;
+export declare function portableTextToMarkdown(value: unknown): RichBody;
 /** Whether a campaign is shown at `now`, and if not, why not. */
 export declare function campaignState(campaign: unknown, now: Date): CampaignState;
 /**
@@ -208,8 +237,10 @@ export declare function parseContentPage(document: unknown): PageContent;
 export declare function parseSiteSettings(document: unknown): SiteSettingsContent;
 /** By fixed id: a second home page at a random id is never read. */
 export declare const HOME_PAGE_DOCUMENT_QUERY = "*[_id == $id][0]";
-export declare const CONTENT_PAGES_QUERY = "*[_type == \"page\" && defined(slug.current)]|order(slug.current asc)";
-export declare const CONTENT_PAGE_BY_SLUG_QUERY = "*[_type == \"page\" && slug.current == $slug][0]";
+/** One snapshot contains both possible headline sources. */
+export declare const HOME_PAGE_WITH_SITE_HERO_QUERY = "*[_id == $id][0]{..., \"_siteHero\": *[_id == \"siteHero\" && _type == \"siteHero\"][0]{heading}}";
+export declare const CONTENT_PAGES_QUERY = "*[_type == \"page\" && defined(slug.current)]|order(slug.current asc){..., \"sections\": coalesce(sections[]{..., _type == \"menuBlock\" => {menu->{_type, _id, _rev, _updatedAt, title, locationKeys, note, signOff,\n  variants[]{_key, label, note, sections[]{_key, title, service, items[]{\n    _key, name, description, priceNote, dietary, allergenNote, availability,\n    prices[]{_key, label, amount{minor, currency}}, extras[]{_key, name, amount{minor, currency}}\n  }}}}}, _type == \"linkListBlock\" => {links[]{..., \"page\": page->{title, \"slug\": slug.current}}}}, sections)}";
+export declare const CONTENT_PAGE_BY_SLUG_QUERY = "*[_type == \"page\" && slug.current == $slug][0]{..., \"sections\": coalesce(sections[]{..., _type == \"menuBlock\" => {menu->{_type, _id, _rev, _updatedAt, title, locationKeys, note, signOff,\n  variants[]{_key, label, note, sections[]{_key, title, service, items[]{\n    _key, name, description, priceNote, dietary, allergenNote, availability,\n    prices[]{_key, label, amount{minor, currency}}, extras[]{_key, name, amount{minor, currency}}\n  }}}}}, _type == \"linkListBlock\" => {links[]{..., \"page\": page->{title, \"slug\": slug.current}}}}, sections)}";
 export interface SiteContentReader {
     /** `null` when no home page document exists yet. */
     home: (options: {