@ptx-showcase/utils 0.5.0 → 0.6.0

package/README.md

@@ -208,6 +208,32 @@ import { normalizeDecimalInput, normalizePhoneNumberInput } from '@ptx-showcase/
 
 ---
 
+### truncateDecimals
+
+Formats a number (or numeric string) to a fixed number of decimal places by cutting the extra digits off, **without rounding**. Accepts a string too, so values more precise than a JS `number` can hold (e.g. amounts from an API) can be truncated without a lossy float conversion first. Returns `'N/A'` for anything that isn't a finite number or a well-formed numeric string.
+
+```ts
+// from root
+import { truncateDecimals } from '@ptx-showcase/utils'
+
+// from subpath
+import { truncateDecimals } from '@ptx-showcase/utils/truncate-decimals'
+
+truncateDecimals(4.21312312) // → '4.21'
+truncateDecimals(4.995) // → '4.99' (not rounded to 5.00)
+truncateDecimals(4.2) // → '4.2' (fewer decimals than requested — left untouched)
+truncateDecimals(4.219, 0) // → '4'
+
+// numeric string input — no float precision loss
+truncateDecimals('4.219999999999999999999999', 2) // → '4.21'
+
+// invalid input
+truncateDecimals('not a number') // → 'N/A'
+truncateDecimals(undefined) // → 'N/A'
+```
+
+---
+
 ## Available modules
 
 | Subpath                                  | Exports                                                          |
@@ -220,6 +246,7 @@ import { normalizeDecimalInput, normalizePhoneNumberInput } from '@ptx-showcase/
 | `@ptx-showcase/utils/download-file`      | `downloadBlob`                                                   |
 | `@ptx-showcase/utils/handle-api-error`   | `handleApiError`, `initHandleApiError`                           |
 | `@ptx-showcase/utils/normalize-input`    | `normalizeDecimalInput`, `normalizePhoneNumberInput`             |
+| `@ptx-showcase/utils/truncate-decimals`  | `truncateDecimals`                                               |
 | `@ptx-showcase/utils/types`              | `TableColumnConfig`, `PaginatedList`                             |
 
 ---

package/dist/chunks/truncate-decimals-BFMoEzul.es

@@ -0,0 +1,7 @@
+//#region src/truncate-decimals/constants/truncate-decimals.constant.ts
+var e = /^-?\d+(\.\d+)?$/, t = (t, r = 2) => typeof t == "number" ? Number.isFinite(t) ? n(String(t), r) : "N/A" : typeof t == "string" && e.test(t.trim()) ? n(t.trim(), r) : "N/A", n = (e, t) => {
+	let [n, r] = e.split(".");
+	return r === void 0 ? e : t > 0 ? `${n}.${r.slice(0, t)}` : n;
+};
+//#endregion
+export { t };

package/dist/chunks/truncate-decimals-CArL-IeO.cjs

@@ -0,0 +1 @@
+var e=/^-?\d+(\.\d+)?$/,t=(t,r=2)=>typeof t==`number`?Number.isFinite(t)?n(String(t),r):`N/A`:typeof t==`string`&&e.test(t.trim())?n(t.trim(),r):`N/A`,n=(e,t)=>{let[n,r]=e.split(`.`);return r===void 0?e:t>0?`${n}.${r.slice(0,t)}`:n};Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return t}});

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./build-query-params/index.cjs"),t=require("./clean-object/index.cjs"),n=require("./cookies/index.cjs"),r=require("./build-sort-param/index.cjs"),i=require("./chunks/currency-symbol-gb63Q_9Q.cjs"),a=require("./download-file/index.cjs"),o=require("./chunks/handle-api-error-D714W9rp.cjs"),s=require("./normalize-input/index.cjs");exports.buildQueryParams=e.buildQueryParams,exports.buildSortParam=r.buildSortParam,exports.cleanObject=t.cleanObject,exports.defaultCookieOptions=n.defaultCookieOptions,exports.deleteCookie=n.deleteCookie,exports.downloadBlob=a.downloadBlob,exports.getCookie=n.getCookie,exports.getCurrencySymbol=i.t,exports.handleApiError=o.t,exports.initHandleApiError=o.n,exports.normalizeDecimalInput=s.normalizeDecimalInput,exports.normalizePhoneNumberInput=s.normalizePhoneNumberInput,exports.setCookie=n.setCookie;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./build-query-params/index.cjs"),t=require("./clean-object/index.cjs"),n=require("./cookies/index.cjs"),r=require("./build-sort-param/index.cjs"),i=require("./chunks/currency-symbol-gb63Q_9Q.cjs"),a=require("./download-file/index.cjs"),o=require("./chunks/handle-api-error-D714W9rp.cjs"),s=require("./normalize-input/index.cjs"),c=require("./chunks/truncate-decimals-CArL-IeO.cjs");exports.buildQueryParams=e.buildQueryParams,exports.buildSortParam=r.buildSortParam,exports.cleanObject=t.cleanObject,exports.defaultCookieOptions=n.defaultCookieOptions,exports.deleteCookie=n.deleteCookie,exports.downloadBlob=a.downloadBlob,exports.getCookie=n.getCookie,exports.getCurrencySymbol=i.t,exports.handleApiError=o.t,exports.initHandleApiError=o.n,exports.normalizeDecimalInput=s.normalizeDecimalInput,exports.normalizePhoneNumberInput=s.normalizePhoneNumberInput,exports.setCookie=n.setCookie,exports.truncateDecimals=c.t;

package/dist/index.d.ts

