yummies 7.11.0 → 7.13.0

package/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","sources":["../src/errors.ts"],"sourcesContent":["import { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\ntype GetErrorTextEnhancer = (error: any) => string;\ntype GetErrorTextFormatErrorFn = (error: Error) => string;\n\n/**\n * Universal function for transforming any errors into readable error text\n *\n * This function can be enhanced with custom handlers using:\n * - `getErrorText.unknownErrorText`\n * - `getErrorText.formatError`\n * - `getErrorText.enhance`\n */\nexport const getErrorText = (error: unknown) => {\n  if (!error) {\n    return getErrorText.unknownErrorText;\n  }\n\n  if (typeGuard.isString(error)) {\n    return error || getErrorText.unknownErrorText;\n  }\n\n  if (error instanceof Error) {\n    return (\n      (getErrorText.formatError?.(error) ?? error.message) ||\n      getErrorText.unknownErrorText\n    );\n  }\n\n  if (getErrorText.enhance) {\n    return getErrorText.enhance(error) ?? getErrorText.unknownErrorText;\n  } else {\n    return getErrorText.unknownErrorText;\n  }\n};\n\ngetErrorText.unknownErrorText = '';\ngetErrorText.formatError = null as Maybe<GetErrorTextFormatErrorFn>;\ngetErrorText.enhance = null as Maybe<GetErrorTextEnhancer>;\n"],"names":["typeGuard"],"mappings":";;;AAcO,MAAM,eAAe,CAAC,UAAmB;AAC9C,MAAI,CAAC,OAAO;AACV,WAAO,aAAa;AAAA,EACtB;AAEA,MAAIA,UAAAA,UAAU,SAAS,KAAK,GAAG;AAC7B,WAAO,SAAS,aAAa;AAAA,EAC/B;AAEA,MAAI,iBAAiB,OAAO;AAC1B,YACG,aAAa,cAAc,KAAK,KAAK,MAAM,YAC5C,aAAa;AAAA,EAEjB;AAEA,MAAI,aAAa,SAAS;AACxB,WAAO,aAAa,QAAQ,KAAK,KAAK,aAAa;AAAA,EACrD,OAAO;AACL,WAAO,aAAa;AAAA,EACtB;AACF;AAEA,aAAa,mBAAmB;AAChC,aAAa,cAAc;AAC3B,aAAa,UAAU;;"}
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/errors\n *\n * ## Description\n *\n * Turns thrown values, `Error` objects, and unknown API failures into a single human-readable string\n * for toasts, forms, and logs. The default `getErrorText` can be extended with custom formatters and\n * enhancers so domain-specific errors still map to stable copy without try/catch boilerplate.\n *\n * ## Usage\n *\n * ```ts\n * import { getErrorText } from \"yummies/errors\";\n * ```\n */\n\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\ntype GetErrorTextEnhancer = (error: any) => string;\ntype GetErrorTextFormatErrorFn = (error: Error) => string;\n\n/**\n * Universal function for transforming any errors into readable error text\n *\n * This function can be enhanced with custom handlers using:\n * - `getErrorText.unknownErrorText`\n * - `getErrorText.formatError`\n * - `getErrorText.enhance`\n */\nexport const getErrorText = (error: unknown) => {\n  if (!error) {\n    return getErrorText.unknownErrorText;\n  }\n\n  if (typeGuard.isString(error)) {\n    return error || getErrorText.unknownErrorText;\n  }\n\n  if (error instanceof Error) {\n    return (\n      (getErrorText.formatError?.(error) ?? error.message) ||\n      getErrorText.unknownErrorText\n    );\n  }\n\n  if (getErrorText.enhance) {\n    return getErrorText.enhance(error) ?? getErrorText.unknownErrorText;\n  } else {\n    return getErrorText.unknownErrorText;\n  }\n};\n\ngetErrorText.unknownErrorText = '';\ngetErrorText.formatError = null as Maybe<GetErrorTextFormatErrorFn>;\ngetErrorText.enhance = null as Maybe<GetErrorTextEnhancer>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,IAAa,gBAAgB,UAAmB;AAC9C,KAAI,CAAC,MACH,QAAO,aAAa;AAGtB,KAAI,mBAAA,UAAU,SAAS,MAAM,CAC3B,QAAO,SAAS,aAAa;AAG/B,KAAI,iBAAiB,MACnB,SACG,aAAa,cAAc,MAAM,IAAI,MAAM,YAC5C,aAAa;AAIjB,KAAI,aAAa,QACf,QAAO,aAAa,QAAQ,MAAM,IAAI,aAAa;KAEnD,QAAO,aAAa;;AAIxB,aAAa,mBAAmB;AAChC,aAAa,cAAc;AAC3B,aAAa,UAAU"}

package/errors.d.ts

@@ -1,5 +1,22 @@
 import { Maybe } from 'yummies/types';
 
+/**
+ * ---header-docs-section---
+ * # yummies/errors
+ *
+ * ## Description
+ *
+ * Turns thrown values, `Error` objects, and unknown API failures into a single human-readable string
+ * for toasts, forms, and logs. The default `getErrorText` can be extended with custom formatters and
+ * enhancers so domain-specific errors still map to stable copy without try/catch boilerplate.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { getErrorText } from "yummies/errors";
+ * ```
+ */
+
 type GetErrorTextEnhancer = (error: any) => string;
 type GetErrorTextFormatErrorFn = (error: Error) => string;
 /**

package/errors.js

@@ -1,24 +1,40 @@
 import { typeGuard } from "yummies/type-guard";
-const getErrorText = (error) => {
-  if (!error) {
-    return getErrorText.unknownErrorText;
-  }
-  if (typeGuard.isString(error)) {
-    return error || getErrorText.unknownErrorText;
-  }
-  if (error instanceof Error) {
-    return (getErrorText.formatError?.(error) ?? error.message) || getErrorText.unknownErrorText;
-  }
-  if (getErrorText.enhance) {
-    return getErrorText.enhance(error) ?? getErrorText.unknownErrorText;
-  } else {
-    return getErrorText.unknownErrorText;
-  }
+//#region src/errors.ts
+/**
+* ---header-docs-section---
+* # yummies/errors
+*
+* ## Description
+*
+* Turns thrown values, `Error` objects, and unknown API failures into a single human-readable string
+* for toasts, forms, and logs. The default `getErrorText` can be extended with custom formatters and
+* enhancers so domain-specific errors still map to stable copy without try/catch boilerplate.
+*
+* ## Usage
+*
+* ```ts
+* import { getErrorText } from "yummies/errors";
+* ```
+*/
+/**
+* Universal function for transforming any errors into readable error text
+*
+* This function can be enhanced with custom handlers using:
+* - `getErrorText.unknownErrorText`
+* - `getErrorText.formatError`
+* - `getErrorText.enhance`
+*/
+var getErrorText = (error) => {
+	if (!error) return getErrorText.unknownErrorText;
+	if (typeGuard.isString(error)) return error || getErrorText.unknownErrorText;
+	if (error instanceof Error) return (getErrorText.formatError?.(error) ?? error.message) || getErrorText.unknownErrorText;
+	if (getErrorText.enhance) return getErrorText.enhance(error) ?? getErrorText.unknownErrorText;
+	else return getErrorText.unknownErrorText;
 };
 getErrorText.unknownErrorText = "";
 getErrorText.formatError = null;
 getErrorText.enhance = null;
-export {
-  getErrorText
-};
-//# sourceMappingURL=errors.js.map
+//#endregion
+export { getErrorText };
+
+//# sourceMappingURL=errors.js.map

package/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sources":["../src/errors.ts"],"sourcesContent":["import { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\ntype GetErrorTextEnhancer = (error: any) => string;\ntype GetErrorTextFormatErrorFn = (error: Error) => string;\n\n/**\n * Universal function for transforming any errors into readable error text\n *\n * This function can be enhanced with custom handlers using:\n * - `getErrorText.unknownErrorText`\n * - `getErrorText.formatError`\n * - `getErrorText.enhance`\n */\nexport const getErrorText = (error: unknown) => {\n  if (!error) {\n    return getErrorText.unknownErrorText;\n  }\n\n  if (typeGuard.isString(error)) {\n    return error || getErrorText.unknownErrorText;\n  }\n\n  if (error instanceof Error) {\n    return (\n      (getErrorText.formatError?.(error) ?? error.message) ||\n      getErrorText.unknownErrorText\n    );\n  }\n\n  if (getErrorText.enhance) {\n    return getErrorText.enhance(error) ?? getErrorText.unknownErrorText;\n  } else {\n    return getErrorText.unknownErrorText;\n  }\n};\n\ngetErrorText.unknownErrorText = '';\ngetErrorText.formatError = null as Maybe<GetErrorTextFormatErrorFn>;\ngetErrorText.enhance = null as Maybe<GetErrorTextEnhancer>;\n"],"names":[],"mappings":";AAcO,MAAM,eAAe,CAAC,UAAmB;AAC9C,MAAI,CAAC,OAAO;AACV,WAAO,aAAa;AAAA,EACtB;AAEA,MAAI,UAAU,SAAS,KAAK,GAAG;AAC7B,WAAO,SAAS,aAAa;AAAA,EAC/B;AAEA,MAAI,iBAAiB,OAAO;AAC1B,YACG,aAAa,cAAc,KAAK,KAAK,MAAM,YAC5C,aAAa;AAAA,EAEjB;AAEA,MAAI,aAAa,SAAS;AACxB,WAAO,aAAa,QAAQ,KAAK,KAAK,aAAa;AAAA,EACrD,OAAO;AACL,WAAO,aAAa;AAAA,EACtB;AACF;AAEA,aAAa,mBAAmB;AAChC,aAAa,cAAc;AAC3B,aAAa,UAAU;"}
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/errors\n *\n * ## Description\n *\n * Turns thrown values, `Error` objects, and unknown API failures into a single human-readable string\n * for toasts, forms, and logs. The default `getErrorText` can be extended with custom formatters and\n * enhancers so domain-specific errors still map to stable copy without try/catch boilerplate.\n *\n * ## Usage\n *\n * ```ts\n * import { getErrorText } from \"yummies/errors\";\n * ```\n */\n\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\ntype GetErrorTextEnhancer = (error: any) => string;\ntype GetErrorTextFormatErrorFn = (error: Error) => string;\n\n/**\n * Universal function for transforming any errors into readable error text\n *\n * This function can be enhanced with custom handlers using:\n * - `getErrorText.unknownErrorText`\n * - `getErrorText.formatError`\n * - `getErrorText.enhance`\n */\nexport const getErrorText = (error: unknown) => {\n  if (!error) {\n    return getErrorText.unknownErrorText;\n  }\n\n  if (typeGuard.isString(error)) {\n    return error || getErrorText.unknownErrorText;\n  }\n\n  if (error instanceof Error) {\n    return (\n      (getErrorText.formatError?.(error) ?? error.message) ||\n      getErrorText.unknownErrorText\n    );\n  }\n\n  if (getErrorText.enhance) {\n    return getErrorText.enhance(error) ?? getErrorText.unknownErrorText;\n  } else {\n    return getErrorText.unknownErrorText;\n  }\n};\n\ngetErrorText.unknownErrorText = '';\ngetErrorText.formatError = null as Maybe<GetErrorTextFormatErrorFn>;\ngetErrorText.enhance = null as Maybe<GetErrorTextEnhancer>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,IAAa,gBAAgB,UAAmB;AAC9C,KAAI,CAAC,MACH,QAAO,aAAa;AAGtB,KAAI,UAAU,SAAS,MAAM,CAC3B,QAAO,SAAS,aAAa;AAG/B,KAAI,iBAAiB,MACnB,SACG,aAAa,cAAc,MAAM,IAAI,MAAM,YAC5C,aAAa;AAIjB,KAAI,aAAa,QACf,QAAO,aAAa,QAAQ,MAAM,IAAI,aAAa;KAEnD,QAAO,aAAa;;AAIxB,aAAa,mBAAmB;AAChC,aAAa,cAAc;AAC3B,aAAa,UAAU"}

package/file.cjs

@@ -1,29 +1,63 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const getBase64FromFile = (file) => {
-  return new Promise((resolve, reject) => {
-    const reader = new FileReader();
-    reader.readAsDataURL(file);
-    reader.onload = () => {
-      resolve(reader.result.toString());
-    };
-    reader.onerror = (error) => {
-      reject(error);
-    };
-  });
+//#region src/file.ts
+/**
+* ---header-docs-section---
+* # yummies/file
+*
+* ## Description
+*
+* Browser `File` helpers: reading contents as Base64 data URLs or plain text with optional
+* encoding. They wrap `FileReader` in promises so async flows stay linear and errors surface as
+* rejections. Handy for uploads, import wizards, and client-side parsing without extra libraries.
+*
+* ## Usage
+*
+* ```ts
+* import { getBase64FromFile } from "yummies/file";
+* ```
+*/
+/**
+* Reads a file as a Base64 data URL.
+*
+* @example
+* ```ts
+* const value = await getBase64FromFile(file);
+* ```
+*/
+var getBase64FromFile = (file) => {
+	return new Promise((resolve, reject) => {
+		const reader = new FileReader();
+		reader.readAsDataURL(file);
+		reader.onload = () => {
+			resolve(reader.result.toString());
+		};
+		reader.onerror = (error) => {
+			reject(error);
+		};
+	});
 };
-const getTextFromFile = (file, encoding) => {
-  return new Promise((resolve, reject) => {
-    const reader = new FileReader();
-    reader.readAsText(file, encoding);
-    reader.onload = () => {
-      resolve(reader.result.toString());
-    };
-    reader.onerror = (error) => {
-      reject(error);
-    };
-  });
+/**
+* Reads a file as text using the provided encoding.
+*
+* @example
+* ```ts
+* const text = await getTextFromFile(file, 'utf-8');
+* ```
+*/
+var getTextFromFile = (file, encoding) => {
+	return new Promise((resolve, reject) => {
+		const reader = new FileReader();
+		reader.readAsText(file, encoding);
+		reader.onload = () => {
+			resolve(reader.result.toString());
+		};
+		reader.onerror = (error) => {
+			reject(error);
+		};
+	});
 };
+//#endregion
 exports.getBase64FromFile = getBase64FromFile;
 exports.getTextFromFile = getTextFromFile;
-//# sourceMappingURL=file.cjs.map
+
+//# sourceMappingURL=file.cjs.map

package/file.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"file.cjs","sources":["../src/file.ts"],"sourcesContent":["export const getBase64FromFile = (file: File) => {\n  return new Promise<string>((resolve, reject) => {\n    const reader = new FileReader();\n    reader.readAsDataURL(file);\n    reader.onload = () => {\n      resolve(reader.result!.toString());\n    };\n    reader.onerror = (error) => {\n      reject(error);\n    };\n  });\n};\n\nexport const getTextFromFile = (file: File, encoding?: string) => {\n  return new Promise<string>((resolve, reject) => {\n    const reader = new FileReader();\n    reader.readAsText(file, encoding);\n    reader.onload = () => {\n      resolve(reader.result!.toString());\n    };\n    reader.onerror = (error) => {\n      reject(error);\n    };\n  });\n};\n"],"names":[],"mappings":";;AAAO,MAAM,oBAAoB,CAAC,SAAe;AAC/C,SAAO,IAAI,QAAgB,CAAC,SAAS,WAAW;AAC9C,UAAM,SAAS,IAAI,WAAA;AACnB,WAAO,cAAc,IAAI;AACzB,WAAO,SAAS,MAAM;AACpB,cAAQ,OAAO,OAAQ,UAAU;AAAA,IACnC;AACA,WAAO,UAAU,CAAC,UAAU;AAC1B,aAAO,KAAK;AAAA,IACd;AAAA,EACF,CAAC;AACH;AAEO,MAAM,kBAAkB,CAAC,MAAY,aAAsB;AAChE,SAAO,IAAI,QAAgB,CAAC,SAAS,WAAW;AAC9C,UAAM,SAAS,IAAI,WAAA;AACnB,WAAO,WAAW,MAAM,QAAQ;AAChC,WAAO,SAAS,MAAM;AACpB,cAAQ,OAAO,OAAQ,UAAU;AAAA,IACnC;AACA,WAAO,UAAU,CAAC,UAAU;AAC1B,aAAO,KAAK;AAAA,IACd;AAAA,EACF,CAAC;AACH;;;"}
+{"version":3,"file":"file.cjs","names":[],"sources":["../src/file.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/file\n *\n * ## Description\n *\n * Browser `File` helpers: reading contents as Base64 data URLs or plain text with optional\n * encoding. They wrap `FileReader` in promises so async flows stay linear and errors surface as\n * rejections. Handy for uploads, import wizards, and client-side parsing without extra libraries.\n *\n * ## Usage\n *\n * ```ts\n * import { getBase64FromFile } from \"yummies/file\";\n * ```\n */\n\n/**\n * Reads a file as a Base64 data URL.\n *\n * @example\n * ```ts\n * const value = await getBase64FromFile(file);\n * ```\n */\nexport const getBase64FromFile = (file: File) => {\n  return new Promise<string>((resolve, reject) => {\n    const reader = new FileReader();\n    reader.readAsDataURL(file);\n    reader.onload = () => {\n      resolve(reader.result!.toString());\n    };\n    reader.onerror = (error) => {\n      reject(error);\n    };\n  });\n};\n\n/**\n * Reads a file as text using the provided encoding.\n *\n * @example\n * ```ts\n * const text = await getTextFromFile(file, 'utf-8');\n * ```\n */\nexport const getTextFromFile = (file: File, encoding?: string) => {\n  return new Promise<string>((resolve, reject) => {\n    const reader = new FileReader();\n    reader.readAsText(file, encoding);\n    reader.onload = () => {\n      resolve(reader.result!.toString());\n    };\n    reader.onerror = (error) => {\n      reject(error);\n    };\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,IAAa,qBAAqB,SAAe;AAC/C,QAAO,IAAI,SAAiB,SAAS,WAAW;EAC9C,MAAM,SAAS,IAAI,YAAY;AAC/B,SAAO,cAAc,KAAK;AAC1B,SAAO,eAAe;AACpB,WAAQ,OAAO,OAAQ,UAAU,CAAC;;AAEpC,SAAO,WAAW,UAAU;AAC1B,UAAO,MAAM;;GAEf;;;;;;;;;;AAWJ,IAAa,mBAAmB,MAAY,aAAsB;AAChE,QAAO,IAAI,SAAiB,SAAS,WAAW;EAC9C,MAAM,SAAS,IAAI,YAAY;AAC/B,SAAO,WAAW,MAAM,SAAS;AACjC,SAAO,eAAe;AACpB,WAAQ,OAAO,OAAQ,UAAU,CAAC;;AAEpC,SAAO,WAAW,UAAU;AAC1B,UAAO,MAAM;;GAEf"}

package/file.d.ts

@@ -1,4 +1,36 @@
+/**
+ * ---header-docs-section---
+ * # yummies/file
+ *
+ * ## Description
+ *
+ * Browser `File` helpers: reading contents as Base64 data URLs or plain text with optional
+ * encoding. They wrap `FileReader` in promises so async flows stay linear and errors surface as
+ * rejections. Handy for uploads, import wizards, and client-side parsing without extra libraries.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { getBase64FromFile } from "yummies/file";
+ * ```
+ */
+/**
+ * Reads a file as a Base64 data URL.
+ *
+ * @example
+ * ```ts
+ * const value = await getBase64FromFile(file);
+ * ```
+ */
 declare const getBase64FromFile: (file: File) => Promise<string>;
+/**
+ * Reads a file as text using the provided encoding.
+ *
+ * @example
+ * ```ts
+ * const text = await getTextFromFile(file, 'utf-8');
+ * ```
+ */
 declare const getTextFromFile: (file: File, encoding?: string) => Promise<string>;
 
 export { getBase64FromFile, getTextFromFile };

package/file.js

@@ -1,29 +1,61 @@
-const getBase64FromFile = (file) => {
-  return new Promise((resolve, reject) => {
-    const reader = new FileReader();
-    reader.readAsDataURL(file);
-    reader.onload = () => {
-      resolve(reader.result.toString());
-    };
-    reader.onerror = (error) => {
-      reject(error);
-    };
-  });
+//#region src/file.ts
+/**
+* ---header-docs-section---
+* # yummies/file
+*
+* ## Description
+*
+* Browser `File` helpers: reading contents as Base64 data URLs or plain text with optional
+* encoding. They wrap `FileReader` in promises so async flows stay linear and errors surface as
+* rejections. Handy for uploads, import wizards, and client-side parsing without extra libraries.
+*
+* ## Usage
+*
+* ```ts
+* import { getBase64FromFile } from "yummies/file";
+* ```
+*/
+/**
+* Reads a file as a Base64 data URL.
+*
+* @example
+* ```ts
+* const value = await getBase64FromFile(file);
+* ```
+*/
+var getBase64FromFile = (file) => {
+	return new Promise((resolve, reject) => {
+		const reader = new FileReader();
+		reader.readAsDataURL(file);
+		reader.onload = () => {
+			resolve(reader.result.toString());
+		};
+		reader.onerror = (error) => {
+			reject(error);
+		};
+	});
 };
-const getTextFromFile = (file, encoding) => {
-  return new Promise((resolve, reject) => {
-    const reader = new FileReader();
-    reader.readAsText(file, encoding);
-    reader.onload = () => {
-      resolve(reader.result.toString());
-    };
-    reader.onerror = (error) => {
-      reject(error);
-    };
-  });
+/**
+* Reads a file as text using the provided encoding.
+*
+* @example
+* ```ts
+* const text = await getTextFromFile(file, 'utf-8');
+* ```
+*/
+var getTextFromFile = (file, encoding) => {
+	return new Promise((resolve, reject) => {
+		const reader = new FileReader();
+		reader.readAsText(file, encoding);
+		reader.onload = () => {
+			resolve(reader.result.toString());
+		};
+		reader.onerror = (error) => {
+			reject(error);
+		};
+	});
 };
-export {
-  getBase64FromFile,
-  getTextFromFile
-};
-//# sourceMappingURL=file.js.map
+//#endregion
+export { getBase64FromFile, getTextFromFile };
+
+//# sourceMappingURL=file.js.map

package/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sources":["../src/file.ts"],"sourcesContent":["export const getBase64FromFile = (file: File) => {\n  return new Promise<string>((resolve, reject) => {\n    const reader = new FileReader();\n    reader.readAsDataURL(file);\n    reader.onload = () => {\n      resolve(reader.result!.toString());\n    };\n    reader.onerror = (error) => {\n      reject(error);\n    };\n  });\n};\n\nexport const getTextFromFile = (file: File, encoding?: string) => {\n  return new Promise<string>((resolve, reject) => {\n    const reader = new FileReader();\n    reader.readAsText(file, encoding);\n    reader.onload = () => {\n      resolve(reader.result!.toString());\n    };\n    reader.onerror = (error) => {\n      reject(error);\n    };\n  });\n};\n"],"names":[],"mappings":"AAAO,MAAM,oBAAoB,CAAC,SAAe;AAC/C,SAAO,IAAI,QAAgB,CAAC,SAAS,WAAW;AAC9C,UAAM,SAAS,IAAI,WAAA;AACnB,WAAO,cAAc,IAAI;AACzB,WAAO,SAAS,MAAM;AACpB,cAAQ,OAAO,OAAQ,UAAU;AAAA,IACnC;AACA,WAAO,UAAU,CAAC,UAAU;AAC1B,aAAO,KAAK;AAAA,IACd;AAAA,EACF,CAAC;AACH;AAEO,MAAM,kBAAkB,CAAC,MAAY,aAAsB;AAChE,SAAO,IAAI,QAAgB,CAAC,SAAS,WAAW;AAC9C,UAAM,SAAS,IAAI,WAAA;AACnB,WAAO,WAAW,MAAM,QAAQ;AAChC,WAAO,SAAS,MAAM;AACpB,cAAQ,OAAO,OAAQ,UAAU;AAAA,IACnC;AACA,WAAO,UAAU,CAAC,UAAU;AAC1B,aAAO,KAAK;AAAA,IACd;AAAA,EACF,CAAC;AACH;"}
+{"version":3,"file":"file.js","names":[],"sources":["../src/file.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/file\n *\n * ## Description\n *\n * Browser `File` helpers: reading contents as Base64 data URLs or plain text with optional\n * encoding. They wrap `FileReader` in promises so async flows stay linear and errors surface as\n * rejections. Handy for uploads, import wizards, and client-side parsing without extra libraries.\n *\n * ## Usage\n *\n * ```ts\n * import { getBase64FromFile } from \"yummies/file\";\n * ```\n */\n\n/**\n * Reads a file as a Base64 data URL.\n *\n * @example\n * ```ts\n * const value = await getBase64FromFile(file);\n * ```\n */\nexport const getBase64FromFile = (file: File) => {\n  return new Promise<string>((resolve, reject) => {\n    const reader = new FileReader();\n    reader.readAsDataURL(file);\n    reader.onload = () => {\n      resolve(reader.result!.toString());\n    };\n    reader.onerror = (error) => {\n      reject(error);\n    };\n  });\n};\n\n/**\n * Reads a file as text using the provided encoding.\n *\n * @example\n * ```ts\n * const text = await getTextFromFile(file, 'utf-8');\n * ```\n */\nexport const getTextFromFile = (file: File, encoding?: string) => {\n  return new Promise<string>((resolve, reject) => {\n    const reader = new FileReader();\n    reader.readAsText(file, encoding);\n    reader.onload = () => {\n      resolve(reader.result!.toString());\n    };\n    reader.onerror = (error) => {\n      reject(error);\n    };\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,IAAa,qBAAqB,SAAe;AAC/C,QAAO,IAAI,SAAiB,SAAS,WAAW;EAC9C,MAAM,SAAS,IAAI,YAAY;AAC/B,SAAO,cAAc,KAAK;AAC1B,SAAO,eAAe;AACpB,WAAQ,OAAO,OAAQ,UAAU,CAAC;;AAEpC,SAAO,WAAW,UAAU;AAC1B,UAAO,MAAM;;GAEf;;;;;;;;;;AAWJ,IAAa,mBAAmB,MAAY,aAAsB;AAChE,QAAO,IAAI,SAAiB,SAAS,WAAW;EAC9C,MAAM,SAAS,IAAI,YAAY;AAC/B,SAAO,WAAW,MAAM,SAAS;AACjC,SAAO,eAAe;AACpB,WAAQ,OAAO,OAAQ,UAAU,CAAC;;AAEpC,SAAO,WAAW,UAAU;AAC1B,UAAO,MAAM;;GAEf"}

package/format.cjs

@@ -1,87 +1,129 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const parser = require("yummies/parser");
-const typeGuard = require("yummies/type-guard");
-const NO_VALUE = "–";
-const HYPHEN = "-";
-const INFINITY = "∞";
-const number = (rawValue, userSettings) => {
-  const settings = {
-    ...number.defaultSettings,
-    ...userSettings
-  };
-  const digits = settings.digits ?? 0;
-  const cutZeros = settings?.cutZeros ?? false;
-  const delimiter = settings.delimiter ?? " ";
-  const postfix = settings.postfix ?? "";
-  const emptyText = settings.emptyText ?? NO_VALUE;
-  const digitsOnlyForFloat = settings.digitsOnlyForFloat ?? true;
-  let value;
-  if (typeGuard.typeGuard.isString(rawValue)) {
-    value = parser.parser.number(value, { fallback: void 0 });
-  } else {
-    value = rawValue;
-  }
-  if (typeGuard.typeGuard.isNumber(value)) {
-    let raw = `${value}`;
-    if (digits !== false) {
-      if (settings.cropDigitsOnly) {
-        const [integerPart2, decimalPart2] = `${raw}`.split(".");
-        const leftPart = integerPart2;
-        const rightPart = (decimalPart2 || "").slice(0, digits).padEnd(digits, "0");
-        if (rightPart) {
-          raw = `${leftPart}.${rightPart}`;
-        } else {
-          raw = leftPart;
-        }
-      } else {
-        raw = value.toFixed(digits);
-      }
-    }
-    if (cutZeros) {
-      raw = `${+raw}`;
-    }
-    const [integerPart, decimalPart] = raw.split(".", 2);
-    let formattedIntegerPart = integerPart;
-    let formattedDecimalPart = "";
-    if (decimalPart && (!digitsOnlyForFloat || !/^0+$/.test(decimalPart))) {
-      formattedDecimalPart = `.${decimalPart}`;
-    }
-    const rgx = /(\d+)(\d{3})/;
-    while (rgx.test(formattedIntegerPart) && delimiter) {
-      formattedIntegerPart = formattedIntegerPart.replace(
-        rgx,
-        `$1${delimiter}$2`
-      );
-    }
-    return formattedIntegerPart + formattedDecimalPart + postfix;
-  }
-  return emptyText;
+const require_chunk = require("./chunk-CVq3Gv4J.cjs");
+let yummies_parser = require("yummies/parser");
+let yummies_type_guard = require("yummies/type-guard");
+//#region src/format/number.ts
+/**
+* Formats a numeric value with thousands separators, fractional digit control
+* and optional postfix text.
+*
+* Invalid, empty or unsupported values fall back to `emptyText`.
+*
+* @param rawValue Number or numeric string to format.
+* @param userSettings Formatting overrides merged with `number.defaultSettings`.
+* @returns Formatted number string or fallback text.
+*
+* @example
+* ```ts
+* number(12000); // '12 000'
+* ```
+*
+* @example
+* ```ts
+* number(12.5, { digits: 1, postfix: '%' }); // '12.5%'
+* ```
+*/
+var number = (rawValue, userSettings) => {
+	const settings = {
+		...number.defaultSettings,
+		...userSettings
+	};
+	const digits = settings.digits ?? 0;
+	const cutZeros = settings?.cutZeros ?? false;
+	const delimiter = settings.delimiter ?? " ";
+	const postfix = settings.postfix ?? "";
+	const emptyText = settings.emptyText ?? "–";
+	const digitsOnlyForFloat = settings.digitsOnlyForFloat ?? true;
+	let value;
+	if (yummies_type_guard.typeGuard.isString(rawValue)) value = yummies_parser.parser.number(value, { fallback: void 0 });
+	else value = rawValue;
+	if (yummies_type_guard.typeGuard.isNumber(value)) {
+		let raw = `${value}`;
+		if (digits !== false) if (settings.cropDigitsOnly) {
+			const [integerPart, decimalPart] = `${raw}`.split(".");
+			const leftPart = integerPart;
+			const rightPart = (decimalPart || "").slice(0, digits).padEnd(digits, "0");
+			if (rightPart) raw = `${leftPart}.${rightPart}`;
+			else raw = leftPart;
+		} else raw = value.toFixed(digits);
+		if (cutZeros) raw = `${+raw}`;
+		const [integerPart, decimalPart] = raw.split(".", 2);
+		let formattedIntegerPart = integerPart;
+		let formattedDecimalPart = "";
+		if (decimalPart && (!digitsOnlyForFloat || !/^0+$/.test(decimalPart))) formattedDecimalPart = `.${decimalPart}`;
+		const rgx = /(\d+)(\d{3})/;
+		while (rgx.test(formattedIntegerPart) && delimiter) formattedIntegerPart = formattedIntegerPart.replace(rgx, `$1${delimiter}$2`);
+		return formattedIntegerPart + formattedDecimalPart + postfix;
+	}
+	return emptyText;
 };
 number.defaultSettings = {};
-const percent = (value, settings) => {
-  const numericValue = parser.parser.number(value, {
-    ...settings,
-    digits: settings?.digits ?? 2,
-    fallback: Number.NaN
-  });
-  if (typeGuard.typeGuard.isNumber(numericValue)) {
-    const divider = settings?.divider ?? ".";
-    const formattedPercent = divider === "." ? numericValue : `${numericValue}`.replace(".", divider);
-    return `${formattedPercent}${settings?.delimiter ?? ""}${settings?.symbol ?? "%"}`;
-  } else {
-    return settings?.emptyText ?? NO_VALUE;
-  }
+//#endregion
+//#region src/format/percent.ts
+/**
+* Formats a value as a percent string with configurable decimal precision,
+* decimal divider and suffix symbol.
+*
+* @param value Number or numeric string to format.
+* @param settings Parser and formatting options.
+* @returns Formatted percent string or fallback text for invalid values.
+*
+* @example
+* ```ts
+* percent(12.345); // '12.35%'
+* ```
+*
+* @example
+* ```ts
+* percent(12.345, { divider: ',', symbol: ' pct' }); // '12,35 pct'
+* ```
+*/
+var percent = (value, settings) => {
+	const numericValue = yummies_parser.parser.number(value, {
+		...settings,
+		digits: settings?.digits ?? 2,
+		fallback: NaN
+	});
+	if (yummies_type_guard.typeGuard.isNumber(numericValue)) {
+		const divider = settings?.divider ?? ".";
+		return `${divider === "." ? numericValue : `${numericValue}`.replace(".", divider)}${settings?.delimiter ?? ""}${settings?.symbol ?? "%"}`;
+	} else return settings?.emptyText ?? "–";
 };
-const skipSpaces = (value) => value.replaceAll(/\s/g, "");
-const _exports = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
-  __proto__: null,
-  HYPHEN,
-  INFINITY,
-  NO_VALUE,
-  number,
-  percent,
-  skipSpaces
-}, Symbol.toStringTag, { value: "Module" }));
-exports.format = _exports;
-//# sourceMappingURL=format.cjs.map
+//#endregion
+//#region src/format/skip-spaces.ts
+/**
+* Removes all whitespace characters from a string.
+*
+* @param value Source string.
+* @returns String without spaces, tabs and line breaks.
+*
+* @example
+* ```ts
+* skipSpaces('1 000 000'); // '1000000'
+* ```
+*
+* @example
+* ```ts
+* skipSpaces('a\tb\nc'); // 'abc'
+* ```
+*/
+var skipSpaces = (value) => value.replaceAll(/\s/g, "");
+//#endregion
+//#region src/format/_exports.ts
+var _exports_exports = /* @__PURE__ */ require_chunk.__exportAll({
+	HYPHEN: () => "-",
+	INFINITY: () => "∞",
+	NO_VALUE: () => "–",
+	number: () => number,
+	percent: () => percent,
+	skipSpaces: () => skipSpaces
+});
+//#endregion
+Object.defineProperty(exports, "format", {
+	enumerable: true,
+	get: function() {
+		return _exports_exports;
+	}
+});
+
+//# sourceMappingURL=format.cjs.map

package/format.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"format.cjs","sources":["../src/format/constants.ts","../src/format/number.ts","../src/format/percent.ts","../src/format/skip-spaces.ts"],"sourcesContent":["/**\n * Placeholder shown when a formatter cannot produce a meaningful value.\n *\n * @example\n * ```ts\n * const fallback = NO_VALUE;\n * ```\n *\n * @example\n * ```ts\n * format.number(null, { emptyText: NO_VALUE });\n * ```\n */\nexport const NO_VALUE = '–'; // en-dash\n\n/**\n * Plain ASCII hyphen character.\n *\n * @example\n * ```ts\n * const separator = HYPHEN;\n * ```\n *\n * @example\n * ```ts\n * `foo${HYPHEN}bar`;\n * ```\n */\nexport const HYPHEN = '-';\n\n/**\n * Infinity symbol used by numeric formatters and UI output.\n *\n * @example\n * ```ts\n * const label = INFINITY;\n * ```\n *\n * @example\n * ```ts\n * `${INFINITY} items`;\n * ```\n */\nexport const INFINITY = '∞';\n","import { parser } from 'yummies/parser';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\nimport { NO_VALUE } from './constants.js';\n\nexport interface NumberFormatSettings {\n  delimiter?: string;\n  /**\n   * digitsOnlyForFloat - Show digits after decimal point only if they are not zeros after converting to number.\n   * Example: \"0.00\" -> \"0\", \"0.10\" -> \"0.1\", but \"0.003\" -> \"0.003\"\n   *\n   * @default true\n   */\n  digitsOnlyForFloat?: boolean;\n  /**\n   * Text which will be returned if the value is undefined, null, NaN, Infinity or empty string.\n   * Example: \"–\" will be returned if the value is undefined and emptyText is \"–\".\n   */\n  emptyText?: string;\n  /**\n   * Text to append to the end of the formatted number.\n   * Example: if value is 1000 and postfix is \"₽\", result will be \"1 000₽\".\n   */\n  postfix?: string;\n  /**\n   * Fixed number of digits after the decimal point (number.toFixed() method)\n   * If set to false, the truncation is ignored!\n   */\n  digits?: number | false;\n  /**\n   * Remove trailing zeros from the end of the number\n   * Example: 0.010000000000000000000000000000000000000000000 -> 0.01\n   */\n  cutZeros?: boolean;\n  cropDigitsOnly?: boolean;\n}\n\n/**\n * Formats a numeric value with thousands separators, fractional digit control\n * and optional postfix text.\n *\n * Invalid, empty or unsupported values fall back to `emptyText`.\n *\n * @param rawValue Number or numeric string to format.\n * @param userSettings Formatting overrides merged with `number.defaultSettings`.\n * @returns Formatted number string or fallback text.\n *\n * @example\n * ```ts\n * number(12000); // '12 000'\n * ```\n *\n * @example\n * ```ts\n * number(12.5, { digits: 1, postfix: '%' }); // '12.5%'\n * ```\n */\nexport const number = (\n  rawValue: Maybe<string | number>,\n  userSettings?: Maybe<NumberFormatSettings>,\n): string => {\n  const settings = {\n    ...number.defaultSettings,\n    ...userSettings,\n  };\n\n  const digits = settings.digits ?? 0;\n  const cutZeros = settings?.cutZeros ?? false;\n  const delimiter = settings.delimiter ?? ' ';\n  const postfix = settings.postfix ?? '';\n  const emptyText = settings.emptyText ?? NO_VALUE;\n  const digitsOnlyForFloat = settings.digitsOnlyForFloat ?? true;\n\n  let value: Maybe<number>;\n\n  if (typeGuard.isString(rawValue)) {\n    value = parser.number(value, { fallback: undefined });\n  } else {\n    value = rawValue;\n  }\n\n  if (typeGuard.isNumber(value)) {\n    let raw: string = `${value}`;\n\n    if (digits !== false) {\n      if (settings.cropDigitsOnly) {\n        const [integerPart, decimalPart] = `${raw}`.split('.');\n        const leftPart = integerPart;\n        const rightPart = (decimalPart || '')\n          .slice(0, digits)\n          .padEnd(digits, '0');\n\n        if (rightPart) {\n          raw = `${leftPart}.${rightPart}`;\n        } else {\n          raw = leftPart;\n        }\n      } else {\n        raw = value.toFixed(digits);\n      }\n    }\n\n    if (cutZeros) {\n      raw = `${+raw}`;\n    }\n\n    const [integerPart, decimalPart] = raw.split('.', 2);\n\n    let formattedIntegerPart = integerPart;\n    let formattedDecimalPart = '';\n\n    if (decimalPart && (!digitsOnlyForFloat || !/^0+$/.test(decimalPart))) {\n      formattedDecimalPart = `.${decimalPart}`;\n    }\n\n    const rgx = /(\\d+)(\\d{3})/;\n\n    while (rgx.test(formattedIntegerPart) && delimiter) {\n      formattedIntegerPart = formattedIntegerPart.replace(\n        rgx,\n        `$1${delimiter}$2`,\n      );\n    }\n\n    return formattedIntegerPart + formattedDecimalPart + postfix;\n  }\n\n  return emptyText;\n};\n\nnumber.defaultSettings = {} as NumberFormatSettings;\n","import { parser } from 'yummies/parser';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\nimport { NO_VALUE } from './constants.js';\n\nexport interface PercentFormatSettings\n  extends Omit<parser.NumberParserSettings, 'fallback'> {\n  divider?: string;\n  delimiter?: string;\n  symbol?: string;\n  emptyText?: string;\n}\n\n/**\n * Formats a value as a percent string with configurable decimal precision,\n * decimal divider and suffix symbol.\n *\n * @param value Number or numeric string to format.\n * @param settings Parser and formatting options.\n * @returns Formatted percent string or fallback text for invalid values.\n *\n * @example\n * ```ts\n * percent(12.345); // '12.35%'\n * ```\n *\n * @example\n * ```ts\n * percent(12.345, { divider: ',', symbol: ' pct' }); // '12,35 pct'\n * ```\n */\nexport const percent = (\n  value: Maybe<number | string>,\n  settings?: PercentFormatSettings,\n) => {\n  const numericValue = parser.number(value, {\n    ...settings,\n    digits: settings?.digits ?? 2,\n    fallback: Number.NaN,\n  });\n\n  if (typeGuard.isNumber(numericValue)) {\n    const divider = settings?.divider ?? '.';\n\n    const formattedPercent =\n      divider === '.' ? numericValue : `${numericValue}`.replace('.', divider);\n\n    return `${formattedPercent}${settings?.delimiter ?? ''}${settings?.symbol ?? '%'}`;\n  } else {\n    return settings?.emptyText ?? NO_VALUE;\n  }\n};\n","/**\n * Removes all whitespace characters from a string.\n *\n * @param value Source string.\n * @returns String without spaces, tabs and line breaks.\n *\n * @example\n * ```ts\n * skipSpaces('1 000 000'); // '1000000'\n * ```\n *\n * @example\n * ```ts\n * skipSpaces('a\\tb\\nc'); // 'abc'\n * ```\n */\nexport const skipSpaces = (value: string) => value.replaceAll(/\\s/g, '');\n"],"names":["typeGuard","parser","integerPart","decimalPart"],"mappings":";;;;AAaO,MAAM,WAAW;AAejB,MAAM,SAAS;AAef,MAAM,WAAW;ACcjB,MAAM,SAAS,CACpB,UACA,iBACW;AACX,QAAM,WAAW;AAAA,IACf,GAAG,OAAO;AAAA,IACV,GAAG;AAAA,EAAA;AAGL,QAAM,SAAS,SAAS,UAAU;AAClC,QAAM,WAAW,UAAU,YAAY;AACvC,QAAM,YAAY,SAAS,aAAa;AACxC,QAAM,UAAU,SAAS,WAAW;AACpC,QAAM,YAAY,SAAS,aAAa;AACxC,QAAM,qBAAqB,SAAS,sBAAsB;AAE1D,MAAI;AAEJ,MAAIA,UAAAA,UAAU,SAAS,QAAQ,GAAG;AAChC,YAAQC,OAAAA,OAAO,OAAO,OAAO,EAAE,UAAU,QAAW;AAAA,EACtD,OAAO;AACL,YAAQ;AAAA,EACV;AAEA,MAAID,UAAAA,UAAU,SAAS,KAAK,GAAG;AAC7B,QAAI,MAAc,GAAG,KAAK;AAE1B,QAAI,WAAW,OAAO;AACpB,UAAI,SAAS,gBAAgB;AAC3B,cAAM,CAACE,cAAaC,YAAW,IAAI,GAAG,GAAG,GAAG,MAAM,GAAG;AACrD,cAAM,WAAWD;AACjB,cAAM,aAAaC,gBAAe,IAC/B,MAAM,GAAG,MAAM,EACf,OAAO,QAAQ,GAAG;AAErB,YAAI,WAAW;AACb,gBAAM,GAAG,QAAQ,IAAI,SAAS;AAAA,QAChC,OAAO;AACL,gBAAM;AAAA,QACR;AAAA,MACF,OAAO;AACL,cAAM,MAAM,QAAQ,MAAM;AAAA,MAC5B;AAAA,IACF;AAEA,QAAI,UAAU;AACZ,YAAM,GAAG,CAAC,GAAG;AAAA,IACf;AAEA,UAAM,CAAC,aAAa,WAAW,IAAI,IAAI,MAAM,KAAK,CAAC;AAEnD,QAAI,uBAAuB;AAC3B,QAAI,uBAAuB;AAE3B,QAAI,gBAAgB,CAAC,sBAAsB,CAAC,OAAO,KAAK,WAAW,IAAI;AACrE,6BAAuB,IAAI,WAAW;AAAA,IACxC;AAEA,UAAM,MAAM;AAEZ,WAAO,IAAI,KAAK,oBAAoB,KAAK,WAAW;AAClD,6BAAuB,qBAAqB;AAAA,QAC1C;AAAA,QACA,KAAK,SAAS;AAAA,MAAA;AAAA,IAElB;AAEA,WAAO,uBAAuB,uBAAuB;AAAA,EACvD;AAEA,SAAO;AACT;AAEA,OAAO,kBAAkB,CAAA;AClGlB,MAAM,UAAU,CACrB,OACA,aACG;AACH,QAAM,eAAeF,OAAAA,OAAO,OAAO,OAAO;AAAA,IACxC,GAAG;AAAA,IACH,QAAQ,UAAU,UAAU;AAAA,IAC5B,UAAU,OAAO;AAAA,EAAA,CAClB;AAED,MAAID,UAAAA,UAAU,SAAS,YAAY,GAAG;AACpC,UAAM,UAAU,UAAU,WAAW;AAErC,UAAM,mBACJ,YAAY,MAAM,eAAe,GAAG,YAAY,GAAG,QAAQ,KAAK,OAAO;AAEzE,WAAO,GAAG,gBAAgB,GAAG,UAAU,aAAa,EAAE,GAAG,UAAU,UAAU,GAAG;AAAA,EAClF,OAAO;AACL,WAAO,UAAU,aAAa;AAAA,EAChC;AACF;ACpCO,MAAM,aAAa,CAAC,UAAkB,MAAM,WAAW,OAAO,EAAE;;;;;;;;;;;"}
+{"version":3,"file":"format.cjs","names":[],"sources":["../src/format/number.ts","../src/format/percent.ts","../src/format/skip-spaces.ts","../src/format/_exports.ts"],"sourcesContent":["import { parser } from 'yummies/parser';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\nimport { NO_VALUE } from './constants.js';\n\nexport interface NumberFormatSettings {\n  delimiter?: string;\n  /**\n   * digitsOnlyForFloat - Show digits after decimal point only if they are not zeros after converting to number.\n   * Example: \"0.00\" -> \"0\", \"0.10\" -> \"0.1\", but \"0.003\" -> \"0.003\"\n   *\n   * @default true\n   */\n  digitsOnlyForFloat?: boolean;\n  /**\n   * Text which will be returned if the value is undefined, null, NaN, Infinity or empty string.\n   * Example: \"–\" will be returned if the value is undefined and emptyText is \"–\".\n   */\n  emptyText?: string;\n  /**\n   * Text to append to the end of the formatted number.\n   * Example: if value is 1000 and postfix is \"₽\", result will be \"1 000₽\".\n   */\n  postfix?: string;\n  /**\n   * Fixed number of digits after the decimal point (number.toFixed() method)\n   * If set to false, the truncation is ignored!\n   */\n  digits?: number | false;\n  /**\n   * Remove trailing zeros from the end of the number\n   * Example: 0.010000000000000000000000000000000000000000000 -> 0.01\n   */\n  cutZeros?: boolean;\n  cropDigitsOnly?: boolean;\n}\n\n/**\n * Formats a numeric value with thousands separators, fractional digit control\n * and optional postfix text.\n *\n * Invalid, empty or unsupported values fall back to `emptyText`.\n *\n * @param rawValue Number or numeric string to format.\n * @param userSettings Formatting overrides merged with `number.defaultSettings`.\n * @returns Formatted number string or fallback text.\n *\n * @example\n * ```ts\n * number(12000); // '12 000'\n * ```\n *\n * @example\n * ```ts\n * number(12.5, { digits: 1, postfix: '%' }); // '12.5%'\n * ```\n */\nexport const number = (\n  rawValue: Maybe<string | number>,\n  userSettings?: Maybe<NumberFormatSettings>,\n): string => {\n  const settings = {\n    ...number.defaultSettings,\n    ...userSettings,\n  };\n\n  const digits = settings.digits ?? 0;\n  const cutZeros = settings?.cutZeros ?? false;\n  const delimiter = settings.delimiter ?? ' ';\n  const postfix = settings.postfix ?? '';\n  const emptyText = settings.emptyText ?? NO_VALUE;\n  const digitsOnlyForFloat = settings.digitsOnlyForFloat ?? true;\n\n  let value: Maybe<number>;\n\n  if (typeGuard.isString(rawValue)) {\n    value = parser.number(value, { fallback: undefined });\n  } else {\n    value = rawValue;\n  }\n\n  if (typeGuard.isNumber(value)) {\n    let raw: string = `${value}`;\n\n    if (digits !== false) {\n      if (settings.cropDigitsOnly) {\n        const [integerPart, decimalPart] = `${raw}`.split('.');\n        const leftPart = integerPart;\n        const rightPart = (decimalPart || '')\n          .slice(0, digits)\n          .padEnd(digits, '0');\n\n        if (rightPart) {\n          raw = `${leftPart}.${rightPart}`;\n        } else {\n          raw = leftPart;\n        }\n      } else {\n        raw = value.toFixed(digits);\n      }\n    }\n\n    if (cutZeros) {\n      raw = `${+raw}`;\n    }\n\n    const [integerPart, decimalPart] = raw.split('.', 2);\n\n    let formattedIntegerPart = integerPart;\n    let formattedDecimalPart = '';\n\n    if (decimalPart && (!digitsOnlyForFloat || !/^0+$/.test(decimalPart))) {\n      formattedDecimalPart = `.${decimalPart}`;\n    }\n\n    const rgx = /(\\d+)(\\d{3})/;\n\n    while (rgx.test(formattedIntegerPart) && delimiter) {\n      formattedIntegerPart = formattedIntegerPart.replace(\n        rgx,\n        `$1${delimiter}$2`,\n      );\n    }\n\n    return formattedIntegerPart + formattedDecimalPart + postfix;\n  }\n\n  return emptyText;\n};\n\nnumber.defaultSettings = {} as NumberFormatSettings;\n","import { parser } from 'yummies/parser';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\nimport { NO_VALUE } from './constants.js';\n\nexport interface PercentFormatSettings\n  extends Omit<parser.NumberParserSettings, 'fallback'> {\n  divider?: string;\n  delimiter?: string;\n  symbol?: string;\n  emptyText?: string;\n}\n\n/**\n * Formats a value as a percent string with configurable decimal precision,\n * decimal divider and suffix symbol.\n *\n * @param value Number or numeric string to format.\n * @param settings Parser and formatting options.\n * @returns Formatted percent string or fallback text for invalid values.\n *\n * @example\n * ```ts\n * percent(12.345); // '12.35%'\n * ```\n *\n * @example\n * ```ts\n * percent(12.345, { divider: ',', symbol: ' pct' }); // '12,35 pct'\n * ```\n */\nexport const percent = (\n  value: Maybe<number | string>,\n  settings?: PercentFormatSettings,\n) => {\n  const numericValue = parser.number(value, {\n    ...settings,\n    digits: settings?.digits ?? 2,\n    fallback: Number.NaN,\n  });\n\n  if (typeGuard.isNumber(numericValue)) {\n    const divider = settings?.divider ?? '.';\n\n    const formattedPercent =\n      divider === '.' ? numericValue : `${numericValue}`.replace('.', divider);\n\n    return `${formattedPercent}${settings?.delimiter ?? ''}${settings?.symbol ?? '%'}`;\n  } else {\n    return settings?.emptyText ?? NO_VALUE;\n  }\n};\n","/**\n * Removes all whitespace characters from a string.\n *\n * @param value Source string.\n * @returns String without spaces, tabs and line breaks.\n *\n * @example\n * ```ts\n * skipSpaces('1 000 000'); // '1000000'\n * ```\n *\n * @example\n * ```ts\n * skipSpaces('a\\tb\\nc'); // 'abc'\n * ```\n */\nexport const skipSpaces = (value: string) => value.replaceAll(/\\s/g, '');\n","/**\n * ---header-docs-section---\n * # yummies/format\n *\n * ## Description\n *\n * Namespace-style **number, percent, and string** formatting for UI tables, inputs, and charts.\n * Submodules cover locale-aware numbers, percent parsing/formatting, trimming helpers, and shared\n * constants so presentation rules stay centralized and tree-shakable behind the package\n * aggregated **format** export from this entry point.\n *\n * ## Usage\n *\n * ```ts\n * import { format } from \"yummies/format\";\n * ```\n */\n\nexport * from './constants.js';\nexport * from './number.js';\nexport * from './percent.js';\nexport * from './skip-spaces.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,IAAa,UACX,UACA,iBACW;CACX,MAAM,WAAW;EACf,GAAG,OAAO;EACV,GAAG;EACJ;CAED,MAAM,SAAS,SAAS,UAAU;CAClC,MAAM,WAAW,UAAU,YAAY;CACvC,MAAM,YAAY,SAAS,aAAa;CACxC,MAAM,UAAU,SAAS,WAAW;CACpC,MAAM,YAAY,SAAS,aAAA;CAC3B,MAAM,qBAAqB,SAAS,sBAAsB;CAE1D,IAAI;AAEJ,KAAI,mBAAA,UAAU,SAAS,SAAS,CAC9B,SAAQ,eAAA,OAAO,OAAO,OAAO,EAAE,UAAU,KAAA,GAAW,CAAC;KAErD,SAAQ;AAGV,KAAI,mBAAA,UAAU,SAAS,MAAM,EAAE;EAC7B,IAAI,MAAc,GAAG;AAErB,MAAI,WAAW,MACb,KAAI,SAAS,gBAAgB;GAC3B,MAAM,CAAC,aAAa,eAAe,GAAG,MAAM,MAAM,IAAI;GACtD,MAAM,WAAW;GACjB,MAAM,aAAa,eAAe,IAC/B,MAAM,GAAG,OAAO,CAChB,OAAO,QAAQ,IAAI;AAEtB,OAAI,UACF,OAAM,GAAG,SAAS,GAAG;OAErB,OAAM;QAGR,OAAM,MAAM,QAAQ,OAAO;AAI/B,MAAI,SACF,OAAM,GAAG,CAAC;EAGZ,MAAM,CAAC,aAAa,eAAe,IAAI,MAAM,KAAK,EAAE;EAEpD,IAAI,uBAAuB;EAC3B,IAAI,uBAAuB;AAE3B,MAAI,gBAAgB,CAAC,sBAAsB,CAAC,OAAO,KAAK,YAAY,EAClE,wBAAuB,IAAI;EAG7B,MAAM,MAAM;AAEZ,SAAO,IAAI,KAAK,qBAAqB,IAAI,UACvC,wBAAuB,qBAAqB,QAC1C,KACA,KAAK,UAAU,IAChB;AAGH,SAAO,uBAAuB,uBAAuB;;AAGvD,QAAO;;AAGT,OAAO,kBAAkB,EAAE;;;;;;;;;;;;;;;;;;;;;AClG3B,IAAa,WACX,OACA,aACG;CACH,MAAM,eAAe,eAAA,OAAO,OAAO,OAAO;EACxC,GAAG;EACH,QAAQ,UAAU,UAAU;EAC5B,UAAU;EACX,CAAC;AAEF,KAAI,mBAAA,UAAU,SAAS,aAAa,EAAE;EACpC,MAAM,UAAU,UAAU,WAAW;AAKrC,SAAO,GAFL,YAAY,MAAM,eAAe,GAAG,eAAe,QAAQ,KAAK,QAAQ,GAE7C,UAAU,aAAa,KAAK,UAAU,UAAU;OAE7E,QAAO,UAAU,aAAA;;;;;;;;;;;;;;;;;;;;AClCrB,IAAa,cAAc,UAAkB,MAAM,WAAW,OAAO,GAAG"}

package/format.d.ts

@@ -144,6 +144,24 @@ declare const percent: (value: Maybe<number | string>, settings?: PercentFormatS
  */
 declare const skipSpaces: (value: string) => string;
 
+/**
+ * ---header-docs-section---
+ * # yummies/format
+ *
+ * ## Description
+ *
+ * Namespace-style **number, percent, and string** formatting for UI tables, inputs, and charts.
+ * Submodules cover locale-aware numbers, percent parsing/formatting, trimming helpers, and shared
+ * constants so presentation rules stay centralized and tree-shakable behind the package
+ * aggregated **format** export from this entry point.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import { format } from "yummies/format";
+ * ```
+ */
+
 declare const _exports_HYPHEN: typeof HYPHEN;
 declare const _exports_INFINITY: typeof INFINITY;
 declare const _exports_NO_VALUE: typeof NO_VALUE;