@seamlet/astro 0.7.0 → 0.8.1

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

@@ -211,4 +211,4 @@ 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 RecordFields 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 LinkField as e, type ChoicesField as f, type TimeField as g, type ChoiceField as h, type ChoiceOption as i, type FieldKind as j, type FieldValue as k, type ImageFocus as l, type RecordOf as m, type ReferenceField as n, type ReferencesField as o, type RichBlock as p, type RichLine as q, type RichSpan as r, type RichText 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 };
+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 };

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

@@ -1,5 +1,5 @@
-import { F as Fields, a as Content } from './content-DeBXwSmg.js';
-import { F as FieldPath } from './parse-content-DqToE6I6.js';
+import { R as RichText, F as Fields, a as Content } from './content-6k-E7NWf.js';
+import { F as FieldPath } from './parse-content-C9ldnmvj.js';
 
 interface Box {
     readonly top: number;
@@ -17,12 +17,53 @@ 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
  * of misreading the page. Raised whenever a message changes in a way the other side cannot read.
  */
-declare const PROTOCOL_VERSION = 1;
+declare const PROTOCOL_VERSION = 2;
 interface Point {
     readonly x: number;
     readonly y: number;
@@ -99,6 +140,18 @@ type PageMessage =
     readonly type: "typed";
     readonly path: string;
     readonly text: string;
+}
+/** The formatted text typed in place, after every character and every change of its marks. */
+ | {
+    readonly type: "rich-typed";
+    readonly path: string;
+    readonly text: RichText;
+}
+/** Where the selection in the typed formatted text is now, for the editor's toolbar. */
+ | {
+    readonly type: "typed-selection";
+    readonly path: string;
+    readonly selection: TypedSelection | undefined;
 } | {
     readonly type: "typing-ended";
     readonly path: string;
@@ -127,6 +180,25 @@ type EditorMessage =
     readonly text: string;
     readonly isSingleLine: boolean;
     readonly point: Point;
+}
+/** Type the formatted text of the field in its element, if the element shows it as it is. */
+ | {
+    readonly type: "start-rich-typing";
+    readonly path: string;
+    readonly text: RichText;
+    /** The words alone, in an element of one line. */
+    readonly isInline: boolean;
+    readonly point: Point;
+}
+/** Mark the selected words of the formatted text typed in place, or make its lines a list. */
+ | {
+    readonly type: "format-typed";
+    readonly format: TextFormat;
+}
+/** The selected words of the typed text, or the link at the cursor, lead here, or nowhere. */
+ | {
+    readonly type: "link-typed";
+    readonly href: string | undefined;
 } | {
     readonly type: "stop-typing";
 }
@@ -140,4 +212,4 @@ declare function readPageMessage(data: unknown): PageMessage | undefined;
 /** The message the editor sent, or undefined for anything that is not one. */
 declare function readEditorMessage(data: unknown): EditorMessage | undefined;
 
-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 Viewport as V, type EditorKey as a, PROTOCOL_VERSION as b, type PageLayout as c, type Point as d, readPageMessage as e, readEditorMessage as r, shortcutOf as s };
+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 };

package/dist/{parse-content-DqToE6I6.d.ts → parse-content-C9ldnmvj.d.ts}

@@ -1,4 +1,4 @@
-import { F as Fields, C as ContentOf } from './content-DeBXwSmg.js';
+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)[];

package/dist/protocol.d.ts

@@ -1,6 +1,7 @@
-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, S as Shortcut, V as Viewport, r as readEditorMessage, e as readPageMessage, s as shortcutOf } from './messages-ClePO8N_.js';
-import { F as Fields, I as ImageField } from './content-DeBXwSmg.js';
-import { F as FieldPath } from './parse-content-DqToE6I6.js';
+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';
 
 declare function carriesFiles(event: DragEvent): boolean;
 
