@stryke/string-format 0.12.13 → 0.12.20

package/dist/pretty-bytes-Dam2n54B.d.mts

@@ -0,0 +1,152 @@
+//#region src/pretty-bytes.d.ts
+interface Options {
+  /**
+   * Include plus sign for positive numbers. If the difference is exactly zero a space character will be prepended instead for better alignment.
+   *
+   * @defaultValue false
+   */
+  readonly signed?: boolean;
+  /**
+   * - If `false`: Output won't be localized.
+   * - If `true`: Localize the output using the system/browser locale.
+   * - If `string`: Expects a [BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) (For example: `en`, `de`, …)
+   * - If `string[]`: Expects a list of [BCP 47 language tags](https://en.wikipedia.org/wiki/IETF_language_tag) (For example: `en`, `de`, …)
+   *
+   * @defaultValue false
+   */
+  readonly locale?: boolean | string | readonly string[];
+  /**
+   * Format the number as [bits](https://en.wikipedia.org/wiki/Bit) instead of [bytes](https://en.wikipedia.org/wiki/Byte). This can be useful when, for example, referring to [bit rate](https://en.wikipedia.org/wiki/Bit_rate).
+   *
+   * @defaultValue false
+   *
+   * @example
+   * ```ts
+   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';
+   *
+   * prettyBytes(1337, {bits: true});
+   * //=> '1.34 kbit'
+   * ```
+   */
+  readonly bits?: boolean;
+  /**
+   * Format the number using the [Binary Prefix](https://en.wikipedia.org/wiki/Binary_prefix) instead of the [SI Prefix](https://en.wikipedia.org/wiki/SI_prefix). This can be useful for presenting memory amounts. However, this should not be used for presenting file sizes.
+   *
+   * @defaultValue false
+   *
+   * @example
+   * ```ts
+   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';
+   *
+   * prettyBytes(1000, {binary: true});
+   * //=> '1000 bit'
+   *
+   * prettyBytes(1024, {binary: true});
+   * //=> '1 kiB'
+   * ```
+   */
+  readonly binary?: boolean;
+  /**
+   * The minimum number of fraction digits to display.
+   *
+   * If neither `minimumFractionDigits` or `maximumFractionDigits` are set, the default behavior is to round to 3 significant digits.
+   *
+   * @defaultValue undefined
+   *
+   * @example
+   * ```ts
+   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';
+   *
+   * // Show the number with at least 3 fractional digits
+   * prettyBytes(1900, {minimumFractionDigits: 3});
+   * //=> '1.900 kB'
+   *
+   * prettyBytes(1900);
+   * //=> '1.9 kB'
+   * ```
+   */
+  readonly minimumFractionDigits?: number;
+  /**
+   * The maximum number of fraction digits to display.
+   *
+   * If neither `minimumFractionDigits` or `maximumFractionDigits` are set, the default behavior is to round to 3 significant digits.
+   *
+   * @defaultValue undefined
+   *
+   * @example
+   * ```ts
+   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';
+   *
+   * // Show the number with at most 1 fractional digit
+   * prettyBytes(1920, {maximumFractionDigits: 1});
+   * //=> '1.9 kB'
+   *
+   * prettyBytes(1920);
+   * //=> '1.92 kB'
+   * ```
+   */
+  readonly maximumFractionDigits?: number;
+  /**
+   * Put a space between the number and unit.
+   *
+   * @defaultValue true
+   *
+   * @example
+   * ```ts
+   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';
+   *
+   * prettyBytes(1920, {space: false});
+   * //=> '1.9kB'
+   *
+   * prettyBytes(1920);
+   * //=> '1.92 kB'
+   * ```
+   */
+  readonly space?: boolean;
+}
+/**
+ * Formats the given number using `Number#toLocaleString`.
+ *
+ * @remarks
+ * - If locale is a string, the value is expected to be a locale-key (for example: `de`).
+ * - If locale is true, the system default locale is used for translation.
+ * - If no value for locale is specified, the number is returned unmodified.
+ *
+ * @param number - The number to format.
+ * @param locale - The locale to use for formatting the number.
+ * @param options - The options to use for formatting the number.
+ * @returns The formatted number.
+ */
+declare const toLocaleString: (number?: number | string, locale?: string | readonly string[] | boolean, options?: Options) => string;
+/**
+ * Convert bytes to a human readable string: `1337` → `1.34 kB`.
+ *
+ * @param number - The number to format.
+ *
+ * @example
+ * ```ts
+ * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';
+ *
+ * prettyBytes(1337);
+ * //=> '1.34 kB'
+ *
+ * prettyBytes(100);
+ * //=> '100 B'
+ *
+ * // Display file size differences
+ * prettyBytes(42, {signed: true});
+ * //=> '+42 B'
+ *
+ * // Localized output using German locale
+ * prettyBytes(1337, {locale: 'de'});
+ * //=> '1,34 kB'
+ * ```
+ *
+ * @param number - The number to format.
+ * @param options - The options to use.
+ * @returns The formatted string.
+ */
+declare function prettyBytes(number: number, options?: Options): string;
+//#endregion
+export { prettyBytes as n, toLocaleString as r, Options as t };
+//# sourceMappingURL=pretty-bytes-Dam2n54B.d.mts.map

package/dist/pretty-bytes-Dam2n54B.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretty-bytes-Dam2n54B.d.mts","names":[],"sources":["../src/pretty-bytes.ts"],"sourcesContent":[],"mappings":";UAkBiB,OAAA;EAAA;AAgKjB;AAiDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAjDa,oGAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8CK,WAAA,2BAAsC"}

package/dist/pretty-bytes-DmvsumO5.mjs

