@koine/utils 2.0.0-beta.15 → 2.0.0-beta.151

package/titleCase.d.ts

@@ -1,2 +1,7 @@
-export declare const titleCase: (input?: null | string) => string;
+/**
+ * @category text
+ *
+ * @borrows [blakeembrey/change-case](https://github.com/blakeembrey/change-case/blob/master/packages/title-case/src/index.ts)
+ */
+export declare let titleCase: (input?: null | string) => string;
 export default titleCase;

package/titleCase.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./titleCase";
+export { default } from "./titleCase";

package/titleCase.esm.js

@@ -0,0 +1,3 @@
+let titleCase=e=>e?e.replace(/\w\S*/g,e=>e.charAt(0).toUpperCase()+e.substring(1).toLowerCase()):"";
+
+export { titleCase as default, titleCase };

package/toNumber.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./toNumber";
+export { default } from "./toNumber";

package/toNumber.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./toNumber.cjs.js').default;

package/toNumber.cjs.js

@@ -0,0 +1,10 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var isNumber = require('./isNumber.cjs.js');
+
+let toNumber=(r,t)=>isNumber.isNumber(r)?r:r?parseFloat(r):t||0;
+
+exports.default = toNumber;
+exports.toNumber = toNumber;

package/toNumber.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './toNumber.cjs.js';
+export { _default as default } from './toNumber.cjs.default.js';

package/toNumber.d.ts

@@ -1,2 +1,7 @@
-export declare function toNumber(input?: string | number, fallback?: number): number;
+/**
+ * @category cast
+ *
+ * @param fallback Defaults to `0`
+ */
+export declare let toNumber: (input?: string | number, fallback?: number) => number;
 export default toNumber;

package/toNumber.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./toNumber";
+export { default } from "./toNumber";

package/toNumber.esm.js

@@ -0,0 +1,5 @@
+import { isNumber } from './isNumber.esm.js';
+
+let toNumber=(r,t)=>isNumber(r)?r:r?parseFloat(r):t||0;
+
+export { toNumber as default, toNumber };

package/toRgba.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./toRgba";
+export { default } from "./toRgba";

package/toRgba.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./toRgba.cjs.js').default;

package/toRgba.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let toRgba=(e,t=1)=>{let a=/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);return a?`rgba(${parseInt(a[1],16)},${parseInt(a[2],16)},${parseInt(a[3],16)},${t})`:""};
+
+exports.default = toRgba;
+exports.toRgba = toRgba;

package/toRgba.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './toRgba.cjs.js';
+export { _default as default } from './toRgba.cjs.default.js';

package/toRgba.d.ts

@@ -1,2 +1,7 @@
-export declare function toRgba(hex: string, alpha?: number): string;
+/**
+ * @category colors
+ *
+ * @see `hex-rgb` package
+ */
+export declare let toRgba: (hex: string, alpha?: number) => string;
 export default toRgba;

package/toRgba.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./toRgba";
+export { default } from "./toRgba";

package/toRgba.esm.js

@@ -0,0 +1,3 @@
+let toRgba=(e,t=1)=>{let a=/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(e);return a?`rgba(${parseInt(a[1],16)},${parseInt(a[2],16)},${parseInt(a[3],16)},${t})`:""};
+
+export { toRgba as default, toRgba };

package/transformToUrlPathname.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./transformToUrlPathname";
+export { default } from "./transformToUrlPathname";

package/transformToUrlPathname.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./transformToUrlPathname.cjs.js').default;

package/transformToUrlPathname.cjs.js

@@ -0,0 +1,10 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var isString = require('./isString.cjs.js');
+
+let transformToUrlPathname=o=>isString.isString(o)?`/${encodeURIComponent(o.replace(/\s/g,"-").toLowerCase())}`:"";
+
+exports.default = transformToUrlPathname;
+exports.transformToUrlPathname = transformToUrlPathname;

package/transformToUrlPathname.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './transformToUrlPathname.cjs.js';
+export { _default as default } from './transformToUrlPathname.cjs.default.js';

