extra-utils 5.1.1 → 5.3.0

package/lib/pipe-async.d.ts

@@ -1,44 +1,44 @@
-import { Awaitable } from 'justypes';
-export declare function pipeAsync<A, B, C, D, E, F, G, H>(value: Awaitable<A>, ...operators: [
-    (value: A) => Awaitable<B>,
-    (value: B) => Awaitable<C>,
-    (value: C) => Awaitable<D>,
-    (value: D) => Awaitable<E>,
-    (value: E) => Awaitable<F>,
-    (value: F) => Awaitable<G>,
-    (value: G) => Awaitable<H>
-]): Promise<H>;
-export declare function pipeAsync<A, B, C, D, E, F, G>(value: Awaitable<A>, ...operators: [
-    (value: A) => Awaitable<B>,
-    (value: B) => Awaitable<C>,
-    (value: C) => Awaitable<D>,
-    (value: D) => Awaitable<E>,
-    (value: E) => Awaitable<F>,
-    (value: F) => Awaitable<G>
-]): Promise<G>;
-export declare function pipeAsync<A, B, C, D, E, F>(value: Awaitable<A>, ...operators: [
-    (value: A) => Awaitable<B>,
-    (value: B) => Awaitable<C>,
-    (value: C) => Awaitable<D>,
-    (value: D) => Awaitable<E>,
-    (value: E) => Awaitable<F>
-]): Promise<F>;
-export declare function pipeAsync<A, B, C, D, E>(value: Awaitable<A>, ...operators: [
-    (value: A) => Awaitable<B>,
-    (value: B) => Awaitable<C>,
-    (value: C) => Awaitable<D>,
-    (value: D) => Awaitable<E>
-]): Promise<E>;
-export declare function pipeAsync<A, B, C, D>(value: Awaitable<A>, ...operators: [
-    (value: A) => Awaitable<B>,
-    (value: B) => Awaitable<C>,
-    (value: C) => Awaitable<D>
-]): Promise<D>;
-export declare function pipeAsync<A, B, C>(value: Awaitable<A>, ...operators: [
-    (value: A) => Awaitable<B>,
-    (value: B) => Awaitable<C>
-]): Promise<C>;
-export declare function pipeAsync<A, B>(value: Awaitable<A>, ...operators: [
-    (value: A) => Awaitable<B>
-]): Promise<B>;
-export declare function pipeAsync<T, U>(value: Awaitable<T>, ...operators: Array<(value: any) => Awaitable<unknown>>): Promise<U>;
+import { Awaitable } from 'justypes';
+export declare function pipeAsync<A, B, C, D, E, F, G, H>(value: Awaitable<A>, ...operators: [
+    (value: A) => Awaitable<B>,
+    (value: B) => Awaitable<C>,
+    (value: C) => Awaitable<D>,
+    (value: D) => Awaitable<E>,
+    (value: E) => Awaitable<F>,
+    (value: F) => Awaitable<G>,
+    (value: G) => Awaitable<H>
+]): Promise<H>;
+export declare function pipeAsync<A, B, C, D, E, F, G>(value: Awaitable<A>, ...operators: [
+    (value: A) => Awaitable<B>,
+    (value: B) => Awaitable<C>,
+    (value: C) => Awaitable<D>,
+    (value: D) => Awaitable<E>,
+    (value: E) => Awaitable<F>,
+    (value: F) => Awaitable<G>
+]): Promise<G>;
+export declare function pipeAsync<A, B, C, D, E, F>(value: Awaitable<A>, ...operators: [
+    (value: A) => Awaitable<B>,
+    (value: B) => Awaitable<C>,
+    (value: C) => Awaitable<D>,
+    (value: D) => Awaitable<E>,
+    (value: E) => Awaitable<F>
+]): Promise<F>;
+export declare function pipeAsync<A, B, C, D, E>(value: Awaitable<A>, ...operators: [
+    (value: A) => Awaitable<B>,
+    (value: B) => Awaitable<C>,
+    (value: C) => Awaitable<D>,
+    (value: D) => Awaitable<E>
+]): Promise<E>;
+export declare function pipeAsync<A, B, C, D>(value: Awaitable<A>, ...operators: [
+    (value: A) => Awaitable<B>,
+    (value: B) => Awaitable<C>,
+    (value: C) => Awaitable<D>
+]): Promise<D>;
+export declare function pipeAsync<A, B, C>(value: Awaitable<A>, ...operators: [
+    (value: A) => Awaitable<B>,
+    (value: B) => Awaitable<C>
+]): Promise<C>;
+export declare function pipeAsync<A, B>(value: Awaitable<A>, ...operators: [
+    (value: A) => Awaitable<B>
+]): Promise<B>;
+export declare function pipeAsync<T, U>(value: Awaitable<T>, ...operators: Array<(value: any) => Awaitable<unknown>>): Promise<U>;

