@easy-cms/core 1.28.0 → 1.30.0

package/dist/{chunk-QRHRDJN5.js → chunk-JTBPGZMF.js}

@@ -26,9 +26,12 @@ import {
   imageDimensions,
   isHasMany,
   isPassingError,
+  isPolymorphic,
   isPrivateKey,
   mimeAllowed,
   mimeAllowedBy,
+  polymorphicValue,
+  relationTargets,
   rowFields,
   sizeKey,
   sniffMimeType,
@@ -38,7 +41,7 @@ import {
   warnDeprecated,
   withCharset,
   withPrivacy
-} from "./chunk-SYUQX2G6.js";
+} from "./chunk-X4SI2QB7.js";
 
 // src/access.ts
 var isSystemAdmin = (user) => user?.role === "admin" && !user.apiKey && user.scoped !== true;
@@ -1742,6 +1745,33 @@ var SingleSignOn = class {
   }
 };
 
+// src/rich-text-blocks.ts
+var BLOCK_NODE = "block";
+function blockNodes(doc) {
+  const found = [];
+  const walk = (node, depth) => {
+    if (!node || typeof node !== "object" || depth > 200) return;
+    const { type, content } = node;
+    if (type === BLOCK_NODE) {
+      const n = node;
+      if (!n.attrs || typeof n.attrs !== "object") n.attrs = {};
+      found.push(n);
+      return;
+    }
+    if (Array.isArray(content)) for (const child of content) walk(child, depth + 1);
+  };
+  walk(doc, 0);
+  return found;
+}
+function blockOf(field, node) {
+  return field.blocks?.find((block) => block.slug === node.attrs.blockType);
+}
+function blockFields(node) {
+  const { fields } = node.attrs;
+  return fields && typeof fields === "object" && !Array.isArray(fields) ? fields : {};
+}
+var hasBlocks = (field, value) => (field.blocks?.length ?? 0) > 0 && !!value && typeof value === "object" && value.type === "doc";
+
 // src/access-control.ts
 async function evaluateAccess(access, args) {
   const result = await (access ?? isStaff)(args);
@@ -1777,6 +1807,14 @@ var FieldAccessChecker = class {
     return allowed2;
   }
 };
