4.24.0: add filters, bump deps

Author: fergusean

package.json

@@ -1,7 +1,7 @@
 {
     "name": "@signal24/vue-foundation",
     "type": "module",
-    "version": "4.23.0",
+    "version": "4.24.0",
     "description": "Common components, directives, and helpers for Vue 3 apps",
     "module": "./dist/vue-foundation.es.js",
     "exports": {
@@ -34,6 +34,7 @@
     },
     "license": "MIT",
     "dependencies": {
+        "currency.js": "^2.0.4",
         "uuid": "^11.1.0"
     },
     "peerDependencies": {
@@ -43,7 +44,7 @@
         "vue": "^3.4.0"
     },
     "devDependencies": {
-        "@eslint/js": "9.26.0",
+        "@eslint/js": "9.27.0",
         "@nabla/vite-plugin-eslint": "^2.0.5",
         "@signal24/openapi-client-codegen": "^2.5.0",
         "@tsconfig/node22": "^22.0.1",
@@ -58,22 +59,22 @@
         "@vue/tsconfig": "^0.7.0",
         "cypress": "^14.3.3",
         "date-fns": "^4.1.0",
-        "eslint": "9.26.0",
+        "eslint": "9.27.0",
         "eslint-plugin-cypress": "^4.3.0",
         "eslint-plugin-simple-import-sort": "^12.1.1",
         "eslint-plugin-unused-imports": "^4.1.4",
         "eslint-plugin-vue": "^10.1.0",
         "jsdom": "^26.1.0",
         "lodash": "^4.17.21",
         "prettier": "^3.5.3",
-        "sass": "^1.88.0",
-        "start-server-and-test": "^2.0.11",
+        "sass": "^1.89.0",
+        "start-server-and-test": "^2.0.12",
         "type-fest": "^4.41.0",
         "typescript": "~5.8",
         "typescript-eslint": "^8.32.1",
         "vite": "^6.3.5",
         "vitest": "^3.1.3",
-        "vue": "^3.5.13",
+        "vue": "^3.5.14",
         "vue-tsc": "^2.2.10"
     },
     "packageManager": "[email protected]"

src/filters/index.ts

@@ -1,5 +1,9 @@
+import currency from 'currency.js';
+import { addDays, format, parse } from 'date-fns';
 import { startCase as _startCase, upperFirst as _upperFirst } from 'lodash';
 
+import { VfOptions } from '@/config';
+
 import { desnakeCase, formatNumber, formatPhone, formatUSCurrency } from '..';
 
 function bytes(value: number) {
@@ -48,6 +52,12 @@ function upperCase(value: string | null) {
     return value ? value.toUpperCase() : null;
 }
 
+function upperWords(value: null): null;
+function upperWords(value: string): string;
+function upperWords(value: string | null) {
+    return value ? startCase(value.toLowerCase()) : null;
+}
+
 function desnake(value: null): null;
 function desnake(value: string): string;
 function desnake(value: string | null) {
@@ -58,6 +68,30 @@ function usCurrency(value: string | number, divisor = 1) {
     return formatUSCurrency(value, divisor);
 }
 
+function divide(value: number, divisor: number) {
+    return currency(value).divide(divisor).value;
+}
+
+function date(value: string | null, formatStr?: string) {
+    if (!value) return value;
+    return format(new Date(value), formatStr ?? VfOptions.defaultDateFormat);
+}
+
+function time(value: string | null, formatStr?: string) {
+    if (!value) return value;
+    return format(new Date(value), formatStr ?? VfOptions.defaultTimeFormat);
+}
+
+function dateTime(value: string | null, formatStr?: string) {
+    if (!value) return value;
+    return format(new Date(value), formatStr ?? VfOptions.defaultDateFormat);
+}
+
+function oneDayForward(date?: string | null) {
+    if (!date) return date;
+    return format(addDays(parse(date, 'yyyy-MM-dd', new Date()), 1), VfOptions.defaultDateFormat);
+}
+
 const FilterFns = {
     bytes,
     dash,
@@ -67,8 +101,14 @@ const FilterFns = {
     upperFirst,
     startCase,
     upperCase,
+    upperWords,
     desnake,
-    usCurrency
+    usCurrency,
+    divide,
+    date,
+    time,
+    dateTime,
+    oneDayForward
 };
 
 // type FilterFn = (value: any, ...unknown: any[]) => any;

src/helpers/string.ts

@@ -1,3 +1,4 @@
+import currency from 'currency.js';
 import { v4 as uuidv4 } from 'uuid';
 
 // placing this here so we don't have to use the ESLint rule everywhere
@@ -19,13 +20,7 @@ export function formatPhone(value: string) {
 }
 
 export function formatUSCurrency(value: string | number, divisor = 1) {
-    return (
-        '$' +
-        (Number(value) / divisor)
-            .toFixed(3)
-            .replace(/0$/, '')
-            .replace(/\B(?=(\d{3})+(?!\d))/g, ',')
-    );
+    return currency(value).divide(divisor).format();
 }
 
 export function uuid() {