@dyrected/core 2.5.55 → 2.5.58

package/dist/index.cjs

@@ -27,9 +27,33 @@ __export(index_exports, {
   canViewWorkflowDraft: () => canViewWorkflowDraft,
   createLifecycleEvent: () => createLifecycleEvent,
   createWorkflowDocument: () => createWorkflowDocument,
+  defineArrayField: () => defineArrayField,
+  defineBlock: () => defineBlock,
+  defineBlocksField: () => defineBlocksField,
+  defineBooleanField: () => defineBooleanField,
   defineCollection: () => defineCollection,
   defineConfig: () => defineConfig,
+  defineDateField: () => defineDateField,
+  defineDateTimeField: () => defineDateTimeField,
+  defineEmailField: () => defineEmailField,
+  defineField: () => defineField,
   defineGlobal: () => defineGlobal,
+  defineIconField: () => defineIconField,
+  defineImageField: () => defineImageField,
+  defineJoinField: () => defineJoinField,
+  defineJsonField: () => defineJsonField,
+  defineMultiSelectField: () => defineMultiSelectField,
+  defineNumberField: () => defineNumberField,
+  defineObjectField: () => defineObjectField,
+  defineRadioField: () => defineRadioField,
+  defineRelationshipField: () => defineRelationshipField,
+  defineRichTextField: () => defineRichTextField,
+  defineRowField: () => defineRowField,
+  defineSelectField: () => defineSelectField,
+  defineTextField: () => defineTextField,
+  defineTextareaField: () => defineTextareaField,
+  defineTimeField: () => defineTimeField,
+  defineUrlField: () => defineUrlField,
   dispatchLifecycleEvent: () => dispatchLifecycleEvent,
   dispatchPendingLifecycleEvents: () => dispatchPendingLifecycleEvents,
   executeFieldAfterRead: () => executeFieldAfterRead,
@@ -1757,6 +1781,37 @@ function defineGlobal(config) {
 function defineConfig(config) {
   return config;
 }
+function defineField(field) {
+  return field;
+}
+function defineBlock(block) {
+  return block;
+}
+function createFieldDefiner(type) {
+  return (field) => ({ ...field, type });
+}
+var defineTextField = createFieldDefiner("text");
+var defineTextareaField = createFieldDefiner("textarea");
+var defineRichTextField = createFieldDefiner("richText");
+var defineNumberField = createFieldDefiner("number");
+var defineBooleanField = createFieldDefiner("boolean");
+var defineDateField = createFieldDefiner("date");
+var defineDateTimeField = createFieldDefiner("datetime");
+var defineTimeField = createFieldDefiner("time");
+var defineSelectField = createFieldDefiner("select");
+var defineMultiSelectField = createFieldDefiner("multiSelect");
+var defineRadioField = createFieldDefiner("radio");
+var defineRelationshipField = createFieldDefiner("relationship");
+var defineArrayField = createFieldDefiner("array");
+var defineObjectField = createFieldDefiner("object");
+var defineJsonField = createFieldDefiner("json");
+var defineBlocksField = createFieldDefiner("blocks");
+var defineImageField = createFieldDefiner("image");
+var defineEmailField = createFieldDefiner("email");
+var defineUrlField = createFieldDefiner("url");
+var defineIconField = createFieldDefiner("icon");
+var defineJoinField = createFieldDefiner("join");
+var defineRowField = createFieldDefiner("row");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LIFECYCLE_EVENTS_COLLECTION,
@@ -1766,9 +1821,33 @@ function defineConfig(config) {
   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,

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, G as GlobalConfig } from './app-config-DqCipvSI.cjs';
-export { e as AccessFunction, f as AdminAuthAccessResolution, g as AdminAuthClaimMapping, h as AdminAuthMember, i as AdminAuthProvider, j as AdminAuthProviderMembersConfig, k as AdminAuthProvisioningMode, l as AdminAuthResolveAccessArgs, m as AdminAuthResolvedIdentity, n as AdminConfig, o as AdminDashboardComponentSlots, p as AdminIconName, q as ArrayField, r as BaseAdminAuthProvider, s as BaseFieldAdmin, t as BlockVariant, u as BlocksField, v as BooleanField, w as BooleanFieldAdmin, x as CharacterLimitFieldAdmin, y as CharacterLimitFieldConfig, z as CollectionAfterChangeHook, E as CollectionAfterDeleteHook, I as CollectionAfterReadHook, J as CollectionAfterTransitionHook, K as CollectionBeforeChangeHook, M as CollectionBeforeDeleteHook, N as CollectionBeforeReadHook, O as CollectionBeforeTransitionHook, Q as CollectionListComponentSlots, R as CustomAdminAuthProvider, S as DatabaseAdapter, T as DateField, U as DateTimeField, V as DynamicOptionItem, X as DynamicOptionsConfig, Y as DynamicOptionsResolver, Z as DynamicOptionsResolverArgs, _ as EmailField, $ as EmailFieldAdmin, a0 as FieldAdminHooks, a1 as FieldAdminOnChangeHook, a2 as FieldAdminOnChangeHookArgs, a3 as FieldAdminOptionsHook, a4 as FieldAdminOptionsHookArgs, a5 as FieldAdminOptionsHookResult, a6 as FieldAfterReadHook, a7 as FieldAfterReadHookArgs, a8 as FieldBase, a9 as FieldBeforeChangeHook, aa as FieldBeforeChangeHookArgs, ab as FieldHook, ac as FieldHooks, ad as FieldType, ae as FileData, af as GlobalAfterChangeHook, ag as GlobalAfterReadHook, ah as GlobalBeforeChangeHook, ai as GlobalBeforeReadHook, aj as HookFunction, ak as IconField, al as IconFieldAdmin, am as ImageField, an as ImageService, ao as JoinField, ap as JsonField, aq as LIFECYCLE_EVENT_NAMES, ar as LifecycleEventHandler, as as MultiSelectField, at as MultiSelectFieldAdmin, au as NumberField, av as OIDCAdminAuthProvider, aw as ObjectField, ax as PaginatedResult, ay as PublicAdminAuthProvider, az as RadioField, aA as RadioFieldAdmin, aB as ReadonlyDatabaseAdapter, aC as RelationshipField, aD as RichTextField, aE as RowField, aF as SelectField, aG as SelectFieldAdmin, aH as StorageAdapter, aI as TextField, aJ as TextFieldAdmin, aK as TextareaField, aL as TextareaFieldAdmin, aM as TimeField, aN as TypedField, aO as UploadConfig, aP as UrlField, aQ as UrlFieldAdmin, aR as WordLimitFieldAdmin, aS as WordLimitFieldConfig, aT as WorkflowMetadata, aU as WorkflowRole, aV as WorkflowState, aW as WorkflowTransitionContext } from './app-config-DqCipvSI.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-oU1EGHND.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-oU1EGHND.cjs';
 import 'lucide-react';
 
 type Prettify<T> = {
@@ -260,8 +260,8 @@ declare function transitionWorkflow(args: {
  * export const Posts = defineCollection({
  *   slug: 'posts',
  *   fields: [
- *     { name: 'title', type: 'text', required: true },
- *     { name: 'status', type: 'select', options: ['draft', 'published'], required: true },
+ *     defineTextField({ name: 'title', required: true }),
+ *     defineSelectField({ name: 'status', options: ['draft', 'published'], required: true }),
  *   ],
  *   hooks: {
  *     beforeChange: [({ data }) => {
@@ -313,8 +313,8 @@ declare function defineCollection<TDoc extends object>(config: CollectionConfig<
  * export const Settings = defineGlobal({
  *   slug: 'site-settings',
  *   fields: [
- *     { name: 'siteName', type: 'text', required: true },
- *     { name: 'maintenanceMode', type: 'boolean' },
+ *     defineTextField({ name: 'siteName', required: true }),
+ *     defineBooleanField({ name: 'maintenanceMode' }),
  *   ],
  *   hooks: {
  *     afterChange: [({ doc }) => {
@@ -341,5 +341,127 @@ declare function defineGlobal<TDoc extends object>(config: GlobalConfig<TDoc>):
  * server-level configuration.
  */
 declare function defineConfig(config: DyrectedConfig): DyrectedConfig;
+/**
+ * Define a single field of any type. This is an identity helper: it returns the
+ * field unchanged at runtime but preserves the exact literal type, so document
+ * shapes still infer correctly when the field is placed in a `defineCollection`
+ * or `defineGlobal` `fields` array.
+ *
+ * Use it when you want autocomplete and type-checking on a field written on its
+ * own — for example a shared field reused across collections:
+ *
+ * ```ts
+ * const slug = defineField({ name: 'slug', type: 'text', required: true, unique: true })
+ *
+ * export const Posts = defineCollection({ slug: 'posts', fields: [slug, ...] })
+ * ```
+ *
+ * For a field of a known type, prefer the dedicated helper (e.g.
+ * {@link defineTextField}) so you don't have to repeat the `type`.
+ */
+declare function defineField<const T extends Field>(field: T): T;
+/**
+ * Define a {@link Block} for use in a `blocks` field. Identity helper that
+ * preserves the block's literal type (slug + fields) so `blocks`-field values
+ * stay fully inferred.
+ *
+ * ```ts
+ * const Hero = defineBlock({
+ *   slug: 'hero',
+ *   fields: [defineTextField({ name: 'heading', required: true })],
+ * })
+ *
+ * defineBlocksField({ name: 'layout', blocks: [Hero] })
+ * ```
+ */
+declare function defineBlock<const T extends Block>(block: T): T;
+/** Define a `text` field. */
+declare const defineTextField: <const T extends Omit<TextField, "type">>(field: T) => T & {
+    type: "text";
+};
+/** Define a `textarea` field. */
+declare const defineTextareaField: <const T extends Omit<TextareaField, "type">>(field: T) => T & {
+    type: "textarea";
+};
+/** Define a `richText` field, including its editor `features` and `headingLevels`. */
+declare const defineRichTextField: <const T extends Omit<RichTextField, "type">>(field: T) => T & {
+    type: "richText";
+};
+/** Define a `number` field. */
+declare const defineNumberField: <const T extends Omit<NumberField, "type">>(field: T) => T & {
+    type: "number";
+};
+/** Define a `boolean` field. */
+declare const defineBooleanField: <const T extends Omit<BooleanField, "type">>(field: T) => T & {
+    type: "boolean";
+};
+/** Define a `date` field. */
+declare const defineDateField: <const T extends Omit<DateField, "type">>(field: T) => T & {
+    type: "date";
+};
+/** Define a `datetime` field. */
+declare const defineDateTimeField: <const T extends Omit<DateTimeField, "type">>(field: T) => T & {
+    type: "datetime";
+};
+/** Define a `time` field. */
+declare const defineTimeField: <const T extends Omit<TimeField, "type">>(field: T) => T & {
+    type: "time";
+};
+/** Define a `select` field. */
+declare const defineSelectField: <const T extends Omit<SelectField, "type">>(field: T) => T & {
+    type: "select";
+};
+/** Define a `multiSelect` field. */
+declare const defineMultiSelectField: <const T extends Omit<MultiSelectField, "type">>(field: T) => T & {
+    type: "multiSelect";
+};
+/** Define a `radio` field. */
+declare const defineRadioField: <const T extends Omit<RadioField, "type">>(field: T) => T & {
+    type: "radio";
+};
+/** Define a `relationship` field. */
+declare const defineRelationshipField: <const T extends Omit<RelationshipField, "type">>(field: T) => T & {
+    type: "relationship";
+};
+/** Define an `array` field. */
+declare const defineArrayField: <const T extends Omit<ArrayField, "type">>(field: T) => T & {
+    type: "array";
+};
+/** Define an `object` field. */
+declare const defineObjectField: <const T extends Omit<ObjectField, "type">>(field: T) => T & {
+    type: "object";
+};
+/** Define a `json` field. */
+declare const defineJsonField: <const T extends Omit<JsonField, "type">>(field: T) => T & {
+    type: "json";
+};
+/** Define a `blocks` field. */
+declare const defineBlocksField: <const T extends Omit<BlocksField, "type">>(field: T) => T & {
+    type: "blocks";
+};
+/** Define an `image` field. */
+declare const defineImageField: <const T extends Omit<ImageField, "type">>(field: T) => T & {
+    type: "image";
+};
+/** Define an `email` field. */
+declare const defineEmailField: <const T extends Omit<EmailField, "type">>(field: T) => T & {
+    type: "email";
+};
+/** Define a `url` field. */
+declare const defineUrlField: <const T extends Omit<UrlField, "type">>(field: T) => T & {
+    type: "url";
+};
+/** Define an `icon` field. */
+declare const defineIconField: <const T extends Omit<IconField, "type">>(field: T) => T & {
+    type: "icon";
+};
+/** Define a `join` field. */
+declare const defineJoinField: <const T extends Omit<JoinField, "type">>(field: T) => T & {
+    type: "join";
+};
+/** Define a layout-only `row` field. */
+declare const defineRowField: <const T extends Omit<RowField, "type">>(field: T) => T & {
+    type: "row";
+};
 
-export { AdminAuthConfig, type AuthDocFields, AuthenticatedUser, BaseDocument, Block, CollectionConfig, DyrectedConfig, Field, GlobalConfig, HookRequestContext, type InferDocShape, LIFECYCLE_EVENTS_COLLECTION, LifecycleEvent, LifecycleEventName, type Prettify, PublicAdminAuthConfig, type SortClause, type SortDirection, type SqlWhereResult, type SystemDocFields, type UploadDocFields, WORKFLOW_HISTORY_COLLECTION, type WhereClause, type WhereOperator, type WhereOperatorName, WorkflowConfig, WorkflowTransition, availableWorkflowTransitions, canViewWorkflowDraft, createLifecycleEvent, createWorkflowDocument, defineCollection, defineConfig, defineGlobal, 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, 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, G as GlobalConfig } from './app-config-DqCipvSI.js';
-export { e as AccessFunction, f as AdminAuthAccessResolution, g as AdminAuthClaimMapping, h as AdminAuthMember, i as AdminAuthProvider, j as AdminAuthProviderMembersConfig, k as AdminAuthProvisioningMode, l as AdminAuthResolveAccessArgs, m as AdminAuthResolvedIdentity, n as AdminConfig, o as AdminDashboardComponentSlots, p as AdminIconName, q as ArrayField, r as BaseAdminAuthProvider, s as BaseFieldAdmin, t as BlockVariant, u as BlocksField, v as BooleanField, w as BooleanFieldAdmin, x as CharacterLimitFieldAdmin, y as CharacterLimitFieldConfig, z as CollectionAfterChangeHook, E as CollectionAfterDeleteHook, I as CollectionAfterReadHook, J as CollectionAfterTransitionHook, K as CollectionBeforeChangeHook, M as CollectionBeforeDeleteHook, N as CollectionBeforeReadHook, O as CollectionBeforeTransitionHook, Q as CollectionListComponentSlots, R as CustomAdminAuthProvider, S as DatabaseAdapter, T as DateField, U as DateTimeField, V as DynamicOptionItem, X as DynamicOptionsConfig, Y as DynamicOptionsResolver, Z as DynamicOptionsResolverArgs, _ as EmailField, $ as EmailFieldAdmin, a0 as FieldAdminHooks, a1 as FieldAdminOnChangeHook, a2 as FieldAdminOnChangeHookArgs, a3 as FieldAdminOptionsHook, a4 as FieldAdminOptionsHookArgs, a5 as FieldAdminOptionsHookResult, a6 as FieldAfterReadHook, a7 as FieldAfterReadHookArgs, a8 as FieldBase, a9 as FieldBeforeChangeHook, aa as FieldBeforeChangeHookArgs, ab as FieldHook, ac as FieldHooks, ad as FieldType, ae as FileData, af as GlobalAfterChangeHook, ag as GlobalAfterReadHook, ah as GlobalBeforeChangeHook, ai as GlobalBeforeReadHook, aj as HookFunction, ak as IconField, al as IconFieldAdmin, am as ImageField, an as ImageService, ao as JoinField, ap as JsonField, aq as LIFECYCLE_EVENT_NAMES, ar as LifecycleEventHandler, as as MultiSelectField, at as MultiSelectFieldAdmin, au as NumberField, av as OIDCAdminAuthProvider, aw as ObjectField, ax as PaginatedResult, ay as PublicAdminAuthProvider, az as RadioField, aA as RadioFieldAdmin, aB as ReadonlyDatabaseAdapter, aC as RelationshipField, aD as RichTextField, aE as RowField, aF as SelectField, aG as SelectFieldAdmin, aH as StorageAdapter, aI as TextField, aJ as TextFieldAdmin, aK as TextareaField, aL as TextareaFieldAdmin, aM as TimeField, aN as TypedField, aO as UploadConfig, aP as UrlField, aQ as UrlFieldAdmin, aR as WordLimitFieldAdmin, aS as WordLimitFieldConfig, aT as WorkflowMetadata, aU as WorkflowRole, aV as WorkflowState, aW as WorkflowTransitionContext } from './app-config-DqCipvSI.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-oU1EGHND.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-oU1EGHND.js';
 import 'lucide-react';
 
 type Prettify<T> = {
@@ -260,8 +260,8 @@ declare function transitionWorkflow(args: {
  * export const Posts = defineCollection({
  *   slug: 'posts',
  *   fields: [
- *     { name: 'title', type: 'text', required: true },
- *     { name: 'status', type: 'select', options: ['draft', 'published'], required: true },
+ *     defineTextField({ name: 'title', required: true }),
+ *     defineSelectField({ name: 'status', options: ['draft', 'published'], required: true }),
  *   ],
  *   hooks: {
  *     beforeChange: [({ data }) => {
@@ -313,8 +313,8 @@ declare function defineCollection<TDoc extends object>(config: CollectionConfig<
  * export const Settings = defineGlobal({
  *   slug: 'site-settings',
  *   fields: [
- *     { name: 'siteName', type: 'text', required: true },
- *     { name: 'maintenanceMode', type: 'boolean' },
+ *     defineTextField({ name: 'siteName', required: true }),
+ *     defineBooleanField({ name: 'maintenanceMode' }),
  *   ],
  *   hooks: {
  *     afterChange: [({ doc }) => {
@@ -341,5 +341,127 @@ declare function defineGlobal<TDoc extends object>(config: GlobalConfig<TDoc>):
  * server-level configuration.
  */
 declare function defineConfig(config: DyrectedConfig): DyrectedConfig;
+/**
+ * Define a single field of any type. This is an identity helper: it returns the
+ * field unchanged at runtime but preserves the exact literal type, so document
+ * shapes still infer correctly when the field is placed in a `defineCollection`
+ * or `defineGlobal` `fields` array.
+ *
+ * Use it when you want autocomplete and type-checking on a field written on its
+ * own — for example a shared field reused across collections:
+ *
+ * ```ts
+ * const slug = defineField({ name: 'slug', type: 'text', required: true, unique: true })
+ *
+ * export const Posts = defineCollection({ slug: 'posts', fields: [slug, ...] })
+ * ```
+ *
+ * For a field of a known type, prefer the dedicated helper (e.g.
+ * {@link defineTextField}) so you don't have to repeat the `type`.
+ */
+declare function defineField<const T extends Field>(field: T): T;
+/**
+ * Define a {@link Block} for use in a `blocks` field. Identity helper that
+ * preserves the block's literal type (slug + fields) so `blocks`-field values
+ * stay fully inferred.
+ *
+ * ```ts
+ * const Hero = defineBlock({
+ *   slug: 'hero',
+ *   fields: [defineTextField({ name: 'heading', required: true })],
+ * })
+ *
+ * defineBlocksField({ name: 'layout', blocks: [Hero] })
+ * ```
+ */
+declare function defineBlock<const T extends Block>(block: T): T;
+/** Define a `text` field. */
+declare const defineTextField: <const T extends Omit<TextField, "type">>(field: T) => T & {
+    type: "text";
+};
+/** Define a `textarea` field. */
+declare const defineTextareaField: <const T extends Omit<TextareaField, "type">>(field: T) => T & {
+    type: "textarea";
+};
+/** Define a `richText` field, including its editor `features` and `headingLevels`. */
+declare const defineRichTextField: <const T extends Omit<RichTextField, "type">>(field: T) => T & {
+    type: "richText";
+};
+/** Define a `number` field. */
+declare const defineNumberField: <const T extends Omit<NumberField, "type">>(field: T) => T & {
+    type: "number";
+};
+/** Define a `boolean` field. */
+declare const defineBooleanField: <const T extends Omit<BooleanField, "type">>(field: T) => T & {
+    type: "boolean";
+};
+/** Define a `date` field. */
+declare const defineDateField: <const T extends Omit<DateField, "type">>(field: T) => T & {
+    type: "date";
+};
+/** Define a `datetime` field. */
+declare const defineDateTimeField: <const T extends Omit<DateTimeField, "type">>(field: T) => T & {
+    type: "datetime";
+};
+/** Define a `time` field. */
+declare const defineTimeField: <const T extends Omit<TimeField, "type">>(field: T) => T & {
+    type: "time";
+};
+/** Define a `select` field. */
+declare const defineSelectField: <const T extends Omit<SelectField, "type">>(field: T) => T & {
+    type: "select";
+};
+/** Define a `multiSelect` field. */
+declare const defineMultiSelectField: <const T extends Omit<MultiSelectField, "type">>(field: T) => T & {
+    type: "multiSelect";
+};
+/** Define a `radio` field. */
+declare const defineRadioField: <const T extends Omit<RadioField, "type">>(field: T) => T & {
+    type: "radio";
+};
+/** Define a `relationship` field. */
+declare const defineRelationshipField: <const T extends Omit<RelationshipField, "type">>(field: T) => T & {
+    type: "relationship";
+};
+/** Define an `array` field. */
+declare const defineArrayField: <const T extends Omit<ArrayField, "type">>(field: T) => T & {
+    type: "array";
+};
+/** Define an `object` field. */
+declare const defineObjectField: <const T extends Omit<ObjectField, "type">>(field: T) => T & {
+    type: "object";
+};
+/** Define a `json` field. */
+declare const defineJsonField: <const T extends Omit<JsonField, "type">>(field: T) => T & {
+    type: "json";
+};
+/** Define a `blocks` field. */
+declare const defineBlocksField: <const T extends Omit<BlocksField, "type">>(field: T) => T & {
+    type: "blocks";
+};
+/** Define an `image` field. */
+declare const defineImageField: <const T extends Omit<ImageField, "type">>(field: T) => T & {
+    type: "image";
+};
+/** Define an `email` field. */
+declare const defineEmailField: <const T extends Omit<EmailField, "type">>(field: T) => T & {
+    type: "email";
+};
+/** Define a `url` field. */
+declare const defineUrlField: <const T extends Omit<UrlField, "type">>(field: T) => T & {
+    type: "url";
+};
+/** Define an `icon` field. */
+declare const defineIconField: <const T extends Omit<IconField, "type">>(field: T) => T & {
+    type: "icon";
+};
+/** Define a `join` field. */
+declare const defineJoinField: <const T extends Omit<JoinField, "type">>(field: T) => T & {
+    type: "join";
+};
+/** Define a layout-only `row` field. */
+declare const defineRowField: <const T extends Omit<RowField, "type">>(field: T) => T & {
+    type: "row";
+};
 
-export { AdminAuthConfig, type AuthDocFields, AuthenticatedUser, BaseDocument, Block, CollectionConfig, DyrectedConfig, Field, GlobalConfig, HookRequestContext, type InferDocShape, LIFECYCLE_EVENTS_COLLECTION, LifecycleEvent, LifecycleEventName, type Prettify, PublicAdminAuthConfig, type SortClause, type SortDirection, type SqlWhereResult, type SystemDocFields, type UploadDocFields, WORKFLOW_HISTORY_COLLECTION, type WhereClause, type WhereOperator, type WhereOperatorName, WorkflowConfig, WorkflowTransition, availableWorkflowTransitions, canViewWorkflowDraft, createLifecycleEvent, createWorkflowDocument, defineCollection, defineConfig, defineGlobal, 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, 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

@@ -216,6 +216,37 @@ function defineGlobal(config) {
 function defineConfig(config) {
   return config;
 }
+function defineField(field) {
+  return field;
+}
+function defineBlock(block) {
+  return block;
+}
+function createFieldDefiner(type) {
+  return (field) => ({ ...field, type });
+}
+var defineTextField = createFieldDefiner("text");
+var defineTextareaField = createFieldDefiner("textarea");
+var defineRichTextField = createFieldDefiner("richText");
+var defineNumberField = createFieldDefiner("number");
+var defineBooleanField = createFieldDefiner("boolean");
+var defineDateField = createFieldDefiner("date");
+var defineDateTimeField = createFieldDefiner("datetime");
+var defineTimeField = createFieldDefiner("time");
+var defineSelectField = createFieldDefiner("select");
+var defineMultiSelectField = createFieldDefiner("multiSelect");
+var defineRadioField = createFieldDefiner("radio");
+var defineRelationshipField = createFieldDefiner("relationship");
+var defineArrayField = createFieldDefiner("array");
+var defineObjectField = createFieldDefiner("object");
+var defineJsonField = createFieldDefiner("json");
+var defineBlocksField = createFieldDefiner("blocks");
+var defineImageField = createFieldDefiner("image");
+var defineEmailField = createFieldDefiner("email");
+var defineUrlField = createFieldDefiner("url");
+var defineIconField = createFieldDefiner("icon");
+var defineJoinField = createFieldDefiner("join");
+var defineRowField = createFieldDefiner("row");
 export {
   LIFECYCLE_EVENTS_COLLECTION,
   LIFECYCLE_EVENT_NAMES,
@@ -224,9 +255,33 @@ export {
   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,