@seamlet/astro 0.11.2 → 0.12.0

package/dist/{chunk-2E7VDSUK.js → chunk-MW3BE5O6.js}

@@ -1,9 +1,12 @@
 import {
   formatFieldPath,
+  isJsonObject,
+  linesOf,
   normalizedLine,
   readRichText,
-  resolveFieldPath
-} from "./chunk-DRDPKFHZ.js";
+  resolveFieldPath,
+  safeHref
+} from "./chunk-7GYJS7ZT.js";
 
 // src/bridge/editor-shortcuts.ts
 function shortcutOf(event) {
@@ -32,28 +35,20 @@ function imageFieldAt(schema, path) {
 
 // src/bridge/messages.ts
 var PROTOCOL_VERSION = 2;
-var EDITOR_KEYS = /* @__PURE__ */ new Set([
-  "save",
-  "undo",
-  "redo",
-  "escape"
-]);
-var TEXT_FORMATS = /* @__PURE__ */ new Set([
-  "bold",
-  "italic",
-  "list"
-]);
-var TYPING_OUTCOMES = /* @__PURE__ */ new Set([
-  "kept",
-  "reverted"
-]);
-function readPageMessage(data) {
-  if (!isRecord(data)) return void 0;
-  return isPageMessage(data) ? data : void 0;
-}
-function readEditorMessage(data) {
-  if (!isRecord(data)) return void 0;
-  return isEditorMessage(data) ? data : void 0;
+var SHORTCUTS = ["save", "undo", "redo"];
+var EDITOR_KEY_NAMES = [...SHORTCUTS, "escape"];
+var TEXT_FORMAT_NAMES = ["bold", "italic", "list"];
+var TYPING_OUTCOME_NAMES = ["kept", "reverted"];
+var EDITOR_KEYS = new Set(EDITOR_KEY_NAMES);
+var TEXT_FORMATS = new Set(TEXT_FORMAT_NAMES);
+var TYPING_OUTCOMES = new Set(TYPING_OUTCOME_NAMES);
+function readPageMessage(posted) {
+  if (!isJsonObject(posted)) return void 0;
+  return isPageMessage(posted) ? posted : void 0;
+}
+function readEditorMessage(posted) {
+  if (!isJsonObject(posted)) return void 0;
+  return isEditorMessage(posted) ? posted : void 0;
 }
 function isPageMessage(message) {
   switch (message["type"]) {
@@ -94,9 +89,9 @@ function isPageMessage(message) {
 function isEditorMessage(message) {
   switch (message["type"]) {
     case "connect":
-      return isRecord(message["schema"]);
+      return isJsonObject(message["schema"]);
     case "render":
-      return isRecord(message["content"]);
+      return isJsonObject(message["content"]);
     case "start-typing":
       return isString(message["path"]) && isString(message["text"]) && typeof message["isSingleLine"] === "boolean" && isPoint(message["point"]);
     case "start-rich-typing":
@@ -114,36 +109,36 @@ function isEditorMessage(message) {
   }
 }
 function isLayout(value) {
-  if (!isRecord(value)) return false;
+  if (!isJsonObject(value)) return false;
   const markers = value["markers"];
   return Array.isArray(markers) && markers.every(isMarkerBox) && isViewport(value["viewport"]) && isOptional(value["link"], isLinkBox);
 }
 function isMarkerBox(value) {
-  return isRecord(value) && isString(value["path"]) && isBox(value["box"]);
+  return isJsonObject(value) && isString(value["path"]) && isBox(value["box"]);
 }
 function isLinkBox(value) {
-  return isRecord(value) && isString(value["href"]) && isBox(value["box"]);
+  return isJsonObject(value) && isString(value["href"]) && isBox(value["box"]);
 }
 function isClickTarget(value) {
-  return isRecord(value) && isString(value["path"]) && isPoint(value["point"]);
+  return isJsonObject(value) && isString(value["path"]) && isPoint(value["point"]);
 }
 function isRichText(value) {
   return readRichText(value) !== void 0;
 }
 function isTypedSelection(value) {
-  return isRecord(value) && isBox(value["box"]) && typeof value["isCollapsed"] === "boolean" && isTextFormats(value["formats"]);
+  return isJsonObject(value) && isBox(value["box"]) && typeof value["isCollapsed"] === "boolean" && isTextFormats(value["formats"]);
 }
 function isTextFormats(value) {
-  return isRecord(value) && typeof value["isBold"] === "boolean" && typeof value["isItalic"] === "boolean" && typeof value["isList"] === "boolean" && isOptional(value["href"], isString);
+  return isJsonObject(value) && typeof value["isBold"] === "boolean" && typeof value["isItalic"] === "boolean" && typeof value["isList"] === "boolean" && isOptional(value["href"], isString);
 }
 function isBox(value) {
-  return isRecord(value) && isNumber(value["top"]) && isNumber(value["left"]) && isNumber(value["width"]) && isNumber(value["height"]);
+  return isJsonObject(value) && isNumber(value["top"]) && isNumber(value["left"]) && isNumber(value["width"]) && isNumber(value["height"]);
 }
 function isViewport(value) {
-  return isRecord(value) && isNumber(value["width"]) && isNumber(value["height"]);
+  return isJsonObject(value) && isNumber(value["width"]) && isNumber(value["height"]);
 }
 function isPoint(value) {
-  return isRecord(value) && isNumber(value["x"]) && isNumber(value["y"]);
+  return isJsonObject(value) && isNumber(value["x"]) && isNumber(value["y"]);
 }
 function isFieldPath(value) {
   return Array.isArray(value) && value.every((segment) => isString(segment) || isNumber(segment));
@@ -151,9 +146,6 @@ function isFieldPath(value) {
 function isOptional(value, isPresent) {
   return value === void 0 || isPresent(value);
 }
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function isString(value) {
   return typeof value === "string";
 }
@@ -377,9 +369,7 @@ function renderRichText(element, text) {
 }
 function renderInlineRichText(element, text) {
   const document = element.ownerDocument;
-  const lines = text.flatMap(
-    (block) => block.kind === "paragraph" ? [block.spans] : block.items
-  );
+  const lines = linesOf(text);
   const nodes = lines.flatMap((line, index) => [
     ...index > 0 ? [document.createElement("br")] : [],
     ...lineNodes(document, line)
@@ -461,9 +451,10 @@ function spanNode(document, span) {
   const words = wordsNode(document, span.text);
   const italic = span.italic === true ? wrapped(document, "em", words) : words;
   const bold = span.bold === true ? wrapped(document, "strong", italic) : italic;
-  if (span.href === void 0) return bold;
+  const href = span.href === void 0 ? void 0 : safeHref(span.href);
+  if (href === void 0) return bold;
   const link = wrapped(document, "a", bold);
-  link.setAttribute("href", span.href);
+  link.setAttribute("href", href);
   return link;
 }
 function wordsNode(document, text) {

package/dist/chunk-QCVWHHJC.js

@@ -0,0 +1,14 @@
+// src/site-addresses.ts
+var SITE_MODULE_FILE = "src/seamlet.ts";
+var PREVIEW_PATH = "/preview";
+var UPLOADS_PATH = "/media";
+function uploadedPhotoPath(siteId, fileName) {
+  return `${UPLOADS_PATH}/${siteId}/${fileName}`;
+}
+
+export {
+  SITE_MODULE_FILE,
+  PREVIEW_PATH,
+  UPLOADS_PATH,
+  uploadedPhotoPath
+};

package/dist/{chunk-P2OQOZBC.js → chunk-QL4K4HR6.js}

@@ -4,6 +4,13 @@ var BAD_REQUEST = 400;
 var PAYLOAD_TOO_LARGE = 413;
 var UNSUPPORTED_MEDIA_TYPE = 415;
 var UPLOADED_PHOTO = /^[A-Za-z0-9_-]+\.webp$/u;
+function previewHeadersOf(cmsOrigin) {
+  return {
+    "Content-Security-Policy": `frame-ancestors ${cmsOrigin}`,
+    "X-Robots-Tag": "noindex",
+    "Cache-Control": "no-store"
+  };
+}
 async function readDraft(request) {
   const isJson = request.headers.get("Content-Type")?.startsWith("application/json") === true;
   if (!isJson) return refused(UNSUPPORTED_MEDIA_TYPE);
@@ -50,6 +57,7 @@ function refused(status) {
 
 export {
   MAX_DRAFT_BYTES,
+  previewHeadersOf,
   readDraft,
   isUploadedPhoto
 };

package/dist/{chunk-3BS5CE26.js → chunk-W2LIOR2C.js}

@@ -1,10 +1,14 @@
+import {
+  UPLOADS_PATH
+} from "./chunk-QCVWHHJC.js";
+
 // src/own-photos.ts
 var OWN_PHOTOS_PATH = "/seamlet-photos";
-var UPLOADS_PATH = "/media/";
+var UPLOADS_FOLDER = `${UPLOADS_PATH}/`;
 var PARENT_SEGMENT = "..";
 function isOwnPhotoSrc(src) {
   const isOnSite = src.startsWith("/") && !src.startsWith("//");
-  const isUpload = src.startsWith(UPLOADS_PATH);
+  const isUpload = src.startsWith(UPLOADS_FOLDER);
   const isPlainPath = !/[?#\\]/u.test(src);
   const climbsUp = src.split("/").includes(PARENT_SEGMENT);
   return isOnSite && !isUpload && isPlainPath && !climbsUp;

package/dist/cli.js

@@ -3,7 +3,10 @@ import {
   SITE_CONFIG_FILE,
   isSiteId,
   readSiteConfig
-} from "./chunk-DRDPKFHZ.js";
+} from "./chunk-7GYJS7ZT.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-7GYJS7ZT.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 };