@koine/utils 2.0.0-beta.2 → 2.0.0-beta.21

package/serializeCookie.d.ts

@@ -1,27 +1,3 @@
-/**
- * @file
- *
- * @category cookie
- *
- * All cookie related code is inspired and adapted from:
- * - [js-cookie](https://github.com/js-cookie/js-cookie)
- * - [cookie](https://github.com/jshttp/cookie)
- */
-import { type CookieAttributesServer } from "./cookie";
-/**
- * Serialize data into a cookie header.
- *
- * Serialize the a name value pair into a cookie string suitable for
- * http headers. An optional attributes object specified cookie parameters.
- *
- * serialize('foo', 'bar', { httpOnly: true })
- *   => "foo=bar; httpOnly"
- *
- * @category cookie
- *
- * All cookie related code is inspired and adapted from:
- * - [js-cookie](https://github.com/js-cookie/js-cookie)
- * - [cookie](https://github.com/jshttp/cookie)
- */
+import { type CookieAttributesServer } from "./cookie.js";
 export declare function serializeCookie(name: string, val: string, attributes?: CookieAttributesServer): string;
 export default serializeCookie;

package/serializeCookie.js

@@ -1,46 +1,11 @@
-"use strict";
-/**
- * @file
- *
- * @category cookie
- *
- * All cookie related code is inspired and adapted from:
- * - [js-cookie](https://github.com/js-cookie/js-cookie)
- * - [cookie](https://github.com/jshttp/cookie)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.serializeCookie = void 0;
-var isNumber_1 = require("./isNumber");
-/**
- * RegExp to match field-content in RFC 7230 sec 3.2
- *
- * field-content = field-vchar [ 1*( SP / HTAB ) field-vchar ]
- * field-vchar   = VCHAR / obs-text
- * obs-text      = %x80-FF
- */
-// eslint-disable-next-line no-control-regex
+import { isNumber } from "./isNumber.js";
 var fieldContentRegExp = /^[\u0009\u0020-\u007e\u0080-\u00ff]+$/;
