@weatherboard/cms 0.2.0 → 0.3.0

package/README.md

@@ -50,6 +50,57 @@ const resolved = parseSiteHero({
 }, fallback);
 ```
 
+## Page sections (0.3.0)
+
+`parseContentPage` (and `contentPageQuery`, `contentPagesQuery`) read the
+optional `page.sections[]` that `@weatherboard/sanity-schema-base` declares
+(A-1889). Each entry maps to a `kind`, listed in `READER_SECTION_KINDS`:
+
+| Sanity `_type` | `kind` | composition | default layout |
+| --- | --- | --- | --- |
+| `featureStoriesBlock`, `surfaceCardBlock`, `accentBandBlock`, `locationsBlock` | `feature_stories`, `cta`, `accent_band`, `locations` | none | none |
+| `textMediaBlock` | `text_media` | Split | `media-end` |
+| `faqBlock` (items `faqItem`) | `faq` | HeadingList | `beside` |
+| `galleryBlock` | `gallery` | StaggerRow | `staggered` |
+| `contactBlock` | `contact` | Split | `media-end` |
+
+The four home kinds read exactly as they do on the home page. The new kinds
+return every key, `null` where there is nothing, with images as
+`SectionImageInput` (`asset` id, `alt`, `caption`, `hotspot` `{ x, y }`).
+
+The layout values are the A-1876 variant names, exported as `SPLIT_LAYOUTS`
+(`media-end`, `media-start`, `media-below`), `HEADING_LIST_LAYOUTS` (`beside`,
+`stacked`) and `STAGGER_ROW_LAYOUTS` (`staggered`, `aligned`), with the defaults
+in `SECTION_LAYOUT_DEFAULTS`. A later contract test can compare them with the UI
+package's lists.
+
+`PageContent.sections` and `PageContent.warnings` are present only when the
+stored page has a `sections` list, so a page without one reads exactly as it did
+in 0.2.0. Each warning is `{ code, where }`, a code from `SECTION_WARNINGS` and
+the path in the stored document, never copy:
+
+- `section.layout.defaulted`: missing or unknown `layout`; the composition
+  default renders. It never throws and never yields an empty section.
+- `section.type.unknown`: a section `_type` this reader does not know is
+  skipped; the rest of the page reads.
+- `section.image.missing-alt`: an image without alt text is dropped, never
+  returned without it. `text_media.image` is then `null`; a gallery keeps its
+  other photos.
+- `section.image.missing-asset`: an image with no uploaded asset is dropped.
+- `section.empty.skipped`: a gallery whose every photo was dropped, or a contact
+  section with email, phone, text and button all off, is skipped.
+
+Everything else stays a named refusal, as for the rest of the reader: missing
+required copy, a FAQ with no questions, a gallery outside 2 to 4 photos, a
+repeated jump link or a button jumping to a section that is not on the page
+throws `MalformedContentError` naming the path. Page fallbacks that carry
+`sections` are validated against the same kinds.
+
+The warnings travel in the page data, not in the server reader's
+`CmsResolution.warnings`, which still names only the hero warning.
+
+0.3.0 is an additive minor under the pilot semver policy: a new reader kind.
+
 ## Schema and release delivery
 
 `@weatherboard/sanity-schema-base` derives the hero schema from these rules:

package/dist/portable/sections.d.cts

@@ -0,0 +1,136 @@
+/**
+ * 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`.
+ *
+ * ===========================================================================
+ * LAYOUTS ARE THE A-1876 VARIANT NAMES, EXACTLY
+ * ===========================================================================
+ *
+ * The three lists below are the composition variant names, spelled as A-1876
+ * spells them, so a contract test can import them and compare them with the
+ * UI package's. A missing or unknown stored `layout` resolves to the
+ * composition's default and records `section.layout.defaulted`, the rule cms
+ * 0.2.0 set for `siteHero.layout`. It never throws and never yields an empty
+ * section.
+ *
+ * ===========================================================================
+ * WARNINGS, NOT REFUSALS, FOR THREE THINGS
+ * ===========================================================================
+ *
+ * The rest of this reader refuses a malformed document by name. Three things
+ * in a section are warnings instead, each recorded with its path:
+ *
+ *   section.layout.defaulted    missing or unknown layout: the default renders
+ *   section.type.unknown        a section `_type` this reader does not know is
+ *                               skipped, so a newer model never breaks a page
+ *   section.image.missing-alt   an image without alt text is DROPPED, never
+ *                               rendered without it
+ *   section.image.missing-asset an image with no uploaded asset is dropped
+ *   section.empty.skipped       a section left with nothing to show (a gallery
+ *                               whose every photo was dropped, a contact
+ *                               section switched off and empty) is skipped
+ */
+import type { ActionInput, CompositionBlockInput, CopyInput } 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. */
+export declare const HEADING_LIST_LAYOUTS: readonly ["beside", "stacked"];
+/** `StaggerRow`: a row of two to four items. */
+export declare const STAGGER_ROW_LAYOUTS: readonly ["staggered", "aligned"];
+export type SplitLayout = (typeof SPLIT_LAYOUTS)[number];
+export type HeadingListLayout = (typeof HEADING_LIST_LAYOUTS)[number];
+export type StaggerRowLayout = (typeof STAGGER_ROW_LAYOUTS)[number];
+/** What a missing or unknown `layout` resolves to, per composition. */
+export declare const SECTION_LAYOUT_DEFAULTS: {
+    readonly Split: "media-end";
+    readonly HeadingList: "beside";
+    readonly StaggerRow: "staggered";
+};
+/** Sanity `_type` on the left, the reader's `kind` on the right; the same rows as schema-base's `SECTION_CONTRACTS`. */
+export declare const READER_SECTION_KINDS: {
+    readonly featureStoriesBlock: "feature_stories";
+    readonly surfaceCardBlock: "cta";
+    readonly accentBandBlock: "accent_band";
+    readonly locationsBlock: "locations";
+    readonly textMediaBlock: "text_media";
+    readonly faqBlock: "faq";
+    readonly galleryBlock: "gallery";
+    readonly contactBlock: "contact";
+};
+/** A gallery is a `StaggerRow`, which holds two to four items. */
+export declare const READER_GALLERY_PHOTO_MIN = 2;
+export declare const READER_GALLERY_PHOTO_LIMIT = 4;
+export declare const SECTION_WARNINGS: {
+    readonly layoutDefaulted: "section.layout.defaulted";
+    readonly unknownType: "section.type.unknown";
+    readonly imageMissingAlt: "section.image.missing-alt";
+    readonly imageMissingAsset: "section.image.missing-asset";
+    readonly emptySkipped: "section.empty.skipped";
+};
+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. */
+export type SectionWarning = {
+    readonly code: SectionWarningCode;
+    readonly where: string;
+};
+/** A Sanity image as a site needs it. `asset` is the image asset's id; `alt` is never empty. */
+export type SectionImageInput = {
+    readonly asset: string;
+    readonly alt: string;
+    readonly caption: string | null;
+    readonly hotspot: {
+        readonly x: number;
+        readonly y: number;
+    } | null;
+};
+export type TextMediaSectionInput = {
+    readonly kind: "text_media";
+    readonly anchor: string | null;
+    readonly layout: SplitLayout;
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly body: CopyInput;
+    readonly action: ActionInput | null;
+    /** `null` only when the stored photo was dropped (no alt text or no asset); a warning names it. */
+    readonly image: SectionImageInput | null;
+};
+export type FaqSectionInput = {
+    readonly kind: "faq";
+    readonly anchor: string | null;
+    readonly layout: HeadingListLayout;
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly intro: CopyInput | null;
+    readonly items: readonly {
+        readonly question: CopyInput;
+        readonly answer: CopyInput;
+    }[];
+};
+export type GallerySectionInput = {
+    readonly kind: "gallery";
+    readonly anchor: string | null;
+    readonly layout: StaggerRowLayout;
+    readonly heading: CopyInput | null;
+    readonly images: readonly SectionImageInput[];
+};
+export type ContactSectionInput = {
+    readonly kind: "contact";
+    readonly anchor: string | null;
+    readonly layout: SplitLayout;
+    readonly heading: CopyInput;
+    readonly body: CopyInput | null;
+    /** Show the site settings' email address. */
+    readonly showEmail: boolean;
+    /** Show the site settings' phone number. */
+    readonly showPhone: boolean;
+    readonly action: ActionInput | null;
+    readonly image: SectionImageInput | null;
+};
+export type NewSectionInput = TextMediaSectionInput | FaqSectionInput | GallerySectionInput | ContactSectionInput;
+/** One entry of `PageContent.sections`: a home section kind or one of the new kinds. */
+export type PageSectionInput = Exclude<CompositionBlockInput, {
+    readonly kind: "campaign";
+}> | NewSectionInput;

