@dyrected/core 2.10.0 → 2.11.0

package/dist/{app-config-DQhcrGDE.d.cts → app-config-6U_Kum-Z.d.cts}

@@ -162,12 +162,24 @@ interface AdminDashboardComponentSlots {
     beforeDashboard?: string[];
     afterDashboard?: string[];
 }
+/** Ordered custom component keys rendered around an operational view's content. */
+interface CollectionViewComponentSlots {
+    beforeViewHeader?: string[];
+    afterViewHeader?: string[];
+    beforeViewContent?: string[];
+    afterViewContent?: string[];
+}
 /** Ordered custom component keys rendered around a collection's list content. */
 interface CollectionListComponentSlots {
     beforeList?: string[];
     beforeListTable?: string[];
     afterListTable?: string[];
     afterList?: string[];
+    beforeViewHeader?: string[];
+    afterViewHeader?: string[];
+    beforeViewContent?: string[];
+    afterViewContent?: string[];
+    collectionView?: CollectionViewComponentSlots;
 }
 /**
  * Branding and metadata options for the Dyrected Admin UI.
@@ -944,6 +956,95 @@ type InferAggregateResult<T extends AggregateInput> = {
     [K in keyof T]: any;
 };
 
+/**
+ * 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[];
+    or?: WhereClause[];
+    AND?: 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>;
+
+/**
+ * Custom component slots rendered around an operational view's content.
+ */
+type ViewComponentSlots = CollectionViewComponentSlots;
 /**
  * Supported layout engines for operational views in the Dyrected Admin UI:
  * - `'table'`: The workhorse — column sorting, search, faceted filters, and bulk actions.
@@ -1072,7 +1173,7 @@ interface ViewConfig {
     /** Layout engine to render: `'table' | 'spreadsheet' | 'kanban' | 'calendar' | 'gantt' | 'cards'`. Defaults to `'table'`. */
     layout?: ViewLayout;
     /** Base query filter applied before user toolbar filters (e.g. `{ attending: { equals: true } }` or JEXL string). */
-    filter?: Record<string, any> | string;
+    filter?: WhereClause | string;
     /** Field name used to organize records into kanban columns or collapsible grouped sections in table, cards, and spreadsheet. */
     groupBy?: string;
     /** Field name containing the ISO date string for calendar placement. Required when `layout: 'calendar'`. */
@@ -1110,6 +1211,8 @@ interface ActionConfig<TDoc extends Record<string, unknown> = Record<string, unk
     name: string;
     /** Button label displayed in the UI. */
     label: string;
+    /** Optional custom label for the modal submit button (defaults to "Run" or "Confirm"). */
+    submitLabel?: string;
     /** Lucide icon name for the button (e.g. `"UserCheck"`, `"CheckCircle"`). */
     icon?: string;
     /** Action placement: `'row'` (per-row), `'bulk'` (multi-row selection bar), or `'header'` (view header). Defaults to `'row'`. */
@@ -1203,6 +1306,8 @@ interface DefineViewOptions {
     actionOrder?: string[];
     /** KPI summary cards rendered in the hero row above the view. */
     metrics?: ViewMetric[];
+    /** Custom component slots rendered around this operational view. */
+    components?: ViewComponentSlots;
     /** Role-based access rules controlling who can see or use this view. */
     access?: AccessConfig;
 }
@@ -1635,9 +1740,31 @@ interface CollectionConfig<TDoc extends object = Record<string, unknown>> {
         urlPattern?: string;
     };
     /**
-     * Custom detail view layout configuration for the Admin UI.
+     * Detail view layout configuration for the Admin UI.
+     *
+     * By default, collections are **Edit-First** (`detail: false`). Clicking a record in the
+     * table or cards view navigates directly to the editing form with Live Preview.
+     *
+     * Set to `true` to enable the automatic read-only summary layout, or provide a `DetailSchema`
+     * array using display helpers (`displaySection`, `displayField`, `displayTabs`, etc.) for a
+     * custom operational dashboard layout.
+     *
+     * @default false
+     * @example
+     * ```ts
+     * // Enable automatic summary detail view
+     * detail: true
+     *
+     * // Or define a custom operational detail view
+     * detail: [
+     *   displaySection("Customer Overview", [
+     *     displayField("name", { span: 8 }),
+     *     displayField("status", { span: 4, display: "badge" }),
+     *   ]),
+     * ]
+     * ```
      */
-    detail?: DetailSchema<TDoc> | false;
+    detail?: DetailSchema<TDoc> | boolean;
     /**
      * Slug of the operational view to render by default when navigating to `/collections/:slug`.
      *
@@ -1763,9 +1890,17 @@ interface GlobalConfig<TDoc extends object = Record<string, unknown>> {
      */
     initialData?: Partial<TDoc>;
     /**
-     * Custom detail view layout configuration for the Admin UI.
+     * Detail view layout configuration for the Admin UI.
+     *
+     * By default, globals are **Edit-First** (`detail: false`). Clicking the global in the
+     * sidebar navigates directly to the editing form.
+     *
+     * Set to `true` to enable the automatic read-only summary layout, or provide a `DetailSchema`
+     * array for a custom operational dashboard layout.
+     *
+     * @default false
      */