+async function mapBlocks(field, doc, map) {
+  const copy = structuredClone(doc);
+  for (const node of blockNodes(copy)) {
+    const block = blockOf(field, node);
+    if (block) node.attrs = { ...node.attrs, fields: await map(block.fields, blockFields(node)) };
+  }
+  return copy;
+}
 async function stripFields(fields, doc, read2) {
   const result = { ...doc };
   for (const field of fields) {
@@ -1788,6 +1826,8 @@ async function stripFields(fields, doc, read2) {
     const value = result[field.name];
     if (field.type === "group" && value && typeof value === "object") {
       result[field.name] = await stripFields(field.fields, value, read2);
+    } else if (field.type === "richText" && hasBlocks(field, value)) {
+      result[field.name] = await mapBlocks(field, value, (f, d) => stripFields(f, d, read2));
     } else if (hasRows(field) && Array.isArray(value)) {
       result[field.name] = await Promise.all(
         value.map((row) => {
@@ -1810,6 +1850,8 @@ async function filterInput(fields, data, update2) {
     const value = result[field.name];
     if (field.type === "group" && value && typeof value === "object" && !Array.isArray(value)) {
       result[field.name] = await filterInput(field.fields, value, update2);
+    } else if (field.type === "richText" && hasBlocks(field, value)) {
+      result[field.name] = await mapBlocks(field, value, (f, d) => filterInput(f, d, update2));
     } else if (hasRows(field) && Array.isArray(value)) {
       result[field.name] = await Promise.all(
         value.map((row) => {
@@ -2786,7 +2828,8 @@ async function normalizeValue(field, raw, path, options, fail, errors, reference
       if (!isPlainObject(raw) || raw.type !== "doc")
         return fail('must be a rich text document ({ type: "doc" })');
       const marks = docLinkMarks(raw);
-      if (marks.length === 0) return raw;
+      const nodes = blockNodes(raw);
+      if (marks.length === 0 && nodes.length === 0) return raw;
       const doc = structuredClone(raw);
       for (const mark of docLinkMarks(doc)) {
         const target = linkTarget(mark.attrs.doc);
@@ -2800,24 +2843,53 @@ async function normalizeValue(field, raw, path, options, fail, errors, reference
         };
         references2.push({ field: path, collection: target.relationTo, id, link: true });
       }
+      for (const node of blockNodes(doc)) {
+        const { id: rawId, blockType } = node.attrs;
+        const id = typeof rawId === "string" && rawId !== "" ? rawId : randomUUID();
+        const block = blockOf(field, node);
+        if (!block) {
+          const known = field.blocks?.map((b) => `"${b.slug}"`).join(", ");
+          errors.push({
+            field: `${path}.${id}`,
+            message: `has a block "${String(blockType)}" this field doesn't have${known ? `: use one of ${known}` : ""}`
+          });
+          continue;
+        }
+        const input = applyDefaults(block.fields, generateSlugs(block.fields, blockFields(node)));
+        const sub = await validateFields(block.fields, input, options, `${path}.${id}.`);
+        errors.push(...sub.errors);
+        references2.push(...sub.references);
+        node.attrs = { ...node.attrs, blockType: block.slug, id, fields: sub.data };
+      }
       return doc;
     }
     case "upload":
     case "relationship": {
-      const target = field.type === "upload" ? "media" : field.to;
+      const targets = relationTargets(field);
+      const poly = isPolymorphic(field);
       const many = field.hasMany === true;
       const values = many ? raw : [raw];
-      if (!Array.isArray(values)) return fail("must be an array of ids");
+      if (!Array.isArray(values))
+        return fail(poly ? "must be an array of { relationTo, value }" : "must be an array of ids");
       if (many && field.minRows !== void 0 && values.length < field.minRows)
         return fail(`must have at least ${itemsOf(field, field.minRows)}`);
       if (many && field.maxRows !== void 0 && values.length > field.maxRows)
         return fail(`must have at most ${itemsOf(field, field.maxRows)}`);
-      const ids = [];
+      const out = [];
       for (const item of values) {
-        const id = parseId(isPlainObject(item) ? item.id : item);
+        const pair = poly ? polymorphicValue(item) : void 0;
+        if (poly && (!pair || !targets.includes(pair.relationTo)))
+          return fail(
+            pair ? `can't link to "${pair.relationTo}": use one of ${targets.map((t) => `"${t}"`).join(", ")}` : `must be ${many ? "a list of" : ""} { relationTo, value } with relationTo one of ${targets.map((t) => `"${t}"`).join(", ")}`
+          );
+        const target = pair ? pair.relationTo : targets[0];
+        const rawId = pair ? pair.value : item;
+        const id = parseId(isPlainObject(rawId) ? rawId.id : rawId);
         if (id === void 0)
-          return fail(`must be ${many ? "ids" : "an id"} of "${target}" documents`);
-        ids.push(id);
+          return fail(
+            poly ? `must have the id of a "${target}" document as value` : `must be ${many ? "ids" : "an id"} of "${target}" documents`
+          );
+        out.push(pair ? { relationTo: target, value: id } : id);
         references2.push({
           field: path,
           collection: target,
@@ -2827,7 +2899,7 @@ async function normalizeValue(field, raw, path, options, fail, errors, reference
           ...field.type === "upload" && field.folder && field.folderOnly ? { folderOnly: field.folder } : {}
         });
       }
-      return many ? ids : ids[0];
+      return many ? out : out[0];
     }
     case "array": {
       if (!Array.isArray(raw)) return fail("must be an array");
@@ -4005,8 +4077,16 @@ function collectSlots(fields, data, bySlug, slots, linkURL) {
             collectSlots(fields2, row, bySlug, slots, linkURL);
         }
       }
-    } else if (field.type === "richText" && linkURL) {
+    } else if (field.type === "richText") {
       if (value.type !== "doc") continue;
+      for (const node of blockNodes(value)) {
+        const block = blockOf(field, node);
+        if (!block) continue;
+        const fields2 = { ...blockFields(node) };
+        node.attrs = { ...node.attrs, fields: fields2 };
+        collectSlots(block.fields, fields2, bySlug, slots, linkURL);
+      }
+      if (!linkURL) continue;
       for (const mark of docLinkMarks(value)) {
         const target = linkTarget(mark.attrs.doc);
         const collection2 = target ? bySlug.get(target.relationTo) : void 0;
@@ -4021,9 +4101,34 @@ function collectSlots(fields, data, bySlug, slots, linkURL) {
           }
         });
       }
+    } else if (isPolymorphic(field)) {
+      const many = Array.isArray(value);
+      const items = (many ? value : [value]).map(polymorphicValue);
+      if (items.some((item) => item === void 0)) continue;
+      const pairs = items;
+      const found = /* @__PURE__ */ new Map();
+      let waiting = 0;
+      for (const relationTo of new Set(pairs.map((p) => p.relationTo))) {
+        if (!bySlug.has(relationTo)) continue;
+        waiting++;
+        slots.push({
+          collection: relationTo,
+          ids: pairs.filter((p) => p.relationTo === relationTo).map((p) => p.value),
+          assign: (byId) => {
+            found.set(relationTo, byId);
+            if (--waiting > 0) return;
+            const filled = pairs.map((p) => {
+              if (!bySlug.has(p.relationTo)) return p;
+              const doc = found.get(p.relationTo)?.get(p.value);
+              return doc ? { relationTo: p.relationTo, value: doc } : void 0;
+            }).filter((p) => p !== void 0);
+            data[field.name] = many ? filled : filled[0] ?? null;
+          }
+        });
+      }
     } else if (field.type === "relationship" || field.type === "upload") {
       if (typeof value === "object" && !Array.isArray(value)) continue;
-      const collection2 = field.type === "upload" ? "media" : field.to;
+      const collection2 = relationTargets(field)[0];
       if (!bySlug.has(collection2)) continue;
       if (Array.isArray(value)) {
         const ids = value;
@@ -5388,7 +5493,7 @@ var FIELD = {
   json: keys(BASE_FIELD),
   select: keys(`${BASE_FIELD} options hasMany minRows maxRows`),
   slug: keys(`${BASE_FIELD} from`),
-  richText: keys(BASE_FIELD),
+  richText: keys(`${BASE_FIELD} blocks`),
   upload: keys(`${BASE_FIELD} hasMany minRows maxRows mimeTypes folder folderOnly filterOptions`),
   relationship: keys(`${BASE_FIELD} to hasMany minRows maxRows filterOptions`),
   array: keys(`${BASE_FIELD} fields minRows maxRows`),
@@ -5617,8 +5722,13 @@ function textOf(field, value) {
       return typeof value === "string" ? value : "";
     case "select":
       return [value].flat().filter((v) => typeof v === "string").join(" ");
-    case "richText":
-      return richText(value);
+    case "richText": {
+      const blocks = hasBlocks(field, value) ? blockNodes(value).map((node) => {
+        const block = blockOf(field, node);
+        return block ? fieldsText(block.fields, blockFields(node)) : "";
+      }) : [];
+      return [richText(value), ...blocks].filter(Boolean).join("\n");
+    }
     case "group":
       return typeof value === "object" ? fieldsText(field.fields, value) : "";
     case "array":
@@ -6263,7 +6373,7 @@ function warnNestedUnique(config, push) {
           severity: "warning"
         });
       if (field.type === "group" || field.type === "array") walk(field.fields, `${at}.fields`, true);
-      if (field.type === "blocks")
+      if (field.type === "blocks" || field.type === "richText")
         for (const block of Array.isArray(field.blocks) ? field.blocks : [])
           walk(block?.fields, `${at}.blocks.${String(block?.slug)}`, true);
     }
@@ -6738,7 +6848,7 @@ function validateUpload(config, add) {
           add(`${at}.folder`, "needs upload.folders: true", "upload: { folders: true }");
         if ((field.type === "group" || field.type === "array") && Array.isArray(field.fields))
           walk(field.fields, at);
-        if (field.type === "blocks" && Array.isArray(field.blocks)) {
+        if ((field.type === "blocks" || field.type === "richText") && Array.isArray(field.blocks)) {
           for (const [b, block] of field.blocks.entries())
             if (Array.isArray(block?.fields)) walk(block.fields, `${at}.blocks[${b}]`);
         }
@@ -7346,16 +7456,24 @@ function validateField(field, path, siblings, collectionSlugs, add) {
         }
       }
       break;
-    case "relationship":
-      if (typeof field.to !== "string" || !collectionSlugs.has(field.to)) {
-        add(
-          `${path}.to`,
-          `unknown collection ${JSON.stringify(field.to)}`,
-          `use one of: ${[...collectionSlugs].join(", ")}`
-        );
+    case "relationship": {
+      const to = field.to;
+      if (Array.isArray(to)) {
+        if (to.length === 0) add(`${path}.to`, "needs at least one collection");
+        if (new Set(to).size !== to.length) add(`${path}.to`, "names a collection twice");
+      }
+      for (const target of Array.isArray(to) ? to : [to]) {
+        if (typeof target !== "string" || !collectionSlugs.has(target)) {
+          add(
+            `${path}.to`,
+            `unknown collection ${JSON.stringify(target)}`,
+            `use one of: ${[...collectionSlugs].join(", ")}`
+          );
+        }
       }
       validateManyRange(field, path, add);
       break;
+    }
     case "upload":
       validateManyRange(field, path, add);
       if (field.folder !== void 0 && !FOLDER_KEY.test(String(field.folder)))
@@ -7449,6 +7567,57 @@ function validateField(field, path, siblings, collectionSlugs, add) {
       }
       break;
     }
+    case "richText": {
+      const blocks = field.blocks;
+      if (blocks === void 0) break;
+      if (!Array.isArray(blocks) || blocks.length === 0) {
+        add(
+          `${path}.blocks`,
+          "must be a list of at least one block",
+          "blocks: [{ slug: 'callout', fields: [...] }]"
+        );
+        break;
+      }
+      const seen = /* @__PURE__ */ new Set();
+      for (const [i, block] of blocks.entries()) {
+        const blockPath = `${path}.blocks[${i}]`;
+        if (typeof block?.slug !== "string" || !SLUG_PATTERN.test(block.slug)) {
+          add(
+            `${blockPath}.slug`,
+            'must be lowercase letters, digits, "-" or "_", starting with a letter'
+          );
+        } else if (seen.has(block.slug)) {
+          add(`${blockPath}.slug`, `duplicate block "${block.slug}"`);
+        } else {
+          seen.add(block.slug);
+        }
+        const summary = block?.admin?.summary;
+        if (summary !== void 0 && typeof summary !== "string" && typeof summary !== "function")
+          add(`${blockPath}.admin.summary`, "must be a function or the tag of a custom element");
+        if (!Array.isArray(block?.fields)) {
+          add(`${blockPath}.fields`, "must be an array");
+          continue;
+        }
+        const walk = (fields, at) => {
+          for (const inner of fields) {
+            const here = `${at}.${inner.name}`;
+            if (inner.type === "richText" || inner.type === "blocks")
+              add(here, `a ${inner.type} field can't be inside a rich text block`);
+            if (inner.localized)
+              add(
+                `${here}.localized`,
+                "fields in rich text blocks can't be localized",
+                "set localized on the rich text field: its blocks follow its locale"
+              );
+            if ((inner.type === "group" || inner.type === "array") && Array.isArray(inner.fields))
+              walk(inner.fields, `${here}.fields`);
+          }
+        };
+        walk(block.fields, `${blockPath}.fields`);
+        validateFields2(block.fields, `${blockPath}.fields`, /* @__PURE__ */ new Set(), collectionSlugs, add);
+      }
+      break;
+    }
   }
 }
 var ADMIN_COMPONENT_TAG = /^[a-z][a-z0-9]*(-[a-z0-9]+)+$/;
@@ -7853,9 +8022,9 @@ function withoutUiFields(config) {
           changed = true;
           next = { ...field, fields: inner.data, [ADMIN_FIELDS]: inner.admin };
         }
-      } else if (field.type === "blocks") {
+      } else if (field.type === "blocks" || field.type === "richText" && field.blocks) {
         let blocksChanged = false;
-        const blocks = field.blocks.map((block) => {
+        const blocks = (field.blocks ?? []).map((block) => {
           const inner = strip(block.fields);
           if (!inner.changed) return block;
           blocksChanged = true;
@@ -7932,7 +8101,7 @@ function cacheableResponse(request, body, status, headers, times, tags) {
 }
 
 // src/version.ts
-var VERSION = true ? "1.28.0" : "0.0.0-dev";
+var VERSION = true ? "1.30.0" : "0.0.0-dev";
 
 // src/telemetry.ts
 var DB_CALLS = /* @__PURE__ */ new Set([
@@ -11048,9 +11217,14 @@ var EasyCMS = class {
     for (const ref of references2) {
       const filter = ref.filterOptions;
       if (!filter) continue;
-      if (!allowed2.has(filter))
-        allowed2.set(filter, await filter({ id: selfId, user, cms, context }));
-      const where = allowed2.get(filter);
+      const byCollection = allowed2.get(filter) ?? /* @__PURE__ */ new Map();
+      allowed2.set(filter, byCollection);
+      if (!byCollection.has(ref.collection))
+        byCollection.set(
+          ref.collection,
+          await filter({ id: selfId, relationTo: ref.collection, user, cms, context })
+        );
+      const where = byCollection.get(ref.collection);
       if (where === true) continue;
       const target = this.config.collections.find((c) => c.slug === ref.collection);
       const localization = this.config.localization;
@@ -11487,10 +11661,11 @@ function ruleFields(fields) {
 }
 function references(fields, out = /* @__PURE__ */ new Set()) {
   for (const field of fields) {
-    if (field.type === "relationship") out.add(field.to);
-    else if (field.type === "upload") out.add("media");
+    if (field.type === "relationship" || field.type === "upload")
+      for (const target of relationTargets(field)) out.add(target);
     else if (field.type === "group" || field.type === "array") references(field.fields, out);
-    else if (field.type === "blocks") for (const b of field.blocks) references(b.fields, out);
+    else if (field.type === "blocks" || field.type === "richText")
+      for (const b of field.blocks ?? []) references(b.fields, out);
   }
   return out;
 }
@@ -12350,7 +12525,7 @@ async function serializeFields(fields, checks, localized, folderId, who) {
         if (field.from) f.from = field.from;
         break;
       case "relationship":
-        f.to = field.to;
+        f.to = typeof field.to === "string" ? field.to : [...field.to];
         if (field.hasMany) f.hasMany = true;
         if (field.minRows !== void 0) f.minRows = field.minRows;
         if (field.maxRows !== void 0) f.maxRows = field.maxRows;
@@ -12384,6 +12559,26 @@ async function serializeFields(fields, checks, localized, folderId, who) {
           }))
         );
         break;
+      case "richText":
+        if (field.blocks)
+          f.blocks = await Promise.all(
+            field.blocks.map(async (block) => {
+              const summary = block.admin?.summary;
+              return {
+                slug: block.slug,
+                ...block.labels ? { labels: block.labels } : {},
+                fields: await serializeFields(
+                  adminFieldsOf(block),
+                  checks,
+                  localized,
+                  folderId,
+                  who
+                ),
+                ...summary !== void 0 ? { summary: typeof summary === "function" ? "server" : summary } : {}
+              };
+            })
+          );
+        break;
       case "group":
         f.fields = await serializeFields(adminFieldsOf(field), checks, localized, folderId, who);
         break;
@@ -12902,15 +13097,38 @@ async function pickerFilter(cms, url, target, user, context = {}) {
   const slug2 = dot > 0 ? spec.slice(0, dot) : "";
   const owner = forCollection !== null ? cms.config.collections.find((c) => c.slug === slug2) : cms.config.globals.find((g) => g.slug === slug2);
   const field = owner ? fieldAt2(owner.fields, spec.slice(dot + 1)) : void 0;
-  const to = field?.type === "upload" ? "media" : field?.type === "relationship" ? field.to : null;
-  if (!field || field.type !== "relationship" && field.type !== "upload" || to !== target)
+  if (!field || field.type !== "relationship" && field.type !== "upload" || !relationTargets(field).includes(target))
     throw new QueryError(`filterFor: no relationship to "${target}" at "${spec}"`);
   if (!field.filterOptions) return void 0;
   const rawId = url.searchParams.get("filterId");
   const id = rawId === null || rawId === "" ? void 0 : /^\d+$/.test(rawId) ? Number(rawId) : rawId;
-  const where = await field.filterOptions({ id, user, cms, context });
+  const where = await field.filterOptions({ id, relationTo: target, user, cms, context });
   return where === true ? void 0 : where;
 }
+async function blockSummaries(cms, user, body) {
+  const input = body && typeof body === "object" ? body : {};
+  const owner = typeof input.collection === "string" ? cms.config.collections.find((c) => c.slug === input.collection) : typeof input.global === "string" ? cms.config.globals.find((g) => g.slug === input.global) : void 0;
+  const field = owner && typeof input.field === "string" ? fieldAt2(owner.fields, input.field) : void 0;
+  if (!field || field.type !== "richText" || !field.blocks)
+    throw new QueryError("block-summaries: no rich text field with blocks there");
+  const summaries = {};
+  for (const item of Array.isArray(input.blocks) ? input.blocks.slice(0, 200) : []) {
+    const { id, blockType, fields } = item ?? {};
+    const summary = field.blocks.find((b) => b.slug === blockType)?.admin?.summary;
+    if (typeof id !== "string" || typeof summary !== "function") continue;
+    try {
+      const text3 = await summary({
+        fields: fields && typeof fields === "object" ? fields : {},
+        user,
+        cms
+      });
+      if (typeof text3 === "string") summaries[id] = text3;
+    } catch (error) {
+      cms.logger.warn(`admin.summary of block "${String(blockType)}" failed: ${String(error)}`);
+    }
+  }
+  return { summaries };
+}
 
 // src/rest/query.ts
 var MAX_DEPTH2 = 10;
@@ -13204,7 +13422,8 @@ var ADMIN_UI_ROUTES = /* @__PURE__ */ new Set([
   "total",
   "media-usage",
   "owned",
-  "sso"
+  "sso",
+  "block-summaries"
 ]);
 var CORS_METHODS = "GET, HEAD, POST, PATCH, PUT, DELETE";
 var CORS_HEADERS = `authorization, content-type, ${CSRF_HEADER}`;
@@ -13581,6 +13800,12 @@ async function route(cms, ctx, method, path, options) {
     if (parsed === void 0) throw new HttpError("Not found", 404);
     return { body: await cms.roles.owned(parsed) };
   }
+  if (first === "admin" && second === "block-summaries" && third === void 0) {
+    if (!ctx.user) throw new UnauthorizedError();
+    if (method !== "POST") throw methodNotAllowed(ctx, "POST");
+    const body = await readJson(ctx.request);
+    return { body: await blockSummaries(cms, ctx.user, body) };
+  }
   if (first === "admin" && second === "media-usage" && segments.length === 2) {
     if (!ctx.user || ctx.user.apiKey) throw new UnauthorizedError();
     if (method !== "GET") throw methodNotAllowed(ctx, "GET");

package/dist/{chunk-SYUQX2G6.js → chunk-X4SI2QB7.js}

@@ -333,6 +333,17 @@ function mimeAllowedBy(mimeType, patterns) {
   });
 }
 var SVG = "image/svg+xml";
+var isPolymorphic = (field) => field.type === "relationship" && Array.isArray(field.to);
+function relationTargets(field) {
+  if (field.type === "upload") return ["media"];
+  if (field.type !== "relationship") return [];
+  return typeof field.to === "string" ? [field.to] : field.to;
+}
+function polymorphicValue(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+  const { relationTo } = value;
+  return typeof relationTo === "string" ? { relationTo, value: value.value } : void 0;
+}
 var hasRows = (field) => field.type === "array" || field.type === "blocks";
 function rowFields(field, row) {
   if (field.type === "array") return field.fields;
@@ -502,7 +513,7 @@ function applyFieldTypes(config) {
     if (!type) {
       if ((field.type === "group" || field.type === "array") && Array.isArray(field.fields))
         return { ...field, fields: convert(field.fields, `${here}.fields`) };
-      if (field.type === "blocks" && Array.isArray(field.blocks))
+      if ((field.type === "blocks" || field.type === "richText") && Array.isArray(field.blocks))
         return {
           ...field,
           blocks: field.blocks.map((block, b) => ({
@@ -592,6 +603,9 @@ export {
   uniqueWithinOf,
   isHasMany,
   mimeAllowedBy,
+  isPolymorphic,
+  relationTargets,
+  polymorphicValue,
   hasRows,
   rowFields,
   TRIGRAM_LIKE_MIN,

package/dist/{config-BLNPAco2.d.ts → config-DGATdBdP.d.ts}

@@ -905,6 +905,28 @@ interface RichTextDocument {
     readonly content?: readonly unknown[];
 }
 interface RichTextField extends BaseField<'richText', RichTextDocument> {
+    /**
+     * Blocks editors place between paragraphs (#328): a card, a callout, a video. Each is a node
+     * `{ type: 'block', attrs: { blockType, id, fields } }` in the document.
+     */
+    readonly blocks?: readonly RichTextBlock[];
+}
+/** Arguments of a rich text block's `admin.summary` function. */
+interface BlockSummaryArgs {
+    readonly fields: Record<string, unknown>;
+    readonly user: AuthUser | null;
+    readonly cms: EasyCMS;
+}
+/** A block in rich text (`richText.blocks`): the fields of `Block`, and how its card reads. */
+interface RichTextBlock extends Block {
+    readonly admin?: {
+        /**
+         * The text of the block's card in the editor: a function, run on the server, or the tag of a
+         * custom element from an admin module, which gets `fields`. Default: the block's label and
+         * its first value.
+         */
+        readonly summary?: string | ((args: BlockSummaryArgs) => string | Promise<string>);
+    };
 }
 /** References a document in the built-in `media` collection: a file or an image. */
 interface UploadField extends BaseField<'upload', never> {
@@ -933,6 +955,8 @@ interface UploadField extends BaseField<'upload', never> {
 interface FilterOptionsArgs {
     /** The document being edited; `undefined` while it is being created. */
     readonly id: ID | undefined;
+    /** The collection the choices come from: one of the field's `to`. */
+    readonly relationTo: string;
     readonly user: AuthUser | null;
     readonly cms: EasyCMS;
     /** The request's context (`onRequest`), `{}` when there is none. */
@@ -944,8 +968,11 @@ interface FilterOptionsArgs {
  */
 type FilterOptions = (args: FilterOptionsArgs) => Where | true | Promise<Where | true>;
 interface RelationshipField extends BaseField<'relationship', never> {
-    /** Slug of the target collection. */
-    readonly to: string;
+    /**
+     * Slug of the target collection, or several: then each value is `{ relationTo, value }`, the
+     * collection and the document's id (#327).
+     */
+    readonly to: string | readonly string[];
     readonly hasMany?: boolean;
     /** With `hasMany`: the fewest documents. */
     readonly minRows?: number;
@@ -989,6 +1016,17 @@ declare const isHasMany: (field: Field) => boolean;
  * carry scripts and is allowed only when listed by name: `image/svg+xml`).
  */
 declare function mimeAllowedBy(mimeType: string, patterns: readonly string[]): boolean;
+/** A relationship to several collections: its values are `{ relationTo, value }` (#327). */
+declare const isPolymorphic: (field: Field) => field is RelationshipField & {
+    readonly to: readonly string[];
+};
+/** The collections a relationship or upload field points to. */
+declare function relationTargets(field: Field): readonly string[];
+/** A `{ relationTo, value }` of a relationship to several collections, or `undefined`. */
+declare function polymorphicValue(value: unknown): {
+    relationTo: string;
+    value: unknown;
+} | undefined;
 /** Fields whose value is a list of rows: `array` and `blocks`. */
 declare const hasRows: (field: Field) => field is ArrayField | BlocksField;
 /** The fields of one row of an `array` or `blocks` field (`undefined` for an unknown block). */
@@ -1162,6 +1200,14 @@ type GlobalBySlug<C extends Config, S> = WithPluginFields<C, Extract<NonNullable
 type RelationValue<C extends Config, S, A extends boolean> = [CollectionBySlug<C, S>] extends [
     never
 ] ? ID | Record<string, unknown> : ID | CollectionDocument<C, S & string, A>;
+/**
+ * A relationship to several collections (#327): `{ relationTo, value }` per collection, so
+ * checking `relationTo` narrows `value`.
+ */
+type PolymorphicValue<C extends Config, To, V extends 'output' | 'input', A extends boolean> = To extends readonly (infer S)[] ? S extends string ? {
+    relationTo: S;
+    value: V extends 'input' ? ID : RelationValue<C, S, A>;
+} : never : never;
 /** The content locales of a config (`localization.locales`); `string` when not literal. */
 type LocaleOf<C extends Config> = C extends {
     readonly localization: {
@@ -1174,6 +1220,11 @@ type LocaleOf<C extends Config> = C extends {
  */
 type LocaleMap<F extends Field, C extends Config> = {
     [L in LocaleOf<C>]?: (F extends {
+        readonly type: 'relationship';
+        readonly to: infer To extends readonly string[];
+    } ? F extends {
+        readonly hasMany: true;
+    } ? PolymorphicValue<C, To, 'input', false>[] : PolymorphicValue<C, To, 'input', false> : F extends {
         readonly type: 'relationship' | 'upload';
     } ? F extends {
         readonly hasMany: true;
@@ -1232,6 +1283,11 @@ type OneLocaleValue<F extends Field, C extends Config, A extends boolean> = F ex
 } ? F extends {
     readonly hasMany: true;
 } ? (ID | MediaDocument)[] : ID | MediaDocument : F extends {
+    readonly type: 'relationship';
+    readonly to: infer To extends readonly string[];
+} ? F extends {
+    readonly hasMany: true;
+} ? PolymorphicValue<C, To, 'output', A>[] : PolymorphicValue<C, To, 'output', A> : F extends {
     readonly type: 'relationship';
     readonly to: infer S;
 } ? F extends {
@@ -1328,6 +1384,11 @@ type CollectionDocument<C extends Config, S extends CollectionSlug<C>, AllLocale
 type GlobalDocument<C extends Config, S extends GlobalSlug<C>, AllLocales extends boolean = false> = InferGlobal<GlobalBySlug<C, S>, C, AllLocales>;
 type InputValue<F extends Field> = F extends {
     readonly type: 'relationship';
+    readonly to: infer To extends readonly string[];
+} ? F extends {
+    readonly hasMany: true;
+} ? readonly PolymorphicValue<Config, To, 'input', false>[] : PolymorphicValue<Config, To, 'input', false> : F extends {
+    readonly type: 'relationship';
 } ? F extends {
     readonly hasMany: true;
 } ? readonly ID[] : ID : F extends {
@@ -1392,6 +1453,24 @@ type CreateInput<C extends Config, S extends CollectionSlug<C>> = Simplify<Field
 type UpdateInput<C extends Config, S extends CollectionSlug<C>> = Partial<CreateInput<C, S>>;
 /** Data accepted by `updateGlobal`. */
 type GlobalInput<C extends Config, S extends GlobalSlug<C>> = Partial<Simplify<FieldsInput<GlobalBySlug<C, S>['fields']> & StatusInput<GlobalBySlug<C, S>>>>;
+type BlocksOfField<F> = F extends {
+    readonly type: 'richText';
+    readonly blocks: readonly (infer B)[];
+} ? B : never;
+/**
+ * The blocks of a rich text field, e.g. `RichTextBlocks<typeof config, 'posts', 'body'>`: a
+ * union of `{ blockType, id, fields }`, for typed renderers in `@easy-cms/richtext`.
+ */
+type RichTextBlocks<C extends Config, S extends CollectionSlug<C>, F extends string> = BlocksOfField<Extract<CollectionBySlug<C, S>['fields'][number], {
+    readonly name: F;
+}>> extends infer B ? B extends {
+    readonly slug: infer Slug;
+    readonly fields: infer Fs extends readonly Field[];
+} ? {
+    blockType: Slug;
+    id: string;
+    fields: Simplify<FieldsValue<Fs, C, false>>;
+} : never : never;
 
 /** What a role may do with a collection or global, ticked in Settings → Roles. */
 declare const ROLE_OPERATIONS: readonly ["read", "create", "update", "delete", "publish"];
@@ -3821,5 +3900,5 @@ interface ResolvedConfig extends Omit<Config, 'cors' | 'localization' | 'routes'
  */
 declare function defineConfig<const TConfig extends Config>(config: TConfig): TConfig;
 
-export { ADAPTER_API_VERSION as A, EasyCMS as E, AuditLog as _, Auth as a1, EasyCMSError as aI, FIELD_TYPES as aP, ConfigError as ar, ForbiddenError as b7, PLUGIN_API_VERSION as bE, PayloadTooLargeError as bJ, QueryError as bP, ROLE_OPERATIONS as bQ, Roles as b_, NotFoundError as by, silentLogger as c$, SchemaError as c1, ValidationError as cB, WEBHOOK_EVENTS as cF, anyone as cJ, consoleEmail as cK, consoleLogger as cL, createEasyCMS as cM, defineConfig as cN, defineFieldType as cO, definePlugin as cP, diskStorage as cQ, hasRows as cR, isAdmin as cS, isHasMany as cT, isSignedIn as cU, isStaff as cV, isSystemAdmin as cW, jsonLogger as cX, memorySearch as cY, mimeAllowedBy as cZ, rowFields as c_, SingleSignOn as cg, TRIGRAM_LIKE_MIN as cn, TooManyRequestsError as cr, UnauthorizedError as cu, uniqueWithinOf as d0, API_KEYS as d1, API_KEY_GLOBAL_OPERATIONS as d2, API_KEY_OPERATIONS as d3, DEFAULT_MAX_VERSIONS as d4, DEFAULT_PASSWORD_EMAILS as d5, FIELD_TYPE_BASES as d6, FOLDER_LEVELS as d7, MediaFolders as d8, SSO_COOKIE as d9, codeOfStatus as db, isJsonLogger as dc, keyAllows as dd, logFormat as de, secretsOf as df, ADMIN_ICONS as j };
-export type { AuditPage as $, AdminRoles as B, Config as C, AdminSso as D, Field as F, GlobalSlug as G, AdminSwitcher as H, ID as I, AdminViewAccess as J, AfterChangeHook as K, LocalizationConfig as L, AfterDeleteHook as M, AfterReadHook as N, ApiKeyContext as O, PaginatedDocs as P, ApiKeyGlobalOperation as Q, ResolvedConfig as R, ApiKeyOperation as S, ApiKeyPermissions as T, UncountedDocs as U, ArrayField as V, Where as W, AuditChange as X, AuditConfig as Y, AuditEntry as Z, CollectionSlug as a, FieldsInput as a$, AuditVerification as a0, AuthConfig as a2, AuthProvider as a3, AuthProviderProfile as a4, AuthProviderRequest as a5, AuthUser as a6, BackupsConfig as a7, BeforeChangeHook as a8, BeforeDeleteHook as a9, DatabaseAdapter as aA, DatabaseInitArgs as aB, DatabaseTransfer as aC, DateField as aD, DepthOptions as aE, DirectUpload as aF, DiskStorageOptions as aG, DocumentOf as aH, EmailAdapter as aJ, EmailField as aK, EmailMessage as aL, Endpoint as aM, EndpointRequest as aN, ErrorCode as aO, FieldAccess as aQ, FieldAccessFn as aR, FieldAdmin as aS, FieldRule as aT, FieldType as aU, FieldTypeBase as aV, FieldTypeDefinition as aW, FieldTypeValidateContext as aX, FieldValidate as aY, FieldValidateContext as aZ, FieldValue as a_, BeforeValidateHook as aa, Block as ab, BlocksField as ac, BooleanField as ad, BuiltinApiKeysCollection as ae, BuiltinMediaCollection as af, BuiltinMediaFoldersCollection as ag, BuiltinUsersCollection as ah, BundleHints as ai, CliCommand as aj, CollectionAccess as ak, CollectionAdmin as al, CollectionCalendarAdmin as am, CollectionConfig as an, CollectionHooks as ao, CollectionListAdmin as ap, CollectionSearch as aq, ConfigIssue as as, ContainerAdmin as at, CreateInput as au, CreateMigrationResult as av, CustomField as aw, CustomFieldTypes as ax, DashboardWidget as ay, Database as az, CollectionDocument as b, RoutesConfig as b$, FieldsValue as b0, FilterOptionsArgs as b1, FindAfterArgs as b2, FindArgs as b3, FindOptions as b4, FolderLevel as b5, FolderPermissions as b6, GlobalAccess as b8, GlobalConfig as b9, OnRequest as bA, OnRequestArgs as bB, Operation as bC, OutboxRow as bD, PasswordEmail as bF, PasswordEmailArgs as bG, PasswordEmailFn as bH, PasswordLinkOptions as bI, Plugin as bK, PluginInfo as bL, PluginTypes as bM, PreviewTarget as bN, PreviewURL as bO, RawDocument as bR, ReadOptions as bS, RelationshipField as bT, RequestContext as bU, RichTextDocument as bV, RichTextField as bW, Role as bX, RoleOperation as bY, RolePermissions as bZ, GlobalHooks as ba, GlobalInput as bb, GroupField as bc, ImageSize as bd, IncrementOptions as be, InferCollection as bf, InferGlobal as bg, JobConfig as bh, JsonField as bi, KeysetPage as bj, Label as bk, LayoutNode as bl, LivePreview as bm, LocaleOf as bn, LogDetails as bo, Logger as bp, LoginArgs as bq, LogsConfig as br, MediaDocument as bs, MediaSize as bt, MembersConfig as bu, MembersSignup as bv, MigrationInfo as bw, NavGroup as bx, NumberField as bz, CursorDocs as c, ScheduledPublish as c0, SchemaMode as c2, SearchAdapter as c3, SearchEntry as c4, SearchHits as c5, SearchOptions as c6, SearchQuery as c7, SearchResults as c8, SearchSetting as c9, UserIdentity as cA, Version as cC, VersionSummary as cD, VersionsConfig as cE, WebhookConfig as cG, WebhookEvent as cH, WhereOperators as cI, SelectField as ca, SelectOption as cb, Session as cc, SidebarPanel as cd, SignupArgs as ce, SignupResult as cf, SlugField as ch, SlugOf as ci, SsoOutcome as cj, SsoProviderRef as ck, StorageAdapter as cl, StoredFile as cm, TelemetryConfig as co, TextField as cp, TextareaField as cq, TypedPlugin as cs, UiField as ct, UpdateInput as cv, UpdateOptions as cw, UploadConfig as cx, UploadField as cy, UploadFromURLConfig as cz, GlobalDocument as d, Secrets as da, FieldError as e, FilterOptions as f, CreateEasyCMSOptions as g, EmailSetting as h, WebhookPayload as i, Access as k, AccessArgs as l, AccessOptions as m, AdminBrand as n, AdminCommand as o, AdminComponent as p, AdminConfig as q, AdminFieldArgs as r, AdminIcon as s, AdminLocale as t, AdminPage as u, AdminRole as v, AdminRoleChange as w, AdminRoleField as x, AdminRoleTarget as y, AdminRoleView as z };
+export { ADAPTER_API_VERSION as A, EasyCMS as E, AuditLog as _, Auth as a1, EasyCMSError as aJ, FIELD_TYPES as aQ, ConfigError as as, ForbiddenError as b8, PLUGIN_API_VERSION as bF, PayloadTooLargeError as bK, QueryError as bQ, ROLE_OPERATIONS as bR, NotFoundError as bz, jsonLogger as c$, Roles as c1, SchemaError as c4, ValidationError as cE, WEBHOOK_EVENTS as cI, anyone as cM, consoleEmail as cN, consoleLogger as cO, createEasyCMS as cP, defineConfig as cQ, defineFieldType as cR, definePlugin as cS, diskStorage as cT, hasRows as cU, isAdmin as cV, isHasMany as cW, isPolymorphic as cX, isSignedIn as cY, isStaff as cZ, isSystemAdmin as c_, SingleSignOn as cj, TRIGRAM_LIKE_MIN as cq, TooManyRequestsError as cu, UnauthorizedError as cx, memorySearch as d0, mimeAllowedBy as d1, polymorphicValue as d2, relationTargets as d3, rowFields as d4, silentLogger as d5, uniqueWithinOf as d6, API_KEYS as d7, API_KEY_GLOBAL_OPERATIONS as d8, API_KEY_OPERATIONS as d9, DEFAULT_MAX_VERSIONS as da, DEFAULT_PASSWORD_EMAILS as db, FIELD_TYPE_BASES as dc, FOLDER_LEVELS as dd, MediaFolders as de, SSO_COOKIE as df, codeOfStatus as dh, isJsonLogger as di, keyAllows as dj, logFormat as dk, secretsOf as dl, ADMIN_ICONS as j };
+export type { AuditPage as $, AdminRoles as B, Config as C, AdminSso as D, Field as F, GlobalSlug as G, AdminSwitcher as H, ID as I, AdminViewAccess as J, AfterChangeHook as K, LocalizationConfig as L, AfterDeleteHook as M, AfterReadHook as N, ApiKeyContext as O, PaginatedDocs as P, ApiKeyGlobalOperation as Q, ResolvedConfig as R, ApiKeyOperation as S, ApiKeyPermissions as T, UncountedDocs as U, ArrayField as V, Where as W, AuditChange as X, AuditConfig as Y, AuditEntry as Z, CollectionSlug as a, FieldValue as a$, AuditVerification as a0, AuthConfig as a2, AuthProvider as a3, AuthProviderProfile as a4, AuthProviderRequest as a5, AuthUser as a6, BackupsConfig as a7, BeforeChangeHook as a8, BeforeDeleteHook as a9, Database as aA, DatabaseAdapter as aB, DatabaseInitArgs as aC, DatabaseTransfer as aD, DateField as aE, DepthOptions as aF, DirectUpload as aG, DiskStorageOptions as aH, DocumentOf as aI, EmailAdapter as aK, EmailField as aL, EmailMessage as aM, Endpoint as aN, EndpointRequest as aO, ErrorCode as aP, FieldAccess as aR, FieldAccessFn as aS, FieldAdmin as aT, FieldRule as aU, FieldType as aV, FieldTypeBase as aW, FieldTypeDefinition as aX, FieldTypeValidateContext as aY, FieldValidate as aZ, FieldValidateContext as a_, BeforeValidateHook as aa, Block as ab, BlockSummaryArgs as ac, BlocksField as ad, BooleanField as ae, BuiltinApiKeysCollection as af, BuiltinMediaCollection as ag, BuiltinMediaFoldersCollection as ah, BuiltinUsersCollection as ai, BundleHints as aj, CliCommand as ak, CollectionAccess as al, CollectionAdmin as am, CollectionCalendarAdmin as an, CollectionConfig as ao, CollectionHooks as ap, CollectionListAdmin as aq, CollectionSearch as ar, ConfigIssue as at, ContainerAdmin as au, CreateInput as av, CreateMigrationResult as aw, CustomField as ax, CustomFieldTypes as ay, DashboardWidget as az, CollectionDocument as b, RoleOperation as b$, FieldsInput as b0, FieldsValue as b1, FilterOptionsArgs as b2, FindAfterArgs as b3, FindArgs as b4, FindOptions as b5, FolderLevel as b6, FolderPermissions as b7, GlobalAccess as b9, NumberField as bA, OnRequest as bB, OnRequestArgs as bC, Operation as bD, OutboxRow as bE, PasswordEmail as bG, PasswordEmailArgs as bH, PasswordEmailFn as bI, PasswordLinkOptions as bJ, Plugin as bL, PluginInfo as bM, PluginTypes as bN, PreviewTarget as bO, PreviewURL as bP, RawDocument as bS, ReadOptions as bT, RelationshipField as bU, RequestContext as bV, RichTextBlock as bW, RichTextBlocks as bX, RichTextDocument as bY, RichTextField as bZ, Role as b_, GlobalConfig as ba, GlobalHooks as bb, GlobalInput as bc, GroupField as bd, ImageSize as be, IncrementOptions as bf, InferCollection as bg, InferGlobal as bh, JobConfig as bi, JsonField as bj, KeysetPage as bk, Label as bl, LayoutNode as bm, LivePreview as bn, LocaleOf as bo, LogDetails as bp, Logger as bq, LoginArgs as br, LogsConfig as bs, MediaDocument as bt, MediaSize as bu, MembersConfig as bv, MembersSignup as bw, MigrationInfo as bx, NavGroup as by, CursorDocs as c, RolePermissions as c0, RoutesConfig as c2, ScheduledPublish as c3, SchemaMode as c5, SearchAdapter as c6, SearchEntry as c7, SearchHits as c8, SearchOptions as c9, UploadConfig as cA, UploadField as cB, UploadFromURLConfig as cC, UserIdentity as cD, Version as cF, VersionSummary as cG, VersionsConfig as cH, WebhookConfig as cJ, WebhookEvent as cK, WhereOperators as cL, SearchQuery as ca, SearchResults as cb, SearchSetting as cc, SelectField as cd, SelectOption as ce, Session as cf, SidebarPanel as cg, SignupArgs as ch, SignupResult as ci, SlugField as ck, SlugOf as cl, SsoOutcome as cm, SsoProviderRef as cn, StorageAdapter as co, StoredFile as cp, TelemetryConfig as cr, TextField as cs, TextareaField as ct, TypedPlugin as cv, UiField as cw, UpdateInput as cy, UpdateOptions as cz, GlobalDocument as d, Secrets as dg, FieldError as e, FilterOptions as f, CreateEasyCMSOptions as g, EmailSetting as h, WebhookPayload as i, Access as k, AccessArgs as l, AccessOptions as m, AdminBrand as n, AdminCommand as o, AdminComponent as p, AdminConfig as q, AdminFieldArgs as r, AdminIcon as s, AdminLocale as t, AdminPage as u, AdminRole as v, AdminRoleChange as w, AdminRoleField as x, AdminRoleTarget as y, AdminRoleView as z };

package/dist/{handler-d7cT0k4l.d.ts → handler-DsA868nd.d.ts}

@@ -1,4 +1,4 @@
-import { I as ID, C as Config, E as EasyCMS, L as LocalizationConfig, F as Field, e as FieldError, f as FilterOptions, g as CreateEasyCMSOptions, R as ResolvedConfig } from './config-BLNPAco2.js';
+import { I as ID, C as Config, E as EasyCMS, L as LocalizationConfig, F as Field, e as FieldError, f as FilterOptions, g as CreateEasyCMSOptions, R as ResolvedConfig } from './config-DGATdBdP.js';
 
 /** Decrypts a file from `encryptBackup`; throws for another key or a changed file. */
 declare function decryptBackup(data: Uint8Array, encryptionKey: string): Uint8Array;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { P as PaginatedDocs, I as ID, h as EmailSetting, i as WebhookPayload } from './config-BLNPAco2.js';
-export { A as ADAPTER_API_VERSION, j as ADMIN_ICONS, k as Access, l as AccessArgs, m as AccessOptions, n as AdminBrand, o as AdminCommand, p as AdminComponent, q as AdminConfig, r as AdminFieldArgs, s as AdminIcon, t as AdminLocale, u as AdminPage, v as AdminRole, w as AdminRoleChange, x as AdminRoleField, y as AdminRoleTarget, z as AdminRoleView, B as AdminRoles, D as AdminSso, H as AdminSwitcher, J as AdminViewAccess, K as AfterChangeHook, M as AfterDeleteHook, N as AfterReadHook, O as ApiKeyContext, Q as ApiKeyGlobalOperation, S as ApiKeyOperation, T as ApiKeyPermissions, V as ArrayField, X as AuditChange, Y as AuditConfig, Z as AuditEntry, _ as AuditLog, $ as AuditPage, a0 as AuditVerification, a1 as Auth, a2 as AuthConfig, a3 as AuthProvider, a4 as AuthProviderProfile, a5 as AuthProviderRequest, a6 as AuthUser, a7 as BackupsConfig, a8 as BeforeChangeHook, a9 as BeforeDeleteHook, aa as BeforeValidateHook, ab as Block, ac as BlocksField, ad as BooleanField, ae as BuiltinApiKeysCollection, af as BuiltinMediaCollection, ag as BuiltinMediaFoldersCollection, ah as BuiltinUsersCollection, ai as BundleHints, aj as CliCommand, ak as CollectionAccess, al as CollectionAdmin, am as CollectionCalendarAdmin, an as CollectionConfig, b as CollectionDocument, ao as CollectionHooks, ap as CollectionListAdmin, aq as CollectionSearch, a as CollectionSlug, C as Config, ar as ConfigError, as as ConfigIssue, at as ContainerAdmin, g as CreateEasyCMSOptions, au as CreateInput, av as CreateMigrationResult, c as CursorDocs, aw as CustomField, ax as CustomFieldTypes, ay as DashboardWidget, az as Database, aA as DatabaseAdapter, aB as DatabaseInitArgs, aC as DatabaseTransfer, aD as DateField, aE as DepthOptions, aF as DirectUpload, aG as DiskStorageOptions, aH as DocumentOf, E as EasyCMS, aI as EasyCMSError, aJ as EmailAdapter, aK as EmailField, aL as EmailMessage, aM as Endpoint, aN as EndpointRequest, aO as ErrorCode, aP as FIELD_TYPES, F as Field, aQ as FieldAccess, aR as FieldAccessFn, aS as FieldAdmin, e as FieldError, aT as FieldRule, aU as FieldType, aV as FieldTypeBase, aW as FieldTypeDefinition, aX as FieldTypeValidateContext, aY as FieldValidate, aZ as FieldValidateContext, a_ as FieldValue, a$ as FieldsInput, b0 as FieldsValue, f as FilterOptions, b1 as FilterOptionsArgs, b2 as FindAfterArgs, b3 as FindArgs, b4 as FindOptions, b5 as FolderLevel, b6 as FolderPermissions, b7 as ForbiddenError, b8 as GlobalAccess, b9 as GlobalConfig, d as GlobalDocument, ba as GlobalHooks, bb as GlobalInput, G as GlobalSlug, bc as GroupField, bd as ImageSize, be as IncrementOptions, bf as InferCollection, bg as InferGlobal, bh as JobConfig, bi as JsonField, bj as KeysetPage, bk as Label, bl as LayoutNode, bm as LivePreview, bn as LocaleOf, L as LocalizationConfig, bo as LogDetails, bp as Logger, bq as LoginArgs, br as LogsConfig, bs as MediaDocument, bt as MediaSize, bu as MembersConfig, bv as MembersSignup, bw as MigrationInfo, bx as NavGroup, by as NotFoundError, bz as NumberField, bA as OnRequest, bB as OnRequestArgs, bC as Operation, bD as OutboxRow, bE as PLUGIN_API_VERSION, bF as PasswordEmail, bG as PasswordEmailArgs, bH as PasswordEmailFn, bI as PasswordLinkOptions, bJ as PayloadTooLargeError, bK as Plugin, bL as PluginInfo, bM as PluginTypes, bN as PreviewTarget, bO as PreviewURL, bP as QueryError, bQ as ROLE_OPERATIONS, bR as RawDocument, bS as ReadOptions, bT as RelationshipField, bU as RequestContext, R as ResolvedConfig, bV as RichTextDocument, bW as RichTextField, bX as Role, bY as RoleOperation, bZ as RolePermissions, b_ as Roles, b$ as RoutesConfig, c0 as ScheduledPublish, c1 as SchemaError, c2 as SchemaMode, c3 as SearchAdapter, c4 as SearchEntry, c5 as SearchHits, c6 as SearchOptions, c7 as SearchQuery, c8 as SearchResults, c9 as SearchSetting, ca as SelectField, cb as SelectOption, cc as Session, cd as SidebarPanel, ce as SignupArgs, cf as SignupResult, cg as SingleSignOn, ch as SlugField, ci as SlugOf, cj as SsoOutcome, ck as SsoProviderRef, cl as StorageAdapter, cm as StoredFile, cn as TRIGRAM_LIKE_MIN, co as TelemetryConfig, cp as TextField, cq as TextareaField, cr as TooManyRequestsError, cs as TypedPlugin, ct as UiField, cu as UnauthorizedError, U as UncountedDocs, cv as UpdateInput, cw as UpdateOptions, cx as UploadConfig, cy as UploadField, cz as UploadFromURLConfig, cA as UserIdentity, cB as ValidationError, cC as Version, cD as VersionSummary, cE as VersionsConfig, cF as WEBHOOK_EVENTS, cG as WebhookConfig, cH as WebhookEvent, W as Where, cI as WhereOperators, cJ as anyone, cK as consoleEmail, cL as consoleLogger, cM as createEasyCMS, cN as defineConfig, cO as defineFieldType, cP as definePlugin, cQ as diskStorage, cR as hasRows, cS as isAdmin, cT as isHasMany, cU as isSignedIn, cV as isStaff, cW as isSystemAdmin, cX as jsonLogger, cY as memorySearch, cZ as mimeAllowedBy, c_ as rowFields, c$ as silentLogger, d0 as uniqueWithinOf } from './config-BLNPAco2.js';
-export { A as ADMIN_API_VERSION, a as AdminCollection, b as AdminComponentRef, c as AdminElementProps, d as AdminField, e as AdminGlobal, f as AdminLayoutNode, g as AdminNavGroup, h as AdminNavItem, i as AdminNavNode, j as AdminPageRef, k as AdminPageRoute, l as AdminSchema, m as AdminWidgetRef, S as SetFieldDetail, w as warnDeprecated } from './plugin-B7pTgG5F.js';
-export { A as AdminBackup, a as AdminBackups, b as ApiHandlerOptions, B as BackupState, L as LoadConfigOptions, R as RestHandler, c as RestHandlerOptions, d as createApiHandler, e as createRestHandler, l as loadConfig, r as resolveConfig, s as sharedEasyCMS, f as slugify } from './handler-d7cT0k4l.js';
+import { P as PaginatedDocs, I as ID, h as EmailSetting, i as WebhookPayload } from './config-DGATdBdP.js';
+export { A as ADAPTER_API_VERSION, j as ADMIN_ICONS, k as Access, l as AccessArgs, m as AccessOptions, n as AdminBrand, o as AdminCommand, p as AdminComponent, q as AdminConfig, r as AdminFieldArgs, s as AdminIcon, t as AdminLocale, u as AdminPage, v as AdminRole, w as AdminRoleChange, x as AdminRoleField, y as AdminRoleTarget, z as AdminRoleView, B as AdminRoles, D as AdminSso, H as AdminSwitcher, J as AdminViewAccess, K as AfterChangeHook, M as AfterDeleteHook, N as AfterReadHook, O as ApiKeyContext, Q as ApiKeyGlobalOperation, S as ApiKeyOperation, T as ApiKeyPermissions, V as ArrayField, X as AuditChange, Y as AuditConfig, Z as AuditEntry, _ as AuditLog, $ as AuditPage, a0 as AuditVerification, a1 as Auth, a2 as AuthConfig, a3 as AuthProvider, a4 as AuthProviderProfile, a5 as AuthProviderRequest, a6 as AuthUser, a7 as BackupsConfig, a8 as BeforeChangeHook, a9 as BeforeDeleteHook, aa as BeforeValidateHook, ab as Block, ac as BlockSummaryArgs, ad as BlocksField, ae as BooleanField, af as BuiltinApiKeysCollection, ag as BuiltinMediaCollection, ah as BuiltinMediaFoldersCollection, ai as BuiltinUsersCollection, aj as BundleHints, ak as CliCommand, al as CollectionAccess, am as CollectionAdmin, an as CollectionCalendarAdmin, ao as CollectionConfig, b as CollectionDocument, ap as CollectionHooks, aq as CollectionListAdmin, ar as CollectionSearch, a as CollectionSlug, C as Config, as as ConfigError, at as ConfigIssue, au as ContainerAdmin, g as CreateEasyCMSOptions, av as CreateInput, aw as CreateMigrationResult, c as CursorDocs, ax as CustomField, ay as CustomFieldTypes, az as DashboardWidget, aA as Database, aB as DatabaseAdapter, aC as DatabaseInitArgs, aD as DatabaseTransfer, aE as DateField, aF as DepthOptions, aG as DirectUpload, aH as DiskStorageOptions, aI as DocumentOf, E as EasyCMS, aJ as EasyCMSError, aK as EmailAdapter, aL as EmailField, aM as EmailMessage, aN as Endpoint, aO as EndpointRequest, aP as ErrorCode, aQ as FIELD_TYPES, F as Field, aR as FieldAccess, aS as FieldAccessFn, aT as FieldAdmin, e as FieldError, aU as FieldRule, aV as FieldType, aW as FieldTypeBase, aX as FieldTypeDefinition, aY as FieldTypeValidateContext, aZ as FieldValidate, a_ as FieldValidateContext, a$ as FieldValue, b0 as FieldsInput, b1 as FieldsValue, f as FilterOptions, b2 as FilterOptionsArgs, b3 as FindAfterArgs, b4 as FindArgs, b5 as FindOptions, b6 as FolderLevel, b7 as FolderPermissions, b8 as ForbiddenError, b9 as GlobalAccess, ba as GlobalConfig, d as GlobalDocument, bb as GlobalHooks, bc as GlobalInput, G as GlobalSlug, bd as GroupField, be as ImageSize, bf as IncrementOptions, bg as InferCollection, bh as InferGlobal, bi as JobConfig, bj as JsonField, bk as KeysetPage, bl as Label, bm as LayoutNode, bn as LivePreview, bo as LocaleOf, L as LocalizationConfig, bp as LogDetails, bq as Logger, br as LoginArgs, bs as LogsConfig, bt as MediaDocument, bu as MediaSize, bv as MembersConfig, bw as MembersSignup, bx as MigrationInfo, by as NavGroup, bz as NotFoundError, bA as NumberField, bB as OnRequest, bC as OnRequestArgs, bD as Operation, bE as OutboxRow, bF as PLUGIN_API_VERSION, bG as PasswordEmail, bH as PasswordEmailArgs, bI as PasswordEmailFn, bJ as PasswordLinkOptions, bK as PayloadTooLargeError, bL as Plugin, bM as PluginInfo, bN as PluginTypes, bO as PreviewTarget, bP as PreviewURL, bQ as QueryError, bR as ROLE_OPERATIONS, bS as RawDocument, bT as ReadOptions, bU as RelationshipField, bV as RequestContext, R as ResolvedConfig, bW as RichTextBlock, bX as RichTextBlocks, bY as RichTextDocument, bZ as RichTextField, b_ as Role, b$ as RoleOperation, c0 as RolePermissions, c1 as Roles, c2 as RoutesConfig, c3 as ScheduledPublish, c4 as SchemaError, c5 as SchemaMode, c6 as SearchAdapter, c7 as SearchEntry, c8 as SearchHits, c9 as SearchOptions, ca as SearchQuery, cb as SearchResults, cc as SearchSetting, cd as SelectField, ce as SelectOption, cf as Session, cg as SidebarPanel, ch as SignupArgs, ci as SignupResult, cj as SingleSignOn, ck as SlugField, cl as SlugOf, cm as SsoOutcome, cn as SsoProviderRef, co as StorageAdapter, cp as StoredFile, cq as TRIGRAM_LIKE_MIN, cr as TelemetryConfig, cs as TextField, ct as TextareaField, cu as TooManyRequestsError, cv as TypedPlugin, cw as UiField, cx as UnauthorizedError, U as UncountedDocs, cy as UpdateInput, cz as UpdateOptions, cA as UploadConfig, cB as UploadField, cC as UploadFromURLConfig, cD as UserIdentity, cE as ValidationError, cF as Version, cG as VersionSummary, cH as VersionsConfig, cI as WEBHOOK_EVENTS, cJ as WebhookConfig, cK as WebhookEvent, W as Where, cL as WhereOperators, cM as anyone, cN as consoleEmail, cO as consoleLogger, cP as createEasyCMS, cQ as defineConfig, cR as defineFieldType, cS as definePlugin, cT as diskStorage, cU as hasRows, cV as isAdmin, cW as isHasMany, cX as isPolymorphic, cY as isSignedIn, cZ as isStaff, c_ as isSystemAdmin, c$ as jsonLogger, d0 as memorySearch, d1 as mimeAllowedBy, d2 as polymorphicValue, d3 as relationTargets, d4 as rowFields, d5 as silentLogger, d6 as uniqueWithinOf } from './config-DGATdBdP.js';
+export { A as ADMIN_API_VERSION, a as AdminCollection, b as AdminComponentRef, c as AdminElementProps, d as AdminField, e as AdminGlobal, f as AdminLayoutNode, g as AdminNavGroup, h as AdminNavItem, i as AdminNavNode, j as AdminPageRef, k as AdminPageRoute, l as AdminSchema, m as AdminWidgetRef, S as SetFieldDetail, w as warnDeprecated } from './plugin-B6lp3qVf.js';
+export { A as AdminBackup, a as AdminBackups, b as ApiHandlerOptions, B as BackupState, L as LoadConfigOptions, R as RestHandler, c as RestHandlerOptions, d as createApiHandler, e as createRestHandler, l as loadConfig, r as resolveConfig, s as sharedEasyCMS, f as slugify } from './handler-DsA868nd.js';
 export { FieldCondition, matchesCondition } from './conditions.js';
 
 type DeliveryKind = 'webhook' | 'email';

package/dist/index.js

@@ -28,7 +28,7 @@ import {
   silentLogger,
   slugify,
   verifyWebhook
-} from "./chunk-QRHRDJN5.js";
+} from "./chunk-JTBPGZMF.js";
 import {
   matchesCondition
 } from "./chunk-U266LV4M.js";
@@ -53,7 +53,7 @@ import {
   defineFieldType,
   definePlugin,
   warnDeprecated
-} from "./chunk-SYUQX2G6.js";
+} from "./chunk-X4SI2QB7.js";
 export {
   ADAPTER_API_VERSION,
   ADMIN_API_VERSION,

package/dist/internal.d.ts

@@ -1,6 +1,6 @@
 import { Config, Database, EasyCMS, NavGroup, CollectionConfig, ID, RawDocument, Field, ResolvedConfig, ConfigIssue } from './index.js';
-export { d1 as API_KEYS, d2 as API_KEY_GLOBAL_OPERATIONS, d3 as API_KEY_OPERATIONS, d4 as DEFAULT_MAX_VERSIONS, d5 as DEFAULT_PASSWORD_EMAILS, d6 as FIELD_TYPE_BASES, d7 as FOLDER_LEVELS, d8 as MediaFolders, d9 as SSO_COOKIE, da as Secrets, cn as TRIGRAM_LIKE_MIN, db as codeOfStatus, cR as hasRows, cT as isHasMany, dc as isJsonLogger, dd as keyAllows, de as logFormat, cZ as mimeAllowedBy, c_ as rowFields, df as secretsOf, d0 as uniqueWithinOf } from './config-BLNPAco2.js';
-export { C as CONFIG_FILE_NAMES, g as CSRF_COOKIE, h as CSRF_HEADER, D as DEFAULT_ADMIN_PATH, i as DEFAULT_API_PATH, j as DEFAULT_MAX_FILE_SIZE, k as DEFAULT_TOKEN_EXPIRATION, m as applyDefaults, n as applyPlugins, o as createRootEndpointHandler, p as decryptBackup, q as fillMissing, t as findConfigFile, u as forwardedClientIp, v as generateSlugs, w as importConfig, x as isEmail, y as mergeForUpdate, z as parseId, E as platformClientIp, F as readCookie, G as validateFields, H as writeBackupFile } from './handler-d7cT0k4l.js';
+export { d7 as API_KEYS, d8 as API_KEY_GLOBAL_OPERATIONS, d9 as API_KEY_OPERATIONS, da as DEFAULT_MAX_VERSIONS, db as DEFAULT_PASSWORD_EMAILS, dc as FIELD_TYPE_BASES, dd as FOLDER_LEVELS, de as MediaFolders, df as SSO_COOKIE, dg as Secrets, cq as TRIGRAM_LIKE_MIN, dh as codeOfStatus, cU as hasRows, cW as isHasMany, di as isJsonLogger, cX as isPolymorphic, dj as keyAllows, dk as logFormat, d1 as mimeAllowedBy, d2 as polymorphicValue, d3 as relationTargets, d4 as rowFields, dl as secretsOf, d6 as uniqueWithinOf } from './config-DGATdBdP.js';
+export { C as CONFIG_FILE_NAMES, g as CSRF_COOKIE, h as CSRF_HEADER, D as DEFAULT_ADMIN_PATH, i as DEFAULT_API_PATH, j as DEFAULT_MAX_FILE_SIZE, k as DEFAULT_TOKEN_EXPIRATION, m as applyDefaults, n as applyPlugins, o as createRootEndpointHandler, p as decryptBackup, q as fillMissing, t as findConfigFile, u as forwardedClientIp, v as generateSlugs, w as importConfig, x as isEmail, y as mergeForUpdate, z as parseId, E as platformClientIp, F as readCookie, G as validateFields, H as writeBackupFile } from './handler-DsA868nd.js';
 export { conditionIssues } from './conditions.js';
 
 /** The session cookie the REST API sets at login. */

package/dist/internal.js

@@ -58,7 +58,7 @@ import {
   verifyPassword,
   verifyTurnstile,
   writeBackupFile
-} from "./chunk-QRHRDJN5.js";
+} from "./chunk-JTBPGZMF.js";
 import {
   conditionIssues
 } from "./chunk-U266LV4M.js";
@@ -72,12 +72,15 @@ import {
   hasRows,
   imageDimensions,
   isHasMany,
+  isPolymorphic,
   mimeAllowed,
   mimeAllowedBy,
+  polymorphicValue,
+  relationTargets,
   rowFields,
   sniffMimeType,
   uniqueWithinOf
-} from "./chunk-SYUQX2G6.js";
+} from "./chunk-X4SI2QB7.js";
 
 // src/typegen.ts
 var pascal = (name) => name.split(/[^A-Za-z0-9]+/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
@@ -88,6 +91,7 @@ function singularize(word) {
   return word.replace(/s$/i, "");
 }
 var quote = (value) => JSON.stringify(value);
+var idOr = (type) => type ? `ID | ${type}` : "ID";
 var key = (name) => /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : quote(name);
 function names(config) {
   const taken = /* @__PURE__ */ new Set(["ID", "RichTextDocument", "MediaSize", "Collections", "Globals"]);
@@ -137,8 +141,9 @@ function fieldType(field, n, indent) {
       return field.hasMany ? `(${one})[]` : one;
     }
     case "relationship": {
-      const target = n.collections.get(field.to);
-      const one = target ? `ID | ${target}` : "ID";
+      const one = typeof field.to === "string" ? idOr(n.collections.get(field.to)) : field.to.map(
+        (slug) => `{ relationTo: ${quote(slug)}; value: ${idOr(n.collections.get(slug))} }`
+      ).join(" | ");
       return field.hasMany ? `(${one})[]` : one;
     }
     case "group":
@@ -229,6 +234,30 @@ function generateTypes(config) {
   for (const global of config.globals) {
     parts.push("", globalInterface(global, n.globals.get(global.slug), n));
   }
+  const owners = [
+    ...config.collections.map((c) => ({ fields: c.fields, name: n.collections.get(c.slug) })),
+    ...config.globals.map((g) => ({ fields: g.fields, name: n.globals.get(g.slug) }))
+  ];
+  for (const { fields, name } of owners) {
+    if (!name) continue;
+    for (const field of fields) {
+      if (field.type !== "richText" || !field.blocks?.length) continue;
+      const kinds = field.blocks.map(
+        (block) => `{
+  blockType: ${quote(block.slug)}
+  id: string
+  fields: {
+${fieldLines(block.fields, n, "    ").join("\n")}
+  }
+}`
+      );
+      parts.push(
+        "",
+        `/** A block in \`${name}.${field.name}\`: \`{ type: 'block', attrs }\` in the document. */`,
+        `export type ${name}${pascal(field.name)}Block = ${kinds.join(" | ")}`
+      );
+    }
+  }
   const map = (entries) => [...entries].map(([slug, name]) => `  ${key(slug)}: ${name}`).join("\n");
   parts.push(
     "",
@@ -303,6 +332,7 @@ export {
   isEmail,
   isHasMany,
   isJsonLogger,
+  isPolymorphic,
   keyAllows,
   logFormat,
   mergeForUpdate,
@@ -310,9 +340,11 @@ export {
   mimeAllowedBy,
   parseId,
   platformClientIp,
+  polymorphicValue,
   populate,
   rateKeys,
   readCookie,
+  relationTargets,
   resolveAdminModule,
   rowFields,
   secretsOf,

package/dist/{plugin-B7pTgG5F.d.ts → plugin-B6lp3qVf.d.ts}

@@ -1,4 +1,4 @@
-import { bk as Label, F as Field, I as ID, t as AdminLocale, H as AdminSwitcher, ck as SsoProviderRef } from './config-BLNPAco2.js';
+import { bl as Label, F as Field, I as ID, t as AdminLocale, H as AdminSwitcher, cn as SsoProviderRef } from './config-DGATdBdP.js';
 import { FieldCondition } from './conditions.js';
 
 /** A Web Component from an admin module, with its `props` (plain JSON). */
@@ -67,7 +67,8 @@ interface AdminField {
         value: string;
     }[];
     hasMany?: boolean;
-    to?: string;
+    /** Several for a relationship to several collections (#327). */
+    to?: string | string[];
     /** An upload's allowed file types, e.g. `image/*`. */
     mimeTypes?: string[];
     /** An upload's media folder (`folder`): where its picker opens; `only`: nowhere else. */
@@ -89,6 +90,11 @@ interface AdminField {
             plural?: Label;
         };
         fields: AdminField[];
+        /**
+         * Rich text blocks (#328): the card's text comes from the server (`'server'`, the block's
+         * `admin.summary` function) or a custom element (its tag).
+         */
+        summary?: string;
     }[];
     /** The current user may not change this field. */
     readOnly?: boolean;

package/dist/plugin.d.ts

@@ -1,3 +1,3 @@
-export { j as ADMIN_ICONS, p as AdminComponent, s as AdminIcon, a6 as AuthUser, aj as CliCommand, ak as CollectionAccess, an as CollectionConfig, C as Config, ar as ConfigError, ay as DashboardWidget, aI as EasyCMSError, aM as Endpoint, aN as EndpointRequest, aO as ErrorCode, F as Field, aQ as FieldAccess, e as FieldError, aV as FieldTypeBase, aW as FieldTypeDefinition, aX as FieldTypeValidateContext, b7 as ForbiddenError, b9 as GlobalConfig, I as ID, bh as JobConfig, bk as Label, bx as NavGroup, by as NotFoundError, bA as OnRequest, bB as OnRequestArgs, bE as PLUGIN_API_VERSION, bJ as PayloadTooLargeError, bK as Plugin, bL as PluginInfo, bM as PluginTypes, bP as QueryError, bU as RequestContext, cr as TooManyRequestsError, cs as TypedPlugin, cu as UnauthorizedError, cB as ValidationError, W as Where, cO as defineFieldType, cP as definePlugin } from './config-BLNPAco2.js';
-export { A as ADMIN_API_VERSION, c as AdminElementProps, k as AdminPageRoute, S as SetFieldDetail, w as warnDeprecated } from './plugin-B7pTgG5F.js';
+export { j as ADMIN_ICONS, p as AdminComponent, s as AdminIcon, a6 as AuthUser, ak as CliCommand, al as CollectionAccess, ao as CollectionConfig, C as Config, as as ConfigError, az as DashboardWidget, aJ as EasyCMSError, aN as Endpoint, aO as EndpointRequest, aP as ErrorCode, F as Field, aR as FieldAccess, e as FieldError, aW as FieldTypeBase, aX as FieldTypeDefinition, aY as FieldTypeValidateContext, b8 as ForbiddenError, ba as GlobalConfig, I as ID, bi as JobConfig, bl as Label, by as NavGroup, bz as NotFoundError, bB as OnRequest, bC as OnRequestArgs, bF as PLUGIN_API_VERSION, bK as PayloadTooLargeError, bL as Plugin, bM as PluginInfo, bN as PluginTypes, bQ as QueryError, bV as RequestContext, cu as TooManyRequestsError, cv as TypedPlugin, cx as UnauthorizedError, cE as ValidationError, W as Where, cR as defineFieldType, cS as definePlugin } from './config-DGATdBdP.js';
+export { A as ADMIN_API_VERSION, c as AdminElementProps, k as AdminPageRoute, S as SetFieldDetail, w as warnDeprecated } from './plugin-B6lp3qVf.js';
 import './conditions.js';

package/dist/plugin.js

@@ -16,7 +16,7 @@ import {
   defineFieldType,
   definePlugin,
   warnDeprecated
-} from "./chunk-SYUQX2G6.js";
+} from "./chunk-X4SI2QB7.js";
 export {
   ADMIN_API_VERSION,
   ADMIN_ICONS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easy-cms/core",
-  "version": "1.28.0",
+  "version": "1.30.0",
   "description": "Embedded, code-first headless CMS for Nuxt and Next.js",
   "license": "MIT",
   "type": "module",