@dyrected/core 2.5.59 → 2.5.60

package/dist/index.cjs

@@ -50,6 +50,7 @@ __export(index_exports, {
   defineRichTextField: () => defineRichTextField,
   defineRowField: () => defineRowField,
   defineSelectField: () => defineSelectField,
+  defineTab: () => defineTab,
   defineTextField: () => defineTextField,
   defineTextareaField: () => defineTextareaField,
   defineTimeField: () => defineTimeField,
@@ -419,6 +420,7 @@ var AUDIT_COLLECTION = {
     { name: "timestamp", type: "date", label: "Timestamp", required: true },
     { name: "changes", type: "json", label: "Changes" }
   ],
+  access: { read: () => false, create: () => false, update: () => false, delete: () => false },
   admin: { hidden: true }
 };
 var WORKFLOW_HISTORY_COLLECTION_CONFIG = {
@@ -523,6 +525,12 @@ function normalizeConfig(config) {
         if (field.name === "email") {
           return {
             ...field,
+            // Email is the login identifier. Keep the integrity constraints
+            // auth relies on even when the field is explicitly redefined, so a
+            // custom `email` field can never silently drop uniqueness.
+            required: true,
+            unique: true,
+            promoted: true,
             access: {
               ...field.access || {},
               update: "!id"
@@ -532,6 +540,9 @@ function normalizeConfig(config) {
         if (field.name === "password") {
           return {
             ...field,
+            // Password is required to authenticate; enforce it regardless of
+            // how the field was declared.
+            required: true,
             admin: { ...field.admin || {} },
             access: {
               ...field.access || {},
@@ -947,6 +958,15 @@ async function executeFieldAfterRead(fields, doc, user, db) {
 }
 
 // src/utils/openapi.ts
+function getCollectionLabels(collection) {
+  return collection.labels || { singular: collection.slug, plural: collection.slug };
+}
+function getCollectionTag(collection) {
+  return `Collection: ${getCollectionLabels(collection).plural}`;
+}
+function getGlobalTag(global) {
+  return `Global: ${global.label || global.slug}`;
+}
 function generateOpenApi(config) {
   const spec = {
     openapi: "3.0.0",
@@ -978,15 +998,7 @@ function generateOpenApi(config) {
         },
         WorkflowHistoryEntry: {
           type: "object",
-          required: [
-            "collection",
-            "documentId",
-            "transition",
-            "from",
-            "to",
-            "revision",
-            "createdAt"
-          ],
+          required: ["collection", "documentId", "transition", "from", "to", "revision", "createdAt"],
           properties: {
             id: { type: "string" },
             collection: { type: "string" },
@@ -1000,6 +1012,21 @@ function generateOpenApi(config) {
             createdAt: { type: "string", format: "date-time" }
           }
         },
+        AuditEntry: {
+          type: "object",
+          required: ["collection", "operation", "timestamp"],
+          properties: {
+            id: { type: "string" },
+            collection: { type: "string" },
+            documentId: { type: "string", nullable: true },
+            operation: { type: "string" },
+            user: { type: "string", nullable: true },
+            timestamp: { type: "string", format: "date-time" },
+            changes: {
+              oneOf: [{ type: "string" }, { type: "object", additionalProperties: true }, { type: "null" }]
+            }
+          }
+        },
         Error: {
           type: "object",
           properties: {
@@ -1088,17 +1115,13 @@ function generateOpenApi(config) {
     get: {
       tags: ["Preferences"],
       summary: "Get an authenticated user preference",
-      parameters: [
-        { name: "key", in: "path", required: true, schema: { type: "string" } }
-      ],
+      parameters: [{ name: "key", in: "path", required: true, schema: { type: "string" } }],
       responses: { 200: { description: "Preference value" } }
     },
     put: {
       tags: ["Preferences"],
       summary: "Set an authenticated user preference",
-      parameters: [
-        { name: "key", in: "path", required: true, schema: { type: "string" } }
-      ],
+      parameters: [{ name: "key", in: "path", required: true, schema: { type: "string" } }],
       requestBody: {
         required: true,
         content: { "application/json": { schema: { type: "object" } } }
@@ -1129,6 +1152,39 @@ function generateOpenApi(config) {
       responses: { 200: { description: "Preview document data" } }
     }
   };
+  spec.paths["/api/audit"] = {
+    get: {
+      tags: ["Audit"],
+      summary: "Get audit entries across all readable audited collections",
+      parameters: [
+        { name: "limit", in: "query", schema: { type: "integer", default: 50, maximum: 100 } },
+        { name: "page", in: "query", schema: { type: "integer", default: 1 } },
+        { name: "where", in: "query", schema: { type: "string" }, description: "JSON filter" },
+        { name: "sort", in: "query", schema: { type: "string", default: "-timestamp" } }
+      ],
+      responses: {
+        200: {
+          description: "Audit entries",
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  docs: {
+                    type: "array",
+                    items: { $ref: "#/components/schemas/AuditEntry" }
+                  },
+                  total: { type: "integer" },
+                  limit: { type: "integer" },
+                  page: { type: "integer" }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  };
   for (const collection of config.collections) {
     spec.components.schemas[collection.slug] = collectionToSchema(collection);
   }
@@ -1138,10 +1194,11 @@ function generateOpenApi(config) {
   for (const collection of config.collections) {
     const slug = collection.slug;
     const path = `/api/collections/${slug}`;
-    const labels = collection.labels || { singular: slug, plural: `${slug}s` };
+    const labels = getCollectionLabels(collection);
+    const collectionTag = getCollectionTag(collection);
     spec.paths[path] = {
       get: {
-        tags: ["Collections"],
+        tags: [collectionTag],
         summary: `Find ${labels.plural}`,
         parameters: [
           {
@@ -1190,7 +1247,7 @@ function generateOpenApi(config) {
         }
       },
       post: {
-        tags: ["Collections"],
+        tags: [collectionTag],
         summary: `Create ${labels.singular}`,
         requestBody: {
           required: true,
@@ -1214,7 +1271,7 @@ function generateOpenApi(config) {
     };
     spec.paths[`${path}/{id}`] = {
       get: {
-        tags: ["Collections"],
+        tags: [collectionTag],
         summary: `Get a single ${labels.singular}`,
         parameters: [
           {
@@ -1236,7 +1293,7 @@ function generateOpenApi(config) {
         }
       },
       patch: {
-        tags: ["Collections"],
+        tags: [collectionTag],
         summary: `Update ${labels.singular}`,
         parameters: [
           {
@@ -1266,7 +1323,7 @@ function generateOpenApi(config) {
         }
       },
       delete: {
-        tags: ["Collections"],
+        tags: [collectionTag],
         summary: `Delete ${labels.singular}`,
         parameters: [
           {
@@ -1283,7 +1340,7 @@ function generateOpenApi(config) {
     };
     spec.paths[`${path}/delete-many`] = {
       delete: {
-        tags: ["Collections"],
+        tags: [collectionTag],
         summary: `Delete multiple ${labels.plural}`,
         requestBody: {
           required: true,
@@ -1302,9 +1359,46 @@ function generateOpenApi(config) {
         responses: { 200: { description: "Deleted and failed document IDs" } }
       }
     };
+    if (collection.audit) {
+      spec.paths[`${path}/__audit`] = {
+        get: {
+          tags: [collectionTag],
+          summary: `Get ${labels.singular} audit entries`,
+          parameters: [
+            { name: "limit", in: "query", schema: { type: "integer", default: 50, maximum: 100 } },
+            { name: "page", in: "query", schema: { type: "integer", default: 1 } },
+            { name: "where", in: "query", schema: { type: "string" }, description: "JSON filter" },
+            { name: "sort", in: "query", schema: { type: "string", default: "-timestamp" } }
+          ],
+          responses: {
+            200: {
+              description: "Audit entries for this collection",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      docs: {
+                        type: "array",
+                        items: { $ref: "#/components/schemas/AuditEntry" }
+                      },
+                      total: { type: "integer" },
+                      limit: { type: "integer" },
+                      page: { type: "integer" }
+                    }
+                  }
+                }
+              }
+            },
+            403: { description: "Collection read access denied" },
+            404: { description: "Audit is not enabled for this collection" }
+          }
+        }
+      };
+    }
     spec.paths[`${path}/seed`] = {
       post: {
-        tags: ["Collections"],
+        tags: [collectionTag],
         summary: `Seed initial ${labels.plural}`,
         responses: { 200: { description: "Seeded documents" } }
       }
@@ -1312,12 +1406,12 @@ function generateOpenApi(config) {
     if (collection.upload) {
       spec.paths[`${path}/media`] = {
         get: {
-          tags: ["Media"],
+          tags: [collectionTag],
           summary: `List ${labels.plural}`,
           responses: { 200: { description: "Paginated media documents" } }
         },
         post: {
-          tags: ["Media"],
+          tags: [collectionTag],
           summary: `Upload ${labels.singular}`,
           requestBody: {
             required: true,
@@ -1336,7 +1430,7 @@ function generateOpenApi(config) {
       };
       spec.paths[`${path}/media/{filename}`] = {
         get: {
-          tags: ["Media"],
+          tags: [collectionTag],
           summary: `Serve ${labels.singular} bytes`,
           parameters: [
             {
@@ -1356,7 +1450,7 @@ function generateOpenApi(config) {
     }
     if (collection.auth) {
       const publicAuthPost = (summary) => ({
-        tags: ["Authentication"],
+        tags: [collectionTag],
         summary,
         security: [],
         requestBody: {
@@ -1398,14 +1492,14 @@ function generateOpenApi(config) {
       };
       spec.paths[`${path}/logout`] = {
         post: {
-          tags: ["Authentication"],
+          tags: [collectionTag],
           summary: `Log out of ${labels.plural}`,
           responses: { 200: { description: "Logged out" } }
         }
       };
       spec.paths[`${path}/init`] = {
         get: {
-          tags: ["Authentication"],
+          tags: [collectionTag],
           summary: `Get ${labels.plural} initialization state`,
           security: [],
           responses: { 200: { description: "Initialization state" } }
@@ -1416,14 +1510,14 @@ function generateOpenApi(config) {
       };
       spec.paths[`${path}/me`] = {
         get: {
-          tags: ["Authentication"],
+          tags: [collectionTag],
           summary: `Get the current ${labels.singular}`,
           responses: { 200: { description: "Authenticated user" } }
         }
       };
       spec.paths[`${path}/refresh-token`] = {
         post: {
-          tags: ["Authentication"],
+          tags: [collectionTag],
           summary: "Refresh an authentication token",
           responses: { 200: { description: "Refreshed token" } }
         }
@@ -1436,7 +1530,7 @@ function generateOpenApi(config) {
       };
       spec.paths[`${path}/invite`] = {
         post: {
-          tags: ["Authentication"],
+          tags: [collectionTag],
           summary: `Invite a ${labels.singular}`,
           responses: { 200: { description: "Invitation sent" } }
         }
@@ -1446,7 +1540,7 @@ function generateOpenApi(config) {
       };
       spec.paths[`${path}/{id}/change-password`] = {
         post: {
-          tags: ["Authentication"],
+          tags: [collectionTag],
           summary: `Change a ${labels.singular} password`,
           parameters: [
             {
@@ -1463,7 +1557,7 @@ function generateOpenApi(config) {
     if (collection.workflow) {
       spec.paths[`${path}/{id}/transitions/{transition}`] = {
         post: {
-          tags: ["Workflows"],
+          tags: [collectionTag],
           summary: `Transition ${labels.singular} workflow`,
           parameters: [
             {
@@ -1508,7 +1602,7 @@ function generateOpenApi(config) {
       };
       spec.paths[`${path}/{id}/workflow-history`] = {
         get: {
-          tags: ["Workflows"],
+          tags: [collectionTag],
           summary: `Get ${labels.singular} workflow history`,
           parameters: [
             {
@@ -1554,9 +1648,10 @@ function generateOpenApi(config) {
   for (const global of config.globals) {
     const slug = global.slug;
     const path = `/api/globals/${slug}`;
+    const globalTag = getGlobalTag(global);
     spec.paths[path] = {
       get: {
-        tags: ["Globals"],
+        tags: [globalTag],
         summary: `Get ${global.label || slug}`,
         responses: {
           200: {
@@ -1570,7 +1665,7 @@ function generateOpenApi(config) {
         }
       },
       patch: {
-        tags: ["Globals"],
+        tags: [globalTag],
         summary: `Update ${global.label || slug}`,
         requestBody: {
           required: true,
@@ -1594,7 +1689,7 @@ function generateOpenApi(config) {
     };
     spec.paths[`${path}/seed`] = {
       post: {
-        tags: ["Globals"],
+        tags: [globalTag],
         summary: `Seed ${global.label || slug}`,
         responses: { 200: { description: "Seeded global" } }
       }
@@ -1673,10 +1768,7 @@ function fieldToSchema(field) {
       break;
     case "url":
       schema = {
-        oneOf: [
-          { type: "string" },
-          { type: "object", additionalProperties: true }
-        ]
+        oneOf: [{ type: "string" }, { type: "object", additionalProperties: true }]
       };
       break;
     case "icon":
@@ -1812,6 +1904,12 @@ var defineUrlField = createFieldDefiner("url");
 var defineIconField = createFieldDefiner("icon");
 var defineJoinField = createFieldDefiner("join");
 var defineRowField = createFieldDefiner("row");
+function defineTab(args) {
+  return args.fields.map((field) => ({
+    ...field,
+    admin: { ...field.admin ?? {}, tab: args.label }
+  }));
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LIFECYCLE_EVENTS_COLLECTION,
@@ -1844,6 +1942,7 @@ var defineRowField = createFieldDefiner("row");
   defineRichTextField,
   defineRowField,
   defineSelectField,
+  defineTab,
   defineTextField,
   defineTextareaField,
   defineTimeField,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as Field, B as Block, D as DyrectedConfig, C as CollectionConfig, A as AdminAuthConfig, P as PublicAdminAuthConfig, W as WorkflowConfig, a as AuthenticatedUser, b as WorkflowTransition, L as LifecycleEventName, c as LifecycleEvent, d as BaseDocument, H as HookRequestContext, e as ArrayField, f as BlocksField, g as BooleanField, h as DateField, i as DateTimeField, E as EmailField, G as GlobalConfig, I as IconField, j as ImageField, J as JoinField, k as JsonField, M as MultiSelectField, N as NumberField, O as ObjectField, R as RadioField, l as RelationshipField, m as RichTextField, n as RowField, S as SelectField, T as TextField, o as TextareaField, p as TimeField, U as UrlField } from './app-config-C3X5BAyK.cjs';
-export { q as AccessFunction, r as AccessFunctionArgs, s as AccessPolicyResolver, t as AccessResult, u as AccessRule, v as AdminAuthAccessResolution, w as AdminAuthClaimMapping, x as AdminAuthMember, y as AdminAuthProvider, z as AdminAuthProviderMembersConfig, K as AdminAuthProvisioningMode, Q as AdminAuthResolveAccessArgs, V as AdminAuthResolvedIdentity, X as AdminConfig, Y as AdminDashboardComponentSlots, Z as AdminIconName, _ as BaseAdminAuthProvider, $ as BaseFieldAdmin, a0 as BlockVariant, a1 as BooleanFieldAdmin, a2 as CharacterLimitFieldAdmin, a3 as CharacterLimitFieldConfig, a4 as CollectionAfterChangeHook, a5 as CollectionAfterDeleteHook, a6 as CollectionAfterReadHook, a7 as CollectionAfterTransitionHook, a8 as CollectionBeforeChangeHook, a9 as CollectionBeforeDeleteHook, aa as CollectionBeforeReadHook, ab as CollectionBeforeTransitionHook, ac as CollectionListComponentSlots, ad as CustomAdminAuthProvider, ae as DatabaseAdapter, af as DynamicOptionItem, ag as DynamicOptionsConfig, ah as DynamicOptionsResolver, ai as DynamicOptionsResolverArgs, aj as EmailFieldAdmin, ak as FieldAdminHooks, al as FieldAdminOnChangeHook, am as FieldAdminOnChangeHookArgs, an as FieldAdminOptionsHook, ao as FieldAdminOptionsHookArgs, ap as FieldAdminOptionsHookResult, aq as FieldAfterReadHook, ar as FieldAfterReadHookArgs, as as FieldBase, at as FieldBeforeChangeHook, au as FieldBeforeChangeHookArgs, av as FieldHook, aw as FieldHooks, ax as FieldType, ay as FileData, az as GlobalAfterChangeHook, aA as GlobalAfterReadHook, aB as GlobalBeforeChangeHook, aC as GlobalBeforeReadHook, aD as HeadingLevel, aE as HookFunction, aF as IconFieldAdmin, aG as ImageService, aH as LIFECYCLE_EVENT_NAMES, aI as LifecycleEventHandler, aJ as MultiSelectFieldAdmin, aK as NamedAccessPolicy, aL as OIDCAdminAuthProvider, aM as PaginatedResult, aN as PublicAdminAuthProvider, aO as RadioFieldAdmin, aP as ReadonlyDatabaseAdapter, aQ as RichTextFeature, aR as RichTextFieldConfig, aS as SelectFieldAdmin, aT as StorageAdapter, aU as TextFieldAdmin, aV as TextareaFieldAdmin, aW as TypedField, aX as UploadConfig, aY as UrlFieldAdmin, aZ as WordLimitFieldAdmin, a_ as WordLimitFieldConfig, a$ as WorkflowMetadata, b0 as WorkflowRole, b1 as WorkflowState, b2 as WorkflowTransitionContext } from './app-config-C3X5BAyK.cjs';
+import { F as Field, B as Block, D as DyrectedConfig, C as CollectionConfig, A as AdminAuthConfig, P as PublicAdminAuthConfig, W as WorkflowConfig, a as AuthenticatedUser, b as WorkflowTransition, L as LifecycleEventName, c as LifecycleEvent, d as BaseDocument, H as HookRequestContext, e as ArrayField, f as BlocksField, g as BooleanField, h as DateField, i as DateTimeField, E as EmailField, G as GlobalConfig, I as IconField, j as ImageField, J as JoinField, k as JsonField, M as MultiSelectField, N as NumberField, O as ObjectField, R as RadioField, l as RelationshipField, m as RichTextField, n as RowField, S as SelectField, T as TextField, o as TextareaField, p as TimeField, U as UrlField } from './app-config-C0twGIaF.cjs';
+export { q as AccessFunction, r as AccessFunctionArgs, s as AccessPolicyResolver, t as AccessResult, u as AccessRule, v as AdminAuthAccessResolution, w as AdminAuthClaimMapping, x as AdminAuthMember, y as AdminAuthProvider, z as AdminAuthProviderMembersConfig, K as AdminAuthProvisioningMode, Q as AdminAuthResolveAccessArgs, V as AdminAuthResolvedIdentity, X as AdminConfig, Y as AdminDashboardComponentSlots, Z as AdminIconName, _ as BaseAdminAuthProvider, $ as BaseFieldAdmin, a0 as BlockVariant, a1 as BooleanFieldAdmin, a2 as CharacterLimitFieldAdmin, a3 as CharacterLimitFieldConfig, a4 as CollectionAfterChangeHook, a5 as CollectionAfterDeleteHook, a6 as CollectionAfterReadHook, a7 as CollectionAfterTransitionHook, a8 as CollectionBeforeChangeHook, a9 as CollectionBeforeDeleteHook, aa as CollectionBeforeReadHook, ab as CollectionBeforeTransitionHook, ac as CollectionListComponentSlots, ad as CustomAdminAuthProvider, ae as DatabaseAdapter, af as DynamicOptionItem, ag as DynamicOptionsConfig, ah as DynamicOptionsResolver, ai as DynamicOptionsResolverArgs, aj as EmailFieldAdmin, ak as FieldAdminHooks, al as FieldAdminOnChangeHook, am as FieldAdminOnChangeHookArgs, an as FieldAdminOptionsHook, ao as FieldAdminOptionsHookArgs, ap as FieldAdminOptionsHookResult, aq as FieldAfterReadHook, ar as FieldAfterReadHookArgs, as as FieldBase, at as FieldBeforeChangeHook, au as FieldBeforeChangeHookArgs, av as FieldHook, aw as FieldHooks, ax as FieldType, ay as FileData, az as GlobalAfterChangeHook, aA as GlobalAfterReadHook, aB as GlobalBeforeChangeHook, aC as GlobalBeforeReadHook, aD as HeadingLevel, aE as HookFunction, aF as IconFieldAdmin, aG as ImageService, aH as LIFECYCLE_EVENT_NAMES, aI as LifecycleEventHandler, aJ as MultiSelectFieldAdmin, aK as NamedAccessPolicy, aL as NumberFieldAdmin, aM as NumberLimitFieldAdmin, aN as NumberLimitFieldConfig, aO as OIDCAdminAuthProvider, aP as PaginatedResult, aQ as PublicAdminAuthProvider, aR as RadioFieldAdmin, aS as ReadonlyDatabaseAdapter, aT as RichTextFeature, aU as RichTextFieldConfig, aV as SelectFieldAdmin, aW as StorageAdapter, aX as TextFieldAdmin, aY as TextareaFieldAdmin, aZ as TypedField, a_ as UploadConfig, a$ as UrlFieldAdmin, b0 as UrlLinkValue, b1 as WordLimitFieldAdmin, b2 as WordLimitFieldConfig, b3 as WorkflowMetadata, b4 as WorkflowRole, b5 as WorkflowState, b6 as WorkflowTransitionContext } from './app-config-C0twGIaF.cjs';
 import 'lucide-react';
 
 type Prettify<T> = {
@@ -463,5 +463,38 @@ declare const defineJoinField: <const T extends Omit<JoinField, "type">>(field:
 declare const defineRowField: <const T extends Omit<RowField, "type">>(field: T) => T & {
     type: "row";
 };
+/**
+ * Group fields under a named tab in the Admin edit form. Tabs are presentational
+ * only: `defineTab` returns the given fields unchanged except that each one's
+ * `admin.tab` is set to `label`, and the Admin panel renders fields that share a
+ * tab name together under that tab. Spread the result into a collection, global,
+ * or group `fields` array, and add one `defineTab` call per tab. Fields left
+ * without a tab are collected into a leading tab named after the collection.
+ *
+ * ```ts
+ * defineCollection({
+ *   slug: 'pages',
+ *   fields: [
+ *     ...defineTab({
+ *       label: 'Content',
+ *       fields: [
+ *         defineTextField({ name: 'title', required: true }),
+ *         defineRichTextField({ name: 'body' }),
+ *       ],
+ *     }),
+ *     ...defineTab({
+ *       label: 'SEO',
+ *       fields: [defineTextField({ name: 'metaTitle' })],
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+declare function defineTab<const T extends readonly Field[]>(args: {
+    /** Tab name shown in the Admin edit form's tab bar. */
+    label: string;
+    /** Fields to place under this tab; each field's `admin.tab` is set to `label`. */
+    fields: T;
+}): T;
 
-export { AdminAuthConfig, ArrayField, type AuthDocFields, AuthenticatedUser, BaseDocument, Block, BlocksField, BooleanField, CollectionConfig, DateField, DateTimeField, DyrectedConfig, EmailField, Field, GlobalConfig, HookRequestContext, IconField, ImageField, type InferDocShape, JoinField, JsonField, LIFECYCLE_EVENTS_COLLECTION, LifecycleEvent, LifecycleEventName, MultiSelectField, NumberField, ObjectField, type Prettify, PublicAdminAuthConfig, RadioField, RelationshipField, RichTextField, RowField, SelectField, type SortClause, type SortDirection, type SqlWhereResult, type SystemDocFields, TextField, TextareaField, TimeField, type UploadDocFields, UrlField, WORKFLOW_HISTORY_COLLECTION, type WhereClause, type WhereOperator, type WhereOperatorName, WorkflowConfig, WorkflowTransition, availableWorkflowTransitions, canViewWorkflowDraft, createLifecycleEvent, createWorkflowDocument, defineArrayField, defineBlock, defineBlocksField, defineBooleanField, defineCollection, defineConfig, defineDateField, defineDateTimeField, defineEmailField, defineField, defineGlobal, defineIconField, defineImageField, defineJoinField, defineJsonField, defineMultiSelectField, defineNumberField, defineObjectField, defineRadioField, defineRelationshipField, defineRichTextField, defineRowField, defineSelectField, defineTextField, defineTextareaField, defineTimeField, defineUrlField, dispatchLifecycleEvent, dispatchPendingLifecycleEvents, executeFieldAfterRead, executeFieldBeforeChange, generateOpenApi, getAdminAuthCollection, getPublicAdminAuthConfig, initializeWorkflowDocument, materializeWorkflowDocument, normalizeConfig, parseMongoWhere, parseSort, parseSqlWhere, publishingWorkflow, resolveAdminAuthCollection, runCollectionHooks, saveWorkflowDraft, transitionWorkflow, workflowCapabilities };
+export { AdminAuthConfig, ArrayField, type AuthDocFields, AuthenticatedUser, BaseDocument, Block, BlocksField, BooleanField, CollectionConfig, DateField, DateTimeField, DyrectedConfig, EmailField, Field, GlobalConfig, HookRequestContext, IconField, ImageField, type InferDocShape, JoinField, JsonField, LIFECYCLE_EVENTS_COLLECTION, LifecycleEvent, LifecycleEventName, MultiSelectField, NumberField, ObjectField, type Prettify, PublicAdminAuthConfig, RadioField, RelationshipField, RichTextField, RowField, SelectField, type SortClause, type SortDirection, type SqlWhereResult, type SystemDocFields, TextField, TextareaField, TimeField, type UploadDocFields, UrlField, WORKFLOW_HISTORY_COLLECTION, type WhereClause, type WhereOperator, type WhereOperatorName, WorkflowConfig, WorkflowTransition, availableWorkflowTransitions, canViewWorkflowDraft, createLifecycleEvent, createWorkflowDocument, defineArrayField, defineBlock, defineBlocksField, defineBooleanField, defineCollection, defineConfig, defineDateField, defineDateTimeField, defineEmailField, defineField, defineGlobal, defineIconField, defineImageField, defineJoinField, defineJsonField, defineMultiSelectField, defineNumberField, defineObjectField, defineRadioField, defineRelationshipField, defineRichTextField, defineRowField, defineSelectField, defineTab, defineTextField, defineTextareaField, defineTimeField, defineUrlField, dispatchLifecycleEvent, dispatchPendingLifecycleEvents, executeFieldAfterRead, executeFieldBeforeChange, generateOpenApi, getAdminAuthCollection, getPublicAdminAuthConfig, initializeWorkflowDocument, materializeWorkflowDocument, normalizeConfig, parseMongoWhere, parseSort, parseSqlWhere, publishingWorkflow, resolveAdminAuthCollection, runCollectionHooks, saveWorkflowDraft, transitionWorkflow, workflowCapabilities };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as Field, B as Block, D as DyrectedConfig, C as CollectionConfig, A as AdminAuthConfig, P as PublicAdminAuthConfig, W as WorkflowConfig, a as AuthenticatedUser, b as WorkflowTransition, L as LifecycleEventName, c as LifecycleEvent, d as BaseDocument, H as HookRequestContext, e as ArrayField, f as BlocksField, g as BooleanField, h as DateField, i as DateTimeField, E as EmailField, G as GlobalConfig, I as IconField, j as ImageField, J as JoinField, k as JsonField, M as MultiSelectField, N as NumberField, O as ObjectField, R as RadioField, l as RelationshipField, m as RichTextField, n as RowField, S as SelectField, T as TextField, o as TextareaField, p as TimeField, U as UrlField } from './app-config-C3X5BAyK.js';
-export { q as AccessFunction, r as AccessFunctionArgs, s as AccessPolicyResolver, t as AccessResult, u as AccessRule, v as AdminAuthAccessResolution, w as AdminAuthClaimMapping, x as AdminAuthMember, y as AdminAuthProvider, z as AdminAuthProviderMembersConfig, K as AdminAuthProvisioningMode, Q as AdminAuthResolveAccessArgs, V as AdminAuthResolvedIdentity, X as AdminConfig, Y as AdminDashboardComponentSlots, Z as AdminIconName, _ as BaseAdminAuthProvider, $ as BaseFieldAdmin, a0 as BlockVariant, a1 as BooleanFieldAdmin, a2 as CharacterLimitFieldAdmin, a3 as CharacterLimitFieldConfig, a4 as CollectionAfterChangeHook, a5 as CollectionAfterDeleteHook, a6 as CollectionAfterReadHook, a7 as CollectionAfterTransitionHook, a8 as CollectionBeforeChangeHook, a9 as CollectionBeforeDeleteHook, aa as CollectionBeforeReadHook, ab as CollectionBeforeTransitionHook, ac as CollectionListComponentSlots, ad as CustomAdminAuthProvider, ae as DatabaseAdapter, af as DynamicOptionItem, ag as DynamicOptionsConfig, ah as DynamicOptionsResolver, ai as DynamicOptionsResolverArgs, aj as EmailFieldAdmin, ak as FieldAdminHooks, al as FieldAdminOnChangeHook, am as FieldAdminOnChangeHookArgs, an as FieldAdminOptionsHook, ao as FieldAdminOptionsHookArgs, ap as FieldAdminOptionsHookResult, aq as FieldAfterReadHook, ar as FieldAfterReadHookArgs, as as FieldBase, at as FieldBeforeChangeHook, au as FieldBeforeChangeHookArgs, av as FieldHook, aw as FieldHooks, ax as FieldType, ay as FileData, az as GlobalAfterChangeHook, aA as GlobalAfterReadHook, aB as GlobalBeforeChangeHook, aC as GlobalBeforeReadHook, aD as HeadingLevel, aE as HookFunction, aF as IconFieldAdmin, aG as ImageService, aH as LIFECYCLE_EVENT_NAMES, aI as LifecycleEventHandler, aJ as MultiSelectFieldAdmin, aK as NamedAccessPolicy, aL as OIDCAdminAuthProvider, aM as PaginatedResult, aN as PublicAdminAuthProvider, aO as RadioFieldAdmin, aP as ReadonlyDatabaseAdapter, aQ as RichTextFeature, aR as RichTextFieldConfig, aS as SelectFieldAdmin, aT as StorageAdapter, aU as TextFieldAdmin, aV as TextareaFieldAdmin, aW as TypedField, aX as UploadConfig, aY as UrlFieldAdmin, aZ as WordLimitFieldAdmin, a_ as WordLimitFieldConfig, a$ as WorkflowMetadata, b0 as WorkflowRole, b1 as WorkflowState, b2 as WorkflowTransitionContext } from './app-config-C3X5BAyK.js';
+import { F as Field, B as Block, D as DyrectedConfig, C as CollectionConfig, A as AdminAuthConfig, P as PublicAdminAuthConfig, W as WorkflowConfig, a as AuthenticatedUser, b as WorkflowTransition, L as LifecycleEventName, c as LifecycleEvent, d as BaseDocument, H as HookRequestContext, e as ArrayField, f as BlocksField, g as BooleanField, h as DateField, i as DateTimeField, E as EmailField, G as GlobalConfig, I as IconField, j as ImageField, J as JoinField, k as JsonField, M as MultiSelectField, N as NumberField, O as ObjectField, R as RadioField, l as RelationshipField, m as RichTextField, n as RowField, S as SelectField, T as TextField, o as TextareaField, p as TimeField, U as UrlField } from './app-config-C0twGIaF.js';
+export { q as AccessFunction, r as AccessFunctionArgs, s as AccessPolicyResolver, t as AccessResult, u as AccessRule, v as AdminAuthAccessResolution, w as AdminAuthClaimMapping, x as AdminAuthMember, y as AdminAuthProvider, z as AdminAuthProviderMembersConfig, K as AdminAuthProvisioningMode, Q as AdminAuthResolveAccessArgs, V as AdminAuthResolvedIdentity, X as AdminConfig, Y as AdminDashboardComponentSlots, Z as AdminIconName, _ as BaseAdminAuthProvider, $ as BaseFieldAdmin, a0 as BlockVariant, a1 as BooleanFieldAdmin, a2 as CharacterLimitFieldAdmin, a3 as CharacterLimitFieldConfig, a4 as CollectionAfterChangeHook, a5 as CollectionAfterDeleteHook, a6 as CollectionAfterReadHook, a7 as CollectionAfterTransitionHook, a8 as CollectionBeforeChangeHook, a9 as CollectionBeforeDeleteHook, aa as CollectionBeforeReadHook, ab as CollectionBeforeTransitionHook, ac as CollectionListComponentSlots, ad as CustomAdminAuthProvider, ae as DatabaseAdapter, af as DynamicOptionItem, ag as DynamicOptionsConfig, ah as DynamicOptionsResolver, ai as DynamicOptionsResolverArgs, aj as EmailFieldAdmin, ak as FieldAdminHooks, al as FieldAdminOnChangeHook, am as FieldAdminOnChangeHookArgs, an as FieldAdminOptionsHook, ao as FieldAdminOptionsHookArgs, ap as FieldAdminOptionsHookResult, aq as FieldAfterReadHook, ar as FieldAfterReadHookArgs, as as FieldBase, at as FieldBeforeChangeHook, au as FieldBeforeChangeHookArgs, av as FieldHook, aw as FieldHooks, ax as FieldType, ay as FileData, az as GlobalAfterChangeHook, aA as GlobalAfterReadHook, aB as GlobalBeforeChangeHook, aC as GlobalBeforeReadHook, aD as HeadingLevel, aE as HookFunction, aF as IconFieldAdmin, aG as ImageService, aH as LIFECYCLE_EVENT_NAMES, aI as LifecycleEventHandler, aJ as MultiSelectFieldAdmin, aK as NamedAccessPolicy, aL as NumberFieldAdmin, aM as NumberLimitFieldAdmin, aN as NumberLimitFieldConfig, aO as OIDCAdminAuthProvider, aP as PaginatedResult, aQ as PublicAdminAuthProvider, aR as RadioFieldAdmin, aS as ReadonlyDatabaseAdapter, aT as RichTextFeature, aU as RichTextFieldConfig, aV as SelectFieldAdmin, aW as StorageAdapter, aX as TextFieldAdmin, aY as TextareaFieldAdmin, aZ as TypedField, a_ as UploadConfig, a$ as UrlFieldAdmin, b0 as UrlLinkValue, b1 as WordLimitFieldAdmin, b2 as WordLimitFieldConfig, b3 as WorkflowMetadata, b4 as WorkflowRole, b5 as WorkflowState, b6 as WorkflowTransitionContext } from './app-config-C0twGIaF.js';
 import 'lucide-react';
 
 type Prettify<T> = {
@@ -463,5 +463,38 @@ declare const defineJoinField: <const T extends Omit<JoinField, "type">>(field:
 declare const defineRowField: <const T extends Omit<RowField, "type">>(field: T) => T & {
     type: "row";
 };
+/**
+ * Group fields under a named tab in the Admin edit form. Tabs are presentational
+ * only: `defineTab` returns the given fields unchanged except that each one's
+ * `admin.tab` is set to `label`, and the Admin panel renders fields that share a
+ * tab name together under that tab. Spread the result into a collection, global,
+ * or group `fields` array, and add one `defineTab` call per tab. Fields left
+ * without a tab are collected into a leading tab named after the collection.
+ *
+ * ```ts
+ * defineCollection({
+ *   slug: 'pages',
+ *   fields: [
+ *     ...defineTab({
+ *       label: 'Content',
+ *       fields: [
+ *         defineTextField({ name: 'title', required: true }),
+ *         defineRichTextField({ name: 'body' }),
+ *       ],
+ *     }),
+ *     ...defineTab({
+ *       label: 'SEO',
+ *       fields: [defineTextField({ name: 'metaTitle' })],
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+declare function defineTab<const T extends readonly Field[]>(args: {
+    /** Tab name shown in the Admin edit form's tab bar. */
+    label: string;
+    /** Fields to place under this tab; each field's `admin.tab` is set to `label`. */
+    fields: T;
+}): T;
 
-export { AdminAuthConfig, ArrayField, type AuthDocFields, AuthenticatedUser, BaseDocument, Block, BlocksField, BooleanField, CollectionConfig, DateField, DateTimeField, DyrectedConfig, EmailField, Field, GlobalConfig, HookRequestContext, IconField, ImageField, type InferDocShape, JoinField, JsonField, LIFECYCLE_EVENTS_COLLECTION, LifecycleEvent, LifecycleEventName, MultiSelectField, NumberField, ObjectField, type Prettify, PublicAdminAuthConfig, RadioField, RelationshipField, RichTextField, RowField, SelectField, type SortClause, type SortDirection, type SqlWhereResult, type SystemDocFields, TextField, TextareaField, TimeField, type UploadDocFields, UrlField, WORKFLOW_HISTORY_COLLECTION, type WhereClause, type WhereOperator, type WhereOperatorName, WorkflowConfig, WorkflowTransition, availableWorkflowTransitions, canViewWorkflowDraft, createLifecycleEvent, createWorkflowDocument, defineArrayField, defineBlock, defineBlocksField, defineBooleanField, defineCollection, defineConfig, defineDateField, defineDateTimeField, defineEmailField, defineField, defineGlobal, defineIconField, defineImageField, defineJoinField, defineJsonField, defineMultiSelectField, defineNumberField, defineObjectField, defineRadioField, defineRelationshipField, defineRichTextField, defineRowField, defineSelectField, defineTextField, defineTextareaField, defineTimeField, defineUrlField, dispatchLifecycleEvent, dispatchPendingLifecycleEvents, executeFieldAfterRead, executeFieldBeforeChange, generateOpenApi, getAdminAuthCollection, getPublicAdminAuthConfig, initializeWorkflowDocument, materializeWorkflowDocument, normalizeConfig, parseMongoWhere, parseSort, parseSqlWhere, publishingWorkflow, resolveAdminAuthCollection, runCollectionHooks, saveWorkflowDraft, transitionWorkflow, workflowCapabilities };
+export { AdminAuthConfig, ArrayField, type AuthDocFields, AuthenticatedUser, BaseDocument, Block, BlocksField, BooleanField, CollectionConfig, DateField, DateTimeField, DyrectedConfig, EmailField, Field, GlobalConfig, HookRequestContext, IconField, ImageField, type InferDocShape, JoinField, JsonField, LIFECYCLE_EVENTS_COLLECTION, LifecycleEvent, LifecycleEventName, MultiSelectField, NumberField, ObjectField, type Prettify, PublicAdminAuthConfig, RadioField, RelationshipField, RichTextField, RowField, SelectField, type SortClause, type SortDirection, type SqlWhereResult, type SystemDocFields, TextField, TextareaField, TimeField, type UploadDocFields, UrlField, WORKFLOW_HISTORY_COLLECTION, type WhereClause, type WhereOperator, type WhereOperatorName, WorkflowConfig, WorkflowTransition, availableWorkflowTransitions, canViewWorkflowDraft, createLifecycleEvent, createWorkflowDocument, defineArrayField, defineBlock, defineBlocksField, defineBooleanField, defineCollection, defineConfig, defineDateField, defineDateTimeField, defineEmailField, defineField, defineGlobal, defineIconField, defineImageField, defineJoinField, defineJsonField, defineMultiSelectField, defineNumberField, defineObjectField, defineRadioField, defineRelationshipField, defineRichTextField, defineRowField, defineSelectField, defineTab, defineTextField, defineTextareaField, defineTimeField, defineUrlField, dispatchLifecycleEvent, dispatchPendingLifecycleEvents, executeFieldAfterRead, executeFieldBeforeChange, generateOpenApi, getAdminAuthCollection, getPublicAdminAuthConfig, initializeWorkflowDocument, materializeWorkflowDocument, normalizeConfig, parseMongoWhere, parseSort, parseSqlWhere, publishingWorkflow, resolveAdminAuthCollection, runCollectionHooks, saveWorkflowDraft, transitionWorkflow, workflowCapabilities };

package/dist/index.js

@@ -21,7 +21,7 @@ import {
   saveWorkflowDraft,
   transitionWorkflow,
   workflowCapabilities
-} from "./chunk-L65PQYDP.js";
+} from "./chunk-2WODKOUB.js";
 
 // src/types/workflows.ts
 var LIFECYCLE_EVENT_NAMES = [
@@ -247,6 +247,12 @@ var defineUrlField = createFieldDefiner("url");
 var defineIconField = createFieldDefiner("icon");
 var defineJoinField = createFieldDefiner("join");
 var defineRowField = createFieldDefiner("row");
+function defineTab(args) {
+  return args.fields.map((field) => ({
+    ...field,
+    admin: { ...field.admin ?? {}, tab: args.label }
+  }));
+}
 export {
   LIFECYCLE_EVENTS_COLLECTION,
   LIFECYCLE_EVENT_NAMES,
@@ -278,6 +284,7 @@ export {
   defineRichTextField,
   defineRowField,
   defineSelectField,
+  defineTab,
   defineTextField,
   defineTextareaField,
   defineTimeField,