@sumaris-net/ngx-components 18.22.13 → 18.22.15

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sumaris-net/ngx-components",
   "description": "SUMARiS Angular components",
-  "version": "18.22.13",
+  "version": "18.22.15",
   "author": "contact@e-is.pro",
   "license": "AGPL-3.0",
   "readmeFilename": "README.md",

package/public_api.d.ts

@@ -115,6 +115,7 @@ export * from './src/app/shared/debug/debug-service.class';
 export * from './src/app/shared/types';
 export * from './src/app/shared/dates';
 export * from './src/app/shared/functions';
+export * from './src/app/shared/focusable';
 export * from './src/app/shared/regexps';
 export * from './src/app/shared/services';
 export * from './src/app/shared/forms';

package/src/app/shared/inputs.d.ts

@@ -17,7 +17,7 @@ export interface InputElement extends FocusableElement {
 }
 export declare function isInputElement(object: any): object is InputElement;
 export declare function asInputElement<T = any>(object: ElementRef<T>): InputElement | undefined;
-export declare function tabindexComparator(a: InputElement, b: InputElement): 1 | 0 | -1;
+export declare function tabindexComparator(a: InputElement, b: InputElement): 0 | 1 | -1;
 export interface CanGainFocusOptions {
     minTabindex?: number;
     maxTabindex?: number;

package/src/app/shared/observables.d.ts

@@ -12,12 +12,14 @@ export declare interface WaitForOptions extends FirstOptions {
 export declare function filterNotNil<T = any>(obs: Observable<T>): Observable<T>;
 export declare function filterTrue(obs: Observable<boolean>): Observable<boolean>;
 export declare function filterFalse(obs: Observable<boolean>): Observable<boolean>;
+export declare function decorateWithTakeUntil<T = any>(obs: Observable<T>, opts?: FirstOptions): Observable<T>;
 export declare function firstNotNil<T = any>(obs: Observable<T>, opts?: FirstOptions): Observable<T>;
 export declare function firstTrue<T = void>(obs: Observable<boolean>, opts?: FirstOptions, result?: T): Observable<T>;
 export declare function firstFalse<T = void>(obs: Observable<boolean>, opts?: FirstOptions, result?: T): Observable<T>;
 export declare function firstTruePromise(obs: Observable<boolean>, opts?: FirstOptions): Promise<void>;
 export declare function firstFalsePromise(obs: Observable<boolean>, opts?: FirstOptions): Promise<void>;
 export declare function firstNotNilPromise<T = any>(obs: Observable<T>, opts?: FirstOptions): Promise<T>;
+export declare function firstPromise<T = any>(obs: Observable<T>, opts?: FirstOptions): Promise<T>;
 export declare function chainPromises<T = any>(defers: (() => Promise<any>)[]): Promise<T[]>;
 /**
  * Wait form a predicate return true. This need to implement AppFormUtils.waitWhilePending(), AppFormUtils.waitIdle()

package/src/app/shared/services/memory-entity-service.class.d.ts

@@ -18,27 +18,34 @@ export interface InMemoryEntitiesServiceOptions<T, F> {
         [key: string]: string;
     };
 }
-export declare class InMemoryEntitiesService<T extends IEntity<T, ID>, F = any, ID = number, O extends EntitiesServiceWatchOptions = EntitiesServiceWatchOptions> extends StartableObservableService<T[], T[]> implements IEntitiesService<T, F, O>, OnDestroy {
+export declare class InMemoryEntitiesService<T extends IEntity<T, ID>, F = any, ID = number, O extends EntitiesServiceWatchOptions = EntitiesServiceWatchOptions, SO extends InMemoryEntitiesServiceOptions<T, F> = InMemoryEntitiesServiceOptions<T, F>> extends StartableObservableService<T[], T[]> implements IEntitiesService<T, F, O>, OnDestroy {
     protected dataType: new () => T;
     protected filterType: new () => F;
     debug: boolean;
     private _hiddenData;
     readonly dirtySubject: BehaviorSubject<boolean>;
     readonly savingSubject: BehaviorSubject<boolean>;
-    protected readonly sortByReplacement: {
+    protected sortByReplacement: {
         [key: string]: string;
     };
-    private readonly _sortFn;
-    private readonly _onLoad;
-    private readonly _onSaveFn;
-    private readonly _equalsFn;
-    private readonly _filterFnFactory;
+    private _sortFn;
+    private _onLoad;
+    private _onSaveFn;
+    private _equalsFn;
+    private _filterFnFactory;
     get defaultFetchPolicy(): 'cache-only';
     set value(data: T[]);
     get value(): T[];
     get saving(): boolean;
     get dirty(): boolean;
-    constructor(dataType: new () => T, filterType: new () => F, options?: InMemoryEntitiesServiceOptions<T, F>);
+    constructor(dataType: new () => T, filterType: new () => F, options?: SO);
+    /**
+     * Configures and sets options for the instance.
+     *
+     * @param {SO} options - An object containing configuration options such as `onSort`, `onLoad`, `onSave`, `equals`, `filterFnFactory`, and `sortByReplacement`.
+     * @return {void} This method does not return a value.
+     */
+    setOptions(options: SO): void;
     protected ngOnStart(data?: T[]): Promise<T[]>;
     protected ngOnStop(): Promise<void>;
     ngOnDestroy(): void;
@@ -74,6 +81,6 @@ export declare class InMemoryEntitiesService<T extends IEntity<T, ID>, F = any,
     protected waitWhileSaving(opts?: WaitForOptions): Promise<void>;
     protected markAsSaving(): void;
     protected markAsSaved(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<InMemoryEntitiesService<any, any, any, any>, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<InMemoryEntitiesService<any, any, any, any>, never, never, {}, {}, never, never, false, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InMemoryEntitiesService<any, any, any, any, any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<InMemoryEntitiesService<any, any, any, any, any>, never, never, {}, {}, never, never, false, never>;
 }

package/src/app/shared/services/startable-observable-service.class.d.ts

@@ -1,5 +1,6 @@
 import { BehaviorSubject, Subject, Subscription } from 'rxjs';
 import { IStartableService } from './startable-service.class';
+import { FirstOptions } from '../observables';
 import * as i0 from "@angular/core";
 /**
  * Same as StartableService, but with a dataSubject instead of a simple 'data' property
@@ -17,8 +18,22 @@ export declare abstract class StartableObservableService<T = any, O = any> imple
     protected constructor(prerequisiteService?: {
         ready: () => Promise<any>;
     });
+    /**
+     * Initiates the startup process for the service. If the service is already started,
+     * it returns the existing data or ensures that the start process executes correctly.
+     *
+     * @param {O} [opts] - Optional configuration or parameters for the startup process.
+     * @return {Promise<T>} A promise that resolves with the service's initialized data, or null if an error occurs during the startup.
+     */
     start(opts?: O): Promise<T>;
-    ready(): Promise<T>;
+    /**
+     * Prepares the service to be ready, ensuring any required setup or initialization is complete.
+     * This method will wait until the service is started, either directly or via a promise, before resolving.
+     *
+     * @param {FirstOptions} [opts] - Optional configuration options that may affect the readiness of the service.
+     * @return {Promise<T>} A promise that resolves with the service's data once it is ready.
+     */
+    ready(opts?: FirstOptions): Promise<T>;
     stop(): Promise<void>;
     restart(opts?: O): Promise<T>;
     get started(): boolean;

package/src/app/shared/services/startable-service.class.d.ts

@@ -1,4 +1,5 @@
 import { Subject, Subscription } from 'rxjs';
+import { FirstOptions } from '../observables';
 import * as i0 from "@angular/core";
 export interface IStartableService<T = any> {
     started: boolean;
@@ -21,7 +22,7 @@ export declare abstract class StartableService<T = any, O = any> implements ISta
         ready: () => Promise<any>;
     });
     start(opts?: O): Promise<T>;
-    ready(): Promise<T>;
+    ready(opts?: FirstOptions): Promise<T>;
     stop(): Promise<void>;
     restart(opts?: O): Promise<T>;
     get started(): boolean;

package/src/assets/manifest.json

@@ -2,7 +2,7 @@
   "name": "ngx-sumaris-components",
   "short_name": "ngx-sumaris-components",
   "manifest_version": 1,
-  "version": "18.22.13",
+  "version": "18.22.15",
   "default_locale": "fr",
   "description": "Angular components for building beautiful and responsive Apps",
   "icons": [{