package/lib/pipe-async.js

@@ -1,8 +1,8 @@
-export async function pipeAsync(value, ...operators) {
-    let result = await value;
-    for (const operator of operators) {
-        result = await operator(result);
-    }
-    return result;
-}
+export async function pipeAsync(value, ...operators) {
+    let result = await value;
+    for (const operator of operators) {
+        result = await operator(result);
+    }
+    return result;
+}
 //# sourceMappingURL=pipe-async.js.map

package/lib/pipe.d.ts

@@ -1,43 +1,43 @@
-export declare function pipe<A, B, C, D, E, F, G, H>(value: A, ...operators: [
-    (value: A) => B,
-    (value: B) => C,
-    (value: C) => D,
-    (value: D) => E,
-    (value: E) => F,
-    (value: F) => G,
-    (value: G) => H
-]): H;
-export declare function pipe<A, B, C, D, E, F, G>(value: A, ...operators: [
-    (value: A) => B,
-    (value: B) => C,
-    (value: C) => D,
-    (value: D) => E,
-    (value: E) => F,
-    (value: F) => G
-]): G;
-export declare function pipe<A, B, C, D, E, F>(value: A, ...operators: [
-    (value: A) => B,
-    (value: B) => C,
-    (value: C) => D,
-    (value: D) => E,
-    (value: E) => F
-]): F;
-export declare function pipe<A, B, C, D, E>(value: A, ...operators: [
-    (value: A) => B,
-    (value: B) => C,
-    (value: C) => D,
-    (value: D) => E
-]): E;
-export declare function pipe<A, B, C, D>(value: A, ...operators: [
-    (value: A) => B,
-    (value: B) => C,
-    (value: C) => D
-]): D;
-export declare function pipe<A, B, C>(value: A, ...operators: [
-    (value: A) => B,
-    (value: B) => C
-]): C;
-export declare function pipe<A, B>(value: A, ...operators: [
-    (value: A) => B
-]): B;
-export declare function pipe<T, U>(value: T, ...operators: Array<(value: any) => unknown>): U;
+export declare function pipe<A, B, C, D, E, F, G, H>(value: A, ...operators: [
+    (value: A) => B,
+    (value: B) => C,
+    (value: C) => D,
+    (value: D) => E,
+    (value: E) => F,
+    (value: F) => G,
+    (value: G) => H
+]): H;
+export declare function pipe<A, B, C, D, E, F, G>(value: A, ...operators: [
+    (value: A) => B,
+    (value: B) => C,
+    (value: C) => D,
+    (value: D) => E,
+    (value: E) => F,
+    (value: F) => G
+]): G;
+export declare function pipe<A, B, C, D, E, F>(value: A, ...operators: [
+    (value: A) => B,
+    (value: B) => C,
+    (value: C) => D,
+    (value: D) => E,
+    (value: E) => F
+]): F;
+export declare function pipe<A, B, C, D, E>(value: A, ...operators: [
+    (value: A) => B,
+    (value: B) => C,
+    (value: C) => D,
+    (value: D) => E
+]): E;
+export declare function pipe<A, B, C, D>(value: A, ...operators: [
+    (value: A) => B,
+    (value: B) => C,
+    (value: C) => D
+]): D;
+export declare function pipe<A, B, C>(value: A, ...operators: [
+    (value: A) => B,
+    (value: B) => C
+]): C;
+export declare function pipe<A, B>(value: A, ...operators: [
+    (value: A) => B
+]): B;
+export declare function pipe<T, U>(value: T, ...operators: Array<(value: any) => unknown>): U;

package/lib/pipe.js

@@ -1,8 +1,8 @@
-export function pipe(value, ...operators) {
-    let result = value;
-    for (const operator of operators) {
-        result = operator(result);
-    }
-    return result;
-}
+export function pipe(value, ...operators) {
+    let result = value;
+    for (const operator of operators) {
+        result = operator(result);
+    }
+    return result;
+}
 //# sourceMappingURL=pipe.js.map

package/lib/string/index.d.ts

