@karibsen/eponyme 0.9.0-nightly.20260912 → 1.0.0

package/dist/eponyme.d.mts

@@ -1,12 +1,15 @@
 import { SectionSchema, FieldVisibilityCondition, SectionFieldDefinition, EponymeCustomFieldTypeDefinition } from '../dist/runtime/types/field.js';
 import { EponymeConfig, EponymeSchema, EponymeCollectionOptions, CollectionSlugField, EponymeCollectionDefinition, EponymeFormSchema, EponymeFormOptions, EponymeFormDefinition } from '../dist/runtime/types/index.js';
-export { ArrayFieldDefinition, ArrayFieldOptions, ArrayItemDefinition, ArrayItemFieldDefinition, ArrayItemSchema, ArrayItemValue, BooleanFieldDefinition, BooleanFieldOptions, CheckboxGroupFieldDefinition, CheckboxGroupFieldOptions, CollectionSlugField, ColorFieldDefinition, ColorFieldOptions, DateFieldDefinition, DateFieldOptions, DateTimeFieldDefinition, DateTimeFieldOptions, DurationFieldDefinition, DurationFieldOptions, DurationInput, EmailFieldDefinition, EmailFieldOptions, EponymeAuthSession, EponymeAuthUser, EponymeCacheFailureContext, EponymeCacheOperation, EponymeCollectionDataByName, EponymeCollectionDefinition, EponymeCollectionDefinitionBase, EponymeCollectionName, EponymeCollectionOptions, EponymeConfig, EponymeCustomFieldComponentProps, EponymeCustomFieldDefinition, EponymeCustomFieldOptions, EponymeCustomFieldTypeDefinition, EponymeCustomFieldValues, EponymeData, EponymeDataByName, EponymeEntryBeforeSaveContext, EponymeEntryContext, EponymeEntryTrashContext, EponymeFormDataByName, EponymeFormDefinition, EponymeFormDefinitionBase, EponymeFormFieldDefinition, EponymeFormMode, EponymeFormName, EponymeFormOptions, EponymeFormSchema, EponymeFormSubmissionContext, EponymeHooks, EponymeManagedUserResult, EponymeName, EponymePermissionAction, EponymePermissionRule, EponymePermissionTarget, EponymeResource, EponymeResourceKind, EponymeRole, EponymeRoleDefinition, EponymeRoleDefinitions, EponymeRoleOption, EponymeSchema, EponymeSystemResource, EponymeVariableDefinition, EponymeVariableSummary, EponymeVariableValue, EponymeVariables, FieldDefinition, FieldValidationResult, FieldValidator, FieldVisibilityCondition, ImageFieldDefinition, ImageFieldOptions, ImageSource, InferEponymeCustomFieldOptions, InferEponymeCustomFieldValue, MediaPlayerFieldDefinition, MediaPlayerFieldOptions, MediaPlayerProvider, MediaPlayerValue, NormalizedDurationFieldOptions, NumberFieldDefinition, NumberFieldOptions, RadioFieldDefinition, RadioFieldOptions, RichTextFieldDefinition, RichTextFieldOptions, SectionFieldDefinition, SectionFieldOptions, SectionItemFieldDefinition, SectionItemValue, SectionSchema, SectionValue, SelectFieldDefinition, SelectFieldOptions, SelectOption, SlugFieldDefinition, SlugFieldOptions, StringFieldDefinition, StringFieldOptions, TabDefinition, TabFieldDefinition, TabFieldOptions, TabsSchema, TabsValue, TextareaFieldDefinition, TextareaFieldOptions, TodayDateDefault, UrlFieldDefinition, UrlFieldOptions, UrlType, UrlValue } from '../dist/runtime/types/index.js';
+export { ArrayFieldDefinition, ArrayFieldOptions, ArrayItemDefinition, ArrayItemFieldDefinition, ArrayItemSchema, ArrayItemValue, BooleanFieldDefinition, BooleanFieldOptions, CheckboxGroupFieldDefinition, CheckboxGroupFieldOptions, CollectionSlugField, ColorFieldDefinition, ColorFieldOptions, DateFieldDefinition, DateFieldOptions, DateTimeFieldDefinition, DateTimeFieldOptions, DurationFieldDefinition, DurationFieldOptions, DurationInput, EmailFieldDefinition, EmailFieldOptions, EponymeAuthSession, EponymeAuthUser, EponymeCacheFailureContext, EponymeCacheOperation, EponymeCdnDependency, EponymeCdnProvider, EponymeCdnPurgeContext, EponymeCdnPurgeFailedContext, EponymeCdnPurgeRequest, EponymeCollectionDataByName, EponymeCollectionDefinition, EponymeCollectionDefinitionBase, EponymeCollectionName, EponymeCollectionOptions, EponymeConfig, EponymeCustomFieldComponentProps, EponymeCustomFieldDefinition, EponymeCustomFieldOptions, EponymeCustomFieldTypeDefinition, EponymeCustomFieldValues, EponymeData, EponymeDataByName, EponymeEntryBeforeSaveContext, EponymeEntryContext, EponymeEntryTrashContext, EponymeFormDataByName, EponymeFormDefinition, EponymeFormDefinitionBase, EponymeFormFieldDefinition, EponymeFormMode, EponymeFormName, EponymeFormOptions, EponymeFormSchema, EponymeFormSubmissionContext, EponymeHooks, EponymeImageCrop, EponymeImageFocal, EponymeImageInput, EponymeImageRatio, EponymeImageValue, EponymeManagedUserResult, EponymeName, EponymePermissionAction, EponymePermissionRule, EponymePermissionTarget, EponymeResource, EponymeResourceKind, EponymeRole, EponymeRoleDefinition, EponymeRoleDefinitions, EponymeRoleOption, EponymeSchema, EponymeSystemResource, EponymeVariableDefinition, EponymeVariableSummary, EponymeVariableValue, EponymeVariables, FieldDefinition, FieldValidationResult, FieldValidator, FieldVisibilityCondition, ImageFieldDefinition, ImageFieldOptions, ImageSource, InferEponymeCustomFieldOptions, InferEponymeCustomFieldValue, MediaPlayerFieldDefinition, MediaPlayerFieldOptions, MediaPlayerProvider, MediaPlayerValue, NormalizedDurationFieldOptions, NumberFieldDefinition, NumberFieldOptions, RadioFieldDefinition, RadioFieldOptions, RichTextFieldDefinition, RichTextFieldOptions, SectionFieldDefinition, SectionFieldOptions, SectionItemFieldDefinition, SectionItemValue, SectionSchema, SectionValue, SelectFieldDefinition, SelectFieldOptions, SelectOption, SlugFieldDefinition, SlugFieldOptions, StringFieldDefinition, StringFieldOptions, TabDefinition, TabFieldDefinition, TabFieldOptions, TabsSchema, TabsValue, TextareaFieldDefinition, TextareaFieldOptions, TodayDateDefault, UrlFieldDefinition, UrlFieldOptions, UrlType, UrlValue } from '../dist/runtime/types/index.js';
 import { EponymeVariables } from '../dist/runtime/types/variables.js';
 export { field, toMs, today } from '../dist/runtime/fields/index.js';