package/dist/portable/sections.d.mts

@@ -0,0 +1,136 @@
+/**
+ * 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`.
+ *
+ * ===========================================================================
+ * LAYOUTS ARE THE A-1876 VARIANT NAMES, EXACTLY
+ * ===========================================================================
+ *
+ * The three lists below are the composition variant names, spelled as A-1876
+ * spells them, so a contract test can import them and compare them with the
+ * UI package's. A missing or unknown stored `layout` resolves to the
+ * composition's default and records `section.layout.defaulted`, the rule cms
+ * 0.2.0 set for `siteHero.layout`. It never throws and never yields an empty
+ * section.
+ *
+ * ===========================================================================
+ * WARNINGS, NOT REFUSALS, FOR THREE THINGS
+ * ===========================================================================
+ *
+ * The rest of this reader refuses a malformed document by name. Three things
+ * in a section are warnings instead, each recorded with its path:
+ *
+ *   section.layout.defaulted    missing or unknown layout: the default renders
+ *   section.type.unknown        a section `_type` this reader does not know is
+ *                               skipped, so a newer model never breaks a page
+ *   section.image.missing-alt   an image without alt text is DROPPED, never
+ *                               rendered without it
+ *   section.image.missing-asset an image with no uploaded asset is dropped
+ *   section.empty.skipped       a section left with nothing to show (a gallery
+ *                               whose every photo was dropped, a contact
+ *                               section switched off and empty) is skipped
+ */
+import type { ActionInput, CompositionBlockInput, CopyInput } 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. */
+export declare const HEADING_LIST_LAYOUTS: readonly ["beside", "stacked"];
+/** `StaggerRow`: a row of two to four items. */
+export declare const STAGGER_ROW_LAYOUTS: readonly ["staggered", "aligned"];
+export type SplitLayout = (typeof SPLIT_LAYOUTS)[number];
+export type HeadingListLayout = (typeof HEADING_LIST_LAYOUTS)[number];
+export type StaggerRowLayout = (typeof STAGGER_ROW_LAYOUTS)[number];
+/** What a missing or unknown `layout` resolves to, per composition. */
+export declare const SECTION_LAYOUT_DEFAULTS: {
+    readonly Split: "media-end";
+    readonly HeadingList: "beside";
+    readonly StaggerRow: "staggered";
+};
+/** Sanity `_type` on the left, the reader's `kind` on the right; the same rows as schema-base's `SECTION_CONTRACTS`. */
+export declare const READER_SECTION_KINDS: {
+    readonly featureStoriesBlock: "feature_stories";
+    readonly surfaceCardBlock: "cta";
+    readonly accentBandBlock: "accent_band";
+    readonly locationsBlock: "locations";
+    readonly textMediaBlock: "text_media";
+    readonly faqBlock: "faq";
+    readonly galleryBlock: "gallery";
+    readonly contactBlock: "contact";
+};
+/** A gallery is a `StaggerRow`, which holds two to four items. */
+export declare const READER_GALLERY_PHOTO_MIN = 2;
+export declare const READER_GALLERY_PHOTO_LIMIT = 4;
+export declare const SECTION_WARNINGS: {
+    readonly layoutDefaulted: "section.layout.defaulted";
+    readonly unknownType: "section.type.unknown";
+    readonly imageMissingAlt: "section.image.missing-alt";
+    readonly imageMissingAsset: "section.image.missing-asset";
+    readonly emptySkipped: "section.empty.skipped";
+};
+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. */
+export type SectionWarning = {
+    readonly code: SectionWarningCode;
+    readonly where: string;
+};
+/** A Sanity image as a site needs it. `asset` is the image asset's id; `alt` is never empty. */
+export type SectionImageInput = {
+    readonly asset: string;
+    readonly alt: string;
+    readonly caption: string | null;
+    readonly hotspot: {
+        readonly x: number;
+        readonly y: number;
+    } | null;
+};
+export type TextMediaSectionInput = {
+    readonly kind: "text_media";
+    readonly anchor: string | null;
+    readonly layout: SplitLayout;
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly body: CopyInput;
+    readonly action: ActionInput | null;
+    /** `null` only when the stored photo was dropped (no alt text or no asset); a warning names it. */
+    readonly image: SectionImageInput | null;
+};
+export type FaqSectionInput = {
+    readonly kind: "faq";
+    readonly anchor: string | null;
+    readonly layout: HeadingListLayout;
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly intro: CopyInput | null;
+    readonly items: readonly {
+        readonly question: CopyInput;
+        readonly answer: CopyInput;
+    }[];
+};
+export type GallerySectionInput = {
+    readonly kind: "gallery";
+    readonly anchor: string | null;
+    readonly layout: StaggerRowLayout;
+    readonly heading: CopyInput | null;
+    readonly images: readonly SectionImageInput[];
+};
+export type ContactSectionInput = {
+    readonly kind: "contact";
+    readonly anchor: string | null;
+    readonly layout: SplitLayout;
+    readonly heading: CopyInput;
+    readonly body: CopyInput | null;
+    /** Show the site settings' email address. */
+    readonly showEmail: boolean;
+    /** Show the site settings' phone number. */
+    readonly showPhone: boolean;
+    readonly action: ActionInput | null;
+    readonly image: SectionImageInput | null;
+};
+export type NewSectionInput = TextMediaSectionInput | FaqSectionInput | GallerySectionInput | ContactSectionInput;
+/** One entry of `PageContent.sections`: a home section kind or one of the new kinds. */
+export type PageSectionInput = Exclude<CompositionBlockInput, {
+    readonly kind: "campaign";
+}> | NewSectionInput;

