@dyrected/core 2.22.0 → 2.24.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as Field, B as Block, C as CollectionConfig, D as DyrectedConfig, A as AdminAuthConfig, P as PublicAdminAuthConfig, G as GlobalConfig, a as DeclarativeHookExpression, W as WorkflowConfig, b as AuthenticatedUser, c as WorkflowTransition, L as LifecycleEventName, d as LifecycleEvent, e as DatabaseAdapter, f as BaseDocument, H as HookRequestContext, T as TaskRunResult, g as TaskConfig, h as DetailActionOptions, i as DetailAction, j as DetailComputedOptions, k as ComputedHandler, l as DetailComputed, m as DetailCustomOptions, n as DetailCustom, o as DetailDividerOptions, p as DetailDivider, q as DisplayFieldOptions, r as DetailField, s as DetailItem, t as DetailGridOptions, u as DetailGrid, v as DetailRepeatOptions, w as DetailRepeat, x as DetailSectionOptions, y as DetailSection, z as DetailTabOptions, E as DetailTab, I as DetailTabsOptions, J as DetailTabs, K as DetailTextOptions, M as DetailText, N as DetailSchema, O as DyrectedContext, Q as AIConfig, R as AIPIIConfig, S as IdStrategy, U as CompiledNavTree, V as CompiledNavItem, X as UserNavigationPreferences, Y as DefineWorkspaceOptions, Z as ViewConfig, _ as DateTimeField, $ as RelationshipField, a0 as SelectField, a1 as ArrayField, a2 as FieldType, a3 as BooleanField, a4 as AuthConfig, a5 as AccessPolicyResolver, a6 as DateField, a7 as TextField, a8 as EmailField, a9 as IconField, aa as ImageField, ab as JoinField, ac as JsonField, ad as MoneyField, ae as MultiSelectField, af as NumberField, ag as ObjectField, ah as RadioField, ai as RichTextField, aj as RowField, ak as TextareaField, al as TimeField, am as UrlField } from './app-BBHBP-6V.js';
-export { an as AIAction, ao as AIActionStatus, ap as AIActionType, aq as AIAuditActionType, ar as AIAuditRecord, as as AIChunk, at as AIMessage, au as AIPIIPattern, av as AIRateLimitResult, aw as AIRateLimitStore, ax as AIThread, ay as AIToolContext, az as AIToolDefinition, aA as AI_ACTIONS_COLLECTION, aB as AI_AUDIT_COLLECTION, aC as AI_CHUNKS_COLLECTION, aD as AI_MESSAGES_COLLECTION, aE as AI_THREADS_COLLECTION, aF as AccessConfig, aG as AccessFunction, aH as AccessFunctionArgs, aI as AccessResult, aJ as AccessRule, aK as ActionConfig, aL as ActionConfigBase, aM as ActionConfigWithHandler, aN as ActionConfigWithMutation, aO as ActionContext, aP as ActionType, aQ as AdminAuthAccessResolution, aR as AdminAuthClaimMapping, aS as AdminAuthMember, aT as AdminAuthProvider, aU as AdminAuthProviderMembersConfig, aV as AdminAuthProvisioningMode, aW as AdminAuthResolveAccessArgs, aX as AdminAuthResolvedIdentity, aY as AdminConfig, aZ as AdminDashboardComponentSlots, a_ as AdminIconName, a$ as AggregateArgs, b0 as AggregateCastType, b1 as AggregateCollectionResult, b2 as AggregateInput, b3 as AggregateOperation, b4 as AggregateResult, b5 as AppTrashConfig, b6 as BaseAdminAuthProvider, b7 as BaseFieldAdmin, b8 as BlockVariant, b9 as BlocksField, ba as BooleanFieldAdmin, bb as BooleanFormat, bc as CURRENT_NAV_PREFERENCES_VERSION, bd as CalendarViewConfig, be as CardsViewConfig, bf as CharacterLimitFieldAdmin, bg as CharacterLimitFieldConfig, bh as CollectionAfterChangeHook, bi as CollectionAfterDeleteHook, bj as CollectionAfterReadHook, bk as CollectionAfterReadHookEntry, bl as CollectionAfterRestoreHook, bm as CollectionAfterTransitionHook, bn as CollectionAfterTrashHook, bo as CollectionBeforeChangeHook, bp as CollectionBeforeChangeHookEntry, bq as CollectionBeforeCommitHook, br as CollectionBeforeDeleteHook, bs as CollectionBeforeReadHook, bt as CollectionBeforeReadHookEntry, bu as CollectionBeforeRestoreHook, bv as CollectionBeforeTransitionHook, bw as CollectionBeforeTrashHook, bx as CollectionEmailConfig, by as CollectionIndex, bz as CollectionListComponentSlots, bA as CollectionRAGConfig, bB as CollectionSchemaResult, bC as CollectionSummaryResult, bD as CollectionViewComponentSlots, bE as CompiledNavGroup, bF as CountOperation, bG as CustomAdminAuthProvider, bH as DEFAULT_USER_NAV_PREFERENCES, bI as DateFieldAdmin, bJ as DateFormat, bK as DefaultValueContext, bL as DefineActionOptions, bM as DefineCalendarViewOptions, bN as DefineCardsViewOptions, bO as DefineGanttViewOptions, bP as DefineKanbanViewOptions, bQ as DefineTableViewOptions, bR as DefineViewBaseOptions, bS as DefineViewOptions, bT as DetailSpan, bU as DisplayTone, bV as DisplayVariant, bW as DistinctCountOperation, bX as DistinctValuesOperation, bY as DynamicOptionItem, bZ as DynamicOptionsConfig, b_ as DynamicOptionsResolver, b$ as DynamicOptionsResolverArgs, c0 as DyrectedAIContext, c1 as DyrectedLoggerConfig, c2 as DyrectedObservabilityConfig, c3 as EmailFieldAdmin, c4 as EmailTemplateArgs, c5 as EmailTemplateResult, c6 as FieldAdminHooks, c7 as FieldAdminOnChangeHook, c8 as FieldAdminOnChangeHookArgs, c9 as FieldAdminOptionsHook, ca as FieldAdminOptionsHookArgs, cb as FieldAdminOptionsHookResult, cc as FieldAfterReadHook, cd as FieldAfterReadHookArgs, ce as FieldBase, cf as FieldBeforeChangeHook, cg as FieldBeforeChangeHookArgs, ch as FieldHook, ci as FieldHooks, cj as FileData, ck as GanttViewConfig, cl as GetDocumentResult, cm as GlobalAfterChangeHook, cn as GlobalAfterReadHook, co as GlobalAfterReadHookEntry, cp as GlobalBeforeChangeHook, cq as GlobalBeforeChangeHookEntry, cr as GlobalBeforeReadHook, cs as GlobalBeforeReadHookEntry, ct as GlobalRAGConfig, cu as GlobalSchemaResult, cv as GlobalSummaryResult, cw as HeadingLevel, cx as HookFunction, cy as IconFieldAdmin, cz as ImageService, cA as ImageTransformOptions, cB as InferAggregateResult, cC as JoinFieldAdmin, cD as JsonFieldAdmin, cE as JsonFormat, cF as KanbanViewConfig, cG as LIFECYCLE_EVENT_NAMES, cH as LifecycleEventHandler, cI as LinkFormat, cJ as MetricColor, cK as MoneyFieldAdmin, cL as MoneyFieldConfig, cM as MultiSelectFieldAdmin, cN as NamedAccessPolicy, cO as NavBadgeConfig, cP as NavGroup, cQ as NumberFieldAdmin, cR as NumberFormat, cS as NumberLimitFieldAdmin, cT as NumberLimitFieldConfig, cU as NumericOperation, cV as NumericUpdateOperator, cW as OIDCAdminAuthProvider, cX as OptionFormat, cY as OutboundEmail, cZ as PaginatedResult, c_ as PinnedNavItemRef, c$ as PublicAdminAuthProvider, d0 as QueryCollectionResult, d1 as RAGSearchResult, d2 as RadioFieldAdmin, d3 as RateLimitConfig, d4 as ReadonlyDatabaseAdapter, d5 as RichTextFeature, d6 as RichTextFieldConfig, d7 as SelectFieldAdmin, d8 as SqlWhereResult, d9 as StorageAdapter, da as TableViewConfig, db as TaskContext, dc as TaskLogger, dd as TaskRunStatus, de as TextFieldAdmin, df as TextFormat, dg as TextareaFieldAdmin, dh as TrashConfig, di as TrustProxyConfig, dj as TypedField, dk as UploadConfig, dl as UrlFieldAdmin, dm as UrlLinkValue, dn as ViewActionFeatures, dp as ViewComponentSlots, dq as ViewConfigBase, dr as ViewLayout, ds as ViewMetric, dt as ViewMetricGroupBy, du as ViewMetricGroupByConfig, dv as ViewMetricTrendConfig, dw as ViewSubMetric, dx as WhereClause, dy as WhereOperator, dz as WhereOperatorName, dA as WordLimitFieldAdmin, dB as WordLimitFieldConfig, dC as WorkflowMetadata, dD as WorkflowOnTransitionContext, dE as WorkflowOnTransitionHook, dF as WorkflowRole, dG as WorkflowState, dH as WorkflowTransitionContext, dI as coerceBooleanWhere, dJ as defineAction, dK as defineCalendarView, dL as defineCardsView, dM as defineGanttView, dN as defineKanbanView, dO as defineTableView, dP as defineView, dQ as defineWorkspace, dR as isAICollection, dS as parseMongoWhere, dT as parseSqlWhere } from './app-BBHBP-6V.js';
+import { F as Field, B as Block, C as CollectionConfig, D as DyrectedConfig, A as AdminAuthConfig, P as PublicAdminAuthConfig, G as GlobalConfig, a as DeclarativeHookExpression, W as WorkflowConfig, b as AuthenticatedUser, c as WorkflowTransition, L as LifecycleEventName, d as LifecycleEvent, e as DatabaseAdapter, f as BaseDocument, H as HookRequestContext, T as TaskRunResult, g as TaskConfig, h as DetailActionOptions, i as DetailAction, j as DetailComputedOptions, k as ComputedHandler, l as DetailComputed, m as DetailCustomOptions, n as DetailCustom, o as DetailDividerOptions, p as DetailDivider, q as DisplayFieldOptions, r as DetailField, s as DetailItem, t as DetailGridOptions, u as DetailGrid, v as DetailRepeatOptions, w as DetailRepeat, x as DetailSectionOptions, y as DetailSection, z as DetailTabOptions, E as DetailTab, I as DetailTabsOptions, J as DetailTabs, K as DetailTextOptions, M as DetailText, N as DetailSchema, O as DyrectedContext, Q as AIConfig, R as AIPIIConfig, S as IdStrategy, U as CompiledNavTree, V as CompiledNavItem, X as UserNavigationPreferences, Y as DefineWorkspaceOptions, Z as ViewConfig, _ as DateTimeField, $ as RelationshipField, a0 as SelectField, a1 as ArrayField, a2 as FieldType, a3 as BooleanField, a4 as AuthConfig, a5 as AccessPolicyResolver, a6 as DateField, a7 as TextField, a8 as EmailField, a9 as IconField, aa as ImageField, ab as JoinField, ac as JsonField, ad as MoneyField, ae as MultiSelectField, af as NumberField, ag as ObjectField, ah as RadioField, ai as RichTextField, aj as RowField, ak as TextareaField, al as TimeField, am as UrlField } from './app-BpQPL2hY.js';
+export { an as AIAction, ao as AIActionStatus, ap as AIActionType, aq as AIAuditActionType, ar as AIAuditRecord, as as AIChunk, at as AIMessage, au as AIPIIPattern, av as AIRateLimitResult, aw as AIRateLimitStore, ax as AIThread, ay as AIToolContext, az as AIToolDefinition, aA as AI_ACTIONS_COLLECTION, aB as AI_AUDIT_COLLECTION, aC as AI_CHUNKS_COLLECTION, aD as AI_MESSAGES_COLLECTION, aE as AI_THREADS_COLLECTION, aF as AccessConfig, aG as AccessFunction, aH as AccessFunctionArgs, aI as AccessResult, aJ as AccessRule, aK as ActionConfig, aL as ActionConfigBase, aM as ActionConfigWithHandler, aN as ActionConfigWithMutation, aO as ActionContext, aP as ActionType, aQ as AdminAuthAccessResolution, aR as AdminAuthClaimMapping, aS as AdminAuthMember, aT as AdminAuthProvider, aU as AdminAuthProviderMembersConfig, aV as AdminAuthProvisioningMode, aW as AdminAuthResolveAccessArgs, aX as AdminAuthResolvedIdentity, aY as AdminConfig, aZ as AdminDashboardComponentSlots, a_ as AdminIconName, a$ as AggregateArgs, b0 as AggregateCastType, b1 as AggregateCollectionResult, b2 as AggregateInput, b3 as AggregateOperation, b4 as AggregateResult, b5 as AppTrashConfig, b6 as BaseAdminAuthProvider, b7 as BaseFieldAdmin, b8 as BlockVariant, b9 as BlocksField, ba as BooleanFieldAdmin, bb as BooleanFormat, bc as CURRENT_NAV_PREFERENCES_VERSION, bd as CUSTOM_VIEW_FETCH_ALL_LIMIT, be as CalendarViewConfig, bf as CardsViewConfig, bg as CharacterLimitFieldAdmin, bh as CharacterLimitFieldConfig, bi as CollectionAfterChangeHook, bj as CollectionAfterDeleteHook, bk as CollectionAfterReadHook, bl as CollectionAfterReadHookEntry, bm as CollectionAfterRestoreHook, bn as CollectionAfterTransitionHook, bo as CollectionAfterTrashHook, bp as CollectionBeforeChangeHook, bq as CollectionBeforeChangeHookEntry, br as CollectionBeforeCommitHook, bs as CollectionBeforeDeleteHook, bt as CollectionBeforeReadHook, bu as CollectionBeforeReadHookEntry, bv as CollectionBeforeRestoreHook, bw as CollectionBeforeTransitionHook, bx as CollectionBeforeTrashHook, by as CollectionEmailConfig, bz as CollectionIndex, bA as CollectionListComponentSlots, bB as CollectionRAGConfig, bC as CollectionSchemaResult, bD as CollectionSummaryResult, bE as CollectionViewComponentSlots, bF as CompiledNavGroup, bG as CountOperation, bH as CustomAdminAuthProvider, bI as CustomViewConfig, bJ as CustomViewDataConfig, bK as DEFAULT_USER_NAV_PREFERENCES, bL as DateFieldAdmin, bM as DateFormat, bN as DefaultValueContext, bO as DefineActionOptions, bP as DefineCalendarViewOptions, bQ as DefineCardsViewOptions, bR as DefineCustomViewOptions, bS as DefineGanttViewOptions, bT as DefineKanbanViewOptions, bU as DefinePageInput, bV as DefineTableViewOptions, bW as DefineViewBaseOptions, bX as DefineViewOptions, bY as DetailSpan, bZ as DisplayTone, b_ as DisplayVariant, b$ as DistinctCountOperation, c0 as DistinctValuesOperation, c1 as DocumentFormComponentSlots, c2 as DynamicOptionItem, c3 as DynamicOptionsConfig, c4 as DynamicOptionsResolver, c5 as DynamicOptionsResolverArgs, c6 as DyrectedAIContext, c7 as DyrectedLoggerConfig, c8 as DyrectedObservabilityConfig, c9 as EmailFieldAdmin, ca as EmailTemplateArgs, cb as EmailTemplateResult, cc as FORM_SHELLS, cd as FieldAdminHooks, ce as FieldAdminOnChangeHook, cf as FieldAdminOnChangeHookArgs, cg as FieldAdminOptionsHook, ch as FieldAdminOptionsHookArgs, ci as FieldAdminOptionsHookResult, cj as FieldAfterReadHook, ck as FieldAfterReadHookArgs, cl as FieldBase, cm as FieldBeforeChangeHook, cn as FieldBeforeChangeHookArgs, co as FieldHook, cp as FieldHooks, cq as FileData, cr as FormShell, cs as GanttViewConfig, ct as GetDocumentResult, cu as GlobalAfterChangeHook, cv as GlobalAfterReadHook, cw as GlobalAfterReadHookEntry, cx as GlobalBeforeChangeHook, cy as GlobalBeforeChangeHookEntry, cz as GlobalBeforeReadHook, cA as GlobalBeforeReadHookEntry, cB as GlobalFormComponentSlots, cC as GlobalRAGConfig, cD as GlobalSchemaResult, cE as GlobalSummaryResult, cF as HeadingLevel, cG as HookFunction, cH as IconFieldAdmin, cI as ImageService, cJ as ImageTransformOptions, cK as InferAggregateResult, cL as JoinFieldAdmin, cM as JsonFieldAdmin, cN as JsonFormat, cO as KanbanViewConfig, cP as LIFECYCLE_EVENT_NAMES, cQ as LifecycleEventHandler, cR as LinkFormat, cS as MetricColor, cT as MoneyFieldAdmin, cU as MoneyFieldConfig, cV as MultiSelectFieldAdmin, cW as NamedAccessPolicy, cX as NavBadgeConfig, cY as NavGroup, cZ as NumberFieldAdmin, c_ as NumberFormat, c$ as NumberLimitFieldAdmin, d0 as NumberLimitFieldConfig, d1 as NumericOperation, d2 as NumericUpdateOperator, d3 as OIDCAdminAuthProvider, d4 as OptionFormat, d5 as OutboundEmail, d6 as PageAction, d7 as PageBreadcrumbItem, d8 as PageConfig, d9 as PaginatedResult, da as PinnedNavItemRef, db as PublicAdminAuthProvider, dc as QueryCollectionResult, dd as RAGSearchResult, de as RadioFieldAdmin, df as RateLimitConfig, dg as ReadonlyDatabaseAdapter, dh as RichTextFeature, di as RichTextFieldConfig, dj as SelectFieldAdmin, dk as SqlWhereResult, dl as StorageAdapter, dm as TableViewConfig, dn as TaskContext, dp as TaskLogger, dq as TaskRunStatus, dr as TextFieldAdmin, ds as TextFormat, dt as TextareaFieldAdmin, du as TrashConfig, dv as TrustProxyConfig, dw as TypedField, dx as UploadConfig, dy as UrlFieldAdmin, dz as UrlLinkValue, dA as ViewActionFeatures, dB as ViewComponentSlots, dC as ViewConfigBase, dD as ViewLayout, dE as ViewMetric, dF as ViewMetricGroupBy, dG as ViewMetricGroupByConfig, dH as ViewMetricTrendConfig, dI as ViewSubMetric, dJ as WhereClause, dK as WhereOperator, dL as WhereOperatorName, dM as WordLimitFieldAdmin, dN as WordLimitFieldConfig, dO as WorkflowMetadata, dP as WorkflowOnTransitionContext, dQ as WorkflowOnTransitionHook, dR as WorkflowRole, dS as WorkflowState, dT as WorkflowTransitionContext, dU as coerceBooleanWhere, dV as defineAction, dW as defineCalendarView, dX as defineCardsView, dY as defineCustomView, dZ as defineGanttView, d_ as defineKanbanView, d$ as definePage, e0 as defineTableView, e1 as defineView, e2 as defineWorkspace, e3 as isAICollection, e4 as parseMongoWhere, e5 as parseSqlWhere } from './app-BpQPL2hY.js';
 import jexl from 'jexl';
 import { Context } from 'hono';
 export { z } from 'zod';
