@dyrected/core 2.10.0 → 2.10.1

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, 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-DQhcrGDE.js';
-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 CountOperation, aQ as CustomAdminAuthProvider, aR as DatabaseAdapter, aS as DateFieldAdmin, aT as DateFormat, aU as DefineActionOptions, aV as DefineViewOptions, aW as DetailSpan, aX as DisplayTone, aY as DisplayVariant, aZ as DistinctCountOperation, a_ as DistinctValuesOperation, a$ as DynamicOptionItem, b0 as DynamicOptionsConfig, b1 as DynamicOptionsResolver, b2 as DynamicOptionsResolverArgs, b3 as DyrectedLoggerConfig, b4 as DyrectedObservabilityConfig, b5 as EmailFieldAdmin, b6 as FieldAdminHooks, b7 as FieldAdminOnChangeHook, b8 as FieldAdminOnChangeHookArgs, b9 as FieldAdminOptionsHook, ba as FieldAdminOptionsHookArgs, bb as FieldAdminOptionsHookResult, bc as FieldAfterReadHook, bd as FieldAfterReadHookArgs, be as FieldBase, bf as FieldBeforeChangeHook, bg as FieldBeforeChangeHookArgs, bh as FieldHook, bi as FieldHooks, bj as FieldType, bk as FileData, bl as GlobalAfterChangeHook, bm as GlobalAfterReadHook, bn as GlobalAfterReadHookEntry, bo as GlobalBeforeChangeHook, bp as GlobalBeforeChangeHookEntry, bq as GlobalBeforeReadHook, br as GlobalBeforeReadHookEntry, bs as HeadingLevel, bt as HookFunction, bu as IconFieldAdmin, bv as ImageService, bw as InferAggregateResult, bx as JoinFieldAdmin, by as JsonFieldAdmin, bz as JsonFormat, bA as LIFECYCLE_EVENT_NAMES, bB as LifecycleEventHandler, bC as LinkFormat, bD as MetricColor, bE as MultiSelectFieldAdmin, bF as NamedAccessPolicy, bG as NumberFieldAdmin, bH as NumberFormat, bI as NumberLimitFieldAdmin, bJ as NumberLimitFieldConfig, bK as NumericOperation, bL as OIDCAdminAuthProvider, bM as OptionFormat, bN as PaginatedResult, bO as PublicAdminAuthProvider, bP as RadioFieldAdmin, bQ as RateLimitConfig, bR as ReadonlyDatabaseAdapter, bS as RichTextFeature, bT as RichTextFieldConfig, bU as SelectFieldAdmin, bV as StorageAdapter, bW as TextFieldAdmin, bX as TextFormat, bY as TextareaFieldAdmin, bZ as TrustProxyConfig, b_ as TypedField, b$ as UploadConfig, c0 as UrlFieldAdmin, c1 as UrlLinkValue, c2 as ViewActionFeatures, c3 as ViewConfig, c4 as ViewLayout, c5 as ViewMetric, c6 as ViewSubMetric, c7 as WordLimitFieldAdmin, c8 as WordLimitFieldConfig, c9 as WorkflowMetadata, ca as WorkflowRole, cb as WorkflowState, cc as WorkflowTransitionContext, cd as defineAction, ce as defineView } from './app-config-DQhcrGDE.js';
+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.js';
+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.js';
 import jexl from 'jexl';
 import 'lucide-react';
 import 'pino';