@@ -0,0 +1,2 @@
+const e=[`B`,`kB`,`MB`,`GB`,`TB`,`PB`,`EB`,`ZB`,`YB`],t=[`B`,`KiB`,`MiB`,`GiB`,`TiB`,`PiB`,`EiB`,`ZiB`,`YiB`],n=[`b`,`kbit`,`Mbit`,`Gbit`,`Tbit`,`Pbit`,`Ebit`,`Zbit`,`Ybit`],r=[`b`,`kibit`,`Mibit`,`Gibit`,`Tibit`,`Pibit`,`Eibit`,`Zibit`,`Yibit`],i=(e,t,n={})=>{let r=e,i=t;return typeof i==`string`?(i||=process.env.STORM_LOCALE||`en-US`,Array.isArray(i)&&(r=e?.toLocaleString(i,n))):(i===!0||n!==void 0)&&(r=e?.toLocaleString(void 0,n)),String(r)};function a(a,o){let s=a;if(!Number.isFinite(s))throw TypeError(`Expected a finite number, got ${typeof s}: ${s}`);let c={bits:!1,binary:!1,space:!0,...o},l=c.bits?c.binary?r:n:c.binary?t:e,u=c.space?` `:``;if(c.signed&&s===0)return` 0${u}${l[0]}`;let d=s<0,f=d?`-`:c.signed?`+`:``;d&&(s=-s);let p;if(c.minimumFractionDigits!==void 0&&(p={minimumFractionDigits:c.minimumFractionDigits}),c.maximumFractionDigits!==void 0&&(p={maximumFractionDigits:c.maximumFractionDigits,...p}),s<1)return f+i(s,c.locale,p)+u+l[0];let m=Math.min(Math.floor(c.binary?Math.log(s)/Math.log(1024):Math.log10(s)/3),l.length-1);s/=(c.binary?1024:1e3)**m,p||(s=s.toPrecision(3));let h=i(Number(s),c.locale,p),g=l[m];return f+h+u+g}export{i as n,a as t};
+//# sourceMappingURL=pretty-bytes-DmvsumO5.mjs.map

