@ptx-showcase/utils 0.4.0-beta.1 → 0.5.0

package/README.md

@@ -126,6 +126,30 @@ await downloadBlob(blob, { hash: 12345 })
 
 ---
 
+### getCurrencySymbol
+
+Resolves the symbol for an ISO 4217 currency code via `Intl`. A handful of currencies (`AUD`, `CAD`, `NZD`, `CHF`, etc.) are overridden where the `Intl` narrow symbol would be ambiguous.
+
+```ts
+// from root
+import { getCurrencySymbol } from '@ptx-showcase/utils'
+
+// from subpath
+import { getCurrencySymbol } from '@ptx-showcase/utils/currency-symbol'
+
+getCurrencySymbol('EUR') // → '€'
+getCurrencySymbol('USD') // → '$'
+getCurrencySymbol('AUD') // → 'A$' (override)
+getCurrencySymbol('CHF') // → '₣' (override)
+getCurrencySymbol('ZZZ') // → 'ZZZ' (well-formed but unknown code)
+getCurrencySymbol('EURO') // → 'N/A' (not a 3-letter code)
+
+// custom locale
+getCurrencySymbol('EUR', 'de-DE') // → '€'
+```
+
+---
+
 ### handleApiError
 
 Parses backend error responses (including `ky`'s `HTTPError`) and reports human-readable messages through whatever notification system your project uses (`vue-sonner`, `react-hot-toast`, `console.error`, etc).
@@ -159,6 +183,31 @@ try {
 
 ---
 
+### normalizeDecimalInput / normalizePhoneNumberInput
+
+In-place `input`/`change` event handlers that sanitize a text input's value as the user types.
+
+- `normalizeDecimalInput` — keeps only digits and a single dot, converts a comma to a dot, prefixes a leading dot with `0`, and truncates the decimal part to `decimals` digits (default `2`).
+- `normalizePhoneNumberInput` — keeps only digits, truncates to `maxDigits` (default `15`, the E.164 limit), and prefixes the result with `+`.
+
+```ts
+// from root
+import { normalizeDecimalInput, normalizePhoneNumberInput } from '@ptx-showcase/utils'
+
+// from subpath
+import { normalizeDecimalInput, normalizePhoneNumberInput } from '@ptx-showcase/utils/normalize-input'
+
+// Vue
+<input type="text" inputmode="decimal" @input="normalizeDecimalInput" />
+<input type="text" inputmode="tel" @input="normalizePhoneNumberInput" />
+
+// React (wrap to access the native event)
+<input type="text" inputMode="decimal" onChange={(e) => normalizeDecimalInput(e.nativeEvent, 4)} />
+<input type="text" inputMode="tel" onChange={(e) => normalizePhoneNumberInput(e.nativeEvent, 11)} />
+```
+
+---
+
 ## Available modules
 
 | Subpath                                  | Exports                                                          |
@@ -167,9 +216,11 @@ try {
 | `@ptx-showcase/utils/build-query-params` | `buildQueryParams`                                               |
 | `@ptx-showcase/utils/build-sort-param`   | `buildSortParam`                                                 |
 | `@ptx-showcase/utils/cookies`            | `setCookie`, `getCookie`, `deleteCookie`, `defaultCookieOptions` |
+| `@ptx-showcase/utils/currency-symbol`    | `getCurrencySymbol`                                              |
 | `@ptx-showcase/utils/download-file`      | `downloadBlob`                                                   |
 | `@ptx-showcase/utils/handle-api-error`   | `handleApiError`, `initHandleApiError`                           |
-| `@ptx-showcase/utils/types`              | `TableColumnConfig`                                              |
+| `@ptx-showcase/utils/normalize-input`    | `normalizeDecimalInput`, `normalizePhoneNumberInput`             |
+| `@ptx-showcase/utils/types`              | `TableColumnConfig`, `PaginatedList`                             |
 
 ---
 

package/dist/build-query-params/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=e=>{let t=new URLSearchParams;Object.entries(e).forEach(([e,n])=>{n==null||n===``||Array.isArray(n)&&n.length===0||t.append(e,String(n))});let n=t.toString();return n?`?${n}`:``};exports.buildQueryParams=e;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=e=>{let t=new URLSearchParams;Object.entries(e).forEach(([e,n])=>{n!=null&&n!==``&&(Array.isArray(n)&&n.length===0||t.append(e,String(n)))});let n=t.toString();return n?`?${n}`:``};exports.buildQueryParams=e;

package/dist/build-query-params/index.js

@@ -2,7 +2,7 @@
 var e = (e) => {
 	let t = new URLSearchParams();
 	Object.entries(e).forEach(([e, n]) => {
-		n == null || n === "" || Array.isArray(n) && n.length === 0 || t.append(e, String(n));
+		n != null && n !== "" && (Array.isArray(n) && n.length === 0 || t.append(e, String(n)));
 	});
 	let n = t.toString();
 	return n ? `?${n}` : "";

package/dist/chunks/currency-symbol-CBowgXv-.es

@@ -0,0 +1,26 @@
+//#region src/currency-symbol/constants/currency-symbol.constant.ts
+var e = {
+	CHF: "₣",
+	AUD: "A$",
+	CAD: "CA$",
+	NZD: "NZ$",
+	HKD: "HK$",
+	MXN: "MX$",
+	SGD: "S$"
+}, t = (t, n = "en-US") => {
+	if (typeof t != "string" || t == null || t === "" || t === " " || t.length !== 3) return "N/A";
+	let r = e[t.toUpperCase()];
+	if (r !== void 0) return r;
+	try {
+		let e = new Intl.NumberFormat(n, {
+			style: "currency",
+			currency: t,
+			currencyDisplay: "narrowSymbol"
+		}).formatToParts(0).find((e) => e.type === "currency");
+		return e === void 0 ? t : e.value;
+	} catch {
+		return t;
+	}
+};
+//#endregion
+export { t };

package/dist/chunks/currency-symbol-gb63Q_9Q.cjs

@@ -0,0 +1 @@
+var e={CHF:`₣`,AUD:`A$`,CAD:`CA$`,NZD:`NZ$`,HKD:`HK$`,MXN:`MX$`,SGD:`S$`},t=(t,n=`en-US`)=>{if(typeof t!=`string`||t==null||t===``||t===` `||t.length!==3)return`N/A`;let r=e[t.toUpperCase()];if(r!==void 0)return r;try{let e=new Intl.NumberFormat(n,{style:`currency`,currency:t,currencyDisplay:`narrowSymbol`}).formatToParts(0).find(e=>e.type===`currency`);return e===void 0?t:e.value}catch{return t}};Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return t}});

package/dist/cookies/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require("js-cookie");c=s(c,1);var l={expires:1/24,secure:!0,sameSite:`Strict`},u=(e,t,n)=>{c.default.set(e,t,{...l,...n})},d=e=>c.default.get(e),f=(e,t)=>{c.default.remove(e,t)};exports.defaultCookieOptions=l,exports.deleteCookie=f,exports.getCookie=d,exports.setCookie=u;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,s)=>(s=n==null?{}:e(i(n)),o(r||!n||!n.__esModule||!a.call(n,`default`)?t(s,`default`,{value:n,enumerable:!0}):s,n));let c=require("js-cookie");c=s(c,1);var l={expires:1/24,secure:!0,sameSite:`Strict`},u=(e,t,n)=>{c.default.set(e,t,{...l,...n})},d=e=>c.default.get(e),f=(e,t)=>{c.default.remove(e,t)};exports.defaultCookieOptions=l,exports.deleteCookie=f,exports.getCookie=d,exports.setCookie=u;

