@poppinss/utils 7.1.0 → 7.1.1

package/README.md

@@ -556,6 +556,16 @@ const values = ['1_foo_bar', '12_foo_bar'].sort(naturalSort)
 // Default sorting: ['1_foo_bar', '12_foo_bar']
 ```
 
+The default comparator uses the English locale. Use `createNaturalSort` to sort with a different locale.
+
+```ts
+import { createNaturalSort } from '@poppinss/utils'
+
+const naturalSort = createNaturalSort({ locale: 'cs' })
+const values = ['children', 'groups'].sort(naturalSort)
+// ['groups', 'children']
+```
+
 ## getGitWorktree
 
 Returns information about the linked Git worktree containing the current working directory. The method returns `null` when called from the primary worktree, outside a Git repository, or when Git is unavailable.

package/build/index.d.ts

@@ -3,7 +3,7 @@ export { compose } from './src/compose.js';
 export { flatten } from './src/flatten.js';
 export { unique } from './src/unique.js';
 export { safeEqual } from './src/safe_equal.js';
-export { naturalSort } from './src/natural_sort.js';
+export { naturalSort, createNaturalSort } from './src/natural_sort.js';
 export { isScriptFile } from './src/is_script_file.js';
 export { importDefault } from './src/import_default.js';
 export { MessageBuilder } from './src/message_builder.js';

package/build/index.js

@@ -1,5 +1,5 @@
 import { n as safeParse, t as safeStringify } from "./main-B9qlOEvt.js";
-import { n as naturalSort, t as isScriptFile } from "./is_script_file-D0Om5zlQ.js";
+import { n as createNaturalSort, r as naturalSort, t as isScriptFile } from "./is_script_file-DECAVJWd.js";
 import { RuntimeException } from "./modules/exception.js";
 import { flattie } from "flattie";
 import { Buffer } from "node:buffer";
@@ -381,4 +381,4 @@ async function getGitWorktree(cwd = process.cwd()) {
 	}
 }
 //#endregion
-export { ImportsBag, MessageBuilder, Secret, compose, defineStaticProperty, detectAIAgent, flatten, getGitWorktree, importDefault, isRunningInAIAgent, isScriptFile, naturalSort, safeEqual, unique };
+export { ImportsBag, MessageBuilder, Secret, compose, createNaturalSort, defineStaticProperty, detectAIAgent, flatten, getGitWorktree, importDefault, isRunningInAIAgent, isScriptFile, naturalSort, safeEqual, unique };

package/build/{is_script_file-D0Om5zlQ.js → is_script_file-DECAVJWd.js}

@@ -1,16 +1,22 @@
 import { extname } from "node:path";
 //#region src/natural_sort.ts
-let collator;
 /**
-* Perform natural sorting with "Array.sort()" method
+* Create a natural sort comparator for a specific locale
 */
-function naturalSort(current, next) {
-	collator ??= new Intl.Collator(void 0, {
-		numeric: true,
-		sensitivity: "base"
-	});
-	return collator.compare(current, next);
+function createNaturalSort({ locale }) {
+	let collator;
+	return function naturalSort(current, next) {
+		collator ??= new Intl.Collator(locale, {
+			numeric: true,
+			sensitivity: "base"
+		});
+		return collator.compare(current, next);
+	};
 }
+/**
+* Perform natural sorting with "Array.sort()" method
+*/
+const naturalSort = createNaturalSort({ locale: "en" });
 //#endregion
 //#region src/is_script_file.ts
 const JS_MODULES = [
@@ -30,4 +36,4 @@ function isScriptFile(filePath) {
 	return false;
 }
 //#endregion
-export { naturalSort as n, isScriptFile as t };
+export { createNaturalSort as n, naturalSort as r, isScriptFile as t };

package/build/modules/fs/main.js

@@ -1,4 +1,4 @@
-import { n as naturalSort, t as isScriptFile } from "../../is_script_file-D0Om5zlQ.js";
+import { r as naturalSort, t as isScriptFile } from "../../is_script_file-DECAVJWd.js";
 import { extname, join, relative, sep } from "node:path";
 import string from "@poppinss/string";
 import lodash from "@poppinss/utils/lodash";

package/build/src/natural_sort.d.ts

@@ -1,4 +1,10 @@
+/**
+ * Create a natural sort comparator for a specific locale
+ */
+export declare function createNaturalSort({ locale }: {
+    locale: Intl.LocalesArgument;
+}): (current: string, next: string) => number;
 /**
  * Perform natural sorting with "Array.sort()" method
  */
-export declare function naturalSort(current: string, next: string): number;
+export declare const naturalSort: (current: string, next: string) => number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poppinss/utils",
-  "version": "7.1.0",
+  "version": "7.1.1",
   "description": "Handy utilities for repetitive work",
   "main": "build/index.js",
   "type": "module",