@weatherboard/cms 0.0.0-stage → 0.2.0

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

@@ -0,0 +1,220 @@
+/**
+ * A-1713. The site content model, read: the home page, content pages and site
+ * settings, validated on read and returned in the shape a site's page
+ * composition consumes.
+ *
+ * ===========================================================================
+ * READ ONLY, BY CONSTRUCTION
+ * ===========================================================================
+ *
+ * A client site reads its content with a read-only token. All editing goes
+ * through the studio's dashboard, which writes to Sanity; nothing on a client
+ * site writes, and this module has no write path to call. It is handed a
+ * `ContentClient` (a `query` function) and nothing else.
+ *
+ * ===========================================================================
+ * VALIDATED ON READ, BECAUSE SANITY VALIDATION ONLY ADVISES
+ * ===========================================================================
+ *
+ * The schema's rules warn an editor; they do not refuse a publish, and
+ * 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.
+ *
+ * Absent is not malformed: `null` from `home()` means nobody has created the
+ * home page yet, and a site decides what to do about that.
+ *
+ * ===========================================================================
+ * THE SHAPE IT RETURNS
+ * ===========================================================================
+ *
+ * The INPUT shape of a site's composition schema (the reference build's
+ * frontmatter): a copy value is a plain string for the client's own words
+ * with no claim about their source, `{ text, copySource: "captured" }` for
+ * words claimed verbatim from the capture (the site checks every such claim
+ * against its capture evidence, so the claim must survive Sanity), and
+ * `{ text, copySource: "proposed" }` for studio-written words awaiting
+ * approval. All three round-trip exactly; a photo is its library slug; every key a block declares is
+ * present, `null` where there is nothing. So a site validates this with the
+ * same schema it validates its Markdown frontmatter with, and its components
+ * never know where the content came from.
+ *
+ * Mapping from the generic model to the composition's names:
+ *
+ *   hero.headline / subline / lead      hero.heading / subline / intro
+ *   hero.photos[0], [1]                 hero.image, hero.inset
+ *   hero.primaryAction / secondary...   hero.cta / secondaryCta
+ *   campaign (when shown)               the FIRST block, kind `campaign`, and
+ *                                       the page body (`# title` + its text)
+ *   featureStoriesBlock                 kind `feature_stories`
+ *   surfaceCardBlock                    kind `cta`
+ *   accentBandBlock                     kind `accent_band`
+ *   locationsBlock                      kind `locations` (jumpLink → anchor)
+ *
+ * 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
+ * `proposedCopy`, which is the list a dashboard and a site both read for
+ * approval. Nothing is dropped silently.
+ */
+import { type CmsQuery } from "../contracts/query.cjs";
+export type CopyInput = string | {
+    readonly text: string;
+    readonly copySource: "captured" | "proposed";
+};
+export type ActionInput = {
+    readonly label: CopyInput;
+    readonly href: string;
+};
+export type HeroInput = {
+    readonly heading: CopyInput;
+    readonly subline: CopyInput | null;
+    readonly intro: CopyInput | null;
+    readonly image: string | null;
+    readonly inset: string | null;
+    readonly cta: ActionInput | null;
+    readonly secondaryCta: ActionInput | null;
+};
+export type StoryInput = {
+    readonly heading: CopyInput;
+    readonly body: CopyInput;
+    readonly action: ActionInput;
+    readonly image: string | null;
+    readonly shape: "wide" | "tall" | "round" | "free";
+    readonly card: boolean;
+};
+export type CompositionBlockInput = {
+    readonly kind: "campaign";
+    readonly action: ActionInput | null;
+    readonly images: readonly string[];
+} | {
+    readonly kind: "locations";
+    readonly anchor: string | null;
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly image: string | null;
+} | {
+    readonly kind: "feature_stories";
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly items: readonly StoryInput[];
+} | {
+    readonly kind: "accent_band";
+    readonly heading: CopyInput;
+    readonly body: CopyInput;
+    readonly action: ActionInput | null;
+    readonly image: string | null;
+} | {
+    readonly kind: "cta";
+    readonly heading: string;
+    readonly body: string | null;
+    readonly link: {
+        readonly label: string;
+        readonly href: string;
+    };
+};
+export type CompositionInput = {
+    readonly intro: string | null;
+    readonly photo: string | null;
+    readonly hero: HeroInput | null;
+    readonly blocks: readonly CompositionBlockInput[];
+};
+/** One line of studio-written copy awaiting approval, and where it is in the document. */
+export type ProposedCopy = {
+    readonly where: string;
+    readonly text: string;
+};
+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;
+    readonly campaign: CampaignState;
+    readonly proposedCopy: readonly ProposedCopy[];
+};
+export type PageContent = {
+    readonly slug: string;
+    readonly title: string;
+    readonly composition: CompositionInput;
+    readonly body: string;
+    readonly migrated: boolean;
+    readonly proposedCopy: readonly ProposedCopy[];
+};
+export type SiteSettingsContent = {
+    readonly name: string;
+    readonly description: string | null;
+    readonly contact: {
+        readonly email: string | null;
+        readonly phone: string | null;
+    };
+    readonly social: readonly {
+        readonly network: string;
+        readonly url: string;
+    }[];
+};
+export declare const MALFORMED_CONTENT = "malformed-content";
+export declare class MalformedContentError extends Error {
+    readonly code = "malformed-content";
+    readonly documentId: string;
+    readonly problems: readonly string[];
+    constructor(documentId: string, problems: readonly string[]);
+}
+export declare const READER_PHOTO_SLUG: RegExp;
+export declare const READER_ACTION_HREF: RegExp;
+export declare const READER_JUMP_LINK: RegExp;
+export declare const READER_STORY_LAYOUTS: readonly ["wide", "tall", "round", "free"];
+export declare const READER_HOME_PAGE_ID = "homePage";
+export declare const READER_SITE_SETTINGS_ID = "siteSettings";
+/**
+ * The narrow Portable Text `portableText` declares, back to Markdown: normal,
+ * h2, h3 and quote blocks, bullet and numbered lists, bold, italic, code and
+ * links. It is the inverse of the seed package's Markdown mapper, and the
+ * round-trip test holds the two to each other.
+ *
+ * An uploaded image inside rich text is REFUSED, not dropped: nothing can
+ * 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.
+ */
+export declare function portableTextToMarkdown(value: unknown): string;
+/** Whether a campaign is shown at `now`, and if not, why not. */
+export declare function campaignState(campaign: unknown, now: Date): CampaignState;
+/**
+ * A stored home page document, validated and mapped. Throws
+ * `MalformedContentError` naming every problem. `now` decides whether a
+ * scheduled campaign is shown, and is a parameter so a build, a preview and a
+ * test each say which moment they mean.
+ */
+export declare function parseHomePage(document: unknown, options: {
+    readonly now: Date;
+}): HomeContent;
+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]";
+export interface SiteContentReader {
+    /** `null` when no home page document exists yet. */
+    home: (options: {
+        readonly now: Date;
+    }) => Promise<HomeContent | null>;
+    pages: () => Promise<PageContent[]>;
+    /** `null` when no page has that slug. */
+    pageBySlug: (slug: string) => Promise<PageContent | null>;
+    /** `null` before anyone has filled in the site's details. */
+    siteSettings: () => Promise<SiteSettingsContent | null>;
+}
+export declare function createSiteContentReader(client: {
+    query: <T>(groq: string, options?: {
+        params?: Record<string, unknown>;
+        tags?: readonly string[];
+    }) => Promise<T>;
+}): SiteContentReader;
+export declare function homeContentQuery(now: Date): CmsQuery<HomeContent | null>;
+export declare function contentPageQuery(slug: string): CmsQuery<PageContent | null>;
+export declare function contentPagesQuery(): CmsQuery<readonly PageContent[]>;
+export declare function siteSettingsQuery(): CmsQuery<SiteSettingsContent | null>;

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

