@dyrected/core 2.9.0 → 2.10.1

package/dist/{app-config-gEQJFvnN.d.cts → app-config-BLC7WoyL.d.cts}

@@ -162,12 +162,24 @@ interface AdminDashboardComponentSlots {
     beforeDashboard?: string[];
     afterDashboard?: string[];
 }
+/** Ordered custom component keys rendered around an operational view's content. */
+interface CollectionViewComponentSlots {
+    beforeViewHeader?: string[];
+    afterViewHeader?: string[];
+    beforeViewContent?: string[];
+    afterViewContent?: string[];
+}
 /** Ordered custom component keys rendered around a collection's list content. */
 interface CollectionListComponentSlots {
     beforeList?: string[];
     beforeListTable?: string[];
     afterListTable?: string[];
     afterList?: string[];
+    beforeViewHeader?: string[];
+    afterViewHeader?: string[];
+    beforeViewContent?: string[];
+    afterViewContent?: string[];
+    collectionView?: CollectionViewComponentSlots;
 }
 /**
  * Branding and metadata options for the Dyrected Admin UI.
@@ -870,6 +882,22 @@ interface CountOperation {
     count: "*";
     where?: Record<string, unknown>;
 }
+/**
+ * A `countDistinct` aggregate operation that counts the number of unique
+ * non-null values for a specific field.
+ */
+interface DistinctCountOperation {
+    countDistinct: string;
+    where?: Record<string, unknown>;
+}
+/**
+ * A `distinct` aggregate operation that retrieves the unique values
+ * (or unique values with item counts) for a specific field.
+ */
+interface DistinctValuesOperation {
+    distinct: string;
+    where?: Record<string, unknown>;
+}
 /**
  * A `sum`, `avg`, `min`, or `max` aggregate operation on a named field.
  *
@@ -886,9 +914,9 @@ interface NumericOperation {
     where?: Record<string, unknown>;
 }
 /**
- * A single named aggregate request — either a count or a numeric operation.
+ * A single named aggregate request — either a count, distinct count, distinct values, or numeric operation.
  */
-type AggregateOperation = CountOperation | NumericOperation;
+type AggregateOperation = CountOperation | DistinctCountOperation | DistinctValuesOperation | NumericOperation;
 /**
  * The map of named aggregate operations sent in a single aggregate request.
  *
@@ -896,6 +924,8 @@ type AggregateOperation = CountOperation | NumericOperation;
  * ```ts
  * {
  *   totalSubmitted: { count: "*" },
+ *   uniqueGuests: { countDistinct: "email" },
+ *   availableSizes: { distinct: "asoebiSize" },
  *   totalAsoebiYards: { sum: "asoebiYards", cast: "number", where: { wantsAsoebi: { equals: true } } },
  * }
  * ```
@@ -909,153 +939,447 @@ interface AggregateArgs {
     collection: string;
     /** Named aggregate operations to compute. */
     aggregates: AggregateInput;
+    /** Optional field to group the aggregates by. */
+    groupBy?: string;
 }
 /**
  * The result returned by `DatabaseAdapter.aggregate`.
  *
- * Every named key maps to a `number | null`.
- * `null` is returned when no documents matched the aggregate's `where`
- * (applicable to `sum`, `avg`, `min`, `max`).
- * `count` also returns `null` only if the database errors — it normally
- * returns `0` for an empty match set.
+ * 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, number | null>;
+type AggregateResult = Record<string, any>;
 /**
  * Derives the typed result shape from an `AggregateInput`.
- * Every named key maps to `number | null`.
- *
- * @example
- * ```ts
- * type Input = { totalSubmitted: CountOperation; totalYards: NumericOperation };
- * type Result = InferAggregateResult<Input>;
- * // => { totalSubmitted: number | null; totalYards: number | null }
- * ```
  */
 type InferAggregateResult<T extends AggregateInput> = {
-    [K in keyof T]: number | null;
+    [K in keyof T]: any;
 };
 
