nhb-toolbox 4.28.50 → 4.28.51

package/CHANGELOG.md

@@ -4,6 +4,10 @@
 
 All notable changes to the package will be documented here.
 
+## [4.28.51] - 2025-12-24
+
+- **Removed** strictness from *format* parameter of `formatTimePart` utility and `Chronos.formatTimePart` static method.
+
 ## [4.28.50] - 2025-12-24
 
 ### ✨ New Class, Chronos Plugin, and Utilities

package/dist/dts/date/Chronos.d.ts

@@ -1,7 +1,7 @@
 import type { Enumerate, NumberRange } from '../number/types';
 import type { LooseLiteral, TupleOf } from '../utils/types';
 import { INTERNALS } from './constants';
-import type { $NativeTzNameOrId, $TimeZoneIdentifier, $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, ChronosObject, ChronosPlugin, ChronosWithOptions, DateRangeOptions, DateTimeFormatOptions, FormatOptions, LocalesArguments, Milliseconds, MonthName, Quarter, RangeWithDates, RelativeDateRange, RelativeRangeOptions, StrictFormat, TimeFormatToken, TimeUnit, TimeUnitValue, TimeZone, TimeZoneId, TimeZoneIdNative, TimeZoneName, UTCOffset, WeekDay } from './types';
+import type { $NativeTzNameOrId, $TimeZoneIdentifier, $UTCOffset, ChronosInput, ChronosInternals, ChronosMethods, ChronosObject, ChronosPlugin, ChronosWithOptions, DateRangeOptions, DateTimeFormatOptions, FormatOptions, LocalesArguments, Milliseconds, MonthName, Quarter, RangeWithDates, RelativeDateRange, RelativeRangeOptions, StrictFormat, TimeOnlyFormat, TimeUnit, TimeUnitValue, TimeZone, TimeZoneId, TimeZoneIdNative, TimeZoneName, UTCOffset, WeekDay } from './types';
 /**
  * * Creates a new immutable `Chronos` instance.
  *
@@ -711,11 +711,11 @@ export declare class Chronos {
      *
      * - *Input will default to today's date and assume local timezone if no offset is provided.*
      *
-     * @param format - Format tokens accepted by {@link formatStrict()} method ({@link TimeFormatToken}) for time part only.
+     * @param format - Format tokens accepted by {@link formatStrict()} method ({@link TimeOnlyFormat}) for time part only.
      *                 Default: `hh:mm:ss a` → 02:33:36 pm.
      * @returns Formatted time string in local (System) time.
      */
-    static formatTimePart(time: string, format?: TimeFormatToken): string;
+    static formatTimePart(time: string, format?: TimeOnlyFormat): string;
     /**
      * @static Returns ISO date strings for each occurrence of a weekday from today, spanning a relative time range.
      *

package/dist/dts/date/types.d.ts

@@ -99,6 +99,8 @@ export type DateFormatToken = `${DateToken} ${Exclude<MonthToken, 'M' | 'MM'>}`
 export type TimeFormatToken = `${Exclude<HourToken, 'h' | 'hh' | 'H'>}:${Exclude<MinuteToken, 'm'>}` | `${Exclude<HourToken, 'H' | 'HH' | 'h'>}:${Exclude<MinuteToken, 'm'>} ${TimeToken}` | `${Exclude<HourToken, 'h' | 'hh' | 'H'>}:${Exclude<MinuteToken, 'm'>}:${Exclude<SecondToken, 's'>}` | `${Exclude<HourToken, 'H' | 'HH' | 'h'>}:${Exclude<MinuteToken, 'm'>}:${Exclude<SecondToken, 's'>} ${TimeToken}` | `${Exclude<HourToken, 'h' | 'hh' | 'H'>}:${Exclude<MinuteToken, 'm'>}:${Exclude<SecondToken, 's'>}:${Exclude<MSToken, 'ms'>}` | `${Exclude<HourToken, 'H' | 'HH' | 'h'>}:${Exclude<MinuteToken, 'm'>}:${Exclude<SecondToken, 's'>}:${Exclude<MSToken, 'ms'>} ${TimeToken}`;
 type DateTimeISO = 'YYYY-MM-DDTHH:mm:ss.mssZZ';
 type TokenConnector = ' ' | ', ' | '; ' | ' - ';
+/** Format tokens for time only string */
+export type TimeOnlyFormat = LooseLiteral<TimeFormatToken>;
 /** Pre-defined literal types for formatting date and time. Optionally can pass any string. */
 export type StrictFormat = LooseLiteral<DateTimeISO | DateFormatToken | TimeFormatToken | `${DateFormatToken}${TokenConnector}${TimeFormatToken}`>;
 /** `BCP47` locale string or {@link Intl.Locale} object that contain one or more language or locale tags */

package/dist/dts/date/utils.d.ts

@@ -1,5 +1,5 @@
 import type { Numeric } from '../types/index';
-import type { $TimeZoneIdentifier, ClockTime, DateFormatOptions, HourMinutes, TimeFormatToken, TimeZoneDetails, TimeZoneIdNative, UTCOffset } from './types';
+import type { $TimeZoneIdentifier, ClockTime, DateFormatOptions, HourMinutes, TimeOnlyFormat, TimeZoneDetails, TimeZoneIdNative, UTCOffset } from './types';
 /**
  * * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
  *
@@ -109,8 +109,8 @@ export declare function formatDate(options?: DateFormatOptions): string;
  *
  * - *Input will default to today's date and assume local timezone if no offset is provided.*
  *
- * @param format - Format tokens accepted by {@link formatDate} method ({@link TimeFormatToken}) for time part only.
+ * @param format - Format tokens accepted by {@link formatDate} method ({@link TimeOnlyFormat}) for time part only.
  *                 Default: `hh:mm:ss a` → 02:33:36 pm.
  * @returns Formatted time string in local (System) time.
  */
-export declare function formatTimePart(time: string, format?: TimeFormatToken): string;
+export declare function formatTimePart(time: string, format?: TimeOnlyFormat): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.28.50",
+  "version": "4.28.51",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",