package/dist/pretty-bytes-DmvsumO5.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretty-bytes-DmvsumO5.mjs","names":["_number: string | number"],"sources":["../src/pretty-bytes.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport interface Options {\n  /**\n   * Include plus sign for positive numbers. If the difference is exactly zero a space character will be prepended instead for better alignment.\n   *\n   * @defaultValue false\n   */\n  readonly signed?: boolean;\n\n  /**\n   * - If `false`: Output won't be localized.\n   * - If `true`: Localize the output using the system/browser locale.\n   * - If `string`: Expects a [BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) (For example: `en`, `de`, …)\n   * - If `string[]`: Expects a list of [BCP 47 language tags](https://en.wikipedia.org/wiki/IETF_language_tag) (For example: `en`, `de`, …)\n   *\n   * @defaultValue false\n   */\n  readonly locale?: boolean | string | readonly string[];\n\n  /**\n   * Format the number as [bits](https://en.wikipedia.org/wiki/Bit) instead of [bytes](https://en.wikipedia.org/wiki/Byte). This can be useful when, for example, referring to [bit rate](https://en.wikipedia.org/wiki/Bit_rate).\n   *\n   * @defaultValue false\n   *\n   * @example\n   * ```ts\n   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';\n   *\n   * prettyBytes(1337, {bits: true});\n   * //=> '1.34 kbit'\n   * ```\n   */\n  readonly bits?: boolean;\n\n  /**\n   * Format the number using the [Binary Prefix](https://en.wikipedia.org/wiki/Binary_prefix) instead of the [SI Prefix](https://en.wikipedia.org/wiki/SI_prefix). This can be useful for presenting memory amounts. However, this should not be used for presenting file sizes.\n   *\n   * @defaultValue false\n   *\n   * @example\n   * ```ts\n   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';\n   *\n   * prettyBytes(1000, {binary: true});\n   * //=> '1000 bit'\n   *\n   * prettyBytes(1024, {binary: true});\n   * //=> '1 kiB'\n   * ```\n   */\n  readonly binary?: boolean;\n\n  /**\n   * The minimum number of fraction digits to display.\n   *\n   * If neither `minimumFractionDigits` or `maximumFractionDigits` are set, the default behavior is to round to 3 significant digits.\n   *\n   * @defaultValue undefined\n   *\n   * @example\n   * ```ts\n   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';\n   *\n   * // Show the number with at least 3 fractional digits\n   * prettyBytes(1900, {minimumFractionDigits: 3});\n   * //=> '1.900 kB'\n   *\n   * prettyBytes(1900);\n   * //=> '1.9 kB'\n   * ```\n   */\n  readonly minimumFractionDigits?: number;\n\n  /**\n   * The maximum number of fraction digits to display.\n   *\n   * If neither `minimumFractionDigits` or `maximumFractionDigits` are set, the default behavior is to round to 3 significant digits.\n   *\n   * @defaultValue undefined\n   *\n   * @example\n   * ```ts\n   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';\n   *\n   * // Show the number with at most 1 fractional digit\n   * prettyBytes(1920, {maximumFractionDigits: 1});\n   * //=> '1.9 kB'\n   *\n   * prettyBytes(1920);\n   * //=> '1.92 kB'\n   * ```\n   */\n  readonly maximumFractionDigits?: number;\n\n  /**\n   * Put a space between the number and unit.\n   *\n   * @defaultValue true\n   *\n   * @example\n   * ```ts\n   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';\n   *\n   * prettyBytes(1920, {space: false});\n   * //=> '1.9kB'\n   *\n   * prettyBytes(1920);\n   * //=> '1.92 kB'\n   * ```\n   */\n  readonly space?: boolean;\n}\n\nconst BYTE_UNITS = [\"B\", \"kB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\", \"ZB\", \"YB\"];\nconst BIBYTE_UNITS = [\n  \"B\",\n  \"KiB\",\n  \"MiB\",\n  \"GiB\",\n  \"TiB\",\n  \"PiB\",\n  \"EiB\",\n  \"ZiB\",\n  \"YiB\"\n];\nconst BIT_UNITS = [\n  \"b\",\n  \"kbit\",\n  \"Mbit\",\n  \"Gbit\",\n  \"Tbit\",\n  \"Pbit\",\n  \"Ebit\",\n  \"Zbit\",\n  \"Ybit\"\n];\nconst BIBIT_UNITS = [\n  \"b\",\n  \"kibit\",\n  \"Mibit\",\n  \"Gibit\",\n  \"Tibit\",\n  \"Pibit\",\n  \"Eibit\",\n  \"Zibit\",\n  \"Yibit\"\n];\n\n/**\n * Formats the given number using `Number#toLocaleString`.\n *\n * @remarks\n * - If locale is a string, the value is expected to be a locale-key (for example: `de`).\n * - If locale is true, the system default locale is used for translation.\n * - If no value for locale is specified, the number is returned unmodified.\n *\n * @param number - The number to format.\n * @param locale - The locale to use for formatting the number.\n * @param options - The options to use for formatting the number.\n * @returns The formatted number.\n */\nexport const toLocaleString = (\n  number?: number | string,\n  locale?: string | readonly string[] | boolean,\n  options: Options = {}\n): string => {\n  let result = number;\n  let _locale = locale;\n  if (typeof _locale === \"string\") {\n    if (!_locale) {\n      _locale = process.env.STORM_LOCALE || \"en-US\";\n    }\n    if (Array.isArray(_locale)) {\n      result = number?.toLocaleString(_locale, options);\n    }\n  } else if (_locale === true || options !== undefined) {\n    result = number?.toLocaleString(undefined, options);\n  }\n\n  return String(result);\n};\n\n/**\n * Convert bytes to a human readable string: `1337` → `1.34 kB`.\n *\n * @param number - The number to format.\n *\n * @example\n * ```ts\n * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';\n *\n * prettyBytes(1337);\n * //=> '1.34 kB'\n *\n * prettyBytes(100);\n * //=> '100 B'\n *\n * // Display file size differences\n * prettyBytes(42, {signed: true});\n * //=> '+42 B'\n *\n * // Localized output using German locale\n * prettyBytes(1337, {locale: 'de'});\n * //=> '1,34 kB'\n * ```\n *\n * @param number - The number to format.\n * @param options - The options to use.\n * @returns The formatted string.\n */\nexport function prettyBytes(number: number, options?: Options): string {\n  let _number: string | number = number;\n  if (!Number.isFinite(_number)) {\n    throw new TypeError(\n      `Expected a finite number, got ${typeof _number}: ${_number}`\n    );\n  }\n\n  const opts = {\n    bits: false,\n    binary: false,\n    space: true,\n    ...options\n  };\n\n  const UNITS = opts.bits\n    ? opts.binary\n      ? BIBIT_UNITS\n      : BIT_UNITS\n    : opts.binary\n      ? BIBYTE_UNITS\n      : BYTE_UNITS;\n\n  const separator = opts.space ? \" \" : \"\";\n\n  if (opts.signed && _number === 0) {\n    return ` 0${separator}${UNITS[0]}`;\n  }\n\n  const isNegative = _number < 0;\n\n  const prefix = isNegative ? \"-\" : opts.signed ? \"+\" : \"\";\n\n  if (isNegative) {\n    _number = -_number;\n  }\n\n  let localeOptions;\n\n  if (opts.minimumFractionDigits !== undefined) {\n    localeOptions = { minimumFractionDigits: opts.minimumFractionDigits };\n  }\n\n  if (opts.maximumFractionDigits !== undefined) {\n    localeOptions = {\n      maximumFractionDigits: opts.maximumFractionDigits,\n      ...localeOptions\n    };\n  }\n\n  if (_number < 1) {\n    const numberString = toLocaleString(_number, opts.locale, localeOptions);\n\n    return prefix + numberString + separator + UNITS[0];\n  }\n\n  const exponent = Math.min(\n    Math.floor(\n      opts.binary ? Math.log(_number) / Math.log(1024) : Math.log10(_number) / 3\n    ),\n    UNITS.length - 1\n  );\n  _number /= (opts.binary ? 1024 : 1000) ** exponent;\n\n  if (!localeOptions) {\n    _number = _number.toPrecision(3);\n  }\n\n  const numberString = toLocaleString(\n    Number(_number),\n    opts.locale,\n    localeOptions\n  );\n\n  const unit = UNITS[exponent];\n\n  return prefix + numberString + separator + unit;\n}\n"],"mappings":"AAkIA,MAAM,EAAa,CAAC,IAAK,KAAM,KAAM,KAAM,KAAM,KAAM,KAAM,KAAM,KAAK,CAClE,EAAe,CACnB,IACA,MACA,MACA,MACA,MACA,MACA,MACA,MACA,MACD,CACK,EAAY,CAChB,IACA,OACA,OACA,OACA,OACA,OACA,OACA,OACA,OACD,CACK,EAAc,CAClB,IACA,QACA,QACA,QACA,QACA,QACA,QACA,QACA,QACD,CAeY,GACX,EACA,EACA,EAAmB,EAAE,GACV,CACX,IAAI,EAAS,EACT,EAAU,EAYd,OAXI,OAAO,GAAY,UACrB,AACE,IAAU,QAAQ,IAAI,cAAgB,QAEpC,MAAM,QAAQ,EAAQ,GACxB,EAAS,GAAQ,eAAe,EAAS,EAAQ,IAE1C,IAAY,IAAQ,IAAY,IAAA,MACzC,EAAS,GAAQ,eAAe,IAAA,GAAW,EAAQ,EAG9C,OAAO,EAAO,EA+BvB,SAAgB,EAAY,EAAgB,EAA2B,CACrE,IAAIA,EAA2B,EAC/B,GAAI,CAAC,OAAO,SAAS,EAAQ,CAC3B,MAAU,UACR,iCAAiC,OAAO,EAAQ,IAAI,IACrD,CAGH,IAAM,EAAO,CACX,KAAM,GACN,OAAQ,GACR,MAAO,GACP,GAAG,EACJ,CAEK,EAAQ,EAAK,KACf,EAAK,OACH,EACA,EACF,EAAK,OACH,EACA,EAEA,EAAY,EAAK,MAAQ,IAAM,GAErC,GAAI,EAAK,QAAU,IAAY,EAC7B,MAAO,KAAK,IAAY,EAAM,KAGhC,IAAM,EAAa,EAAU,EAEvB,EAAS,EAAa,IAAM,EAAK,OAAS,IAAM,GAElD,IACF,EAAU,CAAC,GAGb,IAAI,EAaJ,GAXI,EAAK,wBAA0B,IAAA,KACjC,EAAgB,CAAE,sBAAuB,EAAK,sBAAuB,EAGnE,EAAK,wBAA0B,IAAA,KACjC,EAAgB,CACd,sBAAuB,EAAK,sBAC5B,GAAG,EACJ,EAGC,EAAU,EAGZ,OAAO,EAFc,EAAe,EAAS,EAAK,OAAQ,EAAc,CAEzC,EAAY,EAAM,GAGnD,IAAM,EAAW,KAAK,IACpB,KAAK,MACH,EAAK,OAAS,KAAK,IAAI,EAAQ,CAAG,KAAK,IAAI,KAAK,CAAG,KAAK,MAAM,EAAQ,CAAG,EAC1E,CACD,EAAM,OAAS,EAChB,CACD,IAAY,EAAK,OAAS,KAAO,MAAS,EAErC,IACH,EAAU,EAAQ,YAAY,EAAE,EAGlC,IAAM,EAAe,EACnB,OAAO,EAAQ,CACf,EAAK,OACL,EACD,CAEK,EAAO,EAAM,GAEnB,OAAO,EAAS,EAAe,EAAY"}