+/**
+ * Dyrected Where Clause DSL — shared query language across all database adapters.
+ *
+ * Adapters translate this DSL into their native format:
+ *   - SQL adapters (SQLite, Postgres, MySQL): use parseSqlWhere()
+ *   - MongoDB adapter: use parseMongoWhere()
+ *   - Future adapters: implement their own translator against WhereClause
+ *
+ * Exhaustive operator handling is enforced at compile time via `assertNever`,
+ * so adding a new operator without handling it will produce a TypeScript error
+ * in every adapter translator.
+ */
+type WhereOperatorName = 'equals' | 'not_equals' | 'in' | 'not_in' | 'gt' | 'greater_than' | 'gte' | 'greater_than_equal' | 'greater_than_or_equal' | 'lt' | 'less_than' | 'lte' | 'less_than_equal' | 'less_than_or_equal' | 'contains' | 'like' | 'starts_with' | 'exists';
+type WhereOperator = {
+    equals: any;
+} | {
+    not_equals: any;
+} | {
+    in: any[];
+} | {
+    not_in: any[];
+} | {
+    gt: any;
+} | {
+    greater_than: any;
+} | {
+    gte: any;
+} | {
+    greater_than_equal: any;
+} | {
+    greater_than_or_equal: any;
+} | {
+    lt: any;
+} | {
+    less_than: any;
+} | {
+    lte: any;
+} | {
+    less_than_equal: any;
+} | {
+    less_than_or_equal: any;
+} | {
+    contains: string;
+} | {
+    like: string;
+} | {
+    starts_with: string;
+} | {
+    exists: boolean;
+};
+/** Top-level where clause. Fields map to operator objects or shorthand scalar values. */
+type WhereClause = {
+    [field: string]: WhereOperator | any;
+    OR?: WhereClause[];
+    or?: WhereClause[];
+    AND?: WhereClause[];
+    and?: WhereClause[];
+};
+interface SqlWhereResult {
+    sql: string;
+    params: any[];
+}
+/**
+ * Translates a WhereClause into a parameterized SQL WHERE fragment.
+ *
+ * @param where         The Dyrected where DSL object
+ * @param getJsonField  Returns the SQL expression for a JSON-stored field (dialect-specific):
+ *                        SQLite:   (f) => `json_extract(data, '$.${f}')`
+ *                        Postgres: (f) => `data->>'${f}'`
+ *                        MySQL:    (f) => `JSON_UNQUOTE(JSON_EXTRACT(data, '$.${f}'))`
+ * @param placeholder   '?' for SQLite/MySQL, 'pg' for auto-incrementing Postgres $1/$2/…
+ */
+declare function parseSqlWhere(where: WhereClause, getJsonField: (field: string) => string, placeholder?: '?' | 'pg', 
+/**
+ * SQL keyword used for `contains`/`starts_with`. Postgres `LIKE` is
+ * case-sensitive, so the Postgres adapter defaults to `'ILIKE'` to keep substring
+ * matching case-insensitive like SQLite and MySQL.
+ */
+likeOperator?: 'LIKE' | 'ILIKE'): SqlWhereResult;
+/**
+ * Translates a WhereClause into a MongoDB filter object.
+ * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
+ */
+declare function parseMongoWhere(where: WhereClause): Record<string, any>;
+
+/**
+ * Custom component slots rendered around an operational view's content.
+ */
+type ViewComponentSlots = CollectionViewComponentSlots;
+/**
+ * Supported layout engines for operational views in the Dyrected Admin UI:
+ * - `'table'`: The workhorse — column sorting, search, faceted filters, and bulk actions.
+ * - `'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
- * (View/Edit/Duplicate/Delete/Export-selected). All default to enabled;
- * set any to `false` to hide that operation for the view.
+ * 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;
+    /** 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;
 }
+/**
+ * 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[];
 }
+/**
+ * Complete configuration for a tailored operational view.
+ */
 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;