@@ -0,0 +1,220 @@
+/**
+ * A-1713. The site content model, read: the home page, content pages and site
+ * settings, validated on read and returned in the shape a site's page
+ * composition consumes.
+ *
+ * ===========================================================================
+ * READ ONLY, BY CONSTRUCTION
+ * ===========================================================================
+ *
+ * A client site reads its content with a read-only token. All editing goes
+ * through the studio's dashboard, which writes to Sanity; nothing on a client
+ * site writes, and this module has no write path to call. It is handed a
+ * `ContentClient` (a `query` function) and nothing else.
+ *
+ * ===========================================================================
+ * VALIDATED ON READ, BECAUSE SANITY VALIDATION ONLY ADVISES
+ * ===========================================================================
+ *
+ * The schema's rules warn an editor; they do not refuse a publish, and
+ * 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.
+ *
+ * Absent is not malformed: `null` from `home()` means nobody has created the
+ * home page yet, and a site decides what to do about that.
+ *
+ * ===========================================================================
+ * THE SHAPE IT RETURNS
+ * ===========================================================================
+ *
+ * The INPUT shape of a site's composition schema (the reference build's
+ * frontmatter): a copy value is a plain string for the client's own words
+ * with no claim about their source, `{ text, copySource: "captured" }` for
+ * words claimed verbatim from the capture (the site checks every such claim
+ * against its capture evidence, so the claim must survive Sanity), and
+ * `{ text, copySource: "proposed" }` for studio-written words awaiting
+ * approval. All three round-trip exactly; a photo is its library slug; every key a block declares is
+ * present, `null` where there is nothing. So a site validates this with the
+ * same schema it validates its Markdown frontmatter with, and its components
+ * never know where the content came from.
+ *
+ * Mapping from the generic model to the composition's names:
+ *
+ *   hero.headline / subline / lead      hero.heading / subline / intro
+ *   hero.photos[0], [1]                 hero.image, hero.inset
+ *   hero.primaryAction / secondary...   hero.cta / secondaryCta
+ *   campaign (when shown)               the FIRST block, kind `campaign`, and
+ *                                       the page body (`# title` + its text)
+ *   featureStoriesBlock                 kind `feature_stories`
+ *   surfaceCardBlock                    kind `cta`
+ *   accentBandBlock                     kind `accent_band`
+ *   locationsBlock                      kind `locations` (jumpLink → anchor)
+ *
+ * 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
+ * `proposedCopy`, which is the list a dashboard and a site both read for
+ * approval. Nothing is dropped silently.
+ */
+import { type CmsQuery } from "../contracts/query.mjs";
+export type CopyInput = string | {
+    readonly text: string;
+    readonly copySource: "captured" | "proposed";
+};
+export type ActionInput = {
+    readonly label: CopyInput;
+    readonly href: string;
+};
+export type HeroInput = {
+    readonly heading: CopyInput;
+    readonly subline: CopyInput | null;
+    readonly intro: CopyInput | null;
+    readonly image: string | null;
+    readonly inset: string | null;
+    readonly cta: ActionInput | null;
+    readonly secondaryCta: ActionInput | null;
+};
+export type StoryInput = {
+    readonly heading: CopyInput;
+    readonly body: CopyInput;
+    readonly action: ActionInput;
+    readonly image: string | null;
+    readonly shape: "wide" | "tall" | "round" | "free";
+    readonly card: boolean;
+};
+export type CompositionBlockInput = {
+    readonly kind: "campaign";
+    readonly action: ActionInput | null;
+    readonly images: readonly string[];
+} | {
+    readonly kind: "locations";
+    readonly anchor: string | null;
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly image: string | null;
+} | {
+    readonly kind: "feature_stories";
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly items: readonly StoryInput[];
+} | {
+    readonly kind: "accent_band";
+    readonly heading: CopyInput;
+    readonly body: CopyInput;
+    readonly action: ActionInput | null;
+    readonly image: string | null;
+} | {
+    readonly kind: "cta";
+    readonly heading: string;
+    readonly body: string | null;
+    readonly link: {
+        readonly label: string;
+        readonly href: string;
+    };
+};
+export type CompositionInput = {
+    readonly intro: string | null;
+    readonly photo: string | null;
+    readonly hero: HeroInput | null;
+    readonly blocks: readonly CompositionBlockInput[];
+};
+/** One line of studio-written copy awaiting approval, and where it is in the document. */
+export type ProposedCopy = {
+    readonly where: string;
+    readonly text: string;
+};
+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;
+    readonly campaign: CampaignState;
+    readonly proposedCopy: readonly ProposedCopy[];
+};
+export type PageContent = {
+    readonly slug: string;
+    readonly title: string;
+    readonly composition: CompositionInput;
+    readonly body: string;
+    readonly migrated: boolean;
+    readonly proposedCopy: readonly ProposedCopy[];
+};
+export type SiteSettingsContent = {
+    readonly name: string;
+    readonly description: string | null;
+    readonly contact: {
+        readonly email: string | null;
+        readonly phone: string | null;
+    };
+    readonly social: readonly {
+        readonly network: string;
+        readonly url: string;
+    }[];
+};
+export declare const MALFORMED_CONTENT = "malformed-content";
+export declare class MalformedContentError extends Error {
+    readonly code = "malformed-content";
+    readonly documentId: string;
+    readonly problems: readonly string[];
+    constructor(documentId: string, problems: readonly string[]);
+}
+export declare const READER_PHOTO_SLUG: RegExp;
+export declare const READER_ACTION_HREF: RegExp;
+export declare const READER_JUMP_LINK: RegExp;
+export declare const READER_STORY_LAYOUTS: readonly ["wide", "tall", "round", "free"];
+export declare const READER_HOME_PAGE_ID = "homePage";
+export declare const READER_SITE_SETTINGS_ID = "siteSettings";
+/**
+ * The narrow Portable Text `portableText` declares, back to Markdown: normal,
+ * h2, h3 and quote blocks, bullet and numbered lists, bold, italic, code and
+ * links. It is the inverse of the seed package's Markdown mapper, and the
+ * round-trip test holds the two to each other.
+ *
+ * An uploaded image inside rich text is REFUSED, not dropped: nothing can
+ * 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.
+ */
+export declare function portableTextToMarkdown(value: unknown): string;
+/** Whether a campaign is shown at `now`, and if not, why not. */
+export declare function campaignState(campaign: unknown, now: Date): CampaignState;
+/**
+ * A stored home page document, validated and mapped. Throws
+ * `MalformedContentError` naming every problem. `now` decides whether a
+ * scheduled campaign is shown, and is a parameter so a build, a preview and a
+ * test each say which moment they mean.
+ */
+export declare function parseHomePage(document: unknown, options: {
+    readonly now: Date;
+}): HomeContent;
+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]";
+export interface SiteContentReader {
+    /** `null` when no home page document exists yet. */
+    home: (options: {
+        readonly now: Date;
+    }) => Promise<HomeContent | null>;
+    pages: () => Promise<PageContent[]>;
+    /** `null` when no page has that slug. */
+    pageBySlug: (slug: string) => Promise<PageContent | null>;
+    /** `null` before anyone has filled in the site's details. */
+    siteSettings: () => Promise<SiteSettingsContent | null>;
+}
+export declare function createSiteContentReader(client: {
+    query: <T>(groq: string, options?: {
+        params?: Record<string, unknown>;
+        tags?: readonly string[];
+    }) => Promise<T>;
+}): SiteContentReader;
+export declare function homeContentQuery(now: Date): CmsQuery<HomeContent | null>;
+export declare function contentPageQuery(slug: string): CmsQuery<PageContent | null>;
+export declare function contentPagesQuery(): CmsQuery<readonly PageContent[]>;
+export declare function siteSettingsQuery(): CmsQuery<SiteSettingsContent | null>;

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

