@easy-cms/core 1.25.0 → 1.26.0

package/dist/{chunk-AAZ35NPQ.js → chunk-5L544S33.js}

@@ -36,7 +36,7 @@ import {
   warnDeprecated,
   withCharset,
   withPrivacy
-} from "./chunk-RJGKAYUU.js";
+} from "./chunk-J6E6QMDG.js";
 
 // src/access.ts
 var isSystemAdmin = (user) => user?.role === "admin" && !user.apiKey && user.scoped !== true;
@@ -2517,6 +2517,32 @@ var ADAPTER_API_VERSION = 1;
 
 // src/document.ts
 import { randomUUID } from "crypto";
+
+// src/rich-text-links.ts
+function docLinkMarks(doc) {
+  const found = [];
+  const walk = (node, depth) => {
+    if (!node || typeof node !== "object" || depth > 200) return;
+    const { marks, content } = node;
+    if (Array.isArray(marks))
+      for (const mark of marks) {
+        const m = mark;
+        const attrs = m?.attrs;
+        if (m?.type === "link" && attrs && attrs.doc !== void 0 && attrs.doc !== null)
+          found.push(m);
+      }
+    if (Array.isArray(content)) for (const child of content) walk(child, depth + 1);
+  };
+  walk(doc, 0);
+  return found;
+}
+function linkTarget(doc) {
+  if (!doc || typeof doc !== "object") return void 0;
+  const { relationTo, value } = doc;
+  return typeof relationTo === "string" && relationTo !== "" && value !== void 0 && value !== null ? { relationTo, value } : void 0;
+}
+
+// src/document.ts
 function isEmail(value) {
   const at = value.indexOf("@");
   return at > 0 && !value.includes("@", at + 1) && !/\s/.test(value) && value.slice(at + 2, -1).includes(".");
@@ -2754,10 +2780,26 @@ async function normalizeValue(field, raw, path, options, fail, errors, reference
       } catch {
         return fail("must be JSON-serializable");
       }
-    case "richText":
+    case "richText": {
       if (!isPlainObject(raw) || raw.type !== "doc")
         return fail('must be a rich text document ({ type: "doc" })');
-      return raw;
+      const marks = docLinkMarks(raw);
+      if (marks.length === 0) return raw;
+      const doc = structuredClone(raw);
+      for (const mark of docLinkMarks(doc)) {
+        const target = linkTarget(mark.attrs.doc);
+        const id = target ? parseId(target.value) : void 0;
+        if (!target || id === void 0)
+          return fail("has a link to a document without { relationTo, value }");
+        mark.attrs = {
+          ...mark.attrs,
+          doc: { relationTo: target.relationTo, value: id },
+          href: null
+        };
+        references2.push({ field: path, collection: target.relationTo, id, link: true });
+      }
+      return doc;
+    }
     case "upload":
     case "relationship": {
       const target = field.type === "upload" ? "media" : field.to;
@@ -3912,12 +3954,12 @@ function inScope(row, scope) {
 // src/populate.ts
 var DEFAULT_DEPTH = 1;
 var MAX_DEPTH = 3;
-async function populate(load, collections, fields, docs, depth) {
+async function populate(load, collections, fields, docs, depth, linkURL) {
   if (depth <= 0 || docs.length === 0) return docs;
   const bySlug = new Map(collections.map((c) => [c.slug, c]));
   const copies = docs.map((doc) => structuredClone(doc));
   const slots = [];
-  for (const doc of copies) collectSlots(fields, doc, bySlug, slots);
+  for (const doc of copies) collectSlots(fields, doc, bySlug, slots, linkURL);
   if (slots.length === 0) return copies;
   const wanted = /* @__PURE__ */ new Map();
   for (const slot of slots) {
@@ -3931,28 +3973,52 @@ async function populate(load, collections, fields, docs, depth) {
       const collection2 = bySlug.get(slug2);
       if (!collection2) return;
       const raw = await load(collection2, [...ids]);
-      const populated = await populate(load, collections, collection2.fields, raw, depth - 1);
+      const populated = await populate(
+        load,
+        collections,
+        collection2.fields,
+        raw,
+        depth - 1,
+        linkURL
+      );
       found.set(slug2, new Map(populated.map((d) => [d.id, d])));
     })
   );
   for (const slot of slots) slot.assign(found.get(slot.collection) ?? /* @__PURE__ */ new Map());
   return copies;
 }
-function collectSlots(fields, data, bySlug, slots) {
+function collectSlots(fields, data, bySlug, slots, linkURL) {
   for (const field of fields) {
     if (field.name === "__proto__") continue;
     const value = data[field.name];
     if (value === null || value === void 0) continue;
     if (field.type === "group") {
-      if (typeof value === "object") collectSlots(field.fields, value, bySlug, slots);
+      if (typeof value === "object")
+        collectSlots(field.fields, value, bySlug, slots, linkURL);
     } else if (hasRows(field)) {
       if (Array.isArray(value)) {
         for (const row of value) {
           const fields2 = rowFields(field, row);
           if (fields2 && row && typeof row === "object")
-            collectSlots(fields2, row, bySlug, slots);
+            collectSlots(fields2, row, bySlug, slots, linkURL);
         }
       }
+    } else if (field.type === "richText" && linkURL) {
+      if (value.type !== "doc") continue;
+      for (const mark of docLinkMarks(value)) {
+        const target = linkTarget(mark.attrs.doc);
+        const collection2 = target ? bySlug.get(target.relationTo) : void 0;
+        if (!target || !collection2) continue;
+        const id = target.value;
+        slots.push({
+          collection: target.relationTo,
+          ids: [id],
+          assign: (byId) => {
+            const doc = byId.get(id);
+            mark.attrs = { ...mark.attrs, href: doc ? linkURL(collection2, doc) : 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;
@@ -7309,12 +7375,37 @@ function validateField(field, path, siblings, collectionSlugs, add) {
         }
       }
       break;
+    case "ui": {
+      if (!field.admin?.component)
+        add(
+          `${path}.admin.component`,
+          "is required on a ui field",
+          "e.g. { name: 'estimate', type: 'ui', admin: { component: 'acme-estimate' } }"
+        );
+      const stored = [
+        "required",
+        "unique",
+        "uniqueWithin",
+        "index",
+        "defaultValue",
+        "validate",
+        "access",
+        "hidden",
+        "localized"
+      ];
+      for (const option of stored)
+        if (field[option] !== void 0)
+          add(`${path}.${option}`, "has no effect on a ui field, which stores nothing");
+      break;
+    }
     case "array":
     case "group":
       if (!Array.isArray(field.fields) || field.fields.length === 0) {
         add(`${path}.fields`, "must contain at least one field");
         break;
       }
+      if (field.fields.every((f) => f?.type === "ui"))
+        add(`${path}.fields`, "must contain a field that stores a value, not only ui fields");
       if (field.type === "array")
         checkRange(field.minRows, field.maxRows, "minRows", "maxRows", path, add);
       validateFields2(field.fields, `${path}.fields`, /* @__PURE__ */ new Set(["id"]), collectionSlugs, add);
@@ -7734,8 +7825,59 @@ async function resolveConfig(input) {
     ),
     fieldTypes: config.fieldTypes ?? []
   };
-  resolved.add(result);
-  return result;
+  const final = withoutUiFields(result);
+  resolved.add(final);
+  return final;
+}
+var ADMIN_FIELDS = /* @__PURE__ */ Symbol("easy-cms.adminFields");
+function adminFieldsOf(container) {
+  return container[ADMIN_FIELDS] ?? container.fields;
+}
+function withoutUiFields(config) {
+  const strip = (fields) => {
+    let changed = false;
+    const admin = [];
+    const data = [];
+    for (const field of fields) {
+      if (field.type === "ui") {
+        changed = true;
+        admin.push(field);
+        continue;
+      }
+      let next = field;
+      if (field.type === "group" || field.type === "array") {
+        const inner = strip(field.fields);
+        if (inner.changed) {
+          changed = true;
+          next = { ...field, fields: inner.data, [ADMIN_FIELDS]: inner.admin };
+        }
+      } else if (field.type === "blocks") {
+        let blocksChanged = false;
+        const blocks = field.blocks.map((block) => {
+          const inner = strip(block.fields);
+          if (!inner.changed) return block;
+          blocksChanged = true;
+          return { ...block, fields: inner.data, [ADMIN_FIELDS]: inner.admin };
+        });
+        if (blocksChanged) {
+          changed = true;
+          next = { ...field, blocks };
+        }
+      }
+      admin.push(next);
+      data.push(next);
+    }
+    return { data, admin, changed };
+  };
+  const apply2 = (container) => {
+    const inner = strip(container.fields);
+    return inner.changed ? { ...container, fields: inner.data, [ADMIN_FIELDS]: inner.admin } : container;
+  };
+  return {
+    ...config,
+    collections: config.collections.map(apply2),
+    globals: config.globals.map(apply2)
+  };
 }
 function usesVersions(config) {
   return [...config.collections ?? [], ...config.globals ?? []].some((c) => c.versions);
@@ -7788,7 +7930,7 @@ function cacheableResponse(request, body, status, headers, times, tags) {
 }
 
 // src/version.ts
-var VERSION = true ? "1.25.0" : "0.0.0-dev";
+var VERSION = true ? "1.26.0" : "0.0.0-dev";
 
 // src/telemetry.ts
 var DB_CALLS = /* @__PURE__ */ new Set([
@@ -10341,7 +10483,16 @@ var EasyCMS = class {
     };
     const depth = Math.max(0, Math.min(MAX_DEPTH, Math.trunc(options.depth ?? DEFAULT_DEPTH)));
     const localized = docs.map((d) => this.pick(config, d, options));
-    const populated = await populate(load, this.config.collections, config.fields, localized, depth);
+    const locale = options.locale && options.locale !== "all" ? options.locale : this.config.localization?.defaultLocale ?? this.config.admin.locale;
+    const linkURL = (target, doc) => target.preview?.({ doc, locale }) ?? null;
+    const populated = await populate(
+      load,
+      this.config.collections,
+      config.fields,
+      localized,
+      depth,
+      linkURL
+    );
     return Promise.all(populated.map((d) => finish2(config, d)));
   }
   /** Creates a document: access, input filtering, hooks, validation, then afterChange. */
@@ -10882,11 +11033,26 @@ var EasyCMS = class {
   }
   async checkReferences(references2, guard) {
     const byCollection = /* @__PURE__ */ new Map();
+    const errors = [];
     for (const ref of references2) {
-      if (!this.config.collections.some((c) => c.slug === ref.collection)) continue;
+      const target = this.config.collections.find((c) => c.slug === ref.collection);
+      if (ref.link && (!target || INTERNAL_COLLECTIONS.has(ref.collection))) {
+        errors.push({
+          field: ref.field,
+          message: `links to "${ref.collection}", which is not a collection`
+        });
+        continue;
+      }
+      if (ref.link && typeof target?.preview !== "function") {
+        errors.push({
+          field: ref.field,
+          message: `links to "${ref.collection}", whose documents have no URL (set its preview)`
+        });
+        continue;
+      }
+      if (!target) continue;
       byCollection.set(ref.collection, [...byCollection.get(ref.collection) ?? [], ref]);
     }
-    const errors = [];
     for (const [collection2, refs] of byCollection) {
       const found = await this.db.findByIds({
         collection: collection2,
@@ -12162,7 +12328,7 @@ async function serializeFields(fields, checks, localized, folderId, who) {
       case "array":
         if (field.minRows !== void 0) f.minRows = field.minRows;
         if (field.maxRows !== void 0) f.maxRows = field.maxRows;
-        f.fields = await serializeFields(field.fields, checks, localized, folderId, who);
+        f.fields = await serializeFields(adminFieldsOf(field), checks, localized, folderId, who);
         break;
       case "blocks":
         if (field.minRows !== void 0) f.minRows = field.minRows;
@@ -12171,12 +12337,16 @@ async function serializeFields(fields, checks, localized, folderId, who) {
           field.blocks.map(async (block) => ({
             slug: block.slug,
             ...block.labels ? { labels: block.labels } : {},
-            fields: await serializeFields(block.fields, checks, localized, folderId, who)
+            fields: await serializeFields(adminFieldsOf(block), checks, localized, folderId, who)
           }))
         );
         break;
       case "group":
-        f.fields = await serializeFields(field.fields, checks, localized, folderId, who);
+        f.fields = await serializeFields(adminFieldsOf(field), checks, localized, folderId, who);
+        break;
+      // A component alone: without a label of its own, none is shown.
+      case "ui":
+        if (field.label === void 0) f.label = "";
         break;
     }
     out.push(f);
@@ -12196,7 +12366,7 @@ async function may(cms, access, user, target, operation, context) {
 async function collection(cms, config, user, localized, roles, context) {
   const target = { collection: config.slug };
   const fields = await serializeFields(
-    config.fields,
+    adminFieldsOf(config),
     await checkers(cms, user, context),
     localized,
     folderIds(cms, user, context),
@@ -12256,10 +12426,16 @@ async function global(cms, config, user, localized, context) {
     versions: Boolean(config.versions),
     preview: typeof config.preview === "function",
     schedule: config.schedule === true,
-    fields: await serializeFields(config.fields, checks, localized, folderIds(cms, user, context), {
-      user,
-      context
-    }),
+    fields: await serializeFields(
+      adminFieldsOf(config),
+      checks,
+      localized,
+      folderIds(cms, user, context),
+      {
+        user,
+        context
+      }
+    ),
     permissions: {
       read: await may(cms, config.access?.read, user, target, "read", context),
       update: await may(cms, config.access?.update, user, target, "update", context),

package/dist/{chunk-RJGKAYUU.js → chunk-J6E6QMDG.js}

@@ -329,7 +329,8 @@ var FIELD_TYPES = [
   "relationship",
   "array",
   "group",
-  "blocks"
+  "blocks",
+  "ui"
 ];
 
 // src/config.ts

package/dist/{config-Bsp6rkuH.d.ts → config-BpKdXA32.d.ts}

@@ -993,14 +993,24 @@ declare function mimeAllowedBy(mimeType: string, patterns: readonly string[]): b
 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). */
 declare function rowFields(field: ArrayField | BlocksField, row: unknown): readonly Field[] | undefined;
-type Field = CustomField | TextField | TextareaField | NumberField | BooleanField | DateField | EmailField | JsonField | SelectField | SlugField | RichTextField | UploadField | RelationshipField | ArrayField | GroupField | BlocksField;
+/**
+ * Stores nothing: a component in the edit form (`admin.component`), e.g. a calculator, a preview
+ * or a button. Placed like any field (layout, groups, conditions); not in the database, the API or
+ * the generated types.
+ */
+interface UiField extends BaseField<'ui', never> {
+    readonly admin: FieldAdmin & {
+        readonly component: AdminComponent;
+    };
+}
+type Field = CustomField | TextField | TextareaField | NumberField | BooleanField | DateField | EmailField | JsonField | SelectField | SlugField | RichTextField | UploadField | RelationshipField | ArrayField | GroupField | BlocksField | UiField;
 type FieldType = Field['type'];
 /**
  * The shortest `like` on a field with `index: 'trigram'`: trigrams are three characters, so a
  * shorter search can't use the index and would read every row.
  */
 declare const TRIGRAM_LIKE_MIN = 3;
-declare const FIELD_TYPES: readonly ["text", "textarea", "number", "boolean", "date", "email", "json", "select", "slug", "richText", "upload", "relationship", "array", "group", "blocks"];
+declare const FIELD_TYPES: readonly ["text", "textarea", "number", "boolean", "date", "email", "json", "select", "slug", "richText", "upload", "relationship", "array", "group", "blocks", "ui"];
 
 type Simplify<T> = {
     [K in keyof T]: T[K];
@@ -1259,8 +1269,11 @@ type BlockInput<B> = B extends {
     id?: string;
     blockType: S;
 }> : never;
+/** The fields with a value: not `hidden`, and not `ui` fields (which store nothing). */
 type Visible<Fs extends readonly Field[]> = Exclude<Fs[number], {
     readonly hidden: true;
+} | {
+    readonly type: 'ui';
 }>;
 /** Always set when read: required fields, and lists and groups (empty `[]` / `{}` otherwise). */
 type Present = {
@@ -3803,5 +3816,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 S, Auth as V, EasyCMSError as aE, FIELD_TYPES as aL, ConfigError as am, SchemaError as b$, ForbiddenError as b3, PLUGIN_API_VERSION as bC, PayloadTooLargeError as bH, QueryError as bN, ROLE_OPERATIONS as bO, Roles as bY, NotFoundError as bw, uniqueWithinOf as c$, WEBHOOK_EVENTS as cD, anyone as cI, consoleEmail as cJ, consoleLogger as cK, createEasyCMS as cL, defineConfig as cM, defineFieldType as cN, definePlugin as cO, diskStorage as cP, hasRows as cQ, isAdmin as cR, isHasMany as cS, isSignedIn as cT, isStaff as cU, isSystemAdmin as cV, jsonLogger as cW, memorySearch as cX, mimeAllowedBy as cY, rowFields as cZ, silentLogger as c_, SingleSignOn as ce, TRIGRAM_LIKE_MIN as cl, TooManyRequestsError as cp, UnauthorizedError as cr, ValidationError as cz, API_KEYS as d0, API_KEY_GLOBAL_OPERATIONS as d1, API_KEY_OPERATIONS as d2, DEFAULT_MAX_VERSIONS as d3, DEFAULT_PASSWORD_EMAILS as d4, FIELD_TYPE_BASES as d5, FOLDER_LEVELS as d6, MediaFolders as d7, SSO_COOKIE as d8, codeOfStatus as da, isJsonLogger as db, keyAllows as dc, logFormat as dd, secretsOf as de, ADMIN_ICONS as e };
-export type { AuthUser as $, AfterDeleteHook as B, Config as C, AfterReadHook as D, Field as F, ApiKeyContext as G, ApiKeyGlobalOperation as H, ID as I, ApiKeyOperation as J, ApiKeyPermissions as K, LocalizationConfig as L, ArrayField as M, AuditChange as N, AuditConfig as O, PaginatedDocs as P, AuditEntry as Q, ResolvedConfig as R, AuditPage as T, AuditVerification as U, WebhookPayload as W, AuthConfig as X, AuthProvider as Y, AuthProviderProfile as Z, AuthProviderRequest as _, FieldError as a, FindArgs as a$, BackupsConfig as a0, BeforeChangeHook as a1, BeforeDeleteHook as a2, BeforeValidateHook as a3, Block as a4, BlocksField as a5, BooleanField as a6, BuiltinApiKeysCollection as a7, BuiltinMediaCollection as a8, BuiltinMediaFoldersCollection as a9, DepthOptions as aA, DirectUpload as aB, DiskStorageOptions as aC, DocumentOf as aD, EmailAdapter as aF, EmailField as aG, EmailMessage as aH, Endpoint as aI, EndpointRequest as aJ, ErrorCode as aK, FieldAccess as aM, FieldAccessFn as aN, FieldAdmin as aO, FieldRule as aP, FieldType as aQ, FieldTypeBase as aR, FieldTypeDefinition as aS, FieldTypeValidateContext as aT, FieldValidate as aU, FieldValidateContext as aV, FieldValue as aW, FieldsInput as aX, FieldsValue as aY, FilterOptionsArgs as aZ, FindAfterArgs as a_, BuiltinUsersCollection as aa, BundleHints as ab, CliCommand as ac, CollectionAccess as ad, CollectionAdmin as ae, CollectionCalendarAdmin as af, CollectionConfig as ag, CollectionDocument as ah, CollectionHooks as ai, CollectionListAdmin as aj, CollectionSearch as ak, CollectionSlug as al, ConfigIssue as an, ContainerAdmin as ao, CreateInput as ap, CreateMigrationResult as aq, CursorDocs as ar, CustomField as as, CustomFieldTypes as at, DashboardWidget as au, Database as av, DatabaseAdapter as aw, DatabaseInitArgs as ax, DatabaseTransfer as ay, DateField as az, FilterOptions as b, FindOptions as b0, FolderLevel as b1, FolderPermissions as b2, GlobalAccess as b4, GlobalConfig as b5, GlobalDocument as b6, GlobalHooks as b7, GlobalInput as b8, GlobalSlug as b9, Operation as bA, OutboxRow as bB, PasswordEmail as bD, PasswordEmailArgs as bE, PasswordEmailFn as bF, PasswordLinkOptions as bG, Plugin as bI, PluginInfo as bJ, PluginTypes as bK, PreviewTarget as bL, PreviewURL as bM, RawDocument as bP, ReadOptions as bQ, RelationshipField as bR, RequestContext as bS, RichTextDocument as bT, RichTextField as bU, Role as bV, RoleOperation as bW, RolePermissions as bX, RoutesConfig as bZ, ScheduledPublish as b_, GroupField as ba, ImageSize as bb, IncrementOptions as bc, InferCollection as bd, InferGlobal as be, JobConfig as bf, JsonField as bg, KeysetPage as bh, Label as bi, LayoutNode as bj, LivePreview as bk, LocaleOf as bl, LogDetails as bm, Logger as bn, LoginArgs as bo, LogsConfig as bp, MediaDocument as bq, MediaSize as br, MembersConfig as bs, MembersSignup as bt, MigrationInfo as bu, NavGroup as bv, NumberField as bx, OnRequest as by, OnRequestArgs as bz, CreateEasyCMSOptions as c, SchemaMode as c0, SearchAdapter as c1, SearchEntry as c2, SearchHits as c3, SearchOptions as c4, SearchQuery as c5, SearchResults as c6, SearchSetting as c7, SelectField as c8, SelectOption as c9, Version as cA, VersionSummary as cB, VersionsConfig as cC, WebhookConfig as cE, WebhookEvent as cF, Where as cG, WhereOperators as cH, Session as ca, SidebarPanel as cb, SignupArgs as cc, SignupResult as cd, SlugField as cf, SlugOf as cg, SsoOutcome as ch, SsoProviderRef as ci, StorageAdapter as cj, StoredFile as ck, TelemetryConfig as cm, TextField as cn, TextareaField as co, TypedPlugin as cq, UncountedDocs as cs, UpdateInput as ct, UpdateOptions as cu, UploadConfig as cv, UploadField as cw, UploadFromURLConfig as cx, UserIdentity as cy, EmailSetting as d, Secrets as d9, Access as f, AccessArgs as g, AccessOptions as h, AdminBrand as i, AdminCommand as j, AdminComponent as k, AdminConfig as l, AdminFieldArgs as m, AdminIcon as n, AdminLocale as o, AdminPage as p, AdminRole as q, AdminRoleChange as r, AdminRoleField as s, AdminRoleTarget as t, AdminRoleView as u, AdminRoles as v, AdminSso as w, AdminSwitcher as x, AdminViewAccess as y, AfterChangeHook as z };
+export { ADAPTER_API_VERSION as A, EasyCMS as E, AuditLog as S, Auth as V, EasyCMSError as aE, FIELD_TYPES as aL, ConfigError as am, SchemaError as b$, ForbiddenError as b3, PLUGIN_API_VERSION as bC, PayloadTooLargeError as bH, QueryError as bN, ROLE_OPERATIONS as bO, Roles as bY, NotFoundError as bw, silentLogger as c$, ValidationError as cA, WEBHOOK_EVENTS as cE, 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 ce, TRIGRAM_LIKE_MIN as cl, TooManyRequestsError as cp, UnauthorizedError as cs, 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 e };
+export type { AuthUser as $, AfterDeleteHook as B, Config as C, AfterReadHook as D, Field as F, ApiKeyContext as G, ApiKeyGlobalOperation as H, ID as I, ApiKeyOperation as J, ApiKeyPermissions as K, LocalizationConfig as L, ArrayField as M, AuditChange as N, AuditConfig as O, PaginatedDocs as P, AuditEntry as Q, ResolvedConfig as R, AuditPage as T, AuditVerification as U, WebhookPayload as W, AuthConfig as X, AuthProvider as Y, AuthProviderProfile as Z, AuthProviderRequest as _, FieldError as a, FindArgs as a$, BackupsConfig as a0, BeforeChangeHook as a1, BeforeDeleteHook as a2, BeforeValidateHook as a3, Block as a4, BlocksField as a5, BooleanField as a6, BuiltinApiKeysCollection as a7, BuiltinMediaCollection as a8, BuiltinMediaFoldersCollection as a9, DepthOptions as aA, DirectUpload as aB, DiskStorageOptions as aC, DocumentOf as aD, EmailAdapter as aF, EmailField as aG, EmailMessage as aH, Endpoint as aI, EndpointRequest as aJ, ErrorCode as aK, FieldAccess as aM, FieldAccessFn as aN, FieldAdmin as aO, FieldRule as aP, FieldType as aQ, FieldTypeBase as aR, FieldTypeDefinition as aS, FieldTypeValidateContext as aT, FieldValidate as aU, FieldValidateContext as aV, FieldValue as aW, FieldsInput as aX, FieldsValue as aY, FilterOptionsArgs as aZ, FindAfterArgs as a_, BuiltinUsersCollection as aa, BundleHints as ab, CliCommand as ac, CollectionAccess as ad, CollectionAdmin as ae, CollectionCalendarAdmin as af, CollectionConfig as ag, CollectionDocument as ah, CollectionHooks as ai, CollectionListAdmin as aj, CollectionSearch as ak, CollectionSlug as al, ConfigIssue as an, ContainerAdmin as ao, CreateInput as ap, CreateMigrationResult as aq, CursorDocs as ar, CustomField as as, CustomFieldTypes as at, DashboardWidget as au, Database as av, DatabaseAdapter as aw, DatabaseInitArgs as ax, DatabaseTransfer as ay, DateField as az, FilterOptions as b, FindOptions as b0, FolderLevel as b1, FolderPermissions as b2, GlobalAccess as b4, GlobalConfig as b5, GlobalDocument as b6, GlobalHooks as b7, GlobalInput as b8, GlobalSlug as b9, Operation as bA, OutboxRow as bB, PasswordEmail as bD, PasswordEmailArgs as bE, PasswordEmailFn as bF, PasswordLinkOptions as bG, Plugin as bI, PluginInfo as bJ, PluginTypes as bK, PreviewTarget as bL, PreviewURL as bM, RawDocument as bP, ReadOptions as bQ, RelationshipField as bR, RequestContext as bS, RichTextDocument as bT, RichTextField as bU, Role as bV, RoleOperation as bW, RolePermissions as bX, RoutesConfig as bZ, ScheduledPublish as b_, GroupField as ba, ImageSize as bb, IncrementOptions as bc, InferCollection as bd, InferGlobal as be, JobConfig as bf, JsonField as bg, KeysetPage as bh, Label as bi, LayoutNode as bj, LivePreview as bk, LocaleOf as bl, LogDetails as bm, Logger as bn, LoginArgs as bo, LogsConfig as bp, MediaDocument as bq, MediaSize as br, MembersConfig as bs, MembersSignup as bt, MigrationInfo as bu, NavGroup as bv, NumberField as bx, OnRequest as by, OnRequestArgs as bz, CreateEasyCMSOptions as c, SchemaMode as c0, SearchAdapter as c1, SearchEntry as c2, SearchHits as c3, SearchOptions as c4, SearchQuery as c5, SearchResults as c6, SearchSetting as c7, SelectField as c8, SelectOption as c9, Version as cB, VersionSummary as cC, VersionsConfig as cD, WebhookConfig as cF, WebhookEvent as cG, Where as cH, WhereOperators as cI, Session as ca, SidebarPanel as cb, SignupArgs as cc, SignupResult as cd, SlugField as cf, SlugOf as cg, SsoOutcome as ch, SsoProviderRef as ci, StorageAdapter as cj, StoredFile as ck, TelemetryConfig as cm, TextField as cn, TextareaField as co, TypedPlugin as cq, UiField as cr, UncountedDocs as ct, UpdateInput as cu, UpdateOptions as cv, UploadConfig as cw, UploadField as cx, UploadFromURLConfig as cy, UserIdentity as cz, EmailSetting as d, Secrets as da, Access as f, AccessArgs as g, AccessOptions as h, AdminBrand as i, AdminCommand as j, AdminComponent as k, AdminConfig as l, AdminFieldArgs as m, AdminIcon as n, AdminLocale as o, AdminPage as p, AdminRole as q, AdminRoleChange as r, AdminRoleField as s, AdminRoleTarget as t, AdminRoleView as u, AdminRoles as v, AdminSso as w, AdminSwitcher as x, AdminViewAccess as y, AfterChangeHook as z };

package/dist/{handler-Br9Pu6z9.d.ts → handler-BokoUN1I.d.ts}

@@ -1,4 +1,4 @@
-import { I as ID, C as Config, E as EasyCMS, L as LocalizationConfig, F as Field, a as FieldError, b as FilterOptions, c as CreateEasyCMSOptions, R as ResolvedConfig } from './config-Bsp6rkuH.js';
+import { I as ID, C as Config, E as EasyCMS, L as LocalizationConfig, F as Field, a as FieldError, b as FilterOptions, c as CreateEasyCMSOptions, R as ResolvedConfig } from './config-BpKdXA32.js';
 
 /** Decrypts a file from `encryptBackup`; throws for another key or a changed file. */
 declare function decryptBackup(data: Uint8Array, encryptionKey: string): Uint8Array;
@@ -79,6 +79,8 @@ interface Reference {
     readonly mimeTypes?: readonly string[];
     /** The upload's `folder` with `folderOnly`: the file must be in it, checked when saving. */
     readonly folderOnly?: string;
+    /** A link in rich text (#326): its collection must exist and have a URL (`preview`). */
+    readonly link?: true;
 }
 interface ValidateOptions {
     readonly operation: 'create' | 'update';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { P as PaginatedDocs, I as ID, d as EmailSetting, W as WebhookPayload } from './config-Bsp6rkuH.js';
-export { A as ADAPTER_API_VERSION, e as ADMIN_ICONS, f as Access, g as AccessArgs, h as AccessOptions, i as AdminBrand, j as AdminCommand, k as AdminComponent, l as AdminConfig, m as AdminFieldArgs, n as AdminIcon, o as AdminLocale, p as AdminPage, q as AdminRole, r as AdminRoleChange, s as AdminRoleField, t as AdminRoleTarget, u as AdminRoleView, v as AdminRoles, w as AdminSso, x as AdminSwitcher, y as AdminViewAccess, z as AfterChangeHook, B as AfterDeleteHook, D as AfterReadHook, G as ApiKeyContext, H as ApiKeyGlobalOperation, J as ApiKeyOperation, K as ApiKeyPermissions, M as ArrayField, N as AuditChange, O as AuditConfig, Q as AuditEntry, S as AuditLog, T as AuditPage, U as AuditVerification, V as Auth, X as AuthConfig, Y as AuthProvider, Z as AuthProviderProfile, _ as AuthProviderRequest, $ as AuthUser, a0 as BackupsConfig, a1 as BeforeChangeHook, a2 as BeforeDeleteHook, a3 as BeforeValidateHook, a4 as Block, a5 as BlocksField, a6 as BooleanField, a7 as BuiltinApiKeysCollection, a8 as BuiltinMediaCollection, a9 as BuiltinMediaFoldersCollection, aa as BuiltinUsersCollection, ab as BundleHints, ac as CliCommand, ad as CollectionAccess, ae as CollectionAdmin, af as CollectionCalendarAdmin, ag as CollectionConfig, ah as CollectionDocument, ai as CollectionHooks, aj as CollectionListAdmin, ak as CollectionSearch, al as CollectionSlug, C as Config, am as ConfigError, an as ConfigIssue, ao as ContainerAdmin, c as CreateEasyCMSOptions, ap as CreateInput, aq as CreateMigrationResult, ar as CursorDocs, as as CustomField, at as CustomFieldTypes, au as DashboardWidget, av as Database, aw as DatabaseAdapter, ax as DatabaseInitArgs, ay as DatabaseTransfer, az as DateField, aA as DepthOptions, aB as DirectUpload, aC as DiskStorageOptions, aD as DocumentOf, E as EasyCMS, aE as EasyCMSError, aF as EmailAdapter, aG as EmailField, aH as EmailMessage, aI as Endpoint, aJ as EndpointRequest, aK as ErrorCode, aL as FIELD_TYPES, F as Field, aM as FieldAccess, aN as FieldAccessFn, aO as FieldAdmin, a as FieldError, aP as FieldRule, aQ as FieldType, aR as FieldTypeBase, aS as FieldTypeDefinition, aT as FieldTypeValidateContext, aU as FieldValidate, aV as FieldValidateContext, aW as FieldValue, aX as FieldsInput, aY as FieldsValue, b as FilterOptions, aZ as FilterOptionsArgs, a_ as FindAfterArgs, a$ as FindArgs, b0 as FindOptions, b1 as FolderLevel, b2 as FolderPermissions, b3 as ForbiddenError, b4 as GlobalAccess, b5 as GlobalConfig, b6 as GlobalDocument, b7 as GlobalHooks, b8 as GlobalInput, b9 as GlobalSlug, ba as GroupField, bb as ImageSize, bc as IncrementOptions, bd as InferCollection, be as InferGlobal, bf as JobConfig, bg as JsonField, bh as KeysetPage, bi as Label, bj as LayoutNode, bk as LivePreview, bl as LocaleOf, L as LocalizationConfig, bm as LogDetails, bn as Logger, bo as LoginArgs, bp as LogsConfig, bq as MediaDocument, br as MediaSize, bs as MembersConfig, bt as MembersSignup, bu as MigrationInfo, bv as NavGroup, bw as NotFoundError, bx as NumberField, by as OnRequest, bz as OnRequestArgs, bA as Operation, bB as OutboxRow, bC as PLUGIN_API_VERSION, bD as PasswordEmail, bE as PasswordEmailArgs, bF as PasswordEmailFn, bG as PasswordLinkOptions, bH as PayloadTooLargeError, bI as Plugin, bJ as PluginInfo, bK as PluginTypes, bL as PreviewTarget, bM as PreviewURL, bN as QueryError, bO as ROLE_OPERATIONS, bP as RawDocument, bQ as ReadOptions, bR as RelationshipField, bS as RequestContext, R as ResolvedConfig, bT as RichTextDocument, bU as RichTextField, bV as Role, bW as RoleOperation, bX as RolePermissions, bY as Roles, bZ as RoutesConfig, b_ as ScheduledPublish, b$ as SchemaError, c0 as SchemaMode, c1 as SearchAdapter, c2 as SearchEntry, c3 as SearchHits, c4 as SearchOptions, c5 as SearchQuery, c6 as SearchResults, c7 as SearchSetting, c8 as SelectField, c9 as SelectOption, ca as Session, cb as SidebarPanel, cc as SignupArgs, cd as SignupResult, ce as SingleSignOn, cf as SlugField, cg as SlugOf, ch as SsoOutcome, ci as SsoProviderRef, cj as StorageAdapter, ck as StoredFile, cl as TRIGRAM_LIKE_MIN, cm as TelemetryConfig, cn as TextField, co as TextareaField, cp as TooManyRequestsError, cq as TypedPlugin, cr as UnauthorizedError, cs as UncountedDocs, ct as UpdateInput, cu as UpdateOptions, cv as UploadConfig, cw as UploadField, cx as UploadFromURLConfig, cy as UserIdentity, cz as ValidationError, cA as Version, cB as VersionSummary, cC as VersionsConfig, cD as WEBHOOK_EVENTS, cE as WebhookConfig, cF as WebhookEvent, cG as Where, cH as WhereOperators, cI as anyone, cJ as consoleEmail, cK as consoleLogger, cL as createEasyCMS, cM as defineConfig, cN as defineFieldType, cO as definePlugin, cP as diskStorage, cQ as hasRows, cR as isAdmin, cS as isHasMany, cT as isSignedIn, cU as isStaff, cV as isSystemAdmin, cW as jsonLogger, cX as memorySearch, cY as mimeAllowedBy, cZ as rowFields, c_ as silentLogger, c$ as uniqueWithinOf } from './config-Bsp6rkuH.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-CUzEJN31.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-Br9Pu6z9.js';
+import { P as PaginatedDocs, I as ID, d as EmailSetting, W as WebhookPayload } from './config-BpKdXA32.js';
+export { A as ADAPTER_API_VERSION, e as ADMIN_ICONS, f as Access, g as AccessArgs, h as AccessOptions, i as AdminBrand, j as AdminCommand, k as AdminComponent, l as AdminConfig, m as AdminFieldArgs, n as AdminIcon, o as AdminLocale, p as AdminPage, q as AdminRole, r as AdminRoleChange, s as AdminRoleField, t as AdminRoleTarget, u as AdminRoleView, v as AdminRoles, w as AdminSso, x as AdminSwitcher, y as AdminViewAccess, z as AfterChangeHook, B as AfterDeleteHook, D as AfterReadHook, G as ApiKeyContext, H as ApiKeyGlobalOperation, J as ApiKeyOperation, K as ApiKeyPermissions, M as ArrayField, N as AuditChange, O as AuditConfig, Q as AuditEntry, S as AuditLog, T as AuditPage, U as AuditVerification, V as Auth, X as AuthConfig, Y as AuthProvider, Z as AuthProviderProfile, _ as AuthProviderRequest, $ as AuthUser, a0 as BackupsConfig, a1 as BeforeChangeHook, a2 as BeforeDeleteHook, a3 as BeforeValidateHook, a4 as Block, a5 as BlocksField, a6 as BooleanField, a7 as BuiltinApiKeysCollection, a8 as BuiltinMediaCollection, a9 as BuiltinMediaFoldersCollection, aa as BuiltinUsersCollection, ab as BundleHints, ac as CliCommand, ad as CollectionAccess, ae as CollectionAdmin, af as CollectionCalendarAdmin, ag as CollectionConfig, ah as CollectionDocument, ai as CollectionHooks, aj as CollectionListAdmin, ak as CollectionSearch, al as CollectionSlug, C as Config, am as ConfigError, an as ConfigIssue, ao as ContainerAdmin, c as CreateEasyCMSOptions, ap as CreateInput, aq as CreateMigrationResult, ar as CursorDocs, as as CustomField, at as CustomFieldTypes, au as DashboardWidget, av as Database, aw as DatabaseAdapter, ax as DatabaseInitArgs, ay as DatabaseTransfer, az as DateField, aA as DepthOptions, aB as DirectUpload, aC as DiskStorageOptions, aD as DocumentOf, E as EasyCMS, aE as EasyCMSError, aF as EmailAdapter, aG as EmailField, aH as EmailMessage, aI as Endpoint, aJ as EndpointRequest, aK as ErrorCode, aL as FIELD_TYPES, F as Field, aM as FieldAccess, aN as FieldAccessFn, aO as FieldAdmin, a as FieldError, aP as FieldRule, aQ as FieldType, aR as FieldTypeBase, aS as FieldTypeDefinition, aT as FieldTypeValidateContext, aU as FieldValidate, aV as FieldValidateContext, aW as FieldValue, aX as FieldsInput, aY as FieldsValue, b as FilterOptions, aZ as FilterOptionsArgs, a_ as FindAfterArgs, a$ as FindArgs, b0 as FindOptions, b1 as FolderLevel, b2 as FolderPermissions, b3 as ForbiddenError, b4 as GlobalAccess, b5 as GlobalConfig, b6 as GlobalDocument, b7 as GlobalHooks, b8 as GlobalInput, b9 as GlobalSlug, ba as GroupField, bb as ImageSize, bc as IncrementOptions, bd as InferCollection, be as InferGlobal, bf as JobConfig, bg as JsonField, bh as KeysetPage, bi as Label, bj as LayoutNode, bk as LivePreview, bl as LocaleOf, L as LocalizationConfig, bm as LogDetails, bn as Logger, bo as LoginArgs, bp as LogsConfig, bq as MediaDocument, br as MediaSize, bs as MembersConfig, bt as MembersSignup, bu as MigrationInfo, bv as NavGroup, bw as NotFoundError, bx as NumberField, by as OnRequest, bz as OnRequestArgs, bA as Operation, bB as OutboxRow, bC as PLUGIN_API_VERSION, bD as PasswordEmail, bE as PasswordEmailArgs, bF as PasswordEmailFn, bG as PasswordLinkOptions, bH as PayloadTooLargeError, bI as Plugin, bJ as PluginInfo, bK as PluginTypes, bL as PreviewTarget, bM as PreviewURL, bN as QueryError, bO as ROLE_OPERATIONS, bP as RawDocument, bQ as ReadOptions, bR as RelationshipField, bS as RequestContext, R as ResolvedConfig, bT as RichTextDocument, bU as RichTextField, bV as Role, bW as RoleOperation, bX as RolePermissions, bY as Roles, bZ as RoutesConfig, b_ as ScheduledPublish, b$ as SchemaError, c0 as SchemaMode, c1 as SearchAdapter, c2 as SearchEntry, c3 as SearchHits, c4 as SearchOptions, c5 as SearchQuery, c6 as SearchResults, c7 as SearchSetting, c8 as SelectField, c9 as SelectOption, ca as Session, cb as SidebarPanel, cc as SignupArgs, cd as SignupResult, ce as SingleSignOn, cf as SlugField, cg as SlugOf, ch as SsoOutcome, ci as SsoProviderRef, cj as StorageAdapter, ck as StoredFile, cl as TRIGRAM_LIKE_MIN, cm as TelemetryConfig, cn as TextField, co as TextareaField, cp as TooManyRequestsError, cq as TypedPlugin, cr as UiField, cs as UnauthorizedError, ct as UncountedDocs, cu as UpdateInput, cv as UpdateOptions, cw as UploadConfig, cx as UploadField, cy as UploadFromURLConfig, cz as UserIdentity, cA as ValidationError, cB as Version, cC as VersionSummary, cD as VersionsConfig, cE as WEBHOOK_EVENTS, cF as WebhookConfig, cG as WebhookEvent, cH 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-BpKdXA32.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-AYwNCGrB.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-BokoUN1I.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-AAZ35NPQ.js";
+} from "./chunk-5L544S33.js";
 import {
   matchesCondition
 } from "./chunk-U266LV4M.js";
@@ -53,7 +53,7 @@ import {
   defineFieldType,
   definePlugin,
   warnDeprecated
-} from "./chunk-RJGKAYUU.js";
+} from "./chunk-J6E6QMDG.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 { d0 as API_KEYS, d1 as API_KEY_GLOBAL_OPERATIONS, d2 as API_KEY_OPERATIONS, d3 as DEFAULT_MAX_VERSIONS, d4 as DEFAULT_PASSWORD_EMAILS, d5 as FIELD_TYPE_BASES, d6 as FOLDER_LEVELS, d7 as MediaFolders, d8 as SSO_COOKIE, d9 as Secrets, cl as TRIGRAM_LIKE_MIN, da as codeOfStatus, cQ as hasRows, cS as isHasMany, db as isJsonLogger, dc as keyAllows, dd as logFormat, cY as mimeAllowedBy, cZ as rowFields, de as secretsOf, c$ as uniqueWithinOf } from './config-Bsp6rkuH.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-Br9Pu6z9.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, cl 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-BpKdXA32.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-BokoUN1I.js';
 export { conditionIssues } from './conditions.js';
 
 /** The session cookie the REST API sets at login. */
@@ -92,12 +92,14 @@ declare const DEFAULT_DEPTH = 1;
 declare const MAX_DEPTH = 3;
 /** Loads the documents of one collection that the caller may see. */
 type Loader = (collection: CollectionConfig, ids: readonly ID[]) => Promise<RawDocument[]>;
+/** A linked document's URL, for links in rich text (#326); `null` when it has none. */
+type LinkURL = (collection: CollectionConfig, doc: RawDocument) => string | null;
 /**
  * Replaces relationship and upload ids with documents, `depth` levels deep.
  * Missing (or unreadable) documents become `null` (single) or are dropped (hasMany).
  * Returns new objects; the input is not modified.
  */
-declare function populate(load: Loader, collections: readonly CollectionConfig[], fields: readonly Field[], docs: RawDocument[], depth: number): Promise<RawDocument[]>;
+declare function populate(load: Loader, collections: readonly CollectionConfig[], fields: readonly Field[], docs: RawDocument[], depth: number, linkURL?: LinkURL): Promise<RawDocument[]>;
 
 /**
  * Finds the file of an admin module (`admin.modules`): a package export or a path relative to

package/dist/internal.js

@@ -58,7 +58,7 @@ import {
   verifyPassword,
   verifyTurnstile,
   writeBackupFile
-} from "./chunk-AAZ35NPQ.js";
+} from "./chunk-5L544S33.js";
 import {
   conditionIssues
 } from "./chunk-U266LV4M.js";
@@ -77,7 +77,7 @@ import {
   rowFields,
   sniffMimeType,
   uniqueWithinOf
-} from "./chunk-RJGKAYUU.js";
+} from "./chunk-J6E6QMDG.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("");
@@ -160,12 +160,15 @@ ${indent}}`
       );
       return `(${kinds.join(" | ")})[]`;
     }
+    // Stores nothing (and is gone from a resolved config).
+    case "ui":
+      return "never";
   }
 }
 function fieldLines(fields, n, indent) {
   const lines = [];
   for (const field of fields) {
-    if (field.hidden) continue;
+    if (field.hidden || field.type === "ui") continue;
     const type = fieldType(field, n, indent);
     const alwaysPresent = field.type === "array" || field.type === "blocks" || field.type === "group" || isHasMany(field);
     if (field.required || alwaysPresent) lines.push(`${indent}${key(field.name)}: ${type}`);

package/dist/{plugin-CUzEJN31.d.ts → plugin-AYwNCGrB.d.ts}

@@ -1,4 +1,4 @@
-import { bi as Label, F as Field, I as ID, o as AdminLocale, x as AdminSwitcher, ci as SsoProviderRef } from './config-Bsp6rkuH.js';
+import { bi as Label, F as Field, I as ID, o as AdminLocale, x as AdminSwitcher, ci as SsoProviderRef } from './config-BpKdXA32.js';
 import { FieldCondition } from './conditions.js';
 
 /** A Web Component from an admin module, with its `props` (plain JSON). */

package/dist/plugin.d.ts

@@ -1,3 +1,3 @@
-export { e as ADMIN_ICONS, k as AdminComponent, n as AdminIcon, $ as AuthUser, ac as CliCommand, ad as CollectionAccess, ag as CollectionConfig, C as Config, am as ConfigError, au as DashboardWidget, aE as EasyCMSError, aI as Endpoint, aJ as EndpointRequest, aK as ErrorCode, F as Field, aM as FieldAccess, a as FieldError, aR as FieldTypeBase, aS as FieldTypeDefinition, aT as FieldTypeValidateContext, b3 as ForbiddenError, b5 as GlobalConfig, I as ID, bf as JobConfig, bi as Label, bv as NavGroup, bw as NotFoundError, by as OnRequest, bz as OnRequestArgs, bC as PLUGIN_API_VERSION, bH as PayloadTooLargeError, bI as Plugin, bJ as PluginInfo, bK as PluginTypes, bN as QueryError, bS as RequestContext, cp as TooManyRequestsError, cq as TypedPlugin, cr as UnauthorizedError, cz as ValidationError, cG as Where, cN as defineFieldType, cO as definePlugin } from './config-Bsp6rkuH.js';
-export { A as ADMIN_API_VERSION, c as AdminElementProps, k as AdminPageRoute, S as SetFieldDetail, w as warnDeprecated } from './plugin-CUzEJN31.js';
+export { e as ADMIN_ICONS, k as AdminComponent, n as AdminIcon, $ as AuthUser, ac as CliCommand, ad as CollectionAccess, ag as CollectionConfig, C as Config, am as ConfigError, au as DashboardWidget, aE as EasyCMSError, aI as Endpoint, aJ as EndpointRequest, aK as ErrorCode, F as Field, aM as FieldAccess, a as FieldError, aR as FieldTypeBase, aS as FieldTypeDefinition, aT as FieldTypeValidateContext, b3 as ForbiddenError, b5 as GlobalConfig, I as ID, bf as JobConfig, bi as Label, bv as NavGroup, bw as NotFoundError, by as OnRequest, bz as OnRequestArgs, bC as PLUGIN_API_VERSION, bH as PayloadTooLargeError, bI as Plugin, bJ as PluginInfo, bK as PluginTypes, bN as QueryError, bS as RequestContext, cp as TooManyRequestsError, cq as TypedPlugin, cs as UnauthorizedError, cA as ValidationError, cH as Where, cO as defineFieldType, cP as definePlugin } from './config-BpKdXA32.js';
+export { A as ADMIN_API_VERSION, c as AdminElementProps, k as AdminPageRoute, S as SetFieldDetail, w as warnDeprecated } from './plugin-AYwNCGrB.js';
 import './conditions.js';

package/dist/plugin.js

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

package/package.json

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