package/dist/pretty-bytes-Dv8t5D6N.d.cts

@@ -0,0 +1,152 @@
+//#region src/pretty-bytes.d.ts
+interface Options {
+  /**
+   * Include plus sign for positive numbers. If the difference is exactly zero a space character will be prepended instead for better alignment.
+   *
+   * @defaultValue false
+   */
+  readonly signed?: boolean;
+  /**
+   * - If `false`: Output won't be localized.
+   * - If `true`: Localize the output using the system/browser locale.
+   * - If `string`: Expects a [BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) (For example: `en`, `de`, …)
+   * - If `string[]`: Expects a list of [BCP 47 language tags](https://en.wikipedia.org/wiki/IETF_language_tag) (For example: `en`, `de`, …)
+   *
+   * @defaultValue false
+   */
+  readonly locale?: boolean | string | readonly string[];
+  /**
+   * Format the number as [bits](https://en.wikipedia.org/wiki/Bit) instead of [bytes](https://en.wikipedia.org/wiki/Byte). This can be useful when, for example, referring to [bit rate](https://en.wikipedia.org/wiki/Bit_rate).
+   *
+   * @defaultValue false
+   *
+   * @example
+   * ```ts
+   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';
+   *
+   * prettyBytes(1337, {bits: true});
+   * //=> '1.34 kbit'
+   * ```
+   */
+  readonly bits?: boolean;
+  /**
+   * Format the number using the [Binary Prefix](https://en.wikipedia.org/wiki/Binary_prefix) instead of the [SI Prefix](https://en.wikipedia.org/wiki/SI_prefix). This can be useful for presenting memory amounts. However, this should not be used for presenting file sizes.
+   *
+   * @defaultValue false
+   *
+   * @example
+   * ```ts
+   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';
+   *
+   * prettyBytes(1000, {binary: true});
+   * //=> '1000 bit'
+   *
+   * prettyBytes(1024, {binary: true});
+   * //=> '1 kiB'
+   * ```
+   */
+  readonly binary?: boolean;
+  /**
+   * The minimum number of fraction digits to display.
+   *
+   * If neither `minimumFractionDigits` or `maximumFractionDigits` are set, the default behavior is to round to 3 significant digits.
+   *
+   * @defaultValue undefined
+   *
+   * @example
+   * ```ts
+   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';
+   *
+   * // Show the number with at least 3 fractional digits
+   * prettyBytes(1900, {minimumFractionDigits: 3});
+   * //=> '1.900 kB'
+   *
+   * prettyBytes(1900);
+   * //=> '1.9 kB'
+   * ```
+   */
+  readonly minimumFractionDigits?: number;
+  /**
+   * The maximum number of fraction digits to display.
+   *
+   * If neither `minimumFractionDigits` or `maximumFractionDigits` are set, the default behavior is to round to 3 significant digits.
+   *
+   * @defaultValue undefined
+   *
+   * @example
+   * ```ts
+   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';
+   *
+   * // Show the number with at most 1 fractional digit
+   * prettyBytes(1920, {maximumFractionDigits: 1});
+   * //=> '1.9 kB'
+   *
+   * prettyBytes(1920);
+   * //=> '1.92 kB'
+   * ```
+   */
+  readonly maximumFractionDigits?: number;
+  /**
+   * Put a space between the number and unit.
+   *
+   * @defaultValue true
+   *
+   * @example
+   * ```ts
+   * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';
+   *
+   * prettyBytes(1920, {space: false});
+   * //=> '1.9kB'
+   *
+   * prettyBytes(1920);
+   * //=> '1.92 kB'
+   * ```
+   */
+  readonly space?: boolean;
+}
+/**
+ * Formats the given number using `Number#toLocaleString`.
+ *
+ * @remarks
+ * - If locale is a string, the value is expected to be a locale-key (for example: `de`).
+ * - If locale is true, the system default locale is used for translation.
+ * - If no value for locale is specified, the number is returned unmodified.
+ *
+ * @param number - The number to format.
+ * @param locale - The locale to use for formatting the number.
+ * @param options - The options to use for formatting the number.
+ * @returns The formatted number.
+ */
+declare const toLocaleString: (number?: number | string, locale?: string | readonly string[] | boolean, options?: Options) => string;
+/**
+ * Convert bytes to a human readable string: `1337` → `1.34 kB`.
+ *
+ * @param number - The number to format.
+ *
+ * @example
+ * ```ts
+ * import { prettyBytes } from '@stryke/string-fns/pretty-bytes';
+ *
+ * prettyBytes(1337);
+ * //=> '1.34 kB'
+ *
+ * prettyBytes(100);
+ * //=> '100 B'
+ *
+ * // Display file size differences
+ * prettyBytes(42, {signed: true});
+ * //=> '+42 B'
+ *
+ * // Localized output using German locale
+ * prettyBytes(1337, {locale: 'de'});
+ * //=> '1,34 kB'
+ * ```
+ *
+ * @param number - The number to format.
+ * @param options - The options to use.
+ * @returns The formatted string.
+ */
+declare function prettyBytes(number: number, options?: Options): string;
+//#endregion
+export { prettyBytes as n, toLocaleString as r, Options as t };
+//# sourceMappingURL=pretty-bytes-Dv8t5D6N.d.cts.map