@@ -0,0 +1,220 @@
+/**
+ * A-1713. The site content model, read: the home page, content pages and site
+ * settings, validated on read and returned in the shape a site's page
+ * composition consumes.
+ *
+ * ===========================================================================
+ * READ ONLY, BY CONSTRUCTION
+ * ===========================================================================
+ *
+ * A client site reads its content with a read-only token. All editing goes
+ * through the studio's dashboard, which writes to Sanity; nothing on a client
+ * site writes, and this module has no write path to call. It is handed a
+ * `ContentClient` (a `query` function) and nothing else.
+ *
+ * ===========================================================================
+ * VALIDATED ON READ, BECAUSE SANITY VALIDATION ONLY ADVISES
+ * ===========================================================================
+ *
+ * The schema's rules warn an editor; they do not refuse a publish, and
+ * 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.
+ *
+ * Absent is not malformed: `null` from `home()` means nobody has created the
+ * home page yet, and a site decides what to do about that.
+ *
+ * ===========================================================================
+ * THE SHAPE IT RETURNS
+ * ===========================================================================
+ *
+ * The INPUT shape of a site's composition schema (the reference build's
+ * frontmatter): a copy value is a plain string for the client's own words
+ * with no claim about their source, `{ text, copySource: "captured" }` for
+ * words claimed verbatim from the capture (the site checks every such claim
+ * against its capture evidence, so the claim must survive Sanity), and
+ * `{ text, copySource: "proposed" }` for studio-written words awaiting
+ * approval. All three round-trip exactly; a photo is its library slug; every key a block declares is
+ * present, `null` where there is nothing. So a site validates this with the
+ * same schema it validates its Markdown frontmatter with, and its components
+ * never know where the content came from.
+ *
+ * Mapping from the generic model to the composition's names:
+ *
+ *   hero.headline / subline / lead      hero.heading / subline / intro
+ *   hero.photos[0], [1]                 hero.image, hero.inset
+ *   hero.primaryAction / secondary...   hero.cta / secondaryCta
+ *   campaign (when shown)               the FIRST block, kind `campaign`, and
+ *                                       the page body (`# title` + its text)
+ *   featureStoriesBlock                 kind `feature_stories`
+ *   surfaceCardBlock                    kind `cta`
+ *   accentBandBlock                     kind `accent_band`
+ *   locationsBlock                      kind `locations` (jumpLink → anchor)
+ *
+ * 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
+ * `proposedCopy`, which is the list a dashboard and a site both read for
+ * approval. Nothing is dropped silently.
+ */
+import { type CmsQuery } from "../contracts/query.js";
+export type CopyInput = string | {
+    readonly text: string;
+    readonly copySource: "captured" | "proposed";
+};
+export type ActionInput = {
+    readonly label: CopyInput;
+    readonly href: string;
+};
+export type HeroInput = {
+    readonly heading: CopyInput;
+    readonly subline: CopyInput | null;
+    readonly intro: CopyInput | null;
+    readonly image: string | null;
+    readonly inset: string | null;
+    readonly cta: ActionInput | null;
+    readonly secondaryCta: ActionInput | null;
+};
+export type StoryInput = {
+    readonly heading: CopyInput;
+    readonly body: CopyInput;
+    readonly action: ActionInput;
+    readonly image: string | null;
+    readonly shape: "wide" | "tall" | "round" | "free";
+    readonly card: boolean;
+};
+export type CompositionBlockInput = {
+    readonly kind: "campaign";
+    readonly action: ActionInput | null;
+    readonly images: readonly string[];
+} | {
+    readonly kind: "locations";
+    readonly anchor: string | null;
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly image: string | null;
+} | {
+    readonly kind: "feature_stories";
+    readonly heading: CopyInput;
+    readonly tail: CopyInput | null;
+    readonly items: readonly StoryInput[];
+} | {
+    readonly kind: "accent_band";
+    readonly heading: CopyInput;
+    readonly body: CopyInput;
+    readonly action: ActionInput | null;
+    readonly image: string | null;
+} | {
+    readonly kind: "cta";
+    readonly heading: string;
+    readonly body: string | null;
+    readonly link: {
+        readonly label: string;
+        readonly href: string;
+    };
+};
+export type CompositionInput = {
+    readonly intro: string | null;
+    readonly photo: string | null;
+    readonly hero: HeroInput | null;
+    readonly blocks: readonly CompositionBlockInput[];
+};
+/** One line of studio-written copy awaiting approval, and where it is in the document. */
+export type ProposedCopy = {
+    readonly where: string;
+    readonly text: string;
+};
+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;
+    readonly campaign: CampaignState;
+    readonly proposedCopy: readonly ProposedCopy[];
+};
+export type PageContent = {
+    readonly slug: string;
+    readonly title: string;
+    readonly composition: CompositionInput;
+    readonly body: string;
+    readonly migrated: boolean;
+    readonly proposedCopy: readonly ProposedCopy[];
+};
+export type SiteSettingsContent = {
+    readonly name: string;
+    readonly description: string | null;
+    readonly contact: {
+        readonly email: string | null;
+        readonly phone: string | null;
+    };
+    readonly social: readonly {
+        readonly network: string;
+        readonly url: string;
+    }[];
+};
+export declare const MALFORMED_CONTENT = "malformed-content";
+export declare class MalformedContentError extends Error {
+    readonly code = "malformed-content";
+    readonly documentId: string;
+    readonly problems: readonly string[];
+    constructor(documentId: string, problems: readonly string[]);
+}
+export declare const READER_PHOTO_SLUG: RegExp;
+export declare const READER_ACTION_HREF: RegExp;
+export declare const READER_JUMP_LINK: RegExp;
+export declare const READER_STORY_LAYOUTS: readonly ["wide", "tall", "round", "free"];
+export declare const READER_HOME_PAGE_ID = "homePage";
+export declare const READER_SITE_SETTINGS_ID = "siteSettings";
+/**
+ * The narrow Portable Text `portableText` declares, back to Markdown: normal,
+ * h2, h3 and quote blocks, bullet and numbered lists, bold, italic, code and
+ * links. It is the inverse of the seed package's Markdown mapper, and the
+ * round-trip test holds the two to each other.
+ *
+ * An uploaded image inside rich text is REFUSED, not dropped: nothing can
+ * 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.
+ */
+export declare function portableTextToMarkdown(value: unknown): string;
+/** Whether a campaign is shown at `now`, and if not, why not. */
+export declare function campaignState(campaign: unknown, now: Date): CampaignState;
+/**
+ * A stored home page document, validated and mapped. Throws
+ * `MalformedContentError` naming every problem. `now` decides whether a
+ * scheduled campaign is shown, and is a parameter so a build, a preview and a
+ * test each say which moment they mean.
+ */
+export declare function parseHomePage(document: unknown, options: {
+    readonly now: Date;
+}): HomeContent;
+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]";
+export interface SiteContentReader {
+    /** `null` when no home page document exists yet. */
+    home: (options: {
+        readonly now: Date;
+    }) => Promise<HomeContent | null>;
+    pages: () => Promise<PageContent[]>;
+    /** `null` when no page has that slug. */
+    pageBySlug: (slug: string) => Promise<PageContent | null>;
+    /** `null` before anyone has filled in the site's details. */
+    siteSettings: () => Promise<SiteSettingsContent | null>;
+}
+export declare function createSiteContentReader(client: {
+    query: <T>(groq: string, options?: {
+        params?: Record<string, unknown>;
+        tags?: readonly string[];
+    }) => Promise<T>;
+}): SiteContentReader;
+export declare function homeContentQuery(now: Date): CmsQuery<HomeContent | null>;
+export declare function contentPageQuery(slug: string): CmsQuery<PageContent | null>;
+export declare function contentPagesQuery(): CmsQuery<readonly PageContent[]>;
+export declare function siteSettingsQuery(): CmsQuery<SiteSettingsContent | null>;