@dyrected/core 2.10.1 → 2.12.0

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, G as GlobalConfig, a as DeclarativeHookExpression, W as WorkflowConfig, b as AuthenticatedUser, c as WorkflowTransition, L as LifecycleEventName, d as LifecycleEvent, e as BaseDocument, H as HookRequestContext, f as DetailComputedOptions, g as ComputedHandler, h as DetailComputed, i as DetailCustomOptions, j as DetailCustom, k as DetailDividerOptions, l as DetailDivider, m as DisplayFieldOptions, n as DetailField, o as DetailItem, p as DetailGridOptions, q as DetailGrid, r as DetailRepeatOptions, s as DetailRepeat, t as DetailSectionOptions, u as DetailSection, v as DetailTabOptions, w as DetailTab, x as DetailTabsOptions, y as DetailTabs, z as DetailTextOptions, E as DetailText, I as DetailSchema, J as ArrayField, K as BlocksField, M as BooleanField, N as AuthConfig, O as AccessPolicyResolver, Q as DateField, R as DateTimeField, S as EmailField, T as IconField, U as ImageField, V as JoinField, X as JsonField, Y as MultiSelectField, Z as NumberField, _ as ObjectField, $ as RadioField, a0 as RelationshipField, a1 as RichTextField, a2 as RowField, a3 as SelectField, a4 as TextField, a5 as TextareaField, a6 as TimeField, a7 as UrlField } from './app-config-BLC7WoyL.cjs';
-export { a8 as AccessConfig, a9 as AccessFunction, aa as AccessFunctionArgs, ab as AccessResult, ac as AccessRule, ad as ActionConfig, ae as ActionContext, af as ActionType, ag as AdminAuthAccessResolution, ah as AdminAuthClaimMapping, ai as AdminAuthMember, aj as AdminAuthProvider, ak as AdminAuthProviderMembersConfig, al as AdminAuthProvisioningMode, am as AdminAuthResolveAccessArgs, an as AdminAuthResolvedIdentity, ao as AdminConfig, ap as AdminDashboardComponentSlots, aq as AdminIconName, ar as AggregateArgs, as as AggregateCastType, at as AggregateInput, au as AggregateOperation, av as AggregateResult, aw as BaseAdminAuthProvider, ax as BaseFieldAdmin, ay as BlockVariant, az as BooleanFieldAdmin, aA as BooleanFormat, aB as CharacterLimitFieldAdmin, aC as CharacterLimitFieldConfig, aD as CollectionAfterChangeHook, aE as CollectionAfterDeleteHook, aF as CollectionAfterReadHook, aG as CollectionAfterReadHookEntry, aH as CollectionAfterTransitionHook, aI as CollectionBeforeChangeHook, aJ as CollectionBeforeChangeHookEntry, aK as CollectionBeforeDeleteHook, aL as CollectionBeforeReadHook, aM as CollectionBeforeReadHookEntry, aN as CollectionBeforeTransitionHook, aO as CollectionListComponentSlots, aP as CollectionViewComponentSlots, aQ as CountOperation, aR as CustomAdminAuthProvider, aS as DatabaseAdapter, aT as DateFieldAdmin, aU as DateFormat, aV as DefineActionOptions, aW as DefineViewOptions, aX as DetailSpan, aY as DisplayTone, aZ as DisplayVariant, a_ as DistinctCountOperation, a$ as DistinctValuesOperation, b0 as DynamicOptionItem, b1 as DynamicOptionsConfig, b2 as DynamicOptionsResolver, b3 as DynamicOptionsResolverArgs, b4 as DyrectedLoggerConfig, b5 as DyrectedObservabilityConfig, b6 as EmailFieldAdmin, b7 as FieldAdminHooks, b8 as FieldAdminOnChangeHook, b9 as FieldAdminOnChangeHookArgs, ba as FieldAdminOptionsHook, bb as FieldAdminOptionsHookArgs, bc as FieldAdminOptionsHookResult, bd as FieldAfterReadHook, be as FieldAfterReadHookArgs, bf as FieldBase, bg as FieldBeforeChangeHook, bh as FieldBeforeChangeHookArgs, bi as FieldHook, bj as FieldHooks, bk as FieldType, bl as FileData, bm as GlobalAfterChangeHook, bn as GlobalAfterReadHook, bo as GlobalAfterReadHookEntry, bp as GlobalBeforeChangeHook, bq as GlobalBeforeChangeHookEntry, br as GlobalBeforeReadHook, bs as GlobalBeforeReadHookEntry, bt as HeadingLevel, bu as HookFunction, bv as IconFieldAdmin, bw as ImageService, bx as InferAggregateResult, by as JoinFieldAdmin, bz as JsonFieldAdmin, bA as JsonFormat, bB as LIFECYCLE_EVENT_NAMES, bC as LifecycleEventHandler, bD as LinkFormat, bE as MetricColor, bF as MultiSelectFieldAdmin, bG as NamedAccessPolicy, bH as NumberFieldAdmin, bI as NumberFormat, bJ as NumberLimitFieldAdmin, bK as NumberLimitFieldConfig, bL as NumericOperation, bM as OIDCAdminAuthProvider, bN as OptionFormat, bO as PaginatedResult, bP as PublicAdminAuthProvider, bQ as RadioFieldAdmin, bR as RateLimitConfig, bS as ReadonlyDatabaseAdapter, bT as RichTextFeature, bU as RichTextFieldConfig, bV as SelectFieldAdmin, bW as SqlWhereResult, bX as StorageAdapter, bY as TextFieldAdmin, bZ as TextFormat, b_ as TextareaFieldAdmin, b$ as TrustProxyConfig, c0 as TypedField, c1 as UploadConfig, c2 as UrlFieldAdmin, c3 as UrlLinkValue, c4 as ViewActionFeatures, c5 as ViewComponentSlots, c6 as ViewConfig, c7 as ViewLayout, c8 as ViewMetric, c9 as ViewSubMetric, ca as WhereClause, cb as WhereOperator, cc as WhereOperatorName, cd as WordLimitFieldAdmin, ce as WordLimitFieldConfig, cf as WorkflowMetadata, cg as WorkflowRole, ch as WorkflowState, ci as WorkflowTransitionContext, cj as defineAction, ck as defineView, cl as parseMongoWhere, cm as parseSqlWhere } from './app-config-BLC7WoyL.cjs';
+import { F as Field, B as Block, D as DyrectedConfig, C as CollectionConfig, A as AdminAuthConfig, P as PublicAdminAuthConfig, G as GlobalConfig, a as DeclarativeHookExpression, W as WorkflowConfig, b as AuthenticatedUser, c as WorkflowTransition, L as LifecycleEventName, d as LifecycleEvent, e as BaseDocument, H as HookRequestContext, f as DetailComputedOptions, g as ComputedHandler, h as DetailComputed, i as DetailCustomOptions, j as DetailCustom, k as DetailDividerOptions, l as DetailDivider, m as DisplayFieldOptions, n as DetailField, o as DetailItem, p as DetailGridOptions, q as DetailGrid, r as DetailRepeatOptions, s as DetailRepeat, t as DetailSectionOptions, u as DetailSection, v as DetailTabOptions, w as DetailTab, x as DetailTabsOptions, y as DetailTabs, z as DetailTextOptions, E as DetailText, I as DetailSchema, J as ArrayField, K as BlocksField, M as BooleanField, N as AuthConfig, O as AccessPolicyResolver, Q as DateField, R as DateTimeField, S as EmailField, T as IconField, U as ImageField, V as JoinField, X as JsonField, Y as MultiSelectField, Z as NumberField, _ as ObjectField, $ as RadioField, a0 as RelationshipField, a1 as RichTextField, a2 as RowField, a3 as SelectField, a4 as TextField, a5 as TextareaField, a6 as TimeField, a7 as UrlField } from './app-config-C6hYM8WO.cjs';
+export { a8 as AccessConfig, a9 as AccessFunction, aa as AccessFunctionArgs, ab as AccessResult, ac as AccessRule, ad as ActionConfig, ae as ActionContext, af as ActionType, ag as AdminAuthAccessResolution, ah as AdminAuthClaimMapping, ai as AdminAuthMember, aj as AdminAuthProvider, ak as AdminAuthProviderMembersConfig, al as AdminAuthProvisioningMode, am as AdminAuthResolveAccessArgs, an as AdminAuthResolvedIdentity, ao as AdminConfig, ap as AdminDashboardComponentSlots, aq as AdminIconName, ar as AggregateArgs, as as AggregateCastType, at as AggregateInput, au as AggregateOperation, av as AggregateResult, aw as BaseAdminAuthProvider, ax as BaseFieldAdmin, ay as BlockVariant, az as BooleanFieldAdmin, aA as BooleanFormat, aB as CharacterLimitFieldAdmin, aC as CharacterLimitFieldConfig, aD as CollectionAfterChangeHook, aE as CollectionAfterDeleteHook, aF as CollectionAfterReadHook, aG as CollectionAfterReadHookEntry, aH as CollectionAfterTransitionHook, aI as CollectionBeforeChangeHook, aJ as CollectionBeforeChangeHookEntry, aK as CollectionBeforeDeleteHook, aL as CollectionBeforeReadHook, aM as CollectionBeforeReadHookEntry, aN as CollectionBeforeTransitionHook, aO as CollectionListComponentSlots, aP as CollectionViewComponentSlots, aQ as CountOperation, aR as CustomAdminAuthProvider, aS as DatabaseAdapter, aT as DateFieldAdmin, aU as DateFormat, aV as DefineActionOptions, aW as DefineViewOptions, aX as DetailSpan, aY as DisplayTone, aZ as DisplayVariant, a_ as DistinctCountOperation, a$ as DistinctValuesOperation, b0 as DynamicOptionItem, b1 as DynamicOptionsConfig, b2 as DynamicOptionsResolver, b3 as DynamicOptionsResolverArgs, b4 as DyrectedLoggerConfig, b5 as DyrectedObservabilityConfig, b6 as EmailFieldAdmin, b7 as FieldAdminHooks, b8 as FieldAdminOnChangeHook, b9 as FieldAdminOnChangeHookArgs, ba as FieldAdminOptionsHook, bb as FieldAdminOptionsHookArgs, bc as FieldAdminOptionsHookResult, bd as FieldAfterReadHook, be as FieldAfterReadHookArgs, bf as FieldBase, bg as FieldBeforeChangeHook, bh as FieldBeforeChangeHookArgs, bi as FieldHook, bj as FieldHooks, bk as FieldType, bl as FileData, bm as GlobalAfterChangeHook, bn as GlobalAfterReadHook, bo as GlobalAfterReadHookEntry, bp as GlobalBeforeChangeHook, bq as GlobalBeforeChangeHookEntry, br as GlobalBeforeReadHook, bs as GlobalBeforeReadHookEntry, bt as HeadingLevel, bu as HookFunction, bv as IconFieldAdmin, bw as ImageService, bx as ImageTransformOptions, by as InferAggregateResult, bz as JoinFieldAdmin, bA as JsonFieldAdmin, bB as JsonFormat, bC as LIFECYCLE_EVENT_NAMES, bD as LifecycleEventHandler, bE as LinkFormat, bF as MetricColor, bG as MultiSelectFieldAdmin, bH as NamedAccessPolicy, bI as NumberFieldAdmin, bJ as NumberFormat, bK as NumberLimitFieldAdmin, bL as NumberLimitFieldConfig, bM as NumericOperation, bN as OIDCAdminAuthProvider, bO as OptionFormat, bP as PaginatedResult, bQ as PublicAdminAuthProvider, bR as RadioFieldAdmin, bS as RateLimitConfig, bT as ReadonlyDatabaseAdapter, bU as RichTextFeature, bV as RichTextFieldConfig, bW as SelectFieldAdmin, bX as SqlWhereResult, bY as StorageAdapter, bZ as TextFieldAdmin, b_ as TextFormat, b$ as TextareaFieldAdmin, c0 as TrustProxyConfig, c1 as TypedField, c2 as UploadConfig, c3 as UrlFieldAdmin, c4 as UrlLinkValue, c5 as ViewActionFeatures, c6 as ViewComponentSlots, c7 as ViewConfig, c8 as ViewLayout, c9 as ViewMetric, ca as ViewSubMetric, cb as WhereClause, cc as WhereOperator, cd as WhereOperatorName, ce as WordLimitFieldAdmin, cf as WordLimitFieldConfig, cg as WorkflowMetadata, ch as WorkflowRole, ci as WorkflowState, cj as WorkflowTransitionContext, ck as defineAction, cl as defineView, cm as parseMongoWhere, cn as parseSqlWhere } from './app-config-C6hYM8WO.cjs';
 import jexl from 'jexl';
 import 'lucide-react';
 import 'pino';