package/transformToUrlPathname.d.ts

@@ -1,2 +1,11 @@
-export declare function transformToUrlPathname(toPathname?: string): string;
+/**
+ * Transform string in a URL pathname (relative URL)
+ *
+ * - adds an initial slash
+ * - encode the string
+ * - replaces whitespaces with dashes
+ *
+ * @category location
+ */
+export declare let transformToUrlPathname: (toPathname?: string) => string;
 export default transformToUrlPathname;

package/transformToUrlPathname.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./transformToUrlPathname";
+export { default } from "./transformToUrlPathname";

package/transformToUrlPathname.esm.js

@@ -0,0 +1,5 @@
+import { isString } from './isString.esm.js';
+
+let transformToUrlPathname=o=>isString(o)?`/${encodeURIComponent(o.replace(/\s/g,"-").toLowerCase())}`:"";
+
+export { transformToUrlPathname as default, transformToUrlPathname };

package/truncate.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./truncate";
+export { default } from "./truncate";

package/truncate.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./truncate.cjs.js').default;

package/truncate.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let truncate=(t,e)=>t?t.length>e?t.substring(0,e)+"...":t:"";
+
+exports.default = truncate;
+exports.truncate = truncate;

package/truncate.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './truncate.cjs.js';
+export { _default as default } from './truncate.cjs.default.js';

package/truncate.d.ts

@@ -1,2 +1,7 @@
-export declare const truncate: (input: undefined | null | string, length: number) => string;
+/**
+ * Truncate string
+ *
+ * @category text
+ */
+export declare let truncate: (input: undefined | null | string, length: number) => string;
 export default truncate;

package/truncate.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./truncate";
+export { default } from "./truncate";

package/truncate.esm.js

@@ -0,0 +1,3 @@
+let truncate=(t,e)=>t?t.length>e?t.substring(0,e)+"...":t:"";
+
+export { truncate as default, truncate };

package/tryUntil.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./tryUntil";
+export { default } from "./tryUntil";

package/tryUntil.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./tryUntil.cjs.js').default;

package/tryUntil.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let tryUntil=(t,e,l,n,r)=>{let a=new Date,c=setInterval(function(){t()?(clearInterval(c),n()):new Date-a>e&&(clearInterval(c),r&&r());},l);};
+
+exports.default = tryUntil;
+exports.tryUntil = tryUntil;

package/tryUntil.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './tryUntil.cjs.js';
+export { _default as default } from './tryUntil.cjs.default.js';

package/tryUntil.d.ts

@@ -1,2 +1,11 @@
-export declare const tryUntil: (test: () => boolean, timeout: number, interval: number, resolve: () => void, reject?: () => void) => void;
+/**
+ * @category function
+ * @category async
+ *
+ * @borrows [Javascript: Wait Until Something Happens or Timeout](https://levelup.gitconnected.com/javascript-wait-until-something-happens-or-timeout-82636839ea93)
+ *
+ * @param timeout in `ms`
+ * @param interval in `ms`
+ */
+export declare let tryUntil: (test: () => boolean, timeout: number, interval: number, resolve: () => void, reject?: () => void) => void;
 export default tryUntil;

package/tryUntil.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./tryUntil";
+export { default } from "./tryUntil";

package/tryUntil.esm.js

@@ -0,0 +1,3 @@
+let tryUntil=(t,e,l,n,r)=>{let a=new Date,c=setInterval(function(){t()?(clearInterval(c),n()):new Date-a>e&&(clearInterval(c),r&&r());},l);};
+
+export { tryUntil as default, tryUntil };

package/types.cjs.d.ts

@@ -0,0 +1 @@
+export * from "./types";

package/types.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./types.cjs.js').default;

package/types.cjs.js

@@ -0,0 +1,2 @@
+'use strict';
+

package/types.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './types.cjs.js';
+export { _default as default } from './types.cjs.default.js';

package/types.d.ts

@@ -1,10 +1,58 @@
 import type { Replace } from "type-fest";