@@ -280,7 +280,7 @@ interface DeclarativePreviewValidationIssue {
 }
 interface ConfigDiagnostic {
     severity: "error" | "warning";
-    source: "declarativeHook" | "declarativeAccess" | "adminCondition" | "previewUrl";
+    source: "declarativeHook" | "declarativeAccess" | "adminCondition" | "previewUrl" | "adminComponents";
     path: string;
     surface: string;
     message: string;
@@ -292,7 +292,7 @@ type DiagnosticFormatOptions = {
 type DeclarativeValidationConfig = {
     blocks?: Array<Pick<Block, "fields"> & Partial<Pick<Block, "slug">>>;
     collections: Array<Pick<CollectionConfig, "fields" | "hooks" | "access" | "admin"> & Partial<Pick<CollectionConfig, "slug">>>;
-    globals?: Array<Pick<GlobalConfig, "fields" | "hooks" | "access"> & Partial<Pick<GlobalConfig, "slug">>>;
+    globals?: Array<Pick<GlobalConfig, "fields" | "hooks" | "access" | "admin"> & Partial<Pick<GlobalConfig, "slug">>>;
     accessPolicies?: Record<string, unknown>;
 };
 declare function validateDeclarativeHookExpression(expression: string, surface: DeclarativeHookSurface, path: string): DeclarativeHookValidationIssue[];
@@ -305,6 +305,14 @@ declare function collectDeclarativeHookValidationIssues(config: DeclarativeValid
 declare function collectDeclarativeAccessValidationIssues(config: DeclarativeValidationConfig): DeclarativeAccessValidationIssue[];
 declare function collectAdminConditionValidationIssues(config: DeclarativeValidationConfig): DeclarativeAdminValidationIssue[];
 declare function collectPreviewUrlValidationIssues(config: DeclarativeValidationConfig): DeclarativePreviewValidationIssue[];
+interface AdminComponentsValidationIssue {
+    path: string;
+    surface: "collection.admin.components" | "global.admin.components";
+    message: string;
+    expression: string;
+}
+/** Flags malformed `createForm`, `editForm`, `form` and `formShell` settings. */
+declare function collectAdminComponentsValidationIssues(config: DeclarativeValidationConfig): AdminComponentsValidationIssue[];
 declare function assertValidAdminConditionsInConfig(config: DeclarativeValidationConfig, source?: string): void;
 declare function assertValidPreviewUrlsInConfig(config: DeclarativeValidationConfig, source?: string): void;
 declare function collectConfigDiagnostics(config: DeclarativeValidationConfig): ConfigDiagnostic[];
@@ -318,6 +326,38 @@ declare function isConfigValidationError(error: unknown): error is ConfigValidat
 declare function assertValidDeclarativeHooksInConfig(config: DeclarativeValidationConfig, source?: string): void;
 declare function assertValidDeclarativeAccessInConfig(config: DeclarativeValidationConfig, source?: string): void;
 
+/**
+ * Component keys a schema references, grouped by the `AdminComponents`
+ * registry that must supply them.
+ *
+ * Registration happens in the host app's admin bundle, so this scan is the
+ * single source of truth for both type generation (CLI) and the admin's
+ * unused-registration warning.
+ */
+interface ReferencedComponentKeys {
+    /** `field.admin.component` keys, resolved against `components.fields`. */
+    fields: Set<string>;
+    /** `admin.components.before/afterDashboard` keys. */
+    dashboard: Set<string>;
+    /** `collection.admin.components` list slots. */
+    collectionList: Set<string>;
+    /** Operational view slots (`collectionView` and per-view `components`). */
+    collectionView: Set<string>;
+    /** `createForm`, `editForm` and `form` keys on collections, and `editForm`/`form` on globals. */
+    forms: Set<string>;
+    /** `component` of views with `layout: "custom"`. */
+    viewLayouts: Set<string>;
+    /** `admin.pages[].component` keys. */
+    pages: Set<string>;
+    /** `displayCustom(name)` keys used in Detail View layouts. */
+    customComponents: Set<string>;
+}
+/**
+ * Collects every component key a schema (or a `DyrectedConfig`) references.
+ * Tolerant of partial or unknown shapes: anything unrecognised is skipped.
+ */
+declare function collectReferencedComponentKeys(schema: unknown): ReferencedComponentKeys;
+
 /**
  * Transforms a string into a clean, URL-safe slug.
  * Strips accents, lowercases, removes non-alphanumeric characters, and hyphens whitespace.
@@ -1522,7 +1562,7 @@ declare function reconcileNavigation(baseTree: CompiledNavTree | null | undefine
  */
 declare const RESERVED_NAVIGATION_SLUGS: Set<string>;
 /**
- * Validates that no navigation item uses a reserved system route slug.
+ * Validates that no navigation item uses a reserved system route slug or duplicate slug.
  */
 declare function assertValidNavigationSlugs(navigation: DefineWorkspaceOptions[]): void;
 /**
@@ -2340,4 +2380,4 @@ declare function defineTab<const T extends readonly Field[]>(args: {
     fields: T;
 }): T;
 
-export { AIConfig, type AIErrorCode, AIPIIConfig, type AccessConditions, AccessPolicyResolver, AdminAuthConfig, ArrayField, AuthConfig, type AuthDocFields, AuthenticatedUser, BASE62_ALPHABET, BUILTIN_JEXL_HELPERS, BaseDocument, Block, BooleanField, CROCKFORD_BASE32, CollectionConfig, CompiledNavItem, CompiledNavTree, ComputedHandler, type ConfigDiagnostic, ConfigValidationError, ConflictError, type CreatedAtFieldOptions, type CreatedByFieldOptions, DatabaseAdapter, DateField, DateTimeField, type DeclarativeAccessSurface, type DeclarativeAccessValidationIssue, type DeclarativeAdminSurface, type DeclarativeAdminValidationIssue, DeclarativeHookExpression, type DeclarativeHookSurface, type DeclarativeHookValidationIssue, type DeclarativePreviewSurface, type DeclarativePreviewValidationIssue, DefineWorkspaceOptions, DetailAction, DetailActionOptions, DetailComputed, DetailComputedOptions, DetailCustom, DetailCustomOptions, DetailDivider, DetailDividerOptions, DetailField, DetailGrid, DetailGridOptions, DetailItem, DetailRepeat, DetailRepeatOptions, DetailSchema, DetailSection, DetailSectionOptions, DetailTab, DetailTabOptions, DetailTabs, DetailTabsOptions, DetailText, DetailTextOptions, DisplayFieldOptions, DuplicateKeyError, DyrectedAIError, DyrectedConfig, DyrectedError, EMAIL_TEMPLATES_COLLECTION_CONFIG, EMAIL_TEMPLATES_COLLECTION_SLUG, EmailField, type ExprFunction, type ExtractCollectionSlugs, Field, FieldConditionBuilder, FieldType, ForbiddenError, type GenerateIdOptions, GlobalConfig, HookRequestContext, INTERNAL_SYSTEM_COLLECTIONS, IconField, IdStrategy, ImageField, type InferDocShape, JoinField, JsonField, LIFECYCLE_EVENTS_COLLECTION, type LayoutOptions, LifecycleEvent, LifecycleEventName, MatchBuilder, MoneyField, MultiSelectField, NANOID_ALPHABET, NON_NEGOTIABLE_CREDENTIAL_FIELDS, NotFoundError, NumberField, ObjectField, PII_REGEX_PATTERNS, type Prettify, PublicAdminAuthConfig, type PublishingWorkflowOptions, RESERVED_NAVIGATION_SLUGS, RadioField, type ReconcileNavigationOptions, type ReconciledNavTree, RelationshipField, type ResolvedTrashConfig, type RestoreDocumentOptions, RichTextField, type RoleOption, type RolesFieldOptions, RowField, type SanitizeDocForAIOptions, SelectField, type SoftDeleteOptions, type SortClause, type SortDirection, type SqlSortDialect, type SystemDocFields, TASK_LOCKS_COLLECTION, TASK_LOCKS_COLLECTION_CONFIG, TRASH_COLLECTION, TRASH_COLLECTION_CONFIG, TaskConfig, TaskRunResult, type TaskRunner, type TemplateBlock, TextField, TextareaField, TimeField, UNASSIGNED_GROUP_KEY, type UpdatedAtFieldOptions, type UpdatedByFieldOptions, type UploadDocFields, UrlField, UserNavigationPreferences, ValidationError, ViewConfig, WORKFLOW_HISTORY_COLLECTION, type WhenFunction, WorkflowConfig, WorkflowTransition, abs, addDays, alertBox, asCollection, assertValidAdminConditionsInConfig, assertValidDeclarativeAccessInConfig, assertValidDeclarativeHookExpression, assertValidDeclarativeHookResult, assertValidDeclarativeHooksInConfig, assertValidNavigationSlugs, assertValidPreviewUrlsInConfig, assertValidTrashInConfig, availableWorkflowTransitions, buildSqlOrderBy, canViewWorkflowDraft, capitalize, ceil, clamp, coalesce, collectAdminConditionValidationIssues, collectConfigDiagnostics, collectDeclarativeAccessValidationIssues, collectDeclarativeHookValidationIssues, collectPreviewUrlValidationIssues, compact, compileNavigation, count, createLifecycleEvent, createTaskRunner, createTrashPurgeTask, createWorkflowDocument, ctaButton, defaultValue, defineArrayField, defineBlock, defineBlocksField, defineBooleanField, defineCollection, defineConfig, defineCreatedAtField, defineCreatedByField, defineDateField, defineDateTimeField, defineEmailField, defineField, defineGlobal, defineIconField, defineImageField, defineJoinField, defineJsonField, defineMoneyField, defineMultiSelectField, defineNumberField, defineObjectField, definePublishingWorkflow, defineRadioField, defineRelationshipField, defineRichTextField, defineRoles, defineRolesField, defineRowField, defineSelectField, defineTab, defineTask, defineTextField, defineTextareaField, defineTimeField, defineUpdatedAtField, defineUpdatedByField, defineUrlField, detailBox, diffDays, dispatchLifecycleEvent, dispatchPendingLifecycleEvents, displayAction, displayComputed, displayCustom, displayCustomComponent, displayDivider, displayField, displayGrid, displayRepeat, displaySection, displayTab, displayTabs, displayText, divider, emailTokens, endsWith, escapeHtml, evaluateDetailComputed, evaluateJexl, evaluateJexlSync, eventList, executeFieldAfterRead, executeFieldBeforeChange, expr, first, floor, formatConfigDiagnostics, formatDate, formatJexlValue, generateDefaultDetailSchema, generateDocumentId, generateId, generateOpenApi, get, getAdminAuthCollection, getAdminRoleForCollection, getAllowedSitesForUser, getDefaultEmailTemplate, getPublicAdminAuthConfig, getTrashEntryId, heading, includes, initializeWorkflowDocument, isConfigValidationError, isDetailItemVisible, isEmpty, isFuture, isPast, isSiteAuthorized, isUserAdmin, join, last, layout, length, lower, maskEmail, maskPhone, maskTextPII, materializeWorkflowDocument, max, min, nanoid, nextCronRun, normalizeConfig, normalizeDetailItem, normalizeGroupKey, now, numericFieldNames, paragraph, parseCron, parseSort, pow, prefixedId, pruneNavigationForUser, publishedStateName, publishingWorkflow, readingTime, reconcileNavigation, registerJexlHelpers, replace, resolveAdminAuthCollection, resolveAllCollectionViews, resolveAuthorizedSiteId, resolveBlocks, resolveDocumentTitle, resolveIndexName, resolvePrefix, resolveTrashConfig, restoreDocument, round, row, runCollectionHooks, safeLinkDetailBox, sanitizeDocForAI, saveWorkflowDraft, sectionLabel, simplePublishingWorkflow, slugify, softDeleteDocument, spacer, sqrt, startsWith, sum, table, today, transitionWorkflow, trim, truncate, ulid, unique, upper, uuid, validateAdminConditionExpression, validateDeclarativeAccessExpression, validateDeclarativeHookExpression, validatePreviewUrlExpression, when, wordCount, workflowCapabilities };
+export { AIConfig, type AIErrorCode, AIPIIConfig, type AccessConditions, AccessPolicyResolver, AdminAuthConfig, type AdminComponentsValidationIssue, ArrayField, AuthConfig, type AuthDocFields, AuthenticatedUser, BASE62_ALPHABET, BUILTIN_JEXL_HELPERS, BaseDocument, Block, BooleanField, CROCKFORD_BASE32, CollectionConfig, CompiledNavItem, CompiledNavTree, ComputedHandler, type ConfigDiagnostic, ConfigValidationError, ConflictError, type CreatedAtFieldOptions, type CreatedByFieldOptions, DatabaseAdapter, DateField, DateTimeField, type DeclarativeAccessSurface, type DeclarativeAccessValidationIssue, type DeclarativeAdminSurface, type DeclarativeAdminValidationIssue, DeclarativeHookExpression, type DeclarativeHookSurface, type DeclarativeHookValidationIssue, type DeclarativePreviewSurface, type DeclarativePreviewValidationIssue, DefineWorkspaceOptions, DetailAction, DetailActionOptions, DetailComputed, DetailComputedOptions, DetailCustom, DetailCustomOptions, DetailDivider, DetailDividerOptions, DetailField, DetailGrid, DetailGridOptions, DetailItem, DetailRepeat, DetailRepeatOptions, DetailSchema, DetailSection, DetailSectionOptions, DetailTab, DetailTabOptions, DetailTabs, DetailTabsOptions, DetailText, DetailTextOptions, DisplayFieldOptions, DuplicateKeyError, DyrectedAIError, DyrectedConfig, DyrectedError, EMAIL_TEMPLATES_COLLECTION_CONFIG, EMAIL_TEMPLATES_COLLECTION_SLUG, EmailField, type ExprFunction, type ExtractCollectionSlugs, Field, FieldConditionBuilder, FieldType, ForbiddenError, type GenerateIdOptions, GlobalConfig, HookRequestContext, INTERNAL_SYSTEM_COLLECTIONS, IconField, IdStrategy, ImageField, type InferDocShape, JoinField, JsonField, LIFECYCLE_EVENTS_COLLECTION, type LayoutOptions, LifecycleEvent, LifecycleEventName, MatchBuilder, MoneyField, MultiSelectField, NANOID_ALPHABET, NON_NEGOTIABLE_CREDENTIAL_FIELDS, NotFoundError, NumberField, ObjectField, PII_REGEX_PATTERNS, type Prettify, PublicAdminAuthConfig, type PublishingWorkflowOptions, RESERVED_NAVIGATION_SLUGS, RadioField, type ReconcileNavigationOptions, type ReconciledNavTree, type ReferencedComponentKeys, RelationshipField, type ResolvedTrashConfig, type RestoreDocumentOptions, RichTextField, type RoleOption, type RolesFieldOptions, RowField, type SanitizeDocForAIOptions, SelectField, type SoftDeleteOptions, type SortClause, type SortDirection, type SqlSortDialect, type SystemDocFields, TASK_LOCKS_COLLECTION, TASK_LOCKS_COLLECTION_CONFIG, TRASH_COLLECTION, TRASH_COLLECTION_CONFIG, TaskConfig, TaskRunResult, type TaskRunner, type TemplateBlock, TextField, TextareaField, TimeField, UNASSIGNED_GROUP_KEY, type UpdatedAtFieldOptions, type UpdatedByFieldOptions, type UploadDocFields, UrlField, UserNavigationPreferences, ValidationError, ViewConfig, WORKFLOW_HISTORY_COLLECTION, type WhenFunction, WorkflowConfig, WorkflowTransition, abs, addDays, alertBox, asCollection, assertValidAdminConditionsInConfig, assertValidDeclarativeAccessInConfig, assertValidDeclarativeHookExpression, assertValidDeclarativeHookResult, assertValidDeclarativeHooksInConfig, assertValidNavigationSlugs, assertValidPreviewUrlsInConfig, assertValidTrashInConfig, availableWorkflowTransitions, buildSqlOrderBy, canViewWorkflowDraft, capitalize, ceil, clamp, coalesce, collectAdminComponentsValidationIssues, collectAdminConditionValidationIssues, collectConfigDiagnostics, collectDeclarativeAccessValidationIssues, collectDeclarativeHookValidationIssues, collectPreviewUrlValidationIssues, collectReferencedComponentKeys, compact, compileNavigation, count, createLifecycleEvent, createTaskRunner, createTrashPurgeTask, createWorkflowDocument, ctaButton, defaultValue, defineArrayField, defineBlock, defineBlocksField, defineBooleanField, defineCollection, defineConfig, defineCreatedAtField, defineCreatedByField, defineDateField, defineDateTimeField, defineEmailField, defineField, defineGlobal, defineIconField, defineImageField, defineJoinField, defineJsonField, defineMoneyField, defineMultiSelectField, defineNumberField, defineObjectField, definePublishingWorkflow, defineRadioField, defineRelationshipField, defineRichTextField, defineRoles, defineRolesField, defineRowField, defineSelectField, defineTab, defineTask, defineTextField, defineTextareaField, defineTimeField, defineUpdatedAtField, defineUpdatedByField, defineUrlField, detailBox, diffDays, dispatchLifecycleEvent, dispatchPendingLifecycleEvents, displayAction, displayComputed, displayCustom, displayCustomComponent, displayDivider, displayField, displayGrid, displayRepeat, displaySection, displayTab, displayTabs, displayText, divider, emailTokens, endsWith, escapeHtml, evaluateDetailComputed, evaluateJexl, evaluateJexlSync, eventList, executeFieldAfterRead, executeFieldBeforeChange, expr, first, floor, formatConfigDiagnostics, formatDate, formatJexlValue, generateDefaultDetailSchema, generateDocumentId, generateId, generateOpenApi, get, getAdminAuthCollection, getAdminRoleForCollection, getAllowedSitesForUser, getDefaultEmailTemplate, getPublicAdminAuthConfig, getTrashEntryId, heading, includes, initializeWorkflowDocument, isConfigValidationError, isDetailItemVisible, isEmpty, isFuture, isPast, isSiteAuthorized, isUserAdmin, join, last, layout, length, lower, maskEmail, maskPhone, maskTextPII, materializeWorkflowDocument, max, min, nanoid, nextCronRun, normalizeConfig, normalizeDetailItem, normalizeGroupKey, now, numericFieldNames, paragraph, parseCron, parseSort, pow, prefixedId, pruneNavigationForUser, publishedStateName, publishingWorkflow, readingTime, reconcileNavigation, registerJexlHelpers, replace, resolveAdminAuthCollection, resolveAllCollectionViews, resolveAuthorizedSiteId, resolveBlocks, resolveDocumentTitle, resolveIndexName, resolvePrefix, resolveTrashConfig, restoreDocument, round, row, runCollectionHooks, safeLinkDetailBox, sanitizeDocForAI, saveWorkflowDraft, sectionLabel, simplePublishingWorkflow, slugify, softDeleteDocument, spacer, sqrt, startsWith, sum, table, today, transitionWorkflow, trim, truncate, ulid, unique, upper, uuid, validateAdminConditionExpression, validateDeclarativeAccessExpression, validateDeclarativeHookExpression, validatePreviewUrlExpression, when, wordCount, workflowCapabilities };

package/dist/index.js

@@ -1780,6 +1780,9 @@ function asCollection(config) {
   return config;
 }
 
+// src/types/admin.ts
+var FORM_SHELLS = ["full", "header", "none"];
+
 // src/types/workflows.ts
 var LIFECYCLE_EVENT_NAMES = [
   "revision.created",
@@ -1789,9 +1792,19 @@ var LIFECYCLE_EVENT_NAMES = [
 ];
 
 // src/types/views.ts
+var CUSTOM_VIEW_FETCH_ALL_LIMIT = 1e3;
 function defineView(config) {
+  assertCustomViewComponent(config);
   return config;
 }
+function assertCustomViewComponent(config) {
+  if (config.layout !== "custom") return;
+  if (typeof config.component !== "string" || config.component.trim() === "") {
+    throw new Error(
+      `View "${config.slug ?? "(unnamed)"}" uses layout: "custom" but has no \`component\`. Set \`component\` to a key registered in AdminComponents.viewLayouts.`
+    );
+  }
+}
 function defineTableView(config) {
   return config;
 }
@@ -1804,6 +1817,10 @@ function defineCalendarView(config) {
 function defineGanttView(config) {
   return config;
 }
+function defineCustomView(config) {
+  assertCustomViewComponent(config);
+  return config;
+}
 function defineCardsView(config) {
   return config;
 }
@@ -1860,6 +1877,23 @@ var DEFAULT_USER_NAV_PREFERENCES = {
   items: []
 };
 
+// src/types/pages.ts
+function definePage(config) {
+  return {
+    slug: config.slug,
+    label: config.label,
+    icon: config.icon,
+    group: config.group,
+    order: config.order,
+    after: config.after,
+    before: config.before,
+    position: config.position,
+    badge: config.badge,
+    access: config.access && typeof config.access === "object" && "read" in config.access ? config.access.read : config.access,
+    page: config
+  };
+}
+
 // src/auth/token.ts
 import { SignJWT, jwtVerify, decodeJwt } from "jose";
 
@@ -2699,6 +2733,54 @@ function collectPreviewUrlValidationIssues(config) {
   });
   return issues;
 }
+var FORM_COMPONENT_KEYS = ["createForm", "editForm", "form"];
+var GLOBAL_FORM_COMPONENT_KEYS = ["editForm", "form"];
+function collectFormComponentIssues(components, path, surface, keys, issues) {
+  if (!isPlainObject(components)) return;
+  for (const key of keys) {
+    const value = components[key];
+    if (value === void 0) continue;
+    if (typeof value !== "string" || value.length === 0) {
+      issues.push({
+        path: `${path}.admin.components.${key}`,
+        surface,
+        message: `\`${key}\` must be the registry key of a component, such as "check_ins.scanForm".`,
+        expression: String(value)
+      });
+    }
+  }
+  const shell = components.formShell;
+  if (shell !== void 0 && !FORM_SHELLS.includes(shell)) {
+    issues.push({
+      path: `${path}.admin.components.formShell`,
+      surface,
+      message: `Unknown formShell "${String(shell)}". Use ${FORM_SHELLS.map((value) => `"${value}"`).join(", ")}.`,
+      expression: String(shell)
+    });
+  }
+}
+function collectAdminComponentsValidationIssues(config) {
+  const issues = [];
+  config.collections.forEach((collection, index) => {
+    collectFormComponentIssues(
+      collection.admin?.components,
+      collectionSegment(collection, index),
+      "collection.admin.components",
+      FORM_COMPONENT_KEYS,
+      issues
+    );
+  });
+  config.globals?.forEach((global, index) => {
+    collectFormComponentIssues(
+      global.admin?.components,
+      globalSegment(global, index),
+      "global.admin.components",
+      GLOBAL_FORM_COMPONENT_KEYS,
+      issues
+    );
+  });
+  return issues;
+}
 function assertValidAdminConditionsInConfig(config, source = "config") {
   const diagnostics = collectAdminConditionValidationIssues(config).map((issue) => ({
     severity: "error",
@@ -2756,7 +2838,15 @@ function collectConfigDiagnostics(config) {
     message: issue.message,
     expression: issue.expression
   }));
-  return [...hookIssues, ...accessIssues, ...adminConditionIssues, ...previewUrlIssues];
+  const adminComponentIssues = collectAdminComponentsValidationIssues(config).map((issue) => ({
+    severity: "error",
+    source: "adminComponents",
+    path: issue.path,
+    surface: issue.surface,
+    message: issue.message,
+    expression: issue.expression
+  }));
+  return [...hookIssues, ...accessIssues, ...adminConditionIssues, ...previewUrlIssues, ...adminComponentIssues];
 }
 function formatConfigDiagnostics(source, diagnostics, options = {}) {
   const color = options.color ?? false;
@@ -5189,6 +5279,12 @@ var DuplicateKeyError = class _DuplicateKeyError extends ConflictError {
 function assertNever(op, context) {
   throw new Error(`[dyrected/core] Unhandled where operator "${op}" in ${context}`);
 }
+function escapeLike(value) {
+  return value.replace(/[!%_]/g, "!$&");
+}
+function escapeRegex(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function parseSqlWhere(where, getJsonField, placeholder = "?", likeOperator = placeholder === "pg" ? "ILIKE" : "LIKE") {
   const params = [];
   let pgIndex = 1;
@@ -5198,6 +5294,19 @@ function parseSqlWhere(where, getJsonField, placeholder = "?", likeOperator = pl
   function col(field) {
     return field === "id" ? "id" : getJsonField(field);
   }
+  function buildLike(column, pattern, escaped = false) {
+    const esc = escaped ? ` ESCAPE '!'` : "";
+    if (placeholder === "pg") {
+      params.push(pattern);
+      return `(${column})::text ${likeOperator} ${next()}${esc}`;
+    }
+    if (likeOperator === "ILIKE") {
+      params.push(pattern);
+      return `${column} ILIKE ${next()}${esc}`;
+    }
+    params.push(pattern.toLowerCase());
+    return `LOWER(${column}) LIKE ${next()}${esc}`;
+  }
   function buildOperator(field, value) {
     const c = col(field);
     const isJsonExtract = c.startsWith("data->>") || c.startsWith("json_extract(") || c.startsWith("JSON_UNQUOTE(");
@@ -5340,13 +5449,12 @@ function parseSqlWhere(where, getJsonField, placeholder = "?", likeOperator = pl
       case "less_than_or_equal":
         params.push(operand);
         return `${c} <= ${next()}`;
-      case "contains":
       case "like":
-        params.push(`%${operand}%`);
-        return placeholder === "pg" ? `(${c})::text ${likeOperator} ${next()}` : `${c} ${likeOperator} ${next()}`;
+        return buildLike(c, `%${String(operand)}%`);
+      case "contains":
+        return buildLike(c, `%${escapeLike(String(operand))}%`, true);
       case "starts_with":
-        params.push(`${operand}%`);
-        return placeholder === "pg" ? `(${c})::text ${likeOperator} ${next()}` : `${c} ${likeOperator} ${next()}`;
+        return buildLike(c, `${escapeLike(String(operand))}%`, true);
       case "exists":
         return operand ? `${c} IS NOT NULL` : `${c} IS NULL`;
       default:
@@ -5444,9 +5552,9 @@ function parseMongoWhere(where) {
         return { [field]: { $lte: operand } };
       case "contains":
       case "like":
-        return { [field]: { $regex: operand, $options: "i" } };
+        return { [field]: { $regex: escapeRegex(String(operand)), $options: "i" } };
       case "starts_with":
-        return { [field]: { $regex: `^${operand}`, $options: "i" } };
+        return { [field]: { $regex: `^${escapeRegex(String(operand))}`, $options: "i" } };
       case "exists":
         return { [field]: { $exists: operand } };
       default:
@@ -5556,6 +5664,99 @@ function buildSqlOrderBy(sort, existingColumns, numericFields, dialect) {
   }).join(", ");
 }
 
+// src/utils/component-keys.ts
+var DASHBOARD_SLOTS = ["beforeDashboard", "afterDashboard"];
+var LIST_SLOTS = ["beforeList", "beforeListTable", "afterListTable", "afterList"];
+var FORM_SLOTS = ["createForm", "editForm", "form"];
+var VIEW_SLOTS = ["beforeViewHeader", "afterViewHeader", "beforeViewContent", "afterViewContent"];
+function addKeys(target, value) {
+  for (const key of Array.isArray(value) ? value : [value]) {
+    if (typeof key === "string" && key) target.add(key);
+  }
+}
+function addSlots(target, slots, names) {
+  if (!slots || typeof slots !== "object") return;
+  for (const name of names) addKeys(target, slots[name]);
+}
+function scanFields(fields, keys) {
+  if (!Array.isArray(fields)) return;
+  for (const field of fields) {
+    if (!field || typeof field !== "object") continue;
+    addKeys(keys.fields, field.admin?.component);
+    scanFields(field.fields, keys);
+    if (Array.isArray(field.blocks)) {
+      for (const block of field.blocks) scanFields(block?.fields, keys);
+    }
+    if (Array.isArray(field.tabs)) {
+      for (const tab of field.tabs) scanFields(tab?.fields, keys);
+    }
+  }
+}
+function scanDetail(items, keys) {
+  if (!Array.isArray(items)) return;
+  for (const item of items) {
+    if (!item || typeof item !== "object") continue;
+    if (item.type === "custom") addKeys(keys.customComponents, item.name);
+    scanDetail(item.items, keys);
+    if (Array.isArray(item.tabs)) {
+      for (const tab of item.tabs) scanDetail(tab?.items, keys);
+    }
+  }
+}
+function scanViews(views, keys) {
+  if (!Array.isArray(views)) return;
+  for (const view of views) {
+    addSlots(keys.collectionView, view?.components, VIEW_SLOTS);
+    if (view?.layout === "custom") addKeys(keys.viewLayouts, view.component);
+  }
+}
+function collectReferencedComponentKeys(schema) {
+  const keys = {
+    fields: /* @__PURE__ */ new Set(),
+    dashboard: /* @__PURE__ */ new Set(),
+    collectionList: /* @__PURE__ */ new Set(),
+    collectionView: /* @__PURE__ */ new Set(),
+    forms: /* @__PURE__ */ new Set(),
+    viewLayouts: /* @__PURE__ */ new Set(),
+    pages: /* @__PURE__ */ new Set(),
+    customComponents: /* @__PURE__ */ new Set()
+  };
+  const root = schema;
+  if (!root || typeof root !== "object") return keys;
+  addSlots(keys.dashboard, root.admin?.components, DASHBOARD_SLOTS);
+  if (Array.isArray(root.admin?.navigation)) {
+    for (const item of root.admin.navigation) {
+      if (item?.page) {
+        if (typeof item.page === "string") {
+          addKeys(keys.pages, item.page);
+        } else if (item.page?.component) {
+          addKeys(keys.pages, item.page.component);
+        }
+      }
+    }
+  }
+  if (Array.isArray(root.admin?.pages)) {
+    for (const page of root.admin.pages) addKeys(keys.pages, page?.component);
+  }
+  for (const block of root.blocks ?? []) scanFields(block?.fields, keys);
+  for (const collection of root.collections ?? []) {
+    scanFields(collection.fields, keys);
+    scanDetail(collection.detail, keys);
+    scanViews(collection.views, keys);
+    const slots = collection.admin?.components;
+    addSlots(keys.collectionList, slots, LIST_SLOTS);
+    addSlots(keys.collectionView, slots, VIEW_SLOTS);
+    addSlots(keys.collectionView, slots?.collectionView, VIEW_SLOTS);
+    addSlots(keys.forms, slots, FORM_SLOTS);
+  }
+  for (const global of root.globals ?? []) {
+    scanFields(global.fields, keys);
+    scanDetail(global.detail, keys);
+    addSlots(keys.forms, global.admin?.components, FORM_SLOTS);
+  }
+  return keys;
+}
+
 // src/utils/openapi.ts
 function getCollectionLabels(collection) {
   return collection.labels || { singular: collection.slug, plural: collection.slug };
@@ -8043,11 +8244,32 @@ var RESERVED_NAVIGATION_SLUGS = /* @__PURE__ */ new Set([
   "admin",
   "preferences",
   "auth",
-  "trash"
+  "trash",
+  "pages"
 ]);
 function assertValidNavigationSlugs(navigation) {
+  const seenWorkspaceSlugs = /* @__PURE__ */ new Set();
+  const seenPageSlugs = /* @__PURE__ */ new Set();
   for (const item of navigation) {
     if (item.dashboard || item.trash) continue;
+    if (item.page) {
+      const pageSlug = typeof item.page === "string" ? item.slug || item.page : item.slug || item.page.slug;
+      if (pageSlug) {
+        const normalized = pageSlug.toLowerCase().trim().replace(/^\//, "");
+        if (RESERVED_NAVIGATION_SLUGS.has(normalized)) {
+          throw new Error(
+            `[Dyrected Config] The slug '${pageSlug}' in custom page '${item.label || pageSlug}' is a reserved system path and cannot be used as a page slug.`
+          );
+        }
+        if (seenPageSlugs.has(normalized)) {
+          throw new Error(
+            `[Dyrected Config] Duplicate page slug '${pageSlug}' in navigation. Page slugs must be unique.`
+          );
+        }
+        seenPageSlugs.add(normalized);
+      }
+      continue;
+    }
     if (item.slug) {
       const normalizedSlug = item.slug.toLowerCase().trim().replace(/^\//, "");
       if (RESERVED_NAVIGATION_SLUGS.has(normalizedSlug)) {
@@ -8055,6 +8277,12 @@ function assertValidNavigationSlugs(navigation) {
           `[Dyrected Config] The slug '${item.slug}' in navigation item '${item.label || item.slug}' is a reserved system path and cannot be used as an operational workspace slug.`
         );
       }
+      if (seenWorkspaceSlugs.has(normalizedSlug)) {
+        throw new Error(
+          `[Dyrected Config] Duplicate workspace slug '${item.slug}' in navigation. Workspace slugs must be unique.`
+        );
+      }
+      seenWorkspaceSlugs.add(normalizedSlug);
     }
   }
 }
@@ -8197,6 +8425,43 @@ function compileNavigation(config) {
       });
       continue;
     }
+    if (item.page) {
+      const pageConfig = typeof item.page === "string" ? {
+        slug: item.slug || item.page,
+        label: item.label || item.page,
+        icon: item.icon,
+        component: item.page,
+        group: typeof item.group === "string" ? item.group : item.group?.name,
+        order: item.order,
+        badge: item.badge,
+        access: item.access
+      } : {
+        ...item.page,
+        slug: item.slug || item.page.slug || "page",
+        label: item.label || item.page.label || item.slug || "Page",
+        icon: item.icon || item.page.icon,
+        group: item.group ? typeof item.group === "string" ? item.group : item.group?.name : item.page.group,
+        order: item.order ?? item.page.order,
+        badge: item.badge || item.page.badge,
+        access: item.access || (item.page.access && typeof item.page.access === "object" && "read" in item.page.access ? item.page.access.read : item.page.access)
+      };
+      const pageSlug = pageConfig.slug || "page";
+      registerItem(groupName, {
+        id: `page:${pageSlug}`,
+        type: "page",
+        slug: pageSlug,
+        label: pageConfig.label || pageSlug,
+        icon: pageConfig.icon || "FileText",
+        href: `/pages/${pageSlug}`,
+        group: groupName,
+        order: pageConfig.order ?? 100,
+        views: [],
+        badge: pageConfig.badge,
+        access: pageConfig.access && typeof pageConfig.access === "object" && "read" in pageConfig.access ? pageConfig.access.read : pageConfig.access,
+        page: pageConfig
+      });
+      continue;
+    }
     const workspaceSlug = item.slug || "workspace";
     registerItem(groupName, {
       id: `workspace_${workspaceSlug}`,
@@ -8578,6 +8843,7 @@ export {
   BUILTIN_JEXL_HELPERS,
   CROCKFORD_BASE32,
   CURRENT_NAV_PREFERENCES_VERSION,
+  CUSTOM_VIEW_FETCH_ALL_LIMIT,
   ConfigValidationError,
   ConflictError,
   DEFAULT_USER_NAV_PREFERENCES,
@@ -8586,6 +8852,7 @@ export {
   DyrectedError,
   EMAIL_TEMPLATES_COLLECTION_CONFIG,
   EMAIL_TEMPLATES_COLLECTION_SLUG,
+  FORM_SHELLS,
   FieldConditionBuilder,
   ForbiddenError,
   INTERNAL_SYSTEM_COLLECTIONS,
@@ -8624,11 +8891,13 @@ export {
   clamp,
   coalesce,
   coerceBooleanWhere,
+  collectAdminComponentsValidationIssues,
   collectAdminConditionValidationIssues,
   collectConfigDiagnostics,
   collectDeclarativeAccessValidationIssues,
   collectDeclarativeHookValidationIssues,
   collectPreviewUrlValidationIssues,
+  collectReferencedComponentKeys,
   compact,
   compileNavigation,
   count,
@@ -8649,6 +8918,7 @@ export {
   defineConfig,
   defineCreatedAtField,
   defineCreatedByField,
+  defineCustomView,
   defineDateField,
   defineDateTimeField,
   defineEmailField,
@@ -8664,6 +8934,7 @@ export {
   defineMultiSelectField,
   defineNumberField,
   defineObjectField,
+  definePage,
   definePublishingWorkflow,
   defineRadioField,
   defineRelationshipField,