-    detail?: DetailSchema<TDoc> | false;
+    detail?: DetailSchema<TDoc> | boolean;
 }
 
 /**
@@ -2106,6 +2241,12 @@ interface FieldAdminOnChangeHookArgs<TValue = unknown> {
     siblingData: Record<string, unknown>;
     /** Current values for the entire form. */
     data: Record<string, unknown>;
+    /** The targeted record / document when available. */
+    doc?: Record<string, unknown>;
+    /** Array of targeted records for bulk action operations. */
+    docs?: Record<string, unknown>[];
+    /** Current authenticated user. */
+    user?: unknown;
     /** Imperative setter for async or derived updates. */
     setValue: (value: unknown) => void;
 }
@@ -2118,10 +2259,18 @@ type FieldAdminHooks<TValue> = {
     };
 };
 interface FieldAdminOptionsHookArgs {
+    /** Current field value in the form state (if set). */
+    value?: unknown;
     /** Current values for sibling fields at the same nesting level. */
     siblingData: Record<string, unknown>;
     /** Current values for the entire form. */
     data: Record<string, unknown>;
+    /** The targeted record / document when available. */
+    doc?: Record<string, unknown>;
+    /** Array of targeted records for bulk action operations. */
+    docs?: Record<string, unknown>[];
+    /** Current authenticated user. */
+    user?: unknown;
 }
 type FieldAdminOptionsHookResult = Array<string | {
     label: string;
@@ -2955,4 +3104,4 @@ interface DyrectedConfig<TUser extends AuthenticatedUser = AuthenticatedUser> {
     }>;
 }
 
