yummies 7.19.4 → 7.20.0

package/ms.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ms.cjs","names":[],"sources":["../src/ms.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/ms\n *\n * ## Description\n *\n * Converts human-friendly time units (seconds, minutes, hours, days, weeks) to **milliseconds** for\n * timers, animations, and `dayjs`-style math. The `unitsToMs` map is shared across the library so\n * delays and durations stay consistent instead of scattering `* 1000` literals through the code.\n *\n * ## Usage\n *\n * ```ts\n * import { ms } from \"yummies/ms\";\n * ```\n */\n\nexport const unitsToMs = {\n  ms: 1,\n  sec: 1000,\n  min: 1000 * 60,\n  hour: 1000 * 60 * 60,\n  day: 1000 * 60 * 60 * 24,\n  week: 1000 * 60 * 60 * 24 * 7,\n} as const;\n\n/**\n * Converts a value in the specified unit to milliseconds.\n *\n * @example\n * ```ts\n * ms(1, 'min') // 60_000\n * ms(30, 'sec') // 30_000\n * ```\n */\nexport const ms = (value: number, unit: keyof typeof unitsToMs = 'ms') =>\n  value * unitsToMs[unit];\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,IAAa,YAAY;CACvB,IAAI;CACJ,KAAK;CACL,KAAK,MAAO;CACZ,MAAM,MAAO,KAAK;CAClB,KAAK,MAAO,KAAK,KAAK;CACtB,MAAM,MAAO,KAAK,KAAK,KAAK;CAC7B;;;;;;;;;;AAWD,IAAa,MAAM,OAAe,OAA+B,SAC/D,QAAQ,UAAU"}
+{"version":3,"file":"ms.cjs","names":[],"sources":["../src/ms/units-to-ms.ts","../src/ms/ms.ts"],"sourcesContent":["export const unitsToMs = {\n  ms: 1,\n  sec: 1000,\n  min: 1000 * 60,\n  hour: 1000 * 60 * 60,\n  day: 1000 * 60 * 60 * 24,\n  week: 1000 * 60 * 60 * 24 * 7,\n} as const;\n","import { unitsToMs } from './units-to-ms.js';\n\n/**\n * Converts a value in the specified unit to milliseconds.\n *\n * @example\n * ```ts\n * ms(1, 'min') // 60_000\n * ms(30, 'sec') // 30_000\n * ```\n */\nexport const ms = (value: number, unit: keyof typeof unitsToMs = 'ms') =>\n  value * unitsToMs[unit];\n"],"mappings":";;AAAA,IAAa,YAAY;CACvB,IAAI;CACJ,KAAK;CACL,KAAK,MAAO;CACZ,MAAM,MAAO,KAAK;CAClB,KAAK,MAAO,KAAK,KAAK;CACtB,MAAM,MAAO,KAAK,KAAK,KAAK;AAC9B;;;;;;;;;;;;ACIA,IAAa,MAAM,OAAe,OAA+B,SAC/D,QAAQ,UAAU"}

package/ms.d.ts

