@naturalcycles/js-lib 14.276.0 → 15.0.0

package/dist/string/pupa.d.ts

@@ -1,4 +1,4 @@
-import type { AnyObject } from '../types';
+import type { AnyObject } from '../types.js';
 export declare class MissingValueError extends Error {
     key: any;
     constructor(key: any);

package/dist/string/pupa.js

@@ -1,4 +1,3 @@
-"use strict";
 /*
 
 Vendored:
@@ -11,11 +10,8 @@ Reasons:
 2. ESM-only
 
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MissingValueError = void 0;
-exports.pupa = pupa;
-const escape_1 = require("./escape");
-class MissingValueError extends Error {
+import { htmlEscape } from './escape.js';
+export class MissingValueError extends Error {
     key;
     constructor(key) {
         super(`Missing a value for ${key ? `the placeholder: ${key}` : 'a placeholder'}`);
@@ -23,11 +19,10 @@ class MissingValueError extends Error {
         this.name = 'MissingValueError';
     }
 }
-exports.MissingValueError = MissingValueError;
 /**
  * API: https://github.com/sindresorhus/pupa
  */
-function pupa(template, data, opt = {}) {
+export function pupa(template, data, opt = {}) {
     if (typeof template !== 'string') {
         throw new TypeError(`Expected a \`string\` in the first argument, got \`${typeof template}\``);
     }
@@ -49,7 +44,7 @@ function pupa(template, data, opt = {}) {
         }
         return String(transformedValue);
     };
-    const composeHtmlEscape = (replacer) => (...args) => (0, escape_1.htmlEscape)(replacer(...args));
+    const composeHtmlEscape = (replacer) => (...args) => htmlEscape(replacer(...args));
     // The regex tries to match either a number inside `{{ }}` or a valid JS identifier or key path.
     const doubleBraceRegex = /{{(\d+|[a-z$_][\w\-$]*?(?:\.[\w\-$]*?)*?)}}/gi;
     if (doubleBraceRegex.test(template)) {

package/dist/string/readingTime.d.ts

@@ -1,4 +1,4 @@
-import type { Integer } from '../types';
+import type { Integer } from '../types.js';
 export interface ReadingTimeOptions {
     /**
      * A function that returns a boolean value depending on if a character is considered as a word bound.

package/dist/string/readingTime.js

@@ -1,4 +1,3 @@
-"use strict";
 /*
 
 Vendored from https://github.com/ngryman/reading-time
@@ -9,8 +8,6 @@ Reasons:
 2. Streaming mode is not needed (but brings confusion when used in the Browser).
 
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readingTime = readingTime;
 function codeIsInRanges(num, arrayOfRanges) {
     return arrayOfRanges.some(([lowerBound, upperBound]) => lowerBound <= num && num <= upperBound);
 }
@@ -96,7 +93,7 @@ function readingTimeWithCount(words, options = {}) {
 /**
  * API: https://github.com/ngryman/reading-time
  */
-function readingTime(text, options = {}) {
+export function readingTime(text, options = {}) {
     const words = countWords(text, options);
     return {
         ...readingTimeWithCount(words, options),

package/dist/string/regex.js

@@ -1,9 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SIMPLE_EMAIL_REGEX = void 0;
 /**
  * Simple, intentionally not exhaustive regex to match an email address.
  *
  * Source: https://regexr.com/3e48o
  */
-exports.SIMPLE_EMAIL_REGEX = /^[\w-.]+@([\w-]+\.)+[\w-]{2,4}$/;
+export const SIMPLE_EMAIL_REGEX = /^[\w-.]+@([\w-]+\.)+[\w-]{2,4}$/;

package/dist/string/safeJsonStringify.d.ts

@@ -1,4 +1,4 @@
-import type { Reviver } from '../types';
+import type { Reviver } from '../types.js';
 /**
  * JSON.stringify that avoids circular references, prints them as [Circular ~]
  *

package/dist/string/safeJsonStringify.js

@@ -1,12 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._safeJsonStringify = _safeJsonStringify;
 /**
  * JSON.stringify that avoids circular references, prints them as [Circular ~]
  *
  * Based on: https://github.com/moll/json-stringify-safe/
  */
-function _safeJsonStringify(obj, replacer, spaces, cycleReplacer) {
+export function _safeJsonStringify(obj, replacer, spaces, cycleReplacer) {
     try {
         // Try native first (as it's ~3 times faster)
         return JSON.stringify(obj, replacer, spaces);

package/dist/string/slugify.js

@@ -1,8 +1,5 @@
-"use strict";
 // Credit to (adopted from): https://github.com/sindresorhus/slugify/
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._slugify = _slugify;
-function _slugify(s, opt = {}) {
+export function _slugify(s, opt = {}) {
     opt = {
         separator: '-',
         lowercase: true,

package/dist/string/string.util.js

@@ -1,43 +1,26 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._capitalize = _capitalize;
-exports._toUpperCase = _toUpperCase;
-exports._toLowercase = _toLowercase;
-exports._upperFirst = _upperFirst;
-exports._lowerFirst = _lowerFirst;
-exports._split = _split;
-exports._removeWhitespace = _removeWhitespace;
-exports._truncate = _truncate;
-exports._truncateMiddle = _truncateMiddle;
-exports._substringBefore = _substringBefore;
-exports._substringBeforeLast = _substringBeforeLast;
-exports._substringAfter = _substringAfter;
-exports._substringAfterLast = _substringAfterLast;
-exports._substringBetweenLast = _substringBetweenLast;
-exports._nl2br = _nl2br;
 /**
  * Converts the first character of string to upper case and the remaining to lower case.
  * Returns a type-safe capitalized string.
  */
-function _capitalize(s = '') {
+export function _capitalize(s = '') {
     return (s.charAt(0).toUpperCase() + s.slice(1).toLowerCase());
 }
 /**
  * Convert a string to a type-safe uppercase string.
  */
-function _toUpperCase(s) {
+export function _toUpperCase(s) {
     return s.toUpperCase();
 }
 /**
  * Convert a string to a type-safe lowercase string.
  */
-function _toLowercase(s) {
+export function _toLowercase(s) {
     return s.toLowerCase();
 }
-function _upperFirst(s = '') {
+export function _upperFirst(s = '') {
     return (s.charAt(0).toUpperCase() + s.slice(1));
 }
-function _lowerFirst(s) {
+export function _lowerFirst(s) {
     return (s.charAt(0).toLowerCase() + s.slice(1));
 }
 /**
@@ -45,20 +28,20 @@ function _lowerFirst(s) {
  *
  * @return Returns the new array of string segments.
  */
-function _split(str, separator, limit) {
+export function _split(str, separator, limit) {
     const parts = str.split(separator);
     if (parts.length <= limit)
         return parts;
     return [...parts.slice(0, limit - 1), parts.slice(limit - 1).join(separator)];
 }
-function _removeWhitespace(s) {
+export function _removeWhitespace(s) {
     return s.replaceAll(/\s/g, '');
 }
 /**
  * _.truncate('hi-diddly-ho there, neighborino')
  * // => 'hi-diddly-ho there, neighbo...'
  */
-function _truncate(s, maxLen, omission = '...') {
+export function _truncate(s, maxLen, omission = '...') {
     if (!s || s.length <= maxLen)
         return s;
     if (maxLen <= omission.length)
@@ -69,7 +52,7 @@ function _truncate(s, maxLen, omission = '...') {
  * _.truncateMiddle('abcdefghijklmnopqrstuvwxyz', 10)
  * // => 'abcd...xyz'
  */
-function _truncateMiddle(s, maxLen, omission = '...') {
+export function _truncateMiddle(s, maxLen, omission = '...') {
     if (!s || s.length <= maxLen)
         return s;
     if (maxLen <= omission.length)
@@ -79,19 +62,19 @@ function _truncateMiddle(s, maxLen, omission = '...') {
     return s.slice(0, mark1) + omission + s.slice(mark2);
 }
 // These functions are modeled after Kotlin's String API
-function _substringBefore(s, delimiter) {
+export function _substringBefore(s, delimiter) {
     const pos = s.indexOf(delimiter);
     return s.slice(0, pos !== -1 ? pos : undefined);
 }
-function _substringBeforeLast(s, delimiter) {
+export function _substringBeforeLast(s, delimiter) {
     const pos = s.lastIndexOf(delimiter);
     return s.slice(0, pos !== -1 ? pos : undefined);
 }
-function _substringAfter(s, delimiter) {
+export function _substringAfter(s, delimiter) {
     const pos = s.indexOf(delimiter);
     return pos !== -1 ? s.slice(pos + delimiter.length) : s;
 }
-function _substringAfterLast(s, delimiter) {
+export function _substringAfterLast(s, delimiter) {
     const pos = s.lastIndexOf(delimiter);
     return pos !== -1 ? s.slice(pos + delimiter.length) : s;
 }
@@ -104,13 +87,13 @@ function _substringAfterLast(s, delimiter) {
  * _substringBetweenLast(s, '/', '.')
  * // `someFile`
  */
-function _substringBetweenLast(s, leftDelimiter, rightDelimiter) {
+export function _substringBetweenLast(s, leftDelimiter, rightDelimiter) {
     return _substringBefore(_substringAfterLast(s, leftDelimiter), rightDelimiter);
 }
 /**
  * Converts `\n` (aka new-line) to `<br>`, to be presented in HTML.
  * Keeps `\n`, so if it's printed in non-HTML environment it still looks ok-ish.
  */
-function _nl2br(s) {
+export function _nl2br(s) {
     return s.replaceAll('\n', '<br>\n');
 }

package/dist/string/stringify.d.ts

@@ -1,4 +1,4 @@
-import type { Reviver } from '../types';
+import type { Reviver } from '../types.js';
 /**
  * Allows to set Global "stringifyFunction" that will be used to "pretty-print" objects
  * in various cases.

package/dist/string/stringify.js

@@ -1,12 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setGlobalStringifyFunction = setGlobalStringifyFunction;
-exports._stringify = _stringify;
-const error_util_1 = require("../error/error.util");
-const json_util_1 = require("./json.util");
-const safeJsonStringify_1 = require("./safeJsonStringify");
+import { _isBackendErrorResponseObject, _isErrorLike, _isErrorObject } from '../error/error.util.js';
+import { _jsonParseIfPossible } from './json.util.js';
+import { _safeJsonStringify } from './safeJsonStringify.js';
 const supportsAggregateError = typeof globalThis.AggregateError === 'function';
-let globalStringifyFunction = safeJsonStringify_1._safeJsonStringify;
+let globalStringifyFunction = _safeJsonStringify;
 /**
  * Allows to set Global "stringifyFunction" that will be used to "pretty-print" objects
  * in various cases.
@@ -20,7 +16,7 @@ let globalStringifyFunction = safeJsonStringify_1._safeJsonStringify;
  *
  * It's recommended that this function is circular-reference-safe.
  */
-function setGlobalStringifyFunction(fn) {
+export function setGlobalStringifyFunction(fn) {
     globalStringifyFunction = fn;
 }
 /**
@@ -41,7 +37,7 @@ function setGlobalStringifyFunction(fn) {
  * Returns 'empty_string' if empty string is passed.
  * Returns 'undefined' if undefined is passed (default util.inspect behavior).
  */
-function _stringify(obj, opt = {}) {
+export function _stringify(obj, opt = {}) {
     if (obj === undefined)
         return 'undefined';
     if (obj === null)
@@ -52,14 +48,14 @@ function _stringify(obj, opt = {}) {
         return obj.toString();
     let s;
     // Parse JSON string, if possible
-    obj = (0, json_util_1._jsonParseIfPossible)(obj); // in case it's e.g non-pretty JSON, or even a stringified ErrorObject
+    obj = _jsonParseIfPossible(obj); // in case it's e.g non-pretty JSON, or even a stringified ErrorObject
     //
     // HttpErrorResponse
     //
-    if ((0, error_util_1._isBackendErrorResponseObject)(obj)) {
+    if (_isBackendErrorResponseObject(obj)) {
         return _stringify(obj.error, opt);
     }
-    if (obj instanceof Error || (0, error_util_1._isErrorLike)(obj)) {
+    if (obj instanceof Error || _isErrorLike(obj)) {
         const { includeErrorCause = true } = opt;
         //
         // Error or ErrorLike
@@ -78,7 +74,7 @@ function _stringify(obj, opt = {}) {
             // Error that has no `data`, but has `code` property
             s += `\ncode: ${obj.code}`;
         }
-        if (opt.includeErrorData && (0, error_util_1._isErrorObject)(obj) && Object.keys(obj.data).length) {
+        if (opt.includeErrorData && _isErrorObject(obj) && Object.keys(obj.data).length) {
             s += '\n' + _stringify(obj.data, opt);
         }
         if (opt.includeErrorStack && obj.stack) {

package/dist/string/url.util.d.ts

@@ -1,4 +1,4 @@
-import type { StringMap } from '../types';
+import type { StringMap } from '../types.js';
 /**
  * Parses `location.search` string (e.g `?a=1&b=2`) into a StringMap, e.g:
  * `{ a: '1', b: '2' }`

package/dist/string/url.util.js

@@ -1,7 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._parseQueryString = _parseQueryString;
-exports._toUrlOrNull = _toUrlOrNull;
 /**
  * Parses `location.search` string (e.g `?a=1&b=2`) into a StringMap, e.g:
  * `{ a: '1', b: '2' }`
@@ -15,7 +11,7 @@ exports._toUrlOrNull = _toUrlOrNull;
  *
  * Goal of this function is to produce exactly same output as URLSearchParams would.
  */
-function _parseQueryString(search) {
+export function _parseQueryString(search) {
     const qs = {};
     search
         .slice(search.startsWith('?') ? 1 : 0)
@@ -34,7 +30,7 @@ function _parseQueryString(search) {
  *
  * `null` was chosen instead of `undefined` in the return type union to make it easier to move to `URL.parse` if it ever becomes widely supported.
  */
-function _toUrlOrNull(url, base) {
+export function _toUrlOrNull(url, base) {
     if (typeof url !== 'string')
         return null;
     try {

package/dist/time/time.util.d.ts

@@ -1,4 +1,4 @@
-import type { NumberOfMilliseconds, UnixTimestampMillis } from '../types';
+import type { NumberOfMilliseconds, UnixTimestampMillis } from '../types.js';
 /**
  * using _ = blockTimer()
  * // will log "took 1.234 sec" on dispose

package/dist/time/time.util.js

@@ -1,8 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._blockTimer = _blockTimer;
-exports._since = _since;
-exports._ms = _ms;
 /**
  * using _ = blockTimer()
  * // will log "took 1.234 sec" on dispose
@@ -12,7 +7,7 @@ exports._ms = _ms;
  *
  * @experimental
  */
-function _blockTimer(name) {
+export function _blockTimer(name) {
     const started = Date.now();
     return {
         [Symbol.dispose]() {
@@ -23,7 +18,7 @@ function _blockTimer(name) {
 /**
  * Returns time passed since `from` until `until` (default to Date.now())
  */
-function _since(from, until = Date.now()) {
+export function _since(from, until = Date.now()) {
     return _ms(until - from);
 }
 /**
@@ -35,7 +30,7 @@ function _since(from, until = Date.now()) {
  * 59m2s
  * 1h3m12s
  */
-function _ms(millis) {
+export function _ms(millis) {
     // <1 sec
     if (millis < 1000)
         return `${Math.round(millis)} ms`;

package/dist/typeFest.js

@@ -1,3 +1,2 @@
-"use strict";
 /* eslint-disable */
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { Promisable } from './typeFest';
+import type { Promisable } from './typeFest.js';
 declare const __brand: unique symbol;
 interface Brand<B> {
     [__brand]: B;
@@ -264,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,55 +1,53 @@
-"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._typeCast = _typeCast;
+import { _sortBy } from './array/array.util.js';
 /**
  * Symbol to indicate END of Sequence.
  */
-exports.END = Symbol('END');
+export const END = Symbol('END');
 /**
  * Symbol to indicate SKIP of item (e.g in AbortableMapper)
  */
-exports.SKIP = Symbol('SKIP');
+export const SKIP = Symbol('SKIP');
 /**
  * Symbol to indicate cache miss.
  * To distinguish from cache returning `undefined` or `null`.
  */
-exports.MISS = Symbol('MISS');
-const _passthroughMapper = item => item;
-exports._passthroughMapper = _passthroughMapper;
-const _passUndefinedMapper = () => undefined;
-exports._passUndefinedMapper = _passUndefinedMapper;
+export const MISS = Symbol('MISS');
+export const _passthroughMapper = item => item;
+export const _passUndefinedMapper = () => undefined;
 /**
  * Function that does nothings and returns `undefined`.
  */
-const _noop = (..._args) => undefined;
-exports._noop = _noop;
-const _passthroughPredicate = () => true;
-exports._passthroughPredicate = _passthroughPredicate;
-const _passNothingPredicate = () => false;
-exports._passNothingPredicate = _passNothingPredicate;
+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.
  */
-exports._stringMapValues = Object.values;
+export const _stringMapValues = Object.values;
 /**
  * Needed due to https://github.com/microsoft/TypeScript/issues/13778
  * Only affects typings, no runtime effect.
  */
-exports._stringMapEntries = Object.entries;
+export const _stringMapEntries = Object.entries;
 /**
  * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.
  * This is how TypeScript should work, actually.
  */
-exports._objectKeys = Object.keys;
+export const _objectKeys = Object.keys;
 /**
  * Alias of `Object.entries`, but returns better-typed output.
  *
  * So e.g you can use _objectEntries(obj).map([k, v] => {})
  * and `k` will be `keyof obj` instead of generic `string`.
  */
-exports._objectEntries = Object.entries;
+export const _objectEntries = Object.entries;
 /**
  * Utility function that helps to cast *existing variable* to needed type T.
  *
@@ -61,8 +59,8 @@ exports._objectEntries = Object.entries;
  *   err.data = {} // can be done, because it was casted
  * }
  */
-function _typeCast(v) { }
+export function _typeCast(v) { }
 /**
  * Type-safe Object.assign that checks that part is indeed a Partial<T>
  */
-exports._objectAssign = Object.assign;
+export const _objectAssign = Object.assign;

package/dist/unit/size.util.js

@@ -1,23 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._gb = _gb;
-exports._mb = _mb;
-exports._kb = _kb;
-exports._hb = _hb;
-exports._hc = _hc;
-function _gb(b) {
+export function _gb(b) {
     return Math.round(b / 1024 ** 3);
 }
-function _mb(b) {
+export function _mb(b) {
     return Math.round(b / 1024 ** 2);
 }
-function _kb(b) {
+export function _kb(b) {
     return Math.round(b / 1024);
 }
 /**
  * Byte size to Human byte size string
  */
-function _hb(b = 0) {
+export function _hb(b = 0) {
     if (b < 1024)
         return `${Math.round(b)} byte(s)`;
     if (b < 1024 ** 2)
@@ -35,7 +28,7 @@ function _hb(b = 0) {
  * Helpful to print big numbers, as it adds `K` (kilo), `M` (mega), etc to make
  * them more readable.
  */
-function _hc(c = 0) {
+export function _hc(c = 0) {
     if (c < 10 ** 4)
         return String(c);
     if (c < 10 ** 6)

package/dist/web.d.ts

@@ -1,6 +1,6 @@
 /// <reference lib="es2022" preserve="true" />
 /// <reference lib="dom" preserve="true" />
-import type { StringMap } from './types';
+import type { StringMap } from './types.js';
 /**
  * Implements WebStorage API by using in-memory storage.
  * Can be useful in SSR environment or unit tests.

package/dist/web.js

@@ -1,8 +1,5 @@
-"use strict";
 /// <reference lib="es2022" preserve="true" />
 /// <reference lib="dom" preserve="true" />
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InMemoryWebStorage = void 0;
 /**
  * Implements WebStorage API by using in-memory storage.
  * Can be useful in SSR environment or unit tests.
@@ -15,7 +12,7 @@ exports.InMemoryWebStorage = void 0;
  *
  * @experimental
  */
-class InMemoryWebStorage {
+export class InMemoryWebStorage {
     data;
     constructor(data = {}) {
         this.data = data;
@@ -42,4 +39,3 @@ class InMemoryWebStorage {
         return Object.keys(this.data).length;
     }
 }
-exports.InMemoryWebStorage = InMemoryWebStorage;

package/dist/zod/index.d.ts

@@ -1,5 +1,5 @@
-export * from './zod.shared.schemas';
-export * from './zod.util';
+export * from './zod.shared.schemas.js';
+export * from './zod.util.js';
 import type { ZodIssue } from 'zod';
 import { z, ZodError, ZodSchema } from 'zod';
 export { z, ZodError, ZodSchema };

package/dist/zod/index.js

@@ -1,10 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZodSchema = exports.ZodError = exports.z = void 0;
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./zod.shared.schemas"), exports);
-tslib_1.__exportStar(require("./zod.util"), exports);
-const zod_1 = require("zod");
-Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_1.z; } });
-Object.defineProperty(exports, "ZodError", { enumerable: true, get: function () { return zod_1.ZodError; } });
-Object.defineProperty(exports, "ZodSchema", { enumerable: true, get: function () { return zod_1.ZodSchema; } });
+export * from './zod.shared.schemas.js';
+export * from './zod.util.js';
+import { z, ZodError, ZodSchema } from 'zod';
+export { z, ZodError, ZodSchema };