@seamlet/astro 0.11.3 → 0.12.1

package/dist/cli.js

@@ -3,7 +3,10 @@ import {
   SITE_CONFIG_FILE,
   isSiteId,
   readSiteConfig
-} from "./chunk-DRDPKFHZ.js";
+} from "./chunk-ZS32CW5F.js";
+import {
+  SITE_MODULE_FILE
+} from "./chunk-QCVWHHJC.js";
 
 // src/cli.ts
 import process from "process";
@@ -14,20 +17,21 @@ import { join as join2 } from "path";
 import { parseArgs } from "util";
 
 // src/init/site-files.ts
-var SITE_MODULE_PATH = "src/seamlet.ts";
 var SCHEMA_PATH = "src/schema.ts";
-var HOME_PAGE_PATH = "src/components/HomePage.astro";
+var HOME_PAGE_FILE = "src/components/HomePage.astro";
 var JSON_INDENT = 2;
-function siteFilesOf(config) {
-  return [
-    {
-      path: SITE_CONFIG_FILE,
-      text: `${JSON.stringify(config, null, JSON_INDENT)}
+function configFileOf(config) {
+  return {
+    path: SITE_CONFIG_FILE,
+    text: `${JSON.stringify(config, null, JSON_INDENT)}
 `
-    },
+  };
+}
+function moduleFilesOf(config) {
+  return [
     { path: SCHEMA_PATH, text: schemaModuleOf(config.title) },
-    { path: SITE_MODULE_PATH, text: SITE_MODULE },
-    { path: HOME_PAGE_PATH, text: HOME_PAGE }
+    { path: SITE_MODULE_FILE, text: SITE_MODULE },
+    { path: HOME_PAGE_FILE, text: HOME_PAGE }
   ];
 }
 function siteIdOf(packageName) {
@@ -41,7 +45,7 @@ function schemaModuleOf(title) {
 // What the site's owner edits in the CMS. Add a field here, show it on a page and mark its element
 // with edit(...): the CMS builds its form from this schema alone.
 export const schema = defineSchema({
-  title: text({ label: "\u0417\u0430\u0433\u043E\u043B\u043E\u0432\u043E\u043A", maxLength: 80 }),
+  title: text({ label: "\u0417\u0430\u0433\u043E\u043B\u043E\u0432\u043E\u043A" }),
 });
 
 export type Content = ContentOf<typeof schema>;
@@ -83,30 +87,46 @@ const edit = editable<Content>();
 `;
 
 // src/init/write-site-files.ts
-import { mkdir, writeFile } from "fs/promises";
+import { access, mkdir, writeFile } from "fs/promises";
 import { dirname, join } from "path";
 var ALREADY_EXISTS = "EEXIST";
+var MISSING = "ENOENT";
 async function writeSiteFiles(root, files) {
-  const written = [];
-  const kept = [];
+  const paths = files.map((file) => file.path);
+  if (await isAnyThere(root, paths)) return { written: [], kept: paths };
   for (const file of files) {
-    const isWritten = await writeNewFile(join(root, file.path), file.text);
-    (isWritten ? written : kept).push(file.path);
+    await writeNewFile(join(root, file.path), file.text);
+  }
+  return { written: paths, kept: [] };
+}
+async function isAnyThere(root, paths) {
+  for (const path of paths) {
+    if (await isThere(join(root, path))) return true;
+  }
+  return false;
+}
+async function isThere(path) {
+  try {
+    await access(path);
+    return true;
+  } catch (error) {
+    if (hasCode(error, MISSING)) return false;
+    throw new Error(`@seamlet/astro: cannot read ${path}`, { cause: error });
   }
-  return { written, kept };
 }
 async function writeNewFile(path, text) {
-  await mkdir(dirname(path), { recursive: true });
   try {
+    await mkdir(dirname(path), { recursive: true });
     await writeFile(path, text, { flag: "wx" });
-    return true;
   } catch (error) {
-    if (isAlreadyThere(error)) return false;
-    throw new Error(`@seamlet/astro: cannot write ${path}`, { cause: error });
+    const reason = hasCode(error, ALREADY_EXISTS) ? " (it appeared meanwhile)" : "";
+    throw new Error(`@seamlet/astro: cannot write ${path}${reason}`, {
+      cause: error
+    });
   }
 }
-function isAlreadyThere(error) {
-  return error instanceof Error && "code" in error && error.code === ALREADY_EXISTS;
+function hasCode(error, code2) {
+  return error instanceof Error && "code" in error && error.code === code2;
 }
 
 // src/init/init-command.ts
@@ -114,6 +134,7 @@ var DEFAULT_CMS = "https://cms.seamlet.ru";
 var SUCCESS = 0;
 var FAILURE = 1;
 var MISUSE = 2;
+var MISSING2 = "ENOENT";
 var USAGE = `Usage: npx @seamlet/astro init [--id <id>] [--title <title>] [--cms <address>]
 
 Writes ${SITE_CONFIG_FILE} and a first module of the site in the Astro project here. The id is the
@@ -135,26 +156,64 @@ async function runInit(run) {
     run.log(USAGE);
     return MISUSE;
   }
-  const packageName = await packageNameOf(run.root);
+  const existing = await existingConfigOf(run.root);
+  const reading = existing ?? await configOfOptions(run.root, options);
+  if (reading.status === "invalid") {
+    run.log(invalidConfigMessage(reading, existing !== void 0));
+    return FAILURE;
+  }
+  const config = reading.config;
+  const configFile = await writeSiteFiles(run.root, [configFileOf(config)]);
+  const moduleFiles = await writeSiteFiles(run.root, moduleFilesOf(config));
+  logWritten(run, configFile);
+  logWritten(run, moduleFiles);
+  run.log(NEXT_STEPS);
+  return SUCCESS;
+}
+async function configOfOptions(root, options) {
+  const packageName = await packageNameOf(root);
   const id = options.id ?? siteIdOf(packageName ?? "");
-  const reading = readSiteConfig({
+  return readSiteConfig({
     id,
     title: options.title ?? id,
     cms: options.cms ?? DEFAULT_CMS
   });
-  if (reading.status === "invalid") {
-    const fields = reading.invalidFields.map((field) => `--${field}`).join(", ");
-    run.log(`Give the site ${fields}.
-
-${USAGE}`);
-    return FAILURE;
+}
+async function existingConfigOf(root) {
+  const path = join2(root, SITE_CONFIG_FILE);
+  let text;
+  try {
+    text = await readFile(path, "utf8");
+  } catch (error) {
+    if (hasCode(error, MISSING2)) return void 0;
+    throw new Error(`@seamlet/astro: cannot read ${path}`, { cause: error });
   }
-  const files = await writeSiteFiles(run.root, siteFilesOf(reading.config));
+  return readSiteConfig(parsedOrNothing(text));
+}
+function parsedOrNothing(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+}
+function invalidConfigMessage(reading, isExisting) {
+  if (isExisting) {
+    const fields = reading.invalidFields.map((field) => `"${field}"`).join(", ");
+    return `The site's ${SITE_CONFIG_FILE} needs ${fields}: fix it, or remove it to write a new one.`;
+  }
+  const options = reading.invalidFields.map((field) => `--${field}`).join(", ");
+  return `Give the site ${options}.
+
+${USAGE}`;
+}
+function logWritten(run, files) {
   for (const path of files.written) run.log(`wrote ${path}`);
-  for (const path of files.kept)
-    run.log(`kept ${path}: the site has it already`);
-  run.log(NEXT_STEPS);
-  return SUCCESS;
+  for (const path of files.kept) {
+    run.log(
+      `kept ${path}: the site has it, or a file that goes with it, already`
+    );
+  }
 }
 function optionsOf(argv) {
   try {

package/dist/client.js

@@ -1,6 +1,9 @@
+import {
+  PREVIEW_PATH
+} from "./chunk-QCVWHHJC.js";
+
 // src/client.ts
 import { cmsOrigin } from "virtual:seamlet/config";
-var PREVIEW_PATH = "/preview";
 var isFramed = window.parent !== window;
 var { pathname } = window.location;
 var isPreview = pathname === PREVIEW_PATH || pathname.startsWith(`${PREVIEW_PATH}/`);

package/dist/index.js

@@ -1,14 +1,20 @@
 import {
   OWN_PHOTOS_PATH
-} from "./chunk-3BS5CE26.js";
+} from "./chunk-W2LIOR2C.js";
 import {
   SITE_CONFIG_FILE,
   SITE_DESCRIPTION_PATH,
+  isJsonObject,
   readSiteConfig
-} from "./chunk-DRDPKFHZ.js";
+} from "./chunk-ZS32CW5F.js";
+import {
+  PREVIEW_PATH,
+  SITE_MODULE_FILE,
+  UPLOADS_PATH
+} from "./chunk-QCVWHHJC.js";
 import {
   isUploadedPhoto
-} from "./chunk-P2OQOZBC.js";
+} from "./chunk-QL4K4HR6.js";
 
 // src/index.ts
 import process from "process";
@@ -17,28 +23,35 @@ import { fileURLToPath as fileURLToPath2 } from "url";
 // src/uploaded-photos.ts
 import { mkdir, readdir, readFile, writeFile } from "fs/promises";
 import { dirname, join } from "path";
-var PHOTO_ADDRESS = /\/media\/([a-z0-9-]+)\/([A-Za-z0-9_-]+\.webp)/gu;
+var PHOTO_ADDRESS = new RegExp(
+  `${UPLOADS_PATH}/([^/\\s"'<>]+)/([^/\\s"'<>?#]+)`,
+  "gu"
+);
 var HTML_EXTENSION = ".html";
-function uploadedPhotoAddresses(html) {
+var PHOTOS_COPIED_AT_ONCE = 6;
+var PHOTO_TIMEOUT_MS = 6e4;
+function uploadedPhotoAddresses(html, siteId) {
   const addresses = [...html.matchAll(PHOTO_ADDRESS)].flatMap(
-    ([address, , fileName]) => isUploadedPhoto(fileName) ? [address] : []
+    ([address, site, fileName]) => site === siteId && isUploadedPhoto(fileName) ? [address] : []
   );
   return [...new Set(addresses)];
 }
 async function copyUploadedPhotos(options) {
   const pages = await htmlFilesIn(options.directory);
   const texts = await Promise.all(pages.map((page) => readFile(page, "utf8")));
-  const addresses = new Set(texts.flatMap(uploadedPhotoAddresses));
-  await Promise.all(
-    [...addresses].map(
-      (address) => copyPhoto(address, options.directory, options.cmsOrigin)
-    )
+  const addresses = new Set(
+    texts.flatMap((text) => uploadedPhotoAddresses(text, options.siteId))
+  );
+  await inTurns(
+    [...addresses],
+    PHOTOS_COPIED_AT_ONCE,
+    (address) => copyPhoto(address, options.directory, options.cmsOrigin)
   );
   return addresses.size;
 }
 async function copyPhoto(address, directory, cmsOrigin) {
   const url = new URL(address, cmsOrigin);
-  const response = await fetch(url);
+  const response = await fetchPhoto(url);
   if (!response.ok) {
     throw new Error(
       `Copying the photo ${url.href} into the build failed with status ${String(response.status)}`
@@ -48,6 +61,29 @@ async function copyPhoto(address, directory, cmsOrigin) {
   await mkdir(dirname(target), { recursive: true });
   await writeFile(target, new Uint8Array(await response.arrayBuffer()));
 }
+async function fetchPhoto(url) {
+  try {
+    return await fetch(url, { signal: AbortSignal.timeout(PHOTO_TIMEOUT_MS) });
+  } catch (error) {
+    throw new Error(
+      `Copying the photo ${url.href} into the build failed: the CMS did not answer`,
+      { cause: error }
+    );
+  }
+}
+async function inTurns(items, limit, task) {
+  const waiting = [...items];
+  const runInTurn = async () => {
+    for (let item = waiting.shift(); item !== void 0; item = waiting.shift()) {
+      await task(item);
+    }
+  };
+  const runners = Array.from(
+    { length: Math.min(limit, waiting.length) },
+    runInTurn
+  );
+  await Promise.all(runners);
+}
 async function htmlFilesIn(directory) {
   const entries = await readdir(directory, {
     recursive: true,
@@ -68,7 +104,7 @@ async function loadSiteConfig(root, cmsOverride) {
   const file = new URL(SITE_CONFIG_FILE, root);
   const parsed = await readJsonFile(file);
   const isOverridden = cmsOverride !== void 0 && cmsOverride !== "";
-  const input = isOverridden ? { ...asObject(parsed), cms: cmsOverride } : parsed;
+  const input = isOverridden ? { ...isJsonObject(parsed) ? parsed : {}, cms: cmsOverride } : parsed;
   const reading = readSiteConfig(input);
   if (reading.status === "read") return reading.config;
   throw new Error(invalidFieldsMessage(file, reading.invalidFields));
@@ -91,9 +127,6 @@ async function readJsonFile(file) {
     });
   }
 }
-function asObject(value) {
-  return typeof value === "object" && value !== null ? value : {};
-}
 function invalidFieldsMessage(file, fields) {
   const lines = fields.map((field) => `  "${field}": ${FIELD_RULES[field]}`);
   return [
@@ -106,7 +139,6 @@ function invalidFieldsMessage(file, fields) {
 var CONFIG_MODULE = "virtual:seamlet/config";
 var SITE_MODULE = "virtual:seamlet/site";
 var RESOLVED_CONFIG_MODULE = `\0${CONFIG_MODULE}`;
-var SITE_MODULE_FILE = "src/seamlet.ts";
 var CMS_ORIGIN_VARIABLE = "CMS_ORIGIN";
 function seamlet() {
   let siteConfig;
@@ -146,12 +178,12 @@ function seamlet() {
         });
         injectScript("page", `import "@seamlet/astro/client";`);
         injectRoute({
-          pattern: "/preview/[...page]",
+          pattern: `${PREVIEW_PATH}/[...page]`,
           entrypoint: "@seamlet/astro/routes/preview.astro",
           prerender: false
         });
         injectRoute({
-          pattern: "/media/[site]/[file]",
+          pattern: `${UPLOADS_PATH}/[site]/[file]`,
           entrypoint: "@seamlet/astro/routes/media",
           prerender: false
         });
@@ -173,6 +205,7 @@ function seamlet() {
         if (siteConfig === void 0) return;
         const copied = await copyUploadedPhotos({
           directory: fileURLToPath2(dir),
+          siteId: siteConfig.id,
           cmsOrigin: siteConfig.cms
         });
         if (copied > 0) logger.info(`copied ${String(copied)} uploaded photos`);

package/dist/{messages-Dx0jNy3N.d.ts → messages-CvZhLRSE.d.ts}

@@ -1,5 +1,4 @@
-import { R as RichText, F as Fields, a as Content } from './content-6k-E7NWf.js';
-import { F as FieldPath } from './parse-content-C9ldnmvj.js';
+import { R as RichText, F as Fields, a as Content, b as FieldPath } from './parse-content-Eg8yRq_t.js';
 
 interface Box {
     readonly top: number;
@@ -12,52 +11,6 @@ interface Viewport {
     readonly height: number;
 }
 
-type Shortcut = "save" | "undo" | "redo";
-declare function shortcutOf(event: KeyboardEvent): Shortcut | undefined;
-
-type InlineEditingOutcome = "kept" | "reverted";
-
-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. */
-interface TextFormats {
-    readonly isBold: boolean;
-    readonly isItalic: boolean;
-    readonly isList: boolean;
-    /** The address of the link the selection is in, when all of it is in one link. */
-    readonly href: string | undefined;
-}
-/** 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;
-
-/** A change of formatting the editor's toolbar asks for. */
-type TextFormat = "bold" | "italic" | "list";
-/** The selection in the typed text: where it is on the page and what its words have. */
-interface TypedSelection {
-    readonly box: Box;
-    readonly isCollapsed: boolean;
-    readonly formats: TextFormats;
-}
-
 /**
  * The version of what the two say to each other. A site updates @seamlet/astro when it likes, so the
  * editor may meet a bridge of another version: it tells by this number, said with `ready`, instead
@@ -87,8 +40,32 @@ interface PageLayout {
     /** The link under the pointer, if it is not a field. */
     readonly link: LinkBox | undefined;
 }
+declare const SHORTCUTS: readonly ["save", "undo", "redo"];
+declare const EDITOR_KEY_NAMES: readonly ["save", "undo", "redo", "escape"];
+declare const TEXT_FORMAT_NAMES: readonly ["bold", "italic", "list"];
+declare const TYPING_OUTCOME_NAMES: readonly ["kept", "reverted"];
+/** A keyboard shortcut of the editor, pressed on the page. */
+type Shortcut = (typeof SHORTCUTS)[number];
 /** A key the editor acts on: its shortcuts, and Escape that closes what is open. */
-type EditorKey = Shortcut | "escape";
+type EditorKey = (typeof EDITOR_KEY_NAMES)[number];
+/** A change of formatting the editor's toolbar asks for. */
+type TextFormat = (typeof TEXT_FORMAT_NAMES)[number];
+/** How a typing in place ended: the typed text kept, or brought back as it was. */
+type InlineEditingOutcome = (typeof TYPING_OUTCOME_NAMES)[number];
+/** The marks of the selected words of a formatted text. */
+interface TextFormats {
+    readonly isBold: boolean;
+    readonly isItalic: boolean;
+    readonly isList: boolean;
+    /** The address of the link the selection is in, when all of it is in one link. */
+    readonly href: string | undefined;
+}
+/** The selection in the typed text: where it is on the page and what its words have. */
+interface TypedSelection {
+    readonly box: Box;
+    readonly isCollapsed: boolean;
+    readonly formats: TextFormats;
+}
 /** What the page tells the editor. */
 type PageMessage = 
 /** The bridge runs and waits for the editor to connect; it speaks this version of the protocol. */
@@ -208,8 +185,8 @@ type EditorMessage =
     readonly path: FieldPath;
 };
 /** The message the page sent, or undefined for anything that is not one. */
-declare function readPageMessage(data: unknown): PageMessage | undefined;
+declare function readPageMessage(posted: unknown): PageMessage | undefined;
 /** The message the editor sent, or undefined for anything that is not one. */
-declare function readEditorMessage(data: unknown): EditorMessage | undefined;
+declare function readEditorMessage(posted: unknown): EditorMessage | undefined;
 
-export { type Box as B, type EditorMessage as E, type InlineEditingOutcome as I, type LinkBox as L, type Mark as M, type PageMessage as P, type Shortcut as S, type TextSelection as T, type Viewport as V, type EditorKey as a, type MarkerBox as b, PROTOCOL_VERSION as c, type PageLayout as d, type Point as e, type TextFormat as f, type TextFormats as g, type TextPoint as h, type TypedSelection as i, formatsAt as j, isCollapsed as k, linkSelectionAt as l, readPageMessage as m, shortcutOf as n, toggleMark as o, readEditorMessage as r, setLink as s, toggleList as t };
+export { type Box as B, type EditorMessage as E, type InlineEditingOutcome as I, type LinkBox as L, type MarkerBox as M, type PageMessage as P, type Shortcut as S, type TextFormats as T, type Viewport as V, type EditorKey as a, PROTOCOL_VERSION as b, type PageLayout as c, type Point as d, type TextFormat as e, type TypedSelection as f, readPageMessage as g, readEditorMessage as r };

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-SSECNMAD.js";
+import "./chunk-ZS32CW5F.js";
+import "./chunk-QCVWHHJC.js";
 export {
   OWN_PHOTOS_PATH,
   PROTOCOL_VERSION,