@dyrected/core 2.16.0 → 2.18.0

package/dist/{app-KSDgfXsw.d.cts → app-Dd9cBbCs.d.cts}

@@ -446,1356 +446,1529 @@ declare const AI_ACTIONS_COLLECTION = "_dyrected_ai_actions";
 declare const AI_AUDIT_COLLECTION = "_dyrected_ai_audit";
 declare function isAICollection(slug: string): boolean;
 
-/** A valid icon component name from the Lucide icon set bundled with Dyrected Admin. */
-type AdminIconName = keyof typeof icons;
-/** Ordered custom component keys rendered around the built-in Admin dashboard. */
-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.
+ * The set of type-cast operations supported during aggregation.
  *
- * @example
- * admin: {
- *   branding: {
- *     logo: '/logo.svg',
- *     primaryColor: '#6366f1',
- *   },
- *   meta: {
- *     titleSuffix: '- My App',
- *   },
- * }
- */
-interface AdminConfig {
-    /** Custom component slots around the built-in dashboard. */
-    components?: AdminDashboardComponentSlots;
-    branding?: {
-        /** Full logo image shown in the expanded sidebar. URL or imported image asset. */
-        logo?: string;
-        /** Compact logo mark used in the collapsed sidebar state. */
-        logoMark?: string;
-        /** Text alternative or addition to the logo image. */
-        logoText?: string;
-        /**
-         * Brand colour used for committed, filled actions — Save, Create, Upload —
-         * and active/selected states. Accepts a hex string, a named colour
-         * (`amber`, `lime`, `violet`, `green`, `blue`, `red`, `purple`, `orange`),
-         * or a raw HSL triplet (`"217 91% 60%"`). Applied in both light and dark mode.
-         *
-         * This is one half of the two-colour brand model. Use {@link accentColor}
-         * for links and navigation accents. If you only set `primaryColor`, it is
-         * reused for accents too, matching the single-brand-colour look.
-         * @example '#6366f1'
-         * @example 'blue'
-         * @example 'hsl(240 50% 60%)'
-         */
-        primaryColor?: string;
-        /**
-         * Brand colour used for links, active navigation details, hover text, and
-         * focus rings — the "accent" half of the two-colour brand model, mapped to
-         * the admin's `--intelligence` token. Accepts the same formats as
-         * {@link primaryColor} and applies in both light and dark mode.
-         *
-         * Set this when your brand has a distinct link/accent colour separate from
-         * your primary action colour. When omitted, accents fall back to
-         * `primaryColor` (if set) or the built-in default.
-         * @example '#8b5cf6'
-         * @example 'violet'
-         */
-        accentColor?: string;
-        /** Browser tab favicon URL. */
-        favicon?: string;
-        /** Font family for body and UI text. Must be loaded separately. */
-        fontSans?: string;
-        /** Font family for headings. Must be loaded separately. */
-        fontSerif?: string;
-    };
-    meta?: {
-        /**
-         * String appended to every Admin page's `<title>`.
-         * @default '- Dyrected'
-         */
-        titleSuffix?: string;
-    };
-    /**
-     * The canonical/base URL of the frontend website for links and iframe live previews.
-     */
-    siteUrl?: string;
-}
-
-type DeclarativeHookExpression = string;
-/**
- * @deprecated Use {@link FieldBeforeChangeHook} or `FieldAfterReadHook` instead.
- * This alias remains for backwards compatibility.
+ * Each adapter maps these to its own native conversion primitive
+ * (e.g. `$toDouble` in MongoDB, `CAST(x AS REAL)` in SQLite).
+ * The public API is always database-independent.
  */
-type FieldHook<TDoc extends object = Record<string, unknown>, TValue = unknown> = FieldBeforeChangeHook<TValue, TDoc>;
+type AggregateCastType = "number" | "integer" | "float" | "string" | "boolean" | "date";
 /**
- * Runs before Dyrected queries the database for a list or single-document fetch.
+ * A `count` aggregate operation.
  *
- * Return a new `where` query object to override or extend the current filter.
- * Return `undefined` (or nothing) to leave the query unchanged.
+ * - `count: "*"` — count every document matched by `where`.
+ * - `cast` is intentionally absent: counting is document-level,
+ *   not field-value-level, so type conversion has no meaning here.
  */
-type CollectionBeforeReadHook = (args: {
-    req: HookRequestContext;
-    query?: Record<string, unknown>;
-    user?: AuthenticatedUser;
-    db: ReadonlyDatabaseAdapter;
-}) => Record<string, unknown> | void | Promise<Record<string, unknown> | void>;
-type CollectionBeforeReadHookEntry = CollectionBeforeReadHook | DeclarativeHookExpression;
+interface CountOperation {
+    count: "*";
+    where?: Record<string, unknown>;
+}
 /**
- * Runs after a document (or list of documents) is fetched from the database,
- * before the response is sent to the client.
+ * A `countDistinct` aggregate operation that counts the number of unique
+ * non-null values for a specific field.
  */
-type CollectionAfterReadHook<TDoc extends object = Record<string, unknown>> = (args: {
-    doc: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    db: ReadonlyDatabaseAdapter;
-}) => TDoc | Promise<TDoc>;
-type CollectionAfterReadHookEntry<TDoc extends object = Record<string, unknown>> = CollectionAfterReadHook<TDoc> | DeclarativeHookExpression;
+interface DistinctCountOperation {
+    countDistinct: string;
+    where?: Record<string, unknown>;
+}
 /**
- * Runs **before** a document is created or updated in the database.
+ * A `distinct` aggregate operation that retrieves the unique values
+ * (or unique values with item counts) for a specific field.
  */
-type CollectionBeforeChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
-    data: Partial<TDoc>;
-    doc?: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    operation: "create" | "update";
-    db: ReadonlyDatabaseAdapter;
-}) => Partial<TDoc> | void | Promise<Partial<TDoc> | void>;
-type CollectionBeforeChangeHookEntry<TDoc extends object = Record<string, unknown>> = CollectionBeforeChangeHook<TDoc> | DeclarativeHookExpression;
+interface DistinctValuesOperation {
+    distinct: string;
+    where?: Record<string, unknown>;
+}
 /**
- * Runs **after** a document is created or updated in the database.
+ * A `sum`, `avg`, `min`, or `max` aggregate operation on a named field.
+ *
+ * - `cast` converts stored values before the aggregation runs.
+ *   Invalid values (e.g. `"unknown"` cast to `number`) become `null`
+ *   and are ignored by `sum`, `avg`, `min`, and `max`.
  */
-type CollectionAfterChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
-    doc: TDoc;
-    previousDoc?: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    operation: "create" | "update";
-    db: DatabaseAdapter;
-}) => void | Promise<void>;
+interface NumericOperation {
+    sum?: string;
+    avg?: string;
+    min?: string;
+    max?: string;
+    cast?: AggregateCastType;
+    where?: Record<string, unknown>;
+}
 /**
- * Runs **before** a document is deleted from the database.
+ * A single named aggregate request — either a count, distinct count, distinct values, or numeric operation.
  */
-type CollectionBeforeDeleteHook<TDoc extends object = Record<string, unknown>> = (args: {
-    id: string;
-    doc: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    db: ReadonlyDatabaseAdapter;
-}) => void | Promise<void>;
+type AggregateOperation = CountOperation | DistinctCountOperation | DistinctValuesOperation | NumericOperation;
 /**
- * Runs **after** a document has been deleted from the database.
+ * The map of named aggregate operations sent in a single aggregate request.
+ *
+ * @example
+ * ```ts
+ * {
+ *   totalSubmitted: { count: "*" },
+ *   uniqueGuests: { countDistinct: "email" },
+ *   availableSizes: { distinct: "asoebiSize" },
+ *   totalAsoebiYards: { sum: "asoebiYards", cast: "number", where: { wantsAsoebi: { equals: true } } },
+ * }
+ * ```
  */
-type CollectionAfterDeleteHook<TDoc extends object = Record<string, unknown>> = (args: {
-    id: string;
-    doc: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    db: DatabaseAdapter;
-}) => void | Promise<void>;
-/** @see {@link CollectionBeforeReadHook} */
-type GlobalBeforeReadHook = CollectionBeforeReadHook;
-type GlobalBeforeReadHookEntry = CollectionBeforeReadHookEntry;
+type AggregateInput = Record<string, AggregateOperation>;
 /**
- * Runs after the global document is fetched, before the response is sent.
+ * The arguments passed to `DatabaseAdapter.aggregate`.
  */
-type GlobalAfterReadHook<TDoc extends object = Record<string, unknown>> = (args: {
-    doc: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    db: ReadonlyDatabaseAdapter;
-}) => TDoc | Promise<TDoc>;
-type GlobalAfterReadHookEntry<TDoc extends object = Record<string, unknown>> = GlobalAfterReadHook<TDoc> | DeclarativeHookExpression;
+interface AggregateArgs {
+    /** Collection slug. */
+    collection: string;
+    /** Named aggregate operations to compute. */
+    aggregates: AggregateInput;
+    /** Optional field to group the aggregates by. */
+    groupBy?: string;
+}
 /**
- * Runs before the global document is updated.
- * Operation is always `'update'` (globals cannot be created or deleted).
+ * The result returned by `DatabaseAdapter.aggregate`.
+ *
+ * For scalar aggregates, every named key maps to a `number | null` or `any[]` (for distinct).
+ * When `groupBy` is used, returns a breakdown per group.
  */
-type GlobalBeforeChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
-    data: Partial<TDoc>;
-    doc?: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    operation: "update";
-    db: ReadonlyDatabaseAdapter;
-}) => Partial<TDoc> | void | Promise<Partial<TDoc> | void>;
-type GlobalBeforeChangeHookEntry<TDoc extends object = Record<string, unknown>> = GlobalBeforeChangeHook<TDoc> | DeclarativeHookExpression;
+type AggregateResult = Record<string, any>;
 /**
- * Runs after the global document is updated. Side-effects only.
+ * Derives the typed result shape from an `AggregateInput`.
  */
-type GlobalAfterChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
-    doc: TDoc;
-    previousDoc?: TDoc;
-    req: HookRequestContext;
-    user?: AuthenticatedUser;
-    operation: "update";
-    db: DatabaseAdapter;
-}) => void | Promise<void>;
+type InferAggregateResult<T extends AggregateInput> = {
+    [K in keyof T]: any;
+};
+
 /**
- * @deprecated Use the specific hook types instead:
- * `CollectionBeforeChangeHook`, `CollectionAfterReadHook`, etc.
+ * Dyrected Where Clause DSL — shared query language across all database adapters.
  *
- * This broad type remains for backwards compatibility with the internal hook runner.
+ * 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 HookFunction<TDoc extends object = Record<string, unknown>> = (args: {
-    data?: Partial<TDoc>;
-    doc?: TDoc;
-    user?: AuthenticatedUser;
-    req?: HookRequestContext;
-    operation?: "create" | "update" | "delete";
-    db?: DatabaseAdapter;
-    [key: string]: unknown;
-}) => unknown | Promise<unknown>;
+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[] | readonly WhereClause[];
+    or?: WhereClause[] | readonly WhereClause[];
+    AND?: WhereClause[] | readonly WhereClause[];
+    and?: WhereClause[] | readonly 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>;
+/**
+ * Turns the strings "true"/"false" into booleans for the fields the schema declares as boolean.
+ *
+ * Adapters bind booleans natively (1/0, `true`, BSON bool), but a client that sends the string
+ * `"true"` would otherwise match nothing on some adapters and the wrong rows on others (Postgres
+ * serializes any non-`true` value to `false` for a boolean column). Coercing once, before the
+ * where clause is translated, gives every adapter the same behavior. Fields that are not
+ * declared boolean are left untouched.
+ */
+declare function coerceBooleanWhere(where: WhereClause, fields: ReadonlyArray<{
+    name?: string;
+    type?: string;
+}> | undefined): WhereClause;
 