-export { type RadioField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailText as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailSchema as I, type ArrayField as J, type BlocksField as K, type LifecycleEventName as L, type BooleanField as M, type AuthConfig as N, type AccessPolicyResolver as O, type PublicAdminAuthConfig as P, type DateField as Q, type DateTimeField as R, type EmailField as S, type IconField as T, type ImageField as U, type JoinField as V, type WorkflowConfig as W, type JsonField as X, type MultiSelectField as Y, type NumberField as Z, type ObjectField as _, type DeclarativeHookExpression as a, type DynamicOptionItem as a$, type RelationshipField as a0, type RichTextField as a1, type RowField as a2, type SelectField as a3, type TextField as a4, type TextareaField as a5, type TimeField as a6, type UrlField as a7, type AccessConfig as a8, type AccessFunction as a9, type BooleanFormat as aA, type CharacterLimitFieldAdmin as aB, type CharacterLimitFieldConfig as aC, type CollectionAfterChangeHook as aD, type CollectionAfterDeleteHook as aE, type CollectionAfterReadHook as aF, type CollectionAfterReadHookEntry as aG, type CollectionAfterTransitionHook as aH, type CollectionBeforeChangeHook as aI, type CollectionBeforeChangeHookEntry as aJ, type CollectionBeforeDeleteHook as aK, type CollectionBeforeReadHook as aL, type CollectionBeforeReadHookEntry as aM, type CollectionBeforeTransitionHook as aN, type CollectionListComponentSlots as aO, type CountOperation as aP, type CustomAdminAuthProvider as aQ, type DatabaseAdapter as aR, type DateFieldAdmin as aS, type DateFormat as aT, type DefineActionOptions as aU, type DefineViewOptions as aV, type DetailSpan as aW, type DisplayTone as aX, type DisplayVariant as aY, type DistinctCountOperation as aZ, type DistinctValuesOperation as a_, type AccessFunctionArgs as aa, type AccessResult as ab, type AccessRule as ac, type ActionConfig as ad, type ActionContext as ae, type ActionType as af, type AdminAuthAccessResolution as ag, type AdminAuthClaimMapping as ah, type AdminAuthMember as ai, type AdminAuthProvider as aj, type AdminAuthProviderMembersConfig as ak, type AdminAuthProvisioningMode as al, type AdminAuthResolveAccessArgs as am, type AdminAuthResolvedIdentity as an, type AdminConfig as ao, type AdminDashboardComponentSlots as ap, type AdminIconName as aq, type AggregateArgs as ar, type AggregateCastType as as, type AggregateInput as at, type AggregateOperation as au, type AggregateResult as av, type BaseAdminAuthProvider as aw, type BaseFieldAdmin as ax, type BlockVariant as ay, type BooleanFieldAdmin as az, type AuthenticatedUser as b, type UploadConfig as b$, type DynamicOptionsConfig as b0, type DynamicOptionsResolver as b1, type DynamicOptionsResolverArgs as b2, type DyrectedLoggerConfig as b3, type DyrectedObservabilityConfig as b4, type EmailFieldAdmin as b5, type FieldAdminHooks as b6, type FieldAdminOnChangeHook as b7, type FieldAdminOnChangeHookArgs as b8, type FieldAdminOptionsHook as b9, LIFECYCLE_EVENT_NAMES as bA, type LifecycleEventHandler as bB, type LinkFormat as bC, type MetricColor as bD, type MultiSelectFieldAdmin as bE, type NamedAccessPolicy as bF, type NumberFieldAdmin as bG, type NumberFormat as bH, type NumberLimitFieldAdmin as bI, type NumberLimitFieldConfig as bJ, type NumericOperation as bK, type OIDCAdminAuthProvider as bL, type OptionFormat as bM, type PaginatedResult as bN, type PublicAdminAuthProvider as bO, type RadioFieldAdmin as bP, type RateLimitConfig as bQ, type ReadonlyDatabaseAdapter as bR, type RichTextFeature as bS, type RichTextFieldConfig as bT, type SelectFieldAdmin as bU, type StorageAdapter as bV, type TextFieldAdmin as bW, type TextFormat as bX, type TextareaFieldAdmin as bY, type TrustProxyConfig as bZ, type TypedField as b_, type FieldAdminOptionsHookArgs as ba, type FieldAdminOptionsHookResult as bb, type FieldAfterReadHook as bc, type FieldAfterReadHookArgs as bd, type FieldBase as be, type FieldBeforeChangeHook as bf, type FieldBeforeChangeHookArgs as bg, type FieldHook as bh, type FieldHooks as bi, type FieldType as bj, type FileData as bk, type GlobalAfterChangeHook as bl, type GlobalAfterReadHook as bm, type GlobalAfterReadHookEntry as bn, type GlobalBeforeChangeHook as bo, type GlobalBeforeChangeHookEntry as bp, type GlobalBeforeReadHook as bq, type GlobalBeforeReadHookEntry as br, type HeadingLevel as bs, type HookFunction as bt, type IconFieldAdmin as bu, type ImageService as bv, type InferAggregateResult as bw, type JoinFieldAdmin as bx, type JsonFieldAdmin as by, type JsonFormat as bz, type WorkflowTransition as c, type UrlFieldAdmin as c0, type UrlLinkValue as c1, type ViewActionFeatures as c2, type ViewConfig as c3, type ViewLayout as c4, type ViewMetric as c5, type ViewSubMetric as c6, type WordLimitFieldAdmin as c7, type WordLimitFieldConfig as c8, type WorkflowMetadata as c9, type WorkflowRole as ca, type WorkflowState as cb, type WorkflowTransitionContext as cc, defineAction as cd, defineView as ce, type LifecycleEvent as d, type BaseDocument as e, type DetailComputedOptions as f, type ComputedHandler as g, type DetailComputed as h, type DetailCustomOptions as i, type DetailCustom as j, type DetailDividerOptions as k, type DetailDivider as l, type DisplayFieldOptions as m, type DetailField as n, type DetailItem as o, type DetailGridOptions as p, type DetailGrid as q, type DetailRepeatOptions as r, type DetailRepeat as s, type DetailSectionOptions as t, type DetailSection as u, type DetailTabOptions as v, type DetailTab as w, type DetailTabsOptions as x, type DetailTabs as y, type DetailTextOptions as z };
+export { type RadioField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailText as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailSchema as I, type ArrayField as J, type BlocksField as K, type LifecycleEventName as L, type BooleanField as M, type AuthConfig as N, type AccessPolicyResolver as O, type PublicAdminAuthConfig as P, type DateField as Q, type DateTimeField as R, type EmailField as S, type IconField as T, type ImageField as U, type JoinField as V, type WorkflowConfig as W, type JsonField as X, type MultiSelectField as Y, type NumberField as Z, type ObjectField as _, type DeclarativeHookExpression as a, type DistinctValuesOperation as a$, type RelationshipField as a0, type RichTextField as a1, type RowField as a2, type SelectField as a3, type TextField as a4, type TextareaField as a5, type TimeField as a6, type UrlField as a7, type AccessConfig as a8, type AccessFunction as a9, type BooleanFormat as aA, type CharacterLimitFieldAdmin as aB, type CharacterLimitFieldConfig as aC, type CollectionAfterChangeHook as aD, type CollectionAfterDeleteHook as aE, type CollectionAfterReadHook as aF, type CollectionAfterReadHookEntry as aG, type CollectionAfterTransitionHook as aH, type CollectionBeforeChangeHook as aI, type CollectionBeforeChangeHookEntry as aJ, type CollectionBeforeDeleteHook as aK, type CollectionBeforeReadHook as aL, type CollectionBeforeReadHookEntry as aM, type CollectionBeforeTransitionHook as aN, type CollectionListComponentSlots as aO, type CollectionViewComponentSlots as aP, type CountOperation as aQ, type CustomAdminAuthProvider as aR, type DatabaseAdapter as aS, type DateFieldAdmin as aT, type DateFormat as aU, type DefineActionOptions as aV, type DefineViewOptions as aW, type DetailSpan as aX, type DisplayTone as aY, type DisplayVariant as aZ, type DistinctCountOperation as a_, type AccessFunctionArgs as aa, type AccessResult as ab, type AccessRule as ac, type ActionConfig as ad, type ActionContext as ae, type ActionType as af, type AdminAuthAccessResolution as ag, type AdminAuthClaimMapping as ah, type AdminAuthMember as ai, type AdminAuthProvider as aj, type AdminAuthProviderMembersConfig as ak, type AdminAuthProvisioningMode as al, type AdminAuthResolveAccessArgs as am, type AdminAuthResolvedIdentity as an, type AdminConfig as ao, type AdminDashboardComponentSlots as ap, type AdminIconName as aq, type AggregateArgs as ar, type AggregateCastType as as, type AggregateInput as at, type AggregateOperation as au, type AggregateResult as av, type BaseAdminAuthProvider as aw, type BaseFieldAdmin as ax, type BlockVariant as ay, type BooleanFieldAdmin as az, type AuthenticatedUser as b, type TrustProxyConfig as b$, type DynamicOptionItem as b0, type DynamicOptionsConfig as b1, type DynamicOptionsResolver as b2, type DynamicOptionsResolverArgs as b3, type DyrectedLoggerConfig as b4, type DyrectedObservabilityConfig as b5, type EmailFieldAdmin as b6, type FieldAdminHooks as b7, type FieldAdminOnChangeHook as b8, type FieldAdminOnChangeHookArgs as b9, type JsonFormat as bA, LIFECYCLE_EVENT_NAMES as bB, type LifecycleEventHandler as bC, type LinkFormat as bD, type MetricColor as bE, type MultiSelectFieldAdmin as bF, type NamedAccessPolicy as bG, type NumberFieldAdmin as bH, type NumberFormat as bI, type NumberLimitFieldAdmin as bJ, type NumberLimitFieldConfig as bK, type NumericOperation as bL, type OIDCAdminAuthProvider as bM, type OptionFormat as bN, type PaginatedResult as bO, type PublicAdminAuthProvider as bP, type RadioFieldAdmin as bQ, type RateLimitConfig as bR, type ReadonlyDatabaseAdapter as bS, type RichTextFeature as bT, type RichTextFieldConfig as bU, type SelectFieldAdmin as bV, type SqlWhereResult as bW, type StorageAdapter as bX, type TextFieldAdmin as bY, type TextFormat as bZ, type TextareaFieldAdmin as b_, type FieldAdminOptionsHook as ba, type FieldAdminOptionsHookArgs as bb, type FieldAdminOptionsHookResult as bc, type FieldAfterReadHook as bd, type FieldAfterReadHookArgs as be, type FieldBase as bf, type FieldBeforeChangeHook as bg, type FieldBeforeChangeHookArgs as bh, type FieldHook as bi, type FieldHooks as bj, type FieldType as bk, type FileData as bl, type GlobalAfterChangeHook as bm, type GlobalAfterReadHook as bn, type GlobalAfterReadHookEntry as bo, type GlobalBeforeChangeHook as bp, type GlobalBeforeChangeHookEntry as bq, type GlobalBeforeReadHook as br, type GlobalBeforeReadHookEntry as bs, type HeadingLevel as bt, type HookFunction as bu, type IconFieldAdmin as bv, type ImageService as bw, type InferAggregateResult as bx, type JoinFieldAdmin as by, type JsonFieldAdmin as bz, type WorkflowTransition as c, type TypedField as c0, type UploadConfig as c1, type UrlFieldAdmin as c2, type UrlLinkValue as c3, type ViewActionFeatures as c4, type ViewComponentSlots as c5, type ViewConfig as c6, type ViewLayout as c7, type ViewMetric as c8, type ViewSubMetric as c9, type WhereClause as ca, type WhereOperator as cb, type WhereOperatorName as cc, type WordLimitFieldAdmin as cd, type WordLimitFieldConfig as ce, type WorkflowMetadata as cf, type WorkflowRole as cg, type WorkflowState as ch, type WorkflowTransitionContext as ci, defineAction as cj, defineView as ck, parseMongoWhere as cl, parseSqlWhere as cm, type LifecycleEvent as d, type BaseDocument as e, type DetailComputedOptions as f, type ComputedHandler as g, type DetailComputed as h, type DetailCustomOptions as i, type DetailCustom as j, type DetailDividerOptions as k, type DetailDivider as l, type DisplayFieldOptions as m, type DetailField as n, type DetailItem as o, type DetailGridOptions as p, type DetailGrid as q, type DetailRepeatOptions as r, type DetailRepeat as s, type DetailSectionOptions as t, type DetailSection as u, type DetailTabOptions as v, type DetailTab as w, type DetailTabsOptions as x, type DetailTabs as y, type DetailTextOptions as z };

