nhb-toolbox 4.20.50 → 4.20.52

package/CHANGELOG.md

@@ -6,6 +6,11 @@ All notable changes to the package will be documented here.
 
 ---
 
+## [4.20.52] - 2025-09-26
+
+- **Added** new `Chronos` _plugin_ `greetingPlugin` for accessing `getGreeting` method in `Chronos` instances.
+- **Fixed** some _docs and internal type related issues_ in `convertObjectValues` utility.
+
 ## [4.20.50] - 2025-09-25
 
 - **Fixed** _return type_ of `convertObjectValues` utility to correctly reflect the _transformed object structure_ and `keys` option is now _more strict_: **only accepts keys which values are string and/or number** and **the array cannot be left empty**.

package/dist/cjs/date/plugins/greetingPlugin.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.greetingPlugin = void 0;
+const greet_1 = require("../greet");
+const greetingPlugin = (ChronosClass) => {
+    ChronosClass.prototype.getGreeting = function (configs) {
+        const currentTime = this.formatStrict('HH:mm');
+        return (0, greet_1.getGreeting)({ currentTime, ...configs });
+    };
+};
+exports.greetingPlugin = greetingPlugin;

package/dist/cjs/object/convert.js

@@ -46,7 +46,7 @@ function convertObjectValues(data, options) {
         return newObj;
     };
     if (Array.isArray(data)) {
-        return data?.map((d) => _convertValue(d));
+        return data?.map(_convertValue);
     }
     return _convertValue(data);
 }

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

@@ -181,7 +181,7 @@ export declare class Chronos {
      * @param locales A locale string, array of locale strings, Intl.Locale object, or array of Intl.Locale objects that contain one or more language or locale tags. If you include more than one locale string, list them in descending order of priority so that the first entry is the preferred locale. If you omit this parameter, the default locale of the JavaScript runtime is used.
      * @param options An object that contains one or more properties that specify comparison options.
      */
-    toLocaleString(locale?: LocaleCode | Intl.Locale | (LocaleCode | Intl.Locale)[], options?: Intl.DateTimeFormatOptions): string;
+    toLocaleString(locale?: LocaleCode | Intl.Locale | Array<LocaleCode | Intl.Locale>, options?: Intl.DateTimeFormatOptions): string;
     /** @instance Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
     getTimeStamp(): number;
     /**

package/dist/dts/date/plugins/greetingPlugin.d.ts

@@ -0,0 +1,18 @@
+import type { GreetingConfigs } from '../types';
+type MainChronos = typeof import('../Chronos').Chronos;
+declare module '../Chronos' {
+    interface Chronos {
+        /**
+         * @instance Returns a greeting message based on current instance of `Chronos` time or provided time in the `configs`.
+         *
+         * @remarks This method internally uses {@link https://toolbox.nazmul-nhb.dev/docs/utilities/date/getGreeting getGreeting} function.
+         *
+         * @param configs - Configuration options for greeting times and messages.
+         * @returns The appropriate greeting message.
+         */
+        getGreeting(configs?: GreetingConfigs): string;
+    }
+}
+/** * Plugin to inject `getGreeting` method */
+export declare const greetingPlugin: (ChronosClass: MainChronos) => void;
+export {};

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

@@ -107,6 +107,7 @@ export interface SanitizeOptions<T> {
      */
     requiredKeys?: '*' | DotNotationKey<T>[];
 }
+/** Options for `convertObjectValues` utility */
 export interface ConvertObjectOptions<T extends GenericObject, Key extends NumericDotKey<T>, C extends 'string' | 'number'> {
     /** Array of keys (properties) to convert to `number` or `string` */
     keys: ValidArray<Key>;

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

@@ -283,9 +283,10 @@ export type OneOf<T, U> = (T & Without<U, T>) | (U & Without<T, U>);
  * @template T - The type to test.
  *
  * @example
- * type A = IsStrictObject<{}>;          // true
+ * type A = IsStrictObject<{}>;          // false
  * type B = IsStrictObject<() => void>;  // false
  * type C = IsStrictObject<string>;      // false
+ * type D = IsStrictObject<{name: string}>; // true
  */
 export type IsStrictObject<T> = T extends object ? T extends AdvancedTypes ? false : T extends Array<unknown> ? false : true : false;
 /**

package/dist/esm/date/plugins/greetingPlugin.js

@@ -0,0 +1,7 @@
+import { getGreeting } from '../greet.js';
+export const greetingPlugin = (ChronosClass) => {
+    ChronosClass.prototype.getGreeting = function (configs) {
+        const currentTime = this.formatStrict('HH:mm');
+        return getGreeting({ currentTime, ...configs });
+    };
+};

package/dist/esm/object/convert.js

@@ -39,7 +39,7 @@ export function convertObjectValues(data, options) {
         return newObj;
     };
     if (Array.isArray(data)) {
-        return data?.map((d) => _convertValue(d));
+        return data?.map(_convertValue);
     }
     return _convertValue(data);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.20.50",
+  "version": "4.20.52",
   "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",
@@ -187,6 +187,11 @@
       "import": "./dist/esm/date/plugins/fromNowPlugin.js",
       "require": "./dist/cjs/date/plugins/fromNowPlugin.js"
     },
+    "./plugins/greetingPlugin": {
+      "types": "./dist/dts/date/plugins/greetingPlugin.d.ts",
+      "import": "./dist/esm/date/plugins/greetingPlugin.js",
+      "require": "./dist/cjs/date/plugins/greetingPlugin.js"
+    },
     "./plugins/palindromePlugin": {
       "types": "./dist/dts/date/plugins/palindromePlugin.d.ts",
       "import": "./dist/esm/date/plugins/palindromePlugin.js",
@@ -269,6 +274,9 @@
       "plugins/fromNowPlugin": [
         "dist/dts/date/plugins/fromNowPlugin.d.ts"
       ],
+      "plugins/greetingPlugin": [
+        "dist/dts/date/plugins/greetingPlugin.d.ts"
+      ],
       "plugins/palindromePlugin": [
         "dist/dts/date/plugins/palindromePlugin.d.ts"
       ],