@seamlet/astro 0.11.2 → 0.12.0

package/dist/{content-6k-E7NWf.d.ts → parse-content-Eg8yRq_t.d.ts}

@@ -168,6 +168,8 @@ declare function asOneParagraph(text: RichText): RichText;
 declare function readRichText(input: unknown): RichText | undefined;
 /** The same line with empty pieces left out and neighbors with the same marks joined. */
 declare function normalizedLine(spans: readonly RichSpan[]): RichLine;
+/** The lines of a text: its paragraphs and the items of its lists, in their order. */
+declare function linesOf(text: RichText): readonly RichLine[];
 
 /** The point of a photo that must stay in view when a site crops it: 0 to 1 from the left and the top. */
 interface ImageFocus {
@@ -211,4 +213,70 @@ type FieldValue = string | number | boolean | null | readonly string[] | ImageVa
 declare function defaultValue(field: Field): FieldValue;
 declare function defaultContent(fields: Fields): Content;
 
-export { time as $, defaultContent as A, defaultValue as B, type ContentOf as C, type DateField as D, defineSchema as E, type Fields as F, type GroupField as G, group as H, type ImageField as I, image as J, link as K, type LinkValue as L, normalizedLine as M, type NumberField as N, type OptionValue as O, number as P, plainTextOf as Q, type RichText as R, readRichText as S, type TextField as T, type UrlField as U, type ValueOf as V, reference as W, references as X, richText as Y, richTextOf as Z, text as _, type Content as a, toggle as a0, url as a1, type ImageValue as b, type Field as c, type CollectionField as d, type RecordFields as e, type LinkField as f, type ChoicesField as g, type TimeField as h, type ChoiceField as i, type ChoiceOption as j, type FieldKind as k, type FieldValue as l, type ImageFocus as m, type RecordOf as n, type ReferenceField as o, type ReferencesField as p, type RichBlock as q, type RichLine as r, type RichSpan as s, type RichTextField as t, type ToggleField as u, asOneParagraph as v, choice as w, choices as x, collection as y, date as z };
+/** Where a value lives in the content: field names and, inside a collection, record indexes. */
+type FieldPath = readonly (string | number)[];
+type ContentIssue = {
+    readonly path: FieldPath;
+    readonly code: "invalid-type";
+} | {
+    readonly path: FieldPath;
+    readonly code: "invalid-date";
+} | {
+    readonly path: FieldPath;
+    readonly code: "invalid-time";
+} | {
+    readonly path: FieldPath;
+    readonly code: "too-long";
+    readonly maxLength: number;
+} | {
+    readonly path: FieldPath;
+    readonly code: "below-min";
+    readonly min: number;
+} | {
+    readonly path: FieldPath;
+    readonly code: "above-max";
+    readonly max: number;
+} | {
+    readonly path: FieldPath;
+    readonly code: "missing-image-src";
+} | {
+    readonly path: FieldPath;
+    readonly code: "missing-link-href";
+} | {
+    readonly path: FieldPath;
+    readonly code: "unsupported-link-href";
+} | {
+    readonly path: FieldPath;
+    readonly code: "unsupported-url";
+} | {
+    readonly path: FieldPath;
+    readonly code: "unknown-choice";
+    readonly value: string;
+} | {
+    readonly path: FieldPath;
+    readonly code: "missing-record";
+    readonly id: string;
+};
+interface ParsedContent<C> {
+    readonly content: C;
+    readonly issues: readonly ContentIssue[];
+}
+declare function formatFieldPath(path: FieldPath): string;
+/**
+ * The length that `maxLength` limits: characters as people see them (grapheme clusters), so
+ * "й" and "👍🏽" are one character each, whatever number of code units they take.
+ */
+declare function countCharacters(text: string): number;
+/**
+ * Brings any input to the shape of the schema, so the result is always content of that schema:
+ * - a field missing from the input (the schema grew after the content was saved) gets its default;
+ * - a value of the wrong type or format gets the default too, and an issue;
+ * - a value of the right type that breaks a rule of its field (too long, below the minimum) is
+ *   kept, with an issue: nothing a person typed is lost;
+ * - keys the schema does not know are dropped; a record keeps its id (see withRecordIds);
+ * - a reference to a record its collection does not have (removed since) is kept, with an issue.
+ * Content with issues is valid to show and edit, but not to save.
+ */
+declare function parseContent<F extends Fields>(schema: F, input: unknown): ParsedContent<ContentOf<F>>;
+
+export { plainTextOf as $, collection as A, countCharacters as B, type ContentOf as C, type DateField as D, date as E, type Fields as F, type GroupField as G, defaultContent as H, type ImageField as I, defaultValue as J, defineSchema as K, type LinkValue as L, formatFieldPath as M, type NumberField as N, type OptionValue as O, type ParsedContent as P, group as Q, type RichText as R, image as S, type TextField as T, type UrlField as U, type ValueOf as V, linesOf as W, link as X, normalizedLine as Y, number as Z, parseContent as _, type Content as a, readRichText as a0, reference as a1, references as a2, richText as a3, richTextOf as a4, text as a5, time as a6, toggle as a7, url as a8, type FieldPath as b, type ContentIssue as c, type ImageValue as d, type Field as e, type CollectionField as f, type RecordFields as g, type LinkField as h, type ChoicesField as i, type TimeField as j, type ChoiceField as k, type ChoiceOption as l, type FieldKind as m, type FieldValue as n, type ImageFocus as o, type RecordOf as p, type ReferenceField as q, type ReferencesField as r, type RichBlock as s, type RichLine as t, type RichSpan as u, type RichTextField as v, type ToggleField as w, asOneParagraph as x, choice as y, choices as z };

package/dist/preview-requests.d.ts

@@ -1,5 +1,10 @@
 /** Far more than the content of a site ever takes; a bigger body is not a draft. */
 declare const MAX_DRAFT_BYTES: number;
+/**
+ * What every answer of the preview says, a refusal too: only the CMS's editor frames it, and
+ * nobody indexes or keeps it.
+ */
+declare function previewHeadersOf(cmsOrigin: string): Readonly<Record<string, string>>;
 type DraftReading = {
     readonly isRead: true;
     readonly draft: unknown;
@@ -15,4 +20,4 @@ declare function readDraft(request: Request): Promise<DraftReading>;
 /** Whether a name can be a photo uploaded to the CMS: the hash of its bytes, as WebP. */
 declare function isUploadedPhoto(fileName: string | undefined): fileName is string;
 
-export { type DraftReading, MAX_DRAFT_BYTES, isUploadedPhoto, readDraft };
+export { type DraftReading, MAX_DRAFT_BYTES, isUploadedPhoto, previewHeadersOf, readDraft };

package/dist/preview-requests.js

@@ -1,10 +1,12 @@
 import {
   MAX_DRAFT_BYTES,
   isUploadedPhoto,
+  previewHeadersOf,
   readDraft
-} from "./chunk-P2OQOZBC.js";
+} from "./chunk-QL4K4HR6.js";
 export {
   MAX_DRAFT_BYTES,
   isUploadedPhoto,
+  previewHeadersOf,
   readDraft
 };

package/dist/protocol.d.ts

@@ -1,7 +1,8 @@
-import { T as TextSelection } from './messages-Dx0jNy3N.js';
-export { B as Box, a as EditorKey, E as EditorMessage, I as InlineEditingOutcome, L as LinkBox, M as Mark, b as MarkerBox, c as PROTOCOL_VERSION, d as PageLayout, P as PageMessage, e as Point, S as Shortcut, f as TextFormat, g as TextFormats, h as TextPoint, i as TypedSelection, V as Viewport, j as formatsAt, k as isCollapsed, l as linkSelectionAt, r as readEditorMessage, m as readPageMessage, s as setLink, n as shortcutOf, t as toggleList, o as toggleMark } from './messages-Dx0jNy3N.js';
-import { F as Fields, I as ImageField, R as RichText } from './content-6k-E7NWf.js';
-import { F as FieldPath } from './parse-content-C9ldnmvj.js';
+import { S as Shortcut, T as TextFormats } from './messages-CvZhLRSE.js';
+export { B as Box, a as EditorKey, E as EditorMessage, I as InlineEditingOutcome, L as LinkBox, M as MarkerBox, b as PROTOCOL_VERSION, c as PageLayout, P as PageMessage, d as Point, e as TextFormat, f as TypedSelection, V as Viewport, r as readEditorMessage, g as readPageMessage } from './messages-CvZhLRSE.js';
+import { F as Fields, b as FieldPath, I as ImageField, R as RichText } from './parse-content-Eg8yRq_t.js';
+
+declare function shortcutOf(event: KeyboardEvent): Shortcut | undefined;
 
 declare function carriesFiles(event: DragEvent): boolean;
 
@@ -17,6 +18,31 @@ declare function imageFieldAt(schema: Fields, path: string | undefined): {
  */
 declare function closestMarkedPath(path: FieldPath, isMarked: (path: string) => boolean): string | undefined;
 
+interface TextPoint {
+    /** The paragraph or the list item, counted from the start of the text. */
+    readonly line: number;
+    /** Characters from the start of the line; a line break is one character. */
+    readonly offset: number;
+}
+interface TextSelection {
+    readonly start: TextPoint;
+    readonly end: TextPoint;
+}
+type Mark = "bold" | "italic";
+/** What the selected words have, or the words at the cursor when nothing is selected. */
+/** Whether the selection holds no characters: it is a cursor. */
+declare function isCollapsed(selection: TextSelection): boolean;
+/** The marks every selected word has, and the link they are in. */
+declare function formatsAt(text: RichText, selection: TextSelection): TextFormats;
+/** The words of the link the cursor is in, or undefined outside a link. */
+declare function linkSelectionAt(text: RichText, point: TextPoint): TextSelection | undefined;
+/** The mark on every selected word, or off them all when every one has it already. */
+declare function toggleMark(text: RichText, selection: TextSelection, mark: Mark): RichText;
+/** The selected words lead to the address, or lead nowhere when it is undefined. */
+declare function setLink(text: RichText, selection: TextSelection, href: string | undefined): RichText;
+/** The selected lines become a list, or paragraphs again when they all are a list already. */
+declare function toggleList(text: RichText, selection: TextSelection): RichText;
+
 /** The elements of a text, put into the editable element in place of what it held. */
 declare function renderRichText(element: HTMLElement, text: RichText): void;
 /** What the editable element holds now, as formatted text. */
@@ -35,4 +61,4 @@ declare function isOwnPhotoSrc(src: string): boolean;
 /** Where the site hands out its own photo; undefined for an upload or another site's address. */
 declare function ownPhotoPath(src: string): string | undefined;
 
-export { OWN_PHOTOS_PATH, TextSelection, carriesFiles, closestMarkedPath, imageFieldAt, insertPlainText, isOwnPhotoSrc, ownPhotoPath, readRichTextFrom, readSelectionFrom, renderRichText, selectIn };
+export { type Mark, OWN_PHOTOS_PATH, Shortcut, TextFormats, type TextPoint, type TextSelection, carriesFiles, closestMarkedPath, formatsAt, imageFieldAt, insertPlainText, isCollapsed, isOwnPhotoSrc, linkSelectionAt, ownPhotoPath, readRichTextFrom, readSelectionFrom, renderRichText, selectIn, setLink, shortcutOf, toggleList, toggleMark };

package/dist/protocol.js

@@ -2,7 +2,7 @@ import {
   OWN_PHOTOS_PATH,
   isOwnPhotoSrc,
   ownPhotoPath
-} from "./chunk-3BS5CE26.js";
+} from "./chunk-W2LIOR2C.js";
 import {
   PROTOCOL_VERSION,
   carriesFiles,
@@ -22,8 +22,9 @@ import {
   shortcutOf,
   toggleList,
   toggleMark
-} from "./chunk-2E7VDSUK.js";
-import "./chunk-DRDPKFHZ.js";
+} from "./chunk-MW3BE5O6.js";
+import "./chunk-7GYJS7ZT.js";
+import "./chunk-QCVWHHJC.js";
 export {
   OWN_PHOTOS_PATH,
   PROTOCOL_VERSION,

package/dist/routes/media.js

@@ -1,28 +1,49 @@
+import {
+  uploadedPhotoPath
+} from "../chunk-QCVWHHJC.js";
 import {
   isUploadedPhoto
-} from "../chunk-P2OQOZBC.js";
+} from "../chunk-QL4K4HR6.js";
 
 // src/routes/media.ts
 import { cmsOrigin } from "virtual:seamlet/config";
 import site from "virtual:seamlet/site";
 var NOT_FOUND = 404;
+var BAD_GATEWAY = 502;
+var PHOTO_TIMEOUT_MS = 1e4;
 var GET = async ({ params }) => {
   const fileName = params["file"];
   const isOurs = params["site"] === site.id && isUploadedPhoto(fileName);
   if (!isOurs) {
     return new Response(null, { status: NOT_FOUND });
   }
-  const response = await fetch(
-    new URL(`/media/${site.id}/${fileName}`, cmsOrigin)
-  );
+  const url = new URL(uploadedPhotoPath(site.id, fileName), cmsOrigin);
+  const response = await photoFromCms(url);
+  if (response === void 0) {
+    return new Response(null, { status: BAD_GATEWAY });
+  }
+  if (!response.ok) {
+    const status = response.status === NOT_FOUND ? NOT_FOUND : BAD_GATEWAY;
+    return new Response(null, { status });
+  }
   return new Response(response.body, {
-    status: response.status,
     headers: {
       "Content-Type": response.headers.get("Content-Type") ?? "image/webp",
       "Cache-Control": response.headers.get("Cache-Control") ?? "no-cache"
     }
   });
 };
+async function photoFromCms(url) {
+  try {
+    return await fetch(url, { signal: AbortSignal.timeout(PHOTO_TIMEOUT_MS) });
+  } catch (error) {
+    console.warn(
+      `@seamlet/astro: the photo ${url.href} could not be taken from the CMS`,
+      error
+    );
+    return void 0;
+  }
+}
 export {
   GET
 };

package/dist/routes/own-photos.js

@@ -1,6 +1,7 @@
 import {
   isOwnPhotoSrc
-} from "../chunk-3BS5CE26.js";
+} from "../chunk-W2LIOR2C.js";
+import "../chunk-QCVWHHJC.js";
 
 // src/routes/own-photos.ts
 import site from "virtual:seamlet/site";