package/dist/{app-config-DQhcrGDE.d.ts → app-config-6U_Kum-Z.d.ts}

@@ -162,12 +162,24 @@ interface AdminDashboardComponentSlots {
     beforeDashboard?: string[];
     afterDashboard?: string[];
 }
+/** Ordered custom component keys rendered around an operational view's content. */
+interface CollectionViewComponentSlots {
+    beforeViewHeader?: string[];
+    afterViewHeader?: string[];
+    beforeViewContent?: string[];
+    afterViewContent?: string[];
+}
 /** Ordered custom component keys rendered around a collection's list content. */
 interface CollectionListComponentSlots {
     beforeList?: string[];
     beforeListTable?: string[];
     afterListTable?: string[];
     afterList?: string[];
+    beforeViewHeader?: string[];
+    afterViewHeader?: string[];
+    beforeViewContent?: string[];
+    afterViewContent?: string[];
+    collectionView?: CollectionViewComponentSlots;
 }
 /**
  * Branding and metadata options for the Dyrected Admin UI.
@@ -944,6 +956,95 @@ type InferAggregateResult<T extends AggregateInput> = {
     [K in keyof T]: any;
 };
 
+/**
+ * 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[];
+    or?: WhereClause[];
+    AND?: 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>;
+
+/**
+ * Custom component slots rendered around an operational view's content.
+ */
+type ViewComponentSlots = CollectionViewComponentSlots;
 /**
  * Supported layout engines for operational views in the Dyrected Admin UI:
  * - `'table'`: The workhorse — column sorting, search, faceted filters, and bulk actions.
@@ -1072,7 +1173,7 @@ interface ViewConfig {
     /** Layout engine to render: `'table' | 'spreadsheet' | 'kanban' | 'calendar' | 'gantt' | 'cards'`. Defaults to `'table'`. */
     layout?: ViewLayout;
     /** Base query filter applied before user toolbar filters (e.g. `{ attending: { equals: true } }` or JEXL string). */