package/dist/pretty-bytes-Dv8t5D6N.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretty-bytes-Dv8t5D6N.d.cts","names":[],"sources":["../src/pretty-bytes.ts"],"sourcesContent":[],"mappings":";UAkBiB,OAAA;EAAA;AAgKjB;AAiDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAjDa,oGAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8CK,WAAA,2BAAsC"}

package/dist/pretty-bytes-aHFwwFbw.cjs

@@ -0,0 +1 @@
+const e=[`B`,`kB`,`MB`,`GB`,`TB`,`PB`,`EB`,`ZB`,`YB`],t=[`B`,`KiB`,`MiB`,`GiB`,`TiB`,`PiB`,`EiB`,`ZiB`,`YiB`],n=[`b`,`kbit`,`Mbit`,`Gbit`,`Tbit`,`Pbit`,`Ebit`,`Zbit`,`Ybit`],r=[`b`,`kibit`,`Mibit`,`Gibit`,`Tibit`,`Pibit`,`Eibit`,`Zibit`,`Yibit`],i=(e,t,n={})=>{let r=e,i=t;return typeof i==`string`?(i||=process.env.STORM_LOCALE||`en-US`,Array.isArray(i)&&(r=e?.toLocaleString(i,n))):(i===!0||n!==void 0)&&(r=e?.toLocaleString(void 0,n)),String(r)};function a(a,o){let s=a;if(!Number.isFinite(s))throw TypeError(`Expected a finite number, got ${typeof s}: ${s}`);let c={bits:!1,binary:!1,space:!0,...o},l=c.bits?c.binary?r:n:c.binary?t:e,u=c.space?` `:``;if(c.signed&&s===0)return` 0${u}${l[0]}`;let d=s<0,f=d?`-`:c.signed?`+`:``;d&&(s=-s);let p;if(c.minimumFractionDigits!==void 0&&(p={minimumFractionDigits:c.minimumFractionDigits}),c.maximumFractionDigits!==void 0&&(p={maximumFractionDigits:c.maximumFractionDigits,...p}),s<1)return f+i(s,c.locale,p)+u+l[0];let m=Math.min(Math.floor(c.binary?Math.log(s)/Math.log(1024):Math.log10(s)/3),l.length-1);s/=(c.binary?1024:1e3)**m,p||(s=s.toPrecision(3));let h=i(Number(s),c.locale,p),g=l[m];return f+h+u+g}Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return a}});

package/dist/pretty-bytes.cjs

@@ -1,48 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.prettyBytes = prettyBytes;
-exports.toLocaleString = void 0;
-const u = ["B", "kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"],
-  B = ["B", "KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB"],
-  f = ["b", "kbit", "Mbit", "Gbit", "Tbit", "Pbit", "Ebit", "Zbit", "Ybit"],
-  y = ["b", "kibit", "Mibit", "Gibit", "Tibit", "Pibit", "Eibit", "Zibit", "Yibit"];
-const toLocaleString = (r, o, i = {}) => {
-  let t = r,
-    n = o;
-  return typeof n == "string" ? (n || (n = process.env.STORM_LOCALE || "en-US"), Array.isArray(n) && (t = r?.toLocaleString(n, i))) : (n === !0 || i !== void 0) && (t = r?.toLocaleString(void 0, i)), String(t);
-};
-exports.toLocaleString = toLocaleString;
-function prettyBytes(r, o) {
-  let i = r;
-  if (!Number.isFinite(i)) throw new TypeError(`Expected a finite number, got ${typeof i}: ${i}`);
-  const t = {
-      bits: !1,
-      binary: !1,
-      space: !0,
-      ...o
-    },
-    n = t.bits ? t.binary ? y : f : t.binary ? B : u,
-    a = t.space ? " " : "";
-  if (t.signed && i === 0) return ` 0${a}${n[0]}`;
-  const s = i < 0,
-    b = s ? "-" : t.signed ? "+" : "";
-  s && (i = -i);
-  let e;
-  if (t.minimumFractionDigits !== void 0 && (e = {
-    minimumFractionDigits: t.minimumFractionDigits
-  }), t.maximumFractionDigits !== void 0 && (e = {
-    maximumFractionDigits: t.maximumFractionDigits,
-    ...e
-  }), i < 1) {
-    const g = toLocaleString(i, t.locale, e);
-    return b + g + a + n[0];
-  }
-  const l = Math.min(Math.floor(t.binary ? Math.log(i) / Math.log(1024) : Math.log10(i) / 3), n.length - 1);
-  i /= (t.binary ? 1024 : 1e3) ** l, e || (i = i.toPrecision(3));
-  const c = toLocaleString(Number(i), t.locale, e),
-    m = n[l];
-  return b + c + a + m;
-}
+const e=require(`./pretty-bytes-aHFwwFbw.cjs`);exports.prettyBytes=e.t,exports.toLocaleString=e.n;

package/dist/pretty-bytes.d.cts

@@ -0,0 +1,2 @@
+import { n as prettyBytes, r as toLocaleString, t as Options } from "./pretty-bytes-Dv8t5D6N.cjs";
+export { Options, prettyBytes, toLocaleString };

package/dist/pretty-bytes.d.mts

@@ -0,0 +1,2 @@
+import { n as prettyBytes, r as toLocaleString, t as Options } from "./pretty-bytes-Dam2n54B.mjs";
+export { Options, prettyBytes, toLocaleString };

package/dist/pretty-bytes.mjs