-    filter?: Record<string, any> | string;
+    /** 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;
     /**
-     * Explicit display order for actions — built-in names ("view", "edit",
-     * "duplicate", "delete") and/or custom action names. Unlisted actions
-     * append in their default order.
+     * 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[];
+    /** Role-based access rules controlling who can see or use this view. */
     access?: AccessConfig;
 }
-interface ActionConfig {
+/**
+ * An operational workflow action that can mutate data or trigger server logic.
+ */
+interface ActionConfig<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[];
-    mutation?: Record<string, any>;
-    handler?: (context: ActionContext) => Promise<any>;
+    /** 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;
 }
-interface ActionContext {
-    doc: Record<string, unknown>;
-    docs: Record<string, unknown>[];
+/**
+ * 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). */
+    doc: TDoc;
+    /** All targeted documents (for bulk actions). */
+    docs: TDoc[];
+    /** The authenticated acting user, if available. */
     user: Record<string, unknown> | null;
+    /** User inputs submitted via the action's modal form fields. */
     input: Record<string, unknown>;
+    /** The collection configuration object. */
     collection: Record<string, unknown>;
 }
+/**
+ * Role-based access control rules for a view or action.
+ */
 interface AccessConfig {
     read?: AccessRule<any>;
     create?: AccessRule<any>;
     update?: AccessRule<any>;
     delete?: AccessRule<any>;
 }
+/**
+ * Options for defining an operational view with `defineView`.
+ *
+ * @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" },
+ * });
+ * ```
+ */
 interface DefineViewOptions {
+    /** 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?: Record<string, any> | 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;
+    /**
+     * 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[];
+    /** 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 DefineActionOptions {
+/**
+ * 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[];
-    mutation?: Record<string, any>;
-    handler?: (context: ActionContext) => Promise<any>;
+    /** 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;
 }
-declare function defineView(config: DefineViewOptions): ViewConfig;
-declare function defineAction(config: DefineActionOptions): ActionConfig;
+/**
+ * Defines a typed operational view for a collection.
+ *
+ * @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" },
+ * });
+ * ```
+ */
+declare function defineView<const T extends DefineViewOptions>(config: T): T;
+/**
+ * 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;
 
 /**
  * Configures account lockout behavior for an auth-enabled collection.
@@ -1357,6 +1681,11 @@ interface CollectionConfig<TDoc extends object = Record<string, unknown>> {
          * Collections with the same `group` are visually grouped together.
          */
         group?: string;
+        /**
+         * 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.
+         */
+        defaultView?: string;
         /** If `true`, this collection is not shown in the Admin UI sidebar. */
         hidden?: boolean;
         /** If `false`, disables the filter UI entirely for this collection. Defaults to `true`. */
@@ -1411,12 +1740,70 @@ interface CollectionConfig<TDoc extends object = Record<string, unknown>> {
         urlPattern?: string;
     };
     /**
-     * Custom detail view layout configuration for the Admin UI.
-     */
-    detail?: DetailSchema<TDoc> | false;
-    /**
-     * Operational views for this collection.
-     * Each view provides a tailored workspace for a specific job or workflow.
+     * Detail view layout configuration for the Admin UI.
+     *
+     * By default, collections are **Edit-First** (`detail: false`). Clicking a record in the
+     * table or cards view navigates directly to the editing form with Live Preview.
+     *
+     * Set to `true` to enable the automatic read-only summary layout, or provide a `DetailSchema`
+     * array using display helpers (`displaySection`, `displayField`, `displayTabs`, etc.) for a
+     * custom operational dashboard layout.
+     *
+     * @default false
+     * @example
+     * ```ts
+     * // Enable automatic summary detail view
+     * detail: true
+     *
+     * // Or define a custom operational detail view
+     * detail: [
+     *   displaySection("Customer Overview", [
+     *     displayField("name", { span: 8 }),
+     *     displayField("status", { span: 4, display: "badge" }),
+     *   ]),
+     * ]
+     * ```
+     */
+    detail?: DetailSchema<TDoc> | boolean;
+    /**
+     * Slug of the operational view to render by default when navigating to `/collections/:slug`.
+     *
+     * When set:
+     * 1. Navigating to `/collections/:slug` automatically redirects to `/collections/:slug/views/:defaultView`.
+     * 2. The main collection link in the sidebar directly opens this default view.
+     * 3. The sidebar submenu cleanly lists only your defined views without showing a generic `All [Collection]` item.
+     *
+     * @example
+     * ```ts
+     * export const GuestResponses = defineCollection({
+     *   slug: "guest-responses",
+     *   defaultView: "attending-guests",
+     *   views: [attendingGuests, seatingMatrix],
+     *   fields: [...],
+     * });
+     * ```
+     */
+    defaultView?: string;
+    /**
+     * Tailored operational workspaces for this collection (`table`, `spreadsheet`, `kanban`, `calendar`, `cards`, `gantt`).
+     * Each view provides curated columns, filters, metrics, and workflow buttons for a specific job.
+     *
+     * @example
+     * ```ts
+     * views: [
+     *   defineView({
+     *     slug: "attending-guests",
+     *     label: "Attending Guests",
+     *     icon: "UserCheck",
+     *     layout: "table",
+     *     groupBy: "tableNumber",
+     *     filter: { attending: { equals: true } },
+     *     columns: ["name", "email", "guestCount", "checkedIn"],
+     *   }),
+     * ]
+     * ```
+     *
+     * @see {@link https://dyrected.com/docs/model-content/operational-views/overview Operational views overview}
      */
     views?: ViewConfig[];
 }
