@zelgadis87/utils-core 4.13.9 → 5.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@zelgadis87/utils-core",
-  "version": "4.13.9",
+  "version": "5.0.0",
   "author": "Zelgadis87",
   "license": "ISC",
   "private": false,
@@ -26,7 +26,7 @@
     "@vitest/ui": "3.0.8",
     "esbuild": "0.19.2",
     "eslint": "9.22.0",
-    "nx": "20.6.0",
+    "nx": "21.1.2",
     "rimraf": "6.0.1",
     "typescript": "5.8.2",
     "typescript-eslint": "8.26.1",

package/src/Logger.ts

@@ -4,7 +4,7 @@ import { noop, padRight } from "./utils/_index.js";
 const LEVELS = [ "log", "debug", "info", "warn", "error" ] as const;
 type TLogLevel = keyof Console & typeof LEVELS[ number ]
 
-const timestamp = () => TimeInstant.now().asTimeString();
+const timestamp = () => TimeInstant.now().format( 'HH:mm:ss' );
 
 export type TLoggerOpts = {
 	console: Console;

package/src/async/Deferred.ts

@@ -24,9 +24,6 @@ export class Deferred<T = void> implements ICancelablePromise<T> {
 
 	public get pending(): boolean { return this._pending; }
 
-	/** @deprecated: Use resolve, then and catch directly; use asPromise to return a promise type. */
-	public get promise(): Promise<T> { return this._internals.promise; }
-
 	constructor() {
 		this._pending = true;
 		this._internals = this.createInternals();

package/src/async/_index.ts

@@ -1,5 +1,4 @@
 
-export * from './CancelableDeferred.ts';
 export * from './Deferred.ts';
 export * from './RateThrottler.ts';
 export * from './Semaphore.ts';

package/src/sorting/Sorter.ts

@@ -408,8 +408,4 @@ export const Sorter = {
 	first: <T>( arr: TReadableArray<T>, builder: TSorterBuilder<T> ) => builder( doCreateEmpty() ).first( arr ),
 	last: <T>( arr: TReadableArray<T>, builder: TSorterBuilder<T> ) => builder( doCreateEmpty() ).last( arr ),
 };
-/** 
- * @deprecated[2023-11-01]: Use {@link Sorter} instead.
- **/
-export const Sorting = Sorter;
 export default Sorter;

package/src/sorting/_index.ts

@@ -1,5 +1,4 @@
 
-export * from './types.js';
-export { default as ComparisonChain } from './ComparisonChain.js';
 export * from './Sorter.js';
 export * from './types.js';
+

package/src/time/RandomTimeDuration.ts

@@ -1,10 +1,10 @@
-import { randomInterval } from "../utils/random.js";
+import { randomNumberInInterval } from "../utils/random.js";
 import TimeDuration from "./TimeDuration.js";
 import TimeUnit from "./TimeUnit.js";
 
 function randomize( unit: TimeUnit ) {
 	return ( a: number, b: number ) => {
-		return TimeDuration.fromMs( randomInterval( unit.toMs( a ), unit.toMs( b ) ) );
+		return TimeDuration.fromMs( randomNumberInInterval( unit.toMs( a ), unit.toMs( b ) ) );
 	}
 }
 

package/src/time/TimeDuration.ts

@@ -1,6 +1,6 @@
 import Deferred, { DeferredCanceledError, ICancelable, ICancelablePromise } from "../async/Deferred.js";
 import { TComparisonResult } from "../sorting/_index.js";
-import { TIntervalHandle, TMaybe, TTimeoutHandle, ensureNonNegativeNumber, ensurePositiveNumber, pad, randomInterval } from "../utils/_index.js";
+import { TIntervalHandle, TMaybe, TTimeoutHandle, ensureNonNegativeNumber, ensurePositiveNumber, pad } from "../utils/_index.js";
 import TimeBase from "./TimeBase";
 import TimeInstant from "./TimeInstant";
 import TimeUnit from "./TimeUnit";
@@ -30,11 +30,6 @@ export class TimeDuration extends TimeBase<TimeDuration> {
 		return super.removeUnits( nn, unit );
 	}
 
-	/** @deprecated: Use multiplyBy instead **/
-	public multiply( times: number ) {
-		return this.multiplyBy( times );
-	}
-
 	public multiplyBy( times: number ): TimeDuration {
 		ensureNonNegativeNumber( times, "times" );
 		return TimeDuration.ms( this.ms * times );
@@ -69,13 +64,6 @@ export class TimeDuration extends TimeBase<TimeDuration> {
 			return 'Some time ago';
 	}
 
-	/**
-		* @deprecated[2023-06] this method makes no sense, as durations are positive by default.
-		*/
-	public absolute(): TimeDuration {
-		return this.ms < 0 ? new TimeDuration( -this.ms, TimeUnit.MILLISECONDS ) : this;
-	}
-
 	public interval( cb: () => unknown ): TIntervalHandle {
 		return setInterval( cb, this.ms );
 	}
@@ -153,11 +141,6 @@ export class TimeDuration extends TimeBase<TimeDuration> {
 		return new TimeDuration( Math.abs( this.ms - other.ms ), TimeUnit.MILLISECONDS );
 	}
 
-	/** @deprecated: Use fromNow instead **/
-	public addCurrentTime() {
-		return this.fromNow();
-	}
-
 	public isGreaterThan( other: TimeDuration ): boolean {
 		return this.ms > other.ms;
 	}
@@ -224,11 +207,11 @@ export class TimeDuration extends TimeBase<TimeDuration> {
 		return a.compareTo( b );
 	}
 
-	public static ms = durationConstructor( TimeUnit.MILLISECONDS );
-	public static seconds = durationConstructor( TimeUnit.SECONDS );
-	public static minutes = durationConstructor( TimeUnit.MINUTES );
-	public static hours = durationConstructor( TimeUnit.HOURS );
-	public static days = durationConstructor( TimeUnit.DAYS );
+	public static ms = ( value: number ) => new TimeDuration( value, TimeUnit.MILLISECONDS );
+	public static seconds = ( value: number ) => new TimeDuration( value, TimeUnit.SECONDS );
+	public static minutes = ( value: number ) => new TimeDuration( value, TimeUnit.MINUTES );
+	public static hours = ( value: number ) => new TimeDuration( value, TimeUnit.HOURS );
+	public static days = ( value: number ) => new TimeDuration( value, TimeUnit.DAYS );
 
 	public static shamefulUnref = ( ms: TAllowedTimeDuration ): number => {
 		if ( ms instanceof TimeDuration ) {
@@ -282,20 +265,6 @@ export class TimeDuration extends TimeBase<TimeDuration> {
 
 }
 
-interface IDurationConstructor {
-	( a: number ): TimeDuration
-	/** @deprecated[2023-06] Use RandomTimeDuration instead */( a: number, b?: number ): TimeDuration
-}
-
-/** @deprecated[2023-06] Use RandomTimeDuration instead */
-function durationConstructor( unit: TimeUnit ): IDurationConstructor {
-	return ( a: number, b?: number ) => {
-		const aMs = unit.toMs( a );
-		const bMs = b ? unit.toMs( b ) : aMs;
-		return TimeDuration.fromMs( randomInterval( aMs, bMs ) );
-	}
-}
-
 export type TPredefinedTimeDuration = 0 | 50 | 100 | 150 | 200 | 250 | 300 | 500 | 1000 | 1500 | 2000 | 2500 | 5000;
 export type TValidTimeDuration = TimeDuration | TPredefinedTimeDuration;
 type TAllowedTimeDuration = TValidTimeDuration | number; // eslint-disable-line @typescript-eslint/no-redundant-type-constituents

package/src/time/TimeInstant.ts

@@ -32,6 +32,10 @@ export class TimeInstant extends TimeBase<TimeInstant> {
 	public distanceFromNow(): TimeDuration {
 		return TimeDuration.fromMs( Math.abs( this.ms - Date.now() ) );
 	}
+	
+	public distanceFromUnixTimestamp( timestamp: number ): TimeDuration {
+		return TimeDuration.ms( this.ms - timestamp );
+	}
 
 	public timeLeftFrom( instant: TimeInstant ): TimeDuration {
 		const distance = this.ms - instant.ms;
@@ -76,35 +80,19 @@ export class TimeInstant extends TimeBase<TimeInstant> {
 	}
 
 	public ensureInTheFuture() {
-		if ( !this.isInTheFuture )
-			throw new Error( 'Instant is in the past' );
+		if ( !this.isInTheFuture() )
+			throw new Error( 'Instant is not in the future' );
 	}
 
 	public ensureInThePast() {
-		if ( !this.isInThePast )
-			throw new Error( 'Instant is in the future' );
+		if ( !this.isInThePast() )
+			throw new Error( 'Instant is not in the past' );
 	}
 
 	public isToday(): boolean {
 		return Math.floor( this.days ) === Math.floor( TimeInstant.now().days );
 	}
 
-	/**
-	 * @returns the time as HH:mm:ss
-	 * @deprecated [2024-12-11] this method is too ambigous and should be removed.
-	 */
-	public asTimeString(): string {
-		return this.format( 'HH:mm:ss' );
-	}
-
-	/**
-	 * @returns the date as dd/MM/yyyy
-	 * @deprecated [2024-12-11] this method is too ambigous and should be removed.
-	 */
-	public asDateString(): string {
-		return this.format( 'dd/MM/yyyy' );
-	}
-
 	/**
 	 * Formats this instant using the given pattern. The pattern can contain the following tokens:
 	 * 
@@ -158,8 +146,7 @@ export class TimeInstant extends TimeBase<TimeInstant> {
 	}
 
 	/**
-	 * @returns this instant, in a human readable format. The format COULD change in the future, do NOT use this method for consistent outputs.
-	 * @deprecated [2024-12-11] this method is too broad and ambigous and should be removed.
+	 * @returns this instant, in a human readable format, containing both the date and the time. The format COULD change in the future, do NOT use this method for consistent outputs.
 	 */
 	public asHumanTimestamp(): string {
 		return this.format( 'yyyy-MM-dd HH:mm:ss' )
@@ -178,31 +165,17 @@ export class TimeInstant extends TimeBase<TimeInstant> {
 		return new Date( this.ms + new Date().getTimezoneOffset() * 60 * 1000 );
 	}
 
-	/**
-	 * @deprecated use {@link TimeInstant#isInThePast2} instead.
-	 */
-	public get isInThePast(): boolean {
-		return this.ms < Date.now();
-	}
-
-	/**
-	 * @deprecated use {@link TimeInstant#isInTheFuture2} instead.
-	 */
-	public get isInTheFuture(): boolean {
-		return this.ms > Date.now();
-	}
-
 	/**
 	 * @returns true if the instant is in the past, false otherwise
 	 */
-	public isInThePast2(): boolean {
+	public isInThePast(): boolean {
 		return this.ms < Date.now();
 	}
 
 	/**
 	 * @returns true if the instant is in the future, false otherwise
 	 */
-	public isInTheFuture2(): boolean {
+	public isInTheFuture(): boolean {
 		return this.ms > Date.now();
 	}
 
@@ -224,34 +197,6 @@ export class TimeInstant extends TimeBase<TimeInstant> {
 		}
 	}
 
-	/**
-	 * @deprecated: Use {@link distanceFromNow} instead
-	*/
-	// TODO[2023-07-04, Deprecated]: Remove this method in a future version
-	public fromNow(): TimeDuration {
-		return TimeDuration.ms( this.ms - Date.now() );
-	}
-
-	/**
-	 * @deprecated: Use {@link distanceFrom} instead
-	*/
-	// TODO[2023-07-04, Deprecated]: Remove this method in a future version
-	public from( instant: TimeInstant ): TimeDuration {
-		return TimeDuration.ms( this.ms - instant.ms );
-	}
-
-	/**
-	 * @deprecated: Use {@link distanceFromUnixTimestamp} instead
-	*/
-	// TODO[2023-07-04, Deprecated]: Remove this method in a future version
-	public fromTimestamp( timestamp: number ): TimeDuration {
-		return TimeDuration.ms( this.ms - timestamp );
-	}
-
-	public distanceFromUnixTimestamp( timestamp: number ): TimeDuration {
-		return TimeDuration.ms( this.ms - timestamp );
-	}
-
 	public atTime( parameters: Partial<TTimeInstantCreationParameters & { year: never; month: never; date: never; }> ) {
 		return TimeInstant.fromParameters( parameters, this );
 	}
@@ -296,16 +241,6 @@ export class TimeInstant extends TimeBase<TimeInstant> {
 		return timeInstantBuilder();
 	}
 
-	/**
-	 * @deprecated[19/07/2023] Use {@link fromParameters} instead.
-	 */
-	public static fromUnits( { date, month, year, hours, minutes, seconds }: { date: number, month: number, year: number, hours?: number, minutes?: number, seconds?: number } ): TimeInstant {
-		const dt = Date.UTC( year, month - 1, date, hours ?? 0, minutes ?? 0, seconds ?? 0 );
-		if ( isNaN( dt ) )
-			throw new Error( `Unparseable date: ${date}, ${month}, ${year}, ${hours ?? '-'}, ${minutes ?? '-'}, ${seconds ?? '-'}` )
-		return TimeInstant.fromUnixTimestamp( dt );
-	}
-
 	public static fromIso8601( str: TIso8601DateString ) {
 		return TimeInstant.fromUnixTimestamp( new Date( str ).getTime() );
 	}
@@ -320,10 +255,6 @@ export class TimeInstant extends TimeBase<TimeInstant> {
 		return TimeInstant.fromUnixTimestamp( Date.now() );
 	}
 
-	public static get currentTimeStamp(): number {
-		return Date.now();
-	}
-
 	public static compare( a: TimeInstant, b: TimeInstant ): TComparisonResult {
 		return a.compareTo( b );
 	}

package/src/utils/css.ts

@@ -24,7 +24,11 @@ export function cssDeclarationRulesDictionaryToCss( syleDeclarationRulesForSelec
 export function cssSelectorDeclarationRulesDictionaryToCss( styleDeclarationRules: TCssDeclarationRulesDictionary | TCssSelectorDeclarationRulesDictionary, indent = 0 ): string[] {
 	return Object.entries( styleDeclarationRules ).map( ( [ key, value ]: [ string, string | TCssSelectorDeclarationRulesDictionary ] ) => {
 		if ( typeof value === 'string' ) {
-			return repeat( tabulation, indent ) + pascalCaseToKebabCase( key ) + colon + space + value + semiColon;
+			if ( key.startsWith( '--' ) ) {
+				return repeat( tabulation, indent ) + key + colon + space + value + semiColon;
+			} else {
+				return repeat( tabulation, indent ) + pascalCaseToKebabCase( key ) + colon + space + value + semiColon;
+			}
 		} else {
 			return repeat( tabulation, indent ) + key + space + openBracket + newLine + cssSelectorDeclarationRulesDictionaryToCss( value, indent + 1 ).join( newLine ) + newLine + repeat( tabulation, indent ) + closeBracket;
 		}

package/src/utils/json.ts

@@ -45,5 +45,3 @@ export function omitFromJsonObject<T extends TJsonObject, K extends keyof T>( o:
 		return obj;
 	}, { ...o } );
 }
-/** @deprecated[2024-12-23]: Use {@link omitFromJsonObject} instead. */
-export const omit = omitFromJsonObject;

package/src/utils/random.ts

@@ -1,11 +1,5 @@
 import { TPositiveNumber } from "./numbers.ts";
 
-/** @deprecated[2025-01-14]: Use {@link randomNumberInInterval} instead. */
-export const randomInterval = ( min: number, max: number ): number => randomNumberInInterval( min, max );
-
-/** @deprecated[2025-01-14]: Use {@link randomNumberInInterval} / 100 instead. */
-export const randomPercentage = ( min: number, max: number ): number => randomNumberInInterval( min, max ) / 100;
-
 export function randomNumberInInterval( min: number, max: number ): number {
 	return Math.floor( Math.random() * ( max - min + 1 ) + min );
 }

package/src/utils/strings.ts

@@ -85,7 +85,4 @@ export function wrapWithString( str: string, delimiter: string ): string {
 	return delimiter + str + delimiter;
 }
 
-/** @deprecated[2024-12-23]: Use {@link wrapWithString} instead. */
-export const wrap = wrapWithString;
-