@dyrected/core 2.15.0 → 2.17.0

package/dist/{app-Cmp5lFLJ.d.ts → app-CLdT_0se.d.ts}

@@ -446,1356 +446,1458 @@ 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>;
-
-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;
-    /**
-     * 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.
-     */
-    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;
-}
-interface WorkflowRole {
-    /** Existing user role value, for example `editor` or `publisher`. */
-    role: string;
-    capabilities: string[];
+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[];
 }
 /**
- * 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`.
+ * 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/…
  */
-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>[];
-    };
-}
-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;
-    /** Request context for the transition. */
-    req: HookRequestContext;
-    /** Transaction-scoped database adapter for reads and writes inside the hook. */
-    db: DatabaseAdapter;
+declare function parseSqlWhere(where: WhereClause, getJsonField: (field: string) => string, placeholder?: '?' | 'pg', 
+/**
+ * SQL keyword used for `contains`/`starts_with`. Postgres `LIKE` is
+ * case-sensitive, so the Postgres adapter defaults to `'ILIKE'` to keep substring
+ * matching case-insensitive like SQLite and MySQL.
+ */
+likeOperator?: 'LIKE' | 'ILIKE'): SqlWhereResult;
+/**
+ * Translates a WhereClause into a MongoDB filter object.
+ * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
+ */
+declare function parseMongoWhere(where: WhereClause): Record<string, any>;
+
+/**
+ * Custom component slots rendered around an operational view's content.
+ */
+type ViewComponentSlots = CollectionViewComponentSlots;
+/**
+ * Supported layout engines for operational views in the Dyrected Admin UI:
+ * - `'table'`: The workhorse — column sorting, search, faceted filters, and bulk actions.
+ * - `'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;
 }
-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;
+/**
+ * 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;
+    /** 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;
 }
-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.
+ * 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",
+ * }
+ * ```
  */
-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";
+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[];
+}
 /**
- * Configuration options for rendering a field in a Detail View.
+ * Base configuration shared by all action 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;
+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;
 }
 /**
- * Declared field item in a Detail View.
+ * An operational workflow action with declarative data mutation.
  */
-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;
+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;
 }
 /**
- * Configuration options for a Detail View section container.
+ * An operational workflow action with server handler.
  */
-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 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>;
 }
 /**
- * Section container grouping fields and components in a Detail View.
+ * An operational workflow action that can mutate data or trigger server logic.
+ * Requires either `mutation` or `handler` (or both).
  */
-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;
+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>;
 }
 /**
- * Configuration options for an individual tab in `displayTabs()`.
+ * Role-based access control rules for a view or action.
  */
-interface DetailTabOptions {
-    /** Lucide icon name displayed inside the tab trigger. */
+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;
-    /** Counter or status badge rendered next to the tab label. */
-    badge?: string;
-    /** Color palette name or hex code for the tab badge. */
-    badgeColor?: 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;
     /**
-     * Visibility condition for this individual tab.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     * Explicit display order for action buttons — mixing custom action names and built-in names
+     * (`"view"`, `"edit"`, `"duplicate"`, `"delete"`). Unlisted actions append in default order.
      */
-    visible?: string | 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;
+}
+/** 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;
+}
+/** Kanban view — requires `groupBy` to organize into columns. */
+interface KanbanViewConfig extends ViewConfigBase {
+    layout: 'kanban';
+    /** Field name to organize records into kanban columns. */
+    groupBy: 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;
 }
-/**
- * Single tab entry inside a tabbed container.
- */
-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;
+/** 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;
+}
+/** Cards view — shows records as image/thumbnail gallery. */
+interface CardsViewConfig extends ViewConfigBase {
+    layout: 'cards';
+    /** Field name used to organize records into groups. */
+    groupBy?: string;
 }
 /**
- * Configuration options for a tabbed container.
+ * Complete configuration for a tailored operational view.
  */
-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;
-}
+type ViewConfig = TableViewConfig | KanbanViewConfig | CalendarViewConfig | GanttViewConfig | CardsViewConfig;
 /**
- * Tabbed navigation container in a Detail View layout.
+ * Backwards-compatible aliases for builder types.
  */
