@gerync/utils 1.0.2 → 1.1.0

package/README.md

@@ -21,37 +21,41 @@ npm install @gerync/utils
 
 ### 1. coloredlog
 
-Log messages to the console with color support. Accepts hex, RGB, or CSS named colors. Optional bold styling works in both browser (`%c`) and Node (ANSI) consoles.
+Log messages to the console with color support. Accepts hex, RGB, or CSS named colors. Optional bold styling works in both browser (`%c`) and Node (ANSI) consoles. Supports multi-color output on a single line using arrays.
 
 **Import:**
 ```typescript
-import utils from '@gerync/utils';
-utils.coloredlog(message, color, bold?);
+import { coloredlog } from '@gerync/utils';
+coloredlog(message, color, bold?);
 ```
 
 **Usage:**
 ```typescript
-// Named colors
-utils.coloredlog('This is an error', 'red');
-utils.coloredlog('This is a warning', 'orange');
-utils.coloredlog('Success!', 'green');
-utils.coloredlog('Bold success!', 'green', true);
-
-// Hex colors
-utils.coloredlog('Custom color', '#FF5733');
-utils.coloredlog('Another shade', '#FF5733CC'); // with alpha
-
-// RGB colors
-utils.coloredlog('RGB color', 'rgb(255, 87, 51)');
-utils.coloredlog('RGBA with alpha', 'rgba(255, 87, 51, 0.8)');
+// Single color - Named colors
+coloredlog('This is an error', 'red');
+coloredlog('This is a warning', 'orange');
+coloredlog('Success!', 'green');
+coloredlog('Bold success!', 'green', true);
+
+// Single color - Hex colors
+coloredlog('Custom color', '#FF5733');
+coloredlog('Another shade', '#FF5733CC'); // with alpha
+// Single color - RGB colors
+coloredlog('RGB color', 'rgb(255, 87, 51)');
+coloredlog('RGBA with alpha', 'rgba(255, 87, 51, 0.8)');
+
+// Multi-color on same line (array input)
+coloredlog(['This is red', ' and this is green'], ['red', 'green']);
+coloredlog(['Red', ' Blue', ' Yellow'], ['red', 'blue', 'yellow']);
+coloredlog(['Bold red', ' bold blue'], ['red', 'blue'], true);
 
 // If color is invalid, logs without styling
-utils.coloredlog('No styling', 'invalid-color');
+coloredlog('No styling', 'invalid-color');
 ```
 
 **Parameters:**
-- `message` (string): The text to log
-- `color` (string): A valid hex (`#XXX`, `#XXXX`, `#XXXXXX`, `#XXXXXXXX`), RGB (`rgb(r, g, b)`), RGBA (`rgba(r, g, b, a)`), or CSS named color
+- `message` (string | string[]): The text to log. Use array for multi-color output on same line
+- `color` (string | string[]): A valid hex (`#XXX`, `#XXXX`, `#XXXXXX`, `#XXXXXXXX`), RGB (`rgb(r, g, b)`), RGBA (`rgba(r, g, b, a)`), or CSS named color. Use array to match message array for multi-color
 - `bold` (boolean, default `false`): When true, renders bold text (ANSI in Node, `font-weight` in browsers)
 
 ---
@@ -63,7 +67,9 @@ Manage application preferences and localized response messages.
 **Import:**
 ```typescript
 import utils from '@gerync/utils';
-utils.configure({ ... });
+utils.config({ ... });
+// or use the shorthand:
+utils.conf({ ... });
 ```
 
 **Usage:**
@@ -73,7 +79,7 @@ utils.configure({ ... });
 ```typescript
 import utils from '@gerync/utils';
 
-utils.configure({
+utils.config({
     prefs: {
         acceptedLanguages: ['en', 'fr', 'de'],
         noDupesAllowedof: ['email', 'username', 'phone']
@@ -114,9 +120,9 @@ console.log(prefs.acceptedLanguages);     // ['en', 'fr', 'de']
 ```
 
 **Methods:**
-- `configure(options)`: Set preferences and responses at runtime
-- `getResponses()`: Return the current response messages object
-- `getPrefs()`: Return the current preferences object
+- `config(options)` or `conf(options)`: Set preferences and responses at runtime
+- `config.getResponses()`: Return the current response messages object
+- `config.getPrefs()`: Return the current preferences object
 
 ---
 
