@zajno/common 2.7.6 → 2.7.7

package/types/math/object/types.d.ts

@@ -1,26 +1,26 @@
-import type { AnyObject, DeepReadonly, TypedKeys } from '../../types/index.js';
+import type { AnyObject, DeepReadonly, Nullable, TypedKeys } from '../../types/index.js';
 export type NumKey<T extends AnyObject> = TypedKeys<T, number>;
 export type AbsOptions = false | 'remove' | 'zero';
 export type RoundOptions = 'floor' | 'ceil' | 'round';
 export type DELETE_TYPE = 'delete';
 export interface IObjectOps<T extends AnyObject> {
     readonly Empty: Readonly<T>;
-    isEmpty(o: DeepReadonly<T>): boolean;
+    isEmpty(o: Nullable<DeepReadonly<T>>): boolean;
     getEmpty(): T;
-    clone(o: DeepReadonly<T>): T;
-    isValid(o: DeepReadonly<T>): boolean;
-    isEquals(a: DeepReadonly<T>, b: DeepReadonly<T>): boolean;
-    assign(to: T, other: DeepReadonly<T>): void;
+    clone(o: Nullable<DeepReadonly<T>>): T;
+    isValid(o: Nullable<DeepReadonly<T>>): boolean;
+    isEquals(a: Nullable<DeepReadonly<T>>, b: Nullable<DeepReadonly<T>>): boolean;
+    assign(to: T, other: Nullable<DeepReadonly<T>>): void;
 }
 export interface IObjectMath<T extends AnyObject> extends IObjectOps<T> {
-    contains(base: DeepReadonly<T>, target: DeepReadonly<T>): boolean;
-    inverse(o: DeepReadonly<T>): T;
-    abs(o: DeepReadonly<T>, options?: AbsOptions): T | null;
-    round(o: DeepReadonly<T>, options?: RoundOptions): T | null;
-    add(o1: DeepReadonly<T>, o2: DeepReadonly<T>): T;
-    subtract(base: DeepReadonly<T>, amount: DeepReadonly<T> | number): T;
-    multiply(o1: DeepReadonly<T>, o2: DeepReadonly<T> | number): T;
-    div(o1: DeepReadonly<T>, o2: DeepReadonly<T> | number): number;
+    contains(base: Nullable<DeepReadonly<T>>, target: Nullable<DeepReadonly<T>>): boolean;
+    inverse(o: Nullable<DeepReadonly<T>>): T;
+    abs(o: Nullable<DeepReadonly<T>>, options?: AbsOptions): T | null;
+    round(o: Nullable<DeepReadonly<T>>, options?: RoundOptions): T | null;
+    add(o1: Nullable<DeepReadonly<T>>, o2: Nullable<DeepReadonly<T>>): T;
+    subtract(base: Nullable<DeepReadonly<T>>, amount: Nullable<DeepReadonly<T> | number>): T;
+    multiply(o1: Nullable<DeepReadonly<T>>, o2: Nullable<DeepReadonly<T> | number>): T;
+    div(o1: Nullable<DeepReadonly<T>>, o2: Nullable<DeepReadonly<T> | number>): number;
 }
 export type BasePair<T extends AnyObject, TKey extends string & keyof T = string & keyof T, TOps extends IObjectOps<T[TKey]> = IObjectOps<T[TKey]>> = {
     key: TKey;

package/types/models/LogicModel.d.ts

@@ -5,7 +5,7 @@ import { Loggable } from '../logger/loggable.js';
 export type ActionRunOptions = {
     /** Action name, required for logging and joining. */
     name?: string;
-    /** If set to truthy, will not start an action if another is still in progress.
+    /** If set to truthy, will not start this action if another is still in progress.
      * Additionally, if set to 'throw', will throw an error. Otherwise, will return undefined.
      *
      * Note: if a current action runs in an exclusive mode, but the next one is not, the next one will still be allowed.

package/types/structures/path/index.d.ts

@@ -1,2 +1,2 @@
-export * from './utils.js';
+export * from './utils/index.js';
 export * as Path from './builder.js';

package/types/structures/path/types.d.ts

@@ -1,6 +1,6 @@
 import type { EmptyObject, Expand, IsNever, LengthArray, Nullable } from '../../types/misc.js';
 import type { ArgValue, IsOptional, ReadonlyArrayNormalized, TemplateTransform, ToOptionalArray, ToRequired, ToRequiredArray, TransformMap } from './types.helpers.js';
-import type { CombineOptions } from './utils.js';
+import type { CombineOptions } from './utils/combineUrls.js';
 export type ObjectBuilderArgs<TArgs extends string, TFallback = EmptyObject> = string extends TArgs ? TFallback : ArgRecord<TArgs>;
 export type BuilderArgs<TArgs extends string, L extends number = number> = LengthArray<ArgValue | null, L> | ArgRecord<TArgs>;
 export type ArgRecord<T extends string> = Expand<{

package/types/structures/path/{utils.d.ts → utils/combineUrls.d.ts}

@@ -1,5 +1,4 @@
-import type { Nullable } from '../../types/misc.js';
-export declare function indexTrim(str: string | null | undefined, ch: string): string;
+import type { Nullable } from '../../../types/misc.js';
 export type CombineOptions = {
     noTrim?: boolean;
     addTrail?: boolean | string;

package/types/structures/path/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './indexTrim.js';
+export * from './combineUrls.js';
+export * from './optionals.js';

package/types/structures/path/utils/indexTrim.d.ts

@@ -0,0 +1 @@
+export declare function indexTrim(str: string | null | undefined, ch: string): string;

package/types/structures/path/utils/optionals.d.ts

@@ -0,0 +1,2 @@
+/** Reformats path from format `'/foo/bar?'` to `'/foo{/bar}'`, according to the latest `path-to-regex` lib rules */
+export declare function replaceOptionalParts(pathname: string): string;

package/types/types/misc.d.ts

@@ -1,11 +1,11 @@
 export type Predicate<T> = (value: T) => boolean;
 /** Type for extracting only string keys from T (skips number & symbol keys) */
-export type StringKeys<T extends AnyObject> = {
+export type StringKeys<T extends AnyObject> = Exclude<{
     [K in keyof T]: K extends string ? K : never;
-}[keyof T];
+}[keyof T], undefined | null>;
 /** Type for extracting string keys of type `T` values of each are of certain type `K` */
 export type TypedKeys<T extends AnyObject, K> = {
-    [P in StringKeys<T>]: T[P] extends K ? P : never;
+    [P in StringKeys<T>]: T[P] extends (K | undefined) ? P : never;
 }[StringKeys<T>];
 /** Type for extraction only keys, values of which are functions with certain args and return result */
 export type FunctionKeys<T extends AnyObject, TArgs extends any[] = any[], TRes = any> = TypedKeys<T, (...args: TArgs) => TRes>;

package/cjs/structures/path/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/structures/path/utils.ts"],"names":[],"mappings":"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"}

package/esm/structures/path/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/structures/path/utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,GAA8B,EAAE,EAAU;IAChE,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACd,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IAEhC,OAAO,KAAK,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE;QACnC,EAAE,KAAK,CAAC;IAEZ,OAAO,GAAG,GAAG,KAAK,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE;QACrC,EAAE,GAAG,CAAC;IAEV,OAAO,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;QAClC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC;QAC3B,CAAC,CAAC,GAAG,CAAC;AACd,CAAC;AAWD,MAAM,KAAW,cAAc,CAI9B;AAJD,WAAiB,cAAc;IAC3B,SAAgB,KAAK,CAAC,GAAG,OAAmC;QACxD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;IACzC,CAAC;IAFe,oBAAK,QAEpB,CAAA;AACL,CAAC,EAJgB,cAAc,KAAd,cAAc,QAI9B;AAKD,MAAM,UAAU,WAAW,CAAC,GAAG,KAA0C;IACrE,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ;QACxC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,KAAK,CAAC,CAAC,CAA6B,CAAC;IAE3C,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,GAAG,CAAC;IAC5C,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,GAAG,CAAC;IAE9C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC;IACxC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACpB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YACxB,SAAS;QACb,CAAC;QAED,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,IAAI,GAAG,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;IAED,IAAI,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEpC,oFAAoF;IACpF,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,IAAI,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC,EAAE,CAAC;QACxE,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;YAC7C,CAAC,CAAC,OAAO,CAAC,QAAQ;YAClB,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,IAAI,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;YAC7C,CAAC,CAAC,OAAO,CAAC,QAAQ;YAClB,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}