@@ -1503,9 +1890,17 @@ interface GlobalConfig<TDoc extends object = Record<string, unknown>> {
      */
     initialData?: Partial<TDoc>;
     /**
-     * Custom detail view layout configuration for the Admin UI.
+     * Detail view layout configuration for the Admin UI.
+     *
+     * By default, globals are **Edit-First** (`detail: false`). Clicking the global in the
+     * sidebar navigates directly to the editing form.
+     *
+     * Set to `true` to enable the automatic read-only summary layout, or provide a `DetailSchema`
+     * array for a custom operational dashboard layout.
+     *
+     * @default false
      */
-    detail?: DetailSchema<TDoc> | false;
+    detail?: DetailSchema<TDoc> | boolean;
 }
 
 /**
@@ -2695,4 +3090,4 @@ interface DyrectedConfig<TUser extends AuthenticatedUser = AuthenticatedUser> {
     }>;
 }
 
-export { type RadioField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailText as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailSchema as I, type ArrayField as J, type BlocksField as K, type LifecycleEventName as L, type BooleanField as M, type AuthConfig as N, type AccessPolicyResolver as O, type PublicAdminAuthConfig as P, type DateField as Q, type DateTimeField as R, type EmailField as S, type IconField as T, type ImageField as U, type JoinField as V, type WorkflowConfig as W, type JsonField as X, type MultiSelectField as Y, type NumberField as Z, type ObjectField as _, type DeclarativeHookExpression as a, type DynamicOptionsResolver as a$, type RelationshipField as a0, type RichTextField as a1, type RowField as a2, type SelectField as a3, type TextField as a4, type TextareaField as a5, type TimeField as a6, type UrlField as a7, type AccessConfig as a8, type AccessFunction as a9, type BooleanFormat as aA, type CharacterLimitFieldAdmin as aB, type CharacterLimitFieldConfig as aC, type CollectionAfterChangeHook as aD, type CollectionAfterDeleteHook as aE, type CollectionAfterReadHook as aF, type CollectionAfterReadHookEntry as aG, type CollectionAfterTransitionHook as aH, type CollectionBeforeChangeHook as aI, type CollectionBeforeChangeHookEntry as aJ, type CollectionBeforeDeleteHook as aK, type CollectionBeforeReadHook as aL, type CollectionBeforeReadHookEntry as aM, type CollectionBeforeTransitionHook as aN, type CollectionListComponentSlots as aO, type CountOperation as aP, type CustomAdminAuthProvider as aQ, type DatabaseAdapter as aR, type DateFieldAdmin as aS, type DateFormat as aT, type DefineActionOptions as aU, type DefineViewOptions as aV, type DetailSpan as aW, type DisplayTone as aX, type DisplayVariant as aY, type DynamicOptionItem as aZ, type DynamicOptionsConfig as a_, type AccessFunctionArgs as aa, type AccessResult as ab, type AccessRule as ac, type ActionConfig as ad, type ActionContext as ae, type ActionType as af, type AdminAuthAccessResolution as ag, type AdminAuthClaimMapping as ah, type AdminAuthMember as ai, type AdminAuthProvider as aj, type AdminAuthProviderMembersConfig as ak, type AdminAuthProvisioningMode as al, type AdminAuthResolveAccessArgs as am, type AdminAuthResolvedIdentity as an, type AdminConfig as ao, type AdminDashboardComponentSlots as ap, type AdminIconName as aq, type AggregateArgs as ar, type AggregateCastType as as, type AggregateInput as at, type AggregateOperation as au, type AggregateResult as av, type BaseAdminAuthProvider as aw, type BaseFieldAdmin as ax, type BlockVariant as ay, type BooleanFieldAdmin as az, type AuthenticatedUser as b, type UrlLinkValue as b$, type DynamicOptionsResolverArgs as b0, type DyrectedLoggerConfig as b1, type DyrectedObservabilityConfig as b2, type EmailFieldAdmin as b3, type FieldAdminHooks as b4, type FieldAdminOnChangeHook as b5, type FieldAdminOnChangeHookArgs as b6, type FieldAdminOptionsHook as b7, type FieldAdminOptionsHookArgs as b8, type FieldAdminOptionsHookResult as b9, type LinkFormat as bA, type MetricColor as bB, type MultiSelectFieldAdmin as bC, type NamedAccessPolicy as bD, type NumberFieldAdmin as bE, type NumberFormat as bF, type NumberLimitFieldAdmin as bG, type NumberLimitFieldConfig as bH, type NumericOperation as bI, type OIDCAdminAuthProvider as bJ, type OptionFormat as bK, type PaginatedResult as bL, type PublicAdminAuthProvider as bM, type RadioFieldAdmin as bN, type RateLimitConfig as bO, type ReadonlyDatabaseAdapter as bP, type RichTextFeature as bQ, type RichTextFieldConfig as bR, type SelectFieldAdmin as bS, type StorageAdapter as bT, type TextFieldAdmin as bU, type TextFormat as bV, type TextareaFieldAdmin as bW, type TrustProxyConfig as bX, type TypedField as bY, type UploadConfig as bZ, type UrlFieldAdmin as b_, type FieldAfterReadHook as ba, type FieldAfterReadHookArgs as bb, type FieldBase as bc, type FieldBeforeChangeHook as bd, type FieldBeforeChangeHookArgs as be, type FieldHook as bf, type FieldHooks as bg, type FieldType as bh, type FileData as bi, type GlobalAfterChangeHook as bj, type GlobalAfterReadHook as bk, type GlobalAfterReadHookEntry as bl, type GlobalBeforeChangeHook as bm, type GlobalBeforeChangeHookEntry as bn, type GlobalBeforeReadHook as bo, type GlobalBeforeReadHookEntry as bp, type HeadingLevel as bq, type HookFunction as br, type IconFieldAdmin as bs, type ImageService as bt, type InferAggregateResult as bu, type JoinFieldAdmin as bv, type JsonFieldAdmin as bw, type JsonFormat as bx, LIFECYCLE_EVENT_NAMES as by, type LifecycleEventHandler as bz, type WorkflowTransition as c, type ViewActionFeatures as c0, type ViewConfig as c1, type ViewLayout as c2, type ViewMetric as c3, type ViewSubMetric as c4, type WordLimitFieldAdmin as c5, type WordLimitFieldConfig as c6, type WorkflowMetadata as c7, type WorkflowRole as c8, type WorkflowState as c9, type WorkflowTransitionContext as ca, defineAction as cb, defineView as cc, type LifecycleEvent as d, type BaseDocument as e, type DetailComputedOptions as f, type ComputedHandler as g, type DetailComputed as h, type DetailCustomOptions as i, type DetailCustom as j, type DetailDividerOptions as k, type DetailDivider as l, type DisplayFieldOptions as m, type DetailField as n, type DetailItem as o, type DetailGridOptions as p, type DetailGrid as q, type DetailRepeatOptions as r, type DetailRepeat as s, type DetailSectionOptions as t, type DetailSection as u, type DetailTabOptions as v, type DetailTab as w, type DetailTabsOptions as x, type DetailTabs as y, type DetailTextOptions as z };
+export { type RadioField as $, type AdminAuthConfig as A, type Block as B, type CollectionConfig as C, type DyrectedConfig as D, type DetailText as E, type Field as F, type GlobalConfig as G, type HookRequestContext as H, type DetailSchema as I, type ArrayField as J, type BlocksField as K, type LifecycleEventName as L, type BooleanField as M, type AuthConfig as N, type AccessPolicyResolver as O, type PublicAdminAuthConfig as P, type DateField as Q, type DateTimeField as R, type EmailField as S, type IconField as T, type ImageField as U, type JoinField as V, type WorkflowConfig as W, type JsonField as X, type MultiSelectField as Y, type NumberField as Z, type ObjectField as _, type DeclarativeHookExpression as a, type DistinctValuesOperation as a$, type RelationshipField as a0, type RichTextField as a1, type RowField as a2, type SelectField as a3, type TextField as a4, type TextareaField as a5, type TimeField as a6, type UrlField as a7, type AccessConfig as a8, type AccessFunction as a9, type BooleanFormat as aA, type CharacterLimitFieldAdmin as aB, type CharacterLimitFieldConfig as aC, type CollectionAfterChangeHook as aD, type CollectionAfterDeleteHook as aE, type CollectionAfterReadHook as aF, type CollectionAfterReadHookEntry as aG, type CollectionAfterTransitionHook as aH, type CollectionBeforeChangeHook as aI, type CollectionBeforeChangeHookEntry as aJ, type CollectionBeforeDeleteHook as aK, type CollectionBeforeReadHook as aL, type CollectionBeforeReadHookEntry as aM, type CollectionBeforeTransitionHook as aN, type CollectionListComponentSlots as aO, type CollectionViewComponentSlots as aP, type CountOperation as aQ, type CustomAdminAuthProvider as aR, type DatabaseAdapter as aS, type DateFieldAdmin as aT, type DateFormat as aU, type DefineActionOptions as aV, type DefineViewOptions as aW, type DetailSpan as aX, type DisplayTone as aY, type DisplayVariant as aZ, type DistinctCountOperation as a_, type AccessFunctionArgs as aa, type AccessResult as ab, type AccessRule as ac, type ActionConfig as ad, type ActionContext as ae, type ActionType as af, type AdminAuthAccessResolution as ag, type AdminAuthClaimMapping as ah, type AdminAuthMember as ai, type AdminAuthProvider as aj, type AdminAuthProviderMembersConfig as ak, type AdminAuthProvisioningMode as al, type AdminAuthResolveAccessArgs as am, type AdminAuthResolvedIdentity as an, type AdminConfig as ao, type AdminDashboardComponentSlots as ap, type AdminIconName as aq, type AggregateArgs as ar, type AggregateCastType as as, type AggregateInput as at, type AggregateOperation as au, type AggregateResult as av, type BaseAdminAuthProvider as aw, type BaseFieldAdmin as ax, type BlockVariant as ay, type BooleanFieldAdmin as az, type AuthenticatedUser as b, type TrustProxyConfig as b$, type DynamicOptionItem as b0, type DynamicOptionsConfig as b1, type DynamicOptionsResolver as b2, type DynamicOptionsResolverArgs as b3, type DyrectedLoggerConfig as b4, type DyrectedObservabilityConfig as b5, type EmailFieldAdmin as b6, type FieldAdminHooks as b7, type FieldAdminOnChangeHook as b8, type FieldAdminOnChangeHookArgs as b9, type JsonFormat as bA, LIFECYCLE_EVENT_NAMES as bB, type LifecycleEventHandler as bC, type LinkFormat as bD, type MetricColor as bE, type MultiSelectFieldAdmin as bF, type NamedAccessPolicy as bG, type NumberFieldAdmin as bH, type NumberFormat as bI, type NumberLimitFieldAdmin as bJ, type NumberLimitFieldConfig as bK, type NumericOperation as bL, type OIDCAdminAuthProvider as bM, type OptionFormat as bN, type PaginatedResult as bO, type PublicAdminAuthProvider as bP, type RadioFieldAdmin as bQ, type RateLimitConfig as bR, type ReadonlyDatabaseAdapter as bS, type RichTextFeature as bT, type RichTextFieldConfig as bU, type SelectFieldAdmin as bV, type SqlWhereResult as bW, type StorageAdapter as bX, type TextFieldAdmin as bY, type TextFormat as bZ, type TextareaFieldAdmin as b_, type FieldAdminOptionsHook as ba, type FieldAdminOptionsHookArgs as bb, type FieldAdminOptionsHookResult as bc, type FieldAfterReadHook as bd, type FieldAfterReadHookArgs as be, type FieldBase as bf, type FieldBeforeChangeHook as bg, type FieldBeforeChangeHookArgs as bh, type FieldHook as bi, type FieldHooks as bj, type FieldType as bk, type FileData as bl, type GlobalAfterChangeHook as bm, type GlobalAfterReadHook as bn, type GlobalAfterReadHookEntry as bo, type GlobalBeforeChangeHook as bp, type GlobalBeforeChangeHookEntry as bq, type GlobalBeforeReadHook as br, type GlobalBeforeReadHookEntry as bs, type HeadingLevel as bt, type HookFunction as bu, type IconFieldAdmin as bv, type ImageService as bw, type InferAggregateResult as bx, type JoinFieldAdmin as by, type JsonFieldAdmin as bz, type WorkflowTransition as c, type TypedField as c0, type UploadConfig as c1, type UrlFieldAdmin as c2, type UrlLinkValue as c3, type ViewActionFeatures as c4, type ViewComponentSlots as c5, type ViewConfig as c6, type ViewLayout as c7, type ViewMetric as c8, type ViewSubMetric as c9, type WhereClause as ca, type WhereOperator as cb, type WhereOperatorName as cc, type WordLimitFieldAdmin as cd, type WordLimitFieldConfig as ce, type WorkflowMetadata as cf, type WorkflowRole as cg, type WorkflowState as ch, type WorkflowTransitionContext as ci, defineAction as cj, defineView as ck, parseMongoWhere as cl, parseSqlWhere as cm, type LifecycleEvent as d, type BaseDocument as e, type DetailComputedOptions as f, type ComputedHandler as g, type DetailComputed as h, type DetailCustomOptions as i, type DetailCustom as j, type DetailDividerOptions as k, type DetailDivider as l, type DisplayFieldOptions as m, type DetailField as n, type DetailItem as o, type DetailGridOptions as p, type DetailGrid as q, type DetailRepeatOptions as r, type DetailRepeat as s, type DetailSectionOptions as t, type DetailSection as u, type DetailTabOptions as v, type DetailTab as w, type DetailTabsOptions as x, type DetailTabs as y, type DetailTextOptions as z };