package/dist/portable/sections.d.ts

@@ -0,0 +1,136 @@
+/**
+ * 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`.
+ *
+ * ===========================================================================
+ * LAYOUTS ARE THE A-1876 VARIANT NAMES, EXACTLY
+ * ===========================================================================
+ *
+ * The three lists below are the composition variant names, spelled as A-1876
+ * spells them, so a contract test can import them and compare them with the
+ * UI package's. A missing or unknown stored `layout` resolves to the
+ * composition's default and records `section.layout.defaulted`, the rule cms
+ * 0.2.0 set for `siteHero.layout`. It never throws and never yields an empty
+ * section.
+ *
+ * ===========================================================================
+ * WARNINGS, NOT REFUSALS, FOR THREE THINGS
+ * ===========================================================================
+ *
+ * The rest of this reader refuses a malformed document by name. Three things
+ * in a section are warnings instead, each recorded with its path:
+ *
+ *   section.layout.defaulted    missing or unknown layout: the default renders
+ *   section.type.unknown        a section `_type` this reader does not know is
+ *                               skipped, so a newer model never breaks a page
+ *   section.image.missing-alt   an image without alt text is DROPPED, never
+ *                               rendered without it
+ *   section.image.missing-asset an image with no uploaded asset is dropped
+ *   section.empty.skipped       a section left with nothing to show (a gallery
+ *                               whose every photo was dropped, a contact
+ *                               section switched off and empty) is skipped
+ */
+import type { ActionInput, CompositionBlockInput, CopyInput } 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. */
+export declare const HEADING_LIST_LAYOUTS: readonly ["beside", "stacked"];
+/** `StaggerRow`: a row of two to four items. */
+export declare const STAGGER_ROW_LAYOUTS: readonly ["staggered", "aligned"];
+export type SplitLayout = (typeof SPLIT_LAYOUTS)[number];
+export type HeadingListLayout = (typeof HEADING_LIST_LAYOUTS)[number];
+export type StaggerRowLayout = (typeof STAGGER_ROW_LAYOUTS)[number];
+/** What a missing or unknown `layout` resolves to, per composition. */
+export declare const SECTION_LAYOUT_DEFAULTS: {
+    readonly Split: "media-end";
+    readonly HeadingList: "beside";
+    readonly StaggerRow: "staggered";
+};
+/** Sanity `_type` on the left, the reader's `kind` on the right; the same rows as schema-base's `SECTION_CONTRACTS`. */
+export declare const READER_SECTION_KINDS: {
+    readonly featureStoriesBlock: "feature_stories";
+    readonly surfaceCardBlock: "cta";
+    readonly accentBandBlock: "accent_band";
+    readonly locationsBlock: "locations";
+    readonly textMediaBlock: "text_media";
+    readonly faqBlock: "faq";
+    readonly galleryBlock: "gallery";
+    readonly contactBlock: "contact";
+};
+/** A gallery is a `StaggerRow`, which holds two to four items. */
+export declare const READER_GALLERY_PHOTO_MIN = 2;
+export declare const READER_GALLERY_PHOTO_LIMIT = 4;
+export declare const SECTION_WARNINGS: {
+    readonly layoutDefaulted: "section.layout.defaulted";
+    readonly unknownType: "section.type.unknown";
+    readonly imageMissingAlt: "section.image.missing-alt";
+    readonly imageMissingAsset: "section.image.missing-asset";
+    readonly emptySkipped: "section.empty.skipped";
+};
+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. */
+export type SectionWarning = {
+    readonly code: SectionWarningCode;
+    readonly where: string;
+};
+/** A Sanity image as a site needs it. `asset` is the image asset's id; `alt` is never empty. */
+export type SectionImageInput = {
+    readonly asset: string;
+    readonly alt: string;
+    readonly caption: string | null;
+    readonly hotspot: {
+        readonly x: number;
+        readonly y: number;
+    } | null;
+};
+export type TextMediaSectionInput = {
+    readonly kind: "text_media";
+    readonly anchor: string | null;
+    readonly layout: SplitLayout;
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly body: CopyInput;
+    readonly action: ActionInput | null;
+    /** `null` only when the stored photo was dropped (no alt text or no asset); a warning names it. */
+    readonly image: SectionImageInput | null;
+};
+export type FaqSectionInput = {
+    readonly kind: "faq";
+    readonly anchor: string | null;
+    readonly layout: HeadingListLayout;
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly intro: CopyInput | null;
+    readonly items: readonly {
+        readonly question: CopyInput;
+        readonly answer: CopyInput;
+    }[];
+};
+export type GallerySectionInput = {
+    readonly kind: "gallery";
+    readonly anchor: string | null;
+    readonly layout: StaggerRowLayout;
+    readonly heading: CopyInput | null;
+    readonly images: readonly SectionImageInput[];
+};
+export type ContactSectionInput = {
+    readonly kind: "contact";
+    readonly anchor: string | null;
+    readonly layout: SplitLayout;
+    readonly heading: CopyInput;
+    readonly body: CopyInput | null;
+    /** Show the site settings' email address. */
+    readonly showEmail: boolean;
+    /** Show the site settings' phone number. */
+    readonly showPhone: boolean;
+    readonly action: ActionInput | null;
+    readonly image: SectionImageInput | null;
+};
+export type NewSectionInput = TextMediaSectionInput | FaqSectionInput | GallerySectionInput | ContactSectionInput;
+/** One entry of `PageContent.sections`: a home section kind or one of the new kinds. */
+export type PageSectionInput = Exclude<CompositionBlockInput, {
+    readonly kind: "campaign";
+}> | NewSectionInput;

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

