@seamlet/astro 0.12.1 → 1.1.0

package/dist/{parse-content-Eg8yRq_t.d.ts → parse-content-IOJxgKLB.d.ts}

@@ -76,6 +76,15 @@ interface TimeField {
     readonly kind: "time";
     readonly label: string;
 }
+/**
+ * Where a record's page is on the site: `latte` puts it at `/menu/latte` (see recordPages). Lower-case
+ * Latin letters, digits and hyphens, one of a kind in its collection; left empty, the page is at the
+ * record's id. A field of a record of a collection, one per record.
+ */
+interface SlugField {
+    readonly kind: "slug";
+    readonly label: string;
+}
 /**
  * A record of a collection of the schema, by its id: the teacher of a practice. `collection` is
  * where that collection is, its name or a path through groups: "teachers", "studio.teachers".
@@ -108,7 +117,7 @@ interface CollectionField<F extends RecordFields = RecordFields> {
     /** The field of a record that names it in the editor: a text field, or a link by its text. */
     readonly itemTitle?: keyof F & string;
 }
-type Field = TextField | RichTextField | NumberField | DateField | ImageField | LinkField | ToggleField | ChoiceField | ChoicesField | UrlField | TimeField | ReferenceField | ReferencesField | GroupField | CollectionField;
+type Field = TextField | RichTextField | NumberField | DateField | ImageField | LinkField | ToggleField | ChoiceField | ChoicesField | UrlField | TimeField | SlugField | ReferenceField | ReferencesField | GroupField | CollectionField;
 type FieldKind = Field["kind"];
 /** Field names to fields; the order of the keys is the order of the form. */
 interface Fields {
@@ -133,6 +142,7 @@ declare function choice<const O extends readonly ChoiceOption[]>(options: FieldO
 declare function choices<const O extends readonly ChoiceOption[]>(options: FieldOptions<ChoicesField<O>>): ChoicesField<O>;
 declare function url(options: FieldOptions<UrlField>): UrlField;
 declare function time(options: FieldOptions<TimeField>): TimeField;
+declare function slug(options: FieldOptions<SlugField>): SlugField;
 declare function reference(options: FieldOptions<ReferenceField>): ReferenceField;
 declare function references(options: FieldOptions<ReferencesField>): ReferencesField;
 declare function group<F extends Fields>(options: FieldOptions<GroupField<F>>): GroupField<F>;
@@ -191,7 +201,7 @@ interface LinkValue {
  * The value of each field. A text can be empty (""), the other scalar fields can be unset (null):
  * content is filled in by people, so a site must be ready for a missing price or date.
  */
-type ValueOf<F extends Field> = F extends TextField ? string : F extends RichTextField ? RichText : F extends NumberField ? number | null : F extends DateField ? string | null : F extends ImageField ? ImageValue | null : F extends LinkField ? LinkValue | null : F extends ToggleField ? boolean : F extends ChoiceField<infer Options> ? OptionValue<Options> | null : F extends ChoicesField<infer Options> ? readonly OptionValue<Options>[] : F extends UrlField ? string | null : F extends TimeField ? string | null : F extends ReferenceField ? string | null : F extends ReferencesField ? readonly string[] : F extends GroupField<infer Group> ? ContentOf<Group> : F extends CollectionField<infer Item> ? readonly RecordOf<Item>[] : never;
+type ValueOf<F extends Field> = F extends TextField ? string : F extends RichTextField ? RichText : F extends NumberField ? number | null : F extends DateField ? string | null : F extends ImageField ? ImageValue | null : F extends LinkField ? LinkValue | null : F extends ToggleField ? boolean : F extends ChoiceField<infer Options> ? OptionValue<Options> | null : F extends ChoicesField<infer Options> ? readonly OptionValue<Options>[] : F extends UrlField ? string | null : F extends TimeField ? string | null : F extends SlugField ? string : F extends ReferenceField ? string | null : F extends ReferencesField ? readonly string[] : F extends GroupField<infer Group> ? ContentOf<Group> : F extends CollectionField<infer Item> ? readonly RecordOf<Item>[] : never;
 /**
  * A record of a collection: its fields and its id. The id is missing only in content no editor has
  * saved yet, such as a site's initial content (see withRecordIds).
@@ -256,6 +266,16 @@ type ContentIssue = {
     readonly path: FieldPath;
     readonly code: "missing-record";
     readonly id: string;
+}
+/** A slug with a character an address does not have. */
+ | {
+    readonly path: FieldPath;
+    readonly code: "invalid-slug";
+}
+/** A slug another record of the collection has as its slug or its id. */
+ | {
+    readonly path: FieldPath;
+    readonly code: "taken-slug";
 };
 interface ParsedContent<C> {
     readonly content: C;
@@ -274,9 +294,10 @@ declare function countCharacters(text: string): number;
  * - 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.
+ * - a reference to a record its collection does not have (removed since) is kept, with an issue;
+ * - a slug another record of the collection has 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 };
+export { parseContent as $, collection as A, countCharacters as B, type Content 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, type SlugField as S, type TextField as T, type UrlField as U, type ValueOf as V, image as W, linesOf as X, link as Y, normalizedLine as Z, number as _, type FieldPath as a, plainTextOf as a0, readRichText as a1, reference as a2, references as a3, richText as a4, richTextOf as a5, slug as a6, text as a7, time as a8, toggle as a9, url as aa, type ContentOf as b, type Field as c, type CollectionField as d, type RecordFields as e, type RecordOf as f, type ContentIssue as g, type ImageValue as h, type LinkField as i, type ChoicesField as j, type TimeField as k, type ChoiceField as l, type ChoiceOption as m, type FieldKind as n, type FieldValue as o, type ImageFocus 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,3 +1,6 @@
+import { C as Content } from './parse-content-IOJxgKLB.js';
+import { S as SiteDescription } from './site-description-BuEpga8p.js';
+
 /** Far more than the content of a site ever takes; a bigger body is not a draft. */
 declare const MAX_DRAFT_BYTES: number;
 /**
@@ -17,7 +20,18 @@ type DraftReading = {
  * page's own bridge renders a draft.
  */
 declare function readDraft(request: Request): Promise<DraftReading>;
+/**
+ * Whether the address may be a page of the site: one of its pages, or under its pages of records.
+ * The preview answers anything else at once, without asking the CMS or reading a draft.
+ */
+declare function isPageAddress(description: SiteDescription, rest: string | undefined): boolean;
+/**
+ * The published content, with a blank record when the address is the page of a record it does not
+ * have: one the editor added since the publication, at its id. The editor renders its draft on the
+ * page at once, so the blank record only brings the page with its bridge to the editor.
+ */
+declare function previewContentAt(description: SiteDescription, content: Content, rest: string | undefined): Content;
 /** 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, previewHeadersOf, readDraft };
+export { type DraftReading, MAX_DRAFT_BYTES, isPageAddress, isUploadedPhoto, previewContentAt, previewHeadersOf, readDraft };

package/dist/preview-requests.js

@@ -1,12 +1,18 @@
 import {
   MAX_DRAFT_BYTES,
+  isPageAddress,
   isUploadedPhoto,
+  previewContentAt,
   previewHeadersOf,
   readDraft
-} from "./chunk-QL4K4HR6.js";
+} from "./chunk-QXPXIMIM.js";
+import "./chunk-G6Z44LGA.js";
+import "./chunk-I3HOJE3S.js";
 export {
   MAX_DRAFT_BYTES,
+  isPageAddress,
   isUploadedPhoto,
+  previewContentAt,
   previewHeadersOf,
   readDraft
 };

package/dist/protocol.d.ts

@@ -1,6 +1,6 @@
-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';
+import { S as Shortcut, T as TextFormats } from './messages-Bqgs_mic.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-Bqgs_mic.js';
+import { F as Fields, a as FieldPath, I as ImageField, R as RichText } from './parse-content-IOJxgKLB.js';
 
 declare function shortcutOf(event: KeyboardEvent): Shortcut | undefined;
 

package/dist/protocol.js

@@ -22,9 +22,9 @@ import {
   shortcutOf,
   toggleList,
   toggleMark
-} from "./chunk-SSECNMAD.js";
-import "./chunk-ZS32CW5F.js";
+} from "./chunk-PLNPM2D3.js";
 import "./chunk-QCVWHHJC.js";
+import "./chunk-I3HOJE3S.js";
 export {
   OWN_PHOTOS_PATH,
   PROTOCOL_VERSION,

package/dist/routes/media.js

@@ -3,7 +3,9 @@ import {
 } from "../chunk-QCVWHHJC.js";
 import {
   isUploadedPhoto
-} from "../chunk-QL4K4HR6.js";
+} from "../chunk-QXPXIMIM.js";
+import "../chunk-G6Z44LGA.js";
+import "../chunk-I3HOJE3S.js";
 
 // src/routes/media.ts
 import { cmsOrigin } from "virtual:seamlet/config";

package/dist/schema.d.ts

@@ -1,6 +1,6 @@
-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';
+import { h as ImageValue, L as LinkValue, d as CollectionField, C as Content, F as Fields, e as RecordFields, b as ContentOf, G as GroupField, i as LinkField, T as TextField, U as UrlField, j as ChoicesField, k as TimeField, I as ImageField } from './parse-content-IOJxgKLB.js';
+export { l as ChoiceField, m as ChoiceOption, g as ContentIssue, D as DateField, c as Field, n as FieldKind, a as FieldPath, o as FieldValue, p as ImageFocus, N as NumberField, O as OptionValue, P as ParsedContent, f as RecordOf, q as ReferenceField, r as ReferencesField, s as RichBlock, t as RichLine, u as RichSpan, R as RichText, v as RichTextField, S as SlugField, 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, W as image, X as linesOf, Y as link, Z as normalizedLine, _ as number, $ as parseContent, a0 as plainTextOf, a1 as readRichText, a2 as reference, a3 as references, a4 as richText, a5 as richTextOf, a6 as slug, a7 as text, a8 as time, a9 as toggle, aa as url } from './parse-content-IOJxgKLB.js';
+export { C as CollectionPath, F as FIELD_PATH_SEPARATOR, b as FieldTarget, c as FieldsReading, H as HOME_PAGE_PATH, P as PAGE_PATH_SEPARATOR, d as PageProblemReason, e as PlacedRecord, R as RECORD_PLACEHOLDER, f as RecordFieldsAt, g as RecordPagePath, h as RecordPageProblemReason, i as RecordPages, j as SITE_DESCRIPTION_PATH, k as SchemaProblem, l as SchemaProblemReason, S as SiteDescription, m as SiteDescriptionProblem, n as SiteDescriptionReading, o as SitePageDescription, a as SiteRecordPageDescription, p as checkFields, q as checkSiteDescription, r as isRecordPagePath, s as isSearchTextsGroup, t as readFields, u as readSiteDescription, v as recordAddressOf, w as recordAt, x as recordPageAt, y as recordPagePath, z as recordPages, A as resolveFieldPath } from './site-description-BuEpga8p.js';
 
 declare const FIELD_PATH_ATTRIBUTE = "data-cms-path";
 interface FieldMarker {
@@ -21,24 +21,6 @@ type ContentPath<C> = C extends Leaf ? never : C extends readonly (infer Record)
  */
 declare function editable<C>(): (...path: ContentPath<C>) => FieldMarker;
 
-/** What a path written on a page points at: a field, or a whole record of a collection. */
-type FieldTarget = {
-    readonly kind: "field";
-    readonly path: FieldPath;
-    readonly field: Field;
-} | {
-    readonly kind: "record";
-    readonly path: FieldPath;
-    readonly collection: CollectionField;
-    /** The place of the record in its collection, the last segment of its path. */
-    readonly index: number;
-};
-/**
- * Reads a path from a field marker (`menu.2.price`) by the schema: names inside fields and
- * groups, indexes inside collections. A path the schema does not have gives undefined.
- */
-declare function resolveFieldPath(schema: Fields, text: string): FieldTarget | undefined;
-
 declare const RECORD_ID_KEY = "id";
 declare function isRecordId(value: unknown): value is string;
 /** A new record of a collection: its fields empty, its id the given one. */
@@ -57,6 +39,8 @@ interface CollectionRecords {
  * its records in the content; undefined when the schema has no collection there.
  */
 declare function collectionAt(schema: Fields, content: Content, path: string): CollectionRecords | undefined;
+/** The collection at a path of the schema through groups (`"studio.teachers"`), if it has one there. */
+declare function collectionFieldAt(schema: Fields, path: string): CollectionField | undefined;
 /** The record of the list with the id, if it is there. */
 declare function findRecord<R extends {
     readonly id?: string;
@@ -179,6 +163,11 @@ declare function openingHoursField(options?: {
 /** An object of named values: not null, not a list. */
 type JsonObject = Readonly<Record<string, unknown>>;
 declare function isJsonObject(value: unknown): value is JsonObject;
+/**
+ * Whether the value can be the content of a group or a record: an object of named values. What
+ * the values are is checked by the fields (see parseContent).
+ */
+declare function isContentObject(value: unknown): value is Content;
 
 /** The file at the root of a site's repository. */
 declare const SITE_CONFIG_FILE = "seamlet.json";
@@ -203,4 +192,17 @@ 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, 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 };
+/** Long enough for a name of a product, short enough to read in an address. */
+declare const MAX_SLUG_LENGTH = 80;
+/** Whether the value can be the address of a record's page: `latte`, `banya-6x4`. */
+declare function isSlug(value: string): boolean;
+/**
+ * The address a record's page takes from words: «Баня из бруса 6×4» is `banya-iz-brusa-6x4`. Empty
+ * when the words have no letter or digit to keep.
+ */
+declare function slugOf(words: string): string;
+
+/** The name of the slug of a record of the collection, if its records have one. */
+declare function slugFieldOf(item: RecordFields): string | undefined;
+
+export { ChoicesField, CollectionField, type CollectionRecords, Content, ContentOf, type ContentPath, FIELD_PATH_ATTRIBUTE, type FieldMarker, Fields, GroupField, ImageField, ImageValue, type JsonObject, LinkField, type LinkKind, type LinkTarget, LinkValue, MAX_SLUG_LENGTH, RECORD_ID_KEY, REVEALED_ATTRIBUTE, REVEAL_ATTRIBUTE, REVEAL_EVENT, RecordFields, SITE_CONFIG_FILE, type SiteConfig, type SiteConfigField, type SiteConfigReading, TextField, TimeField, UrlField, WEEKDAYS, collectionAt, collectionFieldAt, contactsFields, editable, findRecord, hrefOf, imagePosition, isContentObject, isJsonObject, isRecordId, isSiteId, isSlug, linkTargetOf, newRecord, openingHoursField, readSiteConfig, safeHref, seoFields, slugFieldOf, slugOf, withRecordIds };

package/dist/schema.js

@@ -1,7 +1,11 @@
 import {
   FIELD_PATH_ATTRIBUTE,
+  FIELD_PATH_SEPARATOR,
   HOME_PAGE_PATH,
+  MAX_SLUG_LENGTH,
+  PAGE_PATH_SEPARATOR,
   RECORD_ID_KEY,
+  RECORD_PLACEHOLDER,
   REVEALED_ATTRIBUTE,
   REVEAL_ATTRIBUTE,
   REVEAL_EVENT,
@@ -15,6 +19,7 @@ import {
   choices,
   collection,
   collectionAt,
+  collectionFieldAt,
   contactsFields,
   countCharacters,
   date,
@@ -28,10 +33,13 @@ import {
   hrefOf,
   image,
   imagePosition,
+  isContentObject,
   isJsonObject,
   isRecordId,
+  isRecordPagePath,
   isSearchTextsGroup,
   isSiteId,
+  isSlug,
   linesOf,
   link,
   linkTargetOf,
@@ -45,6 +53,11 @@ import {
   readRichText,
   readSiteConfig,
   readSiteDescription,
+  recordAddressOf,
+  recordAt,
+  recordPageAt,
+  recordPagePath,
+  recordPages,
   reference,
   references,
   resolveFieldPath,
@@ -52,16 +65,23 @@ import {
   richTextOf,
   safeHref,
   seoFields,
+  slug,
+  slugFieldOf,
+  slugOf,
   text,
   time,
   toggle,
   url,
   withRecordIds
-} from "./chunk-ZS32CW5F.js";
+} from "./chunk-I3HOJE3S.js";
 export {
   FIELD_PATH_ATTRIBUTE,
+  FIELD_PATH_SEPARATOR,
   HOME_PAGE_PATH,
+  MAX_SLUG_LENGTH,
+  PAGE_PATH_SEPARATOR,
   RECORD_ID_KEY,
+  RECORD_PLACEHOLDER,
   REVEALED_ATTRIBUTE,
   REVEAL_ATTRIBUTE,
   REVEAL_EVENT,
@@ -75,6 +95,7 @@ export {
   choices,
   collection,
   collectionAt,
+  collectionFieldAt,
   contactsFields,
   countCharacters,
   date,
@@ -88,10 +109,13 @@ export {
   hrefOf,
   image,
   imagePosition,
+  isContentObject,
   isJsonObject,
   isRecordId,
+  isRecordPagePath,
   isSearchTextsGroup,
   isSiteId,
+  isSlug,
   linesOf,
   link,
   linkTargetOf,
@@ -105,6 +129,11 @@ export {
   readRichText,
   readSiteConfig,
   readSiteDescription,
+  recordAddressOf,
+  recordAt,
+  recordPageAt,
+  recordPagePath,
+  recordPages,
   reference,
   references,
   resolveFieldPath,
@@ -112,6 +141,9 @@ export {
   richTextOf,
   safeHref,
   seoFields,
+  slug,
+  slugFieldOf,
+  slugOf,
   text,
   time,
   toggle,

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

@@ -0,0 +1,245 @@
+import { a as FieldPath, c as Field, d as CollectionField, F as Fields, G as GroupField, C as Content, e as RecordFields, f as RecordOf, g as ContentIssue } from './parse-content-IOJxgKLB.js';
+
+/** What a path written on a page points at: a field, or a whole record of a collection. */
+type FieldTarget = {
+    readonly kind: "field";
+    readonly path: FieldPath;
+    readonly field: Field;
+} | {
+    readonly kind: "record";
+    readonly path: FieldPath;
+    readonly collection: CollectionField;
+    /** The place of the record in its collection, the last segment of its path. */
+    readonly index: number;
+};
+/**
+ * What separates the names of a path written as text: a field marker (`menu.2.price`) and the
+ * collection a reference names (`studio.teachers`). A field's name never holds it.
+ */
+declare const FIELD_PATH_SEPARATOR = ".";
+/**
+ * Reads a path from a field marker (`menu.2.price`) by the schema: names inside fields and
+ * groups, indexes inside collections. A path the schema does not have gives undefined.
+ */
+declare function resolveFieldPath(schema: Fields, text: string): FieldTarget | undefined;
+
+/** 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"
+/** A slug that is not the one slug of a record of a collection: only a record's page has one. */
+ | "misplaced-slug";
+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;
+
+/** What stands for the record in the address of its page: `/menu/[record]`. */
+declare const RECORD_PLACEHOLDER = "[record]";
+/** The pages of the records of a collection, as a site describes them to the CMS. */
+interface SiteRecordPageDescription {
+    /** The address of a record's page, its slug or id in place of `[record]`: `/menu/[record]`. */
+    readonly path: string;
+    /** The collection whose every record has a page: `menu`, or through groups, `catalog.products`. */
+    readonly collection: string;
+    /**
+     * Where a record holds what search engines show for its page: a group of the record with a
+     * `title` and a `description` text (`seo`).
+     */
+    readonly searchTexts?: string;
+}
+/** A record of a collection and its place there. */
+interface PlacedRecord {
+    readonly record: Content;
+    readonly index: number;
+}
+/** The pages of the records of a collection, with the address of each record's page. */
+interface RecordPages<R> extends SiteRecordPageDescription {
+    /** The address of the record's page: `/menu/latte`; none for a record with neither slug nor id. */
+    readonly pathOf: (record: R) => string | undefined;
+}
+/** The address of a record's page with `[record]` in place of the record. */
+type RecordPagePath = `/${string}/${typeof RECORD_PLACEHOLDER}`;
+/** The paths of the collections of a schema, through its groups: `menu`, `catalog.products`. */
+type CollectionPath<F extends Fields> = {
+    [Name in keyof F & string]: F[Name] extends {
+        readonly kind: "collection";
+    } ? Name : F[Name] extends GroupField<infer Inner> ? `${Name}${typeof FIELD_PATH_SEPARATOR}${CollectionPath<Inner>}` : never;
+}[keyof F & string];
+/** The fields of a record of the collection at the path of the schema. */
+type RecordFieldsAt<F extends Fields, P extends string> = P extends `${infer Name}${typeof FIELD_PATH_SEPARATOR}${infer Rest}` ? F[Name] extends GroupField<infer Inner> ? RecordFieldsAt<Inner, Rest> : never : F[P] extends CollectionField<infer Item extends RecordFields> ? Item : never;
+/** What separates the segments of a page's address: `/menu/latte`. */
+declare const PAGE_PATH_SEPARATOR = "/";
+/**
+ * A page of every record of a collection of the schema at the address with `[record]`:
+ * `recordPages(schema, { collection: "menu", path: "/menu/[record]" })`. A site gives it to
+ * `defineSeamletSite` with the component that renders a record, and links to a record's page with
+ * its `pathOf`.
+ */
+declare function recordPages<F extends Fields, const P extends CollectionPath<F>>(schema: F, options: {
+    readonly collection: P;
+    readonly path: RecordPagePath;
+    readonly searchTexts?: string;
+}): RecordPages<RecordOf<RecordFieldsAt<F, P>>>;
+/** Whether the path can be the address of the pages of records: `/menu/[record]`. */
+declare function isRecordPagePath(path: unknown): path is string;
+/** The address of a record's page: its slug, or its id while it has none. */
+declare function recordAddressOf<F extends RecordFields>(collection: CollectionField<F>, record: Content): string | undefined;
+/** The address of a record's page on the site: `/menu/latte` for `/menu/[record]` and `latte`. */
+declare function recordPagePath(pagePath: string, address: string): string;
+/**
+ * The pages of records the path is the address of, with the record's part of it: `/menu/latte` is
+ * `latte` of `/menu/[record]`.
+ */
+declare function recordPageAt<P extends SiteRecordPageDescription>(pages: readonly P[], path: string): {
+    readonly page: P;
+    readonly address: string;
+} | undefined;
+/**
+ * The record at the address of its page: the record whose page it is, or the record with that id,
+ * as the editor opens a page, since a slug may change while the page is open.
+ */
+declare function recordAt<F extends RecordFields>(collection: CollectionField<F>, records: readonly Content[], address: string): PlacedRecord | undefined;
+
+/** 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 pages of the records of collections; left out when the site has none. */
+    readonly recordPages?: readonly SiteRecordPageDescription[];
+}
+/** 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;
+}
+/** The pages of records are not a list. */
+ | {
+    readonly code: "invalid-record-pages";
+}
+/** The pages of records at this place of their list are not such pages, or not of this site. */
+ | {
+    readonly code: "invalid-record-page";
+    readonly index: number;
+    readonly reason: RecordPageProblemReason;
+}
+/** Two kinds of pages for the records of one collection: a record has one page. */
+ | {
+    readonly code: "repeated-record-pages";
+    readonly collection: string;
+}
+/** A page of the site where the pages of records are: `/menu/specials` beside `/menu/[record]`. */
+ | {
+    readonly code: "page-among-record-pages";
+    readonly path: string;
+}
+/** A record of the initial content whose page has no address: neither a slug nor an id. */
+ | {
+    readonly code: "record-without-address";
+    readonly collection: string;
+    readonly index: number;
+}
+/** Two records of the initial content whose pages have one address: the same id, or slug. */
+ | {
+    readonly code: "repeated-record-address";
+    readonly collection: string;
+    readonly address: 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 RecordPageProblemReason = "not-a-page"
+/** Not the address of a page, then `/[record]`, such as `/menu/[record]`. */
+ | "invalid-path"
+/** Not a collection of the schema. */
+ | "unknown-collection"
+/** Not where a record 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 { resolveFieldPath as A, type CollectionPath as C, FIELD_PATH_SEPARATOR as F, HOME_PAGE_PATH as H, PAGE_PATH_SEPARATOR as P, RECORD_PLACEHOLDER as R, type SiteDescription as S, type SiteRecordPageDescription as a, type FieldTarget as b, type FieldsReading as c, type PageProblemReason as d, type PlacedRecord as e, type RecordFieldsAt as f, type RecordPagePath as g, type RecordPageProblemReason as h, type RecordPages as i, SITE_DESCRIPTION_PATH as j, type SchemaProblem as k, type SchemaProblemReason as l, type SiteDescriptionProblem as m, type SiteDescriptionReading as n, type SitePageDescription as o, checkFields as p, checkSiteDescription as q, isRecordPagePath as r, isSearchTextsGroup as s, readFields as t, readSiteDescription as u, recordAddressOf as v, recordAt as w, recordPageAt as x, recordPagePath as y, recordPages as z };