@sumaris-net/ngx-components 18.22.23 → 18.22.25

package/package.json

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

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

@@ -13,6 +13,8 @@ export declare class DateUtils {
     static moment: MomentFn;
     static toDateISOString: typeof toDateISOString;
     static fromDateISOString: typeof fromDateISOString;
+    static fromUnixTimestamp: typeof fromUnixTimestamp;
+    static fromUnixMsTimestamp: typeof fromUnixMsTimestamp;
     static toDuration: typeof toDuration;
     static min(date1: Moment, date2: Moment): Moment;
     static max(date1: Moment | string, date2: Moment | string): Moment;
@@ -37,7 +39,7 @@ export declare class DateUtils {
      * @param keepLocalTime if true, only the timezone (and offset) is updated, keeping the local time same. Consequently, it will now point to a different point in time if the offset has changed.
      */
     static resetTime(value: Moment | string, timezone?: string, keepLocalTime?: boolean): Moment | undefined;
-    static markNoTime(value: Moment): Moment | undefined;
+    static markNoTime(value: Moment | undefined): Moment | undefined;
     static markTime(value: Moment): Moment | undefined;
     static isNoTime(value: Moment): boolean;
     /**
@@ -53,9 +55,31 @@ export declare class DateUtils {
         seconds?: boolean;
     } | any): string;
 }
+/**
+ * Converts the given value to an ISO date string representation.
+ *
+ * @param {any} value - The value to be transformed into an ISO date string. This can be a date, a string, or other compatible formats.
+ * @return {string | undefined} Returns the ISO date string if the conversion is successful; otherwise, returns undefined.
+ */
 export declare function toDateISOString(value: any): string | undefined;
-export declare function fromDateISOString(value: any): Moment | undefined;
-export declare function fromUnixTimestamp(timeInSec: number): momentImported.Moment;
-export declare function fromUnixMsTimestamp(timeInMs: number): momentImported.Moment;
+/**
+ * Converts a given value to a Moment object if possible.
+ * If the given value is already a Moment object, it will simply return it.
+ * The method handles strings in ISO date formats, UNIX timestamps, and performs validation based on provided options.
+ *
+ * @param {any} value - The value to be converted to a Moment object. This can be a string representing a date, a UNIX timestamp, or a Moment object.
+ * @param {Object} [opts] - Optional parameters for controlling the method's behavior.
+ * @param {boolean} [opts.undefinedIfInvalid=true] - Determines if the method should return undefined for invalid dates. If set to false, an invalid Moment object will be returned instead.
+ * @param {boolean} [opts.strict=false] - Controls whether strict validation is performed. Strict mode enforces stricter date parsing rules.
+ * @param {boolean} [opts.requiredTime=false] - Allow to parse a date without any time
+ * @return {Moment | undefined} A Moment object if the value is successfully converted, or undefined if the conversion is not possible and undefinedIfInvalid is true.
+ */
+export declare function fromDateISOString(value: any, opts?: {
+    undefinedIfInvalid?: boolean;
+    strict?: boolean;
+    requiredTime?: boolean;
+}): Moment | undefined;
+export declare function fromUnixTimestamp(timeInSec: MomentInput): momentImported.Moment;
+export declare function fromUnixMsTimestamp(timeInMs: MomentInput): momentImported.Moment;
 export declare function toDuration(value: number, unit?: unitOfTime.DurationConstructor): Duration | undefined;
 export {};

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/assets/manifest.json

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