-    filter?: Record<string, any> | string;
+    filter?: WhereClause | string;
     /** Field name used to organize records into kanban columns or collapsible grouped sections in table, cards, and spreadsheet. */
     groupBy?: string;
     /** Field name containing the ISO date string for calendar placement. Required when `layout: 'calendar'`. */
@@ -1110,6 +1211,8 @@ interface ActionConfig<TDoc extends Record<string, unknown> = Record<string, unk
     name: string;
     /** Button label displayed in the UI. */
     label: string;
+    /** Optional custom label for the modal submit button (defaults to "Run" or "Confirm"). */
+    submitLabel?: string;
     /** Lucide icon name for the button (e.g. `"UserCheck"`, `"CheckCircle"`). */
     icon?: string;
     /** Action placement: `'row'` (per-row), `'bulk'` (multi-row selection bar), or `'header'` (view header). Defaults to `'row'`. */
@@ -1203,6 +1306,8 @@ interface DefineViewOptions {
     actionOrder?: string[];
     /** KPI summary cards rendered in the hero row above the view. */
     metrics?: ViewMetric[];
+    /** Custom component slots rendered around this operational view. */
+    components?: ViewComponentSlots;
     /** Role-based access rules controlling who can see or use this view. */
     access?: AccessConfig;
 }
@@ -1635,9 +1740,31 @@ interface CollectionConfig<TDoc extends object = Record<string, unknown>> {
         urlPattern?: string;
     };
     /**
-     * Custom detail view layout configuration for the Admin UI.
+     * Detail view layout configuration for the Admin UI.
+     *
+     * By default, collections are **Edit-First** (`detail: false`). Clicking a record in the
+     * table or cards view navigates directly to the editing form with Live Preview.
+     *
+     * Set to `true` to enable the automatic read-only summary layout, or provide a `DetailSchema`
+     * array using display helpers (`displaySection`, `displayField`, `displayTabs`, etc.) for a
+     * custom operational dashboard layout.
+     *
+     * @default false
+     * @example
+     * ```ts
+     * // Enable automatic summary detail view
+     * detail: true
+     *
+     * // Or define a custom operational detail view
+     * detail: [
+     *   displaySection("Customer Overview", [
+     *     displayField("name", { span: 8 }),
+     *     displayField("status", { span: 4, display: "badge" }),
+     *   ]),
+     * ]
+     * ```
      */
-    detail?: DetailSchema<TDoc> | false;
+    detail?: DetailSchema<TDoc> | boolean;
     /**
      * Slug of the operational view to render by default when navigating to `/collections/:slug`.
      *
@@ -1763,9 +1890,17 @@ interface GlobalConfig<TDoc extends object = Record<string, unknown>> {
      */
     initialData?: Partial<TDoc>;
     /**
-     * Custom detail view layout configuration for the Admin UI.
+     * Detail view layout configuration for the Admin UI.
+     *
+     * By default, globals are **Edit-First** (`detail: false`). Clicking the global in the
+     * sidebar navigates directly to the editing form.
+     *
+     * Set to `true` to enable the automatic read-only summary layout, or provide a `DetailSchema`
+     * array for a custom operational dashboard layout.
+     *
+     * @default false
      */