@@ -1 +1 @@
-const u=["B","kB","MB","GB","TB","PB","EB","ZB","YB"],B=["B","KiB","MiB","GiB","TiB","PiB","EiB","ZiB","YiB"],f=["b","kbit","Mbit","Gbit","Tbit","Pbit","Ebit","Zbit","Ybit"],y=["b","kibit","Mibit","Gibit","Tibit","Pibit","Eibit","Zibit","Yibit"];export const toLocaleString=(r,o,i={})=>{let t=r,n=o;return typeof n=="string"?(n||(n=process.env.STORM_LOCALE||"en-US"),Array.isArray(n)&&(t=r?.toLocaleString(n,i))):(n===!0||i!==void 0)&&(t=r?.toLocaleString(void 0,i)),String(t)};export function prettyBytes(r,o){let i=r;if(!Number.isFinite(i))throw new TypeError(`Expected a finite number, got ${typeof i}: ${i}`);const t={bits:!1,binary:!1,space:!0,...o},n=t.bits?t.binary?y:f:t.binary?B:u,a=t.space?" ":"";if(t.signed&&i===0)return` 0${a}${n[0]}`;const s=i<0,b=s?"-":t.signed?"+":"";s&&(i=-i);let e;if(t.minimumFractionDigits!==void 0&&(e={minimumFractionDigits:t.minimumFractionDigits}),t.maximumFractionDigits!==void 0&&(e={maximumFractionDigits:t.maximumFractionDigits,...e}),i<1){const g=toLocaleString(i,t.locale,e);return b+g+a+n[0]}const l=Math.min(Math.floor(t.binary?Math.log(i)/Math.log(1024):Math.log10(i)/3),n.length-1);i/=(t.binary?1024:1e3)**l,e||(i=i.toPrecision(3));const c=toLocaleString(Number(i),t.locale,e),m=n[l];return b+c+a+m}
+import{n as e,t}from"./pretty-bytes-DmvsumO5.mjs";export{t as prettyBytes,e as toLocaleString};

package/dist/{snake-case.d.ts → snake-case-C5v7aTGP.d.cts}

@@ -1,5 +1,6 @@
-export interface SnakeCaseOptions {
-    splitOnNumber: boolean;
+//#region src/snake-case.d.ts
+interface SnakeCaseOptions {
+  splitOnNumber: boolean;
 }
 /**
  * Check if the input string is in snake case.
@@ -10,7 +11,7 @@ export interface SnakeCaseOptions {
  * @param input - The input string to check.
  * @returns True if the input is in snake case, false otherwise.
  */
-export declare function isSnakeCase(input: string | undefined): boolean;
+declare function isSnakeCase(input: string | undefined): boolean;
 /**
  * Convert the input string to snake case.
  *
@@ -21,4 +22,7 @@ export declare function isSnakeCase(input: string | undefined): boolean;
  * @param options - Options to control the behavior of the function.
  * @returns The snake-cased string.
  */
-export declare function snakeCase<T extends string | undefined>(input: T, options?: SnakeCaseOptions): T;
+declare function snakeCase<T extends string | undefined>(input: T, options?: SnakeCaseOptions): T;
+//#endregion
+export { isSnakeCase as n, snakeCase as r, SnakeCaseOptions as t };
+//# sourceMappingURL=snake-case-C5v7aTGP.d.cts.map

package/dist/snake-case-C5v7aTGP.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snake-case-C5v7aTGP.d.cts","names":[],"sources":["../src/snake-case.ts"],"sourcesContent":[],"mappings":";UAsBiB,gBAAA;EAAA,aAAA,EAAA,OAAgB;AAajC;AAcA;;;;;;;;;iBAdgB,WAAA;;;;;;;;;;;iBAcA,+CACP,aACG,mBACT"}

package/dist/snake-case-CKf8oDuS.d.mts

@@ -0,0 +1,28 @@
+//#region src/snake-case.d.ts
+interface SnakeCaseOptions {
+  splitOnNumber: boolean;
+}
+/**
+ * Check if the input string is in snake case.
+ *
+ * @remarks
+ * Snake case is defined as all lowercase letters with underscores separating words - "this_is_an_example"
+ *
+ * @param input - The input string to check.
+ * @returns True if the input is in snake case, false otherwise.
+ */
+declare function isSnakeCase(input: string | undefined): boolean;
+/**
+ * Convert the input string to snake case.
+ *
+ *  @remarks
+ * Snake case is defined as all lowercase letters with underscores separating words - "this_is_an_example"
+ *
+ * @param input - The input string.
+ * @param options - Options to control the behavior of the function.
+ * @returns The snake-cased string.
+ */
+declare function snakeCase<T extends string | undefined>(input: T, options?: SnakeCaseOptions): T;
+//#endregion
+export { isSnakeCase as n, snakeCase as r, SnakeCaseOptions as t };
+//# sourceMappingURL=snake-case-CKf8oDuS.d.mts.map

package/dist/snake-case-CKf8oDuS.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snake-case-CKf8oDuS.d.mts","names":[],"sources":["../src/snake-case.ts"],"sourcesContent":[],"mappings":";UAsBiB,gBAAA;EAAA,aAAA,EAAA,OAAgB;AAajC;AAcA;;;;;;;;;iBAdgB,WAAA;;;;;;;;;;;iBAcA,+CACP,aACG,mBACT"}

package/dist/snake-case.cjs

@@ -1,22 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.isSnakeCase = isSnakeCase;
-exports.snakeCase = snakeCase;
-var _types = require("@stryke/types");
-var _constantCase = require("./constant-case.cjs");
-var _upperCaseFirst = require("./upper-case-first.cjs");
-function isSnakeCase(e) {
-  return e ? /^[a-z]+(?:_[a-z0-9]+)*$/.test(e) : !1;
-}
-function snakeCase(e, n) {
-  if (isSnakeCase(e) || e === void 0) return e;
-  if ((0, _constantCase.isConstantCase)(e)) return e.toLowerCase();
-  const s = e?.replace(/[A-Z]+/g, r => (0, _upperCaseFirst.upperCaseFirst)(r) ?? _types.EMPTY_STRING).split(/(?=[A-Z])|[\s._-]/).map(r => r.toLowerCase()) ?? [];
-  if (s.length === 0) return "";
-  if (s.length === 1) return s[0];
-  const t = s.reduce((r, a) => `${r}_${a.toLowerCase()}`);
-  return n?.splitOnNumber === !1 ? t : t.replace(/[A-Z]\d/i, r => `${r[0]}_${r[1]}`);
-}
+const e=require(`./constant-case-B0oTEBjC.cjs`);exports.isSnakeCase=e.r,exports.snakeCase=e.i;

package/dist/snake-case.d.cts

@@ -0,0 +1,2 @@
+import { n as isSnakeCase, r as snakeCase, t as SnakeCaseOptions } from "./snake-case-C5v7aTGP.cjs";
+export { SnakeCaseOptions, isSnakeCase, snakeCase };

package/dist/snake-case.d.mts

@@ -0,0 +1,2 @@
+import { n as isSnakeCase, r as snakeCase, t as SnakeCaseOptions } from "./snake-case-CKf8oDuS.mjs";
+export { SnakeCaseOptions, isSnakeCase, snakeCase };

package/dist/snake-case.mjs

@@ -1 +1 @@
-import{EMPTY_STRING as o}from"@stryke/types";import{isConstantCase as i}from"./constant-case";import{upperCaseFirst as f}from"./upper-case-first";export function isSnakeCase(e){return e?/^[a-z]+(?:_[a-z0-9]+)*$/.test(e):!1}export function snakeCase(e,n){if(isSnakeCase(e)||e===void 0)return e;if(i(e))return e.toLowerCase();const s=e?.replace(/[A-Z]+/g,r=>f(r)??o).split(/(?=[A-Z])|[\s._-]/).map(r=>r.toLowerCase())??[];if(s.length===0)return"";if(s.length===1)return s[0];const t=s.reduce((r,a)=>`${r}_${a.toLowerCase()}`);return n?.splitOnNumber===!1?t:t.replace(/[A-Z]\d/i,r=>`${r[0]}_${r[1]}`)}
+import{i as e,r as t}from"./constant-case-Cn0OS_D5.mjs";export{t as isSnakeCase,e as snakeCase};

package/dist/special-cases-Ab3-SD5v.d.cts

@@ -0,0 +1,5 @@
+//#region src/special-cases.d.ts
+declare const SPECIAL_CASES: string[];
+//#endregion
+export { SPECIAL_CASES as t };
+//# sourceMappingURL=special-cases-Ab3-SD5v.d.cts.map

package/dist/special-cases-Ab3-SD5v.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"special-cases-Ab3-SD5v.d.cts","names":[],"sources":["../src/special-cases.ts"],"sourcesContent":[],"mappings":";cAkBa"}

