@soleil-se/app-util 5.13.0 → 5.14.1

package/CHANGELOG.md

@@ -7,6 +7,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.14.1] - 2026-05-15
+
+- Add exports to package.json for better support in ESM environments.
+
+## [5.14.0] - 2026-04-24
+
+- `localizedCompareBy` now accepts objects with a `key` and optional `order` (`'asc'` | `'desc'`, 
+  defaults to `'asc'`) in addition to plain strings, enabling per-property sort direction.
+  Existing string-based usage is unchanged.
+
 ## [5.13.0] - 2026-01-16
 
 - Add comparator functions `localizedCompare` and `localizedCompareBy` to sort strings and objects 

package/common/localized-compare/index.d.ts

@@ -11,10 +11,19 @@ export function localizedCompare(a: string, b: string): number;
  * Creates a comparator function for sorting objects by a specific property or properties.
  * The property values are compared using localized string comparison.
  * When given an array of properties, sorts by the first property, then by the second if equal, etc.
- * @param {string|string[]} prop - The property name(s) to compare by.
+ * Each property can be a string or an object with a `key` and optional `order` ('asc' | 'desc', defaults to 'asc').
+ * @param {string|{key: string, order?: 'asc'|'desc'}|Array<string|{key: string, order?: 'asc'|'desc'}>} prop - The property name(s) to compare by.
  * @returns {(a: Object, b: Object) => number} A comparator function that accepts two objects and returns their sort order.
  * @example
  * arr.sort(localizedCompareBy('title'))
  * arr.sort(localizedCompareBy(['lastName', 'firstName']))
+ * arr.sort(localizedCompareBy({ key: 'firstName', order: 'desc' }))
+ * arr.sort(localizedCompareBy([{ key: 'lastName', order: 'asc' }, { key: 'firstName', order: 'desc' }]))
  */
-export function localizedCompareBy(prop: string | string[]): (a: any, b: any) => number;
+export function localizedCompareBy(prop: string | {
+    key: string;
+    order?: 'asc' | 'desc';
+} | Array<string | {
+    key: string;
+    order?: 'asc' | 'desc';
+}>): (a: any, b: any) => number;

package/common/localized-compare/index.js

@@ -82,20 +82,28 @@ export function localizedCompare(a, b) {
  * Creates a comparator function for sorting objects by a specific property or properties.
  * The property values are compared using localized string comparison.
  * When given an array of properties, sorts by the first property, then by the second if equal, etc.
- * @param {string|string[]} prop - The property name(s) to compare by.
+ * Each property can be a string or an object with a `key` and optional `order` ('asc' | 'desc', defaults to 'asc').
+ * @param {string|{key: string, order?: 'asc'|'desc'}|Array<string|{key: string, order?: 'asc'|'desc'}>} prop - The property name(s) to compare by.
  * @returns {(a: Object, b: Object) => number} A comparator function that accepts two objects and returns their sort order.
  * @example
  * arr.sort(localizedCompareBy('title'))
  * arr.sort(localizedCompareBy(['lastName', 'firstName']))
+ * arr.sort(localizedCompareBy({ key: 'firstName', order: 'desc' }))
+ * arr.sort(localizedCompareBy([{ key: 'lastName', order: 'asc' }, { key: 'firstName', order: 'desc' }]))
  */
 export function localizedCompareBy(prop) {
-  const props = Array.isArray(prop) ? prop : [prop];
+  const props = (Array.isArray(prop) ? prop : [prop])
+    .map((p) => (typeof p === 'string'
+      ? { key: p, order: 'asc' }
+      : { key: p.key, order: p.order ?? 'asc' }
+    ));
 
   return (a, b) => {
     for (let i = 0; i < props.length; i += 1) {
-      const result = localizedCompare(a[props[i]], b[props[i]]);
+      const { key, order } = props[i];
+      const result = localizedCompare(a[key], b[key]);
       if (result !== 0) {
-        return result;
+        return order === 'desc' ? -result : result;
       }
     }
     return 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleil-se/app-util",
-  "version": "5.13.0",
+  "version": "5.14.1",
   "description": "Utility functions for WebApps, RESTApps and Widgets in Sitevision.",
   "main": "./common/index.js",
   "author": "Soleil AB",
@@ -16,14 +16,29 @@
     "svelte"
   ],
   "devDependencies": {
-    "@sitevision/api": "^2025.1.2",
-    "svelte": "^5.22.6"
+    "@sitevision/api": "^2026.4.2",
+    "svelte": "^5.55.7"
   },
   "peerDependencies": {
     "@sitevision/api": "*"
   },
   "scripts": {
-    "create-type-definitions": "node ../../utils/createTypeDefinitions.js ./common/index.js ./client/index.js ./client/svelte/index.js ./client/svelte/3/index.js ./client/svelte/4/index.js ./client/svelte/5/index.js ./server/index.js ./server/svelte/index.js ./server/svelte/3/index.js ./server/svelte/4/index.js ./server/svelte/5/index.js ./server/app-data/index.js ./server/global-app-data/index.js"
+    "create-type-definitions": "node ../../utils/createTypeDefinitions.js ./common/index.js ./common/localized-compare/index.js ./client/index.js ./client/svelte/index.js ./client/svelte/3/index.js ./client/svelte/4/index.js ./client/svelte/5/index.js ./server/index.js ./server/svelte/index.js ./server/svelte/3/index.js ./server/svelte/4/index.js ./server/svelte/5/index.js ./server/app-data/index.js ./server/global-app-data/index.js"
   },
-  "gitHead": "3c3ef92d604eeed89887a94964edf2146e2a746a"
+  "exports": {
+    ".": "./common/index.js",
+    "./client": "./client/index.js",
+    "./client/fetch-json": "./client/fetch-json/index.js",
+    "./client/prevent-default": "./client/prevent-default/index.js",
+    "./client/url-params": "./client/url-params/index.js",
+    "./client/svelte/3": "./client/svelte/3/index.js",
+    "./client/svelte/4": "./client/svelte/4/index.js",
+    "./client/svelte/5": "./client/svelte/5/index.js",
+    "./server": "./server/index.js",
+    "./server/app-data": "./server/app-data/index.js",
+    "./server/global-app-data": "./server/global-app-data/index.js",
+    "./server/svelte/3": "./server/svelte/3/index.js",
+    "./server/svelte/4": "./server/svelte/4/index.js",
+    "./server/svelte/5": "./server/svelte/5/index.js"
+  }
 }

package/server/index.js

@@ -1,5 +1,5 @@
 /* Make native requires work with @sitevision/sitevision-scripts that uses Webpack */
-/* eslint-disable camelcase, no-undef, import/no-dynamic-require, global-require */
+/* eslint-disable camelcase, no-undef */
 /**
  * Require a module natively, bypassing Webpack bundling.
  * This function behaves like CommonJS require() and is used to import
@@ -16,7 +16,7 @@ export function nativeRequire(module) {
   if (typeof __non_webpack_require__ !== 'undefined') return __non_webpack_require__(module);
   return require(module);
 }
-/* eslint-enable camelcase, no-undef, import/no-dynamic-require, global-require */
+/* eslint-enable camelcase, no-undef */
 
 /**
  * @typedef {import('@sitevision/api/types/javax/jcr/Node').Node} Node