@dflat-core/web 1.0.42 → 1.0.44

package/core-ux/index.d.ts

@@ -25,6 +25,7 @@ export * from './lib/services/modal.service';
 export * from './lib/services/application.service';
 export * from './lib/services/presentation-profile.token';
 export * from './lib/services/selectorMapperBase.service';
+export * from './lib/services/entity-selectors';
 export * from './lib/services/action.service';
 export * from './lib/components/actions/actions.component';
 export * from './lib/components/actions/actions-content.component';

package/core-ux/lib/services/entity-selectors.d.ts

@@ -0,0 +1,37 @@
+import { Injector, Type } from '@angular/core';
+import { EntityDataService } from '@dflat-core/web/core-data';
+/**
+ * Sélecteur d'une entité (champ de formulaire FilterType Custom, dont ModalEntityKey désigne
+ * l'entité) : composant de recherche ouvert en fenêtre modale et service de données dont la
+ * recherche alimente la liste du sélecteur.
+ */
+export interface EntitySelector {
+    /** Clé de l'entité : route de son contrôleur, en minuscule (ex. country). */
+    key: string;
+    /** Composant de recherche de l'entité. */
+    component: Type<any>;
+    /** Libellé de l'entité (titre de la fenêtre de sélection). */
+    title?: string;
+    /** Service de données de l'entité (recherche). */
+    dataService?: Type<EntityDataService<any, any>>;
+}
+/**
+ * Sélecteurs d'entité des modules de l'application. Chaque librairie [module]-ux enregistre ceux
+ * de ses entités, générés par codegenerator (dflat -g ts) dans [module]-components.generated.ts,
+ * dans le constructeur de son module Angular :
+ * `constructor(injector: Injector) { EntitySelectors.register(<Module>GeneratedSelectors, injector); }`.
+ * Le registre est global et garde l'injecteur du module : il sert aussi aux modules chargés à la
+ * demande (loadChildren), dont les services de données ne sont pas visibles de l'injecteur
+ * racine. SelectorMapperServiceBase s'en sert pour toute clé que l'application ne traite pas
+ * elle-même.
+ */
+export declare class EntitySelectors {
+    private static readonly selectors;
+    /** Enregistre des sélecteurs et l'injecteur de leur module (le dernier enregistré l'emporte pour une même clé). */
+    static register(selectors: EntitySelector[], injector?: Injector): void;
+    /** Sélecteur de l'entité de clé `key` (insensible à la casse) et injecteur de son module, sinon undefined. */
+    static find(key: string): {
+        selector: EntitySelector;
+        injector?: Injector;
+    } | undefined;
+}

package/core-ux/lib/services/selectorMapperBase.service.d.ts