package/dist/special-cases-CfBSDTk8.cjs

@@ -0,0 +1 @@
+const e=`2FA.4K.5K.8K.AGI.BI.ChatGPT.CTA.DateTime.FMS.GitHub.GPT.HD.IBMid.IDs.iMac.IMAX.iOS.iPad.iPhone.iPod.LDAP.LinkedIn.LLM.macOS.McDonalds.MCP.ML.MySQL.NLG.NLP.NLU.OpenAI.PDFs.PIM.PEFT.pH.PostgreSQL.SEO.TTS.UHD.UUID.XSS.YouTube.CSpell.ESLint`.split(`.`);Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return e}});

package/dist/special-cases-D7iFXvkR.d.mts

@@ -0,0 +1,5 @@
+//#region src/special-cases.d.ts
+declare const SPECIAL_CASES: string[];
+//#endregion
+export { SPECIAL_CASES as t };
+//# sourceMappingURL=special-cases-D7iFXvkR.d.mts.map

package/dist/special-cases-D7iFXvkR.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"special-cases-D7iFXvkR.d.mts","names":[],"sources":["../src/special-cases.ts"],"sourcesContent":[],"mappings":";cAkBa"}

package/dist/special-cases-gNNOSEbK.mjs

@@ -0,0 +1,2 @@
+const e=`2FA.4K.5K.8K.AGI.BI.ChatGPT.CTA.DateTime.FMS.GitHub.GPT.HD.IBMid.IDs.iMac.IMAX.iOS.iPad.iPhone.iPod.LDAP.LinkedIn.LLM.macOS.McDonalds.MCP.ML.MySQL.NLG.NLP.NLU.OpenAI.PDFs.PIM.PEFT.pH.PostgreSQL.SEO.TTS.UHD.UUID.XSS.YouTube.CSpell.ESLint`.split(`.`);export{e as t};
+//# sourceMappingURL=special-cases-gNNOSEbK.mjs.map

package/dist/special-cases-gNNOSEbK.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"special-cases-gNNOSEbK.mjs","names":[],"sources":["../src/special-cases.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport const SPECIAL_CASES = [\n  \"2FA\",\n  \"4K\",\n  \"5K\",\n  \"8K\",\n  \"AGI\",\n  \"BI\",\n  \"ChatGPT\",\n  \"CTA\",\n  \"DateTime\",\n  \"FMS\",\n  \"GitHub\",\n  \"GPT\",\n  \"HD\",\n  \"IBMid\",\n  \"IDs\",\n  \"iMac\",\n  \"IMAX\",\n  \"iOS\",\n  \"iPad\",\n  \"iPhone\",\n  \"iPod\",\n  \"LDAP\",\n  \"LinkedIn\",\n  \"LLM\",\n  \"macOS\",\n  \"McDonalds\",\n  \"MCP\",\n  \"ML\",\n  \"MySQL\",\n  \"NLG\",\n  \"NLP\",\n  \"NLU\",\n  \"OpenAI\",\n  \"PDFs\",\n  \"PIM\",\n  \"PEFT\",\n  \"pH\",\n  \"PostgreSQL\",\n  \"SEO\",\n  \"TTS\",\n  \"UHD\",\n  \"UUID\",\n  \"XSS\",\n  \"YouTube\",\n  \"CSpell\",\n  \"ESLint\"\n];\n"],"mappings":"AAkBA,MAAa,EAAgB,yPA+C5B"}

package/dist/special-cases.cjs

@@ -1,7 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.SPECIAL_CASES = void 0;
-const SPECIAL_CASES = exports.SPECIAL_CASES = ["2FA", "4K", "5K", "8K", "AGI", "BI", "ChatGPT", "CTA", "DateTime", "FMS", "GitHub", "GPT", "HD", "IBMid", "IDs", "iMac", "IMAX", "iOS", "iPad", "iPhone", "iPod", "LDAP", "LinkedIn", "LLM", "macOS", "McDonalds", "MCP", "ML", "MySQL", "NLG", "NLP", "NLU", "OpenAI", "PDFs", "PIM", "PEFT", "pH", "PostgreSQL", "SEO", "TTS", "UHD", "UUID", "XSS", "YouTube", "CSpell", "ESLint"];
+const e=require(`./special-cases-CfBSDTk8.cjs`);exports.SPECIAL_CASES=e.t;

package/dist/special-cases.d.cts

