yummies 7.10.0 → 7.12.0

package/ms.cjs

@@ -1,14 +1,25 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const unitsToMs = {
-  ms: 1,
-  sec: 1e3,
-  min: 1e3 * 60,
-  hour: 1e3 * 60 * 60,
-  day: 1e3 * 60 * 60 * 24,
-  week: 1e3 * 60 * 60 * 24 * 7
+//#region src/ms.ts
+var unitsToMs = {
+	ms: 1,
+	sec: 1e3,
+	min: 1e3 * 60,
+	hour: 1e3 * 60 * 60,
+	day: 1e3 * 60 * 60 * 24,
+	week: 1e3 * 60 * 60 * 24 * 7
 };
-const ms = (value, unit = "ms") => value * unitsToMs[unit];
+/**
+* Converts a value in the specified unit to milliseconds.
+*
+* @example
+* ```ts
+* ms(1, 'min') // 60_000
+* ms(30, 'sec') // 30_000
+* ```
+*/
+var ms = (value, unit = "ms") => value * unitsToMs[unit];
+//#endregion
 exports.ms = ms;
 exports.unitsToMs = unitsToMs;
-//# sourceMappingURL=ms.cjs.map
+
+//# sourceMappingURL=ms.cjs.map

package/ms.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ms.cjs","sources":["../src/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\n/**\n * Переводит значение в юнитах в миллисекунды\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"],"names":[],"mappings":";;AAAO,MAAM,YAAY;AAAA,EACvB,IAAI;AAAA,EACJ,KAAK;AAAA,EACL,KAAK,MAAO;AAAA,EACZ,MAAM,MAAO,KAAK;AAAA,EAClB,KAAK,MAAO,KAAK,KAAK;AAAA,EACtB,MAAM,MAAO,KAAK,KAAK,KAAK;AAC9B;AAWO,MAAM,KAAK,CAAC,OAAe,OAA+B,SAC/D,QAAQ,UAAU,IAAI;;;"}
+{"version":3,"file":"ms.cjs","names":[],"sources":["../src/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\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;CAC7B;;;;;;;;;;AAWD,IAAa,MAAM,OAAe,OAA+B,SAC/D,QAAQ,UAAU"}

package/ms.d.ts

@@ -7,7 +7,7 @@ declare const unitsToMs: {
     readonly week: number;
 };
 /**
- * Переводит значение в юнитах в миллисекунды
+ * Converts a value in the specified unit to milliseconds.
  *
  * @example
  * ```ts

package/ms.js

@@ -1,14 +1,23 @@
-const unitsToMs = {
-  ms: 1,
-  sec: 1e3,
-  min: 1e3 * 60,
-  hour: 1e3 * 60 * 60,
-  day: 1e3 * 60 * 60 * 24,
-  week: 1e3 * 60 * 60 * 24 * 7
+//#region src/ms.ts
+var unitsToMs = {
+	ms: 1,
+	sec: 1e3,
+	min: 1e3 * 60,
+	hour: 1e3 * 60 * 60,
+	day: 1e3 * 60 * 60 * 24,
+	week: 1e3 * 60 * 60 * 24 * 7
 };
-const ms = (value, unit = "ms") => value * unitsToMs[unit];
-export {
-  ms,
-  unitsToMs
-};
-//# sourceMappingURL=ms.js.map
+/**
+* Converts a value in the specified unit to milliseconds.
+*
+* @example
+* ```ts
+* ms(1, 'min') // 60_000
+* ms(30, 'sec') // 30_000
+* ```
+*/
+var ms = (value, unit = "ms") => value * unitsToMs[unit];
+//#endregion
+export { ms, unitsToMs };
+
+//# sourceMappingURL=ms.js.map

package/ms.js.map

@@ -1 +1 @@
-{"version":3,"file":"ms.js","sources":["../src/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\n/**\n * Переводит значение в юнитах в миллисекунды\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"],"names":[],"mappings":"AAAO,MAAM,YAAY;AAAA,EACvB,IAAI;AAAA,EACJ,KAAK;AAAA,EACL,KAAK,MAAO;AAAA,EACZ,MAAM,MAAO,KAAK;AAAA,EAClB,KAAK,MAAO,KAAK,KAAK;AAAA,EACtB,MAAM,MAAO,KAAK,KAAK,KAAK;AAC9B;AAWO,MAAM,KAAK,CAAC,OAAe,OAA+B,SAC/D,QAAQ,UAAU,IAAI;"}
+{"version":3,"file":"ms.js","names":[],"sources":["../src/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\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;CAC7B;;;;;;;;;;AAWD,IAAa,MAAM,OAAe,OAA+B,SAC/D,QAAQ,UAAU"}

package/number.cjs

@@ -1,11 +1,17 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/number.ts
+/**
+* Works like `parseFloat(number.toFixed(4))` but performance better
+*
+* @example
+* round(191.212999999999999999999999, 4) // 191.213
+*/
 function round(value, decimalPlaces = 0) {
-  if (!decimalPlaces) {
-    return Math.round(value);
-  }
-  const factor = 10 ** decimalPlaces;
-  return Math.round(value * factor) / factor;
+	if (!decimalPlaces) return Math.round(value);
+	const factor = 10 ** decimalPlaces;
+	return Math.round(value * factor) / factor;
 }
+//#endregion
 exports.round = round;
-//# sourceMappingURL=number.cjs.map
+
+//# sourceMappingURL=number.cjs.map

package/number.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"number.cjs","sources":["../src/number.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"],"names":[],"mappings":";;AAMO,SAAS,MAAM,OAAe,gBAAwB,GAAW;AACtE,MAAI,CAAC,eAAe;AAClB,WAAO,KAAK,MAAM,KAAK;AAAA,EACzB;AAEA,QAAM,SAAS,MAAM;AACrB,SAAO,KAAK,MAAM,QAAQ,MAAM,IAAI;AACtC;;"}
+{"version":3,"file":"number.cjs","names":[],"sources":["../src/number.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;AACtE,KAAI,CAAC,cACH,QAAO,KAAK,MAAM,MAAM;CAG1B,MAAM,SAAS,MAAM;AACrB,QAAO,KAAK,MAAM,QAAQ,OAAO,GAAG"}

package/number.js

@@ -1,11 +1,16 @@
+//#region src/number.ts
+/**
+* Works like `parseFloat(number.toFixed(4))` but performance better
+*
+* @example
+* round(191.212999999999999999999999, 4) // 191.213
+*/
 function round(value, decimalPlaces = 0) {
-  if (!decimalPlaces) {
-    return Math.round(value);
-  }
-  const factor = 10 ** decimalPlaces;
-  return Math.round(value * factor) / factor;
+	if (!decimalPlaces) return Math.round(value);
+	const factor = 10 ** decimalPlaces;
+	return Math.round(value * factor) / factor;
 }
-export {
-  round
-};
-//# sourceMappingURL=number.js.map
+//#endregion
+export { round };
+
+//# sourceMappingURL=number.js.map

package/number.js.map

@@ -1 +1 @@
-{"version":3,"file":"number.js","sources":["../src/number.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"],"names":[],"mappings":"AAMO,SAAS,MAAM,OAAe,gBAAwB,GAAW;AACtE,MAAI,CAAC,eAAe;AAClB,WAAO,KAAK,MAAM,KAAK;AAAA,EACzB;AAEA,QAAM,SAAS,MAAM;AACrB,SAAO,KAAK,MAAM,QAAQ,MAAM,IAAI;AACtC;"}
+{"version":3,"file":"number.js","names":[],"sources":["../src/number.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;AACtE,KAAI,CAAC,cACH,QAAO,KAAK,MAAM,MAAM;CAG1B,MAAM,SAAS,MAAM;AACrB,QAAO,KAAK,MAAM,QAAQ,OAAO,GAAG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yummies",
-  "version": "7.10.0",
+  "version": "7.12.0",
   "keywords": [
     "javascript",
     "typescript",
@@ -33,10 +33,10 @@
   "dependencies": {
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "dayjs": "^1.11.13",
-    "dompurify": "^3.2.6",
-    "nanoid": "^5.1.5",
-    "tailwind-merge": "^3.3.1"
+    "dayjs": "^1.11.20",
+    "dompurify": "^3.3.3",
+    "nanoid": "^5.1.7",
+    "tailwind-merge": "^3.5.0"
   },
   "type": "module",
   "exports": {
@@ -46,6 +46,14 @@
       "require": "./async.cjs",
       "default": "./async.js"
     },
+    "./chunk-CVq3Gv4J": {
+      "require": "./chunk-CVq3Gv4J.cjs",
+      "default": "./chunk-CVq3Gv4J.cjs"
+    },
+    "./chunk-YKewjYmz": {
+      "import": "./chunk-YKewjYmz.js",
+      "default": "./chunk-YKewjYmz.js"
+    },
     "./common": {
       "types": "./common.d.ts",
       "import": "./common.js",

package/parser.cjs

@@ -1,69 +1,122 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const format = require("yummies/format");
-const typeGuard = require("yummies/type-guard");
-const number = (input, userSettings) => {
-  const settings = {
-    ...number.defaultSettings,
-    ...userSettings
-  };
-  const fallback = "fallback" in settings ? settings.fallback : 0;
-  let result;
-  if (typeGuard.typeGuard.isNumber(input)) {
-    result = input;
-  } else if (typeGuard.typeGuard.isString(input)) {
-    const formattedInput = format.format.skipSpaces(input).replace(",", ".");
-    if (formattedInput === "") {
-      result = fallback;
-    } else {
-      result = Number(formattedInput);
-    }
-  } else {
-    result = fallback;
-  }
-  if (typeGuard.typeGuard.isNumber(result)) {
-    if (settings?.clamped != null) {
-      result = Math.max(
-        settings.clamped[0] ?? -Infinity,
-        Math.min(result, settings.clamped[1] ?? Infinity)
-      );
-    }
-    if (settings?.ceil != null) {
-      result = Math.ceil(result);
-    }
-    if (settings?.floor != null) {
-      result = Math.floor(result);
-    }
-    if (settings?.digits != null) {
-      result = +result.toFixed(settings.digits);
-    }
-    return result;
-  } else {
-    return fallback;
-  }
+const require_chunk = require("./chunk-CVq3Gv4J.cjs");
+let yummies_type_guard = require("yummies/type-guard");
+let yummies_format = require("yummies/format");
+//#region src/parser/number.ts
+/**
+* Parses a number from raw input and optionally clamps, rounds or limits
+* fractional digits.
+*
+* Strings are normalized by removing spaces and replacing `,` with `.` before
+* parsing. Invalid inputs return the configured fallback.
+*
+* @template TFallback Fallback value type returned when parsing fails.
+* @param input Raw value to parse.
+* @param userSettings Parser settings merged with `number.defaultSettings`.
+* @returns Parsed number or fallback value.
+*
+* @example
+* ```ts
+* number('1 234,5'); // 1234.5
+* ```
+*
+* @example
+* ```ts
+* number('bad', { fallback: 0 }); // 0
+* ```
+*/
+var number = (input, userSettings) => {
+	const settings = {
+		...number.defaultSettings,
+		...userSettings
+	};
+	const fallback = "fallback" in settings ? settings.fallback : 0;
+	let result;
+	if (yummies_type_guard.typeGuard.isNumber(input)) result = input;
+	else if (yummies_type_guard.typeGuard.isString(input)) {
+		const formattedInput = yummies_format.format.skipSpaces(input).replace(",", ".");
+		if (formattedInput === "") result = fallback;
+		else result = Number(formattedInput);
+	} else result = fallback;
+	if (yummies_type_guard.typeGuard.isNumber(result)) {
+		if (settings?.clamped != null) result = Math.max(settings.clamped[0] ?? -Infinity, Math.min(result, settings.clamped[1] ?? Infinity));
+		if (settings?.ceil != null) result = Math.ceil(result);
+		if (settings?.floor != null) result = Math.floor(result);
+		if (settings?.digits != null) result = +result.toFixed(settings.digits);
+		return result;
+	} else return fallback;
 };
 number.defaultSettings = {};
-const percent = (value, maxValue, settings) => {
-  return number(Number(value) / Number(maxValue) * 100, settings);
+//#endregion
+//#region src/parser/percent.ts
+/**
+* Converts a value into a percentage of `maxValue` and parses the result with
+* the shared numeric parser.
+*
+* @template TFallback Fallback value type returned when parsing fails.
+* @param value Current value.
+* @param maxValue Maximum value representing `100%`.
+* @param settings Numeric parser settings for the computed percentage.
+* @returns Parsed percentage or fallback value.
+*
+* @example
+* ```ts
+* percent(25, 200); // 12.5
+* ```
+*
+* @example
+* ```ts
+* percent('bad', 100, { fallback: 0 }); // 0
+* ```
+*/
+var percent = (value, maxValue, settings) => {
+	return number(Number(value) / Number(maxValue) * 100, settings);
 };
-const string = (input, settings) => {
-  const fallback = settings && "fallback" in settings ? settings.fallback : "";
-  if (input == null) {
-    return fallback;
-  }
-  if (typeGuard.typeGuard.isObject(input)) {
-    if (settings?.prettyJson) {
-      return JSON.stringify(input, null, 2);
-    }
-    return JSON.stringify(input);
-  }
-  return String(input);
+//#endregion
+//#region src/parser/string.ts
+/**
+* Converts arbitrary input into a string representation.
+*
+* Objects are serialized with `JSON.stringify`, optionally pretty-printed, and
+* nullish values resolve to the configured fallback.
+*
+* @template TFallback Fallback value type returned for nullish input.
+* @param input Raw value to stringify.
+* @param settings String conversion settings.
+* @returns Stringified input or fallback value.
+*
+* @example
+* ```ts
+* string(123); // '123'
+* ```
+*
+* @example
+* ```ts
+* string({ id: 1 }, { prettyJson: true });
+* ```
+*/
+var string = (input, settings) => {
+	const fallback = settings && "fallback" in settings ? settings.fallback : "";
+	if (input == null) return fallback;
+	if (yummies_type_guard.typeGuard.isObject(input)) {
+		if (settings?.prettyJson) return JSON.stringify(input, null, 2);
+		return JSON.stringify(input);
+	}
+	return String(input);
 };
-const _exports = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
-  __proto__: null,
-  number,
-  percent,
-  string
-}, Symbol.toStringTag, { value: "Module" }));
-exports.parser = _exports;
-//# sourceMappingURL=parser.cjs.map
+//#endregion
+//#region src/parser/_exports.ts
+var _exports_exports = /* @__PURE__ */ require_chunk.__exportAll({
+	number: () => number,
+	percent: () => percent,
+	string: () => string
+});
+//#endregion
+Object.defineProperty(exports, "parser", {
+	enumerable: true,
+	get: function() {
+		return _exports_exports;
+	}
+});
+
+//# sourceMappingURL=parser.cjs.map

package/parser.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"parser.cjs","sources":["../src/parser/number.ts","../src/parser/percent.ts","../src/parser/string.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\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\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\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"],"names":["typeGuard","format"],"mappings":";;;;AAoBO,MAAM,SAAS,CACpB,OACA,iBACuB;AACvB,QAAM,WAAW;AAAA,IACf,GAAG,OAAO;AAAA,IACV,GAAG;AAAA,EAAA;AAGL,QAAM,WACJ,cAAc,WAAW,SAAS,WAAW;AAG/C,MAAI;AAEJ,MAAIA,UAAAA,UAAU,SAAS,KAAK,GAAG;AAC7B,aAAS;AAAA,EACX,WAAWA,UAAAA,UAAU,SAAS,KAAK,GAAG;AACpC,UAAM,iBAAiBC,OAAAA,OAAO,WAAW,KAAK,EAAE,QAAQ,KAAK,GAAG;AAChE,QAAI,mBAAmB,IAAI;AACzB,eAAS;AAAA,IACX,OAAO;AACL,eAAS,OAAO,cAAc;AAAA,IAChC;AAAA,EACF,OAAO;AACL,aAAS;AAAA,EACX;AAEA,MAAID,UAAAA,UAAU,SAAS,MAAM,GAAG;AAC9B,QAAI,UAAU,WAAW,MAAM;AAC7B,eAAS,KAAK;AAAA,QACZ,SAAS,QAAQ,CAAC,KAAK;AAAA,QACvB,KAAK,IAAI,QAAQ,SAAS,QAAQ,CAAC,KAAK,QAAQ;AAAA,MAAA;AAAA,IAEpD;AAEA,QAAI,UAAU,QAAQ,MAAM;AAC1B,eAAS,KAAK,KAAK,MAAM;AAAA,IAC3B;AAEA,QAAI,UAAU,SAAS,MAAM;AAC3B,eAAS,KAAK,MAAM,MAAM;AAAA,IAC5B;AAEA,QAAI,UAAU,UAAU,MAAM;AAC5B,eAAS,CAAC,OAAO,QAAQ,SAAS,MAAM;AAAA,IAC1C;AAEA,WAAO;AAAA,EACT,OAAO;AACL,WAAO;AAAA,EACT;AACF;AAEA,OAAO,kBAAkB,CAAA;ACtElB,MAAM,UAAU,CACrB,OACA,UACA,aACG;AACH,SAAO,OAAmB,OAAO,KAAK,IAAI,OAAO,QAAQ,IAAK,KAAK,QAAQ;AAC7E;ACFO,MAAM,SAAS,CACpB,OACA,aACuB;AACvB,QAAM,WACJ,YAAY,cAAc,WAAY,SAAS,WAAyB;AAE1E,MAAI,SAAS,MAAM;AACjB,WAAO;AAAA,EACT;AAEA,MAAIA,UAAAA,UAAU,SAAS,KAAK,GAAG;AAC7B,QAAI,UAAU,YAAY;AACxB,aAAO,KAAK,UAAU,OAAO,MAAM,CAAC;AAAA,IACtC;AAEA,WAAO,KAAK,UAAU,KAAK;AAAA,EAC7B;AAEA,SAAO,OAAO,KAAK;AACrB;;;;;;;;"}
+{"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","export * 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"}

package/parser.d.ts

@@ -15,17 +15,80 @@ interface NumberParserSettings<TFallback = number> {
     floor?: boolean;
     clamped?: [min?: Maybe<number>, max?: Maybe<number>];
 }
+/**
+ * Parses a number from raw input and optionally clamps, rounds or limits
+ * fractional digits.
+ *
+ * Strings are normalized by removing spaces and replacing `,` with `.` before
+ * parsing. Invalid inputs return the configured fallback.
+ *
+ * @template TFallback Fallback value type returned when parsing fails.
+ * @param input Raw value to parse.
+ * @param userSettings Parser settings merged with `number.defaultSettings`.
+ * @returns Parsed number or fallback value.
+ *
+ * @example
+ * ```ts
+ * number('1 234,5'); // 1234.5
+ * ```
+ *
+ * @example
+ * ```ts
+ * number('bad', { fallback: 0 }); // 0
+ * ```
+ */
 declare const number: {
     <TFallback = number>(input: Maybe<unknown>, userSettings?: Maybe<NumberParserSettings<TFallback>>): number | TFallback;
     defaultSettings: NumberParserSettings<number>;
 };
 
+/**
+ * Converts a value into a percentage of `maxValue` and parses the result with
+ * the shared numeric parser.
+ *
+ * @template TFallback Fallback value type returned when parsing fails.
+ * @param value Current value.
+ * @param maxValue Maximum value representing `100%`.
+ * @param settings Numeric parser settings for the computed percentage.
+ * @returns Parsed percentage or fallback value.
+ *
+ * @example
+ * ```ts
+ * percent(25, 200); // 12.5
+ * ```
+ *
+ * @example
+ * ```ts
+ * percent('bad', 100, { fallback: 0 }); // 0
+ * ```
+ */
 declare const percent: <TFallback = number>(value: Maybe<string | number>, maxValue?: Maybe<string | number>, settings?: Maybe<NumberParserSettings<TFallback>>) => number | TFallback;
 
 interface StringParserSettings<TFallback = string> {
     fallback?: TFallback;
     prettyJson?: boolean;
 }
+/**
+ * Converts arbitrary input into a string representation.
+ *
+ * Objects are serialized with `JSON.stringify`, optionally pretty-printed, and
+ * nullish values resolve to the configured fallback.
+ *
+ * @template TFallback Fallback value type returned for nullish input.
+ * @param input Raw value to stringify.
+ * @param settings String conversion settings.
+ * @returns Stringified input or fallback value.
+ *
+ * @example
+ * ```ts
+ * string(123); // '123'
+ * ```
+ *
+ * @example
+ * ```ts
+ * string({ id: 1 }, { prettyJson: true });
+ * ```
+ */
 declare const string: <TFallback = string>(input: Maybe<unknown>, settings?: Maybe<StringParserSettings<TFallback>>) => string | TFallback;
 
 type _exports_NumberParserSettings<TFallback = number> = NumberParserSettings<TFallback>;