-interface DetailTabs {
-    /** Identifies this item as a tab container. */
-    type: "tabs";
-    /** List of tabs in this container. */
-    tabs: DetailTab[];
-    /** Tab container options. */
-    options?: DetailTabsOptions;
-}
+type DefineViewBaseOptions = ViewConfigBase;
+type DefineTableViewOptions = TableViewConfig;
+type DefineKanbanViewOptions = KanbanViewConfig;
+type DefineCalendarViewOptions = CalendarViewConfig;
+type DefineGanttViewOptions = GanttViewConfig;
+type DefineCardsViewOptions = CardsViewConfig;
+type DefineViewOptions = ViewConfig;
 /**
- * Configuration options for a sub-grid container.
+ * 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 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;
+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;
 }
 /**
- * Multi-column sub-grid layout inside a section or tab.
+ * 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!
+ * });
+ * ```
  */
-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;
-}
+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;
 /**
- * Configuration options for a repeated array field.
+ * 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 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;
-}
+declare function defineAction<const T extends DefineActionOptions>(config: T): T;
+
 /**
- * Delegated repeated array field item in a Detail View.
+ * Definition of a navigation group in the Dyrected admin sidebar.
  */
-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;
+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;
+}
+/**
+ * Configuration for real-time count badges on navigation items.
+ */
+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";
 }
 /**
- * Async or synchronous handler function calculating a computed metric.
+ * Options for defining an operational workspace, or customizing placement of collections/globals, with `defineWorkspace`.
  */
-type ComputedHandler<TDoc = any> = (context: {
-    doc: TDoc;
-    user?: any;
-    db?: any;
-}) => any | Promise<any>;
+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[];
+}
 /**
- * Configuration options for a computed value card.
+ * 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 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;
-}
+declare function defineWorkspace(options: DefineWorkspaceOptions): DefineWorkspaceOptions;
 /**
- * Computed KPI or metric card in a Detail View.
+ * Runtime compiled representation of a single navigation item.
  */
-interface DetailComputed<TDoc = any> {
-    /** Identifies this item as a computed value. */
-    type: "computed";
-    /** Unique computed identifier. */
-    id?: string;
-    /** Human-readable card label. */
+interface CompiledNavItem {
+    id: string;
+    type: "workspace" | "collection" | "global" | "dashboard" | "link";
+    slug: string;
     label: string;
-    /** JEXL evaluation string. */
-    expression?: string;
-    /** Computed function handler. */
-    handler?: ComputedHandler<TDoc>;
-    /** Computed options. */
-    options?: DetailComputedOptions<TDoc>;
+    icon?: string;
+    group?: string;
+    href?: string;
+    badge?: NavBadgeConfig | string;
+    access?: string[] | AccessRule;
+    order: number;
+    collection?: string;
+    global?: string;
+    views: ViewConfig[];
 }
 /**
- * Configuration options for a horizontal divider line.
+ * Runtime compiled representation of a navigation group containing items.
  */
-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";
+interface CompiledNavGroup {
+    id: string;
+    name: string;
+    slug: string;
+    icon?: string;
+    defaultExpanded?: boolean;
+    order: number;
+    items: CompiledNavItem[];
 }
 /**
- * Horizontal divider line in a Detail View layout.
+ * Complete runtime compiled navigation tree.
  */
-interface DetailDivider {
-    /** Identifies this item as a divider. */
-    type: "divider";
-    /** Divider options. */
-    options?: DetailDividerOptions;
+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 static text or callout block.
+ * Branding and metadata options for the Dyrected Admin UI.
+ *
+ * @example
+ * admin: {
+ *   branding: {
+ *     logo: '/logo.svg',
+ *     primaryColor: '#6366f1',
+ *   },
+ *   meta: {
+ *     titleSuffix: '- My App',
+ *   },
+ * }
  */
-interface DetailTextOptions {
-    /** Grid width in the 12-column layout. */
-    span?: DetailSpan;
+interface AdminConfig {
     /**
-     * Visibility condition for this text block.
-     * 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;
-    /** 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;
+    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;
 }
+
+type DeclarativeHookExpression = string;
 /**
- * Static text, heading, callout, or notice block in a Detail View.
+ * @deprecated Use {@link FieldBeforeChangeHook} or `FieldAfterReadHook` instead.
+ * This alias remains for backwards compatibility.
  */
-interface DetailText {
-    /** Identifies this item as a text block. */
-    type: "text";
-    /** Text or markdown content. */
-    content: string;
-    /** Text options. */
-    options?: DetailTextOptions;
-}
+type FieldHook<TDoc extends object = Record<string, unknown>, TValue = unknown> = FieldBeforeChangeHook<TValue, TDoc>;
 /**
- * Configuration options for a custom React component slot.
+ * 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.
  */
-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;
-}
+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;
 /**
- * Custom React component slot mounted in a Detail View.
+ * Runs after a document (or list of documents) is fetched from the database,
+ * before the response is sent to the client.
  */
-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 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;
 /**
- * Configuration options for rendering an action button in a Detail View.
+ * Runs **before** a document is created or updated in the database.
  */
-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;
-}
+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;
 /**
- * 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.
+ * Runs **after** a document is created or updated in the database.
  */
-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;
-}
+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>;
+/**
+ * Runs **before** a document is deleted from the database.
+ */
+type CollectionBeforeDeleteHook<TDoc extends object = Record<string, unknown>> = (args: {
+    id: string;
+    doc: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    db: ReadonlyDatabaseAdapter;
+}) => void | Promise<void>;
+/**
+ * Runs **after** a document has been deleted from the database.
+ */
+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;
 /**
- * Union of all valid item types in a Detail View schema.
+ * Runs after the global document is fetched, before the response is sent.
  */
-type DetailItem<TDoc = any> = DetailSection | DetailTabs | DetailGrid | DetailField | DetailRepeat | DetailComputed<TDoc> | DetailDivider | DetailText | DetailCustom<TDoc> | DetailAction | string;
+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;
 /**
- * Detail View layout schema definition for a collection or global.
+ * Runs before the global document is updated.
+ * Operation is always `'update'` (globals cannot be created or deleted).
  */
-type DetailSchema<TDoc = any> = DetailItem<TDoc>[];
-
+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;
 /**
- * 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.
+ * Runs after the global document is updated. Side-effects only.
  */
-type AggregateCastType = "number" | "integer" | "float" | "string" | "boolean" | "date";
+type GlobalAfterChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
+    doc: TDoc;
+    previousDoc?: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    operation: "update";
+    db: DatabaseAdapter;
+}) => void | Promise<void>;
 /**
- * A `count` aggregate operation.
+ * @deprecated Use the specific hook types instead:
+ * `CollectionBeforeChangeHook`, `CollectionAfterReadHook`, etc.
  *
- * - `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.
+ * This broad type remains for backwards compatibility with the internal hook runner.
  */