-declare const LIFECYCLE_EVENT_NAMES: readonly ["revision.created", "workflow.transitioned", "entry.published", "entry.unpublished"];
-type LifecycleEventName = (typeof LIFECYCLE_EVENT_NAMES)[number];
-interface WorkflowState {
-    /** Stable machine-readable state key. */
-    name: string;
-    /** Label rendered in the Admin UI. */
+/**
+ * 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.
+ * - `'spreadsheet'`: Inline-editable matrix with batch saving (`Save changes` / `Discard`).
+ * - `'kanban'`: Interactive card board grouped by status or category with drag-and-drop.
+ * - `'calendar'`: Event schedule grid plotting records across month/week/day views by date.
+ * - `'gantt'`: Timeline bars plotted across start and end dates.
+ * - `'cards'`: Visual image/thumbnail gallery grid.
+ */
+type ViewLayout = 'table' | 'spreadsheet' | 'kanban' | 'calendar' | 'gantt' | 'cards';
+/**
+ * Scope and placement for an operational view action:
+ * - `'row'`: Renders as an inline action button on each document/row.
+ * - `'bulk'`: Appears in the floating bulk action bar when one or more rows are selected.
+ * - `'header'`: Renders as a primary action button in the view header.
+ */
+type ActionType = 'row' | 'bulk' | 'header';
+/**
+ * Toggles for the built-in document operations an operational view surfaces.
+ * All default to enabled (`true`). Set any to `false` to hide that operation.
+ *
+ * @example
+ * ```ts
+ * features: {
+ *   delete: false, // Prevent deleting records from this view
+ *   exportSelected: true, // Enable CSV export for checked rows
+ * }
+ * ```
+ */
+interface ViewActionFeatures {
+    /** Enables the "View" preview / read-only drawer button. Defaults to `true`. */
+    view?: boolean;
+    /** Enables the "Edit" document form link. Defaults to `true`. */
+    edit?: boolean;
+    /** Enables the "Duplicate" record action. Defaults to `true`. */
+    duplicate?: boolean;
+    /** Enables the "Delete" record action. Defaults to `true`. */
+    delete?: boolean;
+    /** Enables the "Export selected" CSV action in the bulk action bar. Defaults to `true`. */
+    exportSelected?: boolean;
+}
+/**
+ * Color palette options for metric cards:
+ * `'purple' | 'emerald' | 'amber' | 'rose' | 'blue' | 'indigo' | 'cyan' | 'orange'`
+ */
+type MetricColor = 'purple' | 'emerald' | 'amber' | 'rose' | 'blue' | 'indigo' | 'cyan' | 'orange' | string;
+/**
+ * A sub-metric breakdown item displayed in the compact footer of a metric card.
+ *
+ * @example
+ * ```ts
+ * {
+ *   label: "Pending",
+ *   aggregates: {
+ *     checkedIn: { count: "*", where: { checkedIn: { equals: true } } },
+ *     attending: { count: "*", where: { attending: { equals: true } } },
+ *   },
+ *   expression: "aggregates.attending - aggregates.checkedIn",
+ * }
+ * ```
+ */
+interface ViewSubMetric {
+    /** Short label for the sub-metric (e.g. "Pending", "Collected"). */
     label: string;
-    /** Marks the state whose revision is visible to public readers. */
-    published?: boolean;
-    /** Optional visual tone used by the Admin UI. */
-    color?: "neutral" | "warning" | "success" | "danger" | "info";
+    /** Single database aggregate operation. */
+    aggregate?: AggregateOperation;
+    /** Map of named aggregate operations referenced in `expression` as `aggregates.key`. */
+    aggregates?: Record<string, AggregateOperation>;
+    /** JEXL math formula evaluated over `value` for a single aggregate (e.g. `"value * 100"`). */
+    transform?: string;
+    /** JEXL math formula evaluated over `aggregates` (e.g. `"aggregates.a - aggregates.b"`). */
+    expression?: string;
+    /** Display formatter: `'currency' | 'number' | 'percent'`. */
+    format?: 'currency' | 'number' | 'percent' | string;
+    /** 3-letter currency code (e.g. `"USD"`, `"NGN"`, `"EUR"`) used when `format: "currency"`. */
+    currency?: string;
 }
-interface WorkflowTransition {
-    /** Stable transition key used by the REST and SDK APIs. */
+/**
+ * Configuration for a KPI summary card rendered at the top of an operational view.
+ *
+ * All aggregations run directly on the database engine for maximum performance.
+ *
+ * @example
+ * ```ts
+ * {
+ *   label: "Total Revenue",
+ *   color: "emerald",
+ *   aggregate: { sum: "amount", cast: "number", where: { status: "paid" } },
+ *   format: "currency",
+ *   currency: "USD",
+ * }
+ * ```
+ */
+interface ViewMetric {
+    /** Title displayed on the metric card header. */
+    label: string;
+    /** Accent color for the card's visual indicator. */
+    color?: MetricColor;
+    /** Unit badge shown alongside the numeric value (e.g. `"Guests"`, `"Orders"`, `"Tables"`). */
+    unit?: string;
+    /** Single database aggregate operation (`count`, `distinctCount`, `sum`, `avg`, `min`, `max`). */
+    aggregate?: AggregateOperation;
+    /** Map of named aggregate operations referenced in `expression` as `aggregates.key`. */
+    aggregates?: Record<string, AggregateOperation>;
+    /** JEXL math formula evaluated over `value` for a single aggregate (e.g. `"value * 25000"`). */
+    transform?: string;
+    /** JEXL math formula evaluated over `aggregates` (e.g. `"(aggregates.paid / aggregates.total) * 100"`). */
+    expression?: string;
+    /** Display formatter: `'currency' | 'number' | 'percent'`. */
+    format?: 'currency' | 'number' | 'percent' | string;
+    /** 3-letter currency code (e.g. `"USD"`, `"NGN"`, `"EUR"`) used when `format: "currency"`. */
+    currency?: string;
+    /** Optional secondary breakdown items shown in the card footer. */
+    subMetrics?: ViewSubMetric[];
+}
+/**
+ * Base configuration shared by all action types.
+ */
+interface ActionConfigBase<TDoc extends Record<string, unknown> = Record<string, unknown>> {
+    /** Unique action identifier (e.g. `"checkIn"`, `"markPaid"`). */
     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'`. */
+    type?: ActionType;
+    /** Optional confirmation prompt shown before executing (e.g. `"Confirm guest check-in at the door?"`). */
+    confirm?: string;
+    /** Optional interactive modal form fields prompting the user for input before executing. */
+    fields?: Field[];
+    /** Role-based access rules controlling who can trigger this action. */
+    access?: AccessConfig;
+}
+/**
+ * An operational workflow action with declarative data mutation.
+ */
+interface ActionConfigWithMutation<TDoc extends Record<string, unknown> = Record<string, unknown>> extends ActionConfigBase<TDoc> {
+    /** Declarative database mutation applied to targeted documents (e.g. `{ checkedIn: true, checkedInAt: "now()" }`). */
+    mutation: Partial<TDoc> | Record<string, unknown>;
+    /** Optional server handler for additional logic. */
+    handler?: (context: ActionContext<TDoc>) => Promise<unknown> | unknown;
+}
+/**
+ * An operational workflow action with server handler.
+ */
+interface ActionConfigWithHandler<TDoc extends Record<string, unknown> = Record<string, unknown>> extends ActionConfigBase<TDoc> {
+    /** Self-hosted server handler function executed when the action is triggered (required when mutation is not provided). */
+    handler: (context: ActionContext<TDoc>) => Promise<unknown> | unknown;
+    /** Optional declarative mutation. */
+    mutation?: Partial<TDoc> | Record<string, unknown>;
+}
+/**
+ * An operational workflow action that can mutate data or trigger server logic.
+ * Requires either `mutation` or `handler` (or both).
+ */
+type ActionConfig<TDoc extends Record<string, unknown> = Record<string, unknown>> = ActionConfigWithMutation<TDoc> | ActionConfigWithHandler<TDoc>;
+/**
+ * Context passed to an action's server handler function.
+ */
+interface ActionContext<TDoc extends Record<string, unknown> = Record<string, unknown>> {
+    /** The target document (for row actions), or null for header actions. */
+    doc: TDoc | null;
+    /** All targeted documents (for bulk actions). Empty array for header actions. */
+    docs: TDoc[];
+    /** The authenticated acting user, if available. */
+    user: Record<string, unknown> | null;
+    /** User inputs submitted via the action's modal form fields. */
+    input: Record<string, unknown>;
+    /** The collection configuration object. */
+    collection: Record<string, unknown>;
+}
+/**
+ * Role-based access control rules for a view or action.
+ */
+interface AccessConfig {
+    read?: AccessRule<any>;
+    create?: AccessRule<any>;
+    update?: AccessRule<any>;
+    delete?: AccessRule<any>;
+}
+/**
+ * Base options shared by all operational view configurations.
+ */
+interface ViewConfigBase {
+    /** Stable URL slug for the view (`/collections/:slug/views/:viewSlug` or `/:workspaceSlug/:viewSlug`). */
+    slug: string;
+    /** Human-readable title displayed in the sidebar navigation and view header. */
+    label: string;
+    /** Lucide icon name (e.g. `"UserCheck"`, `"Calendar"`, `"Shirt"`, `"TableProperties"`). */
+    icon?: string;
+    /** Optional target collection slug for views defined inside standalone operational workspaces. */
+    collection?: string;
+    /** Base query filter applied before user toolbar filters (e.g. `{ attending: { equals: true } }` or JEXL string). */
+    filter?: WhereClause | Record<string, any> | string;
+    /** Field names to show in this view, in order. If omitted, Dyrected infers default display fields. */
+    columns?: string[];
+    /** Default sorting rule when entering the view. */
+    sort?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    /** Custom workflow actions available in this view. */
+    actions?: ActionConfig[];
+    /** Toggles built-in operations (view/edit/duplicate/delete/export). */
+    features?: ViewActionFeatures;
     /**
-     * Source state(s) this transition originates from.
-     * Must match names in the workflow's `states` array.
-     */
-    from: string | string[];
-    /**
-     * Target state this transition leads to.
-     * Must match a name in the workflow's `states` array.
+     * Explicit display order for action buttons — mixing custom action names and built-in names
+     * (`"view"`, `"edit"`, `"duplicate"`, `"delete"`). Unlisted actions append in default order.
      */
-    to: string;
-    /** Every listed capability is required. */
-    requiredCapabilities?: string[];
-    /** Require a non-empty comment when performing the transition. */
-    requireComment?: boolean;
-    /** Remove the public snapshot after this transition commits. */
-    unpublish?: boolean;
+    actionOrder?: string[];
+    /** KPI summary cards rendered in the hero row above the view. */
+    metrics?: ViewMetric[];
+    /** Optional real-time counter badge or status indicator displayed on this view in navigation and tabs. */
+    badge?: NavBadgeConfig | string;
+    /** Custom component slots rendered around this operational view. */
+    components?: ViewComponentSlots;
+    /** Role-based access rules controlling who can see or use this view. */
+    access?: AccessConfig;
 }
-interface WorkflowRole {
-    /** Existing user role value, for example `editor` or `publisher`. */
-    role: string;
-    capabilities: string[];
+/** Table view — requires no special fields. */
+interface TableViewConfig extends ViewConfigBase {
+    layout?: 'table' | 'spreadsheet';
+    /** Field name used to organize records into kanban columns or collapsible grouped sections in table, cards, and spreadsheet. */
+    groupBy?: string;
 }
-/**
- * Configuration for a collection's editorial workflow: the states a document
- * can be in, the transitions between them, and the roles allowed to perform
- * each. Attach it to a collection's `workflow`, or build one with
- * `definePublishingWorkflow`.
- */
-interface WorkflowConfig<TDoc extends object = Record<string, unknown>> {
-    /** The state every new document starts in, e.g. `"draft"`. */
-    initialState: string;
-    /** State used for a new working revision created from published content. */
-    draftState?: string;
-    /** All states a document can occupy. Exactly one should be marked `published`. */
-    states: WorkflowState[];
-    /** The allowed moves between states, each with its own capability and comment rules. */
-    transitions: WorkflowTransition[];
-    /** Maps values in `user.roles` to workflow capabilities. */
-    roles?: WorkflowRole[];
-    /** Server-side hooks that run around every transition. */
-    hooks?: {
-        /** Runs before a transition commits — throw to validate or block the move. */
-        beforeTransition?: CollectionBeforeTransitionHook<TDoc>[];
-        /** Runs after a transition commits — trigger notifications or downstream work. */
-        afterTransition?: CollectionAfterTransitionHook<TDoc>[];
-    };
+/** Kanban view — requires `groupBy` to organize into columns. */
+interface KanbanViewConfig extends ViewConfigBase {
+    layout: 'kanban';
+    /** Field name to organize records into kanban columns. */
+    groupBy: string;
 }
-interface WorkflowMetadata {
-    /** The document's current workflow state, e.g. `"draft"` or `"published"`. */
-    state: string;
-    /** Revision counter, incremented on every committed transition. */
-    revision: number;
-    /** Revision number currently exposed as the public snapshot, once published. */
-    publishedRevision?: number;
-    /** ISO timestamp of the most recent publish. */
-    publishedAt?: string;
-    /** Id of the user who last published this document. */
-    publishedBy?: string;
-    /** Transitions currently allowed for the requesting user. Response-only. */
-    availableTransitions?: string[];
+/** Calendar view — requires `dateField` to place records on the calendar. */
+interface CalendarViewConfig extends ViewConfigBase {
+    layout: 'calendar';
+    /** Field name containing the ISO date string for calendar placement. */
+    dateField: string;
 }
-interface WorkflowTransitionContext<TDoc extends object = Record<string, unknown>> {
-    /** The transition being performed. */
-    transition: WorkflowTransition;
-    /** State the document is moving out of. */
-    from: string;
-    /** State the document is moving into. */
-    to: string;
-    /** The document as it stands before the transition commits. */
-    doc: TDoc;
-    /** The user performing the transition, when the request is authenticated. */
-    user?: AuthenticatedUser;
-    /** Comment supplied with the transition; required when `requireComment` is set. */
-    comment?: string;
-    /** Request context for the transition. */
-    req: HookRequestContext;
-    /** Transaction-scoped database adapter for reads and writes inside the hook. */
-    db: DatabaseAdapter;
+/** Gantt view — requires both `startDateField` and `endDateField`. */
+interface GanttViewConfig extends ViewConfigBase {
+    layout: 'gantt';
+    /** Field name for the start date in the gantt timeline. */
+    startDateField: string;
+    /** Field name for the end date in the gantt timeline. */
+    endDateField: string;
 }
-type CollectionBeforeTransitionHook<TDoc extends object = Record<string, unknown>> = (args: WorkflowTransitionContext<TDoc>) => void | Promise<void>;
-type CollectionAfterTransitionHook<TDoc extends object = Record<string, unknown>> = (args: WorkflowTransitionContext<TDoc> & {
-    event: LifecycleEvent;
-}) => void | Promise<void>;
-interface LifecycleEvent<TPayload = Record<string, unknown>> {
-    /** Unique id for this event. */
-    id: string;
-    /** The lifecycle event name, e.g. `"workflow.transitioned"` or `"entry.published"`. */
-    name: LifecycleEventName;
-    /** Slug of the collection the event is about. */
-    collection: string;
-    /** Id of the document the event is about. */
-    documentId: string;
-    /** ISO timestamp of when the event occurred. */
-    occurredAt: string;
-    /** Id of the user who triggered the event, when known. */
-    actorId?: string;
-    /** Event-specific data, such as the transition name and affected revision. */
-    payload: TPayload;
-    /** Number of delivery attempts made so far. */
-    attempts: number;
-    /** Current delivery status as the dispatcher works through the queue. */
-    status: "pending" | "processing" | "delivered" | "failed";
-    /** ISO timestamp of the next delivery retry, while pending. */
-    nextAttemptAt?: string;
-    /** ISO timestamp of successful delivery. */
-    deliveredAt?: string;
-    /** Message from the most recent failed delivery attempt. */
-    lastError?: string;
+/** Cards view — shows records as image/thumbnail gallery. */
+interface CardsViewConfig extends ViewConfigBase {
+    layout: 'cards';
+    /** Field name used to organize records into groups. */
+    groupBy?: string;
 }
-type LifecycleEventHandler = (event: LifecycleEvent) => void | Promise<void>;
-
-/** Column span in the 12-column Detail View layout grid (1 to 12). */
-type DetailSpan = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
 /**
- * Visual display variants supported by DetailFieldRenderer.
+ * Complete configuration for a tailored operational view.
  */
-type DisplayVariant = "text" | "badge" | "code-badge" | "code" | "copyable" | "link" | "url" | "email" | "phone" | "currency" | "percent" | "progress" | "star" | "star-rating" | "boolean" | "date" | "datetime" | "time" | "relative" | "image" | "avatar" | "color" | "color-swatches" | "icon" | "key-value" | "table" | "tags" | "badges" | "json";
+type ViewConfig = TableViewConfig | KanbanViewConfig | CalendarViewConfig | GanttViewConfig | CardsViewConfig;
 /**
- * Configuration options for rendering a field in a Detail View.
+ * Backwards-compatible aliases for builder types.
  */
-interface DisplayFieldOptions {
-    /** Custom label overriding the field's schema label. */
-    label?: string;
-    /** When true, hides the field label entirely and renders only the value. */
-    hideLabel?: boolean;
-    /** Informational tooltip shown next to the label. */
-    tooltip?: string;
-    /** Grid column span across the 12-column grid. */
-    span?: DetailSpan;
-    /** Specific visual representation variant (e.g. 'badge', 'currency', 'star', 'copyable'). */
-    display?: DisplayVariant;
-    /** Preset format for numbers, dates, and currencies ('currency', 'date', 'datetime', 'relative', 'number', 'percent'). */
-    format?: "currency" | "date" | "datetime" | "relative" | "number" | "percent" | string;
-    /** ISO currency code (e.g. 'USD', 'EUR') when display or format is 'currency'. */
-    currency?: string;
-    /** Color mapping for badge and tag values (named palette, hex color, Tailwind class, or wildcard). */
-    badgeColors?: Record<string, string>;
-    /** Column header for object keys when display is 'key-value'. */
-    keyLabel?: string;
-    /** Column header for object values when display is 'key-value'. */
-    valueLabel?: string;
-    /** Custom placeholder text when the field value is null, undefined, or empty. */
-    emptyText?: string;
-    /** When true, hides this entire field item if the value is null or empty. */
-    hideIfEmpty?: boolean;
-    /**
-     * When true, allows inline editing of this field in the Detail View
-     * via an interactive toggle.
-     */
-    editable?: boolean;
-    /**
-     * Visibility condition for this field item.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
-     * When false or evaluating to falsy, this item is hidden in the Detail View.
-     *
-     * @example `visible: "doc.status == 'published'"`
-     * @example `visible: false`
-     */
-    visible?: string | boolean;
-    /** Specific aspect ratio constraint for media (e.g., "16/9", "4/3", "1/1", "auto"). */
-    aspectRatio?: string;
-    /** CSS object-fit behavior for media ('cover', 'contain', 'fill', 'scale-down'). */
-    objectFit?: "cover" | "contain" | "fill" | "scale-down";
-    /** Media alignment ('left', 'center', 'right'). */
-    align?: "left" | "center" | "right";
-    /** Fixed pixel width or CSS dimension for media preview. */
-    width?: string | number;
-    /** Fixed pixel height or CSS dimension for media preview. */
-    height?: string | number;
+type DefineViewBaseOptions = ViewConfigBase;
+type DefineTableViewOptions = TableViewConfig;
+type DefineKanbanViewOptions = KanbanViewConfig;
+type DefineCalendarViewOptions = CalendarViewConfig;
+type DefineGanttViewOptions = GanttViewConfig;
+type DefineCardsViewOptions = CardsViewConfig;
+type DefineViewOptions = ViewConfig;
+/**
+ * Options for defining a custom workflow action with `defineAction`.
+ *
+ * @example
+ * ```ts
+ * export const checkInAction = defineAction({
+ *   name: "checkIn",
+ *   label: "Check In",
+ *   icon: "UserCheck",
+ *   type: "row",
+ *   confirm: "Confirm guest check-in at the door?",
+ *   mutation: { checkedIn: true, checkedInAt: "now()" },
+ * });
+ * ```
+ */
+interface DefineActionOptions<TDoc extends Record<string, unknown> = Record<string, unknown>> {
+    /** Unique action identifier (e.g. `"checkIn"`, `"markPaid"`). */
+    name: string;
+    /** Button label displayed in the UI. */
+    label: 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'`. */
+    type?: ActionType;
+    /** Optional confirmation prompt shown before executing (e.g. `"Confirm guest check-in at the door?"`). */
+    confirm?: string;
+    /** Optional interactive modal form fields prompting the user for input before executing. */
+    fields?: Field[];
+    /** Declarative database mutation applied to targeted documents (e.g. `{ checkedIn: true, checkedInAt: "now()" }`). */
+    mutation?: Partial<TDoc> | Record<string, unknown>;
+    /** Self-hosted server handler function executed when the action is triggered. */
+    handler?: (context: ActionContext<TDoc>) => Promise<unknown> | unknown;
+    /** Role-based access rules controlling who can trigger this action. */
+    access?: AccessConfig;
 }
 /**
- * Declared field item in a Detail View.
+ * Defines a typed operational view for a collection.
+ * Layout-specific overloads enforce required fields for each view type.
+ *
+ * @example
+ * ```ts
+ * // Table view (no special requirements)
+ * export const allGuests = defineView({
+ *   slug: "all-guests",
+ *   label: "All Guests",
+ *   layout: "table", // or omit for default
+ * });
+ *
+ * // Kanban view (requires groupBy)
+ * export const guestsByTable = defineView({
+ *   slug: "by-table",
+ *   label: "Guests by Table",
+ *   layout: "kanban",
+ *   groupBy: "tableNumber", // required!
+ * });
+ *
+ * // Calendar view (requires dateField)
+ * export const eventCalendar = defineView({
+ *   slug: "event-calendar",
+ *   label: "Event Calendar",
+ *   layout: "calendar",
+ *   dateField: "eventDate", // required!
+ * });
+ *
+ * // Gantt view (requires startDateField and endDateField)
+ * export const projectTimeline = defineView({
+ *   slug: "timeline",
+ *   label: "Project Timeline",
+ *   layout: "gantt",
+ *   startDateField: "startDate", // required!
+ *   endDateField: "endDate", // required!
+ * });
+ * ```
+ */
+declare function defineView(config: DefineTableViewOptions): DefineTableViewOptions;
+declare function defineView(config: DefineKanbanViewOptions): DefineKanbanViewOptions;
+declare function defineView(config: DefineCalendarViewOptions): DefineCalendarViewOptions;
+declare function defineView(config: DefineGanttViewOptions): DefineGanttViewOptions;
+declare function defineView(config: DefineCardsViewOptions): DefineCardsViewOptions;
+declare function defineView<const T extends DefineViewOptions>(config: T): T;
+/** Convenience helper for table views. Enforces no view-specific required fields. */
+declare function defineTableView(config: DefineTableViewOptions): DefineTableViewOptions;
+/** Convenience helper for kanban views. Enforces `groupBy` is provided. */
+declare function defineKanbanView(config: DefineKanbanViewOptions): DefineKanbanViewOptions;
+/** Convenience helper for calendar views. Enforces `dateField` is provided. */
+declare function defineCalendarView(config: DefineCalendarViewOptions): DefineCalendarViewOptions;
+/** Convenience helper for gantt views. Enforces `startDateField` and `endDateField` are provided. */
+declare function defineGanttView(config: DefineGanttViewOptions): DefineGanttViewOptions;
+/** Convenience helper for cards views. Optional `groupBy`. */
+declare function defineCardsView(config: DefineCardsViewOptions): DefineCardsViewOptions;
+/**
+ * Defines a custom workflow action for an operational view.
+ *
+ * @example
+ * ```ts
+ * export const markPaidAction = defineAction({
+ *   name: "markPaid",
+ *   label: "Mark Paid",
+ *   icon: "DollarSign",
+ *   type: "bulk",
+ *   confirm: "Mark selected orders as paid?",
+ *   mutation: { status: "paid" },
+ * });
+ * ```
  */
-interface DetailField {
-    /** Identifies this item as a field. */
-    type: "field";
-    /** Field name or nested path in the document. */
-    field: string;
-    /** Display options for this field. */
-    options?: DisplayFieldOptions;
-}
+declare function defineAction<const T extends DefineActionOptions>(config: T): T;
+
 /**
- * Configuration options for a Detail View section container.
+ * Definition of a navigation group in the Dyrected admin sidebar.
  */
-interface DetailSectionOptions {
-    /** Lucide icon name displayed in the section header. */
-    icon?: string;
-    /** Status or counter badge displayed beside the section title. */
-    badge?: string;
-    /** Color palette name or hex code for the section badge. */
-    badgeColor?: string;
-    /** Subtitle description displayed beneath the section title. */
-    description?: string;
-    /** Grid width of the section on the main 12-column layout. */
-    span?: DetailSpan;
-    /** Internal grid column count for child items. */
-    columns?: number;
-    /** When true, allows editors to collapse and expand the section. */
-    collapsible?: boolean;
-    /** Starts the section in collapsed state when collapsible is enabled. */
-    collapsedByDefault?: boolean;
-    /**
-     * Visibility condition for this section.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
-     *
-     * @example `visible: "user.roles != null and 'admin' in user.roles"`
-     */
-    visible?: string | boolean;
+interface NavGroup {
+    /** Display title for the group in the sidebar. */
+    name: string;
+    /** Optional stable identifier/slug for the group. */
+    slug?: string;
+    /** Lucide icon name for the group accordion header. */
+    icon?: AdminIconName | string;
+    /** Whether the group is expanded by default in the sidebar. */
+    defaultExpanded?: boolean;
+    /** Sort order weight for the group section in the sidebar (lower numbers appear first). */
+    order?: number;
 }
 /**
- * Section container grouping fields and components in a Detail View.
+ * Configuration for real-time count badges on navigation items.
  */
-interface DetailSection {
-    /** Identifies this item as a section. */
-    type: "section";
-    /** Section heading title. */
-    title: string;
-    /** Child items rendered inside this section. */
-    items: DetailItem[];
-    /** Section container options. */
-    options?: DetailSectionOptions;
+interface NavBadgeConfig {
+    /** If true, automatically calculates a count based on the primary view's filter. */
+    count?: boolean;
+    /** Static text override for the badge (e.g. "Live", "New", "Urgent"). */
+    text?: string;
+    /** Custom aggregate filter evaluated on the database. */
+    aggregate?: {
+        collection: string;
+        where?: Record<string, unknown>;
+    };
+    /** Visual badge color variant. */
+    variant?: "default" | "warning" | "destructive" | "info" | "success";
 }
 /**
- * Configuration options for an individual tab in `displayTabs()`.
+ * Options for defining an operational workspace, or customizing placement of collections/globals, with `defineWorkspace`.
  */
-interface DetailTabOptions {
-    /** Lucide icon name displayed inside the tab trigger. */
-    icon?: string;
-    /** Counter or status badge rendered next to the tab label. */
-    badge?: string;
-    /** Color palette name or hex code for the tab badge. */
-    badgeColor?: string;
-    /**
-     * Visibility condition for this individual tab.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
-     */
-    visible?: string | boolean;
+interface DefineWorkspaceOptions {
+    /** If provided, injects views into an existing collection submenu. If omitted, item stands alone. */
+    addToCollection?: string;
+    /** References an existing collection to position it in navigation. */
+    collection?: string;
+    /** References an existing global to position it in navigation. */
+    global?: string;
+    /** Designates this item as the dashboard link. */
+    dashboard?: boolean;
+    /** Stable URL slug for standalone operational workspaces (`/:slug`). */
+    slug?: string;
+    /** Display label in the sidebar (defaults to collection/global label when applicable). */
+    label?: string;
+    /** Lucide icon name (e.g. "ShieldAlert", "Users", "Briefcase"). */
+    icon?: AdminIconName | string;
+    /** Section group name (string) or group object with icon and default expanded state. */
+    group?: string | NavGroup;
+    /** Relative position: insert immediately after this collection or nav item slug. */
+    after?: string;
+    /** Relative position: insert immediately before this collection or nav item slug. */
+    before?: string;
+    /** Numeric sort weight within its group (lower numbers first, default 100). */
+    order?: number;
+    /** Fast shortcut to pin item to start or end of its group: 'first' | 'last'. */
+    position?: "first" | "last";
+    /** Real-time counter badge (auto-computed from primary view or custom aggregate). */
+    badge?: NavBadgeConfig | string;
+    /** Role-based access rules controlling who can see this navigation item. */
+    access?: string[] | AccessRule;
+    /** Custom internal route or external URL. */
+    href?: string;
+    /** Views belonging to this item. The first view is automatically the default. */
+    views?: ViewConfig[];
 }
 /**
- * Single tab entry inside a tabbed container.
+ * Helper to define an operational workspace or customize placement of collections/globals.
+ *
+ * @example
+ * ```ts
+ * export const kycQueue = defineWorkspace({
+ *   slug: "kyc-review",
+ *   label: "KYC Review",
+ *   icon: "ShieldAlert",
+ *   group: "Compliance",
+ *   views: [
+ *     defineView({ collection: "investors", slug: "pending", label: "Pending" }),
+ *   ],
+ * });
+ * ```
  */
-interface DetailTab {
-    /** Identifies this item as a tab. */
-    type: "tab";
-    /** Tab label shown in the tab bar. */
+declare function defineWorkspace(options: DefineWorkspaceOptions): DefineWorkspaceOptions;
+/**
+ * Runtime compiled representation of a single navigation item.
+ */
+interface CompiledNavItem {
+    id: string;
+    type: "workspace" | "collection" | "global" | "dashboard" | "link";
+    slug: string;
     label: string;
-    /** Child items rendered when this tab is active. */
-    items: DetailItem[];
-    /** Tab options. */
-    options?: DetailTabOptions;
+    icon?: string;
+    group?: string;
+    href?: string;
+    badge?: NavBadgeConfig | string;
+    access?: string[] | AccessRule;
+    order: number;
+    collection?: string;
+    global?: string;
+    views: ViewConfig[];
 }
 /**
- * Configuration options for a tabbed container.
+ * Runtime compiled representation of a navigation group containing items.
  */
-interface DetailTabsOptions {
-    /** Grid width of the tabs container on the main layout. */
-    span?: DetailSpan;
-    /** Label of the tab that should be active on initial render. */
-    defaultTab?: string;
-    /**
-     * Visibility condition for this tab container.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
-     */
-    visible?: string | boolean;
+interface CompiledNavGroup {
+    id: string;
+    name: string;
+    slug: string;
+    icon?: string;
+    defaultExpanded?: boolean;
+    order: number;
+    items: CompiledNavItem[];
 }
 /**
- * Tabbed navigation container in a Detail View layout.
+ * Complete runtime compiled navigation tree.
  */
-interface DetailTabs {
-    /** Identifies this item as a tab container. */
-    type: "tabs";
-    /** List of tabs in this container. */
-    tabs: DetailTab[];
-    /** Tab container options. */
-    options?: DetailTabsOptions;
+interface CompiledNavTree {
+    groups: CompiledNavGroup[];
+    ungrouped: CompiledNavItem[];
+}
+interface PinnedNavItemRef {
+    type: "workspace" | "collection" | "global" | "link" | "dashboard";
+    slug: string;
+    view?: string;
+    label?: string;
+    icon?: string;
+}
+interface UserNavigationPreferences {
+    _version: number;
+    pinned?: PinnedNavItemRef[];
+    hidden?: string[];
+    groupOrder?: string[];
+    itemOrder?: Record<string, string[]>;
+    groups?: NavGroup[];
+    items?: DefineWorkspaceOptions[];
+}
+declare const CURRENT_NAV_PREFERENCES_VERSION = 1;
+declare const DEFAULT_USER_NAV_PREFERENCES: UserNavigationPreferences;
+
+/** A valid icon component name from the Lucide icon set bundled with Dyrected Admin. */
+type AdminIconName = keyof typeof icons;
+/** Ordered custom component keys rendered around the built-in Admin dashboard. */
+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;
 }
 /**
- * Configuration options for a sub-grid container.
+ * Branding and metadata options for the Dyrected Admin UI.
+ *
+ * @example
+ * admin: {
+ *   branding: {
+ *     logo: '/logo.svg',
+ *     primaryColor: '#6366f1',
+ *   },
+ *   meta: {
+ *     titleSuffix: '- My App',
+ *   },
+ * }
  */
-interface DetailGridOptions {
-    /** Grid width of the sub-grid container in the surrounding layout. */
-    span?: DetailSpan;
+interface AdminConfig {
     /**
-     * Visibility condition for this grid container.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     * Custom navigation layout for the admin sidebar.
+     * If omitted, all collections and globals appear in default sections.
      */
-    visible?: string | boolean;
+    navigation?: DefineWorkspaceOptions[];
+    /** Custom component slots around the built-in dashboard. */
+    components?: AdminDashboardComponentSlots;
+    branding?: {
+        /** Full logo image shown in the expanded sidebar. URL or imported image asset. */
+        logo?: string;
+        /** Compact logo mark used in the collapsed sidebar state. */
+        logoMark?: string;
+        /** Text alternative or addition to the logo image. */
+        logoText?: string;
+        /**
+         * Brand colour used for committed, filled actions — Save, Create, Upload —
+         * and active/selected states. Accepts a hex string, a named colour
+         * (`amber`, `lime`, `violet`, `green`, `blue`, `red`, `purple`, `orange`),
+         * or a raw HSL triplet (`"217 91% 60%"`). Applied in both light and dark mode.
+         *
+         * This is one half of the two-colour brand model. Use {@link accentColor}
+         * for links and navigation accents. If you only set `primaryColor`, it is
+         * reused for accents too, matching the single-brand-colour look.
+         * @example '#6366f1'
+         * @example 'blue'
+         * @example 'hsl(240 50% 60%)'
+         */
+        primaryColor?: string;
+        /**
+         * Brand colour used for links, active navigation details, hover text, and
+         * focus rings — the "accent" half of the two-colour brand model, mapped to
+         * the admin's `--intelligence` token. Accepts the same formats as
+         * {@link primaryColor} and applies in both light and dark mode.
+         *
+         * Set this when your brand has a distinct link/accent colour separate from
+         * your primary action colour. When omitted, accents fall back to
+         * `primaryColor` (if set) or the built-in default.
+         * @example '#8b5cf6'
+         * @example 'violet'
+         */
+        accentColor?: string;
+        /** Browser tab favicon URL. */
+        favicon?: string;
+        /** Font family for body and UI text. Must be loaded separately. */
+        fontSans?: string;
+        /** Font family for headings. Must be loaded separately. */
+        fontSerif?: string;
+    };
+    meta?: {
+        /**
+         * String appended to every Admin page's `<title>`.
+         * @default '- Dyrected'
+         */
+        titleSuffix?: string;
+    };
+    /**
+     * The canonical/base URL of the frontend website for links and iframe live previews.
+     */
+    siteUrl?: string;
+    /**
+     * Public URL of the Admin UI, used for links in invite and password-reset emails.
+     * Falls back to the `DYRECTED_ADMIN_URL` env var, then the page the admin is running on,
+     * then `/admin` (resolved against the request origin).
+     */
+    adminUrl?: string;
 }
+
+type DeclarativeHookExpression = string;
+/**
+ * @deprecated Use {@link FieldBeforeChangeHook} or `FieldAfterReadHook` instead.
+ * This alias remains for backwards compatibility.
+ */
+type FieldHook<TDoc extends object = Record<string, unknown>, TValue = unknown> = FieldBeforeChangeHook<TValue, TDoc>;
+/**
+ * Runs before Dyrected queries the database for a list or single-document fetch.
+ *
+ * Return a new `where` query object to override or extend the current filter.
+ * Return `undefined` (or nothing) to leave the query unchanged.
+ */
+type CollectionBeforeReadHook = (args: {
+    req: HookRequestContext;
+    query?: Record<string, unknown>;
+    user?: AuthenticatedUser;
+    db: ReadonlyDatabaseAdapter;
+}) => Record<string, unknown> | void | Promise<Record<string, unknown> | void>;
+type CollectionBeforeReadHookEntry = CollectionBeforeReadHook | DeclarativeHookExpression;
+/**
+ * Runs after a document (or list of documents) is fetched from the database,
+ * before the response is sent to the client.
+ */
+type CollectionAfterReadHook<TDoc extends object = Record<string, unknown>> = (args: {
+    doc: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    db: ReadonlyDatabaseAdapter;
+}) => TDoc | Promise<TDoc>;
+type CollectionAfterReadHookEntry<TDoc extends object = Record<string, unknown>> = CollectionAfterReadHook<TDoc> | DeclarativeHookExpression;
 /**
- * Multi-column sub-grid layout inside a section or tab.
+ * Runs **before** a document is created or updated in the database.
  */
-interface DetailGrid {
-    /** Identifies this item as a grid. */
-    type: "grid";
-    /** Number of balanced columns in this grid. */
-    columns: number;
-    /** Child items rendered across the grid columns. */
-    items: DetailItem[];
-    /** Grid container options. */
-    options?: DetailGridOptions;
-}
+type CollectionBeforeChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
+    data: Partial<TDoc>;
+    doc?: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    operation: "create" | "update";
+    db: ReadonlyDatabaseAdapter;
+}) => Partial<TDoc> | void | Promise<Partial<TDoc> | void>;
+type CollectionBeforeChangeHookEntry<TDoc extends object = Record<string, unknown>> = CollectionBeforeChangeHook<TDoc> | DeclarativeHookExpression;
 /**
- * Configuration options for a repeated array field.
+ * Runs **after** a document is created or updated in the database.
  */
-interface DetailRepeatOptions {
-    /** Layout style for repeated items: 'table', 'cards', or 'list'. */
-    layout?: "table" | "cards" | "list";
-    /** Message shown when the repeated array is empty. */
-    emptyText?: string;
-    /** Grid width of the repeated container. */
-    span?: DetailSpan;
-    /**
-     * Visibility condition for this repeat container.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
-     */
-    visible?: string | boolean;
-    /** Field name in each row to use as the card header title (e.g. 'title', 'key', 'name'). */
-    useAsTitle?: string;
-    /** Field name in each row to use as the card header title (alias for useAsTitle). */
-    titleField?: string;
-    /** Static card title prefix or template (e.g. 'Category' or 'Card #{index}'). */
-    title?: string;
-    /** Optional icon name for card header. */
-    icon?: string;
-    /** Number of grid columns for cards layout (1, 2, 3, or 4; defaults to 3). */
-    columns?: 1 | 2 | 3 | 4;
-}
+type CollectionAfterChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
+    doc: TDoc;
+    previousDoc?: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    operation: "create" | "update";
+    db: DatabaseAdapter;
+}) => void | Promise<void>;
 /**
- * Delegated repeated array field item in a Detail View.
+ * Runs **inside** the database transaction that persists a create or update,
+ * after the document is written and before the transaction commits.
+ *
+ * `tx` is a writable, transaction-scoped adapter: anything written through it
+ * commits or rolls back together with the document. Throw to abort the whole
+ * operation, including the primary write. Use it for invariants that must hold
+ * atomically, such as writing a ledger row alongside a payment.
+ *
+ * Requires a database adapter that supports transactions.
  */
-interface DetailRepeat {
-    /** Identifies this item as a repeat container. */
-    type: "repeat";
-    /** Array field name in the document. */
-    field: string;
-    /** Item template schemas rendered for each element in the array. */
-    items: DetailItem[];
-    /** Repeat options. */
-    options?: DetailRepeatOptions;
-}
+type CollectionBeforeCommitHook<TDoc extends object = Record<string, unknown>> = (args: {
+    /** The document as persisted by this operation. */
+    doc: TDoc;
+    /** The document before the update. Absent on create. */
+    previousDoc?: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    operation: "create" | "update";
+    /** Writable, transaction-scoped database adapter. */
+    tx: DatabaseAdapter;
+}) => void | Promise<void>;
 /**
- * Async or synchronous handler function calculating a computed metric.
+ * Runs **before** a document is deleted from the database.
  */
-type ComputedHandler<TDoc = any> = (context: {
+type CollectionBeforeDeleteHook<TDoc extends object = Record<string, unknown>> = (args: {
+    id: string;
     doc: TDoc;
-    user?: any;
-    db?: any;
-}) => any | Promise<any>;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    db: ReadonlyDatabaseAdapter;
+}) => void | Promise<void>;
 /**
- * Configuration options for a computed value card.
+ * Runs **after** a document has been deleted from the database.
  */
-interface DetailComputedOptions<TDoc = any> {
-    /** Unique identifier for the computed metric. */
-    id?: string;
-    /** JEXL expression string evaluated against `{ doc, user }`. */
-    expression?: string;
-    /** Async or sync function receiving `{ doc, user, db }` returning the computed value. */
-    handler?: ComputedHandler<TDoc>;
-    /** Grid width for the computed card. */
-    span?: DetailSpan;
-    /** Formatting preset for the computed value ('currency', 'percent', 'number', 'date'). */
-    format?: string;
-    /** Currency code when format is 'currency'. */
-    currency?: string;
-    /**
-     * Visibility condition for this computed card.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
-     */
-    visible?: string | boolean;
-}
+type CollectionAfterDeleteHook<TDoc extends object = Record<string, unknown>> = (args: {
+    id: string;
+    doc: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    db: DatabaseAdapter;
+}) => void | Promise<void>;
+/** @see {@link CollectionBeforeReadHook} */
+type GlobalBeforeReadHook = CollectionBeforeReadHook;
+type GlobalBeforeReadHookEntry = CollectionBeforeReadHookEntry;
 /**
- * Computed KPI or metric card in a Detail View.
+ * Runs after the global document is fetched, before the response is sent.
  */
-interface DetailComputed<TDoc = any> {
-    /** Identifies this item as a computed value. */
-    type: "computed";
-    /** Unique computed identifier. */
-    id?: string;
-    /** Human-readable card label. */
-    label: string;
-    /** JEXL evaluation string. */
-    expression?: string;
-    /** Computed function handler. */
-    handler?: ComputedHandler<TDoc>;
-    /** Computed options. */
-    options?: DetailComputedOptions<TDoc>;
-}
+type GlobalAfterReadHook<TDoc extends object = Record<string, unknown>> = (args: {
+    doc: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    db: ReadonlyDatabaseAdapter;
+}) => TDoc | Promise<TDoc>;
+type GlobalAfterReadHookEntry<TDoc extends object = Record<string, unknown>> = GlobalAfterReadHook<TDoc> | DeclarativeHookExpression;
 /**
- * Configuration options for a horizontal divider line.
+ * Runs before the global document is updated.
+ * Operation is always `'update'` (globals cannot be created or deleted).
  */
-interface DetailDividerOptions {
-    /** Grid span in the surrounding layout. */
-    span?: DetailSpan;
-    /**
-     * Visibility condition for this divider.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
-     */
-    visible?: string | boolean;
-    /** Vertical margin spacing around the divider line. */
-    spacing?: "sm" | "md" | "lg" | "none";
-}
+type GlobalBeforeChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
+    data: Partial<TDoc>;
+    doc?: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    operation: "update";
+    db: ReadonlyDatabaseAdapter;
+}) => Partial<TDoc> | void | Promise<Partial<TDoc> | void>;
+type GlobalBeforeChangeHookEntry<TDoc extends object = Record<string, unknown>> = GlobalBeforeChangeHook<TDoc> | DeclarativeHookExpression;
 /**
- * Horizontal divider line in a Detail View layout.
+ * Runs after the global document is updated. Side-effects only.
  */
-interface DetailDivider {
-    /** Identifies this item as a divider. */
-    type: "divider";
-    /** Divider options. */
-    options?: DetailDividerOptions;
-}
+type GlobalAfterChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
+    doc: TDoc;
+    previousDoc?: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    operation: "update";
+    db: DatabaseAdapter;
+}) => void | Promise<void>;
 /**
- * Configuration options for a static text or callout block.
+ * @deprecated Use the specific hook types instead:
+ * `CollectionBeforeChangeHook`, `CollectionAfterReadHook`, etc.
+ *
+ * This broad type remains for backwards compatibility with the internal hook runner.
  */
-interface DetailTextOptions {
-    /** Grid width in the 12-column layout. */
-    span?: DetailSpan;
+type HookFunction<TDoc extends object = Record<string, unknown>> = (args: {
+    data?: Partial<TDoc>;
+    doc?: TDoc;
+    user?: AuthenticatedUser;
+    req?: HookRequestContext;
+    operation?: "create" | "update" | "delete";
+    db?: DatabaseAdapter;
+    [key: string]: unknown;
+}) => unknown | Promise<unknown>;
+
+declare const LIFECYCLE_EVENT_NAMES: readonly ["revision.created", "workflow.transitioned", "entry.published", "entry.unpublished"];
+type LifecycleEventName = (typeof LIFECYCLE_EVENT_NAMES)[number];
+interface WorkflowState {
+    /** Stable machine-readable state key. */
+    name: string;
+    /** Label rendered in the Admin UI. */
+    label: string;
+    /** Marks the state whose revision is visible to public readers. */
+    published?: boolean;
+    /** Optional visual tone used by the Admin UI. */
+    color?: "neutral" | "warning" | "success" | "danger" | "info";
+}
+interface WorkflowTransition {
+    /** Stable transition key used by the REST and SDK APIs. */
+    name: string;
+    label: string;
     /**
-     * Visibility condition for this text block.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     * Source state(s) this transition originates from.
+     * Must match names in the workflow's `states` array.
      */
-    visible?: string | boolean;
-    /** Typography and alert styling variant ('body', 'heading', 'subheading', 'muted', 'caption', 'callout', 'info', 'warning'). */
-    variant?: "body" | "heading" | "subheading" | "muted" | "caption" | "callout" | "info" | "warning";
-    /** Custom CSS or Tailwind classes applied to the text wrapper. */
-    className?: string;
+    from: string | string[];
+    /**
+     * Target state this transition leads to.
+     * Must match a name in the workflow's `states` array.
+     */
+    to: string;
+    /** Every listed capability is required. */
+    requiredCapabilities?: string[];
+    /** Require a non-empty comment when performing the transition. */
+    requireComment?: boolean;
+    /** Remove the public snapshot after this transition commits. */
+    unpublish?: boolean;
+    /**
+     * Runs inside the transition's database transaction, after the workflow state
+     * is written and before it commits. Writes made through `tx` commit or roll
+     * back together with the state change; throw to abort the transition and
+     * leave the document in its original state.
+     */
+    onTransition?: WorkflowOnTransitionHook;
+}
+interface WorkflowOnTransitionContext<TDoc extends object = Record<string, unknown>> {
+    /** The transition being performed. */
+    transition: WorkflowTransition;
+    /** State the document is moving out of. */
+    from: string;
+    /** State the document is moving into. */
+    to: string;
+    /** The document as locked inside the transaction, before the transition is applied. */
+    doc: TDoc;
+    /** Extra payload supplied by the caller alongside the transition request. */
+    input?: Record<string, unknown>;
+    /** Comment supplied with the transition. */
+    comment?: string;
+    /** The user performing the transition, when the request is authenticated. */
+    user?: AuthenticatedUser;
+    /** Request context for the transition. */
+    req: HookRequestContext;
+    /** Writable, transaction-scoped database adapter. */
+    tx: DatabaseAdapter;
+}
+type WorkflowOnTransitionHook<TDoc extends object = Record<string, unknown>> = (args: WorkflowOnTransitionContext<TDoc>) => void | Promise<void>;
+interface WorkflowRole {
+    /** Existing user role value, for example `editor` or `publisher`. */
+    role: string;
+    capabilities: string[];
 }
 /**
- * Static text, heading, callout, or notice block in a Detail View.
+ * Configuration for a collection's editorial workflow: the states a document
+ * can be in, the transitions between them, and the roles allowed to perform
+ * each. Attach it to a collection's `workflow`, or build one with
+ * `definePublishingWorkflow`.
  */
-interface DetailText {
-    /** Identifies this item as a text block. */
-    type: "text";
-    /** Text or markdown content. */
-    content: string;
-    /** Text options. */
-    options?: DetailTextOptions;
+interface WorkflowConfig<TDoc extends object = Record<string, unknown>> {
+    /** The state every new document starts in, e.g. `"draft"`. */
+    initialState: string;
+    /** State used for a new working revision created from published content. */
+    draftState?: string;
+    /** All states a document can occupy. Exactly one should be marked `published`. */
+    states: WorkflowState[];
+    /** The allowed moves between states, each with its own capability and comment rules. */
+    transitions: WorkflowTransition[];
+    /** Maps values in `user.roles` to workflow capabilities. */
+    roles?: WorkflowRole[];
+    /** Server-side hooks that run around every transition. */
+    hooks?: {
+        /** Runs before a transition commits — throw to validate or block the move. */
+        beforeTransition?: CollectionBeforeTransitionHook<TDoc>[];
+        /** Runs after a transition commits — trigger notifications or downstream work. */
+        afterTransition?: CollectionAfterTransitionHook<TDoc>[];
+    };
 }
-/**
- * Configuration options for a custom React component slot.
- */
-interface DetailCustomOptions<TDoc = any> {
-    /** Grid span in the 12-column layout. */
-    span?: DetailSpan;
-    /**
-     * Visibility condition for this custom component.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
-     */
-    visible?: string | boolean;
-    /** Static or initial props passed into the custom component. */
-    props?: Record<string, any>;
-    /** Inline render function receiving `{ doc, user }` (Self-hosted React runtimes). */
-    render?: (context: {
-        doc: TDoc;
-        user?: any;
-        [key: string]: any;
-    }) => any;
+interface WorkflowMetadata {
+    /** The document's current workflow state, e.g. `"draft"` or `"published"`. */
+    state: string;
+    /** Revision counter, incremented on every committed transition. */
+    revision: number;
+    /** Revision number currently exposed as the public snapshot, once published. */
+    publishedRevision?: number;
+    /** ISO timestamp of the most recent publish. */
+    publishedAt?: string;
+    /** Id of the user who last published this document. */
+    publishedBy?: string;
+    /** Transitions currently allowed for the requesting user. Response-only. */
+    availableTransitions?: string[];
+}
+interface WorkflowTransitionContext<TDoc extends object = Record<string, unknown>> {
+    /** The transition being performed. */
+    transition: WorkflowTransition;
+    /** State the document is moving out of. */
+    from: string;
+    /** State the document is moving into. */
+    to: string;
+    /** The document as it stands before the transition commits. */
+    doc: TDoc;
+    /** The user performing the transition, when the request is authenticated. */
+    user?: AuthenticatedUser;
+    /** Comment supplied with the transition; required when `requireComment` is set. */
+    comment?: string;
+    /** Extra payload supplied by the caller alongside the transition request. */
+    input?: Record<string, unknown>;
+    /** Request context for the transition. */
+    req: HookRequestContext;
+    /** Transaction-scoped database adapter for reads and writes inside the hook. */
+    db: DatabaseAdapter;
+}
+type CollectionBeforeTransitionHook<TDoc extends object = Record<string, unknown>> = (args: WorkflowTransitionContext<TDoc>) => void | Promise<void>;
+type CollectionAfterTransitionHook<TDoc extends object = Record<string, unknown>> = (args: WorkflowTransitionContext<TDoc> & {
+    event: LifecycleEvent;
+}) => void | Promise<void>;
+interface LifecycleEvent<TPayload = Record<string, unknown>> {
+    /** Unique id for this event. */
+    id: string;
+    /** The lifecycle event name, e.g. `"workflow.transitioned"` or `"entry.published"`. */
+    name: LifecycleEventName;
+    /** Slug of the collection the event is about. */
+    collection: string;
+    /** Id of the document the event is about. */
+    documentId: string;
+    /** ISO timestamp of when the event occurred. */
+    occurredAt: string;
+    /** Id of the user who triggered the event, when known. */
+    actorId?: string;
+    /** Event-specific data, such as the transition name and affected revision. */
+    payload: TPayload;
+    /** Number of delivery attempts made so far. */
+    attempts: number;
+    /** Current delivery status as the dispatcher works through the queue. */
+    status: "pending" | "processing" | "delivered" | "failed";
+    /** ISO timestamp of the next delivery retry, while pending. */
+    nextAttemptAt?: string;
+    /** ISO timestamp of successful delivery. */
+    deliveredAt?: string;
+    /** Message from the most recent failed delivery attempt. */
+    lastError?: string;
 }
+type LifecycleEventHandler = (event: LifecycleEvent) => void | Promise<void>;
+
+/** Column span in the 12-column Detail View layout grid (1 to 12). */
+type DetailSpan = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
 /**
- * Custom React component slot mounted in a Detail View.
+ * Visual display variants supported by DetailFieldRenderer.
  */
-interface DetailCustom<TDoc = any> {
-    /** Identifies this item as a custom component. */
-    type: "custom";
-    /** Registered custom component name. */
-    name: string;
-    /** Custom component options. */
-    options?: DetailCustomOptions<TDoc>;
-}
+type DisplayVariant = "text" | "badge" | "code-badge" | "code" | "copyable" | "link" | "url" | "email" | "phone" | "currency" | "percent" | "progress" | "star" | "star-rating" | "boolean" | "date" | "datetime" | "time" | "relative" | "image" | "avatar" | "color" | "color-swatches" | "icon" | "key-value" | "table" | "tags" | "badges" | "json";
 /**
- * Configuration options for rendering an action button in a Detail View.
+ * Configuration options for rendering a field in a Detail View.
  */
-interface DetailActionOptions {
+interface DisplayFieldOptions {
+    /** Custom label overriding the field's schema label. */
+    label?: string;
+    /** When true, hides the field label entirely and renders only the value. */
+    hideLabel?: boolean;
+    /** Informational tooltip shown next to the label. */
+    tooltip?: string;
     /** Grid column span across the 12-column grid. */
     span?: DetailSpan;
-    /** Button visual style. Defaults to `'outline'`. */
-    variant?: "default" | "outline" | "secondary" | "ghost" | "destructive";
-    /** Button size. Defaults to `'sm'`. */
-    size?: "sm" | "default";
-    /** Overrides the action's own `label` for this placement. */
-    label?: string;
+    /** Specific visual representation variant (e.g. 'badge', 'currency', 'star', 'copyable'). */
+    display?: DisplayVariant;
+    /** Preset format for numbers, dates, and currencies ('currency', 'date', 'datetime', 'relative', 'number', 'percent'). */
+    format?: "currency" | "date" | "datetime" | "relative" | "number" | "percent" | string;
+    /** ISO currency code (e.g. 'USD', 'EUR') when display or format is 'currency'. */
+    currency?: string;
+    /** Color mapping for badge and tag values (named palette, hex color, Tailwind class, or wildcard). */
+    badgeColors?: Record<string, string>;
+    /** Column header for object keys when display is 'key-value'. */
+    keyLabel?: string;
+    /** Column header for object values when display is 'key-value'. */
+    valueLabel?: string;
+    /** Custom placeholder text when the field value is null, undefined, or empty. */
+    emptyText?: string;
+    /** When true, hides this entire field item if the value is null or empty. */
+    hideIfEmpty?: boolean;
     /**
-     * Visibility condition for this action item.
+     * When true, allows inline editing of this field in the Detail View
+     * via an interactive toggle.
+     */
+    editable?: boolean;
+    /**
+     * Visibility condition for this field item.
      * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     * When false or evaluating to falsy, this item is hidden in the Detail View.
+     *
+     * @example `visible: "doc.status == 'published'"`
+     * @example `visible: false`
      */
     visible?: string | boolean;
+    /** Specific aspect ratio constraint for media (e.g., "16/9", "4/3", "1/1", "auto"). */
+    aspectRatio?: string;
+    /** CSS object-fit behavior for media ('cover', 'contain', 'fill', 'scale-down'). */
+    objectFit?: "cover" | "contain" | "fill" | "scale-down";
+    /** Media alignment ('left', 'center', 'right'). */
+    align?: "left" | "center" | "right";
+    /** Fixed pixel width or CSS dimension for media preview. */
+    width?: string | number;
+    /** Fixed pixel height or CSS dimension for media preview. */
+    height?: string | number;
 }
 /**
- * Renders a button for a named action from `collection.actions` at this
- * position in a Detail View. The same action (and its confirm dialog, modal
- * fields, and execution) can also render automatically in the Detail View's
- * header toolbar when the action's `type` is `'header'` — placing it here
- * too does not duplicate that config, it just adds another entry point to
- * the same action.
- */
-interface DetailAction {
-    /** Identifies this item as an action button. */
-    type: "action";
-    /** Name of the action, matching an entry in `collection.actions`. */
-    name: string;
-    /** Display and visibility options for this placement. */
-    options?: DetailActionOptions;
-}
-/**
- * Union of all valid item types in a Detail View schema.
- */
-type DetailItem<TDoc = any> = DetailSection | DetailTabs | DetailGrid | DetailField | DetailRepeat | DetailComputed<TDoc> | DetailDivider | DetailText | DetailCustom<TDoc> | DetailAction | string;
-/**
- * Detail View layout schema definition for a collection or global.
- */
-type DetailSchema<TDoc = any> = DetailItem<TDoc>[];
-
-/**
- * The set of type-cast operations supported during aggregation.
- *
- * Each adapter maps these to its own native conversion primitive
- * (e.g. `$toDouble` in MongoDB, `CAST(x AS REAL)` in SQLite).
- * The public API is always database-independent.
- */
-type AggregateCastType = "number" | "integer" | "float" | "string" | "boolean" | "date";
-/**
- * A `count` aggregate operation.
- *
- * - `count: "*"` — count every document matched by `where`.
- * - `cast` is intentionally absent: counting is document-level,
- *   not field-value-level, so type conversion has no meaning here.
- */
-interface CountOperation {
-    count: "*";
-    where?: Record<string, unknown>;
-}
-/**
- * A `countDistinct` aggregate operation that counts the number of unique
- * non-null values for a specific field.
- */
-interface DistinctCountOperation {
-    countDistinct: string;
-    where?: Record<string, unknown>;
-}
-/**
- * A `distinct` aggregate operation that retrieves the unique values
- * (or unique values with item counts) for a specific field.
- */
-interface DistinctValuesOperation {
-    distinct: string;
-    where?: Record<string, unknown>;
-}
-/**
- * A `sum`, `avg`, `min`, or `max` aggregate operation on a named field.
- *
- * - `cast` converts stored values before the aggregation runs.
- *   Invalid values (e.g. `"unknown"` cast to `number`) become `null`
- *   and are ignored by `sum`, `avg`, `min`, and `max`.
- */
-interface NumericOperation {
-    sum?: string;
-    avg?: string;
-    min?: string;
-    max?: string;
-    cast?: AggregateCastType;
-    where?: Record<string, unknown>;
-}
-/**
- * A single named aggregate request — either a count, distinct count, distinct values, or numeric operation.
- */
-type AggregateOperation = CountOperation | DistinctCountOperation | DistinctValuesOperation | NumericOperation;
-/**
- * The map of named aggregate operations sent in a single aggregate request.
- *
- * @example
- * ```ts
- * {
- *   totalSubmitted: { count: "*" },
- *   uniqueGuests: { countDistinct: "email" },
- *   availableSizes: { distinct: "asoebiSize" },
- *   totalAsoebiYards: { sum: "asoebiYards", cast: "number", where: { wantsAsoebi: { equals: true } } },
- * }
- * ```
- */
-type AggregateInput = Record<string, AggregateOperation>;
-/**
- * The arguments passed to `DatabaseAdapter.aggregate`.
+ * Declared field item in a Detail View.
  */
-interface AggregateArgs {
-    /** Collection slug. */
-    collection: string;
-    /** Named aggregate operations to compute. */
-    aggregates: AggregateInput;
-    /** Optional field to group the aggregates by. */
-    groupBy?: string;
+interface DetailField {
+    /** Identifies this item as a field. */
+    type: "field";
+    /** Field name or nested path in the document. */
+    field: string;
+    /** Display options for this field. */
+    options?: DisplayFieldOptions;
 }
 /**
- * The result returned by `DatabaseAdapter.aggregate`.
- *
- * For scalar aggregates, every named key maps to a `number | null` or `any[]` (for distinct).
- * When `groupBy` is used, returns a breakdown per group.
- */
-type AggregateResult = Record<string, any>;
-/**
- * Derives the typed result shape from an `AggregateInput`.
- */
-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.
+ * Configuration options for a Detail View section container.
  */
-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[] | readonly WhereClause[];
-    or?: WhereClause[] | readonly WhereClause[];
-    AND?: WhereClause[] | readonly WhereClause[];
-    and?: WhereClause[] | readonly WhereClause[];
-};
-interface SqlWhereResult {
-    sql: string;
-    params: any[];
+interface DetailSectionOptions {
+    /** Lucide icon name displayed in the section header. */
+    icon?: string;
+    /** Status or counter badge displayed beside the section title. */
+    badge?: string;
+    /** Color palette name or hex code for the section badge. */
+    badgeColor?: string;
+    /** Subtitle description displayed beneath the section title. */
+    description?: string;
+    /** Grid width of the section on the main 12-column layout. */
+    span?: DetailSpan;
+    /** Internal grid column count for child items. */
+    columns?: number;
+    /** When true, allows editors to collapse and expand the section. */
+    collapsible?: boolean;
+    /** Starts the section in collapsed state when collapsible is enabled. */
+    collapsedByDefault?: boolean;
+    /**
+     * Visibility condition for this section.
+     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     *
+     * @example `visible: "user.roles != null and 'admin' in user.roles"`
+     */
+    visible?: string | boolean;
 }
 /**
- * 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/…
+ * Section container grouping fields and components in a Detail View.
  */
-declare function parseSqlWhere(where: WhereClause, getJsonField: (field: string) => string, placeholder?: '?' | 'pg', 
+interface DetailSection {
+    /** Identifies this item as a section. */
+    type: "section";
+    /** Section heading title. */
+    title: string;
+    /** Child items rendered inside this section. */
+    items: DetailItem[];
+    /** Section container options. */
+    options?: DetailSectionOptions;
+}
 /**
- * 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.
+ * Configuration options for an individual tab in `displayTabs()`.
  */
-likeOperator?: 'LIKE' | 'ILIKE'): SqlWhereResult;
+interface DetailTabOptions {
+    /** Lucide icon name displayed inside the tab trigger. */
+    icon?: string;
+    /** Counter or status badge rendered next to the tab label. */
+    badge?: string;
+    /** Color palette name or hex code for the tab badge. */
+    badgeColor?: string;
+    /**
+     * Visibility condition for this individual tab.
+     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     */
+    visible?: string | boolean;
+}
 /**
- * Translates a WhereClause into a MongoDB filter object.
- * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
+ * Single tab entry inside a tabbed container.
  */
-declare function parseMongoWhere(where: WhereClause): Record<string, any>;
-
+interface DetailTab {
+    /** Identifies this item as a tab. */
+    type: "tab";
+    /** Tab label shown in the tab bar. */
+    label: string;
+    /** Child items rendered when this tab is active. */
+    items: DetailItem[];
+    /** Tab options. */
+    options?: DetailTabOptions;
+}
 /**
- * Custom component slots rendered around an operational view's content.
+ * Configuration options for a tabbed container.
  */
-type ViewComponentSlots = CollectionViewComponentSlots;
+interface DetailTabsOptions {
+    /** Grid width of the tabs container on the main layout. */
+    span?: DetailSpan;
+    /** Label of the tab that should be active on initial render. */
+    defaultTab?: string;
+    /**
+     * Visibility condition for this tab container.
+     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     */
+    visible?: string | boolean;
+}
 /**
- * Supported layout engines for operational views in the Dyrected Admin UI:
- * - `'table'`: The workhorse — column sorting, search, faceted filters, and bulk actions.
- * - `'spreadsheet'`: Inline-editable matrix with batch saving (`Save changes` / `Discard`).
- * - `'kanban'`: Interactive card board grouped by status or category with drag-and-drop.
- * - `'calendar'`: Event schedule grid plotting records across month/week/day views by date.
- * - `'gantt'`: Timeline bars plotted across start and end dates.
- * - `'cards'`: Visual image/thumbnail gallery grid.
+ * Tabbed navigation container in a Detail View layout.
  */
-type ViewLayout = 'table' | 'spreadsheet' | 'kanban' | 'calendar' | 'gantt' | 'cards';
+interface DetailTabs {
+    /** Identifies this item as a tab container. */
+    type: "tabs";
+    /** List of tabs in this container. */
+    tabs: DetailTab[];
+    /** Tab container options. */
+    options?: DetailTabsOptions;
+}
 /**
- * Scope and placement for an operational view action:
- * - `'row'`: Renders as an inline action button on each document/row.
- * - `'bulk'`: Appears in the floating bulk action bar when one or more rows are selected.
- * - `'header'`: Renders as a primary action button in the view header.
+ * Configuration options for a sub-grid container.
  */
-type ActionType = 'row' | 'bulk' | 'header';
+interface DetailGridOptions {
+    /** Grid width of the sub-grid container in the surrounding layout. */
+    span?: DetailSpan;
+    /**
+     * Visibility condition for this grid container.
+     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     */
+    visible?: string | boolean;
+}
 /**
- * Toggles for the built-in document operations an operational view surfaces.
- * All default to enabled (`true`). Set any to `false` to hide that operation.
- *
- * @example
- * ```ts
- * features: {
- *   delete: false, // Prevent deleting records from this view
- *   exportSelected: true, // Enable CSV export for checked rows
- * }
- * ```
+ * Multi-column sub-grid layout inside a section or tab.
  */
-interface ViewActionFeatures {
-    /** Enables the "View" preview / read-only drawer button. Defaults to `true`. */
-    view?: boolean;
-    /** Enables the "Edit" document form link. Defaults to `true`. */
-    edit?: boolean;
-    /** Enables the "Duplicate" record action. Defaults to `true`. */
-    duplicate?: boolean;
-    /** Enables the "Delete" record action. Defaults to `true`. */
-    delete?: boolean;
-    /** Enables the "Export selected" CSV action in the bulk action bar. Defaults to `true`. */
-    exportSelected?: boolean;
+interface DetailGrid {
+    /** Identifies this item as a grid. */
+    type: "grid";
+    /** Number of balanced columns in this grid. */
+    columns: number;
+    /** Child items rendered across the grid columns. */
+    items: DetailItem[];
+    /** Grid container options. */
+    options?: DetailGridOptions;
 }
 /**
- * Color palette options for metric cards:
- * `'purple' | 'emerald' | 'amber' | 'rose' | 'blue' | 'indigo' | 'cyan' | 'orange'`
+ * Configuration options for a repeated array field.
  */
-type MetricColor = 'purple' | 'emerald' | 'amber' | 'rose' | 'blue' | 'indigo' | 'cyan' | 'orange' | string;
+interface DetailRepeatOptions {
+    /** Layout style for repeated items: 'table', 'cards', or 'list'. */
+    layout?: "table" | "cards" | "list";
+    /** Message shown when the repeated array is empty. */
+    emptyText?: string;
+    /** Grid width of the repeated container. */
+    span?: DetailSpan;
+    /**
+     * Visibility condition for this repeat container.
+     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     */
+    visible?: string | boolean;
+    /** Field name in each row to use as the card header title (e.g. 'title', 'key', 'name'). */
+    useAsTitle?: string;
+    /** Field name in each row to use as the card header title (alias for useAsTitle). */
+    titleField?: string;
+    /** Static card title prefix or template (e.g. 'Category' or 'Card #{index}'). */
+    title?: string;
+    /** Optional icon name for card header. */
+    icon?: string;
+    /** Number of grid columns for cards layout (1, 2, 3, or 4; defaults to 3). */
+    columns?: 1 | 2 | 3 | 4;
+}
 /**
- * A sub-metric breakdown item displayed in the compact footer of a metric card.
- *
- * @example
- * ```ts
- * {
- *   label: "Pending",
- *   aggregates: {
- *     checkedIn: { count: "*", where: { checkedIn: { equals: true } } },
- *     attending: { count: "*", where: { attending: { equals: true } } },
- *   },
- *   expression: "aggregates.attending - aggregates.checkedIn",
- * }
- * ```
+ * Delegated repeated array field item in a Detail View.
  */
-interface ViewSubMetric {
-    /** Short label for the sub-metric (e.g. "Pending", "Collected"). */
-    label: string;
-    /** Single database aggregate operation. */
-    aggregate?: AggregateOperation;
-    /** Map of named aggregate operations referenced in `expression` as `aggregates.key`. */
-    aggregates?: Record<string, AggregateOperation>;
-    /** JEXL math formula evaluated over `value` for a single aggregate (e.g. `"value * 100"`). */
-    transform?: string;
-    /** JEXL math formula evaluated over `aggregates` (e.g. `"aggregates.a - aggregates.b"`). */
-    expression?: string;
-    /** Display formatter: `'currency' | 'number' | 'percent'`. */
-    format?: 'currency' | 'number' | 'percent' | string;
-    /** 3-letter currency code (e.g. `"USD"`, `"NGN"`, `"EUR"`) used when `format: "currency"`. */
-    currency?: string;
+interface DetailRepeat {
+    /** Identifies this item as a repeat container. */
+    type: "repeat";
+    /** Array field name in the document. */
+    field: string;
+    /** Item template schemas rendered for each element in the array. */
+    items: DetailItem[];
+    /** Repeat options. */
+    options?: DetailRepeatOptions;
 }
 /**
- * Configuration for a KPI summary card rendered at the top of an operational view.
- *
- * All aggregations run directly on the database engine for maximum performance.
- *
- * @example
- * ```ts
- * {
- *   label: "Total Revenue",
- *   color: "emerald",
- *   aggregate: { sum: "amount", cast: "number", where: { status: "paid" } },
- *   format: "currency",
- *   currency: "USD",
- * }
- * ```
+ * Async or synchronous handler function calculating a computed metric.
  */
-interface ViewMetric {
-    /** Title displayed on the metric card header. */
-    label: string;
-    /** Accent color for the card's visual indicator. */
-    color?: MetricColor;
-    /** Unit badge shown alongside the numeric value (e.g. `"Guests"`, `"Orders"`, `"Tables"`). */
-    unit?: string;
-    /** Single database aggregate operation (`count`, `distinctCount`, `sum`, `avg`, `min`, `max`). */
-    aggregate?: AggregateOperation;
-    /** Map of named aggregate operations referenced in `expression` as `aggregates.key`. */
-    aggregates?: Record<string, AggregateOperation>;
-    /** JEXL math formula evaluated over `value` for a single aggregate (e.g. `"value * 25000"`). */
-    transform?: string;
-    /** JEXL math formula evaluated over `aggregates` (e.g. `"(aggregates.paid / aggregates.total) * 100"`). */
-    expression?: string;
-    /** Display formatter: `'currency' | 'number' | 'percent'`. */
-    format?: 'currency' | 'number' | 'percent' | string;
-    /** 3-letter currency code (e.g. `"USD"`, `"NGN"`, `"EUR"`) used when `format: "currency"`. */
-    currency?: string;
-    /** Optional secondary breakdown items shown in the card footer. */
-    subMetrics?: ViewSubMetric[];
-}
+type ComputedHandler<TDoc = any> = (context: {
+    doc: TDoc;
+    user?: any;
+    db?: any;
+}) => any | Promise<any>;
 /**
- * Complete configuration for a tailored operational view.
+ * Configuration options for a computed value card.
  */
-interface ViewConfig {
-    /** Stable URL slug for the view (`/collections/:slug/views/:viewSlug`). */
-    slug: string;
-    /** Human-readable title displayed in the sidebar navigation and view header. */
-    label: string;
-    /** Lucide icon name (e.g. `"UserCheck"`, `"Calendar"`, `"Shirt"`, `"TableProperties"`). */
-    icon?: string;
-    /** 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?: 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'`. */
-    dateField?: string;
-    /** Field name for the start date in timeline/gantt views. Required when `layout: 'gantt'`. */
-    startDateField?: string;
-    /** Field name for the end date in timeline/gantt views. Required when `layout: 'gantt'`. */
-    endDateField?: string;
-    /** Field names to show in this view, in order. If omitted, Dyrected infers default display fields. */
-    columns?: string[];
-    /** Default sorting rule when entering the view. */
-    sort?: {
-        field: string;
-        direction: 'asc' | 'desc';
-    };
-    /** Custom workflow actions available in this view. */
-    actions?: ActionConfig[];
-    /** Toggles built-in operations (view/edit/duplicate/delete/export). */
-    features?: ViewActionFeatures;
+interface DetailComputedOptions<TDoc = any> {
+    /** Unique identifier for the computed metric. */
+    id?: string;
+    /** JEXL expression string evaluated against `{ doc, user }`. */
+    expression?: string;
+    /** Async or sync function receiving `{ doc, user, db }` returning the computed value. */
+    handler?: ComputedHandler<TDoc>;
+    /** Grid width for the computed card. */
+    span?: DetailSpan;
+    /** Formatting preset for the computed value ('currency', 'percent', 'number', 'date'). */
+    format?: string;
+    /** Currency code when format is 'currency'. */
+    currency?: string;
     /**
-     * Explicit display order for action buttons — mixing custom action names and built-in names
-     * (`"view"`, `"edit"`, `"duplicate"`, `"delete"`). Unlisted actions append in default order.
+     * Visibility condition for this computed card.
+     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
      */
-    actionOrder?: string[];
-    /** KPI summary cards rendered in the hero row above the view. */
-    metrics?: ViewMetric[];
-    /** Role-based access rules controlling who can see or use this view. */
-    access?: AccessConfig;
+    visible?: string | boolean;
 }
 /**
- * Base configuration shared by all action types.
+ * Computed KPI or metric card in a Detail View.
  */
-interface ActionConfigBase<TDoc extends Record<string, unknown> = Record<string, unknown>> {
-    /** Unique action identifier (e.g. `"checkIn"`, `"markPaid"`). */
-    name: string;
-    /** Button label displayed in the UI. */
+interface DetailComputed<TDoc = any> {
+    /** Identifies this item as a computed value. */
+    type: "computed";
+    /** Unique computed identifier. */
+    id?: string;
+    /** Human-readable card label. */
     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'`. */
-    type?: ActionType;
-    /** Optional confirmation prompt shown before executing (e.g. `"Confirm guest check-in at the door?"`). */
-    confirm?: string;
-    /** Optional interactive modal form fields prompting the user for input before executing. */
-    fields?: Field[];
-    /** Role-based access rules controlling who can trigger this action. */
-    access?: AccessConfig;
+    /** JEXL evaluation string. */
+    expression?: string;
+    /** Computed function handler. */
+    handler?: ComputedHandler<TDoc>;
+    /** Computed options. */
+    options?: DetailComputedOptions<TDoc>;
 }
 /**
- * An operational workflow action with declarative data mutation.
+ * Configuration options for a horizontal divider line.
  */
-interface ActionConfigWithMutation<TDoc extends Record<string, unknown> = Record<string, unknown>> extends ActionConfigBase<TDoc> {
-    /** Declarative database mutation applied to targeted documents (e.g. `{ checkedIn: true, checkedInAt: "now()" }`). */
-    mutation: Partial<TDoc> | Record<string, unknown>;
-    /** Optional server handler for additional logic. */
-    handler?: (context: ActionContext<TDoc>) => Promise<unknown> | unknown;
+interface DetailDividerOptions {
+    /** Grid span in the surrounding layout. */
+    span?: DetailSpan;
+    /**
+     * Visibility condition for this divider.
+     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     */
+    visible?: string | boolean;
+    /** Vertical margin spacing around the divider line. */
+    spacing?: "sm" | "md" | "lg" | "none";
 }
 /**
- * An operational workflow action with server handler.
+ * Horizontal divider line in a Detail View layout.
  */
-interface ActionConfigWithHandler<TDoc extends Record<string, unknown> = Record<string, unknown>> extends ActionConfigBase<TDoc> {
-    /** Self-hosted server handler function executed when the action is triggered (required when mutation is not provided). */
-    handler: (context: ActionContext<TDoc>) => Promise<unknown> | unknown;
-    /** Optional declarative mutation. */
-    mutation?: Partial<TDoc> | Record<string, unknown>;
+interface DetailDivider {
+    /** Identifies this item as a divider. */
+    type: "divider";
+    /** Divider options. */
+    options?: DetailDividerOptions;
 }
 /**
- * An operational workflow action that can mutate data or trigger server logic.
- * Requires either `mutation` or `handler` (or both).
- */
-type ActionConfig<TDoc extends Record<string, unknown> = Record<string, unknown>> = ActionConfigWithMutation<TDoc> | ActionConfigWithHandler<TDoc>;
-/**
- * Context passed to an action's server handler function.
+ * Configuration options for a static text or callout block.
  */
-interface ActionContext<TDoc extends Record<string, unknown> = Record<string, unknown>> {
-    /** The target document (for row actions), or null for header actions. */
-    doc: TDoc | null;
-    /** All targeted documents (for bulk actions). Empty array for header actions. */
-    docs: TDoc[];
-    /** The authenticated acting user, if available. */
-    user: Record<string, unknown> | null;
-    /** User inputs submitted via the action's modal form fields. */
-    input: Record<string, unknown>;
-    /** The collection configuration object. */
-    collection: Record<string, unknown>;
+interface DetailTextOptions {
+    /** Grid width in the 12-column layout. */
+    span?: DetailSpan;
+    /**
+     * Visibility condition for this text block.
+     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     */
+    visible?: string | boolean;
+    /** Typography and alert styling variant ('body', 'heading', 'subheading', 'muted', 'caption', 'callout', 'info', 'warning'). */
+    variant?: "body" | "heading" | "subheading" | "muted" | "caption" | "callout" | "info" | "warning";
+    /** Custom CSS or Tailwind classes applied to the text wrapper. */
+    className?: string;
 }
 /**
- * Role-based access control rules for a view or action.
+ * Static text, heading, callout, or notice block in a Detail View.
  */
-interface AccessConfig {
-    read?: AccessRule<any>;
-    create?: AccessRule<any>;
-    update?: AccessRule<any>;
-    delete?: AccessRule<any>;
+interface DetailText {
+    /** Identifies this item as a text block. */
+    type: "text";
+    /** Text or markdown content. */
+    content: string;
+    /** Text options. */
+    options?: DetailTextOptions;
 }
 /**
- * Base options shared by all operational view types.
+ * Configuration options for a custom React component slot.
  */
-interface DefineViewBaseOptions {
-    /** Stable URL slug for the view (`/collections/:slug/views/:viewSlug`). */
-    slug: string;
-    /** Human-readable title displayed in the sidebar navigation and view header. */
-    label: string;
-    /** Lucide icon name (e.g. `"UserCheck"`, `"Calendar"`, `"Shirt"`, `"TableProperties"`). */
-    icon?: string;
-    /** Base query filter applied before user toolbar filters (e.g. `{ attending: { equals: true } }` or JEXL string). */
-    filter?: Record<string, any> | string;
-    /** Field names to show in this view, in order. If omitted, Dyrected infers default display fields. */
-    columns?: string[];
-    /** Default sorting rule when entering the view. */
-    sort?: {
-        field: string;
-        direction: 'asc' | 'desc';
-    };
-    /** Custom workflow actions available in this view. */
-    actions?: ActionConfig[];
-    /** Toggles built-in operations (view/edit/duplicate/delete/export). */
-    features?: ViewActionFeatures;
+interface DetailCustomOptions<TDoc = any> {
+    /** Grid span in the 12-column layout. */
+    span?: DetailSpan;
     /**
-     * Explicit display order for action buttons — mixing custom action names and built-in names
-     * (`"view"`, `"edit"`, `"duplicate"`, `"delete"`). Unlisted actions append in default order.
+     * Visibility condition for this custom component.
+     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
      */
-    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;
-}
-/** Table view — requires no special fields. */
-interface DefineTableViewOptions extends DefineViewBaseOptions {
-    layout?: 'table' | 'spreadsheet';
-    /** Field name used to organize records into kanban columns or collapsible grouped sections in table, cards, and spreadsheet. */
-    groupBy?: string;
-}
-/** Kanban view — requires `groupBy` to organize into columns. */
-interface DefineKanbanViewOptions extends DefineViewBaseOptions {
-    layout: 'kanban';
-    /** Field name to organize records into kanban columns. */
-    groupBy: string;
-}
-/** Calendar view — requires `dateField` to place records on the calendar. */
-interface DefineCalendarViewOptions extends DefineViewBaseOptions {
-    layout: 'calendar';
-    /** Field name containing the ISO date string for calendar placement. */
-    dateField: string;
-}
-/** Gantt view — requires both `startDateField` and `endDateField`. */
-interface DefineGanttViewOptions extends DefineViewBaseOptions {
-    layout: 'gantt';
-    /** Field name for the start date in the gantt timeline. */
-    startDateField: string;
-    /** Field name for the end date in the gantt timeline. */
-    endDateField: string;
+    visible?: string | boolean;
+    /** Static or initial props passed into the custom component. */
+    props?: Record<string, any>;
+    /** Inline render function receiving `{ doc, user }` (Self-hosted React runtimes). */
+    render?: (context: {
+        doc: TDoc;
+        user?: any;
+        [key: string]: any;
+    }) => any;
 }
-/** Cards view — shows records as image/thumbnail gallery. */
-interface DefineCardsViewOptions extends DefineViewBaseOptions {
-    layout: 'cards';
-    /** Field name used to organize records into groups. */
-    groupBy?: string;
+/**
+ * Custom React component slot mounted in a Detail View.
+ */
+interface DetailCustom<TDoc = any> {
+    /** Identifies this item as a custom component. */
+    type: "custom";
+    /** Registered custom component name. */
+    name: string;
+    /** Custom component options. */
+    options?: DetailCustomOptions<TDoc>;
 }
 /**
- * Options for defining an operational view with `defineView`.
- * Use layout-specific overloads to ensure required fields are provided.
- *
- * @example
- * ```ts
- * export const attendingGuests = defineView({
- *   slug: "attending-guests",
- *   label: "Attending Guests",
- *   icon: "UserCheck",
- *   layout: "table",
- *   groupBy: "tableNumber",
- *   filter: { attending: { equals: true } },
- *   columns: ["name", "email", "guestCount", "checkedIn"],
- *   sort: { field: "name", direction: "asc" },
- * });
- * ```
+ * Configuration options for rendering an action button in a Detail View.
  */
-type DefineViewOptions = DefineTableViewOptions | DefineKanbanViewOptions | DefineCalendarViewOptions | DefineGanttViewOptions | DefineCardsViewOptions;
+interface DetailActionOptions {
+    /** Grid column span across the 12-column grid. */
+    span?: DetailSpan;
+    /** Button visual style. Defaults to `'outline'`. */
+    variant?: "default" | "outline" | "secondary" | "ghost" | "destructive";
+    /** Button size. Defaults to `'sm'`. */
+    size?: "sm" | "default";
+    /** Overrides the action's own `label` for this placement. */
+    label?: string;
+    /**
+     * Visibility condition for this action item.
+     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     */
+    visible?: string | boolean;
+}
 /**
- * Options for defining a custom workflow action with `defineAction`.
- *
- * @example
- * ```ts
- * export const checkInAction = defineAction({
- *   name: "checkIn",
- *   label: "Check In",
- *   icon: "UserCheck",
- *   type: "row",
- *   confirm: "Confirm guest check-in at the door?",
- *   mutation: { checkedIn: true, checkedInAt: "now()" },
- * });
- * ```
+ * Renders a button for a named action from `collection.actions` at this
+ * position in a Detail View. The same action (and its confirm dialog, modal
+ * fields, and execution) can also render automatically in the Detail View's
+ * header toolbar when the action's `type` is `'header'` — placing it here
+ * too does not duplicate that config, it just adds another entry point to
+ * the same action.
  */
-interface DefineActionOptions<TDoc extends Record<string, unknown> = Record<string, unknown>> {
-    /** Unique action identifier (e.g. `"checkIn"`, `"markPaid"`). */
+interface DetailAction {
+    /** Identifies this item as an action button. */
+    type: "action";
+    /** Name of the action, matching an entry in `collection.actions`. */
     name: string;
-    /** Button label displayed in the UI. */
-    label: 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'`. */
-    type?: ActionType;
-    /** Optional confirmation prompt shown before executing (e.g. `"Confirm guest check-in at the door?"`). */
-    confirm?: string;
-    /** Optional interactive modal form fields prompting the user for input before executing. */
-    fields?: Field[];
-    /** Declarative database mutation applied to targeted documents (e.g. `{ checkedIn: true, checkedInAt: "now()" }`). */
-    mutation?: Partial<TDoc> | Record<string, unknown>;
-    /** Self-hosted server handler function executed when the action is triggered. */
-    handler?: (context: ActionContext<TDoc>) => Promise<unknown> | unknown;
-    /** Role-based access rules controlling who can trigger this action. */
-    access?: AccessConfig;
+    /** Display and visibility options for this placement. */
+    options?: DetailActionOptions;
 }
 /**
- * Defines a typed operational view for a collection.
- * Layout-specific overloads enforce required fields for each view type.
- *
- * @example
- * ```ts
- * // Table view (no special requirements)
- * export const allGuests = defineView({
- *   slug: "all-guests",
- *   label: "All Guests",
- *   layout: "table", // or omit for default
- * });
- *
- * // Kanban view (requires groupBy)
- * export const guestsByTable = defineView({
- *   slug: "by-table",
- *   label: "Guests by Table",
- *   layout: "kanban",
- *   groupBy: "tableNumber", // required!
- * });
- *
- * // Calendar view (requires dateField)
- * export const eventCalendar = defineView({
- *   slug: "event-calendar",
- *   label: "Event Calendar",
- *   layout: "calendar",
- *   dateField: "eventDate", // required!
- * });
- *
- * // Gantt view (requires startDateField and endDateField)
- * export const projectTimeline = defineView({
- *   slug: "timeline",
- *   label: "Project Timeline",
- *   layout: "gantt",
- *   startDateField: "startDate", // required!
- *   endDateField: "endDate", // required!
- * });
- * ```
+ * Union of all valid item types in a Detail View schema.
  */
-declare function defineView(config: DefineTableViewOptions): DefineTableViewOptions;
-declare function defineView(config: DefineKanbanViewOptions): DefineKanbanViewOptions;
-declare function defineView(config: DefineCalendarViewOptions): DefineCalendarViewOptions;
-declare function defineView(config: DefineGanttViewOptions): DefineGanttViewOptions;
-declare function defineView(config: DefineCardsViewOptions): DefineCardsViewOptions;
-declare function defineView<const T extends DefineViewOptions>(config: T): T;
-/** Convenience helper for table views. Enforces no view-specific required fields. */
-declare function defineTableView(config: DefineTableViewOptions): DefineTableViewOptions;
-/** Convenience helper for kanban views. Enforces `groupBy` is provided. */
-declare function defineKanbanView(config: DefineKanbanViewOptions): DefineKanbanViewOptions;
-/** Convenience helper for calendar views. Enforces `dateField` is provided. */
-declare function defineCalendarView(config: DefineCalendarViewOptions): DefineCalendarViewOptions;
-/** Convenience helper for gantt views. Enforces `startDateField` and `endDateField` are provided. */
-declare function defineGanttView(config: DefineGanttViewOptions): DefineGanttViewOptions;
-/** Convenience helper for cards views. Optional `groupBy`. */
-declare function defineCardsView(config: DefineCardsViewOptions): DefineCardsViewOptions;
+type DetailItem<TDoc = any> = DetailSection | DetailTabs | DetailGrid | DetailField | DetailRepeat | DetailComputed<TDoc> | DetailDivider | DetailText | DetailCustom<TDoc> | DetailAction | string;
 /**
- * Defines a custom workflow action for an operational view.
- *
- * @example
- * ```ts
- * export const markPaidAction = defineAction({
- *   name: "markPaid",
- *   label: "Mark Paid",
- *   icon: "DollarSign",
- *   type: "bulk",
- *   confirm: "Mark selected orders as paid?",
- *   mutation: { status: "paid" },
- * });
- * ```
+ * Detail View layout schema definition for a collection or global.
  */
-declare function defineAction<const T extends DefineActionOptions>(config: T): T;
+type DetailSchema<TDoc = any> = DetailItem<TDoc>[];
 
 /**
  * Configures account lockout behavior for an auth-enabled collection.
@@ -2117,6 +2290,13 @@ interface CollectionConfig<TDoc extends object = Record<string, unknown>> {
          * See `CollectionAfterChangeHook` for await-vs-fire-and-forget guidance.
          */
         afterChange?: CollectionAfterChangeHook<TDoc>[];
+        /**
+         * Runs inside the database transaction that persists a create or update,
+         * before it commits. `tx` is writable, so secondary writes commit or roll
+         * back atomically with the document. Throw to abort the whole operation.
+         * Requires a transactional database adapter.
+         */
+        beforeCommit?: CollectionBeforeCommitHook<TDoc>[];
         /** Runs before a document is deleted. Throw to cancel the deletion. */
         beforeDelete?: CollectionBeforeDeleteHook<TDoc>[];
         /**
@@ -2162,6 +2342,10 @@ interface CollectionConfig<TDoc extends object = Record<string, unknown>> {
          * Collections with the same `group` are visually grouped together.
          */
         group?: string;
+        /**
+         * Numeric sort order within navigation or sidebar group (lower numbers appear first).
+         */
+        order?: number;
         /**
          * Slug of the view to render by default when navigating to `/collections/:slug`.
          * If not specified, defaults to the view with `default: true` or the all-records table view.
@@ -2425,6 +2609,10 @@ interface GlobalConfig<TDoc extends object = Record<string, unknown>> {
         icon?: AdminIconName;
         /** Groups this global under a named section in the Admin sidebar. */
         group?: string;
+        /**
+         * Numeric sort order within navigation or sidebar group (lower numbers appear first).
+         */
+        order?: number;
         /** If `true`, this global is not shown in the Admin UI sidebar. */
         hidden?: boolean;
     };
@@ -2476,10 +2664,14 @@ interface DatabaseAdapter {
         /** Row-level locking strategy (e.g. SELECT ... FOR UPDATE in transactions). */
         lock?: "for-update";
     }): Promise<PaginatedResult>;
-    /** Find a single document by its ID. Returns `null` if not found. */
+    /**
+     * Find a single document by its ID or by a `where` filter (the first match
+     * is returned). Returns `null` if not found. Provide `id` or `where`.
+     */
     findOne(args: {
         collection: string;
-        id: string;
+        id?: string;
+        where?: Record<string, unknown>;
         /** Row-level locking strategy (e.g. SELECT ... FOR UPDATE in transactions). */
         lock?: "for-update";
     }): Promise<BaseDocument | null>;
@@ -2655,7 +2847,7 @@ interface ImageService {
     }>;
 }
 
-type FieldType = "text" | "textarea" | "richText" | "number" | "boolean" | "date" | "datetime" | "time" | "select" | "multiSelect" | "radio" | "relationship" | "array" | "object" | "json" | "blocks" | "image" | "email" | "url" | "icon" | "join" | "row";
+type FieldType = "text" | "textarea" | "richText" | "number" | "money" | "boolean" | "date" | "datetime" | "time" | "select" | "multiSelect" | "radio" | "relationship" | "array" | "object" | "json" | "blocks" | "image" | "email" | "url" | "icon" | "join" | "row";
 interface DynamicOptionsResolverArgs {
     /** Database adapter available to server-side option resolvers. */
     db?: DatabaseAdapter;
@@ -2737,6 +2929,12 @@ interface FieldBase {
     required?: boolean;
     /** Whether values for this field must be unique across the collection. */
     unique?: boolean;
+    /**
+     * Whether the value can only be set when the document is created. Any update
+     * that tries to change it is rejected with a validation error. Re-sending the
+     * unchanged value is allowed.
+     */
+    immutable?: boolean;
     /** Default value: literal value or function computed from context. */
     defaultValue?: unknown;
     /** Static or dynamic option source for supported selection fields. */
@@ -3197,6 +3395,13 @@ type NumberFieldAdmin = NumberLimitFieldAdmin & {
     /** How the value is displayed in read-only Admin surfaces (list cells, read-only inputs). Does not affect storage or editing. */
     format?: NumberFormat;
 };
+type MoneyFieldAdmin = {
+    /**
+     * Show the stored minor units as a major-unit amount (for example `5250000`
+     * as `52,500.00`) in the Admin. Defaults to `true`. Does not affect storage or the API.
+     */
+    displayMinorAsMajor?: boolean;
+};
 type DateFieldAdmin = {
     /** How the value is displayed in read-only Admin surfaces (list cells, read-only inputs). Does not affect storage or editing. */
     format?: DateFormat;
@@ -3274,6 +3479,22 @@ type SelectField = TypedField<"select", string, SelectFieldAdmin>;
 type RadioField = TypedField<"radio", string, RadioFieldAdmin>;
 /** A numeric value. Optional advisory `min`/`max` guide editors without enforcing server-side validation. */
 type NumberField = TypedField<"number", number, NumberFieldAdmin> & NumberLimitFieldConfig;
+/** Currency settings for a `money` field. */
+interface MoneyFieldConfig {
+    /** Fixed ISO 4217 currency code for every value, for example `"NGN"`. */
+    currency?: string;
+    /** Name of a sibling field holding the ISO 4217 currency code for each document. Overrides `currency`. */
+    currencyField?: string;
+    /** Digits after the decimal point in the major unit. Defaults to `2` (kobo, cents). */
+    decimals?: number;
+}
+/**
+ * A monetary amount stored as an integer count of minor units (kobo, cents),
+ * so arithmetic never suffers floating-point drift. The API reads and writes
+ * the integer; only the Admin formats it as a major-unit amount. Values must be
+ * safe integers, and integer strings are accepted and converted.
+ */
+type MoneyField = TypedField<"money", number, MoneyFieldAdmin> & MoneyFieldConfig;
 /** A `true`/`false` value, shown to editors as a checkbox or switch. */
 type BooleanField = TypedField<"boolean", boolean, BooleanFieldAdmin>;
 /**
@@ -3343,7 +3564,7 @@ type JoinField = TypedField<"join", unknown, JoinFieldAdmin> & {
 };
 /** A layout-only container that arranges its child `fields` horizontally in the admin UI. Stores no value of its own. */
 type RowField = TypedField<"row", unknown>;
-type Field = TextField | TextareaField | EmailField | UrlField | IconField | DateField | DateTimeField | TimeField | SelectField | RadioField | NumberField | BooleanField | MultiSelectField | RelationshipField | ImageField | RichTextField | JsonField | ObjectField | ArrayField | BlocksField | JoinField | RowField;
+type Field = TextField | TextareaField | EmailField | UrlField | IconField | DateField | DateTimeField | TimeField | SelectField | RadioField | NumberField | MoneyField | BooleanField | MultiSelectField | RelationshipField | ImageField | RichTextField | JsonField | ObjectField | ArrayField | BlocksField | JoinField | RowField;
 interface UploadConfig {
     /** Allowed MIME types for uploaded files. */
     allowedMimeTypes?: string[];
@@ -3504,6 +3725,56 @@ interface AdminAuthConfig {
     resolveAccess?: (args: AdminAuthResolveAccessArgs) => Promise<AdminAuthAccessResolution> | AdminAuthAccessResolution;
 }
 
+/** Minimal structural logger handed to task handlers (a pino logger satisfies it). */
+interface TaskLogger {
+    info(obj: unknown, msg?: string): void;
+    warn(obj: unknown, msg?: string): void;
+    error(obj: unknown, msg?: string): void;
+}
+interface TaskContext {
+    /** The database adapter. */
+    db: DatabaseAdapter;
+    /** Logger scoped to this task. */
+    logger: TaskLogger;
+    /**
+     * Aborted when the run exceeds `lockTimeout`. Pass it to `fetch` or check it
+     * in long loops so an overrunning task stops touching data after its lock lapses.
+     */
+    signal: AbortSignal;
+    /** The cron slot this run was started for, or `undefined` for a manual run. */
+    scheduledFor?: Date;
+}
+/**
+ * A named background job. Define it with `defineTask` and list it under
+ * `tasks` in your config, then run it with `createTaskRunner`.
+ */
+interface TaskConfig {
+    /** Unique, stable name, for example `wallet:ledger-drift`. Also the lock key. */
+    name: string;
+    /**
+     * Standard five-field cron expression (`minute hour day-of-month month day-of-week`),
+     * evaluated in UTC. Omit for a task that only runs when you call `runTask`.
+     */
+    cron?: string;
+    /**
+     * Seconds a run may hold its lock before another instance may take over,
+     * and before its `signal` is aborted. Defaults to 300.
+     */
+    lockTimeout?: number;
+    /** The work to do. Throw to record the run as failed. */
+    run: (context: TaskContext) => void | Promise<void>;
+}
+type TaskRunStatus = "completed" | "failed" | "skipped";
+interface TaskRunResult {
+    name: string;
+    status: TaskRunStatus;
+    /** Why a run was skipped. */
+    reason?: "locked" | "not-due";
+    /** Failure message when `status` is `"failed"`. */
+    error?: string;
+    durationMs: number;
+}
+
 type DyrectedLoggerConfig = {
     options: LoggerOptions;
     destination?: DestinationStream;
@@ -3742,6 +4013,11 @@ interface DyrectedConfig<TUser extends AuthenticatedUser = AuthenticatedUser> {
     redis?: {
         url: string;
     };
+    /**
+     * Background tasks. Define each with `defineTask`, then run them with
+     * `createTaskRunner(config)`.
+     */
+    tasks?: TaskConfig[];
     /** Durable lifecycle-event delivery configuration. */
     events?: {
         handlers: LifecycleEventHandler[];
@@ -3954,4 +4230,4 @@ interface DyrectedContext {
  */
 declare function createDyrectedApp(rawConfig: DyrectedConfig | any): Promise<Hono<DyrectedContext, hono_types.BlankSchema, "/">>;
 
-export { type ImageField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailTabs as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailTextOptions as I, type DetailText as J, type DetailSchema as K, type LifecycleEventName as L, type DyrectedContext as M, type AIConfig as N, type AIPIIConfig as O, type PublicAdminAuthConfig as P, type IdStrategy as Q, type ArrayField as R, type FieldType as S, type BooleanField as T, type AuthConfig as U, type AccessPolicyResolver as V, type WorkflowConfig as W, type DateField as X, type DateTimeField as Y, type EmailField as Z, type IconField as _, type DeclarativeHookExpression as a, type BlocksField as a$, type JoinField as a0, type JsonField as a1, type MultiSelectField as a2, type NumberField as a3, type ObjectField as a4, type RadioField as a5, type RelationshipField as a6, type RichTextField as a7, type RowField as a8, type SelectField as a9, type AccessRule as aA, type ActionConfig as aB, type ActionConfigBase as aC, type ActionConfigWithHandler as aD, type ActionConfigWithMutation as aE, type ActionContext as aF, type ActionType as aG, type AdminAuthAccessResolution as aH, type AdminAuthClaimMapping as aI, type AdminAuthMember as aJ, type AdminAuthProvider as aK, type AdminAuthProviderMembersConfig as aL, type AdminAuthProvisioningMode as aM, type AdminAuthResolveAccessArgs as aN, type AdminAuthResolvedIdentity as aO, type AdminConfig as aP, type AdminDashboardComponentSlots as aQ, type AdminIconName as aR, type AggregateArgs as aS, type AggregateCastType as aT, type AggregateCollectionResult as aU, type AggregateInput as aV, type AggregateOperation as aW, type AggregateResult as aX, type BaseAdminAuthProvider as aY, type BaseFieldAdmin as aZ, type BlockVariant as a_, type TextField as aa, type TextareaField as ab, type TimeField as ac, type UrlField as ad, type AIAction as ae, type AIActionStatus as af, type AIActionType as ag, type AIAuditActionType as ah, type AIAuditRecord as ai, type AIChunk as aj, type AIMessage as ak, type AIPIIPattern as al, type AIRateLimitResult as am, type AIRateLimitStore as an, type AIThread as ao, type AIToolContext as ap, type AIToolDefinition as aq, AI_ACTIONS_COLLECTION as ar, AI_AUDIT_COLLECTION as as, AI_CHUNKS_COLLECTION as at, AI_MESSAGES_COLLECTION as au, AI_THREADS_COLLECTION as av, type AccessConfig as aw, type AccessFunction as ax, type AccessFunctionArgs as ay, type AccessResult as az, type AuthenticatedUser as b, type GlobalAfterChangeHook as b$, type BooleanFieldAdmin as b0, type BooleanFormat as b1, type CharacterLimitFieldAdmin as b2, type CharacterLimitFieldConfig as b3, type CollectionAfterChangeHook as b4, type CollectionAfterDeleteHook as b5, type CollectionAfterReadHook as b6, type CollectionAfterReadHookEntry as b7, type CollectionAfterTransitionHook as b8, type CollectionBeforeChangeHook as b9, type DisplayTone as bA, type DisplayVariant as bB, type DistinctCountOperation as bC, type DistinctValuesOperation as bD, type DynamicOptionItem as bE, type DynamicOptionsConfig as bF, type DynamicOptionsResolver as bG, type DynamicOptionsResolverArgs as bH, type DyrectedAIContext as bI, type DyrectedLoggerConfig as bJ, type DyrectedObservabilityConfig as bK, type EmailFieldAdmin as bL, type FieldAdminHooks as bM, type FieldAdminOnChangeHook as bN, type FieldAdminOnChangeHookArgs as bO, type FieldAdminOptionsHook as bP, type FieldAdminOptionsHookArgs as bQ, type FieldAdminOptionsHookResult as bR, type FieldAfterReadHook as bS, type FieldAfterReadHookArgs as bT, type FieldBase as bU, type FieldBeforeChangeHook as bV, type FieldBeforeChangeHookArgs as bW, type FieldHook as bX, type FieldHooks as bY, type FileData as bZ, type GetDocumentResult as b_, type CollectionBeforeChangeHookEntry as ba, type CollectionBeforeDeleteHook as bb, type CollectionBeforeReadHook as bc, type CollectionBeforeReadHookEntry as bd, type CollectionBeforeTransitionHook as be, type CollectionIndex as bf, type CollectionListComponentSlots as bg, type CollectionRAGConfig as bh, type CollectionSchemaResult as bi, type CollectionSummaryResult as bj, type CollectionViewComponentSlots as bk, type CountOperation as bl, type CustomAdminAuthProvider as bm, type DatabaseAdapter as bn, type DateFieldAdmin as bo, type DateFormat as bp, type DefaultValueContext as bq, type DefineActionOptions as br, type DefineCalendarViewOptions as bs, type DefineCardsViewOptions as bt, type DefineGanttViewOptions as bu, type DefineKanbanViewOptions as bv, type DefineTableViewOptions as bw, type DefineViewBaseOptions as bx, type DefineViewOptions as by, type DetailSpan as bz, type WorkflowTransition as c, type WorkflowMetadata as c$, type GlobalAfterReadHook as c0, type GlobalAfterReadHookEntry as c1, type GlobalBeforeChangeHook as c2, type GlobalBeforeChangeHookEntry as c3, type GlobalBeforeReadHook as c4, type GlobalBeforeReadHookEntry as c5, type GlobalRAGConfig as c6, type GlobalSchemaResult as c7, type GlobalSummaryResult as c8, type HeadingLevel as c9, type RadioFieldAdmin as cA, type RateLimitConfig as cB, type ReadonlyDatabaseAdapter as cC, type RichTextFeature as cD, type RichTextFieldConfig as cE, type SelectFieldAdmin as cF, type SqlWhereResult as cG, type StorageAdapter as cH, type TextFieldAdmin as cI, type TextFormat as cJ, type TextareaFieldAdmin as cK, type TrustProxyConfig as cL, type TypedField as cM, type UploadConfig as cN, type UrlFieldAdmin as cO, type UrlLinkValue as cP, type ViewActionFeatures as cQ, type ViewComponentSlots as cR, type ViewConfig as cS, type ViewLayout as cT, type ViewMetric as cU, type ViewSubMetric as cV, type WhereClause as cW, type WhereOperator as cX, type WhereOperatorName as cY, type WordLimitFieldAdmin as cZ, type WordLimitFieldConfig as c_, type HookFunction as ca, type IconFieldAdmin as cb, type ImageService as cc, type ImageTransformOptions as cd, type InferAggregateResult as ce, type JoinFieldAdmin as cf, type JsonFieldAdmin as cg, type JsonFormat as ch, LIFECYCLE_EVENT_NAMES as ci, type LifecycleEventHandler as cj, type LinkFormat as ck, type MetricColor as cl, type MultiSelectFieldAdmin as cm, type NamedAccessPolicy as cn, type NumberFieldAdmin as co, type NumberFormat as cp, type NumberLimitFieldAdmin as cq, type NumberLimitFieldConfig as cr, type NumericOperation as cs, type NumericUpdateOperator as ct, type OIDCAdminAuthProvider as cu, type OptionFormat as cv, type PaginatedResult as cw, type PublicAdminAuthProvider as cx, type QueryCollectionResult as cy, type RAGSearchResult as cz, type LifecycleEvent as d, type WorkflowRole as d0, type WorkflowState as d1, type WorkflowTransitionContext as d2, defineAction as d3, defineCalendarView as d4, defineCardsView as d5, defineGanttView as d6, defineKanbanView as d7, defineTableView as d8, defineView as d9, resolveSessionTokenExpiry as dA, shouldSampleRequest as dB, signCollectionToken as dC, verifyCollectionToken as dD, isAICollection as da, parseMongoWhere as db, parseSqlWhere as dc, type CollectionTokenPayload as dd, DEFAULT_SESSION_EXPIRY as de, type DyrectedObservabilityRuntime as df, type RequestBodyCapture as dg, type RequestTraceContext as dh, type ResolvedObservabilityConfig as di, attachRequestMetrics as dj, bindObservabilityRuntime as dk, buildRequestLogger as dl, captureRequestBody as dm, createDyrectedApp as dn, createObservabilityRuntime as dp, createRequestSpan as dq, decodeCollectionToken as dr, endRequestSpan as ds, getConfigLogger as dt, getObservabilityRuntime as du, getRequestLogger as dv, redactBody as dw, redactHeaders as dx, renderPrometheusMetrics as dy, resolveObservabilityConfig as dz, type BaseDocument as e, type DetailActionOptions as f, type DetailAction as g, type DetailComputedOptions as h, type ComputedHandler as i, type DetailComputed as j, type DetailCustomOptions as k, type DetailCustom as l, type DetailDividerOptions as m, type DetailDivider as n, type DisplayFieldOptions as o, type DetailField as p, type DetailItem as q, type DetailGridOptions as r, type DetailGrid as s, type DetailRepeatOptions as t, type DetailRepeat as u, type DetailSectionOptions as v, type DetailSection as w, type DetailTabOptions as x, type DetailTab as y, type DetailTabsOptions as z };
+export { type BooleanField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailTab as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailTabsOptions as I, type DetailTabs as J, type DetailTextOptions as K, type LifecycleEventName as L, type DetailText as M, type DetailSchema as N, type DyrectedContext as O, type PublicAdminAuthConfig as P, type AIConfig as Q, type AIPIIConfig as R, type IdStrategy as S, type TaskRunResult as T, type CompiledNavTree as U, type CompiledNavItem as V, type WorkflowConfig as W, type UserNavigationPreferences as X, type DefineWorkspaceOptions as Y, type ArrayField as Z, type FieldType as _, type DeclarativeHookExpression as a, type AggregateCastType as a$, type AuthConfig as a0, type AccessPolicyResolver as a1, type DateField as a2, type DateTimeField as a3, type EmailField as a4, type IconField as a5, type ImageField as a6, type JoinField as a7, type JsonField as a8, type MoneyField as a9, AI_AUDIT_COLLECTION as aA, AI_CHUNKS_COLLECTION as aB, AI_MESSAGES_COLLECTION as aC, AI_THREADS_COLLECTION as aD, type AccessConfig as aE, type AccessFunction as aF, type AccessFunctionArgs as aG, type AccessResult as aH, type AccessRule as aI, type ActionConfig as aJ, type ActionConfigBase as aK, type ActionConfigWithHandler as aL, type ActionConfigWithMutation as aM, type ActionContext as aN, type ActionType as aO, type AdminAuthAccessResolution as aP, type AdminAuthClaimMapping as aQ, type AdminAuthMember as aR, type AdminAuthProvider as aS, type AdminAuthProviderMembersConfig as aT, type AdminAuthProvisioningMode as aU, type AdminAuthResolveAccessArgs as aV, type AdminAuthResolvedIdentity as aW, type AdminConfig as aX, type AdminDashboardComponentSlots as aY, type AdminIconName as aZ, type AggregateArgs as a_, type MultiSelectField as aa, type NumberField as ab, type ObjectField as ac, type RadioField as ad, type RelationshipField as ae, type RichTextField as af, type RowField as ag, type SelectField as ah, type TextField as ai, type TextareaField as aj, type TimeField as ak, type UrlField as al, type AIAction as am, type AIActionStatus as an, type AIActionType as ao, type AIAuditActionType as ap, type AIAuditRecord as aq, type AIChunk as ar, type AIMessage as as, type AIPIIPattern as at, type AIRateLimitResult as au, type AIRateLimitStore as av, type AIThread as aw, type AIToolContext as ax, type AIToolDefinition as ay, AI_ACTIONS_COLLECTION as az, type AuthenticatedUser as b, type FieldAdminOnChangeHookArgs as b$, type AggregateCollectionResult as b0, type AggregateInput as b1, type AggregateOperation as b2, type AggregateResult as b3, type BaseAdminAuthProvider as b4, type BaseFieldAdmin as b5, type BlockVariant as b6, type BlocksField as b7, type BooleanFieldAdmin as b8, type BooleanFormat as b9, DEFAULT_USER_NAV_PREFERENCES as bA, type DateFieldAdmin as bB, type DateFormat as bC, type DefaultValueContext as bD, type DefineActionOptions as bE, type DefineCalendarViewOptions as bF, type DefineCardsViewOptions as bG, type DefineGanttViewOptions as bH, type DefineKanbanViewOptions as bI, type DefineTableViewOptions as bJ, type DefineViewBaseOptions as bK, type DefineViewOptions as bL, type DetailSpan as bM, type DisplayTone as bN, type DisplayVariant as bO, type DistinctCountOperation as bP, type DistinctValuesOperation as bQ, type DynamicOptionItem as bR, type DynamicOptionsConfig as bS, type DynamicOptionsResolver as bT, type DynamicOptionsResolverArgs as bU, type DyrectedAIContext as bV, type DyrectedLoggerConfig as bW, type DyrectedObservabilityConfig as bX, type EmailFieldAdmin as bY, type FieldAdminHooks as bZ, type FieldAdminOnChangeHook as b_, CURRENT_NAV_PREFERENCES_VERSION as ba, type CalendarViewConfig as bb, type CardsViewConfig as bc, type CharacterLimitFieldAdmin as bd, type CharacterLimitFieldConfig as be, type CollectionAfterChangeHook as bf, type CollectionAfterDeleteHook as bg, type CollectionAfterReadHook as bh, type CollectionAfterReadHookEntry as bi, type CollectionAfterTransitionHook as bj, type CollectionBeforeChangeHook as bk, type CollectionBeforeChangeHookEntry as bl, type CollectionBeforeCommitHook as bm, type CollectionBeforeDeleteHook as bn, type CollectionBeforeReadHook as bo, type CollectionBeforeReadHookEntry as bp, type CollectionBeforeTransitionHook as bq, type CollectionIndex as br, type CollectionListComponentSlots as bs, type CollectionRAGConfig as bt, type CollectionSchemaResult as bu, type CollectionSummaryResult as bv, type CollectionViewComponentSlots as bw, type CompiledNavGroup as bx, type CountOperation as by, type CustomAdminAuthProvider as bz, type WorkflowTransition as c, type StorageAdapter as c$, type FieldAdminOptionsHook as c0, type FieldAdminOptionsHookArgs as c1, type FieldAdminOptionsHookResult as c2, type FieldAfterReadHook as c3, type FieldAfterReadHookArgs as c4, type FieldBase as c5, type FieldBeforeChangeHook as c6, type FieldBeforeChangeHookArgs as c7, type FieldHook as c8, type FieldHooks as c9, type MetricColor as cA, type MoneyFieldAdmin as cB, type MoneyFieldConfig as cC, type MultiSelectFieldAdmin as cD, type NamedAccessPolicy as cE, type NavBadgeConfig as cF, type NavGroup as cG, type NumberFieldAdmin as cH, type NumberFormat as cI, type NumberLimitFieldAdmin as cJ, type NumberLimitFieldConfig as cK, type NumericOperation as cL, type NumericUpdateOperator as cM, type OIDCAdminAuthProvider as cN, type OptionFormat as cO, type PaginatedResult as cP, type PinnedNavItemRef as cQ, type PublicAdminAuthProvider as cR, type QueryCollectionResult as cS, type RAGSearchResult as cT, type RadioFieldAdmin as cU, type RateLimitConfig as cV, type ReadonlyDatabaseAdapter as cW, type RichTextFeature as cX, type RichTextFieldConfig as cY, type SelectFieldAdmin as cZ, type SqlWhereResult as c_, type FileData as ca, type GanttViewConfig as cb, type GetDocumentResult as cc, type GlobalAfterChangeHook as cd, type GlobalAfterReadHook as ce, type GlobalAfterReadHookEntry as cf, type GlobalBeforeChangeHook as cg, type GlobalBeforeChangeHookEntry as ch, type GlobalBeforeReadHook as ci, type GlobalBeforeReadHookEntry as cj, type GlobalRAGConfig as ck, type GlobalSchemaResult as cl, type GlobalSummaryResult as cm, type HeadingLevel as cn, type HookFunction as co, type IconFieldAdmin as cp, type ImageService as cq, type ImageTransformOptions as cr, type InferAggregateResult as cs, type JoinFieldAdmin as ct, type JsonFieldAdmin as cu, type JsonFormat as cv, type KanbanViewConfig as cw, LIFECYCLE_EVENT_NAMES as cx, type LifecycleEventHandler as cy, type LinkFormat as cz, type LifecycleEvent as d, renderPrometheusMetrics as d$, type TableViewConfig as d0, type TaskContext as d1, type TaskLogger as d2, type TaskRunStatus as d3, type TextFieldAdmin as d4, type TextFormat as d5, type TextareaFieldAdmin as d6, type TrustProxyConfig as d7, type TypedField as d8, type UploadConfig as d9, defineKanbanView as dA, defineTableView as dB, defineView as dC, defineWorkspace as dD, isAICollection as dE, parseMongoWhere as dF, parseSqlWhere as dG, type CollectionTokenPayload as dH, DEFAULT_SESSION_EXPIRY as dI, type DyrectedObservabilityRuntime as dJ, type RequestBodyCapture as dK, type RequestTraceContext as dL, type ResolvedObservabilityConfig as dM, attachRequestMetrics as dN, bindObservabilityRuntime as dO, buildRequestLogger as dP, captureRequestBody as dQ, createDyrectedApp as dR, createObservabilityRuntime as dS, createRequestSpan as dT, decodeCollectionToken as dU, endRequestSpan as dV, getConfigLogger as dW, getObservabilityRuntime as dX, getRequestLogger as dY, redactBody as dZ, redactHeaders as d_, type UrlFieldAdmin as da, type UrlLinkValue as db, type ViewActionFeatures as dc, type ViewComponentSlots as dd, type ViewConfig as de, type ViewConfigBase as df, type ViewLayout as dg, type ViewMetric as dh, type ViewSubMetric as di, type WhereClause as dj, type WhereOperator as dk, type WhereOperatorName as dl, type WordLimitFieldAdmin as dm, type WordLimitFieldConfig as dn, type WorkflowMetadata as dp, type WorkflowOnTransitionContext as dq, type WorkflowOnTransitionHook as dr, type WorkflowRole as ds, type WorkflowState as dt, type WorkflowTransitionContext as du, coerceBooleanWhere as dv, defineAction as dw, defineCalendarView as dx, defineCardsView as dy, defineGanttView as dz, type DatabaseAdapter as e, resolveObservabilityConfig as e0, resolveSessionTokenExpiry as e1, shouldSampleRequest as e2, signCollectionToken as e3, verifyCollectionToken as e4, type BaseDocument as f, type TaskConfig as g, type DetailActionOptions as h, type DetailAction as i, type DetailComputedOptions as j, type ComputedHandler as k, type DetailComputed as l, type DetailCustomOptions as m, type DetailCustom as n, type DetailDividerOptions as o, type DetailDivider as p, type DisplayFieldOptions as q, type DetailField as r, type DetailItem as s, type DetailGridOptions as t, type DetailGrid as u, type DetailRepeatOptions as v, type DetailRepeat as w, type DetailSectionOptions as x, type DetailSection as y, type DetailTabOptions as z };