@momentumcms/admin 0.5.3 → 0.5.5

package/types/momentumcms-admin.d.ts

@@ -1,13 +1,14 @@
 import { Routes, CanActivateFn, CanDeactivateFn } from '@angular/router';
 import * as _angular_core from '@angular/core';
 import { Type, InjectionToken, Signal, Provider, OnInit, WritableSignal, makeEnvironmentProviders } from '@angular/core';
-import { CollectionConfig, GlobalConfig, PluginAdminRouteDescriptor, MomentumPlugin, MomentumConfig, MomentumAdminConfig, MediaDocument, AdminConfig, ImageSizeConfig, Field, DocumentStatus as DocumentStatus$1, BlockConfig, UploadField } from '@momentumcms/core';
+import { CollectionConfig, GlobalConfig, PluginAdminRouteDescriptor, MomentumPlugin, AdminComponentsConfig, MomentumConfig, MomentumAdminConfig, MediaDocument, DocumentStatus as DocumentStatus$1, AdminConfig, ImageSizeConfig, Field, BlockConfig, UploadField } from '@momentumcms/core';
 import { HttpContextToken, HttpInterceptorFn } from '@angular/common/http';
 import { Observable } from 'rxjs';
 import * as _momentumcms_admin from '@momentumcms/admin';
 import { DataTableColumn, DataTableSort, DataTableRowAction, DataTableRowActionEvent, FieldDisplayType, FieldDisplayFieldMeta, FieldDisplayNumberFormat, FieldDisplayDateFormat, PopoverTrigger, ValidationError, SelectOption } from '@momentumcms/ui';
 import * as _angular_forms_signals from '@angular/forms/signals';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
+import * as dist_libs_core_src from 'dist/libs/core/src';
 
 /**
  * Momentum Admin Routes Factory
@@ -77,6 +78,8 @@ interface MomentumAdminRouteData {
     globals?: GlobalConfig[];
     branding?: MomentumAdminBranding;
     pluginRoutes?: AdminPluginRoute[];
+    adminComponents?: AdminComponentsConfig;
+    plugins?: MomentumPlugin[];
 }
 /**
  * Creates Angular routes for the Momentum CMS admin UI.
@@ -638,7 +641,7 @@ interface CollectionOperationsServer<T = Record<string, unknown>> {
     findById(id: string, options?: {
         depth?: number;
         withDeleted?: boolean;
-    }): Promise<T | null>;
+    }): Promise<T>;
     create(data: Partial<T>): Promise<T>;
     update(id: string, data: Partial<T>): Promise<T>;
     delete(id: string): Promise<DeleteResult>;
@@ -695,7 +698,7 @@ interface MomentumClientAPI {
  */
 interface MomentumCollectionAPI<T = Record<string, unknown>> {
     find$(options?: FindOptions): Observable<FindResult<T>>;
-    findById$(id: string, options?: FindByIdOptions): Observable<T | null>;
+    findById$(id: string, options?: FindByIdOptions): Observable<T>;
     create$(data: Partial<T>): Observable<T>;
     update$(id: string, data: Partial<T>): Observable<T>;
     delete$(id: string): Observable<DeleteResult>;
@@ -708,7 +711,7 @@ interface MomentumCollectionAPI<T = Record<string, unknown>> {
     }[]): Observable<T[]>;
     batchDelete$(ids: string[]): Observable<DeleteResult[]>;
     find(options?: FindOptions): Promise<FindResult<T>>;
-    findById(id: string, options?: FindByIdOptions): Promise<T | null>;
+    findById(id: string, options?: FindByIdOptions): Promise<T>;
     create(data: Partial<T>): Promise<T>;
     update(id: string, data: Partial<T>): Promise<T>;
     delete(id: string): Promise<DeleteResult>;
@@ -1388,6 +1391,9 @@ interface HasUnsavedChanges {
 }
 /**
  * Route guard that prompts the user before navigating away from a dirty form.
+ *
+ * Defensive: checks that the component implements HasUnsavedChanges before calling.
+ * This is necessary because AdminPageResolver wraps the actual page component.
  */
 declare const unsavedChangesGuard: CanDeactivateFn<HasUnsavedChanges>;
 