package/dist/schema.d.ts

@@ -1,8 +1,6 @@
-import { b as ImageValue, L as LinkValue, c as Field, d as CollectionField, F as Fields, a as Content, e as RecordFields, C as ContentOf, G as GroupField, f as LinkField, T as TextField, U as UrlField, g as ChoicesField, h as TimeField, I as ImageField } from './content-6k-E7NWf.js';
-export { i as ChoiceField, j as ChoiceOption, D as DateField, k as FieldKind, l as FieldValue, m as ImageFocus, N as NumberField, O as OptionValue, n as RecordOf, o as ReferenceField, p as ReferencesField, q as RichBlock, r as RichLine, s as RichSpan, R as RichText, t as RichTextField, u as ToggleField, V as ValueOf, v as asOneParagraph, w as choice, x as choices, y as collection, z as date, A as defaultContent, B as defaultValue, E as defineSchema, H as group, J as image, K as link, M as normalizedLine, P as number, Q as plainTextOf, S as readRichText, W as reference, X as references, Y as richText, Z as richTextOf, _ as text, $ as time, a0 as toggle, a1 as url } from './content-6k-E7NWf.js';
-import { F as FieldPath } from './parse-content-C9ldnmvj.js';
-export { C as ContentIssue, P as ParsedContent, c as countCharacters, f as formatFieldPath, p as parseContent } from './parse-content-C9ldnmvj.js';
-export { a as SITE_DESCRIPTION_PATH, S as SiteDescription, b as SitePageDescription, i as isSearchTextsGroup, r as readSiteDescription } from './site-description-4Jx6Nq6X.js';
+import { d as ImageValue, L as LinkValue, b as FieldPath, e as Field, f as CollectionField, F as Fields, a as Content, g as RecordFields, C as ContentOf, G as GroupField, h as LinkField, T as TextField, U as UrlField, i as ChoicesField, j as TimeField, I as ImageField } from './parse-content-Eg8yRq_t.js';
+export { k as ChoiceField, l as ChoiceOption, c as ContentIssue, D as DateField, m as FieldKind, n as FieldValue, o as ImageFocus, N as NumberField, O as OptionValue, P as ParsedContent, p as RecordOf, q as ReferenceField, r as ReferencesField, s as RichBlock, t as RichLine, u as RichSpan, R as RichText, v as RichTextField, w as ToggleField, V as ValueOf, x as asOneParagraph, y as choice, z as choices, A as collection, B as countCharacters, E as date, H as defaultContent, J as defaultValue, K as defineSchema, M as formatFieldPath, Q as group, S as image, W as linesOf, X as link, Y as normalizedLine, Z as number, _ as parseContent, $ as plainTextOf, a0 as readRichText, a1 as reference, a2 as references, a3 as richText, a4 as richTextOf, a5 as text, a6 as time, a7 as toggle, a8 as url } from './parse-content-Eg8yRq_t.js';
+export { F as FieldsReading, H as HOME_PAGE_PATH, P as PageProblemReason, a as SITE_DESCRIPTION_PATH, b as SchemaProblem, c as SchemaProblemReason, S as SiteDescription, d as SiteDescriptionProblem, e as SiteDescriptionReading, f as SitePageDescription, g as checkFields, h as checkSiteDescription, i as isSearchTextsGroup, r as readFields, j as readSiteDescription } from './site-description-Cg5KNhhG.js';
 
 declare const FIELD_PATH_ATTRIBUTE = "data-cms-path";
 interface FieldMarker {
@@ -91,6 +89,12 @@ type LinkKind = LinkTarget["kind"];
  * is checked exactly as it is stored and rendered: spaces around it make it no address at all.
  */
 declare function linkTargetOf(href: string): LinkTarget | undefined;
+/**
+ * The address as it is when a link of a site may lead there, or undefined when it may not: what a
+ * site puts into `href` of content it renders, since content that is not saved yet (the editor's
+ * draft in the preview) may hold any address.
+ */
+declare function safeHref(href: string): string | undefined;
 /**
  * The address of a link from what a person typed: a phone or an email without `tel:` or
  * `mailto:`, a site without `https://`.
@@ -172,8 +176,9 @@ declare function openingHoursField(options?: {
     note: TextField;
 }>;
 
-/** The schema the input describes, or undefined when it is not one. */
-declare function readFields(input: unknown): Fields | undefined;
+/** An object of named values: not null, not a list. */
+type JsonObject = Readonly<Record<string, unknown>>;
+declare function isJsonObject(value: unknown): value is JsonObject;
 
 /** The file at the root of a site's repository. */
 declare const SITE_CONFIG_FILE = "seamlet.json";
@@ -198,4 +203,4 @@ declare function isSiteId(value: unknown): value is string;
 /** The config the input gives (the parsed `seamlet.json`); fields it does not know are left out. */
 declare function readSiteConfig(input: unknown): SiteConfigReading;
 
-export { ChoicesField, CollectionField, type CollectionRecords, Content, ContentOf, type ContentPath, FIELD_PATH_ATTRIBUTE, Field, type FieldMarker, FieldPath, type FieldTarget, Fields, GroupField, ImageField, ImageValue, LinkField, type LinkKind, type LinkTarget, LinkValue, RECORD_ID_KEY, REVEALED_ATTRIBUTE, REVEAL_ATTRIBUTE, REVEAL_EVENT, RecordFields, SITE_CONFIG_FILE, type SiteConfig, type SiteConfigField, type SiteConfigReading, TextField, TimeField, UrlField, WEEKDAYS, collectionAt, contactsFields, editable, findRecord, hrefOf, imagePosition, isRecordId, isSiteId, linkTargetOf, newRecord, openingHoursField, readFields, readSiteConfig, resolveFieldPath, seoFields, withRecordIds };
+export { ChoicesField, CollectionField, type CollectionRecords, Content, ContentOf, type ContentPath, FIELD_PATH_ATTRIBUTE, Field, type FieldMarker, FieldPath, type FieldTarget, Fields, GroupField, ImageField, ImageValue, type JsonObject, LinkField, type LinkKind, type LinkTarget, LinkValue, RECORD_ID_KEY, REVEALED_ATTRIBUTE, REVEAL_ATTRIBUTE, REVEAL_EVENT, RecordFields, SITE_CONFIG_FILE, type SiteConfig, type SiteConfigField, type SiteConfigReading, TextField, TimeField, UrlField, WEEKDAYS, collectionAt, contactsFields, editable, findRecord, hrefOf, imagePosition, isJsonObject, isRecordId, isSiteId, linkTargetOf, newRecord, openingHoursField, readSiteConfig, resolveFieldPath, safeHref, seoFields, withRecordIds };

package/dist/schema.js

@@ -1,5 +1,6 @@
 import {
   FIELD_PATH_ATTRIBUTE,
+  HOME_PAGE_PATH,
   RECORD_ID_KEY,
   REVEALED_ATTRIBUTE,
   REVEAL_ATTRIBUTE,
@@ -8,6 +9,8 @@ import {
   SITE_DESCRIPTION_PATH,
   WEEKDAYS,
   asOneParagraph,
+  checkFields,
+  checkSiteDescription,
   choice,
   choices,
   collection,
@@ -25,9 +28,11 @@ import {
   hrefOf,
   image,
   imagePosition,
+  isJsonObject,
   isRecordId,
   isSearchTextsGroup,
   isSiteId,
+  linesOf,
   link,
   linkTargetOf,
   newRecord,
@@ -45,15 +50,17 @@ import {
   resolveFieldPath,
   richText,
   richTextOf,
+  safeHref,
   seoFields,
   text,
   time,
   toggle,
   url,
   withRecordIds
-} from "./chunk-DRDPKFHZ.js";
+} from "./chunk-7GYJS7ZT.js";
 export {
   FIELD_PATH_ATTRIBUTE,
+  HOME_PAGE_PATH,
   RECORD_ID_KEY,
   REVEALED_ATTRIBUTE,
   REVEAL_ATTRIBUTE,
@@ -62,6 +69,8 @@ export {
   SITE_DESCRIPTION_PATH,
   WEEKDAYS,
   asOneParagraph,
+  checkFields,
+  checkSiteDescription,
   choice,
   choices,
   collection,
@@ -79,9 +88,11 @@ export {
   hrefOf,
   image,
   imagePosition,
+  isJsonObject,
   isRecordId,
   isSearchTextsGroup,
   isSiteId,
+  linesOf,
   link,
   linkTargetOf,
   newRecord,
@@ -99,6 +110,7 @@ export {
   resolveFieldPath,
   richText,
   richTextOf,
+  safeHref,
   seoFields,
   text,
   time,

package/dist/site-description-Cg5KNhhG.d.ts

@@ -0,0 +1,112 @@
+import { F as Fields, a as Content, c as ContentIssue } from './parse-content-Eg8yRq_t.js';
+
+/** Why a schema cannot be read. */
+type SchemaProblemReason = 
+/** Not an object of fields, or a field that is not an object. */
+"not-fields"
+/** A name that is empty, holds the separator of paths (`.`) or is a number, which a path reads as a record. */
+ | "invalid-name" | "invalid-label" | "unknown-kind"
+/** An option of the field (`maxLength`, `inline`…) is there but not of its kind. */
+ | "invalid-option" | "invalid-choice-options"
+/** A record has a field named `id`, which is the record's own. */
+ | "record-id-field"
+/** `itemTitle` names no text or link field of the record. */
+ | "invalid-item-title"
+/** A reference names a collection the schema does not have. */
+ | "unknown-collection";
+interface SchemaProblem {
+    /** The names of the fields down to the field with the problem; empty for the schema itself. */
+    readonly path: readonly string[];
+    readonly reason: SchemaProblemReason;
+}
+type FieldsReading = {
+    readonly status: "read";
+    readonly fields: Fields;
+} | {
+    readonly status: "invalid";
+    readonly problem: SchemaProblem;
+};
+/** The schema the input describes, or undefined when it is not one. */
+declare function readFields(input: unknown): Fields | undefined;
+/** The schema the input describes, or the first problem that keeps it from being one. */
+declare function checkFields(input: unknown): FieldsReading;
+
+/** Where a site hands out its description, on the origin of its preview. */
+declare const SITE_DESCRIPTION_PATH = "/seamlet/site.json";
+/** A page of a site, which the site renders itself. */
+interface SitePageDescription {
+    /** The address of the page on the site: `/` for the first page, `/menu` for others. */
+    readonly path: string;
+    /** How the editor names the page in its list of pages. */
+    readonly title: string;
+    /**
+     * Where the content holds what search engines and link previews show for the page
+     * (`seo.menu`): a group of a `title` and a `description` text.
+     */
+    readonly searchTexts?: string;
+}
+interface SiteDescription {
+    /** The address of the site in the CMS (`/sites/<id>`). */
+    readonly id: string;
+    /** How the CMS names the site. */
+    readonly title: string;
+    readonly schema: Fields;
+    /** The content shown and edited until the first save. */
+    readonly initialContent: Content;
+    /** The pages of the site; the first is the home page at `/`. */
+    readonly pages: readonly [SitePageDescription, ...SitePageDescription[]];
+}
+/** Why a site's description cannot be read: what to fix in the site. */
+type SiteDescriptionProblem = {
+    readonly code: "not-a-description";
+} | {
+    readonly code: "invalid-id";
+} | {
+    readonly code: "invalid-title";
+} | {
+    readonly code: "invalid-schema";
+    readonly problem: SchemaProblem;
+}
+/** The initial content is not content the CMS could save. */
+ | {
+    readonly code: "invalid-initial-content";
+    readonly issues: readonly ContentIssue[];
+} | {
+    readonly code: "no-pages";
+}
+/** The page at this place of the list is not a page, or its path or title is not one. */
+ | {
+    readonly code: "invalid-page";
+    readonly index: number;
+    readonly reason: PageProblemReason;
+} | {
+    readonly code: "home-page-not-first";
+} | {
+    readonly code: "repeated-page-path";
+    readonly path: string;
+};
+type PageProblemReason = "not-a-page"
+/** Not `/`, or not lower-case segments without a trailing slash, such as `/menu`. */
+ | "invalid-path" | "invalid-title"
+/** Not where the content holds a group of a `title` and a `description` text. */
+ | "invalid-search-texts";
+type SiteDescriptionReading = {
+    readonly status: "read";
+    readonly description: SiteDescription;
+} | {
+    readonly status: "invalid";
+    readonly problems: readonly SiteDescriptionProblem[];
+};
+/** The first page of every site. */
+declare const HOME_PAGE_PATH = "/";
+/**
+ * The description the input gives, or undefined when it is not a whole and sound one: a known
+ * schema, an initial content with nothing to fix, the home page first, each page once.
+ */
+declare function readSiteDescription(input: unknown): SiteDescription | undefined;
+/** The description the input gives, or every problem that keeps it from being whole and sound. */
+declare function checkSiteDescription(input: unknown): SiteDescriptionReading;
+/** Whether the path names a group of a `title` and a `description` text. */
+declare function isSearchTextsGroup(schema: Fields, path: string): boolean;
+
+export { type FieldsReading as F, HOME_PAGE_PATH as H, type PageProblemReason as P, type SiteDescription as S, SITE_DESCRIPTION_PATH as a, type SchemaProblem as b, type SchemaProblemReason as c, type SiteDescriptionProblem as d, type SiteDescriptionReading as e, type SitePageDescription as f, checkFields as g, checkSiteDescription as h, isSearchTextsGroup as i, readSiteDescription as j, readFields as r };

package/dist/site.d.ts

@@ -1,7 +1,7 @@
 import { ImageMetadata } from 'astro';
 import { AstroComponentFactory } from 'astro/runtime/server/index.js';
-import { F as Fields, C as ContentOf } from './content-6k-E7NWf.js';
-import { S as SiteDescription } from './site-description-4Jx6Nq6X.js';
+import { F as Fields, C as ContentOf } from './parse-content-Eg8yRq_t.js';
+import { S as SiteDescription } from './site-description-Cg5KNhhG.js';
 
 /** A page of the site: how the editor names it, and the component that renders it. */
 interface SeamletPage {

package/dist/site.js

@@ -1,13 +1,34 @@
 import {
+  HOME_PAGE_PATH,
+  checkSiteDescription,
+  formatFieldPath,
   parseContent
-} from "./chunk-DRDPKFHZ.js";
+} from "./chunk-7GYJS7ZT.js";
+import {
+  SITE_MODULE_FILE
+} from "./chunk-QCVWHHJC.js";
 
 // src/site.ts
 import { cmsOrigin, siteId, siteTitle } from "virtual:seamlet/config";
 
 // src/published-answers.ts
 var NOT_FOUND = 404;
+var PUBLISHED_CONTENT_TIMEOUT_MS = 3e4;
 var UNKNOWN_SITE = "unknown-site";
+async function fetchPublishedAnswer(url) {
+  let response;
+  try {
+    response = await fetch(url, {
+      signal: AbortSignal.timeout(PUBLISHED_CONTENT_TIMEOUT_MS)
+    });
+  } catch (error) {
+    throw new Error(
+      `Loading the published content from ${url.href} failed: the CMS did not answer`,
+      { cause: error }
+    );
+  }
+  return readPublishedAnswer(response, url);
+}
 async function readPublishedAnswer(response, url) {
   if (response.ok)
     return { status: "published", content: await response.json() };
@@ -35,21 +56,74 @@ function describeSite(identity, definition) {
       ...page.searchTexts === void 0 ? {} : { searchTexts: page.searchTexts }
     })
   );
-  const [home, ...rest] = pages;
-  if (home === void 0) {
-    throw new Error(`The site "${identity.id}" has no pages`);
-  }
-  return {
+  const description = {
     id: identity.id,
     title: identity.title,
     schema: definition.schema,
     initialContent: definition.initialContent,
-    pages: [home, ...rest]
+    pages
   };
+  const asSent = JSON.parse(JSON.stringify(description));
+  const reading = checkSiteDescription(asSent);
+  if (reading.status === "invalid") {
+    throw new Error(refusalMessage(identity.id, reading.problems));
+  }
+  return reading.description;
+}
+function refusalMessage(id, problems) {
+  const lines = problems.map((problem) => `  - ${problemText(problem)}`);
+  return [
+    `@seamlet/astro: the CMS would refuse the site "${id}" (${SITE_MODULE_FILE}):`,
+    ...lines
+  ].join("\n");
+}
+function problemText(problem) {
+  switch (problem.code) {
+    case "not-a-description":
+      return "the site describes nothing";
+    case "invalid-id":
+      return "its id in seamlet.json is not one";
+    case "invalid-title":
+      return "its title in seamlet.json is empty";
+    case "invalid-schema": {
+      const path = formatFieldPath(problem.problem.path);
+      const where = path === "" ? "the schema" : `the field "${path}"`;
+      return `${where}: ${SCHEMA_PROBLEM_TEXTS[problem.problem.reason]}`;
+    }
+    case "invalid-initial-content":
+      return `the initial content: ${problem.issues.map(issueText).join("; ")}`;
+    case "no-pages":
+      return "it has no pages";
+    case "invalid-page":
+      return `page ${String(problem.index + 1)} of pages: ${PAGE_PROBLEM_TEXTS[problem.reason]}`;
+    case "home-page-not-first":
+      return 'the first of the pages is not the home page "/"';
+    case "repeated-page-path":
+      return `the page "${problem.path}" is named twice`;
+  }
+}
+var SCHEMA_PROBLEM_TEXTS = {
+  "not-fields": "not fields of the schema language",
+  "invalid-name": "a field's name must not be empty, hold a dot or be a number",
+  "invalid-label": "its label is not a text",
+  "unknown-kind": "a kind of field the schema language does not have",
+  "invalid-option": "an option of the field is not of its kind",
+  "invalid-choice-options": "its options are not a list of { value, label }",
+  "record-id-field": "a record has its own id: name the field otherwise",
+  "invalid-item-title": "itemTitle names no text or link field of the record",
+  "unknown-collection": "it refers to a collection the schema does not have"
+};
+var PAGE_PROBLEM_TEXTS = {
+  "not-a-page": "not a page",
+  "invalid-path": 'its address is not "/" or lower-case segments without a trailing slash, such as "/menu"',
+  "invalid-title": "its title is empty",
+  "invalid-search-texts": "searchTexts names no group of a title and a description text"
+};
+function issueText(issue) {
+  return `"${formatFieldPath(issue.path)}" is ${issue.code}`;
 }
 
 // src/site.ts
-var HOME_PAGE_PATH = "/";
 function defineSeamletSite(definition) {
   const pages = new Map(Object.entries(definition.pages));
   return {
@@ -63,7 +137,7 @@ function defineSeamletSite(definition) {
 }
 async function loadPublishedContent(schema) {
   const url = new URL(`/api/sites/${siteId}/published`, cmsOrigin);
-  const answer = await readPublishedAnswer(await fetch(url), url);
+  const answer = await fetchPublishedAnswer(url);
   const content = answer.status === "published" ? answer.content : await initialContentOfSite();
   return parseContent(schema, content).content;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamlet/astro",
-  "version": "0.11.2",
+  "version": "0.12.0",
   "description": "Connects an Astro site to the Seamlet CMS: the schema of its content, the preview the editor frames, and its published content.",
   "license": "MIT",
   "type": "module",