-    detail?: DetailSchema<TDoc> | false;
+    detail?: DetailSchema<TDoc> | boolean;
 }
 
 /**
@@ -2106,6 +2241,12 @@ interface FieldAdminOnChangeHookArgs<TValue = unknown> {
     siblingData: Record<string, unknown>;
     /** Current values for the entire form. */
     data: Record<string, unknown>;
+    /** The targeted record / document when available. */
+    doc?: Record<string, unknown>;
+    /** Array of targeted records for bulk action operations. */
+    docs?: Record<string, unknown>[];
+    /** Current authenticated user. */
+    user?: unknown;
     /** Imperative setter for async or derived updates. */
     setValue: (value: unknown) => void;
 }
@@ -2118,10 +2259,18 @@ type FieldAdminHooks<TValue> = {
     };
 };
 interface FieldAdminOptionsHookArgs {
+    /** Current field value in the form state (if set). */
+    value?: unknown;
     /** Current values for sibling fields at the same nesting level. */
     siblingData: Record<string, unknown>;
     /** Current values for the entire form. */
     data: Record<string, unknown>;
+    /** The targeted record / document when available. */
+    doc?: Record<string, unknown>;
+    /** Array of targeted records for bulk action operations. */
+    docs?: Record<string, unknown>[];
+    /** Current authenticated user. */
+    user?: unknown;
 }
 type FieldAdminOptionsHookResult = Array<string | {
     label: string;
@@ -2955,4 +3104,4 @@ interface DyrectedConfig<TUser extends AuthenticatedUser = AuthenticatedUser> {
     }>;
 }
 