+/**
+ * Type to test types
+ *
+ * @example
+ *
+ * ```ts
+ * type _Test = TestType<
+ *   A extends B ? true : false,
+ *   A & { intruder: 1 } extends B ? false : true
+ * >;
+ * // or, if you want to skip the wrong implementation test, simply
+ * type _Test = TestType<A extends B ? true : false>;
+ * ```
+ */
+export type TestType<RightImplementation extends true, WrongImplementation extends true = true> = RightImplementation | WrongImplementation;
+/**
+ * Whatever that in javascript returns `false` when checked in an `if` condition
+ */
 export type AnythingFalsy = null | undefined | 0 | "";
+/**
+ * Flatten an object bringing the first depth-level of properties to the object
+ * root.
+ *
+ * @borrows [SO' answer by jcalz](https://stackoverflow.com/a/78779784/1938970)
+ */
+export type FlatObjectFirstLevel<T extends object> = {
+    [K in keyof T]: (x: T[K]) => void;
+} extends Record<keyof T, (x: infer I) => void> ? {
+    [K in keyof I]: I[K];
+} : never;
+/**
+ * Pick the keys of an object `T` that starts with `S`. It produces a mapped type
+ * with a subset of `T` whose keys start with `S`.
+ */
 export type PickStartsWith<T extends object, S extends string> = {
     [K in keyof T as K extends `${S}${string}` ? K : never]: T[K];
 };
+/**
+ * Returns a union of all the keys of an object `T` which starts with `S`.
+ */
 export type KeysStartsWith<T extends object, S extends string> = keyof PickStartsWith<T, S>;
+/**
+ * Pick the keys of an object `T` that starts with `S`. It produces a mapped type
+ * with a subset of `T` whose keys start with `S` *and have `S`* removed.
+ */
 export type PickStartsWithTails<T extends object, S extends string> = {
     [K in keyof T as K extends `${S}${string}` ? Replace<K, S, ""> : never]: T[K];
 };
+/**
+ * Returns a union of all the keys of an object `T` which starts with `S`.
+ * The strings in the produced union *have `S` removed*.
+ */
 export type KeysTailsStartsWith<T extends object, S extends string> = keyof PickStartsWithTails<T, S>;
+/**
+ * @borrows [SO's answer by 钵钵鸡实力代购](https://stackoverflow.com/a/64994122/1938970)
+ */
+export type Reverse<Tuple> = Tuple extends [infer Head, ...infer Rest] ? [...Reverse<Rest>, Head] : [];

package/types.esm.d.ts

@@ -0,0 +1 @@
+export * from "./types";

package/types.esm.js

@@ -0,0 +1 @@
+

package/typings.d.ts

@@ -2,3 +2,36 @@
  * List here the global variables used by third party scripts supported within
  * the `koine` ecosystem.
  */
+
+declare type AssertTrue<T extends true> = T;
+
+// as in type-fest start
+declare type Simplify<T> = { [KeyType in keyof T]: T[KeyType] };
+// as in type-fest end
+
+/**
+ * Tweak a model by making some properties required (not `optional` and not `nullable`)
+ *
+ * This is useful to tweak/correct the types generated from Swagger.
+ */
+declare type Tweak<
+  TModel extends object,
+  TRequiredKeys extends keyof TModel | never,
+  TReplacements extends Partial<Record<keyof TModel, unknown>> | false = false,
+> = TReplacements extends false
+  ? Simplify<
+      Omit<TModel, TRequiredKeys> &
+        Required<{
+          [K in TRequiredKeys]: NonNullable<TModel[K]>;
+        }>
+    >
+  : Simplify<
+      Omit<
+        Omit<TModel, TRequiredKeys> &
+          Required<{
+            [K in TRequiredKeys]: NonNullable<TModel[K]>;
+          }>,
+        keyof TReplacements
+      > &
+        TReplacements
+    >;

package/uid.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./uid";
+export { default } from "./uid";

package/uid.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./uid.cjs.js').default;