@@ -1,7 +1,8 @@
-export * from './is-char.js';
-export * from './is-string.js';
-export * from './is-url-string.js';
-export * from './remove-blank-lines.js';
-export * from './remove-extra-indents.js';
-export * from './remove-leading-blank-lines.js';
-export * from './remove-trailing-blank-lines.js';
+export * from './is-char.js';
+export * from './is-string.js';
+export * from './is-url-string.js';
+export * from './remove-blank-lines.js';
+export * from './remove-extra-indents.js';
+export * from './remove-leading-blank-lines.js';
+export * from './remove-trailing-blank-lines.js';
+export * from './to-string.js';

package/lib/string/index.js

@@ -1,8 +1,9 @@
-export * from './is-char.js';
-export * from './is-string.js';
-export * from './is-url-string.js';
-export * from './remove-blank-lines.js';
-export * from './remove-extra-indents.js';
-export * from './remove-leading-blank-lines.js';
-export * from './remove-trailing-blank-lines.js';
+export * from './is-char.js';
+export * from './is-string.js';
+export * from './is-url-string.js';
+export * from './remove-blank-lines.js';
+export * from './remove-extra-indents.js';
+export * from './remove-leading-blank-lines.js';
+export * from './remove-trailing-blank-lines.js';
+export * from './to-string.js';
 //# sourceMappingURL=index.js.map

package/lib/string/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kCAAkC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kCAAkC,CAAA;AAChD,cAAc,gBAAgB,CAAA"}

package/lib/string/is-char.d.ts

@@ -1,2 +1,2 @@
-export declare function isChar(val: unknown): val is string;
-export declare function isntChar(val: unknown): boolean;
+export declare function isChar(val: unknown): val is string;
+export declare function isntChar(val: unknown): boolean;

package/lib/string/is-char.js

@@ -1,9 +1,9 @@
-import { isString } from './is-string.js';
-export function isChar(val) {
-    return isString(val)
-        && val.length === 1;
-}
-export function isntChar(val) {
-    return !isChar(val);
-}
+import { isString } from './is-string.js';
+export function isChar(val) {
+    return isString(val)
+        && val.length === 1;
+}
+export function isntChar(val) {
+    return !isChar(val);
+}
 //# sourceMappingURL=is-char.js.map

package/lib/string/is-string.d.ts

@@ -1,2 +1,2 @@
-export declare function isString(val: unknown): val is string;
-export declare function isntString<T>(val: T): val is Exclude<T, string>;
+export declare function isString(val: unknown): val is string;
+export declare function isntString<T>(val: T): val is Exclude<T, string>;

package/lib/string/is-string.js

@@ -1,7 +1,7 @@
-export function isString(val) {
-    return typeof val === 'string';
-}
-export function isntString(val) {
-    return !isString(val);
-}
+export function isString(val) {
+    return typeof val === 'string';
+}
+export function isntString(val) {
+    return !isString(val);
+}
 //# sourceMappingURL=is-string.js.map

package/lib/string/is-url-string.d.ts

@@ -1,2 +1,2 @@
-export declare function isURLString(text: string): boolean;
-export declare function isntURLString(text: string): boolean;
+export declare function isURLString(text: string): boolean;
+export declare function isntURLString(text: string): boolean;

package/lib/string/is-url-string.js

