@zelgadis87/utils-core 5.2.11 → 5.2.12

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@zelgadis87/utils-core",
-  "version": "5.2.11",
+  "version": "5.2.12",
   "author": "Zelgadis87",
   "license": "ISC",
   "private": false,

package/src/time/TimeInstant.ts

@@ -4,7 +4,7 @@ import TimeBase from "./TimeBase";
 import TimeDuration from "./TimeDuration";
 import { TTimeInstantBuilder, TTimeInstantCreationParameters, createTimeInstantFromParameters, timeInstantBuilder, type TTimeInstantParameters } from "./TimeInstantBuilder.js";
 import { TimeUnit } from "./TimeUnit";
-import { TDayOfMonth, TDayOfWeek, THourOfDay, TIso8601DateString, TIso8601DateUtcString, TMillisecondOfSecond, TMinuteOfHour, TMonth, TSecondOfMinute, TWeekNumber } from "./types";
+import { TDayOfMonth, TDayOfWeek, THourOfDay, TIso8601DateString, TIso8601DateUtcString, TMillisecondOfSecond, TMinuteOfHour, TMonth, TSecondOfMinute, TWeekNumber, type TFourDigitsYear, type TYear } from "./types";
 
 export class TimeInstant extends TimeBase<TimeInstant> {
 
@@ -170,7 +170,7 @@ export class TimeInstant extends TimeBase<TimeInstant> {
 		return parseTimeInstant( dateString, pattern, base, config );
 	}
 
-	public static parse( dateString: string, pattern: string, config: { locale?: string, timeZone?: string } = {} ): Partial<TTimeInstantCreationParameters> {
+	public static parse( dateString: string, pattern: string, config: { locale?: string, timeZone?: string } = {} ): Partial<TTimeInstantParameters> {
 		return parseTimeInstantComponents( dateString, pattern, config );
 	}
 
@@ -428,9 +428,7 @@ export default TimeInstant;
 // Utility functions for date formatting and parsing
 
 // Standalone validation functions
-// TODO: Add calendar-aware validation to check month-specific day limits
-// (e.g., reject February 30th, April 31st, February 29th in non-leap years)
-function isValidYear( num: number ): boolean {
+function isValidYear( num: number ): num is TYear {
 	return num >= 0 && num <= 9999;
 }
 
@@ -438,6 +436,8 @@ function isValidMonth( num: number ): num is TMonth {
 	return num >= 1 && num <= 12;
 }
 
+// TODO: Add calendar-aware validation to check month-specific day limits
+// (e.g., reject February 30th, April 31st, February 29th in non-leap years)
 function isValidDayOfMonth( num: number ): num is TDayOfMonth {
 	return num >= 1 && num <= 31;
 }

package/src/time/TimeInstantBuilder.ts

@@ -3,14 +3,14 @@ import { TFunction } from "../utils/functions.js";
 import { ensureDefined } from "../utils/nulls.js";
 import { monthNames } from "./constants.js";
 import { TimeInstant, isTimeInstant } from "./TimeInstant.js";
-import { TDayOfMonth, THourOfDay, TMillisecondOfSecond, TMinuteOfHour, TMonth, TSecondOfMinute, TUpToTwoDigits, type TMonthName } from "./types.js";
+import { TDayOfMonth, THourOfDay, TMillisecondOfSecond, TMinuteOfHour, TMonth, TSecondOfMinute, TUpToTwoDigits, type TMonthName, type TYear } from "./types.js";
 
 type TRelativeSignum = '+' | '-';
 type TRelativeNumber = `${TRelativeSignum}${TUpToTwoDigits}`;
 const isRelativeNumber = ( x: string ): x is TRelativeNumber => x !== undefined && x.length > 0 && ( x[ 0 ] === '+' || x[ 0 ] === '-' );
 
 export type TTimeInstantParameters = {
-	year: number;
+	year: TYear;
 	month: TMonth;
 	date: TDayOfMonth;
 	hours: THourOfDay;

package/src/time/types.ts

@@ -1,4 +1,4 @@
-import { TDigit, TDigit1_9, TNumber0_1000, TParseableInt } from "../utils/_index";
+import { TDigit, TDigit1_9, TNumber0_1000, TParseableInt, type TPositiveNumber } from "../utils/_index";
 import type { monthNames } from "./constants.ts";
 
 export type TOneDigit = `${TDigit}`;
@@ -19,6 +19,7 @@ export type TThreeDigitsMillisecond = TThreeDigits;
 export type TFourDigitsYear = TFourDigits;
 export type TFourDigitsMillisecond = `${'+' | '-'}${TThreeDigits}`;
 
+export type TYear = TPositiveNumber;
 export type TMonth = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
 export type TMonthName = keyof typeof monthNames;