@@ -0,0 +1,2 @@
+import { t as SPECIAL_CASES } from "./special-cases-Ab3-SD5v.cjs";
+export { SPECIAL_CASES };

package/dist/special-cases.d.mts

@@ -0,0 +1,2 @@
+import { t as SPECIAL_CASES } from "./special-cases-D7iFXvkR.mjs";
+export { SPECIAL_CASES };

package/dist/special-cases.mjs

@@ -1 +1 @@
-export const SPECIAL_CASES=["2FA","4K","5K","8K","AGI","BI","ChatGPT","CTA","DateTime","FMS","GitHub","GPT","HD","IBMid","IDs","iMac","IMAX","iOS","iPad","iPhone","iPod","LDAP","LinkedIn","LLM","macOS","McDonalds","MCP","ML","MySQL","NLG","NLP","NLU","OpenAI","PDFs","PIM","PEFT","pH","PostgreSQL","SEO","TTS","UHD","UUID","XSS","YouTube","CSpell","ESLint"];
+import{t as e}from"./special-cases-gNNOSEbK.mjs";export{e as SPECIAL_CASES};

package/dist/{start-case.d.ts → start-case-B9JLArn_.d.mts}

@@ -1,3 +1,4 @@
+//#region src/start-case.d.ts
 /**
  * Check if the input string is in snake case.
  *
@@ -7,7 +8,7 @@
  * @param input - The input string to check.
  * @returns True if the input is in start case, false otherwise.
  */
-export declare function isStartCase(input: string | undefined): boolean;
+declare function isStartCase(input: string | undefined): boolean;
 /**
  * Converts the first character of each word in a string to uppercase and the remaining characters to lowercase.
  *
@@ -25,4 +26,7 @@ export declare function isStartCase(input: string | undefined): boolean;
  * @param input - The string to convert.
  * @returns The converted string.
  */
-export declare function startCase<T extends string | undefined>(input?: T): T;
+declare function startCase<T extends string | undefined>(input?: T): T;
+//#endregion
+export { startCase as n, isStartCase as t };
+//# sourceMappingURL=start-case-B9JLArn_.d.mts.map

package/dist/start-case-B9JLArn_.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-case-B9JLArn_.d.mts","names":[],"sources":["../src/start-case.ts"],"sourcesContent":[],"mappings":";;AA6BA;AAqBA;;;;;;;iBArBgB,WAAA;;;;;;;;;;;;;;;;;;iBAqBA,gDAAgD,IAAI"}

package/dist/start-case-CbdCqiBN.mjs

@@ -0,0 +1,2 @@
+import{r as e}from"./get-words-vlruPM_Q.mjs";function t(e){return e?/^[A-Z][a-z]*(?: [A-Z][a-z]*)*$/.test(e):!1}function n(n){if(t(n)||n===void 0)return n;let r=e(n.trim()),i=``;for(let e of r)e&&e[0]&&(i&&(i+=` `),i+=e===e.toUpperCase()?e:e[0].toUpperCase()+e.slice(1).toLowerCase());return i}export{n,t};
+//# sourceMappingURL=start-case-CbdCqiBN.mjs.map

package/dist/start-case-CbdCqiBN.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-case-CbdCqiBN.mjs","names":[],"sources":["../src/start-case.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { getWords } from \"./get-words\";\n\n/**\n * Check if the input string is in snake case.\n *\n * @remarks\n * Start case is the naming convention in which each word is written with an initial capital letter - \"This Is An Example\".\n *\n * @param input - The input string to check.\n * @returns True if the input is in start case, false otherwise.\n */\nexport function isStartCase(input: string | undefined): boolean {\n  return input ? /^[A-Z][a-z]*(?: [A-Z][a-z]*)*$/.test(input) : false;\n}\n\n/**\n * Converts the first character of each word in a string to uppercase and the remaining characters to lowercase.\n *\n * @remarks\n * Start case is the naming convention in which each word is written with an initial capital letter - \"This Is An Example\".\n *\n * @example\n * ```ts\n * const result1 = startCase('hello world');  // result will be 'Hello World'\n * const result2 = startCase('HELLO WORLD');  // result will be 'Hello World'\n * const result3 = startCase('hello-world');  // result will be 'Hello World'\n * const result4 = startCase('hello_world');  // result will be 'Hello World'\n * ```\n *\n * @param input - The string to convert.\n * @returns The converted string.\n */\nexport function startCase<T extends string | undefined>(input?: T): T {\n  if (isStartCase(input) || input === undefined) {\n    return input as T;\n  }\n\n  const words = getWords(input.trim());\n\n  let result = \"\";\n  for (const word of words) {\n    if (word && word[0]) {\n      if (result) {\n        result += \" \";\n      }\n\n      result +=\n        word === word.toUpperCase()\n          ? word\n          : word[0].toUpperCase() + word.slice(1).toLowerCase();\n    }\n  }\n\n  return result as T;\n}\n"],"mappings":"6CA6BA,SAAgB,EAAY,EAAoC,CAC9D,OAAO,EAAQ,iCAAiC,KAAK,EAAM,CAAG,GAoBhE,SAAgB,EAAwC,EAAc,CACpE,GAAI,EAAY,EAAM,EAAI,IAAU,IAAA,GAClC,OAAO,EAGT,IAAM,EAAQ,EAAS,EAAM,MAAM,CAAC,CAEhC,EAAS,GACb,IAAK,IAAM,KAAQ,EACb,GAAQ,EAAK,KACX,IACF,GAAU,KAGZ,GACE,IAAS,EAAK,aAAa,CACvB,EACA,EAAK,GAAG,aAAa,CAAG,EAAK,MAAM,EAAE,CAAC,aAAa,EAI7D,OAAO"}

package/dist/start-case-ChU_5Pyw.cjs

@@ -0,0 +1 @@
+const e=require(`./get-words-IF97Rpfr.cjs`);function t(e){return e?/^[A-Z][a-z]*(?: [A-Z][a-z]*)*$/.test(e):!1}function n(n){if(t(n)||n===void 0)return n;let r=e.r(n.trim()),i=``;for(let e of r)e&&e[0]&&(i&&(i+=` `),i+=e===e.toUpperCase()?e:e[0].toUpperCase()+e.slice(1).toLowerCase());return i}Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return t}});