-interface CountOperation {
-    count: "*";
-    where?: Record<string, unknown>;
+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;
+    /**
+     * 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.
+     */
+    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;
+}
+interface WorkflowRole {
+    /** Existing user role value, for example `editor` or `publisher`. */
+    role: string;
+    capabilities: string[];
 }
 /**
- * A `countDistinct` aggregate operation that counts the number of unique
- * non-null values for a specific field.
+ * 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 DistinctCountOperation {
-    countDistinct: string;
-    where?: Record<string, unknown>;
+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>[];
+    };
+}
+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;
+    /** 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;
 /**
- * A `distinct` aggregate operation that retrieves the unique values
- * (or unique values with item counts) for a specific field.
+ * Visual display variants supported by DetailFieldRenderer.
  */
-interface DistinctValuesOperation {
-    distinct: string;
-    where?: Record<string, unknown>;
-}
+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";
 /**
- * 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`.
+ * Configuration options for rendering a field in a Detail View.
  */
-interface NumericOperation {
-    sum?: string;
-    avg?: string;
-    min?: string;
-    max?: string;
-    cast?: AggregateCastType;
-    where?: Record<string, unknown>;
+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;
 }
 /**
- * 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/…
- */
-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.
+ * Section container grouping fields and components in a Detail View.
  */
-likeOperator?: 'LIKE' | 'ILIKE'): SqlWhereResult;
+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;
+}
 /**
- * Translates a WhereClause into a MongoDB filter object.
- * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
+ * Configuration options for an individual tab in `displayTabs()`.
  */
-declare function parseMongoWhere(where: WhereClause): Record<string, any>;
-
+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;
+}
 /**
- * Custom component slots rendered around an operational view's content.
+ * Single tab entry inside a tabbed container.
  */
-type ViewComponentSlots = CollectionViewComponentSlots;
+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;
+}
 /**
- * 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.
+ * Configuration options for a tabbed container.
  */
-type ViewLayout = 'table' | 'spreadsheet' | 'kanban' | 'calendar' | 'gantt' | 'cards';
+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;
+}
 /**
- * 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.
+ * Tabbed navigation container in a Detail View layout.
  */
-type ActionType = 'row' | 'bulk' | 'header';
+interface DetailTabs {
+    /** Identifies this item as a tab container. */
+    type: "tabs";
+    /** List of tabs in this container. */
+    tabs: DetailTab[];
+    /** Tab container options. */
+    options?: DetailTabsOptions;
+}
 /**
- * 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;
+ * Configuration options for a sub-grid container.
+ */
+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;
 }
 /**
- * Color palette options for metric cards:
- * `'purple' | 'emerald' | 'amber' | 'rose' | 'blue' | 'indigo' | 'cyan' | 'orange'`
+ * Multi-column sub-grid layout inside a section or tab.
  */
