@mediusinc/mng-commons 7.3.0 → 7.4.0-rc.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mediusinc/mng-commons",
-  "version": "7.3.0",
+  "version": "7.4.0-rc.0",
   "peerDependencies": {
     "@angular/animations": "^21.0.0",
     "@angular/common": "^21.0.0",

package/types/mediusinc-mng-commons-core.d.ts

@@ -309,10 +309,18 @@ declare class DataProviderInst<Model, Service = any, ServiceClass = ServiceClass
     get isDataProvider(): boolean;
 }
 
+type LookupDataProviderCacheOpts = {
+    ttl?: number;
+    key?: string;
+};
 type LookupDataProviderLookupFnType<Model = any, Service = undefined, Sorts = keyof Model, Filters extends keyof any = keyof Model, ReturnType = ItemOrObservable<Array<Model>>> = (params: DataListParams<Sorts, Filters> | undefined, service: Service, search?: string) => ReturnType;
 interface ILookupDataProviderLookup<Model, Service, Sorts = keyof Model, Filters extends keyof any = keyof Model> {
     lookup: LookupDataProviderLookupFnType<Model, Service, Sorts, Filters>;
+    cacheEnabled?: boolean;
+    cacheKey?: string;
+    cacheTtl?: number;
     withLookup(fn?: LookupDataProviderLookupFnType<Model, Service, Sorts, Filters>): this;
+    withCache(enabled?: boolean, opts?: LookupDataProviderCacheOpts): this;
 }
 type ILookupDataProvider<Model = any, Service = any, Sorts = keyof Model, Filters extends keyof any = keyof Model, ServiceClass = ServiceClassOptType<Service>> = IDataProvider<Model, Service, ServiceClass> & ILookupDataProviderLookup<Model, Service, Sorts, Filters>;
 
@@ -366,6 +374,7 @@ interface ILookupDescriptor<Model, Service = any, Sorts = keyof Model, Filters e
     withOptionsTrackProperty(property: keyof Model): this;
     withOptionsTrackPropertyUnsafe(property: string): this;
     withLookup(lookup: LookupDataProviderLookupFnType<Model, Service, Sorts, Filters>): this;