@@ -139,7 +145,7 @@ import utils from '@gerync/utils';
 const app = express();
 
 // Configure responses and preferences BEFORE using the middleware
-utils.configure({
+utils.config({
     prefs: {
         acceptedLanguages: ['en', 'hu', 'es'],
         noDupesAllowedof: ['email', 'username', 'phone']
@@ -304,77 +310,7 @@ utils.object.AllowedKeys(invalidPayload, requiredKeys, optionalKeys);     // fal
 
 ---
 
-## Complete Example
 
-```typescript
-import express from 'express';
-import utils from '@gerync/utils';
-
-const app = express();
-
-// Setup Config
-utils.configure({
-    prefs: {
-        acceptedLanguages: ['en', 'es'],
-        noDupesAllowedof: ['email', 'username']
-    },
-    responses: {
-        en: {
-            dupes: {
-                email: 'Email already exists.',
-                username: 'Username is taken.'
-            },
-            general: {
-                error: 'An error occurred.'
-            }
-        },
-        es: {
-            dupes: {
-                email: 'El email ya existe.',
-                username: 'El nombre de usuario ya está en uso.'
-            },
-            general: {
-                error: 'Ocurrió un error.'
-            }
-        }
-    }
-});
-
-app.use(express.json());
-
-// Routes
-app.post('/users', (req, res, next) => {
-    try {
-        // Validate request payload
-        const requiredKeys = ['name', 'email'];
-        const optionalKeys = ['phone'];
-
-        if (!utils.object.AllowedKeys(req.body, requiredKeys, optionalKeys)) {
-            return res.status(400).json({
-                status: 'error',
-                message: 'Invalid request payload'
-            });
-        }
-
-        utils.coloredlog(`User creation requested: ${req.body.email}`, 'cyan');
-
-        // Simulate user creation
-        const user = { id: 1, ...req.body };
-        res.json(user);
-    } catch (error) {
-        next(error);
-    }
-});
-
-// Error handler middleware (must be last)
-app.use(utils.errorHandler);
-
-app.listen(3000, () => {
-    utils.coloredlog('Server running on port 3000', 'green');
-});
-```
-
----
 
 ## License
 

package/dist/functions/Colorlog.d.ts

@@ -3,15 +3,17 @@
  * Accepts hex, RGB, RGBA, and CSS named colors.
  * Falls back to unstyled console.log if color is invalid.
  *
- * @param message - Text to log
+ * @param message - Text to log (string or array of strings for multi-color)
  * @param color - Valid hex (#XXX, #XXXX, #XXXXXX, #XXXXXXXX),
  *                RGB (rgb(r, g, b)), RGBA (rgba(r, g, b, a)),
- *                or CSS named color
+ *                or CSS named color (string or array matching message array)
+ * @param bolded - Apply bold styling (default: false)
  *
  * @example
  * coloredlog('Error!', 'red');
  * coloredlog('Success', '#00FF00');
  * coloredlog('Info', 'rgb(0, 0, 255)');
+ * coloredlog(['Red text', 'Blue text'], ['red', 'blue']);
  */
-export default function Coloredlog(message: string, color: string, bolded?: boolean): void;
+export default function Coloredlog(message: string | string[], color: string | string[], bolded?: boolean): void;
 //# sourceMappingURL=Colorlog.d.ts.map

package/dist/functions/Colorlog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Colorlog.d.ts","sourceRoot":"","sources":["../../functions/Colorlog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,OAAe,GAAG,IAAI,CA6GhG"}
+{"version":3,"file":"Colorlog.d.ts","sourceRoot":"","sources":["../../functions/Colorlog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,MAAM,GAAE,OAAe,GAAG,IAAI,CAuJvH"}

package/dist/functions/Colorlog.js

@@ -3,15 +3,17 @@
  * Accepts hex, RGB, RGBA, and CSS named colors.
  * Falls back to unstyled console.log if color is invalid.
  *
- * @param message - Text to log
+ * @param message - Text to log (string or array of strings for multi-color)
  * @param color - Valid hex (#XXX, #XXXX, #XXXXXX, #XXXXXXXX),
  *                RGB (rgb(r, g, b)), RGBA (rgba(r, g, b, a)),
- *                or CSS named color
+ *                or CSS named color (string or array matching message array)
+ * @param bolded - Apply bold styling (default: false)
  *
  * @example
  * coloredlog('Error!', 'red');
  * coloredlog('Success', '#00FF00');
  * coloredlog('Info', 'rgb(0, 0, 255)');
+ * coloredlog(['Red text', 'Blue text'], ['red', 'blue']);
  */
 export default function Coloredlog(message, color, bolded = false) {
     // #region Color Validation Regexes
@@ -85,20 +87,58 @@ export default function Coloredlog(message, color, bolded = false) {
         return null;
     };
     // #endregion
-    // #region Validate Color Format
-    /** Test if color matches any valid format */
-    const isValid = ColorRegex.hex.test(color) ||
-        ColorRegex.rgb.test(color) ||
-        ColorRegex.named.test(color);
+    // #region Handle Multi-Color Array Input
+    if (Array.isArray(message)) {
+        const messages = message;
+        const colors = Array.isArray(color) ? color : Array(messages.length).fill(color);
+        if (isBrowser) {
+            // Build format string with %c placeholders
+            const formatString = messages.map(msg => `%c${msg}`).join('');
+            const styles = colors.map(c => {
+                const weight = bolded ? 'bold' : 'normal';
+                const isValidColor = ColorRegex.hex.test(c) ||
+                    ColorRegex.rgb.test(c) ||
+                    ColorRegex.named.test(c);
+                return isValidColor ? `color: ${c}; font-weight: ${weight};` : `font-weight: ${weight};`;
+            });
+            console.log(formatString, ...styles);
+        }
+        else {
+            // Build ANSI string for Node.js
+            const boldAnsi = bolded ? '\x1b[1m' : '';
+            let output = '';
+            for (let i = 0; i < messages.length; i++) {
+                const msg = messages[i];
+                const col = colors[i] || '';
+                const ansi = colorToAnsi(col);
+                if (ansi) {
+                    output += `${ansi}${boldAnsi}${msg}\x1b[0m`;
+                }
+                else if (boldAnsi) {
+                    output += `${boldAnsi}${msg}\x1b[0m`;
+                }
+                else {
+                    output += msg;
+                }
+            }
+            console.log(output);
+        }
+        return;
+    }
     // #endregion
-    // #region Output
+    // #region Single Color Output (Original Behavior)
+    const colorStr = Array.isArray(color) ? color[0] : color;
+    /** Test if color matches any valid format */
+    const isValid = ColorRegex.hex.test(colorStr) ||
+        ColorRegex.rgb.test(colorStr) ||
+        ColorRegex.named.test(colorStr);
     if (isValid) {
         if (isBrowser) {
             const weight = bolded ? 'bold' : 'normal';
-            console.log(`%c${message}`, `color: ${color}; font-weight: ${weight};`);
+            console.log(`%c${message}`, `color: ${colorStr}; font-weight: ${weight};`);
         }
         else {
-            const ansi = colorToAnsi(color);
+            const ansi = colorToAnsi(colorStr);
             const boldAnsi = bolded ? '\x1b[1m' : '';
             if (ansi) {
                 console.log(`${ansi}${boldAnsi}${message}\x1b[0m`);

package/dist/functions/Config.d.ts

@@ -9,7 +9,16 @@ declare const Configs: {
      * @param options.responses - Localized message objects by language
      * @param options.prefs - Preferences including acceptedLanguages and noDupesAllowedof
      */
-    configure(options: {
+    config(options: {
+        responses: any;
+        prefs: any;
+    }): void;
+    /**
+     * Alias for config(). Initialize configuration with custom responses and preferences.
+     * @param options.responses - Localized message objects by language
+     * @param options.prefs - Preferences including acceptedLanguages and noDupesAllowedof
+     */
+    conf(options: {
         responses: any;
         prefs: any;
     }): void;

package/dist/functions/Config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../functions/Config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,QAAA,MAAM,OAAO;IAET;;;;;OAKG;uBACgB;QAAE,SAAS,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE;IAOjD;;;OAGG;;IAOH;;;OAGG;;IAOH;;;;;;OAMG;qBACc,MAAM,QAAQ,MAAM,WAAW,MAAM;IAetD;;;;;;;OAOG;qBACc,MAAM,QAAQ,MAAM,aAAa,MAAM,GAAG,MAAM,GAAG,SAAS;CAehF,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../functions/Config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,QAAA,MAAM,OAAO;IAET;;;;;OAKG;oBACa;QAAE,SAAS,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE;IAO9C;;;;OAIG;kBACW;QAAE,SAAS,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE;IAM5C;;;OAGG;;IAOH;;;OAGG;;IAOH;;;;;;OAMG;qBACc,MAAM,QAAQ,MAAM,WAAW,MAAM;IAetD;;;;;;;OAOG;qBACc,MAAM,QAAQ,MAAM,aAAa,MAAM,GAAG,MAAM,GAAG,SAAS;CAehF,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/functions/Config.js

@@ -12,18 +12,28 @@ let runtimePrefs = {
 };
 // #endregion
 const Configs = {
-    // #region Configure
+    // #region Config
     /**
      * Initialize configuration with custom responses and preferences.
      * Merges or replaces the runtime state.
      * @param options.responses - Localized message objects by language
      * @param options.prefs - Preferences including acceptedLanguages and noDupesAllowedof
      */
-    configure(options) {
+    config(options) {
         runtimeResponses = options.responses;
         runtimePrefs = options.prefs;
     },
     // #endregion
+    // #region Conf Alias
+    /**
+     * Alias for config(). Initialize configuration with custom responses and preferences.
+     * @param options.responses - Localized message objects by language
+     * @param options.prefs - Preferences including acceptedLanguages and noDupesAllowedof
+     */
+    conf(options) {
+        return this.config(options);
+    },
+    // #endregion
     // #region Get Responses
     /**
      * Retrieve all configured localized response messages.

package/dist/index.d.ts

@@ -3,6 +3,10 @@ import errorHandler from "./functions/handleError.js";
 import config from "./functions/Config.js";
 import object from "./functions/ObjectKeys.js";
 export { coloredlog, errorHandler, object, config };
+export declare const conf: (options: {
+    responses: any;
+    prefs: any;
+}) => void;
 export declare const configure: (options: {
     responses: any;
     prefs: any;
@@ -11,7 +15,11 @@ declare const _default: {
     coloredlog: typeof coloredlog;
     errorHandler: typeof errorHandler;
     config: {
-        configure(options: {
+        config(options: {
+            responses: any;
+            prefs: any;
+        }): void;
+        conf(options: {
             responses: any;
             prefs: any;
         }): void;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,yBAAyB,CAAC;AACjD,OAAO,YAAY,MAAM,4BAA4B,CAAC;AACtD,OAAO,MAAM,MAAM,uBAAuB,CAAC;AAC3C,OAAO,MAAM,MAAM,2BAA2B,CAAC;AAE/C,OAAO,EACH,UAAU,EACV,YAAY,EACZ,MAAM,EACN,MAAM,EACT,CAAC;AAEF,eAAO,MAAM,SAAS;;;UAAmB,CAAC;;;;;;;;;;;;;;;;;;;;;AAE1C,wBAKE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,yBAAyB,CAAC;AACjD,OAAO,YAAY,MAAM,4BAA4B,CAAC;AACtD,OAAO,MAAM,MAAM,uBAAuB,CAAC;AAC3C,OAAO,MAAM,MAAM,2BAA2B,CAAC;AAE/C,OAAO,EACH,UAAU,EACV,YAAY,EACZ,MAAM,EACN,MAAM,EACT,CAAC;AAEF,eAAO,MAAM,IAAI;;;UAAc,CAAC;AAChC,eAAO,MAAM,SAAS;;;UAAgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;AAEvC,wBAKE"}

package/dist/index.js

@@ -3,7 +3,8 @@ import errorHandler from "./functions/handleError.js";
 import config from "./functions/Config.js";
 import object from "./functions/ObjectKeys.js";
 export { coloredlog, errorHandler, object, config };
-export const configure = config.configure;
+export const conf = config.conf;
+export const configure = config.config;
 export default {
     coloredlog,
     errorHandler,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gerync/utils",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "A collection of utilities for any type of project, providing logging, error handling, configuration management, and object manipulation helpers.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",