package/dist/currency-symbol/constants/currency-symbol.constant.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Explicit code → symbol overrides, checked before falling back to `Intl`.
+ * Use this for symbols `Intl` doesn't resolve the way you want (missing,
+ * wrong, or just not the convention your product uses).
+ */
+export declare const CURRENCY_SYMBOL_OVERRIDES: Record<string, string>;

package/dist/currency-symbol/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../chunks/currency-symbol-gb63Q_9Q.cjs");exports.getCurrencySymbol=e.t;

package/dist/currency-symbol/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Returns the symbol for a given ISO 4217 currency code.
+ *
+ * Codes listed in `CURRENCY_SYMBOL_OVERRIDES` are returned as-is — this
+ * covers currencies whose `Intl` narrow symbol is ambiguous (e.g. `AUD`,
+ * `CAD`, `NZD` all narrow to a plain `$`) or otherwise not what the product
+ * wants. Everything else is resolved via the runtime's `Intl` data, so all
+ * other currencies are supported without a hardcoded map.
+ *
+ * @param code - ISO 4217 currency code (e.g. `"EUR"`)
+ * @param locale - Locale used to resolve the symbol. Defaults to `"en-US"`.
+ * @returns The currency symbol; `code` itself if it's well-formed but not a
+ * recognized currency; `"N/A"` if `code` isn't a 3-letter string
+ *
+ * @example
+ * ```ts
+ * getCurrencySymbol('EUR') // => '€'
+ * getCurrencySymbol('USD') // => '$'
+ * getCurrencySymbol('AUD') // => 'A$' (override)
+ * getCurrencySymbol('CHF') // => '₣' (override)
+ * ```
+ */
+export declare const getCurrencySymbol: (code: string, locale?: string) => string;

package/dist/currency-symbol/index.js

@@ -0,0 +1,2 @@
+import { t as e } from "../chunks/currency-symbol-CBowgXv-.es";
+export { e as getCurrencySymbol };

