@momentumcms/core 0.5.3 → 0.5.5

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@momentumcms/core",
-	"version": "0.5.3",
+	"version": "0.5.5",
 	"description": "Core collection config, fields, hooks, and access control for Momentum CMS",
 	"license": "MIT",
 	"author": "Momentum CMS Contributors",

package/src/generators/generator.cjs

@@ -465,6 +465,35 @@ ${indent}}`;
   }
   return "undefined";
 }
+function serializeComponentLoaders(components, configPath, outputPath, indent) {
+  const entries = [];
+  for (const [key, value] of Object.entries(components)) {
+    if (typeof value !== "function")
+      continue;
+    const source = value.toString();
+    const importMatch = /(?:import|__vite_ssr_dynamic_import__)\(\s*['"]([^'"]+)['"]\s*\)/.exec(
+      source
+    );
+    if (!importMatch)
+      continue;
+    const importPath = importMatch[1];
+    const abs = (0, import_node_path.resolve)((0, import_node_path.dirname)(configPath), importPath);
+    const rel = computeRelativeImport(outputPath, abs + ".ts");
+    const memberMatch = /\.then\(\s*\(?\s*(\w+)\s*\)?\s*=>\s*\1(?:\.(\w+)|\[["'](\w+)["']\])\s*\)/.exec(source);
+    if (!memberMatch)
+      continue;
+    const memberName = memberMatch[2] || memberMatch[3];
+    const safeKey = needsQuoting2(key) ? safeQuote(key) : key;
+    entries.push(
+      `${indent}	${safeKey}: () => import(${JSON.stringify(rel)}).then((m) => m.${memberName})`
+    );
+  }
+  if (entries.length === 0)
+    return null;
+  return `{
+${entries.join(",\n")},
+${indent}}`;
+}
 function serializeField(field, indent = "		") {
   const props = [];
   props.push(`${indent}name: ${JSON.stringify(field.name)}`);
@@ -614,7 +643,7 @@ ${indent}	}`;
 ${items},
 ${indent}]`;
 }
-function serializeCollection(collection, indent = "	") {
+function serializeCollection(collection, indent = "	", configPath, outputPath) {
   const parts = [];
   parts.push(`${indent}	slug: ${JSON.stringify(collection.slug)}`);
   if (collection.labels) {
@@ -622,16 +651,37 @@ function serializeCollection(collection, indent = "	") {
   }
   parts.push(`${indent}	fields: ${serializeFieldsArray(collection.fields, indent + "	")}`);
   if (collection.admin) {
-    const adminEntries = Object.entries(collection.admin).filter(([, v]) => v !== void 0).map(([k, v]) => {
+    const componentsObj = collection.admin["components"];
+    const adminEntries = Object.entries(collection.admin).filter(([k, v]) => v !== void 0 && k !== "components").map(([k, v]) => {
       if (k === "preview" && typeof v === "function") {
         const fn = v;
         return [k, previewFunctionToTemplate(fn, collection.fields)];
       }
       return [k, v];
     }).filter(([, v]) => typeof v !== "function");
-    if (adminEntries.length > 0) {
-      const adminObj = Object.fromEntries(adminEntries);
-      parts.push(`${indent}	admin: ${serializeValue(adminObj, indent + "	")}`);
+    let componentsStr = null;
+    if (componentsObj && typeof componentsObj === "object" && configPath && outputPath) {
+      const loaders = {};
+      for (const [k, v] of Object.entries(componentsObj)) {
+        loaders[k] = v;
+      }
+      componentsStr = serializeComponentLoaders(loaders, configPath, outputPath, indent + "		");
+    }
+    if (adminEntries.length > 0 || componentsStr) {
+      const adminProps = [];
+      if (adminEntries.length > 0) {
+        const adminObj = Object.fromEntries(adminEntries);
+        for (const [k, v] of Object.entries(adminObj)) {
+          const key = needsQuoting2(k) ? safeQuote(k) : k;
+          adminProps.push(`${indent}		${key}: ${serializeValue(v, indent + "		")}`);
+        }
+      }
+      if (componentsStr) {
+        adminProps.push(`${indent}		components: ${componentsStr}`);
+      }
+      parts.push(`${indent}	admin: {
+${adminProps.join(",\n")},
+${indent}	}`);
     }
   }
   if (collection.auth) {
@@ -691,14 +741,24 @@ function computeRelativeImport(fromFile, toFile) {
   }
   return rel;
 }
-function generateAdminConfig(config, typesRelPath) {
+function generateAdminConfig(config, typesRelPath, configPath, outputPath) {
   const lines = [];
   const allCollections = resolveAllCollections(config);
   const globals = config.globals ?? [];
   const plugins = config.plugins ?? [];
-  const pluginsWithAdminRoutes = plugins.filter(
-    (p) => p.browserImports?.adminRoutes && p.adminRoutes && p.adminRoutes.length > 0
-  );
+  const SAFE_IDENTIFIER = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
+  const pluginsWithAdminRoutes = plugins.filter((p) => {
+    if (!p.browserImports?.adminRoutes || !p.adminRoutes || p.adminRoutes.length === 0)
+      return false;
+    const exportName = p.browserImports.adminRoutes.exportName;
+    if (!SAFE_IDENTIFIER.test(exportName)) {
+      console.warn(
+        `[generateAdminConfig] Skipping plugin "${p.name}": exportName "${exportName}" is not a valid identifier`
+      );
+      return false;
+    }
+    return true;
+  });
   lines.push("/**");
   lines.push(" * AUTO-GENERATED by @momentumcms/core");
   lines.push(" * DO NOT EDIT - regenerate with: nx run <app>:generate");
@@ -714,13 +774,13 @@ function generateAdminConfig(config, typesRelPath) {
     const imp = plugin.browserImports?.adminRoutes;
     if (!imp)
       continue;
-    lines.push(`import { ${imp.exportName} } from '${imp.path}';`);
+    lines.push(`import { ${imp.exportName} } from ${JSON.stringify(imp.path)};`);
   }
   lines.push("");
   const genericParams = globals.length > 0 ? "<CollectionSlug, GlobalSlug>" : "<CollectionSlug>";
   lines.push(`export const adminConfig: MomentumAdminConfig${genericParams} = {`);
   if (allCollections.length > 0) {
-    const collectionItems = allCollections.map((c) => `		${serializeCollection(c, "		")}`).join(",\n");
+    const collectionItems = allCollections.map((c) => `		${serializeCollection(c, "		", configPath, outputPath)}`).join(",\n");
     lines.push(`	collections: [
 ${collectionItems},
 	],`);
@@ -734,15 +794,31 @@ ${globalItems},
 	],`);
   }
   if (config.admin) {
-    const adminObj = {};
-    if (config.admin.basePath)
-      adminObj["basePath"] = config.admin.basePath;
-    if (config.admin.branding)
-      adminObj["branding"] = config.admin.branding;
-    if (config.admin.toasts !== void 0)
-      adminObj["toasts"] = config.admin.toasts;
-    if (Object.keys(adminObj).length > 0) {
-      lines.push(`	admin: ${serializeValue(adminObj)},`);
+    const adminParts = [];
+    if (config.admin.basePath) {
+      adminParts.push(`		basePath: ${JSON.stringify(config.admin.basePath)}`);
+    }
+    if (config.admin.branding) {
+      adminParts.push(`		branding: ${serializeValue(config.admin.branding, "		")}`);
+    }
+    if (config.admin.toasts !== void 0) {
+      adminParts.push(`		toasts: ${String(config.admin.toasts)}`);
+    }
+    if (config.admin.components && configPath && outputPath) {
+      const componentsStr = serializeComponentLoaders(
+        config.admin.components,
+        configPath,
+        outputPath,
+        "		"
+      );
+      if (componentsStr) {
+        adminParts.push(`		components: ${componentsStr}`);
+      }
+    }
+    if (adminParts.length > 0) {
+      lines.push(`	admin: {
+${adminParts.join(",\n")},
+	},`);
     }
   }
   if (pluginsWithAdminRoutes.length > 0) {
@@ -812,7 +888,12 @@ async function runGenerator(options) {
       (0, import_node_fs.mkdirSync)((0, import_node_path.dirname)(typesOutputPath), { recursive: true });
       (0, import_node_fs.writeFileSync)(typesOutputPath, typesContent, "utf-8");
       console.info(`Types generated: ${typesOutputPath}`);
-      const adminConfigContent = generateAdminConfig(config, typesRelPath);
+      const adminConfigContent = generateAdminConfig(
+        config,
+        typesRelPath,
+        configPath,
+        configOutputPath
+      );
       (0, import_node_fs.mkdirSync)((0, import_node_path.dirname)(configOutputPath), { recursive: true });
       (0, import_node_fs.writeFileSync)(configOutputPath, adminConfigContent, "utf-8");
       console.info(`Admin config generated: ${configOutputPath}`);

package/src/generators/generator.d.ts

@@ -149,6 +149,7 @@ interface MomentumConfig {
             title?: string;
         };
         toasts?: boolean;
+        components?: Record<string, unknown>;
     };
     plugins?: PluginDescriptor[];
 }
@@ -175,7 +176,7 @@ export declare function serializeField(field: FieldDefinition, indent?: string):
 /**
  * Serialize a collection definition, stripping server-only properties.
  */
-export declare function serializeCollection(collection: CollectionDefinition, indent?: string): string;
+export declare function serializeCollection(collection: CollectionDefinition, indent?: string, configPath?: string, outputPath?: string): string;
 /**
  * Serialize a global definition, stripping server-only properties.
  */
@@ -189,7 +190,7 @@ export declare function computeRelativeImport(fromFile: string, toFile: string):
  * Collections and globals are inlined with server-only properties stripped.
  * Only plugin admin routes are still imported (they have loadComponent functions).
  */
-export declare function generateAdminConfig(config: MomentumConfig, typesRelPath: string): string;
+export declare function generateAdminConfig(config: MomentumConfig, typesRelPath: string, configPath?: string, outputPath?: string): string;
 export default function runGenerator(options: GeneratorOptions): Promise<{
     success: boolean;
 }>;

package/src/generators/generator.js

@@ -434,6 +434,35 @@ ${indent}}`;
   }
   return "undefined";
 }
+function serializeComponentLoaders(components, configPath, outputPath, indent) {
+  const entries = [];
+  for (const [key, value] of Object.entries(components)) {
+    if (typeof value !== "function")
+      continue;
+    const source = value.toString();
+    const importMatch = /(?:import|__vite_ssr_dynamic_import__)\(\s*['"]([^'"]+)['"]\s*\)/.exec(
+      source
+    );
+    if (!importMatch)
+      continue;
+    const importPath = importMatch[1];
+    const abs = resolve(dirname(configPath), importPath);
+    const rel = computeRelativeImport(outputPath, abs + ".ts");
+    const memberMatch = /\.then\(\s*\(?\s*(\w+)\s*\)?\s*=>\s*\1(?:\.(\w+)|\[["'](\w+)["']\])\s*\)/.exec(source);
+    if (!memberMatch)
+      continue;
+    const memberName = memberMatch[2] || memberMatch[3];
+    const safeKey = needsQuoting2(key) ? safeQuote(key) : key;
+    entries.push(
+      `${indent}	${safeKey}: () => import(${JSON.stringify(rel)}).then((m) => m.${memberName})`
+    );
+  }
+  if (entries.length === 0)
+    return null;
+  return `{
+${entries.join(",\n")},
+${indent}}`;
+}
 function serializeField(field, indent = "		") {
   const props = [];
   props.push(`${indent}name: ${JSON.stringify(field.name)}`);
@@ -583,7 +612,7 @@ ${indent}	}`;
 ${items},
 ${indent}]`;
 }
-function serializeCollection(collection, indent = "	") {
+function serializeCollection(collection, indent = "	", configPath, outputPath) {
   const parts = [];
   parts.push(`${indent}	slug: ${JSON.stringify(collection.slug)}`);
   if (collection.labels) {
@@ -591,16 +620,37 @@ function serializeCollection(collection, indent = "	") {
   }
   parts.push(`${indent}	fields: ${serializeFieldsArray(collection.fields, indent + "	")}`);
   if (collection.admin) {
-    const adminEntries = Object.entries(collection.admin).filter(([, v]) => v !== void 0).map(([k, v]) => {
+    const componentsObj = collection.admin["components"];
+    const adminEntries = Object.entries(collection.admin).filter(([k, v]) => v !== void 0 && k !== "components").map(([k, v]) => {
       if (k === "preview" && typeof v === "function") {
         const fn = v;
         return [k, previewFunctionToTemplate(fn, collection.fields)];
       }
       return [k, v];
     }).filter(([, v]) => typeof v !== "function");
-    if (adminEntries.length > 0) {
-      const adminObj = Object.fromEntries(adminEntries);
-      parts.push(`${indent}	admin: ${serializeValue(adminObj, indent + "	")}`);
+    let componentsStr = null;
+    if (componentsObj && typeof componentsObj === "object" && configPath && outputPath) {
+      const loaders = {};
+      for (const [k, v] of Object.entries(componentsObj)) {
+        loaders[k] = v;
+      }
+      componentsStr = serializeComponentLoaders(loaders, configPath, outputPath, indent + "		");
+    }
+    if (adminEntries.length > 0 || componentsStr) {
+      const adminProps = [];
+      if (adminEntries.length > 0) {
+        const adminObj = Object.fromEntries(adminEntries);
+        for (const [k, v] of Object.entries(adminObj)) {
+          const key = needsQuoting2(k) ? safeQuote(k) : k;
+          adminProps.push(`${indent}		${key}: ${serializeValue(v, indent + "		")}`);
+        }
+      }
+      if (componentsStr) {
+        adminProps.push(`${indent}		components: ${componentsStr}`);
+      }
+      parts.push(`${indent}	admin: {
+${adminProps.join(",\n")},
+${indent}	}`);
     }
   }
   if (collection.auth) {
@@ -660,14 +710,24 @@ function computeRelativeImport(fromFile, toFile) {
   }
   return rel;
 }
-function generateAdminConfig(config, typesRelPath) {
+function generateAdminConfig(config, typesRelPath, configPath, outputPath) {
   const lines = [];
   const allCollections = resolveAllCollections(config);
   const globals = config.globals ?? [];
   const plugins = config.plugins ?? [];
-  const pluginsWithAdminRoutes = plugins.filter(
-    (p) => p.browserImports?.adminRoutes && p.adminRoutes && p.adminRoutes.length > 0
-  );
+  const SAFE_IDENTIFIER = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
+  const pluginsWithAdminRoutes = plugins.filter((p) => {
+    if (!p.browserImports?.adminRoutes || !p.adminRoutes || p.adminRoutes.length === 0)
+      return false;
+    const exportName = p.browserImports.adminRoutes.exportName;
+    if (!SAFE_IDENTIFIER.test(exportName)) {
+      console.warn(
+        `[generateAdminConfig] Skipping plugin "${p.name}": exportName "${exportName}" is not a valid identifier`
+      );
+      return false;
+    }
+    return true;
+  });
   lines.push("/**");
   lines.push(" * AUTO-GENERATED by @momentumcms/core");
   lines.push(" * DO NOT EDIT - regenerate with: nx run <app>:generate");
@@ -683,13 +743,13 @@ function generateAdminConfig(config, typesRelPath) {
     const imp = plugin.browserImports?.adminRoutes;
     if (!imp)
       continue;
-    lines.push(`import { ${imp.exportName} } from '${imp.path}';`);
+    lines.push(`import { ${imp.exportName} } from ${JSON.stringify(imp.path)};`);
   }
   lines.push("");
   const genericParams = globals.length > 0 ? "<CollectionSlug, GlobalSlug>" : "<CollectionSlug>";
   lines.push(`export const adminConfig: MomentumAdminConfig${genericParams} = {`);
   if (allCollections.length > 0) {
-    const collectionItems = allCollections.map((c) => `		${serializeCollection(c, "		")}`).join(",\n");
+    const collectionItems = allCollections.map((c) => `		${serializeCollection(c, "		", configPath, outputPath)}`).join(",\n");
     lines.push(`	collections: [
 ${collectionItems},
 	],`);
@@ -703,15 +763,31 @@ ${globalItems},
 	],`);
   }
   if (config.admin) {
-    const adminObj = {};
-    if (config.admin.basePath)
-      adminObj["basePath"] = config.admin.basePath;
-    if (config.admin.branding)
-      adminObj["branding"] = config.admin.branding;
-    if (config.admin.toasts !== void 0)
-      adminObj["toasts"] = config.admin.toasts;
-    if (Object.keys(adminObj).length > 0) {
-      lines.push(`	admin: ${serializeValue(adminObj)},`);
+    const adminParts = [];
+    if (config.admin.basePath) {
+      adminParts.push(`		basePath: ${JSON.stringify(config.admin.basePath)}`);
+    }
+    if (config.admin.branding) {
+      adminParts.push(`		branding: ${serializeValue(config.admin.branding, "		")}`);
+    }
+    if (config.admin.toasts !== void 0) {
+      adminParts.push(`		toasts: ${String(config.admin.toasts)}`);
+    }
+    if (config.admin.components && configPath && outputPath) {
+      const componentsStr = serializeComponentLoaders(
+        config.admin.components,
+        configPath,
+        outputPath,
+        "		"
+      );
+      if (componentsStr) {
+        adminParts.push(`		components: ${componentsStr}`);
+      }
+    }
+    if (adminParts.length > 0) {
+      lines.push(`	admin: {
+${adminParts.join(",\n")},
+	},`);
     }
   }
   if (pluginsWithAdminRoutes.length > 0) {
@@ -781,7 +857,12 @@ async function runGenerator(options) {
       mkdirSync(dirname(typesOutputPath), { recursive: true });
       writeFileSync(typesOutputPath, typesContent, "utf-8");
       console.info(`Types generated: ${typesOutputPath}`);
-      const adminConfigContent = generateAdminConfig(config, typesRelPath);
+      const adminConfigContent = generateAdminConfig(
+        config,
+        typesRelPath,
+        configPath,
+        configOutputPath
+      );
       mkdirSync(dirname(configOutputPath), { recursive: true });
       writeFileSync(configOutputPath, adminConfigContent, "utf-8");
       console.info(`Admin config generated: ${configOutputPath}`);

package/src/index.cjs

@@ -51,6 +51,7 @@ __export(src_exports, {
   hasAllRoles: () => hasAllRoles,
   hasAnyRole: () => hasAnyRole,
   hasRole: () => hasRole,
+  hasVersionDrafts: () => hasVersionDrafts,
   humanizeFieldName: () => humanizeFieldName,
   isAuthenticated: () => isAuthenticated,
   isLayoutField: () => isLayoutField,
@@ -70,6 +71,7 @@ __export(src_exports, {
   richText: () => richText,
   row: () => row,
   select: () => select,
+  shouldSyncSchema: () => shouldSyncSchema,
   slug: () => slug,
   tabs: () => tabs,
   text: () => text,
@@ -648,7 +650,8 @@ function defineMomentumConfig(config) {
     admin: {
       basePath: config.admin?.basePath ?? "/admin",
       branding: config.admin?.branding ?? {},
-      toasts: config.admin?.toasts ?? true
+      toasts: config.admin?.toasts ?? true,
+      components: config.admin?.components
     },
     server: {
       port: config.server?.port ?? 3e3,
@@ -674,6 +677,15 @@ function defineMomentumConfig(config) {
     migrations: resolveMigrationConfig(config.migrations)
   };
 }
+function shouldSyncSchema(config) {
+  const explicit = config.db.syncSchema ?? "auto";
+  if (typeof explicit === "boolean")
+    return explicit;
+  if (!config.migrations)
+    return true;
+  const mode = resolveMigrationMode(config.migrations.mode);
+  return mode !== "migrate";
+}
 function getDbAdapter(config) {
   return config.db.adapter;
 }
@@ -769,6 +781,14 @@ function createSeedHelpers() {
     }
   };
 }
+
+// libs/core/src/lib/versions/version.types.ts
+function hasVersionDrafts(collection) {
+  const v = collection.versions;
+  if (!v || typeof v === "boolean")
+    return false;
+  return !!v.drafts;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LAYOUT_FIELD_TYPES,
@@ -802,6 +822,7 @@ function createSeedHelpers() {
   hasAllRoles,
   hasAnyRole,
   hasRole,
+  hasVersionDrafts,
   humanizeFieldName,
   isAuthenticated,
   isLayoutField,
@@ -821,6 +842,7 @@ function createSeedHelpers() {
   richText,
   row,
   select,
+  shouldSyncSchema,
   slug,
   tabs,
   text,

package/src/index.js

@@ -567,7 +567,8 @@ function defineMomentumConfig(config) {
     admin: {
       basePath: config.admin?.basePath ?? "/admin",
       branding: config.admin?.branding ?? {},
-      toasts: config.admin?.toasts ?? true
+      toasts: config.admin?.toasts ?? true,
+      components: config.admin?.components
     },
     server: {
       port: config.server?.port ?? 3e3,
@@ -593,6 +594,15 @@ function defineMomentumConfig(config) {
     migrations: resolveMigrationConfig(config.migrations)
   };
 }
+function shouldSyncSchema(config) {
+  const explicit = config.db.syncSchema ?? "auto";
+  if (typeof explicit === "boolean")
+    return explicit;
+  if (!config.migrations)
+    return true;
+  const mode = resolveMigrationMode(config.migrations.mode);
+  return mode !== "migrate";
+}
 function getDbAdapter(config) {
   return config.db.adapter;
 }
@@ -688,6 +698,14 @@ function createSeedHelpers() {
     }
   };
 }
+
+// libs/core/src/lib/versions/version.types.ts
+function hasVersionDrafts(collection) {
+  const v = collection.versions;
+  if (!v || typeof v === "boolean")
+    return false;
+  return !!v.drafts;
+}
 export {
   LAYOUT_FIELD_TYPES,
   MIN_PASSWORD_LENGTH,
@@ -720,6 +738,7 @@ export {
   hasAllRoles,
   hasAnyRole,
   hasRole,
+  hasVersionDrafts,
   humanizeFieldName,
   isAuthenticated,
   isLayoutField,
@@ -739,6 +758,7 @@ export {
   richText,
   row,
   select,
+  shouldSyncSchema,
   slug,
   tabs,
   text,

package/src/lib/collections/collection.types.d.ts

@@ -37,6 +37,8 @@ export interface AccessConfig {
     publishVersions?: AccessFunction;
     /** Control who can restore previous versions */
     restoreVersions?: AccessFunction;
+    /** Control who can see draft (unpublished) documents. Falls back to `update` access if not set. */
+    readDrafts?: AccessFunction;
 }
 export interface HookArgs {
     req: RequestContext;
@@ -84,6 +86,39 @@ export interface AdminConfig {
         /** HTTP endpoint path for the action (e.g., '/api/auth/api-keys') */
         endpoint?: string;
     }>;
+    /**
+     * Custom components for this collection's admin pages.
+     * Register page replacements and per-collection layout slots.
+     */
+    components?: CollectionAdminComponentsConfig;
+}
+/**
+ * Per-collection admin component overrides and layout slots.
+ * Used in `AdminConfig.components` for collection-specific customization.
+ *
+ * Loaders use `() => Promise<unknown>` to stay framework-agnostic.
+ */
+export interface CollectionAdminComponentsConfig {
+    /** Replace the list page for this collection */
+    list?: () => Promise<unknown>;
+    /** Replace the edit page for this collection */
+    edit?: () => Promise<unknown>;
+    /** Replace the view page for this collection */
+    view?: () => Promise<unknown>;
+    /** Slot: before the collection list */
+    beforeList?: () => Promise<unknown>;
+    /** Slot: after the collection list */
+    afterList?: () => Promise<unknown>;
+    /** Slot: before the edit form */
+    beforeEdit?: () => Promise<unknown>;
+    /** Slot: after the edit form */
+    afterEdit?: () => Promise<unknown>;
+    /** Slot: sidebar panel on edit page */
+    editSidebar?: () => Promise<unknown>;
+    /** Slot: before the view page */
+    beforeView?: () => Promise<unknown>;
+    /** Slot: after the view page */
+    afterView?: () => Promise<unknown>;
 }
 export interface VersionsConfig {
     /** Enable draft versions */

package/src/lib/config.d.ts

@@ -193,6 +193,50 @@ export interface DatabaseConfig {
      * Use @momentumcms/db-drizzle for Drizzle ORM support.
      */
     adapter: DatabaseAdapter;
+    /**
+     * Whether to auto-sync the database schema on server start.
+     *
+     * - `true`:  Always run `adapter.initialize()` (CREATE TABLE IF NOT EXISTS).
+     * - `false`: Never auto-sync — expect migrations to be run separately.
+     * - `'auto'`: Sync when no migration config or in `push` mode;
+     *             skip when migration mode is `migrate`.
+     *
+     * @default 'auto'
+     */
+    syncSchema?: boolean | 'auto';
+}
+/**
+ * Admin component overrides and layout slot registrations.
+ * Used in `AdminPanelConfig.components` for global overrides
+ * and in `MomentumPlugin.adminComponents` for plugin-level overrides.
+ *
+ * Loaders use `() => Promise<unknown>` so this interface stays
+ * framework-agnostic (core is `env:universal`). The admin package
+ * casts to `Type<unknown>` at registration time.
+ */
+export interface AdminComponentsConfig {
+    /** Replace the dashboard page */
+    dashboard?: () => Promise<unknown>;
+    /** Replace the login page */
+    login?: () => Promise<unknown>;
+    /** Replace the media library page */
+    media?: () => Promise<unknown>;
+    /** Slot: before navigation links in sidebar */
+    beforeNavigation?: () => Promise<unknown>;
+    /** Slot: after navigation links in sidebar */
+    afterNavigation?: () => Promise<unknown>;
+    /** Slot: global header (between mobile header and main content) */
+    header?: () => Promise<unknown>;
+    /** Slot: global footer (after main content) */
+    footer?: () => Promise<unknown>;
+    /** Slot: before dashboard content */
+    beforeDashboard?: () => Promise<unknown>;
+    /** Slot: after dashboard content */
+    afterDashboard?: () => Promise<unknown>;
+    /** Slot: before login form */
+    beforeLogin?: () => Promise<unknown>;
+    /** Slot: after login form */
+    afterLogin?: () => Promise<unknown>;
 }
 /**
  * Global admin panel configuration.
@@ -219,6 +263,12 @@ export interface AdminPanelConfig {
      * @default true
      */
     toasts?: boolean;
+    /**
+     * Custom admin component overrides and layout slots.
+     * Register page replacements (dashboard, login, media) and
+     * slot components (header, footer, beforeDashboard, etc.).
+     */
+    components?: AdminComponentsConfig;
 }
 /**
  * Server configuration.
@@ -378,11 +428,16 @@ export type ResolvedSeedingOptions = Required<SeedingOptions>;
 export interface ResolvedSeedingConfig extends SeedingConfig {
     options: ResolvedSeedingOptions;
 }
+/**
+ * AdminPanelConfig with primitive defaults resolved (basePath, branding, toasts).
+ * `components` remains optional since it has no default.
+ */
+export type ResolvedAdminPanelConfig = Required<Omit<AdminPanelConfig, 'components'>> & Pick<AdminPanelConfig, 'components'>;
 /**
  * Internal config with resolved defaults.
  */
 export interface ResolvedMomentumConfig extends MomentumConfig {
-    admin: Required<AdminPanelConfig>;
+    admin: ResolvedAdminPanelConfig;
     server: Required<ServerConfig>;
     seeding?: ResolvedSeedingConfig;
     logging: ResolvedLoggingConfig;
@@ -415,6 +470,14 @@ export interface ResolvedMomentumConfig extends MomentumConfig {
  * ```
  */
 export declare function defineMomentumConfig(config: MomentumConfig): ResolvedMomentumConfig;
+/**
+ * Determine whether the server should auto-sync the database schema on boot.
+ *
+ * Resolution order:
+ * 1. Explicit `db.syncSchema` (true / false) — always wins.
+ * 2. `'auto'` (or omitted) — sync unless migration mode is `'migrate'`.
+ */
+export declare function shouldSyncSchema(config: MomentumConfig | ResolvedMomentumConfig): boolean;
 /**
  * Gets the database adapter from the config.
  */

package/src/lib/plugins.d.ts

@@ -6,7 +6,7 @@
  * Runtime implementations (PluginRunner, etc.) live in @momentumcms/plugins/core.
  */
 import type { CollectionConfig, UserContext } from './collections';
-import type { MomentumConfig } from './config';
+import type { AdminComponentsConfig, MomentumConfig } from './config';
 /**
  * Descriptor for Express middleware/routes that a plugin wants auto-mounted.
  * Plugins register these during onInit via context.registerMiddleware().
@@ -185,6 +185,11 @@ export interface MomentumPlugin {
     onReady?(context: PluginReadyContext): void | Promise<void>;
     /** Called on graceful shutdown. Clean up resources. */
     onShutdown?(context: PluginContext): void | Promise<void>;
+    /**
+     * Admin component overrides and layout slots registered by this plugin.
+     * Merged into the global registries at admin init time.
+     */
+    adminComponents?: AdminComponentsConfig;
     /** Browser-safe import descriptors for the admin config generator.
      *  Tells the generator where to import collections, admin routes, and
      *  modifyCollections from browser-safe sub-paths instead of the main

package/src/lib/versions/version.types.d.ts

@@ -134,6 +134,16 @@ export interface SchedulePublishResult {
     /** Scheduled publish date (ISO string) */
     scheduledPublishAt: string;
 }
+/**
+ * Check if a collection has version drafts enabled.
+ * `versions: true` enables versioning but NOT drafts.
+ * Only `versions: { drafts: true }` (or `{ drafts: { ... } }`) enables drafts.
+ */
+export declare function hasVersionDrafts(collection: {
+    versions?: boolean | {
+        drafts?: boolean | object;
+    };
+}): boolean;
 /**
  * Event data passed to version-related hooks.
  */