@@ -7,3 +7,4 @@ export * from './currency-symbol';
 export * from './download-file';
 export * from './handle-api-error';
 export * from './normalize-input';
+export * from './truncate-decimals';

package/dist/index.js

@@ -6,4 +6,5 @@ import { t as s } from "./chunks/currency-symbol-CBowgXv-.es";
 import { downloadBlob as c } from "./download-file/index.js";
 import { n as l, t as u } from "./chunks/handle-api-error-CMd_LxPS.es";
 import { normalizeDecimalInput as d, normalizePhoneNumberInput as f } from "./normalize-input/index.js";
-export { e as buildQueryParams, o as buildSortParam, t as cleanObject, n as defaultCookieOptions, r as deleteCookie, c as downloadBlob, i as getCookie, s as getCurrencySymbol, u as handleApiError, l as initHandleApiError, d as normalizeDecimalInput, f as normalizePhoneNumberInput, a as setCookie };
+import { t as p } from "./chunks/truncate-decimals-BFMoEzul.es";
+export { e as buildQueryParams, o as buildSortParam, t as cleanObject, n as defaultCookieOptions, r as deleteCookie, c as downloadBlob, i as getCookie, s as getCurrencySymbol, u as handleApiError, l as initHandleApiError, d as normalizeDecimalInput, f as normalizePhoneNumberInput, a as setCookie, p as truncateDecimals };

package/dist/truncate-decimals/constants/truncate-decimals.constant.d.ts

@@ -0,0 +1 @@
+export declare const NUMERIC_STRING_PATTERN: RegExp;

package/dist/truncate-decimals/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../chunks/truncate-decimals-CArL-IeO.cjs");exports.truncateDecimals=e.t;

package/dist/truncate-decimals/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Formats a number (or numeric string) to a fixed number of decimal places
+ * by cutting the extra digits off, without rounding.
+ *
+ * Unlike `toFixed`, `4.21312312` truncated to 2 decimals stays `4.21`
+ * instead of being rounded to `4.21`/`4.22` depending on the digits that follow.
+ *
+ * Accepts a string as well as a number so that values with more precision
+ * than a JS `number` can hold safely (e.g. amounts coming from an API as
+ * strings) can be truncated without going through a lossy float conversion first.
+ *
+ * Numbers large/small enough to be stringified in exponential notation
+ * (e.g. `1e+21`, `1e-7`) are returned as-is, since there's no decimal part to cut.
+ *
+ * @param value - The number (or numeric string) to truncate
+ * @param decimals - Number of digits to keep after the decimal point.
+ * Pass `0` to drop the decimal part entirely. Defaults to `2`.
+ * @returns The truncated value as a string; `'N/A'` if `value` isn't a finite
+ * number or a well-formed numeric string (e.g. `undefined`, `null`, `NaN`,
+ * `{}`, `[]`, `'not a number'`)
+ *
+ * @example
+ * ```ts
+ * truncateDecimals(4.21312312) // => '4.21'
+ * truncateDecimals(4.2) // => '4.2' (fewer decimals than requested — left untouched)
+ * truncateDecimals(4.219, 0) // => '4'
+ * truncateDecimals('4.219999999999999999999999', 2) // => '4.21' (string input, no float precision loss)
+ * truncateDecimals('not a number') // => 'N/A'
+ * truncateDecimals(undefined as unknown as number) // => 'N/A'
+ * ```
+ */
+export declare const truncateDecimals: (value: number | string, decimals?: number) => string;

package/dist/truncate-decimals/index.js

@@ -0,0 +1,2 @@
+import { t as e } from "../chunks/truncate-decimals-BFMoEzul.es";
+export { e as truncateDecimals };

package/package.json

@@ -2,7 +2,7 @@
 	"name": "@ptx-showcase/utils",
 	"author": "ptx-showcase",
 	"description": "Shared utilities for PTX Showcase projects",
-	"version": "0.5.0",
+	"version": "0.6.0",
 	"private": false,
 	"type": "module",
 	"license": "MIT",
@@ -71,6 +71,11 @@
 			"require": "./dist/normalize-input/index.cjs",
 			"types": "./dist/normalize-input/index.d.ts"
 		},
+		"./truncate-decimals": {
+			"import": "./dist/truncate-decimals/index.js",
+			"require": "./dist/truncate-decimals/index.cjs",
+			"types": "./dist/truncate-decimals/index.d.ts"
+		},
 		"./types": {
 			"import": "./dist/types/index.js",
 			"require": "./dist/types/index.cjs",
@@ -92,20 +97,20 @@
 		"access": "public"
 	},
 	"devDependencies": {
-		"@types/node": "^26.1.2",
-		"bumpp": "^12.2.0",
-		"oxfmt": "^0.62.0",
-		"oxlint": "^1.77.0",
+		"@types/node": "^26.4.0",
+		"bumpp": "^12.2.2",
+		"oxfmt": "^0.65.0",
+		"oxlint": "^1.80.0",
 		"typescript": "~6.0.3",
-		"vite": "^8.2.1",
+		"vite": "^8.2.2",
 		"vite-plugin-dts": "^5.0.3",
-		"vitest": "^4.1.10"
+		"vitest": "^4.1.11"
 	},
 	"dependencies": {
 		"@types/file-saver": "^2.0.7",
 		"@types/js-cookie": "^3.0.6",
 		"file-saver": "^2.0.5",
 		"js-cookie": "^3.0.8",
-		"ky": "^2.0.2"
+		"ky": "^2.1.0"
 	}
 }