@dyrected/core 2.16.0 → 2.17.0

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

@@ -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>;
+type WhereOperatorName = 'equals' | 'not_equals' | 'in' | 'not_in' | 'gt' | 'greater_than' | 'gte' | 'greater_than_equal' | 'greater_than_or_equal' | 'lt' | 'less_than' | 'lte' | 'less_than_equal' | 'less_than_or_equal' | 'contains' | 'like' | 'starts_with' | 'exists';
+type WhereOperator = {
+    equals: any;
+} | {
+    not_equals: any;
+} | {
+    in: any[];
+} | {
+    not_in: any[];
+} | {
+    gt: any;
+} | {
+    greater_than: any;
+} | {
+    gte: any;
+} | {
+    greater_than_equal: any;
+} | {
+    greater_than_or_equal: any;
+} | {
+    lt: any;
+} | {
+    less_than: any;
+} | {
+    lte: any;
+} | {
+    less_than_equal: any;
+} | {
+    less_than_or_equal: any;
+} | {
+    contains: string;
+} | {
+    like: string;
+} | {
+    starts_with: string;
+} | {
+    exists: boolean;
+};
+/** Top-level where clause. Fields map to operator objects or shorthand scalar values. */
+type WhereClause = {
+    [field: string]: WhereOperator | any;
+    OR?: WhereClause[] | readonly WhereClause[];
+    or?: WhereClause[] | readonly WhereClause[];
+    AND?: WhereClause[] | readonly WhereClause[];
+    and?: WhereClause[] | readonly WhereClause[];
+};
+interface SqlWhereResult {
+    sql: string;
+    params: any[];
+}
+/**
+ * Translates a WhereClause into a parameterized SQL WHERE fragment.
+ *
+ * @param where         The Dyrected where DSL object
+ * @param getJsonField  Returns the SQL expression for a JSON-stored field (dialect-specific):
+ *                        SQLite:   (f) => `json_extract(data, '$.${f}')`
+ *                        Postgres: (f) => `data->>'${f}'`
+ *                        MySQL:    (f) => `JSON_UNQUOTE(JSON_EXTRACT(data, '$.${f}'))`
+ * @param placeholder   '?' for SQLite/MySQL, 'pg' for auto-incrementing Postgres $1/$2/…
+ */
+declare function parseSqlWhere(where: WhereClause, getJsonField: (field: string) => string, placeholder?: '?' | 'pg', 
+/**
+ * SQL keyword used for `contains`/`starts_with`. Postgres `LIKE` is
+ * case-sensitive, so the Postgres adapter defaults to `'ILIKE'` to keep substring
+ * matching case-insensitive like SQLite and MySQL.
+ */
+likeOperator?: 'LIKE' | 'ILIKE'): SqlWhereResult;
+/**
+ * Translates a WhereClause into a MongoDB filter object.
+ * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
+ */
+declare function parseMongoWhere(where: WhereClause): Record<string, any>;
 