@@ -54,6 +54,11 @@
  *   accentBandBlock                     kind `accent_band`
  *   locationsBlock                      kind `locations` (jumpLink → anchor)
  *
+ * A content page's `sections[]` (A-1915) reads those four kinds plus
+ * `text_media`, `faq`, `gallery` and `contact` into `PageContent.sections`,
+ * with their named warnings in `PageContent.warnings`. `sections.ts` holds the
+ * 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).
  * There the text is returned plain and the line is still listed in
@@ -61,6 +66,7 @@
  * approval. Nothing is dropped silently.
  */
 import { type CmsQuery } from "../contracts/query.cjs";
+import { type PageSectionInput, type SectionWarning } from "./sections.cjs";
 export type CopyInput = string | {
     readonly text: string;
     readonly copySource: "captured" | "proposed";
@@ -142,6 +148,13 @@ export type PageContent = {
     readonly body: string;
     readonly migrated: boolean;
     readonly proposedCopy: readonly ProposedCopy[];
+    /**
+     * A-1915. Present only when the stored page has a `sections` list, so a page
+     * written before sections existed reads exactly as it did in 0.2.0.
+     */
+    readonly sections?: readonly PageSectionInput[];
+    /** A-1915. Present with `sections`: every named section warning, with its path. */
+    readonly warnings?: readonly SectionWarning[];
 };
 export type SiteSettingsContent = {
     readonly name: string;

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

@@ -54,6 +54,11 @@
  *   accentBandBlock                     kind `accent_band`
  *   locationsBlock                      kind `locations` (jumpLink → anchor)
  *
+ * A content page's `sections[]` (A-1915) reads those four kinds plus
+ * `text_media`, `faq`, `gallery` and `contact` into `PageContent.sections`,
+ * with their named warnings in `PageContent.warnings`. `sections.ts` holds the
+ * 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).
  * There the text is returned plain and the line is still listed in
@@ -61,6 +66,7 @@
  * approval. Nothing is dropped silently.
  */
 import { type CmsQuery } from "../contracts/query.mjs";
+import { type PageSectionInput, type SectionWarning } from "./sections.mjs";
 export type CopyInput = string | {
     readonly text: string;
     readonly copySource: "captured" | "proposed";
@@ -142,6 +148,13 @@ export type PageContent = {
     readonly body: string;
     readonly migrated: boolean;
     readonly proposedCopy: readonly ProposedCopy[];
+    /**
+     * A-1915. Present only when the stored page has a `sections` list, so a page
+     * written before sections existed reads exactly as it did in 0.2.0.
+     */
+    readonly sections?: readonly PageSectionInput[];
+    /** A-1915. Present with `sections`: every named section warning, with its path. */
+    readonly warnings?: readonly SectionWarning[];
 };
 export type SiteSettingsContent = {
     readonly name: string;

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

@@ -54,6 +54,11 @@
  *   accentBandBlock                     kind `accent_band`
  *   locationsBlock                      kind `locations` (jumpLink → anchor)
  *
+ * A content page's `sections[]` (A-1915) reads those four kinds plus
+ * `text_media`, `faq`, `gallery` and `contact` into `PageContent.sections`,
+ * with their named warnings in `PageContent.warnings`. `sections.ts` holds the
+ * 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).
  * There the text is returned plain and the line is still listed in
@@ -61,6 +66,7 @@
  * approval. Nothing is dropped silently.
  */
 import { type CmsQuery } from "../contracts/query.js";
+import { type PageSectionInput, type SectionWarning } from "./sections.js";
 export type CopyInput = string | {
     readonly text: string;
     readonly copySource: "captured" | "proposed";
@@ -142,6 +148,13 @@ export type PageContent = {
     readonly body: string;
     readonly migrated: boolean;
     readonly proposedCopy: readonly ProposedCopy[];
+    /**
+     * A-1915. Present only when the stored page has a `sections` list, so a page
+     * written before sections existed reads exactly as it did in 0.2.0.
+     */
+    readonly sections?: readonly PageSectionInput[];
+    /** A-1915. Present with `sections`: every named section warning, with its path. */
+    readonly warnings?: readonly SectionWarning[];
 };
 export type SiteSettingsContent = {
     readonly name: string;