package/dist/download-file/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("file-saver");var t=async e=>{let t=new TextEncoder().encode(String(e)),n=await crypto.subtle.digest(`SHA-1`,t);return Array.from(new Uint8Array(n)).map(e=>e.toString(16).padStart(2,`0`)).join(``)},n=async(n,r)=>{if(!(n instanceof Blob))throw Error(`downloadBlob: expected Blob, got ${typeof n}`);(0,e.saveAs)(n,`filename`in r?r.filename:await t(r.hash))};exports.downloadBlob=n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("file-saver");var t=async e=>{let t=new TextEncoder().encode(String(e)),n=await crypto.subtle.digest(`SHA-1`,t);return Array.from(new Uint8Array(n)).map(e=>e.toString(16).padStart(2,`0`)).join(``)},n=async(n,r)=>{if(!(n instanceof Blob))throw Error(`downloadBlob: expected Blob, got ${typeof n}`);let i=`filename`in r?r.filename:await t(r.hash);(0,e.saveAs)(n,i)};exports.downloadBlob=n;

package/dist/download-file/index.js

@@ -5,7 +5,8 @@ var t = async (e) => {
 	return Array.from(new Uint8Array(n)).map((e) => e.toString(16).padStart(2, "0")).join("");
 }, n = async (n, r) => {
 	if (!(n instanceof Blob)) throw Error(`downloadBlob: expected Blob, got ${typeof n}`);
-	e(n, "filename" in r ? r.filename : await t(r.hash));
+	let i = "filename" in r ? r.filename : await t(r.hash);
+	e(n, i);
 };
 //#endregion
 export { n as downloadBlob };

package/dist/handle-api-error/index.js

@@ -1,2 +1,2 @@
-import { n as e, t } from "../chunks/handle-api-error-CMd_LxPS.esm";
+import { n as e, t } from "../chunks/handle-api-error-CMd_LxPS.es";
 export { t as handleApiError, e as initHandleApiError };

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("./download-file/index.cjs"),a=require("./chunks/handle-api-error-D714W9rp.cjs"),o=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=i.downloadBlob,exports.getCookie=n.getCookie,exports.handleApiError=a.t,exports.initHandleApiError=a.n,exports.normalizeDecimalInput=o.normalizeDecimalInput,exports.normalizePhoneNumberInput=o.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");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;

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './clean-object';
 export * from './cookies';
 export type * from './types';
 export * from './build-sort-param';
+export * from './currency-symbol';
 export * from './download-file';
 export * from './handle-api-error';
 export * from './normalize-input';

package/dist/index.js

@@ -2,7 +2,8 @@ import { buildQueryParams as e } from "./build-query-params/index.js";
 import { cleanObject as t } from "./clean-object/index.js";
 import { defaultCookieOptions as n, deleteCookie as r, getCookie as i, setCookie as a } from "./cookies/index.js";
 import { buildSortParam as o } from "./build-sort-param/index.js";
-import { downloadBlob as s } from "./download-file/index.js";
-import { n as c, t as l } from "./chunks/handle-api-error-CMd_LxPS.esm";
-import { normalizeDecimalInput as u, normalizePhoneNumberInput as d } from "./normalize-input/index.js";
-export { e as buildQueryParams, o as buildSortParam, t as cleanObject, n as defaultCookieOptions, r as deleteCookie, s as downloadBlob, i as getCookie, l as handleApiError, c as initHandleApiError, u as normalizeDecimalInput, d as normalizePhoneNumberInput, a as setCookie };
+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 };

package/dist/types/index.d.ts

@@ -4,3 +4,10 @@ export interface TableColumnConfig<T, ExtraKeys extends string = never> {
     key: keyof T | ExtraKeys;
     sortable?: boolean;
 }
+export interface PaginatedList<T> {
+    items: T[];
+    page: number;
+    per_page: number;
+    total_items: number;
+    total_pages: number;
+}

package/package.json

@@ -2,7 +2,7 @@
 	"name": "@ptx-showcase/utils",
 	"author": "ptx-showcase",
 	"description": "Shared utilities for PTX Showcase projects",
-	"version": "0.4.0-beta.1",
+	"version": "0.5.0",
 	"private": false,
 	"type": "module",
 	"license": "MIT",
@@ -51,6 +51,11 @@
 			"require": "./dist/clean-object/index.cjs",
 			"types": "./dist/clean-object/index.d.ts"
 		},
+		"./currency-symbol": {
+			"import": "./dist/currency-symbol/index.js",
+			"require": "./dist/currency-symbol/index.cjs",
+			"types": "./dist/currency-symbol/index.d.ts"
+		},
 		"./download-file": {
 			"import": "./dist/download-file/index.js",
 			"require": "./dist/download-file/index.cjs",
@@ -87,12 +92,12 @@
 		"access": "public"
 	},
 	"devDependencies": {
-		"@types/node": "^26.1.1",
-		"bumpp": "^11.1.0",
-		"oxfmt": "^0.58.0",
-		"oxlint": "^1.73.0",
+		"@types/node": "^26.1.2",
+		"bumpp": "^12.2.0",
+		"oxfmt": "^0.62.0",
+		"oxlint": "^1.77.0",
 		"typescript": "~6.0.3",
-		"vite": "^8.1.4",
+		"vite": "^8.2.1",
 		"vite-plugin-dts": "^5.0.3",
 		"vitest": "^4.1.10"
 	},