@naturalcycles/js-lib 14.275.0 → 14.277.0

package/dist/types.d.ts

@@ -243,6 +243,11 @@ export type NonNegativeNumber = number;
  * data: (number | null)[]
  */
 export type NullableNumber = number | null;
+export type NullablePositiveNumber = number | null;
+export type NullableNonNegativeNumber = number | null;
+export type NullableInteger = number | null;
+export type NullablePositiveInteger = number | null;
+export type NullableNotNegativeInteger = number | null;
 export type NullableString = string | null;
 export type NullableBoolean = boolean | null;
 export type NullableBuffer = Buffer | null;
@@ -259,16 +264,20 @@ export type SemVerString = string;
  * Named type for JSON.parse / JSON.stringify second argument
  */
 export type Reviver = (this: any, key: string, value: any) => any;
+/**
+ * Like _stringMapValues, but values are sorted.
+ */
+export declare function _stringMapValuesSorted<T>(map: StringMap<T>, mapper: Mapper<T, any>, dir?: SortDirection): T[];
 /**
  * Needed due to https://github.com/microsoft/TypeScript/issues/13778
  * Only affects typings, no runtime effect.
  */
-export declare const _stringMapValues: <T>(m: StringMap<T>) => T[];
+export declare const _stringMapValues: <T>(map: StringMap<T>) => T[];
 /**
  * Needed due to https://github.com/microsoft/TypeScript/issues/13778
  * Only affects typings, no runtime effect.
  */
-export declare const _stringMapEntries: <T>(m: StringMap<T>) => [k: string, v: T][];
+export declare const _stringMapEntries: <T>(map: StringMap<T>) => [k: string, v: T][];
 /**
  * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.
  * This is how TypeScript should work, actually.

package/dist/types.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._objectAssign = exports._objectEntries = exports._objectKeys = exports._stringMapEntries = exports._stringMapValues = exports._passNothingPredicate = exports._passthroughPredicate = exports._noop = exports._passUndefinedMapper = exports._passthroughMapper = exports.MISS = exports.SKIP = exports.END = void 0;
+exports._stringMapValuesSorted = _stringMapValuesSorted;
 exports._typeCast = _typeCast;
+const array_util_1 = require("./array/array.util");
 /**
  * Symbol to indicate END of Sequence.
  */
@@ -28,6 +30,12 @@ const _passthroughPredicate = () => true;
 exports._passthroughPredicate = _passthroughPredicate;
 const _passNothingPredicate = () => false;
 exports._passNothingPredicate = _passNothingPredicate;
+/**
+ * Like _stringMapValues, but values are sorted.
+ */
+function _stringMapValuesSorted(map, mapper, dir = 'asc') {
+    return (0, array_util_1._sortBy)((0, exports._stringMapValues)(map), mapper, false, dir);
+}
 /**
  * Needed due to https://github.com/microsoft/TypeScript/issues/13778
  * Only affects typings, no runtime effect.

package/dist-esm/types.js

@@ -1,3 +1,4 @@
+import { _sortBy } from './array/array.util';
 /**
  * Symbol to indicate END of Sequence.
  */
@@ -19,6 +20,12 @@ export const _passUndefinedMapper = () => undefined;
 export const _noop = (..._args) => undefined;
 export const _passthroughPredicate = () => true;
 export const _passNothingPredicate = () => false;
+/**
+ * Like _stringMapValues, but values are sorted.
+ */
+export function _stringMapValuesSorted(map, mapper, dir = 'asc') {
+    return _sortBy(_stringMapValues(map), mapper, false, dir);
+}
 /**
  * Needed due to https://github.com/microsoft/TypeScript/issues/13778
  * Only affects typings, no runtime effect.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.275.0",
+  "version": "14.277.0",
   "scripts": {
     "prepare": "husky",
     "build": "dev-lib build-esm-cjs",
@@ -20,7 +20,7 @@
     "zod": "^3"
   },
   "devDependencies": {
-    "@naturalcycles/bench-lib": "^3",
+    "@naturalcycles/bench-lib": "^4",
     "@naturalcycles/dev-lib": "^17",
     "@naturalcycles/nodejs-lib": "^13",
     "@naturalcycles/time-lib": "^3",

package/src/types.ts

@@ -1,3 +1,4 @@
+import { _sortBy } from './array/array.util'
 import type { Promisable } from './typeFest'
 
 declare const __brand: unique symbol
@@ -306,6 +307,13 @@ export type NonNegativeNumber = number
  * data: (number | null)[]
  */
 export type NullableNumber = number | null
+export type NullablePositiveNumber = number | null
+export type NullableNonNegativeNumber = number | null
+
+export type NullableInteger = number | null
+export type NullablePositiveInteger = number | null
+export type NullableNotNegativeInteger = number | null
+
 export type NullableString = string | null
 export type NullableBoolean = boolean | null
 export type NullableBuffer = Buffer | null
@@ -327,17 +335,28 @@ export type SemVerString = string
  */
 export type Reviver = (this: any, key: string, value: any) => any
 
+/**
+ * Like _stringMapValues, but values are sorted.
+ */
+export function _stringMapValuesSorted<T>(
+  map: StringMap<T>,
+  mapper: Mapper<T, any>,
+  dir: SortDirection = 'asc',
+): T[] {
+  return _sortBy(_stringMapValues(map), mapper, false, dir)
+}
+
 /**
  * Needed due to https://github.com/microsoft/TypeScript/issues/13778
  * Only affects typings, no runtime effect.
  */
-export const _stringMapValues = Object.values as <T>(m: StringMap<T>) => T[]
+export const _stringMapValues = Object.values as <T>(map: StringMap<T>) => T[]
 
 /**
  * Needed due to https://github.com/microsoft/TypeScript/issues/13778
  * Only affects typings, no runtime effect.
  */
-export const _stringMapEntries = Object.entries as <T>(m: StringMap<T>) => [k: string, v: T][]
+export const _stringMapEntries = Object.entries as <T>(map: StringMap<T>) => [k: string, v: T][]
 
 /**
  * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.