-type MetricColor = 'purple' | 'emerald' | 'amber' | 'rose' | 'blue' | 'indigo' | 'cyan' | 'orange' | string;
+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;
+}
 /**
- * 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",
- * }
- * ```
+ * Configuration options for a repeated array field.
  */
-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 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;
 }
 /**
- * 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",
- * }
- * ```
+ * Delegated repeated array field item in a Detail View.
  */
-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[];
+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;
 }
 /**
- * Complete configuration for a tailored operational view.
+ * Async or synchronous handler function calculating a computed metric.
  */
-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;
+type ComputedHandler<TDoc = any> = (context: {
+    doc: TDoc;
+    user?: any;
+    db?: any;
+}) => any | Promise<any>;
+/**
+ * Configuration options for a computed value card.
+ */
+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). */
-    doc: TDoc;
-    /** All targeted documents (for bulk 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.
@@ -1835,6 +1937,30 @@ interface AuthConfig {
      */
     adminRole?: string;
 }
+/**
+ * Physical database index specification for a collection.
+ */
+interface CollectionIndex {
+    /** Optional custom index name. If omitted, adapter auto-generates one. */
+    name?: string;
+    /** Field names participating in the index. */
+    fields: string[];
+    /** Whether the index enforces database-level uniqueness. Defaults to false. */
+    unique?: boolean;
+    /** Whether to only index non-null rows where supported. */
+    sparse?: boolean;
+}
+/**
+ * Atomic numeric update operators for database mutation payloads.
+ */
+interface NumericUpdateOperator {
+    increment?: number;
+    decrement?: number;
+}
+/**
+ * Strategy for generating document IDs.
+ */
+type IdStrategy = "prefixed-nanoid" | "nanoid" | "ulid" | "uuid";
 /**
  * Use this contract when you want the exact shape of a collection config.
  *
@@ -1960,6 +2086,31 @@ interface CollectionConfig<TDoc extends object = Record<string, unknown>> {
      * @see {@link https://dyrected.com/docs/model-content/fields/blocks Blocks and page sections}
      */
     fields: Field[];
+    /**
+     * Database indexes to create on this collection.
+     *
+     * Fields participating in indexes are automatically promoted to physical columns.
+     */
+    indexes?: CollectionIndex[];
+    /**
+     * Optional custom prefix for auto-generated document IDs (e.g. `'usr'`, `'cob'`, `'sub'`).
+     * When using the default prefixed ID generator, IDs will follow the format `${idPrefix}_${random}`.
+     */
+    idPrefix?: string;
+    /**
+     * Strategy for generating document IDs when not explicitly provided.
+     * - `'prefixed-nanoid'`: Stripe-style prefixed NanoID (default), e.g. `cob_8xK2p9LmQwRt9a`
+     * - `'nanoid'`: Compact URL-friendly random ID, e.g. `V1StGXR8_Z5jdHi6B-myT`
+     * - `'ulid'`: 26-character Crockford Base32 time-sortable ID, e.g. `01J8K3R4Q7V9N2M1P6W0XYZA3C`
+     * - `'uuid'`: 36-character RFC 4122 UUIDv4, e.g. `f47ac10b-58cc-4372-a567-0e02b2c3d479`
+     *
+     * Defaults to `'prefixed-nanoid'`.
+     */
+    idType?: IdStrategy;
+    /**
+     * Custom function to generate document IDs. Overrides `idType` and `idPrefix`.
+     */
+    idGenerator?: (slug: string) => string;
     /**
      * If `true`, Dyrected automatically adds the built-in system fields
      * `createdAt`, `updatedAt`, `createdBy`, and `updatedBy` to every document.
@@ -2113,6 +2264,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.
@@ -2376,6 +2531,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;
     };
@@ -2424,21 +2583,26 @@ interface DatabaseAdapter {
          * ignore it; SQL adapters use it to sort numeric fields by magnitude.
          */
         fields?: Field[];
+        /** 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. */
     findOne(args: {
         collection: string;
         id: string;
+        /** Row-level locking strategy (e.g. SELECT ... FOR UPDATE in transactions). */
+        lock?: "for-update";
     }): Promise<BaseDocument | null>;
     /** Insert a new document and return it with its generated `id`. */
     create(args: {
         collection: string;
         data: Record<string, unknown>;
     }): Promise<BaseDocument>;