package/uid.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let e=0;let uid=(t="id")=>(e++,`${t}-${e}`);
+
+exports.default = uid;
+exports.uid = uid;

package/uid.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './uid.cjs.js';
+export { _default as default } from './uid.cjs.default.js';

package/uid.d.ts

@@ -1,2 +1,7 @@
-export declare const uid: (prefix?: string) => string;
+/**
+ * Super basic UID increment-based generator
+ *
+ * @category uid
+ */
+export declare let uid: (prefix?: string) => string;
 export default uid;

package/uid.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./uid";
+export { default } from "./uid";

package/uid.esm.js

@@ -0,0 +1,3 @@
+let e=0;let uid=(t="id")=>(e++,`${t}-${e}`);
+
+export { uid as default, uid };

package/updateLinkParams.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./updateLinkParams";
+export { default } from "./updateLinkParams";

package/updateLinkParams.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./updateLinkParams.cjs.js').default;

package/updateLinkParams.cjs.js

@@ -0,0 +1,10 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var updateUrlQueryParams = require('./updateUrlQueryParams.cjs.js');
+
+let updateLinkParams=(e,a)=>{let t=updateUrlQueryParams.updateUrlQueryParams(e.href,a);return e.href=t,t};
+
+exports.default = updateLinkParams;
+exports.updateLinkParams = updateLinkParams;

package/updateLinkParams.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './updateLinkParams.cjs.js';
+export { _default as default } from './updateLinkParams.cjs.default.js';

package/updateLinkParams.d.ts

@@ -1,3 +1,10 @@
-import { type AnyQueryParams } from "./location.js";
-export declare function updateLinkParams($anchor: HTMLAnchorElement, newParams: NonNullable<AnyQueryParams>): string;
+import type { AnyQueryParams } from "./location";
+/**
+ * Update link `<a href="">` merging the given new query parameters.
+ * it returns the newly created `href` URL value
+ *
+ * @category location
+ * @pure
+ */
+export declare let updateLinkParams: ($anchor: HTMLAnchorElement, newParams: NonNullable<AnyQueryParams>) => string;
 export default updateLinkParams;

package/updateLinkParams.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./updateLinkParams";
+export { default } from "./updateLinkParams";

package/updateLinkParams.esm.js

@@ -0,0 +1,5 @@
+import { updateUrlQueryParams } from './updateUrlQueryParams.esm.js';
+
+let updateLinkParams=(e,a)=>{let t=updateUrlQueryParams(e.href,a);return e.href=t,t};
+
+export { updateLinkParams as default, updateLinkParams };

package/updateUrlQueryParams.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./updateUrlQueryParams";
+export { default } from "./updateUrlQueryParams";

package/updateUrlQueryParams.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./updateUrlQueryParams.cjs.js').default;

package/updateUrlQueryParams.cjs.js

@@ -0,0 +1,12 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var buildUrlQueryString = require('./buildUrlQueryString.cjs.js');
+var getUrlQueryParams = require('./getUrlQueryParams.cjs.js');
+var mergeUrlQueryParams = require('./mergeUrlQueryParams.cjs.js');
+
+let updateUrlQueryParams=(a,m={})=>{let l=a.split("?"),u=l[1]?mergeUrlQueryParams.mergeUrlQueryParams(getUrlQueryParams.getUrlQueryParams(a),m):m;return l[0]+buildUrlQueryString.buildUrlQueryString(u)};
+
+exports.default = updateUrlQueryParams;
+exports.updateUrlQueryParams = updateUrlQueryParams;

package/updateUrlQueryParams.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './updateUrlQueryParams.cjs.js';
+export { _default as default } from './updateUrlQueryParams.cjs.default.js';

package/updateUrlQueryParams.d.ts

@@ -1,3 +1,8 @@
-import { type AnyQueryParams } from "./location.js";
-export declare function updateUrlQueryParams(url: string, newParams?: NonNullable<AnyQueryParams>): string;
+import type { AnyQueryParams } from "./location";
+/**
+ * Update a URL string query parameters merging the given new query parameters
+ *
+ * @category location
+ */
+export declare let updateUrlQueryParams: (url: string, newParams?: NonNullable<AnyQueryParams>) => string;
 export default updateUrlQueryParams;

