@ls-stack/utils 3.40.0 → 3.41.0

package/dist/retryOnError.d.cts

@@ -1,12 +1,13 @@
 import { ResultValidErrors, Result } from 't-result';
 
-/**
- * Configuration options for retryOnError function.
- */
+/** Configuration options for retryOnError function. */
 type RetryOptions = {
     /** Delay between retries in milliseconds or function returning delay */
     delayBetweenRetriesMs?: number | ((retry: number) => number);
-    /** Function to determine if retry should happen, receives error and duration of last attempt */
+    /**
+     * Function to determine if retry should happen, receives error and duration
+     * of last attempt
+     */
     retryCondition?: (error: Error, lastAttempt: {
         duration: number;
         retry: number;
@@ -24,22 +25,23 @@ type RetryOptions = {
 /**
  * Retries a function on error with configurable retry logic.
  *
+ * @example
+ *   await retryOnError(
+ *     async (ctx) => {
+ *       console.log(`Attempt ${ctx.retry + 1}`);
+ *       return await fetchData();
+ *     },
+ *     3,
+ *     { delayBetweenRetriesMs: 1000 },
+ *   );
+ *
  * @param fn - Function to retry that receives context with retry count
  * @param maxRetries - Maximum number of retries
  * @param options - Configuration options
- * @param retry - internal use only
- * @param originalMaxRetries - internal use only
- * @returns Promise resolving to the function result or rejecting with the final error
- *
- * @example
- * await retryOnError(
- *   async (ctx) => {
- *     console.log(`Attempt ${ctx.retry + 1}`);
- *     return await fetchData();
- *   },
- *   3,
- *   { delayBetweenRetriesMs: 1000 }
- * );
+ * @param retry - Internal use only
+ * @param originalMaxRetries - Internal use only
+ * @returns Promise resolving to the function result or rejecting with the final
+ *   error
  */
 declare function retryOnError<T>(fn: (ctx: {
     /** Current retry count, (0 for first attempt) */
@@ -56,9 +58,10 @@ declare function retryOnError<T>(fn: (ctx: {
  * @param options.debugId
  * @param options.disableRetries
  * @param options.onRetry
- * @param __retry - internal use only
- * @param __originalMaxRetries - internal use only
- * @returns Promise resolving to the function result or rejecting with the final error
+ * @param __retry - Internal use only
+ * @param __originalMaxRetries - Internal use only
+ * @returns Promise resolving to the function result or rejecting with the final
+ *   error
  */
 declare function retryResultOnError<T, E extends ResultValidErrors>(fn: (ctx: {
     /** Current retry count, (0 for first attempt) */

package/dist/retryOnError.d.ts

@@ -1,12 +1,13 @@
 import { ResultValidErrors, Result } from 't-result';
 
-/**
- * Configuration options for retryOnError function.
- */
+/** Configuration options for retryOnError function. */
 type RetryOptions = {
     /** Delay between retries in milliseconds or function returning delay */
     delayBetweenRetriesMs?: number | ((retry: number) => number);
-    /** Function to determine if retry should happen, receives error and duration of last attempt */
+    /**
+     * Function to determine if retry should happen, receives error and duration
+     * of last attempt
+     */
     retryCondition?: (error: Error, lastAttempt: {
         duration: number;
         retry: number;
@@ -24,22 +25,23 @@ type RetryOptions = {
 /**
  * Retries a function on error with configurable retry logic.
  *
+ * @example
+ *   await retryOnError(
+ *     async (ctx) => {
+ *       console.log(`Attempt ${ctx.retry + 1}`);
+ *       return await fetchData();
+ *     },
+ *     3,
+ *     { delayBetweenRetriesMs: 1000 },
+ *   );
+ *
  * @param fn - Function to retry that receives context with retry count
  * @param maxRetries - Maximum number of retries
  * @param options - Configuration options
- * @param retry - internal use only
- * @param originalMaxRetries - internal use only
- * @returns Promise resolving to the function result or rejecting with the final error
- *
- * @example
- * await retryOnError(
- *   async (ctx) => {
- *     console.log(`Attempt ${ctx.retry + 1}`);
- *     return await fetchData();
- *   },
- *   3,
- *   { delayBetweenRetriesMs: 1000 }
- * );
+ * @param retry - Internal use only
+ * @param originalMaxRetries - Internal use only
+ * @returns Promise resolving to the function result or rejecting with the final
+ *   error
  */
 declare function retryOnError<T>(fn: (ctx: {
     /** Current retry count, (0 for first attempt) */
@@ -56,9 +58,10 @@ declare function retryOnError<T>(fn: (ctx: {
  * @param options.debugId
  * @param options.disableRetries
  * @param options.onRetry
- * @param __retry - internal use only
- * @param __originalMaxRetries - internal use only
- * @returns Promise resolving to the function result or rejecting with the final error
+ * @param __retry - Internal use only
+ * @param __originalMaxRetries - Internal use only
+ * @returns Promise resolving to the function result or rejecting with the final
+ *   error
  */
 declare function retryResultOnError<T, E extends ResultValidErrors>(fn: (ctx: {
     /** Current retry count, (0 for first attempt) */

package/dist/runShellCmd.d.cts

@@ -13,6 +13,14 @@ type RunCmdOptions = {
     noCiColorForce?: boolean;
 };
 /**
+ * @deprecated This utility has been moved to @ls-stack/node-utils. Please
+ *   update your imports:
+ *
+ *       // Old (deprecated)
+ *       import { runCmd } from '@ls-stack/utils/runShellCmd';
+ *
+ *       // New (preferred)
+ *       import { runCmd } from '@ls-stack/node-utils/runShellCmd';
  * @param label
  * @param command
  * @param root0
@@ -21,69 +29,61 @@ type RunCmdOptions = {
  * @param root0.throwOnError
  * @param root0.cwd
  * @param root0.noCiColorForce
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please update your imports:
- * ```
- * // Old (deprecated)
- * import { runCmd } from '@ls-stack/utils/runShellCmd';
- *
- * // New (preferred)
- * import { runCmd } from '@ls-stack/node-utils/runShellCmd';
- * ```
  */
 declare function runCmd(label: string | null, command: string | string[], { mock, silent, throwOnError, cwd, noCiColorForce, }?: RunCmdOptions): Promise<CmdResult>;
 /**
+ * @deprecated This utility has been moved to @ls-stack/node-utils. Please
+ *   update your imports:
+ *
+ *       // Old (deprecated)
+ *       import { concurrentCmd } from '@ls-stack/utils/runShellCmd';
+ *
+ *       // New (preferred)
+ *       import { concurrentCmd } from '@ls-stack/node-utils/runShellCmd';
  * @param label
  * @param cmd
  * @param onResult
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please update your imports:
- * ```
- * // Old (deprecated)
- * import { concurrentCmd } from '@ls-stack/utils/runShellCmd';
- *
- * // New (preferred)
- * import { concurrentCmd } from '@ls-stack/node-utils/runShellCmd';
- * ```
  */
 declare function concurrentCmd(label: string, cmd: string | string[], onResult: (result: CmdResult) => void): Promise<() => void>;
 /**
+ * @deprecated This utility has been moved to @ls-stack/node-utils. Please
+ *   update your imports:
+ *
+ *       // Old (deprecated)
+ *       import { runCmdUnwrap } from '@ls-stack/utils/runShellCmd';
+ *
+ *       // New (preferred)
+ *       import { runCmdUnwrap } from '@ls-stack/node-utils/runShellCmd';
  * @param label
  * @param command
  * @param root0
  * @param root0.silent
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please update your imports:
- * ```
- * // Old (deprecated)
- * import { runCmdUnwrap } from '@ls-stack/utils/runShellCmd';
- *
- * // New (preferred)
- * import { runCmdUnwrap } from '@ls-stack/node-utils/runShellCmd';
- * ```
  */
 declare function runCmdUnwrap(label: string | null, command: string | string[], { silent, }?: {
     silent?: boolean | 'timeOnly';
 }): Promise<string>;
 /**
- * @param command
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please update your imports:
- * ```
- * // Old (deprecated)
- * import { runCmdSilent } from '@ls-stack/utils/runShellCmd';
+ * @deprecated This utility has been moved to @ls-stack/node-utils. Please
+ *   update your imports:
  *
- * // New (preferred)
- * import { runCmdSilent } from '@ls-stack/node-utils/runShellCmd';
- * ```
+ *       // Old (deprecated)
+ *       import { runCmdSilent } from '@ls-stack/utils/runShellCmd';
+ *
+ *       // New (preferred)
+ *       import { runCmdSilent } from '@ls-stack/node-utils/runShellCmd';
+ * @param command
  */
 declare function runCmdSilent(command: string | string[]): Promise<CmdResult>;
 /**
- * @param command
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please update your imports:
- * ```
- * // Old (deprecated)
- * import { runCmdSilentUnwrap } from '@ls-stack/utils/runShellCmd';
+ * @deprecated This utility has been moved to @ls-stack/node-utils. Please
+ *   update your imports:
+ *
+ *       // Old (deprecated)
+ *       import { runCmdSilentUnwrap } from '@ls-stack/utils/runShellCmd';
  *
- * // New (preferred)
- * import { runCmdSilentUnwrap } from '@ls-stack/node-utils/runShellCmd';
- * ```
+ *       // New (preferred)
+ *       import { runCmdSilentUnwrap } from '@ls-stack/node-utils/runShellCmd';
+ * @param command
  */
 declare function runCmdSilentUnwrap(command: string | string[]): Promise<string>;
 

package/dist/runShellCmd.d.ts

@@ -13,6 +13,14 @@ type RunCmdOptions = {
     noCiColorForce?: boolean;
 };
 /**
+ * @deprecated This utility has been moved to @ls-stack/node-utils. Please
+ *   update your imports:
+ *
+ *       // Old (deprecated)
+ *       import { runCmd } from '@ls-stack/utils/runShellCmd';
+ *
+ *       // New (preferred)
+ *       import { runCmd } from '@ls-stack/node-utils/runShellCmd';
  * @param label
  * @param command
  * @param root0
@@ -21,69 +29,61 @@ type RunCmdOptions = {
  * @param root0.throwOnError
  * @param root0.cwd
  * @param root0.noCiColorForce
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please update your imports:
- * ```
- * // Old (deprecated)
- * import { runCmd } from '@ls-stack/utils/runShellCmd';
- *
- * // New (preferred)
- * import { runCmd } from '@ls-stack/node-utils/runShellCmd';
- * ```
  */
 declare function runCmd(label: string | null, command: string | string[], { mock, silent, throwOnError, cwd, noCiColorForce, }?: RunCmdOptions): Promise<CmdResult>;
 /**
+ * @deprecated This utility has been moved to @ls-stack/node-utils. Please
+ *   update your imports:
+ *
+ *       // Old (deprecated)
+ *       import { concurrentCmd } from '@ls-stack/utils/runShellCmd';
+ *
+ *       // New (preferred)
+ *       import { concurrentCmd } from '@ls-stack/node-utils/runShellCmd';
  * @param label
  * @param cmd
  * @param onResult
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please update your imports:
- * ```
- * // Old (deprecated)
- * import { concurrentCmd } from '@ls-stack/utils/runShellCmd';
- *
- * // New (preferred)
- * import { concurrentCmd } from '@ls-stack/node-utils/runShellCmd';
- * ```
  */
 declare function concurrentCmd(label: string, cmd: string | string[], onResult: (result: CmdResult) => void): Promise<() => void>;
 /**
+ * @deprecated This utility has been moved to @ls-stack/node-utils. Please
+ *   update your imports:
+ *
+ *       // Old (deprecated)
+ *       import { runCmdUnwrap } from '@ls-stack/utils/runShellCmd';
+ *
+ *       // New (preferred)
+ *       import { runCmdUnwrap } from '@ls-stack/node-utils/runShellCmd';
  * @param label
  * @param command
  * @param root0
  * @param root0.silent
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please update your imports:
- * ```
- * // Old (deprecated)
- * import { runCmdUnwrap } from '@ls-stack/utils/runShellCmd';
- *
- * // New (preferred)
- * import { runCmdUnwrap } from '@ls-stack/node-utils/runShellCmd';
- * ```
  */
 declare function runCmdUnwrap(label: string | null, command: string | string[], { silent, }?: {
     silent?: boolean | 'timeOnly';
 }): Promise<string>;
 /**
- * @param command
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please update your imports:
- * ```
- * // Old (deprecated)
- * import { runCmdSilent } from '@ls-stack/utils/runShellCmd';
+ * @deprecated This utility has been moved to @ls-stack/node-utils. Please
+ *   update your imports:
  *
- * // New (preferred)
- * import { runCmdSilent } from '@ls-stack/node-utils/runShellCmd';
- * ```
+ *       // Old (deprecated)
+ *       import { runCmdSilent } from '@ls-stack/utils/runShellCmd';
+ *
+ *       // New (preferred)
+ *       import { runCmdSilent } from '@ls-stack/node-utils/runShellCmd';
+ * @param command
  */
 declare function runCmdSilent(command: string | string[]): Promise<CmdResult>;
 /**
- * @param command
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please update your imports:
- * ```
- * // Old (deprecated)
- * import { runCmdSilentUnwrap } from '@ls-stack/utils/runShellCmd';
+ * @deprecated This utility has been moved to @ls-stack/node-utils. Please
+ *   update your imports:
+ *
+ *       // Old (deprecated)
+ *       import { runCmdSilentUnwrap } from '@ls-stack/utils/runShellCmd';
  *
- * // New (preferred)
- * import { runCmdSilentUnwrap } from '@ls-stack/node-utils/runShellCmd';
- * ```
+ *       // New (preferred)
+ *       import { runCmdSilentUnwrap } from '@ls-stack/node-utils/runShellCmd';
+ * @param command
  */
 declare function runCmdSilentUnwrap(command: string | string[]): Promise<string>;
 

package/dist/safeJson.d.cts

@@ -1,10 +1,14 @@
 /**
- * JSON.stringify can throw if the value is circular or contains functions, this function catches those errors and returns undefined
+ * JSON.stringify can throw if the value is circular or contains functions, this
+ * function catches those errors and returns undefined
+ *
  * @param value
  */
 declare function safeJsonStringify(value: unknown): string | undefined;
 /**
- * JSON.parse can throw if the value is not valid JSON, this function catches those errors and returns undefined
+ * JSON.parse can throw if the value is not valid JSON, this function catches
+ * those errors and returns undefined
+ *
  * @param value
  */
 declare function safeJsonParse(value: string): unknown;

package/dist/safeJson.d.ts

@@ -1,10 +1,14 @@
 /**
- * JSON.stringify can throw if the value is circular or contains functions, this function catches those errors and returns undefined
+ * JSON.stringify can throw if the value is circular or contains functions, this
+ * function catches those errors and returns undefined
+ *
  * @param value
  */
 declare function safeJsonStringify(value: unknown): string | undefined;
 /**
- * JSON.parse can throw if the value is not valid JSON, this function catches those errors and returns undefined
+ * JSON.parse can throw if the value is not valid JSON, this function catches
+ * those errors and returns undefined
+ *
  * @param value
  */
 declare function safeJsonParse(value: string): unknown;

package/dist/saferTyping.d.cts

@@ -1,39 +1,46 @@
-/** Use this only when you have 100% of certainty that this will not break the types */
-type __LEGIT_ANY__ = any;
-type __LEGIT_ANY_FUNCTION__ = (...params: any) => __LEGIT_ANY__;
 /**
- * An empty object type, equivalent to `{}` but with safer typing
+ * Use this only when you have 100% of certainty that this will not break the
+ * types
  */
+type __LEGIT_ANY__ = any;
+type __LEGIT_ANY_FUNCTION__ = (...params: any) => __LEGIT_ANY__;
+/** An empty object type, equivalent to `{}` but with safer typing */
 type EmptyObject = Record<string, never>;
 /**
- * Cast a value to `any` type. Use this when you have legit usage of `any` casting.
+ * Cast a value to `any` type. Use this when you have legit usage of `any`
+ * casting.
  *
+ * @template V (optional) - When used enforces that the casted value is
+ *   assignable to the type V, use it for safer casts
  * @param value
- * @template V (optional) - When used enforces that the casted value is assignable to the type V, use it for safer casts
  */
 declare function __LEGIT_ANY_CAST__<V = unknown>(value: V): __LEGIT_ANY__;
 /**
- * Cast a value to a specific type T. Use this when you have legit usage of type assertion.
+ * Cast a value to a specific type T. Use this when you have legit usage of type
+ * assertion.
  *
- * @param value
  * @template T - The type to cast to
- * @template V (optional) - When used enforces that the casted value is assignable to the type V, use it for safer casts
+ * @template V (optional) - When used enforces that the casted value is
+ *   assignable to the type V, use it for safer casts
+ * @param value
  */
 declare function __LEGIT_CAST__<T, V = unknown>(value: V): T;
 /**
- * Refine a value to a specific type T. Use this when you have legit usage of type assertion.
+ * Refine a value to a specific type T. Use this when you have legit usage of
+ * type assertion.
  *
- * @param value
  * @template T - The type to cast to
- * @template V (optional) - When used enforces that the casted value is assignable to the type V, use it for safer casts
+ * @template V (optional) - When used enforces that the casted value is
+ *   assignable to the type V, use it for safer casts
+ * @param value
  */
 declare function __REFINE_CAST__<T>(value: T): <R extends T>() => R;
 declare function __FIX_THIS_CASTING__<T>(value: unknown): T;
 type __FIX_THIS_TYPING__ = any;
 declare function __FIX_THIS_TYPING__(value: unknown): __LEGIT_ANY__;
 /**
- * Any type that is not a primitive (number, string, boolean, null, undefined, symbol, bigint, ...)
- * Equivalent to `object` type
+ * Any type that is not a primitive (number, string, boolean, null, undefined,
+ * symbol, bigint, ...) Equivalent to `object` type
  */
 type AnyNonPrimitiveValue = object;
 

package/dist/saferTyping.d.ts

@@ -1,39 +1,46 @@
-/** Use this only when you have 100% of certainty that this will not break the types */
-type __LEGIT_ANY__ = any;
-type __LEGIT_ANY_FUNCTION__ = (...params: any) => __LEGIT_ANY__;
 /**
- * An empty object type, equivalent to `{}` but with safer typing
+ * Use this only when you have 100% of certainty that this will not break the
+ * types
  */
+type __LEGIT_ANY__ = any;
+type __LEGIT_ANY_FUNCTION__ = (...params: any) => __LEGIT_ANY__;
+/** An empty object type, equivalent to `{}` but with safer typing */
 type EmptyObject = Record<string, never>;
 /**
- * Cast a value to `any` type. Use this when you have legit usage of `any` casting.
+ * Cast a value to `any` type. Use this when you have legit usage of `any`
+ * casting.
  *
+ * @template V (optional) - When used enforces that the casted value is
+ *   assignable to the type V, use it for safer casts
  * @param value
- * @template V (optional) - When used enforces that the casted value is assignable to the type V, use it for safer casts
  */
 declare function __LEGIT_ANY_CAST__<V = unknown>(value: V): __LEGIT_ANY__;
 /**
- * Cast a value to a specific type T. Use this when you have legit usage of type assertion.
+ * Cast a value to a specific type T. Use this when you have legit usage of type
+ * assertion.
  *
- * @param value
  * @template T - The type to cast to
- * @template V (optional) - When used enforces that the casted value is assignable to the type V, use it for safer casts
+ * @template V (optional) - When used enforces that the casted value is
+ *   assignable to the type V, use it for safer casts
+ * @param value
  */
 declare function __LEGIT_CAST__<T, V = unknown>(value: V): T;
 /**
- * Refine a value to a specific type T. Use this when you have legit usage of type assertion.
+ * Refine a value to a specific type T. Use this when you have legit usage of
+ * type assertion.
  *
- * @param value
  * @template T - The type to cast to
- * @template V (optional) - When used enforces that the casted value is assignable to the type V, use it for safer casts
+ * @template V (optional) - When used enforces that the casted value is
+ *   assignable to the type V, use it for safer casts
+ * @param value
  */
 declare function __REFINE_CAST__<T>(value: T): <R extends T>() => R;
 declare function __FIX_THIS_CASTING__<T>(value: unknown): T;
 type __FIX_THIS_TYPING__ = any;
 declare function __FIX_THIS_TYPING__(value: unknown): __LEGIT_ANY__;
 /**
- * Any type that is not a primitive (number, string, boolean, null, undefined, symbol, bigint, ...)
- * Equivalent to `object` type
+ * Any type that is not a primitive (number, string, boolean, null, undefined,
+ * symbol, bigint, ...) Equivalent to `object` type
  */
 type AnyNonPrimitiveValue = object;
 

package/dist/shallowEqual.d.cts

@@ -1,4 +1,4 @@
-/** shallow equal version of https://github.com/lukeed/dequal */
+/** Shallow equal version of https://github.com/lukeed/dequal */
 declare function shallowEqual(foo: any, bar: any): boolean;
 
 export { shallowEqual };

package/dist/shallowEqual.d.ts

@@ -1,4 +1,4 @@
-/** shallow equal version of https://github.com/lukeed/dequal */
+/** Shallow equal version of https://github.com/lukeed/dequal */
 declare function shallowEqual(foo: any, bar: any): boolean;
 
 export { shallowEqual };

package/dist/stringUtils.cjs

@@ -67,10 +67,10 @@ function convertToCamelCase(str) {
   return pascalCase.charAt(0).toLowerCase() + pascalCase.slice(1);
 }
 function convertToSentenceCase(str) {
-  return str.split(/[\s_-]+/).map((word) => word.toLowerCase()).join(" ").replace(/^\w/, (char) => char.toUpperCase());
+  return str.replace(/[\s\-.]+/g, " ").replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z])([A-Z][a-z])/g, "$1 $2").split(/[\s_-]+/).map((word) => word.toLowerCase()).join(" ").replace(/^\w/, (char) => char.toUpperCase());
 }
 function convertToTitleCase(str) {
-  return str.split(/[\s_-]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
+  return str.replace(/[\s\-.]+/g, " ").replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z])([A-Z][a-z])/g, "$1 $2").split(/[\s_-]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
 }
 function truncateString(str, length, ellipsis = "\u2026") {
   if (str.length <= length) return str;

package/dist/stringUtils.d.cts

@@ -2,16 +2,15 @@ type Arg = string | false | undefined | null;
 /**
  * A util to create more legible conditional concatenated strings
  *
- * @param args
  * @example
- * joinStrings('a', 'b', 'c') // 'abc'
- * joinStrings('a', false, 'c') // 'ac'
- * joinStrings('a', addBString ? 'b' : null, 'c') // 'ac' if addBString is false, 'abc' if addBString is true
+ *   joinStrings('a', 'b', 'c'); // 'abc'
+ *   joinStrings('a', false, 'c'); // 'ac'
+ *   joinStrings('a', addBString ? 'b' : null, 'c'); // 'ac' if addBString is false, 'abc' if addBString is true
+ *
+ * @param args
  */
 declare function concatStrings(...args: (Arg | Arg[])[]): string;
-/**
- * @deprecated Use {@link concatStrings} instead
- */
+/** @deprecated Use {@link concatStrings} instead */
 declare const joinStrings: typeof concatStrings;
 declare function formatNum(num: number, maxDecimalsOrOptions?: number | Intl.NumberFormatOptions): string;
 declare function isSnakeCase(str: string): boolean;

package/dist/stringUtils.d.ts

@@ -2,16 +2,15 @@ type Arg = string | false | undefined | null;
 /**
  * A util to create more legible conditional concatenated strings
  *
- * @param args
  * @example
- * joinStrings('a', 'b', 'c') // 'abc'
- * joinStrings('a', false, 'c') // 'ac'
- * joinStrings('a', addBString ? 'b' : null, 'c') // 'ac' if addBString is false, 'abc' if addBString is true
+ *   joinStrings('a', 'b', 'c'); // 'abc'
+ *   joinStrings('a', false, 'c'); // 'ac'
+ *   joinStrings('a', addBString ? 'b' : null, 'c'); // 'ac' if addBString is false, 'abc' if addBString is true
+ *
+ * @param args
  */
 declare function concatStrings(...args: (Arg | Arg[])[]): string;
-/**
- * @deprecated Use {@link concatStrings} instead
- */
+/** @deprecated Use {@link concatStrings} instead */
 declare const joinStrings: typeof concatStrings;
 declare function formatNum(num: number, maxDecimalsOrOptions?: number | Intl.NumberFormatOptions): string;
 declare function isSnakeCase(str: string): boolean;

package/dist/stringUtils.js

@@ -10,7 +10,7 @@ import {
   joinStrings,
   removeANSIColors,
   truncateString
-} from "./chunk-KW55OTUG.js";
+} from "./chunk-B3KFV2MH.js";
 export {
   concatStrings,
   convertToCamelCase,

package/dist/testUtils.cjs

@@ -788,14 +788,12 @@ function stringifyValue(value, indent, maxLineLength, showUndefined, maxDepth, d
       const entries = Object.entries(value).filter(
         ([, val]) => val !== void 0 || showUndefined
       );
-      const isSimpleObject = entries.every(
-        ([, val]) => {
-          if (typeof val === "string") {
-            return !val.includes("'") && !val.includes('"') && !val.includes("\\");
-          }
-          return typeof val === "number" || typeof val === "boolean" || val === null || val === void 0;
+      const isSimpleObject = entries.every(([, val]) => {
+        if (typeof val === "string") {
+          return !val.includes("'") && !val.includes('"') && !val.includes("\\");
         }
-      );
+        return typeof val === "number" || typeof val === "boolean" || val === null || val === void 0;
+      });
       const shouldCollapse = isArrayItem ? entries.length > 1 : entries.length > 0;
       if (isSimpleObject && shouldCollapse) {
         let line = "{ ";
@@ -848,7 +846,9 @@ function stringifyValue(value, indent, maxLineLength, showUndefined, maxDepth, d
         false
       );
       const willBeCollapsed = isObject(objVal) && (Object.keys(objVal).length === 0 || collapseObjects && depth + 1 > 0 && (() => {
-        const filteredEntries = Object.entries(objVal).filter(([, val]) => val !== void 0 || showUndefined);
+        const filteredEntries = Object.entries(objVal).filter(
+          ([, val]) => val !== void 0 || showUndefined
+        );
         const shouldCollapseThis = isArrayItem ? filteredEntries.length > 1 : filteredEntries.length > 0;
         return shouldCollapseThis && filteredEntries.every(([, val]) => {
           if (typeof val === "string") {
@@ -858,7 +858,9 @@ function stringifyValue(value, indent, maxLineLength, showUndefined, maxDepth, d
         });
       })());
       const prevWasCollapsed = prevValue && isObject(prevValue) && (Object.keys(prevValue).length === 0 || collapseObjects && depth + 1 > 0 && (() => {
-        const filteredEntries = Object.entries(prevValue).filter(([, val]) => val !== void 0 || showUndefined);
+        const filteredEntries = Object.entries(prevValue).filter(
+          ([, val]) => val !== void 0 || showUndefined
+        );
         const shouldCollapseThis = isArrayItem ? filteredEntries.length > 1 : filteredEntries.length > 0;
         return shouldCollapseThis && filteredEntries.every(([, val]) => {
           if (typeof val === "string") {