@karibsen/eponyme 0.1.0 → 0.2.0

package/README.md

@@ -15,11 +15,13 @@ Define your content in `eponyme.config.ts`. Eponyme provides defaults, validatio
 - Declarative defaults and validation
 - Conditional fields, character counters, and sortable arrays
 - Private drafts with explicit publishing
-- Collections for articles, pages, and other repeatable content
+- Collections for articles, pages, and other repeatable content, with sorting, limiting and pagination
 - Public forms with typed schemas, server-side validation, and stored submissions
+- Content variables such as `{{ currentYear }}`, resolved when the page is served
 - Persistent version history with dashboard restoration
 - Draft previews for configured public routes
 - A general sitemap metadata endpoint for configured public routes
+- Content export and import between environments, guarded by a schema fingerprint
 - A generated dashboard at `/__eponyme`
 - Server sessions with `owner`, `editor`, and `viewer` roles
 - PostgreSQL and Prisma persistence using JSONB
@@ -46,7 +48,7 @@ Add it to `nuxt.config.ts`:
 export default defineNuxtConfig({
   modules: ['@karibsen/eponyme'],
   eponyme: {
-    prismaClient: '~/server/utils/prisma',
+    prismaClient: '~~/server/utils/prisma',
     dashboardPath: '/__eponyme',
     previewPaths: {
       homepage: '/',
@@ -89,6 +91,7 @@ export default defineEponymeConfig({
         href: '/contact',
         type: 'internal',
         openInNewTab: false,
+        download: false,
       },
     }),
     published: field.boolean({
@@ -153,7 +156,10 @@ field.string({
 
 Eponyme uses the Prisma client owned by your application. It does not create the connection or run migrations.
 
-Export an initialized client from the path configured in `nuxt.config.ts`:
+Export an initialized client from the path configured in `nuxt.config.ts`. Note the
+double tilde: `~~/` points at the project root, where `server/` lives, while `~/` points
+at the source directory (`app/` in Nuxt 4). A relative path such as
+`./server/utils/prisma` works too.
 
 ```ts
 // server/utils/prisma.ts
@@ -168,12 +174,14 @@ Add the required models to your Prisma schema:
 
 ```prisma
 model Eponyme {
-  name      String   @id
-  data      Json     @db.JsonB
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+  name      String    @id
+  data      Json      @db.JsonB
+  createdAt DateTime  @default(now())
+  updatedAt DateTime  @updatedAt
+  deletedAt DateTime?
   versions  EponymeVersion[]
 
+  @@index([deletedAt])
   @@map("eponyme_entries")
 }
 
@@ -238,6 +246,9 @@ model EponymeFormSubmission {
 
 Run the migration with the workflow used by your application.
 
+Upgrading from 0.1.1 requires one migration: `Eponyme.deletedAt`, which backs the trash.
+Deleting a collection entry no longer destroys it.
+
 The playground includes the same models in `playground/prisma/schema.prisma`. Copy `playground/.env.example` to `playground/.env`, set `DATABASE_URL`, then run:
 
 ```bash
@@ -312,6 +323,58 @@ GET /api/eponyme-collections/articles
 
 It returns published entries by default. Pass `version=draft` from an authenticated request to read dashboard content.
 
+### Sorting and limiting
+
+Collections accept `take`, `skip`, `orderBy` and `order`:
+
+```ts
+const { entries, total } = useEponymeCollection('articles', {
+  orderBy: 'date',
+  order: 'desc',
+  take: 4,
+})
+```
+
+`orderBy` accepts the `updatedAt`, `publishedAt`, `title` and `slug` metadata as well
+as **any field of the collection**, which is what lets articles be ordered by their own
+date rather than by when they were last edited. The key is typed from the schema, so a
+misspelled field fails to compile.
+
+`total` counts every matching entry *before* `take` and `skip`, so it can drive a pager.
+Sorting runs after unpublished entries are filtered out, meaning a limit never spends a
+slot on an entry that would have been dropped. Entries with a missing or empty value sort
+last in both directions. The default order remains `updatedAt` descending.
+
+The same options work over HTTP, where the response is `{ entries, total }`:
+
+```http
+GET /api/eponyme-collections/articles?orderBy=date&order=desc&take=4
+```
+
+`take` is capped at 200, and an unknown `orderBy` answers `400` with the accepted keys
+rather than returning an arbitrary order.
+
+### Trash
+
+Deleting a collection entry moves it to a trash rather than destroying it. The entry
+disappears from the dashboard, from the public API and from the sitemap, but its content
+and its whole version history are kept, so it can be brought back.
+
+The collection page lists the trash behind a **Trash** button and offers **Restore** and
+**Delete for good**. Restoring is available to editors and owners; deleting for good is
+reserved to owners, since it is the only irreversible content operation — the entry's
+history goes with it.
+
+```http
+GET    /api/eponyme-trash/articles                 # trashed entries of a collection
+PATCH  /api/eponyme-trash/articles/my-article      # restore
+DELETE /api/eponyme-trash/articles/my-article      # delete for good, owner only
+```
+
+A trashed entry keeps its row, so it keeps its slug. Creating an entry with that slug is
+refused with a message pointing at the trash rather than silently overwriting what is
+waiting there. Restore the entry or delete it for good to free its slug.
+
 ## Entries
 
 `useEponyme()` is auto-imported and infers its data from `eponyme.config.ts`:
@@ -345,6 +408,67 @@ The dashboard uses explicit saves. `Ctrl+S` or `Cmd+S` stores a draft. Publish r
 
 The `errors` ref contains field errors returned with HTTP `422`. Eponyme creates missing singleton rows from configured defaults. It also reconciles stored JSONB data when fields are added or removed from the schema.
 
+### Export and import
+
+The dashboard overview at `/__eponyme` carries **Export** and **Import**, so content
+prepared on one environment can be moved to another instead of being retyped.
+
+Export downloads a JSON file holding every singleton and every live collection entry
+with its complete state — draft, published version, status and publication date — plus a
+fingerprint of the schema each entry was written against. The trash, form submissions and
+users are never part of it.
+
+Import applies that file on top of the current content: each entry it carries overwrites
+its counterpart, entries it does not mention are left untouched, and nothing is ever
+deleted. Before the first write, the fingerprints are compared with the local
+configuration; a single divergence refuses the whole file and names what diverged, so an
+import can never land half of its entries into a schema that no longer matches. The
+dashboard first runs the import as a dry run and shows what it would create, overwrite
+and skip. An entry whose slug waits in the trash is skipped rather than resurrected.
+
+Every imported entry is written to the version history, so an import stays reversible
+entry by entry from the timeline.
+
+```http
+GET  /api/eponyme-export             # editors and owners
+POST /api/eponyme-import             # owners only
+POST /api/eponyme-import?dryRun=1    # report the counts without writing
+```
+
+## Content variables
+
+Editors can drop `{{ currentYear }}` into any text or rich-text field. Variables are
+resolved when the page is served, so a year stays current without anyone re-saving the
+content.
+
+The built-ins cover dates: `currentYear`, `nextYear`, `previousYear`, `currentMonth`,
+`currentDay`, `today` and `currentDate`.
+
+Add your own in `eponyme.variables.ts` at the project root:
+
+```ts
+export default defineEponymeVariables({
+  clubName: 'AS Chelles Athlétisme',
+  season: {
+    label: 'Season',
+    description: 'The season spanning two calendar years.',
+    value: () => `${new Date().getFullYear()}-${new Date().getFullYear() + 1}`,
+  },
+})
+```
+
+A plain value is fixed; a function is called on every read. Declaring a name that
+matches a built-in overrides it. The rich text editor lists every variable behind a
+toolbar button, with a preview of what it currently resolves to.
+
+**Names only, never expressions.** `{{ currentYear }}` works, `{{ new Date().getFullYear() }}`
+is left as-is. Content comes from the database and is editable from the dashboard, so
+evaluating it would grant arbitrary code execution on the server. An unknown name is also
+left untouched, so a typo is visible on the page instead of silently deleting text.
+
+The dashboard reads content with `?raw=1` and therefore shows the source form, keeping
+variables editable. Public reads receive the resolved values.
+
 ## Preview
 
 Map a configured entry to its public route:
@@ -352,7 +476,7 @@ Map a configured entry to its public route:
 ```ts
 export default defineNuxtConfig({
   eponyme: {
-    prismaClient: '~/server/utils/prisma',
+    prismaClient: '~~/server/utils/prisma',
     previewPaths: {
       'homepage': '/',
       'pages/contact': '/contact',
@@ -391,7 +515,7 @@ Singleton entries use their exact `previewPaths` value. Collections use a dynami
 ```ts
 export default defineNuxtConfig({
   eponyme: {
-    prismaClient: '~/server/utils/prisma',
+    prismaClient: '~~/server/utils/prisma',
     previewPaths: {
       homepage: '/',
       articles: '/articles/:slug',
@@ -544,17 +668,75 @@ Two protections apply to the public submission route:
 - a **body size limit**, 64 KB by default, configurable with `maxBodyBytes`. An oversized
   body is refused with `413` before it is parsed.
 
-Rate limiting, CAPTCHA support and file uploads are not implemented yet.
+A captcha is not part of the module. A public form is a normal POST route, so adding
+Turnstile, hCaptcha or anything else is done in the host application: render the widget
+on the page, send its token, and verify it in your own handler before calling
+`validateEponymeForm()`.
+
+Rate limiting and file uploads are not implemented yet.
+
+## Hooks
+
+Eponyme emits Nitro hooks around every content write and form submission. Listen to
+them from a server plugin:
+
+```ts
+// server/plugins/eponyme.ts
+export default defineNitroPlugin((nitroApp) => {
+  nitroApp.hooks.hook('eponyme:entry:published', async ({ name, collection, data }) => {
+    await purgeCdnCache(collection ? `/${collection.name}/${collection.slug}` : `/${name}`)
+  })
+
+  nitroApp.hooks.hook('eponyme:form:submitted', async ({ form, data, id }) => {
+    if (form === 'contact') await sendEmail(data)
+  })
+})
+```
+
+| Hook | When |
+|---|---|
+| `eponyme:entry:beforeSave` | Before a draft save or a publication |
+| `eponyme:entry:saved` | After a draft save |
+| `eponyme:entry:published` | After a publication |
+| `eponyme:entry:restored` | After a history version was restored |
+| `eponyme:entry:trashed` | After a collection entry was moved to the trash |
+| `eponyme:entry:untrashed` | After a collection entry was taken back out of the trash |
+| `eponyme:entry:purged` | After a collection entry and its history were deleted for good |
+| `eponyme:form:beforeSubmit` | Before a managed submission is stored |
+| `eponyme:form:submitted` | After a managed submission was stored |
+
+The `before` hooks can **reject or amend** the operation. Throwing rejects it with a
+`422` carrying your message, which is the way to enforce a rule the schema cannot
+express. Mutating `context.data` changes what gets written:
+
+```ts
+nitroApp.hooks.hook('eponyme:entry:beforeSave', ({ data, collection }) => {
+  if (collection?.name === 'articles' && !data.excerpt) throw new Error('An excerpt is required.')
+  data.updatedBy = 'automation'
+})
+```
+
+`eponyme:form:beforeSubmit` runs **after** validation, so a listener never sees a
+payload the schema would have rejected.
+
+The other hooks are notifications: the write already happened, so a listener that
+throws is logged and swallowed. A failing webhook must not report a successful save as
+an error the editor cannot act on.
+
+Entries belonging to a collection carry `collection: { name, slug }`, so a listener can
+branch without re-parsing the entry name. The three trash hooks only ever concern
+collection entries, so their `collection` is always present; they carry no content, since
+a trash move leaves the entry itself untouched.
 
 ## Current status
 
-Eponyme is at version `0.1.0`. It is ready for controlled projects and production pilots. A few workflows still need hardening before a broad public release:
+Eponyme is at version `0.1.1`. It is ready for controlled projects and production pilots. A few workflows still need hardening before a broad public release:
 
-- Dynamic preview routes for collection entries
-- Reliable preview version switching and cache invalidation
-- Client revision tokens for long-running concurrent edits
-- Recoverable deletion
-- Public form submissions
+- Client revision tokens for long-running concurrent edits: the current `updatedAt` check protects overlapping writes within one request, not two editors who loaded the same older revision. A deletion is not guarded by a revision either
+- Retention controls for the trash: entries stay there until someone empties it
+- Rate limiting and file uploads for public forms
+- Filtering, export and retention controls for stored submissions
+- Pagination or a sitemap index beyond 50,000 URLs
 
 ## Development
 

package/dist/eponyme.d.mts

@@ -1,5 +1,6 @@
 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, EmailFieldDefinition, EmailFieldOptions, EponymeAuthSession, EponymeAuthUser, EponymeCollectionDataByName, EponymeCollectionDefinition, EponymeCollectionDefinitionBase, EponymeCollectionName, EponymeCollectionOptions, EponymeConfig, EponymeData, EponymeDataByName, EponymeFormDataByName, EponymeFormDefinition, EponymeFormDefinitionBase, EponymeFormFieldDefinition, EponymeFormMode, EponymeFormName, EponymeFormOptions, EponymeFormSchema, EponymeManagedUserResult, EponymeName, EponymeRole, EponymeSchema, FieldDefinition, FieldValidationResult, FieldValidator, FieldVisibilityCondition, ImageFieldDefinition, ImageFieldOptions, 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, EmailFieldDefinition, EmailFieldOptions, EponymeAuthSession, EponymeAuthUser, EponymeCollectionDataByName, EponymeCollectionDefinition, EponymeCollectionDefinitionBase, EponymeCollectionName, EponymeCollectionOptions, EponymeConfig, EponymeData, EponymeDataByName, EponymeFormDataByName, EponymeFormDefinition, EponymeFormDefinitionBase, EponymeFormFieldDefinition, EponymeFormMode, EponymeFormName, EponymeFormOptions, EponymeFormSchema, EponymeManagedUserResult, EponymeName, EponymeRole, EponymeSchema, EponymeVariableDefinition, EponymeVariableSummary, EponymeVariableValue, EponymeVariables, FieldDefinition, FieldValidationResult, FieldValidator, FieldVisibilityCondition, ImageFieldDefinition, ImageFieldOptions, 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, today } from '../dist/runtime/fields/index.js';
 export { EPONYME_ROLES, canEditEponyme, isEponymeRole } from '../dist/runtime/types/auth.js';
 
@@ -12,4 +13,23 @@ declare function collection<const T extends EponymeSchema>(options: CollectionOp
 
 declare function form<const T extends EponymeFormSchema>(options: EponymeFormOptions<T>): EponymeFormDefinition<T>;
 
-export { collection, defineEponymeConfig, form };
+/**
+ * Declares the variables editors can drop into rich text with `{{ name }}`.
+ * Place them in `eponyme.variables.ts` at the project root:
+ *
+ * ```ts
+ * export default defineEponymeVariables({
+ *   clubName: 'AS Chelles Athlétisme',
+ *   season: {
+ *     label: 'Season',
+ *     value: () => `${new Date().getFullYear()}-${new Date().getFullYear() + 1}`,
+ *   },
+ * })
+ * ```
+ *
+ * A function is called on every read, so the value stays current without anyone
+ * re-saving the content.
+ */
+declare function defineEponymeVariables<const T extends EponymeVariables>(variables: T): T;
+
+export { collection, defineEponymeConfig, defineEponymeVariables, form };

package/dist/eponyme.mjs

@@ -35,4 +35,8 @@ function form(options) {
   };
 }
 
-export { collection, defineEponymeConfig, form };
+function defineEponymeVariables(variables) {
+  return variables;
+}
+
+export { collection, defineEponymeConfig, defineEponymeVariables, form };

package/dist/module.d.mts

@@ -1,8 +1,9 @@
 import * as _nuxt_schema from '@nuxt/schema';
-export { collection, defineEponymeConfig, form } from './eponyme.mjs';
+export { collection, defineEponymeConfig, defineEponymeVariables, form } from './eponyme.mjs';
 export { field, today } from '../dist/runtime/fields/index.js';
 export { EPONYME_ROLES, canEditEponyme, isEponymeRole } from '../dist/runtime/types/auth.js';
-export { ArrayFieldDefinition, ArrayFieldOptions, ArrayItemDefinition, ArrayItemFieldDefinition, ArrayItemSchema, ArrayItemValue, BooleanFieldDefinition, BooleanFieldOptions, CheckboxGroupFieldDefinition, CheckboxGroupFieldOptions, CollectionSlugField, ColorFieldDefinition, ColorFieldOptions, DateFieldDefinition, DateFieldOptions, EmailFieldDefinition, EmailFieldOptions, EponymeAuthSession, EponymeAuthUser, EponymeCollectionDataByName, EponymeCollectionDefinition, EponymeCollectionDefinitionBase, EponymeCollectionName, EponymeCollectionOptions, EponymeConfig, EponymeData, EponymeDataByName, EponymeFormDataByName, EponymeFormDefinition, EponymeFormDefinitionBase, EponymeFormFieldDefinition, EponymeFormMode, EponymeFormName, EponymeFormOptions, EponymeFormSchema, EponymeManagedUserResult, EponymeName, EponymeRole, EponymeSchema, FieldDefinition, FieldValidationResult, FieldValidator, FieldVisibilityCondition, ImageFieldDefinition, ImageFieldOptions, 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, EmailFieldDefinition, EmailFieldOptions, EponymeAuthSession, EponymeAuthUser, EponymeCollectionDataByName, EponymeCollectionDefinition, EponymeCollectionDefinitionBase, EponymeCollectionName, EponymeCollectionOptions, EponymeConfig, EponymeData, EponymeDataByName, EponymeFormDataByName, EponymeFormDefinition, EponymeFormDefinitionBase, EponymeFormFieldDefinition, EponymeFormMode, EponymeFormName, EponymeFormOptions, EponymeFormSchema, EponymeManagedUserResult, EponymeName, EponymeRole, EponymeSchema, EponymeVariableDefinition, EponymeVariableSummary, EponymeVariableValue, EponymeVariables, FieldDefinition, FieldValidationResult, FieldValidator, FieldVisibilityCondition, ImageFieldDefinition, ImageFieldOptions, 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 '../dist/runtime/types/variables.js';
 
 interface ModuleOptions {
     dashboardPath?: string;

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@karibsen/eponyme",
   "configKey": "eponyme",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -1,4 +1,4 @@
-import { defineNuxtModule, useLogger, createResolver, installModule, findPath, addImports, addImportsDir, addServerImports, addRouteMiddleware, addTypeTemplate, addServerHandler, addServerPlugin } from '@nuxt/kit';
+import { defineNuxtModule, useLogger, createResolver, findPath, addImports, addImportsDir, addServerImports, addRouteMiddleware, addTypeTemplate, addServerHandler, addServerPlugin } from '@nuxt/kit';
 import pc from 'picocolors';
 import tailwindcss from '@tailwindcss/vite';
 import { resolve } from 'node:path';
@@ -17,6 +17,46 @@ const module$1 = defineNuxtModule({
       sessionDurationDays: 7
     }
   },
+  moduleDependencies: {
+    "@nuxt/icon": {
+      overrides: {
+        serverBundle: { collections: ["mingcute"] },
+        clientBundle: {
+          icons: [
+            "mingcute:history-anticlockwise-line",
+            "mingcute:eye-2-line",
+            "mingcute:layout-leftbar-close-line",
+            "mingcute:layout-leftbar-open-line",
+            "mingcute:down-small-line",
+            "mingcute:search-line",
+            "mingcute:close-line",
+            "mingcute:arrow-right-line",
+            "mingcute:align-arrow-right-line",
+            "mingcute:link-2-line",
+            "mingcute:settings-3-line",
+            "mingcute:code-line",
+            "mingcute:refresh-2-line",
+            "mingcute:external-link-line",
+            "mingcute:paragraph-line",
+            "mingcute:heading-2-line",
+            "mingcute:heading-3-line",
+            "mingcute:bold-line",
+            "mingcute:italic-line",
+            "mingcute:strikethrough-line",
+            "mingcute:link-line",
+            "mingcute:pic-line",
+            "mingcute:list-check-line",
+            "mingcute:list-ordered-line",
+            "mingcute:quote-left-line",
+            "mingcute:back-2-line",
+            "mingcute:forward-2-line",
+            "mingcute:download-2-line",
+            "mingcute:upload-2-line"
+          ]
+        }
+      }
+    }
+  },
   async setup(options, nuxt) {
     const logger = useLogger("eponyme");
     const resolver = createResolver(import.meta.url);
@@ -30,53 +70,26 @@ const module$1 = defineNuxtModule({
     nuxt.options.runtimeConfig.eponymeAuth = {
       sessionDurationDays: options.auth?.sessionDurationDays ?? 7
     };
-    await installModule("@nuxt/icon", {
-      serverBundle: { collections: ["mingcute"] },
-      clientBundle: {
-        // Explicit list: an icon missing here is not bundled and renders blank in production.
-        icons: [
-          "mingcute:history-anticlockwise-line",
-          "mingcute:eye-2-line",
-          "mingcute:layout-leftbar-close-line",
-          "mingcute:layout-leftbar-open-line",
-          "mingcute:down-small-line",
-          "mingcute:search-line",
-          "mingcute:close-line",
-          "mingcute:arrow-right-line",
-          "mingcute:align-arrow-right-line",
-          "mingcute:link-2-line",
-          "mingcute:settings-3-line",
-          "mingcute:refresh-2-line",
-          "mingcute:external-link-line",
-          "mingcute:paragraph-line",
-          "mingcute:heading-2-line",
-          "mingcute:heading-3-line",
-          "mingcute:bold-line",
-          "mingcute:italic-line",
-          "mingcute:strikethrough-line",
-          "mingcute:link-line",
-          "mingcute:pic-line",
-          "mingcute:list-check-line",
-          "mingcute:list-ordered-line",
-          "mingcute:quote-left-line",
-          "mingcute:back-2-line",
-          "mingcute:forward-2-line"
-        ]
-      }
-    }, nuxt);
     const preparing = Boolean(nuxt.options._prepare);
     if (!options.prismaClient) {
       if (!preparing) throw new Error(`${pc.red("[Eponyme]")} eponyme.prismaClient is required.`);
       logger.info("No prismaClient configured, skipping wiring (prepare).");
       return;
     }
-    const prismaPath = await findPath(resolve(nuxt.options.rootDir, options.prismaClient));
-    if (!prismaPath)
-      throw new Error(`${pc.red("[Eponyme]")} Prisma client module not found: ${options.prismaClient}`);
+    const prismaSpecifier = options.prismaClient.replace(/^[~@]{2}\//, `${nuxt.options.rootDir}/`).replace(/^[~@]\//, `${nuxt.options.srcDir}/`);
+    const prismaPath = await findPath(resolve(nuxt.options.rootDir, prismaSpecifier));
+    if (!prismaPath) {
+      throw new Error(
+        `${pc.red("[Eponyme]")} Prisma client module not found: ${options.prismaClient}
+Expected a module exporting a PrismaClient as its default export, for example '~~/server/utils/prisma'.
+Note that '~/' points at ${nuxt.options.srcDir}, so a server module needs '~~/'.`
+      );
+    }
     addImports([
       { name: "defineEponymeConfig", from: resolver.resolve("./config/config") },
       { name: "collection", from: resolver.resolve("./config/collection") },
       { name: "form", from: resolver.resolve("./config/form") },
+      { name: "defineEponymeVariables", from: resolver.resolve("./config/variables") },
       { name: "field", from: resolver.resolve("./runtime/fields") },
       { name: "today", from: resolver.resolve("./runtime/fields") }
     ]);
@@ -96,6 +109,12 @@ const module$1 = defineNuxtModule({
       path: resolver.resolve("./runtime/middleware/eponyme-owner")
     });
     nuxt.options.build.transpile.push("reka-ui");
+    nuxt.options.vite.optimizeDeps ??= {};
+    nuxt.options.vite.optimizeDeps.include = [
+      ...nuxt.options.vite.optimizeDeps.include ?? [],
+      "slugify",
+      "sortablejs"
+    ];
     nuxt.options.css.push(resolver.resolve("./runtime/assets/dashboard.css"));
     nuxt.hook("vite:extendConfig", (viteConfig) => {
       const plugins = viteConfig.plugins;
@@ -109,23 +128,34 @@ const module$1 = defineNuxtModule({
     }
     nuxt.options.alias["#eponyme/config"] = configPath;
     nuxt.options.alias["#eponyme/prisma"] = prismaPath;
+    const variablesPath = await findPath(resolve(nuxt.options.rootDir, "eponyme.variables.ts"));
+    nuxt.options.alias["#eponyme/variables"] = variablesPath ?? resolver.resolve("./runtime/utils/empty-variables");
     addTypeTemplate({
       filename: "types/eponyme-config.d.ts",
       getContents: () => `declare module '#eponyme/config' {
   const config: typeof import(${JSON.stringify(configPath)})['default']
   export default config
 }
+declare module '#eponyme/variables' {
+  const variables: typeof import(${JSON.stringify(nuxt.options.alias["#eponyme/variables"])})['default']
+  export default variables
+}
 `
     });
     addServerHandler({ route: "/api/eponyme/**", handler: resolver.resolve("./runtime/server/api/eponyme/[name].get") });
     addServerHandler({ route: "/api/eponyme/**", method: "patch", handler: resolver.resolve("./runtime/server/api/eponyme/[name].patch") });
     addServerHandler({ route: "/api/eponyme-statuses", handler: resolver.resolve("./runtime/server/api/eponyme-statuses.get") });
     addServerHandler({ route: "/api/eponyme-sitemap", handler: resolver.resolve("./runtime/server/api/eponyme-sitemap.get") });
+    addServerHandler({ route: "/api/eponyme-export", handler: resolver.resolve("./runtime/server/api/eponyme-export.get") });
+    addServerHandler({ route: "/api/eponyme-import", method: "post", handler: resolver.resolve("./runtime/server/api/eponyme-import.post") });
     addServerHandler({ route: "/api/eponyme-history/**", handler: resolver.resolve("./runtime/server/api/eponyme-history/[path].get") });
     addServerHandler({ route: "/api/eponyme-history/**", method: "patch", handler: resolver.resolve("./runtime/server/api/eponyme-history/[path].patch") });
     addServerHandler({ route: "/api/eponyme-collections/**", handler: resolver.resolve("./runtime/server/api/eponyme-collections/[path].get") });
     addServerHandler({ route: "/api/eponyme-collections/**", method: "post", handler: resolver.resolve("./runtime/server/api/eponyme-collections/[path].post") });
     addServerHandler({ route: "/api/eponyme-collections/**", method: "delete", handler: resolver.resolve("./runtime/server/api/eponyme-collections/[path].delete") });
+    addServerHandler({ route: "/api/eponyme-trash/**", handler: resolver.resolve("./runtime/server/api/eponyme-trash/[path].get") });
+    addServerHandler({ route: "/api/eponyme-trash/**", method: "patch", handler: resolver.resolve("./runtime/server/api/eponyme-trash/[path].patch") });
+    addServerHandler({ route: "/api/eponyme-trash/**", method: "delete", handler: resolver.resolve("./runtime/server/api/eponyme-trash/[path].delete") });
     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") });
@@ -140,11 +170,11 @@ const module$1 = defineNuxtModule({
     addServerPlugin(resolver.resolve("./runtime/server/plugins/eponyme-sync"));
     nuxt.hook("pages:extend", (pages) => {
       pages.push(
-        { name: "eponyme-login", path: `${dashboardPath}/login`, file: resolver.resolve("./runtime/pages/EponymeLoginPage.vue") },
-        { name: "eponyme-change-password", path: `${dashboardPath}/change-password`, file: resolver.resolve("./runtime/pages/EponymeChangePasswordPage.vue"), meta: { middleware: ["eponyme-auth"] } },
-        { name: "eponyme-users", path: `${dashboardPath}/users`, file: resolver.resolve("./runtime/pages/EponymeUsersPage.vue"), meta: { middleware: ["eponyme-auth", "eponyme-owner"] } },
-        { name: "eponyme-index", path: dashboardPath, file: resolver.resolve("./runtime/pages/EponymeIndexPage.vue"), meta: { middleware: ["eponyme-auth"] } },
-        { name: "eponyme-detail", path: `${dashboardPath}/:eponyme(.*)*`, file: resolver.resolve("./runtime/pages/EponymeDetailPage.vue"), meta: { middleware: ["eponyme-auth"] } }
+        { name: "eponyme-login", path: `${dashboardPath}/login`, file: resolver.resolve("./runtime/pages/EponymeLoginPage.vue"), meta: { layout: false } },
+        { name: "eponyme-change-password", path: `${dashboardPath}/change-password`, file: resolver.resolve("./runtime/pages/EponymeChangePasswordPage.vue"), meta: { layout: false, middleware: ["eponyme-auth"] } },
+        { name: "eponyme-users", path: `${dashboardPath}/users`, file: resolver.resolve("./runtime/pages/EponymeUsersPage.vue"), meta: { layout: false, middleware: ["eponyme-auth", "eponyme-owner"] } },
+        { name: "eponyme-index", path: dashboardPath, file: resolver.resolve("./runtime/pages/EponymeIndexPage.vue"), meta: { layout: false, middleware: ["eponyme-auth"] } },
+        { name: "eponyme-detail", path: `${dashboardPath}/:eponyme(.*)*`, file: resolver.resolve("./runtime/pages/EponymeDetailPage.vue"), meta: { layout: false, middleware: ["eponyme-auth"] } }
       );
     });
     logger.debug(`config loaded: ${configPath}`);