-export { type RadioField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailText as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailSchema as I, type ArrayField as J, type BlocksField as K, type LifecycleEventName as L, type BooleanField as M, type AuthConfig as N, type AccessPolicyResolver as O, type PublicAdminAuthConfig as P, type DateField as Q, type DateTimeField as R, type EmailField as S, type IconField as T, type ImageField as U, type JoinField as V, type WorkflowConfig as W, type JsonField as X, type MultiSelectField as Y, type NumberField as Z, type ObjectField as _, type DeclarativeHookExpression as a, type DynamicOptionItem as a$, type RelationshipField as a0, type RichTextField as a1, type RowField as a2, type SelectField as a3, type TextField as a4, type TextareaField as a5, type TimeField as a6, type UrlField as a7, type AccessConfig as a8, type AccessFunction as a9, type BooleanFormat as aA, type CharacterLimitFieldAdmin as aB, type CharacterLimitFieldConfig as aC, type CollectionAfterChangeHook as aD, type CollectionAfterDeleteHook as aE, type CollectionAfterReadHook as aF, type CollectionAfterReadHookEntry as aG, type CollectionAfterTransitionHook as aH, type CollectionBeforeChangeHook as aI, type CollectionBeforeChangeHookEntry as aJ, type CollectionBeforeDeleteHook as aK, type CollectionBeforeReadHook as aL, type CollectionBeforeReadHookEntry as aM, type CollectionBeforeTransitionHook as aN, type CollectionListComponentSlots as aO, type CountOperation as aP, type CustomAdminAuthProvider as aQ, type DatabaseAdapter as aR, type DateFieldAdmin as aS, type DateFormat as aT, type DefineActionOptions as aU, type DefineViewOptions as aV, type DetailSpan as aW, type DisplayTone as aX, type DisplayVariant as aY, type DistinctCountOperation as aZ, type DistinctValuesOperation as a_, type AccessFunctionArgs as aa, type AccessResult as ab, type AccessRule as ac, type ActionConfig as ad, type ActionContext as ae, type ActionType as af, type AdminAuthAccessResolution as ag, type AdminAuthClaimMapping as ah, type AdminAuthMember as ai, type AdminAuthProvider as aj, type AdminAuthProviderMembersConfig as ak, type AdminAuthProvisioningMode as al, type AdminAuthResolveAccessArgs as am, type AdminAuthResolvedIdentity as an, type AdminConfig as ao, type AdminDashboardComponentSlots as ap, type AdminIconName as aq, type AggregateArgs as ar, type AggregateCastType as as, type AggregateInput as at, type AggregateOperation as au, type AggregateResult as av, type BaseAdminAuthProvider as aw, type BaseFieldAdmin as ax, type BlockVariant as ay, type BooleanFieldAdmin as az, type AuthenticatedUser as b, type UploadConfig as b$, type DynamicOptionsConfig as b0, type DynamicOptionsResolver as b1, type DynamicOptionsResolverArgs as b2, type DyrectedLoggerConfig as b3, type DyrectedObservabilityConfig as b4, type EmailFieldAdmin as b5, type FieldAdminHooks as b6, type FieldAdminOnChangeHook as b7, type FieldAdminOnChangeHookArgs as b8, type FieldAdminOptionsHook as b9, LIFECYCLE_EVENT_NAMES as bA, type LifecycleEventHandler as bB, type LinkFormat as bC, type MetricColor as bD, type MultiSelectFieldAdmin as bE, type NamedAccessPolicy as bF, type NumberFieldAdmin as bG, type NumberFormat as bH, type NumberLimitFieldAdmin as bI, type NumberLimitFieldConfig as bJ, type NumericOperation as bK, type OIDCAdminAuthProvider as bL, type OptionFormat as bM, type PaginatedResult as bN, type PublicAdminAuthProvider as bO, type RadioFieldAdmin as bP, type RateLimitConfig as bQ, type ReadonlyDatabaseAdapter as bR, type RichTextFeature as bS, type RichTextFieldConfig as bT, type SelectFieldAdmin as bU, type StorageAdapter as bV, type TextFieldAdmin as bW, type TextFormat as bX, type TextareaFieldAdmin as bY, type TrustProxyConfig as bZ, type TypedField as b_, type FieldAdminOptionsHookArgs as ba, type FieldAdminOptionsHookResult as bb, type FieldAfterReadHook as bc, type FieldAfterReadHookArgs as bd, type FieldBase as be, type FieldBeforeChangeHook as bf, type FieldBeforeChangeHookArgs as bg, type FieldHook as bh, type FieldHooks as bi, type FieldType as bj, type FileData as bk, type GlobalAfterChangeHook as bl, type GlobalAfterReadHook as bm, type GlobalAfterReadHookEntry as bn, type GlobalBeforeChangeHook as bo, type GlobalBeforeChangeHookEntry as bp, type GlobalBeforeReadHook as bq, type GlobalBeforeReadHookEntry as br, type HeadingLevel as bs, type HookFunction as bt, type IconFieldAdmin as bu, type ImageService as bv, type InferAggregateResult as bw, type JoinFieldAdmin as bx, type JsonFieldAdmin as by, type JsonFormat as bz, type WorkflowTransition as c, type UrlFieldAdmin as c0, type UrlLinkValue as c1, type ViewActionFeatures as c2, type ViewConfig as c3, type ViewLayout as c4, type ViewMetric as c5, type ViewSubMetric as c6, type WordLimitFieldAdmin as c7, type WordLimitFieldConfig as c8, type WorkflowMetadata as c9, type WorkflowRole as ca, type WorkflowState as cb, type WorkflowTransitionContext as cc, defineAction as cd, defineView as ce, type LifecycleEvent as d, type BaseDocument as e, type DetailComputedOptions as f, type ComputedHandler as g, type DetailComputed as h, type DetailCustomOptions as i, type DetailCustom as j, type DetailDividerOptions as k, type DetailDivider as l, type DisplayFieldOptions as m, type DetailField as n, type DetailItem as o, type DetailGridOptions as p, type DetailGrid as q, type DetailRepeatOptions as r, type DetailRepeat as s, type DetailSectionOptions as t, type DetailSection as u, type DetailTabOptions as v, type DetailTab as w, type DetailTabsOptions as x, type DetailTabs as y, type DetailTextOptions as z };
+export { type RadioField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailText as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailSchema as I, type ArrayField as J, type BlocksField as K, type LifecycleEventName as L, type BooleanField as M, type AuthConfig as N, type AccessPolicyResolver as O, type PublicAdminAuthConfig as P, type DateField as Q, type DateTimeField as R, type EmailField as S, type IconField as T, type ImageField as U, type JoinField as V, type WorkflowConfig as W, type JsonField as X, type MultiSelectField as Y, type NumberField as Z, type ObjectField as _, type DeclarativeHookExpression as a, type DistinctValuesOperation as a$, type RelationshipField as a0, type RichTextField as a1, type RowField as a2, type SelectField as a3, type TextField as a4, type TextareaField as a5, type TimeField as a6, type UrlField as a7, type AccessConfig as a8, type AccessFunction as a9, type BooleanFormat as aA, type CharacterLimitFieldAdmin as aB, type CharacterLimitFieldConfig as aC, type CollectionAfterChangeHook as aD, type CollectionAfterDeleteHook as aE, type CollectionAfterReadHook as aF, type CollectionAfterReadHookEntry as aG, type CollectionAfterTransitionHook as aH, type CollectionBeforeChangeHook as aI, type CollectionBeforeChangeHookEntry as aJ, type CollectionBeforeDeleteHook as aK, type CollectionBeforeReadHook as aL, type CollectionBeforeReadHookEntry as aM, type CollectionBeforeTransitionHook as aN, type CollectionListComponentSlots as aO, type CollectionViewComponentSlots as aP, type CountOperation as aQ, type CustomAdminAuthProvider as aR, type DatabaseAdapter as aS, type DateFieldAdmin as aT, type DateFormat as aU, type DefineActionOptions as aV, type DefineViewOptions as aW, type DetailSpan as aX, type DisplayTone as aY, type DisplayVariant as aZ, type DistinctCountOperation as a_, type AccessFunctionArgs as aa, type AccessResult as ab, type AccessRule as ac, type ActionConfig as ad, type ActionContext as ae, type ActionType as af, type AdminAuthAccessResolution as ag, type AdminAuthClaimMapping as ah, type AdminAuthMember as ai, type AdminAuthProvider as aj, type AdminAuthProviderMembersConfig as ak, type AdminAuthProvisioningMode as al, type AdminAuthResolveAccessArgs as am, type AdminAuthResolvedIdentity as an, type AdminConfig as ao, type AdminDashboardComponentSlots as ap, type AdminIconName as aq, type AggregateArgs as ar, type AggregateCastType as as, type AggregateInput as at, type AggregateOperation as au, type AggregateResult as av, type BaseAdminAuthProvider as aw, type BaseFieldAdmin as ax, type BlockVariant as ay, type BooleanFieldAdmin as az, type AuthenticatedUser as b, type TrustProxyConfig as b$, type DynamicOptionItem as b0, type DynamicOptionsConfig as b1, type DynamicOptionsResolver as b2, type DynamicOptionsResolverArgs as b3, type DyrectedLoggerConfig as b4, type DyrectedObservabilityConfig as b5, type EmailFieldAdmin as b6, type FieldAdminHooks as b7, type FieldAdminOnChangeHook as b8, type FieldAdminOnChangeHookArgs as b9, type JsonFormat as bA, LIFECYCLE_EVENT_NAMES as bB, type LifecycleEventHandler as bC, type LinkFormat as bD, type MetricColor as bE, type MultiSelectFieldAdmin as bF, type NamedAccessPolicy as bG, type NumberFieldAdmin as bH, type NumberFormat as bI, type NumberLimitFieldAdmin as bJ, type NumberLimitFieldConfig as bK, type NumericOperation as bL, type OIDCAdminAuthProvider as bM, type OptionFormat as bN, type PaginatedResult as bO, type PublicAdminAuthProvider as bP, type RadioFieldAdmin as bQ, type RateLimitConfig as bR, type ReadonlyDatabaseAdapter as bS, type RichTextFeature as bT, type RichTextFieldConfig as bU, type SelectFieldAdmin as bV, type SqlWhereResult as bW, type StorageAdapter as bX, type TextFieldAdmin as bY, type TextFormat as bZ, type TextareaFieldAdmin as b_, type FieldAdminOptionsHook as ba, type FieldAdminOptionsHookArgs as bb, type FieldAdminOptionsHookResult as bc, type FieldAfterReadHook as bd, type FieldAfterReadHookArgs as be, type FieldBase as bf, type FieldBeforeChangeHook as bg, type FieldBeforeChangeHookArgs as bh, type FieldHook as bi, type FieldHooks as bj, type FieldType as bk, type FileData as bl, type GlobalAfterChangeHook as bm, type GlobalAfterReadHook as bn, type GlobalAfterReadHookEntry as bo, type GlobalBeforeChangeHook as bp, type GlobalBeforeChangeHookEntry as bq, type GlobalBeforeReadHook as br, type GlobalBeforeReadHookEntry as bs, type HeadingLevel as bt, type HookFunction as bu, type IconFieldAdmin as bv, type ImageService as bw, type InferAggregateResult as bx, type JoinFieldAdmin as by, type JsonFieldAdmin as bz, type WorkflowTransition as c, type TypedField as c0, type UploadConfig as c1, type UrlFieldAdmin as c2, type UrlLinkValue as c3, type ViewActionFeatures as c4, type ViewComponentSlots as c5, type ViewConfig as c6, type ViewLayout as c7, type ViewMetric as c8, type ViewSubMetric as c9, type WhereClause as ca, type WhereOperator as cb, type WhereOperatorName as cc, type WordLimitFieldAdmin as cd, type WordLimitFieldConfig as ce, type WorkflowMetadata as cf, type WorkflowRole as cg, type WorkflowState as ch, type WorkflowTransitionContext as ci, defineAction as cj, defineView as ck, parseMongoWhere as cl, parseSqlWhere as cm, type LifecycleEvent as d, type BaseDocument as e, type DetailComputedOptions as f, type ComputedHandler as g, type DetailComputed as h, type DetailCustomOptions as i, type DetailCustom as j, type DetailDividerOptions as k, type DetailDivider as l, type DisplayFieldOptions as m, type DetailField as n, type DetailItem as o, type DetailGridOptions as p, type DetailGrid as q, type DetailRepeatOptions as r, type DetailRepeat as s, type DetailSectionOptions as t, type DetailSection as u, type DetailTabOptions as v, type DetailTab as w, type DetailTabsOptions as x, type DetailTabs as y, type DetailTextOptions as z };

package/dist/{chunk-TYPDQTE2.js → chunk-H7DVVW2P.js}

@@ -2474,6 +2474,11 @@ function registerJexlHelpers(jexlInstance = import_jexl.default) {
   try {
     jexlInstance.addBinaryOp("and", 20, (left, right) => Boolean(left && right));
     jexlInstance.addBinaryOp("or", 10, (left, right) => Boolean(left || right));
+    jexlInstance.addBinaryOp("in", 30, (left, right) => {
+      if (Array.isArray(right)) return right.includes(left);
+      if (typeof right === "string") return right.includes(String(left ?? ""));
+      return false;
+    });
   } catch {
   }
 }