@@ -751,6 +751,10 @@ declare class FieldConditionBuilder {
      * Checks that the field is null, undefined, or an empty string.
      */
     isEmpty(): string;
+    /**
+     * Alias for `isEmpty()`.
+     */
+    empty(): string;
     /**
      * Numerical greater than (`field > num`).
      */
@@ -791,6 +795,22 @@ declare class FieldConditionBuilder {
      * Checks if array/string length is at least a threshold.
      */
     hasLengthAtLeast(length: number): string;
+    /**
+     * Generates a JEXL `slugify(field)` transform expression.
+     */
+    slugify(): string;
+    /**
+     * Generates a JEXL `lower(field)` transform expression.
+     */
+    lower(): string;
+    /**
+     * Generates a JEXL `upper(field)` transform expression.
+     */
+    upper(): string;
+    /**
+     * Generates a JEXL `trim(field)` transform expression.
+     */
+    trim(): string;
 }
 /**
  * Pre-built access control condition helpers.
@@ -830,22 +850,26 @@ interface AccessConditions {
  * Condition builder utilities for serializable JEXL expressions in `admin.condition`,
  * access control rules, computed fields, and dynamic `admin.previewUrl`.
  */
-interface WhenFunction {
+/**
+ * Expression builder utilities for serializable JEXL expressions in `admin.condition`,
+ * access control rules, computed fields, transforms, and dynamic `admin.previewUrl`.
+ */
+interface ExprFunction {
     /**
-     * Starts a fluent condition builder for a specific field name.
+     * Starts a fluent condition/expression builder for a specific field name.
      *
      * @example
-     *   admin: { condition: when('price').greaterThan(100) }
-     *   admin: { condition: when('status').in('published', 'archived') }
-     *   admin: { previewUrl: when.then(when('slug').equals('home'), '/', "'/' + slug") }
+     *   admin: { condition: expr('price').greaterThan(100) }
+     *   admin: { condition: expr('status').in('published', 'archived') }
+     *   admin: { previewUrl: expr.ifElse(expr('slug').equals('home'), '/', expr.concat('/', 'slug')) }
      */
     (fieldName: string): FieldConditionBuilder;
     /**
-     * Starts a fluent condition builder on the `user` context (e.g. `when.user('email').endsWith('@company.com')`).
+     * Starts a fluent condition builder on the `user` context (e.g. `expr.user('email').endsWith('@company.com')`).
      */
     user: (userProp: string) => FieldConditionBuilder;
     /**
-     * Starts a fluent condition builder on `siblingData` (e.g. `when.sibling('_variant').equals('split')`).
+     * Starts a fluent condition builder on `siblingData` (e.g. `expr.sibling('_variant').equals('split')`).
      */
     sibling: (siblingProp: string) => FieldConditionBuilder;
     /**
@@ -857,10 +881,10 @@ interface WhenFunction {
      * Automatically quotes literal segments (like paths) and preserves field identifiers.
      *
      * @example
-     *   when.concat('/country-portals/', 'slug')
+     *   expr.concat('/country-portals/', 'slug')
      *   // => "'/country-portals/' + slug"
      *
-     *   when.concat('/blog/', 'category', '/', 'slug')
+     *   expr.concat('/blog/', 'category', '/', 'slug')
      *   // => "'/blog/' + category + '/' + slug"
      */
     concat: (...parts: string[]) => string;
@@ -885,7 +909,11 @@ interface WhenFunction {
      * Can be nested to create ternary chains.
      *
      * @example
-     *   admin: { previewUrl: when.then(when.fieldEquals('slug', 'home'), '/', "'/' + slug") }
+     *   admin: { previewUrl: expr.ifElse(expr.equals('slug', 'home'), '/', expr.concat('/', 'slug')) }
+     */
+    ifElse: (condition: string, ifTrue: string | number | boolean | null, ifFalse?: string | number | boolean | null) => string;
+    /**
+     * Alias for `ifElse`.
      */
     then: (condition: string, ifTrue: string | number | boolean | null, ifFalse?: string | number | boolean | null) => string;
     /**
@@ -893,10 +921,10 @@ interface WhenFunction {
      *
      * @example
      *   admin: {
-     *     previewUrl: when.match()
-     *       .case(when('slug').equals('home'), '/')
-     *       .case(when.fieldNotEmpty('path'), 'path')
-     *       .case(when('category').equals('news'), "'/news/' + slug")
+     *     previewUrl: expr.match()
+     *       .case(expr('slug').equals('home'), '/')
+     *       .case(expr.notEmpty('path'), 'path')
+     *       .case(expr('category').equals('news'), "'/news/' + slug")
      *       .otherwise("'/' + slug")
      *   }
      */
@@ -906,9 +934,9 @@ interface WhenFunction {
      *
      * @example
      *   admin: {
-     *     previewUrl: when.cases(
-     *       [when.fieldEquals('slug', 'home'), '/'],
-     *       [when.fieldNotEmpty('path'), 'path'],
+     *     previewUrl: expr.cases(
+     *       [expr.equals('slug', 'home'), '/'],
+     *       [expr.notEmpty('path'), 'path'],
      *       "'/' + slug"
      *     )
      *   }
@@ -919,7 +947,7 @@ interface WhenFunction {
      */
     all: (...conditions: (string | undefined | null | false)[]) => string;
     /**
-     * Alias for `when.all(...)`.
+     * Alias for `expr.all(...)`.
      */
     and: (...conditions: (string | undefined | null | false)[]) => string;
     /**
@@ -927,7 +955,7 @@ interface WhenFunction {
      */
     any: (...conditions: (string | undefined | null | false)[]) => string;
     /**
-     * Alias for `when.any(...)`.
+     * Alias for `expr.any(...)`.
      */
     or: (...conditions: (string | undefined | null | false)[]) => string;
     /**
@@ -938,8 +966,8 @@ interface WhenFunction {
      * Generates a condition matching one or multiple variant names.
      *
      * @example
-     *   admin: { condition: when.variant('split') }
-     *   admin: { condition: when.variant('imageLeft', 'imageRight') }
+     *   admin: { condition: expr.variant('split') }
+     *   admin: { condition: expr.variant('imageLeft', 'imageRight') }
      */
     variant: (...variants: (string | string[])[]) => string;
     /**
@@ -950,7 +978,7 @@ interface WhenFunction {
      * Generates a condition matching one or multiple block slugs.
      *
      * @example
-     *   admin: { condition: when.block('hero', 'cta') }
+     *   admin: { condition: expr.block('hero', 'cta') }
      */
     block: (...blocks: (string | string[])[]) => string;
     /**
@@ -961,71 +989,90 @@ interface WhenFunction {
      * Generates a condition checking equality against a field value.
      *
      * @example
-     *   admin: { condition: when.fieldEquals('status', 'published') }
+     *   admin: { condition: expr.equals('status', 'published') }
      */
-    fieldEquals: (field: string, value: string | number | boolean | null) => string;
+    equals: (field: string, value: string | number | boolean | null) => string;
     /**
      * Generates a condition checking inequality against a field value.
      */
-    fieldNotEquals: (field: string, value: string | number | boolean | null) => string;
+    notEquals: (field: string, value: string | number | boolean | null) => string;
     /**
      * Generates a condition checking if a field is in a list of allowed values.
      */
-    fieldIn: (field: string, ...values: (string | number | boolean | (string | number | boolean)[])[]) => string;
+    in: (field: string, ...values: (string | number | boolean | (string | number | boolean)[])[]) => string;
     /**
      * Generates a condition checking if a field is NOT in a list of values.
      */
-    fieldNotIn: (field: string, ...values: (string | number | boolean | (string | number | boolean)[])[]) => string;
+    notIn: (field: string, ...values: (string | number | boolean | (string | number | boolean)[])[]) => string;
     /**
      * Generates a condition checking that a field is not null and not empty.
      *
      * @example
-     *   admin: { condition: when.fieldNotEmpty('couponCode') }
+     *   admin: { condition: expr.notEmpty('couponCode') }
      */
-    fieldNotEmpty: (field: string) => string;
+    notEmpty: (field: string) => string;
     /**
      * Generates a condition checking that a field is null, undefined, or empty.
+     *
+     * @example
+     *   admin: { condition: expr.empty('couponCode') }
      */
-    fieldEmpty: (field: string) => string;
+    empty: (field: string) => string;
     /**
      * Generates a condition checking that a boolean field is true.
      */
-    fieldIsTrue: (field: string) => string;
+    isTrue: (field: string) => string;
     /**
      * Generates a condition checking that a boolean field is false / falsy.
      */
-    fieldIsFalse: (field: string) => string;
+    isFalse: (field: string) => string;
     /**
      * Generates a numerical greater-than condition (`field > value`).
      */
-    fieldGreaterThan: (field: string, value: number | string) => string;
+    greaterThan: (field: string, value: number | string) => string;
     /**
      * Generates a numerical greater-than-or-equal condition (`field >= value`).
      */
-    fieldGreaterThanOrEqual: (field: string, value: number | string) => string;
+    greaterThanOrEqual: (field: string, value: number | string) => string;
     /**
      * Generates a numerical less-than condition (`field < value`).
      */
-    fieldLessThan: (field: string, value: number | string) => string;
+    lessThan: (field: string, value: number | string) => string;
     /**
      * Generates a numerical less-than-or-equal condition (`field <= value`).
      */
-    fieldLessThanOrEqual: (field: string, value: number | string) => string;
+    lessThanOrEqual: (field: string, value: number | string) => string;
     /**
      * Generates a range condition (`field >= min && field <= max`).
      */
-    fieldBetween: (field: string, min: number, max: number) => string;
+    between: (field: string, min: number, max: number) => string;
     /**
      * Generates a string prefix condition using JEXL `startsWith(...)`.
      */
-    fieldStartsWith: (field: string, prefix: string) => string;
+    startsWith: (field: string, prefix: string) => string;
     /**
      * Generates a string suffix condition using JEXL `endsWith(...)`.
      */
-    fieldEndsWith: (field: string, suffix: string) => string;
+    endsWith: (field: string, suffix: string) => string;
     /**
      * Generates a string/array inclusion condition using JEXL `includes(...)`.
      */
+    contains: (field: string, item: string | number) => string;
+    fieldEquals: (field: string, value: string | number | boolean | null) => string;
+    fieldNotEquals: (field: string, value: string | number | boolean | null) => string;
+    fieldIn: (field: string, ...values: (string | number | boolean | (string | number | boolean)[])[]) => string;
+    fieldNotIn: (field: string, ...values: (string | number | boolean | (string | number | boolean)[])[]) => string;
+    fieldNotEmpty: (field: string) => string;
+    fieldEmpty: (field: string) => string;
+    fieldIsTrue: (field: string) => string;
+    fieldIsFalse: (field: string) => string;
+    fieldGreaterThan: (field: string, value: number | string) => string;
+    fieldGreaterThanOrEqual: (field: string, value: number | string) => string;
+    fieldLessThan: (field: string, value: number | string) => string;
+    fieldLessThanOrEqual: (field: string, value: number | string) => string;
+    fieldBetween: (field: string, min: number, max: number) => string;
+    fieldStartsWith: (field: string, prefix: string) => string;
+    fieldEndsWith: (field: string, suffix: string) => string;
     fieldContains: (field: string, item: string | number) => string;
     /**
      * Generates a condition checking that an array is non-empty (`length(field) > 0`).
@@ -1052,14 +1099,14 @@ interface WhenFunction {
      * Checks both `user.role` (string) and `user.roles` (array).
      *
      * @example
-     *   admin: { condition: when.userRole('admin', 'developer') }
+     *   admin: { condition: expr.userRole('admin', 'developer') }
      */
     userRole: (...roles: (string | string[])[]) => string;
     /**
      * Generates a condition checking the editor's email domain.
      *
      * @example
-     *   admin: { condition: when.userEmailDomain('agrictrail.com') }
+     *   admin: { condition: expr.userEmailDomain('agrictrail.com') }
      */
     userEmailDomain: (domain: string) => string;
     /**
@@ -1083,7 +1130,18 @@ interface WhenFunction {
      */
     statusIn: (...statuses: (string | string[])[]) => string;
 }
-declare const when: WhenFunction;
+/**
+ * Backwards compatibility type alias for `ExprFunction`.
+ */
+type WhenFunction = ExprFunction;
+/**
+ * Primary declarative expression builder for Dyrected schemas.
+ */
+declare const expr: ExprFunction;
+/**
+ * Backwards compatibility alias for `expr`.
+ */
+declare const when: ExprFunction;
 
 type TopLevelFieldName<TFields extends readonly Field[]> = Extract<TFields[number], {
     name: string;
@@ -1504,4 +1562,4 @@ declare function defineTab<const T extends readonly Field[]>(args: {
     fields: T;
 }): T;
 
-export { type AccessConditions, AccessPolicyResolver, AdminAuthConfig, ArrayField, AuthConfig, type AuthDocFields, AuthenticatedUser, BUILTIN_JEXL_HELPERS, BaseDocument, Block, BlocksField, BooleanField, CollectionConfig, ComputedHandler, type ConfigDiagnostic, ConfigValidationError, DateField, DateTimeField, type DeclarativeAccessSurface, type DeclarativeAccessValidationIssue, type DeclarativeAdminSurface, type DeclarativeAdminValidationIssue, DeclarativeHookExpression, type DeclarativeHookSurface, type DeclarativeHookValidationIssue, type DeclarativePreviewSurface, type DeclarativePreviewValidationIssue, DetailComputed, DetailComputedOptions, DetailCustom, DetailCustomOptions, DetailDivider, DetailDividerOptions, DetailField, DetailGrid, DetailGridOptions, DetailItem, DetailRepeat, DetailRepeatOptions, DetailSchema, DetailSection, DetailSectionOptions, DetailTab, DetailTabOptions, DetailTabs, DetailTabsOptions, DetailText, DetailTextOptions, DisplayFieldOptions, DyrectedConfig, EmailField, Field, FieldConditionBuilder, GlobalConfig, HookRequestContext, IconField, ImageField, type InferDocShape, JoinField, JsonField, LIFECYCLE_EVENTS_COLLECTION, LifecycleEvent, LifecycleEventName, MatchBuilder, MultiSelectField, NumberField, ObjectField, type Prettify, PublicAdminAuthConfig, type PublishingWorkflowOptions, RadioField, RelationshipField, RichTextField, RowField, SelectField, type SortClause, type SortDirection, type SqlSortDialect, type SystemDocFields, TextField, TextareaField, TimeField, type UploadDocFields, UrlField, WORKFLOW_HISTORY_COLLECTION, type WhenFunction, WorkflowConfig, WorkflowTransition, abs, addDays, assertValidAdminConditionsInConfig, assertValidDeclarativeAccessInConfig, assertValidDeclarativeHookExpression, assertValidDeclarativeHookResult, assertValidDeclarativeHooksInConfig, assertValidPreviewUrlsInConfig, availableWorkflowTransitions, buildSqlOrderBy, canViewWorkflowDraft, capitalize, ceil, clamp, coalesce, collectAdminConditionValidationIssues, collectConfigDiagnostics, collectDeclarativeAccessValidationIssues, collectDeclarativeHookValidationIssues, collectPreviewUrlValidationIssues, compact, count, createLifecycleEvent, createWorkflowDocument, defaultValue, defineArrayField, defineBlock, defineBlocksField, defineBooleanField, defineCollection, defineConfig, defineDateField, defineDateTimeField, defineEmailField, defineField, defineGlobal, defineIconField, defineImageField, defineJoinField, defineJsonField, defineMultiSelectField, defineNumberField, defineObjectField, definePublishingWorkflow, defineRadioField, defineRelationshipField, defineRichTextField, defineRowField, defineSelectField, defineTab, defineTextField, defineTextareaField, defineTimeField, defineUrlField, diffDays, dispatchLifecycleEvent, dispatchPendingLifecycleEvents, displayComputed, displayCustom, displayCustomComponent, displayDivider, displayField, displayGrid, displayRepeat, displaySection, displayTab, displayTabs, displayText, endsWith, evaluateDetailComputed, evaluateJexl, evaluateJexlSync, executeFieldAfterRead, executeFieldBeforeChange, first, floor, formatConfigDiagnostics, formatDate, formatJexlValue, generateDefaultDetailSchema, generateOpenApi, get, getAdminAuthCollection, getPublicAdminAuthConfig, includes, initializeWorkflowDocument, isConfigValidationError, isDetailItemVisible, isEmpty, isFuture, isPast, join, last, length, lower, materializeWorkflowDocument, max, min, normalizeConfig, normalizeDetailItem, now, numericFieldNames, parseSort, pow, publishedStateName, publishingWorkflow, readingTime, registerJexlHelpers, replace, resolveAdminAuthCollection, round, runCollectionHooks, saveWorkflowDraft, simplePublishingWorkflow, slugify, sqrt, startsWith, sum, today, transitionWorkflow, trim, truncate, unique, upper, validateAdminConditionExpression, validateDeclarativeAccessExpression, validateDeclarativeHookExpression, validatePreviewUrlExpression, when, wordCount, workflowCapabilities };
+export { type AccessConditions, AccessPolicyResolver, AdminAuthConfig, ArrayField, AuthConfig, type AuthDocFields, AuthenticatedUser, BUILTIN_JEXL_HELPERS, BaseDocument, Block, BlocksField, BooleanField, CollectionConfig, ComputedHandler, type ConfigDiagnostic, ConfigValidationError, DateField, DateTimeField, type DeclarativeAccessSurface, type DeclarativeAccessValidationIssue, type DeclarativeAdminSurface, type DeclarativeAdminValidationIssue, DeclarativeHookExpression, type DeclarativeHookSurface, type DeclarativeHookValidationIssue, type DeclarativePreviewSurface, type DeclarativePreviewValidationIssue, DetailComputed, DetailComputedOptions, DetailCustom, DetailCustomOptions, DetailDivider, DetailDividerOptions, DetailField, DetailGrid, DetailGridOptions, DetailItem, DetailRepeat, DetailRepeatOptions, DetailSchema, DetailSection, DetailSectionOptions, DetailTab, DetailTabOptions, DetailTabs, DetailTabsOptions, DetailText, DetailTextOptions, DisplayFieldOptions, DyrectedConfig, EmailField, type ExprFunction, Field, FieldConditionBuilder, GlobalConfig, HookRequestContext, IconField, ImageField, type InferDocShape, JoinField, JsonField, LIFECYCLE_EVENTS_COLLECTION, LifecycleEvent, LifecycleEventName, MatchBuilder, MultiSelectField, NumberField, ObjectField, type Prettify, PublicAdminAuthConfig, type PublishingWorkflowOptions, RadioField, RelationshipField, RichTextField, RowField, SelectField, type SortClause, type SortDirection, type SqlSortDialect, type SystemDocFields, TextField, TextareaField, TimeField, type UploadDocFields, UrlField, WORKFLOW_HISTORY_COLLECTION, type WhenFunction, WorkflowConfig, WorkflowTransition, abs, addDays, assertValidAdminConditionsInConfig, assertValidDeclarativeAccessInConfig, assertValidDeclarativeHookExpression, assertValidDeclarativeHookResult, assertValidDeclarativeHooksInConfig, assertValidPreviewUrlsInConfig, availableWorkflowTransitions, buildSqlOrderBy, canViewWorkflowDraft, capitalize, ceil, clamp, coalesce, collectAdminConditionValidationIssues, collectConfigDiagnostics, collectDeclarativeAccessValidationIssues, collectDeclarativeHookValidationIssues, collectPreviewUrlValidationIssues, compact, count, createLifecycleEvent, createWorkflowDocument, defaultValue, defineArrayField, defineBlock, defineBlocksField, defineBooleanField, defineCollection, defineConfig, defineDateField, defineDateTimeField, defineEmailField, defineField, defineGlobal, defineIconField, defineImageField, defineJoinField, defineJsonField, defineMultiSelectField, defineNumberField, defineObjectField, definePublishingWorkflow, defineRadioField, defineRelationshipField, defineRichTextField, defineRowField, defineSelectField, defineTab, defineTextField, defineTextareaField, defineTimeField, defineUrlField, diffDays, dispatchLifecycleEvent, dispatchPendingLifecycleEvents, displayComputed, displayCustom, displayCustomComponent, displayDivider, displayField, displayGrid, displayRepeat, displaySection, displayTab, displayTabs, displayText, endsWith, evaluateDetailComputed, evaluateJexl, evaluateJexlSync, executeFieldAfterRead, executeFieldBeforeChange, expr, first, floor, formatConfigDiagnostics, formatDate, formatJexlValue, generateDefaultDetailSchema, generateOpenApi, get, getAdminAuthCollection, getPublicAdminAuthConfig, includes, initializeWorkflowDocument, isConfigValidationError, isDetailItemVisible, isEmpty, isFuture, isPast, join, last, length, lower, materializeWorkflowDocument, max, min, normalizeConfig, normalizeDetailItem, now, numericFieldNames, parseSort, pow, publishedStateName, publishingWorkflow, readingTime, registerJexlHelpers, replace, resolveAdminAuthCollection, round, runCollectionHooks, saveWorkflowDraft, simplePublishingWorkflow, slugify, sqrt, startsWith, sum, today, transitionWorkflow, trim, truncate, unique, upper, validateAdminConditionExpression, validateDeclarativeAccessExpression, validateDeclarativeHookExpression, validatePreviewUrlExpression, when, wordCount, workflowCapabilities };