-declare const LIFECYCLE_EVENT_NAMES: readonly ["revision.created", "workflow.transitioned", "entry.published", "entry.unpublished"];
-type LifecycleEventName = (typeof LIFECYCLE_EVENT_NAMES)[number];
-interface WorkflowState {
-    /** Stable machine-readable state key. */
-    name: string;
-    /** Label rendered in the Admin UI. */
+/**
+ * Custom component slots rendered around an operational view's content.
+ */
+type ViewComponentSlots = CollectionViewComponentSlots;
+/**
+ * Supported layout engines for operational views in the Dyrected Admin UI:
+ * - `'table'`: The workhorse — column sorting, search, faceted filters, and bulk actions.
+ * - `'spreadsheet'`: Inline-editable matrix with batch saving (`Save changes` / `Discard`).
+ * - `'kanban'`: Interactive card board grouped by status or category with drag-and-drop.
+ * - `'calendar'`: Event schedule grid plotting records across month/week/day views by date.
+ * - `'gantt'`: Timeline bars plotted across start and end dates.
+ * - `'cards'`: Visual image/thumbnail gallery grid.
+ */
+type ViewLayout = 'table' | 'spreadsheet' | 'kanban' | 'calendar' | 'gantt' | 'cards';
+/**
+ * Scope and placement for an operational view action:
+ * - `'row'`: Renders as an inline action button on each document/row.
+ * - `'bulk'`: Appears in the floating bulk action bar when one or more rows are selected.
+ * - `'header'`: Renders as a primary action button in the view header.
+ */
+type ActionType = 'row' | 'bulk' | 'header';
+/**
+ * Toggles for the built-in document operations an operational view surfaces.
+ * All default to enabled (`true`). Set any to `false` to hide that operation.
+ *
+ * @example
+ * ```ts
+ * features: {
+ *   delete: false, // Prevent deleting records from this view
+ *   exportSelected: true, // Enable CSV export for checked rows
+ * }
+ * ```
+ */
+interface ViewActionFeatures {
+    /** Enables the "View" preview / read-only drawer button. Defaults to `true`. */
+    view?: boolean;
+    /** Enables the "Edit" document form link. Defaults to `true`. */
+    edit?: boolean;
+    /** Enables the "Duplicate" record action. Defaults to `true`. */
+    duplicate?: boolean;
+    /** Enables the "Delete" record action. Defaults to `true`. */
+    delete?: boolean;
+    /** Enables the "Export selected" CSV action in the bulk action bar. Defaults to `true`. */
+    exportSelected?: boolean;
+}
+/**
+ * Color palette options for metric cards:
+ * `'purple' | 'emerald' | 'amber' | 'rose' | 'blue' | 'indigo' | 'cyan' | 'orange'`
+ */
+type MetricColor = 'purple' | 'emerald' | 'amber' | 'rose' | 'blue' | 'indigo' | 'cyan' | 'orange' | string;
+/**
+ * A sub-metric breakdown item displayed in the compact footer of a metric card.
+ *
+ * @example
+ * ```ts
+ * {
+ *   label: "Pending",
+ *   aggregates: {
+ *     checkedIn: { count: "*", where: { checkedIn: { equals: true } } },
+ *     attending: { count: "*", where: { attending: { equals: true } } },
+ *   },
+ *   expression: "aggregates.attending - aggregates.checkedIn",
+ * }
+ * ```
+ */
+interface ViewSubMetric {
+    /** Short label for the sub-metric (e.g. "Pending", "Collected"). */
     label: string;
-    /** Marks the state whose revision is visible to public readers. */
-    published?: boolean;
-    /** Optional visual tone used by the Admin UI. */
-    color?: "neutral" | "warning" | "success" | "danger" | "info";
+    /** Single database aggregate operation. */
+    aggregate?: AggregateOperation;
+    /** Map of named aggregate operations referenced in `expression` as `aggregates.key`. */
+    aggregates?: Record<string, AggregateOperation>;
+    /** JEXL math formula evaluated over `value` for a single aggregate (e.g. `"value * 100"`). */
+    transform?: string;
+    /** JEXL math formula evaluated over `aggregates` (e.g. `"aggregates.a - aggregates.b"`). */
+    expression?: string;
+    /** Display formatter: `'currency' | 'number' | 'percent'`. */
+    format?: 'currency' | 'number' | 'percent' | string;
+    /** 3-letter currency code (e.g. `"USD"`, `"NGN"`, `"EUR"`) used when `format: "currency"`. */
+    currency?: string;
 }
-interface WorkflowTransition {
-    /** Stable transition key used by the REST and SDK APIs. */
+/**
+ * Configuration for a KPI summary card rendered at the top of an operational view.
+ *
+ * All aggregations run directly on the database engine for maximum performance.
+ *
+ * @example
+ * ```ts
+ * {
+ *   label: "Total Revenue",
+ *   color: "emerald",
+ *   aggregate: { sum: "amount", cast: "number", where: { status: "paid" } },
+ *   format: "currency",
+ *   currency: "USD",
+ * }
+ * ```
+ */
+interface ViewMetric {
+    /** Title displayed on the metric card header. */
+    label: string;
+    /** Accent color for the card's visual indicator. */
+    color?: MetricColor;
+    /** Unit badge shown alongside the numeric value (e.g. `"Guests"`, `"Orders"`, `"Tables"`). */
+    unit?: string;
+    /** Single database aggregate operation (`count`, `distinctCount`, `sum`, `avg`, `min`, `max`). */
+    aggregate?: AggregateOperation;
+    /** Map of named aggregate operations referenced in `expression` as `aggregates.key`. */
+    aggregates?: Record<string, AggregateOperation>;
+    /** JEXL math formula evaluated over `value` for a single aggregate (e.g. `"value * 25000"`). */
+    transform?: string;
+    /** JEXL math formula evaluated over `aggregates` (e.g. `"(aggregates.paid / aggregates.total) * 100"`). */
+    expression?: string;
+    /** Display formatter: `'currency' | 'number' | 'percent'`. */
+    format?: 'currency' | 'number' | 'percent' | string;
+    /** 3-letter currency code (e.g. `"USD"`, `"NGN"`, `"EUR"`) used when `format: "currency"`. */
+    currency?: string;
+    /** Optional secondary breakdown items shown in the card footer. */
+    subMetrics?: ViewSubMetric[];
+}
+/**
+ * Base configuration shared by all action types.
+ */
+interface ActionConfigBase<TDoc extends Record<string, unknown> = Record<string, unknown>> {
+    /** Unique action identifier (e.g. `"checkIn"`, `"markPaid"`). */
     name: string;
+    /** Button label displayed in the UI. */
     label: string;
-    /**
-     * 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;
+    /** 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;
 }
-interface WorkflowRole {
-    /** Existing user role value, for example `editor` or `publisher`. */
-    role: string;
-    capabilities: string[];
+/**
+ * An operational workflow action with declarative data mutation.
+ */
+interface ActionConfigWithMutation<TDoc extends Record<string, unknown> = Record<string, unknown>> extends ActionConfigBase<TDoc> {
+    /** Declarative database mutation applied to targeted documents (e.g. `{ checkedIn: true, checkedInAt: "now()" }`). */
+    mutation: Partial<TDoc> | Record<string, unknown>;
+    /** Optional server handler for additional logic. */
+    handler?: (context: ActionContext<TDoc>) => Promise<unknown> | unknown;
 }
 /**
- * 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`.
+ * An operational workflow action with server handler.
  */
-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 ActionConfigWithHandler<TDoc extends Record<string, unknown> = Record<string, unknown>> extends ActionConfigBase<TDoc> {
+    /** Self-hosted server handler function executed when the action is triggered (required when mutation is not provided). */
+    handler: (context: ActionContext<TDoc>) => Promise<unknown> | unknown;
+    /** Optional declarative mutation. */
+    mutation?: Partial<TDoc> | Record<string, unknown>;
+}
+/**
+ * An operational workflow action that can mutate data or trigger server logic.
+ * Requires either `mutation` or `handler` (or both).
+ */
+type ActionConfig<TDoc extends Record<string, unknown> = Record<string, unknown>> = ActionConfigWithMutation<TDoc> | ActionConfigWithHandler<TDoc>;
+/**
+ * Context passed to an action's server handler function.
+ */
+interface ActionContext<TDoc extends Record<string, unknown> = Record<string, unknown>> {
+    /** The target document (for row actions), or null for header actions. */
+    doc: TDoc | null;
+    /** All targeted documents (for bulk actions). Empty array for header actions. */
+    docs: TDoc[];
+    /** The authenticated acting user, if available. */
+    user: Record<string, unknown> | null;
+    /** User inputs submitted via the action's modal form fields. */
+    input: Record<string, unknown>;
+    /** The collection configuration object. */
+    collection: Record<string, unknown>;
+}
+/**
+ * Role-based access control rules for a view or action.
+ */
+interface AccessConfig {
+    read?: AccessRule<any>;
+    create?: AccessRule<any>;
+    update?: AccessRule<any>;
+    delete?: AccessRule<any>;
+}
+/**
+ * Base options shared by all operational view configurations.
+ */
+interface ViewConfigBase {
+    /** Stable URL slug for the view (`/collections/:slug/views/:viewSlug` or `/:workspaceSlug/:viewSlug`). */
+    slug: string;
+    /** Human-readable title displayed in the sidebar navigation and view header. */
+    label: string;
+    /** Lucide icon name (e.g. `"UserCheck"`, `"Calendar"`, `"Shirt"`, `"TableProperties"`). */
+    icon?: string;
+    /** Optional target collection slug for views defined inside standalone operational workspaces. */
+    collection?: string;
+    /** Base query filter applied before user toolbar filters (e.g. `{ attending: { equals: true } }` or JEXL string). */
+    filter?: WhereClause | Record<string, any> | string;
+    /** Field names to show in this view, in order. If omitted, Dyrected infers default display fields. */
+    columns?: string[];
+    /** Default sorting rule when entering the view. */
+    sort?: {
+        field: string;
+        direction: 'asc' | 'desc';
     };
+    /** Custom workflow actions available in this view. */
+    actions?: ActionConfig[];
+    /** Toggles built-in operations (view/edit/duplicate/delete/export). */
+    features?: ViewActionFeatures;
+    /**
+     * Explicit display order for action buttons — mixing custom action names and built-in names
+     * (`"view"`, `"edit"`, `"duplicate"`, `"delete"`). Unlisted actions append in default order.
+     */
+    actionOrder?: string[];
+    /** KPI summary cards rendered in the hero row above the view. */
+    metrics?: ViewMetric[];
+    /** Optional real-time counter badge or status indicator displayed on this view in navigation and tabs. */
+    badge?: NavBadgeConfig | string;
+    /** Custom component slots rendered around this operational view. */
+    components?: ViewComponentSlots;
+    /** Role-based access rules controlling who can see or use this view. */
+    access?: AccessConfig;
 }
-interface 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[];
+/** 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;
 }
-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;
+/** Kanban view — requires `groupBy` to organize into columns. */
+interface KanbanViewConfig extends ViewConfigBase {
+    layout: 'kanban';
+    /** Field name to organize records into kanban columns. */
+    groupBy: string;
 }
-type CollectionBeforeTransitionHook<TDoc extends object = Record<string, unknown>> = (args: WorkflowTransitionContext<TDoc>) => void | Promise<void>;
-type CollectionAfterTransitionHook<TDoc extends object = Record<string, unknown>> = (args: WorkflowTransitionContext<TDoc> & {
-    event: LifecycleEvent;
-}) => void | Promise<void>;
-interface LifecycleEvent<TPayload = Record<string, unknown>> {
-    /** Unique id for this event. */
-    id: string;
-    /** The lifecycle event name, e.g. `"workflow.transitioned"` or `"entry.published"`. */
-    name: LifecycleEventName;
-    /** Slug of the collection the event is about. */
-    collection: string;
-    /** Id of the document the event is about. */
-    documentId: string;
-    /** ISO timestamp of when the event occurred. */
-    occurredAt: string;
-    /** Id of the user who triggered the event, when known. */
-    actorId?: string;
-    /** Event-specific data, such as the transition name and affected revision. */
-    payload: TPayload;
-    /** Number of delivery attempts made so far. */
-    attempts: number;
-    /** Current delivery status as the dispatcher works through the queue. */
-    status: "pending" | "processing" | "delivered" | "failed";
-    /** ISO timestamp of the next delivery retry, while pending. */
-    nextAttemptAt?: string;
-    /** ISO timestamp of successful delivery. */
-    deliveredAt?: string;
-    /** Message from the most recent failed delivery attempt. */
-    lastError?: string;
+/** 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;
 }
-type LifecycleEventHandler = (event: LifecycleEvent) => void | Promise<void>;
+/** 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;
+}
+/**
+ * Complete configuration for a tailored operational view.
+ */
+type ViewConfig = TableViewConfig | KanbanViewConfig | CalendarViewConfig | GanttViewConfig | CardsViewConfig;
+/**
+ * Backwards-compatible aliases for builder types.
+ */
+type DefineViewBaseOptions = ViewConfigBase;
+type DefineTableViewOptions = TableViewConfig;
+type DefineKanbanViewOptions = KanbanViewConfig;
+type DefineCalendarViewOptions = CalendarViewConfig;
+type DefineGanttViewOptions = GanttViewConfig;
+type DefineCardsViewOptions = CardsViewConfig;
+type DefineViewOptions = ViewConfig;
+/**
+ * Options for defining a custom workflow action with `defineAction`.
+ *
+ * @example
+ * ```ts
+ * export const checkInAction = defineAction({
+ *   name: "checkIn",
+ *   label: "Check In",
+ *   icon: "UserCheck",
+ *   type: "row",
+ *   confirm: "Confirm guest check-in at the door?",
+ *   mutation: { checkedIn: true, checkedInAt: "now()" },
+ * });
+ * ```
+ */
+interface DefineActionOptions<TDoc extends Record<string, unknown> = Record<string, unknown>> {
+    /** Unique action identifier (e.g. `"checkIn"`, `"markPaid"`). */
+    name: string;
+    /** Button label displayed in the UI. */
+    label: string;
+    /** Lucide icon name for the button (e.g. `"UserCheck"`, `"CheckCircle"`). */
+    icon?: string;
+    /** Action placement: `'row'` (per-row), `'bulk'` (multi-row selection bar), or `'header'` (view header). Defaults to `'row'`. */
+    type?: ActionType;
+    /** Optional confirmation prompt shown before executing (e.g. `"Confirm guest check-in at the door?"`). */
+    confirm?: string;
+    /** Optional interactive modal form fields prompting the user for input before executing. */
+    fields?: Field[];
+    /** Declarative database mutation applied to targeted documents (e.g. `{ checkedIn: true, checkedInAt: "now()" }`). */
+    mutation?: Partial<TDoc> | Record<string, unknown>;
+    /** Self-hosted server handler function executed when the action is triggered. */
+    handler?: (context: ActionContext<TDoc>) => Promise<unknown> | unknown;
+    /** Role-based access rules controlling who can trigger this action. */
+    access?: AccessConfig;
+}
+/**
+ * Defines a typed operational view for a collection.
+ * Layout-specific overloads enforce required fields for each view type.
+ *
+ * @example
+ * ```ts
+ * // Table view (no special requirements)
+ * export const allGuests = defineView({
+ *   slug: "all-guests",
+ *   label: "All Guests",
+ *   layout: "table", // or omit for default
+ * });
+ *
+ * // Kanban view (requires groupBy)
+ * export const guestsByTable = defineView({
+ *   slug: "by-table",
+ *   label: "Guests by Table",
+ *   layout: "kanban",
+ *   groupBy: "tableNumber", // required!
+ * });
+ *
+ * // Calendar view (requires dateField)
+ * export const eventCalendar = defineView({
+ *   slug: "event-calendar",
+ *   label: "Event Calendar",
+ *   layout: "calendar",
+ *   dateField: "eventDate", // required!
+ * });
+ *
+ * // Gantt view (requires startDateField and endDateField)
+ * export const projectTimeline = defineView({
+ *   slug: "timeline",
+ *   label: "Project Timeline",
+ *   layout: "gantt",
+ *   startDateField: "startDate", // required!
+ *   endDateField: "endDate", // required!
+ * });
+ * ```
+ */
+declare function defineView(config: DefineTableViewOptions): DefineTableViewOptions;
+declare function defineView(config: DefineKanbanViewOptions): DefineKanbanViewOptions;
+declare function defineView(config: DefineCalendarViewOptions): DefineCalendarViewOptions;
+declare function defineView(config: DefineGanttViewOptions): DefineGanttViewOptions;
+declare function defineView(config: DefineCardsViewOptions): DefineCardsViewOptions;
+declare function defineView<const T extends DefineViewOptions>(config: T): T;
+/** Convenience helper for table views. Enforces no view-specific required fields. */
+declare function defineTableView(config: DefineTableViewOptions): DefineTableViewOptions;
+/** Convenience helper for kanban views. Enforces `groupBy` is provided. */
+declare function defineKanbanView(config: DefineKanbanViewOptions): DefineKanbanViewOptions;
+/** Convenience helper for calendar views. Enforces `dateField` is provided. */
+declare function defineCalendarView(config: DefineCalendarViewOptions): DefineCalendarViewOptions;
+/** Convenience helper for gantt views. Enforces `startDateField` and `endDateField` are provided. */
+declare function defineGanttView(config: DefineGanttViewOptions): DefineGanttViewOptions;
+/** Convenience helper for cards views. Optional `groupBy`. */
+declare function defineCardsView(config: DefineCardsViewOptions): DefineCardsViewOptions;
+/**
+ * Defines a custom workflow action for an operational view.
+ *
+ * @example
+ * ```ts
+ * export const markPaidAction = defineAction({
+ *   name: "markPaid",
+ *   label: "Mark Paid",
+ *   icon: "DollarSign",
+ *   type: "bulk",
+ *   confirm: "Mark selected orders as paid?",
+ *   mutation: { status: "paid" },
+ * });
+ * ```
+ */
+declare function defineAction<const T extends DefineActionOptions>(config: T): T;
 
-/** 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.
+ * Definition of a navigation group in the Dyrected admin sidebar.
  */
-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 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";
+}
 /**
- * Configuration options for rendering a field in a Detail View.
+ * Options for defining an operational workspace, or customizing placement of collections/globals, with `defineWorkspace`.
  */
-interface DisplayFieldOptions {
-    /** Custom label overriding the field's schema label. */
+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;
-    /** 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;
+    /** 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[];
 }
 /**
- * Declared field item in a Detail View.
+ * 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 DetailField {
-    /** Identifies this item as a field. */
-    type: "field";
-    /** Field name or nested path in the document. */
-    field: string;
-    /** Display options for this field. */
-    options?: DisplayFieldOptions;
-}
+declare function defineWorkspace(options: DefineWorkspaceOptions): DefineWorkspaceOptions;
 /**
- * Configuration options for a Detail View section container.
+ * Runtime compiled representation of a single navigation item.
  */
-interface DetailSectionOptions {
-    /** Lucide icon name displayed in the section header. */
+interface CompiledNavItem {
+    id: string;
+    type: "workspace" | "collection" | "global" | "dashboard" | "link";
+    slug: string;
+    label: string;
     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;
+    group?: string;
+    href?: string;
+    badge?: NavBadgeConfig | string;
+    access?: string[] | AccessRule;
+    order: number;
+    collection?: string;
+    global?: string;
+    views: ViewConfig[];
 }
 /**
- * Section container grouping fields and components in a Detail View.
+ * Runtime compiled representation of a navigation group containing items.
  */
-interface DetailSection {
-    /** Identifies this item as a section. */
-    type: "section";
-    /** Section heading title. */
-    title: string;
-    /** Child items rendered inside this section. */
-    items: DetailItem[];
-    /** Section container options. */
-    options?: DetailSectionOptions;
+interface CompiledNavGroup {
+    id: string;
+    name: string;
+    slug: string;
+    icon?: string;
+    defaultExpanded?: boolean;
+    order: number;
+    items: CompiledNavItem[];
 }
 /**
- * Configuration options for an individual tab in `displayTabs()`.
+ * Complete runtime compiled navigation tree.
  */
-interface DetailTabOptions {
-    /** Lucide icon name displayed inside the tab trigger. */
+interface CompiledNavTree {
+    groups: CompiledNavGroup[];
+    ungrouped: CompiledNavItem[];
+}
+interface PinnedNavItemRef {
+    type: "workspace" | "collection" | "global" | "link" | "dashboard";
+    slug: string;
+    view?: string;
+    label?: string;
     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;
 }
-/**
- * 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;
+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[];
 }
-/**
- * Configuration options for a tabbed container.
- */
-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;
+/** Ordered custom component keys rendered around an operational view's content. */
+interface CollectionViewComponentSlots {
+    beforeViewHeader?: string[];
+    afterViewHeader?: string[];
+    beforeViewContent?: string[];
+    afterViewContent?: string[];
 }
-/**
- * Tabbed navigation container in a Detail View layout.
- */
-interface DetailTabs {
-    /** Identifies this item as a tab container. */
-    type: "tabs";
-    /** List of tabs in this container. */
-    tabs: DetailTab[];
-    /** Tab container options. */
-    options?: DetailTabsOptions;
+/** Ordered custom component keys rendered around a collection's list content. */
+interface CollectionListComponentSlots {
+    beforeList?: string[];
+    beforeListTable?: string[];
+    afterListTable?: string[];
+    afterList?: string[];
+    beforeViewHeader?: string[];
+    afterViewHeader?: string[];
+    beforeViewContent?: string[];
+    afterViewContent?: string[];
+    collectionView?: CollectionViewComponentSlots;
 }
 /**
- * Configuration options for a sub-grid container.
+ * Branding and metadata options for the Dyrected Admin UI.
+ *
+ * @example
+ * admin: {
+ *   branding: {
+ *     logo: '/logo.svg',
+ *     primaryColor: '#6366f1',
+ *   },
+ *   meta: {
+ *     titleSuffix: '- My App',
+ *   },
+ * }
  */
-interface DetailGridOptions {
-    /** Grid width of the sub-grid container in the surrounding layout. */
-    span?: DetailSpan;
+interface AdminConfig {
+    /**
+     * Custom navigation layout for the admin sidebar.
+     * If omitted, all collections and globals appear in default sections.
+     */
+    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;
+    };
     /**
-     * Visibility condition for this grid container.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     * The canonical/base URL of the frontend website for links and iframe live previews.
      */
-    visible?: string | boolean;
-}
-/**
- * Multi-column sub-grid layout inside a section or tab.
- */
-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;
+    siteUrl?: string;
 }
+
+type DeclarativeHookExpression = string;
 /**
- * Configuration options for a repeated array field.
+ * @deprecated Use {@link FieldBeforeChangeHook} or `FieldAfterReadHook` instead.
+ * This alias remains for backwards compatibility.
  */
-interface DetailRepeatOptions {
-    /** Layout style for repeated items: 'table', 'cards', or 'list'. */
-    layout?: "table" | "cards" | "list";
-    /** Message shown when the repeated array is empty. */
-    emptyText?: string;
-    /** Grid width of the repeated container. */
-    span?: DetailSpan;
-    /**
-     * Visibility condition for this repeat container.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
-     */
-    visible?: string | boolean;
-    /** Field name in each row to use as the card header title (e.g. 'title', 'key', 'name'). */
-    useAsTitle?: string;
-    /** Field name in each row to use as the card header title (alias for useAsTitle). */
-    titleField?: string;
-    /** Static card title prefix or template (e.g. 'Category' or 'Card #{index}'). */
-    title?: string;
-    /** Optional icon name for card header. */
-    icon?: string;
-    /** Number of grid columns for cards layout (1, 2, 3, or 4; defaults to 3). */
-    columns?: 1 | 2 | 3 | 4;
-}
+type FieldHook<TDoc extends object = Record<string, unknown>, TValue = unknown> = FieldBeforeChangeHook<TValue, TDoc>;
 /**
- * Delegated repeated array field item in a Detail View.
+ * 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 DetailRepeat {
-    /** Identifies this item as a repeat container. */
-    type: "repeat";
-    /** Array field name in the document. */
-    field: string;
-    /** Item template schemas rendered for each element in the array. */
-    items: DetailItem[];
-    /** Repeat options. */
-    options?: DetailRepeatOptions;
-}
+type 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;
 /**
- * Async or synchronous handler function calculating a computed metric.
+ * Runs after a document (or list of documents) is fetched from the database,
+ * before the response is sent to the client.
  */
-type ComputedHandler<TDoc = any> = (context: {
+type CollectionAfterReadHook<TDoc extends object = Record<string, unknown>> = (args: {
     doc: TDoc;
-    user?: any;
-    db?: any;
-}) => any | Promise<any>;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    db: ReadonlyDatabaseAdapter;
+}) => TDoc | Promise<TDoc>;
+type CollectionAfterReadHookEntry<TDoc extends object = Record<string, unknown>> = CollectionAfterReadHook<TDoc> | DeclarativeHookExpression;
 /**
- * Configuration options for a computed value card.
+ * Runs **before** a document is created or updated in the database.
  */
-interface DetailComputedOptions<TDoc = any> {
-    /** Unique identifier for the computed metric. */
-    id?: string;
-    /** JEXL expression string evaluated against `{ doc, user }`. */
-    expression?: string;
-    /** Async or sync function receiving `{ doc, user, db }` returning the computed value. */
-    handler?: ComputedHandler<TDoc>;
-    /** Grid width for the computed card. */
-    span?: DetailSpan;
-    /** Formatting preset for the computed value ('currency', 'percent', 'number', 'date'). */
-    format?: string;
-    /** Currency code when format is 'currency'. */
-    currency?: string;
-    /**
-     * Visibility condition for this computed card.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
-     */
-    visible?: string | boolean;
-}
+type 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;
 /**
- * Computed KPI or metric card in a Detail View.
+ * Runs **after** a document is created or updated in the database.
  */
-interface DetailComputed<TDoc = any> {
-    /** Identifies this item as a computed value. */
-    type: "computed";
-    /** Unique computed identifier. */
-    id?: string;
-    /** Human-readable card label. */
-    label: string;
-    /** JEXL evaluation string. */
-    expression?: string;
-    /** Computed function handler. */
-    handler?: ComputedHandler<TDoc>;
-    /** Computed options. */
-    options?: DetailComputedOptions<TDoc>;
-}
+type CollectionAfterChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
+    doc: TDoc;
+    previousDoc?: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    operation: "create" | "update";
+    db: DatabaseAdapter;
+}) => void | Promise<void>;
 /**
- * Configuration options for a horizontal divider line.
+ * Runs **before** a document is deleted from the database.
  */
-interface DetailDividerOptions {
-    /** Grid span in the surrounding layout. */
-    span?: DetailSpan;
-    /**
-     * Visibility condition for this divider.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
-     */
-    visible?: string | boolean;
-    /** Vertical margin spacing around the divider line. */
-    spacing?: "sm" | "md" | "lg" | "none";
-}
+type CollectionBeforeDeleteHook<TDoc extends object = Record<string, unknown>> = (args: {
+    id: string;
+    doc: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    db: ReadonlyDatabaseAdapter;
+}) => void | Promise<void>;
 /**
- * Horizontal divider line in a Detail View layout.
+ * Runs **after** a document has been deleted from the database.
  */
-interface DetailDivider {
-    /** Identifies this item as a divider. */
-    type: "divider";
-    /** Divider options. */
-    options?: DetailDividerOptions;
-}
+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;
 /**
- * Configuration options for a static text or callout block.
+ * Runs after the global document is fetched, before the response is sent.
  */
-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;
-}
+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;
 /**
- * Static text, heading, callout, or notice block in a Detail View.
+ * Runs before the global document is updated.
+ * Operation is always `'update'` (globals cannot be created or deleted).
  */
-interface DetailText {
-    /** Identifies this item as a text block. */
-    type: "text";
-    /** Text or markdown content. */
-    content: string;
-    /** Text options. */
-    options?: DetailTextOptions;
-}
+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;
 /**
- * Configuration options for a custom React component slot.
+ * Runs after the global document is updated. Side-effects only.
  */
-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 GlobalAfterChangeHook<TDoc extends object = Record<string, unknown>> = (args: {
+    doc: TDoc;
+    previousDoc?: TDoc;
+    req: HookRequestContext;
+    user?: AuthenticatedUser;
+    operation: "update";
+    db: DatabaseAdapter;
+}) => void | Promise<void>;
 /**
- * Custom React component slot mounted in a Detail View.
+ * @deprecated Use the specific hook types instead:
+ * `CollectionBeforeChangeHook`, `CollectionAfterReadHook`, etc.
+ *
+ * This broad type remains for backwards compatibility with the internal hook runner.
  */
-interface DetailCustom<TDoc = any> {
-    /** Identifies this item as a custom component. */
-    type: "custom";
-    /** Registered custom component name. */
+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;
-    /** Custom component options. */
-    options?: DetailCustomOptions<TDoc>;
+    /** 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";
 }
-/**
- * Configuration options for rendering an action button in a Detail View.
- */
-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;
+interface WorkflowTransition {
+    /** Stable transition key used by the REST and SDK APIs. */
+    name: string;
+    label: string;
     /**
-     * Visibility condition for this action item.
-     * Can be a boolean or a JEXL expression evaluated against `{ doc, user }`.
+     * Source state(s) this transition originates from.
+     * Must match names in the workflow's `states` array.
      */
-    visible?: string | boolean;
+    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;
 }
-/**
- * Renders a button for a named action from `collection.actions` at this
- * position in a Detail View. The same action (and its confirm dialog, modal
- * fields, and execution) can also render automatically in the Detail View's
- * header toolbar when the action's `type` is `'header'` — placing it here
- * too does not duplicate that config, it just adds another entry point to
- * the same action.
- */
-interface DetailAction {
-    /** Identifies this item as an action button. */
-    type: "action";
-    /** Name of the action, matching an entry in `collection.actions`. */
-    name: string;
-    /** Display and visibility options for this placement. */
-    options?: DetailActionOptions;
+interface WorkflowRole {
+    /** Existing user role value, for example `editor` or `publisher`. */
+    role: string;
+    capabilities: string[];
 }
 /**
- * Union of all valid item types in a Detail View schema.
- */
-type DetailItem<TDoc = any> = DetailSection | DetailTabs | DetailGrid | DetailField | DetailRepeat | DetailComputed<TDoc> | DetailDivider | DetailText | DetailCustom<TDoc> | DetailAction | string;
-/**
- * Detail View layout schema definition for a collection or global.
+ * 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`.
  */
-type DetailSchema<TDoc = any> = DetailItem<TDoc>[];
+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;
 /**
- * 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.
+ * Visual display variants supported by DetailFieldRenderer.
  */
-type AggregateCastType = "number" | "integer" | "float" | "string" | "boolean" | "date";
+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 `count` aggregate operation.
- *
- * - `count: "*"` — count every document matched by `where`.
- * - `cast` is intentionally absent: counting is document-level,
- *   not field-value-level, so type conversion has no meaning here.
+ * Configuration options for rendering a field in a Detail View.
  */
-interface CountOperation {
-    count: "*";
-    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 `countDistinct` aggregate operation that counts the number of unique
- * non-null values for a specific field.
+ * Declared field item in a Detail View.
  */
-interface DistinctCountOperation {
-    countDistinct: string;
-    where?: Record<string, unknown>;
+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;
 }
 /**
- * A `distinct` aggregate operation that retrieves the unique values
- * (or unique values with item counts) for a specific field.
+ * Configuration options for a Detail View section container.
  */
-interface DistinctValuesOperation {
-    distinct: string;
-    where?: Record<string, unknown>;
+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;
 }
 /**
- * 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`.
+ * Section container grouping fields and components in a Detail View.
  */
-interface NumericOperation {
-    sum?: string;
-    avg?: string;
-    min?: string;
-    max?: string;
-    cast?: AggregateCastType;
-    where?: Record<string, unknown>;
+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;
 }
 /**
- * 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`.
+ * Configuration options for an individual tab in `displayTabs()`.
  */
-interface AggregateArgs {
-    /** Collection slug. */
-    collection: string;
-    /** Named aggregate operations to compute. */
-    aggregates: AggregateInput;
-    /** Optional field to group the aggregates by. */
-    groupBy?: string;
+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;
 }
 /**
- * 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.
+ * Single tab entry inside a tabbed 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 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;
 }
 /**
- * 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.
+ * Configuration options for a tabbed container.
  */
-likeOperator?: 'LIKE' | 'ILIKE'): SqlWhereResult;
+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;
+}
 /**
- * Translates a WhereClause into a MongoDB filter object.
- * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
+ * Tabbed navigation container in a Detail View layout.
  */
-declare function parseMongoWhere(where: WhereClause): Record<string, any>;
-
+interface DetailTabs {
+    /** Identifies this item as a tab container. */
+    type: "tabs";
+    /** List of tabs in this container. */
+    tabs: DetailTab[];
+    /** Tab container options. */
+    options?: DetailTabsOptions;
+}
 /**
- * Custom component slots rendered around an operational view's content.
+ * Configuration options for a sub-grid container.
  */
-type ViewComponentSlots = CollectionViewComponentSlots;
+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;
+}
 /**
- * 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.
+ * Multi-column sub-grid layout inside a section or tab.
  */
-type ViewLayout = 'table' | 'spreadsheet' | 'kanban' | 'calendar' | 'gantt' | 'cards';
+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;
+}
 /**
- * Scope and placement for an operational view action:
- * - `'row'`: Renders as an inline action button on each document/row.
- * - `'bulk'`: Appears in the floating bulk action bar when one or more rows are selected.
- * - `'header'`: Renders as a primary action button in the view header.
+ * Configuration options for a repeated array field.
  */
-type ActionType = 'row' | 'bulk' | 'header';
+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;
+}
 /**
- * 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
- * }
- * ```
+ * Delegated repeated array field item in a Detail View.
  */