package/updateUrlQueryParams.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./updateUrlQueryParams";
+export { default } from "./updateUrlQueryParams";

package/updateUrlQueryParams.esm.js

@@ -0,0 +1,7 @@
+import { buildUrlQueryString } from './buildUrlQueryString.esm.js';
+import { getUrlQueryParams } from './getUrlQueryParams.esm.js';
+import { mergeUrlQueryParams } from './mergeUrlQueryParams.esm.js';
+
+let updateUrlQueryParams=(a,m={})=>{let l=a.split("?"),u=l[1]?mergeUrlQueryParams(getUrlQueryParams(a),m):m;return l[0]+buildUrlQueryString(u)};
+
+export { updateUrlQueryParams as default, updateUrlQueryParams };

package/uppercase.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./uppercase";
+export { default } from "./uppercase";

package/uppercase.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./uppercase.cjs.js').default;

package/uppercase.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let uppercase=e=>(e||"").toUpperCase();
+
+exports.default = uppercase;
+exports.uppercase = uppercase;

package/uppercase.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './uppercase.cjs.js';
+export { _default as default } from './uppercase.cjs.default.js';

package/uppercase.d.ts

@@ -1,2 +1,8 @@
-export declare const uppercase: <T extends string>(str?: T | null | undefined) => Uppercase<T>;
+/**
+ * Replacement for native `toUpperCase` tyescript ready (type narrowing ready)
+ *
+ * @category native
+ * @category text
+ */
+export declare let uppercase: <T extends string>(str?: null | T) => Uppercase<T>;
 export default uppercase;

package/uppercase.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./uppercase";
+export { default } from "./uppercase";

package/uppercase.esm.js

@@ -0,0 +1,3 @@
+let uppercase=e=>(e||"").toUpperCase();
+
+export { uppercase as default, uppercase };

package/uuid.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./uuid";
+export { default } from "./uuid";

package/uuid.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./uuid.cjs.js').default;

package/uuid.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let uuid=()=>"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,x=>{let t=16*Math.random()|0;return ("x"==x?t:3&t|8).toString(16)});
+
+exports.default = uuid;
+exports.uuid = uuid;

package/uuid.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './uuid.cjs.js';
+export { _default as default } from './uuid.cjs.default.js';

package/uuid.d.ts

@@ -1,2 +1,8 @@
-export declare const uuid: () => string;
+/**
+ * Uuid, tiny custom helper instead of node's uuid/v4
+ *
+ * @category uid
+ * @see https://stackoverflow.com/a/2117523/1938970
+ */
+export declare let uuid: () => string;
 export default uuid;

package/uuid.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./uuid";
+export { default } from "./uuid";

package/uuid.esm.js

@@ -0,0 +1,3 @@
+let uuid=()=>"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,x=>{let t=16*Math.random()|0;return ("x"==x?t:3&t|8).toString(16)});
+
+export { uuid as default, uuid };

package/uuidNumeric.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./uuidNumeric";
+export { default } from "./uuidNumeric";

package/uuidNumeric.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./uuidNumeric.cjs.js').default;

package/uuidNumeric.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+let uuidNumeric=()=>new Date().valueOf();
+
+exports.default = uuidNumeric;
+exports.uuidNumeric = uuidNumeric;

package/uuidNumeric.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './uuidNumeric.cjs.js';
+export { _default as default } from './uuidNumeric.cjs.default.js';

package/uuidNumeric.d.ts

@@ -1,2 +1,6 @@
-export declare const uuidNumeric: () => number;
+/**
+ * @category uid
+ * @see https://stackoverflow.com/a/18048162/1938970
+ */
+export declare let uuidNumeric: () => number;
 export default uuidNumeric;

package/uuidNumeric.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./uuidNumeric";
+export { default } from "./uuidNumeric";