@naturalcycles/js-lib 15.1.0 → 15.3.0

package/dist/browser/analytics.util.js

@@ -10,7 +10,7 @@ export async function loadGTag(gtagId, enabled = true) {
     window.dataLayer ||= [];
     window.gtag ||= function gtag() {
         // biome-ignore lint/complexity/useArrowFunction: ok
-        // biome-ignore lint/style/noArguments: ok
+        // biome-ignore lint/complexity/noArguments: ok
         window.dataLayer.push(arguments);
     };
     window.gtag('js', new Date());
@@ -39,7 +39,7 @@ export function loadHotjar(hjid) {
         h.hj =
             h.hj ||
                 function hj() {
-                    // biome-ignore lint/style/noArguments: ok
+                    // biome-ignore lint/complexity/noArguments: ok
                     ;
                     (h.hj.q = h.hj.q || []).push(arguments);
                 };

package/dist/decorators/logMethod.decorator.js

@@ -16,7 +16,7 @@ import { _getArgsSignature, _getMethodSignature } from './decorator.util.js';
  */
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export function _LogMethod(opt = {}) {
-    return (target, key, descriptor) => {
+    return (_target, key, descriptor) => {
         _assert(typeof descriptor.value === 'function', '@_LogMethod can be applied only to methods');
         const originalFn = descriptor.value;
         const keyStr = String(key);

package/dist/decorators/timeout.decorator.js

@@ -3,7 +3,7 @@ import { pTimeout } from '../promise/pTimeout.js';
 import { _getMethodSignature } from './decorator.util.js';
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export function _Timeout(opt) {
-    return (target, key, descriptor) => {
+    return (_target, key, descriptor) => {
         _assert(typeof descriptor.value === 'function', '@_Timeout can be applied only to methods');
         if (!opt.timeout)
             return descriptor;

package/dist/error/assert.js

@@ -93,7 +93,6 @@ export function _assertIsNumber(v, message) {
     _assertTypeOf(v, 'number', message);
 }
 export function _assertTypeOf(v, expectedType, message) {
-    // biome-ignore lint/suspicious/useValidTypeof: ok
     if (typeof v !== expectedType) {
         const msg = message || `Expected typeof ${expectedType}, actual typeof: ${typeof v}`;
         throw new AssertionError(msg);

package/dist/error/error.util.js

@@ -264,6 +264,9 @@ export class AppError extends Error {
                 enumerable: true, // unlike standard - setting it to true for "visibility"
             });
         }
+        else {
+            delete this.cause; // otherwise it's printed as `cause: undefined`
+        }
         // this is to allow changing this.constuctor.name to a non-minified version
         Object.defineProperty(this.constructor, 'name', {
             value: name,

package/dist/string/slugify.js

@@ -17,7 +17,6 @@ export function _slugify(s, opt = {}) {
     // based on https://stackoverflow.com/a/23633850/4919972
     // Combining Diacritical Marks
     // https://www.unicode.org/charts/PDF/U0300.pdf
-    // biome-ignore lint/suspicious/noMisleadingCharacterClass: ok
     s = s.normalize('NFKD').replaceAll(/[\u0300-\u036F]/g, '');
     // Detect contractions/possessives by looking for any word followed by a `'t`
     // or `'s` in isolation and then remove it.

package/dist/types.d.ts

@@ -233,6 +233,12 @@ export type PositiveInteger = number;
 export type NonNegativeInteger = number;
 export type PositiveNumber = number;
 export type NonNegativeNumber = number;
+/**
+ * Same as `number`, but with semantic meaning that it's a Float.
+ */
+export type Float = number;
+export type PositiveFloat = number;
+export type NonNegativeFloat = number;
 /**
  * Convenience type alias, that allows to write this:
  *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.1.0",
+  "version": "15.3.0",
   "dependencies": {
     "tslib": "^2",
     "zod": "^3"
@@ -9,11 +9,16 @@
   "devDependencies": {
     "@naturalcycles/dev-lib": "*",
     "@types/crypto-js": "^4",
-    "@types/node": "^22",
+    "@types/node": "^24",
     "@types/semver": "^7",
     "crypto-js": "^4",
     "dayjs": "^1"
   },
+  "exports": {
+    "./cfg/frontend/tsconfig.json": "./cfg/frontend/tsconfig.json",
+    ".": "./dist/index.js",
+    "./zod": "./dist/zod/index.js"
+  },
   "files": [
     "dist",
     "cfg",
@@ -51,8 +56,9 @@
     "test": "dev-lib test",
     "lint": "dev-lib lint",
     "bt": "dev-lib bt",
-    "lbt": "dev-lib lbt",
-    "check": "dev-lib lbt",
+    "typecheck": "dev-lib typecheck",
+    "check": "dev-lib check",
+    "clean": "dev-lib clean",
     "test-tz1": "TZ=Europe/Stockholm yarn test local",
     "test-tz2": "TZ=JST-9 yarn test local",
     "test-ny": "TZ=GMT-0500 yarn test localTime"

package/readme.md

@@ -10,7 +10,7 @@
 [![Test Coverage](https://api.codeclimate.com/v1/badges/c2dc8d53bd79f79b1d8b/test_coverage)](https://codeclimate.com/github/NaturalCycles/js-lib/test_coverage)
 [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
 
-# [Documentation](https://naturalcycles.github.io/js-lib/)
+# [Documentation](https://naturalcycles.github.io/js-libs/)
 
 # Packaging
 

package/src/browser/analytics.util.ts

@@ -19,7 +19,7 @@ export async function loadGTag(gtagId: string, enabled = true): Promise<void> {
   window.dataLayer ||= []
   window.gtag ||= function gtag() {
     // biome-ignore lint/complexity/useArrowFunction: ok
-    // biome-ignore lint/style/noArguments: ok
+    // biome-ignore lint/complexity/noArguments: ok
     window.dataLayer.push(arguments)
   }
   window.gtag('js', new Date())
@@ -54,7 +54,7 @@ export function loadHotjar(hjid: number): void {
     h.hj =
       h.hj ||
       function hj() {
-        // biome-ignore lint/style/noArguments: ok
+        // biome-ignore lint/complexity/noArguments: ok
         ;(h.hj.q = h.hj.q || []).push(arguments)
       }
     h._hjSettings = { hjid, hjsv: 6 }

package/src/decorators/logMethod.decorator.ts

@@ -71,7 +71,7 @@ export interface LogMethodOptions {
  */
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export function _LogMethod(opt: LogMethodOptions = {}): MethodDecorator {
-  return (target, key, descriptor) => {
+  return (_target, key, descriptor) => {
     _assert(typeof descriptor.value === 'function', '@_LogMethod can be applied only to methods')
 
     const originalFn = descriptor.value
@@ -97,7 +97,7 @@ export function _LogMethod(opt: LogMethodOptions = {}): MethodDecorator {
     const sma = avg ? new SimpleMovingAverage(avg) : undefined
     let count = 0
 
-    descriptor.value = function (this: typeof target, ...args: any[]) {
+    descriptor.value = function (this: typeof _target, ...args: any[]) {
       const started = Date.now()
       const ctx = this
 

package/src/decorators/timeout.decorator.ts

@@ -5,7 +5,7 @@ import { _getMethodSignature } from './decorator.util.js'
 
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export function _Timeout(opt: PTimeoutOptions): MethodDecorator {
-  return (target, key, descriptor) => {
+  return (_target, key, descriptor) => {
     _assert(typeof descriptor.value === 'function', '@_Timeout can be applied only to methods')
 
     if (!opt.timeout) return descriptor
@@ -13,7 +13,7 @@ export function _Timeout(opt: PTimeoutOptions): MethodDecorator {
     const originalFn = descriptor.value
     const keyStr = String(key)
 
-    descriptor.value = async function (this: typeof target, ...args: any[]) {
+    descriptor.value = async function (this: typeof _target, ...args: any[]) {
       const ctx = this
       opt.name ||= _getMethodSignature(ctx, keyStr)
       return await pTimeout(() => originalFn.apply(this, args), opt)

package/src/error/assert.ts

@@ -137,7 +137,6 @@ export function _assertIsNumber(v: any, message?: string): asserts v is number {
 }
 
 export function _assertTypeOf<T>(v: any, expectedType: string, message?: string): asserts v is T {
-  // biome-ignore lint/suspicious/useValidTypeof: ok
   if (typeof v !== expectedType) {
     const msg = message || `Expected typeof ${expectedType}, actual typeof: ${typeof v}`
     throw new AssertionError(msg)

package/src/error/error.util.ts

@@ -351,6 +351,8 @@ export class AppError<DATA_TYPE extends ErrorData = ErrorData> extends Error {
         configurable: true,
         enumerable: true, // unlike standard - setting it to true for "visibility"
       })
+    } else {
+      delete this.cause // otherwise it's printed as `cause: undefined`
     }
 
     // this is to allow changing this.constuctor.name to a non-minified version

package/src/string/slugify.ts

@@ -41,7 +41,6 @@ export function _slugify(s: string, opt: SlugifyOptions = {}): string {
   // based on https://stackoverflow.com/a/23633850/4919972
   // Combining Diacritical Marks
   // https://www.unicode.org/charts/PDF/U0300.pdf
-  // biome-ignore lint/suspicious/noMisleadingCharacterClass: ok
   s = s.normalize('NFKD').replaceAll(/[\u0300-\u036F]/g, '')
 
   // Detect contractions/possessives by looking for any word followed by a `'t`

package/src/types.ts

@@ -297,6 +297,13 @@ export type NonNegativeInteger = number
 export type PositiveNumber = number
 export type NonNegativeNumber = number
 
+/**
+ * Same as `number`, but with semantic meaning that it's a Float.
+ */
+export type Float = number
+export type PositiveFloat = number
+export type NonNegativeFloat = number
+
 /**
  * Convenience type alias, that allows to write this:
  *