-interface ViewActionFeatures {
-    /** Enables the "View" preview / read-only drawer button. Defaults to `true`. */
-    view?: boolean;
-    /** Enables the "Edit" document form link. Defaults to `true`. */
-    edit?: boolean;
-    /** Enables the "Duplicate" record action. Defaults to `true`. */
-    duplicate?: boolean;
-    /** Enables the "Delete" record action. Defaults to `true`. */
-    delete?: boolean;
-    /** Enables the "Export selected" CSV action in the bulk action bar. Defaults to `true`. */
-    exportSelected?: boolean;
+interface 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;
 }
 /**
- * Color palette options for metric cards:
- * `'purple' | 'emerald' | 'amber' | 'rose' | 'blue' | 'indigo' | 'cyan' | 'orange'`
+ * Async or synchronous handler function calculating a computed metric.
  */
-type MetricColor = 'purple' | 'emerald' | 'amber' | 'rose' | 'blue' | 'indigo' | 'cyan' | 'orange' | string;
+type ComputedHandler<TDoc = any> = (context: {
+    doc: TDoc;
+    user?: any;
+    db?: any;
+}) => any | Promise<any>;
 /**
- * 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 computed value card.
  */
-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"`). */
+interface DetailComputedOptions<TDoc = any> {
+    /** Unique identifier for the computed metric. */
+    id?: string;
+    /** JEXL expression string evaluated against `{ doc, user }`. */
     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"`. */
+    /** 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;
 }
 /**
- * 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",
- * }
- * ```
+ * Computed KPI or metric card in a Detail View.
  */
-interface ViewMetric {
-    /** Title displayed on the metric card header. */
+interface DetailComputed<TDoc = any> {
+    /** Identifies this item as a computed value. */
+    type: "computed";
+    /** Unique computed identifier. */
+    id?: string;
+    /** Human-readable card label. */
     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"`). */
+    /** JEXL evaluation string. */
     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[];
+    /** Computed function handler. */
+    handler?: ComputedHandler<TDoc>;
+    /** Computed options. */
+    options?: DetailComputedOptions<TDoc>;
 }
 /**
- * Complete configuration for a tailored operational view.
+ * Configuration options for a horizontal divider line.
  */
-interface ViewConfig {
-    /** Stable URL slug for the view (`/collections/:slug/views/:viewSlug`). */
-    slug: string;
-    /** Human-readable title displayed in the sidebar navigation and view header. */
-    label: string;
-    /** Lucide icon name (e.g. `"UserCheck"`, `"Calendar"`, `"Shirt"`, `"TableProperties"`). */
-    icon?: string;
-    /** Layout engine to render: `'table' | 'spreadsheet' | 'kanban' | 'calendar' | 'gantt' | 'cards'`. Defaults to `'table'`. */
-    layout?: ViewLayout;
-    /** Base query filter applied before user toolbar filters (e.g. `{ attending: { equals: true } }` or JEXL string). */
-    filter?: WhereClause | string;
-    /** Field name used to organize records into kanban columns or collapsible grouped sections in table, cards, and spreadsheet. */
-    groupBy?: string;
-    /** Field name containing the ISO date string for calendar placement. Required when `layout: 'calendar'`. */
-    dateField?: string;
-    /** Field name for the start date in timeline/gantt views. Required when `layout: 'gantt'`. */
-    startDateField?: string;
-    /** Field name for the end date in timeline/gantt views. Required when `layout: 'gantt'`. */
-    endDateField?: string;
-    /** Field names to show in this view, in order. If omitted, Dyrected infers default display fields. */
-    columns?: string[];
-    /** Default sorting rule when entering the view. */
-    sort?: {
-        field: string;
-        direction: 'asc' | 'desc';
-    };
-    /** Custom workflow actions available in this view. */
-    actions?: ActionConfig[];
-    /** Toggles built-in operations (view/edit/duplicate/delete/export). */
-    features?: ViewActionFeatures;
+interface DetailDividerOptions {
+    /** Grid span in the surrounding 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 divider.
+     * 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;
+    /** Vertical margin spacing around the divider line. */
+    spacing?: "sm" | "md" | "lg" | "none";
 }
 /**
- * Base configuration shared by all action types.
+ * Horizontal divider line in a Detail View layout.
  */
-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;
+interface DetailDivider {
+    /** Identifies this item as a divider. */
+    type: "divider";
+    /** Divider options. */
+    options?: DetailDividerOptions;
 }
 /**
- * An operational workflow action with declarative data mutation.
+ * Configuration options for a static text or callout block.
  */
-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 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;
 }
 /**
- * An operational workflow action with server handler.
+ * Static text, heading, callout, or notice block in a Detail View.
  */
-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 DetailText {
+    /** Identifies this item as a text block. */
+    type: "text";
+    /** Text or markdown content. */
+    content: string;
+    /** Text options. */
+    options?: DetailTextOptions;
 }
 /**
- * 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 custom React component slot.
  */
-interface ActionContext<TDoc extends Record<string, unknown> = Record<string, unknown>> {
-    /** The target document (for row actions), or null for header actions. */
-    doc: TDoc | null;
-    /** All targeted documents (for bulk actions). Empty array for header actions. */
-    docs: TDoc[];
-    /** The authenticated acting user, if available. */
-    user: Record<string, unknown> | null;
-    /** User inputs submitted via the action's modal form fields. */
-    input: Record<string, unknown>;
-    /** The collection configuration object. */
-    collection: Record<string, unknown>;
+interface 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;
 }
 /**
- * Role-based access control rules for a view or action.
+ * Custom React component slot mounted in a Detail View.
  */
-interface AccessConfig {
-    read?: AccessRule<any>;
-    create?: AccessRule<any>;
-    update?: AccessRule<any>;
-    delete?: AccessRule<any>;
+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>;
 }
 /**
- * Base options shared by all operational view types.
+ * Configuration options for rendering an action button in a Detail View.
  */
-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 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;
     /**
-     * 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 action item.
+     * 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;
-}
-/** Cards view — shows records as image/thumbnail gallery. */
-interface DefineCardsViewOptions extends DefineViewBaseOptions {
-    layout: 'cards';
-    /** Field name used to organize records into groups. */
-    groupBy?: string;
+    visible?: string | boolean;
 }
 /**
- * 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" },
- * });
- * ```
- */
-type DefineViewOptions = DefineTableViewOptions | DefineKanbanViewOptions | DefineCalendarViewOptions | DefineGanttViewOptions | DefineCardsViewOptions;
-/**
- * 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.
@@ -2162,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.
@@ -2425,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;
     };
@@ -3954,4 +4064,4 @@ interface DyrectedContext {
  */
 declare function createDyrectedApp(rawConfig: DyrectedConfig | any): Promise<Hono<DyrectedContext, hono_types.BlankSchema, "/">>;
 
-export { type ImageField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailTabs as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailTextOptions as I, type DetailText as J, type DetailSchema as K, type LifecycleEventName as L, type DyrectedContext as M, type AIConfig as N, type AIPIIConfig as O, type PublicAdminAuthConfig as P, type IdStrategy as Q, type ArrayField as R, type FieldType as S, type BooleanField as T, type AuthConfig as U, type AccessPolicyResolver as V, type WorkflowConfig as W, type DateField as X, type DateTimeField as Y, type EmailField as Z, type IconField as _, type DeclarativeHookExpression as a, type BlocksField as a$, type JoinField as a0, type JsonField as a1, type MultiSelectField as a2, type NumberField as a3, type ObjectField as a4, type RadioField as a5, type RelationshipField as a6, type RichTextField as a7, type RowField as a8, type SelectField as a9, type AccessRule as aA, type ActionConfig as aB, type ActionConfigBase as aC, type ActionConfigWithHandler as aD, type ActionConfigWithMutation as aE, type ActionContext as aF, type ActionType as aG, type AdminAuthAccessResolution as aH, type AdminAuthClaimMapping as aI, type AdminAuthMember as aJ, type AdminAuthProvider as aK, type AdminAuthProviderMembersConfig as aL, type AdminAuthProvisioningMode as aM, type AdminAuthResolveAccessArgs as aN, type AdminAuthResolvedIdentity as aO, type AdminConfig as aP, type AdminDashboardComponentSlots as aQ, type AdminIconName as aR, type AggregateArgs as aS, type AggregateCastType as aT, type AggregateCollectionResult as aU, type AggregateInput as aV, type AggregateOperation as aW, type AggregateResult as aX, type BaseAdminAuthProvider as aY, type BaseFieldAdmin as aZ, type BlockVariant as a_, type TextField as aa, type TextareaField as ab, type TimeField as ac, type UrlField as ad, type AIAction as ae, type AIActionStatus as af, type AIActionType as ag, type AIAuditActionType as ah, type AIAuditRecord as ai, type AIChunk as aj, type AIMessage as ak, type AIPIIPattern as al, type AIRateLimitResult as am, type AIRateLimitStore as an, type AIThread as ao, type AIToolContext as ap, type AIToolDefinition as aq, AI_ACTIONS_COLLECTION as ar, AI_AUDIT_COLLECTION as as, AI_CHUNKS_COLLECTION as at, AI_MESSAGES_COLLECTION as au, AI_THREADS_COLLECTION as av, type AccessConfig as aw, type AccessFunction as ax, type AccessFunctionArgs as ay, type AccessResult as az, type AuthenticatedUser as b, type GlobalAfterChangeHook as b$, type BooleanFieldAdmin as b0, type BooleanFormat as b1, type CharacterLimitFieldAdmin as b2, type CharacterLimitFieldConfig as b3, type CollectionAfterChangeHook as b4, type CollectionAfterDeleteHook as b5, type CollectionAfterReadHook as b6, type CollectionAfterReadHookEntry as b7, type CollectionAfterTransitionHook as b8, type CollectionBeforeChangeHook as b9, type DisplayTone as bA, type DisplayVariant as bB, type DistinctCountOperation as bC, type DistinctValuesOperation as bD, type DynamicOptionItem as bE, type DynamicOptionsConfig as bF, type DynamicOptionsResolver as bG, type DynamicOptionsResolverArgs as bH, type DyrectedAIContext as bI, type DyrectedLoggerConfig as bJ, type DyrectedObservabilityConfig as bK, type EmailFieldAdmin as bL, type FieldAdminHooks as bM, type FieldAdminOnChangeHook as bN, type FieldAdminOnChangeHookArgs as bO, type FieldAdminOptionsHook as bP, type FieldAdminOptionsHookArgs as bQ, type FieldAdminOptionsHookResult as bR, type FieldAfterReadHook as bS, type FieldAfterReadHookArgs as bT, type FieldBase as bU, type FieldBeforeChangeHook as bV, type FieldBeforeChangeHookArgs as bW, type FieldHook as bX, type FieldHooks as bY, type FileData as bZ, type GetDocumentResult as b_, type CollectionBeforeChangeHookEntry as ba, type CollectionBeforeDeleteHook as bb, type CollectionBeforeReadHook as bc, type CollectionBeforeReadHookEntry as bd, type CollectionBeforeTransitionHook as be, type CollectionIndex as bf, type CollectionListComponentSlots as bg, type CollectionRAGConfig as bh, type CollectionSchemaResult as bi, type CollectionSummaryResult as bj, type CollectionViewComponentSlots as bk, type CountOperation as bl, type CustomAdminAuthProvider as bm, type DatabaseAdapter as bn, type DateFieldAdmin as bo, type DateFormat as bp, type DefaultValueContext as bq, type DefineActionOptions as br, type DefineCalendarViewOptions as bs, type DefineCardsViewOptions as bt, type DefineGanttViewOptions as bu, type DefineKanbanViewOptions as bv, type DefineTableViewOptions as bw, type DefineViewBaseOptions as bx, type DefineViewOptions as by, type DetailSpan as bz, type WorkflowTransition as c, type WorkflowMetadata as c$, type GlobalAfterReadHook as c0, type GlobalAfterReadHookEntry as c1, type GlobalBeforeChangeHook as c2, type GlobalBeforeChangeHookEntry as c3, type GlobalBeforeReadHook as c4, type GlobalBeforeReadHookEntry as c5, type GlobalRAGConfig as c6, type GlobalSchemaResult as c7, type GlobalSummaryResult as c8, type HeadingLevel as c9, type RadioFieldAdmin as cA, type RateLimitConfig as cB, type ReadonlyDatabaseAdapter as cC, type RichTextFeature as cD, type RichTextFieldConfig as cE, type SelectFieldAdmin as cF, type SqlWhereResult as cG, type StorageAdapter as cH, type TextFieldAdmin as cI, type TextFormat as cJ, type TextareaFieldAdmin as cK, type TrustProxyConfig as cL, type TypedField as cM, type UploadConfig as cN, type UrlFieldAdmin as cO, type UrlLinkValue as cP, type ViewActionFeatures as cQ, type ViewComponentSlots as cR, type ViewConfig as cS, type ViewLayout as cT, type ViewMetric as cU, type ViewSubMetric as cV, type WhereClause as cW, type WhereOperator as cX, type WhereOperatorName as cY, type WordLimitFieldAdmin as cZ, type WordLimitFieldConfig as c_, type HookFunction as ca, type IconFieldAdmin as cb, type ImageService as cc, type ImageTransformOptions as cd, type InferAggregateResult as ce, type JoinFieldAdmin as cf, type JsonFieldAdmin as cg, type JsonFormat as ch, LIFECYCLE_EVENT_NAMES as ci, type LifecycleEventHandler as cj, type LinkFormat as ck, type MetricColor as cl, type MultiSelectFieldAdmin as cm, type NamedAccessPolicy as cn, type NumberFieldAdmin as co, type NumberFormat as cp, type NumberLimitFieldAdmin as cq, type NumberLimitFieldConfig as cr, type NumericOperation as cs, type NumericUpdateOperator as ct, type OIDCAdminAuthProvider as cu, type OptionFormat as cv, type PaginatedResult as cw, type PublicAdminAuthProvider as cx, type QueryCollectionResult as cy, type RAGSearchResult as cz, type LifecycleEvent as d, type WorkflowRole as d0, type WorkflowState as d1, type WorkflowTransitionContext as d2, defineAction as d3, defineCalendarView as d4, defineCardsView as d5, defineGanttView as d6, defineKanbanView as d7, defineTableView as d8, defineView as d9, resolveSessionTokenExpiry as dA, shouldSampleRequest as dB, signCollectionToken as dC, verifyCollectionToken as dD, isAICollection as da, parseMongoWhere as db, parseSqlWhere as dc, type CollectionTokenPayload as dd, DEFAULT_SESSION_EXPIRY as de, type DyrectedObservabilityRuntime as df, type RequestBodyCapture as dg, type RequestTraceContext as dh, type ResolvedObservabilityConfig as di, attachRequestMetrics as dj, bindObservabilityRuntime as dk, buildRequestLogger as dl, captureRequestBody as dm, createDyrectedApp as dn, createObservabilityRuntime as dp, createRequestSpan as dq, decodeCollectionToken as dr, endRequestSpan as ds, getConfigLogger as dt, getObservabilityRuntime as du, getRequestLogger as dv, redactBody as dw, redactHeaders as dx, renderPrometheusMetrics as dy, resolveObservabilityConfig as dz, type BaseDocument as e, type DetailActionOptions as f, type DetailAction as g, type DetailComputedOptions as h, type ComputedHandler as i, type DetailComputed as j, type DetailCustomOptions as k, type DetailCustom as l, type DetailDividerOptions as m, type DetailDivider as n, type DisplayFieldOptions as o, type DetailField as p, type DetailItem as q, type DetailGridOptions as r, type DetailGrid as s, type DetailRepeatOptions as t, type DetailRepeat as u, type DetailSectionOptions as v, type DetailSection as w, type DetailTabOptions as x, type DetailTab as y, type DetailTabsOptions as z };
+export { type 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 };