-    /** Update a document by ID and return the updated document. */
+    /** Update a document by ID or conditional filter and return the updated document. */
     update(args: {
         collection: string;
-        id: string;
+        id?: string;
+        where?: Record<string, unknown>;
         data: Record<string, unknown>;
     }): Promise<BaseDocument>;
     /** Delete a document by ID. Return value is intentionally untyped — callers do not use it. */
@@ -3900,4 +4064,4 @@ interface DyrectedContext {
  */
 declare function createDyrectedApp(rawConfig: DyrectedConfig | any): Promise<Hono<DyrectedContext, hono_types.BlankSchema, "/">>;
 
-export { type JoinField 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 ArrayField as Q, type FieldType as R, type BooleanField as S, type AuthConfig as T, type AccessPolicyResolver as U, type DateField as V, type WorkflowConfig as W, type DateTimeField as X, type EmailField as Y, type IconField as Z, type ImageField as _, type DeclarativeHookExpression as a, type BooleanFieldAdmin as a$, type JsonField as a0, type MultiSelectField as a1, type NumberField as a2, type ObjectField as a3, type RadioField as a4, type RelationshipField as a5, type RichTextField as a6, type RowField as a7, type SelectField as a8, type TextField as a9, type ActionConfig as aA, type ActionConfigBase as aB, type ActionConfigWithHandler as aC, type ActionConfigWithMutation as aD, type ActionContext as aE, type ActionType as aF, type AdminAuthAccessResolution as aG, type AdminAuthClaimMapping as aH, type AdminAuthMember as aI, type AdminAuthProvider as aJ, type AdminAuthProviderMembersConfig as aK, type AdminAuthProvisioningMode as aL, type AdminAuthResolveAccessArgs as aM, type AdminAuthResolvedIdentity as aN, type AdminConfig as aO, type AdminDashboardComponentSlots as aP, type AdminIconName as aQ, type AggregateArgs as aR, type AggregateCastType as aS, type AggregateCollectionResult as aT, type AggregateInput as aU, type AggregateOperation as aV, type AggregateResult as aW, type BaseAdminAuthProvider as aX, type BaseFieldAdmin as aY, type BlockVariant as aZ, type BlocksField as a_, type TextareaField as aa, type TimeField as ab, type UrlField as ac, type AIAction as ad, type AIActionStatus as ae, type AIActionType as af, type AIAuditActionType as ag, type AIAuditRecord as ah, type AIChunk as ai, type AIMessage as aj, type AIPIIPattern as ak, type AIRateLimitResult as al, type AIRateLimitStore as am, type AIThread as an, type AIToolContext as ao, type AIToolDefinition as ap, AI_ACTIONS_COLLECTION as aq, AI_AUDIT_COLLECTION as ar, AI_CHUNKS_COLLECTION as as, AI_MESSAGES_COLLECTION as at, AI_THREADS_COLLECTION as au, type AccessConfig as av, type AccessFunction as aw, type AccessFunctionArgs as ax, type AccessResult as ay, type AccessRule as az, type AuthenticatedUser as b, type GlobalAfterReadHookEntry as b$, type BooleanFormat as b0, type CharacterLimitFieldAdmin as b1, type CharacterLimitFieldConfig as b2, type CollectionAfterChangeHook as b3, type CollectionAfterDeleteHook as b4, type CollectionAfterReadHook as b5, type CollectionAfterReadHookEntry as b6, type CollectionAfterTransitionHook as b7, type CollectionBeforeChangeHook as b8, type CollectionBeforeChangeHookEntry as b9, type DistinctCountOperation as bA, type DistinctValuesOperation as bB, type DynamicOptionItem as bC, type DynamicOptionsConfig as bD, type DynamicOptionsResolver as bE, type DynamicOptionsResolverArgs as bF, type DyrectedAIContext as bG, type DyrectedLoggerConfig as bH, type DyrectedObservabilityConfig as bI, type EmailFieldAdmin as bJ, type FieldAdminHooks as bK, type FieldAdminOnChangeHook as bL, type FieldAdminOnChangeHookArgs as bM, type FieldAdminOptionsHook as bN, type FieldAdminOptionsHookArgs as bO, type FieldAdminOptionsHookResult as bP, type FieldAfterReadHook as bQ, type FieldAfterReadHookArgs as bR, type FieldBase as bS, type FieldBeforeChangeHook as bT, type FieldBeforeChangeHookArgs as bU, type FieldHook as bV, type FieldHooks as bW, type FileData as bX, type GetDocumentResult as bY, type GlobalAfterChangeHook as bZ, type GlobalAfterReadHook as b_, type CollectionBeforeDeleteHook as ba, type CollectionBeforeReadHook as bb, type CollectionBeforeReadHookEntry as bc, type CollectionBeforeTransitionHook as bd, type CollectionListComponentSlots as be, type CollectionRAGConfig as bf, type CollectionSchemaResult as bg, type CollectionSummaryResult as bh, type CollectionViewComponentSlots as bi, type CountOperation as bj, type CustomAdminAuthProvider as bk, type DatabaseAdapter as bl, type DateFieldAdmin as bm, type DateFormat as bn, type DefaultValueContext as bo, type DefineActionOptions as bp, type DefineCalendarViewOptions as bq, type DefineCardsViewOptions as br, type DefineGanttViewOptions as bs, type DefineKanbanViewOptions as bt, type DefineTableViewOptions as bu, type DefineViewBaseOptions as bv, type DefineViewOptions as bw, type DetailSpan as bx, type DisplayTone as by, type DisplayVariant as bz, type WorkflowTransition as c, type WorkflowTransitionContext as c$, type GlobalBeforeChangeHook as c0, type GlobalBeforeChangeHookEntry as c1, type GlobalBeforeReadHook as c2, type GlobalBeforeReadHookEntry as c3, type GlobalRAGConfig as c4, type GlobalSchemaResult as c5, type GlobalSummaryResult as c6, type HeadingLevel as c7, type HookFunction as c8, type IconFieldAdmin as c9, type RichTextFeature as cA, type RichTextFieldConfig as cB, type SelectFieldAdmin as cC, type SqlWhereResult as cD, type StorageAdapter as cE, type TextFieldAdmin as cF, type TextFormat as cG, type TextareaFieldAdmin as cH, type TrustProxyConfig as cI, type TypedField as cJ, type UploadConfig as cK, type UrlFieldAdmin as cL, type UrlLinkValue as cM, type ViewActionFeatures as cN, type ViewComponentSlots as cO, type ViewConfig as cP, type ViewLayout as cQ, type ViewMetric as cR, type ViewSubMetric as cS, type WhereClause as cT, type WhereOperator as cU, type WhereOperatorName as cV, type WordLimitFieldAdmin as cW, type WordLimitFieldConfig as cX, type WorkflowMetadata as cY, type WorkflowRole as cZ, type WorkflowState as c_, type ImageService as ca, type ImageTransformOptions as cb, type InferAggregateResult as cc, type JoinFieldAdmin as cd, type JsonFieldAdmin as ce, type JsonFormat as cf, LIFECYCLE_EVENT_NAMES as cg, type LifecycleEventHandler as ch, type LinkFormat as ci, type MetricColor as cj, type MultiSelectFieldAdmin as ck, type NamedAccessPolicy as cl, type NumberFieldAdmin as cm, type NumberFormat as cn, type NumberLimitFieldAdmin as co, type NumberLimitFieldConfig as cp, type NumericOperation as cq, type OIDCAdminAuthProvider as cr, type OptionFormat as cs, type PaginatedResult as ct, type PublicAdminAuthProvider as cu, type QueryCollectionResult as cv, type RAGSearchResult as cw, type RadioFieldAdmin as cx, type RateLimitConfig as cy, type ReadonlyDatabaseAdapter as cz, type LifecycleEvent as d, defineAction as d0, defineCalendarView as d1, defineCardsView as d2, defineGanttView as d3, defineKanbanView as d4, defineTableView as d5, defineView as d6, isAICollection as d7, parseMongoWhere as d8, parseSqlWhere as d9, verifyCollectionToken as dA, type CollectionTokenPayload as da, DEFAULT_SESSION_EXPIRY as db, type DyrectedObservabilityRuntime as dc, type RequestBodyCapture as dd, type RequestTraceContext as de, type ResolvedObservabilityConfig as df, attachRequestMetrics as dg, bindObservabilityRuntime as dh, buildRequestLogger as di, captureRequestBody as dj, createDyrectedApp as dk, createObservabilityRuntime as dl, createRequestSpan as dm, decodeCollectionToken as dn, endRequestSpan as dp, getConfigLogger as dq, getObservabilityRuntime as dr, getRequestLogger as ds, redactBody as dt, redactHeaders as du, renderPrometheusMetrics as dv, resolveObservabilityConfig as dw, resolveSessionTokenExpiry as dx, shouldSampleRequest as dy, signCollectionToken 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 DateField 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 CompiledNavTree as R, type CompiledNavItem as S, type DefineWorkspaceOptions as T, type UserNavigationPreferences as U, type ArrayField as V, type WorkflowConfig as W, type FieldType as X, type BooleanField as Y, type AuthConfig as Z, type AccessPolicyResolver as _, type DeclarativeHookExpression as a, type AggregateResult as a$, type DateTimeField as a0, type EmailField as a1, type IconField as a2, type ImageField as a3, type JoinField as a4, type JsonField as a5, type MultiSelectField as a6, type NumberField as a7, type ObjectField as a8, type RadioField as a9, type AccessConfig as aA, type AccessFunction as aB, type AccessFunctionArgs as aC, type AccessResult as aD, type AccessRule as aE, type ActionConfig as aF, type ActionConfigBase as aG, type ActionConfigWithHandler as aH, type ActionConfigWithMutation as aI, type ActionContext as aJ, type ActionType as aK, type AdminAuthAccessResolution as aL, type AdminAuthClaimMapping as aM, type AdminAuthMember as aN, type AdminAuthProvider as aO, type AdminAuthProviderMembersConfig as aP, type AdminAuthProvisioningMode as aQ, type AdminAuthResolveAccessArgs as aR, type AdminAuthResolvedIdentity as aS, type AdminConfig as aT, type AdminDashboardComponentSlots as aU, type AdminIconName as aV, type AggregateArgs as aW, type AggregateCastType as aX, type AggregateCollectionResult as aY, type AggregateInput as aZ, type AggregateOperation as a_, type RelationshipField as aa, type RichTextField as ab, type RowField as ac, type SelectField as ad, type TextField as ae, type TextareaField as af, type TimeField as ag, type UrlField as ah, type AIAction as ai, type AIActionStatus as aj, type AIActionType as ak, type AIAuditActionType as al, type AIAuditRecord as am, type AIChunk as an, type AIMessage as ao, type AIPIIPattern as ap, type AIRateLimitResult as aq, type AIRateLimitStore as ar, type AIThread as as, type AIToolContext as at, type AIToolDefinition as au, AI_ACTIONS_COLLECTION as av, AI_AUDIT_COLLECTION as aw, AI_CHUNKS_COLLECTION as ax, AI_MESSAGES_COLLECTION as ay, AI_THREADS_COLLECTION as az, type AuthenticatedUser as b, type FieldAfterReadHook as b$, type BaseAdminAuthProvider as b0, type BaseFieldAdmin as b1, type BlockVariant as b2, type BlocksField as b3, type BooleanFieldAdmin as b4, type BooleanFormat as b5, CURRENT_NAV_PREFERENCES_VERSION as b6, type CalendarViewConfig as b7, type CardsViewConfig as b8, type CharacterLimitFieldAdmin as b9, type DefineActionOptions as bA, type DefineCalendarViewOptions as bB, type DefineCardsViewOptions as bC, type DefineGanttViewOptions as bD, type DefineKanbanViewOptions as bE, type DefineTableViewOptions as bF, type DefineViewBaseOptions as bG, type DefineViewOptions as bH, type DetailSpan as bI, type DisplayTone as bJ, type DisplayVariant as bK, type DistinctCountOperation as bL, type DistinctValuesOperation as bM, type DynamicOptionItem as bN, type DynamicOptionsConfig as bO, type DynamicOptionsResolver as bP, type DynamicOptionsResolverArgs as bQ, type DyrectedAIContext as bR, type DyrectedLoggerConfig as bS, type DyrectedObservabilityConfig as bT, type EmailFieldAdmin as bU, type FieldAdminHooks as bV, type FieldAdminOnChangeHook as bW, type FieldAdminOnChangeHookArgs as bX, type FieldAdminOptionsHook as bY, type FieldAdminOptionsHookArgs as bZ, type FieldAdminOptionsHookResult as b_, type CharacterLimitFieldConfig as ba, type CollectionAfterChangeHook as bb, type CollectionAfterDeleteHook as bc, type CollectionAfterReadHook as bd, type CollectionAfterReadHookEntry as be, type CollectionAfterTransitionHook as bf, type CollectionBeforeChangeHook as bg, type CollectionBeforeChangeHookEntry as bh, type CollectionBeforeDeleteHook as bi, type CollectionBeforeReadHook as bj, type CollectionBeforeReadHookEntry as bk, type CollectionBeforeTransitionHook as bl, type CollectionIndex as bm, type CollectionListComponentSlots as bn, type CollectionRAGConfig as bo, type CollectionSchemaResult as bp, type CollectionSummaryResult as bq, type CollectionViewComponentSlots as br, type CompiledNavGroup as bs, type CountOperation as bt, type CustomAdminAuthProvider as bu, DEFAULT_USER_NAV_PREFERENCES as bv, type DatabaseAdapter as bw, type DateFieldAdmin as bx, type DateFormat as by, type DefaultValueContext as bz, type WorkflowTransition as c, type TypedField as c$, type FieldAfterReadHookArgs as c0, type FieldBase as c1, type FieldBeforeChangeHook as c2, type FieldBeforeChangeHookArgs as c3, type FieldHook as c4, type FieldHooks as c5, type FileData as c6, type GanttViewConfig as c7, type GetDocumentResult as c8, type GlobalAfterChangeHook as c9, type NavGroup as cA, type NumberFieldAdmin as cB, type NumberFormat as cC, type NumberLimitFieldAdmin as cD, type NumberLimitFieldConfig as cE, type NumericOperation as cF, type NumericUpdateOperator as cG, type OIDCAdminAuthProvider as cH, type OptionFormat as cI, type PaginatedResult as cJ, type PinnedNavItemRef as cK, type PublicAdminAuthProvider as cL, type QueryCollectionResult as cM, type RAGSearchResult as cN, type RadioFieldAdmin as cO, type RateLimitConfig as cP, type ReadonlyDatabaseAdapter as cQ, type RichTextFeature as cR, type RichTextFieldConfig as cS, type SelectFieldAdmin as cT, type SqlWhereResult as cU, type StorageAdapter as cV, type TableViewConfig as cW, type TextFieldAdmin as cX, type TextFormat as cY, type TextareaFieldAdmin as cZ, type TrustProxyConfig as c_, type GlobalAfterReadHook as ca, type GlobalAfterReadHookEntry as cb, type GlobalBeforeChangeHook as cc, type GlobalBeforeChangeHookEntry as cd, type GlobalBeforeReadHook as ce, type GlobalBeforeReadHookEntry as cf, type GlobalRAGConfig as cg, type GlobalSchemaResult as ch, type GlobalSummaryResult as ci, type HeadingLevel as cj, type HookFunction as ck, type IconFieldAdmin as cl, type ImageService as cm, type ImageTransformOptions as cn, type InferAggregateResult as co, type JoinFieldAdmin as cp, type JsonFieldAdmin as cq, type JsonFormat as cr, type KanbanViewConfig as cs, LIFECYCLE_EVENT_NAMES as ct, type LifecycleEventHandler as cu, type LinkFormat as cv, type MetricColor as cw, type MultiSelectFieldAdmin as cx, type NamedAccessPolicy as cy, type NavBadgeConfig as cz, type LifecycleEvent as d, type UploadConfig as d0, type UrlFieldAdmin as d1, type UrlLinkValue as d2, type ViewActionFeatures as d3, type ViewComponentSlots as d4, type ViewConfig as d5, type ViewConfigBase as d6, type ViewLayout as d7, type ViewMetric as d8, type ViewSubMetric as d9, type ResolvedObservabilityConfig as dA, attachRequestMetrics as dB, bindObservabilityRuntime as dC, buildRequestLogger as dD, captureRequestBody as dE, createDyrectedApp as dF, createObservabilityRuntime as dG, createRequestSpan as dH, decodeCollectionToken as dI, endRequestSpan as dJ, getConfigLogger as dK, getObservabilityRuntime as dL, getRequestLogger as dM, redactBody as dN, redactHeaders as dO, renderPrometheusMetrics as dP, resolveObservabilityConfig as dQ, resolveSessionTokenExpiry as dR, shouldSampleRequest as dS, signCollectionToken as dT, verifyCollectionToken as dU, type WhereClause as da, type WhereOperator as db, type WhereOperatorName as dc, type WordLimitFieldAdmin as dd, type WordLimitFieldConfig as de, type WorkflowMetadata as df, type WorkflowRole as dg, type WorkflowState as dh, type WorkflowTransitionContext as di, defineAction as dj, defineCalendarView as dk, defineCardsView as dl, defineGanttView as dm, defineKanbanView as dn, defineTableView as dp, defineView as dq, defineWorkspace as dr, isAICollection as ds, parseMongoWhere as dt, parseSqlWhere as du, type CollectionTokenPayload as dv, DEFAULT_SESSION_EXPIRY as dw, type DyrectedObservabilityRuntime as dx, type RequestBodyCapture as dy, type RequestTraceContext 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 };