@@ -16,6 +17,17 @@ declare function imageFieldAt(schema: Fields, path: string | undefined): {
  */
 declare function closestMarkedPath(path: FieldPath, isMarked: (path: string) => boolean): string | undefined;
 
+/** 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. */
+declare function readRichTextFrom(element: HTMLElement): RichText;
+/** Where the selection is in the text of the element, or undefined when it is elsewhere. */
+declare function readSelectionFrom(element: HTMLElement): TextSelection | undefined;
+/** Puts the selection on the text of an element this module rendered. */
+declare function selectIn(element: HTMLElement, selection: TextSelection): void;
+/** Puts plain words in place of the selection, their line breaks as `<br>`, the cursor after them. */
+declare function insertPlainText(element: HTMLElement, words: string): void;
+
 /** Where a site hands out its own photos: `/seamlet-photos/menu/cafe/01.jpg`. */
 declare const OWN_PHOTOS_PATH = "/seamlet-photos";
 /** An address of the site itself that is not an upload, and that cannot climb out of the site. */
@@ -23,4 +35,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, carriesFiles, closestMarkedPath, imageFieldAt, isOwnPhotoSrc, ownPhotoPath };
+export { OWN_PHOTOS_PATH, TextSelection, carriesFiles, closestMarkedPath, imageFieldAt, insertPlainText, isOwnPhotoSrc, ownPhotoPath, readRichTextFrom, readSelectionFrom, renderRichText, selectIn };

package/dist/protocol.js

@@ -7,21 +7,43 @@ import {
   PROTOCOL_VERSION,
   carriesFiles,
   closestMarkedPath,
+  formatsAt,
   imageFieldAt,
+  insertPlainText,
+  isCollapsed,
+  linkSelectionAt,
   readEditorMessage,
   readPageMessage,
-  shortcutOf
-} from "./chunk-4YLS3VPT.js";
+  readRichTextFrom,
+  readSelectionFrom,
+  renderRichText,
+  selectIn,
+  setLink,
+  shortcutOf,
+  toggleList,
+  toggleMark
+} from "./chunk-27XIZEVS.js";
 import "./chunk-ZUJEM3P7.js";
 export {
   OWN_PHOTOS_PATH,
   PROTOCOL_VERSION,
   carriesFiles,
   closestMarkedPath,
+  formatsAt,
   imageFieldAt,
+  insertPlainText,
+  isCollapsed,
   isOwnPhotoSrc,
+  linkSelectionAt,
   ownPhotoPath,
   readEditorMessage,
   readPageMessage,
-  shortcutOf
+  readRichTextFrom,
+  readSelectionFrom,
+  renderRichText,
+  selectIn,
+  setLink,
+  shortcutOf,
+  toggleList,
+  toggleMark
 };

package/dist/schema.d.ts

