@seamlet/astro 0.11.3 → 0.12.1

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-ZS32CW5F.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-ZS32CW5F.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.3",
+  "version": "0.12.1",
   "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",

package/routes/preview.astro

@@ -4,29 +4,26 @@
 // content; POST shows the content in its JSON body, never saved: the bridge renders the editor's
 // draft this way.
 import { parseContent } from "@seamlet/astro/schema";
-import { readDraft } from "@seamlet/astro/preview-requests";
+import { previewHeadersOf, readDraft } from "@seamlet/astro/preview-requests";
 import { cmsOrigin } from "virtual:seamlet/config";
 import site from "virtual:seamlet/site";
 
 const NOT_FOUND = 404;
 
+const headers = previewHeadersOf(cmsOrigin);
+for (const [name, value] of Object.entries(headers)) {
+  Astro.response.headers.set(name, value);
+}
+
 const Page = site.pageAt(Astro.params.page);
 if (Page === undefined) {
-  return new Response(null, { status: NOT_FOUND });
+  return new Response(null, { status: NOT_FOUND, headers });
 }
 
-// Only the CMS's editor frames the preview, and nobody indexes or keeps it.
-Astro.response.headers.set(
-  "Content-Security-Policy",
-  `frame-ancestors ${cmsOrigin}`,
-);
-Astro.response.headers.set("X-Robots-Tag", "noindex");
-Astro.response.headers.set("Cache-Control", "no-store");
-
 const reading =
   Astro.request.method === "POST" ? await readDraft(Astro.request) : undefined;
 if (reading !== undefined && !reading.isRead) {
-  return reading.response;
+  return new Response(null, { status: reading.response.status, headers });
 }
 const content =
   reading === undefined

package/dist/parse-content-C9ldnmvj.d.ts

@@ -1,69 +0,0 @@
-import { F as Fields, C as ContentOf } from './content-6k-E7NWf.js';
-
-/** 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 { type ContentIssue as C, type FieldPath as F, type ParsedContent as P, countCharacters as c, formatFieldPath as f, parseContent as p };

package/dist/site-description-4Jx6Nq6X.d.ts

@@ -1,36 +0,0 @@
-import { F as Fields, a as Content } from './content-6k-E7NWf.js';
-
-/** 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[]];
-}
-/**
- * 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;
-/** Whether the path names a group of a `title` and a `description` text. */
-declare function isSearchTextsGroup(schema: Fields, path: string): boolean;
-
-export { type SiteDescription as S, SITE_DESCRIPTION_PATH as a, type SitePageDescription as b, isSearchTextsGroup as i, readSiteDescription as r };