-/**
- * Serialize data into a cookie header.
- *
- * Serialize the a name value pair into a cookie string suitable for
- * http headers. An optional attributes object specified cookie parameters.
- *
- * serialize('foo', 'bar', { httpOnly: true })
- *   => "foo=bar; httpOnly"
- *
- * @category cookie
- *
- * All cookie related code is inspired and adapted from:
- * - [js-cookie](https://github.com/js-cookie/js-cookie)
- * - [cookie](https://github.com/jshttp/cookie)
- */
-function serializeCookie(name, val, attributes) {
+export function serializeCookie(name, val, attributes) {
     if (attributes === void 0) { attributes = {}; }
     var _a = attributes.encode, encode = _a === void 0 ? encodeURIComponent : _a, domain = attributes.domain, path = attributes.path, httpOnly = attributes.httpOnly, secure = attributes.secure, sameSite = attributes.sameSite;
     var maxAge = attributes.maxAge, expires = attributes.expires;
     var value = encode(val);
-    if (process.env["NODE_ENV"] !== "production") {
+    if (process.env["NODE_ENV"] === "development") {
         if (!fieldContentRegExp.test(name)) {
             throw new TypeError("argument name is invalid");
         }
@@ -60,7 +25,7 @@ function serializeCookie(name, val, attributes) {
         str += "; Max-Age=" + Math.floor(maxAge);
     }
     if (domain) {
-        if (process.env["NODE_ENV"] !== "production") {
+        if (process.env["NODE_ENV"] === "development") {
             if (!fieldContentRegExp.test(domain)) {
                 throw new TypeError("option domain is invalid");
             }
@@ -68,7 +33,7 @@ function serializeCookie(name, val, attributes) {
         str += "; Domain=" + domain;
     }
     if (path) {
-        if (process.env["NODE_ENV"] !== "production") {
+        if (process.env["NODE_ENV"] === "development") {
             if (!fieldContentRegExp.test(path)) {
                 throw new TypeError("option path is invalid");
             }
@@ -76,7 +41,7 @@ function serializeCookie(name, val, attributes) {
         str += "; Path=" + path;
     }
     if (expires) {
-        if ((0, isNumber_1.isNumber)(expires)) {
+        if (isNumber(expires)) {
             expires = new Date(Date.now() + expires * 864e5);
         }
         str += "; Expires=" + expires.toUTCString();
@@ -98,11 +63,8 @@ function serializeCookie(name, val, attributes) {
             case "none":
                 str += "; SameSite=None";
                 break;
-            //  default:
-            //    throw new TypeError('option sameSite is invalid');
         }
     }
     return str;
 }
-exports.serializeCookie = serializeCookie;
-exports.default = serializeCookie;
+export default serializeCookie;

package/setCookie.d.ts

@@ -1,10 +1,3 @@
-import { type CookieAttributesClient } from "./cookie";
-/**
- * @category cookie
- *
- * All cookie related code is inspired and adapted from:
- * - [js-cookie](https://github.com/js-cookie/js-cookie)
- * - [cookie](https://github.com/jshttp/cookie)
- */
+import { type CookieAttributesClient } from "./cookie.js";
 export declare function setCookie<T extends string = string>(name: string, value: string | T, attributes?: CookieAttributesClient): string | undefined;
 export default setCookie;

package/setCookie.js

@@ -1,32 +1,21 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setCookie = void 0;
-var tslib_1 = require("tslib");
-var cookie_1 = require("./cookie");
-var isNumber_1 = tslib_1.__importDefault(require("./isNumber"));
-var isUndefined_1 = tslib_1.__importDefault(require("./isUndefined"));
+import { __assign, __rest } from "tslib";
+import { defaultAttributesClient } from "./cookie.js";
+import isNumber from "./isNumber.js";
+import isUndefined from "./isUndefined.js";
 function converterWrite(value) {
     return encodeURIComponent(value).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g, decodeURIComponent);
 }
-/**
- * @category cookie
- *
- * All cookie related code is inspired and adapted from:
- * - [js-cookie](https://github.com/js-cookie/js-cookie)
- * - [cookie](https://github.com/jshttp/cookie)
- */
-function setCookie(name, value, attributes) {
+export function setCookie(name, value, attributes) {
     if (attributes === void 0) { attributes = {}; }
-    // eslint-disable-next-line prefer-const
-    var expires = attributes.expires, restAttrs = tslib_1.__rest(attributes, ["expires"]);
-    var cleanedAttrs = tslib_1.__assign(tslib_1.__assign({ expires: "" }, cookie_1.defaultAttributesClient), restAttrs);
-    if ((0, isUndefined_1.default)(document)) {
-        if (process.env["NODE_ENV"] !== "production") {
+    var expires = attributes.expires, restAttrs = __rest(attributes, ["expires"]);
+    var cleanedAttrs = __assign(__assign({ expires: "" }, defaultAttributesClient), restAttrs);
+    if (isUndefined(document)) {
+        if (process.env["NODE_ENV"] === "development") {
             console.warn("[@koine/utils:setCookie] document is undefined");
         }
         return undefined;
     }
-    if ((0, isNumber_1.default)(expires)) {
+    if (isNumber(expires)) {
         expires = new Date(Date.now() + expires * 864e5);
     }
     if (expires) {
@@ -45,18 +34,10 @@ function setCookie(name, value, attributes) {
         if (attributes[attrName] === true) {
             continue;
         }
-        // Considers RFC 6265 section 5.2:
-        // ...
-        // 3.  If the remaining unparsed-attributes contains a %x3B (";")
-        //     character:
-        // Consume the characters of the unparsed-attributes up to,
-        // not including, the first %x3B (";") character.
-        // ...
         stringifiedAttributes +=
             "=" + String(attributes[attrName]).split(";")[0];
     }
     return (document.cookie =
         name + "=" + converterWrite(value) + stringifiedAttributes);
 }
-exports.setCookie = setCookie;
-exports.default = setCookie;
+export default setCookie;

package/shuffle.d.ts

@@ -1,16 +1,2 @@
-/**
- * Creates an array of shuffled values, using a version of the
- * [Fisher-Yates shuffle](https://en.wikipedia.org/wiki/Fisher-Yates_shuffle).
- *
- * @see lodash.shuffle
- * @since 0.1.0
- * @category arrays
- * @param {Array} array The array to shuffle.
- * @returns {Array} Returns the new shuffled array.
- * @example
- *
- * shuffle([1, 2, 3, 4])
- * // => [4, 1, 3, 2]
- */
 export declare function shuffle<T>(array: T[]): T[];
 export default shuffle;

package/shuffle.js

@@ -1,29 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.shuffle = void 0;
-var tslib_1 = require("tslib");
-/**
- * Creates an array of shuffled values, using a version of the
- * [Fisher-Yates shuffle](https://en.wikipedia.org/wiki/Fisher-Yates_shuffle).
- *
- * @see lodash.shuffle
- * @since 0.1.0
- * @category arrays
- * @param {Array} array The array to shuffle.
- * @returns {Array} Returns the new shuffled array.
- * @example
- *
- * shuffle([1, 2, 3, 4])
- * // => [4, 1, 3, 2]
- */
-function shuffle(array) {
+import { __read, __spreadArray } from "tslib";
+export function shuffle(array) {
     var length = array == null ? 0 : array.length;
     if (!length) {
         return [];
     }
     var index = -1;
     var lastIndex = length - 1;
-    var result = tslib_1.__spreadArray([], array, true);
+    var result = __spreadArray([], __read(array), false);
     while (++index < length) {
         var rand = index + Math.floor(Math.random() * (lastIndex - index + 1));
         var value = result[rand];
@@ -32,5 +15,4 @@ function shuffle(array) {
     }
     return result;
 }
-exports.shuffle = shuffle;
-exports.default = shuffle;
+export default shuffle;

package/slugify.d.ts

@@ -1,11 +1,2 @@
-/**
- * Slugify a text
- *
- * - replaces the accented letters
- * - replaces the punctuation with dashes
- *
- * @category text
- * @see https://gist.github.com/mathewbyrne/1280286#gistcomment-3498021
- */
 export declare function slugify(text: string, separator?: string): string;
 export default slugify;

package/slugify.js

@@ -1,27 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.slugify = void 0;
-var accentSets_1 = require("./accentSets");
-var removeAccents_1 = require("./removeAccents");
-/**
- * Slugify a text
- *
- * - replaces the accented letters
- * - replaces the punctuation with dashes
- *
- * @category text
- * @see https://gist.github.com/mathewbyrne/1280286#gistcomment-3498021
- */
-function slugify(text, separator) {
+import { accentsSets } from "./accentSets.js";
+import { removeAccents } from "./removeAccents.js";
+export function slugify(text, separator) {
     if (separator === void 0) { separator = "-"; }
-    return (0, removeAccents_1.removeAccents)(text.toString().toLowerCase().trim(), accentSets_1.accentsSets.concat([["-", "[·/_,:;']"]]))
-        .replace(/\s+/g, "-") // replace spaces with -
-        .replace(/&/g, "-and-") // replace & with 'and'
-        .replace(/[^\w-]+/g, "") // remove all non-word chars
-        .replace(/--+/g, "-") // replace multiple - with single -
-        .replace(/^-+/, "") // trim - from start of text
-        .replace(/-+$/, "") // trim - from end of text
+    return removeAccents(text.toString().toLowerCase().trim(), accentsSets.concat([["-", "[·/_,:;']"]]))
+        .replace(/\s+/g, "-")
+        .replace(/&/g, "-and-")
+        .replace(/[^\w-]+/g, "")
+        .replace(/--+/g, "-")
+        .replace(/^-+/, "")
+        .replace(/-+$/, "")
         .replace(/-/g, separator);
 }
-exports.slugify = slugify;
-exports.default = slugify;
+export default slugify;

package/split.d.ts

@@ -1,3 +1,3 @@
 export type Split<S extends string, D extends string> = string extends S ? string[] : S extends "" ? [] : S extends `${infer T}${D}${infer U}` ? [T, ...Split<U, D>] : [S];
-export declare function split<T extends string, D extends string>(str: T, delimiter: D): Split<T, D>;
+export declare const split: <T extends string, D extends string>(string: T, delimiter: D) => Split<T, D>;
 export default split;

package/split.js

@@ -1,8 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.split = void 0;
-function split(str, delimiter) {
-    return str.split(delimiter);
-}
-exports.split = split;
-exports.default = split;
+export var split = function (string, delimiter) { return string.split(delimiter); };
+export default split;

package/swapMap.d.ts

@@ -1,7 +1,2 @@
-/**
- * Swap object map key/value
- *
- * @category objects
- */
 export declare function swapMap<T extends Record<string, string | number | symbol> = Record<string, string | number | symbol>>(map?: T): Record<T[keyof T], keyof T>;
 export default swapMap;

package/swapMap.js

@@ -1,12 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.swapMap = void 0;
-/**
- * Swap object map key/value
- *
- * @category objects
- */
-function swapMap(map) {
+export function swapMap(map) {
     if (map === void 0) { map = {}; }
     var output = {};
     for (var key in map) {
@@ -14,5 +6,4 @@ function swapMap(map) {
     }
     return output;
 }
-exports.swapMap = swapMap;
-exports.default = swapMap;
+export default swapMap;

package/throttle.d.ts

@@ -1,8 +1,2 @@
-/**
- * Throttle function (e.g. for resize / scroll handlers)
- *
- * @category function
- * @see https://github.com/Mobius1/Rangeable/
- */
 export declare function throttle<TFn extends Function, TContext>(fn: TFn, limit: number, context?: TContext): (this: TContext, ...args: any[]) => NodeJS.Timeout | undefined;
 export default throttle;

package/throttle.js

@@ -1,14 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.throttle = void 0;
-var tslib_1 = require("tslib");
-/**
- * Throttle function (e.g. for resize / scroll handlers)
- *
- * @category function
- * @see https://github.com/Mobius1/Rangeable/
- */
-function throttle(fn, limit, context) {
+import { __read, __spreadArray } from "tslib";
+export function throttle(fn, limit, context) {
     var wait;
     return function () {
         var args = [];
@@ -17,7 +8,7 @@ function throttle(fn, limit, context) {
         }
         context = context || this;
         if (!wait) {
-            fn.apply.apply(fn, tslib_1.__spreadArray([context], args, false));
+            fn.apply.apply(fn, __spreadArray([context], __read(args), false));
             wait = true;
             return setTimeout(function () {
                 wait = false;
@@ -26,5 +17,4 @@ function throttle(fn, limit, context) {
         return;
     };
 }
-exports.throttle = throttle;
-exports.default = throttle;
+export default throttle;

package/titleCase.d.ts

@@ -1,7 +1,2 @@
-/**
- * @category typography
- * @see https://github.com/blakeembrey/change-case/blob/master/packages/title-case/src/index.ts
- * @author Blake Embrey (hello@blakeembrey.com)
- */
 export declare const titleCase: (input?: null | string) => string;
 export default titleCase;

package/titleCase.js

@@ -1,15 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.titleCase = void 0;
-/**
- * @category typography
- * @see https://github.com/blakeembrey/change-case/blob/master/packages/title-case/src/index.ts
- * @author Blake Embrey (hello@blakeembrey.com)
- */
-var titleCase = function (input) {
+export var titleCase = function (input) {
     return input
         ? input.replace(/\w\S*/g, function (txt) { return txt.charAt(0).toUpperCase() + txt.substring(1).toLowerCase(); })
         : "";
 };
-exports.titleCase = titleCase;
-exports.default = exports.titleCase;
+export default titleCase;

package/toNumber.d.ts

@@ -1,5 +1,2 @@
-/**
- * @category cast
- */
 export declare function toNumber(input?: string | number, fallback?: number): number;
 export default toNumber;

package/toNumber.js

@@ -1,12 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toNumber = void 0;
-var isNumber_1 = require("./isNumber");
-/**
- * @category cast
- */
-function toNumber(input, fallback) {
-    return (0, isNumber_1.isNumber)(input) ? input : input ? parseFloat(input) : fallback || 0;
+import { isNumber } from "./isNumber.js";
+export function toNumber(input, fallback) {
+    return isNumber(input) ? input : input ? parseFloat(input) : fallback || 0;
 }
-exports.toNumber = toNumber;
-exports.default = toNumber;
+export default toNumber;

package/toRgba.d.ts

@@ -1,5 +1,2 @@
-/**
- * @category colors
- */
 export declare function toRgba(hex: string, alpha?: number): string;
 export default toRgba;

package/toRgba.js

@@ -1,14 +1,4 @@
-"use strict";
-// import hexRgb from "hex-rgb";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toRgba = void 0;
-// export const toRgb = (hexColor: string) => hexRgb(hexColor, { format: "css" });
-// export const toRgba = (hexColor: string, alpha: number) =>
-//   hexRgb(hexColor, { format: "css", alpha });
-/**
- * @category colors
- */
-function toRgba(hex, alpha) {
+export function toRgba(hex, alpha) {
     if (alpha === void 0) { alpha = 1; }
     var r = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
     if (r) {
@@ -16,5 +6,4 @@ function toRgba(hex, alpha) {
     }
     return "";
 }
-exports.toRgba = toRgba;
-exports.default = toRgba;
+export default toRgba;

package/transformToUrlPathname.d.ts

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

package/transformToUrlPathname.js

@@ -1,21 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.transformToUrlPathname = void 0;
-var tslib_1 = require("tslib");
-var isString_1 = tslib_1.__importDefault(require("./isString"));
-/**
- * Transform string in a URL pathname (relative URL)
- *
- * - adds an initial slash
- * - encode the string
- * - replaces whitespaces with dashes
- *
- * @category location
- */
-function transformToUrlPathname(toPathname) {
-    return (0, isString_1.default)(toPathname)
+import isString from "./isString.js";
+export function transformToUrlPathname(toPathname) {
+    return isString(toPathname)
         ? "/".concat(encodeURIComponent(toPathname.replace(/\s/g, "-").toLowerCase()))
         : "";
 }
-exports.transformToUrlPathname = transformToUrlPathname;
-exports.default = transformToUrlPathname;
+export default transformToUrlPathname;

package/truncate.d.ts

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

package/truncate.js

@@ -1,17 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.truncate = void 0;
-/**
- * Truncate string
- *
- * @category typography
- */
-var truncate = function (input, length) {
+export var truncate = function (input, length) {
     return input
         ? input.length > length
             ? input.substring(0, length) + "..."
             : input
         : "";
 };
-exports.truncate = truncate;
-exports.default = exports.truncate;
+export default truncate;

package/tryUntil.d.ts

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

package/tryUntil.js

@@ -1,31 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.tryUntil = void 0;
-/**
- * @borrows [https://levelup.gitconnected.com/javascript-wait-until-something-happens-or-timeout-82636839ea93]
- *
- * @param timeout in `ms`
- * @param interval in `ms`
- */
-var tryUntil = function (test, timeout, interval, resolve, reject) {
-    // return new Promise((resolve, reject) => {
+export var tryUntil = function (test, timeout, interval, resolve, reject) {
     var timeWas = new Date();
     var wait = setInterval(function () {
         if (test()) {
-            // console.log("resolved after", new Date() - timeWas, "ms");
             clearInterval(wait);
             resolve();
-            // @ts-expect-error ...
         }
         else if (new Date() - timeWas > timeout) {
-            // Timeout
-            // console.log("rejected after", new Date() - timeWas, "ms");
             clearInterval(wait);
             if (reject)
                 reject();
         }
     }, interval);
-    // });
 };
-exports.tryUntil = tryUntil;
-exports.default = exports.tryUntil;
+export default tryUntil;

package/types.d.ts

@@ -1,28 +1,10 @@
 import type { Replace } from "type-fest";
-/**
- * Whatever that in javascript returns `false` when checked in an `if` condition
- */
 export type AnythingFalsy = null | undefined | 0 | "";
-/**
- * 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>;

package/types.js

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

package/typings.d.ts

@@ -1,9 +1,4 @@
 /**
  * List here the global variables used by third party scripts supported within
- * the `koine` ecosystem. For instance Google Analytics globally available
- * variables.
+ * the `koine` ecosystem.
  */
-
-// declare type NullableRecord<T> = {
-//   [K in keyof T]: T[K] | null;
-// };

package/uid.d.ts

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