@@ -1,13 +1,13 @@
-export function isURLString(text) {
-    try {
-        new URL(text);
-        return true;
-    }
-    catch (_a) {
-        return false;
-    }
-}
-export function isntURLString(text) {
-    return !isURLString(text);
-}
+export function isURLString(text) {
+    try {
+        new URL(text);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+export function isntURLString(text) {
+    return !isURLString(text);
+}
 //# sourceMappingURL=is-url-string.js.map

package/lib/string/remove-blank-lines.d.ts

@@ -1 +1 @@
-export declare function removeBlankLines(text: string): string;
+export declare function removeBlankLines(text: string): string;

package/lib/string/remove-blank-lines.js

@@ -1,8 +1,8 @@
-import { isntBlankLine } from './utils.js';
-export function removeBlankLines(text) {
-    return text
-        .split('\n')
-        .filter(line => isntBlankLine(line))
-        .join('\n');
-}
+import { isntBlankLine } from './utils.js';
+export function removeBlankLines(text) {
+    return text
+        .split('\n')
+        .filter(line => isntBlankLine(line))
+        .join('\n');
+}
 //# sourceMappingURL=remove-blank-lines.js.map

package/lib/string/remove-extra-indents.d.ts

@@ -1,3 +1,3 @@
-export declare function removeExtraIndents(text: string, { ignoreBlankLines }?: {
-    ignoreBlankLines?: boolean;
-}): string;
+export declare function removeExtraIndents(text: string, { ignoreBlankLines }?: {
+    ignoreBlankLines?: boolean;
+}): string;

package/lib/string/remove-extra-indents.js

@@ -1,21 +1,21 @@
-import { isntBlankLine } from './utils.js';
-export function removeExtraIndents(text, { ignoreBlankLines = false } = {}) {
-    const lines = text.split('\n');
-    const commonIndentLength = lines
-        .filter(line => ignoreBlankLines ? isntBlankLine(line) : true)
-        .reduce((acc, cur) => {
-        const indent = cur.match(/^(\s+)/);
-        if (indent) {
-            return Math.min(acc, indent[1].length);
-        }
-        else {
-            return 0;
-        }
-    }, Infinity);
-    if (commonIndentLength === 0 || commonIndentLength === Infinity) {
-        return text;
-    }
-    const newLines = lines.map(x => x.slice(commonIndentLength));
-    return newLines.join('\n');
-}
+import { isntBlankLine } from './utils.js';
+export function removeExtraIndents(text, { ignoreBlankLines = false } = {}) {
+    const lines = text.split('\n');
+    const commonIndentLength = lines
+        .filter(line => ignoreBlankLines ? isntBlankLine(line) : true)
+        .reduce((acc, cur) => {
+        const indent = cur.match(/^(\s+)/);
+        if (indent) {
+            return Math.min(acc, indent[1].length);
+        }
+        else {
+            return 0;
+        }
+    }, Infinity);
+    if (commonIndentLength === 0 || commonIndentLength === Infinity) {
+        return text;
+    }
+    const newLines = lines.map(x => x.slice(commonIndentLength));
+    return newLines.join('\n');
+}
 //# sourceMappingURL=remove-extra-indents.js.map

package/lib/string/remove-leading-blank-lines.d.ts

@@ -1 +1 @@
-export declare function removeLeadingBlankLines(text: string, maxRemovals?: number): string;
+export declare function removeLeadingBlankLines(text: string, maxRemovals?: number): string;

package/lib/string/remove-leading-blank-lines.js

@@ -1,13 +1,13 @@
-import { isBlankLine } from './utils.js';
-export function removeLeadingBlankLines(text, maxRemovals = Infinity) {
-    const lines = text.split('\n');
-    let removals = 0;
-    while (removals < maxRemovals &&
-        lines.length > 0 &&
-        isBlankLine(lines[0])) {
-        lines.shift();
-        removals++;
-    }
-    return lines.join('\n');
-}
+import { isBlankLine } from './utils.js';
+export function removeLeadingBlankLines(text, maxRemovals = Infinity) {
+    const lines = text.split('\n');
+    let removals = 0;
+    while (removals < maxRemovals &&
+        lines.length > 0 &&
+        isBlankLine(lines[0])) {
+        lines.shift();
+        removals++;
+    }
+    return lines.join('\n');
+}
 //# sourceMappingURL=remove-leading-blank-lines.js.map

package/lib/string/remove-trailing-blank-lines.d.ts

@@ -1 +1 @@
-export declare function removeTrailingBlankLines(text: string, maxRemovals?: number): string;
+export declare function removeTrailingBlankLines(text: string, maxRemovals?: number): string;

package/lib/string/remove-trailing-blank-lines.js

@@ -1,13 +1,13 @@
-import { isBlankLine } from './utils.js';
-export function removeTrailingBlankLines(text, maxRemovals = Infinity) {
-    const lines = text.split('\n');
-    let removals = 0;
-    while (removals < maxRemovals &&
-        lines.length > 0 &&
-        isBlankLine(lines[lines.length - 1])) {
-        lines.pop();
-        removals++;
-    }
-    return lines.join('\n');
-}
+import { isBlankLine } from './utils.js';
+export function removeTrailingBlankLines(text, maxRemovals = Infinity) {
+    const lines = text.split('\n');
+    let removals = 0;
+    while (removals < maxRemovals &&
+        lines.length > 0 &&
+        isBlankLine(lines[lines.length - 1])) {
+        lines.pop();
+        removals++;
+    }
+    return lines.join('\n');
+}
 //# sourceMappingURL=remove-trailing-blank-lines.js.map

package/lib/string/to-string.d.ts

@@ -0,0 +1 @@
+export declare function toString(val: unknown): string;

package/lib/string/to-string.js

@@ -0,0 +1,4 @@
+export function toString(val) {
+    return `${val}`;
+}
+//# sourceMappingURL=to-string.js.map

package/lib/string/to-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-string.js","sourceRoot":"","sources":["../../src/string/to-string.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,OAAO,GAAG,GAAG,EAAE,CAAA;AACjB,CAAC"}

package/lib/string/utils.d.ts

@@ -1,2 +1,2 @@
-export declare function isBlankLine(line: string): boolean;
-export declare function isntBlankLine(line: string): boolean;
+export declare function isBlankLine(line: string): boolean;
+export declare function isntBlankLine(line: string): boolean;

package/lib/string/utils.js

@@ -1,7 +1,7 @@
-export function isBlankLine(line) {
-    return line.trim() === '';
-}
-export function isntBlankLine(line) {
-    return !isBlankLine(line);
-}
+export function isBlankLine(line) {
+    return line.trim() === '';
+}
+export function isntBlankLine(line) {
+    return !isBlankLine(line);
+}
 //# sourceMappingURL=utils.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "extra-utils",
-  "version": "5.1.1",
+  "version": "5.3.0",
   "description": "Utilities for JavaScript and Typescript",
   "files": [
     "src",
@@ -36,30 +36,30 @@
   "devDependencies": {
     "@blackglory/jest-resolver": "^0.3.0",
     "@blackglory/pass": "^1.1.0",
-    "@commitlint/cli": "^17.4.4",
-    "@commitlint/config-conventional": "^17.4.4",
-    "@types/jest": "^29.4.0",
-    "@types/jsdom": "^21.1.0",
-    "@types/lodash-es": "^4.17.6",
-    "@typescript-eslint/eslint-plugin": "^5.52.0",
-    "@typescript-eslint/parser": "^5.52.0",
+    "@commitlint/cli": "^17.6.1",
+    "@commitlint/config-conventional": "^17.6.1",
+    "@types/jest": "^29.5.0",
+    "@types/jsdom": "^21.1.1",
+    "@types/lodash-es": "^4.17.7",
+    "@typescript-eslint/eslint-plugin": "^5.58.0",
+    "@typescript-eslint/parser": "^5.58.0",
     "cross-env": "^7.0.3",
-    "eslint": "^8.34.0",
+    "eslint": "^8.38.0",
     "husky": "^4.3.8",
-    "jest": "^29.4.3",
-    "jest-resolve": "^29.4.3",
+    "jest": "^29.5.0",
+    "jest-resolve": "^29.5.0",
     "npm-run-all": "^4.1.5",
     "rimraf": "^3.0.2",
     "standard-version": "^9.5.0",
-    "ts-jest": "^29.0.5",
+    "ts-jest": "^29.1.0",
     "ts-patch": "^2.1.0",
-    "tsd": "^0.25.0",
+    "tsd": "^0.28.1",
     "tslib": "^2.5.0",
     "typescript": "4.8",
     "typescript-transform-paths": "^3.4.6"
   },
   "dependencies": {
-    "justypes": "^4.1.0",
+    "justypes": "^4.2.0",
     "lodash-es": "^4.17.21"
   }
 }

package/src/array-like/first.ts

@@ -0,0 +1,5 @@
+export function first<T>(arr: ArrayLike<T>): T | undefined {
+  return arr.length
+       ? arr[0]
+       : undefined
+}

package/src/array-like/index.ts

@@ -0,0 +1,2 @@
+export * from './first.js'
+export * from './last.js'

package/src/array-like/last.ts

@@ -0,0 +1,5 @@
+export function last<T>(arr: ArrayLike<T>): T | undefined {
+  return arr.length
+       ? arr[arr.length - 1]
+       : undefined
+}

package/src/index.ts

@@ -1,3 +1,4 @@
+export * from './array-like/index.js'
 export * from './array/index.js'
 export * from './boolean/index.js'
 export * from './number/index.js'

package/src/string/index.ts

@@ -5,3 +5,4 @@ export * from './remove-blank-lines.js'
 export * from './remove-extra-indents.js'
 export * from './remove-leading-blank-lines.js'
 export * from './remove-trailing-blank-lines.js'
+export * from './to-string.js'

package/src/string/to-string.ts

@@ -0,0 +1,3 @@
+export function toString(val: unknown): string {
+  return `${val}`
+}