@@ -1,19 +1,3 @@
-/**
- * ---header-docs-section---
- * # yummies/ms
- *
- * ## Description
- *
- * Converts human-friendly time units (seconds, minutes, hours, days, weeks) to **milliseconds** for
- * timers, animations, and `dayjs`-style math. The `unitsToMs` map is shared across the library so
- * delays and durations stay consistent instead of scattering `* 1000` literals through the code.
- *
- * ## Usage
- *
- * ```ts
- * import { ms } from "yummies/ms";
- * ```
- */
 declare const unitsToMs: {
     readonly ms: 1;
     readonly sec: 1000;
@@ -22,6 +6,7 @@ declare const unitsToMs: {
     readonly day: number;
     readonly week: number;
 };
+
 /**
  * Converts a value in the specified unit to milliseconds.
  *

package/ms.js

@@ -1,20 +1,4 @@
-//#region src/ms.ts
-/**
-* ---header-docs-section---
-* # yummies/ms
-*
-* ## Description
-*
-* Converts human-friendly time units (seconds, minutes, hours, days, weeks) to **milliseconds** for
-* timers, animations, and `dayjs`-style math. The `unitsToMs` map is shared across the library so
-* delays and durations stay consistent instead of scattering `* 1000` literals through the code.
-*
-* ## Usage
-*
-* ```ts
-* import { ms } from "yummies/ms";
-* ```
-*/
+//#region src/ms/units-to-ms.ts
 var unitsToMs = {
 	ms: 1,
 	sec: 1e3,
@@ -23,6 +7,8 @@ var unitsToMs = {
 	day: 1e3 * 60 * 60 * 24,
 	week: 1e3 * 60 * 60 * 24 * 7
 };
+//#endregion
+//#region src/ms/ms.ts
 /**
 * Converts a value in the specified unit to milliseconds.
 *

package/ms.js.map

@@ -1 +1 @@
-{"version":3,"file":"ms.js","names":[],"sources":["../src/ms.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/ms\n *\n * ## Description\n *\n * Converts human-friendly time units (seconds, minutes, hours, days, weeks) to **milliseconds** for\n * timers, animations, and `dayjs`-style math. The `unitsToMs` map is shared across the library so\n * delays and durations stay consistent instead of scattering `* 1000` literals through the code.\n *\n * ## Usage\n *\n * ```ts\n * import { ms } from \"yummies/ms\";\n * ```\n */\n\nexport const unitsToMs = {\n  ms: 1,\n  sec: 1000,\n  min: 1000 * 60,\n  hour: 1000 * 60 * 60,\n  day: 1000 * 60 * 60 * 24,\n  week: 1000 * 60 * 60 * 24 * 7,\n} as const;\n\n/**\n * Converts a value in the specified unit to milliseconds.\n *\n * @example\n * ```ts\n * ms(1, 'min') // 60_000\n * ms(30, 'sec') // 30_000\n * ```\n */\nexport const ms = (value: number, unit: keyof typeof unitsToMs = 'ms') =>\n  value * unitsToMs[unit];\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,IAAa,YAAY;CACvB,IAAI;CACJ,KAAK;CACL,KAAK,MAAO;CACZ,MAAM,MAAO,KAAK;CAClB,KAAK,MAAO,KAAK,KAAK;CACtB,MAAM,MAAO,KAAK,KAAK,KAAK;CAC7B;;;;;;;;;;AAWD,IAAa,MAAM,OAAe,OAA+B,SAC/D,QAAQ,UAAU"}
+{"version":3,"file":"ms.js","names":[],"sources":["../src/ms/units-to-ms.ts","../src/ms/ms.ts"],"sourcesContent":["export const unitsToMs = {\n  ms: 1,\n  sec: 1000,\n  min: 1000 * 60,\n  hour: 1000 * 60 * 60,\n  day: 1000 * 60 * 60 * 24,\n  week: 1000 * 60 * 60 * 24 * 7,\n} as const;\n","import { unitsToMs } from './units-to-ms.js';\n\n/**\n * Converts a value in the specified unit to milliseconds.\n *\n * @example\n * ```ts\n * ms(1, 'min') // 60_000\n * ms(30, 'sec') // 30_000\n * ```\n */\nexport const ms = (value: number, unit: keyof typeof unitsToMs = 'ms') =>\n  value * unitsToMs[unit];\n"],"mappings":";AAAA,IAAa,YAAY;CACvB,IAAI;CACJ,KAAK;CACL,KAAK,MAAO;CACZ,MAAM,MAAO,KAAK;CAClB,KAAK,MAAO,KAAK,KAAK;CACtB,MAAM,MAAO,KAAK,KAAK,KAAK;AAC9B;;;;;;;;;;;;ACIA,IAAa,MAAM,OAAe,OAA+B,SAC/D,QAAQ,UAAU"}

package/number.cjs

@@ -1,21 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/number.ts
-/**
-* ---header-docs-section---
-* # yummies/number
-*
-* ## Description
-*
-* Numeric rounding that avoids classic floating-point artifacts (`191.212999…`) without paying for
-* string round-trips in hot paths. Use when formatting prices, charts, or sliders where a fixed
-* decimal count must be stable for display and comparisons.
-*
-* ## Usage
-*
-* ```ts
-* import { round } from "yummies/number";
-* ```
-*/
+//#region src/number/round.ts
 /**
 * Works like `parseFloat(number.toFixed(4))` but performance better
 *

package/number.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"number.cjs","names":[],"sources":["../src/number.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/number\n *\n * ## Description\n *\n * Numeric rounding that avoids classic floating-point artifacts (`191.212999…`) without paying for\n * string round-trips in hot paths. Use when formatting prices, charts, or sliders where a fixed\n * decimal count must be stable for display and comparisons.\n *\n * ## Usage\n *\n * ```ts\n * import { round } from \"yummies/number\";\n * ```\n */\n\n/**\n * Works like `parseFloat(number.toFixed(4))` but performance better\n *\n * @example\n * round(191.212999999999999999999999, 4) // 191.213\n */\nexport function round(value: number, decimalPlaces: number = 0): number {\n  if (!decimalPlaces) {\n    return Math.round(value);\n  }\n\n  const factor = 10 ** decimalPlaces;\n  return Math.round(value * factor) / factor;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,MAAM,OAAe,gBAAwB,GAAW;AACtE,KAAI,CAAC,cACH,QAAO,KAAK,MAAM,MAAM;CAG1B,MAAM,SAAS,MAAM;AACrB,QAAO,KAAK,MAAM,QAAQ,OAAO,GAAG"}
+{"version":3,"file":"number.cjs","names":[],"sources":["../src/number/round.ts"],"sourcesContent":["/**\n * Works like `parseFloat(number.toFixed(4))` but performance better\n *\n * @example\n * round(191.212999999999999999999999, 4) // 191.213\n */\nexport function round(value: number, decimalPlaces: number = 0): number {\n  if (!decimalPlaces) {\n    return Math.round(value);\n  }\n\n  const factor = 10 ** decimalPlaces;\n  return Math.round(value * factor) / factor;\n}\n"],"mappings":";;;;;;;;AAMA,SAAgB,MAAM,OAAe,gBAAwB,GAAW;CACtE,IAAI,CAAC,eACH,OAAO,KAAK,MAAM,KAAK;CAGzB,MAAM,SAAS,MAAM;CACrB,OAAO,KAAK,MAAM,QAAQ,MAAM,IAAI;AACtC"}

package/number.d.ts

@@ -1,19 +1,3 @@
-/**
- * ---header-docs-section---
- * # yummies/number
- *
- * ## Description
- *
- * Numeric rounding that avoids classic floating-point artifacts (`191.212999…`) without paying for
- * string round-trips in hot paths. Use when formatting prices, charts, or sliders where a fixed
- * decimal count must be stable for display and comparisons.
- *
- * ## Usage
- *
- * ```ts
- * import { round } from "yummies/number";
- * ```
- */
 /**
  * Works like `parseFloat(number.toFixed(4))` but performance better
  *

package/number.js

@@ -1,20 +1,4 @@
-//#region src/number.ts
-/**
-* ---header-docs-section---
-* # yummies/number
-*
-* ## Description
-*
-* Numeric rounding that avoids classic floating-point artifacts (`191.212999…`) without paying for
-* string round-trips in hot paths. Use when formatting prices, charts, or sliders where a fixed
-* decimal count must be stable for display and comparisons.
-*
-* ## Usage
-*
-* ```ts
-* import { round } from "yummies/number";
-* ```
-*/
+//#region src/number/round.ts
 /**
 * Works like `parseFloat(number.toFixed(4))` but performance better
 *

package/number.js.map

@@ -1 +1 @@
-{"version":3,"file":"number.js","names":[],"sources":["../src/number.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/number\n *\n * ## Description\n *\n * Numeric rounding that avoids classic floating-point artifacts (`191.212999…`) without paying for\n * string round-trips in hot paths. Use when formatting prices, charts, or sliders where a fixed\n * decimal count must be stable for display and comparisons.\n *\n * ## Usage\n *\n * ```ts\n * import { round } from \"yummies/number\";\n * ```\n */\n\n/**\n * Works like `parseFloat(number.toFixed(4))` but performance better\n *\n * @example\n * round(191.212999999999999999999999, 4) // 191.213\n */\nexport function round(value: number, decimalPlaces: number = 0): number {\n  if (!decimalPlaces) {\n    return Math.round(value);\n  }\n\n  const factor = 10 ** decimalPlaces;\n  return Math.round(value * factor) / factor;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,MAAM,OAAe,gBAAwB,GAAW;AACtE,KAAI,CAAC,cACH,QAAO,KAAK,MAAM,MAAM;CAG1B,MAAM,SAAS,MAAM;AACrB,QAAO,KAAK,MAAM,QAAQ,OAAO,GAAG"}
+{"version":3,"file":"number.js","names":[],"sources":["../src/number/round.ts"],"sourcesContent":["/**\n * Works like `parseFloat(number.toFixed(4))` but performance better\n *\n * @example\n * round(191.212999999999999999999999, 4) // 191.213\n */\nexport function round(value: number, decimalPlaces: number = 0): number {\n  if (!decimalPlaces) {\n    return Math.round(value);\n  }\n\n  const factor = 10 ** decimalPlaces;\n  return Math.round(value * factor) / factor;\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,MAAM,OAAe,gBAAwB,GAAW;CACtE,IAAI,CAAC,eACH,OAAO,KAAK,MAAM,KAAK;CAGzB,MAAM,SAAS,MAAM;CACrB,OAAO,KAAK,MAAM,QAAQ,MAAM,IAAI;AACtC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yummies",
-  "version": "7.19.4",
+  "version": "7.20.0",
   "keywords": [
     "javascript",
     "typescript",
@@ -15,7 +15,7 @@
   "homepage": "https://js2me.github.io/yummies/api/async/",
   "repository": {
     "type": "git",
-    "url": "git://github.com/js2me/yummies"
+    "url": "git+https://github.com/js2me/yummies.git"
   },
   "peerDependencies": {
     "mobx": "^6.12.4",
@@ -33,10 +33,10 @@
   "dependencies": {
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "dayjs": "^1.11.20",
-    "dompurify": "^3.4.1",
-    "nanoid": "^5.1.7",
-    "tailwind-merge": "^3.5.0"
+    "dayjs": "^1.11.21",
+    "dompurify": "^3.4.11",
+    "nanoid": "^5.1.15",
+    "tailwind-merge": "^3.6.0"
   },
   "type": "module",
   "exports": {

package/parser.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_chunk = require("./chunk-CZWwpsFl.cjs");
+const require_chunk = require("./chunk-DakpK96I.cjs");
 let yummies_type_guard = require("yummies/type-guard");
 let yummies_format = require("yummies/format");
 //#region src/parser/number.ts

package/parser.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"parser.cjs","names":[],"sources":["../src/parser/number.ts","../src/parser/percent.ts","../src/parser/string.ts","../src/parser/_exports.ts"],"sourcesContent":["import { format } from 'yummies/format';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\nexport interface NumberParserSettings<TFallback = number> {\n  digits?: number;\n  fallback?: TFallback;\n  /**\n   * Round to upper boundary\n   * 5.1 -> 6\n   */\n  ceil?: boolean;\n  /**\n   * Round to bottom boundary\n   * 5.9 -> 5\n   */\n  floor?: boolean;\n  clamped?: [min?: Maybe<number>, max?: Maybe<number>];\n}\n\n/**\n * Parses a number from raw input and optionally clamps, rounds or limits\n * fractional digits.\n *\n * Strings are normalized by removing spaces and replacing `,` with `.` before\n * parsing. Invalid inputs return the configured fallback.\n *\n * @template TFallback Fallback value type returned when parsing fails.\n * @param input Raw value to parse.\n * @param userSettings Parser settings merged with `number.defaultSettings`.\n * @returns Parsed number or fallback value.\n *\n * @example\n * ```ts\n * number('1 234,5'); // 1234.5\n * ```\n *\n * @example\n * ```ts\n * number('bad', { fallback: 0 }); // 0\n * ```\n */\nexport const number = <TFallback = number>(\n  input: Maybe<unknown>,\n  userSettings?: Maybe<NumberParserSettings<TFallback>>,\n): number | TFallback => {\n  const settings = {\n    ...number.defaultSettings,\n    ...userSettings,\n  };\n\n  const fallback = (\n    'fallback' in settings ? settings.fallback : 0\n  ) as TFallback;\n\n  let result: number;\n\n  if (typeGuard.isNumber(input)) {\n    result = input;\n  } else if (typeGuard.isString(input)) {\n    const formattedInput = format.skipSpaces(input).replace(',', '.');\n    if (formattedInput === '') {\n      result = fallback as any;\n    } else {\n      result = Number(formattedInput);\n    }\n  } else {\n    result = fallback as any;\n  }\n\n  if (typeGuard.isNumber(result)) {\n    if (settings?.clamped != null) {\n      result = Math.max(\n        settings.clamped[0] ?? -Infinity,\n        Math.min(result, settings.clamped[1] ?? Infinity),\n      );\n    }\n\n    if (settings?.ceil != null) {\n      result = Math.ceil(result);\n    }\n\n    if (settings?.floor != null) {\n      result = Math.floor(result);\n    }\n\n    if (settings?.digits != null) {\n      result = +result.toFixed(settings.digits);\n    }\n\n    return result;\n  } else {\n    return fallback;\n  }\n};\n\nnumber.defaultSettings = {} as NumberParserSettings;\n","import type { Maybe } from 'yummies/types';\n\nimport { type NumberParserSettings, number } from './number.js';\n\n/**\n * Converts a value into a percentage of `maxValue` and parses the result with\n * the shared numeric parser.\n *\n * @template TFallback Fallback value type returned when parsing fails.\n * @param value Current value.\n * @param maxValue Maximum value representing `100%`.\n * @param settings Numeric parser settings for the computed percentage.\n * @returns Parsed percentage or fallback value.\n *\n * @example\n * ```ts\n * percent(25, 200); // 12.5\n * ```\n *\n * @example\n * ```ts\n * percent('bad', 100, { fallback: 0 }); // 0\n * ```\n */\nexport const percent = <TFallback = number>(\n  value: Maybe<string | number>,\n  maxValue?: Maybe<string | number>,\n  settings?: Maybe<NumberParserSettings<TFallback>>,\n) => {\n  return number<TFallback>((Number(value) / Number(maxValue)) * 100, settings);\n};\n","import { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\nexport interface StringParserSettings<TFallback = string> {\n  fallback?: TFallback;\n  prettyJson?: boolean;\n}\n\n/**\n * Converts arbitrary input into a string representation.\n *\n * Objects are serialized with `JSON.stringify`, optionally pretty-printed, and\n * nullish values resolve to the configured fallback.\n *\n * @template TFallback Fallback value type returned for nullish input.\n * @param input Raw value to stringify.\n * @param settings String conversion settings.\n * @returns Stringified input or fallback value.\n *\n * @example\n * ```ts\n * string(123); // '123'\n * ```\n *\n * @example\n * ```ts\n * string({ id: 1 }, { prettyJson: true });\n * ```\n */\nexport const string = <TFallback = string>(\n  input: Maybe<unknown>,\n  settings?: Maybe<StringParserSettings<TFallback>>,\n): string | TFallback => {\n  const fallback =\n    settings && 'fallback' in settings ? (settings.fallback as TFallback) : '';\n\n  if (input == null) {\n    return fallback;\n  }\n\n  if (typeGuard.isObject(input)) {\n    if (settings?.prettyJson) {\n      return JSON.stringify(input, null, 2);\n    }\n\n    return JSON.stringify(input);\n  }\n\n  return String(input);\n};\n","/**\n * ---header-docs-section---\n * # yummies/parser\n *\n * ## Description\n *\n * Parsers for user-entered **numbers, percents, and strings** with tolerant input and typed\n * results. Use when normalizing form values, query params, or CSV-like text before validation\n * schemas run, without duplicating regex and `parseFloat` edge cases in every feature module.\n *\n * ## Usage\n *\n * ```ts\n * import { parser } from \"yummies/parser\";\n * ```\n */\n\nexport * from './number.js';\nexport * from './percent.js';\nexport * from './string.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,IAAa,UACX,OACA,iBACuB;CACvB,MAAM,WAAW;EACf,GAAG,OAAO;EACV,GAAG;EACJ;CAED,MAAM,WACJ,cAAc,WAAW,SAAS,WAAW;CAG/C,IAAI;AAEJ,KAAI,mBAAA,UAAU,SAAS,MAAM,CAC3B,UAAS;UACA,mBAAA,UAAU,SAAS,MAAM,EAAE;EACpC,MAAM,iBAAiB,eAAA,OAAO,WAAW,MAAM,CAAC,QAAQ,KAAK,IAAI;AACjE,MAAI,mBAAmB,GACrB,UAAS;MAET,UAAS,OAAO,eAAe;OAGjC,UAAS;AAGX,KAAI,mBAAA,UAAU,SAAS,OAAO,EAAE;AAC9B,MAAI,UAAU,WAAW,KACvB,UAAS,KAAK,IACZ,SAAS,QAAQ,MAAM,WACvB,KAAK,IAAI,QAAQ,SAAS,QAAQ,MAAM,SAAS,CAClD;AAGH,MAAI,UAAU,QAAQ,KACpB,UAAS,KAAK,KAAK,OAAO;AAG5B,MAAI,UAAU,SAAS,KACrB,UAAS,KAAK,MAAM,OAAO;AAG7B,MAAI,UAAU,UAAU,KACtB,UAAS,CAAC,OAAO,QAAQ,SAAS,OAAO;AAG3C,SAAO;OAEP,QAAO;;AAIX,OAAO,kBAAkB,EAAE;;;;;;;;;;;;;;;;;;;;;;;ACxE3B,IAAa,WACX,OACA,UACA,aACG;AACH,QAAO,OAAmB,OAAO,MAAM,GAAG,OAAO,SAAS,GAAI,KAAK,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;ACA9E,IAAa,UACX,OACA,aACuB;CACvB,MAAM,WACJ,YAAY,cAAc,WAAY,SAAS,WAAyB;AAE1E,KAAI,SAAS,KACX,QAAO;AAGT,KAAI,mBAAA,UAAU,SAAS,MAAM,EAAE;AAC7B,MAAI,UAAU,WACZ,QAAO,KAAK,UAAU,OAAO,MAAM,EAAE;AAGvC,SAAO,KAAK,UAAU,MAAM;;AAG9B,QAAO,OAAO,MAAM"}
+{"version":3,"file":"parser.cjs","names":[],"sources":["../src/parser/number.ts","../src/parser/percent.ts","../src/parser/string.ts","../src/parser/_exports.ts"],"sourcesContent":["import { format } from 'yummies/format';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\nexport interface NumberParserSettings<TFallback = number> {\n  digits?: number;\n  fallback?: TFallback;\n  /**\n   * Round to upper boundary\n   * 5.1 -> 6\n   */\n  ceil?: boolean;\n  /**\n   * Round to bottom boundary\n   * 5.9 -> 5\n   */\n  floor?: boolean;\n  clamped?: [min?: Maybe<number>, max?: Maybe<number>];\n}\n\n/**\n * Parses a number from raw input and optionally clamps, rounds or limits\n * fractional digits.\n *\n * Strings are normalized by removing spaces and replacing `,` with `.` before\n * parsing. Invalid inputs return the configured fallback.\n *\n * @template TFallback Fallback value type returned when parsing fails.\n * @param input Raw value to parse.\n * @param userSettings Parser settings merged with `number.defaultSettings`.\n * @returns Parsed number or fallback value.\n *\n * @example\n * ```ts\n * number('1 234,5'); // 1234.5\n * ```\n *\n * @example\n * ```ts\n * number('bad', { fallback: 0 }); // 0\n * ```\n */\nexport const number = <TFallback = number>(\n  input: Maybe<unknown>,\n  userSettings?: Maybe<NumberParserSettings<TFallback>>,\n): number | TFallback => {\n  const settings = {\n    ...number.defaultSettings,\n    ...userSettings,\n  };\n\n  const fallback = (\n    'fallback' in settings ? settings.fallback : 0\n  ) as TFallback;\n\n  let result: number;\n\n  if (typeGuard.isNumber(input)) {\n    result = input;\n  } else if (typeGuard.isString(input)) {\n    const formattedInput = format.skipSpaces(input).replace(',', '.');\n    if (formattedInput === '') {\n      result = fallback as any;\n    } else {\n      result = Number(formattedInput);\n    }\n  } else {\n    result = fallback as any;\n  }\n\n  if (typeGuard.isNumber(result)) {\n    if (settings?.clamped != null) {\n      result = Math.max(\n        settings.clamped[0] ?? -Infinity,\n        Math.min(result, settings.clamped[1] ?? Infinity),\n      );\n    }\n\n    if (settings?.ceil != null) {\n      result = Math.ceil(result);\n    }\n\n    if (settings?.floor != null) {\n      result = Math.floor(result);\n    }\n\n    if (settings?.digits != null) {\n      result = +result.toFixed(settings.digits);\n    }\n\n    return result;\n  } else {\n    return fallback;\n  }\n};\n\nnumber.defaultSettings = {} as NumberParserSettings;\n","import type { Maybe } from 'yummies/types';\n\nimport { type NumberParserSettings, number } from './number.js';\n\n/**\n * Converts a value into a percentage of `maxValue` and parses the result with\n * the shared numeric parser.\n *\n * @template TFallback Fallback value type returned when parsing fails.\n * @param value Current value.\n * @param maxValue Maximum value representing `100%`.\n * @param settings Numeric parser settings for the computed percentage.\n * @returns Parsed percentage or fallback value.\n *\n * @example\n * ```ts\n * percent(25, 200); // 12.5\n * ```\n *\n * @example\n * ```ts\n * percent('bad', 100, { fallback: 0 }); // 0\n * ```\n */\nexport const percent = <TFallback = number>(\n  value: Maybe<string | number>,\n  maxValue?: Maybe<string | number>,\n  settings?: Maybe<NumberParserSettings<TFallback>>,\n) => {\n  return number<TFallback>((Number(value) / Number(maxValue)) * 100, settings);\n};\n","import { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\nexport interface StringParserSettings<TFallback = string> {\n  fallback?: TFallback;\n  prettyJson?: boolean;\n}\n\n/**\n * Converts arbitrary input into a string representation.\n *\n * Objects are serialized with `JSON.stringify`, optionally pretty-printed, and\n * nullish values resolve to the configured fallback.\n *\n * @template TFallback Fallback value type returned for nullish input.\n * @param input Raw value to stringify.\n * @param settings String conversion settings.\n * @returns Stringified input or fallback value.\n *\n * @example\n * ```ts\n * string(123); // '123'\n * ```\n *\n * @example\n * ```ts\n * string({ id: 1 }, { prettyJson: true });\n * ```\n */\nexport const string = <TFallback = string>(\n  input: Maybe<unknown>,\n  settings?: Maybe<StringParserSettings<TFallback>>,\n): string | TFallback => {\n  const fallback =\n    settings && 'fallback' in settings ? (settings.fallback as TFallback) : '';\n\n  if (input == null) {\n    return fallback;\n  }\n\n  if (typeGuard.isObject(input)) {\n    if (settings?.prettyJson) {\n      return JSON.stringify(input, null, 2);\n    }\n\n    return JSON.stringify(input);\n  }\n\n  return String(input);\n};\n","/**\n * ---header-docs-section---\n * # yummies/parser\n *\n * ## Description\n *\n * Parsers for user-entered **numbers, percents, and strings** with tolerant input and typed\n * results. Use when normalizing form values, query params, or CSV-like text before validation\n * schemas run, without duplicating regex and `parseFloat` edge cases in every feature module.\n *\n * ## Usage\n *\n * ```ts\n * import { parser } from \"yummies/parser\";\n * ```\n */\n\nexport * from './number.js';\nexport * from './percent.js';\nexport * from './string.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,IAAa,UACX,OACA,iBACuB;CACvB,MAAM,WAAW;EACf,GAAG,OAAO;EACV,GAAG;CACL;CAEA,MAAM,WACJ,cAAc,WAAW,SAAS,WAAW;CAG/C,IAAI;CAEJ,IAAI,mBAAA,UAAU,SAAS,KAAK,GAC1B,SAAS;MACJ,IAAI,mBAAA,UAAU,SAAS,KAAK,GAAG;EACpC,MAAM,iBAAiB,eAAA,OAAO,WAAW,KAAK,EAAE,QAAQ,KAAK,GAAG;EAChE,IAAI,mBAAmB,IACrB,SAAS;OAET,SAAS,OAAO,cAAc;CAElC,OACE,SAAS;CAGX,IAAI,mBAAA,UAAU,SAAS,MAAM,GAAG;EAC9B,IAAI,UAAU,WAAW,MACvB,SAAS,KAAK,IACZ,SAAS,QAAQ,MAAM,WACvB,KAAK,IAAI,QAAQ,SAAS,QAAQ,MAAM,QAAQ,CAClD;EAGF,IAAI,UAAU,QAAQ,MACpB,SAAS,KAAK,KAAK,MAAM;EAG3B,IAAI,UAAU,SAAS,MACrB,SAAS,KAAK,MAAM,MAAM;EAG5B,IAAI,UAAU,UAAU,MACtB,SAAS,CAAC,OAAO,QAAQ,SAAS,MAAM;EAG1C,OAAO;CACT,OACE,OAAO;AAEX;AAEA,OAAO,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;ACxE1B,IAAa,WACX,OACA,UACA,aACG;CACH,OAAO,OAAmB,OAAO,KAAK,IAAI,OAAO,QAAQ,IAAK,KAAK,QAAQ;AAC7E;;;;;;;;;;;;;;;;;;;;;;;;ACDA,IAAa,UACX,OACA,aACuB;CACvB,MAAM,WACJ,YAAY,cAAc,WAAY,SAAS,WAAyB;CAE1E,IAAI,SAAS,MACX,OAAO;CAGT,IAAI,mBAAA,UAAU,SAAS,KAAK,GAAG;EAC7B,IAAI,UAAU,YACZ,OAAO,KAAK,UAAU,OAAO,MAAM,CAAC;EAGtC,OAAO,KAAK,UAAU,KAAK;CAC7B;CAEA,OAAO,OAAO,KAAK;AACrB"}

package/parser.js

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./chunk-pbuEa-1d.js";
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
 import { typeGuard } from "yummies/type-guard";
 import { format } from "yummies/format";
 //#region src/parser/number.ts

package/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","names":[],"sources":["../src/parser/number.ts","../src/parser/percent.ts","../src/parser/string.ts","../src/parser/_exports.ts"],"sourcesContent":["import { format } from 'yummies/format';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\nexport interface NumberParserSettings<TFallback = number> {\n  digits?: number;\n  fallback?: TFallback;\n  /**\n   * Round to upper boundary\n   * 5.1 -> 6\n   */\n  ceil?: boolean;\n  /**\n   * Round to bottom boundary\n   * 5.9 -> 5\n   */\n  floor?: boolean;\n  clamped?: [min?: Maybe<number>, max?: Maybe<number>];\n}\n\n/**\n * Parses a number from raw input and optionally clamps, rounds or limits\n * fractional digits.\n *\n * Strings are normalized by removing spaces and replacing `,` with `.` before\n * parsing. Invalid inputs return the configured fallback.\n *\n * @template TFallback Fallback value type returned when parsing fails.\n * @param input Raw value to parse.\n * @param userSettings Parser settings merged with `number.defaultSettings`.\n * @returns Parsed number or fallback value.\n *\n * @example\n * ```ts\n * number('1 234,5'); // 1234.5\n * ```\n *\n * @example\n * ```ts\n * number('bad', { fallback: 0 }); // 0\n * ```\n */\nexport const number = <TFallback = number>(\n  input: Maybe<unknown>,\n  userSettings?: Maybe<NumberParserSettings<TFallback>>,\n): number | TFallback => {\n  const settings = {\n    ...number.defaultSettings,\n    ...userSettings,\n  };\n\n  const fallback = (\n    'fallback' in settings ? settings.fallback : 0\n  ) as TFallback;\n\n  let result: number;\n\n  if (typeGuard.isNumber(input)) {\n    result = input;\n  } else if (typeGuard.isString(input)) {\n    const formattedInput = format.skipSpaces(input).replace(',', '.');\n    if (formattedInput === '') {\n      result = fallback as any;\n    } else {\n      result = Number(formattedInput);\n    }\n  } else {\n    result = fallback as any;\n  }\n\n  if (typeGuard.isNumber(result)) {\n    if (settings?.clamped != null) {\n      result = Math.max(\n        settings.clamped[0] ?? -Infinity,\n        Math.min(result, settings.clamped[1] ?? Infinity),\n      );\n    }\n\n    if (settings?.ceil != null) {\n      result = Math.ceil(result);\n    }\n\n    if (settings?.floor != null) {\n      result = Math.floor(result);\n    }\n\n    if (settings?.digits != null) {\n      result = +result.toFixed(settings.digits);\n    }\n\n    return result;\n  } else {\n    return fallback;\n  }\n};\n\nnumber.defaultSettings = {} as NumberParserSettings;\n","import type { Maybe } from 'yummies/types';\n\nimport { type NumberParserSettings, number } from './number.js';\n\n/**\n * Converts a value into a percentage of `maxValue` and parses the result with\n * the shared numeric parser.\n *\n * @template TFallback Fallback value type returned when parsing fails.\n * @param value Current value.\n * @param maxValue Maximum value representing `100%`.\n * @param settings Numeric parser settings for the computed percentage.\n * @returns Parsed percentage or fallback value.\n *\n * @example\n * ```ts\n * percent(25, 200); // 12.5\n * ```\n *\n * @example\n * ```ts\n * percent('bad', 100, { fallback: 0 }); // 0\n * ```\n */\nexport const percent = <TFallback = number>(\n  value: Maybe<string | number>,\n  maxValue?: Maybe<string | number>,\n  settings?: Maybe<NumberParserSettings<TFallback>>,\n) => {\n  return number<TFallback>((Number(value) / Number(maxValue)) * 100, settings);\n};\n","import { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\nexport interface StringParserSettings<TFallback = string> {\n  fallback?: TFallback;\n  prettyJson?: boolean;\n}\n\n/**\n * Converts arbitrary input into a string representation.\n *\n * Objects are serialized with `JSON.stringify`, optionally pretty-printed, and\n * nullish values resolve to the configured fallback.\n *\n * @template TFallback Fallback value type returned for nullish input.\n * @param input Raw value to stringify.\n * @param settings String conversion settings.\n * @returns Stringified input or fallback value.\n *\n * @example\n * ```ts\n * string(123); // '123'\n * ```\n *\n * @example\n * ```ts\n * string({ id: 1 }, { prettyJson: true });\n * ```\n */\nexport const string = <TFallback = string>(\n  input: Maybe<unknown>,\n  settings?: Maybe<StringParserSettings<TFallback>>,\n): string | TFallback => {\n  const fallback =\n    settings && 'fallback' in settings ? (settings.fallback as TFallback) : '';\n\n  if (input == null) {\n    return fallback;\n  }\n\n  if (typeGuard.isObject(input)) {\n    if (settings?.prettyJson) {\n      return JSON.stringify(input, null, 2);\n    }\n\n    return JSON.stringify(input);\n  }\n\n  return String(input);\n};\n","/**\n * ---header-docs-section---\n * # yummies/parser\n *\n * ## Description\n *\n * Parsers for user-entered **numbers, percents, and strings** with tolerant input and typed\n * results. Use when normalizing form values, query params, or CSV-like text before validation\n * schemas run, without duplicating regex and `parseFloat` edge cases in every feature module.\n *\n * ## Usage\n *\n * ```ts\n * import { parser } from \"yummies/parser\";\n * ```\n */\n\nexport * from './number.js';\nexport * from './percent.js';\nexport * from './string.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,IAAa,UACX,OACA,iBACuB;CACvB,MAAM,WAAW;EACf,GAAG,OAAO;EACV,GAAG;EACJ;CAED,MAAM,WACJ,cAAc,WAAW,SAAS,WAAW;CAG/C,IAAI;AAEJ,KAAI,UAAU,SAAS,MAAM,CAC3B,UAAS;UACA,UAAU,SAAS,MAAM,EAAE;EACpC,MAAM,iBAAiB,OAAO,WAAW,MAAM,CAAC,QAAQ,KAAK,IAAI;AACjE,MAAI,mBAAmB,GACrB,UAAS;MAET,UAAS,OAAO,eAAe;OAGjC,UAAS;AAGX,KAAI,UAAU,SAAS,OAAO,EAAE;AAC9B,MAAI,UAAU,WAAW,KACvB,UAAS,KAAK,IACZ,SAAS,QAAQ,MAAM,WACvB,KAAK,IAAI,QAAQ,SAAS,QAAQ,MAAM,SAAS,CAClD;AAGH,MAAI,UAAU,QAAQ,KACpB,UAAS,KAAK,KAAK,OAAO;AAG5B,MAAI,UAAU,SAAS,KACrB,UAAS,KAAK,MAAM,OAAO;AAG7B,MAAI,UAAU,UAAU,KACtB,UAAS,CAAC,OAAO,QAAQ,SAAS,OAAO;AAG3C,SAAO;OAEP,QAAO;;AAIX,OAAO,kBAAkB,EAAE;;;;;;;;;;;;;;;;;;;;;;;ACxE3B,IAAa,WACX,OACA,UACA,aACG;AACH,QAAO,OAAmB,OAAO,MAAM,GAAG,OAAO,SAAS,GAAI,KAAK,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;ACA9E,IAAa,UACX,OACA,aACuB;CACvB,MAAM,WACJ,YAAY,cAAc,WAAY,SAAS,WAAyB;AAE1E,KAAI,SAAS,KACX,QAAO;AAGT,KAAI,UAAU,SAAS,MAAM,EAAE;AAC7B,MAAI,UAAU,WACZ,QAAO,KAAK,UAAU,OAAO,MAAM,EAAE;AAGvC,SAAO,KAAK,UAAU,MAAM;;AAG9B,QAAO,OAAO,MAAM"}
+{"version":3,"file":"parser.js","names":[],"sources":["../src/parser/number.ts","../src/parser/percent.ts","../src/parser/string.ts","../src/parser/_exports.ts"],"sourcesContent":["import { format } from 'yummies/format';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\nexport interface NumberParserSettings<TFallback = number> {\n  digits?: number;\n  fallback?: TFallback;\n  /**\n   * Round to upper boundary\n   * 5.1 -> 6\n   */\n  ceil?: boolean;\n  /**\n   * Round to bottom boundary\n   * 5.9 -> 5\n   */\n  floor?: boolean;\n  clamped?: [min?: Maybe<number>, max?: Maybe<number>];\n}\n\n/**\n * Parses a number from raw input and optionally clamps, rounds or limits\n * fractional digits.\n *\n * Strings are normalized by removing spaces and replacing `,` with `.` before\n * parsing. Invalid inputs return the configured fallback.\n *\n * @template TFallback Fallback value type returned when parsing fails.\n * @param input Raw value to parse.\n * @param userSettings Parser settings merged with `number.defaultSettings`.\n * @returns Parsed number or fallback value.\n *\n * @example\n * ```ts\n * number('1 234,5'); // 1234.5\n * ```\n *\n * @example\n * ```ts\n * number('bad', { fallback: 0 }); // 0\n * ```\n */\nexport const number = <TFallback = number>(\n  input: Maybe<unknown>,\n  userSettings?: Maybe<NumberParserSettings<TFallback>>,\n): number | TFallback => {\n  const settings = {\n    ...number.defaultSettings,\n    ...userSettings,\n  };\n\n  const fallback = (\n    'fallback' in settings ? settings.fallback : 0\n  ) as TFallback;\n\n  let result: number;\n\n  if (typeGuard.isNumber(input)) {\n    result = input;\n  } else if (typeGuard.isString(input)) {\n    const formattedInput = format.skipSpaces(input).replace(',', '.');\n    if (formattedInput === '') {\n      result = fallback as any;\n    } else {\n      result = Number(formattedInput);\n    }\n  } else {\n    result = fallback as any;\n  }\n\n  if (typeGuard.isNumber(result)) {\n    if (settings?.clamped != null) {\n      result = Math.max(\n        settings.clamped[0] ?? -Infinity,\n        Math.min(result, settings.clamped[1] ?? Infinity),\n      );\n    }\n\n    if (settings?.ceil != null) {\n      result = Math.ceil(result);\n    }\n\n    if (settings?.floor != null) {\n      result = Math.floor(result);\n    }\n\n    if (settings?.digits != null) {\n      result = +result.toFixed(settings.digits);\n    }\n\n    return result;\n  } else {\n    return fallback;\n  }\n};\n\nnumber.defaultSettings = {} as NumberParserSettings;\n","import type { Maybe } from 'yummies/types';\n\nimport { type NumberParserSettings, number } from './number.js';\n\n/**\n * Converts a value into a percentage of `maxValue` and parses the result with\n * the shared numeric parser.\n *\n * @template TFallback Fallback value type returned when parsing fails.\n * @param value Current value.\n * @param maxValue Maximum value representing `100%`.\n * @param settings Numeric parser settings for the computed percentage.\n * @returns Parsed percentage or fallback value.\n *\n * @example\n * ```ts\n * percent(25, 200); // 12.5\n * ```\n *\n * @example\n * ```ts\n * percent('bad', 100, { fallback: 0 }); // 0\n * ```\n */\nexport const percent = <TFallback = number>(\n  value: Maybe<string | number>,\n  maxValue?: Maybe<string | number>,\n  settings?: Maybe<NumberParserSettings<TFallback>>,\n) => {\n  return number<TFallback>((Number(value) / Number(maxValue)) * 100, settings);\n};\n","import { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\nexport interface StringParserSettings<TFallback = string> {\n  fallback?: TFallback;\n  prettyJson?: boolean;\n}\n\n/**\n * Converts arbitrary input into a string representation.\n *\n * Objects are serialized with `JSON.stringify`, optionally pretty-printed, and\n * nullish values resolve to the configured fallback.\n *\n * @template TFallback Fallback value type returned for nullish input.\n * @param input Raw value to stringify.\n * @param settings String conversion settings.\n * @returns Stringified input or fallback value.\n *\n * @example\n * ```ts\n * string(123); // '123'\n * ```\n *\n * @example\n * ```ts\n * string({ id: 1 }, { prettyJson: true });\n * ```\n */\nexport const string = <TFallback = string>(\n  input: Maybe<unknown>,\n  settings?: Maybe<StringParserSettings<TFallback>>,\n): string | TFallback => {\n  const fallback =\n    settings && 'fallback' in settings ? (settings.fallback as TFallback) : '';\n\n  if (input == null) {\n    return fallback;\n  }\n\n  if (typeGuard.isObject(input)) {\n    if (settings?.prettyJson) {\n      return JSON.stringify(input, null, 2);\n    }\n\n    return JSON.stringify(input);\n  }\n\n  return String(input);\n};\n","/**\n * ---header-docs-section---\n * # yummies/parser\n *\n * ## Description\n *\n * Parsers for user-entered **numbers, percents, and strings** with tolerant input and typed\n * results. Use when normalizing form values, query params, or CSV-like text before validation\n * schemas run, without duplicating regex and `parseFloat` edge cases in every feature module.\n *\n * ## Usage\n *\n * ```ts\n * import { parser } from \"yummies/parser\";\n * ```\n */\n\nexport * from './number.js';\nexport * from './percent.js';\nexport * from './string.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,IAAa,UACX,OACA,iBACuB;CACvB,MAAM,WAAW;EACf,GAAG,OAAO;EACV,GAAG;CACL;CAEA,MAAM,WACJ,cAAc,WAAW,SAAS,WAAW;CAG/C,IAAI;CAEJ,IAAI,UAAU,SAAS,KAAK,GAC1B,SAAS;MACJ,IAAI,UAAU,SAAS,KAAK,GAAG;EACpC,MAAM,iBAAiB,OAAO,WAAW,KAAK,EAAE,QAAQ,KAAK,GAAG;EAChE,IAAI,mBAAmB,IACrB,SAAS;OAET,SAAS,OAAO,cAAc;CAElC,OACE,SAAS;CAGX,IAAI,UAAU,SAAS,MAAM,GAAG;EAC9B,IAAI,UAAU,WAAW,MACvB,SAAS,KAAK,IACZ,SAAS,QAAQ,MAAM,WACvB,KAAK,IAAI,QAAQ,SAAS,QAAQ,MAAM,QAAQ,CAClD;EAGF,IAAI,UAAU,QAAQ,MACpB,SAAS,KAAK,KAAK,MAAM;EAG3B,IAAI,UAAU,SAAS,MACrB,SAAS,KAAK,MAAM,MAAM;EAG5B,IAAI,UAAU,UAAU,MACtB,SAAS,CAAC,OAAO,QAAQ,SAAS,MAAM;EAG1C,OAAO;CACT,OACE,OAAO;AAEX;AAEA,OAAO,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;ACxE1B,IAAa,WACX,OACA,UACA,aACG;CACH,OAAO,OAAmB,OAAO,KAAK,IAAI,OAAO,QAAQ,IAAK,KAAK,QAAQ;AAC7E;;;;;;;;;;;;;;;;;;;;;;;;ACDA,IAAa,UACX,OACA,aACuB;CACvB,MAAM,WACJ,YAAY,cAAc,WAAY,SAAS,WAAyB;CAE1E,IAAI,SAAS,MACX,OAAO;CAGT,IAAI,UAAU,SAAS,KAAK,GAAG;EAC7B,IAAI,UAAU,YACZ,OAAO,KAAK,UAAU,OAAO,MAAM,CAAC;EAGtC,OAAO,KAAK,UAAU,KAAK;CAC7B;CAEA,OAAO,OAAO,KAAK;AACrB"}

package/price.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/price.ts
+//#region src/price/format-price.ts
 /**
 * Formats a numeric price using locale and currency options.
 *

package/price.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"price.cjs","names":[],"sources":["../src/price.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/price\n *\n * ## Description\n *\n * Locale-aware **money formatting** via `Intl.NumberFormat`, with optional symbol hiding and\n * custom currency symbols for legacy UI. It wraps browser i18n APIs so storefronts and dashboards\n * share one implementation for RUB/EUR/USD-style output without pulling a heavy formatting library.\n *\n * ## Usage\n *\n * ```ts\n * import { formatPrice } from \"yummies/price\";\n * ```\n */\n\nexport interface PriceFormatOptions\n  extends Partial<Omit<Intl.NumberFormatOptions, 'currency'>> {\n  withoutSymbol?: boolean;\n  customSymbol?: string;\n}\n\n/**\n * Formats a numeric price using locale and currency options.\n *\n * @example\n * ```ts\n * formatPrice(1990, 'ru-RU', 'RUB');\n * ```\n */\nexport const formatPrice = (\n  price: number,\n  locale: string,\n  currency?: string,\n  { withoutSymbol, customSymbol, ...options }: PriceFormatOptions = {},\n) => {\n  const priceFormatter = new Intl.NumberFormat(locale, {\n    style: 'currency',\n    currency,\n    minimumFractionDigits: 0,\n    currencyDisplay: 'narrowSymbol',\n    ...options,\n  });\n\n  const zeroPrice = priceFormatter.format(0);\n  const currencySymbol = zeroPrice.replace('0', '');\n  const rawPrice = priceFormatter.format(price);\n  const priceWithoutCurrency = rawPrice.replace(currencySymbol, '');\n\n  if (withoutSymbol) {\n    return priceWithoutCurrency;\n  }\n\n  return `${priceWithoutCurrency} ${\n    customSymbol ?? (currency === 'RUB' ? 'р' : currencySymbol)\n  }`.replace(/\\s{2,}/, ' ');\n};\n"],"mappings":";;;;;;;;;;AA+BA,IAAa,eACX,OACA,QACA,UACA,EAAE,eAAe,cAAc,GAAG,YAAgC,EAAE,KACjE;CACH,MAAM,iBAAiB,IAAI,KAAK,aAAa,QAAQ;EACnD,OAAO;EACP;EACA,uBAAuB;EACvB,iBAAiB;EACjB,GAAG;EACJ,CAAC;CAGF,MAAM,iBADY,eAAe,OAAO,EAAE,CACT,QAAQ,KAAK,GAAG;CAEjD,MAAM,uBADW,eAAe,OAAO,MAAM,CACP,QAAQ,gBAAgB,GAAG;AAEjE,KAAI,cACF,QAAO;AAGT,QAAO,GAAG,qBAAqB,GAC7B,iBAAiB,aAAa,QAAQ,MAAM,kBAC3C,QAAQ,UAAU,IAAI"}
+{"version":3,"file":"price.cjs","names":[],"sources":["../src/price/format-price.ts"],"sourcesContent":["export interface PriceFormatOptions\n  extends Partial<Omit<Intl.NumberFormatOptions, 'currency'>> {\n  withoutSymbol?: boolean;\n  customSymbol?: string;\n}\n\n/**\n * Formats a numeric price using locale and currency options.\n *\n * @example\n * ```ts\n * formatPrice(1990, 'ru-RU', 'RUB');\n * ```\n */\nexport const formatPrice = (\n  price: number,\n  locale: string,\n  currency?: string,\n  { withoutSymbol, customSymbol, ...options }: PriceFormatOptions = {},\n) => {\n  const priceFormatter = new Intl.NumberFormat(locale, {\n    style: 'currency',\n    currency,\n    minimumFractionDigits: 0,\n    currencyDisplay: 'narrowSymbol',\n    ...options,\n  });\n\n  const zeroPrice = priceFormatter.format(0);\n  const currencySymbol = zeroPrice.replace('0', '');\n  const rawPrice = priceFormatter.format(price);\n  const priceWithoutCurrency = rawPrice.replace(currencySymbol, '');\n\n  if (withoutSymbol) {\n    return priceWithoutCurrency;\n  }\n\n  return `${priceWithoutCurrency} ${\n    customSymbol ?? (currency === 'RUB' ? 'р' : currencySymbol)\n  }`.replace(/\\s{2,}/, ' ');\n};\n"],"mappings":";;;;;;;;;;AAcA,IAAa,eACX,OACA,QACA,UACA,EAAE,eAAe,cAAc,GAAG,YAAgC,CAAC,MAChE;CACH,MAAM,iBAAiB,IAAI,KAAK,aAAa,QAAQ;EACnD,OAAO;EACP;EACA,uBAAuB;EACvB,iBAAiB;EACjB,GAAG;CACL,CAAC;CAGD,MAAM,iBADY,eAAe,OAAO,CACjB,EAAU,QAAQ,KAAK,EAAE;CAEhD,MAAM,uBADW,eAAe,OAAO,KACV,EAAS,QAAQ,gBAAgB,EAAE;CAEhE,IAAI,eACF,OAAO;CAGT,OAAO,GAAG,qBAAqB,GAC7B,iBAAiB,aAAa,QAAQ,MAAM,kBAC3C,QAAQ,UAAU,GAAG;AAC1B"}

package/price.d.ts

@@ -1,19 +1,3 @@
-/**
- * ---header-docs-section---
- * # yummies/price
- *
- * ## Description
- *
- * Locale-aware **money formatting** via `Intl.NumberFormat`, with optional symbol hiding and
- * custom currency symbols for legacy UI. It wraps browser i18n APIs so storefronts and dashboards
- * share one implementation for RUB/EUR/USD-style output without pulling a heavy formatting library.
- *
- * ## Usage
- *
- * ```ts
- * import { formatPrice } from "yummies/price";
- * ```
- */
 interface PriceFormatOptions extends Partial<Omit<Intl.NumberFormatOptions, 'currency'>> {
     withoutSymbol?: boolean;
     customSymbol?: string;

package/price.js

@@ -1,4 +1,4 @@
-//#region src/price.ts
+//#region src/price/format-price.ts
 /**
 * Formats a numeric price using locale and currency options.
 *

package/price.js.map

@@ -1 +1 @@
-{"version":3,"file":"price.js","names":[],"sources":["../src/price.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/price\n *\n * ## Description\n *\n * Locale-aware **money formatting** via `Intl.NumberFormat`, with optional symbol hiding and\n * custom currency symbols for legacy UI. It wraps browser i18n APIs so storefronts and dashboards\n * share one implementation for RUB/EUR/USD-style output without pulling a heavy formatting library.\n *\n * ## Usage\n *\n * ```ts\n * import { formatPrice } from \"yummies/price\";\n * ```\n */\n\nexport interface PriceFormatOptions\n  extends Partial<Omit<Intl.NumberFormatOptions, 'currency'>> {\n  withoutSymbol?: boolean;\n  customSymbol?: string;\n}\n\n/**\n * Formats a numeric price using locale and currency options.\n *\n * @example\n * ```ts\n * formatPrice(1990, 'ru-RU', 'RUB');\n * ```\n */\nexport const formatPrice = (\n  price: number,\n  locale: string,\n  currency?: string,\n  { withoutSymbol, customSymbol, ...options }: PriceFormatOptions = {},\n) => {\n  const priceFormatter = new Intl.NumberFormat(locale, {\n    style: 'currency',\n    currency,\n    minimumFractionDigits: 0,\n    currencyDisplay: 'narrowSymbol',\n    ...options,\n  });\n\n  const zeroPrice = priceFormatter.format(0);\n  const currencySymbol = zeroPrice.replace('0', '');\n  const rawPrice = priceFormatter.format(price);\n  const priceWithoutCurrency = rawPrice.replace(currencySymbol, '');\n\n  if (withoutSymbol) {\n    return priceWithoutCurrency;\n  }\n\n  return `${priceWithoutCurrency} ${\n    customSymbol ?? (currency === 'RUB' ? 'р' : currencySymbol)\n  }`.replace(/\\s{2,}/, ' ');\n};\n"],"mappings":";;;;;;;;;AA+BA,IAAa,eACX,OACA,QACA,UACA,EAAE,eAAe,cAAc,GAAG,YAAgC,EAAE,KACjE;CACH,MAAM,iBAAiB,IAAI,KAAK,aAAa,QAAQ;EACnD,OAAO;EACP;EACA,uBAAuB;EACvB,iBAAiB;EACjB,GAAG;EACJ,CAAC;CAGF,MAAM,iBADY,eAAe,OAAO,EAAE,CACT,QAAQ,KAAK,GAAG;CAEjD,MAAM,uBADW,eAAe,OAAO,MAAM,CACP,QAAQ,gBAAgB,GAAG;AAEjE,KAAI,cACF,QAAO;AAGT,QAAO,GAAG,qBAAqB,GAC7B,iBAAiB,aAAa,QAAQ,MAAM,kBAC3C,QAAQ,UAAU,IAAI"}
+{"version":3,"file":"price.js","names":[],"sources":["../src/price/format-price.ts"],"sourcesContent":["export interface PriceFormatOptions\n  extends Partial<Omit<Intl.NumberFormatOptions, 'currency'>> {\n  withoutSymbol?: boolean;\n  customSymbol?: string;\n}\n\n/**\n * Formats a numeric price using locale and currency options.\n *\n * @example\n * ```ts\n * formatPrice(1990, 'ru-RU', 'RUB');\n * ```\n */\nexport const formatPrice = (\n  price: number,\n  locale: string,\n  currency?: string,\n  { withoutSymbol, customSymbol, ...options }: PriceFormatOptions = {},\n) => {\n  const priceFormatter = new Intl.NumberFormat(locale, {\n    style: 'currency',\n    currency,\n    minimumFractionDigits: 0,\n    currencyDisplay: 'narrowSymbol',\n    ...options,\n  });\n\n  const zeroPrice = priceFormatter.format(0);\n  const currencySymbol = zeroPrice.replace('0', '');\n  const rawPrice = priceFormatter.format(price);\n  const priceWithoutCurrency = rawPrice.replace(currencySymbol, '');\n\n  if (withoutSymbol) {\n    return priceWithoutCurrency;\n  }\n\n  return `${priceWithoutCurrency} ${\n    customSymbol ?? (currency === 'RUB' ? 'р' : currencySymbol)\n  }`.replace(/\\s{2,}/, ' ');\n};\n"],"mappings":";;;;;;;;;AAcA,IAAa,eACX,OACA,QACA,UACA,EAAE,eAAe,cAAc,GAAG,YAAgC,CAAC,MAChE;CACH,MAAM,iBAAiB,IAAI,KAAK,aAAa,QAAQ;EACnD,OAAO;EACP;EACA,uBAAuB;EACvB,iBAAiB;EACjB,GAAG;CACL,CAAC;CAGD,MAAM,iBADY,eAAe,OAAO,CACjB,EAAU,QAAQ,KAAK,EAAE;CAEhD,MAAM,uBADW,eAAe,OAAO,KACV,EAAS,QAAQ,gBAAgB,EAAE;CAEhE,IAAI,eACF,OAAO;CAGT,OAAO,GAAG,qBAAqB,GAC7B,iBAAiB,aAAa,QAAQ,MAAM,kBAC3C,QAAQ,UAAU,GAAG;AAC1B"}

package/random.cjs

@@ -1,21 +1,18 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/random.ts
+//#region src/random/get-frequency-value.ts
 /**
-* ---header-docs-section---
-* # yummies/random
-*
-* ## Description
-*
-* Small RNG helpers for UI demos, games, and sampling: floats, integers, and random choices from
-* arrays. They wrap `Math.random` (not cryptographically secure) so prefer platform `crypto` when
-* generating secrets, tokens, or lottery outcomes.
-*
-* ## Usage
+* Returns `true` with the provided probability from `0` to `1`.
 *
+* @example
 * ```ts
-* import { getRandomInt, getRandomChoice } from "yummies/random";
+* const shouldRun = getFrequencyValue(0.25);
 * ```
 */
+var getFrequencyValue = (frequency) => {
+	return Math.random() < frequency;
+};
+//#endregion
+//#region src/random/get-random-float.ts
 /**
 * Returns a random floating-point number between `min` and `max`.
 *
@@ -25,6 +22,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 * ```
 */
 var getRandomFloat = (min = 0, max = 1) => Math.random() * (max - min) + min;
+//#endregion
+//#region src/random/get-random-int.ts
 /**
 * Returns a random integer between `min` and `max`.
 *
@@ -34,24 +33,34 @@ var getRandomFloat = (min = 0, max = 1) => Math.random() * (max - min) + min;
 * ```
 */
 var getRandomInt = (min = 0, max = 1) => min === max ? min : Math.round(getRandomFloat(min, max));
+//#endregion
+//#region src/random/get-major-random-bool.ts
 /**
-* Picks a random element from the provided array.
+* Returns `true` more often than `false`.
 *
 * @example
 * ```ts
-* const fruit = getRandomChoice(['apple', 'banana', 'orange']);
+* const value = getMajorRandomBool();
 * ```
 */
-var getRandomChoice = (arr) => arr[getRandomInt(0, arr.length - 1)];
+var getMajorRandomBool = () => {
+	return getRandomInt(0, 10) <= 6;
+};
+//#endregion
+//#region src/random/get-minor-random-bool.ts
 /**
-* Creates an array filled with `null` values using a random length.
+* Returns `true` less often than `false`.
 *
 * @example
 * ```ts
-* const items = getRandomSizeArray(2, 5);
+* const value = getMinorRandomBool();
 * ```
 */
-var getRandomSizeArray = (min = 0, max = 10) => Array.from({ length: getRandomInt(min, max) }).fill(null);
+var getMinorRandomBool = () => {
+	return !getMajorRandomBool();
+};
+//#endregion
+//#region src/random/get-random-bool.ts
 /**
 * Returns a uniformly random boolean.
 *
@@ -61,39 +70,28 @@ var getRandomSizeArray = (min = 0, max = 10) => Array.from({ length: getRandomIn
 * ```
 */
 var getRandomBool = () => getRandomInt(0, 1) === 1;
+//#endregion
+//#region src/random/get-random-choice.ts
 /**
-* Returns `true` more often than `false`.
-*
-* @example
-* ```ts
-* const value = getMajorRandomBool();
-* ```
-*/
-var getMajorRandomBool = () => {
-	return getRandomInt(0, 10) <= 6;
-};
-/**
-* Returns `true` less often than `false`.
+* Picks a random element from the provided array.
 *
 * @example
 * ```ts
-* const value = getMinorRandomBool();
+* const fruit = getRandomChoice(['apple', 'banana', 'orange']);
 * ```
 */
-var getMinorRandomBool = () => {
-	return !getMajorRandomBool();
-};
+var getRandomChoice = (arr) => arr[getRandomInt(0, arr.length - 1)];
+//#endregion
+//#region src/random/get-random-size-array.ts
 /**
-* Returns `true` with the provided probability from `0` to `1`.
+* Creates an array filled with `null` values using a random length.
 *
 * @example
 * ```ts
-* const shouldRun = getFrequencyValue(0.25);
+* const items = getRandomSizeArray(2, 5);
 * ```
 */
-var getFrequencyValue = (frequency) => {
-	return Math.random() < frequency;
-};
+var getRandomSizeArray = (min = 0, max = 10) => Array.from({ length: getRandomInt(min, max) }).fill(null);
 //#endregion
 exports.getFrequencyValue = getFrequencyValue;
 exports.getMajorRandomBool = getMajorRandomBool;

package/random.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"random.cjs","names":[],"sources":["../src/random.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/random\n *\n * ## Description\n *\n * Small RNG helpers for UI demos, games, and sampling: floats, integers, and random choices from\n * arrays. They wrap `Math.random` (not cryptographically secure) so prefer platform `crypto` when\n * generating secrets, tokens, or lottery outcomes.\n *\n * ## Usage\n *\n * ```ts\n * import { getRandomInt, getRandomChoice } from \"yummies/random\";\n * ```\n */\n\n/**\n * Returns a random floating-point number between `min` and `max`.\n *\n * @example\n * ```ts\n * const value = getRandomFloat(1, 10);\n * ```\n */\nexport const getRandomFloat = <T extends number = number>(\n  min = 0,\n  max = 1,\n): T => (Math.random() * (max - min) + min) as T;\n\n/**\n * Returns a random integer between `min` and `max`.\n *\n * @example\n * ```ts\n * const value = getRandomInt(1, 10);\n * ```\n */\nexport const getRandomInt = <T extends number = number>(min = 0, max = 1): T =>\n  min === max ? (min as T) : (Math.round(getRandomFloat(min, max)) as T);\n\n/**\n * Picks a random element from the provided array.\n *\n * @example\n * ```ts\n * const fruit = getRandomChoice(['apple', 'banana', 'orange']);\n * ```\n */\nexport const getRandomChoice = <T>(arr: T[]): T =>\n  arr[getRandomInt(0, arr.length - 1)];\n\n/**\n * Creates an array filled with `null` values using a random length.\n *\n * @example\n * ```ts\n * const items = getRandomSizeArray(2, 5);\n * ```\n */\nexport const getRandomSizeArray = (min = 0, max = 10) =>\n  Array.from({ length: getRandomInt(min, max) }).fill(null);\n\n/**\n * Returns a uniformly random boolean.\n *\n * @example\n * ```ts\n * const value = getRandomBool();\n * ```\n */\nexport const getRandomBool = () => getRandomInt(0, 1) === 1;\n\n/**\n * Returns `true` more often than `false`.\n *\n * @example\n * ```ts\n * const value = getMajorRandomBool();\n * ```\n */\nexport const getMajorRandomBool = () => {\n  return getRandomInt(0, 10) <= 6;\n};\n\n/**\n * Returns `true` less often than `false`.\n *\n * @example\n * ```ts\n * const value = getMinorRandomBool();\n * ```\n */\nexport const getMinorRandomBool = () => {\n  return !getMajorRandomBool();\n};\n\n/**\n * Returns `true` with the provided probability from `0` to `1`.\n *\n * @example\n * ```ts\n * const shouldRun = getFrequencyValue(0.25);\n * ```\n */\nexport const getFrequencyValue = (frequency: number) => {\n  return Math.random() < frequency;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,IAAa,kBACX,MAAM,GACN,MAAM,MACC,KAAK,QAAQ,IAAI,MAAM,OAAO;;;;;;;;;AAUvC,IAAa,gBAA2C,MAAM,GAAG,MAAM,MACrE,QAAQ,MAAO,MAAa,KAAK,MAAM,eAAe,KAAK,IAAI,CAAC;;;;;;;;;AAUlE,IAAa,mBAAsB,QACjC,IAAI,aAAa,GAAG,IAAI,SAAS,EAAE;;;;;;;;;AAUrC,IAAa,sBAAsB,MAAM,GAAG,MAAM,OAChD,MAAM,KAAK,EAAE,QAAQ,aAAa,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,KAAK;;;;;;;;;AAU3D,IAAa,sBAAsB,aAAa,GAAG,EAAE,KAAK;;;;;;;;;AAU1D,IAAa,2BAA2B;AACtC,QAAO,aAAa,GAAG,GAAG,IAAI;;;;;;;;;;AAWhC,IAAa,2BAA2B;AACtC,QAAO,CAAC,oBAAoB;;;;;;;;;;AAW9B,IAAa,qBAAqB,cAAsB;AACtD,QAAO,KAAK,QAAQ,GAAG"}
+{"version":3,"file":"random.cjs","names":[],"sources":["../src/random/get-frequency-value.ts","../src/random/get-random-float.ts","../src/random/get-random-int.ts","../src/random/get-major-random-bool.ts","../src/random/get-minor-random-bool.ts","../src/random/get-random-bool.ts","../src/random/get-random-choice.ts","../src/random/get-random-size-array.ts"],"sourcesContent":["/**\n * Returns `true` with the provided probability from `0` to `1`.\n *\n * @example\n * ```ts\n * const shouldRun = getFrequencyValue(0.25);\n * ```\n */\nexport const getFrequencyValue = (frequency: number) => {\n  return Math.random() < frequency;\n};\n","/**\n * Returns a random floating-point number between `min` and `max`.\n *\n * @example\n * ```ts\n * const value = getRandomFloat(1, 10);\n * ```\n */\nexport const getRandomFloat = <T extends number = number>(\n  min = 0,\n  max = 1,\n): T => (Math.random() * (max - min) + min) as T;\n","import { getRandomFloat } from './get-random-float.js';\n\n/**\n * Returns a random integer between `min` and `max`.\n *\n * @example\n * ```ts\n * const value = getRandomInt(1, 10);\n * ```\n */\nexport const getRandomInt = <T extends number = number>(min = 0, max = 1): T =>\n  min === max ? (min as T) : (Math.round(getRandomFloat(min, max)) as T);\n","import { getRandomInt } from './get-random-int.js';\n\n/**\n * Returns `true` more often than `false`.\n *\n * @example\n * ```ts\n * const value = getMajorRandomBool();\n * ```\n */\nexport const getMajorRandomBool = () => {\n  return getRandomInt(0, 10) <= 6;\n};\n","import { getMajorRandomBool } from './get-major-random-bool.js';\n\n/**\n * Returns `true` less often than `false`.\n *\n * @example\n * ```ts\n * const value = getMinorRandomBool();\n * ```\n */\nexport const getMinorRandomBool = () => {\n  return !getMajorRandomBool();\n};\n","import { getRandomInt } from './get-random-int.js';\n\n/**\n * Returns a uniformly random boolean.\n *\n * @example\n * ```ts\n * const value = getRandomBool();\n * ```\n */\nexport const getRandomBool = () => getRandomInt(0, 1) === 1;\n","import { getRandomInt } from './get-random-int.js';\n\n/**\n * Picks a random element from the provided array.\n *\n * @example\n * ```ts\n * const fruit = getRandomChoice(['apple', 'banana', 'orange']);\n * ```\n */\nexport const getRandomChoice = <T>(arr: T[]): T =>\n  arr[getRandomInt(0, arr.length - 1)];\n","import { getRandomInt } from './get-random-int.js';\n\n/**\n * Creates an array filled with `null` values using a random length.\n *\n * @example\n * ```ts\n * const items = getRandomSizeArray(2, 5);\n * ```\n */\nexport const getRandomSizeArray = (min = 0, max = 10) =>\n  Array.from({ length: getRandomInt(min, max) }).fill(null);\n"],"mappings":";;;;;;;;;;AAQA,IAAa,qBAAqB,cAAsB;CACtD,OAAO,KAAK,OAAO,IAAI;AACzB;;;;;;;;;;;ACFA,IAAa,kBACX,MAAM,GACN,MAAM,MACC,KAAK,OAAO,KAAK,MAAM,OAAO;;;;;;;;;;;ACDvC,IAAa,gBAA2C,MAAM,GAAG,MAAM,MACrE,QAAQ,MAAO,MAAa,KAAK,MAAM,eAAe,KAAK,GAAG,CAAC;;;;;;;;;;;ACDjE,IAAa,2BAA2B;CACtC,OAAO,aAAa,GAAG,EAAE,KAAK;AAChC;;;;;;;;;;;ACFA,IAAa,2BAA2B;CACtC,OAAO,CAAC,mBAAmB;AAC7B;;;;;;;;;;;ACFA,IAAa,sBAAsB,aAAa,GAAG,CAAC,MAAM;;;;;;;;;;;ACA1D,IAAa,mBAAsB,QACjC,IAAI,aAAa,GAAG,IAAI,SAAS,CAAC;;;;;;;;;;;ACDpC,IAAa,sBAAsB,MAAM,GAAG,MAAM,OAChD,MAAM,KAAK,EAAE,QAAQ,aAAa,KAAK,GAAG,EAAE,CAAC,EAAE,KAAK,IAAI"}

package/random.d.ts

@@ -1,90 +1,81 @@
 /**
- * ---header-docs-section---
- * # yummies/random
- *
- * ## Description
- *
- * Small RNG helpers for UI demos, games, and sampling: floats, integers, and random choices from
- * arrays. They wrap `Math.random` (not cryptographically secure) so prefer platform `crypto` when
- * generating secrets, tokens, or lottery outcomes.
- *
- * ## Usage
- *
- * ```ts
- * import { getRandomInt, getRandomChoice } from "yummies/random";
- * ```
- */
-/**
- * Returns a random floating-point number between `min` and `max`.
+ * Returns `true` with the provided probability from `0` to `1`.
  *
  * @example
  * ```ts
- * const value = getRandomFloat(1, 10);
+ * const shouldRun = getFrequencyValue(0.25);
  * ```
  */
-declare const getRandomFloat: <T extends number = number>(min?: number, max?: number) => T;
+declare const getFrequencyValue: (frequency: number) => boolean;
+
 /**
- * Returns a random integer between `min` and `max`.
+ * Returns `true` more often than `false`.
  *
  * @example
  * ```ts
- * const value = getRandomInt(1, 10);
+ * const value = getMajorRandomBool();
  * ```
  */
-declare const getRandomInt: <T extends number = number>(min?: number, max?: number) => T;
+declare const getMajorRandomBool: () => boolean;
+
 /**
- * Picks a random element from the provided array.
+ * Returns `true` less often than `false`.
  *
  * @example
  * ```ts
- * const fruit = getRandomChoice(['apple', 'banana', 'orange']);
+ * const value = getMinorRandomBool();
  * ```
  */
-declare const getRandomChoice: <T>(arr: T[]) => T;
+declare const getMinorRandomBool: () => boolean;
+
 /**
- * Creates an array filled with `null` values using a random length.
+ * Returns a uniformly random boolean.
  *
  * @example
  * ```ts
- * const items = getRandomSizeArray(2, 5);
+ * const value = getRandomBool();
  * ```
  */
-declare const getRandomSizeArray: (min?: number, max?: number) => unknown[];
+declare const getRandomBool: () => boolean;
+
 /**
- * Returns a uniformly random boolean.
+ * Picks a random element from the provided array.
  *
  * @example
  * ```ts
- * const value = getRandomBool();
+ * const fruit = getRandomChoice(['apple', 'banana', 'orange']);
  * ```
  */
-declare const getRandomBool: () => boolean;
+declare const getRandomChoice: <T>(arr: T[]) => T;
+
 /**
- * Returns `true` more often than `false`.
+ * Returns a random floating-point number between `min` and `max`.
  *
  * @example
  * ```ts
- * const value = getMajorRandomBool();
+ * const value = getRandomFloat(1, 10);
  * ```
  */
-declare const getMajorRandomBool: () => boolean;
+declare const getRandomFloat: <T extends number = number>(min?: number, max?: number) => T;
+
 /**
- * Returns `true` less often than `false`.
+ * Returns a random integer between `min` and `max`.
  *
  * @example
  * ```ts
- * const value = getMinorRandomBool();
+ * const value = getRandomInt(1, 10);
  * ```
  */
-declare const getMinorRandomBool: () => boolean;
+declare const getRandomInt: <T extends number = number>(min?: number, max?: number) => T;
+
 /**
- * Returns `true` with the provided probability from `0` to `1`.
+ * Creates an array filled with `null` values using a random length.
  *
  * @example
  * ```ts
- * const shouldRun = getFrequencyValue(0.25);
+ * const items = getRandomSizeArray(2, 5);
  * ```
  */
-declare const getFrequencyValue: (frequency: number) => boolean;
+declare const getRandomSizeArray: (min?: number, max?: number) => unknown[];
 
 export { getFrequencyValue, getMajorRandomBool, getMinorRandomBool, getRandomBool, getRandomChoice, getRandomFloat, getRandomInt, getRandomSizeArray };