@@ -1,7 +1,7 @@
-import { b as ImageValue, L as LinkValue, c as Field, d as CollectionField, F as Fields, a as Content, R as RecordFields, C as ContentOf, G as GroupField, e as LinkField, T as TextField, U as UrlField, f as ChoicesField, g as TimeField, I as ImageField } from './content-DeBXwSmg.js';
-export { h as ChoiceField, i as ChoiceOption, D as DateField, j as FieldKind, k as FieldValue, l as ImageFocus, N as NumberField, O as OptionValue, m as RecordOf, n as ReferenceField, o as ReferencesField, p as RichBlock, q as RichLine, r as RichSpan, s 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-DeBXwSmg.js';
-import { F as FieldPath } from './parse-content-DqToE6I6.js';
-export { C as ContentIssue, P as ParsedContent, c as countCharacters, f as formatFieldPath, p as parseContent } from './parse-content-DqToE6I6.js';
+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';
 
 declare const FIELD_PATH_ATTRIBUTE = "data-cms-path";
 interface FieldMarker {

package/dist/site.d.ts

@@ -1,6 +1,6 @@
 import { ImageMetadata } from 'astro';
 import { AstroComponentFactory } from 'astro/runtime/server/index.js';
-import { F as Fields, C as ContentOf } from './content-DeBXwSmg.js';
+import { F as Fields, C as ContentOf } from './content-6k-E7NWf.js';
 
 interface SeamletSiteDefinition<F extends Fields> {
     /** The site's address in the CMS: `/sites/<id>`. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamlet/astro",
-  "version": "0.7.0",
+  "version": "0.8.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/dist/chunk-4YLS3VPT.js

@@ -1,160 +0,0 @@
-import {
-  formatFieldPath,
-  resolveFieldPath
-} from "./chunk-ZUJEM3P7.js";
-
-// src/bridge/editor-shortcuts.ts
-function shortcutOf(event) {
-  const hasCommandKey = event.metaKey || event.ctrlKey;
-  if (!hasCommandKey || event.altKey) {
-    return void 0;
-  }
-  switch (event.code) {
-    case "KeyS":
-      return "save";
-    case "KeyZ":
-      return event.shiftKey ? "redo" : "undo";
-    case "KeyY":
-      return "redo";
-    default:
-      return void 0;
-  }
-}
-
-// src/bridge/image-fields.ts
-function imageFieldAt(schema, path) {
-  const target = path === void 0 ? void 0 : resolveFieldPath(schema, path);
-  const isImage = target?.kind === "field" && target.field.kind === "image";
-  return isImage ? { path: target.path, field: target.field } : void 0;
-}
-
-// src/bridge/messages.ts
-var PROTOCOL_VERSION = 1;
-var EDITOR_KEYS = /* @__PURE__ */ new Set([
-  "save",
-  "undo",
-  "redo",
-  "escape"
-]);
-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;
-}
-function isPageMessage(message) {
-  switch (message["type"]) {
-    case "ready":
-      return isNumber(message["protocol"]);
-    case "file-drag-end":
-    case "rendered":
-    case "render-failed":
-      return true;
-    case "layout":
-      return isLayout(message["layout"]);
-    case "hover":
-    case "file-drag":
-      return isOptional(message["path"], isString);
-    case "click":
-      return isOptional(message["target"], isClickTarget);
-    case "link-click":
-      return isString(message["href"]);
-    case "key":
-      return isString(message["key"]) && EDITOR_KEYS.has(message["key"]);
-    case "file-drop":
-      return isString(message["path"]) && message["file"] instanceof File;
-    case "typing-started":
-    case "typing-refused":
-      return isString(message["path"]);
-    case "typed":
-      return isString(message["path"]) && isString(message["text"]);
-    case "typing-ended":
-      return isString(message["path"]) && isString(message["outcome"]) && TYPING_OUTCOMES.has(message["outcome"]);
-    default:
-      return false;
-  }
-}
-function isEditorMessage(message) {
-  switch (message["type"]) {
-    case "connect":
-      return isRecord(message["schema"]);
-    case "render":
-      return isRecord(message["content"]);
-    case "start-typing":
-      return isString(message["path"]) && isString(message["text"]) && typeof message["isSingleLine"] === "boolean" && isPoint(message["point"]);
-    case "stop-typing":
-      return true;
-    case "scroll-to":
-      return isFieldPath(message["path"]);
-    default:
-      return false;
-  }
-}
-function isLayout(value) {
-  if (!isRecord(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"]);
-}
-function isLinkBox(value) {
-  return isRecord(value) && isString(value["href"]) && isBox(value["box"]);
-}
-function isClickTarget(value) {
-  return isRecord(value) && isString(value["path"]) && isPoint(value["point"]);
-}
-function isBox(value) {
-  return isRecord(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"]);
-}
-function isPoint(value) {
-  return isRecord(value) && isNumber(value["x"]) && isNumber(value["y"]);
-}
-function isFieldPath(value) {
-  return Array.isArray(value) && value.every((segment) => isString(segment) || isNumber(segment));
-}
-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";
-}
-function isNumber(value) {
-  return typeof value === "number" && Number.isFinite(value);
-}
-
-// src/bridge/file-drags.ts
-function carriesFiles(event) {
-  return event.dataTransfer?.types.includes("Files") === true;
-}
-
-// src/bridge/marked-paths.ts
-function closestMarkedPath(path, isMarked) {
-  for (let length = path.length; length > 0; length -= 1) {
-    const candidate = formatFieldPath(path.slice(0, length));
-    if (isMarked(candidate)) return candidate;
-  }
-  return void 0;
-}
-
-export {
-  shortcutOf,
-  imageFieldAt,
-  PROTOCOL_VERSION,
-  readPageMessage,
-  readEditorMessage,
-  carriesFiles,
-  closestMarkedPath
-};