-export { EponymeSeoDefinition, EponymeSeoValue, SeoFieldOptions, resolveEponymeSeo } from '../dist/runtime/fields/seo.js';
+export { EponymeResolvedSeo, EponymeSeoDefinition, EponymeSeoValue, SeoFieldOptions, isEponymeSeoExcludedFromSitemap, resolveEponymeSeo } from '../dist/runtime/fields/seo.js';
+export { EponymeSeoHead, EponymeSeoHeadOptions, buildEponymeSeoHead } from '../dist/runtime/utils/eponyme-seo-head.js';
 import { EponymeRoleDefinitions, EponymePermissionAction, EponymePermissionTarget, EponymePermissionRule } from '../dist/runtime/types/permissions.js';
 export { EPONYME_DEFAULT_ROLES, EPONYME_PERMISSION_ACTIONS, EPONYME_SYSTEM_RESOURCES } from '../dist/runtime/types/permissions.js';
 export { eponymeMediaEmbedUrl, eponymeMediaThumbnailUrl, parseEponymeMediaUrl } from '../dist/runtime/utils/media-player.js';
+export { EponymeImageAttrs, EponymeImageAttrsOptions, eponymeImageAttrs, eponymeImageObjectPosition, eponymeImageSrc, parseEponymeImageRatio, toEponymeImageValue } from '../dist/runtime/utils/image-value.js';
+export { EponymePopulateDepth, EponymePopulatedData, EponymeReferrer, EponymeRelationTarget, EponymeSchemaByName } from '../dist/runtime/types/relations.js';
 
 interface EponymeBlockOptions<T extends SectionSchema> {
     name: string;

package/dist/eponyme.mjs

@@ -1,9 +1,11 @@
 import { section } from '../dist/runtime/fields/section.js';
 import { e as eponymeConfigInteger } from './shared/eponyme.BLMX8x9_.mjs';
 export { field, toMs, today } from '../dist/runtime/fields/index.js';
-export { resolveEponymeSeo } from '../dist/runtime/fields/seo.js';
+export { isEponymeSeoExcludedFromSitemap, resolveEponymeSeo } from '../dist/runtime/fields/seo.js';
+export { buildEponymeSeoHead } from '../dist/runtime/utils/eponyme-seo-head.js';
 export { EPONYME_DEFAULT_ROLES, EPONYME_PERMISSION_ACTIONS, EPONYME_SYSTEM_RESOURCES } from '../dist/runtime/types/permissions.js';
 export { eponymeMediaEmbedUrl, eponymeMediaThumbnailUrl, parseEponymeMediaUrl } from '../dist/runtime/utils/media-player.js';
+export { eponymeImageAttrs, eponymeImageObjectPosition, eponymeImageSrc, parseEponymeImageRatio, toEponymeImageValue } from '../dist/runtime/utils/image-value.js';
 
 function defineBlock(block) {
   return (overrides = {}) => ({

package/dist/module.d.mts

@@ -2,12 +2,16 @@ import * as _nuxt_schema from '@nuxt/schema';
 import { EponymeLocaleDefinition } from '../dist/runtime/locales/index.js';
 export { EponymeLocaleDefinition, EponymeMessageKey } from '../dist/runtime/locales/index.js';
 import { EponymePublicationOption } from '../dist/runtime/utils/eponyme-publication.js';
+import { EponymeCdnProvider, EponymeCdnDependency } from '../dist/runtime/types/cdn.js';
 export { EponymeBlock, EponymeBlockDefinition, EponymeBlockOptions, EponymeBlockOverrides, collection, defineBlock, defineEponymeConfig, defineEponymeField, defineEponymeRoles, defineEponymeVariables, form, permission } from './eponyme.mjs';
 export { field, toMs, today } from '../dist/runtime/fields/index.js';
-export { EponymeSeoDefinition, EponymeSeoValue, SeoFieldOptions, resolveEponymeSeo } from '../dist/runtime/fields/seo.js';
+export { EponymeResolvedSeo, EponymeSeoDefinition, EponymeSeoValue, SeoFieldOptions, isEponymeSeoExcludedFromSitemap, resolveEponymeSeo } from '../dist/runtime/fields/seo.js';
+export { EponymeSeoHead, EponymeSeoHeadOptions, buildEponymeSeoHead } from '../dist/runtime/utils/eponyme-seo-head.js';
 export { EPONYME_DEFAULT_ROLES, EPONYME_PERMISSION_ACTIONS, EPONYME_SYSTEM_RESOURCES } from '../dist/runtime/types/permissions.js';
 export { eponymeMediaEmbedUrl, eponymeMediaThumbnailUrl, parseEponymeMediaUrl } from '../dist/runtime/utils/media-player.js';
-export { ArrayFieldDefinition, ArrayFieldOptions, ArrayItemDefinition, ArrayItemFieldDefinition, ArrayItemSchema, ArrayItemValue, BooleanFieldDefinition, BooleanFieldOptions, CheckboxGroupFieldDefinition, CheckboxGroupFieldOptions, CollectionSlugField, ColorFieldDefinition, ColorFieldOptions, DateFieldDefinition, DateFieldOptions, DateTimeFieldDefinition, DateTimeFieldOptions, DurationFieldDefinition, DurationFieldOptions, DurationInput, EmailFieldDefinition, EmailFieldOptions, EponymeAuthSession, EponymeAuthUser, EponymeCacheFailureContext, EponymeCacheOperation, EponymeCollectionDataByName, EponymeCollectionDefinition, EponymeCollectionDefinitionBase, EponymeCollectionName, EponymeCollectionOptions, EponymeConfig, EponymeCustomFieldComponentProps, EponymeCustomFieldDefinition, EponymeCustomFieldOptions, EponymeCustomFieldTypeDefinition, EponymeCustomFieldValues, EponymeData, EponymeDataByName, EponymeEntryBeforeSaveContext, EponymeEntryContext, EponymeEntryTrashContext, EponymeFormDataByName, EponymeFormDefinition, EponymeFormDefinitionBase, EponymeFormFieldDefinition, EponymeFormMode, EponymeFormName, EponymeFormOptions, EponymeFormSchema, EponymeFormSubmissionContext, EponymeHooks, EponymeManagedUserResult, EponymeName, EponymePermissionAction, EponymePermissionRule, EponymePermissionTarget, EponymeResource, EponymeResourceKind, EponymeRole, EponymeRoleDefinition, EponymeRoleDefinitions, EponymeRoleOption, EponymeSchema, EponymeSystemResource, EponymeVariableDefinition, EponymeVariableSummary, EponymeVariableValue, EponymeVariables, FieldDefinition, FieldValidationResult, FieldValidator, FieldVisibilityCondition, ImageFieldDefinition, ImageFieldOptions, ImageSource, InferEponymeCustomFieldOptions, InferEponymeCustomFieldValue, MediaPlayerFieldDefinition, MediaPlayerFieldOptions, MediaPlayerProvider, MediaPlayerValue, NormalizedDurationFieldOptions, NumberFieldDefinition, NumberFieldOptions, RadioFieldDefinition, RadioFieldOptions, RichTextFieldDefinition, RichTextFieldOptions, SectionFieldDefinition, SectionFieldOptions, SectionItemFieldDefinition, SectionItemValue, SectionSchema, SectionValue, SelectFieldDefinition, SelectFieldOptions, SelectOption, SlugFieldDefinition, SlugFieldOptions, StringFieldDefinition, StringFieldOptions, TabDefinition, TabFieldDefinition, TabFieldOptions, TabsSchema, TabsValue, TextareaFieldDefinition, TextareaFieldOptions, TodayDateDefault, UrlFieldDefinition, UrlFieldOptions, UrlType, UrlValue } from '../dist/runtime/types/index.js';
+export { EponymeImageAttrs, EponymeImageAttrsOptions, eponymeImageAttrs, eponymeImageObjectPosition, eponymeImageSrc, parseEponymeImageRatio, toEponymeImageValue } from '../dist/runtime/utils/image-value.js';
+export { ArrayFieldDefinition, ArrayFieldOptions, ArrayItemDefinition, ArrayItemFieldDefinition, ArrayItemSchema, ArrayItemValue, BooleanFieldDefinition, BooleanFieldOptions, CheckboxGroupFieldDefinition, CheckboxGroupFieldOptions, CollectionSlugField, ColorFieldDefinition, ColorFieldOptions, DateFieldDefinition, DateFieldOptions, DateTimeFieldDefinition, DateTimeFieldOptions, DurationFieldDefinition, DurationFieldOptions, DurationInput, EmailFieldDefinition, EmailFieldOptions, EponymeAuthSession, EponymeAuthUser, EponymeCacheFailureContext, EponymeCacheOperation, EponymeCdnDependency, EponymeCdnProvider, EponymeCdnPurgeContext, EponymeCdnPurgeFailedContext, EponymeCdnPurgeRequest, EponymeCollectionDataByName, EponymeCollectionDefinition, EponymeCollectionDefinitionBase, EponymeCollectionName, EponymeCollectionOptions, EponymeConfig, EponymeCustomFieldComponentProps, EponymeCustomFieldDefinition, EponymeCustomFieldOptions, EponymeCustomFieldTypeDefinition, EponymeCustomFieldValues, EponymeData, EponymeDataByName, EponymeEntryBeforeSaveContext, EponymeEntryContext, EponymeEntryTrashContext, EponymeFormDataByName, EponymeFormDefinition, EponymeFormDefinitionBase, EponymeFormFieldDefinition, EponymeFormMode, EponymeFormName, EponymeFormOptions, EponymeFormSchema, EponymeFormSubmissionContext, EponymeHooks, EponymeImageCrop, EponymeImageFocal, EponymeImageInput, EponymeImageRatio, EponymeImageValue, EponymeManagedUserResult, EponymeName, EponymePermissionAction, EponymePermissionRule, EponymePermissionTarget, EponymeResource, EponymeResourceKind, EponymeRole, EponymeRoleDefinition, EponymeRoleDefinitions, EponymeRoleOption, EponymeSchema, EponymeSystemResource, EponymeVariableDefinition, EponymeVariableSummary, EponymeVariableValue, EponymeVariables, FieldDefinition, FieldValidationResult, FieldValidator, FieldVisibilityCondition, ImageFieldDefinition, ImageFieldOptions, ImageSource, InferEponymeCustomFieldOptions, InferEponymeCustomFieldValue, MediaPlayerFieldDefinition, MediaPlayerFieldOptions, MediaPlayerProvider, MediaPlayerValue, NormalizedDurationFieldOptions, NumberFieldDefinition, NumberFieldOptions, RadioFieldDefinition, RadioFieldOptions, RichTextFieldDefinition, RichTextFieldOptions, SectionFieldDefinition, SectionFieldOptions, SectionItemFieldDefinition, SectionItemValue, SectionSchema, SectionValue, SelectFieldDefinition, SelectFieldOptions, SelectOption, SlugFieldDefinition, SlugFieldOptions, StringFieldDefinition, StringFieldOptions, TabDefinition, TabFieldDefinition, TabFieldOptions, TabsSchema, TabsValue, TextareaFieldDefinition, TextareaFieldOptions, TodayDateDefault, UrlFieldDefinition, UrlFieldOptions, UrlType, UrlValue } from '../dist/runtime/types/index.js';
+export { EponymePopulateDepth, EponymePopulatedData, EponymeReferrer, EponymeRelationTarget, EponymeSchemaByName } from '../dist/runtime/types/relations.js';
 import '../dist/runtime/types/field.js';
 import '../dist/runtime/types/variables.js';
 
@@ -187,6 +191,16 @@ interface ModuleOptions {
      * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control
      */
     cdnCacheSeconds?: number;
+    /** How far a read may resolve relations with `depth`. */
+    relations?: {
+        /**
+         * Deepest `depth` a read may ask for, server helpers included. A deeper request is refused rather than
+         * silently cut short. At most 5.
+         *
+         * @default 3
+         */
+        maxDepth?: number;
+    };
     /**
      * Language of the dashboard interface, resolved once at build time.
      *
@@ -202,8 +216,69 @@ interface ModuleOptions {
      * ```
      */
     locale?: EponymeLocaleDefinition;
+    /**
+     * Public origin of the site, used to make canonical and sharing URLs absolute (`useEponymeSeo`). Falls
+     * back to `runtimeConfig.public.siteUrl`, then to the origin of the request.
+     *
+     * @example 'https://example.com'
+     */
+    siteUrl?: string;
+    /**
+     * Purges the CDN on its own when content changes: publication, unpublication, scheduling, restore,
+     * trash and deletion. Off unless a provider is set. Credentials are read from the environment only:
+     * `EPONYME_CDN_CLOUDFLARE_API_TOKEN` and `EPONYME_CDN_CLOUDFLARE_ZONE_ID` for Cloudflare, nothing for
+     * Vercel, which hands its purge API to the function itself.
+     *
+     * @example
+     * ```ts
+     * cdn: {
+     *   provider: 'vercel',
+     *   dependencies: [
+     *     { on: ['club'], routes: ['/**'] },
+     *     { on: '*', routes: ['/sitemap.xml'] },
+     *   ],
+     * }
+     * ```
+     */
+    cdn?: EponymeCdnOptions;
+}
+interface EponymeCdnOptions {
+    /** `custom` sends every purge to the `eponyme:cdn:purge` Nitro hook instead of an API. */
+    provider: EponymeCdnProvider;
+    /** Cached responses that show content without carrying its tags: layouts, listings, aggregates. */
+    dependencies?: EponymeCdnDependency[];
+    /** Tags purged on every change, whatever changed. */
+    alwaysPurge?: string[];
+    /**
+     * Tags public responses at request time, from `previewPaths` and `dependencies`, and on Vercel tags the
+     * ISR entry itself, which a response header does not do.
+     *
+     * @default true
+     */
+    tagResponses?: boolean;
+    /** How long a purge waits for others to merge with, in milliseconds. @default 250 */
+    debounceMs?: number;
+    /** Further attempts after a failed purge. @default 2 */
+    retries?: number;
+    /** Longest one attempt may take, in milliseconds. @default 10000 */
+    timeoutMs?: number;
+    /**
+     * Makes the write wait for its purge. Only useful on a serverless platform without `waitUntil`, where
+     * the function would otherwise stop before the purge leaves; Vercel has one.
+     *
+     * @default false
+     */
+    await?: boolean;
+    vercel?: {
+        /** `invalidate` serves the stale copy once while it regenerates; `delete` drops it. @default 'invalidate' */
+        mode?: 'invalidate' | 'delete';
+    };
+    cloudflare?: {
+        /** Not a secret, so it may be written here. `EPONYME_CDN_CLOUDFLARE_ZONE_ID` takes precedence. */
+        zoneId?: string;
+    };
 }
 declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
 
 export { _default as default };
-export type { ModuleOptions };
+export type { EponymeCdnOptions, ModuleOptions };

package/dist/module.json

@@ -4,9 +4,9 @@
   "compatibility": {
     "nuxt": ">=4.5.1"
   },
-  "version": "0.9.0-nightly.20260912",
+  "version": "1.0.0",
   "builder": {
-    "@nuxt/module-builder": "1.0.2",
+    "@nuxt/module-builder": "1.0.4",
     "unbuild": "3.6.1"
   }
 }

package/dist/module.mjs

@@ -1,4 +1,4 @@
-import { defineNuxtModule, useLogger, createResolver, addTemplate, addTypeTemplate, updateTemplates, findPath, extendViteConfig, addPlugin, addImports, addImportsDir, addComponent, addServerImports, addRouteMiddleware, addServerHandler, addServerPlugin, hasNuxtModule, hasNuxtModuleCompatibility, getNuxtModuleVersion } from '@nuxt/kit';
+import { defineNuxtModule, useLogger, createResolver, addTemplate, addTypeTemplate, updateTemplates, findPath, extendViteConfig, addPlugin, addImports, addImportsDir, addComponent, hasNuxtModule, addServerImports, addRouteMiddleware, addServerHandler, addServerPlugin, hasNuxtModuleCompatibility, getNuxtModuleVersion } from '@nuxt/kit';
 import pc from 'picocolors';
 import tailwindcss from '@tailwindcss/vite';
 import { e as eponymeConfigInteger } from './shared/eponyme.BLMX8x9_.mjs';
@@ -6,6 +6,7 @@ import { EPONYME_DEFAULT_LOCALE, eponymeEnglishMessages } from '../dist/runtime/
 import { resolve } from 'pathe';
 import { tagPreviewPathRoutes } from '../dist/runtime/utils/cache-tags.js';
 import { createEponymeThemeBootstrap } from '../dist/runtime/utils/eponyme-theme.js';
+import { EPONYME_DEFAULT_POPULATE_DEPTH, EPONYME_MAX_POPULATE_DEPTH } from '../dist/runtime/utils/populate-depth.js';
 import { readdir } from 'node:fs/promises';
 
 function resolveEponymeLocale(locale, prefix = "[Eponyme]") {
@@ -145,6 +146,35 @@ function positiveInteger(value, fallback, name) {
 function integerInRange(value, fallback, name, min, max) {
   return eponymeConfigInteger(name, value, { fallback, min, max, prefix: pc.red("[Eponyme]") });
 }
+const CDN_PROVIDERS = ["vercel", "cloudflare", "custom"];
+function resolveCdnOptions(cdn, logger) {
+  const provider = cdn?.provider && CDN_PROVIDERS.includes(cdn.provider) ? cdn.provider : "";
+  if (cdn?.provider && !provider)
+    logger.warn(`eponyme.cdn.provider is "${cdn.provider}", which is none of ${CDN_PROVIDERS.join(", ")}. Nothing will be purged.`);
+  const dependencies = (cdn?.dependencies ?? []).flatMap((dependency, index) => {
+    const on = dependency.on === "*" ? "*" : Array.isArray(dependency.on) ? dependency.on.filter((name) => typeof name === "string" && name) : [];
+    if (on !== "*" && !on.length) {
+      logger.warn(`eponyme.cdn.dependencies[${index}] has no \`on\`, so nothing would ever purge it. It was ignored.`);
+      return [];
+    }
+    const routes = (dependency.routes ?? []).filter((route) => route.startsWith("/"));
+    if (routes.length !== (dependency.routes ?? []).length)
+      logger.warn(`eponyme.cdn.dependencies[${index}].routes must start with "/". The others were ignored.`);
+    return [{ on, routes, tags: dependency.tags ?? [], prefixes: dependency.prefixes ?? [] }];
+  });
+  return {
+    provider,
+    dependencies,
+    alwaysPurge: cdn?.alwaysPurge ?? [],
+    debounceMs: integerInRange(cdn?.debounceMs, 250, "eponyme.cdn.debounceMs", 0, 6e4),
+    retries: integerInRange(cdn?.retries, 2, "eponyme.cdn.retries", 0, 10),
+    timeoutMs: integerInRange(cdn?.timeoutMs, 1e4, "eponyme.cdn.timeoutMs", 100, 12e4),
+    awaitPurge: cdn?.await === true,
+    tagResponses: cdn?.tagResponses !== false,
+    vercelMode: cdn?.vercel?.mode === "delete" ? "delete" : "invalidate",
+    cloudflareZoneId: cdn?.cloudflare?.zoneId ?? ""
+  };
+}
 const module$1 = defineNuxtModule({
   meta: {
     name: "@karibsen/eponyme",
@@ -297,7 +327,8 @@ const module$1 = defineNuxtModule({
       publication: options.publication ?? true,
       storage: storageEnabled,
       storageAccept,
-      storageMaxSize
+      storageMaxSize,
+      siteUrl: (options.siteUrl ?? "").replace(/\/+$/, "")
     };
     nuxt.options.runtimeConfig.eponymeStorage = {
       prefix: storagePrefix,
@@ -332,9 +363,11 @@ const module$1 = defineNuxtModule({
       cacheStorage: options.cacheStorage?.trim() || "",
       autoReindex: options.autoReindex ?? true,
       browserCacheSeconds: integerInRange(options.browserCacheSeconds, 30, "eponyme.browserCacheSeconds", 0, MAX_CACHE_SECONDS),
-      cdnCacheSeconds: integerInRange(options.cdnCacheSeconds, 300, "eponyme.cdnCacheSeconds", 0, MAX_CACHE_SECONDS)
+      cdnCacheSeconds: integerInRange(options.cdnCacheSeconds, 300, "eponyme.cdnCacheSeconds", 0, MAX_CACHE_SECONDS),
+      relationsMaxDepth: integerInRange(options.relations?.maxDepth, EPONYME_DEFAULT_POPULATE_DEPTH, "eponyme.relations.maxDepth", 0, EPONYME_MAX_POPULATE_DEPTH)
     };
     nuxt.options.runtimeConfig.eponymeContent = eponymeContent;
+    nuxt.options.runtimeConfig.eponymeCdn = resolveCdnOptions(options.cdn, logger);
     const locale = resolveEponymeLocale(options.locale, pc.red("[Eponyme]"));
     if (locale.missing.length) {
       logger.warn(
@@ -416,10 +449,18 @@ Note that '~/' points at ${nuxt.options.srcDir}, so a server module needs '~~/'.
       { name: "field", from: resolver.resolve("./runtime/fields") },
       { name: "today", from: resolver.resolve("./runtime/fields") },
       { name: "eponymeMediaEmbedUrl", from: resolver.resolve("./runtime/utils/media-player") },
-      { name: "eponymeMediaThumbnailUrl", from: resolver.resolve("./runtime/utils/media-player") }
+      { name: "eponymeMediaThumbnailUrl", from: resolver.resolve("./runtime/utils/media-player") },
+      { name: "eponymeImageSrc", from: resolver.resolve("./runtime/utils/image-value") }
     ]);
     addImportsDir(resolver.resolve("./runtime/composables"));
     addComponent({ name: "EponymeRichText", filePath: resolver.resolve("./runtime/components/EponymeRichText") });
+    nuxt.hook("modules:done", () => {
+      const withNuxtImage = hasNuxtModule("@nuxt/image", nuxt);
+      addComponent({
+        name: "EponymeImage",
+        filePath: resolver.resolve(withNuxtImage ? "./runtime/components/image/EponymeNuxtImage.vue" : "./runtime/components/image/EponymeImage.vue")
+      });
+    });
     addServerImports([
       { name: "getEponymeSitemapEntries", from: resolver.resolve("./runtime/server/utils/eponyme-sitemap") },
       { name: "reindexEponymeEntries", from: resolver.resolve("./runtime/server/utils/eponyme-reindex") },
@@ -427,7 +468,8 @@ Note that '~/' points at ${nuxt.options.srcDir}, so a server module needs '~~/'.
       { name: "validateEponymeForm", from: resolver.resolve("./runtime/server/utils/eponyme-form") },
       { name: "storeEponymeFormSubmission", from: resolver.resolve("./runtime/server/utils/eponyme-form") },
       { name: "assertEponymeFormRateLimit", from: resolver.resolve("./runtime/server/utils/eponyme-form") },
-      { name: "getEponymeCacheTags", from: resolver.resolve("./runtime/server/utils/eponyme-cache") }
+      { name: "getEponymeCacheTags", from: resolver.resolve("./runtime/server/utils/eponyme-cache") },
+      ...["getEponymeEntry", "getEponymeSingleton", "queryEponymeCollection", "getEponymeReferrers"].map((name) => ({ name, from: resolver.resolve("./runtime/server/utils/eponyme-read") }))
     ]);
     addRouteMiddleware({
       name: "eponyme-auth",
@@ -500,6 +542,8 @@ declare module '#eponyme/storage' {
     addServerHandler({ route: "/api/eponyme-forms/**", handler: resolver.resolve("./runtime/server/api/eponyme-forms/[path].get") });
     addServerHandler({ route: "/api/eponyme-forms/**", method: "post", handler: resolver.resolve("./runtime/server/api/eponyme-forms/[path].post") });
     addServerHandler({ route: "/api/eponyme-forms/**", method: "delete", handler: resolver.resolve("./runtime/server/api/eponyme-forms/[path].delete") });
+    addServerHandler({ route: "/api/eponyme-form-export/**", handler: resolver.resolve("./runtime/server/api/eponyme-form-export/[path].get") });
+    addServerHandler({ route: "/api/eponyme-referrers/**", handler: resolver.resolve("./runtime/server/api/eponyme-referrers/[path].get") });
     addServerHandler({ route: "/api/eponyme-auth/session", handler: resolver.resolve("./runtime/server/api/eponyme-auth/session.get") });
     addServerHandler({ route: "/api/eponyme-auth/login", method: "post", handler: resolver.resolve("./runtime/server/api/eponyme-auth/login.post") });
     addServerHandler({ route: "/api/eponyme-auth/logout", method: "post", handler: resolver.resolve("./runtime/server/api/eponyme-auth/logout.post") });
@@ -518,10 +562,13 @@ declare module '#eponyme/storage' {
       addServerHandler({ route: "/api/eponyme-media/object", method: "put", handler: resolver.resolve("./runtime/server/api/eponyme-media/object.put") });
       addServerHandler({ route: "/api/eponyme-media/object", method: "delete", handler: resolver.resolve("./runtime/server/api/eponyme-media/object.delete") });
       addServerHandler({ route: "/api/eponyme-media/raw/**", handler: resolver.resolve("./runtime/server/api/eponyme-media/raw/[path].get") });
+      addServerHandler({ route: "/api/eponyme-media/meta", method: "get", handler: resolver.resolve("./runtime/server/api/eponyme-media/meta.get") });
+      addServerHandler({ route: "/api/eponyme-media/meta", method: "put", handler: resolver.resolve("./runtime/server/api/eponyme-media/meta.put") });
       logger.info(`Storage enabled from ${storagePath}, media library at ${dashboardPath}/media.`);
     }
     addServerPlugin(resolver.resolve("./runtime/server/plugins/eponyme-sync"));
     addServerPlugin(resolver.resolve("./runtime/server/plugins/eponyme-role-registry"));
+    if (options.cdn?.provider) addServerPlugin(resolver.resolve("./runtime/server/plugins/eponyme-cdn"));
     if (!process.env.EPONYME_CRON_SECRET) {
       logger.info(
         "Audit retention is a scheduled route: set EPONYME_CRON_SECRET and call /api/eponyme-audit/prune with it as a bearer token. Until then, audit events are kept for ever."

package/dist/runtime/components/editor/EponymeFormPage.vue

@@ -13,6 +13,7 @@ import EPButton from "../ui/EPButton.vue";
 import EPCheckbox from "../ui/EPCheckbox.vue";
 import EPDialog from "../ui/EPDialog.vue";
 import EPInputText from "../ui/EPInputText.vue";
+import EPRadioButton from "../ui/EPRadioButton.vue";
 import { EPONYME_DATE_LOCALE } from "../../utils/date-locale";
 const props = defineProps({
   name: { type: String, required: true },
@@ -22,6 +23,7 @@ const requestFetch = useRequestFetch();
 const auth = useEponymeAuth();
 const formResource = computed(() => ({ kind: "form", name: props.name }));
 const canDelete = computed(() => auth.can("submissions.delete", formResource.value));
+const canExport = computed(() => auth.can("submissions.export", formResource.value));
 const collects = computed(() => props.definition.submission.store);
 const page = ref(1);
 const search = ref("");
@@ -33,6 +35,22 @@ const submissionAction = ref();
 const submissionActionPending = ref(false);
 const submissionActionError = ref("");
 const label = computed(() => props.definition.label || humanizeLabel(props.name.split("/").at(-1) || props.name));
+const exportOpen = ref(false);
+const exportFrom = ref("");
+const exportTo = ref("");
+const exportFormat = ref("csv");
+const exportFormats = [
+  { label: t("submissions.exportCsv"), value: "csv" },
+  { label: t("submissions.exportJson"), value: "json" }
+];
+const exportRangeInvalid = computed(() => Boolean(exportFrom.value && exportTo.value && exportFrom.value > exportTo.value));
+const exportUrl = computed(() => {
+  const query = new URLSearchParams({ format: exportFormat.value });
+  if (exportFrom.value) query.set("from", exportFrom.value);
+  if (exportTo.value) query.set("to", exportTo.value);
+  if (debouncedSearch.value.trim()) query.set("search", debouncedSearch.value.trim());
+  return `/api/eponyme-form-export/${props.name}?${query}`;
+});
 const hasSubmissions = ref(false);
 const { data: response, pending, refresh } = useAsyncData(
   () => `eponyme:form:${props.name}`,
@@ -223,6 +241,14 @@ async function confirmSubmissionAction() {
         <EPBadge :variant="collects ? 'managed' : 'neutral'">
           {{ t(definition.submission.mode === "managed" ? "submissions.modeManaged" : "submissions.modeCustom") }}
         </EPBadge>
+        <EPButton
+          v-if="collects && canExport && (hasSubmissions || total > 0)"
+          size="sm"
+          icon="mingcute:download-2-line"
+          @click="exportOpen = true"
+        >
+          {{ t("submissions.export") }}
+        </EPButton>
         <EPButton
           v-if="collects && canDelete && total > 0"
           size="sm"
@@ -447,6 +473,74 @@ async function confirmSubmissionAction() {
       </dl>
     </EPDialog>
 
+    <EPDialog
+      :open="exportOpen"
+      :title="t('submissions.exportTitle')"
+      :description="t('submissions.exportDescription')"
+      @update:open="(value) => exportOpen = value"
+    >
+      <form
+        class="ep:grid ep:gap-4"
+        @submit.prevent
+      >
+        <div class="ep:grid ep:gap-3 ep:sm:grid-cols-2">
+          <label class="ep:grid ep:gap-1 ep:text-xs ep:font-medium ep:text-text-muted">
+            {{ t("submissions.exportFrom") }}
+            <EPInputText
+              v-model="exportFrom"
+              type="date"
+              size="sm"
+            />
+          </label>
+          <label class="ep:grid ep:gap-1 ep:text-xs ep:font-medium ep:text-text-muted">
+            {{ t("submissions.exportTo") }}
+            <EPInputText
+              v-model="exportTo"
+              type="date"
+              size="sm"
+              :invalid="exportRangeInvalid"
+            />
+          </label>
+        </div>
+        <fieldset class="ep:m-0 ep:grid ep:gap-2 ep:border-0 ep:p-0">
+          <legend class="ep:mb-1 ep:p-0 ep:text-xs ep:font-medium ep:text-text-muted">
+            {{ t("submissions.exportFormat") }}
+          </legend>
+          <EPRadioButton
+            v-model="exportFormat"
+            :options="exportFormats"
+          />
+        </fieldset>
+        <p
+          v-if="debouncedSearch.trim()"
+          class="ep:m-0 ep:text-xs ep:text-text-muted"
+        >
+          {{ t("submissions.exportSearch", { query: debouncedSearch.trim() }) }}
+        </p>
+        <p
+          v-if="exportRangeInvalid"
+          role="alert"
+          class="ep:m-0 ep:rounded-lg ep:bg-danger/10 ep:p-3 ep:text-sm ep:text-danger"
+        >
+          {{ t("submissions.exportInvalidRange") }}
+        </p>
+        <a
+          v-else
+          :href="exportUrl"
+          download
+          class="ep:inline-flex ep:h-10 ep:items-center ep:justify-center ep:gap-2 ep:justify-self-start ep:rounded-lg ep:border ep:border-contrast/80 ep:bg-contrast ep:px-5 ep:text-sm ep:font-medium ep:text-surface-raised ep:no-underline ep:hover:bg-text-default ep:focus-visible:outline-none ep:focus-visible:ring-2 ep:focus-visible:ring-contrast/30"
+          @click="exportOpen = false"
+        >
+          <Icon
+            name="mingcute:download-2-line"
+            size="16"
+            aria-hidden="true"
+          />
+          {{ t("submissions.exportDownload") }}
+        </a>
+      </form>
+    </EPDialog>
+
     <EPAlertDialog
       :open="Boolean(submissionAction)"
       :label="submissionAction ? t(actionCopy.title) : ''"

package/dist/runtime/components/fields/FieldRenderer.vue

@@ -7,6 +7,7 @@ import DateField from "./DateField.vue";
 import DateTimeField from "./DateTimeField.vue";
 import DurationField from "./DurationField.vue";
 import FileField from "./FileField.vue";
+import ImageField from "./ImageField.vue";
 import MediaPlayerField from "./MediaPlayerField.vue";
 import NumberField from "./NumberField.vue";
 import PhoneField from "./PhoneField.vue";
@@ -74,8 +75,9 @@ const component = computed(() => {
     case "duration":
       return DurationField;
     case "file":
-    case "image":
       return FileField;
+    case "image":
+      return ImageField;
     case "color":
       return ColorField;
     case "relation":
@@ -136,13 +138,24 @@ const specificProps = computed(() => {
     case "boolean":
       return {};
     case "file":
+      return {
+        placeholder: field.options.placeholder,
+        accept: field.options.accept,
+        maxSize: field.options.maxSize
+      };
     case "image":
       return {
         placeholder: field.options.placeholder,
         accept: field.options.accept,
         maxSize: field.options.maxSize,
-        preview: field.type === "image",
-        sources: field.type === "image" ? field.options.sources : void 0
+        sources: field.options.sources,
+        requireAlt: field.options.requireAlt,
+        caption: field.options.caption,
+        focal: field.options.focal ?? true,
+        // A definition written by hand, without `field.image()`, has no normalised list.
+        crops: (field.options.crops ?? []).map((crop) => typeof crop === "object" ? crop : { ratio: crop }),
+        minWidth: field.options.minWidth,
+        minHeight: field.options.minHeight
       };
     case "color":
       return { presets: field.options.presets, allowCustom: field.options.allowCustom };

package/dist/runtime/components/fields/ImageField.d.vue.ts

@@ -0,0 +1,27 @@
+import type { EponymeImageCrop, EponymeImageValue, ImageSource } from '../../types/field.js';
+type __VLS_Props = {
+    id: string;
+    modelValue?: unknown;
+    label: string;
+    description?: string;
+    required?: boolean;
+    placeholder?: string;
+    accept?: string[];
+    maxSize?: number;
+    sources?: readonly ImageSource[];
+    requireAlt?: boolean;
+    caption?: boolean;
+    focal?: boolean;
+    crops?: readonly EponymeImageCrop[];
+    minWidth?: number;
+    minHeight?: number;
+    errors?: string[];
+    disabled?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: EponymeImageValue | null) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: EponymeImageValue | null) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;