+    withCache(enabled?: boolean, opts?: LookupDataProviderCacheOpts): this;
 }
 
 interface ITableDescriptor<TableModel, Sorts, Filters> {
@@ -1739,9 +1748,10 @@ declare class Styles {
 
 declare enum CommonsFeatureTypeEnum {
     Layout = 0,
-    Table = 1,
-    Tableview = 2,
-    DataApiAsClassV1 = 3
+    Form = 1,
+    Table = 2,
+    Tableview = 3,
+    DataApiAsClassV1 = 4
 }
 interface CommonsFeature {
     type: CommonsFeatureTypeEnum;
@@ -1750,4 +1760,4 @@ interface CommonsFeature {
 declare function provideCommons(config?: CommonsModuleConfig, ...features: CommonsFeature[]): (Provider | EnvironmentProviders)[];
 
 export { ACommonsErrorBase, APermissions, BROWSER_STORAGE_IT, BooleanPipe, COMMONS_INITIALIZER_IT, COMMONS_MODULE_CONFIG_IT, ClassMapPipe, CommonsConfigurationService, CommonsErrorHandler, CommonsFeatureTypeEnum, CommonsHttpError, CommonsInitEventEnum, CommonsInitService, CommonsInternalError, CommonsRouterService, CommonsService, CommonsStorageService, ComponentDirective, DataProviderInst, EnumName, EnumPipe, EnumerateAsyncPipe, EnumeratePipe, FilterMatchMode, GetterPipe, I18nPropertyPipe, JsonPathPipe, LOG_PUBLISHERS, LogLevelEnum, LogPublisherConsoleService, LoggerService, NotificationWrapperComponent, ParametrizePipe, PermissionService, PermissionTypeEnum, Permissions, RerenderDirective, RouteBuilder, RoutesBuilder, StyleSizeEnum, Styles, TemplateDirective, TemplatePipe, TypeName, TypeRegistry, adjustRouteMenuLazyChildrenRouterLinks, angularDateFormatHasSeconds, angularDateFormatHasTime, appendRoutePathToBasePath, booleanOrUndefinedAttribute, booleanWithDefaultAttribute, commonsActionErrorContextToString, commonsErrorToString, commonsInitializerProvider, copyDataListParams, createChildrenLazyRoute, createLazyRoute, createRoute, createRouteRedirect, createRoutes, dataListParamsFilterToUrlQuery, dataListParamsFilterValueToUrlString, dataListParamsFiltersToUrlQuery, dataListParamsSortToUrlQuery, dataListParamsToUrlQuery, dateToIsoString, defineReflectEnumName, defineReflectTypeName, doesUrlMatchRouterLink, effectWithDeps, errorCauseToString, errorToString, escapeHtml, escapeHtmlAny, findReflectEnumName, findReflectTypeName, findTemplateByName, flattenObjectKeys, fromAngularDateFormatToPrime, fromAngularNumberFormatToFractions, fromEnumConstantsAsValueArray, fromEnumValuesAsValueArray, fromSubscribeError, fromTableLoadToDataListParams, fromUrlQueryToDataListParams, getEnumConstantName, getEnumConstantNameFromObject, getEnumConstantNames, getEnumConstantNamesFromObject, getEnumConstantValues, getEnumConstantValuesAsNumber, getEnumConstantValuesAsString, getEnumerationI18nBaseKey, getErrorLogLevel, getErrorName, getHttpErrorResponse, getHttpErrorResponseStatus, getHttpErrorResponseStatusText, getI18n, getI18nAsync, getI18nErrorParams, getI18nForError, getI18nTypeGroupKey, getI18nTypeKeyBasePath, getI18nTypeName, getI18nTypeNameAsync, getI18nTypeParams, getI18nTypeParamsAsync, getI18nTypePropertyKey, getI18nTypeTabKey, getObjectGetters, getObjectProperties, getObjectPropertyByPath, httpErrorResponseToString, isHttpErrorResponse, isMac, isPermitted, isRbacPermitted, itemIdToDefined, itemIdToNumber, itemIdToString, mapToDataList, mergeDataListParamsWithDefaults, narrowI18nToTranslation, narrowPrimeMessageSeverity, objectDeepCopy, objectDeepMerge, permissionGuard, populateI18nParams, populateI18nTypeParams, provideCommons, reflectEnumNameKey, reflectTypeNameExists, reflectTypeNameKey, removeRouteEmptyPathSegments, selectEnumerationI18n, selectI18n, stringify, throwError, toEnumerationI18nEnumerate, toObservable, toastMessage, valueToDefined };
-export type { ActionData, ActionErrorContextToStringOptionsType, ActionParameters, ArrayItemType, BreadcrumbMenuItem, BreadcrumbType, ClassAttributeDef, ClassFunctionKeyParam1ObjKeyExtendsOfTargetType, ClassFunctionKeysType, ClassFunctionKeysWithAnyArgsAndReturnType, ClassFunctionKeysWithParamAndReturnType, ClassFunctionKeysWithReturnType, ClassOptType, ClassType, ColorScheme, CommonKeyof3, CommonPropsObjType3, CommonsErrorBaseOptions, CommonsFeature, CommonsMenuItem, CommonsModuleConfig, CommonsRouteData, CommonsSerializationConfig, DataListFilter, DataListFilterBaseValueType, DataListFilterFromUrlValueType, DataListFilterValueType, DataListFiltersType, DataListParams, DataListResult, DataListSort, DeepCopyOptions, EnumConstantType, EnumFromProperty, EnumType, EnumValue, EnumeratePipeI18nInternal, ErrorCauseToStringOptionsType, ErrorToStringOptionsBaseType, ErrorToStringOptionsType, ErrorTypes, FilterMatchModeExtendedType, FilterMatchModeType, FilterState, GetterFn, HttpErrorResponseToStringOptionsType, I18nMissingTranslationStrategy, IActionContextValidation, IActionDescriptor, IColumnDescriptor, ICommonsActionError, ICommonsActionErrorContext, ICommonsError, IDataProvider, IEditorDescriptor, IEnumDescriptor, IFilterDescriptor, ILogPublisher, ILoggerService, ILookupDataProvider, ILookupDataProviderLookup, ILookupDescriptor, IModelDescriptor, IPermissionService, ITableDescriptor, ITableviewDescriptor, IUser, IdType, InternalCommonsMenuItem, ItemOrObservable, KeyOfType, KeyofAndOfType, LocalstorageConfigValueType, LogConfig, LogEntry, LookupDataProviderLookupFnType, Nullable, ObjectOptPropType, PrimeMessageSeverityType, PrimitiveType, PropertyType, RegistryEnumMap, RegistryTypeMap, RouteBuilderAdjustFnType, ServiceClassOptType, ServiceClassType, SingleOrArrayType, Undefined, VersionConfig, VersionConfigFromConfiguration, VersionConfigFromHttpResource, VersionConfigFromInfo, VersionConfigType, VersionInfo, toIsoStringDateTimeOptsType, toIsoStringTypeOptType };
+export type { ActionData, ActionErrorContextToStringOptionsType, ActionParameters, ArrayItemType, BreadcrumbMenuItem, BreadcrumbType, ClassAttributeDef, ClassFunctionKeyParam1ObjKeyExtendsOfTargetType, ClassFunctionKeysType, ClassFunctionKeysWithAnyArgsAndReturnType, ClassFunctionKeysWithParamAndReturnType, ClassFunctionKeysWithReturnType, ClassOptType, ClassType, ColorScheme, CommonKeyof3, CommonPropsObjType3, CommonsErrorBaseOptions, CommonsFeature, CommonsMenuItem, CommonsModuleConfig, CommonsRouteData, CommonsSerializationConfig, DataListFilter, DataListFilterBaseValueType, DataListFilterFromUrlValueType, DataListFilterValueType, DataListFiltersType, DataListParams, DataListResult, DataListSort, DeepCopyOptions, EnumConstantType, EnumFromProperty, EnumType, EnumValue, EnumeratePipeI18nInternal, ErrorCauseToStringOptionsType, ErrorToStringOptionsBaseType, ErrorToStringOptionsType, ErrorTypes, FilterMatchModeExtendedType, FilterMatchModeType, FilterState, GetterFn, HttpErrorResponseToStringOptionsType, I18nMissingTranslationStrategy, IActionContextValidation, IActionDescriptor, IColumnDescriptor, ICommonsActionError, ICommonsActionErrorContext, ICommonsError, IDataProvider, IEditorDescriptor, IEnumDescriptor, IFilterDescriptor, ILogPublisher, ILoggerService, ILookupDataProvider, ILookupDataProviderLookup, ILookupDescriptor, IModelDescriptor, IPermissionService, ITableDescriptor, ITableviewDescriptor, IUser, IdType, InternalCommonsMenuItem, ItemOrObservable, KeyOfType, KeyofAndOfType, LocalstorageConfigValueType, LogConfig, LogEntry, LookupDataProviderCacheOpts, LookupDataProviderLookupFnType, Nullable, ObjectOptPropType, PrimeMessageSeverityType, PrimitiveType, PropertyType, RegistryEnumMap, RegistryTypeMap, RouteBuilderAdjustFnType, ServiceClassOptType, ServiceClassType, SingleOrArrayType, Undefined, VersionConfig, VersionConfigFromConfiguration, VersionConfigFromHttpResource, VersionConfigFromInfo, VersionConfigType, VersionInfo, toIsoStringDateTimeOptsType, toIsoStringTypeOptType };

package/types/mediusinc-mng-commons-filter.d.ts

@@ -1,5 +1,5 @@
 import { InputSignal, Type } from '@angular/core';
-import { IFilterDescriptor, FilterMatchModeExtendedType, ILookupDataProvider, ServiceClassType, ILookupDescriptor, LookupDataProviderLookupFnType, EnumValue, EnumConstantType } from '@mediusinc/mng-commons/core';
+import { IFilterDescriptor, FilterMatchModeExtendedType, ILookupDataProvider, ServiceClassType, ILookupDescriptor, LookupDataProviderLookupFnType, LookupDataProviderCacheOpts, EnumValue, EnumConstantType } from '@mediusinc/mng-commons/core';
 import { InputTrimType, LookupDataProviderInst } from '@mediusinc/mng-commons/form/api';
 import { EnumDescriptor } from '@mediusinc/mng-commons/model';
 
@@ -377,6 +377,13 @@ declare class FilterLookupDescriptor<FilterModel, TableModel, Service = any, Fil
      */
     withOptionsTrackPropertyUnsafe(): this;
     withLookup(lookup?: LookupDataProviderLookupFnType<FilterModel, Service, Sorts, Filters>): this;
+    /**
+     * Sets the cache configuration.
+     * @param enabled If cache is enabled. Defaults to true.
+     * @param opts.ttl Time-to-live in seconds.
+     * @param opts.key Key to use for caching. Defaults to data provider instance.
+     */
+    withCache(enabled?: boolean, opts?: LookupDataProviderCacheOpts): this;
     /**
      * Sets the dropdown class name.
      * @param dropdownClassName Class name for dropdown.

package/types/mediusinc-mng-commons-form-api.d.ts

@@ -1,12 +1,25 @@
-import { ServiceClassOptType, DataProviderInst, ILookupDataProvider, LookupDataProviderLookupFnType, ServiceClassType, StyleSizeEnum } from '@mediusinc/mng-commons/core';
+import { ServiceClassOptType, DataProviderInst, ILookupDataProvider, LookupDataProviderLookupFnType, LookupDataProviderCacheOpts, ServiceClassType, StyleSizeEnum } from '@mediusinc/mng-commons/core';
 import { TypeDescriptor, ModelDescriptor } from '@mediusinc/mng-commons/model';
 import { ButtonSeverity } from 'primeng/button';
 
 declare class LookupDataProviderInst<Model, Service = any, Sorts = keyof Model, Filters extends keyof any = keyof Model, ServiceClass = ServiceClassOptType<Service>> extends DataProviderInst<Model, Service, ServiceClass> implements ILookupDataProvider<Model, Service, Sorts, Filters, ServiceClass> {
     protected _lookup: LookupDataProviderLookupFnType<Model, Service, Sorts, Filters>;
+    protected _cacheKey?: string;
+    protected _cacheEnabled?: boolean;
+    protected _cacheTtl?: number;
     constructor(serviceType: ServiceClass);
     get lookup(): LookupDataProviderLookupFnType<Model, Service, Sorts, Filters>;
+    get cacheKey(): string | undefined;
+    get cacheEnabled(): boolean | undefined;
+    get cacheTtl(): number | undefined;
     withLookup(fn: LookupDataProviderLookupFnType<Model, Service, Sorts, Filters>): this;
+    /**
+     * Sets the cache configuration.
+     * @param enabled If cache is enabled. Defaults to true.
+     * @param opts.ttl Time-to-live in seconds.
+     * @param opts.key Key to use for caching. Defaults to data provider instance.
+     */
+    withCache(enabled?: boolean, opts?: LookupDataProviderCacheOpts): this;
 }
 
 /**

package/types/mediusinc-mng-commons-form.d.ts

@@ -1,12 +1,13 @@
 import * as _angular_core from '@angular/core';
-import { ExistingProvider, OnInit } from '@angular/core';
+import { ExistingProvider, OnInit, Provider } from '@angular/core';
 import { ControlValueAccessor, Validator, FormControl, ValidationErrors } from '@angular/forms';
 import { AutoCompleteCompleteEvent, AutoCompleteSelectEvent, AutoCompleteUnselectEvent } from 'primeng/autocomplete';
-import { TemplateDirective, ILookupDataProvider } from '@mediusinc/mng-commons/core';
+import { TemplateDirective, ILookupDataProvider, CommonsFeature } from '@mediusinc/mng-commons/core';
 import { InputTrimType, EmptyValueType } from '@mediusinc/mng-commons/form/api';
 import { MultiSelect, MultiSelectChangeEvent, MultiSelectBlurEvent } from 'primeng/multiselect';
 import { Select, SelectChangeEvent } from 'primeng/select';
 import { InputMask } from 'primeng/inputmask';
+import { Observable } from 'rxjs';
 
 type NameType$4 = 'prepend' | 'append';
 declare class AutocompleteTemplateDirective extends TemplateDirective<NameType$4> {
@@ -21,6 +22,7 @@ declare class AutocompleteComponent implements ControlValueAccessor, OnInit {
     private readonly injector;
     private readonly destroyRef;
     private readonly translate;
+    private readonly labelLookupService;
     private readonly logger;
     dataProvider: _angular_core.InputSignal<ILookupDataProvider<any, any, any, any>>;
     optionsTrackProperty: _angular_core.InputSignal<string | undefined>;
@@ -176,6 +178,7 @@ declare class DropdownComponent implements ControlValueAccessor {
     private readonly injector;
     private readonly destroyRef;
     private readonly translate;
+    private readonly labelLookupService;
     dataProvider: _angular_core.InputSignal<ILookupDataProvider<any, any, any, any> | undefined>;
     options: _angular_core.InputSignal<any[]>;
     optionsTrackProperty: _angular_core.InputSignal<string | undefined>;
@@ -427,4 +430,34 @@ declare class InputTrimDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<InputTrimDirective, "[mngInputTrim]", never, { "mngInputTrim": { "alias": "mngInputTrim"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { AUTOCOMPLETE_VALUE_ACCESSOR, AutocompleteComponent, AutocompleteTemplateDirective, DATETIME_PICKER_VALIDATOR, DATETIME_PICKER_VALUE_ACCESSOR, DATE_RANGE_VALIDATOR, DATE_RANGE_VALUE_ACCESSOR, DROPDOWN_VALUE_ACCESSOR, DateRangeComponent, DateRangeTemplateDirective, DatetimePickerComponent, DatetimePickerTemplateDirective, DropdownComponent, DropdownTemplateDirective, InputEmptyValueDirective, InputTrimDirective, NUMBER_RANGE_VALIDATOR, NUMBER_RANGE_VALUE_ACCESSOR, NumberRangeComponent, NumberRangeTemplateDirective };
+declare class LookupLabelResolutionService {
+    #private;
+    private static readonly IDLE_CLEANUP_TIMEOUT_MS;
+    storeEntry(dataProvider: ILookupDataProvider<any, any, any, any>, valueProperty: string, propertyValue: any, item: any): void;
+    getEntries(dataProvider: ILookupDataProvider<any, any, any, any>, dataProviderService: any, valueProperty: string, propertyValues: any[]): Observable<Array<any>>;
+    clear(opts?: {
+        providerKey?: string;
+    }): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LookupLabelResolutionService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<LookupLabelResolutionService>;
+}
+
+interface FormFeatureConfig {
+    lookupNameResolutionConfigEnabled?: boolean;
+    lookupNameResolutionCleanupInterval?: number;
+}
+
+/**
+ * Prepares providers for usage of the tableview functionalities.
+ *
+ * @returns {CommonsFeature} The `CommonsFeature` object with the layout configuration.
+ */
+declare function withForm(config?: FormFeatureConfig): CommonsFeature;
+/**
+ * Provides a list of providers for configuring a form feature. Useful for lazy-loading form chunk in child (lazy loaded routes).
+ *
+ * @param {FormFeatureConfig} [config] - An optional configuration object for the form feature.
+ */
+declare function provideFormChild(config?: FormFeatureConfig): Provider[];
+
+export { AUTOCOMPLETE_VALUE_ACCESSOR, AutocompleteComponent, AutocompleteTemplateDirective, DATETIME_PICKER_VALIDATOR, DATETIME_PICKER_VALUE_ACCESSOR, DATE_RANGE_VALIDATOR, DATE_RANGE_VALUE_ACCESSOR, DROPDOWN_VALUE_ACCESSOR, DateRangeComponent, DateRangeTemplateDirective, DatetimePickerComponent, DatetimePickerTemplateDirective, DropdownComponent, DropdownTemplateDirective, InputEmptyValueDirective, InputTrimDirective, LookupLabelResolutionService, NUMBER_RANGE_VALIDATOR, NUMBER_RANGE_VALUE_ACCESSOR, NumberRangeComponent, NumberRangeTemplateDirective, provideFormChild, withForm };

package/types/mediusinc-mng-commons-table.d.ts

@@ -658,6 +658,8 @@ declare function generateTableLayoutPrefsKey(typeName: string, url: string, trac
 declare class FilterValuePipe implements PipeTransform, OnDestroy {
     private readonly locale;
     private readonly translate;
+    private readonly labelLookupService;
+    private readonly injector;
     private readonly enumPipe;
     private subscription?;
     subject: ReplaySubject<any>;

package/types/mediusinc-mng-commons-tableview-api.d.ts

@@ -2,7 +2,7 @@ import * as i0 from '@angular/core';
 import { InputSignal, OutputEmitterRef, Type, InputSignalWithTransform, WritableSignal, Injector, InjectionToken } from '@angular/core';
 import { ButtonSeverity } from 'primeng/button';
 import * as _mediusinc_mng_commons_core from '@mediusinc/mng-commons/core';
-import { IdType, ActionData, ActionParameters, GetterFn, PrimeMessageSeverityType, ServiceClassType, ILookupDataProvider, ILookupDescriptor, LookupDataProviderLookupFnType, EnumValue, EnumConstantType, ItemOrObservable, ArrayItemType, ITableviewDescriptor, ITableDescriptor, CommonPropsObjType3, IEditorDescriptor, IDataProvider, Nullable, IActionDescriptor, APermissions, ClassType, ServiceClassOptType, Undefined, DataProviderInst, StyleSizeEnum, DataListResult, CommonsErrorBaseOptions, ACommonsErrorBase, ICommonsActionError, ClassFunctionKeysWithParamAndReturnType, ClassFunctionKeyParam1ObjKeyExtendsOfTargetType, CommonsRouteData } from '@mediusinc/mng-commons/core';
+import { IdType, ActionData, ActionParameters, GetterFn, PrimeMessageSeverityType, ServiceClassType, ILookupDataProvider, ILookupDescriptor, LookupDataProviderLookupFnType, LookupDataProviderCacheOpts, EnumValue, EnumConstantType, ItemOrObservable, ArrayItemType, ITableviewDescriptor, ITableDescriptor, CommonPropsObjType3, IEditorDescriptor, IDataProvider, Nullable, IActionDescriptor, APermissions, ClassType, ServiceClassOptType, Undefined, DataProviderInst, StyleSizeEnum, DataListResult, CommonsErrorBaseOptions, ACommonsErrorBase, ICommonsActionError, ClassFunctionKeysWithParamAndReturnType, ClassFunctionKeyParam1ObjKeyExtendsOfTargetType, CommonsRouteData } from '@mediusinc/mng-commons/core';
 import { IActionButtonDescriptor, InputTrimType, EmptyValueType } from '@mediusinc/mng-commons/form/api';
 import { EnumDescriptor, TypeDescriptor, ModelDescriptor, ModelDescriptorCreateOpts } from '@mediusinc/mng-commons/model';
 import { ToastMessageOptions, Confirmation } from 'primeng/api';
@@ -545,6 +545,13 @@ declare class FieldLookupDescriptor<FieldModel, EditorModel, Service = any, Fiel
     withOptionsTrackProperty(property: keyof FieldModel): this;
     withOptionsTrackPropertyUnsafe(property: string): this;
     withLookup(lookup?: LookupDataProviderLookupFnType<FieldModel, Service, Sorts, Filters>): this;
+    /**
+     * Sets the cache configuration.
+     * @param enabled If cache is enabled. Defaults to true.
+     * @param opts.ttl Time-to-live in seconds.
+     * @param opts.key Key to use for caching. Defaults to data provider instance.
+     */
+    withCache(enabled?: boolean, opts?: LookupDataProviderCacheOpts): this;
     withInputTrim(trimOption?: InputTrimType): this;
     withConfig(config: FieldLookupConfig): this;
     withDialogTitle(title: string | null): this;

package/version-info.json

@@ -1,11 +1,11 @@
 {
     "name": "@mediusinc/mng-commons",
-    "version": "7.3.0",
-    "tag": "v7.3.0",
-    "distance": 0,
-    "hash": "fc869fa8",
+    "version": "7.4.0-rc.0",
+    "tag": "v7.3.0-rc.6",
+    "distance": 7,
+    "hash": "20052183",
     "dirty": true,
-    "semver": "7.3.0+0.gfc869fa8.dirty",
+    "semver": "7.3.0-rc.6+7.g20052183.dirty",
     "buildTimestamp": null,
-    "raw": "v7.3.0-fc869fa8-dirty"
+    "raw": "v7.3.0-rc.6-7-20052183-dirty"
 }