@@ -1638,6 +1644,8 @@ declare class AdminShellComponent implements OnInit {
     private readonly auth;
     private readonly collectionAccess;
     private readonly sidebar;
+    private readonly componentRegistry;
+    private readonly slotRegistry;
     readonly entitySheet: EntitySheetService;
     /** All collections from route data */
     private readonly allCollections;
@@ -1850,6 +1858,8 @@ declare class EntityListWidget<T extends Entity = Entity> {
     private readonly route;
     /** Template ref for complex cell rendering (group, array, json). */
     private readonly complexCellTemplate;
+    /** Template ref for badge cell rendering (_status column). */
+    private readonly badgeCellTemplate;
     /** The collection configuration */
     readonly collection: _angular_core.InputSignal<CollectionConfig>;
     /** Base path for entity routes */
@@ -1909,8 +1919,16 @@ declare class EntityListWidget<T extends Entity = Entity> {
     readonly selectedEntities: _angular_core.WritableSignal<T[]>;
     readonly searchQuery: _angular_core.ModelSignal<string>;
     readonly viewingTrash: _angular_core.WritableSignal<boolean>;
+    readonly statusFilter: _angular_core.WritableSignal<DocumentStatus$1 | null>;
+    /** Status filter options for versioned collections */
+    readonly statusFilterOptions: {
+        label: string;
+        value: DocumentStatus$1 | null;
+    }[];
     /** Whether the collection has soft delete enabled */
     readonly hasSoftDelete: _angular_core.Signal<boolean>;
+    /** Whether the collection has versioning with drafts enabled */
+    readonly hasVersioning: _angular_core.Signal<boolean>;
     /** Computed collection label */
     readonly collectionLabel: _angular_core.Signal<string>;
     /** Computed collection label singular */
@@ -1949,6 +1967,13 @@ declare class EntityListWidget<T extends Entity = Entity> {
      * Format a value based on its type.
      */
     private formatValue;
+    /**
+     * Look up a badge configuration from a column's badgeMap.
+     */
+    getBadgeConfig(value: unknown, column: EntityListColumn<T>): {
+        label: string;
+        variant: 'default' | 'secondary' | 'destructive' | 'outline';
+    } | null;
     /**
      * Generate a brief summary string for complex field values (group, array, json).
      */
@@ -1989,6 +2014,10 @@ declare class EntityListWidget<T extends Entity = Entity> {
      * Toggle between active and trash views.
      */
     toggleTrashView(): void;
+    /**
+     * Set the status filter for versioned collections.
+     */
+    setStatusFilter(status: DocumentStatus$1 | null): void;
     /**
      * Handle create button click.
      */
@@ -2581,6 +2610,8 @@ declare class EntityFormWidget<T extends Entity = Entity> {
     readonly canEdit: _angular_core.Signal<boolean>;
     /** Whether collection has versioning with drafts enabled */
     readonly hasVersioning: _angular_core.Signal<boolean>;
+    /** Current document status (from form model or default to 'draft') */
+    readonly documentStatus: _angular_core.Signal<DocumentStatus$1>;
     /** Whether draft save is available (edit mode with existing entity) */
     readonly canSaveDraft: _angular_core.Signal<boolean>;
     constructor();
@@ -2637,6 +2668,10 @@ declare class EntityFormWidget<T extends Entity = Entity> {
      * Switch from view to edit mode.
      */
     switchToEdit(): void;
+    /**
+     * Handle status change from publish controls.
+     */
+    onStatusChanged(status: DocumentStatus$1): void;
     /**
      * Handle version restore — reload the entity data.
      */
@@ -3438,6 +3473,195 @@ declare function provideMomentumFieldRenderers(): ReturnType<typeof makeEnvironm
  */
 declare function provideFieldRenderer(type: string, loader: () => Promise<Type<unknown>>): ReturnType<typeof makeEnvironmentProviders>;
 
+type Loader$1 = () => Promise<unknown>;
+/**
+ * Registry for swappable admin page components.
+ *
+ * Maps page keys (e.g., 'dashboard', 'collection-list') to lazy component loaders.
+ * Per-collection overrides use the pattern: 'collections/{slug}/{type}'.
+ *
+ * Resolution chain: per-collection → global → undefined (use built-in default).
+ */
+declare class AdminComponentRegistry {
+    private readonly components;
+    /** Register a lazy loader for a page key. Later registrations override earlier ones. */
+    register(key: string, loader: Loader$1): void;
+    /** Get the lazy loader for a page key. Returns undefined if not registered. */
+    get(key: string): Loader$1 | undefined;
+    /** Check if a page key has a registered component. */
+    has(key: string): boolean;
+    /**
+     * Resolve a component loader with per-collection fallback.
+     *
+     * For collection pages, tries `collections/{slug}/{type}` first,
+     * then falls back to the global key (e.g., 'collection-list').
+     */
+    resolve(key: string, slug?: string): Loader$1 | undefined;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AdminComponentRegistry, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AdminComponentRegistry>;
+}
+
+type Loader = () => Promise<unknown>;
+/**
+ * Registry for admin layout slot components.
+ *
+ * Slots are additive — multiple components can be registered for the same slot key.
+ * Per-collection slots use the pattern: `{base-slot}:{collection-slug}`.
+ *
+ * Resolution merges global + per-collection loaders (global first).
+ *
+ * The registry is signal-aware: `resolve()` reads an internal version signal,
+ * so Angular effects that call `resolve()` will re-run when new slots are registered.
+ */
+declare class AdminSlotRegistry {
+    private readonly slots;
+    /** Incremented on every register() so signal-based consumers re-evaluate. */
+    private readonly _version;
+    /** Register a lazy loader for a slot. Multiple loaders per slot are supported. Duplicate loaders are skipped. */
+    register(slot: string, loader: Loader): void;
+    /** Get all loaders for a slot key. Returns empty array if none registered. */
+    getAll(slot: string): Loader[];
+    /** Check if a slot has any registered loaders. */
+    has(slot: string): boolean;
+    /**
+     * Resolve slot loaders, merging global and per-collection entries.
+     *
+     * Reads the internal version signal so Angular effects tracking this call
+     * will re-run when new slots are registered.
+     */
+    resolve(slot: string, slug?: string): Loader[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AdminSlotRegistry, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AdminSlotRegistry>;
+}
+
+/** Lazy loader that returns an Angular component class. */
+type ComponentLoader = () => Promise<Type<unknown>>;
+/**
+ * Keys for swappable admin pages.
+ * Used in AdminComponentRegistry to replace built-in pages.
+ *
+ * Resolution chain for collection pages:
+ *   per-collection key (e.g. "collections/articles/list")
+ *   → global key (e.g. "collection-list")
+ *   → built-in default
+ */
+type AdminComponentKey = 'dashboard' | 'login' | 'media' | 'collection-list' | 'collection-edit' | 'collection-view' | 'global-edit';
+/**
+ * Keys for named layout slots in admin pages.
+ * Slots are additive — multiple components can be registered for the same slot.
+ *
+ * Per-collection variants use the pattern: `{base-slot}:{collection-slug}`
+ * e.g. `collection-list:before:articles`
+ */
+type AdminSlotKey = 'shell:header' | 'shell:footer' | 'shell:nav-start' | 'shell:nav-end' | 'dashboard:before' | 'dashboard:after' | 'collection-list:before' | 'collection-list:after' | 'collection-edit:before' | 'collection-edit:after' | 'collection-edit:sidebar' | 'collection-view:before' | 'collection-view:after' | 'login:before' | 'login:after' | `${'collection-list' | 'collection-edit' | 'collection-view'}:${'before' | 'after' | 'sidebar'}:${string}`;
+/**
+ * Context passed to slot components via input bindings.
+ * Available as inputs on any component rendered in a slot.
+ */
+interface AdminSlotContext {
+    /** The collection config, if the slot is within a collection page. */
+    collection?: CollectionConfig;
+    /** The entity ID, if the slot is within an entity view/edit page. */
+    entityId?: string;
+}
+
+/**
+ * Register a custom admin page component override.
+ *
+ * ```typescript
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideAdminComponent('dashboard', () =>
+ *       import('./custom-dashboard.component').then(m => m.CustomDashboard)
+ *     ),
+ *   ],
+ * };
+ * ```
+ */
+declare function provideAdminComponent(key: string, loader: ComponentLoader): ReturnType<typeof makeEnvironmentProviders>;
+/**
+ * Register a component into an admin layout slot.
+ *
+ * ```typescript
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideAdminSlot('dashboard:before', () =>
+ *       import('./welcome-banner.component').then(m => m.WelcomeBanner)
+ *     ),
+ *   ],
+ * };
+ * ```
+ */
+declare function provideAdminSlot(slot: string, loader: ComponentLoader): ReturnType<typeof makeEnvironmentProviders>;
+/**
+ * Read AdminComponentsConfig and CollectionAdminComponentsConfig from config
+ * and register them into AdminComponentRegistry and AdminSlotRegistry.
+ *
+ * Called once in AdminShellComponent.ngOnInit() after route data is available.
+ */
+declare function registerConfigComponents(collections: CollectionConfig[], adminComponents: AdminComponentsConfig | undefined, componentRegistry: AdminComponentRegistry, slotRegistry: AdminSlotRegistry): void;
+
+/**
+ * Renders all components registered for a named admin layout slot.
+ *
+ * Usage:
+ * ```html
+ * <mcms-admin-slot slot="dashboard:before" />
+ * <mcms-admin-slot slot="collection-list:before" [collectionSlug]="slug" />
+ * ```
+ */
+declare class AdminSlotOutlet {
+    private readonly registry;
+    /** The slot key to render (e.g., 'dashboard:before'). */
+    readonly slot: _angular_core.InputSignal<string>;
+    /** Optional collection slug for per-collection slot resolution. */
+    readonly collectionSlug: _angular_core.InputSignal<string | undefined>;
+    /** Optional context passed as inputs to slot components. */
+    readonly context: _angular_core.InputSignal<AdminSlotContext>;
+    /** Resolved component types after lazy loading. */
+    readonly resolvedComponents: _angular_core.WritableSignal<Type<unknown>[]>;
+    /** Inputs to pass to each slot component. */
+    readonly slotInputs: _angular_core.Signal<{
+        collection?: dist_libs_core_src.CollectionConfig;
+        entityId?: string;
+    }>;
+    /** Incremented on every effect run to detect stale promise resolutions. */
+    private loadGeneration;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AdminSlotOutlet, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AdminSlotOutlet, "mcms-admin-slot", never, { "slot": { "alias": "slot"; "required": true; "isSignal": true; }; "collectionSlug": { "alias": "collectionSlug"; "required": false; "isSignal": true; }; "context": { "alias": "context"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Registry-aware page resolver that delegates to either a registered
+ * custom component or the built-in fallback.
+ *
+ * Used as the `loadComponent` for every admin route. Route `data` provides:
+ * - `adminPageKey` — the registry key (e.g., 'dashboard', 'collection-list')
+ * - `adminPageFallback` — lazy loader for the built-in default
+ *
+ * For collection pages, reads `:slug` from route params to check per-collection overrides.
+ *
+ * Subscribes to route observables so the component re-resolves when Angular
+ * reuses the instance for sibling routes (e.g., navigating between collections).
+ *
+ * Implements HasUnsavedChanges to delegate to the resolved component for
+ * the unsaved changes guard.
+ */
+declare class AdminPageResolver implements OnInit, HasUnsavedChanges {
+    private readonly registry;
+    private readonly route;
+    private readonly destroyRef;
+    private readonly outlet;
+    readonly resolvedComponent: _angular_core.WritableSignal<Type<unknown> | null>;
+    /** Incremented on every load to detect stale promise resolutions. */
+    private loadGeneration;
+    ngOnInit(): void;
+    hasUnsavedChanges(): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AdminPageResolver, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AdminPageResolver, "mcms-admin-page-resolver", never, {}, {}, never, never, true, never>;
+}
+
 /**
  * Dynamic field renderer that resolves components lazily from the registry.
  *
@@ -3464,7 +3688,7 @@ declare class FieldRenderer {
     /** Error from lazy loading failure */
     readonly loadError: _angular_core.WritableSignal<Error | null>;
     /** Registry key: maps field type + editor config to renderer registry keys */
-    readonly registryKey: _angular_core.Signal<"number" | "text" | "textarea" | "richText" | "date" | "checkbox" | "select" | "radio" | "email" | "password" | "upload" | "relationship" | "array" | "group" | "blocks" | "json" | "point" | "slug" | "tabs" | "collapsible" | "row" | "blocks-visual" | "json-email-builder" | "json-form-builder">;
+    readonly registryKey: _angular_core.Signal<"number" | "slug" | "email" | "json" | "text" | "textarea" | "richText" | "date" | "checkbox" | "select" | "radio" | "password" | "upload" | "relationship" | "array" | "group" | "blocks" | "point" | "tabs" | "collapsible" | "row" | "blocks-visual" | "json-email-builder" | "json-form-builder">;
     /** Inputs to pass to the dynamically loaded component via NgComponentOutlet */
     readonly rendererInputs: _angular_core.Signal<{
         field: Field;
@@ -3509,7 +3733,7 @@ declare class TextFieldRenderer {
     /** Whether to use textarea */
     readonly isTextarea: _angular_core.Signal<boolean>;
     /** Input type (text, email, etc.) */
-    readonly inputType: _angular_core.Signal<"text" | "email">;
+    readonly inputType: _angular_core.Signal<"email" | "text">;
     /** Number of rows for textarea */
     readonly rows: _angular_core.Signal<number>;
     /** String value from FieldState */
@@ -3903,5 +4127,5 @@ declare class MediaPickerDialog {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MediaPickerDialog, "mcms-media-picker-dialog", never, {}, {}, never, never, true, never>;
 }
 
-export { AdminShellComponent, AdminSidebarWidget, BlockEditDialog, BlockInserterComponent, BlockWrapperComponent, CheckboxFieldRenderer, CollectionAccessService, CollectionCardWidget, CollectionEditPage, CollectionListPage, CollectionViewPage, DashboardPage, DateFieldRenderer, EntityFormWidget, EntityListWidget, EntitySheetService, EntityViewWidget, FeedbackService, FieldRenderer, FieldRendererRegistry, ForgotPasswordFormComponent, ForgotPasswordPage, LivePreviewComponent, LoginPage, MOMENTUM_API, MOMENTUM_API_CONTEXT, McmsThemeService, MediaLibraryPage, MediaPickerDialog, MediaPreviewComponent, MomentumApiService, MomentumAuthService, NumberFieldRenderer, PublishControlsWidget, ResetPasswordFormComponent, ResetPasswordPage, SHEET_QUERY_PARAMS, SKIP_AUTO_TOAST, SelectFieldRenderer, SetupPage, TextFieldRenderer, UploadFieldRenderer, UploadService, VersionHistoryWidget, VersionService, VisualBlockEditorComponent, adminGuard, authGuard, collectionAccessGuard, crudToastInterceptor, getFieldNodeState, getSubNode, getTitleField, guestGuard, injectHasAnyRole, injectHasRole, injectIsAdmin, injectIsAuthenticated, injectMomentumAPI, injectTypedMomentumAPI, injectUser, injectUserRole, injectVersionService, momentumAdminRoutes, provideFieldRenderer, provideMomentumAPI, provideMomentumFieldRenderers, setupGuard, unsavedChangesGuard };
-export type { AdminBranding, AdminNavItem, AdminNavSection, AdminPluginRoute, AdminUser, AuthResult, AuthSession, AuthUser, BaseUser, BlockEditDialogData, BlockItem, BreadcrumbItem, CollectionGroup, CollectionPermissions, CollectionWithCount, DeleteResult, DeviceSize, DocumentStatus, DocumentVersionParsed, DraftSaveResult, Entity, EntityAction, EntityFormMode, EntityListActionEvent, EntityListBulkActionEvent, EntityListColumn, EntityListFindResult, EntitySheetResult, EntityViewActionEvent, EntityViewFieldConfig, FieldNodeState, FindByIdOptions, FindOptions, FindResult, HasUnsavedChanges, McmsTheme, MediaPickerDialogData, MediaPickerResult, MediaPreviewData, MomentumAPIContext, MomentumAPIServer, MomentumAdminBranding, MomentumAdminOptions, MomentumAdminRouteData, MomentumClientAPI, MomentumCollectionAPI, PublishResult, RestoreResult, RestoreVersionOptions, SetupStatus, StatusResult, TypedCollectionAPI, TypedFindByIdOptions, TypedFindOptions, TypedMomentumClientAPI, UploadProgress, UserContext, VersionFindOptions, VersionQueryResult, VisualEditorState };
+export { AdminComponentRegistry, AdminPageResolver, AdminShellComponent, AdminSidebarWidget, AdminSlotOutlet, AdminSlotRegistry, BlockEditDialog, BlockInserterComponent, BlockWrapperComponent, CheckboxFieldRenderer, CollectionAccessService, CollectionCardWidget, CollectionEditPage, CollectionListPage, CollectionViewPage, DashboardPage, DateFieldRenderer, EntityFormWidget, EntityListWidget, EntitySheetService, EntityViewWidget, FeedbackService, FieldRenderer, FieldRendererRegistry, ForgotPasswordFormComponent, ForgotPasswordPage, LivePreviewComponent, LoginPage, MOMENTUM_API, MOMENTUM_API_CONTEXT, McmsThemeService, MediaLibraryPage, MediaPickerDialog, MediaPreviewComponent, MomentumApiService, MomentumAuthService, NumberFieldRenderer, PublishControlsWidget, ResetPasswordFormComponent, ResetPasswordPage, SHEET_QUERY_PARAMS, SKIP_AUTO_TOAST, SelectFieldRenderer, SetupPage, TextFieldRenderer, UploadFieldRenderer, UploadService, VersionHistoryWidget, VersionService, VisualBlockEditorComponent, adminGuard, authGuard, collectionAccessGuard, crudToastInterceptor, getFieldNodeState, getSubNode, getTitleField, guestGuard, injectHasAnyRole, injectHasRole, injectIsAdmin, injectIsAuthenticated, injectMomentumAPI, injectTypedMomentumAPI, injectUser, injectUserRole, injectVersionService, momentumAdminRoutes, provideAdminComponent, provideAdminSlot, provideFieldRenderer, provideMomentumAPI, provideMomentumFieldRenderers, registerConfigComponents, setupGuard, unsavedChangesGuard };
+export type { AdminBranding, AdminComponentKey, AdminNavItem, AdminNavSection, AdminPluginRoute, AdminSlotContext, AdminSlotKey, AdminUser, AuthResult, AuthSession, AuthUser, BaseUser, BlockEditDialogData, BlockItem, BreadcrumbItem, CollectionGroup, CollectionPermissions, CollectionWithCount, ComponentLoader, DeleteResult, DeviceSize, DocumentStatus, DocumentVersionParsed, DraftSaveResult, Entity, EntityAction, EntityFormMode, EntityListActionEvent, EntityListBulkActionEvent, EntityListColumn, EntityListFindResult, EntitySheetResult, EntityViewActionEvent, EntityViewFieldConfig, FieldNodeState, FindByIdOptions, FindOptions, FindResult, HasUnsavedChanges, McmsTheme, MediaPickerDialogData, MediaPickerResult, MediaPreviewData, MomentumAPIContext, MomentumAPIServer, MomentumAdminBranding, MomentumAdminOptions, MomentumAdminRouteData, MomentumClientAPI, MomentumCollectionAPI, PublishResult, RestoreResult, RestoreVersionOptions, SetupStatus, StatusResult, TypedCollectionAPI, TypedFindByIdOptions, TypedFindOptions, TypedMomentumClientAPI, UploadProgress, UserContext, VersionFindOptions, VersionQueryResult, VisualEditorState };