@@ -86,89 +86,6 @@ declare function getAdminAuthCollection(config: Pick<DyrectedConfig, "collection
 declare function resolveAdminAuthCollection(collections: CollectionConfig[], collectionSlug?: string): CollectionConfig | undefined;
 declare function getPublicAdminAuthConfig(adminAuth?: AdminAuthConfig, collections?: CollectionConfig[]): PublicAdminAuthConfig;
 
-/**
- * Dyrected Where Clause DSL — shared query language across all database adapters.
- *
- * Adapters translate this DSL into their native format:
- *   - SQL adapters (SQLite, Postgres, MySQL): use parseSqlWhere()
- *   - MongoDB adapter: use parseMongoWhere()
- *   - Future adapters: implement their own translator against WhereClause
- *
- * Exhaustive operator handling is enforced at compile time via `assertNever`,
- * so adding a new operator without handling it will produce a TypeScript error
- * in every adapter translator.
- */
-type WhereOperatorName = 'equals' | 'not_equals' | 'in' | 'not_in' | 'gt' | 'greater_than' | 'gte' | 'greater_than_equal' | 'greater_than_or_equal' | 'lt' | 'less_than' | 'lte' | 'less_than_equal' | 'less_than_or_equal' | 'contains' | 'like' | 'starts_with' | 'exists';
-type WhereOperator = {
-    equals: any;
-} | {
-    not_equals: any;
-} | {
-    in: any[];
-} | {
-    not_in: any[];
-} | {
-    gt: any;
-} | {
-    greater_than: any;
-} | {
-    gte: any;
-} | {
-    greater_than_equal: any;
-} | {
-    greater_than_or_equal: any;
-} | {
-    lt: any;
-} | {
-    less_than: any;
-} | {
-    lte: any;
-} | {
-    less_than_equal: any;
-} | {
-    less_than_or_equal: any;
-} | {
-    contains: string;
-} | {
-    like: string;
-} | {
-    starts_with: string;
-} | {
-    exists: boolean;
-};
-/** Top-level where clause. Fields map to operator objects or shorthand scalar values. */
-type WhereClause = {
-    [field: string]: WhereOperator | any;
-    OR?: WhereClause[];
-    AND?: WhereClause[];
-};
-interface SqlWhereResult {
-    sql: string;
-    params: any[];
-}
-/**
- * Translates a WhereClause into a parameterized SQL WHERE fragment.
- *
- * @param where         The Dyrected where DSL object
- * @param getJsonField  Returns the SQL expression for a JSON-stored field (dialect-specific):
- *                        SQLite:   (f) => `json_extract(data, '$.${f}')`
- *                        Postgres: (f) => `data->>'${f}'`
- *                        MySQL:    (f) => `JSON_UNQUOTE(JSON_EXTRACT(data, '$.${f}'))`
- * @param placeholder   '?' for SQLite/MySQL, 'pg' for auto-incrementing Postgres $1/$2/…
- */
-declare function parseSqlWhere(where: WhereClause, getJsonField: (field: string) => string, placeholder?: '?' | 'pg', 
-/**
- * SQL keyword used for `contains`/`starts_with`. Postgres `LIKE` is
- * case-sensitive, so the Postgres adapter defaults to `'ILIKE'` to keep substring
- * matching case-insensitive like SQLite and MySQL.
- */
-likeOperator?: 'LIKE' | 'ILIKE'): SqlWhereResult;
-/**
- * Translates a WhereClause into a MongoDB filter object.
- * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
- */
-declare function parseMongoWhere(where: WhereClause): Record<string, any>;
-
 type SortDirection = 'ASC' | 'DESC';
 interface SortClause {
     field: string;
@@ -770,6 +687,404 @@ declare function generateDefaultDetailSchema(schema: {
  */
 declare function isDetailItemVisible(item: DetailItem, doc: any, user?: any): boolean;
 
+/**
+ * Formats a value for serializable JEXL expressions.
+ * Handles paths, expressions, identifiers, strings, and primitives.
+ */
+declare function formatJexlValue(v: string | number | boolean | null | undefined): string;
+/**
+ * Multi-branch conditional builder for chaining if-else / switch-case expressions in JEXL.
+ *
+ * @example
+ *   when.match()
+ *     .case(when('slug').equals('home'), '/')
+ *     .case(when.fieldNotEmpty('path'), 'path')
+ *     .case(when('category').equals('news'), "'/news/' + slug")
+ *     .otherwise("'/' + slug")
+ */
+declare class MatchBuilder {
+    private branches;
+    /**
+     * Adds a conditional branch (`condition ? value : ...`).
+     */
+    case(condition: string, value: string | number | boolean | null): this;
+    /**
+     * Final fallback value when no cases match.
+     */
+    otherwise(fallback?: string | number | boolean | null): string;
+}
+/**
+ * Fluent builder for creating single-field conditions.
+ */
+declare class FieldConditionBuilder {
+    private field;
+    constructor(field: string);
+    /**
+     * Generates equality condition (`field == value`).
+     */
+    equals(value: string | number | boolean | null): string;
+    /**
+     * Generates inequality condition (`field != value`).
+     */
+    notEquals(value: string | number | boolean | null): string;
+    /**
+     * Generates set membership condition (`field in [val1, val2]`).
+     */
+    in(...values: (string | number | boolean | (string | number | boolean)[])[]): string;
+    /**
+     * Generates inverted set membership condition (`!(field in [val1, val2])`).
+     */
+    notIn(...values: (string | number | boolean | (string | number | boolean)[])[]): string;
+    /**
+     * Generates boolean true check (`field == true`).
+     */
+    isTrue(): string;
+    /**
+     * Generates boolean false check (`field != true`).
+     */
+    isFalse(): string;
+    /**
+     * Checks that the field is neither null/undefined nor an empty string.
+     */
+    notEmpty(): string;
+    /**
+     * Checks that the field is null, undefined, or an empty string.
+     */
+    isEmpty(): string;
+    /**
+     * Numerical greater than (`field > num`).
+     */
+    greaterThan(num: number | string): string;
+    /**
+     * Numerical greater than or equal (`field >= num`).
+     */
+    greaterThanOrEqual(num: number | string): string;
+    /**
+     * Numerical less than (`field < num`).
+     */
+    lessThan(num: number | string): string;
+    /**
+     * Numerical less than or equal (`field <= num`).
+     */
+    lessThanOrEqual(num: number | string): string;
+    /**
+     * Numerical range check (`field >= min && field <= max`).
+     */
+    between(min: number, max: number): string;
+    /**
+     * String prefix check using JEXL `startsWith(field, prefix)`.
+     */
+    startsWith(prefix: string): string;
+    /**
+     * String suffix check using JEXL `endsWith(field, suffix)`.
+     */
+    endsWith(suffix: string): string;
+    /**
+     * Substring or array item check using JEXL `includes(field, item)`.
+     */
+    contains(val: string | number): string;
+    /**
+     * Checks if array/string length exceeds a threshold.
+     */
+    hasLengthGreaterThan(length: number): string;
+    /**
+     * Checks if array/string length is at least a threshold.
+     */
+    hasLengthAtLeast(length: number): string;
+}
+/**
+ * Pre-built access control condition helpers.
+ */
+interface AccessConditions {
+    /**
+     * Checks if current user is the document owner (matches `user.id`).
+     * @default ownerField 'author'
+     *
+     * @example
+     *   access: { update: when.access.isOwner('authorId') }
+     */
+    isOwner: (ownerField?: string) => string;
+    /**
+     * Checks if current user has the 'admin' role or 'admin' in `user.roles`.
+     *
+     * @example
+     *   access: { delete: when.access.isAdmin() }
+     */
+    isAdmin: () => string;
+    /**
+     * Checks if current user has one of the specified roles.
+     *
+     * @example
+     *   access: { update: when.access.hasRole('admin', 'editor') }
+     */
+    hasRole: (...roles: (string | string[])[]) => string;
+    /**
+     * Common read access policy: document is published OR user is an admin/editor.
+     *
+     * @example
+     *   access: { read: when.access.isPublishedOrAdmin() }
+     */
+    isPublishedOrAdmin: (statusField?: string) => string;
+}
+/**
+ * Condition builder utilities for serializable JEXL expressions in `admin.condition`,
+ * access control rules, computed fields, and dynamic `admin.previewUrl`.
+ */
+interface WhenFunction {
+    /**
+     * Starts a fluent condition 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") }
+     */
+    (fieldName: string): FieldConditionBuilder;
+    /**
+     * Starts a fluent condition builder on the `user` context (e.g. `when.user('email').endsWith('@company.com')`).
+     */
+    user: (userProp: string) => FieldConditionBuilder;
+    /**
+     * Starts a fluent condition builder on `siblingData` (e.g. `when.sibling('_variant').equals('split')`).
+     */
+    sibling: (siblingProp: string) => FieldConditionBuilder;
+    /**
+     * Pre-packaged role and ownership access condition builders.
+     */
+    access: AccessConditions;
+    /**
+     * Concatenates paths, literal strings, and field identifiers into a JEXL string concatenation expression.
+     * Automatically quotes literal segments (like paths) and preserves field identifiers.
+     *
+     * @example
+     *   when.concat('/country-portals/', 'slug')
+     *   // => "'/country-portals/' + slug"
+     *
+     *   when.concat('/blog/', 'category', '/', 'slug')
+     *   // => "'/blog/' + category + '/' + slug"
+     */
+    concat: (...parts: string[]) => string;
+    /**
+     * Generates a JEXL `slugify(field)` transform expression.
+     */
+    slugify: (field: string) => string;
+    /**
+     * Generates a JEXL `lower(field)` transform expression.
+     */
+    lower: (field: string) => string;
+    /**
+     * Generates a JEXL `upper(field)` transform expression.
+     */
+    upper: (field: string) => string;
+    /**
+     * Generates a JEXL `trim(field)` transform expression.
+     */
+    trim: (field: string) => string;
+    /**
+     * Creates a ternary expression: `condition ? ifTrue : ifFalse`.
+     * Can be nested to create ternary chains.
+     *
+     * @example
+     *   admin: { previewUrl: when.then(when.fieldEquals('slug', 'home'), '/', "'/' + slug") }
+     */
+    then: (condition: string, ifTrue: string | number | boolean | null, ifFalse?: string | number | boolean | null) => string;
+    /**
+     * Starts a multi-branch chained ternary builder (`case().case().otherwise()`).
+     *
+     * @example
+     *   admin: {
+     *     previewUrl: when.match()
+     *       .case(when('slug').equals('home'), '/')
+     *       .case(when.fieldNotEmpty('path'), 'path')
+     *       .case(when('category').equals('news'), "'/news/' + slug")
+     *       .otherwise("'/' + slug")
+     *   }
+     */
+    match: () => MatchBuilder;
+    /**
+     * Declarative multi-case ternary builder.
+     *
+     * @example
+     *   admin: {
+     *     previewUrl: when.cases(
+     *       [when.fieldEquals('slug', 'home'), '/'],
+     *       [when.fieldNotEmpty('path'), 'path'],
+     *       "'/' + slug"
+     *     )
+     *   }
+     */
+    cases: (...branches: ([condition: string, value: string | number | boolean | null] | string | number | boolean | null)[]) => string;
+    /**
+     * Combines multiple conditions with AND (`&&`).
+     */
+    all: (...conditions: (string | undefined | null | false)[]) => string;
+    /**
+     * Alias for `when.all(...)`.
+     */
+    and: (...conditions: (string | undefined | null | false)[]) => string;
+    /**
+     * Combines multiple conditions with OR (`||`).
+     */
+    any: (...conditions: (string | undefined | null | false)[]) => string;
+    /**
+     * Alias for `when.any(...)`.
+     */
+    or: (...conditions: (string | undefined | null | false)[]) => string;
+    /**
+     * Inverts a condition (`!(condition)`).
+     */
+    not: (condition: string) => string;
+    /**
+     * Generates a condition matching one or multiple variant names.
+     *
+     * @example
+     *   admin: { condition: when.variant('split') }
+     *   admin: { condition: when.variant('imageLeft', 'imageRight') }
+     */
+    variant: (...variants: (string | string[])[]) => string;
+    /**
+     * Generates a condition matching everything EXCEPT the given variant names.
+     */
+    notVariant: (...variants: (string | string[])[]) => string;
+    /**
+     * Generates a condition matching one or multiple block slugs.
+     *
+     * @example
+     *   admin: { condition: when.block('hero', 'cta') }
+     */
+    block: (...blocks: (string | string[])[]) => string;
+    /**
+     * Generates a condition matching everything EXCEPT the given block slugs.
+     */
+    notBlock: (...blocks: (string | string[])[]) => string;
+    /**
+     * Generates a condition checking equality against a field value.
+     *
+     * @example
+     *   admin: { condition: when.fieldEquals('status', 'published') }
+     */
+    fieldEquals: (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;
+    /**
+     * 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;
+    /**
+     * 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;
+    /**
+     * Generates a condition checking that a field is not null and not empty.
+     *
+     * @example
+     *   admin: { condition: when.fieldNotEmpty('couponCode') }
+     */
+    fieldNotEmpty: (field: string) => string;
+    /**
+     * Generates a condition checking that a field is null, undefined, or empty.
+     */
+    fieldEmpty: (field: string) => string;
+    /**
+     * Generates a condition checking that a boolean field is true.
+     */
+    fieldIsTrue: (field: string) => string;
+    /**
+     * Generates a condition checking that a boolean field is false / falsy.
+     */
+    fieldIsFalse: (field: string) => string;
+    /**
+     * Generates a numerical greater-than condition (`field > value`).
+     */
+    fieldGreaterThan: (field: string, value: number | string) => string;
+    /**
+     * Generates a numerical greater-than-or-equal condition (`field >= value`).
+     */
+    fieldGreaterThanOrEqual: (field: string, value: number | string) => string;
+    /**
+     * Generates a numerical less-than condition (`field < value`).
+     */
+    fieldLessThan: (field: string, value: number | string) => string;
+    /**
+     * Generates a numerical less-than-or-equal condition (`field <= value`).
+     */
+    fieldLessThanOrEqual: (field: string, value: number | string) => string;
+    /**
+     * Generates a range condition (`field >= min && field <= max`).
+     */
+    fieldBetween: (field: string, min: number, max: number) => string;
+    /**
+     * Generates a string prefix condition using JEXL `startsWith(...)`.
+     */
+    fieldStartsWith: (field: string, prefix: string) => string;
+    /**
+     * Generates a string suffix condition using JEXL `endsWith(...)`.
+     */
+    fieldEndsWith: (field: string, suffix: string) => string;
+    /**
+     * Generates a string/array inclusion condition using JEXL `includes(...)`.
+     */
+    fieldContains: (field: string, item: string | number) => string;
+    /**
+     * Generates a condition checking that an array is non-empty (`length(field) > 0`).
+     */
+    arrayNotEmpty: (field: string) => string;
+    /**
+     * Generates a condition checking that an array is empty (`length(field) == 0`).
+     */
+    arrayEmpty: (field: string) => string;
+    /**
+     * Generates a condition checking that an array has more than N items.
+     */
+    arrayCountGreaterThan: (field: string, count: number) => string;
+    /**
+     * Generates a condition checking that an array has at least N items.
+     */
+    arrayCountAtLeast: (field: string, count: number) => string;
+    /**
+     * Generates a condition checking that an array has less than N items.
+     */
+    arrayCountLessThan: (field: string, count: number) => string;
+    /**
+     * Generates a condition checking the authenticated editor's role.
+     * Checks both `user.role` (string) and `user.roles` (array).
+     *
+     * @example
+     *   admin: { condition: when.userRole('admin', 'developer') }
+     */
+    userRole: (...roles: (string | string[])[]) => string;
+    /**
+     * Generates a condition checking the editor's email domain.
+     *
+     * @example
+     *   admin: { condition: when.userEmailDomain('agrictrail.com') }
+     */
+    userEmailDomain: (domain: string) => string;
+    /**
+     * Generates a condition checking a custom attribute on the user object.
+     */
+    userAttributeEquals: (attr: string, value: string | number | boolean | null) => string;
+    /**
+     * Condition that evaluates to true only for unsaved, newly-created documents.
+     */
+    isNewDocument: () => string;
+    /**
+     * Condition that evaluates to true only for persisted, existing documents.
+     */
+    isExistingDocument: () => string;
+    /**
+     * Generates a condition checking the document's workflow status.
+     */
+    statusEquals: (status: string) => string;
+    /**
+     * Generates a condition checking if status is within a set of statuses.
+     */
+    statusIn: (...statuses: (string | string[])[]) => string;
+}
+declare const when: WhenFunction;
+
 type TopLevelFieldName<TFields extends readonly Field[]> = Extract<TFields[number], {
     name: string;
 }>["name"];
@@ -1189,4 +1504,4 @@ declare function defineTab<const T extends readonly Field[]>(args: {
     fields: T;
 }): T;
 
-export { 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, GlobalConfig, HookRequestContext, IconField, ImageField, type InferDocShape, JoinField, JsonField, LIFECYCLE_EVENTS_COLLECTION, LifecycleEvent, LifecycleEventName, MultiSelectField, NumberField, ObjectField, type Prettify, PublicAdminAuthConfig, type PublishingWorkflowOptions, RadioField, RelationshipField, RichTextField, RowField, SelectField, type SortClause, type SortDirection, type SqlSortDialect, type SqlWhereResult, type SystemDocFields, TextField, TextareaField, TimeField, type UploadDocFields, UrlField, WORKFLOW_HISTORY_COLLECTION, type WhereClause, type WhereOperator, type WhereOperatorName, 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, generateDefaultDetailSchema, generateOpenApi, get, getAdminAuthCollection, getPublicAdminAuthConfig, includes, initializeWorkflowDocument, isConfigValidationError, isDetailItemVisible, isEmpty, isFuture, isPast, join, last, length, lower, materializeWorkflowDocument, max, min, normalizeConfig, normalizeDetailItem, now, numericFieldNames, parseMongoWhere, parseSort, parseSqlWhere, 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, 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, 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 };