@@ -16,9 +16,15 @@ export interface ModalConfig {
 }
 export declare abstract class SelectorMapperServiceBase {
     protected modalService: ModalService;
+    private readonly injector;
     constructor(modalService: ModalService);
     getInputSelectorContext(key: string, title: string, filter?: FilterViewModel, params?: any): IInputSelectorContext;
-    abstract getComponentParams(key: string, params?: any): {
+    /**
+     * Composants et recherche du sélecteur de l'entité de clé `key` : par défaut, le sélecteur
+     * généré de l'entité (EntitySelectors, enregistrés par les librairies [module]-ux). Une
+     * application dérivée traite ses propres clés, puis appelle super.getComponentParams.
+     */
+    getComponentParams(key: string, params?: any): {
         selectionCompType: Type<any>;
         selectionModalTitle?: string;
         creationComType: Type<any>;

package/core-ux/lib/v2/models/contexts/section-context.d.ts

@@ -48,6 +48,18 @@ export declare class SectionContext<P extends EntityViewModel> {
     registerDynamicContainers(containers: ViewContainerRef[]): void;
     private defaultLayoutOverride;
     registerSection<F extends FilterViewModel, T extends EntityViewModel>(name: string, template: Type<ISectionComponent<T>>, config?: ISectionConfig<T, F, P>): ISpecificSectionContext<T, F, P>;
+    /**
+     * Onglet d'une entité liée (relation 1..*), décrit par une section du formulaire par défaut et
+     * enregistré par le composant généré (Base[X]Component.registerFormSections) : liste des
+     * enregistrements de l'entité dont le critère `filterProperty` vaut l'Id de l'enregistrement
+     * sélectionné. Ignoré si le composant spécifique a déjà enregistré un onglet du même titre ou
+     * de la même entité (clé d'entité du composant, ex. variante dérivée du composant généré).
+     */
+    registerRelatedSection<F extends FilterViewModel, T extends EntityViewModel>(name: string, template: Type<ISectionComponent<T>>, filterProperty: keyof F): void;
+    /** Onglets d'entités liées enregistrés par registerRelatedSection (une entité peut en avoir plusieurs, un par clé). */
+    private relatedSections;
+    /** Clé d'entité d'un composant (getEntityKey sans instance, valeur constante), sinon null. */
+    private static getEntityKey;
     getActiveTab(): number;
     renderSection(section: ISpecificSectionContext<any, any, P>, container: ViewContainerRef): void;
     private attachComponentOverrides;

package/fesm2022/dflat-core-web-core-ux.mjs

@@ -2,7 +2,7 @@ import { ApiErrorTypes, FilterType, FilterOperator, CustomFieldTypes, ActionDisp
 import * as i2 from '@angular/common';
 import { CommonModule, Location } from '@angular/common';
 import * as i0 from '@angular/core';
-import { Directive, ContentChild, Component, InjectionToken, ViewChild, Inject, Injectable, HostListener, EventEmitter, forwardRef, Input, Output, ChangeDetectionStrategy, Pipe, ViewChildren, ContentChildren, ViewContainerRef, HostBinding, Host, ElementRef, TemplateRef, signal, computed, inject, LOCALE_ID, Injector, NgModule } from '@angular/core';
+import { Directive, ContentChild, Component, InjectionToken, ViewChild, Inject, Injectable, HostListener, inject, Injector, EventEmitter, forwardRef, Input, Output, ChangeDetectionStrategy, Pipe, ViewChildren, ContentChildren, ViewContainerRef, HostBinding, Host, ElementRef, TemplateRef, signal, computed, LOCALE_ID, NgModule } from '@angular/core';
 import * as i3 from '@angular/forms';
 import { NG_VALUE_ACCESSOR, UntypedFormGroup, UntypedFormControl, Validators, FormGroup, FormControl, FormsModule, ReactiveFormsModule } from '@angular/forms';
 import * as i2$4 from '@angular/router';
@@ -2239,6 +2239,8 @@ class SectionContext {
             facade.layout.setShowActionTitle(false);
             facade.layout.setShowFilterButton(false);
         };
+        /** Onglets d'entités liées enregistrés par registerRelatedSection (une entité peut en avoir plusieurs, un par clé). */
+        this.relatedSections = new Set();
         this.renderedSections = new Set();
         this.lastSelected = [];
         //#region Extended Properties
@@ -2274,6 +2276,30 @@ class SectionContext {
         this.sectionsSubject.next(this.sections.slice());
         return section;
     }
+    /**
+     * Onglet d'une entité liée (relation 1..*), décrit par une section du formulaire par défaut et
+     * enregistré par le composant généré (Base[X]Component.registerFormSections) : liste des
+     * enregistrements de l'entité dont le critère `filterProperty` vaut l'Id de l'enregistrement
+     * sélectionné. Ignoré si le composant spécifique a déjà enregistré un onglet du même titre ou
+     * de la même entité (clé d'entité du composant, ex. variante dérivée du composant généré).
+     */
+    registerRelatedSection(name, template, filterProperty) {
+        const key = SectionContext.getEntityKey(template);
+        if (this.sections.some(s => s.Name === name
+            || (!this.relatedSections.has(s.Name) && !Utilities.IsNil(key) && SectionContext.getEntityKey(s.Template) === key)))
+            return;
+        this.relatedSections.add(name);
+        this.registerSection(name, template, { filterOverride: filterFromId(filterProperty) });
+    }
+    /** Clé d'entité d'un composant (getEntityKey sans instance, valeur constante), sinon null. */
+    static getEntityKey(template) {
+        try {
+            return template?.prototype?.getEntityKey?.call(undefined) ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
     getActiveTab() {
         return this.activeTabIndex;
     }
@@ -3586,9 +3612,32 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.4", ngImpor
             type: Injectable
         }], ctorParameters: () => [] });
 
+/**
+ * Sélecteurs d'entité des modules de l'application. Chaque librairie [module]-ux enregistre ceux
+ * de ses entités, générés par codegenerator (dflat -g ts) dans [module]-components.generated.ts,
+ * dans le constructeur de son module Angular :
+ * `constructor(injector: Injector) { EntitySelectors.register(<Module>GeneratedSelectors, injector); }`.
+ * Le registre est global et garde l'injecteur du module : il sert aussi aux modules chargés à la
+ * demande (loadChildren), dont les services de données ne sont pas visibles de l'injecteur
+ * racine. SelectorMapperServiceBase s'en sert pour toute clé que l'application ne traite pas
+ * elle-même.
+ */
+class EntitySelectors {
+    static { this.selectors = new Map(); }
+    /** Enregistre des sélecteurs et l'injecteur de leur module (le dernier enregistré l'emporte pour une même clé). */
+    static register(selectors, injector) {
+        (selectors ?? []).forEach(selector => EntitySelectors.selectors.set(selector.key.toLowerCase(), { selector, injector }));
+    }
+    /** Sélecteur de l'entité de clé `key` (insensible à la casse) et injecteur de son module, sinon undefined. */
+    static find(key) {
+        return key ? EntitySelectors.selectors.get(key.toLowerCase()) : undefined;
+    }
+}
+
 class SelectorMapperServiceBase {
     constructor(modalService) {
         this.modalService = modalService;
+        this.injector = inject(Injector);
     }
     getInputSelectorContext(key, title, filter = null, params = null) {
         let initialViewModel = {};
@@ -3616,6 +3665,26 @@ class SelectorMapperServiceBase {
             context.selectionModalTitle = title;
         return context;
     }
+    /**
+     * Composants et recherche du sélecteur de l'entité de clé `key` : par défaut, le sélecteur
+     * généré de l'entité (EntitySelectors, enregistrés par les librairies [module]-ux). Une
+     * application dérivée traite ses propres clés, puis appelle super.getComponentParams.
+     */
+    getComponentParams(key, params) {
+        const registered = EntitySelectors.find(key);
+        if (Utilities.IsNil(registered))
+            return undefined;
+        const selector = registered.selector;
+        const injector = registered.injector ?? this.injector;
+        return {
+            selectionCompType: selector.component,
+            selectionModalTitle: Utilities.IsNil(selector.title) ? 'Sélectionner' : `Sélectionner : ${selector.title}`,
+            creationComType: undefined,
+            loadFunction: Utilities.IsNil(selector.dataService)
+                ? undefined
+                : (filter) => injector.get(selector.dataService).search(filter).pipe(map$1(r => r?.Values ?? [])),
+        };
+    }
     getDialogOptions(context, choice) {
         let creationViewModel = {};
         creationViewModel[nameof((component) => component.isModal)] = true;
@@ -11512,14 +11581,30 @@ class SelectorComponent {
     ngAfterViewInit() {
         this.context = this.selectorMapperService
             .getInputSelectorContext(this.field.ModalEntityKey.toLowerCase(), this.field.ModalTitle);
-        this.items$ = this.search$
-            .pipe(debounceTime(200), distinctUntilChanged(), switchMap((keywords) => {
-            let filter = { ...this.field.DataFilter };
-            filter.Take = 10;
-            filter.Offset = 0;
-            filter.Keywords = keywords;
-            return this.context.loadFunction(filter);
-        }));
+        if (Utilities.IsNil(this.context?.loadFunction)) {
+            this.items$ = of([]);
+            return;
+        }
+        // Sélecteur sur la clé étrangère (valeur = Id de l'entité choisie) : l'enregistrement
+        // sélectionné est lu par son Id pour afficher son libellé, même hors de la page chargée.
+        const current$ = this.field.ModalPropertyValue === 'Id' && !Utilities.IsNil(this.control?.value)
+            ? this.context.loadFunction({ ...this.field.DataFilter, Id: this.control.value, Take: 1, Offset: 0 })
+                .pipe(catchError(() => of([])))
+            : of([]);
+        this.items$ = combineLatest([
+            current$,
+            this.search$
+                .pipe(debounceTime(200), distinctUntilChanged(), switchMap((keywords) => {
+                let filter = { ...this.field.DataFilter };
+                filter.Take = 10;
+                filter.Offset = 0;
+                filter.Keywords = keywords;
+                return this.context.loadFunction(filter);
+            }))
+        ]).pipe(map$1(([current, items]) => [
+            ...(current ?? []).filter(c => !(items ?? []).some(i => i?.Id === c?.Id)),
+            ...(items ?? []),
+        ]));
     }
     onSearch(param) {
         // this.page$.next(0);
@@ -16299,5 +16384,5 @@ class SortingState {
  * Generated bundle index. Do not edit.
  */
 
-export { Action, ActionContext, ActionDefinition, ActionHandlerContext, ActionPanelComponent, ActionService, ActionsComponent, ActionsContentComponent, AddclassDirective, AlertDialog, AlertMessage, AlertService, AppConfigService, ApplicationService, BaseArrayParameterTypeComponent, BaseComponent, BaseEditorComponent, BaseFormContext, BaseItemListComponent, BaseParameterTypeComponent, BaseShortcutsDirective, BreadcrumbComponent, CanDeactivateGuard, CellRendererComponent, ChangeDetectionContext, ChangeUtilities, CollapseDirective, ConfirmModalComponent, ConfirmOptions, ContextChoice, CoreUxModule, DataContext, DataGridComponent, DataGridStyleContext, DataListComponent, DatagridCellComponent, DatagridCustomComponent, DefaultDataGridStyleContext, DefaultFilterComponent, DefaultLayoutComponent, DflatBaseComponent, DflatBaseFilterComponent, DialogComponent, DialogComponentParameter, DialogType, DraggableDirective, DroppableDirective, DynamicFieldComponent, DynamicFilterComponent, DynamicFilterExtraComponent, DynamicFilterPanel, DynamicFormComponent, EXTENDED_ACTION_COMPONENT, EditModeDirective, EditorContext, EditorTabComponent, EditorTabSetComponent, EntityConfigContext, EntityFacade, EntityFacadeRegistryService, EntityUpdater, ExportDataModalComponent, ExtendedAction, ExtendedActionComponent, FacadeLoadGuard, FacadeModalService, FieldComponent, FilterContext, FilterFormModalComponent, FilterLifecycleGuard, FilterSummaryComponent, FilterSummaryPanelComponent, FireAuthService, FocusableDirective, FormPasswordComponent, FormWrapper, GridFieldComponent, GridRowComponent, GridStylePipe, HideOnThresholdDirective, IIsCancelWithWarning, ImageComponent, ImageService, InputSelectorComponent, InputSelectorOptions, InputTreeSelectorComponent, InsertionDirective, LayoutContext, LayoutHandlerDirective, LayoutService, LoginLayoutComponent, LogsComponent, MenuComponent, MenuDashboardComponent, MessageSeverity, ModalService, ModalStateService, NewEditorComponent, NewPaginatorComponent, OldDataPageComponent, OldLayoutHandlerDirective, OnEnterDirective, OrderableModalComponent, OrderableModalService, PP_SERVICE, PageLayoutComponent, PaginatorComponent, ParameterFieldComponent, ParameterTypeBoolArrayComponent, ParameterTypeBoolComponent, ParameterTypeDateArrayComponent, ParameterTypeDateComponent, ParameterTypeNumberArrayComponent, ParameterTypeNumberComponent, ParameterTypePasswordComponent, ParameterTypeTextArrayComponent, ParameterTypeTextComponent, PropertyChangeBus, PropertyEditorComponent, PropertyGridComponent, ROOT_DEPS, RowRefDirective, RowRefHost, RowRegistry, SearchResultsComponent, SectionContext, SelectionContext, SelectionService, SelectionStyler, SelectorComponent, SelectorDataSource, SelectorMapperServiceBase, SelectorRegistry, SortableColumnComponent, SortingState, StandardPageLayoutComponent, TRACK_RECORD_MODAL_COMPONENT, Tab, TabHeadingDirective, TabTranscludeDirective, Tabset, TestService, TextViewerComponent, TimePickerComponent, ToDefinePipe, ToFixedSizeIntegerPipe, TooltipDirective, TrackRecordModalComponent, TreeComponent, ValidateOnEnterDirective, ValidationErrorComponent, ValidationModalComponent, ValidationService, ViewModeDirective, ViewModelLoaderService, WizardComponent, WizardStepComponent, downloadFile, filterFromId, layoutKeyToString, normalisedOrder };
+export { Action, ActionContext, ActionDefinition, ActionHandlerContext, ActionPanelComponent, ActionService, ActionsComponent, ActionsContentComponent, AddclassDirective, AlertDialog, AlertMessage, AlertService, AppConfigService, ApplicationService, BaseArrayParameterTypeComponent, BaseComponent, BaseEditorComponent, BaseFormContext, BaseItemListComponent, BaseParameterTypeComponent, BaseShortcutsDirective, BreadcrumbComponent, CanDeactivateGuard, CellRendererComponent, ChangeDetectionContext, ChangeUtilities, CollapseDirective, ConfirmModalComponent, ConfirmOptions, ContextChoice, CoreUxModule, DataContext, DataGridComponent, DataGridStyleContext, DataListComponent, DatagridCellComponent, DatagridCustomComponent, DefaultDataGridStyleContext, DefaultFilterComponent, DefaultLayoutComponent, DflatBaseComponent, DflatBaseFilterComponent, DialogComponent, DialogComponentParameter, DialogType, DraggableDirective, DroppableDirective, DynamicFieldComponent, DynamicFilterComponent, DynamicFilterExtraComponent, DynamicFilterPanel, DynamicFormComponent, EXTENDED_ACTION_COMPONENT, EditModeDirective, EditorContext, EditorTabComponent, EditorTabSetComponent, EntityConfigContext, EntityFacade, EntityFacadeRegistryService, EntitySelectors, EntityUpdater, ExportDataModalComponent, ExtendedAction, ExtendedActionComponent, FacadeLoadGuard, FacadeModalService, FieldComponent, FilterContext, FilterFormModalComponent, FilterLifecycleGuard, FilterSummaryComponent, FilterSummaryPanelComponent, FireAuthService, FocusableDirective, FormPasswordComponent, FormWrapper, GridFieldComponent, GridRowComponent, GridStylePipe, HideOnThresholdDirective, IIsCancelWithWarning, ImageComponent, ImageService, InputSelectorComponent, InputSelectorOptions, InputTreeSelectorComponent, InsertionDirective, LayoutContext, LayoutHandlerDirective, LayoutService, LoginLayoutComponent, LogsComponent, MenuComponent, MenuDashboardComponent, MessageSeverity, ModalService, ModalStateService, NewEditorComponent, NewPaginatorComponent, OldDataPageComponent, OldLayoutHandlerDirective, OnEnterDirective, OrderableModalComponent, OrderableModalService, PP_SERVICE, PageLayoutComponent, PaginatorComponent, ParameterFieldComponent, ParameterTypeBoolArrayComponent, ParameterTypeBoolComponent, ParameterTypeDateArrayComponent, ParameterTypeDateComponent, ParameterTypeNumberArrayComponent, ParameterTypeNumberComponent, ParameterTypePasswordComponent, ParameterTypeTextArrayComponent, ParameterTypeTextComponent, PropertyChangeBus, PropertyEditorComponent, PropertyGridComponent, ROOT_DEPS, RowRefDirective, RowRefHost, RowRegistry, SearchResultsComponent, SectionContext, SelectionContext, SelectionService, SelectionStyler, SelectorComponent, SelectorDataSource, SelectorMapperServiceBase, SelectorRegistry, SortableColumnComponent, SortingState, StandardPageLayoutComponent, TRACK_RECORD_MODAL_COMPONENT, Tab, TabHeadingDirective, TabTranscludeDirective, Tabset, TestService, TextViewerComponent, TimePickerComponent, ToDefinePipe, ToFixedSizeIntegerPipe, TooltipDirective, TrackRecordModalComponent, TreeComponent, ValidateOnEnterDirective, ValidationErrorComponent, ValidationModalComponent, ValidationService, ViewModeDirective, ViewModelLoaderService, WizardComponent, WizardStepComponent, downloadFile, filterFromId, layoutKeyToString, normalisedOrder };
 //# sourceMappingURL=dflat-core-web-core-ux.mjs.map